Move cinder-manage page to cli doc subtree

Since we have a CLI reference and specific doc subtree the
cinder-manage docs should live there. This moves the cinder-manage
page from man/ to cli/ and adds a redirect link.

Change-Id: If99416e8a382d2a6571412742276dccc591d180c

doc/source/_extra/.htaccess

@@ -0,0 +1 @@
+redirectmatch 301 ^/cinder/([^/]+)/man/cinder-manage.html$ /cinder/$1/cli/cinder-manage.html

doc/source/cli/index.rst

@@ -2,6 +2,23 @@
 Command-Line Interface Reference
 ================================
 
+In this section you will find information on Cinder's command line utilities.
+
+Cinder Management Commands
+--------------------------
+
+These commands are used to manage existing installations. They are designed to
+be run by operators in an environment where they have direct access to the
+Cinder database.
+
+.. toctree::
+   :maxdepth: 1
+
+   cinder-manage
+
+Additional Tools and Information
+--------------------------------
+
 .. toctree::
    :maxdepth: 1
 

doc/source/conf.py

@@ -149,7 +149,7 @@ modindex_common_prefix = ['cinder.']
 # List of tuples 'sourcefile', 'target', u'title', u'Authors name', 'manual'
 
 man_pages = [
-    ('man/cinder-manage', 'cinder-manage', u'Cloud controller fabric',
+    ('cli/cinder-manage', 'cinder-manage', u'Cloud controller fabric',
      [u'OpenStack'], 1)
 ]
 
@@ -189,6 +189,9 @@ html_theme = 'openstackdocs'
 # so a file named "default.css" will overwrite the builtin "default.css".
 html_static_path = ['_static']
 
+# Add any paths that contain "extra" files, such as .htaccess.
+html_extra_path = ['_extra']
+
 # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
 # using the given strftime format.
 html_last_updated_fmt = '%Y-%m-%d %H:%M'

doc/source/index.rst

@@ -78,7 +78,6 @@ Full documentation on the python-cinderclient is in the
    :maxdepth: 2
 
    cli/index
-   cinder-manage Usage <man/cinder-manage>
 
 Contributor/Developer Docs
 ~~~~~~~~~~~~~~~~~~~~~~~~~~