search

python / cpython

The Python programming language
https://www.python.org/
Other
59.97k stars 29.02k forks source link

help(UNICODE) -- reference page missing #37336

Closed 6946bf88-cffc-4924-b2d6-5b421a70baa0 closed 21 years ago

6946bf88-cffc-4924-b2d6-5b421a70baa0 commented 21 years ago
BPO 624860
Nosy @freddrake

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: ```python assignee = None closed_at = created_at = labels = ['docs'] title = 'help(UNICODE) -- reference page missing' updated_at = user = 'https://bugs.python.org/scottdaniels' ``` bugs.python.org fields: ```python activity = actor = 'nnorwitz' assignee = 'nnorwitz' closed = True closed_date = None closer = None components = ['Documentation'] creation = creator = 'scott_daniels' dependencies = [] files = [] hgrepos = [] issue_num = 624860 keywords = [] message_count = 3.0 messages = ['12823', '12824', '12825'] nosy_count = 3.0 nosy_names = ['fdrake', 'nnorwitz', 'scott_daniels'] pr_nums = [] priority = 'normal' resolution = 'fixed' stage = None status = 'closed' superseder = None type = None url = 'https://bugs.python.org/issue624860' versions = ['Python 2.2'] ```

6946bf88-cffc-4924-b2d6-5b421a70baa0 commented 21 years ago 
Entering IDLE in 2.2.2 on Win2K:
    >>> help()
    help> topics
Lists (among many others), UNICODE.  Howver,
    help> UNICODE
elicits the error:
    could not read docs 
    from C:\PYTHON22\doc/ref/unicode.html

It seemed the only entry in topics that did fail, but I am not certain this is so.

freddrake commented 21 years ago

Logged In: YES user_id=3066

I've looked into this briefly, and it looks like this is caused by the pydoc module (which implements the interactive help facility) having a static mapping of topic names to HTML files. Since this list is static in the code, and not generated from the documentation in any way, it's out of date. That section (which was available for Python 2.1.x) was never filled in with anything more than "XXX explain more here...".

It's not at all clear what documentation this should point to; I suspect it's material that still needs to be written. I'll open a separate bug on the matter that the list of topics is not integrated with the documentation maintenance -- it should be so we're more aware of this mapping and don't break it accidentally.

d21744ff-f396-4c71-955e-7dbd2e886779 commented 21 years ago

Logged In: YES user_id=33168

This was fixed recently by change for bug bpo-642168.