This is the mail archive of the
binutils@sourceware.org
mailing list for the binutils project.
Re: Move position of @contents
- From: "Joseph S. Myers" <joseph at codesourcery dot com>
- To: Richard Sandiford <richard at codesourcery dot com>
- Cc: binutils at sourceware dot org
- Date: Fri, 23 Mar 2007 17:21:49 +0000 (UTC)
- Subject: Re: Move position of @contents
- References: <87zm63vs9y.fsf@firetop.home>
On Fri, 23 Mar 2007, Richard Sandiford wrote:
> At the moment, the printed versions of most manuals (all except
> libiberty) explicitly put the table of contents at the very end of
> the document, after the index and (where used) the page containing
> typesetting information. This is at odds with most (although admittedly
> not all) manuals I've seen, and is also at odds with the gcc manual.
The reason this once used to make sense was when makefiles used a sequence
tex; texindex; tex to generate printed manuals, and contents at the end
would be more likely to get the page numbers right in some cases. Since
nowadays texi2dvi is used and it iterates as many times as needed for page
numbers to stabilize, putting the contents in their natural position at
the front is now the right thing to do; I fixed the GCC manuals in 2001.
--
Joseph S. Myers
joseph@codesourcery.com