ld.bfd.1: Some remarks and a patch with editorial changes for this man page

[Jan Beulich]

On 28.10.2025 03:02, Bjarni Ingi Gislason wrote:
> Package: binutils-common
> Version: 2.45-8

There's no such thing in upstream binutils; this is a distro version. You want
to report issues against the upstream versions here.

> Severity: minor
> Tags: patch
> 
>    * 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 ":
> 
> troff:<stdin>:322: warning: trailing space in the line
> troff:<stdin>:327: warning: trailing space in the line
> troff:<stdin>:2557: warning: trailing space in the line
> troff:<stdin>:2558: warning: trailing space in the line
> troff:<stdin>:2559: warning: trailing space in the line
> troff:<stdin>:2560: warning: trailing space in the line
> troff:<stdin>:2561: warning: trailing space in the line
> troff:<stdin>:2562: warning: trailing space in the line
> troff:<stdin>:2563: warning: trailing space in the line
> troff:<stdin>:2564: warning: trailing space in the line
> troff:<stdin>:2565: warning: trailing space in the line
> troff:<stdin>:2968: warning: trailing space in the line
> 
>    * What outcome did you expect instead?
> 
>      No output (no warnings).

>From this, how does one know which file(s) you checked?

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

ld.bfd.1.diff contains differences of a generated file. That's not very
useful; it first of all would need to be the original source file
(ld/ld.texi) which is adjusted (if there's any need). It may of course
also be that what you observe is a result of the tools used to produce
that generated file. Then you would want to send patches against those
tools (unless simply using a newer tool version would already suffice),
to whatever the appropriate project is.

Jan