Bugs item #1202395, was opened at 2005-05-15 12:50
Message generated for change (Settings changed) made by rhettinger
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1202395&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: Closed
>Resolution: Fixed
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: Raymond Hettinger (rhettinger)
Date: 2005-05-31 05:27

Message:
Logged In: YES 
user_id=80475

Okay, fixed.
Thanks for the report.

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

Comment By: liturgist (liturgist)
Date: 2005-05-23 11:03

Message:
Logged In: YES 
user_id=197677

It would also be helpful to note the definition of
"whitespace" in each of the strip() methods.  It appears to
be defined in strip() as being identical to
string.whitespace.  However, I do not see a built-in
whitespace for strings.

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

Comment By: Terry J. Reedy (tjreedy)
Date: 2005-05-18 20: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 12: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