From: Petr Viktorin <encukou@gmail.com>
Date: Tue, 23 Nov 2021 10:28:14 +0000 (+0100)
Subject: Clarify that discutils.(plat)include is for CPython's headers (GH-29578)
X-Git-Tag: v3.11.0a3~156
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=2c047f604e6a999390b5fa4ebfb6e8222c5cc096;p=thirdparty%2FPython%2Fcpython.git

Clarify that discutils.(plat)include is for CPython's headers (GH-29578)

Change the docs to note that "include" and "platinclude" are
for CPython's headers, and not necessarily for headers of
third-party libraries.

See discussion in: https://discuss.python.org/t/clarification-on-a-wheels-header-data/9305/19
---

diff --git a/Doc/library/sysconfig.rst b/Doc/library/sysconfig.rst
index 7ef3b2489673..713be1e02cea 100644
--- a/Doc/library/sysconfig.rst
+++ b/Doc/library/sysconfig.rst
@@ -96,8 +96,10 @@ identifier.  Python currently uses eight paths:
   platform-specific.
 - *platlib*: directory for site-specific, platform-specific files.
 - *purelib*: directory for site-specific, non-platform-specific files.
-- *include*: directory for non-platform-specific header files.
-- *platinclude*: directory for platform-specific header files.
+- *include*: directory for non-platform-specific header files for
+  the Python C-API.
+- *platinclude*: directory for platform-specific header files for
+  the Python C-API.
 - *scripts*: directory for script files.
 - *data*: directory for data files.