|
|
1.1 ! root 1: .TH CHECKNR 1 4/5/80 ! 2: .UC 4 ! 3: .SH NAME ! 4: checknr \- check nroff/troff files ! 5: .SH SYNOPSIS ! 6: .B checknr ! 7: [ ! 8: .B \-s ! 9: ] [ ! 10: .B \-f ! 11: ] [ ! 12: .BR \-a ".x1.y1.x2.y2. ... .xn.yn" ! 13: ] [ ! 14: .BR \-c ".x1.x2.x3 ... .xn" ! 15: ] ! 16: \fIfile\fP ... ! 17: .SH DESCRIPTION ! 18: .I Checknr ! 19: checks a list of ! 20: .IR nroff (1) ! 21: or ! 22: .IR troff (1) ! 23: input files for certain kinds of errors ! 24: involving mismatched opening and closing delimiters ! 25: and unknown commands. ! 26: Delimeters checked are: ! 27: .IP (1) ! 28: Font changes using \efx ... \efP. ! 29: .IP (2) ! 30: Size changes using \esx ... \es0. ! 31: .IP (3) ! 32: Macros that come in open ... close forms, for example, ! 33: the .TS and .TE macros which must always come in pairs. ! 34: .PP ! 35: .I Checknr ! 36: knows about the ! 37: .IR ms (7) ! 38: and ! 39: .IR me (7) ! 40: macro packages. ! 41: .PP ! 42: Additional pairs of macros can be added to the list using the ! 43: .B \-a ! 44: option. ! 45: This must be followed by groups of six characters, each group defining ! 46: a pair of macros. ! 47: The six characters are ! 48: a period, ! 49: the first macro name, ! 50: another period, ! 51: and the second macro name. ! 52: For example, to define a pair .BS and .ES, use \-\fBa\fP.BS.ES ! 53: .PP ! 54: The ! 55: .B \-c ! 56: option defines commands which would otherwise be complained about ! 57: as undefined. ! 58: .PP ! 59: The ! 60: .B \-f ! 61: option requests ! 62: .I checknr ! 63: to ignore \ef font changes. ! 64: .PP ! 65: The ! 66: .B \-s ! 67: option requests ! 68: .I checknr ! 69: to ignore \es size changes. ! 70: .PP ! 71: .I Checknr ! 72: is intended to be used on documents that are prepared with ! 73: .I checknr ! 74: in mind, much the same as ! 75: .I lint. ! 76: It expects a certain document writing style for \ef and \es commands, ! 77: in that each \efx must be terminated with \efP and ! 78: each \esx must be terminated with \es0. ! 79: While it will work to directly go into the next font or explicitly ! 80: specify the original font or point size, ! 81: and many existing documents actually do this, ! 82: such a practice will produce complaints from ! 83: .I checknr. ! 84: Since it is probably better to use the \efP and \es0 forms anyway, ! 85: you should think of this as a contribution to your document ! 86: preparation style. ! 87: .SH SEE\ ALSO ! 88: nroff(1), troff(1), ms(7), me(7), checkeqn(1) ! 89: .SH DIAGNOSTICS ! 90: Complaints about unmatched delimiters. ! 91: .br ! 92: Complaints about unrecognized commands. ! 93: .br ! 94: Various complaints about the syntax of commands. ! 95: .SH AUTHOR ! 96: Mark Horton ! 97: .SH BUGS ! 98: There is no way to define a 1 character macro name using ! 99: .B \-a
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.