[Apt-listbugs-commits] [SCM] apt-listbugs development tree branch, master, updated. apt-listbugs/0.1.7-33-ga22516f

Francesco Poli (wintermute) invernomuto at paranoici.org
Sat Sep 22 21:47:12 UTC 2012


The following commit has been merged in the master branch:
commit d81cdc5f0017bad11020ee176c32df3574c522a0
Author: Francesco Poli (wintermute) <invernomuto at paranoici.org>
Date:   Sat Sep 22 22:16:27 2012 +0200

    clarify man page

diff --git a/apt-listbugs b/apt-listbugs
index f51b821..69cd2c3 100755
--- a/apt-listbugs
+++ b/apt-listbugs
@@ -6,6 +6,7 @@
 # Copyright (C) 2006-2008  Junichi Uekawa <dancer at debian.org>
 # Copyright (C) 2008-2012  Francesco Poli <invernomuto at paranoici.org>
 # Copyright (C) 2009       Ryan Niebur <ryan at debian.org>
+# Copyright (C) 2012       Justin B Rye <jbr at edlug.org.uk>
 #
 #  This program is free software; you can redistribute it and/or modify
 #  it under the terms of the GNU General Public License as published by
@@ -42,7 +43,7 @@ in order to check whether the upgrade/installation is safe.
 
 == USAGE
 
-apt-listbugs [-h] [-v] [-s <severities>] [-T <tags>] [-S <stats>] [-B <bug#>] [-D] [-H <hostname>] [-p <port>] [-P <priority>] [-E <title>] [-q] [-C <apt.conf>] [-y] [-n] [-d] <command> [arguments]
+apt-listbugs [-h] [-v] [-s <severities>] [-T <tags>] [-S <states>] [-B <bug#>] [-D] [-H <hostname>] [-p <port>] [-P <priority>] [-E <title>] [-q] [-C <apt.conf>] [-y] [-n] [-d] <command> [arguments]
 
 == OPTIONS
 
@@ -56,29 +57,47 @@ apt-listbugs [-h] [-v] [-s <severities>] [-T <tags>] [-S <stats>] [-B <bug#>] [-
 
 * -s <severities> | --severity <severities>
 
-  Severities you want to see, separated by commas; possible values are critical, grave, serious, important, normal, minor and wishlist. Default: [critical,grave,serious]
-  You can specify '--severity all' to specify all 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>
 
-  Tags you want to see, separated by commas. 
+  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 <stats> | --stats <stats>
+* -S <states> | --stats <states>
 
-  Status you want to see, separated by commas. Default: [forwarded,done,pending,pending-fixed]
+  Filter (and sort) bugs by pending-state, showing only the bugs
+  matching specified values. 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:
 
-  Note that 'pending' does not mean 'tagged pending', but 'still open, pending a fix'.
+    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#>
 
-  By default, apt-listbugs will consider all bugs.
-  This option adds a restriction to the bug numbers you want to see, separated by commas
-  (e.g. 123456,567890,135792).  If this option is specified, all other
-  bugs will be ignored.
+  Filter bugs by number, showing only the bugs directly specified.
+  List the bug numbers that you want to see, separated by commas
+  (e.g. "123456,567890,135792"). Default: no filter.
 
 * -D | --show-downgrade
 
-  Shows bugs of downgraded packages. (apt mode only)
+  Show bugs of downgraded packages. (apt mode only)
 
 * -H <hostname> | --hostname <hostname>
 
@@ -86,7 +105,8 @@ apt-listbugs [-h] [-v] [-s <severities>] [-T <tags>] [-S <stats>] [-B <bug#>] [-
 
 * -p <port> | --port <port>
 
-  Specifies the port number of the web interface of the Debian Bug Tracking System [80].
+  Specifies the port number of the web interface of the Debian Bug
+  Tracking System [80].
 
 * -P <priority> | --pin-priority <priority>
 
diff --git a/debian/changelog b/debian/changelog
index fa25bff..aa86dcf 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -18,6 +18,8 @@ apt-listbugs (0.1.8) UNRELEASED; urgency=low
   * updated French translation, thanks to Jean-Baka Domelevo Entfellner!
     (Closes: #686745)
   * updated German translation, thanks to Thomas Müller! (Closes: #686915)
+  * clarified the man page, thanks to the significant contribution by
+    Justin B Rye
 
  -- Francesco Poli (wintermute) <invernomuto at paranoici.org>  Sat, 07 Jul 2012 23:05:28 +0200
 
diff --git a/debian/copyright b/debian/copyright
index fabfdf3..03f1df0 100644
--- a/debian/copyright
+++ b/debian/copyright
@@ -9,6 +9,7 @@ Copyright (C) 2006-2008  Junichi Uekawa <dancer at debian.org>
 Copyright (C) 2007       Jean Lepropre <jlepropre at gmail.com>
 Copyright (C) 2008-2012  Francesco Poli <invernomuto at paranoici.org>
 Copyright (C) 2009-2010  Ryan Niebur <ryan at debian.org>
+Copyright (C) 2012       Justin B Rye <jbr at edlug.org.uk>
 
   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by

-- 
apt-listbugs development tree



More information about the Apt-listbugs-commits mailing list