]> granicus.if.org Git - python/commitdiff
Make StreamHandler.terminator more discoverable (GH-14359)
authorAndre Delfino <adelfino@gmail.com>
Sat, 29 Jun 2019 21:59:49 +0000 (18:59 -0300)
committerVinay Sajip <vinay_sajip@yahoo.co.uk>
Sat, 29 Jun 2019 21:59:49 +0000 (22:59 +0100)
Doc/library/logging.handlers.rst

index 4c1af7cba6630d5ece1a820daf679071e134b5cd..703d66d7ff6a4ff8b4587385f1f7ecc81f48141c 100644 (file)
@@ -48,7 +48,7 @@ and :meth:`flush` methods).
    .. method:: emit(record)
 
       If a formatter is specified, it is used to format the record. The record
-      is then written to the stream with a terminator. If exception information
+      is then written to the stream followed by :attr:`terminator`. If exception information
       is present, it is formatted using :func:`traceback.print_exception` and
       appended to the stream.
 
@@ -70,13 +70,17 @@ and :meth:`flush` methods).
 
       .. versionadded:: 3.7
 
+   .. attribute:: terminator
 
-.. versionchanged:: 3.2
-   The ``StreamHandler`` class now has a ``terminator`` attribute, default
-   value ``'\n'``, which is used as the terminator when writing a formatted
-   record to a stream. If you don't want this newline termination, you can
-   set the handler instance's ``terminator`` attribute to the empty string.
-   In earlier versions, the terminator was hardcoded as ``'\n'``.
+      String used as the terminator when writing a formatted record to a stream.
+      Default value is ``'\n'``.
+
+      If you don't want a newline termination, you can set the handler instance's
+      ``terminator`` attribute to the empty string.
+
+      In earlier versions, the terminator was hardcoded as ``'\n'``.
+
+      .. versionadded:: 3.2
 
 
 .. _file-handler: