[Python-apps-team] Bug#933909: subdownloader: CLI broken

[Mattia Rizzolo]

On Mon, Aug 05, 2019 at 03:27:29AM +0200, Jan Braun wrote:
> P.P.S.: The manpage is missing a leading "-" for all the options at the
>     start of a line.

I found what is causing this.  Lintian also warns about the manpage:
W: subdownloader: manpage-has-errors-from-man usr/share/man/man1/subdownloader.1.gz 53: a special character is not allowed in a name

And checking more thoroughly manually:
troff: <standard input>:53: a special character is not allowed in a name
troff: <standard input>:56: a special character is not allowed in a name
troff: <standard input>:59: a special character is not allowed in a name
troff: <standard input>:62: a special character is not allowed in a name
troff: <standard input>:69: a special character is not allowed in a name
troff: <standard input>:72: a special character is not allowed in a name
troff: <standard input>:79: a special character is not allowed in a name
troff: <standard input>:82: a special character is not allowed in a name
troff: <standard input>:85: a special character is not allowed in a name
troff: <standard input>:88: a special character is not allowed in a name
troff: <standard input>:91: a special character is not allowed in a name
troff: <standard input>:98: a special character is not allowed in a name
troff: <standard input>:101: a special character is not allowed in a name
troff: <standard input>:104: a special character is not allowed in a name
troff: <standard input>:107: a special character is not allowed in a name
troff: <standard input>:110: a special character is not allowed in a name
troff: <standard input>:113: a special character is not allowed in a name
troff: <standard input>:116: a special character is not allowed in a name
troff: <standard input>:119: a special character is not allowed in a name
troff: <standard input>:122: a special character is not allowed in a name
troff: <standard input>:129: a special character is not allowed in a name
troff: <standard input>:132: a special character is not allowed in a name

Then looking at those lines, they are like this:
    .B\-\-version
i.e. there is a missing space between the groff "tag" (the ".B") and the
"argument" (the "\-\-version").
That clearly breaks while displaying, in this case losing the first
minus sign.

I'm not sure how to handle this.  After all the manpage is generated by
sphinx, and I don't really know it.  I'll look into it (I don't really
consider it urgent).

-- 
regards,
                        Mattia Rizzolo

GPG Key: 66AE 2B4A FCCF 3F52 DA18  4D18 4B04 3FCD B944 4540      .''`.
more about me:  https://mapreri.org                             : :'  :
Launchpad user: https://launchpad.net/~mapreri                  `. `'`
Debian QA page: https://qa.debian.org/developer.php?login=mattia  `-
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: not available
URL: <http://alioth-lists.debian.net/pipermail/python-apps-team/attachments/20190822/668f9895/attachment.sig>