Reporting bugs

From OLPC

Like all open software, the software on the XO is constantly ready for improvement. While the basic functionality is now good, the truth is that many components are only at a beta-testing quality level. That means that we appreciate all bug reports from our users. (In fact, we hope that you will think of the bugs you find as opportunities to help us improve, rather than just nuisances.)

Contents

Quick and easy way: tell somebody

What you do: post to devel@lists.laptop.org only.

What we will do: approve your posting even though you may not be subscribed, review what you said and figure out if anything looks truly interesting, and perhaps enter into discussion, though we might not say anything about things we already know about,

description - Please make sure the build number, firmware version are right up front (preferably in the first line all by themselves); then a step by step description of how to recreate the issue. This is the most important thing you can spend time on since almost any bug can be fixed if it can be recreated... and many bugs will languish with no work if they cannot.

type - defect if it does the wrong thing, enhancement if it doesn't let you try to do a thing

component - use the pull down and try to identify the component. If you don't know, leave the default, 'not assigned'

priority - how important was this to your work? This might be changed by the triage team, but if this was really critical for you, please convey that by bumping up the priority.

A triage team will help with which release to put it in, and may add other notes or ask for more info. Put your user name in the cc field to get updates on the bug.

If you want to alert a particular developer, you can enter their Trac usernames or email address in the Cc: entry box (separated by commas).This mechanism can also be used for the Owner (Assign to: or reassign to:) entry.

If an activity crashed, you can often find a log file, and we would love it if you'd post the important parts of that with your bug. You can use the Log viewer activity. Find the log that corresponds to your application and look for sections that start with "Traceback (most recent call last):" and end with an unindented error name and details. (For older logs, you can use the Terminal activity to browse subfolders of /home/olpc/.sugar/default/logs)

There is a log file gathering tool which collects various potentially-interesting log files and bundles them up into a compressed archive for efficient uploading to the bug-slaying wizards who watch Trac. The tool is called olpc-log and you can run it from a Terminal or console like this:

$ sudo olpc-log

This will create a tar archive in your default directory (usually /home/olpc ). If you want to explore it, extract it into a scratchpad directory like this: