On Fri, 14 Mar 2025 at 19:35, Bjarni Ingi Gislason <[email protected]> wrote:
> Package: grub-common
> Version: 2.12-5
> Severity: minor
> Tags: upstream
>
>    * 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"
>    * What was the outcome of this action?
>
> troff:<stdin>:9: warning: invalid input character code 11

This appears to be a grub bug.  A "\v" is included at the start of the
doc string: 
https://git.savannah.gnu.org/cgit/grub.git/tree/util/grub-mknetdir.c#n88

Argp uses this as a delimiter in the doc string to include
documentation before and after the options:
https://www.gnu.org/software/libc/manual/html_node/Argp-Parsers.html

I don't believe that Argp handles the case where the leading section
is empty (i.e. a leading "\v").  Not sure if it's intended to, but it
doesn't: the text is repeated both before and after the options, and
the "\v" character is retained in the first instance.  See the output
for grub-mknetdir --help, which contains the text twice, and with the
escape and some odd wrapping in the first case:

  Usage: grub-mknetdir [OPTION...]
  ^KPrepares
  GRUB network boot images at net_directory/subdir assuming net_directory being
  TFTP root.

  [...options elided...]
  Mandatory or optional arguments to long options are also mandatory or optional
  for any corresponding short options.

  Prepares GRUB network boot images at net_directory/subdir assuming
  net_directory being TFTP root.

  Report bugs to <[email protected]>.

My guess would be that the intended output would include the summary
at the top, so the "\v" should be removed entirely.

--bod

Reply via email to