From report at bugs.python.org  Thu Feb  1 00:44:53 2018
From: report at bugs.python.org (Yang Yu)
Date: Thu, 01 Feb 2018 05:44:53 +0000
Subject: [docs] [issue32739] collections.deque rotate(n=1) default value not
 documented
Message-ID: <1517463893.34.0.467229070634.issue32739@psf.upfronthosting.co.za>


New submission from Yang Yu <yangyudev at gmail.com>:

https://docs.python.org/3/library/collections.html#collections.deque

rotate() works the same as rotate(1). The documentation did not mention the default for n.

----------
assignee: docs at python
components: Documentation
messages: 311403
nosy: docs at python, yuy
priority: normal
severity: normal
status: open
title: collections.deque rotate(n=1) default value not documented
type: behavior
versions: Python 3.6

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

From report at bugs.python.org  Thu Feb  1 02:31:10 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Thu, 01 Feb 2018 07:31:10 +0000
Subject: [docs] [issue32722] Mislabeling of a dict comprehension as a
 generator expression in the tutorial
In-Reply-To: <1517290861.72.0.467229070634.issue32722@psf.upfronthosting.co.za>
Message-ID: <1517470270.52.0.467229070634.issue32722@psf.upfronthosting.co.za>


Xiang Zhang <angwerzx at 126.com> added the comment:


New changeset ab328756d7fd969ee4882458b07892dff135013c by Xiang Zhang (St?phane Wirtel) in branch 'master':
bpo-32722: Remove useless example in the Classes tutorial (#5446)
https://github.com/python/cpython/commit/ab328756d7fd969ee4882458b07892dff135013c


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

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

From report at bugs.python.org  Thu Feb  1 02:32:10 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Thu, 01 Feb 2018 07:32:10 +0000
Subject: [docs] [issue32722] Mislabeling of a dict comprehension as a
 generator expression in the tutorial
In-Reply-To: <1517290861.72.0.467229070634.issue32722@psf.upfronthosting.co.za>
Message-ID: <1517470330.28.0.467229070634.issue32722@psf.upfronthosting.co.za>


Xiang Zhang <angwerzx at 126.com> added the comment:

I treat it as an enhancement so only merge it into 3.8. Thanks Soothsayer for the report and St?phane for the patch!

----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed
versions:  -Python 2.7, Python 3.4, Python 3.5, Python 3.6, Python 3.7

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

From report at bugs.python.org  Thu Feb  1 05:00:38 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Thu, 01 Feb 2018 10:00:38 +0000
Subject: [docs] [issue20709] os.utime(path_to_directory): wrong
 documentation for Windows.
In-Reply-To: <1392937056.04.0.541478480244.issue20709@psf.upfronthosting.co.za>
Message-ID: <1517479238.98.0.714561066657.issue20709@psf.upfronthosting.co.za>


Change by St?phane Wirtel <stephane at wirtel.be>:


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

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

From report at bugs.python.org  Thu Feb  1 05:02:04 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Thu, 01 Feb 2018 10:02:04 +0000
Subject: [docs] [issue20709] os.utime(path_to_directory): wrong
 documentation for Windows.
In-Reply-To: <1392937056.04.0.541478480244.issue20709@psf.upfronthosting.co.za>
Message-ID: <1517479324.12.0.467229070634.issue20709@psf.upfronthosting.co.za>


St?phane Wirtel <stephane at wirtel.be> added the comment:

Hi @Cheryl

I just created a PR with the patch for 3.8.

Could you take a look?

Thank you

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

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

From report at bugs.python.org  Thu Feb  1 05:08:48 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Thu, 01 Feb 2018 10:08:48 +0000
Subject: [docs] [issue32674] minor documentation fix for '__import__'
In-Reply-To: <1516948902.25.0.467229070634.issue32674@psf.upfronthosting.co.za>
Message-ID: <1517479728.25.0.714561066657.issue32674@psf.upfronthosting.co.za>


Change by St?phane Wirtel <stephane at wirtel.be>:


----------
keywords: +needs review

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

From report at bugs.python.org  Thu Feb  1 06:48:40 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 01 Feb 2018 11:48:40 +0000
Subject: [docs] [issue32565] Document the version of adding opcodes
In-Reply-To: <1516094930.57.0.467229070634.issue32565@psf.upfronthosting.co.za>
Message-ID: <1517485720.18.0.467229070634.issue32565@psf.upfronthosting.co.za>


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


New changeset 12e7cd8a51956a5ce373aac692ae6366c5f86584 by Serhiy Storchaka in branch 'master':
bpo-32565: Add missed versionadded directives for all new opcodes. (#5199)
https://github.com/python/cpython/commit/12e7cd8a51956a5ce373aac692ae6366c5f86584


----------

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

From report at bugs.python.org  Thu Feb  1 06:48:52 2018
From: report at bugs.python.org (miss-islington)
Date: Thu, 01 Feb 2018 11:48:52 +0000
Subject: [docs] [issue32565] Document the version of adding opcodes
In-Reply-To: <1516094930.57.0.467229070634.issue32565@psf.upfronthosting.co.za>
Message-ID: <1517485732.78.0.714561066657.issue32565@psf.upfronthosting.co.za>


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


----------
pull_requests: +5296

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

From report at bugs.python.org  Thu Feb  1 06:55:44 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 01 Feb 2018 11:55:44 +0000
Subject: [docs] [issue32565] Document the version of adding opcodes
In-Reply-To: <1516094930.57.0.467229070634.issue32565@psf.upfronthosting.co.za>
Message-ID: <1517486144.74.0.714561066657.issue32565@psf.upfronthosting.co.za>


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


----------
pull_requests: +5297

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

From report at bugs.python.org  Thu Feb  1 07:13:00 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 01 Feb 2018 12:13:00 +0000
Subject: [docs] [issue32565] Document the version of adding opcodes
In-Reply-To: <1516094930.57.0.467229070634.issue32565@psf.upfronthosting.co.za>
Message-ID: <1517487180.16.0.467229070634.issue32565@psf.upfronthosting.co.za>


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


New changeset 4d6543005df6eba6ec3414686fdc251cb4fe9792 by Serhiy Storchaka (Miss Islington (bot)) in branch '3.7':
bpo-32565: Add missed versionadded directives for all new opcodes. (GH-5199) (GH-5470)
https://github.com/python/cpython/commit/4d6543005df6eba6ec3414686fdc251cb4fe9792


----------

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

From report at bugs.python.org  Thu Feb  1 07:47:25 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 01 Feb 2018 12:47:25 +0000
Subject: [docs] [issue32565] Document the version of adding opcodes
In-Reply-To: <1516094930.57.0.467229070634.issue32565@psf.upfronthosting.co.za>
Message-ID: <1517489245.42.0.467229070634.issue32565@psf.upfronthosting.co.za>


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


New changeset 8cf7ebb32dbdfb976ac92afd264e7587fb0da7ae by Serhiy Storchaka in branch '3.6':
[3.6] bpo-32565: Add missed versionadded directives for all new opcodes. (GH-5199). (GH-5471)
https://github.com/python/cpython/commit/8cf7ebb32dbdfb976ac92afd264e7587fb0da7ae


----------

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

From report at bugs.python.org  Thu Feb  1 07:48:18 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 01 Feb 2018 12:48:18 +0000
Subject: [docs] [issue32565] Document the version of adding opcodes
In-Reply-To: <1516094930.57.0.467229070634.issue32565@psf.upfronthosting.co.za>
Message-ID: <1517489298.08.0.714561066657.issue32565@psf.upfronthosting.co.za>


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


----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed
versions: +Python 3.8

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

From report at bugs.python.org  Thu Feb  1 12:16:51 2018
From: report at bugs.python.org (Dmitry Alimov)
Date: Thu, 01 Feb 2018 17:16:51 +0000
Subject: [docs] [issue32743] Typo in hamt.c comments
Message-ID: <1517505411.15.0.467229070634.issue32743@psf.upfronthosting.co.za>


New submission from Dmitry Alimov <dvalimov at gmail.com>:

In the comments to `hamt_node_collision_without` function in hamt.c module, I think should be `so convert` instead of `co convert`:

```
             if (new_count == 1) {
                 /* The node has two keys, and after deletion the
                    new Collision node would have one.  Collision nodes
-                   with one key shouldn't exist, co convert it to a
+                   with one key shouldn't exist, so convert it to a
                    Bitmap node.
                 */
```

----------
assignee: docs at python
components: Documentation
messages: 311452
nosy: delimitry, docs at python, yselivanov
priority: normal
severity: normal
status: open
title: Typo in hamt.c comments
type: enhancement
versions: Python 3.7, Python 3.8

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

From report at bugs.python.org  Thu Feb  1 12:17:22 2018
From: report at bugs.python.org (Yury Selivanov)
Date: Thu, 01 Feb 2018 17:17:22 +0000
Subject: [docs] [issue32743] Typo in hamt.c comments
In-Reply-To: <1517505411.15.0.467229070634.issue32743@psf.upfronthosting.co.za>
Message-ID: <1517505442.03.0.467229070634.issue32743@psf.upfronthosting.co.za>


Yury Selivanov <yselivanov at gmail.com> added the comment:

Yeah, please submit a PR

----------

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

From report at bugs.python.org  Thu Feb  1 12:18:43 2018
From: report at bugs.python.org (Dmitry Alimov)
Date: Thu, 01 Feb 2018 17:18:43 +0000
Subject: [docs] [issue32743] Typo in hamt.c comments
In-Reply-To: <1517505411.15.0.467229070634.issue32743@psf.upfronthosting.co.za>
Message-ID: <1517505523.46.0.714561066657.issue32743@psf.upfronthosting.co.za>


Change by Dmitry Alimov <dvalimov at gmail.com>:


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

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

From report at bugs.python.org  Thu Feb  1 12:43:36 2018
From: report at bugs.python.org (Dmitry Alimov)
Date: Thu, 01 Feb 2018 17:43:36 +0000
Subject: [docs] [issue32744] PEP 342 double colons typos in code
Message-ID: <1517507016.51.0.467229070634.issue32744@psf.upfronthosting.co.za>


New submission from Dmitry Alimov <dvalimov at gmail.com>:

I've found "double colons" typos in examples:

@consumer
def jpeg_writer(dirname)::  # 1) here
    fileno = 1

and

        try:
            while self.running and self.queue::  # 2) here
               func = self.queue.popleft()

----------
assignee: docs at python
components: Documentation
messages: 311458
nosy: delimitry, docs at python
priority: normal
severity: normal
status: open
title: PEP 342 double colons typos in code
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/issue32744>
_______________________________________

From report at bugs.python.org  Thu Feb  1 12:45:39 2018
From: report at bugs.python.org (Dmitry Alimov)
Date: Thu, 01 Feb 2018 17:45:39 +0000
Subject: [docs] [issue32744] PEP 342 double colons typos in code
In-Reply-To: <1517507016.51.0.467229070634.issue32744@psf.upfronthosting.co.za>
Message-ID: <1517507139.73.0.467229070634.issue32744@psf.upfronthosting.co.za>


Dmitry Alimov <dvalimov at gmail.com> added the comment:

https://github.com/python/peps/pull/567

----------

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

From report at bugs.python.org  Thu Feb  1 13:07:42 2018
From: report at bugs.python.org (Dmitry Alimov)
Date: Thu, 01 Feb 2018 18:07:42 +0000
Subject: [docs] [issue32744] PEP 342 double colons typos in code
In-Reply-To: <1517507016.51.0.467229070634.issue32744@psf.upfronthosting.co.za>
Message-ID: <1517508462.47.0.467229070634.issue32744@psf.upfronthosting.co.za>


Dmitry Alimov <dvalimov at gmail.com> added the comment:

Merged. It's fixed now: https://www.python.org/dev/peps/pep-0342/

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

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

From report at bugs.python.org  Thu Feb  1 15:39:25 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Thu, 01 Feb 2018 20:39:25 +0000
Subject: [docs] [issue32739] collections.deque rotate(n=1) default value not
 documented
In-Reply-To: <1517463893.34.0.467229070634.issue32739@psf.upfronthosting.co.za>
Message-ID: <1517517565.63.0.467229070634.issue32739@psf.upfronthosting.co.za>


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

Thanks for noticing this.

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

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

From report at bugs.python.org  Thu Feb  1 18:50:54 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 01 Feb 2018 23:50:54 +0000
Subject: [docs] [issue32720] Format mini-language integer definition is
 incorrect
In-Reply-To: <1517287529.39.0.467229070634.issue32720@psf.upfronthosting.co.za>
Message-ID: <1517529054.2.0.714561066657.issue32720@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Feb  1 18:56:25 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 01 Feb 2018 23:56:25 +0000
Subject: [docs] [issue32540] venv docs - doesn't match behavior
In-Reply-To: <1515780433.02.0.467229070634.issue32540@psf.upfronthosting.co.za>
Message-ID: <1517529385.93.0.714561066657.issue32540@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Feb  1 19:02:18 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Fri, 02 Feb 2018 00:02:18 +0000
Subject: [docs] [issue30449] Improve __slots__ datamodel documentation
In-Reply-To: <1495587707.13.0.0998591622446.issue30449@psf.upfronthosting.co.za>
Message-ID: <1517529738.13.0.467229070634.issue30449@psf.upfronthosting.co.za>


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

It looks like this documentation patch was applied to master.  Does it need to be backported to 3.6 and 2.7 for the issue to be closed?  Thanks!

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

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

From report at bugs.python.org  Thu Feb  1 20:12:29 2018
From: report at bugs.python.org (Nathan Kerr)
Date: Fri, 02 Feb 2018 01:12:29 +0000
Subject: [docs] [issue32720] Format mini-language integer definition is
 incorrect
In-Reply-To: <1517287529.39.0.467229070634.issue32720@psf.upfronthosting.co.za>
Message-ID: <1517533949.93.0.714561066657.issue32720@psf.upfronthosting.co.za>


Change by Nathan Kerr <nathankerr96 at gmail.com>:


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

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

From report at bugs.python.org  Thu Feb  1 20:18:48 2018
From: report at bugs.python.org (Nathan Kerr)
Date: Fri, 02 Feb 2018 01:18:48 +0000
Subject: [docs] [issue32720] Format mini-language integer definition is
 incorrect
In-Reply-To: <1517287529.39.0.467229070634.issue32720@psf.upfronthosting.co.za>
Message-ID: <1517534328.76.0.467229070634.issue32720@psf.upfronthosting.co.za>


Nathan Kerr <nathankerr96 at gmail.com> added the comment:

Just submitted a PR for this issue, however I only signed the CLA an hour ago so it hasn't gone through yet.

This is my first contribution, I followed the guide but please let me know if I missed anything. Thanks!

----------
nosy: +nkerr

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

From report at bugs.python.org  Thu Feb  1 22:12:59 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Fri, 02 Feb 2018 03:12:59 +0000
Subject: [docs] [issue32739] collections.deque rotate(n=1) default value not
 documented
In-Reply-To: <1517463893.34.0.467229070634.issue32739@psf.upfronthosting.co.za>
Message-ID: <1517541179.52.0.714561066657.issue32739@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Feb  1 22:13:55 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Fri, 02 Feb 2018 03:13:55 +0000
Subject: [docs] [issue32739] collections.deque rotate(n=1) default value not
 documented
In-Reply-To: <1517463893.34.0.467229070634.issue32739@psf.upfronthosting.co.za>
Message-ID: <1517541235.85.0.714561066657.issue32739@psf.upfronthosting.co.za>


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


----------
versions: +Python 3.7, Python 3.8

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

From report at bugs.python.org  Thu Feb  1 23:20:02 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 02 Feb 2018 04:20:02 +0000
Subject: [docs] [issue32674] minor documentation fix for '__import__'
In-Reply-To: <1516948902.25.0.467229070634.issue32674@psf.upfronthosting.co.za>
Message-ID: <1517545202.56.0.467229070634.issue32674@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:


New changeset 461d225b195eec5269f317323b41115516144c41 by Mariatta (oldk) in branch 'master':
bpo-32674: Improve the docstring for __import__ (GH-5339)
https://github.com/python/cpython/commit/461d225b195eec5269f317323b41115516144c41


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

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

From report at bugs.python.org  Thu Feb  1 23:20:21 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 02 Feb 2018 04:20:21 +0000
Subject: [docs] [issue32674] minor documentation fix for '__import__'
In-Reply-To: <1516948902.25.0.467229070634.issue32674@psf.upfronthosting.co.za>
Message-ID: <1517545221.58.0.714561066657.issue32674@psf.upfronthosting.co.za>


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


----------
pull_requests: +5318

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

From report at bugs.python.org  Thu Feb  1 23:21:11 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 02 Feb 2018 04:21:11 +0000
Subject: [docs] [issue32674] minor documentation fix for '__import__'
In-Reply-To: <1516948902.25.0.467229070634.issue32674@psf.upfronthosting.co.za>
Message-ID: <1517545271.03.0.714561066657.issue32674@psf.upfronthosting.co.za>


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


----------
pull_requests: +5319

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

From report at bugs.python.org  Fri Feb  2 00:29:37 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 02 Feb 2018 05:29:37 +0000
Subject: [docs] [issue20285] Improve object.__doc__ and help(object) output
In-Reply-To: <1389920351.63.0.12805701843.issue20285@psf.upfronthosting.co.za>
Message-ID: <1517549377.3.0.714561066657.issue20285@psf.upfronthosting.co.za>


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


----------
assignee: docs at python -> terry.reedy
components: +Library (Lib)
stage: patch review -> commit review
versions: +Python 3.6, Python 3.8

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

From report at bugs.python.org  Fri Feb  2 01:12:05 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 02 Feb 2018 06:12:05 +0000
Subject: [docs] [issue20285] Improve object.__doc__ and help(object) output
In-Reply-To: <1389920351.63.0.12805701843.issue20285@psf.upfronthosting.co.za>
Message-ID: <1517551925.26.0.467229070634.issue20285@psf.upfronthosting.co.za>


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

It is better to ask Guido or other language expert.

----------

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

From report at bugs.python.org  Fri Feb  2 01:35:52 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 02 Feb 2018 06:35:52 +0000
Subject: [docs] [issue20285] Improve object.__doc__ and help(object) output
In-Reply-To: <1389920351.63.0.12805701843.issue20285@psf.upfronthosting.co.za>
Message-ID: <1517553352.78.0.467229070634.issue20285@psf.upfronthosting.co.za>


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

Since this modifies the output of a library module function for a specific input, I will not backport unless and until there is agreement on doing so.

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

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

From report at bugs.python.org  Fri Feb  2 01:53:32 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 02 Feb 2018 06:53:32 +0000
Subject: [docs] [issue20285] Improve object.__doc__ and help(object) output
In-Reply-To: <1389920351.63.0.12805701843.issue20285@psf.upfronthosting.co.za>
Message-ID: <1517554412.11.0.467229070634.issue20285@psf.upfronthosting.co.za>


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

I posted "Is object the most base type?  (bpo-20285)" on pydev.

----------

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

From report at bugs.python.org  Fri Feb  2 02:49:51 2018
From: report at bugs.python.org (Qian Yun)
Date: Fri, 02 Feb 2018 07:49:51 +0000
Subject: [docs] [issue32747] remove trailing spaces in docstring
Message-ID: <1517557791.36.0.467229070634.issue32747@psf.upfronthosting.co.za>


New submission from Qian Yun <oldk1331 at gmail.com>:

This is a simple PR that removes trailing spaces in docstring,
which are found by:
    grep -R ' \\n\\$' .

----------
assignee: docs at python
components: Documentation
messages: 311484
nosy: Qian Yun, docs at python
priority: normal
severity: normal
status: open
title: remove trailing spaces in docstring
versions: Python 3.8

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

From report at bugs.python.org  Fri Feb  2 02:54:44 2018
From: report at bugs.python.org (Qian Yun)
Date: Fri, 02 Feb 2018 07:54:44 +0000
Subject: [docs] [issue32747] remove trailing spaces in docstring
In-Reply-To: <1517557791.36.0.467229070634.issue32747@psf.upfronthosting.co.za>
Message-ID: <1517558084.6.0.714561066657.issue32747@psf.upfronthosting.co.za>


Change by Qian Yun <oldk1331 at gmail.com>:


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

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

From report at bugs.python.org  Fri Feb  2 03:52:58 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 02 Feb 2018 08:52:58 +0000
Subject: [docs] [issue32747] remove trailing spaces in docstring
In-Reply-To: <1517557791.36.0.467229070634.issue32747@psf.upfronthosting.co.za>
Message-ID: <1517561578.83.0.467229070634.issue32747@psf.upfronthosting.co.za>


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


New changeset aa0735f597b072c0eb00404c4d7df359ddc26755 by Serhiy Storchaka (oldk) in branch 'master':
bpo-32747: Remove trailing spaces in docstrings. (GH-5491)
https://github.com/python/cpython/commit/aa0735f597b072c0eb00404c4d7df359ddc26755


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

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

From report at bugs.python.org  Fri Feb  2 03:53:24 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 02 Feb 2018 08:53:24 +0000
Subject: [docs] [issue32747] remove trailing spaces in docstring
In-Reply-To: <1517557791.36.0.467229070634.issue32747@psf.upfronthosting.co.za>
Message-ID: <1517561604.78.0.714561066657.issue32747@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/issue32747>
_______________________________________

From report at bugs.python.org  Fri Feb  2 05:00:41 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Fri, 02 Feb 2018 10:00:41 +0000
Subject: [docs] [issue30449] Improve __slots__ datamodel documentation
In-Reply-To: <1495587707.13.0.0998591622446.issue30449@psf.upfronthosting.co.za>
Message-ID: <1517565641.51.0.714561066657.issue30449@psf.upfronthosting.co.za>


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


----------
assignee: rhettinger -> 

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

From vadmium+py at gmail.com  Fri Feb  2 05:54:31 2018
From: vadmium+py at gmail.com (vadmium+py at gmail.com)
Date: Fri, 02 Feb 2018 10:54:31 -0000
Subject: [docs] include the "object" type in the lists of documented
 types (issue 16508)
Message-ID: <20180202105431.30689.80223@psf.upfronthosting.co.za>

I wrote some of this a long time ago, but never sent it. I agree with
most of Ezio?s comments, but I won?t be updating my patch any time soon.


https://bugs.python.org/review/16508/diff/15301/Doc/library/functions.rst
File Doc/library/functions.rst (right):

https://bugs.python.org/review/16508/diff/15301/Doc/library/functions.rst#newcode855
Doc/library/functions.rst:855: The constructor does not accept any
arguments.
On 2016/01/02 01:05:54, ezio.melotti wrote:
> What about:
> `object` is a type used as base class for all other classes.
> When called, it accepts no arguments and returns a new unique and
featureless
> object.

I like to start sentences and paragraphs with a capital letter. Also, in
Python 3, I understand ?type? and ?class? are the same thing, so let?s
be consistent within the one sentence. Rewriting your first sentence
again, how about:

class object
    This is a base class for all other classes. When called, it accepts
no arguments and returns a new unique and featureless object.

https://bugs.python.org/review/16508/diff/15301/Doc/library/stdtypes.rst
File Doc/library/stdtypes.rst (right):

https://bugs.python.org/review/16508/diff/15301/Doc/library/stdtypes.rst#newcode4326
Doc/library/stdtypes.rst:4326: instances of :class:`object`, the
universal type. Most of these support
On 2016/01/02 01:05:54, ezio.melotti wrote:
> I'm not sure I would use universal here.

I don?t know what I was thinking when I wrote that. Let?s drop it.

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

From report at bugs.python.org  Fri Feb  2 08:30:43 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 02 Feb 2018 13:30:43 +0000
Subject: [docs] [issue32674] minor documentation fix for '__import__'
In-Reply-To: <1516948902.25.0.467229070634.issue32674@psf.upfronthosting.co.za>
Message-ID: <1517578243.3.0.714561066657.issue32674@psf.upfronthosting.co.za>


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


----------
pull_requests: +5327

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

From report at bugs.python.org  Fri Feb  2 08:32:21 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 02 Feb 2018 13:32:21 +0000
Subject: [docs] [issue32674] minor documentation fix for '__import__'
In-Reply-To: <1516948902.25.0.467229070634.issue32674@psf.upfronthosting.co.za>
Message-ID: <1517578341.33.0.467229070634.issue32674@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:


New changeset f61951b10cc08d3926a3ebaacc154d4149150ef4 by Mariatta (Miss Islington (bot)) in branch '3.6':
bpo-32674: Improve the docstring for __import__ (GH-5339) (GH-5489)
https://github.com/python/cpython/commit/f61951b10cc08d3926a3ebaacc154d4149150ef4


----------

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

From report at bugs.python.org  Fri Feb  2 09:09:04 2018
From: report at bugs.python.org (R. David Murray)
Date: Fri, 02 Feb 2018 14:09:04 +0000
Subject: [docs] [issue20285] Improve object.__doc__ and help(object) output
In-Reply-To: <1389920351.63.0.12805701843.issue20285@psf.upfronthosting.co.za>
Message-ID: <1517580544.72.0.467229070634.issue20285@psf.upfronthosting.co.za>


R. David Murray <rdmurray at bitdance.com> added the comment:

If you want to be precise you could say "The last class in every __mro__ list."

----------
nosy: +r.david.murray

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

From report at bugs.python.org  Fri Feb  2 10:14:26 2018
From: report at bugs.python.org (Barry A. Warsaw)
Date: Fri, 02 Feb 2018 15:14:26 +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: <1517584466.82.0.467229070634.issue32216@psf.upfronthosting.co.za>


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

Do you have an ETA for the documentation PR?  I would be happy to review it.

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

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

From report at bugs.python.org  Fri Feb  2 10:24:22 2018
From: report at bugs.python.org (Eric V. Smith)
Date: Fri, 02 Feb 2018 15:24:22 +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: <1517585062.09.0.467229070634.issue32216@psf.upfronthosting.co.za>


Eric V. Smith <eric at trueblade.com> added the comment:

I was hoping a volunteer would step up to write the documentation, as it's definitely not my forte.

Raymond has also volunteered to help.

----------

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

From report at bugs.python.org  Fri Feb  2 10:50:39 2018
From: report at bugs.python.org (Ned Deily)
Date: Fri, 02 Feb 2018 15:50:39 +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: <1517586639.16.0.467229070634.issue32216@psf.upfronthosting.co.za>


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

Marking this as a "deferred blocker" for exiting the beta phase.

----------
nosy: +ned.deily
priority: high -> deferred blocker
stage:  -> needs patch
versions: +Python 3.8

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

From report at bugs.python.org  Fri Feb  2 11:24:01 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 02 Feb 2018 16:24:01 +0000
Subject: [docs] [issue32674] minor documentation fix for '__import__'
In-Reply-To: <1516948902.25.0.467229070634.issue32674@psf.upfronthosting.co.za>
Message-ID: <1517588641.0.0.467229070634.issue32674@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:


New changeset 9b7b3a64560269188fcb43445becc5aacb4de2dc by Mariatta in branch '2.7':
bpo-32674: Improve the docstring for __import__ (GH-5339) (GH-5494)
https://github.com/python/cpython/commit/9b7b3a64560269188fcb43445becc5aacb4de2dc


----------

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

From report at bugs.python.org  Fri Feb  2 11:25:38 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 02 Feb 2018 16:25:38 +0000
Subject: [docs] [issue32674] minor documentation fix for '__import__'
In-Reply-To: <1516948902.25.0.467229070634.issue32674@psf.upfronthosting.co.za>
Message-ID: <1517588738.86.0.467229070634.issue32674@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

Thanks!

----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed
versions: +Python 2.7, Python 3.6, Python 3.8

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

From report at bugs.python.org  Fri Feb  2 15:04:57 2018
From: report at bugs.python.org (Dmitry Alimov)
Date: Fri, 02 Feb 2018 20:04:57 +0000
Subject: [docs] [issue32743] Typo in hamt.c comments
In-Reply-To: <1517505411.15.0.467229070634.issue32743@psf.upfronthosting.co.za>
Message-ID: <1517601897.52.0.467229070634.issue32743@psf.upfronthosting.co.za>


Dmitry Alimov <dvalimov at gmail.com> added the comment:

Fixed

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

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

From report at bugs.python.org  Fri Feb  2 15:43:25 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 02 Feb 2018 20:43:25 +0000
Subject: [docs] [issue32614] Fix documentation examples of using re with
 escape sequences
In-Reply-To: <1516574858.82.0.467229070634.issue32614@psf.upfronthosting.co.za>
Message-ID: <1517604205.97.0.714561066657.issue32614@psf.upfronthosting.co.za>


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


----------
nosy: +serhiy.storchaka
versions: +Python 3.8

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

From report at bugs.python.org  Fri Feb  2 15:53:57 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Fri, 02 Feb 2018 20:53:57 +0000
Subject: [docs] [issue30516] Documentation for datetime substract operation
 incorrect?
In-Reply-To: <1496179333.45.0.413102703331.issue30516@psf.upfronthosting.co.za>
Message-ID: <1517604837.92.0.714561066657.issue30516@psf.upfronthosting.co.za>


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


----------
keywords: +easy
type:  -> enhancement
versions: +Python 3.8

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

From report at bugs.python.org  Fri Feb  2 16:16:35 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 02 Feb 2018 21:16:35 +0000
Subject: [docs] [issue32614] Fix documentation examples of using re with
 escape sequences
In-Reply-To: <1516574858.82.0.467229070634.issue32614@psf.upfronthosting.co.za>
Message-ID: <1517606195.44.0.467229070634.issue32614@psf.upfronthosting.co.za>


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


New changeset 66771422d0541289d0b1287bc3c28e8b5609f6b4 by Terry Jan Reedy (Cheryl Sabella) in branch 'master':
bpo-32614: Modify re examples to use a raw string to prevent warning (GH-5265)
https://github.com/python/cpython/commit/66771422d0541289d0b1287bc3c28e8b5609f6b4


----------

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

From report at bugs.python.org  Fri Feb  2 16:17:36 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 02 Feb 2018 21:17:36 +0000
Subject: [docs] [issue32614] Fix documentation examples of using re with
 escape sequences
In-Reply-To: <1516574858.82.0.467229070634.issue32614@psf.upfronthosting.co.za>
Message-ID: <1517606256.85.0.714561066657.issue32614@psf.upfronthosting.co.za>


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


----------
pull_requests: +5332

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

From report at bugs.python.org  Fri Feb  2 16:48:56 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 02 Feb 2018 21:48:56 +0000
Subject: [docs] [issue32614] Fix documentation examples of using re with
 escape sequences
In-Reply-To: <1516574858.82.0.467229070634.issue32614@psf.upfronthosting.co.za>
Message-ID: <1517608136.26.0.714561066657.issue32614@psf.upfronthosting.co.za>


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


----------
pull_requests: +5333

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

From report at bugs.python.org  Fri Feb  2 16:50:47 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 02 Feb 2018 21:50:47 +0000
Subject: [docs] [issue32614] Fix documentation examples of using re with
 escape sequences
In-Reply-To: <1516574858.82.0.467229070634.issue32614@psf.upfronthosting.co.za>
Message-ID: <1517608247.06.0.467229070634.issue32614@psf.upfronthosting.co.za>


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


New changeset c7de1d7ca62e2b67b90d6c178e63453c03833b75 by Terry Jan Reedy (Miss Islington (bot)) in branch '3.7':
bpo-32614: Modify re examples to use a raw string to prevent warning (GH-5265) (#5499)
https://github.com/python/cpython/commit/c7de1d7ca62e2b67b90d6c178e63453c03833b75


----------

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

From report at bugs.python.org  Fri Feb  2 17:13:29 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 02 Feb 2018 22:13:29 +0000
Subject: [docs] [issue13553] Tkinter Tk args and Gnome Shell application name
In-Reply-To: <1323306729.26.0.368335158355.issue13553@psf.upfronthosting.co.za>
Message-ID: <1517609609.54.0.714561066657.issue13553@psf.upfronthosting.co.za>


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


----------
versions: +Python 3.6, Python 3.8

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

From report at bugs.python.org  Fri Feb  2 17:37:38 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 02 Feb 2018 22:37:38 +0000
Subject: [docs] [issue32614] Fix documentation examples of using re with
 escape sequences
In-Reply-To: <1516574858.82.0.467229070634.issue32614@psf.upfronthosting.co.za>
Message-ID: <1517611058.62.0.467229070634.issue32614@psf.upfronthosting.co.za>


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


New changeset fbf8e823c02ac1c93a48609cc74e439e19ccb426 by Terry Jan Reedy in branch '3.6':
 [3.6] bpo-32614: Modify re examples to use a raw string to prevent wa?  ?rning (GH-5265) (GH-5500)
https://github.com/python/cpython/commit/fbf8e823c02ac1c93a48609cc74e439e19ccb426


----------

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

From report at bugs.python.org  Fri Feb  2 17:38:37 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 02 Feb 2018 22:38:37 +0000
Subject: [docs] [issue32614] Fix documentation examples of using re with
 escape sequences
In-Reply-To: <1516574858.82.0.467229070634.issue32614@psf.upfronthosting.co.za>
Message-ID: <1517611117.69.0.714561066657.issue32614@psf.upfronthosting.co.za>


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


----------
assignee: docs at python -> terry.reedy
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed
versions: +Python 3.6

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

From report at bugs.python.org  Fri Feb  2 17:59:06 2018
From: report at bugs.python.org (Paul Pinterits)
Date: Fri, 02 Feb 2018 22:59:06 +0000
Subject: [docs] [issue32752] no information about accessing typing.Generic
 type arguments
Message-ID: <1517612346.62.0.467229070634.issue32752@psf.upfronthosting.co.za>


New submission from Paul Pinterits <rawing7 at gmail.com>:

The documentation of the typing module explains how to instantiate generic types, but there is no information about how to extract the type arguments from a generic type.

Example:

>>> list_of_ints = typing.List[int]
>>> 
>>> # how do we get <class 'int'> out of list_of_ints?
>>> list_of_ints.???
<class 'int'>

Through trial and error I've discovered list_of_ints.__args__, which *seems* to be what I'm looking for, but since it's never mentioned in the docs, it's unclear whether this __args__ attribute is an implementation detail or not.

Please document the official/intended way to extract type arguments from a Generic.

----------
assignee: docs at python
components: Documentation
messages: 311520
nosy: Paul Pinterits, docs at python
priority: normal
severity: normal
status: open
title: no information about accessing typing.Generic type arguments
type: enhancement
versions: Python 3.5, Python 3.6

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

From report at bugs.python.org  Fri Feb  2 22:23:51 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 03 Feb 2018 03:23:51 +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: <1517628231.09.0.467229070634.issue32216@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

I'd be interested to help write the PR for this.

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

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

From report at bugs.python.org  Sat Feb  3 00:03:04 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 03 Feb 2018 05:03:04 +0000
Subject: [docs] [issue8722] Documentation for __getattr__
In-Reply-To: <1273896658.97.0.575873001655.issue8722@psf.upfronthosting.co.za>
Message-ID: <1517634184.36.0.467229070634.issue8722@psf.upfronthosting.co.za>


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

Nick, this is about better documenting the behavior of __get(set/del)attr__ in 3.x it relations to AttributeError in a property.  I think I understand what it does and think the patch is correct.  Could you either review or suggest someone else who better understands core behavior like this?

----------
components: +Interpreter Core
nosy: +ncoghlan
versions: +Python 3.8

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

From report at bugs.python.org  Sat Feb  3 11:46:36 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Sat, 03 Feb 2018 16:46:36 +0000
Subject: [docs] [issue32739] collections.deque rotate(n=1) default value not
 documented
In-Reply-To: <1517463893.34.0.467229070634.issue32739@psf.upfronthosting.co.za>
Message-ID: <1517676396.08.0.467229070634.issue32739@psf.upfronthosting.co.za>


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


New changeset 589c718a8e3bde017350f248f7f1c009240eb52b by Raymond Hettinger in branch 'master':
bpo-32739: Show default value for rotate() (GH-5485)
https://github.com/python/cpython/commit/589c718a8e3bde017350f248f7f1c009240eb52b


----------

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

From report at bugs.python.org  Sat Feb  3 11:46:38 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 03 Feb 2018 16:46:38 +0000
Subject: [docs] [issue32739] collections.deque rotate(n=1) default value not
 documented
In-Reply-To: <1517463893.34.0.467229070634.issue32739@psf.upfronthosting.co.za>
Message-ID: <1517676398.57.0.714561066657.issue32739@psf.upfronthosting.co.za>


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


----------
pull_requests: +5346

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

From report at bugs.python.org  Sat Feb  3 11:47:37 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 03 Feb 2018 16:47:37 +0000
Subject: [docs] [issue32739] collections.deque rotate(n=1) default value not
 documented
In-Reply-To: <1517463893.34.0.467229070634.issue32739@psf.upfronthosting.co.za>
Message-ID: <1517676457.1.0.714561066657.issue32739@psf.upfronthosting.co.za>


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


----------
pull_requests: +5347

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

From report at bugs.python.org  Sat Feb  3 12:08:44 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Sat, 03 Feb 2018 17:08:44 +0000
Subject: [docs] [issue32739] collections.deque rotate(n=1) default value not
 documented
In-Reply-To: <1517463893.34.0.467229070634.issue32739@psf.upfronthosting.co.za>
Message-ID: <1517677724.83.0.467229070634.issue32739@psf.upfronthosting.co.za>


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


New changeset 52f745852e49498d7dd86fd309ae57f6a7af568f by Raymond Hettinger (Miss Islington (bot)) in branch '3.7':
bpo-32739: Show default value for rotate() (GH-5485) (GH-5514)
https://github.com/python/cpython/commit/52f745852e49498d7dd86fd309ae57f6a7af568f


----------

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

From report at bugs.python.org  Sat Feb  3 13:27:42 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Sat, 03 Feb 2018 18:27:42 +0000
Subject: [docs] [issue32739] collections.deque rotate(n=1) default value not
 documented
In-Reply-To: <1517463893.34.0.467229070634.issue32739@psf.upfronthosting.co.za>
Message-ID: <1517682462.08.0.467229070634.issue32739@psf.upfronthosting.co.za>


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


New changeset 7eb3d1e7da42112ba879a5f8602891fa17963f9e by Raymond Hettinger (Miss Islington (bot)) in branch '3.6':
bpo-32739: Show default value for rotate() (GH-5485) (GH-5515)
https://github.com/python/cpython/commit/7eb3d1e7da42112ba879a5f8602891fa17963f9e


----------

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

From report at bugs.python.org  Sat Feb  3 16:30:50 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Sat, 03 Feb 2018 21:30:50 +0000
Subject: [docs] [issue32739] collections.deque rotate(n=1) default value not
 documented
In-Reply-To: <1517463893.34.0.467229070634.issue32739@psf.upfronthosting.co.za>
Message-ID: <1517693450.67.0.714561066657.issue32739@psf.upfronthosting.co.za>


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


----------
pull_requests: +5349

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

From report at bugs.python.org  Sat Feb  3 16:57:04 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Sat, 03 Feb 2018 21:57:04 +0000
Subject: [docs] [issue32739] collections.deque rotate(n=1) default value not
 documented
In-Reply-To: <1517463893.34.0.467229070634.issue32739@psf.upfronthosting.co.za>
Message-ID: <1517695024.36.0.467229070634.issue32739@psf.upfronthosting.co.za>


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


New changeset 42e8ea9f69c133a4bbb9e496f68a05926b99c2da by Raymond Hettinger in branch '2.7':
bpo-32739: Show default value for rotate() (GH-5517)
https://github.com/python/cpython/commit/42e8ea9f69c133a4bbb9e496f68a05926b99c2da


----------

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

From report at bugs.python.org  Sat Feb  3 17:32:43 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Sat, 03 Feb 2018 22:32:43 +0000
Subject: [docs] [issue32739] collections.deque rotate(n=1) default value not
 documented
In-Reply-To: <1517463893.34.0.467229070634.issue32739@psf.upfronthosting.co.za>
Message-ID: <1517697163.13.0.714561066657.issue32739@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Feb  3 18:32:41 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Sat, 03 Feb 2018 23:32:41 +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: <1517700761.34.0.467229070634.issue32216@psf.upfronthosting.co.za>


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

> I'd be interested to help write the PR for this.

I've already started on drafting these docs.  Would you like to work together?

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

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

From report at bugs.python.org  Sat Feb  3 22:25:34 2018
From: report at bugs.python.org (Christopher Barker)
Date: Sun, 04 Feb 2018 03:25:34 +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: <1517714734.78.0.467229070634.issue32216@psf.upfronthosting.co.za>


Christopher Barker <Chris.Barker at noaa.gov> added the comment:

Thanks Raymond. Can a draft be put in a gitHub repo so we can all help out?

----------

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

From report at bugs.python.org  Sat Feb  3 22:36:58 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sun, 04 Feb 2018 03:36:58 +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: <1517715418.37.0.467229070634.issue32216@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

> I've already started on drafting these docs.  Would you like to work together?

Sure, Raymond. Let me know how I can help :)

----------

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

From report at bugs.python.org  Sun Feb  4 00:42:10 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sun, 04 Feb 2018 05:42:10 +0000
Subject: [docs] [issue32720] Format mini-language integer definition is
 incorrect
In-Reply-To: <1517287529.39.0.467229070634.issue32720@psf.upfronthosting.co.za>
Message-ID: <1517722930.87.0.467229070634.issue32720@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:


New changeset 8b5fa289fdb04b6b919cf95fa99246aa872e47a8 by Mariatta (nathankerr96) in branch 'master':
bpo-32720: Fixed the definition for width and precision in format mini-language doc (GH-5482)
https://github.com/python/cpython/commit/8b5fa289fdb04b6b919cf95fa99246aa872e47a8


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

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

From report at bugs.python.org  Sun Feb  4 00:44:16 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 04 Feb 2018 05:44:16 +0000
Subject: [docs] [issue32720] Format mini-language integer definition is
 incorrect
In-Reply-To: <1517287529.39.0.467229070634.issue32720@psf.upfronthosting.co.za>
Message-ID: <1517723056.88.0.714561066657.issue32720@psf.upfronthosting.co.za>


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


----------
pull_requests: +5354

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

From report at bugs.python.org  Sun Feb  4 00:43:17 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 04 Feb 2018 05:43:17 +0000
Subject: [docs] [issue32720] Format mini-language integer definition is
 incorrect
In-Reply-To: <1517287529.39.0.467229070634.issue32720@psf.upfronthosting.co.za>
Message-ID: <1517722997.23.0.714561066657.issue32720@psf.upfronthosting.co.za>


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


----------
pull_requests: +5353

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

From report at bugs.python.org  Sun Feb  4 01:03:23 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sun, 04 Feb 2018 06:03:23 +0000
Subject: [docs] [issue32720] Format mini-language integer definition is
 incorrect
In-Reply-To: <1517287529.39.0.467229070634.issue32720@psf.upfronthosting.co.za>
Message-ID: <1517724203.89.0.467229070634.issue32720@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:


New changeset 133514e9dcea9c8cc9d9dd459b1a7fb502747d7e by Mariatta (Miss Islington (bot)) in branch '3.7':
bpo-32720: Fixed the definition for width and precision in format mini-language doc (GH-5482) (GH-5524)
https://github.com/python/cpython/commit/133514e9dcea9c8cc9d9dd459b1a7fb502747d7e


----------

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

From report at bugs.python.org  Sun Feb  4 01:26:18 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sun, 04 Feb 2018 06:26:18 +0000
Subject: [docs] [issue32720] Format mini-language integer definition is
 incorrect
In-Reply-To: <1517287529.39.0.467229070634.issue32720@psf.upfronthosting.co.za>
Message-ID: <1517725578.81.0.467229070634.issue32720@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:


New changeset 3bd749b2122c17b835dc438cdaef63bfdfd61344 by Mariatta (Miss Islington (bot)) in branch '3.6':
bpo-32720: Fixed the definition for width and precision in format mini-language doc (GH-5482) (GH-5525)
https://github.com/python/cpython/commit/3bd749b2122c17b835dc438cdaef63bfdfd61344


----------

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

From report at bugs.python.org  Sun Feb  4 01:28:50 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 04 Feb 2018 06:28:50 +0000
Subject: [docs] [issue32720] Format mini-language integer definition is
 incorrect
In-Reply-To: <1517287529.39.0.467229070634.issue32720@psf.upfronthosting.co.za>
Message-ID: <1517725730.78.0.467229070634.issue32720@psf.upfronthosting.co.za>


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

What about arg_name and element_index?

>>> '{}'.format(123)
'123'
>>> '{0}'.format(123)
'123'
>>> '{0x0}'.format(123)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
KeyError: '0x0'
>>> '{0_0}'.format(123)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
KeyError: '0_0'
>>> '{0[0]}'.format([123])
'123'
>>> '{0[0x0]}'.format([123])
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: list indices must be integers or slices, not str
>>> '{0[0_0]}'.format([123])
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: list indices must be integers or slices, not str

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

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

From report at bugs.python.org  Sun Feb  4 01:36:09 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 04 Feb 2018 06:36:09 +0000
Subject: [docs] [issue32739] collections.deque rotate(n=1) default value not
 documented
In-Reply-To: <1517463893.34.0.467229070634.issue32739@psf.upfronthosting.co.za>
Message-ID: <1517726169.82.0.467229070634.issue32739@psf.upfronthosting.co.za>


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

Isn't there a missed "not"?

----------
nosy: +serhiy.storchaka
status: closed -> open

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

From report at bugs.python.org  Sun Feb  4 11:17:22 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Sun, 04 Feb 2018 16:17:22 +0000
Subject: [docs] [issue32739] collections.deque rotate(n=1) default value not
 documented
In-Reply-To: <1517463893.34.0.467229070634.issue32739@psf.upfronthosting.co.za>
Message-ID: <1517761042.43.0.714561066657.issue32739@psf.upfronthosting.co.za>


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


----------
pull_requests: +5355
stage: resolved -> patch review

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

From report at bugs.python.org  Sun Feb  4 12:03:33 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 04 Feb 2018 17:03:33 +0000
Subject: [docs] [issue30569] Tutorial section 2.1 has *nix example at 3.7,
 but Windows at 3.6
In-Reply-To: <1496609553.39.0.613003310721.issue30569@psf.upfronthosting.co.za>
Message-ID: <1517763813.34.0.467229070634.issue30569@psf.upfronthosting.co.za>


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

This is still an issue.  Since it's more than updating the release version, I think someone more knowledgeable than me should fix it.  I wouldn't want to miss something that should be included.

----------
versions: +Python 3.8

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

From report at bugs.python.org  Sun Feb  4 12:16:23 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 04 Feb 2018 17:16:23 +0000
Subject: [docs] [issue32739] collections.deque rotate(n=1) default value not
 documented
In-Reply-To: <1517463893.34.0.467229070634.issue32739@psf.upfronthosting.co.za>
Message-ID: <1517764583.48.0.714561066657.issue32739@psf.upfronthosting.co.za>


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


----------
pull_requests: +5357

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

From report at bugs.python.org  Sun Feb  4 12:17:05 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 04 Feb 2018 17:17:05 +0000
Subject: [docs] [issue32739] collections.deque rotate(n=1) default value not
 documented
In-Reply-To: <1517463893.34.0.467229070634.issue32739@psf.upfronthosting.co.za>
Message-ID: <1517764625.43.0.714561066657.issue32739@psf.upfronthosting.co.za>


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


----------
pull_requests: +5358

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

From report at bugs.python.org  Sun Feb  4 12:25:30 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Sun, 04 Feb 2018 17:25:30 +0000
Subject: [docs] [issue32739] collections.deque rotate(n=1) default value not
 documented
In-Reply-To: <1517463893.34.0.467229070634.issue32739@psf.upfronthosting.co.za>
Message-ID: <1517765130.62.0.714561066657.issue32739@psf.upfronthosting.co.za>


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


----------
pull_requests: +5359

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

From report at bugs.python.org  Sun Feb  4 12:57:24 2018
From: report at bugs.python.org (John Hossbach)
Date: Sun, 04 Feb 2018 17:57:24 +0000
Subject: [docs] [issue32766] 4.7.7. Function Annotations
Message-ID: <1517767044.74.0.467229070634.issue32766@psf.upfronthosting.co.za>


New submission from John Hossbach <john.hossbach at gmail.com>:

https://docs.python.org/3.5/tutorial/controlflow.html#function-annotations

The end of the first paragraph states, "The following example has a positional argument, a keyword argument, and the return value annotated:"

However, the only function call is f('spam') which has a single positional argument.

I believe the author was referencing the output of print("Annotations:", f.__annotations__) which was:
Annotations: {'ham': <class 'str'>, 'return': <class 'str'>, 'eggs': <class 'str'>}

and then confused that with 4.7.2. Keyword Arguments (https://docs.python.org/3.5/tutorial/controlflow.html#keyword-arguments) where it points out that keyword arguments follow positional arguments.  However, the difference between identifying a positional argument vs keyword argument is done at the function CALL, not the function DEFINITION since any argument can be both positional or keyword, depending on how it is referenced.

Moreover, the last sentence in 4.7.2. Keyword Arguments, points out that the order of unsorted sequences is undefined, which would then explain why 'return' appears in the middle here instead of at the end.

----------
assignee: docs at python
components: Documentation
messages: 311612
nosy: John Hossbach, docs at python
priority: normal
severity: normal
status: open
title: 4.7.7. Function Annotations
versions: Python 3.5

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

From report at bugs.python.org  Sun Feb  4 14:27:00 2018
From: report at bugs.python.org (Tim Peters)
Date: Sun, 04 Feb 2018 19:27:00 +0000
Subject: [docs] [issue32767] Mutating a list while iterating: clarify the
 docs
Message-ID: <1517772420.88.0.467229070634.issue32767@psf.upfronthosting.co.za>


New submission from Tim Peters <tim at python.org>:

This has come up repeatedly, and the docs should be updated to resolve it:

https://stackoverflow.com/questions/48603998/python-iterating-over-a-list-but-i-want-to-add-to-that-list-while-in-the-loop/48604036#48604036

Seemingly the only relevant documentation is in the reference manual, but it's flawed:

https://docs.python.org/3.7/reference/compound_stmts.html#the-for-statement

- The behavior it's describing is specific to list iterators, but it pretends to apply to "mutable sequences" in general (which may or may not mimic list iterators in relevant respects).

- It's not clear that the "length of the sequence" (list!) is evaluated anew on each iteration (not, e.g., captured once at the start of the `for` loop).

- While it describes things that can go wrong, it doesn't describe the common useful case:  appending to a list during iteration (for example, in a breadth-first search).

----------
assignee: docs at python
components: Documentation
messages: 311614
nosy: docs at python, tim.peters
priority: normal
severity: normal
stage: needs patch
status: open
title: Mutating a list while iterating:  clarify the docs
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/issue32767>
_______________________________________

From report at bugs.python.org  Sun Feb  4 17:27:06 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Sun, 04 Feb 2018 22:27:06 +0000
Subject: [docs] [issue32739] collections.deque rotate(n=1) default value not
 documented
In-Reply-To: <1517463893.34.0.467229070634.issue32739@psf.upfronthosting.co.za>
Message-ID: <1517783226.8.0.714561066657.issue32739@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sun Feb  4 18:13:13 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 04 Feb 2018 23:13:13 +0000
Subject: [docs] [issue32769] Add 'annotations' to the glossary
Message-ID: <1517785993.58.0.714561066657.issue32769@psf.upfronthosting.co.za>


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


----------
assignee: docs at python
components: Documentation
keywords: easy
nosy: csabella, docs at python
priority: normal
severity: normal
status: open
title: Add 'annotations' to the glossary
type: enhancement
versions: Python 3.8

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

From report at bugs.python.org  Sun Feb  4 19:34:34 2018
From: report at bugs.python.org (Anthony Flury)
Date: Mon, 05 Feb 2018 00:34:34 +0000
Subject: [docs] [issue32770] collections.counter examples are misleading
Message-ID: <1517790874.74.0.467229070634.issue32770@psf.upfronthosting.co.za>


New submission from Anthony Flury <anthony.flury at btinternet.com>:

The first example given for collections.Counter is misleading - the documentation ideally should show the 'best' (one and only one) way to do something and the example is this : 

>>> # Tally occurrences of words in a list
>>> cnt = Counter()
>>> for word in ['red', 'blue', 'red', 'green', 'blue', 'blue']:
...     cnt[word] += 1
>>> cnt
Counter({'blue': 3, 'red': 2, 'green': 1})

clearly this could simply be : 

>>> # Tally occurrences of words in a list
>>> cnt = Counter(['red', 'blue', 'red', 'green', 'blue', 'blue'])
>>> cnt
Counter({'blue': 3, 'red': 2, 'green': 1})

(i.e. the iteration through the array is unneeded in this example).

The 2nd example is better in showing the 'entry-level' use of the Counter class.

There possibly does need to be a simple example of when you might manually increment the Counter class - but I don't think that the examples given illustrate that in a useful way; and I personally haven't come across a use-case for manually incrementing the Counter class entires that couldn't be accomplished with a comprehension or generator expression passed directly to the Counter constructor.

----------
assignee: docs at python
components: Documentation
messages: 311630
nosy: anthony-flury, docs at python
priority: normal
severity: normal
status: open
title: collections.counter examples are misleading
versions: Python 2.7, Python 3.4, Python 3.5, Python 3.6

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

From report at bugs.python.org  Sun Feb  4 21:03:25 2018
From: report at bugs.python.org (Nick Coghlan)
Date: Mon, 05 Feb 2018 02:03:25 +0000
Subject: [docs] [issue8722] Documentation for __getattr__
In-Reply-To: <1273896658.97.0.575873001655.issue8722@psf.upfronthosting.co.za>
Message-ID: <1517796205.61.0.467229070634.issue8722@psf.upfronthosting.co.za>


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


New changeset d1f318105b8781b01f3507d5cb0fd841b977d5f2 by Nick Coghlan (Cheryl Sabella) in branch 'master':
bpo-8722: Document __getattr__ behavior with AttributeError in property (GH-4754)
https://github.com/python/cpython/commit/d1f318105b8781b01f3507d5cb0fd841b977d5f2


----------

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

From report at bugs.python.org  Sun Feb  4 21:38:14 2018
From: report at bugs.python.org (Nick Coghlan)
Date: Mon, 05 Feb 2018 02:38:14 +0000
Subject: [docs] [issue32720] Format mini-language integer definition is
 incorrect
In-Reply-To: <1517287529.39.0.467229070634.issue32720@psf.upfronthosting.co.za>
Message-ID: <1517798294.03.0.467229070634.issue32720@psf.upfronthosting.co.za>


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

I didn't think to check those - it looks like they have the same problem with the same fix (i.e. the actual syntax is "digit+").

----------

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

From report at bugs.python.org  Sun Feb  4 21:41:28 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 05 Feb 2018 02:41:28 +0000
Subject: [docs] [issue8722] Documentation for __getattr__
In-Reply-To: <1273896658.97.0.575873001655.issue8722@psf.upfronthosting.co.za>
Message-ID: <1517798488.46.0.714561066657.issue8722@psf.upfronthosting.co.za>


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


----------
keywords: +patch
pull_requests: +5368

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

From report at bugs.python.org  Sun Feb  4 21:42:30 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 05 Feb 2018 02:42:30 +0000
Subject: [docs] [issue8722] Documentation for __getattr__
In-Reply-To: <1273896658.97.0.575873001655.issue8722@psf.upfronthosting.co.za>
Message-ID: <1517798550.35.0.714561066657.issue8722@psf.upfronthosting.co.za>


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


----------
pull_requests: +5369

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

From report at bugs.python.org  Sun Feb  4 22:10:03 2018
From: report at bugs.python.org (Nick Coghlan)
Date: Mon, 05 Feb 2018 03:10:03 +0000
Subject: [docs] [issue8722] Documentation for __getattr__
In-Reply-To: <1273896658.97.0.575873001655.issue8722@psf.upfronthosting.co.za>
Message-ID: <1517800203.15.0.467229070634.issue8722@psf.upfronthosting.co.za>


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


New changeset a8c25d1c7f0d395861cc3e10dd01989150891c95 by Nick Coghlan (Miss Islington (bot)) in branch '3.6':
[3.6] bpo-8722: Document __getattr__ behavior with AttributeError in property (GH-5542)
https://github.com/python/cpython/commit/a8c25d1c7f0d395861cc3e10dd01989150891c95


----------

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

From report at bugs.python.org  Sun Feb  4 22:11:47 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 05 Feb 2018 03:11:47 +0000
Subject: [docs] [issue32720] Format mini-language integer definition is
 incorrect
In-Reply-To: <1517287529.39.0.467229070634.issue32720@psf.upfronthosting.co.za>
Message-ID: <1517800307.09.0.714561066657.issue32720@psf.upfronthosting.co.za>


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


----------
pull_requests: +5370

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

From report at bugs.python.org  Sun Feb  4 22:16:51 2018
From: report at bugs.python.org (Nick Coghlan)
Date: Mon, 05 Feb 2018 03:16:51 +0000
Subject: [docs] [issue8722] Documentation for __getattr__
In-Reply-To: <1273896658.97.0.575873001655.issue8722@psf.upfronthosting.co.za>
Message-ID: <1517800611.73.0.467229070634.issue8722@psf.upfronthosting.co.za>


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


New changeset fea0a12f6bee4a36b2c9533003e33a12c58d2d91 by Nick Coghlan (Miss Islington (bot)) in branch '3.7':
[3.7] bpo-8722: Document __getattr__ behavior with AttributeError in property (GH-5543)
https://github.com/python/cpython/commit/fea0a12f6bee4a36b2c9533003e33a12c58d2d91


----------

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

From report at bugs.python.org  Sun Feb  4 22:27:04 2018
From: report at bugs.python.org (Nick Coghlan)
Date: Mon, 05 Feb 2018 03:27:04 +0000
Subject: [docs] [issue8722] Documentation for __getattr__
In-Reply-To: <1273896658.97.0.575873001655.issue8722@psf.upfronthosting.co.za>
Message-ID: <1517801223.95.0.467229070634.issue8722@psf.upfronthosting.co.za>


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

Thanks for the patch Cheryl, and for the reviews Terry!

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

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

From report at bugs.python.org  Sun Feb  4 23:36:16 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 05 Feb 2018 04:36:16 +0000
Subject: [docs] [issue32770] collections.counter examples are misleading
In-Reply-To: <1517790874.74.0.467229070634.issue32770@psf.upfronthosting.co.za>
Message-ID: <1517805376.67.0.467229070634.issue32770@psf.upfronthosting.co.za>


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

Thanks for the suggestion.  I respectfully disagree.  The "core" functionality of Counter is the ability to write c['x'] += 1 without risking a KeyError.  The add-on capability is to process an entire iterable all at once.   This is analogous to the list() builtin- where the core ability is to write s.append(e) and there is a convenience of calling list(iterable).

Another reason the first example goes first because it is simple.  It shows counting in isolation with no other distractions (an in-vitro example).

The second example is in a more complex environment incorporating file access and regular expressions (an in-vivo example).

FWIW, there are plenty of examples of using the += style.  Here's one I use in my Python courses:

    'Scan a log file from a NASA server'

    import collections, re, pprint

    visited = collections.Counter()
    with open('notes/nasa_19950801.log') as f:
        for line in f:
            mo = re.search(r'GET\s+(\S+)\s+200', line)
            if mo is not None:
                url = mo.group(1)
                visited[url] += 1

    pprint.pprint(visited.most_common(20))

I've had good luck with people understanding the docs as-is, so I'm going to decline the suggestion.  I do appreciate you taking the time to share your thoughts.

----------
assignee: docs at python -> rhettinger
nosy: +rhettinger
resolution:  -> not a bug
stage:  -> resolved
status: open -> closed

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

From report at bugs.python.org  Mon Feb  5 04:29:10 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 05 Feb 2018 09:29:10 +0000
Subject: [docs] [issue32720] Format mini-language integer definition is
 incorrect
In-Reply-To: <1517287529.39.0.467229070634.issue32720@psf.upfronthosting.co.za>
Message-ID: <1517822950.28.0.467229070634.issue32720@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:


New changeset 7a561afd2c79f63a6008843b83733911d07f0119 by Mariatta in branch 'master':
bpo-32720: Fixed the replacement field grammar documentation. (GH-5544)
https://github.com/python/cpython/commit/7a561afd2c79f63a6008843b83733911d07f0119


----------

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

From report at bugs.python.org  Mon Feb  5 04:30:18 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 05 Feb 2018 09:30:18 +0000
Subject: [docs] [issue32720] Format mini-language integer definition is
 incorrect
In-Reply-To: <1517287529.39.0.467229070634.issue32720@psf.upfronthosting.co.za>
Message-ID: <1517823018.96.0.714561066657.issue32720@psf.upfronthosting.co.za>


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


----------
pull_requests: +5372

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

From report at bugs.python.org  Mon Feb  5 04:31:11 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 05 Feb 2018 09:31:11 +0000
Subject: [docs] [issue32720] Format mini-language integer definition is
 incorrect
In-Reply-To: <1517287529.39.0.467229070634.issue32720@psf.upfronthosting.co.za>
Message-ID: <1517823071.9.0.714561066657.issue32720@psf.upfronthosting.co.za>


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


----------
pull_requests: +5373

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

From report at bugs.python.org  Mon Feb  5 08:11:56 2018
From: report at bugs.python.org (Anthony Flury)
Date: Mon, 05 Feb 2018 13:11:56 +0000
Subject: [docs] [issue32770] collections.counter examples are misleading
In-Reply-To: <1517790874.74.0.467229070634.issue32770@psf.upfronthosting.co.za>
Message-ID: <1517836316.25.0.467229070634.issue32770@psf.upfronthosting.co.za>


Anthony Flury <anthony.flury at btinternet.com> added the comment:

Raymond, 
I completely understand your comment but I do disagree.

My view would be that the documentation of the stdlib should document the entry level use cases.
The first example given uses nothing special from the Counter class - you could implement exactly the same with a defaultdict(int) - the only difference would be that output will read defaultdict(<type 'int'>,{'blue': 3, 'red': 2, 'green': 1}).

I think the examples in the documentation should at least demonstrate something important on the class being documented - and the first example doesn't.

I am very tempted to re-open - but I wont - no benefit in bouncing the status as we discuss this.

----------

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

From report at bugs.python.org  Mon Feb  5 11:35:56 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Mon, 05 Feb 2018 16:35:56 +0000
Subject: [docs] [issue32774] distutils: cyclic reference in the documentation
Message-ID: <1517848556.08.0.714561066657.issue32774@psf.upfronthosting.co.za>


Change by St?phane Wirtel <stephane at wirtel.be>:


----------
assignee: docs at python
components: Documentation
nosy: docs at python, matrixise
priority: normal
severity: normal
status: open
title: distutils: cyclic reference in the documentation
versions: Python 2.7, Python 3.6, Python 3.7, Python 3.8

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

From report at bugs.python.org  Mon Feb  5 11:38:23 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Mon, 05 Feb 2018 16:38:23 +0000
Subject: [docs] [issue32774] distutils: cyclic reference in the documentation
Message-ID: <1517848703.37.0.714561066657.issue32774@psf.upfronthosting.co.za>


Change by St?phane Wirtel <stephane at wirtel.be>:


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

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

From report at bugs.python.org  Mon Feb  5 11:39:31 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Mon, 05 Feb 2018 16:39:31 +0000
Subject: [docs] [issue32774] distutils: cyclic reference in the documentation
Message-ID: <1517848771.32.0.467229070634.issue32774@psf.upfronthosting.co.za>


New submission from St?phane Wirtel <stephane at wirtel.be>:

in the documentation of the distutils module, there is a cyclic references, just remove them because I think it's useless.

----------

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

From report at bugs.python.org  Mon Feb  5 13:12:51 2018
From: report at bugs.python.org (R. David Murray)
Date: Mon, 05 Feb 2018 18:12:51 +0000
Subject: [docs] [issue32774] distutils: cyclic reference in the documentation
In-Reply-To: <1517848771.32.0.467229070634.issue32774@psf.upfronthosting.co.za>
Message-ID: <1517854371.52.0.467229070634.issue32774@psf.upfronthosting.co.za>


R. David Murray <rdmurray at bitdance.com> added the comment:

This is a common pattern in our documentation.  It is done because ":mod:`xxx`" means that xxx should be formatted as a module name, rather than anything else.  While it is true that the formatting for most such references is currently the same, it could be different in principle, and is for a few.  It is in some ways unfortunate that it also always results in a link, so you will indeed find a number of places where the prefix is omitted, mostly commonly when the same entity is referenced several times in the same paragraph.

So, it is not completely clear cut, but I would recommend rejecting this and leaving the docs as is.

----------
nosy: +r.david.murray

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

From report at bugs.python.org  Mon Feb  5 13:36:28 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Mon, 05 Feb 2018 18:36:28 +0000
Subject: [docs] [issue31215] Add version changed notes for OpenSSL 1.1.0
 compatibility
In-Reply-To: <1502860659.7.0.930691554308.issue31215@psf.upfronthosting.co.za>
Message-ID: <1517855788.85.0.714561066657.issue31215@psf.upfronthosting.co.za>


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


----------
keywords: +easy
versions: +Python 3.8

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

From report at bugs.python.org  Mon Feb  5 14:04:46 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Mon, 05 Feb 2018 19:04:46 +0000
Subject: [docs] [issue32774] distutils: cyclic reference in the documentation
In-Reply-To: <1517848771.32.0.467229070634.issue32774@psf.upfronthosting.co.za>
Message-ID: <1517857486.55.0.467229070634.issue32774@psf.upfronthosting.co.za>


St?phane Wirtel <stephane at wirtel.be> added the comment:

ok, it's fine for me, I close this issue

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

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

From report at bugs.python.org  Mon Feb  5 15:05:04 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Mon, 05 Feb 2018 20:05:04 +0000
Subject: [docs] [issue32752] no information about accessing typing.Generic
 type arguments
In-Reply-To: <1517612346.62.0.467229070634.issue32752@psf.upfronthosting.co.za>
Message-ID: <1517861104.66.0.467229070634.issue32752@psf.upfronthosting.co.za>


St?phane Wirtel <stephane at wirtel.be> added the comment:

with the help command, you have a good documentation, help(list_of_ints), but you are right, there is no functions/methods for your need.

in the code of typing, there is a comment about __args__ but it is not used by the documentation.

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

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

From report at bugs.python.org  Mon Feb  5 21:08:01 2018
From: report at bugs.python.org (Tim Peters)
Date: Tue, 06 Feb 2018 02:08:01 +0000
Subject: [docs] [issue32767] Mutating a list while iterating: clarify the
 docs
In-Reply-To: <1517772420.88.0.467229070634.issue32767@psf.upfronthosting.co.za>
Message-ID: <1517882881.56.0.467229070634.issue32767@psf.upfronthosting.co.za>


Tim Peters <tim at python.org> added the comment:

Some other points to consider:  I don't think this belongs in the `for` statement docs at all.  Instead they should merely _note_ that what happens if a sequence being iterated over is mutated is up to the sequence iterator.

Then, e.g., the `list` docs should spell out the behavior currently (but, as already noted, incompletely) described.  From StackOverflow experience, I may be the only person in the world who knows that list behavior here is documented under the `for` statement - everyone else gives up after not finding a word about it in the `list` docs ;-)

`collections.deque` docs, in contrast, may wish to document the behavior of its iterators.  They in fact work hard to raise an exception if a size-changing mutation occurs during iteration, but that doesn't appear to be documented.  It's worth debating whether it should be.

Are there other mutable sequence types in the standard distribution?

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

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

From report at bugs.python.org  Mon Feb  5 21:21:09 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Tue, 06 Feb 2018 02:21:09 +0000
Subject: [docs] [issue32770] collections.counter examples are misleading
In-Reply-To: <1517790874.74.0.467229070634.issue32770@psf.upfronthosting.co.za>
Message-ID: <1517883669.82.0.467229070634.issue32770@psf.upfronthosting.co.za>


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

You know, I'm not sure if I had ever seen that example before.  When you click Counter at the top of the page, it goes right to the class definition, which is past the example.

Having said that, I really like the example.  Until now, I didn't realize what Raymond said above about Counters (that the core ability is to write c['x'] += 1 without a KeyError).  So, thanks to this report, I learned that today!

One thing that did surprise me in the example is that I expected the repr to be in insertion order in 3.7.  The class description says 'It is an unordered collection where elements are stored as dictionary keys' and I was wondering if that was still true since dicts now have a guaranteed order.  I tried it on the example, which still printed Counter({'blue': 3, 'red': 2, 'green': 1})!  Of course it makes sense after looking at the code because it calls `most_common` in the repr, but I hadn't realized that before.  So, two things learned about Counter today.   :-)

Anyway, writing this here to ask about the wording regarding 'unordered collection'.

Thanks!

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

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

From report at bugs.python.org  Tue Feb  6 02:20:23 2018
From: report at bugs.python.org (Anthony Flury)
Date: Tue, 06 Feb 2018 07:20:23 +0000
Subject: [docs] [issue32770] collections.counter examples are misleading
In-Reply-To: <1517790874.74.0.467229070634.issue32770@psf.upfronthosting.co.za>
Message-ID: <1517901623.21.0.467229070634.issue32770@psf.upfronthosting.co.za>


Anthony Flury <anthony.flury at btinternet.com> added the comment:

Cheryl : 
When you iterate around a counter instance it does return keys in the order they are first encountered/inserted - so I agree with you that it is an ordered collection from Python 3.7 onwards (although the iteration and the repr are ordered in different orders.

----------

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

From mail at bachsau.name  Sun Feb  4 08:19:14 2018
From: mail at bachsau.name (Sven Heinemann)
Date: Sun, 4 Feb 2018 14:19:14 +0100
Subject: [docs] Signature of configparser.ConfigParser
Message-ID: <771ae5a5-809f-254b-f282-18aa90b0f388@bachsau.name>

I just tried to set up a ConfigParser by giving all settings as 
positional arguments. According to the documentation, this should be 
possible. However, I got the error message, that ConfigParser.__init__() 
only accepts up to four positional arguments, effectively three, since 
the first one is `self`. I had to inspect its constructor to find out 
what's really going on. It should be documented.

-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/pkcs7-signature
Size: 4199 bytes
Desc: S/MIME Cryptographic Signature
URL: <http://mail.python.org/pipermail/docs/attachments/20180204/2b5c1c1c/attachment.bin>

From mayankgupta18198 at gmail.com  Sat Feb  3 23:17:51 2018
From: mayankgupta18198 at gmail.com (Mayank Gupta)
Date: Sun, 4 Feb 2018 09:47:51 +0530
Subject: [docs] Very light print of docs for Python 2.7.14
Message-ID: <CAJNRPQSr0a24bLNC7ZRic6phW4TgPo_41YgOvsHvJerDaLMvJQ@mail.gmail.com>

Hi,

The pdf version of the docs available for Python 2.7.14 at your site,
https://docs.python.org/2.7/download.html are in very light print. The font
is very small and faded making it impossible to read the documentation.
I request you to rectify this as soon as possible.

Thanks in advance,
Mayank.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180204/d698926d/attachment.html>

From misterdjakis at gmail.com  Mon Feb  5 07:36:34 2018
From: misterdjakis at gmail.com (Djakaria Ouattara)
Date: Mon, 5 Feb 2018 12:36:34 +0000
Subject: [docs] Biginners guide
Message-ID: <CAEXPf7tWx0Cpm6JZ7eM=G8VAuEGLM=upT5cjm6yhTDNqq7C4xw@mail.gmail.com>

Dear Madam,

I am very interested to the Python programing language but I just want to
start my owner skills. So please can you send to me all documents I will
need to succeed and become a strong programmer in a few time. It is my aim
and dream since I was born.

Sincerely greeting to the team for all things you do to achieve our life.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180205/f8a37a23/attachment.html>

From report at bugs.python.org  Tue Feb  6 13:08:56 2018
From: report at bugs.python.org (Stefan Pochmann)
Date: Tue, 06 Feb 2018 18:08:56 +0000
Subject: [docs] [issue32767] Mutating a list while iterating: clarify the
 docs
In-Reply-To: <1517772420.88.0.467229070634.issue32767@psf.upfronthosting.co.za>
Message-ID: <1517940536.71.0.467229070634.issue32767@psf.upfronthosting.co.za>


Stefan Pochmann <stefan.pochmann at gmail.com> added the comment:

Yes, there's also `array.array`.

----------
nosy: +Stefan Pochmann

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

From report at bugs.python.org  Tue Feb  6 20:14:23 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 07 Feb 2018 01:14:23 +0000
Subject: [docs] [issue32720] Format mini-language integer definition is
 incorrect
In-Reply-To: <1517287529.39.0.467229070634.issue32720@psf.upfronthosting.co.za>
Message-ID: <1517966062.79.0.467229070634.issue32720@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:


New changeset a747cf6d9b87ea8c7ce3a42d09e5b966c8e83fa0 by Mariatta (Miss Islington (bot)) in branch '3.7':
bpo-32720: Fixed the replacement field grammar documentation. (GH-5544) (GH-5546)
https://github.com/python/cpython/commit/a747cf6d9b87ea8c7ce3a42d09e5b966c8e83fa0


----------

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

From report at bugs.python.org  Wed Feb  7 10:46:00 2018
From: report at bugs.python.org (Stefan Pochmann)
Date: Wed, 07 Feb 2018 15:46:00 +0000
Subject: [docs] [issue32767] Mutating a list while iterating: clarify the
 docs
In-Reply-To: <1517772420.88.0.467229070634.issue32767@psf.upfronthosting.co.za>
Message-ID: <1518018360.17.0.467229070634.issue32767@psf.upfronthosting.co.za>


Stefan Pochmann <stefan.pochmann at gmail.com> added the comment:

And `bytearray`.

----------

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

From report at bugs.python.org  Wed Feb  7 10:53:39 2018
From: report at bugs.python.org (Pedro)
Date: Wed, 07 Feb 2018 15:53:39 +0000
Subject: [docs] [issue32789] Note missing from logging.debug() docs
Message-ID: <1518018819.58.0.467229070634.issue32789@psf.upfronthosting.co.za>


New submission from Pedro <pgacv2+pythonbugs at gmail.com>:

The docs for Logger.debug() (https://docs.python.org/3/library/logging.html#logging.Logger.debug) specify that exc_info can take an exception instance as of version 3.5.

However, the docs for logging.debug() (https://docs.python.org/3/library/logging.html#logging.debug) do not, even though logging.debug() redirects to an instance of Logger and so can take the same types of arguments.

----------
assignee: docs at python
components: Documentation
messages: 311792
nosy: docs at python, pgacv2
priority: normal
severity: normal
status: open
title: Note missing from logging.debug() docs
type: enhancement
versions: Python 3.5, Python 3.6, Python 3.7, Python 3.8

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

From report at bugs.python.org  Wed Feb  7 11:01:32 2018
From: report at bugs.python.org (Pedro)
Date: Wed, 07 Feb 2018 16:01:32 +0000
Subject: [docs] [issue32789] Note missing from logging.debug() docs
In-Reply-To: <1518018819.58.0.467229070634.issue32789@psf.upfronthosting.co.za>
Message-ID: <1518019292.52.0.467229070634.issue32789@psf.upfronthosting.co.za>


Pedro <pgacv2+pythonbugs at gmail.com> added the comment:

Might be cleaner to just say, "The arguments are interpreted as for debug/info/warning/error/critical/exception/log," but with the bookmark URL pointing to the Logger methods.

----------

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

From report at bugs.python.org  Wed Feb  7 11:09:37 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Wed, 07 Feb 2018 16:09:37 +0000
Subject: [docs] [issue32769] Add 'annotations' to the glossary
Message-ID: <1518019777.95.0.467229070634.issue32769@psf.upfronthosting.co.za>


New submission from St?phane Wirtel <stephane at wirtel.be>:

There is a description of the annotation in the Glossary, but with 'function annotation'

maybe we could rename 'function annotation' by 'annotation'

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

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

From report at bugs.python.org  Wed Feb  7 11:18:10 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Wed, 07 Feb 2018 16:18:10 +0000
Subject: [docs] [issue31937] Add the term "dunder" to the glossary
In-Reply-To: <1509742669.66.0.213398074469.issue31937@psf.upfronthosting.co.za>
Message-ID: <1518020290.1.0.467229070634.issue31937@psf.upfronthosting.co.za>


St?phane Wirtel <stephane at wirtel.be> added the comment:

Just added the term in the glossary

If you want to review this PR, thank you

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

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

From report at bugs.python.org  Wed Feb  7 11:17:38 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Wed, 07 Feb 2018 16:17:38 +0000
Subject: [docs] [issue31937] Add the term "dunder" to the glossary
In-Reply-To: <1509742669.66.0.213398074469.issue31937@psf.upfronthosting.co.za>
Message-ID: <1518020258.42.0.714561066657.issue31937@psf.upfronthosting.co.za>


Change by St?phane Wirtel <stephane at wirtel.be>:


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

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

From report at bugs.python.org  Wed Feb  7 12:29:14 2018
From: report at bugs.python.org (R. David Murray)
Date: Wed, 07 Feb 2018 17:29:14 +0000
Subject: [docs] [issue31937] Add the term "dunder" to the glossary
In-Reply-To: <1509742669.66.0.213398074469.issue31937@psf.upfronthosting.co.za>
Message-ID: <1518024554.66.0.467229070634.issue31937@psf.upfronthosting.co.za>


R. David Murray <rdmurray at bitdance.com> added the comment:

EAFP and BDFL are not python folk terminology (the former never was, the latter may have originated with us but it has widespread use).  They are also acronyms.  'dunder' is the phonetic spelling of a way of pronouncing punctuation.  Raymond's examples of 'stir' and 'repper' are similar: phonetic spellings of ways of pronouncing something that isn't a word.

It seems to me that such phonetic spellings do no belong in the glossary.  The counter argument is that unlike the other two 'dunder' does appear *occasionally* in text...but the only place it appears in our documentation (that I can find via grep) is in the enum docs, and there it should be replaced by the correct term "special methods", especially since it there it is spelled "__dunder__".

For 'stir' and 'repper' the text spelling is __str__/str and __repr__/repr, for 'dunder XXX' the correct text spelling is the special method name, and for the "dunder method" the correct spelling (and I would argue the correct pronunciation :) is "special method".  That is, 'dunder' is mostly used in speech, not text.  It is not a "word" in the sense that the rest of the glossary entries are.
  
So, I vote with Raymond and others that this term does *not* belong in our glossary.

I recommend closing this issue as rejected.

----------
nosy: +r.david.murray

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

From report at bugs.python.org  Wed Feb  7 15:07:12 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Wed, 07 Feb 2018 20:07:12 +0000
Subject: [docs] [issue31937] Add the term "dunder" to the glossary
In-Reply-To: <1509742669.66.0.213398074469.issue31937@psf.upfronthosting.co.za>
Message-ID: <1518034032.89.0.467229070634.issue31937@psf.upfronthosting.co.za>


St?phane Wirtel <stephane at wirtel.be> added the comment:

David, 

I have no objection to closing this issue and I totally agree with your comment.

----------

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

From knutson at cray.com  Tue Feb  6 14:18:09 2018
From: knutson at cray.com (Erik Knutson)
Date: Tue, 6 Feb 2018 19:18:09 +0000
Subject: [docs] Python 3.6.4 documentation of re $
Message-ID: <CY4PR11MB18328ED54892000F73EB7073CAFD0@CY4PR11MB1832.namprd11.prod.outlook.com>

>From https://docs.python.org/3.6/library/re.html with English 3.6.4 selected:

$
Matches the end of the string or just before the newline at the end of the string, and in MULTILINE mode also matches before a newline. ...

I found that a regular expression such as r"Text:([^|]).*$" would include the newline in the match group if there is no "|". The "or just before the newline" in the documentation can be interpreted as requiring a newline to follow the $ and not be included in the match group.

Erik Knutson


From report at bugs.python.org  Thu Feb  8 10:11:03 2018
From: report at bugs.python.org (Christian Heimes)
Date: Thu, 08 Feb 2018 15:11:03 +0000
Subject: [docs] [issue32798] mmap.flush() on Linux does not accept the
 "offset" and "size" args
In-Reply-To: <1518102419.01.0.467229070634.issue32798@psf.upfronthosting.co.za>
Message-ID: <1518102663.84.0.467229070634.issue32798@psf.upfronthosting.co.za>


Christian Heimes <lists at cheimes.de> added the comment:

offset must be a multiple of pagesize. This is a known but undocumented restriction on some platforms, see http://man7.org/linux/man-pages/man2/msync.2.html

----------
assignee:  -> docs at python
components: +Documentation -Library (Lib)
nosy: +christian.heimes, docs at python
priority: normal -> low
type: crash -> behavior
versions: +Python 3.6, Python 3.7, Python 3.8

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

From report at bugs.python.org  Thu Feb  8 10:14:12 2018
From: report at bugs.python.org (Christian Heimes)
Date: Thu, 08 Feb 2018 15:14:12 +0000
Subject: [docs] [issue32798] mmap.flush() on Linux does not accept the
 "offset" and "size" args
In-Reply-To: <1518102419.01.0.467229070634.issue32798@psf.upfronthosting.co.za>
Message-ID: <1518102852.82.0.467229070634.issue32798@psf.upfronthosting.co.za>


Christian Heimes <lists at cheimes.de> added the comment:

I'm marking this as a low priority and simple documentation bug. The mmap module exposes the page size of the architecture as mmap.PAGESIZE.

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

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

From report at bugs.python.org  Thu Feb  8 10:22:34 2018
From: report at bugs.python.org (Byron Hawkins)
Date: Thu, 08 Feb 2018 15:22:34 +0000
Subject: [docs] [issue32798] mmap.flush() on Linux does not accept the
 "offset" and "size" args
In-Reply-To: <1518102419.01.0.467229070634.issue32798@psf.upfronthosting.co.za>
Message-ID: <1518103354.23.0.467229070634.issue32798@psf.upfronthosting.co.za>


Byron Hawkins <byron.c.hawkins at gmail.com> added the comment:

Couldn't the implementation check the page size and throw a better error (for relevant platforms)? Or better yet, adjust the offset to the nearest inclusive page boundary.

----------

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

From report at bugs.python.org  Thu Feb  8 10:33:14 2018
From: report at bugs.python.org (sblondon)
Date: Thu, 08 Feb 2018 15:33:14 +0000
Subject: [docs] [issue32800] Replace deprecated link to new page on w3c site
Message-ID: <1518103994.08.0.467229070634.issue32800@psf.upfronthosting.co.za>


New submission from sblondon <stephane.blondon at gmail.com>:

The documentation about namespace of ElemenTree (https://docs.python.org/3/library/xml.etree.elementtree.html#parsing-xml-with-namespaces) has a link for 'default namespace' to 'https://www.w3.org/TR/2006/REC-xml-names-20060816/#defaulting'.
This page displays a big red message because the page is outdated. It can be replaced by the new one: https://www.w3.org/TR/xml-names/#defaulting

The content of the paragraph in the new version is equivalent to the old one.


I can provide a PR if you are interested.

----------
assignee: docs at python
components: Documentation
messages: 311837
nosy: docs at python, sblondon
priority: normal
severity: normal
status: open
title: Replace deprecated link to new page on w3c site
type: enhancement

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

From report at bugs.python.org  Thu Feb  8 14:40:01 2018
From: report at bugs.python.org (Mark Dickinson)
Date: Thu, 08 Feb 2018 19:40:01 +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: <1518118801.4.0.467229070634.issue32790@psf.upfronthosting.co.za>


Mark Dickinson <dickinsm at gmail.com> added the comment:

> Maybe the documentation could also add this information in the chart for 'g' here:

Agreed that that would make sense. All the information is *there* in the docs (the alternate format is described a bit above that table), but it's not very easy to extract the information.

And that table entry is misleading as it currently is, since it suggests that trailing zeros are removed unconditionally: "In both cases insignificant trailing zeros are removed from the significand, and the decimal point is also removed if there are no remaining digits following it."

Perhaps we could adopt something like the wording in the C standard, where it says:

> Finally, unless the # flag is used, any trailing zeros are removed
> from the fractional portion of the result and the decimal-point
> character is removed if there is no fractional portion remaining.

Re-classifying as a documentation issue.

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

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

From report at bugs.python.org  Thu Feb  8 20:33:21 2018
From: report at bugs.python.org (Julian O)
Date: Fri, 09 Feb 2018 01:33:21 +0000
Subject: [docs] [issue32804] urllib.retrieve documentation doesn't mention
 context parameter
Message-ID: <1518140001.56.0.467229070634.issue32804@psf.upfronthosting.co.za>


New submission from Julian O <pythontracker at somethinkodd.com>:

In 2014, urlretrieve was changed to accept a context parameter to configure, for example, SSL settings.

Ref: https://github.com/python/cpython/commit/b206473ef8a7abe9abf5ab8776ea3bcb90adc747

However, 2.7.14 documentation does not mention this parameter.

> urllib.urlretrieve(url[, filename[, reporthook[, data]]])

Ref: https://docs.python.org/2/library/urllib.html

----------
assignee: docs at python
components: Documentation
messages: 311861
nosy: docs at python, julian_o
priority: normal
severity: normal
status: open
title: urllib.retrieve documentation doesn't mention context parameter
versions: Python 2.7

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

From report at bugs.python.org  Fri Feb  9 00:54:37 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Fri, 09 Feb 2018 05:54:37 +0000
Subject: [docs] [issue32804] urllib.retrieve documentation doesn't mention
 context parameter
In-Reply-To: <1518140001.56.0.467229070634.issue32804@psf.upfronthosting.co.za>
Message-ID: <1518155677.04.0.467229070634.issue32804@psf.upfronthosting.co.za>


St?phane Wirtel <stephane at wirtel.be> added the comment:

effectively, there is no documentation about this new parameter.

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

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

From report at bugs.python.org  Fri Feb  9 00:54:58 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Fri, 09 Feb 2018 05:54:58 +0000
Subject: [docs] [issue32804] urllib.retrieve documentation doesn't mention
 context parameter
In-Reply-To: <1518140001.56.0.467229070634.issue32804@psf.upfronthosting.co.za>
Message-ID: <1518155698.24.0.714561066657.issue32804@psf.upfronthosting.co.za>


Change by St?phane Wirtel <stephane at wirtel.be>:


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

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

From report at bugs.python.org  Fri Feb  9 07:48:24 2018
From: report at bugs.python.org (=?utf-8?b?0JzQsNGA0Log0JrQvtGA0LXQvdCx0LXRgNCz?=)
Date: Fri, 09 Feb 2018 12:48:24 +0000
Subject: [docs] [issue32798] mmap.flush() on Linux does not accept the
 "offset" and "size" args
In-Reply-To: <1518102419.01.0.467229070634.issue32798@psf.upfronthosting.co.za>
Message-ID: <1518180503.97.0.467229070634.issue32798@psf.upfronthosting.co.za>


???? ????????? <socketpair at gmail.com> added the comment:

Actually documented: 

http://man7.org/linux/man-pages/man2/msync.2.html

EINVAL: addr is not a multiple of PAGESIZE;

----------
nosy: +socketpair

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

From report at bugs.python.org  Fri Feb  9 12:51:33 2018
From: report at bugs.python.org (Ivan Levkivskyi)
Date: Fri, 09 Feb 2018 17:51:33 +0000
Subject: [docs] [issue32769] Add 'annotations' to the glossary
In-Reply-To: <1518019777.95.0.467229070634.issue32769@psf.upfronthosting.co.za>
Message-ID: <1518198693.06.0.467229070634.issue32769@psf.upfronthosting.co.za>


Ivan Levkivskyi <levkivskyi at gmail.com> added the comment:

This is a rather small change, so probably it would be easier to discuss it in a PR.

----------
nosy: +levkivskyi

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

From report at bugs.python.org  Fri Feb  9 12:57:05 2018
From: report at bugs.python.org (Ivan Levkivskyi)
Date: Fri, 09 Feb 2018 17:57:05 +0000
Subject: [docs] [issue32752] no information about accessing typing.Generic
 type arguments
In-Reply-To: <1517612346.62.0.467229070634.issue32752@psf.upfronthosting.co.za>
Message-ID: <1518199024.91.0.467229070634.issue32752@psf.upfronthosting.co.za>


Ivan Levkivskyi <levkivskyi at gmail.com> added the comment:

There is a third party library on PyPI called typing_inspect that provides thin wrappers around internal APIs to get lots of useful information about generics and other special types in typing.

If there will be more requests like this, then the most used functions from there might be moved to typing itself. Or is it already enough? (Especially in view of recent typing refactoring that simplified the internal APIs.)

----------
nosy: +gvanrossum, levkivskyi

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

From report at bugs.python.org  Fri Feb  9 14:35:27 2018
From: report at bugs.python.org (R. David Murray)
Date: Fri, 09 Feb 2018 19:35:27 +0000
Subject: [docs] [issue32769] Add 'annotations' to the glossary
In-Reply-To: <1518019777.95.0.467229070634.issue32769@psf.upfronthosting.co.za>
Message-ID: <1518204927.69.0.467229070634.issue32769@psf.upfronthosting.co.za>


R. David Murray <rdmurray at bitdance.com> added the comment:

PRs are for discussing proposed text/code.  Discussion of whether or not to do this belongs here.  (I have no opinion on this issue myself.)

----------
nosy: +r.david.murray

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

From report at bugs.python.org  Fri Feb  9 14:43:33 2018
From: report at bugs.python.org (Ivan Levkivskyi)
Date: Fri, 09 Feb 2018 19:43:33 +0000
Subject: [docs] [issue32769] Add 'annotations' to the glossary
In-Reply-To: <1518019777.95.0.467229070634.issue32769@psf.upfronthosting.co.za>
Message-ID: <1518205413.61.0.467229070634.issue32769@psf.upfronthosting.co.za>


Ivan Levkivskyi <levkivskyi at gmail.com> added the comment:

I wanted to say implicitly that I like the idea, and that we should figure out details in a PR. But of course if someone is against this, then we should wait with a PR.

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

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

From report at bugs.python.org  Fri Feb  9 16:26:01 2018
From: report at bugs.python.org (Guido van Rossum)
Date: Fri, 09 Feb 2018 21:26:01 +0000
Subject: [docs] [issue32769] Add 'annotations' to the glossary
In-Reply-To: <1518019777.95.0.467229070634.issue32769@psf.upfronthosting.co.za>
Message-ID: <1518211561.14.0.467229070634.issue32769@psf.upfronthosting.co.za>


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

I'm all for adding a bunch of terms related to type hints/annotations to the Glossary.

----------

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

From report at bugs.python.org  Fri Feb  9 19:18:23 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sat, 10 Feb 2018 00:18:23 +0000
Subject: [docs] [issue32769] Add 'annotations' to the glossary
In-Reply-To: <1518019777.95.0.467229070634.issue32769@psf.upfronthosting.co.za>
Message-ID: <1518221903.87.0.714561066657.issue32769@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Feb  9 19:51:24 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 10 Feb 2018 00:51:24 +0000
Subject: [docs] [issue32766] 4.7.7. Function Annotations
In-Reply-To: <1517767044.74.0.467229070634.issue32766@psf.upfronthosting.co.za>
Message-ID: <1518223884.27.0.467229070634.issue32766@psf.upfronthosting.co.za>


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

3.5 and its docs are frozen except for security patches.  The 3.7 doc is identical.

The sentence refers to the def statement and perhaps should say so.  It should end with 'a required argument, an optional argument, and the return value annotated'.  Or maybe better, 'annotations for ... and the return value.'

In 3.6, cpython dicts became (unofficially) input ordered.  In 3.7, this became official for Python dicts.  The example output should be changed to what it is now.  (This is an example where the change produces better output.)

Annotations: {'ham': <class 'str'>, 'eggs': <class 'str'>, 'return': <class 'str'>}

----------
nosy: +terry.reedy
versions: +Python 3.6, Python 3.7, Python 3.8 -Python 3.5

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

From report at bugs.python.org  Fri Feb  9 22:31:54 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 10 Feb 2018 03:31:54 +0000
Subject: [docs] [issue32767] Mutating a list while iterating: clarify the
 docs
In-Reply-To: <1517772420.88.0.467229070634.issue32767@psf.upfronthosting.co.za>
Message-ID: <1518233513.98.0.467229070634.issue32767@psf.upfronthosting.co.za>


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

Replace 'sequence' with 'collection' and I agree.  The for loop code just calls iter() and it.next() until an exception.  The behavior of it.next for builtins should be documented with the builtins.  (I think there is something already about dict iteration in the dict entry.)

I agree we should say that the list iterator checks the internal index against the current .__len__() on each .next call.  I had not thought about the usefullness of doing that for breadth-first search, so yes, mention that.

----------
nosy: +terry.reedy
versions:  -Python 2.7, Python 3.4, Python 3.6, Python 3.7, Python 3.8

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

From report at bugs.python.org  Fri Feb  9 22:58:54 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 10 Feb 2018 03:58:54 +0000
Subject: [docs] [issue32800] Replace deprecated link to new page on w3c site
In-Reply-To: <1518103994.08.0.467229070634.issue32800@psf.upfronthosting.co.za>
Message-ID: <1518235134.9.0.467229070634.issue32800@psf.upfronthosting.co.za>


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

Ah, yes, the 'big red message' nicely gives the replacement.  Please submit a PR against master.  Include a news blurb if you can (explained in the devguide).  If you cannot set the backport labels (I don't know of non-committer author's are allowed to, mention that all 3 are needed in a comment (I checked 2.7 and 3.8).

----------
nosy: +terry.reedy
stage:  -> needs patch
type: enhancement -> behavior
versions: +Python 2.7, Python 3.6, Python 3.7, Python 3.8

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

From report at bugs.python.org  Fri Feb  9 23:11:42 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 10 Feb 2018 04:11:42 +0000
Subject: [docs] [issue32804] urllib.retrieve documentation doesn't mention
 context parameter
In-Reply-To: <1518140001.56.0.467229070634.issue32804@psf.upfronthosting.co.za>
Message-ID: <1518235902.87.0.714561066657.issue32804@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Feb 10 08:23:01 2018
From: report at bugs.python.org (Segev Finer)
Date: Sat, 10 Feb 2018 13:23:01 +0000
Subject: [docs] [issue32815] Document text parameter to subprocess.Popen
Message-ID: <1518268981.78.0.467229070634.issue32815@psf.upfronthosting.co.za>


New submission from Segev Finer <segev208 at gmail.com>:

The new text parameter in subprocess was documented for subprocess.run but not for subprocess.Popen in the Sphinx documentation. It is documented in the docstring for both though.

----------
assignee: docs at python
components: Documentation
messages: 311949
nosy: Segev Finer, docs at python
priority: normal
severity: normal
status: open
title: Document text parameter to subprocess.Popen
type: enhancement
versions: Python 3.7

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

From report at bugs.python.org  Sat Feb 10 09:34:21 2018
From: report at bugs.python.org (sblondon)
Date: Sat, 10 Feb 2018 14:34:21 +0000
Subject: [docs] [issue32800] Replace deprecated link to new page on w3c site
In-Reply-To: <1518103994.08.0.467229070634.issue32800@psf.upfronthosting.co.za>
Message-ID: <1518273261.44.0.714561066657.issue32800@psf.upfronthosting.co.za>


Change by sblondon <stephane.blondon at gmail.com>:


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

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

From report at bugs.python.org  Sat Feb 10 12:50:27 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sat, 10 Feb 2018 17:50:27 +0000
Subject: [docs] [issue11015] Bring test.support docs up to date
In-Reply-To: <1296009969.38.0.282241852849.issue11015@psf.upfronthosting.co.za>
Message-ID: <1518285027.63.0.714561066657.issue11015@psf.upfronthosting.co.za>


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


----------
pull_requests: +5420

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

From report at bugs.python.org  Sat Feb 10 12:53:46 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sat, 10 Feb 2018 17:53:46 +0000
Subject: [docs] [issue11015] Bring test.support docs up to date
In-Reply-To: <1296009969.38.0.282241852849.issue11015@psf.upfronthosting.co.za>
Message-ID: <1518285226.21.0.467229070634.issue11015@psf.upfronthosting.co.za>


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

I have created a pull request adding documentation for all of test.support, including script_helper.py.  I hope this will be helpful.

----------
nosy: +csabella
versions: +Python 3.8

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

From report at bugs.python.org  Sat Feb 10 15:46:30 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 10 Feb 2018 20:46:30 +0000
Subject: [docs] [issue32800] Replace deprecated link to new page on w3c site
In-Reply-To: <1518103994.08.0.467229070634.issue32800@psf.upfronthosting.co.za>
Message-ID: <1518295590.83.0.467229070634.issue32800@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

> If you cannot set the backport labels (I don't know of non-committer author's are allowed to, mention that all 3 are needed in a comment (I checked 2.7 and 3.8)

Only committers (and the bots) can apply labels :) I've applied the necessary labels.

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

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

From report at bugs.python.org  Sat Feb 10 15:50:43 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 10 Feb 2018 20:50:43 +0000
Subject: [docs] [issue32800] Replace deprecated link to new page on w3c site
In-Reply-To: <1518103994.08.0.467229070634.issue32800@psf.upfronthosting.co.za>
Message-ID: <1518295843.64.0.467229070634.issue32800@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

I think the news blurb is not needed though.

----------

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

From report at bugs.python.org  Sat Feb 10 17:19:21 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 10 Feb 2018 22:19:21 +0000
Subject: [docs] [issue32800] Replace deprecated link to new page on w3c site
In-Reply-To: <1518103994.08.0.467229070634.issue32800@psf.upfronthosting.co.za>
Message-ID: <1518301161.61.0.467229070634.issue32800@psf.upfronthosting.co.za>


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

Agreed.  This could have been done without a PR.

----------

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

From report at bugs.python.org  Sat Feb 10 17:39:45 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 10 Feb 2018 22:39:45 +0000
Subject: [docs] [issue32800] Replace deprecated link to new page on w3c site
In-Reply-To: <1518103994.08.0.467229070634.issue32800@psf.upfronthosting.co.za>
Message-ID: <1518302385.39.0.467229070634.issue32800@psf.upfronthosting.co.za>


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


New changeset 8d1f2f40389c476d9240ec87a33da0373597c6af by Terry Jan Reedy (sblondon) in branch 'master':
bpo-32800: Update link to w3c doc for xml default namespaces (GH-5609)
https://github.com/python/cpython/commit/8d1f2f40389c476d9240ec87a33da0373597c6af


----------

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

From report at bugs.python.org  Sat Feb 10 17:39:59 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 10 Feb 2018 22:39:59 +0000
Subject: [docs] [issue32800] Replace deprecated link to new page on w3c site
In-Reply-To: <1518103994.08.0.467229070634.issue32800@psf.upfronthosting.co.za>
Message-ID: <1518302399.75.0.714561066657.issue32800@psf.upfronthosting.co.za>


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


----------
pull_requests: +5421

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

From report at bugs.python.org  Sat Feb 10 17:40:51 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 10 Feb 2018 22:40:51 +0000
Subject: [docs] [issue32800] Replace deprecated link to new page on w3c site
In-Reply-To: <1518103994.08.0.467229070634.issue32800@psf.upfronthosting.co.za>
Message-ID: <1518302451.54.0.714561066657.issue32800@psf.upfronthosting.co.za>


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


----------
pull_requests: +5422

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

From report at bugs.python.org  Sat Feb 10 17:41:51 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 10 Feb 2018 22:41:51 +0000
Subject: [docs] [issue32800] Replace deprecated link to new page on w3c site
In-Reply-To: <1518103994.08.0.467229070634.issue32800@psf.upfronthosting.co.za>
Message-ID: <1518302511.64.0.714561066657.issue32800@psf.upfronthosting.co.za>


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


----------
pull_requests: +5423

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

From report at bugs.python.org  Sat Feb 10 18:08:36 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 10 Feb 2018 23:08:36 +0000
Subject: [docs] [issue32800] Replace deprecated link to new page on w3c site
In-Reply-To: <1518103994.08.0.467229070634.issue32800@psf.upfronthosting.co.za>
Message-ID: <1518304116.39.0.467229070634.issue32800@psf.upfronthosting.co.za>


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


New changeset e6033209754c5b01870791645044a791da1fa73f by Terry Jan Reedy (Miss Islington (bot)) in branch '3.7':
bpo-32800: Update link to w3c doc for xml default namespaces (GH-5609) (GH-5611)
https://github.com/python/cpython/commit/e6033209754c5b01870791645044a791da1fa73f


----------

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

From report at bugs.python.org  Sat Feb 10 19:42:24 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 11 Feb 2018 00:42:24 +0000
Subject: [docs] [issue32800] Replace deprecated link to new page on w3c site
In-Reply-To: <1518103994.08.0.467229070634.issue32800@psf.upfronthosting.co.za>
Message-ID: <1518309744.23.0.467229070634.issue32800@psf.upfronthosting.co.za>


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


New changeset 9d8c24b79162711551394c8f8e6002342554791b by Terry Jan Reedy (Miss Islington (bot)) in branch '3.6':
bpo-32800: Update link to w3c doc for xml default namespaces (GH-5609) GH-5612)
https://github.com/python/cpython/commit/9d8c24b79162711551394c8f8e6002342554791b


----------

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

From report at bugs.python.org  Sat Feb 10 19:42:44 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 11 Feb 2018 00:42:44 +0000
Subject: [docs] [issue32800] Replace deprecated link to new page on w3c site
In-Reply-To: <1518103994.08.0.467229070634.issue32800@psf.upfronthosting.co.za>
Message-ID: <1518309764.41.0.467229070634.issue32800@psf.upfronthosting.co.za>


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


New changeset ea6e6444bdf983c99d9175a22dd054bf02ee22b4 by Terry Jan Reedy (Miss Islington (bot)) in branch '2.7':
bpo-32800: Update link to w3c doc for xml default namespaces (GH-5609) (GH-5613)
https://github.com/python/cpython/commit/ea6e6444bdf983c99d9175a22dd054bf02ee22b4


----------

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

From report at bugs.python.org  Sat Feb 10 19:44:57 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 11 Feb 2018 00:44:57 +0000
Subject: [docs] [issue32800] Replace deprecated link to new page on w3c site
In-Reply-To: <1518103994.08.0.467229070634.issue32800@psf.upfronthosting.co.za>
Message-ID: <1518309897.12.0.467229070634.issue32800@psf.upfronthosting.co.za>


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

I meant, could have been done without a bpo issue.  And since the blurb was added, I kept it.  Thanks 'sbondon'.

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

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

From report at bugs.python.org  Sat Feb 10 21:36:29 2018
From: report at bugs.python.org (Xavier G. Domingo)
Date: Sun, 11 Feb 2018 02:36:29 +0000
Subject: [docs] [issue32767] Mutating a list while iterating: clarify the
 docs
In-Reply-To: <1517772420.88.0.467229070634.issue32767@psf.upfronthosting.co.za>
Message-ID: <1518316589.45.0.714561066657.issue32767@psf.upfronthosting.co.za>


Change by Xavier G. Domingo <xgdomingo at gmail.com>:


----------
nosy: +xgdomingo

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

From report at bugs.python.org  Sat Feb 10 22:02:24 2018
From: report at bugs.python.org (Tim Peters)
Date: Sun, 11 Feb 2018 03:02:24 +0000
Subject: [docs] [issue32767] Mutating a list while iterating: clarify the
 docs
In-Reply-To: <1517772420.88.0.467229070634.issue32767@psf.upfronthosting.co.za>
Message-ID: <1518318144.24.0.467229070634.issue32767@psf.upfronthosting.co.za>


Tim Peters <tim at python.org> added the comment:

Stefan, yup!  Thank you.  `array.array` and `bytearray` iterators appear to work the same way as `list` iterators here.

Terry, the note in the `for` statement docs was written before there _was_ an iterator protocol.  For example, here are the 1.5.1 docs:

https://docs.python.org/release/1.5.1/ref/ref-9.html#HEADING9-27

Back then, the expression_list had to evaluate to a "string, tuple or list".  Or so the docs said - I don't remember the implementation details.

Regardless, I think we all agree the note is at best out of date ;-)

----------

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

From report at bugs.python.org  Sun Feb 11 08:10:48 2018
From: report at bugs.python.org (Nick Coghlan)
Date: Sun, 11 Feb 2018 13:10:48 +0000
Subject: [docs] [issue11015] Bring test.support docs up to date
In-Reply-To: <1296009969.38.0.282241852849.issue11015@psf.upfronthosting.co.za>
Message-ID: <1518354648.35.0.467229070634.issue11015@psf.upfronthosting.co.za>


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


New changeset 988fb28431d3a3fc5dc6eb657c8a4baacc04d9ce by Nick Coghlan (Cheryl Sabella) in branch 'master':
bpo-11015: Update test.support documentation (GH-5610)
https://github.com/python/cpython/commit/988fb28431d3a3fc5dc6eb657c8a4baacc04d9ce


----------

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

From report at bugs.python.org  Sun Feb 11 08:12:00 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 11 Feb 2018 13:12:00 +0000
Subject: [docs] [issue11015] Bring test.support docs up to date
In-Reply-To: <1296009969.38.0.282241852849.issue11015@psf.upfronthosting.co.za>
Message-ID: <1518354719.99.0.714561066657.issue11015@psf.upfronthosting.co.za>


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


----------
pull_requests: +5428

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

From report at bugs.python.org  Sun Feb 11 08:14:15 2018
From: report at bugs.python.org (Nick Coghlan)
Date: Sun, 11 Feb 2018 13:14:15 +0000
Subject: [docs] [issue11015] Bring test.support docs up to date
In-Reply-To: <1296009969.38.0.282241852849.issue11015@psf.upfronthosting.co.za>
Message-ID: <1518354854.96.0.467229070634.issue11015@psf.upfronthosting.co.za>


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

I merged Cheryl's PR to the dev branch, and triggered the backport to 3.7. If nobody beats me to it, I'll merge the latter tomorrow :)

----------
assignee: docs at python -> ncoghlan
resolution:  -> fixed
stage: patch review -> backport needed

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

From report at bugs.python.org  Sun Feb 11 10:21:46 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Sun, 11 Feb 2018 15:21:46 +0000
Subject: [docs] [issue32798] mmap.flush() on Linux does not accept the
 "offset" and "size" args
In-Reply-To: <1518102419.01.0.467229070634.issue32798@psf.upfronthosting.co.za>
Message-ID: <1518362506.94.0.714561066657.issue32798@psf.upfronthosting.co.za>


Change by Pablo Galindo Salgado <pablogsal at gmail.com>:


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

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

From report at bugs.python.org  Sun Feb 11 10:34:59 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Sun, 11 Feb 2018 15:34:59 +0000
Subject: [docs] [issue32815] Document text parameter to subprocess.Popen
In-Reply-To: <1518268981.78.0.467229070634.issue32815@psf.upfronthosting.co.za>
Message-ID: <1518363299.37.0.714561066657.issue32815@psf.upfronthosting.co.za>


Change by Pablo Galindo Salgado <pablogsal at gmail.com>:


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

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

From report at bugs.python.org  Sun Feb 11 11:22:22 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 11 Feb 2018 16:22:22 +0000
Subject: [docs] [issue11015] Bring test.support docs up to date
In-Reply-To: <1296009969.38.0.282241852849.issue11015@psf.upfronthosting.co.za>
Message-ID: <1518366142.32.0.467229070634.issue11015@psf.upfronthosting.co.za>


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

I have left comments to PR.

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

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

From report at bugs.python.org  Sun Feb 11 11:34:30 2018
From: report at bugs.python.org (Nick Coghlan)
Date: Sun, 11 Feb 2018 16:34:30 +0000
Subject: [docs] [issue11015] Bring test.support docs up to date
In-Reply-To: <1296009969.38.0.282241852849.issue11015@psf.upfronthosting.co.za>
Message-ID: <1518366870.18.0.467229070634.issue11015@psf.upfronthosting.co.za>


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


New changeset a0b998df314370f00502efe7ad84206f5bb782ff by Nick Coghlan (Miss Islington (bot)) in branch '3.7':
bpo-11015: Update test.support documentation (GH-5619)
https://github.com/python/cpython/commit/a0b998df314370f00502efe7ad84206f5bb782ff


----------

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

From report at bugs.python.org  Sun Feb 11 12:00:52 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 11 Feb 2018 17:00:52 +0000
Subject: [docs] [issue5978] cProfile and profile don't work with pygtk/pyqt
 and sys.exit(0)
In-Reply-To: <1241895448.39.0.497331485225.issue5978@psf.upfronthosting.co.za>
Message-ID: <1518368451.99.0.714561066657.issue5978@psf.upfronthosting.co.za>


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


----------
keywords: +easy
stage:  -> needs patch
type: behavior -> enhancement
versions: +Python 3.8 -Python 2.7, Python 3.1, Python 3.2

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

From report at bugs.python.org  Sun Feb 11 12:07:03 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 11 Feb 2018 17:07:03 +0000
Subject: [docs] [issue11015] Bring test.support docs up to date
In-Reply-To: <1296009969.38.0.282241852849.issue11015@psf.upfronthosting.co.za>
Message-ID: <1518368823.2.0.467229070634.issue11015@psf.upfronthosting.co.za>


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

Thanks Nick for merging.  Should I open a new PR to address Serhiy's review or fix them on the original PR?

----------

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

From report at bugs.python.org  Sun Feb 11 12:08:39 2018
From: report at bugs.python.org (Mario Corchero)
Date: Sun, 11 Feb 2018 17:08:39 +0000
Subject: [docs] [issue32821] Add snippet on how to configure a "split"
 stream for console
Message-ID: <1518368919.27.0.467229070634.issue32821@psf.upfronthosting.co.za>


New submission from Mario Corchero <mariocj89 at gmail.com>:

As discussed in python-ideas, it would be good to have a recipe on how to configure the logging stack to be able to log ``ERROR`` and above to stderr and ``INFO`` and below to stdout.

It was proposed to add it into the cookbook rather than on the standard library. An alternative proposal was a "ConsoleHandler" that would do this by default. (https://github.com/mariocj89/cpython/commit/501cfcd0f4cad1e04d87b89784988c52a77a80ad)

----------
assignee: docs at python
components: Documentation
messages: 312003
nosy: docs at python, mariocj89
priority: normal
severity: normal
status: open
title: Add snippet on how to configure a "split" stream for console
versions: Python 3.8

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

From report at bugs.python.org  Sun Feb 11 12:11:05 2018
From: report at bugs.python.org (Mario Corchero)
Date: Sun, 11 Feb 2018 17:11:05 +0000
Subject: [docs] [issue32821] Add snippet on how to configure a "split"
 stream for console
In-Reply-To: <1518368919.27.0.467229070634.issue32821@psf.upfronthosting.co.za>
Message-ID: <1518369065.55.0.714561066657.issue32821@psf.upfronthosting.co.za>


Change by Mario Corchero <mariocj89 at gmail.com>:


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

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

From report at bugs.python.org  Sun Feb 11 14:43:25 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 11 Feb 2018 19:43:25 +0000
Subject: [docs] [issue11015] Bring test.support docs up to date
In-Reply-To: <1296009969.38.0.282241852849.issue11015@psf.upfronthosting.co.za>
Message-ID: <1518378205.63.0.467229070634.issue11015@psf.upfronthosting.co.za>


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

Since Nick already merged and backported, at least a new PR is needed.  Since this is an old issue with a long discussion and several inactives on the nosy list, I suggest a new issue starting from the merge result as a base: "More revisions to test.support docs".  Make a list of Serhiy's questions and comments.

TESTFN_NONASCII - How different from TESTFN_UNICODE?
PGO -  value? True/False?
TEST_SUPPORT_DIR - Not used.
...

Add Nick, Serhiy, and me as nosy.  We can discuss there how to handle the additional issues.

----------
components: +Documentation, Tests
stage: backport needed -> resolved
status: open -> closed
versions: +Python 3.7

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

From report at bugs.python.org  Sun Feb 11 15:58:25 2018
From: report at bugs.python.org (Gregory P. Smith)
Date: Sun, 11 Feb 2018 20:58:25 +0000
Subject: [docs] [issue32815] Document text parameter to subprocess.Popen
In-Reply-To: <1518268981.78.0.467229070634.issue32815@psf.upfronthosting.co.za>
Message-ID: <1518382705.24.0.467229070634.issue32815@psf.upfronthosting.co.za>


Gregory P. Smith <greg at krypto.org> added the comment:


New changeset e14c01037877768a3fe766e50d14993bd5d8a67e by Gregory P. Smith (Pablo Galindo) in branch 'master':
bpo-32815: Improve docs on the subprocess API *text* parameter (GH-5622)
https://github.com/python/cpython/commit/e14c01037877768a3fe766e50d14993bd5d8a67e


----------
nosy: +gregory.p.smith

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

From report at bugs.python.org  Sun Feb 11 15:58:33 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 11 Feb 2018 20:58:33 +0000
Subject: [docs] [issue32815] Document text parameter to subprocess.Popen
In-Reply-To: <1518268981.78.0.467229070634.issue32815@psf.upfronthosting.co.za>
Message-ID: <1518382713.89.0.714561066657.issue32815@psf.upfronthosting.co.za>


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


----------
pull_requests: +5435

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

From report at bugs.python.org  Sun Feb 11 18:21:04 2018
From: report at bugs.python.org (Gregory P. Smith)
Date: Sun, 11 Feb 2018 23:21:04 +0000
Subject: [docs] [issue32815] Document text parameter to subprocess.Popen
In-Reply-To: <1518268981.78.0.467229070634.issue32815@psf.upfronthosting.co.za>
Message-ID: <1518391264.23.0.467229070634.issue32815@psf.upfronthosting.co.za>


Gregory P. Smith <greg at krypto.org> added the comment:


New changeset ba4f218657efcba856d00eb320418355cce8309a by Gregory P. Smith (Miss Islington (bot)) in branch '3.7':
bpo-32815: Improve docs on the subprocess API *text* parameter (GH-5622) (GH-5631)
https://github.com/python/cpython/commit/ba4f218657efcba856d00eb320418355cce8309a


----------

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

From report at bugs.python.org  Sun Feb 11 18:21:39 2018
From: report at bugs.python.org (Gregory P. Smith)
Date: Sun, 11 Feb 2018 23:21:39 +0000
Subject: [docs] [issue32815] Document text parameter to subprocess.Popen
In-Reply-To: <1518268981.78.0.467229070634.issue32815@psf.upfronthosting.co.za>
Message-ID: <1518391299.79.0.714561066657.issue32815@psf.upfronthosting.co.za>


Change by Gregory P. Smith <greg at krypto.org>:


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

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

From report at bugs.python.org  Sun Feb 11 18:42:34 2018
From: report at bugs.python.org (Frank Griswold)
Date: Sun, 11 Feb 2018 23:42:34 +0000
Subject: [docs] [issue32824] Docs: Using Python on a Macintosh has bad info
 per Apple site
Message-ID: <1518392554.24.0.467229070634.issue32824@psf.upfronthosting.co.za>


New submission from Frank Griswold <py.griswolf at spamgourmet.com>:

This chunk of docs has bad info in both Python2 and Python3 docs:

4.1.3. Configuration

Python on OS X honors all standard Unix environment variables such as PYTHONPATH, but setting these variables for programs started from the Finder is non-standard as the Finder does not read your .profile or .cshrc at startup. You need to create a file ~/.MacOSX/environment.plist. See Apple?s Technical Document QA1067 for details.

If you search for QA1067, you are informed that the document is legacy and unsupported, with a suggestion for where to look now. That suggested link leads to a 404.

Searching the apple site, I find that at least some thoughtful developers think that configuring the environment isn't even possible, generally; and isn't considered good form even if so. Here:
https://forums.developer.apple.com/message/217422

I have no problem setting things for my terminal, as a longtime (unix) user, but for others, this section probably needs a complete examination with an eye toward making it current. quite possibly by reorganizing it.

----------
assignee: docs at python
components: Documentation
messages: 312023
nosy: docs at python, griswolf
priority: normal
severity: normal
status: open
title: Docs: Using Python on a Macintosh has bad info per Apple site
type: enhancement

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

From report at bugs.python.org  Sun Feb 11 19:22:31 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Mon, 12 Feb 2018 00:22:31 +0000
Subject: [docs] [issue20285] Improve object.__doc__ and help(object) output
In-Reply-To: <1389920351.63.0.12805701843.issue20285@psf.upfronthosting.co.za>
Message-ID: <1518394951.68.0.467229070634.issue20285@psf.upfronthosting.co.za>


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

Reponses on the pydev thread, which include 3 other coredevs:

"a base for all classes." object entry in lib ref, function
"the ultimate base class of all other classes."  Martin Panter

object is neither a base or superclass of itself, so the first of each pair above is not quite right.

"the base class of the class heirarchy ['hierarchy']"  Steven D'Aprano
"the root of the class heirarchy"  ditto
+ quotes from Java and Ruby

Jeff Allen and Barry Warsaw like either, with BW slightly referring the first.

I was thinking about 'tree' instead of 'hierachy', but 'class tree' is wrong and 'directed acyclic graph of classes' a bit wordy.  While hierarchies are often thought of as trees, it is possible for someone to report to more than one person.

No one supported the status quo.

Martin also suggested a continuation:  "When called, it accepts no
arguments and returns a new unique and featureless object."

Even though object, unlike any other class, is primarily used as a base class rather than instance source, the latter should be included.  For other built-in classes, the summary line describes instances. I would leave out 'unique' as that could be confused with 'singleton'.


I propose the following, which follows general docstring format, but describes the class instead of instances in the summary line.

"The base class of the class hierarchy.

When called, it accepts no arguments and returns a new featureless instance that has no instance attributes and cannot be given any."

Passing arguments to object and trying to add attributes to object instances are two common beginner mistakes.

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

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

From report at bugs.python.org  Sun Feb 11 23:41:29 2018
From: report at bugs.python.org (Ned Deily)
Date: Mon, 12 Feb 2018 04:41:29 +0000
Subject: [docs] [issue32824] Docs: Using Python on a Macintosh has bad info
 per Apple site
In-Reply-To: <1518392554.24.0.467229070634.issue32824@psf.upfronthosting.co.za>
Message-ID: <1518410489.22.0.467229070634.issue32824@psf.upfronthosting.co.za>


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

Thanks for the reminder.  Yes, the whole "Using Python on a Macintosh" section is very much out-of-date and needs a complete rewrite.  It has been on my To Do list for a long time; I'll see what I can do to expedite it.

----------
assignee: docs at python -> ned.deily
nosy: +ned.deily
priority: normal -> high
stage:  -> needs patch
versions: +Python 2.7, Python 3.6, Python 3.7, Python 3.8

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

From report at bugs.python.org  Mon Feb 12 03:02:43 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 12 Feb 2018 08:02:43 +0000
Subject: [docs] [issue32758] Stack overflow when parse long expression to AST
In-Reply-To: <1517682171.17.0.467229070634.issue32758@psf.upfronthosting.co.za>
Message-ID: <1518422563.8.0.714561066657.issue32758@psf.upfronthosting.co.za>


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


----------
assignee:  -> docs at python
components: +Documentation -Interpreter Core
nosy: +docs at python
stage:  -> needs patch

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

From report at bugs.python.org  Mon Feb 12 03:07:57 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 12 Feb 2018 08:07:57 +0000
Subject: [docs] [issue32720] Format mini-language integer definition is
 incorrect
In-Reply-To: <1517287529.39.0.467229070634.issue32720@psf.upfronthosting.co.za>
Message-ID: <1518422877.75.0.467229070634.issue32720@psf.upfronthosting.co.za>


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


New changeset 6708be744d032aeffab3e2cf0b064a41a719d8a1 by Miss Islington (bot) in branch '3.6':
bpo-32720: Fixed the replacement field grammar documentation. (GH-5544) (GH-5547)
https://github.com/python/cpython/commit/6708be744d032aeffab3e2cf0b064a41a719d8a1


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

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

From report at bugs.python.org  Mon Feb 12 03:09:29 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Mon, 12 Feb 2018 08:09:29 +0000
Subject: [docs] [issue32720] Format mini-language integer definition is
 incorrect
In-Reply-To: <1517287529.39.0.467229070634.issue32720@psf.upfronthosting.co.za>
Message-ID: <1518422969.46.0.467229070634.issue32720@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

Thanks!

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

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

From report at bugs.python.org  Mon Feb 12 07:51:45 2018
From: report at bugs.python.org (ChrisRands)
Date: Mon, 12 Feb 2018 12:51:45 +0000
Subject: [docs] [issue32830] tkinter documentation suggests "from tkinter
 import *", contradicting PEP8
Message-ID: <1518439905.14.0.467229070634.issue32830@psf.upfronthosting.co.za>


New submission from ChrisRands <chrisrands0 at gmail.com>:

Issue arose from this SO post: https://stackoverflow.com/questions/48746351/documentation-is-contradicting-pep8

The tkinter documentation suggests:

from tkinter import *

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

But this obviously contradicts PEP8:
"Wildcard imports (from <module> import *) should be avoided"

https://www.python.org/dev/peps/pep-0008/#imports

Is tkinter a valid exception or is this a documentation bug?

The commit of this line to the documentation is >10 years old (at least Python 2.4 I think): https://github.com/python/cpython/commit/116aa62bf54a39697e25f21d6cf6799f7faa1349#diff-05a258c160de90c51c1948689f788ef7R53

----------
assignee: docs at python
components: Documentation
messages: 312045
nosy: ChrisRands, docs at python
priority: normal
severity: normal
status: open
title: tkinter documentation suggests "from tkinter import *", contradicting PEP8

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

From report at bugs.python.org  Mon Feb 12 08:09:32 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 12 Feb 2018 13:09:32 +0000
Subject: [docs] [issue32830] tkinter documentation suggests "from tkinter
 import *", contradicting PEP8
In-Reply-To: <1518439905.14.0.467229070634.issue32830@psf.upfronthosting.co.za>
Message-ID: <1518440972.24.0.467229070634.issue32830@psf.upfronthosting.co.za>


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

I think tkinter is a valid exception. It provides the enormous number of names (mostly constants like RIGHT or VERTICAL) which are convenient to use without prefix.

PEP 8 is a style guide for the code of the stdlib. Its suggestions are not mandatory for a user code.

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

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

From report at bugs.python.org  Mon Feb 12 08:22:58 2018
From: report at bugs.python.org (ChrisRands)
Date: Mon, 12 Feb 2018 13:22:58 +0000
Subject: [docs] [issue32830] tkinter documentation suggests "from tkinter
 import *", contradicting PEP8
In-Reply-To: <1518439905.14.0.467229070634.issue32830@psf.upfronthosting.co.za>
Message-ID: <1518441778.41.0.467229070634.issue32830@psf.upfronthosting.co.za>


ChrisRands <chrisrands0 at gmail.com> added the comment:

Thanks Serhiy, you might be right (I am not a tkinter user myself).

I also forgot to say that in PEP 328 tkinter is mentioned in this context:
https://www.python.org/dev/peps/pep-0328/#rationale-for-parentheses

----------

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

From report at bugs.python.org  Mon Feb 12 08:31:39 2018
From: report at bugs.python.org (Ned Deily)
Date: Mon, 12 Feb 2018 13:31:39 +0000
Subject: [docs] [issue32830] tkinter documentation suggests "from tkinter
 import *", contradicting PEP8
In-Reply-To: <1518439905.14.0.467229070634.issue32830@psf.upfronthosting.co.za>
Message-ID: <1518442299.88.0.467229070634.issue32830@psf.upfronthosting.co.za>


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

PEP 8 also says: "In particular: do not break backwards compatibility just to comply with this PEP!"  This is one of those cases.  There is a ton of code out there that depends on importing tkinter this way for the reasons Serhiy cited.  Thanks for the suggestion but this usage is not going to change.

----------
nosy: +ned.deily
resolution:  -> not a bug
stage:  -> resolved
status: open -> closed

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

From report at bugs.python.org  Mon Feb 12 08:39:55 2018
From: report at bugs.python.org (ChrisRands)
Date: Mon, 12 Feb 2018 13:39:55 +0000
Subject: [docs] [issue32830] tkinter documentation suggests "from tkinter
 import *", contradicting PEP8
In-Reply-To: <1518439905.14.0.467229070634.issue32830@psf.upfronthosting.co.za>
Message-ID: <1518442795.72.0.467229070634.issue32830@psf.upfronthosting.co.za>


ChrisRands <chrisrands0 at gmail.com> added the comment:

Ok thanks both for the clarification!

----------

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

From report at bugs.python.org  Mon Feb 12 08:52:55 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 12 Feb 2018 13:52:55 +0000
Subject: [docs] [issue32830] tkinter documentation suggests "from tkinter
 import *", contradicting PEP8
In-Reply-To: <1518439905.14.0.467229070634.issue32830@psf.upfronthosting.co.za>
Message-ID: <1518443575.76.0.467229070634.issue32830@psf.upfronthosting.co.za>


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

I want to add that the star import is more convenient when you experiment with Tkinter in REPL. You don't know what names will be needed when import Tkinter.

The interpreter core has a special support of Tkinter. You don't need to run mainloop() for updating GUI in REPL. So this is a supported case.

----------

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

From report at bugs.python.org  Mon Feb 12 16:12:23 2018
From: report at bugs.python.org (Jay Yin)
Date: Mon, 12 Feb 2018 21:12:23 +0000
Subject: [docs] [issue32835] Add documention mentioning that Cygwin isn't
 fully compatible
Message-ID: <1518469943.71.0.467229070634.issue32835@psf.upfronthosting.co.za>


New submission from Jay Yin <jayyin11043 at gmail.com>:

I didn't find any documentation stating that Cygwin isn't currently compatible with building, I was wondering if it would be good to add documentation stating this and that it would be an area requiring help.

----------
assignee: docs at python
components: Documentation
messages: 312080
nosy: docs at python, jayyin11043
priority: normal
severity: normal
status: open
title: Add documention mentioning that Cygwin isn't fully compatible
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/issue32835>
_______________________________________

From report at bugs.python.org  Mon Feb 12 16:16:18 2018
From: report at bugs.python.org (Christian Heimes)
Date: Mon, 12 Feb 2018 21:16:18 +0000
Subject: [docs] [issue32835] Add documention mentioning that Cygwin isn't
 fully compatible
In-Reply-To: <1518469943.71.0.467229070634.issue32835@psf.upfronthosting.co.za>
Message-ID: <1518470178.98.0.714561066657.issue32835@psf.upfronthosting.co.za>


Change by Christian Heimes <lists at cheimes.de>:


----------
keywords: +easy
stage:  -> needs patch
type:  -> enhancement
versions:  -Python 3.4, Python 3.5

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

From report at bugs.python.org  Mon Feb 12 16:56:46 2018
From: report at bugs.python.org (R. David Murray)
Date: Mon, 12 Feb 2018 21:56:46 +0000
Subject: [docs] [issue32835] Add documention mentioning that Cygwin isn't
 fully compatible
In-Reply-To: <1518469943.71.0.467229070634.issue32835@psf.upfronthosting.co.za>
Message-ID: <1518472606.53.0.467229070634.issue32835@psf.upfronthosting.co.za>


R. David Murray <rdmurray at bitdance.com> added the comment:

We don't (can't) document everything we're *not* compatible with, we can only realisticly document what we support.  I thought we did that, but all I can find at the moment is PEP 11, which you are correct, does not list cygwin as a no-longer-supported platform (although we'd like to support it, see the many issues in this tracker about it).

----------
nosy: +r.david.murray

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

From report at bugs.python.org  Mon Feb 12 17:00:10 2018
From: report at bugs.python.org (Jay Yin)
Date: Mon, 12 Feb 2018 22:00:10 +0000
Subject: [docs] [issue32835] Add documention mentioning that Cygwin isn't
 fully compatible
In-Reply-To: <1518469943.71.0.467229070634.issue32835@psf.upfronthosting.co.za>
Message-ID: <1518472810.31.0.467229070634.issue32835@psf.upfronthosting.co.za>


Jay Yin <jayyin11043 at gmail.com> added the comment:

ah I see, hence the *currently* incompatible, there must be some way of tracking areas in need of help without having to use the search, kind of like the way Github uses labels.

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

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

From report at bugs.python.org  Mon Feb 12 22:32:56 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Tue, 13 Feb 2018 03:32:56 +0000
Subject: [docs] [issue32798] mmap.flush() on Linux does not accept the
 "offset" and "size" args
In-Reply-To: <1518102419.01.0.467229070634.issue32798@psf.upfronthosting.co.za>
Message-ID: <1518492776.21.0.467229070634.issue32798@psf.upfronthosting.co.za>


Xiang Zhang <angwerzx at 126.com> added the comment:

One thing to note is the behaviour seems fit implementation detail. POSIX doesn't requires this for both mmap and msync, it's optional:

The mmap( ) function may fail if:
[EINVAL] The addr argument (if MAP_FIXED was specified) or off is not a multiple of the page size as returned

The msync( ) function may fail if:
[EINVAL] The value of addr is not a multiple of the page size as returned by sysconf( ).

----------
nosy: +berker.peksag, pablogsal, xiang.zhang

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

From report at bugs.python.org  Tue Feb 13 14:06:09 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Tue, 13 Feb 2018 19:06:09 +0000
Subject: [docs] [issue21196] Name mangling example in Python tutorial
In-Reply-To: <1397133080.37.0.870141660622.issue21196@psf.upfronthosting.co.za>
Message-ID: <1518548769.83.0.467229070634.issue21196@psf.upfronthosting.co.za>


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

Chandan or Berker,

Any interest in making a Github pull request for this patch?

----------
nosy: +csabella
versions: +Python 3.7, Python 3.8 -Python 3.5, Python 3.6

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

From report at bugs.python.org  Tue Feb 13 18:44:19 2018
From: report at bugs.python.org (Zackery Spytz)
Date: Tue, 13 Feb 2018 23:44:19 +0000
Subject: [docs] [issue27846] Base64 expansion factor is 4 to 3, not 6 to 4
In-Reply-To: <1472030737.8.0.133776759316.issue27846@psf.upfronthosting.co.za>
Message-ID: <1518565459.01.0.714561066657.issue27846@psf.upfronthosting.co.za>


Change by Zackery Spytz <Osmunda46 at gmail.com>:


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

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

From report at bugs.python.org  Tue Feb 13 18:48:19 2018
From: report at bugs.python.org (Zackery Spytz)
Date: Tue, 13 Feb 2018 23:48:19 +0000
Subject: [docs] [issue27846] Base64 expansion factor is 4 to 3, not 6 to 4
In-Reply-To: <1472030737.8.0.133776759316.issue27846@psf.upfronthosting.co.za>
Message-ID: <1518565699.18.0.714561066657.issue27846@psf.upfronthosting.co.za>


Change by Zackery Spytz <Osmunda46 at gmail.com>:


----------
nosy: +ZackerySpytz
versions: +Python 3.7, Python 3.8 -Python 3.5

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

From report at bugs.python.org  Tue Feb 13 19:03:22 2018
From: report at bugs.python.org (Berker Peksag)
Date: Wed, 14 Feb 2018 00:03:22 +0000
Subject: [docs] [issue21196] Name mangling example in Python tutorial
In-Reply-To: <1397133080.37.0.870141660622.issue21196@psf.upfronthosting.co.za>
Message-ID: <1518566602.49.0.714561066657.issue21196@psf.upfronthosting.co.za>


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


----------
pull_requests: +5469

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

From report at bugs.python.org  Tue Feb 13 19:08:57 2018
From: report at bugs.python.org (Berker Peksag)
Date: Wed, 14 Feb 2018 00:08:57 +0000
Subject: [docs] [issue27846] Base64 expansion factor is 4 to 3, not 6 to 4
In-Reply-To: <1472030737.8.0.133776759316.issue27846@psf.upfronthosting.co.za>
Message-ID: <1518566937.02.0.467229070634.issue27846@psf.upfronthosting.co.za>


Berker Peksag <berker.peksag at gmail.com> added the comment:


New changeset 88c38a4049ded0e1f197fec3e76be7c0c0e83d7a by Berker Peksag (Zackery Spytz) in branch 'master':
bpo-27846: Delete incorrect note in base64 docs (GH-5666)
https://github.com/python/cpython/commit/88c38a4049ded0e1f197fec3e76be7c0c0e83d7a


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

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

From report at bugs.python.org  Tue Feb 13 19:09:16 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 14 Feb 2018 00:09:16 +0000
Subject: [docs] [issue27846] Base64 expansion factor is 4 to 3, not 6 to 4
In-Reply-To: <1472030737.8.0.133776759316.issue27846@psf.upfronthosting.co.za>
Message-ID: <1518566956.37.0.714561066657.issue27846@psf.upfronthosting.co.za>


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


----------
pull_requests: +5470

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

From report at bugs.python.org  Tue Feb 13 19:10:04 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 14 Feb 2018 00:10:04 +0000
Subject: [docs] [issue27846] Base64 expansion factor is 4 to 3, not 6 to 4
In-Reply-To: <1472030737.8.0.133776759316.issue27846@psf.upfronthosting.co.za>
Message-ID: <1518567004.78.0.714561066657.issue27846@psf.upfronthosting.co.za>


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


----------
pull_requests: +5471

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

From report at bugs.python.org  Tue Feb 13 19:48:03 2018
From: report at bugs.python.org (Berker Peksag)
Date: Wed, 14 Feb 2018 00:48:03 +0000
Subject: [docs] [issue27846] Base64 expansion factor is 4 to 3, not 6 to 4
In-Reply-To: <1472030737.8.0.133776759316.issue27846@psf.upfronthosting.co.za>
Message-ID: <1518569283.02.0.467229070634.issue27846@psf.upfronthosting.co.za>


Berker Peksag <berker.peksag at gmail.com> added the comment:


New changeset 2e8d9003ed7a97955c36fa19a9ce7c43d9ec83e1 by Berker Peksag (Miss Islington (bot)) in branch '3.7':
bpo-27846: Delete incorrect note in base64 docs (GH-5666)
https://github.com/python/cpython/commit/2e8d9003ed7a97955c36fa19a9ce7c43d9ec83e1


----------

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

From report at bugs.python.org  Tue Feb 13 19:48:30 2018
From: report at bugs.python.org (Berker Peksag)
Date: Wed, 14 Feb 2018 00:48:30 +0000
Subject: [docs] [issue27846] Base64 expansion factor is 4 to 3, not 6 to 4
In-Reply-To: <1472030737.8.0.133776759316.issue27846@psf.upfronthosting.co.za>
Message-ID: <1518569310.94.0.467229070634.issue27846@psf.upfronthosting.co.za>


Berker Peksag <berker.peksag at gmail.com> added the comment:


New changeset b93a52b136fd2285f2891eef91c50e3d36ea6f36 by Berker Peksag (Miss Islington (bot)) in branch '3.6':
bpo-27846: Delete incorrect note in base64 docs (GH-5666)
https://github.com/python/cpython/commit/b93a52b136fd2285f2891eef91c50e3d36ea6f36


----------

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

From report at bugs.python.org  Tue Feb 13 19:50:03 2018
From: report at bugs.python.org (Berker Peksag)
Date: Wed, 14 Feb 2018 00:50:03 +0000
Subject: [docs] [issue27846] Base64 expansion factor is 4 to 3, not 6 to 4
In-Reply-To: <1472030737.8.0.133776759316.issue27846@psf.upfronthosting.co.za>
Message-ID: <1518569403.23.0.467229070634.issue27846@psf.upfronthosting.co.za>


Berker Peksag <berker.peksag at gmail.com> added the comment:

Thanks!

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

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

From report at bugs.python.org  Wed Feb 14 00:40:26 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Wed, 14 Feb 2018 05:40:26 +0000
Subject: [docs] [issue21196] Name mangling example in Python tutorial
In-Reply-To: <1397133080.37.0.870141660622.issue21196@psf.upfronthosting.co.za>
Message-ID: <1518586826.17.0.467229070634.issue21196@psf.upfronthosting.co.za>


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

I don't think we should advertise how to manually mangle the names.  That isn't a best practice.  The feature is automatic for a reason.

----------

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

From report at bugs.python.org  Wed Feb 14 06:18:06 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Wed, 14 Feb 2018 11:18:06 +0000
Subject: [docs] [issue32843] More revisions to test.support docs
Message-ID: <1518607086.66.0.467229070634.issue32843@psf.upfronthosting.co.za>


New submission from Cheryl Sabella <chekat2 at gmail.com>:

Serhiy had made the following comments on the pull request for issue11015, but that PR was merged before applying his requested changes.  This issue is to address his concerns.


TESTFN_NONASCII - How different from TESTFN_UNICODE?
PGO -  value? True/False?
TEST_SUPPORT_DIR - Not used.
max_memuse - Not used.
MISSING_C_DOCSTRINGS - Remove `Return` since it's a constant.
HAVE_DOCSTRINGS - Remove `Check` since it's a constant.

Possibly group the next 3 to avoid repetition:
unlink(filename) - Add an explanation why this is needed (due to antiviruses that can hold files open and prevent thy deletion).
rmdir(filename) - Add an explanation why this is needed (due to antiviruses that can hold files open and prevent thy deletion).
rmtree(path) - Add an explanation why this is needed (due to antiviruses that can hold files open and prevent thy deletion).

make_legacy_pyc(source) - Add markup references to PEPs.
system_must_validate_cert(f) - This is a decorator and change text to "Skip the test on TLS certificate validation failures.".

match_test(test) and set_match_tests(patterns) - Used internally to regrtest.  Remove or ask Victor to document as the current documentation is useless.

check_impl_detail(**guards) - Document that a boolean is returned and check the docstring to include more information.

get_original_stdout - Add ().

strip_python_strerr(stderr) - Typo `strip_python_stderr` and make it clear that *stderr* is a byte string.

disable_faulthandler() - Wrong description.

disable_gc() - Add that it works only if it was enabled.

start_threads(threads, unlock=None) - Document that *threads* is a sequence of threads and document what unlock is.

calcobjsize(fmt) - Add the purpose of this - calcobjsize() returns the size of Python object (PyObject) whose structure is defined by fmt with account of Python object header.
calcvobjsize(fmt) - Same as above for PyVarObject.

requires_freebsd_version(*min_version) - Change to skip the test instead of Raise.

cpython_only(test) - Remove argument.
no_tracing(func) - Remove argument.
refcount_test(test) - Remove argument.
reap_threads(func) - Remove argument.
bigaddrspacetest(f) - Remove argument.

import_module(name, deprecated=False, *, required_on()) - Missed =

check_free_after_iterating(test, iter, cls, args=()) - This description is misleading. This function doesn't test iter. iter is either iter or reversed, cls is a base iterable class, args are arguments for its constructor. The true description is too complex, I suggest to remove this function from the documentation.

missing_compiler_executable(cmd_names=[]) - It is used only in distutils tests and should be in distutils.tests.support.

CleanImport(*module_names) - Format DeprecationWarning as a link.

DirsOnSysPath(*paths) - Format first sys.path as a link, Keeps the first one (in the above sentence) and format other mentions as ``sys.path`` or :data:`!sys.path`.

SaveSignals() - How to use it?

Matcher() - This class is used only in test_logging, and only with TestHandler. These classes should be documented together and with references to logging. I'm not sure they should be in test.support.

BasicTestRunner() - This is an internal class used for implementing run_unittest(). No need to expose it.

TestHandler(logging.handlers.BufferingHandler) - I'm not sure it should be in test.support rather of test_logging.

assert_python_ok(*args, **env_vars) - Since this is a keyword argument name, it should be formatter as *__cleanenv*.

----------
assignee: docs at python
components: Documentation
messages: 312170
nosy: csabella, docs at python, ncoghlan, serhiy.storchaka, terry.reedy
priority: normal
severity: normal
status: open
title: More revisions to test.support docs
type: enhancement
versions: Python 3.8

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

From cppljevans at suddenlink.net  Sun Feb 11 17:28:08 2018
From: cppljevans at suddenlink.net (Larry Evans)
Date: Sun, 11 Feb 2018 16:28:08 -0600
Subject: [docs] https://docs.python.org/3/library/html.entities.html
 give not hint about how to access the module
In-Reply-To: <4b1b519a-a591-569e-31b0-73d902d241c4@suddenlink.net>
References: <4b1b519a-a591-569e-31b0-73d902d241c4@suddenlink.net>
Message-ID: <82105f40-7509-103f-728f-a6b8b74c5e5a@suddenlink.net>

On 02/11/2018 04:21 PM, Larry Evans wrote:
> The obvious 1st guess is:
> 
>  ? import html
> 
> but that results in:
> 
> make
> python entities.py
> Traceback (most recent call last):
>  ? File "entities.py", line 1, in <module>
>  ??? import html
> ImportError: No module named html
> 
> I'm on linux and obviouly have python installed; so, why can't python 
> find the *standard* library?
> 
> I've been trying for hours to get this to work.
> It shouldn't be this hard.
> 
> -regards,
> Larry
> 
Never mind.  I just had to use python3 instead of python2 :(


From cppljevans at suddenlink.net  Sun Feb 11 17:21:07 2018
From: cppljevans at suddenlink.net (Larry Evans)
Date: Sun, 11 Feb 2018 16:21:07 -0600
Subject: [docs] https://docs.python.org/3/library/html.entities.html give
 not hint about how to access the module
Message-ID: <4b1b519a-a591-569e-31b0-73d902d241c4@suddenlink.net>

The obvious 1st guess is:

   import html

but that results in:

make
python entities.py
Traceback (most recent call last):
   File "entities.py", line 1, in <module>
     import html
ImportError: No module named html

I'm on linux and obviouly have python installed; so, why can't python 
find the *standard* library?

I've been trying for hours to get this to work.
It shouldn't be this hard.

-regards,
Larry


From john.halbert at gmail.com  Sun Feb 11 23:03:26 2018
From: john.halbert at gmail.com (John Halbert)
Date: Sun, 11 Feb 2018 20:03:26 -0800
Subject: [docs] Epub Broken
In-Reply-To: <CADMvoFuJBzwtSohbu9W28XVwhBAaVdagsWnGwF9VVBgdTLgBZQ@mail.gmail.com>
References: <CADMvoFs0+M5Jxaa0jgUtDyhcV+F-CXMf_eTkgnvkdP5Rq8d1_g@mail.gmail.com>
 <CADMvoFvnxghc36eBmzQD37p7xAgKrQ+5_1vPNLzTpHWsTjdMAQ@mail.gmail.com>
 <CADMvoFst_wbu_oD-qj37z307=zZd6kjBDA4AcSuwZo4rFmnvLw@mail.gmail.com>
 <CADMvoFuJBzwtSohbu9W28XVwhBAaVdagsWnGwF9VVBgdTLgBZQ@mail.gmail.com>
Message-ID: <CADMvoFvws6tJDXyTBo_bqAoXr8wg3iDyFTX8z0mbp3gK1Dnnew@mail.gmail.com>

I downloaded your latest docs in epub format and received an error when
being processed by my Google books app.  I checked http://validator.idpf.org
and received several validation errors regarding missing references.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180211/fda2f986/attachment-0001.html>

From lutinfou at free.fr  Fri Feb  9 07:03:18 2018
From: lutinfou at free.fr (lutinfou)
Date: Fri, 9 Feb 2018 13:03:18 +0100 (CET)
Subject: [docs] Download French documentation
Message-ID: <955606232.98993680.1518177798600.JavaMail.root@zimbra33-e6>

Hello Mr. Python :)

All the download links about french documentation seems to be dead.
For example :
https://docs.python.org/fr/3.5/download.html

Is there any french downloable documentation ?

Regards

From messiguoj at outlook.com  Tue Feb 13 07:32:05 2018
From: messiguoj at outlook.com (Graham Adolph)
Date: Tue, 13 Feb 2018 12:32:05 +0000
Subject: [docs] The installation of Python failed.
Message-ID: <CY4PR16MB1592C3F03B2B2BB9BDE505E5AAF60@CY4PR16MB1592.namprd16.prod.outlook.com>

I can't install python .I am depressed[cid:image001.png at 01D3A4C7.A2E32A40][cid:image002.png at 01D3A4C7.A2E32A40]
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180213/b9b91d06/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image001.png
Type: image/png
Size: 1513158 bytes
Desc: image001.png
URL: <http://mail.python.org/pipermail/docs/attachments/20180213/b9b91d06/attachment-0002.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image002.png
Type: image/png
Size: 1514795 bytes
Desc: image002.png
URL: <http://mail.python.org/pipermail/docs/attachments/20180213/b9b91d06/attachment-0003.png>

From report at bugs.python.org  Thu Feb 15 11:52:04 2018
From: report at bugs.python.org (Eli_B)
Date: Thu, 15 Feb 2018 16:52:04 +0000
Subject: [docs] [issue32853] struct's docstring implies alignment is always
 performed
Message-ID: <1518713524.32.0.467229070634.issue32853@psf.upfronthosting.co.za>


New submission from Eli_B <eli.boyarski at gmail.com>:

In module struct's docstring, it says:
"...
The optional first format char indicates byte order, size and alignment:\n
  @: native order, size & alignment (default)\n
  =: native order, std. size & alignment\n
  <: little-endian, std. size & alignment\n
  >: big-endian, std. size & alignment\n
  !: same as >\n
..."
The wording sounds like either native or standard alignment is performed, regardless of the optional first format char.

In comparison, the table in https://docs.python.org/3.8/library/struct.html#byte-order-size-and-alignment states that in all modes other than the default, no alignment is performed. This is the actual behavior of the module.

----------
assignee: docs at python
components: Documentation
messages: 312214
nosy: Eli_B, docs at python
priority: normal
severity: normal
status: open
title: struct's docstring implies alignment is always performed
type: behavior
versions: Python 3.8

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

From report at bugs.python.org  Thu Feb 15 21:33:36 2018
From: report at bugs.python.org (Jay Yin)
Date: Fri, 16 Feb 2018 02:33:36 +0000
Subject: [docs] [issue32855] Add documention stating supported Platforms
Message-ID: <1518748416.8.0.467229070634.issue32855@psf.upfronthosting.co.za>


New submission from Jay Yin <jayyin11043 at gmail.com>:

we can probably add a section that includes all supported platforms and possibly "partially" supported platforms, and maybe include platforms that currently aren't supported but want/plan to be supported.

----------
assignee: docs at python
components: Documentation
messages: 312225
nosy: docs at python, jayyin11043
priority: normal
severity: normal
status: open
title: Add documention stating supported Platforms

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

From report at bugs.python.org  Thu Feb 15 22:02:08 2018
From: report at bugs.python.org (Ned Deily)
Date: Fri, 16 Feb 2018 03:02:08 +0000
Subject: [docs] [issue32855] Add documention stating supported Platforms
In-Reply-To: <1518748416.8.0.467229070634.issue32855@psf.upfronthosting.co.za>
Message-ID: <1518750128.12.0.714561066657.issue32855@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Feb 16 18:57:38 2018
From: report at bugs.python.org (Roger Erens)
Date: Fri, 16 Feb 2018 23:57:38 +0000
Subject: [docs] [issue22167] iglob() has misleading documentation (does
 indeed store names internally)
In-Reply-To: <1407460141.27.0.298063472331.issue22167@psf.upfronthosting.co.za>
Message-ID: <1518825458.01.0.467229070634.issue22167@psf.upfronthosting.co.za>


Roger Erens <snereregor at gmail.com> added the comment:

http://bugs.python.org/issue25596 has been closed...

----------
nosy: +Roger Erens

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

From report at bugs.python.org  Fri Feb 16 19:06:49 2018
From: report at bugs.python.org (Roger Erens)
Date: Sat, 17 Feb 2018 00:06:49 +0000
Subject: [docs] [issue32860] Definition of iglob does not mention single
 star (unlike glob)
Message-ID: <1518826009.15.0.467229070634.issue32860@psf.upfronthosting.co.za>


New submission from Roger Erens <snereregor at gmail.com>:

Although both glob and iglob have the same arity in Lib/glob.py:

def glob(pathname, *, recursive=False)

def iglob(pathname, *, recursive=False):

the documentation only mentions for glob the single star
https://docs.python.org/3/library/glob.html#glob.iglob:

glob.glob(pathname, *, recursive=False)

glob.iglob(pathname, recursive=False)

----------
assignee: docs at python
components: Documentation
messages: 312258
nosy: Roger Erens, docs at python
priority: normal
severity: normal
status: open
title: Definition of iglob does not mention single star (unlike glob)

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

From report at bugs.python.org  Fri Feb 16 21:31:10 2018
From: report at bugs.python.org (Zackery Spytz)
Date: Sat, 17 Feb 2018 02:31:10 +0000
Subject: [docs] [issue32860] Definition of iglob does not mention single
 star (unlike glob)
In-Reply-To: <1518826009.15.0.467229070634.issue32860@psf.upfronthosting.co.za>
Message-ID: <1518834670.99.0.714561066657.issue32860@psf.upfronthosting.co.za>


Change by Zackery Spytz <zspytz at gmail.com>:


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

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

From report at bugs.python.org  Fri Feb 16 22:39:54 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 17 Feb 2018 03:39:54 +0000
Subject: [docs] [issue32860] Definition of iglob does not mention single
 star (unlike glob)
In-Reply-To: <1518826009.15.0.467229070634.issue32860@psf.upfronthosting.co.za>
Message-ID: <1518838794.02.0.467229070634.issue32860@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:


New changeset 6887d86e9a04b9c5718b08e5d9e1ca3cc1f53721 by Mariatta (Zackery Spytz) in branch 'master':
bpo-32860: Fix a missing asterisk in the documentation for glob.iglob() (GH-5712)
https://github.com/python/cpython/commit/6887d86e9a04b9c5718b08e5d9e1ca3cc1f53721


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

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

From report at bugs.python.org  Fri Feb 16 22:40:07 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 17 Feb 2018 03:40:07 +0000
Subject: [docs] [issue32860] Definition of iglob does not mention single
 star (unlike glob)
In-Reply-To: <1518826009.15.0.467229070634.issue32860@psf.upfronthosting.co.za>
Message-ID: <1518838807.87.0.714561066657.issue32860@psf.upfronthosting.co.za>


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


----------
pull_requests: +5504

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

From report at bugs.python.org  Fri Feb 16 22:40:59 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 17 Feb 2018 03:40:59 +0000
Subject: [docs] [issue32860] Definition of iglob does not mention single
 star (unlike glob)
In-Reply-To: <1518826009.15.0.467229070634.issue32860@psf.upfronthosting.co.za>
Message-ID: <1518838859.59.0.714561066657.issue32860@psf.upfronthosting.co.za>


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


----------
pull_requests: +5505

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

From report at bugs.python.org  Fri Feb 16 22:42:42 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 17 Feb 2018 03:42:42 +0000
Subject: [docs] [issue32860] Definition of iglob does not mention single
 star (unlike glob)
In-Reply-To: <1518826009.15.0.467229070634.issue32860@psf.upfronthosting.co.za>
Message-ID: <1518838962.64.0.467229070634.issue32860@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

Thanks!

----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed
versions: +Python 3.6, Python 3.7, Python 3.8

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

From report at bugs.python.org  Fri Feb 16 22:51:12 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 17 Feb 2018 03:51:12 +0000
Subject: [docs] [issue32860] Definition of iglob does not mention single
 star (unlike glob)
In-Reply-To: <1518826009.15.0.467229070634.issue32860@psf.upfronthosting.co.za>
Message-ID: <1518839471.97.0.467229070634.issue32860@psf.upfronthosting.co.za>


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


New changeset 0f764110593b337161e9321671dc13b54ca0cf95 by Miss Islington (bot) in branch '3.7':
bpo-32860: Fix a missing asterisk in the documentation for glob.iglob() (GH-5712)
https://github.com/python/cpython/commit/0f764110593b337161e9321671dc13b54ca0cf95


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

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

From report at bugs.python.org  Fri Feb 16 22:58:13 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 17 Feb 2018 03:58:13 +0000
Subject: [docs] [issue32860] Definition of iglob does not mention single
 star (unlike glob)
In-Reply-To: <1518826009.15.0.467229070634.issue32860@psf.upfronthosting.co.za>
Message-ID: <1518839893.58.0.467229070634.issue32860@psf.upfronthosting.co.za>


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


New changeset 76591bc03a26e8fde143c25cb88a98f1c96f8bc2 by Miss Islington (bot) in branch '3.6':
bpo-32860: Fix a missing asterisk in the documentation for glob.iglob() (GH-5712)
https://github.com/python/cpython/commit/76591bc03a26e8fde143c25cb88a98f1c96f8bc2


----------

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

From report at bugs.python.org  Sat Feb 17 03:09:23 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 17 Feb 2018 08:09:23 +0000
Subject: [docs] [issue22167] iglob() has misleading documentation (does
 indeed store names internally)
In-Reply-To: <1407460141.27.0.298063472331.issue22167@psf.upfronthosting.co.za>
Message-ID: <1518854962.94.0.467229070634.issue22167@psf.upfronthosting.co.za>


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

Unfortunately issue25596 didn't change anything about this issue. iglob() still stores names (actually DirEntry objects) of all files in a directory before starting yielding the first of them. Otherwise we cold exceed the limit of open file descriptors.

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

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

From report at bugs.python.org  Sun Feb 18 10:32:51 2018
From: report at bugs.python.org (Joachim Trouverie)
Date: Sun, 18 Feb 2018 15:32:51 +0000
Subject: [docs] [issue32540] venv docs - doesn't match behavior
In-Reply-To: <1515780433.02.0.467229070634.issue32540@psf.upfronthosting.co.za>
Message-ID: <1518967971.37.0.467229070634.issue32540@psf.upfronthosting.co.za>


Joachim Trouverie <joachim.trouverie at linoame.fr> added the comment:

Is there anybody working on this issue or can I make a PR ?

----------
nosy: +jtrouverie

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

From report at bugs.python.org  Sun Feb 18 10:38:37 2018
From: report at bugs.python.org (Jason R. Coombs)
Date: Sun, 18 Feb 2018 15:38:37 +0000
Subject: [docs] [issue32540] venv docs - doesn't match behavior
In-Reply-To: <1515780433.02.0.467229070634.issue32540@psf.upfronthosting.co.za>
Message-ID: <1518968317.48.0.467229070634.issue32540@psf.upfronthosting.co.za>


Jason R. Coombs <jaraco at jaraco.com> added the comment:

@jtrouverie: Yes, please do. Thanks!

----------

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

From report at bugs.python.org  Sun Feb 18 11:27:43 2018
From: report at bugs.python.org (robotwizard)
Date: Sun, 18 Feb 2018 16:27:43 +0000
Subject: [docs] [issue32868] python 3 docs' iterator example has python 2
 code
Message-ID: <1518971263.84.0.467229070634.issue32868@psf.upfronthosting.co.za>


New submission from robotwizard <harikrishnan527 at gmail.com>:

Please note this is my first issue.

The documentation at https://docs.python.org/3/tutorial/classes.html#iterators on the second code block gives the example of iterating a string by creating an iterator out of it. However I tried it with python 3.5 and 3.6 and both give me a "str_iterator" which has no "next()" method. When I tried the code with python 2.7, it works.

----------
assignee: docs at python
components: Documentation
messages: 312312
nosy: docs at python, robotwizard, willingc
priority: normal
severity: normal
status: open
title: python 3 docs' iterator example has python 2 code
versions: Python 3.6

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

From report at bugs.python.org  Sun Feb 18 11:31:40 2018
From: report at bugs.python.org (robotwizard)
Date: Sun, 18 Feb 2018 16:31:40 +0000
Subject: [docs] [issue32868] python 3 docs' iterator example has python 2
 code
In-Reply-To: <1518971263.84.0.467229070634.issue32868@psf.upfronthosting.co.za>
Message-ID: <1518971500.67.0.467229070634.issue32868@psf.upfronthosting.co.za>


robotwizard <harikrishnan527 at gmail.com> added the comment:

I'm so sorry... I tried doing it.next() instead of next(it). I'm sincerely sorry. I promise not to be so frivolous about opening an issue on the bug tracker next time.

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

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

From report at bugs.python.org  Sun Feb 18 11:35:34 2018
From: report at bugs.python.org (TROUVERIE Joachim)
Date: Sun, 18 Feb 2018 16:35:34 +0000
Subject: [docs] [issue32540] venv docs - doesn't match behavior
In-Reply-To: <1515780433.02.0.467229070634.issue32540@psf.upfronthosting.co.za>
Message-ID: <1518971734.91.0.714561066657.issue32540@psf.upfronthosting.co.za>


Change by TROUVERIE Joachim <joachim.trouverie at linoame.fr>:


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

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

From report at bugs.python.org  Sun Feb 18 12:59:37 2018
From: report at bugs.python.org (Andrew Scheller)
Date: Sun, 18 Feb 2018 17:59:37 +0000
Subject: [docs] [issue32870] Documentation typo (2.x only) for deque.remove
Message-ID: <1518976776.93.0.467229070634.issue32870@psf.upfronthosting.co.za>


New submission from Andrew Scheller <launchpad at loowis.durge.org>:

https://docs.python.org/2/library/collections.html#collections.deque.remove says "Removed the first occurrence of value."
I believe the "Removed" should be changed to just "Remove" ?

(this has already been fixed in the 3.x documentation https://docs.python.org/3/library/collections.html#collections.deque.remove )

----------
assignee: docs at python
components: Documentation
messages: 312319
nosy: docs at python, lurchman
priority: normal
severity: normal
status: open
title: Documentation typo (2.x only) for deque.remove
versions: Python 2.7

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

From report at bugs.python.org  Sun Feb 18 13:13:46 2018
From: report at bugs.python.org (Andrew Scheller)
Date: Sun, 18 Feb 2018 18:13:46 +0000
Subject: [docs] [issue32870] Documentation typo (2.x only) for deque.remove
In-Reply-To: <1518976776.93.0.467229070634.issue32870@psf.upfronthosting.co.za>
Message-ID: <1518977626.84.0.467229070634.issue32870@psf.upfronthosting.co.za>


Andrew Scheller <launchpad at loowis.durge.org> added the comment:

Looks like https://bugs.python.org/issue24269 is where this got fixed for the 3.x documentation ;-)

----------

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

From report at bugs.python.org  Sun Feb 18 13:15:32 2018
From: report at bugs.python.org (Andrew Scheller)
Date: Sun, 18 Feb 2018 18:15:32 +0000
Subject: [docs] [issue32870] Documentation typo (2.x only) for deque.remove
In-Reply-To: <1518976776.93.0.467229070634.issue32870@psf.upfronthosting.co.za>
Message-ID: <1518977732.57.0.714561066657.issue32870@psf.upfronthosting.co.za>


Change by Andrew Scheller <launchpad at loowis.durge.org>:


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

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

From report at bugs.python.org  Sun Feb 18 18:36:34 2018
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Sun, 18 Feb 2018 23:36:34 +0000
Subject: [docs] [issue31972] Inherited docstrings for pathlib classes are
 confusing
In-Reply-To: <1510081543.19.0.213398074469.issue31972@psf.upfronthosting.co.za>
Message-ID: <1518996994.16.0.467229070634.issue31972@psf.upfronthosting.co.za>


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


New changeset dfa015cf77a148d229ddc0a5b063562c9f9664f2 by ?ric Araujo (chason) in branch 'master':
bpo-31972: Improve docstrings for pathlib classes (#5310)
https://github.com/python/cpython/commit/dfa015cf77a148d229ddc0a5b063562c9f9664f2


----------

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

From report at bugs.python.org  Sun Feb 18 18:37:39 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 18 Feb 2018 23:37:39 +0000
Subject: [docs] [issue31972] Inherited docstrings for pathlib classes are
 confusing
In-Reply-To: <1510081543.19.0.213398074469.issue31972@psf.upfronthosting.co.za>
Message-ID: <1518997059.76.0.714561066657.issue31972@psf.upfronthosting.co.za>


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


----------
pull_requests: +5523

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

From report at bugs.python.org  Sun Feb 18 18:40:26 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 18 Feb 2018 23:40:26 +0000
Subject: [docs] [issue31972] Inherited docstrings for pathlib classes are
 confusing
In-Reply-To: <1510081543.19.0.213398074469.issue31972@psf.upfronthosting.co.za>
Message-ID: <1518997226.09.0.714561066657.issue31972@psf.upfronthosting.co.za>


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


----------
pull_requests: +5524

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

From report at bugs.python.org  Sun Feb 18 19:37:03 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 19 Feb 2018 00:37:03 +0000
Subject: [docs] [issue31972] Inherited docstrings for pathlib classes are
 confusing
In-Reply-To: <1510081543.19.0.213398074469.issue31972@psf.upfronthosting.co.za>
Message-ID: <1519000622.95.0.467229070634.issue31972@psf.upfronthosting.co.za>


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


New changeset 5c81ed49412e41a671283cdb4c297dab52f5b7c5 by Miss Islington (bot) in branch '3.6':
bpo-31972: Improve docstrings for pathlib classes (GH-5310)
https://github.com/python/cpython/commit/5c81ed49412e41a671283cdb4c297dab52f5b7c5


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

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

From report at bugs.python.org  Sun Feb 18 19:48:09 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 19 Feb 2018 00:48:09 +0000
Subject: [docs] [issue31972] Inherited docstrings for pathlib classes are
 confusing
In-Reply-To: <1510081543.19.0.213398074469.issue31972@psf.upfronthosting.co.za>
Message-ID: <1519001289.87.0.467229070634.issue31972@psf.upfronthosting.co.za>


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


New changeset 19b7f6694af56a1c9fdc0f1f9fc09ae48439ab4c by Miss Islington (bot) in branch '3.7':
bpo-31972: Improve docstrings for pathlib classes (GH-5310)
https://github.com/python/cpython/commit/19b7f6694af56a1c9fdc0f1f9fc09ae48439ab4c


----------

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

From report at bugs.python.org  Sun Feb 18 20:00:42 2018
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 19 Feb 2018 01:00:42 +0000
Subject: [docs] [issue31972] Inherited docstrings for pathlib classes are
 confusing
In-Reply-To: <1510081543.19.0.213398074469.issue31972@psf.upfronthosting.co.za>
Message-ID: <1519002042.73.0.714561066657.issue31972@psf.upfronthosting.co.za>


Change by ?ric Araujo <merwok at netwok.org>:


----------
assignee: docs at python -> eric.araujo
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed
versions: +Python 3.8

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

From report at bugs.python.org  Sun Feb 18 20:01:17 2018
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 19 Feb 2018 01:01:17 +0000
Subject: [docs] [issue31972] Inherited docstrings for pathlib classes are
 confusing
In-Reply-To: <1510081543.19.0.213398074469.issue31972@psf.upfronthosting.co.za>
Message-ID: <1519002076.89.0.467229070634.issue31972@psf.upfronthosting.co.za>


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

Thanks for the patch!

----------

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

From jerettfranklin at gmail.com  Sun Feb 18 12:08:52 2018
From: jerettfranklin at gmail.com (Jerett Franklin)
Date: Sun, 18 Feb 2018 11:08:52 -0600
Subject: [docs] Python 3.5.5 documents unavailable for download
Message-ID: <CAL-W_X_FCsxBh6YfSAmWLddnsA8ChFekC9EOwFoX6PYt8GrigQ@mail.gmail.com>

I cannot seem to download the documentation from my Motorola x4. Instead
I'm just going download each page offline.  I just wanted to let you busy
guys know.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180218/9e452f72/attachment.html>

From jerettfranklin at gmail.com  Sun Feb 18 12:08:52 2018
From: jerettfranklin at gmail.com (Jerett Franklin)
Date: Sun, 18 Feb 2018 11:08:52 -0600
Subject: [docs] Python 3.5.5 documents unavailable for download
In-Reply-To: <CAL-W_X_ojhM+JBLq6-6TNBDZ+a5HCVRaHLuvj8cojOhW9BdSbg@mail.gmail.com>
References: <CAL-W_X_ojhM+JBLq6-6TNBDZ+a5HCVRaHLuvj8cojOhW9BdSbg@mail.gmail.com>
Message-ID: <CAL-W_X9WRtk=FQiabR3vKfkbs6LPrGkLbugnYUUoetCan1+0Qw@mail.gmail.com>

I cannot seem to download the documentation from my Motorola x4. Instead
I'm just going download each page offline.  I just wanted to let you busy
guys know.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180218/a74bae9a/attachment.html>

From report at bugs.python.org  Mon Feb 19 13:47:12 2018
From: report at bugs.python.org (Brett Cannon)
Date: Mon, 19 Feb 2018 18:47:12 +0000
Subject: [docs] [issue31937] Add the term "dunder" to the glossary
In-Reply-To: <1509742669.66.0.213398074469.issue31937@psf.upfronthosting.co.za>
Message-ID: <1519066032.57.0.714561066657.issue31937@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Mon Feb 19 18:31:29 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 19 Feb 2018 23:31:29 +0000
Subject: [docs] [issue32870] Documentation typo (2.x only) for deque.remove
In-Reply-To: <1518976776.93.0.467229070634.issue32870@psf.upfronthosting.co.za>
Message-ID: <1519083089.98.0.714561066657.issue32870@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Mon Feb 19 18:42:59 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 19 Feb 2018 23:42:59 +0000
Subject: [docs] [issue32870] Documentation typo (2.x only) for deque.remove
In-Reply-To: <1518976776.93.0.467229070634.issue32870@psf.upfronthosting.co.za>
Message-ID: <1519083779.25.0.714561066657.issue32870@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Mon Feb 19 21:50:52 2018
From: report at bugs.python.org (Zackery Spytz)
Date: Tue, 20 Feb 2018 02:50:52 +0000
Subject: [docs] [issue32500] PySequence_Length() raises TypeError on dict
 type
In-Reply-To: <1515199107.36.0.467229070634.issue32500@psf.upfronthosting.co.za>
Message-ID: <1519095052.6.0.714561066657.issue32500@psf.upfronthosting.co.za>


Change by Zackery Spytz <zspytz at gmail.com>:


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

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

From report at bugs.python.org  Mon Feb 19 21:54:21 2018
From: report at bugs.python.org (Zackery Spytz)
Date: Tue, 20 Feb 2018 02:54:21 +0000
Subject: [docs] [issue32500] PySequence_Length() raises TypeError on dict
 type
In-Reply-To: <1515199107.36.0.467229070634.issue32500@psf.upfronthosting.co.za>
Message-ID: <1519095261.1.0.714561066657.issue32500@psf.upfronthosting.co.za>


Change by Zackery Spytz <zspytz at gmail.com>:


----------
nosy: +ZackerySpytz
versions: +Python 3.8

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

From report at bugs.python.org  Tue Feb 20 11:19:30 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Tue, 20 Feb 2018 16:19:30 +0000
Subject: [docs] [issue32843] More revisions to test.support docs
In-Reply-To: <1518607086.66.0.467229070634.issue32843@psf.upfronthosting.co.za>
Message-ID: <1519143570.42.0.714561066657.issue32843@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Tue Feb 20 11:22:12 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Tue, 20 Feb 2018 16:22:12 +0000
Subject: [docs] [issue32843] More revisions to test.support docs
In-Reply-To: <1518607086.66.0.467229070634.issue32843@psf.upfronthosting.co.za>
Message-ID: <1519143732.41.0.467229070634.issue32843@psf.upfronthosting.co.za>


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

I've made the changes requested.  I wasn't sure about:

TESTFN_NONASCII - How different from TESTFN_UNICODE?


Should I move these out of test.support?:
missing_compiler_executable(cmd_names=[]) - It is used only in distutils tests and should be in distutils.tests.support.
Matcher() - This class is used only in test_logging, and only with TestHandler. These classes should be documented together and with references to logging. I'm not sure they should be in test.support.
TestHandler(logging.handlers.BufferingHandler) - I'm not sure it should be in test.support rather of test_logging.

Thanks!

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

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

From report at bugs.python.org  Tue Feb 20 11:22:30 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Tue, 20 Feb 2018 16:22:30 +0000
Subject: [docs] [issue32843] More revisions to test.support docs
In-Reply-To: <1518607086.66.0.467229070634.issue32843@psf.upfronthosting.co.za>
Message-ID: <1519143750.41.0.714561066657.issue32843@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Tue Feb 20 12:24:32 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 20 Feb 2018 17:24:32 +0000
Subject: [docs] [issue32500] PySequence_Length() raises TypeError on dict
 type
In-Reply-To: <1515199107.36.0.467229070634.issue32500@psf.upfronthosting.co.za>
Message-ID: <1519147472.82.0.467229070634.issue32500@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:


New changeset 7a1e1786f98ad49caa157dcdf14ada9d0b07d0fd by Mariatta (Zackery Spytz) in branch 'master':
bpo-32500: Correct the documentation for PySequence_Size() and PySequence_Length() (GH-5767)
https://github.com/python/cpython/commit/7a1e1786f98ad49caa157dcdf14ada9d0b07d0fd


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

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

From report at bugs.python.org  Tue Feb 20 12:25:47 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 20 Feb 2018 17:25:47 +0000
Subject: [docs] [issue32500] PySequence_Length() raises TypeError on dict
 type
In-Reply-To: <1515199107.36.0.467229070634.issue32500@psf.upfronthosting.co.za>
Message-ID: <1519147547.46.0.714561066657.issue32500@psf.upfronthosting.co.za>


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


----------
pull_requests: +5554

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

From report at bugs.python.org  Tue Feb 20 12:26:40 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 20 Feb 2018 17:26:40 +0000
Subject: [docs] [issue32500] PySequence_Length() raises TypeError on dict
 type
In-Reply-To: <1515199107.36.0.467229070634.issue32500@psf.upfronthosting.co.za>
Message-ID: <1519147600.28.0.714561066657.issue32500@psf.upfronthosting.co.za>


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


----------
pull_requests: +5556

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

From report at bugs.python.org  Tue Feb 20 12:27:38 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 20 Feb 2018 17:27:38 +0000
Subject: [docs] [issue32500] PySequence_Length() raises TypeError on dict
 type
In-Reply-To: <1515199107.36.0.467229070634.issue32500@psf.upfronthosting.co.za>
Message-ID: <1519147658.66.0.714561066657.issue32500@psf.upfronthosting.co.za>


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


----------
pull_requests: +5557

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

From report at bugs.python.org  Tue Feb 20 14:46:17 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 20 Feb 2018 19:46:17 +0000
Subject: [docs] [issue32500] PySequence_Length() raises TypeError on dict
 type
In-Reply-To: <1515199107.36.0.467229070634.issue32500@psf.upfronthosting.co.za>
Message-ID: <1519155977.34.0.467229070634.issue32500@psf.upfronthosting.co.za>


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


New changeset 6ae87cae091f4835090c10c1e65eb057a13fca2c by Miss Islington (bot) in branch '3.6':
bpo-32500: Correct the documentation for PySequence_Size() and PySequence_Length() (GH-5767)
https://github.com/python/cpython/commit/6ae87cae091f4835090c10c1e65eb057a13fca2c


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

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

From report at bugs.python.org  Tue Feb 20 18:35:43 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Tue, 20 Feb 2018 23:35:43 +0000
Subject: [docs] [issue32540] venv docs - doesn't match behavior
In-Reply-To: <1515780433.02.0.467229070634.issue32540@psf.upfronthosting.co.za>
Message-ID: <1519169743.1.0.467229070634.issue32540@psf.upfronthosting.co.za>


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

Does this need to be backported to 3.7 and 3.6?  Or can it be closed as resolved?

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

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

From report at bugs.python.org  Tue Feb 20 19:46:27 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Wed, 21 Feb 2018 00:46:27 +0000
Subject: [docs] [issue32017] profile.Profile() has no method enable()
In-Reply-To: <1510607839.08.0.213398074469.issue32017@psf.upfronthosting.co.za>
Message-ID: <1519173987.04.0.467229070634.issue32017@psf.upfronthosting.co.za>


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

I started taking a look at this and discovered a few things.  There are four methods in the C module `_lsprof` that are within the Profiler class - `enable`, `disable`, `getstats`, and `clear` and which are all available through cProfile.Profile.  These aren't available in profile.py.  Also, `getstats` and `clear` aren't in the documentation and `enable` takes two optional parameters that aren't mentioned in the documentation.  There are also many methods in profile.py that aren't documented.

What would be the preferred approach to fixing the documentation?  It seems that the documentation currently focuses on trying to make profile and cProfile as similar as possible.  Should they have separate sections that define the differences?  Or should `enable` and `disable` be removed since they aren't in profile?  The example under https://docs.python.org/3.8/library/profile.html#profile.Profile  uses `enable` and `disable` and seems to be a helpful example.

----------
nosy: +csabella
stage:  -> needs patch
versions: +Python 3.8

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

From report at bugs.python.org  Tue Feb 20 19:49:07 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Wed, 21 Feb 2018 00:49:07 +0000
Subject: [docs] [issue32008] Example suggest to use a TLSv1 socket
In-Reply-To: <1510428965.62.0.213398074469.issue32008@psf.upfronthosting.co.za>
Message-ID: <1519174147.91.0.467229070634.issue32008@psf.upfronthosting.co.za>


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

Christian,

Would you have any feedback on this?  Thanks!

----------
nosy: +christian.heimes, csabella

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

From report at bugs.python.org  Tue Feb 20 20:22:35 2018
From: report at bugs.python.org (Nick Coghlan)
Date: Wed, 21 Feb 2018 01:22:35 +0000
Subject: [docs] [issue32843] More revisions to test.support docs
In-Reply-To: <1518607086.66.0.467229070634.issue32843@psf.upfronthosting.co.za>
Message-ID: <1519176154.7.0.467229070634.issue32843@psf.upfronthosting.co.za>


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

For TESTFN_NONASCII vs TESTFN_UNICODE (inferred from reading the current code & https://github.com/python/cpython/commit/8b219b2936d767bf6c6c17618db3a7b22fc2e865):

* TESTFN_NONASCII guarantees that it can be encoded and decoded with the default filesystem encoding, but may be None if it can't find a suitable non-ASCII character that meets that constraint. This allows affected tests to be easily skipped on platforms where they can't work.
* TESTFN_UNICODE is always set, but may *not* be encodable with os.fsencode()

(The two could potentially be consolidated by converting the tests that use TESTFN_UNICODE over to TESTFN_NONASCII, but for now it makes sense to just document the above differences)

For the logging helpers, I'd check how they're used in test_logging: if they're used in logging configuration tests, they may be in test.support to avoid reimporting the module that defines the logging tests. If so, then they can be filed away in their own subsection at the end of the test.support documentation. If not, then yeah, moving them into test_logging would make sense.

Similarly, moving the distutils helper makes sense to me, *unless* there's a specific reason that importing it from "distutils.tests.support" instead would be problematic.

----------

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

From report at bugs.python.org  Tue Feb 20 20:46:46 2018
From: report at bugs.python.org (Jason R. Coombs)
Date: Wed, 21 Feb 2018 01:46:46 +0000
Subject: [docs] [issue32540] venv docs - doesn't match behavior
In-Reply-To: <1515780433.02.0.467229070634.issue32540@psf.upfronthosting.co.za>
Message-ID: <1519177606.74.0.467229070634.issue32540@psf.upfronthosting.co.za>


Jason R. Coombs <jaraco at jaraco.com> added the comment:

I thought I saw the PR to the 3.6 branch. If that's not the case - a backport to 3.7 would be much appreciated.

----------

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

From report at bugs.python.org  Tue Feb 20 22:15:40 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 21 Feb 2018 03:15:40 +0000
Subject: [docs] [issue32540] venv docs - doesn't match behavior
In-Reply-To: <1515780433.02.0.467229070634.issue32540@psf.upfronthosting.co.za>
Message-ID: <1519182940.47.0.467229070634.issue32540@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

The PR was against master branch. So if backports are needed, you can add "needs backport to" labels on GH-5736 and the bot will take care of it.

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

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

From report at bugs.python.org  Tue Feb 20 22:53:03 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 21 Feb 2018 03:53:03 +0000
Subject: [docs] [issue32540] venv docs - doesn't match behavior
In-Reply-To: <1515780433.02.0.467229070634.issue32540@psf.upfronthosting.co.za>
Message-ID: <1519185183.2.0.467229070634.issue32540@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

I've went ahead to initiate the backports.

----------
stage: patch review -> backport needed
versions: +Python 3.6, Python 3.7

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

From report at bugs.python.org  Tue Feb 20 23:21:10 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 21 Feb 2018 04:21:10 +0000
Subject: [docs] [issue32540] venv docs - doesn't match behavior
In-Reply-To: <1515780433.02.0.467229070634.issue32540@psf.upfronthosting.co.za>
Message-ID: <1519186870.69.0.714561066657.issue32540@psf.upfronthosting.co.za>


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


----------
pull_requests: +5566
stage: backport needed -> patch review

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

From report at bugs.python.org  Tue Feb 20 23:21:56 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 21 Feb 2018 04:21:56 +0000
Subject: [docs] [issue32540] venv docs - doesn't match behavior
In-Reply-To: <1515780433.02.0.467229070634.issue32540@psf.upfronthosting.co.za>
Message-ID: <1519186916.89.0.714561066657.issue32540@psf.upfronthosting.co.za>


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


----------
pull_requests: +5567

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

From report at bugs.python.org  Tue Feb 20 23:25:39 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 21 Feb 2018 04:25:39 +0000
Subject: [docs] [issue32540] venv docs - doesn't match behavior
In-Reply-To: <1515780433.02.0.467229070634.issue32540@psf.upfronthosting.co.za>
Message-ID: <1519187139.31.0.467229070634.issue32540@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:


New changeset 98a86cbb9bed94a232263698041acd2775da3dad by Mariatta (Miss Islington (bot)) in branch '3.7':
bpo-32540: Update venv documentation (GH-5736)
https://github.com/python/cpython/commit/98a86cbb9bed94a232263698041acd2775da3dad


----------

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

From report at bugs.python.org  Tue Feb 20 23:26:23 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 21 Feb 2018 04:26:23 +0000
Subject: [docs] [issue32540] venv docs - doesn't match behavior
In-Reply-To: <1515780433.02.0.467229070634.issue32540@psf.upfronthosting.co.za>
Message-ID: <1519187183.79.0.467229070634.issue32540@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:


New changeset 76c3f5eeb07aeb037da1ed6761dd9bd95e2c1d8d by Mariatta (Miss Islington (bot)) in branch '3.6':
bpo-32540: Update venv documentation (GH-5736)
https://github.com/python/cpython/commit/76c3f5eeb07aeb037da1ed6761dd9bd95e2c1d8d


----------

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

From report at bugs.python.org  Tue Feb 20 23:27:50 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Wed, 21 Feb 2018 04:27:50 +0000
Subject: [docs] [issue32540] venv docs - doesn't match behavior
In-Reply-To: <1515780433.02.0.467229070634.issue32540@psf.upfronthosting.co.za>
Message-ID: <1519187270.54.0.467229070634.issue32540@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

This should be good now.
Thanks!

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

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

From report at bugs.python.org  Tue Feb 20 23:30:04 2018
From: report at bugs.python.org (INADA Naoki)
Date: Wed, 21 Feb 2018 04:30:04 +0000
Subject: [docs] [issue28886] Move deprecated abc module decorators to
 separate section in docs
In-Reply-To: <1481031817.69.0.735601842725.issue28886@psf.upfronthosting.co.za>
Message-ID: <1519187404.01.0.467229070634.issue28886@psf.upfronthosting.co.za>


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


New changeset 52c6b89796a7ec391db20281e05b256f57e97b35 by INADA Naoki (Harshul jain) in branch 'master':
bpo-28886: doc: Move deprecated abc decorators to separate section (GH-176)
https://github.com/python/cpython/commit/52c6b89796a7ec391db20281e05b256f57e97b35


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

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

From report at bugs.python.org  Tue Feb 20 23:31:10 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 21 Feb 2018 04:31:10 +0000
Subject: [docs] [issue28886] Move deprecated abc module decorators to
 separate section in docs
In-Reply-To: <1481031817.69.0.735601842725.issue28886@psf.upfronthosting.co.za>
Message-ID: <1519187470.35.0.714561066657.issue28886@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Tue Feb 20 23:32:09 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 21 Feb 2018 04:32:09 +0000
Subject: [docs] [issue28886] Move deprecated abc module decorators to
 separate section in docs
In-Reply-To: <1481031817.69.0.735601842725.issue28886@psf.upfronthosting.co.za>
Message-ID: <1519187529.87.0.714561066657.issue28886@psf.upfronthosting.co.za>


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


----------
pull_requests: +5569

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

From report at bugs.python.org  Wed Feb 21 00:24:24 2018
From: report at bugs.python.org (INADA Naoki)
Date: Wed, 21 Feb 2018 05:24:24 +0000
Subject: [docs] [issue28886] Move deprecated abc module decorators to
 separate section in docs
In-Reply-To: <1481031817.69.0.735601842725.issue28886@psf.upfronthosting.co.za>
Message-ID: <1519190664.85.0.467229070634.issue28886@psf.upfronthosting.co.za>


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


New changeset 7452f6d8fa3ffe5dab20f7e4244851a6eca397be by INADA Naoki (Miss Islington (bot)) in branch '3.7':
bpo-28886: doc: Move deprecated abc decorators to separate section (GH-176)
https://github.com/python/cpython/commit/7452f6d8fa3ffe5dab20f7e4244851a6eca397be


----------

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

From report at bugs.python.org  Wed Feb 21 00:24:39 2018
From: report at bugs.python.org (INADA Naoki)
Date: Wed, 21 Feb 2018 05:24:39 +0000
Subject: [docs] [issue28886] Move deprecated abc module decorators to
 separate section in docs
In-Reply-To: <1481031817.69.0.735601842725.issue28886@psf.upfronthosting.co.za>
Message-ID: <1519190679.47.0.467229070634.issue28886@psf.upfronthosting.co.za>


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


New changeset 0150dc589439a9a78c80c2aa8d7d6c5d3bba1d6d by INADA Naoki (Miss Islington (bot)) in branch '3.6':
bpo-28886: doc: Move deprecated abc decorators to separate section (GH-176)
https://github.com/python/cpython/commit/0150dc589439a9a78c80c2aa8d7d6c5d3bba1d6d


----------

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

From report at bugs.python.org  Wed Feb 21 00:42:18 2018
From: report at bugs.python.org (Benjamin Peterson)
Date: Wed, 21 Feb 2018 05:42:18 +0000
Subject: [docs] [issue32008] Example suggest to use a TLSv1 socket
In-Reply-To: <1510428965.62.0.213398074469.issue32008@psf.upfronthosting.co.za>
Message-ID: <1519191738.82.0.714561066657.issue32008@psf.upfronthosting.co.za>


Change by Benjamin Peterson <benjamin at python.org>:


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

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

From report at bugs.python.org  Wed Feb 21 00:55:03 2018
From: report at bugs.python.org (Benjamin Peterson)
Date: Wed, 21 Feb 2018 05:55:03 +0000
Subject: [docs] [issue32008] Example suggest to use a TLSv1 socket
In-Reply-To: <1510428965.62.0.213398074469.issue32008@psf.upfronthosting.co.za>
Message-ID: <1519192503.87.0.467229070634.issue32008@psf.upfronthosting.co.za>


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


New changeset e9edee0b65650c4f9db90cefc2e9a8125bad762c by Benjamin Peterson in branch 'master':
bpo-32008: don't use PROTOCOL_TLSv1 in example (GH-5789)
https://github.com/python/cpython/commit/e9edee0b65650c4f9db90cefc2e9a8125bad762c


----------
nosy: +benjamin.peterson

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

From report at bugs.python.org  Wed Feb 21 00:55:13 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 21 Feb 2018 05:55:13 +0000
Subject: [docs] [issue32008] Example suggest to use a TLSv1 socket
In-Reply-To: <1510428965.62.0.213398074469.issue32008@psf.upfronthosting.co.za>
Message-ID: <1519192513.04.0.714561066657.issue32008@psf.upfronthosting.co.za>


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


----------
pull_requests: +5571

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

From report at bugs.python.org  Wed Feb 21 00:56:11 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 21 Feb 2018 05:56:11 +0000
Subject: [docs] [issue32008] Example suggest to use a TLSv1 socket
In-Reply-To: <1510428965.62.0.213398074469.issue32008@psf.upfronthosting.co.za>
Message-ID: <1519192571.56.0.714561066657.issue32008@psf.upfronthosting.co.za>


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


----------
pull_requests: +5572

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

From report at bugs.python.org  Wed Feb 21 00:59:28 2018
From: report at bugs.python.org (Benjamin Peterson)
Date: Wed, 21 Feb 2018 05:59:28 +0000
Subject: [docs] [issue32008] Example suggest to use a TLSv1 socket
In-Reply-To: <1510428965.62.0.213398074469.issue32008@psf.upfronthosting.co.za>
Message-ID: <1519192768.8.0.714561066657.issue32008@psf.upfronthosting.co.za>


Change by Benjamin Peterson <benjamin at python.org>:


----------
pull_requests: +5573

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

From report at bugs.python.org  Wed Feb 21 01:02:21 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 21 Feb 2018 06:02:21 +0000
Subject: [docs] [issue32008] Example suggest to use a TLSv1 socket
In-Reply-To: <1510428965.62.0.213398074469.issue32008@psf.upfronthosting.co.za>
Message-ID: <1519192941.11.0.467229070634.issue32008@psf.upfronthosting.co.za>


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


New changeset e5d38deb045d0907e6fcf82af8d2d8f0556a8591 by Miss Islington (bot) in branch '3.7':
bpo-32008: don't use PROTOCOL_TLSv1 in example (GH-5789)
https://github.com/python/cpython/commit/e5d38deb045d0907e6fcf82af8d2d8f0556a8591


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

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

From report at bugs.python.org  Wed Feb 21 01:07:19 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 21 Feb 2018 06:07:19 +0000
Subject: [docs] [issue32008] Example suggest to use a TLSv1 socket
In-Reply-To: <1510428965.62.0.213398074469.issue32008@psf.upfronthosting.co.za>
Message-ID: <1519193239.6.0.467229070634.issue32008@psf.upfronthosting.co.za>


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


New changeset f8a794c04c8d375da279fc830770a5e6b4f363fb by Miss Islington (bot) in branch '3.6':
bpo-32008: don't use PROTOCOL_TLSv1 in example (GH-5789)
https://github.com/python/cpython/commit/f8a794c04c8d375da279fc830770a5e6b4f363fb


----------

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

From report at bugs.python.org  Wed Feb 21 01:17:12 2018
From: report at bugs.python.org (Benjamin Peterson)
Date: Wed, 21 Feb 2018 06:17:12 +0000
Subject: [docs] [issue32008] Example suggest to use a TLSv1 socket
In-Reply-To: <1510428965.62.0.213398074469.issue32008@psf.upfronthosting.co.za>
Message-ID: <1519193832.51.0.467229070634.issue32008@psf.upfronthosting.co.za>


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


New changeset 6c7edba1665ea676328c6b50f92e8423c8f0d164 by Benjamin Peterson in branch '2.7':
[2.7] closes bpo-32008: don't use PROTOCOL_TLSv1 in example (GH-5789) (#5792)
https://github.com/python/cpython/commit/6c7edba1665ea676328c6b50f92e8423c8f0d164


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

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

From report at bugs.python.org  Wed Feb 21 04:45:15 2018
From: report at bugs.python.org (Christian Heimes)
Date: Wed, 21 Feb 2018 09:45:15 +0000
Subject: [docs] [issue32008] Example suggest to use a TLSv1 socket
In-Reply-To: <1510428965.62.0.213398074469.issue32008@psf.upfronthosting.co.za>
Message-ID: <1519206315.55.0.467229070634.issue32008@psf.upfronthosting.co.za>


Christian Heimes <lists at cheimes.de> added the comment:

For 3.6 to 3.8 I'd prefer TLS_PROTOCOL_CLIENT. It also sets check_hostname and verify_mode to sane, safe values, too.

----------
resolution: fixed -> 
stage: resolved -> needs patch
status: closed -> open
versions: +Python 3.6, Python 3.7, Python 3.8

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

From report at bugs.python.org  Wed Feb 21 04:45:56 2018
From: report at bugs.python.org (Christian Heimes)
Date: Wed, 21 Feb 2018 09:45:56 +0000
Subject: [docs] [issue32008] Example suggest to use a TLSv1 socket
In-Reply-To: <1510428965.62.0.213398074469.issue32008@psf.upfronthosting.co.za>
Message-ID: <1519206356.09.0.467229070634.issue32008@psf.upfronthosting.co.za>


Christian Heimes <lists at cheimes.de> added the comment:

Err, I meant PROTOCOL_TLS_CLIENT:

>>> import ssl
>>> context = ssl.SSLContext(ssl.PROTOCOL_TLS_CLIENT)
>>> context.check_hostname
True
>>> context.verify_mode
<VerifyMode.CERT_REQUIRED: 2>

----------

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

From report at bugs.python.org  Wed Feb 21 05:01:55 2018
From: report at bugs.python.org (Christian Heimes)
Date: Wed, 21 Feb 2018 10:01:55 +0000
Subject: [docs] [issue32008] Example suggest to use a TLSv1 socket
In-Reply-To: <1510428965.62.0.213398074469.issue32008@psf.upfronthosting.co.za>
Message-ID: <1519207315.08.0.714561066657.issue32008@psf.upfronthosting.co.za>


Change by Christian Heimes <lists at cheimes.de>:


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

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

From report at bugs.python.org  Wed Feb 21 05:17:25 2018
From: report at bugs.python.org (Antoine Pitrou)
Date: Wed, 21 Feb 2018 10:17:25 +0000
Subject: [docs] [issue32017] profile.Profile() has no method enable()
In-Reply-To: <1510607839.08.0.213398074469.issue32017@psf.upfronthosting.co.za>
Message-ID: <1519208244.94.0.467229070634.issue32017@psf.upfronthosting.co.za>


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

We can't remove public-looking methods (i.e. they don't start with an underscore) like that because some people may be using them.  Rather than document the differences, I think it would be more useful to try to bridge the gap by augmenting the profile API with whatever supplementary APIs cProfile has.  If some API is difficult to implement for profile, then we can revisit that goal and make an exception.

----------

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

From report at bugs.python.org  Wed Feb 21 09:05:22 2018
From: report at bugs.python.org (INADA Naoki)
Date: Wed, 21 Feb 2018 14:05:22 +0000
Subject: [docs] [issue28886] Move deprecated abc module decorators to
 separate section in docs
In-Reply-To: <1481031817.69.0.735601842725.issue28886@psf.upfronthosting.co.za>
Message-ID: <1519221922.81.0.714561066657.issue28886@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Wed Feb 21 15:01:23 2018
From: report at bugs.python.org (xitop)
Date: Wed, 21 Feb 2018 20:01:23 +0000
Subject: [docs] [issue32899] Not documented: key in dict test may raise
 TypeError
Message-ID: <1519243283.39.0.467229070634.issue32899@psf.upfronthosting.co.za>


New submission from xitop <reg.bugs at poti.sk>:

I'd like to suggest an addition to the documentation of the "key in dict" operation.

Current version found at
https://docs.python.org/3/library/stdtypes.html#dict
says only:

---
key in d

    Return True if d has a key key, else False.
---

This is not precise. TypeError is also a possible outcome. It happens when the key is unhashable. Unsure whether the description is incomplete or the membership test has a bug I submitted the issue 32675 in January. The issue was closed with resolution of "not a bug".

If it is indded the intended behaviour, I think it needs to be documented in order to prevent further misunderstandings. Before the issue 32675 I believed a membership test is failsafe, because the definition of __contains__ clearly defines the return value as either True or False.

----------
assignee: docs at python
components: Documentation
messages: 312506
nosy: docs at python, xitop
priority: normal
severity: normal
status: open
title: Not documented: key in dict test may raise TypeError
type: enhancement

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

From report at bugs.python.org  Wed Feb 21 15:08:54 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 21 Feb 2018 20:08:54 +0000
Subject: [docs] [issue32899] Not documented: key in dict test may raise
 TypeError
In-Reply-To: <1519243283.39.0.467229070634.issue32899@psf.upfronthosting.co.za>
Message-ID: <1519243734.76.0.714561066657.issue32899@psf.upfronthosting.co.za>


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


----------
nosy: +inada.naoki, rhettinger

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

From report at bugs.python.org  Wed Feb 21 18:40:20 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Wed, 21 Feb 2018 23:40:20 +0000
Subject: [docs] [issue32899] Not documented: key in dict test may raise
 TypeError
In-Reply-To: <1519243283.39.0.467229070634.issue32899@psf.upfronthosting.co.za>
Message-ID: <1519256420.86.0.467229070634.issue32899@psf.upfronthosting.co.za>


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

In general, Python functions don't document all possible exceptions.  One reason is that it would lead to substantial redundancy in the docs.  Another reason is that functions generally don't know all the possible exceptions that can be raised because that can be controlled determined by the data itself.  Also, the docs try to focus on core functionality and not drown out the message with side details.

For comparison, look at str.startswith() or math.cos() which can raise a TypeError if the input type is incorrect.  There is no reason to discuss that in the docs because most functions raise a TypeError when the type is incorrect.  This is more of a general FAQ than a function by function documentation issue.

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

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

From report at bugs.python.org  Thu Feb 22 01:56:24 2018
From: report at bugs.python.org (xitop)
Date: Thu, 22 Feb 2018 06:56:24 +0000
Subject: [docs] [issue32899] Not documented: key in dict test may raise
 TypeError
In-Reply-To: <1519243283.39.0.467229070634.issue32899@psf.upfronthosting.co.za>
Message-ID: <1519282584.9.0.467229070634.issue32899@psf.upfronthosting.co.za>


xitop <reg.bugs at poti.sk> added the comment:

While I do fully agree with not documenting all exceptions, I'd like to point out a major difference in the case of "unhashable in dict". 

It differs from the general case where an exception means the function is unable to return a meaningful result, beacuse it easily COULD return False as its documentation states. The exception is raised by a design decision, not by necessity. That makes it special.

A single sentence like "A hashable key is precondition of all dict operations." would explain the behaviour well. 

That's all I wanted to say. Thank you.

----------

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

From report at bugs.python.org  Thu Feb 22 02:10:44 2018
From: report at bugs.python.org (INADA Naoki)
Date: Thu, 22 Feb 2018 07:10:44 +0000
Subject: [docs] [issue32899] Not documented: key in dict test may raise
 TypeError
In-Reply-To: <1519243283.39.0.467229070634.issue32899@psf.upfronthosting.co.za>
Message-ID: <1519283444.5.0.467229070634.issue32899@psf.upfronthosting.co.za>


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

We have it already:

https://docs.python.org/3/library/stdtypes.html#mapping-types-dict

> A dictionary?s keys are almost arbitrary values. Values that are not hashable, that is, values containing lists, dictionaries or other mutable types (that are compared by value rather than by object identity) may not be used as keys.

----------

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

From report at bugs.python.org  Thu Feb 22 02:31:39 2018
From: report at bugs.python.org (xitop)
Date: Thu, 22 Feb 2018 07:31:39 +0000
Subject: [docs] [issue32899] Not documented: key in dict test may raise
 TypeError
In-Reply-To: <1519243283.39.0.467229070634.issue32899@psf.upfronthosting.co.za>
Message-ID: <1519284699.31.0.467229070634.issue32899@psf.upfronthosting.co.za>


xitop <reg.bugs at poti.sk> added the comment:

You are right. It is 'key in d', not 'object in d'.

(Thanks for you patience. I'm sorry I did not get it right earlier.)

----------

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

From report at bugs.python.org  Thu Feb 22 09:42:22 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 22 Feb 2018 14:42:22 +0000
Subject: [docs] [issue30449] Improve __slots__ datamodel documentation
In-Reply-To: <1495587707.13.0.0998591622446.issue30449@psf.upfronthosting.co.za>
Message-ID: <1519310542.2.0.467229070634.issue30449@psf.upfronthosting.co.za>


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

Mariatta,

Do you think this one needs to be backported?  You had originally added the labels on the pull request, then removed them.  I wasn't sure if that was needed before being able to close this.

Thanks!

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

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

From report at bugs.python.org  Thu Feb 22 09:50:13 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 22 Feb 2018 14:50:13 +0000
Subject: [docs] [issue26792] docstrings of runpy.run_{module,
 path} are rather sparse
In-Reply-To: <1460944502.67.0.955110104065.issue26792@psf.upfronthosting.co.za>
Message-ID: <1519311013.78.0.714561066657.issue26792@psf.upfronthosting.co.za>


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


----------
keywords: +easy
stage:  -> needs patch
type:  -> enhancement
versions: +Python 3.7, Python 3.8 -Python 3.5

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

From report at bugs.python.org  Thu Feb 22 12:25:29 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 22 Feb 2018 17:25:29 +0000
Subject: [docs] [issue30449] Improve __slots__ datamodel documentation
In-Reply-To: <1495587707.13.0.0998591622446.issue30449@psf.upfronthosting.co.za>
Message-ID: <1519320329.0.0.467229070634.issue30449@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

Yes I think we can backport this to 3.6 and 2.7.

----------

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

From report at bugs.python.org  Thu Feb 22 12:28:00 2018
From: report at bugs.python.org (miss-islington)
Date: Thu, 22 Feb 2018 17:28:00 +0000
Subject: [docs] [issue30449] Improve __slots__ datamodel documentation
In-Reply-To: <1495587707.13.0.0998591622446.issue30449@psf.upfronthosting.co.za>
Message-ID: <1519320480.86.0.714561066657.issue30449@psf.upfronthosting.co.za>


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


----------
keywords: +patch
pull_requests: +5590
stage: backport needed -> patch review

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

From report at bugs.python.org  Thu Feb 22 12:32:08 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 22 Feb 2018 17:32:08 +0000
Subject: [docs] [issue30449] Improve __slots__ datamodel documentation
In-Reply-To: <1495587707.13.0.0998591622446.issue30449@psf.upfronthosting.co.za>
Message-ID: <1519320728.38.0.467229070634.issue30449@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

We can't auto backport to 2.7 because of conflict.
Aaron can you prepare the backport PR?

----------

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

From report at bugs.python.org  Thu Feb 22 12:25:36 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 22 Feb 2018 17:25:36 +0000
Subject: [docs] [issue30449] Improve __slots__ datamodel documentation
In-Reply-To: <1495587707.13.0.0998591622446.issue30449@psf.upfronthosting.co.za>
Message-ID: <1519320336.02.0.714561066657.issue30449@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Feb 22 12:37:43 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 22 Feb 2018 17:37:43 +0000
Subject: [docs] [issue30449] Improve __slots__ datamodel documentation
In-Reply-To: <1495587707.13.0.0998591622446.issue30449@psf.upfronthosting.co.za>
Message-ID: <1519321063.06.0.467229070634.issue30449@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:


New changeset 6eab93cfe5ee08a6168e5bb69474e461cc7ac535 by Mariatta (Miss Islington (bot)) in branch '3.6':
bpo-30449: Improve __slots__ documentation (GH-1819)
https://github.com/python/cpython/commit/6eab93cfe5ee08a6168e5bb69474e461cc7ac535


----------

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

From report at bugs.python.org  Thu Feb 22 15:10:00 2018
From: report at bugs.python.org (Joshua Li)
Date: Thu, 22 Feb 2018 20:10:00 +0000
Subject: [docs] [issue32913] Improve regular expression HOWTO
Message-ID: <1519330200.78.0.467229070634.issue32913@psf.upfronthosting.co.za>


New submission from Joshua Li <joshua.r.li.98 at gmail.com>:

"Python HOWTOs are documents that cover a single, specific topic, and attempt to cover it fairly completely."

It would be quite helpful if the section "non-capturing-and-named-groups" in the regex HOWTO contained at least a mention and short usage example of the re.match.groupdict method, something I have found to be pythonic and useful, yet it does not appear frequently in the docs.

I will be submitting a PR for this.

----------
assignee: docs at python
components: Documentation
messages: 312592
nosy: JoshuaRLi, docs at python
priority: normal
severity: normal
status: open
title: Improve regular expression HOWTO
type: enhancement

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

From report at bugs.python.org  Thu Feb 22 15:41:49 2018
From: report at bugs.python.org (Joshua Li)
Date: Thu, 22 Feb 2018 20:41:49 +0000
Subject: [docs] [issue32913] Improve regular expression HOWTO
In-Reply-To: <1519330200.78.0.467229070634.issue32913@psf.upfronthosting.co.za>
Message-ID: <1519332109.48.0.714561066657.issue32913@psf.upfronthosting.co.za>


Change by Joshua Li <joshua.r.li.98 at gmail.com>:


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

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

From report at bugs.python.org  Thu Feb 22 17:09:32 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 22 Feb 2018 22:09:32 +0000
Subject: [docs] [issue17232] Improve -O docs
In-Reply-To: <1361255101.21.0.948205073894.issue17232@psf.upfronthosting.co.za>
Message-ID: <1519337372.0.0.467229070634.issue17232@psf.upfronthosting.co.za>


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

Should I make a pull request for Terry's last patch?

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

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

From report at bugs.python.org  Thu Feb 22 17:32:40 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 22 Feb 2018 22:32:40 +0000
Subject: [docs] [issue18356] help(numpy) causes segfault on exit
In-Reply-To: <1372924520.77.0.111539946992.issue18356@psf.upfronthosting.co.za>
Message-ID: <1519338760.61.0.467229070634.issue18356@psf.upfronthosting.co.za>


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

It appears that the suggested change from SO was implemented under issue23374 and issue23792.  I cannot recreate this on Ubuntu 16.04, so closing as resolved.

----------
assignee: docs at python -> 
nosy: +csabella
resolution:  -> fixed
stage:  -> resolved
status: open -> closed

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

From report at bugs.python.org  Thu Feb 22 17:45:01 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Thu, 22 Feb 2018 22:45:01 +0000
Subject: [docs] [issue17232] Improve -O docs
In-Reply-To: <1361255101.21.0.948205073894.issue17232@psf.upfronthosting.co.za>
Message-ID: <1519339501.38.0.467229070634.issue17232@psf.upfronthosting.co.za>


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

Cheryl: yes, with changes in responses to Ezio's review.

Nick or Antoine: has there been any change to meaning of -O or -OO that I am not remembering?

----------
versions: +Python 3.6, Python 3.7, Python 3.8 -Python 3.4, Python 3.5

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

From report at bugs.python.org  Thu Feb 22 18:06:32 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 22 Feb 2018 23:06:32 +0000
Subject: [docs] [issue19412] Add docs for test.support.requires_docstrings
 decorator
In-Reply-To: <1382809267.31.0.380635405032.issue19412@psf.upfronthosting.co.za>
Message-ID: <1519340791.99.0.467229070634.issue19412@psf.upfronthosting.co.za>


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

I added `HAVE_DOCSTRINGS`,`MISSING_C_DOCSTRINGS`, `requires_docstring` to the test.support documentation under issue11015.  Additional changes to those three have been made under issue32843, so I am closing this issue in favor of issue32843.  Please comment on that PR if the wording still needs to be adjusted.  Thanks!

----------
nosy: +csabella
resolution:  -> duplicate
stage: needs patch -> resolved
status: open -> closed
superseder:  -> More revisions to test.support docs

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

From report at bugs.python.org  Thu Feb 22 18:11:18 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 22 Feb 2018 23:11:18 +0000
Subject: [docs] [issue26018] documentation of ZipFile file name encoding
In-Reply-To: <1452038801.7.0.594053315947.issue26018@psf.upfronthosting.co.za>
Message-ID: <1519341078.26.0.714561066657.issue26018@psf.upfronthosting.co.za>


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


----------
keywords: +easy
versions: +Python 3.7, Python 3.8 -Python 3.5

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

From report at bugs.python.org  Thu Feb 22 18:21:44 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 22 Feb 2018 23:21:44 +0000
Subject: [docs] [issue30935] document the new behavior of get_event_loop()
 in Python 3.6
In-Reply-To: <1500084221.73.0.556830879215.issue30935@psf.upfronthosting.co.za>
Message-ID: <1519341704.89.0.714561066657.issue30935@psf.upfronthosting.co.za>


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


----------
stage: needs patch -> patch review
type:  -> enhancement

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

From report at bugs.python.org  Thu Feb 22 21:00:01 2018
From: report at bugs.python.org (Nick Coghlan)
Date: Fri, 23 Feb 2018 02:00:01 +0000
Subject: [docs] [issue17232] Improve -O docs
In-Reply-To: <1361255101.21.0.948205073894.issue17232@psf.upfronthosting.co.za>
Message-ID: <1519351201.29.0.467229070634.issue17232@psf.upfronthosting.co.za>


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

We don't change the extension on optimised pyc files any more, we add an optimisation marker to the name without changing the file extension: https://www.python.org/dev/peps/pep-0488/

(This means `-O` and `-OO` don't tread on each other any more)

----------

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

From report at bugs.python.org  Fri Feb 23 06:47:21 2018
From: report at bugs.python.org (INADA Naoki)
Date: Fri, 23 Feb 2018 11:47:21 +0000
Subject: [docs] [issue32087] deprecated-removed directive generates
 overlapping msgids in .pot files
In-Reply-To: <1511187880.98.0.213398074469.issue32087@psf.upfronthosting.co.za>
Message-ID: <1519386441.39.0.467229070634.issue32087@psf.upfronthosting.co.za>


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


New changeset 0febc053736112d7bb9081742b3ac0ece7b973e7 by INADA Naoki (cocoatomo) in branch 'master':
bpo-32087: Doc: Make "deprecated-removed"  directive translatable (GH-4473)
https://github.com/python/cpython/commit/0febc053736112d7bb9081742b3ac0ece7b973e7


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

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

From report at bugs.python.org  Fri Feb 23 06:48:28 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 23 Feb 2018 11:48:28 +0000
Subject: [docs] [issue32087] deprecated-removed directive generates
 overlapping msgids in .pot files
In-Reply-To: <1511187880.98.0.213398074469.issue32087@psf.upfronthosting.co.za>
Message-ID: <1519386508.31.0.714561066657.issue32087@psf.upfronthosting.co.za>


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


----------
pull_requests: +5606

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

From report at bugs.python.org  Fri Feb 23 06:50:27 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 23 Feb 2018 11:50:27 +0000
Subject: [docs] [issue32087] deprecated-removed directive generates
 overlapping msgids in .pot files
In-Reply-To: <1511187880.98.0.213398074469.issue32087@psf.upfronthosting.co.za>
Message-ID: <1519386627.72.0.714561066657.issue32087@psf.upfronthosting.co.za>


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


----------
pull_requests: +5607

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

From report at bugs.python.org  Fri Feb 23 07:08:47 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 23 Feb 2018 12:08:47 +0000
Subject: [docs] [issue32087] deprecated-removed directive generates
 overlapping msgids in .pot files
In-Reply-To: <1511187880.98.0.213398074469.issue32087@psf.upfronthosting.co.za>
Message-ID: <1519387727.83.0.467229070634.issue32087@psf.upfronthosting.co.za>


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


New changeset c673a62d5f3c650130bf40f2161a2eac64419bce by Miss Islington (bot) in branch '3.7':
bpo-32087: Doc: Make "deprecated-removed"  directive translatable (GH-4473)
https://github.com/python/cpython/commit/c673a62d5f3c650130bf40f2161a2eac64419bce


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

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

From report at bugs.python.org  Fri Feb 23 07:13:17 2018
From: report at bugs.python.org (INADA Naoki)
Date: Fri, 23 Feb 2018 12:13:17 +0000
Subject: [docs] [issue32087] deprecated-removed directive generates
 overlapping msgids in .pot files
In-Reply-To: <1511187880.98.0.213398074469.issue32087@psf.upfronthosting.co.za>
Message-ID: <1519387997.18.0.714561066657.issue32087@psf.upfronthosting.co.za>


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


----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed
versions: +Python 3.8

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

From report at bugs.python.org  Fri Feb 23 07:14:06 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 23 Feb 2018 12:14:06 +0000
Subject: [docs] [issue32087] deprecated-removed directive generates
 overlapping msgids in .pot files
In-Reply-To: <1511187880.98.0.213398074469.issue32087@psf.upfronthosting.co.za>
Message-ID: <1519388046.44.0.467229070634.issue32087@psf.upfronthosting.co.za>


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


New changeset dd52d5c868fb1eb33bcf22e777317de0391bfaf6 by Miss Islington (bot) in branch '3.6':
bpo-32087: Doc: Make "deprecated-removed"  directive translatable (GH-4473)
https://github.com/python/cpython/commit/dd52d5c868fb1eb33bcf22e777317de0391bfaf6


----------

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

From tjreedy at udel.edu  Thu Feb 22 17:42:14 2018
From: tjreedy at udel.edu (tjreedy at udel.edu)
Date: Thu, 22 Feb 2018 22:42:14 -0000
Subject: [docs] Improve -O docs (issue 17232)
Message-ID: <20180222224214.20989.42374@psf.upfronthosting.co.za>


https://bugs.python.org/review/17232/diff/7583/Doc/using/cmdline.rst
File Doc/using/cmdline.rst (right):

https://bugs.python.org/review/17232/diff/7583/Doc/using/cmdline.rst#newcode214
Doc/using/cmdline.rst:214: :const:`__debug__`.  Change the filename
extension for compiled
On 2013/03/14 08:47:00, ezio.melotti wrote:
> Does this link to the place where __debug__ is documented (assuming
there is
> such place)?

https://docs.python.org/3/library/constants.html#__debug__

https://bugs.python.org/review/17232/diff/7583/Doc/using/cmdline.rst#newcode221
Doc/using/cmdline.rst:221: Discard docstrings in addition to what
:option:`-O` does.
On 2013/03/14 08:47:00, ezio.melotti wrote:
> What about "Like :option:`-O`, but also discard docstrins."?

At the time I wrote this, -00 *is* -0 + discard docstrings.   I see the
point of mentioning things in this order.  Perhaps

Do :option:`-O` and also discard docstrings.

https://bugs.python.org/review/17232/diff/7583/Modules/main.c
File Modules/main.c (right):

https://bugs.python.org/review/17232/diff/7583/Modules/main.c#newcode69
Modules/main.c:69: -O     : remove assert and __debug__-dependent
statements; change .py\n\
On 2013/03/14 08:47:00, ezio.melotti wrote:
> Shouldn't this be .pyc?

Yes

https://bugs.python.org/review/17232/diff/7583/Modules/main.c#newcode71
Modules/main.c:71: -OO    : remove doc-strings in addition to the -O
changes\n\
On 2013/03/14 08:47:00, ezio.melotti wrote:
> I would re-use the same wording I proposed for the docs.

I suggested a slightly different replacement.

-OO     : do -O and also discard docstrings\n\

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

From report at bugs.python.org  Fri Feb 23 10:30:13 2018
From: report at bugs.python.org (=?utf-8?b?0KLQuNC80L7RhNC10Lkg0KXQuNGA0YzRj9C90L7Qsg==?=)
Date: Fri, 23 Feb 2018 15:30:13 +0000
Subject: [docs] [issue32923] Typo in documentation of unittest: whilst
 instead of while
Message-ID: <1519399813.0.0.467229070634.issue32923@psf.upfronthosting.co.za>


New submission from ??????? ???????? <tkhirianov at gmail.com>:

Typo is on the https://docs.python.org/3/library/unittest.html page.

At bottom of the page you can see text: "unittest.removeHandler(function=None)
When called without arguments this function removes the control-c handler if it has been installed. This function can also be used as a test decorator to temporarily remove the handler whilst the test is being executed:"

Typo is: ST instead of E in the word "whilst".

----------
assignee: docs at python
components: Documentation
messages: 312637
nosy: docs at python, ??????? ????????
priority: normal
severity: normal
status: open
title: Typo in documentation of unittest: whilst instead of while
versions: Python 3.6

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

From report at bugs.python.org  Fri Feb 23 11:20:50 2018
From: report at bugs.python.org (Mark Dickinson)
Date: Fri, 23 Feb 2018 16:20:50 +0000
Subject: [docs] [issue32923] Typo in documentation of unittest: whilst
 instead of while
In-Reply-To: <1519399813.0.0.467229070634.issue32923@psf.upfronthosting.co.za>
Message-ID: <1519402850.53.0.467229070634.issue32923@psf.upfronthosting.co.za>


Mark Dickinson <dickinsm at gmail.com> added the comment:

Not a typo: it's a valid English word.

http://dictionary.cambridge.org/grammar/british-grammar/linking-words-and-expressions/while-and-whilst

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

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

From report at bugs.python.org  Fri Feb 23 11:49:41 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 23 Feb 2018 16:49:41 +0000
Subject: [docs] [issue32923] Typo in documentation of unittest: whilst
 instead of while
In-Reply-To: <1519399813.0.0.467229070634.issue32923@psf.upfronthosting.co.za>
Message-ID: <1519404581.75.0.467229070634.issue32923@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

`while` and `whilst` are both valid english words, however I can understand if readers who don't primarily speak english can get confused.

I'll be open to change that to `while` just to make it friendlier to international readers.

----------
nosy: +Mariatta
versions: +Python 2.7, Python 3.7, Python 3.8

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

From report at bugs.python.org  Fri Feb 23 12:11:41 2018
From: report at bugs.python.org (Eric V. Smith)
Date: Fri, 23 Feb 2018 17:11:41 +0000
Subject: [docs] [issue32923] Typo in documentation of unittest: whilst
 instead of while
In-Reply-To: <1519399813.0.0.467229070634.issue32923@psf.upfronthosting.co.za>
Message-ID: <1519405901.16.0.467229070634.issue32923@psf.upfronthosting.co.za>


Eric V. Smith <eric at trueblade.com> added the comment:

Agree with Marietta: it's valid, but lets change it to make it more approachable to non-native speakers.

----------
nosy: +eric.smith

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

From report at bugs.python.org  Fri Feb 23 12:21:45 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 23 Feb 2018 17:21:45 +0000
Subject: [docs] [issue32923] Typo in documentation of unittest: whilst
 instead of while
In-Reply-To: <1519399813.0.0.467229070634.issue32923@psf.upfronthosting.co.za>
Message-ID: <1519406505.1.0.714561066657.issue32923@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Feb 23 12:24:46 2018
From: report at bugs.python.org (Mark Dickinson)
Date: Fri, 23 Feb 2018 17:24:46 +0000
Subject: [docs] [issue32923] Typo in documentation of unittest: whilst
 instead of while
In-Reply-To: <1519399813.0.0.467229070634.issue32923@psf.upfronthosting.co.za>
Message-ID: <1519406686.67.0.467229070634.issue32923@psf.upfronthosting.co.za>


Mark Dickinson <dickinsm at gmail.com> added the comment:

> lets change it to make it more approachable to non-native speakers.

Sounds good to me.

----------

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

From report at bugs.python.org  Fri Feb 23 12:51:15 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 23 Feb 2018 17:51:15 +0000
Subject: [docs] [issue32923] Typo in documentation of unittest: whilst
 instead of while
In-Reply-To: <1519399813.0.0.467229070634.issue32923@psf.upfronthosting.co.za>
Message-ID: <1519408275.83.0.467229070634.issue32923@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:


New changeset 98f42aac23f3863973cb6e9964c5212cfd3a1d98 by Mariatta in branch 'master':
bpo-32923: Unittest doc: replace `whilst` with `while` (GH-5833)
https://github.com/python/cpython/commit/98f42aac23f3863973cb6e9964c5212cfd3a1d98


----------

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

From report at bugs.python.org  Fri Feb 23 12:52:28 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 23 Feb 2018 17:52:28 +0000
Subject: [docs] [issue32923] Typo in documentation of unittest: whilst
 instead of while
In-Reply-To: <1519399813.0.0.467229070634.issue32923@psf.upfronthosting.co.za>
Message-ID: <1519408348.54.0.714561066657.issue32923@psf.upfronthosting.co.za>


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


----------
pull_requests: +5613

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

From report at bugs.python.org  Fri Feb 23 12:53:22 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 23 Feb 2018 17:53:22 +0000
Subject: [docs] [issue32923] Typo in documentation of unittest: whilst
 instead of while
In-Reply-To: <1519399813.0.0.467229070634.issue32923@psf.upfronthosting.co.za>
Message-ID: <1519408402.59.0.714561066657.issue32923@psf.upfronthosting.co.za>


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


----------
pull_requests: +5614

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

From report at bugs.python.org  Fri Feb 23 12:54:23 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 23 Feb 2018 17:54:23 +0000
Subject: [docs] [issue32923] Typo in documentation of unittest: whilst
 instead of while
In-Reply-To: <1519399813.0.0.467229070634.issue32923@psf.upfronthosting.co.za>
Message-ID: <1519408463.68.0.714561066657.issue32923@psf.upfronthosting.co.za>


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


----------
pull_requests: +5615

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

From report at bugs.python.org  Fri Feb 23 13:02:26 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Fri, 23 Feb 2018 18:02:26 +0000
Subject: [docs] [issue17232] Improve -O docs
In-Reply-To: <1361255101.21.0.948205073894.issue17232@psf.upfronthosting.co.za>
Message-ID: <1519408946.63.0.714561066657.issue17232@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Feb 23 13:04:45 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 23 Feb 2018 18:04:45 +0000
Subject: [docs] [issue32923] Typo in documentation of unittest: whilst
 instead of while
In-Reply-To: <1519399813.0.0.467229070634.issue32923@psf.upfronthosting.co.za>
Message-ID: <1519409085.9.0.467229070634.issue32923@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

Thanks! I've fixed it on master, the backports have been initiated and will finish automatically.

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

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

From report at bugs.python.org  Fri Feb 23 13:05:03 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Fri, 23 Feb 2018 18:05:03 +0000
Subject: [docs] [issue17232] Improve -O docs
In-Reply-To: <1361255101.21.0.948205073894.issue17232@psf.upfronthosting.co.za>
Message-ID: <1519409103.44.0.467229070634.issue17232@psf.upfronthosting.co.za>


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

I've made a PR and tried to integrate the changes from PEP 488.

----------

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

From report at bugs.python.org  Fri Feb 23 13:14:25 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 23 Feb 2018 18:14:25 +0000
Subject: [docs] [issue32923] Typo in documentation of unittest: whilst
 instead of while
In-Reply-To: <1519399813.0.0.467229070634.issue32923@psf.upfronthosting.co.za>
Message-ID: <1519409665.4.0.467229070634.issue32923@psf.upfronthosting.co.za>


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


New changeset 1ad6ca5eb95ebb7351e0f5d9ce607dec54de6407 by Miss Islington (bot) in branch '3.7':
bpo-32923: Unittest doc: replace `whilst` with `while` (GH-5833)
https://github.com/python/cpython/commit/1ad6ca5eb95ebb7351e0f5d9ce607dec54de6407


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

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

From report at bugs.python.org  Fri Feb 23 13:16:58 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 23 Feb 2018 18:16:58 +0000
Subject: [docs] [issue32923] Typo in documentation of unittest: whilst
 instead of while
In-Reply-To: <1519399813.0.0.467229070634.issue32923@psf.upfronthosting.co.za>
Message-ID: <1519409818.5.0.467229070634.issue32923@psf.upfronthosting.co.za>


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


New changeset 8a7f1f4b0ffddf230864ebf16b481546970dd9c2 by Miss Islington (bot) in branch '2.7':
bpo-32923: Unittest doc: replace `whilst` with `while` (GH-5833)
https://github.com/python/cpython/commit/8a7f1f4b0ffddf230864ebf16b481546970dd9c2


----------

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

From report at bugs.python.org  Fri Feb 23 13:22:29 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 23 Feb 2018 18:22:29 +0000
Subject: [docs] [issue32923] Typo in documentation of unittest: whilst
 instead of while
In-Reply-To: <1519399813.0.0.467229070634.issue32923@psf.upfronthosting.co.za>
Message-ID: <1519410149.68.0.467229070634.issue32923@psf.upfronthosting.co.za>


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


New changeset cffe0467ab7b164739693598826bd3860f01b11f by Miss Islington (bot) in branch '3.6':
bpo-32923: Unittest doc: replace `whilst` with `while` (GH-5833)
https://github.com/python/cpython/commit/cffe0467ab7b164739693598826bd3860f01b11f


----------

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

From report at bugs.python.org  Sat Feb 24 02:04:16 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 24 Feb 2018 07:04:16 +0000
Subject: [docs] [issue32758] Stack overflow when parse long expression to AST
In-Reply-To: <1517682171.17.0.467229070634.issue32758@psf.upfronthosting.co.za>
Message-ID: <1519455855.91.0.467229070634.issue32758@psf.upfronthosting.co.za>


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

A consequence of this is that ast.literal_eval() can crash.

>>> import ast
>>> ast.literal_eval("+0"*200000)
Segmentation fault (core dumped)

It should be documented that ast.literal_eval() is not safe.

----------

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

From Nicholas at mytopw.cn  Sat Feb 24 04:14:57 2018
From: Nicholas at mytopw.cn (Nicholas Fu)
Date: Sat, 24 Feb 2018 17:14:57 +0800
Subject: [docs] python
Message-ID: <DM__180223162812_88250387761@smtp.mytopw.cn>

Dear Sir or Madam,
Thanks for reading this letter. This is a letter regarding python brand and domain names(cn hk etc). We are a Chinese domain registrar and received the registration application from Iupo Investment LTD and found the main body of those brand and domain names is same as your company's name. Therefore, we confirm with your company to verify whether or not you two companies are affiliated. Please reply me ASAP. Thanks for your cooperation.
Nicholas Fu
Tel:0086-551 634 911 93
Fax:0086-551 634 911 92
Address:No.358,Jiangnan Xinlicheng Garden,Tongcheng Road,Heifei China
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20180224/b54b1725/attachment-0001.html>

From report at bugs.python.org  Sat Feb 24 07:55:27 2018
From: report at bugs.python.org (Christian Heimes)
Date: Sat, 24 Feb 2018 12:55:27 +0000
Subject: [docs] [issue28124] Rework SSL module documentation
In-Reply-To: <1473762840.76.0.666078412099.issue28124@psf.upfronthosting.co.za>
Message-ID: <1519476927.13.0.714561066657.issue28124@psf.upfronthosting.co.za>


Change by Christian Heimes <lists at cheimes.de>:


----------
versions: +Python 3.8

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

From report at bugs.python.org  Sat Feb 24 22:04:43 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 25 Feb 2018 03:04:43 +0000
Subject: [docs] [issue17232] Improve -O docs
In-Reply-To: <1361255101.21.0.948205073894.issue17232@psf.upfronthosting.co.za>
Message-ID: <1519527883.38.0.467229070634.issue17232@psf.upfronthosting.co.za>


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


New changeset 186b606d8a2ea4fd51b7286813302c8e8c7006cc by Terry Jan Reedy (Cheryl Sabella) in branch 'master':
bpo-17232: Clarify docs for -O and -OO command line options (#5839)
https://github.com/python/cpython/commit/186b606d8a2ea4fd51b7286813302c8e8c7006cc


----------

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

From report at bugs.python.org  Sat Feb 24 22:05:51 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 25 Feb 2018 03:05:51 +0000
Subject: [docs] [issue17232] Improve -O docs
In-Reply-To: <1361255101.21.0.948205073894.issue17232@psf.upfronthosting.co.za>
Message-ID: <1519527951.58.0.714561066657.issue17232@psf.upfronthosting.co.za>


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


----------
pull_requests: +5641

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

From report at bugs.python.org  Sat Feb 24 22:06:50 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 25 Feb 2018 03:06:50 +0000
Subject: [docs] [issue17232] Improve -O docs
In-Reply-To: <1361255101.21.0.948205073894.issue17232@psf.upfronthosting.co.za>
Message-ID: <1519528010.73.0.714561066657.issue17232@psf.upfronthosting.co.za>


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


----------
pull_requests: +5642

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

From report at bugs.python.org  Sat Feb 24 22:24:10 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 25 Feb 2018 03:24:10 +0000
Subject: [docs] [issue17232] Improve -O docs
In-Reply-To: <1361255101.21.0.948205073894.issue17232@psf.upfronthosting.co.za>
Message-ID: <1519529050.54.0.467229070634.issue17232@psf.upfronthosting.co.za>


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


New changeset b5655f3d187084579ff389dbd8734742a8b66cbc by Miss Islington (bot) in branch '3.7':
bpo-17232: Clarify docs for -O and -OO command line options (GH-5839)
https://github.com/python/cpython/commit/b5655f3d187084579ff389dbd8734742a8b66cbc


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

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

From report at bugs.python.org  Sat Feb 24 22:46:18 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 25 Feb 2018 03:46:18 +0000
Subject: [docs] [issue17232] Improve -O docs
In-Reply-To: <1361255101.21.0.948205073894.issue17232@psf.upfronthosting.co.za>
Message-ID: <1519530378.57.0.467229070634.issue17232@psf.upfronthosting.co.za>


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


New changeset fc9471a888f373aedff3c118ae9a6cbf2037bd7c by Miss Islington (bot) in branch '3.6':
bpo-17232: Clarify docs for -O and -OO command line options (GH-5839)
https://github.com/python/cpython/commit/fc9471a888f373aedff3c118ae9a6cbf2037bd7c


----------

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

From report at bugs.python.org  Sat Feb 24 23:08:45 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 25 Feb 2018 04:08:45 +0000
Subject: [docs] [issue17232] Improve -O docs
In-Reply-To: <1361255101.21.0.948205073894.issue17232@psf.upfronthosting.co.za>
Message-ID: <1519531725.9.0.714561066657.issue17232@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sun Feb 25 05:55:32 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 25 Feb 2018 10:55:32 +0000
Subject: [docs] [issue25059] Mistake in input-output tutorial regarding
 print() seperator
In-Reply-To: <1441903521.59.0.166588959306.issue25059@psf.upfronthosting.co.za>
Message-ID: <1519556132.67.0.714561066657.issue25059@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sun Feb 25 05:56:14 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 25 Feb 2018 10:56:14 +0000
Subject: [docs] [issue25059] Mistake in input-output tutorial regarding
 print() seperator
In-Reply-To: <1441903521.59.0.166588959306.issue25059@psf.upfronthosting.co.za>
Message-ID: <1519556174.7.0.467229070634.issue25059@psf.upfronthosting.co.za>


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

Created a PR based on the discussion and not the original patch.

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

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

From report at bugs.python.org  Sun Feb 25 08:50:58 2018
From: report at bugs.python.org (bbayles)
Date: Sun, 25 Feb 2018 13:50:58 +0000
Subject: [docs] [issue32017] profile.Profile() has no method enable()
In-Reply-To: <1510607839.08.0.213398074469.issue32017@psf.upfronthosting.co.za>
Message-ID: <1519566657.99.0.467229070634.issue32017@psf.upfronthosting.co.za>


bbayles <bbayles at gmail.com> added the comment:

I'm afraid that profile.Profile and cProfile.Profile behave pretty differently, and there's not a good way to bring the methods from the C version to the Python version.

The example at [1] shows a cProfile.Profile object being instantiated and enabled. At this point the profiler is tracing execution - until the disable() method is called, any activity is recorded.

profile.Profile doesn't work this way. Creating a profile.Profile object doesn't cause activity to be recorded. It doesn't do anything until you call one of its run* methods.

This is because the C version uses PyEval_SetProfile ([2]) to take advantage of CPython's "low-level support for attaching profiling and execution tracing facilities" ([3]). I don't think we can do that from the Python version.

There is already a precedent for showing differences between cProfile.Profile and profile.Profile in the existing docs - see [4].


[1] https://docs.python.org/3/library/profile.html#profile.Profile
[2] https://github.com/python/cpython/blob/6f0eb93183519024cb360162bdd81b9faec97ba6/Modules/_lsprof.c#L693
[3] https://docs.python.org/3/c-api/init.html#profiling-and-tracing
[4] https://docs.python.org/3/library/profile.html#using-a-custom-timer

----------
nosy: +bbayles

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

From report at bugs.python.org  Sun Feb 25 10:23:31 2018
From: report at bugs.python.org (bbayles)
Date: Sun, 25 Feb 2018 15:23:31 +0000
Subject: [docs] [issue32017] profile.Profile() has no method enable()
In-Reply-To: <1510607839.08.0.213398074469.issue32017@psf.upfronthosting.co.za>
Message-ID: <1519572211.4.0.714561066657.issue32017@psf.upfronthosting.co.za>


Change by bbayles <bbayles at gmail.com>:


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

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

From report at bugs.python.org  Sun Feb 25 10:27:59 2018
From: report at bugs.python.org (bbayles)
Date: Sun, 25 Feb 2018 15:27:59 +0000
Subject: [docs] [issue32017] profile.Profile() has no method enable()
In-Reply-To: <1510607839.08.0.213398074469.issue32017@psf.upfronthosting.co.za>
Message-ID: <1519572479.5.0.467229070634.issue32017@psf.upfronthosting.co.za>


bbayles <bbayles at gmail.com> added the comment:

I've made a pull request that clarifies things in the docs.

As csabella notes, there are some more differences that could be pointed out. The 'subcalls' and 'builtins' arguments could be explained as well.

Nonetheless, I think the PR does fix some definitely incorrect aspects of the existing documentation and is at least an improvement.

----------

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

From report at bugs.python.org  Sun Feb 25 10:36:22 2018
From: report at bugs.python.org (Christian Heimes)
Date: Sun, 25 Feb 2018 15:36:22 +0000
Subject: [docs] [issue28124] Rework SSL module documentation
In-Reply-To: <1473762840.76.0.666078412099.issue28124@psf.upfronthosting.co.za>
Message-ID: <1519572982.28.0.714561066657.issue28124@psf.upfronthosting.co.za>


Change by Christian Heimes <lists at cheimes.de>:


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

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

From report at bugs.python.org  Sun Feb 25 12:05:08 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 25 Feb 2018 17:05:08 +0000
Subject: [docs] [issue13790] In str.format an incorrect error message for
 list, tuple, dict, set
In-Reply-To: <1326605478.95.0.601079964751.issue13790@psf.upfronthosting.co.za>
Message-ID: <1519578308.53.0.467229070634.issue13790@psf.upfronthosting.co.za>


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

>From the examples in msg220401, issue28385 changed it to print the object type in the message. 

>>> format([], 'd')
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: unsupported format string passed to list.__format__
>>> format((), 'd')
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: unsupported format string passed to tuple.__format__


Would the change left on this issue be to create a PR for Terry's documetation patch?

Thanks!

----------
nosy: +csabella
versions: +Python 3.6, Python 3.7, Python 3.8 -Python 3.4, Python 3.5

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

From report at bugs.python.org  Sun Feb 25 13:55:56 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sun, 25 Feb 2018 18:55:56 +0000
Subject: [docs] [issue31454] Include "import as" in tutorial
In-Reply-To: <1505317940.24.0.986048971751.issue31454@psf.upfronthosting.co.za>
Message-ID: <1519584956.65.0.467229070634.issue31454@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

> PR 4041 looks good to me. Mariatta, do you have time to look at Mario's patch?

Sorry I just saw this now, months later.
Looks good to me. I can merge and backport once the CI passed.
Thanks!

----------

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

From report at bugs.python.org  Sun Feb 25 14:06:03 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sun, 25 Feb 2018 19:06:03 +0000
Subject: [docs] [issue25059] Mistake in input-output tutorial regarding
 print() seperator
In-Reply-To: <1441903521.59.0.166588959306.issue25059@psf.upfronthosting.co.za>
Message-ID: <1519585563.94.0.467229070634.issue25059@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:


New changeset 84c4b0cc67ceb4b70842b78c718b6e8214874d6a by Mariatta (Cheryl Sabella) in branch 'master':
bpo-25059: Clarify the print separator usage in tutorial (GH-5879)
https://github.com/python/cpython/commit/84c4b0cc67ceb4b70842b78c718b6e8214874d6a


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

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

From report at bugs.python.org  Sun Feb 25 14:07:11 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 25 Feb 2018 19:07:11 +0000
Subject: [docs] [issue25059] Mistake in input-output tutorial regarding
 print() seperator
In-Reply-To: <1441903521.59.0.166588959306.issue25059@psf.upfronthosting.co.za>
Message-ID: <1519585631.97.0.714561066657.issue25059@psf.upfronthosting.co.za>


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


----------
pull_requests: +5664

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

From report at bugs.python.org  Sun Feb 25 14:09:12 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 25 Feb 2018 19:09:12 +0000
Subject: [docs] [issue25059] Mistake in input-output tutorial regarding
 print() seperator
In-Reply-To: <1441903521.59.0.166588959306.issue25059@psf.upfronthosting.co.za>
Message-ID: <1519585752.51.0.714561066657.issue25059@psf.upfronthosting.co.za>


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


----------
pull_requests: +5665

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

From report at bugs.python.org  Sun Feb 25 14:11:14 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sun, 25 Feb 2018 19:11:14 +0000
Subject: [docs] [issue31454] Include "import as" in tutorial
In-Reply-To: <1505317940.24.0.986048971751.issue31454@psf.upfronthosting.co.za>
Message-ID: <1519585874.22.0.467229070634.issue31454@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:


New changeset fbee88244e8921afdb29fde51a9a010a8ae18277 by Mariatta (Mario Corchero) in branch 'master':
bpo-31454: Include information about "import X as Y" in Modules tutorial (GH-4041)
https://github.com/python/cpython/commit/fbee88244e8921afdb29fde51a9a010a8ae18277


----------

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

From report at bugs.python.org  Sun Feb 25 14:12:21 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 25 Feb 2018 19:12:21 +0000
Subject: [docs] [issue31454] Include "import as" in tutorial
In-Reply-To: <1505317940.24.0.986048971751.issue31454@psf.upfronthosting.co.za>
Message-ID: <1519585941.08.0.714561066657.issue31454@psf.upfronthosting.co.za>


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


----------
pull_requests: +5666

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

From report at bugs.python.org  Sun Feb 25 14:13:20 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 25 Feb 2018 19:13:20 +0000
Subject: [docs] [issue31454] Include "import as" in tutorial
In-Reply-To: <1505317940.24.0.986048971751.issue31454@psf.upfronthosting.co.za>
Message-ID: <1519586000.75.0.714561066657.issue31454@psf.upfronthosting.co.za>


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


----------
pull_requests: +5667

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

From report at bugs.python.org  Sun Feb 25 14:13:35 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 25 Feb 2018 19:13:35 +0000
Subject: [docs] [issue25059] Mistake in input-output tutorial regarding
 print() seperator
In-Reply-To: <1441903521.59.0.166588959306.issue25059@psf.upfronthosting.co.za>
Message-ID: <1519586015.81.0.467229070634.issue25059@psf.upfronthosting.co.za>


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


New changeset ddf2485103c1e56ba4f290641247dfa07fcbe7f3 by Miss Islington (bot) in branch '3.7':
bpo-25059: Clarify the print separator usage in tutorial (GH-5879)
https://github.com/python/cpython/commit/ddf2485103c1e56ba4f290641247dfa07fcbe7f3


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

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

From report at bugs.python.org  Sun Feb 25 14:14:22 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 25 Feb 2018 19:14:22 +0000
Subject: [docs] [issue31454] Include "import as" in tutorial
In-Reply-To: <1505317940.24.0.986048971751.issue31454@psf.upfronthosting.co.za>
Message-ID: <1519586062.51.0.714561066657.issue31454@psf.upfronthosting.co.za>


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


----------
pull_requests: +5668

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

From report at bugs.python.org  Sun Feb 25 14:14:53 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 25 Feb 2018 19:14:53 +0000
Subject: [docs] [issue13790] In str.format an incorrect error message for
 list, tuple, dict, set
In-Reply-To: <1326605478.95.0.601079964751.issue13790@psf.upfronthosting.co.za>
Message-ID: <1519586093.16.0.467229070634.issue13790@psf.upfronthosting.co.za>


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

In msg151730, R. David Murry said "Terry's [first] patch with the ("{}") removed should be committed, though."
In msg151738, Eric V. Smith said "I agree with your comment about Terry's patch."

My second patch removed "{}" but also made more text changes, explained in msg151757.  Someone should re-review

----------

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

From report at bugs.python.org  Sun Feb 25 14:16:37 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sun, 25 Feb 2018 19:16:37 +0000
Subject: [docs] [issue31454] Include "import as" in tutorial
In-Reply-To: <1505317940.24.0.986048971751.issue31454@psf.upfronthosting.co.za>
Message-ID: <1519586197.02.0.467229070634.issue31454@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

Thanks everyone. I've merged Marios's PR. The backport PRs have started and will automerge.

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

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

From report at bugs.python.org  Sun Feb 25 14:21:17 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 25 Feb 2018 19:21:17 +0000
Subject: [docs] [issue25059] Mistake in input-output tutorial regarding
 print() seperator
In-Reply-To: <1441903521.59.0.166588959306.issue25059@psf.upfronthosting.co.za>
Message-ID: <1519586477.93.0.467229070634.issue25059@psf.upfronthosting.co.za>


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


New changeset b9678d3aa156996947655ed66b554f6307b29546 by Miss Islington (bot) in branch '3.6':
bpo-25059: Clarify the print separator usage in tutorial (GH-5879)
https://github.com/python/cpython/commit/b9678d3aa156996947655ed66b554f6307b29546


----------

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

From report at bugs.python.org  Sun Feb 25 14:33:16 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 25 Feb 2018 19:33:16 +0000
Subject: [docs] [issue31454] Include "import as" in tutorial
In-Reply-To: <1505317940.24.0.986048971751.issue31454@psf.upfronthosting.co.za>
Message-ID: <1519587196.32.0.467229070634.issue31454@psf.upfronthosting.co.za>


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


New changeset 5a07608d0855e4104e4070328155b52010dec4e7 by Miss Islington (bot) in branch '3.6':
bpo-31454: Include information about "import X as Y" in Modules tutorial (GH-4041)
https://github.com/python/cpython/commit/5a07608d0855e4104e4070328155b52010dec4e7


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

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

From report at bugs.python.org  Sun Feb 25 14:35:54 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 25 Feb 2018 19:35:54 +0000
Subject: [docs] [issue31454] Include "import as" in tutorial
In-Reply-To: <1505317940.24.0.986048971751.issue31454@psf.upfronthosting.co.za>
Message-ID: <1519587354.59.0.467229070634.issue31454@psf.upfronthosting.co.za>


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


New changeset e48e6499bbad56f7cc665efa25ae4847f51dbc38 by Miss Islington (bot) in branch '3.7':
bpo-31454: Include information about "import X as Y" in Modules tutorial (GH-4041)
https://github.com/python/cpython/commit/e48e6499bbad56f7cc665efa25ae4847f51dbc38


----------

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

From report at bugs.python.org  Sun Feb 25 14:38:26 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 25 Feb 2018 19:38:26 +0000
Subject: [docs] [issue31454] Include "import as" in tutorial
In-Reply-To: <1505317940.24.0.986048971751.issue31454@psf.upfronthosting.co.za>
Message-ID: <1519587506.88.0.467229070634.issue31454@psf.upfronthosting.co.za>


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


New changeset 76349471adfa4366a92438c88fd05a0e1e94c59b by Miss Islington (bot) in branch '2.7':
bpo-31454: Include information about "import X as Y" in Modules tutorial (GH-4041)
https://github.com/python/cpython/commit/76349471adfa4366a92438c88fd05a0e1e94c59b


----------

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

From report at bugs.python.org  Sun Feb 25 15:20:40 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 25 Feb 2018 20:20:40 +0000
Subject: [docs] [issue25059] Mistake in input-output tutorial regarding
 print() seperator
In-Reply-To: <1441903521.59.0.166588959306.issue25059@psf.upfronthosting.co.za>
Message-ID: <1519590040.3.0.714561066657.issue25059@psf.upfronthosting.co.za>


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


----------
pull_requests: +5669

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

From report at bugs.python.org  Sun Feb 25 15:50:29 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sun, 25 Feb 2018 20:50:29 +0000
Subject: [docs] [issue25059] Mistake in input-output tutorial regarding
 print() seperator
In-Reply-To: <1441903521.59.0.166588959306.issue25059@psf.upfronthosting.co.za>
Message-ID: <1519591829.0.0.467229070634.issue25059@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:


New changeset b7c1a94f94305d82fc77f833fd68cc8616991bd4 by Mariatta (Cheryl Sabella) in branch '2.7':
[2.7] bpo-25059: Clarify the print separator usage in tutorial (GH-5879)
https://github.com/python/cpython/commit/b7c1a94f94305d82fc77f833fd68cc8616991bd4


----------

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

From report at bugs.python.org  Sun Feb 25 15:50:49 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sun, 25 Feb 2018 20:50:49 +0000
Subject: [docs] [issue25059] Mistake in input-output tutorial regarding
 print() seperator
In-Reply-To: <1441903521.59.0.166588959306.issue25059@psf.upfronthosting.co.za>
Message-ID: <1519591849.22.0.467229070634.issue25059@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

Thanks!

----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed
versions: +Python 2.7, Python 3.7, Python 3.8 -Python 3.5

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

From report at bugs.python.org  Sun Feb 25 16:03:37 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 25 Feb 2018 21:03:37 +0000
Subject: [docs] [issue13474] Mention of "-m" Flag Missing From Doc on
 Execution Model
In-Reply-To: <1322165458.97.0.989343856998.issue13474@psf.upfronthosting.co.za>
Message-ID: <1519592617.47.0.714561066657.issue13474@psf.upfronthosting.co.za>


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


----------
keywords: +easy
type:  -> enhancement
versions: +Python 3.7, Python 3.8 -Python 3.2, Python 3.3

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

From report at bugs.python.org  Sun Feb 25 16:13:00 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 25 Feb 2018 21:13:00 +0000
Subject: [docs] [issue32500] PySequence_Length() raises TypeError on dict
 type
In-Reply-To: <1515199107.36.0.467229070634.issue32500@psf.upfronthosting.co.za>
Message-ID: <1519593180.47.0.714561066657.issue32500@psf.upfronthosting.co.za>


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


----------
pull_requests: +5670

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

From report at bugs.python.org  Sun Feb 25 16:14:07 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 25 Feb 2018 21:14:07 +0000
Subject: [docs] [issue32500] PySequence_Length() raises TypeError on dict
 type
In-Reply-To: <1515199107.36.0.467229070634.issue32500@psf.upfronthosting.co.za>
Message-ID: <1519593247.43.0.714561066657.issue32500@psf.upfronthosting.co.za>


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


----------
pull_requests: +5671

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

From report at bugs.python.org  Sun Feb 25 16:19:57 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 25 Feb 2018 21:19:57 +0000
Subject: [docs] [issue32500] PySequence_Length() raises TypeError on dict
 type
In-Reply-To: <1515199107.36.0.467229070634.issue32500@psf.upfronthosting.co.za>
Message-ID: <1519593597.35.0.467229070634.issue32500@psf.upfronthosting.co.za>


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


New changeset 139e64694f546982a8cc801dda30670abadb8d06 by Miss Islington (bot) in branch '3.7':
bpo-32500: Correct the documentation for PySequence_Size() and PySequence_Length() (GH-5767)
https://github.com/python/cpython/commit/139e64694f546982a8cc801dda30670abadb8d06


----------

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

From report at bugs.python.org  Sun Feb 25 16:22:46 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 25 Feb 2018 21:22:46 +0000
Subject: [docs] [issue32500] PySequence_Length() raises TypeError on dict
 type
In-Reply-To: <1515199107.36.0.467229070634.issue32500@psf.upfronthosting.co.za>
Message-ID: <1519593766.17.0.467229070634.issue32500@psf.upfronthosting.co.za>


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


New changeset ecaa372f74eeb6c032791c520af6b23e527d335f by Miss Islington (bot) in branch '2.7':
bpo-32500: Correct the documentation for PySequence_Size() and PySequence_Length() (GH-5767)
https://github.com/python/cpython/commit/ecaa372f74eeb6c032791c520af6b23e527d335f


----------

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

From report at bugs.python.org  Sun Feb 25 16:29:04 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sun, 25 Feb 2018 21:29:04 +0000
Subject: [docs] [issue32500] PySequence_Length() raises TypeError on dict
 type
In-Reply-To: <1515199107.36.0.467229070634.issue32500@psf.upfronthosting.co.za>
Message-ID: <1519594144.33.0.467229070634.issue32500@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta.wijaya at gmail.com> added the comment:

Thanks!

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

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

From report at bugs.python.org  Sun Feb 25 18:19:08 2018
From: report at bugs.python.org (bbayles)
Date: Sun, 25 Feb 2018 23:19:08 +0000
Subject: [docs] [issue17286] Make subprocess handling text output with
 universal_newlines more obious
In-Reply-To: <1361708455.88.0.426093416103.issue17286@psf.upfronthosting.co.za>
Message-ID: <1519600748.05.0.467229070634.issue17286@psf.upfronthosting.co.za>


bbayles <bbayles at gmail.com> added the comment:

This is fixed in 3.7 with the `text` parameter. See GitHub PR 4049: https://github.com/python/cpython/pull/4049

----------
nosy: +bbayles

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

From report at bugs.python.org  Sun Feb 25 18:28:20 2018
From: report at bugs.python.org (bbayles)
Date: Sun, 25 Feb 2018 23:28:20 +0000
Subject: [docs] [issue19894] zipfile ignores deflate level settings in
 zipinfo object
In-Reply-To: <1386235609.47.0.431866049959.issue19894@psf.upfronthosting.co.za>
Message-ID: <1519601300.29.0.467229070634.issue19894@psf.upfronthosting.co.za>


bbayles <bbayles at gmail.com> added the comment:

This was fixed in issue 21417, in Github PR 5385:

https://github.com/python/cpython/pull/5385

----------
nosy: +bbayles

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

From report at bugs.python.org  Mon Feb 26 03:25:04 2018
From: report at bugs.python.org (Christian Heimes)
Date: Mon, 26 Feb 2018 08:25:04 +0000
Subject: [docs] [issue18617] AIA chasing for missing intermediate
 certificates on TLS connections
In-Reply-To: <1375376317.99.0.429350247521.issue18617@psf.upfronthosting.co.za>
Message-ID: <1519633504.59.0.714561066657.issue18617@psf.upfronthosting.co.za>


Change by Christian Heimes <lists at cheimes.de>:


----------
assignee: docs at python -> christian.heimes
stage:  -> needs patch
versions: +Python 3.8 -Python 3.7

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

From report at bugs.python.org  Mon Feb 26 04:06:41 2018
From: report at bugs.python.org (Christian Heimes)
Date: Mon, 26 Feb 2018 09:06:41 +0000
Subject: [docs] [issue31711] ssl.SSLSocket.send(b"") fails
In-Reply-To: <1507282980.19.0.213398074469.issue31711@psf.upfronthosting.co.za>
Message-ID: <1519636001.87.0.467229070634.issue31711@psf.upfronthosting.co.za>


Christian Heimes <lists at cheimes.de> added the comment:

It's a bit too late to change the behavior of send(). Let's document the issue instead.

----------
assignee: christian.heimes -> docs at python
components: +Documentation
nosy: +alex, docs at python, dstufft, janssen, njs
stage:  -> needs patch
versions: +Python 2.7, Python 3.7, Python 3.8

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

From report at bugs.python.org  Mon Feb 26 04:42:33 2018
From: report at bugs.python.org (Nathaniel Smith)
Date: Mon, 26 Feb 2018 09:42:33 +0000
Subject: [docs] [issue31711] ssl.SSLSocket.send(b"") fails
In-Reply-To: <1507282980.19.0.213398074469.issue31711@psf.upfronthosting.co.za>
Message-ID: <1519638153.45.0.467229070634.issue31711@psf.upfronthosting.co.za>


Nathaniel Smith <njs at pobox.com> added the comment:

If openssl says the behavior is undefined, then don't we have to first make it defined before we can document it?

And if we're going to detect this case and guarantee some behavior, making it a no-op like it is on regular sockets seems the way to go...

----------

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

From report at bugs.python.org  Mon Feb 26 04:57:24 2018
From: report at bugs.python.org (Christian Heimes)
Date: Mon, 26 Feb 2018 09:57:24 +0000
Subject: [docs] [issue31711] ssl.SSLSocket.send(b"") fails
In-Reply-To: <1507282980.19.0.213398074469.issue31711@psf.upfronthosting.co.za>
Message-ID: <1519639044.92.0.467229070634.issue31711@psf.upfronthosting.co.za>


Christian Heimes <lists at cheimes.de> added the comment:

The message "EOF occurred in violation of protocol" is set by Python. Python maps SSL_ERROR_SYSCALL with SSL error code == 0 and len == 0 to that error message. 

https://github.com/python/cpython/blob/master/Modules/_ssl.c#L682-L689
https://github.com/python/cpython/blob/master/Modules/_ssl.c#L2263

I don't know why the code was implemented that way.

----------

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

From report at bugs.python.org  Mon Feb 26 10:37:03 2018
From: report at bugs.python.org (Mark Lawrence)
Date: Mon, 26 Feb 2018 15:37:03 +0000
Subject: [docs] [issue13790] In str.format an incorrect error message for
 list, tuple, dict, set
In-Reply-To: <1326605478.95.0.601079964751.issue13790@psf.upfronthosting.co.za>
Message-ID: <1519659423.38.0.714561066657.issue13790@psf.upfronthosting.co.za>


Change by Mark Lawrence <breamoreboy at gmail.com>:


----------
nosy:  -BreamoreBoy

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

From report at bugs.python.org  Mon Feb 26 10:37:23 2018
From: report at bugs.python.org (Mark Lawrence)
Date: Mon, 26 Feb 2018 15:37:23 +0000
Subject: [docs] [issue17286] Make subprocess handling text output with
 universal_newlines more obious
In-Reply-To: <1361708455.88.0.426093416103.issue17286@psf.upfronthosting.co.za>
Message-ID: <1519659443.47.0.714561066657.issue17286@psf.upfronthosting.co.za>


Change by Mark Lawrence <breamoreboy at gmail.com>:


----------
nosy:  -BreamoreBoy

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

From report at bugs.python.org  Mon Feb 26 15:54:16 2018
From: report at bugs.python.org (Nathaniel Smith)
Date: Mon, 26 Feb 2018 20:54:16 +0000
Subject: [docs] [issue31711] ssl.SSLSocket.send(b"") fails
In-Reply-To: <1507282980.19.0.213398074469.issue31711@psf.upfronthosting.co.za>
Message-ID: <1519678456.56.0.467229070634.issue31711@psf.upfronthosting.co.za>


Nathaniel Smith <njs at pobox.com> added the comment:

My point is that SSL_write(3ssl) says "WARNING: When calling SSL_write() with num=0 bytes to be sent the behaviour is undefined."

Apparently on the particular openssl you're looking at, it gives SSL_ERROR_SYSCALL with error code == 0 and len == 0, but the openssl devs claim this is some arbitrary thing that shouldn't be depended on.

Just as a general principle it would be nice if performing ordinary operations on an SSLSocket from Python did not invoke undefined behavior :-)

----------

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

From report at bugs.python.org  Mon Feb 26 21:26:07 2018
From: report at bugs.python.org (Andrew Brezovsky)
Date: Tue, 27 Feb 2018 02:26:07 +0000
Subject: [docs] [issue26792] docstrings of runpy.run_{module,
 path} are rather sparse
In-Reply-To: <1460944502.67.0.955110104065.issue26792@psf.upfronthosting.co.za>
Message-ID: <1519698367.21.0.467229070634.issue26792@psf.upfronthosting.co.za>


Andrew Brezovsky <abrezovsky at gmail.com> added the comment:

I'll update these based on the information in the HTML docs.

----------
nosy: +abrezovsky

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

From report at bugs.python.org  Mon Feb 26 23:24:25 2018
From: report at bugs.python.org (Andrew Brezovsky)
Date: Tue, 27 Feb 2018 04:24:25 +0000
Subject: [docs] [issue26792] docstrings of runpy.run_{module,
 path} are rather sparse
In-Reply-To: <1460944502.67.0.955110104065.issue26792@psf.upfronthosting.co.za>
Message-ID: <1519705465.65.0.714561066657.issue26792@psf.upfronthosting.co.za>


Change by Andrew Brezovsky <abrezovsky at gmail.com>:


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

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

From report at bugs.python.org  Tue Feb 27 03:21:36 2018
From: report at bugs.python.org (Christian Heimes)
Date: Tue, 27 Feb 2018 08:21:36 +0000
Subject: [docs] [issue28124] Rework SSL module documentation
In-Reply-To: <1473762840.76.0.666078412099.issue28124@psf.upfronthosting.co.za>
Message-ID: <1519719696.93.0.467229070634.issue28124@psf.upfronthosting.co.za>


Christian Heimes <lists at cheimes.de> added the comment:


New changeset 90f05a527c7d439f1d0cba80f2eb32e60ee20fc3 by Christian Heimes in branch 'master':
bpo-28124: deprecate ssl.wrap_socket() (#5888)
https://github.com/python/cpython/commit/90f05a527c7d439f1d0cba80f2eb32e60ee20fc3


----------

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

From report at bugs.python.org  Tue Feb 27 03:22:47 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 27 Feb 2018 08:22:47 +0000
Subject: [docs] [issue28124] Rework SSL module documentation
In-Reply-To: <1473762840.76.0.666078412099.issue28124@psf.upfronthosting.co.za>
Message-ID: <1519719767.68.0.714561066657.issue28124@psf.upfronthosting.co.za>


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


----------
pull_requests: +5695

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

From report at bugs.python.org  Tue Feb 27 04:04:23 2018
From: report at bugs.python.org (Martijn Pieters)
Date: Tue, 27 Feb 2018 09:04:23 +0000
Subject: [docs] [issue32963] Python 2.7 tutorial claims source code is UTF-8
 encoded
Message-ID: <1519722263.23.0.467229070634.issue32963@psf.upfronthosting.co.za>


New submission from Martijn Pieters <mj at python.org>:

Issue #29381 updated the tutorial to clarify #! use, but the 2.7 patch re-used Python 3 material that doesn't apply. See r40ba60f6 at https://github.com/python/cpython/commit/40ba60f6bf2f7192f86da395c71348d0fa24da09

It now reads:

"By default, Python source files are treated as encoded in UTF-8."

and

" To display all these characters properly, your editor must recognize that the file is UTF-8, and it must use a font that supports all the characters in the file."

This is a huge deviation from the previous text, and confusing and wrong to people new to Python 2.

----------
assignee: docs at python
components: Documentation
messages: 312986
nosy: docs at python, mjpieters
priority: normal
severity: normal
status: open
title: Python 2.7 tutorial claims source code is UTF-8 encoded
versions: Python 2.7

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

From report at bugs.python.org  Tue Feb 27 04:05:04 2018
From: report at bugs.python.org (Martijn Pieters)
Date: Tue, 27 Feb 2018 09:05:04 +0000
Subject: [docs] [issue32963] Python 2.7 tutorial claims source code is UTF-8
 encoded
In-Reply-To: <1519722263.23.0.467229070634.issue32963@psf.upfronthosting.co.za>
Message-ID: <1519722304.55.0.714561066657.issue32963@psf.upfronthosting.co.za>


Change by Martijn Pieters <mj at python.org>:


----------
nosy: +Mariatta, rhettinger

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

From report at bugs.python.org  Tue Feb 27 04:45:33 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 27 Feb 2018 09:45:33 +0000
Subject: [docs] [issue28124] Rework SSL module documentation
In-Reply-To: <1473762840.76.0.666078412099.issue28124@psf.upfronthosting.co.za>
Message-ID: <1519724733.35.0.467229070634.issue28124@psf.upfronthosting.co.za>


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


New changeset 102d5204add249248d1a0fa1dd3f673e884b06b4 by Miss Islington (bot) in branch '3.7':
bpo-28124: deprecate ssl.wrap_socket() (GH-5888)
https://github.com/python/cpython/commit/102d5204add249248d1a0fa1dd3f673e884b06b4


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

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

From report at bugs.python.org  Tue Feb 27 18:08:36 2018
From: report at bugs.python.org (Neeraj Badlani)
Date: Tue, 27 Feb 2018 23:08:36 +0000
Subject: [docs] [issue32967] make check in devguide failing
Message-ID: <1519772916.68.0.714561066657.issue32967@psf.upfronthosting.co.za>


Change by Neeraj Badlani <neerajbadlani.edu at gmail.com>:


----------
assignee: docs at python
components: Documentation
nosy: docs at python, neerajbadlani
priority: normal
severity: normal
status: open
title: make check in devguide failing
versions: Python 3.8

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

From report at bugs.python.org  Tue Feb 27 18:27:27 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 27 Feb 2018 23:27:27 +0000
Subject: [docs] [issue32967] make check in devguide failing
Message-ID: <1519774047.18.0.467229070634.issue32967@psf.upfronthosting.co.za>


New submission from Mariatta Wijaya <mariatta.wijaya at gmail.com>:

Thanks. Can you open the issue in github.com/python/devguide?

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

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

From report at bugs.python.org  Wed Feb 28 03:59:00 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Wed, 28 Feb 2018 08:59:00 +0000
Subject: [docs] [issue32969] Add more constants to zlib module
Message-ID: <1519808340.69.0.467229070634.issue32969@psf.upfronthosting.co.za>


New submission from Xiang Zhang <angwerzx at 126.com>:

Inspired by https://github.com/python/cpython/pull/5511, zlib module in Python lacks some constants exposed by C zlib library, and some constants are not documented.

----------
assignee: docs at python
components: Documentation, Library (Lib)
messages: 313053
nosy: docs at python, xiang.zhang
priority: normal
severity: normal
status: open
title: Add more constants to zlib module
type: enhancement
versions: Python 3.8

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

From report at bugs.python.org  Wed Feb 28 12:58:02 2018
From: report at bugs.python.org (NODA, Kai)
Date: Wed, 28 Feb 2018 17:58:02 +0000
Subject: [docs] [issue32971] unittest.TestCase.assertRaises
Message-ID: <1519840682.18.0.467229070634.issue32971@psf.upfronthosting.co.za>


New submission from NODA, Kai <nodakai at gmail.com>:

https://docs.python.org/dev/library/unittest.html#unittest.TestCase.assertRaises

> If only the exception and possibly the msg arguments are given, return a context manager so that the code under test can be written inline rather than as a function:
> 
>     with self.assertRaises(SomeException):
          do_something()
> 
> When used as a context manager, assertRaises() accepts the additional keyword argument msg.

Perhaps we don't need the second sentence on the `msg` argument which isn't adding anything new.

Ideally it should be more clear when the method operates in context manager mode.
("If only" and "possibly" don't play nicely together.)
Maybe along the lines of "If no callable was passed as an argument ..." ? I haven't looked in to the actual implementation yet...

----------
assignee: docs at python
components: Documentation
messages: 313061
nosy: docs at python, nodakai
priority: normal
severity: normal
status: open
title: unittest.TestCase.assertRaises
versions: Python 3.8

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

From report at bugs.python.org  Wed Feb 28 12:59:16 2018
From: report at bugs.python.org (NODA, Kai)
Date: Wed, 28 Feb 2018 17:59:16 +0000
Subject: [docs] [issue32971] Docs on unittest.TestCase.assertRaises() should
 be improved
In-Reply-To: <1519840682.18.0.467229070634.issue32971@psf.upfronthosting.co.za>
Message-ID: <1519840756.48.0.714561066657.issue32971@psf.upfronthosting.co.za>


Change by NODA, Kai <nodakai at gmail.com>:


----------
title: unittest.TestCase.assertRaises -> Docs on unittest.TestCase.assertRaises() should be improved

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

From report at bugs.python.org  Wed Feb 28 13:02:20 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 28 Feb 2018 18:02:20 +0000
Subject: [docs] [issue32971] Docs on unittest.TestCase.assertRaises() should
 be improved
In-Reply-To: <1519840682.18.0.467229070634.issue32971@psf.upfronthosting.co.za>
Message-ID: <1519840940.61.0.714561066657.issue32971@psf.upfronthosting.co.za>


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


----------
nosy: +ezio.melotti

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

From report at bugs.python.org  Wed Feb 28 19:11:02 2018
From: report at bugs.python.org (Brett Cannon)
Date: Thu, 01 Mar 2018 00:11:02 +0000
Subject: [docs] [issue32963] Python 2.7 tutorial claims source code is UTF-8
 encoded
In-Reply-To: <1519722263.23.0.467229070634.issue32963@psf.upfronthosting.co.za>
Message-ID: <1519863062.43.0.467229070634.issue32963@psf.upfronthosting.co.za>


Brett Cannon <brett at python.org> added the comment:

https://docs.python.org/2.7/tutorial/interpreter.html#source-code-encoding if people are looking for the doc link.

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

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

From report at bugs.python.org  Wed Feb 28 21:19:37 2018
From: report at bugs.python.org (Jay Crotts)
Date: Thu, 01 Mar 2018 02:19: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: <1519870777.31.0.714561066657.issue8243@psf.upfronthosting.co.za>


Change by Jay Crotts <crotts.jay at gmail.com>:


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

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