#1098663 dmsetup.8: Some remarks and a patch with editorial changes for this man page

Package:
dmsetup
Source:
dmsetup
Description:
Linux Kernel Device Mapper userspace library
Submitter:
Bjarni Ingi Gislason
Date:
2025-02-22 11:15:02 UTC
Severity:
normal
Tags:
#1098663#5
Date:
2025-02-22 11:11:37 UTC
From:
To:
   * What led up to the situation?

     Checking for defects with a new version

test-[g|n]roff -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=10 -ww -z < "man page"

  [Use "groff -e ' $' -e '\\~$' <file>" to find obvious trailing spaces.]

  ["test-groff" is a script in the repository for "groff"; is not shipped]
(local copy and "troff" slightly changed by me).

  [The fate of "test-nroff" was decided in groff bug #55941.]

   * What was the outcome of this action?

Output from "test-groff  -mandoc -t -K utf8 -rF0 -rHY=0 -rCHECKSTYLE=10 -ww -z ":

an.tmac:<stdin>:11: style: use of deprecated macro: .PD
an.tmac:<stdin>:37: misuse, warning: .BR is for at least 2 arguments, got 1
	Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:37: misuse, warning: .IR is for at least 2 arguments, got 1
	Use macro '.I' for one argument or split argument.
an.tmac:<stdin>:408: style: use of deprecated macro: .PD
an.tmac:<stdin>:614: misuse, warning: .BR is for at least 2 arguments, got 1
	Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:614: misuse, warning: .IR is for at least 2 arguments, got 1
	Use macro '.I' for one argument or split argument.
an.tmac:<stdin>:656: style: 1 leading space(s) on input line
an.tmac:<stdin>:657: style: 1 leading space(s) on input line
an.tmac:<stdin>:658: style: 1 leading space(s) on input line
an.tmac:<stdin>:659: style: 1 leading space(s) on input line
an.tmac:<stdin>:660: style: 1 leading space(s) on input line
an.tmac:<stdin>:661: style: 1 leading space(s) on input line
an.tmac:<stdin>:662: style: 1 leading space(s) on input line
an.tmac:<stdin>:950: style: 1 leading space(s) on input line
an.tmac:<stdin>:951: style: 1 leading space(s) on input line
an.tmac:<stdin>:952: style: 1 leading space(s) on input line
an.tmac:<stdin>:953: style: 1 leading space(s) on input line
an.tmac:<stdin>:954: style: 1 leading space(s) on input line
an.tmac:<stdin>:1062: style: use of deprecated macro: .PD
an.tmac:<stdin>:1074: style: use of deprecated macro: .PD


   * What outcome did you expect instead?

     No output (no warnings).

-.-

  General remarks and further material, if a diff-file exist, are in the
attachments.