V10/man/manx/troff.5

.TH TROFF 5
.CT 1 writing_output
.SH NAME
troff \- device-independent output
.SH DESCRIPTION
.IR Troff (1)
produces an ASCII representation of a typeset document,
expressed in the following syntax.
Strings inside
.B [
.B ]
are optional.
The string
.B \en
represents newline.
White space (spaces or newlines) may occur
between commands and is sometimes necessary to terminate numbers.
.PP
.TP
.BI s n
Set point size to
.I n.
.PD 0
.TP
.BI f n
Use font in position 
.I n.
Normally fonts
are mounted starting at position 1; 0 is reserved.
.I troff.
.TP
.BI c x
Place character
.I x
at the current location on the page;
.I x
is a single ASCII character.
.TP
.BI C name
Place special character.
The
.I name
of the character is delimited by white space.
.TP
.BI H n
Go to horizontal location
.I n,
expressed in basic units.
.TP
.BI h n
Add 
.I n
to the current horizontal location (relative goto).
.TP
.BI V n
Go to vertical location
.I n,
measured positive downward.
.TP
.BI v n
Add 
.I n
to the current vertical location.
.TP
.I nnx
A two-digit number followed by an ASCII character; equivalent to
.BI h nn c x.
.TP
.BI n b\ a
End of line.
No action is required;
.I troff
will explicitly reset the location.
Number
.IR b 
is the amount of space before
the line,
.IR a ,
the amount of space after the line.
.TP
.B w
A
.B w
appears between words of the input document.
No action is
required.
.TP
.BI p n
Begin a new page with page number
.I n.
The vertical location on the page becomes 0.
.TP
.BI # \ .... \en
Comment.
.TP
.BI Dl " x y" \en
Draw a line from the current location by
.IR x , y .
.TP 
.BI Dc " d" \en
Draw a circle of diameter
.I d
with the leftmost edge at the current location,
.IR x , y .
The current location becomes
.IR x + d  , y .
.TP
.BI De " dx dy" \en
Draw an ellipse with 
.IR x -axis
.I dx
and
.IR y -axis
.I dy.
The leftmost edge
of the ellipse will be at the current location.
The current location becomes
.IR x + dx , y .
.TP
.BI Da " x y u v" \en
Draw an arc counterclockwise from the current location to
.IR x + u,
.IR y + v,
with center offset
.IR x , y
from the current location.
The end of the arc becomes the current location.
.TP
.BI D~ " x y x y ..." \en
Draw a spline curve (wiggly line) from the
current location, moving by
.I x,y
each time.
The end of the curve becomes the current location.
.TP
.B x\ i[nit]\en
Initialize the typesetting device.
The actions required depend on the device.
.TP
.BI x\ T \ dest \en
The name of the typesetter is
.IR dest ,
as in  option
.BR \-T 
of
.IR troff (1).
.TP
.BI "x r[es]" " n h v" \en
The resolution of the typesetting device is
.IR n 
units per inch.
Horizontal motions must be multiples of
.I h
units, vertical motions 
.I v
units.
.TP
.B x p[ause]\en
Pause.
Cause the current page to finish but do not relinquish the
typesetter.
.TP
.B x s[top]\en
Stop.
Cause the current page to finish and then relinquish the typesetter.
.TP
.B x t[railer]\en
Generate a trailer if necessary.
.TP
.BI "x f[ont]" " n name" \en
Load font
.I name
into position
.IR n .
.TP
.BI "x H[eight] "  n \en
Set the character height to
.I n
points.
This causes the letters
to be elongated or shortened.
It does not affect the width
of a letter.
Not all typesetters can do this.
.TP
.BI "x S[lant] " n \en
Set the slant to
.I n
degrees, if possible.
.TP
.BI x "..." \en
Arbitrary;  may be used for device-specific functions.
.SH SEE ALSO
.IR troff (1),
.IR d202 (1),
.IR apsend (1),
.IR lp (1),
.IR proof (9.1)
.br
B. W. Kernighan,
.I "A Typesetter-Independent Troff
this manual, volume 2.