GNU bug report logs - #50144
[PATCH] doc: Work around po4a doc generation hangup.

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Sergei Trofimovich <slyich <at> gmail.com>
Subject: bug#50144: closed (Re: [bug#50144] [PATCH] doc: Work around po4a
 doc generation hangup.)
Date: Sat, 21 Aug 2021 12:02:03 +0000

[Message part 1 (text/plain, inline)]

Your bug report

#50144: [PATCH] doc: Work around po4a doc generation hangup.

which was filed against the guix-patches package, has been closed.

The explanation is attached below, along with your original report.
If you require more details, please reply to 50144 <at> debbugs.gnu.org.

-- 
50144: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=50144
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: Julien Lepiller <julien <at> lepiller.eu>
To: Sergei Trofimovich <slyich <at> gmail.com>
Cc: 50144-done <at> debbugs.gnu.org
Subject: Re: [bug#50144] [PATCH] doc: Work around po4a doc generation hangup.
Date: Sat, 21 Aug 2021 14:01:37 +0200

Thanks for the patch, pushed to master as
79c07db3d52fb97f38de13d409264c5194e132fe. Sorry for all the trouble I
caused by pushing the incriminated patch, I wasn't expecting it to
break po4a!

[Message part 3 (message/rfc822, inline)]

From: Sergei Trofimovich <slyich <at> gmail.com>
To: guix-patches <at> gnu.org
Cc: Sergei Trofimovich <slyich <at> gmail.com>
Subject: [PATCH] doc: Work around po4a doc generation hangup.
Date: Sat, 21 Aug 2021 12:29:44 +0100

Multiple people are affected by 'guix pull' hangup.
The reproducer is:

    $ po4a-translate -d -M UTF-8 -L UTF-8 -k 0 -f texinfo \
      -m "doc/guix.texi" -p "po/doc/guix-manual.de.po" -l "doc/guix.de.texi.tmp"

The regression is bisected down to commit fc29c80b9
("guix: opam: More flexibility in the importer").

The workaround is to avoid multiline @code{...} directive.

* doc/guix.texi: Avoid multiline @code{...} directive.
---
 doc/guix.texi | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index 5155e67481..2b8448c856 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -11668,9 +11668,10 @@ which will be searched for packages.  It accepts as valid arguments:
 @item the name of a known repository - can be one of @code{opam},
       @code{coq} (equivalent to @code{coq-released}),
 	  @code{coq-core-dev}, @code{coq-extra-dev} or @code{grew}.
-@item the URL of a repository as expected by the @code{opam repository
-      add} command (for instance, the URL equivalent of the above
-	  @code{opam} name would be @uref{https://opam.ocaml.org}).
+@item the URL of a repository as expected by the
+      @code{opam repository add} command (for instance, the URL equivalent
+	  of the above @code{opam} name would be
+	  @uref{https://opam.ocaml.org}).
 @item the path to a local copy of a repository (a directory containing a
       @file{packages/} sub-directory).
 @end itemize
-- 
2.33.0

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.