Message347687
> 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. |
|
Date |
User |
Action |
Args |
2019-07-11 15:11:25 | jonathan-lp | link | issue37563 messages |
2019-07-11 15:11:25 | jonathan-lp | create | |
|