Annotation of researchv10dc/dist/man/v4/man1/roff.1, revision 1.1.1.1

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.

unix.superglobalmegacorp.com

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