'''''Translations of this page:''''' not yet ported. Translators, please see Discussion page. This page is for notes on how to use Bugzilla to report and triage bugs. There is also some generic information on [http://bugs.winehq.org/page.cgi?id=bug-writing.html writing good bug reports.] === When to report a bug === You should report a bug when: * Wine doesn't run a program the same way as Windows does (e.g. crashes) with the default Wine configuration (i.e. no dlls from Windows, or DllOverrides set). * You are using the '''latest ''development'' version''' of Wine (not stable) (See [https://www.winehq.org/download downloads] for information on how to get the latest). * You tested with a '''clean''' Wine directory (default location: "~/.wine", z: drive -> / link exists, no DLL overrides). * You [[Wine_User%27s_Guide#How_to_install_and_run_Windows_programs|installed and ran]] the application using Wine, not on your Windows installation. * Your system isn't at fault (system hangs/lockups that require a system reboot are usually driver problems). * Your system has all the libraries that Wine needs. * You haven't modified Wine in any way; i.e. you are using a prepackaged binary without any custom patches or modifications or have built from the official WineHQ source by doing: ./configure ; make depend ; make * You are '''not''' using a third party wrapper for Wine (e.g., Crossover, PlayOnLinux, PlayOnMac, Wineskin, Q4Wine, etc.) or custom patches. * You have searched [http://bugs.winehq.org bugzilla], and the problem hasn't been reported already. Check [[Known Issues]] as well. * Also search for the application in the [http://appdb.winehq.org AppDB] and look at the bug links for that application, as it could be already reported. === How to report === Each bug report should cover '''''one''''' problem. If there are additional problems with the same application or game, file separate reports for each. If a similar problem appears with multiple applications or games, file separate reports for each. No, really. Even though it may look the same to you, the underlying problem is likely different. If it really is the same, we'll resolve the report as duplicate afterward. Go to [http://bugs.winehq.org Bugzilla], login, and click [http://bugs.winehq.org/enter_bug.cgi?product=Wine Enter bug, then Wine]. * Put the name of the application in the '''Summary''' field, followed by a short description of the error, e.g. WinZip 7: crashes when extracting a zip archive : Use a summary explaining the bug symptoms and the name ''and version'' of the program that displays them, not what you think the problem is, so that: :* Users can find duplicates :*The problem can be marked as solved by checking that the symptom is gone :*The bug remains valid even if your analysis is incorrect * Describe the bug in the '''Comments''' field, e.g. how to make the crash happen: Wine crashes when I click on the Extract button on the toolbar in WinZip 7.01 :If you have any clues as to what the problem is, write them in here. Don't paste too much information in the comments field, just what looks relevant. '''Do not paste''' backtraces or error logs in the comments field ('''attach''' them instead). For bugs related to graphics, sound, and hardware devices, be sure to write down what hardware and drivers you're using. :[http://bugs.winehq.org/show_bug.cgi?id=7661#c0 Here is an example of what NOT to do] * Set Product to Wine and '''specify''' '''Wine''' '''version''' you are using, if in doubt run `wine --version`. If you are using wine-staging, mention this in the comments. * Provide a download link to a free version of the program / program installer that shows the bug if possible, e.g. http://download.winzip.com/ngs/winzip175.exe :The download link should point to the ''exact'' program version you encountered the bug with (to improve reproducibility). Ideally also provide a SHA1 checksum of the installation file, along with the filename, e.g. $ sha1sum winzip175.exe 885c7e4ea128351e5fe325d98344f27a46222d73 winzip175.exe :This makes it easier for other people to try to reproduce the bug using the same program version, especially when the original download link is broken and it has to be retrieved elsewhere. * Attach [[FAQ#How can I get a debugging log (a.k.a. terminal output)?|'''complete terminal output''']] to the bug. Please '''do not paste''' [[winedbg|backtraces]] or error logs in the comments field, but ''attach'' them to your bug report (use a `.txt` file extension, or set MIME type to `text/plain`). If a file is large, compress it first (e.g. with gzip or xz). If you have many files to upload (i.e. more than two), please use an archive (e.g. tar) rather than uploading them all individually. Also, please do not paste to the Wiki, AppDB, or the IRC channel. A trace may be temporarily stored at a [http://en.wikipedia.org/wiki/Pastebin Pastebin] so it can be referred to on IRC (it should still be attached to the bug report itself so everything is archived in one place).
* Set the importance to ** '''Trivial''' for a UI glitch that doesn't affect running of a program **'''Minor''' for minor loss of functionality, or other problem where an easy workaround is present ** '''Normal''' for an application crash or other issue ** '''Major''' for major loss of functionality for a wide range of applications ** '''Critical''' for a critical problem that prevents '''all''' applications from working ** '''Blocker''' when development and/or testing work cannot be done :For the above example, the severity is '''Normal'''. Severity levels above Normal should only be set by experienced users or bugzilla admins, and are not even necessary for 99% of issues. Also, after making your initial report, please leave changing the bug's severity to someone with admin permissions. * After you have submitted your bug, please add it to the appropriate [http://appdb.winehq.org AppDB] page(s). If there is no entry in the [http://appdb.winehq.org AppDB] for an application, it might be helpful to add one (though that is not required for the bug report). === Do's and Don'ts === '''Don't:''' :{{x mark|red|150}}Change the reported version. It should reflect the earliest version of Wine that had the bug. Don't update it every time you test for the bug. :{{x mark|red|150}}Attach large files such as executables unless they are explicitly requested (link to a legitimate download page instead) :{{x mark|red|150}}Use pirated/cracked software. :{{x mark|red|150}}Post links to file-sharing websites to download executables instead of the developer's site. :{{x mark|red|150}}Ask when the bug will be fixed. If a fix is in progress, it'll likely be posted in the bug. :{{x mark|red|150}}Close fixed bugs. We'll close it whenever the next release is made. :{{x mark|red|150}}cc yourself to bugs you have reported (the system will notify you of updates regardless) or reply to email notifications of bug updates (add your comment using the webpage). === Bugzilla Policies === Some general policies for WineHQ's [http://bugs.winehq.org/describekeywords.cgi Bugzilla]: * Bug reporters are expected to check their bug on newer Wine versions periodically (3-6 months) and to update the bug if it's fixed or still present. If it's still present, simply a comment saying still in wine-x.y.z is enough. If the behavior of the bug has changed in any way, please update the bug with that info as well as an updated log. * The NEEDINFO status should be used for bugs where: **the reporter did not provide enough information to act on (missing program name, no terminal output, etc.), **there has been no comment on the bug within 1 year AND no download is available to test (or the download is not enough on its own, e.g., a login is required). * Bugs that are NEEDINFO for one year will be CLOSED ABANDONED. * Please don't CC yourself on EVERY bug, this spams a lot of people. Users who do this are subject to a ban. If you want to watch all bugs, subscribe to wine-bugs at https://www.winehq.org/mailman/listinfo/wine-bugs * All Wine developers are entitled to bugzilla triage permissions. If you don't have them, contact [[User:Austin987|AustinEnglish]] or send an email to bugs-admin@winehq.org === See Also === * [[Known Issues]] * [[Bug Triage]] ---- [[Category:Quality Assurance]]