[issue11984] Wrong "See also" in symbol and token module docs
New submission from Davi Post <post@pobox.com>: The "See also" reference in the documentation for the token and symbol modules is no longer accurate. The "second example" mentioned was apparently removed in Python 2.7. This leaves no explanation for how to use the symbol module. I don't think this "See also" belongs in the token module at all. (It's in Python 2.5 and 2.6 as well.) http://docs.python.org/release/2.7.1/library/symbol.html See also: Module parser The second example for the parser module shows how to use the symbol module. ---------- assignee: docs@python components: Documentation messages: 135017 nosy: davipo, docs@python priority: normal severity: normal status: open title: Wrong "See also" in symbol and token module docs versions: Python 2.7, Python 3.1, Python 3.2, Python 3.3 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue11984> _______________________________________
Éric Araujo <merwok@netwok.org> added the comment: IIUC, the parser and token module somehow can be used together. If so, the interlinks are okay, provided the text is revised to remove mention of the “second example”. If I’m wrong, let’s remove the link. ---------- nosy: +eric.araujo _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue11984> _______________________________________
Roundup Robot <devnull@psf.upfronthosting.co.za> added the comment: New changeset d8102ccc5bf7 by Sandro Tosi in branch '2.7': Issue #11984: remove reference to parser, it's not showing symbol usage anymore http://hg.python.org/cpython/rev/d8102ccc5bf7 New changeset b326d90ce9c9 by Sandro Tosi in branch '3.2': Issue #11984: remove reference to parser, it's not showing symbol usage anymore http://hg.python.org/cpython/rev/b326d90ce9c9 New changeset f375a1be031c by Sandro Tosi in branch 'default': Issue #11984: merge with 3.2 http://hg.python.org/cpython/rev/f375a1be031c ---------- nosy: +python-dev _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue11984> _______________________________________
Sandro Tosi <sandro.tosi@gmail.com> added the comment: Hi Davi, thanks for your report! I've removed the reference from symbol to parser, given this last module doesn't show anymore how to user symbol, and it's encouraging to use ast module instead. ---------- nosy: +sandro.tosi resolution: -> fixed stage: -> committed/rejected status: open -> closed versions: -Python 3.1 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue11984> _______________________________________
participants (4)
-
Davi Post -
Roundup Robot
-
Sandro Tosi
-
Éric Araujo