[Community Ubuntu Documentation] Update of "ReportingBugs" by brian-murray
Help Ubuntu
webmaster at ubuntu.com
Wed Mar 7 22:18:27 UTC 2012
Dear Wiki user,
You have subscribed to a wiki page or wiki category on "Community Ubuntu Documentation" for change notification.
The "ReportingBugs" page has been changed by brian-murray:
http://help.ubuntu.com/community/ReportingBugs?action=diff&rev1=167&rev2=168
Comment:
Add new pictures, remove printing information since it isn't relevant, fix some typos
== 4. Collect information about the bug ==
- The method of reporting bugs in Ubuntu is by using the tool "ubuntu-bug", otherwise known as '''Apport'''. When reporting a bug, you must tell Apport which program or [[https://help.ubuntu.com/community/InstallingSoftware#What%20is%20a%20package?|package]] is at fault.
+ The method for reporting bugs in Ubuntu is by using the tool "ubuntu-bug", otherwise known as '''Apport'''. When reporting a bug, you must tell Apport which program or [[https://help.ubuntu.com/community/InstallingSoftware#What%20is%20a%20package?|package]] is at fault.
=== Collecting information from a specific package ===
- ||<style="border: 1px solid black">{{attachment:ubuntu-bug.png|Filing a bug with the "Run Application" window}}||
+ ||<style="border: 1px solid black">{{attachment:unity-ubuntu-bug-pkgname.png|Filing a bug with the "Run Application" window}}||
Press Alt+F2 to open the "Run Application" window, pictured above. Type `ubuntu-bug `''`<package name>`'' and click ''Run''. If you're not sure which package has the problem,
refer to the instructions for [[https://wiki.ubuntu.com/Bugs/FindRightPackage|finding the right package]].
@@ -61, +61 @@
To file a bug against a program that is currently running, go to '''System > Administration > System Monitor''', and find the ID of the process.
- ||<style="border: 1px solid black">{{attachment:system-monitor-id.png | System Monitor Processes tab }}||
+ ||<style="border: 1px solid black">{{attachment:system-monitor-id-new.png | System Monitor Processes tab }}||
Then type "ubuntu-bug " followed by the process ID into the "Run Application" window.
- ||<style="border: 1px solid black">{{attachment:ubuntu-bug-pid.png | Filing a bug with the "Run Application" window and a process ID}}||
+ ||<style="border: 1px solid black">{{attachment:unity-ubuntu-bug-pid.png | Filing a bug with the "Run Application" window and a process ID}}||
=== Filing a general bug against no particular package ===
@@ -81, +81 @@
A window will then pop up, asking you if you want to report the bug. Click "Send Report" if you wish to proceed, or click "Content of the report" if you want to review the information Apport collected.
- ||<style="border: 1px solid black">{{attachment:send-problem-question.png | Apport asking you to send the report}}||
+ ||<style="border: 1px solid black">{{attachment:apport-problem-report.png | Apport asking you to send the report}}||
Apport will then upload the problem information to Launchpad, and a new browser window will then open to inform you that the bug report is being processed.
@@ -89, +89 @@
||<style="border: 1px solid black">{{attachment:process-data2.png | Launchpad processing the bug report data}}||
- After the bug report data has been processed, a new page will open that will ask you for the bug report's title. When you're done, click "Next".
+ After the bug report data has been processed, a new page will open that will ask you for the bug report's title. The bug title will appear in all bug listings so make sure it represents the bug well. When you're done, click "Next".
||<style="border: 1px solid black">{{attachment:bug-title2.png | Launchpad asking for a bug title}}||
@@ -103, +103 @@
1. What actually happened
1. If possible, a 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.
+ Fill in the description field with as much information as you can, it is better to have too much information in the description than not enough.
||<style="border: 1px solid black">{{attachment:more-informations2.png | Launchpad asking for further information}}||
- At then bottom of the page, there is some extra options you can use to make your bug report more complete:
+ At then bottom of the page, there are some extra options you can use to make your bug report more complete:
* '''This bug is a security vulnerability:''' Please check this '''''only''''' if your bug report describes a behaviour that could be exploited to crack your system. (TODO: better wording?)
- * '''Tags:''' You can add here [[http://wiki.ubuntu.com/Bugs/Tags|tags]] that pertain to your bug report. The predefined values are fine most of the time.
+ * '''Tags:''' You can add here [[http://wiki.ubuntu.com/Bugs/Tags|tags]] that pertain to your bug report. The predefined values should be left alone.
* '''Include an attachment:''' Using this option, you can add supporting attachments to explain or help others reproduce the bug. This might include a screenshot, a video capture of the problem or a sample document that triggers the fault. Additional attachments, if necessary, can be added after the bug is reported via '''Add a comment/attachment''' at the bottom of the page.
||<style="border: 1px solid black">{{attachment:extra-options2.png | Launchpad presenting extra options}}||
When you're done, click "Submit bug report".
-
- = Printing Problems =
-
- For information about printing problems and debugging them, please see [[https://wiki.ubuntu.com/DebuggingPrintingProblems|the printing debugging page]]
= Tips and tricks =
@@ -158, +154 @@
{{attachment: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.
+ This method is preferable to filing a bug at the Launchpad website - it will automatically attach relevant information, which helps analyze the problem.
If an application crashes, and you're using a version of Ubuntu which is actively under development, [[https://wiki.ubuntu.com/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.
More information about the Ubuntu-bugsquad
mailing list