(Brought up on python-help)

The documentation for string.capitalize() says:

capitalize(word)
Capitalize the first character of the argument.

while it should really say what the documentation for
the corresponding string method says:

capitalize()
Return a copy of the string with only its first
character capitalized. 

since it makes the rest of the string lowercase.

Logged In: YES 
user_id=3066

Fixed in Doc/lib/libstring.tex revisions 1.47, 1.45.8.2, and
1.42.4.2.

Internal python docs need to be updated.
help(str.capitalize)
still has the old incorrect documentation.

I tested this on Python 2.6 on Windows, and Python 2.7 in Ubuntu 11.04 alpha.

I see correct doc strings on both 2.7 head and 3.1.