Differences between revisions 2 and 26 (spanning 24 versions)
Revision 2 as of 2005-06-17 14:55:22
Size: 2571
Editor: anonymous
Comment:
Revision 26 as of 2012-07-31 19:14:20
Size: 3675
Editor: ?skizzhg
Comment: 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

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

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:

  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.)

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