Run mandoc lint checker on man pages (#22)

BUILD.md

@@ -20,13 +20,26 @@ Installation that overwrites config files and translation tables:
 
 Install `mandoc` to generate fresh PDFs.
 
+## Formatting
+
+Check code:
+
+```
+astyle --style=kr --indent-switches --add-braces --pad-oper --pad-header $(ls src/*.[ch] | egrep -v 'config_file_(lex|yacc)')`
+```
+
+Check docs:
+
+```
+mandoc -T lint man/*.[15]
+```
+
 ## Testing
 
 1. Run static analysis tools. (sparse, cppcheck)
-2. Run `astyle --style=kr --indent-switches --add-braces --pad-oper --pad-header $(ls src/*.[ch] | egrep -v 'config_file_(lex|yacc)')`
-3. Run `make clean ; make` to rebuild `detox`.
-4. Run `tests/test.sh src/detox` to perform basic regression tests.
-5. Run custom external regression tests.
+2. Run `make clean ; make` to rebuild `detox`.
+3. Run `tests/test.sh src/detox` to perform basic regression tests.
+4. Run custom external regression tests.
 
 ## Release
 

man/detox.1

@@ -124,12 +124,12 @@ showing their filters and options.
 .El
 .Sh SEE ALSO
 .Xr inline-detox 1 ,
-.Xr detoxrc 5 ,
 .Xr detox.tbl 5 ,
+.Xr detoxrc 5 ,
 .Xr ascii 7 ,
 .Xr iso_8859-1 7 ,
 .Xr unicode 7 ,
-.Xr utf-8 7 .
+.Xr utf-8 7
 .Sh HISTORY
 .Nm
 was originally designed to clean up files that I had received from

man/detox.tbl.5

@@ -41,7 +41,7 @@ same rules that apply to sscanf apply here.
 Translation can be a string or a quoted string, with either single or
 double quotes.
 .El
-.Sh EXAMPLE
+.Sh EXAMPLES
 The following example shows a portion of a
 .Ar safe
 table, with only a few character replacements specified.
@@ -115,7 +115,7 @@ for more details on the various filter types.
 .Xr ascii 7 ,
 .Xr iso_8859-1 7 ,
 .Xr unicode 7 ,
-.Xr utf-8 7 .
+.Xr utf-8 7
 .Sh AUTHORS
 detox was written by
 .An "Doug Harple" .

man/detoxrc.5

@@ -155,7 +155,7 @@ on ASCII characters.
 .It Cm # comments
 Any thing after a # on any line is ignored.
 .El
-.Sh EXAMPLE
+.Sh EXAMPLES
 .Bd -literal
 sequence default {
   uncgi;
@@ -186,20 +186,17 @@ or creating a copy of
 and updating your
 .Pa detoxrc
 file.
-.Pp
 .Ss Rules that apply anywhere in the filename:
 .Bl -column -offset indent ".Sy Removed" ".Sy Original"
 .It Sy Safe Ta Sy Original
 .It _and_ Ta &
 .It _ Ta \fIspace\fR ` \&! @ $ * \e | \&: \&; \&" ' < > \&? /
 .It - Ta \&( \&) \&[ \&] { }
 .El
-.Pp
 .Sh WIPEUP
 The following characters are translated by the
 .Ar wipeup
 filter.
-.Pp
 .Ss Rules that apply anywhere in the filename:
 .Bl -column -offset indent ".Sy Wipeup" ".Sy Original"
 .It Sy Wipeup Ta Sy Original
@@ -208,7 +205,6 @@ filter.
 .It - Ta --
 .It _ Ta __
 .El
-.Pp
 .Ss Rules that apply only at the beginning of a filename:
 Any leading dashes are stripped to prevent programs from interpreting
 these files as command line options.
@@ -224,7 +220,6 @@ these files as command line options.
 .It . Ta ._
 .It . Ta _.
 .El
-.Pp
 .Sh SEE ALSO
 .Xr detox 1 ,
 .Xr inline-detox 1 ,
@@ -233,7 +228,7 @@ these files as command line options.
 .Xr cp1252 7 ,
 .Xr iso_8859-1 7 ,
 .Xr unicode 7 ,
-.Xr utf-8 7 .
+.Xr utf-8 7
 .Sh AUTHORS
 detox was written by
 .An "Doug Harple" .

man/inline-detox.1

@@ -117,12 +117,12 @@ listing any changes and returning the result to the output stream.
 .El
 .Sh SEE ALSO
 .Xr detox 1 ,
-.Xr detoxrc 5 ,
 .Xr detox.tbl 5 ,
+.Xr detoxrc 5 ,
 .Xr ascii 7 ,
 .Xr iso_8859-1 7 ,
 .Xr unicode 7 ,
-.Xr utf-8 7 .
+.Xr utf-8 7
 .Sh HISTORY
 .Nm
 was originally designed to clean up files that I had received from