New submission from Terry J. Reedy <tjre...@udel.edu>:
Two related proposals.
1. Add a warning similar to the one for the dis module. As modified:
"CPython implementation detail: The ast definition is specific to the CPython
interpreter! Ast nodes may be added, removed, or changed between versions. Use
*ast.__version__* to work across versions."
I omitted " Use of this module should not be considered to work across Python
VMs or Python releases." as redundant and too legalistic.
*ast.__version__* should link to its (new) entry).
2. Add a full entry for __version__. Currently (3.2):
"The module defines a string constant __version__ which is the decimal
Subversion revision number of the file shown below."
Proposed replacement (with hidden reference point):
ast.__version__ [__version__ in normal entry boldface]
String constant with version number of abstract grammar file.
3.1: 67616; 3.2: 82163; 3.3: xxxxxxxxx
----------
assignee: docs@python
components: Documentation
messages: 132951
nosy: docs@python, terry.reedy
priority: normal
severity: normal
stage: needs patch
status: open
title: Ast doc: warning and version number
versions: Python 2.7, Python 3.2, Python 3.3
_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue11762>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe:
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
