8000 bpo-29521 Fix two minor documentation build warnings (#41) · python/cpython@3d707be · GitHub
[go: up one dir, main page]

Skip to content

Commit 3d707be

Browse files
JDLHbriancurtin
authored andcommitted
bpo-29521 Fix two minor documentation build warnings (#41)
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.
1 parent 649a7ca commit 3d707be

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)
0