#981356 jq: the manpage table definitions are broken

Package:
jq
Source:
jq
Description:
lightweight and flexible command-line JSON processor
Submitter:
Marc Chantreux
Date:
2021-01-29 20:54:03 UTC
Severity:
normal
#981356#5
Date:
2021-01-29 20:43:32 UTC
From:
To:
Dear Maintainer,

i read the jq manpage to a vim buffer (:r !man jq) to test examples
and realized i got those errors:

   Optional Object Idtbl:<standard input>:2170: unrecognised format 'T'
tbl:<standard input>:2170: giving up on this table
tbl:<standard input>:2178: unrecognised format '\'
tbl:<standard input>:2178: giving up on this table
tbl:<standard input>:2184: unrecognised format 'o'
tbl:<standard input>:2184: giving up on this table
tbl:<standard input>:2188: unrecognised format '('
tbl:<standard input>:2188: giving up on this table
tbl:<standard input>:2194: unrecognised format '('
tbl:<standard input>:2194: giving up on this table

so tables are not rendered. this is because all the table headers are
missing. example

    .TS
    allbox;
    This example should show the difference between \'=\' and \'	=\':
    .TE

should be

    .TS
    allbox;
    l l.
    This example should show the difference between \'=\' and \'	=\':
    .TE

so i wrote a patch

2169a2170
2177a2179
2183a2186
2187a2191
2193a2198

in general, the manpage quality is very poor and broken patterns appears
regulary so i suspect it was generated from a tool the authors should
avoid.

i'll be happy to help writting a decent manpage (maybe using mandoc?).

regards
marc