in the RFC buffer. Remember that this operation
can be undone with a single C-_ if things go too wrong.
Search through the file for <H3>. Each one is a header line, and
will trigger the creation of a separate HTML file.
I like to use "less" in another xterm to compare the <H3> lines to the
original table of contents. Make sure all the section headers are
tagged <H3>, and no other lines (like numbered lists) were accidently
labeled <H3>. The C-x C-h keycode is bound to a function that
turns normal lines into headers.
For some very small, insignificant sections, I change
the <H3> </H3> pair to a <H4> </H4>, which stops the ELISP code from
breaking the micro-section out into a separate file. It also screws
up the ToC (the micro-section is not listed), so you'll have to go
back and fix it up later.
Go back through the file, line by line (or at least screen page
by screen page). Look for things that are "wrong", like PRE
blocks that can be converted into numbered, unnumbered, or
definition lists. It's best to fix them here, rather than
wait until later.
Be careful to put <P> tags on blank lines within former PRE blocks.
Also, the C-x C-d keycode is useful for building definition lists
(it turns the current line into a header tag).
ESC x write-html-files in the RFC buffer. This splits
the RFC up into multiple HTML files on the header boundaries,
writes them out, and builds a ToC in index.html
Switch to index.html, kill the entire ToC, insert file 0.html
(everything before the first section header - almost certainly
stuff you want in index.html), then yank the ToC back at an
"appropriate" place
Still in index.html, fix up the various author and title areas,
kill the last "Up:" that points to RFC 000, convert all three
instances of "RFC 000 - " to "RFC 000". Save this file,
enter the RFC in the "master list" one directory up, load it
up in Netscape and make sure the ToC looks right
Assuming everything looks fine, exit emacs (without
saving the RFC text file), and run something like this:
sededit 's/RFC 000/RFC 1155/g' *.html
Edit 1.html and delete the "Prev:" reference to 0.html. Then
delete 0.html.
Use Netscape to browse through the RFC, checking to make sure
it "looks right", and fixing it up where it doesn't