[ python-Bugs-1429053 ] set documentation deficiencies

[SourceForge.net]

Bugs item #1429053, was opened at 2006-02-10 12:07
Message generated for change (Comment added) made by kbriggs
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1429053&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: Python 2.4
Status: Open
Resolution: None
Priority: 5
Submitted By: Keith Briggs (kbriggs)
Assigned to: Nobody/Anonymous (nobody)
Summary: set documentation deficiencies

Initial Comment:
http://www.python.org/doc/current/lib/types-set.html
has a dead link: "Module sets".

Also, there does not seem to be any documentation on
how to construct a set.   Does set()==set([])?   What
is allowed  as an argument to set()?  Any iterable?

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

>Comment By: Keith Briggs (kbriggs)
Date: 2006-02-10 15:53

Message:
Logged In: YES 
user_id=888261

Furthermore, the operations update etc. are mutations of s,
so wouldn't the definitions

s.update(t)  	s |= t  	return set s with elements added from t
s.intersection_update(t) 	s &= t 	return set s keeping only
elements also found in t
s.difference_update(t) 	s -= t 	return set s after removing
elements found in t
s.symmetric_difference_update(t) 	s ^= t 	return set s with
elements from s or t but not both

be better as 

s.update(t)  	s |= t  	add elements from t to s

etc.?
I'm not sure what the word "return" is doing here.


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

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