[issue37563] Documentation - default for StreamHandler

2019-07-13 Thread Jonathan
Jonathan added the comment: >What fallacy? You appeared to be saying (to paraphrase) "no-one else has ever reported this, so it's never been a problem". That's a fallacy. > I was responding to "does anyone else have opinions on this?" I was asking if anyone else wanted to chime in with an

[issue37563] Documentation - default for StreamHandler

2019-07-13 Thread Vinay Sajip
Vinay Sajip added the comment: > This is a fallacy. What fallacy? I was responding to "does anyone else have opinions on this?" I can't read minds of people all over the world, so I have to go by my best guess, which is based on how many times this issue has been reported before - which I

[issue37563] Documentation - default for StreamHandler

2019-07-13 Thread Jonathan
Jonathan added the comment: > I'm not sure your tone is particularly constructive here. Apologies, my bad. > Which code are you looking at? The documentation code: `class logging.StreamHandler(stream=None)`. Sorry, I don't know what you'd call that. I'm not referring to the code proper. >

[issue37563] Documentation - default for StreamHandler

2019-07-13 Thread Vinay Sajip
Vinay Sajip added the comment: > the prose clearly say that the default is sys.stderr, however the code > doesn't show that Which code are you looking at? Here is the entirety of StreamHandler.__init__: def __init__(self, stream=None): """ Initialize the handler.

[issue37563] Documentation - default for StreamHandler

2019-07-13 Thread Jonathan
Jonathan added the comment: > The devil is in the detail. If stream=sys.stderr is specified, that takes > effect at import time. If stream=None is specified and the implementation > chooses to treat that as sys.stderr, that takes effect at the time of the > call. The two are not equivalent.

[issue37563] Documentation - default for StreamHandler

2019-07-12 Thread Vinay Sajip
Vinay Sajip added the comment: The devil is in the detail. If stream=sys.stderr is specified, that takes effect at import time. If stream=None is specified and the implementation chooses to treat that as sys.stderr, that takes effect at the time of the call. The two are not equivalent. It

[issue37563] Documentation - default for StreamHandler

2019-07-11 Thread Jonathan
Change by Jonathan : -- status: -> open ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue37563] Documentation - default for StreamHandler

2019-07-11 Thread Vinay Sajip
Vinay Sajip added the comment: If None is passed, that is interpreted to mean whatever the implementation default is, and that is sys.stderr. For backwards compatibility, that won't change: and I don't see any need to update the documentation, as it makes it perfectly clear that sys.stderr

[issue37563] Documentation - default for StreamHandler

2019-07-11 Thread Karthikeyan Singaravelan
Change by Karthikeyan Singaravelan : -- nosy: +vinay.sajip ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue37563] Documentation - default for StreamHandler

2019-07-11 Thread Jonathan
New submission from Jonathan : https://docs.python.org/2/library/logging.handlers.html https://docs.python.org/3/library/logging.handlers.html Both say: """class logging.StreamHandler(stream=None) Returns a new instance of the StreamHandler class. If stream is specified, the instance will