(Beta version : user interface may change)

Troff Companions

Troff has been made to be used within tubes. It works with preprocessors, postprocessors and filters. A lot of filters exist since the 70’s. Some of them needed some enhancement to be used with utmac, some others needed to be created.


Dpage is a postscript post-processor that simply put two A4 pages on an A3 sheet of paper, since psnup, from psutils, did not work correctly with Heirloom troff output.

See the following files : readme, dpage, bsd2, log, or download utroff-dpage.pdf.


Ugrind is an awfull hack of vfontedpr, the programm which makes the hard work of the mostly forgotten vgrind preprocessor : it highlight code in troff sources. Vfontedpr doesn’t handle variables, troff source nor color, Ugrind does all that, and is easier to use. It is written in C, and is probably the lightest tool you’ll ever find for this task.

See the following files : readme, ugrind, bsd2, bsd4, cddl, log, or download utroff-ugrind.pdf.


Idx build, repair, format, and handle index files. It has been made to automatically index a troff document, but it also provides option to be used as an helper tool to manually index a book, and work with index files. idx is a shell and awk script.

See the following files : readme, idx, bsd2, log, or download utroff-idx.pdf.


Refer is a small hack of the venerable refer, as found in the heirloom-doctools archive. Refer use strings definition for small capitals, makes a difference between lastname and firstname in author and editor fiels, add support for multiple editors, and give an option to sort the bibliography database in the order defined by the iso-690 bibliography standart.

See the following files : readme, hunt, inv, mkey, refer, sortbib, referformat, bsd4, cddl, log, or download utroff-refer.pdf.


The soelim software which is part of the heirloom doctools archive did not change the file name when needed. This hack simply does that. Utmac needed this to insert anchors links and in pdf documents. The archive also contain slelim to eliminates some slashes and felim to eliminate hardcoded fonts.

See the following files : readme, soelim, felim, slelim, bsd2, cddl, log, or download utroff-soelim.pdf.


Tchars translate an ascii coded text to complex utf-8 characters. Actually, it can only translate a simple sort of beta-code to polytonic greek.

See the following files : readme, tchars, bsd2, log, or download utroff-tchars.pdf.

Troffxml tools

The troffxml tools convert an utmac file to xml. They are longer discussed in the xml page.

See the following files : readme, postxml, trxtr, bsd2, log, or download utroff-troffxml.pdf.

U script

To avoid conflicts with Groff and the vanilla Heirloom Troff, Utroff is installed by default on /opt/utroff. The U script has been made to use utroff easily, even if its bin/ directory is at the end of the PATH environment variable.

See the following files : readme, U, bsd2, log, or download utroff-U.pdf.


Look at the list of changes and download the pre-built archive utroff-0.3.tar.gz and its md5sum to install utroff on your system, or download the RCS list of revision utroff-dev.tar.gz and its md5sum to hack the sources. All these tools are part of the utroff archive.