#205 [manpage] Change macros for literal block to avoid warnings from groff 1.23

[Dmitry Shachnev]

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).

[G. Branden Robinson]

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 the sp 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.

[engelbert gruber]

patch applied , happy news considered :-)
cheers

[G. Branden Robinson]

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.

[engelbert gruber]

if you send some pointers to places using the manpage-writer i could test too ... OTOH i check my linux systems packages

[engelbert gruber]

already applied in prior version