AA-Turner · Aug 16, 2023 · Aug 16, 2023 · Aug 16, 2023 · Aug 16, 2023 · Aug 16, 2023
diff --git a/Doc/extending/building.rst b/Doc/extending/building.rst
@@ -1,3 +1,11 @@
+..
+   The guides to building C and C++ extensions are fairly out of date
+   and would benefit from re-writing in terms of a simple primer,
+   with specific reference to sysconfig, and how a modules can be build
+   'by hand', rather than via setuptools, CMake, meson, etc.
+   If you're reading this and would like to have a go, please do!
+   See https://github.com/python/cpython/issues/108064 for discussion.
+
 .. highlight:: c
 
 .. _building:
@@ -14,6 +22,7 @@ See :ref:`extension-modules` for details.
 
 .. highlight:: c
 
+.. _building-on-windows:
 .. _install-index:
 .. _setuptools-index:
 
@@ -28,3 +37,11 @@ https://setuptools.pypa.io/en/latest/setuptools.html.
 
 The :mod:`distutils` module, which was included in the standard library
 until Python 3.12, is now maintained as part of Setuptools.
+
+
+.. c:macro:: Py_NO_LINK_LIB
+
+   Turn off the implicit, ``#pragma``-based linkage with the Python
+   library, performed inside CPython header files.
+
+   .. versionadded:: 3.14
diff --git a/Doc/extending/index.rst b/Doc/extending/index.rst
@@ -51,7 +51,6 @@ source file by including the header ``"Python.h"``.
    newtypes_tutorial.rst
    newtypes.rst
    building.rst
-   windows.rst
    embedding.rst
 
 
@@ -92,7 +91,6 @@ C extensions.
 * :ref:`defining-new-types`
 * :ref:`new-types-topics`
 * :ref:`building`
-* :ref:`building-on-windows`
 
 Embedding the CPython runtime in a larger application
 =====================================================

diff --git a/Doc/extending/windows.rst b/Doc/extending/windows.rst
diff --git a/Doc/using/windows.rst b/Doc/using/windows.rst
@@ -1544,5 +1544,3 @@ Visual Studio, which is the compiler used to build the official Python
 releases. These files are in the :file:`PCbuild` directory.
 
 Check :file:`PCbuild/readme.txt` for general information on the build process.
-
-For extension modules, consult :ref:`building-on-windows`.
diff --git a/Include/exports.h b/Include/exports.h
@@ -75,7 +75,7 @@
         /* public Python functions and data are imported */
         /* Under Cygwin, auto-import functions to prevent compilation */
         /* failures similar to those described at the bottom of 4.1: */
-        /* http://docs.python.org/extending/windows.html#a-cookbook-approach */
+        /* https://docs.python.org/3.2/extending/windows.html#a-cookbook-approach */
 #                       if !defined(__CYGWIN__)
 #                               define PyAPI_FUNC(RTYPE) Py_IMPORTED_SYMBOL RTYPE
 #                       endif /* !__CYGWIN__ */
Original file line number	Diff line number	Diff line change
Expand Up		@@ -1544,5 +1544,3 @@ Visual Studio, which is the compiler used to build the official Python
		releases. These files are in the :file:`PCbuild` directory.

		Check :file:`PCbuild/readme.txt` for general information on the build process.

		For extension modules, consult :ref:`building-on-windows`.