Differences between revisions 1 and 25 (spanning 24 versions)
Revision 1 as of 2005-06-17 14:47:57
Size: 2130
Editor: anonymous
Comment:
Revision 25 as of 2012-07-31 18:03:02
Size: 3646
Editor: nodiscc
Comment:
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
~-Translation(s): [[it/reportbug|Italiano]] -~
~-Translation(s): [[fr/reportbug|Français]] -~
----
Line 4: Line 6:
$ reportbug package = Reporting bugs in Debian =
<<TableOfContents()>>
Line 6: Line 9:
The commands shows already reported bugs by around 20 .
Type Enter to reach next page.
After the last one you will be asked if you want to report a new bug.
== Introduction ==

DebPkg: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'
Line 11: Line 26:
NB: If you don't know the vim text editor please choose one you know with "update-alternatices --config editor.
In case you only know say gedit. Use :

== Installation ==
{{{
apt-get install reportbug
}}}
Line 15: Line 33:
From there there are two ways ( ) . 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 17: Line 35:
Way 1, read the reports, if one match , write its number and click enter 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 20: Line 38:
links which could help improve this page :

 * the reportbug project page
http://alioth.debian.org/projects/reportbug/

 * Reporting Bugs in Debian . Best Debian Bug report introduction i ever saw.
http://women.alioth.debian.org/involvement/bugreporting

 * debian 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.txt

 * wiki page about the previous bug reporting command :
http://wiki.debian.net/?DebianBugTrackingSystem

 * SysAdminDocs : ["DebianXWindowsHowTo"]
http://www.geosci.usyd.edu.au/pmwiki/pmwiki.php?n=SysAdminDocs.["DebianXWindowsHowTo"]

 * How to report bugs on Debian
http://www.linuxfocus.org/English/September2000/article171.shtml

 * debian installer logs are in /var/log/debian-installer

 * How to Report Bugs Effectively : generic recommandations for bug reporter
http://www.chiark.greenend.org.uk/~sgtatham/bugs.html

 * an example of the "formal letter" send to some of our Xfree users
http://www.xfree86.org/pipermail/forum/2003-November/003841.html

 * 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
In control@bugs.debian.org there is a robot that expects specially-crafted control messages for the [[BTS|bug tracking system]].
Line 56: Line 41:
 * 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
== See also ==

 * 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

 * debian BTS interface : <<BR>>http://www.debian.org/Bugs/

 * 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

 * How to Report Bugs Effectively : generic recommendations for bug reporter<<BR>> http://www.chiark.greenend.org.uk/~sgtatham/bugs.html

 * the reportbug project page<<BR>> http://alioth.debian.org/projects/reportbug/

 * an example of the "formal letter" send to some of our Xfree users <<BR>>http://www.xfree86.org/pipermail/forum/2003-November/003841.html

 * BugTriage

 * [[BTS/BugTag]]

 * [[apt-get]]

== 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
}}}

Translation(s): Italiano Translation(s): Français


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