Package: jq
Version: 1.6-2.1
Severity: normal

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
> l l.
2177a2179
> l l.
2183a2186
> l l.
2187a2191
> l l.
2193a2198
> l l l.

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

-- System Information:
Debian Release: bullseye/sid
  APT prefers testing
  APT policy: (900, 'testing')
Architecture: amd64 (x86_64)

Kernel: Linux 5.10.0-1-amd64 (SMP w/4 CPU threads)
Locale: LANG=fr_FR.utf8, LC_CTYPE=fr_FR.utf8 (charmap=UTF-8), LANGUAGE not set
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages jq depends on:
ii  libc6   2.31-9
ii  libjq1  1.6-2.1

jq recommends no packages.

jq suggests no packages.

-- no debconf information

Reply via email to