pydoc data descriptor unification

[belm0]

BPO	936774
Nosy	@belm0
Files	pydoc_descriptors.patch: patch to pydoc test1.py: input example test1.txt: output example (text)

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2005-01-08.20:18:30.000>
created_at = <Date 2004-04-17.05:07:44.000>
labels = ['library']
title = 'pydoc data descriptor unification'
updated_at = <Date 2005-01-08.20:18:30.000>
user = 'https://github.com/belm0'

bugs.python.org fields:

activity = <Date 2005-01-08.20:18:30.000>
actor = 'jlgijsbers'
assignee = 'jlgijsbers'
closed = True
closed_date = None
closer = None
components = ['Library (Lib)']
creation = <Date 2004-04-17.05:07:44.000>
creator = 'jbelmonte'
dependencies = []
files = ['5927', '5928', '5929']
hgrepos = []
issue_num = 936774
keywords = ['patch']
message_count = 2.0
messages = ['45789', '45790']
nosy_count = 2.0
nosy_names = ['jlgijsbers', 'jbelmonte']
pr_nums = []
priority = 'normal'
resolution = 'accepted'
stage = None
status = 'closed'
superseder = None
type = None
url = 'https://bugs.python.org/issue936774'
versions = ['Python 2.4']

[belm0]

This patch to pydoc unifies the display of data
descriptors, including slots, properties, and custom
descriptors.

The changes are as follows:

* removed special handling of properties

* added special handling of data descriptors - All

data descriptors are grouped together in a section.
For each item, the attribute name and doc string, if
present, is displayed.

* disabled display of \_\_slots__ attribute - since

slots are descriptors, they are listed in the section
described above

A complementary change to Python will be to support
setting of doc strings on slots. The proposal is to
use dictionary values when __slots__ is a dictionary
object, as suggested in Guido's "Unifying types and
classes".

The rationale for these changes is described in
<http://mail.python.org/pipermail/python-dev/2004-April/044213.html\>.

[jlgijsbers]

Logged In: YES
user_id=469548

Checked in as rev 1.102 of pydoc.py, with some minor changes:

• renamed _docproperty to _docdescriptor
• made names of data descriptors bold, and put a newline
  between each of them, to be consistent with the rest of the
  methods and data