Move docs into OpenStack PTI structure

It's not strictly required for steth, but keeping things organized like
the rest of OpenStack projects allows for easier and more powerful
integration with centralized tooling.

This also adds a bindep.txt file which is needed to ensure that
non-python requirements are properly installed.

Change-Id: Iec6b27d5cbb9743c7cc84278e6f4e1a5ca07f853

bindep.txt

@@ -0,0 +1,5 @@
+libpcap-dev [platform:dpkg]
+libpcap-devel [platform:rpm]
+python-dev [platform:dpkg]
+python-devel [platform:redhat !platform:fedora]
+python2-devel [platform:fedora]

doc/Makefile

@@ -3,9 +3,9 @@
 # You can set these variables from the command line.
 SPHINXOPTS	=
 SPHINXBUILD	= sphinx-build
-SPHINXSOURCE	= .
+SPHINXSOURCE	= source
 PAPER	=
-BUILDDIR	= _build
+BUILDDIR	= build
 
 # Internal variables.
 PAPEROPT_a4	= -D latex_paper_size=a4

setup.cfg

@@ -17,10 +17,6 @@ classifier =
     Programming Language :: Python :: 2.7
     Programming Language :: Python :: 2.6
 
-[global]
-setup-hooks =
-    pbr.hooks.setup_hook
-
 [files]
 packages =
     steth
@@ -41,3 +37,8 @@ universal = 1
 [pbr]
 autodoc_index_modules = 1
 warnerrors = true
+
+[build_sphinx]
+all_files = 1
+build-dir = doc/build
+source-dir = doc/source

steth/stethclient/constants.py

@@ -177,4 +177,5 @@ def validate_and_parse_network_types():
     check_and_fill_sdn_info()
     check_and_fill_storage_info()
 
+
 validate_and_parse_network_types()

steth/stethclient/shell.py

@@ -81,5 +81,6 @@ def main(argv=sys.argv[1:]):
         print(e)
         return 1
 
+
 if __name__ == "__main__":
     sys.exit(main(sys.argv[1:]))

steth/stethclient/utils.py

@@ -83,6 +83,7 @@ class Logger():
     def log_fail(info):
         print(Logger.FAIL + info + Logger.ENDC)
 
+
 LISTEN_PORT = 9698