[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCHES] gnu packages: Clean up synopses and descriptions.
From: |
Alex Kost |
Subject: |
Re: [PATCHES] gnu packages: Clean up synopses and descriptions. |
Date: |
Sun, 19 Jul 2015 12:58:18 +0300 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/24.5 (gnu/linux) |
Andreas Enge (2015-07-19 00:13 +0300) wrote:
> Coming late, I have not followed the full discussion closely, so my remark
> may be out of tune.
Not too late; the final decision on lists formatting has not been made
yet. The last related post is Ludo's "Texinfo in descriptions?":
<http://lists.gnu.org/archive/html/guix-devel/2015-07/msg00471.html>.
> I think our descriptions should be formatted as simply
> as possible: just plain ascii text, which would work in any locale (or if
> you insist, maybe utf8).
>
> So far, I simply avoided lists in package descriptions; usually, by
> replacing
> "The bla package contains
> - A
> - B
> - C"
> by "The bla package contains A; B; C." or similarly.
This is good if A, B, C are not too long, but I think it is less
readable for more verbose list items (e.g., 'guile-json', 'xkb-utils',
'libdaemon', …).
--
Alex
- Re: Texinfo in descriptions?, (continued)
- Re: Texinfo in descriptions?, Ludovic Courtès, 2015/07/23
- [PATCHES] gnu packages: Clean up synopses and descriptions., Alex Kost, 2015/07/17
- Re: [PATCHES] gnu packages: Clean up synopses and descriptions., Mathieu Lirzin, 2015/07/17
- Re: [PATCHES] gnu packages: Clean up synopses and descriptions., Ludovic Courtès, 2015/07/17
- Re: [PATCHES] gnu packages: Clean up synopses and descriptions., Alex Kost, 2015/07/18
- Re: [PATCHES] gnu packages: Clean up synopses and descriptions., Andreas Enge, 2015/07/18
- Re: [PATCHES] gnu packages: Clean up synopses and descriptions.,
Alex Kost <=
Re: [PATCH] gnu packages: Clean up synopses and descriptions., Alex Kost, 2015/07/16
Re: [PATCH] gnu packages: Clean up synopses and descriptions., Eric Bavier, 2015/07/16