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.