From report at bugs.python.org  Sun Apr  1 01:26:13 2018
From: report at bugs.python.org (INADA Naoki)
Date: Sun, 01 Apr 2018 05:26:13 +0000
Subject: [docs] [issue33195] PyArg_Parse* should deprecate 'u' and 'z'
 family.
Message-ID: <1522560373.89.0.467229070634.issue33195@psf.upfronthosting.co.za>


New submission from INADA Naoki <songofacandy at gmail.com>:

https://docs.python.org/3/c-api/arg.html

Py_UNICODE usage is not deprecated in this document.
Before thinking about raising warning, deprecate it in document first.

But... from when?  Can I backport the "deprecated" doc to 3.6 or 3.5?

----------
assignee: docs at python
components: Documentation
messages: 314761
nosy: docs at python, inada.naoki
priority: normal
severity: normal
status: open
title: PyArg_Parse* should deprecate 'u' and 'z' family.
versions: Python 3.7, Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33195>
_______________________________________

From report at bugs.python.org  Sun Apr  1 01:28:24 2018
From: report at bugs.python.org (INADA Naoki)
Date: Sun, 01 Apr 2018 05:28:24 +0000
Subject: [docs] [issue33195] PyArg_Parse* should deprecate 'u' and 'z'
 family.
In-Reply-To: <1522560373.89.0.467229070634.issue33195@psf.upfronthosting.co.za>
Message-ID: <1522560504.8.0.714561066657.issue33195@psf.upfronthosting.co.za>


Change by INADA Naoki <songofacandy at gmail.com>:


----------
keywords: +patch
pull_requests: +6042
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33195>
_______________________________________

From report at bugs.python.org  Sun Apr  1 02:38:24 2018
From: report at bugs.python.org (Nick Coghlan)
Date: Sun, 01 Apr 2018 06:38:24 +0000
Subject: [docs] [issue33130] functools.reduce signature/docstring discordance
In-Reply-To: <1521849944.24.0.467229070634.issue33130@psf.upfronthosting.co.za>
Message-ID: <1522564704.82.0.467229070634.issue33130@psf.upfronthosting.co.za>


Nick Coghlan <ncoghlan at gmail.com> added the comment:

+1 for switching over to `iterable` in the reduce docstring.

As a possible enhancement for 3.8+ only, it would be reasonable to start converting functools over to Argument Clinic in order to improve the introspection support. (Note that only some APIs could be converted though, as others have more complex signatures that AC doesn't yet support: https://bugs.python.org/issue20291)

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33130>
_______________________________________

From report at bugs.python.org  Sun Apr  1 03:18:19 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 01 Apr 2018 07:18:19 +0000
Subject: [docs] [issue33195] PyArg_Parse* should deprecate 'u' and 'z'
 family.
In-Reply-To: <1522560373.89.0.467229070634.issue33195@psf.upfronthosting.co.za>
Message-ID: <1522567099.65.0.467229070634.issue33195@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:

See also issue24009. We should get rid of using these units in the stdlib.

I'm not sure about deprecating Py_BuildValue() units right now. They can be redefined in terms of wchar_t, and they are already implemented with PyUnicode_FromWideChar().

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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33195>
_______________________________________

From report at bugs.python.org  Sun Apr  1 15:03:03 2018
From: report at bugs.python.org (Antoine Pitrou)
Date: Sun, 01 Apr 2018 19:03:03 +0000
Subject: [docs] [issue33201] Modernize "Extension types" documentation
Message-ID: <1522609383.56.0.467229070634.issue33201@psf.upfronthosting.co.za>


New submission from Antoine Pitrou <pitrou at free.fr>:

The "Defining New Types" in the C extension docs uses outdated idioms (e.g. pre-C99 struct initialization) and could do with a good refresh.

----------
assignee: docs at python
components: Documentation
messages: 314782
nosy: docs at python, pitrou
priority: normal
severity: normal
stage: needs patch
status: open
title: Modernize "Extension types" documentation
type: behavior
versions: Python 3.6, Python 3.7, Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33201>
_______________________________________

From report at bugs.python.org  Sun Apr  1 15:18:16 2018
From: report at bugs.python.org (Antoine Pitrou)
Date: Sun, 01 Apr 2018 19:18:16 +0000
Subject: [docs] [issue33201] Modernize "Extension types" documentation
In-Reply-To: <1522609383.56.0.467229070634.issue33201@psf.upfronthosting.co.za>
Message-ID: <1522610296.99.0.714561066657.issue33201@psf.upfronthosting.co.za>


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


----------
keywords: +patch
pull_requests: +6048
stage: needs patch -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33201>
_______________________________________

From report at bugs.python.org  Sun Apr  1 15:21:50 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Sun, 01 Apr 2018 19:21:50 +0000
Subject: [docs] [issue33202] os.walk mentions os.listdir instead of
 os.scandir
Message-ID: <1522610510.25.0.467229070634.issue33202@psf.upfronthosting.co.za>


New submission from Andr?s Delfino <adelfino at gmail.com>:

Documentation states that, for walk, "errors from the listdir() call are ignored". That's no longer the case since 3.5. Change mention to listdir() to scandir().

----------
assignee: docs at python
components: Documentation
messages: 314786
nosy: adelfino, docs at python
priority: normal
pull_requests: 6049
severity: normal
status: open
title: os.walk mentions os.listdir instead of os.scandir
versions: Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33202>
_______________________________________

From report at bugs.python.org  Sun Apr  1 18:53:37 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 01 Apr 2018 22:53:37 +0000
Subject: [docs] [issue27212] Doc for itertools,
 'islice()' implementation have unwanted behavior for recipe
 'consume()'
In-Reply-To: <1465018426.98.0.63725897135.issue27212@psf.upfronthosting.co.za>
Message-ID: <1522623217.69.0.714561066657.issue27212@psf.upfronthosting.co.za>


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


----------
pull_requests: +6051

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue27212>
_______________________________________

From report at bugs.python.org  Sun Apr  1 19:41:10 2018
From: report at bugs.python.org (Antoine Pitrou)
Date: Sun, 01 Apr 2018 23:41:10 +0000
Subject: [docs] [issue15088] PyGen_NeedsFinalizing is public,
 but undocumented
In-Reply-To: <1339906861.99.0.42415214654.issue15088@psf.upfronthosting.co.za>
Message-ID: <1522626070.52.0.467229070634.issue15088@psf.upfronthosting.co.za>


Antoine Pitrou <pitrou at free.fr> added the comment:

Cheryl: it may be useful to do a code search to find out whether any third-party projects are relying on PyGen_NeedsFinalizing.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue15088>
_______________________________________

From report at bugs.python.org  Sun Apr  1 20:55:27 2018
From: report at bugs.python.org (Lisa Roach)
Date: Mon, 02 Apr 2018 00:55:27 +0000
Subject: [docs] [issue30940] Documentation for round() is incorrect.
In-Reply-To: <1500223918.38.0.72996478594.issue30940@psf.upfronthosting.co.za>
Message-ID: <1522630527.44.0.714561066657.issue30940@psf.upfronthosting.co.za>


Change by Lisa Roach <lisaroach14 at gmail.com>:


----------
keywords: +patch
pull_requests: +6053

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue30940>
_______________________________________

From report at bugs.python.org  Mon Apr  2 01:29:05 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 02 Apr 2018 05:29:05 +0000
Subject: [docs] [issue27212] Doc for itertools,
 'islice()' implementation have unwanted behavior for recipe
 'consume()'
In-Reply-To: <1465018426.98.0.63725897135.issue27212@psf.upfronthosting.co.za>
Message-ID: <1522646945.04.0.467229070634.issue27212@psf.upfronthosting.co.za>


Raymond Hettinger <raymond.hettinger at gmail.com> added the comment:


New changeset 325191bd6b3a2d5e3012adee868f19baf3e2c3ab by Raymond Hettinger (Cheryl Sabella) in branch '2.7':
[2.7] bpo-27212: Modify islice recipe to consume initial values preceding start (GH-6195) (GH-6339)
https://github.com/python/cpython/commit/325191bd6b3a2d5e3012adee868f19baf3e2c3ab


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue27212>
_______________________________________

From report at bugs.python.org  Mon Apr  2 01:29:54 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 02 Apr 2018 05:29:54 +0000
Subject: [docs] [issue27212] Doc for itertools,
 'islice()' implementation have unwanted behavior for recipe
 'consume()'
In-Reply-To: <1465018426.98.0.63725897135.issue27212@psf.upfronthosting.co.za>
Message-ID: <1522646994.12.0.467229070634.issue27212@psf.upfronthosting.co.za>


Raymond Hettinger <raymond.hettinger at gmail.com> added the comment:

Thanks Cheryl.  This was nice work :-)

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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue27212>
_______________________________________

From report at bugs.python.org  Mon Apr  2 10:30:19 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Mon, 02 Apr 2018 14:30:19 +0000
Subject: [docs] [issue15088] PyGen_NeedsFinalizing is public,
 but undocumented
In-Reply-To: <1339906861.99.0.42415214654.issue15088@psf.upfronthosting.co.za>
Message-ID: <1522679419.73.0.467229070634.issue15088@psf.upfronthosting.co.za>


Cheryl Sabella <chekat2 at gmail.com> added the comment:

Thanks Antoine.

Do you have a good way for searching third party projects?  I searched on Github and I'm getting a lot of references to the CPython filenames.  I don't know how to check if anyone is making calls to the function.  But, maybe that's the point and it can't be removed if there's a chance that anyone uses it?  Thanks!

This is what I tried on Github:
PyGen_NeedsFinalizing -filename:ceval -filename:genobject -filename:gcmodule

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue15088>
_______________________________________

From report at bugs.python.org  Mon Apr  2 10:32:36 2018
From: report at bugs.python.org (Antoine Pitrou)
Date: Mon, 02 Apr 2018 14:32:36 +0000
Subject: [docs] [issue15088] PyGen_NeedsFinalizing is public,
 but undocumented
In-Reply-To: <1339906861.99.0.42415214654.issue15088@psf.upfronthosting.co.za>
Message-ID: <1522679556.1.0.467229070634.issue15088@psf.upfronthosting.co.za>


Antoine Pitrou <pitrou at free.fr> added the comment:

I think https://searchcode.com/ may have a larger indexing base than GitHub alone.

And, yes, you'll see many duplicates of the CPython source code... Visual inspection may be needed :-/

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue15088>
_______________________________________

From report at bugs.python.org  Mon Apr  2 13:36:40 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Mon, 02 Apr 2018 17:36:40 +0000
Subject: [docs] [issue27212] Doc for itertools,
 'islice()' implementation have unwanted behavior for recipe
 'consume()'
In-Reply-To: <1465018426.98.0.63725897135.issue27212@psf.upfronthosting.co.za>
Message-ID: <1522690600.49.0.467229070634.issue27212@psf.upfronthosting.co.za>


Cheryl Sabella <chekat2 at gmail.com> added the comment:

Thanks!  :-)

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue27212>
_______________________________________

From report at bugs.python.org  Mon Apr  2 15:25:31 2018
From: report at bugs.python.org (Lino Mastrodomenico)
Date: Mon, 02 Apr 2018 19:25:31 +0000
Subject: [docs] [issue32216] Document PEP 557 Data Classes (dataclasses
 module)
In-Reply-To: <1512439511.23.0.213398074469.issue32216@psf.upfronthosting.co.za>
Message-ID: <1522697131.61.0.467229070634.issue32216@psf.upfronthosting.co.za>


Lino Mastrodomenico <l.mastrodomenico at gmail.com> added the comment:

Friendly ping, there's still no documentation for this wonderful new module and there's only one planned beta left for 3.7 before the release candidates.

Needless to say, https://www.python.org/dev/peps/pep-0557/ has lots of information that could be a starting point.

----------
nosy: +mastrodomenico

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32216>
_______________________________________

From report at bugs.python.org  Mon Apr  2 22:48:56 2018
From: report at bugs.python.org (Benjamin Peterson)
Date: Tue, 03 Apr 2018 02:48:56 +0000
Subject: [docs] [issue33202] os.walk mentions os.listdir instead of
 os.scandir
In-Reply-To: <1522610510.25.0.467229070634.issue33202@psf.upfronthosting.co.za>
Message-ID: <1522723736.69.0.467229070634.issue33202@psf.upfronthosting.co.za>


Benjamin Peterson <benjamin at python.org> added the comment:


New changeset badb894bbbb8aaa8b669c4a6f675a0bc7d98e188 by Benjamin Peterson (Andr?s Delfino) in branch 'master':
closes bpo-33202: fix os.walk mentioning os.listdir instead of os.scandir (GH-6335)
https://github.com/python/cpython/commit/badb894bbbb8aaa8b669c4a6f675a0bc7d98e188


----------
nosy: +benjamin.peterson
resolution:  -> fixed
stage:  -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33202>
_______________________________________

From report at bugs.python.org  Mon Apr  2 22:50:04 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 03 Apr 2018 02:50:04 +0000
Subject: [docs] [issue33202] os.walk mentions os.listdir instead of
 os.scandir
In-Reply-To: <1522610510.25.0.467229070634.issue33202@psf.upfronthosting.co.za>
Message-ID: <1522723804.58.0.714561066657.issue33202@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +6070

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33202>
_______________________________________

From report at bugs.python.org  Mon Apr  2 22:51:02 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 03 Apr 2018 02:51:02 +0000
Subject: [docs] [issue33202] os.walk mentions os.listdir instead of
 os.scandir
In-Reply-To: <1522610510.25.0.467229070634.issue33202@psf.upfronthosting.co.za>
Message-ID: <1522723862.32.0.714561066657.issue33202@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +6071

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33202>
_______________________________________

From report at bugs.python.org  Mon Apr  2 23:33:40 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 03 Apr 2018 03:33:40 +0000
Subject: [docs] [issue33202] os.walk mentions os.listdir instead of
 os.scandir
In-Reply-To: <1522610510.25.0.467229070634.issue33202@psf.upfronthosting.co.za>
Message-ID: <1522726420.56.0.467229070634.issue33202@psf.upfronthosting.co.za>


miss-islington <mariatta.wijaya+miss-islington at gmail.com> added the comment:


New changeset f6d1d65803f290dfe14048f17d8125f8093a61ec by Miss Islington (bot) in branch '3.7':
closes bpo-33202: fix os.walk mentioning os.listdir instead of os.scandir (GH-6335)
https://github.com/python/cpython/commit/f6d1d65803f290dfe14048f17d8125f8093a61ec


----------
nosy: +miss-islington

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33202>
_______________________________________

From report at bugs.python.org  Mon Apr  2 23:39:17 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 03 Apr 2018 03:39:17 +0000
Subject: [docs] [issue33202] os.walk mentions os.listdir instead of
 os.scandir
In-Reply-To: <1522610510.25.0.467229070634.issue33202@psf.upfronthosting.co.za>
Message-ID: <1522726757.28.0.467229070634.issue33202@psf.upfronthosting.co.za>


miss-islington <mariatta.wijaya+miss-islington at gmail.com> added the comment:


New changeset fa5157e0499f7afdb59e220e3f4fdbf44adb5ac8 by Miss Islington (bot) in branch '3.6':
closes bpo-33202: fix os.walk mentioning os.listdir instead of os.scandir (GH-6335)
https://github.com/python/cpython/commit/fa5157e0499f7afdb59e220e3f4fdbf44adb5ac8


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33202>
_______________________________________

From report at bugs.python.org  Tue Apr  3 04:23:52 2018
From: report at bugs.python.org (INADA Naoki)
Date: Tue, 03 Apr 2018 08:23:52 +0000
Subject: [docs] [issue33195] PyArg_Parse* should deprecate 'u' and 'z'
 family.
In-Reply-To: <1522560373.89.0.467229070634.issue33195@psf.upfronthosting.co.za>
Message-ID: <1522743832.51.0.467229070634.issue33195@psf.upfronthosting.co.za>


INADA Naoki <songofacandy at gmail.com> added the comment:

OK, I replaced Py_UNICODE with wchar_t in Py_BuildValue document.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33195>
_______________________________________

From report at bugs.python.org  Tue Apr  3 11:34:06 2018
From: report at bugs.python.org (Steven Downum)
Date: Tue, 03 Apr 2018 15:34:06 +0000
Subject: [docs] [issue31201] make test: module test that failed doesn't exist
In-Reply-To: <1502707428.17.0.905101363291.issue31201@psf.upfronthosting.co.za>
Message-ID: <1522769646.74.0.714561066657.issue31201@psf.upfronthosting.co.za>


Change by Steven Downum <devilaether at gmail.com>:


----------
nosy: +steven.downum

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue31201>
_______________________________________

From report at bugs.python.org  Tue Apr  3 12:11:15 2018
From: report at bugs.python.org (Marius Gedminas)
Date: Tue, 03 Apr 2018 16:11:15 +0000
Subject: [docs] [issue33215] PyPI API wiki pages could link to Warehous docs
 please
Message-ID: <1522771875.25.0.467229070634.issue33215@psf.upfronthosting.co.za>


New submission from Marius Gedminas <marius at gedmin.as>:

Now that Warehouse is preparing to replace the old PyPI codebase I think it would be a good idea if the old PyPI API documentation pages on the Python wiki would link to the new Warehouse API documentation.

Specifically,

- https://wiki.python.org/moin/PyPISimple ought to link to https://warehouse.readthedocs.io/api-reference/legacy/

- https://wiki.python.org/moin/PyPIJSON ought to link to https://warehouse.readthedocs.io/api-reference/json/

- https://wiki.python.org/moin/PyPIXmlRpc ought to link to https://warehouse.readthedocs.io/api-reference/xml-rpc/

The wiki pages are immutable so I cannot do this myself.

(I'm not sure if this is the right bug tracker.  Apologies if I got it wrong!)

----------
assignee: docs at python
components: Documentation
messages: 314886
nosy: docs at python, mgedmin
priority: normal
severity: normal
status: open
title: PyPI API wiki pages could link to Warehous docs please
type: enhancement

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33215>
_______________________________________

From report at bugs.python.org  Tue Apr  3 12:28:49 2018
From: report at bugs.python.org (Sumana Harihareswara)
Date: Tue, 03 Apr 2018 16:28:49 +0000
Subject: [docs] [issue33215] PyPI API wiki pages could link to Warehous docs
 please
In-Reply-To: <1522771875.25.0.467229070634.issue33215@psf.upfronthosting.co.za>
Message-ID: <1522772929.79.0.714561066657.issue33215@psf.upfronthosting.co.za>


Change by Sumana Harihareswara <sh at changeset.nyc>:


----------
nosy: +sumanah

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33215>
_______________________________________

From report at bugs.python.org  Tue Apr  3 15:42:23 2018
From: report at bugs.python.org (Manuel Vazquez Acosta)
Date: Tue, 03 Apr 2018 19:42:23 +0000
Subject: [docs] [issue33216] Wrong order of stack for CALL_FUNCTION_VAR and
 CALL_FUNCTION_VAR_KW
Message-ID: <1522784543.83.0.467229070634.issue33216@psf.upfronthosting.co.za>


New submission from Manuel Vazquez Acosta <manuel at merchise.org>:

The documentation of the dis module says that:

  CALL_FUNCTION_VAR (argc)

   Calls a function. *argc* is interpreted as in CALL_FUNCTION. The
   top elements on the stack are the keyword arguments, followed by the
   variable argument list, and then the positional arguments.

However, inspecting the how ``f(b=1, *args)`` is actually compiled shows a different order:

   >>> import dis
   >>> dis.dis(compile('f(b=1, *args)', '<>', 'eval'))

  1           0 LOAD_NAME                0 (f)
              3 LOAD_NAME                1 (args)
              6 LOAD_CONST               0 ('b')
              9 LOAD_CONST               1 (1)
             12 CALL_FUNCTION_VAR      256 (0 positional, 1 keyword pair)
             15 RETURN_VALUE

Notice that the top of the stack contains the explicit keyword arguments.

The documentation of CALL_FUNCTION_VAR_KW is also incorrect.

----------
assignee:  -> docs at python
components: +Documentation
nosy: +docs at python
title: CALL_FUNCTION_VAR -> Wrong order of stack for CALL_FUNCTION_VAR and CALL_FUNCTION_VAR_KW
versions: +Python 3.5

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33216>
_______________________________________

From report at bugs.python.org  Tue Apr  3 15:49:47 2018
From: report at bugs.python.org (Manuel Vazquez Acosta)
Date: Tue, 03 Apr 2018 19:49:47 +0000
Subject: [docs] [issue33216] Wrong order of stack for CALL_FUNCTION_VAR and
 CALL_FUNCTION_VAR_KW
In-Reply-To: <1522784543.83.0.467229070634.issue33216@psf.upfronthosting.co.za>
Message-ID: <1522784987.83.0.714561066657.issue33216@psf.upfronthosting.co.za>


Change by Manuel Vazquez Acosta <manuel at merchise.org>:


----------
keywords: +patch
pull_requests: +6075
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33216>
_______________________________________

From report at bugs.python.org  Tue Apr  3 16:18:34 2018
From: report at bugs.python.org (Manuel Vazquez Acosta)
Date: Tue, 03 Apr 2018 20:18:34 +0000
Subject: [docs] [issue33216] Wrong order of stack for CALL_FUNCTION_VAR and
 CALL_FUNCTION_VAR_KW
In-Reply-To: <1522784543.83.0.467229070634.issue33216@psf.upfronthosting.co.za>
Message-ID: <1522786714.95.0.467229070634.issue33216@psf.upfronthosting.co.za>


Manuel Vazquez Acosta <manuel at merchise.org> added the comment:

Correction, the documentation for CALL_FUNCTION_VAR said:

Calls a function. *argc* is interpreted as in :opcode:`CALL_FUNCTION`. The top element on the stack contains the variable argument list, followed by keyword and positional arguments.


In a previous comment I pasted the version I'm putting in the PR.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33216>
_______________________________________

From report at bugs.python.org  Tue Apr  3 16:26:04 2018
From: report at bugs.python.org (arjun v)
Date: Tue, 03 Apr 2018 20:26:04 +0000
Subject: [docs] [issue33218] Fix instances in documentation where
 dictionaries are referenced as unordered
Message-ID: <1522787164.53.0.467229070634.issue33218@psf.upfronthosting.co.za>


New submission from arjun v <arjunvkp at gmail.com>:

In python 3.6 (and above hopefully), dictionary keys are going to be ordered, while their documentation still reference them as being unordered.

https://docs.python.org/3/tutorial/datastructures.html#dictionaries 

1: `It is best to think of a dictionary as an unordered set of key: value pairs,...`

2: `Performing list(d.keys()) on a dictionary returns a list of all the keys used in the dictionary, in arbitrary order..`

The examples should also be changed to reflect the same:
```
>>> tel = {'jack': 4098, 'sape': 4139}
>>> tel['guido'] = 4127
>>> tel
{'sape': 4139, 'guido': 4127, 'jack': 4098}
>>> tel['jack']
4098
>>> del tel['sape']
>>> tel['irv'] = 4127
>>> tel
{'guido': 4127, 'irv': 4127, 'jack': 4098}
>>> list(tel.keys())
['irv', 'guido', 'jack']
>>> sorted(tel.keys())
['guido', 'irv', 'jack']
>>> 'guido' in tel
True
>>> 'jack' not in tel
False
```

```
>>> dict([('sape', 4139), ('guido', 4127), ('jack', 4098)])
{'sape': 4139, 'guido': 4127, 'jack': 4098}
```

```
>>> dict(sape=4139, guido=4127, jack=4098)
{'sape': 4139, 'guido': 4127, 'jack': 4098}
```

----------
assignee: docs at python
components: Documentation
messages: 314892
nosy: arjunv, docs at python
priority: normal
severity: normal
status: open
title: Fix instances in documentation where dictionaries are referenced as unordered
versions: Python 3.6, Python 3.7, Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33218>
_______________________________________

From report at bugs.python.org  Tue Apr  3 17:06:24 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 03 Apr 2018 21:06:24 +0000
Subject: [docs] [issue33216] Wrong order of stack for CALL_FUNCTION_VAR and
 CALL_FUNCTION_VAR_KW
In-Reply-To: <1522784543.83.0.467229070634.issue33216@psf.upfronthosting.co.za>
Message-ID: <1522789584.63.0.714561066657.issue33216@psf.upfronthosting.co.za>


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


----------
nosy: +larry, ned.deily

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33216>
_______________________________________

From report at bugs.python.org  Tue Apr  3 17:49:11 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Tue, 03 Apr 2018 21:49:11 +0000
Subject: [docs] [issue15088] PyGen_NeedsFinalizing is public,
 but undocumented
In-Reply-To: <1339906861.99.0.42415214654.issue15088@psf.upfronthosting.co.za>
Message-ID: <1522792151.72.0.467229070634.issue15088@psf.upfronthosting.co.za>


Cheryl Sabella <chekat2 at gmail.com> added the comment:

Thanks again, Antoine.  I'll see what I can come up with.  :-)

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue15088>
_______________________________________

From report at bugs.python.org  Wed Apr  4 00:22:51 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Wed, 04 Apr 2018 04:22:51 +0000
Subject: [docs] [issue33218] Fix instances in documentation where
 dictionaries are referenced as unordered
In-Reply-To: <1522787164.53.0.467229070634.issue33218@psf.upfronthosting.co.za>
Message-ID: <1522815771.48.0.467229070634.issue33218@psf.upfronthosting.co.za>


Raymond Hettinger <raymond.hettinger at gmail.com> added the comment:

Would you like to make a pull request or do you prefer for me to assign it to someone else?

----------
nosy: +rhettinger
versions:  -Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33218>
_______________________________________

From report at bugs.python.org  Wed Apr  4 00:24:27 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Wed, 04 Apr 2018 04:24:27 +0000
Subject: [docs] [issue33218] Fix instances in documentation where
 dictionaries are referenced as unordered
In-Reply-To: <1522787164.53.0.467229070634.issue33218@psf.upfronthosting.co.za>
Message-ID: <1522815867.85.0.467229070634.issue33218@psf.upfronthosting.co.za>


Raymond Hettinger <raymond.hettinger at gmail.com> added the comment:

Also check the 3.7 docs to see if this work has already been done.

It's unlikely that the 3.6 docs will change because it is considered a non-guaranteed implementation detail for 3.6.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33218>
_______________________________________

From report at bugs.python.org  Wed Apr  4 00:24:58 2018
From: report at bugs.python.org (INADA Naoki)
Date: Wed, 04 Apr 2018 04:24:58 +0000
Subject: [docs] [issue33218] Fix instances in documentation where
 dictionaries are referenced as unordered
In-Reply-To: <1522787164.53.0.467229070634.issue33218@psf.upfronthosting.co.za>
Message-ID: <1522815898.61.0.714561066657.issue33218@psf.upfronthosting.co.za>


Change by INADA Naoki <songofacandy at gmail.com>:


----------
resolution:  -> duplicate
stage:  -> resolved
status: open -> closed
superseder:  -> Dict order is now guaranteed, so add tests and doc for it

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33218>
_______________________________________

From report at bugs.python.org  Wed Apr  4 00:59:10 2018
From: report at bugs.python.org (INADA Naoki)
Date: Wed, 04 Apr 2018 04:59:10 +0000
Subject: [docs] [issue33195] PyArg_Parse* should deprecate 'u' and 'z'
 family.
In-Reply-To: <1522560373.89.0.467229070634.issue33195@psf.upfronthosting.co.za>
Message-ID: <1522817950.79.0.467229070634.issue33195@psf.upfronthosting.co.za>


INADA Naoki <songofacandy at gmail.com> added the comment:


New changeset 42ec190761a2e8503aaa06f0bfaaabe98749179b by INADA Naoki in branch 'master':
bpo-33195: Doc: Deprecate Py_UNICODE in c-api/arg (GH-6329)
https://github.com/python/cpython/commit/42ec190761a2e8503aaa06f0bfaaabe98749179b


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33195>
_______________________________________

From report at bugs.python.org  Wed Apr  4 01:00:19 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 04 Apr 2018 05:00:19 +0000
Subject: [docs] [issue33195] PyArg_Parse* should deprecate 'u' and 'z'
 family.
In-Reply-To: <1522560373.89.0.467229070634.issue33195@psf.upfronthosting.co.za>
Message-ID: <1522818019.65.0.714561066657.issue33195@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +6080

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33195>
_______________________________________

From report at bugs.python.org  Wed Apr  4 01:09:21 2018
From: report at bugs.python.org (Ned Deily)
Date: Wed, 04 Apr 2018 05:09:21 +0000
Subject: [docs] [issue33216] Wrong order of stack for CALL_FUNCTION_VAR and
 CALL_FUNCTION_VAR_KW
In-Reply-To: <1522784543.83.0.467229070634.issue33216@psf.upfronthosting.co.za>
Message-ID: <1522818561.16.0.714561066657.issue33216@psf.upfronthosting.co.za>


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


----------
assignee: docs at python -> larry
nosy:  -ned.deily

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33216>
_______________________________________

From report at bugs.python.org  Wed Apr  4 01:13:40 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 04 Apr 2018 05:13:40 +0000
Subject: [docs] [issue33195] PyArg_Parse* should deprecate 'u' and 'z'
 family.
In-Reply-To: <1522560373.89.0.467229070634.issue33195@psf.upfronthosting.co.za>
Message-ID: <1522818820.37.0.467229070634.issue33195@psf.upfronthosting.co.za>


miss-islington <mariatta.wijaya+miss-islington at gmail.com> added the comment:


New changeset b8fc2d658094941250116a48577f54d1f6300362 by Miss Islington (bot) in branch '3.7':
bpo-33195: Doc: Deprecate Py_UNICODE in c-api/arg (GH-6329)
https://github.com/python/cpython/commit/b8fc2d658094941250116a48577f54d1f6300362


----------
nosy: +miss-islington

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33195>
_______________________________________

From report at bugs.python.org  Wed Apr  4 01:15:59 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 04 Apr 2018 05:15:59 +0000
Subject: [docs] [issue33216] Wrong order of stack for CALL_FUNCTION_VAR and
 CALL_FUNCTION_VAR_KW
In-Reply-To: <1522784543.83.0.467229070634.issue33216@psf.upfronthosting.co.za>
Message-ID: <1522818959.69.0.467229070634.issue33216@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:

I confirm that this issue is 3.5-only. Before 3.5 the order matched the documentation. After 3.5 these opcodes were completely rewritten and they use now other way of passing arguments.

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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33216>
_______________________________________

From report at bugs.python.org  Wed Apr  4 01:26:02 2018
From: report at bugs.python.org (Ned Deily)
Date: Wed, 04 Apr 2018 05:26:02 +0000
Subject: [docs] [issue33215] PyPI API wiki pages could link to Warehous docs
 please
In-Reply-To: <1522771875.25.0.467229070634.issue33215@psf.upfronthosting.co.za>
Message-ID: <1522819562.26.0.467229070634.issue33215@psf.upfronthosting.co.za>


Ned Deily <nad at python.org> added the comment:

You should probably bring this up on the packaging mailing list:

https://mail.python.org/mailman/listinfo/distutils-sig

or on the Warehouse issue tracker:

https://github.com/pypa/warehouse/issues

----------
nosy: +ned.deily
resolution:  -> third party
stage:  -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33215>
_______________________________________

From report at bugs.python.org  Wed Apr  4 01:34:06 2018
From: report at bugs.python.org (Sumana Harihareswara)
Date: Wed, 04 Apr 2018 05:34:06 +0000
Subject: [docs] [issue33215] PyPI API wiki pages should be mutable
In-Reply-To: <1522771875.25.0.467229070634.issue33215@psf.upfronthosting.co.za>
Message-ID: <1522820046.09.0.467229070634.issue33215@psf.upfronthosting.co.za>


Sumana Harihareswara <sh at changeset.nyc> added the comment:

The problem mgedmin is experiencing is that these particular wiki.python.org pages are immutable, which is not a problem Warehouse maintainers (like me) can solve, and I believe it's also not a problem people on distutils-sig can solve. Perhaps this is an infrastructure question that should go into https://github.com/python/psf-infra-meta/issues ?

----------
title: PyPI API wiki pages could link to Warehous docs please -> PyPI API wiki pages should be mutable

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33215>
_______________________________________

From report at bugs.python.org  Wed Apr  4 01:37:00 2018
From: report at bugs.python.org (Ned Deily)
Date: Wed, 04 Apr 2018 05:37:00 +0000
Subject: [docs] [issue33215] PyPI API wiki pages should be mutable
In-Reply-To: <1522771875.25.0.467229070634.issue33215@psf.upfronthosting.co.za>
Message-ID: <1522820220.07.0.467229070634.issue33215@psf.upfronthosting.co.za>


Ned Deily <nad at python.org> added the comment:

wiki.python.org pages aren't immutable.  Anyone can ask for Wiki editing permission.  See https://wiki.python.org/moin/:

If you want to edit a page and have just signed up, or you find that you can no longer edit a page that you could edit before, please write to the pydotorg-www mailing list, stating your account name and your intended edits and we'll add you to the EditorsGroup.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33215>
_______________________________________

From report at bugs.python.org  Wed Apr  4 04:42:48 2018
From: report at bugs.python.org (INADA Naoki)
Date: Wed, 04 Apr 2018 08:42:48 +0000
Subject: [docs] [issue33195] PyArg_Parse* should deprecate 'u' and 'z'
 family.
In-Reply-To: <1522560373.89.0.467229070634.issue33195@psf.upfronthosting.co.za>
Message-ID: <1522831368.43.0.714561066657.issue33195@psf.upfronthosting.co.za>


Change by INADA Naoki <songofacandy at gmail.com>:


----------
resolution:  -> fixed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33195>
_______________________________________

From report at bugs.python.org  Wed Apr  4 04:43:07 2018
From: report at bugs.python.org (INADA Naoki)
Date: Wed, 04 Apr 2018 08:43:07 +0000
Subject: [docs] [issue33195] PyArg_Parse* should deprecate 'u' and 'z'
 family.
In-Reply-To: <1522560373.89.0.467229070634.issue33195@psf.upfronthosting.co.za>
Message-ID: <1522831387.23.0.714561066657.issue33195@psf.upfronthosting.co.za>


Change by INADA Naoki <songofacandy at gmail.com>:


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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33195>
_______________________________________

From heggenator at gmail.com  Tue Apr  3 23:28:58 2018
From: heggenator at gmail.com (That one Star Wars Nerd)
Date: Wed, 04 Apr 2018 03:28:58 +0000
Subject: [docs] iPad support
Message-ID: <CAEJt_T21QkX1XxVKThLY0TF+q=1tYDsxJBFkO5oCC=4nY3yj1w@mail.gmail.com>

Please make python work with iPad or chromeOS thanks
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180404/c066a77a/attachment-0001.html>

From sebastien.bechet at osinix.com  Mon Apr  2 09:56:36 2018
From: sebastien.bechet at osinix.com (Sebastien Bechet)
Date: Mon, 02 Apr 2018 15:56:36 +0200
Subject: [docs] french update failed
Message-ID: <c4250ba54fe5ed515e2f6eaebc33d60fc1c24607.camel@osinix.com>

Hello,

I tried to download french epub from different version (3.6.5 to 3.8)
but all failed (https://docs.python.org/fr/3.6/download.html)

html page say last updated was done avr. 02, 2018 so i thing we have a
problem in generation somewhere.

Thank you.



From report at bugs.python.org  Wed Apr  4 13:52:44 2018
From: report at bugs.python.org (=?utf-8?q?Ville_Skytt=C3=A4?=)
Date: Wed, 04 Apr 2018 17:52:44 +0000
Subject: [docs] [issue28393] Update encoding lookup docs wrt #27938
In-Reply-To: <1476013149.31.0.17921258936.issue28393@psf.upfronthosting.co.za>
Message-ID: <1522864364.8.0.262363346258.issue28393@psf.upfronthosting.co.za>


Change by Ville Skytt? <ville.skytta at iki.fi>:


----------
pull_requests: +6085

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue28393>
_______________________________________

From report at bugs.python.org  Thu Apr  5 03:49:41 2018
From: report at bugs.python.org (INADA Naoki)
Date: Thu, 05 Apr 2018 07:49:41 +0000
Subject: [docs] [issue33195] PyArg_Parse* should deprecate 'u' and 'z'
 family.
In-Reply-To: <1522560373.89.0.467229070634.issue33195@psf.upfronthosting.co.za>
Message-ID: <1522914581.36.0.262363346258.issue33195@psf.upfronthosting.co.za>


Change by INADA Naoki <songofacandy at gmail.com>:


----------
pull_requests: +6092

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33195>
_______________________________________

From report at bugs.python.org  Thu Apr  5 05:08:38 2018
From: report at bugs.python.org (Mikhail Zakharov)
Date: Thu, 05 Apr 2018 09:08:38 +0000
Subject: [docs] =?utf-8?q?=5Bissue33229=5D_Documentation_-__io_=E2=80=94_?=
 =?utf-8?q?Core_tools_for_working_with_streams_-_seek=28=29?=
Message-ID: <1522919317.94.0.682650639539.issue33229@psf.upfronthosting.co.za>


New submission from Mikhail Zakharov <zmey20000 at yahoo.com>:

Documentation for io.IOBase class and it's seek() method at https://docs.python.org/3/library/io.html mentions SEEK_* constants like:

"    SEEK_SET or 0 ? start of the stream (the default); offset should be zero or positive
    SEEK_CUR or 1 ? current stream position; offset may be negative
    SEEK_END or 2 ? end of the stream; offset is usually negative
"

It seems, they actually should be used as os.SEEK_SET, os.SEEK_CUR and os.SEEK_END.

----------
assignee: docs at python
components: Documentation
messages: 314970
nosy: Mikhail Zakharov, docs at python
priority: normal
severity: normal
status: open
title: Documentation -  io ? Core tools for working with streams - seek()
type: enhancement
versions: Python 2.7, Python 3.4, Python 3.5, Python 3.6, Python 3.7, Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33229>
_______________________________________

From report at bugs.python.org  Thu Apr  5 05:08:51 2018
From: report at bugs.python.org (INADA Naoki)
Date: Thu, 05 Apr 2018 09:08:51 +0000
Subject: [docs] [issue33195] PyArg_Parse* should deprecate 'u' and 'z'
 family.
In-Reply-To: <1522560373.89.0.467229070634.issue33195@psf.upfronthosting.co.za>
Message-ID: <1522919331.3.0.682650639539.issue33195@psf.upfronthosting.co.za>


INADA Naoki <songofacandy at gmail.com> added the comment:


New changeset 29bc6f6347b1e05b22180fd296013bb2a104d589 by INADA Naoki in branch '3.6':
bpo-33195: Doc: Deprecate Py_UNICODE in c-api/arg (GH-6329)
https://github.com/python/cpython/commit/29bc6f6347b1e05b22180fd296013bb2a104d589


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33195>
_______________________________________

From report at bugs.python.org  Thu Apr  5 09:41:07 2018
From: report at bugs.python.org (Josh Rosenberg)
Date: Thu, 05 Apr 2018 13:41:07 +0000
Subject: [docs] =?utf-8?q?=5Bissue33229=5D_Documentation_-__io_=E2=80=94_?=
 =?utf-8?q?Core_tools_for_working_with_streams_-_seek=28=29?=
In-Reply-To: <1522919317.94.0.682650639539.issue33229@psf.upfronthosting.co.za>
Message-ID: <1522935666.96.0.682650639539.issue33229@psf.upfronthosting.co.za>


Josh Rosenberg <shadowranger+python at gmail.com> added the comment:

As indicated in the seek docs ( https://docs.python.org/3/library/io.html#io.IOBase.seek ), all three names were added to the io module in 3.1:

> New in version 3.1: The SEEK_* constants.

Since they're part of the io module too, there is no need to qualify them on the io module docs page.

They're available in os as well, but you don't need to import it to use them. The OS specific addition position flags are explicitly documented to be found on the os module.

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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33229>
_______________________________________

From report at bugs.python.org  Thu Apr  5 10:01:46 2018
From: report at bugs.python.org (Mikhail Zakharov)
Date: Thu, 05 Apr 2018 14:01:46 +0000
Subject: [docs] =?utf-8?q?=5Bissue33229=5D_Documentation_-__io_=E2=80=94_?=
 =?utf-8?q?Core_tools_for_working_with_streams_-_seek=28=29?=
In-Reply-To: <1522919317.94.0.682650639539.issue33229@psf.upfronthosting.co.za>
Message-ID: <1522936906.77.0.682650639539.issue33229@psf.upfronthosting.co.za>


Mikhail Zakharov <zmey20000 at yahoo.com> added the comment:

Seems in my, quite old 3.4.5 version, it doesn't work:

$ python3
Python 3.4.5 (default, Jun  1 2017, 13:52:39) 
[GCC 4.4.7 20120313 (Red Hat 4.4.7-18)] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> f = open('/tmp/text.txt', 'r')
>>> f.seek(0, SEEK_END)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
NameError: name 'SEEK_END' is not defined
>>> f.close()
>>> 
>>> import os
>>> f = open('/tmp/text.txt', 'r')
>>> f.seek(0, os.SEEK_END)
214
>>> f.close()

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33229>
_______________________________________

From report at bugs.python.org  Thu Apr  5 10:11:54 2018
From: report at bugs.python.org (Mikhail Zakharov)
Date: Thu, 05 Apr 2018 14:11:54 +0000
Subject: [docs] =?utf-8?q?=5Bissue33229=5D_Documentation_-__io_=E2=80=94_?=
 =?utf-8?q?Core_tools_for_working_with_streams_-_seek=28=29?=
In-Reply-To: <1522919317.94.0.682650639539.issue33229@psf.upfronthosting.co.za>
Message-ID: <1522937514.08.0.682650639539.issue33229@psf.upfronthosting.co.za>


Mikhail Zakharov <zmey20000 at yahoo.com> added the comment:

OK, I got it. Sorry for disturbing you.

The should be called like: io.SEEK_*

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33229>
_______________________________________

From report at bugs.python.org  Thu Apr  5 14:51:29 2018
From: report at bugs.python.org (Ned Deily)
Date: Thu, 05 Apr 2018 18:51:29 +0000
Subject: [docs] [issue33233] Suggest third-party cmd2 module as alternative
 to cmd
Message-ID: <1522954289.49.0.682650639539.issue33233@psf.upfronthosting.co.za>


New submission from Ned Deily <nad at python.org>:

The cmd module in the standard library has languished for many years.  In the mean time, third-party replacements for it have arisen.  Perhaps the most popular is cmd2 which seems to be actively maintained, provides upward compatibility from cmd along with many desirable new features, and is permissively licensed.

I suggest we consider at a minimum adding a "See also:" note referencing cmd2 to the cmd documentation in the Standard Library document, similar to what we do for the third-party "requests" module in the "urllib.request" documentation.

We could be even bolder and officially deprecate "cmd" and consider closing open enhancement issues for it on b.p.o.




https://pypi.org/project/cmd2/
https://cmd2.readthedocs.io/

----------
assignee: docs at python
components: Documentation
messages: 315002
nosy: Catherine.Devlin, docs at python, lukasz.langa, ned.deily
priority: normal
severity: normal
status: open
title: Suggest third-party cmd2 module as alternative to cmd
versions: Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33233>
_______________________________________

From report at bugs.python.org  Fri Apr  6 06:13:47 2018
From: report at bugs.python.org (Paddy McCarthy)
Date: Fri, 06 Apr 2018 10:13:47 +0000
Subject: [docs] [issue33235] Better help text for dict.setdefault
Message-ID: <1523009627.66.0.682650639539.issue33235@psf.upfronthosting.co.za>


New submission from Paddy McCarthy <paddy3118 at gmail.com>:

Hi, I was answering some question and used dict.setdefault as part of the solution and posted the help() on it as part of my answer.

The help was this:

In [15]: help(mapper.setdefault)
Help on built-in function setdefault:

setdefault(...) method of builtins.dict instance
    D.setdefault(k[,d]) -> D.get(k,d), also set D[k]=d if k not in D

This seems the wrong way around. Is it not better expressed as

    D.setdefault(k[,d]) -> set D[k]=d if k not in D and then D.get(k,d)

----------
assignee: docs at python
components: Documentation
messages: 315015
nosy: Paddy McCarthy, docs at python
priority: normal
severity: normal
status: open
title: Better help text for dict.setdefault
type: enhancement
versions: Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33235>
_______________________________________

From report at bugs.python.org  Fri Apr  6 10:30:40 2018
From: report at bugs.python.org (Nick Coghlan)
Date: Fri, 06 Apr 2018 14:30:40 +0000
Subject: [docs] [issue33210] pkgutil.walk_packages "prefix" option docs are
 misleading
In-Reply-To: <1522722338.23.0.467229070634.issue33210@psf.upfronthosting.co.za>
Message-ID: <1523025040.56.0.682650639539.issue33210@psf.upfronthosting.co.za>


Nick Coghlan <ncoghlan at gmail.com> added the comment:

https://bugs.python.org/issue29258 is an existing issue for the PEP 420 limitation (it also notes why fixing that implicitly is a potential problem)

I've retitled this issue to be specifically about the misleading docs for the "prefix" option (and updated the metadata accordingly).

"Recursive descent in pkgutil.walk_packages depends on sys.path" would be a reasonable title for an issue to actually fix the operation to use a better algorithm based on newer importlib APIs, but I haven't filed that myself.

----------
assignee:  -> docs at python
components: +Documentation -Library (Lib)
nosy: +docs at python
title: pkgutil.walk_packages gives incomplete results -> pkgutil.walk_packages "prefix" option docs are misleading
versions: +Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33210>
_______________________________________

From report at bugs.python.org  Fri Apr  6 12:31:54 2018
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 06 Apr 2018 16:31:54 +0000
Subject: [docs] [issue33235] Better help text for dict.setdefault
In-Reply-To: <1523009627.66.0.682650639539.issue33235@psf.upfronthosting.co.za>
Message-ID: <1523032314.25.0.682650639539.issue33235@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

The two lines are equivalent!

`d.setdefault(key, default)` does return the same thing as `d.get(key, default)`, and then sets `d[key] = default` if the get method went into the ?key was not found, let?s return default? branch.

----------
nosy: +eric.araujo

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33235>
_______________________________________

From report at bugs.python.org  Fri Apr  6 12:33:18 2018
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 06 Apr 2018 16:33:18 +0000
Subject: [docs] [issue33235] Better help text for dict.setdefault
In-Reply-To: <1523009627.66.0.682650639539.issue33235@psf.upfronthosting.co.za>
Message-ID: <1523032398.05.0.682650639539.issue33235@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

Note that if we switch the order like you propose, we don?t need to use dict.get:


  set D[k]=d if k not in D then return D[k]


I suspect the current doc was written the way it is because it matches the actual implementation.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33235>
_______________________________________

From report at bugs.python.org  Fri Apr  6 12:43:41 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 06 Apr 2018 16:43:41 +0000
Subject: [docs] [issue33235] Better help text for dict.setdefault
In-Reply-To: <1523009627.66.0.682650639539.issue33235@psf.upfronthosting.co.za>
Message-ID: <1523033021.85.0.682650639539.issue33235@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:

Changing docstring can break existing code, therefore it should go only in future new Python version unless it contains a bug. The current docstring in 3.6 doesn't look incorrect to me. The docstring in 3.7 is different.

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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33235>
_______________________________________

From report at bugs.python.org  Fri Apr  6 17:29:36 2018
From: report at bugs.python.org (Ned Deily)
Date: Fri, 06 Apr 2018 21:29:36 +0000
Subject: [docs] [issue33187] Document ElementInclude (XInclude) support in
 ElementTree
In-Reply-To: <1522427694.7.0.467229070634.issue33187@psf.upfronthosting.co.za>
Message-ID: <1523050176.6.0.262363346258.issue33187@psf.upfronthosting.co.za>


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


----------
keywords: +easy
stage:  -> needs patch
versions: +Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33187>
_______________________________________

From report at bugs.python.org  Fri Apr  6 18:04:03 2018
From: report at bugs.python.org (Ned Deily)
Date: Fri, 06 Apr 2018 22:04:03 +0000
Subject: [docs] [issue33233] Suggest third-party cmd2 module as alternative
 to cmd
In-Reply-To: <1522954289.49.0.682650639539.issue33233@psf.upfronthosting.co.za>
Message-ID: <1523052243.65.0.682650639539.issue33233@psf.upfronthosting.co.za>


Ned Deily <nad at python.org> added the comment:

I've asked on python-dev for comments:

https://mail.python.org/pipermail/python-dev/2018-April/152653.html

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33233>
_______________________________________

From report at bugs.python.org  Fri Apr  6 18:51:43 2018
From: report at bugs.python.org (Barry A. Warsaw)
Date: Fri, 06 Apr 2018 22:51:43 +0000
Subject: [docs] [issue33233] Suggest third-party cmd2 module as alternative
 to cmd
In-Reply-To: <1522954289.49.0.682650639539.issue33233@psf.upfronthosting.co.za>
Message-ID: <1523055102.93.0.682650639539.issue33233@psf.upfronthosting.co.za>


Barry A. Warsaw <barry at python.org> added the comment:

@ned.deily - are you proposing to officially deprecate it for 3.7?  If we're going to do it, let's do it now so we can remove it for 3.9.  It seems like a reasonable strategy to push folks toward cmd2 and clean up our stdlib.

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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33233>
_______________________________________

From report at bugs.python.org  Fri Apr  6 18:56:39 2018
From: report at bugs.python.org (Ned Deily)
Date: Fri, 06 Apr 2018 22:56:39 +0000
Subject: [docs] [issue33233] Suggest third-party cmd2 module as alternative
 to cmd
In-Reply-To: <1522954289.49.0.682650639539.issue33233@psf.upfronthosting.co.za>
Message-ID: <1523055399.14.0.682650639539.issue33233@psf.upfronthosting.co.za>


Ned Deily <nad at python.org> added the comment:

@barry, I was thinking more of 3.8 but, sure, if there seems to be a consensus prior to 3.7.0b4 that deprecation is the right thing, we could do it in 3.7.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33233>
_______________________________________

From report at bugs.python.org  Fri Apr  6 20:30:59 2018
From: report at bugs.python.org (Steven D'Aprano)
Date: Sat, 07 Apr 2018 00:30:59 +0000
Subject: [docs] [issue33233] Suggest third-party cmd2 module as alternative
 to cmd
In-Reply-To: <1522954289.49.0.682650639539.issue33233@psf.upfronthosting.co.za>
Message-ID: <1523061059.07.0.682650639539.issue33233@psf.upfronthosting.co.za>


Steven D'Aprano <steve+python at pearwood.info> added the comment:

(Previously posted on Python-Dev.)

I think the documentation note is a good idea.

But I disagree with deprecating "cmd" unless it is actively falling
apart and no longer working, not just languishing with no feature
improvements. Just in the last week, I've been reminded twice that many
people using Python do so where they cannot just arbitrarily pip install
<whatever>, and if a library isn't in the std lib, they can't use it
without a lot of pain:

https://mail.python.org/pipermail/tutor/2018-April/112817.html

https://mail.python.org/pipermail/tutor/2018-April/112818.html

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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33233>
_______________________________________

From report at bugs.python.org  Fri Apr  6 21:26:10 2018
From: report at bugs.python.org (Guido van Rossum)
Date: Sat, 07 Apr 2018 01:26:10 +0000
Subject: [docs] [issue33233] Suggest third-party cmd2 module as alternative
 to cmd
In-Reply-To: <1522954289.49.0.682650639539.issue33233@psf.upfronthosting.co.za>
Message-ID: <1523064370.46.0.682650639539.issue33233@psf.upfronthosting.co.za>


Guido van Rossum <guido at python.org> added the comment:

But cmd is used by pdb. Do you recommend we deprecate that too? (There are countless 3rd party alternatives, but I sure prefer to have it in the stdlib, so I can start debugging without first having to install a dependency.)

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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33233>
_______________________________________

From report at bugs.python.org  Fri Apr  6 21:27:12 2018
From: report at bugs.python.org (Ned Deily)
Date: Sat, 07 Apr 2018 01:27:12 +0000
Subject: [docs] [issue8243] curses writing to window's bottom right position
 raises: `_curses.error: addstr() returned ERR'
In-Reply-To: <1352121880.55.0.191535515397.issue8243@psf.upfronthosting.co.za>
Message-ID: <1523064432.06.0.682650639539.issue8243@psf.upfronthosting.co.za>


Ned Deily <nad at python.org> added the comment:


New changeset ef5ce884a41c8553a7eff66ebace908c1dcc1f89 by Ned Deily (Jay Crotts) in branch 'master':
bpo-8243: Doc patch for curses.window.addstr and curses.window.addch (GH-5179)
https://github.com/python/cpython/commit/ef5ce884a41c8553a7eff66ebace908c1dcc1f89


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue8243>
_______________________________________

From report at bugs.python.org  Fri Apr  6 21:28:24 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 07 Apr 2018 01:28:24 +0000
Subject: [docs] [issue8243] curses writing to window's bottom right position
 raises: `_curses.error: addstr() returned ERR'
In-Reply-To: <1352121880.55.0.191535515397.issue8243@psf.upfronthosting.co.za>
Message-ID: <1523064504.49.0.262363346258.issue8243@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +6109

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue8243>
_______________________________________

From report at bugs.python.org  Fri Apr  6 21:29:19 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 07 Apr 2018 01:29:19 +0000
Subject: [docs] [issue8243] curses writing to window's bottom right position
 raises: `_curses.error: addstr() returned ERR'
In-Reply-To: <1352121880.55.0.191535515397.issue8243@psf.upfronthosting.co.za>
Message-ID: <1523064559.14.0.262363346258.issue8243@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +6110

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue8243>
_______________________________________

From report at bugs.python.org  Fri Apr  6 21:30:18 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 07 Apr 2018 01:30:18 +0000
Subject: [docs] [issue8243] curses writing to window's bottom right position
 raises: `_curses.error: addstr() returned ERR'
In-Reply-To: <1352121880.55.0.191535515397.issue8243@psf.upfronthosting.co.za>
Message-ID: <1523064618.59.0.262363346258.issue8243@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +6111

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue8243>
_______________________________________

From report at bugs.python.org  Fri Apr  6 21:35:14 2018
From: report at bugs.python.org (Ned Deily)
Date: Sat, 07 Apr 2018 01:35:14 +0000
Subject: [docs] [issue33233] Suggest third-party cmd2 module as alternative
 to cmd
In-Reply-To: <1522954289.49.0.682650639539.issue33233@psf.upfronthosting.co.za>
Message-ID: <1523064914.41.0.682650639539.issue33233@psf.upfronthosting.co.za>


Ned Deily <nad at python.org> added the comment:

> cmd is used by pdb

Well, that's a pretty good reason for not removing cmd!  I really wasn't advocating its removal, just gently pushing users to use cmd2.  So perhaps we should only add a "See Also" like we do for urllib.request and close any new feature request issues?

>  See also: The Requests package is recommended for a higher-level
>  HTTP client interface.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33233>
_______________________________________

From report at bugs.python.org  Fri Apr  6 21:38:30 2018
From: report at bugs.python.org (Guido van Rossum)
Date: Sat, 07 Apr 2018 01:38:30 +0000
Subject: [docs] [issue33233] Suggest third-party cmd2 module as alternative
 to cmd
In-Reply-To: <1523064914.41.0.682650639539.issue33233@psf.upfronthosting.co.za>
Message-ID: <CAP7+vJLCrDEohUTiJ0isE_xACQP5JPpT4x8TzF_RiYgCg3avbA@mail.gmail.com>


Guido van Rossum <guido at python.org> added the comment:

I'm fine with linking to cmd2, we do that for some other modules too.
(Though I think it's somewhat arbitrary. E.g. do we link to requests
anywhere? Or to all the "better pdb" modules?)

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33233>
_______________________________________

From report at bugs.python.org  Fri Apr  6 21:40:35 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Sat, 07 Apr 2018 01:40:35 +0000
Subject: [docs] [issue33233] Suggest third-party cmd2 module as alternative
 to cmd
In-Reply-To: <1522954289.49.0.682650639539.issue33233@psf.upfronthosting.co.za>
Message-ID: <1523065234.96.0.682650639539.issue33233@psf.upfronthosting.co.za>


Raymond Hettinger <raymond.hettinger at gmail.com> added the comment:

FWIW, I've been teaching cmd to my clients for years and it has worked fine for them.

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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33233>
_______________________________________

From report at bugs.python.org  Fri Apr  6 21:43:19 2018
From: report at bugs.python.org (Ned Deily)
Date: Sat, 07 Apr 2018 01:43:19 +0000
Subject: [docs] [issue33233] Suggest third-party cmd2 module as alternative
 to cmd
In-Reply-To: <1522954289.49.0.682650639539.issue33233@psf.upfronthosting.co.za>
Message-ID: <1523065399.69.0.682650639539.issue33233@psf.upfronthosting.co.za>


Ned Deily <nad at python.org> added the comment:

> (Though I think it's somewhat arbitrary.

Yes, it is.

> E.g. do we link to requests anywhere?

Yes:
https://docs.python.org/3/library/urllib.request.html

> Or to all the "better pdb" modules?)

Not that I'm aware of.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33233>
_______________________________________

From report at bugs.python.org  Fri Apr  6 21:56:20 2018
From: report at bugs.python.org (Ned Deily)
Date: Sat, 07 Apr 2018 01:56:20 +0000
Subject: [docs] [issue33233] Suggest third-party cmd2 module as alternative
 to cmd
In-Reply-To: <1522954289.49.0.682650639539.issue33233@psf.upfronthosting.co.za>
Message-ID: <1523066180.1.0.682650639539.issue33233@psf.upfronthosting.co.za>


Ned Deily <nad at python.org> added the comment:

> FWIW, I've been teaching cmd to my clients for years and it has worked fine for them.

I'm not saying that cmd is bad; it's just that there have been suggested improvements over the years and many of those are already implemented in cmd2, which is supposed to be generally upward compatible from cmd.  (I don't know how accurate that is in practice.)  The main reason for bringing this up is that it seems to me that, rather than trying to duplicate effort by re-implementing new features for cmd that are already in cmd2, we should point at cmd2 for new users who want those features.  So, as Guido pointed out, with a customer of cmd in the std library (e.g. pdb), we shouldn't remove it.  But we can still set expectations that there aren't going to be new features in cmd.  Does that sound reasonable to everyone?

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33233>
_______________________________________

From report at bugs.python.org  Fri Apr  6 22:00:09 2018
From: report at bugs.python.org (Ned Deily)
Date: Sat, 07 Apr 2018 02:00:09 +0000
Subject: [docs] [issue8243] curses writing to window's bottom right position
 raises: `_curses.error: addstr() returned ERR'
In-Reply-To: <1352121880.55.0.191535515397.issue8243@psf.upfronthosting.co.za>
Message-ID: <1523066409.23.0.682650639539.issue8243@psf.upfronthosting.co.za>


Ned Deily <nad at python.org> added the comment:


New changeset 98e8ac8d82202aae32961f10b1014641ae1fffbf by Ned Deily (Miss Islington (bot)) in branch '3.7':
[3.7] bpo-8243: Doc patch for curses.window.addstr and curses.window.addch (GH-5179) (GH-6404)
https://github.com/python/cpython/commit/98e8ac8d82202aae32961f10b1014641ae1fffbf


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue8243>
_______________________________________

From report at bugs.python.org  Fri Apr  6 22:01:05 2018
From: report at bugs.python.org (Ned Deily)
Date: Sat, 07 Apr 2018 02:01:05 +0000
Subject: [docs] [issue8243] curses writing to window's bottom right position
 raises: `_curses.error: addstr() returned ERR'
In-Reply-To: <1352121880.55.0.191535515397.issue8243@psf.upfronthosting.co.za>
Message-ID: <1523066465.62.0.682650639539.issue8243@psf.upfronthosting.co.za>


Ned Deily <nad at python.org> added the comment:


New changeset 70c44465475c41ab3aa832858b250ede6f170aac by Ned Deily (Miss Islington (bot)) in branch '3.6':
[3.6] bpo-8243: Doc patch for curses.window.addstr and curses.window.addch (GH-5179) (GH-6406)
https://github.com/python/cpython/commit/70c44465475c41ab3aa832858b250ede6f170aac


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue8243>
_______________________________________

From report at bugs.python.org  Fri Apr  6 22:01:37 2018
From: report at bugs.python.org (Ned Deily)
Date: Sat, 07 Apr 2018 02:01:37 +0000
Subject: [docs] [issue8243] curses writing to window's bottom right position
 raises: `_curses.error: addstr() returned ERR'
In-Reply-To: <1352121880.55.0.191535515397.issue8243@psf.upfronthosting.co.za>
Message-ID: <1523066497.68.0.682650639539.issue8243@psf.upfronthosting.co.za>


Ned Deily <nad at python.org> added the comment:


New changeset 77f0a41d72886513f5e9277e5587455745c29ac1 by Ned Deily (Miss Islington (bot)) in branch '2.7':
[2.7] bpo-8243: Doc patch for curses.window.addstr and curses.window.addch (GH-5179) (GH-6405)
https://github.com/python/cpython/commit/77f0a41d72886513f5e9277e5587455745c29ac1


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue8243>
_______________________________________

From report at bugs.python.org  Fri Apr  6 22:03:45 2018
From: report at bugs.python.org (Ned Deily)
Date: Sat, 07 Apr 2018 02:03:45 +0000
Subject: [docs] [issue8243] curses writing to window's bottom right position
 raises: `_curses.error: addstr() returned ERR'
In-Reply-To: <1352121880.55.0.191535515397.issue8243@psf.upfronthosting.co.za>
Message-ID: <1523066625.9.0.682650639539.issue8243@psf.upfronthosting.co.za>


Ned Deily <nad at python.org> added the comment:

Thank you for producing the PR, Jay!

----------
components:  -Extension Modules
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed
type: enhancement -> 
versions: +Python 2.7, Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue8243>
_______________________________________

From report at bugs.python.org  Fri Apr  6 22:17:58 2018
From: report at bugs.python.org (Guido van Rossum)
Date: Sat, 07 Apr 2018 02:17:58 +0000
Subject: [docs] [issue33233] Suggest third-party cmd2 module as alternative
 to cmd
In-Reply-To: <1522954289.49.0.682650639539.issue33233@psf.upfronthosting.co.za>
Message-ID: <1523067478.01.0.682650639539.issue33233@psf.upfronthosting.co.za>


Guido van Rossum <guido at python.org> added the comment:

Well, is cmd2 stabilizing, or is it still changing at a rate too fast for inclusion in the stdlib? Does it perhaps have a mix of desirable and wacky features? Or could we just copy much of it into the stdlib as 'cmd'?

I'm a bit concerned about the idea that we should not upgrade stdlib modules because a better 3rd party alternative exists -- and I'm kind of assuming that those 3rd party module authors are also somewhat disappointed that their modules are not used to improve the stdlib. (PyPI not withstanding.)

Often (like in this case) there's just no chance of getting rid of the stdlib module, so we're just stuck with a duplication of functionality.

Note that every case is a bit different. But I'm not ready to give up on the idea that Python comes with batteries included. We should not let those batteries corrode and leak.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33233>
_______________________________________

From report at bugs.python.org  Fri Apr  6 22:31:49 2018
From: report at bugs.python.org (Ned Deily)
Date: Sat, 07 Apr 2018 02:31:49 +0000
Subject: [docs] [issue33233] Suggest third-party cmd2 module as alternative
 to cmd
In-Reply-To: <1522954289.49.0.682650639539.issue33233@psf.upfronthosting.co.za>
Message-ID: <1523068309.8.0.682650639539.issue33233@psf.upfronthosting.co.za>


Ned Deily <nad at python.org> added the comment:

> But I'm not ready to give up on the idea that Python comes with batteries included. We should not let those batteries corrode and leak.

I totally agree with you.  And it would be great if cmd2 could be incorporated into the std lib as an updated cmd.  cmd seems to be largely abandoned in the std lib: looking at the commit history for it shows few changes in the past decade or so and I'm not aware that any current core developer feels ownership of it: I might be wrong.  But it certainly is true that cmd2 has seen much more activity recently than cmd has.  So I would think that the ideal solution would be for the cmd2 project to take ownership of cmd in the std library.  OTOH, it seems like we haven't always had good long-term results in the past when trying to bring existing third-party packages into the std lib.  But it could be worth trying again, if someone were willing to shepherd it.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33233>
_______________________________________

From report at bugs.python.org  Fri Apr  6 23:04:06 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Sat, 07 Apr 2018 03:04:06 +0000
Subject: [docs] [issue33233] Suggest third-party cmd2 module as alternative
 to cmd
In-Reply-To: <1522954289.49.0.682650639539.issue33233@psf.upfronthosting.co.za>
Message-ID: <1523070246.69.0.682650639539.issue33233@psf.upfronthosting.co.za>


Raymond Hettinger <raymond.hettinger at gmail.com> added the comment:

>  cmd seems to be largely abandoned in the std lib: 

I'm not sure why the absence of bugs indicates abandonment.  We almost never touch defaultdict, in part because the code is straight-forward, tested, and not buggy.  If a bug were reported for cmd, I would be happy to work on it.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33233>
_______________________________________

From report at bugs.python.org  Fri Apr  6 23:58:32 2018
From: report at bugs.python.org (Catherine Devlin)
Date: Sat, 07 Apr 2018 03:58:32 +0000
Subject: [docs] [issue33233] Suggest third-party cmd2 module as alternative
 to cmd
In-Reply-To: <1522954289.49.0.682650639539.issue33233@psf.upfronthosting.co.za>
Message-ID: <1523073512.07.0.682650639539.issue33233@psf.upfronthosting.co.za>


Catherine Devlin <catherinedevlin at users.sourceforge.net> added the comment:

Hi, everybody!  I really appreciate the kind words about cmd2.

For several years now, Todd Leonhardt has been cmd2's primary maintainer, so I may be speaking out of turn.  But, before I wanted to let it get within screaming distance of the standard library, I would want to refactor it like mad; maybe even remove some features that were created more in a spirit of gee-whiz-I-can-do-this than real need.  Todd and I have worked a little on such a refactor, but even once we make time to actually complete it, that would make cmd2 by definition too unstable until the refactored version itself had earned some grey hair.

Also, cmd2 depends on pyparsing, which is itself unlikely to be in the standard library.

I think a "see also" list attached to standard library module docs would be great, and if this helps nucleate a decision about whether/how to do that for a bunch of modules, that would be great.

----------
nosy: +catherinedevlin

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33233>
_______________________________________

From report at bugs.python.org  Sat Apr  7 01:16:30 2018
From: report at bugs.python.org (Todd Leonhardt)
Date: Sat, 07 Apr 2018 05:16:30 +0000
Subject: [docs] [issue33233] Suggest third-party cmd2 module as alternative
 to cmd
In-Reply-To: <1522954289.49.0.682650639539.issue33233@psf.upfronthosting.co.za>
Message-ID: <1523078190.27.0.682650639539.issue33233@psf.upfronthosting.co.za>


Todd Leonhardt <todd.leonhardt at gmail.com> added the comment:

The cmd2 project is in the process of rapidly stabilizing, but it isn't quite there yet.

The other cmd2 core maintainers and I do have a bunch of refactoring planned over the next 6 to 8 months or so.  Right now @kotfu (Jared Crapo) is working on replacing pyparsing with shlex.  Since shlex is built into Python, that removes one 3rd party dependency.   In early September we plan on abandoning support for Python 2.7 for future releases which will enable us to remove dependencies on most of the other 3rd party libraries we currently depend upon and to dramatically clean the code up in numerous other ways.  The one third party dependency which will be left is pyperclip, but honestly that isn't very well maintained and I've been thinking about removing the functionality we use it for (clipboard copy/paste).

Another core cmd2 maintainer, @kmvanbrunt (Kevin Van Brunt) has been toying with the idea of forking it and creating a lighter and simpler version with a reduced feature set.  If it is something the core developers view as desirable, I think it would perhaps be a viable path forward to have the cmd2 maintainers take over maintenance of cmd and to move towards that becoming the lightweight reduced feature set version and cmd2 living on as the heavier weight more full featured extension of cmd (but many of the current features of cmd2 could be merged into cmd).

----------
nosy: +tleonhardt

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33233>
_______________________________________

From report at bugs.python.org  Sat Apr  7 12:14:11 2018
From: report at bugs.python.org (Antoine Pitrou)
Date: Sat, 07 Apr 2018 16:14:11 +0000
Subject: [docs] [issue33201] Modernize "Extension types" documentation
In-Reply-To: <1522609383.56.0.467229070634.issue33201@psf.upfronthosting.co.za>
Message-ID: <1523117651.26.0.682650639539.issue33201@psf.upfronthosting.co.za>


Antoine Pitrou <pitrou at free.fr> added the comment:


New changeset 1d80a561734b9932961c546b0897405a3bfbf3e6 by Antoine Pitrou in branch 'master':
bpo-33201: Modernize "Extension types" doc (GH-6337)
https://github.com/python/cpython/commit/1d80a561734b9932961c546b0897405a3bfbf3e6


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33201>
_______________________________________

From report at bugs.python.org  Sat Apr  7 12:15:24 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 07 Apr 2018 16:15:24 +0000
Subject: [docs] [issue33201] Modernize "Extension types" documentation
In-Reply-To: <1522609383.56.0.467229070634.issue33201@psf.upfronthosting.co.za>
Message-ID: <1523117724.92.0.262363346258.issue33201@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +6116

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33201>
_______________________________________

From report at bugs.python.org  Sat Apr  7 12:21:30 2018
From: report at bugs.python.org (Antoine Pitrou)
Date: Sat, 07 Apr 2018 16:21:30 +0000
Subject: [docs] [issue33201] Modernize "Extension types" documentation
In-Reply-To: <1522609383.56.0.467229070634.issue33201@psf.upfronthosting.co.za>
Message-ID: <1523118090.34.0.262363346258.issue33201@psf.upfronthosting.co.za>


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


----------
pull_requests: +6117

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33201>
_______________________________________

From report at bugs.python.org  Sat Apr  7 12:27:07 2018
From: report at bugs.python.org (Antoine Pitrou)
Date: Sat, 07 Apr 2018 16:27:07 +0000
Subject: [docs] [issue33201] Modernize "Extension types" documentation
In-Reply-To: <1522609383.56.0.467229070634.issue33201@psf.upfronthosting.co.za>
Message-ID: <1523118427.64.0.682650639539.issue33201@psf.upfronthosting.co.za>


Antoine Pitrou <pitrou at free.fr> added the comment:


New changeset 31f1b52f1f6c2d84eacf3c6db3f6b9adf04b675e by Antoine Pitrou (Miss Islington (bot)) in branch '3.7':
bpo-33201: Modernize "Extension types" doc (GH-6337) (GH-6411)
https://github.com/python/cpython/commit/31f1b52f1f6c2d84eacf3c6db3f6b9adf04b675e


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33201>
_______________________________________

From report at bugs.python.org  Sat Apr  7 12:35:37 2018
From: report at bugs.python.org (Antoine Pitrou)
Date: Sat, 07 Apr 2018 16:35:37 +0000
Subject: [docs] [issue33201] Modernize "Extension types" documentation
In-Reply-To: <1522609383.56.0.467229070634.issue33201@psf.upfronthosting.co.za>
Message-ID: <1523118937.55.0.682650639539.issue33201@psf.upfronthosting.co.za>


Antoine Pitrou <pitrou at free.fr> added the comment:


New changeset b603609e9dd19268b61b52e701cc0ee8e86784c5 by Antoine Pitrou in branch '3.6':
[3.6] bpo-33201: Modernize "Extension types" doc (GH-6337) (GH-6412)
https://github.com/python/cpython/commit/b603609e9dd19268b61b52e701cc0ee8e86784c5


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33201>
_______________________________________

From report at bugs.python.org  Sat Apr  7 12:36:00 2018
From: report at bugs.python.org (Antoine Pitrou)
Date: Sat, 07 Apr 2018 16:36:00 +0000
Subject: [docs] [issue33201] Modernize "Extension types" documentation
In-Reply-To: <1522609383.56.0.467229070634.issue33201@psf.upfronthosting.co.za>
Message-ID: <1523118960.59.0.262363346258.issue33201@psf.upfronthosting.co.za>


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


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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33201>
_______________________________________

From report at bugs.python.org  Sat Apr  7 15:22:42 2018
From: report at bugs.python.org (Martin Falatic)
Date: Sat, 07 Apr 2018 19:22:42 +0000
Subject: [docs] [issue33239] tempfile module: functions with the 'buffering'
 option are incorrectly documented
Message-ID: <1523128962.9.0.682650639539.issue33239@psf.upfronthosting.co.za>


New submission from Martin Falatic <martin at falatic.com>:

The documentation for the tempfile module in Python 3.x for the `buffering` option is incorrect:

https://docs.python.org/3/library/tempfile.html

TemporaryFile, NamedTemporaryFile, and SpooledTemporaryFile all take the `buffering` option, which in turn appears to correlate to the Python 2.7 option `bufsize`, which was and continues to be an integer (per the source).

In the 3.x documentation the default signature for TemporaryFile, NamedTemporaryFile, and SpooledTemporaryFile includes `buffering=None`. Actually specifying None as a default for this will cause an exception (`TypeError: an integer is required (got type NoneType)`).

There is a cross-reference in the 3.x tempfile docs to `open` (https://docs.python.org/3/library/functions.html#open) which in turn shows the correct signature to use for `buffering`. Additionally, the source code is clearly documented (https://github.com/python/cpython/blob/master/Lib/tempfile.py)

A good correction would be to ensure `buffering=-1` is documented as the default for the three functions in tempfile, with an additional note explicitly stating that -1 == no buffering, and the existing `open` cross-reference retained.

----------
assignee: docs at python
components: Documentation
messages: 315072
nosy: MartyMacGyver, docs at python
priority: normal
severity: normal
status: open
title: tempfile module: functions with the 'buffering' option are incorrectly documented
versions: Python 3.4, Python 3.5, Python 3.6, Python 3.7, Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33239>
_______________________________________

From report at bugs.python.org  Sun Apr  8 03:57:48 2018
From: report at bugs.python.org (Aaron Ang)
Date: Sun, 08 Apr 2018 07:57:48 +0000
Subject: [docs] [issue31201] make test: module test that failed doesn't exist
In-Reply-To: <1502707428.17.0.905101363291.issue31201@psf.upfronthosting.co.za>
Message-ID: <1523174268.3.0.262363346258.issue31201@psf.upfronthosting.co.za>


Change by Aaron Ang <awz.ang at gmail.com>:


----------
keywords: +patch
pull_requests: +6119
stage: needs patch -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue31201>
_______________________________________

From report at bugs.python.org  Sun Apr  8 04:11:43 2018
From: report at bugs.python.org (Mikhail Zakharov)
Date: Sun, 08 Apr 2018 08:11:43 +0000
Subject: [docs] =?utf-8?q?=5Bissue33229=5D_Documentation_-__io_=E2=80=94_?=
 =?utf-8?q?Core_tools_for_working_with_streams_-_seek=28=29?=
In-Reply-To: <1522919317.94.0.682650639539.issue33229@psf.upfronthosting.co.za>
Message-ID: <1523175103.17.0.262363346258.issue33229@psf.upfronthosting.co.za>


Change by Mikhail Zakharov <zmey20000 at yahoo.com>:


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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33229>
_______________________________________

From report at bugs.python.org  Sun Apr  8 07:22:25 2018
From: report at bugs.python.org (Akshay Sharma)
Date: Sun, 08 Apr 2018 11:22:25 +0000
Subject: [docs] [issue33239] tempfile module: functions with the 'buffering'
 option are incorrectly documented
In-Reply-To: <1523128962.9.0.682650639539.issue33239@psf.upfronthosting.co.za>
Message-ID: <1523186545.42.0.682650639539.issue33239@psf.upfronthosting.co.za>


Akshay Sharma <akshay.sharma09695 at gmail.com> added the comment:

Hi, will it be good to link the cross-reference for `open`(https://docs.python.org/3/library/functions.html#open) in the documentation?

I think specifically mentioning the usage of the  `buffering` is a better way.

----------
nosy: +Akshay Sharma

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33239>
_______________________________________

From report at bugs.python.org  Sun Apr  8 08:08:51 2018
From: report at bugs.python.org (Akshay Sharma)
Date: Sun, 08 Apr 2018 12:08:51 +0000
Subject: [docs] [issue33239] tempfile module: functions with the 'buffering'
 option are incorrectly documented
In-Reply-To: <1523128962.9.0.682650639539.issue33239@psf.upfronthosting.co.za>
Message-ID: <1523189331.68.0.262363346258.issue33239@psf.upfronthosting.co.za>


Change by Akshay Sharma <akshay.sharma09695 at gmail.com>:


----------
keywords: +patch
pull_requests: +6120
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33239>
_______________________________________

From report at bugs.python.org  Sun Apr  8 09:42:47 2018
From: report at bugs.python.org (Akshay Sharma)
Date: Sun, 08 Apr 2018 13:42:47 +0000
Subject: [docs] [issue25735] math.factorial doc should mention integer
 return type
In-Reply-To: <1448480671.49.0.139605050425.issue25735@psf.upfronthosting.co.za>
Message-ID: <1523194967.11.0.262363346258.issue25735@psf.upfronthosting.co.za>


Change by Akshay Sharma <akshay.sharma09695 at gmail.com>:


----------
pull_requests: +6123
stage: needs patch -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue25735>
_______________________________________

From report at bugs.python.org  Sun Apr  8 12:08:37 2018
From: report at bugs.python.org (Matej Cepl)
Date: Sun, 08 Apr 2018 16:08:37 +0000
Subject: [docs] [issue33233] Suggest third-party cmd2 module as alternative
 to cmd
In-Reply-To: <1522954289.49.0.682650639539.issue33233@psf.upfronthosting.co.za>
Message-ID: <1523203717.84.0.262363346258.issue33233@psf.upfronthosting.co.za>


Change by Matej Cepl <mcepl at cepl.eu>:


----------
nosy: +mcepl

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33233>
_______________________________________

From report at bugs.python.org  Sun Apr  8 19:41:40 2018
From: report at bugs.python.org (Martin Falatic)
Date: Sun, 08 Apr 2018 23:41:40 +0000
Subject: [docs] [issue33239] tempfile module: functions with the 'buffering'
 option are incorrectly documented
In-Reply-To: <1523128962.9.0.682650639539.issue33239@psf.upfronthosting.co.za>
Message-ID: <1523230900.92.0.682650639539.issue33239@psf.upfronthosting.co.za>


Martin Falatic <martin at falatic.com> added the comment:

The correction of `buffering=None` --> `buffering=-1` for the defaults definitely needs to happen.

A reference to `open()` is already present in the 3.x documentation: "buffering, encoding and newline are interpreted as for open()."

Given that the `open()` reference already suffices for `encoding` and `newline`, it ought to suffice for `buffering` as well. No extra text beyond that should be necessary (I originally thought that might be good to add, but looking at this now it's clear if you add more to describe `buffering` you'll need to add it for the other two options, and it's all duplicative. Fixing the defaults should suffice.)

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33239>
_______________________________________

From report at bugs.python.org  Mon Apr  9 03:14:29 2018
From: report at bugs.python.org (=?utf-8?q?Markus_J=C3=A4rvisalo?=)
Date: Mon, 09 Apr 2018 07:14:29 +0000
Subject: [docs] =?utf-8?q?=5Bissue33246=5D_Note_in_18=2E2=2E_json_?=
 =?utf-8?q?=E2=80=94_JSON_encoder_and_decoder_is_incorrect?=
Message-ID: <1523258069.7.0.682650639539.issue33246@psf.upfronthosting.co.za>


New submission from Markus J?rvisalo <markus.jarvisalo at gmail.com>:

The note in https://docs.python.org/2/library/json.html section "18.2. json ? JSON encoder and decoder".

The note says incorrectly that JSON is a subset of YAML 1.2 but if you follow the text written in YAML 1.2 specification it states that:

"The primary objective of this revision is to bring YAML into compliance with JSON as an official subset."

So it should be that YAML is a subset of JSON and not the other way around.

----------
assignee: docs at python
components: Documentation
messages: 315111
nosy: Markus J?rvisalo, docs at python
priority: normal
severity: normal
status: open
title: Note in 18.2. json ? JSON encoder and decoder is incorrect
type: behavior
versions: Python 2.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33246>
_______________________________________

From report at bugs.python.org  Mon Apr  9 03:48:23 2018
From: report at bugs.python.org (INADA Naoki)
Date: Mon, 09 Apr 2018 07:48:23 +0000
Subject: [docs] =?utf-8?q?=5Bissue33246=5D_Note_in_18=2E2=2E_json_?=
 =?utf-8?q?=E2=80=94_JSON_encoder_and_decoder_is_incorrect?=
In-Reply-To: <1523258069.7.0.682650639539.issue33246@psf.upfronthosting.co.za>
Message-ID: <1523260103.83.0.682650639539.issue33246@psf.upfronthosting.co.za>


INADA Naoki <songofacandy at gmail.com> added the comment:

> "The primary objective of this revision is to bring YAML into compliance with JSON as an official subset."
>
> So it should be that YAML is a subset of JSON and not the other way around.

This sentence can be read as "JSON is subset of YAML" and "YAML is subset of JSON".
As reading the spec, it means former.

For example, http://yaml.org/spec/1.2/spec.html#id2759572 says:

> YAML can therefore be viewed as a natural superset of JSON, offering improved human readability and a more complete information model. This is also the case in practice; every JSON file is also a valid YAML file. This makes it easy to migrate from JSON to YAML if/when the additional features are required.

----------
nosy: +inada.naoki
resolution:  -> not a bug
stage:  -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33246>
_______________________________________

From report at bugs.python.org  Mon Apr  9 06:48:33 2018
From: report at bugs.python.org (Petr Viktorin)
Date: Mon, 09 Apr 2018 10:48:33 +0000
Subject: [docs] [issue26979] The danger of PyType_FromSpec()
In-Reply-To: <1462731878.82.0.9073654009.issue26979@psf.upfronthosting.co.za>
Message-ID: <1523270913.2.0.262363346258.issue26979@psf.upfronthosting.co.za>


Change by Petr Viktorin <encukou at gmail.com>:


----------
nosy: +Dormouse759, encukou

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue26979>
_______________________________________

From report at bugs.python.org  Mon Apr  9 07:53:18 2018
From: report at bugs.python.org (Nick Coghlan)
Date: Mon, 09 Apr 2018 11:53:18 +0000
Subject: [docs] [issue26979] The danger of PyType_FromSpec()
In-Reply-To: <1462731878.82.0.9073654009.issue26979@psf.upfronthosting.co.za>
Message-ID: <1523274798.13.0.262363346258.issue26979@psf.upfronthosting.co.za>


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


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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue26979>
_______________________________________

From report at bugs.python.org  Mon Apr  9 12:44:19 2018
From: report at bugs.python.org (Ethan Furman)
Date: Mon, 09 Apr 2018 16:44:19 +0000
Subject: [docs] [issue33233] Suggest third-party cmd2 module as alternative
 to cmd
In-Reply-To: <1522954289.49.0.682650639539.issue33233@psf.upfronthosting.co.za>
Message-ID: <1523292259.96.0.262363346258.issue33233@psf.upfronthosting.co.za>


Change by Ethan Furman <ethan at stoneleaf.us>:


----------
nosy: +ethan.furman

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33233>
_______________________________________

From report at bugs.python.org  Mon Apr  9 17:09:40 2018
From: report at bugs.python.org (Ned Deily)
Date: Mon, 09 Apr 2018 21:09:40 +0000
Subject: [docs] [issue31201] make test: module test that failed doesn't exist
In-Reply-To: <1502707428.17.0.905101363291.issue31201@psf.upfronthosting.co.za>
Message-ID: <1523308180.78.0.682650639539.issue31201@psf.upfronthosting.co.za>


Ned Deily <nad at python.org> added the comment:


New changeset 0f914b5b5f6ba186afd7112fc851c97247076f70 by Ned Deily (Aaron Ang) in branch 'master':
bpo-31201: Clarify command to re-run failing test(s) with example (GH-6417)
https://github.com/python/cpython/commit/0f914b5b5f6ba186afd7112fc851c97247076f70


----------
nosy: +ned.deily

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue31201>
_______________________________________

From report at bugs.python.org  Mon Apr  9 17:10:48 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 09 Apr 2018 21:10:48 +0000
Subject: [docs] [issue31201] make test: module test that failed doesn't exist
In-Reply-To: <1502707428.17.0.905101363291.issue31201@psf.upfronthosting.co.za>
Message-ID: <1523308248.47.0.262363346258.issue31201@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +6133

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue31201>
_______________________________________

From report at bugs.python.org  Mon Apr  9 17:11:41 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 09 Apr 2018 21:11:41 +0000
Subject: [docs] [issue31201] make test: module test that failed doesn't exist
In-Reply-To: <1502707428.17.0.905101363291.issue31201@psf.upfronthosting.co.za>
Message-ID: <1523308301.38.0.262363346258.issue31201@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +6134

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue31201>
_______________________________________

From report at bugs.python.org  Mon Apr  9 17:17:23 2018
From: report at bugs.python.org (Ned Deily)
Date: Mon, 09 Apr 2018 21:17:23 +0000
Subject: [docs] [issue31201] make test: module test that failed doesn't exist
In-Reply-To: <1502707428.17.0.905101363291.issue31201@psf.upfronthosting.co.za>
Message-ID: <1523308643.01.0.682650639539.issue31201@psf.upfronthosting.co.za>


Ned Deily <nad at python.org> added the comment:


New changeset 71a3837bf39580ffa828c14247230a9277b9d5b1 by Ned Deily (Miss Islington (bot)) in branch '3.7':
[3.7] bpo-31201: Clarify command to re-run failing test(s) with example (GH-6417) (GH-6437)
https://github.com/python/cpython/commit/71a3837bf39580ffa828c14247230a9277b9d5b1


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue31201>
_______________________________________

From report at bugs.python.org  Mon Apr  9 17:19:34 2018
From: report at bugs.python.org (Ned Deily)
Date: Mon, 09 Apr 2018 21:19:34 +0000
Subject: [docs] [issue31201] make test: module test that failed doesn't exist
In-Reply-To: <1502707428.17.0.905101363291.issue31201@psf.upfronthosting.co.za>
Message-ID: <1523308774.69.0.682650639539.issue31201@psf.upfronthosting.co.za>


Ned Deily <nad at python.org> added the comment:


New changeset 83bb39907ec3828aec6d99bb9338283bd6b30ac2 by Ned Deily (Miss Islington (bot)) in branch '3.6':
[3.6] bpo-31201: Clarify command to re-run failing test(s) with example (GH-6417) (GH-6438)
https://github.com/python/cpython/commit/83bb39907ec3828aec6d99bb9338283bd6b30ac2


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue31201>
_______________________________________

From report at bugs.python.org  Mon Apr  9 17:21:01 2018
From: report at bugs.python.org (Ned Deily)
Date: Mon, 09 Apr 2018 21:21:01 +0000
Subject: [docs] [issue31201] make test: module test that failed doesn't exist
In-Reply-To: <1502707428.17.0.905101363291.issue31201@psf.upfronthosting.co.za>
Message-ID: <1523308861.73.0.682650639539.issue31201@psf.upfronthosting.co.za>


Ned Deily <nad at python.org> added the comment:

Thanks for the PR, Aaron!

----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed
type: enhancement -> 
versions: +Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue31201>
_______________________________________

From report at bugs.python.org  Mon Apr  9 18:13:44 2018
From: report at bugs.python.org (Ed Morley)
Date: Mon, 09 Apr 2018 22:13:44 +0000
Subject: [docs] [issue33252] Clarify ResourceWarning documentation
Message-ID: <1523312024.12.0.682650639539.issue33252@psf.upfronthosting.co.za>


New submission from Ed Morley <emorley at mozilla.com>:

The `ResourceWarning` warning has always been ignored by default, since it was added in Python 3.2 in:
https://github.com/python/cpython/commit/08be72d0aa0112118b79d271479598c218adfd23#diff-db4e2b9efea108a38c53e06fa99cdd77R391

However there are several places in the docs where the "ignored by default" aspect is not mentioned even though it is for `DeprecationWarning` and similar - which caused me quite a bit of confusion today.

The docs were partly improved in Python 3.7 onwards by:
https://github.com/python/cpython/commit/9b99747386b690007027c3be2a5d7cfe3d3634f5

...however:
(a) there is still at least one place that still needs updating on master (https://docs.python.org/3.8/library/warnings.html#warning-categories)
(b) it would be good to backport the docs fixes to 3.4/3.5/3.6 (I was looking at the 3.6 docs today)

I'm happy to open PRs to fix this; but filing this issue so I have something to reference.

----------
assignee: docs at python
components: Documentation
messages: 315153
nosy: docs at python, edmorley
priority: normal
severity: normal
status: open
title: Clarify ResourceWarning documentation
type: enhancement
versions: Python 3.4, Python 3.5, Python 3.6, Python 3.7, Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33252>
_______________________________________

From report at bugs.python.org  Tue Apr 10 09:02:18 2018
From: report at bugs.python.org (INADA Naoki)
Date: Tue, 10 Apr 2018 13:02:18 +0000
Subject: [docs] [issue31584] Documentation Language mixed up
In-Reply-To: <1506402847.94.0.987670636111.issue31584@psf.upfronthosting.co.za>
Message-ID: <1523365338.04.0.682650639539.issue31584@psf.upfronthosting.co.za>


INADA Naoki <songofacandy at gmail.com> added the comment:

Maybe, this issue is fixed?

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue31584>
_______________________________________

From report at bugs.python.org  Tue Apr 10 09:36:11 2018
From: report at bugs.python.org (Julien Palard)
Date: Tue, 10 Apr 2018 13:36:11 +0000
Subject: [docs] [issue31584] Documentation Language mixed up
In-Reply-To: <1506402847.94.0.987670636111.issue31584@psf.upfronthosting.co.za>
Message-ID: <1523367371.56.0.682650639539.issue31584@psf.upfronthosting.co.za>


Julien Palard <julien+python at palard.fr> added the comment:

I think so, at least since https://github.com/python/docsbuild-scripts/pull/36 has been merged.

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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue31584>
_______________________________________

From report at bugs.python.org  Tue Apr 10 10:38:43 2018
From: report at bugs.python.org (Ned Deily)
Date: Tue, 10 Apr 2018 14:38:43 +0000
Subject: [docs] [issue33252] Clarify ResourceWarning documentation
In-Reply-To: <1523312024.12.0.682650639539.issue33252@psf.upfronthosting.co.za>
Message-ID: <1523371123.88.0.262363346258.issue33252@psf.upfronthosting.co.za>


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


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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33252>
_______________________________________

From report at bugs.python.org  Wed Apr 11 09:51:58 2018
From: report at bugs.python.org (Nick Coghlan)
Date: Wed, 11 Apr 2018 13:51:58 +0000
Subject: [docs] [issue33252] Clarify ResourceWarning documentation
In-Reply-To: <1523312024.12.0.682650639539.issue33252@psf.upfronthosting.co.za>
Message-ID: <1523454718.86.0.682650639539.issue33252@psf.upfronthosting.co.za>


Nick Coghlan <ncoghlan at gmail.com> added the comment:

+1 from me for further ResourceWarning docs improvements - my focus when working on PEP 565 was the actual change in how DeprecationWarning was being handled, and the other warnings doc improvements were just a necessary prerequisite for being able to convey that clearly.

The backport to 3.6 may or may not be worthwhile, depending on how much work it proves to be in practice (while those will still be the default online docs for the next couple of months, the 3.7 branch will take their place once 3.7.0 is officially released).

We wouldn't backport docs changes to 3.4 or 3.5, as both of those branches are already in security-fix-only mode.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33252>
_______________________________________

From report at bugs.python.org  Wed Apr 11 10:49:18 2018
From: report at bugs.python.org (Oliver Urs Lenz)
Date: Wed, 11 Apr 2018 14:49:18 +0000
Subject: [docs] [issue25433] whitespace in strip()/lstrip()/rstrip()
In-Reply-To: <1445170536.34.0.94220475409.issue25433@psf.upfronthosting.co.za>
Message-ID: <1523458158.22.0.682650639539.issue25433@psf.upfronthosting.co.za>


Oliver Urs Lenz <oliver.urs.lenz at gmail.com> added the comment:

Slightly tangential, but it would be great if the documentation of lstrip() and rstrip() could include an equivalent definition in terms of re.sub(), e.g.:

lstrip(foo) == re.sub(r'(?u)\A\s*', '', foo)
rstrip(foo) == re.sub(r'(?u)\s*\Z', '', foo)

(Or whatever else is correct.)

----------
nosy: +oulenz

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue25433>
_______________________________________

From report at bugs.python.org  Wed Apr 11 18:57:04 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Wed, 11 Apr 2018 22:57:04 +0000
Subject: [docs] [issue33264] Remove to-be-deprecated
 urllib.request.urlretrieve function reference from HOWTO
Message-ID: <1523487424.62.0.682650639539.issue33264@psf.upfronthosting.co.za>


New submission from Andr?s Delfino <adelfino at gmail.com>:

Documentation says urllib.request.urlretrieve "might become deprecated at some point in the future".

IMHO, it's better to provide examples that do not make users rely on API that has this label.

I propose the example in the pull request to accomplish exactly the same task while not relying on urllib.request.urlretrieve.

----------
assignee: docs at python
components: Documentation
messages: 315204
nosy: adelfino, docs at python
priority: normal
severity: normal
status: open
title: Remove to-be-deprecated urllib.request.urlretrieve function reference from HOWTO
type: enhancement
versions: Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33264>
_______________________________________

From report at bugs.python.org  Wed Apr 11 18:59:29 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Wed, 11 Apr 2018 22:59:29 +0000
Subject: [docs] [issue33264] Remove to-be-deprecated
 urllib.request.urlretrieve function reference from HOWTO
In-Reply-To: <1523487424.62.0.682650639539.issue33264@psf.upfronthosting.co.za>
Message-ID: <1523487569.6.0.262363346258.issue33264@psf.upfronthosting.co.za>


Change by Andr?s Delfino <adelfino at gmail.com>:


----------
keywords: +patch
pull_requests: +6148
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33264>
_______________________________________

From report at bugs.python.org  Wed Apr 11 19:31:37 2018
From: report at bugs.python.org (Ned Deily)
Date: Wed, 11 Apr 2018 23:31:37 +0000
Subject: [docs] [issue33264] Remove to-be-deprecated
 urllib.request.urlretrieve function reference from HOWTO
In-Reply-To: <1523487424.62.0.682650639539.issue33264@psf.upfronthosting.co.za>
Message-ID: <1523489497.19.0.262363346258.issue33264@psf.upfronthosting.co.za>


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


----------
nosy: +orsenthil

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33264>
_______________________________________

From report at bugs.python.org  Wed Apr 11 19:44:05 2018
From: report at bugs.python.org (Senthil Kumaran)
Date: Wed, 11 Apr 2018 23:44:05 +0000
Subject: [docs] [issue33264] Remove to-be-deprecated
 urllib.request.urlretrieve function reference from HOWTO
In-Reply-To: <1523487424.62.0.682650639539.issue33264@psf.upfronthosting.co.za>
Message-ID: <1523490245.02.0.682650639539.issue33264@psf.upfronthosting.co.za>


Senthil Kumaran <senthil at uthcode.com> added the comment:

Andr?s,  your pull request looks good to me. Please go ahead and sign the CLA and I can merge this to cpython HEAD. 

Thank you for your contribution.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33264>
_______________________________________

From report at bugs.python.org  Wed Apr 11 19:48:09 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Wed, 11 Apr 2018 23:48:09 +0000
Subject: [docs] [issue33264] Remove to-be-deprecated
 urllib.request.urlretrieve function reference from HOWTO
In-Reply-To: <1523487424.62.0.682650639539.issue33264@psf.upfronthosting.co.za>
Message-ID: <1523490489.35.0.682650639539.issue33264@psf.upfronthosting.co.za>


Andr?s Delfino <adelfino at gmail.com> added the comment:

Hi Senthil! I signed the CLA several days ago. Got the "Python Contributor Agreement Form between Python Software Foundation and Andr?s Delfino is Signed and Filed!" mail on April 1st (perhaps I chose a bad date to fill the request ;) )

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33264>
_______________________________________

From report at bugs.python.org  Wed Apr 11 20:40:34 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Thu, 12 Apr 2018 00:40:34 +0000
Subject: [docs] [issue33264] Remove to-be-deprecated
 urllib.request.urlretrieve function reference from HOWTO
In-Reply-To: <1523487424.62.0.682650639539.issue33264@psf.upfronthosting.co.za>
Message-ID: <1523493633.9.0.682650639539.issue33264@psf.upfronthosting.co.za>


Andr?s Delfino <adelfino at gmail.com> added the comment:

The agreement can be found at: https://secure.na1.echosign.com/public/viewAgreement?tsid=CBFCIBAA3AAABLblqZhC0bOfZxqQ_bUGhwUqnYiqqxAj3N7_dOts1qHsH9YdsbakL5qJ6FbSU9NHkecXglBLZ29gXbHeNdUErGzW7QkUs&

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33264>
_______________________________________

From report at bugs.python.org  Wed Apr 11 21:05:48 2018
From: report at bugs.python.org (Chad)
Date: Thu, 12 Apr 2018 01:05:48 +0000
Subject: [docs] [issue33082] multiprocessing docs bury very important
 'callback=' args
In-Reply-To: <1521139850.07.0.467229070634.issue33082@psf.upfronthosting.co.za>
Message-ID: <1523495148.47.0.262363346258.issue33082@psf.upfronthosting.co.za>


Change by Chad <millchad at amazon.com>:


----------
pull_requests: +6150

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33082>
_______________________________________

From report at bugs.python.org  Thu Apr 12 19:00:55 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Thu, 12 Apr 2018 23:00:55 +0000
Subject: [docs] [issue33264] Remove to-be-deprecated
 urllib.request.urlretrieve function reference from HOWTO
In-Reply-To: <1523487424.62.0.682650639539.issue33264@psf.upfronthosting.co.za>
Message-ID: <1523574055.02.0.682650639539.issue33264@psf.upfronthosting.co.za>


Andr?s Delfino <adelfino at gmail.com> added the comment:

My contributor form shows as received now :)

Don't know how to update the "CLA not signed" label on the PR.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33264>
_______________________________________

From ilei2011 at qq.com  Thu Apr 12 11:39:46 2018
From: ilei2011 at qq.com (=?ISO-8859-1?B?aGE=?=)
Date: Thu, 12 Apr 2018 23:39:46 +0800
Subject: [docs] A print mistake
Message-ID: <tencent_4F575D8A4574225E141BC6E977B279D35F08@qq.com>

It's in Python 3.1.5 --- 2.Built-in fuctions --- ord(c) --- "Uncicode"
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180412/52b2e5cc/attachment.html>

From report at bugs.python.org  Fri Apr 13 15:34:47 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Fri, 13 Apr 2018 19:34:47 +0000
Subject: [docs] [issue33275] glob.glob should explicitly note that results
 aren't sorted
In-Reply-To: <1523644726.46.0.682650639539.issue33275@psf.upfronthosting.co.za>
Message-ID: <1523648087.6.0.682650639539.issue33275@psf.upfronthosting.co.za>


Raymond Hettinger <raymond.hettinger at gmail.com> added the comment:

This seems reasonable.  I would like like it to be part of the regular text rather rather than appearing as a big ..note entry which can be visually distracting from the core functionality.

----------
assignee:  -> docs at python
components: +Documentation -Library (Lib)
keywords: +easy
nosy: +docs at python, rhettinger
stage:  -> needs patch
versions:  -Python 3.4, Python 3.5

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33275>
_______________________________________

From report at bugs.python.org  Fri Apr 13 15:35:33 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Fri, 13 Apr 2018 19:35:33 +0000
Subject: [docs] [issue33275] glob.glob should explicitly note that results
 aren't sorted
In-Reply-To: <1523644726.46.0.682650639539.issue33275@psf.upfronthosting.co.za>
Message-ID: <1523648133.82.0.262363346258.issue33275@psf.upfronthosting.co.za>


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


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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33275>
_______________________________________

From report at bugs.python.org  Fri Apr 13 19:55:52 2018
From: report at bugs.python.org (Eryk Sun)
Date: Fri, 13 Apr 2018 23:55:52 +0000
Subject: [docs] [issue33275] glob.glob should explicitly note that results
 aren't sorted
In-Reply-To: <1523644726.46.0.682650639539.issue33275@psf.upfronthosting.co.za>
Message-ID: <1523663752.91.0.682650639539.issue33275@psf.upfronthosting.co.za>


Eryk Sun <eryksun at gmail.com> added the comment:

> The sortedness of glob.glob's output is platform-dependent.

It's typically file-system dependent (e.g. NTFS, FAT, ISO9660, UDF) -- at least on Windows. NTFS and ISO9660 store directories in sorted order based on the filename (Unicode or ASCII ordinal sort).

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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33275>
_______________________________________

From report at bugs.python.org  Fri Apr 13 20:09:49 2018
From: report at bugs.python.org (Ben FrantzDale)
Date: Sat, 14 Apr 2018 00:09:49 +0000
Subject: [docs] [issue33275] glob.glob should explicitly note that results
 aren't sorted
In-Reply-To: <1523644726.46.0.682650639539.issue33275@psf.upfronthosting.co.za>
Message-ID: <1523664589.04.0.682650639539.issue33275@psf.upfronthosting.co.za>


Ben FrantzDale <ben at formlabs.com> added the comment:

Fascinating. That seems like an even wilder gotcha: It sounds like a script assuming sorted results would work in one directory (on one filesystem) but not on another. Or even weirder, if I had a mounted scratch partition, the script could work until I (or a sys admin) mounts a larger drive with a different filesystem on the same mountpoint. Yikes! Either way, this gotcha seems worth mentioning explicitly.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33275>
_______________________________________

From report at bugs.python.org  Fri Apr 13 20:32:21 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 14 Apr 2018 00:32:21 +0000
Subject: [docs] [issue33264] Remove to-be-deprecated
 urllib.request.urlretrieve function reference from HOWTO
In-Reply-To: <1523487424.62.0.682650639539.issue33264@psf.upfronthosting.co.za>
Message-ID: <1523665940.91.0.682650639539.issue33264@psf.upfronthosting.co.za>


Terry J. Reedy <tjreedy at udel.edu> added the comment:

The label has been changed.  Senthil, go ahead and merge this.

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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33264>
_______________________________________

From report at bugs.python.org  Sat Apr 14 08:13:54 2018
From: report at bugs.python.org (Jeffrey McLarty)
Date: Sat, 14 Apr 2018 12:13:54 +0000
Subject: [docs] [issue27544] Document the ABCs for instance/subclass checks
 of dict view types
In-Reply-To: <1468805116.02.0.14575319212.issue27544@psf.upfronthosting.co.za>
Message-ID: <1523708034.85.0.262363346258.issue27544@psf.upfronthosting.co.za>


Change by Jeffrey McLarty <jeffrey.mclarty at gmail.com>:


----------
nosy: +Jeffrey McLarty

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue27544>
_______________________________________

From report at bugs.python.org  Sat Apr 14 16:12:42 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Sat, 14 Apr 2018 20:12:42 +0000
Subject: [docs] [issue33280] Update link to Tcl/Tk 8.6 man pages in
 tkinter.rst
Message-ID: <1523736762.33.0.682650639539.issue33280@psf.upfronthosting.co.za>


New submission from Andr?s Delfino <adelfino at gmail.com>:

There are two links to the Tcl/Tk documentation on tkinter.rst. One of them points to 8.5 man pages.

----------
assignee: docs at python
components: Documentation
messages: 315303
nosy: adelfino, docs at python
priority: normal
severity: normal
status: open
title: Update link to Tcl/Tk 8.6 man pages in tkinter.rst
type: enhancement
versions: Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33280>
_______________________________________

From report at bugs.python.org  Sat Apr 14 16:13:57 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Sat, 14 Apr 2018 20:13:57 +0000
Subject: [docs] [issue33280] Update link to Tcl/Tk 8.6 man pages in
 tkinter.rst
In-Reply-To: <1523736762.33.0.682650639539.issue33280@psf.upfronthosting.co.za>
Message-ID: <1523736837.82.0.262363346258.issue33280@psf.upfronthosting.co.za>


Change by Andr?s Delfino <adelfino at gmail.com>:


----------
keywords: +patch
pull_requests: +6172
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33280>
_______________________________________

From report at bugs.python.org  Sun Apr 15 10:23:12 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Sun, 15 Apr 2018 14:23:12 +0000
Subject: [docs] [issue33283] Mention PNG as a supported image format by
 Tcl/Tk
Message-ID: <1523802192.37.0.682650639539.issue33283@psf.upfronthosting.co.za>


New submission from Andr?s Delfino <adelfino at gmail.com>:

PNG is supported since Tcl/Tk 8.6. Update the doc/source accordingly.

----------
assignee: docs at python
components: Documentation
messages: 315324
nosy: adelfino, docs at python
priority: normal
severity: normal
status: open
title: Mention PNG as a supported image format by Tcl/Tk
type: enhancement
versions: Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33283>
_______________________________________

From report at bugs.python.org  Sun Apr 15 10:23:55 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Sun, 15 Apr 2018 14:23:55 +0000
Subject: [docs] [issue33283] Mention PNG as a supported image format by
 Tcl/Tk
In-Reply-To: <1523802192.37.0.682650639539.issue33283@psf.upfronthosting.co.za>
Message-ID: <1523802235.96.0.262363346258.issue33283@psf.upfronthosting.co.za>


Change by Andr?s Delfino <adelfino at gmail.com>:


----------
keywords: +patch
pull_requests: +6179
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33283>
_______________________________________

From report at bugs.python.org  Sun Apr 15 11:40:37 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 15 Apr 2018 15:40:37 +0000
Subject: [docs] [issue33280] Update link to Tcl/Tk 8.6 man pages in
 tkinter.rst
In-Reply-To: <1523736762.33.0.682650639539.issue33280@psf.upfronthosting.co.za>
Message-ID: <1523806837.58.0.682650639539.issue33280@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:

I suggest to just remove the version suffix "8.6".

----------
nosy: +serhiy.storchaka, terry.reedy
versions: +Python 2.7, Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33280>
_______________________________________

From report at bugs.python.org  Sun Apr 15 11:41:12 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 15 Apr 2018 15:41:12 +0000
Subject: [docs] [issue33280] Update link to Tcl/Tk 8.6 man pages in
 tkinter.rst
In-Reply-To: <1523736762.33.0.682650639539.issue33280@psf.upfronthosting.co.za>
Message-ID: <1523806872.84.0.262363346258.issue33280@psf.upfronthosting.co.za>


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


----------
components: +Tkinter

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33280>
_______________________________________

From report at bugs.python.org  Sun Apr 15 11:45:29 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 15 Apr 2018 15:45:29 +0000
Subject: [docs] [issue33283] Mention PNG as a supported image format by
 Tcl/Tk
In-Reply-To: <1523802192.37.0.682650639539.issue33283@psf.upfronthosting.co.za>
Message-ID: <1523807129.54.0.682650639539.issue33283@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:

The minimal supported version is 8.4 in 3.x and 8.3 in 2.7, which don't support PNG.

----------
components: +Tkinter
nosy: +serhiy.storchaka, terry.reedy
versions: +Python 2.7, Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33283>
_______________________________________

From report at bugs.python.org  Sun Apr 15 11:49:58 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Sun, 15 Apr 2018 15:49:58 +0000
Subject: [docs] [issue33280] Update link to Tcl/Tk 8.6 man pages in
 tkinter.rst
In-Reply-To: <1523736762.33.0.682650639539.issue33280@psf.upfronthosting.co.za>
Message-ID: <1523807398.45.0.682650639539.issue33280@psf.upfronthosting.co.za>


Andr?s Delfino <adelfino at gmail.com> added the comment:

IMHO, it's important to provide the link of the specific version of Tcl/Tk that Python actually uses. Otherwise, when 8.7 users might read the wrong documentation. Also, users might read the 8.5 man pages.

Perhaps I didn't get your comment?

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33280>
_______________________________________

From report at bugs.python.org  Sun Apr 15 11:52:24 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Sun, 15 Apr 2018 15:52:24 +0000
Subject: [docs] [issue33283] Mention PNG as a supported image format by
 Tcl/Tk
In-Reply-To: <1523802192.37.0.682650639539.issue33283@psf.upfronthosting.co.za>
Message-ID: <1523807544.69.0.682650639539.issue33283@psf.upfronthosting.co.za>


Andr?s Delfino <adelfino at gmail.com> added the comment:

This brings the question: should the documentation follow what Python provides, or the minimum supported version?

Maybe a compromise is to have a "requires Tcl/Tk 8.6" note?

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33283>
_______________________________________

From report at bugs.python.org  Sun Apr 15 11:54:21 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Sun, 15 Apr 2018 15:54:21 +0000
Subject: [docs] [issue33280] Update link to Tcl/Tk 8.6 man pages in
 tkinter.rst
In-Reply-To: <1523736762.33.0.682650639539.issue33280@psf.upfronthosting.co.za>
Message-ID: <1523807661.21.0.682650639539.issue33280@psf.upfronthosting.co.za>


Andr?s Delfino <adelfino at gmail.com> added the comment:

Replaces msg315327:

IMHO, it's important to provide the link of the specific version of Tcl/Tk that Python actually uses. Otherwise, when 8.7 users might read the wrong documentation.

Perhaps I didn't get your comment?

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33280>
_______________________________________

From report at bugs.python.org  Sun Apr 15 12:29:41 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 15 Apr 2018 16:29:41 +0000
Subject: [docs] [issue33283] Mention PNG as a supported image format by
 Tcl/Tk
In-Reply-To: <1523802192.37.0.682650639539.issue33283@psf.upfronthosting.co.za>
Message-ID: <1523809781.22.0.682650639539.issue33283@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:

Yes, the minimal version of Tcl/Tk for supporting PNG should be mentioned.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33283>
_______________________________________

From report at bugs.python.org  Sun Apr 15 12:43:09 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Sun, 15 Apr 2018 16:43:09 +0000
Subject: [docs] [issue33283] Mention PNG as a supported image format by
 Tcl/Tk
In-Reply-To: <1523802192.37.0.682650639539.issue33283@psf.upfronthosting.co.za>
Message-ID: <1523810589.83.0.682650639539.issue33283@psf.upfronthosting.co.za>


Andr?s Delfino <adelfino at gmail.com> added the comment:

I have updated the PR. Hopefully, it addreses Serhiy's comments.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33283>
_______________________________________

From report at bugs.python.org  Sun Apr 15 12:45:14 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 15 Apr 2018 16:45:14 +0000
Subject: [docs] [issue33280] Update link to Tcl/Tk 8.6 man pages in
 tkinter.rst
In-Reply-To: <1523736762.33.0.682650639539.issue33280@psf.upfronthosting.co.za>
Message-ID: <1523810714.09.0.682650639539.issue33280@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:

Different builds of Python can use different versions of Tcl/Tk (as well as other external libraries). Tkinter supports features added in versions newer than minimal.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33280>
_______________________________________

From report at bugs.python.org  Sun Apr 15 12:50:21 2018
From: report at bugs.python.org (Ned Deily)
Date: Sun, 15 Apr 2018 16:50:21 +0000
Subject: [docs] [issue33283] Mention PNG as a supported image format by
 Tcl/Tk
In-Reply-To: <1523802192.37.0.682650639539.issue33283@psf.upfronthosting.co.za>
Message-ID: <1523811020.99.0.682650639539.issue33283@psf.upfronthosting.co.za>


Ned Deily <nad at python.org> added the comment:

(As a side note to Sehiy and others, as of 2.7.15, we no longer ship any python.org macOS binary installers that link with Tcl/Tk 8.4 and we also now ship at least one installer variant for 2.7.x and 3.6.x that provides Tcl/Tk 8.6.  3.7.0 will be only 8.6 and perhaps 2.7.x and 3.6.x will drop 8.5 in a future release. Of course, there may still be other platforms that use 8.4.)

----------
nosy: +ned.deily

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33283>
_______________________________________

From report at bugs.python.org  Sun Apr 15 12:50:57 2018
From: report at bugs.python.org (Ned Deily)
Date: Sun, 15 Apr 2018 16:50:57 +0000
Subject: [docs] [issue33283] Mention PNG as a supported image format by
 Tcl/Tk
In-Reply-To: <1523802192.37.0.682650639539.issue33283@psf.upfronthosting.co.za>
Message-ID: <1523811057.62.0.682650639539.issue33283@psf.upfronthosting.co.za>


Ned Deily <nad at python.org> added the comment:

(As a side note to Serhiy and others, as of 2.7.15, we no longer ship any python.org macOS binary installers that link with Tcl/Tk 8.4 and we also now ship at least one installer variant for 2.7.x and 3.6.x that provides Tcl/Tk 8.6.  3.7.0 will be only 8.6 and perhaps 2.7.x and 3.6.x will drop 8.5 in a future release. Of course, there may still be other platforms that use 8.4.)

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33283>
_______________________________________

From report at bugs.python.org  Sun Apr 15 12:51:05 2018
From: report at bugs.python.org (Ned Deily)
Date: Sun, 15 Apr 2018 16:51:05 +0000
Subject: [docs] [issue33283] Mention PNG as a supported image format by
 Tcl/Tk
In-Reply-To: <1523802192.37.0.682650639539.issue33283@psf.upfronthosting.co.za>
Message-ID: <1523811065.12.0.262363346258.issue33283@psf.upfronthosting.co.za>


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


----------
Removed message: https://bugs.python.org/msg315333

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33283>
_______________________________________

From report at bugs.python.org  Sun Apr 15 12:55:12 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Sun, 15 Apr 2018 16:55:12 +0000
Subject: [docs] [issue33280] Update link to Tcl/Tk 8.6 man pages in
 tkinter.rst
In-Reply-To: <1523736762.33.0.682650639539.issue33280@psf.upfronthosting.co.za>
Message-ID: <1523811312.56.0.682650639539.issue33280@psf.upfronthosting.co.za>


Andr?s Delfino <adelfino at gmail.com> added the comment:

Perhaps a comment in the lines of:

---
You can find the relevant Tk man pages by checking what version is installed in your system:

python -c "import tkinter; print(tkinter.TkVersion)"
---

at the top of the page, and then removing all version suffixes as you suggested?

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33280>
_______________________________________

From report at bugs.python.org  Sun Apr 15 15:07:35 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 15 Apr 2018 19:07:35 +0000
Subject: [docs] [issue33280] Update link to Tcl/Tk 8.6 man pages in
 tkinter.rst
In-Reply-To: <1523736762.33.0.682650639539.issue33280@psf.upfronthosting.co.za>
Message-ID: <1523819255.31.0.262363346258.issue33280@psf.upfronthosting.co.za>


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


----------
Removed message: https://bugs.python.org/msg315327

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33280>
_______________________________________

From report at bugs.python.org  Mon Apr 16 10:06:29 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 16 Apr 2018 14:06:29 +0000
Subject: [docs] [issue33264] Remove to-be-deprecated
 urllib.request.urlretrieve function reference from HOWTO
In-Reply-To: <1523487424.62.0.682650639539.issue33264@psf.upfronthosting.co.za>
Message-ID: <1523887589.39.0.262363346258.issue33264@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +6185

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33264>
_______________________________________

From report at bugs.python.org  Mon Apr 16 10:06:45 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 16 Apr 2018 14:06:45 +0000
Subject: [docs] [issue33264] Remove to-be-deprecated
 urllib.request.urlretrieve function reference from HOWTO
In-Reply-To: <1523487424.62.0.682650639539.issue33264@psf.upfronthosting.co.za>
Message-ID: <1523887605.06.0.262363346258.issue33264@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +6186

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33264>
_______________________________________

From report at bugs.python.org  Mon Apr 16 10:13:05 2018
From: report at bugs.python.org (Senthil Kumaran)
Date: Mon, 16 Apr 2018 14:13:05 +0000
Subject: [docs] [issue33264] Remove to-be-deprecated
 urllib.request.urlretrieve function reference from HOWTO
In-Reply-To: <1523487424.62.0.682650639539.issue33264@psf.upfronthosting.co.za>
Message-ID: <1523887985.07.0.682650639539.issue33264@psf.upfronthosting.co.za>


Senthil Kumaran <senthil at uthcode.com> added the comment:

Thank you, Andr?s and Terry.

This is merged in 3.8 and backported to 3.7 and 3.6 too.

----------
versions: +Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33264>
_______________________________________

From report at bugs.python.org  Tue Apr 17 01:34:42 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 17 Apr 2018 05:34:42 +0000
Subject: [docs] [issue33283] Mention PNG as a supported image format by
 Tcl/Tk
In-Reply-To: <1523802192.37.0.682650639539.issue33283@psf.upfronthosting.co.za>
Message-ID: <1523943282.57.0.682650639539.issue33283@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:


New changeset 4b685bf7192fff48c8effeeae4f4d64f9420ec0f by Serhiy Storchaka (Andr?s Delfino) in branch 'master':
bpo-33283: Mention PNG as a supported format by Tcl/Tk. (GH-6479)
https://github.com/python/cpython/commit/4b685bf7192fff48c8effeeae4f4d64f9420ec0f


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33283>
_______________________________________

From report at bugs.python.org  Tue Apr 17 01:35:51 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 17 Apr 2018 05:35:51 +0000
Subject: [docs] [issue33283] Mention PNG as a supported image format by
 Tcl/Tk
In-Reply-To: <1523802192.37.0.682650639539.issue33283@psf.upfronthosting.co.za>
Message-ID: <1523943351.51.0.262363346258.issue33283@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +6196

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33283>
_______________________________________

From report at bugs.python.org  Tue Apr 17 01:37:44 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 17 Apr 2018 05:37:44 +0000
Subject: [docs] [issue33283] Mention PNG as a supported image format by
 Tcl/Tk
In-Reply-To: <1523802192.37.0.682650639539.issue33283@psf.upfronthosting.co.za>
Message-ID: <1523943464.46.0.262363346258.issue33283@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +6197

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33283>
_______________________________________

From report at bugs.python.org  Tue Apr 17 06:10:48 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 17 Apr 2018 10:10:48 +0000
Subject: [docs] [issue33283] Mention PNG as a supported image format by
 Tcl/Tk
In-Reply-To: <1523802192.37.0.682650639539.issue33283@psf.upfronthosting.co.za>
Message-ID: <1523959848.28.0.682650639539.issue33283@psf.upfronthosting.co.za>


miss-islington <mariatta.wijaya+miss-islington at gmail.com> added the comment:


New changeset f44ce356a6ccd6c8e80ac5c4b29adb13db5c117a by Miss Islington (bot) in branch '3.6':
bpo-33283: Mention PNG as a supported format by Tcl/Tk. (GH-6479)
https://github.com/python/cpython/commit/f44ce356a6ccd6c8e80ac5c4b29adb13db5c117a


----------
nosy: +miss-islington

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33283>
_______________________________________

From report at bugs.python.org  Tue Apr 17 07:12:06 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Tue, 17 Apr 2018 11:12:06 +0000
Subject: [docs] [issue33297] Mention Pillow package on tkinter.rst to work
 with more image formats
Message-ID: <1523963526.08.0.682650639539.issue33297@psf.upfronthosting.co.za>


New submission from Andr?s Delfino <adelfino at gmail.com>:

Given that the default list of supported formats is quite limited, IMHO we should point to Pillow, or any other package that provides support for more formats.

----------
assignee: docs at python
components: Documentation
messages: 315393
nosy: adelfino, docs at python
priority: normal
severity: normal
status: open
title: Mention Pillow package on tkinter.rst to work with more image formats
versions: Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33297>
_______________________________________

From report at bugs.python.org  Tue Apr 17 07:12:29 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Tue, 17 Apr 2018 11:12:29 +0000
Subject: [docs] [issue33297] Mention Pillow package on tkinter.rst to work
 with more image formats
In-Reply-To: <1523963526.08.0.682650639539.issue33297@psf.upfronthosting.co.za>
Message-ID: <1523963549.18.0.262363346258.issue33297@psf.upfronthosting.co.za>


Change by Andr?s Delfino <adelfino at gmail.com>:


----------
keywords: +patch
pull_requests: +6201
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33297>
_______________________________________

From report at bugs.python.org  Tue Apr 17 07:12:57 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Tue, 17 Apr 2018 11:12:57 +0000
Subject: [docs] [issue33297] Mention Pillow package on tkinter.rst to work
 with more image formats
In-Reply-To: <1523963526.08.0.682650639539.issue33297@psf.upfronthosting.co.za>
Message-ID: <1523963577.84.0.262363346258.issue33297@psf.upfronthosting.co.za>


Change by Andr?s Delfino <adelfino at gmail.com>:


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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33297>
_______________________________________

From report at bugs.python.org  Tue Apr 17 16:02:15 2018
From: report at bugs.python.org (Glen Neff)
Date: Tue, 17 Apr 2018 20:02:15 +0000
Subject: [docs] [issue33300] Bad usage example in id() DocString
Message-ID: <1523995335.26.0.682650639539.issue33300@psf.upfronthosting.co.za>


New submission from Glen Neff <gneff at trioptimum.com>:

The DocString for id() in 3.5.x & 3.6.x seems to have an incorrect usage example, specifically ``id(obj, /)``.

This is present in 3.5.x & 3.6.x.  It does not appear to be present in 2.7.x or 3.4.x.:

Python 3.6.4 (v3.6.4:d48eceb, Dec 19 2017, 06:54:40) [MSC v.1900 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>> help(id)
Help on built-in function id in module builtins:

id(obj, /)
    Return the identity of an object.

    This is guaranteed to be unique among simultaneously existing objects.
    (CPython uses the object's memory address.)

>>>

----------
assignee: docs at python
components: Documentation
messages: 315410
nosy: docs at python, gneff
priority: normal
severity: normal
status: open
title: Bad usage example in id() DocString
versions: Python 3.5, Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33300>
_______________________________________

From report at bugs.python.org  Tue Apr 17 16:52:05 2018
From: report at bugs.python.org (Martin Panter)
Date: Tue, 17 Apr 2018 20:52:05 +0000
Subject: [docs] [issue33300] Bad usage example in id() DocString
In-Reply-To: <1523995335.26.0.682650639539.issue33300@psf.upfronthosting.co.za>
Message-ID: <1523998325.02.0.682650639539.issue33300@psf.upfronthosting.co.za>


Martin Panter <vadmium+py at gmail.com> added the comment:

It is supposed to be a function signature, similar to the syntax when you define your own function, rather than a usage example of calling the function.

In this case, the slash notation is described by PEP 457. It is supposed to indicate that ?obj? is a positional-only parameter, and not a keyword parameter. If that is what you think is incorrect, perhaps you can suggest a place to explain the notation in Issue 21314.

----------
nosy: +martin.panter
superseder:  -> Document '/' in signatures

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33300>
_______________________________________

From report at bugs.python.org  Tue Apr 17 18:13:48 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Tue, 17 Apr 2018 22:13:48 +0000
Subject: [docs] [issue33297] Mention Pillow package on tkinter.rst to work
 with more image formats
In-Reply-To: <1523963526.08.0.682650639539.issue33297@psf.upfronthosting.co.za>
Message-ID: <1524003228.39.0.262363346258.issue33297@psf.upfronthosting.co.za>


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


----------
nosy: +serhiy.storchaka, terry.reedy

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33297>
_______________________________________

From dingkewen0 at gmail.com  Fri Apr 13 21:31:54 2018
From: dingkewen0 at gmail.com (dingkewen0)
Date: Sat, 14 Apr 2018 11:31:54 +1000
Subject: [docs] Contributing to Python's documentation
Message-ID: <12253DE2-5AAF-4309-9C3D-F2CBB3E88F17@gmail.com>

An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180414/fb2df8c4/attachment.html>

From krishnandoss08 at gmail.com  Wed Apr 18 05:36:51 2018
From: krishnandoss08 at gmail.com (Thulsi Doss Krishnan)
Date: Wed, 18 Apr 2018 15:06:51 +0530
Subject: [docs] Fwd:
In-Reply-To: <CAAGZ4tfeCVy7=63oKp0dpOihq6kLULfP93Uo70qfA91VULHvsA@mail.gmail.com>
References: <CAAGZ4tfeCVy7=63oKp0dpOihq6kLULfP93Uo70qfA91VULHvsA@mail.gmail.com>
Message-ID: <CAAGZ4td5BSjYKyAxzb=JfWx4YYudUj87pytmcM4qgQHBQA5CkQ@mail.gmail.com>

---------- Forwarded message ----------
From: Thulsi Doss Krishnan <krishnandoss08 at gmail.com>
Date: Wed, Apr 18, 2018 at 3:05 PM
Subject:
To: Thulsi Doss Krishnan <krishnandoss08 at gmail.com>


Dear Volunteer ,
Greetings. This is behavior that i noticed in python 3.6.5 . The end
parameter does not work in print command.
C:\WINDOWS\system32>python
Python 3.6.0 |Anaconda 4.3.1 (64-bit)| (default, Dec 23 2016, 11:57:41)
[MSC v.1900 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.

I would expect that Cheese Burger to be printed on the console where as it
does not

Thx
K.Thulsi
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180418/8844dbc6/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: py3.6.5_error.JPG
Type: image/jpeg
Size: 19697 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20180418/8844dbc6/attachment-0001.jpe>

From lincolnkilby at gmail.com  Mon Apr 16 22:52:25 2018
From: lincolnkilby at gmail.com (Lincoln Kilby)
Date: Mon, 16 Apr 2018 22:52:25 -0400
Subject: [docs] Error on: 3. An Informal Introduction to Python
Message-ID: <5ad5616b.d085a70a.cf740.d59b@mx.google.com>

To whom it may concern,

In the last example on the page:

https://docs.python.org/3/tutorial/introduction.html

The last line of output should have ?>>>? (in dark red) appended to it, as the print() function has had the newline overridden with the end keyboard, and should appear like so:

>>> a, b = 0, 1
>>> while b < 1000:
...     print(b, end=',')
...     a, b = b, a+b
...
1,1,2,3,5,8,13,21,34,55,89,144,233,377,610,987,>>>

A brief note explaining why this happens would be instructional, as well.

Thank you,

Lincoln
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180416/21d2077f/attachment.html>

From report at bugs.python.org  Wed Apr 18 13:28:40 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 18 Apr 2018 17:28:40 +0000
Subject: [docs] [issue33283] Mention PNG as a supported image format by
 Tcl/Tk
In-Reply-To: <1523802192.37.0.682650639539.issue33283@psf.upfronthosting.co.za>
Message-ID: <1524072520.61.0.262363346258.issue33283@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +6214

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33283>
_______________________________________

From report at bugs.python.org  Wed Apr 18 14:16:49 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 18 Apr 2018 18:16:49 +0000
Subject: [docs] [issue33283] Mention PNG as a supported image format by
 Tcl/Tk
In-Reply-To: <1523802192.37.0.682650639539.issue33283@psf.upfronthosting.co.za>
Message-ID: <1524075408.95.0.682650639539.issue33283@psf.upfronthosting.co.za>


miss-islington <mariatta.wijaya+miss-islington at gmail.com> added the comment:


New changeset b88f73749db98ed62dbc8fa59480aa62202e25d7 by Miss Islington (bot) in branch '3.7':
bpo-33283: Mention PNG as a supported format by Tcl/Tk. (GH-6479)
https://github.com/python/cpython/commit/b88f73749db98ed62dbc8fa59480aa62202e25d7


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33283>
_______________________________________

From report at bugs.python.org  Wed Apr 18 14:38:33 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 18 Apr 2018 18:38:33 +0000
Subject: [docs] [issue33310] Update references to PIL-style arrays
Message-ID: <1524076713.71.0.682650639539.issue33310@psf.upfronthosting.co.za>


New submission from Serhiy Storchaka <storchaka+cpython at gmail.com>:

The documentation for buffer protocol and memoryview objects contains references to "PIL-style arrays". Since PIL [1] seems dead (it was not ported to Python 3) and superseded by Pillow [2], I think it is worth to update these references. Either rename "PIL-style arrays" to "Pillow-style arrays" or change the wording to more general.

[1] http://www.pythonware.com/products/pil/
[2] http://python-pillow.org/

----------
assignee: docs at python
components: Documentation
messages: 315458
nosy: docs at python, pitrou, serhiy.storchaka, skrah
priority: normal
severity: normal
status: open
title: Update references to PIL-style arrays
type: enhancement
versions: Python 3.6, Python 3.7, Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33310>
_______________________________________

From report at bugs.python.org  Wed Apr 18 14:55:49 2018
From: report at bugs.python.org (Stefan Krah)
Date: Wed, 18 Apr 2018 18:55:49 +0000
Subject: [docs] [issue33310] Update references to PIL-style arrays
In-Reply-To: <1524076713.71.0.682650639539.issue33310@psf.upfronthosting.co.za>
Message-ID: <1524077749.51.0.682650639539.issue33310@psf.upfronthosting.co.za>


Stefan Krah <stefan at bytereef.org> added the comment:

I guess I don't really see much of an issue: The first link for "PIL Python" goes Pillow page and since Pillow is just a fork, the technical term is IMHO "PIL-style".

I like to give credit to original authors.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33310>
_______________________________________

From report at bugs.python.org  Wed Apr 18 14:59:27 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 18 Apr 2018 18:59:27 +0000
Subject: [docs] [issue33310] Update references to PIL-style arrays
In-Reply-To: <1524076713.71.0.682650639539.issue33310@psf.upfronthosting.co.za>
Message-ID: <1524077967.05.0.682650639539.issue33310@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:

Indeed, the name of the top-level package is PIL in Pillow.

Unless you want to rewrite the wording or add links I think this issue can be closed.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33310>
_______________________________________

From report at bugs.python.org  Wed Apr 18 15:08:33 2018
From: report at bugs.python.org (Stefan Krah)
Date: Wed, 18 Apr 2018 19:08:33 +0000
Subject: [docs] [issue33310] Update references to PIL-style arrays
In-Reply-To: <1524076713.71.0.682650639539.issue33310@psf.upfronthosting.co.za>
Message-ID: <1524078513.93.0.682650639539.issue33310@psf.upfronthosting.co.za>


Stefan Krah <stefan at bytereef.org> added the comment:

I think I want to leave it as is.  Probably no one is using suboffsets anyway. :-)

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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33310>
_______________________________________

From report at bugs.python.org  Wed Apr 18 15:17:00 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 18 Apr 2018 19:17:00 +0000
Subject: [docs] [issue33310] Update references to PIL-style arrays
In-Reply-To: <1524076713.71.0.682650639539.issue33310@psf.upfronthosting.co.za>
Message-ID: <1524079020.32.0.682650639539.issue33310@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:

Thanks.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33310>
_______________________________________

From report at bugs.python.org  Thu Apr 19 06:13:59 2018
From: report at bugs.python.org (Joachim Wagner)
Date: Thu, 19 Apr 2018 10:13:59 +0000
Subject: [docs] [issue24318] Better documentaiton of profile-opt (and
 release builds in general?)
In-Reply-To: <1432830865.51.0.995414707141.issue24318@psf.upfronthosting.co.za>
Message-ID: <1524132839.89.0.682650639539.issue24318@psf.upfronthosting.co.za>


Joachim Wagner <jwagner at computing.dcu.ie> added the comment:

The readme in 3.6.5 has a section on PGO but the sentence "If ran,
``make profile-opt`` will do several steps." can be misunderstood that one has to run this command instead of "make" after "configure --enable-optimizations". Furthermore, a 2015 post suggests that most Linux distributions use a different workload than the one provided for much better results. The readme should talk about this, either clarifying that this issue has been resolved or making recommendations for the workload. (I understand that licence incompatibilities or the size of the workload may be reasons for not including the recommended workload in the source distribution.)

----------
nosy: +jwagner

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue24318>
_______________________________________

From report at bugs.python.org  Thu Apr 19 11:44:21 2018
From: report at bugs.python.org (Gregory P. Smith)
Date: Thu, 19 Apr 2018 15:44:21 +0000
Subject: [docs] [issue24318] Better documentaiton of profile-opt (and
 release builds in general?)
In-Reply-To: <1432830865.51.0.995414707141.issue24318@psf.upfronthosting.co.za>
Message-ID: <1524152661.03.0.262363346258.issue24318@psf.upfronthosting.co.za>


Change by Gregory P. Smith <greg at krypto.org>:


----------
pull_requests: +6234
stage: needs patch -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue24318>
_______________________________________

From report at bugs.python.org  Thu Apr 19 11:47:36 2018
From: report at bugs.python.org (Gregory P. Smith)
Date: Thu, 19 Apr 2018 15:47:36 +0000
Subject: [docs] [issue24318] Better documentaiton of profile-opt (and
 release builds in general?)
In-Reply-To: <1432830865.51.0.995414707141.issue24318@psf.upfronthosting.co.za>
Message-ID: <1524152856.5.0.682650639539.issue24318@psf.upfronthosting.co.za>


Gregory P. Smith <greg at krypto.org> added the comment:

FYI - The test suite minus some of the crazier tests (multiprocessing) that the makefile uses today is the recommended workload and is effectively what linux distros I've looked at use.

It is a myth that the specific application workload matters a great deal for building a Python PGO interpreter.  The layer of indirection provided by an interpreter makes it easier.  All you really need is code that exercises the major important C speed paths.  The eval loop, unicode internals, long bignum internals, marshal, re, pickle, json, xml, and cdecimal are all well exercised by running the test suite.

A specific Python application's actual logic is not going to exercise the internals of those in a meaningfully different manner.

Performance experiments bear this out.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue24318>
_______________________________________

From report at bugs.python.org  Thu Apr 19 12:14:10 2018
From: report at bugs.python.org (miss-islington)
Date: Thu, 19 Apr 2018 16:14:10 +0000
Subject: [docs] [issue24318] Better documentaiton of profile-opt (and
 release builds in general?)
In-Reply-To: <1432830865.51.0.995414707141.issue24318@psf.upfronthosting.co.za>
Message-ID: <1524154450.05.0.262363346258.issue24318@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +6235

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue24318>
_______________________________________

From report at bugs.python.org  Thu Apr 19 12:15:29 2018
From: report at bugs.python.org (miss-islington)
Date: Thu, 19 Apr 2018 16:15:29 +0000
Subject: [docs] [issue24318] Better documentaiton of profile-opt (and
 release builds in general?)
In-Reply-To: <1432830865.51.0.995414707141.issue24318@psf.upfronthosting.co.za>
Message-ID: <1524154529.09.0.262363346258.issue24318@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +6236

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue24318>
_______________________________________

From report at bugs.python.org  Thu Apr 19 21:51:56 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Fri, 20 Apr 2018 01:51:56 +0000
Subject: [docs] [issue33283] Mention PNG as a supported image format by
 Tcl/Tk
In-Reply-To: <1523802192.37.0.682650639539.issue33283@psf.upfronthosting.co.za>
Message-ID: <1524189116.25.0.262363346258.issue33283@psf.upfronthosting.co.za>


Change by Andr?s Delfino <adelfino at gmail.com>:


----------
pull_requests: +6238

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33283>
_______________________________________

From report at bugs.python.org  Fri Apr 20 02:15:04 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 20 Apr 2018 06:15:04 +0000
Subject: [docs] [issue33283] Mention PNG as a supported image format by
 Tcl/Tk
In-Reply-To: <1523802192.37.0.682650639539.issue33283@psf.upfronthosting.co.za>
Message-ID: <1524204904.09.0.682650639539.issue33283@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:


New changeset 7a45eb9efb6fffdb4051d1f62b3af4f50c083bf1 by Serhiy Storchaka (Andr?s Delfino) in branch '2.7':
bpo-33283: Mention PNG as a supported format by Tcl/Tk. (GH-6479) (GH-6542)
https://github.com/python/cpython/commit/7a45eb9efb6fffdb4051d1f62b3af4f50c083bf1


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33283>
_______________________________________

From report at bugs.python.org  Fri Apr 20 02:15:43 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 20 Apr 2018 06:15:43 +0000
Subject: [docs] [issue33283] Mention PNG as a supported image format by
 Tcl/Tk
In-Reply-To: <1523802192.37.0.682650639539.issue33283@psf.upfronthosting.co.za>
Message-ID: <1524204943.18.0.262363346258.issue33283@psf.upfronthosting.co.za>


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


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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33283>
_______________________________________

From jrenouard.ext at orange.com  Fri Apr 20 06:06:57 2018
From: jrenouard.ext at orange.com (jrenouard.ext at orange.com)
Date: Fri, 20 Apr 2018 10:06:57 +0000
Subject: [docs] Access French documnetation
Message-ID: <12928_1524218817_5AD9BBC1_12928_297_9_A396413C2496B046ABD0D30BF9A074BD05F8EF56@OPEXCLILM34.corporate.adroot.infra.ftgroup>

Hi Dear Doc Team,

Access to download archive for french documentation is not working anymore.
Links are broken.
https://docs.python.org/fr/3/download.html

For example:
https://docs.python.org/fr/3/archives/python-3.6.5-docs-html.zip
Result:
404 Not Found
________________________________
nginx




[logo Orange]<http://www.orange.com/>

Jean Marie Renouard
SGDB expert from  ATOS
ORANGE/IMT/OINIS/ITE/ECV/SGBD-WAS
t?l. +33 1 61 38 43 02 / +33 2 23 06 68 25 (lundi)
mob. +33 6 62 69 58 81
jrenouard.ext at orange.com
http://shp.itn.ftgroup/sites/eco/sgbd-was/default.aspx
http://shp.itn.ftgroup/sites/eco/sgbd-was/SitePages/MySQL.aspx
[oinis]


_________________________________________________________________________________________________________________________

Ce message et ses pieces jointes peuvent contenir des informations confidentielles ou privilegiees et ne doivent donc
pas etre diffuses, exploites ou copies sans autorisation. Si vous avez recu ce message par erreur, veuillez le signaler
a l'expediteur et le detruire ainsi que les pieces jointes. Les messages electroniques etant susceptibles d'alteration,
Orange decline toute responsabilite si ce message a ete altere, deforme ou falsifie. Merci.

This message and its attachments may contain confidential or privileged information that may be protected by law;
they should not be distributed, used or copied without authorisation.
If you have received this email in error, please notify the sender and delete this message and its attachments.
As emails may be altered, Orange is not liable for messages that have been modified, changed or falsified.
Thank you.

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180420/17bd578b/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image001.gif
Type: image/gif
Size: 1450 bytes
Desc: image001.gif
URL: <http://mail.python.org/pipermail/docs/attachments/20180420/17bd578b/attachment-0001.gif>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image002.png
Type: image/png
Size: 13209 bytes
Desc: image002.png
URL: <http://mail.python.org/pipermail/docs/attachments/20180420/17bd578b/attachment-0001.png>

From peter.hollandmoritz at gmail.com  Wed Apr 18 12:37:37 2018
From: peter.hollandmoritz at gmail.com (Peter H-M)
Date: Wed, 18 Apr 2018 18:37:37 +0200
Subject: [docs] strange Libary bug
Message-ID: <CALkxJQG10SCs8+G6hQcFTSQjAnQ0aZ87fW5AApqjYFNTi-OhjQ@mail.gmail.com>

 Hello

I encountered a strange bug wich is reproducable!

How it happend:
1. I had a normal working basic turtle-code wich just draw an coordinate
system
2. I changed nothing but all of the sudden the line "turtle.speed(0)" is
not longer viable and gives this error :

"
Traceback (most recent call last):
  File "C:\My_Projects\my_unit_008.py", line 19, in <module>
    turtle.speed(0)
  File "C:\Python25\lib\lib-tk\turtle.py", line 705, in speed
    def speed(speed): return _getpen().speed(speed)
  File "C:\Python25\lib\lib-tk\turtle.py", line 586, in speed
    "one of %s" % (speed, speeds))
ValueError: 0 is not a valid speed. speed must be one of ['fastest',
'fast', 'normal', 'slow', 'slowest']
"
there seems also something wrong within a libary...

THe strange behaviour:
1. I created a new file with EXACT the same code and it worked perfectly
fine
2. changed nothing and after 2 min i get this Error again
3. Some other file works with the same Code even after many days

I can even have 2 exact same files open but one suddenly get?s this
error.....

I allready checked my Phyton for Errors and even Deinstalled - reinstalled
I found no way to fix anything of this bug.  I hope you can help me :)
VG Peter
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180418/f7f51b0e/attachment.html>

From selah at outlook.com  Wed Apr 18 06:19:25 2018
From: selah at outlook.com (? ??)
Date: Wed, 18 Apr 2018 10:19:25 +0000
Subject: [docs] [bug] bug in example code of queue
Message-ID: <PS1PR0601MB1498369A4407E500D8915A26AFB60@PS1PR0601MB1498.apcprd06.prod.outlook.com>

https://docs.python.org/3.5/library/queue.html
This function will cause q.join() block forever.
```

def worker():

    while True:

        item = q.get()

        if item is None:

++          q.task_done()

            break

        do_work(item)

        q.task_done()
```
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180418/a6775095/attachment.html>

From report at bugs.python.org  Fri Apr 20 09:05:37 2018
From: report at bugs.python.org (=?utf-8?q?Pekka_Kl=C3=A4rck?=)
Date: Fri, 20 Apr 2018 13:05:37 +0000
Subject: [docs] [issue33319] `subprocess.run` documentation doesn't tell is
 using `stdout=PIPE` safe
In-Reply-To: <1524229514.84.0.682650639539.issue33319@psf.upfronthosting.co.za>
Message-ID: <1524229537.49.0.262363346258.issue33319@psf.upfronthosting.co.za>


Change by Pekka Kl?rck <pekka.klarck at gmail.com>:


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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33319>
_______________________________________

From report at bugs.python.org  Fri Apr 20 10:00:14 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Fri, 20 Apr 2018 14:00:14 +0000
Subject: [docs] [issue33264] Remove to-be-deprecated
 urllib.request.urlretrieve function reference from HOWTO
In-Reply-To: <1523487424.62.0.682650639539.issue33264@psf.upfronthosting.co.za>
Message-ID: <1524232814.46.0.682650639539.issue33264@psf.upfronthosting.co.za>


Andr?s Delfino <adelfino at gmail.com> added the comment:

I believe this issue can be closed, right?

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33264>
_______________________________________

From report at bugs.python.org  Fri Apr 20 10:15:01 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Fri, 20 Apr 2018 14:15:01 +0000
Subject: [docs] [issue33320] Clarify who can add the "skip issue" label on
 GitHub
Message-ID: <1524233701.12.0.682650639539.issue33320@psf.upfronthosting.co.za>


New submission from Andr?s Delfino <adelfino at gmail.com>:

IMHO, the wording of https://devguide.python.org/pullrequest/ is somewhat confusing regarding the "skip issue" label.

I thought that I (with no commit access) should add the label, but, as far I understand, that is a responsibility of developers with commit access.

The PR offers a wording to clarify this.

----------
assignee: docs at python
components: Documentation
messages: 315512
nosy: adelfino, docs at python
priority: normal
severity: normal
status: open
title: Clarify who can add the "skip issue" label on GitHub
type: enhancement

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33320>
_______________________________________

From report at bugs.python.org  Fri Apr 20 10:16:56 2018
From: report at bugs.python.org (Senthil Kumaran)
Date: Fri, 20 Apr 2018 14:16:56 +0000
Subject: [docs] [issue33264] Remove to-be-deprecated
 urllib.request.urlretrieve function reference from HOWTO
In-Reply-To: <1523487424.62.0.682650639539.issue33264@psf.upfronthosting.co.za>
Message-ID: <1524233815.96.0.682650639539.issue33264@psf.upfronthosting.co.za>


Senthil Kumaran <senthil at uthcode.com> added the comment:

Indeed. Thank you!

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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33264>
_______________________________________

From report at bugs.python.org  Fri Apr 20 10:18:48 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Fri, 20 Apr 2018 14:18:48 +0000
Subject: [docs] [issue33320] Clarify who can add the "skip issue" label on
 GitHub
In-Reply-To: <1524233701.12.0.682650639539.issue33320@psf.upfronthosting.co.za>
Message-ID: <1524233928.01.0.262363346258.issue33320@psf.upfronthosting.co.za>


Change by Andr?s Delfino <adelfino at gmail.com>:


----------
keywords: +patch
pull_requests: +6242
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33320>
_______________________________________

From report at bugs.python.org  Fri Apr 20 10:19:00 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Fri, 20 Apr 2018 14:19:00 +0000
Subject: [docs] [issue33320] Clarify who can add the "skip issue" label on
 GitHub
In-Reply-To: <1524233701.12.0.682650639539.issue33320@psf.upfronthosting.co.za>
Message-ID: <1524233940.01.0.262363346258.issue33320@psf.upfronthosting.co.za>


Change by Andr?s Delfino <adelfino at gmail.com>:


----------
pull_requests:  -6242

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33320>
_______________________________________

From report at bugs.python.org  Fri Apr 20 10:19:13 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Fri, 20 Apr 2018 14:19:13 +0000
Subject: [docs] [issue33320] Clarify who can add the "skip issue" label on
 GitHub
In-Reply-To: <1524233701.12.0.682650639539.issue33320@psf.upfronthosting.co.za>
Message-ID: <1524233953.11.0.682650639539.issue33320@psf.upfronthosting.co.za>


Andr?s Delfino <adelfino at gmail.com> added the comment:

This is the PR: https://github.com/python/devguide/pull/359

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33320>
_______________________________________

From report at bugs.python.org  Fri Apr 20 11:17:11 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Fri, 20 Apr 2018 15:17:11 +0000
Subject: [docs] [issue33320] Clarify who can add the "skip issue" label on
 GitHub
In-Reply-To: <1524233701.12.0.682650639539.issue33320@psf.upfronthosting.co.za>
Message-ID: <1524237431.38.0.262363346258.issue33320@psf.upfronthosting.co.za>


Change by Andr?s Delfino <adelfino at gmail.com>:


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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33320>
_______________________________________

From report at bugs.python.org  Fri Apr 20 13:08:03 2018
From: report at bugs.python.org (Jakub Wilk)
Date: Fri, 20 Apr 2018 17:08:03 +0000
Subject: [docs] [issue21314] Document '/' in signatures
In-Reply-To: <1397988439.5.0.703056699862.issue21314@psf.upfronthosting.co.za>
Message-ID: <1524244083.32.0.262363346258.issue21314@psf.upfronthosting.co.za>


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


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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue21314>
_______________________________________

From report at bugs.python.org  Fri Apr 20 13:26:03 2018
From: report at bugs.python.org (Josh Rosenberg)
Date: Fri, 20 Apr 2018 17:26:03 +0000
Subject: [docs] [issue33319] `subprocess.run` documentation doesn't tell is
 using `stdout=PIPE` safe
In-Reply-To: <1524229514.84.0.682650639539.issue33319@psf.upfronthosting.co.za>
Message-ID: <1524245163.19.0.682650639539.issue33319@psf.upfronthosting.co.za>


Josh Rosenberg <shadowranger+python at gmail.com> added the comment:

If the goal is just to suppress stdout, that's what passing subprocess.DEVNULL is for (doesn't exist in Py2, but opening os.devnull and passing that is a slightly higher overhead equivalent).

subprocess.run includes a call to communicate as part of its default behavior, and stores its results, so call() isn't quite equivalent to run().returncode when PIPE was passed for standard handles, because call only includes an implicit call to wait, not communicate, and therefore pipes are not explicitly read and can block.

Basically, subprocess.run is deadlock-safe (because it uses communicate, not just wait), but if you don't care about the results, and the results might be huge, don't pass it PIPE for stdout/stderr (because it will store the complete outputs in memory, just like any use of communicate with PIPE).

The docs effectively tell you PIPE is safe; it returns a CompletedProcess object, and explicitly tells you that it has attributes that are (completely) populated based on whether capture was requested. If it had such attributes and still allowed deadlocks, it would definitely merit a warning.

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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33319>
_______________________________________

From report at bugs.python.org  Fri Apr 20 20:36:55 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 21 Apr 2018 00:36:55 +0000
Subject: [docs] [issue33275] glob.glob should explicitly note that results
 aren't sorted
In-Reply-To: <1523644726.46.0.682650639539.issue33275@psf.upfronthosting.co.za>
Message-ID: <1524271015.6.0.682650639539.issue33275@psf.upfronthosting.co.za>


Terry J. Reedy <tjreedy at udel.edu> added the comment:

How about adding a sentence to the end of the first paragraph.

 glob.glob(pathname, *, recursive=False)

    Return a possibly-empty list of path names that match pathname, which must be a string containing a path specification. pathname can be either absolute (like /usr/src/Python-1.5/Makefile) or relative (like ../../Tools/*/*.gif), and can contain shell-style wildcards. Broken symlinks are included in the results (as in the shell).  Whether or not the results are sorted depends on the file system.

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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33275>
_______________________________________

From report at bugs.python.org  Sat Apr 21 05:07:12 2018
From: report at bugs.python.org (Matej Cepl)
Date: Sat, 21 Apr 2018 09:07:12 +0000
Subject: [docs] [issue18280] Documentation is too personalized
In-Reply-To: <1371889714.5.0.753258621658.issue18280@psf.upfronthosting.co.za>
Message-ID: <1524301632.29.0.682650639539.issue18280@psf.upfronthosting.co.za>


Matej Cepl <mcepl at cepl.eu> added the comment:

What about WONTFIX here? I completely agree with rhettinger: this is a waste of time with potential for causing damage.

----------
nosy: +mcepl

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

From report at bugs.python.org  Sat Apr 21 05:14:32 2018
From: report at bugs.python.org (Matej Cepl)
Date: Sat, 21 Apr 2018 09:14:32 +0000
Subject: [docs] [issue24027] IMAP library lacks documentation about expected
 parameter types
In-Reply-To: <1429715983.31.0.608966950375.issue24027@psf.upfronthosting.co.za>
Message-ID: <1524302072.77.0.682650639539.issue24027@psf.upfronthosting.co.za>


Matej Cepl <mcepl at cepl.eu> added the comment:

UTF-7 is tackled in https://bugs.python.org/issue5305

----------
nosy: +mcepl

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue24027>
_______________________________________

From report at bugs.python.org  Sat Apr 21 07:50:02 2018
From: report at bugs.python.org (Alfonso Chavez)
Date: Sat, 21 Apr 2018 11:50:02 +0000
Subject: [docs] [issue33324] Bug in documentation 3.6: string-methods -
 str.center
Message-ID: <1524311402.18.0.682650639539.issue33324@psf.upfronthosting.co.za>


New submission from Alfonso Chavez <alfonsochc at gmail.com>:

Hi. In https://docs.python.org/3/library/stdtypes.html#string-methods says:

str.center(width[, fillchar])

But, I tried in Windows 10 and Ubuntu Server:

>>> var = 'Variable de prueba'
>>> str.center(50, var)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: descriptor 'center' requires a 'str' object but received a 'int'

Then, I tried this:

>>> str.center(var, 50)
'                Variable de prueba                '

I think the documentation should read:
str.center(fillchar[, width])

Version in Windows: Python 3.6.5
Version in Ubuntu Server: Python 3.5.2

----------
assignee: docs at python
components: Documentation
messages: 315562
nosy: Alfonso Chavez, docs at python
priority: normal
severity: normal
status: open
title: Bug in documentation 3.6: string-methods - str.center
type: enhancement
versions: Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33324>
_______________________________________

From report at bugs.python.org  Sat Apr 21 07:55:21 2018
From: report at bugs.python.org (Alfonso Chavez)
Date: Sat, 21 Apr 2018 11:55:21 +0000
Subject: [docs] [issue33324] Bug in documentation 3.6: string-methods -
 str.center
In-Reply-To: <1524311402.18.0.682650639539.issue33324@psf.upfronthosting.co.za>
Message-ID: <1524311721.14.0.262363346258.issue33324@psf.upfronthosting.co.za>


Change by Alfonso Chavez <alfonsochc at gmail.com>:


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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33324>
_______________________________________

From report at bugs.python.org  Sat Apr 21 08:17:32 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 21 Apr 2018 12:17:32 +0000
Subject: [docs] [issue33297] Mention Pillow package on tkinter.rst to work
 with more image formats
In-Reply-To: <1523963526.08.0.682650639539.issue33297@psf.upfronthosting.co.za>
Message-ID: <1524313052.09.0.682650639539.issue33297@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:


New changeset b81ca28b378c8b29204a37f8bd433a3379f53f7d by Serhiy Storchaka (Andr?s Delfino) in branch 'master':
bpo-33297: Mention Pillow to work with more image formats. (#6505)
https://github.com/python/cpython/commit/b81ca28b378c8b29204a37f8bd433a3379f53f7d


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33297>
_______________________________________

From report at bugs.python.org  Sat Apr 21 08:17:47 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 21 Apr 2018 12:17:47 +0000
Subject: [docs] [issue33297] Mention Pillow package on tkinter.rst to work
 with more image formats
In-Reply-To: <1523963526.08.0.682650639539.issue33297@psf.upfronthosting.co.za>
Message-ID: <1524313067.43.0.262363346258.issue33297@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +6255

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33297>
_______________________________________

From report at bugs.python.org  Sat Apr 21 08:18:36 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 21 Apr 2018 12:18:36 +0000
Subject: [docs] [issue33297] Mention Pillow package on tkinter.rst to work
 with more image formats
In-Reply-To: <1523963526.08.0.682650639539.issue33297@psf.upfronthosting.co.za>
Message-ID: <1524313116.08.0.262363346258.issue33297@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +6256

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33297>
_______________________________________

From report at bugs.python.org  Sat Apr 21 09:03:58 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 21 Apr 2018 13:03:58 +0000
Subject: [docs] [issue33297] Mention Pillow package on tkinter.rst to work
 with more image formats
In-Reply-To: <1523963526.08.0.682650639539.issue33297@psf.upfronthosting.co.za>
Message-ID: <1524315838.65.0.682650639539.issue33297@psf.upfronthosting.co.za>


miss-islington <mariatta.wijaya+miss-islington at gmail.com> added the comment:


New changeset f9005030fee6af333fada014da3eb0144078779f by Miss Islington (bot) in branch '3.7':
bpo-33297: Mention Pillow to work with more image formats. (GH-6505)
https://github.com/python/cpython/commit/f9005030fee6af333fada014da3eb0144078779f


----------
nosy: +miss-islington

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33297>
_______________________________________

From report at bugs.python.org  Sat Apr 21 09:04:10 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 21 Apr 2018 13:04:10 +0000
Subject: [docs] [issue33297] Mention Pillow package on tkinter.rst to work
 with more image formats
In-Reply-To: <1523963526.08.0.682650639539.issue33297@psf.upfronthosting.co.za>
Message-ID: <1524315850.61.0.682650639539.issue33297@psf.upfronthosting.co.za>


miss-islington <mariatta.wijaya+miss-islington at gmail.com> added the comment:


New changeset 5c0a8bb1c2c8d77c4b2d5002259d08fe6a277b40 by Miss Islington (bot) in branch '3.6':
bpo-33297: Mention Pillow to work with more image formats. (GH-6505)
https://github.com/python/cpython/commit/5c0a8bb1c2c8d77c4b2d5002259d08fe6a277b40


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33297>
_______________________________________

From report at bugs.python.org  Sat Apr 21 09:05:33 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Sat, 21 Apr 2018 13:05:33 +0000
Subject: [docs] [issue33297] Mention Pillow package on tkinter.rst to work
 with more image formats
In-Reply-To: <1523963526.08.0.682650639539.issue33297@psf.upfronthosting.co.za>
Message-ID: <1524315933.93.0.682650639539.issue33297@psf.upfronthosting.co.za>


Andr?s Delfino <adelfino at gmail.com> added the comment:

Currently cherry picking the commit for 2.7.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33297>
_______________________________________

From report at bugs.python.org  Sat Apr 21 10:06:39 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Sat, 21 Apr 2018 14:06:39 +0000
Subject: [docs] [issue33297] Mention Pillow package on tkinter.rst to work
 with more image formats
In-Reply-To: <1523963526.08.0.682650639539.issue33297@psf.upfronthosting.co.za>
Message-ID: <1524319599.58.0.262363346258.issue33297@psf.upfronthosting.co.za>


Change by Andr?s Delfino <adelfino at gmail.com>:


----------
pull_requests: +6257

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33297>
_______________________________________

From report at bugs.python.org  Sat Apr 21 12:06:49 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 21 Apr 2018 16:06:49 +0000
Subject: [docs] [issue33297] Mention Pillow package on tkinter.rst to work
 with more image formats
In-Reply-To: <1523963526.08.0.682650639539.issue33297@psf.upfronthosting.co.za>
Message-ID: <1524326809.02.0.682650639539.issue33297@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:


New changeset b9827b762093f2b295934bed755b4de0049b1f15 by Serhiy Storchaka (Andr?s Delfino) in branch '2.7':
[2.7] bpo-33297: Mention Pillow to work with more image formats. (GH-6505) (GH-6562)
https://github.com/python/cpython/commit/b9827b762093f2b295934bed755b4de0049b1f15


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33297>
_______________________________________

From report at bugs.python.org  Sat Apr 21 12:08:06 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 21 Apr 2018 16:08:06 +0000
Subject: [docs] [issue33297] Mention Pillow package on tkinter.rst to work
 with more image formats
In-Reply-To: <1523963526.08.0.682650639539.issue33297@psf.upfronthosting.co.za>
Message-ID: <1524326886.13.0.262363346258.issue33297@psf.upfronthosting.co.za>


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


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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33297>
_______________________________________

From report at bugs.python.org  Sun Apr 22 06:55:42 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 22 Apr 2018 10:55:42 +0000
Subject: [docs] [issue24024] str.__doc__ needs an update
In-Reply-To: <1429708426.75.0.208318155296.issue24024@psf.upfronthosting.co.za>
Message-ID: <1524394542.2.0.262363346258.issue24024@psf.upfronthosting.co.za>


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


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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue24024>
_______________________________________

From report at bugs.python.org  Sun Apr 22 07:00:54 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 22 Apr 2018 11:00:54 +0000
Subject: [docs] [issue25205] setattr accepts invalid identifiers
In-Reply-To: <1442861960.51.0.201067879836.issue25205@psf.upfronthosting.co.za>
Message-ID: <1524394854.42.0.262363346258.issue25205@psf.upfronthosting.co.za>


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


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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue25205>
_______________________________________

From report at bugs.python.org  Sun Apr 22 13:30:40 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Sun, 22 Apr 2018 17:30:40 +0000
Subject: [docs] [issue33280] Update link to Tcl/Tk 8.6 man pages in
 tkinter.rst
In-Reply-To: <1523736762.33.0.682650639539.issue33280@psf.upfronthosting.co.za>
Message-ID: <1524418240.22.0.682650639539.issue33280@psf.upfronthosting.co.za>


Andr?s Delfino <adelfino at gmail.com> added the comment:

I have updated the PR:

* Now we mention that python -m tkinter shows the installed Tcl/Tk version so users can read the right man pages.

* Only mention the link to documentation page (sadly, there doesn't seem to exist an "Archived man pages", and mentioning 8.5/8.4 man pages doesn't seem right).

* I have merged the two "See also" sections of the page, separating Tkinter-specific documentation from Tcl/Tk general documentation.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33280>
_______________________________________

From report at bugs.python.org  Sun Apr 22 18:05:28 2018
From: report at bugs.python.org (Chris Bradbury)
Date: Sun, 22 Apr 2018 22:05:28 +0000
Subject: [docs] [issue33333] ConfigParser.items returns items present in
 `DEFAULTSECT` when section argument given.
In-Reply-To: <1524396036.58.0.682650639539.issue33333@psf.upfronthosting.co.za>
Message-ID: <1524434728.77.0.262363346258.issue33333@psf.upfronthosting.co.za>


Change by Chris Bradbury <viff3000 at gmail.com>:


----------
assignee:  -> docs at python
components: +Documentation -Library (Lib)
nosy: +docs at python
resolution: not a bug -> 
status: closed -> open

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33333>
_______________________________________

From report at bugs.python.org  Mon Apr 23 04:23:44 2018
From: report at bugs.python.org (=?utf-8?q?Pekka_Kl=C3=A4rck?=)
Date: Mon, 23 Apr 2018 08:23:44 +0000
Subject: [docs] [issue33319] `subprocess.run` documentation doesn't tell is
 using `stdout=PIPE` safe
In-Reply-To: <1524229514.84.0.682650639539.issue33319@psf.upfronthosting.co.za>
Message-ID: <1524471824.82.0.682650639539.issue33319@psf.upfronthosting.co.za>


Pekka Kl?rck <pekka.klarck at gmail.com> added the comment:

My goal is to read stdout. It's good to hear `subprocess.run()` is deadlock-safe and I can use it safely. Making the docs explicit about it so that others know it's safe would in my opinion be a good idea as well.

Casual users don't know `run()` it uses `communicate()`, not `wait()`, internally, or even that this would mean it cannot deadlock. The current situation when the docs say that `call()` shouldn't be used with `stdout=PIPE` and that `call(...)` is equivalent to `run(...).returncode` indicates `stdout=PIPE` is unsafe with `run()` as well.

A separate questions is that if `call(...)` is equivalent to `run(...).returncode`, should it also be implemented that way. Based on this discussion it would avoid the problem with `stdout=PIPE` also in that case.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33319>
_______________________________________

From report at bugs.python.org  Mon Apr 23 05:51:36 2018
From: report at bugs.python.org (sam_b)
Date: Mon, 23 Apr 2018 09:51:36 +0000
Subject: [docs] [issue33340] Inaccurate docs on `import` behaviour
Message-ID: <1524477096.11.0.682650639539.issue33340@psf.upfronthosting.co.za>


New submission from sam_b <sam at sambrown.eu>:

The docs https://docs.python.org/3/tutorial/modules.html#the-module-search-path describe:

> When a module named spam is imported, the interpreter first searches for a built-in module with that name. If not found, it then searches for a file named spam.py in a list of directories given by the variable sys.path. sys.path is initialized from these locations:

> -   The directory containing the input script (or the current directory when no file is specified).
> -   PYTHONPATH (a list of directory names, with the same syntax as the shell variable PATH).
> -   The installation-dependent default.


However, it seems like "the directory containing the input script" is checked *before* the standard library:

?  tmp more logging.py
def foo():
    print('bar')
?  tmp python
Python 2.7.15rc1 (default, Apr 15 2018, 21:51:34)
[GCC 7.3.0] on linux2
Type "help", "copyright", "credits" or "license" for more information.
>>> import logging
>>> logging.foo()
bar
>>> logging.WARNING
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
AttributeError: 'module' object has no attribute 'WARNING'
>>> 


Am I misunderstanding the docs?

----------
assignee: docs at python
components: Documentation
messages: 315653
nosy: docs at python, sam_b
priority: normal
severity: normal
status: open
title: Inaccurate docs on `import` behaviour
type: behavior
versions: Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33340>
_______________________________________

From report at bugs.python.org  Mon Apr 23 06:08:14 2018
From: report at bugs.python.org (Eric V. Smith)
Date: Mon, 23 Apr 2018 10:08:14 +0000
Subject: [docs] [issue33340] Inaccurate docs on `import` behaviour
In-Reply-To: <1524477096.11.0.682650639539.issue33340@psf.upfronthosting.co.za>
Message-ID: <1524478093.99.0.682650639539.issue33340@psf.upfronthosting.co.za>


Eric V. Smith <eric at trueblade.com> added the comment:

"built-in modules" has the specific meaning of modules that are compiled in to the python executable. It doesn't mean modules in the standard library.

See https://docs.python.org/3.6/library/sys.html#sys.builtin_module_names

Python 3.6.4 (default, Jan  7 2018, 15:53:53)
[GCC 6.4.0] on cygwin
Type "help", "copyright", "credits" or "license" for more information.
>>> import sys
>>> sys.builtin_module_names
('_ast', '_codecs', '_collections', '_functools', '_imp', '_io', '_locale', '_operator', '_signal', '_sre', '_stat', '_string', '_symtable', '_thread', '_tracemalloc', '_warnings', '_weakref', 'atexit', 'builtins', 'errno', 'faulthandler', 'gc', 'itertools', 'marshal', 'posix', 'pwd', 'sys', 'time', 'xxsubtype', 'zipimport')

----------
nosy: +eric.smith

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33340>
_______________________________________

From report at bugs.python.org  Mon Apr 23 06:27:58 2018
From: report at bugs.python.org (sam_b)
Date: Mon, 23 Apr 2018 10:27:58 +0000
Subject: [docs] [issue33340] Inaccurate docs on `import` behaviour
In-Reply-To: <1524477096.11.0.682650639539.issue33340@psf.upfronthosting.co.za>
Message-ID: <1524479278.03.0.682650639539.issue33340@psf.upfronthosting.co.za>


sam_b <sam at sambrown.eu> added the comment:

Thanks, I thought it might be something like that. Would it be worth clarifying the distinction in the docs? It was certainly surprising to me that `import time` and `import logging` behave differently.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33340>
_______________________________________

From report at bugs.python.org  Mon Apr 23 06:30:32 2018
From: report at bugs.python.org (Eric V. Smith)
Date: Mon, 23 Apr 2018 10:30:32 +0000
Subject: [docs] [issue33340] Inaccurate docs on `import` behaviour
In-Reply-To: <1524477096.11.0.682650639539.issue33340@psf.upfronthosting.co.za>
Message-ID: <1524479432.37.0.682650639539.issue33340@psf.upfronthosting.co.za>


Eric V. Smith <eric at trueblade.com> added the comment:

If you have a suggested improvement, please create a pull request. Thanks!

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33340>
_______________________________________

From report at bugs.python.org  Tue Apr 24 03:44:04 2018
From: report at bugs.python.org (Steve Piercy)
Date: Tue, 24 Apr 2018 07:44:04 +0000
Subject: [docs] [issue33345] Documentation for PowerShell instructions
Message-ID: <1524555844.08.0.682650639539.issue33345@psf.upfronthosting.co.za>


New submission from Steve Piercy <web at stevepiercy.com>:

Effective 2017-11-20, PowerShell is now the default command shell on Windows 10, and possibly other versions.  Command Prompt (cmd.exe) is still present, just no longer the default.

https://support.microsoft.com/en-us/help/4027690/windows-powershell-is-replacing-command-prompt

Current instructions for installing and configuring Python on Windows reference only Command Prompt.  There may be other places.

https://docs.python.org/3/using/windows.html#configuring-python

FYI, we're in the process of updating our documentation for Pyramid where we have both PowerShell and Command Prompt.  At some point in the future, we may drop the latter.

https://github.com/Pylons/pyramid/issues/3260

Let me know what y'all think is the best way to proceed, even if that is no action.

----------
assignee: docs at python
components: Documentation
messages: 315690
nosy: docs at python, stevepiercy
priority: normal
severity: normal
status: open
title: Documentation for PowerShell instructions
type: enhancement
versions: Python 3.6, Python 3.7, Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33345>
_______________________________________

From report at bugs.python.org  Tue Apr 24 04:42:35 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 24 Apr 2018 08:42:35 +0000
Subject: [docs] [issue33345] Documentation for PowerShell instructions
In-Reply-To: <1524555844.08.0.682650639539.issue33345@psf.upfronthosting.co.za>
Message-ID: <1524559355.93.0.262363346258.issue33345@psf.upfronthosting.co.za>


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


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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33345>
_______________________________________

From amitesh.sahay at yahoo.com  Tue Apr 24 07:06:18 2018
From: amitesh.sahay at yahoo.com (Amitesh Sahay)
Date: Tue, 24 Apr 2018 11:06:18 +0000 (UTC)
Subject: [docs] reg: Bug with python module "Pattern"
References: <1811281765.333131.1524567978793.ref@mail.yahoo.com>
Message-ID: <1811281765.333131.1524567978793@mail.yahoo.com>

Hello Team,?
I am not sure if I have reached a right DL to register my observation. However, I will share my observation
I was installing python module "pattern" through pip, and at the end it throws error as below::
=====================Collecting pattern? Using cached https://files.pythonhosted.org/packages/bf/50/d09941d53416f2a86676bd0dc341d5968b599a763b73f5d13f51c57b5641/pattern-2.6.zip? ? Complete output from command python setup.py egg_info:? ? Traceback (most recent call last):? ? ? File "<string>", line 1, in <module>? ? ? File "C:\Users\AMITES~1\AppData\Local\Temp\pip-install-e_magdqz\pattern\setup.py", line 40? ? ? ? print n? ? ? ? ? ? ? ^? ? SyntaxError: Missing parentheses in call to 'print'=======================
This is happening both on Windows as well as on Linux. I guess the author of this module was trying to make some changes and forgot to put parentheses or something.


Regards,
Amitesh Sahay91-750 797 8619
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180424/2eaf452e/attachment.html>

From bgibbeme at us.ibm.com  Mon Apr 23 15:35:22 2018
From: bgibbeme at us.ibm.com (Brian Gibbemeyer)
Date: Mon, 23 Apr 2018 19:35:22 +0000
Subject: [docs] Issue with python365.chm on window 7
Message-ID: <OF5D323BAD.36DE33A3-ON85258278.006B476E-85258278.006B9BC5@notes.na.collabserv.com>

Not sure which email this should go to.

But I downloaded .chm version of the Python guide and found that it is not 
working in windows 7






Thank you,

Brian Gibbemeyer
Sr Software Engineer
Watson Health - Value Based Care


Phone: 1-7349133594 | Mobile: 1-7347258319
E-mail: bgibbeme at us.ibm.com


100 Phoenix Dr
Ann Arbor, MI 48108-2202
United States


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180423/46fc5425/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: image/gif
Size: 44922 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20180423/46fc5425/attachment-0001.gif>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: image/jpeg
Size: 2874 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20180423/46fc5425/attachment-0001.jpe>

From bgibbeme at us.ibm.com  Mon Apr 23 17:38:30 2018
From: bgibbeme at us.ibm.com (Brian Gibbemeyer)
Date: Mon, 23 Apr 2018 21:38:30 +0000
Subject: [docs] Issue with python365.chm on window 7
In-Reply-To: <OF5D323BAD.36DE33A3-ON85258278.006B476E-85258278.006B9B53@LocalDomain>
References: <OF5D323BAD.36DE33A3-ON85258278.006B476E-85258278.006B9B53@LocalDomain>
Message-ID: <OF85D386E4.E3EDAAA4-ON85258278.0076D40C-85258278.0076E199@notes.na.collabserv.com>

From:   Brian Gibbemeyer/Detroit/IBM
To:     python-list at python.org, docs at python.org
Date:   04/23/2018 03:35 PM
Subject:        Issue with python365.chm on window 7


Not sure which email this should go to.

But I downloaded .chm version of the Python guide and found that it is not 
working in windows 7






Thank you,

Brian Gibbemeyer
Sr Software Engineer
Watson Health - Value Based Care


Phone: 1-7349133594 | Mobile: 1-7347258319
E-mail: bgibbeme at us.ibm.com


100 Phoenix Dr
Ann Arbor, MI 48108-2202
United States




-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180423/21c1f901/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: image/gif
Size: 44922 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20180423/21c1f901/attachment-0001.gif>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: image/jpeg
Size: 2874 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20180423/21c1f901/attachment-0001.jpe>

From kaw130 at eng.ucsd.edu  Mon Apr 23 15:13:25 2018
From: kaw130 at eng.ucsd.edu (Kaiwen Wu)
Date: Mon, 23 Apr 2018 12:13:25 -0700
Subject: [docs] Python 3.5.3 'NoneType' object has no attribute 'isatty'
Message-ID: <CAMzvxVsKgAg1Ad8_dMgkRssi8kOJUJyMMzNs8BBkvtSKWr=tqg@mail.gmail.com>

Dear maintenance,

Exception ignored in: <_io.TextIOWrapper name='<stdout>' mode='w'
> encoding='cp936'>
> OSError: [Errno 22] Invalid argument
> Traceback (most recent call last):
>   File "<some-path>.py", line 88, in <module>
>     main()
>   File "<some-path>.py", line 75, in main
>     if not len(args.filenames) and not sys.stdin.isatty():
> AttributeError: 'NoneType' object has no attribute 'isatty'


I have never set `sys.stdin` to None. It happens occasionally when I pipe
output from another program to the Python script. For example, when I do

some-program | this-script


It raises this error. And when I do it again, it does not raise.

Thanks for your attention!

----------------
Yours sincerely,
Kaiwen Wu
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180423/fc993e4f/attachment.html>

From report at bugs.python.org  Tue Apr 24 09:34:46 2018
From: report at bugs.python.org (Elena Oat)
Date: Tue, 24 Apr 2018 13:34:46 +0000
Subject: [docs] [issue33275] glob.glob should explicitly note that results
 aren't sorted
In-Reply-To: <1523644726.46.0.682650639539.issue33275@psf.upfronthosting.co.za>
Message-ID: <1524576886.44.0.262363346258.issue33275@psf.upfronthosting.co.za>


Change by Elena Oat <oat.elena at gmail.com>:


----------
keywords: +patch
pull_requests: +6287
stage: needs patch -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33275>
_______________________________________

From report at bugs.python.org  Tue Apr 24 09:41:32 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 24 Apr 2018 13:41:32 +0000
Subject: [docs] [issue33275] glob.glob should explicitly note that results
 aren't sorted
In-Reply-To: <1523644726.46.0.682650639539.issue33275@psf.upfronthosting.co.za>
Message-ID: <1524577292.8.0.682650639539.issue33275@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:

Are there such notes in the descriptions of os.listdir(), os.scandir(), os.walk(), os.fwalk() and corresponding Path methods? If explicitly document the sorting, this should be made for all files enumerating functions.

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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33275>
_______________________________________

From report at bugs.python.org  Tue Apr 24 10:15:41 2018
From: report at bugs.python.org (Ben FrantzDale)
Date: Tue, 24 Apr 2018 14:15:41 +0000
Subject: [docs] [issue33275] glob.glob should explicitly note that results
 aren't sorted
In-Reply-To: <1524577292.8.0.682650639539.issue33275@psf.upfronthosting.co.za>
Message-ID: <CACJ_BKdaZQnLByOB2rJjD-cJQdi1JUW5iW_HgYJV3gcnX24muA@mail.gmail.com>


Ben FrantzDale <ben at formlabs.com> added the comment:

Great point. Looks like the phrase is "in arbitrary order" in the docs for
those (both 2.7 and 3), which is better than saying nothing. I'd still
prefer a bit more specificity about the potential gotcha since "arbitrary"
seems a lot less deterministic than "some file systems will give you sorted
order, some won't".

On Tue, Apr 24, 2018 at 9:41 AM, Serhiy Storchaka <report at bugs.python.org>
wrote:

>
> Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:
>
> Are there such notes in the descriptions of os.listdir(), os.scandir(),
> os.walk(), os.fwalk() and corresponding Path methods? If explicitly
> document the sorting, this should be made for all files enumerating
> functions.
>
> ----------
> nosy: +serhiy.storchaka
>
> _______________________________________
> Python tracker <report at bugs.python.org>
> <https://bugs.python.org/issue33275>
> _______________________________________
>

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33275>
_______________________________________

From report at bugs.python.org  Tue Apr 24 11:42:32 2018
From: report at bugs.python.org (Elena Oat)
Date: Tue, 24 Apr 2018 15:42:32 +0000
Subject: [docs] [issue24356] venv documentation incorrect / misleading
In-Reply-To: <1433197293.5.0.203233804739.issue24356@psf.upfronthosting.co.za>
Message-ID: <1524584552.09.0.262363346258.issue24356@psf.upfronthosting.co.za>


Change by Elena Oat <oat.elena at gmail.com>:


----------
keywords: +patch
pull_requests: +6289
stage: needs patch -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue24356>
_______________________________________

From report at bugs.python.org  Tue Apr 24 13:35:31 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Tue, 24 Apr 2018 17:35:31 +0000
Subject: [docs] [issue33275] glob.glob should explicitly note that results
 aren't sorted
In-Reply-To: <1523644726.46.0.682650639539.issue33275@psf.upfronthosting.co.za>
Message-ID: <1524591331.22.0.682650639539.issue33275@psf.upfronthosting.co.za>


Terry J. Reedy <tjreedy at udel.edu> added the comment:

I agree that anything that has the same FS-determined sorted or not behavior should get the same note, for the same reason.  Ben, can you test?  Eryk, can you enlighten us further?

PS: Ben, when responding by email, please delete the quote, as it is duplicate noise on the web page.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33275>
_______________________________________

From report at bugs.python.org  Wed Apr 25 07:05:08 2018
From: report at bugs.python.org (Steve Piercy)
Date: Wed, 25 Apr 2018 11:05:08 +0000
Subject: [docs] [issue33345] Documentation for PowerShell instructions
In-Reply-To: <1524555844.08.0.682650639539.issue33345@psf.upfronthosting.co.za>
Message-ID: <1524654307.99.0.682650639539.issue33345@psf.upfronthosting.co.za>


Steve Piercy <web at stevepiercy.com> added the comment:

After reviewing PowerShell syntax, I found it is impractical to support in Pyramid's documentation.  The discussion we had may be useful.

https://github.com/Pylons/pyramid/issues/3260

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33345>
_______________________________________

From report at bugs.python.org  Wed Apr 25 11:47:39 2018
From: report at bugs.python.org (Eryk Sun)
Date: Wed, 25 Apr 2018 15:47:39 +0000
Subject: [docs] [issue33275] glob.glob should explicitly note that results
 aren't sorted
In-Reply-To: <1523644726.46.0.682650639539.issue33275@psf.upfronthosting.co.za>
Message-ID: <1524671259.5.0.682650639539.issue33275@psf.upfronthosting.co.za>


Eryk Sun <eryksun at gmail.com> added the comment:

As I said, some file systems such as NTFS and ISO 9660 (or Joliet) store directories in lexicographically sorted order. NTFS does this using a b-tree and case-insensitive comparison, which helps the driver efficiently implement filtering a directory listing using a pattern such as "spam*eggs?.txt". (Filtering of a directory listing at the syscall level is peculiar to Windows and not supported by Python.)

I like the phrase "arbitrary order". I don't think it's wise for an application to ever depend on the order. Also, we usually want natural-language collation for display purposes (e.g. spam2.txt should come before spam10.txt), so we have to sort the result regardless of the file system.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33275>
_______________________________________

From report at bugs.python.org  Wed Apr 25 13:22:17 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Wed, 25 Apr 2018 17:22:17 +0000
Subject: [docs] [issue22069] TextIOWrapper(newline="\n",
 line_buffering=True) mistakenly treat \r as a newline
In-Reply-To: <1406306623.81.0.633771356606.issue22069@psf.upfronthosting.co.za>
Message-ID: <1524676937.11.0.262363346258.issue22069@psf.upfronthosting.co.za>


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


----------
keywords: +easy
stage:  -> needs patch
versions: +Python 3.7, Python 3.8 -Python 2.7, Python 3.4, Python 3.5

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue22069>
_______________________________________

From report at bugs.python.org  Wed Apr 25 13:25:32 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Wed, 25 Apr 2018 17:25:32 +0000
Subject: [docs] [issue19950] Document that unittest.TestCase.__init__ is
 called once per test
In-Reply-To: <1386714858.72.0.878231586551.issue19950@psf.upfronthosting.co.za>
Message-ID: <1524677132.2.0.262363346258.issue19950@psf.upfronthosting.co.za>


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


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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue19950>
_______________________________________

From report at bugs.python.org  Wed Apr 25 13:54:00 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 25 Apr 2018 17:54:00 +0000
Subject: [docs] [issue33280] Update link to Tcl/Tk 8.6 man pages in
 tkinter.rst
In-Reply-To: <1523736762.33.0.682650639539.issue33280@psf.upfronthosting.co.za>
Message-ID: <1524678840.79.0.682650639539.issue33280@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:


New changeset 67a8f4fed3169e1b8c947c10f6e06863e399ae32 by Serhiy Storchaka (Andr?s Delfino) in branch 'master':
bpo-33280: Reorganize external Tcl/Tk references. (GH-6473)
https://github.com/python/cpython/commit/67a8f4fed3169e1b8c947c10f6e06863e399ae32


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33280>
_______________________________________

From report at bugs.python.org  Wed Apr 25 13:56:37 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 25 Apr 2018 17:56:37 +0000
Subject: [docs] [issue33280] Update link to Tcl/Tk 8.6 man pages in
 tkinter.rst
In-Reply-To: <1523736762.33.0.682650639539.issue33280@psf.upfronthosting.co.za>
Message-ID: <1524678997.72.0.262363346258.issue33280@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +6295

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33280>
_______________________________________

From report at bugs.python.org  Wed Apr 25 14:29:07 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Wed, 25 Apr 2018 18:29:07 +0000
Subject: [docs] [issue33280] Update link to Tcl/Tk 8.6 man pages in
 tkinter.rst
In-Reply-To: <1523736762.33.0.682650639539.issue33280@psf.upfronthosting.co.za>
Message-ID: <1524680947.53.0.262363346258.issue33280@psf.upfronthosting.co.za>


Change by Andr?s Delfino <adelfino at gmail.com>:


----------
pull_requests: +6297

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33280>
_______________________________________

From report at bugs.python.org  Wed Apr 25 14:31:01 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 25 Apr 2018 18:31:01 +0000
Subject: [docs] [issue33280] Update link to Tcl/Tk 8.6 man pages in
 tkinter.rst
In-Reply-To: <1523736762.33.0.682650639539.issue33280@psf.upfronthosting.co.za>
Message-ID: <1524681060.96.0.682650639539.issue33280@psf.upfronthosting.co.za>


miss-islington <mariatta.wijaya+miss-islington at gmail.com> added the comment:


New changeset 53d36cc961ff2080fa91a216cce718295259d723 by Miss Islington (bot) in branch '3.7':
bpo-33280: Reorganize external Tcl/Tk references. (GH-6473)
https://github.com/python/cpython/commit/53d36cc961ff2080fa91a216cce718295259d723


----------
nosy: +miss-islington

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33280>
_______________________________________

From report at bugs.python.org  Wed Apr 25 14:40:00 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Wed, 25 Apr 2018 18:40:00 +0000
Subject: [docs] [issue33280] Update link to Tcl/Tk 8.6 man pages in
 tkinter.rst
In-Reply-To: <1523736762.33.0.682650639539.issue33280@psf.upfronthosting.co.za>
Message-ID: <1524681600.13.0.262363346258.issue33280@psf.upfronthosting.co.za>


Change by Andr?s Delfino <adelfino at gmail.com>:


----------
pull_requests: +6299

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33280>
_______________________________________

From report at bugs.python.org  Wed Apr 25 17:00:12 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Wed, 25 Apr 2018 21:00:12 +0000
Subject: [docs] [issue33280] Update link to Tcl/Tk 8.6 man pages in
 tkinter.rst
In-Reply-To: <1523736762.33.0.682650639539.issue33280@psf.upfronthosting.co.za>
Message-ID: <1524690012.24.0.262363346258.issue33280@psf.upfronthosting.co.za>


Change by Andr?s Delfino <adelfino at gmail.com>:


----------
pull_requests: +6303

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33280>
_______________________________________

From report at bugs.python.org  Wed Apr 25 18:58:37 2018
From: report at bugs.python.org (Juan Postlbauer)
Date: Wed, 25 Apr 2018 22:58:37 +0000
Subject: [docs] [issue33360] ALternative recipe for password using secrets
Message-ID: <1524697117.91.0.682650639539.issue33360@psf.upfronthosting.co.za>


New submission from Juan Postlbauer <jpc4242 at gmail.com>:

Chapter 15.3.4 shows a recipe with an infinite potential loop.
An alternative would be:

''.join(sorted([choice(string.ascii_lowercase) for i in range(1)]+[choice(string.ascii_uppercase) for i in range(1)]+[choice(string.digits) for i in range(3)]+[choice(string.ascii_letters+string.digits) for i in range(10-(1+1+3))],key=lambda x:randbelow(4096)))

Can we assume secrets.SystemRandom is cryptographically strong but has all the methods of random??
If so it can be done in a more understandable way by using choices and shuffle. (see 2 examples below)

def generate_password_random(totalchars=10,minlower=1,minupper=1,mindigits=3):
    restcount= totalchars-(minlower+minupper+mindigits)
    if restcount<0:
        raise ValueError("Impossible conditions")
    lowerchars=random.choices(string.ascii_lowercase,k=minlower)
    upperchars=random.choices(string.ascii_uppercase,k=minupper)
    digitchars=random.choices(string.digits,k=mindigits)
    restchars=random.choices(string.ascii_letters+string.digits,k=restcount)
    allchars=lowerchars+upperchars+digitchars+restchars
    random.shuffle(allchars)
    password=''.join(allchars)
    return password

def generate_password_secrets(totalchars=10,minlower=1,minupper=1,mindigits=3):
    restcount= totalchars- (minlower+minupper+mindigits)
    if restcount<0:
        raise ValueError("Impossible conditions")
    lowerchars=[secrets.choice(string.ascii_lowercase) for _ in range(minlower)]
    upperchars=[secrets.choice(string.ascii_uppercase) for _ in range(minupper)]
    digitchars=[secrets.choice(string.digits) for _ in range (mindigits)]
    restchars=[secrets.choice(string.ascii_letters+string.digits) for _ in range (restcount)]
    allchars=lowerchars+upperchars+digitchars+restchars
    allchars.sort(key=lambda x:secrets.randbelow(4096))
    password=''.join(allchars)
    return password

----------
assignee: docs at python
components: Documentation
messages: 315763
nosy: docs at python, jpc4242
priority: normal
severity: normal
status: open
title: ALternative recipe for password using secrets
type: enhancement
versions: Python 3.6

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33360>
_______________________________________

From report at bugs.python.org  Thu Apr 26 03:05:10 2018
From: report at bugs.python.org (Juan Postlbauer)
Date: Thu, 26 Apr 2018 07:05:10 +0000
Subject: [docs] [issue33360] ALternative recipe for password using secrets
In-Reply-To: <1524697117.91.0.682650639539.issue33360@psf.upfronthosting.co.za>
Message-ID: <1524726310.38.0.682650639539.issue33360@psf.upfronthosting.co.za>


Juan Postlbauer <jpc4242 at gmail.com> added the comment:

Just a clarification: by "infinite potential loop" I meant a loop that *theoretically* could last forever. Of course in practice it won't, but my experiments show that for the conditions in the example in average the current recipe generates 5 tentative passwords before finding one that fulfills all conditions.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33360>
_______________________________________

From report at bugs.python.org  Thu Apr 26 06:13:00 2018
From: report at bugs.python.org (Elena Oat)
Date: Thu, 26 Apr 2018 10:13:00 +0000
Subject: [docs] [issue22069] TextIOWrapper(newline="\n",
 line_buffering=True) mistakenly treat \r as a newline
In-Reply-To: <1406306623.81.0.633771356606.issue22069@psf.upfronthosting.co.za>
Message-ID: <1524737579.87.0.682650639539.issue22069@psf.upfronthosting.co.za>


Elena Oat <oat.elena at gmail.com> added the comment:

Note that the correct link to the test case is:
https://github.com/python/cpython/blob/master/Lib/test/test_io.py#L2565

----------
nosy: +Elena.Oat

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue22069>
_______________________________________

From report at bugs.python.org  Thu Apr 26 06:25:07 2018
From: report at bugs.python.org (Elena Oat)
Date: Thu, 26 Apr 2018 10:25:07 +0000
Subject: [docs] [issue22069] TextIOWrapper(newline="\n",
 line_buffering=True) mistakenly treat \r as a newline
In-Reply-To: <1406306623.81.0.633771356606.issue22069@psf.upfronthosting.co.za>
Message-ID: <1524738307.13.0.262363346258.issue22069@psf.upfronthosting.co.za>


Change by Elena Oat <oat.elena at gmail.com>:


----------
keywords: +patch
pull_requests: +6305
stage: needs patch -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue22069>
_______________________________________

From report at bugs.python.org  Thu Apr 26 07:33:14 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 26 Apr 2018 11:33:14 +0000
Subject: [docs] [issue32790] Keep trailing zeros in precision for string
 format option g
In-Reply-To: <1518055716.96.0.467229070634.issue32790@psf.upfronthosting.co.za>
Message-ID: <1524742394.22.0.262363346258.issue32790@psf.upfronthosting.co.za>


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


----------
keywords: +easy
stage:  -> needs patch
versions: +Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32790>
_______________________________________

From report at bugs.python.org  Thu Apr 26 08:47:52 2018
From: report at bugs.python.org (Tom Christie)
Date: Thu, 26 Apr 2018 12:47:52 +0000
Subject: [docs] [issue33366] `contextvars` documentation incorrectly refers
 to "non-local state".
Message-ID: <1524746872.41.0.682650639539.issue33366@psf.upfronthosting.co.za>


New submission from Tom Christie <tom at tomchristie.com>:

The `contextvars` documentation, at https://docs.python.org/3.7/library/contextvars.html starts with the following:

"This module provides APIs to manage, store, and access non-local state."

I assume that must be a documentation bug, right. The module isn't for managing non-local state, it's for managing state that *is* local.

I'd assume it ought to read...

"This module provides APIs to manage, store, and access context-local state."

(ie. for managing state that is transparently either thread-local or task-local depending on the current execution context.)

----------
assignee: docs at python
components: Documentation, asyncio
messages: 315792
nosy: asvetlov, docs at python, tomchristie, yselivanov
priority: normal
severity: normal
status: open
title: `contextvars` documentation incorrectly refers to "non-local state".
type: enhancement
versions: Python 3.7, Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33366>
_______________________________________

From report at bugs.python.org  Thu Apr 26 09:50:17 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 26 Apr 2018 13:50:17 +0000
Subject: [docs] [issue33280] Update link to Tcl/Tk 8.6 man pages in
 tkinter.rst
In-Reply-To: <1523736762.33.0.682650639539.issue33280@psf.upfronthosting.co.za>
Message-ID: <1524750617.69.0.682650639539.issue33280@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:


New changeset 1c6c8510f91fcd9d46a8ce9155d8c2689d7df92b by Serhiy Storchaka (Andr?s Delfino) in branch '2.7':
[2.7] bpo-33280: Reorganize external Tcl/Tk references. (GH-6473). (GH-6607)
https://github.com/python/cpython/commit/1c6c8510f91fcd9d46a8ce9155d8c2689d7df92b


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33280>
_______________________________________

From report at bugs.python.org  Thu Apr 26 10:06:28 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 26 Apr 2018 14:06:28 +0000
Subject: [docs] [issue33280] Update link to Tcl/Tk 8.6 man pages in
 tkinter.rst
In-Reply-To: <1523736762.33.0.682650639539.issue33280@psf.upfronthosting.co.za>
Message-ID: <1524751588.06.0.262363346258.issue33280@psf.upfronthosting.co.za>


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


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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33280>
_______________________________________

From report at bugs.python.org  Thu Apr 26 10:09:44 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Thu, 26 Apr 2018 14:09:44 +0000
Subject: [docs] [issue33280] Update link to Tcl/Tk 8.6 man pages in
 tkinter.rst
In-Reply-To: <1523736762.33.0.682650639539.issue33280@psf.upfronthosting.co.za>
Message-ID: <1524751784.66.0.682650639539.issue33280@psf.upfronthosting.co.za>


Andr?s Delfino <adelfino at gmail.com> added the comment:

There's still an open PR to backport this to 3.6:

https://github.com/python/cpython/pull/6602

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33280>
_______________________________________

From report at bugs.python.org  Thu Apr 26 10:10:13 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 26 Apr 2018 14:10:13 +0000
Subject: [docs] [issue33280] Update link to Tcl/Tk 8.6 man pages in
 tkinter.rst
In-Reply-To: <1523736762.33.0.682650639539.issue33280@psf.upfronthosting.co.za>
Message-ID: <1524751813.69.0.682650639539.issue33280@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:


New changeset 4533494ac553273239c809053b54c0ab783a0c78 by Serhiy Storchaka (Andr?s Delfino) in branch '3.6':
[3.6] bpo-33280: Reorganize external Tcl/Tk references. (GH-6473). (#6602)
https://github.com/python/cpython/commit/4533494ac553273239c809053b54c0ab783a0c78


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33280>
_______________________________________

From report at bugs.python.org  Thu Apr 26 11:24:20 2018
From: report at bugs.python.org (Yury Selivanov)
Date: Thu, 26 Apr 2018 15:24:20 +0000
Subject: [docs] [issue33366] `contextvars` documentation incorrectly refers
 to "non-local state".
In-Reply-To: <1524746872.41.0.682650639539.issue33366@psf.upfronthosting.co.za>
Message-ID: <1524756260.77.0.682650639539.issue33366@psf.upfronthosting.co.za>


Yury Selivanov <yselivanov at gmail.com> added the comment:

I like what you propose. Can you submit a PR? :)

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33366>
_______________________________________

From report at bugs.python.org  Thu Apr 26 15:08:57 2018
From: report at bugs.python.org (C. Y. Hollander)
Date: Thu, 26 Apr 2018 19:08:57 +0000
Subject: [docs] [issue33368] Inaccuracy in
 https://docs.python.org/3/library/re.html#re.match.end
Message-ID: <1524769737.79.0.682650639539.issue33368@psf.upfronthosting.co.za>


New submission from C. Y. Hollander <judah0 at gmail.com>:

The documentation states that match.end([group]) returns "the ind[ex] of the... end of the substring matched by group". In fact, it returns [said index] + 1, as demonstrated by the example below:

s = 'example'
sre = re.search('le', s)
s[sre.end()]

Incidentally, I don't see the logic of this behaviour, but in any case it should be correctly documented.

----------
assignee: docs at python
components: Documentation
messages: 315813
nosy: C. Y. Hollander, docs at python
priority: normal
severity: normal
status: open
title: Inaccuracy in https://docs.python.org/3/library/re.html#re.match.end
type: enhancement

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33368>
_______________________________________

From report at bugs.python.org  Thu Apr 26 16:03:03 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 26 Apr 2018 20:03:03 +0000
Subject: [docs] [issue33368] Inaccuracy in
 https://docs.python.org/3/library/re.html#re.match.end
In-Reply-To: <1524769737.79.0.682650639539.issue33368@psf.upfronthosting.co.za>
Message-ID: <1524772983.31.0.682650639539.issue33368@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:

It returns not the index of the last character of the substring, but the index of the end of the substring, i.e. the position past the last character of the substring.

Try s[:sre.end()] and s[sre.end():].

s[sre.begin()] gives you the part of s before the matched substring, s[sre.begin():sre.end()] gives you the matched substring itself (the same as sre.group()) and s[sre.end():] gives you the part of s after the matched substring.

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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33368>
_______________________________________

From report at bugs.python.org  Fri Apr 27 05:54:07 2018
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 27 Apr 2018 09:54:07 +0000
Subject: [docs] [issue33366] `contextvars` documentation incorrectly refers
 to "non-local state".
In-Reply-To: <1524746872.41.0.682650639539.issue33366@psf.upfronthosting.co.za>
Message-ID: <1524822847.76.0.262363346258.issue33366@psf.upfronthosting.co.za>


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


----------
keywords: +patch
pull_requests: +6313
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33366>
_______________________________________

From report at bugs.python.org  Fri Apr 27 05:58:01 2018
From: report at bugs.python.org (Tom Christie)
Date: Fri, 27 Apr 2018 09:58:01 +0000
Subject: [docs] [issue33366] `contextvars` documentation incorrectly refers
 to "non-local state".
In-Reply-To: <1524746872.41.0.682650639539.issue33366@psf.upfronthosting.co.za>
Message-ID: <1524823081.51.0.682650639539.issue33366@psf.upfronthosting.co.za>


Tom Christie <tom at tomchristie.com> added the comment:

Refs: https://github.com/python/cpython/pull/6617

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33366>
_______________________________________

From Matt.Valentine at garmin.com  Tue Apr 24 12:11:52 2018
From: Matt.Valentine at garmin.com (Valentine, Matt)
Date: Tue, 24 Apr 2018 16:11:52 +0000
Subject: [docs] audioop.rms() docs
Message-ID: <c69fbc5a8cb24a108d19a915aad158b1@garmin.com>

Hi folks,

There is a slight mis-statement in the audioop docs<https://docs.python.org/3/library/audioop.html> about audioop.rms():

audioop.rms(fragment, width)?
Return the root-mean-square of the fragment, i.e. sqrt(sum(S_i^2)/n).

This is a measure of the power in an audio signal.

RMS is actually a measure of the amplitude in an audio signal. Power is RMS amplitude squared (RMS without the R). See Wikipedia RMS Amplitude<https://en.wikipedia.org/wiki/Amplitude#Root_mean_square_amplitude>:

  *   "Root mean square (RMS) amplitude is used especially in electrical engineering: the RMS is defined as the square root of the mean over time of the square of the vertical distance of the graph from the rest state"
  *   "the average power transmitted by an acoustic or electromagnetic wave or by an electrical signal is proportional to the square of the RMS amplitude".

The python docs comment could be tweaked as follows:

  *   Simple: "This is the RMS amplitude in an audio signal."
  *   OR: "This is the RMS amplitude in an audio signal. The average power is proportional to the square of the RMS amplitude."

Thanks, -Matt
--
Matt Valentine
Speech Technologies
Garmin International
[auto_oem_sig_96dpi]


________________________________

CONFIDENTIALITY NOTICE: This email and any attachments are for the sole use of the intended recipient(s) and contain information that may be Garmin confidential and/or Garmin legally privileged. If you have received this email in error, please notify the sender by reply email and delete the message. Any disclosure, copying, distribution or use of this communication (including attachments) by someone other than the intended recipient is prohibited. Thank you.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180424/01b685da/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image001.png
Type: image/png
Size: 6810 bytes
Desc: image001.png
URL: <http://mail.python.org/pipermail/docs/attachments/20180424/01b685da/attachment-0001.png>

From vijithmp87 at gmail.com  Fri Apr 27 02:40:21 2018
From: vijithmp87 at gmail.com (VijithNambiar)
Date: Fri, 27 Apr 2018 12:10:21 +0530
Subject: [docs] =?utf-8?q?Reporting_Documentation_Bug_in_Documentation_?=
	=?utf-8?q?=C2=BB_The_Python_Tutorial_=C2=BB6=2EModules?=
Message-ID: <CA+pEq-7MosAzcVX9hjdWiBN7M7Z1VOKXfD9qMM81D65YoJYptA@mail.gmail.com>

Hi
I think there is a bug in the section
https://docs.python.org/3/tutorial/modules.html#more-on-modules
where the outputs of the statements below is given as wrong as it is
starting with a '0'

>>> import fibo as fib>>> fib.fib(500)0 1 1 2 3 5 8 13 21 34 55 89 144 233 377

>>> import fibo as fib>>> fib.fib(500)0 1 1 2 3 5 8 13 21 34 55 89 144 233 377
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180427/22af11b6/attachment.html>

From vijithmp87 at gmail.com  Fri Apr 27 04:02:59 2018
From: vijithmp87 at gmail.com (VijithNambiar)
Date: Fri, 27 Apr 2018 13:32:59 +0530
Subject: [docs] =?utf-8?q?Fwd=3A_Reporting_Documentation_Bug_in_Documenta?=
	=?utf-8?q?tion_=C2=BB_The_Python_Tutorial_=C2=BB6=2EModules?=
In-Reply-To: <CA+pEq-7MosAzcVX9hjdWiBN7M7Z1VOKXfD9qMM81D65YoJYptA@mail.gmail.com>
References: <CA+pEq-7MosAzcVX9hjdWiBN7M7Z1VOKXfD9qMM81D65YoJYptA@mail.gmail.com>
Message-ID: <CA+pEq-4mEsACO1MtY18t+w+yN6wZ=J0V6ttjA8Dmh+nLOpKatg@mail.gmail.com>

Hi
I think there is a bug in the section https://docs.python.org/3/
tutorial/modules.html#more-on-modules
where the outputs of the statements below is given as wrong as it is
starting with a '0'

>>> import fibo as fib>>> fib.fib(500)0 1 1 2 3 5 8 13 21 34 55 89 144 233 377

>>> import fibo as fib>>> fib.fib(500)0 1 1 2 3 5 8 13 21 34 55 89 144 233 377
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180427/d4d245c5/attachment.html>

From report at bugs.python.org  Fri Apr 27 14:38:53 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 27 Apr 2018 18:38:53 +0000
Subject: [docs] [issue33339] Using default encoding with `subprocess.run()`
 is not obvious
In-Reply-To: <1524472712.16.0.682650639539.issue33339@psf.upfronthosting.co.za>
Message-ID: <1524854333.5.0.262363346258.issue33339@psf.upfronthosting.co.za>


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


----------
assignee:  -> docs at python
components: +Documentation
nosy: +docs at python
stage:  -> needs patch
type:  -> enhancement
versions: +Python 2.7, Python 3.6, Python 3.7, Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33339>
_______________________________________

From report at bugs.python.org  Fri Apr 27 18:35:45 2018
From: report at bugs.python.org (Yury Selivanov)
Date: Fri, 27 Apr 2018 22:35:45 +0000
Subject: [docs] [issue33366] `contextvars` documentation incorrectly refers
 to "non-local state".
In-Reply-To: <1524746872.41.0.682650639539.issue33366@psf.upfronthosting.co.za>
Message-ID: <1524868545.06.0.682650639539.issue33366@psf.upfronthosting.co.za>


Yury Selivanov <yselivanov at gmail.com> added the comment:

Thank you, Tom!

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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33366>
_______________________________________

From report at bugs.python.org  Fri Apr 27 18:36:36 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 27 Apr 2018 22:36:36 +0000
Subject: [docs] [issue33366] `contextvars` documentation incorrectly refers
 to "non-local state".
In-Reply-To: <1524746872.41.0.682650639539.issue33366@psf.upfronthosting.co.za>
Message-ID: <1524868596.01.0.262363346258.issue33366@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +6317

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33366>
_______________________________________

From report at bugs.python.org  Sat Apr 28 05:13:49 2018
From: report at bugs.python.org (Bharat Chhabra)
Date: Sat, 28 Apr 2018 09:13:49 +0000
Subject: [docs] [issue32790] Keep trailing zeros in precision for string
 format option g
In-Reply-To: <1518055716.96.0.467229070634.issue32790@psf.upfronthosting.co.za>
Message-ID: <1524906829.45.0.262363346258.issue32790@psf.upfronthosting.co.za>


Change by Bharat Chhabra <bchhabra2490 at gmail.com>:


----------
keywords: +patch
pull_requests: +6320
stage: needs patch -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32790>
_______________________________________

From report at bugs.python.org  Sun Apr 29 14:03:07 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 29 Apr 2018 18:03:07 +0000
Subject: [docs] [issue32362] multiprocessing.connection.Connection
 misdocumented as multiprocessing.Connection
In-Reply-To: <1513592247.3.0.213398074469.issue32362@psf.upfronthosting.co.za>
Message-ID: <1525024987.78.0.682650639539.issue32362@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:


New changeset 9f3535c9cde8813ce631d6ebe4d790682f594828 by Serhiy Storchaka (Bo Bayles) in branch 'master':
bpo-32362: Fix references to non-existent multiprocessing.Connection() (GH-6223)
https://github.com/python/cpython/commit/9f3535c9cde8813ce631d6ebe4d790682f594828


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

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32362>
_______________________________________

From report at bugs.python.org  Sun Apr 29 14:04:15 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 29 Apr 2018 18:04:15 +0000
Subject: [docs] [issue32362] multiprocessing.connection.Connection
 misdocumented as multiprocessing.Connection
In-Reply-To: <1513592247.3.0.213398074469.issue32362@psf.upfronthosting.co.za>
Message-ID: <1525025055.91.0.262363346258.issue32362@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +6335

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32362>
_______________________________________

From report at bugs.python.org  Sun Apr 29 14:06:16 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 29 Apr 2018 18:06:16 +0000
Subject: [docs] [issue32362] multiprocessing.connection.Connection
 misdocumented as multiprocessing.Connection
In-Reply-To: <1513592247.3.0.213398074469.issue32362@psf.upfronthosting.co.za>
Message-ID: <1525025176.56.0.262363346258.issue32362@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +6336

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32362>
_______________________________________

From report at bugs.python.org  Sun Apr 29 15:09:38 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 29 Apr 2018 19:09:38 +0000
Subject: [docs] [issue32362] multiprocessing.connection.Connection
 misdocumented as multiprocessing.Connection
In-Reply-To: <1513592247.3.0.213398074469.issue32362@psf.upfronthosting.co.za>
Message-ID: <1525028977.54.0.682650639539.issue32362@psf.upfronthosting.co.za>


miss-islington <mariatta.wijaya+miss-islington at gmail.com> added the comment:


New changeset cebce2e8d15db101435194f79be31b5d80455bb0 by Miss Islington (bot) in branch '3.7':
bpo-32362: Fix references to non-existent multiprocessing.Connection() (GH-6223)
https://github.com/python/cpython/commit/cebce2e8d15db101435194f79be31b5d80455bb0


----------
nosy: +miss-islington

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32362>
_______________________________________

From report at bugs.python.org  Sun Apr 29 15:11:03 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 29 Apr 2018 19:11:03 +0000
Subject: [docs] [issue32362] multiprocessing.connection.Connection
 misdocumented as multiprocessing.Connection
In-Reply-To: <1513592247.3.0.213398074469.issue32362@psf.upfronthosting.co.za>
Message-ID: <1525029063.72.0.682650639539.issue32362@psf.upfronthosting.co.za>


miss-islington <mariatta.wijaya+miss-islington at gmail.com> added the comment:


New changeset 9a039d5679a5838c876ff607ce2f5d8dc0fb307a by Miss Islington (bot) in branch '3.6':
bpo-32362: Fix references to non-existent multiprocessing.Connection() (GH-6223)
https://github.com/python/cpython/commit/9a039d5679a5838c876ff607ce2f5d8dc0fb307a


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32362>
_______________________________________

From report at bugs.python.org  Sun Apr 29 19:00:55 2018
From: report at bugs.python.org (bbayles)
Date: Sun, 29 Apr 2018 23:00:55 +0000
Subject: [docs] [issue32362] multiprocessing.connection.Connection
 misdocumented as multiprocessing.Connection
In-Reply-To: <1513592247.3.0.213398074469.issue32362@psf.upfronthosting.co.za>
Message-ID: <1525042855.95.0.262363346258.issue32362@psf.upfronthosting.co.za>


Change by bbayles <bbayles at gmail.com>:


----------
pull_requests: +6343

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32362>
_______________________________________

From report at bugs.python.org  Mon Apr 30 13:09:20 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Mon, 30 Apr 2018 17:09:20 +0000
Subject: [docs] [issue32769] Add 'annotations' to the glossary
In-Reply-To: <1518019777.95.0.467229070634.issue32769@psf.upfronthosting.co.za>
Message-ID: <1525108160.72.0.262363346258.issue32769@psf.upfronthosting.co.za>


Change by Andr?s Delfino <adelfino at gmail.com>:


----------
keywords: +patch
pull_requests: +6353
stage: needs patch -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32769>
_______________________________________

From report at bugs.python.org  Mon Apr 30 13:10:36 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Mon, 30 Apr 2018 17:10:36 +0000
Subject: [docs] [issue32769] Add 'annotations' to the glossary
In-Reply-To: <1518019777.95.0.467229070634.issue32769@psf.upfronthosting.co.za>
Message-ID: <1525108236.0.0.682650639539.issue32769@psf.upfronthosting.co.za>


Andr?s Delfino <adelfino at gmail.com> added the comment:

I just made a PR to start working on the right wording.

----------
nosy: +adelfino

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32769>
_______________________________________

From report at bugs.python.org  Mon Apr 30 18:05:57 2018
From: report at bugs.python.org (Anthony Flury)
Date: Mon, 30 Apr 2018 22:05:57 +0000
Subject: [docs] [issue33006] docstring of filter function is incorrect
In-Reply-To: <1520300191.48.0.467229070634.issue33006@psf.upfronthosting.co.za>
Message-ID: <1525125957.39.0.682650639539.issue33006@psf.upfronthosting.co.za>


Anthony Flury <anthony.flury at btinternet.com> added the comment:

Strictly speaking the official Python2 reference document isn't a great example - for instance:

' If function is None, the identity function is assumed, that is, all elements of iterable that are false are removed.' 

Implies that items are removed from the iterable are removed, but they aren't; they are simply not included in the sequence that is returned.

Does the documentation need to be fixed too ?

----------
nosy: +anthony-flury

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33006>
_______________________________________

From report at bugs.python.org  Mon Apr 30 19:03:51 2018
From: report at bugs.python.org (Pierre Thibault)
Date: Mon, 30 Apr 2018 23:03:51 +0000
Subject: [docs] [issue33006] docstring of filter function is incorrect
In-Reply-To: <1525125957.39.0.682650639539.issue33006@psf.upfronthosting.co.za>
Message-ID: <CACzzh1dTd5ZX2VTRTSog2Rn+xx9nPxK-hdQRuXM4U4OcQpZ+Bw@mail.gmail.com>


Pierre Thibault <pierre.thibault1.dev at gmail.com> added the comment:

I guess it does since it gives false information.

2018-04-30 18:05 GMT-04:00 Anthony Flury <report at bugs.python.org>:

>
> Anthony Flury <anthony.flury at btinternet.com> added the comment:
>
> Strictly speaking the official Python2 reference document isn't a great
> example - for instance:
>
> ' If function is None, the identity function is assumed, that is, all
> elements of iterable that are false are removed.'
>
> Implies that items are removed from the iterable are removed, but they
> aren't; they are simply not included in the sequence that is returned.
>
> Does the documentation need to be fixed too ?
>
> ----------
> nosy: +anthony-flury
>
> _______________________________________
> Python tracker <report at bugs.python.org>
> <https://bugs.python.org/issue33006>
> _______________________________________
>

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue33006>
_______________________________________