Mailman 3 April 2000 - Doc-SIG

Nit in "urllib" library documentation
by Ka-Ping Yee Oct. 10, 2000

Oct. 10, 2000

See http://www.python.org/doc/1.5.2p2/lib/module-urllib.html The last chunk of the section on "urlopen" appears to be repeated twice: The urlopen() function works transparently with proxies... For example (the "%" is the command prompt): ... In a Macintosh environment, urlopen() will retrieve proxy information from Internet Config. The urlopen() function works transparently with proxies... For example (the "%" is the command prompt): ... In a Macintosh environment, urlopen() will retrieve proxy information from Internet Config. -- ?!ng

2 1

library reference contents
by Ka-Ping Yee Oct. 10, 2000

Oct. 10, 2000

The contents page of the Library Reference has a few warts: - A few section headers (e.g. operator, pprint, repr) end in periods that probably ought to be deleted. (Complete list: 3.5, 3.23, 3.24, 3.27, 3.32, 4.2, 4.3, 4.5, 5.10, 6.13, 6.15, 7.1, 7.6, 11.11, 11.12, 11.13, 12.13, 12.14, 14.9, 14.10, 15.4.) - Description of 3.28 "new" doesn't make much sense: "runtime implementation object creation" (probably you want to replace "implementation" with "instance") - Description of 4.3 "regex" should probably say "old" or "deprecated". - Description of 6.12 "curses" has a spelling mistake: "Terminal independant (sic) console handling". - Description of 7.14 "rlcompleter" probably ought to say "Completion function for GNU readline". - Descriptions of 11.14 "SimpleHTTPServer" and 11.15 "CGIHTTPServer" seem strange: "A Do-Something Request Handler". Suggest "11.14 SimpleHTTPServer -- A simple HTTP request handler" and "11.16 CGIHTTPServer -- A CGI-capable HTTP request handler". Hope this helps. -- ?!ng "I'm not trying not to answer the question; i'm just not answering it." -- Lenore Snell

2 1

Unicode documentation
by Fred L. Drake, Jr. April 18, 2000

April 18, 2000

I've added Marc-Andre Lemburg's documentation updates for Unicode to the CVS repository. I still have a bunch of other patches and bug reports to deal with, but I'm going to do some paying work for a few hours now. ;) -Fred -- Fred L. Drake, Jr. <fdrake at acm.org> Corporation for National Research Initiatives

2 1

HTML versions of documentation.
by Mark Hammond April 6, 2000

April 6, 2000

It would be great if I could get HTML versions of the documentation from the CVS tex versions.. So I started to have a look into the build process. It looks a little complicated, and attempting to perform it on Windows sounds like I would be blazing trails that are better left as old-growth :-) So, I guess my questions are (stop as soon as you can answer "yes" :-) * Has anyone built HTML on Windows? If so and its not too painful, this is my simplest route. * Does anyone know of a CRON job that already does this? * If all else fails, would someone be able to respond to my calls for help should I attempt to perform this automatically on starship (sort of a-la DA's tarballing of CVS)? Does anyone know why starship _wouldnt_ be able to build the .html? Mark.

3 3