[systemvoltage]

Tangential: Does anyone know how to generate HTML docs such as this? It looks like a page in a book - with a header/footer and page number. And, surprisingly no one in 1991 imaged we would be reading it on a 4k widescreen - and here I am, and it is extremely readable (using SF Mono on macOS). I would love to know what tools can be used to generate almost paper-like HTML docs.

Edit: I found the answer, tiny link at the bottom: https://tools.ietf.org/tools/rfcmarkup/

[lozf]

> Edit: I found the answer, tiny link at the bottom: https://tools.ietf.org/tools/rfcmarkup/

If you read the link, that just adds the HTML markup to plain text ASCII RFCs (which were deprecated in favour of XML, back in 2013 as per RFC 7994.)

RFC 7990 has more details on the format framework. But for actual guidance on the tools used, you probably want to peruse the "Prepare documents" section of the IETF's tools[0] page, or those at rfc-editor.org[1].

[0]: http://tools.ietf.org/

[1]: https://www.rfc-editor.org/pubprocess/tools/

XML, markdown, asciidoc, Bibtex, nroff, and even Word are covered.

[yjftsjthsd-h]

pr(1) can do it - https://linux.die.net/man/1/pr

[andrewzah]

You could also achieve this with LaTeX and pandoc.

[systemvoltage]

With similar formatting and index?

[pan69]

Yes. This book uses pandoc:

https://github.com/jagregory/abrash-black-book

This is the HTML output:

http://www.jagregory.com/abrash-black-book/

[ducktective]

How about a version-controllable markdown diagram generator? https://mermaid-js.github.io/mermaid/