@@ -937,18 +937,18 @@ The compiler now emits a :exc:`SyntaxWarning` when a :keyword:`return`,
937937leaving a :keyword: `finally ` block.
938938This 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
944944with 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