GNU bug report logs - #75625
link in manual to Debbugs User Guide does not work

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 75625 in the body.
You can then email your comments to 75625 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: "Dr. Arne Babenhauserheide" <arne_bab <at> web.de>
To: bug-guix <at> gnu.org
Subject: link in manual to Debbugs User Guide does not work
Date: Fri, 17 Jan 2025 08:41:42 +0100

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

Dear Guix hackers,

the link in the Guix manual to the Debbugs User Guide does not work in
the web:

https://guix.gnu.org/manual/en/html_node/Debbugs-User-Interfaces.html

It’s defined in
./doc/contributing.texi:2537:@xref{Top,,, debbugs-ug, Debbugs User Guide}, for more information on

but I do not know how to fix it.

Best wishes,
Arne
-- 
Unpolitisch sein
heißt politisch sein,
ohne es zu merken.
draketo.de

[signature.asc (application/pgp-signature, inline)]

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

From: jgart <jgart <at> dismail.de>
To: 75625 <at> debbugs.gnu.org
Cc: "Dr. Arne Babenhauserheide" <arne_bab <at> web.de>
Subject: Re: link in manual to Debbugs User Guide does not work
Date: Fri, 17 Jan 2025 12:33:51 -0600

Hmmm, yeah, I don't know the texinfo arcana to fix that either... 🦆

-- 
all the best,
jgart

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

From: Tomas Volf <~@wolfsden.cz>
To: 75625 <at> debbugs.gnu.org
Cc: Tomas Volf <~@wolfsden.cz>
Subject: [PATCH 2/4] doc: htmlxref.cnf: Trim trailing whitespace characters.
Date: Wed, 22 Jan 2025 20:05:18 +0100

Change-Id: Idda2684864248b1ef11acff31bc145b1cbdabe9d
---
 doc/htmlxref.cnf | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/doc/htmlxref.cnf b/doc/htmlxref.cnf
index 46a396bcad..e1f3415fc0 100644
--- a/doc/htmlxref.cnf
+++ b/doc/htmlxref.cnf
@@ -5,7 +5,7 @@
 htmlxrefversion=2025-01-22.18; # UTC
 
 # Copyright 2010-2020, 2022 Free Software Foundation, Inc.
-# 
+#
 # Copying and distribution of this file, with or without modification,
 # are permitted in any medium without royalty provided the copyright
 # notice and this notice are preserved.
@@ -24,10 +24,10 @@ htmlxrefversion=2025-01-22.18; # UTC
 # - follow the naming convention for nodes described at
 # http://www.gnu.org/software/texinfo/manual/texinfo/html_node/HTML-Xref.html
 #   This is what makeinfo and texi2html implement.
-# 
+#
 # Unless the above criteria are met, it's not possible to generate
 # reliable cross-manual references.
-# 
+#
 # For information on automatically generating all the useful formats for
 # a manual to put on the web, see
 # http://www.gnu.org/prep/maintain/html_node/Manuals-on-Web-Pages.html.
-- 
2.47.1

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

From: Tomas Volf <~@wolfsden.cz>
To: 75625 <at> debbugs.gnu.org
Cc: Tomas Volf <~@wolfsden.cz>
Subject: [PATCH 3/4] doc: htmlxref.cnf: Add link to debbugs-ug.
Date: Wed, 22 Jan 2025 20:05:19 +0100

* doc/htmlxref.cnf (ELPA, ELPA_DOC): New variables.
(debbugs-ug): Define `mono' version.

Change-Id: I3a914354df732ec8d2cc92d56e551ba63c723041
---
 doc/htmlxref.cnf | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/doc/htmlxref.cnf b/doc/htmlxref.cnf
index e1f3415fc0..bd7cf72db4 100644
--- a/doc/htmlxref.cnf
+++ b/doc/htmlxref.cnf
@@ -715,6 +715,11 @@ latex2e		mono	${T}/latex2e.html
 tlbuild		mono	${T}/tlbuild.html
 web2c		mono	${T}/web2c.html
 
+ELPA     = https://elpa.gnu.org
+ELPA_DOC = ${ELPA}/packages/doc
+
+debbugs-ug	mono	${ELPA_DOC}/debbugs-ug.html
+
 
 # Local Variables:
 # eval: (add-hook 'write-file-functions 'time-stamp)
-- 
2.47.1

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

From: Tomas Volf <~@wolfsden.cz>
To: 75625 <at> debbugs.gnu.org
Cc: Tomas Volf <~@wolfsden.cz>
Subject: [PATCH 1/4] doc: htmlxref.cnf: Use write-file-functions.
Date: Wed, 22 Jan 2025 20:05:17 +0100

The write-file-hooks is deprecated since Emacs 22.1, so switch to the
suggested replacement.

* doc/htmlxref.cnf (add-hook): Use 'write-file-functions.

Change-Id: Ia652ace9a5b5ffb971999372348fa4133f909a4e
---
 doc/htmlxref.cnf | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/doc/htmlxref.cnf b/doc/htmlxref.cnf
index dc819a92ad..46a396bcad 100644
--- a/doc/htmlxref.cnf
+++ b/doc/htmlxref.cnf
@@ -1,7 +1,8 @@
 # htmlxref.cnf - reference file for free Texinfo manuals on the web.
 # Modified by Ludovic Courtès <ludo <at> gnu.org> for the GNU Guix manual.
+# Further modified by Tomas Volf <~@wolfsden.cz>.
 
-htmlxrefversion=2024-06-02.15; # UTC
+htmlxrefversion=2025-01-22.18; # UTC
 
 # Copyright 2010-2020, 2022 Free Software Foundation, Inc.
 # 
@@ -716,7 +717,7 @@ web2c		mono	${T}/web2c.html
 
 
 # Local Variables:
-# eval: (add-hook 'write-file-hooks 'time-stamp)
+# eval: (add-hook 'write-file-functions 'time-stamp)
 # time-stamp-start: "htmlxrefversion="
 # time-stamp-format: "%:y-%02m-%02d.%02H"
 # time-stamp-time-zone: "UTC"
-- 
2.47.1

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

From: Tomas Volf <~@wolfsden.cz>
To: 75625 <at> debbugs.gnu.org
Cc: Tomas Volf <~@wolfsden.cz>
Subject: [PATCH 4/4] doc: htmlxref.cnf: Fix link to The GNU Stow Manual.
Date: Wed, 22 Jan 2025 20:05:20 +0100

At the same time the reference text is adjusted.  I found it confusing for
link to the `Top' to be labeled `Introduction'.  So let us just link to the
`Introduction', it is probably what the author intended.

* doc/htmlxref.cnf (stow): Add both mono and node versions.
* doc/guix.texi (Essential Home Services): Link to `Introduction' node of GNU
Stow's manual.

Change-Id: Ib82d2eecfb655694a0af73e1aec9fcd68c3994e3
---
 doc/guix.texi    | 5 +++--
 doc/htmlxref.cnf | 3 +++
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/doc/guix.texi b/doc/guix.texi
index 3b32d5408e..a8d69fe73f 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -46645,8 +46645,9 @@ Essential Home Services
 @end example
 
 For an informal specification please refer to the Stow manual
-(@pxref{Top,,, stow, Introduction}). This tree structure is installed following
-GNU Stow's logic to the home directory upon @command{guix home reconfigure}.
+(@pxref{Introduction,,, stow, The GNU Stow Manual}). This tree structure
+is installed following GNU Stow's logic to the home directory upon
+@command{guix home reconfigure}.
 
 A suitable configuration with a @code{'plain} layout could be:
 
diff --git a/doc/htmlxref.cnf b/doc/htmlxref.cnf
index bd7cf72db4..34e1745e51 100644
--- a/doc/htmlxref.cnf
+++ b/doc/htmlxref.cnf
@@ -665,6 +665,9 @@ sqltutor	node	${GS}/sqltutor/manual/html_node/
 
 src-highlite	mono	${GS}/src-highlite/source-highlight.html
 
+stow		mono	${GS}/stow/manual/stow.html
+stow		node	${GS}/stow/manual/html_node/
+
 swbis		mono	${GS}/swbis/manual.html
 
 tar		mono	${GS}/tar/manual/tar.html
-- 
2.47.1

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

From: Tomas Volf <~@wolfsden.cz>
To: jgart via Bug reports for GNU Guix <bug-guix <at> gnu.org>
Cc: 75625 <at> debbugs.gnu.org, jgart <jgart <at> dismail.de>, "Dr. Arne
 Babenhauserheide" <arne_bab <at> web.de>
Subject: Re: bug#75625: link in manual to Debbugs User Guide does not work
Date: Wed, 22 Jan 2025 20:08:35 +0100

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

jgart via Bug reports for GNU Guix <bug-guix <at> gnu.org> writes:

> Hmmm, yeah, I don't know the texinfo arcana to fix that either... 🦆

I took the liberty to send a patch fixing the reported issue.  There are
few more remaining (in the EN manual):

--8<---------------cut here---------------start------------->8---
guix.texi:14144: warning: no htmlxref.cnf entry found for `guile-gcrypt'
guix.texi:20311: warning: no htmlxref.cnf entry found for `gpm'
guix.texi:21423: warning: no htmlxref.cnf entry found for `qemu'
guix.texi:47685: warning: no htmlxref.cnf entry found for `pinentry'
guix.texi:50444: warning: no htmlxref.cnf entry found for `gash'
--8<---------------cut here---------------end--------------->8---

I leave fixing those as an exercise to the reader.  (Mainly because I
did not really find an usable HTML version of their info pages.)

Have a nice day,
Tomas

-- 
There are only two hard things in Computer Science:
cache invalidation, naming things and off-by-one errors.

[signature.asc (application/pgp-signature, inline)]

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

From: Maxim Cournoyer <maxim.cournoyer <at> gmail.com>
To: Tomas Volf <~@wolfsden.cz>
Cc: 75625-done <at> debbugs.gnu.org, Jorge Gomez <jgart <at> dismail.de>,
 Ludovic Courtès <ludo <at> gnu.org>,
 Arne Babenhauserheide <arne_bab <at> web.de>
Subject: Re: bug#75625: link in manual to Debbugs User Guide does not work
Date: Fri, 24 Jan 2025 00:25:22 +0900

Hi Tomas,

I've pushed your fixes, thank you.

As mentioned in a comment at the top of htmlxref.cnf, would you mind
submitting a diff of our copy from the version hosted here:
http://ftpmirror.gnu.org/texinfo/htmlxref.cnf and email it to
bug-texinfo <at> gnu.org so they may update it with our additions?

-- 
Thanks,
Maxim

Previous Next

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