Mailman 3 June 2016 - docs

[issue13784] Documentation of xml.sax.xmlreader: Locator.getLineNumber() and Locator.getColumnNumber()
by patrick vrijlandt 02 Jun '16

02 Jun '16

New submission from patrick vrijlandt <patrick.vrijlandt(a)gmail.com>: Problem: Locator methods return the location where the event starts, not where it ends. Locator line numbers start at 1, Locator column numbers can be 0. Proposal: Adapt documentation. >From the docs: Instances of Locator provide these methods: Locator.getColumnNumber() Return the column number where the current event ends. Locator.getLineNumber() Return the line number where the current event ends My Test: import xml.sax data = b"""<main> <sub attr="1" id="name" > <subsub /> </sub> </main>""" class MyHandler(xml.sax.handler.ContentHandler): def startElement(self, name, attrs): if name == "sub": print("open", name, self._locator.getLineNumber(), self._locator.getColumnNumber()) def endElement(self, name): if name == "sub": print("close", name, self._locator.getLineNumber(), self._locator.getColumnNumber()) xml.sax.parseString(data, MyHandler()) Output: open sub 2 4 close sub 7 4 ---------- assignee: docs@python components: Documentation, XML messages: 151247 nosy: docs@python, patrick.vrijlandt priority: normal severity: normal status: open title: Documentation of xml.sax.xmlreader: Locator.getLineNumber() and Locator.getColumnNumber() type: behavior versions: Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue13784> _______________________________________

5 4

[issue27183] Clarify that Py_VISIT(NULL) does nothing
by Petr Viktorin 02 Jun '16

02 Jun '16

New submission from Petr Viktorin: The Py_VISIT macro (in Include/objimpl.h) does nothing if passed NULL (and did this since its introduction). It would be nice to have this formally documented. ---------- assignee: docs@python components: Documentation files: 0001-Doc-c-api-Clarify-that-Py_VISIT-NULL-does-nothing.patch keywords: patch messages: 266894 nosy: docs@python, encukou, eric.araujo, ezio.melotti, georg.brandl priority: normal severity: normal status: open title: Clarify that Py_VISIT(NULL) does nothing type: enhancement versions: Python 3.6 Added file: http://bugs.python.org/file43102/0001-Doc-c-api-Clarify-that-Py_VISIT-NULL-… _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue27183> _______________________________________

2 1

[issue23116] Python Tutorial 4.7.1: Improve ask_ok() to cover more input values
by Berker Peksag 02 Jun '16

02 Jun '16

Berker Peksag added the comment: Thanks for the review. I removed the "-=" part from the patch. ---------- resolution: -> fixed stage: patch review -> resolved status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue23116> _______________________________________

1 0

[issue23116] Python Tutorial 4.7.1: Improve ask_ok() to cover more input values
by Roundup Robot 02 Jun '16

02 Jun '16

Roundup Robot added the comment: New changeset ef800c30e28c by Berker Peksag in branch '3.5': Issue #23116: Improve ask_ok() example in the Python tutorial https://hg.python.org/cpython/rev/ef800c30e28c New changeset 174eae50b664 by Berker Peksag in branch 'default': Issue #23116: Merge from 3.5 https://hg.python.org/cpython/rev/174eae50b664 ---------- nosy: +python-dev _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue23116> _______________________________________

1 0

[issue23116] Python Tutorial 4.7.1: Improve ask_ok() to cover more input values
by Benjamin Peterson 02 Jun '16

02 Jun '16

Benjamin Peterson added the comment: I think the patch is okay except for the use of "-=" instead of the more verbose version. ---------- nosy: +benjamin.peterson _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue23116> _______________________________________

1 0

[issue9755] Fix refcounting details in Py3k C API documentation
by Fred L. Drake, Jr. 02 Jun '16

02 Jun '16

Fred L. Drake, Jr. added the comment: As mentioned in issue 18085, the original file was not generated, but crafted by hand (though I don't think that really matters). ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9755> _______________________________________

1 0

[issue18384] Add devhelp build instructions to the documentation makefile
by Balthazar Rouberol 02 Jun '16

02 Jun '16

New submission from Balthazar Rouberol: The documentation makefile is missing support for Devhelp. The supplied patch fixes this for the Python 3 branch. It also edits the ouput of the sphinx build to change the name of the devhelp project. This is needed to be able to have both versions of documentation (py2 & py3) displayed in Devhelp. This is useful if developers need to access documentation for both versions, such as both maintaining a Python2 project and starting a new project in Python3. This has been patched in some distributions downstream, but would be nice to have patched upstream. See: https://bugs.launchpad.net/ubuntu/+source/devhelp/+bug/787039 ---------- assignee: docs@python components: Documentation files: devhelp-build-py3.patch keywords: patch messages: 192457 nosy: brouberol, docs@python priority: normal severity: normal status: open title: Add devhelp build instructions to the documentation makefile type: enhancement versions: Python 3.5 Added file: http://bugs.python.org/file30823/devhelp-build-py3.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue18384> _______________________________________

4 7

[issue20693] Sidebar scrolls down 2x as fast as page content
by Nick Timkovich 02 Jun '16

02 Jun '16

New submission from Nick Timkovich: When scrolling down in the Python 3.4 docs (e.g. http://docs.python.org/3.4/library/index.html ) the Sphinx sidebar's top value increases twice as fast as the user moves down the page, resulting in it "running away". I don't know sufficient JS to identify the problem, but I'm guessing it's somewhere in the sidebar.js:scroll_sidebar() function or whatever might configure it. (apologies, I *think* I may have sent a similar mail to the docs list already) ---------- assignee: docs@python components: Documentation files: py34sidebar.png messages: 211675 nosy: docs@python, nicktimko priority: normal severity: normal status: open title: Sidebar scrolls down 2x as fast as page content type: behavior versions: Python 3.4 Added file: http://bugs.python.org/file34149/py34sidebar.png _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue20693> _______________________________________

8 11

[issue8519] doc: termios and ioctl reference links
by Berker Peksag 02 Jun '16

02 Jun '16

Berker Peksag added the comment: +1 for using the manpage directives. ---------- keywords: +easy nosy: +berker.peksag stage: -> needs patch type: -> enhancement versions: +Python 3.5, Python 3.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8519> _______________________________________

1 0

[issue12243] getpass.getuser works on OSX
by Bryce Verdier 02 Jun '16

02 Jun '16

New submission from Bryce Verdier <bryceverdier(a)gmail.com>: In the docs for getpass: http://docs.python.org/release/2.6.6/library/getpass.html (as an example). It hints that getuser() doesn't work on OSX. I tried this out and it works fine for python 2.6 on 10.6. I have included a patch for this. I believe the cleanest way to handle this is to remove the "Availability" entry as it's no longer necessary. ---------- assignee: docs@python components: Documentation files: getuser.patch keywords: patch messages: 137483 nosy: docs@python, louiscipher priority: normal severity: normal status: open title: getpass.getuser works on OSX versions: Python 2.6, Python 2.7, Python 3.1, Python 3.2, Python 3.3, Python 3.4 Added file: http://bugs.python.org/file22222/getuser.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue12243> _______________________________________

7 12