Skip to content

Commit 9db5c40

Browse files
ncoghlaniritkatrielAA-Turner
authored
Apply suggestions from code review
Co-authored-by: Irit Katriel <[email protected]> Co-authored-by: Adam Turner <[email protected]>
1 parent 5435a8a commit 9db5c40

File tree

1 file changed

+8
-8
lines changed

1 file changed

+8
-8
lines changed

Doc/whatsnew/3.14.rst

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -937,18 +937,18 @@ The compiler now emits a :exc:`SyntaxWarning` when a :keyword:`return`,
937937
leaving a :keyword:`finally` block.
938938
This change is specified in :pep:`765`.
939939

940-
For use cases where this change is inconvenient (such as those where the
941-
warnings are redundant due to code linting), syntax warnings specifically
942-
may be switched off via the :ref:`warning filter <warning-filter>`, using the
943-
clause ``ignore::SyntaxWarning``. This can also be specified in combination
940+
In situations where this change is inconvenient (such as those where the
941+
warnings are redundant due to code linting), the :ref:`warning filter
942+
<warning-filter>` can be used to turn off all syntax warnings, by using the
943+
``ignore::SyntaxWarning`` filter. This can be specified in combination
944944
with a filter that converts other warnings to errors (for example, passing
945945
``-Werror -Wignore::SyntaxWarning`` as CLI options, or setting
946946
``PYTHONWARNINGS=error,ignore::SyntaxWarning``).
947947

948-
Note that applying such a filter at runtime (rather than via the interpreter's
949-
startup configuration) will only suppress the warning in code that is compiled
950-
*after* the filter is adjusted. Code that is compiled prior to the filter
951-
adjustment (for example, when a module is imported) will still emit the warning.
948+
Note that applying such a filter at runtime, using the :mod:`warnings` module
949+
will only suppress the warning in code that is compiled *after* the filter is
950+
adjusted. Code that is compiled prior to the filter adjustment (for example,
951+
when a module is imported) will still emit the syntax warning.
952952

953953
(Contributed by Irit Katriel in :gh:`130080`.)
954954

0 commit comments

Comments
 (0)