|
|
1.1 ! root 1: .th ROFF I 6/12/72 ! 2: .sh NAME ! 3: roff \*- format text ! 4: .sh SYNOPSIS ! 5: .bd roff ! 6: [ \fB+\fIn\fR ] [ \fB\*-\fIn\fR ] [ ! 7: .bd \*-s ! 8: ] [ ! 9: .bd \*-h ! 10: ] file ... ! 11: .sh DESCRIPTION ! 12: .it Roff ! 13: formats text according to control lines embedded ! 14: in the text in the given files. ! 15: Encountering a nonexistent file terminates printing. ! 16: Incoming interconsole messages are turned off during printing. ! 17: The optional flag arguments mean: ! 18: .s3 ! 19: .lp +5 5 ! 20: \fB+\fIn\fR Start printing at the first page with number \fIn\fR. ! 21: .s3 ! 22: .lp +5 5 ! 23: \fB\*-\fIn\fR Stop printing at the first page numbered higher ! 24: than \fIn\fR. ! 25: .s3 ! 26: .lp +5 5 ! 27: \fB\*-s\fR Stop before each page (including the first) ! 28: to allow paper manipulation; ! 29: resume on receipt of an interrupt signal. ! 30: .s3 ! 31: .lp +5 5 ! 32: \fB\*-h\fR Insert tabs in the output stream to replace ! 33: spaces whenever appropriate. ! 34: .s3 ! 35: .i0 ! 36: A Request Summary is attached. ! 37: .sh FILES ! 38: /usr/lib/suftab suffix hyphenation tables ! 39: .br ! 40: /tmp/rtm? temporary ! 41: .br ! 42: .sh "SEE ALSO" ! 43: nroff (I), troff (I) ! 44: .sh BUGS ! 45: .it Roff ! 46: is the simplest of the runoff ! 47: programs, but is virtually ! 48: undocumented. ! 49: .bp ! 50: .tc | ! 51: .tr | ! 52: .in 0 ! 53: .ce ! 54: REQUEST SUMMARY ! 55: .s3 ! 56: .ul ! 57: .if t .ta .75i 1.5i 2.25i ! 58: .if n .ta 8 16 24 32 ! 59: Request Break Initial Meaning ! 60: .if t .in2.25i ! 61: .if n .in24 ! 62: .na ! 63: .ti 0 ! 64: .li ! 65: .ad yes yes Begin adjusting right margins. ! 66: .ti 0 ! 67: .li ! 68: .ar no arabic Arabic page numbers. ! 69: .ti 0 ! 70: .li ! 71: .br yes - Causes a line break \*- the filling of ! 72: the current line is stopped. ! 73: .ti 0 ! 74: .li ! 75: .bl|n yes - Insert of n blank lines, on new page if necessary. ! 76: .ti 0 ! 77: .li ! 78: .bp|+n yes n=1 Begin new page and number it n; no n means `+1'. ! 79: .ti 0 ! 80: .li ! 81: .cc|c no c=. Control character becomes `c'. ! 82: .ti 0 ! 83: .li ! 84: .ce|n yes - Center the next n input lines, ! 85: without filling. ! 86: .ti 0 ! 87: .li ! 88: .de|xx no - Define macro named `xx' ! 89: (definition ends on line beginning `\fB..\fR'). ! 90: .ti 0 ! 91: .li ! 92: .ds yes no Double space; same as `.ls 2'. ! 93: .ti 0 ! 94: .li ! 95: .ef|t no t=\*a\*a\*a\*a Even foot title becomes t. ! 96: .ti 0 ! 97: .li ! 98: .eh|t no t=\*a\*a\*a\*a Even head title becomes t. ! 99: .ti 0 ! 100: .li ! 101: .fi yes yes Begin filling output lines. ! 102: .ti 0 ! 103: .li ! 104: .fo no t=\*a\*a\*a\*a All foot titles are t. ! 105: .ti 0 ! 106: .li ! 107: .hc|c no none Hyphenation character set to `c'. ! 108: .ti 0 ! 109: .li ! 110: .he|t no t=\*a\*a\*a\*a All head titles are t. ! 111: .ti 0 ! 112: .li ! 113: .hx no - Title lines are suppressed. ! 114: .ti 0 ! 115: .li ! 116: .hy|n no n=1 Hyphenation is done, if n=1; ! 117: and is not done, if n=0. ! 118: .ti 0 ! 119: .li ! 120: .ig no - Ignore input lines through ! 121: a line beginning with `\fB..\fR'. ! 122: .ti 0 ! 123: .li ! 124: .in|+n yes - Indent n spaces from left margin. ! 125: .ti 0 ! 126: .li ! 127: .ix +n no - Same as `.in' but without break. ! 128: .ti 0 ! 129: .li ! 130: .li|n no - Literal, treat next n lines as text. ! 131: .ti 0 ! 132: .li ! 133: .ll|+n no n=65 Line length including indent is n characters. ! 134: .ti 0 ! 135: .li ! 136: .ls|+n yes n=1 Line spacing set to n lines per output line. ! 137: .ti 0 ! 138: .li ! 139: .m1|n no n=2 Put n blank lines between the top ! 140: of page and head title. ! 141: .ti 0 ! 142: .li ! 143: .m2|n no n=2 n blank lines put between head title ! 144: and beginning of text on page. ! 145: .ti 0 ! 146: .li ! 147: .m3|n no n=1 n blank lines put between end of ! 148: text and foot title. ! 149: .ti 0 ! 150: .li ! 151: .m4|n no n=3 n blank lines put between the foot title ! 152: and the bottom of page. ! 153: .ti 0 ! 154: .li ! 155: .na yes no Stop adjusting the right margin. ! 156: .ti 0 ! 157: .li ! 158: .ne|n no - Begin new page, if n output lines ! 159: cannot fit on present page. ! 160: .ti 0 ! 161: .li ! 162: .nn|+n no - The next n output lines are not numbered. ! 163: .ti 0 ! 164: .li ! 165: .n1 no no Number output lines; start with 1 each page ! 166: .ti 0 ! 167: .li ! 168: .n2|n no no Number output lines; stop numbering if n=0. ! 169: .ti 0 ! 170: .li ! 171: .ni|+n no n=0 Line numbers are indented n. ! 172: .ti 0 ! 173: .li ! 174: .nf yes no Stop filling output lines. ! 175: .ti 0 ! 176: .li ! 177: .nx|filename - Change to input file `filename'. ! 178: .ti 0 ! 179: .li ! 180: .of|t no t=\*a\*a\*a\*a Odd foot title becomes t. ! 181: .ti 0 ! 182: .li ! 183: .oh|t no t=\*a\*a\*a\*a Odd head title becomes t. ! 184: .ti 0 ! 185: .li ! 186: .pa|+n yes n=1 Same as `.bp'. ! 187: .ti 0 ! 188: .li ! 189: .pl|+n no n=66 Total paper length taken to be n lines. ! 190: .ti 0 ! 191: .li ! 192: .po|+n no n=0 Page offset. ! 193: All lines are preceded by N spaces. ! 194: .ti 0 ! 195: .li ! 196: .ro no arabic Roman page numbers. ! 197: .ti 0 ! 198: .li ! 199: .sk|n no - Produce n blank pages starting next page. ! 200: .ti 0 ! 201: .li ! 202: .sp|n yes - Insert block of n blank lines. ! 203: .ti 0 ! 204: .li ! 205: .ss yes yes Single space output lines, ! 206: equivalent to `.ls 1'. ! 207: .ti 0 ! 208: .li ! 209: .ta|N|M|... - Pseudotab settings. ! 210: Initial tab settings are columns 9,17,25,... ! 211: .ti 0 ! 212: .li ! 213: .tc|c no c=`|' Tab replacement character becomes `c'. ! 214: .ti 0 ! 215: .li ! 216: .ti|+n yes - Temporarily indent next output ! 217: line n space. ! 218: .ti0 ! 219: .li ! 220: .tr|abcd.. no - Translate a into b, c into d, etc. ! 221: .ti0 ! 222: .li ! 223: .ul|n no - Underline the letters and numbers ! 224: in the next n input lines.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.