Viewing Links for a info file

Viewing Links for a info file

[Christopher Dimech]

   I made a texinfo file using

   texinfo file.texi

   However, when I load the info file, the links with @menu do not work.
   Is there some prodecure to
   see the links in Emacs?

Re: Viewing Links for a info file

[Brett Gilio]

Christopher Dimech <dimech@gmx.com> writes:

>    I made a texinfo file using
>
>    texinfo file.texi
>
>    However, when I load the info file, the links with @menu do not work.
>    Is there some prodecure to
>    see the links in Emacs?

Hi Christopher,

Would you feel okay sharing the file in question? I feel it would be
easier for us to diagnose the problem.

-- 
Brett M. Gilio
brettg@gnu.org
https://brettgilio.com/
E82A C026 95D6 FF02 43CA 1E5C F6C5 2DD1 BA27 CB87

Re: Viewing Links for a info file

[Emanuel Berg via Users list for the GNU Emacs text editor]

Brett Gilio wrote:

> Would you feel okay sharing the file in question?
> I feel it would be easier for us to diagnose
> the problem.

You look first and tell me if it is OK :)

-- 
underground experts united
http://user.it.uu.se/~embe8573
https://dataswamp.org/~incal

Re: Viewing Links for a info file

[Brett Gilio]

Emanuel Berg via Users list for the GNU Emacs text editor
<help-gnu-emacs@gnu.org> writes:

> You look first and tell me if it is OK :)

I'll let you know if my computer explodes from a texinfo virus. :)

-- 
Brett M. Gilio
brettg@gnu.org
https://brettgilio.com/
E82A C026 95D6 FF02 43CA 1E5C F6C5 2DD1 BA27 CB87

Re: Viewing Links for a info file

[Eli Zaretskii]

> From: Christopher Dimech <dimech@gmx.com>
> Date: Fri, 16 Oct 2020 01:59:21 +0200
> Sensitivity: Normal
> 
>    I made a texinfo file using
> 
>    texinfo file.texi

What is the command 'texinfo'? what does it do?  I don't have such a
command on my system.  Did you mean 'makeinfo', perhaps?

Re: Viewing Links for a info file

[Christopher Dimech]

   That's right. It is makeinfo. I have then done

   C-u C-h i file

   and it works

   Is tht how you view the resulting file.info?



   Sent: Friday, October 16, 2020 at 7:59 AM
   From: "Eli Zaretskii" <eliz@gnu.org>
   To: help-gnu-emacs@gnu.org
   Subject: Re: Viewing Links for a info file
   > From: Christopher Dimech <dimech@gmx.com>
   > Date: Fri, 16 Oct 2020 01:59:21 +0200
   > Sensitivity: Normal
   >
   > I made a texinfo file using
   >
   > texinfo file.texi
   What is the command 'texinfo'? what does it do? I don't have such a
   command on my system. Did you mean 'makeinfo', perhaps?

Re: Viewing Links for a info file

[Eli Zaretskii]

> From: Christopher Dimech <dimech@gmx.com>
> Cc: help-gnu-emacs@gnu.org
> Date: Fri, 16 Oct 2020 11:42:15 +0200
> 
> 
> That's right. It is makeinfo. I have then done
>  
> C-u C-h i file
>  
> and it works
>  
> Is tht how you view the resulting file.info?

Yes.

You should also consider running "install-info file" (from the shell's
prompt) to add its entry to the DIR file.

Re: Viewing Links for a info file

[Christopher Dimech]

   I have been getting these complaints.

   makeinfo 00-gungadin-elisp-abbrev.texi
   00-gungadin-elisp-abbrev.texi:19: warning: @end ifclear should only
   appear at a line beginning
   00-gungadin-elisp-abbrev.texi:52: warning: @end ifset should only
   appear at a line beginning
   00-gungadin-elisp-abbrev.texi:103: @menu reference to nonexistent node
   `Introduction'
   00-gungadin-elisp-abbrev.texi:110: @detailmenu reference to nonexistent
   node `Modifier-Keys'
   00-gungadin-elisp-abbrev.texi:111: @detailmenu reference to nonexistent
   node `Key-Mnemonics'
   00-gungadin-elisp-abbrev.texi:112: @detailmenu reference to nonexistent
   node `Composing-KeySeq'
   00-gungadin-elisp-abbrev.texi:113: @detailmenu reference to nonexistent
   node `Complete-Kbd'
   00-gungadin-elisp-abbrev.texi:114: @detailmenu reference to nonexistent
   node `Docu-KeySeq'
   00-gungadin-elisp-abbrev.texi:115: @detailmenu reference to nonexistent
   node `Emacs-Tutorials-Eww'
   00-gungadin-elisp-abbrev.texi:117: @detailmenu reference to nonexistent
   node `Docu-Function'
   00-gungadin-elisp-abbrev.texi:118: @detailmenu reference to nonexistent
   node `Intactv-Function'
   00-gungadin-elisp-abbrev.texi:119: @detailmenu reference to nonexistent
   node `UPrefix-Argument'
   00-gungadin-elisp-abbrev.texi:120: @detailmenu reference to nonexistent
   node `Fnc-ArgSet-PrPfx'

   My code goes something like this

   \input texinfo
   @c %**start of header
   @setfilename gungadin-elisp-abbrev.info
   @set Volume-1
   @set Gela-Version 1.0
   @set Emacs-Version 27.0
   @set Date October 21, 2020.
   @c %**end of header

   @menu
   * Introduction::   Introduction to Emacs Lisp.
   @detailmenu
   Subnodes so you can get to them easily in one step:
   Introduction
   * Modifier-Keys::     Modifier Keys on Lisp Machine Keyboards.
   * Key-Mnemonics::     Mnemonics that identify specific keys.
   * Composing-KeySeq::  Composing Key Sequences.
   * Complete-Kbd::      Complete Key Bindings.
   * Docu-KeySeq::       Documentationm of Key Sequences.
   * Emacs-Tutorials-Eww::  Emacs Tutorials and View Web Pages with Eww.
   * Docu-Function::     Documentation of Functions.
   * Intactv-Function::  Interactive Functions.
   * UPrefix-Argument::  The Universal Prefix Argument.
   * Fnc-ArgSet-PrPfx::  Setting Function Arguments by Prompt or Prefix.
   @end detailmenu
   @end menu

   @ifclear Volume-1
      @include 01-gela-intro.texi
   @end ifclear

   @bye


   cat 01-gela-intro.texi

   @node Introduction
   @chapter Introduction
   Looks at what Emacs is.

   @node Modifier-Keys
   @section Modifier Keys on Lisp Machine Keyboards
   Looks at Modifier Keys on Lisp Machine Keyboards.

   etc

   @node Fnc-ArgSet-PrPfx
   @section Setting Function Argument by Prompt and Prefix
   Passing arguments to interactive functions

   @c end-of-file








   Sent: Friday, October 16, 2020 at 12:33 PM
   From: "Eli Zaretskii" <eliz@gnu.org>
   To: help-gnu-emacs@gnu.org
   Subject: Re: Viewing Links for a info file
   > From: Christopher Dimech <dimech@gmx.com>
   > Cc: help-gnu-emacs@gnu.org
   > Date: Fri, 16 Oct 2020 11:42:15 +0200
   >
   >
   > That's right. It is makeinfo. I have then done
   >
   > C-u C-h i file
   >
   > and it works
   >
   > Is tht how you view the resulting file.info?
   Yes.
   You should also consider running "install-info file" (from the shell's
   prompt) to add its entry to the DIR file.

Re: Viewing Links for a info file

[Eli Zaretskii]

> From: Christopher Dimech <dimech@gmx.com>
> Cc: help-gnu-emacs@gnu.org
> Date: Fri, 16 Oct 2020 12:52:21 +0200
> 
> I have been getting these complaints.
>  
> makeinfo 00-gungadin-elisp-abbrev.texi
> 00-gungadin-elisp-abbrev.texi:19: warning: @end ifclear should only appear at a line beginning
> 00-gungadin-elisp-abbrev.texi:52: warning: @end ifset should only appear at a line beginning
> 00-gungadin-elisp-abbrev.texi:103: @menu reference to nonexistent node `Introduction'
> 00-gungadin-elisp-abbrev.texi:110: @detailmenu reference to nonexistent node `Modifier-Keys'
> 00-gungadin-elisp-abbrev.texi:111: @detailmenu reference to nonexistent node `Key-Mnemonics'
> 00-gungadin-elisp-abbrev.texi:112: @detailmenu reference to nonexistent node `Composing-KeySeq'
> 00-gungadin-elisp-abbrev.texi:113: @detailmenu reference to nonexistent node `Complete-Kbd'
> 00-gungadin-elisp-abbrev.texi:114: @detailmenu reference to nonexistent node `Docu-KeySeq'
> 00-gungadin-elisp-abbrev.texi:115: @detailmenu reference to nonexistent node `Emacs-Tutorials-Eww'
> 00-gungadin-elisp-abbrev.texi:117: @detailmenu reference to nonexistent node `Docu-Function'
> 00-gungadin-elisp-abbrev.texi:118: @detailmenu reference to nonexistent node `Intactv-Function'
> 00-gungadin-elisp-abbrev.texi:119: @detailmenu reference to nonexistent node `UPrefix-Argument'
> 00-gungadin-elisp-abbrev.texi:120: @detailmenu reference to nonexistent node `Fnc-ArgSet-PrPfx'

I think this diagnostics is quite self-explanatory, no?

I suggest to consult the Texinfo manual if you are unsure how to
correctly write these constructs in Texinfo.

Re: Viewing Links for a info file

[Christopher Dimech]

   I see, the problem was the @ifclear when I wantnd to include the file.
   Must be @ifset.

   In my intro file I have addes a menu apter @chapter and before the
   first @section
   Put everything in a @macro
   @macro Gela-Menu
   @menu
   * Modifier-Keys::     Modifier Keys on Lisp Machine Keyboards.
   * Key-Mnemonics::     Mnemonics that identify specific keys.
   * Composing-KeySeq::  Composing Key Sequences.
   * Complete-Kbd::      Complete Key Bindings.
   * Docu-KeySeq::       Documentationm of Key Sequences.
   * Emacs-Tutorials-Eww::  Emacs Tutorials and View Web Pages with Eww.
   * Docu-Function::     Documentation of Functions.
   * Intactv-Function::  Interactive Functions.
   * UPrefix-Argument::  The Universal Prefix Argument.
   * Fnc-ArgSet-PrPfx::  Setting Function Arguments by Prompt or Prefix.
   @end menu
   @end macro
   @Gela-Menu

   But makeinfo complains if I try to call @Gela-Menu after each section.
   How can one go about having the menu also show after each section. It
   would be much easier to read as when you finish reading, one won't have
   to
   scroll up to the top of the buffer to select Introduction, which is the
   Chapter Title


   Sent: Friday, October 16, 2020 at 12:58 PM
   From: "Eli Zaretskii" <eliz@gnu.org>
   To: help-gnu-emacs@gnu.org
   Subject: Re: Viewing Links for a info file
   > From: Christopher Dimech <dimech@gmx.com>
   > Cc: help-gnu-emacs@gnu.org
   > Date: Fri, 16 Oct 2020 12:52:21 +0200
   >
   > I have been getting these complaints.
   >
   > makeinfo 00-gungadin-elisp-abbrev.texi
   > 00-gungadin-elisp-abbrev.texi:19: warning: @end ifclear should only
   appear at a line beginning
   > 00-gungadin-elisp-abbrev.texi:52: warning: @end ifset should only
   appear at a line beginning
   > 00-gungadin-elisp-abbrev.texi:103: @menu reference to nonexistent
   node `Introduction'
   > 00-gungadin-elisp-abbrev.texi:110: @detailmenu reference to
   nonexistent node `Modifier-Keys'
   > 00-gungadin-elisp-abbrev.texi:111: @detailmenu reference to
   nonexistent node `Key-Mnemonics'
   > 00-gungadin-elisp-abbrev.texi:112: @detailmenu reference to
   nonexistent node `Composing-KeySeq'
   > 00-gungadin-elisp-abbrev.texi:113: @detailmenu reference to
   nonexistent node `Complete-Kbd'
   > 00-gungadin-elisp-abbrev.texi:114: @detailmenu reference to
   nonexistent node `Docu-KeySeq'
   > 00-gungadin-elisp-abbrev.texi:115: @detailmenu reference to
   nonexistent node `Emacs-Tutorials-Eww'
   > 00-gungadin-elisp-abbrev.texi:117: @detailmenu reference to
   nonexistent node `Docu-Function'
   > 00-gungadin-elisp-abbrev.texi:118: @detailmenu reference to
   nonexistent node `Intactv-Function'
   > 00-gungadin-elisp-abbrev.texi:119: @detailmenu reference to
   nonexistent node `UPrefix-Argument'
   > 00-gungadin-elisp-abbrev.texi:120: @detailmenu reference to
   nonexistent node `Fnc-ArgSet-PrPfx'
   I think this diagnostics is quite self-explanatory, no?
   I suggest to consult the Texinfo manual if you are unsure how to
   correctly write these constructs in Texinfo.

Re: Viewing Links for a info file

[Eli Zaretskii]

> From: Christopher Dimech <dimech@gmx.com>
> Cc: help-gnu-emacs@gnu.org
> Date: Fri, 16 Oct 2020 13:17:57 +0200
> 
> In my intro file I have addes a menu apter @chapter and before the first @section
> Put everything in a @macro
> @macro Gela-Menu
> 
> @menu
> * Modifier-Keys::     Modifier Keys on Lisp Machine Keyboards.
> * Key-Mnemonics::     Mnemonics that identify specific keys.
> * Composing-KeySeq::  Composing Key Sequences.
> * Complete-Kbd::      Complete Key Bindings.
> * Docu-KeySeq::       Documentationm of Key Sequences.
> * Emacs-Tutorials-Eww::  Emacs Tutorials and View Web Pages with Eww.
> 
> * Docu-Function::     Documentation of Functions.
> * Intactv-Function::  Interactive Functions.
> * UPrefix-Argument::  The Universal Prefix Argument.
> * Fnc-ArgSet-PrPfx::  Setting Function Arguments by Prompt or Prefix.
> @end menu
> 
> @end macro
> 
> @Gela-Menu
>  
> But makeinfo complains if I try to call @Gela-Menu after each section.
> How can one go about having the menu also show after each section. It
> would be much easier to read as when you finish reading, one won't have to
> scroll up to the top of the buffer to select Introduction, which is the Chapter Title

You cannot have the same @menu after each section without also
updating the corresponding @node lines.

This is not an Emacs issue, this is a Texinfo issue, so I suggest to
ask this on the help-texinfo list instead.