Annotation of researchv10dc/man/manx/troff.5, revision 1.1.1.1

1.1       root        1: .TH TROFF 5
                      2: .CT 1 writing_output
                      3: .SH NAME
                      4: troff \- device-independent output
                      5: .SH DESCRIPTION
                      6: .IR Troff (1)
                      7: produces an ASCII representation of a typeset document,
                      8: expressed in the following syntax.
                      9: Strings inside
                     10: .B [
                     11: .B ]
                     12: are optional.
                     13: The string
                     14: .B \en
                     15: represents newline.
                     16: White space (spaces or newlines) may occur
                     17: between commands and is sometimes necessary to terminate numbers.
                     18: .PP
                     19: .TP
                     20: .BI s n
                     21: Set point size to
                     22: .I n.
                     23: .PD 0
                     24: .TP
                     25: .BI f n
                     26: Use font in position 
                     27: .I n.
                     28: Normally fonts
                     29: are mounted starting at position 1; 0 is reserved.
                     30: .I troff.
                     31: .TP
                     32: .BI c x
                     33: Place character
                     34: .I x
                     35: at the current location on the page;
                     36: .I x
                     37: is a single ASCII character.
                     38: .TP
                     39: .BI C name
                     40: Place special character.
                     41: The
                     42: .I name
                     43: of the character is delimited by white space.
                     44: .TP
                     45: .BI H n
                     46: Go to horizontal location
                     47: .I n,
                     48: expressed in basic units.
                     49: .TP
                     50: .BI h n
                     51: Add 
                     52: .I n
                     53: to the current horizontal location (relative goto).
                     54: .TP
                     55: .BI V n
                     56: Go to vertical location
                     57: .I n,
                     58: measured positive downward.
                     59: .TP
                     60: .BI v n
                     61: Add 
                     62: .I n
                     63: to the current vertical location.
                     64: .TP
                     65: .I nnx
                     66: A two-digit number followed by an ASCII character; equivalent to
                     67: .BI h nn c x.
                     68: .TP
                     69: .BI n b\ a
                     70: End of line.
                     71: No action is required;
                     72: .I troff
                     73: will explicitly reset the location.
                     74: Number
                     75: .IR b 
                     76: is the amount of space before
                     77: the line,
                     78: .IR a ,
                     79: the amount of space after the line.
                     80: .TP
                     81: .B w
                     82: A
                     83: .B w
                     84: appears between words of the input document.
                     85: No action is
                     86: required.
                     87: .TP
                     88: .BI p n
                     89: Begin a new page with page number
                     90: .I n.
                     91: The vertical location on the page becomes 0.
                     92: .TP
                     93: .BI # \ .... \en
                     94: Comment.
                     95: .TP
                     96: .BI Dl " x y" \en
                     97: Draw a line from the current location by
                     98: .IR x , y .
                     99: .TP 
                    100: .BI Dc " d" \en
                    101: Draw a circle of diameter
                    102: .I d
                    103: with the leftmost edge at the current location,
                    104: .IR x , y .
                    105: The current location becomes
                    106: .IR x + d  , y .
                    107: .TP
                    108: .BI De " dx dy" \en
                    109: Draw an ellipse with 
                    110: .IR x -axis
                    111: .I dx
                    112: and
                    113: .IR y -axis
                    114: .I dy.
                    115: The leftmost edge
                    116: of the ellipse will be at the current location.
                    117: The current location becomes
                    118: .IR x + dx , y .
                    119: .TP
                    120: .BI Da " x y u v" \en
                    121: Draw an arc counterclockwise from the current location to
                    122: .IR x + u,
                    123: .IR y + v,
                    124: with center offset
                    125: .IR x , y
                    126: from the current location.
                    127: The end of the arc becomes the current location.
                    128: .TP
                    129: .BI D~ " x y x y ..." \en
                    130: Draw a spline curve (wiggly line) from the
                    131: current location, moving by
                    132: .I x,y
                    133: each time.
                    134: The end of the curve becomes the current location.
                    135: .TP
                    136: .B x\ i[nit]\en
                    137: Initialize the typesetting device.
                    138: The actions required depend on the device.
                    139: .TP
                    140: .BI x\ T \ dest \en
                    141: The name of the typesetter is
                    142: .IR dest ,
                    143: as in  option
                    144: .BR \-T 
                    145: of
                    146: .IR troff (1).
                    147: .TP
                    148: .BI "x r[es]" " n h v" \en
                    149: The resolution of the typesetting device is
                    150: .IR n 
                    151: units per inch.
                    152: Horizontal motions must be multiples of
                    153: .I h
                    154: units, vertical motions 
                    155: .I v
                    156: units.
                    157: .TP
                    158: .B x p[ause]\en
                    159: Pause.
                    160: Cause the current page to finish but do not relinquish the
                    161: typesetter.
                    162: .TP
                    163: .B x s[top]\en
                    164: Stop.
                    165: Cause the current page to finish and then relinquish the typesetter.
                    166: .TP
                    167: .B x t[railer]\en
                    168: Generate a trailer if necessary.
                    169: .TP
                    170: .BI "x f[ont]" " n name" \en
                    171: Load font
                    172: .I name
                    173: into position
                    174: .IR n .
                    175: .TP
                    176: .BI "x H[eight] "  n \en
                    177: Set the character height to
                    178: .I n
                    179: points.
                    180: This causes the letters
                    181: to be elongated or shortened.
                    182: It does not affect the width
                    183: of a letter.
                    184: Not all typesetters can do this.
                    185: .TP
                    186: .BI "x S[lant] " n \en
                    187: Set the slant to
                    188: .I n
                    189: degrees, if possible.
                    190: .TP
                    191: .BI x "..." \en
                    192: Arbitrary;  may be used for device-specific functions.
                    193: .SH SEE ALSO
                    194: .IR troff (1),
                    195: .IR d202 (1),
                    196: .IR apsend (1),
                    197: .IR lp (1),
                    198: .IR proof (9.1)
                    199: .br
                    200: B. W. Kernighan,
                    201: .I "A Typesetter-Independent Troff
                    202: this manual, volume 2.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.