From report at bugs.python.org  Mon May  1 02:16:33 2017
From: report at bugs.python.org (Xiang Zhang)
Date: Mon, 01 May 2017 06:16:33 +0000
Subject: [docs] [issue30180] PyArg_ParseTupleAndKeywords supports required
 keyword only arguments
In-Reply-To: <1493254262.66.0.357413160828.issue30180@psf.upfronthosting.co.za>
Message-ID: <1493619393.39.0.107219893032.issue30180@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Mon May  1 11:39:14 2017
From: report at bugs.python.org (Mike)
Date: Mon, 01 May 2017 15:39:14 +0000
Subject: [docs] [issue30160] BaseHTTPRequestHandler.wfile: supported usage
 unclear
In-Reply-To: <1493131484.95.0.842958745675.issue30160@psf.upfronthosting.co.za>
Message-ID: <1493653154.07.0.590715747743.issue30160@psf.upfronthosting.co.za>


Mike added the comment:

My CLA signature has been verified, but based on the most recent comments, I'm not sure if something needs to change in this patch. Is there anything I can doto help this land?

----------

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

From report at bugs.python.org  Mon May  1 12:30:08 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 01 May 2017 16:30:08 +0000
Subject: [docs] [issue28315] incorrect "in ?" output in 'divide' example at
 "Defining Clean-up Actions" in tutorial
In-Reply-To: <1475194645.41.0.947079052008.issue28315@psf.upfronthosting.co.za>
Message-ID: <1493656208.13.0.451718394344.issue28315@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Jaysinh, are you up for preparing a PR based on you patch?
Start with the master branch. 
Thanks.

----------

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

From report at bugs.python.org  Mon May  1 13:06:29 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 01 May 2017 17:06:29 +0000
Subject: [docs] [issue30145] Create a How to or Tutorial documentation for
 asyncio
In-Reply-To: <1492960602.26.0.461554169011.issue30145@psf.upfronthosting.co.za>
Message-ID: <1493658389.88.0.459891698789.issue30145@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Sounds great! Thanks, Yury!

Victor, do you think it's worth including a link to http://asyncio.readthedocs.io/en/latest/ somewhere in the docs, if we haven't already?

----------

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

From report at bugs.python.org  Mon May  1 13:25:05 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 01 May 2017 17:25:05 +0000
Subject: [docs] [issue30208] Small typos in IDLE doc
In-Reply-To: <1493473358.59.0.135881718149.issue30208@psf.upfronthosting.co.za>
Message-ID: <1493659505.42.0.433733083562.issue30208@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

One PR per branch is correct.

For future reference, preferably the commit hash to be cherry-picked is the one that is merged into CPython's master branch. It can be found at the original PR where it says <coredeveloper> merged commit <hash> into python:master. For PR 1353, it is 9dc2b38. 

For this issue, it doesn't make much difference since the PR contains only one commit. For PRs that contain multiple commits, it makes more sense to cherry-pick the squashed commit to master :)

Thanks :)

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

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

From report at bugs.python.org  Mon May  1 13:58:45 2017
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 01 May 2017 17:58:45 +0000
Subject: [docs] [issue30145] Create a How to or Tutorial documentation for
 asyncio
In-Reply-To: <1493658389.88.0.459891698789.issue30145@psf.upfronthosting.co.za>
Message-ID: <CAMpsgwasfAmZh83j8jkFwvswPUQ4EOXByy_==BwAaqDJR8wmgA@mail.gmail.com>


STINNER Victor added the comment:

Le 1 mai 2017 19:06, "Mariatta Wijaya" <report at bugs.python.org> a ?crit :

Mariatta Wijaya added the comment:

Sounds great! Thanks, Yury!

Victor, do you think it's worth including a link to
http://asyncio.readthedocs.io/en/latest/ somewhere in the docs, if we
haven't already?

Yes!

----------

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

From report at bugs.python.org  Mon May  1 15:42:07 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 01 May 2017 19:42:07 +0000
Subject: [docs] [issue27618] docs for threading.Lock claim it's a class
 (since 3.3), but it's not (and has never been, apparently)
In-Reply-To: <1469480103.96.0.342423272445.issue27618@psf.upfronthosting.co.za>
Message-ID: <1493667727.12.0.725842155774.issue27618@psf.upfronthosting.co.za>


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


----------
stage:  -> patch review
versions: +Python 2.7, Python 3.7 -Python 3.3, Python 3.4

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

From report at bugs.python.org  Tue May  2 01:16:06 2017
From: report at bugs.python.org (Jaysinh shukla)
Date: Tue, 02 May 2017 05:16:06 +0000
Subject: [docs] [issue28315] incorrect "in ?" output in 'divide' example at
 "Defining Clean-up Actions" in tutorial
In-Reply-To: <1475194645.41.0.947079052008.issue28315@psf.upfronthosting.co.za>
Message-ID: <1493702166.43.0.892419467044.issue28315@psf.upfronthosting.co.za>


Jaysinh shukla added the comment:

Thanks Mariatta for reminding. Please expect a Github PR from my side in next 2 days.

----------

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

From report at bugs.python.org  Tue May  2 03:00:53 2017
From: report at bugs.python.org (Jaysinh shukla)
Date: Tue, 02 May 2017 07:00:53 +0000
Subject: [docs] [issue28315] incorrect "in ?" output in 'divide' example at
 "Defining Clean-up Actions" in tutorial
In-Reply-To: <1475194645.41.0.947079052008.issue28315@psf.upfronthosting.co.za>
Message-ID: <1493708453.89.0.287389207614.issue28315@psf.upfronthosting.co.za>


Changes by Jaysinh shukla <jaysinhp at gmail.com>:


----------
pull_requests: +1480

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

From zdivmilen at gmail.com  Tue May  2 03:08:53 2017
From: zdivmilen at gmail.com (Zen Milen)
Date: Tue, 2 May 2017 16:08:53 +0900
Subject: [docs] What are the license for python manuals?
Message-ID: <CAPfs-F2rGPPboKWXx7G9bzsDohPQMXXasv3P9FwfeVFiECMtkg@mail.gmail.com>

Dear, copyright holder for python manuals.

I want to know if I can redistribute python manuals with  the form of
 mobile  application.
If I can, what are the restrictions ? Can I add an Ads in that application ?


Thanks for your help in advance.

Chun.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170502/4786d252/attachment.html>

From report at bugs.python.org  Tue May  2 17:36:31 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Tue, 02 May 2017 21:36:31 +0000
Subject: [docs] [issue30208] Small typos in IDLE doc
In-Reply-To: <1493659505.42.0.433733083562.issue30208@psf.upfronthosting.co.za>
Message-ID: <CAACPsK5LD2Tz0E1U4XoDNGgsLuO551fukf=nMx+FDjY6wnZ2ZQ@mail.gmail.com>


Cheryl Sabella added the comment:

Thank you for that information, Mariatta.  I had to read your description
twice to find the 9dc2b38 commit hash.  Once someone learns this, then they
will remember it, but you may want to highlight it on the cherry-pick
readme.  That was very well written and easy to follow, but I don't
remember it specifying the commit hash to use.

Cherry-pick is an awesome tool.  Can't wait to use it again!   :-)

On Mon, May 1, 2017 at 1:25 PM, Mariatta Wijaya <report at bugs.python.org>
wrote:

>
> Mariatta Wijaya added the comment:
>
> One PR per branch is correct.
>
> For future reference, preferably the commit hash to be cherry-picked is
> the one that is merged into CPython's master branch. It can be found at the
> original PR where it says <coredeveloper> merged commit <hash> into
> python:master. For PR 1353, it is 9dc2b38.
>
> For this issue, it doesn't make much difference since the PR contains only
> one commit. For PRs that contain multiple commits, it makes more sense to
> cherry-pick the squashed commit to master :)
>
> Thanks :)
>
> ----------
> nosy: +Mariatta
>
> _______________________________________
> Python tracker <report at bugs.python.org>
> <http://bugs.python.org/issue30208>
> _______________________________________
>

----------

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

From report at bugs.python.org  Wed May  3 12:46:47 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 03 May 2017 16:46:47 +0000
Subject: [docs] [issue28315] incorrect "in ?" output in 'divide' example at
 "Defining Clean-up Actions" in tutorial
In-Reply-To: <1475194645.41.0.947079052008.issue28315@psf.upfronthosting.co.za>
Message-ID: <1493830007.22.0.427996433624.issue28315@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 8856940cf2e82cb17db2b684cd5732fe658605ca by Mariatta (UltimateCoder) in branch 'master':
bpo-28315: Improve code examples in docs (GH-1372)
https://github.com/python/cpython/commit/8856940cf2e82cb17db2b684cd5732fe658605ca


----------

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

From report at bugs.python.org  Wed May  3 12:47:55 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 03 May 2017 16:47:55 +0000
Subject: [docs] [issue28315] incorrect "in ?" output in 'divide' example at
 "Defining Clean-up Actions" in tutorial
In-Reply-To: <1475194645.41.0.947079052008.issue28315@psf.upfronthosting.co.za>
Message-ID: <1493830075.44.0.751318426489.issue28315@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Wed May  3 16:23:28 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Wed, 03 May 2017 20:23:28 +0000
Subject: [docs] [issue28315] incorrect "in ?" output in 'divide' example at
 "Defining Clean-up Actions" in tutorial
In-Reply-To: <1475194645.41.0.947079052008.issue28315@psf.upfronthosting.co.za>
Message-ID: <1493843008.17.0.428556165007.issue28315@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

Mariatta, please continue with this and assign to yourself.  I now have IDLE PRs to review and apply.

----------
assignee: terry.reedy -> 

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

From report at bugs.python.org  Wed May  3 16:30:08 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 03 May 2017 20:30:08 +0000
Subject: [docs] [issue28315] incorrect "in ?" output in 'divide' example at
 "Defining Clean-up Actions" in tutorial
In-Reply-To: <1475194645.41.0.947079052008.issue28315@psf.upfronthosting.co.za>
Message-ID: <1493843408.26.0.556699844874.issue28315@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

For sure :) Thanks Terry.

----------
assignee:  -> Mariatta

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

From report at bugs.python.org  Wed May  3 21:08:19 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 04 May 2017 01:08:19 +0000
Subject: [docs] [issue28315] incorrect "in ?" output in 'divide' example at
 "Defining Clean-up Actions" in tutorial
In-Reply-To: <1475194645.41.0.947079052008.issue28315@psf.upfronthosting.co.za>
Message-ID: <1493860099.23.0.640826070198.issue28315@psf.upfronthosting.co.za>


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


----------
pull_requests: +1543

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

From report at bugs.python.org  Wed May  3 21:08:30 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 04 May 2017 01:08:30 +0000
Subject: [docs] [issue28315] incorrect "in ?" output in 'divide' example at
 "Defining Clean-up Actions" in tutorial
In-Reply-To: <1475194645.41.0.947079052008.issue28315@psf.upfronthosting.co.za>
Message-ID: <1493860110.76.0.886235862248.issue28315@psf.upfronthosting.co.za>


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


----------
pull_requests: +1544

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

From report at bugs.python.org  Wed May  3 21:41:14 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 04 May 2017 01:41:14 +0000
Subject: [docs] [issue28315] incorrect "in ?" output in 'divide' example at
 "Defining Clean-up Actions" in tutorial
In-Reply-To: <1475194645.41.0.947079052008.issue28315@psf.upfronthosting.co.za>
Message-ID: <1493862074.52.0.830754268545.issue28315@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 5274faf5e360f74690ffb735e919cdba5fdbdf1c by Mariatta in branch '3.5':
[3.5] bpo-28315: Improve code examples in docs (GH-1372) (#1446)
https://github.com/python/cpython/commit/5274faf5e360f74690ffb735e919cdba5fdbdf1c


----------

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

From report at bugs.python.org  Wed May  3 21:41:22 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 04 May 2017 01:41:22 +0000
Subject: [docs] [issue28315] incorrect "in ?" output in 'divide' example at
 "Defining Clean-up Actions" in tutorial
In-Reply-To: <1475194645.41.0.947079052008.issue28315@psf.upfronthosting.co.za>
Message-ID: <1493862082.91.0.934694269032.issue28315@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset af71364c3f0e9cd6cb9d83194315af0ee3c783d2 by Mariatta in branch '3.6':
[3.6] bpo-28315: Improve code examples in docs (GH-1372) (#1445)
https://github.com/python/cpython/commit/af71364c3f0e9cd6cb9d83194315af0ee3c783d2


----------

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

From report at bugs.python.org  Wed May  3 21:47:49 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 04 May 2017 01:47:49 +0000
Subject: [docs] [issue28315] incorrect "in ?" output in 'divide' example at
 "Defining Clean-up Actions" in tutorial
In-Reply-To: <1475194645.41.0.947079052008.issue28315@psf.upfronthosting.co.za>
Message-ID: <1493862469.68.0.152206056498.issue28315@psf.upfronthosting.co.za>


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


----------
pull_requests: +1545

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

From report at bugs.python.org  Wed May  3 21:54:30 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 04 May 2017 01:54:30 +0000
Subject: [docs] [issue28315] incorrect "in ?" output in 'divide' example at
 "Defining Clean-up Actions" in tutorial
In-Reply-To: <1475194645.41.0.947079052008.issue28315@psf.upfronthosting.co.za>
Message-ID: <1493862870.33.0.235976798514.issue28315@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset e1b02ff58883c68d3a5e549aa33c6dd94f915bd6 by Mariatta in branch '2.7':
[2.7] bpo-28315: Improve code examples in docs (GH-1372) (#1447)
https://github.com/python/cpython/commit/e1b02ff58883c68d3a5e549aa33c6dd94f915bd6


----------

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

From report at bugs.python.org  Wed May  3 21:56:16 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 04 May 2017 01:56:16 +0000
Subject: [docs] [issue28315] incorrect "in ?" output in 'divide' example at
 "Defining Clean-up Actions" in tutorial
In-Reply-To: <1475194645.41.0.947079052008.issue28315@psf.upfronthosting.co.za>
Message-ID: <1493862976.52.0.388734175745.issue28315@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

We can finally close this. Thanks everyone :)

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

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

From report at bugs.python.org  Thu May  4 01:43:00 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 04 May 2017 05:43:00 +0000
Subject: [docs] [issue29956] math.exp documentation is misleading
In-Reply-To: <1490990917.06.0.404933995002.issue29956@psf.upfronthosting.co.za>
Message-ID: <1493876580.39.0.472335104045.issue29956@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

Could anybody please make a review of PR 1073?

----------

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

From report at bugs.python.org  Thu May  4 05:25:12 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 04 May 2017 09:25:12 +0000
Subject: [docs] [issue29956] math.exp documentation is misleading
In-Reply-To: <1490990917.06.0.404933995002.issue29956@psf.upfronthosting.co.za>
Message-ID: <1493889912.08.0.479705560029.issue29956@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:


New changeset dbaf746b6de0ee431c809d3175ab40ccc18898a8 by Serhiy Storchaka in branch 'master':
bpo-29956: Improve the math.exp() related documentation. (#1073)
https://github.com/python/cpython/commit/dbaf746b6de0ee431c809d3175ab40ccc18898a8


----------

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

From report at bugs.python.org  Thu May  4 07:14:35 2017
From: report at bugs.python.org (Cristian Barbarosie)
Date: Thu, 04 May 2017 11:14:35 +0000
Subject: [docs] [issue30004] in regex-howto, improve example on grouping
In-Reply-To: <1491453642.54.0.802330198745.issue30004@psf.upfronthosting.co.za>
Message-ID: <1493896475.8.0.666605427025.issue30004@psf.upfronthosting.co.za>


Cristian Barbarosie added the comment:

This topic seems stuck. Is there anything else I should do ?

----------

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

From report at bugs.python.org  Thu May  4 14:51:37 2017
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 04 May 2017 18:51:37 +0000
Subject: [docs] [issue18669] curses.chgat() moves cursor,
 documentation says it shouldn't
In-Reply-To: <1375800170.73.0.20062232661.issue18669@psf.upfronthosting.co.za>
Message-ID: <1493923897.58.0.0443523746251.issue18669@psf.upfronthosting.co.za>


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


----------
pull_requests: +1558

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

From report at bugs.python.org  Thu May  4 18:11:04 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Thu, 04 May 2017 22:11:04 +0000
Subject: [docs] [issue30085] Discourage operator.__dunder__ functions
In-Reply-To: <1492396029.61.0.720198059802.issue30085@psf.upfronthosting.co.za>
Message-ID: <1493935864.64.0.841025131856.issue30085@psf.upfronthosting.co.za>


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


----------
stage:  -> commit review
type:  -> enhancement
versions: +Python 3.7

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

From report at bugs.python.org  Thu May  4 18:24:49 2017
From: report at bugs.python.org (Brett Cannon)
Date: Thu, 04 May 2017 22:24:49 +0000
Subject: [docs] [issue30274] Make
 importlib.abc.ExtensionFileLoader.__init__() documentation match code
Message-ID: <1493936689.45.0.0881901800669.issue30274@psf.upfronthosting.co.za>


New submission from Brett Cannon:

https://docs.python.org/3/library/importlib.html#importlib.machinery.ExtensionFileLoader says "fullname, path" for __init__(), but https://github.com/python/cpython/blob/647c3d381e67490e82cdbbe6c96e46d5e1628ce2/Lib/importlib/_bootstrap_external.py#L909 says "name, path". While I would much rather change the parameter name to match the rest of the module, I don't think I'm comfortable with the backwards-compatibility breakage over just a single parameter name (although chances are no one will notice in either direction as everyone probably passes by position).

----------
assignee: docs at python
components: Documentation
messages: 293022
nosy: brett.cannon, docs at python
priority: normal
severity: normal
stage: needs patch
status: open
title: Make importlib.abc.ExtensionFileLoader.__init__() documentation match code

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

From report at bugs.python.org  Fri May  5 03:36:46 2017
From: report at bugs.python.org (Kyle Thomas)
Date: Fri, 05 May 2017 07:36:46 +0000
Subject: [docs] [issue30278] The element div#sidebar on documentation
 requires the attribute role="button".
Message-ID: <1493969806.2.0.294346675831.issue30278@psf.upfronthosting.co.za>


New submission from Kyle Thomas:

Elements other than buttons which act as buttons require metadata to be accessible. Refer to
https://www.w3.org/TR/wai-aria-practices/examples/button/button.html

----------
assignee: docs at python
components: Documentation
messages: 293056
nosy: Kyle Thomas, docs at python
priority: normal
severity: normal
status: open
title: The element div#sidebar on documentation requires the attribute role="button".
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/issue30278>
_______________________________________

From report at bugs.python.org  Fri May  5 04:15:14 2017
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 05 May 2017 08:15: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: <1493972114.19.0.334358404755.issue29920@psf.upfronthosting.co.za>


Berker Peksag added the comment:


New changeset c07b3a15be5e0a68a73b4c532861ed8de6932bd2 by Berker Peksag (masklinn) in branch 'master':
bpo-29920: Document cgitb.text() and cgitb.html() functions (GH-849)
https://github.com/python/cpython/commit/c07b3a15be5e0a68a73b4c532861ed8de6932bd2


----------
nosy: +berker.peksag

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

From report at bugs.python.org  Fri May  5 12:34:30 2017
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 05 May 2017 16:34:30 +0000
Subject: [docs] [issue30274] Make
 importlib.abc.ExtensionFileLoader.__init__() documentation match code
In-Reply-To: <1493936689.45.0.0881901800669.issue30274@psf.upfronthosting.co.za>
Message-ID: <1494002070.38.0.824597763753.issue30274@psf.upfronthosting.co.za>


Brett Cannon added the comment:

Another option is to rename 'name' to 'fullname', make 'name' keyword-only, and then raise a DeprecationWarning if 'name' is used, eventually removing the keyword-only argument.

----------

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

From report at bugs.python.org  Fri May  5 18:01:33 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 05 May 2017 22:01:33 +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: <1494021693.16.0.77069632917.issue30217@psf.upfronthosting.co.za>


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


----------
nosy: +terry.reedy
versions:  -Python 3.3, Python 3.4

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

From report at bugs.python.org  Sat May  6 09:05:43 2017
From: report at bugs.python.org (debuggy)
Date: Sat, 06 May 2017 13:05:43 +0000
Subject: [docs] [issue30292] Why is there a concept "unbound method" in
 <Descriptor HowTo Guide> python3 version?
Message-ID: <1494075943.31.0.565968699812.issue30292@psf.upfronthosting.co.za>


New submission from debuggy:

When I read <Descriptor HowTo Guide> (python 3.6.1 version), I found there is a concept of 'unbound method' in some places. However, when I referred to <What?s New In Python 3.0>, it said the concept of ?unbound methods? has been removed from the language.

So I wondered if there should be a change in <Descriptor HowTo Guide> python3 version?

For instance, in this code example of the guide:

>>> class D(object):
...     def f(self, x):
...         return x
...
>>> d = D()
>>> D.__dict__['f']  # Stored internally as a function
<function f at 0x00C45070>
>>> D.f              # Get from a class becomes an unbound method
<unbound method D.f> 
>>> d.f              # Get from an instance becomes a bound method
<bound method D.f of <__main__.D object at 0x00B18C90>>

When I tested myself, the result of statement "D.f" should be <function> not <unbound method>.

----------
assignee: docs at python
components: Documentation
messages: 293160
nosy: debuggy, docs at python
priority: normal
severity: normal
status: open
title: Why is there a concept "unbound method" in <Descriptor HowTo Guide> python3 version?
type: enhancement
versions: Python 3.6

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

From report at bugs.python.org  Sat May  6 10:16:47 2017
From: report at bugs.python.org (Martin Panter)
Date: Sat, 06 May 2017 14:16:47 +0000
Subject: [docs] [issue12077] Harmonizing descriptor protocol documentation
In-Reply-To: <1305381385.94.0.81554539251.issue12077@psf.upfronthosting.co.za>
Message-ID: <1494080207.31.0.514591691661.issue12077@psf.upfronthosting.co.za>


Martin Panter added the comment:

See Issue 23702 specifically about unbound methods in Python 3, and Issue 25435 about general problems with the how-to in Python 3.

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

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

From report at bugs.python.org  Sat May  6 10:20:15 2017
From: report at bugs.python.org (Martin Panter)
Date: Sat, 06 May 2017 14:20:15 +0000
Subject: [docs] [issue30292] Why is there a concept "unbound method" in
 <Descriptor HowTo Guide> python3 version?
In-Reply-To: <1494075943.31.0.565968699812.issue30292@psf.upfronthosting.co.za>
Message-ID: <1494080415.92.0.00921629492614.issue30292@psf.upfronthosting.co.za>


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


----------
resolution:  -> duplicate
stage:  -> resolved
status: open -> closed
superseder:  -> docs.python.org/3/howto/descriptor.html still refers to "unbound methods"

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

From report at bugs.python.org  Sat May  6 10:23:47 2017
From: report at bugs.python.org (Martin Panter)
Date: Sat, 06 May 2017 14:23:47 +0000
Subject: [docs] [issue25435] Wrong function calls and referring to not
 removed concepts in descriptor HowTo (documentation)
In-Reply-To: <1445194189.09.0.0973348556564.issue25435@psf.upfronthosting.co.za>
Message-ID: <1494080627.69.0.209666192047.issue25435@psf.upfronthosting.co.za>


Martin Panter added the comment:

Raymond I suggest you unassign this and let others work on it.

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

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

From report at bugs.python.org  Sat May  6 10:45:05 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 06 May 2017 14:45:05 +0000
Subject: [docs] [issue25435] Wrong function calls and referring to not
 removed concepts in descriptor HowTo (documentation)
In-Reply-To: <1445194189.09.0.0973348556564.issue25435@psf.upfronthosting.co.za>
Message-ID: <1494081905.57.0.945163308264.issue25435@psf.upfronthosting.co.za>


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


----------
versions: +Python 3.7 -Python 3.4

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

From report at bugs.python.org  Sat May  6 11:15:56 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Sat, 06 May 2017 15:15:56 +0000
Subject: [docs] [issue25435] Wrong function calls and referring to not
 removed concepts in descriptor HowTo (documentation)
In-Reply-To: <1445194189.09.0.0973348556564.issue25435@psf.upfronthosting.co.za>
Message-ID: <1494083756.19.0.0709776518742.issue25435@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

I will have a chance to work on this before long.

----------

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

From report at bugs.python.org  Sat May  6 11:16:26 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Sat, 06 May 2017 15:16:26 +0000
Subject: [docs] [issue12077] Harmonizing descriptor protocol documentation
In-Reply-To: <1305381385.94.0.81554539251.issue12077@psf.upfronthosting.co.za>
Message-ID: <1494083786.48.0.765272887588.issue12077@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

I will have a chance to work on this before long.

----------

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

From report at bugs.python.org  Sat May  6 15:50:03 2017
From: report at bugs.python.org (Joshua Jay Herman)
Date: Sat, 06 May 2017 19:50:03 +0000
Subject: [docs] [issue24459] Mention PYTHONFAULTHANDLER in the man page
In-Reply-To: <1434487895.85.0.561507121326.issue24459@psf.upfronthosting.co.za>
Message-ID: <1494100203.22.0.803319607208.issue24459@psf.upfronthosting.co.za>


Joshua Jay Herman added the comment:

Ping

----------

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

From report at bugs.python.org  Sun May  7 03:18:17 2017
From: report at bugs.python.org (Mark Dickinson)
Date: Sun, 07 May 2017 07:18:17 +0000
Subject: [docs] [issue29956] math.exp documentation is misleading
In-Reply-To: <1490990917.06.0.404933995002.issue29956@psf.upfronthosting.co.za>
Message-ID: <1494141497.8.0.649464361505.issue29956@psf.upfronthosting.co.za>


Mark Dickinson added the comment:

Can this be closed?

----------

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

From report at bugs.python.org  Sun May  7 08:24:20 2017
From: report at bugs.python.org (Giampaolo Rodola')
Date: Sun, 07 May 2017 12:24:20 +0000
Subject: [docs] [issue30295] msvcrt SetErrorMode not documented
Message-ID: <1494159860.93.0.93225035242.issue30295@psf.upfronthosting.co.za>


New submission from Giampaolo Rodola':

Also SEM_FAILCRITICALERRORS and other SEM_constants. They should as setting error mode on Windows for console applications is a pretty common use case (in fact ./Lib/test/libregrtest/setup.py uses it).

----------
assignee: docs at python
components: Documentation
messages: 293189
nosy: docs at python, giampaolo.rodola
priority: normal
severity: normal
status: open
title: msvcrt SetErrorMode not documented
versions: Python 3.4, Python 3.5, Python 3.6, Python 3.7

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

From report at bugs.python.org  Sun May  7 11:56:09 2017
From: report at bugs.python.org (Eryk Sun)
Date: Sun, 07 May 2017 15:56:09 +0000
Subject: [docs] [issue30295] msvcrt SetErrorMode not documented
In-Reply-To: <1494159860.93.0.93225035242.issue30295@psf.upfronthosting.co.za>
Message-ID: <1494172569.38.0.653479048734.issue30295@psf.upfronthosting.co.za>


Eryk Sun added the comment:

msvcrt set_error_mode, CrtReportMode, CrtReportFile and the associated CRT constants should be documented for use with debug builds. Also, msvcrt is missing the set_error_mode constants _OUT_TO_DEFAULT, _OUT_TO_STDERR, _OUT_TO_MSGBOX, and _REPORT_ERRMODE.

SetErrorMode [1] and the SEM_* constants are defined in msvcrt, for convenience I suppose. They're not related to the CRT. I think they should be aliased in the os module and documented there. GetErrorMode [2] can also be provided in Python 3.5+. It would be useful to also provide SetThreadErrorMode [3] and GetThreadErrorMode conditionally in Windows 7+, which is practically all Windows users nowadays.

[1]: https://msdn.microsoft.com/en-us/library/ms680621
[2]: https://msdn.microsoft.com/en-us/library/ms679355
[3]: https://msdn.microsoft.com/en-us/library/dd553630

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

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

From report at bugs.python.org  Sun May  7 11:56:43 2017
From: report at bugs.python.org (Eryk Sun)
Date: Sun, 07 May 2017 15:56:43 +0000
Subject: [docs] [issue30295] msvcrt SetErrorMode not documented
In-Reply-To: <1494159860.93.0.93225035242.issue30295@psf.upfronthosting.co.za>
Message-ID: <1494172603.91.0.513307392811.issue30295@psf.upfronthosting.co.za>


Changes by Eryk Sun <eryksun at gmail.com>:


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

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

From report at bugs.python.org  Sun May  7 14:22:29 2017
From: report at bugs.python.org (Barry A. Warsaw)
Date: Sun, 07 May 2017 18:22:29 +0000
Subject: [docs] [issue30145] Create a How to or Tutorial documentation for
 asyncio
In-Reply-To: <1492960602.26.0.461554169011.issue30145@psf.upfronthosting.co.za>
Message-ID: <1494181349.55.0.518723307765.issue30145@psf.upfronthosting.co.za>


Changes by Barry A. Warsaw <barry at python.org>:


----------
nosy: +barry

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

From report at bugs.python.org  Sun May  7 14:40:20 2017
From: report at bugs.python.org (Vinay Sajip)
Date: Sun, 07 May 2017 18:40:20 +0000
Subject: [docs] [issue30168] Class Logger is unindented in the documentation.
In-Reply-To: <1493210640.98.0.578541878256.issue30168@psf.upfronthosting.co.za>
Message-ID: <1494182420.27.0.258383760862.issue30168@psf.upfronthosting.co.za>


Vinay Sajip added the comment:


New changeset 55ace65eba587fe3cf3759a43cccf85214651971 by Vinay Sajip (Jim Fasarakis-Hilliard) in branch 'master':
Closes bpo-30168: indent methods in Logger Class (#1295)
https://github.com/python/cpython/commit/55ace65eba587fe3cf3759a43cccf85214651971


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

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

From report at bugs.python.org  Sun May  7 20:59:10 2017
From: report at bugs.python.org (Steven D'Aprano)
Date: Mon, 08 May 2017 00:59:10 +0000
Subject: [docs] [issue23702] docs.python.org/3/howto/descriptor.html still
 refers to "unbound methods"
In-Reply-To: <1426708114.47.0.635748134131.issue23702@psf.upfronthosting.co.za>
Message-ID: <1494205150.68.0.428907785087.issue23702@psf.upfronthosting.co.za>


Steven D'Aprano added the comment:

Be careful with the documentation patch. Although unbound method as an object type is gone, unbound method as a concept is not.

Conceptually, something like ``MyClass.spam`` is an unbound method: it is a method of the MyClass type, but bound to no instance. In Python 2 that concept was implemented by MethodType. In Python 3, the concept is implemented by FunctionType.

While it is certainly true from one perspective that unbound methods are nothing but functions, it is nevertheless also sometimes useful to distinguish from "functions defined in a class" (methods) and "other functions". I think that nearly all Python programmers would be happy to call ``spam`` below:

    class MyClass:
        def spam(self, arg): ...

a method, even though it is also/really a function.

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

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

From report at bugs.python.org  Sun May  7 21:17:18 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 08 May 2017 01:17:18 +0000
Subject: [docs] [issue23702] docs.python.org/3/howto/descriptor.html still
 refers to "unbound methods"
In-Reply-To: <1426708114.47.0.635748134131.issue23702@psf.upfronthosting.co.za>
Message-ID: <1494206238.82.0.916723373213.issue23702@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

I'll fix that up.  I've already been working on revising the document.  There are a number of updates needed (user-friendly intro, properties revised to show the setting methods, __set_name__, etc).

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

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

From report at bugs.python.org  Mon May  8 00:16:49 2017
From: report at bugs.python.org (Louie Lu)
Date: Mon, 08 May 2017 04:16:49 +0000
Subject: [docs] [issue29947] In SocketServer,
 why not passing a factory instance for the RequestHandlerClass
 instead of the class itself?
In-Reply-To: <1490875733.83.0.750732897079.issue29947@psf.upfronthosting.co.za>
Message-ID: <1494217009.43.0.100581942971.issue29947@psf.upfronthosting.co.za>


Changes by Louie Lu <me at louie.lu>:


----------
pull_requests: +1598

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

From report at bugs.python.org  Mon May  8 04:50:09 2017
From: report at bugs.python.org (Martin Panter)
Date: Mon, 08 May 2017 08:50:09 +0000
Subject: [docs] [issue30304] TestCase.assertMultiLineEqual only registered
 for Unicode strings in 2.7
Message-ID: <1494233409.78.0.688533240712.issue30304@psf.upfronthosting.co.za>


New submission from Martin Panter:

In Mercurial revision 6e5b5d1b6714, the documentation for ?assertMultiLineEqual? was changed from

This method is used by default when comparing Unicode strings with ?assertEqual?.

to

This method is used by default when comparing strings with ?assertEqual?. 

The new text is misleading because ?str? objects are also strings, but the default does not apply to ?str? objects.

----------
assignee: docs at python
components: Documentation, Tests
keywords: easy
messages: 293229
nosy: docs at python, ezio.melotti, martin.panter
priority: normal
severity: normal
stage: needs patch
status: open
title: TestCase.assertMultiLineEqual only registered for Unicode strings in 2.7
type: behavior
versions: Python 2.7

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

From report at bugs.python.org  Mon May  8 11:15:13 2017
From: report at bugs.python.org (Marco Buttu)
Date: Mon, 08 May 2017 15:15:13 +0000
Subject: [docs] [issue25435] Wrong function calls and referring to not
 removed concepts in descriptor HowTo (documentation)
In-Reply-To: <1445194189.09.0.0973348556564.issue25435@psf.upfronthosting.co.za>
Message-ID: <1494256513.62.0.209251578539.issue25435@psf.upfronthosting.co.za>


Marco Buttu added the comment:

I also noticed that the howto differentiates between objects and classes:

"The details of invocation depend on whether obj is an object or a class."

I think it is misleading, because a class is actually an object.  IMHO is better to differentiate between classes and non-classes objects:

"The details of invocation depend on whether obj is a class or not."

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

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

From report at bugs.python.org  Mon May  8 11:50:22 2017
From: report at bugs.python.org (Marco Buttu)
Date: Mon, 08 May 2017 15:50:22 +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: <1494258622.72.0.858298679078.issue30217@psf.upfronthosting.co.za>


Marco Buttu added the comment:

Thanks Eric.  I think the reference should be added here, as we do for the other operators:

https://docs.python.org/3/library/stdtypes.html#bitwise-operations-on-integer-types

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

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

From report at bugs.python.org  Mon May  8 11:56:23 2017
From: report at bugs.python.org (Marco Buttu)
Date: Mon, 08 May 2017 15:56:23 +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: <1494258983.57.0.249699307146.issue30217@psf.upfronthosting.co.za>


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


----------
pull_requests: +1603

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

From report at bugs.python.org  Mon May  8 13:10:15 2017
From: report at bugs.python.org (Eric Lebigot)
Date: Mon, 08 May 2017 17:10:15 +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: <1494263415.58.0.724491788293.issue30217@psf.upfronthosting.co.za>


Eric Lebigot added the comment:

Good reference.

Another one would be https://docs.python.org/3/reference/expressions.html#unary-arithmetic-and-bitwise-operations, which explicitly indicates that it only makes sense for integer types (which is useful to keep in mind, as one may think that it could somehow apply to floating point numbers as well).

The one at https://docs.python.org/3.6/reference/datamodel.html#object.__invert__ is also important for learning that it is related to __invert__().

----------
nosy: +Eric Lebigot

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

From report at bugs.python.org  Mon May  8 13:14:18 2017
From: report at bugs.python.org (Alexander Belopolsky)
Date: Mon, 08 May 2017 17:14:18 +0000
Subject: [docs] [issue29956] math.exp documentation is misleading
In-Reply-To: <1490990917.06.0.404933995002.issue29956@psf.upfronthosting.co.za>
Message-ID: <1494263658.54.0.519444693945.issue29956@psf.upfronthosting.co.za>


Changes by Alexander Belopolsky <alexander.belopolsky at gmail.com>:


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

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

From report at bugs.python.org  Mon May  8 14:26:22 2017
From: report at bugs.python.org (rohit singh)
Date: Mon, 08 May 2017 18:26:22 +0000
Subject: [docs] [issue30307]
 https://docs.python.org/3/tutorial/introduction.html#strings Section 3.1.2
 doc issue
Message-ID: <1494267982.7.0.781940622722.issue30307@psf.upfronthosting.co.za>


New submission from rohit singh:

The documentation says:

>>> '"Isn\'t," she said.'
'"Isn\'t," she said.'

It should be:

>>> '"Isn\'t," she said.'
'"Isn't," she said.'

----------
assignee: docs at python
components: Documentation
messages: 293246
nosy: docs at python, rohit singh
priority: normal
severity: normal
status: open
title: https://docs.python.org/3/tutorial/introduction.html#strings Section 3.1.2 doc issue
versions: Python 3.6

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

From report at bugs.python.org  Mon May  8 14:30:28 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 08 May 2017 18:30:28 +0000
Subject: [docs] [issue30307]
 https://docs.python.org/3/tutorial/introduction.html#strings Section 3.1.2
 doc issue
In-Reply-To: <1494267982.7.0.781940622722.issue30307@psf.upfronthosting.co.za>
Message-ID: <1494268228.33.0.627635589018.issue30307@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Mon May  8 16:28:46 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 08 May 2017 20:28:46 +0000
Subject: [docs] [issue25435] Wrong function calls and referring to not
 removed concepts in descriptor HowTo (documentation)
In-Reply-To: <1445194189.09.0.0973348556564.issue25435@psf.upfronthosting.co.za>
Message-ID: <1494275325.99.0.861229065795.issue25435@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

> I think it is misleading, because a class is actually an object.

This is only misleading *after* you know all the interesting details about Python and metaclasses.  Prior to that, it is a reasonable and important distinction that I don't want to get lost in weasel words.   The calls from object.__getattribute__ are different that those from type.__getattribute__.  Likewise, data and non-data descriptors can only be described in terms of objects versus classes.  Lastly, descriptors only work when stored in a class, if you store them in instances, they don't get invoked.

----------

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

From report at bugs.python.org  Tue May  9 04:47:27 2017
From: report at bugs.python.org (Oskar Weser)
Date: Tue, 09 May 2017 08:47:27 +0000
Subject: [docs] [issue30312] Small correction in set code sample
Message-ID: <1494319647.07.0.625979333092.issue30312@psf.upfronthosting.co.za>


New submission from Oskar Weser:

There is a code example about the set type found under:
https://docs.python.org/3/tutorial/datastructures.html

It reads as:
```
>>> basket = {'apple', 'orange', 'apple', 'pear', 'orange', 'banana'}
>>> print(basket)                      # show that duplicates have been removed
{'orange', 'banana', 'pear', 'apple'}
>>> 'orange' in basket                 # fast membership testing
True
>>> 'crabgrass' in basket
False

>>> # Demonstrate set operations on unique letters from two words
...
>>> a = set('abracadabra')
>>> b = set('alacazam')
>>> a                                  # unique letters in a
{'a', 'r', 'b', 'c', 'd'}
>>> a - b                              # letters in a but not in b
{'r', 'd', 'b'}
>>> a | b                              # letters in either a or b
```

I read "either a or b" as "a .EXOR. b". Shouldn't it be:
```
>>> a | b                              # letters in a or b
```
I don't speak English as a native language, so perhaps I am wrong.

----------
assignee: docs at python
components: Documentation
messages: 293291
nosy: docs at python, mcocdawc
priority: normal
severity: normal
status: open
title: Small correction in set code sample
versions: Python 3.5, Python 3.6, Python 3.7

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

From report at bugs.python.org  Tue May  9 05:10:11 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Tue, 09 May 2017 09:10: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: <1494321011.78.0.667375386841.issue30312@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

ISTM the result of the expression makes the meaning clear:

    >>> a | b
    {'r', 'l', 'b', 'c', 'z', 'd', 'a', 'm'}

That said, the text might be a little clearer like this:

   # letters in a or b or both

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

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

From report at bugs.python.org  Tue May  9 09:08:51 2017
From: report at bugs.python.org (flying sheep)
Date: Tue, 09 May 2017 13:08:51 +0000
Subject: [docs] [issue10436] tarfile.extractfile in "r|" stream mode fails
 with filenames or members from getmembers()
In-Reply-To: <1289931464.79.0.618120236196.issue10436@psf.upfronthosting.co.za>
Message-ID: <1494335331.91.0.950567600608.issue10436@psf.upfronthosting.co.za>


flying sheep added the comment:

well, we should just allow

extractall(members=['foo', 'bar'])

currently members only accepts TarInfo objects, not filenames, but it?s easy to accept both.

https://github.com/python/cpython/blob/74683fc6247c522ae955a6e7308b8ff51def35d8/Lib/tarfile.py#L1991-L1999

sth like:

filenames = set()
for member in members:
    if isinstance(member, TarInfo):
        # do what?s done now
    else:
        filenames.add(member)

for tarinfo in self:
    if tarinfo.name in filenames:
        self.extract(tarinfo)

----------
nosy: +flying sheep

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

From gustavotoffo at gmail.com  Tue May  9 11:12:01 2017
From: gustavotoffo at gmail.com (Gustavo Toffo)
Date: Tue, 9 May 2017 12:12:01 -0300
Subject: [docs] I would like to contribute to the Python documentation
Message-ID: <CAKmm7v=gfTGeNga1X6+EG6+LoOq41sOobgCEcXzmtSH85A7xeA@mail.gmail.com>

Hello!

I would like to contribute to the wonderful language that is Python.

I've noticed that the portuguese documentation of Python is either severely
lacking or not updated.

I would like to help out and offer to translate the documentation and
provide working resources, whether updated examples, books that are
updated, including books of my own, all in the documentation to better help
teach Python.

I will do the work for free although I would very much appreciate some
mention of my contribution. My primary concern is in making sure that
Python reaches as many people as possible with the best quality that it can.

I want to eventually translate the whole website in order to make it
available to the Portuguese speaking audiences (of which I'm a native)

I'm sending along a 3 page sample of my work. I've translated the
beginner's guide and purposefuly left at the side some of the original text
just so you can be assured of my quality of work.

Thank you for all your efforts in this wonderful language

Grandes abra?os!
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170509/131cf488/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: Beginner's Guide to Python.pdf
Type: application/pdf
Size: 38903 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20170509/131cf488/attachment-0001.pdf>

From report at bugs.python.org  Tue May  9 11:38:14 2017
From: report at bugs.python.org (Marco Buttu)
Date: Tue, 09 May 2017 15:38: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: <1494344294.91.0.0603854254434.issue30217@psf.upfronthosting.co.za>


Marco Buttu added the comment:

Looking at Doc/reference/expressions.rst and Doc/reference/datamodel.rst, I do not see any reference to the symbols, but only to the operator name (negation, minus, plus, inversion, etc.).  Therefore I think it is better to not change these files.

In the PR [*] I added (in Doc/library/stdtypes.rst) both a reference to the symbol and to the name.

Thank you very much 

[*] https://github.com/python/cpython/pull/1502/

----------

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

From report at bugs.python.org  Tue May  9 15:22:55 2017
From: report at bugs.python.org (Wolfgang Maier)
Date: Tue, 09 May 2017 19:22:55 +0000
Subject: [docs] [issue30307]
 https://docs.python.org/3/tutorial/introduction.html#strings Section 3.1.2
 doc issue
In-Reply-To: <1494267982.7.0.781940622722.issue30307@psf.upfronthosting.co.za>
Message-ID: <1494357774.91.0.0435225123274.issue30307@psf.upfronthosting.co.za>


Wolfgang Maier added the comment:

The section is correct as it is. Just try it in the interactive interpreter to convince yourself.

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

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

From report at bugs.python.org  Tue May  9 15:30:34 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 09 May 2017 19:30:34 +0000
Subject: [docs] [issue30307]
 https://docs.python.org/3/tutorial/introduction.html#strings Section 3.1.2
 doc issue
In-Reply-To: <1494267982.7.0.781940622722.issue30307@psf.upfronthosting.co.za>
Message-ID: <1494358234.27.0.454577246228.issue30307@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Tue May  9 16:19:39 2017
From: report at bugs.python.org (Sam De Meyer)
Date: Tue, 09 May 2017 20:19:39 +0000
Subject: [docs] [issue30322] PyObject_GetIter does not behave as documented
 on dict objects
Message-ID: <1494361179.47.0.337252878474.issue30322@psf.upfronthosting.co.za>


New submission from Sam De Meyer:

According to the docs (https://docs.python.org/3/c-api/object.html) the `PyObject_GetIter` method should be equivalent to the python call `iter(<some_dict>)`, but, when given a dict, the `PyObject_GetIter` returns an iterator over key-value pairs whereas the `iter()` method returns an iterator over keys only.

I tripped over this when giving the `<some_dict>.update()` a dict-like object that does not inherit from the builtin dict and implements its own `__iter__()`.

The `update()` method eventually reaches the following piece of code:
https://hg.python.org/cpython/file/4243df51fe43/Objects/dictobject.c#l2383

>    it = PyObject_GetIter(seq2);
> ...
>        item = PyIter_Next(it);
> ...
>        fast = PySequence_Fast(item, "");
> ...
>        key = PySequence_Fast_GET_ITEM(fast, 0);
>        value = PySequence_Fast_GET_ITEM(fast, 1);

displaying the difference in behaviour between `PyObject_GetIter` and `iter(o)`.

----------
assignee: docs at python
components: Documentation
messages: 293346
nosy: Sam De Meyer, docs at python
priority: normal
severity: normal
status: open
title: PyObject_GetIter does not behave as documented on dict objects
versions: Python 3.6

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

From report at bugs.python.org  Tue May  9 16:35:36 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 09 May 2017 20:35:36 +0000
Subject: [docs] [issue30322] PyObject_GetIter does not behave as documented
 on dict objects
In-Reply-To: <1494361179.47.0.337252878474.issue30322@psf.upfronthosting.co.za>
Message-ID: <1494362136.53.0.534834000192.issue30322@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

I can't believe in this since one-argument iter() just calls PyObject_GetIter().

dict.update() accepts either a dict-like object (which should have the keys() method) or an iterable producing key-value pairs. If your dict-like object doesn't work as expected, check that it has the keys() method.

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

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

From report at bugs.python.org  Tue May  9 17:35:42 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Tue, 09 May 2017 21:35:42 +0000
Subject: [docs] [issue30322] PyObject_GetIter does not behave as documented
 on dict objects
In-Reply-To: <1494361179.47.0.337252878474.issue30322@psf.upfronthosting.co.za>
Message-ID: <1494365742.57.0.70039754582.issue30322@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

This from the help on dict.update():

 |  update(...)
 |      D.update([E, ]**F) -> None.  Update D from dict/iterable E and F.
 |      If E present and has a .keys() method, does:     for k in E: D[k] = E[k]
 |      If E present and lacks .keys() method, does:     for (k, v) in E: D[k] = v
 |      In either case, this is followed by: for k in F: D[k] = F[k]

Likewise in the source for collections.abc.MutableMapping:

    def update(*args, **kwds):
        ''' D.update([E, ]**F) -> None.  Update D from mapping/iterable E and F.
            If E present and has a .keys() method, does:     for k in E: D[k] = E[k]
            If E present and lacks .keys() method, does:     for (k, v) in E: D[k] = v
            In either case, this is followed by: for k, v in F.items(): D[k] = v
        '''
        if not args:
            raise TypeError("descriptor 'update' of 'MutableMapping' object "
                            "needs an argument")
        self, *args = args
        if len(args) > 1:
            raise TypeError('update expected at most 1 arguments, got %d' %
                            len(args))
        if args:
            other = args[0]
            if isinstance(other, Mapping):
                for key in other:
                    self[key] = other[key]
            elif hasattr(other, "keys"):
                for key in other.keys():
                    self[key] = other[key]
            else:
                for key, value in other:
                    self[key] = value
        for key, value in kwds.items():
            self[key] = value

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

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

From report at bugs.python.org  Wed May 10 04:50:47 2017
From: report at bugs.python.org (Berker Peksag)
Date: Wed, 10 May 2017 08:50:47 +0000
Subject: [docs] [issue29920] Document cgitb.text and cgitb.html
In-Reply-To: <1490620609.02.0.405950190914.issue29920@psf.upfronthosting.co.za>
Message-ID: <1494406247.57.0.059728002558.issue29920@psf.upfronthosting.co.za>


Changes by Berker Peksag <berker.peksag at gmail.com>:


----------
pull_requests: +1626

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

From report at bugs.python.org  Wed May 10 04:52:34 2017
From: report at bugs.python.org (Berker Peksag)
Date: Wed, 10 May 2017 08:52:34 +0000
Subject: [docs] [issue29920] Document cgitb.text and cgitb.html
In-Reply-To: <1490620609.02.0.405950190914.issue29920@psf.upfronthosting.co.za>
Message-ID: <1494406354.57.0.267562834034.issue29920@psf.upfronthosting.co.za>


Changes by Berker Peksag <berker.peksag at gmail.com>:


----------
pull_requests: +1627

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

From report at bugs.python.org  Wed May 10 05:24:52 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 10 May 2017 09:24:52 +0000
Subject: [docs] [issue29920] Document cgitb.text and cgitb.html
In-Reply-To: <1490620609.02.0.405950190914.issue29920@psf.upfronthosting.co.za>
Message-ID: <1494408292.31.0.991719442171.issue29920@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

The main functions of the cgitb module are enable() and handler(). I would describe them first, and text() and html() at the end (maybe in separate subsection). Actually the main part of the descriptions of text() and html() can be shared and placed in a paragraph preceding them: "The following two functions handle..."

Note that the documented name of the first parameter is "info", but actual name is "einfo".

----------
nosy: +martin.panter, serhiy.storchaka

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

From report at bugs.python.org  Wed May 10 10:42:58 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Wed, 10 May 2017 14:42:58 +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: <1494427378.71.0.66353501114.issue25409@psf.upfronthosting.co.za>


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


----------
pull_requests: +1634

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

From report at bugs.python.org  Wed May 10 10:57:06 2017
From: report at bugs.python.org (Florian Bruhin)
Date: Wed, 10 May 2017 14:57:06 +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: <1494428226.31.0.00522002368466.issue25409@psf.upfronthosting.co.za>


Florian Bruhin added the comment:

https://github.com/python/cpython/pull/1535 seems to be the correct PR, not 1634.

----------

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

From report at bugs.python.org  Wed May 10 11:46:35 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 10 May 2017 15:46: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: <1494431195.86.0.778508168576.issue25409@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Yes, PR 1535 is indeed linked to this issue, if you're reading it from the bug tracker.

The pull request number you see from the notification email (+1634) refers to the pull_request item in the bug tracker (https://bugs.python.org/pull_request1634).

This number is different than the pull request # on GitHub.

Hope this clarifies it :)

See also discussions about it:
https://github.com/python/core-workflow/issues/35
http://psf.upfronthosting.co.za/roundup/meta/issue624
(I was confused about it too)

----------
nosy: +Mariatta
stage: needs patch -> patch review
versions: +Python 3.7 -Python 3.4

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

From report at bugs.python.org  Wed May 10 16:49:49 2017
From: report at bugs.python.org (Sam Silberstein)
Date: Wed, 10 May 2017 20:49:49 +0000
Subject: [docs] [issue30337] Vague wording of pkgutil.walk_packages
 parameter 'prefix'
Message-ID: <1494449389.02.0.790150087603.issue30337@psf.upfronthosting.co.za>


New submission from Sam Silberstein:

Hi there! 

This is my first submission to the bug tracker, so I apologize if I'm missing some formatting here.

I've found what's either vague documentation for the 'prefix' parameter of `pgkutil.walk_packages` or a bug. The method implies that it will only import submodules of the provided path, but if the prefix parameter is not filled, this method will import a module with the same name from outside the path -- so long as it exists in `sys.modules`. I'm unsure if this is due to the documentation not specifying that prefix should always be used when path is set, or if this is a bug (I can provide a fix if it's a bug).

Steps to reproduce:

Create a directory with a nested package with the same name as a package outside that directory, e.g.:

|_ test1
  |_ __init__.py
  |_ should_not_be_included.py
|_ test2
  |_ test1
    |_ __init__.py
    |_ test1
      |_ __init__.py
      |_ should_be_included.py

`list(pkgutil.walk_packages('test2'))` will contain 'should_not_be_included.py' instead of 'should_be_included.py'.

Thank you!

Sam Silberstein

----------
assignee: docs at python
components: Documentation
messages: 293453
nosy: docs at python, smsilb
priority: normal
severity: normal
status: open
title: Vague wording of pkgutil.walk_packages parameter 'prefix'
type: behavior
versions: Python 2.7

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

From report at bugs.python.org  Wed May 10 17:21:25 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Wed, 10 May 2017 21:21:25 +0000
Subject: [docs] [issue17188] Document 'from None' in raise statement doc.
In-Reply-To: <1360631999.8.0.76627095073.issue17188@psf.upfronthosting.co.za>
Message-ID: <1494451284.87.0.416255928586.issue17188@psf.upfronthosting.co.za>


Cheryl Sabella added the comment:

Would any of the original authors be able to prepare a PR for this?  Thanks.

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

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

From report at bugs.python.org  Wed May 10 17:56:50 2017
From: report at bugs.python.org (Sam De Meyer)
Date: Wed, 10 May 2017 21:56:50 +0000
Subject: [docs] [issue30322] PyObject_GetIter does not behave as documented
 on dict objects
In-Reply-To: <1494361179.47.0.337252878474.issue30322@psf.upfronthosting.co.za>
Message-ID: <1494453410.71.0.774682159015.issue30322@psf.upfronthosting.co.za>


Sam De Meyer added the comment:

You seem to be right, my object was lacking the keys method.

Please excuse me for the false alarm, and thanks for pointing it out.

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

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

From report at bugs.python.org  Thu May 11 10:32:58 2017
From: report at bugs.python.org (Sam Silberstein)
Date: Thu, 11 May 2017 14:32:58 +0000
Subject: [docs] [issue30337] Vague wording of pkgutil.walk_packages
 parameter 'prefix'
In-Reply-To: <1494449389.02.0.790150087603.issue30337@psf.upfronthosting.co.za>
Message-ID: <1494513178.55.0.626826591014.issue30337@psf.upfronthosting.co.za>


Changes by Sam Silberstein <samuelmsilberstein at gmail.com>:


----------
components: +Library (Lib) -Documentation
versions:  -Python 2.7

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

From report at bugs.python.org  Thu May 11 10:35:17 2017
From: report at bugs.python.org (Sam Silberstein)
Date: Thu, 11 May 2017 14:35:17 +0000
Subject: [docs] [issue30337] Vague wording of pkgutil.walk_packages
 parameter 'prefix'
In-Reply-To: <1494449389.02.0.790150087603.issue30337@psf.upfronthosting.co.za>
Message-ID: <1494513317.32.0.93359914948.issue30337@psf.upfronthosting.co.za>


Sam Silberstein added the comment:

Hi there! 

This is my first submission to the bug tracker, so I apologize if I'm missing some formatting here.

I've found what's either vague documentation for the 'prefix' parameter of `pgkutil.walk_packages` or a bug. The method implies that it will only import submodules of the provided path, but if the prefix parameter is not filled, this method will import a module with the same name from outside the path -- so long as it exists in `sys.modules`. I'm unsure if this is due to the documentation not specifying that prefix should always be used when path is set, or if this is a bug (I can provide a fix if it's a bug).

Steps to reproduce:

Create a directory with a nested package with the same name as a package outside that directory, e.g.:

??? test1
?   ??? __init__.py
?   ??? should_not_be_included.py
??? test2
    ??? __init__.py
    ??? test1
        ??? __init__.py
        ??? should_be_included.py

`list(pkgutil.walk_packages(['test2']))` will contain 'should_not_be_included.py' instead of 'should_be_included.py'.

Thank you!

Sam Silberstein

----------

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

From report at bugs.python.org  Fri May 12 05:32:48 2017
From: report at bugs.python.org (STINNER Victor)
Date: Fri, 12 May 2017 09:32:48 +0000
Subject: [docs] [issue30350] devguide suggests to use VS 2008 to build
 Python 2.7, but VS 2008 is no more supported?
Message-ID: <1494581567.83.0.310363881682.issue30350@psf.upfronthosting.co.za>


New submission from STINNER Victor:

Steve Dower wrote this comment on my PR https://github.com/python/cpython/pull/1544 :

"Ah, I see. This is fine then - I have very little interest in doing much work to support the old build files (as they are explicitly unsupported)."

Copy of my reply:

"I have very little interest in doing much work to support the old build files (as they are explicitly unsupported)."

Wait wait wait... I fail to follow progress on the Windows build system, so I rely on the devguide which I expect to be up to date, and the guide says:

https://docs.python.org/devguide/setup.html#windows-compiling

"Python 2.7 uses Microsoft Visual Studio 2008, which is most easily obtained through an MSDN subscription."

I have a MSDN account, but after 30 min, I failed to get my MSDN number and I don't know my subscription is still valid or not (well, I guess that, it's expired). It took me 1 hour to find an old ISO of Visual Studio 2008, and not from microsoft.com :-(

I didn't want to install VS 2008, but I just followed the devguide.

... Do you mean that VS 2010 must now be used and the devguide is just outdated?


Moreover: we do have a buildbot using VS 2008. I'm now trying to fix all buildbots, so I had to fix issues on this VS 2008 buildbot too: http://bugs.python.org/issue30313

But I guess that it's ok to have a buildbot on a system not officially fully supported.

----------
assignee: docs at python
components: Build, Documentation, Windows
messages: 293536
nosy: docs at python, haypo, paul.moore, steve.dower, tim.golden, zach.ware
priority: normal
severity: normal
status: open
title: devguide suggests to use VS 2008 to build Python 2.7, but VS 2008 is no more supported?
versions: Python 2.7

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

From chrisc.101 at gmail.com  Wed May 10 04:59:16 2017
From: chrisc.101 at gmail.com (Chris Cummins)
Date: Wed, 10 May 2017 08:59:16 +0000
Subject: [docs] 'sort' argument to profile.runctx is undocumented
Message-ID: <CANq6S6H2=Ydx6pzPKJGG9YhLp=ye++6jyVmChu8hiBznh1oH9w@mail.gmail.com>

Hi,

The runctx function in the profile module accepts sort as an optional
keyword, but this is undocumented. The sort keyword was added in Py 3.2:
https://bugs.python.org/issue9898

It would be nice if the documentation could be updated to reflect this.

Cheers,
Chris
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170510/5f7119ba/attachment.html>

From sduncan at gsu.edu  Thu May 11 12:29:19 2017
From: sduncan at gsu.edu (Samuel Lee Duncan)
Date: Thu, 11 May 2017 16:29:19 +0000
Subject: [docs] question about the documentation
Message-ID: <BN6PR05MB306078405569BC6F6EF54AF9A1ED0@BN6PR05MB3060.namprd05.prod.outlook.com>



Your documentation states:
In addition to indexing, slicing is also supported. While indexing is used to obtain individual characters, slicing allows you to obtain substring:
>>>
>>> word[0:2]  # characters from position 0 (included) to 2 (excluded)
'Py'
>>> word[2:5]  # characters from position 2 (included) to 5 (excluded)
'tho'



However, for slicing, doesn't it appear to work better if it stated
Using 'python'  for the word.

Word[0:2]  # return 2 characters and show me the characters starting at the "0" position

-          Returns 'py'  p is position 0, and py are 2 chars
Word[2:5] # return 5 characters and show me the characters starting at the "2" position

-          Returns 'tho'  "o" is the 5th character to be returned (1-based), and "t" is the character at the "2" position (0-based)
Word[3:5]  # return 5 characters and show me the characters starting at the "3" position

-          Returns 'ho'  "o" is the 5th character to be returned (1-based) and "h" is the character at the "3" position (0-based)
Word[5:5]  # return 5 characters and show me the characters starting at the "5" position

-          Returns ' '  - this may be a bug - should throw an error saying the index has been exceeded?
Word [4:5] # return 5 characters and show me the characters starting at the "4" position

-          Returns 'o' - "o" is the 5th character to be returned (1-based) and "o" is the character at the 4th position (0-based)
Word[3:4]

-          Returns 'h' - "h" is the 4th character to be returned (1-based) and "h" is the character at the 3rd position (0-based in the original word 'python')



Sincerely,



[SamNoManagerSignature]

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170511/07291580/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image001.jpg
Type: image/jpeg
Size: 22030 bytes
Desc: image001.jpg
URL: <http://mail.python.org/pipermail/docs/attachments/20170511/07291580/attachment-0001.jpg>

From report at bugs.python.org  Fri May 12 10:29:32 2017
From: report at bugs.python.org (Jeremy Kloth)
Date: Fri, 12 May 2017 14:29:32 +0000
Subject: [docs] [issue30350] devguide suggests to use VS 2008 to build
 Python 2.7, but VS 2008 is no more supported?
In-Reply-To: <1494581567.83.0.310363881682.issue30350@psf.upfronthosting.co.za>
Message-ID: <1494599372.47.0.387644262444.issue30350@psf.upfronthosting.co.za>


Jeremy Kloth added the comment:

A few things...

First to Victor's comments on the devguide.  The following sentence after the one quoted states:

"To use the build files in the PCbuild directory you will also need Visual Studio 2010"

In short, you need *both* VS2008 and VS2010 to compile the "default" way.

Secondly, to Steve's comment on the PC\VS9.0 build files.

Normally Steve would be correct in stating that the PC\VS* directories are not maintained, however, in this case they are supported.  It is explicitly stated as such in the devguide and PCbuild\readme.txt (https://github.com/python/cpython/blob/2.7/PCbuild/readme.txt).

----------
nosy: +jkloth

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

From report at bugs.python.org  Fri May 12 12:40:59 2017
From: report at bugs.python.org (Zachary Ware)
Date: Fri, 12 May 2017 16:40:59 +0000
Subject: [docs] [issue30350] devguide suggests to use VS 2008 to build
 Python 2.7, but VS 2008 is no more supported?
In-Reply-To: <1494581567.83.0.310363881682.issue30350@psf.upfronthosting.co.za>
Message-ID: <1494607259.59.0.559879119499.issue30350@psf.upfronthosting.co.za>


Zachary Ware added the comment:

Jeremy is correct.

To further clarify, *all* 2.7 Windows builders *are* using VS 2008's compiler toolchain, but they're using VS 2015's MSBuild with VS 2010's description of 2008's compiler toolchain to build the projects described in PCbuild/.  It's a mess, but it works and makes things much easier to customize.  The two specific VS9.0 builders are using VS 2008 directly via the PC/VS9.0 build files, but ideally the output from both methods should be exactly the same.  As Jeremy pointed out, the PC/VS9.0 files are still explicitly supported, and those two builders were set up to make sure they're not broken.

Anything older than PC/VS9.0 is explicitly *un*supported, and I would have no problem with just removing them (and any support for them in sysconfig).

----------

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

From report at bugs.python.org  Fri May 12 15:40:13 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Fri, 12 May 2017 19:40:13 +0000
Subject: [docs] [issue30354] Change data model documentation to
 zero-argument super()
Message-ID: <1494618013.81.0.516656587156.issue30354@psf.upfronthosting.co.za>


New submission from Cheryl Sabella:

Update data model documentaion to reflect the zero-argument form of super().

----------
assignee: docs at python
components: Documentation
messages: 293566
nosy: csabella, docs at python
priority: normal
severity: normal
status: open
title: Change data model documentation to zero-argument super()
type: enhancement
versions: Python 3.7

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

From report at bugs.python.org  Fri May 12 15:43:53 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Fri, 12 May 2017 19:43:53 +0000
Subject: [docs] [issue30354] Change data model documentation to
 zero-argument super()
In-Reply-To: <1494618013.81.0.516656587156.issue30354@psf.upfronthosting.co.za>
Message-ID: <1494618233.6.0.0555845864757.issue30354@psf.upfronthosting.co.za>


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


----------
pull_requests: +1659

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

From report at bugs.python.org  Fri May 12 17:01:20 2017
From: report at bugs.python.org (Zachary Ware)
Date: Fri, 12 May 2017 21:01:20 +0000
Subject: [docs] [issue11681] -b option undocumented
In-Reply-To: <1301100825.87.0.69977993755.issue11681@psf.upfronthosting.co.za>
Message-ID: <1494622880.63.0.472865248208.issue11681@psf.upfronthosting.co.za>


Changes by Zachary Ware <zachary.ware at gmail.com>:


----------
pull_requests: +1660

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

From report at bugs.python.org  Fri May 12 17:39:51 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 12 May 2017 21:39:51 +0000
Subject: [docs] [issue30312] Small correction in set code sample
In-Reply-To: <1494319647.07.0.625979333092.issue30312@psf.upfronthosting.co.za>
Message-ID: <1494625191.34.0.455758132387.issue30312@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

English 'or' remains ambiguous, and often exclusive, even without 'either'.  Hence jokes like
  Parent: "Cake or pie?"
  Smart kid: "Both!"
I agree with replacing 'either' with 'or both'.

----------
nosy: +terry.reedy

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

From report at bugs.python.org  Fri May 12 17:43:23 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Fri, 12 May 2017 21:43:23 +0000
Subject: [docs] [issue30312] Small correction in set code sample
In-Reply-To: <1494319647.07.0.625979333092.issue30312@psf.upfronthosting.co.za>
Message-ID: <1494625403.09.0.589622965255.issue30312@psf.upfronthosting.co.za>


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


----------
versions:  -Python 3.5

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

From report at bugs.python.org  Fri May 12 18:11:50 2017
From: report at bugs.python.org (STINNER Victor)
Date: Fri, 12 May 2017 22:11:50 +0000
Subject: [docs] [issue30350] devguide suggests to use VS 2008 to build
 Python 2.7, but VS 2008 is no more supported?
In-Reply-To: <1494607259.59.0.559879119499.issue30350@psf.upfronthosting.co.za>
Message-ID: <CAMpsgwa0FMsE1Xx1g=8g5diC+8Htq7VVyF1yWFyWX82Spf99TQ@mail.gmail.com>


STINNER Victor added the comment:

Anyway, I fixed some issues specific to VS9.0 recently, so things
should be a little bit better now :-)

For me, the last annoying issue is bpo-30313: re-run failed tests in
verbose mode. I will try to implement proposed solution.

----------

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

From report at bugs.python.org  Fri May 12 20:58:34 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Sat, 13 May 2017 00:58:34 +0000
Subject: [docs] [issue30358] Profile documentation - include sort argument
 for runctx
Message-ID: <1494637114.79.0.498202209221.issue30358@psf.upfronthosting.co.za>


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


----------
assignee: docs at python
components: Documentation
nosy: csabella, docs at python
priority: normal
severity: normal
status: open
title: Profile documentation - include sort argument for runctx
type: enhancement
versions: Python 3.7

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

From report at bugs.python.org  Fri May 12 21:00:25 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Sat, 13 May 2017 01:00:25 +0000
Subject: [docs] [issue30358] Profile documentation - include sort argument
 for runctx
Message-ID: <1494637225.79.0.293782235994.issue30358@psf.upfronthosting.co.za>


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


----------
pull_requests: +1661

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

From report at bugs.python.org  Sat May 13 10:30:23 2017
From: report at bugs.python.org (Zachary Ware)
Date: Sat, 13 May 2017 14:30:23 +0000
Subject: [docs] [issue11681] -b option undocumented
In-Reply-To: <1301100825.87.0.69977993755.issue11681@psf.upfronthosting.co.za>
Message-ID: <1494685822.88.0.84920097418.issue11681@psf.upfronthosting.co.za>


Zachary Ware added the comment:


New changeset f6c6d1e2304a06efdf65c60c3e1c6bbe1f192fd0 by Zachary Ware in branch '2.7':
bpo-11681: Document the `-b` and `-bb` options (GH-1562)
https://github.com/python/cpython/commit/f6c6d1e2304a06efdf65c60c3e1c6bbe1f192fd0


----------
nosy: +zach.ware

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

From report at bugs.python.org  Sat May 13 10:46:56 2017
From: report at bugs.python.org (Zachary Ware)
Date: Sat, 13 May 2017 14:46:56 +0000
Subject: [docs] [issue11681] -b option undocumented
In-Reply-To: <1301100825.87.0.69977993755.issue11681@psf.upfronthosting.co.za>
Message-ID: <1494686816.68.0.33362747235.issue11681@psf.upfronthosting.co.za>


Zachary Ware added the comment:

Thanks for the patch, Greg!  I implemented Nick's suggestions and merged it.

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

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

From report at bugs.python.org  Sat May 13 11:19:56 2017
From: report at bugs.python.org (Jim Fasarakis-Hilliard)
Date: Sat, 13 May 2017 15:19:56 +0000
Subject: [docs] [issue30178] Indent methods and attributes of MimeTypes class
In-Reply-To: <1493226814.74.0.770717289652.issue30178@psf.upfronthosting.co.za>
Message-ID: <1494688796.74.0.469231800114.issue30178@psf.upfronthosting.co.za>


Jim Fasarakis-Hilliard added the comment:

bump

----------

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

From report at bugs.python.org  Sat May 13 12:32:41 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 13 May 2017 16:32:41 +0000
Subject: [docs] [issue30178] Indent methods and attributes of MimeTypes class
In-Reply-To: <1493226814.74.0.770717289652.issue30178@psf.upfronthosting.co.za>
Message-ID: <1494693161.44.0.206057194896.issue30178@psf.upfronthosting.co.za>


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


----------
stage:  -> patch review
versions: +Python 2.7, Python 3.5, Python 3.6

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

From report at bugs.python.org  Sat May 13 12:34:30 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 13 May 2017 16:34:30 +0000
Subject: [docs] [issue30178] Indent methods and attributes of MimeTypes class
In-Reply-To: <1493226814.74.0.770717289652.issue30178@psf.upfronthosting.co.za>
Message-ID: <1494693270.08.0.258940960724.issue30178@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset c71168090df435c1eb8c03005b11df764cd7ebd6 by Mariatta (Jim Fasarakis-Hilliard) in branch 'master':
bpo-30178: Indent methods and attributes of MimeType class (GH-1306)
https://github.com/python/cpython/commit/c71168090df435c1eb8c03005b11df764cd7ebd6


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

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

From report at bugs.python.org  Sat May 13 12:34:57 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 13 May 2017 16:34:57 +0000
Subject: [docs] [issue30178] Indent methods and attributes of MimeTypes class
In-Reply-To: <1493226814.74.0.770717289652.issue30178@psf.upfronthosting.co.za>
Message-ID: <1494693297.83.0.888782092889.issue30178@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/issue30178>
_______________________________________

From report at bugs.python.org  Sat May 13 12:42:41 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 13 May 2017 16:42:41 +0000
Subject: [docs] [issue30178] Indent methods and attributes of MimeTypes class
In-Reply-To: <1493226814.74.0.770717289652.issue30178@psf.upfronthosting.co.za>
Message-ID: <1494693761.03.0.43821922014.issue30178@psf.upfronthosting.co.za>


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


----------
pull_requests: +1665

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

From report at bugs.python.org  Sat May 13 12:45:16 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 13 May 2017 16:45:16 +0000
Subject: [docs] [issue30178] Indent methods and attributes of MimeTypes class
In-Reply-To: <1493226814.74.0.770717289652.issue30178@psf.upfronthosting.co.za>
Message-ID: <1494693916.0.0.967669479451.issue30178@psf.upfronthosting.co.za>


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


----------
pull_requests: +1666

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

From report at bugs.python.org  Sat May 13 12:49:29 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 13 May 2017 16:49:29 +0000
Subject: [docs] [issue30178] Indent methods and attributes of MimeTypes class
In-Reply-To: <1493226814.74.0.770717289652.issue30178@psf.upfronthosting.co.za>
Message-ID: <1494694169.15.0.709697607598.issue30178@psf.upfronthosting.co.za>


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


----------
pull_requests: +1667

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

From report at bugs.python.org  Sat May 13 12:59:10 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 13 May 2017 16:59:10 +0000
Subject: [docs] [issue30178] Indent methods and attributes of MimeTypes class
In-Reply-To: <1493226814.74.0.770717289652.issue30178@psf.upfronthosting.co.za>
Message-ID: <1494694750.18.0.824760553552.issue30178@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 600c5ad53c0112d48581c48f986ea04676a28c44 by Mariatta in branch 'master':
bpo-30178: Add Jim Fasarakis-Hilliard to Misc/ACKS (GH-1572)
https://github.com/python/cpython/commit/600c5ad53c0112d48581c48f986ea04676a28c44


----------

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

From report at bugs.python.org  Sat May 13 14:46:13 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 13 May 2017 18:46:13 +0000
Subject: [docs] [issue30178] Indent methods and attributes of MimeTypes class
In-Reply-To: <1493226814.74.0.770717289652.issue30178@psf.upfronthosting.co.za>
Message-ID: <1494701173.81.0.3677770811.issue30178@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Jim, are you up for preparing the backport to 2.7?
I came across a conflict while doing so with cherry_picker.py, and don't have the bandwidth to resolve it for now.
Otherwise, I'll look into the 2.7 backport after PyCon.
Thanks :)

----------

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

From report at bugs.python.org  Sun May 14 01:46:41 2017
From: report at bugs.python.org (Berker Peksag)
Date: Sun, 14 May 2017 05:46:41 +0000
Subject: [docs] [issue29898] PYTHONLEGACYWINDOWSIOENCODING isn't implemented
In-Reply-To: <1490394843.09.0.467635996133.issue29898@psf.upfronthosting.co.za>
Message-ID: <1494740801.29.0.80127455663.issue29898@psf.upfronthosting.co.za>


Changes by Berker Peksag <berker.peksag at gmail.com>:


----------
pull_requests: +1669

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

From report at bugs.python.org  Sun May 14 02:52:15 2017
From: report at bugs.python.org (Berker Peksag)
Date: Sun, 14 May 2017 06:52:15 +0000
Subject: [docs] [issue30358] Profile documentation - include sort argument
 for runctx
Message-ID: <1494744735.45.0.395374110281.issue30358@psf.upfronthosting.co.za>


New submission from Berker Peksag:

For future reference, this was also reported by Chris Cummins on docs at p.o at https://mail.python.org/pipermail/docs/2017-May/031420.html

----------
nosy: +berker.peksag
stage:  -> patch review
versions: +Python 3.5, Python 3.6

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

From report at bugs.python.org  Sun May 14 03:02:41 2017
From: report at bugs.python.org (Berker Peksag)
Date: Sun, 14 May 2017 07:02:41 +0000
Subject: [docs] [issue30358] Profile documentation - include sort argument
 for runctx
In-Reply-To: <1494744735.45.0.395374110281.issue30358@psf.upfronthosting.co.za>
Message-ID: <1494745360.98.0.357937042128.issue30358@psf.upfronthosting.co.za>


Berker Peksag added the comment:


New changeset 99776296230ddd8429ebad2d07854b8c27ea10ab by Berker Peksag (csabella) in branch 'master':
bpo-30358: Document sort argument of profile.runctx() (GH-1566)
https://github.com/python/cpython/commit/99776296230ddd8429ebad2d07854b8c27ea10ab


----------

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

From report at bugs.python.org  Sun May 14 03:03:08 2017
From: report at bugs.python.org (Berker Peksag)
Date: Sun, 14 May 2017 07:03:08 +0000
Subject: [docs] [issue30358] Profile documentation - include sort argument
 for runctx
In-Reply-To: <1494744735.45.0.395374110281.issue30358@psf.upfronthosting.co.za>
Message-ID: <1494745388.24.0.560910159073.issue30358@psf.upfronthosting.co.za>


Changes by Berker Peksag <berker.peksag at gmail.com>:


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

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

From berker.peksag at gmail.com  Sun May 14 03:03:56 2017
From: berker.peksag at gmail.com (=?UTF-8?Q?Berker_Peksa=C4=9F?=)
Date: Sun, 14 May 2017 10:03:56 +0300
Subject: [docs] 'sort' argument to profile.runctx is undocumented
In-Reply-To: <CANq6S6H2=Ydx6pzPKJGG9YhLp=ye++6jyVmChu8hiBznh1oH9w@mail.gmail.com>
References: <CANq6S6H2=Ydx6pzPKJGG9YhLp=ye++6jyVmChu8hiBznh1oH9w@mail.gmail.com>
Message-ID: <CAF4280LNPahZC+p8RhQPMDNxzO9asYoEEu4pHD7U2oVCZCL3Qw@mail.gmail.com>

On Wed, May 10, 2017 at 11:59 AM, Chris Cummins <chrisc.101 at gmail.com> wrote:
> Hi,
>
> The runctx function in the profile module accepts sort as an optional
> keyword, but this is undocumented. The sort keyword was added in Py 3.2:
> https://bugs.python.org/issue9898
>
> It would be nice if the documentation could be updated to reflect this.

Thanks for the report, Chris. This is now done in
http://bugs.python.org/issue30358

--Berker

From report at bugs.python.org  Sun May 14 05:08:39 2017
From: report at bugs.python.org (Mihai Borobocea)
Date: Sun, 14 May 2017 09:08:39 +0000
Subject: [docs] [issue30361] Docs example: converting mixed types to
 floating point
Message-ID: <1494752919.15.0.561616045601.issue30361@psf.upfronthosting.co.za>


New submission from Mihai Borobocea:

Section 3.1.1 in the Docs states:
"operators with mixed type operands convert the integer operand to floating point"
https://docs.python.org/3/tutorial/introduction.html

But gives an example using the division operator:
>>> 3 * 3.75 / 1.5
7.5
>>> 7.0 / 2
3.5

In Python 3, division always returns a float, e.g. when all operands are integers:
>>> 3 * 3 / 1
9.0
>>> 7 / 2
3.5

To illustrate that "operators with mixed type operands convert the integer operand to floating point" the example should not use division. For example:
>>> 3 * 3.75 - 1
10.25
>>> 7.0 + 2
9.0

----------
assignee: docs at python
components: Documentation
messages: 293641
nosy: MihaiHimself, docs at python
priority: normal
severity: normal
status: open
title: Docs example: converting mixed types to floating point
versions: Python 3.6, Python 3.7

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

From report at bugs.python.org  Sun May 14 09:45:04 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sun, 14 May 2017 13:45:04 +0000
Subject: [docs] [issue30361] Docs example: converting mixed types to
 floating point
In-Reply-To: <1494752919.15.0.561616045601.issue30361@psf.upfronthosting.co.za>
Message-ID: <1494769504.48.0.393515852675.issue30361@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sun May 14 10:59:36 2017
From: report at bugs.python.org (Berker Peksag)
Date: Sun, 14 May 2017 14:59:36 +0000
Subject: [docs] [issue30358] Profile documentation - include sort argument
 for runctx
In-Reply-To: <1494744735.45.0.395374110281.issue30358@psf.upfronthosting.co.za>
Message-ID: <1494773976.74.0.931312585718.issue30358@psf.upfronthosting.co.za>


Changes by Berker Peksag <berker.peksag at gmail.com>:


----------
pull_requests: +1672

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

From report at bugs.python.org  Sun May 14 11:00:52 2017
From: report at bugs.python.org (Berker Peksag)
Date: Sun, 14 May 2017 15:00:52 +0000
Subject: [docs] [issue30358] Profile documentation - include sort argument
 for runctx
In-Reply-To: <1494744735.45.0.395374110281.issue30358@psf.upfronthosting.co.za>
Message-ID: <1494774052.89.0.501400315827.issue30358@psf.upfronthosting.co.za>


Changes by Berker Peksag <berker.peksag at gmail.com>:


----------
pull_requests: +1673

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

From report at bugs.python.org  Sun May 14 11:30:50 2017
From: report at bugs.python.org (Berker Peksag)
Date: Sun, 14 May 2017 15:30:50 +0000
Subject: [docs] [issue30358] Profile documentation - include sort argument
 for runctx
In-Reply-To: <1494744735.45.0.395374110281.issue30358@psf.upfronthosting.co.za>
Message-ID: <1494775850.7.0.566435308887.issue30358@psf.upfronthosting.co.za>


Berker Peksag added the comment:


New changeset 61b6e5cf929a80bb44500fb1a212facf66d7f45c by Berker Peksag in branch '3.6':
bpo-30358: Document sort argument of profile.runctx() (GH-1566)
https://github.com/python/cpython/commit/61b6e5cf929a80bb44500fb1a212facf66d7f45c


----------

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

From report at bugs.python.org  Sun May 14 11:31:34 2017
From: report at bugs.python.org (Berker Peksag)
Date: Sun, 14 May 2017 15:31:34 +0000
Subject: [docs] [issue30358] Profile documentation - include sort argument
 for runctx
In-Reply-To: <1494744735.45.0.395374110281.issue30358@psf.upfronthosting.co.za>
Message-ID: <1494775894.87.0.534305959283.issue30358@psf.upfronthosting.co.za>


Berker Peksag added the comment:


New changeset f3291eeb90da2ddb37efea30dfc9406983b0f681 by Berker Peksag in branch '3.5':
bpo-30358: Document sort argument of profile.runctx() (GH-1566)
https://github.com/python/cpython/commit/f3291eeb90da2ddb37efea30dfc9406983b0f681


----------

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

From report at bugs.python.org  Sun May 14 11:31:58 2017
From: report at bugs.python.org (Berker Peksag)
Date: Sun, 14 May 2017 15:31:58 +0000
Subject: [docs] [issue30358] Profile documentation - include sort argument
 for runctx
In-Reply-To: <1494744735.45.0.395374110281.issue30358@psf.upfronthosting.co.za>
Message-ID: <1494775918.7.0.376060320235.issue30358@psf.upfronthosting.co.za>


Changes by Berker Peksag <berker.peksag at gmail.com>:


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

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

From report at bugs.python.org  Sun May 14 21:45:21 2017
From: report at bugs.python.org (Jeremy Kloth)
Date: Mon, 15 May 2017 01:45:21 +0000
Subject: [docs] [issue30350] devguide suggests to use VS 2008 to build
 Python 2.7, but VS 2008 is no more supported?
In-Reply-To: <1494581567.83.0.310363881682.issue30350@psf.upfronthosting.co.za>
Message-ID: <1494812721.5.0.127645076075.issue30350@psf.upfronthosting.co.za>


Jeremy Kloth added the comment:

Now that my buildbot is back online, there is one unresolved issue pertaining to using VS9.0 only for building.  That is building without Perl.  It was a supported feature prior to backporting the MSBuild toolchain.  With recent OpenSSL releases, without Perl is no longer functional.

I have a changeset that restores this ability, but would like to know if that change was intentional, or just missed due to not having any buildbots covering VS9.0-only builds.

----------

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

From report at bugs.python.org  Sun May 14 23:42:02 2017
From: report at bugs.python.org (Nick Coghlan)
Date: Mon, 15 May 2017 03:42:02 +0000
Subject: [docs] [issue30354] Change data model documentation to
 zero-argument super()
In-Reply-To: <1494618013.81.0.516656587156.issue30354@psf.upfronthosting.co.za>
Message-ID: <1494819722.55.0.729241919753.issue30354@psf.upfronthosting.co.za>


Nick Coghlan added the comment:


New changeset 12b1c180986fc744331b8f30d3d2f49a0fdb43dd by Nick Coghlan (csabella) in branch 'master':
bpo-30354: Update data model documentation for super() (GH-1561)
https://github.com/python/cpython/commit/12b1c180986fc744331b8f30d3d2f49a0fdb43dd


----------
nosy: +ncoghlan

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

From report at bugs.python.org  Sun May 14 23:50:26 2017
From: report at bugs.python.org (Zachary Ware)
Date: Mon, 15 May 2017 03:50:26 +0000
Subject: [docs] [issue30350] devguide suggests to use VS 2008 to build
 Python 2.7, but VS 2008 is no more supported?
In-Reply-To: <1494581567.83.0.310363881682.issue30350@psf.upfronthosting.co.za>
Message-ID: <1494820226.33.0.157756309286.issue30350@psf.upfronthosting.co.za>


Zachary Ware added the comment:

> I have a changeset that restores this ability, but would like to know if 
> that change was intentional, or just missed due to not having any buildbots 
> covering VS9.0-only builds.

It was intentional; it was more effort than I wanted to put in to get newer OpenSSL to work with both the new build scripts and the old method, so I figured installing Perl wasn't the worst thing in the world for those who wanted to use the VS9.0 files.  If your patch isn't too big or invasive, I'd be fine with applying it, though.

----------

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

From songofacandy at gmail.com  Mon May 15 04:05:35 2017
From: songofacandy at gmail.com (INADA Naoki)
Date: Mon, 15 May 2017 17:05:35 +0900
Subject: [docs] I would like to contribute to the Python documentation
In-Reply-To: <CAKmm7v=gfTGeNga1X6+EG6+LoOq41sOobgCEcXzmtSH85A7xeA@mail.gmail.com>
References: <CAKmm7v=gfTGeNga1X6+EG6+LoOq41sOobgCEcXzmtSH85A7xeA@mail.gmail.com>
Message-ID: <CAEfz+TxcEi39sMAMMwY6tHn16v_VdmPpAnysFBCfzgQx5PzFZg@mail.gmail.com>

Hi, Gustavo.

I'm grad to hear that you're interested in translating Python document.

Julien Palard is working on making doc translation easier.
Please see PEP 545 (https://www.python.org/dev/peps/pep-0545/ )

If you're happy about your translation is redistributed in OSS license,
you can start translating on Transifex without waiting PEP 545 is accepted.
https://www.transifex.com/python-doc/python-36/dashboard/

I want to assign you as a coordinator of Portuguese.

But I'm not familiar with Portuguese.
There are pt_BR and pt_PT in Python project on Transifex.  (Both are inactive).
Are they different language like cn_TW and cn_ZH?
Which language do you want to lead? pt_PT, pt_BR or pt?

Regards,


On Wed, May 10, 2017 at 12:12 AM, Gustavo Toffo <gustavotoffo at gmail.com> wrote:
> Hello!
>
> I would like to contribute to the wonderful language that is Python.
>
> I've noticed that the portuguese documentation of Python is either severely
> lacking or not updated.
>
> I would like to help out and offer to translate the documentation and
> provide working resources, whether updated examples, books that are updated,
> including books of my own, all in the documentation to better help teach
> Python.
>
> I will do the work for free although I would very much appreciate some
> mention of my contribution. My primary concern is in making sure that Python
> reaches as many people as possible with the best quality that it can.
>
> I want to eventually translate the whole website in order to make it
> available to the Portuguese speaking audiences (of which I'm a native)
>
> I'm sending along a 3 page sample of my work. I've translated the beginner's
> guide and purposefuly left at the side some of the original text just so you
> can be assured of my quality of work.
>
> Thank you for all your efforts in this wonderful language
>
> Grandes abra?os!
>
>
>
> _______________________________________________
> docs mailing list
> docs at python.org
> https://mail.python.org/mailman/listinfo/docs
>

From report at bugs.python.org  Mon May 15 04:40:58 2017
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 15 May 2017 08:40:58 +0000
Subject: [docs] [issue30350] devguide suggests to use VS 2008 to build
 Python 2.7, but VS 2008 is no more supported?
In-Reply-To: <1494581567.83.0.310363881682.issue30350@psf.upfronthosting.co.za>
Message-ID: <1494837658.53.0.17257487552.issue30350@psf.upfronthosting.co.za>


STINNER Victor added the comment:

"To further clarify, *all* 2.7 Windows builders *are* using VS 2008's compiler toolchain, but they're using VS 2015's MSBuild with VS 2010's description of 2008's compiler toolchain to build the projects described in PCbuild/."

Wait? Why not suggesting to use this recent VS 2015 if it's supported? It's a pain to try to install VS 2008 in 2017: it disappeared from microsoft.com, at least the Express edition. Moreover, it becomes more and more clear that VS 2008 has a worse support than the PCbuild directory.

So why not updating the devguide to suggest first to use the PCbuild directory using VS 2010 or newer? Are the latest VS version able to use PCbuild of Python 2.7?

----------

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

From report at bugs.python.org  Mon May 15 04:48:02 2017
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 15 May 2017 08:48:02 +0000
Subject: [docs] [issue30350] devguide suggests to use VS 2008 to build
 Python 2.7, but VS 2008 is no more supported?
In-Reply-To: <1494581567.83.0.310363881682.issue30350@psf.upfronthosting.co.za>
Message-ID: <1494838082.71.0.279549683131.issue30350@psf.upfronthosting.co.za>


STINNER Victor added the comment:

> Now that my buildbot is back online, there is one unresolved issue pertaining to using VS9.0 only for building.  That is building without Perl.  It was a supported feature prior to backporting the MSBuild toolchain.  With recent OpenSSL releases, without Perl is no longer functional.

I opened bpo-30368 to track this issue.

----------

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

From songofacandy at gmail.com  Mon May 15 06:22:20 2017
From: songofacandy at gmail.com (INADA Naoki)
Date: Mon, 15 May 2017 19:22:20 +0900
Subject: [docs] I would like to contribute to the Python documentation
In-Reply-To: <CAKmm7v=DW_c7ePkBP6+wNoJMCX-eapF76aWNvx+mL-VZdphFyA@mail.gmail.com>
References: <CAKmm7v=gfTGeNga1X6+EG6+LoOq41sOobgCEcXzmtSH85A7xeA@mail.gmail.com>
 <CAEfz+TxcEi39sMAMMwY6tHn16v_VdmPpAnysFBCfzgQx5PzFZg@mail.gmail.com>
 <CAKmm7v=DW_c7ePkBP6+wNoJMCX-eapF76aWNvx+mL-VZdphFyA@mail.gmail.com>
Message-ID: <CAEfz+TyvGwPFROyQ7ZByXNwQGn5LjQh63=8k_PTrgJ3acD=ZHg@mail.gmail.com>

On Mon, May 15, 2017 at 6:54 PM, Gustavo Toffo <gustavotoffo at gmail.com> wrote:
> I'd be more than happy to be the coordinator on the Portuguese language
> section
>
> And honestly, there aren't major differences between brazil's and portugal's
> portuguese. You can think of it like british and american english, although
> there are some difference in words, meanings and expressions, the flow of
> the language tends to be the same, and since I was born and raised in
> portugal by my mostly brazilian family I'm well acquainted with all the
> proper terms of both accents.
>
> But if I had to make a choice it'd be pt_br while making sure the terms are
> understood by pt_pt.

There is `pt` language which is not activated yet.
Which do you prefer? `pt` or `pt_BR`?

>
> Also, I'd be more than happy that my translation is redistributed in OSS
> license
>
> All I'd like is basically the following;
>
> - To have my name and e-mail contact on the translation so people know who
> the translator is and who to contact and so on
>

See this page: https://docs.python.org/3/about.html#contributors-to-the-python-documentation

I think all contributors will be listed somewhere like that.
But we're in planning phase.  There are no actual translated page
under docs.python.org yet.

Of course, you can build translated document from source and Transifex
by yourself
and publish it under PSF license.


> - To have a link (even if it's a website I myself create which wouldn't be
> much of a problem) to books both free and paid on how to learn Python (since
> I think you can agree that learning Python by the syntax itself is a bit too
> abstract) and for more advanced topic such as machine learning and so on.
>
> Can I do this with the OSS license? Thank you
>

Maybe, docs hosted under docs.python.org will be
"sentense-by-sentense" translation.
But you can build customized version and publish it by yourself too.

>
> 2017-05-15 5:05 GMT-03:00 INADA Naoki <songofacandy at gmail.com>:
>>
>> Hi, Gustavo.
>>
>> I'm grad to hear that you're interested in translating Python document.
>>
>> Julien Palard is working on making doc translation easier.
>> Please see PEP 545 (https://www.python.org/dev/peps/pep-0545/ )
>>
>> If you're happy about your translation is redistributed in OSS license,
>> you can start translating on Transifex without waiting PEP 545 is
>> accepted.
>> https://www.transifex.com/python-doc/python-36/dashboard/
>>
>> I want to assign you as a coordinator of Portuguese.
>>
>> But I'm not familiar with Portuguese.
>> There are pt_BR and pt_PT in Python project on Transifex.  (Both are
>> inactive).
>> Are they different language like cn_TW and cn_ZH?
>> Which language do you want to lead? pt_PT, pt_BR or pt?
>>
>> Regards,
>>
>>
>> On Wed, May 10, 2017 at 12:12 AM, Gustavo Toffo <gustavotoffo at gmail.com>
>> wrote:
>> > Hello!
>> >
>> > I would like to contribute to the wonderful language that is Python.
>> >
>> > I've noticed that the portuguese documentation of Python is either
>> > severely
>> > lacking or not updated.
>> >
>> > I would like to help out and offer to translate the documentation and
>> > provide working resources, whether updated examples, books that are
>> > updated,
>> > including books of my own, all in the documentation to better help teach
>> > Python.
>> >
>> > I will do the work for free although I would very much appreciate some
>> > mention of my contribution. My primary concern is in making sure that
>> > Python
>> > reaches as many people as possible with the best quality that it can.
>> >
>> > I want to eventually translate the whole website in order to make it
>> > available to the Portuguese speaking audiences (of which I'm a native)
>> >
>> > I'm sending along a 3 page sample of my work. I've translated the
>> > beginner's
>> > guide and purposefuly left at the side some of the original text just so
>> > you
>> > can be assured of my quality of work.
>> >
>> > Thank you for all your efforts in this wonderful language
>> >
>> > Grandes abra?os!
>> >
>> >
>> >
>> > _______________________________________________
>> > docs mailing list
>> > docs at python.org
>> > https://mail.python.org/mailman/listinfo/docs
>> >
>
>

From report at bugs.python.org  Mon May 15 06:42:23 2017
From: report at bugs.python.org (Jeremy Kloth)
Date: Mon, 15 May 2017 10:42:23 +0000
Subject: [docs] [issue30350] devguide suggests to use VS 2008 to build
 Python 2.7, but VS 2008 is no more supported?
In-Reply-To: <1494581567.83.0.310363881682.issue30350@psf.upfronthosting.co.za>
Message-ID: <1494844943.39.0.169516455986.issue30350@psf.upfronthosting.co.za>


Jeremy Kloth added the comment:

> Wait? Why not suggesting to use this recent VS 2015 if it's
> supported?

In theory it is supported, yes.  However, it is not compatible with previous C runtimes.  Meaning things like memory allocation (malloc) and file pointers (FILE *) wouldn't play nice in extensions compiled against the 2008 toolchain (everything on PyPI).

> It's a pain to try to install VS 2008 in 2017: it disappeared from
> microsoft.com, at least the Express edition.

I believe that is why Microsoft released the Visual C++ Compiler for Python 2.7 (https://www.microsoft.com/en-us/download/details.aspx?id=44266) although, if memory serves, there is some issue with the 64-bit toolchain.

> Moreover, it becomes more and more clear that VS 2008 has a worse
> support than the PCbuild directory.

I guess that is why this bug report exists ;)  Seriously, though, that is why we recently added the VS9.0 builders.

> So why not updating the devguide to suggest first to use the
> PCbuild directory using VS 2010 or newer? Are the latest VS
> version able to use PCbuild of Python 2.7?

See above.  You can, but then your built Python is incompatible with the world.

----------

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

From report at bugs.python.org  Mon May 15 09:05:46 2017
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 15 May 2017 13:05:46 +0000
Subject: [docs] [issue30350] devguide suggests to use VS 2008 to build
 Python 2.7, but VS 2008 is no more supported?
In-Reply-To: <1494844943.39.0.169516455986.issue30350@psf.upfronthosting.co.za>
Message-ID: <CAMpsgwaU1wx-t7t7Q8Yh7JLSA_ECB6_z4thNxMAsgvHgqKKZ9Q@mail.gmail.com>


STINNER Victor added the comment:

> I believe that is why Microsoft released the Visual C++ Compiler for Python 2.7 (https://www.microsoft.com/en-us/download/details.aspx?id=44266) although, if memory serves, there is some issue with the 64-bit toolchain.

Oh, I recall an announcement about that, but I don't see the link on
the devguide. It should be added.

----------

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

From report at bugs.python.org  Mon May 15 09:14:11 2017
From: report at bugs.python.org (Eryk Sun)
Date: Mon, 15 May 2017 13:14:11 +0000
Subject: [docs] [issue30350] devguide suggests to use VS 2008 to build
 Python 2.7, but VS 2008 is no more supported?
In-Reply-To: <1494581567.83.0.310363881682.issue30350@psf.upfronthosting.co.za>
Message-ID: <1494854051.39.0.844829094074.issue30350@psf.upfronthosting.co.za>


Eryk Sun added the comment:

>> It's a pain to try to install VS 2008 in 2017: it disappeared from
>> microsoft.com, at least the Express edition.

> I believe that is why Microsoft released the Visual C++ Compiler for 
> Python 2.7 
> (https://www.microsoft.com/en-us/download/details.aspx?id=44266) 
> although, if memory serves, there is some issue with the 64-bit
> toolchain.

That release is intended for building extension modules. Is it possible to configure it for building CPython?

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

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

From report at bugs.python.org  Mon May 15 12:20:38 2017
From: report at bugs.python.org (Malcolm Smith)
Date: Mon, 15 May 2017 16:20:38 +0000
Subject: [docs] [issue30372] Status of __builtins__ is not totally clear
Message-ID: <1494865238.41.0.458723699483.issue30372@psf.upfronthosting.co.za>


New submission from Malcolm Smith:

https://docs.python.org/3.6/reference/executionmodel.html#builtins-and-restricted-execution describes the various things you can do with __builtins__, but then says "Users should not touch __builtins__; it is strictly an implementation detail." If this is so, the entire section should be marked "CPython implementation detail", not just that last paragraph.

Elsewhere, https://docs.python.org/3.6/reference/import.html#replacing-the-standard-import-system suggests that the __import__ function could be replaced "at the module level to only alter the behaviour of import statements within that module". Is there any way of doing this other than manipulating the module's __builtins__? If not, this is encouraging the programmer to rely on a CPython implementation detail without marking it as such.

----------
assignee: docs at python
components: Documentation
messages: 293722
nosy: Malcolm Smith, docs at python
priority: normal
severity: normal
status: open
title: Status of __builtins__ is not totally clear
versions: Python 3.6

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

From report at bugs.python.org  Mon May 15 13:33:23 2017
From: report at bugs.python.org (Jakub Wilk)
Date: Mon, 15 May 2017 17:33:23 +0000
Subject: [docs] [issue30373] Incomplete description of re.LOCALE
Message-ID: <1494869603.65.0.652150578672.issue30373@psf.upfronthosting.co.za>


New submission from Jakub Wilk:

<https://docs.python.org/3/library/re.html#re.LOCALE> reads:
"Make \w, \W, \b, \B, \s and \S dependent on the current locale."

But this is not the only thing this flag does. When combined with re.IGNORECASE,  it also makes case-insesitive matching locale-dependent.

----------
assignee: docs at python
components: Documentation
messages: 293726
nosy: docs at python, jwilk
priority: normal
severity: normal
status: open
title: Incomplete description of re.LOCALE

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

From report at bugs.python.org  Mon May 15 14:43:03 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 15 May 2017 18:43:03 +0000
Subject: [docs] [issue30373] Incomplete description of re.LOCALE
In-Reply-To: <1494869603.65.0.652150578672.issue30373@psf.upfronthosting.co.za>
Message-ID: <1494873783.46.0.125322089257.issue30373@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

This looks similar to issue24896. Closing this issue as a duplicate since it is makes large sense to merge these two documentation changes.

----------
nosy: +serhiy.storchaka
resolution:  -> fixed
stage:  -> resolved
status: open -> closed
superseder:  -> It is undocumented that re.UNICODE affects re.IGNORECASE

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

From report at bugs.python.org  Mon May 15 14:48:04 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 15 May 2017 18:48:04 +0000
Subject: [docs] [issue24896] It is undocumented that re.UNICODE and
 re.LOCALE affect re.IGNORECASE
In-Reply-To: <1439987891.31.0.547960058443.issue24896@psf.upfronthosting.co.za>
Message-ID: <1494874084.09.0.827115965029.issue24896@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

As was reported in issue30373 there is the same issue with re.LOCALE.

This documentation issue should be easy for everyone who is fluent in English and familiar with the re module.

----------
keywords: +easy
nosy: +serhiy.storchaka
title: It is undocumented that re.UNICODE affects re.IGNORECASE -> It is undocumented that re.UNICODE and re.LOCALE affect re.IGNORECASE

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

From report at bugs.python.org  Mon May 15 14:51:23 2017
From: report at bugs.python.org (Jakub Wilk)
Date: Mon, 15 May 2017 18:51:23 +0000
Subject: [docs] [issue24896] It is undocumented that re.UNICODE and
 re.LOCALE affect re.IGNORECASE
In-Reply-To: <1439987891.31.0.547960058443.issue24896@psf.upfronthosting.co.za>
Message-ID: <1494874283.86.0.668162326337.issue24896@psf.upfronthosting.co.za>


Changes by Jakub Wilk <jwilk at jwilk.net>:


----------
nosy: +jwilk

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

From report at bugs.python.org  Mon May 15 15:45:51 2017
From: report at bugs.python.org (Steve Dower)
Date: Mon, 15 May 2017 19:45:51 +0000
Subject: [docs] [issue30350] devguide suggests to use VS 2008 to build
 Python 2.7, but VS 2008 is no more supported?
In-Reply-To: <1494581567.83.0.310363881682.issue30350@psf.upfronthosting.co.za>
Message-ID: <1494877551.36.0.16554798022.issue30350@psf.upfronthosting.co.za>


Steve Dower added the comment:

> That release is intended for building extension modules. Is it possible to configure it for building CPython

It's intended for extension modules, but should be usable for building CPython itself if someone wants to take the time to update the Python 2.7 build system to use it. (Also, there's nothing wrong with the 64-bit toolset in this installer - that was the Windows SDK version of the compilers.)

The main reason you can't use it is because our build system is MSBuild based and the compiler package does not register with MSBuild (it doesn't provide a Platform Toolset). It would be possible to write one that would work, though I don't know exactly how to do it - I believe ICC and clang both provide the required files though, so it may be relatively easy to add the toolset files into our source repo and make it work.

There are likely some other reasons that the build will fail, but those can likely be worked around within the source repository.

----------

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

From report at bugs.python.org  Mon May 15 17:16:05 2017
From: report at bugs.python.org (Ryan Jarvis)
Date: Mon, 15 May 2017 21:16:05 +0000
Subject: [docs] [issue30376] Curses documentation refers to incorrect type
Message-ID: <1494882965.33.0.779610991751.issue30376@psf.upfronthosting.co.za>


New submission from Ryan Jarvis:

Currently the Python curses documentation refers to `WindowObject` multiple times in the documentation.  The actual type signature is `_curses.curses window`.  WindowObject does not exist.  

Seen at 16.11.1. Textbox objects and curses.initscr() for both Python2 and Python3 documentation.   

https://docs.python.org/3/library/curses.html
https://docs.python.org/2/library/curses.html

There is no type information available the curses window object in the documentation.

----------
assignee: docs at python
components: Documentation
messages: 293740
nosy: Ryan Jarvis, docs at python
priority: normal
severity: normal
status: open
title: Curses documentation refers to incorrect type
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/issue30376>
_______________________________________

From report at bugs.python.org  Mon May 15 21:24:56 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Tue, 16 May 2017 01:24:56 +0000
Subject: [docs] [issue30211] Bdb: add docstrings
In-Reply-To: <1493495660.85.0.350046044168.issue30211@psf.upfronthosting.co.za>
Message-ID: <1494897896.63.0.265558107729.issue30211@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

In the entry at https://docs.python.org/3/library/bdb.html#bdb.Bdb.canonic, 
", stripped of surrounding angle brackets"
is wrong, and should be replaced by
".  'Filenames' with angle brackets, such as "<stdin>", generated in interactive mode, are returned unchanged"

>>> 1/0
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ZeroDivisionError: division by zero

(IDLE generates "<PyShell#n>", when n is statement number, starting with 0.)

This and any other doc errors we find should be corrected in this issue, but perhaps in a separate PR that can be backported separately.

----------
assignee: docs at python -> terry.reedy

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

From report at bugs.python.org  Mon May 15 21:26:27 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Tue, 16 May 2017 01:26:27 +0000
Subject: [docs] [issue30211] Bdb: add docstrings
In-Reply-To: <1493495660.85.0.350046044168.issue30211@psf.upfronthosting.co.za>
Message-ID: <1494897987.53.0.708947869601.issue30211@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

As I just posted to core-mentorship, my attempt to push to the PR failed.  Did you leave the 'allow pushes' box checked when you created the PR?

----------

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

From report at bugs.python.org  Tue May 16 00:48:18 2017
From: report at bugs.python.org (Senthil Kumaran)
Date: Tue, 16 May 2017 04:48:18 +0000
Subject: [docs] [issue29651] Inconsistent/undocumented urlsplit/urlparse
 behavior on invalid inputs
In-Reply-To: <1488051927.22.0.367579438822.issue29651@psf.upfronthosting.co.za>
Message-ID: <1494910098.43.0.392693606633.issue29651@psf.upfronthosting.co.za>


Senthil Kumaran added the comment:


New changeset f6e863d868a621594df2a8abe072b5d4766e7137 by Senthil Kumaran (Howie Benefiel) in branch 'master':
 bpo-29651 - Cover edge case of square brackets in urllib docs (#1128)
https://github.com/python/cpython/commit/f6e863d868a621594df2a8abe072b5d4766e7137


----------

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

From report at bugs.python.org  Tue May 16 01:01:30 2017
From: report at bugs.python.org (Senthil Kumaran)
Date: Tue, 16 May 2017 05:01:30 +0000
Subject: [docs] [issue29651] Inconsistent/undocumented urlsplit/urlparse
 behavior on invalid inputs
In-Reply-To: <1488051927.22.0.367579438822.issue29651@psf.upfronthosting.co.za>
Message-ID: <1494910890.6.0.764244694677.issue29651@psf.upfronthosting.co.za>


Changes by Senthil Kumaran <senthil at uthcode.com>:


----------
pull_requests: +1690

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

From report at bugs.python.org  Tue May 16 01:09:39 2017
From: report at bugs.python.org (Senthil Kumaran)
Date: Tue, 16 May 2017 05:09:39 +0000
Subject: [docs] [issue29651] Inconsistent/undocumented urlsplit/urlparse
 behavior on invalid inputs
In-Reply-To: <1488051927.22.0.367579438822.issue29651@psf.upfronthosting.co.za>
Message-ID: <1494911379.71.0.587935536055.issue29651@psf.upfronthosting.co.za>


Changes by Senthil Kumaran <senthil at uthcode.com>:


----------
pull_requests: +1691

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

From report at bugs.python.org  Tue May 16 01:41:05 2017
From: report at bugs.python.org (Senthil Kumaran)
Date: Tue, 16 May 2017 05:41:05 +0000
Subject: [docs] [issue29651] Inconsistent/undocumented urlsplit/urlparse
 behavior on invalid inputs
In-Reply-To: <1488051927.22.0.367579438822.issue29651@psf.upfronthosting.co.za>
Message-ID: <1494913265.59.0.0801139537306.issue29651@psf.upfronthosting.co.za>


Senthil Kumaran added the comment:


New changeset 72e5aa1ef812358b3b113e784e7365fec13dfd69 by Senthil Kumaran in branch '3.5':
 bpo-29651 - Cover edge case of square brackets in urllib docs (#1128) (#1597)
https://github.com/python/cpython/commit/72e5aa1ef812358b3b113e784e7365fec13dfd69


----------

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

From report at bugs.python.org  Tue May 16 01:41:10 2017
From: report at bugs.python.org (Senthil Kumaran)
Date: Tue, 16 May 2017 05:41:10 +0000
Subject: [docs] [issue29651] Inconsistent/undocumented urlsplit/urlparse
 behavior on invalid inputs
In-Reply-To: <1488051927.22.0.367579438822.issue29651@psf.upfronthosting.co.za>
Message-ID: <1494913270.12.0.260187145399.issue29651@psf.upfronthosting.co.za>


Senthil Kumaran added the comment:


New changeset 75b8a54bcad70806d9dcbbe20786f4d9092ab39c by Senthil Kumaran in branch '3.6':
 bpo-29651 - Cover edge case of square brackets in urllib docs (#1128) (#1596)
https://github.com/python/cpython/commit/75b8a54bcad70806d9dcbbe20786f4d9092ab39c


----------

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

From report at bugs.python.org  Tue May 16 01:50:15 2017
From: report at bugs.python.org (Senthil Kumaran)
Date: Tue, 16 May 2017 05:50:15 +0000
Subject: [docs] [issue29651] Inconsistent/undocumented urlsplit/urlparse
 behavior on invalid inputs
In-Reply-To: <1488051927.22.0.367579438822.issue29651@psf.upfronthosting.co.za>
Message-ID: <1494913815.03.0.615769795422.issue29651@psf.upfronthosting.co.za>


Changes by Senthil Kumaran <senthil at uthcode.com>:


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

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

From report at bugs.python.org  Tue May 16 02:35:27 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Tue, 16 May 2017 06:35:27 +0000
Subject: [docs] [issue30211] Bdb: add docstrings
In-Reply-To: <1493495660.85.0.350046044168.issue30211@psf.upfronthosting.co.za>
Message-ID: <1494916527.18.0.496999442015.issue30211@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

The bdb class or __init__ docstring needs to document the data members with a short explanation.  Some of the args need better explanation.  Some of this I may fill in *after* reviewing the proposed tests, when I understand the code better.  Reviewing pdb and IDLE's Idb and Debugger (my real interest here) will help.

is_skipped_module is public, by its name, but is not in the doc.

break_here: " If the breakpoint is a temporary one, this method deletes it."  maybe (if flag from effective is True)

The first comment and the code that follows do not seem to match.  IDLE does not set breakpoints for functions, so I cannot test the behavior here with its debugger.

set_break doc says filename should be canonic, but function then calls canonic.  So canonic not needed.  If it is, result is self.fncache[canonic_filename] = self.fncache[canonic_filename].  But I will leave suggestion as is for now.

get_stack: return 'size of the higher part': If higher part does not stop as self.botframe (which might be None?), the size is of the lower part.  I need to review frame and tb objects pin down this docstring.

I just pushed my changes.  Please review for typos and anything you think is a new error.  Otherwise, I think this is about good enough to merge.

----------
stage:  -> commit review

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

From report at bugs.python.org  Tue May 16 05:36:49 2017
From: report at bugs.python.org (Berker Peksag)
Date: Tue, 16 May 2017 09:36:49 +0000
Subject: [docs] [issue29898] PYTHONLEGACYWINDOWSIOENCODING isn't implemented
In-Reply-To: <1490394843.09.0.467635996133.issue29898@psf.upfronthosting.co.za>
Message-ID: <1494927409.26.0.0263165276019.issue29898@psf.upfronthosting.co.za>


Berker Peksag added the comment:


New changeset 87fa8a780e9045a26c735f085c07bba4b2d0be60 by Berker Peksag in branch 'master':
bpo-29898: Fix incorrect env variable name (GH-1576)
https://github.com/python/cpython/commit/87fa8a780e9045a26c735f085c07bba4b2d0be60


----------
nosy: +berker.peksag

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

From report at bugs.python.org  Tue May 16 05:37:09 2017
From: report at bugs.python.org (Berker Peksag)
Date: Tue, 16 May 2017 09:37:09 +0000
Subject: [docs] [issue29898] PYTHONLEGACYWINDOWSIOENCODING isn't implemented
In-Reply-To: <1490394843.09.0.467635996133.issue29898@psf.upfronthosting.co.za>
Message-ID: <1494927429.37.0.0160653459324.issue29898@psf.upfronthosting.co.za>


Changes by Berker Peksag <berker.peksag at gmail.com>:


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

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

From p.chauveau.thoumelin at gmail.com  Tue May 16 07:59:44 2017
From: p.chauveau.thoumelin at gmail.com (Pierre Chauveau-Thoumelin)
Date: Tue, 16 May 2017 11:59:44 +0000
Subject: [docs] Wrong paper format
Message-ID: <CANCjTrkeZr_PJADMy3-eB+iq5Jqyokhs78h_w-HFJN=2HrVWeQ@mail.gmail.com>

Hello,

I am attempting to download the docs as PDFs (A4 paper size) from this page
: https://docs.python.org/3.7/download.html. The problem is that both
archives (
https://docs.python.org/3.7/archives/python-3.7.0a0-docs-pdf-a4.zip and
https://docs.python.org/3.7/archives/python-3.7.0a0-docs-pdf-a4.tar.bz2)
contain PDFs with the US-Letter paper size. Could you please do something
about it? (I've only checked the tutorial.pdf, not all files).

Thank you!

Best,
Pierre Chauveau-Thoumelin
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170516/35651b84/attachment.html>

From report at bugs.python.org  Tue May 16 08:59:22 2017
From: report at bugs.python.org (Nick Coghlan)
Date: Tue, 16 May 2017 12:59:22 +0000
Subject: [docs] [issue29710] Incorrect representation caveat on bitwise
 operation docs
In-Reply-To: <1488551919.31.0.20533072889.issue29710@psf.upfronthosting.co.za>
Message-ID: <1494939561.98.0.153650750258.issue29710@psf.upfronthosting.co.za>


Nick Coghlan added the comment:

I think the simplest fix to make the docs "not wrong" would be to just delete the part in parentheses.

Beyond that, I'm not quite sure how to concisely describe the actual behaviour, but I think the mention of "2's complement" isn't especially helpful in its current form, since we don't give a clear sense of how the translation from an arbitrary length integer to a suitable 2's complement form is handled.

For `~n`, the most concise explanation is the arithmetic equivalent: it is always implemented as `-(n+1)`

Similarly, for `x << n` and `x >> n`, they're now exactly equivalent to `x * 2 ** n` and `x // 2 ** n` without any overflow checking or internal representation qualification (as even in Python 2.x, left-shift will automatically promote to a long when needed)

For `x | y` and `x & y`, things are a little more subtle, since that's where the internal 2's complement representation comes into play, but you can't just write out the formal definition of 2's complement at the Python level and get the same answer as is given by the binary operators:

>>> -5 & 5
1
>>> -5 | 5
-1

>>> (~-5 + 1) & 5 # Effectively '5 & 5'
5
>>> (~-5 + 1) | 5 # Effectively '5 | 5'
5

>>> -5 | (~5+1) # Effectively '-5 & -5'
-5
>>> -5 & (~5+1) # Effectively '-5 | -5'
-5


The problem here is that the sign bits of the operands matter a great deal, since they affect the sign expansion in the conversion to the 2's complement form, but that detail gets lost if the conversion is done prior to the bitwise binary operator invocation.

One way to get the same results as the interpreter level algorithms is to use a 2's complement bit length of `1 + max(x.bit_length(), y.bit_length()`, so the equivalent operations become:

>>> bin(0b1011 & 0b0101) # -5 & 5 -> 1 in 4 bit 2's complement
'0b1'
>>> bin(0b1011 | 0b0101) # -5 | 5 -> -1 in 4 bit 2's complement
'0b1111'

So perhaps a helpful change to make would be to move the note about negative numbers to a numbered footnote in the table, and state that the bitwise binary operations are semantically equivalent to calculations using two's complement in a bit-width of `1 + max(x.bit_length(), y.bit_length()`.

----------

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

From report at bugs.python.org  Tue May 16 09:31:09 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Tue, 16 May 2017 13:31:09 +0000
Subject: [docs] [issue30211] Bdb: add docstrings
In-Reply-To: <1493495660.85.0.350046044168.issue30211@psf.upfronthosting.co.za>
Message-ID: <1494941469.28.0.56529061138.issue30211@psf.upfronthosting.co.za>


Cheryl Sabella added the comment:

Thank you.  I had some questions that I put on the commit.

You're right about it saying it must be in canonic form and then it calls canonic.  I figured someone added the call later to prevent an error, but didn't change the warning, but I didn't know if I should change it.

I added a comment about get_stack on github.  I know I'm missing something here, but I had trouble documenting that because it didn't look like it was doing what the doc said.

I'm not at my regular computer this week, so I can't add any changes until Saturday.  I'll do the is_skipped_module doc then.

Thank you for the edits on the other docstrings.  They make a lot more sense now.  Although I still don't like the user_* ones.  I hadn't changed them from the original before, but it feels like they should say something else, like what's expected of them.  The test example within bdb.py helped me understand what can be done with them.

----------

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

From report at bugs.python.org  Tue May 16 12:19:28 2017
From: report at bugs.python.org (Berker Peksag)
Date: Tue, 16 May 2017 16:19:28 +0000
Subject: [docs] [issue29898] PYTHONLEGACYWINDOWSIOENCODING isn't implemented
In-Reply-To: <1490394843.09.0.467635996133.issue29898@psf.upfronthosting.co.za>
Message-ID: <1494951568.96.0.309555941955.issue29898@psf.upfronthosting.co.za>


Changes by Berker Peksag <berker.peksag at gmail.com>:


----------
pull_requests: +1700

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

From report at bugs.python.org  Tue May 16 12:28:01 2017
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 16 May 2017 16:28:01 +0000
Subject: [docs] [issue30372] Status of __builtins__ is not totally clear
In-Reply-To: <1494865238.41.0.458723699483.issue30372@psf.upfronthosting.co.za>
Message-ID: <1494952080.96.0.359592456989.issue30372@psf.upfronthosting.co.za>


Brett Cannon added the comment:

You're correct that both are CPython implementation details and could be more clearly marked as such.

(In case anyone is curious, the code to look up __import__() can be found at https://github.com/python/cpython/blob/c7ac7280c321b3c1679fe5f657a6be0f86adf173/Python/ceval.c#L4991 .)

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

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

From report at bugs.python.org  Tue May 16 13:29:33 2017
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 16 May 2017 17:29:33 +0000
Subject: [docs] [issue30380] Sphinx 1.6.1 raising new warnings in docs build
Message-ID: <1494955773.64.0.780886638634.issue30380@psf.upfronthosting.co.za>


New submission from Brett Cannon:

The Travis file uses `make venv` which does `python3 -m pip install --upgrade sphinx` which is pulling in Sphinx 1.6.1 which was released today (under Python 2.7 the pip call is direct instead of using `make venv`). The problem is that Sphinx 1.6.1 adds some new warnings that then is flagging the docs build as failing.

To fix this we should probably stop calling `make venv` in .travis.yml and instead explicitly install Sphinx 1.5.6 for the docs build.

Once Travis is green again a separate PR can be done to update `master` to build cleanly under Sphinx 1.6.1.

----------
assignee: docs at python
components: Documentation
messages: 293775
nosy: brett.cannon, docs at python
priority: critical
severity: normal
status: open
title: Sphinx 1.6.1 raising new warnings in docs build
versions: Python 2.7, Python 3.5, Python 3.6, Python 3.7

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

From report at bugs.python.org  Tue May 16 13:30:24 2017
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 16 May 2017 17:30:24 +0000
Subject: [docs] [issue30380] Sphinx 1.6.1 raising new warnings in docs build
In-Reply-To: <1494955773.64.0.780886638634.issue30380@psf.upfronthosting.co.za>
Message-ID: <1494955824.35.0.552251972738.issue30380@psf.upfronthosting.co.za>


Brett Cannon added the comment:

Technically it's probably best to do `python3 -m pip install sphinx~=1.5.6` so bugfix releases are picked up.

----------

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

From report at bugs.python.org  Tue May 16 13:54:29 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 16 May 2017 17:54:29 +0000
Subject: [docs] [issue30380] Sphinx 1.6.1 raising new warnings in docs build
In-Reply-To: <1494955773.64.0.780886638634.issue30380@psf.upfronthosting.co.za>
Message-ID: <1494957269.19.0.00496943130875.issue30380@psf.upfronthosting.co.za>


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


----------
pull_requests: +1701

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

From report at bugs.python.org  Tue May 16 14:18:08 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 16 May 2017 18:18:08 +0000
Subject: [docs] [issue30380] Sphinx 1.6.1 raising new warnings in docs build
In-Reply-To: <1494955773.64.0.780886638634.issue30380@psf.upfronthosting.co.za>
Message-ID: <1494958688.29.0.78015995627.issue30380@psf.upfronthosting.co.za>


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


----------
pull_requests: +1702

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

From report at bugs.python.org  Tue May 16 14:20:15 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 16 May 2017 18:20:15 +0000
Subject: [docs] [issue30380] Sphinx 1.6.1 raising new warnings in docs build
In-Reply-To: <1494955773.64.0.780886638634.issue30380@psf.upfronthosting.co.za>
Message-ID: <1494958815.25.0.186499925799.issue30380@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

PR 1613 tries to fix a warning by using explicit footnote numbering.

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

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

From report at bugs.python.org  Tue May 16 16:18:12 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 16 May 2017 20:18:12 +0000
Subject: [docs] [issue30380] Sphinx 1.6.1 raising new warnings in docs build
In-Reply-To: <1494955773.64.0.780886638634.issue30380@psf.upfronthosting.co.za>
Message-ID: <1494965892.08.0.763446232908.issue30380@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:


New changeset d97b7dc94b19063f0589d401bdc4aaadc7030762 by Serhiy Storchaka in branch 'master':
bpo-30380: Fix Sphinx 1.6.1 warnings. (#1613)
https://github.com/python/cpython/commit/d97b7dc94b19063f0589d401bdc4aaadc7030762


----------

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

From report at bugs.python.org  Tue May 16 16:24:31 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 16 May 2017 20:24:31 +0000
Subject: [docs] [issue30380] Sphinx 1.6.1 raising new warnings in docs build
In-Reply-To: <1494955773.64.0.780886638634.issue30380@psf.upfronthosting.co.za>
Message-ID: <1494966271.34.0.505530208861.issue30380@psf.upfronthosting.co.za>


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


----------
pull_requests: +1703

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

From report at bugs.python.org  Tue May 16 16:28:37 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 16 May 2017 20:28:37 +0000
Subject: [docs] [issue30380] Sphinx 1.6.1 raising new warnings in docs build
In-Reply-To: <1494955773.64.0.780886638634.issue30380@psf.upfronthosting.co.za>
Message-ID: <1494966517.31.0.804361285455.issue30380@psf.upfronthosting.co.za>


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


----------
pull_requests: +1704

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

From report at bugs.python.org  Tue May 16 16:34:33 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 16 May 2017 20:34:33 +0000
Subject: [docs] [issue30380] Sphinx 1.6.1 raising new warnings in docs build
In-Reply-To: <1494955773.64.0.780886638634.issue30380@psf.upfronthosting.co.za>
Message-ID: <1494966873.67.0.96322284922.issue30380@psf.upfronthosting.co.za>


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


----------
pull_requests: +1705

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

From report at bugs.python.org  Tue May 16 16:48:11 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Tue, 16 May 2017 20:48:11 +0000
Subject: [docs] [issue30211] Bdb: add docstrings
In-Reply-To: <1493495660.85.0.350046044168.issue30211@psf.upfronthosting.co.za>
Message-ID: <1494967690.98.0.218107801842.issue30211@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

I plan to merge when I can.  Possible future improvements for bdb.py.

1. Bdb attributes.
2. Say what user_xyz functions might do.  Anything better than 'Intervene in debugging process.'?
3. Clarify what get_stack does.

Improvement for bdb.rst (optional for this issue).
1. Add is_skipped_module
2. Fix overt errors we are sure of, noted above
* canonic: <> not stripped
* break_here: temps *may* be deleted
* get_stack: length may or may not be what says.

----------

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

From report at bugs.python.org  Tue May 16 16:48:28 2017
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 16 May 2017 20:48:28 +0000
Subject: [docs] [issue30380] Sphinx 1.6.1 raising new warnings in docs build
In-Reply-To: <1494955773.64.0.780886638634.issue30380@psf.upfronthosting.co.za>
Message-ID: <1494967708.57.0.494822773171.issue30380@psf.upfronthosting.co.za>


Brett Cannon added the comment:


New changeset fca224f117d25bdfec1bf7160b67438c4fcf6dee by Brett Cannon (Mariatta) in branch 'master':
bpo-30380: Pin the version of Sphinx used to build the documentation (GH-1612)
https://github.com/python/cpython/commit/fca224f117d25bdfec1bf7160b67438c4fcf6dee


----------

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

From report at bugs.python.org  Tue May 16 17:01:49 2017
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 16 May 2017 21:01:49 +0000
Subject: [docs] [issue30380] Sphinx 1.6.1 raising new warnings in docs build
In-Reply-To: <1494955773.64.0.780886638634.issue30380@psf.upfronthosting.co.za>
Message-ID: <1494968509.43.0.0245970942948.issue30380@psf.upfronthosting.co.za>


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


----------
pull_requests: +1706

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

From report at bugs.python.org  Tue May 16 17:05:42 2017
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 16 May 2017 21:05:42 +0000
Subject: [docs] [issue30380] Sphinx 1.6.1 raising new warnings in docs build
In-Reply-To: <1494955773.64.0.780886638634.issue30380@psf.upfronthosting.co.za>
Message-ID: <1494968742.11.0.651379772213.issue30380@psf.upfronthosting.co.za>


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


----------
pull_requests: +1707

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

From report at bugs.python.org  Tue May 16 17:09:25 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 16 May 2017 21:09:25 +0000
Subject: [docs] [issue30380] Sphinx 1.6.1 raising new warnings in docs build
In-Reply-To: <1494955773.64.0.780886638634.issue30380@psf.upfronthosting.co.za>
Message-ID: <1494968965.82.0.817942014485.issue30380@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:


New changeset 8fc1ff51adb52c80f6bf78393413c72543bae3e1 by Serhiy Storchaka in branch '3.6':
[3.6] bpo-30380: Fix Sphinx 1.6.1 warnings. (GH-1613) (#1614)
https://github.com/python/cpython/commit/8fc1ff51adb52c80f6bf78393413c72543bae3e1


----------

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

From report at bugs.python.org  Tue May 16 17:15:52 2017
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 16 May 2017 21:15:52 +0000
Subject: [docs] [issue30380] Sphinx 1.6.1 raising new warnings in docs build
In-Reply-To: <1494955773.64.0.780886638634.issue30380@psf.upfronthosting.co.za>
Message-ID: <1494969352.98.0.687519082625.issue30380@psf.upfronthosting.co.za>


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


----------
pull_requests: +1708

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

From report at bugs.python.org  Tue May 16 17:28:23 2017
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 16 May 2017 21:28:23 +0000
Subject: [docs] [issue30380] Sphinx 1.6.1 raising new warnings in docs build
In-Reply-To: <1494955773.64.0.780886638634.issue30380@psf.upfronthosting.co.za>
Message-ID: <1494970103.47.0.357330097639.issue30380@psf.upfronthosting.co.za>


Brett Cannon added the comment:


New changeset 5e2016dce92d66e6e1fb25e6ce39031d8c7d5412 by Brett Cannon in branch '3.6':
bpo-30380: Pin the version of Sphinx used to build the docs (GH-1612) (GH-1617)
https://github.com/python/cpython/commit/5e2016dce92d66e6e1fb25e6ce39031d8c7d5412


----------

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

From report at bugs.python.org  Tue May 16 17:29:44 2017
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 16 May 2017 21:29:44 +0000
Subject: [docs] [issue30380] Sphinx 1.6.1 raising new warnings in docs build
In-Reply-To: <1494955773.64.0.780886638634.issue30380@psf.upfronthosting.co.za>
Message-ID: <1494970184.28.0.378680802758.issue30380@psf.upfronthosting.co.za>


Brett Cannon added the comment:


New changeset 083f13e34c0b9f9ed4ed64fed3989d4af97843b3 by Brett Cannon (Serhiy Storchaka) in branch '3.5':
[3.5] bpo-30380: Fix Sphinx 1.6.1 warnings. (GH-1613) (GH-1615)
https://github.com/python/cpython/commit/083f13e34c0b9f9ed4ed64fed3989d4af97843b3


----------

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

From report at bugs.python.org  Tue May 16 17:31:42 2017
From: report at bugs.python.org (Berker Peksag)
Date: Tue, 16 May 2017 21:31:42 +0000
Subject: [docs] [issue29898] PYTHONLEGACYWINDOWSIOENCODING isn't implemented
In-Reply-To: <1490394843.09.0.467635996133.issue29898@psf.upfronthosting.co.za>
Message-ID: <1494970302.16.0.538190459549.issue29898@psf.upfronthosting.co.za>


Berker Peksag added the comment:


New changeset 0d267041c40a3ab655676b885c0ba35ed9685848 by Berker Peksag in branch '3.6':
bpo-29898: Fix incorrect env variable name (GH-1576)
https://github.com/python/cpython/commit/0d267041c40a3ab655676b885c0ba35ed9685848


----------

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

From report at bugs.python.org  Tue May 16 17:32:02 2017
From: report at bugs.python.org (Berker Peksag)
Date: Tue, 16 May 2017 21:32:02 +0000
Subject: [docs] [issue29898] PYTHONLEGACYWINDOWSIOENCODING isn't implemented
In-Reply-To: <1490394843.09.0.467635996133.issue29898@psf.upfronthosting.co.za>
Message-ID: <1494970322.54.0.790437585658.issue29898@psf.upfronthosting.co.za>


Changes by Berker Peksag <berker.peksag at gmail.com>:


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

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

From report at bugs.python.org  Tue May 16 17:40:35 2017
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 16 May 2017 21:40:35 +0000
Subject: [docs] [issue30380] Sphinx 1.6.1 raising new warnings in docs build
In-Reply-To: <1494955773.64.0.780886638634.issue30380@psf.upfronthosting.co.za>
Message-ID: <1494970835.15.0.61868856514.issue30380@psf.upfronthosting.co.za>


Brett Cannon added the comment:


New changeset 77606957e71ce477d2c5569718f0fc36f05c6f59 by Brett Cannon in branch '3.5':
bpo-30380: Pin the version of Sphinx used to build the documentation (GH-1612) (GH-1618)
https://github.com/python/cpython/commit/77606957e71ce477d2c5569718f0fc36f05c6f59


----------

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

From report at bugs.python.org  Tue May 16 17:41:02 2017
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 16 May 2017 21:41:02 +0000
Subject: [docs] [issue30380] Sphinx 1.6.1 raising new warnings in docs build
In-Reply-To: <1494955773.64.0.780886638634.issue30380@psf.upfronthosting.co.za>
Message-ID: <1494970862.75.0.433260708448.issue30380@psf.upfronthosting.co.za>


Brett Cannon added the comment:


New changeset 97eb2a7d77011605e8fc49e754cd371ead4366bc by Brett Cannon in branch '2.7':
[2.7] bpo-30380: Pin the version of Sphinx used to build the docs (GH-1612) (GH-1619)
https://github.com/python/cpython/commit/97eb2a7d77011605e8fc49e754cd371ead4366bc


----------

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

From report at bugs.python.org  Tue May 16 17:46:52 2017
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 16 May 2017 21:46:52 +0000
Subject: [docs] [issue30380] Sphinx 1.6.1 raising new warnings in docs build
In-Reply-To: <1494955773.64.0.780886638634.issue30380@psf.upfronthosting.co.za>
Message-ID: <1494971212.33.0.649082494228.issue30380@psf.upfronthosting.co.za>


Brett Cannon added the comment:

All branches should be green again. Serhiy has a PR out to fix 2.7 for Sphinx 1.6.1, but it isn't passing yet so that branch is pinned to 1.5.6 until then.

I will leave this issue open for Serhiy to close once his 2.7 PR is merged.

----------

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

From report at bugs.python.org  Tue May 16 18:26:50 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 16 May 2017 22:26:50 +0000
Subject: [docs] [issue30380] Sphinx 1.6.1 raising new warnings in docs build
In-Reply-To: <1494955773.64.0.780886638634.issue30380@psf.upfronthosting.co.za>
Message-ID: <1494973610.89.0.108991157059.issue30380@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:


New changeset b8b9f95f660d00ce9bd11bd9de429176858be3c5 by Serhiy Storchaka in branch '2.7':
[2.7] bpo-30380: Fix Sphinx 1.6.1 warnings. (GH-1613) (#1616)
https://github.com/python/cpython/commit/b8b9f95f660d00ce9bd11bd9de429176858be3c5


----------

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

From report at bugs.python.org  Tue May 16 18:28:04 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Tue, 16 May 2017 22:28:04 +0000
Subject: [docs] [issue30211] Bdb: add docstrings
In-Reply-To: <1493495660.85.0.350046044168.issue30211@psf.upfronthosting.co.za>
Message-ID: <1494973684.62.0.513755762383.issue30211@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:


New changeset 0774e79b93cc494b3a957d538c7c112e289973c0 by terryjreedy (csabella) in branch 'master':
bpo-30211: bdb: add docstrings (#1350)
https://github.com/python/cpython/commit/0774e79b93cc494b3a957d538c7c112e289973c0


----------

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

From report at bugs.python.org  Tue May 16 20:43:11 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Wed, 17 May 2017 00:43:11 +0000
Subject: [docs] [issue30211] Bdb: add docstrings
In-Reply-To: <1493495660.85.0.350046044168.issue30211@psf.upfronthosting.co.za>
Message-ID: <1494981790.83.0.594950395454.issue30211@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

I still need to push a News Entry.

----------

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

From report at bugs.python.org  Wed May 17 02:16:17 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 17 May 2017 06:16:17 +0000
Subject: [docs] [issue30380] Sphinx 1.6.1 raising new warnings in docs build
In-Reply-To: <1494955773.64.0.780886638634.issue30380@psf.upfronthosting.co.za>
Message-ID: <1495001777.51.0.351783752987.issue30380@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

There was other warnings, mostly false positive, but there were also the real documentation bugs. Sphinx now converts quotes to Unicode variants at earlier stage (this is good thing, because converting them at late stage, in HTML, not always worked), and rules in susp-ignored.csv containing '"' no longer worked.

Now warnings in 2.7 are fixed and Sphinx can be pinned to 1.6.1.

----------

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

From report at bugs.python.org  Wed May 17 10:17:54 2017
From: report at bugs.python.org (Berker Peksag)
Date: Wed, 17 May 2017 14:17:54 +0000
Subject: [docs] [issue30376] Curses documentation refers to incorrect type
In-Reply-To: <1494882965.33.0.779610991751.issue30376@psf.upfronthosting.co.za>
Message-ID: <1495030674.1.0.38339407536.issue30376@psf.upfronthosting.co.za>


Changes by Berker Peksag <berker.peksag at gmail.com>:


----------
pull_requests: +1721

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

From report at bugs.python.org  Wed May 17 13:56:45 2017
From: report at bugs.python.org (Decorater)
Date: Wed, 17 May 2017 17:56:45 +0000
Subject: [docs] [issue30390] Document how to make classes in the C API.
Message-ID: <1495043805.38.0.403862403913.issue30390@psf.upfronthosting.co.za>


New submission from Decorater:

On the C API, it tells how to make modules, functions, variables, and other things, but what about classes?

Like for example if you wanted to make a class with all of the methods having to use direct C Code which would then be converted to PyObject *'s for returning the information the C Code would normally return.

Not only that but also being able to create class instance variables using the C API as well.

Like for example here is an example class (As it would be if it was written in python):

class Example:
    def __init__(self):
        self.data = None  # None being a place holder for now.

    def somefunction(self):
        # C Code here.
        self.data = ret  # return value for the C Code.
        return self.data

Yes, there are better ways than writing the return data to the instance variable and returning it. That is just an example, I have classes that uses them for other things that does not return anything making the instance variables be the only way to get the data.

But yeah long story short I think creating classes with the C API should be documented if not already, or at least an example of doing one to be added as an guide for others wondering how to use the C API to make their own (non exception) classes.

----------
assignee: docs at python
components: Documentation, Extension Modules
messages: 293863
nosy: Decorater, docs at python
priority: normal
severity: normal
status: open
title: Document how to make classes in the C API.
versions: Python 3.5, Python 3.6, Python 3.7

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

From report at bugs.python.org  Wed May 17 14:03:21 2017
From: report at bugs.python.org (Decorater)
Date: Wed, 17 May 2017 18:03:21 +0000
Subject: [docs] [issue30390] Document how to make classes in the C API.
In-Reply-To: <1495043805.38.0.403862403913.issue30390@psf.upfronthosting.co.za>
Message-ID: <1495044201.1.0.201029763163.issue30390@psf.upfronthosting.co.za>


Decorater added the comment:

Hmm seems that when looking at the exports in python36.dll that the following functions seem to not be documented as far as I seen:

PyClassMethodDescr_Type
PyClassMethod_New
PyClassMethod_Type

There might be more functions dealing with classes that are not documented. However looking through the whole exports would take to long as there are so many.

----------

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

From report at bugs.python.org  Wed May 17 14:07:58 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 17 May 2017 18:07:58 +0000
Subject: [docs] [issue30390] Document how to make classes in the C API.
In-Reply-To: <1495043805.38.0.403862403913.issue30390@psf.upfronthosting.co.za>
Message-ID: <1495044478.55.0.02632735885.issue30390@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

This is documented. See https://docs.python.org/3/extending/newtypes.html.

----------
nosy: +serhiy.storchaka
resolution:  -> not a bug
stage:  -> resolved
status: open -> closed

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

From report at bugs.python.org  Wed May 17 15:15:28 2017
From: report at bugs.python.org (Decorater)
Date: Wed, 17 May 2017 19:15:28 +0000
Subject: [docs] [issue30390] Document how to make classes in the C API.
In-Reply-To: <1495043805.38.0.403862403913.issue30390@psf.upfronthosting.co.za>
Message-ID: <1495048528.02.0.376063523281.issue30390@psf.upfronthosting.co.za>


Decorater added the comment:

Still it does look the functions lited in the second comment are undocumented.

https://docs.python.org/3/search.html?q=PyClassMethodDescr_Type
https://docs.python.org/3/search.html?q=PyClassMethod_New&check_keywords=yes&area=default

However on the last function I did find 1 thing However it was not what I was looking for. What I actually was looking for was the args for the 3 functions and description on what it does and all that similar to how this function is documented:

```
PyObject* PyObject_CallObject(PyObject *callable_object, PyObject *args)
Return value: New reference.
Call a callable Python object callable_object, with arguments given by the tuple args. If no arguments are needed, then args may be NULL. Returns the result of the call on success, or NULL on failure. This is the equivalent of the Python expression callable_object(*args).

```

This is actually the reason why the issue was opened as the functions was not documented like this.

----------

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

From report at bugs.python.org  Wed May 17 15:17:41 2017
From: report at bugs.python.org (Decorater)
Date: Wed, 17 May 2017 19:17:41 +0000
Subject: [docs] [issue30390] Document how to make classes in the C API.
In-Reply-To: <1495043805.38.0.403862403913.issue30390@psf.upfronthosting.co.za>
Message-ID: <1495048661.93.0.0800927460918.issue30390@psf.upfronthosting.co.za>


Changes by Decorater <seandhunt_7 at yahoo.com>:


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

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

From report at bugs.python.org  Wed May 17 16:05:36 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 17 May 2017 20:05:36 +0000
Subject: [docs] [issue30390] Document how to make classes in the C API.
In-Reply-To: <1495043805.38.0.403862403913.issue30390@psf.upfronthosting.co.za>
Message-ID: <1495051536.0.0.53323934782.issue30390@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

The title of this issue is "Document how to make classes in the C API." This already is documented.

For documenting the PyClassMethod* names open a new issue.

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

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

From report at bugs.python.org  Wed May 17 16:45:30 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 17 May 2017 20:45:30 +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: <1495053930.36.0.312456406261.issue29660@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/issue29660>
_______________________________________

From report at bugs.python.org  Wed May 17 17:50:38 2017
From: report at bugs.python.org (April King)
Date: Wed, 17 May 2017 21:50:38 +0000
Subject: [docs] [issue18617] AIA chasing for missing intermediate
 certificates on TLS connections
In-Reply-To: <1375376317.99.0.429350247521.issue18617@psf.upfronthosting.co.za>
Message-ID: <1495057838.7.0.690460432502.issue18617@psf.upfronthosting.co.za>


April King added the comment:

Browsers universally support AIA chasing/fetching, as do a number of underlying OS libraries, such as Secure Transport (macOS) and schannel (Windows).

As a result, it is becoming increasingly common for server operators to fail to include the entire certificate chain in their handshake. By some measures, anywhere from 10 to over 30% of all TLS errors(1) are caused by missing intermediate certificates.

There are a handful of ways that scanners and other tools have worked around this issue. Some, like SSL Labs, do their own AIA chasing. Others make subprocess to other tools linked to OS libraries which invisibly perform AIA chasing, such as curl on macOS. Others, like Firefox, maintain a cache of intermediate certificates.

In any case, all of these solutions are concession to the reality that TLS is really hard and that it is largely impossible to solve this particular misconfiguration issue.

I myself write a popular tool(2) that does scanning of sites for missing security configurations. Although it's not explicitly focused on TLS, some of the underlying tests rely on a verified TLS connection.  For example, the HTTP Strict Transport Security (HSTS) header can only be set on valid TLS connections.  I use requests (which uses httplib underneath), but I'm unable to tell if a given certificate error is because of either:

a) the certificate validation actually failed (for example, due to being expired), or
b) there was a missing intermediate certificate and that things would have worked if AIA chasing was available

As a result, I have to tell people that their HSTS header can't be set. This is often incorrect, because browsers that do AIA chasing consider the connection perfectly secure for the purposes of HSTS.

It would be really nice if Python's httplib could be updated to do transparent AIA chasing, with the optional ability to turn it off. In an ideal world, the underlying TLS libraries (such as OpenSSL) would do this for us, but unfortunately as things stand now OpenSSL leaves it up to the applications themselves to perform chasing. According to Mozilla research (3), if implemented, it would reduce TLS errors by approximately 6% were AIA chasing always performed and successful.

Thanks!

1. https://docs.google.com/document/d/1ryqFMSHHRDERg1jm3LeVt7VMfxtXXrI8p49gmtniNP0/edit?pli=1
2. https://observatory.mozilla.org/
3. https://bugzilla.mozilla.org/show_bug.cgi?id=399324#c80

----------
nosy: +april
title: TLS and Intermediate Certificates -> AIA chasing for missing intermediate certificates on TLS connections

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

From report at bugs.python.org  Wed May 17 17:59:37 2017
From: report at bugs.python.org (April King)
Date: Wed, 17 May 2017 21:59:37 +0000
Subject: [docs] [issue18617] AIA chasing for missing intermediate
 certificates on TLS connections
In-Reply-To: <1375376317.99.0.429350247521.issue18617@psf.upfronthosting.co.za>
Message-ID: <1495058377.47.0.905642292535.issue18617@psf.upfronthosting.co.za>


April King added the comment:

Err, sorry, I may have been a bit unclear.  AIA chasing is not *universal* amongst browsers.  IE, Edge, Chrome, and Safari perform AIA chasing.  Firefox maintains a cache of intermediate certificate authorities.  I noted that a bit further underneath, but my apologies if it was confusing.

That said, every browser has a some chosen some underlying method to ameliorate this common TLS error.  It would be amazing if Python could similarly resolve this issue for developers.

----------

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

From report at bugs.python.org  Wed May 17 18:37:17 2017
From: report at bugs.python.org (Alex Gaynor)
Date: Wed, 17 May 2017 22:37:17 +0000
Subject: [docs] [issue18617] AIA chasing for missing intermediate
 certificates on TLS connections
In-Reply-To: <1375376317.99.0.429350247521.issue18617@psf.upfronthosting.co.za>
Message-ID: <1495060637.09.0.705852063791.issue18617@psf.upfronthosting.co.za>


Alex Gaynor added the comment:

Just discussed with Christian, and we're both in favor of adding AIA chasing support to the stdlib ssl.

----------
nosy: +alex, janssen

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

From report at bugs.python.org  Wed May 17 21:49:31 2017
From: report at bugs.python.org (Decorater)
Date: Thu, 18 May 2017 01:49:31 +0000
Subject: [docs] [issue30396] Document the PyClassMethod* C API functions.
Message-ID: <1495072171.73.0.812244452186.issue30396@psf.upfronthosting.co.za>


New submission from Decorater:

The way the documentation currently is set up there is no way to know what these functions in the C API actually do or what all the parameters are to call it unless someone source dives into python. Because of this I think making an C API page or a section for the functions like these or similar capabilities would be an Great an huge help to others as well as an example small module using said PyClassMethod* functions.

I will need to look at how far down in python versions that these functions exist for though.

----------
assignee: docs at python
components: Documentation, Extension Modules
messages: 293907
nosy: Decorater, docs at python
priority: normal
severity: normal
status: open
title: Document the PyClassMethod* C API functions.
versions: Python 3.5, Python 3.6, Python 3.7

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

From skz5k2 at gmail.com  Thu May 18 18:13:43 2017
From: skz5k2 at gmail.com (F SkZ M)
Date: Thu, 18 May 2017 18:13:43 -0400
Subject: [docs] Documentation in PDF A4
In-Reply-To: <CAPEWdcWWk_o3WFnCn0+B_SFTVeZN3-oYCkXf22DgKtd3rfQZ3A@mail.gmail.com>
References: <CAPEWdcWWk_o3WFnCn0+B_SFTVeZN3-oYCkXf22DgKtd3rfQZ3A@mail.gmail.com>
Message-ID: <CAPEWdcXb6=u+GLyPcSnM-hMiu6eqk2jMaPogkmmcNTPBruEsSA@mail.gmail.com>

The problem still persists. From  python-3.6.1-docs-pdf-a4.tar.bz2 I get
pdfinfo c-api.pdf
Title:
Subject:
Keywords:
Author:
Creator:        LaTeX with hyperref package
Producer:       pdfTeX-1.40.14
CreationDate:   Thu May 18 00:15:47 2017
ModDate:        Thu May 18 00:15:47 2017
Tagged:         no
Form:           none
Pages:          226
Encrypted:      no
Page size:      612 x 792 pts (letter)
Page rot:       0
File size:      947866 bytes
Optimized:      no
PDF version:    1.5

pdfinfo library.pdf
Title:
Subject:
Keywords:
Author:
Creator:        LaTeX with hyperref package
Producer:       pdfTeX-1.40.14
CreationDate:   Thu May 18 00:17:12 2017
ModDate:        Thu May 18 00:17:12 2017
Tagged:         no
Form:           none
Pages:          1898
Encrypted:      no
Page size:      612 x 792 pts (letter)
Page rot:       0
File size:      6623892 bytes
Optimized:      no
PDF version:    1.5

--and rising one morning with the rosy dawn, he went before the sun, and
spake thus unto it:
Thou great star! What would be thy happiness if thou hadst not those for
whom thou shinest! (Nietzsche, AsZ)
Software is like sex: it's better when it's free (Linus T.)

2017-04-25 15:34 GMT-03:00 F SkZ M <skz5k2 at gmail.com>:

> I downloaded the A4 version of the documentation from the site, but when I
> check in the properties the pdf files result to be in letter, and comparing
> with the letter version of the same document, they have effectively the
> same format (pages 102 of c-api.pdf of "a4" and letter version are
> identical, that it would be not possible considering the different size of
> the page format).
>
> python-3.6.1 :)pdfinfo c-api.pdf
>> Title:
>> Subject:
>> Keywords:
>> Author:
>> Creator:        LaTeX with hyperref package
>> Producer:       pdfTeX-1.40.14
>> CreationDate:   Tue Apr 25 00:15:56 2017
>> ModDate:        Tue Apr 25 00:15:56 2017
>> Tagged:         no
>> Form:           none
>> Pages:          226
>> Encrypted:      no
>> Page size:      612 x 792 pts (letter)
>> Page rot:       0
>> File size:      947872 bytes
>> Optimized:      no
>> PDF version:    1.5
>>
>
> Francesco Mauro
>
> PS: the size of the compress file is actually 12MiB and not 8MiB
>
>
> --and rising one morning with the rosy dawn, he went before the sun, and
> spake thus unto it:
> Thou great star! What would be thy happiness if thou hadst not those for
> whom thou shinest! (Nietzsche, AsZ)
> Software is like sex: it's better when it's free (Linus T.)
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170518/13745e7b/attachment.html>

From kaylen.student at gmail.com  Fri May 19 09:46:36 2017
From: kaylen.student at gmail.com (Kaylen Pillay)
Date: Fri, 19 May 2017 15:46:36 +0200
Subject: [docs] Python Docs HTML issue
Message-ID: <CAN_0kdWgTjppeAf9BYeSARM8-tWDs7bhBn_w-GpE7=kZf=+X4A@mail.gmail.com>

Hi,

I'm starting to learn the python language and I wanted to download the
documentation to have easy access to the docs when I'm offline. However I'm
finding that the HTML version doesn't show correctly in my browser. Could
you please help me solve this issue, also I'd prefer the HTML over the PDF
and I'm currently having to use the PDF version

Thank you
Kaylen
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170519/f028566e/attachment.html>

From report at bugs.python.org  Fri May 19 15:18:32 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 19 May 2017 19:18:32 +0000
Subject: [docs] [issue30361] Docs example: converting mixed types to
 floating point
In-Reply-To: <1494752919.15.0.561616045601.issue30361@psf.upfronthosting.co.za>
Message-ID: <1495221512.65.0.266767256669.issue30361@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

Agreed.  Also, I think one example is enough.  A good sprint fix.

----------
keywords: +easy
nosy: +terry.reedy

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

From report at bugs.python.org  Fri May 19 16:06:01 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 19 May 2017 20:06:01 +0000
Subject: [docs] [issue30372] Status of __builtins__ is not totally clear
In-Reply-To: <1494865238.41.0.458723699483.issue30372@psf.upfronthosting.co.za>
Message-ID: <1495224361.52.0.577841627836.issue30372@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

Moving "CPython implementation detail: " up a paragraph should be trivial.  Resolving the conflict between " __builtins__ can be set to a user-created dictionary to create a weak form of restricted execution." and "Users should not touch __builtins__;" seems less so.  I suspect the the latter was added well after the former, and that the former should have been deleted at that time.

----------
nosy: +terry.reedy
stage:  -> needs patch
type:  -> behavior

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

From report at bugs.python.org  Fri May 19 16:10:02 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 19 May 2017 20:10:02 +0000
Subject: [docs] [issue30376] Curses documentation refers to incorrect type
In-Reply-To: <1494882965.33.0.779610991751.issue30376@psf.upfronthosting.co.za>
Message-ID: <1495224602.51.0.658195682653.issue30376@psf.upfronthosting.co.za>


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


----------
stage:  -> needs patch
type:  -> behavior
versions:  -Python 3.3, Python 3.4

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

From report at bugs.python.org  Fri May 19 16:10:59 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 19 May 2017 20:10:59 +0000
Subject: [docs] [issue30376] Curses documentation refers to incorrect type
In-Reply-To: <1494882965.33.0.779610991751.issue30376@psf.upfronthosting.co.za>
Message-ID: <1495224659.82.0.753403761015.issue30376@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri May 19 19:44:18 2017
From: report at bugs.python.org (Eric N. Vander Weele)
Date: Fri, 19 May 2017 23:44:18 +0000
Subject: [docs] [issue28845] Clean up known issues for AIX
In-Reply-To: <1480542032.97.0.55863701863.issue28845@psf.upfronthosting.co.za>
Message-ID: <1495237458.39.0.200268976615.issue28845@psf.upfronthosting.co.za>


Changes by Eric N. Vander Weele <ericvw at gmail.com>:


----------
pull_requests: +1764

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

From report at bugs.python.org  Fri May 19 19:51:37 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Fri, 19 May 2017 23:51:37 +0000
Subject: [docs] [issue23674] super() documentation isn't very clear
In-Reply-To: <1426448451.56.0.492486239807.issue23674@psf.upfronthosting.co.za>
Message-ID: <1495237897.04.0.0533143010111.issue23674@psf.upfronthosting.co.za>


Cheryl Sabella added the comment:

I don't know if it's appropriate to add this to this ticket, but on the Data Model doc page, section 3.3.2.2 for Invoking Descriptors describes Super Binding.  A separate discussion with Nick in PR 1561 highlighted that section as a possible candidate for clarification.  It seemed to fit in with the discussion of super() and __mro__ here.

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

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

From report at bugs.python.org  Fri May 19 20:16:44 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Sat, 20 May 2017 00:16:44 +0000
Subject: [docs] [issue17188] Document 'from None' in raise statement doc.
In-Reply-To: <1360631999.8.0.76627095073.issue17188@psf.upfronthosting.co.za>
Message-ID: <1495239402.63.0.504195475367.issue17188@psf.upfronthosting.co.za>


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


----------
pull_requests: +1765

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

From report at bugs.python.org  Fri May 19 20:16:46 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Sat, 20 May 2017 00:16:46 +0000
Subject: [docs] [issue17188] Document 'from None' in raise statement doc.
In-Reply-To: <1360631999.8.0.76627095073.issue17188@psf.upfronthosting.co.za>
Message-ID: <1495239406.09.0.0553749078733.issue17188@psf.upfronthosting.co.za>


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


----------
pull_requests: +1765, 1766

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

From report at bugs.python.org  Sat May 20 02:48:30 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 20 May 2017 06:48:30 +0000
Subject: [docs] [issue17188] Document 'from None' in raise statement doc.
In-Reply-To: <1360631999.8.0.76627095073.issue17188@psf.upfronthosting.co.za>
Message-ID: <1495262910.52.0.165417758242.issue17188@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:


New changeset 763557eac06ba60d7c5133e4f80df8870d8f917e by terryjreedy (csabella) in branch 'master':
bpo-17188: DOC: Document 'from None' in raise statement (#1671)
https://github.com/python/cpython/commit/763557eac06ba60d7c5133e4f80df8870d8f917e


----------

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

From report at bugs.python.org  Sat May 20 02:48:50 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Sat, 20 May 2017 06:48:50 +0000
Subject: [docs] [issue23674] super() documentation isn't very clear
In-Reply-To: <1426448451.56.0.492486239807.issue23674@psf.upfronthosting.co.za>
Message-ID: <1495262930.55.0.243978048232.issue23674@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

Martin, can we just fix the signature here.  It is not the purpose of the super docs explain the MRO (that is a feature of all new-style classes, super() is just something that hops to the next in the chain) or to be a tutorial.  I would like to keep the rest of the docs mostly as-is.  These docs have already been refined multiple times and proven themselves usable for a lot of user).   The only part that wasn't previously edited was the parameter names for the signature.

----------

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

From report at bugs.python.org  Sat May 20 02:51:30 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 20 May 2017 06:51:30 +0000
Subject: [docs] [issue17188] Document 'from None' in raise statement doc.
In-Reply-To: <1360631999.8.0.76627095073.issue17188@psf.upfronthosting.co.za>
Message-ID: <1495263090.38.0.321104764488.issue17188@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

The double listing seems to be a glitch.

Either someone else does backport or online doc change waits until I can do it.

----------
assignee: docs at python -> terry.reedy
stage: patch review -> backport needed
versions: +Python 3.6, Python 3.7 -Python 3.4, Python 3.5

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

From report at bugs.python.org  Sat May 20 04:58:49 2017
From: report at bugs.python.org (Paul Moore)
Date: Sat, 20 May 2017 08:58:49 +0000
Subject: [docs] [issue30410] Documentation for sys.stdout encoding does not
 reflect the new Windows behavior in Python 3.6+
Message-ID: <1495270729.75.0.717879181788.issue30410@psf.upfronthosting.co.za>


New submission from Paul Moore:

The documentation for the encoding of sys.stdin/out/err (see https://docs.python.org/3.6/library/sys.html#sys.stdout) does not reflect the change in Python 3.6 on Windows to use the console Unicode APIs, and hence UTF-8 for the encoding.

----------
assignee: docs at python
components: Documentation, Windows
keywords: easy
messages: 294020
nosy: docs at python, paul.moore, steve.dower, tim.golden, zach.ware
priority: normal
severity: normal
status: open
title: Documentation for sys.stdout encoding does not reflect the new Windows behavior in Python 3.6+
type: behavior
versions: Python 3.6, Python 3.7

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

From report at bugs.python.org  Sat May 20 05:35:51 2017
From: report at bugs.python.org (Martin Panter)
Date: Sat, 20 May 2017 09:35:51 +0000
Subject: [docs] [issue20751] Misleading descriptor protocol documentation:
 direct call, super binding
In-Reply-To: <1393193636.36.0.125202538555.issue20751@psf.upfronthosting.co.za>
Message-ID: <1495272951.58.0.701844451143.issue20751@psf.upfronthosting.co.za>


Martin Panter added the comment:

Lower-case ?a? is defined at the top of the list: ?The starting point . . . is ?a.x?.? The last entry may fit in better if it was written ?If binding to an instance of ?super? ?.

The problem with the m() call is also mentioned in Issue 25777, about the descriptor how-to.

Issue 12077 seems to be largely about the __get__ signature.

----------
dependencies: +Harmonizing descriptor protocol documentation
nosy: +martin.panter, rhettinger
stage:  -> needs patch
title: Misleading examples in the descriptor protocol documentation -> Misleading descriptor protocol documentation: direct call, super binding
versions: +Python 2.7, Python 3.6, Python 3.7 -Python 3.4

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

From report at bugs.python.org  Sat May 20 06:32:19 2017
From: report at bugs.python.org (Martin Panter)
Date: Sat, 20 May 2017 10:32:19 +0000
Subject: [docs] [issue23674] super() documentation isn't very clear
In-Reply-To: <1426448451.56.0.492486239807.issue23674@psf.upfronthosting.co.za>
Message-ID: <1495276339.05.0.214051194714.issue23674@psf.upfronthosting.co.za>


Martin Panter added the comment:

Cheryl: see also Issue 25777 and Issue 20751, both about the ?super binding? under Invoking Descriptors.

Raymond: if you want to just pick parts of my patch, go for it. But I don?t understand your concern about explaining the MRO. I think it is important to explain which base classes are skipped, and which are searched. It is not just the type/subclass (super.__thisclass__) entry in the MRO that is skipped; this parameter determines the starting point, so the preceding entries are also skipped.

Another problem with referring to ?getattr? is that it checks for instance attributes and custom __getattr__ and __getattribute__ implementations, but I don?t think ?super? does any of that.

Looking at my patch now, I would propose that the exception message only be changed in the current (3.7) branch.

----------

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

From report at bugs.python.org  Sat May 20 09:36:56 2017
From: report at bugs.python.org (Mark Lawrence)
Date: Sat, 20 May 2017 13:36:56 +0000
Subject: [docs] [issue20751] Misleading descriptor protocol documentation:
 direct call, super binding
In-Reply-To: <1393193636.36.0.125202538555.issue20751@psf.upfronthosting.co.za>
Message-ID: <1495287416.35.0.987992846545.issue20751@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/issue20751>
_______________________________________

From report at bugs.python.org  Sat May 20 14:08:56 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Sat, 20 May 2017 18:08:56 +0000
Subject: [docs] [issue23674] super() documentation isn't very clear
In-Reply-To: <1426448451.56.0.492486239807.issue23674@psf.upfronthosting.co.za>
Message-ID: <1495303736.18.0.556083301132.issue23674@psf.upfronthosting.co.za>


Cheryl Sabella added the comment:

Thank you for pointing out those other links.  For me, they all tie together because I was originally trying to figure out why the data model page defined `super(B, obj).m()` instead of just `super().m()`.  It seems that the zero argument super is preferred, so I was trying to understand when to use the other form.  I didn't intend to question whether the docs needed to be rewritten.

----------

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

From report at bugs.python.org  Sat May 20 14:37:01 2017
From: report at bugs.python.org (Eryk Sun)
Date: Sat, 20 May 2017 18:37:01 +0000
Subject: [docs] [issue30410] Documentation for sys.stdout encoding does not
 reflect the new Windows behavior in Python 3.6+
In-Reply-To: <1495270729.75.0.717879181788.issue30410@psf.upfronthosting.co.za>
Message-ID: <1495305421.4.0.147160035599.issue30410@psf.upfronthosting.co.za>


Eryk Sun added the comment:

How about this?

    The character encoding is platform-dependent. Non-Windows 
    platforms use the locale encoding (see 
    locale.getpreferredencoding()).

    On Windows, UTF-8 is used for console character 
    devices (i.e. CON, CONIN$, and CONOUT$). However, this
    can be overridden to use the console as a generic 
    character device by setting the environment variable 
    PYTHONLEGACYWINDOWSSTDIO before starting Python. Non-
    character devices such as disk files and pipes use the 
    system locale encoding (i.e. the ANSI codepage). 
    Character devices such as NUL (i.e. isatty() returns 
    True) use the value of the console input and output
    codepages at startup, respectively for stdin and
    stdout/stderr. This defaults to the system locale
    encoding if the process is not initially attached to a
    console.

    Under all platforms, you can override this value by
    setting the PYTHONIOENCODING environment variable before
    starting Python. However, for the Windows console, this
    only applies when PYTHONLEGACYWINDOWSSTDIO is also set.

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

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

From report at bugs.python.org  Sat May 20 16:17:09 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Sat, 20 May 2017 20:17:09 +0000
Subject: [docs] [issue23560] Group the docs of similar methods in
 stdtypes.rst
In-Reply-To: <1425288490.4.0.288876913126.issue23560@psf.upfronthosting.co.za>
Message-ID: <1495311429.26.0.47975375941.issue23560@psf.upfronthosting.co.za>


Cheryl Sabella added the comment:

Hi Martin,

Do you think it would be good to move forward with this as a PR?


Thanks!

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

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

From report at bugs.python.org  Sat May 20 19:00:32 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Sat, 20 May 2017 23:00:32 +0000
Subject: [docs] [issue30419] Bdb: Update doc page
Message-ID: <1495321232.14.0.230718218205.issue30419@psf.upfronthosting.co.za>


New submission from Cheryl Sabella:

Update bdb docs to reflect issues found in #30211.

----------
assignee: docs at python
components: Documentation
messages: 294057
nosy: csabella, docs at python, terry.reedy
priority: normal
severity: normal
status: open
title: Bdb: Update doc page
type: enhancement
versions: Python 3.7

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

From report at bugs.python.org  Sat May 20 19:59:14 2017
From: report at bugs.python.org (Steve Dower)
Date: Sat, 20 May 2017 23:59:14 +0000
Subject: [docs] [issue30410] Documentation for sys.stdout encoding does not
 reflect the new Windows behavior in Python 3.6+
In-Reply-To: <1495270729.75.0.717879181788.issue30410@psf.upfronthosting.co.za>
Message-ID: <1495324754.54.0.743634237003.issue30410@psf.upfronthosting.co.za>


Steve Dower added the comment:

Looks great, though I wonder whether the rest of the paragraph after "Character devices such as NUL" would be more confusing than it's worth?

Can you create a PR? (And having links to the environment variable docs would be great.)

----------

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

From report at bugs.python.org  Sat May 20 20:53:24 2017
From: report at bugs.python.org (Eryk Sun)
Date: Sun, 21 May 2017 00:53:24 +0000
Subject: [docs] [issue30410] Documentation for sys.stdout encoding does not
 reflect the new Windows behavior in Python 3.6+
In-Reply-To: <1495270729.75.0.717879181788.issue30410@psf.upfronthosting.co.za>
Message-ID: <1495328004.58.0.171347369672.issue30410@psf.upfronthosting.co.za>


Eryk Sun added the comment:

I discussed character devices mostly because of the NUL device. It could be surprising that Python dies on an encoding error when output is redirected to NUL:

    C:\>chcp 1252
    Active code page: 1252

    C:\>python -c "print('\u20ac')" > nul
    C:\>chcp 437
    Active code page: 437

    C:\>python -c "print('\u20ac')" > nul
    Traceback (most recent call last):
      File "<string>", line 1, in <module>
      File "C:\Program Files\Python36\lib\encodings\cp437.py", line 19, in encode
        return codecs.charmap_encode(input,self.errors,encoding_map)[0]
    UnicodeEncodeError: 'charmap' codec can't encode character '\u20ac' in position 0:
    character maps to <undefined>

Unix has a similar problem:

    $ LANG=C python3 -c 'print("\u20ac")' > /dev/null
    Traceback (most recent call last):
      File "<string>", line 1, in <module>
    UnicodeEncodeError: 'ascii' codec can't encode character '\u20ac' in position 0:
    ordinal not in range(128)

Except /dev/null isn't a TTY. Also, it's rare nowadays for the locale encoding in Unix systems to be something other than UTF-8.

It would be useful if we special-cased NUL like we do for the Windows console, but just to make it use the backslashreplace error handler. Unfortunately I don't know how to do that without calling NtQueryObject, for which ObjectNameInformation (1) can't be used because it's undocumented [1]. GetFinalPathNameByHandle also can't be used because it requires file-system devices. As a crude workaround, we could lump together all non-console character devices (i.e. isatty() but not a console). That will affect serial devices, too, but I can't think of a good reason someone would redirect stdout or stderr to a COM port.

[1]: https://msdn.microsoft.com/en-us/library/ff550964

----------

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

From report at bugs.python.org  Sat May 20 23:29:11 2017
From: report at bugs.python.org (Nick Coghlan)
Date: Sun, 21 May 2017 03:29:11 +0000
Subject: [docs] [issue30420] Clarify kwarg handing for subprocess
 convenience APIs
Message-ID: <1495337351.2.0.395497440987.issue30420@psf.upfronthosting.co.za>


New submission from Nick Coghlan:

As per the discussion in https://github.com/python/cpython/pull/1685, the current nominal signatures of the convenience APIs in subprocess is confusing, as they don't make it clear that all Popen keyword arguments are supported, with only the most common ones being listed in the signature.

Proposed fixes:

* add `cwd` to the list of frequently used arguments, and list it in the nominal signatures for `run()`, `call()`, `check_call()`, and `check_output()`
* append `**popenargs` to the nominal signatures of `run()`, `call()`, and `check_call()`
* append `**runargs` to the nominal signature of `check_output()`
* amend the prose descriptions for these functions accordingly

Background:

The status quo is that while this behaviour is documented, it's documented solely as text in the bodies of the API definitions, using paragraphs like the following:

`run()`: """The arguments shown above are merely the most common ones, described below in Frequently Used Arguments (hence the use of keyword-only notation in the abbreviated signature). The full function signature is largely the same as that of the Popen constructor - apart from timeout, input and check, all the arguments to this function are passed through to that interface."""

`call()`, `check_call()`: """The arguments shown above are merely the most common ones. The full function signature is largely the same as that of the Popen constructor - this function passes all supplied arguments other than timeout directly through to that interface."""

`check_output()`: """The arguments shown above are merely the most common ones. The full function signature is largely the same as that of run() - most arguments are passed directly through to that interface."""

While it's technically anecdotal, we still have pretty decent evidence that this isn't adequate as:

- I worked on the original patch splitting out the "Frequently Used Arguments" section, and initially missed not only that the run() docs had retained that paragraph, but also missed the revised paragraphs in the relocated docs for the older API
- as mentioned in the linked PR, Paul Kehrer had missed that `check_call()` and `check_output()` both supported the Popen `cwd` parameter

The working theory behind adding the appropriately named `**kwargs` parameters to the end of the nominal signatures is that it will give readers a clearer indication that we're *not* explicitly listing all the parameters, and a hint as to which API to go look at to find out more about the unlisted ones.

----------
assignee: docs at python
components: Documentation
messages: 294070
nosy: docs at python, ncoghlan
priority: normal
severity: normal
stage: needs patch
status: open
title: Clarify kwarg handing for subprocess convenience APIs
type: enhancement
versions: Python 3.5, Python 3.6, Python 3.7

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

From report at bugs.python.org  Sat May 20 23:32:37 2017
From: report at bugs.python.org (Alex Gaynor)
Date: Sun, 21 May 2017 03:32:37 +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: <1495337557.72.0.00989955797225.issue30420@psf.upfronthosting.co.za>


Changes by Alex Gaynor <alex.gaynor at gmail.com>:


----------
pull_requests: +1781

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

From report at bugs.python.org  Sun May 21 00:34:36 2017
From: report at bugs.python.org (Sanyam Khurana)
Date: Sun, 21 May 2017 04:34:36 +0000
Subject: [docs] [issue29710] Incorrect representation caveat on bitwise
 operation docs
In-Reply-To: <1488551919.31.0.20533072889.issue29710@psf.upfronthosting.co.za>
Message-ID: <1495341276.77.0.357697136029.issue29710@psf.upfronthosting.co.za>


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


----------
pull_requests: +1784

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

From report at bugs.python.org  Sun May 21 01:31:04 2017
From: report at bugs.python.org (Martin Panter)
Date: Sun, 21 May 2017 05:31:04 +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: <1495344664.32.0.3976467909.issue30420@psf.upfronthosting.co.za>


Martin Panter added the comment:

For the curious, Nick added the ?frequently used arguments? in Issue 13237. Before that the signatures were like <https://docs.python.org/release/3.2.2/library/subprocess.html#convenience-functions>:

subprocess.call(*popenargs, **kwargs)

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

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

From report at bugs.python.org  Sun May 21 02:06:37 2017
From: report at bugs.python.org (Martin Panter)
Date: Sun, 21 May 2017 06:06:37 +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: <1495346797.15.0.6161289621.issue30420@psf.upfronthosting.co.za>


Martin Panter added the comment:

If you add ?cwd? to Frequently Use Arguments, please try to keep the details in one place. Otherwise you encourage a fix for Issue 15533 (cwd platform specifics) to repeat the problem of Issue 20344 (args vs shell platform specifics), where some details are only found in one section and contradict the other section.

----------

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

From report at bugs.python.org  Sun May 21 02:53:12 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Sun, 21 May 2017 06:53:12 +0000
Subject: [docs] [issue23560] Group the docs of similar methods in
 stdtypes.rst
In-Reply-To: <1425288490.4.0.288876913126.issue23560@psf.upfronthosting.co.za>
Message-ID: <1495349592.55.0.438844682841.issue23560@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

I don't think this should be done.  Instead, add a table at the top listing the functions in groups, possibly linking to the alphabetical details docs below.

When looking a what a string method does, alphabetical makes the search easier than having to guess which group something is in before you can find it.

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

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

From report at bugs.python.org  Sun May 21 05:25:45 2017
From: report at bugs.python.org (Mark Dickinson)
Date: Sun, 21 May 2017 09:25:45 +0000
Subject: [docs] [issue29710] Incorrect representation caveat on bitwise
 operation docs
In-Reply-To: <1488551919.31.0.20533072889.issue29710@psf.upfronthosting.co.za>
Message-ID: <1495358745.07.0.688355292884.issue29710@psf.upfronthosting.co.za>


Mark Dickinson added the comment:

So on re-reading the docs, I think we're misinterpreting this part:

> this assumes that there are enough bits so that no overflow occurs during the operation

One way to think of | and & (and ~ and ^, too):

1. Find a positive integer n such that both x and y can be represented *without overflow* in n-bit two's complement.

2. Do the computation x | y (or x & y, x ^ y, ~x, as appropriate) in n-bit two's-complement arithmetic, giving an n-bit two's complement result that we re-interpret as a signed integer in the usual way.

I think the "so that no overflow occurs" refers to choosing n sufficient large in the first step above. Note that it doesn't matter what value of n we choose to use, so long as it's large enough: evaluating 5 & -17 will work just as well using 8-bit two's complement as using 23-bit two's complement --- we'll get the same result either way.

(I personally tend to find it easier to think in terms of the infinite 2-adic representation, which is essentially what you get by extending the 0 or 1 sign bit leftwards into an infinite string of 0s or 1s.)

----------

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

From report at bugs.python.org  Sun May 21 05:27:33 2017
From: report at bugs.python.org (Mark Dickinson)
Date: Sun, 21 May 2017 09:27:33 +0000
Subject: [docs] [issue29710] Incorrect representation caveat on bitwise
 operation docs
In-Reply-To: <1488551919.31.0.20533072889.issue29710@psf.upfronthosting.co.za>
Message-ID: <1495358853.65.0.646839356395.issue29710@psf.upfronthosting.co.za>


Mark Dickinson added the comment:

Adding Tim Peters to the nosy, since I suspect (without actually having checked) that this is his language.

----------
nosy: +tim.peters

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

From report at bugs.python.org  Sun May 21 06:11:06 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 21 May 2017 10:11:06 +0000
Subject: [docs] [issue30419] Bdb: Update doc page
In-Reply-To: <1495321232.14.0.230718218205.issue30419@psf.upfronthosting.co.za>
Message-ID: <1495361466.31.0.983789720601.issue30419@psf.upfronthosting.co.za>


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


----------
pull_requests: +1791

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

From report at bugs.python.org  Sun May 21 11:43:37 2017
From: report at bugs.python.org (Jelle Zijlstra)
Date: Sun, 21 May 2017 15:43:37 +0000
Subject: [docs] [issue30424] make pydoc-topics fails
In-Reply-To: <1495381376.42.0.658045095039.issue30424@psf.upfronthosting.co.za>
Message-ID: <1495381417.3.0.735459444772.issue30424@psf.upfronthosting.co.za>


Changes by Jelle Zijlstra <jelle.zijlstra at gmail.com>:


----------
assignee:  -> docs at python
components: +Documentation
nosy: +docs at python
stage:  -> needs patch
versions: +Python 3.7

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

From report at bugs.python.org  Sun May 21 16:57:02 2017
From: report at bugs.python.org (G Young)
Date: Sun, 21 May 2017 20:57:02 +0000
Subject: [docs] [issue30361] Docs example: converting mixed types to
 floating point
In-Reply-To: <1494752919.15.0.561616045601.issue30361@psf.upfronthosting.co.za>
Message-ID: <1495400222.22.0.606098526059.issue30361@psf.upfronthosting.co.za>


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


----------
pull_requests: +1797

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

From report at bugs.python.org  Sun May 21 20:54:43 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Mon, 22 May 2017 00:54:43 +0000
Subject: [docs] [issue23560] Group the docs of similar methods in
 stdtypes.rst
In-Reply-To: <1425288490.4.0.288876913126.issue23560@psf.upfronthosting.co.za>
Message-ID: <1495414483.57.0.668100700333.issue23560@psf.upfronthosting.co.za>


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


----------
pull_requests: +1800

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

From report at bugs.python.org  Sun May 21 20:58:25 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Mon, 22 May 2017 00:58:25 +0000
Subject: [docs] [issue23560] Group the docs of similar methods in
 stdtypes.rst
In-Reply-To: <1425288490.4.0.288876913126.issue23560@psf.upfronthosting.co.za>
Message-ID: <1495414704.81.0.383483209507.issue23560@psf.upfronthosting.co.za>


Cheryl Sabella added the comment:

I hope this is OK, but I created a version of the patch with a table as Raymond suggested.  I didn't know how to make a patch, so I did it in a PR.  I wanted to have a comparison available to see the differences between the two versions.  I used the original categories as defined by Martin.

I could also add a bytearray column if the table looks reasonable.

Thanks!

----------

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

From report at bugs.python.org  Sun May 21 21:55:40 2017
From: report at bugs.python.org (G Young)
Date: Mon, 22 May 2017 01:55:40 +0000
Subject: [docs] [issue29596] Unfinished sentense in howto/clinic.rst
In-Reply-To: <1487380332.64.0.682733186171.issue29596@psf.upfronthosting.co.za>
Message-ID: <1495418140.31.0.137311235489.issue29596@psf.upfronthosting.co.za>


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


----------
pull_requests: +1801

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

From report at bugs.python.org  Mon May 22 14:51:43 2017
From: report at bugs.python.org (Caleb Hattingh)
Date: Mon, 22 May 2017 18:51:43 +0000
Subject: [docs] [issue30433] Devguide lacks instructions for building docs
Message-ID: <1495479103.65.0.491386375497.issue30433@psf.upfronthosting.co.za>


New submission from Caleb Hattingh:

The official devguide at https://github.com/python/devguide does not include instructions on exactly how to build the docs!  If, after cloning, you simply type `make`, you get some helpful output:

$ make
Please use `make <target>' where <target> is one of
  html       to make standalone HTML files
  dirhtml    to make HTML files named index.html in directories
  singlehtml to make a single large HTML file
  pickle     to make pickle files
  json       to make JSON files
  htmlhelp   to make HTML files and a HTML help project
  qthelp     to make HTML files and a qthelp project
  devhelp    to make HTML files and a Devhelp project
  epub       to make an epub
  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter
  latexpdf   to make LaTeX files and run them through pdflatex
  text       to make text files
  man        to make manual pages
  changes    to make an overview of all changed/added/deprecated items
  linkcheck  to check all external links for integrity
  doctest    to run all doctests embedded in the documentation (if enabled)
  check      to run a check for frequent markup errors

However, in order to build, say, HTML, you need to have sphinx installed in your environment.  I would like to add a `requirements.txt` file that will specify which dependencies must be installed (into a virtualenv, probably), in order to successfully build the documentation.  In the GitHub PR, I have also added a BUILDING.rst that explains how to install the dependencies for building the documentation.

----------
assignee: docs at python
components: Documentation
messages: 294170
nosy: cjrh, docs at python
priority: normal
pull_requests: 1812
severity: normal
status: open
title: Devguide lacks instructions for building docs
versions: Python 3.7

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

From report at bugs.python.org  Mon May 22 15:00:55 2017
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Mon, 22 May 2017 19:00:55 +0000
Subject: [docs] [issue30433] Devguide lacks instructions for building docs
In-Reply-To: <1495479103.65.0.491386375497.issue30433@psf.upfronthosting.co.za>
Message-ID: <1495479654.99.0.135381734855.issue30433@psf.upfronthosting.co.za>


St?phane Wirtel added the comment:

Hello,

Are you sure about the PR ?

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

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

From report at bugs.python.org  Mon May 22 15:20:21 2017
From: report at bugs.python.org (Caleb Hattingh)
Date: Mon, 22 May 2017 19:20:21 +0000
Subject: [docs] [issue30433] Devguide lacks instructions for building docs
In-Reply-To: <1495479103.65.0.491386375497.issue30433@psf.upfronthosting.co.za>
Message-ID: <1495480821.14.0.791567255166.issue30433@psf.upfronthosting.co.za>


Changes by Caleb Hattingh <caleb.hattingh at gmail.com>:


----------
pull_requests:  -1812

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

From report at bugs.python.org  Mon May 22 15:21:46 2017
From: report at bugs.python.org (Caleb Hattingh)
Date: Mon, 22 May 2017 19:21:46 +0000
Subject: [docs] [issue30433] Devguide lacks instructions for building docs
In-Reply-To: <1495479103.65.0.491386375497.issue30433@psf.upfronthosting.co.za>
Message-ID: <1495480906.92.0.495139561346.issue30433@psf.upfronthosting.co.za>


Caleb Hattingh added the comment:

Oops, sorry!  The PR was wrong because it auto-assumes the main cpython repo, but my PR is in the devguide repo. This is the URL for the PR:

https://github.com/python/devguide/pull/206

----------

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

From report at bugs.python.org  Mon May 22 16:40:12 2017
From: report at bugs.python.org (Naomi Ceder)
Date: Mon, 22 May 2017 20:40:12 +0000
Subject: [docs] [issue30372] Status of __builtins__ is not totally clear
In-Reply-To: <1494865238.41.0.458723699483.issue30372@psf.upfronthosting.co.za>
Message-ID: <1495485612.75.0.148167080287.issue30372@psf.upfronthosting.co.za>


Changes by Naomi Ceder <naomi.ceder at gmail.com>:


----------
pull_requests: +1813

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

From report at bugs.python.org  Mon May 22 16:41:19 2017
From: report at bugs.python.org (Naomi Ceder)
Date: Mon, 22 May 2017 20:41:19 +0000
Subject: [docs] [issue30372] Status of __builtins__ is not totally clear
In-Reply-To: <1494865238.41.0.458723699483.issue30372@psf.upfronthosting.co.za>
Message-ID: <1495485679.4.0.830909104922.issue30372@psf.upfronthosting.co.za>


Naomi Ceder added the comment:

Created a PR on this... it seems that making the Implementation Detail warning come first and deleting the limited execution sentence achieves what's needed here.

----------
nosy: +NaomiCeder

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

From report at bugs.python.org  Mon May 22 16:50:13 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 22 May 2017 20:50:13 +0000
Subject: [docs] [issue30372] Status of __builtins__ is not totally clear
In-Reply-To: <1494865238.41.0.458723699483.issue30372@psf.upfronthosting.co.za>
Message-ID: <1495486213.54.0.777407841345.issue30372@psf.upfronthosting.co.za>


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


----------
stage: needs patch -> patch review
versions: +Python 3.7

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

From report at bugs.python.org  Mon May 22 17:09:57 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 22 May 2017 21:09:57 +0000
Subject: [docs] [issue30372] Status of __builtins__ is not totally clear
In-Reply-To: <1494865238.41.0.458723699483.issue30372@psf.upfronthosting.co.za>
Message-ID: <1495487397.44.0.219090593671.issue30372@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 43c8a9e39bb2d4f25ed7ae17a55f34e375d1868b by Mariatta (Naomi Ceder) in branch 'master':
bpo-30372: Clarify that '__builtins__' is a CPython Implementation detail (GH-1725)
https://github.com/python/cpython/commit/43c8a9e39bb2d4f25ed7ae17a55f34e375d1868b


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

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

From report at bugs.python.org  Mon May 22 17:17:05 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 22 May 2017 21:17:05 +0000
Subject: [docs] [issue30372] Status of __builtins__ is not totally clear
In-Reply-To: <1494865238.41.0.458723699483.issue30372@psf.upfronthosting.co.za>
Message-ID: <1495487825.75.0.325224209566.issue30372@psf.upfronthosting.co.za>


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


----------
pull_requests: +1817

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

From report at bugs.python.org  Mon May 22 17:36:21 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 22 May 2017 21:36:21 +0000
Subject: [docs] [issue30372] Status of __builtins__ is not totally clear
In-Reply-To: <1494865238.41.0.458723699483.issue30372@psf.upfronthosting.co.za>
Message-ID: <1495488981.23.0.935062685941.issue30372@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 3d3b189f8ef321ccfb144a46d50892939d6004aa by Mariatta in branch '3.6':
[3.6] bpo-30372: Clarify that '__builtins__' is a CPython Implementation detail (GH-1725) (GH-1727)
https://github.com/python/cpython/commit/3d3b189f8ef321ccfb144a46d50892939d6004aa


----------

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

From report at bugs.python.org  Mon May 22 17:37:10 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 22 May 2017 21:37:10 +0000
Subject: [docs] [issue30372] Status of __builtins__ is not totally clear
In-Reply-To: <1494865238.41.0.458723699483.issue30372@psf.upfronthosting.co.za>
Message-ID: <1495489029.98.0.490936261658.issue30372@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

PR merged, and I backport it to 3.6

Thanks everyone :)

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

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

From report at bugs.python.org  Mon May 22 17:53:17 2017
From: report at bugs.python.org (Jamiel Almeida)
Date: Mon, 22 May 2017 21:53:17 +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: <1495489997.03.0.273813019596.issue24899@psf.upfronthosting.co.za>


Jamiel Almeida added the comment:

I'm picking this up.

----------
nosy: +slashfoo
versions: +Python 3.7 -Python 3.5, Python 3.6

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

From report at bugs.python.org  Mon May 22 17:53:26 2017
From: report at bugs.python.org (Sayan Chowdhury)
Date: Mon, 22 May 2017 21:53:26 +0000
Subject: [docs] [issue30274] Make
 importlib.abc.ExtensionFileLoader.__init__() documentation match code
In-Reply-To: <1493936689.45.0.0881901800669.issue30274@psf.upfronthosting.co.za>
Message-ID: <1495490006.57.0.0532463597734.issue30274@psf.upfronthosting.co.za>


Sayan Chowdhury added the comment:

I am starting to work on this issue.

----------
nosy: +sayanchowdhury

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

From report at bugs.python.org  Mon May 22 19:06:47 2017
From: report at bugs.python.org (Alex Perry)
Date: Mon, 22 May 2017 23:06:47 +0000
Subject: [docs] [issue27269] ipaddress: Wrong behavior with ::ffff:1.2.3.4
 style IPs
In-Reply-To: <1465397723.89.0.175384049159.issue27269@psf.upfronthosting.co.za>
Message-ID: <1495494407.44.0.629406211467.issue27269@psf.upfronthosting.co.za>


Alex Perry added the comment:

https://github.com/python/cpython/commit/5cc274262a99e5633177fc540261abbbecbbc51c

... seems to implement the principle in this bug, but I'm not convinced this is a good idea.

----------
nosy: +arp11

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

From report at bugs.python.org  Mon May 22 19:31:00 2017
From: report at bugs.python.org (Sayan Chowdhury)
Date: Mon, 22 May 2017 23:31:00 +0000
Subject: [docs] [issue30274] Make
 importlib.abc.ExtensionFileLoader.__init__() documentation match code
In-Reply-To: <1493936689.45.0.0881901800669.issue30274@psf.upfronthosting.co.za>
Message-ID: <1495495860.57.0.738701782761.issue30274@psf.upfronthosting.co.za>


Changes by Sayan Chowdhury <sayan.chowdhury2012 at gmail.com>:


----------
pull_requests: +1826

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

From report at bugs.python.org  Mon May 22 19:32:59 2017
From: report at bugs.python.org (ipatrol)
Date: Mon, 22 May 2017 23:32:59 +0000
Subject: [docs] [issue30435] Documentation either unclear or incorrect on
 comparisons between bytes and strings in Python 3
Message-ID: <1495495979.22.0.902310404899.issue30435@psf.upfronthosting.co.za>


New submission from ipatrol:

https://docs.python.org/3/reference/expressions.html#comparisons says that "Strings and binary sequences cannot be directly compared." That would seem to me to imply that an equality between them would raise an exception, as also claimed by https://wiki.python.org/moin/BytesStr

However, that is manifestly incorrect. Bytes and strings can be compared: they are always unequal. This appears to be a result of the operation falling through to the default comparison, which returns False since they are not identical objects. Equality is a comparison, though it is not an order comparison. A brief search of the word "cannot" in the documentation suggest that saying a certain thing cannot be done usually implies that attempting to do so anyway will raise an exception, typically a TypeError. That this is not the case for string-bytes comparisons should be mentioned.

----------
assignee: docs at python
components: Documentation
messages: 294200
nosy: docs at python, ipatrol
priority: normal
severity: normal
status: open
title: Documentation either unclear or incorrect on comparisons between bytes and strings in Python 3
type: behavior
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/issue30435>
_______________________________________

From report at bugs.python.org  Mon May 22 19:34:38 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 22 May 2017 23:34:38 +0000
Subject: [docs] [issue30435] Documentation either unclear or incorrect on
 comparisons between bytes and strings in Python 3
In-Reply-To: <1495495979.22.0.902310404899.issue30435@psf.upfronthosting.co.za>
Message-ID: <1495496078.19.0.532988274616.issue30435@psf.upfronthosting.co.za>


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


----------
versions:  -Python 3.4, Python 3.5

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

From report at bugs.python.org  Mon May 22 19:34:45 2017
From: report at bugs.python.org (Naomi Ceder)
Date: Mon, 22 May 2017 23:34:45 +0000
Subject: [docs] [issue30424] make pydoc-topics fails
In-Reply-To: <1495381376.42.0.658045095039.issue30424@psf.upfronthosting.co.za>
Message-ID: <1495496085.6.0.257238889481.issue30424@psf.upfronthosting.co.za>


Naomi Ceder added the comment:

This issue is related to the version of sphinx. When I tested with sphinx 1.3.6 it worked fine, but with sphinx 1.6.2 I did get the error.

----------
nosy: +NaomiCeder

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

From report at bugs.python.org  Mon May 22 19:40:39 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 22 May 2017 23:40:39 +0000
Subject: [docs] [issue30435] Documentation either unclear or incorrect on
 comparisons between bytes and strings in Python 3
In-Reply-To: <1495495979.22.0.902310404899.issue30435@psf.upfronthosting.co.za>
Message-ID: <1495496439.18.0.734796704325.issue30435@psf.upfronthosting.co.za>


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


----------
versions: +Python 2.7, Python 3.5 -Python 3.3

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

From report at bugs.python.org  Mon May 22 20:08:58 2017
From: report at bugs.python.org (Alex Perry)
Date: Tue, 23 May 2017 00:08:58 +0000
Subject: [docs] [issue27269] ipaddress: Wrong behavior with ::ffff:1.2.3.4
 style IPs
In-Reply-To: <1465397723.89.0.175384049159.issue27269@psf.upfronthosting.co.za>
Message-ID: <1495498138.84.0.91808346916.issue27269@psf.upfronthosting.co.za>


Changes by Alex Perry <arp11 at pamurray.com>:


----------
pull_requests: +1831

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

From report at bugs.python.org  Mon May 22 20:16:11 2017
From: report at bugs.python.org (Kushal Das)
Date: Tue, 23 May 2017 00:16:11 +0000
Subject: [docs] [issue30376] Curses documentation refers to incorrect type
In-Reply-To: <1494882965.33.0.779610991751.issue30376@psf.upfronthosting.co.za>
Message-ID: <1495498569.94.0.571939652618.issue30376@psf.upfronthosting.co.za>


Kushal Das added the comment:


New changeset 93fc20b73eea3da0b6305aaee951e5dd22d5c408 by Kushal Das (Berker Peksag) in branch 'master':
bpo-30376: Update outdated WindowObject references (#1630)
https://github.com/python/cpython/commit/93fc20b73eea3da0b6305aaee951e5dd22d5c408


----------
nosy: +kushal.das

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

From report at bugs.python.org  Mon May 22 20:18:36 2017
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 23 May 2017 00:18:36 +0000
Subject: [docs] [issue30380] Sphinx 1.6.1 raising new warnings in docs build
In-Reply-To: <1494955773.64.0.780886638634.issue30380@psf.upfronthosting.co.za>
Message-ID: <1495498715.36.0.257428423777.issue30380@psf.upfronthosting.co.za>


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


----------
pull_requests: +1833

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

From report at bugs.python.org  Mon May 22 20:35:30 2017
From: report at bugs.python.org (Kushal Das)
Date: Tue, 23 May 2017 00:35:30 +0000
Subject: [docs] [issue30376] Curses documentation refers to incorrect type
In-Reply-To: <1494882965.33.0.779610991751.issue30376@psf.upfronthosting.co.za>
Message-ID: <1495499730.99.0.371313202862.issue30376@psf.upfronthosting.co.za>


Changes by Kushal Das <mail at kushaldas.in>:


----------
pull_requests: +1835

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

From report at bugs.python.org  Mon May 22 20:35:35 2017
From: report at bugs.python.org (Kushal Das)
Date: Tue, 23 May 2017 00:35:35 +0000
Subject: [docs] [issue30376] Curses documentation refers to incorrect type
In-Reply-To: <1494882965.33.0.779610991751.issue30376@psf.upfronthosting.co.za>
Message-ID: <1495499735.66.0.407552746197.issue30376@psf.upfronthosting.co.za>


Changes by Kushal Das <mail at kushaldas.in>:


----------
pull_requests: +1836

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

From report at bugs.python.org  Mon May 22 21:10:26 2017
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 23 May 2017 01:10:26 +0000
Subject: [docs] [issue30380] Sphinx 1.6.1 raising new warnings in docs build
In-Reply-To: <1494955773.64.0.780886638634.issue30380@psf.upfronthosting.co.za>
Message-ID: <1495501826.82.0.030155492438.issue30380@psf.upfronthosting.co.za>


Brett Cannon added the comment:

All branches are now pinned to and working under Sphinx 1.6.1, so I'm closing this as fixed!

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

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

From report at bugs.python.org  Tue May 23 01:09:44 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 23 May 2017 05:09:44 +0000
Subject: [docs] [issue21056] csv documentation is incorrect
In-Reply-To: <1395720703.0.0.19592596057.issue21056@psf.upfronthosting.co.za>
Message-ID: <1495516184.46.0.680088485833.issue21056@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset d618c8c6d31b9b288f8a070417683974eb98e3ba by Mariatta (Amit Kumar) in branch 'master':
bpo-21056: Document return type of next method of csv reader (#146)
https://github.com/python/cpython/commit/d618c8c6d31b9b288f8a070417683974eb98e3ba


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

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

From report at bugs.python.org  Tue May 23 01:10:22 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 23 May 2017 05:10:22 +0000
Subject: [docs] [issue21056] csv documentation is incorrect
In-Reply-To: <1395720703.0.0.19592596057.issue21056@psf.upfronthosting.co.za>
Message-ID: <1495516222.38.0.646931647347.issue21056@psf.upfronthosting.co.za>


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


----------
stage: needs patch -> backport needed
versions: +Python 3.7 -Python 2.7

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

From report at bugs.python.org  Tue May 23 01:11:45 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 23 May 2017 05:11:45 +0000
Subject: [docs] [issue21056] csv documentation is incorrect
In-Reply-To: <1395720703.0.0.19592596057.issue21056@psf.upfronthosting.co.za>
Message-ID: <1495516305.15.0.734881804738.issue21056@psf.upfronthosting.co.za>


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


----------
pull_requests: +1837

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

From report at bugs.python.org  Tue May 23 01:12:01 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 23 May 2017 05:12:01 +0000
Subject: [docs] [issue21056] csv documentation is incorrect
In-Reply-To: <1395720703.0.0.19592596057.issue21056@psf.upfronthosting.co.za>
Message-ID: <1495516321.59.0.666323140323.issue21056@psf.upfronthosting.co.za>


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


----------
pull_requests: +1838

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

From report at bugs.python.org  Tue May 23 01:25:35 2017
From: report at bugs.python.org (Eryk Sun)
Date: Tue, 23 May 2017 05:25:35 +0000
Subject: [docs] [issue30435] Documentation either unclear or incorrect on
 comparisons between bytes and strings in Python 3
In-Reply-To: <1495495979.22.0.902310404899.issue30435@psf.upfronthosting.co.za>
Message-ID: <1495517135.14.0.062089088693.issue30435@psf.upfronthosting.co.za>


Eryk Sun added the comment:

How about "cannot be compared by value" or "cannot be ordered by value"? Emphasizing the value aspect doesn't conflict with the default equality comparison by identity.

Note that starting Python with the -b option causes the bytes type to raise a warning in this case:

    >>> sys.flags.bytes_warning
    1
    >>> 'a'.__eq__(b'a')
    NotImplemented

    >>> b'a'.__eq__('a')
    __main__:1: BytesWarning: Comparison between bytes and string
    NotImplemented

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

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

From report at bugs.python.org  Tue May 23 01:27:04 2017
From: report at bugs.python.org (=?utf-8?q?=C5=81ukasz_Langa?=)
Date: Tue, 23 May 2017 05:27:04 +0000
Subject: [docs] [issue21056] csv documentation is incorrect
In-Reply-To: <1395720703.0.0.19592596057.issue21056@psf.upfronthosting.co.za>
Message-ID: <1495517224.88.0.55213349467.issue21056@psf.upfronthosting.co.za>


?ukasz Langa added the comment:


New changeset 6ef0882303cff24c58785bb1082250088266886d by ?ukasz Langa (Mariatta) in branch '3.6':
[3.6] bpo-21056: Document return type of next method of csv reader (GH-146) (#1749)
https://github.com/python/cpython/commit/6ef0882303cff24c58785bb1082250088266886d


----------
nosy: +lukasz.langa

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

From report at bugs.python.org  Tue May 23 01:27:13 2017
From: report at bugs.python.org (=?utf-8?q?=C5=81ukasz_Langa?=)
Date: Tue, 23 May 2017 05:27:13 +0000
Subject: [docs] [issue21056] csv documentation is incorrect
In-Reply-To: <1395720703.0.0.19592596057.issue21056@psf.upfronthosting.co.za>
Message-ID: <1495517233.08.0.18008299732.issue21056@psf.upfronthosting.co.za>


?ukasz Langa added the comment:


New changeset 32dcf426ad2ae10e24e92f60e99dbb4939fb2021 by ?ukasz Langa (Mariatta) in branch '3.5':
[3.5] bpo-21056: Document return type of next method of csv reader (GH-146) (#1750)
https://github.com/python/cpython/commit/32dcf426ad2ae10e24e92f60e99dbb4939fb2021


----------

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

From report at bugs.python.org  Tue May 23 01:36:21 2017
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 23 May 2017 05:36:21 +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: <1495517781.61.0.193428642017.issue24899@psf.upfronthosting.co.za>


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


----------
pull_requests: +1840

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

From report at bugs.python.org  Tue May 23 02:11:26 2017
From: report at bugs.python.org (Martin Panter)
Date: Tue, 23 May 2017 06:11:26 +0000
Subject: [docs] [issue30435] Documentation either unclear or incorrect on
 comparisons between bytes and strings in Python 3
In-Reply-To: <1495495979.22.0.902310404899.issue30435@psf.upfronthosting.co.za>
Message-ID: <1495519886.68.0.820282889272.issue30435@psf.upfronthosting.co.za>


Martin Panter added the comment:

Also, ?-bb? turns it into an exception, and the same applies to bytes vs int:

>>> b"a" == "a"
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
BytesWarning: Comparison between bytes and string
>>> b"a" == 0x61
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
BytesWarning: Comparison between bytes and int

Perhaps the documentation should say ?should not be compared? rather than ?cannot?. Or perhaps it should mention ?-b?.

Mariatta: I don?t think this is relevant to 2.7. In 2.7, you do get an error with bytearray vs unicode, but bytearray is not discussed in this bit of the Py 2 documentation.

----------
nosy: +Mariatta, martin.panter

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

From report at bugs.python.org  Tue May 23 02:16:50 2017
From: report at bugs.python.org (Martin Panter)
Date: Tue, 23 May 2017 06:16:50 +0000
Subject: [docs] [issue29321] Wrong documentation (Language Ref) for unicode
 and str comparison
In-Reply-To: <1484836003.73.0.224345826816.issue29321@psf.upfronthosting.co.za>
Message-ID: <1495520210.88.0.0293063864593.issue29321@psf.upfronthosting.co.za>


Martin Panter added the comment:

I backported Issue 12067 documentation, so hopefully this is fixed.

----------
resolution:  -> out of date
stage:  -> resolved
status: open -> closed
superseder:  -> Doc: remove errors about mixed-type comparisons.

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

From report at bugs.python.org  Tue May 23 04:13:45 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 23 May 2017 08:13:45 +0000
Subject: [docs] [issue21056] csv documentation is incorrect
In-Reply-To: <1395720703.0.0.19592596057.issue21056@psf.upfronthosting.co.za>
Message-ID: <1495527225.34.0.935809201058.issue21056@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/issue21056>
_______________________________________

From report at bugs.python.org  Tue May 23 04:15:00 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 23 May 2017 08:15:00 +0000
Subject: [docs] [issue30435] Documentation either unclear or incorrect on
 comparisons between bytes and strings in Python 3
In-Reply-To: <1495495979.22.0.902310404899.issue30435@psf.upfronthosting.co.za>
Message-ID: <1495527300.71.0.906266732276.issue30435@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Tue May 23 08:52:21 2017
From: report at bugs.python.org (Andrew Dalke)
Date: Tue, 23 May 2017 12:52:21 +0000
Subject: [docs] [issue30440] document peephole optimizer effects
Message-ID: <1495543941.79.0.954903712475.issue30440@psf.upfronthosting.co.za>


New submission from Andrew Dalke:

The peephole optimizer is an overall benefit to Python but it has some side-effects that occasionally cause problems. These are well-known in the issue tracker, but there is no other documentation which will help a Python programmer figure out which constructs may be a problem.

1) it will compute large integer constants and save them in the .pyc file. The following results in a 19M .pyc file. 

def compute_largest_known_prime():
  return 2**74207281 - 1

As an example of someone affected by the compile-time evaluation, see https://stackoverflow.com/questions/34113609/why-does-python-preemptively-hang-when-trying-to-calculate-a-very-large-number/ . Note the many people who struggled to find definitive documentation.

2) it will create and discard large strings. Consider this variant of the code in test_zlib.py, where I have replaced the imported module variable "_1G" with its value:

    @bigmemtest(size=_4G + 4, memuse=1, dry_run=False)
    def test_big_buffer(self, size):
        data = b"nyan" * (2**30 + 1)  # the original uses "_1G"
        self.assertEqual(zlib.crc32(data), 1044521549)
        self.assertEqual(zlib.adler32(data), 2256789997)

The byte compiler will create the ~4GB string then discard it, even though the function will not be called on machines with insufficient RAM.

As an example of how I was affected by this, see #21074 .

3) The optimizer affects control flow such that the coverage.py gives false positives about unreached code.

As examples of how people are affected, see #2506 and https://bitbucket.org/ned/coveragepy/issues/198/continue-marked-as-not-covered . The last item on the coverage.py tracker asks "Is this limitation documented anywhere?"

I do not believe that the current peephole optimizer should be changed to support these use cases, only that there should be documentation about how the optimizer may negatively affect real-world code.

The domain expert on this topic is Raymond Hettinger. He does not feel safe in issues where I am involved. As I believe my continued presence on this issue will inhibit the documentation changes which I think are needed, I will remove my name from this issue and not be further involved.

----------
assignee: docs at python
components: Documentation
messages: 294248
nosy: dalke, docs at python
priority: normal
severity: normal
status: open
title: document peephole optimizer effects
versions: Python 3.7

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

From report at bugs.python.org  Tue May 23 08:52:37 2017
From: report at bugs.python.org (Andrew Dalke)
Date: Tue, 23 May 2017 12:52:37 +0000
Subject: [docs] [issue30440] document peephole optimizer effects
In-Reply-To: <1495543941.79.0.954903712475.issue30440@psf.upfronthosting.co.za>
Message-ID: <1495543957.51.0.432733123337.issue30440@psf.upfronthosting.co.za>


Changes by Andrew Dalke <dalke at dalkescientific.com>:


----------
nosy:  -dalke

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

From report at bugs.python.org  Tue May 23 12:56:48 2017
From: report at bugs.python.org (Kushal Das)
Date: Tue, 23 May 2017 16:56:48 +0000
Subject: [docs] [issue30376] Curses documentation refers to incorrect type
In-Reply-To: <1494882965.33.0.779610991751.issue30376@psf.upfronthosting.co.za>
Message-ID: <1495558608.02.0.277305609361.issue30376@psf.upfronthosting.co.za>


Kushal Das added the comment:


New changeset 8af0a214be7c0c921ba5ce5c11043dd5b5da9211 by Kushal Das in branch '3.5':
[3.5] bpo-30376: Update outdated WindowObject references (GH-1630) (#1747)
https://github.com/python/cpython/commit/8af0a214be7c0c921ba5ce5c11043dd5b5da9211


----------

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

From report at bugs.python.org  Tue May 23 12:57:06 2017
From: report at bugs.python.org (Kushal Das)
Date: Tue, 23 May 2017 16:57:06 +0000
Subject: [docs] [issue30376] Curses documentation refers to incorrect type
In-Reply-To: <1494882965.33.0.779610991751.issue30376@psf.upfronthosting.co.za>
Message-ID: <1495558626.58.0.106152595635.issue30376@psf.upfronthosting.co.za>


Kushal Das added the comment:


New changeset 9bcf81da1436468c3c5e500ae36678a2ad675e32 by Kushal Das in branch '3.6':
[3.6] bpo-30376: Update outdated WindowObject references (GH-1630) (#1746)
https://github.com/python/cpython/commit/9bcf81da1436468c3c5e500ae36678a2ad675e32


----------

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

From report at bugs.python.org  Tue May 23 13:37:48 2017
From: report at bugs.python.org (Emily Morehouse)
Date: Tue, 23 May 2017 17:37:48 +0000
Subject: [docs] [issue30440] document peephole optimizer effects
In-Reply-To: <1495543941.79.0.954903712475.issue30440@psf.upfronthosting.co.za>
Message-ID: <1495561068.45.0.608981137843.issue30440@psf.upfronthosting.co.za>


Emily Morehouse added the comment:

Raymond, I'm willing to take over this issue with your guidance if you're open to it.

----------
nosy: +emilyemorehouse, rhettinger

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

From report at bugs.python.org  Tue May 23 13:55:53 2017
From: report at bugs.python.org (Brian Ward)
Date: Tue, 23 May 2017 17:55:53 +0000
Subject: [docs] [issue30435] Documentation either unclear or incorrect on
 comparisons between bytes and strings in Python 3
In-Reply-To: <1495495979.22.0.902310404899.issue30435@psf.upfronthosting.co.za>
Message-ID: <1495562153.3.0.960691956073.issue30435@psf.upfronthosting.co.za>


Brian Ward added the comment:

The "should" recommendation seems like the right direction, but feels like it needs an explanation (in case someone's trying to run some 2.7 code and is wondering why their comparisons don't work anymore). Unfortunately, it's a little complicated to pile into a section like this. Putting it somewhere else (that includes a reference to -b) might work.

A somewhat related aside is that I've sometimes thought that there ought to be something a little more extensive regarding converting bytes to strings, as it's the kind of thing that can lead you down this road anyway.

----------
nosy: +Brian Ward

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

From report at bugs.python.org  Tue May 23 13:56:36 2017
From: report at bugs.python.org (Kushal Das)
Date: Tue, 23 May 2017 17:56:36 +0000
Subject: [docs] [issue30376] Curses documentation refers to incorrect type
In-Reply-To: <1494882965.33.0.779610991751.issue30376@psf.upfronthosting.co.za>
Message-ID: <1495562195.97.0.329545415579.issue30376@psf.upfronthosting.co.za>


Kushal Das added the comment:

Thanks for filing the bug, fixed now. Thank you Berker for the quick patch.

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

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

From report at bugs.python.org  Tue May 23 17:31:25 2017
From: report at bugs.python.org (Brian Ward)
Date: Tue, 23 May 2017 21:31:25 +0000
Subject: [docs] [issue24896] It is undocumented that re.UNICODE and
 re.LOCALE affect re.IGNORECASE
In-Reply-To: <1439987891.31.0.547960058443.issue24896@psf.upfronthosting.co.za>
Message-ID: <1495575085.51.0.291300635295.issue24896@psf.upfronthosting.co.za>


Changes by Brian Ward <bri at aem7.net>:


----------
nosy: +Brian Ward

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

From report at bugs.python.org  Tue May 23 20:32:26 2017
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 24 May 2017 00:32:26 +0000
Subject: [docs] [issue24896] It is undocumented that re.UNICODE and
 re.LOCALE affect re.IGNORECASE
In-Reply-To: <1439987891.31.0.547960058443.issue24896@psf.upfronthosting.co.za>
Message-ID: <1495585946.83.0.941706674497.issue24896@psf.upfronthosting.co.za>


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


----------
pull_requests: +1862

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

From report at bugs.python.org  Tue May 23 20:44:21 2017
From: report at bugs.python.org (Brian Ward)
Date: Wed, 24 May 2017 00:44:21 +0000
Subject: [docs] [issue24896] It is undocumented that re.UNICODE and
 re.LOCALE affect re.IGNORECASE
In-Reply-To: <1439987891.31.0.547960058443.issue24896@psf.upfronthosting.co.za>
Message-ID: <1495586661.8.0.615273958886.issue24896@psf.upfronthosting.co.za>


Changes by Brian Ward <bri at aem7.net>:


----------
pull_requests: +1863

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

From report at bugs.python.org  Tue May 23 21:01:47 2017
From: report at bugs.python.org (Aaron Hall)
Date: Wed, 24 May 2017 01:01:47 +0000
Subject: [docs] [issue30449] Improve __slots__ datamodel documentation
Message-ID: <1495587707.13.0.0998591622446.issue30449@psf.upfronthosting.co.za>


New submission from Aaron Hall:

The __slots__ documentation in the datamodel needs improvement.

For example:

> When inheriting from a class without __slots__, the __dict__ attribute of that class will always be accessible, so a __slots__ definition in the subclass is meaningless.

The __slots__ definition for such a subclass is not meaningless: other slots declared will still be used, and the __dict__ will not be instantiated unless it is looked for (although this may be an implementation detail).

> The action of a __slots__ declaration is limited to the class where it is defined. As a result, subclasses will have a __dict__ unless they also define __slots__ (which must only contain names of any additional slots).

That's not quite right either. The action of a __slots__ declaration is not entirely limited to the class where it is defined. They can have implications for multiple inheritance, and child classes will have access to those slots.

I have some changes I'd like to make to the entire section on __slots__, and I'll be providing a pull request soon.

----------
assignee: docs at python
components: Documentation
messages: 294305
nosy: Aaron Hall, docs at python
priority: normal
severity: normal
status: open
title: Improve __slots__ datamodel documentation
versions: Python 2.7, Python 3.6, Python 3.7

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

From report at bugs.python.org  Tue May 23 21:11:54 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Wed, 24 May 2017 01:11:54 +0000
Subject: [docs] [issue30440] document peephole optimizer effects
In-Reply-To: <1495543941.79.0.954903712475.issue30440@psf.upfronthosting.co.za>
Message-ID: <1495588314.8.0.941788747485.issue30440@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

Thanks Emily.  

This should be probably be a FAQ entry (cpython/Doc/faq) because the peephole optimizer is a CPython implementation detail, because we don't normally document internal details such as which opcodes are generated or big-oh runtimes etc, because isn't really a good place for this elsewhere, and because the low level details are frequently changing.

Ideally, the FAQ entry should be brief and focus on the two user visible effects. 1) The jump-to-jump optimization can cause a coverage analysis tool to mark as uncovered a line that is logically executed but is bypassed because it has no effect.  2) Constant folding transfers run-time costs to compile-time costs -- this may matter when the expression is expensive to compute or if it results in the creation of a large object.

Follow the documentation advice given in the dev guide:
* https://docs.python.org/devguide/documenting.html#affirmative-tone
* https://docs.python.org/devguide/documenting.html#economy-of-expression
* https://docs.python.org/devguide/documenting.html#audience

The key part of the first link is to keep it upbeat, focusing on what the tool does, the related costs and benefits, and giving recommendations on how to control it.  We don't want the docs to read as a litany of warnings and suggestions of danger.

In particular, I recommend discussing the OP's compute_largest_known_prime() example and explaining:
1) the intended calculation is expensive in terms of both space and time 
2) the constant folding step of code generation does this computation at compile-time
3) since this computation is slow, it noticeably slows down the compilation (appears to hang at compile-time rather than at run-time as it normally would)
4) since this computation creates a large object, the pyc file will be large
5) due to pre-computation, the run-time call will be fast
6) if that effect is not desired, it is easily turned-off by storing part of the expression in a variable:
    >>> def compute_largest_known_prime():
    ...     exp = 74207281
    ...     return 2 ** exp - 1

The key part of the second link is to be brief and terse.  It would be easy to write an entire blog post or chapter in a book about constant folding, but that wouldn't be efficient with the reader's time or really help them out in a meaningful way.

The key part of the third link is address what you think is helpful to new readers of the FAQ who don't already understand the issue.  We don't make doc entries to appease or vindicate someone.  The docs aren't a vehicle for expressing opposition to design decision; instead, it is a place to explain what the tools do and how to use them.

Try not to over-specify the implementation.  Note that constant folding takes place but don't guarantee specific transformations.  These are all subject to change, have changed over time (including backports), and changing even now.

----------
assignee: docs at python -> emilyemorehouse

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

From report at bugs.python.org  Tue May 23 22:25:57 2017
From: report at bugs.python.org (Aaron Hall)
Date: Wed, 24 May 2017 02:25:57 +0000
Subject: [docs] [issue30449] Improve __slots__ datamodel documentation
In-Reply-To: <1495587707.13.0.0998591622446.issue30449@psf.upfronthosting.co.za>
Message-ID: <1495592757.86.0.407894320695.issue30449@psf.upfronthosting.co.za>


Aaron Hall added the comment:

I've been working on this section quite a lot, trying to improve the flow of content (which in the prior revision is a bit of a mish-mash of information in the "Notes on using __slots__ section") - I intend to move some of that information into the exposition/introduction.

I have also been reviewing my changes and actively working on it with a volunteer at the PyCon sprints, Joshua Goldin. Will submit a pull request soon, tonight or tomorrow morning.

----------

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

From report at bugs.python.org  Wed May 24 01:51:07 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 24 May 2017 05:51:07 +0000
Subject: [docs] [issue24896] It is undocumented that re.UNICODE and
 re.LOCALE affect re.IGNORECASE
In-Reply-To: <1439987891.31.0.547960058443.issue24896@psf.upfronthosting.co.za>
Message-ID: <1495605067.23.0.691450553759.issue24896@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

Actually the locale affects case-insensitively matching if use the re.LOCAL flag. The set of characters matched by b'[A-Z]' is locale-depending. For example in Turkish locale it can include the letters '?' and '?'. Only 8-bit locales are supported, not UTF-8 locales.

In Unicode case-insensitive mode the expression '[A-Z]' matches not only Latin uppercase and lowercacase letters A-Z and a-z, but also characters '?', '?', '?', and '?'.

----------

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

From report at bugs.python.org  Wed May 24 08:38:01 2017
From: report at bugs.python.org (Eli_B)
Date: Wed, 24 May 2017 12:38:01 +0000
Subject: [docs] [issue30456] 2to3 docs: example of fix for duplicates in
 second argument of isinstance has superfluous parentheses
Message-ID: <1495629480.46.0.852726762555.issue30456@psf.upfronthosting.co.za>


New submission from Eli_B:

The documentation says isinstance(x, (int, int)) would be fixed to isinstance(x, (int)). The fix is actually isinstance(x, int).

I propose the following text instead:
"
2to3fixer:: isinstance

Fixes duplicate types in the second argument of :func:`isinstance`.  For example, isinstance(x, (int, int)) is converted to isinstance(x, int) and isinstance(x, (int, float, int)) is converted to isinstance(x, (int, float)).
"

----------
assignee: docs at python
components: Documentation
files: 2to3.rst
messages: 294351
nosy: Eli_B, docs at python
priority: normal
pull_requests: 1867
severity: normal
status: open
title: 2to3 docs: example of fix for duplicates in second argument of isinstance has superfluous parentheses
versions: Python 2.7
Added file: http://bugs.python.org/file46894/2to3.rst

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

From report at bugs.python.org  Wed May 24 11:40:38 2017
From: report at bugs.python.org (Mike)
Date: Wed, 24 May 2017 15:40:38 +0000
Subject: [docs] [issue30160] BaseHTTPRequestHandler.wfile: supported usage
 unclear
In-Reply-To: <1493131484.95.0.842958745675.issue30160@psf.upfronthosting.co.za>
Message-ID: <1495640438.11.0.577423126146.issue30160@psf.upfronthosting.co.za>


Mike added the comment:

It's been about a month since I heard back, so I thought I'd comment here just in case this slipped of anyone's radar. Is there anything I can doto help this land?

----------

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

From report at bugs.python.org  Wed May 24 14:25:52 2017
From: report at bugs.python.org (R. David Murray)
Date: Wed, 24 May 2017 18:25:52 +0000
Subject: [docs] [issue30160] BaseHTTPRequestHandler.wfile: supported usage
 unclear
In-Reply-To: <1493131484.95.0.842958745675.issue30160@psf.upfronthosting.co.za>
Message-ID: <1495650352.63.0.772816477203.issue30160@psf.upfronthosting.co.za>


R. David Murray added the comment:


New changeset a083c8ee6cb89ca573fe10c4c1922e2fa69ceaa3 by R. David Murray (jugglinmike) in branch 'master':
bpo-30160: Clarify intended usage of wfile (gh-1300)
https://github.com/python/cpython/commit/a083c8ee6cb89ca573fe10c4c1922e2fa69ceaa3


----------

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

From report at bugs.python.org  Wed May 24 14:28:02 2017
From: report at bugs.python.org (R. David Murray)
Date: Wed, 24 May 2017 18:28:02 +0000
Subject: [docs] [issue30160] BaseHTTPRequestHandler.wfile: supported usage
 unclear
In-Reply-To: <1493131484.95.0.842958745675.issue30160@psf.upfronthosting.co.za>
Message-ID: <1495650481.98.0.80087476721.issue30160@psf.upfronthosting.co.za>


R. David Murray added the comment:

Pinging the issue is exactly what you needed to do :)  As I said on the PR, I'm not set up to do backports yet so hopefully you or someone else will do those.

----------
stage:  -> backport needed
versions: +Python 3.5, Python 3.6, Python 3.7

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

From report at bugs.python.org  Wed May 24 14:51:19 2017
From: report at bugs.python.org (Zachary Ware)
Date: Wed, 24 May 2017 18:51:19 +0000
Subject: [docs] [issue30160] BaseHTTPRequestHandler.wfile: supported usage
 unclear
In-Reply-To: <1493131484.95.0.842958745675.issue30160@psf.upfronthosting.co.za>
Message-ID: <1495651879.58.0.764565520155.issue30160@psf.upfronthosting.co.za>


Changes by Zachary Ware <zachary.ware at gmail.com>:


----------
pull_requests: +1875

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

From report at bugs.python.org  Wed May 24 14:51:23 2017
From: report at bugs.python.org (Zachary Ware)
Date: Wed, 24 May 2017 18:51:23 +0000
Subject: [docs] [issue30160] BaseHTTPRequestHandler.wfile: supported usage
 unclear
In-Reply-To: <1493131484.95.0.842958745675.issue30160@psf.upfronthosting.co.za>
Message-ID: <1495651883.45.0.533307867086.issue30160@psf.upfronthosting.co.za>


Changes by Zachary Ware <zachary.ware at gmail.com>:


----------
pull_requests: +1876

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

From report at bugs.python.org  Wed May 24 15:27:50 2017
From: report at bugs.python.org (Zachary Ware)
Date: Wed, 24 May 2017 19:27:50 +0000
Subject: [docs] [issue28845] Clean up known issues for AIX
In-Reply-To: <1480542032.97.0.55863701863.issue28845@psf.upfronthosting.co.za>
Message-ID: <1495654069.91.0.264669849803.issue28845@psf.upfronthosting.co.za>


Zachary Ware added the comment:


New changeset 7c2f82d158a19ec9ee6b7e259c243e1f06f0434f by Zachary Ware (Eric N. Vander Weele) in branch 'master':
bpo-28845: Clean up known issues for AIX (GH-1670)
https://github.com/python/cpython/commit/7c2f82d158a19ec9ee6b7e259c243e1f06f0434f


----------
nosy: +zach.ware

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

From report at bugs.python.org  Wed May 24 15:30:00 2017
From: report at bugs.python.org (Zachary Ware)
Date: Wed, 24 May 2017 19:30:00 +0000
Subject: [docs] [issue28845] Clean up known issues for AIX
In-Reply-To: <1480542032.97.0.55863701863.issue28845@psf.upfronthosting.co.za>
Message-ID: <1495654199.93.0.741882577687.issue28845@psf.upfronthosting.co.za>


Zachary Ware added the comment:

Thanks for the patch!  I'm going to decline backporting this; let's just focus on the future for this.

----------
resolution:  -> fixed
stage: patch review -> 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/issue28845>
_______________________________________

From report at bugs.python.org  Wed May 24 15:45:11 2017
From: report at bugs.python.org (Sourav Singh)
Date: Wed, 24 May 2017 19:45:11 +0000
Subject: [docs] [issue9938] Documentation for argparse interactive use
In-Reply-To: <1285338690.84.0.283413950067.issue9938@psf.upfronthosting.co.za>
Message-ID: <1495655111.22.0.942664746378.issue9938@psf.upfronthosting.co.za>


Sourav Singh added the comment:

I would like to send a patch for the issue. How do I start

----------
nosy: +Sourav Singh

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

From report at bugs.python.org  Wed May 24 15:53:43 2017
From: report at bugs.python.org (Sourav Singh)
Date: Wed, 24 May 2017 19:53:43 +0000
Subject: [docs] [issue20265] Bring Windows docs up to date
In-Reply-To: <1389757265.26.0.116885263001.issue20265@psf.upfronthosting.co.za>
Message-ID: <1495655623.2.0.320980579997.issue20265@psf.upfronthosting.co.za>


Sourav Singh added the comment:

The issue is beileve is fixed now.

----------
nosy: +Sourav Singh

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

From report at bugs.python.org  Wed May 24 16:04:05 2017
From: report at bugs.python.org (Sourav Singh)
Date: Wed, 24 May 2017 20:04:05 +0000
Subject: [docs] [issue30304] TestCase.assertMultiLineEqual only registered
 for Unicode strings in 2.7
In-Reply-To: <1494233409.78.0.688533240712.issue30304@psf.upfronthosting.co.za>
Message-ID: <1495656245.3.0.908342613956.issue30304@psf.upfronthosting.co.za>


Sourav Singh added the comment:

@Martin I would like to take a stab at the issue. How do I start?

----------
nosy: +Sourav Singh

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

From report at bugs.python.org  Wed May 24 17:11:04 2017
From: report at bugs.python.org (Zachary Ware)
Date: Wed, 24 May 2017 21:11:04 +0000
Subject: [docs] [issue30160] BaseHTTPRequestHandler.wfile: supported usage
 unclear
In-Reply-To: <1493131484.95.0.842958745675.issue30160@psf.upfronthosting.co.za>
Message-ID: <1495660264.09.0.124297087376.issue30160@psf.upfronthosting.co.za>


Zachary Ware added the comment:


New changeset a2a9984a278d2ee945e91ce13e000e571794fc24 by Zachary Ware in branch '3.6':
[3.6] bpo-30160: Clarify intended usage of wfile (gh-1300) (GH-1793)
https://github.com/python/cpython/commit/a2a9984a278d2ee945e91ce13e000e571794fc24


----------
nosy: +zach.ware

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

From report at bugs.python.org  Wed May 24 17:11:23 2017
From: report at bugs.python.org (Zachary Ware)
Date: Wed, 24 May 2017 21:11:23 +0000
Subject: [docs] [issue30160] BaseHTTPRequestHandler.wfile: supported usage
 unclear
In-Reply-To: <1493131484.95.0.842958745675.issue30160@psf.upfronthosting.co.za>
Message-ID: <1495660283.75.0.285141820176.issue30160@psf.upfronthosting.co.za>


Zachary Ware added the comment:


New changeset aa27f0e94f4d9c5ef589984dc2b32d856e8e038f by Zachary Ware in branch '3.5':
[3.5] bpo-30160: Clarify intended usage of wfile (gh-1300) (GH-1792)
https://github.com/python/cpython/commit/aa27f0e94f4d9c5ef589984dc2b32d856e8e038f


----------

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

From report at bugs.python.org  Wed May 24 17:11:59 2017
From: report at bugs.python.org (Zachary Ware)
Date: Wed, 24 May 2017 21:11:59 +0000
Subject: [docs] [issue30160] BaseHTTPRequestHandler.wfile: supported usage
 unclear
In-Reply-To: <1493131484.95.0.842958745675.issue30160@psf.upfronthosting.co.za>
Message-ID: <1495660319.25.0.442167782656.issue30160@psf.upfronthosting.co.za>


Zachary Ware added the comment:

Backported.  Thanks for the patch, Mike!

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

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

From report at bugs.python.org  Wed May 24 17:14:17 2017
From: report at bugs.python.org (Mike)
Date: Wed, 24 May 2017 21:14:17 +0000
Subject: [docs] [issue30160] BaseHTTPRequestHandler.wfile: supported usage
 unclear
In-Reply-To: <1493131484.95.0.842958745675.issue30160@psf.upfronthosting.co.za>
Message-ID: <1495660457.65.0.967188269171.issue30160@psf.upfronthosting.co.za>


Mike added the comment:

My pleasure. And thank you for backporting on my behalf :)

----------

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

From report at bugs.python.org  Wed May 24 18:58:40 2017
From: report at bugs.python.org (Trey Hunner)
Date: Wed, 24 May 2017 22:58:40 +0000
Subject: [docs] [issue30466] Tutorial doesn't explain the use of classes
Message-ID: <1495666720.41.0.650692797283.issue30466@psf.upfronthosting.co.za>


New submission from Trey Hunner:

The tutorial page for classes starts with "Compared with other programming languages".

While object-oriented programming and classes are popular in many programming languages, not everyone learning about Python's classes is familiar with the concept.  I teach both new programmers and programmers who have heard of object-oriented programming but never created a class before.

I think the first paragraph on this page should be a brief explanation of the use of classes.  It may also be a good idea to have a "Why classes?" section explaining the uses of classes in more detail.

----------
assignee: docs at python
components: Documentation
messages: 294409
nosy: docs at python, trey
priority: normal
severity: normal
status: open
title: Tutorial doesn't explain the use of classes
type: enhancement
versions: Python 3.6, Python 3.7

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

From report at bugs.python.org  Wed May 24 19:04:20 2017
From: report at bugs.python.org (Brian Ward)
Date: Wed, 24 May 2017 23:04:20 +0000
Subject: [docs] [issue24896] It is undocumented that re.UNICODE and
 re.LOCALE affect re.IGNORECASE
In-Reply-To: <1439987891.31.0.547960058443.issue24896@psf.upfronthosting.co.za>
Message-ID: <1495667060.32.0.836018430147.issue24896@psf.upfronthosting.co.za>


Brian Ward added the comment:

OK, I'll look at this soon and come up with the next iteration.

----------

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

From report at bugs.python.org  Wed May 24 19:18:43 2017
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Wed, 24 May 2017 23:18:43 +0000
Subject: [docs] [issue30178] Indent methods and attributes of MimeTypes class
In-Reply-To: <1493226814.74.0.770717289652.issue30178@psf.upfronthosting.co.za>
Message-ID: <1495667923.39.0.762432762617.issue30178@psf.upfronthosting.co.za>


Changes by St?phane Wirtel <stephane at wirtel.be>:


----------
pull_requests: +1884

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

From report at bugs.python.org  Wed May 24 20:19:34 2017
From: report at bugs.python.org (Trey Hunner)
Date: Thu, 25 May 2017 00:19:34 +0000
Subject: [docs] [issue30466] Tutorial doesn't explain the use of classes
In-Reply-To: <1495666720.41.0.650692797283.issue30466@psf.upfronthosting.co.za>
Message-ID: <1495671574.43.0.367833859801.issue30466@psf.upfronthosting.co.za>


Changes by Trey Hunner <trey at truthful.technology>:


----------
pull_requests: +1887

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

From report at bugs.python.org  Wed May 24 20:25:08 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 25 May 2017 00:25:08 +0000
Subject: [docs] [issue30466] Tutorial doesn't explain the use of classes
In-Reply-To: <1495666720.41.0.650692797283.issue30466@psf.upfronthosting.co.za>
Message-ID: <1495671908.39.0.190459338796.issue30466@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/issue30466>
_______________________________________

From report at bugs.python.org  Wed May 24 20:30:54 2017
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 25 May 2017 00:30:54 +0000
Subject: [docs] [issue30449] Improve __slots__ datamodel documentation
In-Reply-To: <1495587707.13.0.0998591622446.issue30449@psf.upfronthosting.co.za>
Message-ID: <1495672254.2.0.690209549482.issue30449@psf.upfronthosting.co.za>


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


----------
pull_requests: +1889

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

From report at bugs.python.org  Wed May 24 20:34:55 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Thu, 25 May 2017 00:34:55 +0000
Subject: [docs] [issue30466] Tutorial doesn't explain the use of classes
In-Reply-To: <1495666720.41.0.650692797283.issue30466@psf.upfronthosting.co.za>
Message-ID: <1495672495.23.0.371763525344.issue30466@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

This particular PR seems fine.  I'll review it in more detail later.

In general, the tutorial is intended to be a structured overview of the language rather than a how-to-program lesson.  Concepts are usually linked to the glossary or external sources and some information is communicated indirectly by the examples.

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

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

From report at bugs.python.org  Wed May 24 21:04:59 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 25 May 2017 01:04:59 +0000
Subject: [docs] [issue30449] Improve __slots__ datamodel documentation
In-Reply-To: <1495587707.13.0.0998591622446.issue30449@psf.upfronthosting.co.za>
Message-ID: <1495674299.02.0.783271863164.issue30449@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/issue30449>
_______________________________________

From report at bugs.python.org  Wed May 24 21:06:04 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 25 May 2017 01:06:04 +0000
Subject: [docs] [issue30449] Improve __slots__ datamodel documentation
In-Reply-To: <1495587707.13.0.0998591622446.issue30449@psf.upfronthosting.co.za>
Message-ID: <1495674364.13.0.838771941661.issue30449@psf.upfronthosting.co.za>


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


----------
versions: +Python 3.5

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

From report at bugs.python.org  Wed May 24 23:50:05 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Thu, 25 May 2017 03:50:05 +0000
Subject: [docs] [issue30449] Improve __slots__ datamodel documentation
In-Reply-To: <1495587707.13.0.0998591622446.issue30449@psf.upfronthosting.co.za>
Message-ID: <1495684205.3.0.197969604076.issue30449@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

As much as possible, please stick with the existing terse style of the data model docs.  They tend to be concise, direct, and very light on examples.  They don't serve as a tutorial, faq, or cover programming patterns or advice.

Looking at the PR, I don't think most of these changes should be made.

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

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

From report at bugs.python.org  Thu May 25 01:44:56 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 25 May 2017 05:44:56 +0000
Subject: [docs] [issue30470] Deprecate invalid ctypes call protection on
 Windows
Message-ID: <1495691096.42.0.177794201857.issue30470@psf.upfronthosting.co.za>


New submission from Mariatta Wijaya:

It was proposed by Steve Dower by email to python-dev:
https://mail.python.org/pipermail/python-dev/2017-May/147959.html

It should be deprecated in Python 3.6.2 and removed in 3.7.0

----------
assignee: docs at python
components: Documentation, ctypes
messages: 294435
nosy: Mariatta, docs at python, haypo, steve.dower
priority: normal
severity: normal
status: open
title: Deprecate invalid ctypes call protection on Windows
versions: Python 3.6, Python 3.7

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

From report at bugs.python.org  Thu May 25 01:51:54 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 25 May 2017 05:51:54 +0000
Subject: [docs] [issue30470] Deprecate invalid ctypes call protection on
 Windows
In-Reply-To: <1495691096.42.0.177794201857.issue30470@psf.upfronthosting.co.za>
Message-ID: <1495691514.68.0.476811093816.issue30470@psf.upfronthosting.co.za>


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


----------
pull_requests: +1895

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

From bgailer at gmail.com  Thu May 25 11:00:00 2017
From: bgailer at gmail.com (bob gailer)
Date: Thu, 25 May 2017 11:00:00 -0400
Subject: [docs] Recommendation for tutorial.
Message-ID: <9740cc2f-1eeb-f87b-a098-b3aedcd880d9@gmail.com>

"Python 3.6.1 documentation

Welcome! This is the documentation for Python 3.6.1.

Parts of the documentation:

What's new in Python 3.6?
or all "What's new" documents since 2.0

Tutorial
start here"

Within the Tutorial " It helps to have a Python interpreter handy"

Jessica McKellar commented several years ago regarding the lack of 
adequate instructions for getting and installing python. It seems that 
is still an issue.

If I were a newbie I would be stuck at "have a Python interpreter handy".

SO I recommend we add a link to installation instructions. There is a 
fairly good guide at https://wiki.python.org/moin/BeginnersGuide/Download.

I don't see anything that would help a newbie edit and run a program.

The more I read the bigger my pile of ideas and recommendations gets. 
What is the best way for me to communicate these?

From report at bugs.python.org  Thu May 25 13:14:57 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 25 May 2017 17:14:57 +0000
Subject: [docs] [issue30178] Indent methods and attributes of MimeTypes class
In-Reply-To: <1493226814.74.0.770717289652.issue30178@psf.upfronthosting.co.za>
Message-ID: <1495732497.2.0.197669576872.issue30178@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Thanks Jim and St?phane.

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

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

From report at bugs.python.org  Thu May 25 17:43:51 2017
From: report at bugs.python.org (Aaron Hall)
Date: Thu, 25 May 2017 21:43:51 +0000
Subject: [docs] [issue30449] Improve __slots__ datamodel documentation
In-Reply-To: <1495587707.13.0.0998591622446.issue30449@psf.upfronthosting.co.za>
Message-ID: <1495748631.75.0.105898377294.issue30449@psf.upfronthosting.co.za>


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


----------
pull_requests: +1905

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

From report at bugs.python.org  Thu May 25 17:58:30 2017
From: report at bugs.python.org (Aaron Hall)
Date: Thu, 25 May 2017 21:58:30 +0000
Subject: [docs] [issue30449] Improve __slots__ datamodel documentation
In-Reply-To: <1495587707.13.0.0998591622446.issue30449@psf.upfronthosting.co.za>
Message-ID: <1495749509.98.0.510185822688.issue30449@psf.upfronthosting.co.za>


Aaron Hall added the comment:

I created a new PR based on rhettinger's feedback (which on consideration was quite correct) with a fresh branch from master. 

Terseness is retained, and I think this revision makes the documentation more correct and complete. The rewording makes the behavior more clear (IMHO).

No example code is needed for this revision, so I didn't give any, but one or two class definitions might be desirable.

Feedback is quite welcome!

----------

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

From report at bugs.python.org  Thu May 25 22:14:05 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Fri, 26 May 2017 02:14:05 +0000
Subject: [docs] [issue30449] Improve __slots__ datamodel documentation
In-Reply-To: <1495587707.13.0.0998591622446.issue30449@psf.upfronthosting.co.za>
Message-ID: <1495764845.21.0.696364541622.issue30449@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

Overall this looks good.  Please do fix the one review comment.

----------

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

From report at bugs.python.org  Thu May 25 22:14:13 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Fri, 26 May 2017 02:14:13 +0000
Subject: [docs] [issue30449] Improve __slots__ datamodel documentation
In-Reply-To: <1495587707.13.0.0998591622446.issue30449@psf.upfronthosting.co.za>
Message-ID: <1495764853.38.0.994652323341.issue30449@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/issue30449>
_______________________________________

From report at bugs.python.org  Thu May 25 22:28:20 2017
From: report at bugs.python.org (Nick Coghlan)
Date: Fri, 26 May 2017 02:28:20 +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: <1495765700.04.0.692843801032.issue30420@psf.upfronthosting.co.za>


Nick Coghlan added the comment:


New changeset 368cf1d20630498ca7939069a05d744fabb570aa by Nick Coghlan (Alex Gaynor) in branch 'master':
bpo-30420: List cwd parameter in subprocess convenience APIs (GH-1685)
https://github.com/python/cpython/commit/368cf1d20630498ca7939069a05d744fabb570aa


----------

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

From report at bugs.python.org  Thu May 25 22:34:02 2017
From: report at bugs.python.org (Nick Coghlan)
Date: Fri, 26 May 2017 02:34:02 +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: <1495766042.32.0.0546284223647.issue30420@psf.upfronthosting.co.za>


Nick Coghlan added the comment:

The just merged PR covers the "list `cwd` in the nominal signatures for `run()`, `call()`, `check_call()`, and `check_output()`" part of the proposal.

The rest of the proposed fixes are still pending a patch (and keeping in mind Martin's caveat on minimising duplication between the "Frequently Used Arguments" section and the full Popen documentation)

----------

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

From report at bugs.python.org  Fri May 26 01:33:28 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Fri, 26 May 2017 05:33:28 +0000
Subject: [docs] [issue30449] Improve __slots__ datamodel documentation
In-Reply-To: <1495587707.13.0.0998591622446.issue30449@psf.upfronthosting.co.za>
Message-ID: <1495776808.71.0.678994313175.issue30449@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:


New changeset 2b44e302ec3079363c4d5c875677945953705c58 by Raymond Hettinger (Aaron Hall, MBA) in branch 'master':
bpo-30449 Terse slots (#1819)
https://github.com/python/cpython/commit/2b44e302ec3079363c4d5c875677945953705c58


----------

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

From report at bugs.python.org  Fri May 26 12:40:55 2017
From: report at bugs.python.org (Caleb Hattingh)
Date: Fri, 26 May 2017 16:40:55 +0000
Subject: [docs] [issue30433] Devguide lacks instructions for building docs
In-Reply-To: <1495479103.65.0.491386375497.issue30433@psf.upfronthosting.co.za>
Message-ID: <1495816855.24.0.849953343758.issue30433@psf.upfronthosting.co.za>


Caleb Hattingh added the comment:

The PR has been merged by Mariatta so I think this can be closed.

----------

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

From report at bugs.python.org  Fri May 26 12:49:48 2017
From: report at bugs.python.org (Caleb Hattingh)
Date: Fri, 26 May 2017 16:49:48 +0000
Subject: [docs] [issue30487] DOC: automatically create a venv and install
 Sphinx when running make
Message-ID: <1495817388.46.0.640927890572.issue30487@psf.upfronthosting.co.za>


New submission from Caleb Hattingh:

Under guidance from zware during Pycon sprints, I've changed the Doc/ Makefile to automatically create a virtual environment and install Sphinx, all as part of the `make html` command.

----------
assignee: docs at python
components: Documentation
messages: 294556
nosy: cjrh, docs at python, willingc, zach.ware
priority: normal
pull_requests: 1909
severity: normal
status: open
title: DOC: automatically create a venv and install Sphinx when running make
versions: Python 3.7

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

From report at bugs.python.org  Fri May 26 12:50:51 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 26 May 2017 16:50:51 +0000
Subject: [docs] [issue30433] Devguide lacks instructions for building docs
In-Reply-To: <1495479103.65.0.491386375497.issue30433@psf.upfronthosting.co.za>
Message-ID: <1495817450.97.0.816853403382.issue30433@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Thanks Caleb.

This has been addressed in the Dev Guide PR https://github.com/python/devguide/pull/206 and it has been merged.

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

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

From report at bugs.python.org  Fri May 26 12:51:33 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 26 May 2017 16:51:33 +0000
Subject: [docs] [issue30487] DOC: automatically create a venv and install
 Sphinx when running make
In-Reply-To: <1495817388.46.0.640927890572.issue30487@psf.upfronthosting.co.za>
Message-ID: <1495817493.72.0.516661918361.issue30487@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/issue30487>
_______________________________________

From report at bugs.python.org  Fri May 26 13:04:43 2017
From: report at bugs.python.org (Yury Selivanov)
Date: Fri, 26 May 2017 17:04:43 +0000
Subject: [docs] [issue30145] Create a How to or Tutorial documentation for
 asyncio
In-Reply-To: <1492960602.26.0.461554169011.issue30145@psf.upfronthosting.co.za>
Message-ID: <1495818282.28.0.619202239856.issue30145@psf.upfronthosting.co.za>


Yury Selivanov added the comment:

A while ago, Eric Appelt stepped forward to help with the asyncio 
documentation.  Here's my response to his email in which we discuss
the direction for the new docs.

On May 24, 2017 at 1:04:56 PM, Eric Appelt (eric.appelt at gmail.com) wrote:
> Hi Yury,
> 
> I (briefly) went through the curio and trio tutorials and wanted to
> summarize a few thoughts. I'm going to go through them again slowly and
> actually do the exercises, but a few things that I found notable:
> 
> Both Curio and Trio start with an emphasis of tasks, spawning tasks at
> various points, and then later joining them. Trio even has a "nursery"
> async context manager where you spawn tasks inside and then they are all
> joined on exit. Following various exchanges, I understand that the
> coroutine is to be the preferred abstraction layer for use in the
> application developer, i.e. one would generally be using
> asyncio.gather(...) rather than create_task as the routine way of invoking
> concurrency. If that's correct, I would expect an asyncio tutorial to be a
> bit more focused on using gather, but I expect that manipulating tasks is
> of enough interest that it deserves some discussion.

What I like about Trio documentation is that it tries to explain 
async/await first, gradually paving the way to more advanced concepts
and the library API.

I?m going to propose a concrete structure for the revamped documentation.
It?s not something set in stone, let?s discuss and potentially 
restructure it:

1. Tutorial
 a/ Why async IO?
 b/ async/await in Python
 c/ Simple example in asyncio (Tasks + sleep) + explanation
 d/ An example of using aiohttp
 e/ How asyncio works and what is the event loop
 f/ Tasks, asyncio.gather, wait_for, cancellation

2. Advanced Tutorial
 a/ A short primer on network IO
 b/ Let?s implement a memcache driver using streams!
 c/ Let?s implement a memcache driver with transports!

3. API reference ? there are a few things we?ll need to restructure
there.


In more detail:

1a - we need to answer the question of why would you even bother
learning asyncio and async/await.  What are the benefits?  When do
you want to use asyncio and when you really shouldn?t.

1b - we need to explain async/await in a friendly way.  In particular,
you don?t need to understand the details of the async/await protocol 
etc.  What you need to know is that there are two types of functions
in Python: regular functions and coroutines.  Coroutines can be
paused and resumed in: `await`, `async with`, and `async for` 
statements.  Fundamentally, this is all you need to know about
async/await in Python. You simply use `await` for coroutines, that?s
it.

1c - A simple example similar to
https://curio.readthedocs.io/en/latest/tutorial.html#getting-started

1d - Here I propose to just use aiohttp to implement a simple
web client or hello-world-server.  I think it can be a valuable
early tutorial point to show people a real example, something they
will actually need and use asyncio for.  It?s not a problem to
use some non-standard library in the tutorial.

1e - Here we?ll need to discuss some fundamental asyncio building
blocks: event loop, callbacks, Future, and Task.  Briefly, the point
is to get the user familiar with the terminology and give them a
high-level understanding of how things work.

1f - All high-level asyncio primitives that everyone needs to know:
Tasks, gather, wait_for, etc.  No more than 5 API functions should
be covered here, culminating in a simple example.


2a - Now we are entering the ?advanced? part of the tutorial.  Let?s
explain sockets and selectors and how we tie them to callbacks using
the loop.

2b - I propose to take a simple protocol like Memcache or 
Redis and simply implement it using the streams API.  We?ll only
need two methods: set and get; and in the end we?ll teach the user
how things really work and how to design async APIs.

2c - Same as 1h but with Transports and Protocols.  Explain how
to decouple protocol parser from the IO and the benefits of that.
Show that the end result is faster than 1h, and not that much
more complex.


3 - We?ll need to restructure the current API reference a bit.  Things
that we will cover in the tutorial won?t be needed to be explained 
in detail again.  The idea is to get a simple to digest, concise
API reference.

Some things are currently documented in several different places. Like
event loops / policies, I believe we have three different pages 
covering them.  Some things aren?t needed to be fully covered at all,
like `AbstractEventLoop`.

Anyways, I think that ?3? is an easy part. The hard part is the
tutorial because it?s completely new.


> 
> Curio has a nice discussion of tasks that consume lots of CPU time
> crunching numbers, and the cooperative nature of coroutine multitasking,
> which I think is helpful.

Yes, I agree.  Maybe this should go to 1a.

> 
> Trio starts with a nice discussion of ?regular? and ?async? functions, good
> explanation of how coroutine objects get created and run.

We need this too: 1b.

> 
> Both Curio and Trio have a good discussion of their respective monitoring
> tools allowing the beginner to watch what is happening without peppering
> the code with too many prints and sleeps.

We don?t have this yet.  I think I saw a package on github 
(in aio-libs, IIRC) that implements this.  If it works we can use it in
the tutorial.

> 
> They both start with coroutines that sleep and print. Curio has a more
> entertaining example, and they both have the traditional socket echo
> server. On this point it seems somewhat unfortunate - IMO - from the
> perspective of an application developer print/sleep and socket examples are
> not the most compelling examples. The print/sleep examples aren't doing
> anything useful, and sockets are more low level than the typical
> application developer has to worry about. In my own professional
> experience, I have rarely had to use the python socket library - really
> just once to talk to HAProxy. What would be more interesting would be web
> client/servers, but this would rely on a third party library.
> 
> Curio has examples of a publish/subscribe system, and ends in a chat
> server. I really like this tutorial example as it highlights one of the
> most obvious situations where coroutines are useful - when you have a
> zillion connected clients doing nothing almost all of the time.

Yeah, this sounds entertaining.  Let?s have it too: 1d?

> 
> Somewhat related I gave a talk at PyTennessee on async/await/asyncio for
> novices and I submitted a tutorial to PyOhio that I might be able to draw
> from in this project. The one difference is that I'm able to rely on third
> party libraries (requests, aiohttp) and have a little more fun with real IO
> without having to get into sockets which I think is less familiar for most
> novices than simple http. Much like the curio example, I was playing with
> simple publish/subscribe examples possibly to use with the tutorial:
> https://gist.github.com/appeltel/fd3ddeeed6c330c7208502462639d2c9

This might be a bit too advanced for 1a-1f, we can have something like
this in the advanced tutorial.

> 
> I feel like now would be a good time to get started - is there already an
> outline of a new asyncio tutorial that I can help with, or is it worth
> taking some of these ideas from Curio and Trio and drafting out a prototype
> outline? Please let me know what you think.
> 

I?ll ask Brett if we can have a cpython-aiodocs fork under CPython 
organization.  This way we?ll be able to grant push privileges easily
to those who?s interested to work on this, and we?ll also have Issues/PRs
for workflow.

----------

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

From report at bugs.python.org  Fri May 26 13:20:00 2017
From: report at bugs.python.org (Eric Appelt)
Date: Fri, 26 May 2017 17:20:00 +0000
Subject: [docs] [issue30145] Create a How to or Tutorial documentation for
 asyncio
In-Reply-To: <1492960602.26.0.461554169011.issue30145@psf.upfronthosting.co.za>
Message-ID: <1495819200.31.0.75218979521.issue30145@psf.upfronthosting.co.za>


Changes by Eric Appelt <eric.appelt at gmail.com>:


----------
nosy: +Eric Appelt

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

From report at bugs.python.org  Fri May 26 22:51:43 2017
From: report at bugs.python.org (Martin Panter)
Date: Sat, 27 May 2017 02:51:43 +0000
Subject: [docs] [issue30304] TestCase.assertMultiLineEqual only registered
 for Unicode strings in 2.7
In-Reply-To: <1494233409.78.0.688533240712.issue30304@psf.upfronthosting.co.za>
Message-ID: <1495853503.5.0.640989839593.issue30304@psf.upfronthosting.co.za>


Martin Panter added the comment:

I think the simplest way forward would be to add the word ?Unicode? back in. You could look at making a Git Hub pull request for this if you want. Hopefully somebody else can merge it though, because I probably won?t be in a position to do so for a while.

----------

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

From report at bugs.python.org  Sat May 27 01:35:41 2017
From: report at bugs.python.org (Nick Coghlan)
Date: Sat, 27 May 2017 05:35:41 +0000
Subject: [docs] [issue19180] some RFC references could be updated
In-Reply-To: <525144B9.3040305@python.org>
Message-ID: <1495863341.44.0.178227703132.issue19180@psf.upfronthosting.co.za>


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


----------
nosy: +ncoghlan

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

From report at bugs.python.org  Sat May 27 01:44:44 2017
From: report at bugs.python.org (Nick Coghlan)
Date: Sat, 27 May 2017 05:44:44 +0000
Subject: [docs] [issue22702] to improve documentation for join() (str method)
In-Reply-To: <1414017441.98.0.187335340973.issue22702@psf.upfronthosting.co.za>
Message-ID: <1495863883.9.0.983916787833.issue22702@psf.upfronthosting.co.za>


Nick Coghlan added the comment:


New changeset 08e2f355d04d3cbea5751ce1275306ee3f569b32 by Nick Coghlan (Sanyam Khurana) in branch 'master':
bpo-22702: Clarify documentation of str.join & bytes.join (GH-156)
https://github.com/python/cpython/commit/08e2f355d04d3cbea5751ce1275306ee3f569b32


----------

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

From report at bugs.python.org  Sat May 27 01:47:38 2017
From: report at bugs.python.org (Nick Coghlan)
Date: Sat, 27 May 2017 05:47:38 +0000
Subject: [docs] [issue22702] to improve documentation for join() (str method)
In-Reply-To: <1414017441.98.0.187335340973.issue22702@psf.upfronthosting.co.za>
Message-ID: <1495864058.35.0.0514789199946.issue22702@psf.upfronthosting.co.za>


Nick Coghlan added the comment:

Raymond, I went ahead and accepted the patch to remove the "iterable iterable" phrasing by only referencing the parameter name and dropping the link to the term definition.

Do you think that's sufficient to fully resolve the request here, or would you prefer to see further changes made?

----------

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

From report at bugs.python.org  Sat May 27 10:23:28 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 27 May 2017 14:23:28 +0000
Subject: [docs] [issue30470] Deprecate invalid ctypes call protection on
 Windows
In-Reply-To: <1495691096.42.0.177794201857.issue30470@psf.upfronthosting.co.za>
Message-ID: <1495895008.31.0.953871231302.issue30470@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset f931fd1c2ad969db72460d3ab41e3d1a4a62c371 by Mariatta in branch 'master':
bpo-30470: Deprecate invalid ctypes call protection on Windows. (GH-1810)
https://github.com/python/cpython/commit/f931fd1c2ad969db72460d3ab41e3d1a4a62c371


----------

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

From report at bugs.python.org  Sat May 27 10:27:06 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 27 May 2017 14:27:06 +0000
Subject: [docs] [issue30470] Deprecate invalid ctypes call protection on
 Windows
In-Reply-To: <1495691096.42.0.177794201857.issue30470@psf.upfronthosting.co.za>
Message-ID: <1495895226.65.0.643325525565.issue30470@psf.upfronthosting.co.za>


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


----------
pull_requests: +1916

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

From report at bugs.python.org  Sat May 27 10:58:27 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 27 May 2017 14:58:27 +0000
Subject: [docs] [issue30470] Deprecate invalid ctypes call protection on
 Windows
In-Reply-To: <1495691096.42.0.177794201857.issue30470@psf.upfronthosting.co.za>
Message-ID: <1495897107.73.0.240179683641.issue30470@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 2ee91c8ad825079cdfc0d98f3f439f3b1c8ca471 by Mariatta in branch '3.6':
[3.6] bpo-30470: Deprecate invalid ctypes call protection on Windows. (GH-1810) (GH-1833)
https://github.com/python/cpython/commit/2ee91c8ad825079cdfc0d98f3f439f3b1c8ca471


----------

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

From report at bugs.python.org  Sat May 27 10:59:08 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 27 May 2017 14:59:08 +0000
Subject: [docs] [issue30470] Deprecate invalid ctypes call protection on
 Windows
In-Reply-To: <1495691096.42.0.177794201857.issue30470@psf.upfronthosting.co.za>
Message-ID: <1495897148.43.0.970950920766.issue30470@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/issue30470>
_______________________________________

From report at bugs.python.org  Sat May 27 12:49:25 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Sat, 27 May 2017 16:49:25 +0000
Subject: [docs] [issue22702] to improve documentation for join() (str method)
In-Reply-To: <1414017441.98.0.187335340973.issue22702@psf.upfronthosting.co.za>
Message-ID: <1495903764.96.0.379937973761.issue22702@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

> Do you think that's sufficient to fully resolve the request here,

Thanks Nick.  That will suffice.

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

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

From report at bugs.python.org  Sat May 27 14:28:10 2017
From: report at bugs.python.org (Gregory P. Smith)
Date: Sat, 27 May 2017 18:28:10 +0000
Subject: [docs] [issue30492] 'make clinic' does not work for out of tree
 builds / clinic.py is not in the devguide
Message-ID: <1495909690.05.0.0866994683674.issue30492@psf.upfronthosting.co.za>


New submission from Gregory P. Smith:

I never do in-tree builds anymore because they make me feel dirty and leave build artifacts cluttering up my source tree.

make clinic does not work for out of tree builds.

To reproduce:

~$ git clone ...cpython repo...
~$ mkdir build && cd build
~/build$ ../cpython/configure --with-pydebug
~/build$ make clinic
./python -E ./Tools/clinic/clinic.py --make
./python: can't open file './Tools/clinic/clinic.py': [Errno 2] No such file or directory
Makefile:545: recipe for target 'clinic' failed
make: *** [clinic] Error 2

Per https://docs.python.org/3/howto/clinic.html it looks like I can just manually run clinic.py on the files I have modified.  Ideally the build system would take care of that for me.  But all I really want is a single command that keeps me up to date.

python3 Tools/clinic/clinic.py  appears to be that command.  Even if it isn't fixed for out of tree builds, use of clinic needs to be in the devguide.

----------
assignee: docs at python
components: Argument Clinic, Documentation
messages: 294604
nosy: docs at python, gregory.p.smith, larry
priority: normal
severity: normal
stage: needs patch
status: open
title: 'make clinic' does not work for out of tree builds / clinic.py is not in the devguide
type: compile error
versions: Python 3.7

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

From report at bugs.python.org  Sat May 27 15:15:46 2017
From: report at bugs.python.org (Larry Hastings)
Date: Sat, 27 May 2017 19:15:46 +0000
Subject: [docs] [issue30492] 'make clinic' does not work for out of tree
 builds / clinic.py is not in the devguide
In-Reply-To: <1495909690.05.0.0866994683674.issue30492@psf.upfronthosting.co.za>
Message-ID: <1495912546.75.0.125765017658.issue30492@psf.upfronthosting.co.za>


Larry Hastings added the comment:

I don't know how to fix it.  "make clinic" needs to be run in-tree anyway as it's modifying the C source code in place.

Can you suggest a patch?

----------

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

From report at bugs.python.org  Sat May 27 15:26:48 2017
From: report at bugs.python.org (Gregory P. Smith)
Date: Sat, 27 May 2017 19:26:48 +0000
Subject: [docs] [issue30492] 'make clinic' does not work for out of tree
 builds / clinic.py is not in the devguide
In-Reply-To: <1495909690.05.0.0866994683674.issue30492@psf.upfronthosting.co.za>
Message-ID: <1495913208.77.0.43683145902.issue30492@psf.upfronthosting.co.za>


Gregory P. Smith added the comment:

The Makefile knows where the source tree is, I think we can make it tell clinic.py.  Let me whip something up.

----------

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

From report at bugs.python.org  Sat May 27 15:45:50 2017
From: report at bugs.python.org (Gregory P. Smith)
Date: Sat, 27 May 2017 19:45:50 +0000
Subject: [docs] [issue30492] 'make clinic' does not work for out of tree
 builds / clinic.py is not in the devguide
In-Reply-To: <1495909690.05.0.0866994683674.issue30492@psf.upfronthosting.co.za>
Message-ID: <1495914350.52.0.961099101162.issue30492@psf.upfronthosting.co.za>


Changes by Gregory P. Smith <greg at krypto.org>:


----------
pull_requests: +1920

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

From report at bugs.python.org  Sat May 27 15:48:39 2017
From: report at bugs.python.org (Gregory P. Smith)
Date: Sat, 27 May 2017 19:48:39 +0000
Subject: [docs] [issue30492] 'make clinic' does not work for out of tree
 builds / clinic.py is not in the devguide
In-Reply-To: <1495909690.05.0.0866994683674.issue30492@psf.upfronthosting.co.za>
Message-ID: <1495914518.95.0.601905716352.issue30492@psf.upfronthosting.co.za>


Gregory P. Smith added the comment:

My PR doesn't address the potential issue of needing to have done a make all before doing a make clinic.  I'll leave that for something else, there could be bootstrapping issues in that situation depending on what the developer is doing.

In that less common case, running clinic.py oneself under a stable python3 interpreter is probably advisable.

The devguide docs still need to mention 'make clinic' and point to the argument clinic docs in some section talking about the Modules/ tree.

----------

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

From report at bugs.python.org  Sat May 27 19:40:49 2017
From: report at bugs.python.org (Gregory P. Smith)
Date: Sat, 27 May 2017 23:40:49 +0000
Subject: [docs] [issue30492] 'make clinic' does not work for out of tree
 builds / clinic.py is not in the devguide
In-Reply-To: <1495909690.05.0.0866994683674.issue30492@psf.upfronthosting.co.za>
Message-ID: <1495928448.77.0.385316271675.issue30492@psf.upfronthosting.co.za>


Gregory P. Smith added the comment:


New changeset 178418ad6791b6ef5ba610ed93fab75fc1567ad2 by Gregory P. Smith in branch 'master':
bpo-30492: Allow make clinic to work out of tree. (#1836)
https://github.com/python/cpython/commit/178418ad6791b6ef5ba610ed93fab75fc1567ad2


----------

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

From report at bugs.python.org  Sun May 28 17:30:18 2017
From: report at bugs.python.org (Julien Palard)
Date: Sun, 28 May 2017 21:30:18 +0000
Subject: [docs] [issue30499] Deprecated note in set documentation
Message-ID: <1496007018.0.0.712296031489.issue30499@psf.upfronthosting.co.za>


New submission from Julien Palard:

While translating doc to french, I found a surprising comment in stdtypes.html about sets, stating:

> To support searching for an equivalent frozenset, the elem set is temporarily mutated during the search and then restored. During the search, the elem set should not be read or mutated since it does not have a meaningful value.

So I searched the equivalent in the code, at least to help me understand it to translate it in a proper way, but found it has been deleted in 51ced7afe72d861b46f069d757f2787f13253d32.

This commit is in branches 2.7 and 3.1 to 3.6 (and master).

----------
assignee: docs at python
components: Documentation
messages: 294662
nosy: docs at python, mdk, rhettinger
priority: normal
severity: normal
status: open
title: Deprecated note in set documentation
versions: Python 2.7, Python 3.5, Python 3.6

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

From report at bugs.python.org  Sun May 28 17:35:00 2017
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 28 May 2017 21:35:00 +0000
Subject: [docs] [issue30499] Deprecated note in set documentation
In-Reply-To: <1496007018.0.0.712296031489.issue30499@psf.upfronthosting.co.za>
Message-ID: <1496007300.3.0.140650968001.issue30499@psf.upfronthosting.co.za>


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


----------
pull_requests: +1932

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

From report at bugs.python.org  Sun May 28 23:34:35 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 29 May 2017 03:34:35 +0000
Subject: [docs] [issue30499] Deprecated note in set documentation
In-Reply-To: <1496007018.0.0.712296031489.issue30499@psf.upfronthosting.co.za>
Message-ID: <1496028875.38.0.45608184437.issue30499@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/issue30499>
_______________________________________

From report at bugs.python.org  Mon May 29 10:37:52 2017
From: report at bugs.python.org (Jan Hnatek)
Date: Mon, 29 May 2017 14:37:52 +0000
Subject: [docs] [issue9544] xdrlib.Packer().pack_fstring throws a TypeError
 when called with a str()
In-Reply-To: <1281333086.43.0.820305754452.issue9544@psf.upfronthosting.co.za>
Message-ID: <1496068672.82.0.812495053907.issue9544@psf.upfronthosting.co.za>


Changes by Jan Hnatek <jan.hnatek at gmail.com>:


----------
nosy: +hnhn

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

From report at bugs.python.org  Mon May 29 12:17:47 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 29 May 2017 16:17:47 +0000
Subject: [docs] [issue9544] xdrlib.Packer().pack_fstring throws a TypeError
 when called with a str()
In-Reply-To: <1281333086.43.0.820305754452.issue9544@psf.upfronthosting.co.za>
Message-ID: <1496074667.32.0.44581986415.issue9544@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

issue9544.patch LGTM as the first step. There are other mentions of strings in the documentation.

----------
nosy: +serhiy.storchaka
stage:  -> needs patch
versions: +Python 3.5, Python 3.6, Python 3.7 -Python 3.2, Python 3.3

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

From report at bugs.python.org  Mon May 29 17:26:34 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Mon, 29 May 2017 21:26:34 +0000
Subject: [docs] [issue30361] Docs example: converting mixed types to
 floating point
In-Reply-To: <1494752919.15.0.561616045601.issue30361@psf.upfronthosting.co.za>
Message-ID: <1496093194.09.0.847415605366.issue30361@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:


New changeset e405d4b8dfb8b497e1c3d1f0f8e28030040c165e by terryjreedy (gfyoung) in branch 'master':
bpo-30361: Use better example for mixed-type operands (#1701)
https://github.com/python/cpython/commit/e405d4b8dfb8b497e1c3d1f0f8e28030040c165e


----------

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

From report at bugs.python.org  Mon May 29 17:37:43 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 29 May 2017 21:37:43 +0000
Subject: [docs] [issue30361] Docs example: converting mixed types to
 floating point
In-Reply-To: <1494752919.15.0.561616045601.issue30361@psf.upfronthosting.co.za>
Message-ID: <1496093863.02.0.277307539297.issue30361@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Thanks for merging the PR, Terry.

Now it needs backport :)

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

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

From report at bugs.python.org  Mon May 29 17:41:57 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Mon, 29 May 2017 21:41:57 +0000
Subject: [docs] [issue30361] Docs example: converting mixed types to
 floating point
In-Reply-To: <1494752919.15.0.561616045601.issue30361@psf.upfronthosting.co.za>
Message-ID: <1496094117.15.0.675544890649.issue30361@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

Go ahead.  I don't care much either way.

----------

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

From report at bugs.python.org  Mon May 29 17:48:01 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 29 May 2017 21:48:01 +0000
Subject: [docs] [issue30361] Docs example: converting mixed types to
 floating point
In-Reply-To: <1494752919.15.0.561616045601.issue30361@psf.upfronthosting.co.za>
Message-ID: <1496094481.34.0.561859030473.issue30361@psf.upfronthosting.co.za>


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


----------
pull_requests: +1939

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

From report at bugs.python.org  Mon May 29 17:48:14 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 29 May 2017 21:48:14 +0000
Subject: [docs] [issue30361] Docs example: converting mixed types to
 floating point
In-Reply-To: <1494752919.15.0.561616045601.issue30361@psf.upfronthosting.co.za>
Message-ID: <1496094494.16.0.718981189221.issue30361@psf.upfronthosting.co.za>


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


----------
pull_requests: +1940

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

From report at bugs.python.org  Mon May 29 18:19:33 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Mon, 29 May 2017 22:19:33 +0000
Subject: [docs] [issue30361] Docs example: converting mixed types to
 floating point
In-Reply-To: <1494752919.15.0.561616045601.issue30361@psf.upfronthosting.co.za>
Message-ID: <1496096373.48.0.378080520159.issue30361@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:


New changeset d52f47a8f7794ee09151973a00d29c8612672e7a by terryjreedy (Mariatta) in branch '3.6':
[3.6] bpo-30361: Use better example for mixed-type operands (GH-1701) (#1856)
https://github.com/python/cpython/commit/d52f47a8f7794ee09151973a00d29c8612672e7a


----------

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

From report at bugs.python.org  Mon May 29 18:20:49 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Mon, 29 May 2017 22:20:49 +0000
Subject: [docs] [issue30361] Docs example: converting mixed types to
 floating point
In-Reply-To: <1494752919.15.0.561616045601.issue30361@psf.upfronthosting.co.za>
Message-ID: <1496096449.88.0.358331454957.issue30361@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:


New changeset 03c7cfcd52be702957cc174f5cb2ce4c8be8bfca by terryjreedy (Mariatta) in branch '3.5':
[3.5] bpo-30361: Use better example for mixed-type operands (GH-1701) (#1857)
https://github.com/python/cpython/commit/03c7cfcd52be702957cc174f5cb2ce4c8be8bfca


----------

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

From report at bugs.python.org  Mon May 29 18:23:28 2017
From: report at bugs.python.org (Terry J. Reedy)
Date: Mon, 29 May 2017 22:23:28 +0000
Subject: [docs] [issue30361] Docs example: converting mixed types to
 floating point
In-Reply-To: <1494752919.15.0.561616045601.issue30361@psf.upfronthosting.co.za>
Message-ID: <1496096608.68.0.528463203574.issue30361@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

Just curious, what sprint?

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

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

From report at bugs.python.org  Mon May 29 18:25:44 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 29 May 2017 22:25:44 +0000
Subject: [docs] [issue30361] Docs example: converting mixed types to
 floating point
In-Reply-To: <1494752919.15.0.561616045601.issue30361@psf.upfronthosting.co.za>
Message-ID: <1496096744.09.0.85899199384.issue30361@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Sorry, I don't know whether this was a sprint project or not.]
Saw that the original PR has sprint label on it, I merely copied them over to the backport PRs.

Thanks.

----------

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

From report at bugs.python.org  Mon May 29 22:39:14 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 30 May 2017 02:39:14 +0000
Subject: [docs] [issue23787] sum() function docstring lists arguments
 incorrectly
In-Reply-To: <1427455446.97.0.658394608092.issue23787@psf.upfronthosting.co.za>
Message-ID: <1496111954.06.0.324560452855.issue23787@psf.upfronthosting.co.za>


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


----------
pull_requests: +1942

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

From report at bugs.python.org  Mon May 29 22:39:33 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 30 May 2017 02:39:33 +0000
Subject: [docs] [issue23787] sum() function docstring lists arguments
 incorrectly
In-Reply-To: <1427455446.97.0.658394608092.issue23787@psf.upfronthosting.co.za>
Message-ID: <1496111973.56.0.0408876246013.issue23787@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/issue23787>
_______________________________________

From report at bugs.python.org  Tue May 30 00:36:43 2017
From: report at bugs.python.org (Martin Panter)
Date: Tue, 30 May 2017 04:36:43 +0000
Subject: [docs] [issue29596] Unfinished sentence in howto/clinic.rst
In-Reply-To: <1487380332.64.0.682733186171.issue29596@psf.upfronthosting.co.za>
Message-ID: <1496119003.55.0.928584483666.issue29596@psf.upfronthosting.co.za>


Martin Panter added the comment:

Currently for the ?buffer? destination, it says

Suppress . . ., write . . . to ``block``, and write everything else to ``file``.

Would it be more correct to change ?file? to ?buffer?? I.e.

Suppress . . ., write . . . to ``block``, and write everything else to ``buffer``.

----------
components: +Argument Clinic
nosy: +martin.panter
stage: needs patch -> patch review
title: Unfinished sentense in howto/clinic.rst -> Unfinished sentence in howto/clinic.rst

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

From report at bugs.python.org  Tue May 30 05:37:36 2017
From: report at bugs.python.org (Jan Hnatek)
Date: Tue, 30 May 2017 09:37:36 +0000
Subject: [docs] [issue9544] xdrlib.Packer().pack_fstring throws a TypeError
 when called with a str()
In-Reply-To: <1281333086.43.0.820305754452.issue9544@psf.upfronthosting.co.za>
Message-ID: <1496137056.55.0.218353137993.issue9544@psf.upfronthosting.co.za>


Jan Hnatek added the comment:

Attached an updated patch against 3.7 fixing the remaining mentions of string.

----------
Added file: http://bugs.python.org/file46914/issue9544.2.patch

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

From report at bugs.python.org  Tue May 30 16:18:31 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Tue, 30 May 2017 20:18:31 +0000
Subject: [docs] [issue17188] Document 'from None' in raise statement doc.
In-Reply-To: <1360631999.8.0.76627095073.issue17188@psf.upfronthosting.co.za>
Message-ID: <1496175511.34.0.978593297149.issue17188@psf.upfronthosting.co.za>


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


----------
pull_requests: +1949

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

From report at bugs.python.org  Tue May 30 16:27:42 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 30 May 2017 20:27:42 +0000
Subject: [docs] [issue17188] Document 'from None' in raise statement doc.
In-Reply-To: <1360631999.8.0.76627095073.issue17188@psf.upfronthosting.co.za>
Message-ID: <1496176062.14.0.0272804402329.issue17188@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 00b381b9a7b6b15350d1dcf7c688bf808cbf0ebb by Mariatta (csabella) in branch '3.6':
bpo-17188: DOC: Document 'from None' in raise statement (GH-1671) (GH-1867)
https://github.com/python/cpython/commit/00b381b9a7b6b15350d1dcf7c688bf808cbf0ebb


----------

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

From report at bugs.python.org  Tue May 30 16:31:02 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 30 May 2017 20:31:02 +0000
Subject: [docs] [issue17188] Document 'from None' in raise statement doc.
In-Reply-To: <1360631999.8.0.76627095073.issue17188@psf.upfronthosting.co.za>
Message-ID: <1496176262.69.0.956309159201.issue17188@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Patch has been applied to 3.7 and 3.6.
Thanks everyone :)

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

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

From report at bugs.python.org  Tue May 30 16:32:08 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Tue, 30 May 2017 20:32:08 +0000
Subject: [docs] [issue30354] Change data model documentation to
 zero-argument super()
In-Reply-To: <1494618013.81.0.516656587156.issue30354@psf.upfronthosting.co.za>
Message-ID: <1496176328.44.0.250194168708.issue30354@psf.upfronthosting.co.za>


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


----------
pull_requests: +1951

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

From report at bugs.python.org  Tue May 30 16:33:01 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Tue, 30 May 2017 20:33:01 +0000
Subject: [docs] [issue30354] Change data model documentation to
 zero-argument super()
In-Reply-To: <1494618013.81.0.516656587156.issue30354@psf.upfronthosting.co.za>
Message-ID: <1496176381.47.0.817382676461.issue30354@psf.upfronthosting.co.za>


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


----------
pull_requests: +1952

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

From report at bugs.python.org  Tue May 30 16:34:52 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 30 May 2017 20:34:52 +0000
Subject: [docs] [issue30354] Change data model documentation to
 zero-argument super()
In-Reply-To: <1494618013.81.0.516656587156.issue30354@psf.upfronthosting.co.za>
Message-ID: <1496176492.49.0.472884585753.issue30354@psf.upfronthosting.co.za>


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


----------
stage:  -> backport needed
versions: +Python 3.5, Python 3.6

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

From report at bugs.python.org  Tue May 30 16:47:49 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 30 May 2017 20:47:49 +0000
Subject: [docs] [issue30354] Change data model documentation to
 zero-argument super()
In-Reply-To: <1494618013.81.0.516656587156.issue30354@psf.upfronthosting.co.za>
Message-ID: <1496177269.76.0.189144838954.issue30354@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 75ea91bb736f2a061a3ebc689ff17629bdc15568 by Mariatta (csabella) in branch '3.5':
bpo-30354: Update data model documentation for super() (GH-1561) (GH-1869)
https://github.com/python/cpython/commit/75ea91bb736f2a061a3ebc689ff17629bdc15568


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

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

From report at bugs.python.org  Tue May 30 16:48:25 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 30 May 2017 20:48:25 +0000
Subject: [docs] [issue30354] Change data model documentation to
 zero-argument super()
In-Reply-To: <1494618013.81.0.516656587156.issue30354@psf.upfronthosting.co.za>
Message-ID: <1496177305.9.0.161043747506.issue30354@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset ad13d54646d189cea8e6f7a9bc4a87e20df33ac4 by Mariatta (csabella) in branch '3.6':
bpo-30354: Update data model documentation for super() (GH-1561) (GH-1868)
https://github.com/python/cpython/commit/ad13d54646d189cea8e6f7a9bc4a87e20df33ac4


----------

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

From report at bugs.python.org  Tue May 30 16:49:20 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 30 May 2017 20:49:20 +0000
Subject: [docs] [issue30354] Change data model documentation to
 zero-argument super()
In-Reply-To: <1494618013.81.0.516656587156.issue30354@psf.upfronthosting.co.za>
Message-ID: <1496177360.74.0.512390364499.issue30354@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Thanks for the PR and the backports, Cheryl :)

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

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

From report at bugs.python.org  Tue May 30 17:15:42 2017
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 30 May 2017 21:15:42 +0000
Subject: [docs] [issue17188] Document 'from None' in raise statement doc.
In-Reply-To: <1360631999.8.0.76627095073.issue17188@psf.upfronthosting.co.za>
Message-ID: <1496178942.08.0.592051539504.issue17188@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

Seems periods at the ends of sentences are missed.

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

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

From report at bugs.python.org  Tue May 30 17:30:17 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 30 May 2017 21:30:17 +0000
Subject: [docs] [issue17188] Document 'from None' in raise statement doc.
In-Reply-To: <1360631999.8.0.76627095073.issue17188@psf.upfronthosting.co.za>
Message-ID: <1496179816.99.0.527454070681.issue17188@psf.upfronthosting.co.za>


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


----------
pull_requests: +1955

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

From report at bugs.python.org  Tue May 30 18:26:44 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 30 May 2017 22:26:44 +0000
Subject: [docs] [issue17188] Document 'from None' in raise statement doc.
In-Reply-To: <1360631999.8.0.76627095073.issue17188@psf.upfronthosting.co.za>
Message-ID: <1496183204.35.0.171910199666.issue17188@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 9efad1e5aef32a6d8ca288793e8ee6df8782f615 by Mariatta in branch 'master':
bpo-17188: add missing periods at the end of sentences (GH-1875)
https://github.com/python/cpython/commit/9efad1e5aef32a6d8ca288793e8ee6df8782f615


----------

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

From report at bugs.python.org  Tue May 30 18:28:17 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 30 May 2017 22:28:17 +0000
Subject: [docs] [issue17188] Document 'from None' in raise statement doc.
In-Reply-To: <1360631999.8.0.76627095073.issue17188@psf.upfronthosting.co.za>
Message-ID: <1496183297.12.0.872328606307.issue17188@psf.upfronthosting.co.za>


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


----------
pull_requests: +1956

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

From report at bugs.python.org  Tue May 30 18:37:45 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 30 May 2017 22:37:45 +0000
Subject: [docs] [issue17188] Document 'from None' in raise statement doc.
In-Reply-To: <1360631999.8.0.76627095073.issue17188@psf.upfronthosting.co.za>
Message-ID: <1496183865.76.0.634642847577.issue17188@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 60b257b01ca497d7a556e3f526704aa1b923d1ac by Mariatta in branch '3.6':
bpo-17188: add missing periods at the end of sentences (GH-1875) (GH-1876)
https://github.com/python/cpython/commit/60b257b01ca497d7a556e3f526704aa1b923d1ac


----------

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

From report at bugs.python.org  Tue May 30 18:38:56 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 30 May 2017 22:38:56 +0000
Subject: [docs] [issue17188] Document 'from None' in raise statement doc.
In-Reply-To: <1360631999.8.0.76627095073.issue17188@psf.upfronthosting.co.za>
Message-ID: <1496183936.04.0.660794511677.issue17188@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Thanks Serhiy.
I added the missing periods.

----------

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

From micahleviparks at gmail.com  Tue May 30 20:27:08 2017
From: micahleviparks at gmail.com (Micah Parks)
Date: Tue, 30 May 2017 20:27:08 -0400
Subject: [docs] Minor Issue (Broken Link) on SSL Module Library Page
Message-ID: <CA+ayZfuPQ2RoZmGzZuKuS-EnjNr8d-isGXqrQ3_1ytw7NBxGdA@mail.gmail.com>

Hello,

I found a broken link on the SSL module library page for Python 3.6.1. This
link is under "18.2.1.1. Socket creation" in the "ssl.wrap_socket"
function. The description for the *ciphers *keyword argument contains this
text: "The *ciphers* parameter sets the available ciphers for this SSL
object. It should be a string in the OpenSSL cipher list format
<https://www.openssl.org/docs/apps/ciphers.html#CIPHER-LIST-FORMAT>." This
link is broken. I believe the correct link should lead to: "
https://www.openssl.org/docs/man1.1.0/apps/ciphers.html".

Other versions of the docs appear to need this small updated link too.

Thank you contributing your time to the Python community!
Micah Parks
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20170530/c3ce4794/attachment.html>

From report at bugs.python.org  Wed May 31 17:11:25 2017
From: report at bugs.python.org (Mariano Anaya)
Date: Wed, 31 May 2017 21:11:25 +0000
Subject: [docs] [issue30530] Descriptors HowTo: Example on function.__get__
 needs update
Message-ID: <1496265085.29.0.159074921199.issue30530@psf.upfronthosting.co.za>


New submission from Mariano Anaya:

The example on which tries to create a method from the function's __get__ doesn't work for Python 3.5+. It would give this error:

TypeError: method expected 2 arguments, got 3

The 3rd parameter, needs to be removed.

----------
assignee: docs at python
components: Documentation
messages: 294871
nosy: Mariano Anaya, docs at python
priority: normal
pull_requests: 1967
severity: normal
status: open
title: Descriptors HowTo: Example on function.__get__ needs update
versions: Python 3.5, Python 3.6, Python 3.7

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

From report at bugs.python.org  Wed May 31 18:21:14 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 31 May 2017 22:21:14 +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: <1496269274.86.0.236857606308.issue30530@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/issue30530>
_______________________________________

From report at bugs.python.org  Wed May 31 19:58:03 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Wed, 31 May 2017 23:58:03 +0000
Subject: [docs] [issue27618] docs for threading.Lock claim it's a class
 (since 3.3), but it's not (and has never been, apparently)
In-Reply-To: <1469480103.96.0.342423272445.issue27618@psf.upfronthosting.co.za>
Message-ID: <1496275082.58.0.68202948154.issue27618@psf.upfronthosting.co.za>


Cheryl Sabella added the comment:

*bump*

The PR was approved by R. David Murray a while ago.  I can backport once it's merged.

Thanks!

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

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

From report at bugs.python.org  Wed May 31 20:14:29 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 01 Jun 2017 00:14:29 +0000
Subject: [docs] [issue27618] docs for threading.Lock claim it's a class
 (since 3.3), but it's not (and has never been, apparently)
In-Reply-To: <1469480103.96.0.342423272445.issue27618@psf.upfronthosting.co.za>
Message-ID: <1496276066.7.0.188075657034.issue27618@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 56ddfd2eea4d98456a9a99bf2a718f21ee6b2be2 by Mariatta (csabella) in branch 'master':
bpo-27618: Clarify that threading.Lock is a factory function (GH-1307)
https://github.com/python/cpython/commit/56ddfd2eea4d98456a9a99bf2a718f21ee6b2be2


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

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

From report at bugs.python.org  Wed May 31 20:22:40 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 01 Jun 2017 00:22:40 +0000
Subject: [docs] [issue27618] docs for threading.Lock claim it's a class
 (since 3.3), but it's not (and has never been, apparently)
In-Reply-To: <1469480103.96.0.342423272445.issue27618@psf.upfronthosting.co.za>
Message-ID: <1496276560.6.0.0711722668752.issue27618@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Thanks for the PR Cheryl. 

You can backport using cherry_picker.py 
Note that there's a recent update to it: https://github.com/python/core-workflow/tree/master/cherry_picker

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

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

From report at bugs.python.org  Wed May 31 21:18:27 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 01 Jun 2017 01:18:27 +0000
Subject: [docs] [issue27618] docs for threading.Lock claim it's a class
 (since 3.3), but it's not (and has never been, apparently)
In-Reply-To: <1469480103.96.0.342423272445.issue27618@psf.upfronthosting.co.za>
Message-ID: <1496279907.68.0.549921651804.issue27618@psf.upfronthosting.co.za>


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


----------
pull_requests: +1972

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

From report at bugs.python.org  Wed May 31 21:19:15 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 01 Jun 2017 01:19:15 +0000
Subject: [docs] [issue27618] docs for threading.Lock claim it's a class
 (since 3.3), but it's not (and has never been, apparently)
In-Reply-To: <1469480103.96.0.342423272445.issue27618@psf.upfronthosting.co.za>
Message-ID: <1496279955.65.0.216315188239.issue27618@psf.upfronthosting.co.za>


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


----------
pull_requests: +1973

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

From report at bugs.python.org  Wed May 31 21:46:10 2017
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 01 Jun 2017 01:46:10 +0000
Subject: [docs] [issue27618] docs for threading.Lock claim it's a class
 (since 3.3), but it's not (and has never been, apparently)
In-Reply-To: <1469480103.96.0.342423272445.issue27618@psf.upfronthosting.co.za>
Message-ID: <1496281570.92.0.459744657421.issue27618@psf.upfronthosting.co.za>


Cheryl Sabella added the comment:

Thanks, Mariatta.  I've backported to 3.5 and 3.6 with the new cherry_picker instructions.

----------

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

From report at bugs.python.org  Wed May 31 21:49:56 2017
From: report at bugs.python.org (Eric Appelt)
Date: Thu, 01 Jun 2017 01:49:56 +0000
Subject: [docs] [issue30145] Create a How to or Tutorial documentation for
 asyncio
In-Reply-To: <1492960602.26.0.461554169011.issue30145@psf.upfronthosting.co.za>
Message-ID: <1496281796.69.0.691387293857.issue30145@psf.upfronthosting.co.za>


Eric Appelt added the comment:

> 2b - I propose to take a simple protocol like Memcache or 
> Redis and simply implement it using the streams API.  We?ll only
> need two methods: set and get; and in the end we?ll teach the user
> how things really work and how to design async APIs.

I decided to make myself a test subject for this idea using Redis since although I use Redis a lot at work I've never looked at the underlying Redis protocol. I also haven't used the streams API in a long time, and never for anything other than simple exploration.

I worked on this the other night and found the Redis protocol simple enough to understand and was able to write a simple and somewhat clumsy client the other night with a bit of work: https://gist.github.com/appeltel/09d77eb489494ae1e2703933108cb60a

One thing that might be good about the Redis protocol for this purpose is that the parsing isn't completely trivial but it isn't overly complex either. For example, a response string can be given in either the simple format, which begins with a "+" byte and then terminates with "\r\n", or it can be in a binary safe format where a token of the form "$123\r\n" is sent first, signaling that the next 123 bytes are the result to be followed by another "\r\n" termination. There is also the sentinel value "$-1\r\n" which may signal an unset key. Thus the string "foo" might be sent as "+foo\r\n" or "$3\r\nfoo\r\n".

So I think this can be reasonably described in a few brief paragraphs and it is much more interesting (to me) than an echo client/server example.

The tutorial should probably also include a link to a rudimentary server implementation of an in-memory key/value store implementing the Redis protocol and supporting just GET and SET, as the reader may not be able to easily stand up Redis for a variety of reasons or lack of knowledge.

I can experiment with memcached as well but I think this proposal is a good idea and would work well with Redis.

----------

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

From report at bugs.python.org  Wed May 31 21:53:11 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 01 Jun 2017 01:53:11 +0000
Subject: [docs] [issue27618] docs for threading.Lock claim it's a class
 (since 3.3), but it's not (and has never been, apparently)
In-Reply-To: <1469480103.96.0.342423272445.issue27618@psf.upfronthosting.co.za>
Message-ID: <1496281991.09.0.500815286262.issue27618@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 958e815fe014e9a3c64f3568b883c2a7b32a4e2e by Mariatta (csabella) in branch '3.5':
bpo-27618: Clarify that threading.Lock is a factory function (GH-1307) (GH-1895)
https://github.com/python/cpython/commit/958e815fe014e9a3c64f3568b883c2a7b32a4e2e


----------

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

From report at bugs.python.org  Wed May 31 21:53:26 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 01 Jun 2017 01:53:26 +0000
Subject: [docs] [issue27618] docs for threading.Lock claim it's a class
 (since 3.3), but it's not (and has never been, apparently)
In-Reply-To: <1469480103.96.0.342423272445.issue27618@psf.upfronthosting.co.za>
Message-ID: <1496282006.73.0.15422168239.issue27618@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 9abd0bf68f73b3beb56954e22740f0efcf04bc79 by Mariatta (csabella) in branch '3.6':
bpo-27618: Clarify that threading.Lock is a factory function (GH-1307) (GH-1894)
https://github.com/python/cpython/commit/9abd0bf68f73b3beb56954e22740f0efcf04bc79


----------

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

From report at bugs.python.org  Wed May 31 21:54:19 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 01 Jun 2017 01:54:19 +0000
Subject: [docs] [issue27618] docs for threading.Lock claim it's a class
 (since 3.3), but it's not (and has never been, apparently)
In-Reply-To: <1469480103.96.0.342423272445.issue27618@psf.upfronthosting.co.za>
Message-ID: <1496282059.91.0.0909150360083.issue27618@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:

Thanks :)

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

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

From report at bugs.python.org  Wed May 31 21:59:08 2017
From: report at bugs.python.org (Yury Selivanov)
Date: Thu, 01 Jun 2017 01:59:08 +0000
Subject: [docs] [issue30145] Create a How to or Tutorial documentation for
 asyncio
In-Reply-To: <1492960602.26.0.461554169011.issue30145@psf.upfronthosting.co.za>
Message-ID: <1496282348.02.0.608350241131.issue30145@psf.upfronthosting.co.za>


Yury Selivanov added the comment:

I've created a repo for discussing and making next version of asyncio docs: https://github.com/asyncio-docs/cpython-aiodocs. Feel free to join!

----------

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

From report at bugs.python.org  Wed May 31 22:01:10 2017
From: report at bugs.python.org (Yury Selivanov)
Date: Thu, 01 Jun 2017 02:01:10 +0000
Subject: [docs] [issue30145] Create a How to or Tutorial documentation for
 asyncio
In-Reply-To: <1492960602.26.0.461554169011.issue30145@psf.upfronthosting.co.za>
Message-ID: <1496282469.99.0.670998035296.issue30145@psf.upfronthosting.co.za>


Yury Selivanov added the comment:

I propose to start using the issues [1] as there are so many topics we'll have to discuss.  Feel free to create new issue for whatever idea you have!

[1] https://github.com/asyncio-docs/cpython-aiodocs/issues

----------

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

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


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


----------
stage:  -> patch review
versions: +Python 3.7

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

From report at bugs.python.org  Wed May 31 22:24:55 2017
From: report at bugs.python.org (Yury Selivanov)
Date: Thu, 01 Jun 2017 02:24:55 +0000
Subject: [docs] [issue30145] Create a How to or Tutorial documentation for
 asyncio
In-Reply-To: <1492960602.26.0.461554169011.issue30145@psf.upfronthosting.co.za>
Message-ID: <1496283895.92.0.503525916522.issue30145@psf.upfronthosting.co.za>


Yury Selivanov added the comment:

> I can experiment with memcached as well but I think this proposal is a good idea and would work well with Redis.

I like it! Let's use Redis as an example. Please open an issue at asyncio-docs to discuss the details.

----------

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

From report at bugs.python.org  Wed May 31 22:26:19 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 01 Jun 2017 02:26:19 +0000
Subject: [docs] [issue22702] to improve documentation for join() (str method)
In-Reply-To: <1414017441.98.0.187335340973.issue22702@psf.upfronthosting.co.za>
Message-ID: <1496283979.51.0.0577751218467.issue22702@psf.upfronthosting.co.za>


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


----------
stage: resolved -> backport needed
versions: +Python 3.6, Python 3.7 -Python 3.4

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

From report at bugs.python.org  Wed May 31 22:29:24 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 01 Jun 2017 02:29:24 +0000
Subject: [docs] [issue22702] to improve documentation for join() (str method)
In-Reply-To: <1414017441.98.0.187335340973.issue22702@psf.upfronthosting.co.za>
Message-ID: <1496284164.04.0.0123927392529.issue22702@psf.upfronthosting.co.za>


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


----------
pull_requests: +1974

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

From report at bugs.python.org  Wed May 31 22:29:59 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 01 Jun 2017 02:29:59 +0000
Subject: [docs] [issue22702] to improve documentation for join() (str method)
In-Reply-To: <1414017441.98.0.187335340973.issue22702@psf.upfronthosting.co.za>
Message-ID: <1496284199.83.0.00548228741222.issue22702@psf.upfronthosting.co.za>


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


----------
pull_requests: +1975

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

From report at bugs.python.org  Wed May 31 22:32:48 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 01 Jun 2017 02:32:48 +0000
Subject: [docs] [issue22702] to improve documentation for join() (str method)
In-Reply-To: <1414017441.98.0.187335340973.issue22702@psf.upfronthosting.co.za>
Message-ID: <1496284368.36.0.57927879169.issue22702@psf.upfronthosting.co.za>


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


----------
pull_requests: +1976

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

From report at bugs.python.org  Wed May 31 22:48:30 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 01 Jun 2017 02:48:30 +0000
Subject: [docs] [issue22702] to improve documentation for join() (str method)
In-Reply-To: <1414017441.98.0.187335340973.issue22702@psf.upfronthosting.co.za>
Message-ID: <1496285310.43.0.973465463919.issue22702@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 1721b06a78a4fd7942d9658ac8add6911a1a03e3 by Mariatta in branch '3.5':
bpo-22702: Clarify documentation of str.join & bytes.join (GH-156) (GH-1896)
https://github.com/python/cpython/commit/1721b06a78a4fd7942d9658ac8add6911a1a03e3


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

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

From report at bugs.python.org  Wed May 31 22:49:03 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 01 Jun 2017 02:49:03 +0000
Subject: [docs] [issue22702] to improve documentation for join() (str method)
In-Reply-To: <1414017441.98.0.187335340973.issue22702@psf.upfronthosting.co.za>
Message-ID: <1496285343.52.0.565092970594.issue22702@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 9522159bc41f2be0f4aafd0fa182669876aca47f by Mariatta in branch '3.6':
bpo-22702: Clarify documentation of str.join & bytes.join (GH-156) (GH-1897)
https://github.com/python/cpython/commit/9522159bc41f2be0f4aafd0fa182669876aca47f


----------

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

From report at bugs.python.org  Wed May 31 22:49:33 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 01 Jun 2017 02:49:33 +0000
Subject: [docs] [issue22702] to improve documentation for join() (str method)
In-Reply-To: <1414017441.98.0.187335340973.issue22702@psf.upfronthosting.co.za>
Message-ID: <1496285373.03.0.932106838228.issue22702@psf.upfronthosting.co.za>


Mariatta Wijaya added the comment:


New changeset 9139f23464ed0f71cb0e34a535a5b7ddf7fad748 by Mariatta in branch '2.7':
bpo-22702: Clarify documentation of str.join & bytes.join (GH-156) (GH-1898)
https://github.com/python/cpython/commit/9139f23464ed0f71cb0e34a535a5b7ddf7fad748


----------

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

From report at bugs.python.org  Wed May 31 22:50:00 2017
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 01 Jun 2017 02:50:00 +0000
Subject: [docs] [issue22702] to improve documentation for join() (str method)
In-Reply-To: <1414017441.98.0.187335340973.issue22702@psf.upfronthosting.co.za>
Message-ID: <1496285400.45.0.336935442488.issue22702@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Wed May 31 23:25:58 2017
From: report at bugs.python.org (Raymond Hettinger)
Date: Thu, 01 Jun 2017 03:25:58 +0000
Subject: [docs] [issue30499] Deprecated note in set documentation
In-Reply-To: <1496007018.0.0.712296031489.issue30499@psf.upfronthosting.co.za>
Message-ID: <1496287558.05.0.124404274225.issue30499@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

This is good to go.

----------
assignee: rhettinger -> Mariatta
nosy: +Mariatta

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