[BACK]Return to me.7 CVS log [TXT][DIR] Up to [local] / src / share / me

Annotation of src/share/me/me.7, Revision 1.1

1.1     ! deraadt     1: .\" Copyright (c) 1980 The Regents of the University of California.
        !             2: .\" All rights reserved.
        !             3: .\"
        !             4: .\" Redistribution and use in source and binary forms, with or without
        !             5: .\" modification, are permitted provided that the following conditions
        !             6: .\" are met:
        !             7: .\" 1. Redistributions of source code must retain the above copyright
        !             8: .\"    notice, this list of conditions and the following disclaimer.
        !             9: .\" 2. Redistributions in binary form must reproduce the above copyright
        !            10: .\"    notice, this list of conditions and the following disclaimer in the
        !            11: .\"    documentation and/or other materials provided with the distribution.
        !            12: .\" 3. All advertising materials mentioning features or use of this software
        !            13: .\"    must display the following acknowledgement:
        !            14: .\"    This product includes software developed by the University of
        !            15: .\"    California, Berkeley and its contributors.
        !            16: .\" 4. Neither the name of the University nor the names of its contributors
        !            17: .\"    may be used to endorse or promote products derived from this software
        !            18: .\"    without specific prior written permission.
        !            19: .\"
        !            20: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
        !            21: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
        !            22: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
        !            23: .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
        !            24: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
        !            25: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
        !            26: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
        !            27: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
        !            28: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
        !            29: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
        !            30: .\" SUCH DAMAGE.
        !            31: .\"
        !            32: .\"    from: @(#)me.7  6.5 (Berkeley) 4/17/91
        !            33: .\"    $Id: me.7,v 1.4 1993/08/09 22:25:25 jtc Exp $
        !            34: .\"
        !            35: .hc %
        !            36: .TH ME 7 "April 17, 1991"
        !            37: .UC 3
        !            38: .SH NAME
        !            39: me \- macros for formatting papers
        !            40: .SH SYNOPSIS
        !            41: .B "nroff \-me"
        !            42: [ options ]
        !            43: file ...
        !            44: .br
        !            45: .B "troff \-me"
        !            46: [ options ]
        !            47: file ...
        !            48: .SH DESCRIPTION
        !            49: This package of
        !            50: .I nroff
        !            51: and
        !            52: .I troff
        !            53: macro definitions provides a canned formatting
        !            54: facility for tech%nical papers in various formats.
        !            55: When producing 2-column output on a terminal, filter
        !            56: the output through
        !            57: .IR  col (1).
        !            58: .PP
        !            59: The macro requests are defined below.
        !            60: Many
        !            61: .I nroff
        !            62: and
        !            63: .I troff
        !            64: requests are unsafe in conjunction with
        !            65: this package, however, these requests may be used with
        !            66: impunity after the first .pp:
        !            67: .nf
        !            68: .IP
        !            69: .ta \w'.sz +n  'u
        !            70: \&.bp  begin new page
        !            71: \&.br  break output line here
        !            72: \&.sp n        insert n spacing lines
        !            73: \&.ls n        (line spacing) n=1 single, n=2 double space
        !            74: \&.na  no alignment of right margin
        !            75: \&.ce n        center next n lines
        !            76: \&.ul n        underline next n lines
        !            77: \&.sz +n       add n to point size
        !            78: .fi
        !            79: .PP
        !            80: Output of the
        !            81: .I eqn,
        !            82: .I neqn,
        !            83: .I refer,
        !            84: and
        !            85: .IR  tbl (1)
        !            86: preprocessors
        !            87: for equations and tables is acceptable as input.
        !            88: .SH FILES
        !            89: /usr/share/tmac/tmac.e
        !            90: .br
        !            91: /usr/share/me/*
        !            92: .SH "SEE ALSO"
        !            93: eqn(1), troff(1), refer(1), tbl(1)
        !            94: .br
        !            95: \-me Reference Manual, Eric P. Allman
        !            96: .br
        !            97: Writing Papers with Nroff Using \-me
        !            98: .tr &.
        !            99: .SH REQUESTS
        !           100: In the following list,
        !           101: \*(lqinitialization\*(rq
        !           102: refers to the first .pp, .lp, .ip, .np, .sh, or .uh macro.
        !           103: This list is incomplete;
        !           104: see
        !           105: .I "The \-me Reference Manual"
        !           106: for interesting details.
        !           107: .PP
        !           108: .ta \w'.eh \'x\'y\'z\'  'u +\w'Initial 'u +\w'Cause 'u
        !           109: .br
        !           110: .di x
        !           111:                        \ka
        !           112: .br
        !           113: .di
        !           114: .in \nau
        !           115: .ti 0
        !           116: Request        Initial Cause   Explanation
        !           117: .ti 0
        !           118:        Value   Break
        !           119: .br
        !           120: .in \nau
        !           121: .ti 0
        !           122: \&.(c  -       yes     Begin centered block
        !           123: .ti 0
        !           124: \&.(d  -       no      Begin delayed text
        !           125: .ti 0
        !           126: \&.(f  -       no      Begin footnote
        !           127: .ti 0
        !           128: \&.(l  -       yes     Begin list
        !           129: .ti 0
        !           130: \&.(q  -       yes     Begin major quote
        !           131: .ti 0
        !           132: \&.(x \fIx\fR  -       no      Begin indexed item in index
        !           133: .I x
        !           134: .ti 0
        !           135: \&.(z  -       no      Begin floating keep
        !           136: .ti 0
        !           137: \&.)c  -       yes     End centered block
        !           138: .ti 0
        !           139: \&.)d  -       yes     End delayed text
        !           140: .ti 0
        !           141: \&.)f  -       yes     End footnote
        !           142: .ti 0
        !           143: \&.)l  -       yes     End list
        !           144: .ti 0
        !           145: \&.)q  -       yes     End major quote
        !           146: .ti 0
        !           147: \&.)x  -       yes     End index item
        !           148: .ti 0
        !           149: \&.)z  -       yes     End floating keep
        !           150: .ti 0
        !           151: \&.++ \fIm H\fR        -       no      Define paper section.
        !           152: .I m
        !           153: defines the part of the paper, and can be
        !           154: .B C
        !           155: (chapter),
        !           156: .B A
        !           157: (appendix),
        !           158: .B P
        !           159: (preliminary, e.g., abstract, table of contents, etc.),
        !           160: .B B
        !           161: (bibliography),
        !           162: .B RC
        !           163: (chapters renumbered from page one each chapter),
        !           164: or
        !           165: .B RA
        !           166: (appendix renumbered from page one).
        !           167: .ti 0
        !           168: \&.+c \fIT\fR  -       yes     Begin chapter (or appendix, etc., as
        !           169: set by .++).
        !           170: .I T
        !           171: is the chapter title.
        !           172: .ti 0
        !           173: \&.1c  1       yes     One column format on a new page.
        !           174: .ti 0
        !           175: \&.2c  1       yes     Two column format.
        !           176: .ti 0
        !           177: \&.EN  -       yes     Space after equation
        !           178: produced by
        !           179: .I eqn
        !           180: or
        !           181: .IR neqn .
        !           182: .ti 0
        !           183: \&.EQ \fIx y\fR        -       yes     Precede equation; break out and
        !           184: add space.
        !           185: Equation number is
        !           186: .IR y .
        !           187: The optional argument \fIx\fR
        !           188: may be
        !           189: .I I
        !           190: to indent equation (default),
        !           191: .I L
        !           192: to left-adjust the equation, or
        !           193: .I C
        !           194: to center the equation.
        !           195: .ti 0
        !           196: \&.GE  -       yes     End \fIgremlin\fP picture.
        !           197: .ti 0
        !           198: \&.GS  -       yes     Begin \fIgremlin\fP picture.
        !           199: .ti 0
        !           200: \&.PE  -       yes     End \fIpic\fP picture.
        !           201: .ti 0
        !           202: \&.PS  -       yes     Begin \fIpic\fP picture.
        !           203: .ti 0
        !           204: \&.TE  -       yes     End table.
        !           205: .ti 0
        !           206: \&.TH  -       yes     End heading section of table.
        !           207: .ti 0
        !           208: \&.TS \fIx\fR  -       yes     Begin table; if \fIx\fR is
        !           209: .I H
        !           210: table has repeated heading.
        !           211: .ti 0
        !           212: \&.ac \fIA N\fR        -       no      Set up for ACM style output.
        !           213: .I A
        !           214: is the Author's name(s),
        !           215: .I N
        !           216: is the total number of pages.
        !           217: Must be given before the first initialization.
        !           218: .ti 0
        !           219: \&.b \fIx\fR   no      no      Print
        !           220: .I x
        !           221: in boldface; if no argument switch to boldface.
        !           222: .ti 0
        !           223: \&.ba \fI+n\fR 0       yes     Augments the base indent by
        !           224: .I n.
        !           225: This indent is used to set the indent on regular text
        !           226: (like paragraphs).
        !           227: .ti 0
        !           228: \&.bc  no      yes     Begin new column
        !           229: .ti 0
        !           230: \&.bi \fIx\fR  no      no      Print
        !           231: .I x
        !           232: in bold italics (nofill only)
        !           233: .ti 0
        !           234: \&.bu  -       yes     Begin bulleted paragraph
        !           235: .ti 0
        !           236: \&.bx \fIx\fR  no      no      Print \fIx\fR in a box (nofill only).
        !           237: .ti 0
        !           238: \&.ef \fI\'x\'y\'z\'\fR        \'\'\'\'        no      Set even footer to x  y  z
        !           239: .ti 0
        !           240: \&.eh \fI\'x\'y\'z\'\fR        \'\'\'\'        no      Set even header to x  y  z
        !           241: .ti 0
        !           242: \&.fo \fI\'x\'y\'z\'\fR        \'\'\'\'        no      Set footer to x  y  z
        !           243: .ti 0
        !           244: \&.hx  -       no      Suppress headers and footers on next page.
        !           245: .ti 0
        !           246: \&.he \fI\'x\'y\'z\'\fR        \'\'\'\'        no      Set header to x  y  z
        !           247: .ti 0
        !           248: \&.hl  -       yes     Draw a horizontal line
        !           249: .ti 0
        !           250: \&.i \fIx\fR   no      no      Italicize
        !           251: .I x;
        !           252: if
        !           253: .I x
        !           254: missing, italic text follows.
        !           255: .ti 0
        !           256: \&.ip \fIx y\fR        no      yes     Start indented paragraph,
        !           257: with hanging tag
        !           258: .IR x .
        !           259: Indentation is
        !           260: .I y
        !           261: ens (default 5).
        !           262: .ti 0
        !           263: \&.lp  yes     yes     Start left-blocked paragraph.
        !           264: .ti 0
        !           265: \&.lo  -       no      Read in a file of local macros of the
        !           266: form
        !           267: .BI \&.* x.
        !           268: Must be given before initialization.
        !           269: .ti 0
        !           270: \&.np  1       yes     Start numbered paragraph.
        !           271: .ti 0
        !           272: \&.of \fI\'x\'y\'z\'\fR        \'\'\'\'        no      Set odd footer to x  y  z
        !           273: .ti 0
        !           274: \&.oh \fI\'x\'y\'z\'\fR        \'\'\'\'        no      Set odd header to x  y  z
        !           275: .ti 0
        !           276: \&.pd  -       yes     Print delayed text.
        !           277: .ti 0
        !           278: \&.pp  no      yes     Begin paragraph.
        !           279: First line indented.
        !           280: .ti 0
        !           281: \&.r   yes     no      Roman text follows.
        !           282: .ti 0
        !           283: \&.re  -       no      Reset tabs to default values.
        !           284: .ti 0
        !           285: \&.sc  no      no      Read in a file of special characters
        !           286: and diacritical marks.
        !           287: Must be given before initialization.
        !           288: .ti 0
        !           289: \&.sh \fIn x\fR        -       yes     Section head follows,
        !           290: font automatically bold.
        !           291: .I n
        !           292: is level of section,
        !           293: .I x
        !           294: is title of section.
        !           295: .ti 0
        !           296: \&.sk  no      no      Leave the next page blank.
        !           297: Only one page is remembered ahead.
        !           298: .ti 0
        !           299: \&.sm \fIx\fR  -       no      Set
        !           300: .I x
        !           301: in a smaller pointsize.
        !           302: .ti 0
        !           303: \&.sz \fI+n\fR 10p     no      Augment the point size by
        !           304: .I n
        !           305: points.
        !           306: .ti 0
        !           307: \&.th  no      no      Produce the paper in thesis format.
        !           308: Must be given before initialization.
        !           309: .ti 0
        !           310: \&.tp  no      yes     Begin title page.
        !           311: .ti 0
        !           312: \&.u \fIx\fR   -       no      Underline argument (even in \fItroff\fR).
        !           313: (Nofill only).
        !           314: .ti 0
        !           315: \&.uh  -       yes     Like .sh but unnumbered.
        !           316: .ti 0
        !           317: \&.xp \fIx\fR  -       no      Print index
        !           318: .I x.