Menu

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

None
closed-fixed
nobody
manpage (2)
5
2024-05-16
2023-07-29
No

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

1 Attachments

Discussion

  • 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

    • status: open --> closed-fixed
     
  • engelbert gruber

    already applied in prior version

     

Log in to post a comment.

Want the latest updates on software, tech news, and AI?
Get latest updates about software, tech news, and AI from SourceForge directly in your inbox once a month.