bug#71087: grep.in.1: some remarks and editorial changes for this man page

[Bjarni Ingi Gislason]

  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.diff
Description: Text Data