--- Begin Message ---
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
--- End Message ---
--- Begin Message ---
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!
--- End Message ---