Annotation of researchv10dc/dist/man/v4/man1/roff.1, revision 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.