Improve documentation.

Author: serhiy-storchaka

Doc/library/functions.rst

@@ -336,8 +336,9 @@ are always available.  They are listed here in alphabetical order.
    ``__debug__`` is true), ``1`` (asserts are removed, ``__debug__`` is false)
    or ``2`` (docstrings are removed too).
 
-   The optional argument *module* specifies the module name used
-   when filtering syntax warnings.
+   The optional argument *module* specifies the module name.
+   It is needed to unambiguous :ref:`filter <_warning-filter>` syntax warnings
+   by module name.
 
    This function raises :exc:`SyntaxError` if the compiled source is invalid,
    and :exc:`ValueError` if the source contains null bytes.

Doc/library/importlib.rst

@@ -471,8 +471,9 @@ ABC hierarchy::
         With the subsequent code object one can execute it in a module by
         running ``exec(code, module.__dict__)``.
 
-        The optional argument *fullname* specifies the name of the module used
-        when filtering syntax warnings.
+        The optional argument *fullname* specifies the module name.
+        It is needed to unambiguous :ref:`filter <_warning-filter>` syntax
+        warnings by module name.
 
         .. versionadded:: 3.4
 

Doc/library/symtable.rst

@@ -26,8 +26,9 @@ Generating Symbol Tables
    Return the toplevel :class:`SymbolTable` for the Python source *code*.
    *filename* is the name of the file containing the code.  *compile_type* is
    like the *mode* argument to :func:`compile`.
-   The optional argument *module* specifies the module name used
-   when filtering syntax warnings.
+   The optional argument *module* specifies the module name.
+   It is needed to unambiguous :ref:`filter <_warning-filter>` syntax warnings
+   by module name.
 
    .. versionadded:: next
       Added the *module* parameter.

Doc/whatsnew/3.15.rst

@@ -310,7 +310,8 @@ Other language changes
 * Many functions related to compiling or parsing Python code, such as
   :func:`compile`, :func:`ast.parse`, :func:`symtable.symtable`,
   and :func:`importlib.abc.InspectLoader.source_to_code`, now allow to pass
-  the module name used when filtering syntax warnings.
+  the module name. It is needed to unambiguous :ref:`filter <_warning-filter>`
+  syntax warnings by module name.
   (Contributed by Serhiy Storchaka in :gh:`135801`.)
 
 

Misc/NEWS.d/next/Core_and_Builtins/2025-10-06-14-19-47.gh-issue-135801.OhxEZS.rst

@@ -1,4 +1,6 @@
 Many functions related to compiling or parsing Python code, such as
 :func:`compile`, :func:`ast.parse`, :func:`symtable.symtable`, and
-:func:`importlib.abc.InspectLoader.source_to_code` now allow to pass the module
-name used when filtering syntax warnings.
+:func:`importlib.abc.InspectLoader.source_to_code` now allow to specify
+the module name.
+It is needed to unambiguous :ref:`filter <_warning-filter>` syntax warnings
+by module name.