From mboxrd@z Thu Jan  1 00:00:00 1970
From: =?utf-8?Q?Ludovic_Court=C3=A8s?= <ludo@gnu.org>
Subject: Re: 03/04: gnu: Replace all cons* with beginner-friendly (append
	(list ...)).
Date: Wed, 23 Jan 2019 12:01:49 +0100
Message-ID: <87r2d3fxia.fsf@gnu.org>
References: <20190121211227.11235.26515@vcs0.savannah.gnu.org>
	<20190121211229.A391C209D7@vcs0.savannah.gnu.org>
	<87tvi0on8g.fsf@gnu.org> <87zhrsss61.fsf@ambrevar.xyz>
Mime-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Return-path: <guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([209.51.188.92]:49384)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ludo@gnu.org>) id 1gmGIE-0004FP-4f
	for guix-devel@gnu.org; Wed, 23 Jan 2019 06:02:07 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <ludo@gnu.org>) id 1gmGI5-0006Of-9t
	for guix-devel@gnu.org; Wed, 23 Jan 2019 06:02:00 -0500
Received: from hera.aquilenet.fr ([185.233.100.1]:37840)
	by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32)
	(Exim 4.71) (envelope-from <ludo@gnu.org>) id 1gmGI5-0006OD-3G
	for guix-devel@gnu.org; Wed, 23 Jan 2019 06:01:53 -0500
In-Reply-To: <87zhrsss61.fsf@ambrevar.xyz> (Pierre Neidhardt's message of
	"Tue, 22 Jan 2019 15:06:30 +0100")
List-Id: "Development of GNU Guix and the GNU System distribution."
	<guix-devel.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/guix-devel>,
	<mailto:guix-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/guix-devel/>
List-Post: <mailto:guix-devel@gnu.org>
List-Help: <mailto:guix-devel-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/guix-devel>,
	<mailto:guix-devel-request@gnu.org?subject=subscribe>
Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org
Sender: "Guix-devel" <guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org>
To: Pierre Neidhardt <mail@ambrevar.xyz>
Cc: guix-devel@gnu.org

Pierre Neidhardt <mail@ambrevar.xyz> skribis:

>> Please don=E2=80=99t leave hanging parens=E2=80=94we want to teach peopl=
e the Right Way
>> to format code.  ;-)
>
> I've always wondered what's the recommendation for closing parentheses af=
ter
> inline comments.

You mean =E2=80=9Cmargin comments=E2=80=9D (to the right)?

> In general, I refrain from using inline comments so I would do this:
>
>    (packages (append (list nvi fdisk
>                            ;; mostly so xrefs to its manual work:
>                            grub=20=20=20=20=20=20=20=20=20=20
>                            ;; partprobe:
>                            parted)

That would work as well.  Either way: no hanging parens.  :-)

>> Last, make sure the text in guix.texi that explains these examples does
>> not mention =E2=80=98cons*=E2=80=99.
>
> My rationale here was that I've switched to "(append (list...))" until th=
e first time we explain
> cons*, then I left the cons*.

Oh OK, perfect!

Ludo=E2=80=99.