summaryrefslogtreecommitdiff
path: root/README
blob: 6809ffbc9ccfc390addbc4b5fa08b4b0826bbabb (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
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`.