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

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 50144 in the body.
You can then email your comments to 50144 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

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

Message #8 received at 50144 <at> debbugs.gnu.org (full text, mbox):

From: Sergei Trofimovich <slyich <at> gmail.com>
Cc: 50144 <at> debbugs.gnu.org
Subject: Re: bug#50144: Acknowledgement ([PATCH] doc: Work around po4a doc
 generation hangup.)
Date: Sat, 21 Aug 2021 12:51:03 +0100

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

Also filed https://github.com/mquinson/po4a/issues/313 upstream in
hopes to get better at handling of such files.

-- 

  Sergei

[Message part 2 (application/pgp-signature, inline)]

Message #13 received at 50144-done <at> debbugs.gnu.org (full text, mbox):

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!

Previous Next

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