docs/library/re: Document non-capturing grouping.

agatti · dpgeorge · commit df9b714af4f9 · 2026-03-17T16:14:11.000+11:00
This commit updates the documentation for the `re` library, officially documenting non-capturing grouping rules (ie. "(?:...)"). The documentation mistakenly marked that feature as not supported, but is is indeed supported in the current iteration of the regex library. This closes #18900. Signed-off-by: Alessandro Gatti <a.gatti@frob.it>
diff --git a/docs/library/re.rst b/docs/library/re.rst
@@ -54,6 +54,10 @@ Supported operators and special sequences are:
    Grouping. Each group is capturing (a substring it captures can be accessed
    with `match.group()` method).
 
+``(?:...)``
+   Non-capturing grouping. Each group is matched using the same rules as
+   regular grouping, but will not be part of the match object.
+
 ``\d``
    Matches digit. Equivalent to ``[0-9]``.
 
@@ -87,7 +91,6 @@ Supported operators and special sequences are:
 
 * counted repetitions (``{m,n}``)
 * named groups (``(?P<name>...)``)
-* non-capturing groups (``(?:...)``)
 * more advanced assertions (``\b``, ``\B``)
 * special character escapes like ``\r``, ``\n`` - use Python's own escaping
   instead
