Re: [PATCHES] gnu packages: Clean up synopses and descriptions.

[Alex Kost <alezost@gmail.com>]

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