ietf
[Top] [All Lists]

Re: Automatically updated Table of Contents with Nroff

2009-07-15 05:08:38
Hi -

From: "Stefan Santesson" <stefan(_at_)aaa-sec(_dot_)com>
To: "Donald Eastlake" <d3e3e3(_at_)gmail(_dot_)com>
Cc: "IETF Discussion Mailing List" <ietf(_at_)ietf(_dot_)org>
Sent: Tuesday, July 14, 2009 6:03 PM
Subject: Re: Automatically updated Table of Contents with Nroff
...
All I have managed to get across are ways to generate a TOC in the end of
the document, that you have to move manually. When doing that move, your
page numbering and formatting may change.
...

No need to manually edit.

Use the macros or awk / sed to spit the toc into a file which can be inserted
into the correct position by the .so nroff directive.  This will result in
a table of contents in the correct position.  There is the possibility
that if the number of toc pages has changed from one iteration
to the next that the page numbers will be off by one, but that will
go away the next time the process runs.

For editing a document, particularly a largish one, the availability of
.so is for me nroff's biggest advantage over xml2rfc.

Randy

_______________________________________________
Ietf mailing list
Ietf(_at_)ietf(_dot_)org
https://www.ietf.org/mailman/listinfo/ietf