[Python-Dev] Descriptor write-up [Draft: Please comment]

[Raymond Hettinger]

In the spirit of Michele Simionato's write-up on method resolution order, I've written up almost everything I know about
descriptors:
http://tinyurl.com/d63d

Key features:
* Defines a descriptor
* Shows the protocol and how it is called
* Shows a handmade descriptor
* Then covers functions, properties, static and class methods
* Gives examples of each
* Suggests when each would be useful
* Gives a pure python definition of each
* Provides exact references into C source to save efforts in hunting down details

I would like to hammer this into something really useful.  So, any and all suggestions are welcome.


Raymond Hettinger


P.S.  I've borrowed Alex Martelli's style of making precise descriptions of how the CPython works by showing pure Python
equivalents.