Chris Jerdonek added the comment:
This was addressed by issue #16209 since with that change :class:`str` and
:func:`str` now both go to the new str class entry in the string type section.
See also the new issue #16568.
--
resolution: - duplicate
status: open - closed
superseder: -
Ezio Melotti added the comment:
If :class:`str` and :func:`str` point respectively to stdtypes.rst and
functions.rst once a class directive is added to stdtypes.rst, then we can do
that. We might than need to update a few links to use :class: instead of
:func:, and possibly use
Ezio Melotti added the comment:
Adding a class directive for str is tracked in #16209.
--
dependencies: +add a class str entry to the docs
___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue16205
Chris Jerdonek added the comment:
If :class:`str` and :func:`str` point respectively to stdtypes.rst and
functions.rst once a class directive is added to stdtypes.rst, then we can do
that.
I agree. I would suggest starting small by adding a stub class entry above the
string methods. The
New submission from Chris Jerdonek:
3.3 added a dedicated section to the docs for the str type. However,
references to :class:`str` still link to the documentation of the built-in
function str().
This issue is to update references to the str class to point to the new section
on the str
Chris Jerdonek added the comment:
I'm not sure if Sphinx would allow it, but it would be nice if references to
the function str() could link to the built-in function documentation, and
references to the class str could link to the section on the str type.
--
Chris Jerdonek added the comment:
The documentation seems to take a similar approach with dict:
http://docs.python.org/dev/library/stdtypes.html#dict
http://docs.python.org/dev/library/functions.html#func-dict
--
___
Python tracker