Merge "Build pdf doc"

doc/source/conf.py

@@ -182,7 +182,7 @@ latex_elements = {
 # Grouping the document tree into LaTeX files. List of tuples
 # (source start file, target name, title, author, documentclass [howto/manual]).
 latex_documents = [
-  ('index', 'Ironic-specs.tex', u'Ironic Specs',
+  ('index', 'doc-ironic-specs.tex', u'Ironic Specs',
    u'OpenStack Ironic Team', 'manual'),
 ]
 

requirements.txt

@@ -1,5 +1,5 @@
 pbr>=0.6,!=0.7,<1.0
 sphinx!=1.6.6,!=1.6.7,>=1.6.2,<2.0.0;python_version=='2.7' # BSD
 sphinx!=1.6.6,!=1.6.7,>=1.6.2;python_version>='3.4' # BSD
-openstackdocstheme>=1.18.1 # Apache-2.0
+openstackdocstheme>=1.20.0 # Apache-2.0
 yasfb>=0.5.1

specs/kilo-implemented/irmc-management-driver.rst

@@ -27,7 +27,7 @@ Proposed change
 ===============
 This module inherits ipmitool.IPMIManagement and overrides the
 following two functions for iRMC Drivers, namely pxe_irmc, iscsi_irmc,
-and agent_irmc [*]_, in order to make use of iRMC IPMI boot mode
+and agent_irmc [#]_, in order to make use of iRMC IPMI boot mode
 get/set capability and SCCI get sensor data.
 
 This module will be re-factored, when Ironic set/get boot mode I/F
@@ -50,7 +50,7 @@ is standardized in Ironic Management Interface.
   'sensor_method=ipmitool', this function just calls the parent class
   function, ipmitool.IPMIManagement.get_sensors_data() as default.
 
-.. [*] Driver consists of five elements.
+.. [#] Driver consists of five elements.
        In the initial implementation, iRMC driver supports three
        combinations out of all combinations.
 

tox.ini

@@ -22,3 +22,10 @@ commands = {posargs}
 [testenv:docs]
 basepython = python3
 commands = sphinx-build -W -b html doc/source doc/build/html
+
+[testenv:pdf-docs]
+basepython = python3
+whitelist_externals = make
+commands = sphinx-build -W -b latex doc/source doc/build/pdf
+           make -C doc/build/pdf
+