[dput-ng-maint] Bug#741966: dcut: please make --allow for multiple package foolproof

[Jakub Wilk]

Package: dput-ng
Version: 1.7
Severity: wishlist

This is how I struggled with granting a DM permissions to upload 
multiple packages today:

1) Try this:

$ dcut dm --uid mrs.buns at example.com --allow=eggs --allow=ham

It works! Err, except that it grants permission only for "ham".

2) Look into the manpage, which reads:

--allow=PACKAGES
    Source package(s) where permissions to upload should be granted. 
Repeat the argument to apply permissions to more than one package at 
once.

3) Follow the documentation:

$ dcut dm --uid mrs.buns at example.com --allow=eggs ham
[...]
dcut: error: unrecognized arguments: ham

4) Think that maybe the manpage got out of sync, and try to learn the 
correct syntax from --help instead:

$ dcut dm --help | grep allow
[nothing]

(This is bug #741947).

5) Look into the documentation, and figure out the correct syntax from 
the EXAMPLES section.

6) Finally succeed with:

$ dcut dm --uid mrs.buns at example.com --allow eggs ham


I'd like to propose two changes to ease life of people who are not very 
smart (e.g. me):

* Either make "--allow=eggs --allow=ham" an error, or make it Do The 
Right Thing (preferably the latter).

* Fix the manual page, so that is uses syntax that actually works.

Thanks for considering.

-- 
Jakub Wilk