[issue39112] Misleading documentation for tuple
New submission from Simon Berens <sberensnyc@gmail.com>: Sorry if this is a silly question (my first bug report), but it seems that https://docs.python.org/3/library/functions.html#func-tuple should say "class tuple" instead of just "tuple", as list, dict, and set do. ---------- assignee: docs@python components: Documentation messages: 358753 nosy: docs@python, sberens priority: normal severity: normal status: open title: Misleading documentation for tuple type: enhancement versions: Python 2.7, Python 3.5, Python 3.6, Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue39112> _______________________________________
Karthikeyan Singaravelan <tir.karthi@gmail.com> added the comment: FWIW, built-in types page has the class prefix : https://docs.python.org/3/library/stdtypes.html#tuple . Similar difference between range in the two pages. ---------- nosy: +xtreak _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue39112> _______________________________________
Terry J. Reedy <tjreedy@udel.edu> added the comment: I believe that this is a duplicate issue. As noted before, filter, map, reversed, and zip are classes, but they return iterators and are documented differently. ---------- nosy: +terry.reedy versions: -Python 3.5, Python 3.6 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue39112> _______________________________________
Karthikeyan Singaravelan <tir.karthi@gmail.com> added the comment: Thanks Terry, I guess it's a duplicate of issue34118 . ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue39112> _______________________________________
Change by Terry J. Reedy <tjreedy@udel.edu>: ---------- resolution: -> duplicate stage: -> resolved status: open -> closed superseder: -> Fix some class entries in 'Built-in Functions' _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue39112> _______________________________________
participants (3)
-
Karthikeyan Singaravelan
-
Simon Berens
-
Terry J. Reedy