This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author jonathan-lp
Recipients
Date 2019-07-11.15:11:25
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id
In-reply-to
Content
> If None is passed, that is interpreted to mean whatever the implementation default is, and that is sys.stderr.
Unless I'm missing something, this means that sys.stderr is functionally the default, which means it is the default. We users don't care about implementation details; this documentation is for users, not implementers.

This is how other parts of the same docs work. e.g.:
"""
class logging.handlers.RotatingFileHandler(filename, mode='a', maxBytes=0, backupCount=0, encoding=None, delay=0)
...If mode is not specified, 'a' is used...
"""


"""
class logging.handlers.SysLogHandler(address=('localhost', SYSLOG_UDP_PORT), facility=LOG_USER, socktype=socket.SOCK_DGRAM)
...If address is not specified, ('localhost', 514) is used...
If facility is not specified, LOG_USER is used... 
"""

There's a standard for documenting defaults for keyword arguments, I would ask that it please be used consistently to help us users.
History
Date User Action Args
2019-07-11 15:11:25jonathan-lplinkissue37563 messages
2019-07-11 15:11:25jonathan-lpcreate