This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author terry.reedy
Recipients docs@python, terry.reedy
Date 2011-04-04.16:16:00
SpamBayes Score 7.731951e-08
Marked as misclassified No
Message-id <1301933761.05.0.937546235723.issue11762@psf.upfronthosting.co.za>
In-reply-to
Content
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
History
Date User Action Args
2011-04-04 16:16:01terry.reedysetrecipients: + terry.reedy, docs@python
2011-04-04 16:16:01terry.reedysetmessageid: <1301933761.05.0.937546235723.issue11762@psf.upfronthosting.co.za>
2011-04-04 16:16:00terry.reedylinkissue11762 messages
2011-04-04 16:16:00terry.reedycreate