NAME

checknr − check nroff/troff files

SYNOPSIS

checknr [ −s ] [ −f ] [ −a.x1.y1.x2.y2. ... .xn.yn ] [ −c.x1.x2.x3 ... .xn ] [ file ...  ]

DESCRIPTION

Checknr checks a list of nroff(1) or troff input files for certain kinds of errors involving mismatched opening and closing delimiters and unknown commands.  If no files are specified, checknr checks the standard input.  Delimiters checked are:

(1)Font changes using \fx ... \fP. 

(2)Size changes using \sx ... \s0. 

(3)Macros that come in open ... close forms, such as the .TS and .TE macros, both of which must appear. 

Checknr knows about the ms and me macro packages. 

Additional pairs of macros can be added to the list using the −a option.  This must be followed by groups of six characters, each group defining a pair of macros.  The six characters are a period, the first macro name, another period, and the second macro name.  For example, to define a pair .BS and .ES, use −a.BS.ES

The −c option defines commands that checknr would interpret otherwise as undefined. 

The −f option requests checknr to ignore \f font changes. 

The −s option requests checknr to ignore \s size changes. 

DIAGNOSTICS

Checknr complains about unmatched delimiters, unrecognized commands, and bad syntax of commands. 

EXAMPLES

The command:

checknr -f sorting

checks the file sorting for errors that involve mismatched opening and closing delimiters and unknown commands, but disregards errors caused by font changes. 

WARNINGS

Checknr is intended for use on documents prepared with checknr in mind, much the same as lint. 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. While text formats properly when the next font or point size is specified instead of \fP or \s0, such practice produces complaints from checknr.  If the user intends to run checknr, the \fP and \s0 delimiting conventions should be used.

There is no way to define a single-character macro name using −a. 

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). 

INTERNATIONAL SUPPORT

8-bit file names. 

Hewlett-Packard Company  —  May 11, 2021