Ezio Melotti added the comment: This came up while documenting the str type in datamodel.rst (IIRC), and linking to it from functions.rst.
On one hand you want to say what the str type is, on the other hand you want to document the constructor and explain how can you use str() to obtain str objects. Putting both under the constructor doesn't work too well, especially when there's a lot of text. Putting the str type description in a plain paragraph before the "class" directive doesn't work too well either, because :class:`str` will link to the constructor documentation. The idea is to keep the two separate but still provide an easy way to link to the class without missing the general description. ---------- _______________________________________ Python tracker <rep...@bugs.python.org> <http://bugs.python.org/issue16568> _______________________________________ _______________________________________________ Python-bugs-list mailing list Unsubscribe: http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
