TODO: Organize this page with more info.
Orcus uses autoconf and automake as its build system. As such, building it from sources should be familiar to those who are used to these tools.
In short, run the following command:
./autogen.sh
make
make install
at the root directory after either cloning from the repository or unpacking the source package.
Orcus has build-time dependency on the following libraries:
Note that when you are building from the master branch of the git repository, we recommend that you also use the latest mdds source code from its git repository for the build as well as the latest ixion library built from its git repository, else you may encounter build issues or test failures.
Orcus uses a combination of Doxygen, Sphinx and Breathe to build its documentation. It also use Sphinx Bootstrap Theme for the page layout and theme.
Most distros package Doxygen, and Sphinx, Breathe and Sphinx Bootstrap Theme can be installed via pip.
Orcus uses libtool to manage linking of executables. When you have a test
failure and you wish to debug it by running it under, say, gdb
, you need
to use libtool
to wrap the libtool wrapper script that wraps the actual
executable binary. For instance, the following command executes the test
program named parser-test-threaded-sax-token-parser
under gdb
with the
help of libtool
:
libtool --mode=execute gdb src/parser/parser-test-threaded-sax-token-parser