[docs] Harmonizing descriptor protocol documentation (issue 12077)

berker.peksag at gmail.com berker.peksag at gmail.com
Tue Feb 12 10:20:42 CET 2013


http://bugs.python.org/review/12077/diff/7351/Doc/howto/descriptor.rst
File Doc/howto/descriptor.rst (right):

http://bugs.python.org/review/12077/diff/7351/Doc/howto/descriptor.rst#newcode393
Doc/howto/descriptor.rst:393: '''Emulate PyStaticMethod_Type() in
Objects/funcobject.c'''
Nit: I would use triple quotes.

See PEP 257:

"For consistency, always use """triple double quotes""" around
docstrings."

http://www.python.org/dev/peps/pep-0257/

http://bugs.python.org/review/12077/diff/7351/Doc/howto/descriptor.rst#newcode419
Doc/howto/descriptor.rst:419: is to create alternate class constructors.
 In Python 2.3, the classmethod
Python 2.3 is almost 10 years old. I think this part can be deleted (at
least in Python 3).

http://bugs.python.org/review/12077/


More information about the docs mailing list