25f707cdf0
It is often helpful to point people at the documentation for a specific attribute or property. This change achieves this by using sections instead if definition items to format the documentation of a property/attribute. Complex property schemas are indented using block quotes and the fragment identifier is appended to so that each link is unique. (eg, #OS::Ceilometer::Alarm-prop-query-*-field) The 'required' and 'optional' sections have been brought up one level, replacing 'Properties' with 'Required Properties' and 'Optional Properties'. Closes-Bug: #1486429 Change-Id: Ifd497aac74e8aff76ea91a295df17bb1da949ba8 |
||
---|---|---|
.. | ||
docbkx | ||
source | ||
.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.