openstack
/
nova
Code Issues Proposed changes

Use .. deprecated:: theme for deprecations 

We were using `warning`, and `important` themes to mark deprecations in
various places.  We have a `deprecated` role, so this change switches to
use it.

Note that I also found the following files that mentioned deprecation,
but not in a way where using this role seemed appropriate.  I'm
recording them here so you know I considered them.

doc/source/admin/configuration/hypervisor-kvm.rst
doc/source/admin/configuration/schedulers.rst
doc/source/cli/index.rst
doc/source/cli/nova-rootwrap.rst
doc/source/contributor/api.rst
doc/source/contributor/code-review.rst
doc/source/contributor/policies.rst
doc/source/contributor/project-scope.rst
doc/source/reference/policy-enforcement.rst
doc/source/reference/stable-api.rst
doc/source/user/feature-classification.rst
doc/source/user/flavors.rst
doc/source/user/upgrade.rst

Change-Id: Icd7613d9886cfe0775372c817e5f3d07d8fb553d
This commit is contained in:
Eric Fried 2018-05-02 11:01:02 -05:00 committed by Matt Riedemann
parent 338a3df403
commit fca14f0906
4 changed files with 11 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
doc/source/admin/networking-nova.rst
View File

@ -2,7 +2,7 @@
Networking with nova-network
============================
.. important::
.. deprecated:: 14.0.0
``nova-network`` was deprecated in the OpenStack Newton release. In Ocata
and future releases, you can start ``nova-network`` only with a cells v1

3
doc/source/cli/nova-cells.rst
View File

@ -26,7 +26,8 @@ Starts the `nova-cells` service.
The `nova-cells` service handles communication between cells and selects cells
for new instances.
.. warning:: Everything in this document is referring to Cells v1, which is
.. deprecated:: 16.0.0
Everything in this document is referring to Cells v1, which is
not recommended for new deployments and is deprecated in favor of Cells v2
as of the 16.0.0 Pike release. For information about commands to use
with Cells v2, see the man page for :ref:`man-page-cells-v2`.

2
doc/source/cli/nova-network.rst
View File

@ -24,7 +24,7 @@ Description
`nova-network` is a server daemon that serves the Nova Network service, which
is responsible for allocating IPs and setting up the network
.. warning::
.. deprecated:: 14.0.0
`nova-network` is deprecated and will be removed in an upcoming release. Use
`neutron` or another networking solution instead.

11
doc/source/user/cells.rst
View File

@ -40,8 +40,8 @@ See `Comparison with Cells V1`_ for more detail.
Status
~~~~~~
.. warning:: Cells v1 is deprecated in favor of Cells v2 as of the
16.0.0 Pike release.
.. deprecated:: 16.0.0
Cells v1 is deprecated in favor of Cells v2 as of the 16.0.0 Pike release.
Cells v1 is considered experimental and receives much less testing than the
rest of Nova. For example, there is no job for testing cells v1 with Neutron.
@ -576,8 +576,11 @@ FAQs
There are a couple of ways to do this.
1. Run ``nova-manage --config-file <cell config> host list``. This will
only lists hosts in the provided cell nova.conf. Note, however, that
this command is deprecated as of the 16.0.0 Pike release.
only lists hosts in the provided cell nova.conf.
.. deprecated:: 16.0.0
The ``nova-manage host list`` command is deprecated as of the
16.0.0 Pike release.
2. Run ``nova-manage cell_v2 discover_hosts --verbose``. This does not
produce a report but if you are trying to determine if a host is in a