2571
Comment:
|
3675
fixing header
|
Deletions are marked like this. | Additions are marked like this. |
Line 1: | Line 1: |
## Auto-converted by kwiki2moinmoin v2005-10-07 FIXME : this is page is incomplete and have no structure. Though it is no worst than the void of newby documentation. |
#language en ~-[[DebianWiki/EditorGuide#translation|Translation(s)]]: English - [[fr/reportbug|Français]] - [[it/reportbug|Italiano]] -~ ---- |
Line 4: | Line 5: |
#debian dpkg bot : "it has been said that reportbug is use used to submit bugs to the Debian bug system. really simple to use, apt-get install reportbug, then run reportbug and answer the questions. It will file automagically if you're on-line. note: always check the list that reportbug gives you to see if the bug is already known" |
= Reporting bugs in Debian = <<TableOfContents()>> |
Line 7: | Line 8: |
== Introduction == | |
Line 8: | Line 10: |
$ reportbug package | DebPkg:reportbug is a tool designed to make the reporting of bugs in Debian and derived distributions relatively painless. Its features include: |
Line 10: | Line 12: |
The commands shows already reported bugs by around 20 . Type Enter to reach next page. |
* Access to outstanding bug reports to make it easier to identify whether problems have already been reported. * Automatic checking for newer versions of packages. * Optional automatic verification of integrity of packages via debsums. * Support for following-up on outstanding reports. * Integration with the mutt, af, and mh/nmh e-mail readers. * Optional PGP/GnuPG integration. This package provides access to the Debian Bug Tracking System, which can be used for both reporting and researching bugs, by a number of interfaces, including email, web, and command-line utilities. * To report a bug: 'reportbug packagename' * To view bugs for a package: 'querybts packagename' |
Line 15: | Line 26: |
From there there are two ways ( ) . Way 1, read the reports, if one match , write its number and click enter |
== Installation == {{{ apt-get install reportbug }}} |
Line 21: | Line 32: |
reportbug is designed to be used on systems with an installed mail transport agent, like exim or sendmail; however, you can edit the configuration file and send reports using any available mail server. | |
Line 22: | Line 34: |
Way 2, search throuhg the bugs by typing "f" then | If your system's users use [[Locale|locales]] with character sets other than [[UTF-8]] and ISO-8859-*, one of either python2.3-cjkcodecs or python2.3-iconvcodec is required for proper operation. For Asian locales, the use of python2.3-cjkcodecs is preferred over the more limited python2.3-iconvcodec. |
Line 25: | Line 37: |
After the last one you will be asked if you want to report a new bug. NB: If you don't know the vim text editor please choose one you know with "update-alternatices --config editor. You need to write your report with an editor :) In case you only know say gedit. Use : |
In control@bugs.debian.org there is a robot that expects specially-crafted control messages for the [[BTS|bug tracking system]]. |
Line 30: | Line 40: |
== See also == | |
Line 31: | Line 42: |
* Debian FAQ : 11.5 How do I report a bug in Debian ?<<BR>> http://www.debian.org/doc/manuals/debian-faq/ch-support.html#s-bugreport | |
Line 32: | Line 44: |
links which could help improve this page : | * debian BTS interface : <<BR>>http://www.debian.org/Bugs/ |
Line 34: | Line 46: |
* the reportbug project page http://alioth.debian.org/projects/reportbug/ |
* How to report a bug in Debian : mostly tell how to do things without reportbug.<<BR>> http://www.debian.org/Bugs/Reporting <<BR>> Also available in : /usr/share/doc/debian/bug-reporting.txt |
Line 37: | Line 48: |
* Reporting Bugs in Debian . Best Debian Bug report introduction i ever saw. http://women.alioth.debian.org/involvement/bugreporting |
* How to Report Bugs Effectively : generic recommendations for bug reporter<<BR>> http://www.chiark.greenend.org.uk/~sgtatham/bugs.html |
Line 40: | Line 50: |
* debian BTS interface : http://www.debian.org/Bugs/ |
* the reportbug project page<<BR>> http://alioth.debian.org/projects/reportbug/ |
Line 43: | Line 52: |
* How to report a bug in Debian : mostly tell how to do things without reportbug. http://www.debian.org/Bugs/Reporting Also available in : /usr/share/doc/debian/bug-reporting.txt |
* an example of the "formal letter" send to some of our Xfree users <<BR>>http://www.xfree86.org/pipermail/forum/2003-November/003841.html |
Line 47: | Line 54: |
* wiki page about the previous bug reporting command : http://wiki.debian.net/?DebianBugTrackingSystem |
* BugTriage |
Line 50: | Line 56: |
* SysAdminDocs : ["DebianXWindowsHowTo"] http://www.geosci.usyd.edu.au/pmwiki/pmwiki.php?n=SysAdminDocs.["DebianXWindowsHowTo"] |
* [[BTS/BugTag]] |
Line 53: | Line 58: |
* How to report bugs on Debian http://www.linuxfocus.org/English/September2000/article171.shtml |
* [[apt-get]] |
Line 56: | Line 60: |
* debian installer logs are in /var/log/debian-installer | == Using GMail's SMTP Server == |
Line 58: | Line 62: |
* How to Report Bugs Effectively : generic recommandations for bug reporter http://www.chiark.greenend.org.uk/~sgtatham/bugs.html |
It is sometimes easier to configure reportbug to use GMail to send bug reports rather than the existing sendmail program installed by default in Debian. The following outlines the steps to accomplish this: |
Line 61: | Line 64: |
* an example of the "formal letter" send to some of our Xfree users http://www.xfree86.org/pipermail/forum/2003-November/003841.html |
1. Run 'reportbug --configure' as your normal user. This creates a ~/.reportbugrc file that stores all the configurations. 2. Follow the instructions and when asked "''Do you have a 'mail transport agent' (MTA) configured''", choose 'No'. 3. Then enter the SMTP host for gmail: 'smtp.gmail.com:587' 4. For the user name enter: '<username>@gmail.com' 5. For the question "''Does your SMTP host require TLS authentication?''", choose 'Yes' (If you are on a release < squeeze, reportbug will not ask this question.) |
Line 64: | Line 70: |
* Debian FAQ : 11.5 How do I report a bug in Debian? http://www.debian.org/doc/manuals/debian-faq/ch-support.en.html#s-bugreport |
== Error Messages == |
Line 67: | Line 72: |
=== Warning: unsupported locale setting === | |
Line 68: | Line 74: |
* Re: bug reporting in noncommercial software : provide a light though complete description of reportbug capabilities and the BTS process. http://lwn.net/2001/1115/letters.php3 , cf Re: bug reporting in noncommercial software |
This warning may appear on the screen as '''reportbug''' is invoked. The error relates to [[Locale]] configuration. * Workaround : type LANG=C before the command. for example : {{{ LANG=C reportbug }}} |
Translation(s): English - Français - Italiano
Reporting bugs in Debian
Contents
Introduction
reportbug is a tool designed to make the reporting of bugs in Debian and derived distributions relatively painless. Its features include:
- Access to outstanding bug reports to make it easier to identify whether problems have already been reported.
- Automatic checking for newer versions of packages.
- Optional automatic verification of integrity of packages via debsums.
- Support for following-up on outstanding reports.
- Integration with the mutt, af, and mh/nmh e-mail readers.
- Optional PGP/GnuPG integration.
This package provides access to the Debian Bug Tracking System, which can be used for both reporting and researching bugs, by a number of interfaces, including email, web, and command-line utilities.
- To report a bug: 'reportbug packagename'
- To view bugs for a package: 'querybts packagename'
Installation
apt-get install reportbug
reportbug is designed to be used on systems with an installed mail transport agent, like exim or sendmail; however, you can edit the configuration file and send reports using any available mail server.
If your system's users use locales with character sets other than UTF-8 and ISO-8859-*, one of either python2.3-cjkcodecs or python2.3-iconvcodec is required for proper operation. For Asian locales, the use of python2.3-cjkcodecs is preferred over the more limited python2.3-iconvcodec.
In control@bugs.debian.org there is a robot that expects specially-crafted control messages for the bug tracking system.
See also
Debian FAQ : 11.5 How do I report a bug in Debian ?
http://www.debian.org/doc/manuals/debian-faq/ch-support.html#s-bugreportdebian BTS interface :
http://www.debian.org/Bugs/How to report a bug in Debian : mostly tell how to do things without reportbug.
http://www.debian.org/Bugs/Reporting
Also available in : /usr/share/doc/debian/bug-reporting.txtHow to Report Bugs Effectively : generic recommendations for bug reporter
http://www.chiark.greenend.org.uk/~sgtatham/bugs.htmlthe reportbug project page
http://alioth.debian.org/projects/reportbug/an example of the "formal letter" send to some of our Xfree users
http://www.xfree86.org/pipermail/forum/2003-November/003841.html
Using GMail's SMTP Server
It is sometimes easier to configure reportbug to use GMail to send bug reports rather than the existing sendmail program installed by default in Debian. The following outlines the steps to accomplish this:
- Run 'reportbug --configure' as your normal user. This creates a ~/.reportbugrc file that stores all the configurations.
Follow the instructions and when asked "Do you have a 'mail transport agent' (MTA) configured", choose 'No'.
- Then enter the SMTP host for gmail: 'smtp.gmail.com:587'
For the user name enter: '<username>@gmail.com'
For the question "Does your SMTP host require TLS authentication?", choose 'Yes' (If you are on a release < squeeze, reportbug will not ask this question.)
Error Messages
Warning: unsupported locale setting
This warning may appear on the screen as reportbug is invoked. The error relates to Locale configuration.
- Workaround : type LANG=C before the command. for example :
LANG=C reportbug