#10961: Pydoc touchups in new 3.2 Web server (issue4090042)

[merwok]

BPO	10975
Nosy	@merwok

^{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 2011-01-21.18:48:31.953>
created_at = <Date 2011-01-21.18:46:03.396>
labels = ['invalid']
title = '#10961: Pydoc touchups in new 3.2 Web server (issue4090042)'
updated_at = <Date 2011-01-29.19:15:38.154>
user = 'https://github.com/merwok'

bugs.python.org fields:

activity = <Date 2011-01-29.19:15:38.154>
actor = 'eric.araujo'
assignee = 'none'
closed = True
closed_date = <Date 2011-01-21.18:48:31.953>
closer = 'eric.araujo'
components = []
creation = <Date 2011-01-21.18:46:03.396>
creator = 'eric.araujo'
dependencies = []
files = []
hgrepos = []
issue_num = 10975
keywords = []
message_count = 2.0
messages = ['126765', '126766']
nosy_count = 1.0
nosy_names = ['eric.araujo']
pr_nums = []
priority = 'normal'
resolution = 'not a bug'
stage = 'resolved'
status = 'closed'
superseder = None
type = None
url = 'https://bugs.python.org/issue10975'
versions = []

[merwok]

Some comments. Haven’t tested the patch yet.

http://codereview.appspot.com/4090042/diff/1/Lib/pydoc.py
File Lib/pydoc.py (right):

http://codereview.appspot.com/4090042/diff/1/Lib/pydoc.py#newcode2507
Lib/pydoc.py:2507: <div style='overflow:auto'>
Does this work fine with common Web browsers, including not-most-recent
versions, and various resolutions? (“fine” being defined as “not worse
than before the patch”)

http://codereview.appspot.com/4090042/diff/1/Lib/pydoc.py#newcode2591
Lib/pydoc.py:2591: return '<a href="topic?key=%s.html">%s</a>' % (name,
name)
I see no reason for polluting the key value with “.html”

http://codereview.appspot.com/4090042/diff/1/Lib/pydoc.py#newcode2713
Lib/pydoc.py:2713: raise TypeError('unknown content type %r' % ([url,
content_type]))
You can remove the extraneous parens around the list.

http://codereview.appspot.com/4090042/diff/1/Lib/test/test_pydoc.py
File Lib/test/test_pydoc.py (right):

http://codereview.appspot.com/4090042/diff/1/Lib/test/test_pydoc.py#newcode431
Lib/test/test_pydoc.py:431: ("", "PyDoc: Index of Modules"),
I’m not sure “PyDoc” is better than “Python”. What about “Python Doc”?
Very clear and still short.

http://codereview.appspot.com/4090042/

[merwok]

One day, email from rietveld will go to the right roundup report.