BTLFAQ

When should I use the BTL?

As often as possible ;-) No, seriously: You should consider it as soon as you have >= 2 components/systems exchanging data with each other or whenever you are using bonsai. Remember that the BTL currently assumes XML-based data.

Should I use a release or the trunk version?

It is highly recommended that you go with the releases. You should only consider the trunk if you have to add a number of data descriptions (or already did that in the trunk).

Where can I get the releases of the BTL?

The releases can be found in the branch-folder of the svn, e.g. source:branches/rel_0_9_0. For some events/demos you can find additional "tags" in the tags-folder of the svn. There will be release files in the files section. You can get it from the repository like this


me@mycomputer:$svn export https://opensource.cit-ec.de/svn/btl/branches/rel_0_9_0/

You can also download the Release files from the files section.

How can I build the BTL?

You should read the README: source:branches/rel_0_9_0/README
  1. Checkout the BTL to your machine.
  2. Change into the directory: 
    me@mycomputer:$cd <BTLDIR>
  3. Change into the build folder: 
    me@mycomputer:$cd build
  4. Configuration is done with CMAKE: 
    me@mycomputer:$cmake -DCMAKE_INSTALL_PREFIX=<INSTALL PATH>
  5. Build the BTL: 
    me@mycomputer:$make
    This will build the Java and the C++ part.

How can I compile the API documentation?

The Doxygen and JavaDoc pages can be compiled using make:
  1. Follow steps 1 to 4 of topic "How can I build the BTL?"
  2. Compiling API doc: 
    me@mycomputer:$make doc
    This will build the Java and the C++ API documentation in the subfolder doc.

Are there any code examples?

Yes. You may have a look at source:branches/rel_0_9_0/examples/ for further details.