Skip to content

Commit db3deb9

Browse files
authored
bpo-29521 Fix two minor documentation build warnings (#41) (#83)
Much of bpo-29521 was fixed in parallel with commit e7ffb99 . This cleans up the rest. Apply parallel change to Doc/make.bat to read "set SPHINXOPTS=-D latex_elements.papersize=" I don't have a Windows system on which to observe the warning, but it should be necessary. The warning: .../workspace/cpython_github/Doc/faq/windows.rst:303: WARNING: unknown option: -t In the Windows FAQ, `How do I keep editors from inserting tabs into my Python source?`, contained a reference to a Python -t option. In Python 2.x, this caused Python to issue warnings about lines with mixed spaces and tabs, but as of Python 3.6 it does nothing. Per discussion at http://bugs.python.org/issue29387, take their wording. Python [3] raises an IndentationError or TabError. Tabnanny is now a module. (cherry picked from commit 3d707be)
1 parent 9268855 commit db3deb9

File tree

2 files changed

+5
-4
lines changed

2 files changed

+5
-4
lines changed

Doc/faq/windows.rst

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -300,9 +300,10 @@ this respect, and is easily configured to use spaces: Take :menuselection:`Tools
300300
--> Options --> Tabs`, and for file type "Default" set "Tab size" and "Indent
301301
size" to 4, and select the "Insert spaces" radio button.
302302

303-
If you suspect mixed tabs and spaces are causing problems in leading whitespace,
304-
run Python with the :option:`-t` switch or run ``Tools/Scripts/tabnanny.py`` to
305-
check a directory tree in batch mode.
303+
Python raises :exc:`IndentationError` or :exc:`TabError` if mixed tabs
304+
and spaces are causing problems in leading whitespace.
305+
You may also run the :mod:`tabnanny` module to check a directory tree
306+
in batch mode.
306307

307308

308309
How do I check for a keypress without blocking?

Doc/make.bat

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -86,7 +86,7 @@ goto end
8686

8787
:build
8888
if NOT "%PAPER%" == "" (
89-
set SPHINXOPTS=-D latex_paper_size=%PAPER% %SPHINXOPTS%
89+
set SPHINXOPTS=-D latex_elements.papersize=%PAPER% %SPHINXOPTS%
9090
)
9191
cmd /C %SPHINXBUILD% %SPHINXOPTS% -b%1 -dbuild\doctrees . %BUILDDIR%\%*
9292

0 commit comments

Comments
 (0)
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy