docs-rst: pdf: use same vertical margin on all Sphinx versions
authorMauro Carvalho Chehab <mchehab@s-opensource.com>
Wed, 23 Aug 2017 07:05:43 +0000 (04:05 -0300)
committerJonathan Corbet <corbet@lwn.net>
Thu, 24 Aug 2017 19:23:31 +0000 (13:23 -0600)
Currently, on Sphinx up to version 1.4, pdf output uses a vertical
margin of 1 inch. For upper versions, it uses a margin of 0.5 inches.

That causes both page headers and footers to be very close to the margin
of the sheet. Not all printers support writing like that.

Also, there's no reason why the layout for newer versions would be
different than for previous ones.

So, standardize it, by always setting to 1 inch.

Signed-off-by: Mauro Carvalho Chehab <mchehab@s-opensource.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
Documentation/conf.py

index 71b032bb44fd14b772512d9f2769cc8c47569389..8e74d68037a5731b83743fc3e99d8f65d96acd90 100644 (file)
@@ -344,7 +344,7 @@ if major == 1 and minor > 3:
 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'
+    latex_elements['sphinxsetup'] = 'hmargin=0.5in, vmargin=1in'
 
 
 # Grouping the document tree into LaTeX files. List of tuples