[issue10289] Document magic methods called by built-in functions

2016-04-09 Thread Raymond Hettinger
Raymond Hettinger added the comment: Most of the proposed update look reasonable updates and would improve the documentation. That said, please take care to not accidentally document and unintentionally guarantee implementation details rather than language requirements (leaving freedom for

[issue10289] Document magic methods called by built-in functions

2016-04-09 Thread Mark Lawrence
Changes by Mark Lawrence : -- nosy: -BreamoreBoy ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.

[issue10289] Document magic methods called by built-in functions

2016-04-09 Thread Serhiy Storchaka
Changes by Serhiy Storchaka : -- nosy: +serhiy.storchaka versions: +Python 3.6 -Python 3.4 ___ Python tracker ___ ___ Python-bugs-list

[issue10289] Document magic methods called by built-in functions

2015-04-12 Thread Berker Peksag
Changes by Berker Peksag : -- nosy: +berker.peksag stage: needs patch -> patch review type: -> enhancement ___ Python tracker ___ ___

[issue10289] Document magic methods called by built-in functions

2015-04-11 Thread Martin Panter
Martin Panter added the comment: Sizeof is not relevant to the built-in functions as far as I know. It is already described at . Some more delegations that I think should be documented here (at least for Python 3): * abs() -> object

[issue10289] Document magic methods called by built-in functions

2014-07-13 Thread Chris Rebert
Changes by Chris Rebert : -- nosy: +cvrebert ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.pytho

[issue10289] Document magic methods called by built-in functions

2014-07-07 Thread Mark Lawrence
Mark Lawrence added the comment: Could #15436 "__sizeof__ is not documented" also be covered by this? -- nosy: +BreamoreBoy ___ Python tracker ___ ___

[issue10289] Document magic methods called by built-in functions

2014-07-07 Thread Mark Dickinson
Mark Dickinson added the comment: Should the Python 2.7 delegation of `round` to `__float__` for its input also be described as part of this issue? >>> class A(object): ... def __float__(self): return 1729.1 ... >>> round(A()) 1729.0 -- nosy: +mark.dickinson _

[issue10289] Document magic methods called by built-in functions

2014-07-07 Thread Andy Maier
Andy Maier added the comment: I reviewed the description of the built-in functions in Python 2.7, and found these issues: 1. The following built-in functions do not mention their underyling __special__ functions: - cmp() - delattr(), getattr(), hasattr(), setattr() - complex(), int(), long(),

[issue10289] Document magic methods called by built-in functions

2014-07-07 Thread Andy Maier
Andy Maier added the comment: Comments on the patch py34_v2: 1. On complex(): It delegates to object.__complex__(); that should also be described. 2. On hex(): The use of "__index__()" is text and should be changed to a hyperlink. Andy -- ___ Pyt

[issue10289] Document magic methods called by built-in functions

2014-07-07 Thread Andy Maier
Andy Maier added the comment: Uploaded v2 of the 3.4/default patch, which removes the comment line at the top of Doc/library/functions.rst (mentioned by Éric in the original message of this issue). -> Please review the patch. -> Please also double check whether there are any additional built-

[issue10289] Document magic methods called by built-in functions

2014-07-07 Thread Andy Maier
Andy Maier added the comment: Uploaded a patch for Python 3.4, and for merging into "default". The patch addresses items 1) to 3) from my previous post; item 4) does not need to be addressed IMHO. Andy -- keywords: +patch Added file: http://bugs.python.org/file35879/issue10289-magic-p

[issue10289] Document magic methods called by built-in functions

2014-07-04 Thread Andy Maier
Andy Maier added the comment: I have reviewed the descriptions of the built-in functions in Python 3.4, and found only the following issues w.r.t. missing __special__functions: 1. getattr(), setattr(), delattr(): They only refer to object attributes and miss to mention the fallback to object._

[issue10289] Document magic methods called by built-in functions

2010-11-01 Thread Alexander Belopolsky
Alexander Belopolsky added the comment: Éric, I just wanted to link to a related discussion we had under issue 8983. See msg107689. -- nosy: +belopolsky ___ Python tracker __

[issue10289] Document magic methods called by built-in functions

2010-11-01 Thread Éric Araujo
New submission from Éric Araujo : At the top of Doc/library/functions.rst, which documents built-in functions like abs, getattr or hash, a comment reads “document all delegations to __special__ methods”. Some functions are already good: enumerate for instance does link to the definition of it