Steven Hardy
66f4178d28
Currently any attempt to substitute placeholders using data from a json/map or list parameter/attribute results in an error, which is inconvenient if you wish to provide such data to an instance, e.g so it can be used in a script via jq/python or whatever. So, tolerate non-string parameter values, and attempt to serialize them as json, then substitute the resulting json strings. Change-Id: I362cc76ac3f68d4649a62459455c0dcae2dcd25d Closes-Bug: #1489028
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 oslosphinxIf you are using the virtualenv you'll need to install them in the virtualenv.
Get Help
Just type make to get help:
makeIt will list available build targets.
Build Doc
To build the man pages:
make manTo build the developer documentation as HTML:
make htmlType make for more formats.
Test Doc
If you modify doc files, you can type:
make doctestto check whether the format has problem.