How do I create a bug report

From Free Pascal wiki
Revision as of 16:26, 7 April 2011 by Zeljan (talk | contribs) (Enter the bug in the Lazarus Bug Tracker)

Afrikaans (af) Deutsch (de) English (en) français (fr) português (pt) русский (ru)

You found a bug in Lazarus and you want to report it to the developers. This page tells you how to do that.

Lazarus code compilation errors

If you have errors when compiling code from latest SVN revision, please contact the Mailing list or better join #lazarus-ide IRC channel on irc.freenode.net. Then the problem should be solved more promptly.

Check if the bug is not already reported

  1. Use search field in View Issues. Hint: The searching is not smart: e.g. if you have a problem using TEdit.SelStart, search for "SelStart".

If the same issue is already reported:

  • reopen it, if the bug report has been resolved or closed - use Reopen Issue button
  • add a note, if you have reproduce this bug in different situation than reported
  • you can set to monitor changes in this bug report - use Monitor Issue button

Note: you need to be logged-in to perform these operations, see section #Logging/Creating new account.

Enter the bug in the Lazarus Bug Tracker

  1. Go to the Lazarus bug tracker
  2. You need to be logged, see section #Logging/Creating new account
  3. Go to the Report Issue page. Fill in as much as you can and know. The more specific, the better.
    • Important fields are the OS and Product fields and the steps to reproduce this issue. If an issue cannot be reproduced by the developers, they cannot start to fix it! Do not forget to mention, if you are using some exotic PC architecture (big endian or 64-bit).
    • It is often useful to upload a small test application that shows the bug, and this speeds up correcting it.
    • If there is some graphical error, it is useful to upload a (partial) screenshot (in png or jpeg, not bmp format).
    • If it is a crash, try to create a backtrace. See Creating a Backtrace with GDB for more info.
    • You can try to reproduce the bug on as many different platforms as you can - it helps to determinate if it is widget specific issue.
    • You can boost fixing the bug by submitting a bounty, see Bounties.

The following page contains good tips about How to Report Bugs Effectively.

Logging/Creating new account

You need to be logged in to edit or submit bug reports. If you are logged in as guest, you need to log out first (Guests cannot make reports, only watch them). If you already have an account go to the login page, otherwise create a new account on the sign up page.

Attachments

If you're adding a text attachment for the bug report (source code or project sample), please use Zip, GZip or Tar.GZip archives.

Please don't use Rar, 7zip or others archives for bug reporting, since most of the modern OSes are usually need 3d party software to unpack them.