diff options
author | Mauro Carvalho Chehab <mchehab@s-opensource.com> | 2016-07-15 06:42:08 -0400 |
---|---|---|
committer | Mauro Carvalho Chehab <mchehab@s-opensource.com> | 2016-07-15 06:56:10 -0400 |
commit | 520a247760f750307b53db905a10a17df1700f3b (patch) | |
tree | ed15b99b4c07cf8453550920be7db0307744f8e6 /Documentation/conf.py | |
parent | 425efba23509e18e39d0056799004f2005b66b15 (diff) |
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.
Diffstat (limited to 'Documentation/conf.py')
-rw-r--r-- | Documentation/conf.py | 2 |
1 files changed, 1 insertions, 1 deletions
diff --git a/Documentation/conf.py b/Documentation/conf.py index 224240b5bc50..96b7aa66c89c 100644 --- a/Documentation/conf.py +++ b/Documentation/conf.py | |||
@@ -411,7 +411,7 @@ epub_exclude_files = ['search.html'] | |||
411 | # multiple PDF files here actually tries to get the cross-referencing right | 411 | # multiple PDF files here actually tries to get the cross-referencing right |
412 | # *between* PDF files. | 412 | # *between* PDF files. |
413 | pdf_documents = [ | 413 | pdf_documents = [ |
414 | ('index', u'Kernel', u'Kernel', u'J. Random Bozo'), | 414 | ('kernel-documentation', u'Kernel', u'Kernel', u'J. Random Bozo'), |
415 | ] | 415 | ] |
416 | 416 | ||
417 | # kernel-doc extension configuration for running Sphinx directly (e.g. by Read | 417 | # kernel-doc extension configuration for running Sphinx directly (e.g. by Read |