sl/plan9

Troff Resources
===============

TODO: Neatroff
TODO: Heirloom docutils
TODO: Groff
TODO: related resources like style guides or PostScript docs?

Some papers are in <https://github.com/bwarken/roff_classical>, as
well as in the source trees of various Unices.

Troff
-----

Troff User’s Manual
(what you keep under your pillow)
CSTR 54: https://troff.org/54.pdf
Plan 9 version: http://9p.io/sys/doc/troff.pdf
Heirloom docutils version: http://heirloom.sourceforge.net/doctools/troff.pdf

Troff Tutorial
(a tutorial to the troff language)
http://www.kohala.com/start/troff/v7man/trofftut/trofftut.ps

A Typesetter-independent Troff
(describes the changes of ditroff to otroff, as well as some of its
internals and configuration)
http://9p.io/cm/cs/cstr/97.ps.gz

Macro Packages
--------------

Typing Documents on the UNIX System: Using the -ms Macros with Troff
and Nroff
(description of the standard manuscript macro package)
http://www.kohala.com/start/troff/v7man/msmacros/msmacros.ps

A Revised Version of -ms
(description of a BSD version of -ms)
https://docs.freebsd.org/44doc/usd/18.msdiffs/paper.pdf

Writing Papers with NROFF using -me
(description of a weird but commonly distributed macro package noöne
uses)
https://docs.freebsd.org/44doc/usd/19.memacros/paper.pdf

-me Reference Manual
(… and its reference manual)
http://docs.freebsd.org/44doc/usd/20.meref/paper.pdf

TODO: find DWB -mm docs
TODO: more obscure macros like -mv, as well as -man and -mdoc

Preprocessors
-------------

Tbl—A Program to Format Tables
(describes the table system)
http://www.kohala.com/start/troff/v7man/tbl/tbl.ps

Typesetting Mathematics—User’s Guide (Second Edition)
(introduction to the math system)
http://www.kohala.com/start/troff/v7man/eqn/eqn2e.ps

A System for Typesetting Mathematics
(more on eqn)
http://www.kohala.com/start/troff/v7man/eqn/cacm.ps

Some Applications of Inverted Indexes on the UNIX System
(a little on indexes and refer)
http://www.kohala.com/start/troff/v7man/refer/refer.ps

TODO: pic and more

IDEAL: http://9p.io/cm/cs/cstr/103.ps.gz
GRAP: http://9p.io/cm/cs/cstr/114.ps.gz
PIC: http://9p.io/cm/cs/cstr/116.ps.gz
CHEM: http://9p.io/cm/cs/cstr/122.ps.gz
animations: http://9p.io/cm/cs/cstr/132.ps.gz
dformat: http://9p.io/cm/cs/cstr/142.ps.gz
https://www.mirbsd.org/htman/i386/manUSD/26.refer.htm
BIB

Indexes
-------

Maintaining Cross References in Manuscripts
(what it sounds like)
http://9p.io/cm/cs/cstr/127.ps.gz

Tools for Printing Indexes
(more on the above)
http://9p.io/cm/cs/cstr/128.ps.gz

Books
-----

UNIX Text Processing
(introduction book to using UNIX for text processing, including troff,
its ms and mm macro packages, the tbl, eqn, and pic preprocessors, and
writing your own macro packages)
https://www.oreilly.com/openbook/utp/UnixTextProcessing.pdf

vim: tw=70:cc=71: