On Thu, 21 Mar 2024 at 03:27, Faidon Liambotis <parav...@debian.org> wrote: > In trixie and above, including tables in a manpage does not work > anymore, unless the "tbl" preprocessor is added explicitly. [...]
I'm not aware of a change to help2man which would have affected this, so I'm assuming that it is a man/groff change. > help2man does not output any tables by default (AIUI) but in case one > adds text e.g. in their DESCRIPTION that includes tables, it won't work. help2man is intended to take `--help` output and massage it into a manual page. The `--help` output still needs to be readable however, since people do invoke `foo --help` from the command line. One option would be to have help2man recognize markdown-format tables, which would preserve the property of the `--help` output being readable. A simpler option would be to add the table to an include file: https://www.gnu.org/software/help2man/#Including-text > While my issue is specific to the "tbl" preprocessor, man(1) supports > other preprocessors, including eqn (e), grap (g), pic (p), tbl (t), > vgrind (v), refer (r). See the `-p` argument. Perhaps help2man should > just gain an argument to support adding arbitrary preprocessors to its > output? I will look into that. --bod
