#1120415 Xserver.1: Some remarks and a patch with editorial changes for this man page

Package:
xserver-common
Source:
xserver-common
Submitter:
Bjarni Ingi Gislason
Date:
2025-11-09 01:59:02 UTC
Severity:
normal
Tags:
#1120415#5
Date:
2025-11-09 01:57:41 UTC
From:
To:
From "/usr/share/doc/debian/bug-reporting.txt.gz":

  Don't file bugs upstream

   If you file a bug in Debian, don't send a copy to the upstream software
   maintainers yourself, as it is possible that the bug exists only in
   Debian. If necessary, the maintainer of the package will forward the
   bug upstream.

-.-

  I do not send reports upstream if I have to get an account there.
The Debian maintainers have one already.

  If I get a negative (or no) response from upstream, I send henceforth
bugs to Debian.

-.-

   * 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=0 -ww -z < "man page"

  [Use

grep -n -e ' $' -e '\\~$' -e ' \\f.$' -e ' \\"' <file>

  to find (most) 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=0 -ww -z ":

an.tmac:<stdin>:104: misuse, warning: .BI is for at least 2 arguments, got 1
	Use macro '.B' for one argument or split the argument.
troff:<stdin>:117: warning: ignoring escape character before '+'
troff:<stdin>:174: warning: cannot select font 'F'
troff:<stdin>:525: warning: [page 6, 9.3i]: cannot adjust line in b adjust mode; overset by 91.563n

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

an.tmac:<stdin>:104: misuse, warning: .BI is for at least 2 arguments, got 1
	Use macro '.B' for one argument or split the argument.
troff:<stdin>:117: warning: ignoring escape character before '+'
troff:<stdin>:174: warning: cannot select font 'F'
troff:<stdin>:525: warning [page 1, line 464]: cannot break line in l adjust mode; overset by 144n
troff:<stdin>:571: warning [page 1, line 509, diversion 'an*paragraph-tag', line 1]: cannot break line in l adjust mode; overset by 5n


   * What outcome did you expect instead?

     No output (no warnings).

-.-

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