Fix various Sphinx errors/warnings

Change-Id: If34202291b5605302baf47c210b07ffc4ffad094

diff --git a/doc/source/getting_started/on_devstack.rst b/doc/source/getting_started/on_devstack.rst
index 6294e63a200e1b599b7e6fe983a8b5fbc98e936c..e273500a164b6365ab182a4e88455882ecc125c1 100644 (file)
--- a/doc/source/getting_started/on_devstack.rst
+++ b/doc/source/getting_started/on_devstack.rst
@@ -19,12 +19,13 @@ These instructions assume you already have a working DevStack installation which
 
 Configure DevStack to enable Heat
 ---------------------------------
-Adding the following line to your `localrc` file will enable the heat services
-::
+Adding the following line to your `localrc` file will enable the heat services::
+
     ENABLED_SERVICES+=,heat,h-api,h-api-cfn,h-api-cw,h-eng
 
-It would also be useful to automatically download and register a VM image that Heat can launch.
-::
+It would also be useful to automatically download and register
+a VM image that Heat can launch::
+
     IMAGE_URLS+=",http://fedorapeople.org/groups/heat/prebuilt-jeos-images/F17-x86_64-cfntools.qcow2,http://fedorapeople.org/groups/heat/prebuilt-jeos-images/F17-i386-cfntools.qcow2"
 
 URLs for any of [http://fedorapeople.org/groups/heat/prebuilt-jeos-images/ these prebuilt JEOS images] can be specified.
@@ -33,25 +34,30 @@ That is all the configuration that is required. When you run `./stack.sh` the He
 
 Confirming heat is responding
 -----------------------------
-Before any heat commands can be run, the authentication environment needs to be loaded
-::
+
+Before any heat commands can be run, the authentication environment
+needs to be loaded::
+
     source openrc
 
-You can confirm that Heat is running and responding with this command
-::
+You can confirm that Heat is running and responding
+with this command::
+
     heat stack-list
 
 This should return an empty line
 
 Preparing Nova for running stacks
 ---------------------------------
-Enabling Heat in devstack will replace the default Nova flavors with flavours that the Heat example templates expect. You can see what those flavors are by running
-::
+
+Enabling Heat in devstack will replace the default Nova flavors with
+flavours that the Heat example templates expect. You can see what
+those flavors are by running::
 
     nova flavor-list
 
-Heat needs to launch instances with a keypair, so we need to generate one
-::
+Heat needs to launch instances with a keypair, so we need
+to generate one::
 
     nova keypair-add heat_key > heat_key.priv
     chmod 600 heat_key.priv

diff --git a/doc/source/getting_started/on_ubuntu.rst b/doc/source/getting_started/on_ubuntu.rst
index b9324050c7ac2409baeccf12d93b788c84257765..7ddb3763fd0ebaf537038c9e78776fb162c47c2c 100644 (file)
--- a/doc/source/getting_started/on_ubuntu.rst
+++ b/doc/source/getting_started/on_ubuntu.rst
@@ -124,7 +124,8 @@ Create the keystone authentication parameters
     sudo -E ./bin/heat-keystone-setup
 
 Download or alternatively generate a JEOS image
-----------------------------------------------
+------------------------------------------------
+
 It is possible to either use an image-building tool to create an image or download a prebuilt image of a desired distribution.
 
 Download a prebuilt image and copy to libvirt images location

diff --git a/doc/source/man/heat-keystone-setup.rst b/doc/source/man/heat-keystone-setup.rst
index b661faf2128bd3aaaf289a36222e9fa61f73b19f..f3c05ceea79d78429f6180622578b7e566c41e07 100644 (file)
--- a/doc/source/man/heat-keystone-setup.rst
+++ b/doc/source/man/heat-keystone-setup.rst
@@ -1,6 +1,6 @@
-========
+===================
 heat-keystone-setup
-========
+===================
 
 .. program:: heat-keystone-setup
 

diff --git a/doc/source/man/index.rst b/doc/source/man/index.rst
index 60720bed920d194eded01fd9ce614555ff49a98d..c19c003fcd4ac181371f355d566f3c26d7ef05b2 100644 (file)
--- a/doc/source/man/index.rst
+++ b/doc/source/man/index.rst
@@ -22,3 +22,7 @@ Heat utilities
    :maxdepth: 2
 
    heat-cfn
+   heat-boto
+   heat-watch
+   heat-db-setup
+   heat-keystone-setup