#1120078 luaotfload.conf.5: Some remarks and a patch with editorial changes for this man page

#1120078#5
Date:
2025-11-04 21:05:14 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 ":

troff:<stdin>:458: warning: [page 3, 10.0i (diversion '3tbd4,2', 0.0i)]: cannot adjust line in b adjust mode; overset by 4.3304n

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

troff:<stdin>:450: warning [page 1, line 225, diversion '3tbd3,2', line 1]: cannot break line in l adjust mode; overset by 2n
troff:<stdin>:458: warning [page 1, line 225, diversion '3tbd4,2', line 1]: cannot break line in l adjust mode; overset by 7n
troff:<stdin>:498: warning [page 1, line 247, diversion '3tbd2,2', line 1]: cannot break line in l adjust mode; overset by 3n


   * What outcome did you expect instead?

     No output (no warnings).

-.-

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

#1120078#10
Date:
2025-11-09 22:41:05 UTC
From:
To:
On 11/4/2025 10:05 PM, Bjarni Ingi Gislason wrote:

Hello Bjarni,

If you see this:

<snip>
root@rasppi3:~# zless /usr/share/man/man5/luaotfload.conf.5.gz|head -n 5
.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
<snip>

inside the source code of the manual page, it does not make sense to
patch the manual page. In this case either the rst (source) file is
broken or the converter. Please check if the conversion from the latest
rst file [1] using the rst2man from python3-docutils still generates the
same broken page. If yes, the issue probably goes to python3-docutils.

For now I remove the patch tag.

Hilmar

[1] https://github.com/latex3/luaotfload/blob/main/doc/luaotfload.conf.rst

#1120078#17
Date:
2025-11-17 08:20:37 UTC
From:
To:
On 11/4/2025 10:05 PM, Bjarni Ingi Gislason wrote:

Hello Bjarni,

If you see this:

<snip>
root@rasppi3:~# zless /usr/share/man/man5/luaotfload.conf.5.gz|head -n 5
.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
<snip>

inside the source code of the manual page, it does not make sense to
patch the manual page. In this case either the rst (source) file is
broken or the converter. Please check if the conversion from the latest
rst file [1] using the rst2man from python3-docutils still generates the
same broken page. If yes, the issue probably goes to python3-docutils.

For now I remove the patch tag.

Hilmar

[1] https://github.com/latex3/luaotfload/blob/main/doc/luaotfload.conf.rst