User Tools

Site Tools


reporting_bugs

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
reporting_bugs [2015/07/20 11:51]
be.ing [Reporting Bugs]
reporting_bugs [2018/10/05 17:59]
rryan Add info about ubuntu-bug and /var/crash/ on Ubuntu.
Line 1: Line 1:
 ====== Reporting Bugs ====== ====== Reporting Bugs ======
 +If you think you've found a bug in the software, first make sure you're using the latest version from www.mixxx.org,​ then **check the [[Troubleshooting]] page and the [[http://​mixxx.org/​forums|forums]]** to see if there is a known solution or workaround or if other people are having the same problem.
  
-If you think you've found a bug in the software, first make sure you're using the latest version from www.mixxx.org,​ then **check the [[FAQ]], the [[Troubleshooting]] page and the [[http://mixxx.org/forums|forums]]** to see if there is a known solution ​or workaround or if other people are having ​the same problem.+If you don't find anything there, our bug tracking system is hosted on [[https://bugs.launchpad.net/mixxx|Launchpad]]. First try a few searches on various keywords related to the problem ​to see if it's already been reported and what the current status ​is. If you find one or more that relate, click change on "This bug doesn'​t affect me" to "​vote"​ for the bug (you may need to sign in to see this.)
  
-If you don't find anything thereour bug tracking system is located at [[https://​bugs.launchpad.net/​mixxx]]. ​First try a few searches on various keywords related to the problem to see if it's already been reported and what the current status is. If you find one or more that relate, click change on "This bug doesn'​t affect me" to "​vote"​ for the bug (you may need to sign in to see this.) +If no existing bugs cover your issueplease gather the following information to report ​[[https://​bugs.launchpad.net/​mixxx/+filebug|a new bug on Launchpad]].
- +
-If no existing bugs cover your issue, please gather the following information:​+
  
   * Steps to reproduce the problem. **Please be as detailed as you can be.** For example, rather than saying "Foo doesn'​t work", say "When I clicked on the Bar button, Foo did not put the Bazes in the right place. I expected the Bazes to be put in Folder 1, but instead Mixxx put them in Folder 2." If you cannot write well in English, please write your description in both English and another language you are more comfortable writing in.   * Steps to reproduce the problem. **Please be as detailed as you can be.** For example, rather than saying "Foo doesn'​t work", say "When I clicked on the Bar button, Foo did not put the Bazes in the right place. I expected the Bazes to be put in Folder 1, but instead Mixxx put them in Folder 2." If you cannot write well in English, please write your description in both English and another language you are more comfortable writing in.
Line 12: Line 11:
   * Your video and sound hardware (Brands, models, options, etc.)   * Your video and sound hardware (Brands, models, options, etc.)
   * [[reporting_bugs#​gathering_logs|Information logs]]   * [[reporting_bugs#​gathering_logs|Information logs]]
 +  * Screenshots of the bug, if applicable
  
 Much of the system information can be gathered from System Information in Windows (found under Control Panel->​Administrative Tools->​Computer Management->​System Information,​) and with the commands uname -a and lspci -v on Linux. Much of the system information can be gathered from System Information in Windows (found under Control Panel->​Administrative Tools->​Computer Management->​System Information,​) and with the commands uname -a and lspci -v on Linux.
Line 18: Line 18:
  
 Obtain the following information and add it as an attachment to your bug report: Obtain the following information and add it as an attachment to your bug report:
 +
 +==== Ubuntu ====
 +
 +On Ubuntu, if Mixxx crashes and Ubuntu asks if you would like to report the problem, please click report. We receive these crash reports, and they are quite useful.
 +
 +If you are filing a bug, see if you have a crash report, stored in ''/​var/​crash'',​ and if you find one for Mixxx, please attach it to your bug report. If you don't find an error report, please use the ''​ubuntu-bug''​ tool to create an error report. From a terminal, or by pressing ''​Alt + F2''​ to invoke the run dialog, enter:
 +
 +<​code>​
 +ubuntu-bug mixxx --save mixxx.crash
 +</​code>​
 +
 +This will create a mixxx.crash file in your home directory which you can attach to the bug report you file on our [[https://​bugs.launchpad.net/​mixxx|Bug Tracker]]. However, since this isn't a crash from an actual run of Mixxx, it will not contain details on your specific bug -- just background information about your system that will be useful to us. If you are reporting a crash bug, it would be useful if you could include a crash report from ''/​var/​crash''​ from a time when Mixxx actually crashed. Additionally,​ see below about generating backtraces. Crash reports sometimes include backtraces, but if you collect one yourself it may be more informative.
  
 ==== Linux & Mac OSX ==== ==== Linux & Mac OSX ====
reporting_bugs.txt · Last modified: 2018/10/05 17:59 by rryan