How do I create a bug report

This is an old revision of How do I create a bug report, edited by Jdlinke at . The current revision is 27874.

This document contains some guidelines for using the Lazarus bug tracker as a reporter. This document is written for Lazarus users, who identify bugs, have recommendations, want to submit patches, or find other issues and want to report these to the Lazarus development team.

The FreePascal bug reporting procedure is similar to the one described here.

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 the 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 issue is already reported:

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 Lazarus bug tracker
  2. You need to be logged in, 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 your specific architecture/configuration (32 or 64 bit, little or big endian if both are possible on your platform, version of your operating system).
    • If possible, please upload a small test application that shows the bug. This will likely speed up a fix.
    • 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 determine if it is widget specific issue.
    • If you have a possible solution, you can add a patch - see Creating A Patch, which will speed up the process.
    • 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 in / 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.

What should be submitted via the Bug Tracker?

Please note: The Bug Tracker is not designed to field questions. These should be directed toward the Forums http://forum.lazarus.freepascal.org/.

Submitting Bugs

As when submitting any report, please be sure to include as much useful information as possible. In addition to the various prompts and text boxes available on the "Report Issue" page http://bugs.freepascal.org/bug_report_page.php, if may be helpful to upload a sample of code or a project that demonstrates the bug you are experiencing so that others can replicate, identify, and fix it.

If you are able to correct the problem, you should Submit a patch (Creating A Patch).

Submitting Suggestions

(I will work on this shortly, or feel free to add to it yourself -jdlinke)

Submitting Improvements

(I will work on this shortly, or feel free to add to it yourself -jdlinke)

Attachments

If you add source code or project sample attachments for the bug report (strongly recommended, see Tips on writing bug reports), please compress them using preferably these formats:

Other formats like 7zip, Bzip and RAR are ok, too. Nowadays tools for them are easily available.

Undertanding the Report Status

An issue can have the following states:

See also