97db901658
OpenStack is dropping the py2.7 support in ussuri cycle. Complete discussion & schedule can be found in - http://lists.openstack.org/pipermail/openstack-discuss/2019-October/010142.html - https://etherpad.openstack.org/p/drop-python2-support Ussuri Communtiy-wide goal: https://governance.openstack.org/tc/goals/selected/ussuri/drop-py27.html This change cleans up: * remove old requirements * remove universal wheel building, we don't need this for py3 * cleanup setup.py * tox.ini: move basepython around; remove install_command since the default is fine and constraints should be in deps; add ignore_basepython_conflict Change-Id: Ife0a696ca62be21d3d93c5d8279a412578f62697
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.