c

checknr(1)

checknr(1)

NAME

checknr - check nroff/troff ®les

SYNOPSIS

checknr [-s] [-f] [-a.x1.y1.x2.y2 ... .xn.yn] [-c.x1.x2.x3 ...c .xn] [ ®le ... ]

DESCRIPTION

checknr searches a list of nroff or troff input ®les for certain kinds of errors involving mismatched opening and closing delimiters and unknown commands. If no ®les are speci®ed, checknr searches the standard input. checknr looks for the following:

∙Font changes using \fx ... \fP.

∙Size changes using \sx ... \s0.

∙Macros that come in open ... close forms, such as the .TS and .TE macros, which must appear in matched pairs.

checknr knows about the ms and me macro packages.

Options

checknr recognizes the following options:

-aDe®ne additional macro pairs in the list. -ais followed by groups of six characters, each group de®ning a pair of macros. Each six characters consist of a period, the ®rst macro name, another period, and the second macro name. For example, to de®ne the pairs .BS and .ES, and .XS and .XE, use:

-a.BS.ES.XS.XE

No spaces are allowed between the option and its arguments.

-cDe®ne commands that checknr would otherwise interpret as unde®ned. -fIgnore \fx font changes.

-sIgnore \sx size changes.

EXTERNAL INFLUENCES

International Code Set Support

Single-byte character code sets are supported.

DIAGNOSTICS

checknr complains about unmatched delimiters, unrecognized commands, and bad command syntax.

EXAMPLES

Check ®le sorting for errors that involve mismatched opening and closing delimiters and unknown com- mands, but disregard errors caused by font changes:

checknr -f sorting

WARNINGS

checknr is designed for use on documents prepared with the intent of using checknr, much the same as lint is used. It expects a certain document writing style for \f... and \s... commands, in which each \fx is terminated with \fP and each \sx is terminated with \s0. Although text ®les format properly when the next font or point size is coded directly instead of using \fP or \s0, such techniques produce complaints from checknr. If ®les are to be examined by checknr, the \fP and \s0 delimiting conventions should be used.

-acannot be used to de®ne single-character macro names.

checknr does not recognize certain reasonable constructs such as conditionals.

AUTHOR

checknr was developed by the University of California, Berkeley.

SEE ALSO

checkeq(1), lint(1), nroff(1).

Section 1−80

− 1 −

HP-UX Release 11i: December 2000