checknr(1) checknr(1)
NAME [Toc] [Back]
checknr - check nroff/troff files
SYNOPSIS [Toc] [Back]
checknr [-s] [-f] [-a.x1.y1.x2.y2 ... .xn.yn] [-c.x1.x2.x3...c .xn]
[file ...]
DESCRIPTION [Toc] [Back]
checknr searches a list of nroff or troff input files for certain
kinds of errors involving mismatched opening and closing delimiters
and unknown commands. If no files are specified, 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 [Toc] [Back]
checknr recognizes the following options:
-a Define additional macro pairs in the list. -a is followed
by groups of six characters, each group defining a pair of
macros. Each six characters consist of a period, the first
macro name, another period, and the second macro name. For
example, to define 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.
-c Define commands that checknr would otherwise interpret as
undefined.
-f Ignore \fx font changes.
-s Ignore \sx size changes.
EXTERNAL INFLUENCES [Toc] [Back]
International Code Set Support
Single-byte character code sets are supported.
DIAGNOSTICS [Toc] [Back]
checknr complains about unmatched delimiters, unrecognized commands,
and bad command syntax.
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003
checknr(1) checknr(1)
EXAMPLES [Toc] [Back]
Check file sorting for errors that involve mismatched opening and
closing delimiters and unknown commands, but disregard errors caused
by font changes:
checknr -f sorting
WARNINGS [Toc] [Back]
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 files 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 files are to be examined by checknr, the
\fP and \s0 delimiting conventions should be used.
-a cannot be used to define single-character macro names.
checknr does not recognize certain reasonable constructs such as
conditionals.
AUTHOR [Toc] [Back]
checknr was developed by the University of California, Berkeley.
SEE ALSO [Toc] [Back]
checkeq(1), lint(1), nroff(1).
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: August 2003 [ Back ] |