Reporting Bugs and Requesting Features
If you have found a bug in Geary or would like to request a new feature, here’s how to do it:
Search for the problem or feature, in case it has already been reported
Report it if no existing issue was found
Get a stack trace for crashes, and add it to the bug report
Search
Look in the FAQ and search through the existing reports on GitLab. Try searching with similar words and partial prefixes. For example, if the bug is about attaching files, search for “attach” instead of “attaching” or “attachments.”
If the bug has already been reported, switch on notifications for the issue to receive updates about it. Feel free to add more detail to it, but please avoid "me too" comments, thanks!
Report it
A good place to report bugs or request new features is to get in touch either by sending an email to the mailing list or by chat on on IRC. The Geary community can help out with existing workarounds, solutions and suggestions.
If you are sure the behaviour you are seeing is a new, unreported bug or feature, please create a new issue for it on GitLab. Please include the following information:
- Geary version and installation method (Package? Flathub? Source code?)
- Your desktop (GNOME? KDE? Something else?)
- Your operating system and version (Ubuntu 16.04? Fedora 28? Rolled your own?)
- Email provider (Gmail, Yahoo!, Outlook.com, or someone else?)
- Steps to reproduce the bug
- What actually happened?
- What did you expect to happen?
Stack Trace
If the bug is a crash or a hang and is repeatable, please follow the following steps to generate a backtrace.
1. Install debug symbols if possible.
- Flatpak
Run: flatpak install flathub org.gnome.Geary.Debug org.gnome.Sdk.Debug
- Fedora
Run: sudo dnf debuginfo-install geary glib2 gtk3
- Ubuntu
Follow the Ubuntu wiki instructions for installing dbgsym packages, then run: sudo apt install geary-dbgsym libglib2.0-0-dbgsym libgtk-3-0-dbgsym
2. Run Geary under GDB.
If you have installed Geary using Flatpak, run the following command first before proceeding:
flatpak run --devel --command=sh org.gnome.Geary
Launch GDB:
G_DEBUG=fatal-criticals gdb --args geary --debug
At the (gdb) prompt, enter the following two commands:
handle SIGUSR1 noprint run
3. Make the crash happen or in the case of a hang, press Ctrl-C to return to the GDB console.
In GDB, generate a backtrace by entering the following command:
backtrace full
This will print out a stack trace, you can then type quit to exit GDB and close Geary.
4. Once done, copy and paste the debug output into a plain text file (for example, using Gedit) and attach when filing your bug.
Please examine the debug output for private information. You may discover email addresses, folder names, etc. that you do not want to share. Remember, your bug report is public to the world, including this file. Please redact or edit the debug file before posting it.