|
|
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.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.