Mailman 3 July 2010 - docs

[issue9223] distutils Command docs linking
by anatoly techtonik July 11, 2010

July 11, 2010

anatoly techtonik <techtonik(a)gmail.com> added the comment: Eric, think about people who will be porting old code from distutils. They need to understand the behavior of distutils even if you'd like to force them to rewrite the logic for distutils2 from scratch. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9223> _______________________________________

1 0

[issue7340] Doc for sys.exc_info has warning that is no longer valid
by Éric Araujo July 11, 2010

July 11, 2010

Changes by Éric Araujo <merwok(a)netwok.org>: ---------- resolution: -> accepted stage: -> needs patch versions: -Python 3.0 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue7340> _______________________________________

1 0

[issue7674] select.select() corner cases: duplicate fds, out-of-range fds
by Mark Lawrence July 11, 2010

July 11, 2010

Mark Lawrence <breamoreboy(a)yahoo.co.uk> added the comment: Chris, to me it's as clear as mud but please produce a doc patch anyway. :) ---------- assignee: georg.brandl -> docs@python nosy: +BreamoreBoy, docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue7674> _______________________________________

1 0

[issue7340] Doc for sys.exc_info has warning that is no longer valid
by Mark Lawrence July 11, 2010

July 11, 2010

Changes by Mark Lawrence <breamoreboy(a)yahoo.co.uk>: ---------- assignee: georg.brandl -> docs@python nosy: +docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue7340> _______________________________________

1 0

[issue9184] open() doc: default value for buffering is -1, not None
by STINNER Victor July 11, 2010

July 11, 2010

New submission from STINNER Victor <victor.stinner(a)haypocalc.com>: Examples: * open(filename) works * open(filename, buffering=-1) works * open(filename, buffering=None) fails In the code: * _pyio.open(): default value is -1, type is int, no default value in the docstring * _io.open(): default value is not specified (C function), type is int, default value in the docstring is None In the doc: * open() default value is None The default value should be -1 everywhere. None is rejected by io.open (_io) and _pyio.open. Attached patch fixes _io.open() docstring Python documentation. ---------- assignee: docs@python components: Documentation, IO, Interpreter Core files: open_doc_buffering.patch keywords: patch messages: 109434 nosy: docs@python, haypo, pitrou priority: normal severity: normal status: open title: open() doc: default value for buffering is -1, not None versions: Python 3.1, Python 3.2, Python 3.3 Added file: http://bugs.python.org/file17886/open_doc_buffering.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9184> _______________________________________

4 5

[issue9223] distutils Command docs linking
by Georg Brandl July 11, 2010

July 11, 2010

Georg Brandl <georg(a)python.org> added the comment: Thanks, should be fixed in r82806. ---------- nosy: +georg.brandl resolution: -> fixed status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9223> _______________________________________

1 0

[issue9223] distutils Command docs linking
by Éric Araujo July 11, 2010

July 11, 2010

Éric Araujo <merwok(a)netwok.org> added the comment: Note for someone wanting to propose a patch: distutils is in the process of being improved and cleaned up as distutils2. Improving the documentation is part of the process. Adding cross-links in the existing docs is okay, but I’d recommend against using too much time for distutils. For example, merging sections or doing other significant work would be IMO (which is only one opinion) time better spent on something else. ---------- assignee: tarek -> docs@python components: -Distutils nosy: +alexis, merwok stage: -> needs patch versions: +Python 3.1 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9223> _______________________________________

1 0

[issue9223] distutils Command docs linking
by anatoly techtonik July 11, 2010

July 11, 2010

Changes by anatoly techtonik <techtonik(a)gmail.com>: ---------- nosy: +docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9223> _______________________________________

1 0

[issue7935] Cross-reference ast.literal_eval() from eval() docs
by Georg Brandl July 11, 2010

July 11, 2010

Georg Brandl <georg(a)python.org> added the comment: Added reference in r82805. Thanks! ---------- resolution: -> fixed status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue7935> _______________________________________

1 0

[issue6867] return value of epoll.register
by Mark Lawrence July 11, 2010

July 11, 2010

Changes by Mark Lawrence <breamoreboy(a)yahoo.co.uk>: ---------- assignee: georg.brandl -> docs@python nosy: +docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue6867> _______________________________________

1 0