bug-texinfo
[Top][All Lists]
Advanced

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

Re: version 6.8 forces Table of Contents to top of HTML document


From: Gavin Smith
Subject: Re: version 6.8 forces Table of Contents to top of HTML document
Date: Fri, 24 Dec 2021 08:07:02 +0000
User-agent: Mutt/1.9.4 (2018-02-28)

On Fri, Dec 24, 2021 at 12:35:09AM +0100, Patrice Dumas wrote:
> On Tue, Dec 21, 2021 at 09:28:45PM +0000, Gavin Smith wrote:
> > On Mon, Oct 18, 2021 at 10:35:17AM +0200, Benno Schulenberg wrote:
> > > > By default a list of chapters isn't output at the start, as it would
> > > > be repetition from the table of contents.  However, if 
> > > > "-c CONTENTS_OUTPUT_LOCATION=inline" is given as an option to texi2any,
> > > > I see that it is a problem that there is no initial list of chapters.
> > > 
> > > Indeed.
> > 
> > I've changed this in commit d94128ef20.  Now a list of chapters will be 
> > output
> > with -c CONTENTS_OUTPUT_LOCATION=inline.
> 
> I think that it is wrong.  Indeed, the principle of
> CONTENTS_OUTPUT_LOCATION=inline is to have the table of contents
> output where the @-command @contents is.  If the user uses
> CONTENTS_OUTPUT_LOCATION=inline it means that she wants the table of
> contents to appear where @contents here, not at the beginning as it is
> the meaning of CONTENTS_OUTPUT_LOCATION=after_top.
> 
> To me, if anything needs to change, it should only be the documentation.

In the case of the nano manual the @contents was at the end of the document.
With CONTENTS_OUTPUT_LOCATION=inline it would still be output at the end
of the document.  The difference is that there would also be a sectional
table of contents at the beginning of the document as well, to replace the
menu and/or master menu (with FORMAT_MENU=sectiontoc).  It is not the full
table of contents, as it doesn't list sections or subsections.



reply via email to

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