From mboxrd@z Thu Jan  1 00:00:00 1970
From: ludo@gnu.org (Ludovic =?utf-8?Q?Court=C3=A8s?=)
Subject: Re: Formatting lists in descriptions
Date: Tue, 14 Jul 2015 15:23:47 +0200
Message-ID: <874ml6swik.fsf@gnu.org>
References: <87wpy5uvd8.fsf@gmail.com> <877fq4yol1.fsf@gnu.org>
	<87wpy3xhoy.fsf_-_@gmail.com>
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 ([2001:4830:134:3::10]:45471)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <ludo@gnu.org>) id 1ZF0Bc-0002Va-6J
	for guix-devel@gnu.org; Tue, 14 Jul 2015 09:23:53 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <ludo@gnu.org>) id 1ZF0Bb-00087G-8c
	for guix-devel@gnu.org; Tue, 14 Jul 2015 09:23:52 -0400
In-Reply-To: <87wpy3xhoy.fsf_-_@gmail.com> (Alex Kost's message of "Tue, 14
	Jul 2015 11:32:45 +0300")
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-bounces+gcggd-guix-devel=m.gmane.org@gnu.org
To: Alex Kost <alezost@gmail.com>
Cc: guix-devel@gnu.org

Alex Kost <alezost@gmail.com> skribis:

> Ludovic Court=C3=A8s (2015-07-13 20:06 +0300) wrote:

[...]

>> Formatting will be lost in UIs, so this should be a comma-separated list
>> instead.
>
> Currently the formatting is not lost in Emacs UI, but I agree on this one.

The --show and --search options fill paragraphs, and now the Emacs UI
does as well.  :-)  Same for guix-web, where the browser automatically
fills things.

> What about separating such entries with newspaces as it is done in some
> other packages (e.g., 'signing-party') to prevent the format breaking?:

Yes, why not; it=E2=80=99s still not very pleasant to the eye but at least =
it
formatting will be preserved (except for guix-web, but we can fix it
later.)

> And as I have an unhealthy desire to organize the same things in the
> same manner, what variant to choose for formatting lists?  Should the
> list items begin with "-" or "+" or "*" or "=E2=80=A2" and should there b=
e spaces
> before the chosen symbol or maybe there should be just a couple of
> spaces without any marker?

I have a slight preference for =E2=80=A2 (which is the standard thing in
English, AIUI), preceded by two spaces.

The downside is that it won=E2=80=99t render properly on non-Unicode capable
terminals (and in a non-Unicode-capable locale, Guile will emit a
question mark instead), but I think that=E2=80=99s a price I don=E2=80=99t =
mind paying.

Thoughts?

Thanks,
Ludo=E2=80=99.