- If you get an error during documentation build saying that
itircl.dll
was not registered correctly, go toexternals\windows-installer\htmlhelp
and runregsvr32 itcc.dll
. Or you can install HTML Help Compiler system-wide, which would register this DLL anyway. - Build from a path that doesn't contain spaces. Otherwise you may get an error 9009 when executing
gendef
.
- Install Windows 8.1 SDK and Visual Studio 2015 build tools.
- Install SVN with command line tools from https://tortoisesvn.net/downloads.html.
- Build of installer works with Sphinx 1.7.9 for Python 3.5.5 to 3.5.7 and Sphinx 1.8.5 for Python 3.5.8 to 3.5.10. Install Sphinx into a Python 3.6 venv and set
SPHINXBUILD
to the path tosphinx-build.exe
. - Apply
build-full-installer-1.patch
to include debug symbols and debug binaries in the installer. - Run
buildrelease.bat -x86 -x64
.
- Install Sphinx 1.8.5 to a Python 3.6 venv and set
SPHINXBUILD
to the path tosphinx-build.exe
. - Due to a bug in build scripts (python/cpython#79555), set
HTMLHELP
to the path tohhc.exe
inexternals\windows-installer\htmlhelp
. - Install Windows SDK 10.0.10586.212.
- Apply
build-full-installer-1.patch
to include debug symbols and debug binaries in the installer. - Apply
fix-test_winconsole.patch
to fix a hang during PGO profile generation (python/cpython#85895). - Run
buildrelease.bat -x86 -x64
.
- Install Sphinx 2.4.5 to a Python 3.6 venv and set
PYTHON
to the location of the Python executable. - Apply
build-full-installer-2.patch
to include debug symbols and debug binaries in the installer. - Apply
fix-htmlhelp.patch
to fix error in documentation build (python/cpython#90621). - Apply
fix-test_winconsole.patch
to fix a hang during PGO profile generation (python/cpython#85895). - Run
buildrelease.bat -x86 -x64
.
- Install Sphinx 2.4.5 to a Python 3.6 venv and set
PYTHON
to the location of the Python executable. - Apply
fix-libffi-1.patch
for 3.8.11 orfix-libffi-2.patch
for 3.8.12 to avoid error wherelibffi-7.lib
can't be found. - Apply
build-full-installer-2.patch
to include debug symbols and debug binaries in the installer. - Apply
fix-htmlhelp.patch
to fix error in documentation build (python/cpython#90621). - Apply
fix-chm.patch
to fix formatting errors in the.chm
help file (python/cpython#91207). - Run
buildrelease.bat -x86 -x64
.
- Install Sphinx 3.5.4 to a Python 3.6 venv and set
PYTHON
to the location of the Python executable. - Apply
build-full-installer-3.patch
to include debug symbols, debug binaries, and the Universal CRT in the installer. - Apply
fix-guid.patch
to work around python/cpython#96729. - Apply
fix-chm.patch
to fix formatting errors in the.chm
help file (python/cpython#91207). - Run
buildrelease.bat -x86 -x64
.
- Install Sphinx 3.5.4 to a Python 3.6 venv and set
PYTHON
to the location of the Python executable. - Apply
build-full-installer-4.patch
to include debug symbols, debug binaries, and the Universal CRT in the installer. - Apply
fix-vcruntime-threads.patch
to fix python/cpython#115167. - Run
buildrelease.bat -x86 -x64
.
- Install Sphinx 7.2.6 to a Python 3.10 venv and set
PYTHON
to the location of the Python executable. - Apply
build-full-installer-5.patch
to include debug symbols, debug binaries, and the Universal CRT in the installer. - Apply
enable-arm64-zip-nupkg.patch
to enable building the ARM64 embeddable ZIP file and the ARM64 NuGet package file. This also fixes python/cpython#123915. - Run
buildrelease.bat -x86 -x64 -arm64
.