This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: set documentation deficiencies
Type: Stage:
Components: Documentation Versions: Python 2.4
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: akuchling Nosy List: akuchling, georg.brandl, kbriggs
Priority: normal Keywords:

Created on 2006-02-10 12:07 by kbriggs, last changed 2022-04-11 14:56 by admin. This issue is now closed.

Messages (6)
msg27474 - (view) Author: Keith Briggs (kbriggs) Date: 2006-02-10 12:07
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?
msg27475 - (view) Author: Keith Briggs (kbriggs) Date: 2006-02-10 15:53
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.
msg27476 - (view) Author: Georg Brandl (georg.brandl) * (Python committer) Date: 2006-02-10 16:21
Logged In: YES 
user_id=1188172

This is all already corrected, except for the empty set thing.
msg27477 - (view) Author: Keith Briggs (kbriggs) Date: 2006-02-13 12:12
Logged In: YES 
user_id=888261

Where is it fixed?  I see all the same problems at
http://www.python.org/dev/doc/devel/lib/types-set.html.
msg27478 - (view) Author: Georg Brandl (georg.brandl) * (Python committer) Date: 2006-02-13 19:29
Logged In: YES 
user_id=1188172

The new location of the devel docs is
http://docs.python.org/dev.
msg27479 - (view) Author: A.M. Kuchling (akuchling) * (Python committer) Date: 2006-07-29 17:27
Logged In: YES 
user_id=11375

This bug seems to be fixed; closing.
History
Date User Action Args
2022-04-11 14:56:15adminsetgithub: 42883
2006-02-10 12:07:19kbriggscreate