summaryrefslogtreecommitdiff
path: root/admin/build-doc
blob: 52c3870a9f4bde3439201fb06b6f613e1340b4a9 (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
#!/bin/sh
set -e
cd "$(dirname "$0")"
cd ..

install -d -m0755 build-doc

if [ ! -e build-doc/doxygen/xml ]; then
    doxygen
fi

dia --filter=png-libart --export=doc/overview.png.tmp doc/overview.dia

mv -- doc/overview.png.tmp doc/overview.png

cat src/osd/PG.h src/osd/PG.cc | doc/scripts/gen_state_diagram.py > doc/dev/peering_graph.generated.dot

cd build-doc

if [ ! -e virtualenv ]; then
    virtualenv --no-site-packages virtualenv
fi
if [ ! -x virtualenv/bin/sphinx-build ]; then
    ./virtualenv/bin/pip install sphinx
fi

# ugly kludge until breathe is distutils-friendly
install -d breathe
cd breathe
if [ ! -e .git ]; then
    git init
fi
if [ -z "$(git rev-parse --default HEAD)" ]; then
    git pull --ff-only https://github.com/michaeljones/breathe.git master
fi
cd ..

install -d -m0755 \
    output/html \
    output/man
PYTHONPATH=`pwd`/../src/pybind ./virtualenv/bin/sphinx-build -a -b dirhtml -d doctrees ../doc output/html
./virtualenv/bin/sphinx-build -a -b man -d doctrees ../doc output/man