bpo-41898: add caveat on root logger seeing all messages in assertLogs doc (GH-22526)

diff --git a/Doc/library/unittest.rst b/Doc/library/unittest.rst
index a52df9ee01578ce53404b3a4fc6484f3a3971d28..f04ec91270eebe2171f04dd12250f8ac5d1e7f8e 100644 (file)
--- a/Doc/library/unittest.rst
+++ b/Doc/library/unittest.rst
@@ -1091,7 +1091,8 @@ Test cases
 
       If given, *logger* should be a :class:`logging.Logger` object or a
       :class:`str` giving the name of a logger.  The default is the root
-      logger, which will catch all messages.
+      logger, which will catch all messages that were not blocked by a
+      non-propagating descendent logger.
 
       If given, *level* should be either a numeric logging level or
       its string equivalent (for example either ``"ERROR"`` or