[Community Help Wiki] Update of "ReportingBugs" by popey
Help Ubuntu
webmaster at ubuntu.com
Tue Nov 18 15:42:33 UTC 2014
Dear Wiki user,
You have subscribed to a wiki page or wiki category on "Community Help Wiki" for change notification.
The "ReportingBugs" page has been changed by popey:
http://help.ubuntu.com/community/ReportingBugs?action=diff&rev1=270&rev2=271
Comment:
Move the list of "do not" to the bottom
<<Anchor(Top)>>
||<tablestyle="float:right; font-size: 0.9em; width:40%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;"><<TableOfContents>>||
+
+ = How to report bugs =
+
+ Ubuntu uses [[Launchpad]] to keep track of bugs and their fixes. This page will guide you through the steps required to file a good and detailed report.
+
+ == Create a Launchpad account ==
+
+ If you don’t already have one - you need to [[https://help.launchpad.net/YourAccount/NewAccount|create a Launchpad account]]. This will allow you to file new bugs and comment on existing ones.
+
+ == Determine if the bug is really a bug ==
+
+ You should not file a bug if you are:
+
+ * '''Requesting new software:''' you should follow the guidelines at https://wiki.ubuntu.com/UbuntuDevelopment/NewPackages
+ * '''Requesting support:''' there are a multitude of ways you can get help using Ubuntu, such as the [[https://answers.launchpad.net/ubuntu|Launchpad answer tracker]], the [[http://askubuntu.com/|Ask Ubuntu]] site, the [[http://www.ubuntuforums.org/|Ubuntu forums]], the [[irc://irc.freenode.net/#ubuntu|#ubuntu]] channel on the [[https://help.ubuntu.com/community/InternetRelayChat|Freenode IRC]] server, and the [[http://lists.ubuntu.com/mailman/listinfo/ubuntu-users|ubuntu-users]] mailing list.
+ * '''Discussing features and existing policy:''' this belongs to the [[http://lists.ubuntu.com/mailman/listinfo/ubuntu-devel-discuss|ubuntu-devel-discuss]] mailing list.
+ * '''Proposing features and ideas:''' you should submit your idea to the [[http://lists.ubuntu.com/mailman/listinfo/ubuntu-devel-discuss|ubuntu-devel-discuss]] mailing list.
+ * '''Filing a bug against a program not provided by an Ubuntu package:''' You should file a bug in that program's bug tracking interface. Instructions are generally available on the program's web site.
+
+ /!\ If you want to file a translation or misspelling bug, follow the instructions [[#translation|here]].
+
+ == Perform a survey of your problem ==
+
+ First, check the release notes for your version of Ubuntu:
+ * [[http://www.ubuntu.com/getubuntu/releasenotes/1004|Ubuntu 10.04 LTS (Lucid Lynx)]]
+ * [[http://www.ubuntu.com/getubuntu/releasenotes/1204|Ubuntu 12.04 LTS (Precise Pangolin)]]
+ * [[https://wiki.ubuntu.com/TrustyTahr/ReleaseNotes#Known_issues|Ubuntu 14.04 (Trusty Tahr)]] <<BR>>
+ Second, check Launchpad for any duplicates, and make note of this.
+
+ === Desktop Applications ===
+
+ For [[https://wiki.ubuntu.com/DebuggingProcedures#Desktop_Applications|desktop applications]], if you find an already reported bug that is exactly like the problem you have, please feel free to add this information to the existing report, rather than opening a new one. However, if you have any doubt as to it being the same or not, please file a separate report.
+
+ [[#Top|Back to top]]
+
+ == Reporting an application crash in the development release ==
+
+ Please report an application crash via the methods outlined below and at [[https://wiki.ubuntu.com/DebuggingProgramCrash]].
+
+ If an application crashes, and you're using a development release, Apport should start automatically, raising an appropriate bug report for you to complete in Launchpad. This report is subsequently processed by [[Apport Retracing Service]], in order to provide developers with debugging information that make it easier to fix the problem.
+
+ == Reporting an application crash in the stable release ==
+
+ Apport may come disabled by default. To enable it, edit the file:
+ {{{
+ /etc/default/apport
+ }}}
+
+ and change:
+ {{{
+ enabled=0
+ }}}
+
+ to:
+ {{{
+ enabled=1
+ }}}
+
+ /!\ Even when enabled, apport will not upload crash reports to Launchpad for a stable release (see [[https://bugs.launchpad.net/ubuntu/+source/apport/+bug/994921|bug #994921]]). Instead, crash reports are uploaded to [[http://errors.ubuntu.com]]. To file a report on Launchpad anyway, one may open the following file via a command line: {{{
+ gksudo gedit /etc/apport/crashdb.conf
+ }}} and change: {{{
+ 'problem_types': ['Bug', 'Package'],
+ }}} to: {{{
+ # 'problem_types': ['Bug', 'Package'],
+ }}}
+ Save, close, and try to file the crash report again via: {{{
+ ubuntu-bug /var/crash/_my_crash_report.crash
+ }}}
+
+ /!\ apport will appear to upload a crash report, but only actually does so if whoopsie is installed. Whoopsie is installed by default for users of ubuntu-desktop, but for users of alternative desktops, or for server users, whoopsie has to be installed manually with ''apt-get install whoopsie''. See [[https://bugs.launchpad.net/ubuntu/+source/xubuntu-meta/+bug/1001630|bug #1001630]] for details.
+
+ == Reporting a system crash ==
+
+ If your system lockups up, freezes, logs you out, etc., then this is not an application crash, but a system crash. Please see below, and consult the following article for these types of problems [[https://help.ubuntu.com/community/DebuggingSystemCrash]].
+
+ == Reporting non-crash hardware and desktop application bugs ==
+
+ 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 ===
+
+ Press Alt+F2 to open the “Run Command” screen:
+
+ ||<style="border: 1px solid black">{{attachment:unity-ubuntu-bug-pkgname.png|Filing a bug with the “Run Command” screen}}||
+
+ Then, type `ubuntu-bug <package name>` and press Enter. 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]].
+
+ === Collecting information about a program with a window open ===
+
+ If you want to file a bug about an application but you don't know what that application's package name is, if it has an open window you are in luck.
+
+ In a terminal execute the command 'ubuntu-bug -w'.
+
+ ||<style="border: 1px solid black">{{attachment:ubuntu-bug-w.png | terminal with ubuntu-bug -w }}||
+
+ After you close the dialog the next window that you click on will have a problem report created for the package that created the window.
+
+ === Collecting information from a currently running program ===
+
+ To file a bug against a program that is currently running, open the System Monitor application and find the ID of the process.
+
+ ||<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 Command” screen.
+
+ ||<style="border: 1px solid black">{{attachment:unity-ubuntu-bug-pid.png | Filing a bug with the “Run Command” screen and a process ID}}||
+
+ == Filing a general bug against no particular package ==
+
+ If you’re not sure which package is affected by the bug, type `ubuntu-bug` in the “Run Command” screen and press Enter. This will guide you through a series of questions to gather more information about the bug and help you assign it to the appropriate package.
+
+ [[#Top|Back to top]]
+
+ == Complete the bug report filing process ==
+
+ After running one of the above commands, Apport (the Ubuntu bug reporter) will gather information about the bug.
+
+ ||<style="border: 1px solid black">{{attachment:apport-1.png | Apport collecting information about the bug}}||
+
+ 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: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.
+
+ ||<style="border: 1px solid black">{{attachment:information-upload.png | Apport uploading the problem information}}||
+
+ ||<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. 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}}||
+
+ A search will then occur based on the title you gave to the bug report, and will show potentially similar ones. If one of these seems to be the exact bug you're reporting, click its title, then "Yes, this is the bug I'm trying to report". If not, click "No, I need to report a new bug".
+
+ ||<style="border: 1px solid black">{{attachment:bug-search.png | Launchpad search results about the bug title}}||
+
+ Launchpad will then ask you for further information. It's important that you specify three things:
+
+ 1. What you expected to happen
+ 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, 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 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 compromise your security or safety, as well as cause issues such as identity theft or "hi-jacking".
+ * '''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. If necessary, additional attachments can be added after the bug is reported via '''Add a comment/attachment''' at the bottom of the page. Please check [[https://wiki.ubuntu.com/DebuggingProcedures]] for anything further information to provide. It is vital for developers to get this information, as it contains the minimum requirement information necessary for a developer to begin working on your bug.
+ * Please note that if one files a bug against the [[https://launchpad.net/ubuntu/+source/linux|linux]] kernel package, you do not need to add as an attachment the terminal command:
+ {{{
+ lspci -vvnn
+ lspci -vnvn
+ }}}
+
+ This is due to how [[Launchpad]] automatically generates this as an additional attachment.
+
+ ||<style="border: 1px solid black">{{attachment:extra-options2.png | Launchpad presenting extra options}}||
+
+ When you're done, click "Submit bug report".
+
+ = Tips and tricks =
+
+ == Filing bugs when off-line ==
+
+ In the event that you have an issue with your Internet connection or want to file a bug for another system you can still do this using apport.
+
+ First, on the target system, gather the information in a file:
+
+ * For a bug report about a system crash:<<BR>>`apport-cli -p` ''`<package name>`'' `--save bug.crash`
+ * For a bug report about any other issue:<<BR>>`apport-cli -f -p` ''`<package name>`'' `--save bug.apport`
+
+ You will need to answer a few questions, which will vary depending on which package the bug report is about. Relevant system information, including the package name, is then saved on the target system, in the current directory. The extension indicates if it is a crash report or another kind of report. If you decide to rename the report file, please keep the `.apport` or `.crash` extension.
+
+ When the file is ready, copy it to the system you intend to use for filing the report. There you can then file the report:<<BR>>
+ `ubuntu-bug -c` ''`<apport_file.extension>`''
+
+ /!\ 'ubuntu-bug -c x.crash' does not work for crash reports from stable Ubuntu releases (see [[#Stable_release|note about stable releases above]]).
+
+ If this is to be added to an existing bug report, also use the -u option:<<BR>>
+ `ubuntu-bug -c` ''`<apport_file.extension>`'' `-u` ''`<bug number>`''
+
+ You will need to answer a few questions, and a web browser will be launched to complete the bug report. Please do not attach the `.apport` or `.crash` file to the report, as this is not the same as performing the above mentioned steps.
+
+ == Filing bugs at Launchpad.net ==
+
+ If for some reason you cannot file a bug using the ''Apport'' tool you can file one via [[https://bugs.launchpad.net/ubuntu/+filebug/?no-redirect | Launchpad's own bug report form]]. When doing so it is best if you have determined which package it should be filed against. Read '[[http://wiki.ubuntu.com/Bugs/FindRightPackage|finding the right package]]' for guidance or use [[ http://launchpad.net/ubuntu/ | Launchpad's package search feature ]]. We don't recommend this method for most bug reports because they will likely be missing crucial information, use ubuntu-bug if you can!
+
+ To file a bug against a specific package you can also use a URL like 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 report.
+
+ In the event that you want to request a piece of software be packaged for Ubuntu please follow the instructions in the [[ https://wiki.ubuntu.com/UbuntuDevelopment/NewPackages#Requesting%20a%20new%20package%20for%20Ubuntu | wiki ]].
+
+ == Crashes ==
+
+ If an application crashes, [[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.
+
+ ||<style="border: 1px solid black">{{attachment:apport-1.png}}||
+
+ == Error: The launchpadlib Python module is not installed ==
+
+ If one gets the following error while trying to perform apport-collect: {{{
+ ERROR: The launchpadlib Python module is not installed. This functionality
+ is not available.
+ }}} please install the following package: {{{
+ sudo apt-get -y install python-launchpadlib
+ }}}
+
+ === Package libreoffice not installed and no hook available, ignoring ===
+
+ If one attempts to apport-collect and gets the error message: {{{
+ Package libreoffice not installed and no hook available, ignoring
+ }}} one has to install the following package: {{{
+ sudo apt-get -y install libreoffice
+ }}}
+
+ === Crash reports ===
+
+ If your attachment is a crash report (ex. found in directory /var/crash), please do not attach it to an existing report. Instead, file a new report via a terminal so that [[https://help.ubuntu.com/community/ApportRetracingService|Apport Retracing Service]] may process it:
+ {{{
+ ubuntu-bug my_crash_report.crash
+ }}}
+
+ === Non-crash userspace bugs ===
+
+ Sometimes it is useful to take a picture (with a camera or via PrtSc button), or [[https://help.ubuntu.com/community/Screencast|screencast]] of the problem to demonstrate how you reproduced it, what the bug specifically shows, and the impact it has.
+
+ <<Anchor(translation)>>
+
+ == Filing a translation bug ==
+
+ You should file a translation bug if you are experiencing one of the following issues:
+
+ * Wrong translations or spelling mistakes for languages other than English in applications
+ * Errors in spellcheckers or language support
+ * A string from an application not available for translation in [[http://translations.launchpad.net/ubuntu|Launchpad Translations]]
+ * An application from the Ubuntu main repository not available for translation in [[http://translations.launchpad.net/ubuntu|Launchpad Translations]]
+ * A translation made in [[http://translations.launchpad.net/ubuntu|Launchpad Translations]] and not updated in the Ubuntu language packs
+ * 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 no longer used in Ubuntu and that should be disabled from [[http://translations.launchpad.net/ubuntu|Launchpad Translations]]
+ In case of doubt, you can always [[http://wiki.ubuntu.com/Translations/Contact|contact the Translations team]].
+
+ All translation issues should be filed against the [[https://bugs.launchpad.net/ubuntu-translations | Ubuntu Translations project]]. From there the bugs will be triaged and assigned to the right person and package.
+
+ [[#Top|Back to top]]
+
+ = Getting advice =
+
+ Still have doubts about the bug report filing process? You can ask someone on [[irc://irc.freenode.net/#ubuntu-bugs|#ubuntu-bugs]] on the [[https://help.ubuntu.com/community/InternetRelayChat|Freenode IRC]] server or on the [[https://lists.ubuntu.com/mailman/listinfo/Ubuntu-bugsquad|bugsquad mailing list]].
+
+ [[#Top|Back to top]]
= Bug reporting etiquette =
@@ -43, +300 @@
* '''Please do not solicit non-original reporters to post comments, attachments, etc.'''
* '''Please do not attach anything to another persons report.''' <<BR>> Adding undesired attachments when not asked by a triager or developer creates spammy E-Mail traffic for those subscribed, clutters up the bug report with undesired attachments, and hinders the bug getting addressed quickly. As well, your attachments are subject to deletion at the discretion of developers and triagers.
- = How to report bugs =
-
- Ubuntu uses [[Launchpad]] to keep track of bugs and their fixes. This page will guide you through the steps required to file a good and detailed report.
-
- == Create a Launchpad account ==
-
- If you don’t already have one - you need to [[https://help.launchpad.net/YourAccount/NewAccount|create a Launchpad account]]. This will allow you to file new bugs and comment on existing ones.
-
- == Determine if the bug is really a bug ==
-
- You should not file a bug if you are:
-
- * '''Requesting new software:''' you should follow the guidelines at https://wiki.ubuntu.com/UbuntuDevelopment/NewPackages
- * '''Requesting support:''' there are a multitude of ways you can get help using Ubuntu, such as the [[https://answers.launchpad.net/ubuntu|Launchpad answer tracker]], the [[http://askubuntu.com/|Ask Ubuntu]] site, the [[http://www.ubuntuforums.org/|Ubuntu forums]], the [[irc://irc.freenode.net/#ubuntu|#ubuntu]] channel on the [[https://help.ubuntu.com/community/InternetRelayChat|Freenode IRC]] server, and the [[http://lists.ubuntu.com/mailman/listinfo/ubuntu-users|ubuntu-users]] mailing list.
- * '''Discussing features and existing policy:''' this belongs to the [[http://lists.ubuntu.com/mailman/listinfo/ubuntu-devel-discuss|ubuntu-devel-discuss]] mailing list.
- * '''Proposing features and ideas:''' you should submit your idea to the [[http://lists.ubuntu.com/mailman/listinfo/ubuntu-devel-discuss|ubuntu-devel-discuss]] mailing list.
- * '''Filing a bug against a program not provided by an Ubuntu package:''' You should file a bug in that program's bug tracking interface. Instructions are generally available on the program's web site.
-
- /!\ If you want to file a translation or misspelling bug, follow the instructions [[#translation|here]].
-
- == Perform a survey of your problem ==
-
- First, check the release notes for your version of Ubuntu:
- * [[http://www.ubuntu.com/getubuntu/releasenotes/1004|Ubuntu 10.04 LTS (Lucid Lynx)]]
- * [[http://www.ubuntu.com/getubuntu/releasenotes/1204|Ubuntu 12.04 LTS (Precise Pangolin)]]
- * [[https://wiki.ubuntu.com/TrustyTahr/ReleaseNotes#Known_issues|Ubuntu 14.04 (Trusty Tahr)]] <<BR>>
- Second, check Launchpad for any duplicates, and make note of this.
-
- === Desktop Applications ===
-
- For [[https://wiki.ubuntu.com/DebuggingProcedures#Desktop_Applications|desktop applications]], if you find an already reported bug that is exactly like the problem you have, please feel free to add this information to the existing report, rather than opening a new one. However, if you have any doubt as to it being the same or not, please file a separate report.
-
- [[#Top|Back to top]]
-
- == Reporting an application crash in the development release ==
-
- Please report an application crash via the methods outlined below and at [[https://wiki.ubuntu.com/DebuggingProgramCrash]].
-
- If an application crashes, and you're using a development release, Apport should start automatically, raising an appropriate bug report for you to complete in Launchpad. This report is subsequently processed by [[Apport Retracing Service]], in order to provide developers with debugging information that make it easier to fix the problem.
-
- == Reporting an application crash in the stable release ==
-
- Apport may come disabled by default. To enable it, edit the file:
- {{{
- /etc/default/apport
- }}}
-
- and change:
- {{{
- enabled=0
- }}}
-
- to:
- {{{
- enabled=1
- }}}
-
- /!\ Even when enabled, apport will not upload crash reports to Launchpad for a stable release (see [[https://bugs.launchpad.net/ubuntu/+source/apport/+bug/994921|bug #994921]]). Instead, crash reports are uploaded to [[http://errors.ubuntu.com]]. To file a report on Launchpad anyway, one may open the following file via a command line: {{{
- gksudo gedit /etc/apport/crashdb.conf
- }}} and change: {{{
- 'problem_types': ['Bug', 'Package'],
- }}} to: {{{
- # 'problem_types': ['Bug', 'Package'],
- }}}
- Save, close, and try to file the crash report again via: {{{
- ubuntu-bug /var/crash/_my_crash_report.crash
- }}}
-
- /!\ apport will appear to upload a crash report, but only actually does so if whoopsie is installed. Whoopsie is installed by default for users of ubuntu-desktop, but for users of alternative desktops, or for server users, whoopsie has to be installed manually with ''apt-get install whoopsie''. See [[https://bugs.launchpad.net/ubuntu/+source/xubuntu-meta/+bug/1001630|bug #1001630]] for details.
-
- == Reporting a system crash ==
-
- If your system lockups up, freezes, logs you out, etc., then this is not an application crash, but a system crash. Please see below, and consult the following article for these types of problems [[https://help.ubuntu.com/community/DebuggingSystemCrash]].
-
- == Reporting non-crash hardware and desktop application bugs ==
-
- 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 ===
-
- Press Alt+F2 to open the “Run Command” screen:
-
- ||<style="border: 1px solid black">{{attachment:unity-ubuntu-bug-pkgname.png|Filing a bug with the “Run Command” screen}}||
-
- Then, type `ubuntu-bug <package name>` and press Enter. 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]].
-
- === Collecting information about a program with a window open ===
-
- If you want to file a bug about an application but you don't know what that application's package name is, if it has an open window you are in luck.
-
- In a terminal execute the command 'ubuntu-bug -w'.
-
- ||<style="border: 1px solid black">{{attachment:ubuntu-bug-w.png | terminal with ubuntu-bug -w }}||
-
- After you close the dialog the next window that you click on will have a problem report created for the package that created the window.
-
- === Collecting information from a currently running program ===
-
- To file a bug against a program that is currently running, open the System Monitor application and find the ID of the process.
-
- ||<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 Command” screen.
-
- ||<style="border: 1px solid black">{{attachment:unity-ubuntu-bug-pid.png | Filing a bug with the “Run Command” screen and a process ID}}||
-
- == Filing a general bug against no particular package ==
-
- If you’re not sure which package is affected by the bug, type `ubuntu-bug` in the “Run Command” screen and press Enter. This will guide you through a series of questions to gather more information about the bug and help you assign it to the appropriate package.
-
- [[#Top|Back to top]]
-
- == Complete the bug report filing process ==
-
- After running one of the above commands, Apport (the Ubuntu bug reporter) will gather information about the bug.
-
- ||<style="border: 1px solid black">{{attachment:apport-1.png | Apport collecting information about the bug}}||
-
- 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: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.
-
- ||<style="border: 1px solid black">{{attachment:information-upload.png | Apport uploading the problem information}}||
-
- ||<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. 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}}||
-
- A search will then occur based on the title you gave to the bug report, and will show potentially similar ones. If one of these seems to be the exact bug you're reporting, click its title, then "Yes, this is the bug I'm trying to report". If not, click "No, I need to report a new bug".
-
- ||<style="border: 1px solid black">{{attachment:bug-search.png | Launchpad search results about the bug title}}||
-
- Launchpad will then ask you for further information. It's important that you specify three things:
-
- 1. What you expected to happen
- 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, 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 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 compromise your security or safety, as well as cause issues such as identity theft or "hi-jacking".
- * '''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. If necessary, additional attachments can be added after the bug is reported via '''Add a comment/attachment''' at the bottom of the page. Please check [[https://wiki.ubuntu.com/DebuggingProcedures]] for anything further information to provide. It is vital for developers to get this information, as it contains the minimum requirement information necessary for a developer to begin working on your bug.
- * Please note that if one files a bug against the [[https://launchpad.net/ubuntu/+source/linux|linux]] kernel package, you do not need to add as an attachment the terminal command:
- {{{
- lspci -vvnn
- lspci -vnvn
- }}}
-
- This is due to how [[Launchpad]] automatically generates this as an additional attachment.
-
- ||<style="border: 1px solid black">{{attachment:extra-options2.png | Launchpad presenting extra options}}||
-
- When you're done, click "Submit bug report".
-
- = Tips and tricks =
-
- == Filing bugs when off-line ==
-
- In the event that you have an issue with your Internet connection or want to file a bug for another system you can still do this using apport.
-
- First, on the target system, gather the information in a file:
-
- * For a bug report about a system crash:<<BR>>`apport-cli -p` ''`<package name>`'' `--save bug.crash`
- * For a bug report about any other issue:<<BR>>`apport-cli -f -p` ''`<package name>`'' `--save bug.apport`
-
- You will need to answer a few questions, which will vary depending on which package the bug report is about. Relevant system information, including the package name, is then saved on the target system, in the current directory. The extension indicates if it is a crash report or another kind of report. If you decide to rename the report file, please keep the `.apport` or `.crash` extension.
-
- When the file is ready, copy it to the system you intend to use for filing the report. There you can then file the report:<<BR>>
- `ubuntu-bug -c` ''`<apport_file.extension>`''
-
- /!\ 'ubuntu-bug -c x.crash' does not work for crash reports from stable Ubuntu releases (see [[#Stable_release|note about stable releases above]]).
-
- If this is to be added to an existing bug report, also use the -u option:<<BR>>
- `ubuntu-bug -c` ''`<apport_file.extension>`'' `-u` ''`<bug number>`''
-
- You will need to answer a few questions, and a web browser will be launched to complete the bug report. Please do not attach the `.apport` or `.crash` file to the report, as this is not the same as performing the above mentioned steps.
-
- == Filing bugs at Launchpad.net ==
-
- If for some reason you cannot file a bug using the ''Apport'' tool you can file one via [[https://bugs.launchpad.net/ubuntu/+filebug/?no-redirect | Launchpad's own bug report form]]. When doing so it is best if you have determined which package it should be filed against. Read '[[http://wiki.ubuntu.com/Bugs/FindRightPackage|finding the right package]]' for guidance or use [[ http://launchpad.net/ubuntu/ | Launchpad's package search feature ]]. We don't recommend this method for most bug reports because they will likely be missing crucial information, use ubuntu-bug if you can!
-
- To file a bug against a specific package you can also use a URL like 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 report.
-
- In the event that you want to request a piece of software be packaged for Ubuntu please follow the instructions in the [[ https://wiki.ubuntu.com/UbuntuDevelopment/NewPackages#Requesting%20a%20new%20package%20for%20Ubuntu | wiki ]].
-
- == Crashes ==
-
- If an application crashes, [[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.
-
- ||<style="border: 1px solid black">{{attachment:apport-1.png}}||
-
- == Error: The launchpadlib Python module is not installed ==
-
- If one gets the following error while trying to perform apport-collect: {{{
- ERROR: The launchpadlib Python module is not installed. This functionality
- is not available.
- }}} please install the following package: {{{
- sudo apt-get -y install python-launchpadlib
- }}}
-
- === Package libreoffice not installed and no hook available, ignoring ===
-
- If one attempts to apport-collect and gets the error message: {{{
- Package libreoffice not installed and no hook available, ignoring
- }}} one has to install the following package: {{{
- sudo apt-get -y install libreoffice
- }}}
-
- === Crash reports ===
-
- If your attachment is a crash report (ex. found in directory /var/crash), please do not attach it to an existing report. Instead, file a new report via a terminal so that [[https://help.ubuntu.com/community/ApportRetracingService|Apport Retracing Service]] may process it:
- {{{
- ubuntu-bug my_crash_report.crash
- }}}
-
- === Non-crash userspace bugs ===
-
- Sometimes it is useful to take a picture (with a camera or via PrtSc button), or [[https://help.ubuntu.com/community/Screencast|screencast]] of the problem to demonstrate how you reproduced it, what the bug specifically shows, and the impact it has.
-
- <<Anchor(translation)>>
-
- == Filing a translation bug ==
-
- You should file a translation bug if you are experiencing one of the following issues:
-
- * Wrong translations or spelling mistakes for languages other than English in applications
- * Errors in spellcheckers or language support
- * A string from an application not available for translation in [[http://translations.launchpad.net/ubuntu|Launchpad Translations]]
- * An application from the Ubuntu main repository not available for translation in [[http://translations.launchpad.net/ubuntu|Launchpad Translations]]
- * A translation made in [[http://translations.launchpad.net/ubuntu|Launchpad Translations]] and not updated in the Ubuntu language packs
- * 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 no longer used in Ubuntu and that should be disabled from [[http://translations.launchpad.net/ubuntu|Launchpad Translations]]
- In case of doubt, you can always [[http://wiki.ubuntu.com/Translations/Contact|contact the Translations team]].
-
- All translation issues should be filed against the [[https://bugs.launchpad.net/ubuntu-translations | Ubuntu Translations project]]. From there the bugs will be triaged and assigned to the right person and package.
-
- [[#Top|Back to top]]
-
- = Getting advice =
-
- Still have doubts about the bug report filing process? You can ask someone on [[irc://irc.freenode.net/#ubuntu-bugs|#ubuntu-bugs]] on the [[https://help.ubuntu.com/community/InternetRelayChat|Freenode IRC]] server or on the [[https://lists.ubuntu.com/mailman/listinfo/Ubuntu-bugsquad|bugsquad mailing list]].
-
- [[#Top|Back to top]]
= Other languages =
More information about the Ubuntu-bugsquad
mailing list