Wrong "See also" in symbol and token module docs

[davipo]

BPO	11984
Nosy	@merwok, @sandrotosi

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2012-01-05.18:09:41.187>
created_at = <Date 2011-05-03.06:45:50.514>
labels = ['docs']
title = 'Wrong "See also" in symbol and token module docs'
updated_at = <Date 2012-01-05.18:09:41.176>
user = 'https://bugs.python.org/davipo'

bugs.python.org fields:

activity = <Date 2012-01-05.18:09:41.176>
actor = 'sandro.tosi'
assignee = 'docs@python'
closed = True
closed_date = <Date 2012-01-05.18:09:41.187>
closer = 'sandro.tosi'
components = ['Documentation']
creation = <Date 2011-05-03.06:45:50.514>
creator = 'davipo'
dependencies = []
files = []
hgrepos = []
issue_num = 11984
keywords = []
message_count = 4.0
messages = ['135017', '135338', '150679', '150680']
nosy_count = 5.0
nosy_names = ['eric.araujo', 'davipo', 'sandro.tosi', 'docs@python', 'python-dev']
pr_nums = []
priority = 'normal'
resolution = 'fixed'
stage = 'resolved'
status = 'closed'
superseder = None
type = None
url = 'https://bugs.python.org/issue11984'
versions = ['Python 2.7', 'Python 3.2', 'Python 3.3']

[davipo]

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.

[merwok]

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.

[python-dev]

New changeset d8102ccc5bf7 by Sandro Tosi in branch '2.7':
Issue bpo-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 bpo-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 bpo-11984: merge with 3.2
http://hg.python.org/cpython/rev/f375a1be031c

[sandrotosi]

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.