2016: I’ve updated the proposed bug report guidelines through my own bug tracking routine. – morr
Please try to fill the following template, whenever you report a bug to:
Github (https://github.com/pencil2d/pencil/issues/ )
Bug Reports forum (http://www.pencil2d.org/forums/forum/bugs/)
–Issue Overview–
Write a brief but concise description of what is happening in layman’s terms.
–Video or Image Demo–
Try to attach a screen recording (video or gif) or a series of images that will help the developers to spot the problem right away while following the “steps to reproduce” the bug. Usually mandatory for complex bugs.
–Steps to reproduce–
In here write quite literally what steps you took when the problem surfaced. If you’re not sure, try to pinpoint what steps are exactly causing the problem
EXAMPLE:
- Open Pencil2D
- Select a drawing tool (i.e Pencil)
- Draw in Camera Layer
- Pencil2D Crashes
- (...)
EXAMPLE:
"The polyline tool should draw straight lines, not pixel blobs"
--System Information--- Pencil2D Build Version
- Operative System
- Graphics Card Specs
- CPU Specs
- RAM Specs
Pencil Debug Window Report
Note: This is for Versions of Pencil that have the DOS Window / Linux Console output enabled, and should be shared by intermediate to veteran users if possible.
When suffering from a bug that doesn’t crash pencil try to copy & paste the information that appears in the Pencil Debug Window / Linux console
Windows Crash Reports
If your Pencil crashes often you can go to:
- Control Panel > Administrative Tools > Event Viewer
- On the left side pane go to Application > look for your crash report.
- Copy & paste the information or attach a .txt file with the report.