doc-rst: Fix compilation of the pdf docbook
authorMauro Carvalho Chehab <mchehab@s-opensource.com>
Fri, 15 Jul 2016 10:42:08 +0000 (07:42 -0300)
committerMauro Carvalho Chehab <mchehab@s-opensource.com>
Fri, 15 Jul 2016 10:56:10 +0000 (07:56 -0300)
commit520a247760f750307b53db905a10a17df1700f3b
treeed15b99b4c07cf8453550920be7db0307744f8e6
parent425efba23509e18e39d0056799004f2005b66b15
doc-rst: Fix compilation of the pdf docbook

The rst2pdf tool is a very broken toolchain, with is not capable
of parsing complex documents. As such, it doesn't build the
media book, failing with:

[ERROR] pdfbuilder.py:130 too many values to unpack

(using rst2pdf version 0.93.dev-r0 and Sphinx version 1.4.5)

So, make it build only the books we know that are safe to build.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
--

Btw, with the standard Sphinx version shipped on Fedora 24 (Sphinx
1.3.1), rst2pdf doesn't build even the simple kernel-documentation,
failing with this error:
    writing Kernel... [ERROR] pdfbuilder.py:130 list index out of range

This is a known bug:
    https://github.com/sphinx-doc/sphinx/issues/1844

So, maybe we should just disable pdf generation from RST for good,
as I suspect that maintaining it with a broken toolchain will be a
big headache.
Documentation/conf.py