Make 'pydoc coverage' more friendly

[nedbat]

Originally reported by Marius Gedminas (Bitbucket: mgedmin, GitHub: mgedmin)

---

Today if you do 'pydoc coverage', you get a bunch of opaque descriptions that look like this:

analysis = wrapper(*args, **kwargs)
    Singleton wrapper around a coverage method.

With my patch you see

analysis = wrapper(*args, **kwargs)
    analysis(morf)
    
    Like `analysis2` but doesn't return excluded line numbers.
    
    This function operates on a singleton coverage object created on first use.

---

• Bitbucket: https://bitbucket.org/ned/coveragepy/issue/205
• This issue had attachments: better-docstrings.diff. See the original issue for details.

[nedbat]

Thanks, fixed in <<changeset d0217f680cd8 (bb)>>.