aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/conf.py
diff options
context:
space:
mode:
authorMauro Carvalho Chehab <mchehab@s-opensource.com>2017-06-19 07:49:06 -0300
committerJonathan Corbet <corbet@lwn.net>2017-06-23 13:45:37 -0600
commit633d612bda6a37e1d5f5f878ec5a22a11599f800 (patch)
tree4676c4e3d7ebe1822af3bc8b2b7758c5b5aba1ce /Documentation/conf.py
parentDocs: Include the Latex "ifthen" package (diff)
downloadlinux-dev-633d612bda6a37e1d5f5f878ec5a22a11599f800.tar.xz
linux-dev-633d612bda6a37e1d5f5f878ec5a22a11599f800.zip
Docs: Fix breakage with Sphinx 1.5 and upper
Commit 85c21e5c3ee7 (docs-rst: better adjust margins and font size) added a \usepackage{geometry} that conflicts with another inclusion deep within the dependencies with newer versions of Sphinx, causing the the PDF build to fail with a "conflicting parameters" error. Detect the Sphinx version, using sphinxsetup for Sphinx versions 1.5 and upper. Fixes: 85c21e5c3ee74fb75d690c57f7066bae7e2dca55 [jc: Tweaked logic to exclude 1.5.x for x < 3 ] Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Diffstat (limited to 'Documentation/conf.py')
-rw-r--r--Documentation/conf.py8
1 files changed, 6 insertions, 2 deletions
diff --git a/Documentation/conf.py b/Documentation/conf.py
index 9eff2c8f7f67..71b032bb44fd 100644
--- a/Documentation/conf.py
+++ b/Documentation/conf.py
@@ -271,8 +271,6 @@ latex_elements = {
# Additional stuff for the LaTeX preamble.
'preamble': '''
- % Adjust margins
- \\usepackage[margin=0.5in, top=1in, bottom=1in]{geometry}
\\usepackage{ifthen}
% Allow generate some pages in landscape
@@ -343,6 +341,12 @@ latex_elements = {
if major == 1 and minor > 3:
latex_elements['preamble'] += '\\renewcommand*{\\DUrole}[2]{ #2 }\n'
+if major == 1 and minor <= 4:
+ latex_elements['preamble'] += '\\usepackage[margin=0.5in, top=1in, bottom=1in]{geometry}'
+elif major == 1 and (minor > 5 or (minor == 5 and patch >= 3)):
+ latex_elements['sphinxsetup'] = 'hmargin=0.5in, vmargin=0.5in'
+
+
# Grouping the document tree into LaTeX files. List of tuples
# (source start file, target name, title,
# author, documentclass [howto, manual, or own class]).