3409c0e26d
It's unusual to include a '+00:00' offset in an ISO8601 timestamp rather than just using the 'Z' suffix. It's also very weird for our API to be returning timestamps which aren't in UTC. Let's make these timestamps consistent with other timestamps by using UTC always and representing that with a 'Z' suffix. Also, enforce this in the API sample tests by using a new 'isotime' regexp. A small number of the extensions in the API sample templates specified the exact timestamp, so templatize those before regenerating the API samples for GET /extensions. Full context here: http://lists.openstack.org/pipermail/openstack-dev/2014-April/033971.html Change-Id: Idf429e55e4ae13738ac531a25ce54b20d395410d
OpenStack Nova Documentation README
Included documents:
- developer reference guide(devref)
- man pages
Dependencies
Building this documentation can be done in a regular Nova development
environment, such as the virtualenv created by run_tests.sh
or tools/install_venv.py. A leaner but sufficient
environment can be created by starting with one that is suitable for
running Nova (such as the one created by DevStack) and then using pip to
install oslosphinx.
Building the docs
From the root nova directory:
python setup.py build_sphinxBuilding just the man pages
from the root nova directory:
python setup.py build_sphinx -b manInstalling the man pages
After building the man pages, they can be found in
doc/build/man/. You can install the man page onto your
system by following the following steps:
Example for nova-scheduler:
mkdir /usr/local/man/man1
install -g 0 -o 0 -m 0644 doc/build/man/nova-scheduler.1 /usr/local/man/man1/nova-scheduler.1
gzip /usr/local/man/man1/nova-scheduler.1
man nova-scheduler