unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 checknr(1)							  checknr(1)




 NAME
      checknr - check nroff/troff files

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

 DESCRIPTION
      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
      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
    International Code Set Support
      Single-byte character code sets are supported.

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




 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 checknr(1)							  checknr(1)




 EXAMPLES
      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
      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
      checknr was developed by the University of California, Berkeley.

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



























 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000