May 19, 2025 · May 19, 2025
diff --git a/Doc/library/re.rst b/Doc/library/re.rst
   That way, separator components are always found at the same relative
   indices within the result list.

 Emptymatchesfor the pattern split the string only when not adjacent
 to a previousempty match.
 Adjacent emptymatchesare not possible, but an empty match can occur
 immediately after a non-empty match.

   .. code:: pycon


   The optional argument *count* is the maximum number of pattern occurrences to be
   replaced; *count* must be a non-negative integer.  If omitted or zero, all
   occurrences will be replaced. Empty matches for the pattern are replaced only
   when not adjacent to a previous empty match, so ``sub('x*', '-', 'abxd')`` returns
   ``'-a-b--d-'``.
   occurrences will be replaced.

   Adjacent empty matches are not possible, but an empty match can occur
   immediately after a non-empty match.
   As a result, ``sub('x*', '-', 'abxd')`` returns ``'-a-b--d-'``
   instead of ``'-a-b-d-'``.

   .. index:: single: \g; in regular expressions

   .. versionchanged:: 3.7
      Unknown escapes in *repl* consisting of ``'\'`` and an ASCII letter
      now are errors.
      Empty matches for the pattern are replaced when adjacent to a previous
      non-empty match.
      An empty match can occur immediately after a non-empty match.

   .. versionchanged:: 3.12
      Group *id* can only contain ASCII digits.
Original file line number	Diff line number	Diff line change
Expand Up		@@ -991,8 +991,8 @@ Functions
		That way, separator components are always found at the same relative
		indices within the result list.

		Emptymatchesfor the pattern split the string only when not adjacent
		to a previousempty match.
		Adjacent emptymatchesare not possible, but an empty match can occur
		immediately after a non-empty match.

		.. code:: pycon

Expand DownExpand Up		@@ -1095,9 +1095,12 @@ Functions

		The optional argument count is the maximum number of pattern occurrences to be
		replaced; count must be a non-negative integer. If omitted or zero, all
		occurrences will be replaced. Empty matches for the pattern are replaced only
		when not adjacent to a previous empty match, so ``sub('x*', '-', 'abxd')`` returns
		``'-a-b--d-'``.
		occurrences will be replaced.

		Adjacent empty matches are not possible, but an empty match can occur
		immediately after a non-empty match.
		As a result, ``sub('x*', '-', 'abxd')`` returns ``'-a-b--d-'``
		instead of ``'-a-b-d-'``.

		.. index:: single: \g; in regular expressions

Expand DownExpand Up		@@ -1128,8 +1131,7 @@ Functions
		.. versionchanged:: 3.7
		Unknown escapes in repl consisting of ``'\'`` and an ASCII letter
		now are errors.
		Empty matches for the pattern are replaced when adjacent to a previous
		non-empty match.
		An empty match can occur immediately after a non-empty match.

		.. versionchanged:: 3.12
		Group id can only contain ASCII digits.
Expand Down