Bugs item #1202395, was opened at 2005-05-15 13:50
Message generated for change (Comment added) made by tjreedy
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1202395&group_id=5470

Category: Documentation
Group: None
Status: Open
Resolution: None
Priority: 5
Submitted By: Roy Smith (roysmith)
Assigned to: Nobody/Anonymous (nobody)
Summary: Description of string.lstrip() needs improvement

Initial Comment:
In http://docs.python.org/lib/string-methods.html, under lstrip(), it 
says,

"chars must be a string; the characters in the string will be stripped 
from the beginning of the string this method is called on".

It would be clearer if it said:

"chars must be a string; the characters in the string constitute a set 
of characters to be stripped from the beginning of the string this 
method is called on".

Similarly for rstrip() and strip().

There was a recent posting to comp.lang.python where it appears 
that the poster thought the argument to lstrip() was a leading string 
to be removed, not a set of characters.



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

>Comment By: Terry J. Reedy (tjreedy)
Date: 2005-05-18 21:18

Message:
Logged In: YES 
user_id=593130

Over the years, several people have tripped over this and posted 
to c.l.p., so I think the existing text is unclear enough to arguably 
qualify as a buglet.  In response to the same posting, I had the 
same thought of clarifying that the 'string' defines a set, so I 
support this suggestion or something similar ;-) and thank you for 
submitting it.

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

Comment By: Roy Smith (roysmith)
Date: 2005-05-15 13:55

Message:
Logged In: YES 
user_id=390499

I notice bug #1196824 (recently submitted and closed as "not a bug") 
relates to the same issue.  It seems more than one person has gotten 
confused by this :-)


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

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1202395&group_id=5470
_______________________________________________
Python-bugs-list mailing list 
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to