Info manual nodes are too big

[Robert P. Goldman]

If you try to read the manual in emacs in the info browser (or, presumably, in command-line info on linux), the cross-references and indexes don't work at all well. The problem is that the manual is not chopped up into small enough nodes, and the node is the unit addressed by cross-references in info.

I was trying to read one of the sections on the configuration DSL in emacs, and found that a bunch of cross-references there just pointed to the node I was already in.

This could be substantially fixed by shattering the manual up into nodes on subsection boundaries.

[Robert P. Goldman (rpgoldman)]

Didier Verna suggests:

  You may want to start with C-x h C-u M-x texinfo-insert-node-lines.
This will create all missing nodes for every sectionning command and
fill them up with the proper title. However, you will most probably need
to update the structure afterwards.

[Faré (fahree)]

I see there are still @section entries without a @node. Would the magic emacs command fix that?

[Robert P. Goldman (rpgoldman)]

New manual version with many more nodes is committed in the docs topic branch. It will be merged before the next release.