V10/vol2/ms/ms

.so tmac.s
.so ../ADM/mac
.XX ms 7 "Typing Documents on the UNIX System" \" do not move
.nr zz \n(%#u-1u
.nr PN \n(%#u
.de PT
.lt \\n(LLu
.pc %
.nr PN \\n%u+\\n(zzu
.if \\n%-1 .if o \\*(%o
.if \\n%-1 .if e \\*(%e
.lt \\n(.lu
..
.de BT
.nr PN \\n%u+\\n(zzu
.nr PX \\n(.s
.nr PF \\n(.f
.ft 1
.ps \\n(PS
'lt \\n(LTu
.po \\n(POu
.if o \\*(%O
.if e \\*(%E
.ft \\n(PF
.ps \\n(PX
..
....TM 76-1274-16 39199 39199-11
....ND October 8, 1976
.....typesetting
.nr CW 2.85i
.nr GW .3i
.DT August 1989
.TL
Typing Documents on the UNIX System:
.br
Using the \&\f(CB\-ms\fP and \&\f(CB\-mcs\fP Macros with Troff\(dg
.AU MH 6067 2C-516 research!llc
L. L. Cherry 
.AU MH 2C-572 6377
M. E. Lesk
.AI
.MH
.AB
This document describes a set of easy-to-use macros
for preparing documents on
.US .
The macros provide facilities for paragraphs, sections headings (optionally
with automatic numbering), page titles, footnotes,
equations,
tables, two-column format, and
several formats of cover pages for papers.
.PP
This memo includes, as an appendix,
the text of ``A Guide to Preparing
Documents with
.CW \-ms
and
.CW \-mcs ,''
which contains additional examples
of features of
.CW \-ms.
.AE
.FS
\(dg This manual is a substantial revision by Lorinda Cherry of |reference(1979 msmacros).
.FE
.PP
.BI
Introduction.
.R
This memorandum describes a package of commands to produce
papers
using the
.bd I
.I
troff
.R
formatting program.
As with other
formatting
programs,
text is prepared interspersed with formatting commands.
However, this package,
which itself is written in
.I troff
commands,
provides higher-level commands
than those provided with the basic
.I troff
program.
A separate set of macros,
.CW \-mcs ,
produces
an official AT&T style internal document cover sheet.
The
.CW \-mcs
macros automatically invoke the
.CW \-ms
macros.
Although the basic
.CW \-ms
macros work with
.I nroff ,
the
.CW \-mcs
macros do not.
Macro names were selected in
.CW \-mcs
to avoid collisions with
the original
.CW \-ms
macros and thereby maintain backward compatibility.
This document reflects the new macros.
The commands available in this package are listed in
Appendix A; the cover sheet commands and their order are in Appendix B.
.PP
.BI
Text.
.R
Type normally, except that instead of indenting for paragraphs,
place a line reading ``.PP'' before each paragraph.
This will produce indenting and extra space.
.LP
Alternatively, the command .LP that was used here will produce
a left-aligned (block) paragraph.
The paragraph spacing and indent can be changed: see below under ``Registers.''
.PP
.BI
Beginning.
.R
The input should start as follows:
.DS L
	[optional overall format .RP or .TR \- see below]
	.TI
	Title of document (one or more lines)
	.AH "G. R. Emlin" MH 3744 2C-501 research!gre
	.AI
	Author's institution(s)
	.SA
	Abstract; to be placed on the cover sheet of a paper.
	Line length is 5/6 of normal; use .ll here to change.
	.SE  (abstract end)
	.SC 10
	.NH
	Heading (one or more lines)
	.PP
	text ...
.DE
To omit some of the standard headings
(e.g. no abstract, or no author's institution) just
omit the corresponding fields and command lines.
The word
.SM
ABSTRACT
.NL
can be suppressed by writing ``.SA no'' for ``.SA'' or changed to something
else by supplying the replacement as an argument to .SA.
Several interspersed .AH and .AI lines can be used for multiple authors.
The headings are not compulsory: beginning
with a .PP command is perfectly OK and will just
start printing an ordinary paragraph.
.I Warning:
You can't just begin a document with a line of text.
Some
.CW \-ms
command must
precede any text input.  When in doubt, use .LP
to get proper initialization, although any of
the commands .PP, .LP, .TI, .SH, .NH is good enough.
.PP
.BI
Cover Sheets and First Pages.
.R
The first line
of a document may signal the general format of the first page.
In particular, if it is ".RP" a released paper type cover sheet with title and
abstract is prepared.
If it is ".TR", a Computing Science Technical Report format is produced.
If neither .RP nor .TR are present, the .SC triggers an official AT&T
style cover sheet and first page.
The default format, produced if there is no .SC command,
has no cover sheet but puts the title, author information and abstract
on the first page, and
is useful for scanning drafts.
.PP
In general
.CW \-ms
and
.CW \-mcs
are arranged so that only one form
of a document need be stored, containing all
information;  the first command gives the format,
and unnecessary items for that format are ignored.
The full set of commands to produce an official cover sheet is listed
in order in Appendix B.
If you would rather let a program generate the
.CW \-mcs
commands for you, you can use
.I docgen .
|reference(latest volume1)
.I Docgen
is an interactive program that ask questions and packages the answers
into the necessary commands to produce a cover sheet.
.PP
Warning: don't put extraneous material
between the .TI and .SE commands.  Processing
of the titling items is
special, and other data placed in them may not behave
as you expect.
Don't forget that some
.CW \-ms
command must precede any input text.
.PP
.BI
Page headings.
.R
The
.CW \-ms
macros, by default, will print a page heading containing
a page number (if greater than 1).
The default page footer is empty.
You can make minor adjustments to the page headings/footings
by redefining the
strings
LH, CH, and RH
which are the left, center and right portions of the page headings,
respectively; and the
strings
LF, CF, and RF,
which are the left, center and right portions of the page footer.
For more complex formats, the user can redefine
the macros PT and BT, which are invoked respectively at the top
and bottom of each page.
The margins (taken from registers HM and FM for the top and bottom
margin respectively) are normally 1 inch; the page header/footer are
in the middle of that space.
If you redefine these macros, you should be careful
not to change parameters such as point size or font
without resetting them to default values.
.PP
.2C
.BI
Multi-column formats.
.R
If you place the command ``.2C'' in your document, the document will
be printed in double column format beginning
at that point.
The command ``.1C'' will go
back to one-column format and also skip to a new page.
The ``.2C'' command is actually a special case of the command
.DS L
	.MC [column width [gutter width]]
.DE
which makes multiple columns with the specified column
and gutter width; as many columns as will fit across the page
are used.
Thus triple, quadruple, ... column pages can be printed.
Whenever the number of columns is changed (except going from
full width to some larger number of columns)
a new page is started.
.PP
.BI
Headings.
.R
There are two commands to produce headings.
If you type
.DS L
	.NH
	type section heading here
	may be several lines
.DE
you will get automatically numbered section headings (1, 2, 3, ...),
in boldface.
For example,
.DS L
    .NH
    Care and Feeding of Department Heads
.DE
produces
.NH
Care and Feeding of Department Heads
.PP
Alternatively,
.DS L
	.SH
	Care and Feeding of Directors
.DE
will print the heading with no number added:
.SH
Care and Feeding of Directors
.PP
Every section heading, of either type, should be followed
by a paragraph beginning with .PP or .LP, indicating
the end of the heading
or another heading command.
Headings may contain more than one line
of text.
.PP
The .NH command also supports more complex numbering schemes.
If a numerical argument is given, it is taken to be a
``level'' number and an appropriate sub-section
number is generated.
Larger level numbers indicate deeper
sub-sections, as in this example:
.DS L
	.NH
	Erie-Lackawanna
	.NH 2
	Morris and Essex Division
	.NH 3
	Gladstone Branch
	.NH 3
	Montclair Branch
	.NH 2
	Boonton Line
.DE
generates:
.br
.ne 2i
.NH
Erie-Lackawanna
.NH 2
Morris and Essex Division
.NH 3
Gladstone Branch
.NH 3
Montclair Branch
.sp
.B
2.2. Boonton Line
.R
.PP
An explicit ``.NH 0'' will reset the numbering of level 1
to one, as here:
.DS L
	.NH 0
	Penn Central
.DE
.ft 3
.if n .ul 1
.sp 1
1.  Penn Central
.PP
.BI
Indented paragraphs.
.R
(Paragraphs with hanging numbers, e.g., references.)
The sequence
.DS L
	.IP [1]
	Text for first paragraph, typed
	normally for as long as you would
	like on as many lines as needed.
	.IP [2]
	Text for second paragraph, ...
.DE
produces
.IP [1]
Text for first paragraph, typed normally for as long
as you would like on as many lines as
needed.
.IP [2]
Text for second paragraph, ...
.LP
A series of indented paragraphs may be followed by an ordinary paragraph
beginning with .PP or .LP,
depending on whether you wish indenting or not.
The command .LP was used here.
.PP
More sophisticated uses of .IP are also possible.
If the label is omitted, for example, a plain block indent
is produced.
.DS L
	.IP
	This material will
	just be turned into a
	block indent suitable for quotations or
	such matter.
	.LP
.DE
will produce
.IP
This material
will just be turned
into a block indent
suitable for
quotations or such matter.
.LP
If a non-standard amount of indenting is required,
it may be specified after the label
and will remain in effect until the next .PP or .LP.
The default dimension of the indent is character positions.
Thus, the general form of the .IP command
contains two additional fields: the label and the indenting
length.  For example,
.DS L
	.IP first: 9
	Notice the longer label, requiring larger
	indenting for these paragraphs.
	.IP second:
	And so forth.
	.LP
.DE
produces this:
.IP first: 9
Notice the longer label, requiring larger
indenting for these paragraphs.
.IP second:
And so forth.
.LP
It is also possible to produce multiple nested indents;
the command .RS indicates that the next .IP starts from the
current indentation level.
Each .RE will eat up one level of indenting
so you should balance .RS and .RE commands.
The .RS command should be thought of as ``move right'' and
the .RE command as ``move left''.
As an example
.DS L
	.IP 1.
	Bell Laboratories
	.RS
	.IP 1.1
	Murray Hill
	.IP 1.2
	Holmdel
	.RS
	.IP 1.2.1
	Red Hill
	.RE
	.IP 1.3
	Whippany
	.RE
	.LP
.DE
will result in
.IP 1.
Bell Laboratories
.RS
.IP 1.1
Murray Hill
.IP 1.2
Holmdel
.RS
.IP 1.2.1
Red Hill
.RE
.IP 1.3
Whippany
.RE
.LP
All of these variations on .LP leave the right
margin untouched.  Sometimes, for purposes
such as setting off a quotation, a paragraph indented
on both right and left is required.
.QP
A single paragraph
like this is obtained
by preceding it with .QP.
More complicated material (several paragraphs) should be
bracketed with .QS and .QE.
.LP
.BI
Emphasis.
.R
To get
italics
say
.DS L
	.I
	as much text as you want
	can be typed here
	.R
.DE
.bd I
.br
as was done for
.I
these three words.
.R
The .R command restores the normal (usually Roman) font.
If only one word is to be italicized, it
may be just given on the line with the .I command,
.br
.bd I 3
.DS
	.I word
.DE
and in this case no .R is needed to restore
the previous font.
A second argument to the .I command is put in the normal font
after to the first argument; a third argument is put in normal font
before the first.
These are usually used to get punctuation to follow or precede the italicized word.
.B
Boldface
.R
can be produced by
.DS L
	.B
	Text to be set in boldface
	goes here
	.R
.DE
Bold text will be underlined on the terminal or line printer.
Arguments to .B behave as those for .I described above.
.BI
Bold italic
.R
is produced with the .BI macro and
.CW
constant width
.R
font with the .CW macro.
The third argument is most useful with .CW.
To say
.CW A ) (
you would type
.DS L
	.CW A ) (
.DE
.PP
The entire font family can be changed with the .FP macro.
So to set the whole document in Palatino you would say
.DS L
	.FP palatino
.DE
Other available font families are: century, helvetica, and times.
Changing the font family does not effect the fonts used for the cover sheet
except in the abstract.
.PP
A few size changes
can be specified with
the commands .LG (make larger), .SM (make smaller), and .NL
(return to normal size).
The size change
is two points; the commands may be repeated for
.SM
increased
.SM
effect
.NL
(here one .NL canceled two .SM commands).
.PP
If actual
.UL underlining
as opposed to italicizing is required,
the command
.DS
	.UL word
.DE
will underline a word.  There is no way to underline
multiple words.
.PP
.BI
Footnotes.
.R
Material placed between lines with the commands .FS
(footnote) and .FE (footnote end) will
be collected, remembered, and finally placed
at the bottom of the current page*.
By default, footnotes are 11/12th the
length of normal text,
but this can be changed using the FL register (see below).
Footnotes are not automatically numbered.
.FS
* Like this.
.FE
.PP
.BI
Displays and Tables.
.R
To prepare displays of lines, such as tables, in which
the lines should not be re-arranged,
enclose them in the commands .DS and .DE
.DS L
	.DS
	table lines, like the
	examples here, are placed
	between .DS and .DE
	.DE
.DE
By default, lines between .DS and .DE are indented and left-adjusted.
\&.DS I is equivalent to plain .DS.
You can also center lines, or retain the left margin.
Lines bracketed by .DS C and .DE commands are
centered individually (and not re-arranged); lines bracketed
by .DS L and .DE are left-adjusted, not indented, and
not re-arranged; lines bracketed by .DS B and .DE are first left-adjusted
then centered as a block.
Thus,
.DS C
these lines were preceded
by .DS C and followed by
a .DE command;
.DE
whereas
.DS L
these lines were preceded
by .DS L and followed by
a .DE command.
.DE
and
.DS B
these lines were preceded
by .DS B and followed by
a .DE command
.DE
Normally a display is kept together, on one page.
If you wish to have a long display which
may be split across page
boundaries,
use .CD, .LD, or .ID in place of
the commands .DS C, .DS L, or .DS I respectively.
An extra argument to the .DS I or .ID command is taken
as an amount to indent.
Note: it is tempting to assume that .DS R will right adjust
lines, but it doesn't work.
.PP
.BI
Programs.
.R
Programs can be displayed using the .P1 and .P2 macros like this:
.P1 3n
#include <stdio.h>
main(){
     printf("hello, world\en");
}
.P2
The amount of indentation may be specified as an argument to .P1
or with number register P1.
.PP
.BI
Equations.
.R
If you have to do Greek or mathematics, see
.I eqn |reference(latest eqn)
for equation setting.
To aid
.I eqn
users,
.CW \-ms
provides definitions of .EQ and .EN
which normally center the equation and set it off slightly.
An argument on .EQ is taken to be an equation
number and placed in the right margin near the equation.
In addition, there are three special arguments to EQ:
the letters C, I, and L indicate centered (default),
indented, and left adjusted equations, respectively. 
If there is both a format argument
and an equation number,
give the format argument first, as in
.bd I
.DS
	.EQ L (1.3a)
.DE
for a left-adjusted equation numbered (1.3a).
.PP
.BI
Tables and Pictures.
.R
Similarly,
the macros .TS and .TE
are defined
to separate tables (see |reference(latest tbl)) from text with a little space.
A very long table with a heading may be broken
across pages by beginning it with .TS H
instead of .TS,
and placing the line .TH in the table data
after the heading.  If the table
has no heading repeated from page to page,
just use the ordinary .TS and .TE macros.
Pictures produced with
.I
pic
.R
are surrounded by the macros .PS and .PE (see |reference(latest pic))
and
.I
grap
.R
graphs are surrounded by .G1 and .G2 (see |reference(latest grap)).
.PP
.BI
Boxing words or lines.
.R
To draw rectangular boxes around words the command
.DS L
	.BX word
.DE
will print
.BX word
as shown.
.sp .05
.B1
Longer pieces of text may be boxed
by enclosing them with .B1 and .B2:
.DS L
	.B1
	text...
	.B2
.DE
as has been done here.
.B2
.PP
.BI
Keeping blocks together.
.R
If you wish to keep a table or other block of lines
together on a page, there are ``keep - release'' commands.
If a block of lines preceded by .KS and followed by .KE does
not fit on the remainder of the current page, it will begin
on a new page.
Lines bracketed by .DS and .DE commands are automatically
kept together this way.
There is also a ``keep floating'' command: if the
block to be kept together is preceded by .KF instead of .KS
and does not fit
on the current page, it will be moved down through the text
until the top of the next page.  Thus, no large blank space
will be introduced in the document.  
.PP
.BI
Troff commands.
.R
Among the useful commands from the basic formatting programs
are the following:
.DS L
	.bp - begin new page.
	.br - ``break'', stop running text
	          from line to line.
	.sp n - insert n blank lines.
	.na - don't adjust right margins.
.DE
.PP
.BI
Date.
.R
To specify a date other than today, say, for example,
.DS L
	.DT May 8, 1945
.DE
In the official cover sheet style, this date is placed on the first page.
In ".RP" or ".TR" formats
it is placed on the cover sheet and nowhere else.
To suppress the date, use .DT with no arguments.
Place this line before the title.
.PP
.BI
Signature line.
.R
You can obtain a signature line by placing
the command .SG in the document.
The authors' names will
be output in place of the .SG line and
a typing identification line with author location, department and
initials will be placed on the left side of the page.
If .SG has an argument, it is used as the typing identification line.
The .SG command is ignored
in released paper format.
.PP
.BI
Registers You Can Change.
.R
Certain of the registers used by
.CW \-ms
can
be altered to change default
settings.
They should be changed with .nr commands,
as with
.DS
	.nr PS 9
.DE
.bd I
to make the default point size 9 point.
If the effect is needed immediately, the
normal
.I
troff
.R
command, .ps 9, should be used
in addition to changing the number register.
.br
.ps 9
.vs 10p
.TS
c0 c1 c1 c
c c1 c1 c
a l1 l1 l.
Register	Defines	Takes	Default
		effect
PS	point size	next para.	10
VS	line spacing	next para.	12 pts
LL	line length	next para.	6\(fm\(fm
LT	title length	next para.	6\(fm\(fm
PD	para. spacing	next para.	0.3 VS
PI	para. indent	next para.	5 ens
FL	footnote length	next FS	11/12 LL
CW	column width	next 2C	7/15 LL
GW	intercolumn gap	next 2C	1/15 LL
PO	page offset	next page	1\(fm\(fm
HM	top margin	next page	1\(fm\(fm
FM	bottom margin	next page	1\(fm\(fm
.TE
.ps \n(PS
.vs \n(VS
You may also alter
the strings
LH, CH, and RH which are the left, center, and right headings
respectively; and similarly LF, CF, and RF which are strings in the
page footer.
The page number on
output
is taken from register PN, to permit
changing its output style.
For more complicated headers and footers
the macros PT and BT can be redefined, as
explained earlier.
.bd I 3
.PP
.BI
Accents.
.R
To simplify typing certain foreign words,
strings representing common accent marks are defined.
They precede the letter over which the mark
is to appear.
Here are the strings:
.TS
center;
c c6 c c.
Input	Output	Input	Output
\e*\(fme	\*'e	\e*~a	\*~a
\e*\(gae	\*`e	\e*ve	\h'0.15m'\v'-0.6m'\s6\zv\s0\v'0.6m'\h'-0.15m'e
\e*:u	\*:u	\e*,c	\*,c
\e*^e	\o'^e'
.TE
.PP
.BI
Usage.
.R
After your document is prepared and stored on a file,
you can print it on a laser printer with the
command
.P1
troff -mcs file | lp
.P2
The
.CW \-mcs
macros will automatically read in the
.CW \-ms
macros.
In each case, if your document is stored in several files,
just list all the filenames
where we have used ``file''.
If you used
.I docgen
to produce the cover sheet file, your file
will begin with commands to include the macros, so you need only type
.P1
troff file | lp
.P2
If equations, tables, or pictures are used,
.I eqn
and/or
.I tbl
and/or
.I pic
must be invoked as preprocessors, so you might say
.P1 0
tbl file | eqn | troff \-mcs | lp
.P2
If other preprocessors are used with
.I eqn ,
.I eqn
should be the \fBlast\fR preprocessor in the pipeline.
In case of doubt,
.I doctype (1)
will tell you how to run off a paper.
.PP
Whenever you print a paper with an official cover sheet, a time-stamped
electronic version of the cover sheet is sent to ITDS.
When ITDS receives the official paper copy of your document, the electronic version
with the same time-stamp is retrieved and included in the next Mercury
Bulletin.
All other electronic versions are deleted. 
.br
.bd I 3
.PP
.BI
References and further study.
.R
To learn more about
.I troff
see
|reference(latest troff tutorial) for a general introduction, and |reference(latest troff reference)
for the full details (experts only).
Information on related UNIX commands
is in |reference(latest volume1).
|reference(page makeup) describes page makeup macros based on
.CW \-ms.
.PP
.bd I 3
.BI
Acknowledgment.
.R
Many thanks are due to Brian Kernighan for
his help in the design and implementation of this package,
and for his assistance in preparing this manual.
.bd I
.SH
.ce
References
.LP
|reference_placement
.1C
.sp
.rs
.SH
.ce
Appendix A
.ce
List of \f(CW\-ms\fP Commands
.ft R
.TS
expand;
l l7 l l.
1C	Return to single column format.	MC	Start multiple column format.
2C	Start double column format.	NH	Specify numbered heading.
AH	Specify author. (old name AU)	NL	Return to normal type size.
AI	Specify author's institution.	P1	Begin program display.
AT	Attachments.	P2	End program display.
B	Begin boldface.	PP	Begin paragraph.
B1	Begin box.	PT	Page top header.
B2	End box.	QE	End quotation.
BT	Page bottom header.	QP	Left and right indented paragraph.
BX	Box word.	QS	Begin quotation.
CT	Copy to.	R	Return to regular font (usually Roman).
CW	Begin constant width.	RE	End one level of relative indenting.
DE	End display.	RP	Use released paper format.
DS	Start display (also CD, LD, ID).	RS	Relative indent increased one level.
DT	Change or cancel date. (old name ND)	SA	Begin abstract. (old name AB)
EN	End equation.	SC	Trigger cover sheet and first page.
EQ	Begin equation.	SE	End abstract. (old name AE)
FE	End footnote.	SG	Insert signature line.
FP	Change font family.	SH	Specify section heading.
FS	Begin footnote.	SM	Change to smaller type size.
I	Begin italics.	TE	End table.
IP	Begin indented paragraph.	TI	Specify title. (old name TL)
KE	Release keep.	TR	Computer Science Technical Report format.
KF	Begin floating keep.	TS	Begin table.
KS	Start keep.	UL	Underline one word.
LG	Increase type size.	US	``the UNIX Operating System''
LP	Left aligned block paragraph.	UX	UNIX\(rg on first use UNIX after
LT	Letter format.
.TE
.sp
.ce
.ft B
Register Names
.ft R
.PP
The following register names are used by
.CW \-ms
internally.
Independent use of these names in one's own macros may
produce incorrect output.
.TS
expand;
c s s  s s s  s s s  s s
l l l  l l l  l l l  l l.
Number registers used in \f(CW\-ms\fP
#T	BQ	FM	HT	IK	KM	MK	NS	PO	T#	TZ
\&.T	BW	FP	HY	IM	KN	ML	NX	PQ	T.	VS
1T	CS	FT	I0	IP	KR	MM	OI	PS	TB	WF
:	CW	GA	I1	IQ	KV	MN	OJ	PV	TC	XP
AJ	DV	GW	I2	IR	L1	MO	P1	PX	TD	XT
AV	DW	H1	I3	IS	LE	NA	PD	QI	TK	XV
BC	EF	H2	I4	IT	LL	NC	PE	QP	TN	XX
BD	EI	H3	I5	IU	LT	ND	PF	RO	TQ	YE
BE	EP	H4	IA	IX	MC	NF	PI	SJ	TV	YY
BH	FC	H5	IB	JQ	MF	NQ	PN	ST	TY	ZN
BI	FL	HM	IF	KI	MG
.TE
.TS
 expand;
c s s  s s s  s s s  s s
l l l  l l l  l l l  l l.
Number registers used in \f(CW\-mcs\fP
a	b	d	fc	k	m	np	qq	t	u!	wp
a1	b1	dn	g	l	m2	o	r	tc	ud	x
a2	b2	dv	h	la	m3	p	ra	tp	v	y
aa	c	e	i	lp	n	q	s	u	w	z
ar
.TE
.bp
.TS
expand;
c s s  s s s  s s s  s s
l l l  l l l  l l l  l l.
String registers used in \f(CW\-ms\fP
,	A6	BX	DF	EQ	HO	KD	ME	PT	RQ	TH
\(fm	A7	C	DS	EZ	I	KE	MF	PY	RS	TL
\(ga	A8	C1	DW	FA	I1	KF	MH	QE	RT	TM
[	A9	C2	DY	FE	I2	KJ	MN	QF	S0	TQ
]	AB	CA	E1	FF	I3	KK	MO	QP	S1	TR
^	AE	CB	E2	FG	I4	KL	MR	QS	S2	TS
~	AI	CC	E3	FJ	I5	KP	ND	R	S3	TT
:	AT	CD	E4	FK	I6	KQ	NH	R1	SG	TX
p1	AU	CF	E5	FL	I7	KS	NL	R2	SH	UL
sd	AX	CH	E6	FN	I8	LB	NP	R3	SM	US
v	B	CM	E7	FO	I9	LD	OD	R4	SN	UX
1C	B1	CS	E8	FP	ID	LF	OK	R5	SY	WB
2C	B2	CT	E9	FQ	IE	LG	P1	RC	TA	WH
A1	BB	CW	EE	FS	IH	LH	P2	RE	TC	WT
A2	BD	D	EL	FV	IM	LP	PE	RF	TD	XD
A3	BG	DA	EM	FX	IP	LT	PP	RH	TE	XF
A4	BI	DD	EN	FY	IZ	MC	PS	RP	TF	XK
A5	BT	DE
.TE
.sp
.TS
expand;
c s s  s s s  s s s  s s
l l l  l l l  l l l  l l.
String registers used in \f(CW\-mcs\fP
1L	A5	CV	DT	G9	N2	S1	TY	ZI	f	r)
2L	A6	CX	ED	GS	N3	SA	WW	ZN	k)	s(
3L	A7	CZ	EJ	HC	N4	SC	X1	ZO	m!	s)
4L	A8	D1	ET	HD	N5	SE	X2	ZP	m(	t(
5L	A9	D2	F1	HX	NN	SR	X3	ZS	n!	t)
6L	AA	D3	F2	IZ	NU	SS	X4	ZT	n(	v)
7L	AH	D4	F3	KW	OC	ST	X5	ZW	o!	ve
8L	AP	D5	F4	MC	OV	T1	XE	ZZ	o(	w)
9L	AZ	D6	F5	MG	PR	TF	XX	a)	o)	x!
A1	CE	D7	FB	MQ	QF	TI	ZA	b)	p(	x(
A2	CI	D8	FC	MT	RL	TK	ZB	d!	p)	x)
A3	CO	D9	FE	MY	RP	TO	ZC	d)	q)	y!
A4	CP	DL	FT	N1	RT	TR	ZD	e(	r(	z!
.TE
.bp
.ft B
..........
.ce 2
Appendix B
Cover Sheet Macros in Order
.ft R
.sp
.ta 1i 2i 3i
.nf
\&.DT month day, year
\&.TI
Title can be several
lines
\&.AH "author name" location_code department extension room email_addr non_btl_company
\&.AI
Author's institution
\&.AP responsible_AT&T_person
\&.SA
Abstract goes here
\&.SE
\&.KW "key word1" "key word2" ... "key word9"
\&.TY document_type software_related?
	document_type=[TM | IM], software_related=[y | n]
\&.NU department yymmdd sequence filing_case project_work_number
	default project_work_number is that of center 1127
\&.ED earlier_document_number
\&.MY m1 m2 m3 m4 m5 m6 m7 m8
	Mercury Categories, positional arguments mi=[y | n]
.in +1i
.TS
cc
ll.
position	Mercury category
1	Chemistry and Materials
2	Communications
3	Computing
4	Electronics
5	Life Science
6	Mathematics and Statistics
7	Physics
8	Manufacturing
.TE
.in -1i
\&.PR proprietary_marking
	proprietary_marking=[BP | BR | 0] ATT-BL Proprietary, Restricted, unmarked
\&.GS
	Government Security
\&.RL release_to_all_att?
	release_to_all_att?=[y |n]
\&.CO y
list of people for complete copies \- the argument to .CO requests the default 1127 list
\&.CE
\&.CV y
list of people for cover sheet only \- the argument to .CV requests the default 1127 list
\&.CE
\&.SC pages
	.SC causes the cover sheet to be output and puts the headings on the first page
.sp 2
The following macros are mandatory: .TI, .AH, .SA, .SE, .TY, .NU, .MY, .SC.
.sp
\&.RP before .TI produces released paper format; .TR produces CSTR format.
.sp
.fi
The
.I
docgen
.R
program will ask you questions and create a cover sheet file for you with
the macros in the proper order.