Vinay Sajip <vinay_sa...@yahoo.co.uk> 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.
        If stream is not specified, sys.stderr is used.
        """
        Handler.__init__(self)
        if stream is None:
            stream = sys.stderr
        self.stream = stream

> We users Do. Not. Care. about how wonderfully clever your implementation is, 
> we care about how it actually works. Whatever Rube-Goldbergian implementation 
> details there are behind the scenes are of no interest to us.

I'm not sure your tone is particularly constructive here. I don't regard the 
code you say you've read, reproduced above, is particularly Rube-Goldbergian, 
or even Heath-Robinsonish. And are you presuming to speak for all Python users 
here?

> Fine, lets try this another way - does anyone else have opinions on this?

As far as I can remember, you're the first person to bring this up since 
logging was added to Python in 2003. In all that time, no-one appears to have 
been confused by that prose, which has been there since pretty much the 
beginning, though there was a spelling change and a logging documentation 
reorganisation around 9 years ago.

----------

_______________________________________
Python tracker <rep...@bugs.python.org>
<https://bugs.python.org/issue37563>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to