From report at bugs.python.org  Thu Jun  1 03:21:14 2017
From: report at bugs.python.org (Antoine Pietri)
Date: Thu, 01 Jun 2017 07:21:14 +0000
Subject: [docs] [issue24692] types.coroutines() idempotence documentation
In-Reply-To: <1437650502.32.0.0288592289227.issue24692@psf.upfronthosting.co.za>
Message-ID: <1496301674.44.0.817836741943.issue24692@psf.upfronthosting.co.za>


Antoine Pietri added the comment:

I checked, the current doc gives a good explanation. I'm closing the issue.

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

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

From report at bugs.python.org  Thu Jun  1 04:59:10 2017
From: report at bugs.python.org (Xavier Morel)
Date: Thu, 01 Jun 2017 08:59:10 +0000
Subject: [docs] [issue30535] Warn that meta_path is not empty
Message-ID: <1496307550.81.0.122215532062.issue30535@psf.upfronthosting.co.za>


New submission from Xavier Morel:

Encountered this issue porting Python 2 code manipulating meta_path to Python 3.

In Python 2, meta_path is empty by default and its documentation specifically notes that:

> sys.meta_path is searched before any implicit default finders or sys.path.

As a result, sys.meta_path.append() works perfectly well and is overwhelmingly common[0].

In Python 3, this note was removed but the documentation does not specifically state default finders are present in meta_path, and the old code using sys.meta_path.append may now break as the default finders will silently take precedence on the custom ones if they believe they can do the job.

I'd like to add a warning to the Python 3 documentation (3.5+?) noting the presence of existing default loaders, and to the Python 2 documentation suggesting `sys.meta_path.insert(0, finder)` for future-proofing, would there be objections or issues?

[0] https://github.com/search?q=meta_path.append&type=Code&utf8=?

----------
assignee: docs at python
components: Documentation
messages: 294919
nosy: docs at python, xmorel
priority: normal
severity: normal
status: open
title: Warn that meta_path is not empty
type: behavior
versions: Python 2.7, Python 3.5, Python 3.6

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

From report at bugs.python.org  Thu Jun  1 05:45:34 2017
From: report at bugs.python.org (Xavier Morel)
Date: Thu, 01 Jun 2017 09:45:34 +0000
Subject: [docs] [issue30535] Warn that meta_path is not empty
In-Reply-To: <1496307550.81.0.122215532062.issue30535@psf.upfronthosting.co.za>
Message-ID: <1496310334.29.0.290726146246.issue30535@psf.upfronthosting.co.za>


Xavier Morel added the comment:

Addendum: the warning was present (in the documentation) until Python 3.5, even though Python 3.3 is apparently where the "default finders" were moved to meta_path:

    > python3.2 -c 'import sys;print(sys.meta_path)'
    []
> python3.3 -c 'import sys;print(sys.meta_path)'
    [<class '_frozen_importlib.BuiltinImporter'>, <class '_frozen_importlib.FrozenImporter'>, <class '_frozen_importlib.PathFinder'>]

----------

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

From report at bugs.python.org  Thu Jun  1 05:51:31 2017
From: report at bugs.python.org (Xavier Morel)
Date: Thu, 01 Jun 2017 09:51:31 +0000
Subject: [docs] [issue29920] Document cgitb.text and cgitb.html
In-Reply-To: <1490620609.02.0.405950190914.issue29920@psf.upfronthosting.co.za>
Message-ID: <1496310691.66.0.526668384638.issue29920@psf.upfronthosting.co.za>


Xavier Morel added the comment:

Should I close this since the PR was merged?

----------

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

From report at bugs.python.org  Thu Jun  1 05:52:51 2017
From: report at bugs.python.org (Xavier Morel)
Date: Thu, 01 Jun 2017 09:52:51 +0000
Subject: [docs] [issue30535] Warn that meta_path is not empty
In-Reply-To: <1496307550.81.0.122215532062.issue30535@psf.upfronthosting.co.za>
Message-ID: <1496310771.57.0.177592044561.issue30535@psf.upfronthosting.co.za>


Xavier Morel added the comment:

And it turns out the change was noted in the Python 3.3 release notes[0] though not all the consequences were spelled out (and the meta_path and path_hooks documentations were not changed)

[0] https://docs.python.org/3/whatsnew/3.3.html#visible-changes

----------

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

From report at bugs.python.org  Thu Jun  1 05:56:33 2017
From: report at bugs.python.org (Antoine Pitrou)
Date: Thu, 01 Jun 2017 09:56:33 +0000
Subject: [docs] [issue30535] Warn that meta_path is not empty
In-Reply-To: <1496307550.81.0.122215532062.issue30535@psf.upfronthosting.co.za>
Message-ID: <1496310993.94.0.285015285547.issue30535@psf.upfronthosting.co.za>


Antoine Pitrou added the comment:

A warning is probably too strong.  Also, it's easy to check sys.meta_path at the interpreter prompt, so I'm not sure it's worth mentioning at all.

----------
nosy: +brett.cannon, eric.snow, ncoghlan, pitrou

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

From report at bugs.python.org  Thu Jun  1 06:25:03 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 01 Jun 2017 10:25:03 +0000
Subject: [docs] [issue29920] Document cgitb.text and cgitb.html
In-Reply-To: <1490620609.02.0.405950190914.issue29920@psf.upfronthosting.co.za>
Message-ID: <1496312703.02.0.575215874415.issue29920@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

I suggest to move the descriptions of text() and html() after handle(). And I don't know what to do with the discrepancy in the parameter name.

----------
versions:  -Python 2.7, Python 3.5, Python 3.6

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

From report at bugs.python.org  Thu Jun  1 07:32:36 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 01 Jun 2017 11:32:36 +0000
Subject: [docs] [issue30538] Functional Programming HOWTO describes one
 argument itertools.count()
Message-ID: <1496316755.99.0.127514740016.issue30538@psf.upfronthosting.co.za>


New submission from Cheryl Sabella:

The Functional Programming HOWTO describes single variable itertools.count instead of the two variable version that is linked to.

----------
assignee: docs at python
components: Documentation
messages: 294935
nosy: csabella, docs at python
priority: normal
severity: normal
status: open
title: Functional Programming HOWTO describes one argument itertools.count()
versions: Python 3.7

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

From report at bugs.python.org  Thu Jun  1 07:33:17 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 01 Jun 2017 11:33:17 +0000
Subject: [docs] [issue30538] Functional Programming HOWTO describes one
 argument itertools.count()
In-Reply-To: <1496316755.99.0.127514740016.issue30538@psf.upfronthosting.co.za>
Message-ID: <1496316797.86.0.36259614474.issue30538@psf.upfronthosting.co.za>


Changes by Cheryl Sabella <chekat2 at gmail.com>:


----------
type:  -> enhancement

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

From bgailer at gmail.com  Thu Jun  1 09:34:25 2017
From: bgailer at gmail.com (bob gailer)
Date: Thu, 1 Jun 2017 09:34:25 -0400
Subject: [docs] RE documentation question
Message-ID: <e4d80b9e-1f6e-9a76-980a-537425bf33c4@gmail.com>

I discovered a match object property "regs" which contains the start and 
end positions of the entire match and of each group. This is exactly 
what I need. But it is not documented. Is that an oversight, or does it 
mean it might change in the future?

From report at bugs.python.org  Thu Jun  1 10:02:39 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 01 Jun 2017 14:02:39 +0000
Subject: [docs] [issue30499] Deprecated note in set documentation
In-Reply-To: <1496007018.0.0.712296031489.issue30499@psf.upfronthosting.co.za>
Message-ID: <1496325759.81.0.77717524235.issue30499@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 0737ee20671d60802a7ef40f653fe449f1921de0 by Mariatta (Julien) in branch 'master':
bpo-30499: Remove a deprecated note about sets. (GH-1848)
https://github.com/python/cpython/commit/0737ee20671d60802a7ef40f653fe449f1921de0


----------

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

From report at bugs.python.org  Thu Jun  1 10:05:06 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 01 Jun 2017 14:05:06 +0000
Subject: [docs] [issue30499] Deprecated note in set documentation
In-Reply-To: <1496007018.0.0.712296031489.issue30499@psf.upfronthosting.co.za>
Message-ID: <1496325906.78.0.707590478768.issue30499@psf.upfronthosting.co.za>


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


----------
pull_requests: +1984

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

From report at bugs.python.org  Thu Jun  1 10:05:16 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 01 Jun 2017 14:05:16 +0000
Subject: [docs] [issue30499] Deprecated note in set documentation
In-Reply-To: <1496007018.0.0.712296031489.issue30499@psf.upfronthosting.co.za>
Message-ID: <1496325916.02.0.358018400621.issue30499@psf.upfronthosting.co.za>


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


----------
pull_requests: +1985

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

From report at bugs.python.org  Thu Jun  1 10:05:22 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 01 Jun 2017 14:05:22 +0000
Subject: [docs] [issue30499] Deprecated note in set documentation
In-Reply-To: <1496007018.0.0.712296031489.issue30499@psf.upfronthosting.co.za>
Message-ID: <1496325922.47.0.00575533300592.issue30499@psf.upfronthosting.co.za>


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


----------
pull_requests: +1986

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

From report at bugs.python.org  Thu Jun  1 10:12:35 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 01 Jun 2017 14:12:35 +0000
Subject: [docs] [issue30499] Deprecated note in set documentation
In-Reply-To: <1496007018.0.0.712296031489.issue30499@psf.upfronthosting.co.za>
Message-ID: <1496326355.54.0.731456664561.issue30499@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 9d752aa5e695d682f3cfc40655580900b132e52a by Mariatta in branch '3.6':
bpo-30499: Remove a deprecated note about sets. (GH-1848) (GH-1905)
https://github.com/python/cpython/commit/9d752aa5e695d682f3cfc40655580900b132e52a


----------

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

From report at bugs.python.org  Thu Jun  1 10:12:45 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 01 Jun 2017 14:12:45 +0000
Subject: [docs] [issue30499] Deprecated note in set documentation
In-Reply-To: <1496007018.0.0.712296031489.issue30499@psf.upfronthosting.co.za>
Message-ID: <1496326365.31.0.344739689397.issue30499@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 3419fc2bf1e81d42ef4578e59d3c10f9c239e80f by Mariatta in branch '3.5':
bpo-30499: Remove a deprecated note about sets. (GH-1848) (GH-1906)
https://github.com/python/cpython/commit/3419fc2bf1e81d42ef4578e59d3c10f9c239e80f


----------

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

From report at bugs.python.org  Thu Jun  1 10:12:57 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 01 Jun 2017 14:12:57 +0000
Subject: [docs] [issue30499] Deprecated note in set documentation
In-Reply-To: <1496007018.0.0.712296031489.issue30499@psf.upfronthosting.co.za>
Message-ID: <1496326377.3.0.230070530641.issue30499@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 662d856cd7d21dbdbd4043c1735d93b32568c9e5 by Mariatta in branch '2.7':
bpo-30499: Remove a deprecated note about sets. (GH-1848) (GH-1907)
https://github.com/python/cpython/commit/662d856cd7d21dbdbd4043c1735d93b32568c9e5


----------

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

From report at bugs.python.org  Thu Jun  1 10:13:51 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 01 Jun 2017 14:13:51 +0000
Subject: [docs] [issue30499] Deprecated note in set documentation
In-Reply-To: <1496007018.0.0.712296031489.issue30499@psf.upfronthosting.co.za>
Message-ID: <1496326431.41.0.494786306856.issue30499@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Thanks Julien and Raymond.
PR has been merged and backported to 2.7, 3.5 and 3.6.

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

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

From bgailer at gmail.com  Thu Jun  1 10:22:29 2017
From: bgailer at gmail.com (bob gailer)
Date: Thu, 1 Jun 2017 10:22:29 -0400
Subject: [docs] RE documentation question
In-Reply-To: <e4d80b9e-1f6e-9a76-980a-537425bf33c4@gmail.com>
References: <e4d80b9e-1f6e-9a76-980a-537425bf33c4@gmail.com>
Message-ID: <4732b463-9d06-b670-ebdb-93d10b5a8708@gmail.com>

On 6/1/2017 9:34 AM, bob gailer wrote:
> I discovered a match object property "regs" which contains the start 
> and end positions of the entire match and of each group. This is 
> exactly what I need. But it is not documented. Is that an oversight, 
> or does it mean it might change in the future?

I discovered I can get the same info from match.span(group#) so no worries.

From report at bugs.python.org  Thu Jun  1 10:48:14 2017
From: report at bugs.python.org (Berker Peksag)
Date: Thu, 01 Jun 2017 14:48:14 +0000
Subject: [docs] [issue29920] Document cgitb.text and cgitb.html
In-Reply-To: <1490620609.02.0.405950190914.issue29920@psf.upfronthosting.co.za>
Message-ID: <1496328494.06.0.129196719128.issue29920@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Please don't close it yet. I agree with Serhiy's comments in msg293394, but I couldn't find time to address his comments yet (plus we still need to backport the documentation update to 3.5 and 3.6 branches)

----------

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

From report at bugs.python.org  Thu Jun  1 16:53:06 2017
From: report at bugs.python.org (Brett Cannon)
Date: Thu, 01 Jun 2017 20:53:06 +0000
Subject: [docs] [issue30535] Warn that meta_path is not empty
In-Reply-To: <1496307550.81.0.122215532062.issue30535@psf.upfronthosting.co.za>
Message-ID: <1496350386.6.0.764666998603.issue30535@psf.upfronthosting.co.za>


Brett Cannon added the comment:

I'm fine with adding a note to the Python 2 docs, but putting it in Python 3 seems to be going in the wrong direction as having sys.meta_path not be empty is how Python will be going forward.

----------

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

From report at bugs.python.org  Thu Jun  1 17:54:04 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 01 Jun 2017 21:54:04 +0000
Subject: [docs] [issue29660] Document that print/format_exception ignore
 etype
In-Reply-To: <1488158499.0.0.645448196253.issue29660@psf.upfronthosting.co.za>
Message-ID: <1496354044.39.0.728951115299.issue29660@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset cdb89cd72cbc66e4626914b4a71b9052ddb3a32a by Mariatta (Matthias Bussonnier) in branch 'master':
bpo-29660: traceback: Document that etype is ignored in some places. (GH-344)
https://github.com/python/cpython/commit/cdb89cd72cbc66e4626914b4a71b9052ddb3a32a


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

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

From report at bugs.python.org  Thu Jun  1 17:54:50 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 01 Jun 2017 21:54:50 +0000
Subject: [docs] [issue29660] Document that print/format_exception ignore
 etype
In-Reply-To: <1488158499.0.0.645448196253.issue29660@psf.upfronthosting.co.za>
Message-ID: <1496354090.31.0.316256124478.issue29660@psf.upfronthosting.co.za>


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


----------
stage: patch review -> backport needed

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

From report at bugs.python.org  Thu Jun  1 18:08:01 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 01 Jun 2017 22:08:01 +0000
Subject: [docs] [issue29660] Document that print/format_exception ignore
 etype
In-Reply-To: <1488158499.0.0.645448196253.issue29660@psf.upfronthosting.co.za>
Message-ID: <1496354881.06.0.073067393232.issue29660@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Thanks Matthias.

I can backport this later today.
Or do you want to do it? :)
You can use cherry_picker.py https://github.com/python/core-workflow/tree/master/cherry_picker

----------

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

From report at bugs.python.org  Thu Jun  1 23:02:01 2017
From: report at bugs.python.org (Matthias Bussonnier)
Date: Fri, 02 Jun 2017 03:02:01 +0000
Subject: [docs] [issue29660] Document that print/format_exception ignore
 etype
In-Reply-To: <1488158499.0.0.645448196253.issue29660@psf.upfronthosting.co.za>
Message-ID: <1496372521.74.0.674608459356.issue29660@psf.upfronthosting.co.za>


Matthias Bussonnier added the comment:

Thanks @Mariatta, I'll try to cherry-pick!

----------

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

From report at bugs.python.org  Thu Jun  1 23:18:09 2017
From: report at bugs.python.org (Matthias Bussonnier)
Date: Fri, 02 Jun 2017 03:18:09 +0000
Subject: [docs] [issue29660] Document that print/format_exception ignore
 etype
In-Reply-To: <1488158499.0.0.645448196253.issue29660@psf.upfronthosting.co.za>
Message-ID: <1496373489.42.0.0923022741545.issue29660@psf.upfronthosting.co.za>


Changes by Matthias Bussonnier <bussonniermatthias at gmail.com>:


----------
pull_requests: +1993

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

From report at bugs.python.org  Thu Jun  1 23:19:39 2017
From: report at bugs.python.org (Matthias Bussonnier)
Date: Fri, 02 Jun 2017 03:19:39 +0000
Subject: [docs] [issue29660] Document that print/format_exception ignore
 etype
In-Reply-To: <1488158499.0.0.645448196253.issue29660@psf.upfronthosting.co.za>
Message-ID: <1496373579.47.0.155376260824.issue29660@psf.upfronthosting.co.za>


Changes by Matthias Bussonnier <bussonniermatthias at gmail.com>:


----------
pull_requests: +1994

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

From report at bugs.python.org  Thu Jun  1 23:26:17 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 02 Jun 2017 03:26:17 +0000
Subject: [docs] [issue29660] Document that print/format_exception ignore
 etype
In-Reply-To: <1488158499.0.0.645448196253.issue29660@psf.upfronthosting.co.za>
Message-ID: <1496373977.89.0.821128970456.issue29660@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset e417d12d728103445b8516a35f643536e401f120 by Mariatta (Matthias Bussonnier) in branch '3.6':
bpo-29660: traceback: Document that etype is ignored in some places. (GH-344) (GH-1913)
https://github.com/python/cpython/commit/e417d12d728103445b8516a35f643536e401f120


----------

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

From report at bugs.python.org  Thu Jun  1 23:26:59 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 02 Jun 2017 03:26:59 +0000
Subject: [docs] [issue29660] Document that print/format_exception ignore
 etype
In-Reply-To: <1488158499.0.0.645448196253.issue29660@psf.upfronthosting.co.za>
Message-ID: <1496374019.42.0.17964437997.issue29660@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset cca3d4aa25a7aea0cda90dd2aa012f58c85e7e24 by Mariatta (Matthias Bussonnier) in branch '3.5':
bpo-29660: traceback: Document that etype is ignored in some places. (GH-344) (GH-1914)
https://github.com/python/cpython/commit/cca3d4aa25a7aea0cda90dd2aa012f58c85e7e24


----------

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

From report at bugs.python.org  Thu Jun  1 23:27:41 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 02 Jun 2017 03:27:41 +0000
Subject: [docs] [issue29660] Document that print/format_exception ignore
 etype
In-Reply-To: <1488158499.0.0.645448196253.issue29660@psf.upfronthosting.co.za>
Message-ID: <1496374061.93.0.460395639513.issue29660@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Thanks :)

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

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

From report at bugs.python.org  Fri Jun  2 00:41:43 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 02 Jun 2017 04:41:43 +0000
Subject: [docs] [issue30052] URL Quoting page links to function Bytes
 instead of defintion
In-Reply-To: <1492001374.68.0.411275444037.issue30052@psf.upfronthosting.co.za>
Message-ID: <1496378503.97.0.0196825635444.issue30052@psf.upfronthosting.co.za>


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


----------
pull_requests: +1995

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

From report at bugs.python.org  Fri Jun  2 00:56:26 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 02 Jun 2017 04:56:26 +0000
Subject: [docs] [issue30052] URL Quoting page links to function Bytes
 instead of defintion
In-Reply-To: <1492001374.68.0.411275444037.issue30052@psf.upfronthosting.co.za>
Message-ID: <1496379386.56.0.312625963472.issue30052@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 1c92c0edca413c6f8ce8ec326a67451ae751ead9 by Mariatta in branch '3.6':
bpo-30052: Link `bytes` & `bytearray` to stdtypes not functions  (GH-1271) (GH-1915)
https://github.com/python/cpython/commit/1c92c0edca413c6f8ce8ec326a67451ae751ead9


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

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

From report at bugs.python.org  Fri Jun  2 03:18:32 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Fri, 02 Jun 2017 07:18:32 +0000
Subject: [docs] [issue30538] Functional Programming HOWTO describes one
 argument itertools.count()
In-Reply-To: <1496316755.99.0.127514740016.issue30538@psf.upfronthosting.co.za>
Message-ID: <1496387911.98.0.349022412655.issue30538@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

If you would like, go ahead an submit a PR.

----------
assignee: docs at python -> rhettinger
nosy: +rhettinger
priority: normal -> low

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

From report at bugs.python.org  Fri Jun  2 05:06:21 2017
From: report at bugs.python.org (=?utf-8?q?Erik_Bystr=C3=B6m?=)
Date: Fri, 02 Jun 2017 09:06:21 +0000
Subject: [docs] [issue30548] typo in documentation for create_autospec
Message-ID: <1496394381.09.0.91116482689.issue30548@psf.upfronthosting.co.za>


New submission from Erik Bystr?m:

"a class" should most probably be replaced by "an instance" in the documentation for create_autospec.

"You can use a class as the spec for an instance object by passing instance=True. The returned mock will only be callable if instances of the mock are callable."

https://docs.python.org/3/library/unittest.mock.html#unittest.mock.create_autospec

----------
assignee: docs at python
components: Documentation
messages: 294993
nosy: Erik Bystr?m, docs at python
priority: normal
severity: normal
status: open
title: typo in documentation for create_autospec
type: enhancement
versions: Python 3.6

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

From report at bugs.python.org  Fri Jun  2 05:49:46 2017
From: report at bugs.python.org (Eric O. LEBIGOT)
Date: Fri, 02 Jun 2017 09:49:46 +0000
Subject: [docs] [issue30550] Document order-preserving dictionary output in
 json
In-Reply-To: <1496396847.32.0.655591837652.issue30550@psf.upfronthosting.co.za>
Message-ID: <1496396986.89.0.346225750982.issue30550@psf.upfronthosting.co.za>


Changes by Eric O. LEBIGOT <eric.lebigot at normalesup.org>:


----------
assignee:  -> docs at python
components: +Documentation -Library (Lib)
nosy: +docs at python

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

From report at bugs.python.org  Fri Jun  2 07:17:36 2017
From: report at bugs.python.org (Xavier Morel)
Date: Fri, 02 Jun 2017 11:17:36 +0000
Subject: [docs] [issue30535] Warn that meta_path is not empty
In-Reply-To: <1496307550.81.0.122215532062.issue30535@psf.upfronthosting.co.za>
Message-ID: <1496402256.68.0.0674236158231.issue30535@psf.upfronthosting.co.za>


Xavier Morel added the comment:

> I'm fine with adding a note to the Python 2 docs, but putting it in Python 3 seems to be going in the wrong direction as having sys.meta_path not be empty is how Python will be going forward.

I don't think putting a note is any hint that the Python 3 behaviour (which I appreciate) would change, it would simply tell the reader that the list is not empty by default and they ought decide whether they want their finders to take precedence over (and insert at head) or be fallback to (and append) the builtin finders.

It could also link to the standard/builtin finders.

----------

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

From report at bugs.python.org  Fri Jun  2 07:21:45 2017
From: report at bugs.python.org (Xavier Morel)
Date: Fri, 02 Jun 2017 11:21:45 +0000
Subject: [docs] [issue30535] Warn that meta_path is not empty
In-Reply-To: <1496307550.81.0.122215532062.issue30535@psf.upfronthosting.co.za>
Message-ID: <1496402504.94.0.589128231866.issue30535@psf.upfronthosting.co.za>


Xavier Morel added the comment:

> A warning is probably too strong.  Also, it's easy to check sys.meta_path at the interpreter prompt, so I'm not sure it's worth mentioning at all.

It's easy if you think of it and did not miss a small bit of the Python 3.3 release note indicating that the *documented guarantees* of Python 2.x, 3.0, 3.1 and 3.2 had been dropped, even as they were incorrectly still present in the official documentation itself.

I spent a few hours trying to understand why our import hooks did not work correctly anymore in 3.5, and I never even considered printing sys.meta_path in an open interpreter, I realised the behavioural change because I ended up printing meta_path after the addition of our custom hooks to make sure they were actually there.

----------

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

From report at bugs.python.org  Fri Jun  2 07:36:02 2017
From: report at bugs.python.org (Antoine Pitrou)
Date: Fri, 02 Jun 2017 11:36:02 +0000
Subject: [docs] [issue30535] Warn that meta_path is not empty
In-Reply-To: <1496402504.94.0.589128231866.issue30535@psf.upfronthosting.co.za>
Message-ID: <cb1d9ceb-5d75-b2d7-19f7-c662f858b960@free.fr>


Antoine Pitrou added the comment:

Le 02/06/2017 ? 13:21, Xavier Morel a ?crit :
> 
> I spent a few hours trying to understand why our import hooks did not work correctly anymore in 3.5, and I never even considered printing sys.meta_path in an open interpreter, I realised the behavioural change because I ended up printing meta_path after the addition of our custom hooks to make sure they were actually there.

Fair enough. So we can just add a sentence informing readers that
`meta_path`, by default, holds entries to handle the standard kinds of
modules (.py files, extension modules...).

----------

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

From report at bugs.python.org  Fri Jun  2 08:24:02 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Fri, 02 Jun 2017 12:24:02 +0000
Subject: [docs] [issue30538] Functional Programming HOWTO describes one
 argument itertools.count()
In-Reply-To: <1496316755.99.0.127514740016.issue30538@psf.upfronthosting.co.za>
Message-ID: <1496406242.73.0.508463013005.issue30538@psf.upfronthosting.co.za>


Changes by Cheryl Sabella <chekat2 at gmail.com>:


----------
pull_requests: +1998

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

From report at bugs.python.org  Fri Jun  2 08:29:53 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Fri, 02 Jun 2017 12:29:53 +0000
Subject: [docs] [issue30538] Functional Programming HOWTO describes one
 argument itertools.count()
In-Reply-To: <1496316755.99.0.127514740016.issue30538@psf.upfronthosting.co.za>
Message-ID: <1496406593.95.0.811247311187.issue30538@psf.upfronthosting.co.za>


Cheryl Sabella added the comment:

Submitted a PR, thank you.

I changed added the argument for count().  Also I noticed that the link to accumulate() was broken, so I fixed that and I added a link to functools in the references at the end of the page.

One other thing I noticed was that enumerate was described with one argument, but it takes two.  Should I update that as well?

Thanks!

----------

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

From report at bugs.python.org  Fri Jun  2 08:45:57 2017
From: report at bugs.python.org (Xavier Morel)
Date: Fri, 02 Jun 2017 12:45:57 +0000
Subject: [docs] [issue30535] Warn that meta_path is not empty
In-Reply-To: <1496307550.81.0.122215532062.issue30535@psf.upfronthosting.co.za>
Message-ID: <1496407557.51.0.0341962507976.issue30535@psf.upfronthosting.co.za>


Xavier Morel added the comment:

> Fair enough. So we can just add a sentence informing readers that
`meta_path`, by default, holds entries to handle the standard kinds of
modules (.py files, extension modules?).

Yeah that's basically what I meant, talking about a "warning" in python 3 may have been the wrong wording or given an incorrect impression, sorry about that.

----------

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

From report at bugs.python.org  Fri Jun  2 09:03:21 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Fri, 02 Jun 2017 13:03:21 +0000
Subject: [docs] [issue30052] URL Quoting page links to function Bytes
 instead of defintion
In-Reply-To: <1492001374.68.0.411275444037.issue30052@psf.upfronthosting.co.za>
Message-ID: <1496408601.1.0.801502708985.issue30052@psf.upfronthosting.co.za>


Cheryl Sabella added the comment:

Sorry, Mariatta.  I didn't realize this was waiting for a backport.

----------

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

From report at bugs.python.org  Fri Jun  2 09:30:59 2017
From: report at bugs.python.org (Nick Coghlan)
Date: Fri, 02 Jun 2017 13:30:59 +0000
Subject: [docs] [issue30052] URL Quoting page links to function Bytes
 instead of defintion
In-Reply-To: <1492001374.68.0.411275444037.issue30052@psf.upfronthosting.co.za>
Message-ID: <1496410259.41.0.64893094008.issue30052@psf.upfronthosting.co.za>


Nick Coghlan added the comment:


New changeset 7a82f9c2b94d31c8f4cc8bb8e3151765d8b148d7 by Nick Coghlan in branch 'master':
bpo-30052: Always regenerate cross-references (#1339)
https://github.com/python/cpython/commit/7a82f9c2b94d31c8f4cc8bb8e3151765d8b148d7


----------

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

From report at bugs.python.org  Fri Jun  2 10:04:24 2017
From: report at bugs.python.org (Nick Coghlan)
Date: Fri, 02 Jun 2017 14:04:24 +0000
Subject: [docs] [issue30052] URL Quoting page links to function Bytes
 instead of defintion
In-Reply-To: <1492001374.68.0.411275444037.issue30052@psf.upfronthosting.co.za>
Message-ID: <1496412264.35.0.682245146229.issue30052@psf.upfronthosting.co.za>


Changes by Nick Coghlan <ncoghlan at gmail.com>:


----------
pull_requests: +1999

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

From report at bugs.python.org  Fri Jun  2 10:05:23 2017
From: report at bugs.python.org (Nick Coghlan)
Date: Fri, 02 Jun 2017 14:05:23 +0000
Subject: [docs] [issue30052] URL Quoting page links to function Bytes
 instead of defintion
In-Reply-To: <1492001374.68.0.411275444037.issue30052@psf.upfronthosting.co.za>
Message-ID: <1496412323.08.0.77106705806.issue30052@psf.upfronthosting.co.za>


Nick Coghlan added the comment:

Not your fault, Cheryl! I unfortunately got distracted and didn't follow up on the backports for several PRs I merged a while back. Mariatta has been graciously cleaning some of those up rather than leaving them lingering the way I had been :)

I also just noticed that I never merged the PR to always regenerate the cross-references, so I went ahead and did that, and also submitted the corresponding 3.6 backport PR.

----------

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

From report at bugs.python.org  Fri Jun  2 11:01:22 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Fri, 02 Jun 2017 15:01:22 +0000
Subject: [docs] [issue30538] Functional Programming HOWTO describes one
 argument itertools.count()
In-Reply-To: <1496316755.99.0.127514740016.issue30538@psf.upfronthosting.co.za>
Message-ID: <1496415682.2.0.384452343412.issue30538@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

> enumerate was described with one argument, but it takes two.
> Should I update that as well?

Yes please.

----------

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

From report at bugs.python.org  Fri Jun  2 11:06:45 2017
From: report at bugs.python.org (Eric Snow)
Date: Fri, 02 Jun 2017 15:06:45 +0000
Subject: [docs] [issue30535] Warn that meta_path is not empty
In-Reply-To: <1496307550.81.0.122215532062.issue30535@psf.upfronthosting.co.za>
Message-ID: <1496416005.9.0.385063023552.issue30535@psf.upfronthosting.co.za>


Changes by Eric Snow <ericsnowcurrently at gmail.com>:


----------
keywords: +easy

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

From report at bugs.python.org  Fri Jun  2 14:23:47 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 02 Jun 2017 18:23:47 +0000
Subject: [docs] [issue30535] Warn that meta_path is not empty
In-Reply-To: <1496307550.81.0.122215532062.issue30535@psf.upfronthosting.co.za>
Message-ID: <1496427827.19.0.773498937876.issue30535@psf.upfronthosting.co.za>


Brett Cannon added the comment:

Yeah, there's actually a specific 'warning' directive which puts text in the docs in a red box to make it a full-blown warning which is what I thought you wanted, having it say "this is different than Python 2!". Having a sentence that just states how things are without referring to Python 2 is totally fine.

----------

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

From report at bugs.python.org  Fri Jun  2 14:36:05 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 02 Jun 2017 18:36:05 +0000
Subject: [docs] [issue24899] Add an os.path <=> pathlib equivalence table in
 pathlib docs
In-Reply-To: <1440050617.44.0.44226546659.issue24899@psf.upfronthosting.co.za>
Message-ID: <1496428564.93.0.274519054857.issue24899@psf.upfronthosting.co.za>


Brett Cannon added the comment:


New changeset ae8750bca8234a9af9382b9d7e457b57f810ad64 by Brett Cannon (Jamiel Almeida) in branch 'master':
bpo-24899: Add comparison table for os.path -> pathlib (GH-1753)
https://github.com/python/cpython/commit/ae8750bca8234a9af9382b9d7e457b57f810ad64


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

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

From report at bugs.python.org  Fri Jun  2 14:36:23 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 02 Jun 2017 18:36:23 +0000
Subject: [docs] [issue24899] Add an os.path <=> pathlib equivalence table in
 pathlib docs
In-Reply-To: <1440050617.44.0.44226546659.issue24899@psf.upfronthosting.co.za>
Message-ID: <1496428583.75.0.0202420185609.issue24899@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Jun  3 01:30:44 2017
From: report at bugs.python.org (Nick Coghlan)
Date: Sat, 03 Jun 2017 05:30:44 +0000
Subject: [docs] [issue30535] Explicitly note that meta_path is not empty
In-Reply-To: <1496307550.81.0.122215532062.issue30535@psf.upfronthosting.co.za>
Message-ID: <1496467844.5.0.49207187799.issue30535@psf.upfronthosting.co.za>


Nick Coghlan added the comment:

s/Warn/Explicitly note/ in the issue title :)

I think this is actually both important enough and subtle enough to warrant a ".. note::" callout in the docs.

In Python 3, it would say to use `sys.meta_path.insert(0, finder)` if you want your finder to take precedence over the default search locations, and `sys.meta_path.append(finder)` if you only want it handle cases that aren't already handled by the default machine.

In Python 2, it would say that custom finders on `sys.meta_path` will always take precedence over the default machinery, and if you want to do otherwise, you'll need to use `importlib2` and install its loaders into `sys.meta_path` ahead of your own.

----------
title: Warn that meta_path is not empty -> Explicitly note that meta_path is not empty

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

From report at bugs.python.org  Sat Jun  3 03:04:23 2017
From: report at bugs.python.org (Sanyam Khurana)
Date: Sat, 03 Jun 2017 07:04:23 +0000
Subject: [docs] [issue25910] Fixing links in documentation
In-Reply-To: <1450530544.1.0.9187941337.issue25910@psf.upfronthosting.co.za>
Message-ID: <1496473463.63.0.545967369157.issue25910@psf.upfronthosting.co.za>


Sanyam Khurana added the comment:

Hi,

If this work is not being actively worked on, can I work on this and fix the remaining links?

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

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

From report at bugs.python.org  Sat Jun  3 03:04:30 2017
From: report at bugs.python.org (Martin Panter)
Date: Sat, 03 Jun 2017 07:04:30 +0000
Subject: [docs] [issue30558] [Suggestion] Improve documentation for set() API
In-Reply-To: <1496462736.53.0.208043684916.issue30558@psf.upfronthosting.co.za>
Message-ID: <1496473470.17.0.900707260402.issue30558@psf.upfronthosting.co.za>


Martin Panter added the comment:

Did you see <https://docs.python.org/3.6/library/stdtypes.html#set-types-set-frozenset>?

----------
assignee:  -> docs at python
components: +Documentation
nosy: +docs at python, martin.panter
status: open -> pending

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

From report at bugs.python.org  Sat Jun  3 05:39:32 2017
From: report at bugs.python.org (SilentGhost)
Date: Sat, 03 Jun 2017 09:39:32 +0000
Subject: [docs] [issue25910] Fixing links in documentation
In-Reply-To: <1450530544.1.0.9187941337.issue25910@psf.upfronthosting.co.za>
Message-ID: <1496482772.11.0.32950572995.issue25910@psf.upfronthosting.co.za>


SilentGhost added the comment:

>  can I work on this and fix the remaining links?
Please do.

----------

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

From report at bugs.python.org  Sat Jun  3 09:08:32 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 03 Jun 2017 13:08:32 +0000
Subject: [docs] [issue25910] Fixing links in documentation
In-Reply-To: <1450530544.1.0.9187941337.issue25910@psf.upfronthosting.co.za>
Message-ID: <1496495312.48.0.163457286332.issue25910@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

I think only lawyers or people related to the Zope Corporation and the BeOpen PythonLabs team can help with fixing the links to http://www.zope.com/ and http://www.pythonlabs.com/logos.html.

----------

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

From report at bugs.python.org  Sat Jun  3 10:52:13 2017
From: report at bugs.python.org (Barry A. Warsaw)
Date: Sat, 03 Jun 2017 14:52:13 +0000
Subject: [docs] [issue25910] Fixing links in documentation
In-Reply-To: <1450530544.1.0.9187941337.issue25910@psf.upfronthosting.co.za>
Message-ID: <1496501533.53.0.048219222599.issue25910@psf.upfronthosting.co.za>


Barry A. Warsaw added the comment:

Adding Jim Fulton (for Zope) and Guido (for Pythonlabs).  I don't know who owns the former, but I'm fairly sure Guido owns the pythonlabs domain.

----------
nosy: +gvanrossum, j1m

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

From report at bugs.python.org  Sat Jun  3 11:33:31 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Sat, 03 Jun 2017 15:33:31 +0000
Subject: [docs] [issue30538] Functional Programming HOWTO describes one
 argument itertools.count()
In-Reply-To: <1496316755.99.0.127514740016.issue30538@psf.upfronthosting.co.za>
Message-ID: <1496504011.02.0.0111244449509.issue30538@psf.upfronthosting.co.za>


Cheryl Sabella added the comment:

Thank you.  I've added that.  

This may seem like an odd question, but should I assume that the docs should always match the code?  For example, in the Functional HOWTO, I wasn't sure if the arguments were left off purposely or if it was just something that hadn't been updated.  If the docs should always match, then I wouldn't have to ask so many questions if I see another place where this happens.

Also, the example for enumerate is this:

f = open('data.txt', 'r')
for i, line in enumerate(f):
    if line.strip() == '':
        print('Blank line at line #%i' % i)

Is it code churn to replace the old style string formatting or is that something else that should be done as clean-up?

----------

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

From report at bugs.python.org  Sat Jun  3 13:30:42 2017
From: report at bugs.python.org (Guido van Rossum)
Date: Sat, 03 Jun 2017 17:30:42 +0000
Subject: [docs] [issue25910] Fixing links in documentation
In-Reply-To: <1496501533.53.0.048219222599.issue25910@psf.upfronthosting.co.za>
Message-ID: <CAP7+vJ+yQxt7pY3uj5kSqx_H05UAz9vknLUxA_B4p7EW5bSXSw@mail.gmail.com>


Guido van Rossum added the comment:

www.pythonlabs.com still exists. (The www. is mandatory.) And zope.org also
still works.

On Jun 3, 2017 7:52 AM, "Barry A. Warsaw" <report at bugs.python.org> wrote:

>
> Barry A. Warsaw added the comment:
>
> Adding Jim Fulton (for Zope) and Guido (for Pythonlabs).  I don't know who
> owns the former, but I'm fairly sure Guido owns the pythonlabs domain.
>
> ----------
> nosy: +gvanrossum, j1m
>
> _______________________________________
> Python tracker <report at bugs.python.org>
> <http://bugs.python.org/issue25910>
> _______________________________________
>

----------

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

From report at bugs.python.org  Sat Jun  3 13:37:22 2017
From: report at bugs.python.org (Jim Fulton)
Date: Sat, 03 Jun 2017 17:37:22 +0000
Subject: [docs] [issue25910] Fixing links in documentation
In-Reply-To: <1450530544.1.0.9187941337.issue25910@psf.upfronthosting.co.za>
Message-ID: <1496511442.09.0.386603504697.issue25910@psf.upfronthosting.co.za>


Jim Fulton added the comment:

Zope Corporation no longer exists. Any references to it should be in the past tense and without a link.

(The http://www.zope.org is for the Zope Foundation, which is a different thing.)

----------

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

From report at bugs.python.org  Sat Jun  3 15:08:02 2017
From: report at bugs.python.org (Ned Deily)
Date: Sat, 03 Jun 2017 19:08:02 +0000
Subject: [docs] [issue30558] [Suggestion] Improve documentation for set() API
In-Reply-To: <1496462736.53.0.208043684916.issue30558@psf.upfronthosting.co.za>
Message-ID: <1496516882.51.0.593824246011.issue30558@psf.upfronthosting.co.za>


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


----------
nosy: +rhettinger
status: pending -> open

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

From report at bugs.python.org  Sat Jun  3 15:57:57 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 03 Jun 2017 19:57:57 +0000
Subject: [docs] [issue25910] Fixing links in documentation
In-Reply-To: <1450530544.1.0.9187941337.issue25910@psf.upfronthosting.co.za>
Message-ID: <1496519877.09.0.467961098048.issue25910@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

> www.pythonlabs.com still exists. (The www. is mandatory.)

But http://www.pythonlabs.com/logos.html doesn't. And since this link is a part of the BeOpen.com license, changing it changes the license. I don't know whether this part of the license is valid if the referred resource no longer available.

----------

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

From report at bugs.python.org  Sat Jun  3 16:05:23 2017
From: report at bugs.python.org (Sanyam Khurana)
Date: Sat, 03 Jun 2017 20:05:23 +0000
Subject: [docs] [issue25910] Fixing links in documentation
In-Reply-To: <1450530544.1.0.9187941337.issue25910@psf.upfronthosting.co.za>
Message-ID: <1496520323.56.0.867188892647.issue25910@psf.upfronthosting.co.za>


Changes by Sanyam Khurana <sanyam.khurana01 at gmail.com>:


----------
pull_requests: +2010

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

From report at bugs.python.org  Sat Jun  3 16:26:18 2017
From: report at bugs.python.org (Guido van Rossum)
Date: Sat, 03 Jun 2017 20:26:18 +0000
Subject: [docs] [issue25910] Fixing links in documentation
In-Reply-To: <1496520323.56.0.867188892647.issue25910@psf.upfronthosting.co.za>
Message-ID: <CAP7+vJJM5wDpyrOx+6o4hGXUXVM0=1FpAs9gQxkikfmCnpBshA@mail.gmail.com>


Guido van Rossum added the comment:

I can make the logos.html page appear. Just keep the link in the license as
it is.

On Jun 3, 2017 1:05 PM, "Sanyam Khurana" <report at bugs.python.org> wrote:

>
> Changes by Sanyam Khurana <sanyam.khurana01 at gmail.com>:
>
>
> ----------
> pull_requests: +2010
>
> _______________________________________
> Python tracker <report at bugs.python.org>
> <http://bugs.python.org/issue25910>
> _______________________________________
>

----------

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

From report at bugs.python.org  Sat Jun  3 19:31:50 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Sat, 03 Jun 2017 23:31:50 +0000
Subject: [docs] [issue30538] Functional Programming HOWTO describes one
 argument itertools.count()
In-Reply-To: <1496316755.99.0.127514740016.issue30538@psf.upfronthosting.co.za>
Message-ID: <1496532710.52.0.439493184102.issue30538@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

> Is it code churn to replace the old style string formatting
> or is that something else that should be done as clean-up?

Let's leave it as is.  Old-style formatting is still valid and is not going away.   We consciously decided not to sweep through the docs change the string formatting style.  Also, since both occur quite a bit in the wild, it is is useful for the docs to show some of both.

----------

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

From report at bugs.python.org  Sat Jun  3 19:33:37 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Sat, 03 Jun 2017 23:33:37 +0000
Subject: [docs] [issue30558] [Suggestion] Improve documentation for set() API
In-Reply-To: <1496462736.53.0.208043684916.issue30558@psf.upfronthosting.co.za>
Message-ID: <1496532817.14.0.327150142477.issue30558@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

This looks like an invalid request.

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

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

From report at bugs.python.org  Sun Jun  4 07:00:08 2017
From: report at bugs.python.org (desbma)
Date: Sun, 04 Jun 2017 11:00:08 +0000
Subject: [docs] [issue28206] signal.Signals not documented
In-Reply-To: <1474297204.47.0.613989661481.issue28206@psf.upfronthosting.co.za>
Message-ID: <1496574008.45.0.646952794937.issue28206@psf.upfronthosting.co.za>


Changes by desbma <dutch109 at gmail.com>:


----------
pull_requests: +2018

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

From report at bugs.python.org  Sun Jun  4 11:50:29 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 04 Jun 2017 15:50:29 +0000
Subject: [docs] [issue26656] Documentation for re.compile is a bit outdated
In-Reply-To: <1459178484.74.0.770971045402.issue26656@psf.upfronthosting.co.za>
Message-ID: <1496591429.52.0.650108062203.issue26656@psf.upfronthosting.co.za>


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


----------
keywords: +easy
status: open -> pending

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

From report at bugs.python.org  Sun Jun  4 11:57:51 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 04 Jun 2017 15:57:51 +0000
Subject: [docs] [issue23532] add example of 'first match wins' to regex "|"
 documentation?
In-Reply-To: <1424991623.26.0.907615110662.issue23532@psf.upfronthosting.co.za>
Message-ID: <1496591871.28.0.787526931147.issue23532@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

>From the documentation:

"""
As the target string is scanned, REs separated by ``'|'`` are tried from left to right. When one pattern completely matches, that branch is accepted. This means that once ``A`` matches, ``B`` will not be tested further, even if it would produce a longer overall match.  In other words, the ``'|'`` operator is never greedy.
"""

I think this completely describes the behavior.

----------
nosy: +serhiy.storchaka
resolution:  -> not a bug
status: open -> pending

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

From report at bugs.python.org  Sun Jun  4 12:19:21 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Sun, 04 Jun 2017 16:19:21 +0000
Subject: [docs] [issue23532] add example of 'first match wins' to regex "|"
 documentation?
In-Reply-To: <1424991623.26.0.907615110662.issue23532@psf.upfronthosting.co.za>
Message-ID: <1496593161.45.0.565105236902.issue23532@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

I concur with Serhiy that the docs correctly and completely describe the behavior.

----------
nosy: +rhettinger
status: pending -> open

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

From report at bugs.python.org  Sun Jun  4 12:37:25 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Sun, 04 Jun 2017 16:37:25 +0000
Subject: [docs] [issue26656] Documentation for re.compile is a bit outdated
In-Reply-To: <1459178484.74.0.770971045402.issue26656@psf.upfronthosting.co.za>
Message-ID: <1496594245.37.0.231644612951.issue26656@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

FWIW, I think the sentence is fine as-is.  The "which can be used" part doesn't purport to be all inclusive.   I rather like that at match() and search() are mentioned -- this is better than more vague reference to "the methods described below" -- and this is better than listing out every method.

I vote for leaving this alone.

----------
nosy: +rhettinger
status: pending -> open

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

From report at bugs.python.org  Sun Jun  4 13:37:29 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Sun, 04 Jun 2017 17:37:29 +0000
Subject: [docs] [issue30558] [Suggestion] Improve documentation for set() API
In-Reply-To: <1496462736.53.0.208043684916.issue30558@psf.upfronthosting.co.za>
Message-ID: <1496597849.75.0.227178836659.issue30558@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sun Jun  4 13:39:23 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Sun, 04 Jun 2017 17:39:23 +0000
Subject: [docs] [issue30538] Functional Programming HOWTO describes one
 argument itertools.count()
In-Reply-To: <1496316755.99.0.127514740016.issue30538@psf.upfronthosting.co.za>
Message-ID: <1496597963.16.0.227963743012.issue30538@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:


New changeset 9be4ff359daa67cde6246494f643ed7cd2825d46 by Raymond Hettinger (csabella) in branch 'master':
bpo-30538: Update count() in Functional Programming HOWTO (#1919)
https://github.com/python/cpython/commit/9be4ff359daa67cde6246494f643ed7cd2825d46


----------

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

From report at bugs.python.org  Sun Jun  4 13:39:54 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Sun, 04 Jun 2017 17:39:54 +0000
Subject: [docs] [issue30538] Functional Programming HOWTO describes one
 argument itertools.count()
In-Reply-To: <1496316755.99.0.127514740016.issue30538@psf.upfronthosting.co.za>
Message-ID: <1496597994.01.0.505070887855.issue30538@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

Thank you for the PR.

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

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

From report at bugs.python.org  Sun Jun  4 13:41:43 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Sun, 04 Jun 2017 17:41:43 +0000
Subject: [docs] [issue30530] Descriptors HowTo: Example on function.__get__
 needs update
In-Reply-To: <1496265085.29.0.159074921199.issue30530@psf.upfronthosting.co.za>
Message-ID: <1496598103.61.0.909394417194.issue30530@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

Mariatta, feel free to apply and backport once the CLA is signed.

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

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

From report at bugs.python.org  Sun Jun  4 14:33:55 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 04 Jun 2017 18:33:55 +0000
Subject: [docs] [issue30538] Functional Programming HOWTO describes one
 argument itertools.count()
In-Reply-To: <1496316755.99.0.127514740016.issue30538@psf.upfronthosting.co.za>
Message-ID: <1496601235.83.0.839143995518.issue30538@psf.upfronthosting.co.za>


Cheryl Sabella added the comment:

Thank you.  And thank you for explaining about the strings.  That's what I suspected, so I appreciate you confirming it.

----------

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

From report at bugs.python.org  Sun Jun  4 16:02:18 2017
From: report at bugs.python.org (James Lu)
Date: Sun, 04 Jun 2017 20:02:18 +0000
Subject: [docs] [issue30568] README Formatting
Message-ID: <1496606538.63.0.614342546478.issue30568@psf.upfronthosting.co.za>


New submission from James Lu:

- Shorten the Copyright statement from a list of years (`2001, 2002, 2003, ... 2017`) into `2001-2017`
  - Extend copyright date at end of README from 2016 to 2017
 - Ensure that there are two newlines before every header throughout the file (this was the original format)

----------
assignee: docs at python
components: Documentation
messages: 295140
nosy: James.Lu, docs at python
priority: normal
pull_requests: 2020
severity: normal
status: open
title: README Formatting
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/issue30568>
_______________________________________

From report at bugs.python.org  Sun Jun  4 16:18:34 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 04 Jun 2017 20:18:34 +0000
Subject: [docs] [issue30538] Functional Programming HOWTO describes one
 argument itertools.count()
In-Reply-To: <1496316755.99.0.127514740016.issue30538@psf.upfronthosting.co.za>
Message-ID: <1496607514.4.0.385953395883.issue30538@psf.upfronthosting.co.za>


Changes by Cheryl Sabella <chekat2 at gmail.com>:


----------
pull_requests: +2021

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

From report at bugs.python.org  Sun Jun  4 16:19:35 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 04 Jun 2017 20:19:35 +0000
Subject: [docs] [issue30538] Functional Programming HOWTO describes one
 argument itertools.count()
In-Reply-To: <1496316755.99.0.127514740016.issue30538@psf.upfronthosting.co.za>
Message-ID: <1496607575.46.0.719517113135.issue30538@psf.upfronthosting.co.za>


Changes by Cheryl Sabella <chekat2 at gmail.com>:


----------
pull_requests: +2022

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

From report at bugs.python.org  Sun Jun  4 16:49:14 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 04 Jun 2017 20:49:14 +0000
Subject: [docs] [issue18280] Documentation is too personalized
In-Reply-To: <1371889714.5.0.753258621658.issue18280@psf.upfronthosting.co.za>
Message-ID: <1496609354.76.0.227291320441.issue18280@psf.upfronthosting.co.za>


Cheryl Sabella added the comment:

Would it be OK for me to tackle this?

----------
nosy: +csabella

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

From report at bugs.python.org  Sun Jun  4 16:52:33 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 04 Jun 2017 20:52:33 +0000
Subject: [docs] [issue30569] Tutorial section 2.1 has *nix example at 3.7,
 but Windows at 3.6
Message-ID: <1496609553.39.0.613003310721.issue30569@psf.upfronthosting.co.za>


New submission from Cheryl Sabella:

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

The first lines for the location/command have been updated for 3.7, but next paragraph for Windows has not been updated.

----------
assignee: docs at python
components: Documentation
messages: 295142
nosy: csabella, docs at python
priority: normal
severity: normal
status: open
title: Tutorial section 2.1 has *nix example at 3.7, but Windows at 3.6
type: enhancement
versions: Python 3.7

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

From report at bugs.python.org  Sun Jun  4 16:59:54 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 04 Jun 2017 20:59:54 +0000
Subject: [docs] [issue30568] README Formatting
In-Reply-To: <1496606538.63.0.614342546478.issue30568@psf.upfronthosting.co.za>
Message-ID: <1496609994.68.0.573112319336.issue30568@psf.upfronthosting.co.za>


Cheryl Sabella added the comment:

I had made the same suggestion a few months ago and found that it had already been discussed.  :-)

Duplicate of http://bugs.python.org/issue29555.

----------
nosy: +csabella

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

From report at bugs.python.org  Sun Jun  4 17:10:28 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 04 Jun 2017 21:10:28 +0000
Subject: [docs] [issue26602] argparse doc introduction is inappropriately
 targeted
In-Reply-To: <1458562294.77.0.347454712136.issue26602@psf.upfronthosting.co.za>
Message-ID: <1496610628.11.0.279160268968.issue26602@psf.upfronthosting.co.za>


Cheryl Sabella added the comment:

If it helps at all, I first learned about argparse a few weeks ago.  I first went to the doc page and then immediately went to the tutorial, as suggested.  I didn't find it difficult or off-putting at all.  In fact, I loved that there was a tutorial that it explained it perfectly for my level as a newbie.  I've referenced the doc page a few times since, but I haven't read it from beginning to end like I did to learn the str functions, for example.  I think the doc page should be more advanced for people who need to know it's full power (as it is now) and the tutorial can serve newbies (as it does now).

----------
nosy: +csabella

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

From report at bugs.python.org  Sun Jun  4 17:32:57 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 04 Jun 2017 21:32:57 +0000
Subject: [docs] [issue12067] Doc: remove errors about mixed-type comparisons.
In-Reply-To: <1305237573.86.0.646542413513.issue12067@psf.upfronthosting.co.za>
Message-ID: <1496611977.59.0.562087172736.issue12067@psf.upfronthosting.co.za>


Cheryl Sabella added the comment:

It appears all the patches for this issue have been applied.  Is the only open item the changes to test_compare?

----------
nosy: +csabella

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

From report at bugs.python.org  Sun Jun  4 19:13:43 2017
From: report at bugs.python.org (Guido van Rossum)
Date: Sun, 04 Jun 2017 23:13:43 +0000
Subject: [docs] [issue25910] Fixing links in documentation
In-Reply-To: <1450530544.1.0.9187941337.issue25910@psf.upfronthosting.co.za>
Message-ID: <1496618023.28.0.495723243892.issue25910@psf.upfronthosting.co.za>


Guido van Rossum added the comment:

I've done what I can for the logos: http://www.pythonlabs.com/logos.html

----------

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

From report at bugs.python.org  Sun Jun  4 22:46:52 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 05 Jun 2017 02:46:52 +0000
Subject: [docs] [issue30530] Descriptors HowTo: Example on function.__get__
 needs update
In-Reply-To: <1496265085.29.0.159074921199.issue30530@psf.upfronthosting.co.za>
Message-ID: <1496630812.72.0.395624933946.issue30530@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 1bced56567335745f91676192fc39c06aab30da9 by Mariatta (Mariano Anaya) in branch 'master':
bpo-30530: Update Descriptor How To Documentation (GH-1845)
https://github.com/python/cpython/commit/1bced56567335745f91676192fc39c06aab30da9


----------

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

From report at bugs.python.org  Sun Jun  4 22:48:45 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 05 Jun 2017 02:48:45 +0000
Subject: [docs] [issue30530] Descriptors HowTo: Example on function.__get__
 needs update
In-Reply-To: <1496265085.29.0.159074921199.issue30530@psf.upfronthosting.co.za>
Message-ID: <1496630925.09.0.14528677779.issue30530@psf.upfronthosting.co.za>


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


----------
pull_requests: +2024

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

From report at bugs.python.org  Sun Jun  4 22:48:53 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 05 Jun 2017 02:48:53 +0000
Subject: [docs] [issue30530] Descriptors HowTo: Example on function.__get__
 needs update
In-Reply-To: <1496265085.29.0.159074921199.issue30530@psf.upfronthosting.co.za>
Message-ID: <1496630933.21.0.265248248343.issue30530@psf.upfronthosting.co.za>


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


----------
pull_requests: +2025

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

From report at bugs.python.org  Sun Jun  4 22:49:08 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 05 Jun 2017 02:49:08 +0000
Subject: [docs] [issue30530] Descriptors HowTo: Example on function.__get__
 needs update
In-Reply-To: <1496265085.29.0.159074921199.issue30530@psf.upfronthosting.co.za>
Message-ID: <1496630948.53.0.283531981311.issue30530@psf.upfronthosting.co.za>


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


----------
stage: patch review -> backport needed

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

From report at bugs.python.org  Sun Jun  4 23:04:53 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 05 Jun 2017 03:04:53 +0000
Subject: [docs] [issue30568] README Formatting
In-Reply-To: <1496606538.63.0.614342546478.issue30568@psf.upfronthosting.co.za>
Message-ID: <1496631893.59.0.313321855442.issue30568@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Thanks :) Yes the issue with copyright in the docs is still pending.
I'm closing this as a duplicate.

----------
nosy: +Mariatta
resolution:  -> duplicate
stage:  -> resolved
status: open -> closed
superseder:  -> Update Python Software Foundation Copyright Year

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

From report at bugs.python.org  Sun Jun  4 23:05:46 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 05 Jun 2017 03:05:46 +0000
Subject: [docs] [issue29555] Update Python Software Foundation Copyright Year
In-Reply-To: <1487088120.64.0.260258993464.issue29555@psf.upfronthosting.co.za>
Message-ID: <1496631946.04.0.771040900955.issue29555@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sun Jun  4 23:06:50 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 05 Jun 2017 03:06:50 +0000
Subject: [docs] [issue30530] Descriptors HowTo: Example on function.__get__
 needs update
In-Reply-To: <1496265085.29.0.159074921199.issue30530@psf.upfronthosting.co.za>
Message-ID: <1496632010.82.0.633133081938.issue30530@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 86eb93fae6fc5bf121de815b82697f2bc5bc126c by Mariatta in branch '3.6':
bpo-30530: Update Descriptor How To Documentation (GH-1845) (GH-1953)
https://github.com/python/cpython/commit/86eb93fae6fc5bf121de815b82697f2bc5bc126c


----------

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

From report at bugs.python.org  Sun Jun  4 23:09:18 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 05 Jun 2017 03:09:18 +0000
Subject: [docs] [issue30530] Descriptors HowTo: Example on function.__get__
 needs update
In-Reply-To: <1496265085.29.0.159074921199.issue30530@psf.upfronthosting.co.za>
Message-ID: <1496632158.31.0.172908844329.issue30530@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 1f04b900861686351977f6a7d51afa5fdc181b82 by Mariatta in branch '3.5':
bpo-30530: Update Descriptor How To Documentation (GH-1845) (GH-1954)
https://github.com/python/cpython/commit/1f04b900861686351977f6a7d51afa5fdc181b82


----------

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

From report at bugs.python.org  Sun Jun  4 23:10:35 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 05 Jun 2017 03:10:35 +0000
Subject: [docs] [issue30530] Descriptors HowTo: Example on function.__get__
 needs update
In-Reply-To: <1496265085.29.0.159074921199.issue30530@psf.upfronthosting.co.za>
Message-ID: <1496632235.46.0.604482764174.issue30530@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Thanks Mariano. I merged your PR and it's been backported to 3.5 and 3.6.

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

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

From report at bugs.python.org  Sun Jun  4 23:12:01 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 05 Jun 2017 03:12:01 +0000
Subject: [docs] [issue30538] Functional Programming HOWTO describes one
 argument itertools.count()
In-Reply-To: <1496316755.99.0.127514740016.issue30538@psf.upfronthosting.co.za>
Message-ID: <1496632320.97.0.0570494289861.issue30538@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset b32fb6c1fb6cdf019817176f573e60c0923a6e22 by Mariatta (csabella) in branch '3.5':
bpo-30538: Update count() in Functional Programming HOWTO (GH-1919) (GH-1944)
https://github.com/python/cpython/commit/b32fb6c1fb6cdf019817176f573e60c0923a6e22


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

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

From report at bugs.python.org  Sun Jun  4 23:12:25 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 05 Jun 2017 03:12:25 +0000
Subject: [docs] [issue30538] Functional Programming HOWTO describes one
 argument itertools.count()
In-Reply-To: <1496316755.99.0.127514740016.issue30538@psf.upfronthosting.co.za>
Message-ID: <1496632345.75.0.93277848496.issue30538@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset ce40550acd3a8928bb6fef4d4e73642a8a69745d by Mariatta (csabella) in branch '3.6':
bpo-30538: Update count() in Functional Programming HOWTO (GH-1919) (GH-1943)
https://github.com/python/cpython/commit/ce40550acd3a8928bb6fef4d4e73642a8a69745d


----------

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

From report at bugs.python.org  Mon Jun  5 00:42:06 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 05 Jun 2017 04:42:06 +0000
Subject: [docs] [issue25910] Fixing links in documentation
In-Reply-To: <1450530544.1.0.9187941337.issue25910@psf.upfronthosting.co.za>
Message-ID: <1496637726.45.0.289836726112.issue25910@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

Thank you!

What is left:

* Rewrite the text of license.rst for referring the Zope Corporation in the past tense and remove the link (and maybe add the reference to the Zope Foundation if it is related).

* Mark historical links http://www.vex.net/parnassus/ and http://svn.python.org/view/tracker/importer/ as dead.

----------

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

From report at bugs.python.org  Mon Jun  5 00:46:07 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 05 Jun 2017 04:46:07 +0000
Subject: [docs] [issue18280] Documentation is too personalized
In-Reply-To: <1371889714.5.0.753258621658.issue18280@psf.upfronthosting.co.za>
Message-ID: <1496637967.21.0.033156475638.issue18280@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

Fred, do you want to opine on this?

In some cases, like heapq.py, the personal touch is an essential and beautiful part of the presentation and is a cherished part of Python.  In other cases, it seems unnecessary or a little off-putting, so perhaps a few changes are warranted.

Personally, I've grown to really dislike the incessant stream of proposals to make broad sweeping trivial changes across the code or documentation to fix made-up problems (ones not reported or cared about by actual users).  In particular, I worry about sending some new dev on a mission to rewrite documentation that was written by domain experts (Alex Martelli reported that copy-editors "wreaked havoc" on one of his books just prior to publication by subtly changing the meaning or correctness of his prose while applying grammar rules and minor style edits -- I wish to avoid the same for us).

Also, I place high value on text written by Guido and think we lose something every time someone wants to rewrite it to fit their personal tastes and views of the language.  The tastes and views of module authors are more important are easily lost in style edits (especially those that change point of view, mood, or theme of presentation).

Another thought is that there should be different general rules for different sections.  The standard library docs tend to be more formal.  The language reference tends to be even more formal ("for language lawyers"). The tutorial tends to be personable.  The how-to guides are often have a personal touch and are the only places where we attribute authorship back individuals (actual by-lines at the top of the file).

[Cheryl Sabella]
> Would it be OK for me to tackle this?
You could, but I would really like to get you involved in more substantive work that involves thinking about real issues and real code.  IMO, this project isn't worthy of you time and is not on the critical path to your stated goals.   That said, feel free to volunteer for anything that interests you.

----------
assignee: docs at python -> fdrake
nosy: +fdrake, rhettinger
versions: +Python 3.7 -Python 2.7, Python 3.3, Python 3.4

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

From hrt.kalaria at gmail.com  Fri Jun  2 03:50:07 2017
From: hrt.kalaria at gmail.com (Herat Kalaria)
Date: Fri, 2 Jun 2017 13:20:07 +0530
Subject: [docs] Error in code at : 15.4 (argparser)
Message-ID: <CAOtvVuZZyXY+REcxsupJ_X0-wmnev9ABz_JvyqbCSF-TpGOjaQ@mail.gmail.com>

Hi,

I got an error while executing the code given in example 15.4.1. Error is:
too few arguments. Please look into this.

Thanks & Regards
Herat Kalaria
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170602/5df17100/attachment.html>

From report at bugs.python.org  Mon Jun  5 09:47:58 2017
From: report at bugs.python.org (Decorater)
Date: Mon, 05 Jun 2017 13:47:58 +0000
Subject: [docs] [issue30574] Document why embedding the interpreter can
 sometimes crash.
Message-ID: <1496670478.12.0.928840980105.issue30574@psf.upfronthosting.co.za>


New submission from Decorater:

According to this example at https://docs.python.org/3/extending/embedding.html#very-high-level-embedding you can use something similar on embedding the interpreter.

However for some reason it can crash on Windows and probably some other platforms no matter what python code you enter in the string. I am currently getting that issue on Windows even with the python DLL's being in the same folder of the embedded executable it seems (when I open the crash dump in VS2010 express) that it tried to access an memory address that it has no permissions to.

However I have been thinking as to why that might be. The system should have plenty of memory left for it to allocate and run just fine unless it wants to use an already active python process (why would that be when other applications that embed the interpreter seem to work just fine).

I think documenting there on when and iff the compiled code crashes with suggestions on how to fix them would be best to do on the page.

it could be that the example actually compiles but does not work anymore too. But why would it be on the page if it would compile but crash on any string put into it? Something makes me think the crash is on the Py_DecodeLocale line with the size_t * param being NULL.

----------
assignee: docs at python
components: Documentation, Windows
messages: 295187
nosy: Decorater, docs at python, paul.moore, steve.dower, tim.golden, zach.ware
priority: normal
severity: normal
status: open
title: Document why embedding the interpreter can sometimes crash.
versions: Python 3.5, Python 3.6, Python 3.7

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

From report at bugs.python.org  Mon Jun  5 09:55:46 2017
From: report at bugs.python.org (Paul Moore)
Date: Mon, 05 Jun 2017 13:55:46 +0000
Subject: [docs] [issue30574] Document why embedding the interpreter can
 sometimes crash.
In-Reply-To: <1496670478.12.0.928840980105.issue30574@psf.upfronthosting.co.za>
Message-ID: <1496670946.67.0.08916095884.issue30574@psf.upfronthosting.co.za>


Paul Moore added the comment:

I'm a bit confused what you're asking for here.

Certainly if you embed Python, you can get crashes, just as with any other C program. Pass an invalid pointer to a Python API, build your application and the Python DLL with incompatible C runtimes, free memory you don't own, ...

That's not really something we need to cover in the Python documentation, though, it's just things you need to understand if you're doing anything beyond the most trivial C programming.

If there's a specific issue that you're having, we'd need more details to say anything else.

----------

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

From report at bugs.python.org  Mon Jun  5 10:22:56 2017
From: report at bugs.python.org (Decorater)
Date: Mon, 05 Jun 2017 14:22:56 +0000
Subject: [docs] [issue30574] Document why embedding the interpreter can
 sometimes crash.
In-Reply-To: <1496670478.12.0.928840980105.issue30574@psf.upfronthosting.co.za>
Message-ID: <1496672576.91.0.507887375752.issue30574@psf.upfronthosting.co.za>


Decorater added the comment:

Well the example I linked if I compile it and try to run it it instantly crashes with no explainable reason. I am using the same compiler used to build the core too and the normal interpreter works just fine with the code I am trying to embed. So it seems to definitely be the Py_DecodeLocale or the Py_SetProgramName line.

----------

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

From report at bugs.python.org  Mon Jun  5 10:31:57 2017
From: report at bugs.python.org (Paul Moore)
Date: Mon, 05 Jun 2017 14:31:57 +0000
Subject: [docs] [issue30574] Document why embedding the interpreter can
 sometimes crash.
In-Reply-To: <1496670478.12.0.928840980105.issue30574@psf.upfronthosting.co.za>
Message-ID: <1496673117.52.0.518557225463.issue30574@psf.upfronthosting.co.za>


Paul Moore added the comment:

Worked fine for me:

>cl .\pyc.c /I $env:LOCALAPPDATA\Programs\Python\Python36\include $env:LOCALAPPDATA\Programs\Python\Python36\libs\python36.lib
Microsoft (R) C/C++ Optimizing Compiler Version 19.00.24213.1 for x64
Copyright (C) Microsoft Corporation.  All rights reserved.

pyc.c
Microsoft (R) Incremental Linker Version 14.00.24213.1
Copyright (C) Microsoft Corporation.  All rights reserved.

/out:pyc.exe
pyc.obj
...\Programs\Python\Python36\libs\python36.lib

>.\pyc.exe
Today is Mon Jun  5 15:27:45 2017

So it doesn't look like the problem is with the code, so much as with how you've done the build. The problem here is that there are so many possibilities for C compilation environments, that there's simply no way we could give a "this is how you set up to build an embedding application".

If you have specific suggestions for how to improve the documentation, a patch would be welcome. But in the absence of specifics, I don't think there's anything actionable in this report.

----------

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

From report at bugs.python.org  Mon Jun  5 10:39:47 2017
From: report at bugs.python.org (Decorater)
Date: Mon, 05 Jun 2017 14:39:47 +0000
Subject: [docs] [issue30574] Document why embedding the interpreter can
 sometimes crash.
In-Reply-To: <1496670478.12.0.928840980105.issue30574@psf.upfronthosting.co.za>
Message-ID: <1496673587.66.0.537702430472.issue30574@psf.upfronthosting.co.za>


Decorater added the comment:

hmm, maybe it was because I was compiling it inside of the VS2015 IDE in an project file and not with cl.exe directly.

----------

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

From report at bugs.python.org  Mon Jun  5 10:48:47 2017
From: report at bugs.python.org (Decorater)
Date: Mon, 05 Jun 2017 14:48:47 +0000
Subject: [docs] [issue30574] Document why embedding the interpreter can
 sometimes crash.
In-Reply-To: <1496670478.12.0.928840980105.issue30574@psf.upfronthosting.co.za>
Message-ID: <1496674127.6.0.537509214946.issue30574@psf.upfronthosting.co.za>


Decorater added the comment:

Well looks like with cl.exe it is still crashing.

----------

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

From report at bugs.python.org  Mon Jun  5 10:53:28 2017
From: report at bugs.python.org (Paul Moore)
Date: Mon, 05 Jun 2017 14:53:28 +0000
Subject: [docs] [issue30574] Document why embedding the interpreter can
 sometimes crash.
In-Reply-To: <1496670478.12.0.928840980105.issue30574@psf.upfronthosting.co.za>
Message-ID: <1496674408.78.0.140228557613.issue30574@psf.upfronthosting.co.za>


Paul Moore added the comment:

My bet is still on something like you compiling your code 32-bit and linking to 64-bit Python, or something like that.

----------

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

From report at bugs.python.org  Mon Jun  5 10:54:15 2017
From: report at bugs.python.org (R. David Murray)
Date: Mon, 05 Jun 2017 14:54:15 +0000
Subject: [docs] [issue30574] Document why embedding the interpreter can
 sometimes crash.
In-Reply-To: <1496670478.12.0.928840980105.issue30574@psf.upfronthosting.co.za>
Message-ID: <1496674455.39.0.170109093377.issue30574@psf.upfronthosting.co.za>


R. David Murray added the comment:

Agreed, there's nothing for us to do here.  It sounds like you may need to go to a help forum to work through your crash.

If you learn things that you think it would be valuable to add to the docs, please do submit a doc enhancement issue/PR.

----------
nosy: +r.david.murray
resolution:  -> not a bug
stage:  -> resolved
status: open -> closed

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

From report at bugs.python.org  Mon Jun  5 10:56:38 2017
From: report at bugs.python.org (Decorater)
Date: Mon, 05 Jun 2017 14:56:38 +0000
Subject: [docs] [issue30574] Document why embedding the interpreter can
 sometimes crash.
In-Reply-To: <1496670478.12.0.928840980105.issue30574@psf.upfronthosting.co.za>
Message-ID: <1496674598.59.0.903826845942.issue30574@psf.upfronthosting.co.za>


Decorater added the comment:

I am compiling and linking to 32 bit python based on the folder I entered for the lib file. Unless the lib file in the lib folder is somehow for the 64 bit one.

----------

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

From report at bugs.python.org  Mon Jun  5 11:12:18 2017
From: report at bugs.python.org (Decorater)
Date: Mon, 05 Jun 2017 15:12:18 +0000
Subject: [docs] [issue30574] Document why embedding the interpreter can
 sometimes crash.
In-Reply-To: <1496670478.12.0.928840980105.issue30574@psf.upfronthosting.co.za>
Message-ID: <1496675537.97.0.644911260229.issue30574@psf.upfronthosting.co.za>


Decorater added the comment:

Wait a minute, I think it is because the 32 and 64 bit python36.lib files are in the path environment variable so that might be the reason for the crash.

----------

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

From report at bugs.python.org  Mon Jun  5 11:19:25 2017
From: report at bugs.python.org (Decorater)
Date: Mon, 05 Jun 2017 15:19:25 +0000
Subject: [docs] [issue30574] Document why embedding the interpreter can
 sometimes crash.
In-Reply-To: <1496670478.12.0.928840980105.issue30574@psf.upfronthosting.co.za>
Message-ID: <1496675965.09.0.719025404181.issue30574@psf.upfronthosting.co.za>


Decorater added the comment:

E:\Users\Elsword\Documents\GitHub\TinyURL\app>call "E:\Program Files (x86)\Micro
soft Visual Studio 14.0\Common7\Tools\VsDevCmd.bat"

E:\Users\Elsword\Documents\GitHub\TinyURL\app>cd "E:\Users\Elsword\Documents\Git
Hub\TinyURL\app\"

E:\Users\Elsword\Documents\GitHub\TinyURL\app>RC.exe /r TinyURL.rc
Microsoft (R) Windows (R) Resource Compiler Version 10.0.10011.16384
Copyright (C) Microsoft Corporation.  All rights reserved.


E:\Users\Elsword\Documents\GitHub\TinyURL\app>cl.exe /Tc "TinyURL.c" /I E:\Python360\include E:\Python360\libs\python36.lib /link /OUT:"TinyURL.exe" /SUBSYSTEM:CONSOLE "TinyURL.res" /FIXED
Microsoft (R) C/C++ Optimizing Compiler Version 19.00.24215.1 for x86
Copyright (C) Microsoft Corporation.  All rights reserved.

TinyURL.c
TinyURL.c(204): warning C4129: '/': unrecognized character escape sequence
Microsoft (R) Incremental Linker Version 14.00.24215.1
Copyright (C) Microsoft Corporation.  All rights reserved.

/out:TinyURL.exe
/OUT:TinyURL.exe
/SUBSYSTEM:CONSOLE
TinyURL.res
/FIXED
TinyURL.obj
E:\Python360\libs\python36.lib

Wait a minute, it seems the build tools are a bit out of date.

----------

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

From report at bugs.python.org  Mon Jun  5 11:29:09 2017
From: report at bugs.python.org (Guido van Rossum)
Date: Mon, 05 Jun 2017 15:29:09 +0000
Subject: [docs] [issue25910] Fixing links in documentation
In-Reply-To: <1450530544.1.0.9187941337.issue25910@psf.upfronthosting.co.za>
Message-ID: <1496676549.16.0.533211353227.issue25910@psf.upfronthosting.co.za>


Guido van Rossum added the comment:

I suggest the following replacement for that paragraph in Doc/license.txt, as well as in LICENSE:

In May 2000, Guido and the Python core development team moved to
BeOpen.com to form the BeOpen PythonLabs team.  In October of the same
year, the PythonLabs team moved to Digital Creations, which became
Zope Corporation.  In 2001, the Python Software Foundation (PSF, see
https://www.python.org/psf/) was formed, a non-profit organization
created specifically to own Python-related Intellectual Property.
Zope Corporation was a sponsoring member of the PSF.

----------

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

From report at bugs.python.org  Mon Jun  5 11:32:49 2017
From: report at bugs.python.org (Jim Fulton)
Date: Mon, 05 Jun 2017 15:32:49 +0000
Subject: [docs] [issue25910] Fixing links in documentation
In-Reply-To: <1450530544.1.0.9187941337.issue25910@psf.upfronthosting.co.za>
Message-ID: <1496676769.44.0.734662460531.issue25910@psf.upfronthosting.co.za>


Jim Fulton added the comment:

+1

----------

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

From report at bugs.python.org  Mon Jun  5 16:43:33 2017
From: report at bugs.python.org (Aaron Hall)
Date: Mon, 05 Jun 2017 20:43:33 +0000
Subject: [docs] [issue26103] Contradiction in definition of "data
 descriptor" between (dotted lookup behavior/datamodel documentation) and
 (inspect lib/descriptor how-to)
In-Reply-To: <1452718612.1.0.925403449689.issue26103@psf.upfronthosting.co.za>
Message-ID: <1496695413.38.0.232084640914.issue26103@psf.upfronthosting.co.za>


Aaron Hall added the comment:

Bumping this - I intend to work on this next, if no objections.

----------

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

From report at bugs.python.org  Mon Jun  5 18:57:49 2017
From: report at bugs.python.org (Aaron Hall)
Date: Mon, 05 Jun 2017 22:57:49 +0000
Subject: [docs] [issue26103] Contradiction in definition of "data
 descriptor" between (dotted lookup behavior/datamodel documentation) and
 (inspect lib/descriptor how-to)
In-Reply-To: <1452718612.1.0.925403449689.issue26103@psf.upfronthosting.co.za>
Message-ID: <1496703469.31.0.238863495287.issue26103@psf.upfronthosting.co.za>


Changes by Aaron Hall <aaronchall at yahoo.com>:


----------
pull_requests: +2030

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

From report at bugs.python.org  Mon Jun  5 19:58:20 2017
From: report at bugs.python.org (Martin Panter)
Date: Mon, 05 Jun 2017 23:58:20 +0000
Subject: [docs] [issue12067] Doc: remove errors about mixed-type comparisons.
In-Reply-To: <1305237573.86.0.646542413513.issue12067@psf.upfronthosting.co.za>
Message-ID: <1496707099.42.0.848637395906.issue12067@psf.upfronthosting.co.za>


Martin Panter added the comment:

Yes I think I committed all the documentation. Someone needs to decide whether to use Andy?s tests as they are, or perhaps modify or drop some or all of them.

----------

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

From report at bugs.python.org  Mon Jun  5 21:45:57 2017
From: report at bugs.python.org (Martin Panter)
Date: Tue, 06 Jun 2017 01:45:57 +0000
Subject: [docs] [issue23019] pyexpat.errors wrongly bound to message strings
 instead of message codes
In-Reply-To: <1418111127.16.0.333870475533.issue23019@psf.upfronthosting.co.za>
Message-ID: <1496713557.85.0.214749340305.issue23019@psf.upfronthosting.co.za>


Martin Panter added the comment:

Also, even in the Py 3 docs, the ErrorCode parser attribute is said to be numeric, but there is a suggestion to compare it with ?constants? defined in the ?errors? (module) object. I guess it should be clarified that you can?t compare it directly; perhaps using ErrorString or Py 3?s ?errors.codes? is more appropriate?

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

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

From report at bugs.python.org  Mon Jun  5 22:19:41 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 06 Jun 2017 02:19:41 +0000
Subject: [docs] [issue30052] URL Quoting page links to function Bytes
 instead of defintion
In-Reply-To: <1492001374.68.0.411275444037.issue30052@psf.upfronthosting.co.za>
Message-ID: <1496715581.01.0.766284244477.issue30052@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 798cfb212383a6f5a31b610825d1af1d376804b2 by Mariatta (Nick Coghlan) in branch '3.6':
bpo-30052: Always regenerate cross-references (GH-1339) (GH-1921)
https://github.com/python/cpython/commit/798cfb212383a6f5a31b610825d1af1d376804b2


----------

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

From report at bugs.python.org  Mon Jun  5 22:20:48 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 06 Jun 2017 02:20:48 +0000
Subject: [docs] [issue30052] URL Quoting page links to function Bytes
 instead of defintion
In-Reply-To: <1492001374.68.0.411275444037.issue30052@psf.upfronthosting.co.za>
Message-ID: <1496715648.17.0.384324640671.issue30052@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Backport PR looks good so I went ahead and merged it :)
Thanks.

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

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

From report at bugs.python.org  Mon Jun  5 22:44:22 2017
From: report at bugs.python.org (Guido van Rossum)
Date: Tue, 06 Jun 2017 02:44:22 +0000
Subject: [docs] [issue12067] Doc: remove errors about mixed-type comparisons.
In-Reply-To: <1305237573.86.0.646542413513.issue12067@psf.upfronthosting.co.za>
Message-ID: <1496717061.87.0.937298628395.issue12067@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/issue12067>
_______________________________________

From report at bugs.python.org  Mon Jun  5 22:44:33 2017
From: report at bugs.python.org (Nick Coghlan)
Date: Tue, 06 Jun 2017 02:44:33 +0000
Subject: [docs] [issue30578] Misleading example in sys.set_coroutine_wrapper
 docs
Message-ID: <1496717073.05.0.260137843936.issue30578@psf.upfronthosting.co.za>


New submission from Nick Coghlan:

In issue 24342, the invocation of coroutine wrappers specified via sys.set_coroutine_wrapper was fixed to catch and report the case of infinite recursion, where the wrapper attempts to instantiate a nested coroutine (which would call the wrapper, which would attempt to instantiate the coroutine, etc, etc)

The docs for sys.set_coroutine_wrapper include an example of this failure case: https://docs.python.org/3/library/sys.html#sys.set_coroutine_wrapper

However, if you're not reading carefully, it looks like an example of how to *use* sys.set_coroutine_wrapper, rather than an example of a case that won't work.

It would be better to include an example that either doesn't wrap the coroutine at all, or else uses one of the non-native coroutine emulations to avoid the infinite recursion problem:

```
import asyncio, sys

def wrapper(coro):
    @asyncio.coroutine
    def wrap(coro):
        print("Coroutine started")
        result = yield from coro
        print("Coroutine finished")
        return result
    return wrap(coro)

sys.set_coroutine_wrapper(wrapper)

async def foo():
    print("Coroutine running")
    return "Coroutine result"

import asyncio
asyncio.get_event_loop().run_until_complete(foo())
```

Also related: I discovered in writing this that "sys.set_coroutine_wrapper(None)" doesn't actually turn off coroutine wrapping. Instead, you still get this exception when attempting to recursively define an unwrapped one:

RuntimeError: coroutine wrapper <NULL> attempted to recursively wrap <code object wrap at 0x7eff31fbde40, file "<stdin>", line 2>)

That error was produced as follows:

```
import sys, contextlib

@contextlib.contextmanager
def disable_coroutine_wrapping():
    wrapper = sys.get_coroutine_wrapper()
    sys.set_coroutine_wrapper(None)
    try:
        yield
    finally:
        sys.set_coroutine_wrapper(wrapper)

def wrapper(coro):
    async def wrap(coro):
        print("Coroutine started")
        result = await coro
        print("Coroutine finished")
        return result
    with disable_coroutine_wrapping():
        return wrap(coro)

sys.set_coroutine_wrapper(wrapper)

async def foo():
    print("Coroutine running")
    return "Coroutine result"

import asyncio
asyncio.get_event_loop().run_until_complete(foo())
```

----------
assignee: docs at python
components: Documentation
messages: 295231
nosy: docs at python, giampaolo.rodola, haypo, ncoghlan, yselivanov
priority: normal
severity: normal
stage: needs patch
status: open
title: Misleading example in sys.set_coroutine_wrapper docs
type: enhancement
versions: Python 3.6, Python 3.7

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

From report at bugs.python.org  Tue Jun  6 03:13:58 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 06 Jun 2017 07:13:58 +0000
Subject: [docs] [issue26103] Contradiction in definition of "data
 descriptor" between (dotted lookup behavior/datamodel documentation) and
 (inspect lib/descriptor how-to)
In-Reply-To: <1452718612.1.0.925403449689.issue26103@psf.upfronthosting.co.za>
Message-ID: <1496733238.56.0.649712293597.issue26103@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

This isn't just a documentation issue since it fixes inspect.isdatadescriptor(). I confirm that the new implementation better matches the C code. LGTM, but needed tests for inspect.isdatadescriptor() and a Misc/NEWS entry.

----------
assignee: docs at python -> 
nosy: +serhiy.storchaka
stage: needs patch -> patch review
versions: +Python 2.7, Python 3.7

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

From report at bugs.python.org  Tue Jun  6 12:12:06 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 06 Jun 2017 16:12:06 +0000
Subject: [docs] [issue23787] sum() function docstring lists arguments
 incorrectly
In-Reply-To: <1427455446.97.0.658394608092.issue23787@psf.upfronthosting.co.za>
Message-ID: <1496765525.93.0.643569216809.issue23787@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 536209ef92f16ea8823209a3c4b8763c0ec5d4bc by Mariatta in branch '2.7':
bpo-23787: Change sum() docstring from sequence to iterable (GH-1859)
https://github.com/python/cpython/commit/536209ef92f16ea8823209a3c4b8763c0ec5d4bc


----------

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

From report at bugs.python.org  Tue Jun  6 12:12:54 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 06 Jun 2017 16:12:54 +0000
Subject: [docs] [issue23787] sum() function docstring lists arguments
 incorrectly
In-Reply-To: <1427455446.97.0.658394608092.issue23787@psf.upfronthosting.co.za>
Message-ID: <1496765574.82.0.00671692501132.issue23787@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Raymond's patch has been applied to 2.7 branch.
Thanks :)

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

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

From report at bugs.python.org  Tue Jun  6 13:37:23 2017
From: report at bugs.python.org (wim glenn)
Date: Tue, 06 Jun 2017 17:37:23 +0000
Subject: [docs] [issue30583] docs mention datetuil presumably it should be
 dateutil
In-Reply-To: <1496770049.03.0.569012645786.issue30583@psf.upfronthosting.co.za>
Message-ID: <1496770643.95.0.163799007442.issue30583@psf.upfronthosting.co.za>


Changes by wim glenn <wim.glenn at gmail.com>:


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

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

From report at bugs.python.org  Tue Jun  6 13:37:53 2017
From: report at bugs.python.org (wim glenn)
Date: Tue, 06 Jun 2017 17:37:53 +0000
Subject: [docs] [issue30583] docs mention datetuil presumably it should be
 dateutil
In-Reply-To: <1496770049.03.0.569012645786.issue30583@psf.upfronthosting.co.za>
Message-ID: <1496770673.68.0.152455646386.issue30583@psf.upfronthosting.co.za>


Changes by wim glenn <wim.glenn at gmail.com>:


----------
type:  -> enhancement

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

From report at bugs.python.org  Tue Jun  6 13:54:44 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 06 Jun 2017 17:54:44 +0000
Subject: [docs] [issue30583] docs mention datetuil presumably it should be
 dateutil
In-Reply-To: <1496770049.03.0.569012645786.issue30583@psf.upfronthosting.co.za>
Message-ID: <1496771684.24.0.606607007665.issue30583@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 53f2af16551eb3a080da313257603c31ef8b93b4 by Mariatta (wim glenn) in branch 'master':
bpo-30583: Fix typo in datetime dateutil documentation (GH-1972)
https://github.com/python/cpython/commit/53f2af16551eb3a080da313257603c31ef8b93b4


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

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

From report at bugs.python.org  Tue Jun  6 14:06:21 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 06 Jun 2017 18:06:21 +0000
Subject: [docs] [issue30583] docs mention datetuil presumably it should be
 dateutil
In-Reply-To: <1496770049.03.0.569012645786.issue30583@psf.upfronthosting.co.za>
Message-ID: <1496772381.47.0.709549647041.issue30583@psf.upfronthosting.co.za>


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


----------
stage:  -> backport needed

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

From report at bugs.python.org  Tue Jun  6 14:13:41 2017
From: report at bugs.python.org (Aaron Hall)
Date: Tue, 06 Jun 2017 18:13:41 +0000
Subject: [docs] [issue26103] Contradiction in definition of "data
 descriptor" between (dotted lookup behavior/datamodel documentation) and
 (inspect lib/descriptor how-to)
In-Reply-To: <1452718612.1.0.925403449689.issue26103@psf.upfronthosting.co.za>
Message-ID: <1496772821.74.0.153587312573.issue26103@psf.upfronthosting.co.za>


Aaron Hall added the comment:

Added news, working on tests

----------

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

From report at bugs.python.org  Tue Jun  6 14:16:37 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 06 Jun 2017 18:16:37 +0000
Subject: [docs] [issue26103] Contradiction in definition of "data
 descriptor" between (dotted lookup behavior/datamodel documentation) and
 (inspect lib/descriptor how-to)
In-Reply-To: <1452718612.1.0.925403449689.issue26103@psf.upfronthosting.co.za>
Message-ID: <1496772997.04.0.34233417847.issue26103@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Please also add yourself to Misc/ACKS.

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

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

From report at bugs.python.org  Tue Jun  6 15:01:12 2017
From: report at bugs.python.org (wim glenn)
Date: Tue, 06 Jun 2017 19:01:12 +0000
Subject: [docs] [issue30583] docs mention datetuil presumably it should be
 dateutil
In-Reply-To: <1496770049.03.0.569012645786.issue30583@psf.upfronthosting.co.za>
Message-ID: <1496775672.34.0.529619692778.issue30583@psf.upfronthosting.co.za>


Changes by wim glenn <wim.glenn at gmail.com>:


----------
pull_requests: +2040

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

From report at bugs.python.org  Tue Jun  6 15:23:55 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 06 Jun 2017 19:23:55 +0000
Subject: [docs] [issue29596] Unfinished sentence in howto/clinic.rst
In-Reply-To: <1487380332.64.0.682733186171.issue29596@psf.upfronthosting.co.za>
Message-ID: <1496777035.16.0.82198743619.issue29596@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset ec19ba210bba2c3097232a05d7dbe093beb5f833 by Mariatta (gfyoung) in branch 'master':
bpo-29596: Improve clinic howto documentation (GH-1710)
https://github.com/python/cpython/commit/ec19ba210bba2c3097232a05d7dbe093beb5f833


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

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

From report at bugs.python.org  Tue Jun  6 15:32:16 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 06 Jun 2017 19:32:16 +0000
Subject: [docs] [issue30583] docs mention datetuil presumably it should be
 dateutil
In-Reply-To: <1496770049.03.0.569012645786.issue30583@psf.upfronthosting.co.za>
Message-ID: <1496777536.58.0.348295372052.issue30583@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset b25b7254d909697bb7f3aa893b740cb650547cb6 by Mariatta (wim glenn) in branch '3.6':
bpo-30583: Fix typo in datetime dateutil documentation (GH-1972) (GH-1974)
https://github.com/python/cpython/commit/b25b7254d909697bb7f3aa893b740cb650547cb6


----------

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

From report at bugs.python.org  Tue Jun  6 15:32:47 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 06 Jun 2017 19:32:47 +0000
Subject: [docs] [issue30583] docs mention datetuil presumably it should be
 dateutil
In-Reply-To: <1496770049.03.0.569012645786.issue30583@psf.upfronthosting.co.za>
Message-ID: <1496777567.89.0.144973665197.issue30583@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Thanks wim glenn :)

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

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

From report at bugs.python.org  Tue Jun  6 16:32:41 2017
From: report at bugs.python.org (G Young)
Date: Tue, 06 Jun 2017 20:32:41 +0000
Subject: [docs] [issue29596] Unfinished sentence in howto/clinic.rst
In-Reply-To: <1487380332.64.0.682733186171.issue29596@psf.upfronthosting.co.za>
Message-ID: <1496781161.27.0.838738273638.issue29596@psf.upfronthosting.co.za>


Changes by G Young <gfyoung17 at gmail.com>:


----------
pull_requests: +2041

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

From report at bugs.python.org  Tue Jun  6 16:34:26 2017
From: report at bugs.python.org (G Young)
Date: Tue, 06 Jun 2017 20:34:26 +0000
Subject: [docs] [issue29596] Unfinished sentence in howto/clinic.rst
In-Reply-To: <1487380332.64.0.682733186171.issue29596@psf.upfronthosting.co.za>
Message-ID: <1496781266.24.0.567536733666.issue29596@psf.upfronthosting.co.za>


Changes by G Young <gfyoung17 at gmail.com>:


----------
pull_requests: +2042

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

From report at bugs.python.org  Tue Jun  6 17:17:20 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 06 Jun 2017 21:17:20 +0000
Subject: [docs] [issue29596] Unfinished sentence in howto/clinic.rst
In-Reply-To: <1487380332.64.0.682733186171.issue29596@psf.upfronthosting.co.za>
Message-ID: <1496783840.86.0.504854180145.issue29596@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 063f0b358331322d84f85008e6c01f80ff321fd6 by Mariatta (gfyoung) in branch '3.6':
bpo-29596: Improve clinic howto documentation (GH-1710) (GH-1976)
https://github.com/python/cpython/commit/063f0b358331322d84f85008e6c01f80ff321fd6


----------

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

From report at bugs.python.org  Tue Jun  6 17:38:10 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 06 Jun 2017 21:38:10 +0000
Subject: [docs] [issue29596] Unfinished sentence in howto/clinic.rst
In-Reply-To: <1487380332.64.0.682733186171.issue29596@psf.upfronthosting.co.za>
Message-ID: <1496785090.92.0.278757368036.issue29596@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset ee9de30aa0dbcfd848e4200944674a084d963588 by Mariatta (gfyoung) in branch '3.5':
bpo-29596: Improve clinic howto documentation (GH-1710) (GH-1975)
https://github.com/python/cpython/commit/ee9de30aa0dbcfd848e4200944674a084d963588


----------

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

From report at bugs.python.org  Tue Jun  6 17:40:13 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 06 Jun 2017 21:40:13 +0000
Subject: [docs] [issue29596] Unfinished sentence in howto/clinic.rst
In-Reply-To: <1487380332.64.0.682733186171.issue29596@psf.upfronthosting.co.za>
Message-ID: <1496785213.84.0.512113579856.issue29596@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Thanks everyone :)

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

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

From report at bugs.python.org  Tue Jun  6 18:27:45 2017
From: report at bugs.python.org (Aaron Hall)
Date: Tue, 06 Jun 2017 22:27:45 +0000
Subject: [docs] [issue26103] Contradiction in definition of "data
 descriptor" between (dotted lookup behavior/datamodel documentation) and
 (inspect lib/descriptor how-to)
In-Reply-To: <1452718612.1.0.925403449689.issue26103@psf.upfronthosting.co.za>
Message-ID: <1496788064.95.0.650790218875.issue26103@psf.upfronthosting.co.za>


Aaron Hall added the comment:

> Please also add yourself to Misc/ACKS.

Done!

----------

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

From report at bugs.python.org  Wed Jun  7 11:02:55 2017
From: report at bugs.python.org (Matthieu Dartiailh)
Date: Wed, 07 Jun 2017 15:02:55 +0000
Subject: [docs] [issue30588] Missing documentation for codecs.escape_decode
Message-ID: <1496847775.57.0.842403144977.issue30588@psf.upfronthosting.co.za>


New submission from Matthieu Dartiailh:

codecs.escape_decode does not appear in the codecs documentation. This function is to my knowledge the only convenient way to process the escaped characters in a literal string (actually found here https://stackoverflow.com/questions/4020539/process-escape-sequences-in-a-string-in-python). It is most useful when implementing a parser for a language extending python semantic while retaining python processing of string (cf https://github.com/MatthieuDartiailh/enaml).

Is there a reason for that function not being documented ?

----------
assignee: docs at python
components: Documentation
messages: 295342
nosy: docs at python, mdartiailh
priority: normal
severity: normal
status: open
title: Missing documentation for codecs.escape_decode
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/issue30588>
_______________________________________

From report at bugs.python.org  Wed Jun  7 11:22:14 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 07 Jun 2017 15:22:14 +0000
Subject: [docs] [issue30588] Missing documentation for codecs.escape_decode
In-Reply-To: <1496847775.57.0.842403144977.issue30588@psf.upfronthosting.co.za>
Message-ID: <1496848934.86.0.0773547758796.issue30588@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

This is an internal function kept for compatibility. It is used only for decoding pickle protocol 0 data created in Python 2. Look at unicode_escape and raw_unicode_escape codecs for doing similar decoding to strings in Python 3.

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

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

From report at bugs.python.org  Wed Jun  7 11:36:21 2017
From: report at bugs.python.org (Matthieu Dartiailh)
Date: Wed, 07 Jun 2017 15:36:21 +0000
Subject: [docs] [issue30588] Missing documentation for codecs.escape_decode
In-Reply-To: <1496848934.86.0.0773547758796.issue30588@psf.upfronthosting.co.za>
Message-ID: <361c3150-e362-a6ed-0083-e8f40fc27806@gmail.com>


Matthieu Dartiailh added the comment:

The issue is that unicode_escape will not properly handle strings mixing
unicode character and escaped character as it assumes latin-1 compatible
characters only. For example, given the literal string '?\n?', one
cannot encode using latin-1 and encoding it using utf-8 then using
unicode _escape produces a wrong output: '?\x94\n?\x94'. However using
codecs.escape_decode(r'?\n?'.encode('utf-8'))[0].decode('utf-8') gives
the proper output. Internally the Python parser handle this case but I
was unable to find where and this is the closest solution I found. I
guess it may be possible using error handlers but it seems much more
cumbersome.

Best regards

Matthieu

----------

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

From report at bugs.python.org  Wed Jun  7 14:07:16 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 07 Jun 2017 18:07:16 +0000
Subject: [docs] [issue29981] Update Index for set, dict,
 and generator 'comprehensions'
In-Reply-To: <1491328871.52.0.864348862414.issue29981@psf.upfronthosting.co.za>
Message-ID: <1496858836.31.0.902531974705.issue29981@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/issue29981>
_______________________________________

From report at bugs.python.org  Wed Jun  7 23:49:49 2017
From: report at bugs.python.org (Aaron Hall)
Date: Thu, 08 Jun 2017 03:49:49 +0000
Subject: [docs] [issue26103] Contradiction in definition of "data
 descriptor" between (dotted lookup behavior/datamodel documentation) and
 (inspect lib/descriptor how-to)
In-Reply-To: <1452718612.1.0.925403449689.issue26103@psf.upfronthosting.co.za>
Message-ID: <1496893789.38.0.72474538935.issue26103@psf.upfronthosting.co.za>


Aaron Hall added the comment:

I tweaked the docs a little more this morning, but I believe I am done making any further changes unless so requested.

This issue doesn't say it's assigned to anyone. Is there anything else that needs to happen here?

----------

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

From report at bugs.python.org  Fri Jun  9 00:07:59 2017
From: report at bugs.python.org (Jon Wayne Parrott)
Date: Fri, 09 Jun 2017 04:07:59 +0000
Subject: [docs] [issue30607] Extract documentation theme into a separate
 package
Message-ID: <1496981279.71.0.300273355047.issue30607@psf.upfronthosting.co.za>


New submission from Jon Wayne Parrott:

As part of an effort to align the packaging documentation (packaging.python.org) with the CPython docs, PyPA has extracted the theme used in the CPython documentation into a separate repository and package (https://github.com/python/python-docs-theme).

This bug is to track removing the now duplicate theme code from CPython and relying on the externalized version.


Context links:
1. https://mail.python.org/pipermail/python-dev/2017-May/148029.html
2. https://github.com/pypa/python-packaging-user-guide/pull/305

----------
assignee: docs at python
components: Documentation
messages: 295482
nosy: Jon Wayne Parrott, brett.cannon, docs at python, dstufft, ncoghlan
priority: normal
severity: normal
status: open
title: Extract documentation theme into a separate package
type: enhancement
versions: Python 3.7

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

From report at bugs.python.org  Fri Jun  9 00:19:28 2017
From: report at bugs.python.org (Jon Wayne Parrott)
Date: Fri, 09 Jun 2017 04:19:28 +0000
Subject: [docs] [issue30607] Extract documentation theme into a separate
 package
In-Reply-To: <1496981279.71.0.300273355047.issue30607@psf.upfronthosting.co.za>
Message-ID: <1496981968.59.0.657966120319.issue30607@psf.upfronthosting.co.za>


Changes by Jon Wayne Parrott <jonwayne at google.com>:


----------
pull_requests: +2083

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

From report at bugs.python.org  Fri Jun  9 02:29:02 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 09 Jun 2017 06:29:02 +0000
Subject: [docs] [issue24755] asyncio.wrap_future undocumented
In-Reply-To: <1438250618.09.0.00442439827356.issue24755@psf.upfronthosting.co.za>
Message-ID: <1496989742.09.0.379663687264.issue24755@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 824f6879121413e09439fffef54580413e44bf46 by Mariatta (adisbladis) in branch 'master':
bpo-24755: Document asyncio.wrap_future (GH-603)
https://github.com/python/cpython/commit/824f6879121413e09439fffef54580413e44bf46


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

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

From report at bugs.python.org  Fri Jun  9 02:30:46 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 09 Jun 2017 06:30:46 +0000
Subject: [docs] [issue24755] asyncio.wrap_future undocumented
In-Reply-To: <1438250618.09.0.00442439827356.issue24755@psf.upfronthosting.co.za>
Message-ID: <1496989846.92.0.897297848979.issue24755@psf.upfronthosting.co.za>


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


----------
pull_requests: +2085

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

From report at bugs.python.org  Fri Jun  9 02:30:58 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 09 Jun 2017 06:30:58 +0000
Subject: [docs] [issue24755] asyncio.wrap_future undocumented
In-Reply-To: <1438250618.09.0.00442439827356.issue24755@psf.upfronthosting.co.za>
Message-ID: <1496989858.88.0.798780856004.issue24755@psf.upfronthosting.co.za>


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


----------
pull_requests: +2086

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

From report at bugs.python.org  Fri Jun  9 02:31:41 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 09 Jun 2017 06:31:41 +0000
Subject: [docs] [issue24755] asyncio.wrap_future undocumented
In-Reply-To: <1438250618.09.0.00442439827356.issue24755@psf.upfronthosting.co.za>
Message-ID: <1496989901.11.0.892867689162.issue24755@psf.upfronthosting.co.za>


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


----------
stage: patch review -> backport needed

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

From report at bugs.python.org  Fri Jun  9 03:38:24 2017
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Fri, 09 Jun 2017 07:38:24 +0000
Subject: [docs] [issue19180] some RFC references could be updated
In-Reply-To: <525144B9.3040305@python.org>
Message-ID: <1496993904.04.0.342211490964.issue19180@psf.upfronthosting.co.za>


St?phane Wirtel added the comment:

The associated PR has been reviewed and could be merged.

----------
nosy: +matrixise

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

From report at bugs.python.org  Fri Jun  9 05:20:31 2017
From: report at bugs.python.org (Christian Ullrich)
Date: Fri, 09 Jun 2017 09:20:31 +0000
Subject: [docs] [issue30611] Windows HTML Help always opens maximized
Message-ID: <1497000031.32.0.397781298272.issue30611@psf.upfronthosting.co.za>


New submission from Christian Ullrich:

The CHM help files on Windows always open maximized. I would prefer they opened in a regular window instead, because the current behavior is annoying.

Fix: In Tools/msi/doc/doc.wxs line 34, change 'Show="maximized"' to 'Show="normal"'.

----------
assignee: docs at python
components: Documentation, Windows
messages: 295503
nosy: Christian.Ullrich, docs at python, paul.moore, steve.dower, tim.golden, zach.ware
priority: normal
severity: normal
status: open
title: Windows HTML Help always opens maximized
type: behavior
versions: Python 3.6

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

From report at bugs.python.org  Fri Jun  9 05:33:24 2017
From: report at bugs.python.org (Christian Ullrich)
Date: Fri, 09 Jun 2017 09:33:24 +0000
Subject: [docs] [issue30612] Unusual Windows registry path syntax
Message-ID: <1497000804.0.0.079840477122.issue30612@psf.upfronthosting.co.za>


New submission from Christian Ullrich:

In 3.6.1, the manual, section 3.1.3, has this to say:

"Your administrator will need to activate the ?Enable Win32 long paths? group policy, or set the registry value HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem at LongPathsEnabled to 1."

Separating a value name from the key path with an @-sign, which is what the above is doing, is something I have never before seen anywhere. I suggest changing it by either:

- replacing the instructions for the manual change with a link to <https://msdn.microsoft.com/en-us/library/windows/desktop/aa365247(v=vs.85).aspx#maxpath> or a more suitable reference (I could not find a KB article when I looked)

- rewording it as, e.g.,

  ... in the registry key HKEY_...FileSystem, set the REG_DWORD value LongPathsEnabled to 1

  The value type could be left out; the value is predefined on all platforms where it will be effective.

----------
assignee: docs at python
components: Documentation
messages: 295505
nosy: Christian.Ullrich, docs at python
priority: normal
severity: normal
status: open
title: Unusual Windows registry path syntax
type: enhancement
versions: Python 3.6

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

From report at bugs.python.org  Fri Jun  9 05:44:01 2017
From: report at bugs.python.org (Nick Coghlan)
Date: Fri, 09 Jun 2017 09:44:01 +0000
Subject: [docs] [issue19180] some RFC references could be updated
In-Reply-To: <525144B9.3040305@python.org>
Message-ID: <1497001441.23.0.948226202106.issue19180@psf.upfronthosting.co.za>


Nick Coghlan added the comment:


New changeset 63c2c8ac17750ba2be2cfc4e339cae1f4edee54f by Nick Coghlan (Chandan Kumar) in branch 'master':
bpo-19180: Updated references for RFC 1750, RFC 3280 & RFC 4366 (GH-148)
https://github.com/python/cpython/commit/63c2c8ac17750ba2be2cfc4e339cae1f4edee54f


----------

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

From report at bugs.python.org  Fri Jun  9 06:13:35 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 09 Jun 2017 10:13:35 +0000
Subject: [docs] [issue19180] some RFC references could be updated
In-Reply-To: <525144B9.3040305@python.org>
Message-ID: <1497003215.68.0.21421655789.issue19180@psf.upfronthosting.co.za>


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


----------
stage: patch review -> backport needed

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

From report at bugs.python.org  Fri Jun  9 07:58:30 2017
From: report at bugs.python.org (Nick Coghlan)
Date: Fri, 09 Jun 2017 11:58:30 +0000
Subject: [docs] [issue19180] some RFC references could be updated
In-Reply-To: <525144B9.3040305@python.org>
Message-ID: <1497009510.95.0.733179846852.issue19180@psf.upfronthosting.co.za>


Changes by Nick Coghlan <ncoghlan at gmail.com>:


----------
pull_requests: +2089

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

From report at bugs.python.org  Fri Jun  9 08:37:55 2017
From: report at bugs.python.org (Nick Coghlan)
Date: Fri, 09 Jun 2017 12:37:55 +0000
Subject: [docs] [issue19180] some RFC references could be updated
In-Reply-To: <525144B9.3040305@python.org>
Message-ID: <1497011875.35.0.201408156185.issue19180@psf.upfronthosting.co.za>


Nick Coghlan added the comment:


New changeset c422959daca0598fabbefa5de4417ebce3b1da06 by Nick Coghlan in branch '3.6':
[3.6] bpo-19180: Updated references for RFC 1750, RFC 3280 & RFC 4366
https://github.com/python/cpython/commit/c422959daca0598fabbefa5de4417ebce3b1da06


----------

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

From report at bugs.python.org  Fri Jun  9 08:39:24 2017
From: report at bugs.python.org (Nick Coghlan)
Date: Fri, 09 Jun 2017 12:39:24 +0000
Subject: [docs] [issue19180] some RFC references could be updated
In-Reply-To: <525144B9.3040305@python.org>
Message-ID: <1497011964.63.0.549846062549.issue19180@psf.upfronthosting.co.za>


Nick Coghlan added the comment:

And merged. Thanks Chandan for the update, and everyone else for the comments and triage :)

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

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

From report at bugs.python.org  Fri Jun  9 10:28:30 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 09 Jun 2017 14:28:30 +0000
Subject: [docs] [issue30217] Missing entry for the tilde (~) operator in the
 Index
In-Reply-To: <1493582160.76.0.882487661277.issue30217@psf.upfronthosting.co.za>
Message-ID: <1497018510.27.0.428268221239.issue30217@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:


New changeset 5eb7075915f0509c5027376bda0e6d9c1e505a2c by Serhiy Storchaka (Marco Buttu) in branch 'master':
bpo-30217: Add the operators ~ and | to the index (#1502)
https://github.com/python/cpython/commit/5eb7075915f0509c5027376bda0e6d9c1e505a2c


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

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

From report at bugs.python.org  Fri Jun  9 10:32:49 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 09 Jun 2017 14:32:49 +0000
Subject: [docs] [issue24755] asyncio.wrap_future undocumented
In-Reply-To: <1438250618.09.0.00442439827356.issue24755@psf.upfronthosting.co.za>
Message-ID: <1497018769.17.0.647863275286.issue24755@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset af609a00a64fd58bd67c102f208ed9fe15c2748d by Mariatta in branch '3.6':
bpo-24755: Document asyncio.wrap_future (GH-603) (GH-2019)
https://github.com/python/cpython/commit/af609a00a64fd58bd67c102f208ed9fe15c2748d


----------

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

From report at bugs.python.org  Fri Jun  9 10:33:26 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 09 Jun 2017 14:33:26 +0000
Subject: [docs] [issue24755] asyncio.wrap_future undocumented
In-Reply-To: <1438250618.09.0.00442439827356.issue24755@psf.upfronthosting.co.za>
Message-ID: <1497018806.49.0.616218806709.issue24755@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 3fc2fa8cb909cb58325f56deb5cd500d278e4102 by Mariatta in branch '3.5':
bpo-24755: Document asyncio.wrap_future (GH-603) (GH-2020)
https://github.com/python/cpython/commit/3fc2fa8cb909cb58325f56deb5cd500d278e4102


----------

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

From report at bugs.python.org  Fri Jun  9 10:34:35 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 09 Jun 2017 14:34:35 +0000
Subject: [docs] [issue24755] asyncio.wrap_future undocumented
In-Reply-To: <1438250618.09.0.00442439827356.issue24755@psf.upfronthosting.co.za>
Message-ID: <1497018874.99.0.189321007079.issue24755@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

PR merged and backported to 3.6 and 3.5.
Thanks :)

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

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

From report at bugs.python.org  Fri Jun  9 11:16:08 2017
From: report at bugs.python.org (Zachary Ware)
Date: Fri, 09 Jun 2017 15:16:08 +0000
Subject: [docs] [issue30611] Windows HTML Help always opens maximized
In-Reply-To: <1497000031.32.0.397781298272.issue30611@psf.upfronthosting.co.za>
Message-ID: <1497021368.54.0.0892742452816.issue30611@psf.upfronthosting.co.za>


Zachary Ware added the comment:

Does 'Show="normal"' cause the usual behavior of "do whatever it was doing when last closed"?  Does 'Show=' need to be specified?

Would you like to submit a PR?

----------
versions: +Python 3.5, Python 3.7

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

From report at bugs.python.org  Fri Jun  9 12:42:26 2017
From: report at bugs.python.org (R. David Murray)
Date: Fri, 09 Jun 2017 16:42:26 +0000
Subject: [docs] [issue30612] Unusual Windows registry path syntax
In-Reply-To: <1497000804.0.0.079840477122.issue30612@psf.upfronthosting.co.za>
Message-ID: <1497026546.06.0.782564653667.issue30612@psf.upfronthosting.co.za>


Changes by R. David Murray <rdmurray at bitdance.com>:


----------
components: +Windows
nosy: +paul.moore, steve.dower, tim.golden, zach.ware
versions: +Python 3.7

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

From report at bugs.python.org  Fri Jun  9 13:11:10 2017
From: report at bugs.python.org (Steve Dower)
Date: Fri, 09 Jun 2017 17:11:10 +0000
Subject: [docs] [issue30612] Unusual Windows registry path syntax
In-Reply-To: <1497000804.0.0.079840477122.issue30612@psf.upfronthosting.co.za>
Message-ID: <1497028270.23.0.804243632619.issue30612@psf.upfronthosting.co.za>


Steve Dower added the comment:

Pull requests welcome, but as someone who lives in the Windows API day in and day out, I can vouch for it being the normal abbreviated way of specifying a fully qualified registry value.

----------
priority: normal -> low

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

From report at bugs.python.org  Fri Jun  9 13:17:01 2017
From: report at bugs.python.org (Steve Dower)
Date: Fri, 09 Jun 2017 17:17:01 +0000
Subject: [docs] [issue30611] Windows HTML Help always opens maximized
In-Reply-To: <1497000031.32.0.397781298272.issue30611@psf.upfronthosting.co.za>
Message-ID: <1497028621.9.0.9237142035.issue30611@psf.upfronthosting.co.za>


Steve Dower added the comment:

Opening in normal size (i.e. randomly positioned somewhere on the screen) is equally annoying.

PR is welcome, but I won't be approving it. Someone else might.

Certainly doesn't need to be backported - this is not a bug.

----------
assignee: docs at python -> 
components:  -Documentation
type: behavior -> enhancement
versions:  -Python 3.5, Python 3.6

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

From report at bugs.python.org  Fri Jun  9 13:17:46 2017
From: report at bugs.python.org (Christian Ullrich)
Date: Fri, 09 Jun 2017 17:17:46 +0000
Subject: [docs] [issue30612] Unusual Windows registry path syntax
In-Reply-To: <1497000804.0.0.079840477122.issue30612@psf.upfronthosting.co.za>
Message-ID: <1497028666.55.0.3195208194.issue30612@psf.upfronthosting.co.za>


Christian Ullrich added the comment:

Out of curiosity, can you point me to an example or two?

I have been living with, though not in, Win32 for quite a few years myself, and I can say with certainty that I have never seen this notation before in my life.

Other than that, PR on the way soonish.

----------

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

From report at bugs.python.org  Fri Jun  9 13:24:32 2017
From: report at bugs.python.org (Steve Dower)
Date: Fri, 09 Jun 2017 17:24:32 +0000
Subject: [docs] [issue30612] Unusual Windows registry path syntax
In-Reply-To: <1497000804.0.0.079840477122.issue30612@psf.upfronthosting.co.za>
Message-ID: <1497029072.39.0.339398159501.issue30612@psf.upfronthosting.co.za>


Steve Dower added the comment:

There's a handful of references in https://docs.microsoft.com/en-us/visualstudio/ide/walkthrough-creating-a-multiple-computer-build-environment, though TBH most of the docs written by actual doc writers use more complicated sentences to avoid it.

It's also the syntax used by MSBuild, which is probably mostly why I think it's normal.

----------

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

From report at bugs.python.org  Fri Jun  9 13:31:27 2017
From: report at bugs.python.org (Christian Ullrich)
Date: Fri, 09 Jun 2017 17:31:27 +0000
Subject: [docs] [issue30611] Windows HTML Help always opens maximized
In-Reply-To: <1497000031.32.0.397781298272.issue30611@psf.upfronthosting.co.za>
Message-ID: <1497029487.37.0.70970129867.issue30611@psf.upfronthosting.co.za>


Christian Ullrich added the comment:

I'll have to start with the ceterae again, won't I? OK, since you asked:

Ceterum censeo: This behavior could have been easily adapted to differing local requirements if MSI had been used as the distribution package format by appropriately transforming  the Shortcut table at install time, but burn bundles do not expose an interface to apply transforms to individual component MSIs, needlessly disabling this unique advantage of the Windows Installer technology.

(Apologies to people who know Latin. Unless I'm really lucky here.)

Not sure if the tracker will let me close the bug myself; if it doesn't, know that I have tried.

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

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

From report at bugs.python.org  Fri Jun  9 16:28:21 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 09 Jun 2017 20:28:21 +0000
Subject: [docs] [issue30335] Document deprecated alias of assertNotRegex
In-Reply-To: <1494431600.9.0.620975623094.issue30335@psf.upfronthosting.co.za>
Message-ID: <1497040101.79.0.999883093294.issue30335@psf.upfronthosting.co.za>


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


----------
assignee:  -> docs at python
components: +Documentation -Tests
nosy: +docs at python
stage:  -> backport needed
versions: +Python 3.5, Python 3.6

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

From report at bugs.python.org  Fri Jun  9 16:31:41 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 09 Jun 2017 20:31:41 +0000
Subject: [docs] [issue30335] Document deprecated alias of assertNotRegex
In-Reply-To: <1494431600.9.0.620975623094.issue30335@psf.upfronthosting.co.za>
Message-ID: <1497040301.11.0.792918570291.issue30335@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Jun  9 17:00:44 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 09 Jun 2017 21:00:44 +0000
Subject: [docs] [issue30569] Tutorial section 2.1 has *nix example at 3.7,
 but Windows at 3.6
In-Reply-To: <1496609553.39.0.613003310721.issue30569@psf.upfronthosting.co.za>
Message-ID: <1497042044.8.0.650269553462.issue30569@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

There is a lot more wrong with the Windows part:

 "On Windows machines, the Python installation is usually placed in C:\Python36," is no longer true.  All-users install is, by default, in Program Files.  Current-user install is, by default, buried somewhere forgettable in the hidden /users/USER/appdata dir.

" you can type the following command into the command prompt in a DOS box:"  It has been a long time since Command Prompt was widely called a 'DOS box'.

set path=%path%

The is not permanent, at least for non-admin user.  One can add the install dir, whatever it is, to path during installation.  Or one can use 'py -3.6'

----------
nosy: +steve.dower, terry.reedy

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

From report at bugs.python.org  Fri Jun  9 20:38:11 2017
From: report at bugs.python.org (khyox)
Date: Sat, 10 Jun 2017 00:38:11 +0000
Subject: [docs] [issue30619] typing.Union doc incoherence in case a class
 and its subclass are present
Message-ID: <1497055090.79.0.980256634301.issue30619@psf.upfronthosting.co.za>


New submission from khyox:

In https://docs.python.org/3.6/library/typing.html#typing.Union, when giving details for Union and in the case when a class and its subclass are present, the doc states:

    When a class and its subclass are present, the former is skipped, e.g.:

        Union[int, object] == object

But it is the example (and not the text) which is consistent with PEP 483:

    Corollary: Union[..., object, ...] returns object

So, the proposed correction would be substitute 'former' for 'latter':

    When a class and its subclass are present, the latter is skipped, e.g.:

        Union[int, object] == object

----------
assignee: docs at python
components: Documentation
messages: 295593
nosy: docs at python, khyox
priority: normal
severity: normal
status: open
title: typing.Union doc incoherence in case a class and its subclass are present
versions: Python 3.5, Python 3.6

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

From report at bugs.python.org  Fri Jun  9 21:12:18 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 10 Jun 2017 01:12:18 +0000
Subject: [docs] [issue30335] Document deprecated alias of assertNotRegex
In-Reply-To: <1494431600.9.0.620975623094.issue30335@psf.upfronthosting.co.za>
Message-ID: <1497057138.77.0.819964111633.issue30335@psf.upfronthosting.co.za>


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


----------
pull_requests: +2116

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

From report at bugs.python.org  Fri Jun  9 21:12:24 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 10 Jun 2017 01:12:24 +0000
Subject: [docs] [issue30335] Document deprecated alias of assertNotRegex
In-Reply-To: <1494431600.9.0.620975623094.issue30335@psf.upfronthosting.co.za>
Message-ID: <1497057144.86.0.388954253357.issue30335@psf.upfronthosting.co.za>


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


----------
pull_requests: +2117

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

From report at bugs.python.org  Fri Jun  9 21:33:34 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 10 Jun 2017 01:33:34 +0000
Subject: [docs] [issue30335] Document deprecated alias of assertNotRegex
In-Reply-To: <1494431600.9.0.620975623094.issue30335@psf.upfronthosting.co.za>
Message-ID: <1497058413.99.0.795858495286.issue30335@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 10c9a09ef4810f0235f5f585dcce70eca049604a by Mariatta in branch '3.6':
[3.6] bpo-30335: Add deprecation alias entry for assertNotRegexpMatches (GH-1536) (GH-2055)
https://github.com/python/cpython/commit/10c9a09ef4810f0235f5f585dcce70eca049604a


----------

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

From report at bugs.python.org  Fri Jun  9 21:33:52 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 10 Jun 2017 01:33:52 +0000
Subject: [docs] [issue30335] Document deprecated alias of assertNotRegex
In-Reply-To: <1494431600.9.0.620975623094.issue30335@psf.upfronthosting.co.za>
Message-ID: <1497058432.67.0.28572154907.issue30335@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset cabdba24b5cee036bd4963d2dcf5bf667e6d63c9 by Mariatta in branch '3.5':
[3.5] bpo-30335: Add deprecation alias entry for assertNotRegexpMatches (GH-1536) (GH-2056)
https://github.com/python/cpython/commit/cabdba24b5cee036bd4963d2dcf5bf667e6d63c9


----------

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

From report at bugs.python.org  Fri Jun  9 21:35:07 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 10 Jun 2017 01:35:07 +0000
Subject: [docs] [issue30335] Document deprecated alias of assertNotRegex
In-Reply-To: <1494431600.9.0.620975623094.issue30335@psf.upfronthosting.co.za>
Message-ID: <1497058507.37.0.739929824484.issue30335@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Thanks!

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

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

From report at bugs.python.org  Sat Jun 10 00:42:14 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 10 Jun 2017 04:42:14 +0000
Subject: [docs] [issue25409] fnmatch.fnmatch normalizes slashes/backslashes
 on Windows
In-Reply-To: <1444889091.12.0.272630391848.issue25409@psf.upfronthosting.co.za>
Message-ID: <1497069733.91.0.810497662451.issue25409@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset e5f6e86c48c7b2eb9e1d6a0e72867b4d8b4720f3 by Mariatta (csabella) in branch 'master':
bpo-25409: Clarify fnmatch and fnmatchcase documentation (GH-1535)
https://github.com/python/cpython/commit/e5f6e86c48c7b2eb9e1d6a0e72867b4d8b4720f3


----------

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

From report at bugs.python.org  Sat Jun 10 00:42:54 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 10 Jun 2017 04:42:54 +0000
Subject: [docs] [issue25409] fnmatch.fnmatch normalizes slashes/backslashes
 on Windows
In-Reply-To: <1444889091.12.0.272630391848.issue25409@psf.upfronthosting.co.za>
Message-ID: <1497069774.84.0.988841457803.issue25409@psf.upfronthosting.co.za>


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


----------
pull_requests: +2129

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

From report at bugs.python.org  Sat Jun 10 00:44:43 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 10 Jun 2017 04:44:43 +0000
Subject: [docs] [issue25409] fnmatch.fnmatch normalizes slashes/backslashes
 on Windows
In-Reply-To: <1444889091.12.0.272630391848.issue25409@psf.upfronthosting.co.za>
Message-ID: <1497069883.99.0.740877395565.issue25409@psf.upfronthosting.co.za>


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


----------
pull_requests: +2130

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

From report at bugs.python.org  Sat Jun 10 00:50:08 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 10 Jun 2017 04:50:08 +0000
Subject: [docs] [issue25409] fnmatch.fnmatch normalizes slashes/backslashes
 on Windows
In-Reply-To: <1444889091.12.0.272630391848.issue25409@psf.upfronthosting.co.za>
Message-ID: <1497070208.13.0.484819091372.issue25409@psf.upfronthosting.co.za>


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


----------
pull_requests: +2131

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

From report at bugs.python.org  Sat Jun 10 01:31:14 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 10 Jun 2017 05:31:14 +0000
Subject: [docs] [issue19180] some RFC references could be updated
In-Reply-To: <525144B9.3040305@python.org>
Message-ID: <1497072674.09.0.0149133478929.issue19180@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

Needed to regenerate Argument Clinic code.

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

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

From report at bugs.python.org  Sat Jun 10 04:10:13 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 10 Jun 2017 08:10:13 +0000
Subject: [docs] [issue19180] some RFC references could be updated
In-Reply-To: <525144B9.3040305@python.org>
Message-ID: <1497082213.18.0.849272277386.issue19180@psf.upfronthosting.co.za>


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


----------
pull_requests: +2137

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

From report at bugs.python.org  Sat Jun 10 05:17:03 2017
From: report at bugs.python.org (Masaki Suketa)
Date: Sat, 10 Jun 2017 09:17:03 +0000
Subject: [docs] [issue30621] import json before using json module in
 tutorial Input and Output
Message-ID: <1497086223.62.0.997560014368.issue30621@psf.upfronthosting.co.za>


New submission from Masaki Suketa:

In Input and Output tutorial, use json module without `import json`.

----------
assignee: docs at python
components: Documentation
messages: 295626
nosy: docs at python, suketa
priority: normal
pull_requests: 2139
severity: normal
status: open
title: import json before using json module in tutorial Input and Output
type: resource usage
versions: Python 3.6

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

From report at bugs.python.org  Sat Jun 10 06:13:54 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 10 Jun 2017 10:13:54 +0000
Subject: [docs] [issue19180] some RFC references could be updated
In-Reply-To: <525144B9.3040305@python.org>
Message-ID: <1497089633.97.0.0786639725503.issue19180@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:


New changeset 5f31d5cf6efa8c304d352e34f9f2a1ed0074298e by Serhiy Storchaka in branch 'master':
Regenerate Argument Clinic code for bpo-19180. (#2073)
https://github.com/python/cpython/commit/5f31d5cf6efa8c304d352e34f9f2a1ed0074298e


----------

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

From report at bugs.python.org  Sat Jun 10 06:17:18 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 10 Jun 2017 10:17:18 +0000
Subject: [docs] [issue19180] some RFC references could be updated
In-Reply-To: <525144B9.3040305@python.org>
Message-ID: <1497089838.28.0.397190513257.issue19180@psf.upfronthosting.co.za>


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


----------
pull_requests: +2141

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

From report at bugs.python.org  Sat Jun 10 06:48:55 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 10 Jun 2017 10:48:55 +0000
Subject: [docs] [issue19180] some RFC references could be updated
In-Reply-To: <525144B9.3040305@python.org>
Message-ID: <1497091735.66.0.467423366094.issue19180@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:


New changeset 911068e250ee2b0847ca78d9ff527e0d6bf94551 by Serhiy Storchaka in branch '3.6':
[3.6] Regenerate Argument Clinic code for bpo-19180. (GH-2073). (#2077)
https://github.com/python/cpython/commit/911068e250ee2b0847ca78d9ff527e0d6bf94551


----------

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

From report at bugs.python.org  Sat Jun 10 06:50:15 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 10 Jun 2017 10:50:15 +0000
Subject: [docs] [issue19180] some RFC references could be updated
In-Reply-To: <525144B9.3040305@python.org>
Message-ID: <1497091815.35.0.426769285143.issue19180@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Jun 10 10:25:35 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 10 Jun 2017 14:25:35 +0000
Subject: [docs] [issue25409] fnmatch.fnmatch normalizes slashes/backslashes
 on Windows
In-Reply-To: <1444889091.12.0.272630391848.issue25409@psf.upfronthosting.co.za>
Message-ID: <1497104735.35.0.543449073236.issue25409@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 76eabd3a21dc578de6093d45dd8d69a5ec4b9afe by Mariatta in branch '3.6':
bpo-25409: Clarify fnmatch and fnmatchcase documentation (GH-1535) (GH-2065)
https://github.com/python/cpython/commit/76eabd3a21dc578de6093d45dd8d69a5ec4b9afe


----------

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

From report at bugs.python.org  Sat Jun 10 10:26:11 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 10 Jun 2017 14:26:11 +0000
Subject: [docs] [issue25409] fnmatch.fnmatch normalizes slashes/backslashes
 on Windows
In-Reply-To: <1444889091.12.0.272630391848.issue25409@psf.upfronthosting.co.za>
Message-ID: <1497104771.16.0.643912319653.issue25409@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 656f232131e7a49800662119c7f9b8078729e697 by Mariatta in branch '3.5':
bpo-25409: Clarify fnmatch and fnmatchcase documentation (GH-1535) (GH-2066)
https://github.com/python/cpython/commit/656f232131e7a49800662119c7f9b8078729e697


----------

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

From report at bugs.python.org  Sat Jun 10 10:26:41 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 10 Jun 2017 14:26:41 +0000
Subject: [docs] [issue25409] fnmatch.fnmatch normalizes slashes/backslashes
 on Windows
In-Reply-To: <1444889091.12.0.272630391848.issue25409@psf.upfronthosting.co.za>
Message-ID: <1497104801.06.0.0640965697322.issue25409@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 9660a7e4bbc3932846fcde0e31856b5b3908b834 by Mariatta in branch '2.7':
bpo-25409: Clarify fnmatch and fnmatchcase documentation (GH-1535) (GH-2067)
https://github.com/python/cpython/commit/9660a7e4bbc3932846fcde0e31856b5b3908b834


----------

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

From report at bugs.python.org  Sat Jun 10 10:27:45 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 10 Jun 2017 14:27:45 +0000
Subject: [docs] [issue25409] fnmatch.fnmatch normalizes slashes/backslashes
 on Windows
In-Reply-To: <1444889091.12.0.272630391848.issue25409@psf.upfronthosting.co.za>
Message-ID: <1497104865.29.0.233508472491.issue25409@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

This has been fixed, and backported to 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/issue25409>
_______________________________________

From report at bugs.python.org  Sat Jun 10 10:42:27 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 10 Jun 2017 14:42:27 +0000
Subject: [docs] [issue30621] import json before using json module in
 tutorial Input and Output
In-Reply-To: <1497086223.62.0.997560014368.issue30621@psf.upfronthosting.co.za>
Message-ID: <1497105747.7.0.115389495657.issue30621@psf.upfronthosting.co.za>


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


----------
stage:  -> patch review
type: resource usage -> 
versions: +Python 2.7, Python 3.5, Python 3.7

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

From report at bugs.python.org  Sat Jun 10 10:54:23 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 10 Jun 2017 14:54:23 +0000
Subject: [docs] [issue28206] signal.Signals not documented
In-Reply-To: <1474297204.47.0.613989661481.issue28206@psf.upfronthosting.co.za>
Message-ID: <1497106463.9.0.431748968323.issue28206@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/issue28206>
_______________________________________

From report at bugs.python.org  Sat Jun 10 13:00:49 2017
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 10 Jun 2017 17:00:49 +0000
Subject: [docs] [issue30312] Small correction in set code sample
In-Reply-To: <1494319647.07.0.625979333092.issue30312@psf.upfronthosting.co.za>
Message-ID: <1497114049.56.0.933208024312.issue30312@psf.upfronthosting.co.za>


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


----------
pull_requests: +2145

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

From report at bugs.python.org  Sat Jun 10 14:16:12 2017
From: report at bugs.python.org (Gregory Szorc)
Date: Sat, 10 Jun 2017 18:16:12 +0000
Subject: [docs] [issue30625] Documentation is unclear how "y*" and "y#"
 formit units vary
Message-ID: <1497118572.05.0.886949691959.issue30625@psf.upfronthosting.co.za>


New submission from Gregory Szorc:

https://github.com/indygreg/python-zstandard/issues/26 is a bug report against python-zstandard that a C API using the "y#" format unit is unable to accept a memoryview instance constructed from a bytes literal. It fails with "TypeError: argument 1 must be read-only bytes-like object, not memoryview".

I understand why the "y*" format unit and the buffer protocol are a superior API. In hindsight, I should have used the buffer protocol from the beginning in python-zstandard. However, this decision was primarily influenced because the docs aren't clear about the apparent limitations of "y#" compared to "y*" and I believed "y#" would get me what I wanted (pointer to read-only memory) without having to be burdened by the complexity of the buffer protocol in my C code.

So, docs issue #1 is that the limitations of "y#" compared to "y*" aren't immediately obvious when reading their respective sections in https://docs.python.org/3/c-api/arg.html#strings-and-buffers. To their credit, the docs for "y*" do have a bold recommendation to use it. But what's missing is the critical "why." There is also a paragraph above the format unit list explaining "bytes-like object" but this is detached from the definitions for "y#" and "y*" so it is easy to pass over.

Issue #2 (which may be an implementation bug) is why "y#" isn't accepting a memoryview constructed from bytes. The docs for "y#" say it accepts a "read-only bytes-like object," which is defined at https://docs.python.org/3/glossary.html#term-bytes-like-object. And the paragraphs there explicitly state that a memoryview of an immutable bytes is in fact a "read-only bytes-like object." So I have no clue why "y#" is refusing such an object.

I'll gladly author a documentation fix. However, I'm not sure what to say because I don't understand why "y#" isn't working in this memoryview(bytes) case and whether that issue applies to other types.

----------
assignee: docs at python
components: Documentation
messages: 295649
nosy: Gregory.Szorc, docs at python
priority: normal
severity: normal
status: open
title: Documentation is unclear how "y*" and "y#" formit units vary
type: enhancement
versions: Python 3.5

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

From report at bugs.python.org  Sat Jun 10 14:39:57 2017
From: report at bugs.python.org (Antoine Pitrou)
Date: Sat, 10 Jun 2017 18:39:57 +0000
Subject: [docs] [issue30625] Documentation is unclear how "y*" and "y#"
 formit units vary
In-Reply-To: <1497118572.05.0.886949691959.issue30625@psf.upfronthosting.co.za>
Message-ID: <1497119997.84.0.271677398177.issue30625@psf.upfronthosting.co.za>


Changes by Antoine Pitrou <pitrou at free.fr>:


----------
stage:  -> needs patch
type: enhancement -> behavior
versions: +Python 3.6, Python 3.7

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

From report at bugs.python.org  Sat Jun 10 15:19:11 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 10 Jun 2017 19:19:11 +0000
Subject: [docs] [issue30312] Small correction in set code sample
In-Reply-To: <1494319647.07.0.625979333092.issue30312@psf.upfronthosting.co.za>
Message-ID: <1497122351.52.0.479351594606.issue30312@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset ca816153445cba3baec15f7e890c71abfe495340 by Mariatta (KatherineMichel) in branch 'master':
bpo-30312: Small correction in datastructures set code sample (GH-2081)
https://github.com/python/cpython/commit/ca816153445cba3baec15f7e890c71abfe495340


----------

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

From report at bugs.python.org  Sat Jun 10 15:22:30 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 10 Jun 2017 19:22:30 +0000
Subject: [docs] [issue30312] Small correction in set code sample
In-Reply-To: <1494319647.07.0.625979333092.issue30312@psf.upfronthosting.co.za>
Message-ID: <1497122550.04.0.182905615417.issue30312@psf.upfronthosting.co.za>


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


----------
stage:  -> backport needed

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

From report at bugs.python.org  Sat Jun 10 16:23:17 2017
From: report at bugs.python.org (Katherine Michel)
Date: Sat, 10 Jun 2017 20:23:17 +0000
Subject: [docs] [issue30312] Small correction in set code sample
In-Reply-To: <1494319647.07.0.625979333092.issue30312@psf.upfronthosting.co.za>
Message-ID: <1497126197.03.0.624087642572.issue30312@psf.upfronthosting.co.za>


Changes by Katherine Michel <kthrnmichel at gmail.com>:


----------
pull_requests: +2149

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

From report at bugs.python.org  Sat Jun 10 16:33:59 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 10 Jun 2017 20:33:59 +0000
Subject: [docs] [issue30312] Small correction in set code sample
In-Reply-To: <1494319647.07.0.625979333092.issue30312@psf.upfronthosting.co.za>
Message-ID: <1497126839.7.0.279911463796.issue30312@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 865ed9ea67cf0d8a8dead91f3eac527553d92284 by Mariatta (KatherineMichel) in branch '3.6':
bpo-30312: Small correction in datastructures set code sample (GH-2081) (GH-2085)
https://github.com/python/cpython/commit/865ed9ea67cf0d8a8dead91f3eac527553d92284


----------

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

From report at bugs.python.org  Sat Jun 10 16:35:18 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 10 Jun 2017 20:35:18 +0000
Subject: [docs] [issue30312] Small correction in set code sample
In-Reply-To: <1494319647.07.0.625979333092.issue30312@psf.upfronthosting.co.za>
Message-ID: <1497126918.9.0.847456296656.issue30312@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Documentation has been updated, and backported to 3.6.
Thanks :)

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

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

From report at bugs.python.org  Sun Jun 11 00:06:17 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 11 Jun 2017 04:06:17 +0000
Subject: [docs] [issue30625] Documentation is unclear how "y*" and "y#"
 format units vary
In-Reply-To: <1497118572.05.0.886949691959.issue30625@psf.upfronthosting.co.za>
Message-ID: <1497153977.52.0.960552298933.issue30625@psf.upfronthosting.co.za>


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


----------
title: Documentation is unclear how "y*" and "y#" formit units vary -> Documentation is unclear how "y*" and "y#" format units vary

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

From report at bugs.python.org  Sun Jun 11 13:59:05 2017
From: report at bugs.python.org (SylvainDe)
Date: Sun, 11 Jun 2017 17:59:05 +0000
Subject: [docs] [issue26656] Documentation for re.compile is a bit outdated
In-Reply-To: <1459178484.74.0.770971045402.issue26656@psf.upfronthosting.co.za>
Message-ID: <1497203945.06.0.661831404628.issue26656@psf.upfronthosting.co.za>


SylvainDe added the comment:

IMHO, the sentence is not bad as it is. An easy (?) yet efficient way to make it much better from the a user perspective would be to make the "regular expression object" text a link leading to https://docs.python.org/3/library/re.html#regular-expression-objects .

----------
nosy: +SylvainDe

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

From report at bugs.python.org  Sun Jun 11 21:43:03 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 12 Jun 2017 01:43:03 +0000
Subject: [docs] [issue30621] import json before using json module in
 tutorial Input and Output
In-Reply-To: <1497086223.62.0.997560014368.issue30621@psf.upfronthosting.co.za>
Message-ID: <1497231783.28.0.504556055781.issue30621@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 1dbce04d0e3e93b715eb0d8024da396361759d16 by Mariatta (suketa) in branch 'master':
bpo-30621: Update Input Output Tutorial Example(GH-2074)
https://github.com/python/cpython/commit/1dbce04d0e3e93b715eb0d8024da396361759d16


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

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

From report at bugs.python.org  Sun Jun 11 21:44:29 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 12 Jun 2017 01:44:29 +0000
Subject: [docs] [issue30621] import json before using json module in
 tutorial Input and Output
In-Reply-To: <1497086223.62.0.997560014368.issue30621@psf.upfronthosting.co.za>
Message-ID: <1497231869.93.0.29107138958.issue30621@psf.upfronthosting.co.za>


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


----------
pull_requests: +2172

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

From report at bugs.python.org  Sun Jun 11 21:44:31 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 12 Jun 2017 01:44:31 +0000
Subject: [docs] [issue30621] import json before using json module in
 tutorial Input and Output
In-Reply-To: <1497086223.62.0.997560014368.issue30621@psf.upfronthosting.co.za>
Message-ID: <1497231871.89.0.798761076287.issue30621@psf.upfronthosting.co.za>


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


----------
pull_requests: +2173

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

From report at bugs.python.org  Sun Jun 11 21:44:34 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 12 Jun 2017 01:44:34 +0000
Subject: [docs] [issue30621] import json before using json module in
 tutorial Input and Output
In-Reply-To: <1497086223.62.0.997560014368.issue30621@psf.upfronthosting.co.za>
Message-ID: <1497231874.12.0.212808956408.issue30621@psf.upfronthosting.co.za>


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


----------
pull_requests: +2174

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

From report at bugs.python.org  Sun Jun 11 21:59:08 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 12 Jun 2017 01:59:08 +0000
Subject: [docs] [issue30621] import json before using json module in
 tutorial Input and Output
In-Reply-To: <1497086223.62.0.997560014368.issue30621@psf.upfronthosting.co.za>
Message-ID: <1497232747.95.0.42850655712.issue30621@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 47c9decb5feabb51416deffd2098ee31d73f1f5f by Mariatta in branch '3.6':
bpo-30621: Update Input Output Tutorial Example(GH-2074) (GH-2118)
https://github.com/python/cpython/commit/47c9decb5feabb51416deffd2098ee31d73f1f5f


----------

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

From report at bugs.python.org  Sun Jun 11 21:59:19 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 12 Jun 2017 01:59:19 +0000
Subject: [docs] [issue30621] import json before using json module in
 tutorial Input and Output
In-Reply-To: <1497086223.62.0.997560014368.issue30621@psf.upfronthosting.co.za>
Message-ID: <1497232759.84.0.397128325582.issue30621@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 7563b0508172cedb5e6a95d05e9122f1a0bfcd86 by Mariatta in branch '3.5':
bpo-30621: Update Input Output Tutorial Example(GH-2074) (GH-2119)
https://github.com/python/cpython/commit/7563b0508172cedb5e6a95d05e9122f1a0bfcd86


----------

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

From report at bugs.python.org  Sun Jun 11 21:59:35 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 12 Jun 2017 01:59:35 +0000
Subject: [docs] [issue30621] import json before using json module in
 tutorial Input and Output
In-Reply-To: <1497086223.62.0.997560014368.issue30621@psf.upfronthosting.co.za>
Message-ID: <1497232775.54.0.533021242558.issue30621@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 107949cb87d0f064bd9bcd39dc2a5e7266bfee30 by Mariatta in branch '2.7':
bpo-30621: Update Input Output Tutorial Example(GH-2074) (GH-2120)
https://github.com/python/cpython/commit/107949cb87d0f064bd9bcd39dc2a5e7266bfee30


----------

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

From report at bugs.python.org  Sun Jun 11 22:01:01 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 12 Jun 2017 02:01:01 +0000
Subject: [docs] [issue30621] import json before using json module in
 tutorial Input and Output
In-Reply-To: <1497086223.62.0.997560014368.issue30621@psf.upfronthosting.co.za>
Message-ID: <1497232861.95.0.255486492179.issue30621@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Thanks! :)

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

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

From vaulttech at gmail.com  Fri Jun  9 05:26:35 2017
From: vaulttech at gmail.com (John Gamboa)
Date: Fri, 9 Jun 2017 11:26:35 +0200
Subject: [docs] (minor issue) Missing string `_widget` in example code of
 unittest
Message-ID: <CAM6-U1Sp_4QkRZ+4Xj0eR6i+b=hRAga+yJP+H8ZU6SJkKZ_gvA@mail.gmail.com>

*TL;DR*: instead of `test_default_size` and `test_resize`, the strings
should be `test_default_widget_size` and `test_default_resize` in the
snippet explaining how to create a test suite (defining the function
`suite()`) in the documentation of Python 3.


*Longer version:*

I was reading the unittest documentation (in
https://docs.python.org/3/library/unittest.html). It has this example code:

class WidgetTestCase(unittest.TestCase):
    def setUp(self):
        self.widget = Widget('The widget')

    def test_default_widget_size(self):
        self.assertEqual(self.widget.size(), (50,50),
                         'incorrect default size')

    def test_widget_resize(self):
        self.widget.resize(100,150)
        self.assertEqual(self.widget.size(), (100,150),
                         'wrong size after resize')

Here, the names of the functions have `_widget`. In the Python 2.7
documentation (in https://docs.python.org/2/library/unittest.html), they
didn't have:

class WidgetTestCase(unittest.TestCase):
    def setUp(self):
        self.widget = Widget('The widget')

    def tearDown(self):
        self.widget.dispose()
        self.widget = None

    def test_default_size(self):
        self.assertEqual(self.widget.size(), (50,50),
                         'incorrect default size')

    def test_resize(self):
        self.widget.resize(100,150)
        self.assertEqual(self.widget.size(), (100,150),
                         'wrong size after resize')


Now... in the Python 2.7 documentation, afterwards there was another
example code that mentioned this one:

widgetTestSuite =
unittest.TestSuite()widgetTestSuite.addTest(WidgetTestCase('test_default_size'))widgetTestSuite.addTest(WidgetTestCase('test_resize'))

However, in the Python 3.6 documentation, the names of the functions
(`test_default_size`) are still the same:

def suite():
    suite = unittest.TestSuite()
    suite.addTest(WidgetTestCase('test_default_size'))
    suite.addTest(WidgetTestCase('test_resize'))
    return suite

They should have become `test_default_widget_size` and `test_widget_resize`.

(I tried creating an account in the issue tracker, but there seemed to be
some problem with my registration)

-- 
John Gamboa
rabanetescebolas.blogspot.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170609/243eda1f/attachment.html>

From report at bugs.python.org  Mon Jun 12 13:29:19 2017
From: report at bugs.python.org (Marco Buttu)
Date: Mon, 12 Jun 2017 17:29:19 +0000
Subject: [docs] [issue30217] Missing entry for the tilde (~) operator in the
 Index
In-Reply-To: <1493582160.76.0.882487661277.issue30217@psf.upfronthosting.co.za>
Message-ID: <1497288559.39.0.345380566204.issue30217@psf.upfronthosting.co.za>


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


----------
pull_requests: +2190

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

From report at bugs.python.org  Mon Jun 12 13:29:37 2017
From: report at bugs.python.org (Marco Buttu)
Date: Mon, 12 Jun 2017 17:29:37 +0000
Subject: [docs] [issue30217] Missing entry for the tilde (~) operator in the
 Index
In-Reply-To: <1493582160.76.0.882487661277.issue30217@psf.upfronthosting.co.za>
Message-ID: <1497288577.18.0.907737274754.issue30217@psf.upfronthosting.co.za>


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


----------
pull_requests: +2191

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

From report at bugs.python.org  Mon Jun 12 13:30:01 2017
From: report at bugs.python.org (Marco Buttu)
Date: Mon, 12 Jun 2017 17:30:01 +0000
Subject: [docs] [issue30217] Missing entry for the tilde (~) operator in the
 Index
In-Reply-To: <1493582160.76.0.882487661277.issue30217@psf.upfronthosting.co.za>
Message-ID: <1497288601.97.0.572843569636.issue30217@psf.upfronthosting.co.za>


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


----------
pull_requests: +2192

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

From report at bugs.python.org  Mon Jun 12 15:41:45 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 12 Jun 2017 19:41:45 +0000
Subject: [docs] [issue30217] Missing entry for the tilde (~) operator in the
 Index
In-Reply-To: <1493582160.76.0.882487661277.issue30217@psf.upfronthosting.co.za>
Message-ID: <1497296505.16.0.649513925823.issue30217@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset f59cac4b6458e5c47e24a39ba46fb178c3766577 by Mariatta (Marco Buttu) in branch '3.6':
bpo-30217: add the operators ~ and | to the index (GH-1502) (GH-2136)
https://github.com/python/cpython/commit/f59cac4b6458e5c47e24a39ba46fb178c3766577


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

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

From report at bugs.python.org  Mon Jun 12 15:42:51 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 12 Jun 2017 19:42:51 +0000
Subject: [docs] [issue30217] Missing entry for the tilde (~) operator in the
 Index
In-Reply-To: <1493582160.76.0.882487661277.issue30217@psf.upfronthosting.co.za>
Message-ID: <1497296571.68.0.370254226146.issue30217@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset bbb335891c2967bd13fbe2da775c0348260d95cb by Mariatta (Marco Buttu) in branch '2.7':
bpo-30217: add the operators ~ and | to the index (GH-1502) (GH-2137)
https://github.com/python/cpython/commit/bbb335891c2967bd13fbe2da775c0348260d95cb


----------

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

From report at bugs.python.org  Mon Jun 12 15:44:05 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 12 Jun 2017 19:44:05 +0000
Subject: [docs] [issue30217] Missing entry for the tilde (~) operator in the
 Index
In-Reply-To: <1493582160.76.0.882487661277.issue30217@psf.upfronthosting.co.za>
Message-ID: <1497296645.43.0.379199486831.issue30217@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 37e04153d5e331162608b33639ecd3c9a5ae2432 by Mariatta (Marco Buttu) in branch '3.5':
bpo-30217: add the operators ~ and | to the index (GH-1502) (GH-2138)
https://github.com/python/cpython/commit/37e04153d5e331162608b33639ecd3c9a5ae2432


----------

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

From report at bugs.python.org  Mon Jun 12 15:45:14 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 12 Jun 2017 19:45:14 +0000
Subject: [docs] [issue30217] Missing entry for the tilde (~) operator in the
 Index
In-Reply-To: <1493582160.76.0.882487661277.issue30217@psf.upfronthosting.co.za>
Message-ID: <1497296714.3.0.723710799698.issue30217@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Mon Jun 12 23:03:38 2017
From: report at bugs.python.org (Emily Morehouse)
Date: Tue, 13 Jun 2017 03:03:38 +0000
Subject: [docs] [issue26656] Documentation for re.compile is a bit outdated
In-Reply-To: <1459178484.74.0.770971045402.issue26656@psf.upfronthosting.co.za>
Message-ID: <1497323018.17.0.817956419811.issue26656@psf.upfronthosting.co.za>


Emily Morehouse added the comment:

YAHO (yet another humble opinion), I support improving the current re.compile documentation by adding a link to the regular expression object documentation. Great way to point a user to the complete list of methods and attributes while keeping match() and search() listed explicitly.

----------
nosy: +emilyemorehouse

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

From report at bugs.python.org  Tue Jun 13 03:46:00 2017
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 13 Jun 2017 07:46:00 +0000
Subject: [docs] [issue30644] [EASY][doc] Document that
 signal.set_wakeup_fd(-1), unregister the previsouly set wakeup FD
Message-ID: <1497339960.05.0.509461627972.issue30644@psf.upfronthosting.co.za>


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


----------
assignee: docs at python
components: Documentation
keywords: easy
nosy: docs at python, haypo
priority: normal
severity: normal
status: open
title: [EASY][doc] Document that signal.set_wakeup_fd(-1), unregister the previsouly set wakeup FD
versions: Python 3.7

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

From report at bugs.python.org  Tue Jun 13 03:48:51 2017
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 13 Jun 2017 07:48:51 +0000
Subject: [docs] [issue30644] [EASY][doc] Document that
 signal.set_wakeup_fd(-1), unregister the previsouly set wakeup FD
Message-ID: <1497340131.95.0.0118831841828.issue30644@psf.upfronthosting.co.za>


New submission from STINNER Victor:

The signal.set_wakeup_fd() function is used to write signal numbers as bytes into a pipe, to be able to handle signals using a "regular" file descriptors instead of special signal handlers.

https://docs.python.org/dev/library/signal.html

Problem: it's not documented how to unregister the FD. I just saw "signal.set_wakeup_fd(-1)" in a Pull Request and realized that we forgot to document it:
https://github.com/python/cpython/pull/2139/

This issue is an EASY issue: please leave it to real newcomers who didn't write any PR to CPython previously. Core developers: explain how to fix the issue, don't fix it ;-)

Doc/library/signal.rst should be modified. I read that it's even possible to create a PR using an online editor? I never tried:
https://github.com/python/cpython/blob/master/Doc/library/signal.rst

----------

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

From report at bugs.python.org  Tue Jun 13 04:17:59 2017
From: report at bugs.python.org (Antoine Pitrou)
Date: Tue, 13 Jun 2017 08:17:59 +0000
Subject: [docs] [issue30644] [EASY][doc] Document that
 signal.set_wakeup_fd(-1), unregister the previsouly set wakeup FD
In-Reply-To: <1497340131.95.0.0118831841828.issue30644@psf.upfronthosting.co.za>
Message-ID: <1497341879.58.0.0967231154719.issue30644@psf.upfronthosting.co.za>


Changes by Antoine Pitrou <pitrou at free.fr>:


----------
pull_requests: +2200

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

From report at bugs.python.org  Tue Jun 13 04:18:22 2017
From: report at bugs.python.org (Antoine Pitrou)
Date: Tue, 13 Jun 2017 08:18:22 +0000
Subject: [docs] [issue30644] [EASY][doc] Document that
 signal.set_wakeup_fd(-1), unregister the previsouly set wakeup FD
In-Reply-To: <1497340131.95.0.0118831841828.issue30644@psf.upfronthosting.co.za>
Message-ID: <1497341902.39.0.406443185427.issue30644@psf.upfronthosting.co.za>


Changes by Antoine Pitrou <pitrou at free.fr>:


----------
pull_requests: +2201

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

From report at bugs.python.org  Tue Jun 13 04:18:54 2017
From: report at bugs.python.org (Antoine Pitrou)
Date: Tue, 13 Jun 2017 08:18:54 +0000
Subject: [docs] [issue30644] [EASY][doc] Document that
 signal.set_wakeup_fd(-1), unregister the previsouly set wakeup FD
In-Reply-To: <1497340131.95.0.0118831841828.issue30644@psf.upfronthosting.co.za>
Message-ID: <1497341934.68.0.284642924501.issue30644@psf.upfronthosting.co.za>


Changes by Antoine Pitrou <pitrou at free.fr>:


----------
pull_requests: +2202

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

From report at bugs.python.org  Tue Jun 13 04:18:59 2017
From: report at bugs.python.org (Antoine Pitrou)
Date: Tue, 13 Jun 2017 08:18:59 +0000
Subject: [docs] [issue30644] [EASY][doc] Document that
 signal.set_wakeup_fd(-1), unregister the previsouly set wakeup FD
In-Reply-To: <1497340131.95.0.0118831841828.issue30644@psf.upfronthosting.co.za>
Message-ID: <1497341939.11.0.415167745042.issue30644@psf.upfronthosting.co.za>


Changes by Antoine Pitrou <pitrou at free.fr>:


----------
pull_requests: +2203

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

From report at bugs.python.org  Tue Jun 13 04:19:27 2017
From: report at bugs.python.org (Antoine Pitrou)
Date: Tue, 13 Jun 2017 08:19:27 +0000
Subject: [docs] [issue30644] [EASY][doc] Document that
 signal.set_wakeup_fd(-1), unregister the previsouly set wakeup FD
In-Reply-To: <1497340131.95.0.0118831841828.issue30644@psf.upfronthosting.co.za>
Message-ID: <1497341967.1.0.817203852948.issue30644@psf.upfronthosting.co.za>


Antoine Pitrou added the comment:

> This issue is an EASY issue: please leave it to real newcomers who didn't write any PR to CPython previously. Core developers: explain how to fix the issue, don't fix it ;-)

Too late, sorry!

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

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

From report at bugs.python.org  Tue Jun 13 04:20:16 2017
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 13 Jun 2017 08:20:16 +0000
Subject: [docs] [issue30644] [EASY][doc] Document that
 signal.set_wakeup_fd(-1), unregister the previsouly set wakeup FD
In-Reply-To: <1497340131.95.0.0118831841828.issue30644@psf.upfronthosting.co.za>
Message-ID: <1497342016.58.0.599673416397.issue30644@psf.upfronthosting.co.za>


STINNER Victor added the comment:

> This issue is an EASY issue: please leave it to real newcomers who didn't write any PR to CPython previously. Core developers: explain how to fix the issue, don't fix it ;-)

Oh wait, it seems like the core developer Antoine Pitrou fixed the issue before I created it! => commit d79c1d4a9406384f10a37f26a7515ce79f9fdd78

He already created 3 PR to backport the doc enhancement to 2.7, 3.5 and 3.6 branches.

Sorry!

----------

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

From report at bugs.python.org  Tue Jun 13 04:38:21 2017
From: report at bugs.python.org (Antoine Pitrou)
Date: Tue, 13 Jun 2017 08:38:21 +0000
Subject: [docs] [issue30644] [EASY][doc] Document that
 signal.set_wakeup_fd(-1), unregister the previsouly set wakeup FD
In-Reply-To: <1497340131.95.0.0118831841828.issue30644@psf.upfronthosting.co.za>
Message-ID: <1497343101.68.0.165963949702.issue30644@psf.upfronthosting.co.za>


Changes by Antoine Pitrou <pitrou at free.fr>:


----------
resolution:  -> fixed
stage:  -> resolved
status: open -> closed
versions: +Python 2.7, Python 3.5, Python 3.6

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

From report at bugs.python.org  Tue Jun 13 06:33:32 2017
From: report at bugs.python.org (Antoine Pitrou)
Date: Tue, 13 Jun 2017 10:33:32 +0000
Subject: [docs] [issue30051] Document that the random module doesn't support
 fork
In-Reply-To: <1491989089.77.0.552733144958.issue30051@psf.upfronthosting.co.za>
Message-ID: <1497350012.18.0.193247833975.issue30051@psf.upfronthosting.co.za>


Antoine Pitrou added the comment:

Victor, this issue should be obsolete now that the global Random instance is reseeded after fork().

----------

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

From report at bugs.python.org  Tue Jun 13 06:59:54 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 13 Jun 2017 10:59:54 +0000
Subject: [docs] [issue30051] Document that the random module doesn't support
 fork
In-Reply-To: <1491989089.77.0.552733144958.issue30051@psf.upfronthosting.co.za>
Message-ID: <1497351594.71.0.19173825027.issue30051@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

Even if the global Random instance is reseeded after fork(), other instances are not reseeded.

----------

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

From report at bugs.python.org  Tue Jun 13 07:07:29 2017
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 13 Jun 2017 11:07:29 +0000
Subject: [docs] [issue30051] Document that the random module doesn't support
 fork
In-Reply-To: <1497351594.71.0.19173825027.issue30051@psf.upfronthosting.co.za>
Message-ID: <CAMpsgwZ9W_bn65EXEEw98h_NKw9ManomJOMe4-_=f4RQYgbKMQ@mail.gmail.com>


STINNER Victor added the comment:

At least, it would be nice to document it for Python 3.6 and older.

----------

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

From report at bugs.python.org  Tue Jun 13 07:07:35 2017
From: report at bugs.python.org (Antoine Pitrou)
Date: Tue, 13 Jun 2017 11:07:35 +0000
Subject: [docs] [issue30051] Document that the random module doesn't support
 fork
In-Reply-To: <1491989089.77.0.552733144958.issue30051@psf.upfronthosting.co.za>
Message-ID: <1497352055.09.0.84019888625.issue30051@psf.upfronthosting.co.za>


Antoine Pitrou added the comment:

This is true, but it's by design.  If you want a specific random sequence (which is the primary use case for specific instances), you don't want fork() to mess with the random sequence.

----------

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

From report at bugs.python.org  Tue Jun 13 07:12:24 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 13 Jun 2017 11:12:24 +0000
Subject: [docs] [issue30051] Document that the random module doesn't support
 fork
In-Reply-To: <1491989089.77.0.552733144958.issue30051@psf.upfronthosting.co.za>
Message-ID: <1497352344.21.0.128585456531.issue30051@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

Yes, this is a feature, not a bug. But I think it is worth be explicitly documented.

----------

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

From report at bugs.python.org  Tue Jun 13 08:10:56 2017
From: report at bugs.python.org (Nick Coghlan)
Date: Tue, 13 Jun 2017 12:10:56 +0000
Subject: [docs] [issue30637] Syntax error reported on compile(...),
 but not on compile(..., ast.PyCF_ONLY_AST)
In-Reply-To: <1497271056.08.0.482498543523.issue30637@psf.upfronthosting.co.za>
Message-ID: <1497355856.56.0.710678326693.issue30637@psf.upfronthosting.co.za>


Nick Coghlan added the comment:

It's intended behaviour, but you're right that we don't explicitly document anywhere that SyntaxError can be reported from three different places:

- the initial parsing based on the language Grammar
- the conversion of the parse tree into the AST
- the conversion of the AST into a runtime code object

It isn't possible to separate the first two from pure Python code, but ast.parse() (aka the ast.PyCF_ONLY_AST compile flag) skips the last one.

As Micha? noted, it's usually that last stage which checks for "higher level" constructs related to lexical structure, where certain statements can only be meaningfully executed when used inside a suitable compound statement, but can still be parsed outside it:

```
>>> ast.dump(ast.parse("break"))
'Module(body=[Break()])'
>>> ast.dump(ast.parse("continue"))
'Module(body=[Continue()])'
>>> ast.dump(ast.parse("return"))
'Module(body=[Return(value=None)])'
>>> ast.dump(ast.parse("yield"))
'Module(body=[Expr(value=Yield(value=None))])'
```

(`await` currently isn't in that category, but that's specifically due to the parser hacks used to enable it without needing a __future__ import)

The appropriate fix would probably be to add a sentence to the `ast.PyCF_ONLY_AST` documentation to say that some syntax errors are only detected when compiling the AST to a code object.

----------
assignee:  -> docs at python
components: +Documentation -Interpreter Core
nosy: +docs at python, ncoghlan
stage:  -> needs patch
type:  -> enhancement

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

From report at bugs.python.org  Tue Jun 13 08:18:03 2017
From: report at bugs.python.org (=?utf-8?b?SHJ2b2plIE5pa8WhacSH?=)
Date: Tue, 13 Jun 2017 12:18:03 +0000
Subject: [docs] [issue30637] Syntax error reported on compile(...),
 but not on compile(..., ast.PyCF_ONLY_AST)
In-Reply-To: <1497271056.08.0.482498543523.issue30637@psf.upfronthosting.co.za>
Message-ID: <1497356283.03.0.969586733536.issue30637@psf.upfronthosting.co.za>


Hrvoje Nik?i? added the comment:

> The appropriate fix would probably be to add a sentence to the
> `ast.PyCF_ONLY_AST` documentation to say that some syntax errors
> are only detected when compiling the AST to a code object.

Yes, please. I'm not saying the current behavior is wrong (it makes sense that some constructs are legal as AST, but can't be converted into code), I just found it surprising. In other words, we would have found it very useful for the documentation to mention that code generation performs additional checks on the AST that are not performed during the ast.PyCF_ONLY_AST compilation.

----------

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

From report at bugs.python.org  Tue Jun 13 10:40:09 2017
From: report at bugs.python.org (Jan Hnatek)
Date: Tue, 13 Jun 2017 14:40:09 +0000
Subject: [docs] [issue30656] typo in PyModule_New documentation
Message-ID: <1497364809.31.0.0904265199441.issue30656@psf.upfronthosting.co.za>


New submission from Jan Hnatek:

The doc for PyModule_New() refers to "PyImport_NewObject()", while it should refer to "PyModule_NewObject()":

https://docs.python.org/3.6/c-api/module.html#c.PyModule_New

----------
assignee: docs at python
components: Documentation
messages: 295922
nosy: docs at python, hnhn
priority: normal
severity: normal
status: open
title: typo in PyModule_New documentation
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/issue30656>
_______________________________________

From report at bugs.python.org  Tue Jun 13 12:50:23 2017
From: report at bugs.python.org (Carol Willing)
Date: Tue, 13 Jun 2017 16:50:23 +0000
Subject: [docs] [issue25514] Improve IDLE's "subprocess didn't make
 connection" message
In-Reply-To: <1446151640.74.0.583734209916.issue25514@psf.upfronthosting.co.za>
Message-ID: <1497372623.81.0.372147211701.issue25514@psf.upfronthosting.co.za>


Carol Willing added the comment:

Based on Terry's latest message and recommendation, I've marked this as a Documentation issue and suitable for new contributors.

----------
assignee:  -> docs at python
components: +Documentation
keywords: +easy
nosy: +docs at python, willingc

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

From report at bugs.python.org  Tue Jun 13 12:55:09 2017
From: report at bugs.python.org (Emily Morehouse)
Date: Tue, 13 Jun 2017 16:55:09 +0000
Subject: [docs] [issue30656] typo in PyModule_New documentation
In-Reply-To: <1497364809.31.0.0904265199441.issue30656@psf.upfronthosting.co.za>
Message-ID: <1497372909.78.0.0108705642813.issue30656@psf.upfronthosting.co.za>


Changes by Emily Morehouse <emily at cuttlesoft.com>:


----------
pull_requests: +2220

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

From report at bugs.python.org  Tue Jun 13 12:55:49 2017
From: report at bugs.python.org (Emily Morehouse)
Date: Tue, 13 Jun 2017 16:55:49 +0000
Subject: [docs] [issue30656] typo in PyModule_New documentation
In-Reply-To: <1497364809.31.0.0904265199441.issue30656@psf.upfronthosting.co.za>
Message-ID: <1497372949.32.0.0269391107108.issue30656@psf.upfronthosting.co.za>


Emily Morehouse added the comment:

Good catch, fixed in PR.

----------
nosy: +emilyemorehouse

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

From report at bugs.python.org  Tue Jun 13 13:09:24 2017
From: report at bugs.python.org (=?utf-8?b?TWljaGHFgiBSYWR3YcWEc2tp?=)
Date: Tue, 13 Jun 2017 17:09:24 +0000
Subject: [docs] [issue30656] typo in PyModule_New documentation
In-Reply-To: <1497364809.31.0.0904265199441.issue30656@psf.upfronthosting.co.za>
Message-ID: <1497373764.53.0.581270653434.issue30656@psf.upfronthosting.co.za>


Changes by Micha? Radwa?ski <lisklusownik at gmail.com>:


----------
pull_requests: +2222

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

From report at bugs.python.org  Tue Jun 13 13:10:29 2017
From: report at bugs.python.org (Carol Willing)
Date: Tue, 13 Jun 2017 17:10:29 +0000
Subject: [docs] [issue30656] typo in PyModule_New documentation
In-Reply-To: <1497364809.31.0.0904265199441.issue30656@psf.upfronthosting.co.za>
Message-ID: <1497373829.74.0.721835238038.issue30656@psf.upfronthosting.co.za>


Changes by Carol Willing <willingc at gmail.com>:


----------
stage:  -> commit review

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

From report at bugs.python.org  Tue Jun 13 13:52:55 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 13 Jun 2017 17:52:55 +0000
Subject: [docs] [issue30656] typo in PyModule_New documentation
In-Reply-To: <1497364809.31.0.0904265199441.issue30656@psf.upfronthosting.co.za>
Message-ID: <1497376375.99.0.32978063185.issue30656@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Tue Jun 13 13:58:21 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 13 Jun 2017 17:58:21 +0000
Subject: [docs] [issue30656] typo in PyModule_New documentation
In-Reply-To: <1497364809.31.0.0904265199441.issue30656@psf.upfronthosting.co.za>
Message-ID: <1497376701.12.0.0526499516613.issue30656@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 2d0afef82a07afdb666f2ca0c533aac5d39155cd by Mariatta (Emily Morehouse) in branch 'master':
bpo-30656: Fix Python C API Module Objects documentation (GH-2170)
https://github.com/python/cpython/commit/2d0afef82a07afdb666f2ca0c533aac5d39155cd


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

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

From report at bugs.python.org  Tue Jun 13 13:59:33 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 13 Jun 2017 17:59:33 +0000
Subject: [docs] [issue30656] typo in PyModule_New documentation
In-Reply-To: <1497364809.31.0.0904265199441.issue30656@psf.upfronthosting.co.za>
Message-ID: <1497376773.03.0.165556786896.issue30656@psf.upfronthosting.co.za>


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


----------
stage: commit review -> backport needed

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

From report at bugs.python.org  Tue Jun 13 14:49:23 2017
From: report at bugs.python.org (Ben Hoyt)
Date: Tue, 13 Jun 2017 18:49:23 +0000
Subject: [docs] [issue30659] Use ** correctly for "kwargs" in signature of
 namedtuple._replace()
Message-ID: <1497379763.32.0.322552703927.issue30659@psf.upfronthosting.co.za>


New submission from Ben Hoyt:

The documentation for namedtuple._replace() needs a tweak: currently its signature shows "kwargs" without the ** notation, indicating it's a single, positional argument. It should have the ** to indicate it's actually any number of keyword arguments.

See https://docs.python.org/3/library/collections.html#collections.somenamedtuple._replace and compare with the docs for the signature of Logger.debug() for example: https://docs.python.org/3/library/logging.html#logging.Logger.debug

----------
assignee: docs at python
components: Documentation
messages: 295949
nosy: benhoyt, docs at python, rhettinger
priority: normal
pull_requests: 2225
severity: normal
status: open
title: Use ** correctly for "kwargs" in signature of namedtuple._replace()
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/issue30659>
_______________________________________

From report at bugs.python.org  Tue Jun 13 14:56:58 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Tue, 13 Jun 2017 18:56:58 +0000
Subject: [docs] [issue25514] Improve IDLE's "subprocess didn't make
 connection" message
In-Reply-To: <1446151640.74.0.583734209916.issue25514@psf.upfronthosting.co.za>
Message-ID: <1497380218.82.0.674428120261.issue25514@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

Thanks for the reminder to get busy on this ;-). My short notes are insufficient for anyone else to write this.

----------
assignee: docs at python -> terry.reedy

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

From report at bugs.python.org  Tue Jun 13 14:58:51 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Tue, 13 Jun 2017 18:58:51 +0000
Subject: [docs] [issue25514] Improve IDLE's "subprocess didn't make
 connection" message
In-Reply-To: <1446151640.74.0.583734209916.issue25514@psf.upfronthosting.co.za>
Message-ID: <1497380331.49.0.341580162186.issue25514@psf.upfronthosting.co.za>


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


Removed file: http://bugs.python.org/file40915/dia2.py

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

From report at bugs.python.org  Tue Jun 13 15:20:53 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 13 Jun 2017 19:20:53 +0000
Subject: [docs] [issue30659] Use ** correctly for "kwargs" in signature of
 namedtuple._replace()
In-Reply-To: <1497379763.32.0.322552703927.issue30659@psf.upfronthosting.co.za>
Message-ID: <1497381653.43.0.728323627153.issue30659@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 184bd82ba8106785ba22f0d2477dbd08bef821fb by Mariatta (Ben Hoyt) in branch 'master':
bpo-30659 : Use ** for kwargs in namedtuple._replace() signature (GH-2173)
https://github.com/python/cpython/commit/184bd82ba8106785ba22f0d2477dbd08bef821fb


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

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

From report at bugs.python.org  Tue Jun 13 15:21:37 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 13 Jun 2017 19:21:37 +0000
Subject: [docs] [issue30659] Use ** correctly for "kwargs" in signature of
 namedtuple._replace()
In-Reply-To: <1497379763.32.0.322552703927.issue30659@psf.upfronthosting.co.za>
Message-ID: <1497381697.72.0.690392319119.issue30659@psf.upfronthosting.co.za>


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


----------
stage:  -> backport needed
versions:  -Python 3.3, Python 3.4

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

From report at bugs.python.org  Tue Jun 13 20:27:03 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Wed, 14 Jun 2017 00:27:03 +0000
Subject: [docs] [issue25514] Improve IDLE's "subprocess didn't make
 connection" message
In-Reply-To: <1446151640.74.0.583734209916.issue25514@psf.upfronthosting.co.za>
Message-ID: <1497400023.97.0.177263062446.issue25514@psf.upfronthosting.co.za>


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


----------
pull_requests: +2230

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

From report at bugs.python.org  Tue Jun 13 20:37:56 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Wed, 14 Jun 2017 00:37:56 +0000
Subject: [docs] [issue25514] Improve IDLE's "subprocess didn't make
 connection" message
In-Reply-To: <1446151640.74.0.583734209916.issue25514@psf.upfronthosting.co.za>
Message-ID: <1497400676.73.0.0103334844957.issue25514@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

I tested (and tweaked) the visible box with this:
from idlelib.run import show_socket_error
show_socket_error(OSError(61, 'connection refused'), ('port', 8888))
URL was tested with cut-and-paste from run.py.

This should be turned into an htest (human view test).  I did not do so now because I wanted get this into 3.6.2, and there is no indication of when the grace-period delay will end.

Message boxes do not allow copy to clipboard.  A nice refinement would be a [View URL] button.  I believe the code to do so is somewhere in IDLE.  Or the F1 Python Docs code, which opens the Windows help version, should be adjustable to open to a specific topic.

----------
versions: +Python 3.7 -Python 2.7, Python 3.5

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

From report at bugs.python.org  Tue Jun 13 21:32:19 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Wed, 14 Jun 2017 01:32:19 +0000
Subject: [docs] [issue25514] Improve IDLE's "subprocess didn't make
 connection" message
In-Reply-To: <1446151640.74.0.583734209916.issue25514@psf.upfronthosting.co.za>
Message-ID: <1497403939.08.0.508806331118.issue25514@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:


New changeset 188aedf8bb623d41302e10503268b0852ea91134 by terryjreedy in branch 'master':
bpo-25514: Improve IDLE's connection refused message (#2177)
https://github.com/python/cpython/commit/188aedf8bb623d41302e10503268b0852ea91134


----------

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

From report at bugs.python.org  Tue Jun 13 21:38:40 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Wed, 14 Jun 2017 01:38:40 +0000
Subject: [docs] [issue25514] Improve IDLE's "subprocess didn't make
 connection" message
In-Reply-To: <1446151640.74.0.583734209916.issue25514@psf.upfronthosting.co.za>
Message-ID: <1497404320.45.0.247051355307.issue25514@psf.upfronthosting.co.za>


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


----------
pull_requests: +2231

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

From report at bugs.python.org  Tue Jun 13 22:13:17 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Wed, 14 Jun 2017 02:13:17 +0000
Subject: [docs] [issue25514] Improve IDLE's "subprocess didn't make
 connection" message
In-Reply-To: <1446151640.74.0.583734209916.issue25514@psf.upfronthosting.co.za>
Message-ID: <1497406397.32.0.950975764854.issue25514@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:


New changeset 22d909f8c24bd7768df1a5bf0e52c597ea947cfb by terryjreedy in branch '3.6':
[3.6]bpo-25514: Improve IDLE's connection refused message (#2177) (#2178)
https://github.com/python/cpython/commit/22d909f8c24bd7768df1a5bf0e52c597ea947cfb


----------

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

From report at bugs.python.org  Wed Jun 14 01:18:40 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Wed, 14 Jun 2017 05:18:40 +0000
Subject: [docs] [issue30659] Use ** correctly for "kwargs" in signature of
 namedtuple._replace()
In-Reply-To: <1497379763.32.0.322552703927.issue30659@psf.upfronthosting.co.za>
Message-ID: <1497417520.13.0.177425693163.issue30659@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/issue30659>
_______________________________________

From report at bugs.python.org  Wed Jun 14 01:22:49 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Wed, 14 Jun 2017 05:22:49 +0000
Subject: [docs] [issue30659] Use ** correctly for "kwargs" in signature of
 namedtuple._replace()
In-Reply-To: <1497379763.32.0.322552703927.issue30659@psf.upfronthosting.co.za>
Message-ID: <1497417769.88.0.636604586014.issue30659@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

This looks fine.

----------

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

From report at bugs.python.org  Wed Jun 14 01:25:26 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 14 Jun 2017 05:25:26 +0000
Subject: [docs] [issue30659] Use ** correctly for "kwargs" in signature of
 namedtuple._replace()
In-Reply-To: <1497379763.32.0.322552703927.issue30659@psf.upfronthosting.co.za>
Message-ID: <1497417926.25.0.422947650421.issue30659@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

Currently there are two implementations of OrderedDict, and Python implementation is not used. Is C implementation need an update? What about the module documentation, is it need an update?

I don't think that we should include such details about past Python versions in docstrings. I can't remember precedences.

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

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

From report at bugs.python.org  Wed Jun 14 01:26:31 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 14 Jun 2017 05:26:31 +0000
Subject: [docs] [issue30659] Use ** correctly for "kwargs" in signature of
 namedtuple._replace()
In-Reply-To: <1497379763.32.0.322552703927.issue30659@psf.upfronthosting.co.za>
Message-ID: <1497417991.94.0.810247841495.issue30659@psf.upfronthosting.co.za>


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


----------
Removed message: http://bugs.python.org/msg295986

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

From report at bugs.python.org  Wed Jun 14 01:26:49 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 14 Jun 2017 05:26:49 +0000
Subject: [docs] [issue30659] Use ** correctly for "kwargs" in signature of
 namedtuple._replace()
In-Reply-To: <1497379763.32.0.322552703927.issue30659@psf.upfronthosting.co.za>
Message-ID: <1497418009.03.0.925965958925.issue30659@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

Sorry, wrong issue.

----------

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

From sophiatcm at outlook.com  Wed Jun 14 00:09:47 2017
From: sophiatcm at outlook.com (tang ge)
Date: Wed, 14 Jun 2017 04:09:47 +0000
Subject: [docs] question!
Message-ID: <SG2PR0401MB20483C61C308CBAC48CACFF8AAC30@SG2PR0401MB2048.apcprd04.prod.outlook.com>

I don't know why I can't use my python? Could you help me?

[cid:C2C9B9E7-7185-4018-B829-74AE5201BEA5]
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170614/9b546466/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: IDLE.tiff
Type: image/tiff
Size: 36586 bytes
Desc: IDLE.tiff
URL: <http://mail.python.org/pipermail/docs/attachments/20170614/9b546466/attachment-0001.tiff>

From report at bugs.python.org  Wed Jun 14 10:17:34 2017
From: report at bugs.python.org (Antoine Pitrou)
Date: Wed, 14 Jun 2017 14:17:34 +0000
Subject: [docs] [issue30625] Documentation is unclear how "y*" and "y#"
 format units vary
In-Reply-To: <1497118572.05.0.886949691959.issue30625@psf.upfronthosting.co.za>
Message-ID: <1497449854.46.0.656036305853.issue30625@psf.upfronthosting.co.za>


Changes by Antoine Pitrou <pitrou at free.fr>:


----------
nosy: +skrah

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

From report at bugs.python.org  Wed Jun 14 11:09:16 2017
From: report at bugs.python.org (Stefan Krah)
Date: Wed, 14 Jun 2017 15:09:16 +0000
Subject: [docs] [issue30625] Documentation is unclear how "y*" and "y#"
 format units vary
In-Reply-To: <1497118572.05.0.886949691959.issue30625@psf.upfronthosting.co.za>
Message-ID: <1497452955.92.0.660578354878.issue30625@psf.upfronthosting.co.za>


Stefan Krah added the comment:

Out of curiosity:

Is the 3.2 documentation clearer?

https://docs.python.org/3.2/c-api/arg.html#strings-and-buffers


Lately we have a lot of churn in the docs, not necessarily written by subject experts.

----------

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

From report at bugs.python.org  Wed Jun 14 14:27:06 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Wed, 14 Jun 2017 18:27:06 +0000
Subject: [docs] [issue30668] DOC: missing word in license.rst
Message-ID: <1497464826.74.0.48412228971.issue30668@psf.upfronthosting.co.za>


New submission from Cheryl Sabella:

The 'Select kqueue' section starts with:

"The `select` and contains the following notice for the kqueue    interface:"

And the 'SipHash24' section has:

"The file Python/pyhash.c contains Marek Majkowski? implementation of Dan Bernstein?s SipHash24 algorithm. The contains the following note:"

It seems like a word is missing on each line.  Maybe `module`?

----------
assignee: docs at python
components: Documentation
messages: 296021
nosy: christian.heimes, csabella, docs at python
priority: normal
severity: normal
status: open
title: DOC: missing word in license.rst
type: enhancement
versions: Python 3.7

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

From report at bugs.python.org  Wed Jun 14 14:40:49 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 14 Jun 2017 18:40:49 +0000
Subject: [docs] [issue30659] Use ** correctly for "kwargs" in signature of
 namedtuple._replace()
In-Reply-To: <1497379763.32.0.322552703927.issue30659@psf.upfronthosting.co.za>
Message-ID: <1497465649.25.0.722457071721.issue30659@psf.upfronthosting.co.za>


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


----------
pull_requests: +2239

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

From report at bugs.python.org  Wed Jun 14 14:57:28 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 14 Jun 2017 18:57:28 +0000
Subject: [docs] [issue30659] Use ** correctly for "kwargs" in signature of
 namedtuple._replace()
In-Reply-To: <1497379763.32.0.322552703927.issue30659@psf.upfronthosting.co.za>
Message-ID: <1497466648.82.0.94744824806.issue30659@psf.upfronthosting.co.za>


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


----------
pull_requests: +2240

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

From report at bugs.python.org  Wed Jun 14 14:58:34 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 14 Jun 2017 18:58:34 +0000
Subject: [docs] [issue30659] Use ** correctly for "kwargs" in signature of
 namedtuple._replace()
In-Reply-To: <1497379763.32.0.322552703927.issue30659@psf.upfronthosting.co.za>
Message-ID: <1497466714.89.0.969915472431.issue30659@psf.upfronthosting.co.za>


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


----------
pull_requests: +2241

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

From report at bugs.python.org  Wed Jun 14 14:59:40 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 14 Jun 2017 18:59:40 +0000
Subject: [docs] [issue30659] Use ** correctly for "kwargs" in signature of
 namedtuple._replace()
In-Reply-To: <1497379763.32.0.322552703927.issue30659@psf.upfronthosting.co.za>
Message-ID: <1497466780.04.0.711528617007.issue30659@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 789f47ebb56283bd0156957121ac2854817b2bf9 by Mariatta in branch '3.6':
bpo-30659 : Use ** for kwargs in namedtuple._replace() signature (GH-2173) (GH-2195)
https://github.com/python/cpython/commit/789f47ebb56283bd0156957121ac2854817b2bf9


----------

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

From report at bugs.python.org  Wed Jun 14 15:07:44 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 14 Jun 2017 19:07:44 +0000
Subject: [docs] [issue30659] Use ** correctly for "kwargs" in signature of
 namedtuple._replace()
In-Reply-To: <1497379763.32.0.322552703927.issue30659@psf.upfronthosting.co.za>
Message-ID: <1497467264.84.0.458343401329.issue30659@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 4b30107bfdc9ba5afbe7f4a9d96273d6078bc310 by Mariatta in branch '2.7':
bpo-30659 : Use ** for kwargs in namedtuple._replace() signature (GH-2173) (GH-2196)
https://github.com/python/cpython/commit/4b30107bfdc9ba5afbe7f4a9d96273d6078bc310


----------

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

From report at bugs.python.org  Wed Jun 14 15:07:57 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 14 Jun 2017 19:07:57 +0000
Subject: [docs] [issue30659] Use ** correctly for "kwargs" in signature of
 namedtuple._replace()
In-Reply-To: <1497379763.32.0.322552703927.issue30659@psf.upfronthosting.co.za>
Message-ID: <1497467277.1.0.438121633025.issue30659@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset a3afdca2190201bf6572435226dd3f8668139002 by Mariatta in branch '3.5':
bpo-30659 : Use ** for kwargs in namedtuple._replace() signature (GH-2173) (GH-2197)
https://github.com/python/cpython/commit/a3afdca2190201bf6572435226dd3f8668139002


----------

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

From report at bugs.python.org  Wed Jun 14 15:08:45 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 14 Jun 2017 19:08:45 +0000
Subject: [docs] [issue30659] Use ** correctly for "kwargs" in signature of
 namedtuple._replace()
In-Reply-To: <1497379763.32.0.322552703927.issue30659@psf.upfronthosting.co.za>
Message-ID: <1497467325.27.0.0211759626385.issue30659@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Fixed and backported.
Thanks.

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

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

From bgailer at gmail.com  Thu Jun 15 09:37:52 2017
From: bgailer at gmail.com (bob gailer)
Date: Thu, 15 Jun 2017 09:37:52 -0400
Subject: [docs] Bug or intended behavior?
In-Reply-To: <3c3d3d9f-9ee9-4610-a232-2d0565dcf061@googlegroups.com>
References: <1aef49ce-91e5-4327-beb4-369fac8da0ac@googlegroups.com>
 <lf5k24u70zn.fsf@ling.helsinki.fi>
 <5d0eaeff-55b1-5989-df92-6f3c2f6a33e7@gmail.com>
 <mailman.3.1496425551.29852.python-list@python.org>
 <3c3d3d9f-9ee9-4610-a232-2d0565dcf061@googlegroups.com>
Message-ID: <ddd0fb29-63ce-662e-c0c6-8bfb4d9516b0@gmail.com>

Sending this to docs in hopes of improving documentation of % formatting 
and operator precedence. Perhaps add "see 6:16 Operator precedence."

On 6/3/2017 5:59 PM, Sean DiZazzo wrote:
> On Friday, June 2, 2017 at 10:46:03 AM UTC-7, bob gailer wrote:
>> On 6/2/2017 1:28 PM, Jussi Piitulainen wrote:
>>> sean.dizazzo at gmail.com writes:
>>>
>>>> Can someone please explain this to me?  Thanks in advance!
>>>>
>>>> ~Sean
>>>>
>>>>
>>>> Python 2.7.13 (v2.7.13:a06454b1afa1, Dec 17 2016, 12:39:47)
>>>> [GCC 4.2.1 (Apple Inc. build 5666) (dot 3)] on darwin
>>>> Type "help", "copyright", "credits" or "license" for more information.
>>>>>>> print "foo %s" % 1-2
>>>> Traceback (most recent call last):
>>>>     File "<stdin>", line 1, in <module>
>>>> TypeError: unsupported operand type(s) for -: 'str' and 'int'
>>> The per cent operator has precedence over minus. Spacing is not
>>> relevant. Use parentheses.
>>
>> In other words "foo %s" % 1 is executed, giving "1". Then "1"-2 is
>> attempted giving the error.
>> Also: If there is more than one conversion specifier the right argument
>> to % must be a tuple.
>> I usually write a tuple even if there is only one conversion specifier -
>> that avoids the problem
>> you encountered and makes it easy to add more values when you add more
>> conversion specifiers.
>>
>> print "foo %s" % (1-2,)
>>
>> Bob Gailer
> I get what it's doing, it just doesn't make much sense to me.  Looking at operator precedence, I only see the % operator in regards to modulus.  Nothing in regards to string formatting.  Is it just a side effect of the % being overloaded in strings?   Or is it intentional that it's higher precedence...and why?
The documentation is unfortunately flawed. If you look at the .chm file 
in the docs folder under the python installation 
(c:\python35\docs\python351.chm as an example, and enter % in the index, 
you will see:
%
   operator
% formatting
% interpolation
note that modulo is missing!

double-click operator to see the numeric operator
double-click % formatting to see the string "unique built-in operation" 
aka interpolation.
See under section 6:16 Operator precedence:
   "[5] The % operator is also used for string formatting; the same 
precedence applies."

Maybe I'm making too big a deal of it.  It just doesn't 'feel' right to me.

Unfortunately "feel" is not a good guide to understanding programming 
languages.
COBOL and Assembler use MOVE when it is actually COPY!

Slight OT digression: The language that is best for me is APL in which 
there is no operator precedence to worry about. Execution is strictly 
right-to-left. () are used when the order of evaluation needs to be 
altered. I recall one person telling me that "right-to-left" was not 
natural. He preferred "left-to-right" as in FORTRAN. So I considered the 
FORTRAN statement A = B + C * D. Turns out that A * B happens first, 
then C + then A =. Sure looks right-to-left to me!

From report at bugs.python.org  Thu Jun 15 10:08:58 2017
From: report at bugs.python.org (Enrico Bianchi)
Date: Thu, 15 Jun 2017 14:08:58 +0000
Subject: [docs] [issue30677] Enhance documentation of os.mkdir()
Message-ID: <1497535738.66.0.994856278172.issue30677@psf.upfronthosting.co.za>


New submission from Enrico Bianchi:

Currently, documentation for os.mkdir() (see https://docs.python.org/3.6/library/os.html#os.mkdir ) reports only FileExistsError exception if directory exists. Please, add other exceptions (e.g. FileNotFoundError if directory is created in a non existent path) or report OSError as superclass of exceptions returned from this method

----------
assignee: docs at python
components: Documentation
messages: 296097
nosy: docs at python, ebianchi
priority: normal
severity: normal
status: open
title: Enhance documentation of os.mkdir()
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/issue30677>
_______________________________________

From report at bugs.python.org  Thu Jun 15 11:28:35 2017
From: report at bugs.python.org (R. David Murray)
Date: Thu, 15 Jun 2017 15:28:35 +0000
Subject: [docs] [issue30677] Enhance documentation of os.mkdir()
In-Reply-To: <1497535738.66.0.994856278172.issue30677@psf.upfronthosting.co.za>
Message-ID: <1497540515.32.0.117366938956.issue30677@psf.upfronthosting.co.za>


R. David Murray added the comment:

We don't generally document all exceptions that a method can raise, only those that are relevant to its specific API.  In this case, documenting the exception answers the question, "what happens if the directory already exists?"  This question is relevant to the API since the other reasonable possibility is that it would act as if the mkdir had succeeded.  As for documenting OSError, I'm sure there are ways to get os.mkdir to raise an exception that is not an OSError.

However, there is an argument to be made for documenting FileNotFound: the other reasonable thing the function could do in that case would be to create all intermediate path parts, but it does not do that (you use os.makedirs for that).  Since os.makedirs is documented right after os.mkdir, I'm not sure it is worth adding, but one can make the argument :)

----------
nosy: +r.david.murray

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

From report at bugs.python.org  Thu Jun 15 13:21:48 2017
From: report at bugs.python.org (Gregory Szorc)
Date: Thu, 15 Jun 2017 17:21:48 +0000
Subject: [docs] [issue30625] Documentation is unclear how "y*" and "y#"
 format units vary
In-Reply-To: <1497118572.05.0.886949691959.issue30625@psf.upfronthosting.co.za>
Message-ID: <1497547308.66.0.661019411158.issue30625@psf.upfronthosting.co.za>


Gregory Szorc added the comment:

IMO I don't find the 3.2 docs more useful. Specifically, the behavior for memoryview is still unclear.

----------

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

From report at bugs.python.org  Thu Jun 15 18:18:17 2017
From: report at bugs.python.org (STINNER Victor)
Date: Thu, 15 Jun 2017 22:18:17 +0000
Subject: [docs] [issue23890] assertRaises increases reference counter
In-Reply-To: <1428518225.53.0.665360255509.issue23890@psf.upfronthosting.co.za>
Message-ID: <1497565097.76.0.917541687997.issue23890@psf.upfronthosting.co.za>


STINNER Victor added the comment:


New changeset 50dbf577e10f806056d60ac956db0748d2cc8257 by Victor Stinner in branch '3.6':
bpo-23890: Fix ref cycle in TestCase.assertRaises (#858)
https://github.com/python/cpython/commit/50dbf577e10f806056d60ac956db0748d2cc8257


----------

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

From report at bugs.python.org  Thu Jun 15 18:33:48 2017
From: report at bugs.python.org (STINNER Victor)
Date: Thu, 15 Jun 2017 22:33:48 +0000
Subject: [docs] [issue23890] assertRaises increases reference counter
In-Reply-To: <1428518225.53.0.665360255509.issue23890@psf.upfronthosting.co.za>
Message-ID: <1497566028.43.0.842293057858.issue23890@psf.upfronthosting.co.za>


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


----------
pull_requests: +2273

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

From report at bugs.python.org  Thu Jun 15 18:51:26 2017
From: report at bugs.python.org (STINNER Victor)
Date: Thu, 15 Jun 2017 22:51:26 +0000
Subject: [docs] [issue23890] assertRaises increases reference counter
In-Reply-To: <1428518225.53.0.665360255509.issue23890@psf.upfronthosting.co.za>
Message-ID: <1497567086.62.0.797679182231.issue23890@psf.upfronthosting.co.za>


STINNER Victor added the comment:


New changeset 3dc573c8d19dc42ed786ca3237afdad183c41ca0 by Victor Stinner in branch '3.5':
Fix ref cycles in TestCase.assertRaises() (#193) (#2228)
https://github.com/python/cpython/commit/3dc573c8d19dc42ed786ca3237afdad183c41ca0


----------

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

From report at bugs.python.org  Thu Jun 15 18:52:21 2017
From: report at bugs.python.org (STINNER Victor)
Date: Thu, 15 Jun 2017 22:52:21 +0000
Subject: [docs] [issue23890] assertRaises increases reference counter
In-Reply-To: <1428518225.53.0.665360255509.issue23890@psf.upfronthosting.co.za>
Message-ID: <1497567141.11.0.0885922097337.issue23890@psf.upfronthosting.co.za>


STINNER Victor added the comment:

Thank you Vjacheslav Fyodorov for your bug report! The bug should now be fixed in 3.5, 3.6 and master (future 3.7) branches.

Python 2.7 is not affected by the bug.

----------

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

From report at bugs.python.org  Thu Jun 15 18:52:29 2017
From: report at bugs.python.org (STINNER Victor)
Date: Thu, 15 Jun 2017 22:52:29 +0000
Subject: [docs] [issue23890] assertRaises increases reference counter
In-Reply-To: <1428518225.53.0.665360255509.issue23890@psf.upfronthosting.co.za>
Message-ID: <1497567149.54.0.0878044505774.issue23890@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Jun 15 20:59:49 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 16 Jun 2017 00:59:49 +0000
Subject: [docs] [issue30656] typo in PyModule_New documentation
In-Reply-To: <1497364809.31.0.0904265199441.issue30656@psf.upfronthosting.co.za>
Message-ID: <1497574789.87.0.885077981794.issue30656@psf.upfronthosting.co.za>


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


----------
pull_requests: +2275

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

From report at bugs.python.org  Thu Jun 15 20:59:55 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 16 Jun 2017 00:59:55 +0000
Subject: [docs] [issue30656] typo in PyModule_New documentation
In-Reply-To: <1497364809.31.0.0904265199441.issue30656@psf.upfronthosting.co.za>
Message-ID: <1497574795.75.0.433389143489.issue30656@psf.upfronthosting.co.za>


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


----------
pull_requests: +2276

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

From report at bugs.python.org  Thu Jun 15 21:49:45 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 16 Jun 2017 01:49:45 +0000
Subject: [docs] [issue30656] typo in PyModule_New documentation
In-Reply-To: <1497364809.31.0.0904265199441.issue30656@psf.upfronthosting.co.za>
Message-ID: <1497577785.27.0.294352767827.issue30656@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 6a90a124706b73824aebf5c2bd7b27daf82b2342 by Mariatta in branch '3.6':
bpo-30656: Fix Python C API Module Objects documentation (GH-2170) (GH-2230)
https://github.com/python/cpython/commit/6a90a124706b73824aebf5c2bd7b27daf82b2342


----------

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

From report at bugs.python.org  Thu Jun 15 21:49:56 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 16 Jun 2017 01:49:56 +0000
Subject: [docs] [issue30656] typo in PyModule_New documentation
In-Reply-To: <1497364809.31.0.0904265199441.issue30656@psf.upfronthosting.co.za>
Message-ID: <1497577796.85.0.548628210098.issue30656@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 0b13f58497d3a36d062c3b3b827abb05db5afbc1 by Mariatta in branch '3.5':
bpo-30656: Fix Python C API Module Objects documentation (GH-2170) (GH-2231)
https://github.com/python/cpython/commit/0b13f58497d3a36d062c3b3b827abb05db5afbc1


----------

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

From report at bugs.python.org  Thu Jun 15 21:50:11 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 16 Jun 2017 01:50:11 +0000
Subject: [docs] [issue30656] typo in PyModule_New documentation
In-Reply-To: <1497364809.31.0.0904265199441.issue30656@psf.upfronthosting.co.za>
Message-ID: <1497577811.5.0.386812208219.issue30656@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Jun 15 23:20:10 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 16 Jun 2017 03:20:10 +0000
Subject: [docs] [issue30176] curses attribute constants list is incomplete
In-Reply-To: <1493226906.47.0.950642994662.issue30176@psf.upfronthosting.co.za>
Message-ID: <1497583210.47.0.450213517375.issue30176@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 116dd5eba60a940b35db6aaf4e8c998ac30ad440 by Mariatta (Xiang Zhang) in branch 'master':
bpo-30176: Add missing curses cell attributes constants (GH-1302)
https://github.com/python/cpython/commit/116dd5eba60a940b35db6aaf4e8c998ac30ad440


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

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

From report at bugs.python.org  Fri Jun 16 00:00:22 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Fri, 16 Jun 2017 04:00:22 +0000
Subject: [docs] [issue30176] curses attribute constants list is incomplete
In-Reply-To: <1493226906.47.0.950642994662.issue30176@psf.upfronthosting.co.za>
Message-ID: <1497585622.74.0.0620086313469.issue30176@psf.upfronthosting.co.za>


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


----------
stage: patch review -> backport needed

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

From report at bugs.python.org  Fri Jun 16 02:16:03 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 16 Jun 2017 06:16:03 +0000
Subject: [docs] [issue30176] curses attribute constants list is incomplete
In-Reply-To: <1493226906.47.0.950642994662.issue30176@psf.upfronthosting.co.za>
Message-ID: <1497593763.16.0.481521377509.issue30176@psf.upfronthosting.co.za>


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


----------
pull_requests: +2284

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

From sudipta.saha.swtp at gmail.com  Thu Jun 15 13:52:45 2017
From: sudipta.saha.swtp at gmail.com (Sudipta Saha)
Date: Thu, 15 Jun 2017 23:22:45 +0530
Subject: [docs] [BUG] - Series.index returns wrong value for stop index
Message-ID: <CAJZ0Tu+cm_H3vF2p9DgAkRqP21=-fZpE5YNuE41r+Jo0HT748w@mail.gmail.com>

Hi,

I am using Anaconda3-4.3.1 (python based platform) and importing pandas.

I have defined a series object using the below code -

import pandas as pnd
series1 = pnd.Series([1,2,3,4,5,6,7,8,9])

So, the default index for the above series is from 0 to 8 as seen below -

0    1
1    2
2    3
3    4
4    5
5    6
6    7
7    8
8    9
dtype: int64


But, when i execute the code


series1.index


it returns the below output -


RangeIndex(start=0, *stop=9*, step=1)


I think that stop value is incorrect in the above output, instead the
stop value in the RangeIndex should be 8 (as per the definition of my
series1 object)



Thanks

Sudipta
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170615/60d18860/attachment-0001.html>

From report at bugs.python.org  Fri Jun 16 08:23:48 2017
From: report at bugs.python.org (Stefan Krah)
Date: Fri, 16 Jun 2017 12:23:48 +0000
Subject: [docs] [issue30625] Documentation is unclear how "y*" and "y#"
 format units vary
In-Reply-To: <1497118572.05.0.886949691959.issue30625@psf.upfronthosting.co.za>
Message-ID: <1497615828.75.0.466793411515.issue30625@psf.upfronthosting.co.za>


Stefan Krah added the comment:

Okay thanks, it's good to hear what others think about the docs.

> So I have no clue why "y#" is refusing such an object.

"y#" is refusing memoryview(bytes) because "y#" only allows objects without a releasebufferproc and memoryview itself always has one.


I wonder if we could simply use the cleanup() solution also for "y#", but I have to look closer at this.

----------

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

From report at bugs.python.org  Fri Jun 16 10:19:58 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 16 Jun 2017 14:19:58 +0000
Subject: [docs] [issue30176] curses attribute constants list is incomplete
In-Reply-To: <1493226906.47.0.950642994662.issue30176@psf.upfronthosting.co.za>
Message-ID: <1497622798.23.0.409988517329.issue30176@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 304a96e5868c1b38a87692668f297aaf041e6e67 by Mariatta in branch '3.6':
bpo-30176: Add missing curses cell attributes constants (GH-1302). (GH-2241)
https://github.com/python/cpython/commit/304a96e5868c1b38a87692668f297aaf041e6e67


----------

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

From report at bugs.python.org  Fri Jun 16 18:14:24 2017
From: report at bugs.python.org (Ivan Levkivskyi)
Date: Fri, 16 Jun 2017 22:14:24 +0000
Subject: [docs] [issue30619] typing.Union doc incoherence in case a class
 and its subclass are present
In-Reply-To: <1497055090.79.0.980256634301.issue30619@psf.upfronthosting.co.za>
Message-ID: <1497651263.99.0.315620428932.issue30619@psf.upfronthosting.co.za>


Ivan Levkivskyi added the comment:

Yes, you are right. Could you please make a PR at https://github.com/python/cpython/pulls ?

----------
nosy: +levkivskyi

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

From report at bugs.python.org  Fri Jun 16 21:33:03 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 17 Jun 2017 01:33:03 +0000
Subject: [docs] [issue30420] Clarify kwarg handing for subprocess
 convenience APIs
In-Reply-To: <1495337351.2.0.395497440987.issue30420@psf.upfronthosting.co.za>
Message-ID: <1497663183.41.0.0632408272358.issue30420@psf.upfronthosting.co.za>


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


----------
pull_requests: +2303

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

From report at bugs.python.org  Fri Jun 16 21:45:01 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 17 Jun 2017 01:45:01 +0000
Subject: [docs] [issue30637] Syntax error reported on compile(...),
 but not on compile(..., ast.PyCF_ONLY_AST)
In-Reply-To: <1497271056.08.0.482498543523.issue30637@psf.upfronthosting.co.za>
Message-ID: <1497663901.68.0.743728944502.issue30637@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

Python grammar is constrained to be, I believe, LL(1).  Whatever the constraint is, there are a few syntax rules that either cannot be written or would be difficult to write within the constraint.  So they are checked during compilation.  Can you suggest a couple of sentences you would have like to have seen, and where?

I might also note that not all exceptions raised by compile are literally 'SyntaxError's.

----------
nosy: +terry.reedy

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

From report at bugs.python.org  Fri Jun 16 23:18:44 2017
From: report at bugs.python.org (Martin Panter)
Date: Sat, 17 Jun 2017 03:18:44 +0000
Subject: [docs] [issue30625] Documentation is unclear how "y*" and "y#"
 format units vary
In-Reply-To: <1497118572.05.0.886949691959.issue30625@psf.upfronthosting.co.za>
Message-ID: <1497669524.51.0.498564549389.issue30625@psf.upfronthosting.co.za>


Martin Panter added the comment:

Issue 24009 proposes deprecating y# (among other units).

IMO the documentation and error message aren?t specific enough regarding the reference to ?bytes-like?.

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

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

From report at bugs.python.org  Sat Jun 17 22:17:43 2017
From: report at bugs.python.org (Kojo Idrissa)
Date: Sun, 18 Jun 2017 02:17:43 +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: <1497752263.64.0.880391085468.issue29933@psf.upfronthosting.co.za>


Changes by Kojo Idrissa <kojo.idrissa at gmail.com>:


----------
pull_requests: +2312

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

From report at bugs.python.org  Sat Jun 17 23:39:44 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sun, 18 Jun 2017 03:39:44 +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: <1497757184.27.0.445763764691.issue29933@psf.upfronthosting.co.za>


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


----------
versions: +Python 3.5, Python 3.6

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

From report at bugs.python.org  Sun Jun 18 08:45:07 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 18 Jun 2017 12:45:07 +0000
Subject: [docs] [issue20823] Clarify copyreg.pickle() documentation
In-Reply-To: <1393749966.08.0.529137298895.issue20823@psf.upfronthosting.co.za>
Message-ID: <1497789907.53.0.965697950735.issue20823@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

Could you update your patch Peter, and since CPython development is moved to GitHub, create a pull request?

----------

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

From report at bugs.python.org  Sun Jun 18 14:58:53 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 18 Jun 2017 18:58:53 +0000
Subject: [docs] [issue29430] zipfile: invalid link
In-Reply-To: <1486113194.67.0.258347417914.issue29430@psf.upfronthosting.co.za>
Message-ID: <1497812333.91.0.392615592778.issue29430@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

The link already is fixed.

----------
resolution:  -> out of date
stage: needs patch -> resolved
status: open -> closed

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

From report at bugs.python.org  Sun Jun 18 18:15:56 2017
From: report at bugs.python.org (Robert Tasarz)
Date: Sun, 18 Jun 2017 22:15:56 +0000
Subject: [docs] [issue30699] Misleading class names in datetime.tzinfo usage
 examples
Message-ID: <1497824156.09.0.152108719585.issue30699@psf.upfronthosting.co.za>


New submission from Robert Tasarz:

https://docs.python.org/3/library/datetime.html#datetime-objects
gives in an example two classes named GMT1 and GMT2 subclassing tzinfo, defined with dst(?) methods returning one hour timedelta for summer periods. This is in conflict with naming, as GMT timezone is not defined with any daylight saving time, so any timezone offsetted from it shouldn't be as well. I would suggest renaming them to something like BrusselsTZ and HelsinkiTZ (with a comment that this is simplified implementation, that doesn't account for exact hour when dst switch is made, and maybe mentioning pytz) and tzname(?) to return ('CET', 'CEST')[bool(self.dst(dt))] and ('EET', 'EEST')[bool(self.dst(dt))] accordingly.

Also https://docs.python.org/3/library/datetime.html#time-objects
has an example with GMT1 class, though this time dst(?) unconditionally returns offset 0 properly, tzname(?) gives 'Europe/Prague' ? region that uses dst. IMHO returning any of: "CET", "GMT+1", "Africa/Tunis" would be better here.

----------
assignee: docs at python
components: Documentation
messages: 296296
nosy: Robert.Tasarz, docs at python
priority: normal
severity: normal
status: open
title: Misleading class names in datetime.tzinfo usage examples
type: enhancement
versions: Python 2.7, Python 3.6

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

From report at bugs.python.org  Mon Jun 19 07:55:14 2017
From: report at bugs.python.org (swapnil agarwal)
Date: Mon, 19 Jun 2017 11:55:14 +0000
Subject: [docs] [issue26656] Documentation for re.compile is a bit outdated
In-Reply-To: <1459178484.74.0.770971045402.issue26656@psf.upfronthosting.co.za>
Message-ID: <1497873314.4.0.917083309042.issue26656@psf.upfronthosting.co.za>


swapnil agarwal added the comment:

hello team,

I am novice developer. Can I take it up as my first bug.

----------
nosy: +swapnil agarwal

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

From bityon at gmail.com  Sun Jun 18 06:27:15 2017
From: bityon at gmail.com (Yonatan)
Date: Sun, 18 Jun 2017 10:27:15 +0000
Subject: [docs] Bug Download Doc page
Message-ID: <HE1PR0502MB30344DADDAC4CC2F357479D6DBC70@HE1PR0502MB3034.eurprd05.prod.outlook.com>

Hello,

All the formats I tried to download the doc, their link was broken (404)

For example:

https://docs.python.org/3/archives/python-3.6.2rc1-docs-pdf-letter.zip

[cid:image003.png at 01D2E836.9732E9E0]
Hope it will be fixed soon,

Thank you,

Yonatan

Sent from Mail<https://go.microsoft.com/fwlink/?LinkId=550986> for Windows 10

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170618/39ce580e/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: B6140F2CABA74539A5AB70687A516C86.png
Type: image/png
Size: 45001 bytes
Desc: B6140F2CABA74539A5AB70687A516C86.png
URL: <http://mail.python.org/pipermail/docs/attachments/20170618/39ce580e/attachment-0001.png>

From report at bugs.python.org  Mon Jun 19 10:00:42 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Mon, 19 Jun 2017 14:00:42 +0000
Subject: [docs] [issue30176] curses attribute constants list is incomplete
In-Reply-To: <1493226906.47.0.950642994662.issue30176@psf.upfronthosting.co.za>
Message-ID: <1497880842.93.0.552467116791.issue30176@psf.upfronthosting.co.za>


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


----------
pull_requests: +2326

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

From report at bugs.python.org  Mon Jun 19 10:05:01 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Mon, 19 Jun 2017 14:05:01 +0000
Subject: [docs] [issue30176] curses attribute constants list is incomplete
In-Reply-To: <1493226906.47.0.950642994662.issue30176@psf.upfronthosting.co.za>
Message-ID: <1497881101.52.0.754187301383.issue30176@psf.upfronthosting.co.za>


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


----------
pull_requests: +2327

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

From report at bugs.python.org  Mon Jun 19 10:07:02 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Mon, 19 Jun 2017 14:07:02 +0000
Subject: [docs] [issue30176] curses attribute constants list is incomplete
In-Reply-To: <1493226906.47.0.950642994662.issue30176@psf.upfronthosting.co.za>
Message-ID: <1497881222.21.0.904873527561.issue30176@psf.upfronthosting.co.za>


Xiang Zhang added the comment:


New changeset 04521c275e47e4df59046ee0297810f06c208350 by Xiang Zhang in branch '3.5':
bpo-30176: Add missing curses cell attributes constants (#2277)
https://github.com/python/cpython/commit/04521c275e47e4df59046ee0297810f06c208350


----------

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

From report at bugs.python.org  Mon Jun 19 10:12:47 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Mon, 19 Jun 2017 14:12:47 +0000
Subject: [docs] [issue30176] curses attribute constants list is incomplete
In-Reply-To: <1493226906.47.0.950642994662.issue30176@psf.upfronthosting.co.za>
Message-ID: <1497881567.86.0.468257667255.issue30176@psf.upfronthosting.co.za>


Xiang Zhang added the comment:


New changeset b39a7481ee7e6166d6d2b252a7a514b1f6553dfa by Xiang Zhang in branch '2.7':
bpo-30176: Add missing curses cell attributes constants (#2278)
https://github.com/python/cpython/commit/b39a7481ee7e6166d6d2b252a7a514b1f6553dfa


----------

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

From report at bugs.python.org  Mon Jun 19 10:13:28 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Mon, 19 Jun 2017 14:13:28 +0000
Subject: [docs] [issue30176] curses attribute constants list is incomplete
In-Reply-To: <1493226906.47.0.950642994662.issue30176@psf.upfronthosting.co.za>
Message-ID: <1497881608.3.0.135328602335.issue30176@psf.upfronthosting.co.za>


Xiang Zhang added the comment:

Thanks Mariatta and Serhiy!

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

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

From report at bugs.python.org  Mon Jun 19 17:59:35 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Mon, 19 Jun 2017 21:59:35 +0000
Subject: [docs] [issue14944] Setup & Usage documentation for pydoc, IDLE,
 & 2to3
In-Reply-To: <1338256058.02.0.10025521772.issue14944@psf.upfronthosting.co.za>
Message-ID: <1497909575.48.0.0557679124967.issue14944@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

I am not sure where installed scripts are documented in Using Python.  'idle' and 'idle3' are not installed on Windows.

----------
title: Setup & Usage documentation for pydoc, idle & 2to3 -> Setup & Usage documentation for pydoc, IDLE, & 2to3
versions: +Python 3.6, Python 3.7 -Python 3.4, Python 3.5

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

From report at bugs.python.org  Mon Jun 19 18:15:41 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Mon, 19 Jun 2017 22:15:41 +0000
Subject: [docs] [issue17583] IDLE HOWTO
In-Reply-To: <1364685156.29.0.769214841654.issue17583@psf.upfronthosting.co.za>
Message-ID: <1497910541.48.0.714694663539.issue17583@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

Cheryl, what do you think of the revised patch?  I imagine it needs some updating for *nix, but does it seem useful to a beginner?

----------
nosy: +csabella
versions: +Python 3.6, Python 3.7 -Python 2.7, Python 3.3, Python 3.4

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

From report at bugs.python.org  Mon Jun 19 18:44:08 2017
From: report at bugs.python.org (Mark Lawrence)
Date: Mon, 19 Jun 2017 22:44:08 +0000
Subject: [docs] [issue14944] Setup & Usage documentation for pydoc, IDLE,
 & 2to3
In-Reply-To: <1338256058.02.0.10025521772.issue14944@psf.upfronthosting.co.za>
Message-ID: <1497912248.96.0.676737682537.issue14944@psf.upfronthosting.co.za>


Changes by Mark Lawrence <breamoreboy at gmail.com>:


----------
nosy:  -BreamoreBoy

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

From report at bugs.python.org  Mon Jun 19 19:59:28 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Mon, 19 Jun 2017 23:59:28 +0000
Subject: [docs] [issue17583] IDLE HOWTO
In-Reply-To: <1497910541.48.0.714694663539.issue17583@psf.upfronthosting.co.za>
Message-ID: <CAACPsK7di__bKS7A5VDC8x2tsntAwo3sNFe9f5PMzwoBqrqfrA@mail.gmail.com>


Cheryl Sabella added the comment:

I think it's a good start, but may need some tweaking.  For example, the
Menu options should probably somehow stand out from the rest of the text.

I think it would be useful for a beginner, depending on how much of a
beginner they are and how they got to this page.  For example, if I wanted
to learn Python and had no prior programming experience, most likely I
would google 'learn python' (or maybe even just 'learn to program') and
check out those links.  Some results, like the Tutorial in the python.org
docs, focus on getting Python installed and using the interactive
interpreter.  There doesn't seem to be anything in the python.org docs
(except for the FAQ) that suggest using IDLE.  Although, the FAQ might be
one of the first places a beginner would look, so maybe a link from there
to the HOWTO would be helpful.  I think showing how to install IDLE and use
it is important, and that alone would make this page useful.  The current
IDLE doc page has the command line usage in the middle of the page, but
doesn't really just answer how do I install it and how do I run it?

So, assuming a beginner is following some tutorial, they get to a point
where they need an editor.  Following the instructions for installing any
program can be tricky.  Heck, even installing Python might have been
tricky, so good for them if they got this far.  But, without any
instructions for getting IDLE to run, they are left to googling for it.  It
would be great for the python docs can have a step by step installation
instruction and even troubleshooting.  Then, as this HOWTO does, explain
what opens up and how to use the editor, etc.  As I've recently experienced
with git, I find it frustrating to spend half a day trying to get something
to work when it should be easy.  This page could be a one page
introduction/reference so that someone doesn't have to cobble together
answers from all over the internet to questions they didn't even know to
ask.

----------

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

From report at bugs.python.org  Mon Jun 19 21:27:52 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Tue, 20 Jun 2017 01:27:52 +0000
Subject: [docs] [issue17583] IDLE HOWTO
In-Reply-To: <1364685156.29.0.769214841654.issue17583@psf.upfronthosting.co.za>
Message-ID: <1497922072.68.0.420374515018.issue17583@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

Thanks.  This is helpful and got me started thinking.

I don't want to duplicate the reference doc too much, but a reference is just that, a reference.  The menu items are discussed in the order they appear, not the order a beginner might use the most common ones.

Judging from Stackoverflow questions, covering platform specifics is needed.  People seem to miss the following: Python runs IDLE; IDLE hands user code to Python to execute.  Output and error messages come from Python, not IDLE.  If you want python to import 3rd party modules, one must install the module for the Python used to run IDLE.  (I have answered at least 3 variations of this question.) Anyway, I realize that I have a source of frequent beginner questions and problems.  If we have answers in a How-To, I can quote and suggest that people read it.

Amit, do you wish to continue with this?

----------

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

From report at bugs.python.org  Mon Jun 19 23:28:19 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 20 Jun 2017 03:28:19 +0000
Subject: [docs] [issue30420] Clarify kwarg handing for subprocess
 convenience APIs
In-Reply-To: <1495337351.2.0.395497440987.issue30420@psf.upfronthosting.co.za>
Message-ID: <1497929299.07.0.395694597614.issue30420@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 0a4fe1d8578fa59004518f8deef137282be4d71a by Mariatta in branch '3.6':
[3.6] bpo-30420: List cwd parameter in subprocess convenience APIs (GH-1685) (GH-2253)
https://github.com/python/cpython/commit/0a4fe1d8578fa59004518f8deef137282be4d71a


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

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

From report at bugs.python.org  Tue Jun 20 00:34:20 2017
From: report at bugs.python.org (Damien George)
Date: Tue, 20 Jun 2017 04:34:20 +0000
Subject: [docs] [issue30707] Incorrect description of "async with" in PEP492
 and documentation
Message-ID: <1497933260.83.0.132605306713.issue30707@psf.upfronthosting.co.za>


Changes by Damien George <damien.p.george at gmail.com>:


----------
assignee: docs at python
components: Documentation
nosy: Damien George, docs at python
priority: normal
severity: normal
status: open
title: Incorrect description of "async with" in PEP492 and documentation
type: behavior
versions: Python 3.5, Python 3.6, Python 3.7

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

From report at bugs.python.org  Tue Jun 20 00:36:45 2017
From: report at bugs.python.org (Damien George)
Date: Tue, 20 Jun 2017 04:36:45 +0000
Subject: [docs] [issue30707] Incorrect description of "async with" in PEP492
 and documentation
Message-ID: <1497933405.85.0.444758448054.issue30707@psf.upfronthosting.co.za>


New submission from Damien George:

The behaviour of the "async with" statement in CPython does not match the description of it in PEP492, nor the language documentation.  The implementation uses a try/except/finally block, while the PEP and documentation describe the behaviour using a try/except/else block.  The PEP and documentation should be updated to reflect the true intention of "async with".

----------

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

From report at bugs.python.org  Tue Jun 20 01:38:31 2017
From: report at bugs.python.org (Nick Coghlan)
Date: Tue, 20 Jun 2017 05:38:31 +0000
Subject: [docs] [issue30707] Incorrect description of "async with" in PEP492
 and documentation
In-Reply-To: <1497933405.85.0.444758448054.issue30707@psf.upfronthosting.co.za>
Message-ID: <1497937111.75.0.984028127297.issue30707@psf.upfronthosting.co.za>


Nick Coghlan added the comment:

The specific issue is that early exits from an "async with" statement are actually defined the same way they for synchronous with statements: exiting early via return, break, or continue, is the same as reaching the end of the try block.

However, that's not what the documentation currently says: it describes "async with" in terms of try/except/else, which isn't correct.

----------
nosy: +ncoghlan, yselivanov

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

From report at bugs.python.org  Tue Jun 20 07:13:18 2017
From: report at bugs.python.org (AnqurVanillapy)
Date: Tue, 20 Jun 2017 11:13:18 +0000
Subject: [docs] [issue30709] Bad getter from Descriptor#Properties example
Message-ID: <1497957198.83.0.108909072277.issue30709@psf.upfronthosting.co.za>


New submission from AnqurVanillapy:

- The purpose of `obj` in the example is implicit
- As an argument the `obj` will cause errors when using Cell('b10').value because it expects more arguments, but 1 given

----------
assignee: docs at python
components: Documentation
messages: 296412
nosy: anqur, docs at python
priority: normal
pull_requests: 2336
severity: normal
status: open
title: Bad getter from Descriptor#Properties example
type: enhancement
versions: Python 2.7

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

From report at bugs.python.org  Tue Jun 20 15:32:05 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 20 Jun 2017 19:32:05 +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: <1497987124.85.0.510574989526.issue29933@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 5200a7c7f9ea65a96330c5f276f4acc6ec70854e by Mariatta (Kojo Idrissa) in branch 'master':
bpo-29933: Improve set_write_buffer_limits description (GH-2262)
https://github.com/python/cpython/commit/5200a7c7f9ea65a96330c5f276f4acc6ec70854e


----------

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

From report at bugs.python.org  Wed Jun 21 11:59:40 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 21 Jun 2017 15:59:40 +0000
Subject: [docs] [issue30709] Bad getter from Descriptor#Properties example
In-Reply-To: <1497957198.83.0.108909072277.issue30709@psf.upfronthosting.co.za>
Message-ID: <1498060780.55.0.160009805574.issue30709@psf.upfronthosting.co.za>


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


----------
versions: +Python 3.5, Python 3.6, Python 3.7

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

From report at bugs.python.org  Wed Jun 21 16:18:14 2017
From: report at bugs.python.org (R. David Murray)
Date: Wed, 21 Jun 2017 20:18:14 +0000
Subject: [docs] [issue29981] Update Index for set, dict,
 and generator 'comprehensions'
In-Reply-To: <1491328871.52.0.864348862414.issue29981@psf.upfronthosting.co.za>
Message-ID: <1498076294.29.0.779919546238.issue29981@psf.upfronthosting.co.za>


R. David Murray added the comment:

On the PR Berker wrote:

   I'm wondering if we should still advertise the use of set([...]). We replaced all instances of it with set literals in the stdlib.

set([...]) is part of the language, and the python documentation is also a specification of the language, so I think the reference *must* stay.

----------
nosy: +r.david.murray

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

From report at bugs.python.org  Thu Jun 22 04:32:01 2017
From: report at bugs.python.org (khyox)
Date: Thu, 22 Jun 2017 08:32:01 +0000
Subject: [docs] [issue30619] typing.Union doc incoherence in case a class
 and its subclass are present
In-Reply-To: <1497055090.79.0.980256634301.issue30619@psf.upfronthosting.co.za>
Message-ID: <1498120321.17.0.022093140807.issue30619@psf.upfronthosting.co.za>


Changes by khyox <jse.mnl at gmail.com>:


----------
pull_requests: +2375

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

From report at bugs.python.org  Thu Jun 22 08:34:09 2017
From: report at bugs.python.org (Jonathon Vandezande)
Date: Thu, 22 Jun 2017 12:34:09 +0000
Subject: [docs] [issue30733] Typo in Document What's New: Calendar
Message-ID: <1498134849.55.0.432143845642.issue30733@psf.upfronthosting.co.za>


New submission from Jonathon Vandezande:

Says:
The HTMLCalendar has added new class attribute which ease the customisation the CSS classes in the produced HTML calendar. (Contributed by Oz Tiram in bpo-30095.)

Should say:
The HTMLCalendar has added new class attributes which ease the customisation of the CSS classes in the produced HTML calendar. (Contributed by Oz Tiram in bpo-30095.)


Summary of changes:
'attribute' should be plural
Missing an 'of' in front of 'the CSS classes', could also substitute 'of' for 'the'

----------
assignee: docs at python
components: Documentation
messages: 296625
nosy: Jonathon Vandezande, docs at python
priority: normal
severity: normal
status: open
title: Typo in Document What's New: Calendar
type: enhancement
versions: Python 3.7

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

From report at bugs.python.org  Thu Jun 22 09:06:54 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 22 Jun 2017 13:06:54 +0000
Subject: [docs] [issue30733] Typo in Document What's New: Calendar
In-Reply-To: <1498134849.55.0.432143845642.issue30733@psf.upfronthosting.co.za>
Message-ID: <1498136814.52.0.461845909494.issue30733@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/issue30733>
_______________________________________

From report at bugs.python.org  Thu Jun 22 09:14:59 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 22 Jun 2017 13:14:59 +0000
Subject: [docs] [issue30619] typing.Union doc incoherence in case a class
 and its subclass are present
In-Reply-To: <1497055090.79.0.980256634301.issue30619@psf.upfronthosting.co.za>
Message-ID: <1498137299.7.0.570786967179.issue30619@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 6580c19bbbe7bc9bc0884699afd69184f523b32e by Mariatta (khyox) in branch 'master':
bpo-30619: Clarify typing.Union documentation (GH-2326)
https://github.com/python/cpython/commit/6580c19bbbe7bc9bc0884699afd69184f523b32e


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

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

From report at bugs.python.org  Thu Jun 22 09:16:47 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 22 Jun 2017 13:16:47 +0000
Subject: [docs] [issue30619] typing.Union doc incoherence in case a class
 and its subclass are present
In-Reply-To: <1497055090.79.0.980256634301.issue30619@psf.upfronthosting.co.za>
Message-ID: <1498137407.04.0.386438911865.issue30619@psf.upfronthosting.co.za>


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


----------
stage:  -> backport needed

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

From report at bugs.python.org  Thu Jun 22 13:19:12 2017
From: report at bugs.python.org (Hiba)
Date: Thu, 22 Jun 2017 17:19:12 +0000
Subject: [docs] [issue30738] __next__() method in iterators 9.9
Message-ID: <1498151952.1.0.340362281065.issue30738@psf.upfronthosting.co.za>


New submission from Hiba:

class Reverse:
    """Iterator for looping over a sequence backwards."""
    def __init__(self, data):
        self.data = data
        self.index = len(data)

    def __iter__(self):
        return self

    def next(self):
        if self.index == 0:
            raise StopIteration
        self.index = self.index - 1
        return self.data[self.index]


*********************************************
The next() method in the above code snippet(from 9.9 Iterators section in Tutorial is not correctly overridden. It's missing the underscores.

----------
assignee: docs at python
components: Documentation
messages: 296646
nosy: docs at python, hiba
priority: normal
severity: normal
status: open
title: __next__() method in iterators 9.9
versions: Python 2.7

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

From report at bugs.python.org  Thu Jun 22 13:31:46 2017
From: report at bugs.python.org (Eryk Sun)
Date: Thu, 22 Jun 2017 17:31:46 +0000
Subject: [docs] [issue30738] __next__() method in iterators 9.9
In-Reply-To: <1498151952.1.0.340362281065.issue30738@psf.upfronthosting.co.za>
Message-ID: <1498152706.29.0.00348310413188.issue30738@psf.upfronthosting.co.za>


Eryk Sun added the comment:

Did you try the example in Python 2? Did you click on the "next" link in the preceding paragraph? Please read the following:

https://docs.python.org/2/library/stdtypes.html#iterator.next

    iterator.next()
       Return the next item from the container....

In Python 3, this method was renamed `__next__`.

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

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

From report at bugs.python.org  Thu Jun 22 21:43:42 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 23 Jun 2017 01:43:42 +0000
Subject: [docs] [issue30619] typing.Union doc incoherence in case a class
 and its subclass are present
In-Reply-To: <1497055090.79.0.980256634301.issue30619@psf.upfronthosting.co.za>
Message-ID: <1498182222.72.0.895513456257.issue30619@psf.upfronthosting.co.za>


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


----------
pull_requests: +2380

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

From report at bugs.python.org  Thu Jun 22 21:53:00 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 23 Jun 2017 01:53:00 +0000
Subject: [docs] [issue30619] typing.Union doc incoherence in case a class
 and its subclass are present
In-Reply-To: <1497055090.79.0.980256634301.issue30619@psf.upfronthosting.co.za>
Message-ID: <1498182780.24.0.671738405292.issue30619@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 8baf78b98f3acd76e51a4381542ff1612911b18f by Mariatta in branch '3.6':
[3.6] bpo-30619: Clarify typing.Union documentation (GH-2326) (GH-2337)
https://github.com/python/cpython/commit/8baf78b98f3acd76e51a4381542ff1612911b18f


----------

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

From report at bugs.python.org  Thu Jun 22 22:12:50 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 23 Jun 2017 02:12:50 +0000
Subject: [docs] [issue30619] typing.Union doc incoherence in case a class
 and its subclass are present
In-Reply-To: <1497055090.79.0.980256634301.issue30619@psf.upfronthosting.co.za>
Message-ID: <1498183970.1.0.39584615351.issue30619@psf.upfronthosting.co.za>


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


----------
pull_requests: +2381

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

From report at bugs.python.org  Thu Jun 22 22:18:07 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 23 Jun 2017 02:18:07 +0000
Subject: [docs] [issue30619] typing.Union doc incoherence in case a class
 and its subclass are present
In-Reply-To: <1497055090.79.0.980256634301.issue30619@psf.upfronthosting.co.za>
Message-ID: <1498184287.77.0.604628566602.issue30619@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset ce1bd6ac7ffaf396157a9ceb55b281a3b196323f by Mariatta in branch '3.5':
[3.5] bpo-30619: Clarify typing.Union documentation (GH-2326) (GH-2338)
https://github.com/python/cpython/commit/ce1bd6ac7ffaf396157a9ceb55b281a3b196323f


----------

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

From report at bugs.python.org  Thu Jun 22 22:18:36 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 23 Jun 2017 02:18:36 +0000
Subject: [docs] [issue30619] typing.Union doc incoherence in case a class
 and its subclass are present
In-Reply-To: <1497055090.79.0.980256634301.issue30619@psf.upfronthosting.co.za>
Message-ID: <1498184316.65.0.201618738027.issue30619@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Fixed and backported to 3.5 and 3.6.
Thanks!

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

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

From report at bugs.python.org  Thu Jun 22 23:45:46 2017
From: report at bugs.python.org (AnqurVanillapy)
Date: Fri, 23 Jun 2017 03:45:46 +0000
Subject: [docs] [issue30709] Bad getter from Descriptor#Properties example
In-Reply-To: <1497957198.83.0.108909072277.issue30709@psf.upfronthosting.co.za>
Message-ID: <1498189546.93.0.975203898596.issue30709@psf.upfronthosting.co.za>


Changes by AnqurVanillapy <anqurvanillapy at gmail.com>:


----------
pull_requests: +2382

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

From report at bugs.python.org  Thu Jun 22 23:46:41 2017
From: report at bugs.python.org (AnqurVanillapy)
Date: Fri, 23 Jun 2017 03:46:41 +0000
Subject: [docs] [issue30709] Bad getter from Descriptor#Properties example
In-Reply-To: <1497957198.83.0.108909072277.issue30709@psf.upfronthosting.co.za>
Message-ID: <1498189601.86.0.895917147404.issue30709@psf.upfronthosting.co.za>


AnqurVanillapy added the comment:

Previous conversation here: https://github.com/python/cpython/pull/2288

----------

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

From report at bugs.python.org  Thu Jun 22 23:54:37 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 23 Jun 2017 03:54:37 +0000
Subject: [docs] [issue30709] Bad getter from Descriptor#Properties example
In-Reply-To: <1497957198.83.0.108909072277.issue30709@psf.upfronthosting.co.za>
Message-ID: <1498190077.67.0.947780113568.issue30709@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset b066edfb1b268e90ea11f45dd1827f46d7ceec88 by Mariatta (_ = NaN) in branch 'master':
bpo-30709: Improve code example in Descriptor HowTo doc (GH-2339)
https://github.com/python/cpython/commit/b066edfb1b268e90ea11f45dd1827f46d7ceec88


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

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

From report at bugs.python.org  Fri Jun 23 00:10:01 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 23 Jun 2017 04:10:01 +0000
Subject: [docs] [issue30709] Bad getter from Descriptor#Properties example
In-Reply-To: <1497957198.83.0.108909072277.issue30709@psf.upfronthosting.co.za>
Message-ID: <1498191001.53.0.629914584645.issue30709@psf.upfronthosting.co.za>


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


----------
pull_requests: +2384

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

From report at bugs.python.org  Fri Jun 23 00:10:09 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 23 Jun 2017 04:10:09 +0000
Subject: [docs] [issue30709] Bad getter from Descriptor#Properties example
In-Reply-To: <1497957198.83.0.108909072277.issue30709@psf.upfronthosting.co.za>
Message-ID: <1498191009.43.0.499839031639.issue30709@psf.upfronthosting.co.za>


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


----------
pull_requests: +2385

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

From report at bugs.python.org  Fri Jun 23 00:10:17 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 23 Jun 2017 04:10:17 +0000
Subject: [docs] [issue30709] Bad getter from Descriptor#Properties example
In-Reply-To: <1497957198.83.0.108909072277.issue30709@psf.upfronthosting.co.za>
Message-ID: <1498191017.39.0.333723515689.issue30709@psf.upfronthosting.co.za>


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


----------
pull_requests: +2386

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

From report at bugs.python.org  Fri Jun 23 00:24:26 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 23 Jun 2017 04:24:26 +0000
Subject: [docs] [issue30709] Bad getter from Descriptor#Properties example
In-Reply-To: <1497957198.83.0.108909072277.issue30709@psf.upfronthosting.co.za>
Message-ID: <1498191866.01.0.739926497136.issue30709@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 508267437cc66fdadc12fb19fb2958c452b8a26f by Mariatta in branch '2.7':
[2.7] bpo-30709: Improve code example in Descriptor HowTo doc (GH-2339) (GH-2340)
https://github.com/python/cpython/commit/508267437cc66fdadc12fb19fb2958c452b8a26f


----------

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

From report at bugs.python.org  Fri Jun 23 00:24:35 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 23 Jun 2017 04:24:35 +0000
Subject: [docs] [issue30709] Bad getter from Descriptor#Properties example
In-Reply-To: <1497957198.83.0.108909072277.issue30709@psf.upfronthosting.co.za>
Message-ID: <1498191875.24.0.65563149706.issue30709@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 8aa15ba884b14c1cf65d4c1a4c5abc4253f5c9ed by Mariatta in branch '3.5':
[3.5] bpo-30709: Improve code example in Descriptor HowTo doc (GH-2339) (GH-2341)
https://github.com/python/cpython/commit/8aa15ba884b14c1cf65d4c1a4c5abc4253f5c9ed


----------

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

From report at bugs.python.org  Fri Jun 23 00:24:46 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 23 Jun 2017 04:24:46 +0000
Subject: [docs] [issue30709] Bad getter from Descriptor#Properties example
In-Reply-To: <1497957198.83.0.108909072277.issue30709@psf.upfronthosting.co.za>
Message-ID: <1498191885.99.0.55191570325.issue30709@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset d79ac2c2468f072653ed9096cd33f89acb6ff5bb by Mariatta in branch '3.6':
[3.6] bpo-30709: Improve code example in Descriptor HowTo doc (GH-2339) (GH-2342)
https://github.com/python/cpython/commit/d79ac2c2468f072653ed9096cd33f89acb6ff5bb


----------

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

From report at bugs.python.org  Fri Jun 23 00:25:38 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 23 Jun 2017 04:25:38 +0000
Subject: [docs] [issue30709] Bad getter from Descriptor#Properties example
In-Reply-To: <1497957198.83.0.108909072277.issue30709@psf.upfronthosting.co.za>
Message-ID: <1498191938.21.0.247011425471.issue30709@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Jun 23 09:11:14 2017
From: report at bugs.python.org (STINNER Victor)
Date: Fri, 23 Jun 2017 13:11:14 +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: <1498223474.35.0.1028750329.issue21071@psf.upfronthosting.co.za>


STINNER Victor added the comment:


New changeset f87b85f80853c580b1c8bf78a51b0e9a25f6e1a7 by Victor Stinner in branch 'master':
bpo-21071: struct.Struct.format type is now str (#845)
https://github.com/python/cpython/commit/f87b85f80853c580b1c8bf78a51b0e9a25f6e1a7


----------

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

From report at bugs.python.org  Fri Jun 23 09:14:02 2017
From: report at bugs.python.org (STINNER Victor)
Date: Fri, 23 Jun 2017 13:14:02 +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: <1498223641.97.0.572117270861.issue21071@psf.upfronthosting.co.za>


STINNER Victor added the comment:

Ok, I changed struct.Struct.format type to str (Unicode string).

If someone wants to modify the C code to use a PyUnicodeObject rather than a char*, feel free to propose a further change.

Since the initial issue is fixed, I now close the issue.

Thank you all for your feedback and reviews ;-)

----------
resolution:  -> fixed
stage: needs patch -> resolved
status: open -> closed
versions: +Python 3.7 -Python 3.4, Python 3.5

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

From report at bugs.python.org  Fri Jun 23 17:57:36 2017
From: report at bugs.python.org (Alessandro Piccione)
Date: Fri, 23 Jun 2017 21:57:36 +0000
Subject: [docs] [issue30743] unittest discover does not mention module file
 must be named with "test_" prefix
Message-ID: <1498255056.87.0.611217256865.issue30743@psf.upfronthosting.co.za>


New submission from Alessandro Piccione:

1. execute "python -m unittest"
2. Result: 0 test found
3. Change file name from "aaaTest.py" to "test_aaa.py" 
4. execute "python -m unittest"
3. Result: Ran 1 tests in 000.0s

Module file MUST be named using the prefiux "test_".

The page "https://docs.python.org/3/library/unittest.html"
does not mention this MANDATORY rule.

I went to this conclusion because I readed the documentation without find any point about the naming convention of modules and than looking for this specific rule searching "test_" and "test_ " without any result.

Regards,

Alessandro

----------
assignee: docs at python
components: Documentation
messages: 296740
nosy: alex.75, docs at python
priority: normal
severity: normal
status: open
title: unittest discover does not mention module file must be named with "test_" prefix
versions: Python 3.6

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

From report at bugs.python.org  Fri Jun 23 18:05:22 2017
From: report at bugs.python.org (Zachary Ware)
Date: Fri, 23 Jun 2017 22:05:22 +0000
Subject: [docs] [issue30743] unittest discover does not mention module file
 must be named with "test_" prefix
In-Reply-To: <1498255056.87.0.611217256865.issue30743@psf.upfronthosting.co.za>
Message-ID: <1498255522.18.0.262494865091.issue30743@psf.upfronthosting.co.za>


Zachary Ware added the comment:

Does this cover what you're looking for?

https://docs.python.org/3/library/unittest.html#cmdoption-unittest-discover-p

----------
nosy: +zach.ware

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

From report at bugs.python.org  Fri Jun 23 18:17:11 2017
From: report at bugs.python.org (Alessandro Piccione)
Date: Fri, 23 Jun 2017 22:17:11 +0000
Subject: [docs] [issue30743] unittest discover does not mention module file
 must be named with "test_" prefix
In-Reply-To: <1498255056.87.0.611217256865.issue30743@psf.upfronthosting.co.za>
Message-ID: <1498256231.08.0.706135798582.issue30743@psf.upfronthosting.co.za>


Alessandro Piccione added the comment:

If you refer to the -p ("pattern" parameter) I think not.
I have my module named aaaTest.py.
I is is not mentioned that discover look for modules named "test_" for which reason I have to use a pattern?

If you refer to -s ("start-directory" parameter) same thing: for which reason I have to assume my aaaTest.py module is not recognized as a test?

----------

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

From report at bugs.python.org  Sat Jun 24 01:48:27 2017
From: report at bugs.python.org (Matthias Bussonnier)
Date: Sat, 24 Jun 2017 05:48:27 +0000
Subject: [docs] [issue13821] misleading return from isidentifier
In-Reply-To: <1326934459.59.0.614334427327.issue13821@psf.upfronthosting.co.za>
Message-ID: <1498283307.25.0.505070197469.issue13821@psf.upfronthosting.co.za>


Matthias Bussonnier added the comment:

I have been bitten by that as well. I think the doc should mention to verify that the given string is normalized, not that it **should** be normalized.

Agreed that If isidentifier could also possibly grow a `allow_non_nfkc=True` default parameter that would allow to deactivate internal normalisation and return False/Raise on Non NKFC that would be great. 

I'm also interested on having an option on ast.parse or compile to not normalize to at least be able to lint wether users are using non NFKC form, but that's another issue.

I'll see if I can come up with ? at least ? a documentation patch.

----------
nosy: +mbussonn

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

From cameronleigh1412 at gmail.com  Fri Jun 23 04:51:48 2017
From: cameronleigh1412 at gmail.com (Bok)
Date: Fri, 23 Jun 2017 09:51:48 +0100
Subject: [docs] Python Error - Validation - Format Checking
Message-ID: <CANPHvf3raHDUHw2PqsQ+iLXyPX0Qd6pxCSKZDRgOVrwzy12EPg@mail.gmail.com>

We are in the middle of completing format checks in a program we are
writing, it keeps giving us an error. We do not understand why. I hope you
can explain why or help us.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170623/b0fda899/attachment.html>
-------------- next part --------------
import re
print("We are collecting some data to see if you qualify for our job ")
age=input("What is your age? ")
if len(age)== 2:
    print("Your age is 2 digits long")
    if int(age) >=18 and int(age)<=50:
        print("Your age is between 18-50")
        email=input("What is your email: ")
        pattern="^[A-Za-Z0-9]+\@[A-Za-z0-9]+\.[A-Za-z0-9]+$"
        emailmatch=re.match(pattern, email)
        if emailmatch:
            print("You entered a valid email")
            name=input("What is your full name: ")
            pattern1="^[A-Za-z]$"
            namematch=re.match(pattern1, name)
            if namematch:
                print("You entered your name")
                if name.isupper()==True:
                    print("You have a capital letter in your name")
else:
    print("Error")

From christopher.stokely at gmail.com  Thu Jun 22 01:59:42 2017
From: christopher.stokely at gmail.com (Christopher Stokely)
Date: Thu, 22 Jun 2017 00:59:42 -0500
Subject: [docs] Website Suggestion
Message-ID: <CAHcUWyvY_T7G0jMPv40cCH=JEqSRjo2D2WQo=QXPgzeWXgJ4iA@mail.gmail.com>

I am visually impaired.  I'm trying to learn Python from your documentation
website. Despite increasing the font size significantly via the handicap
feature on my tablet reader, the code examples do not increase their size.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170622/ddb4d088/attachment.html>

From gilber.cj at gmail.com  Sat Jun 24 16:19:28 2017
From: gilber.cj at gmail.com (gilberto junior)
Date: Sat, 24 Jun 2017 17:19:28 -0300
Subject: [docs] importar dados do fortran para o python
Message-ID: <CAMmzPAcbaYa6uU_ZSOXdFHOn7dWkA8b03xWiPNt+CSbK=f_tzg@mail.gmail.com>

ol?, li o artigo de voc?s sobre python. E
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170624/1b9ae920/attachment.html>

From gilber.cj at gmail.com  Sat Jun 24 16:21:32 2017
From: gilber.cj at gmail.com (gilberto junior)
Date: Sat, 24 Jun 2017 17:21:32 -0300
Subject: [docs] importar dados do fortran para o python
Message-ID: <CAMmzPAdAQmU=8G-6cfKYGTq=6XFvgP_nc_sVwcFUgvaOiD1jbQ@mail.gmail.com>

ol?, li o artigo de voc?s sobre python. E gostaria de saber se existe algum
materia que possam me fornecer que fale sobre como importar dados do
fortran para o python e de como manipular os dados de fortran no python.

att
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170624/cdedc6b3/attachment.html>

From juriahn817 at gmail.com  Tue Jun 20 16:48:17 2017
From: juriahn817 at gmail.com (Juri Ahn)
Date: Tue, 20 Jun 2017 15:48:17 -0500
Subject: [docs] Python Extension Bug
Message-ID: <CAL9WY6puxRq31R4E9WA5A3NEe9TjzVhnKLMjMTUAhOgasK2nCw@mail.gmail.com>

Hey guys,
(Great extension, by the way) I'm not sure if this is just a problem I am
having with Google chrome, or if this is a prevalent issue. Whenever I type
in "py + space" the search bar DOES change to py-search. However, when I
hit 'enter' after typing in "loops" for example, it does not run, but keep
me on the same page. I tried uninstalling/reinstalling, and same issue.
Just a heads up, thanks!
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170620/30323273/attachment.html>

From livia.juliao at ccc.ufcg.edu.br  Sat Jun 24 22:56:16 2017
From: livia.juliao at ccc.ufcg.edu.br (Livia Cavalcanti Bandeira Juliao)
Date: Sat, 24 Jun 2017 23:56:16 -0300
Subject: [docs] =?utf-8?b?VHJhZHXDp8Ojbw==?=
Message-ID: <CAJyYS8iXfcAZUw31OstSGmK-rng9pbKGK19tumwTCrS+_jXo2A@mail.gmail.com>

Ol?,

Sou uma amante de Python e adoraria ser mais ativa na comunidade. Gostaria
de saber se poderia ajudar na tradu??o da documenta??o.

Desde j?, obrigada!!
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170624/4403f3b9/attachment.html>

From report at bugs.python.org  Mon Jun 26 00:26:08 2017
From: report at bugs.python.org (Denis Akhiyarov)
Date: Mon, 26 Jun 2017 04:26:08 +0000
Subject: [docs] [issue30757] pyinstaller can be added to docs,
 py2exe ref can be updated
Message-ID: <1498451168.27.0.593036349197.issue30757@psf.upfronthosting.co.za>


New submission from Denis Akhiyarov:

https://github.com/python/cpython/pull/1158

It is not clear why this FAQ item is written in addition to this document:

https://github.com/python/cpython/blob/master/Doc/faq/windows.rst#how-do-i-make-python-scripts-executable

https://github.com/python/cpython/blob/master/Doc/faq/programming.rst#how-can-i-create-a-stand-alone-binary-from-a-python-script

----------
assignee: docs at python
components: Documentation
messages: 296844
nosy: denfromufa, docs at python
priority: normal
severity: normal
status: open
title: pyinstaller can be added to docs, py2exe ref can be updated
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/issue30757>
_______________________________________

From report at bugs.python.org  Mon Jun 26 00:28:11 2017
From: report at bugs.python.org (Denis Akhiyarov)
Date: Mon, 26 Jun 2017 04:28:11 +0000
Subject: [docs] [issue30757] pyinstaller can be added to docs,
 py2exe ref can be updated
In-Reply-To: <1498451168.27.0.593036349197.issue30757@psf.upfronthosting.co.za>
Message-ID: <1498451291.23.0.215608341634.issue30757@psf.upfronthosting.co.za>


Changes by Denis Akhiyarov <denis.akhiyarov at gmail.com>:


----------
pull_requests: +2443

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

From report at bugs.python.org  Mon Jun 26 12:24:38 2017
From: report at bugs.python.org (=?utf-8?q?Walter_D=C3=B6rwald?=)
Date: Mon, 26 Jun 2017 16:24:38 +0000
Subject: [docs] [issue30733] Typo in Document What's New: Calendar
In-Reply-To: <1498134849.55.0.432143845642.issue30733@psf.upfronthosting.co.za>
Message-ID: <1498494278.6.0.60566786656.issue30733@psf.upfronthosting.co.za>


Changes by Walter D?rwald <walter at livinglogic.de>:


----------
pull_requests: +2463

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

From report at bugs.python.org  Mon Jun 26 12:31:54 2017
From: report at bugs.python.org (=?utf-8?q?Walter_D=C3=B6rwald?=)
Date: Mon, 26 Jun 2017 16:31:54 +0000
Subject: [docs] [issue30733] Typo in Document What's New: Calendar
In-Reply-To: <1498134849.55.0.432143845642.issue30733@psf.upfronthosting.co.za>
Message-ID: <1498494714.5.0.447917746326.issue30733@psf.upfronthosting.co.za>


Walter D?rwald added the comment:


New changeset f5c58c781aa0bb296885baf62f4f39100f2cd93d by Walter D?rwald in branch 'master':
bpo-30733: Fix typos in "What's New" entry (GH-2414)
https://github.com/python/cpython/commit/f5c58c781aa0bb296885baf62f4f39100f2cd93d


----------
nosy: +doerwalter

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

From report at bugs.python.org  Mon Jun 26 12:35:40 2017
From: report at bugs.python.org (=?utf-8?q?Walter_D=C3=B6rwald?=)
Date: Mon, 26 Jun 2017 16:35:40 +0000
Subject: [docs] [issue30733] Typo in Document What's New: Calendar
In-Reply-To: <1498134849.55.0.432143845642.issue30733@psf.upfronthosting.co.za>
Message-ID: <1498494940.55.0.886041337883.issue30733@psf.upfronthosting.co.za>


Walter D?rwald added the comment:

Should be fixed now. Thanks for noticing it.

----------
resolution:  -> fixed

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

From report at bugs.python.org  Mon Jun 26 12:35:47 2017
From: report at bugs.python.org (=?utf-8?q?Walter_D=C3=B6rwald?=)
Date: Mon, 26 Jun 2017 16:35:47 +0000
Subject: [docs] [issue30733] Typo in Document What's New: Calendar
In-Reply-To: <1498134849.55.0.432143845642.issue30733@psf.upfronthosting.co.za>
Message-ID: <1498494947.21.0.69531248211.issue30733@psf.upfronthosting.co.za>


Changes by Walter D?rwald <walter at livinglogic.de>:


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

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

From report at bugs.python.org  Tue Jun 27 10:23:18 2017
From: report at bugs.python.org (tom kronmiller)
Date: Tue, 27 Jun 2017 14:23:18 +0000
Subject: [docs] [issue30787] Please add a comprehensive index of decorators
 to the documentation.
Message-ID: <1498573398.64.0.663772847899.issue30787@psf.upfronthosting.co.za>


New submission from tom kronmiller:

It is difficult to learn what decorators there are because there is no single index which lists all of them (at least, I have been unable to find one).  Instead, one must stumble across them while reading library module documentation.  An index listing the decorators with a short description would be really helpful (to me, at least).

Thanks.

----------
assignee: docs at python
components: Documentation
messages: 297039
nosy: docs at python, tom kronmiller
priority: normal
severity: normal
status: open
title: Please add a comprehensive index of decorators to the documentation.
type: enhancement
versions: Python 3.6, Python 3.7

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

From report at bugs.python.org  Tue Jun 27 16:01:56 2017
From: report at bugs.python.org (Zachary Ware)
Date: Tue, 27 Jun 2017 20:01:56 +0000
Subject: [docs] [issue30743] unittest discover does not mention module file
 must be named with "test_" prefix
In-Reply-To: <1498255056.87.0.611217256865.issue30743@psf.upfronthosting.co.za>
Message-ID: <1498593716.59.0.655641204189.issue30743@psf.upfronthosting.co.za>


Zachary Ware added the comment:

This all seems to be covered in https://docs.python.org/3/library/unittest.html#test-discovery

$ cat aaaTest.py 
import unittest


class TestAAA(unittest.TestCase):

    def test_something(self):
        self.assertTrue(True)


if __name__ == '__main__':
    unittest.main()
$ python3 -m unittest discover -v -p "*Test.py"
test_something (aaaTest.TestAAA) ... ok

----------------------------------------------------------------------
Ran 1 test in 0.000s

OK



As the `--pattern` documentation says, the default pattern is "test*.py" which does not match "aaaTest.py".

----------

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

From report at bugs.python.org  Tue Jun 27 16:35:24 2017
From: report at bugs.python.org (Alessandro Piccione)
Date: Tue, 27 Jun 2017 20:35:24 +0000
Subject: [docs] [issue30743] unittest discover does not mention module file
 must be named with "test_" prefix
In-Reply-To: <1498255056.87.0.611217256865.issue30743@psf.upfronthosting.co.za>
Message-ID: <1498595724.54.0.0556388458428.issue30743@psf.upfronthosting.co.za>


Alessandro Piccione added the comment:

You are right.

As the `--pattern` documentation says, the default pattern is "test*.py" which does not match "aaaTest.py".

I had looking for the wrong pattern.

Thanks,

Alex

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

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

From report at bugs.python.org  Tue Jun 27 20:55:49 2017
From: report at bugs.python.org (STINNER Victor)
Date: Wed, 28 Jun 2017 00:55:49 +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: <1498611348.95.0.656556962328.issue29933@psf.upfronthosting.co.za>


STINNER Victor added the comment:

Oh, thanks for the documentation! Now the change should just be backported to other branches.

----------

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

From report at bugs.python.org  Tue Jun 27 21:10:40 2017
From: report at bugs.python.org (STINNER Victor)
Date: Wed, 28 Jun 2017 01:10:40 +0000
Subject: [docs] [issue26506] hex() documentation: mention "%x" % int
In-Reply-To: <1457372823.56.0.270827849914.issue26506@psf.upfronthosting.co.za>
Message-ID: <1498612240.35.0.718027120775.issue26506@psf.upfronthosting.co.za>


STINNER Victor added the comment:

Can someone pick the last patch and convert it to a pull request? CPython moved to GitHub in the meanwhile! See http://docs.python.org/devguide/ ;-)

----------

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

From report at bugs.python.org  Tue Jun 27 21:10:55 2017
From: report at bugs.python.org (STINNER Victor)
Date: Wed, 28 Jun 2017 01:10:55 +0000
Subject: [docs] [issue26506] [EASY] hex() documentation: mention "%x" % int
In-Reply-To: <1457372823.56.0.270827849914.issue26506@psf.upfronthosting.co.za>
Message-ID: <1498612255.88.0.551997221731.issue26506@psf.upfronthosting.co.za>


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


----------
keywords: +easy
title: hex() documentation: mention "%x" % int -> [EASY] hex() documentation: mention "%x" % int

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

From report at bugs.python.org  Wed Jun 28 12:31:08 2017
From: report at bugs.python.org (Sharan Yalburgi)
Date: Wed, 28 Jun 2017 16:31:08 +0000
Subject: [docs] [issue26506] [EASY] hex() documentation: mention "%x" % int
In-Reply-To: <1457372823.56.0.270827849914.issue26506@psf.upfronthosting.co.za>
Message-ID: <1498667468.21.0.16039017033.issue26506@psf.upfronthosting.co.za>


Sharan Yalburgi added the comment:

Hey, I am new to Open Source, can I work on this?

----------
nosy: +Sharan Yalburgi

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

From report at bugs.python.org  Wed Jun 28 12:34:29 2017
From: report at bugs.python.org (STINNER Victor)
Date: Wed, 28 Jun 2017 16:34:29 +0000
Subject: [docs] [issue26506] [EASY] hex() documentation: mention "%x" % int
In-Reply-To: <1457372823.56.0.270827849914.issue26506@psf.upfronthosting.co.za>
Message-ID: <1498667669.17.0.238838174121.issue26506@psf.upfronthosting.co.za>


STINNER Victor added the comment:

> Hey, I am new to Open Source, can I work on this?

Hi, did you read http://docs.python.org/devguide/ ? IMHO its a good start. You can also join the https://www.python.org/dev/core-mentorship/ group to get help!

----------

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

From report at bugs.python.org  Wed Jun 28 12:54:36 2017
From: report at bugs.python.org (Sharan Yalburgi)
Date: Wed, 28 Jun 2017 16:54:36 +0000
Subject: [docs] [issue26506] [EASY] hex() documentation: mention "%x" % int
In-Reply-To: <1457372823.56.0.270827849914.issue26506@psf.upfronthosting.co.za>
Message-ID: <1498668876.34.0.0879813715451.issue26506@psf.upfronthosting.co.za>


Changes by Sharan Yalburgi <sharanyalburgi at gmail.com>:


----------
pull_requests: +2533

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

From report at bugs.python.org  Wed Jun 28 13:01:56 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 28 Jun 2017 17:01:56 +0000
Subject: [docs] [issue26506] [EASY] hex() documentation: mention "%x" % int
In-Reply-To: <1457372823.56.0.270827849914.issue26506@psf.upfronthosting.co.za>
Message-ID: <1498669316.45.0.871942660512.issue26506@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

When uploading patch from another person, please include "Original patch by <original author>" in the PR, and the commit message.
Thanks.

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

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

From report at bugs.python.org  Wed Jun 28 13:05:25 2017
From: report at bugs.python.org (Sharan Yalburgi)
Date: Wed, 28 Jun 2017 17:05:25 +0000
Subject: [docs] [issue26506] [EASY] hex() documentation: mention "%x" % int
In-Reply-To: <1457372823.56.0.270827849914.issue26506@psf.upfronthosting.co.za>
Message-ID: <1498669525.0.0.339681489037.issue26506@psf.upfronthosting.co.za>


Sharan Yalburgi added the comment:

> Hi, did you read http://docs.python.org/devguide/ ? IMHO its a good start. You can also join the https://www.python.org/dev/core-mentorship/ group to get help!

Yes I did. Thank you. I have made a PR. I says I haven't signed CLA yet. I am doing that right now.

> When uploading patch from another person, please include "Original patch by <original author>" in the PR, and the commit message.

Will do that thank you.

----------

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

From report at bugs.python.org  Wed Jun 28 13:53:25 2017
From: report at bugs.python.org (Brett Cannon)
Date: Wed, 28 Jun 2017 17:53:25 +0000
Subject: [docs] [issue30787] Please add a comprehensive index of decorators
 to the documentation.
In-Reply-To: <1498573398.64.0.663772847899.issue30787@psf.upfronthosting.co.za>
Message-ID: <1498672405.9.0.41870081021.issue30787@psf.upfronthosting.co.za>


Brett Cannon added the comment:

Why do you want an index of *just* decorators? The documentation is structured so you look for the module that probably contains a solution to your problem and then you see what the module may have (which may have a solution that isn't a decorator). Jumping straight to a list of just decorators means you would miss out on any other solution that happens to not be a decorator.

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

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

From report at bugs.python.org  Wed Jun 28 22:14:46 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Thu, 29 Jun 2017 02:14:46 +0000
Subject: [docs] [issue30787] Please add a comprehensive index of decorators
 to the documentation.
In-Reply-To: <1498573398.64.0.663772847899.issue30787@psf.upfronthosting.co.za>
Message-ID: <1498702486.85.0.616454075455.issue30787@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

This request doesn't make sense to me.  Decorators are an implementation technique and not really a topic unto themselves.

FWIW, Guido recently rejected a request to create a listing of all the command line tools.  Python docs are primarily organized by modules of related tools rather than by their implementation technique.

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

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

From report at bugs.python.org  Wed Jun 28 22:32:34 2017
From: report at bugs.python.org (James Lin)
Date: Thu, 29 Jun 2017 02:32:34 +0000
Subject: [docs] [issue30798] Document that subprocess.Popen does not set PWD
Message-ID: <1498703554.38.0.302571639781.issue30798@psf.upfronthosting.co.za>


New submission from James Lin:

Even though http://bugs.python.org/issue4057 was rejected (which I think is fair), I think it would be worth mentioning something about PWD in the Python docs for subprocess.Popen's cwd parameter (and possibly for os.chdir):

1. It's pretty common for people to use Python to execute other things.
2. I don't think it's that uncommon to come across binaries/scripts that directly read PWD instead of calling getcwd() or equivalent.
3. For people who encounter this problem for the first time, it can be really puzzling.

My suggestion would be to add something like:

   Note: Some programs might expect that the current directory is specified in a PWD environment variable.  Callers should explicitly set it themselves when invoking such programs.

or even just:

   Note: Callers are responsible for setting a PWD environment variable if necessary.

----------
assignee: docs at python
components: Documentation
messages: 297244
nosy: docs at python, jamesdlin
priority: normal
severity: normal
status: open
title: Document that subprocess.Popen does not set PWD
type: enhancement
versions: Python 3.6

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

From report at bugs.python.org  Thu Jun 29 09:36:18 2017
From: report at bugs.python.org (Peter Thomassen)
Date: Thu, 29 Jun 2017 13:36:18 +0000
Subject: [docs] [issue30803] Truth value of sets not properly documented
Message-ID: <1498743378.1.0.0570911503542.issue30803@psf.upfronthosting.co.za>


New submission from Peter Thomassen:

The truth value of sets is not properly documented, in particular regarding whether an empty set is considered false or not.

Ignoring primitive (such as numerals) as well as user-defined types, https://docs.python.org/3/library/stdtypes.html#truth says:

> The following values are considered false:
> 
> - [...]
> - any empty sequence, for example, '', (), [].
> - any empty mapping, for example, {}.
> - [...]
> 
> All other values are considered true

According to https://docs.python.org/3/library/stdtypes.html#sequence-types-list-tuple-range, a set is not a sequence (it is unordered, its elements do not have indices, etc.):

> There are three basic sequence types: lists, tuples, and range objects.

And, according to https://docs.python.org/3/library/stdtypes.html#mapping-types-dict,

> There is currently only one standard mapping type, the dictionary.

So, as per the documentation, the set type is not a type that can ever be False. However, when I try, bool(set()) evaluates to False.

When I asked this on Stack Overflow, someone checked in the CPython code and judged that this is most likely a mere documentation issue: https://stackoverflow.com/a/44813565/6867099

----------
assignee: docs at python
components: Documentation
messages: 297268
nosy: docs at python, thomassen
priority: normal
severity: normal
status: open
title: Truth value of sets not properly documented
type: enhancement
versions: Python 3.5, Python 3.6, Python 3.7

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

From report at bugs.python.org  Thu Jun 29 10:21:06 2017
From: report at bugs.python.org (R. David Murray)
Date: Thu, 29 Jun 2017 14:21:06 +0000
Subject: [docs] [issue13821] misleading return from isidentifier
In-Reply-To: <1326934459.59.0.614334427327.issue13821@psf.upfronthosting.co.za>
Message-ID: <1498746066.3.0.805066782601.issue13821@psf.upfronthosting.co.za>


R. David Murray added the comment:

IMO allow_non_nfkc=True that just returns False would be a bad idea, since as Benjamin points out it *is* a valid identifier, it's just not normalized (yet).  Raising might work, that way you could tell the difference, but that would be a weird API for such a check function.  Regardless, we should probably keep this issue to a doc patch, and open a new issue for any proposed enhancement request.  

And you probably want to discuss it on python-ideas first, since the underlying issue is a bit complex and the solution non-obvious, with possible knock-on effects.  (Or maybe I'm wrong and the consensus will be that returning False with that flag would be fine.)

----------
nosy: +r.david.murray

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

From report at bugs.python.org  Thu Jun 29 10:38:49 2017
From: report at bugs.python.org (STINNER Victor)
Date: Thu, 29 Jun 2017 14:38:49 +0000
Subject: [docs] [issue13821] misleading return from isidentifier
In-Reply-To: <1326934459.59.0.614334427327.issue13821@psf.upfronthosting.co.za>
Message-ID: <1498747129.29.0.956074267742.issue13821@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/issue13821>
_______________________________________

From report at bugs.python.org  Thu Jun 29 15:08:05 2017
From: report at bugs.python.org (tom kronmiller)
Date: Thu, 29 Jun 2017 19:08:05 +0000
Subject: [docs] [issue30787] Please add a comprehensive index of decorators
 to the documentation.
In-Reply-To: <1498573398.64.0.663772847899.issue30787@psf.upfronthosting.co.za>
Message-ID: <1498763285.21.0.679100574331.issue30787@psf.upfronthosting.co.za>


tom kronmiller added the comment:

I would not object if there was an index which contained the decorators among other things, but I have found it difficult in practice to discover things like @staticmethod and @contextmanager.  Just as I browse the index of library modules to for insight as to what it provides, I would like to browse the decorators for insight as to problems that have been solved using them.

----------

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

From report at bugs.python.org  Thu Jun 29 16:19:15 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Thu, 29 Jun 2017 20:19:15 +0000
Subject: [docs] [issue30803] Truth value of sets not properly documented
In-Reply-To: <1498743378.1.0.0570911503542.issue30803@psf.upfronthosting.co.za>
Message-ID: <1498767555.63.0.341893267565.issue30803@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

This case was supposed to be covered by the last bullet point, "instances of user-defined classes, if the class defines a __bool__() or __len__() method, when that method returns the integer zero or bool value False.".  The word "user-defined" should be dropped.

Also, the whole section can be simplified to something like:

"""
By default, objects are considered true unless they define either a __bool__ method that returns False or __len__ method that returns zero.  

Practically, this means that empty containers are false (such as [], (), {}, '', etc) and that numbers equal to zero are false (such as 0, 0.0, 0.0j, False, Decimal(0), Fractions(0, 1), etc).  Also, *None* is a false value.


"""

----------
assignee: docs at python -> rhettinger
nosy: +rhettinger
priority: normal -> low

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

From report at bugs.python.org  Fri Jun 30 07:02:56 2017
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 30 Jun 2017 11:02:56 +0000
Subject: [docs] [issue30803] Truth value of sets not properly documented
In-Reply-To: <1498743378.1.0.0570911503542.issue30803@psf.upfronthosting.co.za>
Message-ID: <1498820576.9.0.736165988711.issue30803@psf.upfronthosting.co.za>


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


----------
pull_requests: +2579

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

From report at bugs.python.org  Fri Jun 30 07:19:46 2017
From: report at bugs.python.org (Peter Thomassen)
Date: Fri, 30 Jun 2017 11:19:46 +0000
Subject: [docs] [issue30803] Truth value of sets not properly documented
In-Reply-To: <1498743378.1.0.0570911503542.issue30803@psf.upfronthosting.co.za>
Message-ID: <1498821586.5.0.771449838331.issue30803@psf.upfronthosting.co.za>


Peter Thomassen added the comment:

I submitted a PR on github, and signed the CLA before doing so. (I double-checked my bpo username in the CLA, and my github username in the bpo profile.) Still, the bot says I need to sign the CLA. I'm not sure what to do?

----------

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

From report at bugs.python.org  Fri Jun 30 09:44:23 2017
From: report at bugs.python.org (R. David Murray)
Date: Fri, 30 Jun 2017 13:44:23 +0000
Subject: [docs] [issue13821] misleading return from isidentifier
In-Reply-To: <1326934459.59.0.614334427327.issue13821@psf.upfronthosting.co.za>
Message-ID: <1498830263.78.0.585181196806.issue13821@psf.upfronthosting.co.za>


R. David Murray added the comment:

See also issue 30772 about the deeper problem.

----------

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

From report at bugs.python.org  Fri Jun 30 11:29:00 2017
From: report at bugs.python.org (R. David Murray)
Date: Fri, 30 Jun 2017 15:29:00 +0000
Subject: [docs] [issue30787] Please add a comprehensive index of decorators
 to the documentation.
In-Reply-To: <1498573398.64.0.663772847899.issue30787@psf.upfronthosting.co.za>
Message-ID: <1498836540.35.0.768259856212.issue30787@psf.upfronthosting.co.za>


R. David Murray added the comment:

Hmm.  All the dunder methods are listed in the index on the '_' page.  It would kind of be consistent to have an '@' page.  Not sure what would be needed to make that happen though (might be a sphinx level thing).

----------
nosy: +r.david.murray

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

From report at bugs.python.org  Fri Jun 30 11:42:18 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 30 Jun 2017 15:42:18 +0000
Subject: [docs] [issue30787] Please add a comprehensive index of decorators
 to the documentation.
In-Reply-To: <1498573398.64.0.663772847899.issue30787@psf.upfronthosting.co.za>
Message-ID: <1498837338.44.0.451490470732.issue30787@psf.upfronthosting.co.za>


Brett Cannon added the comment:

Both staticmethod and contextmanager are in the index under "S" and "C". But if you mean they were hard to discover, having them under a list of decorators wouldn't have necessarily helped since, as we pointed out, you may get misled to look for a decorator when in fact there was a better solution that wasn't a decorator.

I'm closing this as "not a bug" since listing everything twice -- once under its name and once under its type/expected usage -- is just going to lead to unwieldy lists that are ridiculously long that no one is going to peruse.

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

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

From report at bugs.python.org  Fri Jun 30 11:42:53 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 30 Jun 2017 15:42:53 +0000
Subject: [docs] [issue30787] Please add a comprehensive index of decorators
 to the documentation.
In-Reply-To: <1498573398.64.0.663772847899.issue30787@psf.upfronthosting.co.za>
Message-ID: <1498837373.31.0.0692527830786.issue30787@psf.upfronthosting.co.za>


Brett Cannon added the comment:

And thanks for at least bringing the idea forward, Tom.

----------

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

From report at bugs.python.org  Fri Jun 30 14:52:44 2017
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 30 Jun 2017 18:52:44 +0000
Subject: [docs] [issue11975] Fix referencing of built-in types (list, int,
 ...)
In-Reply-To: <1304281262.53.0.265979216697.issue11975@psf.upfronthosting.co.za>
Message-ID: <1498848764.83.0.554821163783.issue11975@psf.upfronthosting.co.za>


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


----------
pull_requests: +2587

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

From report at bugs.python.org  Fri Jun 30 15:31:02 2017
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 30 Jun 2017 19:31:02 +0000
Subject: [docs] [issue11975] Fix referencing of built-in types (list, int,
 ...)
In-Reply-To: <1304281262.53.0.265979216697.issue11975@psf.upfronthosting.co.za>
Message-ID: <1498851062.54.0.280432068949.issue11975@psf.upfronthosting.co.za>


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


----------
pull_requests: +2588

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

From report at bugs.python.org  Fri Jun 30 18:14:48 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 30 Jun 2017 22:14:48 +0000
Subject: [docs] [issue30803] Truth value of sets not properly documented
In-Reply-To: <1498743378.1.0.0570911503542.issue30803@psf.upfronthosting.co.za>
Message-ID: <1498860888.43.0.785131251248.issue30803@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

1. You have to go to your profile page
https://bugs.python.org/user26480
and add your GitHub name in the GitHub Name box.
2. A committer has to change the labels to trigger the robot to recheck.  I did that but it did not work because of 1.

As I said in my review, I strongly prefer leaving the bulleted list and making a minimal addition of 'set or' and 'set(), '.  I would not merge the current patch.

----------
nosy: +terry.reedy

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