New submission from Chris Jerdonek <chris.jerdo...@gmail.com>:

The "Economy of Expression" section of the Dev Guide's "Documenting Python"--

http://docs.python.org/devguide/documenting.html#economy-of-expression

says, "The documentation for super() is an example of where a good deal of 
information was condensed into a few short paragraphs."

However, the documentation for super() is now nine short paragraphs.  Back in 
Python 2.2 (when super() was introduced), the description really was only two 
short paragraphs (along with a brief code snippet):

http://docs.python.org/release/2.2.3/lib/built-in-funcs.html

So this might no longer be the best example.

----------
components: Devguide
keywords: easy
messages: 164788
nosy: cjerdonek, ezio.melotti
priority: normal
severity: normal
status: open
title: "Economy of Expression" section outdated
versions: Python 3.3

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue15270>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to