#16304: merge with 3.2.
diff --git a/Doc/library/re.rst b/Doc/library/re.rst
index 07623c9..b0cb870 100644
--- a/Doc/library/re.rst
+++ b/Doc/library/re.rst
@@ -824,9 +824,16 @@
Match Objects
-------------
-Match objects always have a boolean value of :const:`True`. This lets you
-use a simple if-statement to test whether a match was found. Match objects
-support the following methods and attributes:
+Match objects always have a boolean value of ``True``.
+Since :meth:`~regex.match` and :meth:`~regex.search` return ``None``
+when there is no match, you can test whether there was a match with a simple
+``if`` statement::
+
+ match = re.search(pattern, string)
+ if match:
+ process(match)
+
+Match objects support the following methods and attributes:
.. method:: match.expand(template)