On Mon, May 19, 2025 at 09:33:43PM +0000, Heime wrote:
>
>
> > Sent: Tuesday, May 20, 2025 at 8:12 AM
> > From: "Gavin Smith" <[email protected]>
> > To: "Heime" <[email protected]>
> > Cc: "[email protected]" <[email protected]>
> > Subject: Re: Texinfo Menu Formatting: Node Names, Display, and Line Length
> >
> > On Sun, May 18, 2025 at 06:07:08PM +0000, Heime via Users list for the
> > Texinfo documentation system wrote:
> > >
> > > I want to discuss the following Texinfo Menu
> > >
> > > @menu
> > > * Installing Emacs with Synaptic Package Manager: nstl-emacs-snptk.
> > > Something.
> > > * Installing Emacs from Source: nstl-emacs-src. Something.
> > > @end menu
> > >
> > > In the Info output, the menu entry line consists of:
> > >
> > > 1. The menu entry name (what the user sees and types to select the entry),
> > > 2. The node name (the actual destination node),
> > > 3. An optional description.
> > >
> > > The node name is not always printed in the menu, not only the
> > > menu-entry-name.
> >
> > Not printing the node name is a feature of the Info viewer you are using.
> > The
> > node name is always present in the Info file.
> >
> >
> > > Is it a bad idea not to display the node-name?
> >
> > It's up to the user if they want to enable this feature or not.
>
> What is the feature that decides whether to show the node-name or not?
Info-hide-note-references in emacs and hide-note-references in the stand-alone
Info reader.
> > > And how can I keep my menu to 72 columns?
> >
> > Don't type past 72 columns in your text editor?
>
> So one would continue on the next line for the details of the same menu item
> (node)?
>
Yes. Here's an example from the Texinfo manual:
* Drills:: Making holes in things with power
screwdrivers, drill drivers, combi
drills, impact drivers, hammer drills,
breakers and demolition drills.
