unofficial mirror of bug-guix@gnu.org 
 help / color / mirror / code / Atom feed
* bug#75625: link in manual to Debbugs User Guide does not work
@ 2025-01-17  7:41 Dr. Arne Babenhauserheide via Bug reports for GNU Guix
  2025-01-17 18:33 ` jgart via Bug reports for GNU Guix
  2025-01-22 19:05 ` bug#75625: [PATCH 1/4] doc: htmlxref.cnf: Use write-file-functions Tomas Volf
  0 siblings, 2 replies; 8+ messages in thread
From: Dr. Arne Babenhauserheide via Bug reports for GNU Guix @ 2025-01-17  7:41 UTC (permalink / raw)
  To: 75625

[-- Attachment #1: Type: text/plain, Size: 435 bytes --]

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

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 1125 bytes --]

^ permalink raw reply	[flat|nested] 8+ messages in thread

* bug#75625: link in manual to Debbugs User Guide does not work
  2025-01-17  7:41 bug#75625: link in manual to Debbugs User Guide does not work Dr. Arne Babenhauserheide via Bug reports for GNU Guix
@ 2025-01-17 18:33 ` jgart via Bug reports for GNU Guix
  2025-01-22 19:08   ` Tomas Volf
  2025-01-22 19:05 ` bug#75625: [PATCH 1/4] doc: htmlxref.cnf: Use write-file-functions Tomas Volf
  1 sibling, 1 reply; 8+ messages in thread
From: jgart via Bug reports for GNU Guix @ 2025-01-17 18:33 UTC (permalink / raw)
  To: 75625; +Cc: Dr. Arne Babenhauserheide


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

-- 
all the best,
jgart




^ permalink raw reply	[flat|nested] 8+ messages in thread

* bug#75625: [PATCH 1/4] doc: htmlxref.cnf: Use write-file-functions.
  2025-01-17  7:41 bug#75625: link in manual to Debbugs User Guide does not work Dr. Arne Babenhauserheide via Bug reports for GNU Guix
  2025-01-17 18:33 ` jgart via Bug reports for GNU Guix
@ 2025-01-22 19:05 ` Tomas Volf
  2025-01-22 19:05   ` bug#75625: [PATCH 2/4] doc: htmlxref.cnf: Trim trailing whitespace characters Tomas Volf
                     ` (2 more replies)
  1 sibling, 3 replies; 8+ messages in thread
From: Tomas Volf @ 2025-01-22 19:05 UTC (permalink / raw)
  To: 75625; +Cc: Tomas Volf

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@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





^ permalink raw reply related	[flat|nested] 8+ messages in thread

* bug#75625: [PATCH 2/4] doc: htmlxref.cnf: Trim trailing whitespace characters.
  2025-01-22 19:05 ` bug#75625: [PATCH 1/4] doc: htmlxref.cnf: Use write-file-functions Tomas Volf
@ 2025-01-22 19:05   ` Tomas Volf
  2025-01-22 19:05   ` bug#75625: [PATCH 3/4] doc: htmlxref.cnf: Add link to debbugs-ug Tomas Volf
  2025-01-22 19:05   ` bug#75625: [PATCH 4/4] doc: htmlxref.cnf: Fix link to The GNU Stow Manual Tomas Volf
  2 siblings, 0 replies; 8+ messages in thread
From: Tomas Volf @ 2025-01-22 19:05 UTC (permalink / raw)
  To: 75625; +Cc: Tomas Volf

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





^ permalink raw reply related	[flat|nested] 8+ messages in thread

* bug#75625: [PATCH 3/4] doc: htmlxref.cnf: Add link to debbugs-ug.
  2025-01-22 19:05 ` bug#75625: [PATCH 1/4] doc: htmlxref.cnf: Use write-file-functions Tomas Volf
  2025-01-22 19:05   ` bug#75625: [PATCH 2/4] doc: htmlxref.cnf: Trim trailing whitespace characters Tomas Volf
@ 2025-01-22 19:05   ` Tomas Volf
  2025-01-22 19:05   ` bug#75625: [PATCH 4/4] doc: htmlxref.cnf: Fix link to The GNU Stow Manual Tomas Volf
  2 siblings, 0 replies; 8+ messages in thread
From: Tomas Volf @ 2025-01-22 19:05 UTC (permalink / raw)
  To: 75625; +Cc: Tomas Volf

* 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





^ permalink raw reply related	[flat|nested] 8+ messages in thread

* bug#75625: [PATCH 4/4] doc: htmlxref.cnf: Fix link to The GNU Stow Manual.
  2025-01-22 19:05 ` bug#75625: [PATCH 1/4] doc: htmlxref.cnf: Use write-file-functions Tomas Volf
  2025-01-22 19:05   ` bug#75625: [PATCH 2/4] doc: htmlxref.cnf: Trim trailing whitespace characters Tomas Volf
  2025-01-22 19:05   ` bug#75625: [PATCH 3/4] doc: htmlxref.cnf: Add link to debbugs-ug Tomas Volf
@ 2025-01-22 19:05   ` Tomas Volf
  2025-01-23 15:25     ` bug#75625: link in manual to Debbugs User Guide does not work Maxim Cournoyer
  2 siblings, 1 reply; 8+ messages in thread
From: Tomas Volf @ 2025-01-22 19:05 UTC (permalink / raw)
  To: 75625; +Cc: Tomas Volf, Ludovic Courtès, Maxim Cournoyer

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





^ permalink raw reply related	[flat|nested] 8+ messages in thread

* bug#75625: link in manual to Debbugs User Guide does not work
  2025-01-17 18:33 ` jgart via Bug reports for GNU Guix
@ 2025-01-22 19:08   ` Tomas Volf
  0 siblings, 0 replies; 8+ messages in thread
From: Tomas Volf @ 2025-01-22 19:08 UTC (permalink / raw)
  To: 75625; +Cc: jgart, arne_bab

[-- Attachment #1: Type: text/plain, Size: 1016 bytes --]

jgart via Bug reports for GNU Guix <bug-guix@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.

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 853 bytes --]

^ permalink raw reply	[flat|nested] 8+ messages in thread

* bug#75625: link in manual to Debbugs User Guide does not work
  2025-01-22 19:05   ` bug#75625: [PATCH 4/4] doc: htmlxref.cnf: Fix link to The GNU Stow Manual Tomas Volf
@ 2025-01-23 15:25     ` Maxim Cournoyer
  0 siblings, 0 replies; 8+ messages in thread
From: Maxim Cournoyer @ 2025-01-23 15:25 UTC (permalink / raw)
  To: Tomas Volf
  Cc: 75625-done, Jorge Gomez, Ludovic Courtès,
	Arne Babenhauserheide

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@gnu.org so they may update it with our additions?

-- 
Thanks,
Maxim




^ permalink raw reply	[flat|nested] 8+ messages in thread

end of thread, other threads:[~2025-01-23 15:26 UTC | newest]

Thread overview: 8+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2025-01-17  7:41 bug#75625: link in manual to Debbugs User Guide does not work Dr. Arne Babenhauserheide via Bug reports for GNU Guix
2025-01-17 18:33 ` jgart via Bug reports for GNU Guix
2025-01-22 19:08   ` Tomas Volf
2025-01-22 19:05 ` bug#75625: [PATCH 1/4] doc: htmlxref.cnf: Use write-file-functions Tomas Volf
2025-01-22 19:05   ` bug#75625: [PATCH 2/4] doc: htmlxref.cnf: Trim trailing whitespace characters Tomas Volf
2025-01-22 19:05   ` bug#75625: [PATCH 3/4] doc: htmlxref.cnf: Add link to debbugs-ug Tomas Volf
2025-01-22 19:05   ` bug#75625: [PATCH 4/4] doc: htmlxref.cnf: Fix link to The GNU Stow Manual Tomas Volf
2025-01-23 15:25     ` bug#75625: link in manual to Debbugs User Guide does not work Maxim Cournoyer

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/guix.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).