个人工具

“UbuntuHelp:ReportingBugs”的版本间的差异

来自Ubuntu中文

跳转至: 导航, 搜索
(新页面: {{From|https://help.ubuntu.com/community/ReportingBugs}} {{Languages|UbuntuHelp:ReportingBugs}} Software contains flaws, called bugs. To keep track of bugs and their fixes, Ubuntu uses [...)
 
 
(未显示2个用户的12个中间版本)
第1行: 第1行:
 
{{From|https://help.ubuntu.com/community/ReportingBugs}}
 
{{From|https://help.ubuntu.com/community/ReportingBugs}}
 
{{Languages|UbuntuHelp:ReportingBugs}}
 
{{Languages|UbuntuHelp:ReportingBugs}}
 +
#title Reporting Bugs - [[UbuntuHelp:HowTo|HowTo]]   
 +
<<Anchor(Top)>>
 +
'''If you've come here when trying to file a bug about Ubuntu in Launchpad this was deliberate.  Please read the following documentation regarding how to report a bug about Ubuntu.'''
 +
== Reporting bugs ==
 +
Ubuntu uses Launchpad to keep track of bugs and their fixes. To file a bug you first need to [[UbuntuHelp: https://help.launchpad.net/YourAccount/NewAccount | create an account ]].  Once you have an account you can use the tools we've provided you on your Ubuntu system to file bug reports.
 +
Note 1: If you use Kubuntu, please see the Kubuntu variant of this page [https://wiki.kubuntu.org/Kubuntu/Bugs/Reporting here].
 +
Note 2: After the bug is reported, please '''always''' leave the Status set to ''New'' (Curious about bug status? Details [[UbuntuWiki:Bugs/Status|here]]).
 +
=== Use the menu - try this first! ===
 +
'''Note:''' Since [[UbuntuWiki:LucidLynx|Lucid|Lynx]] this only works for the Development Releases, If you're running Lucid you might want to use the [[UbuntuHelp:ReportingBugs#Filing_a_bug_with_ubuntu-bug|ubuntu-bug]] method.
 +
If you want to report a bug on an application that is ''running and responding'', use the application's help menu: '''Help -> Report a problem'''.
 +
https://help.ubuntu.com/community/ReportingBugs?action=AttachFile&do=get&target=report-a-problem.png
 +
This method is preferable to filing a bug at the Launchpad website - it automatically attaches relevant information, which helps analyze the problem.
 +
If an application crashes, and you're using a version of Ubuntu which is actively under development, [[UbuntuWiki:Apport|Apport]] will start automatically, raising an appropriate bug report for you to complete in Launchpad.  This provides developers with rich debugging information that will make it easier to fix the problem.
 +
https://help.ubuntu.com/community/ReportingBugs?action=AttachFile&do=get&target=apport-1.png
 +
=== Filing a bug with ubuntu-bug ===
 +
If you can't file your report from the menu, for example:
 +
* You're using the Server Edition
 +
* The application doesn't have the appropriate menu item
 +
* The application won't start at all
 +
* Your problem is not related to an application but is an infrastructure component, such as the Linux kernel or graphics subsystem
 +
You can still help us by using `ubuntu-bug`.
 +
==== Ubuntu 8.10 and later ====
 +
{|border="1" cellspacing="0"
 +
|https://help.ubuntu.com/community/ReportingBugs?action=AttachFile&do=get&target=ubuntu-bug.png%7CFiling+a+bug+with+the+%22Run+Application%22+window
 +
|}
 +
Press Alt+F2 to open the "Run Application" window, pictured above.  Type `ubuntu-bug `''`<package name>`'' and click ''Run''.  Server Edition users should use a terminal instead.  If you're not sure which package has a problem,
 +
refer to the instructions for [[UbuntuWiki:Bugs/FindRightPackage|finding|the right package]].
 +
To file a bug against a program that is currently running, go to '''System > Administration > System Monitor''', and find the ID of the process.  Server Edition users should use `ps aux`.
 +
https://help.ubuntu.com/community/ReportingBugs?action=AttachFile&do=get&target=system-monitor-id.png+%7C+System+Monitor+Processes+tab+
 +
Then type the process ID instead of the package name into the "Run Application" window.
 +
https://help.ubuntu.com/community/ReportingBugs?action=AttachFile&do=get&target=ubuntu-bug-pid.png+%7C+Filing+a+bug+with+the+%22Run+Application%22+window+and+a+process+ID
 +
==== Ubuntu 8.04 LTS to Ubuntu 9.04 ====
 +
In Ubuntu 8.04 LTS, you need to type `ubuntu-bug -p` (lowercase `p`) when reporting a bug about a package, or `ubuntu-bug -P` (capital `P`) when reporting a bug about a process ID.  Instructions are otherwise identical to the above.
 +
==== Ubuntu 9.10 and Later ====
 +
You only need to type `ubuntu-bug PKGNAME` when reporting against a package, or `ubuntu-bug PID` when reporting a bug about a process ID.  Instructions are otherwise identical to the above.
 +
=== Filing bugs when off-line ===
 +
In the event that you have a bug with your internet connection or want to file a bug for another system you can still do this using apport.  Using the command `apport-cli -f -p` ''`<package name>`'' on the target system will collect information and provide you with an option to "K: Keep report file for sending later or copying to somewhere else".  The report is then saved on the target system, in your ''/tmp'' directory which is cleared out on reboot,  with a .apport extension.  After copying it to a different system you can file that report using `ubuntu-bug ` ''`<location of apport file>`''.
 +
=== Filing translation bugs ===
 +
All translation issues should be filed against the [https://bugs.launchpad.net/ubuntu-translations  Ubuntu Translations project] (ubuntu-translations). From there the bugs will be triaged and assigned to the right person and package.
 +
Here is a non-exhaustive list of problems that are appropriate for the Ubuntu Translations project:
 +
* Wrong translations or spelling mistakes in applications
 +
* Errors in spellcheckers or language support
 +
* A string from an application is not available for translation in [http://translations.launchpad.net/ubuntu Launchpad Translations]
 +
* An application from the Ubuntu main repository is not available for translation in [http://translations.launchpad.net/ubuntu Launchpad Translations]
 +
* A translation made in [http://translations.launchpad.net/ubuntu Launchpad Translations] is not updated in the Ubuntu language packs
 +
* There is a duplicate translation template (the same application can be translated in two different places) in [http://translations.launchpad.net/ubuntu Launchpad Translations]
 +
* A template/translation is no longer used in Ubuntu and should be disabled from [http://translations.launchpad.net/ubuntu Launchpad Translations]
 +
You can also consult the [https://bugs.launchpad.net/ubuntu-translations current bugs] to see the big picture. In case of doubt, you can always [[UbuntuWiki:Translations/Contact|contact|the Translations team]].
 +
=== Filing bugs at Launchpad.net ===
 +
If for some reason you cannot file a bug through the ''Apport'' tool you can file one via [https://launchpad.net/distros/ubuntu/ Launchpad]. When doing so please ensure that you have determined which package it should be filed against. Read '[[UbuntuWiki:Bugs/FindRightPackage|finding|the right package]]' for guidance or use [[UbuntuHelp: http://launchpad.net/ubuntu/ | Launchpad's package search feature ]].  To file a bug against a specific package use a url similar to the following, `http://bugs.launchpad.net/ubuntu/+source/PACKAGENAME/+filebug?no-redirect`, where PACKAGENAME is the name of the source package about which you want to file the bug.  In the event that you want to request a piece of software be packaged for Ubuntu please follow the instructions in the [[UbuntuHelp: https://wiki.ubuntu.com/UbuntuDevelopment/NewPackages#Requesting_a_new_package_for_Ubuntu | wiki ]].
 +
To report a bug when you don't know the package name [https://bugs.launchpad.net/ubuntu/+filebug/?no-redirect]
 +
==== Adding Apport Debug Information to an Existing Launchpad Bug ====
 +
If you have already reported a bug directly via Launchpad, but want to add additional debugging information via ''Apport'' to the bug, you can do this by running the command `apport-collect bug_number` via "Run Application" or terminal window.
 +
=== Writing a useful report ===
 +
When a developer fixes a bug, they will test that the bug occurs, make a small change to the program, then see if the bug has gone away.  Depending on the bug, they might need to run the same test dozens or hundreds of times.  When you submit a bug report, it's important to specify three things:
 +
<ol><li>What you expected to happen
 +
</li><li>What actually happened
 +
</li><li>The minimal series of steps necessary to make it happen, where step 1 is "start the program"</li></ol>
  
Software contains flaws, called bugs. To keep track of bugs and their fixes, Ubuntu uses [https://bugs.launchpad.net/ubuntu Launchpad].
+
Fill in the description field with as much information as you can, including the release of Ubuntu you are using and steps for someone else to recreate the bug. It is better to have too much information in the description than not enough.
 
+
Only describe a single problem per bug report so that each can be followed up on in detail. If you experience several issues file separate reports.
'''If you want to help fixing bugs, please see HelpingWithBugs'''.
+
Add supporting attachments to explain or help others reproduce your bug. This might include a screenshot or video capture of the problem or a sample document that triggers the fault.  To add an attachment to the bug use the '''Include an attachment''' section of the bug form.  Additional attachments, if necessary, can be added after the bug is reported via '''Add a comment/attachment''' at the bottom of the page.
 
+
For anything hardware related, give precise details about your hardware. Attaching the output of "lspci -vvnn" and "dmesg", after a fresh boot, will help a lot.
=== Getting started ===
+
[[UbuntuHelp:[Top|Back to top]]]
 
+
== When not to file a bug ==
To create a Launchpad account, go [https://launchpad.net/distros/ubuntu/+bugs/+login here].
+
* '''Requesting new software''' you should follow the guidelines in https://wiki.ubuntu.com/UbuntuDevelopment/NewPackages
 
+
* '''Support requests''' should go to [https://answers.launchpad.net/ubuntu support requests in Launchpad], the [http://www.ubuntuforums.org/ Ubuntu forums], the [[UbuntuHelp:irc://irc.freenode.net/#ubuntu|#ubuntu]] channel on the [[UbuntuHelp:InternetRelayChat|Freenode|IRC]] server, or the [http://lists.ubuntu.com/mailman/listinfo/ubuntu-users ubuntu-users] mailing list.
=== Reporting bugs ===
+
* '''Feature and policy discussions''' (including suggestions to change defaults) should be discussed on the [http://lists.ubuntu.com/mailman/listinfo/ubuntu-devel-discuss ubuntu-devel-discuss] mailing list.
 
+
* '''Development ideas''' should be posted to http://brainstorm.ubuntu.com/ or discussed on the [http://lists.ubuntu.com/mailman/listinfo/ubuntu-devel-discuss ubuntu-devel-discuss] mailing list.
The first things you should look at are the following guides about deciding to file a bug or not.
+
* '''Already filed''' - Please check if it has already been reported by searching through the [https://launchpad.net/distros/ubuntu/+bugs existing bugs] and the release notes for your release of Ubuntu: [[UbuntuWiki:DapperReleaseNotes|6.06|(Dapper Drake)]], [http://www.ubuntu.com/getubuntu/releasenotes/804 8.04 (Hardy Heron)], [http://www.ubuntu.com/getubuntu/releasenotes/810 8.10 (Intrepid Ibex)], [http://www.ubuntu.com/getubuntu/releasenotes/904 9.04 (Jaunty Jackalope)], [http://www.ubuntu.com/getubuntu/releasenotes/910 9.10 (Karmic Koala)]. If you have further information about an already reported bug, add this information to the existing reported bug, instead of opening a new one.
 
+
[[UbuntuHelp:[Top|Back to top]]]
If you need help determining which package to file a bug about please read [http://wiki.ubuntu.com/Bugs/FindRightPackage finding the right package].
+
== Getting advice ==
 
+
If you need help in finding the right package or providing appropriate information ask someone on [[UbuntuHelp:irc://irc.freenode.net/#ubuntu-bugs|#ubuntu-bugs]] on the [[UbuntuHelp:InternetRelayChat|Freenode|IRC]] server or on the [https://lists.ubuntu.com/mailman/listinfo/Ubuntu-bugsquad bugsquad mailing list].
If you need help with debugging a problem, see [[UbuntuHelp:DebuggingProcedures]].
+
[[UbuntuHelp:[Top|Back to top]]]
 
+
== Other languages ==
If you need help with actually filing the bug, http://www.chiark.greenend.org.uk/~sgtatham/bugs.html has quite a lot of information on how to do it properly.
+
* [[UbuntuHelp:ReportingBugs_es|Spanish]]
 
+
* [http://www.ubuntu.ro/documentatie/comunitate/RaportareErori  Romanian]
==== When to file a bug ====
+
[[UbuntuHelp:[Top|Back to top]]]
 
+
== See Also ==
* You can repeat the problem
+
* [[UbuntuHelp: http://screencasts.ubuntu.com/2009/09/16/Reporting_Bugs | A screencast on using these tools ]] by Daniel Holbach
* It is not a feature of the program
+
* [http://www.chiark.greenend.org.uk/~sgtatham/bugs.html How to Report Bugs Effectively], by Simon Tatham
 
+
* [[UbuntuWiki:DebuggingProcedures|Debugging Procedures]]
==== When to not file a bug ====
+
[[UbuntuHelp:[Top|Back to top]]]
 
+
* Support requests should go to [https://answers.launchpad.net/ubuntu support requests in launchpad], the [http://www.ubuntuforums.org/ Ubuntu forums], the #ubuntu channel on the [https://help.ubuntu.com/community/InternetRelayChat Freenode IRC] server, or the [http://lists.ubuntu.com/mailman/listinfo/ubuntu-users ubuntu-users] mailing list.
+
* Feature and policy discussions should be discussed on the [http://lists.ubuntu.com/mailman/listinfo/ubuntu-devel ubuntu-devel] mailing list.
+
* Development ideas should be discussed on the [http://lists.ubuntu.com/mailman/listinfo/ubuntu-devel ubuntu-devel] mailing list.
+
 
+
==== Actually filing the bug ====
+
 
+
So, your bug is an actual bug. The first thing you should do is check if it has already been reported by searching through the [https://launchpad.net/distros/ubuntu/+bugs existing bugs] and the release notes for your version of Ubuntu. Release notes can be found at [http://wiki.ubuntu.com/DapperReleaseNotes Ubuntu 6.06 LTS] or [https://wiki.ubuntu.com/EdgyReleaseNotes#head-7348aa0831ef34256bdd066d1d9a1d112a4afa50 Ubuntu 6.10] or [http://www.ubuntu.com/getubuntu/releasenotes/704 Ubuntu 7.04].
+
 
+
If it has not been reported, then you can  [https://launchpad.net/distros/ubuntu/+filebug report a new bug]. Fill out a useful summary and select which program it happened in. If you do not know, read [https://wiki.ubuntu.com/Bugs/FindRightPackage finding the right package] or ask someone on #ubuntu-bugs on the [https://help.ubuntu.com/community/InternetRelayChat Freenode IRC] server. Then fill out the description with as much information as you can, including the version of Ubuntu you are using. It is better to have more information than too little. Once you have filled out the package name, summary and description, click on "Submit Bug Report". When entering your initial description of the bug it is not possible to add attachments.  However, after you have clicked "Submit Bug Report" it is then possible to add attachments. Unless you are experienced, it is best if you leave the other fields blank or with their default information. You are now done with your initial report but will mostly likely be contacted for more information about your bug.
+
 
+
* File the bug on one package only. If after reading [https://wiki.ubuntu.com/Bugs/FindRightPackage finding the right package] you still aren't positive, file it on "Ubuntu" but it may not receive attention as quickly.
+
* Do not file it in a release (Dapper/Edgy/Feisty), just on the source package in [https://launchpad.net/distros/ubuntu/+bugs Ubuntu].
+
* For anything hardware related, give precise details about your hardware. Attaching the output of "lspci -vv", "lspci -vvn" and "dmesg" will help.
+
* For display/X problems, always attach /etc/X11/xorg.conf and /var/log/Xorg.0.log.
+
 
+
NOTE: Most kubuntu specific packages are listed [https://launchpad.net/people/kubuntu-team/+packagebugs here]
+
 
+
===== English error messages =====
+
If you are getting error messages in a language other than English, it can often be helpful to put the English version of the message in the bug report. You can do this by running the program from a terminal with "LANGUAGE=C" before its name. For example, if "sudo apt-get update" is not working properly,
+
<pre><nowiki>
+
LANGUAGE=C sudo apt-get update
+
</nowiki></pre>
+
 
+
 
+
=== Bug triage ===
+
 
+
Bug triage is the act of cleaning up old bugs, solving some, and closing those which are incorrectly filed. Information on bug triage can be found at HelpingWithBugs.
+
 
+
[[category:CategoryDocumentation]] [[category:CategoryCleanup]]
+
  
 
[[category:UbuntuHelp]]
 
[[category:UbuntuHelp]]

2010年5月20日 (四) 00:02的最新版本

  1. title Reporting Bugs - HowTo

<<Anchor(Top)>> If you've come here when trying to file a bug about Ubuntu in Launchpad this was deliberate. Please read the following documentation regarding how to report a bug about Ubuntu.

Reporting bugs

Ubuntu uses Launchpad to keep track of bugs and their fixes. To file a bug you first need to create an account . Once you have an account you can use the tools we've provided you on your Ubuntu system to file bug reports. Note 1: If you use Kubuntu, please see the Kubuntu variant of this page here. Note 2: After the bug is reported, please always leave the Status set to New (Curious about bug status? Details here).

Use the menu - try this first!

Note: Since Lucid|Lynx this only works for the Development Releases, If you're running Lucid you might want to use the ubuntu-bug method. If you want to report a bug on an application that is running and responding, use the application's help menu: Help -> Report a problem. ReportingBugs?action=AttachFile&do=get&target=report-a-problem.png This method is preferable to filing a bug at the Launchpad website - it automatically attaches relevant information, which helps analyze the problem. If an application crashes, and you're using a version of Ubuntu which is actively under development, Apport will start automatically, raising an appropriate bug report for you to complete in Launchpad. This provides developers with rich debugging information that will make it easier to fix the problem. ReportingBugs?action=AttachFile&do=get&target=apport-1.png

Filing a bug with ubuntu-bug

If you can't file your report from the menu, for example:

  • You're using the Server Edition
  • The application doesn't have the appropriate menu item
  • The application won't start at all
  • Your problem is not related to an application but is an infrastructure component, such as the Linux kernel or graphics subsystem

You can still help us by using `ubuntu-bug`.

Ubuntu 8.10 and later

https://help.ubuntu.com/community/ReportingBugs?action=AttachFile&do=get&target=ubuntu-bug.png%7CFiling+a+bug+with+the+%22Run+Application%22+window

Press Alt+F2 to open the "Run Application" window, pictured above. Type `ubuntu-bug ``<package name>` and click Run. Server Edition users should use a terminal instead. If you're not sure which package has a problem, refer to the instructions for finding|the right package. To file a bug against a program that is currently running, go to System > Administration > System Monitor, and find the ID of the process. Server Edition users should use `ps aux`. https://help.ubuntu.com/community/ReportingBugs?action=AttachFile&do=get&target=system-monitor-id.png+%7C+System+Monitor+Processes+tab+ Then type the process ID instead of the package name into the "Run Application" window. https://help.ubuntu.com/community/ReportingBugs?action=AttachFile&do=get&target=ubuntu-bug-pid.png+%7C+Filing+a+bug+with+the+%22Run+Application%22+window+and+a+process+ID

Ubuntu 8.04 LTS to Ubuntu 9.04

In Ubuntu 8.04 LTS, you need to type `ubuntu-bug -p` (lowercase `p`) when reporting a bug about a package, or `ubuntu-bug -P` (capital `P`) when reporting a bug about a process ID. Instructions are otherwise identical to the above.

Ubuntu 9.10 and Later

You only need to type `ubuntu-bug PKGNAME` when reporting against a package, or `ubuntu-bug PID` when reporting a bug about a process ID. Instructions are otherwise identical to the above.

Filing bugs when off-line

In the event that you have a bug with your internet connection or want to file a bug for another system you can still do this using apport. Using the command `apport-cli -f -p` `<package name>` on the target system will collect information and provide you with an option to "K: Keep report file for sending later or copying to somewhere else". The report is then saved on the target system, in your /tmp directory which is cleared out on reboot, with a .apport extension. After copying it to a different system you can file that report using `ubuntu-bug ` `<location of apport file>`.

Filing translation bugs

All translation issues should be filed against the Ubuntu Translations project (ubuntu-translations). From there the bugs will be triaged and assigned to the right person and package. Here is a non-exhaustive list of problems that are appropriate for the Ubuntu Translations project:

  • Wrong translations or spelling mistakes in applications
  • Errors in spellcheckers or language support
  • A string from an application is not available for translation in Launchpad Translations
  • An application from the Ubuntu main repository is not available for translation in Launchpad Translations
  • A translation made in Launchpad Translations is not updated in the Ubuntu language packs
  • There is a duplicate translation template (the same application can be translated in two different places) in Launchpad Translations
  • A template/translation is no longer used in Ubuntu and should be disabled from Launchpad Translations

You can also consult the current bugs to see the big picture. In case of doubt, you can always contact|the Translations team.

Filing bugs at Launchpad.net

If for some reason you cannot file a bug through the Apport tool you can file one via Launchpad. When doing so please ensure that you have determined which package it should be filed against. Read 'finding|the right package' for guidance or use Launchpad's package search feature . To file a bug against a specific package use a url similar to the following, `http://bugs.launchpad.net/ubuntu/+source/PACKAGENAME/+filebug?no-redirect`, where PACKAGENAME is the name of the source package about which you want to file the bug. In the event that you want to request a piece of software be packaged for Ubuntu please follow the instructions in the wiki . To report a bug when you don't know the package name [1]

Adding Apport Debug Information to an Existing Launchpad Bug

If you have already reported a bug directly via Launchpad, but want to add additional debugging information via Apport to the bug, you can do this by running the command `apport-collect bug_number` via "Run Application" or terminal window.

Writing a useful report

When a developer fixes a bug, they will test that the bug occurs, make a small change to the program, then see if the bug has gone away. Depending on the bug, they might need to run the same test dozens or hundreds of times. When you submit a bug report, it's important to specify three things:

  1. What you expected to happen
  2. What actually happened
  3. The minimal series of steps necessary to make it happen, where step 1 is "start the program"

Fill in the description field with as much information as you can, including the release of Ubuntu you are using and steps for someone else to recreate the bug. It is better to have too much information in the description than not enough. Only describe a single problem per bug report so that each can be followed up on in detail. If you experience several issues file separate reports. Add supporting attachments to explain or help others reproduce your bug. This might include a screenshot or video capture of the problem or a sample document that triggers the fault. To add an attachment to the bug use the Include an attachment section of the bug form. Additional attachments, if necessary, can be added after the bug is reported via Add a comment/attachment at the bottom of the page. For anything hardware related, give precise details about your hardware. Attaching the output of "lspci -vvnn" and "dmesg", after a fresh boot, will help a lot. [[UbuntuHelp:[Top|Back to top]]]

When not to file a bug

[[UbuntuHelp:[Top|Back to top]]]

Getting advice

If you need help in finding the right package or providing appropriate information ask someone on #ubuntu-bugs on the Freenode|IRC server or on the bugsquad mailing list. [[UbuntuHelp:[Top|Back to top]]]

Other languages

[[UbuntuHelp:[Top|Back to top]]]

See Also

[[UbuntuHelp:[Top|Back to top]]]