README

# Troff/Groff Resources

------------------------------------------------------------------------

## The Gist

This is a list of resources for troff, the original Unix system for
typesetting documents. Below will be a list of resources for troff,
nroff, preprocessors & more associated tools.

NOTE: Some PDFs may not render previewed in GitHub! You likely will have to download them.

## List

-   [Troff.org](http://www.troff.org)
-   [Unix Text Processing rewritten source code, originally published in
    1987.](https://github.com/larrykollar/Unix-Text-Processing)
-   [Unix Text Processing (PDF)](./utp_book.pdf)
-   [CSTR 54: Bell Labs Troff User\'s Manual](./cstr-54.pdf)
-   [The GNU Troff (groff)
    Manual](http://www.gnu.org/software/groff/manual/groff.html)
-   [The GNU Troff (groff) Mailing
    List](http://lists.gnu.org/archive/html/groff/)
-   [The Groff Friends Howto from Dean Allen
    Provins](./TheGroffFriendsHowto.pdf)
-   [GNU PIC Guide from Eric S. Raymond (esr)](./gpic.pdf)
-   [Bell Labs pic Guide](./bell/116-pic.pdf)
-   [Bell Labs grap Guide](./bell/114-grap.pdf)
-   [TAR file containing a grap
    implementation](./bell/grap-faber-1.46.tar)
-   [Bell Labs chem Guide](./bell/122-chem.pdf)
-   [tbl Preprocessor Guide by Cherry & Lesk](./tbl.pdf)
-   [refer Bibliography System Guide from Bill Tuthill](./refer.pdf)
-   [Typesetting Mathematics (eqn) Second Edition by Kernighan &
    Cherry](./eqn2e.pdf)
-   [Typesetting Mathematics with GNU eqn by Ted Harding](./gnu-eqn.pdf)
-   [-ms Macros Guide from Cherry & Lesk](./msdoc.pdf)
-   [-ms Macros Reference from Cherry & Lesk (2?)](./msmacros.pdf)
-   [-me Macros Guide by Eric Allman](./memacros.pdf)
-   [-mm Macros Manual](./mm-all.pdf)
-   [-me Macros Reference by Eric Allman](./meref.pdf)
-   [-mom Macros by Peter
    Shaffter](http://www.schaffter.ca/mom/momdoc/toc.html)
-   [eqn: Formatting Equations in groff by Douglas
    Rumbaugh](http://douglasrumbaugh.com/post/groff-eqn/)
-   [Massive groff examples repository (Thanks
    lkh!)](http://froude.eu/groff/)
-   [Formatting Academic Papers with -me Macros by Jim
    Hall](http://opensource.com/article/18/2/writing-academic-papers-groff-me)
-   [\[VIDEO\] Writing Documents with nroff -me by Jim
    Hall](http://www.youtube.com/watch?v=WCF5oSuMm9g)
-   [\[VIDEO\] Minimalist Documents with groff from Luke
    Smith](http://www.youtube.com/watch?v=w8EKH_fjmXA)
-   [\[VIDEO\] Customizing groff Macros from Luke
    Smith](http://www.youtube.com/watch?v=kJ_TXZB4Gm4)
-   [\[VIDEO\] Refer Bibliographies from Luke
    Smith](http://www.youtube.com/watch?v=yTQbi_E_Gys)
-   [\[VIDEO\] EQN Mathematics from Luke
    Smith](http://www.youtube.com/watch?v=sp0qgpeG6EY)
-   [\[VIDEO PLAYLIST\] Troff/Groff Tutorials from Gavin
    Freeborn](https://www.youtube.com/playlist?list=PLknodeJt-I5FgZ5VwT-BHda_lu3dYrMeJ)
-   [Groff -mm and -me macro cheatsheets
    (source)](https://gitlab.com/wef/groff-quick-ref)
-   [PDF version of the -me cheatsheet by Bob Hepple](./me_quick.pdf)
-   [PDF version of the -mm cheatsheet by Bob Hepple](./mm_quick.pdf)
-   [Heirloom Doctools: A featureful troff implementation from real Unix
    sources](http://n-t-roff.github.io/heirloom/doctools.html)
-   [Heirloom
    Quickstart](http://n-t-roff.github.io/heirloom/doctools/quickstart.pdf)
-   [Heirloom Troff
    Manual](http://n-t-roff.github.io/heirloom/doctools/troff.pdf)
-   [Heirloom Doctools Source
    code](http://github.com/n-t-roff/heirloom-doctools)
-   [NetHack Guidebook (vers 3.6.7) source, written in
    troff](./ex/NetHack-doc.tar.gz)
-   [Troff Source code to the PSD/USD/SMM 4.4BSD documentation books.
    Incomplete, does not build but is useful for learning. (As of
    2024-Aug-18)](./ex/4.4doc-incomplete.tar.gz)