Documentation fixes to make Sphinx happy

On this note, we have an issue with our current gate test for
documentation not properly catching these issues.  I'll be attempting to
address the issue in a future patch.

Change-Id: I7d0bea70ef98d1744200815ce12f1436729349e8
Signed-off-by: Paul Belanger <paul.belanger@polybeacon.com>
Reviewed-on: https://review.openstack.org/19889
Reviewed-by: Clark Boylan <clark.boylan@gmail.com>
Reviewed-by: James E. Blair <corvus@inaugust.com>
Approved: James E. Blair <corvus@inaugust.com>
Tested-by: Jenkins
Remove setuptools-git from setup.py.

Put it in test-requires so it's there when we build a tarball.
Change-Id: I8a5adec74beeb397e71e17030338a8051fe6fb0b
Reviewed-on: https://review.openstack.org/19885
Reviewed-by: Clark Boylan <clark.boylan@gmail.com>
Reviewed-by: Jeremy Stanley <fungi@yuggoth.org>
Approved: Clark Boylan <clark.boylan@gmail.com>
Tested-by: Jenkins
Raise exception for at least one type of syntax errors

Every so often, I create a yaml file with something like:

- job:
  name: "test"

This previously exploded with an obscure error message, now it raises
an exception with a hopefully less obscure error.

Change-Id: Ie9e402a9ec5afa8dac069a6cae5710eabbc0e665
Signed-off-by: Tollef Fog Heen <tfheen@varnish-software.com>
Reviewed-on: https://review.openstack.org/20322
Reviewed-by: Clark Boylan <clark.boylan@gmail.com>
Reviewed-by: James E. Blair <corvus@inaugust.com>
Reviewed-by: Jeremy Stanley <fungi@yuggoth.org>
Approved: Clark Boylan <clark.boylan@gmail.com>
Tested-by: Jenkins
Bugfix and tidy-up

Allow the configuration file to be optional for test mode
Tidy-up the hipchat notifier module
    - Require a valid hipchat authtoken
Ignore temporary vi/vim files in .gitignore
Add extra debugging output
    - write out cache file to enable easy removal to force upload
    - clearly notify that no changes are seen so uploading not occurring

Change-Id: Ia418704b76090e284e0b801609f2f05bfa06b9ae
Reviewed-on: https://review.openstack.org/20380
Reviewed-by: Jeremy Stanley <fungi@yuggoth.org>
Reviewed-by: Khai Do <do.khai@gmail.com>
Reviewed-by: Clark Boylan <clark.boylan@gmail.com>
Approved: James E. Blair <corvus@inaugust.com>
Reviewed-by: James E. Blair <corvus@inaugust.com>
Tested-by: Jenkins