Re: [PATCH] STYLE: Initial draft of coding style document
authorJani Nikula <jani@nikula.org>
Mon, 30 Jan 2012 16:01:15 +0000 (18:01 +0200)
committerW. Trevor King <wking@tremily.us>
Fri, 7 Nov 2014 17:43:41 +0000 (09:43 -0800)
55/5b7b985649fca82a2330caf574130193d73f3c [new file with mode: 0644]

diff --git a/55/5b7b985649fca82a2330caf574130193d73f3c b/55/5b7b985649fca82a2330caf574130193d73f3c
new file mode 100644 (file)
index 0000000..b5af180
--- /dev/null
@@ -0,0 +1,180 @@
+Return-Path: <jani@nikula.org>\r
+X-Original-To: notmuch@notmuchmail.org\r
+Delivered-To: notmuch@notmuchmail.org\r
+Received: from localhost (localhost [127.0.0.1])\r
+       by olra.theworths.org (Postfix) with ESMTP id F3C65431E64\r
+       for <notmuch@notmuchmail.org>; Mon, 30 Jan 2012 08:01:18 -0800 (PST)\r
+X-Virus-Scanned: Debian amavisd-new at olra.theworths.org\r
+X-Spam-Flag: NO\r
+X-Spam-Score: -0.699\r
+X-Spam-Level: \r
+X-Spam-Status: No, score=-0.699 tagged_above=-999 required=5\r
+       tests=[HTML_MESSAGE=0.001, RCVD_IN_DNSWL_LOW=-0.7] autolearn=disabled\r
+Received: from olra.theworths.org ([127.0.0.1])\r
+       by localhost (olra.theworths.org [127.0.0.1]) (amavisd-new, port 10024)\r
+       with ESMTP id LW6auxftsU0l for <notmuch@notmuchmail.org>;\r
+       Mon, 30 Jan 2012 08:01:18 -0800 (PST)\r
+Received: from mail-pz0-f53.google.com (mail-pz0-f53.google.com\r
+       [209.85.210.53]) (using TLSv1 with cipher RC4-SHA (128/128 bits))\r
+       (No client certificate requested)\r
+       by olra.theworths.org (Postfix) with ESMTPS id 28CE5431FBC\r
+       for <notmuch@notmuchmail.org>; Mon, 30 Jan 2012 08:01:18 -0800 (PST)\r
+Received: by dadv6 with SMTP id v6so4707384dad.26\r
+       for <notmuch@notmuchmail.org>; Mon, 30 Jan 2012 08:01:16 -0800 (PST)\r
+MIME-Version: 1.0\r
+Received: by 10.68.74.72 with SMTP id r8mr42556447pbv.8.1327939275958; Mon, 30\r
+       Jan 2012 08:01:15 -0800 (PST)\r
+Received: by 10.68.236.137 with HTTP; Mon, 30 Jan 2012 08:01:15 -0800 (PST)\r
+Received: by 10.68.236.137 with HTTP; Mon, 30 Jan 2012 08:01:15 -0800 (PST)\r
+In-Reply-To: <m2ehuhdzls.fsf@guru.guru-group.fi>\r
+References: <1327708018-1107-1-git-send-email-david@tethera.net>\r
+       <m2ehuhdzls.fsf@guru.guru-group.fi>\r
+Date: Mon, 30 Jan 2012 18:01:15 +0200\r
+Message-ID:\r
+ <CAB+hUn-o8JyWPqS+1e37m171cR04=LNOCBxFLyUiRK1vWjbe3g@mail.gmail.com>\r
+Subject: Re: [PATCH] STYLE: Initial draft of coding style document\r
+From: Jani Nikula <jani@nikula.org>\r
+To: Tomi Ollila <tomi.ollila@iki.fi>\r
+Content-Type: multipart/alternative; boundary=f46d040f9ca2d3a82204b7c0f4fc\r
+Cc: notmuch@notmuchmail.org, David Bremner <bremner@debian.org>\r
+X-BeenThere: notmuch@notmuchmail.org\r
+X-Mailman-Version: 2.1.13\r
+Precedence: list\r
+List-Id: "Use and development of the notmuch mail system."\r
+       <notmuch.notmuchmail.org>\r
+List-Unsubscribe: <http://notmuchmail.org/mailman/options/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=unsubscribe>\r
+List-Archive: <http://notmuchmail.org/pipermail/notmuch>\r
+List-Post: <mailto:notmuch@notmuchmail.org>\r
+List-Help: <mailto:notmuch-request@notmuchmail.org?subject=help>\r
+List-Subscribe: <http://notmuchmail.org/mailman/listinfo/notmuch>,\r
+       <mailto:notmuch-request@notmuchmail.org?subject=subscribe>\r
+X-List-Received-Date: Mon, 30 Jan 2012 16:01:19 -0000\r
+\r
+--f46d040f9ca2d3a82204b7c0f4fc\r
+Content-Type: text/plain; charset=UTF-8\r
+\r
+On Jan 30, 2012 4:38 PM, "Tomi Ollila" <tomi.ollila@iki.fi> wrote:\r
+>\r
+> On Fri, 27 Jan 2012 19:46:58 -0400, David Bremner <david@tethera.net>\r
+wrote:\r
+> > From: David Bremner <bremner@debian.org>\r
+>\r
+> [ ... ]\r
+>\r
+> > +\r
+> > +* Indent is 4 spaces with mixed tabs/spaces and a tab width of 8.\r
+> > +  Tabs should be only at the beginning of the line.\r
+>\r
+> So, after initial indentation (with tabs) there should not be further\r
+> tabs? We'll be using the former instead of the latter in these 2 below?\r
+\r
+I'd prefer tabs for aligning comments at the end of lines.\r
+\r
+>\r
+> /* excerpt from command-line-arguments.h -- indentation without tabs */\r
+>\r
+> enum notmuch_opt_type {\r
+>    NOTMUCH_OPT_END = 0,\r
+>    NOTMUCH_OPT_BOOLEAN,        /* --verbose              */\r
+>    NOTMUCH_OPT_INT,            /* --frob=8               */\r
+>    NOTMUCH_OPT_KEYWORD,        /* --format=raw|json|text */\r
+>    NOTMUCH_OPT_STRING,         /* --file=/tmp/gnarf.txt  */\r
+>    NOTMUCH_OPT_POSITION        /* notmuch dump pos_arg   */\r
+> };\r
+>\r
+> /* excerpt from command-line-arguments.h -- indentation with tabs */\r
+>\r
+> enum notmuch_opt_type {\r
+>    NOTMUCH_OPT_END = 0,\r
+>    NOTMUCH_OPT_BOOLEAN,        /* --verbose              */\r
+>    NOTMUCH_OPT_INT,            /* --frob=8               */\r
+>    NOTMUCH_OPT_KEYWORD,        /* --format=raw|json|text */\r
+>    NOTMUCH_OPT_STRING,         /* --file=/tmp/gnarf.txt  */\r
+>    NOTMUCH_OPT_POSITION        /* notmuch dump pos_arg   */\r
+> };\r
+>\r
+>\r
+> [ ... ]\r
+>\r
+>\r
+> Tomi\r
+> _______________________________________________\r
+> notmuch mailing list\r
+> notmuch@notmuchmail.org\r
+> http://notmuchmail.org/mailman/listinfo/notmuch\r
+\r
+--f46d040f9ca2d3a82204b7c0f4fc\r
+Content-Type: text/html; charset=UTF-8\r
+Content-Transfer-Encoding: quoted-printable\r
+\r
+<p><br>\r
+On Jan 30, 2012 4:38 PM, &quot;Tomi Ollila&quot; &lt;<a href=3D"mailto:tomi=\r
+.ollila@iki.fi">tomi.ollila@iki.fi</a>&gt; wrote:<br>\r
+&gt;<br>\r
+&gt; On Fri, 27 Jan 2012 19:46:58 -0400, David Bremner &lt;<a href=3D"mailt=\r
+o:david@tethera.net">david@tethera.net</a>&gt; wrote:<br>\r
+&gt; &gt; From: David Bremner &lt;<a href=3D"mailto:bremner@debian.org">bre=\r
+mner@debian.org</a>&gt;<br>\r
+&gt;<br>\r
+&gt; [ ... ]<br>\r
+&gt;<br>\r
+&gt; &gt; +<br>\r
+&gt; &gt; +* Indent is 4 spaces with mixed tabs/spaces and a tab width of 8=\r
+.<br>\r
+&gt; &gt; + =C2=A0Tabs should be only at the beginning of the line.<br>\r
+&gt;<br>\r
+&gt; So, after initial indentation (with tabs) there should not be further<=\r
+br>\r
+&gt; tabs? We&#39;ll be using the former instead of the latter in these 2 b=\r
+elow?</p>\r
+<p>I&#39;d prefer tabs for aligning comments at the end of lines.</p>\r
+<p>&gt;<br>\r
+&gt; /* excerpt from command-line-arguments.h -- indentation without tabs *=\r
+/<br>\r
+&gt;<br>\r
+&gt; enum notmuch_opt_type {<br>\r
+&gt; =C2=A0 =C2=A0NOTMUCH_OPT_END =3D 0,<br>\r
+&gt; =C2=A0 =C2=A0NOTMUCH_OPT_BOOLEAN, =C2=A0 =C2=A0 =C2=A0 =C2=A0/* --verb=\r
+ose =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0*/<br>\r
+&gt; =C2=A0 =C2=A0NOTMUCH_OPT_INT, =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=\r
+=A0/* --frob=3D8 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 */<br>\r
+&gt; =C2=A0 =C2=A0NOTMUCH_OPT_KEYWORD, =C2=A0 =C2=A0 =C2=A0 =C2=A0/* --form=\r
+at=3Draw|json|text */<br>\r
+&gt; =C2=A0 =C2=A0NOTMUCH_OPT_STRING, =C2=A0 =C2=A0 =C2=A0 =C2=A0 /* --file=\r
+=3D/tmp/gnarf.txt =C2=A0*/<br>\r
+&gt; =C2=A0 =C2=A0NOTMUCH_OPT_POSITION =C2=A0 =C2=A0 =C2=A0 =C2=A0/* notmuc=\r
+h dump pos_arg =C2=A0 */<br>\r
+&gt; };<br>\r
+&gt;<br>\r
+&gt; /* excerpt from command-line-arguments.h -- indentation with tabs */<b=\r
+r>\r
+&gt;<br>\r
+&gt; enum notmuch_opt_type {<br>\r
+&gt; =C2=A0 =C2=A0NOTMUCH_OPT_END =3D 0,<br>\r
+&gt; =C2=A0 =C2=A0NOTMUCH_OPT_BOOLEAN, =C2=A0 =C2=A0 =C2=A0 =C2=A0/* --verb=\r
+ose =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0*/<br>\r
+&gt; =C2=A0 =C2=A0NOTMUCH_OPT_INT, =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=\r
+=A0/* --frob=3D8 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 =C2=A0 */<br>\r
+&gt; =C2=A0 =C2=A0NOTMUCH_OPT_KEYWORD, =C2=A0 =C2=A0 =C2=A0 =C2=A0/* --form=\r
+at=3Draw|json|text */<br>\r
+&gt; =C2=A0 =C2=A0NOTMUCH_OPT_STRING, =C2=A0 =C2=A0 =C2=A0 =C2=A0 /* --file=\r
+=3D/tmp/gnarf.txt =C2=A0*/<br>\r
+&gt; =C2=A0 =C2=A0NOTMUCH_OPT_POSITION =C2=A0 =C2=A0 =C2=A0 =C2=A0/* notmuc=\r
+h dump pos_arg =C2=A0 */<br>\r
+&gt; };<br>\r
+&gt;<br>\r
+&gt;<br>\r
+&gt; [ ... ]<br>\r
+&gt;<br>\r
+&gt;<br>\r
+&gt; Tomi<br>\r
+&gt; _______________________________________________<br>\r
+&gt; notmuch mailing list<br>\r
+&gt; <a href=3D"mailto:notmuch@notmuchmail.org">notmuch@notmuchmail.org</a>=\r
+<br>\r
+&gt; <a href=3D"http://notmuchmail.org/mailman/listinfo/notmuch">http://not=\r
+muchmail.org/mailman/listinfo/notmuch</a><br>\r
+</p>\r
+\r
+--f46d040f9ca2d3a82204b7c0f4fc--\r