From mboxrd@z Thu Jan 1 00:00:00 1970 From: ludo@gnu.org (Ludovic =?utf-8?Q?Court=C3=A8s?=) Subject: Re: Texinfo in descriptions? Date: Fri, 04 Sep 2015 00:12:38 +0200 Message-ID: <87bndjxicp.fsf@gnu.org> References: <87wpy0nygt.fsf@gmail.com> <87y4ige2ux.fsf@openmailbox.org> <87wpy0t83c.fsf@gnu.org> <87r3o7pz3h.fsf@openmailbox.org> <87y4ietrdz.fsf_-_@gnu.org> <874mkx8a5o.fsf@openmailbox.org> <87wpxs9ux0.fsf@gnu.org> <87h9ov51j9.fsf@gnu.org> <87a8tcfnox.fsf@openmailbox.org> <87a8tbf5lu.fsf@openmailbox.org> <87613wlmgv.fsf@gnu.org> <87zj18ik3d.fsf@openmailbox.org> <87egij2lyi.fsf@gnu.org> <87oahk8qbh.fsf@openmailbox.org> 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]:37825) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZXckR-0003bM-M8 for guix-devel@gnu.org; Thu, 03 Sep 2015 18:12:48 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZXckQ-0008HL-Gz for guix-devel@gnu.org; Thu, 03 Sep 2015 18:12:47 -0400 In-Reply-To: <87oahk8qbh.fsf@openmailbox.org> (Mathieu Lirzin's message of "Wed, 02 Sep 2015 23:27:30 +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: Mathieu Lirzin Cc: guix-devel@gnu.org, Alex Kost Mathieu Lirzin skribis: > From e691c2080929dd1390184ab4669de8b2695a237f Mon Sep 17 00:00:00 2001 > From: Mathieu Lirzin > Date: Fri, 7 Aug 2015 00:10:43 +0200 > Subject: [PATCH] ui: Add package-description-string. > > Provide support for Texinfo's markup in package description. > > * guix/ui.scm (%text-width, %initial-indent): New parameters. > (package-description-string): New variable. > (package->recutils): Use them. > * emacs/guix-main.scm (%package-param-alist): Use it. > * gnu/packages/databases.scm (perl-dbd-pg): Adapt to Texinfo's markup. > * gnu/packages/perl.scm (perl-devel-globaldestruction) > (perl-devel-lexalias, perl-exporter-lite): Likewise. > * gnu/packages/python.scm (python2-empy): Likewise. [...] > +++ b/gnu/packages/databases.scm > @@ -578,7 +578,7 @@ columns, primary keys, unique constraints and relatio= nships.") > ("postgresql" ,postgresql))) > (home-page "http://search.cpan.org/dist/DBD-Pg") > (synopsis "DBI PostgreSQL interface") > - (description "") > + (description #f) Weird, and doesn=E2=80=99t really match the commit log. Maybe this hunk ca= n be removed? > +(set! (@@ (texinfo plain-text) wrap*) > + ;; Monkey patch this private procedure to let 'package->recutils' ^ Please prepend =E2=80=9CXXX=E2=80=9D here to make the kludge more visible. = (Eventually we should fix it in Guile.) I tried adding an @itemize list in a description and noticed that the initial indent is not working the way I thought: --8<---------------cut here---------------start------------->8--- $ ./pre-inst-env guix package --show=3Demacs-let-alist name: emacs-let-alist version: 1.0.4 outputs: out systems: x86_64-linux i686-linux armhf-linux mips64el-linux dependencies: emacs-no-x-24.5 location: gnu/packages/emacs.scm:491:2 homepage: http://elpa.gnu.org/packages/let-alist.html license: GPL 3+ synopsis: Easily let-bind values of an assoc-list by their names description: This package offers a single Emacs Lisp macro, `let-alist'. T= his + macro takes a first argument, whose value must be an alist (association l= ist), + and a body. +=20 + des* iption: one +=20 + des* iption: two +=20 + des* iption: three +=20 + description: The macro expands to a let form containing the body, where e= ach + dotted symbol inside body is let-bound to their cdrs in the alist. Only = those + present in the body are let-bound and this search is done at compile time. --8<---------------cut here---------------end--------------->8--- Notice how =E2=80=9Cdescription:=E2=80=9D is repeated for each @item and fo= r the next paragraph. I wonder if using =E2=80=98fill-paragraph=E2=80=99 instead of =E2=80=98fill= -string=E2=80=99 would solve this. Could you look into it? Sorry for not noticing earlier! Thanks, Ludo=E2=80=99.