Mailman 3 May 2011 - docs

shutil .move() on 2.6
by Alejandro Fritz 10 May '11

10 May '11

Hi, I am changing from py 2.5 and 2.6 on windows and noticed that the shutil.move() function changed from overwriting (in 2.4 and 2.5) to non-overwriting the destination file if it exists: if os.path.isdir(dst): real_dst = os.path.join(dst, _basename(src)) if os.path.exists(real_dst): raise Error, "Destination path '%s' already exists" % real_dst This behavior is not documented. best, af -- Alejandro Fritz Infoware project coordinator QUIPU GmbH Frankfurt Am Eisernen Schlag 31 / Große Seestraße 43 60431 Frankfurt/M. / 60486 Frankfurt/M. Skype: quipu_alex E-Mail: fritz(a)quipugmbh.com Web: www.quipu-processing.com ; www.quipugmbh.com CONFIDENTIALITY NOTICE This e-mail message and any attachments are only for the use of the intended recipient and may contain information that is privileged, confidential or exempt from disclosure under applicable law. If you are not the intended recipient, any disclosure, distribution or other use of this e-mail message or attachments is prohibited. If you have received this e-mail message in error, please delete and notify the sender immediately. Thank you.

2 1

Looks like there should be walk() instead of listdir()
by Victor Varvariuc 09 May '11

09 May '11

http://docs.python.org/library/os.html#os.walk ... > By default errors from the listdir()<http://docs.python.org/library/os.html#os.listdir> call > are ignored. If optional argument *onerror* is specified, it should be a > function; it will be called with one argument, an OSError<http://docs.python.org/library/exceptions.html#exceptions.OSError> > instance. > ... <http://docs.python.org/library/os.html#os.walk> Looks like there should be walk() instead of listdir() -- Victor Varvariuc

2 1

[issue12025] strangely missing separator in "resource" table
by Jesús Cea Avión 09 May '11

09 May '11

New submission from Jesús Cea Avión <jcea(a)jcea.es>: "resource" page in python docs is missing a separator between 6 and 7. Checking the RST source code, everything seems correct. But the fact is that a line is missing in the HTML output. Checking the HTML output code, it seems OK. Disabling CSS, I see the table is correct. Maybe an issue with the CSS?. A bug in Firefox 4.0.1? (my current browser). Viewing in iPhone, the display is OK :-?. Python 2.7: http://docs.python.org/library/resource.html#resource-usage Python 3.1: http://docs.python.org/release/3.1.3/library/resource.html#resource-usage Python 3.2: http://docs.python.org/py3k/library/resource.html#resource-usage Python 3.3: http://docs.python.org/dev/library/resource.html#resource-usage ---------- assignee: docs@python components: Documentation messages: 135397 nosy: docs@python, jcea priority: normal severity: normal status: open title: strangely missing separator in "resource" table versions: Python 2.7, Python 3.1, Python 3.2, Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue12025> _______________________________________

3 3

[issue12005] modulo result of Decimal differs from float/int
by Raymond Hettinger 05 May '11

05 May '11

Changes by Raymond Hettinger <raymond.hettinger(a)gmail.com>: ---------- assignee: docs@python -> rhettinger nosy: +rhettinger _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue12005> _______________________________________

1 0

[issue11690] Devguide: Add "communication" FAQ
by Nick Coghlan 05 May '11

05 May '11

Changes by Nick Coghlan <ncoghlan(a)gmail.com>: ---------- assignee: docs@python -> ncoghlan _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue11690> _______________________________________

1 0

[issue12005] modulo result of Decimal differs from float/int
by Mark Dickinson 05 May '11

05 May '11

Mark Dickinson <dickinsm(a)gmail.com> added the comment: The doc change should also note that // and divmod suffer from a similar mismatch: >>> Decimal(-2) // Decimal(3) Decimal('-0') >>> -2 // 3 -1 >>> -2.0 // 3 -1.0 However, the invariant that x = x // y * y + x % y is retained, as it should be. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue12005> _______________________________________

1 0

[issue12005] modulo result of Decimal differs from float/int
by Mark Dickinson 05 May '11

05 May '11

Mark Dickinson <dickinsm(a)gmail.com> added the comment: I believe that this was a deliberate design decision, though now that I look it seems it's not well documented. That should probably be fixed, so I see this as a documentation issue. More details: The specification on which the decimal module is based requires that there be a 'remainder' operation with the semantics of Decimal's '%' operation (i.e., the result of x % y has the sign of x). However, the specification doesn't say anything about how the prescribed operations should map to language constructs. So the choice was between (1) leaving '%' for Decimal objects unimplemented, and providing a separate 'remainder' method, or (2) mapping '%' to Decimal's remainder operation, and accepting the slight mismatch between the '%' semantics for float and Decimal. Perhaps the wrong choice was made. But it's there now, and to me it's not so obviously wrong that it's worth the upheaval of deprecating '%' for Decimal objects. Of course there's a third choice, which is to implement the float % semantics for the Decimal type; however, this is outside the scope of the specification---none of the specified operations matches this behaviour, and I'd oppose the addition of such an operation to the Decimal module. There's a strong sense in which Decimal's % is a more natural operation for floating-point types than float's %. (For one thing, it's exact in many circumstances, while float's % suffers from surprising results with negative operands.) Reclassifying as a documentation issue. ---------- assignee: -> docs@python components: +Documentation -Library (Lib) nosy: +docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue12005> _______________________________________

1 0

[issue11997] One typo in Doc/c-api/init.rst
by Steffen Daode Nurpmeso 05 May '11

05 May '11

New submission from Steffen Daode Nurpmeso <sdaoden(a)googlemail.com>: Yes, i really found a typo. I'll send two patches, one with the typo fixed, and one with the typo fixed and one for which i've :setlocal tw=80:{gq} ---------- assignee: docs@python components: Documentation messages: 135107 nosy: docs@python, sdaoden priority: normal severity: normal status: open title: One typo in Doc/c-api/init.rst versions: Python 2.7, Python 3.1, Python 3.2, Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue11997> _______________________________________

3 3

[issue8158] Docstring of optparse.OptionParser incomplete
by R. David Murray 05 May '11

05 May '11

R. David Murray <rdmurray(a)bitdance.com> added the comment: Thanks everyone. ---------- resolution: -> fixed stage: needs patch -> committed/rejected status: open -> closed versions: +Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8158> _______________________________________

1 0

[issue8158] Docstring of optparse.OptionParser incomplete
by Roundup Robot 05 May '11

05 May '11

Roundup Robot <devnull@devnull> added the comment: New changeset c13d2552eb51 by R David Murray in branch '2.7': #8158: add missing 'description' description to optparse docstring. http://hg.python.org/cpython/rev/c13d2552eb51 New changeset f559b88bcaa0 by R David Murray in branch '3.1': #8158: add missing 'description' description to optparse docstring. http://hg.python.org/cpython/rev/f559b88bcaa0 New changeset b4b0a1458638 by R David Murray in branch '3.2': Merge #8158: add missing 'description' description to optparse docstring. http://hg.python.org/cpython/rev/b4b0a1458638 New changeset 2a403afc4a76 by R David Murray in branch 'default': Merge #8158: add missing 'description' description to optparse docstring. http://hg.python.org/cpython/rev/2a403afc4a76 ---------- nosy: +python-dev _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8158> _______________________________________

1 0