[Python-checkins] [3.7] bpo-34293: Fix PDF documentation paper size (GH-8585) (GH-15817)
Zachary Ware
webhook-mailer at python.org
Mon Sep 9 18:11:38 EDT 2019
https://github.com/python/cpython/commit/12228ce41de1b8fcfb3f1ba0a86d98a232815e85
commit: 12228ce41de1b8fcfb3f1ba0a86d98a232815e85
branch: 3.7
author: Zachary Ware <zachary.ware at gmail.com>
committer: GitHub <noreply at github.com>
date: 2019-09-09T23:11:34+01:00
summary:
[3.7] bpo-34293: Fix PDF documentation paper size (GH-8585) (GH-15817)
The "A4" pdfs were previously the wrong size due to a change in the options in Sphinx 1.5.
See also sphinx-doc/sphinxGH-5235.
(cherry picked from commit b5381f669718aa19690f42f3b8bd88f03045b9d2)
Authored-by: Jean-François B <jfbu at free.fr>
files:
A Misc/NEWS.d/next/Documentation/2018-07-31-15-38-26.bpo-34293.yHupAL.rst
M Doc/Makefile
diff --git a/Doc/Makefile b/Doc/Makefile
index 307d1e0e7de1..08013c0ef48c 100644
--- a/Doc/Makefile
+++ b/Doc/Makefile
@@ -12,7 +12,11 @@ PAPER =
SOURCES =
DISTVERSION = $(shell $(PYTHON) tools/extensions/patchlevel.py)
-ALLSPHINXOPTS = -b $(BUILDER) -d build/doctrees -D latex_elements.papersize=$(PAPER) \
+# Internal variables.
+PAPEROPT_a4 = -D latex_elements.papersize=a4paper
+PAPEROPT_letter = -D latex_elements.papersize=letterpaper
+
+ALLSPHINXOPTS = -b $(BUILDER) -d build/doctrees $(PAPEROPT_$(PAPER)) \
$(SPHINXOPTS) . build/$(BUILDER) $(SOURCES)
.PHONY: help build html htmlhelp latex text changes linkcheck \
diff --git a/Misc/NEWS.d/next/Documentation/2018-07-31-15-38-26.bpo-34293.yHupAL.rst b/Misc/NEWS.d/next/Documentation/2018-07-31-15-38-26.bpo-34293.yHupAL.rst
new file mode 100644
index 000000000000..912a3ad48d40
--- /dev/null
+++ b/Misc/NEWS.d/next/Documentation/2018-07-31-15-38-26.bpo-34293.yHupAL.rst
@@ -0,0 +1 @@
+Fix the Doc/Makefile regarding PAPER environment variable and PDF builds
More information about the Python-checkins
mailing list