5. Quale pacchetto di macro dovrei utilizzare?

Esistono numerosi pacchetti di macro progettati appositamente per scrivere le pagine di manuale; di solito si trovano nella directory delle macro di groff /usr/lib/groff/tmac. I nomi dei file sono tmac.<qualcosa>, dove <qualcosa> è l'argomento per l'opzione -m di groff. Groff utilizzerà tmac.<qualcosa> quando verrà data l'opzione `-m <qualcosa>'. Spesso viene omesso lo spazio tra `-m' e `<qualcosa>', cosicché potremo scrivere `groff -man' per formattare le pagine man con il pacchetto di macro tmac.an. È questa la ragione dello strano nome `tmac.an'. Oltre a tmac.an esiste un altro pacchetto di macro che ha avuto una certa diffusione, tmac.doc, creato presso l'Università della California di Berkeley (UCB). Molte pagine man di BSD usano tale macro e sembra che l'UCB l'abbia resa un vero standard per la documentazione. Le macro tmac.doc sono molto più flessibili, ma purtroppo ci sono alcuni visualizzatori di pagine man che non le usano e che effettuano sempre la chiamata groff -man. Per esempio, tutte le versioni di xman che conosco fanno cilecca con le pagine man che richiedono tmac.doc. in definitiva, se volete fare un favore a voi stessi, usate tmac.an; l'uso di qualsiasi altro pacchetto di macro è considerato dannoso. tmac.andoc è un pacchetto di pseudo macro che fa un primo esame del sorgente e poi, sulla base di quest'esame, carica tmac.an o tmac.doc. In effetti sarebbe meglio che i visualizzatori di pagine man utilizzassero questo pacchetto di pseudo macro; poiché però ciò non avviene, è meglio prendere confidenza con il buon vecchio tmac.an. Tutto quello che d'ora in poi verrà detto sulle macro vale per tmac.an. Ad ogni modo, se volete usare le macro di tmac.doc, date un'occhiata a mdoc.samples, un esempio utile anche come tutorial. In alcune distribuzioni (come ho già detto) sono compresi mdoc(7), mdoc.samples(7) e groff_man(7).

Il massimo della documentazione ottenibile su troff, con descrizione minuziosa di tutte le macro, è il Troff User's Manual, disponibile nei formati html, PostScript (ps, 760K) o Portable Document Format (pdf, 240K). Gli autori sono Jospeh F. Ossanna e Brian W. Kernighan; è stato revisionato in novembre 1992 ed è stato messo a disposizione dai Bell Labs di AT&T. Non dimenticate di visitare l'eccellente homepage di W. Richard Steven (famoso per Unix Network Programming e per la trilogia TCP/IP Illustrated), che ha anche un elenco di risorse su Troff tra cui tbl, eqn, pic e altri filtri.