Generate PDF documentation

Change-Id: I82069d3b92350bf51def36822094aeeae8a5ee73
Story: 2006073
Task: 34799

doc/source/conf.py

@@ -67,15 +67,20 @@ html_theme = 'openstackdocs'
 # Output file base name for HTML help builder.
 htmlhelp_basename = '%sdoc' % project
 
+# -- Options for LaTeX output ------------------------------------------------
+
 # Grouping the document tree into LaTeX files. List of tuples
 # (source start file, target name, title, author, documentclass
 # [howto/manual]).
 latex_documents = [
     ('index',
-     '%s.tex' % project,
+     'doc-%s.tex' % project,
      u'%s Documentation' % project,
      u'OpenStack Developers', 'manual'),
 ]
 
+# Disable usage of xindy https://bugzilla.redhat.com/show_bug.cgi?id=1643664
+latex_use_xindy = False
+
 # Example configuration for intersphinx: refer to the Python standard library.
 #intersphinx_mapping = {'http://docs.python.org/': None}

tox.ini

@@ -38,6 +38,13 @@ commands =
 basepython = python3
 commands = python setup.py build_sphinx
 
+[testenv:pdf-docs]
+basepython = python3
+whitelist_externals = make
+commands =
+    sphinx-build -b latex doc/source doc/build/pdf
+    make -C doc/build/pdf
+
 [testenv:releasenotes]
 basepython = python3
 commands =