[3.11] gh-107028: tiny textual changes in logging docs and docstrings (GH-107029...

(cherry picked from commit 5e5a34ac3a827e040cd89426b1774fec2123336a)

diff --git a/Doc/library/logging.handlers.rst b/Doc/library/logging.handlers.rst
index 7f638251602c721928a2b861e04e6ad87f84fb7d..d1566957e7ed1485e102d72407f8c2221f6c88fb 100644 (file)
--- a/Doc/library/logging.handlers.rst
+++ b/Doc/library/logging.handlers.rst
@@ -917,8 +917,9 @@ should, then :meth:`flush` is expected to do the flushing.
 
    .. method:: flush()
 
-      You can override this to implement custom flushing behavior. This version
-      just zaps the buffer to empty.
+      For a :class:`BufferingHandler` instance, flushing means that it sets the
+      buffer to an empty list. This method can be overwritten to implement more useful
+      flushing behavior.
 
 
    .. method:: shouldFlush(record)
@@ -950,9 +951,9 @@ should, then :meth:`flush` is expected to do the flushing.
 
    .. method:: flush()
 
-      For a :class:`MemoryHandler`, flushing means just sending the buffered
+      For a :class:`MemoryHandler` instance, flushing means just sending the buffered
       records to the target, if there is one. The buffer is also cleared when
-      this happens. Override if you want different behavior.
+      buffered records are sent to the target. Override if you want different behavior.
 
 
    .. method:: setTarget(target)

diff --git a/Lib/logging/handlers.py b/Lib/logging/handlers.py
index f5a9760fd496b6befcc55d8991e56d0a612f73c3..eadd1b6340bcb66efd58e00ec50b6a15f2d2631b 100644 (file)
--- a/Lib/logging/handlers.py
+++ b/Lib/logging/handlers.py
@@ -1399,7 +1399,7 @@ class MemoryHandler(BufferingHandler):
         records to the target, if there is one. Override if you want
         different behaviour.
 
-        The record buffer is also cleared by this operation.
+        The record buffer is only cleared if a target has been set.
         """
         self.acquire()
         try: