Fix all doc warnings and gate on warnings

* Remove releases (File removed in e334096aa3a4badb2930c766cb4b42bbcc9ac107)
* Add link to man page
* Fix some docstring formatting

Change-Id: Iec67a6d32f0365e514394c1e3eb7d8e4ae6aff65

doc/source/index.rst

@@ -26,7 +26,6 @@ Contents:
    api
    ref/index
    ref/v2/index
-   releases
 
 Contributing
 ============
@@ -79,6 +78,17 @@ The process for command deprecation is:
      Since there was less than six months before 2015.2 would be released, the
      deprecation cycle ran through the 2016.1 Nova server release.
 
+
+Man Page
+========
+
+.. toctree::
+   :maxdepth: 1
+
+   man/nova
+
+
+
 Indices and tables
 ==================
 

novaclient/v2/volume_snapshots.py

@@ -52,7 +52,7 @@ class SnapshotManager(base.ManagerWithFind):
 
         :param volume_id: The ID of the volume to snapshot.
         :param force: If force is True, create a snapshot even if the volume is
-        attached to an instance. Default is False.
+                      attached to an instance. Default is False.
         :param display_name: Name of the snapshot
         :param display_description: Description of the snapshot
         :rtype: :class:`Snapshot`

setup.cfg

@@ -38,3 +38,6 @@ upload-dir = doc/build/html
 
 [wheel]
 universal = 1
+
+[pbr]
+warnerrors = true