Add usage info to JJB documentation

Display the usage info for JJB and add it to the
sphinx docs.

Fixes bug 1221944

Change-Id: I5b36cca7a836b009bfb0ca880abbccd4477de307

doc/source/conf.py

@@ -27,7 +27,7 @@ sys.path.insert(0, os.path.abspath('../../jenkins_jobs/modules'))
 # Add any Sphinx extension module names here, as strings. They can be extensions
 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
 extensions = ['sphinx.ext.autodoc', 'sphinx.ext.coverage',
-              'jenkins_jobs.sphinx.yaml']
+              'jenkins_jobs.sphinx.yaml', 'sphinxcontrib.programoutput']
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']

doc/source/installation.rst

@@ -48,14 +48,14 @@ Running
 After it's installed and configured, you can invoke Jenkins Job
 Builder by running ``jenkins-jobs``.  You won't be able to do anything
 useful just yet without a configuration which is discussed in the next
-section).  But you should be able to get help on the various commands
-by running::
+section.
 
-  jenkins-jobs --help
-  jenkins-jobs update --help
-  jenkins-jobs test --help
-  (etc.)
+Usage
+^^^^^
+.. program-output:: jenkins-jobs --help
 
+Testing
+^^^^^^^
 Once you have a configuration defined, you can test it with::
 
   jenkins-jobs test /path/to/config -o /path/to/output

tools/test-requires

@@ -6,3 +6,4 @@ setuptools_git>=0.4
 testscenarios
 testtools
 testrepository
+sphinxcontrib-programoutput