Social problems of Python doc [was Re: Python docs disappointing]

[Paul Rubin]

Carl Banks <pavlovevidence at gmail.com> writes:
> On> For example, kj (who started this mess of thread) complained that
> pydoc didn't give exhaustive usage documentation.  In contrast, I
> think pydoc gives too much information.  I would rather have only the
> bare minimum; I don't want to pan through ten paragraphs just to see
> what the fifth argument is.

The problem is that it doesn't sufficiently separate the carefully
written useful stuff from the automatically generated useless stuff.