On Tue, Nov 12, 2024 at 11:29:37PM +0100, Agustin Martin wrote: > On Tue, Nov 12, 2024 at 12:40:22AM +0000, Bjarni Ingi Gislason wrote: > > Package: dictionaries-common > > Version: 1.30.1 > > Severity: minor > > > > * What led up to the situation? > > > > Checking for defects with > > > > test-[g|n]roff -mandoc -t -K utf8 -rF0 -rHY=0 -ww -b -z < "man page" > > > > [Use "groff -e ' $' <file>" to find 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: backtrace: '<stdin>':11: macro 'Vb' > > troff: backtrace: file '<stdin>':67 > > troff:<stdin>:67: warning: font name 'CW' is deprecated > > Hi, thanks for the feedback. > > In this case, I have to remark that these groff code is generated from perl > pod code by pod2man, not written directly, so there is little to do from > dictionaries-common package. I am happy to hear about patches for the > original perl pod code of this script (and other similar scripts in > dictionaries-common), but in general I tend to think this as a pod2man > issue.
Hi, I have looked more carefully at this and there is something I think can be improved from the dictionaries-common pod side: - Starting new sentences in a new line when possible (in some corner cases of fixed format text that is ugly and I prefer not to do that). - Starting parenthetical sentences in a new line seems OK. Hope this will propagate to roff code and improve spacing, dealing with the issues you point out. The issue about long lines in *roff code is IMHO not relevant since what is important is length in original pod code, which is the source. I have tried to keep lines not too long in original pod code, this is what should be important for easier maintenance. Other issues belong to pod2man, like the already reported > https://bugs.debian.org/1041070 > [perl: pod2man uses CW, groff-base no longer supports this by default] as well as IMHO * Add a zero (0) in front of a decimal fraction that begins with a period * Change '-' (\-) to '\(en' (en-dash) for a numeric range. I suggest to open a separate bug report against perl package (where pod2man belongs) with a minimal example of pod source that triggers this problem. Expect an upload with above changes soon. Thanks for your feedback. Regards, -- Agustin
