MCS(5)

NAME
mcs - macros for formatting document cover sheets

SYNOPSIS
docsend -mcs [ options []] [ files []]

troff -mcs [ options []] [ files []]

DESCRIPTION
The MCS macros are a special stand-alone troff(1) package developed specifically for preparing the G.E.I.-required document cover sheet for internal technical memoranda. The MCS macros are styled after the Memorandum Macros (MM), but the two macro packages are not compatible. MCS macro usage is summarized below. The strings Rg(,) Tm(,) and produce the registered mark, trademark, and service mark, respectively.

WARNINGS
The macro has been redefined (effective March 1988). Only one argument, pages, is recognized; all other arguments are ignored.

If you choose to include MCS macros in an MM macros document, bracket the MCS macros in an ignore block (e.g., between the and requests. This way, troff(1) will ignore the MCS macros during MM processing. See the coverdoc(1) manual page for additional information.

A subset of MM-like macros can be used to format the document cover sheet title and abstract text (summarized below). It should be noted, however, that several of these macros may conflict with MM usage. Specifically, the footnote macros may not be used within the title and the display macros may not be used within title or abstract.

FILES

SEE ALSO
coverdoc(1), docsend(1), mm(5)

REFERENCE
A Primer For Creating Document Cover Sheets With Memorandum Macros and Cover Sheet Macros

SUMMARY
Macros marked with * are mandatory; all other macros are optional. Optional arguments are enclosed in square brackets. Use to represent a null argument (i.e., to skip an argument). The macros must be used in the order presented.

Define AT&T company for whom cover sheet is generated. Usage for code is:
    BL   AT&T Bell Laboratories (default)
    IS   AT&T Information Systems
    TI   AT&T Technologies, Inc.
    CH   AT&T Corporate Headquarters
Start title (followed by one or more lines of title text). Define author(s) information where n is name, i is initials (or null), l is location code, d is department, e is extension, r is room, and a is affiliation. A separate macro is required for each author (maximum 12). (Note: If register is set to before the author macro, then ``ORIGINAL SIGNED BY'' is placed above the author's signature line; by default, is set to and the space above the signature line is left blank to accommodate the author's signature.) Define responsible person (for use when no company author supplied).
Start abstract, followed by one or more lines of abstract text. An abstract is not required for Technical Correspondence. End of abstract. Specify one to nine topical keywords or keyword phrases. Define memorandum type. Usage for type is:
    1   Technical Memorandum
    2   Internal Memorandum
    3   Technical Correspondence
Appends ``S'' to document number string. Define numeric portion of the document number(s) where org is the organization number, date is six digits of the form YYMMDD (only 2 digits of the form YY for AT&T-TI), and seq is 2 digits. A separate macro is required for each document number (maximum 12). Specify full date for AT&T-TI only; date has 6 digits of the form YYMMDD . Define filing case(s) for AT&T-BL and AT&T-IS only. A separate macro is required for each filing case (maximum 12). Define project/time charge/case number(s). A separate macro is required for each number (maximum 12). Define MERCURY code(s). Usage for c is:
    chm   Chemistry and Materials
    cmm   Communications
    cmp   Computing
    elc   Electronics
    lfs   Life Sciences
    man   Manufacturing
    mas   Mathematics and Statistics
    mkt   Marketing
    phy   Physics
    std   Standards
A maximum of three codes are allowed. At least one code is required for non-restricted Technical Memoranda. Change the proprietary marking. By default, all coversheets carry the standard ``AT&T - PROPRIETARY'' marking. If code is RS(,) then the restrictive ``AT&T - PROPRIETARY (RESTRICTED)'' marking is used instead. Designate as government security classified. Specify complete document number (including the document number suffix (e.g., TM(,) IM(,) or S()) of earlier document. Indicate policy ITDS should follow concerning Future Distribution of document to AT&T employees (excluding contract employees). Usage for code is:
    y   RELEASE to any AT&T employee
    n   DO NOT RELEASE to any AT&T employee
           without obtaining appropriate approval
(Note: code must be for restricted documents.) Define name(s) to appear under signature lines in the Organizational Approval section. A separate macro is required for each name (maximum 12). Start complete copy distribution list, followed by list of names (maximum 350 names). End of distribution list (for list and/or list). Start cover sheet only distribution list, followed by list of names (maximum 350 names). Define total page count of the document in pages (not including the pages of the cover sheet) and generate the coversheet. The macros automatically calculate the ``total pages'' (including document cover sheet) by adding pages to the number of cover sheet pages generated.

The following MM-like macros are available for formatting the text of the abstract. The macros for font selection and in-line equations can also be used to format the title text.

Make text bold. Make text italic. Concatenate roman a with italic b, and alternate these two fonts for up to six arguments. Concatenate italic a with roman b, and alternate these two fonts for up to six arguments. Concatenate roman a with bold b, and alternate these two fonts for up to six arguments. Concatenate bold a with roman b, and alternate these two fonts for up to six arguments. Concatenate italic a with bold b, and alternate these two fonts for up to six arguments. Concatenate bold a with italic b, and alternate these two fonts for up to six arguments. Begin paragraph; type is for left-adjusted block paragraph (default), and for indented (5 spaces) paragraph. Start footnote with optional label, followed by one or more lines of footnote text. Automatically numbered footnotes are not supported. End of footnote. Start bullet list where t is text-indent. List item (followed by list item text). End of list. Start marked list where t is text-indent. List item, followed by list item text. End of list. Start variable-item list where t is text-indent and m is mark-indent. List item (followed by list item text). End of list. Start of static display. Usage for the format code f is:
    0 or L    left-justified (default)
    1 or I    indented (5 spaces)
    2 or C    centered lines (individually)
    3 or CB   centered as a block
The fill code l is or for no-fill mode (default), and or for fill mode. The code i is the number spaces for the right indent. End of display. Start of equation, followed by equation text. (Note: If the and macros are used to produce an equation, the macros and the equation input must be enclosed within a display (e.g., surrounded by and macros.) End of equation.