#1095861 magic.5: Some remarks and a patch with editorial changes for this man page

Package:
file
Source:
file
Description:
Recognize the type of data in a file using "magic" numbers
Submitter:
Bjarni Ingi Gislason
Date:
2025-02-13 04:15:02 UTC
Severity:
normal
Tags:
#1095861#5
Date:
2025-02-13 04:12:21 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?


troff:<stdin>:71: warning: trailing space in the line
troff:<stdin>:451: warning: name 'doc-list-type-stack0' not defined
doc.tmac:<stdin>:451: error: .It without preceding .Bl
troff:<stdin>:451: warning: register 'doc--type' not defined
troff:<stdin>:451: warning: name 'doc-' not defined (possibly missing space after 'do')
doc.tmac:<stdin>:527: error: .It without preceding .Bl
troff:<stdin>:527: warning: name 'doc-' not defined (possibly missing space after 'do')
troff:<stdin>:538: warning: register 'doc-list-indent-stack0' not defined
troff:<stdin>:538: warning: register 'doc-list-offset-stack0' not defined
doc.tmac:<stdin>:538: warning: extraneous .El call
troff:<stdin>:654: warning: tab character in unquoted macro argument
troff:<stdin>:654: warning: tab character in unquoted macro argument
troff:<stdin>:654: warning: tab character in unquoted macro argument
troff:<stdin>:655: warning: tab character in unquoted macro argument
troff:<stdin>:656: warning: tab character in unquoted macro argument
troff:<stdin>:657: warning: tab character in unquoted macro argument
troff:<stdin>:658: warning: tab character in unquoted macro argument
troff:<stdin>:659: warning: tab character in unquoted macro argument
troff:<stdin>:660: warning: tab character in unquoted macro argument
troff:<stdin>:661: warning: tab character in unquoted macro argument
troff:<stdin>:662: warning: tab character in unquoted macro argument
troff:<stdin>:663: warning: tab character in unquoted macro argument
troff:<stdin>:664: warning: tab character in unquoted macro argument
troff:<stdin>:665: warning: tab character in unquoted macro argument


   * What outcome did you expect instead?

     No output (no warnings).

-.-

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