[issue27470] -3 commandline option documented differently via man
New submission from Matthew Gilson: The man page for python says:
Warn about Python 3.x incompatibilities that 2to3 cannot trivially fix.
The official documentation (https://docs.python.org/2/using/cmdline.html#cmdoption-3) does not mention 2to3 at all:
Warn about Python 3.x possible incompatibilities by emitting a DeprecationWarning for features that are removed or significantly changed in Python 3.
This seems like a pretty big oversight when the following code issues no warnings (presumably because 2to3 can trivially handle this change): ``` from __future__ import print_function class test(object): def __nonzero__(self): return False t = test() if t: print('Hello') ``` ---------- assignee: docs@python components: Documentation messages: 269994 nosy: docs@python, mgilson priority: normal severity: normal status: open title: -3 commandline option documented differently via man versions: Python 2.7 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue27470> _______________________________________
Changes by Berker Peksag <berker.peksag@gmail.com>: ---------- keywords: +easy nosy: +berker.peksag stage: -> needs patch type: -> behavior _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue27470> _______________________________________
Changes by Subhendu Ghosh <subho.prp@gmail.com>: ---------- pull_requests: +113 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue27470> _______________________________________
Changes by Mariatta Wijaya <mariatta.wijaya@gmail.com>: ---------- stage: needs patch -> patch review _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue27470> _______________________________________
Mariatta Wijaya added the comment: New changeset dd6e4aa113c6db4fcf9d252b5063ab217e8330a2 by Mariatta (Subhendu Ghosh) in branch '2.7': bpo-27470: Improve doc for commandline -3 option https://github.com/python/cpython/commit/dd6e4aa113c6db4fcf9d252b5063ab217e8... ---------- nosy: +Mariatta _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue27470> _______________________________________
Changes by Mariatta Wijaya <mariatta.wijaya@gmail.com>: ---------- resolution: -> fixed stage: patch review -> resolved status: open -> closed _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue27470> _______________________________________
participants (4)
-
Berker Peksag
-
Mariatta Wijaya
-
Matthew Gilson
-
Subhendu Ghosh