@@ -937,18 +937,18 @@ The compiler now emits a :exc:`SyntaxWarning` when a :keyword:`return`,
937
937
leaving a :keyword: `finally ` block.
938
938
This change is specified in :pep: `765 `.
939
939
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
944
944
with a filter that converts other warnings to errors (for example, passing
945
945
``-Werror -Wignore::SyntaxWarning `` as CLI options, or setting
946
946
``PYTHONWARNINGS=error,ignore::SyntaxWarning ``).
947
947
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.
952
952
953
953
(Contributed by Irit Katriel in :gh: `130080 `.)
954
954
0 commit comments