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

[Francesco Poli (wintermute)]

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

    improve the man page further
    
    The options list should be also turned into a DescList (by using ':'
    instead of '*' characters), but this is currently blocked by
    bug #688450, unfortunately.

diff --git a/apt-listbugs b/apt-listbugs
index 69cd2c3..afcce6d 100755
--- a/apt-listbugs
+++ b/apt-listbugs
@@ -47,15 +47,15 @@ apt-listbugs [-h] [-v] [-s <severities>] [-T <tags>] [-S <states>] [-B <bug#>] [
 
 == OPTIONS
 
-* -h | --help
+* -h, --help
 
-  Print usage help and exit
+  Print usage help and exit.
 
-* -v | --version
+* -v, --version
 
-  Print version number and exit
+  Print version number and exit.
 
-* -s <severities> | --severity <severities>
+* -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
@@ -63,14 +63,14 @@ apt-listbugs [-h] [-v] [-s <severities>] [-T <tags>] [-S <states>] [-B <bug#>] [
   "critical", "grave", "serious", "important", "normal", "minor",
   "wishlist", or the special value "all" to disable filtering.
 
-* -T <tags> | --tag <tags>
+* -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 <states> | --stats <states>
+* -S <states>, --stats <states>
 
   Filter (and sort) bugs by pending-state, showing only the bugs
   matching specified values. List the pending-state categories that
@@ -89,84 +89,84 @@ apt-listbugs [-h] [-v] [-s <severities>] [-T <tags>] [-S <states>] [-B <bug#>] [
   conditions on this list match, the later one takes priority), and
   that "pending" does not mean "tagged as pending".
 
-* -B <bug#> | --bugs <bug#>
+* -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
   (e.g. "123456,567890,135792"). Default: no filter.
 
-* -D | --show-downgrade
+* -D, --show-downgrade
 
   Show bugs of downgraded packages. (apt mode only)
 
-* -H <hostname> | --hostname <hostname>
+* -H <hostname>, --hostname <hostname>
 
   Specifies the hostname of the Debian Bug Tracking System [bugs.debian.org].
 
-* -p <port> | --port <port>
+* -p <port>, --port <port>
 
   Specifies the port number of the web interface of the Debian Bug
   Tracking System [80].
 
-* -P <priority> | --pin-priority <priority>
+* -P <priority>, --pin-priority <priority>
 
   Specifies Pin-Priority value [1000].
 
-* -E <title> | --title <title>
+* -E <title>, --title <title>
 
   Specifies the title of RSS output.
 
-* -q | --quiet
+* -q, --quiet
 
   Don't display progress bar. This option is assumed if stdout is not a 
   terminal or if /dev/tty cannot be opened.
 
-* -C <apt.conf> | --aptconf <apt.conf>
+* -C <apt.conf>, --aptconf <apt.conf>
 
   Specifies the apt configuration file to use.
 
-* -y | --force-yes 
+* -y, --force-yes 
 
   Assumes that you select yes for all questions.
 
-* -n | --force-no
+* -n, --force-no
 
   Assumes that you select no for all questions.  This option is
   assumed if stdout is not a terminal or if /dev/tty cannot be opened.
 
-* -d | --debug
+* -d, --debug
 
   Give extra debug output, important for debugging problems. Please
   include -d when reporting problems.
 
 == COMMANDS
 
-* apt
+: apt
 
   Reads package actions from standard input (typically provided by apt
   or other compatible package manager; Pre-Install-Pkgs hook info
   protocol version 2 is expected - see apt.conf(5) for more details).
 
-* list [<package1[/version]> <package2[/version]>...]
+: list [<package1[/version]> <package2[/version]>...]
 
   Reads package names from the arguments and simply lists bugs of
   these packages. Package versions may be specified with a slash, as in
   apt/1.0 for example.
 
-* rss [<package1[/version]> <package2[/version]>...]
+: rss [<package1[/version]> <package2[/version]>...]
 
   Reads package names from the arguments and lists bugs of these packages
   in RSS format. Again, package versions may be specified with a slash.
 
 == ENVIRONMENT VARIABLES
 
-* APT_LISTBUGS_FRONTEND
+: APT_LISTBUGS_FRONTEND
 
   If this variable is set to "none", apt-listbugs will not execute at all;
   this might be useful if you would like to script the use of a program that
   calls apt-listbugs.
 
-* http_proxy
+: http_proxy
 
   If http_proxy is set, the value is used for HTTP Proxy, unless
   proxy settings are found in APT configuration (see below).
@@ -176,21 +176,19 @@ apt-listbugs [-h] [-v] [-s <severities>] [-T <tags>] [-S <states>] [-B <bug#>] [
 apt-listbugs understands APT configuration file (see apt.conf). The
 notable configuration options are 
 
-* Acquire::HTTP::Proxy
+: Acquire::HTTP::Proxy
 
   Default HTTP Proxy setting (overrides any http_proxy environment variable
   value).
-
   An empty string or the special keyword 'DIRECT' will disable proxy.
 
-* Acquire::HTTP::Proxy::bugs.debian.org
+: Acquire::HTTP::Proxy::bugs.debian.org
 
   Specific HTTP Proxy setting (overrides the default HTTP Proxy setting).
   Useful for setting HTTP proxy for apt-listbugs.
-
   The special keyword 'DIRECT' will disable proxy.
 
-* AptListbugs::IgnoreRegexp
+: AptListbugs::IgnoreRegexp
 
   Bugs to ignore when in apt mode. I would suggest setting this to
   "FTBFS" since those bugs tend to not affect the user, but this
@@ -217,19 +215,19 @@ notable configuration options are
 
 == EXIT CODE
 
-* 0 
+: 0 
 
   Success.
 
-* 1
+: 1
 
   When something is wrong.
 
-* 10 
+: 10 
 
   To warn APT not to proceed.
 
-* 130 
+: 130 
 
   When a SIGINT was received (for instance because the user
   pressed [Ctrl+C]).

-- 
apt-listbugs development tree