From report at bugs.python.org  Wed Mar  1 02:28:17 2017
From: report at bugs.python.org (Wolfgang Maier)
Date: Wed, 01 Mar 2017 07:28:17 +0000
Subject: [docs] [issue29414] Change 'the for statement is such an iterator'
 in Tutorial
In-Reply-To: <1485976216.65.0.169866413965.issue29414@psf.upfronthosting.co.za>
Message-ID: <1488353296.91.0.0575846107134.issue29414@psf.upfronthosting.co.za>


Wolfgang Maier added the comment:

> [...] I prefere the chapter as it currently is, because IMHO it
> introduces the concepts more gradually than your proposal.

That's ok! It's your PR and I only wanted to show an alternative.
I was hoping for a bit more people to provide feedback though.

The main reason I'm interested in changes to the tutorial is because
I'm teaching Python to undergraduates (not in CS, but in Biology) and
I recommend them to work through the Tutorial alongside the course so
I have a natural interest in its quality and really appreciate any
improvement, which I think your PR is certainly offering :)

Let me still comment on some of your points regarding my suggestion:

> In addition the modification of the title section from "for
> Statements" to "for Loops" IMHO makes the title not consistent with
> the other section titles.

I don't see this point. The other section titles are not about loops.
The preceding chapter introduces while loops as a loop, not a
statement, and this chapter talks about while and for loops further
down the page. 

>> - restructured the for loop section to discuss Python for loops
>> first and only compare them to Pascal/C afterwards
> +0. I think for a reader who is coming from another language is better
> to have the current introduction. But maybe it is not the same for a
> reader who is learning Python as a first programming language.

I don't agree with you on this. I'm coming from a C background myself,
but if I want to learn a new language the first thing I'm interested in
is not how it's *not* working, but how it does.
Plus, it's 2017, Perl has foreach, Javascript has at least
array.foreach and even C++11 has auto-iteration over collections so starting an explanation of for loops with 'hey, look Python is different 
from two > 40 years old languages' feels a bit outdated.

Regarding my main point of removing most of the ranges section it is
possible I went a bit too far with that and maybe one should still
briefly mention the optional start argument and stress that stop is not
included in the range, but my seealso is quite prominent and the linked
section on range is pretty good.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29414>
_______________________________________

From report at bugs.python.org  Wed Mar  1 03:55:06 2017
From: report at bugs.python.org (Marco Buttu)
Date: Wed, 01 Mar 2017 08:55:06 +0000
Subject: [docs] [issue29414] Change 'the for statement is such an iterator'
 in Tutorial
In-Reply-To: <1485976216.65.0.169866413965.issue29414@psf.upfronthosting.co.za>
Message-ID: <1488358506.7.0.0635749815676.issue29414@psf.upfronthosting.co.za>


Marco Buttu added the comment:

> I don't see this point. The other section titles are not about
> loops. The preceding chapter introduces while loops as a loop,
> not a statement, and this chapter talks about while and for
> loops further down the page.

What I mean is that currently in every section (of this chapter) about a statemet, the statement is qualified as "statement": "if Statements", "for Statements", "pass Statements", and "break and continue Statements, and else Clauses on Loops". The last one is not an exeption, bacause we have already introduced for and while, and writing "break and continue Statements, and else Clauses on for and while statements" IMO is redundant. 

I like the current structure of titles, because IMO helps beginners to better classify things (statements, functions, ...), and it is not clear to me the objective motivation for changing "for Statemets" to "for Loops", breaking the structure given by the original author.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29414>
_______________________________________

From report at bugs.python.org  Wed Mar  1 04:38:28 2017
From: report at bugs.python.org (=?utf-8?b?VmVkcmFuIMSMYcSNacSH?=)
Date: Wed, 01 Mar 2017 09:38:28 +0000
Subject: [docs] [issue29677] 'round()' accepts a negative integer for ndigits
In-Reply-To: <1488285024.25.0.0499728148151.issue29677@psf.upfronthosting.co.za>
Message-ID: <1488361107.95.0.105684763954.issue29677@psf.upfronthosting.co.za>


Vedran ?a?i? added the comment:

This is one of those things that show Python being extremely consistent within itself. Of course, docs should be clarified if needed, but the feature is desirable and useful.

----------
nosy: +veky

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29677>
_______________________________________

From report at bugs.python.org  Wed Mar  1 12:37:28 2017
From: report at bugs.python.org (Jim Fasarakis-Hilliard)
Date: Wed, 01 Mar 2017 17:37:28 +0000
Subject: [docs] [issue29688] Document Path.absolute
Message-ID: <1488389848.79.0.700814097868.issue29688@psf.upfronthosting.co.za>


New submission from Jim Fasarakis-Hilliard:

Method absolute of Path objects lacked documentation, proposed PR adds relevant method to docs.

----------
assignee: docs at python
components: Documentation
messages: 288767
nosy: Jim Fasarakis-Hilliard, docs at python
priority: normal
severity: normal
status: open
title: Document Path.absolute
versions: Python 3.5, Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29688>
_______________________________________

From report at bugs.python.org  Wed Mar  1 12:38:12 2017
From: report at bugs.python.org (Jim Fasarakis-Hilliard)
Date: Wed, 01 Mar 2017 17:38:12 +0000
Subject: [docs] [issue29688] Document Path.absolute
In-Reply-To: <1488389848.79.0.700814097868.issue29688@psf.upfronthosting.co.za>
Message-ID: <1488389892.71.0.264801669551.issue29688@psf.upfronthosting.co.za>


Changes by Jim Fasarakis-Hilliard <d.f.hilliard at gmail.com>:


----------
pull_requests: +321

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29688>
_______________________________________

From report at bugs.python.org  Thu Mar  2 05:17:19 2017
From: report at bugs.python.org (STINNER Victor)
Date: Thu, 02 Mar 2017 10:17:19 +0000
Subject: [docs] [issue29666] Issue in enum documentation
In-Reply-To: <1488203311.1.0.764284916797.issue29666@psf.upfronthosting.co.za>
Message-ID: <1488449839.02.0.587410654086.issue29666@psf.upfronthosting.co.za>


Changes by STINNER Victor <victor.stinner at gmail.com>:


----------
versions: +Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29666>
_______________________________________

From report at bugs.python.org  Thu Mar  2 06:47:37 2017
From: report at bugs.python.org (STINNER Victor)
Date: Thu, 02 Mar 2017 11:47:37 +0000
Subject: [docs] [issue29666] Issue in enum documentation
In-Reply-To: <1488203311.1.0.764284916797.issue29666@psf.upfronthosting.co.za>
Message-ID: <1488455257.69.0.661060826715.issue29666@psf.upfronthosting.co.za>


Changes by STINNER Victor <victor.stinner at gmail.com>:


----------
pull_requests: +325

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29666>
_______________________________________

From report at bugs.python.org  Thu Mar  2 06:48:04 2017
From: report at bugs.python.org (STINNER Victor)
Date: Thu, 02 Mar 2017 11:48:04 +0000
Subject: [docs] [issue29666] Issue in enum documentation
In-Reply-To: <1488203311.1.0.764284916797.issue29666@psf.upfronthosting.co.za>
Message-ID: <1488455284.42.0.0242959347676.issue29666@psf.upfronthosting.co.za>


STINNER Victor added the comment:

Doc has been fixed in Python 3.6 and 3.7. Thanks!

----------
resolution:  -> fixed
stage:  -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29666>
_______________________________________

From mwysokin at akamai.com  Wed Mar  1 09:26:40 2017
From: mwysokin at akamai.com (Wysokinski, Michal)
Date: Wed, 1 Mar 2017 14:26:40 +0000
Subject: [docs] link to openssl ciphers from ssl module docs is dead
Message-ID: <7AC1F416-9574-4419-B3AA-DC9B130E7814@akamai.com>

In docs for set_ciphers method of the SSLContext class (https://docs.python.org/3.6/library/ssl.html#ssl.SSLContext.set_ciphers) there is an external link labeled OpenSSL cipher list format pointing to https://www.openssl.org/docs/manmaster/apps/ciphers.html#CIPHER-LIST-FORMAT That link is dead. I believe currently the link needs to include specific open ssl version in it and the following one works fine: https://www.openssl.org/docs/man1.0.2/apps/ciphers.html#CIPHER-LIST-FORMAT The problem is present in Python 3.6 and 3.5 docs. I haven?t checked docs for other versions.

Cheers
Michal
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170301/b8ec6525/attachment.html>

From sweavo at gmail.com  Thu Mar  2 03:06:56 2017
From: sweavo at gmail.com (Steve Carter)
Date: Thu, 02 Mar 2017 08:06:56 +0000
Subject: [docs] Margaret docs maintenance
Message-ID: <CABTxiB32z4b9CBMpZbW7GmPiuFJ3RgKMK3sYxSxvzA_gO2ddaQ@mail.gmail.com>

Hi all,



How would I go about submitting a rewrite to the argparse page?



I use argparse a lot (python 2.7) and find myself at the reference page
often, but it opens with an example that is far from a typical argument
parsing application.



It should open with reference material and illustrate the reference
material with realistic examples.



Would such a contribution be welcome? How should I start?



Thanks



Best regards,

Steve Carter
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170302/18700682/attachment-0001.html>

From report at bugs.python.org  Thu Mar  2 13:56:01 2017
From: report at bugs.python.org (Brett Cannon)
Date: Thu, 02 Mar 2017 18:56:01 +0000
Subject: [docs] [issue29688] Document Path.absolute
In-Reply-To: <1488389848.79.0.700814097868.issue29688@psf.upfronthosting.co.za>
Message-ID: <1488480961.4.0.399801006893.issue29688@psf.upfronthosting.co.za>


Changes by Brett Cannon <brett at python.org>:


----------
assignee: docs at python -> brett.cannon
nosy: +brett.cannon

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29688>
_______________________________________

From report at bugs.python.org  Thu Mar  2 13:57:59 2017
From: report at bugs.python.org (Brett Cannon)
Date: Thu, 02 Mar 2017 18:57:59 +0000
Subject: [docs] [issue29677] clarify docs about 'round()' accepting a
 negative integer for ndigits
In-Reply-To: <1488285024.25.0.0499728148151.issue29677@psf.upfronthosting.co.za>
Message-ID: <1488481079.74.0.542178116067.issue29677@psf.upfronthosting.co.za>


Changes by Brett Cannon <brett at python.org>:


----------
title: 'round()' accepts a negative integer for ndigits -> clarify docs about 'round()' accepting a negative integer for ndigits

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29677>
_______________________________________

From report at bugs.python.org  Fri Mar  3 00:42:00 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 03 Mar 2017 05:42:00 +0000
Subject: [docs] [issue29026] time.time() documentation should mention UTC
 timezone
In-Reply-To: <1482243889.09.0.538886851254.issue29026@psf.upfronthosting.co.za>
Message-ID: <1488519720.74.0.315022994651.issue29026@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +348

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29026>
_______________________________________

From report at bugs.python.org  Fri Mar  3 00:42:50 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 03 Mar 2017 05:42:50 +0000
Subject: [docs] [issue29026] time.time() documentation should mention UTC
 timezone
In-Reply-To: <1482243889.09.0.538886851254.issue29026@psf.upfronthosting.co.za>
Message-ID: <1488519770.82.0.384072842431.issue29026@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +349

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29026>
_______________________________________

From report at bugs.python.org  Fri Mar  3 07:11:40 2017
From: report at bugs.python.org (Stefan Pochmann)
Date: Fri, 03 Mar 2017 12:11:40 +0000
Subject: [docs] [issue29709] Short-circuiting not only on False and True
Message-ID: <1488543100.15.0.348225972332.issue29709@psf.upfronthosting.co.za>


New submission from Stefan Pochmann:

The notes at https://docs.python.org/3/library/stdtypes.html#boolean-operations-and-or-not say that `or` "only evaluates the second argument if the first one is False" and that `and` "only evaluates the second argument if the first one is True". Should say "false" and "true" instead of "False" and "True".

----------
assignee: docs at python
components: Documentation
messages: 288881
nosy: Stefan Pochmann, docs at python
priority: normal
severity: normal
status: open
title: Short-circuiting not only on False and True
type: enhancement
versions: Python 2.7, Python 3.3, Python 3.4, Python 3.5, Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29709>
_______________________________________

From report at bugs.python.org  Fri Mar  3 07:33:38 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 03 Mar 2017 12:33:38 +0000
Subject: [docs] [issue29709] Short-circuiting not only on False and True
In-Reply-To: <1488543100.15.0.348225972332.issue29709@psf.upfronthosting.co.za>
Message-ID: <1488544418.6.0.285688304324.issue29709@psf.upfronthosting.co.za>


Changes by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
keywords: +easy
stage:  -> needs patch
versions:  -Python 3.3, Python 3.4

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29709>
_______________________________________

From report at bugs.python.org  Fri Mar  3 09:02:05 2017
From: report at bugs.python.org (Marco Buttu)
Date: Fri, 03 Mar 2017 14:02:05 +0000
Subject: [docs] [issue16355] inspect.getcomments() does not work in the
 interactive shell
In-Reply-To: <1351511930.82.0.59071323276.issue16355@psf.upfronthosting.co.za>
Message-ID: <1488549725.02.0.787268356548.issue16355@psf.upfronthosting.co.za>


Changes by Marco Buttu <marco.buttu at gmail.com>:


----------
pull_requests: +356

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue16355>
_______________________________________

From report at bugs.python.org  Fri Mar  3 09:20:33 2017
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 03 Mar 2017 14:20:33 +0000
Subject: [docs] [issue16355] inspect.getcomments() does not work in the
 interactive shell
In-Reply-To: <1351511930.82.0.59071323276.issue16355@psf.upfronthosting.co.za>
Message-ID: <1488550833.13.0.0764131708153.issue16355@psf.upfronthosting.co.za>


Berker Peksag added the comment:

I think David's comment about tests was for the second patch. Looking at msg199395 and msg199397, my understanding is that tests are still needed.

----------
nosy: +berker.peksag
versions: +Python 3.5, Python 3.6, Python 3.7 -Python 3.3, Python 3.4

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue16355>
_______________________________________

From report at bugs.python.org  Fri Mar  3 09:38:39 2017
From: report at bugs.python.org (Nick Coghlan)
Date: Fri, 03 Mar 2017 14:38:39 +0000
Subject: [docs] [issue29710] Incorrect representation caveat on bitwise
 operation docs
Message-ID: <1488551919.31.0.20533072889.issue29710@psf.upfronthosting.co.za>


New submission from Nick Coghlan:

The docs on bitwise operations at https://docs.python.org/3/library/stdtypes.html#bitwise-operations-on-integer-types include the caveated sentence:

    Negative numbers are treated as their 2?s complement value (this assumes that there are enough bits so that no overflow occurs during the operation).

This sentence isn't correct now that integers are always arbitrary length. The bitwise inversion will never overflow, and is instead calculated as "-(n+1)" rather than literally flipping bits in the representation: https://docs.python.org/3/reference/expressions.html#unary-arithmetic-and-bitwise-operations

----------
assignee: docs at python
components: Documentation
messages: 288890
nosy: docs at python, ncoghlan
priority: normal
severity: normal
stage: needs patch
status: open
title: Incorrect representation caveat on bitwise operation docs
type: enhancement
versions: Python 3.5, Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29710>
_______________________________________

From report at bugs.python.org  Fri Mar  3 09:43:39 2017
From: report at bugs.python.org (R. David Murray)
Date: Fri, 03 Mar 2017 14:43:39 +0000
Subject: [docs] [issue16355] inspect.getcomments() does not work in the
 interactive shell
In-Reply-To: <1351511930.82.0.59071323276.issue16355@psf.upfronthosting.co.za>
Message-ID: <1488552219.07.0.744282825013.issue16355@psf.upfronthosting.co.za>


R. David Murray added the comment:

Correct.  Tests are good, it's the fix I was rejecting.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue16355>
_______________________________________

From report at bugs.python.org  Fri Mar  3 09:48:31 2017
From: report at bugs.python.org (Sanyam Khurana)
Date: Fri, 03 Mar 2017 14:48:31 +0000
Subject: [docs] [issue29710] Incorrect representation caveat on bitwise
 operation docs
In-Reply-To: <1488551919.31.0.20533072889.issue29710@psf.upfronthosting.co.za>
Message-ID: <1488552511.07.0.760157334069.issue29710@psf.upfronthosting.co.za>


Sanyam Khurana added the comment:

Hi, I'm working on this issue.

----------
nosy: +CuriousLearner

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29710>
_______________________________________

From report at bugs.python.org  Fri Mar  3 10:34:12 2017
From: report at bugs.python.org (Wolfgang Maier)
Date: Fri, 03 Mar 2017 15:34:12 +0000
Subject: [docs] [issue29710] Incorrect representation caveat on bitwise
 operation docs
In-Reply-To: <1488551919.31.0.20533072889.issue29710@psf.upfronthosting.co.za>
Message-ID: <1488555252.98.0.251735387259.issue29710@psf.upfronthosting.co.za>


Changes by Wolfgang Maier <wolfgang.maier at biologie.uni-freiburg.de>:


----------
nosy: +wolma

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29710>
_______________________________________

From report at bugs.python.org  Fri Mar  3 10:58:44 2017
From: report at bugs.python.org (Mark Dickinson)
Date: Fri, 03 Mar 2017 15:58:44 +0000
Subject: [docs] [issue29710] Incorrect representation caveat on bitwise
 operation docs
In-Reply-To: <1488551919.31.0.20533072889.issue29710@psf.upfronthosting.co.za>
Message-ID: <1488556724.94.0.529955057417.issue29710@psf.upfronthosting.co.za>


Mark Dickinson added the comment:

> This sentence isn't correct now that integers are always arbitrary length.

It's not really clear what that line in the docs means for Python 2, either: if values x and y both fit in an int, then so do ~x, x|y and x&y. We already assume in the Python source that the underlying representation is two's complement (no padding bits, no trap representation, etc.), so there aren't any complications from platforms where the C representation is ones' complement or sign-magnitude.

----------
nosy: +mark.dickinson

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29710>
_______________________________________

From report at bugs.python.org  Fri Mar  3 11:23:12 2017
From: report at bugs.python.org (Mark Dickinson)
Date: Fri, 03 Mar 2017 16:23:12 +0000
Subject: [docs] [issue29710] Incorrect representation caveat on bitwise
 operation docs
In-Reply-To: <1488551919.31.0.20533072889.issue29710@psf.upfronthosting.co.za>
Message-ID: <1488558192.04.0.733020311374.issue29710@psf.upfronthosting.co.za>


Mark Dickinson added the comment:

> It's not really clear what that line in the docs means for Python 2, either

Ah, I guess it still kinda sorta applies for the left-shift operator, though even then, Python has promoted the result to long for many versions now. So the only "overflow" that's really relevant on Python 2 is "overflow" from int to long in the case of left shift.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29710>
_______________________________________

From report at bugs.python.org  Fri Mar  3 12:26:39 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 03 Mar 2017 17:26:39 +0000
Subject: [docs] [issue29026] time.time() documentation should mention UTC
 timezone
In-Reply-To: <1482243889.09.0.538886851254.issue29026@psf.upfronthosting.co.za>
Message-ID: <1488561998.86.0.652284560209.issue29026@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Hi, does this need backport to 2.7?
I'm getting a lot of conflicts while trying to do that... Not sure how to proceed.

----------
nosy: +Mariatta

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29026>
_______________________________________

From report at bugs.python.org  Fri Mar  3 13:00:40 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Fri, 03 Mar 2017 18:00:40 +0000
Subject: [docs] [issue29709] Short-circuiting not only on False and True
In-Reply-To: <1488543100.15.0.348225972332.issue29709@psf.upfronthosting.co.za>
Message-ID: <1488564040.32.0.866732242156.issue29709@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

Mariatta, would you like to fix this one (False -> false and True -> true).

----------
assignee: docs at python -> Mariatta
nosy: +Mariatta, rhettinger

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29709>
_______________________________________

From report at bugs.python.org  Fri Mar  3 13:09:30 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 03 Mar 2017 18:09:30 +0000
Subject: [docs] [issue29709] Short-circuiting not only on False and True
In-Reply-To: <1488543100.15.0.348225972332.issue29709@psf.upfronthosting.co.za>
Message-ID: <1488564570.87.0.662282001018.issue29709@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +359

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29709>
_______________________________________

From report at bugs.python.org  Fri Mar  3 13:14:56 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 03 Mar 2017 18:14:56 +0000
Subject: [docs] [issue29709] Short-circuiting not only on False and True
In-Reply-To: <1488543100.15.0.348225972332.issue29709@psf.upfronthosting.co.za>
Message-ID: <1488564896.17.0.639167671331.issue29709@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Thanks, Raymond. I made the PR :)
I can backport to 2.7, 3.5, and 3.6 once it's accepted.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29709>
_______________________________________

From report at bugs.python.org  Fri Mar  3 15:37:32 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 03 Mar 2017 20:37:32 +0000
Subject: [docs] [issue29688] Document Path.absolute
In-Reply-To: <1488389848.79.0.700814097868.issue29688@psf.upfronthosting.co.za>
Message-ID: <1488573452.44.0.669016631657.issue29688@psf.upfronthosting.co.za>


Brett Cannon added the comment:

As brought up on the PR, it turns out Path.absolute() is extremely under-tested.

Perhaps we should deprecate Path.absolute() instead of document it and properly test it (and the testing will be necessary to move forward with the documentation)? Path.resolve() handles absolute paths already while also resolving '.' and '..': https://docs.python.org/3/library/pathlib.html#pathlib.Path.resolve. It also works with non-existent paths so unless there's some performance issue I'm not aware of for resolving '.' and '..', then I say we deprecate Path.absolute().

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29688>
_______________________________________

From report at bugs.python.org  Fri Mar  3 15:46:14 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 03 Mar 2017 20:46:14 +0000
Subject: [docs] [issue29455] Mention coverage.py in trace module
 documentation
In-Reply-To: <1486352347.76.0.0578982981399.issue29455@psf.upfronthosting.co.za>
Message-ID: <1488573974.84.0.46698149468.issue29455@psf.upfronthosting.co.za>


Changes by Brett Cannon <brett at python.org>:


----------
pull_requests: +361

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29455>
_______________________________________

From report at bugs.python.org  Fri Mar  3 16:01:05 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 03 Mar 2017 21:01:05 +0000
Subject: [docs] [issue29455] Mention coverage.py in trace module
 documentation
In-Reply-To: <1486352347.76.0.0578982981399.issue29455@psf.upfronthosting.co.za>
Message-ID: <1488574865.66.0.672110219147.issue29455@psf.upfronthosting.co.za>


Brett Cannon added the comment:

Thanks for the PR, Marco!

----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29455>
_______________________________________

From report at bugs.python.org  Fri Mar  3 16:17:05 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 03 Mar 2017 21:17:05 +0000
Subject: [docs] [issue29688] Document Path.absolute
In-Reply-To: <1488389848.79.0.700814097868.issue29688@psf.upfronthosting.co.za>
Message-ID: <1488575825.79.0.847152292248.issue29688@psf.upfronthosting.co.za>


Brett Cannon added the comment:

I've closed the PR on GitHub until we decide whether we just want to deprecate Path.absolute() in favour of Path.resolve().

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29688>
_______________________________________

From report at bugs.python.org  Fri Mar  3 16:20:32 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 03 Mar 2017 21:20:32 +0000
Subject: [docs] [issue29688] Document Path.absolute
In-Reply-To: <1488389848.79.0.700814097868.issue29688@psf.upfronthosting.co.za>
Message-ID: <1488576032.43.0.178629153667.issue29688@psf.upfronthosting.co.za>


Changes by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
nosy: +pitrou

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29688>
_______________________________________

From report at bugs.python.org  Fri Mar  3 16:21:09 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 03 Mar 2017 21:21:09 +0000
Subject: [docs] [issue29651] Inconsistent/undocumented urlsplit/urlparse
 behavior on invalid inputs
In-Reply-To: <1488051927.22.0.367579438822.issue29651@psf.upfronthosting.co.za>
Message-ID: <1488576069.77.0.118574388917.issue29651@psf.upfronthosting.co.za>


Changes by Terry J. Reedy <tjreedy at udel.edu>:


----------
nosy: +orsenthil
stage:  -> needs patch
versions:  -Python 3.3, Python 3.4, Python 3.5

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29651>
_______________________________________

From report at bugs.python.org  Fri Mar  3 16:22:17 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 03 Mar 2017 21:22:17 +0000
Subject: [docs] [issue29709] Short-circuiting not only on False and True
In-Reply-To: <1488543100.15.0.348225972332.issue29709@psf.upfronthosting.co.za>
Message-ID: <1488576137.15.0.813752219607.issue29709@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +362

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29709>
_______________________________________

From report at bugs.python.org  Fri Mar  3 16:22:53 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 03 Mar 2017 21:22:53 +0000
Subject: [docs] [issue29709] Short-circuiting not only on False and True
In-Reply-To: <1488543100.15.0.348225972332.issue29709@psf.upfronthosting.co.za>
Message-ID: <1488576173.22.0.710365936278.issue29709@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +363

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29709>
_______________________________________

From report at bugs.python.org  Fri Mar  3 16:23:34 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 03 Mar 2017 21:23:34 +0000
Subject: [docs] [issue29709] Short-circuiting not only on False and True
In-Reply-To: <1488543100.15.0.348225972332.issue29709@psf.upfronthosting.co.za>
Message-ID: <1488576214.32.0.469738683724.issue29709@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +364

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29709>
_______________________________________

From report at bugs.python.org  Fri Mar  3 16:26:13 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 03 Mar 2017 21:26:13 +0000
Subject: [docs] [issue26213] Document BUILD_*_UNPACK opcodes
In-Reply-To: <1453851645.07.0.698993321818.issue26213@psf.upfronthosting.co.za>
Message-ID: <1488576373.23.0.43780885215.issue26213@psf.upfronthosting.co.za>


Changes by Brett Cannon <brett at python.org>:


----------
assignee: docs at python -> brett.cannon

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue26213>
_______________________________________

From report at bugs.python.org  Fri Mar  3 16:26:26 2017
From: report at bugs.python.org (James O)
Date: Fri, 03 Mar 2017 21:26:26 +0000
Subject: [docs] [issue29716] Python 3 Module doc still sounds like
 __init__.py is required
Message-ID: <1488576386.83.0.924613404524.issue29716@psf.upfronthosting.co.za>


New submission from James O:

PEP 420 says "Allowing implicit namespace packages means that the requirement to provide an __init__.py file can be dropped completely..."
(as described here:  http://stackoverflow.com/questions/37139786/is-init-py-not-required-for-packages-in-python-3)

The documentation for modules <https://docs.python.org/3/tutorial/modules.html> doesn't seem to reflect this change. 

My "enhancement suggestion" is that a sentence (and perhaps an example) be added that explicitly states or shows an import from another directory.

(P.S. This is my first Python bug submission, so if it's silly, let me know. Thanks!)

----------
assignee: docs at python
components: Documentation
messages: 288932
nosy: James O, docs at python
priority: normal
severity: normal
status: open
title: Python 3 Module doc still sounds like __init__.py is required
type: enhancement
versions: Python 3.3, Python 3.4, Python 3.5, Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29716>
_______________________________________

From report at bugs.python.org  Fri Mar  3 16:36:46 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 03 Mar 2017 21:36:46 +0000
Subject: [docs] [issue29709] Short-circuiting not only on False and True
In-Reply-To: <1488543100.15.0.348225972332.issue29709@psf.upfronthosting.co.za>
Message-ID: <1488577006.72.0.52433179549.issue29709@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Committed and backported to 2.7, 3.5, and 3.6.
Thanks all :)

----------
resolution:  -> fixed
stage: needs patch -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29709>
_______________________________________

From report at bugs.python.org  Fri Mar  3 16:55:54 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 03 Mar 2017 21:55:54 +0000
Subject: [docs] [issue26213] Document BUILD_*_UNPACK opcodes
In-Reply-To: <1453851645.07.0.698993321818.issue26213@psf.upfronthosting.co.za>
Message-ID: <1488578154.43.0.879566505842.issue26213@psf.upfronthosting.co.za>


Changes by Brett Cannon <brett at python.org>:


----------
pull_requests: +366

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue26213>
_______________________________________

From report at bugs.python.org  Fri Mar  3 16:56:31 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 03 Mar 2017 21:56:31 +0000
Subject: [docs] [issue26213] Document BUILD_*_UNPACK opcodes
In-Reply-To: <1453851645.07.0.698993321818.issue26213@psf.upfronthosting.co.za>
Message-ID: <1488578191.34.0.152950685802.issue26213@psf.upfronthosting.co.za>


Changes by Brett Cannon <brett at python.org>:


----------
pull_requests: +367

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue26213>
_______________________________________

From report at bugs.python.org  Fri Mar  3 17:48:42 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 03 Mar 2017 22:48:42 +0000
Subject: [docs] [issue26213] Document BUILD_*_UNPACK opcodes
In-Reply-To: <1453851645.07.0.698993321818.issue26213@psf.upfronthosting.co.za>
Message-ID: <1488581322.81.0.463602664419.issue26213@psf.upfronthosting.co.za>


Brett Cannon added the comment:

Thanks to Ivan for the PRs!

----------
resolution:  -> fixed
stage: needs patch -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue26213>
_______________________________________

From report at bugs.python.org  Fri Mar  3 23:45:15 2017
From: report at bugs.python.org (INADA Naoki)
Date: Sat, 04 Mar 2017 04:45:15 +0000
Subject: [docs] [issue29716] Python 3 Module doc still sounds like
 __init__.py is required
In-Reply-To: <CAEfz+TwuVAL6tKfZCXmtssBVYZYt+JoT3PopT4CNquYvJA5CqA@mail.gmail.com>
Message-ID: <CAEfz+TwYrw6XqfOXq-LuvyHQ6kN2sgCdhmyCk5PC6V5wFDTP8A@mail.gmail.com>


INADA Naoki added the comment:

namespace package is very advanced topic.
I don't think tutorial should mention it.
Putting __init__.py always in normal package is highly recommended.
Otherwise, many tools can't distinguish normal directory and python package.

2017/03/04 ??6:26 "James O" <report at bugs.python.org>:

New submission from James O:

PEP 420 says "Allowing implicit namespace packages means that the
requirement to provide an __init__.py file can be dropped completely..."
(as described here:  http://stackoverflow.com/questions/37139786/is-init-py-
not-required-for-packages-in-python-3)

The documentation for modules <https://docs.python.org/3/
tutorial/modules.html> doesn't seem to reflect this change.

My "enhancement suggestion" is that a sentence (and perhaps an example) be
added that explicitly states or shows an import from another directory.

(P.S. This is my first Python bug submission, so if it's silly, let me
know. Thanks!)

----------
assignee: docs at python
components: Documentation
messages: 288932
nosy: James O, docs at python
priority: normal
severity: normal
status: open
title: Python 3 Module doc still sounds like __init__.py is required
type: enhancement
versions: Python 3.3, Python 3.4, Python 3.5, Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29716>
_______________________________________
_______________________________________________
docs mailing list
docs at python.org
https://mail.python.org/mailman/listinfo/docs

----------
nosy: +inada.naoki

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29716>
_______________________________________

From report at bugs.python.org  Fri Mar  3 23:52:59 2017
From: report at bugs.python.org (James O)
Date: Sat, 04 Mar 2017 04:52:59 +0000
Subject: [docs] [issue29716] Python 3 Module doc still sounds like
 __init__.py is required
In-Reply-To: <1488576386.83.0.924613404524.issue29716@psf.upfronthosting.co.za>
Message-ID: <1488603179.76.0.227500400722.issue29716@psf.upfronthosting.co.za>


James O added the comment:

Ah, I didn't realize some tools depended on it. Should I set the status to closed? (like I said, I'm new to this)

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29716>
_______________________________________

From report at bugs.python.org  Sat Mar  4 00:15:17 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Sat, 04 Mar 2017 05:15:17 +0000
Subject: [docs] [issue29651] Inconsistent/undocumented urlsplit/urlparse
 behavior on invalid inputs
In-Reply-To: <1488051927.22.0.367579438822.issue29651@psf.upfronthosting.co.za>
Message-ID: <1488604517.83.0.517873365453.issue29651@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

A note in the docs would be useful.  This API is far too well established to make any behavioral changes at this point.

----------
nosy: +rhettinger

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29651>
_______________________________________

From report at bugs.python.org  Sat Mar  4 00:20:37 2017
From: report at bugs.python.org (INADA Naoki)
Date: Sat, 04 Mar 2017 05:20:37 +0000
Subject: [docs] [issue29716] Python 3 Module doc still sounds like
 __init__.py is required
In-Reply-To: <1488603179.76.0.227500400722.issue29716@psf.upfronthosting.co.za>
Message-ID: <CAEfz+TxPbCoR-Kr0HdSmBU-rBGKEJS2S8zMkKofT9kt=9eo4wA@mail.gmail.com>


INADA Naoki added the comment:

I think so.
namespace package is topic for packaging ecosystem developers, like
setuptools and pip.
Normal python programmer shouldn't omit __init__.py.
Python tutorial is for people who want to be normal python programmer.

2017/03/04 ??1:53 "James O" <report at bugs.python.org>:

>
> James O added the comment:
>
> Ah, I didn't realize some tools depended on it. Should I set the status to
> closed? (like I said, I'm new to this)
>
> ----------
>
> _______________________________________
> Python tracker <report at bugs.python.org>
> <http://bugs.python.org/issue29716>
> _______________________________________
>

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29716>
_______________________________________

From report at bugs.python.org  Sat Mar  4 11:35:48 2017
From: report at bugs.python.org (Marco Buttu)
Date: Sat, 04 Mar 2017 16:35:48 +0000
Subject: [docs] [issue29716] Python 3 Module doc still sounds like
 __init__.py is required
In-Reply-To: <1488576386.83.0.924613404524.issue29716@psf.upfronthosting.co.za>
Message-ID: <1488645348.5.0.170743443436.issue29716@psf.upfronthosting.co.za>


Changes by Marco Buttu <marco.buttu at gmail.com>:


----------
nosy: +marco.buttu

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29716>
_______________________________________

From report at bugs.python.org  Sat Mar  4 22:26:38 2017
From: report at bugs.python.org (Adam)
Date: Sun, 05 Mar 2017 03:26:38 +0000
Subject: [docs] [issue29722] heapq.merge docs don't handle reverse flag well
Message-ID: <1488684398.15.0.985624873811.issue29722@psf.upfronthosting.co.za>


New submission from Adam:

The docs for heapq.merge are a little misleading. Iterables passed into heapq.merge with the reversed flag set to True must be sorted from largest to smallest to achieve the desired sorting effect, but the paragraph describing the function in the general case states that they should be sorted from smallest to largest.

----------
assignee: docs at python
components: Documentation
messages: 288997
nosy: adamniederer, docs at python
priority: normal
pull_requests: 388
severity: normal
status: open
title: heapq.merge docs don't handle reverse flag well
type: behavior
versions: Python 2.7, Python 3.3, Python 3.4, Python 3.5, Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29722>
_______________________________________

From report at bugs.python.org  Sat Mar  4 22:29:29 2017
From: report at bugs.python.org (Adam)
Date: Sun, 05 Mar 2017 03:29:29 +0000
Subject: [docs] [issue29722] heapq.merge docs are misleading with the
 "reversed" flag
In-Reply-To: <1488684398.15.0.985624873811.issue29722@psf.upfronthosting.co.za>
Message-ID: <1488684569.81.0.643656486893.issue29722@psf.upfronthosting.co.za>


Changes by Adam <adam.niederer at gmail.com>:


----------
title: heapq.merge docs don't handle reverse flag well -> heapq.merge docs are misleading with the "reversed" flag

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29722>
_______________________________________

From report at bugs.python.org  Sat Mar  4 22:36:46 2017
From: report at bugs.python.org (Nick Coghlan)
Date: Sun, 05 Mar 2017 03:36:46 +0000
Subject: [docs] [issue29710] Incorrect representation caveat on bitwise
 operation docs
In-Reply-To: <1488551919.31.0.20533072889.issue29710@psf.upfronthosting.co.za>
Message-ID: <1488685006.56.0.778704146939.issue29710@psf.upfronthosting.co.za>


Nick Coghlan added the comment:

Added 2.7 to the list of affected versions.

Clearly my 2's-complement arithmetic is incredibly rusty, as for some reason I was thinking "~(-sys.maxint-1)" could overflow, but no, the answer to that is just "sys.maxint" :)

----------
versions: +Python 2.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29710>
_______________________________________

From report at bugs.python.org  Sun Mar  5 00:00:08 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Sun, 05 Mar 2017 05:00:08 +0000
Subject: [docs] [issue29722] heapq.merge docs are misleading with the
 "reversed" flag
In-Reply-To: <1488684398.15.0.985624873811.issue29722@psf.upfronthosting.co.za>
Message-ID: <1488690008.18.0.212012050875.issue29722@psf.upfronthosting.co.za>


Changes by Raymond Hettinger <raymond.hettinger at gmail.com>:


----------
assignee: docs at python -> rhettinger
nosy: +rhettinger

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29722>
_______________________________________

From report at bugs.python.org  Sun Mar  5 01:51:15 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sun, 05 Mar 2017 06:51:15 +0000
Subject: [docs] [issue29557] binhex documentation claims unknown bug
In-Reply-To: <1487089244.04.0.406287394607.issue29557@psf.upfronthosting.co.za>
Message-ID: <1488696675.28.0.191441681969.issue29557@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +389

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29557>
_______________________________________

From report at bugs.python.org  Sun Mar  5 01:51:46 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sun, 05 Mar 2017 06:51:46 +0000
Subject: [docs] [issue29557] binhex documentation claims unknown bug
In-Reply-To: <1487089244.04.0.406287394607.issue29557@psf.upfronthosting.co.za>
Message-ID: <1488696706.41.0.178374425043.issue29557@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +390

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29557>
_______________________________________

From report at bugs.python.org  Sun Mar  5 02:46:32 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 05 Mar 2017 07:46:32 +0000
Subject: [docs] [issue29557] binhex documentation claims unknown bug
In-Reply-To: <1487089244.04.0.406287394607.issue29557@psf.upfronthosting.co.za>
Message-ID: <1488699991.85.0.44555640442.issue29557@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

See also issue29566. Perhaps hexbin() bug is related to that bug.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29557>
_______________________________________

From report at bugs.python.org  Sun Mar  5 11:32:04 2017
From: report at bugs.python.org (Chris Warrick)
Date: Sun, 05 Mar 2017 16:32:04 +0000
Subject: [docs] =?utf-8?q?=5Bissue29724=5D_Itertools_docs_propose_a_harmfu?=
 =?utf-8?q?l_=E2=80=9Cspeedup=E2=80=9D_without_any_explanation?=
Message-ID: <1488731524.9.0.615939918768.issue29724@psf.upfronthosting.co.za>


New submission from Chris Warrick:

The itertools recipes list [0] ends with the following dubious advice:

> Note, many of the above recipes can be optimized by replacing global lookups with local variables defined as default values. For example, the dotproduct recipe can be written as:
>
> def dotproduct(vec1, vec2, sum=sum, map=map, mul=operator.mul):
>     return sum(map(mul, vec1, vec2))

This is presented in the document without any explanation. It may confuse beginners into always doing it in their code (as evidenced in #python today), leading to unreadable code and function signatures. There is also no proof of there being a significant speed difference by using this ?trick?. In my opinion, this should not be part of the documentation, or should provide proof that it can provide a real, noticeable speedup and is not premature optimization.

(Added in [1] by Raymond Hettinger ? added to nosy list)

[0]: https://docs.python.org/3/library/itertools.html#itertools-recipes
[1]: https://github.com/python/cpython/commit/fc91aa28fd8dad5280fd4d3a4747b5e08ee37ac0

----------
assignee: docs at python
components: Documentation
messages: 289020
nosy: Kwpolska, docs at python, rhettinger
priority: normal
severity: normal
status: open
title: Itertools docs propose a harmful ?speedup? without any explanation
versions: Python 2.7, Python 3.3, Python 3.4, Python 3.5, Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29724>
_______________________________________

From report at bugs.python.org  Sun Mar  5 11:47:29 2017
From: report at bugs.python.org (=?utf-8?q?J=C3=BCrgen_A=2E_Erhard?=)
Date: Sun, 05 Mar 2017 16:47:29 +0000
Subject: [docs] [issue29725] sqlite3.Cursor doesn't properly document
 "arraysize"
Message-ID: <1488732449.69.0.822466282685.issue29725@psf.upfronthosting.co.za>


New submission from J?rgen A. Erhard:

It's an attribute mentioned in fetchmany and fetchall, but it's not in the list with those two, but it should be, since the section says "A Cursor instance has the following attributes and methods." and it is an attribute.

----------
assignee: docs at python
components: Documentation
messages: 289023
nosy: docs at python, jae
priority: normal
severity: normal
status: open
title: sqlite3.Cursor doesn't properly document "arraysize"

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29725>
_______________________________________

From report at bugs.python.org  Sun Mar  5 11:57:56 2017
From: report at bugs.python.org (Steven D'Aprano)
Date: Sun, 05 Mar 2017 16:57:56 +0000
Subject: [docs] =?utf-8?q?=5Bissue29724=5D_Itertools_docs_propose_a_harmfu?=
 =?utf-8?q?l_=E2=80=9Cspeedup=E2=80=9D_without_any_explanation?=
In-Reply-To: <1488731524.9.0.615939918768.issue29724@psf.upfronthosting.co.za>
Message-ID: <1488733076.78.0.615761097204.issue29724@psf.upfronthosting.co.za>


Changes by Steven D'Aprano <steve+python at pearwood.info>:


----------
nosy: +steven.daprano

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29724>
_______________________________________

From report at bugs.python.org  Sun Mar  5 12:32:38 2017
From: report at bugs.python.org (Steven D'Aprano)
Date: Sun, 05 Mar 2017 17:32:38 +0000
Subject: [docs] =?utf-8?q?=5Bissue29724=5D_Itertools_docs_propose_a_harmfu?=
 =?utf-8?q?l_=E2=80=9Cspeedup=E2=80=9D_without_any_explanation?=
In-Reply-To: <1488731524.9.0.615939918768.issue29724@psf.upfronthosting.co.za>
Message-ID: <1488735158.37.0.824750546179.issue29724@psf.upfronthosting.co.za>


Steven D'Aprano added the comment:

On my computer, running Python 3.5 and continuing to do other tasks while the tests are running, I get a reproducible 5% speedup by using the "default values" trick. Here's my code:

import operator
def dotproduct(vec1, vec2):
    return sum(map(operator.mul, vec1, vec2))

def dotproduct2(vec1, vec2, sum=sum, map=map, mul=operator.mul):
    return sum(map(mul, vec1, vec2))

setup = 'from __main__ import a, b, dotproduct, dotproduct2'
from random import random as r
a = [[r(), r(), r()] for i in range(10000)]
b = [[r(), r(), r()] for i in range(10000)]
t1 = Timer('for v1, v2 in zip(a, b): dotproduct(v1, v2)', setup)
t2 = Timer('for v1, v2 in zip(a, b): dotproduct2(v1, v2)', setup)


I then ran and compared 

min(t1.repeat(number=200, repeat=10))
min(t2.repeat(number=200, repeat=10))

a few times while reading email and doing local editing of files. Normal desktop activity. Each time, t2 (the dotproduct with the micro-optimizations) was about 5% faster.

Victor will probably tell me I'm micro-benchmarking this the wrong way, so to satisfy him I did one more run:

py> import statistics
py> d1 = t1.repeat(number=200, repeat=10)
py> d2 = t2.repeat(number=200, repeat=10)
py>
py> statistics.mean(d1); statistics.stdev(d1)
5.277554708393291
0.15216686556059497
py> statistics.mean(d2); statistics.stdev(d2)
4.929395379964262
0.05397586490809523


So I'm satisfied that this trick gives a real, if small, speed up for at least the example given. YMMV.

----------
nosy: +haypo
type:  -> performance

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29724>
_______________________________________

From report at bugs.python.org  Sun Mar  5 12:45:07 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 05 Mar 2017 17:45:07 +0000
Subject: [docs] =?utf-8?q?=5Bissue29724=5D_Itertools_docs_propose_a_harmfu?=
 =?utf-8?q?l_=E2=80=9Cspeedup=E2=80=9D_without_any_explanation?=
In-Reply-To: <1488731524.9.0.615939918768.issue29724@psf.upfronthosting.co.za>
Message-ID: <1488735907.63.0.563519385986.issue29724@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

How it comparing with

    return vec1[0]*vec2[0]+vec1[1]*vec2[1]+vec1[2]*vec2[2]

and

    x1, y1, z1 = vec1
    x2, y2, z2 = vec2
    return x1*x2+y1*y2+z1*z2

and

    x1, y1, z1 = vec1
    x2, y2, z2 = vec2
    return sum(a*b for a, b in zip(vec1, vec2))

?

A 5% speed up may be not enough high for cluttering the educational example.

----------
nosy: +serhiy.storchaka

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29724>
_______________________________________

From report at bugs.python.org  Sun Mar  5 12:47:35 2017
From: report at bugs.python.org (Marc-Andre Lemburg)
Date: Sun, 05 Mar 2017 17:47:35 +0000
Subject: [docs] =?utf-8?q?=5Bissue29724=5D_Itertools_docs_propose_a_harmfu?=
 =?utf-8?q?l_=E2=80=9Cspeedup=E2=80=9D_without_any_explanation?=
In-Reply-To: <1488731524.9.0.615939918768.issue29724@psf.upfronthosting.co.za>
Message-ID: <1488736055.37.0.897084630494.issue29724@psf.upfronthosting.co.za>


Marc-Andre Lemburg added the comment:

The localization using keyword parameters is a very old trick to avoid global lookups. It does give a noticeable speedup, esp. when the localized variables are used in tight loops or the function itself is used in such loops.

The 5% speedup Steven measured matches my experience with this trick as well. In some cases, it can provide a more dramatic speedup, but this depends a lot on how the code is written.

----------
nosy: +lemburg

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29724>
_______________________________________

From report at bugs.python.org  Sun Mar  5 12:56:02 2017
From: report at bugs.python.org (Leonid R.)
Date: Sun, 05 Mar 2017 17:56:02 +0000
Subject: [docs] =?utf-8?q?=5Bissue29724=5D_Itertools_docs_propose_a_harmfu?=
 =?utf-8?q?l_=E2=80=9Cspeedup=E2=80=9D_without_any_explanation?=
In-Reply-To: <1488731524.9.0.615939918768.issue29724@psf.upfronthosting.co.za>
Message-ID: <1488736562.12.0.206091597273.issue29724@psf.upfronthosting.co.za>


Leonid R. added the comment:

I think this is a "last resort" optimization and shouldn't be encouraged, especially in the official documentation. There are plenty of real optimizations you can do before doing micro-optimizations like this, and there is no reason it should be mentioned in the docs.

----------
nosy: +leovp

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29724>
_______________________________________

From report at bugs.python.org  Sun Mar  5 13:04:26 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 05 Mar 2017 18:04:26 +0000
Subject: [docs] =?utf-8?q?=5Bissue29724=5D_Itertools_docs_propose_a_harmfu?=
 =?utf-8?q?l_=E2=80=9Cspeedup=E2=80=9D_without_any_explanation?=
In-Reply-To: <1488731524.9.0.615939918768.issue29724@psf.upfronthosting.co.za>
Message-ID: <1488737066.08.0.823089833533.issue29724@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

I have got 15% speed up.

But two of my variants (the first and the second) speed up the calculation by 2.8 and 3.6 times correspondingly. It doesn't make sense to talk about microoptimization of the example if rewriting it without using iterator tools can get much larger speed up.

The example still is good for the case when use vectors of large dimensions. But in that case the effect of the microoptimization is dwarfed by the time of iteration and calculation.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29724>
_______________________________________

From report at bugs.python.org  Sun Mar  5 13:26:44 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Sun, 05 Mar 2017 18:26:44 +0000
Subject: [docs] =?utf-8?q?=5Bissue29724=5D_Itertools_docs_propose_a_harmfu?=
 =?utf-8?q?l_=E2=80=9Cspeedup=E2=80=9D_without_any_explanation?=
In-Reply-To: <1488731524.9.0.615939918768.issue29724@psf.upfronthosting.co.za>
Message-ID: <1488738404.56.0.0371450575904.issue29724@psf.upfronthosting.co.za>


Changes by Raymond Hettinger <raymond.hettinger at gmail.com>:


----------
assignee: docs at python -> rhettinger

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29724>
_______________________________________

From report at bugs.python.org  Sun Mar  5 13:32:37 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Sun, 05 Mar 2017 18:32:37 +0000
Subject: [docs] =?utf-8?q?=5Bissue29724=5D_Itertools_docs_propose_a_harmfu?=
 =?utf-8?q?l_=E2=80=9Cspeedup=E2=80=9D_without_any_explanation?=
In-Reply-To: <1488731524.9.0.615939918768.issue29724@psf.upfronthosting.co.za>
Message-ID: <1488738757.58.0.233163668848.issue29724@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

The reason that this comment was added was to note the recipes themselves are unoptimized and to provide some guideance on how that could be done.  The recipes themselves are provided in the cleaner looking form.

FWIW, localizing variables is one of the few code optimizations available to python programmers.  It is not uncommon in the standard library eventhough there are some people who just don't like it (including apparently the OP).

Sorry Chris, I'm going to reject this.  The note is correct, the optimization is valid, and so is the original purpose for adding it.

----------
resolution:  -> not a bug
stage:  -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29724>
_______________________________________

From report at bugs.python.org  Sun Mar  5 14:09:12 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Sun, 05 Mar 2017 19:09:12 +0000
Subject: [docs] =?utf-8?q?=5Bissue29724=5D_Itertools_docs_propose_a_harmfu?=
 =?utf-8?q?l_=E2=80=9Cspeedup=E2=80=9D_without_any_explanation?=
In-Reply-To: <1488731524.9.0.615939918768.issue29724@psf.upfronthosting.co.za>
Message-ID: <1488740952.39.0.277342389034.issue29724@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

Additional note:  For folks interested in performance, it is common for people not to realize that function call overhead can dominate their timings (see this recent SO question as a recent, but typical example http://stackoverflow.com/questions/41772054 ).

In any case, the note needs to remain because people commonly move these recipes into production code and need to be warned that basic optimizations were skipped.  This is important in a module where improved performance is one of the primary goals.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29724>
_______________________________________

From report at bugs.python.org  Sun Mar  5 17:01:01 2017
From: report at bugs.python.org (STINNER Victor)
Date: Sun, 05 Mar 2017 22:01:01 +0000
Subject: [docs] =?utf-8?q?=5Bissue29724=5D_Itertools_docs_propose_a_harmfu?=
 =?utf-8?q?l_=E2=80=9Cspeedup=E2=80=9D_without_any_explanation?=
In-Reply-To: <1488735158.37.0.824750546179.issue29724@psf.upfronthosting.co.za>
Message-ID: <CAMpsgwbFnHXGxfvzq=7HhwEG8MmanqndanfEohbLizWZJ-V=og@mail.gmail.com>


STINNER Victor added the comment:

> Victor will probably tell me I'm micro-benchmarking this the wrong way,
so to satisfy him I did one more run:

You are doing it the wrong way :-D Please replace Timeit(...) with
runner=perf.Runner() and then runner.timeit('bench1', ...).

Runner spaws multiples processes and then test if a comparison is
significant (perf compare_to a.json b.json).

Moreover, for microbenchmaks, I highly recommand to tune your system for
benchmarks: python3 -m perf system tune, and see also perf doc ;-)

5% is not significant on a microbenchmark, it can be pure noise.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29724>
_______________________________________

From report at bugs.python.org  Sun Mar  5 17:01:42 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 05 Mar 2017 22:01:42 +0000
Subject: [docs] [issue28749] Fixed the documentation of the mapping codec
 APIs
In-Reply-To: <1479637798.25.0.994184606714.issue28749@psf.upfronthosting.co.za>
Message-ID: <1488751302.71.0.510627094123.issue28749@psf.upfronthosting.co.za>


Changes by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
pull_requests: +400

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28749>
_______________________________________

From andrineduus at gmail.com  Fri Mar  3 11:06:36 2017
From: andrineduus at gmail.com (Andrine Duus)
Date: Fri, 3 Mar 2017 10:06:36 -0600
Subject: [docs] 9. Classes << The Python Tutorial
Message-ID: <CAMVZ_s-9CgNJWgX1dA+=ozQbu0_ynw=FNAPot--MnVUfHJHn9Q@mail.gmail.com>

Suddenly, some "I" is writing the tutorial. But, "we" don't care.

That's only somewhat excusable in texts or papers written by one
individual. Certainly, it wouldn't be excusable in documentation at the
gateway of a massive community.

And other things like statements "A *namespace* is a mapping from names to
objects" should be looked into as well in a proofing. Most people learning
to program for the first time may come to a language like Python, and they
wouldn't have learned formal definitions of mathematical functions to make
sense of such phrasings.

A writer signaling their "higher knowledge" to a fraction of the audience
doesn't serve pedagogical purposes.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170303/b023dba9/attachment.html>

From nicolas.bergeaud at gmail.com  Sun Mar  5 11:06:30 2017
From: nicolas.bergeaud at gmail.com (Nicolas Bergeaud)
Date: Sun, 5 Mar 2017 17:06:30 +0100
Subject: [docs] ePub version does ont exist
Message-ID: <8AC7E43A-31FD-4086-8EC3-BEE522EBE119@gmail.com>



ePub version does ont exist
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170305/9a94d096/attachment.html>

From report at bugs.python.org  Mon Mar  6 13:44:11 2017
From: report at bugs.python.org (Brett Cannon)
Date: Mon, 06 Mar 2017 18:44:11 +0000
Subject: [docs] [issue29716] Python 3 Module doc still sounds like
 __init__.py is required
In-Reply-To: <1488576386.83.0.924613404524.issue29716@psf.upfronthosting.co.za>
Message-ID: <1488825851.02.0.638832087338.issue29716@psf.upfronthosting.co.za>


Brett Cannon added the comment:

I've gone ahead and closed this. Thanks for taking the time to check in on this, James!

----------
nosy: +brett.cannon
resolution:  -> not a bug
stage:  -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29716>
_______________________________________

From report at bugs.python.org  Tue Mar  7 10:51:01 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 07 Mar 2017 15:51:01 +0000
Subject: [docs] [issue19871] json module won't parse a float that starts
 with a decimal point
In-Reply-To: <1386058873.01.0.290791588539.issue19871@psf.upfronthosting.co.za>
Message-ID: <1488901861.96.0.612201780579.issue19871@psf.upfronthosting.co.za>


Changes by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
status: open -> pending

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue19871>
_______________________________________

From report at bugs.python.org  Tue Mar  7 12:44:29 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 07 Mar 2017 17:44:29 +0000
Subject: [docs] =?utf-8?q?=5Bissue17003=5D_Unification_of_read=28=29=C2=A0?=
 =?utf-8?q?and_readline=28=29_argument_names?=
In-Reply-To: <1358698394.54.0.180835263252.issue17003@psf.upfronthosting.co.za>
Message-ID: <1488908669.03.0.907986910671.issue17003@psf.upfronthosting.co.za>


Changes by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue17003>
_______________________________________

From report at bugs.python.org  Tue Mar  7 14:03:00 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 07 Mar 2017 19:03:00 +0000
Subject: [docs] [issue25841] In FancyURLopener error in example with http
 address.
In-Reply-To: <1449848545.54.0.701964592914.issue25841@psf.upfronthosting.co.za>
Message-ID: <1488913380.81.0.175911147745.issue25841@psf.upfronthosting.co.za>


Changes by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
stage: needs patch -> resolved
status: pending -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue25841>
_______________________________________

From report at bugs.python.org  Tue Mar  7 14:08:44 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 07 Mar 2017 19:08:44 +0000
Subject: [docs] [issue1283110] Give __len__() advice for "don't know"
Message-ID: <1488913724.64.0.507470088103.issue1283110@psf.upfronthosting.co.za>


Changes by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
keywords: +needs review
stage:  -> patch review
status: pending -> open
versions: +Python 3.5, Python 3.6, Python 3.7 -Python 3.4

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue1283110>
_______________________________________

From report at bugs.python.org  Tue Mar  7 16:53:10 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 07 Mar 2017 21:53:10 +0000
Subject: [docs] [issue29751] PyLong_FromString fails on decimals with
 leading zero and base=0
In-Reply-To: <1488922068.27.0.463542328186.issue29751@psf.upfronthosting.co.za>
Message-ID: <1488923590.79.0.511752398889.issue29751@psf.upfronthosting.co.za>


Changes by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
assignee:  -> docs at python
components: +Documentation -Interpreter Core
nosy: +docs at python, mark.dickinson
type: behavior -> enhancement

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29751>
_______________________________________

From report at bugs.python.org  Tue Mar  7 21:32:22 2017
From: report at bugs.python.org (Tomohiko Kinebuchi)
Date: Wed, 08 Mar 2017 02:32:22 +0000
Subject: [docs] [issue19225] lack of PyExc_BufferError doc
In-Reply-To: <1381485777.95.0.364414099437.issue19225@psf.upfronthosting.co.za>
Message-ID: <1488940342.36.0.99384311207.issue19225@psf.upfronthosting.co.za>


Tomohiko Kinebuchi added the comment:

This issue seems pending.

> beng94

Would you create a pull request?

----------
nosy: +cocoatomo

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue19225>
_______________________________________

From report at bugs.python.org  Wed Mar  8 03:47:57 2017
From: report at bugs.python.org (Mark Dickinson)
Date: Wed, 08 Mar 2017 08:47:57 +0000
Subject: [docs] [issue29751] PyLong_FromString fails on decimals with
 leading zero and base=0
In-Reply-To: <1488922068.27.0.463542328186.issue29751@psf.upfronthosting.co.za>
Message-ID: <1488962877.38.0.0215333749442.issue29751@psf.upfronthosting.co.za>


Mark Dickinson added the comment:

Yes, PyLong_FromString is directly used by the implementation of int, and is also used in parsing of numeric integer literals in source:

https://github.com/python/cpython/blob/cb41b2766de646435743b6af7dd152751b54e73f/Python/ast.c#L4084

So I agree that this is a documentation bug. There's also no mention of the support for underscores in the documentation.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29751>
_______________________________________

From f.nateghirad at gmail.com  Wed Mar  8 07:13:54 2017
From: f.nateghirad at gmail.com (Faraz Nateghi Rad)
Date: Wed, 8 Mar 2017 15:43:54 +0330
Subject: [docs] power BUG
Message-ID: <CAP_VewfALVekQbCCWNnrYox7WN78m8jZtrSpLr0wQ2+T6uDn+g@mail.gmail.com>

hi
1000**(1/3) most return 10 but return 9.99999998
tanx for your attention
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170308/39b18494/attachment.html>

From selphiron at zedat.fu-berlin.de  Tue Mar  7 19:28:21 2017
From: selphiron at zedat.fu-berlin.de (Ahmet-Serdar Karakaya)
Date: Wed, 8 Mar 2017 01:28:21 +0100
Subject: [docs] Questions about API documentation
Message-ID: <16444.95.91.246.87.1488932901.webmail@webmail.zedat.fu-berlin.de>

Hello,

I am trying to understand how to write good API documentation. I have read
?7. Documenting Python? in the python developers guide [1] and skimmed the
Doc-SIG email archives, but I still have some questions and I would
appreciate your help. (Whenever I refer to me in the following questions,
I mean documentation authors in general)

1) How much should I (or a documentation author in general) go into
detail? I don?t want to bore experienced users, but I don?t want to scare
beginners away either.

2) Should I give a code example for each method and object?

3) I recognize 2 different kinds of examples: Some are rather small and
right under the object or method description and some are quite long and
at the end of a module in a use case. Which kind is encouraged at which
conditions?

4) The documentation of the Python Standard Library is quite verbose or
like a book / tutorial. Some other documentations like JavaDoc [2] or
PerlDoc [3] use a more reference-like documentation. Why did Python choose
a different approach? Was this discussed before?

5) Do you have any other advice? Are there things I should be aware of?

Regards

Ahmet-Serdar Karakaya



[1] https://docs.python.org/devguide/documenting.html

[2] http://docs.oracle.com/javase/8/docs/api/index.html

[3] http://perldoc.perl.org/



From supakit.kr at gmail.com  Wed Mar  8 01:28:26 2017
From: supakit.kr at gmail.com (Supakit Kriangkhajorn)
Date: Wed, 8 Mar 2017 13:28:26 +0700
Subject: [docs] Report bug of fixes.py
Message-ID: <CAJ+H_cU7oguqF+KFA1Ev6Zw-6jwLr4BC3mTSHV8vTBeC7GEedQ@mail.gmail.com>

Dear, support


I met bug in fixes.py file.

Bug detail :

File "C:\Python36\lib\site-packages\sklearn\utils\fixes.py", line 406, in
<module>
    if np_version < (1, 12, 0):
TypeError: '<' not supported between instances of 'str' and 'int'


Solution :
Edit line 406 from if np_version < (1, 12, 0) to if np_version < (1, 12)

May be, It occur only my laptop, please test it and if you not understand
please reply me.


Thank you.
?
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170308/73d9d327/attachment.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: Screenshot (380).png
Type: image/png
Size: 15056 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20170308/73d9d327/attachment.png>

From bgailer at gmail.com  Wed Mar  8 08:29:04 2017
From: bgailer at gmail.com (Bob Gailer)
Date: Wed, 8 Mar 2017 08:29:04 -0500
Subject: [docs] power BUG
In-Reply-To: <CAP_VewfALVekQbCCWNnrYox7WN78m8jZtrSpLr0wQ2+T6uDn+g@mail.gmail.com>
References: <CAP_VewfALVekQbCCWNnrYox7WN78m8jZtrSpLr0wQ2+T6uDn+g@mail.gmail.com>
Message-ID: <CAP1rxO48Li7RKuf1P4eD3vdg6izktM3U7+dFcWDg2ffTpF+tuw@mail.gmail.com>

On Mar 8, 2017 8:02 AM, "Faraz Nateghi Rad" <f.nateghirad at gmail.com> wrote:
>
> hi
> 1000**(1/3) most return 10 but return 9.99999998
probably just floating point arithmetic inaccuracy.
> tanx for your attention
>
> _______________________________________________
> docs mailing list
> docs at python.org
> https://mail.python.org/mailman/listinfo/docs
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170308/41716ce8/attachment-0001.html>

From report at bugs.python.org  Wed Mar  8 10:01:57 2017
From: report at bugs.python.org (Steven D'Aprano)
Date: Wed, 08 Mar 2017 15:01:57 +0000
Subject: [docs] [issue29756] Improve documentation for list methods that
 compare items by equality
In-Reply-To: <1488981833.28.0.455455965624.issue29756@psf.upfronthosting.co.za>
Message-ID: <1488985317.79.0.112661931752.issue29756@psf.upfronthosting.co.za>


Steven D'Aprano added the comment:

Further to Barry's explanation, you see the same result with any values which compare equal:

py> from decimal import Decimal as D
py> [1, 1.0, D(1), True, 1+0j].count(D(1))
5

This is standard behaviour for methods `count`, `remove`, and `index`, but it isn't explained well in the documentation. E.g. `remove` says "Remove the first item from the list whose value is x` which could be read as meaning that the test is done by identity. All three methods need to clarify that ordinary == equality is used.


I'm going to re-open the task as a documentation issue.

----------
assignee:  -> docs at python
components: +Documentation
nosy: +docs at python, steven.daprano
resolution: not a bug -> 
stage: resolved -> 
status: closed -> open
title: List count() counts True as 1 -> Improve documentation for list methods that compare items by equality
type:  -> enhancement
versions:  -Python 2.7, Python 3.5

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29756>
_______________________________________

From report at bugs.python.org  Wed Mar  8 10:10:16 2017
From: report at bugs.python.org (Steven D'Aprano)
Date: Wed, 08 Mar 2017 15:10:16 +0000
Subject: [docs] [issue29756] Improve documentation for list methods that
 compare items by equality
In-Reply-To: <1488981833.28.0.455455965624.issue29756@psf.upfronthosting.co.za>
Message-ID: <1488985815.96.0.74650153271.issue29756@psf.upfronthosting.co.za>


Steven D'Aprano added the comment:

To be clear, I'm referring to the docs in the tutorial:

https://docs.python.org/3.7/tutorial/datastructures.html

and the docstrings as well as the library reference:

https://docs.python.org/3.7/library/stdtypes.html#sequence-types-list-tuple-range

The library reference already notes that `remove` uses equality, but the others do not.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29756>
_______________________________________

From report at bugs.python.org  Wed Mar  8 10:35:23 2017
From: report at bugs.python.org (Josh Rosenberg)
Date: Wed, 08 Mar 2017 15:35:23 +0000
Subject: [docs] [issue29756] Improve documentation for list methods that
 compare items by equality
In-Reply-To: <1488981833.28.0.455455965624.issue29756@psf.upfronthosting.co.za>
Message-ID: <1488987323.45.0.697958840526.issue29756@psf.upfronthosting.co.za>


Josh Rosenberg added the comment:

Steven: Technically, in CPython, they use both identity and equality testing, as a function of using RichCompareBool (which tests identity first, then equality), rather than RichCompare (which only tests equality).

It makes a difference for stuff like NaN values, where describing it as equality only would imply that:

nan = float('nan')
([nan] * 10).count(nan)

produces 0 (because nan is equal to nothing, including itself), when in fact it produces 10 (because we reused the same nan object, and the identity test passed).

----------
nosy: +josh.r

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29756>
_______________________________________

From report at bugs.python.org  Wed Mar  8 12:31:31 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 08 Mar 2017 17:31:31 +0000
Subject: [docs] [issue28810] Document bytecode changes in 3.6
In-Reply-To: <1480184644.53.0.660721117392.issue28810@psf.upfronthosting.co.za>
Message-ID: <1488994291.2.0.606346258952.issue28810@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

Ping.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28810>
_______________________________________

From report at bugs.python.org  Wed Mar  8 13:19:47 2017
From: report at bugs.python.org (Brett Cannon)
Date: Wed, 08 Mar 2017 18:19:47 +0000
Subject: [docs] [issue28810] Document bytecode changes in 3.6
In-Reply-To: <1480184644.53.0.660721117392.issue28810@psf.upfronthosting.co.za>
Message-ID: <1488997187.41.0.972573730736.issue28810@psf.upfronthosting.co.za>


Brett Cannon added the comment:

If the "ping" is for me, I spent my open source day last week reviewing the dependency for this issue (and other stuff) so I plan to get to this PR this Friday.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28810>
_______________________________________

From report at bugs.python.org  Wed Mar  8 15:47:17 2017
From: report at bugs.python.org (Ivan Levkivskyi)
Date: Wed, 08 Mar 2017 20:47:17 +0000
Subject: [docs] [issue28810] Document bytecode changes in 3.6
In-Reply-To: <1480184644.53.0.660721117392.issue28810@psf.upfronthosting.co.za>
Message-ID: <1489006037.06.0.556511958346.issue28810@psf.upfronthosting.co.za>


Ivan Levkivskyi added the comment:

It looks like there are still few things that are not covered in two open PRs. I will add these in an additional PR in the next few days.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28810>
_______________________________________

From report at bugs.python.org  Wed Mar  8 23:07:31 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Thu, 09 Mar 2017 04:07:31 +0000
Subject: [docs] [issue29756] Improve documentation for list methods that
 compare items by equality
In-Reply-To: <1488981833.28.0.455455965624.issue29756@psf.upfronthosting.co.za>
Message-ID: <1489032451.42.0.362541284425.issue29756@psf.upfronthosting.co.za>


Xiang Zhang added the comment:

+1 for jsoh. Actually the behaviour is documented in https://docs.python.org/3/reference/expressions.html#value-comparisons.

So a single 'a is b' or 'a == b' is not complete. I would like to use 'equal to' which implies 'a is b or a == b'.

----------
nosy: +xiang.zhang

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29756>
_______________________________________

From report at bugs.python.org  Wed Mar  8 23:59:26 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Thu, 09 Mar 2017 04:59:26 +0000
Subject: [docs] [issue29756] Improve documentation for list methods that
 compare items by equality
In-Reply-To: <1488981833.28.0.455455965624.issue29756@psf.upfronthosting.co.za>
Message-ID: <1489035566.25.0.146512920495.issue29756@psf.upfronthosting.co.za>


Changes by Xiang Zhang <angwerzx at 126.com>:


----------
pull_requests: +468

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29756>
_______________________________________

From report at bugs.python.org  Thu Mar  9 07:49:52 2017
From: report at bugs.python.org (Wolfgang Langner)
Date: Thu, 09 Mar 2017 12:49:52 +0000
Subject: [docs] [issue29770] Executable help output (--help) at commandline
 is wrong for option -B
Message-ID: <1489063792.65.0.00439171993212.issue29770@psf.upfronthosting.co.za>


New submission from Wolfgang Langner:

The output for "python --help" for the option -B is wrong.
It contains also the old pyo files. But they were removed.

Output is:

-B     : don't write .py[co] files on import; also PYTHONDONTWRITEBYTECODE=x

should be:

-B     : don't write .pyc files on import; also PYTHONDONTWRITEBYTECODE=x

----------
assignee: docs at python
components: Documentation
messages: 289287
nosy: docs at python, tds333
priority: normal
severity: normal
status: open
title: Executable help output (--help) at commandline is wrong for option -B
type: enhancement
versions: Python 3.5, Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29770>
_______________________________________

From report at bugs.python.org  Thu Mar  9 08:38:05 2017
From: report at bugs.python.org (Eric V. Smith)
Date: Thu, 09 Mar 2017 13:38:05 +0000
Subject: [docs] [issue29771] An email and MIME handling package - Add
 support to send CC of email
In-Reply-To: <1489065010.61.0.0444038371691.issue29771@psf.upfronthosting.co.za>
Message-ID: <1489066685.9.0.0384941553706.issue29771@psf.upfronthosting.co.za>


Eric V. Smith added the comment:

So, you want to improve the examples? I wouldn't be opposed to that. I don't see that there's any code to change.

----------
assignee:  -> docs at python
components: +Documentation
nosy: +docs at python

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29771>
_______________________________________

From report at bugs.python.org  Thu Mar  9 08:42:29 2017
From: report at bugs.python.org (Jack)
Date: Thu, 09 Mar 2017 13:42:29 +0000
Subject: [docs] [issue29771] An email and MIME handling package - Add
 support to send CC of email
In-Reply-To: <1489065010.61.0.0444038371691.issue29771@psf.upfronthosting.co.za>
Message-ID: <1489066948.98.0.703656568445.issue29771@psf.upfronthosting.co.za>


Jack added the comment:

I think you missundersttod. I showed the example page just so you would understand what I am talking about.
Let me explain it better:
msg['Subject'] = 'The contents of %s' % textfile
msg['From'] = me
msg['To'] = you

Works.

msg['Subject'] = 'The contents of %s' % textfile
msg['From'] = me
msg['To'] = you
msg['CC'] = x
msg['BCC'] = y

won't work. It doesn't know what is CC and BCC.
This is why I opened this request to modify the package to support it.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29771>
_______________________________________

From report at bugs.python.org  Thu Mar  9 08:43:36 2017
From: report at bugs.python.org (Jack)
Date: Thu, 09 Mar 2017 13:43:36 +0000
Subject: [docs] [issue29771] An email and MIME handling package - Add
 support to send CC of email
In-Reply-To: <1489065010.61.0.0444038371691.issue29771@psf.upfronthosting.co.za>
Message-ID: <1489067016.17.0.844704810228.issue29771@psf.upfronthosting.co.za>


Jack added the comment:

Please see the stack overflow question:
http://stackoverflow.com/questions/42696100/python-smtp-send-email-with-cc

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29771>
_______________________________________

From report at bugs.python.org  Thu Mar  9 08:44:54 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 09 Mar 2017 13:44:54 +0000
Subject: [docs] [issue29771] An email and MIME handling package - Add
 support to send CC of email
In-Reply-To: <1489065010.61.0.0444038371691.issue29771@psf.upfronthosting.co.za>
Message-ID: <1489067094.09.0.907486807666.issue29771@psf.upfronthosting.co.za>


Changes by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
components: +email
nosy: +barry, r.david.murray

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29771>
_______________________________________

From report at bugs.python.org  Thu Mar  9 08:53:34 2017
From: report at bugs.python.org (Eric V. Smith)
Date: Thu, 09 Mar 2017 13:53:34 +0000
Subject: [docs] [issue29771] An email and MIME handling package - Add
 support to send CC of email
In-Reply-To: <1489065010.61.0.0444038371691.issue29771@psf.upfronthosting.co.za>
Message-ID: <1489067614.93.0.225025979516.issue29771@psf.upfronthosting.co.za>


Eric V. Smith added the comment:

You need to review how SMTP works. The contents of the mail message have no bearing on where messages are sent. That's exactly how BCC works: there's nothing in the message telling you who is BCC'd, but the mail is still sent to the BCC recipients, via SMTP.

Similarly, you could have the message say that someone at example.com is in the To: header, but not send it to them via SMTP.

I'm on the fence about including this in the examples.

In any event, this bug tracker is not a place for an email tutorial. From your SO link, there's a reference (by user xyref) to another question which explains this in detail: http://stackoverflow.com/questions/1546367/python-how-to-send-mail-with-to-cc-and-bcc. This completely explains the issue.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29771>
_______________________________________

From report at bugs.python.org  Thu Mar  9 08:59:09 2017
From: report at bugs.python.org (Jack)
Date: Thu, 09 Mar 2017 13:59:09 +0000
Subject: [docs] [issue29771] An email and MIME handling package - Add
 support to send CC of email
In-Reply-To: <1489065010.61.0.0444038371691.issue29771@psf.upfronthosting.co.za>
Message-ID: <1489067949.17.0.132025099136.issue29771@psf.upfronthosting.co.za>


Jack added the comment:

"I'm on the fence about including this in the examples."

Think of it this way.. Including it in the docs would have prevented this question.
It can be just a side note it doesn't have to be a whole example.

Thx.

----------
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29771>
_______________________________________

From report at bugs.python.org  Thu Mar  9 08:59:53 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 09 Mar 2017 13:59:53 +0000
Subject: [docs] [issue29770] Executable help output (--help) at commandline
 is wrong for option -B
In-Reply-To: <1489063792.65.0.00439171993212.issue29770@psf.upfronthosting.co.za>
Message-ID: <1489067993.06.0.25977852158.issue29770@psf.upfronthosting.co.za>


Changes by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
nosy: +brett.cannon

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29770>
_______________________________________

From report at bugs.python.org  Thu Mar  9 09:01:02 2017
From: report at bugs.python.org (R. David Murray)
Date: Thu, 09 Mar 2017 14:01:02 +0000
Subject: [docs] [issue29771] An email and MIME handling package - Add
 support to send CC of email
In-Reply-To: <1489065010.61.0.0444038371691.issue29771@psf.upfronthosting.co.za>
Message-ID: <1489068062.69.0.650473060327.issue29771@psf.upfronthosting.co.za>


R. David Murray added the comment:

If you use smtplib.send_message in python3, it will do what you want (including stripping BCC headers before sending the message).

If someone wants to create a PR to add an example of what Eric is talking about (specifying additional senders in smtplib.sendmail to match what is in the CC headers) please open a new issue with a PR (which may or may not get accepted :). I don't think it is worth doing, myself, but I won't object if others think it enhances the docs.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29771>
_______________________________________

From report at bugs.python.org  Thu Mar  9 09:44:56 2017
From: report at bugs.python.org (Kinebuchi Tomohiko)
Date: Thu, 09 Mar 2017 14:44:56 +0000
Subject: [docs] [issue29772] Unintentionally deleted line on
 library/collections.rst
Message-ID: <1489070696.66.0.394233240398.issue29772@psf.upfronthosting.co.za>


New submission from Kinebuchi Tomohiko:

The last part of "Counter objects" section has a strange line: "in Smalltalk."

https://docs.python.org/2.7/library/collections.html#counter-objects

The line just before "in Smalltalk" might be deleted by accident.
Related issue is bpo-25910 [1]_ and the applied patch is this [2]_, although an intended patch might looks like this [3]_.

.. [1] http://bugs.python.org/issue25910

.. [2] https://hg.python.org/cpython/rev/14e00e7e4d51#l15.7
   patch for the 2.7 branch

.. [3] https://hg.python.org/cpython/rev/ce5ef48b5140#l21.7
   patch for the 3.5 branch

I will create a pull request.

----------
assignee: docs at python
components: Documentation
messages: 289300
nosy: cocoatomo, docs at python
priority: normal
severity: normal
status: open
title: Unintentionally deleted line on library/collections.rst
versions: Python 2.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29772>
_______________________________________

From report at bugs.python.org  Thu Mar  9 10:22:28 2017
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 09 Mar 2017 15:22:28 +0000
Subject: [docs] [issue29772] Unintentionally deleted line on
 library/collections.rst
In-Reply-To: <1489070696.66.0.394233240398.issue29772@psf.upfronthosting.co.za>
Message-ID: <1489072948.05.0.277834209752.issue29772@psf.upfronthosting.co.za>


Changes by Roundup Robot <devnull at psf.upfronthosting.co.za>:


----------
pull_requests: +478

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29772>
_______________________________________

From report at bugs.python.org  Thu Mar  9 10:37:00 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 09 Mar 2017 15:37:00 +0000
Subject: [docs] [issue29772] Unintentionally deleted line on
 library/collections.rst
In-Reply-To: <1489070696.66.0.394233240398.issue29772@psf.upfronthosting.co.za>
Message-ID: <1489073820.69.0.24177573092.issue29772@psf.upfronthosting.co.za>


Changes by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
nosy: +serhiy.storchaka

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29772>
_______________________________________

From report at bugs.python.org  Thu Mar  9 10:56:01 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Thu, 09 Mar 2017 15:56:01 +0000
Subject: [docs] [issue29772] Unintentionally deleted line on
 library/collections.rst
In-Reply-To: <1489070696.66.0.394233240398.issue29772@psf.upfronthosting.co.za>
Message-ID: <1489074961.62.0.388853840839.issue29772@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

Nice catch.

----------
nosy: +rhettinger
resolution:  -> fixed
stage:  -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29772>
_______________________________________

From report at bugs.python.org  Thu Mar  9 13:37:52 2017
From: report at bugs.python.org (Brett Cannon)
Date: Thu, 09 Mar 2017 18:37:52 +0000
Subject: [docs] [issue29751] PyLong_FromString documentation wrong on
 numbers with leading zero and base=0
In-Reply-To: <1488922068.27.0.463542328186.issue29751@psf.upfronthosting.co.za>
Message-ID: <1489084672.14.0.612376343696.issue29751@psf.upfronthosting.co.za>


Changes by Brett Cannon <brett at python.org>:


----------
title: PyLong_FromString fails on decimals with leading zero and base=0 -> PyLong_FromString documentation wrong on numbers with leading zero and base=0

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29751>
_______________________________________

From report at bugs.python.org  Fri Mar 10 00:11:13 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Fri, 10 Mar 2017 05:11:13 +0000
Subject: [docs] [issue29770] Executable help output (--help) at commandline
 is wrong for option -B
In-Reply-To: <1489063792.65.0.00439171993212.issue29770@psf.upfronthosting.co.za>
Message-ID: <1489122673.41.0.136354138413.issue29770@psf.upfronthosting.co.za>


Changes by Xiang Zhang <angwerzx at 126.com>:


----------
pull_requests: +486

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29770>
_______________________________________

From report at bugs.python.org  Fri Mar 10 02:02:39 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 10 Mar 2017 07:02:39 +0000
Subject: [docs] [issue28739] PEP 498: docstrings as f-strings
In-Reply-To: <1479501831.35.0.531195928426.issue28739@psf.upfronthosting.co.za>
Message-ID: <1489129359.33.0.516390641588.issue28739@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +487

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28739>
_______________________________________

From report at bugs.python.org  Fri Mar 10 02:07:17 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 10 Mar 2017 07:07:17 +0000
Subject: [docs] [issue28739] PEP 498: docstrings as f-strings
In-Reply-To: <1479501831.35.0.531195928426.issue28739@psf.upfronthosting.co.za>
Message-ID: <1489129637.44.0.477258088331.issue28739@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Hi, I updated the documentation mentioning that f-strings cannot be used as docstring. Please review it.
Thanks.

----------
nosy: +Mariatta

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28739>
_______________________________________

From report at bugs.python.org  Fri Mar 10 02:07:48 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 10 Mar 2017 07:07:48 +0000
Subject: [docs] [issue28739] PEP 498: docstrings as f-strings
In-Reply-To: <1479501831.35.0.531195928426.issue28739@psf.upfronthosting.co.za>
Message-ID: <1489129668.12.0.0401634852205.issue28739@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
stage: needs patch -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28739>
_______________________________________

From report at bugs.python.org  Fri Mar 10 09:45:51 2017
From: report at bugs.python.org (Maxime Buquet)
Date: Fri, 10 Mar 2017 14:45:51 +0000
Subject: [docs] [issue29784] Erroneous link in shutil.copy description
Message-ID: <1489157151.86.0.545519035584.issue29784@psf.upfronthosting.co.za>


New submission from Maxime Buquet:

https://docs.python.org/3/library/shutil.html#shutil.copy

The link to "copy()" in the description seems to be pointing to the copy module, but I suppose it was meant to point at shutil.copy.

----------
assignee: docs at python
components: Documentation
messages: 289370
nosy: docs at python, pep.
priority: normal
severity: normal
status: open
title: Erroneous link in shutil.copy description

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29784>
_______________________________________

From report at bugs.python.org  Fri Mar 10 10:15:39 2017
From: report at bugs.python.org (STINNER Victor)
Date: Fri, 10 Mar 2017 15:15:39 +0000
Subject: [docs] [issue29786] asyncio.wrap_future() is not documented
Message-ID: <1489158939.82.0.933594898276.issue29786@psf.upfronthosting.co.za>


New submission from STINNER Victor:

The following asyncio function is not documented. Is it deliberate? The function is exported in the asyncio module.

def wrap_future(future, *, loop=None):
    """Wrap concurrent.futures.Future object."""

----------
assignee: docs at python
components: Documentation, asyncio
messages: 289376
nosy: docs at python, gvanrossum, haypo, yselivanov
priority: normal
severity: normal
status: open
title: asyncio.wrap_future() is not documented
versions: Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29786>
_______________________________________

From report at bugs.python.org  Fri Mar 10 10:53:46 2017
From: report at bugs.python.org (Guido van Rossum)
Date: Fri, 10 Mar 2017 15:53:46 +0000
Subject: [docs] [issue29786] asyncio.wrap_future() is not documented
In-Reply-To: <1489158939.82.0.933594898276.issue29786@psf.upfronthosting.co.za>
Message-ID: <1489161226.64.0.608371651925.issue29786@psf.upfronthosting.co.za>


Changes by Guido van Rossum <guido at python.org>:


----------
nosy:  -gvanrossum

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29786>
_______________________________________

From report at bugs.python.org  Fri Mar 10 11:59:51 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 10 Mar 2017 16:59:51 +0000
Subject: [docs] [issue28739] PEP 498: docstrings as f-strings
In-Reply-To: <1479501831.35.0.531195928426.issue28739@psf.upfronthosting.co.za>
Message-ID: <1489165191.03.0.541885797894.issue28739@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +494

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28739>
_______________________________________

From report at bugs.python.org  Fri Mar 10 12:13:33 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Fri, 10 Mar 2017 17:13:33 +0000
Subject: [docs] [issue29784] Erroneous link in shutil.copy description
In-Reply-To: <1489157151.86.0.545519035584.issue29784@psf.upfronthosting.co.za>
Message-ID: <1489166013.44.0.629097802236.issue29784@psf.upfronthosting.co.za>


Changes by Xiang Zhang <angwerzx at 126.com>:


----------
pull_requests: +495

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29784>
_______________________________________

From report at bugs.python.org  Fri Mar 10 12:15:05 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Fri, 10 Mar 2017 17:15:05 +0000
Subject: [docs] [issue29784] Erroneous link in shutil.copy description
In-Reply-To: <1489157151.86.0.545519035584.issue29784@psf.upfronthosting.co.za>
Message-ID: <1489166105.27.0.213172550393.issue29784@psf.upfronthosting.co.za>


Xiang Zhang added the comment:

Thanks for your report, Maxime! I open PRs to fix it.

----------
nosy: +xiang.zhang
versions: +Python 3.5, Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29784>
_______________________________________

From report at bugs.python.org  Fri Mar 10 12:19:36 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 10 Mar 2017 17:19:36 +0000
Subject: [docs] [issue29784] Erroneous link in shutil.copy description
In-Reply-To: <1489157151.86.0.545519035584.issue29784@psf.upfronthosting.co.za>
Message-ID: <1489166376.2.0.2640018153.issue29784@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +496

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29784>
_______________________________________

From report at bugs.python.org  Fri Mar 10 12:26:07 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Fri, 10 Mar 2017 17:26:07 +0000
Subject: [docs] [issue29784] Erroneous link in shutil.copy description
In-Reply-To: <1489157151.86.0.545519035584.issue29784@psf.upfronthosting.co.za>
Message-ID: <1489166767.56.0.456916231022.issue29784@psf.upfronthosting.co.za>


Xiang Zhang added the comment:

Assigned to Mariatta :-).

----------
assignee: docs at python -> Mariatta
nosy: +Mariatta

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29784>
_______________________________________

From report at bugs.python.org  Fri Mar 10 12:46:14 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 10 Mar 2017 17:46:14 +0000
Subject: [docs] [issue29784] Erroneous link in shutil.copy description
In-Reply-To: <1489157151.86.0.545519035584.issue29784@psf.upfronthosting.co.za>
Message-ID: <1489167974.09.0.433965502986.issue29784@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

See also issue21818. I suspect there are other incorrect references.

----------
nosy: +serhiy.storchaka

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29784>
_______________________________________

From report at bugs.python.org  Fri Mar 10 12:58:02 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 10 Mar 2017 17:58:02 +0000
Subject: [docs] [issue28739] PEP 498: docstrings as f-strings
In-Reply-To: <1479501831.35.0.531195928426.issue28739@psf.upfronthosting.co.za>
Message-ID: <1489168682.36.0.416135520908.issue28739@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Thanks for reviewing, Serhiy and Eric. Documentation has been updated and backported to 3.6.

OK to close this issue?

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28739>
_______________________________________

From report at bugs.python.org  Fri Mar 10 13:08:55 2017
From: report at bugs.python.org (Eric V. Smith)
Date: Fri, 10 Mar 2017 18:08:55 +0000
Subject: [docs] [issue28739] PEP 498: docstrings as f-strings
In-Reply-To: <1479501831.35.0.531195928426.issue28739@psf.upfronthosting.co.za>
Message-ID: <1489169335.53.0.373594385851.issue28739@psf.upfronthosting.co.za>


Eric V. Smith added the comment:

Yes, I think it can be closed. Thanks!

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28739>
_______________________________________

From report at bugs.python.org  Fri Mar 10 13:12:56 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 10 Mar 2017 18:12:56 +0000
Subject: [docs] [issue28739] PEP 498: docstrings as f-strings
In-Reply-To: <1479501831.35.0.531195928426.issue28739@psf.upfronthosting.co.za>
Message-ID: <1489169576.9.0.800475091972.issue28739@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28739>
_______________________________________

From report at bugs.python.org  Fri Mar 10 14:43:32 2017
From: report at bugs.python.org (=?utf-8?q?Adam_H=C3=B6se?=)
Date: Fri, 10 Mar 2017 19:43:32 +0000
Subject: [docs] [issue24755] asyncio.wrap_future undocumented
In-Reply-To: <1438250618.09.0.00442439827356.issue24755@psf.upfronthosting.co.za>
Message-ID: <1489175012.73.0.00416571367095.issue24755@psf.upfronthosting.co.za>


Changes by Adam H?se <adisbladis at gmail.com>:


----------
pull_requests: +497

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue24755>
_______________________________________

From report at bugs.python.org  Fri Mar 10 14:45:40 2017
From: report at bugs.python.org (=?utf-8?q?Adam_H=C3=B6se?=)
Date: Fri, 10 Mar 2017 19:45:40 +0000
Subject: [docs] [issue29786] asyncio.wrap_future() is not documented
In-Reply-To: <1489158939.82.0.933594898276.issue29786@psf.upfronthosting.co.za>
Message-ID: <1489175140.69.0.222196180545.issue29786@psf.upfronthosting.co.za>


Adam H?se added the comment:

While fixing this issue I found that it's a duplicate of issue 24755.

----------
nosy: +adisbladis
pull_requests: +498
type:  -> enhancement

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29786>
_______________________________________

From report at bugs.python.org  Fri Mar 10 15:29:43 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 10 Mar 2017 20:29:43 +0000
Subject: [docs] [issue29722] heapq.merge docs are misleading with the
 "reversed" flag
In-Reply-To: <1488684398.15.0.985624873811.issue29722@psf.upfronthosting.co.za>
Message-ID: <1489177783.61.0.963902128005.issue29722@psf.upfronthosting.co.za>


Changes by Terry J. Reedy <tjreedy at udel.edu>:


----------
versions:  -Python 3.3, Python 3.4

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29722>
_______________________________________

From report at bugs.python.org  Fri Mar 10 16:06:33 2017
From: report at bugs.python.org (Lucio Ricardo Montero Valenzuela)
Date: Fri, 10 Mar 2017 21:06:33 +0000
Subject: [docs] [issue29791] print documentation: flush is also a keyword
 argument
Message-ID: <1489179993.27.0.31165504732.issue29791@psf.upfronthosting.co.za>


New submission from Lucio Ricardo Montero Valenzuela:

In the print() function documentation (https://docs.python.org/3/library/functions.html#print), the first line says "Print objects to the text stream file, separated by sep and followed by end. sep, end and file, if present, must be given as keyword arguments.", but the function definition is said to be "print(*objects, sep=' ', end='\n', file=sys.stdout, flush=False)". Based on the Python user function definition grammar, the only way of passing an value to a non-star parameters that appear after a star-parameter is with the keyword (so the interpreter knows not to push the value into the star-parameter list/mapping). So the flush parameter can be set only naming explicitly the keyword 'flush' ?Isn't it?. So the first line of the print() function documentation should say "Print objects to the text stream file, separated by sep and followed by end. sep, end, file and flush, if present, must be given as keyword arguments.". Flush is a new parameter, so maybe you forgot to update this line of the documentation to include it.
Best regards.

----------
assignee: docs at python
components: Documentation
messages: 289411
nosy: Lucio Ricardo Montero Valenzuela, docs at python
priority: normal
severity: normal
status: open
title: print documentation: flush is also a keyword argument
type: enhancement
versions: Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29791>
_______________________________________

From report at bugs.python.org  Fri Mar 10 16:28:41 2017
From: report at bugs.python.org (Martin Panter)
Date: Fri, 10 Mar 2017 21:28:41 +0000
Subject: [docs] [issue29786] asyncio.wrap_future() is not documented
In-Reply-To: <1489158939.82.0.933594898276.issue29786@psf.upfronthosting.co.za>
Message-ID: <1489181321.57.0.899835891731.issue29786@psf.upfronthosting.co.za>


Changes by Martin Panter <vadmium+py at gmail.com>:


----------
resolution:  -> duplicate
stage:  -> resolved
status: open -> closed
superseder:  -> asyncio.wrap_future undocumented

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29786>
_______________________________________

From report at bugs.python.org  Fri Mar 10 16:30:31 2017
From: report at bugs.python.org (Martin Panter)
Date: Fri, 10 Mar 2017 21:30:31 +0000
Subject: [docs] [issue24755] asyncio.wrap_future undocumented
In-Reply-To: <1438250618.09.0.00442439827356.issue24755@psf.upfronthosting.co.za>
Message-ID: <1489181431.12.0.100591736568.issue24755@psf.upfronthosting.co.za>


Changes by Martin Panter <vadmium+py at gmail.com>:


----------
components: +asyncio
stage:  -> patch review
versions: +Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue24755>
_______________________________________

From report at bugs.python.org  Fri Mar 10 17:14:26 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 10 Mar 2017 22:14:26 +0000
Subject: [docs] [issue29688] Document Path.absolute
In-Reply-To: <1488389848.79.0.700814097868.issue29688@psf.upfronthosting.co.za>
Message-ID: <1489184066.8.0.910721074983.issue29688@psf.upfronthosting.co.za>


Brett Cannon added the comment:

I'm still thinking about this but I'm still leaning towards deprecating pathlib.absolute().

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29688>
_______________________________________

From report at bugs.python.org  Fri Mar 10 17:18:51 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 10 Mar 2017 22:18:51 +0000
Subject: [docs] [issue28810] Document bytecode changes in 3.6
In-Reply-To: <1480184644.53.0.660721117392.issue28810@psf.upfronthosting.co.za>
Message-ID: <1489184331.08.0.894119454138.issue28810@psf.upfronthosting.co.za>


Changes by Brett Cannon <brett at python.org>:


----------
pull_requests: +500

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28810>
_______________________________________

From report at bugs.python.org  Fri Mar 10 17:58:17 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 10 Mar 2017 22:58:17 +0000
Subject: [docs] [issue28810] Document bytecode changes in 3.6
In-Reply-To: <1480184644.53.0.660721117392.issue28810@psf.upfronthosting.co.za>
Message-ID: <1489186697.28.0.932581878433.issue28810@psf.upfronthosting.co.za>


Changes by Brett Cannon <brett at python.org>:


----------
pull_requests: +502

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28810>
_______________________________________

From report at bugs.python.org  Fri Mar 10 18:09:51 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 10 Mar 2017 23:09:51 +0000
Subject: [docs] [issue28810] Document bytecode changes in 3.6
In-Reply-To: <1480184644.53.0.660721117392.issue28810@psf.upfronthosting.co.za>
Message-ID: <1489187391.12.0.964558709223.issue28810@psf.upfronthosting.co.za>


Brett Cannon added the comment:

I have merged all the PRs that Ivan had open. I'll leave the issue open since Ivan said he had another PR he wanted to create.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28810>
_______________________________________

From report at bugs.python.org  Fri Mar 10 21:18:47 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 11 Mar 2017 02:18:47 +0000
Subject: [docs] [issue29784] Erroneous link in shutil.copy description
In-Reply-To: <1489157151.86.0.545519035584.issue29784@psf.upfronthosting.co.za>
Message-ID: <1489198727.8.0.255058555789.issue29784@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +503

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29784>
_______________________________________

From report at bugs.python.org  Fri Mar 10 21:19:02 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 11 Mar 2017 02:19:02 +0000
Subject: [docs] [issue29784] Erroneous link in shutil.copy description
In-Reply-To: <1489157151.86.0.545519035584.issue29784@psf.upfronthosting.co.za>
Message-ID: <1489198742.97.0.836871786408.issue29784@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +504

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29784>
_______________________________________

From report at bugs.python.org  Fri Mar 10 22:41:19 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 11 Mar 2017 03:41:19 +0000
Subject: [docs] [issue29784] Erroneous link in shutil.copy description
In-Reply-To: <1489157151.86.0.545519035584.issue29784@psf.upfronthosting.co.za>
Message-ID: <1489203678.97.0.104525882443.issue29784@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Thanks all :)
I fixed the two references to copy() in shutil docs, and backported to 3.5 and 3.6.
Since this particular issue is fixed, I'm closing this. If people find other incorrect references, they can open another ticket.

----------
resolution:  -> fixed
stage:  -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29784>
_______________________________________

From report at bugs.python.org  Sat Mar 11 00:17:14 2017
From: report at bugs.python.org (Eryk Sun)
Date: Sat, 11 Mar 2017 05:17:14 +0000
Subject: [docs] [issue29688] Document Path.absolute
In-Reply-To: <1488389848.79.0.700814097868.issue29688@psf.upfronthosting.co.za>
Message-ID: <1489209434.4.0.690311145907.issue29688@psf.upfronthosting.co.za>


Eryk Sun added the comment:

resolve() can't replace absolute(). They serve different purposes. Sometimes one wants an absolute path, but without resolving symbolic links. 

absolute() processes a path as a string, which will continue to be true if it's updated to call nt._getfullpathname (GetFullPathName) on Windows. OTOH, resolve() can outright fail on Windows. I can write up a list of examples (I can think of 5 or 6 unhandled error codes), but it's not directly relevant to this issue.

----------
nosy: +eryksun

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29688>
_______________________________________

From report at bugs.python.org  Sat Mar 11 00:34:26 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Sat, 11 Mar 2017 05:34:26 +0000
Subject: [docs] [issue29770] Executable help output (--help) at commandline
 is wrong for option -B
In-Reply-To: <1489063792.65.0.00439171993212.issue29770@psf.upfronthosting.co.za>
Message-ID: <1489210466.36.0.705611697925.issue29770@psf.upfronthosting.co.za>


Changes by Xiang Zhang <angwerzx at 126.com>:


----------
pull_requests: +505

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29770>
_______________________________________

From report at bugs.python.org  Sat Mar 11 00:49:03 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Sat, 11 Mar 2017 05:49:03 +0000
Subject: [docs] [issue29770] Executable help output (--help) at commandline
 is wrong for option -B
In-Reply-To: <1489063792.65.0.00439171993212.issue29770@psf.upfronthosting.co.za>
Message-ID: <1489211343.56.0.0875821535801.issue29770@psf.upfronthosting.co.za>


Changes by Xiang Zhang <angwerzx at 126.com>:


----------
pull_requests: +506

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29770>
_______________________________________

From report at bugs.python.org  Sat Mar 11 01:16:53 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Sat, 11 Mar 2017 06:16:53 +0000
Subject: [docs] [issue29770] Executable help output (--help) at commandline
 is wrong for option -B
In-Reply-To: <1489063792.65.0.00439171993212.issue29770@psf.upfronthosting.co.za>
Message-ID: <1489213013.78.0.998812382872.issue29770@psf.upfronthosting.co.za>


Changes by Xiang Zhang <angwerzx at 126.com>:


----------
resolution:  -> fixed
stage:  -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29770>
_______________________________________

From report at bugs.python.org  Sat Mar 11 13:20:34 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Sat, 11 Mar 2017 18:20:34 +0000
Subject: [docs] [issue29722] heapq.merge docs are misleading with the
 "reversed" flag
In-Reply-To: <1488684398.15.0.985624873811.issue29722@psf.upfronthosting.co.za>
Message-ID: <1489256434.83.0.285162990081.issue29722@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

The PR was applied to 3.7.  I don't think it is worth backing.

----------
resolution:  -> fixed
stage:  -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29722>
_______________________________________

From report at bugs.python.org  Sat Mar 11 13:43:06 2017
From: report at bugs.python.org (Brett Cannon)
Date: Sat, 11 Mar 2017 18:43:06 +0000
Subject: [docs] [issue29688] Document Path.absolute
In-Reply-To: <1488389848.79.0.700814097868.issue29688@psf.upfronthosting.co.za>
Message-ID: <1489257786.7.0.348725428818.issue29688@psf.upfronthosting.co.za>


Brett Cannon added the comment:

I know it has it's uses (avoiding stat calls is one of them), but it is still undocumented, untested, and has two comments in it saying it needs work. Because of all that it might as well not exist since it doesn't meet our standards of quality.

If someone wants to fix all those issues then we can properly document it as supported, but if no one is willing to then I don't think we should leave unsupported code lying around that people might discover through dir().

And it doesn't serve a _different_ purpose compared to resolve(), it serves a _subset_ of resolve()'s purpose since resolve() calls absolute() unconditionally.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29688>
_______________________________________

From report at bugs.python.org  Sat Mar 11 13:43:17 2017
From: report at bugs.python.org (Brett Cannon)
Date: Sat, 11 Mar 2017 18:43:17 +0000
Subject: [docs] [issue29688] Add support for Path.absolute
In-Reply-To: <1488389848.79.0.700814097868.issue29688@psf.upfronthosting.co.za>
Message-ID: <1489257797.3.0.669869913376.issue29688@psf.upfronthosting.co.za>


Changes by Brett Cannon <brett at python.org>:


----------
title: Document Path.absolute -> Add support for Path.absolute

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29688>
_______________________________________

From report at bugs.python.org  Sat Mar 11 13:43:22 2017
From: report at bugs.python.org (Brett Cannon)
Date: Sat, 11 Mar 2017 18:43:22 +0000
Subject: [docs] [issue29688] Add support for Path.absolute()
In-Reply-To: <1488389848.79.0.700814097868.issue29688@psf.upfronthosting.co.za>
Message-ID: <1489257802.43.0.245240748306.issue29688@psf.upfronthosting.co.za>


Changes by Brett Cannon <brett at python.org>:


----------
title: Add support for Path.absolute -> Add support for Path.absolute()

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29688>
_______________________________________

From report at bugs.python.org  Sat Mar 11 14:25:49 2017
From: report at bugs.python.org (Max)
Date: Sat, 11 Mar 2017 19:25:49 +0000
Subject: [docs] [issue29795] Clarify how to share multiprocessing primitives
Message-ID: <1489260349.05.0.251290010989.issue29795@psf.upfronthosting.co.za>


New submission from Max:

It seems both me and many other people (judging from SO questions) are confused about whether it's ok to write this:

from multiprocessing import Process, Queue
q = Queue()

def f():
    q.put([42, None, 'hello'])

def main():
    p = Process(target=f)
    p.start()
    print(q.get())    # prints "[42, None, 'hello']"
    p.join()

if __name__ == '__main__':
    main()

It's not ok (doesn't work on Windows presumably because somehow when it's pickled, the connection between global queues in the two processes is lost; works on Linux, because I guess fork keeps more information than pickle, so the connection is maintained).

I thought it would be good to clarify in the docs that all the Queue() and Manager().* and other similar objects should be passed as parameters not just defined as globals.

----------
assignee: docs at python
components: Documentation
messages: 289454
nosy: docs at python, max
priority: normal
severity: normal
status: open
title: Clarify how to share multiprocessing primitives
type: behavior
versions: Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29795>
_______________________________________

From delaflota at yahoo.com  Sat Mar 11 06:59:41 2017
From: delaflota at yahoo.com (Julio Talaverano)
Date: Sat, 11 Mar 2017 11:59:41 +0000 (UTC)
Subject: [docs] Bug?
References: <1322970771.3333076.1489233581159.ref@mail.yahoo.com>
Message-ID: <1322970771.3333076.1489233581159@mail.yahoo.com>

Hi,
I actually don't think it's a bug but:when I have two python installations on my win10 home (python 3.4 and 3.6) 
then when I click on a python script to get the context menu I see twice the "Edit with IDLE", 
so I can't distinguish which is which one.Is there a possibility to rename the context menu items or is it fix in the code?
Thanks
Regards
Julio
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170311/bebe902e/attachment.html>

From report at bugs.python.org  Sat Mar 11 15:46:23 2017
From: report at bugs.python.org (Davin Potts)
Date: Sat, 11 Mar 2017 20:46:23 +0000
Subject: [docs] [issue29795] Clarify how to share multiprocessing primitives
In-Reply-To: <1489260349.05.0.251290010989.issue29795@psf.upfronthosting.co.za>
Message-ID: <1489265183.45.0.907010686151.issue29795@psf.upfronthosting.co.za>


Davin Potts added the comment:

On Windows, because that OS does not support fork, multiprocessing uses spawn to create new processes by default.  Note that in Python 3, multiprocessing provides the user with a choice of how to create new processes (i.e. fork, spawn, forkserver).

When fork is used, the 'q = Queue()' in this example would be executed once by the parent process before the fork takes place, the resulting child process continues execution from the same point as the parent when it triggered the fork, and thus both parent and child processes would see the same multiprocessing.Queue.  When spawn is used, a new process is spawned and the whole of this example script would be executed again from scratch by the child process, resulting in the child (spawned) process creating a new Queue object of its own with no sense of connection to the parent.


Would you be up for proposing replacement text to improve the documentation?  Getting the documentation just right so that everyone understands it is worth spending time on.

----------
nosy: +davin
stage:  -> needs patch
type: behavior -> enhancement

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29795>
_______________________________________

From report at bugs.python.org  Sat Mar 11 19:46:36 2017
From: report at bugs.python.org (Max)
Date: Sun, 12 Mar 2017 00:46:36 +0000
Subject: [docs] [issue29795] Clarify how to share multiprocessing primitives
In-Reply-To: <1489260349.05.0.251290010989.issue29795@psf.upfronthosting.co.za>
Message-ID: <1489279596.17.0.239300163841.issue29795@psf.upfronthosting.co.za>


Max added the comment:

How about inserting this text somewhere:

Note that sharing and synchronization objects (such as `Queue()`, `Pipe()`, `Manager()`, `Lock()`, `Semaphore()`) should be made available to a new process by passing them as arguments to the `target` function invoked by the `run()` method. Making these objects visible through global variables will only work when the process was started using `fork` (and as such sacrifices portability for no special benefit).

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29795>
_______________________________________

From report at bugs.python.org  Sat Mar 11 19:47:05 2017
From: report at bugs.python.org (Eryk Sun)
Date: Sun, 12 Mar 2017 00:47:05 +0000
Subject: [docs] [issue29688] Add support for Path.absolute()
In-Reply-To: <1488389848.79.0.700814097868.issue29688@psf.upfronthosting.co.za>
Message-ID: <1489279625.84.0.115528051027.issue29688@psf.upfronthosting.co.za>


Eryk Sun added the comment:

What's the rationale for not calling self._flavour.pathmod.abspath() to implement absolute()? For example:

    >>> p = pathlib.Path('C:/con')
    >>> p._flavour.pathmod.abspath(p)
    '\\\\.\\con'
    >>> p._from_parts((p._flavour.pathmod.abspath(p),), init=False)
    WindowsPath('//./con/')

That's almost right except for an unrelated problem that pathlib shouldn't append a trailing slash for \\.\ local device paths. Doing so creates a different path, which may be invalid. \\.\con is a symbolic link to \Device\ConDrv\Console, and adding a trailing backslash after the "Console" filename is invalid. An example where the resulting path is valid but wrong is the volume device \\.\C:, which is a link to something like \Device\HarddiskVolume2. Appending a backslash refers to the root directory of the file system on the volume.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29688>
_______________________________________

From report at bugs.python.org  Sun Mar 12 04:09:08 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 12 Mar 2017 08:09:08 +0000
Subject: [docs] [issue28749] Fixed the documentation of the mapping codec
 APIs
In-Reply-To: <1479637798.25.0.994184606714.issue28749@psf.upfronthosting.co.za>
Message-ID: <1489306148.02.0.71599877546.issue28749@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

Do you still have objections Marc-Andre?

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28749>
_______________________________________

From report at bugs.python.org  Sun Mar 12 15:22:21 2017
From: report at bugs.python.org (Max)
Date: Sun, 12 Mar 2017 19:22:21 +0000
Subject: [docs] [issue29795] Clarify how to share multiprocessing primitives
In-Reply-To: <1489260349.05.0.251290010989.issue29795@psf.upfronthosting.co.za>
Message-ID: <1489346541.31.0.816526431745.issue29795@psf.upfronthosting.co.za>


Max added the comment:

Somewhat related is this statement from Programming Guidelines:

> When using the spawn or forkserver start methods many types from multiprocessing need to be picklable so that child processes can use them. However, one should generally avoid sending shared objects to other processes using pipes or queues. Instead you should arrange the program so that a process which needs access to a shared resource created elsewhere can inherit it from an ancestor process.

Since on Windows, even "inheritance" is really the same pickle + pipe executed inside CPython, I assume the entire paragraph is intended for UNIX platform only (might be worth clarifying, btw).

On Linux, "inheritance" works faster, and can deal with more complex objects compared to pickle with pipe/queue -- but it's equally true whether it's inheritance through global variables or through arguments to the target function. There's no reason 

So the text I proposed earlier wouldn't conflict with this one. It would just encourage programmers to use function arguments instead of global variables: because it's doesn't matter on Linux but makes the code portable to Windows.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29795>
_______________________________________

From report at bugs.python.org  Sun Mar 12 16:26:41 2017
From: report at bugs.python.org (Brett Cannon)
Date: Sun, 12 Mar 2017 20:26:41 +0000
Subject: [docs] [issue29688] Add support for Path.absolute()
In-Reply-To: <1488389848.79.0.700814097868.issue29688@psf.upfronthosting.co.za>
Message-ID: <1489350401.43.0.924787768905.issue29688@psf.upfronthosting.co.za>


Brett Cannon added the comment:

"What's the rationale for not calling self._flavour.pathmod.abspath() to implement absolute()?" Beats me. :) It's just how Antoine wrote it and that's all I know.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29688>
_______________________________________

From report at bugs.python.org  Sun Mar 12 16:52:49 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 12 Mar 2017 20:52:49 +0000
Subject: [docs] [issue29688] Add support for Path.absolute()
In-Reply-To: <1488389848.79.0.700814097868.issue29688@psf.upfronthosting.co.za>
Message-ID: <1489351969.3.0.589063053771.issue29688@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

posixpath.abspath() collapses "<path>/<symlink>/.." to "<path>", this is not correct. Not sure about ntpath.abspath().

----------
nosy: +serhiy.storchaka

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29688>
_______________________________________

From report at bugs.python.org  Sun Mar 12 17:53:17 2017
From: report at bugs.python.org (Alexander Todorov)
Date: Sun, 12 Mar 2017 21:53:17 +0000
Subject: [docs] [issue29756] Improve documentation for list methods that
 compare items by equality
In-Reply-To: <1488981833.28.0.455455965624.issue29756@psf.upfronthosting.co.za>
Message-ID: <1489355596.92.0.947827040639.issue29756@psf.upfronthosting.co.za>


Alexander Todorov added the comment:

Hi folks,
I have another very similar issue, it could be the same root cause. Let me know if it is. 

assert 3 == 3.0  will pass

self.assertEqual(3, 3.0) - will pass

this had the nasty side effect of my test suite not catching a problem with SUT. I have updated the test suite to validate the result type as well but want to know how to file this use-case.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29756>
_______________________________________

From report at bugs.python.org  Sun Mar 12 20:06:31 2017
From: report at bugs.python.org (Eryk Sun)
Date: Mon, 13 Mar 2017 00:06:31 +0000
Subject: [docs] [issue29688] Add support for Path.absolute()
In-Reply-To: <1488389848.79.0.700814097868.issue29688@psf.upfronthosting.co.za>
Message-ID: <1489363591.18.0.252408954954.issue29688@psf.upfronthosting.co.za>


Eryk Sun added the comment:

It's the same with ntpath.abspath since the underlying GetFullPathName function processes the path only as a string. OK, so it seems we're requiring that p.absolute().resolve() is the same as p.resolve().

Consider the following example:

    >>> p = Path('C:/symlink/../nul .eggs & spam')
    >>> print(p.absolute())
    C:\symlink\..\nul .eggs & spam
    >>> print(os.path.abspath(p))
    \\.\nul

If the current absolute() result is fine, then I think resolve() should return \\.\nul, which means it needs to be expanded to handle device-path cases for which _getfinalpathname fails. We should be able to handle these cases by falling back on _getfullpathname. It's a separate issue, but here are some concrete examples that currently cause resolve() to fail. 

GetFinalPathNameByHandle will fail with ERROR_INVALID_FUNCTION or ERROR_INVALID_PARAMETER for devices that aren't file systems and thus do not support the particular NtQueryInformationFile and NtDeviceIoControlFile information classes and IOCTLs that it requests. Also, getting a handle via CreateFile can fail with ERROR_INVALID_PARAMETER for devices that require either read or write access such as CON. It can also fail with ERROR_ACCESS_DENIED for exclusive devices that are already open such as COM1.  

ERROR_ACCESS_DENIED can also be due to the file security denying the right to read attributes or synchronize since CreateFile implicitly requests those rights. There's also ERROR_SHARING_VIOLATION when trying to open a system paging file. These non-device PermissionError cases can be handled the same way that resolve() currently handles FileNotFoundError by trying to resolve the parent directory.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29688>
_______________________________________

From report at bugs.python.org  Sun Mar 12 20:17:56 2017
From: report at bugs.python.org (Ivan Levkivskyi)
Date: Mon, 13 Mar 2017 00:17:56 +0000
Subject: [docs] [issue28810] Document bytecode changes in 3.6
In-Reply-To: <1480184644.53.0.660721117392.issue28810@psf.upfronthosting.co.za>
Message-ID: <1489364276.3.0.514679788866.issue28810@psf.upfronthosting.co.za>


Changes by Ivan Levkivskyi <levkivskyi at gmail.com>:


----------
pull_requests: +538

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28810>
_______________________________________

From report at bugs.python.org  Sun Mar 12 21:28:02 2017
From: report at bugs.python.org (Steven D'Aprano)
Date: Mon, 13 Mar 2017 01:28:02 +0000
Subject: [docs] [issue29756] Improve documentation for list methods that
 compare items by equality
In-Reply-To: <1489355596.92.0.947827040639.issue29756@psf.upfronthosting.co.za>
Message-ID: <20170313012700.GT5689@ando.pearwood.info>


Steven D'Aprano added the comment:

I'm afraid I don't know what SUT means.

But 3 == 3.0 is the correct and expected behaviour. If you need to 
check that two values are both the same type and the same value, you 
have to validate the type and value separately.

Changing the behaviour of == is ruled out for backwards 
compatability, but perhaps you could suggest a new === operator 
to check type and value. That would require some discussion on 
the Python Ideas mailing list, not just a feature request on the 
tracker.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29756>
_______________________________________

From report at bugs.python.org  Sun Mar 12 22:11:02 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Mon, 13 Mar 2017 02:11:02 +0000
Subject: [docs] [issue29756] Improve documentation for list methods that
 compare items by equality
In-Reply-To: <1488981833.28.0.455455965624.issue29756@psf.upfronthosting.co.za>
Message-ID: <1489371062.34.0.831787660024.issue29756@psf.upfronthosting.co.za>


Changes by Xiang Zhang <angwerzx at 126.com>:


----------
resolution:  -> fixed
stage:  -> resolved
status: open -> closed
versions: +Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29756>
_______________________________________

From report at bugs.python.org  Sun Mar 12 22:25:52 2017
From: report at bugs.python.org (Max)
Date: Mon, 13 Mar 2017 02:25:52 +0000
Subject: [docs] [issue29795] Clarify how to share multiprocessing primitives
In-Reply-To: <1489260349.05.0.251290010989.issue29795@psf.upfronthosting.co.za>
Message-ID: <1489371952.8.0.300316658755.issue29795@psf.upfronthosting.co.za>


Max added the comment:

Actually, never mind, I think one of the paragraphs in the Programming Guidelines ("Explicitly pass resources to child processes") basically explains everything already. I just didn't notice it until @noxdafox pointed it out to me on SO.

Close please.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29795>
_______________________________________

From report at bugs.python.org  Sun Mar 12 22:33:42 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Mon, 13 Mar 2017 02:33:42 +0000
Subject: [docs] [issue22576] ftplib documentation gives a wrong argument
 name for storbinary
In-Reply-To: <1412714078.21.0.80330944433.issue22576@psf.upfronthosting.co.za>
Message-ID: <1489372422.05.0.487866593111.issue22576@psf.upfronthosting.co.za>


Changes by Xiang Zhang <angwerzx at 126.com>:


----------
pull_requests: +539

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue22576>
_______________________________________

From report at bugs.python.org  Sun Mar 12 22:35:07 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Mon, 13 Mar 2017 02:35:07 +0000
Subject: [docs] [issue22576] ftplib documentation gives a wrong argument
 name for storbinary
In-Reply-To: <1412714078.21.0.80330944433.issue22576@psf.upfronthosting.co.za>
Message-ID: <1489372507.05.0.900434929289.issue22576@psf.upfronthosting.co.za>


Changes by Xiang Zhang <angwerzx at 126.com>:


----------
versions: +Python 2.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue22576>
_______________________________________

From report at bugs.python.org  Sun Mar 12 22:58:49 2017
From: report at bugs.python.org (INADA Naoki)
Date: Mon, 13 Mar 2017 02:58:49 +0000
Subject: [docs] [issue29688] Add support for Path.absolute()
In-Reply-To: <1488389848.79.0.700814097868.issue29688@psf.upfronthosting.co.za>
Message-ID: <1489373929.76.0.223814828695.issue29688@psf.upfronthosting.co.za>


INADA Naoki added the comment:

> posixpath.abspath() collapses "<path>/<symlink>/.." to "<path>", this is not correct. Not sure about ntpath.abspath().

I feel this is reasonable limitation, and expected behavior for some cases.
So I think adding note about this in document is enough.

----------
nosy: +inada.naoki

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29688>
_______________________________________

From report at bugs.python.org  Sun Mar 12 23:42:17 2017
From: report at bugs.python.org (Davin Potts)
Date: Mon, 13 Mar 2017 03:42:17 +0000
Subject: [docs] [issue29795] Clarify how to share multiprocessing primitives
In-Reply-To: <1489260349.05.0.251290010989.issue29795@psf.upfronthosting.co.za>
Message-ID: <1489376537.57.0.541718975524.issue29795@psf.upfronthosting.co.za>


Changes by Davin Potts <python at discontinuity.net>:


----------
resolution:  -> works for me
stage: needs patch -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29795>
_______________________________________

From report at bugs.python.org  Mon Mar 13 09:11:40 2017
From: report at bugs.python.org (Wolfgang Langner)
Date: Mon, 13 Mar 2017 13:11:40 +0000
Subject: [docs] [issue29770] Executable help output (--help) at commandline
 is wrong for option -B
In-Reply-To: <1489063792.65.0.00439171993212.issue29770@psf.upfronthosting.co.za>
Message-ID: <1489410700.31.0.708133035749.issue29770@psf.upfronthosting.co.za>


Wolfgang Langner added the comment:

Thanks for fixing this so fast. Good work.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29770>
_______________________________________

From report at bugs.python.org  Mon Mar 13 12:38:23 2017
From: report at bugs.python.org (Brett Cannon)
Date: Mon, 13 Mar 2017 16:38:23 +0000
Subject: [docs] [issue29688] Add support for Path.absolute()
In-Reply-To: <1488389848.79.0.700814097868.issue29688@psf.upfronthosting.co.za>
Message-ID: <1489423103.61.0.0465827624673.issue29688@psf.upfronthosting.co.za>


Changes by Brett Cannon <brett at python.org>:


----------
assignee: brett.cannon -> 

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29688>
_______________________________________

From report at bugs.python.org  Mon Mar 13 23:18:20 2017
From: report at bugs.python.org (Anne Moroney)
Date: Tue, 14 Mar 2017 03:18:20 +0000
Subject: [docs] [issue29806] Requesting version info with lowercase -v or
 -vv causes an import crash
Message-ID: <1489461500.81.0.649560868679.issue29806@psf.upfronthosting.co.za>


New submission from Anne Moroney:

In trying to test the new feature in 3.6.0, 
$ python -VV  # get more info than python -V or python --version 
I found several oddities. 

1.On both  Amazon Linux AMI Python 2.7.12 and also Anaconda Python 3.6.0, using lowercase v's causes a crash on some kind of import.

1a.AWS first lines are:
[ec2-user at ip-172-31-2-101 ~]$ python -v
# installing zipimport hook
import zipimport # builtin
# installed zipimport hook
# /usr/lib64/python2.7/site.pyc matches /usr/lib64/python2.7/site.py
import site # precompiled from /usr/lib64/python2.7/site.pyc

1b.Conda first lines are:
(py36aws)me:tool-aws me$ python -v
import _frozen_importlib # frozen
import _imp # builtin
import sys # builtin
import '_warnings' # <class '_frozen_importlib.BuiltinImporter'>
//etc 

1c.In both cases, after lots of stuff, must quit python with 
quit()

2.Anaconda does not provide more information. Is that expected?
(py36aws) $ python -VV
Python 3.6.0 :: Continuum Analytics, Inc.
(py36aws)$ python -V
Python 3.6.0 :: Continuum Analytics, Inc.
(py36aws)$ python --version
Python 3.6.0 :: Continuum Analytics, Inc.

----------
assignee: docs at python
components: Documentation
messages: 289561
nosy: AnneTheAgile, docs at python
priority: normal
severity: normal
status: open
title: Requesting version info with lowercase -v or -vv causes an import crash
type: crash
versions: Python 2.7, Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29806>
_______________________________________

From report at bugs.python.org  Mon Mar 13 23:26:39 2017
From: report at bugs.python.org (INADA Naoki)
Date: Tue, 14 Mar 2017 03:26:39 +0000
Subject: [docs] [issue29806] Requesting version info with lowercase -v or
 -vv causes an import crash
In-Reply-To: <1489461500.81.0.649560868679.issue29806@psf.upfronthosting.co.za>
Message-ID: <1489461999.58.0.439470537885.issue29806@psf.upfronthosting.co.za>


INADA Naoki added the comment:

> 1.On both  Amazon Linux AMI Python 2.7.12 and also Anaconda Python 3.6.0, using lowercase v's causes a crash on some kind of import.

Lowercase -v is not version, it's "verbose". and -vv is "very verbose".
So it's not crash, just a verbose message about importing.

> 2.Anaconda does not provide more information. Is that expected?

output of -V and -VV is implementation detail.  No standard format is specified by Python language.
PyPy has different output too.

----------
nosy: +inada.naoki
resolution:  -> not a bug

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29806>
_______________________________________

From report at bugs.python.org  Mon Mar 13 23:33:57 2017
From: report at bugs.python.org (Ned Deily)
Date: Tue, 14 Mar 2017 03:33:57 +0000
Subject: [docs] [issue29806] Requesting version info with lowercase -v or
 -vv causes an import crash
In-Reply-To: <1489461500.81.0.649560868679.issue29806@psf.upfronthosting.co.za>
Message-ID: <1489462437.64.0.610356514624.issue29806@psf.upfronthosting.co.za>


Changes by Ned Deily <nad at python.org>:


----------
stage:  -> resolved
status: open -> closed
type: crash -> 

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29806>
_______________________________________

From report at bugs.python.org  Tue Mar 14 02:18:04 2017
From: report at bugs.python.org (Steve Carter)
Date: Tue, 14 Mar 2017 06:18:04 +0000
Subject: [docs] [issue29807] ArgParse page in library reference rewrite
Message-ID: <1489472284.38.0.40207115242.issue29807@psf.upfronthosting.co.za>


New submission from Steve Carter:

Originally raise as https://github.com/python/pythondotorg/issues/1059

Although it's a reference page, it is clouded by too many examples and too little reference material. Moreover, the examples are not real-world applications of argument parsing.

I propose removing the "process some integers" example, replacing it with something more typically gnu style, e.g., myapp.py [--quiet] [--log-level _n_] [--title=STR] {get | put} [FSPEC [, FSPEC...]]. This shows the user how to to many of the common command-line tasks.

[I'm tentatively offering to do this, but I haven't yet found the content I need to revise.]

----------
assignee: docs at python
components: Documentation
messages: 289569
nosy: docs at python, sweavo
priority: normal
severity: normal
status: open
title: ArgParse page in library reference rewrite
versions: Python 2.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29807>
_______________________________________

From vadmium+py at gmail.com  Tue Mar 14 04:19:39 2017
From: vadmium+py at gmail.com (vadmium+py at gmail.com)
Date: Tue, 14 Mar 2017 08:19:39 -0000
Subject: [docs] argparse doc introduction is inappropriately targeted (issue
 26602)
Message-ID: <20170314081939.6596.56251@psf.upfronthosting.co.za>


https://bugs.python.org/review/26602/diff/16809/Doc/library/argparse.rst
File Doc/library/argparse.rst (right):

https://bugs.python.org/review/26602/diff/16809/Doc/library/argparse.rst#newcode31
Doc/library/argparse.rst:31: The following code is a Python program that
takes a String and outputs the
String doesn?t need to be capitalized I don?t think

https://bugs.python.org/review/26602/diff/16809/Doc/library/argparse.rst#newcode37
Doc/library/argparse.rst:37: parser.add_argument("message", help='Type
in any message')
I find starting parameter descriptions with lower case is more
consistent with the default description for ?--help?:

positional arguments:
  message     Type in any message

optional arguments:
  -h, --help  show this help message and exit

https://bugs.python.org/review/26602/diff/16809/Doc/library/argparse.rst#newcode40
Doc/library/argparse.rst:40: print args.message[:1]
You seem to be replacing a Python 3 example with Python 2 syntax.

https://bugs.python.org/review/26602/diff/16809/Doc/library/argparse.rst#newcode52
Doc/library/argparse.rst:52: message           type in any message
Spacing seems off. Also casing of ?Type? is different to in the code.

https://bugs.python.org/review/26602/diff/16809/Doc/library/argparse.rst#newcode103
Doc/library/argparse.rst:103: >>> parser.add_argument('message',
help='an integer for the accumulator')
Looks like this is unfinished, a cross between the old and new examples
:)

https://bugs.python.org/review/26602/

From report at bugs.python.org  Tue Mar 14 04:22:46 2017
From: report at bugs.python.org (Martin Panter)
Date: Tue, 14 Mar 2017 08:22:46 +0000
Subject: [docs] [issue26602] argparse doc introduction is inappropriately
 targeted
In-Reply-To: <1458562294.77.0.347454712136.issue26602@psf.upfronthosting.co.za>
Message-ID: <1489479766.5.0.782036176889.issue26602@psf.upfronthosting.co.za>


Martin Panter added the comment:

The patch looks unfinished. I left some narrow nit-picky review comments, but I haven?t really thought about the problem from a high level.

----------
nosy: +martin.panter
stage:  -> patch review
versions: +Python 2.7, Python 3.5, Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue26602>
_______________________________________

From report at bugs.python.org  Tue Mar 14 04:27:28 2017
From: report at bugs.python.org (Ivan Levkivskyi)
Date: Tue, 14 Mar 2017 08:27:28 +0000
Subject: [docs] [issue28810] Document bytecode changes in 3.6
In-Reply-To: <1480184644.53.0.660721117392.issue28810@psf.upfronthosting.co.za>
Message-ID: <1489480048.0.0.654630580465.issue28810@psf.upfronthosting.co.za>


Changes by Ivan Levkivskyi <levkivskyi at gmail.com>:


----------
pull_requests: +547

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28810>
_______________________________________

From report at bugs.python.org  Tue Mar 14 06:09:56 2017
From: report at bugs.python.org (Martin Panter)
Date: Tue, 14 Mar 2017 10:09:56 +0000
Subject: [docs] [issue29807] ArgParse page in library reference rewrite
In-Reply-To: <1489472284.38.0.40207115242.issue29807@psf.upfronthosting.co.za>
Message-ID: <1489486196.01.0.990527697431.issue29807@psf.upfronthosting.co.za>


Martin Panter added the comment:

Also see Issue 26602 and Issue 11176, each with patches. Perhaps you could help review and combine them.

----------
nosy: +martin.panter

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29807>
_______________________________________

From report at bugs.python.org  Tue Mar 14 10:42:42 2017
From: report at bugs.python.org (Jim Fasarakis-Hilliard)
Date: Tue, 14 Mar 2017 14:42:42 +0000
Subject: [docs] [issue29387] Tabs vs spaces FAQ out of date
In-Reply-To: <1485734038.81.0.0566253928841.issue29387@psf.upfronthosting.co.za>
Message-ID: <1489502562.64.0.749358441341.issue29387@psf.upfronthosting.co.za>


Jim Fasarakis-Hilliard added the comment:

Shouldn't this issue get closed now that the PR was merged?

----------
nosy: +Jim Fasarakis-Hilliard

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29387>
_______________________________________

From report at bugs.python.org  Tue Mar 14 13:52:45 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 14 Mar 2017 17:52:45 +0000
Subject: [docs] [issue29387] Tabs vs spaces FAQ out of date
In-Reply-To: <1485734038.81.0.0566253928841.issue29387@psf.upfronthosting.co.za>
Message-ID: <1489513965.82.0.721877386733.issue29387@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Just a question, does this need backport to 2.7?
It's only been backported to 3.5 and 3.6.

----------
nosy: +Mariatta

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29387>
_______________________________________

From report at bugs.python.org  Tue Mar 14 16:37:05 2017
From: report at bugs.python.org (Martin Panter)
Date: Tue, 14 Mar 2017 20:37:05 +0000
Subject: [docs] [issue29387] Tabs vs spaces FAQ out of date
In-Reply-To: <1485734038.81.0.0566253928841.issue29387@psf.upfronthosting.co.za>
Message-ID: <1489523825.35.0.77583358235.issue29387@psf.upfronthosting.co.za>


Martin Panter added the comment:

The ?tabnanny? script was removed from Tools/scripts/ in 2.0: <https://github.com/python/cpython/commit/a02c898>. So the 2.7 FAQ also has the wrong location.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29387>
_______________________________________

From report at bugs.python.org  Tue Mar 14 16:54:35 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 14 Mar 2017 20:54:35 +0000
Subject: [docs] [issue29387] Tabs vs spaces FAQ out of date
In-Reply-To: <1485734038.81.0.0566253928841.issue29387@psf.upfronthosting.co.za>
Message-ID: <1489524875.81.0.838628367209.issue29387@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Thanks, Martin, and thanks Jim for the ping.
I'll backport the change to 2.7 later today, and then this issue can be closed :)

----------
assignee: docs at python -> Mariatta

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29387>
_______________________________________

From report at bugs.python.org  Tue Mar 14 17:47:16 2017
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 14 Mar 2017 21:47:16 +0000
Subject: [docs] [issue29026] time.time() documentation should mention UTC
 timezone
In-Reply-To: <1482243889.09.0.538886851254.issue29026@psf.upfronthosting.co.za>
Message-ID: <1489528036.3.0.253438733403.issue29026@psf.upfronthosting.co.za>


STINNER Victor added the comment:

Mariatta: "Hi, does this need backport to 2.7? I'm getting a lot of conflicts while trying to do that... Not sure how to proceed."

I think it's ok to leave Python 2.7 doc unchanged. It's only a minor doc enhancement, the 2.7 doc is still correct. I close the issue.

----------
resolution:  -> fixed
stage:  -> resolved
status: open -> closed
versions:  -Python 2.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29026>
_______________________________________

From report at bugs.python.org  Tue Mar 14 22:40:50 2017
From: report at bugs.python.org (Michael Seifert)
Date: Wed, 15 Mar 2017 02:40:50 +0000
Subject: [docs] [issue29813] PyTuple_GetSlice documentation incorrect
Message-ID: <1489545650.77.0.905284505898.issue29813@psf.upfronthosting.co.za>


New submission from Michael Seifert:

The PyTuple_GetSlice documentation says it "Take a slice of the tuple pointed to by p from low to high and return it as a new tuple." [0] However in case the start is <= 0 and the stop is >= tuplesize it doesn't return the promised "new tuple", it just returns the tuplepointer after incrementing it's refcount [1].

The behaviour is fine (it gave me a bit of a headache though), however could a note/warning/sentence be included in the docs mentioning that special case?

[0] https://docs.python.org/3/c-api/tuple.html#c.PyTuple_GetSlice
[1] https://github.com/python/cpython/blob/master/Objects/tupleobject.c#L414

----------
assignee: docs at python
components: Documentation
messages: 289632
nosy: MSeifert, docs at python
priority: normal
severity: normal
status: open
title: PyTuple_GetSlice documentation incorrect
type: behavior

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29813>
_______________________________________

From report at bugs.python.org  Tue Mar 14 22:41:35 2017
From: report at bugs.python.org (Michael Seifert)
Date: Wed, 15 Mar 2017 02:41:35 +0000
Subject: [docs] [issue29813] PyTuple_GetSlice does not always return a new
 tuple
In-Reply-To: <1489545650.77.0.905284505898.issue29813@psf.upfronthosting.co.za>
Message-ID: <1489545695.53.0.333202402136.issue29813@psf.upfronthosting.co.za>


Changes by Michael Seifert <michaelseifert04 at yahoo.de>:


----------
title: PyTuple_GetSlice documentation incorrect -> PyTuple_GetSlice does not always return a new tuple

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29813>
_______________________________________

From report at bugs.python.org  Tue Mar 14 23:36:38 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Wed, 15 Mar 2017 03:36:38 +0000
Subject: [docs] [issue29813] PyTuple_GetSlice does not always return a new
 tuple
In-Reply-To: <1489545650.77.0.905284505898.issue29813@psf.upfronthosting.co.za>
Message-ID: <1489548998.89.0.386887146872.issue29813@psf.upfronthosting.co.za>


Xiang Zhang added the comment:

I think the description is fine. :-( What leads to your headache?

----------
nosy: +xiang.zhang

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29813>
_______________________________________

From report at bugs.python.org  Wed Mar 15 00:08:48 2017
From: report at bugs.python.org (Michael Seifert)
Date: Wed, 15 Mar 2017 04:08:48 +0000
Subject: [docs] [issue29813] PyTuple_GetSlice does not always return a new
 tuple
In-Reply-To: <1489545650.77.0.905284505898.issue29813@psf.upfronthosting.co.za>
Message-ID: <1489550928.4.0.895924885104.issue29813@psf.upfronthosting.co.za>


Michael Seifert added the comment:

> What leads to your headache?

That depending on the arguments to "PyTuple_GetSlice" I get "SystemError: ..\Objects\tupleobject.c:156: bad argument to internal function" when using PyTuple_SetItem on the (supposedly) new tuple. 

Maybe I just misunderstood the word "new" in the documentation. :-)

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29813>
_______________________________________

From report at bugs.python.org  Wed Mar 15 00:17:32 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Wed, 15 Mar 2017 04:17:32 +0000
Subject: [docs] [issue29813] PyTuple_GetSlice does not always return a new
 tuple
In-Reply-To: <1489545650.77.0.905284505898.issue29813@psf.upfronthosting.co.za>
Message-ID: <1489551452.69.0.263009519663.issue29813@psf.upfronthosting.co.za>


Changes by Xiang Zhang <angwerzx at 126.com>:


----------
nosy: +rhettinger

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29813>
_______________________________________

From report at bugs.python.org  Wed Mar 15 00:25:20 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Wed, 15 Mar 2017 04:25:20 +0000
Subject: [docs] [issue29813] PyTuple_GetSlice does not always return a new
 tuple
In-Reply-To: <1489545650.77.0.905284505898.issue29813@psf.upfronthosting.co.za>
Message-ID: <1489551920.87.0.159891195927.issue29813@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

I think the docs are fine as-is.  Whether an identical tuple is new or not is an implementation detail.

IMO, the docs would create more confusion by trying to over-explain, "slicing of tuples always returns a new tuple when the result tuple is distinct from the original; however, in the case where the result tuple is not distinct, the implementation is at liberty to return the original tuple instead of a new tuple.  Since tuples are immutable, this should make no difference at all to the user."

----------
resolution:  -> not a bug
stage:  -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29813>
_______________________________________

From report at bugs.python.org  Wed Mar 15 01:04:03 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 15 Mar 2017 05:04:03 +0000
Subject: [docs] [issue29521] Minor warning messages when compiling
 documentation
In-Reply-To: <1486714459.11.0.428886237265.issue29521@psf.upfronthosting.co.za>
Message-ID: <1489554243.88.0.559916732157.issue29521@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +553

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29521>
_______________________________________

From report at bugs.python.org  Wed Mar 15 05:54:17 2017
From: report at bugs.python.org (Berker Peksag)
Date: Wed, 15 Mar 2017 09:54:17 +0000
Subject: [docs] [issue29725] sqlite3.Cursor doesn't properly document
 "arraysize"
In-Reply-To: <1488732449.69.0.822466282685.issue29725@psf.upfronthosting.co.za>
Message-ID: <1489571657.19.0.551393422725.issue29725@psf.upfronthosting.co.za>


Changes by Berker Peksag <berker.peksag at gmail.com>:


----------
keywords: +easy
nosy: +berker.peksag
stage:  -> needs patch
type:  -> enhancement
versions: +Python 3.5, Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29725>
_______________________________________

From report at bugs.python.org  Wed Mar 15 11:29:21 2017
From: report at bugs.python.org (Marco Buttu)
Date: Wed, 15 Mar 2017 15:29:21 +0000
Subject: [docs] [issue29820] Broken link to "GUI Programming with Python: QT
 Edition" book
Message-ID: <1489591760.97.0.349566849467.issue29820@psf.upfronthosting.co.za>


New submission from Marco Buttu:

In [*] the link to "GUI Programming with Python: QT Edition by Boudewijn Rempt", does not work.  I did not find an official web page for this book, but it is really outdated (2002), so maybe we can take only the reference to the Mark Summerfield's book, about PyQt4.  Let me know, so in case I will open a PR.


[*] https://docs.python.org/3/library/othergui.html

----------
assignee: docs at python
components: Documentation
messages: 289678
nosy: docs at python, marco.buttu
priority: normal
severity: normal
status: open
title: Broken link to "GUI Programming with Python: QT Edition" book
versions: Python 2.7, Python 3.3, Python 3.4, Python 3.5, Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29820>
_______________________________________

From report at bugs.python.org  Wed Mar 15 12:29:50 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 15 Mar 2017 16:29:50 +0000
Subject: [docs] [issue29820] Broken link to "GUI Programming with Python: QT
 Edition" book
In-Reply-To: <1489591760.97.0.349566849467.issue29820@psf.upfronthosting.co.za>
Message-ID: <1489595390.92.0.606841304795.issue29820@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Maybe instead of referencing to the books, we add reference to the wiki
https://wiki.python.org/moin/PyQt

----------
nosy: +Mariatta
versions:  -Python 3.3, Python 3.4

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29820>
_______________________________________

From report at bugs.python.org  Wed Mar 15 22:53:00 2017
From: report at bugs.python.org (Michael Seifert)
Date: Thu, 16 Mar 2017 02:53:00 +0000
Subject: [docs] [issue29813] PyTuple_GetSlice does not always return a new
 tuple
In-Reply-To: <1489545650.77.0.905284505898.issue29813@psf.upfronthosting.co.za>
Message-ID: <1489632780.64.0.304653728779.issue29813@psf.upfronthosting.co.za>


Michael Seifert added the comment:

I rather thought about something along the lines of: "Take a slice of the tuple pointed to by *p* from *low* to *high* and return it as a tuple. Whether the returned tuple is new or not is an implementation detail (and may depend on the value of the arguments)." Because from the point of the C-API tuples aren't immutable, at least not if they are new (refcount 1).

Thank you both for your feedback. I'll leave it closed as "not a bug", I got the point about over-explaining. :)

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29813>
_______________________________________

From chogorislava at gmail.com  Wed Mar 15 10:58:29 2017
From: chogorislava at gmail.com (Slava Novak)
Date: Wed, 15 Mar 2017 14:58:29 +0000
Subject: [docs] Misleading wording in Python HOWTOs
Message-ID: <CAEWF-4Q0LNqZ_+tVTueSAcdvQeKpW0PwHhiGSHeByNSz2tJXkw@mail.gmail.com>

Hi,

Misleading wording:
https://docs.python.org/2/howto/logging.html#logging-advanced-tutorial
Section ->Basic Logging Tutorial->When to use logging->
...
The default level is WARNING, which means that only events of this *level
and above* will be tracked, unless the logging package is configured to do
otherwise.
...

But based on the table before this sting:
Level     When it?s used
DEBUG          Detailed information, typically of interest only when
diagnosing problems.
INFO              Confirmation that things are working as expected.
WARNING      An indication that something unexpected happened, or
indicative of some problem in the near future (e.g. ?disk space low?). The
software is still working as expected.
ERROR     Due to a more serious problem, the software has not been able to
perform some function.
CRITICAL        A serious error, indicating that the program itself may be
unable to continue running.

So according to statement, all above which are blue will be logged.
Which is not true.

With WARNING level it will log: WARNING, ERROR, CRITICAL.

As show in *A simple example* section in
https://docs.python.org/2/howto/logging.html#logging-advanced-tutorial

Does this make sense?
Or I didn't read it properly?

Sincerely,
-Slava
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170315/5c63cace/attachment.html>

From ikomyagin at gmail.com  Thu Mar 16 05:01:54 2017
From: ikomyagin at gmail.com (Igor Komyagin)
Date: Thu, 16 Mar 2017 12:01:54 +0300
Subject: [docs] wrong output in example | 3.6/tutorial/introduction
Message-ID: <CA+u0uE5RAhSf=GHF0f-+tzd+LyLxv3o4stXaJ=CAPLfzXL5tag@mail.gmail.com>

Greetings.
I have found the wrong output on page
https://docs.python.org/3.6/tutorial/introduction.html in the example:


*This only works with two literals though, not with variables or
expressions:*
*>>>*

*>>> prefix = 'Py'
>>> prefix 'thon'  # can't concatenate a variable and a string literal
  ...
SyntaxError: invalid syntax
>>> ('un' * 3) 'ium'
  ... *

*SyntaxError: invalid syntax *

Right output should be:

>>> prefix = 'Py'
>>> prefix 'thon'
  File "<stdin>", line 1
    prefix 'thon'
                ^
SyntaxError: invalid syntax

It looks like a pretty easy fix.
Feel free to contact me for further information.

Best regards, Igor Komyagin
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170316/18c6761f/attachment.html>

From report at bugs.python.org  Thu Mar 16 12:39:13 2017
From: report at bugs.python.org (Marco Buttu)
Date: Thu, 16 Mar 2017 16:39:13 +0000
Subject: [docs] [issue29820] Broken link to "GUI Programming with Python: QT
 Edition" book
In-Reply-To: <1489591760.97.0.349566849467.issue29820@psf.upfronthosting.co.za>
Message-ID: <1489682353.71.0.975327800363.issue29820@psf.upfronthosting.co.za>


Marco Buttu added the comment:

Hi Mariatta, all the other seealso entries (PyGObject, PySide, ...) have references to some specific books and tutorials.  No one has a reference to the wiki, maybe because there is already a reference to it (at the end of the page).  IMHO we can keep the PyQt description consistent with the other GUIs descriptions, and we can fix the broken URL just removing the reference to the outdated book.  What do you think?

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29820>
_______________________________________

From report at bugs.python.org  Thu Mar 16 12:58:21 2017
From: report at bugs.python.org (Steve Barnes)
Date: Thu, 16 Mar 2017 16:58:21 +0000
Subject: [docs] [issue29829] Documentation lacks clear warning of subprocess
 issue with pythonw
Message-ID: <1489683501.47.0.952186876903.issue29829@psf.upfronthosting.co.za>


New submission from Steve Barnes:

When running under pythonw, or pyinstaller with the -w flag, modules that use subprocess calls such as popen, run, etc. will crash if the default `stdout=None, stderr=None` behaviour is used rather than PIPE. This is an obscure problem which is very hard to debug yet there is no warning in the documentation on this.

I would like to suggest adding a :warning:`stdout=None, stderr=None` must not be used in any of the calls in this module when running under pythonw due to the lack of sys.stdout & sys.stderr in that case. Please use `stdout=PIPE, stderr=PIPE` instead.

A patch against the default branch would be:
diff -r 4243df51fe43 Doc/library/subprocess.rst
--- a/Doc/library/subprocess.rst	Fri Feb 10 14:19:36 2017 +0100
+++ b/Doc/library/subprocess.rst	Thu Mar 16 16:56:24 2017 +0000
@@ -33,6 +33,13 @@
 function for all use cases it can handle. For more advanced use cases, the
 underlying :class:`Popen` interface can be used directly.
 
+.. warning:: Do not use default parameters on Windows with pythonw.
+    
+	As pythonw deletes `sys.stdout` & `sys.stderr` the use of the default 
+	parameters, `stdout=None, stderr=None,`, which defaults to being
+	`stdout=sys.stdout, stderr=sys.stderr,` may cause unexpected crashes
+	it is recommended to use `stdout=PIPE, stderr=PIPE,` instead.
+
 The :func:`run` function was added in Python 3.5; if you need to retain
 compatibility with older versions, see the :ref:`call-function-trio` section.

----------
assignee: docs at python
components: Documentation
messages: 289722
nosy: Steve Barnes, docs at python
priority: normal
severity: normal
status: open
title: Documentation lacks clear warning of subprocess issue with pythonw
type: behavior
versions: Python 2.7, Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29829>
_______________________________________

From report at bugs.python.org  Thu Mar 16 13:36:25 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 16 Mar 2017 17:36:25 +0000
Subject: [docs] [issue29820] Broken link to "GUI Programming with Python: QT
 Edition" book
In-Reply-To: <1489591760.97.0.349566849467.issue29820@psf.upfronthosting.co.za>
Message-ID: <1489685785.51.0.294680334262.issue29820@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Thanks, Marco. That sounds good. Let's just remove the reference to the books from both PyQt and wxPython.

----------
keywords: +easy
stage:  -> needs patch

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29820>
_______________________________________

From report at bugs.python.org  Thu Mar 16 15:03:36 2017
From: report at bugs.python.org (R. David Murray)
Date: Thu, 16 Mar 2017 19:03:36 +0000
Subject: [docs] [issue29829] Documentation lacks clear warning of subprocess
 issue with pythonw
In-Reply-To: <1489683501.47.0.952186876903.issue29829@psf.upfronthosting.co.za>
Message-ID: <1489691016.06.0.908655850578.issue29829@psf.upfronthosting.co.za>


R. David Murray added the comment:

A warning is not appropriate (we reserve those for things that are security related, pretty much). A sentence might be, though.  For example, we could change the initial discussion of the run function to say:

   This does not capture stdout or stderr by default. To do so, pass PIPE for the stdout and/or stderr arguments.  You *must* do this if you run your python program with pythonw on windows, since pythonw closes the standard streams.

Here I'm adding the windows sentence to the existing "This does not capture" sentence.

----------
nosy: +r.david.murray

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29829>
_______________________________________

From report at bugs.python.org  Thu Mar 16 16:53:15 2017
From: report at bugs.python.org (Marco Buttu)
Date: Thu, 16 Mar 2017 20:53:15 +0000
Subject: [docs] [issue29820] Broken link to "GUI Programming with Python: QT
 Edition" book
In-Reply-To: <1489591760.97.0.349566849467.issue29820@psf.upfronthosting.co.za>
Message-ID: <1489697595.7.0.433380469887.issue29820@psf.upfronthosting.co.za>


Changes by Marco Buttu <marco.buttu at gmail.com>:


----------
pull_requests: +561

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29820>
_______________________________________

From report at bugs.python.org  Thu Mar 16 22:51:43 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 17 Mar 2017 02:51:43 +0000
Subject: [docs] [issue29820] Broken link to "GUI Programming with Python: QT
 Edition" book
In-Reply-To: <1489591760.97.0.349566849467.issue29820@psf.upfronthosting.co.za>
Message-ID: <1489719103.21.0.95797069526.issue29820@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +562

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29820>
_______________________________________

From report at bugs.python.org  Thu Mar 16 22:51:58 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 17 Mar 2017 02:51:58 +0000
Subject: [docs] [issue29820] Broken link to "GUI Programming with Python: QT
 Edition" book
In-Reply-To: <1489591760.97.0.349566849467.issue29820@psf.upfronthosting.co.za>
Message-ID: <1489719118.07.0.861094287666.issue29820@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +563

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29820>
_______________________________________

From report at bugs.python.org  Thu Mar 16 22:59:08 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 17 Mar 2017 02:59:08 +0000
Subject: [docs] [issue29820] Broken link to "GUI Programming with Python: QT
 Edition" book
In-Reply-To: <1489591760.97.0.349566849467.issue29820@psf.upfronthosting.co.za>
Message-ID: <1489719548.6.0.233552448953.issue29820@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Thanks Marco :) I merged your PR, and backported to 3.5 and 3.6.

There are some merge conflict with the 2.7 branch, so I decided not to bother with it.

----------
resolution:  -> fixed
stage: needs patch -> resolved
status: open -> closed
versions:  -Python 2.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29820>
_______________________________________

From report at bugs.python.org  Thu Mar 16 23:26:43 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Fri, 17 Mar 2017 03:26:43 +0000
Subject: [docs] [issue28415] PyUnicode_FromFormat integer format handling
 different from printf about zeropad
In-Reply-To: <1476176180.11.0.398413685253.issue28415@psf.upfronthosting.co.za>
Message-ID: <1489721203.01.0.884514704509.issue28415@psf.upfronthosting.co.za>


Changes by Xiang Zhang <angwerzx at 126.com>:


----------
keywords: +easy
stage:  -> needs patch

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28415>
_______________________________________

From report at bugs.python.org  Fri Mar 17 00:00:37 2017
From: report at bugs.python.org (Eryk Sun)
Date: Fri, 17 Mar 2017 04:00:37 +0000
Subject: [docs] [issue29829] Documentation lacks clear warning of subprocess
 issue with pythonw
In-Reply-To: <1489683501.47.0.952186876903.issue29829@psf.upfronthosting.co.za>
Message-ID: <1489723236.95.0.727081599792.issue29829@psf.upfronthosting.co.za>


Eryk Sun added the comment:

An exception (not a crash) is possible if a standard handle is invalid and a Popen call tries to replace one or two of the other standard handles (e.g. stdin is invalid and you pass the argument stdout=PIPE). Note that subprocess uses the standard handles directly, so this problem is unrelated to Python's sys.std* streams. IMO, the presence of an invalid handle in the standard handles should not cause Popen to fail. This is an old problem, and it should have been addressed a long time ago by substituting a handle for \\.\NUL.

In Windows 8+ this isn't particular to running pythonw.exe. In older versions such as Windows 7, if you start pythonw.exe from a console application, then the parent's standard handle values are copied to the pythonw.exe child. But these handles are invalid because pythonw.exe doesn't automatically attach to its parent's console. (You have to manually call AttachConsole(-1) or AllocConsole(), but that's complicated because you may need to reset the CRT's standard file descriptors and FILE streams and Pythons sys.std* streams.)

Note that pythonw.exe doesn't delete or close the standard streams. They're normally set to None because, in the default case, the Windows standard handles aren't valid in pythonw.exe, and thus the CRT maps its standard file descriptors (0, 1, and 2) to INVALID_HANDLE_VALUE (i.e. -1 cast as a pointer). For example:

    C:\Temp>pyw -2 -c "import msvcrt; open('test.txt', 'w').write(str(msvcrt.get_osfhandle(1)))"

    C:\Temp>type test.txt
    18446744073709551614

You can override this by starting pythonw.exe with explicit standard handles. For example, the following redirects stderr (2) to stdout (1) and redirects stdout to a pipe:

    C:\>set "script=import sys; print(sys.executable); print(sys.stdout); print(sys.stderr)"

    C:\>2>&1 pyw -2 -c "%script%" | more
    C:\Program Files\Python27\pythonw.exe
    <open file '<stdout>', mode 'w' at 0x00000000021FB0C0>
    <open file '<stderr>', mode 'w' at 0x00000000021FB150>

    C:\>2>&1 pyw -3 -c "%script%" | more
    C:\Program Files\Python36\pythonw.exe
    <_io.TextIOWrapper name='<stdout>' mode='w' encoding='cp1252'>
    <_io.TextIOWrapper name='<stderr>' mode='w' encoding='cp1252'>

----------
components: +Windows
nosy: +eryksun, paul.moore, steve.dower, tim.golden, zach.ware

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29829>
_______________________________________

From report at bugs.python.org  Fri Mar 17 04:55:12 2017
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 17 Mar 2017 08:55:12 +0000
Subject: [docs] [issue16355] inspect.getcomments() does not work in the
 interactive shell
In-Reply-To: <1351511930.82.0.59071323276.issue16355@psf.upfronthosting.co.za>
Message-ID: <1489740912.13.0.480325706613.issue16355@psf.upfronthosting.co.za>


Changes by Berker Peksag <berker.peksag at gmail.com>:


----------
pull_requests: +565

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue16355>
_______________________________________

From report at bugs.python.org  Fri Mar 17 06:33:43 2017
From: report at bugs.python.org (Marco Buttu)
Date: Fri, 17 Mar 2017 10:33:43 +0000
Subject: [docs] [issue16355] inspect.getcomments() does not work in the
 interactive shell
In-Reply-To: <1351511930.82.0.59071323276.issue16355@psf.upfronthosting.co.za>
Message-ID: <1489746823.94.0.0561514104322.issue16355@psf.upfronthosting.co.za>


Changes by Marco Buttu <marco.buttu at gmail.com>:


----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue16355>
_______________________________________

From report at bugs.python.org  Fri Mar 17 07:24:26 2017
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 17 Mar 2017 11:24:26 +0000
Subject: [docs] [issue16355] inspect.getcomments() does not work in the
 interactive shell
In-Reply-To: <1351511930.82.0.59071323276.issue16355@psf.upfronthosting.co.za>
Message-ID: <1489749866.25.0.758604607605.issue16355@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Please don't close an issue while there are still open backport PRs on GitHub.

----------
resolution: fixed -> 
stage: resolved -> 
status: closed -> open

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue16355>
_______________________________________

From report at bugs.python.org  Fri Mar 17 07:37:53 2017
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 17 Mar 2017 11:37:53 +0000
Subject: [docs] [issue16355] inspect.getcomments() does not work in the
 interactive shell
In-Reply-To: <1351511930.82.0.59071323276.issue16355@psf.upfronthosting.co.za>
Message-ID: <1489750673.17.0.630790570582.issue16355@psf.upfronthosting.co.za>


Changes by Berker Peksag <berker.peksag at gmail.com>:


----------
pull_requests: +567

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue16355>
_______________________________________

From report at bugs.python.org  Fri Mar 17 08:01:35 2017
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 17 Mar 2017 12:01:35 +0000
Subject: [docs] [issue16355] inspect.getcomments() does not work in the
 interactive shell
In-Reply-To: <1351511930.82.0.59071323276.issue16355@psf.upfronthosting.co.za>
Message-ID: <1489752095.15.0.305379353687.issue16355@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Now all PRs have been merged:

* master: https://github.com/python/cpython/commit/3f2155ffe683080f2a1b28408fa48d43ba92f943
* 3.6: https://github.com/python/cpython/commit/948171bf999cf8b3e12048851041d2e04ae3a78c
* 3.5: https://github.com/python/cpython/commit/41b4a2189f29daae008e57f799a30890643d191f

Thanks for the patches, Vajrasky and Marco!

----------
resolution:  -> fixed
stage:  -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue16355>
_______________________________________

From report at bugs.python.org  Fri Mar 17 16:05:00 2017
From: report at bugs.python.org (Akira Li)
Date: Fri, 17 Mar 2017 20:05:00 +0000
Subject: [docs] [issue29352] provide the authorative source for s[i:j]
 negative slice indices (<-len(s)) behavior for standard sequences
In-Reply-To: <1485190156.24.0.631194950251.issue29352@psf.upfronthosting.co.za>
Message-ID: <1489781100.28.0.634555909837.issue29352@psf.upfronthosting.co.za>


Akira Li added the comment:

I prefer the wording in the current patch. Though I don't have strong feelings one way or the other as long as the behavior is specified explicitly.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29352>
_______________________________________

From report at bugs.python.org  Fri Mar 17 16:35:38 2017
From: report at bugs.python.org (Akira Li)
Date: Fri, 17 Mar 2017 20:35:38 +0000
Subject: [docs] [issue29352] provide the authorative source for s[i:j]
 negative slice indices (<-len(s)) behavior for standard sequences
In-Reply-To: <1485190156.24.0.631194950251.issue29352@psf.upfronthosting.co.za>
Message-ID: <1489782938.45.0.734471565304.issue29352@psf.upfronthosting.co.za>


Changes by Akira Li <4kir4.1i at gmail.com>:


----------
pull_requests: +576

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29352>
_______________________________________

From report at bugs.python.org  Fri Mar 17 17:00:34 2017
From: report at bugs.python.org (Larry Hastings)
Date: Fri, 17 Mar 2017 21:00:34 +0000
Subject: [docs] [issue28929] Provide a link from documentation back to its
 source file
In-Reply-To: <1481331536.86.0.539237207001.issue28929@psf.upfronthosting.co.za>
Message-ID: <1489784434.17.0.5771054447.issue28929@psf.upfronthosting.co.za>


Changes by Larry Hastings <larry at hastings.org>:


----------
pull_requests: +600

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28929>
_______________________________________

From report at bugs.python.org  Fri Mar 17 17:00:35 2017
From: report at bugs.python.org (Larry Hastings)
Date: Fri, 17 Mar 2017 21:00:35 +0000
Subject: [docs] [issue29576] Improve some deprecations in the importlib
In-Reply-To: <1487208454.1.0.000568467436348.issue29576@psf.upfronthosting.co.za>
Message-ID: <1489784435.94.0.988330530986.issue29576@psf.upfronthosting.co.za>


Changes by Larry Hastings <larry at hastings.org>:


----------
pull_requests: +618

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29576>
_______________________________________

From report at bugs.python.org  Sat Mar 18 07:06:32 2017
From: report at bugs.python.org (Eryk Sun)
Date: Sat, 18 Mar 2017 11:06:32 +0000
Subject: [docs] [issue29844] Windows Python installers not installing DLL to
 System32/SysWOW64
In-Reply-To: <1489831433.22.0.028475249754.issue29844@psf.upfronthosting.co.za>
Message-ID: <1489835192.35.0.985415544254.issue29844@psf.upfronthosting.co.za>


Eryk Sun added the comment:

3.5+ doesn't install files to system directories -- except the py launcher in %SystemRoot%. This was an intentional change, so I'm flagging this as a documentation issue.

----------
assignee:  -> docs at python
components: +Documentation, Windows
keywords: +easy
nosy: +docs at python, eryksun, paul.moore, steve.dower, tim.golden, zach.ware
stage:  -> needs patch
versions: +Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29844>
_______________________________________

From report at bugs.python.org  Sat Mar 18 09:39:06 2017
From: report at bugs.python.org (Ivan Levkivskyi)
Date: Sat, 18 Mar 2017 13:39:06 +0000
Subject: [docs] [issue24796] Deleting names referencing from enclosed and
 enclosing scopes
In-Reply-To: <1438779917.48.0.0299421063838.issue24796@psf.upfronthosting.co.za>
Message-ID: <1489844346.41.0.468987184655.issue24796@psf.upfronthosting.co.za>


Ivan Levkivskyi added the comment:

It looks like it is safe to just remove this line from docs. This code

>>> x = 1
>>> def f():
...     global x
...     del x
... 
>>> f()
>>> x

Works as expected, i.e. raises NameError. (The same happens for nonlocal but with UnboundLocalError.)

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue24796>
_______________________________________

From report at bugs.python.org  Sat Mar 18 10:37:15 2017
From: report at bugs.python.org (Steve Dower)
Date: Sat, 18 Mar 2017 14:37:15 +0000
Subject: [docs] [issue29844] Windows Python installers not installing DLL to
 System32/SysWOW64
In-Reply-To: <1489831433.22.0.028475249754.issue29844@psf.upfronthosting.co.za>
Message-ID: <1489847835.86.0.776764172041.issue29844@psf.upfronthosting.co.za>


Steve Dower added the comment:

I don't even think there's documentation to fix, the install page should say where things are installed.

The system directory is for the system to install files - the Python installer is not a system component, it's a developer kit. For most cases, the install directory was "fixed" rather than broken.

If you have particular needs to install a system-wide python3x.dll, I'd suggest crafting your own install script from the files in a normal install (though putting the install directory on PATH should also enable dependency resolution for most processes).

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29844>
_______________________________________

From report at bugs.python.org  Sun Mar 19 01:19:12 2017
From: report at bugs.python.org (Paul "TBBle" Hampson)
Date: Sun, 19 Mar 2017 05:19:12 +0000
Subject: [docs] [issue29844] Windows Python installers not installing DLL to
 System32/SysWOW64
In-Reply-To: <1489831433.22.0.028475249754.issue29844@psf.upfronthosting.co.za>
Message-ID: <1489900752.88.0.136219078135.issue29844@psf.upfronthosting.co.za>


Paul "TBBle" Hampson added the comment:

If this is just a documentation fix, then there's two places that need it:

* https://github.com/python/cpython/blob/master/Tools/msi/README.txt contains the text I quoted in the original report.

* Some kind of release note (https://docs.python.org/3/whatsnew/3.5.html) so that things that have relied on this behaviour in the past (e.g. gvim with the Python3/dynamic build option) can have all their documentation updated to tell people to... I don't know? Grab the embedded version into the gvim install directory? What _is_ the recommended approach here, to give system-wide-installed applications access to a system-wide-installed Python environment?

==============================================

I don't agree that this change is correct. It's inconsistent with the Linux experience of an all-users installation (i.e. anything on the system can link against libpython2.7.so and get the expected behaviour of using the system-installed Python) and I would also consider an All-Users install to *be* a system component, since the intent is clearly to make it available to all users and applications without further effort.

Unlike putting python.exe in the path, the DLLs are version-named, so you don't suffer the conflict of *which Python* you get. The Python Launcher for Windows has taken care of that nicely, and if I have to add all the Python install directories to my path to ensure the DLLs are visible to applications that link against them, that seems to be a regression in the behaviour that launcher was trying to fix.

An issue I see with the embedded installation approach is that if I want to make modules available to something like gvim's Python environment, then I need to maintain those modules distinctly from the modules I maintain on the system level. It also means I need to be modifying gvim's install directory to add that embedded distribution, and that leaves a whole bunch of manual tracking of installed things I need to worry about.

I have the same concerns (manual tracking of things) if I have to add extra infrastructure to manage a copy of python3.X.dll in System32. Searching Google for this issue suggests that many people are just grabbing a random DLL off the internet named python3.5.dll and putting it in System32 when they encounter this problem, because "it used to work with Python 3.2".

Alternatively... Does it make sense to have a "System Component" installer version of Python for use by other applications that want to offer (optional) Python interpreter support? It would be pretty-much identical to the installer we have now, except putting the DLL entry point (python3.x.dll) into the system path, but not having python.exe in the path to confuse command-line usage.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29844>
_______________________________________

From report at bugs.python.org  Sun Mar 19 02:32:38 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 19 Mar 2017 06:32:38 +0000
Subject: [docs] [issue28749] Fixed the documentation of the mapping codec
 APIs
In-Reply-To: <1479637798.25.0.994184606714.issue28749@psf.upfronthosting.co.za>
Message-ID: <1489905158.79.0.203107712559.issue28749@psf.upfronthosting.co.za>


Changes by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
pull_requests: +634

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28749>
_______________________________________

From report at bugs.python.org  Sun Mar 19 02:37:41 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 19 Mar 2017 06:37:41 +0000
Subject: [docs] [issue28749] Fixed the documentation of the mapping codec
 APIs
In-Reply-To: <1479637798.25.0.994184606714.issue28749@psf.upfronthosting.co.za>
Message-ID: <1489905461.85.0.838673562896.issue28749@psf.upfronthosting.co.za>


Changes by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
pull_requests: +635

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28749>
_______________________________________

From report at bugs.python.org  Sun Mar 19 14:41:09 2017
From: report at bugs.python.org (Steve Dower)
Date: Sun, 19 Mar 2017 18:41:09 +0000
Subject: [docs] [issue29844] Windows Python installers not installing DLL to
 System32/SysWOW64
In-Reply-To: <1489831433.22.0.028475249754.issue29844@psf.upfronthosting.co.za>
Message-ID: <1489948869.52.0.769949968735.issue29844@psf.upfronthosting.co.za>


Steve Dower added the comment:

Maybe I need to look through the history to see whether I actually intended the all-users install to be in System, but I don't think I did (despite writing the documentation linked - it may have been adapted from the old documentation).

Applications that need Python should look in the registry or embed the embeddable distro, depending on whether they are providing access to the user's own Python (e.g. an IDE) or it's an internal implementation detail (e.g. a tool that just happens to be implemented using Python). The former should really offer options for the user to specify a path to the install as well.

Reliably finding the required standard library for a copy of Python that is installed somewhere else is every bit as problematic as locating the install itself. When everyone follows PEP 514 properly it may be safe for a System32-DLL to use the registry again for finding its library, but as long as various distros want to overwrite the core registry keys, everyone is better off without it being a system component.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29844>
_______________________________________

From report at bugs.python.org  Sun Mar 19 14:56:05 2017
From: report at bugs.python.org (Decorater)
Date: Sun, 19 Mar 2017 18:56:05 +0000
Subject: [docs] [issue29844] Windows Python installers not installing DLL to
 System32/SysWOW64
In-Reply-To: <1489831433.22.0.028475249754.issue29844@psf.upfronthosting.co.za>
Message-ID: <1489949765.27.0.624640065507.issue29844@psf.upfronthosting.co.za>


Decorater added the comment:

tbh, I would rather have it default for all python files installed for all users to go in ``%SystemDrive%\Python{major}{minor}`` on windows and then work with then the environment variables like currently so that way none of the python dll's are outside of such folder in case someone installs for example 3.6.0 in ``%SystemDrive%\Python360`` and then installs 3.6.1 in ``%SystemDrive%\Python361`` without uninstalling 3.6.0.

----------
nosy: +Decorater

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29844>
_______________________________________

From report at bugs.python.org  Sun Mar 19 22:52:31 2017
From: report at bugs.python.org (Raphael McSinyx)
Date: Mon, 20 Mar 2017 02:52:31 +0000
Subject: [docs] [issue29856] curses online documentation typo
Message-ID: <1489978351.51.0.185284735277.issue29856@psf.upfronthosting.co.za>


New submission from Raphael McSinyx:

I think there is a typo in curses online documentation about key constants:

https://docs.python.org/3.7/library/curses.html#constants

The key KEY_SEXIT is described as `Shifted Dxit' while I think that should be `Shifted Exit'.

----------
assignee: docs at python
components: Documentation
messages: 289868
nosy: McSinyx, docs at python
priority: normal
severity: normal
status: open
title: curses online documentation typo
versions: Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29856>
_______________________________________

From report at bugs.python.org  Sun Mar 19 23:34:34 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 20 Mar 2017 03:34:34 +0000
Subject: [docs] [issue29856] curses online documentation typo
In-Reply-To: <1489978351.51.0.185284735277.issue29856@psf.upfronthosting.co.za>
Message-ID: <1489980874.1.0.641762480553.issue29856@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +644

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29856>
_______________________________________

From report at bugs.python.org  Sun Mar 19 23:37:56 2017
From: report at bugs.python.org (Jim Fasarakis-Hilliard)
Date: Mon, 20 Mar 2017 03:37:56 +0000
Subject: [docs] [issue29856] curses online documentation typo
In-Reply-To: <1489978351.51.0.185284735277.issue29856@psf.upfronthosting.co.za>
Message-ID: <1489981076.89.0.898026797471.issue29856@psf.upfronthosting.co.za>


Jim Fasarakis-Hilliard added the comment:

Nice catch, that's a typo indeed. If you'd like, submit a PR [see https://docs.python.org/devguide/#quick-start] to address this.

----------
nosy: +Jim Fasarakis-Hilliard

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29856>
_______________________________________

From report at bugs.python.org  Sun Mar 19 23:40:55 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 20 Mar 2017 03:40:55 +0000
Subject: [docs] [issue29856] curses online documentation typo
In-Reply-To: <1489978351.51.0.185284735277.issue29856@psf.upfronthosting.co.za>
Message-ID: <1489981254.88.0.866764657466.issue29856@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Thanks for the report, Raphael.
And thanks Jim, I made a PR just as you commented :)

----------
assignee: docs at python -> Mariatta
nosy: +Mariatta
stage:  -> patch review
versions: +Python 2.7, Python 3.5, Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29856>
_______________________________________

From report at bugs.python.org  Sun Mar 19 23:49:45 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 20 Mar 2017 03:49:45 +0000
Subject: [docs] [issue29856] curses online documentation typo
In-Reply-To: <1489978351.51.0.185284735277.issue29856@psf.upfronthosting.co.za>
Message-ID: <1489981785.04.0.0646796672937.issue29856@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +645

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29856>
_______________________________________

From report at bugs.python.org  Sun Mar 19 23:49:58 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 20 Mar 2017 03:49:58 +0000
Subject: [docs] [issue29856] curses online documentation typo
In-Reply-To: <1489978351.51.0.185284735277.issue29856@psf.upfronthosting.co.za>
Message-ID: <1489981798.44.0.741927187239.issue29856@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +646

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29856>
_______________________________________

From report at bugs.python.org  Sun Mar 19 23:50:14 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 20 Mar 2017 03:50:14 +0000
Subject: [docs] [issue29856] curses online documentation typo
In-Reply-To: <1489978351.51.0.185284735277.issue29856@psf.upfronthosting.co.za>
Message-ID: <1489981814.98.0.664700999974.issue29856@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +647

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29856>
_______________________________________

From report at bugs.python.org  Sun Mar 19 23:59:49 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 20 Mar 2017 03:59:49 +0000
Subject: [docs] [issue29856] curses online documentation typo
In-Reply-To: <1489978351.51.0.185284735277.issue29856@psf.upfronthosting.co.za>
Message-ID: <1489982389.03.0.0466427286869.issue29856@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Typo fixed and backported into 2.7, 3.5 and 3.6.
Thanks :)

----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29856>
_______________________________________

From report at bugs.python.org  Mon Mar 20 06:11:44 2017
From: report at bugs.python.org (Eryk Sun)
Date: Mon, 20 Mar 2017 10:11:44 +0000
Subject: [docs] [issue29844] Windows Python installers not installing DLL to
 System32/SysWOW64
In-Reply-To: <1489831433.22.0.028475249754.issue29844@psf.upfronthosting.co.za>
Message-ID: <1490004704.26.0.0796957854968.issue29844@psf.upfronthosting.co.za>


Eryk Sun added the comment:

> It's inconsistent with the Linux experience of an all-users 
> installation

Yes, if you build with --enable-shared on Linux, then the shared libraries libpython3.X.so.1.0 and libpython3.so are installed in /usr/local/lib. 

Currently there's no direct equivalent for 3.5+ on Windows. However, delay-loading the DLL is an alternative to a static import. At program startup, get the install path from the registry and load python3x.dll manually via LoadLibraryEx with the flag LOAD_WITH_ALTERED_SEARCH_PATH. Delayed loading automates calling GetProcAddress, so you get the flexibility of a dynamic import without losing the convenience of a static import.

> add all the Python install directories to my path to ensure the DLLs 
> are visible to applications that link against them

If the 32-bit DLL were distributed as, for example, python36-32.dll, then this would at least be reliable, albeit tedious. Using System32 and SysWOW64 handles this problem reliably via file-system redirection.

> all users to go in ``%SystemDrive%\Python{major}{minor}``

The change to use %ProgramFiles% for a machine installation and %LocalAppData% for a user installation locks down the discretionary file security. In contrast, the file security inherited from C:\ is permissive. It allows any authenticated user the right to modify the directory, subdirectories, and files. The only rights not granted are delete-child (meaningless since the user has delete access for all files) and the right to modify the file security.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29844>
_______________________________________

From report at bugs.python.org  Mon Mar 20 10:44:46 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 20 Mar 2017 14:44:46 +0000
Subject: [docs] [issue24796] Deleting names referencing from enclosed and
 enclosing scopes
In-Reply-To: <1438779917.48.0.0299421063838.issue24796@psf.upfronthosting.co.za>
Message-ID: <1490021086.81.0.204830620433.issue24796@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
keywords: +easy
stage:  -> needs patch
versions: +Python 3.5, Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue24796>
_______________________________________

From report at bugs.python.org  Mon Mar 20 13:02:00 2017
From: report at bugs.python.org (Jim Fasarakis-Hilliard)
Date: Mon, 20 Mar 2017 17:02:00 +0000
Subject: [docs] [issue14003] __self__ on built-in functions is not as
 documented
In-Reply-To: <1329159935.3.0.264942191971.issue14003@psf.upfronthosting.co.za>
Message-ID: <1490029320.28.0.53234498705.issue14003@psf.upfronthosting.co.za>


Changes by Jim Fasarakis-Hilliard <d.f.hilliard at gmail.com>:


----------
nosy: +Jim Fasarakis-Hilliard

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue14003>
_______________________________________

From report at bugs.python.org  Tue Mar 21 02:25:21 2017
From: report at bugs.python.org (Decorater)
Date: Tue, 21 Mar 2017 06:25:21 +0000
Subject: [docs] [issue29866] Added datetime_diff to datetime.py.
Message-ID: <1490077521.83.0.664563461017.issue29866@psf.upfronthosting.co.za>


New submission from Decorater:

The datetime_diff function compares two datetime objects and returns the time since the prior datetime objects (based on the current datetime object) in a what that is readable by humans.

This is useful when one might need to compare two datetime objects, keeping ones codebase as small as possible (to ensure fast Python code), and to reduce 'hacks' in their code to make the comparison more readable by humans

the github pull request comes with changes to datetime.rst as well

Note: This is currently targeting 3.7, however if you guys desire you guys could backport it into 3.5 and 3.6.

----------
assignee: docs at python
components: Documentation, Library (Lib)
messages: 289917
nosy: Decorater, docs at python
priority: normal
severity: normal
status: open
title: Added datetime_diff to datetime.py.
versions: Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29866>
_______________________________________

From report at bugs.python.org  Tue Mar 21 02:25:36 2017
From: report at bugs.python.org (Decorater)
Date: Tue, 21 Mar 2017 06:25:36 +0000
Subject: [docs] [issue29866] Added datetime_diff to datetime.py.
In-Reply-To: <1490077521.83.0.664563461017.issue29866@psf.upfronthosting.co.za>
Message-ID: <1490077536.9.0.0609132324613.issue29866@psf.upfronthosting.co.za>


Changes by Decorater <seandhunt_7 at yahoo.com>:


----------
pull_requests: +663

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29866>
_______________________________________

From report at bugs.python.org  Tue Mar 21 02:35:04 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 21 Mar 2017 06:35:04 +0000
Subject: [docs] [issue29866] Added datetime_diff to datetime.py.
In-Reply-To: <1490077521.83.0.664563461017.issue29866@psf.upfronthosting.co.za>
Message-ID: <1490078104.29.0.088529642467.issue29866@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

In most cases you needed localized version. And I doubt that it makes much sense to output seconds seconds when the difference is larger than a year. Often you need to use other units for quantizations, e.g. "1 1/4 hours ago" as on this tracker.

This function doesn't look enough general for including in the stdlib.

----------
nosy: +belopolsky, serhiy.storchaka
stage:  -> patch review
type:  -> enhancement

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29866>
_______________________________________

From report at bugs.python.org  Tue Mar 21 02:41:15 2017
From: report at bugs.python.org (Decorater)
Date: Tue, 21 Mar 2017 06:41:15 +0000
Subject: [docs] [issue29866] Added datetime_diff to datetime.py.
In-Reply-To: <1490077521.83.0.664563461017.issue29866@psf.upfronthosting.co.za>
Message-ID: <1490078475.29.0.47431513285.issue29866@psf.upfronthosting.co.za>


Decorater added the comment:

I have people who would use it and there are use cases for it as well. Also it works perfectly fine the other one I added to it's docstring is an example datetime object of my very own discord account from when I created it.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29866>
_______________________________________

From report at bugs.python.org  Tue Mar 21 04:14:55 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 21 Mar 2017 08:14:55 +0000
Subject: [docs] [issue28749] Fixed the documentation of the mapping codec
 APIs
In-Reply-To: <1479637798.25.0.994184606714.issue28749@psf.upfronthosting.co.za>
Message-ID: <1490084095.07.0.23507820378.issue28749@psf.upfronthosting.co.za>


Changes by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28749>
_______________________________________

From report at bugs.python.org  Tue Mar 21 04:50:36 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 21 Mar 2017 08:50:36 +0000
Subject: [docs] [issue29866] Added datetime_diff to datetime.py.
In-Reply-To: <1490077521.83.0.664563461017.issue29866@psf.upfronthosting.co.za>
Message-ID: <1490086236.83.0.910859744561.issue29866@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

In that case you can publish your code as a receipt or as a module on PyPI. If it will be popular enough we can consider including it in the stdlib.

Currently your code is just broken.

>>> datetime.datetime_diff(datetime.datetime(2017, 1, 31), datetime.datetime(2017, 1, 31))
' ago.'
>>> datetime.datetime_diff(datetime.datetime(2016, 12, 31, 23, 59, 59), datetime.datetime(2017, 1, 1))
'1 years ago.'
>>> datetime.datetime_diff(datetime.datetime(2016, 1, 31), datetime.datetime(2017, 1, 31, 1))
'1 years1 hours ago.'

----------
resolution:  -> rejected
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29866>
_______________________________________

From krisbai1991 at gmail.com  Tue Mar 21 04:11:34 2017
From: krisbai1991 at gmail.com (Kris Bai)
Date: Tue, 21 Mar 2017 16:11:34 +0800
Subject: [docs] python-JSON encoder and decoder
Message-ID: <577CEECB-4DEF-4566-839C-A46C8EFAAC5E@gmail.com>


    URL : https://docs.python.org/3.3/library/json.html <https://docs.python.org/3.3/library/json.html>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170321/7cc8062f/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: PastedGraphic-1.png
Type: image/png
Size: 26813 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20170321/7cc8062f/attachment-0001.png>

From report at bugs.python.org  Tue Mar 21 14:13:41 2017
From: report at bugs.python.org (Decorater)
Date: Tue, 21 Mar 2017 18:13:41 +0000
Subject: [docs] [issue29866] Added datetime_diff to datetime.py.
In-Reply-To: <1490077521.83.0.664563461017.issue29866@psf.upfronthosting.co.za>
Message-ID: <1490120021.84.0.0684845022749.issue29866@psf.upfronthosting.co.za>


Decorater added the comment:

Oh, I just realized I forgot to add other if's to each block in case certain parts was 0 but others was not. I also realized I tried to do datetime.datetime.new instead of datetime.datetime.now on the tests.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29866>
_______________________________________

From report at bugs.python.org  Tue Mar 21 14:36:30 2017
From: report at bugs.python.org (Decorater)
Date: Tue, 21 Mar 2017 18:36:30 +0000
Subject: [docs] [issue29866] Added datetime_diff to datetime.py.
In-Reply-To: <1490077521.83.0.664563461017.issue29866@psf.upfronthosting.co.za>
Message-ID: <1490121390.47.0.0541646757253.issue29866@psf.upfronthosting.co.za>


Decorater added the comment:

Alright I revised it a bit locally too

>>> import datetime
>>> datetime.datetime_diff(datetime.datetime(2017, 1, 31), datetime.datetime(2017, 1, 31))
''
>>> datetime.datetime_diff(datetime.datetime(2016, 12, 31, 23, 59, 59), datetime.datetime(2017, 1, 1))
'1 year ago.'
>>> datetime.datetime_diff(datetime.datetime(2016, 1, 31), datetime.datetime(2017, 1, 31, 1))
'1 year, 1 hour ago.'
>>>

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29866>
_______________________________________

From report at bugs.python.org  Tue Mar 21 14:37:27 2017
From: report at bugs.python.org (Decorater)
Date: Tue, 21 Mar 2017 18:37:27 +0000
Subject: [docs] [issue29866] Added datetime_diff to datetime.py.
In-Reply-To: <1490077521.83.0.664563461017.issue29866@psf.upfronthosting.co.za>
Message-ID: <1490121447.94.0.207989028338.issue29866@psf.upfronthosting.co.za>


Decorater added the comment:

I plan to also have it to where if it is the last unit in the thing that it appends an and to the end as well.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29866>
_______________________________________

From report at bugs.python.org  Tue Mar 21 16:41:58 2017
From: report at bugs.python.org (Ivan Levkivskyi)
Date: Tue, 21 Mar 2017 20:41:58 +0000
Subject: [docs] [issue24796] Deleting names referencing from enclosed and
 enclosing scopes
In-Reply-To: <1438779917.48.0.0299421063838.issue24796@psf.upfronthosting.co.za>
Message-ID: <1490128918.36.0.127469606948.issue24796@psf.upfronthosting.co.za>


Changes by Ivan Levkivskyi <levkivskyi at gmail.com>:


----------
pull_requests: +667

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue24796>
_______________________________________

From report at bugs.python.org  Wed Mar 22 07:58:04 2017
From: report at bugs.python.org (INADA Naoki)
Date: Wed, 22 Mar 2017 11:58:04 +0000
Subject: [docs] [issue28331] "CPython implementation detail:" removed when
 content translated
In-Reply-To: <1475328552.4.0.631332821236.issue28331@psf.upfronthosting.co.za>
Message-ID: <1490183884.36.0.412674990309.issue28331@psf.upfronthosting.co.za>


Changes by INADA Naoki <songofacandy at gmail.com>:


----------
pull_requests: +676

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28331>
_______________________________________

From report at bugs.python.org  Wed Mar 22 08:10:05 2017
From: report at bugs.python.org (INADA Naoki)
Date: Wed, 22 Mar 2017 12:10:05 +0000
Subject: [docs] [issue28331] "CPython implementation detail:" removed when
 content translated
In-Reply-To: <1475328552.4.0.631332821236.issue28331@psf.upfronthosting.co.za>
Message-ID: <1490184605.75.0.595560459394.issue28331@psf.upfronthosting.co.za>


Changes by INADA Naoki <songofacandy at gmail.com>:


----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed
versions:  -Python 2.7, Python 3.5

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28331>
_______________________________________

From report at bugs.python.org  Wed Mar 22 10:11:25 2017
From: report at bugs.python.org (=?utf-8?q?Charles_Bouchard-L=C3=A9gar=C3=A9?=)
Date: Wed, 22 Mar 2017 14:11:25 +0000
Subject: [docs] [issue29879] typing.Text not available in python 3.5.1
Message-ID: <1490191885.24.0.466307693119.issue29879@psf.upfronthosting.co.za>


New submission from Charles Bouchard-L?gar?:

The real issue here is that this is not documented in Doc/library/typing.rst.

----------
assignee: docs at python
components: Documentation
messages: 289985
nosy: Charles Bouchard-L?gar?, docs at python
priority: normal
severity: normal
status: open
title: typing.Text not available in python 3.5.1
versions: Python 3.5

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29879>
_______________________________________

From report at bugs.python.org  Wed Mar 22 10:23:47 2017
From: report at bugs.python.org (Jim Fasarakis-Hilliard)
Date: Wed, 22 Mar 2017 14:23:47 +0000
Subject: [docs] [issue29879] typing.Text not available in python 3.5.1
In-Reply-To: <1490191885.24.0.466307693119.issue29879@psf.upfronthosting.co.za>
Message-ID: <1490192627.26.0.145906782706.issue29879@psf.upfronthosting.co.za>


Jim Fasarakis-Hilliard added the comment:

I'm guessing you might of missed it, `Text` is documented in the docs for Python 3.5 https://docs.python.org/3.5/library/typing.html#typing.Text :-)

----------
nosy: +Jim Fasarakis-Hilliard

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29879>
_______________________________________

From report at bugs.python.org  Wed Mar 22 10:25:27 2017
From: report at bugs.python.org (=?utf-8?q?Charles_Bouchard-L=C3=A9gar=C3=A9?=)
Date: Wed, 22 Mar 2017 14:25:27 +0000
Subject: [docs] [issue29879] typing.Text not available in python 3.5.1
In-Reply-To: <1490191885.24.0.466307693119.issue29879@psf.upfronthosting.co.za>
Message-ID: <1490192727.93.0.910195220263.issue29879@psf.upfronthosting.co.za>


Charles Bouchard-L?gar? added the comment:

I mean, what is not documented is 'New in 3.5.2'

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29879>
_______________________________________

From report at bugs.python.org  Wed Mar 22 12:09:09 2017
From: report at bugs.python.org (Jim Fasarakis-Hilliard)
Date: Wed, 22 Mar 2017 16:09:09 +0000
Subject: [docs] [issue29879] typing.Text not available in python 3.5.1
In-Reply-To: <1490191885.24.0.466307693119.issue29879@psf.upfronthosting.co.za>
Message-ID: <1490198949.25.0.573409078012.issue29879@psf.upfronthosting.co.za>


Jim Fasarakis-Hilliard added the comment:

Ah I see now, yes, neither are Reversible, Type, NewType, TYPE_CHECKING and DefaultDict. 

Why don't you go ahead an submit a PR for this? :-)

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29879>
_______________________________________

From report at bugs.python.org  Wed Mar 22 12:15:16 2017
From: report at bugs.python.org (=?utf-8?q?Charles_Bouchard-L=C3=A9gar=C3=A9?=)
Date: Wed, 22 Mar 2017 16:15:16 +0000
Subject: [docs] [issue29879] typing.Text not available in python 3.5.1
In-Reply-To: <1490191885.24.0.466307693119.issue29879@psf.upfronthosting.co.za>
Message-ID: <1490199316.89.0.58321098265.issue29879@psf.upfronthosting.co.za>


Charles Bouchard-L?gar? added the comment:

Thank you for confirming this.  I'll look into it

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29879>
_______________________________________

From report at bugs.python.org  Wed Mar 22 12:18:20 2017
From: report at bugs.python.org (Jim Fasarakis-Hilliard)
Date: Wed, 22 Mar 2017 16:18:20 +0000
Subject: [docs] [issue29866] Added datetime_diff to datetime.py.
In-Reply-To: <1490077521.83.0.664563461017.issue29866@psf.upfronthosting.co.za>
Message-ID: <1490199500.82.0.451577590123.issue29866@psf.upfronthosting.co.za>


Jim Fasarakis-Hilliard added the comment:

Without stating an opinion on the change, I'd suggest first posting to python-ideas (unless you already did so and I missed it :-) to get an initial reaction from folks on your idea before coming to b.p.o.

If you have the backing of python-ideas you might have a good chance of having your change accepted.

----------
nosy: +Jim Fasarakis-Hilliard

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29866>
_______________________________________

From report at bugs.python.org  Wed Mar 22 12:21:25 2017
From: report at bugs.python.org (Jim Fasarakis-Hilliard)
Date: Wed, 22 Mar 2017 16:21:25 +0000
Subject: [docs] [issue29879] typing.Text not available in python 3.5.1
In-Reply-To: <1490191885.24.0.466307693119.issue29879@psf.upfronthosting.co.za>
Message-ID: <1490199685.61.0.315587593061.issue29879@psf.upfronthosting.co.za>


Jim Fasarakis-Hilliard added the comment:

That's great, make sure you also take a look at the quick start section of the devguide [1] if you need help in any steps :-)

[1]: https://docs.python.org/devguide/#quick-start

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29879>
_______________________________________

From report at bugs.python.org  Wed Mar 22 13:53:29 2017
From: report at bugs.python.org (Decorater)
Date: Wed, 22 Mar 2017 17:53:29 +0000
Subject: [docs] [issue29866] Added datetime_diff to datetime.py.
In-Reply-To: <1490077521.83.0.664563461017.issue29866@psf.upfronthosting.co.za>
Message-ID: <1490205209.52.0.882777744113.issue29866@psf.upfronthosting.co.za>


Decorater added the comment:

Yeah, I could. I did just realize that there is a bug in it though that sometimes if it is like 58 seconds into a minute and you sleep for 15 that the code then thinks an entire minute elapsed when it has not. I need to think of a way to bypass that bug first. I found it after running tests many times locally (that actually run this time). Before it even gets accepted even with support from them I would have to fix that bug somehow.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29866>
_______________________________________

From buraphalinuxserver at gmail.com  Tue Mar 21 23:50:16 2017
From: buraphalinuxserver at gmail.com (Somchai Smythe)
Date: Wed, 22 Mar 2017 10:50:16 +0700
Subject: [docs] https://docs.python.org/3/download.html
Message-ID: <CAFJqGkMReXVWVNOPJ4b_OXGLxypYrt3sqAENPdSKasc5gDJH+g@mail.gmail.com>

python-3.6.1 downloadable documentation gets 404s for all .tar.bz2 links

From greyingsit at gmail.com  Wed Mar 22 13:53:04 2017
From: greyingsit at gmail.com (Rajdeep Bhattacharya)
Date: Wed, 22 Mar 2017 23:23:04 +0530
Subject: [docs] Doc Links not working
Message-ID: <CANmhSORut0J6cBSUrSxB14nWHmhuAfG8_r-YDz7OqAuucms7cA@mail.gmail.com>

Hi Team,

None of the docs download link at url
https://docs.python.org/3/download.html is working. Can you please fix this
up.

Thanks,

Rajdeep
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170322/4a42f48e/attachment.html>

From report at bugs.python.org  Wed Mar 22 14:04:40 2017
From: report at bugs.python.org (Decorater)
Date: Wed, 22 Mar 2017 18:04:40 +0000
Subject: [docs] [issue29866] Added datetime_diff to datetime.py.
In-Reply-To: <1490077521.83.0.664563461017.issue29866@psf.upfronthosting.co.za>
Message-ID: <1490205880.58.0.520820224003.issue29866@psf.upfronthosting.co.za>


Decorater added the comment:

an url preview of the bug itself https://travis-ci.org/AraHaan/datetime_diff/jobs/213944228

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29866>
_______________________________________

From report at bugs.python.org  Thu Mar 23 00:06:31 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 23 Mar 2017 04:06:31 +0000
Subject: [docs] [issue24796] Deleting names referencing from enclosed and
 enclosing scopes
In-Reply-To: <1438779917.48.0.0299421063838.issue24796@psf.upfronthosting.co.za>
Message-ID: <1490241991.2.0.661805050466.issue24796@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +680

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue24796>
_______________________________________

From report at bugs.python.org  Thu Mar 23 00:07:12 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 23 Mar 2017 04:07:12 +0000
Subject: [docs] [issue24796] Deleting names referencing from enclosed and
 enclosing scopes
In-Reply-To: <1438779917.48.0.0299421063838.issue24796@psf.upfronthosting.co.za>
Message-ID: <1490242032.61.0.197408548644.issue24796@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +681

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue24796>
_______________________________________

From report at bugs.python.org  Thu Mar 23 00:08:32 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 23 Mar 2017 04:08:32 +0000
Subject: [docs] [issue24796] Deleting names referencing from enclosed and
 enclosing scopes
In-Reply-To: <1438779917.48.0.0299421063838.issue24796@psf.upfronthosting.co.za>
Message-ID: <1490242111.95.0.682804455607.issue24796@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Thanks for the PR, Ivan. Merged and backported to 3.5 and 3.6.

----------
nosy: +Mariatta
resolution:  -> fixed
stage: needs patch -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue24796>
_______________________________________

From tim at bps.nl  Wed Mar 22 17:49:05 2017
From: tim at bps.nl (Tim | BPS International)
Date: Wed, 22 Mar 2017 21:49:05 +0000
Subject: [docs] Documentation download problem
Message-ID: <VI1PR0802MB25417DA9C49FF5706016DE5BC73C0@VI1PR0802MB2541.eurprd08.prod.outlook.com>

Dear Python team,

I get a 404 error when I try to download the Python 3.6.1 documentation from https://docs.python.org/3/download.html . All of the download links seem to be broken as nginx is returning a 404 error. The reason why I?m sending this mail to docs at python.org<mailto:docs at python.org> is because I saw a header called ?Problems? on the documentation page, and I think not being able to download the documentation is a problem. ?

Thanks in advance for looking into this issue and possibly fixing it!


Best regards,

Tim van de Kerkhof
Sales engineer

[cid:image002.png at 01D269A2.45D6D010]<http://www.facebook.com/BPSBV>[cid:image003.png at 01D269A2.45D6D010]<http://twitter.com/bps_bv>


[cid:image004.png at 01D269A2.45D6D010]

BPS International B.V.
Eerselsedijk 43 | 5571 TM Bergeijk
T +31 (0)497-550260 | F +31 (0)497-550261 | www.bps.nl<http://www.bps.nl/>
 tim at bps.nl<mailto:tim at bps.nl>

[cid:image005.png at 01D269A2.45D6D010]


Over BPS International:
BPS International is specialist in digitale spraak- en scherm opname en garandeert vlekkeloze integratie met elk telefonie platform van traditionele PABX tot VoIP. Gedegen advies, een breed assortiment aan gespreks- en schermopname-apparatuur en betrouwbare ondersteuning zijn de uitgangspunten
The information contained in this message is confidential and may be legally privileged. The message is intended solely for the addressee(s). If you are not the intended recipient, you are hereby notified that any use, dissemination, or reproduction is strictly prohibited and may be unlawful. If you are not the intended recipient, please contact the sender by return e-mail and destroy all copies of the original message.



-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170322/0e8fa87c/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image001.png
Type: image/png
Size: 2563 bytes
Desc: image001.png
URL: <http://mail.python.org/pipermail/docs/attachments/20170322/0e8fa87c/attachment-0004.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image002.png
Type: image/png
Size: 2828 bytes
Desc: image002.png
URL: <http://mail.python.org/pipermail/docs/attachments/20170322/0e8fa87c/attachment-0005.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image003.png
Type: image/png
Size: 324 bytes
Desc: image003.png
URL: <http://mail.python.org/pipermail/docs/attachments/20170322/0e8fa87c/attachment-0006.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image004.png
Type: image/png
Size: 3787 bytes
Desc: image004.png
URL: <http://mail.python.org/pipermail/docs/attachments/20170322/0e8fa87c/attachment-0007.png>

From report at bugs.python.org  Thu Mar 23 09:55:19 2017
From: report at bugs.python.org (=?utf-8?q?Charles_Bouchard-L=C3=A9gar=C3=A9?=)
Date: Thu, 23 Mar 2017 13:55:19 +0000
Subject: [docs] [issue29879] typing.Text not available in python 3.5.1
In-Reply-To: <1490191885.24.0.466307693119.issue29879@psf.upfronthosting.co.za>
Message-ID: <1490277319.34.0.209980982414.issue29879@psf.upfronthosting.co.za>


Changes by Charles Bouchard-L?gar? <cblegare.atl at ntis.ca>:


----------
pull_requests: +688

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29879>
_______________________________________

From report at bugs.python.org  Thu Mar 23 11:14:44 2017
From: report at bugs.python.org (chrysn)
Date: Thu, 23 Mar 2017 15:14:44 +0000
Subject: [docs] [issue29886] links between binascii.{un, }hexlify / bytes.{,
 to}hex
Message-ID: <1490282084.27.0.505150099985.issue29886@psf.upfronthosting.co.za>


New submission from chrysn:

The function binascii.{un,}hexlify and bytes.{,to}hex do almost the same things (plus/minus details of whether they accept whitespace, and whether the hex-encoded data is accepted/returned as strings or bytes).

I think that it would help users to point that out in the documentation, eg. by adding a "Similar functionality is provided by the ... function." lines at the ends of the functions' documentations.

----------
assignee: docs at python
components: Documentation
messages: 290050
nosy: chrysn, docs at python
priority: normal
severity: normal
status: open
title: links between binascii.{un,}hexlify / bytes.{,to}hex
type: enhancement
versions: Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29886>
_______________________________________

From report at bugs.python.org  Thu Mar 23 12:20:35 2017
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 23 Mar 2017 16:20:35 +0000
Subject: [docs] [issue29886] links between binascii.{un, }hexlify / bytes.{,
 to}hex
In-Reply-To: <1490282084.27.0.505150099985.issue29886@psf.upfronthosting.co.za>
Message-ID: <1490286035.45.0.625502414687.issue29886@psf.upfronthosting.co.za>


Changes by Roundup Robot <devnull at psf.upfronthosting.co.za>:


----------
pull_requests: +689

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29886>
_______________________________________

From report at bugs.python.org  Thu Mar 23 14:04:23 2017
From: report at bugs.python.org (Kinebuchi Tomohiko)
Date: Thu, 23 Mar 2017 18:04:23 +0000
Subject: [docs] [issue29888] The link referring to "Python download page" is
 broken
Message-ID: <1490292263.44.0.884300917971.issue29888@psf.upfronthosting.co.za>


New submission from Kinebuchi Tomohiko:

The download page [1]_ contains a link intended to refer to the release page of the corresponding Python version [2]_.

.. [1] `Download Python 2.7.13 Documentation <https://docs.python.org/2.7/download.html>`_

.. [2] e.g. `Python 2.7.8 Release <https://www.python.org/download/releases/2.7.8/>`_

Although, this link is broken for three reasons.

1. Wrong template syntax

   `Present code <https://github.com/python/cpython/blob/2.7/Doc/tools/templates/download.html#L78-L80>`_::

      <p>{% trans download_page="https://www.python.org/download/releases/{{ release[:5] }}/" %}HTML Help
      (<tt>.chm</tt>) files are made available in the "Windows" section
      on the <a href={{ download_page }}>Python download page</a>.{% endtrans %}</p>

   Fixed code::

      <p>{% trans download_page="https://www.python.org/download/releases/" + release[:5] + "/" %}HTML Help
      (<tt>.chm</tt>) files are made available in the "Windows" section
      on the <a href="{{ download_page }}">Python download page</a>.{% endtrans %}</p>

2. Unexpected version number

   The URL contains a Python version string (i.e. ``release[:5]``), but for Python 2.7.13, ``release[:5]`` evaluates to ``'2.7.1'`` which obviously wrong as a version string.

3. Non-existent release pages for some versions

   www.python.org has pages which URLs are https://www.python.org/download/releases/<version>/ with <version> = 2.7.1--8, although has no pages with <version> = 2.7.9 and so on.

   Is https://www.python.org/downloads/release/python-2713/ an appropriate page to refer?

----------
assignee: docs at python
components: Documentation
messages: 290057
nosy: cocoatomo, docs at python
priority: normal
severity: normal
status: open
title: The link referring to "Python download page" is broken
versions: Python 2.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29888>
_______________________________________

From report at bugs.python.org  Thu Mar 23 19:46:18 2017
From: report at bugs.python.org (OSAMU NAKAMURA)
Date: Thu, 23 Mar 2017 23:46:18 +0000
Subject: [docs] [issue29892] change statement for open() is splited into two
 part in middle of sentence.
Message-ID: <1490312778.71.0.779732227064.issue29892@psf.upfronthosting.co.za>


New submission from OSAMU NAKAMURA:

In https://docs.python.org/3.6/library/functions.html#open , 
Following sentence is wrongly separated by extra asterisk.

```
FileExistsError is now raised if the file opened in exclusive
creation mode ('x') already exists.
```

This mistake is introduced by https://github.com/python/cpython/commit/3929499914d47365ae744df312e16da8955c90ac#diff-30d76a3dc0c885f86917b7d307ccf279

----------
assignee: docs at python
components: Documentation
messages: 290070
nosy: OSAMU.NAKAMURA, docs at python
priority: normal
severity: normal
status: open
title: change statement for open() is splited into two part in middle of sentence.
versions: Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29892>
_______________________________________

From report at bugs.python.org  Thu Mar 23 20:16:52 2017
From: report at bugs.python.org (Jim Fasarakis-Hilliard)
Date: Fri, 24 Mar 2017 00:16:52 +0000
Subject: [docs] [issue29892] change statement for open() is splited into two
 part in middle of sentence.
In-Reply-To: <1490312778.71.0.779732227064.issue29892@psf.upfronthosting.co.za>
Message-ID: <1490314612.74.0.780490684673.issue29892@psf.upfronthosting.co.za>


Jim Fasarakis-Hilliard added the comment:

Indeed, nice catch! Submit a PR for it if you want to (if not, someone else will pick it up soon :-)

----------
nosy: +Jim Fasarakis-Hilliard

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29892>
_______________________________________

From report at bugs.python.org  Fri Mar 24 10:24:13 2017
From: report at bugs.python.org (OSAMU NAKAMURA)
Date: Fri, 24 Mar 2017 14:24:13 +0000
Subject: [docs] [issue29892] change statement for open() is splited into two
 part in middle of sentence.
In-Reply-To: <1490312778.71.0.779732227064.issue29892@psf.upfronthosting.co.za>
Message-ID: <1490365453.91.0.185629388772.issue29892@psf.upfronthosting.co.za>


Changes by OSAMU NAKAMURA <osamu0329nakamura at gmail.com>:


----------
pull_requests: +707

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29892>
_______________________________________

From report at bugs.python.org  Fri Mar 24 12:26:23 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 16:26:23 +0000
Subject: [docs] [issue29892] change statement for open() is splited into two
 part in middle of sentence.
In-Reply-To: <1490312778.71.0.779732227064.issue29892@psf.upfronthosting.co.za>
Message-ID: <1490372783.64.0.814901609462.issue29892@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
stage:  -> patch review
versions: +Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29892>
_______________________________________

From report at bugs.python.org  Fri Mar 24 12:29:59 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 24 Mar 2017 16:29:59 +0000
Subject: [docs] [issue18713] Clearly document the use of PYTHONIOENCODING to
 set surrogateescape
In-Reply-To: <1376320774.07.0.703505392881.issue18713@psf.upfronthosting.co.za>
Message-ID: <1490372999.69.0.845280930157.issue18713@psf.upfronthosting.co.za>


Changes by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
resolution:  -> duplicate
status: open -> pending
superseder:  -> The documentation for the print function should explain/point to how to control the sys.stdout encoding

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue18713>
_______________________________________

From report at bugs.python.org  Fri Mar 24 12:34:11 2017
From: report at bugs.python.org (INADA Naoki)
Date: Fri, 24 Mar 2017 16:34:11 +0000
Subject: [docs] [issue28331] "CPython implementation detail:" removed when
 content translated
In-Reply-To: <1475328552.4.0.631332821236.issue28331@psf.upfronthosting.co.za>
Message-ID: <1490373250.73.0.770471125168.issue28331@psf.upfronthosting.co.za>


INADA Naoki added the comment:


New changeset 906118d8c68160ed4a3d15cec803d1ee57836517 by INADA Naoki in branch '3.6':
bpo-28331: fix impl-detail label is removed when content is translated. (GH-769)
https://github.com/python/cpython/commit/906118d8c68160ed4a3d15cec803d1ee57836517


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28331>
_______________________________________

From report at bugs.python.org  Fri Mar 24 14:17:04 2017
From: report at bugs.python.org (Kinebuchi Tomohiko)
Date: Fri, 24 Mar 2017 18:17:04 +0000
Subject: [docs] [issue29888] The link referring to "Python download page" is
 broken
In-Reply-To: <1490292263.44.0.884300917971.issue29888@psf.upfronthosting.co.za>
Message-ID: <1490379424.36.0.371230639875.issue29888@psf.upfronthosting.co.za>


Kinebuchi Tomohiko added the comment:

According to the table on the Downloads page [1]_, relations between Python versions and version specific release pages are listed as follows:

   2.7.0  -> https://www.python.org/download/releases/2.7/
   2.7.1  -> https://www.python.org/download/releases/2.7.1/
   2.7.2  -> https://www.python.org/download/releases/2.7.2/
   2.7.3  -> https://www.python.org/download/releases/2.7.3/
   2.7.4  -> https://www.python.org/download/releases/2.7.4/
   2.7.5  -> https://www.python.org/download/releases/2.7.5/
   2.7.6  -> https://www.python.org/download/releases/2.7.6/
   2.7.7  -> https://www.python.org/download/releases/2.7.7/
   2.7.8  -> https://www.python.org/downloads/release/python-278/
   2.7.9  -> https://www.python.org/downloads/release/python-279/
   2.7.10 -> https://www.python.org/downloads/release/python-2710/
   2.7.11 -> https://www.python.org/downloads/release/python-2711/
   2.7.12 -> https://www.python.org/downloads/release/python-2712/
   2.7.13 -> https://www.python.org/downloads/release/python-2713/

   3.0.0  -> https://www.python.org/download/releases/3.0/
   3.0.1  -> https://www.python.org/download/releases/3.0.1/

   3.1.0  -> https://www.python.org/download/releases/3.1/
   3.1.1  -> https://www.python.org/download/releases/3.1.1/
   3.1.2  -> https://www.python.org/download/releases/3.1.2/
   3.1.3  -> https://www.python.org/download/releases/3.1.3/
   3.1.4  -> https://www.python.org/download/releases/3.1.4/
   3.1.5  -> https://www.python.org/downloads/release/python-315/

   3.2.0  -> https://www.python.org/download/releases/3.2/
   3.2.1  -> https://www.python.org/download/releases/3.2.1/
   3.2.2  -> https://www.python.org/download/releases/3.2.2/
   3.2.3  -> https://www.python.org/download/releases/3.2.3/
   3.2.4  -> https://www.python.org/download/releases/3.2.4/
   3.2.5  -> https://www.python.org/download/releases/3.2.5/
   3.2.6  -> https://www.python.org/downloads/release/python-326/

   3.3.0  -> https://www.python.org/download/releases/3.3.0/
   3.3.1  -> https://www.python.org/download/releases/3.3.1/
   3.3.2  -> https://www.python.org/download/releases/3.3.2/
   3.3.3  -> https://www.python.org/download/releases/3.3.3/
   3.3.4  -> https://www.python.org/download/releases/3.3.4/
   3.3.5  -> https://www.python.org/download/releases/3.3.5/
   3.3.6  -> https://www.python.org/downloads/release/python-336/

   3.4.0  -> https://www.python.org/download/releases/3.4.0/
   3.4.1  -> https://www.python.org/downloads/release/python-341/
   3.4.2  -> https://www.python.org/downloads/release/python-342/
   3.4.3  -> https://www.python.org/downloads/release/python-343/
   3.4.4  -> https://www.python.org/downloads/release/python-344/
   3.4.5  -> https://www.python.org/downloads/release/python-345/
   3.4.6  -> https://www.python.org/downloads/release/python-346/

   3.5.0  -> https://www.python.org/downloads/release/python-350/
   3.5.1  -> https://www.python.org/downloads/release/python-351/
   3.5.2  -> https://www.python.org/downloads/release/python-352/
   3.5.3  -> https://www.python.org/downloads/release/python-353/

   3.6.0  -> https://www.python.org/downloads/release/python-360/
   3.6.1  -> https://www.python.org/downloads/release/python-361/


.. [1] https://www.python.org/downloads/

I will create a pull request for Python 2.7, 3.5 and 3.6.

----------
versions: +Python 3.5, Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29888>
_______________________________________

From report at bugs.python.org  Fri Mar 24 14:33:26 2017
From: report at bugs.python.org (Ned Deily)
Date: Fri, 24 Mar 2017 18:33:26 +0000
Subject: [docs] [issue29888] The link referring to "Python download page" is
 broken
In-Reply-To: <1490292263.44.0.884300917971.issue29888@psf.upfronthosting.co.za>
Message-ID: <1490380406.71.0.551105839937.issue29888@psf.upfronthosting.co.za>


Ned Deily added the comment:

Thanks for noticing this.  The change in URLs was due to the introduction of the "new" python.org website a few years ago;  the canonical form of the URL for releases introduced after the move to the new web site is indeed  https://www.python.org/downloads/release/python-xyz/ so that should be the URL form used for current and future releases.  Another approach would be to add aliases on the web site to redirect from /releases/x.y.z to /release/python-xyz/ but, at this point, I don't think that's necessary.  A PR to fix the generated docs would be great.

----------
nosy: +ned.deily

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29888>
_______________________________________

From report at bugs.python.org  Fri Mar 24 14:38:31 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 18:38:31 +0000
Subject: [docs] [issue29892] change statement for open() is splited into two
 part in middle of sentence.
In-Reply-To: <1490312778.71.0.779732227064.issue29892@psf.upfronthosting.co.za>
Message-ID: <1490380711.67.0.641814829053.issue29892@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
assignee: docs at python -> Mariatta
nosy: +Mariatta

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29892>
_______________________________________

From report at bugs.python.org  Fri Mar 24 16:18:51 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 20:18:51 +0000
Subject: [docs] [issue29856] curses online documentation typo
In-Reply-To: <1489978351.51.0.185284735277.issue29856@psf.upfronthosting.co.za>
Message-ID: <1490386731.63.0.633150493806.issue29856@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 7cc071c96b95e7422f64cb436d547c952e0ca52f by Mariatta in branch '3.5':
bpo-29856: Fix typo in curses documentation (GH-730) (GH-732)
https://github.com/python/cpython/commit/7cc071c96b95e7422f64cb436d547c952e0ca52f


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29856>
_______________________________________

From report at bugs.python.org  Fri Mar 24 16:18:58 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 20:18:58 +0000
Subject: [docs] [issue29856] curses online documentation typo
In-Reply-To: <1489978351.51.0.185284735277.issue29856@psf.upfronthosting.co.za>
Message-ID: <1490386738.09.0.075655617221.issue29856@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 91f79db02acb9f82c738bb0b2f7bfc3260b90930 by Mariatta in branch '2.7':
bpo-29856: Fix typo in curses documentation (GH-730) (GH-733)
https://github.com/python/cpython/commit/91f79db02acb9f82c738bb0b2f7bfc3260b90930


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29856>
_______________________________________

From report at bugs.python.org  Fri Mar 24 16:19:04 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 20:19:04 +0000
Subject: [docs] [issue29856] curses online documentation typo
In-Reply-To: <1489978351.51.0.185284735277.issue29856@psf.upfronthosting.co.za>
Message-ID: <1490386744.75.0.949522415316.issue29856@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset d1f566f6bddc67e9870eaa75ae477208b9a199be by Mariatta in branch '3.6':
bpo-29856: Fix typo in curses documentation (GH-730) (GH-731)
https://github.com/python/cpython/commit/d1f566f6bddc67e9870eaa75ae477208b9a199be


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29856>
_______________________________________

From report at bugs.python.org  Fri Mar 24 16:19:12 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 20:19:12 +0000
Subject: [docs] [issue29856] curses online documentation typo
In-Reply-To: <1489978351.51.0.185284735277.issue29856@psf.upfronthosting.co.za>
Message-ID: <1490386752.32.0.473183626195.issue29856@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 64508780d72769e4c7afc67a511c057261c578f6 by Mariatta in branch 'master':
bpo-29856: Fix typo in curses documentation (GH-730)
https://github.com/python/cpython/commit/64508780d72769e4c7afc67a511c057261c578f6


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29856>
_______________________________________

From report at bugs.python.org  Fri Mar 24 17:05:06 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 24 Mar 2017 21:05:06 +0000
Subject: [docs] [issue28810] Document bytecode changes in 3.6
In-Reply-To: <1480184644.53.0.660721117392.issue28810@psf.upfronthosting.co.za>
Message-ID: <1490389506.48.0.564153087454.issue28810@psf.upfronthosting.co.za>


Brett Cannon added the comment:


New changeset 8f9e1bbf2dbdf46a0bf920279568a31460043376 by Brett Cannon (Ivan Levkivskyi) in branch 'master':
bpo-28810: Document remaining bytecode changes in 3.6 (GH-651)
https://github.com/python/cpython/commit/8f9e1bbf2dbdf46a0bf920279568a31460043376


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28810>
_______________________________________

From report at bugs.python.org  Fri Mar 24 17:06:17 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 24 Mar 2017 21:06:17 +0000
Subject: [docs] [issue28810] Document bytecode changes in 3.6
In-Reply-To: <1480184644.53.0.660721117392.issue28810@psf.upfronthosting.co.za>
Message-ID: <1490389577.24.0.958742658725.issue28810@psf.upfronthosting.co.za>


Changes by Brett Cannon <brett at python.org>:


----------
pull_requests: +713

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28810>
_______________________________________

From report at bugs.python.org  Fri Mar 24 17:18:56 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 24 Mar 2017 21:18:56 +0000
Subject: [docs] [issue28810] Document bytecode changes in 3.6
In-Reply-To: <1480184644.53.0.660721117392.issue28810@psf.upfronthosting.co.za>
Message-ID: <1490390336.1.0.871985903284.issue28810@psf.upfronthosting.co.za>


Brett Cannon added the comment:


New changeset 74bfcc314b188e1e8c90e442270e36d6510755ee by Brett Cannon in branch '3.6':
bpo-28810: Document remaining bytecode changes in 3.6 (GH-651) (GH-808)
https://github.com/python/cpython/commit/74bfcc314b188e1e8c90e442270e36d6510755ee


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28810>
_______________________________________

From report at bugs.python.org  Fri Mar 24 17:19:30 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 24 Mar 2017 21:19:30 +0000
Subject: [docs] [issue28810] Document bytecode changes in 3.6
In-Reply-To: <1480184644.53.0.660721117392.issue28810@psf.upfronthosting.co.za>
Message-ID: <1490390370.85.0.392618101904.issue28810@psf.upfronthosting.co.za>


Brett Cannon added the comment:

Is there anything left to do for this Ivan?

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28810>
_______________________________________

From report at bugs.python.org  Fri Mar 24 17:32:35 2017
From: report at bugs.python.org (Ivan Levkivskyi)
Date: Fri, 24 Mar 2017 21:32:35 +0000
Subject: [docs] [issue28810] Document bytecode changes in 3.6
In-Reply-To: <1480184644.53.0.660721117392.issue28810@psf.upfronthosting.co.za>
Message-ID: <1490391155.35.0.548085927827.issue28810@psf.upfronthosting.co.za>


Ivan Levkivskyi added the comment:

Thanks Brett!

I think this could be closed now.

----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28810>
_______________________________________

From report at bugs.python.org  Fri Mar 24 18:06:17 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 24 Mar 2017 22:06:17 +0000
Subject: [docs] [issue28749] Fixed the documentation of the mapping codec
 APIs
In-Reply-To: <1479637798.25.0.994184606714.issue28749@psf.upfronthosting.co.za>
Message-ID: <1490393177.77.0.0898044098095.issue28749@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:


New changeset 88b32eb7b317dd7c7943433f980e17e34e50f8f8 by Serhiy Storchaka in branch '3.5':
bpo-28749: Fixed the documentation of the mapping codec APIs. (#487) (#715)
https://github.com/python/cpython/commit/88b32eb7b317dd7c7943433f980e17e34e50f8f8


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28749>
_______________________________________

From report at bugs.python.org  Fri Mar 24 18:06:26 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 24 Mar 2017 22:06:26 +0000
Subject: [docs] [issue28749] Fixed the documentation of the mapping codec
 APIs
In-Reply-To: <1479637798.25.0.994184606714.issue28749@psf.upfronthosting.co.za>
Message-ID: <1490393186.3.0.981465689929.issue28749@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:


New changeset 69eab3123ed1de4bed4b7dedecabe415f6139bb6 by Serhiy Storchaka in branch '3.6':
bpo-28749: Fixed the documentation of the mapping codec APIs. (#487) (#714)
https://github.com/python/cpython/commit/69eab3123ed1de4bed4b7dedecabe415f6139bb6


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28749>
_______________________________________

From report at bugs.python.org  Fri Mar 24 18:09:27 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 24 Mar 2017 22:09:27 +0000
Subject: [docs] [issue28749] Fixed the documentation of the mapping codec
 APIs
In-Reply-To: <1479637798.25.0.994184606714.issue28749@psf.upfronthosting.co.za>
Message-ID: <1490393367.01.0.866439254004.issue28749@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:


New changeset c85a26628ceb9624c96c3064e8b99033c026d8a3 by Serhiy Storchaka in branch 'master':
bpo-28749: Fixed the documentation of the mapping codec APIs. (#487)
https://github.com/python/cpython/commit/c85a26628ceb9624c96c3064e8b99033c026d8a3


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28749>
_______________________________________

From report at bugs.python.org  Fri Mar 24 18:14:12 2017
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 24 Mar 2017 22:14:12 +0000
Subject: [docs] [issue16355] inspect.getcomments() does not work in the
 interactive shell
In-Reply-To: <1351511930.82.0.59071323276.issue16355@psf.upfronthosting.co.za>
Message-ID: <1490393652.35.0.40681780817.issue16355@psf.upfronthosting.co.za>


Berker Peksag added the comment:


New changeset 948171bf999cf8b3e12048851041d2e04ae3a78c by Berker Peksag in branch '3.6':
bpo-16355: Clarify when inspect.getcomments() returns None (#428) (#690)
https://github.com/python/cpython/commit/948171bf999cf8b3e12048851041d2e04ae3a78c


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue16355>
_______________________________________

From report at bugs.python.org  Fri Mar 24 18:14:19 2017
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 24 Mar 2017 22:14:19 +0000
Subject: [docs] [issue16355] inspect.getcomments() does not work in the
 interactive shell
In-Reply-To: <1351511930.82.0.59071323276.issue16355@psf.upfronthosting.co.za>
Message-ID: <1490393659.72.0.0580468346466.issue16355@psf.upfronthosting.co.za>


Berker Peksag added the comment:


New changeset 41b4a2189f29daae008e57f799a30890643d191f by Berker Peksag in branch '3.5':
bpo-16355: Clarify when inspect.getcomments() returns None (#428) (#691)
https://github.com/python/cpython/commit/41b4a2189f29daae008e57f799a30890643d191f


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue16355>
_______________________________________

From report at bugs.python.org  Fri Mar 24 18:15:43 2017
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 24 Mar 2017 22:15:43 +0000
Subject: [docs] [issue16355] inspect.getcomments() does not work in the
 interactive shell
In-Reply-To: <1351511930.82.0.59071323276.issue16355@psf.upfronthosting.co.za>
Message-ID: <1490393743.1.0.0618324437986.issue16355@psf.upfronthosting.co.za>


Berker Peksag added the comment:


New changeset 3f2155ffe683080f2a1b28408fa48d43ba92f943 by Berker Peksag (Marco Buttu) in branch 'master':
bpo-16355: Clarify when inspect.getcomments() returns None  (#428)
https://github.com/python/cpython/commit/3f2155ffe683080f2a1b28408fa48d43ba92f943


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue16355>
_______________________________________

From report at bugs.python.org  Fri Mar 24 18:17:55 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 22:17:55 +0000
Subject: [docs] [issue29820] Broken link to "GUI Programming with Python: QT
 Edition" book
In-Reply-To: <1489591760.97.0.349566849467.issue29820@psf.upfronthosting.co.za>
Message-ID: <1490393875.24.0.558945599109.issue29820@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 3fce38c540681a736b7e5ca7611758f7bc159c9e by Mariatta in branch '3.6':
bpo-29820: othergui.rst: Remove outdated information  (GH-685) (GH-688)
https://github.com/python/cpython/commit/3fce38c540681a736b7e5ca7611758f7bc159c9e


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29820>
_______________________________________

From report at bugs.python.org  Fri Mar 24 18:18:00 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 22:18:00 +0000
Subject: [docs] [issue29820] Broken link to "GUI Programming with Python: QT
 Edition" book
In-Reply-To: <1489591760.97.0.349566849467.issue29820@psf.upfronthosting.co.za>
Message-ID: <1490393880.7.0.812080781873.issue29820@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 091d90f9a429b81b046cb83582062941f8ded9da by Mariatta in branch '3.5':
bpo-29820: othergui.rst: Remove outdated information  (GH-685) (GH-689)
https://github.com/python/cpython/commit/091d90f9a429b81b046cb83582062941f8ded9da


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29820>
_______________________________________

From report at bugs.python.org  Fri Mar 24 18:18:08 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 22:18:08 +0000
Subject: [docs] [issue29820] Broken link to "GUI Programming with Python: QT
 Edition" book
In-Reply-To: <1489591760.97.0.349566849467.issue29820@psf.upfronthosting.co.za>
Message-ID: <1490393888.78.0.56888411982.issue29820@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 1bb0f3762ec5104014aeed0ae6e9d64598d8fcac by Mariatta (Marco Buttu) in branch 'master':
bpo-29820: othergui.rst: Remove outdated information  (GH-685)
https://github.com/python/cpython/commit/1bb0f3762ec5104014aeed0ae6e9d64598d8fcac


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29820>
_______________________________________

From report at bugs.python.org  Fri Mar 24 18:19:36 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 24 Mar 2017 22:19:36 +0000
Subject: [docs] [issue28810] Document bytecode changes in 3.6
In-Reply-To: <1480184644.53.0.660721117392.issue28810@psf.upfronthosting.co.za>
Message-ID: <1490393976.68.0.933742973979.issue28810@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:


New changeset 9135275cba680902e6caf29461f0423dc570190d by Serhiy Storchaka (Ivan Levkivskyi) in branch 'master':
bpo-28810: Update lnotab_notes.txt (#665)
https://github.com/python/cpython/commit/9135275cba680902e6caf29461f0423dc570190d


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28810>
_______________________________________

From report at bugs.python.org  Fri Mar 24 18:20:59 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Fri, 24 Mar 2017 22:20:59 +0000
Subject: [docs] [issue29756] Improve documentation for list methods that
 compare items by equality
In-Reply-To: <1488981833.28.0.455455965624.issue29756@psf.upfronthosting.co.za>
Message-ID: <1490394058.99.0.655887872355.issue29756@psf.upfronthosting.co.za>


Xiang Zhang added the comment:


New changeset b2d77175d1317494b4238b4e07426d310fbf1d19 by Xiang Zhang in branch 'master':
bpo-29756: Improve documentation for list methods that compare items by equality (GH-572)
https://github.com/python/cpython/commit/b2d77175d1317494b4238b4e07426d310fbf1d19


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29756>
_______________________________________

From report at bugs.python.org  Fri Mar 24 18:25:35 2017
From: report at bugs.python.org (Torrin Jones)
Date: Fri, 24 Mar 2017 22:25:35 +0000
Subject: [docs] [issue29893] create_subprocess_exec doc doesn't match
 software
In-Reply-To: <1490332817.83.0.92510042207.issue29893@psf.upfronthosting.co.za>
Message-ID: <1490394335.14.0.553853084032.issue29893@psf.upfronthosting.co.za>


Changes by Torrin Jones <torrinj at gmail.com>:


----------
assignee:  -> docs at python
components: +Documentation
nosy: +docs at python
type:  -> behavior

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29893>
_______________________________________

From report at bugs.python.org  Fri Mar 24 18:27:26 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Fri, 24 Mar 2017 22:27:26 +0000
Subject: [docs] [issue29770] Executable help output (--help) at commandline
 is wrong for option -B
In-Reply-To: <1489063792.65.0.00439171993212.issue29770@psf.upfronthosting.co.za>
Message-ID: <1490394446.07.0.636396996421.issue29770@psf.upfronthosting.co.za>


Xiang Zhang added the comment:


New changeset ce222c87706b1062f7fc03867d1867aa4848dd7b by Xiang Zhang in branch '3.5':
bpo-29770: remove outdated PYO related info (GH-590) (GH-613)
https://github.com/python/cpython/commit/ce222c87706b1062f7fc03867d1867aa4848dd7b


----------
nosy: +xiang.zhang

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29770>
_______________________________________

From report at bugs.python.org  Fri Mar 24 18:27:46 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Fri, 24 Mar 2017 22:27:46 +0000
Subject: [docs] [issue29770] Executable help output (--help) at commandline
 is wrong for option -B
In-Reply-To: <1489063792.65.0.00439171993212.issue29770@psf.upfronthosting.co.za>
Message-ID: <1490394466.34.0.838941982206.issue29770@psf.upfronthosting.co.za>


Xiang Zhang added the comment:


New changeset 16416c22f9b8d9e067506d3a98f661756c80389c by Xiang Zhang in branch '3.6':
bpo-29770: remove outdated PYO related info (GH-590) (GH-612)
https://github.com/python/cpython/commit/16416c22f9b8d9e067506d3a98f661756c80389c


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29770>
_______________________________________

From report at bugs.python.org  Fri Mar 24 18:27:57 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Fri, 24 Mar 2017 22:27:57 +0000
Subject: [docs] [issue29770] Executable help output (--help) at commandline
 is wrong for option -B
In-Reply-To: <1489063792.65.0.00439171993212.issue29770@psf.upfronthosting.co.za>
Message-ID: <1490394477.71.0.611466713515.issue29770@psf.upfronthosting.co.za>


Xiang Zhang added the comment:


New changeset 0710d754255e731e6fcc3f206b51db6156da17c8 by Xiang Zhang in branch 'master':
bpo-29770: remove outdated PYO related info (GH-590)
https://github.com/python/cpython/commit/0710d754255e731e6fcc3f206b51db6156da17c8


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29770>
_______________________________________

From report at bugs.python.org  Fri Mar 24 18:28:07 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 22:28:07 +0000
Subject: [docs] [issue29784] Erroneous link in shutil.copy description
In-Reply-To: <1489157151.86.0.545519035584.issue29784@psf.upfronthosting.co.za>
Message-ID: <1490394487.69.0.498129564607.issue29784@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 701f13ab930b62a634579951dc610f737f461135 by Mariatta in branch '3.6':
bpo-29784: Fix the reference to shutil.copy in the docs (GH-602) (GH-608)
https://github.com/python/cpython/commit/701f13ab930b62a634579951dc610f737f461135


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29784>
_______________________________________

From report at bugs.python.org  Fri Mar 24 18:28:13 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 22:28:13 +0000
Subject: [docs] [issue29784] Erroneous link in shutil.copy description
In-Reply-To: <1489157151.86.0.545519035584.issue29784@psf.upfronthosting.co.za>
Message-ID: <1490394493.6.0.309462356072.issue29784@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 518d8fcb89896dd30fbf11c667ee4e6b509e4dd9 by Mariatta in branch '3.5':
bpo-29784: Fix the reference to shutil.copy in the docs (GH-602) (GH-609)
https://github.com/python/cpython/commit/518d8fcb89896dd30fbf11c667ee4e6b509e4dd9


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29784>
_______________________________________

From report at bugs.python.org  Fri Mar 24 18:28:26 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 22:28:26 +0000
Subject: [docs] [issue29784] Erroneous link in shutil.copy description
In-Reply-To: <1489157151.86.0.545519035584.issue29784@psf.upfronthosting.co.za>
Message-ID: <1490394506.59.0.00570090108419.issue29784@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 70ee0cd5c2a3dba82cb8e0c0742c012f9134c040 by Mariatta in branch 'master':
bpo-29784: Fix the reference to shutil.copy in the docs (GH-602)
https://github.com/python/cpython/commit/70ee0cd5c2a3dba82cb8e0c0742c012f9134c040


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29784>
_______________________________________

From report at bugs.python.org  Fri Mar 24 18:28:35 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 24 Mar 2017 22:28:35 +0000
Subject: [docs] [issue28810] Document bytecode changes in 3.6
In-Reply-To: <1480184644.53.0.660721117392.issue28810@psf.upfronthosting.co.za>
Message-ID: <1490394515.19.0.429239207903.issue28810@psf.upfronthosting.co.za>


Brett Cannon added the comment:


New changeset 4807fa8386f825d0c71192c59f7e33b99a94bebe by Brett Cannon in branch '3.6':
bpo-28810: Document changes to CALL_FUNCTION opcodes (GH-607)
https://github.com/python/cpython/commit/4807fa8386f825d0c71192c59f7e33b99a94bebe


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28810>
_______________________________________

From report at bugs.python.org  Fri Mar 24 18:28:50 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 24 Mar 2017 22:28:50 +0000
Subject: [docs] [issue28810] Document bytecode changes in 3.6
In-Reply-To: <1480184644.53.0.660721117392.issue28810@psf.upfronthosting.co.za>
Message-ID: <1490394530.39.0.440836709373.issue28810@psf.upfronthosting.co.za>


Brett Cannon added the comment:


New changeset 4b2a2a425a906c8e4eb8daee14ab1793e225f726 by Brett Cannon (Ivan Levkivskyi) in branch 'master':
bpo-28810: Document changes to CALL_FUNCTION opcodes (GH-250)
https://github.com/python/cpython/commit/4b2a2a425a906c8e4eb8daee14ab1793e225f726


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28810>
_______________________________________

From report at bugs.python.org  Fri Mar 24 18:28:57 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 24 Mar 2017 22:28:57 +0000
Subject: [docs] [issue28810] Document bytecode changes in 3.6
In-Reply-To: <1480184644.53.0.660721117392.issue28810@psf.upfronthosting.co.za>
Message-ID: <1490394537.22.0.341101225138.issue28810@psf.upfronthosting.co.za>


Brett Cannon added the comment:


New changeset 68c5e4c592495f1e0f4f60acb3483beb6aa87be1 by Brett Cannon in branch '3.6':
bpo-28810: Document BUILD_TUPLE_UNPACK_WITH_CALL bytecode (GH-605)
https://github.com/python/cpython/commit/68c5e4c592495f1e0f4f60acb3483beb6aa87be1


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28810>
_______________________________________

From report at bugs.python.org  Fri Mar 24 18:29:10 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 24 Mar 2017 22:29:10 +0000
Subject: [docs] [issue28810] Document bytecode changes in 3.6
In-Reply-To: <1480184644.53.0.660721117392.issue28810@psf.upfronthosting.co.za>
Message-ID: <1490394550.3.0.821958900036.issue28810@psf.upfronthosting.co.za>


Brett Cannon added the comment:


New changeset 7e52c3e7aefb4cdaa0662fc01ff68a5e976b77ca by Brett Cannon (Ivan Levkivskyi) in branch 'master':
bpo-28810: Document BUILD_TUPLE_UNPACK_WITH_CALL bytecode added in 3.6 (GH-239)
https://github.com/python/cpython/commit/7e52c3e7aefb4cdaa0662fc01ff68a5e976b77ca


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28810>
_______________________________________

From report at bugs.python.org  Fri Mar 24 18:36:50 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 22:36:50 +0000
Subject: [docs] [issue28739] PEP 498: docstrings as f-strings
In-Reply-To: <1479501831.35.0.531195928426.issue28739@psf.upfronthosting.co.za>
Message-ID: <1490395010.05.0.976261022899.issue28739@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset ff6f3716279e75b2519133a82b9de0c3601963d9 by Mariatta in branch '3.6':
bpo-28739: Document that f-strings cannot be used as docstring (GH-592) (GH-600)
https://github.com/python/cpython/commit/ff6f3716279e75b2519133a82b9de0c3601963d9


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28739>
_______________________________________

From report at bugs.python.org  Fri Mar 24 18:37:02 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 22:37:02 +0000
Subject: [docs] [issue28739] PEP 498: docstrings as f-strings
In-Reply-To: <1479501831.35.0.531195928426.issue28739@psf.upfronthosting.co.za>
Message-ID: <1490395022.92.0.479444408853.issue28739@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset d4e89287b397c7382c12d3f3d9fd901fd8243b3c by Mariatta in branch 'master':
bpo-28739: Document that f-strings cannot be used as docstring (GH-592)
https://github.com/python/cpython/commit/d4e89287b397c7382c12d3f3d9fd901fd8243b3c


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28739>
_______________________________________

From report at bugs.python.org  Fri Mar 24 18:38:11 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Fri, 24 Mar 2017 22:38:11 +0000
Subject: [docs] [issue29772] Unintentionally deleted line on
 library/collections.rst
In-Reply-To: <1489070696.66.0.394233240398.issue29772@psf.upfronthosting.co.za>
Message-ID: <1490395091.59.0.927552865806.issue29772@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:


New changeset 309fb90f6895c47e7b41df3d739db45e8ec136c9 by Raymond Hettinger (cocoatomo) in branch '2.7':
Insert the line which should not have been deleted (#581)
https://github.com/python/cpython/commit/309fb90f6895c47e7b41df3d739db45e8ec136c9


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29772>
_______________________________________

From report at bugs.python.org  Fri Mar 24 18:41:36 2017
From: report at bugs.python.org (INADA Naoki)
Date: Fri, 24 Mar 2017 22:41:36 +0000
Subject: [docs] [issue28331] "CPython implementation detail:" removed when
 content translated
In-Reply-To: <1475328552.4.0.631332821236.issue28331@psf.upfronthosting.co.za>
Message-ID: <1490395296.83.0.777011982997.issue28331@psf.upfronthosting.co.za>


INADA Naoki added the comment:


New changeset c351ce6a2c923c5016e48ecbf7b1e4833031d154 by INADA Naoki in branch 'master':
bpo-28331: fix impl-detail label is removed when content is translated. (GH-195)
https://github.com/python/cpython/commit/c351ce6a2c923c5016e48ecbf7b1e4833031d154


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28331>
_______________________________________

From report at bugs.python.org  Fri Mar 24 18:49:19 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 22:49:19 +0000
Subject: [docs] [issue29557] binhex documentation claims unknown bug
In-Reply-To: <1487089244.04.0.406287394607.issue29557@psf.upfronthosting.co.za>
Message-ID: <1490395759.56.0.520854562169.issue29557@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 6b7bc45e33ec953c542788420adc305ec026fa40 by Mariatta in branch '3.5':
bpo-29557: Remove ambiguous line in binhex docs (GH-90) (GH-474)
https://github.com/python/cpython/commit/6b7bc45e33ec953c542788420adc305ec026fa40


----------
nosy: +Mariatta

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29557>
_______________________________________

From report at bugs.python.org  Fri Mar 24 18:49:25 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 22:49:25 +0000
Subject: [docs] [issue29557] binhex documentation claims unknown bug
In-Reply-To: <1487089244.04.0.406287394607.issue29557@psf.upfronthosting.co.za>
Message-ID: <1490395765.55.0.0364619212178.issue29557@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 130c4ec5fbeb0878b88ec6aa06e47c9672566c17 by Mariatta in branch '3.6':
bpo-29557: Remove ambiguous line in binhex docs (GH-90) (GH-475)
https://github.com/python/cpython/commit/130c4ec5fbeb0878b88ec6aa06e47c9672566c17


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29557>
_______________________________________

From report at bugs.python.org  Fri Mar 24 18:57:00 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 24 Mar 2017 22:57:00 +0000
Subject: [docs] [issue29896] ElementTree.fromstring raises undocumented
 UnicodeError
In-Reply-To: <1490366078.02.0.633799101454.issue29896@psf.upfronthosting.co.za>
Message-ID: <1490396220.87.0.359383112871.issue29896@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

I disagree.  The docs only sporadically mention specific exceptions for specific functions.  UnicodeDecodeError can occur any place bytes are decoded to unicode.  I think this should be closed.

Builtin exceptions are documented in https://docs.python.org/3/library/exceptions.html.  Module docs document additional exceptions defined in a module.  ParseError is one such.  https://docs.python.org/3/library/xml.etree.elementtree.html#exceptions.  It is not specifically mentioned in the entry for fromstring or .feed.

I also disagree that the decode error should be wrapped as a parse error.  It happens before parsing in the data preparation step, and the UnicodeDecodeError message give 3 pieces of information specific to the problem.

----------
assignee:  -> docs at python
components: +Documentation
nosy: +docs at python, terry.reedy
status: open -> pending

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29896>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:00:03 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 24 Mar 2017 23:00:03 +0000
Subject: [docs] [issue26213] Document BUILD_*_UNPACK opcodes
In-Reply-To: <1453851645.07.0.698993321818.issue26213@psf.upfronthosting.co.za>
Message-ID: <1490396402.83.0.534685405365.issue26213@psf.upfronthosting.co.za>


Brett Cannon added the comment:


New changeset 4d0630d9d5ff4919caa463a64887f32d671eaab8 by Brett Cannon in branch '3.5':
bpo-26213: Document _UNPACK bytecodes and BUILD_MAP changes (GH-441)
https://github.com/python/cpython/commit/4d0630d9d5ff4919caa463a64887f32d671eaab8


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue26213>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:00:26 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 24 Mar 2017 23:00:26 +0000
Subject: [docs] [issue26213] Document BUILD_*_UNPACK opcodes
In-Reply-To: <1453851645.07.0.698993321818.issue26213@psf.upfronthosting.co.za>
Message-ID: <1490396426.17.0.187297419661.issue26213@psf.upfronthosting.co.za>


Brett Cannon added the comment:


New changeset 226af23e858e2914cf78dfa6fd441c7b90a4cc91 by Brett Cannon in branch '3.6':
bpo-26213: Document _UNPACK bytecodes and BUILD_MAP changes (GH-440)
https://github.com/python/cpython/commit/226af23e858e2914cf78dfa6fd441c7b90a4cc91


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue26213>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:01:45 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 24 Mar 2017 23:01:45 +0000
Subject: [docs] [issue26213] Document BUILD_*_UNPACK opcodes
In-Reply-To: <1453851645.07.0.698993321818.issue26213@psf.upfronthosting.co.za>
Message-ID: <1490396505.76.0.940927601814.issue26213@psf.upfronthosting.co.za>


Brett Cannon added the comment:


New changeset 0705f66eb369aa6a6cdb699e24ff61e1ab2e0c56 by Brett Cannon (Ivan Levkivskyi) in branch 'master':
bpo-26213: Document _UNPACK bytecodes and BUILD_MAP changes (#238)
https://github.com/python/cpython/commit/0705f66eb369aa6a6cdb699e24ff61e1ab2e0c56


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue26213>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:01:54 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 23:01:54 +0000
Subject: [docs] [issue29709] Short-circuiting not only on False and True
In-Reply-To: <1488543100.15.0.348225972332.issue29709@psf.upfronthosting.co.za>
Message-ID: <1490396514.45.0.214709825156.issue29709@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset fc59e5c7073af4d9255644a83933dd5b14c7f722 by Mariatta in branch '2.7':
bpo-29709: Improve Boolean Operations documentation (#433) (#438)
https://github.com/python/cpython/commit/fc59e5c7073af4d9255644a83933dd5b14c7f722


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29709>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:02:08 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 23:02:08 +0000
Subject: [docs] [issue29709] Short-circuiting not only on False and True
In-Reply-To: <1488543100.15.0.348225972332.issue29709@psf.upfronthosting.co.za>
Message-ID: <1490396528.65.0.558172685718.issue29709@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 6e965d9e78b278f2f720a932e7b149cb7d88bd72 by Mariatta in branch '3.5':
bpo-29709: Improve Boolean Operations documentation (#433) (#436)
https://github.com/python/cpython/commit/6e965d9e78b278f2f720a932e7b149cb7d88bd72


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29709>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:02:16 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 23:02:16 +0000
Subject: [docs] [issue29709] Short-circuiting not only on False and True
In-Reply-To: <1488543100.15.0.348225972332.issue29709@psf.upfronthosting.co.za>
Message-ID: <1490396536.14.0.300823697195.issue29709@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 1936ba93c900d47d0c8c915184ac2fa7773c952e by Mariatta in branch '3.6':
bpo-29709: Improve Boolean Operations documentation (#433) (#437)
https://github.com/python/cpython/commit/1936ba93c900d47d0c8c915184ac2fa7773c952e


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29709>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:02:25 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 24 Mar 2017 23:02:25 +0000
Subject: [docs] [issue29455] Mention coverage.py in trace module
 documentation
In-Reply-To: <1486352347.76.0.0578982981399.issue29455@psf.upfronthosting.co.za>
Message-ID: <1490396545.43.0.369495184185.issue29455@psf.upfronthosting.co.za>


Brett Cannon added the comment:


New changeset 9d07aceedabcdc9826489f8b9baffff056283bb3 by Brett Cannon in branch '3.6':
bpo-29455: Mention coverage.py in trace module documentation (GH-435)
https://github.com/python/cpython/commit/9d07aceedabcdc9826489f8b9baffff056283bb3


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29455>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:02:35 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 23:02:35 +0000
Subject: [docs] [issue29709] Short-circuiting not only on False and True
In-Reply-To: <1488543100.15.0.348225972332.issue29709@psf.upfronthosting.co.za>
Message-ID: <1490396554.99.0.797493026427.issue29709@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 8eb531d9db0861e14222445fcaebe1a373bba170 by Mariatta in branch 'master':
bpo-29709: Improve Boolean Operations documentation (#433)
https://github.com/python/cpython/commit/8eb531d9db0861e14222445fcaebe1a373bba170


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29709>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:02:45 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 24 Mar 2017 23:02:45 +0000
Subject: [docs] [issue29455] Mention coverage.py in trace module
 documentation
In-Reply-To: <1486352347.76.0.0578982981399.issue29455@psf.upfronthosting.co.za>
Message-ID: <1490396565.2.0.181269892052.issue29455@psf.upfronthosting.co.za>


Brett Cannon added the comment:


New changeset 5dfccb06dc513ae67fac5fee66356ad58a4de170 by Brett Cannon (Marco Buttu) in branch 'master':
bpo-29455: Mention coverage.py in trace module documentation (#261)
https://github.com/python/cpython/commit/5dfccb06dc513ae67fac5fee66356ad58a4de170


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29455>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:06:36 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 23:06:36 +0000
Subject: [docs] [issue29026] time.time() documentation should mention UTC
 timezone
In-Reply-To: <1482243889.09.0.538886851254.issue29026@psf.upfronthosting.co.za>
Message-ID: <1490396795.97.0.544299459607.issue29026@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 8c851fa3d3044d5bc53e9f931129f5987ece401d by Mariatta in branch '3.5':
bpo-29026: Clarify documentation of time.time (GH-34) (GH-418)
https://github.com/python/cpython/commit/8c851fa3d3044d5bc53e9f931129f5987ece401d


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29026>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:06:56 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 23:06:56 +0000
Subject: [docs] [issue29026] time.time() documentation should mention UTC
 timezone
In-Reply-To: <1482243889.09.0.538886851254.issue29026@psf.upfronthosting.co.za>
Message-ID: <1490396816.45.0.73584981292.issue29026@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset b8f5d07158f171a18be4d42f9769d3c9c073e748 by Mariatta in branch '3.6':
bpo-29026: Clarify documentation of time.time (GH-34) (GH-417)
https://github.com/python/cpython/commit/b8f5d07158f171a18be4d42f9769d3c9c073e748


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29026>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:34:25 2017
From: report at bugs.python.org (Steve Dower)
Date: Fri, 24 Mar 2017 23:34:25 +0000
Subject: [docs] [issue29898] PYTHONLEGACYWINDOWSIOENCODING isn't implemented
In-Reply-To: <1490394843.09.0.467635996133.issue29898@psf.upfronthosting.co.za>
Message-ID: <1490398465.74.0.349575776434.issue29898@psf.upfronthosting.co.za>


Steve Dower added the comment:

It's actually called "PYTHONLEGACYWINDOWSSTDIO" in Python/pylifecycle.c, which is also what PEP 528 says it should be, so this is a docs issue.

You're correct that PYTHONIOENCODING is overridden by detection of a real console, however, PYTHONIOENCODING doesn't currently set a flag anywhere, and the (required for compatibility) defaults on Windows would make it look like it's always been set to something else.

In my opinion, you should set PYTHONLEGACYWINDOWSSTDIO to indicate that even though we know the incoming encoding (Unicode from an interactive console), you don't care and you want to override it with a default value. Then use PYTHONIOENCODING to set that default value. This is most consistent with the existing use of PYTHONIOENCODING (it's the default unless you know exactly which encoding you are getting).

----------
assignee:  -> docs at python
components: +Documentation
nosy: +docs at python

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29898>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:39:05 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 23:39:05 +0000
Subject: [docs] [issue26184] Add versionchanged note for error when
 create_module() is not defined by loaders
In-Reply-To: <1453501860.77.0.669534801782.issue26184@psf.upfronthosting.co.za>
Message-ID: <1490398745.6.0.121910082167.issue26184@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 7e4897a2fb91e49f131a42ed6de88b5185f7dea8 by Mariatta in branch '3.6':
bpo-26184: import.rst: Improve versionchanged note (GH-325) (GH-326)
https://github.com/python/cpython/commit/7e4897a2fb91e49f131a42ed6de88b5185f7dea8


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue26184>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:39:23 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 23:39:23 +0000
Subject: [docs] [issue26184] Add versionchanged note for error when
 create_module() is not defined by loaders
In-Reply-To: <1453501860.77.0.669534801782.issue26184@psf.upfronthosting.co.za>
Message-ID: <1490398763.67.0.993562014095.issue26184@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 1f5639c77f736c18fb5a85b4a1850121e25c788e by Mariatta in branch 'master':
bpo-26184: import.rst: Improve versionchanged note (GH-325)
https://github.com/python/cpython/commit/1f5639c77f736c18fb5a85b4a1850121e25c788e


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue26184>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:40:27 2017
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 24 Mar 2017 23:40:27 +0000
Subject: [docs] [issue29121] sqlite3 Controlling Transactions documentation
 not updated
In-Reply-To: <1483200295.1.0.801871810477.issue29121@psf.upfronthosting.co.za>
Message-ID: <1490398826.61.0.962680955987.issue29121@psf.upfronthosting.co.za>


Berker Peksag added the comment:


New changeset 893e86e9d3c0caeb878ccb1120c7259e022f3b68 by Berker Peksag in branch '3.6':
bpo-29121: Remove outdated documentation about transactions (#313) (#319)
https://github.com/python/cpython/commit/893e86e9d3c0caeb878ccb1120c7259e022f3b68


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29121>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:40:43 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 23:40:43 +0000
Subject: [docs] [issue26184] Add versionchanged note for error when
 create_module() is not defined by loaders
In-Reply-To: <1453501860.77.0.669534801782.issue26184@psf.upfronthosting.co.za>
Message-ID: <1490398843.05.0.24924155519.issue26184@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset deea29e61e61f0e216bff3f0ca008f5ee231793f by Mariatta in branch '3.6':
bpo-26184: import.rst: Improve versionchanged note (GH-277) (#320)
https://github.com/python/cpython/commit/deea29e61e61f0e216bff3f0ca008f5ee231793f


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue26184>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:40:48 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 23:40:48 +0000
Subject: [docs] [issue22594] Add a link to the regex module in re
 documentation
In-Reply-To: <1412927285.57.0.392292696343.issue22594@psf.upfronthosting.co.za>
Message-ID: <1490398848.53.0.172200969575.issue22594@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset c8e20218d77c5b8c16fd76d45612ae48ca3fba91 by Mariatta in branch '2.7':
bpo-22594: Add a link to the regex module in re documentation (GH-241) (GH-321)
https://github.com/python/cpython/commit/c8e20218d77c5b8c16fd76d45612ae48ca3fba91


----------
nosy: +Mariatta

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue22594>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:40:59 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 23:40:59 +0000
Subject: [docs] [issue22594] Add a link to the regex module in re
 documentation
In-Reply-To: <1412927285.57.0.392292696343.issue22594@psf.upfronthosting.co.za>
Message-ID: <1490398859.13.0.936956413544.issue22594@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 21c697fd1073d6ab59e2ba82ea80bc81b9c4125c by Mariatta in branch '3.5':
bpo-22594: Add a link to the regex module in re documentation (GH-241) (GH-317)
https://github.com/python/cpython/commit/21c697fd1073d6ab59e2ba82ea80bc81b9c4125c


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue22594>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:41:09 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 23:41:09 +0000
Subject: [docs] [issue22594] Add a link to the regex module in re
 documentation
In-Reply-To: <1412927285.57.0.392292696343.issue22594@psf.upfronthosting.co.za>
Message-ID: <1490398869.54.0.0738158278654.issue22594@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 1457984c003b1e461f8aab93bfc37fd8e42312d5 by Mariatta in branch '3.6':
bpo-22594: Add a link to the regex module in re documentation (GH-241) (GH-316)
https://github.com/python/cpython/commit/1457984c003b1e461f8aab93bfc37fd8e42312d5


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue22594>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:41:21 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 23:41:21 +0000
Subject: [docs] [issue29648] Missed reference to create_module() in
 versionadded (import.rst)
In-Reply-To: <1488021728.97.0.531293750465.issue29648@psf.upfronthosting.co.za>
Message-ID: <1490398881.51.0.233815443491.issue29648@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 63ed9bc94d8df45b16aee9b92f658ebb34aa1012 by Mariatta in branch '3.5':
bpo-29648: import.rst: Add reference to create_module() (GH-290) (GH-315)
https://github.com/python/cpython/commit/63ed9bc94d8df45b16aee9b92f658ebb34aa1012


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29648>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:41:35 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 23:41:35 +0000
Subject: [docs] [issue26184] Add versionchanged note for error when
 create_module() is not defined by loaders
In-Reply-To: <1453501860.77.0.669534801782.issue26184@psf.upfronthosting.co.za>
Message-ID: <1490398895.62.0.133410407416.issue26184@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 6b4a5f45e2df524174a97832571c82c76a3d424a by Mariatta in branch 'master':
bpo-26184: import.rst: Improve versionchanged note (GH-277)
https://github.com/python/cpython/commit/6b4a5f45e2df524174a97832571c82c76a3d424a


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue26184>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:41:42 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 23:41:42 +0000
Subject: [docs] [issue29648] Missed reference to create_module() in
 versionadded (import.rst)
In-Reply-To: <1488021728.97.0.531293750465.issue29648@psf.upfronthosting.co.za>
Message-ID: <1490398902.79.0.185274104265.issue29648@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 7333d1760e12cf27bcf63265f72521892285c10a by Mariatta in branch '3.6':
bpo-29648: import.rst: Add reference to create_module() (GH-290) (GH-314)
https://github.com/python/cpython/commit/7333d1760e12cf27bcf63265f72521892285c10a


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29648>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:41:50 2017
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 24 Mar 2017 23:41:50 +0000
Subject: [docs] [issue29121] sqlite3 Controlling Transactions documentation
 not updated
In-Reply-To: <1483200295.1.0.801871810477.issue29121@psf.upfronthosting.co.za>
Message-ID: <1490398910.42.0.697889012225.issue29121@psf.upfronthosting.co.za>


Berker Peksag added the comment:


New changeset fe70d924bb6106d4c21eb414f4a1ba1324e8f46a by Berker Peksag in branch 'master':
bpo-29121: Remove outdated documentation about transactions (#313)
https://github.com/python/cpython/commit/fe70d924bb6106d4c21eb414f4a1ba1324e8f46a


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29121>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:41:51 2017
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 24 Mar 2017 23:41:51 +0000
Subject: [docs] [issue29121] sqlite3 Controlling Transactions documentation
 not updated
In-Reply-To: <1483200295.1.0.801871810477.issue29121@psf.upfronthosting.co.za>
Message-ID: <1490398911.2.0.165347420713.issue29121@psf.upfronthosting.co.za>


Berker Peksag added the comment:


New changeset fe70d924bb6106d4c21eb414f4a1ba1324e8f46a by Berker Peksag in branch 'master':
bpo-29121: Remove outdated documentation about transactions (#313)
https://github.com/python/cpython/commit/fe70d924bb6106d4c21eb414f4a1ba1324e8f46a


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29121>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:42:01 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 23:42:01 +0000
Subject: [docs] [issue22594] Add a link to the regex module in re
 documentation
In-Reply-To: <1412927285.57.0.392292696343.issue22594@psf.upfronthosting.co.za>
Message-ID: <1490398921.51.0.0458829774042.issue22594@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset ed6795e46f7653e23b862efad240a93453e7df97 by Mariatta (Marco Buttu) in branch 'master':
bpo-22594: Add a link to the regex module in re documentation (GH-241)
https://github.com/python/cpython/commit/ed6795e46f7653e23b862efad240a93453e7df97


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue22594>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:42:22 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 23:42:22 +0000
Subject: [docs] [issue29648] Missed reference to create_module() in
 versionadded (import.rst)
In-Reply-To: <1488021728.97.0.531293750465.issue29648@psf.upfronthosting.co.za>
Message-ID: <1490398942.36.0.356628095289.issue29648@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 46ce7599af82a929506baeaaee5c149970440c4c by Mariatta (Marco Buttu) in branch 'master':
bpo-29648: import.rst: Add reference to create_module() (GH-290)
https://github.com/python/cpython/commit/46ce7599af82a929506baeaaee5c149970440c4c


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29648>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:43:30 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 23:43:30 +0000
Subject: [docs] [issue28929] Provide a link from documentation back to its
 source file
In-Reply-To: <1481331536.86.0.539237207001.issue28929@psf.upfronthosting.co.za>
Message-ID: <1490399009.9.0.399640670065.issue28929@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 23d2c31cbf3032b8c6bb254f06c4532a6db466b6 by Mariatta in branch '2.7':
[2.7] bpo-28929: Add to Misc/NEWS (GH-286)
https://github.com/python/cpython/commit/23d2c31cbf3032b8c6bb254f06c4532a6db466b6


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28929>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:43:39 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 23:43:39 +0000
Subject: [docs] [issue28929] Provide a link from documentation back to its
 source file
In-Reply-To: <1481331536.86.0.539237207001.issue28929@psf.upfronthosting.co.za>
Message-ID: <1490399019.61.0.323218343695.issue28929@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 5023686f7ee69e9da07cda4b7da6691f19892111 by Mariatta in branch '3.5':
[3.5] bpo-28929: Add to Misc/NEWS (GH-285)
https://github.com/python/cpython/commit/5023686f7ee69e9da07cda4b7da6691f19892111


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28929>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:43:48 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 23:43:48 +0000
Subject: [docs] [issue28929] Provide a link from documentation back to its
 source file
In-Reply-To: <1481331536.86.0.539237207001.issue28929@psf.upfronthosting.co.za>
Message-ID: <1490399028.32.0.167067617446.issue28929@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 1a8dd944d4016593e78a7a6c3c635adee783abfd by Mariatta in branch '3.6':
[3.6] bpo-28929: Add to Misc/NEWS (GH-284)
https://github.com/python/cpython/commit/1a8dd944d4016593e78a7a6c3c635adee783abfd


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28929>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:47:13 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 24 Mar 2017 23:47:13 +0000
Subject: [docs] [issue28929] Provide a link from documentation back to its
 source file
In-Reply-To: <1481331536.86.0.539237207001.issue28929@psf.upfronthosting.co.za>
Message-ID: <1490399233.12.0.329475190696.issue28929@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset e3bf4cdd3db9004220d3ec7f5db4e7d16a99c743 by Mariatta in branch 'master':
bpo-28929: Add to Misc/NEWS (GH-112)
https://github.com/python/cpython/commit/e3bf4cdd3db9004220d3ec7f5db4e7d16a99c743


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28929>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:50:19 2017
From: report at bugs.python.org (Nick Coghlan)
Date: Fri, 24 Mar 2017 23:50:19 +0000
Subject: [docs] [issue28814] Deprecation notice on inspect.getargvalues() is
 incorrect
In-Reply-To: <1480252052.94.0.16018093739.issue28814@psf.upfronthosting.co.za>
Message-ID: <1490399419.16.0.0976140892072.issue28814@psf.upfronthosting.co.za>


Nick Coghlan added the comment:


New changeset 0246422b974b1a0c50dd30b0e1a1138674ef87a5 by Nick Coghlan (Berker Peksag) in branch '3.5':
bpo-28814: Undeprecate inadvertently deprecated inspect functions. (#122) (#244)
https://github.com/python/cpython/commit/0246422b974b1a0c50dd30b0e1a1138674ef87a5


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28814>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:50:25 2017
From: report at bugs.python.org (STINNER Victor)
Date: Fri, 24 Mar 2017 23:50:25 +0000
Subject: [docs] [issue28911] Clarify the behaviour of assert_called_once_with
In-Reply-To: <1481233700.68.0.637550951007.issue28911@psf.upfronthosting.co.za>
Message-ID: <1490399425.91.0.867185437423.issue28911@psf.upfronthosting.co.za>


STINNER Victor added the comment:


New changeset fa30453568ae71861aa1928373bd76da4f3a33f6 by Victor Stinner (Arne de Laat) in branch '3.5':
bpo-28911: Clarify the behaviour of assert_called_once_with. (#254)
https://github.com/python/cpython/commit/fa30453568ae71861aa1928373bd76da4f3a33f6


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28911>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:50:35 2017
From: report at bugs.python.org (Nick Coghlan)
Date: Fri, 24 Mar 2017 23:50:35 +0000
Subject: [docs] [issue28814] Deprecation notice on inspect.getargvalues() is
 incorrect
In-Reply-To: <1480252052.94.0.16018093739.issue28814@psf.upfronthosting.co.za>
Message-ID: <1490399435.83.0.794992762095.issue28814@psf.upfronthosting.co.za>


Nick Coghlan added the comment:


New changeset 2197eac6104311472f200645bc844adb46444b10 by Nick Coghlan (Berker Peksag) in branch '3.6':
bpo-28814: Undeprecate inadvertently deprecated inspect functions. (#122) (#243)
https://github.com/python/cpython/commit/2197eac6104311472f200645bc844adb46444b10


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28814>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:51:07 2017
From: report at bugs.python.org (STINNER Victor)
Date: Fri, 24 Mar 2017 23:51:07 +0000
Subject: [docs] [issue28911] Clarify the behaviour of assert_called_once_with
In-Reply-To: <1481233700.68.0.637550951007.issue28911@psf.upfronthosting.co.za>
Message-ID: <1490399467.91.0.193545469587.issue28911@psf.upfronthosting.co.za>


STINNER Victor added the comment:


New changeset 55b82e10dc6b75b30a72fa56beb60eaf54a008d4 by Victor Stinner (Arne de Laat) in branch '3.6':
bpo-28911: Clarify the behaviour of assert_called_once_with. (#252)
https://github.com/python/cpython/commit/55b82e10dc6b75b30a72fa56beb60eaf54a008d4


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28911>
_______________________________________

From report at bugs.python.org  Fri Mar 24 19:51:15 2017
From: report at bugs.python.org (STINNER Victor)
Date: Fri, 24 Mar 2017 23:51:15 +0000
Subject: [docs] [issue28911] Clarify the behaviour of assert_called_once_with
In-Reply-To: <1481233700.68.0.637550951007.issue28911@psf.upfronthosting.co.za>
Message-ID: <1490399475.31.0.143984865119.issue28911@psf.upfronthosting.co.za>


STINNER Victor added the comment:


New changeset 324c5d8ca6ed1c964d3b20e5762139ec65c7827c by Victor Stinner (Arne de Laat) in branch 'master':
bpo-28911: Clarify the behaviour of assert_called_once_with. (#251)
https://github.com/python/cpython/commit/324c5d8ca6ed1c964d3b20e5762139ec65c7827c


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28911>
_______________________________________

From report at bugs.python.org  Fri Mar 24 20:07:39 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 25 Mar 2017 00:07:39 +0000
Subject: [docs] [issue29521] Minor warning messages when compiling
 documentation
In-Reply-To: <1486714459.11.0.428886237265.issue29521@psf.upfronthosting.co.za>
Message-ID: <1490400459.06.0.671261444426.issue29521@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset db3deb98e969d3f43b169cd320abd46b21a10c6d by Mariatta in branch '3.6':
bpo-29521 Fix two minor documentation build warnings (#41) (#83)
https://github.com/python/cpython/commit/db3deb98e969d3f43b169cd320abd46b21a10c6d


----------
nosy: +Mariatta

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29521>
_______________________________________

From report at bugs.python.org  Fri Mar 24 20:08:10 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 25 Mar 2017 00:08:10 +0000
Subject: [docs] [issue29521] Minor warning messages when compiling
 documentation
In-Reply-To: <1486714459.11.0.428886237265.issue29521@psf.upfronthosting.co.za>
Message-ID: <1490400490.27.0.877930467474.issue29521@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 38c8354f3204441f6c6bd22213b449d2d8954fcc by Mariatta in branch '3.5':
bpo-29521 Fix two minor documentation build warnings (#41) (#84)
https://github.com/python/cpython/commit/38c8354f3204441f6c6bd22213b449d2d8954fcc


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29521>
_______________________________________

From report at bugs.python.org  Fri Mar 24 20:18:25 2017
From: report at bugs.python.org (STINNER Victor)
Date: Sat, 25 Mar 2017 00:18:25 +0000
Subject: [docs] [issue29521] Minor warning messages when compiling
 documentation
In-Reply-To: <1486714459.11.0.428886237265.issue29521@psf.upfronthosting.co.za>
Message-ID: <1490401105.67.0.367109668897.issue29521@psf.upfronthosting.co.za>


STINNER Victor added the comment:


New changeset 2b501866ed493758e4c4b29f0ce9b24023d910a1 by Victor Stinner in branch 'master':
Travis CI: run rstlint.py in the docs job (#68)
https://github.com/python/cpython/commit/2b501866ed493758e4c4b29f0ce9b24023d910a1


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29521>
_______________________________________

From report at bugs.python.org  Fri Mar 24 20:18:52 2017
From: report at bugs.python.org (Brian Curtin)
Date: Sat, 25 Mar 2017 00:18:52 +0000
Subject: [docs] [issue29521] Minor warning messages when compiling
 documentation
In-Reply-To: <1486714459.11.0.428886237265.issue29521@psf.upfronthosting.co.za>
Message-ID: <1490401132.32.0.530922077018.issue29521@psf.upfronthosting.co.za>


Brian Curtin added the comment:


New changeset 3d707be950b387552585451071928e7b39cdfa53 by Brian Curtin (Jim DeLaHunt) in branch 'master':
bpo-29521 Fix two minor documentation build warnings (#41)
https://github.com/python/cpython/commit/3d707be950b387552585451071928e7b39cdfa53


----------
nosy: +brian.curtin

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29521>
_______________________________________

From report at bugs.python.org  Fri Mar 24 20:22:34 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 25 Mar 2017 00:22:34 +0000
Subject: [docs] [issue28929] Provide a link from documentation back to its
 source file
In-Reply-To: <1481331536.86.0.539237207001.issue28929@psf.upfronthosting.co.za>
Message-ID: <1490401354.05.0.983152188836.issue28929@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset f66c81ff499fb431e56bc68f5e39c2f7b9fcb6a7 by Mariatta in branch '3.6':
[backport to 3.6] bpo-28929: Link the documentation to its source file on GitHub (#37)
https://github.com/python/cpython/commit/f66c81ff499fb431e56bc68f5e39c2f7b9fcb6a7


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28929>
_______________________________________

From report at bugs.python.org  Fri Mar 24 20:23:03 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 25 Mar 2017 00:23:03 +0000
Subject: [docs] [issue28929] Provide a link from documentation back to its
 source file
In-Reply-To: <1481331536.86.0.539237207001.issue28929@psf.upfronthosting.co.za>
Message-ID: <1490401383.11.0.440434999267.issue28929@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset d4a97d894859d4bb52937d46460049ba016e00b2 by Mariatta in branch 'master':
bpo-28929: Link the documentation to its source file on GitHub (#35)
https://github.com/python/cpython/commit/d4a97d894859d4bb52937d46460049ba016e00b2


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28929>
_______________________________________

From report at bugs.python.org  Fri Mar 24 20:23:29 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 25 Mar 2017 00:23:29 +0000
Subject: [docs] [issue28929] Provide a link from documentation back to its
 source file
In-Reply-To: <1481331536.86.0.539237207001.issue28929@psf.upfronthosting.co.za>
Message-ID: <1490401409.04.0.652246798945.issue28929@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset e15259c2dfef58df5f7cfa2305811a00c05e0353 by Mariatta in branch '2.7':
bpo-28929: Link the documentation to its source file on GitHub (#38)
https://github.com/python/cpython/commit/e15259c2dfef58df5f7cfa2305811a00c05e0353


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28929>
_______________________________________

From report at bugs.python.org  Fri Mar 24 20:24:59 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 25 Mar 2017 00:24:59 +0000
Subject: [docs] [issue28929] Provide a link from documentation back to its
 source file
In-Reply-To: <1481331536.86.0.539237207001.issue28929@psf.upfronthosting.co.za>
Message-ID: <1490401499.27.0.919024961072.issue28929@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset cabd1c7462ef991937e0e759b9bf307b3091ef06 by Mariatta in branch '3.5':
[backport to 3.5] bpo-28929: Link the documentation to its source file on GitHub (#36)
https://github.com/python/cpython/commit/cabd1c7462ef991937e0e759b9bf307b3091ef06


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28929>
_______________________________________

From report at bugs.python.org  Fri Mar 24 20:27:25 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 25 Mar 2017 00:27:25 +0000
Subject: [docs] [issue29474] Grammatical errors in
 weakref.WeakValueDictionary docs
In-Reply-To: <1486483158.7.0.401706945265.issue29474@psf.upfronthosting.co.za>
Message-ID: <1490401645.07.0.977545616049.issue29474@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 3110a379bbb1ec10a84d70a2f0faffcf8d22c7ed by Mariatta in branch 'master':
bpo-29474: Improve documentation for weakref.WeakValueDictionary (#10)
https://github.com/python/cpython/commit/3110a379bbb1ec10a84d70a2f0faffcf8d22c7ed


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29474>
_______________________________________

From report at bugs.python.org  Fri Mar 24 20:27:54 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 25 Mar 2017 00:27:54 +0000
Subject: [docs] [issue29474] Grammatical errors in
 weakref.WeakValueDictionary docs
In-Reply-To: <1486483158.7.0.401706945265.issue29474@psf.upfronthosting.co.za>
Message-ID: <1490401674.04.0.423648076796.issue29474@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 308f789d00735e6707dbc5c8f60a1c8cf245fb4b by Mariatta in branch '3.6':
bpo-29474: Improve documentation for weakref.WeakValueDictionary (#22)
https://github.com/python/cpython/commit/308f789d00735e6707dbc5c8f60a1c8cf245fb4b


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29474>
_______________________________________

From report at bugs.python.org  Fri Mar 24 20:28:11 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 25 Mar 2017 00:28:11 +0000
Subject: [docs] [issue29474] Grammatical errors in
 weakref.WeakValueDictionary docs
In-Reply-To: <1486483158.7.0.401706945265.issue29474@psf.upfronthosting.co.za>
Message-ID: <1490401691.13.0.336109132721.issue29474@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset ae828714ebdb7a0d69bf23c1f6d606e5e63bdcfe by Mariatta in branch '3.5':
bpo-29474: Improve documentation for weakref.WeakValueDictionary (#23)
https://github.com/python/cpython/commit/ae828714ebdb7a0d69bf23c1f6d606e5e63bdcfe


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29474>
_______________________________________

From report at bugs.python.org  Fri Mar 24 20:49:39 2017
From: report at bugs.python.org (Zachary Ware)
Date: Sat, 25 Mar 2017 00:49:39 +0000
Subject: [docs] [issue29474] Grammatical errors in
 weakref.WeakValueDictionary docs
In-Reply-To: <1486483158.7.0.401706945265.issue29474@psf.upfronthosting.co.za>
Message-ID: <1490402978.96.0.619692933371.issue29474@psf.upfronthosting.co.za>


Zachary Ware added the comment:


New changeset 5c329882fa20f615375f068176e569de7389fa3f by Zachary Ware (Mariatta) in branch '2.7':
bpo-29474: Improve documentation for weakref.WeakValueDictionary (#11)
https://github.com/python/cpython/commit/5c329882fa20f615375f068176e569de7389fa3f


----------
nosy: +zach.ware

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29474>
_______________________________________

From report at bugs.python.org  Fri Mar 24 22:55:11 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 25 Mar 2017 02:55:11 +0000
Subject: [docs] [issue29892] change statement for open() is splited into two
 part in middle of sentence.
In-Reply-To: <1490312778.71.0.779732227064.issue29892@psf.upfronthosting.co.za>
Message-ID: <1490410511.27.0.675450716147.issue29892@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 29540cdf6c66df9f806375a95078c0c63192ef78 by Mariatta (NAKAMURA Osamu) in branch 'master':
bpo-29892: Fix wrong markup on doc-lib-functions (GH-802)
https://github.com/python/cpython/commit/29540cdf6c66df9f806375a95078c0c63192ef78


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29892>
_______________________________________

From report at bugs.python.org  Fri Mar 24 22:56:56 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 25 Mar 2017 02:56:56 +0000
Subject: [docs] [issue29892] change statement for open() is splited into two
 part in middle of sentence.
In-Reply-To: <1490312778.71.0.779732227064.issue29892@psf.upfronthosting.co.za>
Message-ID: <1490410616.47.0.991177908574.issue29892@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +717

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29892>
_______________________________________

From report at bugs.python.org  Fri Mar 24 23:04:42 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 25 Mar 2017 03:04:42 +0000
Subject: [docs] [issue29892] change statement for open() is splited into two
 part in middle of sentence.
In-Reply-To: <1490312778.71.0.779732227064.issue29892@psf.upfronthosting.co.za>
Message-ID: <1490411082.79.0.854876091507.issue29892@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 5dafaece67cb576ef96579fb5ddcbf62e0827b0d by Mariatta in branch '3.6':
bpo-29892: Fix wrong markup on doc-lib-functions (GH-802) (GH-810)
https://github.com/python/cpython/commit/5dafaece67cb576ef96579fb5ddcbf62e0827b0d


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29892>
_______________________________________

From report at bugs.python.org  Fri Mar 24 23:06:14 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 25 Mar 2017 03:06:14 +0000
Subject: [docs] [issue29892] change statement for open() is splited into two
 part in middle of sentence.
In-Reply-To: <1490312778.71.0.779732227064.issue29892@psf.upfronthosting.co.za>
Message-ID: <1490411174.48.0.588031651384.issue29892@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

PR was merged and backported into 3.6.

Thanks all :)

----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29892>
_______________________________________

From report at bugs.python.org  Sat Mar 25 00:28:39 2017
From: report at bugs.python.org (R. David Murray)
Date: Sat, 25 Mar 2017 04:28:39 +0000
Subject: [docs] [issue29896] ElementTree.fromstring raises undocumented
 UnicodeError
In-Reply-To: <1490366078.02.0.633799101454.issue29896@psf.upfronthosting.co.za>
Message-ID: <1490416119.58.0.987934054767.issue29896@psf.upfronthosting.co.za>


R. David Murray added the comment:

Agreed with Terry.  The general policy in Python is that we let errors bubble up unless there is a good reason to do something else with them.  And errors that bubble up are not, in general, documented.  (In short, Python is not Java :)

----------
nosy: +r.david.murray
resolution:  -> not a bug
stage:  -> resolved
status: pending -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29896>
_______________________________________

From report at bugs.python.org  Sat Mar 25 01:53:17 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 25 Mar 2017 05:53:17 +0000
Subject: [docs] [issue29557] binhex documentation claims unknown bug
In-Reply-To: <1487089244.04.0.406287394607.issue29557@psf.upfronthosting.co.za>
Message-ID: <1490421197.55.0.260677360502.issue29557@psf.upfronthosting.co.za>


Changes by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29557>
_______________________________________

From report at bugs.python.org  Sat Mar 25 03:42:54 2017
From: report at bugs.python.org (Eryk Sun)
Date: Sat, 25 Mar 2017 07:42:54 +0000
Subject: [docs] [issue29898] PYTHONLEGACYWINDOWSIOENCODING isn't implemented
In-Reply-To: <1490394843.09.0.467635996133.issue29898@psf.upfronthosting.co.za>
Message-ID: <1490427774.11.0.442994010342.issue29898@psf.upfronthosting.co.za>


Eryk Sun added the comment:

I prefer the name PYTHONLEGACYWINDOWSIOENCODING for symmetry with both PYTHONIOENCODING and PYTHONLEGACYWINDOWSFSENCODING, but I suppose you changed it to make it more visually distinguished from the latter.

I discovered this issue due to the modified behavior of PYTHONIOENCODING. It's not really a disruptive change, but it looks wrong based solely on the --help text description of PYTHONIOENCODING. An alternative would be to set Py_LegacyWindowsStdioFlag in _Py_InitializeEx_Private either when PYTHONLEGACYWINDOWSSTDIO is set or when PYTHONIOENCODING isn't a case-insensitive match for "utf-8" with an optional :errors spec. That way people get exactly what they asked for, even if it's mojibake nonsense given the console's current input and output codepages.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29898>
_______________________________________

From report at bugs.python.org  Sat Mar 25 13:05:16 2017
From: report at bugs.python.org (Steve Dower)
Date: Sat, 25 Mar 2017 17:05:16 +0000
Subject: [docs] [issue29898] PYTHONLEGACYWINDOWSIOENCODING isn't implemented
In-Reply-To: <1490394843.09.0.467635996133.issue29898@psf.upfronthosting.co.za>
Message-ID: <1490461516.31.0.809591296488.issue29898@psf.upfronthosting.co.za>


Steve Dower added the comment:

Sure, but you're proposing a change to a correctly documented (apart from the variable name) and released behavior. It can't be changed in 3.6, and I don't see a compelling reason to have different behavior in 3.7.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29898>
_______________________________________

From report at bugs.python.org  Sat Mar 25 17:21:35 2017
From: report at bugs.python.org (Martin Panter)
Date: Sat, 25 Mar 2017 21:21:35 +0000
Subject: [docs] [issue21071] struct.Struct.format is bytes, but should be str
In-Reply-To: <1395856133.5.0.672707015318.issue21071@psf.upfronthosting.co.za>
Message-ID: <1490476895.88.0.979076150648.issue21071@psf.upfronthosting.co.za>


Martin Panter added the comment:

A backwards-compatible way forward would be to preserve (and document) the ?format? attribute as a byte string, and add a new attribute which is definitely a text string. Not sure of a good name; perhaps ?Struct.text_format? or ?format_str? is a start.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue21071>
_______________________________________

From report at bugs.python.org  Sun Mar 26 03:05:25 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 26 Mar 2017 07:05:25 +0000
Subject: [docs] [issue22062] Fix pathlib.Path.(r)glob doc glitches.
In-Reply-To: <1406239862.0.0.293742999811.issue22062@psf.upfronthosting.co.za>
Message-ID: <1490511925.28.0.0685926336321.issue22062@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

Can you create a pull request on GitHub Mike?

----------
nosy: +serhiy.storchaka

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue22062>
_______________________________________

From report at bugs.python.org  Sun Mar 26 03:58:33 2017
From: report at bugs.python.org (Kinebuchi Tomohiko)
Date: Sun, 26 Mar 2017 07:58:33 +0000
Subject: [docs] [issue29888] The link referring to "Python download page" is
 broken
In-Reply-To: <1490292263.44.0.884300917971.issue29888@psf.upfronthosting.co.za>
Message-ID: <1490515113.48.0.621781594896.issue29888@psf.upfronthosting.co.za>


Changes by Kinebuchi Tomohiko <cocoatomo77 at gmail.com>:


----------
pull_requests: +726

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29888>
_______________________________________

From report at bugs.python.org  Sun Mar 26 09:13:18 2017
From: report at bugs.python.org (Kinebuchi Tomohiko)
Date: Sun, 26 Mar 2017 13:13:18 +0000
Subject: [docs] [issue29888] The link referring to "Python download page" is
 broken
In-Reply-To: <1490292263.44.0.884300917971.issue29888@psf.upfronthosting.co.za>
Message-ID: <1490533998.61.0.0102721451183.issue29888@psf.upfronthosting.co.za>


Changes by Kinebuchi Tomohiko <cocoatomo77 at gmail.com>:


----------
pull_requests: +728

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29888>
_______________________________________

From report at bugs.python.org  Sun Mar 26 10:00:32 2017
From: report at bugs.python.org (Kinebuchi Tomohiko)
Date: Sun, 26 Mar 2017 14:00:32 +0000
Subject: [docs] [issue29888] The link referring to "Python download page" is
 broken
In-Reply-To: <1490292263.44.0.884300917971.issue29888@psf.upfronthosting.co.za>
Message-ID: <1490536832.39.0.46820304616.issue29888@psf.upfronthosting.co.za>


Changes by Kinebuchi Tomohiko <cocoatomo77 at gmail.com>:


----------
pull_requests: +730

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29888>
_______________________________________

From report at bugs.python.org  Sun Mar 26 10:02:27 2017
From: report at bugs.python.org (Kinebuchi Tomohiko)
Date: Sun, 26 Mar 2017 14:02:27 +0000
Subject: [docs] [issue29888] The link referring to "Python download page" is
 broken
In-Reply-To: <1490292263.44.0.884300917971.issue29888@psf.upfronthosting.co.za>
Message-ID: <1490536947.8.0.78267570756.issue29888@psf.upfronthosting.co.za>


Kinebuchi Tomohiko added the comment:

I just created two pull requests.

+ PR for 2.7 -> https://github.com/python/cpython/pull/823
+ PR for 3.5 or newer -> https://github.com/python/cpython/pull/824

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29888>
_______________________________________

From report at bugs.python.org  Sun Mar 26 13:32:27 2017
From: report at bugs.python.org (Ned Deily)
Date: Sun, 26 Mar 2017 17:32:27 +0000
Subject: [docs] [issue29888] The link referring to "Python download page" is
 broken
In-Reply-To: <1490292263.44.0.884300917971.issue29888@psf.upfronthosting.co.za>
Message-ID: <1490549547.16.0.879477297535.issue29888@psf.upfronthosting.co.za>


Ned Deily added the comment:


New changeset f8beb9831acd5cf80b9c56aea5864e16118c5400 by Ned Deily (cocoatomo) in branch 'master':
bpo-29888: Fix the link referring to the "Python download page" (GH-824)
https://github.com/python/cpython/commit/f8beb9831acd5cf80b9c56aea5864e16118c5400


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29888>
_______________________________________

From report at bugs.python.org  Sun Mar 26 13:44:11 2017
From: report at bugs.python.org (Ned Deily)
Date: Sun, 26 Mar 2017 17:44:11 +0000
Subject: [docs] [issue29888] The link referring to "Python download page" is
 broken
In-Reply-To: <1490292263.44.0.884300917971.issue29888@psf.upfronthosting.co.za>
Message-ID: <1490550251.63.0.788487664935.issue29888@psf.upfronthosting.co.za>


Changes by Ned Deily <nad at python.org>:


----------
pull_requests: +732

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29888>
_______________________________________

From report at bugs.python.org  Sun Mar 26 13:47:07 2017
From: report at bugs.python.org (Ned Deily)
Date: Sun, 26 Mar 2017 17:47:07 +0000
Subject: [docs] [issue29888] The link referring to "Python download page" is
 broken
In-Reply-To: <1490292263.44.0.884300917971.issue29888@psf.upfronthosting.co.za>
Message-ID: <1490550427.09.0.259469113802.issue29888@psf.upfronthosting.co.za>


Changes by Ned Deily <nad at python.org>:


----------
pull_requests: +733

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29888>
_______________________________________

From report at bugs.python.org  Sun Mar 26 13:58:15 2017
From: report at bugs.python.org (Ned Deily)
Date: Sun, 26 Mar 2017 17:58:15 +0000
Subject: [docs] [issue29888] The link referring to "Python download page" is
 broken
In-Reply-To: <1490292263.44.0.884300917971.issue29888@psf.upfronthosting.co.za>
Message-ID: <1490551095.26.0.116967837071.issue29888@psf.upfronthosting.co.za>


Ned Deily added the comment:


New changeset ceff32fb833e7be42508ffa73344e2e56865e54b by Ned Deily in branch '3.6':
bpo-29888: Fix the link referring to the "Python download page" (GH-824) (GH-826)
https://github.com/python/cpython/commit/ceff32fb833e7be42508ffa73344e2e56865e54b


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29888>
_______________________________________

From report at bugs.python.org  Sun Mar 26 13:59:03 2017
From: report at bugs.python.org (Ned Deily)
Date: Sun, 26 Mar 2017 17:59:03 +0000
Subject: [docs] [issue29888] The link referring to "Python download page" is
 broken
In-Reply-To: <1490292263.44.0.884300917971.issue29888@psf.upfronthosting.co.za>
Message-ID: <1490551143.78.0.0682473839032.issue29888@psf.upfronthosting.co.za>


Ned Deily added the comment:


New changeset 8ce3085bf167b702989a9db466078b5676e825e3 by Ned Deily in branch '3.5':
bpo-29888: Fix the link referring to the "Python download page" (GH-824) (GH-827)
https://github.com/python/cpython/commit/8ce3085bf167b702989a9db466078b5676e825e3


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29888>
_______________________________________

From report at bugs.python.org  Sun Mar 26 14:05:03 2017
From: report at bugs.python.org (Ned Deily)
Date: Sun, 26 Mar 2017 18:05:03 +0000
Subject: [docs] [issue29888] The link referring to "Python download page" is
 broken
In-Reply-To: <1490292263.44.0.884300917971.issue29888@psf.upfronthosting.co.za>
Message-ID: <1490551503.63.0.381026527977.issue29888@psf.upfronthosting.co.za>


Ned Deily added the comment:

Thanks for the pull requests!  I've merged to master, 3.6, and 3.5 and I left a comment for the 2.7 PR.  By the way, next time you make a PR, please feel free to add your name to Misc/ACKS.

----------
stage:  -> commit review
versions: +Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29888>
_______________________________________

From report at bugs.python.org  Sun Mar 26 15:17:24 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 26 Mar 2017 19:17:24 +0000
Subject: [docs] [issue19824] string.Template: Add PHP-style variable
 expansion example
In-Reply-To: <1385658424.56.0.963803246137.issue19824@psf.upfronthosting.co.za>
Message-ID: <1490555844.18.0.482139498742.issue19824@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

Formatting with locals() and globals() should be used with careful. This is not the most idiomatic way of formatting. I think that the post in specialised blog would be better place for describing it than Python stdlib documentation.

Peoples coming from PHP world can use f-strings.

----------
nosy: +serhiy.storchaka
status: open -> pending

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue19824>
_______________________________________

From report at bugs.python.org  Sun Mar 26 16:17:31 2017
From: report at bugs.python.org (Barry A. Warsaw)
Date: Sun, 26 Mar 2017 20:17:31 +0000
Subject: [docs] [issue19824] string.Template: Add PHP-style variable
 expansion example
In-Reply-To: <1385658424.56.0.963803246137.issue19824@psf.upfronthosting.co.za>
Message-ID: <1490559451.2.0.0368440781312.issue19824@psf.upfronthosting.co.za>


Barry A. Warsaw added the comment:

We should really restructure string.Template documentation to emphasize i18n.  That's always been its prime use case, and f-strings don't change that (because f-strings are not really appropriate for translations).  Before f-strings, string.Template had other common uses. But f-strings do fulfill most other cases where people were using string.Template, so let's make sure that distinction is clear to people.

----------
status: pending -> open

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue19824>
_______________________________________

From report at bugs.python.org  Sun Mar 26 20:48:25 2017
From: report at bugs.python.org (R. David Murray)
Date: Mon, 27 Mar 2017 00:48:25 +0000
Subject: [docs] [issue19824] string.Template: Rewrite docs to emphasize i18n
 use case
In-Reply-To: <1385658424.56.0.963803246137.issue19824@psf.upfronthosting.co.za>
Message-ID: <1490575705.49.0.0338395057397.issue19824@psf.upfronthosting.co.za>


R. David Murray added the comment:

Let's retitle this, then.

----------
nosy: +r.david.murray
title: string.Template: Add PHP-style variable expansion example -> string.Template: Rewrite docs to emphasize i18n use case

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue19824>
_______________________________________

From report at bugs.python.org  Sun Mar 26 21:52:12 2017
From: report at bugs.python.org (Kinebuchi Tomohiko)
Date: Mon, 27 Mar 2017 01:52:12 +0000
Subject: [docs] [issue29888] The link referring to "Python download page" is
 broken
In-Reply-To: <1490292263.44.0.884300917971.issue29888@psf.upfronthosting.co.za>
Message-ID: <1490579532.5.0.212103016716.issue29888@psf.upfronthosting.co.za>


Kinebuchi Tomohiko added the comment:

@ned.deily Thank you for the commend. I updated the 2.7 PR.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29888>
_______________________________________

From report at bugs.python.org  Sun Mar 26 22:59:16 2017
From: report at bugs.python.org (Ned Deily)
Date: Mon, 27 Mar 2017 02:59:16 +0000
Subject: [docs] [issue29888] The link referring to "Python download page" is
 broken
In-Reply-To: <1490292263.44.0.884300917971.issue29888@psf.upfronthosting.co.za>
Message-ID: <1490583556.6.0.177752946382.issue29888@psf.upfronthosting.co.za>


Ned Deily added the comment:


New changeset 6f95b37f290e0225aed5f8f7733ad0730601201b by Ned Deily (cocoatomo) in branch '2.7':
bpo-29888: Fix the link referring to "Python download page" (GH-823)
https://github.com/python/cpython/commit/6f95b37f290e0225aed5f8f7733ad0730601201b


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29888>
_______________________________________

From report at bugs.python.org  Sun Mar 26 23:02:26 2017
From: report at bugs.python.org (Ned Deily)
Date: Mon, 27 Mar 2017 03:02:26 +0000
Subject: [docs] [issue29888] The link referring to "Python download page" is
 broken
In-Reply-To: <1490292263.44.0.884300917971.issue29888@psf.upfronthosting.co.za>
Message-ID: <1490583746.67.0.76133605292.issue29888@psf.upfronthosting.co.za>


Changes by Ned Deily <nad at python.org>:


----------
resolution:  -> fixed
stage: commit review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29888>
_______________________________________

From report at bugs.python.org  Mon Mar 27 01:38:04 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 27 Mar 2017 05:38:04 +0000
Subject: [docs] [issue19824] string.Template: Rewrite docs to emphasize i18n
 use case
In-Reply-To: <1385658424.56.0.963803246137.issue19824@psf.upfronthosting.co.za>
Message-ID: <1490593084.22.0.342125123093.issue19824@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

In that case issue20314 looks related.

----------
stage:  -> needs patch
type:  -> enhancement

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue19824>
_______________________________________

From report at bugs.python.org  Mon Mar 27 06:26:54 2017
From: report at bugs.python.org (Michael Seifert)
Date: Mon, 27 Mar 2017 10:26:54 +0000
Subject: [docs] [issue29916] No explicit documentation for PyGetSetDef and
 getter and setter C-API
Message-ID: <1490610414.6.0.8634942266.issue29916@psf.upfronthosting.co.za>


New submission from Michael Seifert:

A copy of the struct definition can be found in the typeobject documentation [1]. There is also some explanation of the "closure" function pointer in the extending tutorial [2].

However the struct isn't explicitly defined as "c:type" so the 6 links to it in the documentations go nowhere.

I also submitted a pull request.

[1] https://docs.python.org/3.6/c-api/typeobj.html#c.PyTypeObject.tp_getset
[2] https://docs.python.org/3/extending/newtypes.html

----------
assignee: docs at python
components: Documentation
messages: 290574
nosy: MSeifert, docs at python
priority: normal
pull_requests: 742
severity: normal
status: open
title: No explicit documentation for PyGetSetDef and getter and setter C-API

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29916>
_______________________________________

From report at bugs.python.org  Mon Mar 27 06:31:12 2017
From: report at bugs.python.org (Michael Seifert)
Date: Mon, 27 Mar 2017 10:31:12 +0000
Subject: [docs] [issue29917] Wrong link target in PyMethodDef documentation
Message-ID: <1490610672.62.0.617621215351.issue29917@psf.upfronthosting.co.za>


New submission from Michael Seifert:

The `link`-target of the "type" struct member is the python built-in "type".  See [1].

I think it should not be a link at all.

[1] https://docs.python.org/3.7/c-api/structures.html#c.PyMemberDef

----------
assignee: docs at python
components: Documentation
messages: 290575
nosy: MSeifert, docs at python
priority: normal
severity: normal
status: open
title: Wrong link target in PyMethodDef documentation

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29917>
_______________________________________

From report at bugs.python.org  Mon Mar 27 06:37:52 2017
From: report at bugs.python.org (Nick Coghlan)
Date: Mon, 27 Mar 2017 10:37:52 +0000
Subject: [docs] [issue29913] ipadress compare_networks does not work
 according to documentation
In-Reply-To: <1490599415.99.0.717154213111.issue29913@psf.upfronthosting.co.za>
Message-ID: <1490611072.56.0.920470434145.issue29913@psf.upfronthosting.co.za>


Nick Coghlan added the comment:

Right, I agree compare_networks() is behaving correctly according to its original design. However:

- it was designed for Python 2, where cmp() style idioms were still more common. Those idioms have largely been removed in Python 3 (no cmp() builtin, no __cmp__ magic method, no cmp argument to list.sort() and sorted())

- it was designed for the ipaddr data model, where network equality comparisons are more like ipaddress.ip_interface comparisons than they ipaddress.ip_network comparisons

Since there isn't any real maintenance burden in keeping the code around, I'm flipping this to be purely a documentation issue and suggesting that we:

- mark the method as deprecated in the docs, but *not* in the code (using the method form is just kind of pointless, not actively harmful)

- update the docs to say that it uses the same ordering and comparison algorithm as "<", "==", and ">" (the current confusion stems from the fact that the algorithms were different in ipaddr, but in the stdlib that other algorithm is the one used by interface objects, not network objects)

----------
assignee:  -> docs at python
components: +Documentation -Library (Lib)
nosy: +docs at python
stage:  -> needs patch

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29913>
_______________________________________

From report at bugs.python.org  Mon Mar 27 06:48:20 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Mon, 27 Mar 2017 10:48:20 +0000
Subject: [docs] [issue29913] ipadress compare_networks does not work
 according to documentation
In-Reply-To: <1490599415.99.0.717154213111.issue29913@psf.upfronthosting.co.za>
Message-ID: <1490611700.87.0.0675714305324.issue29913@psf.upfronthosting.co.za>


Xiang Zhang added the comment:

+1 for the doc change.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29913>
_______________________________________

From report at bugs.python.org  Mon Mar 27 07:11:36 2017
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 27 Mar 2017 11:11:36 +0000
Subject: [docs] [issue21071] struct.Struct.format is bytes, but should be str
In-Reply-To: <1395856133.5.0.672707015318.issue21071@psf.upfronthosting.co.za>
Message-ID: <1490613096.52.0.370684208265.issue21071@psf.upfronthosting.co.za>


Changes by STINNER Victor <victor.stinner at gmail.com>:


----------
pull_requests: +743

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue21071>
_______________________________________

From report at bugs.python.org  Mon Mar 27 07:14:00 2017
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 27 Mar 2017 11:14:00 +0000
Subject: [docs] [issue21071] struct.Struct.format is bytes, but should be str
In-Reply-To: <1395856133.5.0.672707015318.issue21071@psf.upfronthosting.co.za>
Message-ID: <1490613240.64.0.0175429067557.issue21071@psf.upfronthosting.co.za>


STINNER Victor added the comment:

I created https://github.com/python/cpython/pull/845 to change struct.Struct.format type to str (Unicode).

struct.Struct() accepts bytes and str format strings, so it's not really a backward incompatible change.

It's just a minor enhancement to help development:

$ ./python
Python 3.7.0a0 (heads/master-dirty:b8a7daf, Mar 27 2017, 13:02:20) 
>>> print(struct.Struct('hi').format)
hi


Without the patch:

haypo at selma$ python3
Python 3.5.2 (default, Sep 14 2016, 11:28:32) 
[GCC 6.2.1 20160901 (Red Hat 6.2.1-1)] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import struct
>>> print(struct.Struct('hi').format)
b'hi'

haypo at selma$ python3 -bb
Python 3.5.2 (default, Sep 14 2016, 11:28:32) 
>>> import struct
>>> print(struct.Struct('hi').format)
Traceback (most recent call last):
  ...
BytesWarning: str() on a bytes instance

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue21071>
_______________________________________

From report at bugs.python.org  Mon Mar 27 07:30:46 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 27 Mar 2017 11:30:46 +0000
Subject: [docs] [issue29918] Missed "const" modifiers in C API documentation
Message-ID: <1490614245.98.0.401745534622.issue29918@psf.upfronthosting.co.za>


New submission from Serhiy Storchaka:

Proposed patch adds missed "const" modifiers in C API documentation.

----------
assignee: docs at python
components: Documentation
messages: 290588
nosy: docs at python, serhiy.storchaka
priority: normal
severity: normal
stage: patch review
status: open
title: Missed "const" modifiers in C API documentation
type: enhancement
versions: Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29918>
_______________________________________

From report at bugs.python.org  Mon Mar 27 07:32:10 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 27 Mar 2017 11:32:10 +0000
Subject: [docs] [issue29918] Missed "const" modifiers in C API documentation
In-Reply-To: <1490614245.98.0.401745534622.issue29918@psf.upfronthosting.co.za>
Message-ID: <1490614330.66.0.998161382992.issue29918@psf.upfronthosting.co.za>


Changes by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
pull_requests: +744

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29918>
_______________________________________

From report at bugs.python.org  Mon Mar 27 07:55:22 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 27 Mar 2017 11:55:22 +0000
Subject: [docs] [issue21071] struct.Struct.format is bytes, but should be str
In-Reply-To: <1395856133.5.0.672707015318.issue21071@psf.upfronthosting.co.za>
Message-ID: <1490615722.03.0.653776273444.issue21071@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

This should be discussed on Python-Dev first. I already raised this issue on Python-Dev, but don't remember what is the result.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue21071>
_______________________________________

From report at bugs.python.org  Mon Mar 27 07:55:52 2017
From: report at bugs.python.org (Martin Panter)
Date: Mon, 27 Mar 2017 11:55:52 +0000
Subject: [docs] [issue21071] struct.Struct.format is bytes, but should be str
In-Reply-To: <1395856133.5.0.672707015318.issue21071@psf.upfronthosting.co.za>
Message-ID: <1490615751.98.0.0951145779815.issue21071@psf.upfronthosting.co.za>


Martin Panter added the comment:

Hi Victor, I?m not sure about changing the data type. As Python 3 grows older, there is potentially more code being written that you break by fixing a bug like this. It is incompatible if you used to write

>>> print(struct.Struct('hi').format.decode())
hi

I have used this decode() trick in the past to build composite format strings; e.g.: <https://bugs.python.org/issue16349#msg174083>. If you change the data type this code will raise AttributeError. At a minimum you should acknowledge it in the ?porting? section of What?s New.

Also, if you make this change, maybe update the module doc string. See the end of format-str.patch.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue21071>
_______________________________________

From C.Partin at ferndalecs.com  Mon Mar 27 04:35:23 2017
From: C.Partin at ferndalecs.com (Chris Partin)
Date: Mon, 27 Mar 2017 08:35:23 +0000
Subject: [docs] Next iteration
Message-ID: <E6F18C0D924D0142A6E81A0BAC33477202A36B2B@EXCHANGE.FERNDALE.MSR.EDU>

Hi I'm using the latest python idle and as an old school linux/unix user feel it would be a good addition if when in the idle I could press the up arrow to get the last command I typed in.

Thanks
Chris


________________________________

This email and any files transmitted with it are confidential and intended solely for the use of the individual or entity to whom they are addressed. If you have received this email in error please notify the system manager. This message contains confidential information and is intended only for the individual named. If you are not the named addressee you should not disseminate, distribute or copy this e-mail. Please notify the sender immediately by e-mail if you have received this e-mail by mistake and delete this e-mail from your system. If you are not the intended recipient you are notified that disclosing, copying, distributing or taking any action in reliance on the contents of this information is strictly prohibited.

________________________________
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170327/10c8e753/attachment.html>

From Primrose.Mbanefo at arm.com  Wed Mar 22 08:51:47 2017
From: Primrose.Mbanefo at arm.com (Primrose Mbanefo)
Date: Wed, 22 Mar 2017 12:51:47 +0000
Subject: [docs] links broken (as of march 22 2017 at 12:46 UKtime)
Message-ID: <568F0908-A512-4232-B75A-689B886A1D15@arm.com>

Hello,

Sorry I don?t know if you have a bug report system for the documentation (New to python).
The page I am on points to this email address!

Details:

1)       I was on page: https://docs.python.org/3/download.html (I got here from the download link in https://docs.python.org/3/)


2)       And clicked on the HTML link which says it goes to: https://docs.python.org/3/archives/python-3.6.1-docs-html.zip
That link is broken (404).

3)       There is an existing link to: https://docs.python.org/3/archives/python-3.6.1rc1-docs-html.zip which could be the correct link.

Thanks!

Primrose Mbanefo

----
ARM Limited, 110 Fulbourn Road, Cambridge CB1 9NJ, UK
IMPORTANT NOTICE: The contents of this email and any attachments are confidential and may also be privileged. If you are not the intended recipient, please notify the sender immediately and do not disclose the contents to any other person, use it for any purpose, or store or copy the information in any medium. Thank you.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170322/4494e8c8/attachment-0001.html>

From report at bugs.python.org  Mon Mar 27 08:10:13 2017
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 27 Mar 2017 12:10:13 +0000
Subject: [docs] [issue29918] Missed "const" modifiers in C API documentation
In-Reply-To: <1490614245.98.0.401745534622.issue29918@psf.upfronthosting.co.za>
Message-ID: <1490616613.51.0.437777249487.issue29918@psf.upfronthosting.co.za>


Changes by STINNER Victor <victor.stinner at gmail.com>:


----------
nosy: +haypo

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29918>
_______________________________________

From report at bugs.python.org  Mon Mar 27 08:14:46 2017
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 27 Mar 2017 12:14:46 +0000
Subject: [docs] [issue21071] struct.Struct.format is bytes, but should be str
In-Reply-To: <1490615751.98.0.0951145779815.issue21071@psf.upfronthosting.co.za>
Message-ID: <CAMpsgwaedFCDUMZt3ST5Cp=k3m3UoezUtDDW334mH9NJmsnURw@mail.gmail.com>


STINNER Victor added the comment:

Ok, I opened a thread on python-dev:
https://mail.python.org/pipermail/python-dev/2017-March/147688.html

Martin: "At a minimum you should acknowledge it in the ?porting?
section of What?s New."

I wasn't sure if the change was worth it to be mentionned in What's
New in Python 3.7. Ok, will do for the next round (I'm now waiting for
more feedback on my python-dev thread and this issue.)

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue21071>
_______________________________________

From report at bugs.python.org  Mon Mar 27 08:57:26 2017
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 27 Mar 2017 12:57:26 +0000
Subject: [docs] [issue29893] create_subprocess_exec doc doesn't match
 software
In-Reply-To: <1490332817.83.0.92510042207.issue29893@psf.upfronthosting.co.za>
Message-ID: <1490619446.28.0.990895370912.issue29893@psf.upfronthosting.co.za>


STINNER Victor added the comment:

Ah, I wrote "def create_subprocess_exec(program, *args," to implicitly check that args is non empty.

We can either change the function prototype to check that args is non-empty in the body, or just update the documentation.

The documentation is not exactly wrong :-)

----------
nosy: +haypo

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29893>
_______________________________________

From report at bugs.python.org  Mon Mar 27 09:16:49 2017
From: report at bugs.python.org (Xavier Morel)
Date: Mon, 27 Mar 2017 13:16:49 +0000
Subject: [docs] [issue29920] Document cgitb.text and cgitb.html
Message-ID: <1490620609.02.0.405950190914.issue29920@psf.upfronthosting.co.za>


New submission from Xavier Morel:

Currently, cgitb documents the hook (enable) and somewhat unclearly the ability to dump the HTML traceback to stdout, but despite that being technically available it does not document the ability to dump the traceback to a string as either text or html.

Possible further improvement: make ``cgitb.html`` and ``cgitb.text`` implicitly call `sys.exc_info()` if not given a parameter (much like `cgitb.handler` does).

----------
assignee: docs at python
components: Documentation
messages: 290608
nosy: docs at python, xmorel
priority: normal
pull_requests: 747
severity: normal
status: open
title: Document cgitb.text and cgitb.html
type: enhancement
versions: Python 2.7, Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29920>
_______________________________________

From report at bugs.python.org  Mon Mar 27 09:49:48 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 27 Mar 2017 13:49:48 +0000
Subject: [docs] [issue29920] Document cgitb.text and cgitb.html
In-Reply-To: <1490620609.02.0.405950190914.issue29920@psf.upfronthosting.co.za>
Message-ID: <1490622588.57.0.731690678668.issue29920@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
versions: +Python 3.5

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29920>
_______________________________________

From report at bugs.python.org  Mon Mar 27 09:57:38 2017
From: report at bugs.python.org (Xavier Morel)
Date: Mon, 27 Mar 2017 13:57:38 +0000
Subject: [docs] [issue29920] Document cgitb.text and cgitb.html
In-Reply-To: <1490620609.02.0.405950190914.issue29920@psf.upfronthosting.co.za>
Message-ID: <1490623058.23.0.617936684043.issue29920@psf.upfronthosting.co.za>


Xavier Morel added the comment:

PR targetted to master rather than 2.7

----------
pull_requests: +748

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29920>
_______________________________________

From report at bugs.python.org  Mon Mar 27 09:57:49 2017
From: report at bugs.python.org (Xavier Morel)
Date: Mon, 27 Mar 2017 13:57:49 +0000
Subject: [docs] [issue29920] Document cgitb.text and cgitb.html
In-Reply-To: <1490620609.02.0.405950190914.issue29920@psf.upfronthosting.co.za>
Message-ID: <1490623069.42.0.213517463253.issue29920@psf.upfronthosting.co.za>


Changes by Xavier Morel <xavier.morel at masklinn.net>:


----------
pull_requests:  -747

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29920>
_______________________________________

From report at bugs.python.org  Mon Mar 27 10:16:39 2017
From: report at bugs.python.org (Barry A. Warsaw)
Date: Mon, 27 Mar 2017 14:16:39 +0000
Subject: [docs] [issue19824] string.Template: Rewrite docs to emphasize i18n
 use case
In-Reply-To: <1385658424.56.0.963803246137.issue19824@psf.upfronthosting.co.za>
Message-ID: <1490624199.97.0.361848704838.issue19824@psf.upfronthosting.co.za>


Changes by Barry A. Warsaw <barry at python.org>:


----------
assignee: docs at python -> barry

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue19824>
_______________________________________

From report at bugs.python.org  Mon Mar 27 10:17:15 2017
From: report at bugs.python.org (Barry A. Warsaw)
Date: Mon, 27 Mar 2017 14:17:15 +0000
Subject: [docs] [issue19824] string.Template: Rewrite docs to emphasize i18n
 use case
In-Reply-To: <1385658424.56.0.963803246137.issue19824@psf.upfronthosting.co.za>
Message-ID: <1490624235.08.0.829626995041.issue19824@psf.upfronthosting.co.za>


Barry A. Warsaw added the comment:

I'll take this one, and see if I can address 20314 also.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue19824>
_______________________________________

From report at bugs.python.org  Mon Mar 27 13:21:15 2017
From: report at bugs.python.org (R. David Murray)
Date: Mon, 27 Mar 2017 17:21:15 +0000
Subject: [docs] [issue29506] Incorrect documentation for the copy module
In-Reply-To: <1486591364.1.0.297030175166.issue29506@psf.upfronthosting.co.za>
Message-ID: <1490635275.44.0.393733970721.issue29506@psf.upfronthosting.co.za>


R. David Murray added the comment:

Looking over the PR, and especially in the context of Serhiy's point about this being about 'deep copy' and not 'deepcopy', I think this would be clearer if it were shortened even further, to just:

"Because deep copy copies everything, it may copy data that is intended to be shared between copies."

After all, what deepcopy does it provide a way for a class to implement that sharing when a deepcopy is done.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29506>
_______________________________________

From report at bugs.python.org  Mon Mar 27 14:37:15 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 27 Mar 2017 18:37:15 +0000
Subject: [docs] [issue29917] Wrong link target in PyMethodDef documentation
In-Reply-To: <1490610672.62.0.617621215351.issue29917@psf.upfronthosting.co.za>
Message-ID: <1490639835.68.0.581695851649.issue29917@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

Agree. I noticed this when making a review of PR 831, but forgot to open an issue.

----------
nosy: +serhiy.storchaka
stage:  -> needs patch
type:  -> behavior
versions: +Python 2.7, Python 3.5, Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29917>
_______________________________________

From report at bugs.python.org  Mon Mar 27 16:54:00 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Mon, 27 Mar 2017 20:54:00 +0000
Subject: [docs] [issue29677] clarify docs about 'round()' accepting a
 negative integer for ndigits
In-Reply-To: <1488285024.25.0.0499728148151.issue29677@psf.upfronthosting.co.za>
Message-ID: <1490648040.24.0.330500347208.issue29677@psf.upfronthosting.co.za>


Cheryl Sabella added the comment:

I'm new to contributing.  Can I work on this one?

----------
nosy: +csabella

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29677>
_______________________________________

From report at bugs.python.org  Mon Mar 27 17:19:01 2017
From: report at bugs.python.org (Jim Fasarakis-Hilliard)
Date: Mon, 27 Mar 2017 21:19:01 +0000
Subject: [docs] [issue29251] Class __dict__ is only a mapping proxy
In-Reply-To: <1484222660.7.0.65822313324.issue29251@psf.upfronthosting.co.za>
Message-ID: <1490649541.0.0.672979234268.issue29251@psf.upfronthosting.co.za>


Jim Fasarakis-Hilliard added the comment:

Isn't the fact that it's read-only a CPython implementation detail? That is, shouldn't that just read: 

"gives a :term:`mapping` object representing the class's namespace"

so as to not enforce anything on any other implementations?

----------
nosy: +Jim Fasarakis-Hilliard

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29251>
_______________________________________

From report at bugs.python.org  Mon Mar 27 17:39:51 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 27 Mar 2017 21:39:51 +0000
Subject: [docs] [issue29677] clarify docs about 'round()' accepting a
 negative integer for ndigits
In-Reply-To: <1488285024.25.0.0499728148151.issue29677@psf.upfronthosting.co.za>
Message-ID: <1490650791.31.0.938038082632.issue29677@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
versions: +Python 2.7, Python 3.5, Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29677>
_______________________________________

From report at bugs.python.org  Mon Mar 27 18:15:22 2017
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 27 Mar 2017 22:15:22 +0000
Subject: [docs] [issue29677] clarify docs about 'round()' accepting a
 negative integer for ndigits
In-Reply-To: <1488285024.25.0.0499728148151.issue29677@psf.upfronthosting.co.za>
Message-ID: <1490652922.56.0.140987705024.issue29677@psf.upfronthosting.co.za>


STINNER Victor added the comment:


New changeset 6003db7db5fec545c01923c198a5fdfca5a91538 by Victor Stinner (Gerrit Holl) in branch 'master':
bpo-29677: DOC: clarify documentation for `round` (#357)
https://github.com/python/cpython/commit/6003db7db5fec545c01923c198a5fdfca5a91538


----------
nosy: +haypo

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29677>
_______________________________________

From report at bugs.python.org  Mon Mar 27 18:22:16 2017
From: report at bugs.python.org (Barry A. Warsaw)
Date: Mon, 27 Mar 2017 22:22:16 +0000
Subject: [docs] [issue20314] Potentially confusing formulation in 6.1.4.
 Template	strings
In-Reply-To: <1390237853.97.0.751678212058.issue20314@psf.upfronthosting.co.za>
Message-ID: <1490653336.93.0.882586745863.issue20314@psf.upfronthosting.co.za>


Changes by Barry A. Warsaw <barry at python.org>:


----------
assignee: docs at python -> barry

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue20314>
_______________________________________

From report at bugs.python.org  Mon Mar 27 18:36:40 2017
From: report at bugs.python.org (Barry A. Warsaw)
Date: Mon, 27 Mar 2017 22:36:40 +0000
Subject: [docs] [issue19824] string.Template: Rewrite docs to emphasize i18n
 use case
In-Reply-To: <1385658424.56.0.963803246137.issue19824@psf.upfronthosting.co.za>
Message-ID: <1490654200.52.0.808049838241.issue19824@psf.upfronthosting.co.za>


Changes by Barry A. Warsaw <barry at python.org>:


----------
pull_requests: +758

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue19824>
_______________________________________

From report at bugs.python.org  Mon Mar 27 18:36:40 2017
From: report at bugs.python.org (Barry A. Warsaw)
Date: Mon, 27 Mar 2017 22:36:40 +0000
Subject: [docs] [issue20314] Potentially confusing formulation in 6.1.4.
 Template	strings
In-Reply-To: <1390237853.97.0.751678212058.issue20314@psf.upfronthosting.co.za>
Message-ID: <1490654200.61.0.463051705696.issue20314@psf.upfronthosting.co.za>


Changes by Barry A. Warsaw <barry at python.org>:


----------
pull_requests: +759

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue20314>
_______________________________________

From report at bugs.python.org  Mon Mar 27 18:42:13 2017
From: report at bugs.python.org (Martin Panter)
Date: Mon, 27 Mar 2017 22:42:13 +0000
Subject: [docs] [issue4928] tempfile.NamedTemporaryFile: automatic cleanup
 by OS
In-Reply-To: <1231838566.25.0.143957228078.issue4928@psf.upfronthosting.co.za>
Message-ID: <1490654533.17.0.331351528515.issue4928@psf.upfronthosting.co.za>


Changes by Martin Panter <vadmium+py at gmail.com>:


----------
title: Problem with tempfile.NamedTemporaryFile -> tempfile.NamedTemporaryFile: automatic cleanup by OS

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue4928>
_______________________________________

From report at bugs.python.org  Mon Mar 27 18:56:31 2017
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 27 Mar 2017 22:56:31 +0000
Subject: [docs] [issue23890] assertRaises increases reference counter
In-Reply-To: <1428518225.53.0.665360255509.issue23890@psf.upfronthosting.co.za>
Message-ID: <1490655391.25.0.790974861867.issue23890@psf.upfronthosting.co.za>


STINNER Victor added the comment:


New changeset bbd3cf8f1ef1e91a8d6dac6411e18b4b9084abf5 by Victor Stinner in branch 'master':
Fix ref cycles in TestCase.assertRaises() (#193)
https://github.com/python/cpython/commit/bbd3cf8f1ef1e91a8d6dac6411e18b4b9084abf5


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue23890>
_______________________________________

From report at bugs.python.org  Mon Mar 27 18:57:43 2017
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 27 Mar 2017 22:57:43 +0000
Subject: [docs] [issue23890] assertRaises increases reference counter
In-Reply-To: <1428518225.53.0.665360255509.issue23890@psf.upfronthosting.co.za>
Message-ID: <1490655463.82.0.687759669528.issue23890@psf.upfronthosting.co.za>


Changes by STINNER Victor <victor.stinner at gmail.com>:


----------
pull_requests: +761

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue23890>
_______________________________________

From report at bugs.python.org  Mon Mar 27 19:04:57 2017
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 27 Mar 2017 23:04:57 +0000
Subject: [docs] [issue23890] assertRaises increases reference counter
In-Reply-To: <1428518225.53.0.665360255509.issue23890@psf.upfronthosting.co.za>
Message-ID: <1490655897.94.0.287592814655.issue23890@psf.upfronthosting.co.za>


STINNER Victor added the comment:

It seems like Python 2.7 is not affected.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue23890>
_______________________________________

From report at bugs.python.org  Mon Mar 27 19:55:01 2017
From: report at bugs.python.org (Martin Panter)
Date: Mon, 27 Mar 2017 23:55:01 +0000
Subject: [docs] [issue29251] Class __dict__ is only a mapping proxy
In-Reply-To: <1484222660.7.0.65822313324.issue29251@psf.upfronthosting.co.za>
Message-ID: <1490658901.67.0.441477256355.issue29251@psf.upfronthosting.co.za>


Martin Panter added the comment:

I don?t know if it is an implementation detail or not. Maybe it is the documentation itself which defines that. Anyway, I think your wording would have been fine for my original problem.

I wonder if we should clarify that only reading the mapping is supported, even if we don?t define any particular behaviour for modifying it (like updating the namespace, raising an exception, ignoring the change, etc).

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29251>
_______________________________________

From report at bugs.python.org  Mon Mar 27 19:56:38 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 27 Mar 2017 23:56:38 +0000
Subject: [docs] [issue29677] clarify docs about 'round()' accepting a
 negative integer for ndigits
In-Reply-To: <1488285024.25.0.0499728148151.issue29677@psf.upfronthosting.co.za>
Message-ID: <1490658998.78.0.702462146947.issue29677@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +762

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29677>
_______________________________________

From report at bugs.python.org  Mon Mar 27 19:57:16 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 27 Mar 2017 23:57:16 +0000
Subject: [docs] [issue29677] clarify docs about 'round()' accepting a
 negative integer for ndigits
In-Reply-To: <1488285024.25.0.0499728148151.issue29677@psf.upfronthosting.co.za>
Message-ID: <1490659036.56.0.13398011778.issue29677@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +763

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29677>
_______________________________________

From report at bugs.python.org  Mon Mar 27 20:02:32 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 28 Mar 2017 00:02:32 +0000
Subject: [docs] [issue29677] clarify docs about 'round()' accepting a
 negative integer for ndigits
In-Reply-To: <1488285024.25.0.0499728148151.issue29677@psf.upfronthosting.co.za>
Message-ID: <1490659351.97.0.862689914937.issue29677@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 596506216104613591218c2896cdb49fa0b7e5bb by Mariatta in branch '3.6':
bpo-29677: DOC: clarify documentation for `round` (GH-357) (GH-862)
https://github.com/python/cpython/commit/596506216104613591218c2896cdb49fa0b7e5bb


----------
nosy: +Mariatta

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29677>
_______________________________________

From report at bugs.python.org  Mon Mar 27 20:09:23 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 28 Mar 2017 00:09:23 +0000
Subject: [docs] [issue29677] clarify docs about 'round()' accepting a
 negative integer for ndigits
In-Reply-To: <1488285024.25.0.0499728148151.issue29677@psf.upfronthosting.co.za>
Message-ID: <1490659763.49.0.303474732866.issue29677@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 8994f36287b068e8ea9a9230fc90eda72bf5fff0 by Mariatta in branch '3.5':
bpo-29677: DOC: clarify documentation for `round` (GH-357) (GH-863)
https://github.com/python/cpython/commit/8994f36287b068e8ea9a9230fc90eda72bf5fff0


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29677>
_______________________________________

From report at bugs.python.org  Mon Mar 27 20:19:46 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 28 Mar 2017 00:19:46 +0000
Subject: [docs] [issue29677] clarify docs about 'round()' accepting a
 negative integer for ndigits
In-Reply-To: <1488285024.25.0.0499728148151.issue29677@psf.upfronthosting.co.za>
Message-ID: <1490660386.18.0.449316900204.issue29677@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Cheryl, thank you for your interest in working on this issue.

The original issue has been addressed in Gerrit Holl's PR. But it seems like the docs can be further improved.

Here is Victor's comment about it: (copied from GH-357)

```
while we are modifying the doc, I dislike the start: "Return the floating point value number": number can be an integer. round(123, -2) doesn't use floating point numbers. Maybe rephrase to following text?

Return number rounded to (...). number can be an integer or a floating point number.

Or just remove "floating pointer number"?
```

Will you be interested in preparing a PR to address Victor's comment above?

Thanks :)

----------
stage:  -> needs patch
versions:  -Python 2.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29677>
_______________________________________

From report at bugs.python.org  Mon Mar 27 20:22:06 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 28 Mar 2017 00:22:06 +0000
Subject: [docs] [issue29677] clarify docs about 'round()' accepting a
 negative integer for ndigits
In-Reply-To: <1488285024.25.0.0499728148151.issue29677@psf.upfronthosting.co.za>
Message-ID: <1490660525.95.0.452663116797.issue29677@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

GH-357 is:
https://github.com/python/cpython/pull/357/files

:)

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29677>
_______________________________________

From report at bugs.python.org  Mon Mar 27 23:38:25 2017
From: report at bugs.python.org (Sanjay)
Date: Tue, 28 Mar 2017 03:38:25 +0000
Subject: [docs] [issue29913] ipadress compare_networks does not work
 according to documentation
In-Reply-To: <1490599415.99.0.717154213111.issue29913@psf.upfronthosting.co.za>
Message-ID: <1490672305.71.0.330182803962.issue29913@psf.upfronthosting.co.za>


Sanjay added the comment:

ok I will update the doc

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29913>
_______________________________________

From report at bugs.python.org  Tue Mar 28 01:07:33 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 28 Mar 2017 05:07:33 +0000
Subject: [docs] [issue29928] Add f-strings to Glossary
Message-ID: <1490677653.09.0.270979437774.issue29928@psf.upfronthosting.co.za>


New submission from Mariatta Wijaya:

The Glossary section should mention f-strings, starting in Python 3.6.

----------
assignee: docs at python
components: Documentation
messages: 290682
nosy: Mariatta, docs at python
priority: normal
severity: normal
status: open
title: Add f-strings to Glossary
versions: Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29928>
_______________________________________

From report at bugs.python.org  Tue Mar 28 01:09:27 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 28 Mar 2017 05:09:27 +0000
Subject: [docs] [issue29928] Add f-strings to Glossary
In-Reply-To: <1490677653.09.0.270979437774.issue29928@psf.upfronthosting.co.za>
Message-ID: <1490677767.25.0.482514260843.issue29928@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +764

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29928>
_______________________________________

From report at bugs.python.org  Tue Mar 28 01:18:51 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 28 Mar 2017 05:18:51 +0000
Subject: [docs] [issue29928] Add f-strings to Glossary
In-Reply-To: <1490677653.09.0.270979437774.issue29928@psf.upfronthosting.co.za>
Message-ID: <1490678331.83.0.816867546355.issue29928@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29928>
_______________________________________

From report at bugs.python.org  Tue Mar 28 01:39:18 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 28 Mar 2017 05:39:18 +0000
Subject: [docs] [issue29928] Add f-strings to Glossary
In-Reply-To: <1490677653.09.0.270979437774.issue29928@psf.upfronthosting.co.za>
Message-ID: <1490679558.81.0.264680467931.issue29928@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

"f-string" is widely used, but misleading term. It is not used in the documentation. But "formatted string literal" is not better. This isn't literal, this isn't special kind of strings, this is a special formatting expression resulting to string.

There was a discussion on Python-Dev about better term, but it didn't come to any conclusion.

----------
nosy: +serhiy.storchaka

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29928>
_______________________________________

From report at bugs.python.org  Tue Mar 28 01:49:04 2017
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 28 Mar 2017 05:49:04 +0000
Subject: [docs] [issue29913] ipadress compare_networks does not work
 according to documentation
In-Reply-To: <1490599415.99.0.717154213111.issue29913@psf.upfronthosting.co.za>
Message-ID: <1490680144.72.0.0721536161901.issue29913@psf.upfronthosting.co.za>


Changes by Roundup Robot <devnull at psf.upfronthosting.co.za>:


----------
pull_requests: +765

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29913>
_______________________________________

From report at bugs.python.org  Tue Mar 28 03:07:24 2017
From: report at bugs.python.org (Martin Panter)
Date: Tue, 28 Mar 2017 07:07:24 +0000
Subject: [docs] [issue29928] Add f-strings to Glossary
In-Reply-To: <1490677653.09.0.270979437774.issue29928@psf.upfronthosting.co.za>
Message-ID: <1490684844.36.0.115779519104.issue29928@psf.upfronthosting.co.za>


Martin Panter added the comment:

When I wrote the documentation <https://docs.python.org/dev/reference/lexical_analysis.html#f-strings>, I think I tried to avoid ?f-string?, being jargon, and used more formal terminology from PEP 498 instead. But I agree they more than regular literals.

Serhiy do you have a link/message-id/etc of the Python-dev discussion? All I found with Google was <https://www.reddit.com/r/Python/comments/3k969r/lets_find_a_better_name_for_fstrings/>. One other goal is to differentiate these from other formatted strings, such as from str.format and percent formatting.

* formatted strings (doesn?t differentiate from str.format, etc)
* string interpolations
* string expressions
* string comprehensions (apparently too far removed from set comprehensions)
* Maybe format(ted) string displays? (parallelling list etc displays)

----------
nosy: +martin.panter

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29928>
_______________________________________

From report at bugs.python.org  Tue Mar 28 03:22:37 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 28 Mar 2017 07:22:37 +0000
Subject: [docs] [issue29928] Add f-strings to Glossary
In-Reply-To: <1490677653.09.0.270979437774.issue29928@psf.upfronthosting.co.za>
Message-ID: <1490685757.72.0.767333177399.issue29928@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

I don't have a link. There were a lot of threads about this feature and I didn't follow them. After implementing PEP 498 there was a discussion about terminology.

I read discussions about coming and released Python 3.6 on StackOverflow, Reddit and other resources and seen a lot of misinterpretation due to using terms "string" and "literal".

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29928>
_______________________________________

From report at bugs.python.org  Tue Mar 28 06:13:49 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Tue, 28 Mar 2017 10:13:49 +0000
Subject: [docs] [issue29677] clarify docs about 'round()' accepting a
 negative integer for ndigits
In-Reply-To: <1488285024.25.0.0499728148151.issue29677@psf.upfronthosting.co.za>
Message-ID: <1490696029.77.0.285222979843.issue29677@psf.upfronthosting.co.za>


Cheryl Sabella added the comment:

Mariatta,

Yes, thank you, I will work on a pull request to address Victor's comment.  Since it's my first time, I hope to read through the contributing docs and get this done today or tomorrow.

Thank you!

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29677>
_______________________________________

From report at bugs.python.org  Tue Mar 28 06:53:05 2017
From: report at bugs.python.org (Jim Fasarakis-Hilliard)
Date: Tue, 28 Mar 2017 10:53:05 +0000
Subject: [docs] [issue29928] Add f-strings to Glossary
In-Reply-To: <1490677653.09.0.270979437774.issue29928@psf.upfronthosting.co.za>
Message-ID: <1490698385.41.0.0682429785983.issue29928@psf.upfronthosting.co.za>


Jim Fasarakis-Hilliard added the comment:

It's odd how 'f-string' just caught on when byte, raw and unicode strings never really did (at least I personally don't see many people using b-string, r-string and u-string respectively).

Shouldn't an entry for them be made too if 'f-string' would be added?

As for the name used by everyone, you can't blame them, f-string is a term used throughout PEP 498.

I guess a a new discussion might be warranted where people can decide if a new term should be thought of or if the negative effects of using the current aren't all that bad.

----------
nosy: +Jim Fasarakis-Hilliard

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29928>
_______________________________________

From report at bugs.python.org  Tue Mar 28 09:18:58 2017
From: report at bugs.python.org (R. David Murray)
Date: Tue, 28 Mar 2017 13:18:58 +0000
Subject: [docs] [issue29928] Add f-strings to Glossary
In-Reply-To: <1490677653.09.0.270979437774.issue29928@psf.upfronthosting.co.za>
Message-ID: <1490707138.17.0.952925477376.issue29928@psf.upfronthosting.co.za>


R. David Murray added the comment:

"raw" and "byte" are one syllable names, and thus as easy and more meaningful to say than "r-string" or "b-string".  "unicode string" is more descriptive and not much longer, but "u-string" does occasionally get used, though mostly in a python3 context where you want to differentiate it from normal unadorned unicode strings.  If you want to replace 'f-string' in the vernacular, you need a one or two syllable word that is descriptive.  The only real candidate is "format string", and we already use that for the older types of format strings.  If those were to fall out of use, I'd expect "format string" to come to mean what f-string does now.  But by the time that happens, f-string will be more entrenched than it is now.  We could try for "format expression", but that is more syllables, and faces headwind because the f prefix obviously makes it a "string"-like object, and that's how we think about it: a string with expressions inside it, instead of as an expression itself.

In summary, I think we're stuck with f-string.  It's a term of art: a short expression that encapsulates a non-trivial concept for which there are no precise existing words.

----------
nosy: +r.david.murray

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29928>
_______________________________________

From report at bugs.python.org  Tue Mar 28 09:18:59 2017
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 28 Mar 2017 13:18:59 +0000
Subject: [docs] [issue29933] asyncio: set_write_buffer_limits() doc doesn't
 specify unit of the parameters
Message-ID: <1490707139.27.0.838851028066.issue29933@psf.upfronthosting.co.za>


New submission from STINNER Victor:

The asyncio set_write_buffer_limits() documentation doesn't specify unit of high and low parameters. Moreover, it would to explain better the effect of high and low:

* pause_writing() is called when the buffer size becomes larger or equal to high
* (if writing is pause) resume_writing() is called when the buffer size becomes smaller or equal to low

----------
assignee: docs at python
components: Documentation, asyncio
keywords: easy
messages: 290712
nosy: docs at python, haypo, yselivanov
priority: normal
severity: normal
status: open
title: asyncio: set_write_buffer_limits() doc doesn't specify unit of the parameters
versions: Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29933>
_______________________________________

From report at bugs.python.org  Tue Mar 28 09:19:24 2017
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 28 Mar 2017 13:19:24 +0000
Subject: [docs] [issue29933] asyncio: set_write_buffer_limits() doc doesn't
 specify unit of the parameters
In-Reply-To: <1490707139.27.0.838851028066.issue29933@psf.upfronthosting.co.za>
Message-ID: <1490707164.69.0.253427453326.issue29933@psf.upfronthosting.co.za>


STINNER Victor added the comment:

See also https://github.com/asyncio-doc/asyncio-doc/issues/17 for a more general documentation request on asyncio parameters (on the external asyncio doc).

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29933>
_______________________________________

From report at bugs.python.org  Tue Mar 28 09:55:57 2017
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 28 Mar 2017 13:55:57 +0000
Subject: [docs] [issue29933] asyncio: set_write_buffer_limits() doc doesn't
 specify unit of the parameters
In-Reply-To: <1490707139.27.0.838851028066.issue29933@psf.upfronthosting.co.za>
Message-ID: <1490709357.9.0.374904890943.issue29933@psf.upfronthosting.co.za>


STINNER Victor added the comment:

It would also be nice to:

* link to set_write_buffer_limits() from drain()
* link to set_write_buffer_limits() from pause_writing() / resume_writing()
* mention asyncio default values for set_write_buffer_limits(): low=16 kB, high=64 kB (kb? kib? i never know :-/)

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29933>
_______________________________________

From report at bugs.python.org  Tue Mar 28 10:02:09 2017
From: report at bugs.python.org (Barry A. Warsaw)
Date: Tue, 28 Mar 2017 14:02:09 +0000
Subject: [docs] [issue19824] string.Template: Rewrite docs to emphasize i18n
 use case
In-Reply-To: <1385658424.56.0.963803246137.issue19824@psf.upfronthosting.co.za>
Message-ID: <1490709729.23.0.0530626353071.issue19824@psf.upfronthosting.co.za>


Barry A. Warsaw added the comment:


New changeset 9f74deba784fc8781d13ed564f69c02ed7c331bb by Barry Warsaw in branch 'master':
Improve the documentation for template strings (#856)
https://github.com/python/cpython/commit/9f74deba784fc8781d13ed564f69c02ed7c331bb


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue19824>
_______________________________________

From report at bugs.python.org  Tue Mar 28 10:02:09 2017
From: report at bugs.python.org (Barry A. Warsaw)
Date: Tue, 28 Mar 2017 14:02:09 +0000
Subject: [docs] [issue20314] Potentially confusing formulation in 6.1.4.
 Template	strings
In-Reply-To: <1390237853.97.0.751678212058.issue20314@psf.upfronthosting.co.za>
Message-ID: <1490709729.56.0.184421759101.issue20314@psf.upfronthosting.co.za>


Barry A. Warsaw added the comment:


New changeset 9f74deba784fc8781d13ed564f69c02ed7c331bb by Barry Warsaw in branch 'master':
Improve the documentation for template strings (#856)
https://github.com/python/cpython/commit/9f74deba784fc8781d13ed564f69c02ed7c331bb


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue20314>
_______________________________________

From report at bugs.python.org  Tue Mar 28 10:04:19 2017
From: report at bugs.python.org (Barry A. Warsaw)
Date: Tue, 28 Mar 2017 14:04:19 +0000
Subject: [docs] [issue19824] string.Template: Rewrite docs to emphasize i18n
 use case
In-Reply-To: <1385658424.56.0.963803246137.issue19824@psf.upfronthosting.co.za>
Message-ID: <1490709859.6.0.456148516449.issue19824@psf.upfronthosting.co.za>


Changes by Barry A. Warsaw <barry at python.org>:


----------
resolution:  -> fixed
stage: needs patch -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue19824>
_______________________________________

From report at bugs.python.org  Tue Mar 28 10:04:34 2017
From: report at bugs.python.org (Barry A. Warsaw)
Date: Tue, 28 Mar 2017 14:04:34 +0000
Subject: [docs] [issue20314] Potentially confusing formulation in 6.1.4.
 Template	strings
In-Reply-To: <1390237853.97.0.751678212058.issue20314@psf.upfronthosting.co.za>
Message-ID: <1490709874.07.0.0871746193888.issue20314@psf.upfronthosting.co.za>


Changes by Barry A. Warsaw <barry at python.org>:


----------
resolution:  -> fixed
stage:  -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue20314>
_______________________________________

From report at bugs.python.org  Tue Mar 28 10:04:40 2017
From: report at bugs.python.org (Barry A. Warsaw)
Date: Tue, 28 Mar 2017 14:04:40 +0000
Subject: [docs] [issue20314] Potentially confusing formulation in 6.1.4.
 Template	strings
In-Reply-To: <1390237853.97.0.751678212058.issue20314@psf.upfronthosting.co.za>
Message-ID: <1490709880.83.0.617944500043.issue20314@psf.upfronthosting.co.za>


Changes by Barry A. Warsaw <barry at python.org>:


----------
versions: +Python 3.7 -Python 2.7, Python 3.3, Python 3.4

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue20314>
_______________________________________

From report at bugs.python.org  Tue Mar 28 10:13:04 2017
From: report at bugs.python.org (R. David Murray)
Date: Tue, 28 Mar 2017 14:13:04 +0000
Subject: [docs] [issue16011] "in" should be consistent with return value of
 __contains__
In-Reply-To: <1348445631.47.0.961273834435.issue16011@psf.upfronthosting.co.za>
Message-ID: <1490710383.88.0.861075956607.issue16011@psf.upfronthosting.co.za>


R. David Murray added the comment:


New changeset 0ae7c8bd614d3aa1fcaf2d71a10ff1148c80d9b5 by R. David Murray (Amit Kumar) in branch 'master':
bpo-16011 clarify that 'in' always returns a boolean value
https://github.com/python/cpython/commit/0ae7c8bd614d3aa1fcaf2d71a10ff1148c80d9b5


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue16011>
_______________________________________

From report at bugs.python.org  Tue Mar 28 10:21:15 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 28 Mar 2017 14:21:15 +0000
Subject: [docs] [issue29928] Add f-strings to Glossary
In-Reply-To: <1490677653.09.0.270979437774.issue29928@psf.upfronthosting.co.za>
Message-ID: <1490710875.63.0.182901856506.issue29928@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

The abstract of PEP 498 states:
```
In this PEP, such strings will be referred to as "f-strings", taken from the leading character used to denote such strings, and standing for "formatted strings".
```

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29928>
_______________________________________

From report at bugs.python.org  Tue Mar 28 10:27:23 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 28 Mar 2017 14:27:23 +0000
Subject: [docs] [issue16011] "in" should be consistent with return value of
 __contains__
In-Reply-To: <1348445631.47.0.961273834435.issue16011@psf.upfronthosting.co.za>
Message-ID: <1490711243.9.0.429944130461.issue16011@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +772

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue16011>
_______________________________________

From report at bugs.python.org  Tue Mar 28 10:27:54 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 28 Mar 2017 14:27:54 +0000
Subject: [docs] [issue16011] "in" should be consistent with return value of
 __contains__
In-Reply-To: <1348445631.47.0.961273834435.issue16011@psf.upfronthosting.co.za>
Message-ID: <1490711274.22.0.939466753536.issue16011@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +773

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue16011>
_______________________________________

From report at bugs.python.org  Tue Mar 28 10:33:09 2017
From: report at bugs.python.org (R. David Murray)
Date: Tue, 28 Mar 2017 14:33:09 +0000
Subject: [docs] [issue10379] locale.format() input regression
In-Reply-To: <1289345606.99.0.972407204822.issue10379@psf.upfronthosting.co.za>
Message-ID: <1490711589.64.0.158799017967.issue10379@psf.upfronthosting.co.za>


Changes by R. David Murray <rdmurray at bitdance.com>:


----------
stage: needs patch -> backport needed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue10379>
_______________________________________

From report at bugs.python.org  Tue Mar 28 10:41:35 2017
From: report at bugs.python.org (R. David Murray)
Date: Tue, 28 Mar 2017 14:41:35 +0000
Subject: [docs] [issue10379] locale.format() input regression
In-Reply-To: <1289345606.99.0.972407204822.issue10379@psf.upfronthosting.co.za>
Message-ID: <1490712095.55.0.71138607002.issue10379@psf.upfronthosting.co.za>


Changes by R. David Murray <rdmurray at bitdance.com>:


----------
stage: backport needed -> needs patch

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue10379>
_______________________________________

From report at bugs.python.org  Tue Mar 28 10:42:00 2017
From: report at bugs.python.org (R. David Murray)
Date: Tue, 28 Mar 2017 14:42:00 +0000
Subject: [docs] [issue16011] "in" should be consistent with return value of
 __contains__
In-Reply-To: <1348445631.47.0.961273834435.issue16011@psf.upfronthosting.co.za>
Message-ID: <1490712120.32.0.881427458144.issue16011@psf.upfronthosting.co.za>


R. David Murray added the comment:

Thanks,

----------
stage: patch review -> backport needed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue16011>
_______________________________________

From report at bugs.python.org  Tue Mar 28 11:43:40 2017
From: report at bugs.python.org (R. David Murray)
Date: Tue, 28 Mar 2017 15:43:40 +0000
Subject: [docs] [issue10379] locale.format() input regression
In-Reply-To: <1289345606.99.0.972407204822.issue10379@psf.upfronthosting.co.za>
Message-ID: <1490715820.72.0.448164766179.issue10379@psf.upfronthosting.co.za>


R. David Murray added the comment:


New changeset 1cf93a76c2cf307f2e1e514a8944864f746337ea by R. David Murray (Garvit Khatri) in branch 'master':
bpo-10379: add 'monetary' to format_string, deprecate format
https://github.com/python/cpython/commit/1cf93a76c2cf307f2e1e514a8944864f746337ea


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue10379>
_______________________________________

From report at bugs.python.org  Tue Mar 28 11:46:37 2017
From: report at bugs.python.org (R. David Murray)
Date: Tue, 28 Mar 2017 15:46:37 +0000
Subject: [docs] [issue10379] locale.format() input regression
In-Reply-To: <1289345606.99.0.972407204822.issue10379@psf.upfronthosting.co.za>
Message-ID: <1490715997.59.0.963500049532.issue10379@psf.upfronthosting.co.za>


R. David Murray added the comment:

Oops.  I merged the patch without coming back here first :(.  Still getting used to the new workflow.

It turns out that format has a parameter, monetary, that isn't supported by format_string.  So what we did was add that parameter to format_string and deprecate format.

If there is objection to this solution I will revert the merge.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue10379>
_______________________________________

From report at bugs.python.org  Tue Mar 28 12:22:32 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Tue, 28 Mar 2017 16:22:32 +0000
Subject: [docs] [issue29677] clarify docs about 'round()' accepting a
 negative integer for ndigits
In-Reply-To: <1488285024.25.0.0499728148151.issue29677@psf.upfronthosting.co.za>
Message-ID: <1490718152.84.0.277721756446.issue29677@psf.upfronthosting.co.za>


Changes by Cheryl Sabella <chekat2 at gmail.com>:


----------
pull_requests: +776

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29677>
_______________________________________

From report at bugs.python.org  Tue Mar 28 12:32:53 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 28 Mar 2017 16:32:53 +0000
Subject: [docs] [issue16011] "in" should be consistent with return value of
 __contains__
In-Reply-To: <1348445631.47.0.961273834435.issue16011@psf.upfronthosting.co.za>
Message-ID: <1490718773.04.0.904637085514.issue16011@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 0957f262c5e47167efd520624557aebdc61bfda8 by Mariatta in branch '3.5':
bpo-16011: clarify that 'in' always returns a boolean value (GH-152) (GH-875)
https://github.com/python/cpython/commit/0957f262c5e47167efd520624557aebdc61bfda8


----------
nosy: +Mariatta

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue16011>
_______________________________________

From report at bugs.python.org  Tue Mar 28 12:33:57 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 28 Mar 2017 16:33:57 +0000
Subject: [docs] [issue16011] "in" should be consistent with return value of
 __contains__
In-Reply-To: <1348445631.47.0.961273834435.issue16011@psf.upfronthosting.co.za>
Message-ID: <1490718837.42.0.60729474513.issue16011@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset c4021af50526f488c0c280e7c7eaa83ef80ae1df by Mariatta in branch '3.6':
bpo-16011: clarify that 'in' always returns a boolean value (GH-874)
https://github.com/python/cpython/commit/c4021af50526f488c0c280e7c7eaa83ef80ae1df


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue16011>
_______________________________________

From report at bugs.python.org  Tue Mar 28 12:50:13 2017
From: report at bugs.python.org (paul j3)
Date: Tue, 28 Mar 2017 16:50:13 +0000
Subject: [docs] [issue22049] argparse: type=<callable> doesn't honor nargs >
 1
In-Reply-To: <1406135782.37.0.476079892774.issue22049@psf.upfronthosting.co.za>
Message-ID: <1490719813.98.0.835602100992.issue22049@psf.upfronthosting.co.za>


Changes by paul j3 <ajipanca at gmail.com>:


----------
resolution:  -> not a bug
stage: needs patch -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue22049>
_______________________________________

From report at bugs.python.org  Tue Mar 28 13:09:08 2017
From: report at bugs.python.org (paul j3)
Date: Tue, 28 Mar 2017 17:09:08 +0000
Subject: [docs] [issue23487] argparse: add_subparsers 'action' broken
In-Reply-To: <1424417043.22.0.71313795028.issue23487@psf.upfronthosting.co.za>
Message-ID: <1490720948.42.0.29445693249.issue23487@psf.upfronthosting.co.za>


paul j3 added the comment:

I'm going to close this.  At most it calls for a documentation change.  But saying something like

   It must be compatible with argparse._SubParsersAction.

will just confuse the average user.  Any customization of this action class is an advanced topic, that requires familiarity with the code, not just the documentation.

----------
resolution:  -> rejected
stage:  -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue23487>
_______________________________________

From report at bugs.python.org  Tue Mar 28 15:50:37 2017
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 28 Mar 2017 19:50:37 +0000
Subject: [docs] [issue29928] Add f-strings to Glossary
In-Reply-To: <1490677653.09.0.270979437774.issue29928@psf.upfronthosting.co.za>
Message-ID: <1490730637.91.0.596064547763.issue29928@psf.upfronthosting.co.za>


Brett Cannon added the comment:

I think we're getting bogged down in a larger scope than this issue is about. All we should be discussing in this issue is whether adding an entry in the glossary for "f-string" as it's already being used in the community is bad (which I don't think it is since it's seeing use "in the wild"). No one is suggesting we change all the documentation to start using the shorthand/slang term, nor to introduce entries for other types of string literals where the community has not started using such terms (e.g. r-strings for raw strings). Heck, the docs already use "f-string" internally as a link target, i.e. https://docs.python.org/3/reference/lexical_analysis.html#f-strings (notice the intra-page link target).

IOW this is just making it easier for someone who comes across the term "f-string" to know what it means when they see it on e.g. Twitter, not trying to come up with a more accurate shorthand.

----------
nosy: +brett.cannon

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29928>
_______________________________________

From report at bugs.python.org  Tue Mar 28 16:12:46 2017
From: report at bugs.python.org (R. David Murray)
Date: Tue, 28 Mar 2017 20:12:46 +0000
Subject: [docs] [issue29928] Add f-strings to Glossary
In-Reply-To: <1490677653.09.0.270979437774.issue29928@psf.upfronthosting.co.za>
Message-ID: <1490731966.08.0.552105344112.issue29928@psf.upfronthosting.co.za>


R. David Murray added the comment:

Agreed with Brett.  What I was trying to say was that we aren't going to get people to change to a different term, nor are the other 'x-string' abbreviations interesting, so we should document just f-string. But I wasn't exactly clear that that was my point :).

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29928>
_______________________________________

From report at bugs.python.org  Tue Mar 28 17:05:05 2017
From: report at bugs.python.org (Jim Fasarakis-Hilliard)
Date: Tue, 28 Mar 2017 21:05:05 +0000
Subject: [docs] [issue29928] Add f-strings to Glossary
In-Reply-To: <1490677653.09.0.270979437774.issue29928@psf.upfronthosting.co.za>
Message-ID: <1490735105.62.0.234946452439.issue29928@psf.upfronthosting.co.za>


Jim Fasarakis-Hilliard added the comment:

I was probably misunderstood, too, in hindsight, it's my fault for not being more clear :-). 

In my first sentence I was merely pointing out the oddity of <prefix>-string not being a very popular term until f-string came along.

As for my second sentence (adding the other prefixed strings to the glossary) I was thinking of using the names people currently use. Entries for (byte|raw|unicode)-strings, seeing as they don't already exist, might be a good addition now that f-strings are up for inclusion.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29928>
_______________________________________

From report at bugs.python.org  Tue Mar 28 17:28:39 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 28 Mar 2017 21:28:39 +0000
Subject: [docs] [issue29928] Add f-strings to Glossary
In-Reply-To: <1490677653.09.0.270979437774.issue29928@psf.upfronthosting.co.za>
Message-ID: <1490736519.6.0.966362505886.issue29928@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Since this ticket is about adding f-strings to the Glossary, let's keep this as discussions about the inclusion of f-strings in the Glossary.

If others want to add (byte|raw|unicode)-strings into the Glossary, they can open another ticket. 

Thanks :)

P.S: I like David's quote "..f-string. It's a term of art"

----------
assignee: docs at python -> Mariatta

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29928>
_______________________________________

From report at bugs.python.org  Tue Mar 28 17:32:20 2017
From: report at bugs.python.org (Jim Fasarakis-Hilliard)
Date: Tue, 28 Mar 2017 21:32:20 +0000
Subject: [docs] [issue29928] Add f-strings to Glossary
In-Reply-To: <1490677653.09.0.270979437774.issue29928@psf.upfronthosting.co.za>
Message-ID: <1490736740.24.0.471876632724.issue29928@psf.upfronthosting.co.za>


Jim Fasarakis-Hilliard added the comment:

Completely agree, Mariatta. I just wanted to clarify my initial position :-)

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29928>
_______________________________________

From report at bugs.python.org  Tue Mar 28 21:20:11 2017
From: report at bugs.python.org (Kinebuchi Tomohiko)
Date: Wed, 29 Mar 2017 01:20:11 +0000
Subject: [docs] [issue19225] lack of PyExc_BufferError doc
In-Reply-To: <1381485777.95.0.364414099437.issue19225@psf.upfronthosting.co.za>
Message-ID: <1490750411.52.0.0381876675142.issue19225@psf.upfronthosting.co.za>


Kinebuchi Tomohiko added the comment:

I will create a pull request based on the patch created by beng94.
In addition, I will have its contents up-to-date.

----------
versions: +Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue19225>
_______________________________________

From report at bugs.python.org  Tue Mar 28 21:26:19 2017
From: report at bugs.python.org (Kinebuchi Tomohiko)
Date: Wed, 29 Mar 2017 01:26:19 +0000
Subject: [docs] [issue19225] lack of PyExc_BufferError doc
In-Reply-To: <1381485777.95.0.364414099437.issue19225@psf.upfronthosting.co.za>
Message-ID: <1490750779.84.0.247190347329.issue19225@psf.upfronthosting.co.za>


Changes by Kinebuchi Tomohiko <cocoatomo77 at gmail.com>:


----------
pull_requests: +783

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue19225>
_______________________________________

From report at bugs.python.org  Wed Mar 29 00:10:48 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 29 Mar 2017 04:10:48 +0000
Subject: [docs] [issue16011] "in" should be consistent with return value of
 __contains__
In-Reply-To: <1348445631.47.0.961273834435.issue16011@psf.upfronthosting.co.za>
Message-ID: <1490760648.59.0.474730841548.issue16011@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +785

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue16011>
_______________________________________

From report at bugs.python.org  Wed Mar 29 06:19:00 2017
From: report at bugs.python.org (Louie Lu)
Date: Wed, 29 Mar 2017 10:19:00 +0000
Subject: [docs] [issue28415] PyUnicode_FromFormat integer format handling
 different from printf about zeropad
In-Reply-To: <1476176180.11.0.398413685253.issue28415@psf.upfronthosting.co.za>
Message-ID: <1490782740.51.0.0223643922655.issue28415@psf.upfronthosting.co.za>


Changes by Louie Lu <me at louie.lu>:


----------
pull_requests: +787

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28415>
_______________________________________

From report at bugs.python.org  Wed Mar 29 06:20:21 2017
From: report at bugs.python.org (Louie Lu)
Date: Wed, 29 Mar 2017 10:20:21 +0000
Subject: [docs] [issue28415] PyUnicode_FromFormat integer format handling
 different from printf about zeropad
In-Reply-To: <1476176180.11.0.398413685253.issue28415@psf.upfronthosting.co.za>
Message-ID: <1490782821.15.0.711079174905.issue28415@psf.upfronthosting.co.za>


Louie Lu added the comment:

Add a note block under Py*_FromFormat in unicode.rst and bytes.rst.

Could Xiang or Terry help to review? Thanks.

----------
nosy: +louielu

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28415>
_______________________________________

From report at bugs.python.org  Wed Mar 29 06:54:32 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Wed, 29 Mar 2017 10:54:32 +0000
Subject: [docs] [issue28415] PyUnicode_FromFormat integer format handling
 different from printf about zeropad
In-Reply-To: <1476176180.11.0.398413685253.issue28415@psf.upfronthosting.co.za>
Message-ID: <1490784872.56.0.655416591896.issue28415@psf.upfronthosting.co.za>


Changes by Xiang Zhang <angwerzx at 126.com>:


----------
versions: +Python 2.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28415>
_______________________________________

From report at bugs.python.org  Wed Mar 29 17:10:17 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 29 Mar 2017 21:10:17 +0000
Subject: [docs] [issue16011] "in" should be consistent with return value of
 __contains__
In-Reply-To: <1348445631.47.0.961273834435.issue16011@psf.upfronthosting.co.za>
Message-ID: <1490821816.62.0.721328992278.issue16011@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset fd704a02ca8713b0dae644f7f182f3e3d1218dbf by Mariatta in branch '2.7':
bpo-16011: clarify that 'in' always returns a boolean value (GH-152) (GH-883)
https://github.com/python/cpython/commit/fd704a02ca8713b0dae644f7f182f3e3d1218dbf


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue16011>
_______________________________________

From report at bugs.python.org  Wed Mar 29 17:12:55 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 29 Mar 2017 21:12:55 +0000
Subject: [docs] [issue16011] "in" should be consistent with return value of
 __contains__
In-Reply-To: <1348445631.47.0.961273834435.issue16011@psf.upfronthosting.co.za>
Message-ID: <1490821975.77.0.523240357075.issue16011@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Thanks everyone :) Patch has been merged and backported to 3.6, 3.5, and 2.7.

----------
resolution:  -> fixed
stage: backport needed -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue16011>
_______________________________________

From report at bugs.python.org  Wed Mar 29 17:14:09 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 29 Mar 2017 21:14:09 +0000
Subject: [docs] [issue29677] clarify docs about 'round()' accepting a
 negative integer for ndigits
In-Reply-To: <1488285024.25.0.0499728148151.issue29677@psf.upfronthosting.co.za>
Message-ID: <1490822049.08.0.19373492614.issue29677@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 85deefcf61d3cc192846f41a4ccc6df17da60c98 by Mariatta (csabella) in branch 'master':
bpo-29677: DOC: clarify documentation for `round` (GH-877)
https://github.com/python/cpython/commit/85deefcf61d3cc192846f41a4ccc6df17da60c98


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29677>
_______________________________________

From report at bugs.python.org  Wed Mar 29 17:15:20 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 29 Mar 2017 21:15:20 +0000
Subject: [docs] [issue29677] clarify docs about 'round()' accepting a
 negative integer for ndigits
In-Reply-To: <1488285024.25.0.0499728148151.issue29677@psf.upfronthosting.co.za>
Message-ID: <1490822120.09.0.0836359569256.issue29677@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
stage: needs patch -> backport needed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29677>
_______________________________________

From report at bugs.python.org  Wed Mar 29 18:29:32 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Wed, 29 Mar 2017 22:29:32 +0000
Subject: [docs] [issue29677] clarify docs about 'round()' accepting a
 negative integer for ndigits
In-Reply-To: <1488285024.25.0.0499728148151.issue29677@psf.upfronthosting.co.za>
Message-ID: <1490826572.84.0.414520073485.issue29677@psf.upfronthosting.co.za>


Cheryl Sabella added the comment:

Mariatta,

Thank you so much for your support and encouragement while I worked on my first PR.  You've made this an awesome experience!

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29677>
_______________________________________

From report at bugs.python.org  Wed Mar 29 19:56:32 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Wed, 29 Mar 2017 23:56:32 +0000
Subject: [docs] [issue29917] Wrong link target in PyMethodDef documentation
In-Reply-To: <1490610672.62.0.617621215351.issue29917@psf.upfronthosting.co.za>
Message-ID: <1490831792.24.0.390954342987.issue29917@psf.upfronthosting.co.za>


Cheryl Sabella added the comment:

I am working on a pull request for this issue.

----------
nosy: +csabella

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29917>
_______________________________________

From report at bugs.python.org  Wed Mar 29 20:14:02 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 30 Mar 2017 00:14:02 +0000
Subject: [docs] [issue29917] Wrong link target in PyMethodDef documentation
In-Reply-To: <1490610672.62.0.617621215351.issue29917@psf.upfronthosting.co.za>
Message-ID: <1490832841.8.0.360859967374.issue29917@psf.upfronthosting.co.za>


Changes by Cheryl Sabella <chekat2 at gmail.com>:


----------
pull_requests: +792

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29917>
_______________________________________

From report at bugs.python.org  Wed Mar 29 20:14:03 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 30 Mar 2017 00:14:03 +0000
Subject: [docs] [issue29917] Wrong link target in PyMethodDef documentation
In-Reply-To: <1490610672.62.0.617621215351.issue29917@psf.upfronthosting.co.za>
Message-ID: <1490832843.01.0.479813344159.issue29917@psf.upfronthosting.co.za>


Changes by Cheryl Sabella <chekat2 at gmail.com>:


----------
pull_requests: +792, 793

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29917>
_______________________________________

From report at bugs.python.org  Wed Mar 29 20:27:52 2017
From: report at bugs.python.org (Senthil Kumaran)
Date: Thu, 30 Mar 2017 00:27:52 +0000
Subject: [docs] [issue29917] Wrong link target in PyMethodDef documentation
In-Reply-To: <1490610672.62.0.617621215351.issue29917@psf.upfronthosting.co.za>
Message-ID: <1490833672.5.0.549992995933.issue29917@psf.upfronthosting.co.za>


Senthil Kumaran added the comment:


New changeset c3c7ef088583cc12bd218138036d1edb6de9c63f by Senthil Kumaran (csabella) in branch 'master':
bpo-29917: DOC: Remove link from PyMethodDef (#890)
https://github.com/python/cpython/commit/c3c7ef088583cc12bd218138036d1edb6de9c63f


----------
nosy: +orsenthil

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29917>
_______________________________________

From report at bugs.python.org  Wed Mar 29 20:28:51 2017
From: report at bugs.python.org (Senthil Kumaran)
Date: Thu, 30 Mar 2017 00:28:51 +0000
Subject: [docs] [issue29917] Wrong link target in PyMethodDef documentation
In-Reply-To: <1490610672.62.0.617621215351.issue29917@psf.upfronthosting.co.za>
Message-ID: <1490833731.46.0.354063012995.issue29917@psf.upfronthosting.co.za>


Changes by Senthil Kumaran <senthil at uthcode.com>:


----------
stage: needs patch -> backport needed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29917>
_______________________________________

From report at bugs.python.org  Wed Mar 29 22:05:12 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 30 Mar 2017 02:05:12 +0000
Subject: [docs] [issue29677] clarify docs about 'round()' accepting a
 negative integer for ndigits
In-Reply-To: <1488285024.25.0.0499728148151.issue29677@psf.upfronthosting.co.za>
Message-ID: <1490839512.5.0.803832439484.issue29677@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +795

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29677>
_______________________________________

From report at bugs.python.org  Wed Mar 29 22:05:31 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 30 Mar 2017 02:05:31 +0000
Subject: [docs] [issue29677] clarify docs about 'round()' accepting a
 negative integer for ndigits
In-Reply-To: <1488285024.25.0.0499728148151.issue29677@psf.upfronthosting.co.za>
Message-ID: <1490839531.91.0.06442664942.issue29677@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +796

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29677>
_______________________________________

From report at bugs.python.org  Wed Mar 29 22:10:09 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 30 Mar 2017 02:10:09 +0000
Subject: [docs] [issue29677] clarify docs about 'round()' accepting a
 negative integer for ndigits
In-Reply-To: <1488285024.25.0.0499728148151.issue29677@psf.upfronthosting.co.za>
Message-ID: <1490839809.64.0.556665203609.issue29677@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 2609c9ee78c53d501914a5a90dbe094d9a8c3c97 by Mariatta in branch '3.6':
bpo-29677: DOC: clarify documentation for `round` (GH-877) (GH-892)
https://github.com/python/cpython/commit/2609c9ee78c53d501914a5a90dbe094d9a8c3c97


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29677>
_______________________________________

From report at bugs.python.org  Wed Mar 29 22:10:24 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 30 Mar 2017 02:10:24 +0000
Subject: [docs] [issue29677] clarify docs about 'round()' accepting a
 negative integer for ndigits
In-Reply-To: <1488285024.25.0.0499728148151.issue29677@psf.upfronthosting.co.za>
Message-ID: <1490839824.85.0.580831506487.issue29677@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset eef6e11f9883f54de491121b8c49fdadd3e3506d by Mariatta in branch '3.5':
bpo-29677: DOC: clarify documentation for `round` (GH-877) (GH-893)
https://github.com/python/cpython/commit/eef6e11f9883f54de491121b8c49fdadd3e3506d


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29677>
_______________________________________

From report at bugs.python.org  Wed Mar 29 22:16:02 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 30 Mar 2017 02:16:02 +0000
Subject: [docs] [issue29677] clarify docs about 'round()' accepting a
 negative integer for ndigits
In-Reply-To: <1488285024.25.0.0499728148151.issue29677@psf.upfronthosting.co.za>
Message-ID: <1490840162.12.0.361565396319.issue29677@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Gerrit, Cheryl, thanks and congrats for your first contributions to CPython!

They've been merged and backported to 3.5 and 3.6.
So I'm closing this now.

Thanks all :)

----------
resolution:  -> fixed
stage: backport needed -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29677>
_______________________________________

From report at bugs.python.org  Thu Mar 30 01:20:12 2017
From: report at bugs.python.org (Senthil Kumaran)
Date: Thu, 30 Mar 2017 05:20:12 +0000
Subject: [docs] [issue29917] Wrong link target in PyMethodDef documentation
In-Reply-To: <1490610672.62.0.617621215351.issue29917@psf.upfronthosting.co.za>
Message-ID: <1490851212.41.0.181873084374.issue29917@psf.upfronthosting.co.za>


Changes by Senthil Kumaran <senthil at uthcode.com>:


----------
pull_requests: +797

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29917>
_______________________________________

From report at bugs.python.org  Thu Mar 30 01:20:40 2017
From: report at bugs.python.org (Senthil Kumaran)
Date: Thu, 30 Mar 2017 05:20:40 +0000
Subject: [docs] [issue29917] Wrong link target in PyMethodDef documentation
In-Reply-To: <1490610672.62.0.617621215351.issue29917@psf.upfronthosting.co.za>
Message-ID: <1490851240.81.0.111988975338.issue29917@psf.upfronthosting.co.za>


Changes by Senthil Kumaran <senthil at uthcode.com>:


----------
pull_requests: +798

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29917>
_______________________________________

From report at bugs.python.org  Thu Mar 30 01:21:41 2017
From: report at bugs.python.org (Senthil Kumaran)
Date: Thu, 30 Mar 2017 05:21:41 +0000
Subject: [docs] [issue29917] Wrong link target in PyMethodDef documentation
In-Reply-To: <1490610672.62.0.617621215351.issue29917@psf.upfronthosting.co.za>
Message-ID: <1490851301.54.0.637545042199.issue29917@psf.upfronthosting.co.za>


Changes by Senthil Kumaran <senthil at uthcode.com>:


----------
pull_requests: +799

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29917>
_______________________________________

From report at bugs.python.org  Thu Mar 30 01:29:02 2017
From: report at bugs.python.org (Senthil Kumaran)
Date: Thu, 30 Mar 2017 05:29:02 +0000
Subject: [docs] [issue29917] Wrong link target in PyMethodDef documentation
In-Reply-To: <1490610672.62.0.617621215351.issue29917@psf.upfronthosting.co.za>
Message-ID: <1490851742.87.0.336283460485.issue29917@psf.upfronthosting.co.za>


Senthil Kumaran added the comment:


New changeset da6ad2f780d187fbfdea330d1037766ae7bdb778 by Senthil Kumaran in branch '3.6':
bpo-29917: DOC: Remove link from PyMethodDef (#890) (#894)
https://github.com/python/cpython/commit/da6ad2f780d187fbfdea330d1037766ae7bdb778


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29917>
_______________________________________

From report at bugs.python.org  Thu Mar 30 01:29:08 2017
From: report at bugs.python.org (Senthil Kumaran)
Date: Thu, 30 Mar 2017 05:29:08 +0000
Subject: [docs] [issue29917] Wrong link target in PyMethodDef documentation
In-Reply-To: <1490610672.62.0.617621215351.issue29917@psf.upfronthosting.co.za>
Message-ID: <1490851748.75.0.665138927496.issue29917@psf.upfronthosting.co.za>


Senthil Kumaran added the comment:


New changeset d1dbbaab01354f01faa696aff1280db3b349e354 by Senthil Kumaran in branch '3.5':
bpo-29917: DOC: Remove link from PyMethodDef (#890) (#895)
https://github.com/python/cpython/commit/d1dbbaab01354f01faa696aff1280db3b349e354


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29917>
_______________________________________

From report at bugs.python.org  Thu Mar 30 01:29:14 2017
From: report at bugs.python.org (Senthil Kumaran)
Date: Thu, 30 Mar 2017 05:29:14 +0000
Subject: [docs] [issue29917] Wrong link target in PyMethodDef documentation
In-Reply-To: <1490610672.62.0.617621215351.issue29917@psf.upfronthosting.co.za>
Message-ID: <1490851754.64.0.743330371558.issue29917@psf.upfronthosting.co.za>


Senthil Kumaran added the comment:


New changeset 3ceca68741f8a2d3a4436b6d54eae76aa5bcc4c5 by Senthil Kumaran in branch '2.7':
bpo-29917: DOC: Remove link from PyMethodDef (#890) (#896)
https://github.com/python/cpython/commit/3ceca68741f8a2d3a4436b6d54eae76aa5bcc4c5


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29917>
_______________________________________

From report at bugs.python.org  Thu Mar 30 01:30:26 2017
From: report at bugs.python.org (Senthil Kumaran)
Date: Thu, 30 Mar 2017 05:30:26 +0000
Subject: [docs] [issue29917] Wrong link target in PyMethodDef documentation
In-Reply-To: <1490610672.62.0.617621215351.issue29917@psf.upfronthosting.co.za>
Message-ID: <1490851826.35.0.526168534531.issue29917@psf.upfronthosting.co.za>


Changes by Senthil Kumaran <senthil at uthcode.com>:


----------
resolution:  -> fixed
stage: backport needed -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29917>
_______________________________________

From report at bugs.python.org  Thu Mar 30 01:53:52 2017
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 30 Mar 2017 05:53:52 +0000
Subject: [docs] [issue22392] Clarify documentation of __getinitargs__
In-Reply-To: <1410461552.96.0.589396040073.issue22392@psf.upfronthosting.co.za>
Message-ID: <1490853232.17.0.871696398076.issue22392@psf.upfronthosting.co.za>


Changes by Roundup Robot <devnull at psf.upfronthosting.co.za>:


----------
pull_requests: +800

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue22392>
_______________________________________

From report at bugs.python.org  Thu Mar 30 01:55:45 2017
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 30 Mar 2017 05:55:45 +0000
Subject: [docs] [issue22392] Clarify documentation of __getinitargs__
In-Reply-To: <1410461552.96.0.589396040073.issue22392@psf.upfronthosting.co.za>
Message-ID: <1490853345.41.0.463177215703.issue22392@psf.upfronthosting.co.za>


Changes by Roundup Robot <devnull at psf.upfronthosting.co.za>:


----------
pull_requests: +801

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue22392>
_______________________________________

From report at bugs.python.org  Thu Mar 30 02:07:11 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 30 Mar 2017 06:07:11 +0000
Subject: [docs] [issue22392] Clarify documentation of __getinitargs__
In-Reply-To: <1410461552.96.0.589396040073.issue22392@psf.upfronthosting.co.za>
Message-ID: <1490854031.89.0.0702871117191.issue22392@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

See more detailed description in PEP 307.

----------
nosy: +serhiy.storchaka
stage: needs patch -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue22392>
_______________________________________

From report at bugs.python.org  Thu Mar 30 02:08:02 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 30 Mar 2017 06:08:02 +0000
Subject: [docs] [issue22392] Clarify documentation of __getinitargs__
In-Reply-To: <1410461552.96.0.589396040073.issue22392@psf.upfronthosting.co.za>
Message-ID: <1490854082.62.0.446269739364.issue22392@psf.upfronthosting.co.za>


Changes by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
nosy: +alexandre.vassalotti

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue22392>
_______________________________________

From report at bugs.python.org  Thu Mar 30 03:01:05 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 30 Mar 2017 07:01:05 +0000
Subject: [docs] [issue29918] Missed "const" modifiers in C API documentation
In-Reply-To: <1490614245.98.0.401745534622.issue29918@psf.upfronthosting.co.za>
Message-ID: <1490857265.15.0.98142380838.issue29918@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:


New changeset 84b8e92e463bd6a5174bd3e5a6543580f6319c57 by Serhiy Storchaka in branch 'master':
bpo-29918: Add missed "const" modifiers in C API documentation. (#846)
https://github.com/python/cpython/commit/84b8e92e463bd6a5174bd3e5a6543580f6319c57


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29918>
_______________________________________

From report at bugs.python.org  Thu Mar 30 03:01:39 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 30 Mar 2017 07:01:39 +0000
Subject: [docs] [issue29918] Missed "const" modifiers in C API documentation
In-Reply-To: <1490614245.98.0.401745534622.issue29918@psf.upfronthosting.co.za>
Message-ID: <1490857299.5.0.693787672153.issue29918@psf.upfronthosting.co.za>


Changes by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29918>
_______________________________________

From report at bugs.python.org  Thu Mar 30 03:44:31 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Thu, 30 Mar 2017 07:44:31 +0000
Subject: [docs] [issue29913] ipadress compare_networks does not work
 according to documentation
In-Reply-To: <1490599415.99.0.717154213111.issue29913@psf.upfronthosting.co.za>
Message-ID: <1490859871.42.0.210579443949.issue29913@psf.upfronthosting.co.za>


Xiang Zhang added the comment:


New changeset 16f852345bcdec1bbb15e5363fad6b33bf960912 by Xiang Zhang (s-sanjay) in branch 'master':
bpo-29913: deprecate compare_networks() in documentation (GH-865)
https://github.com/python/cpython/commit/16f852345bcdec1bbb15e5363fad6b33bf960912


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29913>
_______________________________________

From report at bugs.python.org  Thu Mar 30 03:45:06 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Thu, 30 Mar 2017 07:45:06 +0000
Subject: [docs] [issue29913] ipadress compare_networks does not work
 according to documentation
In-Reply-To: <1490599415.99.0.717154213111.issue29913@psf.upfronthosting.co.za>
Message-ID: <1490859906.66.0.588444961497.issue29913@psf.upfronthosting.co.za>


Changes by Xiang Zhang <angwerzx at 126.com>:


----------
resolution:  -> fixed
stage: needs patch -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29913>
_______________________________________

From report at bugs.python.org  Thu Mar 30 10:20:23 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 30 Mar 2017 14:20:23 +0000
Subject: [docs] [issue29725] sqlite3.Cursor doesn't properly document
 "arraysize"
In-Reply-To: <1488732449.69.0.822466282685.issue29725@psf.upfronthosting.co.za>
Message-ID: <1490883623.62.0.919339863123.issue29725@psf.upfronthosting.co.za>


Cheryl Sabella added the comment:

I wanted to try to work on the documentation for this, but I had some questions.

I looked at:
https://github.com/python/cpython/blob/master/Modules/_sqlite/cursor.c

And I don't see arraysize being set to anything other than 1.  I also don't see fetchall using it like the documentation says.  fetchmany does seem to be using the size sent in as an argument or using the arraysize (which is 1) to break out of the loop early, so the default behaviour appears to be the similar to fetchone.  Please take this all with the caveat that I don't know c, so I may be missing something really obvious.  But, I can see all the other cursor attributes being changed within this module, so I expected arraysize to work in a similar way.

I did find this website which has a definition of arraysize:
http://initd.org/psycopg/docs/cursor.html#cursor.arraysize

Sorry if this is too many questions.  I've just started trying to help with documentation issues and I may have gotten in over my head.

----------
nosy: +csabella

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29725>
_______________________________________

From report at bugs.python.org  Thu Mar 30 15:12:20 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 30 Mar 2017 19:12:20 +0000
Subject: [docs] [issue29928] Add f-strings to Glossary
In-Reply-To: <1490677653.09.0.270979437774.issue29928@psf.upfronthosting.co.za>
Message-ID: <1490901140.48.0.369851949586.issue29928@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 33db068dac7686e37736f7ecf8abb2aee0345cf2 by Mariatta in branch 'master':
bpo-29928: Add f-string to the Glossary (GH-864)
https://github.com/python/cpython/commit/33db068dac7686e37736f7ecf8abb2aee0345cf2


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29928>
_______________________________________

From report at bugs.python.org  Thu Mar 30 15:15:17 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 30 Mar 2017 19:15:17 +0000
Subject: [docs] [issue29928] Add f-strings to Glossary
In-Reply-To: <1490677653.09.0.270979437774.issue29928@psf.upfronthosting.co.za>
Message-ID: <1490901317.8.0.993475444448.issue29928@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +814

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29928>
_______________________________________

From report at bugs.python.org  Thu Mar 30 15:27:21 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 30 Mar 2017 19:27:21 +0000
Subject: [docs] [issue29928] Add f-strings to Glossary
In-Reply-To: <1490677653.09.0.270979437774.issue29928@psf.upfronthosting.co.za>
Message-ID: <1490902041.92.0.293907383118.issue29928@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 7b5b1379ac2c1e89ebf90b88b5d32457910e975e by Mariatta in branch '3.6':
bpo-29928: Add f-string to the Glossary (GH-864) (GH-914)
https://github.com/python/cpython/commit/7b5b1379ac2c1e89ebf90b88b5d32457910e975e


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29928>
_______________________________________

From report at bugs.python.org  Thu Mar 30 15:30:42 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 30 Mar 2017 19:30:42 +0000
Subject: [docs] [issue29928] Add f-strings to Glossary
In-Reply-To: <1490677653.09.0.270979437774.issue29928@psf.upfronthosting.co.za>
Message-ID: <1490902242.5.0.914105593394.issue29928@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Thanks all!

----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29928>
_______________________________________

From report at bugs.python.org  Thu Mar 30 15:51:35 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 30 Mar 2017 19:51:35 +0000
Subject: [docs] [issue29751] PyLong_FromString documentation wrong on
 numbers with leading zero and base=0
In-Reply-To: <1488922068.27.0.463542328186.issue29751@psf.upfronthosting.co.za>
Message-ID: <1490903495.79.0.148911468896.issue29751@psf.upfronthosting.co.za>


Changes by Cheryl Sabella <chekat2 at gmail.com>:


----------
pull_requests: +815

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29751>
_______________________________________

From report at bugs.python.org  Thu Mar 30 15:52:32 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 30 Mar 2017 19:52:32 +0000
Subject: [docs] [issue29751] PyLong_FromString documentation wrong on
 numbers with leading zero and base=0
In-Reply-To: <1488922068.27.0.463542328186.issue29751@psf.upfronthosting.co.za>
Message-ID: <1490903552.7.0.151300860823.issue29751@psf.upfronthosting.co.za>


Cheryl Sabella added the comment:

I have a pull request ready for the documentation, but I didn't understand the underscore usage, so I couldn't add that.

If you explain it, then I can try to add it.

----------
nosy: +csabella

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29751>
_______________________________________

From report at bugs.python.org  Thu Mar 30 16:06:28 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 30 Mar 2017 20:06:28 +0000
Subject: [docs] [issue29751] PyLong_FromString documentation wrong on
 numbers with leading zero and base=0
In-Reply-To: <1488922068.27.0.463542328186.issue29751@psf.upfronthosting.co.za>
Message-ID: <1490904388.75.0.370582116461.issue29751@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
stage:  -> patch review
versions: +Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29751>
_______________________________________

From report at bugs.python.org  Thu Mar 30 16:29:01 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Thu, 30 Mar 2017 20:29:01 +0000
Subject: [docs] [issue29751] PyLong_FromString documentation wrong on
 numbers with leading zero and base=0
In-Reply-To: <1488922068.27.0.463542328186.issue29751@psf.upfronthosting.co.za>
Message-ID: <1490905741.92.0.507048548223.issue29751@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

String arguments to int are quoted int literals.  From
https://docs.python.org/3/reference/lexical_analysis.html#literals
'Underscores are ignored for determining the numeric value of the literal. They can be used to group digits for enhanced readability. One underscore can occur between digits, and after base specifiers like 0x.'

For your patch, I would summarize this by expanding 'Leading spaces are ignored.' to the following (in patch comment also).
"Leading spaces and single underscores after a base specifier and between digits are ignored."

----------
nosy: +terry.reedy

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29751>
_______________________________________

From report at bugs.python.org  Thu Mar 30 16:39:09 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 30 Mar 2017 20:39:09 +0000
Subject: [docs] [issue22392] Clarify documentation of __getinitargs__
In-Reply-To: <1410461552.96.0.589396040073.issue22392@psf.upfronthosting.co.za>
Message-ID: <1490906348.87.0.329405989492.issue22392@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 2ee01ecf419a392f0b6a33ca10d1f747adb6c43a by Mariatta (Mandeep Singh) in branch '2.7':
[2.7] bpo-22392: Improve documentation for __getinitargs__  (GH-899)
https://github.com/python/cpython/commit/2ee01ecf419a392f0b6a33ca10d1f747adb6c43a


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue22392>
_______________________________________

From report at bugs.python.org  Thu Mar 30 16:40:21 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 30 Mar 2017 20:40:21 +0000
Subject: [docs] [issue22392] Clarify documentation of __getinitargs__
In-Reply-To: <1410461552.96.0.589396040073.issue22392@psf.upfronthosting.co.za>
Message-ID: <1490906421.97.0.219037132724.issue22392@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue22392>
_______________________________________

From report at bugs.python.org  Thu Mar 30 16:45:01 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Thu, 30 Mar 2017 20:45:01 +0000
Subject: [docs] [issue28415] PyUnicode_FromFormat integer format handling
 different from printf about zeropad
In-Reply-To: <1476176180.11.0.398413685253.issue28415@psf.upfronthosting.co.za>
Message-ID: <1490906700.98.0.886876557461.issue28415@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

*Way* too wordy. In msg278666, I suggested minimal and terse alternatives.
a. /exactly/nearly/
b. add "except that a 0 conversion flag is not ignored when a precision is given for d, i, o, u, x and X conversion types"

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28415>
_______________________________________

From report at bugs.python.org  Thu Mar 30 17:05:29 2017
From: report at bugs.python.org (Jim Fasarakis-Hilliard)
Date: Thu, 30 Mar 2017 21:05:29 +0000
Subject: [docs] [issue29251] Class __dict__ is only a mapping proxy
In-Reply-To: <1484222660.7.0.65822313324.issue29251@psf.upfronthosting.co.za>
Message-ID: <1490907929.55.0.0273904618273.issue29251@psf.upfronthosting.co.za>


Jim Fasarakis-Hilliard added the comment:

I believe the docs defined that, usually using a bold "CPython implementation detail" sentence.

It seems like it's something that would be considered an implementation detail, though, according to Raymond's answer here: http://stackoverflow.com/questions/32720492/why-is-a-class-dict-a-mappingproxy

Changing it to just state it's a mapping definitely looks like the safest option.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29251>
_______________________________________

From report at bugs.python.org  Thu Mar 30 23:40:13 2017
From: report at bugs.python.org (Kinebuchi Tomohiko)
Date: Fri, 31 Mar 2017 03:40:13 +0000
Subject: [docs] [issue29952] "keys and values" is preferred to "keys and
 elements" for name of dict constituent
Message-ID: <1490931613.41.0.406216073022.issue29952@psf.upfronthosting.co.za>


New submission from Kinebuchi Tomohiko:

In the section "6.10.1. Value comparisons" [1]_::

   Equality comparison of the keys and elements enforces reflexivity.

would be

   Equality comparison of the keys and values enforces reflexivity.

because we usually call an entry of dict as "key-value pair".

.. [1] https://docs.python.org/3.6/reference/expressions.html#value-comparisons

----------
assignee: docs at python
components: Documentation
messages: 290890
nosy: cocoatomo, docs at python
priority: normal
severity: normal
status: open
title: "keys and values" is preferred to "keys and elements" for name of dict constituent
versions: Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29952>
_______________________________________

From report at bugs.python.org  Fri Mar 31 01:26:16 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 31 Mar 2017 05:26:16 +0000
Subject: [docs] [issue28810] Document bytecode changes in 3.6
In-Reply-To: <1480184644.53.0.660721117392.issue28810@psf.upfronthosting.co.za>
Message-ID: <1490937976.17.0.388997484812.issue28810@psf.upfronthosting.co.za>


Changes by Mariatta Wijaya <mariatta.wijaya at gmail.com>:


----------
pull_requests: +817

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28810>
_______________________________________

From report at bugs.python.org  Fri Mar 31 01:34:14 2017
From: report at bugs.python.org (Aviv Palivoda)
Date: Fri, 31 Mar 2017 05:34:14 +0000
Subject: [docs] [issue29725] sqlite3.Cursor doesn't properly document
 "arraysize"
In-Reply-To: <1488732449.69.0.822466282685.issue29725@psf.upfronthosting.co.za>
Message-ID: <1490938454.79.0.459357322118.issue29725@psf.upfronthosting.co.za>


Changes by Aviv Palivoda <palaviv at gmail.com>:


----------
nosy: +palaviv

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29725>
_______________________________________

From report at bugs.python.org  Fri Mar 31 01:40:43 2017
From: report at bugs.python.org (Kinebuchi Tomohiko)
Date: Fri, 31 Mar 2017 05:40:43 +0000
Subject: [docs] [issue29952] "keys and values" is preferred to "keys and
 elements" for name of dict constituent
In-Reply-To: <1490931613.41.0.406216073022.issue29952@psf.upfronthosting.co.za>
Message-ID: <1490938843.69.0.407357121916.issue29952@psf.upfronthosting.co.za>


Changes by Kinebuchi Tomohiko <cocoatomo77 at gmail.com>:


----------
pull_requests: +818

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29952>
_______________________________________

From report at bugs.python.org  Fri Mar 31 01:48:51 2017
From: report at bugs.python.org (INADA Naoki)
Date: Fri, 31 Mar 2017 05:48:51 +0000
Subject: [docs] [issue29952] "keys and values" is preferred to "keys and
 elements" for name of dict constituent
In-Reply-To: <1490931613.41.0.406216073022.issue29952@psf.upfronthosting.co.za>
Message-ID: <1490939331.72.0.49872279153.issue29952@psf.upfronthosting.co.za>


INADA Naoki added the comment:


New changeset cdcac039fb447f2ab04efcacbe663751bb2cb4ec by INADA Naoki (cocoatomo) in branch 'master':
bpo-29952: Use usual terminology of dict (GH-917)
https://github.com/python/cpython/commit/cdcac039fb447f2ab04efcacbe663751bb2cb4ec


----------
nosy: +inada.naoki

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29952>
_______________________________________

From report at bugs.python.org  Fri Mar 31 02:35:15 2017
From: report at bugs.python.org (INADA Naoki)
Date: Fri, 31 Mar 2017 06:35:15 +0000
Subject: [docs] [issue29952] "keys and values" is preferred to "keys and
 elements" for name of dict constituent
In-Reply-To: <1490931613.41.0.406216073022.issue29952@psf.upfronthosting.co.za>
Message-ID: <1490942115.97.0.544094239755.issue29952@psf.upfronthosting.co.za>


Changes by INADA Naoki <songofacandy at gmail.com>:


----------
pull_requests: +819

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29952>
_______________________________________

From report at bugs.python.org  Fri Mar 31 02:36:12 2017
From: report at bugs.python.org (INADA Naoki)
Date: Fri, 31 Mar 2017 06:36:12 +0000
Subject: [docs] [issue29952] "keys and values" is preferred to "keys and
 elements" for name of dict constituent
In-Reply-To: <1490931613.41.0.406216073022.issue29952@psf.upfronthosting.co.za>
Message-ID: <1490942172.56.0.763076237473.issue29952@psf.upfronthosting.co.za>


Changes by INADA Naoki <songofacandy at gmail.com>:


----------
pull_requests: +820

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29952>
_______________________________________

From report at bugs.python.org  Fri Mar 31 02:37:43 2017
From: report at bugs.python.org (INADA Naoki)
Date: Fri, 31 Mar 2017 06:37:43 +0000
Subject: [docs] [issue29952] "keys and values" is preferred to "keys and
 elements" for name of dict constituent
In-Reply-To: <1490931613.41.0.406216073022.issue29952@psf.upfronthosting.co.za>
Message-ID: <1490942263.73.0.25195962198.issue29952@psf.upfronthosting.co.za>


Changes by INADA Naoki <songofacandy at gmail.com>:


----------
pull_requests: +821

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29952>
_______________________________________

From report at bugs.python.org  Fri Mar 31 02:43:12 2017
From: report at bugs.python.org (INADA Naoki)
Date: Fri, 31 Mar 2017 06:43:12 +0000
Subject: [docs] [issue29952] "keys and values" is preferred to "keys and
 elements" for name of dict constituent
In-Reply-To: <1490931613.41.0.406216073022.issue29952@psf.upfronthosting.co.za>
Message-ID: <1490942592.91.0.249806595527.issue29952@psf.upfronthosting.co.za>


INADA Naoki added the comment:


New changeset 4c75fbb485c0e42181aab95c2ae92c597915827c by INADA Naoki in branch '3.6':
bpo-29952: Use usual terminology of dict  (GH-922)
https://github.com/python/cpython/commit/4c75fbb485c0e42181aab95c2ae92c597915827c


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29952>
_______________________________________

From report at bugs.python.org  Fri Mar 31 02:43:37 2017
From: report at bugs.python.org (INADA Naoki)
Date: Fri, 31 Mar 2017 06:43:37 +0000
Subject: [docs] [issue29952] "keys and values" is preferred to "keys and
 elements" for name of dict constituent
In-Reply-To: <1490931613.41.0.406216073022.issue29952@psf.upfronthosting.co.za>
Message-ID: <1490942617.11.0.471198888827.issue29952@psf.upfronthosting.co.za>


INADA Naoki added the comment:


New changeset f3158121132a1519439bf4c7dba3333b07802d6d by INADA Naoki in branch '3.5':
bpo-29952: Use usual terminology of dict (GH-923)
https://github.com/python/cpython/commit/f3158121132a1519439bf4c7dba3333b07802d6d


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29952>
_______________________________________

From report at bugs.python.org  Fri Mar 31 02:53:27 2017
From: report at bugs.python.org (INADA Naoki)
Date: Fri, 31 Mar 2017 06:53:27 +0000
Subject: [docs] [issue29952] "keys and values" is preferred to "keys and
 elements" for name of dict constituent
In-Reply-To: <1490931613.41.0.406216073022.issue29952@psf.upfronthosting.co.za>
Message-ID: <1490943207.84.0.444315804755.issue29952@psf.upfronthosting.co.za>


INADA Naoki added the comment:


New changeset 5aa913d72317d7632781fb71a7b45a2b5e31558e by INADA Naoki in branch '2.7':
bpo-29952: Use usual terminology of dict (GH-924)
https://github.com/python/cpython/commit/5aa913d72317d7632781fb71a7b45a2b5e31558e


----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29952>
_______________________________________

From report at bugs.python.org  Fri Mar 31 05:12:21 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 31 Mar 2017 09:12:21 +0000
Subject: [docs] [issue28810] Document bytecode changes in 3.6
In-Reply-To: <1480184644.53.0.660721117392.issue28810@psf.upfronthosting.co.za>
Message-ID: <1490951541.03.0.377065459757.issue28810@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 0a17e584461b14ff65ec287048f53911dbb22222 by Mariatta in branch '3.6':
bpo-28810: Update lnotab_notes.txt (GH-665) (GH-919)
https://github.com/python/cpython/commit/0a17e584461b14ff65ec287048f53911dbb22222


----------
nosy: +Mariatta

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28810>
_______________________________________

From report at bugs.python.org  Fri Mar 31 11:10:42 2017
From: report at bugs.python.org (Aviv Palivoda)
Date: Fri, 31 Mar 2017 15:10:42 +0000
Subject: [docs] [issue29725] sqlite3.Cursor doesn't properly document
 "arraysize"
In-Reply-To: <1488732449.69.0.822466282685.issue29725@psf.upfronthosting.co.za>
Message-ID: <1490973042.9.0.801127027976.issue29725@psf.upfronthosting.co.za>


Aviv Palivoda added the comment:

Hi Cheryl, the arraysize value can be set by doing:
>>> cursor.array = 5

For example I can do the following
>>> import sqlite3
>>> s = sqlite3.connect(":memory:")
>>> s.execute("create table a(a,b)")
>>> s.execute("insert into a(a,b) values (1,2)")
>>> s.execute("insert into a(a,b) values (3,4)")
>>> c = s.cursor() # Array size is 1
>>> c.execute("select * from a")
>>> c.fetchmany()
[(1, 2)]
>>> c.fetchmany()
[(3, 4)]
>>> c.arraysize = 2 # Change array size
>>> c.fetchmany()
[(1, 2), (3, 4)]

As you can see the arraysize set the number of results the fetchmany will return.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29725>
_______________________________________

From report at bugs.python.org  Fri Mar 31 12:31:36 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Fri, 31 Mar 2017 16:31:36 +0000
Subject: [docs] [issue29725] sqlite3.Cursor doesn't properly document
 "arraysize"
In-Reply-To: <1488732449.69.0.822466282685.issue29725@psf.upfronthosting.co.za>
Message-ID: <1490977896.51.0.0479693936022.issue29725@psf.upfronthosting.co.za>


Cheryl Sabella added the comment:

Hi Aviv,

Thank you so much for explaining that!  It's obvious to me now.  It wasn't marked as READ ONLY in the program, so of course it would set by the caller.  I'll be able to document that.

I still have the question about this line in fetchall - " Note that the cursor?s arraysize attribute can affect the performance of this operation. "  I don't see arraysize referenced in that function.  I must be missing something else, but if it's not used, then maybe I should remove that line?

One other question --
There is another attribute called row_factory in the cursor structure that isn't in the docs.  There is a row_factory defined in the docs, but that one is for the connection structure.  Should it be added under cursor as well?

Thank you!

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29725>
_______________________________________

From report at bugs.python.org  Fri Mar 31 12:36:09 2017
From: report at bugs.python.org (Donald Stufft)
Date: Fri, 31 Mar 2017 16:36:09 +0000
Subject: [docs] [issue27778] PEP 524: Add os.getrandom()
In-Reply-To: <1471368341.7.0.188364803995.issue27778@psf.upfronthosting.co.za>
Message-ID: <1490978169.34.0.121306657837.issue27778@psf.upfronthosting.co.za>


Changes by Donald Stufft <donald at stufft.io>:


----------
pull_requests: +848

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue27778>
_______________________________________

From report at bugs.python.org  Fri Mar 31 12:36:13 2017
From: report at bugs.python.org (Donald Stufft)
Date: Fri, 31 Mar 2017 16:36:13 +0000
Subject: [docs] [issue28739] PEP 498: docstrings as f-strings
In-Reply-To: <1479501831.35.0.531195928426.issue28739@psf.upfronthosting.co.za>
Message-ID: <1490978173.11.0.418296618802.issue28739@psf.upfronthosting.co.za>


Changes by Donald Stufft <donald at stufft.io>:


----------
pull_requests: +885

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28739>
_______________________________________

From report at bugs.python.org  Fri Mar 31 12:36:20 2017
From: report at bugs.python.org (Donald Stufft)
Date: Fri, 31 Mar 2017 16:36:20 +0000
Subject: [docs] [issue15369] pybench and test.pystone poorly documented
In-Reply-To: <1342446105.53.0.956340794171.issue15369@psf.upfronthosting.co.za>
Message-ID: <1490978180.13.0.301602603431.issue15369@psf.upfronthosting.co.za>


Changes by Donald Stufft <donald at stufft.io>:


----------
pull_requests: +938

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue15369>
_______________________________________

From report at bugs.python.org  Fri Mar 31 12:36:21 2017
From: report at bugs.python.org (Donald Stufft)
Date: Fri, 31 Mar 2017 16:36:21 +0000
Subject: [docs] [issue28513] Document zipfile CLI
In-Reply-To: <1477218977.25.0.95260452294.issue28513@psf.upfronthosting.co.za>
Message-ID: <1490978181.97.0.714686631214.issue28513@psf.upfronthosting.co.za>


Changes by Donald Stufft <donald at stufft.io>:


----------
pull_requests: +954

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28513>
_______________________________________

From report at bugs.python.org  Fri Mar 31 12:36:24 2017
From: report at bugs.python.org (Donald Stufft)
Date: Fri, 31 Mar 2017 16:36:24 +0000
Subject: [docs] [issue27998] Bytes paths now are supported in os.scandir()
 on Windows
In-Reply-To: <1473236470.81.0.837469962495.issue27998@psf.upfronthosting.co.za>
Message-ID: <1490978184.19.0.254470820948.issue27998@psf.upfronthosting.co.za>


Changes by Donald Stufft <donald at stufft.io>:


----------
pull_requests: +977

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue27998>
_______________________________________

From report at bugs.python.org  Fri Mar 31 12:36:27 2017
From: report at bugs.python.org (Donald Stufft)
Date: Fri, 31 Mar 2017 16:36:27 +0000
Subject: [docs] [issue29349] Update old Python 2 code in
 Docs/tools/extensions/patchlevel.py
In-Reply-To: <1485164481.25.0.457345760711.issue29349@psf.upfronthosting.co.za>
Message-ID: <1490978187.14.0.630861900322.issue29349@psf.upfronthosting.co.za>


Changes by Donald Stufft <donald at stufft.io>:


----------
pull_requests: +1007

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29349>
_______________________________________

From report at bugs.python.org  Fri Mar 31 12:36:28 2017
From: report at bugs.python.org (Donald Stufft)
Date: Fri, 31 Mar 2017 16:36:28 +0000
Subject: [docs] [issue29000] Not matched behavior within printf style bytes
 formatting
In-Reply-To: <1481982064.72.0.399504561165.issue29000@psf.upfronthosting.co.za>
Message-ID: <1490978188.73.0.601677929419.issue29000@psf.upfronthosting.co.za>


Changes by Donald Stufft <donald at stufft.io>:


----------
pull_requests: +1017

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29000>
_______________________________________

From report at bugs.python.org  Fri Mar 31 12:36:29 2017
From: report at bugs.python.org (Donald Stufft)
Date: Fri, 31 Mar 2017 16:36:29 +0000
Subject: [docs] [issue28929] Provide a link from documentation back to its
 source file
In-Reply-To: <1481331536.86.0.539237207001.issue28929@psf.upfronthosting.co.za>
Message-ID: <1490978189.35.0.213484266887.issue28929@psf.upfronthosting.co.za>


Changes by Donald Stufft <donald at stufft.io>:


----------
pull_requests: +1023

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue28929>
_______________________________________

From report at bugs.python.org  Fri Mar 31 12:36:30 2017
From: report at bugs.python.org (Donald Stufft)
Date: Fri, 31 Mar 2017 16:36:30 +0000
Subject: [docs] [issue26355] Emit major version based canonical URLs for docs
In-Reply-To: <1455353539.4.0.541474968967.issue26355@psf.upfronthosting.co.za>
Message-ID: <1490978190.1.0.55182590349.issue26355@psf.upfronthosting.co.za>


Changes by Donald Stufft <donald at stufft.io>:


----------
pull_requests: +1028

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue26355>
_______________________________________

From report at bugs.python.org  Fri Mar 31 12:36:38 2017
From: report at bugs.python.org (Donald Stufft)
Date: Fri, 31 Mar 2017 16:36:38 +0000
Subject: [docs] [issue29576] Improve some deprecations in the importlib
In-Reply-To: <1487208454.1.0.000568467436348.issue29576@psf.upfronthosting.co.za>
Message-ID: <1490978198.25.0.745230895805.issue29576@psf.upfronthosting.co.za>


Changes by Donald Stufft <donald at stufft.io>:


----------
pull_requests: +1100

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29576>
_______________________________________

From report at bugs.python.org  Fri Mar 31 16:08:37 2017
From: report at bugs.python.org (Alexander Belopolsky)
Date: Fri, 31 Mar 2017 20:08:37 +0000
Subject: [docs] [issue29956] math.exp documentation is misleading
Message-ID: <1490990917.06.0.404933995002.issue29956@psf.upfronthosting.co.za>


New submission from Alexander Belopolsky:

The math.exp(x) function is documented to "Return e**x" <https://docs.python.org/3/library/math.html#math.exp>.  This is misleading because even in the simplest case, math.exp(x) is not the same as math.e ** x:

>>> import math
>>> math.exp(2) - math.e ** 2
8.881784197001252e-16

I suggest using e<sup>x instead of e**x to distinguish between Python syntax and mathematical operation and change "Return e**x" to "Return e<sup>x, the base-e exponential of x."

----------
assignee: docs at python
components: Documentation
messages: 290937
nosy: belopolsky, docs at python
priority: normal
severity: normal
status: open
title: math.exp documentation is misleading
versions: Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29956>
_______________________________________

From report at bugs.python.org  Fri Mar 31 16:29:31 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 31 Mar 2017 20:29:31 +0000
Subject: [docs] [issue29956] math.exp documentation is misleading
In-Reply-To: <1490990917.06.0.404933995002.issue29956@psf.upfronthosting.co.za>
Message-ID: <1490992170.95.0.696355682594.issue29956@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

This is because math.e is not the same as e.

----------
nosy: +mark.dickinson, rhettinger, serhiy.storchaka, stutzbach, tim.peters

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29956>
_______________________________________

From report at bugs.python.org  Fri Mar 31 16:36:18 2017
From: report at bugs.python.org (Alexander Belopolsky)
Date: Fri, 31 Mar 2017 20:36:18 +0000
Subject: [docs] [issue29956] math.exp documentation is misleading
In-Reply-To: <1490990917.06.0.404933995002.issue29956@psf.upfronthosting.co.za>
Message-ID: <1490992578.34.0.721148151282.issue29956@psf.upfronthosting.co.za>


Alexander Belopolsky added the comment:

> This is because math.e is not the same as e.

Right.  That's why I think it would be nice to distinguish math.e and the base of the natural logarithm typographically in the docs.  Can we use sphinx math mode?  If not, I would use italic for the mathematical e.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29956>
_______________________________________

From report at bugs.python.org  Fri Mar 31 16:54:14 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 31 Mar 2017 20:54:14 +0000
Subject: [docs] [issue29956] math.exp documentation is misleading
In-Reply-To: <1490990917.06.0.404933995002.issue29956@psf.upfronthosting.co.za>
Message-ID: <1490993654.0.0.877979076518.issue29956@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

*e*:sup:`x` ? I like this idea.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29956>
_______________________________________

From report at bugs.python.org  Fri Mar 31 17:37:56 2017
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 31 Mar 2017 21:37:56 +0000
Subject: [docs] [issue29725] sqlite3.Cursor doesn't properly document
 "arraysize"
In-Reply-To: <1488732449.69.0.822466282685.issue29725@psf.upfronthosting.co.za>
Message-ID: <1490996276.34.0.0611315248176.issue29725@psf.upfronthosting.co.za>


Berker Peksag added the comment:

> There is another attribute called row_factory in the cursor structure
> that isn't in the docs.  There is a row_factory defined in the docs,
> but that one is for the connection structure.  Should it be added under
> cursor as well?

Thank you for working on this issue, Cheryl. Cursor.row_factory is there for backwards compatibility reasons so we can't remove it until we retire Python 2.

For example, pysqlite has already been removed it in version 2.8.0 [1] but they don't have a strict backwards compatibility policy since their user base is much smaller than us and it only supports Python 2.

[1] https://github.com/ghaering/pysqlite/commit/10dbbe4cca7487a3c65776186b3fb4ceeab5e8fa

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29725>
_______________________________________

From report at bugs.python.org  Fri Mar 31 19:11:58 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Fri, 31 Mar 2017 23:11:58 +0000
Subject: [docs] [issue29956] math.exp documentation is misleading
In-Reply-To: <1490990917.06.0.404933995002.issue29956@psf.upfronthosting.co.za>
Message-ID: <1491001918.93.0.431287346263.issue29956@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

I suggest changing the main docs to match the existing docstring, "Return e raised to the power of x."  

The exp() function is a thin wrapper around the C math library and where it is documented as "compute e (the base of natural logarithms) raised to the power x" or "e raised to the power X (where e is the base of the natural system of logarithms, approximately 2.71828)."  Our docs shouldn't make more or fewer promises than the upstream libraries are making.

Perhaps there can be a general note about reading too much into the math module implementation details.  We expect some relationships to only be approximate: log(x)+1?log1p(x), log2(x)?log(x,2.0), exp(lgamma(x))?gamma(x), sqrt(x)?x**0.5, etc.  These are floating point math library "facts of life".

* http://www.slac.stanford.edu/comp/unix/package/rtems/doc/html/libm/libm.info.exp.html

* https://www.gnu.org/software/libc/manual/html_node/Exponents-and-Logarithms.html

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29956>
_______________________________________

From report at bugs.python.org  Fri Mar 31 20:09:48 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 01 Apr 2017 00:09:48 +0000
Subject: [docs] [issue29952] "keys and values" preferred to "keys and
 elements" for dict constituent
In-Reply-To: <1490931613.41.0.406216073022.issue29952@psf.upfronthosting.co.za>
Message-ID: <1491005388.83.0.035893913447.issue29952@psf.upfronthosting.co.za>


Changes by Terry J. Reedy <tjreedy at udel.edu>:


----------
title: "keys and values" is preferred to "keys and elements" for name of dict constituent -> "keys and values" preferred to "keys and elements" for dict constituent

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue29952>
_______________________________________

From flavio.bonifacio at metis-ricerche.it  Wed Mar 29 07:52:31 2017
From: flavio.bonifacio at metis-ricerche.it (flavio.bonifacio at metis-ricerche.it)
Date: Wed, 29 Mar 2017 13:52:31 +0200 (CEST)
Subject: [docs] It seems to be a bug in online tutoria
Message-ID: <56027.85.89.128.1.1490788351.squirrel@pdamail.inrete.it>

In the on line tutorial par. 4.6 , in the fib2 function a print is missing

>>> def fib2(n):  # return Fibonacci series up to n
...     """Return a list containing the Fibonacci series up to n."""
...     result = []
...     a, b = 0, 1
...     while a < n:
...         result.append(a)    # see below
...         a, b = b, a+b
...     return result
...
>>> f100 = fib2(100)    # call it
>>> f100                # write the result  <========>  I THINK IT MUST BE
print(f100)
[0, 1, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89]

Flavio Bonifacio

---------
Ai sensi e per effetto della Legge sulla tutela della
riservatezza personale (D. Lgs. 196/2003) questa e-mail ?
destinata unicamente agli indirizzi sopra indicati e le
informazioni in essa contenute sono da considerarsi
strettamente riservate.
E' proibito leggere, copiare, usare o diffondere il
contenuto della presente e-mail senza autorizzazione. Se
avete ricevuto questo messaggio per errore, siete pregati
di eliminarlo e darne comunicazione al mittente. Grazie.
---------
Metis Ricerche srl
via Camerana, 6
10128 Torino
Tel +39-011538028




From iafisher at haverford.edu  Wed Mar 29 10:57:48 2017
From: iafisher at haverford.edu (Ian Fisher)
Date: Wed, 29 Mar 2017 10:57:48 -0400
Subject: [docs] Broken link on distutils doc page
Message-ID: <CABU5uxjgpPTZL-DNohtpcKK0wK=J-h8E+FE8HwgSQt4KHkEoZw@mail.gmail.com>

Hello,

I am writing to report a bug on the distutils page
<https://docs.python.org/3.4/library/distutils.html> of the Python 3.4
documentation. This page contains a broken link to the setuptools page.
Currently the link is https://setuptools.pypa.io/en/latest/setuptools.html;
the link http://setuptools.readthedocs.io/en/latest/ is probably what was
intended.

Sincerely,
Ian Fisher
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170329/ba9b9900/attachment.html>

From mcowperthwaite at accelbiotech.com  Tue Mar 28 20:40:07 2017
From: mcowperthwaite at accelbiotech.com (Michael Cowperthwaite)
Date: Tue, 28 Mar 2017 17:40:07 -0700
Subject: [docs] argparse doc improvement
Message-ID: <CA+heH2awRtphDkRWRLOFJX+1d7GJS_ZtT7ZYL4XhuY44YWeDnQ@mail.gmail.com>

https://docs.python.org/2/library/argparse.html#invalid-arguments

When it encounters such an error, it exits and prints the error along with
> a usage message:


"It" in the sentence refers to the parse_args() method. Saying that "it
exits" makes it sound as if the method exits. Rather, an error in parsing
causes sys.exit() to be called, exiting the entire script. Suggested
rewrite:

When it encounters such an error, parse_args() prints the error and a usage
> message, then causes the script to exit immediately. No exception is raised.


Whether it's worth noting that the exit is the result of sys.exit(), I
can't say. I don't need that level of detail.

-- 

*Michael Cowperthwaite*
Sr. Software Engineer

Accel Biotech LLC, a Ximedica company

103 Cooper Court, Los Gatos, CA 95032

408.354.1700 x  <408.354.1700%20x%20307>559





www.accelbiotech.com



Providence   |   Minneapolis   |   San Francisco  |  Los Gatos  |  Hong Kong

Visit us at www.ximedica.com and read our blog, *Living Innovation.
<http://www.ximedica.com/People/LivingInnovationBlog.aspx>*

The information contained in this transmission may contain privileged and
confidential information. It is intended only for the use of the person(s)
named above and/or involved in the noted project(s). If you are not the
intended recipient, you are hereby notified that any review, dissemination,
distribution or duplication of this communication is strictly prohibited.
If you are not the intended recipient, please contact the sender by reply
email and destroy all copies of the original message.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170328/4b8be907/attachment-0001.html>

From seantcanavan at gmail.com  Mon Mar 27 20:47:25 2017
From: seantcanavan at gmail.com (Sean Canavan)
Date: Mon, 27 Mar 2017 17:47:25 -0700
Subject: [docs] small doc typo
Message-ID: <CA+XNkn02eDRCPA4UM41wpecChOqRwURPYpJPkqjJuvHn965tOg@mail.gmail.com>

Under
https://docs.python.org/2/howto/argparse.html#introducing-optional-arguments

"*So far we,* have been playing with positional arguments" should probably
be "*So far we* have been playing with positional arguments"

Cheers,
Sean
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170327/989e98b9/attachment.html>