Mailman 3 February 2014 - docs

[issue13663] pootle.python.org is outdated.
by INADA Naoki Feb. 16, 2014

Feb. 16, 2014

New submission from INADA Naoki <songofacandy(a)gmail.com>: I am one of Japanese translate of Python documents. We have done translating Python 2.7 document and will start translating Python 3.2 or 3.3. I want to use sphinx-i18n and pootle to translate. But http://pootle.python.org/ is very outdated. Anyone can update the site? If nobody maintain the site, could I create Python Document project at http://pootle.locamotion.org/ ? ---------- assignee: docs@python components: Documentation messages: 150261 nosy: docs@python, naoki priority: normal severity: normal status: open title: pootle.python.org is outdated. versions: Python 2.7, Python 3.2, Python 3.3, Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue13663> _______________________________________

8 10

[issue16728] Missing cross-reference in sequence glossary entry
by A.M. Kuchling Feb. 16, 2014

Feb. 16, 2014

Changes by A.M. Kuchling <amk(a)amk.ca>: ---------- stage: needs patch -> commit review _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue16728> _______________________________________

1 0

[issue16728] Missing cross-reference in sequence glossary entry
by Roundup Robot Feb. 15, 2014

Feb. 15, 2014

Roundup Robot added the comment: New changeset 30d0816939a3 by Andrew Kuchling in branch '3.3': #16728: Mention collections.abc.Sequence in 'sequence' glossary entry http://hg.python.org/cpython/rev/30d0816939a3 ---------- nosy: +python-dev _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue16728> _______________________________________

1 0

[issue16728] Missing cross-reference in sequence glossary entry
by A.M. Kuchling Feb. 15, 2014

Feb. 15, 2014

A.M. Kuchling added the comment: Here's a possible patch that mentions collections.abc.Sequence. I left out MutableSequence, because I couldn't see how to mention it without making the definition longer and more complicated. (It could be objected that this is the *glossary*, and is supposed to provide brief descriptions of terms, not precisely detailed descriptions. In that case, the patch could simply be rejected.) ---------- nosy: +akuchling Added file: http://bugs.python.org/file34095/issue16728.txt _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue16728> _______________________________________

1 0

[issue20497] Unclear word in socket document.
by INADA Naoki Feb. 15, 2014

Feb. 15, 2014

New submission from INADA Naoki: http://docs.python.org/3.3/library/socket.html#socket.getaddrinfo > Changed in version 3.2: parameters can now be passed as single keyword arguments. What *single* means? I can use multiple keyword arguments: In [3]: socket.getaddrinfo('www.python.org', 80, proto=socket.SOL_TCP, family=socket.AF_INET) Out[3]: [(<AddressFamily.AF_INET: 2>, <SocketType.SOCK_STREAM: 1>, 6, '', ('82.94.164.162', 80))] ---------- assignee: docs@python components: Documentation messages: 210078 nosy: docs@python, naoki priority: normal severity: normal status: open title: Unclear word in socket document. versions: Python 3.2, Python 3.3, Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue20497> _______________________________________

5 4

[issue20237] Ambiguous sentence in document of xml package.
by INADA Naoki Feb. 15, 2014

Feb. 15, 2014

New submission from INADA Naoki: http://docs.python.org/3.3/library/xml.html#defused-packages "The courses of action are recommended for any server code that parses untrusted XML data." What this sentence means? What "The courses" is? ---------- assignee: docs@python components: Documentation messages: 208015 nosy: docs@python, naoki priority: normal severity: normal status: open title: Ambiguous sentence in document of xml package. versions: Python 3.2, Python 3.3, Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue20237> _______________________________________

6 7

[issue20610] Documentation with two slashes in URL links to v2.6.5c2
by Daniel Ellis Feb. 15, 2014

Feb. 15, 2014

New submission from Daniel Ellis: I was searching for the documentation for itertools via Google and was sent here: http://www.python.org/doc//current/library/itertools.html After glancing at the upper-left hand corner, I wondered why Google was sending people to the 2.6 documentation, and a release candidate at that. After checking out the URL, it became obvious that there's an issue somewhere in the Python docs that is causing this. Quite a bizarre and obscure bug, but probably should be fixed since a major search engine is passing front-page search traffic there. ---------- assignee: docs@python components: Documentation messages: 211094 nosy: Daniel.Ellis, docs@python priority: normal severity: normal status: open title: Documentation with two slashes in URL links to v2.6.5c2 versions: Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue20610> _______________________________________

5 4

[issue19363] Python 2.7's future_builtins.map is not compatible with Python 3's map
by A.M. Kuchling Feb. 15, 2014

Feb. 15, 2014

A.M. Kuchling added the comment: Gareth Rees: it doesn't look like you attached the patch mentioned in your 02/04 comment. ---------- nosy: +akuchling _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue19363> _______________________________________

1 0

[issue20393] Docs: mark deprecated items in the TOC
by Zearin Feb. 15, 2014

Feb. 15, 2014

New submission from Zearin: When exploring the docs for the standard library, it’s frustrating to have an idea and look for the answer only to find out that an entire module (or package) has been deprecated _after_ I click on it. Can we have links to deprecated items on the Standard Library’s TOC page flagged? I see you’re using multiple CSS classes on some links. I propose: - add a CSS class to flag links to deprecated items - use something like the following CSS ---- /* * Example 1: color */ .toctree-wrapper a.deprecated { color: #933; } /* * Example 2: "badge" */ .toctree-wrapper a.deprecated:after { display: inline-block; content: "deprecated"; margin: 0 1em; padding: 0 1ex !important; border-radius: 1ex !important; font-size: x-small; background-color: #f66; color: #933; } ---- Of course, since the CSS class '.deprecated' already exists, there's 2 options: 1. the examples above are rewritten to use a different classname, or 2. add the following CSS: ---- /* "Reset" .deprecated in a toctree context */ .toctree-wrapper a.deprecated { background: none; border: none; padding: 0; } /* << insert above example CSS here >> */ ---- ---------- assignee: docs@python components: Documentation messages: 209239 nosy: docs@python, zearin priority: normal severity: normal status: open title: Docs: mark deprecated items in the TOC type: enhancement versions: Python 2.7, Python 3.1, Python 3.2, Python 3.3, Python 3.4, Python 3.5 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue20393> _______________________________________

3 2

[issue19890] Typo in multiprocessing docs
by Antony Lee Feb. 15, 2014

Feb. 15, 2014

New submission from Antony Lee: The docs for multiprocessing refer to BaseProxy._callMethod() while it should be _callmethod. ---------- assignee: docs@python components: Documentation messages: 205261 nosy: Antony.Lee, docs@python priority: normal severity: normal status: open title: Typo in multiprocessing docs versions: Python 2.7, Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue19890> _______________________________________

4 4