[docs] [issue19557] ast - docs for every node type are missing

[anatoly techtonik]

New submission from anatoly techtonik:

http://docs.python.org/2/library/ast.html

AST module doc is incomplete. To write node visitor, you need to know possible types of parameters and expected values for every node type. They are different.

http://hg.python.org/cpython/file/1ee45eb6aab9/Parser/Python.asdl

For example, visit_Assign expects:
 Assign(targets, value)
   `targets` can be List, Tuple or Name

When there is List, and when there is Tuple? It should be documented.

----------
assignee: docs at python
components: Devguide, Documentation
messages: 202675
nosy: docs at python, ezio.melotti, techtonik
priority: normal
severity: normal
status: open
title: ast - docs for every node type are missing

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue19557>
_______________________________________