[Debian-l10n-devel] Bug#1099526: dl10n: Missing "actions" in useage docu

[Christian Buhtz]

Package: dl10n
Version: 3.00+nmu1
Severity: important
Tags: l10n

The docu about using "dl10n-check" is not complete and therefore "dl10n-check"
can not be used.

See the following example and have a look to the second line starting with
"Syntax: ". There the placeholder "[action]" is shown. But there is no action
described in the rest of that usage output.

$ dl10n-check
dl10n-check: Nothing to do !
Syntax: /usr/bin/dl10n-check [action] [options] [--] [package|path to the
dist]+
General options:
    -h, --help                display short help text
    -v, --verbose             verbose messages
    -V, --version             display version and exit
    -d, --debug               turn debug messages ON
    --print-version           print unadorned version number and exit
Behaviour options:
    --careful                 save the db file after each package proceeding
    -f, --force               force check even if packages are up-to-date in db
    --force-material          force check for any package containing material
    -u, --remove-unused       remove packages not found in Packages files
    --mark-obsolete           when extracting package data, add a .old suffix
                              instead of deleting old files
Configuration options:
    -F, --files-from=FILE     reads dsc filenames from FILE
    --db=DB_FILE              use DB_FILE as database file
                                (instead of ./data/status)
    --mandb=DB_FILE           use DB_FILE as database file for manpages
                                (instead of ./data/transmonitorman)
    --tmp=TMP_DIR             use TMP_DIR as temp dir
                                (instead of /tmp/dl10n)
                                (warning, the script do 'rm -rf' on this dir!)
    --po=PO_ROOT              where to store the po files
                                (instead of ./material/po)
    --templates=DIR           where to store the debconf templates files
                                (instead of ./material/templates)
    --menu=DIR                where to store the menu files
                                (instead of ./material/menu)
    --man=DIR                 where to store the man files
                                (instead of ./material/man)
    --root=ROOTDIR            search the libs in ROOTDIR
                                (instead of ./)


-- System Information:
Debian Release: trixie/sid
  APT prefers testing
  APT policy: (500, 'testing')
Architecture: arm64 (aarch64)

Kernel: Linux 6.12.12-arm64 (SMP w/4 CPU threads)
Kernel taint flags: TAINT_CRAP
Locale: LANG=de_DE.UTF-8, LC_CTYPE=de_DE.UTF-8 (charmap=UTF-8), LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages dl10n depends on:
ii  gettext                           0.23.1-1
ii  liblocale-gettext-perl            1.07-7+b1
ii  libmailtools-perl                 2.22-1
ii  libtimedate-perl                  2.3300-2
ii  libwww-perl                       6.77-1
ii  perl                              5.40.1-2
ii  perl-modules-5.36 [perl-modules]  5.36.0-7+deb12u1
ii  perl-modules-5.40 [perl-modules]  5.40.1-2

dl10n recommends no packages.

dl10n suggests no packages.

-- no debconf information