bug#28835: guild help refers to non-existing info node

bug#28835: guild help refers to non-existing info node

[Maxim Cournoyer]

While attempting to learn what I could do with guild, I stumbled on the following:

guild help
Usage: guild COMMAND [ARGS]
Run command-line scripts provided by GNU Guile and related programs.

[...]

Report guild bugs to bug-guile@gnu.org
GNU Guile home page: <http://www.gnu.org/software/guile/>
General help using GNU software: <http://www.gnu.org/gethelp/>
For complete documentation, run: info guile 'Using Guile Tools'

Running 'info guile 'Using Guile Tools' brings us to the top of the
Guile Reference Manual with the following warning in the mini-buffer:

--8<---------------cut here---------------start------------->8---
No menu item 'Using Guile Tools' in node '(guile.info.gz)Top'.
--8<---------------cut here---------------end--------------->8---

Maxim

bug#28835: [PATCH] Re: bug#28835: guild help refers to non-existing info node

[Maxim Cournoyer]

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

Maxim Cournoyer <maxim.cournoyer@gmail.com> writes:

> While attempting to learn what I could do with guild, I stumbled on the following:
>
> guild help
> Usage: guild COMMAND [ARGS]
> Run command-line scripts provided by GNU Guile and related programs.
>
> [...]
>
> Report guild bugs to bug-guile@gnu.org
> GNU Guile home page: <http://www.gnu.org/software/guile/>
> General help using GNU software: <http://www.gnu.org/gethelp/>
> For complete documentation, run: info guile 'Using Guile Tools'
>
> Running 'info guile 'Using Guile Tools' brings us to the top of the
> Guile Reference Manual with the following warning in the mini-buffer:
>
> No menu item 'Using Guile Tools' in node '(guile.info.gz)Top'.
>

Apparently, there *is* a node 'Using Guile Tools', but its reference
in the help should read as

    info '(guile)Using Guile Tools'

instead of

    info guile 'Using Guile Tools'

Patch attached.

Maxim

[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: 0001-scripts-help-Fix-reference-to-the-Using-Guile-Tools-.patch --]
[-- Type: text/x-patch, Size: 1025 bytes --]

From b5613324a15a3f9b64d32d30cd58ba5bea688016 Mon Sep 17 00:00:00 2001
From: Maxim Cournoyer <maxim.cournoyer@gmail.com>
Date: Sat, 14 Oct 2017 12:16:54 -0400
Subject: [PATCH] scripts: help: Fix reference to the "Using Guile Tools" node.

Fixes bug#28835.

* module/scripts/help.scm (list-commands): Fix reference to the "Using
Guile Tools" node.
---
 module/scripts/help.scm | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/module/scripts/help.scm b/module/scripts/help.scm
index 4e0f47c32..34400db3a 100644
--- a/module/scripts/help.scm
+++ b/module/scripts/help.scm
@@ -115,7 +115,7 @@ For help on a specific command, try \"guild help COMMAND\".
 Report guild bugs to ~a
 GNU Guile home page: <http://www.gnu.org/software/guile/>
 General help using GNU software: <http://www.gnu.org/gethelp/>
-For complete documentation, run: info guile 'Using Guile Tools'
+For complete documentation, run: info '(guile)Using Guile Tools'
 " %guile-bug-report-address))
 
 (define (module-commentary mod)
-- 
2.14.1

bug#28835: [PATCH] Re: bug#28835: guild help refers to non-existing info node

[Ludovic Courtès]

Maxim Cournoyer <maxim.cournoyer@gmail.com> skribis:

>>From b5613324a15a3f9b64d32d30cd58ba5bea688016 Mon Sep 17 00:00:00 2001
> From: Maxim Cournoyer <maxim.cournoyer@gmail.com>
> Date: Sat, 14 Oct 2017 12:16:54 -0400
> Subject: [PATCH] scripts: help: Fix reference to the "Using Guile Tools" node.
>
> Fixes bug#28835.
>
> * module/scripts/help.scm (list-commands): Fix reference to the "Using
> Guile Tools" node.

Applied, thank you Maxim!

Ludo’.