DOC: Makefile inherits a Sphinx 1.5 bug regarding PAPER envvar

[jfbu]

BPO	34293
Nosy	@zware, @jfbu
PRs	bpo-34293: fix DOC Makefile regarding PAPER envvar #8585 [3.8] bpo-34293: Fix PDF documentation paper size (GH-8585) #15816 [3.7] bpo-34293: Fix PDF documentation paper size (GH-8585) #15817

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2019-09-09.21:59:54.098>
created_at = <Date 2018-07-31.13:10:13.284>
labels = ['3.8', 'type-bug', '3.7', '3.9', 'docs']
title = 'DOC: Makefile inherits a Sphinx 1.5 bug regarding PAPER envvar'
updated_at = <Date 2019-09-09.22:11:37.191>
user = 'https://github.com/jfbu'

bugs.python.org fields:

activity = <Date 2019-09-09.22:11:37.191>
actor = 'zach.ware'
assignee = 'docs@python'
closed = True
closed_date = <Date 2019-09-09.21:59:54.098>
closer = 'zach.ware'
components = ['Documentation']
creation = <Date 2018-07-31.13:10:13.284>
creator = 'jfbu'
dependencies = []
files = []
hgrepos = []
issue_num = 34293
keywords = ['patch']
message_count = 6.0
messages = ['322770', '322774', '351554', '351556', '351558', '351559']
nosy_count = 3.0
nosy_names = ['docs@python', 'zach.ware', 'jfbu']
pr_nums = ['8585', '15816', '15817']
priority = 'normal'
resolution = 'fixed'
stage = 'resolved'
status = 'closed'
superseder = None
type = 'behavior'
url = 'https://bugs.python.org/issue34293'
versions = ['Python 3.7', 'Python 3.8', 'Python 3.9']

[jfbu]

There has been a bug at Sphinx since release 1.5 sphinx-doc/sphinx#5234 about wrong handling of PAPER environment variable. The Makefile in Doc/ reproduces the error. As a result the "A4 latex" and "letter latex" sub targets of "dist" mis-behave.

A bugfix will be released at Sphinx 1.7.7 or 1.8 but the CPython Doc/Makefile needs an update, because the bugfix can only solve problems for new projects created with sphinx-quickstart (whether or not using the "make-mode" small Makefile, or the "no-make-mode" bigger Makefile which was default up to Sphinx 1.5).

I will send PR next.

[jfbu]

#8585

[zware]

New changeset b5381f6 by Zachary Ware (Jean-François B) in branch 'master':
bpo-34293: Fix PDF documentation paper size (GH-8585)
b5381f6

[zware]

Thank you for the patch!

[zware]

New changeset 99df5e8 by Zachary Ware in branch '3.8':
[3.8] bpo-34293: Fix PDF documentation paper size (GH-8585) (GH-15816)
99df5e8

[zware]

New changeset 12228ce by Zachary Ware in branch '3.7':
[3.7] bpo-34293: Fix PDF documentation paper size (GH-8585) (GH-15817)
12228ce