This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: Suggested Additional Material for urllib2 docs
Type: Stage:
Components: Documentation Versions:
process
Status: closed Resolution:
Dependencies: Superseder:
Assigned To: fdrake Nosy List: fdrake, jjlee, michael.foord
Priority: normal Keywords: patch

Created on 2005-06-08 09:41 by michael.foord, last changed 2022-04-11 14:56 by admin. This issue is now closed.

Files
File name Uploaded Description Edit
urllib2.txt michael.foord, 2005-06-08 09:41 Suggested addition to urllib2 docs.
Messages (7)
msg48445 - (view) Author: Michael Foord (michael.foord) * (Python committer) Date: 2005-06-08 09:41
This is some suggested additional material for the 
urllib2 docs.

Particularly the part about error codes and the 
reason/code attributes of error objects is *missing* from 
the manual and needed.

Also the example showing basic Authentication using 
password manager/handler/opener may help avoid some 
confusion.

Alternatively you can link to my online tutorials at 
http://www.voidspace.org.uk/python/articles.shtml#http

:-)

msg48446 - (view) Author: John J Lee (jjlee) Date: 2005-12-04 20:01
Logged In: YES 
user_id=261020

I'm sure doc improvements are welcome here, so thank you :)

However, I think you need to

1) split this up into small patches that address very
specific issues, and briefly justify each change in the
patch submission note on the SF patch tracker

2) present the patches by editing the original .tex source
files from src/Doc/lib and then running 'diff -u' or 'svn
diff'  (it doesn't matter if you can't compile the docs or
get the TeX markup wrong, just as long as everybody can see
exactly what the intended changes to the text are)

Also, one thing that caught my eye on a very brief scan was
that the actual response code->name mapping (rather than a
note to document the existence of that mapping) shouldn't be
reproduced in the docs, I think.
msg48447 - (view) Author: Fred Drake (fdrake) (Python committer) Date: 2005-12-22 14:53
Logged In: YES 
user_id=3066

I'll TeXify.  I agree with John about reproducing the
response code listing; that's a good place to simply defer
to the HTTP spec.
msg48448 - (view) Author: John J Lee (jjlee) Date: 2005-12-22 22:01
Logged In: YES 
user_id=261020

Fred, what will you TeXify?  Are you waiting for Mike to
reply, or were you saying that you'll TeXify what he already
submitted?

Personally, I'm not happy with the original as-is, foremost
because it's not clear how it is intended to fit with the
existing docs (there are certainly other problems with the
suggested additions, but not much point going into detail
before there's a patch).  I would be happy to review / edit
at least some of the content it if it were presented as
patch(es).
msg48449 - (view) Author: John J Lee (jjlee) Date: 2005-12-22 22:07
Logged In: YES 
user_id=261020

Just to shout it out again: no need for said patches to
contain TeX markup!-)  Plain text / reST pasted into the
existing docs is ok (though making it clear by some means
what is a heading and what isn't &c. is obviously
desirable).  I only want a patch because that would make it
clear how the additions are intended to be integrated with
the existing docs. 
msg48450 - (view) Author: John J Lee (jjlee) Date: 2006-05-02 01:22
Logged In: YES 
user_id=261020

Andrew Kuchling checked in Michael's tutorial as a howto, so
I guess this can be closed.
msg48451 - (view) Author: Fred Drake (fdrake) (Python committer) Date: 2006-06-10 20:21
Logged In: YES 
user_id=3066

Closed as suggested.
History
Date User Action Args
2022-04-11 14:56:11adminsetgithub: 42063
2005-06-08 09:41:49mjfoordcreate