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

Package:
e2fsprogs
Source:
e2fsprogs
Description:
ext2/ext3/ext4 file system utilities
Submitter:
Bjarni Ingi Gislason
Date:
2025-12-06 20:13:02 UTC
Severity:
normal
Tags:
#1098816#5
Date:
2025-02-24 18:01:47 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?


an.tmac:<stdin>:285: misuse, warning: .BR is for at least 2 arguments, got 1
	Use macro '.B' for one argument or split argument.
an.tmac:<stdin>:372: warning: cannot nest .TP or .TQ inside .TP; supply a tag


   * What outcome did you expect instead?

     No output (no warnings).

-.-

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

#1098816#10
Date:
2025-12-06 19:48:39 UTC
From:
To:
Since bug #1098816 is about mke2fs.8 manual page, I want to raise the following
minor issues, that are not tied to what the bug is about so far.
Qouting mke2fs.8

           -c     Check the device for bad blocks before creating the file system.  If this option is speci‐
              fied twice, then a slower read-write test is used instead of a fast read-only test.

In my opinion, specifying this option twice is not suggsted by the synopsis. I
propose the following patch.