From mboxrd@z Thu Jan 1 00:00:00 1970 From: Alex Kost Subject: Re: [PATCHES] gnu packages: Clean up synopses and descriptions. Date: Sun, 19 Jul 2015 12:58:18 +0300 Message-ID: <87h9p0o4ed.fsf@gmail.com> References: <87wpy0nygt.fsf@gmail.com> <87y4ige2ux.fsf@openmailbox.org> <87wpy0t83c.fsf@gnu.org> <87h9p3dkry.fsf_-_@gmail.com> <87615itqu3.fsf@gnu.org> <87380l3hil.fsf@gmail.com> <20150718211303.GA3038@debian> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:33043) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZGlMR-0006tC-GZ for guix-devel@gnu.org; Sun, 19 Jul 2015 05:58:20 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZGlMO-0002aJ-CE for guix-devel@gnu.org; Sun, 19 Jul 2015 05:58:19 -0400 Received: from mail-lb0-x22b.google.com ([2a00:1450:4010:c04::22b]:33903) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZGlMO-0002aB-3o for guix-devel@gnu.org; Sun, 19 Jul 2015 05:58:16 -0400 Received: by lbbzr7 with SMTP id zr7so80618736lbb.1 for ; Sun, 19 Jul 2015 02:58:14 -0700 (PDT) In-Reply-To: <20150718211303.GA3038@debian> (Andreas Enge's message of "Sat, 18 Jul 2015 23:13:03 +0200") List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-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: Andreas Enge Cc: guix-devel@gnu.org 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?": . > 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', =E2=80=A6). --=20 Alex