xref: /plan9/sys/src/cmd/troff/README (revision 219b2ee8daee37f4aad58d63f21287faa8e4ffdc)
1*219b2ee8SDavid du ColombierTo make troff (actually a.out):
2*219b2ee8SDavid du Colombier
3*219b2ee8SDavid du Colombier	make
4*219b2ee8SDavid du Colombier
5*219b2ee8SDavid du ColombierYou will also need to write a driver for your favorite output device.
6*219b2ee8SDavid du Colombierd202.c provides a model, although it is specialized to a machine no
7*219b2ee8SDavid du Colombierone has.  There are also a variety of postscript drivers that are the
8*219b2ee8SDavid du Colombierbest thing to use if you have a postscript device.
9*219b2ee8SDavid du Colombier
10*219b2ee8SDavid du ColombierYou will also have to make a DESC file for your typesetter and some
11*219b2ee8SDavid du Colombierfont description files; see dev202 for examples.  These describe the
12*219b2ee8SDavid du Colombiernamed characters, widths, kerning information, and output codes.
13*219b2ee8SDavid du Colombier
14*219b2ee8SDavid du ColombierNroff is the same program as troff, so you should
15*219b2ee8SDavid du Colombier
16*219b2ee8SDavid du Colombier	cp a.out /usr/bin/troff
17*219b2ee8SDavid du Colombier	ln /usr/bin/troff /usr/bin/nroff
18*219b2ee8SDavid du Colombier
19*219b2ee8SDavid du Colombieror the equivalent.
20*219b2ee8SDavid du Colombier
21*219b2ee8SDavid du ColombierYou will also need terminal description files for your terminals; see
22*219b2ee8SDavid du Colombiertab.37, tab.450 and tab.lp for examples.
23*219b2ee8SDavid du Colombier
24*219b2ee8SDavid du ColombierTroff uses files that are normally stored in /usr/lib/font;
25*219b2ee8SDavid du Colombiermacro packages are in /usr/lib/tmac; and nroff tables are in
26*219b2ee8SDavid du Colombier/usr/lib/term.  You can edit tdef.h to change these assumptions.
27*219b2ee8SDavid du Colombier
28*219b2ee8SDavid du ColombierThere have been a few features since the last version, and a number of
29*219b2ee8SDavid du Colombiersignificant internal changes.  Not all are improvements, of course.
30*219b2ee8SDavid du ColombierMost of the more recent changes, including bug fixes, are in FIXES,
31*219b2ee8SDavid du Colombierwhich you should read also.
32