From: Erlend E. Aasland <erlend@python.org>
Date: Mon, 15 Apr 2024 21:17:28 +0000 (+0200)
Subject: gh-117804: Document how to suppress PGO unprofiled source warnings (#117859)
X-Git-Tag: v3.13.0b1~413
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=757891ee8ad61a864444c1fdb764d81bc8a11189;p=thirdparty%2FPython%2Fcpython.git

gh-117804: Document how to suppress PGO unprofiled source warnings (#117859)
---

diff --git a/Doc/using/configure.rst b/Doc/using/configure.rst
index eef0c5022d37..580d31fd422c 100644
--- a/Doc/using/configure.rst
+++ b/Doc/using/configure.rst
@@ -518,6 +518,15 @@ also be used to improve performance.
    GCC is used: add ``-fno-semantic-interposition`` to the compiler and linker
    flags.
 
+   .. note::
+
+      During the build, you may encounter compiler warnings about
+      profile data not being available for some source files.
+      These warnings are harmless, as only a subset of the code is exercised
+      during profile data acquisition.
+      To disable these warnings on Clang, manually suppress them by adding
+      ``-Wno-profile-instr-unprofiled`` to :envvar:`CFLAGS`.
+
    .. versionadded:: 3.6
 
    .. versionchanged:: 3.10