1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
The Debian Package apt-listbugs
-------------------------------
Introduction
============
'apt-listbugs' is a tool which retrieves bug reports from the Debian
Bug Tracking System and lists them. Especially, it is intended to
be invoked before each upgrade by apt in order to check whether
the upgrade is safe.
Most of Debian developers use the unstable version of Debian
and some users also use it because the version is the latest
snapshot which includes many features and new packages.
'apt' is a great convenient tool to follow your system to the latest
version easily. On the other hand, the feature also makes your system
break easily. If a package is broken and uploaded to the Debian unstable,
the package will be installed on many Debian system soon.
From a debian developer's point of view, many bug reports are reported
for only one bug. Unfortunately, these bugs are usually reported to several
packages.
You can install it easily by apt. Usually, customisation is not
required. However, I do strongly suggest use of proxy server in order
to reduce the number of accesses to the BTS.
Bug information retrieval
=========================
This version of 'apt-listbugs' uses bugs.debian.org for bug
retrieval. It retrieves index from bugs.debian.org/indices/ (currently
redirected to merkel.debian.org/~dancer/apt-listbugs/), and each bug
via SOAP interface on bugs.debian.org (currently a redirect to
bugs.donarmstrong.com).
Notes
=====
'apt-listbugs' requires a console for user interaction. It will
default to noninteractive failure more if tty is not available.
By default, 'apt-listbugs' retrieves bug reports from the local
cache. Because it's not possible to know if the cache contents are
up-to-date the reports may be old. The cache will be automatically
removed in 1 hour (by default). If you want to change the timer, put
the -t option to apt-listbugs. Use -f option to force refresh.
'apt-listbugs' has a simple interactive viewer built-in. It uses
querybts program as a back-end. To enable this feature, you need to
install 'reportbug' package. In addition, you can select broken
packages for pinning, to avoid automatically upgrading them. However,
pinning is not effective immediately, and requires restarting your apt
session.
The pinning will be removed when the package no longer has any
critical bugs, by cron.daily.
If you install www-browser, you can view bug lists in html.
sensible-browser in debianutils (>= 2.0) also available.
Current Design Limitation
=========================
There is a problem with packages which have source-version and
binary-version mismatch. The BTS tracks the source version, while
apt-listbugs tracks the binary version. This conflict results in
version tracking not functioning for such packages. A popular example
of such package is gcc.
apt-setup bug
=============
During Etch development, there was a time where apt-setup had a bug,
and put 'false' as Acquire::http::proxy configuration. (Bug: #378868)
Remove the line saying
Acquire::http::proxy 'false'
from apt.conf
Reading package fields... Done
Reading package status... Done
Retrieving bug reports... 0% W: unsupported proxy `false'
Filing Bugs on apt-listbugs
===========================
SOAP_USE_PROXY
--------------
If you intend to file bug on why SOAP_USE_PROXY is required, don't.
There's already a bug filed as 399706.
This bug is going to be fixed in future ruby1.8 upstream version of
soap4r.
Debugging apt-listbugs
----------------------
When there is an error, to obtain reproducible debugging information,
please run the following command-line to invoke apt-listbugs with the
debugging output, and attach the output along with your bugreport.
(echo 'VERSION 2'; echo '' ;
ls -1 /var/cache/apt/archives/PACKAGE_*.deb |
sed 's/^/x x x x /') |
/usr/sbin/apt-listbugs apt -d
(substitute PACKAGE with the package name)
Of course, if you are feeling more like contributing to apt-listbugs,
enable debug output by default by editing
/etc/apt/apt.conf.d/10apt-listbugs to add the debug option '-d'.
DPkg::Pre-Install-Pkgs {"/usr/sbin/apt-listbugs apt || exit 10"};
to read
DPkg::Pre-Install-Pkgs {"/usr/sbin/apt-listbugs apt -d || exit 10"};
Hacking apt-listbugs
====================
There is so much more information about debbugs SOAP debbugs interface
available from debbbugs source.
http://bugs.debian.org/debbugs-source/mainline/Debbugs/Bugs.pm
-- Junichi Uekawa <dancer@debian.org>, Fri, 4 Jan 2008 19:55:38 +0900
|
