Return-Path: X-Original-To: apmail-commons-dev-archive@www.apache.org Delivered-To: apmail-commons-dev-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 131C3DC1C for ; Thu, 23 Aug 2012 10:57:55 +0000 (UTC) Received: (qmail 99462 invoked by uid 500); 23 Aug 2012 10:57:54 -0000 Delivered-To: apmail-commons-dev-archive@commons.apache.org Received: (qmail 99213 invoked by uid 500); 23 Aug 2012 10:57:54 -0000 Mailing-List: contact dev-help@commons.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: "Commons Developers List" Delivered-To: mailing list dev@commons.apache.org Received: (qmail 99188 invoked by uid 99); 23 Aug 2012 10:57:53 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 23 Aug 2012 10:57:53 +0000 X-ASF-Spam-Status: No, hits=-0.7 required=5.0 tests=RCVD_IN_DNSWL_LOW,SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (athena.apache.org: domain of sebbaz@gmail.com designates 209.85.220.171 as permitted sender) Received: from [209.85.220.171] (HELO mail-vc0-f171.google.com) (209.85.220.171) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 23 Aug 2012 10:57:48 +0000 Received: by vcdd16 with SMTP id d16so810656vcd.30 for ; Thu, 23 Aug 2012 03:57:27 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :content-type:content-transfer-encoding; bh=CvDl3IO2tPAhxiMIn1RWjMiR7OmSizrmkew6sd9lSlU=; b=W/mIHh2CcplId+30FzwGXXLsZlg42IWifd/THwIcqvVYek+AZGXbIaYeaNPRWTpOdl +fh9akD3vx8YkynE26jmsZi0M9HvlxPtKnuQ/DuS3R0gnuvfNTKoekmULeej7/DLr57q ki8SP9vG7Z1RsDHSu/Jr5RX8RJ6dN8nDhKb2b/VJ4eJUzNq+QWMsRKz8uVGn7fW7RtTk Ija+NRnGBwoDmc5OjLaYK0OxhR3eUqaLskO8gXPk2f+Mt+hW5I1hZWRm25h109eFcFgM SIm8D0+Gj3rutdRQ2TgPgjyTACnRzXF+TW2BKDwSCpWEUZ35Zv0VWOF6VCD+DS9hlsyU N47Q== MIME-Version: 1.0 Received: by 10.58.211.100 with SMTP id nb4mr928748vec.25.1345719447866; Thu, 23 Aug 2012 03:57:27 -0700 (PDT) Received: by 10.58.58.197 with HTTP; Thu, 23 Aug 2012 03:57:27 -0700 (PDT) In-Reply-To: References: Date: Thu, 23 Aug 2012 11:57:27 +0100 Message-ID: Subject: Re: [math] Formatting From: sebb To: Commons Developers List Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable X-Virus-Checked: Checked by ClamAV on apache.org On 23 August 2012 11:39, S=E9bastien Brisard wr= ote: > Hi, > in MATH-851, a discussion about code- and comments-formatting as yet > again taken place. It is true we are a bit fuzzy on this side. I > propose to start writing something up in the developer's guide. This > will be a start, and every one of you could then comment on these > guidelines. > The idea is to gather the compulsory rules, as well as some optional > rules, which should then be complemented by the rationale for these > optional rules. > > What do you think ? Probably easiest to use the Wiki for this, at least initially. If there are compulsory rules - e.g. no tabs - a reason should be given, for example: Tab settings vary. This causes alignment issues, so tabs are banned. Generally it's easier to understand and follow rules if their purpose is made explicit. > S=E9bastien > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org > For additional commands, e-mail: dev-help@commons.apache.org > --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org For additional commands, e-mail: dev-help@commons.apache.org