Sandro Tosi added the comment: Hi Éric, after #11085, I think the part of the doc you're referring to has been moved to collections.abc.rst, is that correct? If so, can you please explain what you'd like to see? all those ":class:`Container`" converted into ".. class:: Container" in the table? That will help me provide a patch :) ---------- nosy: +sandro.tosi versions: +Python 3.3 _______________________________________ Python tracker http://bugs.python.org/issue10617 _______________________________________

Sandro Tosi added the comment: but that will generate "class collections.abc.Container" as text in the first column of the table: do you really like it? I don't :) ---------- _______________________________________ Python tracker http://bugs.python.org/issue10617 _______________________________________

Changes by Ezio Melotti : ---------- nosy: +ezio.melotti _______________________________________ Python tracker http://bugs.python.org/issue10617 _______________________________________

Raymond Hettinger added the comment: Georg, do you have a recommendation? ---------- assignee: docs@python -> georg.brandl nosy: +rhettinger _______________________________________ Python tracker http://bugs.python.org/issue10617 _______________________________________

Ezio Melotti added the comment: Here's a patch that adds the list of classes with a minimal description before the table. I grouped a few classes to save some space. Container, Hashable, Sized, Callable could be grouped too. I also added links to the methods and to glossary terms (the `set` term is missing from the glossary though). The methods listed in the table can be turned to links too. (The :meth:`__len__ <__len__>` markup is to hide the () after the __method__.) ---------- assignee: georg.brandl -> ezio.melotti keywords: +patch stage: needs patch -> patch review Added file: http://bugs.python.org/file21318/issue10617.diff _______________________________________ Python tracker http://bugs.python.org/issue10617 _______________________________________

Georg Brandl added the comment: Yes; then the table entries will link to the descriptions below. ---------- _______________________________________ Python tracker http://bugs.python.org/issue10617 _______________________________________

Ezio Melotti added the comment: I put the list first and table second because the table contains more details and information, whereas the list only has a short description (usually the tables provide an overview and they are followed by a more comprehensive list). I didn't include the () after the methods name because they are not in the table, they look ugly on the special __methods__() and it's clear that they are methods even without the (). ---------- _______________________________________ Python tracker http://bugs.python.org/issue10617 _______________________________________

Ezio Melotti added the comment: I put the list under the table and grouped a few more ABCs. If this patch is OK I'll commit it. ---------- Added file: http://bugs.python.org/file21394/issue10617-2.diff _______________________________________ Python tracker http://bugs.python.org/issue10617 _______________________________________

Éric Araujo added the comment: What about making the class names in the table not links? ---------- _______________________________________ Python tracker http://bugs.python.org/issue10617 _______________________________________

Roundup Robot added the comment: New changeset c5de208d205c by Ezio Melotti in branch '3.1': #10617: add class directives to collections ABCs. http://hg.python.org/cpython/rev/c5de208d205c New changeset 3daca2b76297 by Ezio Melotti in branch '3.2': #10617: merge with 3.1. http://hg.python.org/cpython/rev/3daca2b76297 New changeset 30a026a25167 by Ezio Melotti in branch 'default': #10617: merge with 3.2. http://hg.python.org/cpython/rev/30a026a25167 ---------- _______________________________________ Python tracker http://bugs.python.org/issue10617 _______________________________________

Éric Araujo added the comment: Thanks Ezio. ---------- _______________________________________ Python tracker http://bugs.python.org/issue10617 _______________________________________