gh-92412: Clarify the documentation on library/syslog (GH-92587) (GH-95266)

(cherry picked from commit b7ce4625fe2a8a4d6c1db6b39b52c7f97d384caa)

Co-authored-by: Nicolas Haller <nicolas@haller.im>

diff --git a/Doc/library/syslog.rst b/Doc/library/syslog.rst
index d264a3340c98b01fcc6f568025760ad70140b91d..ce51856ab7be1379568becbc185ddb28d843b2aa 100644 (file)
--- a/Doc/library/syslog.rst
+++ b/Doc/library/syslog.rst
@@ -29,10 +29,15 @@ The module defines the following functions:
    value given in the :func:`openlog` call is used.
 
    If :func:`openlog` has not been called prior to the call to :func:`syslog`,
-   ``openlog()`` will be called with no arguments.
+   :func:`openlog` will be called with no arguments.
 
    .. audit-event:: syslog.syslog priority,message syslog.syslog
 
+   .. versionchanged:: 3.2
+      In previous versions, :func:`openlog` would not be called automatically if
+      it wasn't called prior to the call to :func:`syslog`, deferring to the syslog
+      implementation to call ``openlog()``.
+
 
 .. function:: openlog([ident[, logoption[, facility]]])
 
@@ -51,8 +56,7 @@ The module defines the following functions:
 
    .. versionchanged:: 3.2
       In previous versions, keyword arguments were not allowed, and *ident* was
-      required.  The default for *ident* was dependent on the system libraries,
-      and often was ``python`` instead of the name of the Python program file.
+      required.
 
 
 .. function:: closelog()