[Python-Dev] [Python-checkins] cpython: Fix reST label for collections ABCs.

Raymond Hettinger raymond.hettinger at gmail.com
Fri Jun 3 19:43:14 CEST 2011


On Jun 3, 2011, at 10:27 AM, eric.araujo wrote:
> 
>  Fix reST label for collections ABCs.
> 
> The previous markup hijacked the abstract-base-classes glossary entry,
> which resulted in the HTML linking to collections.abc when defining the
> generic ABC concept.  Now the glossary links to the abc module.

I think the users are better served by links to collections.abc, io.abc, etc.
For the most part, glossary readers will be interested in actual
abstract classes than in the underlying implementation.

IOW, I believe this edit makes the docs worse rather than better.


Raymond
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/python-dev/attachments/20110603/43b3b816/attachment.html>


More information about the Python-Dev mailing list