Theses used to be used for building docs in the past and were made
obsolete with change Icc65afd5f6c0e22147b179c16d6a4fa5f47954ce.
A recent release of setuptools 61.0.0 introduced a breaking change [1]
which caused our openstack-tox-docs and openstack-tox-pep8 jobs to fail
with:
error: Multiple top-level packages discovered in a flat-layout:
['specs', 'priorities'].
This removes setup.py and setup.cfg from use in tox.ini to resolve the
issue and they are not needed anyway.
Related-Bug: #1966382
[1] https://github.com/pypa/setuptools/issues/3197
Change-Id: Ib90065a62bdef235e83173c73894c478af0df5fa
Setuptools v54.1.0 introduces a warning that the use of dash-separated
options in 'setup.cfg' will not be supported in a future version [1].
Get ahead of the issue by replacing the dashes with underscores. Without
this, we see 'UserWarning' messages like the following on new enough
versions of setuptools:
UserWarning: Usage of dash-separated 'description-file' will not be
supported in future versions. Please use the underscore name
'description_file' instead
[1] https://github.com/pypa/setuptools/commit/a2e9ae4cb
Change-Id: I2b6c5e82a9da6e163e9d6b1f103ad350c43c0de6
Make a few cleanups:
- Remove python 2.7 stanza from setup.py
- Remove obsolete sections from setup.cfg
- Remove install_command from tox.ini, the default is fine
Change-Id: I693afdb7097b156935424c5549e1b22a08bf2773
For some reason, the gate was failing with the following message:
"WARNING: no "man_pages" config value found; no manual pages will be
written"
I don't know why this has suddenly started happening, but it was
mitigated by 'I97d4ade4'. However, this change didn't fix the root cause
of the issue, which is that 'pbr' defaults to building both html and man
page output and we don't need/want the latter.
Disable the man page builder entirely. This allows us to remove all man
page-related configuration in the process, seeing as it'll never be
used.
Change-Id: I83bb54f413cbad29afb2233043150fb037bca3bd
[pbr]warnerrors doesn't actually make the sphinx
docs build fail on warnings, and we have a ton of
garbage in the specs. pbr 2.0.0 removes warnerrors
so we should be using warning-is-error with sphinx
instead, which was introduced in sphinx 1.5 (we use 1.5.1).
Change-Id: Ibd087afd7a11f835d3bc74b7be1e9ccfbdcb1224
Instead of pointing to openstack.org, the homepage has been
changed to point to the homepage of nova-specs.
Change-Id: I8c94bd84dc8867c91e5e5958ff6f7c9bbd475310
Update the nova-specs project to use sphinx. This will allow us to
still write our specs using rst, but also have a nice framework for
rendering and publishing the specs if we choose to.
Change-Id: Ib92231acb28bba44abafb7dd554404f542da13a7