1checknr(1)                       User Commands                      checknr(1)
2
3
4

NAME

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

SYNOPSIS

9       checknr [-fs] [-a . x1 . y1 . x2 . y2 ... .xn .yn]
10            [-c . x1 . x2 . x3 ... .xn] [filename]...
11
12

DESCRIPTION

14       checknr  checks  a list of nroff(1) or troff(1) input files for certain
15       kinds of errors involving mismatched opening and closing delimiters and
16       unknown  commands.  If no files are specified, checknr checks the stan‐
17       dard input. Delimiters checked are:
18
19           o      Font changes using \fx ... \fP.
20
21           o      Size changes using \sx ... \s0.
22
23           o      Macros that come in open ... close forms, for  example,  the
24                  .TS and .TE macros which must always come in pairs.
25
26
27       checknr knows about the ms(5) and me(5) macro packages.
28
29
30       checknr  is  intended  to  be  used on documents that are prepared with
31       checknr in mind.  It expects a certain document writing  style  for  \f
32       and  \s commands, in that each \fx must be terminated with \fP and each
33       \sx must be terminated with \s0. While it will work to directly go into
34       the  next  font  or explicitly specify the original font or point size,
35       and many existing documents actually do this, such a practice will pro‐
36       duce  complaints  from  checknr. Since it is probably better to use the
37       \fP and \s0 forms anyway, you should think of this as a contribution to
38       your document preparation style.
39

OPTIONS

41       -f                      Ignore \f font changes.
42
43
44       -s                      Ignore \s size changes.
45
46
47       -a .x1 .y1...           Add  pairs  of macros to the list. The pairs of
48                               macros are assumed to be those (such as .DS and
49                               .DE)  that  should be checked for balance.  The
50                               -a option must be followed  by  groups  of  six
51                               characters,  each  group  defining  a  pair  of
52                               macros. The six characters are  a  period,  the
53                               first  macro name, another period, and the sec‐
54                               ond macro name. For example, to define  a  pair
55                               .BS and .ES, use `-a.BS.ES'
56
57
58       -c .x1...               Define  commands  which checknr would otherwise
59                               complain about as undefined.
60
61

ATTRIBUTES

63       See attributes(5) for descriptions of the following attributes:
64
65
66
67
68       ┌─────────────────────────────┬─────────────────────────────┐
69       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
70       ├─────────────────────────────┼─────────────────────────────┤
71       │Availability                 │SUNWdoc                      │
72       └─────────────────────────────┴─────────────────────────────┘
73

SEE ALSO

75       eqn(1), nroff(1), troff(1), attributes(5), me(5), ms(5)
76

BUGS

78       There is no way to define a  one-character  macro  name  using  the  -a
79       option.
80
81
82
83SunOS 5.11                        14 Sep 1992                       checknr(1)