b9fd782106
There have been efforst to change Senlin API in an ad-hoc manner. Such kind of changes should be strictly reviewed. This patch clarifies the proper procedure to introduce API changes to Senlin. Change-Id: I63a7981d6dc639ca9b73768f4b921ab5f8996069 |
||
---|---|---|
.. | ||
docbkx | ||
source | ||
specs | ||
.gitignore | ||
Makefile | ||
README.rst |
Building the developer docs
For user and admin docs, go to the directory doc/docbkx.
Dependencies
You'll need to install python Sphinx package and oslosphinx package:
sudo pip install sphinx oslosphinx
If you are using the virtualenv you'll need to install them in the virtualenv.
Get Help
Just type make to get help:
make
It will list available build targets.
Build Doc
To build the man pages:
make man
To build the developer documentation as HTML:
make html
Type make for more formats.
Test Doc
If you modify doc files, you can type:
make doctest
to check whether the format has problem.