Mailman 3 July 2010 - docs

[issue9223] distutils Command docs linking
by anatoly techtonik 11 Jul '10

11 Jul '10

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 11 Jul '10

11 Jul '10

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 11 Jul '10

11 Jul '10

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 11 Jul '10

11 Jul '10

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 11 Jul '10

11 Jul '10

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 11 Jul '10

11 Jul '10

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 11 Jul '10

11 Jul '10

É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 11 Jul '10

11 Jul '10

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 11 Jul '10

11 Jul '10

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 11 Jul '10

11 Jul '10

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