From mboxrd@z Thu Jan  1 00:00:00 1970
From: Pierre Neidhardt <mail@ambrevar.xyz>
Subject: Re: 03/04: gnu: Replace all cons* with beginner-friendly (append
	(list ...)).
Date: Tue, 22 Jan 2019 15:06:30 +0100
Message-ID: <87zhrsss61.fsf@ambrevar.xyz>
References: <20190121211227.11235.26515@vcs0.savannah.gnu.org>
	<20190121211229.A391C209D7@vcs0.savannah.gnu.org>
	<87tvi0on8g.fsf@gnu.org>
Mime-Version: 1.0
Content-Type: multipart/signed; boundary="=-=-=";
	micalg=pgp-sha256; protocol="application/pgp-signature"
Return-path: <guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([209.51.188.92]:51773)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <mail@ambrevar.xyz>) id 1gm1A1-0000gz-Aa
	for guix-devel@gnu.org; Tue, 22 Jan 2019 13:52:34 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <mail@ambrevar.xyz>) id 1gm19z-0000IY-0F
	for guix-devel@gnu.org; Tue, 22 Jan 2019 13:52:33 -0500
In-reply-to: <87tvi0on8g.fsf@gnu.org>
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: Ludovic =?utf-8?Q?Court=C3=A8s?= <ludo@gnu.org>
Cc: guix-devel@gnu.org

--=-=-=
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable


> Please don=E2=80=99t leave hanging parens=E2=80=94we want to teach people=
 the Right Way
> to format code.  ;-)

I've always wondered what's the recommendation for closing parentheses after
inline comments.

In general, I refrain from using inline comments so I would do this:

=2D-8<---------------cut here---------------start------------->8---
   (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)
=2D-8<---------------cut here---------------end--------------->8---

> 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 the =
first time we explain
cons*, then I left the cons*.

=2D-=20
Pierre Neidhardt
https://ambrevar.xyz/

--=-=-=
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQEzBAEBCAAdFiEEUPM+LlsMPZAEJKvom9z0l6S7zH8FAlxHI2YACgkQm9z0l6S7
zH8BQggArU0YJZ32UQ9p14yzOus8r51O5xf6h88orvqf5VTnM3EVAknQ7K4QyAjN
CJ/6bClADtmaFqSx9okMY3GIUDoMwrDvo9B3lM3jDWsalmbu6JkFIfwsOOW1tMA3
8WTkqidn4YTH1hTcR7kR9GtAXd61oLHqbshQ37YX+MKDCNRvmVg1Qe5+WLJeEGH9
r7zxGyOUPSBx3qsRw6Kvcxby4FeqHbNHci2czbHiNH8CazZ1oKnaP5yo3OJEto57
g56Z6SnvLwVNfhLRghUK2WAd1apqrQTjkm+InBEls32GRwIyjRGmerLwxb66VHl6
s32XjlJjceKhoL07VPSoV1uTV+6qmw==
=olJG
-----END PGP SIGNATURE-----
--=-=-=--