From e93cacb8cf6bbfe4dedb561e73fc2ff4d74f5089 Mon Sep 17 00:00:00 2001 From: "Miss Islington (bot)" <31488909+miss-islington@users.noreply.github.com> Date: Fri, 29 Aug 2025 16:35:17 +0200 Subject: [PATCH] [3.13] gh-123858: Improve Doc: SyntaxWarning is emitted during bytecode generation (gh-138243) --------- (cherry picked from commit 5f7906715adea645d8141d5337851872cfca4381) Co-authored-by: Hang Co-authored-by: Alyssa Coghlan --- Doc/library/exceptions.rst | 3 +++ Doc/library/warnings.rst | 4 +++- 2 files changed, 6 insertions(+), 1 deletion(-) diff --git a/Doc/library/exceptions.rst b/Doc/library/exceptions.rst index f47cc0abb8b6..59043886dabe 100644 --- a/Doc/library/exceptions.rst +++ b/Doc/library/exceptions.rst @@ -880,6 +880,9 @@ The following exceptions are used as warning categories; see the Base class for warnings about dubious syntax. + This warning is typically emitted when compiling Python source code, and usually won't be reported + when running already compiled code. + .. exception:: RuntimeWarning diff --git a/Doc/library/warnings.rst b/Doc/library/warnings.rst index 288181a98268..25f54ba7fb85 100644 --- a/Doc/library/warnings.rst +++ b/Doc/library/warnings.rst @@ -80,7 +80,9 @@ The following warnings category classes are currently defined: | | unless triggered by code in ``__main__``). | +----------------------------------+-----------------------------------------------+ | :exc:`SyntaxWarning` | Base category for warnings about dubious | -| | syntactic features. | +| | syntactic features (typically emitted when | +| | compiling Python source code, and hence | +| | may not be suppressed by runtime filters) | +----------------------------------+-----------------------------------------------+ | :exc:`RuntimeWarning` | Base category for warnings about dubious | | | runtime features. | -- 2.47.3