Update to sphinx 1.5

Update for Sphinx 1.5 version.
Update all requirements with global requirements file for this.

Change-Id: Ie271c3d8f384176410ccfc66039edf8c0c47f960

setup.py

@@ -1,4 +1,3 @@
-#!/usr/bin/env python
 # Copyright (c) 2013 Hewlett-Packard Development Company, L.P.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -14,8 +13,17 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+# THIS FILE IS MANAGED BY THE GLOBAL REQUIREMENTS REPO - DO NOT EDIT
 import setuptools
 
+# In python < 2.7.4, a lazy loading of package `pbr` will break
+# setuptools if some other modules registered functions in `atexit`.
+# solution from: http://bugs.python.org/issue15881#msg170215
+try:
+    import multiprocessing  # noqa
+except ImportError:
+    pass
+
 setuptools.setup(
-    setup_requires=['pbr'],
+    setup_requires=['pbr>=1.8'],
     pbr=True)

test-requirements.txt

@@ -1,6 +1,9 @@
-hacking>=0.5.6,<0.8
-Sphinx>=1.1.2,<1.2
-oslosphinx
-bashate>=0.2
-PyYAML
+# The order of packages is significant, because pip processes them in the order
+# of appearance. Changing the order has an impact on the overall integration
+# process, which may cause wedges in the gate later.
+hacking!=0.13.0,<0.14,>=0.12.0 # Apache-2.0
+sphinx>=1.5.1 # BSD
+oslosphinx>=4.7.0 # Apache-2.0
+bashate>=0.2 # Apache-2.0
+PyYAML>=3.10.0 # MIT
 ansible-lint