ceph/admin/build-doc
Tommi Virtanen 66ee58f691 doc: Move internals into a new section, /dev.
Most of the doc is user-oriented, let's isolate internals more.

Split into multiple files. Clean up RST.

Use Sphinx's graphviz plugin for graphs.

Signed-off-by: Tommi Virtanen <tommi.virtanen@dreamhost.com>
2011-09-01 13:28:12 -07:00

41 lines
879 B
Bash
Executable File

#!/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
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
./virtualenv/bin/sphinx-build -a -b dirhtml -d doctrees ../doc output/html
./virtualenv/bin/sphinx-build -a -b man -d doctrees ../doc output/man