Here are some notes and editorial fixes for the manual.
The patch is in the attachment.
-.-
The difference between the formatted outputs can be seen with:
nroff -man <file1> > <out1>
nroff -man <file2> > <out2>
diff -u <out1> <out2>
and for groff, using
"printf '%s\n%s\n' '.kern 0' '.ss 12 0' | groff -man -Z - "
instead of "nroff -man"
Add the option "-t", if the file contains a table.
Read the output of "diff -u" with "less -R" or similar.
-.-.
If "man" (man-db) is used to check the manual for warnings,
the following must be set:
The option "-warnings=w"
The environmental variable:
export MAN_KEEP_STDERR=yes (or any non-empty value)
or
(produce only warnings):
export MANROFFOPT="-ww -z"
export MAN_KEEP_STDERR=yes (or any non-empty value)
-.-.
Output from "mandoc -T lint grep.in.1": (possibly shortened list)
mandoc: grep.in.1:27:9: WARNING: undefined string, using "": la
The fix to eliminate this warning is to add explicitly an empty string to
its value:
.as la ""
A similar method can be used for undefined registers:
.nr a +0
The groff's 'an-ext.tmac' does not define the string 'la',
just the character.
-.-.
Use the correct macro for the font change of a single argument or
split the argument into two.
248:.IR FILE
677:.BR \-I
-.-.
Change a HYPHEN-MINUS (code 0x2D) to a minus(-dash) (\-),
if it
is in front of a name for an option,
is a symbol for standard input,
is a single character used to indicate an option,
or is in the NAME section (man-pages(7)).
N.B. - (0x2D), processed as a UTF-8 file, is changed to a hyphen
(0x2010, groff \[u2010] or \[hy]) in the output.
752:.B sort -z
-.-.
Output from "groff -b -mandoc -dAD=l -rF0 -rHY=0 -t -w w -z -rCHECKSTYLE=0":
troff: backtrace: file '<stdin>':26
troff:<stdin>:26: warning: macro 'la' not defined
--- grep.in.1 2024-05-21 01:34:19.228927615 +0000
+++ grep.in.1.new 2024-05-21 01:32:13.506930462 +0000
@@ -23,6 +23,7 @@
. \}
.\}
.
+.as la \" add an empty string to avoid a warning
.if !\w|\*(la| \{\
.\" groff an-ext.tmac does not seem to be in use, so define the parts of
.\" it that are used below. For a copy of groff an-ext.tmac, please see:
@@ -245,7 +246,7 @@ If this option is used multiple times or
option, search for all patterns given.
The empty file contains zero patterns, and therefore matches nothing.
If
-.IR FILE
+.I FILE
is
.B \-
, read patterns from standard input.
@@ -674,7 +675,7 @@ whose base name matches
Ignore any redundant trailing slashes in
.IR GLOB .
.TP
-.BR \-I
+.B \-I
Process a binary file as if it did not contain matching data; this is
equivalent to the
.B \-\^\-binary\-files=without\-match
@@ -749,7 +750,7 @@ Like the
or
.B \-\^\-null
option, this option can be used with commands like
-.B sort -z
+.B sort \-z
to process arbitrary file names.
.
.SH "REGULAR EXPRESSIONS"
