https://github.com/python/cpython/commit/e93cacb8cf6bbfe4dedb561e73fc2ff4d74f5089
commit: e93cacb8cf6bbfe4dedb561e73fc2ff4d74f5089
branch: 3.13
author: Miss Islington (bot) <[email protected]>
committer: ncoghlan <[email protected]>
date: 2025-08-30T00:35:17+10:00
summary:

[3.13] gh-123858: Improve Doc: SyntaxWarning is emitted during bytecode 
generation (gh-138243)

---------
(cherry picked from commit 5f7906715adea645d8141d5337851872cfca4381)

Co-authored-by: Hang <[email protected]>
Co-authored-by: Alyssa Coghlan <[email protected]>

files:
M Doc/library/exceptions.rst
M Doc/library/warnings.rst

diff --git a/Doc/library/exceptions.rst b/Doc/library/exceptions.rst
index f47cc0abb8b667..59043886dabe3b 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 288181a9826858..25f54ba7fb85bf 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.                         
    |

_______________________________________________
Python-checkins mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: [email protected]

Reply via email to