[Python-modules-team] Bug#814848: subliminal: order of arguments in help and manpage is confusing

[Roland Hieber]

Package: subliminal
Version: 0.7.4-1
Severity: normal

Dear Maintainer,

If I try to call subliminal like described in the help, I get an error:

	rohieb at r2d2:~/Videos$ subliminal -l en .
	usage: subliminal -l LANGUAGE [LANGUAGE ...] [-s] [-c CACHE_FILE]
										[-p PROVIDER [PROVIDER ...]] [-m MIN_SCORE] [-a AGE] [-h]
										[-f] [--addic7ed-username USERNAME]
										[--addic7ed-password PASSWORD] [-q | -v] [--color] [--debug]
										[--version] [--help]
										PATH [PATH ...]
	subliminal: error: the following arguments are required: PATH

Note that PATH is only given at the end of the syntax, so I interpreted it to
be "the last given parameter", but apparently it is not parsed when I call
subliminal like that.

When I call subliminal with the path first, then the languages, the error does
not appear.



-- System Information:
Debian Release: stretch/sid
  APT prefers testing-proposed-updates
  APT policy: (500, 'testing-proposed-updates'), (500, 'testing'), (170, 'unstable'), (1, 'experimental')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 4.3.0-1-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=de_DE.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)

Versions of packages subliminal depends on:
ii  python3             3.5.1-1
ii  python3-subliminal  0.7.4-1

subliminal recommends no packages.

subliminal suggests no packages.

-- no debconf information