Re: top node in html cross references

Dumas Patrice <[email protected]> Tue, 27 Jan 2004 13:13:43 +0100
Newsgroups gmane.comp.tex.texinfo.pretest
Message-ID <[email protected]>
> Please tell why you think so.  What's wrong with having the indices
> on the same file as Top?
> 
> Personally, I think that there's nothing wrong with the current setup.

The Top node should be the first node, but a node named index may appear 
anywhere in the document. If they appear on the same file it doesn't reflect
the organization of the manual. It happens because the 'index.html' file name 
happen, by chance, to be a special name in the html world. 

Note that this argument holds for other nodes which may appear by chance in 
the same file, but this shouldn't happen with the proposal (except for 
index.html, of course).

Another reason, which may be of less interest is that I think that the Top 
node is a special node and thus it should be much better to keep it in its own
file. In texi2html the formatting is done differently for the Top node and 
the other nodes. To say it otherwise, the Top node is really something like 
the title page of a book. Currently in makeinfo the formating of the Top node
isn't special, but it could change (a simple possibility could be special css 
classes in the Top node, or a <div class="Top"> enclosing the whole node), 
thus I think we should really keep it in a separate file.

Of course if an author wants to have the indices in the Top node he can use
@headings and @printindex in that node.

Pat
_______________________________________________
Texinfo home page: http://www.gnu.org/software/texinfo/
[email protected]
http://ff0.org/mailman/listinfo/texinfo-pretest