SysIII/usr/src/man/docs/mm_man/s24appd

.aH "ERROR MESSAGES"
.H 3 "MM Error Messages"
Each \*(PM error message consists of a standard part followed by a variable part.
The standard part is of the form:
.Es1
ERROR:input line \c
.I n \^:
.Ee
.P
The variable part consists of a descriptive message,
usually beginning with a macro name.
The variable parts are listed below
in alphabetical order by macro name,
each with a more complete explanation:\*F
.FS
This list is set up by ``\f3.\fPLB 37 0 2 0'' {5.4}.
.FE
.LB 37 0 2 0
.tr ~
.LI "Check~TL,~AU,~AS,~AE,~MT~sequence"
The proper sequence of macros for the beginning of a memorandum is shown in
{6.9}.
Something has disturbed this order.
.LI "AL:bad~arg:value"
The argument to the \f3.\fPAL macro is not one of 1, A, a, I, or i.
The incorrect
argument
is shown as
.I value.
.LI "CS:cover~sheet~too~long"
The text of the cover sheet is too long to fit on one page.
The abstract should be reduced or the indent of the abstract
should be decreased {6.4}.
.LI "DS:too~many~displays"
More than 26 floating displays are active at once,
i.e., have been accumulated but not yet output.
.LI "DS:missing~FE"
A display starts inside a footnote.
The likely cause is the omission (or misspelling) of a \f3.\fPFE to end a previous footnote\f3.\fP
.LI "DS:missing~DE"
\&\f3.\fPDS or \f3.\fPDF occurs within a display, i.e.,
a \f3.\fPDE has been omitted or mistyped.
.LI "DE:no~DS~or~DF~active"
\&\f3.\fPDE has been encountered
but there has not been a previous \f3.\fPDS
or \&\f3.\fPDF to match it.
.LI "FE:no~FS"
\&\f3.\fPFE has been encountered with no previous \f3.\fPFS to match it.
.LI "FS:missing~FE"
A previous \f3.\fPFS was not matched by a closing \f3.\fPFE,
i.e., an attempt is being made to begin a footnote inside another one.
.LI "FS:missing~DE"
A footnote starts inside a display, i.e.,
a \f3.\fPDS or \f3.\fPDF occurs without a matching \f3.\fPDE.
.LI "H:bad~arg:value"
The first argument to \f3.\fPH must be a single digit from
1 to 7, but
.I value
has been supplied instead.
.LI "H:missing~FE"
A heading macro (\f3.\fPH or \f3.\fPHU) occurs inside a footnote.
.LI "H:missing~DE"
A heading macro (\f3.\fPH or \f3.\fPHU) occurs
inside a display.
.LI "H:missing~arg"
\&\f3.\fPH needs at least 1 argument.
.LI "HU:missing~arg"
\&\f3.\fPHU needs 1 argument.
.LI "LB:missing~arg(s)"
\&\f3.\fPLB requires at least 4 arguments.
.LI "LB:too~many~nested~lists"
Another list was started when there were already 6 active lists.
.LI "LE:mismatched"
\&\f3.\fPLE has occurred without a previous \f3.\fPLB or other
list-initialization
macro {5.3.3}.
Although this is not a fatal error,
the message is issued because there almost certainly exists some problem
in the preceding text.
.LI "LI:no~lists~active"
\&\f3.\fPLI occurs without a preceding
list-initialization
macro.
The latter has probably been omitted,
or has been separated from the \f3.\fPLI
by an intervening \f3.\fPH or \f3.\fPHU.
.LI "ML:missing~arg"
\&\f3.\fPML requires at least 1 argument.
.LI "ND:missing~arg"
\&\f3.\fPND requires 1 argument.
.LI "SA:bad~arg:value"
The argument to \f3.\fPSA (if any) must be either 0 or 1.
The incorrect
argument is shown as
.I value.
.LI "SG:missing~DE"
\&\f3.\fPSG occurs inside a display.
.LI "SG:missing~FE"
\&\f3.\fPSG occurs inside a footnote.
.LI "SG:no~authors"
\&\f3.\fPSG occurs without any previous \f3.\fPAU macro(s).
.LI "VL:missing~arg"
\&\f3.\fPVL requires at least 1 argument.
.LE
.tr ~~
.H 3 "Formatter Error Messages"
Most messages issued by the formatter
are self-explanatory.
Those
error
messages over which the
.I user 
has (some) control are listed below.
Any other
error
messages should be reported
to the local system-support group.
.VL 5
.LI
``Cannot do ev''
is caused by
.I (a)
setting a page width that is negative or extremely short,
.I (b)
setting a page length that is negative or extremely short,
.I (c)
reprocessing a macro package (e.g. performing a .so to a macro
package that was requested from the command line),
and
.I (d)
requesting the \-s1 option to \f2troff\f1
on a document that is longer than ten pages.
.LI
``Cannot execute \c
.I filename \|''
is given by the \f3.\fP! request if it cannot find the
.I filename .
.LI
``Cannot open \c
.I filename \|''
is issued if
one of the files in the list of files to be processed
cannot be opened.
.LI
``Exception word list full'' indicates that 
too many words have been specified in
the hyphenation exception list
(via 
\&\f3.\fPhw
requests).
.LI
``Line overflow'' means that the output line being generated
was too long for the formatter's line buffer.
The excess was discarded.
See the ``Word overflow'' message below.
.LI
``Non-existent font type'' means that a request
has been made to mount an unknown font.
.LI
``Non-existent macro file'' means that the requested
macro package does not exist.
.LI
``Non-existent terminal type'' means that
the terminal options refers to an unknown terminal type.
.LI
``Out of temp file space'' means that additional temporary space for
macro definitions, diversions, etc. cannot be allocated.
This message often occurs because of unclosed diversions
(missing \f3.\fPFE or \f3.\fPDE),
unclosed macro definitions (e.g., missing ``\f3.\|.\fP''),
or a huge
table of contents.
.LI
``Too many page numbers'' is issued when the list of pages
specified to the formatter
.I -o
option
is too long.
.LI
``Too many string/macro names'' is issued when
the pool of string and macro names is full.
Unneeded strings and macros can be deleted using the
\&\f3.\fPrm
request.
.LI
``Too many number registers'' means that the pool of
number register names is full.
Unneeded registers can be deleted by using the \f3.\fPrr request.
.LI
``Word overflow'' means that a word being generated exceeded
the formatter's word buffer.
The excess characters were discarded.
A likely cause for this and for the ``Line overflow'' message above
are very long lines or words generated
through the misuse of \\c or of the
\&\f3.\fPcu
request,
or very long equations produced by
.I eqn \^(1)/\c
.I neqn \^(1).
.LE