bug#32473: Broken menu entry in manual, section 4.1
I noticed a broken menu entry in the Info version of the Guix manual: the node `Defining Packages` (4.1) has an extra space between the last word and the closing colons: * package Reference :: The package data type The standalone Info reader tolerates it, but not the Info.vim reader, which considers the space to be part of the target node name. Neither the Texinfo manual (section 4.9) nor the Info manual seem to allow for this extra space, so it looks like a bug in the manual to me. PS: I am the author of the Info.vim reader, if that matters. https://gitlab.com/HiPhish/info.vim
bug#32473: Broken menu entry in manual, section 4.1
On Montag, 20. August 2018 12:21:07 CEST you wrote: > > The standalone Info reader tolerates it, but not the Info.vim reader, > > which > > considers the space to be part of the target node name. Neither the > > Texinfo > > manual (section 4.9) nor the Info manual seem to allow for this extra > > space, so it looks like a bug in the manual to me. > > Would it make sense for Info.vim to be bug-compatible? I considered that, but I don't think it's a good idea: it's better to fix a bug (when feasible of course) than to sweep it under the rug with some hack. If the bug is fixed, it's fixed for everyone, if I make Info.vim bug- compatible I make my reader harder to maintain and that bug still persists and will eventually bite someone when they want to implement their own Info reader.
bug#49145: Cannot build Guix (Texinfo failure)
Hello, I have been trying to build Guix from source (in order to contribute a new package), but the `make` step fails every time. I am on Void Linux (glibc) and I have checked out commit d027858e70c4a37aca90b1d4ecb2f0421a95d987. Here are the steps I took after checking out the repo: guix environment guix ./bootstrap ./configure --localstatedir=/var make The error messages are all complaining to that cross-references in Texinfo cannot be resolved. I have attached the full log. I already tried with a freshly checked out repository, and with both a pure Guix environment and a regular one. I had the same issue a couple of weeks ago, and I don't know if the issue is related to my distribution. Please let me know if you need any more information.make all-recursive make[1]: Entering directory '/home/hiphish/Developer/guix' Making all in po/guix make[2]: Entering directory '/home/hiphish/Developer/guix/po/guix' make[2]: Nothing to be done for 'all'. make[2]: Leaving directory '/home/hiphish/Developer/guix/po/guix' Making all in po/packages make[2]: Entering directory '/home/hiphish/Developer/guix/po/packages' make[2]: Nothing to be done for 'all'. make[2]: Leaving directory '/home/hiphish/Developer/guix/po/packages' make[2]: Entering directory '/home/hiphish/Developer/guix' MAKEINFO doc/guix.de.info ./doc/guix.de.texi:479: @ref reference to nonexistent node `GNU Distribution' ./doc/guix.de.texi:491: @ref reference to nonexistent node `Invoking guix package' ./doc/guix.de.texi:492: @ref reference to nonexistent node `Development' ./doc/guix.de.texi:493: @ref reference to nonexistent node `Utilities' ./doc/guix.de.texi:494: @ref reference to nonexistent node `Programming Interface' ./doc/guix.de.texi:497: @ref reference to nonexistent node `Setting Up the Daemon' ./doc/guix.de.texi:499: @ref reference to nonexistent node `Substitutes' ./doc/guix.de.texi:506: @ref reference to nonexistent node `Defining Packages' ./doc/guix.de.texi:508: @ref reference to nonexistent node `Package Modules' ./doc/guix.de.texi:510: @ref reference to nonexistent node `Package Transformation Options' ./doc/guix.de.texi:516: @ref reference to nonexistent node `Acknowledgments' ./doc/guix.de.texi:533: @ref reference to nonexistent node `The Store' ./doc/guix.de.texi:542: @ref reference to nonexistent node `Features' ./doc/guix.de.texi:553: @ref reference to nonexistent node `System Installation' ./doc/guix.de.texi:564: @ref reference to nonexistent node `Invoking guix package' ./doc/guix.de.texi:601: @ref reference to nonexistent node `Contributing' ./doc/guix.de.texi:618: @ref reference to nonexistent node `Substitutes' ./doc/guix.de.texi:619: @ref reference to nonexistent node `Tracking Bugs and Patches' ./doc/guix.de.texi:629: @ref reference to nonexistent node `System Configuration' ./doc/guix.de.texi:640: @ref reference to nonexistent node `Porting' ./doc/guix.de.texi:643: @ref reference to nonexistent node `Contributing' ./doc/guix.de.texi:661: @ref reference to nonexistent node `System Installation' ./doc/guix.de.texi:676: @ref reference to nonexistent node `Invoking guix pull' ./doc/guix.de.texi:725: @ref reference to nonexistent node `Application Setup' ./doc/guix.de.texi:727: @ref reference to nonexistent node `Getting Started' ./doc/guix.de.texi:740: @ref reference to nonexistent node `GNU Distribution' ./doc/guix.de.texi:780: @ref reference to nonexistent node `The Store' ./doc/guix.de.texi:797: @ref reference to nonexistent node `Invoking guix pull' ./doc/guix.de.texi:815: @ref reference to nonexistent node `Build Environment Setup' ./doc/guix.de.texi:883: @pxref reference to nonexistent node `Substitutes' ./doc/guix.de.texi:896: @xref reference to nonexistent node `On Trusting Binaries' ./doc/guix.de.texi:902: @ref reference to nonexistent node `Application Setup' ./doc/guix.de.texi:930: @ref reference to nonexistent node `Invoking guix pack' ./doc/guix.de.texi:976: @ref reference to nonexistent node `Daemon Offload Setup' ./doc/guix.de.texi:977: @ref reference to nonexistent node `Invoking guix copy' ./doc/guix.de.texi:984: @ref reference to nonexistent node `Invoking guix publish' ./doc/guix.de.texi:988: @ref reference to nonexistent node `Invoking guix import' ./doc/guix.de.texi:992: @ref reference to nonexistent node `Invoking guix import' ./doc/guix.de.texi:993: @ref reference to nonexistent node `Invoking guix refresh' ./doc/guix.de.texi:1019: @ref reference to nonexistent node `The Store' ./doc/guix.de.texi:1097: @ref reference to nonexistent node `Requirements' ./doc/guix.de.texi:1121: @ref reference to nonexistent node `Substitutes' ./doc/guix.de.texi:1141: @ref reference to nonexist
bug#49145: Cannot build Guix (Texinfo failure)
I had already tried with `--pure` initially. Here is the output from the pure environment attached anyway, just in case. On Tuesday, 22 June 2021 14:06:59 CEST Julien Lepiller wrote: > Something seems to have gone wrong with the i18n code. Maybe we use > something that's not recognized by your shell? Can you try again, but this > time configure and make in a pure environment? (Add --pure to the guix > environment invocation). > Le 20 juin 2021 17:37:34 GMT-04:00, HiPhish a écrit : > >Hello, > > > >I have been trying to build Guix from source (in order to contribute a > >new > >package), but the `make` step fails every time. I am on Void Linux > >(glibc) and > >I have checked out commit d027858e70c4a37aca90b1d4ecb2f0421a95d987. > > > >Here are the steps I took after checking out the repo: > >guix environment guix > >./bootstrap > >./configure --localstatedir=/var > >make > > > >The error messages are all complaining to that cross-references in > >Texinfo > >cannot be resolved. I have attached the full log. I already tried with > >a > >freshly checked out repository, and with both a pure Guix environment > >and a > >regular one. > > > >I had the same issue a couple of weeks ago, and I don't know if the > >issue is > >related to my distribution. Please let me know if you need any more > >information. make all-recursive make[1]: Entering directory '/home/hiphish/Developer/guix' Making all in po/guix make[2]: Entering directory '/home/hiphish/Developer/guix/po/guix' make[2]: Nothing to be done for 'all'. make[2]: Leaving directory '/home/hiphish/Developer/guix/po/guix' Making all in po/packages make[2]: Entering directory '/home/hiphish/Developer/guix/po/packages' make[2]: Nothing to be done for 'all'. make[2]: Leaving directory '/home/hiphish/Developer/guix/po/packages' make[2]: Entering directory '/home/hiphish/Developer/guix' MAKEINFO doc/guix.info MAKEINFO doc/guix.de.info ./doc/guix.de.texi:479: @ref reference to nonexistent node `GNU Distribution' ./doc/guix.de.texi:491: @ref reference to nonexistent node `Invoking guix package' ./doc/guix.de.texi:492: @ref reference to nonexistent node `Development' ./doc/guix.de.texi:493: @ref reference to nonexistent node `Utilities' ./doc/guix.de.texi:494: @ref reference to nonexistent node `Programming Interface' ./doc/guix.de.texi:497: @ref reference to nonexistent node `Setting Up the Daemon' ./doc/guix.de.texi:499: @ref reference to nonexistent node `Substitutes' ./doc/guix.de.texi:506: @ref reference to nonexistent node `Defining Packages' ./doc/guix.de.texi:508: @ref reference to nonexistent node `Package Modules' ./doc/guix.de.texi:510: @ref reference to nonexistent node `Package Transformation Options' ./doc/guix.de.texi:516: @ref reference to nonexistent node `Acknowledgments' ./doc/guix.de.texi:533: @ref reference to nonexistent node `The Store' ./doc/guix.de.texi:542: @ref reference to nonexistent node `Features' ./doc/guix.de.texi:553: @ref reference to nonexistent node `System Installation' ./doc/guix.de.texi:564: @ref reference to nonexistent node `Invoking guix package' ./doc/guix.de.texi:601: @ref reference to nonexistent node `Contributing' ./doc/guix.de.texi:618: @ref reference to nonexistent node `Substitutes' ./doc/guix.de.texi:619: @ref reference to nonexistent node `Tracking Bugs and Patches' ./doc/guix.de.texi:629: @ref reference to nonexistent node `System Configuration' ./doc/guix.de.texi:640: @ref reference to nonexistent node `Porting' ./doc/guix.de.texi:643: @ref reference to nonexistent node `Contributing' ./doc/guix.de.texi:661: @ref reference to nonexistent node `System Installation' ./doc/guix.de.texi:676: @ref reference to nonexistent node `Invoking guix pull' ./doc/guix.de.texi:725: @ref reference to nonexistent node `Application Setup' ./doc/guix.de.texi:727: @ref reference to nonexistent node `Getting Started' ./doc/guix.de.texi:740: @ref reference to nonexistent node `GNU Distribution' ./doc/guix.de.texi:780: @ref reference to nonexistent node `The Store' ./doc/guix.de.texi:797: @ref reference to nonexistent node `Invoking guix pull' ./doc/guix.de.texi:815: @ref reference to nonexistent node `Build Environment Setup' ./doc/guix.de.texi:883: @pxref reference to nonexistent node `Substitutes' ./doc/guix.de.texi:896: @xref reference to nonexistent node `On Trusting Binaries' ./doc/guix.de.texi:902: @ref reference to nonexistent node `Application Setup' ./doc/guix.de.texi:930: @ref reference to nonexistent node `Invoking guix pack' ./doc/guix.de.texi:976: @ref reference to no
bug#49145: Cannot build Guix (Texinfo failure)
I actually looked into the offending files and I found that they are only half- translated. Part of them is in German, but some parts are in English, and the English parts are referencing English node names, which obviously do not exist in the German manual. I do not need the German manual, is there a way to skip it? A quick glance shows the same problem in the Spanish manual as well, and other manuals are probably affected as well. I don't know why `make` only choked up on the German manual though. Maybe because that's the first one in alphabetical order and `make` did not bother trying the rest? Or could it be because my machine is in Germany? The output of the `locale` command is: $ locale LANG=en_GB.UTF-8 LC_CTYPE="en_GB.UTF-8" LC_NUMERIC="en_GB.UTF-8" LC_TIME="en_GB.UTF-8" LC_COLLATE=C LC_MONETARY="en_GB.UTF-8" LC_MESSAGES="en_GB.UTF-8" LC_PAPER="en_GB.UTF-8" LC_NAME="en_GB.UTF-8" LC_ADDRESS="en_GB.UTF-8" LC_TELEPHONE="en_GB.UTF-8" LC_MEASUREMENT="en_GB.UTF-8" LC_IDENTIFICATION="en_GB.UTF-8" LC_ALL= And when inside a pure Guix environment: $ locale LANG= LC_CTYPE="POSIX" LC_NUMERIC="POSIX" LC_TIME="POSIX" LC_COLLATE="POSIX" LC_MONETARY="POSIX" LC_MESSAGES="POSIX" LC_PAPER="POSIX" LC_NAME="POSIX" LC_ADDRESS="POSIX" LC_TELEPHONE="POSIX" LC_MEASUREMENT="POSIX" LC_IDENTIFICATION="POSIX" LC_ALL=
bug#49145: Cannot build Guix (Texinfo failure)
Do you mean like this? $ make --file=doc/local.mk xref_command doc/local.mk:219: *** missing separator. Stop. On Saturday, 26 June 2021 12:58:03 CEST Julien Lepiller wrote: > The process for translating the manual is as follows: we use po4a to replace > English strings with the target language's strings. At this point, the > translation contains English node names. Then, the Makefile is supposed to > replace these with the actual translation of the node names (that way even > untranslated strings refer to the correct nodes). However, it seems that in > your case, that process did not go well. > > I'd rather try to fix the issue than avoid it, but you can always remove > references to the translated manual from doc/local.mk. > > Can you try running the xref command from doc/local.mk manually, to see if > it's doing anything wrong?
bug#49145: Cannot build Guix (Texinfo failure)
*bump* Any idea, or anything I can try?
bug#49145: Solved, I guess
I recently had to re-install my system due to a data loss. When I tried building Guix on the fresh Void install everything worked out, so I guess this issue can be closed now. I still don't know what went wrong, but it must have been something peculiar about my previous setup, either on the Guix side or on the Void side, or the bug simply got fixed upstream. I don't know.
