2006-08-11 20:41 UTC

Reporting bugs

How to report bugs and other potential problems?

Problems should be reported on the mailing list, directly to me (tuomov), or on the IRC channel, if you are patient enough to wait for somebody to respond. Always mention the version of Ion you are using, and anything else you consider relevant. To solve certain common problems, and for more specific information needed in some other cases, use the following chart:

Are you using the latest version (of Ion3 or Ion2)?

No. Then do so.

Yes. You may proceed to the next step.
Have you applied unsupported patches from elsewhere? (Such as an Xft patch.)

Yes. Remove them and come back again.

No. Next step, please.
Does Ion die with a segmentation fault?

Yes. Obtain a backtrace from gdb and send it along with other relevant detail. You must have compiled Ion with debugging symbols (default in development releases). If you have enabled core dumps, simply run gdb -core the_core_file path_to/bin/ion3 and then run backtrace full in gdb. If you have not enabled coredumps, you have the options of running Ion from within gdb, enabling coredumps (ulimit -c 10000, for example, before starting Ion), or trying to attach gdb to the process before it dumps core, and trying to reproduce the problem.

No. Go to next step.
Is the problem Gnome-related?

Yes. Goodbye.

No. Next step.
Did you run any Gnome software in your session (especially gdm or gnome-settings-daemon)?

No. Please report the problem.

Yes. Remove all Gnome software from your system. Then go to next step.
Does the problem persist?

No. Problem solved.

Yes. Please report the problem.