[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Clarification plan for apt-listbugs filtering options



Hello!

The following plan is what I prepared after re-reading the
two recent (sub-)threads that start from:
https://lists.debian.org/debian-l10n-english/2012/09/msg00026.html
https://lists.debian.org/debian-l10n-english/2012/09/msg00043.html

My plan consists of two parts, one to be implemented soon,
the other to be postponed until wheezy is released (since,
as far as I can tell, behavioral changes would not be accepted
for testing during a freeze, unless they fix RC bugs).

Constructive criticism, suggestions for improvements, and so forth, are
more than welcome.
Please Cc me and Thomas on replies.
Thanks!


First part (to be implemented soon)
-----------------------------------

Change the man page so that it says:


 * -s <severities> | --severity <severities>

  Filter bugs by severity, showing only the bugs matching a specified
  value. List the bug severities that you want to see, separated by
  commas. Default: [critical,grave,serious]. Possible values are
  "critical", "grave", "serious", "important", "normal", "minor",
  "wishlist", or the special value "all" to disable filtering.

 * -T <tags> | --tag <tags>

  Filter bugs by tags, showing only the bugs matching _all_ specified
  values. List the tags that you want to see, separated by commas.
  Default: no filter. Possible values include "confirmed,l10n" to show
  only bugs that have both these tags.

 * -S <state> | --stats <state>

  Filter bugs by pending-state, showing only the bugs matching a
  specified value. List the pending-state categories that you want to
  see, separated by commas and in the desired order. Default:
  [forwarded,done,pending,pending-fixed]. Possible values are:

        pending = open bug
        forwarded = marked as "forwarded"
        pending-fixed = tagged as "pending"
        fixed = tagged as "fixed"
        absent = not found in this distribution/architecture
        done = resolved in some version for this distribution/architecture

   Note that a bug can only match one such state (when multiple
   conditions on this list match, the later one takes priority), and
   that "pending" does not mean "tagged as pending".

 * -B <bug#> | --bugs <bug#>

  Filter bugs by number, showing only the bugs directly specified.
  List the bug numbers that you want to see, separated by commas.
  Default: no filter.


The above text is derived from the one drafted by JBR, which he released
under the same terms as apt-listbugs (GPL v2 or later).
Please note that I slightly changed the description of the -S option,
since the order in which pending-states are specified is significant
(as it changes the order in which bugs are displayed in output).


Second part (to be implemented after wheezy is out)
---------------------------------------------------

Add the "fixed" pending-state to the default list for the -S option
and reorder that list: [pending,forwarded,pending-fixed,fixed,done].
Update the man page accordingly.

Modify the discursive descriptions used in apt-listbugs output
according to the following mapping:

        pending          becomes    "Outstanding"
        forwarded        becomes    "Forwarded"
        pending-fixed    becomes    "Pending Upload"
        fixed            becomes    "Fixed in NMU"
        absent           becomes    "From other Branch"
        done             becomes    "Resolved in some Version"

for better consistency with the BTS web interface.

Change the output of "apt-listbugs -h", so that it says:

 -s <severities>  : Filter bugs by severities you want to see (or "all")
                    [critical,grave,serious].
 -T <tags>        : Filter bugs by tags you want to see.
 -S <state>       : Filter bugs by pending-state categories you want to see
                    [pending,forwarded,pending-fixed,fixed,done].
 -B <bug#>        : Filter bugs by number, showing only the specified bugs.





-- 
 http://www.inventati.org/frx/frx-gpg-key-transition-2010.txt
 New GnuPG key, see the transition document!
..................................................... Francesco Poli .
 GnuPG key fpr == CA01 1147 9CD2 EFDF FB82  3925 3E1C 27E1 1F69 BFFE

Attachment: pgpWarCwYlUCi.pgp
Description: PGP signature


Reply to: