Issue #21289: Fix documentation building on Windows using Doc/make.bat.

zware · zware · commit a37ff0fb80d5 · 2014-04-18T15:10:40.000-05:00
Also fixes a long-standing typo in Doc/README.txt.

Initial patch by Dave Sawyer.
diff --git a/Doc/README.txt b/Doc/README.txt
@@ -81,7 +81,7 @@ Without make
 
 Install the Sphinx package and its dependencies from PyPI.
 
-Then, from the ``Docs`` directory, run ::
+Then, from the ``Doc`` directory, run ::
 
    sphinx-build -b<builder> . build/<builder>
 
diff --git a/Doc/make.bat b/Doc/make.bat
@@ -1,7 +1,8 @@
 @@echo off
 setlocal
 
-if "%PYTHON%" EQU "" set PYTHON=py -2
+if "%SPHINXBUILD%" EQU "" set SPHINXBUILD=sphinx-build
+if "%PYTHON%" EQU "" set PYTHON=py
 if "%HTMLHELP%" EQU "" set HTMLHELP=%ProgramFiles%\HTML Help Workshop\hhc.exe
 if "%DISTVERSION%" EQU "" for /f "usebackq" %%v in (`%PYTHON% tools/sphinxext/patchlevel.py`) do set DISTVERSION=%%v
 
@@ -32,8 +33,7 @@ goto end
 if not exist build mkdir build
 if not exist build\%1 mkdir build\%1
 if not exist build\doctrees mkdir build\doctrees
-cmd /C %PYTHON% --version
-cmd /C %PYTHON% tools\sphinx-build.py -b%1 -dbuild\doctrees . build\%*
+cmd /C %SPHINXBUILD% -b%1 -dbuild\doctrees . build\%*
 if "%1" EQU "htmlhelp" "%HTMLHELP%" build\htmlhelp\python%DISTVERSION:.=%.hhp
 goto end
 
diff --git a/Misc/ACKS b/Misc/ACKS
@@ -1152,6 +1152,7 @@ Mark Sapiro
 Ty Sarna
 Hugh Sasse
 Bob Savage
+Dave Sawyer
 Ben Sayer
 sbt
 Marco Scataglini
