[ python-Bugs-1239681 ] email.Utils.formatdate documetaion missing

[SourceForge.net]

Bugs item #1239681, was opened at 2005-07-17 12:09
Message generated for change (Tracker Item Submitted) made by Item Submitter
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1239681&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: None
Group: None
Status: Open
Resolution: None
Priority: 5
Submitted By: Nir Soffer (nirs)
Assigned to: Nobody/Anonymous (nobody)
Summary: email.Utils.formatdate documetaion missing

Initial Comment:
email.Utils.formatdate documentation does not mention that 
'usegmt' keyword argument is new on Python 2.4.

reference:
http://python.org/doc/2.4.1/lib/module-email.Utils.html
http://python.org/doc/2.3.5/lib/module-email.Utils.html

I don't know if its the rule, but usually the docs warn about new 
additions, and its very important when you try to create code that 
should work on multiple Python versions.

Suggested fix
replace:
"Optional usegmt is a flag that when True, outputs a date string with 
the timezone as an ascii string GMT, rather than a numeric -0000. 
This is needed for some protocols (such as HTTP). This only applies 
when localtime is False"

with:
"Optional usegmt is a flag that when True, outputs a date string with 
the timezone as an ascii string GMT, rather than a numeric -0000. 
This is needed for some protocols (such as HTTP). This only applies 
when localtime is False. New in Python 2.4."

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1239681&group_id=5470