New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Link directly to set and frozenset in built-in function docs #60640
Comments
http://docs.python.org/3/library/functions.html#func-frozenset http://docs.python.org/3/library/functions.html#func-set frozenset and set function have no links to their definitions. Also the anchor name is prefixed with func, which is different to other builtin functions. |
I guess the reason is that names are classes, not functions. See http://docs.python.org/3/library/functions.html#func-dict also for example. |
Currently, the built-in types are not treated consistently as to whether their constructors are documented in the "Built-in Functions" or "Built-in Types" page. There are some open issues related to this topic (see, for example, bpo-16209). For the purposes of this issue though, yes, I agree that the abbreviated built-in function versions of the documentation for set and frozenset should contain direct links to the more complete constructor documentation in the "Built-in Types" page (as is already done for dict, for example, as Andrew pointed out). |
I recommend copying for set and frozenset the documentation pattern for dict (and in particular by stating explicitly in its own sentence that the object is a class): |
New changeset 16fa6462dfe1 by Chris Jerdonek in branch '3.2': New changeset d534da27ca8b by Chris Jerdonek in branch '3.3': New changeset 1fde0d70f2b8 by Chris Jerdonek in branch 'default': |
New changeset 24db5292c2c9 by Chris Jerdonek in branch '2.7': |
Fixed. Thanks a lot for the report, Yongzhi. |
Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.
Show more details
GitHub fields:
bugs.python.org fields:
The text was updated successfully, but these errors were encountered: