Re: texi2dvi outputs toc commands on stdout for @include files

[Patrice Dumas]

On Sun, Feb 05, 2012 at 11:26:49AM -0800, Karl Berry wrote:
> Hi Patrice,
> 
>     the line that should be writen in the .toc file is written to stdout
>     ...
>     @numchapentry{chap}{1}{}{2}
> 
> This happens because @contents occurs after @top.  That's never been
> supported -- @contents has to be outside all of the other material,
> either at the beginning or the end, not in the middle. 

This is not clearly stated in the documentation:

 Both contents commands should be written on a line by themselves, and
 are best placed near the beginning of the file, after the @code{@@end
 titlepage} (@pxref{titlepage}).  

Maybe it should be changed to:

 Both contents commands should be written on a line by themselves, and
 are best placed near the beginning of the file, after the @code{@@end
 titlepage} (@pxref{titlepage}) and before any sectioning command.


> I suppose texinfo.tex could detect this and issue an error instead of
> just weird output, but it doesn't seem too critical.  On the other hand,
> it would be nice for makeinfo to output a warning :).

Ok.

-- 
Pat