


      CHECKNR(1)		    (DWB)		     CHECKNR(1)



      NAME
	   checknr - check nroff/troff files

      SYNTAX
	   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(1) 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, for example,
		the .TS	and .TE	macros which must always come in pairs.

	   Checknr knows about the ms(5) and me(5) 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

	   -c	defines	commands which would otherwise be complained
		about as undefined.

	   -f	requests checknr to ignore \f font changes.

	   -s	requests checknr to ignore \s size changes.

	   Checknr is intended to be used on documents that are
	   prepared with checknr in mind, much the same	as lint. It
	   expects a certain document writing style for	\f and \s
	   commands, in	that each \fx must be terminated with \fP and
	   each	\sx must be terminated with \s0.  While	it will	work to
	   directly go into the	next font or explicitly	specify	the
	   original font or point size,	and many existing documents
	   actually do this, such a practice will produce complaints
	   from	checknr. Since it is probably better to	use the	\fP and
	   \s0 forms anyway, you should	think of this as a contribution
	   to your document preparation	style.

      SEE ALSO
	   nroff(1), troff(1), ms(5), me(5)
	   In ROS Reference Manual, checkeq(1).



      Page 1					      (73 A2 02MT REV1)






      CHECKNR(1)		    (DWB)		     CHECKNR(1)



      DIAGNOSTICS
	   Complaints about unmatched delimiters.
	   Complaints about unrecognized commands.
	   Various complaints about the	syntax of commands.

      BUGS
	   There is no way to define a one-character macro name	using
	   -a.
	   Does	not correctly recognize	certain	reasonable constructs,
	   such	as conditionals.













































      Page 2					      (73 A2 02MT REV1)



