Mailman 3 November 2011 - docs

[issue5088] optparse: inconsistent default value for append actions
by Eli Bendersky Nov. 11, 2011

Nov. 11, 2011

Changes by Eli Bendersky <eliben(a)gmail.com>: ---------- nosy: -eli.bendersky _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue5088> _______________________________________

1 0

[issue3849] FUD in documentation for urllib.urlopen()
by Eli Bendersky Nov. 11, 2011

Nov. 11, 2011

Changes by Eli Bendersky <eliben(a)gmail.com>: ---------- nosy: -eli.bendersky _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue3849> _______________________________________

1 0

[issue13161] problems with help() documentation of __i*__ operators
by Eli Bendersky Nov. 11, 2011

Nov. 11, 2011

New submission from Eli Bendersky <eliben(a)gmail.com>: Report from Joao Carneiro in the docs@ maillist: ---------------------------- I would like to report that I found a mistake in the document of "help(set)". In the document all the __i*__ methods are described exactly like the same methods without i before the name. Copied from the document: __ixor__(...) x.__ixor__(y) <==> x^y __xor__(...) x.__xor__(y) <==> x^y I suppose that the __ixor__ would mean x^=… [View More]

3 4

[issue13191] Typo in argparse documentation
by Mike Hoy Nov. 11, 2011

Nov. 11, 2011

New submission from Mike Hoy <mhoy09(a)gmail.com>: In the Docs mailing list a typo was pointed out in argparse docs. http://docs.python.org/dev/library/argparse.html#metavar > "So, a single positional argument with dest='bar' will that argument > will be referred to as bar." > "So, a single positional argument with dest='bar' WITH that argument > will be referred to as bar." Eli Bendersky: > I agree the original sentence makes little sense. But I'm not sure > … [View More]

4 5

[issue13237] subprocess docs should use emphasise convenience functions
by Nick Coghlan Nov. 11, 2011

Nov. 11, 2011

New submission from Nick Coghlan <ncoghlan(a)gmail.com>: Many typical subprocess use cases can now be handled simply via the convenience functions: subprocess.call() subprocess.check_call() subprocess.check_output() However, readers of the documentation could be forgiven for not realising that, since the docs dive right in with Popen() and will scare most readers away in search of more user friendly APIs (or even other languages). The module documentation should be reordered to … [View More]

6 24

[issue13365] str.expandtabs documentation is wrong
by John Feuerstein Nov. 11, 2011

Nov. 11, 2011

New submission from John Feuerstein <john(a)feurix.com>: The documentation for str.expandtabs([tabsize]) is wrong: "Return a copy of the string where all tab characters are replaced by one or more spaces, depending on the current column and the given tab size. [...]" This should read "zero or more spaces": >>> 'a\tb'.expandtabs(0) 'ab' >>> 'a\tb'.expandtabs(-1) 'ab' The description in Objects/unicodeobject.c does not include this error. ---------- assignee: docs@… [View More]

3 4

[issue5904] strftime docs do not explain locale effect on result string
by Ezio Melotti Nov. 8, 2011

Nov. 8, 2011

Changes by Ezio Melotti <ezio.melotti(a)gmail.com>: ---------- nosy: +ezio.melotti stage: -> needs patch versions: +Python 2.7 -Python 2.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue5904> _______________________________________

1 0

[issue13367] PyCapsule_New's argument *must* not a NULL.
by INADA Naoki Nov. 7, 2011

Nov. 7, 2011

New submission from INADA Naoki <songofacandy(a)gmail.com>: http://docs.python.org/c-api/capsule.html?highlight=capsule#PyCapsule_New > The pointer argument may not be NULL. I think "must not" is correct. ---------- assignee: docs@python components: Documentation messages: 147269 nosy: docs@python, naoki priority: normal severity: normal status: open title: PyCapsule_New's argument *must* not a NULL. versions: Python 2.7 _______________________________________ Python tracker <… [View More]

4 3

Bug in documentation of module subprocess, method send_signal
by Dieterle, Daniel Nov. 7, 2011

Nov. 7, 2011

Hi, in the documentation (http://docs.python.org/library/subprocess.html#subprocess.Popen.send_si gnal) is a bug. CTRL_C_EVENT can not be sent to processes started with a creationflags parameter which includes CREATE_NEW_PROCESS_GROUP. Why can be read in the msdn documentation http://msdn.microsoft.com/en-us/library/windows/desktop/ms683155%28v=vs. 85%29.aspx . A workaround using CTRL_C_EVENT nevertheless is described here: http://stackoverflow.com/questions/7085604/sending-c-to-python-… [View More]

2 3

[issue13353] documentation problem in logging.handlers.TimedRotatingFileHandler for 2.7
by Eli Bendersky Nov. 6, 2011

Nov. 6, 2011

New submission from Eli Bendersky <eliben(a)gmail.com>: User (Yoann Roman) report on docs@ maillist: ---- The docs for logging.handlers.TimedRotatingFileHandler in Python 2.7 say that the "utc" keyword argument was added in 2.7: http://docs.python.org/library/logging.handlers.html#timedrotatingfilehandl… This isn't correct, however, since it was available as of 2.6 (I verified the source as well): http://docs.python.org/release/2.6/library/logging.html#timedrotatingfileha… It did … [View More]

4 3