[issue23639] Not documented special names

2015-09-02 Thread Serhiy Storchaka
Changes by Serhiy Storchaka : -- dependencies: +Clarify documentation of __getinitargs__, __self__ on built-in functions is not as documented ___ Python tracker

[issue23639] Not documented special names

2015-08-31 Thread Raymond Hettinger
Raymond Hettinger added the comment: > I think most of these are either implementation details > or "private" names, so there is no need to document them. Also, we want to be careful to not guarantee implementation details that are subject to change. Most of these are not intended for users

[issue23639] Not documented special names

2015-08-30 Thread Martin Panter
Changes by Martin Panter vadmium...@gmail.com: -- dependencies: +__base__ undocumented stage: needs patch - patch review ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue23639 ___

[issue23639] Not documented special names

2015-03-13 Thread Terry J. Reedy
Terry J. Reedy added the comment: Idlelib.rpc uses the somewhat arbitrary *strings* '__methods__' and '__attributes__' as private signals in its protocol. They are not object or attribute names, special or otherwise, in the sense used here. The use of '__methods__' in idlelib.rpc (line 176)

[issue23639] Not documented special names

2015-03-13 Thread Ian Lee
Changes by Ian Lee ianlee1...@gmail.com: -- nosy: +IanLee1521 ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue23639 ___ ___ Python-bugs-list mailing

[issue23639] Not documented special names

2015-03-12 Thread Martin Panter
Martin Panter added the comment: Some of these that I believe are at least partially documented, so could be added to the index. But the index for these is not very good anyway, because they are listed in a funny (ASCII-betical?) order in a special section called “symbols”, rather than

[issue23639] Not documented special names

2015-03-11 Thread Éric Araujo
Éric Araujo added the comment: I think like Ezio does. Python covers itself by saying that all names starting and ending with two underscores are reserved, and documents those that are interesting for users. On the other hand, many third-party frameworks/libs/apps invent their own __names__

[issue23639] Not documented special names

2015-03-11 Thread Peter Otten
Changes by Peter Otten __pete...@web.de: -- nosy: +peter.otten ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue23639 ___ ___ Python-bugs-list

[issue23639] Not documented special names

2015-03-11 Thread Serhiy Storchaka
New submission from Serhiy Storchaka: Here are lists of special names used in Python core and the stdlib, but absent in documentation index. Module level names used in pydoc: __author__ __credits__ __date__ __version__ Module level name used in doctest: __test__ Other

[issue23639] Not documented special names

2015-03-11 Thread Ezio Melotti
Ezio Melotti added the comment: I think most of these are either implementation details or private names, so there is no need to document them. The ones that are intended to be used by developers or that are useful to understand the functioning of a public API should be documented. If these

[issue23639] Not documented special names

2015-03-11 Thread Serhiy Storchaka
Changes by Serhiy Storchaka storch...@gmail.com: -- dependencies: +__sizeof__ is not documented ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue23639 ___

[issue23639] Not documented special names

2015-03-11 Thread Martin Panter
Changes by Martin Panter vadmium...@gmail.com: -- nosy: +vadmium ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue23639 ___ ___ Python-bugs-list