Docutils manpage writer currently uses .ft C
, but this causes warnings from groff ≥ 1.23.0.
Please see the downstream bug https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1041809 for a discussion about this issue with many references.
The attached patch, based on the original patch from G. Branden Robinson, fixes the warnings and makes the manpage writer use .EX
and .EE
instead, which are documented here:
Begin and end example. After .EX, filling is disabled and a constant-width (monospaced) font is selected. Calling .EE enables filling and restores the previous font.
So this should be equivalent to the previous code (.nf
/.fi
was for the filling, .ft C
/.ft P
was for the font).
Hi Dmitry,
I was able to confirm that the second version of my patch to fix this did not regress any of the inputs in
sandbox/manpage-writer/input
.In my opinion it would thus be better to use the
P
macro than thesp
request.In other happy news, I see that the claim in
sandbox/manpage-writer/input/indent.txt
that part of the example isn't indented correctly is not true. Maybe it got fixed without someone noticing. I'm preparing a patch to remove the false claim.patch applied , happy news considered :-)
cheers
Thanks, Engelbert! I started revising the examples extensively and didn't reach a proper stopping point before switching tasks to something else. I hope to have something more for you in the near future.
if you send some pointers to places using the manpage-writer i could test too ... OTOH i check my linux systems packages
already applied in prior version