Ramchandra Apte added the comment:
In my view, it is adequately documented now, should not be undocumented, and
should not be given more prominence either. So I recommend closing this.
+1
--
nosy: +Ramchandra Apte
___
Python tracker
Éric Araujo added the comment:
No problem.
--
resolution: - rejected
stage: patch review - committed/rejected
status: open - closed
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue12207
___
Mark Lawrence added the comment:
PyCF_ONLY_AST is defined in pythonrun.h and referenced in bltinmodule.c,
Python-ast.c and pythonrun.c. Should it be documented or not?
--
nosy: +BreamoreBoy
___
Python tracker rep...@bugs.python.org
Éric Araujo mer...@netwok.org added the comment:
FWIW this issue was also noted by Terry in #4118, but there was no reply.
--
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue12207
___
Éric Araujo mer...@netwok.org added the comment:
Another bug requesting documentation for a compiler flag exposed by a module:
#1612012.
If possible, I would have the index point to the first current
sentence, which also mentions .parse() as an alternative.
This should be possible:
Terry J. Reedy tjre...@udel.edu added the comment:
This is a bit tricky. It may be superseded, but it is still there, is possible
used in older code, has not been deprecated as far as I know, and appears in
dir(ast).
The two current mentions of PyCF_ONLY_AST in ast doc are:
An abstract
Éric Araujo mer...@netwok.org added the comment:
Okay. I’ll make another patch to remove mentions of this flag then.
--
versions: -Python 3.1
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue12207
New submission from Éric Araujo mer...@netwok.org:
Title says it all.
--
assignee: docs@python
components: Documentation
files: document-pycf-only-ast.diff
keywords: needs review, patch
messages: 137203
nosy: docs@python, eric.araujo
priority: normal
severity: normal
stage: patch review
Benjamin Peterson benja...@python.org added the comment:
Use of PyCF_ONLY_AST be superseded by ast.parse.
--
nosy: +benjamin.peterson
priority: normal - low
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue12207