Annotation of 43BSDReno/share/man/man7/ms.7, revision 1.1

1.1     ! root        1: .\" Copyright (c) 1980 Regents of the University of California.
        !             2: .\" All rights reserved.  The Berkeley software License Agreement
        !             3: .\" specifies the terms and conditions for redistribution.
        !             4: .\"
        !             5: .\"    @(#)ms.7        6.2 (Berkeley) 5/2/88
        !             6: .\"
        !             7: .TH MS 7 "May 2, 1988"
        !             8: .UC 4
        !             9: .ds ]W UCB Computer Center
        !            10: .SH NAME
        !            11: ms \- text formatting macros
        !            12: .SH SYNOPSIS
        !            13: \fBnroff  \-ms\fP  [ options ]  file  ...
        !            14: .br
        !            15: \fBtroff  \-ms\fP  [ options ]  file  ...
        !            16: .SH DESCRIPTION
        !            17: This package of \fInroff\fP\| and \fItroff\fP\|
        !            18: macro definitions provides a formatting facility
        !            19: for various styles of articles, theses, and books.
        !            20: When producing 2-column output on a terminal or lineprinter,
        !            21: or when reverse line motions are needed,
        !            22: filter the output through \fIcol\fP\|(1).
        !            23: All external \-ms macros are defined below.
        !            24: Many \fInroff\fP\| and \fItroff\fP\| requests
        !            25: are unsafe in conjunction with this package.
        !            26: However, the first four requests below
        !            27: may be used with impunity after initialization,
        !            28: and the last two may be used even before initialization:
        !            29: .sp .2
        !            30: .ta 5n 12n
        !            31: .nf
        !            32:        .bp     begin new page
        !            33:        .br     break output line
        !            34:        .sp n   insert n spacing lines
        !            35:        .ce n   center next n lines
        !            36:        .ls n   line spacing: n=1 single, n=2 double space
        !            37:        .na     no alignment of right margin
        !            38: .fi
        !            39: .sp .2
        !            40: Font and point size changes with \ef and \es are also allowed;
        !            41: for example, ``\efIword\efR'' will italicize \fIword.\fP
        !            42: Output of the \fItbl, eqn,\fP and \fIrefer\fP\|(1) preprocessors
        !            43: for equations, tables, and references is acceptable as input.
        !            44: .SH FILES
        !            45: /usr/share/tmac/tmac.x
        !            46: .br
        !            47: /usr/share/ms/x.???
        !            48: .SH "SEE ALSO"
        !            49: eqn(1), refer(1), tbl(1), troff(1)
        !            50: .SH REQUESTS
        !            51: .if n .in 0
        !            52: .ds x \fIx\fP\|
        !            53: .ds y \fIy\fP\|
        !            54: .ds z \fI y\fP
        !            55: .ds Y \fIx y\fP
        !            56: .tr _.
        !            57: .ta \w'MacroNam'u +\w'InitialVal'u +\w'Break? 'u
        !            58: .sp .3
        !            59: .nf
        !            60: Macro  Initial Break?  \0 Explanation
        !            61: Name   Value   Reset?
        !            62: .sp .3
        !            63: _AB \*x        \-      y       begin abstract; if \*x=no don't label abstract
        !            64: _AE    \-      y       end abstract
        !            65: _AI    \-      y       author's institution
        !            66: _AM    \-      n       better accent mark definitions
        !            67: _AU    \-      y       author's name
        !            68: _B \*x \-      n       embolden \*x; if no \*x, switch to boldface
        !            69: _B1    \-      y       begin text to be enclosed in a box
        !            70: _B2    \-      y       end boxed text and print it
        !            71: _BT    date    n       bottom title, printed at foot of page
        !            72: _BX \*x        \-      n       print word \*x in a box
        !            73: _CM    if t    n       cut mark between pages
        !            74: _CT    \-      y,y     chapter title: page number moved to CF (TM only)
        !            75: _DA \*x        if n    n       force date \*x at bottom of page; today if no \*x
        !            76: _DE    \-      y       end display (unfilled text) of any kind
        !            77: _DS \*Y        I       y       begin display with keep; \*x=I,L,C,B; \*y=indent 
        !            78: _ID\*z 8n,.5i  y       indented display with no keep; \*y=indent
        !            79: _LD    \-      y       left display with no keep
        !            80: _CD    \-      y       centered display with no keep
        !            81: _BD    \-      y       block display; center entire block
        !            82: _EF \*x        \-      n       even page footer \*x (3 part as for .tl)
        !            83: _EH \*x        \-      n       even page header \*x (3 part as for .tl)
        !            84: _EN    \-      y       end displayed equation produced by \fIeqn\fP
        !            85: _EQ \*Y        \-      y       break out equation; \*x=L,I,C; \*y=equation number
        !            86: _FE    \-      n       end footnote to be placed at bottom of page
        !            87: _FP    \-      n       numbered footnote paragraph; may be redefined
        !            88: _FS \*x        \-      n       start footnote; \*x is optional footnote label
        !            89: _HD    undef   n       optional page header below header margin
        !            90: _I \*x \-      n       italicize \*x; if no \*x, switch to italics
        !            91: _IP \*Y        \-      y,y     indented paragraph, with hanging tag \*x; \*y=indent
        !            92: _IX \*Y        \-      y       index words \*x \*y and so on (up to 5 levels)
        !            93: _KE    \-      n       end keep of any kind
        !            94: _KF    \-      n       begin floating keep; text fills remainder of page
        !            95: _KS    \-      y       begin keep; unit kept together on a single page
        !            96: _LG    \-      n       larger; increase point size by 2
        !            97: _LP    \-      y,y     left (block) paragraph.
        !            98: _MC \*x        \-      y,y     multiple columns; \*x=column width
        !            99: _ND \*x        if t    n       no date in page footer; \*x is date on cover
        !           100: _NH \*Y        \-      y,y     numbered header; \*x=level, \*x=0 resets, \*x=S sets to \*y
        !           101: _NL    10p     n       set point size back to normal
        !           102: _OF \*x        \-      n       odd page footer \*x (3 part as for .tl)
        !           103: _OH \*x        \-      n       odd page header \*x (3 part as for .tl)
        !           104: _P1    if TM   n       print header on 1st page
        !           105: _PP    \-      y,y     paragraph with first line indented
        !           106: _PT    - % -   n       page title, printed at head of page
        !           107: _PX \*x        \-      y       print index (table of contents); \*x=no suppresses title
        !           108: _QP    \-      y,y     quote paragraph (indented and shorter)
        !           109: _R     on      n       return to Roman font
        !           110: _RE    5n      y,y     retreat: end level of relative indentation
        !           111: _RP \*x        \-      n       released paper format; \*x=no stops title on 1st page
        !           112: _RS    5n      y,y     right shift: start level of relative indentation
        !           113: _SH    \-      y,y     section header, in boldface
        !           114: _SM    \-      n       smaller; decrease point size by 2
        !           115: _TA    8n,5n   n       set tabs to 8n 16n ... (nroff) 5n 10n ... (troff)
        !           116: _TC \*x        \-      y       print table of contents at end; \*x=no suppresses title
        !           117: _TE    \-      y       end of table processed by \fItbl\fP
        !           118: _TH    \-      y       end multi-page header of table
        !           119: _TL    \-      y       title in boldface and two points larger
        !           120: _TM    off     n       UC Berkeley thesis mode
        !           121: _TS \*x        \-      y,y     begin table; if \*x=H table has multi-page header
        !           122: _UL \*x        \-      n       underline \*x, even in \fItroff\fP
        !           123: _UX \*x        \-      n       UNIX; trademark message first time; \*x appended
        !           124: _XA \*Y        \-      y       another index entry; \*x=page or no for none; \*y=indent
        !           125: _XE    \-      y       end index entry (or series of .IX entries)
        !           126: _XP    \-      y,y     paragraph with first line exdented, others indented
        !           127: _XS \*Y        \-      y       begin index entry; \*x=page or no for none; \*y=indent
        !           128: _1C    on      y,y     one column format, on a new page
        !           129: _2C    \-      y,y     begin two column format
        !           130: _]-    \-      n       beginning of \fIrefer\fP\| reference
        !           131: _[0    \-      n       end of unclassifiable type of reference
        !           132: _[N    \-      n       N= 1:journal-article, 2:book, 3:book-article, 4:report
        !           133: .fi
        !           134: .if t .bp
        !           135: .DT
        !           136: .SH REGISTERS
        !           137: Formatting distances can be controlled in \-ms
        !           138: by means of built-in number registers.
        !           139: For example, this sets the line length to 6.5 inches:
        !           140: .sp .3
        !           141:        .nr  LL  6.5i
        !           142: .sp .3
        !           143: Here is a table of number registers and their default values:
        !           144: .sp .3
        !           145: .nf
        !           146: .ta .5i +\w'Name\0'u +\w'paragraph distance 'u +\w'Takes Effect 'u
        !           147:        Name    Register Controls       Takes Effect    Default
        !           148: .sp .3
        !           149:        PS      point size              paragraph       10
        !           150:        VS      vertical spacing        paragraph       12
        !           151:        LL      line length             paragraph       6i
        !           152:        LT      title length            next page       same as LL
        !           153:        FL      footnote length         next .FS        5.5i
        !           154:        PD      paragraph distance      paragraph       1v (if n), .3v (if t)
        !           155:        DD      display distance        displays        1v (if n), .5v (if t)
        !           156:        PI      paragraph indent        paragraph       5n
        !           157:        QI      quote indent            next .QP        5n
        !           158:        FI      footnote indent         next .FS        2n
        !           159:        PO      page offset             next page       0 (if n), \(ap1i (if t)
        !           160:        HM      header margin           next page       1i
        !           161:        FM      footer margin           next page       1i
        !           162:        FF      footnote format         next .FS        0 (1, 2, 3 available)
        !           163: .fi
        !           164: .sp .3
        !           165: When resetting these values,
        !           166: make sure to specify the appropriate units.
        !           167: Setting the line length to 7, for example,
        !           168: will result in output with one character per line.
        !           169: Setting FF to 1 suppresses footnote superscripting;
        !           170: setting it to 2 also suppresses indentation of the first line;
        !           171: and setting it to 3 produces an .IP-like footnote paragraph.
        !           172: .PP
        !           173: Here is a list of string registers available in \-ms;
        !           174: they may be used anywhere in the text:
        !           175: .sp .3
        !           176: .nf
        !           177: .ta .5i 1.1i
        !           178:        Name    String's Function
        !           179: .sp .3
        !           180:        \e*Q    quote (" in \fInroff,\fP\| `` in \fItroff\fP )
        !           181:        \e*U    unquote (" in \fInroff,\fP\| '' in \fItroff\fP )
        !           182:        \e*\-   dash (-- in \fInroff,\fP \(em in \fItroff\fP )
        !           183:        \e*(MO  month (month of the year)
        !           184:        \e*(DY  day (current date)
        !           185:        \e**    automatically numbered footnote
        !           186:        \e*[    opening footnote string delimiter
        !           187:        \e*]    closing footnote string delimiter
        !           188:        \e*([.  opening reference tag delimiter
        !           189:        \e*(.]  closing reference tag delimiter
        !           190:        \e*\'   acute accent (before letter)
        !           191:        \e*\`   grave accent (before letter)
        !           192:        \e*\d^  \ucircumflex (before letter)
        !           193:        \e*,    cedilla (before letter)
        !           194:        \e*:    umlaut (before letter)
        !           195:        \e*\d~  \utilde (before letter)
        !           196: .fi
        !           197: .sp .3
        !           198: The opening and closing delimiters for footnote numbers
        !           199: and reference tags may be changed by resetting the appropriate string.
        !           200: Both opening delimiters change to italics and superscript in \fItroff\fP,
        !           201: reverting to the previous font and the baseline at the closing delimiter.
        !           202: In \fInroff\fP, square brackets are used as delimiters, with footnote
        !           203: numbers in italics.
        !           204: .PP
        !           205: When using the extended accent mark definitions available with .AM,
        !           206: these strings should come after, rather than before,
        !           207: the letter to be accented.
        !           208: .SH BUGS
        !           209: Floating keeps and regular keeps are diverted to the same space,
        !           210: so they cannot be mixed together with predictable results.

unix.superglobalmegacorp.com

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