History

He Jie Xu a8b805d3a3 Fix agent_id with string type in API samples files for os-agents v2 The agent_id should be integer for agent create and index. But in the api sample file it is string type. It's because the api sample tests provide agent_id with string type in fake data. This patch correct the api sample files and tests. For agent update, it use agent_id that passed from url, make the response use string for agent_id. We can't fix this problem for back-compatibility. This will be fix in the future after v3 API expose by micro-version Change-Id: I262b4b26c94dba003e80bda2f38d2e985ef9f220 Partial-Bug: #1333494		2014-06-26 08:46:41 -07:00
..
api_samples	Fix agent_id with string type in API samples files for os-agents v2	2014-06-26 08:46:41 -07:00
ext	Remove usage of locals() for formatting from nova.api.*	2013-05-18 00:04:17 +04:00
source	Merge "minor corrections to devref rpc page"	2014-06-19 01:05:48 +00:00
v3/api_samples	Fix update agent return agent_id with string for os-agents v3	2014-06-26 08:46:41 -07:00
README.rst	Replace oslo.sphinx with oslosphinx	2014-02-12 16:45:49 +00:00

README.rst

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_sphinx

Building just the man pages

from the root nova directory:

python setup.py build_sphinx -b man

Installing 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