Hi Karl,

* Karl Berry wrote on Tue, Jun 03, 2008 at 07:26:20PM CEST:
> I noticed automake.texi has many sectioning commands without nodes.
> Mostly but not entirely @subsub-level entries.
> 
> This is quite unusual.  It leads to some very long nodes.  Was it a
> deliberate decision?

I have no idea whether that was deliberate.

> In cases like Install and Dist, I even venture to
> say that it is a bug.

I tend to agree, for these cases.

> Anyway, if it is deliberate, the usual Texinfo style is to use the
> @subsubheading (etc.) commands, instead of @subsubsection.  As is done
> in the `API versioning' chapter (unlike all others that I saw).

AIUI, the subsubheadings do not cause entries in the contents of the PDF
file.  I'm not sure I think that's better, though.  Are there other
differences I overlooked?

> Below is the edited output from C-u C-c C-s with the places I saw that
> were potentially missing @nodes.

I can go through them; do you rather propose to split into several
nodes, or just use less headings?

Cheers, and thanks,
Ralf


Reply via email to