On 2019-02-07 11:25, Stuart Prescott wrote:
> Control: reassign -1 apt-listbugs 0.1.28
> Control: severity -1 wishlist
> Control: retitle -1 apt-listbugs: simplify wording for pinning description

> ...

> I've reassigned this bug to apt-listbugs as that is the appropriate
> package. If you can suggest an appropriate improvement to the wording
> of the above help text then that would be useful.

Well, since you asked ...

1) Maybe for the user prompt, adopt the style of 'reportbug'; something
   like:

   How to deal with the listed bugs [y|n|a|#..|p..|i..|w|?]?" Y

   This intentionally breaks the convention of upper-casing the default,
   since the default is written anyway, and because ...

2) My druthers would be for option 'a' to be made an upper-case 'I' and
   the unqualified option 'p' be made an upper-case 'P'.

3) If there already exists an option 'n' that can stop the APT
   installation, why can't an unqualified 'p' option do the same? What
   further operation are you expecting a user to do after 'p'? Requiring
   an extra manual step introduces an unnecessary opportunity for
   user-error, and introduces confusion of when and how to perform the
   abort.

4) The extended prompt, and the man page documentation, make it seem
   like pinning is done for all or none of a package's listed bugs; it's
   unclear whether in a case of two or more bugs being listed for a
   single package, if its possible to pin only a sub-set of the bug
   list, eg. 'p <num>' or 'p b<id>'.

5) The 'p' option seems to be able to handle a list of packages, which
   is a nice convenience, but the parallel option 'i' isn't annotated
   that way.

6) There doesn't seem to be a command-line method to recover from a
   keying error or a decision-change regarding pinning or ignoring a bug
   - something like a 'u' option to undo a particular change, and a 'U'
   option to undo all changes. For those options to be practical, it
   would be useful to have yet another option 'R' to redisplay all bugs,
   including those prior marked 'ignored' or 'pinned'.

7) So your simple request did eventually get me here, with the following
   for the extended prompt, which definitely pre-supposes changes to
   option keys and functionality:

   | How to deal with the listed bugs [y|n|P|I|U|R|r|w|#..|p..|i..|u..|?]?" Y
   |
   |     y     - install anyway. Do not mark the bugs 'ignored'.
   |     n     - stop the APT installation.
   |     P     - pin all the listed bugs, and stop the APT install
   |     I     - continue the install. Mark the bugs 'ignored'.
   |     U     - remove all pins and ignore states.
   |     r     - redisplay the bug list
   |     R     - redisplay the bug list, with ALL pins and 'ignored' bugs.
   |     w     - redisplay the bug list in HTML
   |     ?     - redisplay this help.
   |
   |       In the following options <arg> may be an entry b<num>, a
   |       debian bug number <num> or #<num>, or a package names. <args>
   |       may be a list of those, in any combination.
   |
   |   <arg>   - display bug detail, using querybts
   | p <args>  - pin pkgs (Later, you must select 'n' to enable this).
   | i <args>  - ignore bugs on future APT runs.
   | u <args>  - remove pin and 'ignore' states


Regards.

-- 
hkp://keys.gnupg.net
CA45 09B5 5351 7C11 A9D1  7286 0036 9E45 1595 8BC0

Reply via email to