[issue32212] few discrepancy between source and docs in logging

Change by Vinay Sajip : -- resolution: not a bug -> fixed stage: patch review -> resolved status: open -> closed type: -> enhancement ___ Python tracker

[issue32212] few discrepancy between source and docs in logging

Vinay Sajip added the comment: New changeset 292fce9934280867ca9a65870495f83fca37751e by Vinay Sajip in branch '2.7': bpo-32212: Updated logging documentation to make parameter names more consistent with source. (GH-4765) (GH-4768)

[issue32212] few discrepancy between source and docs in logging

Vinay Sajip added the comment: New changeset 63868181a904c844d8d01e3badfdd5b134acc5fa by Vinay Sajip in branch '3.6': bpo-32212: Updated logging documentation to make parameter names more consistent with source. (GH-4765) (GH-4767)

[issue32212] few discrepancy between source and docs in logging

Change by Vinay Sajip : -- pull_requests: +4671 ___ Python tracker ___ ___

[issue32212] few discrepancy between source and docs in logging

Change by Vinay Sajip : -- pull_requests: +4670 ___ Python tracker ___ ___

[issue32212] few discrepancy between source and docs in logging

Vinay Sajip added the comment: New changeset a9f8df646aac7fc94ced0aefd1ed2c8566d14d10 by Vinay Sajip in branch 'master': bpo-32212: Updated logging documentation to make parameter names more consistent with source. (GH-4765)

[issue32212] few discrepancy between source and docs in logging

Change by Vinay Sajip : -- keywords: +patch pull_requests: +4668 stage: needs patch -> patch review ___ Python tracker ___

[issue32212] few discrepancy between source and docs in logging

Change by Éric Araujo : -- keywords: +easy ___ Python tracker ___ ___ Python-bugs-list

[issue32212] few discrepancy between source and docs in logging

R. David Murray added the comment: It does matter, though, because in Python you can specify a positional argument as if it were a keyword argument if you use the name from the source rather than the documented name. We have made other doc corrections along these

[issue32212] few discrepancy between source and docs in logging

Vinay Sajip added the comment: I don't have a problem with tweaking the documentation where discrepancies are found between source and doc for keyword arguments, but in both the examples you give, the arguments are positional, not keyword. Therefore in my opinion

[issue32212] few discrepancy between source and docs in logging

Michal Plichta added the comment: Nice, btw maybe other parameters in logging's docs needs to be corrected. -- ___ Python tracker

[issue32212] few discrepancy between source and docs in logging

Change by R. David Murray : -- stage: -> needs patch versions: +Python 3.7 -Python 3.4, Python 3.5 ___ Python tracker ___

[issue32212] few discrepancy between source and docs in logging

R. David Murray added the comment: Ah. I'm guessing Vinay will probably want to fix the docs, then, since that's less disruptive backward compatibility wise. -- nosy: +vinay.sajip ___ Python tracker

[issue32212] few discrepancy between source and docs in logging

Michal Plichta added the comment: see at typeshed: https://github.com/python/typeshed/blob/master/stdlib/2and3/logging/__init__.pyi#L147 def setLevel(self, lvl: Union[int, str]) -> None: ... def setFormatter(self, form: 'Formatter') -> None: ... this match python

[issue32212] few discrepancy between source and docs in logging

R. David Murray added the comment: I don't understand what the bug is that you are reporting here. Can you clarify? mypy isn't part of the stdlib, so an explanation in terms of what's in the stdlib would be helpful. -- nosy: +r.david.murray

[issue32212] few discrepancy between source and docs in logging

New submission from Michal Plichta : my code: logger = logging.getLogger(name) logger.setLevel(level=logging.DEBUG) ... stream_handler = logging.StreamHandler(stream=stdout) stream_handler.setLevel(logging_level) stream_handler.setFormatter(fmt=formatter) and mypy-0.550