diff options
author | Jenkins <jenkins@review.openstack.org> | 2013-06-13 02:33:10 +0000 |
---|---|---|
committer | Gerrit Code Review <review@openstack.org> | 2013-06-13 02:33:10 +0000 |
commit | 53f62b33caa71de1da3163e0f835e39ea7a64ee8 (patch) | |
tree | a06bc7c7777c5910cc8f0a93bf39182eede112c9 /HACKING.rst | |
parent | 3f2b22499d9e94ae3ac80786752223f43d24492b (diff) | |
parent | c067e2dc131112514c6c0a8900dad9ce6c79a4e4 (diff) | |
download | nova-53f62b33caa71de1da3163e0f835e39ea7a64ee8.tar.gz nova-53f62b33caa71de1da3163e0f835e39ea7a64ee8.tar.xz nova-53f62b33caa71de1da3163e0f835e39ea7a64ee8.zip |
Merge "Add notes about how doc generation works."
Diffstat (limited to 'HACKING.rst')
-rw-r--r-- | HACKING.rst | 21 |
1 files changed, 21 insertions, 0 deletions
diff --git a/HACKING.rst b/HACKING.rst index c272bfc25..082beb87d 100644 --- a/HACKING.rst +++ b/HACKING.rst @@ -261,6 +261,27 @@ run --parallel` will run it in parallel (this is the default incantation tox uses.) More information about testr can be found at: http://wiki.openstack.org/testr +Building Docs +------------- +Normal Sphinx docs can be built via the setuptools `build_sphinx` command. To +do this via `tox`, simply run `tox -evenv -- python setup.py build_sphinx`, +which will cause a virtualenv with all of the needed dependencies to be +created and then inside of the virtualenv, the docs will be created and +put into doc/build/html. + +If you'd like a PDF of the documentation, you'll need LaTeX installed, and +additionally some fonts. On Ubuntu systems, you can get what you need with:: + + apt-get install texlive-latex-recommended texlive-latex-extra texlive-fonts-recommended + +Then run `build_sphinx_latex`, change to the build dir and run `make`. +Like so:: + + tox -evenv -- python setup.py build_sphinx_latex + cd build/sphinx/latex + make + +You should wind up with a PDF - Nova.pdf. oslo-incubator ---------------- |