[issue3152] ast module docs document private attribute

2008-06-20 Thread Brett Cannon
New submission from Brett Cannon [EMAIL PROTECTED]: The docs for the ast module document the '_fields' attribute on AST instances. Either that documentation needs to go away or the attribute needs to be renamed as the leading underscore means it is private to the internal API. --

[issue3152] ast module docs document private attribute

2008-06-20 Thread Georg Brandl
Georg Brandl [EMAIL PROTECTED] added the comment: I disagree. The AST classes are auto-generated, the leading underscore of _fields is there to avoid clashes with field names from the AST types. This is similar to http://docs.python.org/dev/library/collections#collections.somenamedtuple._fields

[issue3152] ast module docs document private attribute

2008-06-20 Thread Raymond Hettinger
Raymond Hettinger [EMAIL PROTECTED] added the comment: This is consistent with the methods in named tuples (also to avoid name clashes). -- components: +None keywords: +26backport nosy: +rhettinger ___ Python tracker [EMAIL PROTECTED]

[issue3152] ast module docs document private attribute

2008-06-20 Thread Martin v. Löwis
Martin v. Löwis [EMAIL PROTECTED] added the comment: I agree with Georg and Raymond, closing this as won't fix. -- nosy: +loewis resolution: - wont fix status: open - closed ___ Python tracker [EMAIL PROTECTED] http://bugs.python.org/issue3152