The Barrelfish source contains a number of technical notes, which are rough and ready documentation, tutorials, reference manuals etc. for the system. A recent snapshot of PDF files is available on the Barrelfish web site, but the most up-to-date versions are in the tree. This article describes how to generate these.
The instructions below assume you downloaded the Barrelfish source and configured it as described in Getting Started with Barrelfish.
Requirements
Additionally to the requirements listed in Getting Started with Barrelfish you need the following tools:
LaTeX-Distribution (packet texlive on Ubuntu or Debian)
Graphviz - Graph visualization (packet graphviz on Ubuntu or Debian)
Compiling
Change into the build directory of the Barrelfish source
cd barrelfish/build
and run
make docs
After the generation finished, the documents can be found in
barrelfish/build/doc/
Errors
If you get the following error, check if the dot program (which ships with graphviz) is properly installed.
dot -Tpdf ../doc/010-spec/app_cspace.dot -o ./tools/tmp/app_cspace.pdf make: dot: Command not found