[ python-Bugs-1119282 ] Docs for set() omit constructor

[SourceForge.net]

Bugs item #1119282, was opened at 2005-02-09 08:27
Message generated for change (Comment added) made by rhettinger
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1119282&group_id=5470

Category: Documentation
Group: Python 2.4
Status: Open
Resolution: None
Priority: 5
Submitted By: Kent Johnson (kjohnson)
Assigned to: Nobody/Anonymous (nobody)
Summary: Docs for set() omit constructor

Initial Comment:
The documentation for set() and frozenset() in the
library reference section 2.3.7 has no explicit
description of how to create a set or frozenset. IOW,
nowhere does it say what the argument(s) to set() and
frozenset() are.

The text from section 5.15 (the sets module) should be
usable here.

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

>Comment By: Raymond Hettinger (rhettinger)
Date: 2005-02-09 13:51

Message:
Logged In: YES 
user_id=80475

Following the style for list(), dict(), and tuple(), the
constructor for set() and frozenset() is documented in
section 2.1 (builtin functions).

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

Comment By: Kent Johnson (kjohnson)
Date: 2005-02-09 08:37

Message:
Logged In: YES 
user_id=49695

Ah, it's documented in section 2.1, Built-in Functions.

A cross-reference from section 2.3.7 might be helpful...e.g.

"Instances of set and frozenset may be created by calling
the set() and frozenset() built-in functions; see Section
2.1, Built-in Functions, for details."

BTW the same suggestion applies for dict(), list() and
tuple() - some mention of them in sections 2.3.6 and 2.3.8
seems appropriate.

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

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