From 73ff2a7878fb516fce16db2c0df2d6611a647b99 Mon Sep 17 00:00:00 2001
From: Matt Riedemann <mriedem.os@gmail.com>
Date: Thu, 22 Aug 2019 12:52:57 -0400
Subject: [PATCH] docs: pretty up return code table or heal_allocations

This just converts the bullet list to the prettier table
format like archive_deleted_rows and map_instances use.

Change-Id: I33b78a4d55c9a34fca6ab20b2b9e8db41d747da5
---
 doc/source/cli/nova-manage.rst | 46 +++++++++++++++++++++++-----------
 1 file changed, 31 insertions(+), 15 deletions(-)

diff --git a/doc/source/cli/nova-manage.rst b/doc/source/cli/nova-manage.rst
index b063252af1..fff31c5b0b 100644
--- a/doc/source/cli/nova-manage.rst
+++ b/doc/source/cli/nova-manage.rst
@@ -484,24 +484,40 @@ Placement
     :oslo.config:group:`placement` configuration options are set. Placement API
     >= 1.28 is required.
 
-    Return codes:
+    **Return Codes**
 
-    * 0: Command completed successfully and allocations were created.
-    * 1: ``--max-count`` was reached and there are more instances to process.
-    * 2: Unable to find a compute node record for a given instance.
-    * 3: Unable to create (or update) allocations for an instance against its
-      compute node resource provider.
-    * 4: Command completed successfully but no allocations were created.
-    * 5: Unable to query ports from neutron
-    * 6: Unable to update ports in neutron
-    * 7: Cannot roll back neutron port updates. Manual steps needed. The error
-      message will indicate which neutron ports need to be changed to clean up
-      ``binding:profile`` of the port::
+    .. list-table::
+       :widths: 20 80
+       :header-rows: 1
 
-        $ openstack port unset <port_uuid> --binding-profile allocation
+       * - Return code
+         - Description
+       * - 0
+         - Command completed successfully and allocations were created.
+       * - 1
+         - ``--max-count`` was reached and there are more instances to process.
+       * - 2
+         - Unable to find a compute node record for a given instance.
+       * - 3
+         - Unable to create (or update) allocations for an instance against its
+           compute node resource provider.
+       * - 4
+         - Command completed successfully but no allocations were created.
+       * - 5
+         - Unable to query ports from neutron
+       * - 6
+         - Unable to update ports in neutron
+       * - 7
+         - Cannot roll back neutron port updates. Manual steps needed. The
+           error message will indicate which neutron ports need to be changed
+           to clean up ``binding:profile`` of the port::
 
-    * 127: Invalid input.
-    * 255: An unexpected error occurred.
+             $ openstack port unset <port_uuid> --binding-profile allocation
+
+       * - 127
+         - Invalid input.
+       * - 255
+         - An unexpected error occurred.
 
 ``nova-manage placement sync_aggregates [--verbose]``
     Mirrors compute host aggregates to resource provider aggregates