[docs] list of depricate function on http://docs.python.org/library/string.html

[Jens Hvelplund Odborg]

Hi Sandro

I am not really the one to ask what to do about this since I fall in to the category "new commers to Python"

however I took a second glanze at this page 

and the section start with "The following list of functions are also defined as methods of string and Unicode objects; ..."

so it seems like "string.capitalize(word)" should be replaced with "word.capitalize()" where word in both cases are of type str

 

Yours sincerely,


Jens Hvelplund Odborg
Consultant
Generic Systems


Technology R&D
jehod at vestas.com
http://www.vestas.com


Company reg. name: Vestas 
This e-mail is subject to our e-mail disclaimer statement.
Please refer to www.vestas.com/legal/notice
If you have received this e-mail in error please contact the sender.


-----Original Message-----
From: matrixhasu at gmail.com [mailto:matrixhasu at gmail.com] On Behalf Of Sandro Tosi
Sent: 23. februar 2011 00:29
To: Jens Hvelplund Odborg
Cc: docs at python.org
Subject: Re: [docs] list of depricate function on http://docs.python.org/library/string.html

Hi Jens,
thanks for your email.

On Wed, Feb 2, 2011 at 13:17, Jens Hvelplund Odborg <jehod at vestas.com> wrote:
> Hi
>
> On the http://docs.python.org/library/string.html the section 7.1.6 is some
> what confusing in that some function is marked explicit whith a red box and
> a replacemen while other are not
> futher more many of those not marked with a red box are quite commonly used
> in other languages so a replacement would be nice for new commers to Python

I traced back the red boxes to this[1] commit.

[1] http://svn.python.org/view?view=revision&revision=17867

I actually don't know what to do exactly here: those functions are
deprecated from string module but they are still available in
string/unicode objects, so I'm inclined to leave things as they are,
unless you can show us a strong opinion on that along with a detailed
plan of how you'd like to see the doc to be change in this regards.

Cheers,

PS: resent to both recipients.

-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi