[issue16015] Incorrect startup header in tutorial
New submission from Ramchandra Apte: In http://docs.python.org/py3k/tutorial/interpreter.html#interactive-mode , the header shown is "Python 3.2 (py3k, Sep 12 2007, 12:21:02)". Python 3.2 was no made in Sep 12 2007, so it could not be compiled at that time. It should be a correct date or the date of today. ---------- assignee: docs@python components: Documentation messages: 171126 nosy: docs@python, ramchandra.apte priority: normal severity: normal status: open title: Incorrect startup header in tutorial _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue16015> _______________________________________
Ezio Melotti added the comment: Looks like the version got updated but not the rest, even the 3.3 doc has the same date. ---------- nosy: +ezio.melotti stage: -> needs patch type: -> enhancement _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue16015> _______________________________________
Ramchandra Apte added the comment: The later lines also needs to be updated. ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue16015> _______________________________________
Ramchandra Apte added the comment: In http://docs.python.org/dev/tutorial/introduction.html, there is an ... line which is impossible in that case: Variables must be “defined” (assigned a value) before they can be used, or an error will occur:
# try to access an undefined variable
... n Traceback (most recent call last): File "<stdin>", line 1, in <module> NameError: name 'n' is not defined
It should be:
n # try to access an undefined variable Traceback (most recent call last): File "<stdin>", line 1, in <module> NameError: name 'n' is not defined
---------- title: Incorrect startup header in tutorial -> impossible ... line in tutorial _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue16015> _______________________________________
Ramchandra Apte added the comment: Oops! The last message should be in a new issue. ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue16015> _______________________________________
Changes by Ramchandra Apte <maniandram01@gmail.com>: ---------- title: impossible ... line in tutorial -> Incorrect startup header in tutorial _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue16015> _______________________________________
Ezio Melotti added the comment: I'm not sure it's worth updating it, it will probably get outdated again when new versions are released. Also this is just an example, the actual header and dates might be different depending on the version/.OS/compiler. ---------- versions: +Python 3.2, Python 3.3 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue16015> _______________________________________
Éric Araujo added the comment: Suggest closing: I think this causes no issue and changing it would have no benefit. ---------- nosy: +eric.araujo _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue16015> _______________________________________
Roundup Robot added the comment: New changeset 5f4841977bee by Chris Jerdonek in branch '3.2': Issue #16015: Fix NameError doctest example in tutorial introduction. http://hg.python.org/cpython/rev/5f4841977bee New changeset dae33c2e916b by Chris Jerdonek in branch 'default': Issue #16015: Merge fix from 3.2. http://hg.python.org/cpython/rev/dae33c2e916b New changeset 878c33d2f301 by Chris Jerdonek in branch '2.7': Issue #16015: Fix NameError doctest example in tutorial introduction. http://hg.python.org/cpython/rev/878c33d2f301 ---------- nosy: +python-dev _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue16015> _______________________________________
Chris Jerdonek added the comment: I don't mind fixing the year suggestion (in the interest of "realism" and for practice). ---------- nosy: +chris.jerdonek _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue16015> _______________________________________
Ezio Melotti added the comment: OK. If you change the date also change s/py3k/default/, py3k was used on the SVN days. Here is what my header looks like: $ python3 Python 3.2.3 (default, May 3 2012, 15:54:42) [GCC 4.6.3] on linux2 Type "help", "copyright", "credits" or "license" for more information. While you are at it, you could also add .. code-block:: sh. ---------- stage: needs patch -> type: enhancement -> _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue16015> _______________________________________
Roundup Robot added the comment: New changeset d2df5bc89fc9 by Chris Jerdonek in branch '3.2': Issue #16015: Make welcome message more realistic in tutorial example. http://hg.python.org/cpython/rev/d2df5bc89fc9 New changeset fcb5bc824e3e by Chris Jerdonek in branch 'default': Issue #16015: Merge and update from 3.2. http://hg.python.org/cpython/rev/fcb5bc824e3e ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue16015> _______________________________________
Chris Jerdonek added the comment: Fixed, and thanks for the report! (Ezio, I didn't add "code-block:: sh" because it resulted in some undesired highlighting in the interpreter portion when I tried it.) ---------- resolution: -> fixed stage: -> committed/rejected status: open -> closed _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue16015> _______________________________________
participants (5)
-
Chris Jerdonek -
Ezio Melotti
-
Ramchandra Apte
-
Roundup Robot
-
Éric Araujo