unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-4.1.3)
Page:
Section:
Apropos / Subsearch:
optional field

CHECKNR(1)                  General Commands Manual                 CHECKNR(1)



NAME
       checknr - check nroff and troff input files; report possible errors

SYNOPSIS
       checknr [ -fs ] [ -a .x1 .y1 .x2 .y2 ...  .xn .yn ]
            [ -c .x1 .x2 .x3 ...  .xn ] [ filename ...  ]

AVAILABILITY
       This  command  is available with the Text software installation option.
       Refer to for information on how to install optional software.

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  stan-
       dard input.  Delimiters checked are:

              o  Font changes using \fx ... \fP.

              o  Size changes using \sx ... \s0.

              o  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(7) and me(7) macro packages.

       checknr is intended to be used on  documents  that  are  prepared  with
       checknr  in  mind.   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 contri-
       bution to your document preparation style.

OPTIONS
       -f     Ignore \f font changes.

       -s     Ignore \s size changes.

       -a .x1 .y1...
              Add pairs of macros to  the  list.   The  pairs  of  macros  are
              assumed to be those (such as .DS and .DE) that should be checked
              for balance.  The -a option must be followed by  groups  of  six
              characters, each group defining a pair of macros.  The six char-
              acters 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 .x1...
              Define commands which checknr would otherwise complain about  as
              undefined.

SEE ALSO
       eqn(1), nroff(1), troff(1), me(7), ms(7)

BUGS
       There  is  no  way  to  define  a one-character macro name using the -a
       option.



                               22 December 1987                     CHECKNR(1)