Mailman 3 November 2012 - docs

[issue16436] Missing anchor in doc
by Yongzhi Pan Nov. 9, 2012

Nov. 9, 2012

New submission from Yongzhi Pan: 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. ---------- assignee: docs@python components: Documentation messages: 175157 nosy: docs@python, fossilet priority: normal severity: normal status: open title: Missing anchor in doc versions: Python 3.3, Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue16436> _______________________________________

5 9

[issue16435] Python 3 doc link to Python 2 FAQ
by Yongzhi Pan Nov. 9, 2012

Nov. 9, 2012

New submission from Yongzhi Pan: http://docs.python.org/3/tutorial/whatnow.html The last paragraph links to http://www.python.org/doc/faq/, which defaults to Python 2 FAQ. ---------- assignee: docs@python components: Documentation messages: 175156 nosy: docs@python, fossilet priority: normal severity: normal status: open title: Python 3 doc link to Python 2 FAQ versions: Python 3.2, Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue16435> _______________________________________

4 6

Explanation of the term "cell" in Python reference missing or hard to find
by Peter Funk Nov. 9, 2012

Nov. 9, 2012

Hello, while reading in the Python reference manual I stumbled about this table entry: "__closure__ : None or a tuple of cells that contain bindings for the function’s free variables." http://docs.python.org/3.2/reference/datamodel.html This text block is inherited unchanged from Python 2 as in http://docs.python.org/2/reference/datamodel.html In both cases this is first and only use of the term "cell" in the whole data model chapter. I believe the term cell can have very different meanings in computer science (AFAIK: english is not my native language) and should be better defined or replaced by something else here. Or not? Regards, Peter Funk P.S.: Please Cc: me since I'm currently not subscribed to the docs mailing list. -- Peter Funk, home: ✉Oldenburger Str.86, D-27777 Ganderkesee mobile:+49-179-640-8878 phone:+49-421-20419-0 <http://www.artcom-gmbh.de/> office: ArtCom GmbH, ✉Haferwende 2, D-28357 Bremen, Germany

1 0

[issue16437] issubclass doc improvement
by Yongzhi Pan Nov. 8, 2012

Nov. 8, 2012

New submission from Yongzhi Pan: http://docs.python.org/3/library/functions.html#issubclass "classinfo may be a tuple of class objects." I suggest make it clear like isinstance, use something like this: classinfo may be a tuple of class objects and such tuples. ---------- assignee: docs@python components: Documentation messages: 175158 nosy: docs@python, fossilet priority: normal severity: normal status: open title: issubclass doc improvement versions: Python 3.3, Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue16437> _______________________________________

2 1

[issue16440] Exception type
by Yongzhi Pan Nov. 8, 2012

Nov. 8, 2012

New submission from Yongzhi Pan: http://docs.python.org/3/library/stdtypes.html#methods "Attempting to set a method attribute results in a TypeError being raised." But in the example, if we do c.method.whoami = 'c', we get AttributeError instead of TypeError. ---------- assignee: docs@python components: Documentation messages: 175174 nosy: docs@python, fossilet priority: normal severity: normal status: open title: Exception type versions: Python 2.7, Python 3.2, Python 3.3, Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue16440> _______________________________________

3 3

[issue16439] Code not collapsed correctly
by Yongzhi Pan Nov. 8, 2012

Nov. 8, 2012

New submission from Yongzhi Pan: http://docs.python.org/3/library/stdtypes.html#str.title The second snippets is not collapsed correctly. ---------- assignee: docs@python components: Documentation messages: 175171 nosy: docs@python, fossilet priority: normal severity: normal status: open title: Code not collapsed correctly versions: Python 2.7, Python 3.2, Python 3.3, Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue16439> _______________________________________

4 6

[issue11974] Class definition gotcha.. should this be documented somewhere?
by Ezio Melotti Nov. 8, 2012

Nov. 8, 2012

Changes by Ezio Melotti <ezio.melotti(a)gmail.com>: ---------- keywords: +easy stage: -> needs patch versions: +Python 3.2, Python 3.3, Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue11974> _______________________________________

1 0

[issue10589] I/O ABC docs should specify which methods have implementations
by Ezio Melotti Nov. 8, 2012

Nov. 8, 2012

Changes by Ezio Melotti <ezio.melotti(a)gmail.com>: ---------- stage: needs patch -> patch review versions: +Python 3.3, Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10589> _______________________________________

1 0

[issue10358] Doc styles for print should only use dark colors
by Fred L. Drake, Jr. Nov. 8, 2012

Nov. 8, 2012

New submission from Fred L. Drake, Jr. <fdrake(a)acm.org>: The HTML version of the documentation should include style settings for printing that use fairly dark colors, so that printed copies of pages are more readable. Using a printer that reduces colors to grays causes the light colors in code examples (or inlined references to classes and the like) to nearly drop out, making the result very painful to read. ---------- assignee: docs@python components: Documentation keywords: easy messages: 120741 nosy: docs@python, fdrake priority: normal severity: normal stage: needs patch status: open title: Doc styles for print should only use dark colors type: feature request _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10358> _______________________________________

3 3

[issue8939] Use C type names (PyUnicode etc; ) in the C API docs
by Ezio Melotti Nov. 8, 2012

Nov. 8, 2012

Ezio Melotti added the comment: What's the status of this? ---------- type: -> enhancement versions: +Python 3.3, Python 3.4 -Python 3.1 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8939> _______________________________________

1 0