Latest Posts

Changes in How to Write a Good Bug Report

Revision Differences of Revision 16

AFor very gooin-depth guidelines (fromn theow perspective of a reprogrammer) and to bugets in an ideway thabout bugassists rthe progrtingammer, itschelf,ck you can readt this (long) [article](http://www.chiark.greenend.org.uk/~sgtatham/bugs.html). ¶

If you are not an native eEnglish spreakder (like me), there are diffa numberen of opt laionguages: ¶

English | Português | 简体中文 | Česky | Dansk | Deutsch | Español | Français | Magyar | Italiano | 日本語 | Nederlands | Polski | Русский | 繁體中文 ¶


. ¶


##0. The easiest way to report a bug is to open upcraft a bug report at [Launchpad](https://bugs.launchpad.net/widelands). ¶

You will need to have a Log-In on Launchpad. ¶

On the right hand side are two possibiliptieons: ¶

* Report a bug ¶
* Ask a question ¶

TherBefore you wfill ineedg an account ona LaBunchg Repad! ¶

Jusort, fill outse the head line and 'sSearch' - maybe other bfugs ncomtiong upto soee if your probuglem whas alreporteady sombe timen agoddressed. ¶

If your bug is not listed or nothing was found, please fill out the free form with the needed information (see below), then scroll down and attach files. (aDo ndot forget to add the proper tags). ¶

SFomer more help specificaboully with Launchpad, can you ghetck [here](https://help.launchpad.net/Bugs). ¶


If you fearel unotable okayr unwilling tho use tLanchispad, report the bug on tour forum under "Technical Help" - Link: https://wl.widelands.org/forum/forum/1/ (btw. the internal Link description is wrong!) ¶

##1. We need mandatALL oryf the following details abnfourmation ytou try coanfigud addraess tihe pronblem: ¶


* Operating System (OS) and patch level/kernel: ¶
* e. g.: Windows XP SP3 ¶
* e. g.: Xubuntu 12.04.3, Linux xubuntu 3.8.0-35-generic #52~precise1-Ubuntu SMP Thu Jan 30 17:24:40 UTC 2014 x86_64 x86_64 x86_64 GNU/Linux ¶


* Widelands release: ¶
* e. g.: 17 ¶
* e. g.: bzr6826 ¶
* e. g.: 1:17-ppa0-bzr6827-201402020556~ubuntu12.04.1 ¶


##2. Describe the error / bug / false behavior as spexcificactlly as possible: ¶

* AThink meaningfboult your headline; wtry tould be succinct as goodwell ias deascriptive. ¶

* Describe what you have doid aned what yoru expected and whato happen, as wedll inas what actually occurread,. pleAgase in, be descriptailve, but try not ato write the next installment of A Song of Icoe and TLotR/BFiblre:.

* e. g.: wanted to attack the enemy -> no soldier attacks / game crashed while opening up statistic details ¶


##2a. If you have trouble with the hardware/ plu-ins (graphics, music, sound, .etc.. add), thbe hasure to indwicarte althiso in the bug report or as an attachment: ¶

* Mainboard and CPU ¶
* RAM ¶
* Graphics card ¶
* SSD/HDD and extraordinary configuration (RAID ?; LVM2 ?; ...) ¶
* Network card (?) ¶
* Sound card (?) ¶

* e. g.: Gigabyte GA-MA790GP-UD4H F7c w/ AMD Phenom II X4 810 + 2× 2×2048 MB AData DDR2 800 MHz; Gigabyte GV-R667D3-2GI; 64 GB AData SP900 /; 2×1 TB Seagate ST31000523AS /home (LVM2) + 1.5 TB Seagate ST31500521AS /pub; Pioneer BDR-208DBK ¶

If you do NOTnot know the exactly pwhiech hardware elements of you are machreferrineg to, loocheck either following:

* in the system management (Start --> Execute... --> compmgmt.msc --> Device Manager --> ) ¶

* or in a Terminal by typing "sudo lshw > lshw.txt" ¶


##3. Attach save games and/or replays: ¶
You. The willay to findo themis is dependent on your OS:


###3a. Apple Operating Systems: ¶


* Mac OS X: ¶


###3b. Microsoft Operating Systems: ¶

* Windows XP/Vista: C:\\Documents\\[username]\\.widelands ¶

* Windows 7: ¶

* Windows 8 (if you have NOT upgraded to 8.1): ¶

* Windows 8.1: ¶


###3c. GNU/Linux: ¶


* /home/[username]/.widelands ¶
* tested with Ubuntu and Fedora ¶


##4. If you had an crash, attach the file to the bug report. The path differs according to your OS: ¶

* Mac OS X: ¶

* Microsoft OSe's: C:\\Programs\\Widelands\\stdout.txt ¶

* GNU/Linux: ¶


##5. Still have more questions about bug reporting? ¶

Cannot findgure anythingt out on the damn machine? Struggling with my bad eEnglish/ this guide? ¶

Try in this order: ¶

* search in the Forums ¶
* search on Launchpad for questions ¶
* ask them on chat ¶
* ....raise hands in despair, fall on the floor, watch as everyone else becomes a dinosaur