qiBuild documentation

Reporting qiBuild issues

Before reporting

Preparing a detailed and well-formed bug report is not difficult, but requires an effort on behalf of the reporter. The work done before reporting a bug is arguably the most useful part of the job.

The following steps will guide you in preparing your bug report or feature request.

Search for duplicates

You should search for duplicates first.

Make sure to also browse the qibuild-dev archives, too.

https://groups.google.com/a/aldebaran-robotics.com/group/qibuild-dev/

Gather useful information

Here is a list of useful information that should be mentioned in your bug report :

  • Version of the package being used. qibuild --version may be useful. Also please precise where you qibuild installation comes from.
  • Platform used: operating system, 32/64bits, etc.
  • Add relevant information when any is available:
    • Add the full error messages. We make sure qibuild error messages are precise and useful, (see Error messages)
    • Add the full command line you used, and the full output
  • Indicate how to reproduce the bug. This is very important, it will help people test the bug and potential patches on their own computer.
  • The stack trace: use --backtrace argument

For instance:

Cannot frobinicate with latest qibuild

Using qibuild from github (rev 0f452b), I get the
following when I try to frobnicate:

$ qibuild frobnicate --baz baz --backtrace
Frobnicating baz
...

Traceback (most recent call last):
File "qibuild/python/bin/qibuild", line 61, in <module>
...

File "qibuild/python/qibuild/cmake.py", line 76, in cmake
...

Could not frobnicate baz:
  error was: return code is 42 instead of 41

This is a very useful bug report.

This is not:

I updated qibuild and now frobnicate is broken!

Special case: compilation issues

When you have a compilation issue and can’t figure out what is wrong, you will have to add even more information to your bug report.

In particular, you should:

  • Run qibuild configure with --trace-cmake and attach the cmake.log file generated in the build directory.
  • Run qibuild make --verbose-make -j1 and send the full output of the build.

Open the request

You can open the request and browse the existing issues on github: https://github.com/aldebaran/qibuild/issues