bug-texinfo
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Providing extra information for Info menu generation


From: Gavin Smith
Subject: Providing extra information for Info menu generation
Date: Tue, 14 Feb 2023 19:24:57 +0000

I know we probably have more ideas for projects in texi2any than we
really have time to implement just now, but one thing that I think
would be really nice is to allow complete omission of Info menus from
Texinfo source, without anything being lost.

Although generation of menus is already possible, as far as I know
most manuals and nodes do still use explicit menus.  This may be for
the benefit of Info output, where extra descriptive text can be given
for a node reference.

For example, in the main menu in the bash manual:

* Job Control::                 What job control is and how Bash allows you
                                to use it.

In the Texinfo source, this node could be defined like

@node Job Control
@nodeelaboration What job control is and how Bash allows you to use it.

I remember seeing a similar proposal before in a discussion one of
the GNU mailing lists (emacs-devel?); however, I cannot remember
where I saw it, so can't give due credit.

This would really clean up the syntax of Texinfo files, avoiding the
hetergeneous syntax implicit in the name "TeX-Info".  The special
characters would be @, { and } and that would be it, pretty much.

We could take this idea a bit further and allow arbitrary
cross-references from nodes that would appear in Info menus, as
a kind of "see also" link for the node.  This would enable the
generation of non-hierarchical manuals as a collection of nodes.
(This may not be as useful, though.)




reply via email to

[Prev in Thread] Current Thread [Next in Thread]