[Patches] [ python-Patches-1216942 ] Suggested Additional Material for urllib2 docs
SourceForge.net
noreply at sourceforge.net
Sun Dec 4 21:01:05 CET 2005
Patches item #1216942, was opened at 2005-06-08 10:41
Message generated for change (Comment added) made by jjlee
You can respond by visiting:
https://sourceforge.net/tracker/?func=detail&atid=305470&aid=1216942&group_id=5470
Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
Category: Documentation
Group: None
Status: Open
Resolution: None
Priority: 5
Submitted By: Mike Foord (mjfoord)
Assigned to: Nobody/Anonymous (nobody)
Summary: Suggested Additional Material for urllib2 docs
Initial Comment:
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
:-)
----------------------------------------------------------------------
Comment By: John J Lee (jjlee)
Date: 2005-12-04 20:01
Message:
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.
----------------------------------------------------------------------
You can respond by visiting:
https://sourceforge.net/tracker/?func=detail&atid=305470&aid=1216942&group_id=5470
More information about the Patches
mailing list