Welk macropackage kan ik het beste gebruiken?

Er zijn een aantal macropackages speciaal ontworpen voor gebruik bij het schrijven van manpages. Gewoonlijk zijn ze te vinden in de groff macrodirectory /usr/lib/groff/tmac. De bestandsnamen zijn tmac.<iets>, waarbij <iets> het argument is aan de -m optie van groff. Groff zal tmac.<iets> gebruiken wanneer het de optie `-m <iets>' meekrijgt. Vaak wordt de spatie tussen `-m' en `<iets>' weggelaten, dus kunnen we zeggen `groff -man' wanneer we manpages met het macropackage tmac.an formatteren. Dat is de reden voor de vreemde naam `tmac.an'. Afgezien van tmac.an is er nog een ander populair macropackage, genaamd tmac.doc, welk zijn oorsprong vindt op de Universiteit van Californië op Berkeley. Veel BSD manpages gebruiken het en het schijnt dat UCB het tot standaard heeft verheven voor documentatie. De tmac.doc macro's zijn veel flexibeler, maar helaas zijn er manpage browsers die ze niet zullen gebruiken en altijd groff -man zullen aanroepen. Bijvoorbeeld alle xman programma's die ik heb gezien zullen manpages die tmac.doc nodig hebben verknallen. Dus doe jezelf een plezier: gebruik tmac.an -- het gebruik van een ander macropackage wordt als schadelijk aangemerkt. tmac.andoc is een pseudo macropackage dat de broncode bekijkt en dan tmac.an of tmac.doc laadt. In feite zou elke manpagebrowser het moeten gebruiken, maar tot op heden, doen ze dit niet allemaal, dus is het 't beste als ons we vasthouden aan de oude tmac.an. Alles wat ik je van nu af aan vertel met betrekking tot macro's geldt alleen voor tmac.an. Als je toch gebruik wilt maken van de tmac.doc macro's, bekijk dan de tutorialsampler, mdoc.samples. Een aantal distro's (is me verteld) worden ook met mdoc(7), mdoc.samples(7) en groff_man(7) geleverd.

De definitieve bron voor troff, waarin alle macro's worden uitgelegd is de Troff User's Manual, beschikbaar in html, PostScript (ps, 760K) of Portable Document Format (pdf, 240K). door Jospeh F. Ossanna en Brian W. Kernighan, gereviseerd November 1992. AT&T Bell Labs heeft het voor het publiek beschikbaar gesteld. Vergeet niet de laatste geweldige homepage van W. Richard Steven te bekijken (beroemd om Unix Network Programming als ook de TCP/IP Illustrated trilogie), die ook een lijst heeft met Troff Resources waaronder tbl, eqn, pic en andere filters.