bug-automake
[Top][All Lists]
Advanced

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

Re: sections without nodes in automake manual?


From: Ralf Wildenhues
Subject: Re: sections without nodes in automake manual?
Date: Wed, 4 Jun 2008 21:19:04 +0200
User-agent: Mutt/1.5.17+20080114 (2008-01-14)

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

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