Build System for Linutronix Training Slides/Handouts
----------------------------------------------------

Requirements
~~~~~~~~~~~~

The Linutronix package `lx-cd` must be manually installed:

----
$ git clone lxcvs:linutronix/lx-cd
$ cd lx-cd
$ dpkg-buildpackage -us -uc
$ cd ..
$ sudo dpkg -i lx-cd_2.0_all.deb
$ sudo apt-get -f install
----


The rest of the required packages are within Debian:

----
$ sudo apt-get install gcc gperf make bison flex libncurses5-dev \
       latexmk texlive-xetex fonts-liberation2 lx-cd
----


Generate Slides/Handouts
~~~~~~~~~~~~~~~~~~~~~~~~

The material to generate is chosen using the kconfig menu system:

----
$ make menuconfig
----


To generate the material:

----
$ make
----

The generated PDF files are located in the `deploy` directory.


Debugging
~~~~~~~~~

If there are errors generating the material, consider building with
verbose mode:

----
$ make V=2
----


Known Issues
~~~~~~~~~~~~

  * Building in parallel using `-j` is not supported.

  * A `make clean` must be performed if the theme is changed.

  * If printouts are enabled, incremental building does not work,
    i.e. a full rebuild occurs every time on `make`.