From report at bugs.python.org  Thu Nov  1 03:16:51 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Thu, 01 Nov 2018 07:16:51 +0000
Subject: [docs] [issue35126] Mistake in FAQ about converting number to
 string.
In-Reply-To: <1541005659.07.0.788709270274.issue35126@psf.upfronthosting.co.za>
Message-ID: <1541056611.76.0.702299269573.issue35126@psf.upfronthosting.co.za>


Change by Karthikeyan Singaravelan <tir.karthi at gmail.com>:


----------
nosy: +xtreak

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

From report at bugs.python.org  Thu Nov  1 03:45:34 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Thu, 01 Nov 2018 07:45:34 +0000
Subject: [docs] [issue35114] ssl.RAND_status docs describe it as returning
 True/False; actually returns 1/0
In-Reply-To: <1540906817.06.0.788709270274.issue35114@psf.upfronthosting.co.za>
Message-ID: <1541058334.25.0.702299269573.issue35114@psf.upfronthosting.co.za>


Change by Karthikeyan Singaravelan <tir.karthi at gmail.com>:


----------
nosy: +xtreak

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

From report at bugs.python.org  Thu Nov  1 08:29:44 2018
From: report at bugs.python.org (miss-islington)
Date: Thu, 01 Nov 2018 12:29:44 +0000
Subject: [docs] [issue35075] Doc: pprint example uses dead URL
In-Reply-To: <1540539643.28.0.788709270274.issue35075@psf.upfronthosting.co.za>
Message-ID: <1541075384.16.0.788709270274.issue35075@psf.upfronthosting.co.za>


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


New changeset bf46a09dec372b85846216bd692d648dac08ac36 by Miss Islington (bot) (Pablo Galindo) in branch 'master':
bpo-35075: Fix broken url in the pprint documentation (GH-10201)
https://github.com/python/cpython/commit/bf46a09dec372b85846216bd692d648dac08ac36


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

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

From report at bugs.python.org  Thu Nov  1 08:29:48 2018
From: report at bugs.python.org (miss-islington)
Date: Thu, 01 Nov 2018 12:29:48 +0000
Subject: [docs] [issue35075] Doc: pprint example uses dead URL
In-Reply-To: <1540539643.28.0.788709270274.issue35075@psf.upfronthosting.co.za>
Message-ID: <1541075388.48.0.702299269573.issue35075@psf.upfronthosting.co.za>


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


----------
pull_requests: +9593

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

From report at bugs.python.org  Thu Nov  1 08:29:55 2018
From: report at bugs.python.org (miss-islington)
Date: Thu, 01 Nov 2018 12:29:55 +0000
Subject: [docs] [issue35075] Doc: pprint example uses dead URL
In-Reply-To: <1540539643.28.0.788709270274.issue35075@psf.upfronthosting.co.za>
Message-ID: <1541075395.18.0.702299269573.issue35075@psf.upfronthosting.co.za>


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


----------
pull_requests: +9594

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

From report at bugs.python.org  Thu Nov  1 09:37:33 2018
From: report at bugs.python.org (miss-islington)
Date: Thu, 01 Nov 2018 13:37:33 +0000
Subject: [docs] [issue35075] Doc: pprint example uses dead URL
In-Reply-To: <1540539643.28.0.788709270274.issue35075@psf.upfronthosting.co.za>
Message-ID: <1541079453.22.0.788709270274.issue35075@psf.upfronthosting.co.za>


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


New changeset 7344b9fa0ef7bd8b902e7aa9a8f74b5dce915e59 by Miss Islington (bot) in branch '3.6':
bpo-35075: Fix broken url in the pprint documentation (GH-10201)
https://github.com/python/cpython/commit/7344b9fa0ef7bd8b902e7aa9a8f74b5dce915e59


----------

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

From report at bugs.python.org  Thu Nov  1 10:09:14 2018
From: report at bugs.python.org (Pedro)
Date: Thu, 01 Nov 2018 14:09:14 +0000
Subject: [docs] [issue35135] pip install --download option does not exist
Message-ID: <1541081354.04.0.788709270274.issue35135@psf.upfronthosting.co.za>


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

https://pip.pypa.io/en/stable/user_guide/#installing-from-local-packages states that you can use a --directory option with the install subcommand. This fails with pip 18.1 on both Python 2.7 on SLES12 and Python 3.6 on Windows 10:

==========

pip install --download my_dir -r reqs.txt

Usage:
  pip install [options] <requirement specifier> [package-index-options] ...
  pip install [options] -r <requirements file> [package-index-options] ...
  pip install [options] [-e] <vcs project url> ...
  pip install [options] [-e] <local project path> ...
  pip install [options] <archive url/path> ...

no such option: --download

----------
assignee: docs at python
components: Documentation
messages: 329069
nosy: docs at python, pgacv2
priority: normal
severity: normal
status: open
title: pip install --download option does not exist
type: behavior
versions: Python 2.7, Python 3.6

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

From report at bugs.python.org  Thu Nov  1 10:25:47 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Thu, 01 Nov 2018 14:25:47 +0000
Subject: [docs] [issue35135] pip install --download option does not exist
In-Reply-To: <1541081354.04.0.788709270274.issue35135@psf.upfronthosting.co.za>
Message-ID: <1541082347.56.0.788709270274.issue35135@psf.upfronthosting.co.za>


Karthikeyan Singaravelan <tir.karthi at gmail.com> added the comment:

Thanks for the report. The issue tracker deals with reports for CPython and issues related to pip are not maintained here. Please file a doc issue at https://github.com/pypa/pip/ . `--download` was deprecated with https://github.com/pypa/pip/pull/3085 and PR reports it's for removal with pip 10. Usage of `pip download` as a toplevel command is encouraged and can be used.

Relevant doc needs to be updated at https://github.com/pypa/pip/blob/master/docs/html/user_guide.rst.


Thanks

----------
nosy: +xtreak

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

From report at bugs.python.org  Thu Nov  1 10:29:06 2018
From: report at bugs.python.org (Zachary Ware)
Date: Thu, 01 Nov 2018 14:29:06 +0000
Subject: [docs] [issue35135] pip install --download option does not exist
In-Reply-To: <1541081354.04.0.788709270274.issue35135@psf.upfronthosting.co.za>
Message-ID: <1541082546.49.0.702299269573.issue35135@psf.upfronthosting.co.za>


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


----------
assignee: docs at python -> 
resolution:  -> third party
stage:  -> resolved
status: open -> closed
type: behavior -> 

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

From report at bugs.python.org  Thu Nov  1 10:38:14 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Thu, 01 Nov 2018 14:38:14 +0000
Subject: [docs] [issue35135] pip install --download option does not exist
In-Reply-To: <1541081354.04.0.788709270274.issue35135@psf.upfronthosting.co.za>
Message-ID: <1541083094.28.0.788709270274.issue35135@psf.upfronthosting.co.za>


Karthikeyan Singaravelan <tir.karthi at gmail.com> added the comment:

FYI created an issue at https://github.com/pypa/pip/issues/5976

Thanks!

----------
assignee:  -> docs at python
resolution: third party -> 
stage: resolved -> 
status: closed -> open
type:  -> behavior

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

From report at bugs.python.org  Thu Nov  1 10:39:04 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Thu, 01 Nov 2018 14:39:04 +0000
Subject: [docs] [issue35135] pip install --download option does not exist
In-Reply-To: <1541081354.04.0.788709270274.issue35135@psf.upfronthosting.co.za>
Message-ID: <1541083144.53.0.788709270274.issue35135@psf.upfronthosting.co.za>


Karthikeyan Singaravelan <tir.karthi at gmail.com> added the comment:

Sorry, my comment reopened the bug :(

----------
resolution:  -> third party
stage:  -> resolved
status: open -> closed

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

From report at bugs.python.org  Thu Nov  1 12:45:34 2018
From: report at bugs.python.org (davidak)
Date: Thu, 01 Nov 2018 16:45:34 +0000
Subject: [docs] [issue35138] timeit documentation should have example with
 function arguments
Message-ID: <1541090734.49.0.788709270274.issue35138@psf.upfronthosting.co.za>


New submission from davidak <bugs.python.org+xdnb at davidak.de>:

It is described here: https://www.pythoncentral.io/time-a-python-function/

I have just tested it. Works as expected.

Best would be if timeit supports this natively.

----------
assignee: docs at python
components: Documentation
messages: 329079
nosy: davidak, docs at python
priority: normal
severity: normal
status: open
title: timeit documentation should have example with function arguments
versions: Python 3.6, Python 3.7

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

From report at bugs.python.org  Thu Nov  1 13:12:45 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 01 Nov 2018 17:12:45 +0000
Subject: [docs] [issue35138] timeit documentation should have example with
 function arguments
In-Reply-To: <1541090734.49.0.788709270274.issue35138@psf.upfronthosting.co.za>
Message-ID: <1541092365.72.0.702299269573.issue35138@psf.upfronthosting.co.za>


Change by Serhiy Storchaka <storchaka+cpython 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/issue35138>
_______________________________________

From report at bugs.python.org  Thu Nov  1 14:16:46 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Thu, 01 Nov 2018 18:16:46 +0000
Subject: [docs] [issue35138] timeit documentation should have example with
 function arguments
In-Reply-To: <1541090734.49.0.788709270274.issue35138@psf.upfronthosting.co.za>
Message-ID: <1541096206.54.0.788709270274.issue35138@psf.upfronthosting.co.za>


Karthikeyan Singaravelan <tir.karthi at gmail.com> added the comment:

There is an open PR that adds a similar example. Is it the same as the one you are proposing and I think you can add a review comment to add it with the same PR if it's different?

PR : https://github.com/python/cpython/pull/9787

Thanks

----------
nosy: +xtreak

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

From report at bugs.python.org  Thu Nov  1 14:42:49 2018
From: report at bugs.python.org (davidak)
Date: Thu, 01 Nov 2018 18:42:49 +0000
Subject: [docs] [issue35138] timeit documentation should have example with
 function arguments
In-Reply-To: <1541090734.49.0.788709270274.issue35138@psf.upfronthosting.co.za>
Message-ID: <1541097769.59.0.702299269573.issue35138@psf.upfronthosting.co.za>


Change by davidak <bugs.python.org+xdnb at davidak.de>:


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

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

From report at bugs.python.org  Thu Nov  1 17:33:57 2018
From: report at bugs.python.org (miss-islington)
Date: Thu, 01 Nov 2018 21:33:57 +0000
Subject: [docs] [issue35075] Doc: pprint example uses dead URL
In-Reply-To: <1540539643.28.0.788709270274.issue35075@psf.upfronthosting.co.za>
Message-ID: <1541108037.25.0.788709270274.issue35075@psf.upfronthosting.co.za>


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


New changeset 7d35553138d8b2799ae68601ce836a3647509718 by Miss Islington (bot) in branch '3.7':
bpo-35075: Fix broken url in the pprint documentation (GH-10201)
https://github.com/python/cpython/commit/7d35553138d8b2799ae68601ce836a3647509718


----------

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

From report at bugs.python.org  Fri Nov  2 02:03:03 2018
From: report at bugs.python.org (INADA Naoki)
Date: Fri, 02 Nov 2018 06:03:03 +0000
Subject: [docs] [issue35075] Doc: pprint example uses dead URL
In-Reply-To: <1540539643.28.0.788709270274.issue35075@psf.upfronthosting.co.za>
Message-ID: <1541138583.05.0.702299269573.issue35075@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/issue35075>
_______________________________________

From report at bugs.python.org  Fri Nov  2 07:25:06 2018
From: report at bugs.python.org (Dave Shawley)
Date: Fri, 02 Nov 2018 11:25:06 +0000
Subject: [docs] [issue32971] Docs on unittest.TestCase.assertRaises() should
 clarify context manager details
In-Reply-To: <1519840682.18.0.467229070634.issue32971@psf.upfronthosting.co.za>
Message-ID: <1541157906.34.0.702299269573.issue32971@psf.upfronthosting.co.za>


Change by Dave Shawley <daveshawley at gmail.com>:


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

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

From report at bugs.python.org  Fri Nov  2 11:20:26 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Fri, 02 Nov 2018 15:20:26 +0000
Subject: [docs] [issue29341] Missing accepting path-like object in
 docstrings of os module functions
In-Reply-To: <1485064061.59.0.597221589705.issue29341@psf.upfronthosting.co.za>
Message-ID: <1541172026.07.0.788709270274.issue29341@psf.upfronthosting.co.za>


Pablo Galindo Salgado <pablogsal at gmail.com> added the comment:


New changeset b942707fc23454a998323c17e30be78ff1a4f0e7 by Pablo Galindo (BNMetrics) in branch 'master':
bpo-29341: Clarify that path-like objects are accepted in some os methods (GH-10101)
https://github.com/python/cpython/commit/b942707fc23454a998323c17e30be78ff1a4f0e7


----------
nosy: +pablogsal

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

From report at bugs.python.org  Fri Nov  2 11:45:12 2018
From: report at bugs.python.org (Luna Chen)
Date: Fri, 02 Nov 2018 15:45:12 +0000
Subject: [docs] [issue29341] Missing accepting path-like object in
 docstrings of os module functions
In-Reply-To: <1485064061.59.0.597221589705.issue29341@psf.upfronthosting.co.za>
Message-ID: <1541173512.82.0.702299269573.issue29341@psf.upfronthosting.co.za>


Change by Luna Chen <luna at bnmetrics.com>:


----------
pull_requests: +9607

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

From report at bugs.python.org  Fri Nov  2 11:58:23 2018
From: report at bugs.python.org (Luna Chen)
Date: Fri, 02 Nov 2018 15:58:23 +0000
Subject: [docs] [issue29341] Missing accepting path-like object in
 docstrings of os module functions
In-Reply-To: <1485064061.59.0.597221589705.issue29341@psf.upfronthosting.co.za>
Message-ID: <1541174303.58.0.702299269573.issue29341@psf.upfronthosting.co.za>


Change by Luna Chen <luna at bnmetrics.com>:


----------
pull_requests: +9608

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

From report at bugs.python.org  Fri Nov  2 13:55:45 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Fri, 02 Nov 2018 17:55:45 +0000
Subject: [docs] [issue29341] Missing accepting path-like object in
 docstrings of os module functions
In-Reply-To: <1485064061.59.0.597221589705.issue29341@psf.upfronthosting.co.za>
Message-ID: <1541181345.24.0.788709270274.issue29341@psf.upfronthosting.co.za>


Pablo Galindo Salgado <pablogsal at gmail.com> added the comment:


New changeset 8d2f88fb17468642813108977bb9ec5f7a065b84 by Pablo Galindo (BNMetrics) in branch '3.6':
[3.6]bpo-29341: Backport b942707 3.6 (GH-10299)
https://github.com/python/cpython/commit/8d2f88fb17468642813108977bb9ec5f7a065b84


----------

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

From report at bugs.python.org  Fri Nov  2 13:56:29 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Fri, 02 Nov 2018 17:56:29 +0000
Subject: [docs] [issue29341] Missing accepting path-like object in
 docstrings of os module functions
In-Reply-To: <1485064061.59.0.597221589705.issue29341@psf.upfronthosting.co.za>
Message-ID: <1541181389.16.0.788709270274.issue29341@psf.upfronthosting.co.za>


Pablo Galindo Salgado <pablogsal at gmail.com> added the comment:


New changeset 08026b103ea8f4c9f2b5045ef7806dd8b760da2b by Pablo Galindo (BNMetrics) in branch '3.7':
[3.7]bpo-29341: Backport b942707 3.7 (#10298)
https://github.com/python/cpython/commit/08026b103ea8f4c9f2b5045ef7806dd8b760da2b


----------

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

From report at bugs.python.org  Fri Nov  2 13:57:30 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Fri, 02 Nov 2018 17:57:30 +0000
Subject: [docs] [issue29341] Missing accepting path-like object in
 docstrings of os module functions
In-Reply-To: <1485064061.59.0.597221589705.issue29341@psf.upfronthosting.co.za>
Message-ID: <1541181450.64.0.788709270274.issue29341@psf.upfronthosting.co.za>


Pablo Galindo Salgado <pablogsal at gmail.com> added the comment:

The docstrings are fixed and the m(anual!) backports to 3.7 and 3.6 are done. Very good job, Luna!

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

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

From report at bugs.python.org  Fri Nov  2 13:57:52 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Fri, 02 Nov 2018 17:57:52 +0000
Subject: [docs] [issue29341] Missing accepting path-like object in
 docstrings of os module functions
In-Reply-To: <1485064061.59.0.597221589705.issue29341@psf.upfronthosting.co.za>
Message-ID: <1541181472.68.0.702299269573.issue29341@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Nov  2 13:58:00 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Fri, 02 Nov 2018 17:58:00 +0000
Subject: [docs] [issue29341] Missing accepting path-like object in
 docstrings of os module functions
In-Reply-To: <1485064061.59.0.597221589705.issue29341@psf.upfronthosting.co.za>
Message-ID: <1541181480.89.0.788709270274.issue29341@psf.upfronthosting.co.za>


Pablo Galindo Salgado <pablogsal at gmail.com> added the comment:

The docstrings are fixed and the (manual!) backports to 3.7 and 3.6 are done. Very good job, Luna!

----------

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

From report at bugs.python.org  Fri Nov  2 14:08:52 2018
From: report at bugs.python.org (Robert Henry)
Date: Fri, 02 Nov 2018 18:08:52 +0000
Subject: [docs] [issue35150] Misc/README.valgrind out-of-date
Message-ID: <1541182132.22.0.788709270274.issue35150@psf.upfronthosting.co.za>


New submission from Robert Henry <rrh.henry at gmail.com>:

File Misc/README.valgrind is out of date with respect to python3.8.  There are important sections of this file that are 15 years old!

Example: the README.valgrind refers to "Uncomment Py_USING_MEMORY_DEBUGGER in Objects/obmalloc.c" but there's no such symbol in obmalloc.c (There is in Python/dtoa.c)

I have no idea if the valgrind suppression file Misc/valgrind-python.supp is up to date, but it bears examination by an expert.

----------
assignee: docs at python
components: Documentation
messages: 329151
nosy: docs at python, rrh
priority: normal
severity: normal
status: open
title: Misc/README.valgrind out-of-date
versions: Python 3.8

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

From report at bugs.python.org  Fri Nov  2 16:22:01 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 02 Nov 2018 20:22:01 +0000
Subject: [docs] [issue35105] Document that CPython accepts "invalid"
 identifiers
In-Reply-To: <1540815891.13.0.788709270274.issue35105@psf.upfronthosting.co.za>
Message-ID: <1541190121.62.0.788709270274.issue35105@psf.upfronthosting.co.za>


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

It is an implementation detail that some people need to know, and that is very unlikely to change.  In the pydev thread, Guido said
"
My feeling is that limiting it to strings is fine, but checking those
strings for resembling identifiers is pointless and wasteful."

We occasionally document such things in a 'CPython implementation detail' note.  I don't know the proper markup for these.  At present, I think the note should be in setattr and **kwargs docs.

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

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

From report at bugs.python.org  Fri Nov  2 18:15:45 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Fri, 02 Nov 2018 22:15:45 +0000
Subject: [docs] [issue35150] Misc/README.valgrind out-of-date
In-Reply-To: <1541182132.22.0.788709270274.issue35150@psf.upfronthosting.co.za>
Message-ID: <1541196945.77.0.788709270274.issue35150@psf.upfronthosting.co.za>


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

Thank you for the report.  Closing as a duplicate of issue32666.

----------
nosy: +cheryl.sabella
resolution:  -> duplicate
stage:  -> resolved
status: open -> closed
superseder:  -> Valgrind documentation seems to need updating

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

From report at bugs.python.org  Fri Nov  2 18:31:51 2018
From: report at bugs.python.org (STINNER Victor)
Date: Fri, 02 Nov 2018 22:31:51 +0000
Subject: [docs] [issue32666] Valgrind documentation seems to need updating
In-Reply-To: <1516886985.24.0.467229070634.issue32666@psf.upfronthosting.co.za>
Message-ID: <1541197911.17.0.788709270274.issue32666@psf.upfronthosting.co.za>


STINNER Victor <vstinner at redhat.com> added the comment:

You may want to use PYTHONMALLOC=malloc environment variable, which changes the memory allocator from Python pymalloc to the regular libc malloc(). Valgrind false alarms come from pymalloc.

----------
nosy: +vstinner

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

From report at bugs.python.org  Fri Nov  2 18:51:57 2018
From: report at bugs.python.org (STINNER Victor)
Date: Fri, 02 Nov 2018 22:51:57 +0000
Subject: [docs] [issue35105] Document that CPython accepts "invalid"
 identifiers
In-Reply-To: <1540815891.13.0.788709270274.issue35105@psf.upfronthosting.co.za>
Message-ID: <1541199117.32.0.788709270274.issue35105@psf.upfronthosting.co.za>


STINNER Victor <vstinner at redhat.com> added the comment:

> I don't know the proper markup for these.

It's ".. impl-detail::". See for example:
https://docs.python.org/dev/library/codecs.html#standard-encodings

----------

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

From report at bugs.python.org  Fri Nov  2 20:20:18 2018
From: report at bugs.python.org (Joshua Honeycutt)
Date: Sat, 03 Nov 2018 00:20:18 +0000
Subject: [docs] [issue35151] Python 2 xml.etree.ElementTree documentation
 tutorial uses undocumented arguments
Message-ID: <1541204418.39.0.788709270274.issue35151@psf.upfronthosting.co.za>


New submission from Joshua Honeycutt <joshua.honeycutt at gmail.com>:

In python 2 documentation 19.7.1.6
(https://docs.python.org/2/library/xml.etree.elementtree.html#parsing-xml-with-namespaces)
a second argument (ns) is passed to find and findall.

However 19.7.3.2 
(https://docs.python.org/2/library/xml.etree.elementtree.html#xml.etree.ElementTree.Element.find)
only specifies the single match argument.

If we compare the python 3 documentation the namespaces argument is included in the find method. (https://docs.python.org/3/library/xml.etree.elementtree.html#xml.etree.ElementTree.Element.find)

Maybe the tutorial was created for python 3 version? I assume the function arguments are automatically generated, but I have not tested or tried these functions in python 2. I just stumbled on the docs while working with python 3.

----------
assignee: docs at python
components: Documentation
messages: 329174
nosy: docs at python, epakai
priority: normal
severity: normal
status: open
title: Python 2 xml.etree.ElementTree documentation tutorial uses undocumented arguments
versions: Python 2.7

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

From report at bugs.python.org  Sat Nov  3 03:07:33 2018
From: report at bugs.python.org (Reuben Thomas)
Date: Sat, 03 Nov 2018 07:07:33 +0000
Subject: [docs] [issue32666] Valgrind documentation seems to need updating
In-Reply-To: <1516886985.24.0.467229070634.issue32666@psf.upfronthosting.co.za>
Message-ID: <1541228853.82.0.788709270274.issue32666@psf.upfronthosting.co.za>


Reuben Thomas <rrt at sc3d.org> added the comment:

Victor, thanks; that's precisely the sort of thing that would make a useful addition to the docs.

----------

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

From report at bugs.python.org  Sat Nov  3 07:58:18 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Sat, 03 Nov 2018 11:58:18 +0000
Subject: [docs] [issue35032] Remove the videos from faq/Windows
In-Reply-To: <1540045855.07.0.788709270274.issue35032@psf.upfronthosting.co.za>
Message-ID: <1541246298.23.0.788709270274.issue35032@psf.upfronthosting.co.za>


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

I close this issue because all the PR and backports (3.7, 3.6 & 2.7) are merged.

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

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

From report at bugs.python.org  Sat Nov  3 08:22:28 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Sat, 03 Nov 2018 12:22:28 +0000
Subject: [docs] [issue35109] Doctest in CI uses python binary built from
 master causing DeprecationWarnings
In-Reply-To: <1540888465.31.0.788709270274.issue35109@psf.upfronthosting.co.za>
Message-ID: <1541247748.39.0.788709270274.issue35109@psf.upfronthosting.co.za>


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

I think we could close this issue because the DeprecationWarnings are not related to Python itself but to the dependencies.

We could open an issue about the DeprecationWarnings and the dependency like python-babel (thanks for the issue).

@mdk? Can we close this issue?

----------

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

From report at bugs.python.org  Sat Nov  3 11:16:40 2018
From: report at bugs.python.org (Julien Palard)
Date: Sat, 03 Nov 2018 15:16:40 +0000
Subject: [docs] [issue35109] Doctest in CI uses python binary built from
 master causing DeprecationWarnings
In-Reply-To: <1540888465.31.0.788709270274.issue35109@psf.upfronthosting.co.za>
Message-ID: <1541258200.52.0.788709270274.issue35109@psf.upfronthosting.co.za>


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

Yes we can close it. Also -W from sphinx-build won't cause errors from those warnings.

Yes we'll probably suffer a bit if someone push the final step of a deprecation if one of our build dependencies is still using it.

----------
resolution:  -> third party
stage:  -> resolved
status: open -> closed

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

From report at bugs.python.org  Sat Nov  3 17:31:25 2018
From: report at bugs.python.org (Ned Batchelder)
Date: Sat, 03 Nov 2018 21:31:25 +0000
Subject: [docs] [issue35105] Document that CPython accepts "invalid"
 identifiers
In-Reply-To: <1540815891.13.0.788709270274.issue35105@psf.upfronthosting.co.za>
Message-ID: <1541280685.48.0.788709270274.issue35105@psf.upfronthosting.co.za>


Ned Batchelder <ned at nedbatchelder.com> added the comment:

This seems like a confusion of two things: identifiers are lexical elements of the language.  Attributes are not limited to identifiers.

We could add to the docs for setattr: "The attribute name does not have to be a valid identifier."   I don't know what the language guarantees about what strings are valid as attribute names.

----------
nosy: +nedbat

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

From report at bugs.python.org  Sat Nov  3 17:49:15 2018
From: report at bugs.python.org (Chris Jerdonek)
Date: Sat, 03 Nov 2018 21:49:15 +0000
Subject: [docs] [issue35105] Document that CPython accepts "invalid"
 identifiers
In-Reply-To: <1540815891.13.0.788709270274.issue35105@psf.upfronthosting.co.za>
Message-ID: <1541281755.26.0.788709270274.issue35105@psf.upfronthosting.co.za>


Chris Jerdonek <chris.jerdonek at gmail.com> added the comment:

> In the pydev thread, Guido said "My feeling is that limiting it to strings is fine, but checking those strings for resembling identifiers is pointless and wasteful."

But in a later message, after additional discussion, he acknowledged there could be reasons to change and said, "we needn't rush this."

So if the docs do describe the current implementation, I think it should warn people that this behavior might not be subject to the same backwards compatibility guarantees as other documented behavior.

----------
nosy: +chris.jerdonek

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

From report at bugs.python.org  Sat Nov  3 19:11:13 2018
From: report at bugs.python.org (Denton Liu)
Date: Sat, 03 Nov 2018 23:11:13 +0000
Subject: [docs] [issue35155] Clarify Protocol Handlers in urllib.request Docs
Message-ID: <1541286673.86.0.788709270274.issue35155@psf.upfronthosting.co.za>


New submission from Denton Liu <liu.denton at gmail.com>:

The urllib.request documentation that they can add their own protocol handlers, however they are unclear on how they should be named. We should replace instances of things like protocol_request with <protocol>_request to make it clear that we are literally replacing "protocol" with the literal protocol.

I am creating this issue because I had to actually read the urllib.request source code in order to figure out how to use the protocol handler APIs.

----------
assignee: docs at python
components: Documentation
messages: 329210
nosy: Denton-L, docs at python
priority: normal
severity: normal
status: open
title: Clarify Protocol Handlers in urllib.request Docs
type: enhancement
versions: Python 3.4, Python 3.5, Python 3.6, Python 3.7, Python 3.8

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

From report at bugs.python.org  Sat Nov  3 19:12:47 2018
From: report at bugs.python.org (Denton Liu)
Date: Sat, 03 Nov 2018 23:12:47 +0000
Subject: [docs] [issue35155] Clarify Protocol Handlers in urllib.request Docs
In-Reply-To: <1541286673.86.0.788709270274.issue35155@psf.upfronthosting.co.za>
Message-ID: <1541286767.27.0.702299269573.issue35155@psf.upfronthosting.co.za>


Change by Denton Liu <liu.denton at gmail.com>:


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

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

From report at bugs.python.org  Sat Nov  3 19:34:29 2018
From: report at bugs.python.org (Jorge Ramos)
Date: Sat, 03 Nov 2018 23:34:29 +0000
Subject: [docs] [issue35156] Consider revising documentation on Python
 Builds from source
Message-ID: <1541288069.11.0.788709270274.issue35156@psf.upfronthosting.co.za>


New submission from Jorge Ramos <neyuru at gmail.com>:

I want to build from source a 3.6 Python, using PGO for windows.

Followed instructions at https://devguide.python.org/setup/ (the original search from google was "build python from source windows"). From a newbie perspective there are several problems:

1) it is suggested that you should build first a "debug" python (header 1.3) but they don't tell you how.
2) it is suggested that you should first build via "PCBuild\build.bat" but they don't tell you that this builds a win32 platform. What if I want to build a x64 version? (lost much time here figuring out how)
3) I ran into problems when building with "PCBuild\build.bat" (header 1.3.2) because the dependencies where not all downloaded in the first pass (but this is a bug I could fill later). Lost much time here figuring why the build did not succeed.
4) in (1.3.2) it is suggested you keep reading in a readme file: https://github.com/python/cpython/blob/master/PCbuild/readme.txt This is the first time an optimization is mentioned (other than simply compiling from your machine. I did not know that using PGO was mandatory for real speedups compared to the downloadable ?general? binaries).
5) In this very same readme, it says that there are other "subprojects" that you need to consider building with Python. Lost much time here trying to figure out that these subprojects are downloaded via "get_externals.bat" in the "Getting External Sources" section. Why not simply put the "Getting External Sources" section first and avoid worrying the newcomer of potential projects that are "not included with python"?
6) They tell you that PGO is automated via a "build_pgo.bat" file. But this does not exist. 
7) They tell you that first, you have to run the PGInstrument option in the build, but it is not clear what should be run next: PCBuild\build.bat -c PGUpdate -p x64" or "PCBuild\build.bat --pgo -p x64"
8) After 2 days of trying to build (and learn in the process by trial and error) I stumble upon YET ANOTHER WAY TO BUILD: the one found in "cpython\Tools\msi" NOT the first one: "cpython\PCbuild"

And this is the one I was interested in the first place: building an installable version of python (yet I have to figure out how to pack all cab files and such into one exe), not a developer?s python for testing. And after now 3 days with this, I noticed that all previous testing and building techniques are indeed reachable from "cpython\Tools\msi\buildrelease.bat -x64" which tries to build a python in x64 version AND using GPO (by default -in the x64 but not in the win32-, which is not mentioned in the documentation, by the way) also generating the dependencies required (I could have avoided losing some time if knowing this from the very beginning- see point 5)

As you can see, I lost few hours here, few there. And because I am not a developer (my intention is to have an optimized python for my PC for AI research) I lost much time trying to figure out things that are not explicitly said in the documentation: I managed to learn from other sources (googling around), by careful observation of the compilation results, and digging into the help section of each of the files used.
Hope I successfully communicated Python?s lack of proper documentation (just for the case of building from source!)

----------
assignee: docs at python
components: Documentation
messages: 329211
nosy: docs at python, neyuru
priority: normal
severity: normal
status: open
title: Consider revising documentation on Python Builds from source
type: enhancement
versions: Python 3.6

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

From report at bugs.python.org  Sat Nov  3 22:20:13 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 04 Nov 2018 02:20:13 +0000
Subject: [docs] [issue35105] Document that CPython accepts "invalid"
 identifiers
In-Reply-To: <1540815891.13.0.788709270274.issue35105@psf.upfronthosting.co.za>
Message-ID: <1541298013.49.0.788709270274.issue35105@psf.upfronthosting.co.za>


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

Documenting something as an 'implementation detail' denies that it is a language feature and does not offer stability guarantees.

----------

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

From report at bugs.python.org  Sun Nov  4 00:14:30 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Sun, 04 Nov 2018 04:14:30 +0000
Subject: [docs] [issue35156] Consider revising documentation on Python
 Builds from source
In-Reply-To: <1541288069.11.0.788709270274.issue35156@psf.upfronthosting.co.za>
Message-ID: <1541304870.47.0.702299269573.issue35156@psf.upfronthosting.co.za>


Change by Karthikeyan Singaravelan <tir.karthi at gmail.com>:


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

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

From report at bugs.python.org  Sun Nov  4 02:57:09 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Sun, 04 Nov 2018 07:57:09 +0000
Subject: [docs] [issue35159] Add a link to the devguide in the sidebar of
 the documentation
Message-ID: <1541318229.4.0.788709270274.issue35159@psf.upfronthosting.co.za>


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

I think a link to the devguide could be useful for a future contributor and the right place could be the sidebar in the index page.

----------
assignee: docs at python
components: Documentation
messages: 329219
nosy: docs at python, matrixise
priority: normal
severity: normal
status: open
title: Add a link to the devguide in the sidebar of the documentation

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

From report at bugs.python.org  Sun Nov  4 02:58:17 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Sun, 04 Nov 2018 07:58:17 +0000
Subject: [docs] [issue35159] Add a link to the devguide in the sidebar of
 the documentation
In-Reply-To: <1541318229.4.0.788709270274.issue35159@psf.upfronthosting.co.za>
Message-ID: <1541318297.17.0.702299269573.issue35159@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sun Nov  4 03:02:08 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Sun, 04 Nov 2018 08:02:08 +0000
Subject: [docs] [issue35159] Add a link to the devguide in the sidebar of
 the documentation
In-Reply-To: <1541318229.4.0.788709270274.issue35159@psf.upfronthosting.co.za>
Message-ID: <1541318528.04.0.702299269573.issue35159@psf.upfronthosting.co.za>


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


----------
nosy: +mdk

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

From report at bugs.python.org  Sun Nov  4 03:02:15 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Sun, 04 Nov 2018 08:02:15 +0000
Subject: [docs] [issue35159] Add a link to the devguide in the sidebar of
 the documentation
In-Reply-To: <1541318229.4.0.788709270274.issue35159@psf.upfronthosting.co.za>
Message-ID: <1541318535.99.0.702299269573.issue35159@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sun Nov  4 09:51:19 2018
From: report at bugs.python.org (Julien Palard)
Date: Sun, 04 Nov 2018 14:51:19 +0000
Subject: [docs] [issue33275] glob.glob should explicitly note that results
 aren't sorted
In-Reply-To: <1523644726.46.0.682650639539.issue33275@psf.upfronthosting.co.za>
Message-ID: <1541343079.55.0.702299269573.issue33275@psf.upfronthosting.co.za>


Change by Julien Palard <julien+python at palard.fr>:


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

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

From report at bugs.python.org  Sun Nov  4 12:19:15 2018
From: report at bugs.python.org (Denis Osipov)
Date: Sun, 04 Nov 2018 17:19:15 +0000
Subject: [docs] [issue35119] Customizing module attribute access example
 raises RecursionError
In-Reply-To: <1540959974.35.0.788709270274.issue35119@psf.upfronthosting.co.za>
Message-ID: <1541351955.72.0.788709270274.issue35119@psf.upfronthosting.co.za>


Denis Osipov <osipov_d at list.ru> added the comment:

I understand that it's expected behavior. But why don't use completely working example in the docs, which one could just copy and paste? It requires to add just seven chars)

----------

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

From report at bugs.python.org  Sun Nov  4 12:40:10 2018
From: report at bugs.python.org (Ivan Levkivskyi)
Date: Sun, 04 Nov 2018 17:40:10 +0000
Subject: [docs] [issue35119] Customizing module attribute access example
 raises RecursionError
In-Reply-To: <1540959974.35.0.788709270274.issue35119@psf.upfronthosting.co.za>
Message-ID: <1541353210.6.0.788709270274.issue35119@psf.upfronthosting.co.za>


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

Ah, sorry, I didn't understand this was a documentation issue. Please feel free to submit a PR that fixes the example to use `super().__setattr__()`.

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

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

From report at bugs.python.org  Sun Nov  4 12:43:20 2018
From: report at bugs.python.org (Denis Osipov)
Date: Sun, 04 Nov 2018 17:43:20 +0000
Subject: [docs] [issue35165] Possible wrong method name in attribute
 references doc
Message-ID: <1541353400.8.0.788709270274.issue35165@psf.upfronthosting.co.za>


New submission from Denis Osipov <osipov_d at list.ru>:

6.3.1. Attribute references says:

"The primary must evaluate to an object of a type that supports attribute references, which most objects do. This object is then asked to produce the attribute whose name is the identifier. This production can be customized by overriding the __getattr__() method. If this attribute is not available, the exception AttributeError is raised."

It seems that __getattribute__ method is meaning.

----------
assignee: docs at python
components: Documentation
messages: 329245
nosy: denis-osipov, docs at python
priority: normal
severity: normal
status: open
title: Possible wrong method name in attribute references doc
type: behavior
versions: Python 3.4, Python 3.5, Python 3.6, Python 3.7, Python 3.8

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

From report at bugs.python.org  Sun Nov  4 14:16:55 2018
From: report at bugs.python.org (Denis Osipov)
Date: Sun, 04 Nov 2018 19:16:55 +0000
Subject: [docs] [issue35119] Customizing module attribute access example
 raises RecursionError
In-Reply-To: <1540959974.35.0.788709270274.issue35119@psf.upfronthosting.co.za>
Message-ID: <1541359015.04.0.702299269573.issue35119@psf.upfronthosting.co.za>


Change by Denis Osipov <osipov_d at list.ru>:


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

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

From report at bugs.python.org  Sun Nov  4 14:47:23 2018
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Sun, 04 Nov 2018 19:47:23 +0000
Subject: [docs] [issue10536] Enhancements to gettext docs
In-Reply-To: <1290730924.88.0.289473332428.issue10536@psf.upfronthosting.co.za>
Message-ID: <1541360843.35.0.788709270274.issue10536@psf.upfronthosting.co.za>


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

I will try to find some time in the next month!

----------

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

From report at bugs.python.org  Sun Nov  4 14:54:20 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Sun, 04 Nov 2018 19:54:20 +0000
Subject: [docs] [issue10536] Enhancements to gettext docs
In-Reply-To: <1290730924.88.0.289473332428.issue10536@psf.upfronthosting.co.za>
Message-ID: <1541361260.74.0.788709270274.issue10536@psf.upfronthosting.co.za>


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

Serhyi and Eric, for which version of Python, only 2.7? or master, 3.6 & 3.7?

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

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

From report at bugs.python.org  Sun Nov  4 15:41:36 2018
From: report at bugs.python.org (Julien Palard)
Date: Sun, 04 Nov 2018 20:41:36 +0000
Subject: [docs] [issue35159] Add a link to the devguide in the sidebar of
 the documentation
In-Reply-To: <1541318229.4.0.788709270274.issue35159@psf.upfronthosting.co.za>
Message-ID: <1541364096.56.0.788709270274.issue35159@psf.upfronthosting.co.za>


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


New changeset 0edc7b1b1a2b22d4d200f80995454d01927bf93e by Julien Palard (St?phane Wirtel) in branch 'master':
bpo-35159: Add a link to the devguide in the sidebar of the index (Doc/) (GH-10316)
https://github.com/python/cpython/commit/0edc7b1b1a2b22d4d200f80995454d01927bf93e


----------

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

From report at bugs.python.org  Sun Nov  4 15:41:58 2018
From: report at bugs.python.org (Julien Palard)
Date: Sun, 04 Nov 2018 20:41:58 +0000
Subject: [docs] [issue35159] Add a link to the devguide in the sidebar of
 the documentation
In-Reply-To: <1541318229.4.0.788709270274.issue35159@psf.upfronthosting.co.za>
Message-ID: <1541364118.66.0.702299269573.issue35159@psf.upfronthosting.co.za>


Change by Julien Palard <julien+python at palard.fr>:


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

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

From report at bugs.python.org  Sun Nov  4 15:59:02 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Sun, 04 Nov 2018 20:59:02 +0000
Subject: [docs] [issue10536] Enhancements to gettext docs
In-Reply-To: <1290730924.88.0.289473332428.issue10536@psf.upfronthosting.co.za>
Message-ID: <1541365142.37.0.702299269573.issue10536@psf.upfronthosting.co.za>


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


----------
pull_requests: +9627

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

From report at bugs.python.org  Sun Nov  4 16:02:03 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Sun, 04 Nov 2018 21:02:03 +0000
Subject: [docs] [issue10536] Enhancements to gettext docs
In-Reply-To: <1290730924.88.0.289473332428.issue10536@psf.upfronthosting.co.za>
Message-ID: <1541365322.75.0.788709270274.issue10536@psf.upfronthosting.co.za>


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

Serhiy & ?ric, I have ported the patch to a PR for master (3.8).

I have removed the double spaces and some useless diffs. You will find my diff file I have used for the PR.
 
the git revision was 5d744a8855bb4d411e5f32cfd365f0581e30ef48

Author: Stefan Krah <stefan at bytereef.org>
Date:   Fri Nov 26 11:07:04 2010 +0000

    Merged revisions 86791 via svnmerge from
    svn+ssh://pythondev at svn.python.org/python/branches/py3k
    
    ........
      r86791 | stefan.krah | 2010-11-26 11:54:09 +0100 (Fri, 26 Nov 2010) | 1 line
    
      Indentation cleanup.

----------
Added file: https://bugs.python.org/file47904/bpo-10536.diff

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

From report at bugs.python.org  Sun Nov  4 16:02:14 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Sun, 04 Nov 2018 21:02:14 +0000
Subject: [docs] [issue10536] Enhancements to gettext docs
In-Reply-To: <1290730924.88.0.289473332428.issue10536@psf.upfronthosting.co.za>
Message-ID: <1541365334.49.0.702299269573.issue10536@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sun Nov  4 16:46:49 2018
From: report at bugs.python.org (Julien Palard)
Date: Sun, 04 Nov 2018 21:46:49 +0000
Subject: [docs] [issue31873] Inconsistent capitalization of proper noun -
 Unicode.
In-Reply-To: <1509023732.92.0.213398074469.issue31873@psf.upfronthosting.co.za>
Message-ID: <1541368008.91.0.788709270274.issue31873@psf.upfronthosting.co.za>


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

Currently in our documentation there's 89 "Unicode obj" vs 8 "unicode obj" so I'll go for it.

----------
nosy: +mdk

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

From report at bugs.python.org  Sun Nov  4 17:02:49 2018
From: report at bugs.python.org (Marc-Andre Lemburg)
Date: Sun, 04 Nov 2018 22:02:49 +0000
Subject: [docs] [issue31873] Inconsistent capitalization of proper noun -
 Unicode.
In-Reply-To: <1509023732.92.0.213398074469.issue31873@psf.upfronthosting.co.za>
Message-ID: <1541368969.49.0.788709270274.issue31873@psf.upfronthosting.co.za>


Marc-Andre Lemburg <mal at egenix.com> added the comment:

If you want to do this correctly, you have to check each case:

* if "unicode object" refers to a C PyUnicode object, it's probably better to use "PyUnicode object"
* if "unicode object" refers to a C PyObject object, with type "unicode", it's probably better to leave it as is
* if "unicode object" refers to a Python unicode object, it's probably better to call it "Unicode string object" or just "string object" in Python 3
* if "unicode object" does not indicate whether Python or C is meant, "Unicode object" is probably better

----------

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

From report at bugs.python.org  Sun Nov  4 17:24:44 2018
From: report at bugs.python.org (Julien Palard)
Date: Sun, 04 Nov 2018 22:24:44 +0000
Subject: [docs] [issue10536] Enhancements to gettext docs
In-Reply-To: <1290730924.88.0.289473332428.issue10536@psf.upfronthosting.co.za>
Message-ID: <1541370284.26.0.788709270274.issue10536@psf.upfronthosting.co.za>


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


New changeset 55f3317e984cc35bd18ba0326ed98766a2750ffd by Julien Palard (St?phane Wirtel) in branch 'master':
bpo-10536: Enhancements to gettext docs (GH-10324)
https://github.com/python/cpython/commit/55f3317e984cc35bd18ba0326ed98766a2750ffd


----------
nosy: +mdk

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

From report at bugs.python.org  Sun Nov  4 17:27:10 2018
From: report at bugs.python.org (Julien Palard)
Date: Sun, 04 Nov 2018 22:27:10 +0000
Subject: [docs] [issue10536] Enhancements to gettext docs
In-Reply-To: <1290730924.88.0.289473332428.issue10536@psf.upfronthosting.co.za>
Message-ID: <1541370430.28.0.702299269573.issue10536@psf.upfronthosting.co.za>


Change by Julien Palard <julien+python at palard.fr>:


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

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

From report at bugs.python.org  Sun Nov  4 17:34:24 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Sun, 04 Nov 2018 22:34:24 +0000
Subject: [docs] [issue35118] Add peek() or first() method in queue
In-Reply-To: <1540956018.19.0.788709270274.issue35118@psf.upfronthosting.co.za>
Message-ID: <1541370864.8.0.788709270274.issue35118@psf.upfronthosting.co.za>


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


New changeset 98b85354153883b0a080f678f213729cd0764fee by Raymond Hettinger (Windson yang) in branch 'master':
bpo-35118: Improve docs regarding indexing (GH-10265)
https://github.com/python/cpython/commit/98b85354153883b0a080f678f213729cd0764fee


----------

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

From report at bugs.python.org  Sun Nov  4 17:34:54 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Sun, 04 Nov 2018 22:34:54 +0000
Subject: [docs] [issue35118] Add peek() or first() method in queue
In-Reply-To: <1540956018.19.0.788709270274.issue35118@psf.upfronthosting.co.za>
Message-ID: <1541370894.34.0.702299269573.issue35118@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/issue35118>
_______________________________________

From report at bugs.python.org  Sun Nov  4 17:36:27 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 04 Nov 2018 22:36:27 +0000
Subject: [docs] [issue9842] Document ... used in recursive repr of containers
In-Reply-To: <1284336324.93.0.400210409006.issue9842@psf.upfronthosting.co.za>
Message-ID: <1541370987.64.0.788709270274.issue9842@psf.upfronthosting.co.za>


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


New changeset b4db249c9544fc4425c32feb86d610f3224ca3d8 by Miss Islington (bot) (Pablo Galindo) in branch 'master':
bpo-9842: Add cross-reference to the ellipsis object (GH-4063)
https://github.com/python/cpython/commit/b4db249c9544fc4425c32feb86d610f3224ca3d8


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

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

From report at bugs.python.org  Sun Nov  4 18:12:15 2018
From: report at bugs.python.org (Steven D'Aprano)
Date: Sun, 04 Nov 2018 23:12:15 +0000
Subject: [docs] [issue35165] Possible wrong method name in attribute
 references doc
In-Reply-To: <1541353400.8.0.788709270274.issue35165@psf.upfronthosting.co.za>
Message-ID: <1541373135.04.0.788709270274.issue35165@psf.upfronthosting.co.za>


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

https://docs.python.org/3/reference/expressions.html#attribute-references

__getattr__ is the correct method to override in most (but not all) cases. I don't think we should encourage people to override __getattribute__ as the first resort.

__getattribute__ is a more specialised method that is used by the interpreter at a deeper level. It is called on every attribute access, so it ought to be as fast as possible, while __getattr__ is only called if the named attribute doesn't exist.

I don't think anything needs to change here.

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

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

From report at bugs.python.org  Mon Nov  5 00:46:01 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 05 Nov 2018 05:46:01 +0000
Subject: [docs] [issue9842] Document ... used in recursive repr of containers
In-Reply-To: <1284336324.93.0.400210409006.issue9842@psf.upfronthosting.co.za>
Message-ID: <1541396761.1.0.702299269573.issue9842@psf.upfronthosting.co.za>


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


----------
pull_requests: +9634

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

From report at bugs.python.org  Mon Nov  5 00:47:39 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 05 Nov 2018 05:47:39 +0000
Subject: [docs] [issue9842] Document ... used in recursive repr of containers
In-Reply-To: <1284336324.93.0.400210409006.issue9842@psf.upfronthosting.co.za>
Message-ID: <1541396858.88.0.788709270274.issue9842@psf.upfronthosting.co.za>


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

PR 10330 adds few references for using an ellipsis as a placeholder.

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

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

From report at bugs.python.org  Mon Nov  5 01:11:42 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 05 Nov 2018 06:11:42 +0000
Subject: [docs] [issue10536] Enhancements to gettext docs
In-Reply-To: <1290730924.88.0.289473332428.issue10536@psf.upfronthosting.co.za>
Message-ID: <1541398302.54.0.788709270274.issue10536@psf.upfronthosting.co.za>


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

I think it is worth to enhance documentation for other versions too. See also my comments on GitHub.

----------

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

From report at bugs.python.org  Mon Nov  5 02:58:23 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 05 Nov 2018 07:58:23 +0000
Subject: [docs] [issue33460] "..." is used to confusingly indicate many
 different things in chapter 3
In-Reply-To: <1525995197.73.0.682650639539.issue33460@psf.upfronthosting.co.za>
Message-ID: <1541404703.19.0.702299269573.issue33460@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Mon Nov  5 04:45:47 2018
From: report at bugs.python.org (Denis Osipov)
Date: Mon, 05 Nov 2018 09:45:47 +0000
Subject: [docs] [issue35165] Possible wrong method name in attribute
 references doc
In-Reply-To: <1541353400.8.0.788709270274.issue35165@psf.upfronthosting.co.za>
Message-ID: <1541411147.47.0.788709270274.issue35165@psf.upfronthosting.co.za>


Denis Osipov <osipov_d at list.ru> added the comment:

Got it.

But now docs says that overriding the __getattr__() method is enough to customize attribute access. It's not completely true.

If I understand it correct, to make __getattr__() work every time you need to call it by __getattribute__ or raise AttributeError, e.g. store attributes somewhere not in instance __dict__. In this case you need to override __setattr__ too.

class MyGetattrClass:
    def __init__(self):
        super().__setattr__("attrs", {})

    def __setattr__(self, name, value):
        self.attrs[name] = value

    def __getattr__(self, name):
        try:
            print(f"{name} equals {self.attrs[name]}")
        except KeyError:
            raise AttributeError(
                f"{type(self).__name__!r} object has no attribute {name!r}"
            ) from None

If it's correct, we probably should add some clarification in expressions doc. Or maybe just link to https://docs.python.org/3/reference/datamodel.html#object.__getattr__ (which mention about it) will be enough.

----------

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

From report at bugs.python.org  Mon Nov  5 05:32:00 2018
From: report at bugs.python.org (orlnub123)
Date: Mon, 05 Nov 2018 10:32:00 +0000
Subject: [docs] [issue35105] Document that CPython accepts "invalid"
 identifiers
In-Reply-To: <1540815891.13.0.788709270274.issue35105@psf.upfronthosting.co.za>
Message-ID: <1541413919.86.0.788709270274.issue35105@psf.upfronthosting.co.za>


orlnub123 <orlnub123 at gmail.com> added the comment:

I take back my previous suggestion, I agree that documenting it in setattr() (and **kwargs) is the way to go. It's obvious that you can assign anything to the __dict__, since it represents a dict, but setattr() is more ambiguous.
'Anything' was the key word for me here. For example you can assign ints to __dict__ and it won't complain but try to do the same with setattr()/getattr() and it results in an error.

----------

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

From report at bugs.python.org  Mon Nov  5 09:26:38 2018
From: report at bugs.python.org (Steve Dower)
Date: Mon, 05 Nov 2018 14:26:38 +0000
Subject: [docs] [issue35156] Consider revising documentation on Python
 Builds from source
In-Reply-To: <1541288069.11.0.788709270274.issue35156@psf.upfronthosting.co.za>
Message-ID: <1541427998.54.0.788709270274.issue35156@psf.upfronthosting.co.za>


Steve Dower <steve.dower at python.org> added the comment:

Most people building Python from the devguide are doing it for contributions, so I'd be very hesitant to change the default recommendations. But we should highlight how to make a working installable build (including the extra dependencies) and the common options on our scripts, as well as their -h options.

I also have a "layout" script coming that will make it easier for people to produce their own custom installers by at least copying the files into the right place.

----------
stage:  -> needs patch
versions: +Python 3.7, Python 3.8

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

From report at bugs.python.org  Mon Nov  5 11:28:46 2018
From: report at bugs.python.org (Jorge Ramos)
Date: Mon, 05 Nov 2018 16:28:46 +0000
Subject: [docs] [issue35156] Consider revising documentation on Python
 Builds from source
In-Reply-To: <1541288069.11.0.788709270274.issue35156@psf.upfronthosting.co.za>
Message-ID: <1541435326.74.0.788709270274.issue35156@psf.upfronthosting.co.za>


Jorge Ramos <neyuru at gmail.com> added the comment:

Thank you, I think that will suffice. At least guide folks like myself who want to build from source and with optimizations in the right direction (on which folder to work on and which commands to issue to the terminal)

Please keep me posted.

----------

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

From report at bugs.python.org  Mon Nov  5 11:33:25 2018
From: report at bugs.python.org (Jorge Ramos)
Date: Mon, 05 Nov 2018 16:33:25 +0000
Subject: [docs] [issue35156] Consider revising documentation on Python
 Builds from source
In-Reply-To: <1541288069.11.0.788709270274.issue35156@psf.upfronthosting.co.za>
Message-ID: <1541435605.09.0.788709270274.issue35156@psf.upfronthosting.co.za>


Jorge Ramos <neyuru at gmail.com> added the comment:

One more thing: point in case #6 does credit a revision IMO. The build_pgo.bat file does not exist.

----------

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

From report at bugs.python.org  Mon Nov  5 16:20:59 2018
From: report at bugs.python.org (Julien Palard)
Date: Mon, 05 Nov 2018 21:20:59 +0000
Subject: [docs] [issue31793] Allow to specialize smart quotes in
 documentation translations
In-Reply-To: <1508060988.99.0.213398074469.issue31793@psf.upfronthosting.co.za>
Message-ID: <1541452859.43.0.702299269573.issue31793@psf.upfronthosting.co.za>


Change by Julien Palard <julien+python at palard.fr>:


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

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

From report at bugs.python.org  Mon Nov  5 20:53:26 2018
From: report at bugs.python.org (Ivan Levkivskyi)
Date: Tue, 06 Nov 2018 01:53:26 +0000
Subject: [docs] [issue35119] Customizing module attribute access example
 raises RecursionError
In-Reply-To: <1540959974.35.0.788709270274.issue35119@psf.upfronthosting.co.za>
Message-ID: <1541469205.95.0.788709270274.issue35119@psf.upfronthosting.co.za>


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


New changeset 0bee3c36d406e47fa9f99cfc1e07b701512c4f3f by Ivan Levkivskyi (Denis Osipov) in branch 'master':
bpo-35119: Fix RecursionError in example of customizing module attribute access. (GH-10323)
https://github.com/python/cpython/commit/0bee3c36d406e47fa9f99cfc1e07b701512c4f3f


----------

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

From report at bugs.python.org  Mon Nov  5 20:53:35 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 06 Nov 2018 01:53:35 +0000
Subject: [docs] [issue35119] Customizing module attribute access example
 raises RecursionError
In-Reply-To: <1540959974.35.0.788709270274.issue35119@psf.upfronthosting.co.za>
Message-ID: <1541469215.72.0.702299269573.issue35119@psf.upfronthosting.co.za>


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


----------
pull_requests: +9648

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

From report at bugs.python.org  Mon Nov  5 20:57:38 2018
From: report at bugs.python.org (Lysandros Nikolaou)
Date: Tue, 06 Nov 2018 01:57:38 +0000
Subject: [docs] [issue22021] shutil.make_archive()  root_dir do not work
In-Reply-To: <1405936213.68.0.143186152462.issue22021@psf.upfronthosting.co.za>
Message-ID: <1541469458.06.0.788709270274.issue22021@psf.upfronthosting.co.za>


Lysandros Nikolaou <lisandrosnik at gmail.com> added the comment:

Is anybody working on this or can I submit a PR?

----------
nosy: +lys.nikolaou

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

From report at bugs.python.org  Mon Nov  5 20:59:19 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 06 Nov 2018 01:59:19 +0000
Subject: [docs] [issue35119] Customizing module attribute access example
 raises RecursionError
In-Reply-To: <1540959974.35.0.788709270274.issue35119@psf.upfronthosting.co.za>
Message-ID: <1541469559.17.0.788709270274.issue35119@psf.upfronthosting.co.za>


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


New changeset 558dc8adbec0b85e0ff257fcedc85c5d89cd2825 by Miss Islington (bot) in branch '3.7':
bpo-35119: Fix RecursionError in example of customizing module attribute access. (GH-10323)
https://github.com/python/cpython/commit/558dc8adbec0b85e0ff257fcedc85c5d89cd2825


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

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

From report at bugs.python.org  Mon Nov  5 21:00:37 2018
From: report at bugs.python.org (Ivan Levkivskyi)
Date: Tue, 06 Nov 2018 02:00:37 +0000
Subject: [docs] [issue35119] Customizing module attribute access example
 raises RecursionError
In-Reply-To: <1540959974.35.0.788709270274.issue35119@psf.upfronthosting.co.za>
Message-ID: <1541469637.83.0.702299269573.issue35119@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Mon Nov  5 22:15:16 2018
From: report at bugs.python.org (Steve Dower)
Date: Tue, 06 Nov 2018 03:15:16 +0000
Subject: [docs] [issue35156] Consider revising documentation on Python
 Builds from source
In-Reply-To: <1541288069.11.0.788709270274.issue35156@psf.upfronthosting.co.za>
Message-ID: <1541474116.36.0.788709270274.issue35156@psf.upfronthosting.co.za>


Steve Dower <steve.dower at python.org> added the comment:

If you're able, you might be the best person to do some of those updates right now :) The rest of us will have to set aside time to get back up to speed on some of the details, and while we'll likely have to do that to review changes anyway, at least that's one less person to wait for.

----------

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

From report at bugs.python.org  Mon Nov  5 23:25:38 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Tue, 06 Nov 2018 04:25:38 +0000
Subject: [docs] [issue23220] IDLE: Document how Shell displays user code
 output
In-Reply-To: <1420937687.17.0.885670059147.issue23220@psf.upfronthosting.co.za>
Message-ID: <1541478338.13.0.702299269573.issue23220@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Tue Nov  6 00:10:27 2018
From: report at bugs.python.org (Jorge Ramos)
Date: Tue, 06 Nov 2018 05:10:27 +0000
Subject: [docs] [issue35156] Consider revising documentation on Python
 Builds from source
In-Reply-To: <1541288069.11.0.788709270274.issue35156@psf.upfronthosting.co.za>
Message-ID: <1541481027.92.0.788709270274.issue35156@psf.upfronthosting.co.za>


Jorge Ramos <neyuru at gmail.com> added the comment:

Although I appreciate the confidence placed in me, I think I'm not exactly the most competent person to make changes to such an important project. I know what -probably- could be improved (from my very narrow point of view) but I don't even know where or how to start so to not screw things up. 

Don't get me wrong, participating in a project like this (no matter how minor the contribution) is an exciting thought but I ignore so many things that I'm afraid I would probably make it worse rather than making it better. Those things where written for a reason and I'm not even close to know or understand the context on why it was so, as to make a meaningful contribution.

----------

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

From report at bugs.python.org  Tue Nov  6 03:22:24 2018
From: report at bugs.python.org (Julien Palard)
Date: Tue, 06 Nov 2018 08:22:24 +0000
Subject: [docs] [issue35015] availability directive breaks po files
In-Reply-To: <1539852628.85.0.788709270274.issue35015@psf.upfronthosting.co.za>
Message-ID: <1541492544.66.0.702299269573.issue35015@psf.upfronthosting.co.za>


Change by Julien Palard <julien+python at palard.fr>:


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

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

From report at bugs.python.org  Tue Nov  6 08:14:40 2018
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 06 Nov 2018 13:14:40 +0000
Subject: [docs] [issue22021] shutil.make_archive()  root_dir do not work
In-Reply-To: <1405936213.68.0.143186152462.issue22021@psf.upfronthosting.co.za>
Message-ID: <1541510080.48.0.788709270274.issue22021@psf.upfronthosting.co.za>


STINNER Victor <vstinner at redhat.com> added the comment:

> Is anybody working on this or can I submit a PR?

Yes: Joannah Nanjekye wrote PR 10191 (from Issue22021.patch) which has been rejected. This issue is more complex from what it looks.

----------

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

From report at bugs.python.org  Tue Nov  6 11:18:20 2018
From: report at bugs.python.org (Lysandros Nikolaou)
Date: Tue, 06 Nov 2018 16:18:20 +0000
Subject: [docs] [issue22021] shutil.make_archive()  root_dir do not work
In-Reply-To: <1405936213.68.0.143186152462.issue22021@psf.upfronthosting.co.za>
Message-ID: <1541521100.85.0.788709270274.issue22021@psf.upfronthosting.co.za>


Lysandros Nikolaou <lisandrosnik at gmail.com> added the comment:

Since Serhiy said that this is a pure documentation issue, I thought that a doc PR is all that was needed, which I would be happy to make. Am I missing something here?

----------

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

From report at bugs.python.org  Tue Nov  6 12:37:42 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Tue, 06 Nov 2018 17:37:42 +0000
Subject: [docs] [issue23220] IDLE: Document how Shell displays user code
 output
In-Reply-To: <1420937687.17.0.885670059147.issue23220@psf.upfronthosting.co.za>
Message-ID: <1541525862.15.0.788709270274.issue23220@psf.upfronthosting.co.za>


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


New changeset 75d9d59ab3a372d3d78e6a1f5e9f256e29d0a9a6 by Terry Jan Reedy in branch 'master':
bpo-23220: Explain how IDLE's Shell displays output (GH-10356)
https://github.com/python/cpython/commit/75d9d59ab3a372d3d78e6a1f5e9f256e29d0a9a6


----------

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

From report at bugs.python.org  Tue Nov  6 12:37:48 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 06 Nov 2018 17:37:48 +0000
Subject: [docs] [issue23220] IDLE: Document how Shell displays user code
 output
In-Reply-To: <1420937687.17.0.885670059147.issue23220@psf.upfronthosting.co.za>
Message-ID: <1541525868.97.0.702299269573.issue23220@psf.upfronthosting.co.za>


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


----------
pull_requests: +9666

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

From report at bugs.python.org  Tue Nov  6 12:37:58 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 06 Nov 2018 17:37:58 +0000
Subject: [docs] [issue23220] IDLE: Document how Shell displays user code
 output
In-Reply-To: <1420937687.17.0.885670059147.issue23220@psf.upfronthosting.co.za>
Message-ID: <1541525878.45.0.702299269573.issue23220@psf.upfronthosting.co.za>


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


----------
pull_requests: +9667

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

From report at bugs.python.org  Tue Nov  6 12:53:53 2018
From: report at bugs.python.org (Tobias Kunze)
Date: Tue, 06 Nov 2018 17:53:53 +0000
Subject: [docs] [issue22021] shutil.make_archive()  root_dir do not work
In-Reply-To: <1405936213.68.0.143186152462.issue22021@psf.upfronthosting.co.za>
Message-ID: <1541526832.96.0.788709270274.issue22021@psf.upfronthosting.co.za>


Tobias Kunze <r at rixx.de> added the comment:

Yes, this is a documentation issue: A patch clarifying what root_dir and base_dir do, and how they interact (or how they are to be used in combination) would be sufficient to close this issue.

----------

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

From report at bugs.python.org  Tue Nov  6 13:08:14 2018
From: report at bugs.python.org (Lysandros Nikolaou)
Date: Tue, 06 Nov 2018 18:08:14 +0000
Subject: [docs] [issue22021] shutil.make_archive()  root_dir do not work
In-Reply-To: <1405936213.68.0.143186152462.issue22021@psf.upfronthosting.co.za>
Message-ID: <1541527694.11.0.702299269573.issue22021@psf.upfronthosting.co.za>


Change by Lysandros Nikolaou <lisandrosnik at gmail.com>:


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

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

From report at bugs.python.org  Tue Nov  6 13:14:59 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 06 Nov 2018 18:14:59 +0000
Subject: [docs] [issue23220] IDLE: Document how Shell displays user code
 output
In-Reply-To: <1420937687.17.0.885670059147.issue23220@psf.upfronthosting.co.za>
Message-ID: <1541528099.18.0.702299269573.issue23220@psf.upfronthosting.co.za>


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


----------
pull_requests: +9669

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

From report at bugs.python.org  Tue Nov  6 13:27:23 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 06 Nov 2018 18:27:23 +0000
Subject: [docs] [issue23220] IDLE: Document how Shell displays user code
 output
In-Reply-To: <1420937687.17.0.885670059147.issue23220@psf.upfronthosting.co.za>
Message-ID: <1541528843.75.0.788709270274.issue23220@psf.upfronthosting.co.za>


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


New changeset 34fcee9ed81c954d6418241ad546f71e103d3b9b by Miss Islington (bot) in branch '3.7':
bpo-23220: Explain how IDLE's Shell displays output (GH-10356)
https://github.com/python/cpython/commit/34fcee9ed81c954d6418241ad546f71e103d3b9b


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

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

From report at bugs.python.org  Tue Nov  6 13:44:40 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 06 Nov 2018 18:44:40 +0000
Subject: [docs] [issue23220] IDLE: Document how Shell displays user code
 output
In-Reply-To: <1420937687.17.0.885670059147.issue23220@psf.upfronthosting.co.za>
Message-ID: <1541529880.94.0.702299269573.issue23220@psf.upfronthosting.co.za>


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


----------
pull_requests: +9670

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

From report at bugs.python.org  Tue Nov  6 13:59:44 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Tue, 06 Nov 2018 18:59:44 +0000
Subject: [docs] [issue23220] IDLE: Document how Shell displays user code
 output
In-Reply-To: <1420937687.17.0.885670059147.issue23220@psf.upfronthosting.co.za>
Message-ID: <1541530784.03.0.788709270274.issue23220@psf.upfronthosting.co.za>


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


New changeset 7476fefb65075161d57435c8dd7e92437578d3c1 by Terry Jan Reedy (Miss Islington (bot)) in branch '3.6':
bpo-23220: Explain how IDLE's Shell displays output (GH-10356) (#10369)
https://github.com/python/cpython/commit/7476fefb65075161d57435c8dd7e92437578d3c1


----------

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

From report at bugs.python.org  Tue Nov  6 17:11:37 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Tue, 06 Nov 2018 22:11:37 +0000
Subject: [docs] [issue23220] IDLE: Document how Shell displays user code
 output
In-Reply-To: <1420937687.17.0.885670059147.issue23220@psf.upfronthosting.co.za>
Message-ID: <1541542297.69.0.788709270274.issue23220@psf.upfronthosting.co.za>


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

I merged a first edition of the new section.  It does not include Mac behavior, so will need revision.  But I want to do some experiments with tk/inter on various systems before doing so.

----------
dependencies: +IDLE Doc: Text consumes unlimited RAM, consoles likely not
stage: patch review -> needs patch

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

From report at bugs.python.org  Tue Nov  6 17:29:09 2018
From: report at bugs.python.org (Julien Palard)
Date: Tue, 06 Nov 2018 22:29:09 +0000
Subject: [docs] [issue35181] Doc: Namespace Packages: Inconsistent
 documentation of __loader__ being None
Message-ID: <1541543349.68.0.788709270274.issue35181@psf.upfronthosting.co.za>


New submission from Julien Palard <julien+python at palard.fr>:

The documentation states that a __loader__ of a namespace package should be None:

- [1] "For namespace packages this should be set to None."
- [2] "To indicate to the import machinery that the spec represents a namespace portion. the path entry finder sets ?loader? on the spec to None".

But this looks wrong [3], looks like it has been changed in [4]/[5].

I think one should rely on __file__ being None on namespace packages (which make sense as they span over multiple directories) instead of __loader__ being None (a side effect of the import machinery ?).


[1]: https://docs.python.org/3/library/importlib.html#importlib.machinery.ModuleSpec.loader
[2]: https://docs.python.org/3/reference/import.html#path-entry-finder-protocol
[3]: https://stackoverflow.com/questions/52869541/namespace-package-spec-loader-and-loader-attributes-not-set-to-none
[4]: https://bugs.python.org/issue32303
[5]: https://github.com/python/cpython/pull/5481/files#diff-a6592cec2ebc8dba9bbf7d396370b138L319

----------
assignee: docs at python
components: Documentation
messages: 329392
nosy: docs at python, mdk
priority: normal
severity: normal
status: open
title: Doc: Namespace Packages: Inconsistent documentation of __loader__ being None
versions: Python 3.7

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

From report at bugs.python.org  Tue Nov  6 18:41:53 2018
From: report at bugs.python.org (Barry A. Warsaw)
Date: Tue, 06 Nov 2018 23:41:53 +0000
Subject: [docs] [issue35181] Doc: Namespace Packages: Inconsistent
 documentation of __loader__ being None
In-Reply-To: <1541543349.68.0.788709270274.issue35181@psf.upfronthosting.co.za>
Message-ID: <1541547713.98.0.702299269573.issue35181@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Wed Nov  7 01:27:32 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Wed, 07 Nov 2018 06:27:32 +0000
Subject: [docs] [issue17972] inspect module docs omits many functions
In-Reply-To: <1368501068.91.0.677640111487.issue17972@psf.upfronthosting.co.za>
Message-ID: <1541572052.19.0.702299269573.issue17972@psf.upfronthosting.co.za>


Change by Karthikeyan Singaravelan <tir.karthi at gmail.com>:


----------
nosy: +xtreak

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

From report at bugs.python.org  Wed Nov  7 06:49:13 2018
From: report at bugs.python.org (Shaun Griffith)
Date: Wed, 07 Nov 2018 11:49:13 +0000
Subject: [docs] [issue35183] os.path.splitext documentation needs typical
 example
Message-ID: <1541591353.01.0.788709270274.issue35183@psf.upfronthosting.co.za>


New submission from Shaun Griffith <shaun.griffith.1964 at gmail.com>:

As with many entries on the os.path doc page, splitext needs a typical example. Not grokking the bare minimum text, I had to actually try it in the interpreter to see what it did.

The one example that *is* there is an edge case, and does nothing to explain the normal behavior, or why this is the correct behavior for the edge case.

Here is where I tripped up:

Split the pathname path into a pair (root, ext) such that root + ext == path, and ext is empty or begins with a period and contains at most one period.

One interpretation of this is that ext is either empty, or has a period, _and nothing else_. 

Here are 2 examples for typical use:

>>> splitext('readme.txt')
('readme', '.txt')
>>> splitext('/some/long/pathname/warble.csv')
('/some/long/pathname/warble', '.csv')

----------
assignee: docs at python
components: Documentation
messages: 329414
nosy: docs at python, shaungriffith
priority: normal
severity: normal
status: open
title: os.path.splitext documentation needs typical example
type: enhancement
versions: Python 3.6

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

From report at bugs.python.org  Wed Nov  7 07:57:40 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 07 Nov 2018 12:57:40 +0000
Subject: [docs] [issue10536] Enhancements to gettext docs
In-Reply-To: <1290730924.88.0.289473332428.issue10536@psf.upfronthosting.co.za>
Message-ID: <1541595460.7.0.702299269573.issue10536@psf.upfronthosting.co.za>


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


----------
stage: resolved -> 
status: closed -> open
versions: +Python 3.6, Python 3.7 -Python 3.4, Python 3.5

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

From report at bugs.python.org  Wed Nov  7 09:43:39 2018
From: report at bugs.python.org (=?utf-8?b?R8Opcnk=?=)
Date: Wed, 07 Nov 2018 14:43:39 +0000
Subject: [docs] [issue35181] Doc: Namespace Packages: Inconsistent
 documentation of __loader__ being None
In-Reply-To: <1541543349.68.0.788709270274.issue35181@psf.upfronthosting.co.za>
Message-ID: <1541601819.74.0.702299269573.issue35181@psf.upfronthosting.co.za>


Change by G?ry <gery.ogam at gmail.com>:


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

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

From report at bugs.python.org  Wed Nov  7 09:47:06 2018
From: report at bugs.python.org (=?utf-8?b?R8Opcnk=?=)
Date: Wed, 07 Nov 2018 14:47:06 +0000
Subject: [docs] [issue35181] Doc: Namespace Packages: Inconsistent
 documentation of __loader__ being None
In-Reply-To: <1541543349.68.0.788709270274.issue35181@psf.upfronthosting.co.za>
Message-ID: <1541602026.42.0.702299269573.issue35181@psf.upfronthosting.co.za>


Change by G?ry <gery.ogam at gmail.com>:


----------
pull_requests: +9678

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

From report at bugs.python.org  Wed Nov  7 10:13:59 2018
From: report at bugs.python.org (=?utf-8?b?R8Opcnk=?=)
Date: Wed, 07 Nov 2018 15:13:59 +0000
Subject: [docs] [issue35181] Doc: Namespace Packages: Inconsistent
 documentation of __loader__ being None
In-Reply-To: <1541543349.68.0.788709270274.issue35181@psf.upfronthosting.co.za>
Message-ID: <1541603639.79.0.788709270274.issue35181@psf.upfronthosting.co.za>


G?ry <gery.ogam at gmail.com> added the comment:

It looks like Barry Warsaw has not been fully updated the documentation after making the __spec__.loader attribute match with the __loader__ attribute, and the __spec__.file attribute match with the __file__ attribute for namespace packages.

Here is a pull request to update the library documentation of importlib (your first link [1]) with the current Barry's implementation:
https://github.com/python/cpython/pull/10016

Here is another pull request to update the reference documentation of the import system (your second link [2], but for a different paragraph, as I think the "To indicate to the import machinery that the spec represents a namespace portion the path entry finder sets ?loader? on the spec to None" sentence is correct, since the `_bootstrap.ModuleSpec.loader` attribute of a namespace package remains `None` until the call to the `importlib._bootstrap._init_module_attrs` function):
https://github.com/python/cpython/pull/10376

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

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

From report at bugs.python.org  Wed Nov  7 16:42:46 2018
From: report at bugs.python.org (Julien Palard)
Date: Wed, 07 Nov 2018 21:42:46 +0000
Subject: [docs] [issue35015] availability directive breaks po files
In-Reply-To: <1539852628.85.0.788709270274.issue35015@psf.upfronthosting.co.za>
Message-ID: <1541626966.6.0.788709270274.issue35015@psf.upfronthosting.co.za>


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


New changeset beed84ca5e0f2784d758478d4e7c81c9c1088c4e by Julien Palard in branch 'master':
bpo-35015: Doc: Fix internationalisation of the availability directive. (GH-10360)
https://github.com/python/cpython/commit/beed84ca5e0f2784d758478d4e7c81c9c1088c4e


----------

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

From report at bugs.python.org  Wed Nov  7 16:42:55 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 07 Nov 2018 21:42:55 +0000
Subject: [docs] [issue35015] availability directive breaks po files
In-Reply-To: <1539852628.85.0.788709270274.issue35015@psf.upfronthosting.co.za>
Message-ID: <1541626975.8.0.702299269573.issue35015@psf.upfronthosting.co.za>


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


----------
pull_requests: +9684

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

From report at bugs.python.org  Wed Nov  7 16:48:41 2018
From: report at bugs.python.org (Julien Palard)
Date: Wed, 07 Nov 2018 21:48:41 +0000
Subject: [docs] [issue35015] availability directive breaks po files
In-Reply-To: <1539852628.85.0.788709270274.issue35015@psf.upfronthosting.co.za>
Message-ID: <1541627321.19.0.702299269573.issue35015@psf.upfronthosting.co.za>


Change by Julien Palard <julien+python at palard.fr>:


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

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

From report at bugs.python.org  Wed Nov  7 16:48:50 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 07 Nov 2018 21:48:50 +0000
Subject: [docs] [issue35015] availability directive breaks po files
In-Reply-To: <1539852628.85.0.788709270274.issue35015@psf.upfronthosting.co.za>
Message-ID: <1541627330.67.0.788709270274.issue35015@psf.upfronthosting.co.za>


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


New changeset 363839caf9dac796783c74b682a70680a15fa8a7 by Miss Islington (bot) in branch '3.7':
bpo-35015: Doc: Fix internationalisation of the availability directive. (GH-10360)
https://github.com/python/cpython/commit/363839caf9dac796783c74b682a70680a15fa8a7


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

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

From report at bugs.python.org  Thu Nov  8 07:24:26 2018
From: report at bugs.python.org (Andrew Svetlov)
Date: Thu, 08 Nov 2018 12:24:26 +0000
Subject: [docs] [issue34885] asyncio documention has lost its paragraph
 about cancellation
In-Reply-To: <1538568479.97.0.545547206417.issue34885@psf.upfronthosting.co.za>
Message-ID: <1541679866.63.0.788709270274.issue34885@psf.upfronthosting.co.za>


Andrew Svetlov <andrew.svetlov at gmail.com> added the comment:

I think the issue can be closed

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

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

From report at bugs.python.org  Thu Nov  8 09:41:26 2018
From: report at bugs.python.org (=?utf-8?q?Miro_Hron=C4=8Dok?=)
Date: Thu, 08 Nov 2018 14:41:26 +0000
Subject: [docs] [issue35190] collections.abc.Sequence cannot be used to test
 whether a class provides a particular interface
Message-ID: <1541688086.42.0.788709270274.issue35190@psf.upfronthosting.co.za>


New submission from Miro Hron?ok <miro at hroncok.cz>:

The collections.abc ? Abstract Base Classes for Containers documentation says:

> This module provides abstract base classes that can be used to test whether a class provides a particular interface; for example, whether it is hashable or whether it is a mapping.

https://docs.python.org/3/library/collections.abc.html

However this is not true for Sequence.

When I implement a class that provides a particular interface (defined in the Collections Abstract Base Classes table in that very page), I cannot check whether it implements a Sequence.

See an example:

    from collections import abc

    class Box:
        def __init__(self, wrapped):
            self._w = wrapped

        def __len__(self):
            return len(self._w)

        def __iter__(self):
            yield from self._w

        def __getitem__(self, i):
            return self._w[i]

        def __reversed__(self):
            yield from reversed(self._w)

        def __contains__(self, i):
            return i in self._w

        def index(self, value, start=0, stop=None):
            return self._w.index(value, start, stop)

        def count(self, value):
            return self._w.count(value)


    b = Box([1, 2, 3])

    for t in 'Sized', 'Iterable', 'Reversible', 'Container', 'Collection', 'Sequence':
        print(f'{t}: {isinstance(b, getattr(abc, t))}')


My class is Reversible.
My class is a Collection (as it is a Sized Iterable Container).
It implements __getitem__, __len__, __contains__, __iter__, __reversed__, index, and count.

Yet my class instance is not an instance of Sequence.

I suppose this behavior might be intentional, as discussed in issue16728 - or it might as well not be.

The main concern was that dict also provides these methods, but is not considered a Sequence,
however dict does not provide index() or count().

Regardless whether this is right or wrong behavior, as documented this should be a Sequence.

See also https://stackoverflow.com/questions/34927949/issubclass-of-abstract-base-class-sequence


As I see it, either:

    collections.abc.Sequence needs a __subclasshook__ so it can be used as the documentation implies.

Or:

    the documentation should not say that "abstract base classes (from abc module) can be used to test whether a class provides a particular interface" if it doesn't generally apply


Or:

    the Sequence documentation should say: "this particular abstract base class cannot be used to test whether a class provides a particular interface because reasons" (yet I don't really get those reasons)

----------
assignee: docs at python
components: Documentation, Library (Lib)
messages: 329475
nosy: docs at python, hroncok, vstinner
priority: normal
severity: normal
status: open
title: collections.abc.Sequence cannot be used to test whether a class provides a particular interface
versions: Python 3.6, Python 3.7, Python 3.8

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

From report at bugs.python.org  Thu Nov  8 10:18:35 2018
From: report at bugs.python.org (STINNER Victor)
Date: Thu, 08 Nov 2018 15:18:35 +0000
Subject: [docs] [issue35190] collections.abc.Sequence cannot be used to test
 whether a class provides a particular interface
In-Reply-To: <1541688086.42.0.788709270274.issue35190@psf.upfronthosting.co.za>
Message-ID: <1541690315.7.0.702299269573.issue35190@psf.upfronthosting.co.za>


Change by STINNER Victor <vstinner at redhat.com>:


----------
nosy: +gvanrossum, rhettinger, serhiy.storchaka

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

From report at bugs.python.org  Thu Nov  8 10:22:55 2018
From: report at bugs.python.org (Guido van Rossum)
Date: Thu, 08 Nov 2018 15:22:55 +0000
Subject: [docs] [issue35190] collections.abc.Sequence cannot be used to test
 whether a class provides a particular interface
In-Reply-To: <1541688086.42.0.788709270274.issue35190@psf.upfronthosting.co.za>
Message-ID: <1541690575.59.0.788709270274.issue35190@psf.upfronthosting.co.za>


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

Yeah, the docs need to be clarified.

----------

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

From report at bugs.python.org  Thu Nov  8 10:23:00 2018
From: report at bugs.python.org (Guido van Rossum)
Date: Thu, 08 Nov 2018 15:23:00 +0000
Subject: [docs] [issue35190] collections.abc.Sequence cannot be used to test
 whether a class provides a particular interface
In-Reply-To: <1541688086.42.0.788709270274.issue35190@psf.upfronthosting.co.za>
Message-ID: <1541690580.28.0.702299269573.issue35190@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Nov  8 10:33:54 2018
From: report at bugs.python.org (=?utf-8?q?Miro_Hron=C4=8Dok?=)
Date: Thu, 08 Nov 2018 15:33:54 +0000
Subject: [docs] [issue35190] collections.abc.Sequence cannot be used to test
 whether a class provides a particular interface
In-Reply-To: <1541688086.42.0.788709270274.issue35190@psf.upfronthosting.co.za>
Message-ID: <1541691234.47.0.788709270274.issue35190@psf.upfronthosting.co.za>


Miro Hron?ok <miro at hroncok.cz> added the comment:

I fail to understand what abc classes can be used to test whether a class provides a particular interface, and what abc classes cannot be used that way. What is the difference between those abc classes and why are all those abc classes listed together when they behave differently?

----------

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

From report at bugs.python.org  Thu Nov  8 11:44:03 2018
From: report at bugs.python.org (Paul Ganssle)
Date: Thu, 08 Nov 2018 16:44:03 +0000
Subject: [docs] [issue35190] collections.abc.Sequence cannot be used to test
 whether a class provides a particular interface
In-Reply-To: <1541688086.42.0.788709270274.issue35190@psf.upfronthosting.co.za>
Message-ID: <1541695443.68.0.702299269573.issue35190@psf.upfronthosting.co.za>


Change by Paul Ganssle <p.ganssle at gmail.com>:


----------
nosy: +p-ganssle

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

From report at bugs.python.org  Thu Nov  8 12:11:42 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 08 Nov 2018 17:11:42 +0000
Subject: [docs] [issue35190] collections.abc.Sequence cannot be used to test
 whether a class provides a particular interface
In-Reply-To: <1541688086.42.0.788709270274.issue35190@psf.upfronthosting.co.za>
Message-ID: <1541697102.52.0.702299269573.issue35190@psf.upfronthosting.co.za>


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


----------
nosy: +stutzbach

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

From report at bugs.python.org  Fri Nov  9 00:00:16 2018
From: report at bugs.python.org (Windson Yang)
Date: Fri, 09 Nov 2018 05:00:16 +0000
Subject: [docs] [issue35105] Document that CPython accepts "invalid"
 identifiers
In-Reply-To: <1540815891.13.0.788709270274.issue35105@psf.upfronthosting.co.za>
Message-ID: <1541739615.89.0.788709270274.issue35105@psf.upfronthosting.co.za>


Windson Yang <wiwindson at outlook.com> added the comment:

I try to create a PR for it. Should we add 'CPython implementation detail' at the document? Because this happens at cpython as well as pypy. BTW, where should we add the document? I have two choices.

* https://docs.python.org/3/reference/datamodel.html#object.__setattr__
* https://docs.python.org/3/library/functions.html#setattr

----------

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

From report at bugs.python.org  Fri Nov  9 07:27:25 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 09 Nov 2018 12:27:25 +0000
Subject: [docs] [issue33878] Doc: Assignment statement to tuple or list:
 case missing.
In-Reply-To: <1529154106.75.0.56676864532.issue33878@psf.upfronthosting.co.za>
Message-ID: <1541766445.71.0.788709270274.issue33878@psf.upfronthosting.co.za>


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

I think that the fact that `(a) = 42` is accepted is rather an implementation detail, and the consequence of limitations of the grammar parser. It accepts arbitrary expression at the left hand side of assignment. After transforming CST to AST unsuitable targets are rejected, but information about grouping parenthesis is lost at this stage.

This can be fixed if check the left hand side node before converting to AST.

----------
nosy: +gvanrossum, serhiy.storchaka

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

From gowrishankar at computerengineer.in  Thu Nov  1 13:20:54 2018
From: gowrishankar at computerengineer.in (Gowrishankar S Nath)
Date: Thu, 1 Nov 2018 22:50:54 +0530
Subject: [docs] Permission to use few programs and part of the documentation
 found in Python.org
Message-ID: <CANeMcMJNMEOCPyDBFNCzJkBygK6Rnmx_vwPO5wbT=Ptt_RQUGQ@mail.gmail.com>

Hi,

I would like to introduce myself as Dr.S.Gowrishankar working as Associate
Professor at the Department of Computer Science and Engineering at
Dr.Ambedkar Institute of Technology, Bengaluru, India.

I like to adopt a few programs and part of the explanation as it is found
in the documentation of Python.org for a book I'm working on.

Can you please give permission to use these programs? I'll mention the
source and give attribute to you.

Please consider our request.

Regards,
Gowrishankar.S







**************************************************************************Dr.S.Gowrishankar,Associate
Professor,Department of Computer Science and Engineering,Dr.Ambedkar
Institute of Technology,Bengaluru-560056, Karnataka, India.*

*Mob: 9986374400*

*http://www.gowrishankarnath.com <http://www.gowrishankarnath.com>*

*Twitter: @g_s_nath*
***************************************************************************
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181101/3389c790/attachment.html>

From gilbertohasnofb at googlemail.com  Sun Nov  4 20:11:24 2018
From: gilbertohasnofb at googlemail.com (Gilberto Agostinho)
Date: Mon, 5 Nov 2018 01:11:24 +0000
Subject: [docs] print() separator argument
Message-ID: <2af26706-5abb-52ac-ee05-0b1ee9a4b1db@gmail.com>

Hello,

This is a very minor report: in the documentation of both Python 3.6 and 
3.7, the print() built-in function is said to have a default separator 
value as sep=' ' in the first line of this function documentation, i.e. 
' print(*objects, sep=' ', end='\n', file=sys.stdout, flush=False)'. I 
believe the correct default argument should be sep='? ', since the 
default separator adds a space between print()'s arguments -- that is, 
the default print('foo', 'bar') is equivalent to print('foo', 'bar', 
sep=' '), both producing 'foo bar', and not equivalent to print('foo', 
'bar', sep='') which produces 'foobar'. Links for the pages below:

https://docs.python.org/3.6/library/functions.html#print
https://docs.python.org/3.7/library/functions.html#print

Best,
Gilberto Agostinho

From Nikolai.Ehrhardt at bshg.com  Mon Nov  5 11:06:20 2018
From: Nikolai.Ehrhardt at bshg.com (Ehrhardt, Nikolai (GED-SDD4))
Date: Mon, 5 Nov 2018 16:06:20 +0000
Subject: [docs] Python Documentation 3.7.1 concerning Spinbox
Message-ID: <a723effcc6ca4a9aa258da5d513d940e@SI0SWIEXMB3A.bsh.corp.bshg.com>

Theres no set() command for spinboxes.

Mit freundlichen Gr??en
Nikolai Ehrhardt

BSH Hausger?te GmbH

Im Gewerbepark B10
93059 Regensburg
www.bsh-group.com<http://www.bsh-group.com>

BSH Hausger?te GmbH, Carl-Wery-Str. 34, 81739 M?nchen
Vorsitzender des Aufsichtsrats: Uwe Raschke
Gesch?ftsf?hrung: Dr. Karsten Ottenberg (Vorsitzender), Matthias Ginthum, Johannes N?rger, Dr. Michael Sch?llhorn
Sitz: M?nchen; Registergericht: Amtsgericht M?nchen, HRB 75534
WEEE-Reg.-Nr. DE 57986696

Diese Mitteilung ist ausschlie?lich f?r den beabsichtigten Empf?nger bestimmt. Sie kann Betriebs- oder Gesch?ftsgeheimnisse oder sonstige vertrauliche Informationen enthalten. Jede(r) unberechtigte Gebrauch, Kopie, Weitergabe oder Ver?ffentlichung ist untersagt. Sollten Sie diese E-Mail irrt?mlich erhalten haben, benachrichtigen Sie uns bitte sofort durch Antwortmail und l?schen Sie diese E-Mail nebst etwaigen Anlagen und einschlie?lich aller angefertigten Kopien von Ihrem System.

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181105/1e1b5eae/attachment-0001.html>

From andrewdsearles at gmail.com  Mon Nov  5 13:20:10 2018
From: andrewdsearles at gmail.com (Andrew Searles)
Date: Mon, 5 Nov 2018 13:20:10 -0500
Subject: [docs] Documentation bug: Errors and Exceptions
Message-ID: <CAB=ASMRkDE3juDXKcExz+3mCPQxfwKvddBEV62X8XqRUQdBDxw@mail.gmail.com>

Hi

I was reading the tutorial for python when I noticed a typo!
I have included the link and section for the page:
https://docs.python.org/2/tutorial/errors.html
8.5. User-defined Exceptions

*English error:*
When creating a module that can raise several distinct errors, a common
practice is to create a base class for exceptions defined by that module,
and *subclass that to create *specific exception classes for different
error conditions:
*Possible suggestion:*
When creating a module that can raise several distinct errors, a common
practice is to create a base class for exceptions defined by that module,
and *a subclass to create *specific exception classes for different error
conditions:

Best,
Andrew
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181105/d974ed72/attachment-0001.html>

From lorenz.fischer at web.de  Wed Nov  7 08:05:37 2018
From: lorenz.fischer at web.de (Lorenz Fischer)
Date: Wed, 7 Nov 2018 14:05:37 +0100
Subject: [docs] Documentation Issue: 6.15. Evaluation order , ,
 Python evaluates expressions from left to right."
Message-ID: <224a3da4-8e8c-7128-dac3-22f0ee3e5861@web.de>

The documentation says:


    /6.15. Evaluation order/

/Python evaluates expressions from left to right./

But: Multiple power operators are evaluated right to left.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181107/4b092af7/attachment-0001.html>

From bluepostit101 at gmail.com  Thu Nov  8 08:24:39 2018
From: bluepostit101 at gmail.com (Blue Postit)
Date: Thu, 8 Nov 2018 15:24:39 +0200
Subject: [docs] Python Docs SEO
Message-ID: <5be4391b.1c69fb81.672ac.bc61@mx.google.com>

Hello

It?s quite frustrating that for many given search results (on DuckDuckGo), the first result from the Python documentation is for an old version of Python, usually 2.x.

Here?s an example:


Please fix the SEO ranking of the Python 3 documentation pages. Thanks!

Regards,

bluepostit
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181108/8f567961/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: 493AC132995E4802A7C9FCE898025749.png
Type: image/png
Size: 264320 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20181108/8f567961/attachment-0001.png>

From betsy at python.org  Thu Nov  8 13:28:20 2018
From: betsy at python.org (Betsy Waliszewski)
Date: Thu, 8 Nov 2018 10:28:20 -0800
Subject: [docs] [PSF-Board] Permission to use few programs and part of
 the documentation found in Python.org
In-Reply-To: <CANeMcMJNMEOCPyDBFNCzJkBygK6Rnmx_vwPO5wbT=Ptt_RQUGQ@mail.gmail.com>
References: <CANeMcMJNMEOCPyDBFNCzJkBygK6Rnmx_vwPO5wbT=Ptt_RQUGQ@mail.gmail.com>
Message-ID: <CAKMnukrGnYnGzF_6R3VLtWBY=q9w5Mugr+TBd3wi0pdQgWC=4Q@mail.gmail.com>

Hello Gowrishankar.S,

The Python programming language is open source and is free to use. You can
check out more details about our license here:
https://docs.python.org/3/license.html

Best,

Betsy

On Thu, Nov 1, 2018 at 10:57 AM Gowrishankar S Nath <
gowrishankar at computerengineer.in> wrote:

> Hi,
>
> I would like to introduce myself as Dr.S.Gowrishankar working as Associate
> Professor at the Department of Computer Science and Engineering at
> Dr.Ambedkar Institute of Technology, Bengaluru, India.
>
> I like to adopt a few programs and part of the explanation as it is found
> in the documentation of Python.org for a book I'm working on.
>
> Can you please give permission to use these programs? I'll mention the
> source and give attribute to you.
>
> Please consider our request.
>
> Regards,
> Gowrishankar.S
>
>
>
>
>
>
>
> **************************************************************************Dr.S.Gowrishankar,Associate
> Professor,Department of Computer Science and Engineering,Dr.Ambedkar
> Institute of Technology,Bengaluru-560056, Karnataka, India.*
>
> *Mob: 9986374400*
>
> *http://www.gowrishankarnath.com <http://www.gowrishankarnath.com>*
>
> *Twitter: @g_s_nath*
> ***************************************************************************
> _______________________________________________
> PSF-Board mailing list
> PSF-Board at python.org
> https://mail.python.org/mailman/listinfo/psf-board
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181108/d3a073c5/attachment.html>

From bgailer at gmail.com  Fri Nov  9 14:05:49 2018
From: bgailer at gmail.com (Bob Gailer)
Date: Fri, 9 Nov 2018 14:05:49 -0500
Subject: [docs] Python Docs SEO
In-Reply-To: <5be4391b.1c69fb81.672ac.bc61@mx.google.com>
References: <5be4391b.1c69fb81.672ac.bc61@mx.google.com>
Message-ID: <CAP1rxO61sfigq68DadMC-u+0fGokRN_dDhVSo6D3ZkemsgtcDg@mail.gmail.com>

On Nov 9, 2018 10:42 AM, "Blue Postit" <bluepostit101 at gmail.com> wrote:
>
> Hello
>
>
>
> It?s quite frustrating that for many given search results (on
DuckDuckGo), the first result from the Python documentation is for an old
version of Python, usually 2.x.

Search for " python 3 inheritance"

Bob Gailer
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181109/e347903b/attachment.html>

From report at bugs.python.org  Fri Nov  9 15:13:07 2018
From: report at bugs.python.org (Guido van Rossum)
Date: Fri, 09 Nov 2018 20:13:07 +0000
Subject: [docs] [issue33878] Doc: Assignment statement to tuple or list:
 case missing.
In-Reply-To: <1541766445.71.0.788709270274.issue33878@psf.upfronthosting.co.za>
Message-ID: <CAP7+vJ+4acn=vacfqLoeggYpkTwUgtkfKG6e6euTbGmc2wYYbw@mail.gmail.com>


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

I would like to see this fixed.

On Fri, Nov 9, 2018 at 4:27 AM Serhiy Storchaka <report at bugs.python.org>
wrote:

>
> Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:
>
> I think that the fact that `(a) = 42` is accepted is rather an
> implementation detail, and the consequence of limitations of the grammar
> parser. It accepts arbitrary expression at the left hand side of
> assignment. After transforming CST to AST unsuitable targets are rejected,
> but information about grouping parenthesis is lost at this stage.
>
> This can be fixed if check the left hand side node before converting to
> AST.
>
> ----------
> nosy: +gvanrossum, serhiy.storchaka
>
> _______________________________________
> Python tracker <report at bugs.python.org>
> <https://bugs.python.org/issue33878>
> _______________________________________
>
-- 
--Guido (mobile)

----------

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

From report at bugs.python.org  Fri Nov  9 23:15:13 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Sat, 10 Nov 2018 04:15:13 +0000
Subject: [docs] [issue33878] Doc: Assignment statement to tuple or list:
 case missing.
In-Reply-To: <1529154106.75.0.56676864532.issue33878@psf.upfronthosting.co.za>
Message-ID: <1541823313.79.0.023849094327.issue33878@psf.upfronthosting.co.za>


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


----------
pull_requests: +9719

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

From report at bugs.python.org  Sat Nov 10 09:34:52 2018
From: report at bugs.python.org (Ivan Levkivskyi)
Date: Sat, 10 Nov 2018 14:34:52 +0000
Subject: [docs] [issue35190] collections.abc.Sequence cannot be used to test
 whether a class provides a particular interface
In-Reply-To: <1541688086.42.0.788709270274.issue35190@psf.upfronthosting.co.za>
Message-ID: <1541860492.79.0.788709270274.issue35190@psf.upfronthosting.co.za>


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

The separation may look arbitrary, but the idea is quite simple. Only those classes with few methods support structural checks. Those classes have few independent abstract methods (or even just one method), while in classes with large APIs like `Sequence`, the methods are not logically independent, so you can't say a class is 100% a `Sequence` even if types/signatures of all methods are correct, because e.g. `__contains__()` and `index()` should behave in agreement with `__getitem__()`.

We might explicitly document which ABCs support structural checks, and which require explicit subclassing. Also we might clarify what "abstract methods" and "mixin methods" mean in the table at the top. In the case of `Sequence` one can just implement two abstract methods and the other will behave in a "coordinated way". Then, simple purely abstract classes (called "One-trick ponies" in the source code) support structural checks.

> The collections.abc ? Abstract Base Classes for Containers documentation says:

>> This module provides abstract base classes that can be used to test whether a class provides a particular interface; for example, whether it is hashable or whether it is a mapping.

Btw, Mapping also doesn't support structural checks, so the docs are quite outdated.

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

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

From report at bugs.python.org  Sat Nov 10 18:34:26 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 10 Nov 2018 23:34:26 +0000
Subject: [docs] [issue23220] IDLE: Document how Shell displays user code
 output
In-Reply-To: <1420937687.17.0.885670059147.issue23220@psf.upfronthosting.co.za>
Message-ID: <1541892866.31.0.788709270274.issue23220@psf.upfronthosting.co.za>


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

In the patch for #33000, to cover MacOS behavior, I changed the comment about control chars from 'replaced' to 'replaced or deleted' Users can fill in the details by comparing IDLE on their system to a particular console or terminal.

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

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

From report at bugs.python.org  Sat Nov 10 20:27:38 2018
From: report at bugs.python.org (Emily Morehouse)
Date: Sun, 11 Nov 2018 01:27:38 +0000
Subject: [docs] [issue33878] Doc: Assignment statement to tuple or list:
 case missing.
In-Reply-To: <1529154106.75.0.56676864532.issue33878@psf.upfronthosting.co.za>
Message-ID: <1541899658.71.0.702299269573.issue33878@psf.upfronthosting.co.za>


Change by Emily Morehouse <emilyemorehouse at gmail.com>:


----------
nosy: +emilyemorehouse

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

From report at bugs.python.org  Sun Nov 11 14:33:54 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 11 Nov 2018 19:33:54 +0000
Subject: [docs] [issue33699] Don't describe try's else clause in a footnote
In-Reply-To: <1527709182.68.0.682650639539.issue33699@psf.upfronthosting.co.za>
Message-ID: <1541964834.6.0.788709270274.issue33699@psf.upfronthosting.co.za>


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


New changeset b086c8afdb8c862011e3e27d4c8f6833749f2c56 by Miss Islington (bot) (Andr?s Delfino) in branch 'master':
bpo-33699: Describe try's else clause with the rest of the try clause (GH-7252)
https://github.com/python/cpython/commit/b086c8afdb8c862011e3e27d4c8f6833749f2c56


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

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

From report at bugs.python.org  Sun Nov 11 14:34:03 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 11 Nov 2018 19:34:03 +0000
Subject: [docs] [issue33699] Don't describe try's else clause in a footnote
In-Reply-To: <1527709182.68.0.682650639539.issue33699@psf.upfronthosting.co.za>
Message-ID: <1541964843.16.0.702299269573.issue33699@psf.upfronthosting.co.za>


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


----------
pull_requests: +9738

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

From report at bugs.python.org  Sun Nov 11 14:34:12 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 11 Nov 2018 19:34:12 +0000
Subject: [docs] [issue33699] Don't describe try's else clause in a footnote
In-Reply-To: <1527709182.68.0.682650639539.issue33699@psf.upfronthosting.co.za>
Message-ID: <1541964852.27.0.702299269573.issue33699@psf.upfronthosting.co.za>


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


----------
pull_requests: +9739

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

From report at bugs.python.org  Sun Nov 11 14:43:15 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sun, 11 Nov 2018 19:43:15 +0000
Subject: [docs] [issue33699] Don't describe try's else clause in a footnote
In-Reply-To: <1527709182.68.0.682650639539.issue33699@psf.upfronthosting.co.za>
Message-ID: <1541965395.91.0.788709270274.issue33699@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta at python.org> added the comment:

Just need a manual backport to 2.7, which I'm not doing :) 

If no one is motivated enough to backport to 2.7, I'm fine with that. Otherwise this issue can be closed.

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

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

From report at bugs.python.org  Sun Nov 11 14:43:55 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 11 Nov 2018 19:43:55 +0000
Subject: [docs] [issue33699] Don't describe try's else clause in a footnote
In-Reply-To: <1527709182.68.0.682650639539.issue33699@psf.upfronthosting.co.za>
Message-ID: <1541965435.24.0.788709270274.issue33699@psf.upfronthosting.co.za>


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


New changeset 7d7ff672dfe93a50053166798cdc0fbc86ea63e3 by Miss Islington (bot) in branch '3.7':
bpo-33699: Describe try's else clause with the rest of the try clause (GH-7252)
https://github.com/python/cpython/commit/7d7ff672dfe93a50053166798cdc0fbc86ea63e3


----------

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

From report at bugs.python.org  Sun Nov 11 14:44:34 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 11 Nov 2018 19:44:34 +0000
Subject: [docs] [issue33699] Don't describe try's else clause in a footnote
In-Reply-To: <1527709182.68.0.682650639539.issue33699@psf.upfronthosting.co.za>
Message-ID: <1541965474.23.0.788709270274.issue33699@psf.upfronthosting.co.za>


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


New changeset 3f6a0a292e12f737448a11660da0c880e8f972be by Miss Islington (bot) in branch '3.6':
bpo-33699: Describe try's else clause with the rest of the try clause (GH-7252)
https://github.com/python/cpython/commit/3f6a0a292e12f737448a11660da0c880e8f972be


----------

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

From report at bugs.python.org  Sun Nov 11 14:46:24 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Sun, 11 Nov 2018 19:46:24 +0000
Subject: [docs] [issue33699] Don't describe try's else clause in a footnote
In-Reply-To: <1527709182.68.0.682650639539.issue33699@psf.upfronthosting.co.za>
Message-ID: <1541965584.61.0.788709270274.issue33699@psf.upfronthosting.co.za>


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

I'm doing the 2.7 backport right now :)

----------

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

From report at bugs.python.org  Sun Nov 11 14:56:25 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Sun, 11 Nov 2018 19:56:25 +0000
Subject: [docs] [issue33699] Don't describe try's else clause in a footnote
In-Reply-To: <1527709182.68.0.682650639539.issue33699@psf.upfronthosting.co.za>
Message-ID: <1541966185.45.0.702299269573.issue33699@psf.upfronthosting.co.za>


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


----------
pull_requests: +9740

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

From report at bugs.python.org  Sun Nov 11 15:09:06 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 11 Nov 2018 20:09:06 +0000
Subject: [docs] [issue33699] Don't describe try's else clause in a footnote
In-Reply-To: <1527709182.68.0.682650639539.issue33699@psf.upfronthosting.co.za>
Message-ID: <1541966946.14.0.788709270274.issue33699@psf.upfronthosting.co.za>


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


New changeset fb8eb2c2776efb34523e0a616c6f845a6b975e38 by Miss Islington (bot) (Andr?s Delfino) in branch '2.7':
[2.7] bpo-33699: Describe try's else clause with the rest of the try clause (GH-7252) (GH-10469)
https://github.com/python/cpython/commit/fb8eb2c2776efb34523e0a616c6f845a6b975e38


----------

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

From report at bugs.python.org  Sun Nov 11 18:59:42 2018
From: report at bugs.python.org (Julien Palard)
Date: Sun, 11 Nov 2018 23:59:42 +0000
Subject: [docs] [issue33878] Doc: Assignment statement to tuple or list:
 case missing.
In-Reply-To: <1529154106.75.0.56676864532.issue33878@psf.upfronthosting.co.za>
Message-ID: <1541980782.08.0.788709270274.issue33878@psf.upfronthosting.co.za>


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


New changeset 082875dcd6d482558e5f1da97a1c801d60b3ed5b by Julien Palard in branch 'master':
bpo-33878: Doc: Fix missing case by simplifying. (GH-7762)
https://github.com/python/cpython/commit/082875dcd6d482558e5f1da97a1c801d60b3ed5b


----------

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

From report at bugs.python.org  Sun Nov 11 18:59:50 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 11 Nov 2018 23:59:50 +0000
Subject: [docs] [issue33878] Doc: Assignment statement to tuple or list:
 case missing.
In-Reply-To: <1529154106.75.0.56676864532.issue33878@psf.upfronthosting.co.za>
Message-ID: <1541980790.34.0.702299269573.issue33878@psf.upfronthosting.co.za>


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


----------
pull_requests: +9743

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

From report at bugs.python.org  Sun Nov 11 18:59:59 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 11 Nov 2018 23:59:59 +0000
Subject: [docs] [issue33878] Doc: Assignment statement to tuple or list:
 case missing.
In-Reply-To: <1529154106.75.0.56676864532.issue33878@psf.upfronthosting.co.za>
Message-ID: <1541980799.11.0.702299269573.issue33878@psf.upfronthosting.co.za>


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


----------
pull_requests: +9744

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

From report at bugs.python.org  Sun Nov 11 19:09:26 2018
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 12 Nov 2018 00:09:26 +0000
Subject: [docs] [issue35190] collections.abc.Sequence cannot be used to test
 whether a class provides a particular interface (doc issue)
In-Reply-To: <1541688086.42.0.788709270274.issue35190@psf.upfronthosting.co.za>
Message-ID: <1541981366.4.0.702299269573.issue35190@psf.upfronthosting.co.za>


Change by STINNER Victor <vstinner at redhat.com>:


----------
title: collections.abc.Sequence cannot be used to test whether a class provides a particular interface -> collections.abc.Sequence cannot be used to test whether a class provides a particular interface (doc issue)

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

From report at bugs.python.org  Sun Nov 11 19:24:33 2018
From: report at bugs.python.org (Julien Palard)
Date: Mon, 12 Nov 2018 00:24:33 +0000
Subject: [docs] [issue33878] Doc: Assignment statement to tuple or list:
 case missing.
In-Reply-To: <1529154106.75.0.56676864532.issue33878@psf.upfronthosting.co.za>
Message-ID: <1541982273.91.0.788709270274.issue33878@psf.upfronthosting.co.za>


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


New changeset aa493b5c18463ab45c087564e287643606f004ca by Julien Palard (Miss Islington (bot)) in branch '3.7':
bpo-33878: Doc: Fix missing case by simplifying. (GH-7762)
https://github.com/python/cpython/commit/aa493b5c18463ab45c087564e287643606f004ca


----------

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

From report at bugs.python.org  Sun Nov 11 19:24:44 2018
From: report at bugs.python.org (Julien Palard)
Date: Mon, 12 Nov 2018 00:24:44 +0000
Subject: [docs] [issue33878] Doc: Assignment statement to tuple or list:
 case missing.
In-Reply-To: <1529154106.75.0.56676864532.issue33878@psf.upfronthosting.co.za>
Message-ID: <1541982284.33.0.788709270274.issue33878@psf.upfronthosting.co.za>


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


New changeset d0ebbf4895439233c8398dbdd0456d07132b2a6f by Julien Palard (Miss Islington (bot)) in branch '3.6':
bpo-33878: Doc: Fix missing case by simplifying. (GH-7762)
https://github.com/python/cpython/commit/d0ebbf4895439233c8398dbdd0456d07132b2a6f


----------

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

From report at bugs.python.org  Sun Nov 11 19:37:25 2018
From: report at bugs.python.org (Julien Palard)
Date: Mon, 12 Nov 2018 00:37:25 +0000
Subject: [docs] [issue33878] Doc: Assignment statement to tuple or list:
 case missing.
In-Reply-To: <1529154106.75.0.56676864532.issue33878@psf.upfronthosting.co.za>
Message-ID: <1541983045.71.0.702299269573.issue33878@psf.upfronthosting.co.za>


Change by Julien Palard <julien+python at palard.fr>:


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

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

From report at bugs.python.org  Mon Nov 12 01:42:38 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Mon, 12 Nov 2018 06:42:38 +0000
Subject: [docs] [issue35151] Python 2 xml.etree.ElementTree documentation
 tutorial uses undocumented arguments
In-Reply-To: <1541204418.39.0.788709270274.issue35151@psf.upfronthosting.co.za>
Message-ID: <1542004958.9.0.702299269573.issue35151@psf.upfronthosting.co.za>


Change by Karthikeyan Singaravelan <tir.karthi at gmail.com>:


----------
nosy: +xtreak

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

From report at bugs.python.org  Mon Nov 12 15:45:18 2018
From: report at bugs.python.org (Mathieu Dupuy)
Date: Mon, 12 Nov 2018 20:45:18 +0000
Subject: [docs] [issue35220] delete "how do I emulate os.kill" section in
 Windows FAQ
Message-ID: <1542055518.86.0.788709270274.issue35220@psf.upfronthosting.co.za>


New submission from Mathieu Dupuy <deronnax at gmail.com>:

That section is a tip on how to kill process on Windows for Python prior to 2.7 and 3.2.
3.1 end of support was April 2012 and 2.6 was October 2013, so that hasn't been needed for supported versions of Python for more than 5 years. Beside not being needed anymore for a long time, when I read it with the eyes of a Python profane, it makes Python looks bad, like a language from the pasts with warts you need to circumvent.
Let's delete that.

----------
assignee: docs at python
components: Documentation
messages: 329751
nosy: deronnax, docs at python
priority: normal
pull_requests: 9750
severity: normal
status: open
title: delete "how do I emulate os.kill" section in Windows FAQ
type: enhancement
versions: Python 3.8

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

From report at bugs.python.org  Mon Nov 12 18:34:30 2018
From: report at bugs.python.org (Lysandros Nikolaou)
Date: Mon, 12 Nov 2018 23:34:30 +0000
Subject: [docs] [issue25438] document what codec PyMemberDef T_STRING
 decodes the char * as
In-Reply-To: <1445236924.11.0.92849861938.issue25438@psf.upfronthosting.co.za>
Message-ID: <1542065670.9.0.788709270274.issue25438@psf.upfronthosting.co.za>


Lysandros Nikolaou <lisandrosnik at gmail.com> added the comment:

It's been more than 3 years, since this was opened, but I will ask nevertheless. Should a PR maybe made for this issue?

----------
nosy: +lys.nikolaou

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

From report at bugs.python.org  Mon Nov 12 18:44:13 2018
From: report at bugs.python.org (Gregory P. Smith)
Date: Mon, 12 Nov 2018 23:44:13 +0000
Subject: [docs] [issue25438] document what codec PyMemberDef T_STRING
 decodes the char * as
In-Reply-To: <1445236924.11.0.92849861938.issue25438@psf.upfronthosting.co.za>
Message-ID: <1542066253.65.0.788709270274.issue25438@psf.upfronthosting.co.za>


Gregory P. Smith <greg at krypto.org> added the comment:

it still seems relevant, having better docs is always good.

----------

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

From report at bugs.python.org  Mon Nov 12 20:56:09 2018
From: report at bugs.python.org (Windson Yang)
Date: Tue, 13 Nov 2018 01:56:09 +0000
Subject: [docs] [issue25438] document what codec PyMemberDef T_STRING
 decodes the char * as
In-Reply-To: <1445236924.11.0.92849861938.issue25438@psf.upfronthosting.co.za>
Message-ID: <1542074169.49.0.788709270274.issue25438@psf.upfronthosting.co.za>


Windson Yang <wiwindson at outlook.com> added the comment:

I will work on it today :D

----------
nosy: +Windson Yang

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

From report at bugs.python.org  Tue Nov 13 06:06:57 2018
From: report at bugs.python.org (Christian Ullrich)
Date: Tue, 13 Nov 2018 11:06:57 +0000
Subject: [docs] [issue35228] Index search in CHM help crashes viewer
Message-ID: <1542107217.87.0.788709270274.issue35228@psf.upfronthosting.co.za>


New submission from Christian Ullrich <chris at chrullrich.net>:

Typing into the index keyword field frequently crashes the CHM viewer with the first or second character. The Python CHMs are the only ones that I see this crash with; it started around 3.6 or so.

>From event log:

Faulting application name: hh.exe, version: 10.0.17134.1, time stamp: 0xa0eff942
Faulting module name: hhctrl.ocx, version: 10.0.17134.48, time stamp: 0x412ce02a
Exception code: 0xc0000005
Fault offset: 0x00000000000387b2
Faulting process ID: 0x3558
Faulting application start time: 0x01d47b3f8db53eef
Faulting application path: C:\Windows\hh.exe
Faulting module path: C:\Windows\System32\hhctrl.ocx
Report ID: 53f84d38-adb4-4c0b-bd45-9bce02406e6f
Faulting package full name: 
Faulting package-relative application ID: 

This particular crash involved the file from 3.7.1:

sha1(doc\python371.chm) = 1c0e2d861cadc759436bfac0a767c5bb633423f9

----------
assignee: docs at python
components: Documentation, Windows
messages: 329824
nosy: chrullrich, docs at python, paul.moore, steve.dower, tim.golden, zach.ware
priority: normal
severity: normal
status: open
title: Index search in CHM help crashes viewer
type: behavior
versions: Python 3.7

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

From report at bugs.python.org  Tue Nov 13 08:06:07 2018
From: report at bugs.python.org (Lysandros Nikolaou)
Date: Tue, 13 Nov 2018 13:06:07 +0000
Subject: [docs] [issue17972] inspect module docs omits many functions
In-Reply-To: <1368501068.91.0.677640111487.issue17972@psf.upfronthosting.co.za>
Message-ID: <1542114367.41.0.788709270274.issue17972@psf.upfronthosting.co.za>


Lysandros Nikolaou <lisandrosnik at gmail.com> added the comment:

I think this issue should be discussed once more. I am not sure it's worth defining __all__, but then we would have to include them in the docs. If you think __all__ should be defined instead, then I could go through the trouble of doing so. Could a core developer maybe offer their opinion here?

----------
nosy: +lys.nikolaou

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

From report at bugs.python.org  Tue Nov 13 08:08:23 2018
From: report at bugs.python.org (Lysandros Nikolaou)
Date: Tue, 13 Nov 2018 13:08:23 +0000
Subject: [docs] [issue17972] inspect module docs omits many functions
In-Reply-To: <1368501068.91.0.677640111487.issue17972@psf.upfronthosting.co.za>
Message-ID: <1542114503.84.0.788709270274.issue17972@psf.upfronthosting.co.za>


Lysandros Nikolaou <lisandrosnik at gmail.com> added the comment:

...but then we would have to include them in the docs... should be *but then we would have to include all the public functions in the docs*.

----------

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

From report at bugs.python.org  Tue Nov 13 14:40:10 2018
From: report at bugs.python.org (Anjali Malik)
Date: Tue, 13 Nov 2018 19:40:10 +0000
Subject: [docs] [issue16438] Numeric operator predecence confusing
In-Reply-To: <1352384371.29.0.086289583253.issue16438@psf.upfronthosting.co.za>
Message-ID: <1542138010.65.0.702299269573.issue16438@psf.upfronthosting.co.za>


Change by Anjali Malik <anjaliimalik at outlook.com>:


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

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

From report at bugs.python.org  Tue Nov 13 18:44:33 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Tue, 13 Nov 2018 23:44:33 +0000
Subject: [docs] [issue16438] Numeric operator predecence confusing
In-Reply-To: <1352384371.29.0.086289583253.issue16438@psf.upfronthosting.co.za>
Message-ID: <1542152673.07.0.788709270274.issue16438@psf.upfronthosting.co.za>


Mariatta Wijaya <mariatta at python.org> added the comment:

I'm actually thinking perhaps the "see :ref:`operator-summary`" clause should be separate and under Notes below the table, as opposed to current PR:

```
All numeric types (except complex) support the following operations (for priorities of
the operations, see :ref:`operator-summary`)
```

reads oddly to me.

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

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

From report at bugs.python.org  Wed Nov 14 15:40:45 2018
From: report at bugs.python.org (Shane)
Date: Wed, 14 Nov 2018 20:40:45 +0000
Subject: [docs] [issue35250] Minor parameter documentation mismatch for
 turtle
Message-ID: <1542228045.84.0.788709270274.issue35250@psf.upfronthosting.co.za>


New submission from Shane <shanesmith4 at gmail.com>:

I noticed a slight mismatch in the parameter documentation for one of turtle's functions.  onclick() accepts the parameters (fun, btn, add), but the documentation describes the parameters (fun, num, add).  A minor issue, to be sure, but I wanted to point it out since I just noticed it.  I'm using Python 3.7.1 but I suspect it's not isolated to that.

>>> help(turtle.Turtle().onclick)
Help on method onclick in module turtle:

onclick(fun, btn=1, add=None) method of turtle.Turtle instance
    Bind fun to mouse-click event on this turtle on canvas.
    
    Arguments:
    fun --  a function with two arguments, to which will be assigned
            the coordinates of the clicked point on the canvas.
    num --  number of the mouse-button defaults to 1 (left mouse button).
    add --  True or False. If True, new binding will be added, otherwise
            it will replace a former binding.

----------
assignee: docs at python
components: Documentation
messages: 329932
nosy: Shane Smith, docs at python
priority: normal
severity: normal
status: open
title: Minor parameter documentation mismatch for turtle

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

From report at bugs.python.org  Thu Nov 15 06:33:32 2018
From: report at bugs.python.org (Mathieu Dupuy)
Date: Thu, 15 Nov 2018 11:33:32 +0000
Subject: [docs] [issue35255] delete "How do I extract the downloaded
 documentation" section in Windows FAQ
In-Reply-To: <1542281478.85.0.788709270274.issue35255@psf.upfronthosting.co.za>
Message-ID: <1542281612.03.0.702299269573.issue35255@psf.upfronthosting.co.za>


Change by Mathieu Dupuy <deronnax at gmail.com>:


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

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

From report at bugs.python.org  Thu Nov 15 08:06:50 2018
From: report at bugs.python.org (Mathieu Dupuy)
Date: Thu, 15 Nov 2018 13:06:50 +0000
Subject: [docs] [issue35255] delete "How do I extract the downloaded
 documentation" section in Windows FAQ
In-Reply-To: <1542281478.85.0.788709270274.issue35255@psf.upfronthosting.co.za>
Message-ID: <1542287210.61.0.702299269573.issue35255@psf.upfronthosting.co.za>


Change by Mathieu Dupuy <deronnax at gmail.com>:


----------
pull_requests: +9802

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

From report at bugs.python.org  Thu Nov 15 09:03:06 2018
From: report at bugs.python.org (Julien Palard)
Date: Thu, 15 Nov 2018 14:03:06 +0000
Subject: [docs] [issue31146] Docs: On non-public translations,
 language picker fallback to "English"
In-Reply-To: <1502206180.29.0.859774070814.issue31146@psf.upfronthosting.co.za>
Message-ID: <1542290586.86.0.702299269573.issue31146@psf.upfronthosting.co.za>


Change by Julien Palard <julien+python at palard.fr>:


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

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

From report at bugs.python.org  Thu Nov 15 17:05:13 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 15 Nov 2018 22:05:13 +0000
Subject: [docs] [issue9056] Adding additional level of bookmarks and section
 numbers in python pdf documents.
In-Reply-To: <1277175637.31.0.472126376822.issue9056@psf.upfronthosting.co.za>
Message-ID: <1542319513.63.0.702299269573.issue9056@psf.upfronthosting.co.za>


Change by Cheryl Sabella <cheryl.sabella at gmail.com>:


----------
nosy: +cheryl.sabella, mdk
versions: +Python 3.8 -Python 3.3

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

From report at bugs.python.org  Fri Nov 16 00:33:01 2018
From: report at bugs.python.org (Windson Yang)
Date: Fri, 16 Nov 2018 05:33:01 +0000
Subject: [docs] [issue35250] Minor parameter documentation mismatch for
 turtle
In-Reply-To: <1542228045.84.0.788709270274.issue35250@psf.upfronthosting.co.za>
Message-ID: <1542346380.93.0.788709270274.issue35250@psf.upfronthosting.co.za>


Windson Yang <wiwindson at outlook.com> added the comment:

Yes, you are right. A quick fix would change 'num' to 'btn' in parameters in
 https://docs.python.org/3.3/library/turtle.html?highlight=turtle#turtle.onclick. I think they are the same thing. Do you want to create a patch?

----------
nosy: +Windson Yang

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

From report at bugs.python.org  Fri Nov 16 04:59:04 2018
From: report at bugs.python.org (=?utf-8?b?U3Jpbml2YXMgIFJlZGR5IFRoYXRpcGFydGh5KOCwtuCxjeCwsOCxgOCwqA==?= =?utf-8?b?4LC/4LC14LC+4LC44LGNIOCwsOCxhuCwoeCxjeCwoeCwvyDgsKTgsL7gsJ8=?= =?utf-8?b?4LC/4LCq4LCw4LGN4LCk4LC/KQ==?=)
Date: Fri, 16 Nov 2018 09:59:04 +0000
Subject: [docs] [issue35250] Minor parameter documentation mismatch for
 turtle
In-Reply-To: <1542228045.84.0.788709270274.issue35250@psf.upfronthosting.co.za>
Message-ID: <1542362344.08.0.702299269573.issue35250@psf.upfronthosting.co.za>


Change by Srinivas  Reddy Thatiparthy(?????????? ?????? ?????????) <thatiparthysreenivas at gmail.com>:


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

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

From report at bugs.python.org  Fri Nov 16 06:42:04 2018
From: report at bugs.python.org (INADA Naoki)
Date: Fri, 16 Nov 2018 11:42:04 +0000
Subject: [docs] [issue33816] New metaclass example for Data Model topic
In-Reply-To: <1528567160.68.0.592728768989.issue33816@psf.upfronthosting.co.za>
Message-ID: <1542368524.05.0.788709270274.issue33816@psf.upfronthosting.co.za>


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


New changeset c2ccac7b9f9a1132ca36255b0ddfeecef4371aa3 by INADA Naoki (Andr?s Delfino) in branch 'master':
bpo-33816: Remove outdated metaclass example (GH-7566)
https://github.com/python/cpython/commit/c2ccac7b9f9a1132ca36255b0ddfeecef4371aa3


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

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

From report at bugs.python.org  Fri Nov 16 06:42:13 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 16 Nov 2018 11:42:13 +0000
Subject: [docs] [issue33816] New metaclass example for Data Model topic
In-Reply-To: <1528567160.68.0.592728768989.issue33816@psf.upfronthosting.co.za>
Message-ID: <1542368533.69.0.702299269573.issue33816@psf.upfronthosting.co.za>


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


----------
pull_requests: +9816

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

From report at bugs.python.org  Fri Nov 16 06:42:25 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 16 Nov 2018 11:42:25 +0000
Subject: [docs] [issue33816] New metaclass example for Data Model topic
In-Reply-To: <1528567160.68.0.592728768989.issue33816@psf.upfronthosting.co.za>
Message-ID: <1542368545.64.0.702299269573.issue33816@psf.upfronthosting.co.za>


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


----------
pull_requests: +9817

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

From report at bugs.python.org  Fri Nov 16 06:51:23 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 16 Nov 2018 11:51:23 +0000
Subject: [docs] [issue33816] New metaclass example for Data Model topic
In-Reply-To: <1528567160.68.0.592728768989.issue33816@psf.upfronthosting.co.za>
Message-ID: <1542369083.01.0.788709270274.issue33816@psf.upfronthosting.co.za>


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


New changeset 1b80a373d104480c51cacb8b07ec3b61e21d5fa0 by Miss Islington (bot) in branch '3.7':
bpo-33816: Remove outdated metaclass example (GH-7566)
https://github.com/python/cpython/commit/1b80a373d104480c51cacb8b07ec3b61e21d5fa0


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

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

From report at bugs.python.org  Fri Nov 16 06:58:12 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 16 Nov 2018 11:58:12 +0000
Subject: [docs] [issue33816] New metaclass example for Data Model topic
In-Reply-To: <1528567160.68.0.592728768989.issue33816@psf.upfronthosting.co.za>
Message-ID: <1542369492.23.0.788709270274.issue33816@psf.upfronthosting.co.za>


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


New changeset 46fa7a60e08fc7486ecab726af93fa2cfe225305 by Miss Islington (bot) in branch '3.6':
bpo-33816: Remove outdated metaclass example (GH-7566)
https://github.com/python/cpython/commit/46fa7a60e08fc7486ecab726af93fa2cfe225305


----------

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

From report at bugs.python.org  Fri Nov 16 08:29:05 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 16 Nov 2018 13:29:05 +0000
Subject: [docs] [issue35250] Minor parameter documentation mismatch for
 turtle
In-Reply-To: <1542228045.84.0.788709270274.issue35250@psf.upfronthosting.co.za>
Message-ID: <1542374945.68.0.702299269573.issue35250@psf.upfronthosting.co.za>


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


----------
pull_requests: +9819

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

From report at bugs.python.org  Fri Nov 16 08:29:18 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 16 Nov 2018 13:29:18 +0000
Subject: [docs] [issue35250] Minor parameter documentation mismatch for
 turtle
In-Reply-To: <1542228045.84.0.788709270274.issue35250@psf.upfronthosting.co.za>
Message-ID: <1542374958.05.0.702299269573.issue35250@psf.upfronthosting.co.za>


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


----------
pull_requests: +9820

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

From report at bugs.python.org  Fri Nov 16 08:55:17 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 16 Nov 2018 13:55:17 +0000
Subject: [docs] [issue35250] Minor parameter documentation mismatch for
 turtle
In-Reply-To: <1542228045.84.0.788709270274.issue35250@psf.upfronthosting.co.za>
Message-ID: <1542376516.97.0.788709270274.issue35250@psf.upfronthosting.co.za>


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


New changeset 0461c3b635d53e8e75145695803a2fca288a1689 by Miss Islington (bot) in branch '3.7':
bpo-35250: Correct argument name "num" -> "btn" in turtle docs. (GH-10565)
https://github.com/python/cpython/commit/0461c3b635d53e8e75145695803a2fca288a1689


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

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

From report at bugs.python.org  Fri Nov 16 08:56:36 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 16 Nov 2018 13:56:36 +0000
Subject: [docs] [issue35250] Minor parameter documentation mismatch for
 turtle
In-Reply-To: <1542228045.84.0.788709270274.issue35250@psf.upfronthosting.co.za>
Message-ID: <1542376596.39.0.788709270274.issue35250@psf.upfronthosting.co.za>


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


New changeset 8856246c41b0663bfe8d3af7d52a7c337e25572d by Miss Islington (bot) in branch '3.6':
bpo-35250: Correct argument name "num" -> "btn" in turtle docs. (GH-10565)
https://github.com/python/cpython/commit/8856246c41b0663bfe8d3af7d52a7c337e25572d


----------

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

From report at bugs.python.org  Fri Nov 16 09:05:11 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 16 Nov 2018 14:05:11 +0000
Subject: [docs] [issue24653] Mock.assert_has_calls([]) is surprising for
 users
In-Reply-To: <1437126004.09.0.453747784975.issue24653@psf.upfronthosting.co.za>
Message-ID: <1542377111.23.0.788709270274.issue24653@psf.upfronthosting.co.za>


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

Why this case should be explicitly mentioned? Is it an exception from some rules? Is the empty list special? Does existing documentation say that assert_has_calls([]) should raise an exception?

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

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

From report at bugs.python.org  Fri Nov 16 13:30:00 2018
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 16 Nov 2018 18:30:00 +0000
Subject: [docs] [issue35250] Minor parameter documentation mismatch for
 turtle
In-Reply-To: <1542228045.84.0.788709270274.issue35250@psf.upfronthosting.co.za>
Message-ID: <1542393000.91.0.788709270274.issue35250@psf.upfronthosting.co.za>


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

There is an HTML escaping problem in the PR list!

----------
nosy: +eric.araujo, ezio.melotti

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

From report at bugs.python.org  Fri Nov 16 22:34:44 2018
From: report at bugs.python.org (Windson Yang)
Date: Sat, 17 Nov 2018 03:34:44 +0000
Subject: [docs] [issue25438] document what codec PyMemberDef T_STRING
 decodes the char * as
In-Reply-To: <1445236924.11.0.92849861938.issue25438@psf.upfronthosting.co.za>
Message-ID: <1542425684.4.0.702299269573.issue25438@psf.upfronthosting.co.za>


Change by Windson Yang <wiwindson at outlook.com>:


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

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

From report at bugs.python.org  Fri Nov 16 22:34:48 2018
From: report at bugs.python.org (Windson Yang)
Date: Sat, 17 Nov 2018 03:34:48 +0000
Subject: [docs] [issue25438] document what codec PyMemberDef T_STRING
 decodes the char * as
In-Reply-To: <1445236924.11.0.92849861938.issue25438@psf.upfronthosting.co.za>
Message-ID: <1542425688.87.0.702299269573.issue25438@psf.upfronthosting.co.za>


Change by Windson Yang <wiwindson at outlook.com>:


----------
keywords: +patch, patch
pull_requests: +9824, 9826
stage: needs patch -> patch review

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

From report at bugs.python.org  Fri Nov 16 22:34:53 2018
From: report at bugs.python.org (Windson Yang)
Date: Sat, 17 Nov 2018 03:34:53 +0000
Subject: [docs] [issue25438] document what codec PyMemberDef T_STRING
 decodes the char * as
In-Reply-To: <1445236924.11.0.92849861938.issue25438@psf.upfronthosting.co.za>
Message-ID: <1542425693.92.0.702299269573.issue25438@psf.upfronthosting.co.za>


Change by Windson Yang <wiwindson at outlook.com>:


----------
keywords: +patch, patch, patch
pull_requests: +9824, 9825, 9826
stage: needs patch -> patch review

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

From report at bugs.python.org  Sat Nov 17 14:16:54 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 17 Nov 2018 19:16:54 +0000
Subject: [docs] [issue25438] document what codec PyMemberDef T_STRING
 decodes the char * as
In-Reply-To: <1445236924.11.0.92849861938.issue25438@psf.upfronthosting.co.za>
Message-ID: <1542482213.87.0.788709270274.issue25438@psf.upfronthosting.co.za>


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


New changeset 689d555ec135d4115574addd063c358ac4897cc4 by Miss Islington (bot) (Windson yang) in branch 'master':
bpo-25438: document what codec PyMemberDef T_STRING decodes the char * as (GH-10580)
https://github.com/python/cpython/commit/689d555ec135d4115574addd063c358ac4897cc4


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

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

From report at bugs.python.org  Sat Nov 17 14:17:09 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 17 Nov 2018 19:17:09 +0000
Subject: [docs] [issue25438] document what codec PyMemberDef T_STRING
 decodes the char * as
In-Reply-To: <1445236924.11.0.92849861938.issue25438@psf.upfronthosting.co.za>
Message-ID: <1542482229.28.0.702299269573.issue25438@psf.upfronthosting.co.za>


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


----------
pull_requests: +9830

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

From report at bugs.python.org  Sat Nov 17 14:17:19 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 17 Nov 2018 19:17:19 +0000
Subject: [docs] [issue25438] document what codec PyMemberDef T_STRING
 decodes the char * as
In-Reply-To: <1445236924.11.0.92849861938.issue25438@psf.upfronthosting.co.za>
Message-ID: <1542482239.32.0.702299269573.issue25438@psf.upfronthosting.co.za>


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


----------
pull_requests: +9831

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

From report at bugs.python.org  Sat Nov 17 14:50:01 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 17 Nov 2018 19:50:01 +0000
Subject: [docs] [issue25438] document what codec PyMemberDef T_STRING
 decodes the char * as
In-Reply-To: <1445236924.11.0.92849861938.issue25438@psf.upfronthosting.co.za>
Message-ID: <1542484201.65.0.788709270274.issue25438@psf.upfronthosting.co.za>


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


New changeset d1a97b36595726074a83452e5c476806936becba by Miss Islington (bot) in branch '3.7':
[3.7] bpo-25438: document what codec PyMemberDef T_STRING decodes the char * as (GH-10580) (GH-10586)
https://github.com/python/cpython/commit/d1a97b36595726074a83452e5c476806936becba


----------

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

From report at bugs.python.org  Sat Nov 17 14:50:28 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 17 Nov 2018 19:50:28 +0000
Subject: [docs] [issue25438] document what codec PyMemberDef T_STRING
 decodes the char * as
In-Reply-To: <1445236924.11.0.92849861938.issue25438@psf.upfronthosting.co.za>
Message-ID: <1542484228.1.0.788709270274.issue25438@psf.upfronthosting.co.za>


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


New changeset 8945017be4cc9527767bb66673e73e28e4b0b4d3 by Miss Islington (bot) in branch '3.6':
[3.6] bpo-25438: document what codec PyMemberDef T_STRING decodes the char * as (GH-10580) (GH-10587)
https://github.com/python/cpython/commit/8945017be4cc9527767bb66673e73e28e4b0b4d3


----------

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

From report at bugs.python.org  Sat Nov 17 14:51:01 2018
From: report at bugs.python.org (Gregory P. Smith)
Date: Sat, 17 Nov 2018 19:51:01 +0000
Subject: [docs] [issue25438] document what codec PyMemberDef T_STRING
 decodes the char * as
In-Reply-To: <1445236924.11.0.92849861938.issue25438@psf.upfronthosting.co.za>
Message-ID: <1542484261.93.0.702299269573.issue25438@psf.upfronthosting.co.za>


Change by Gregory P. Smith <greg at krypto.org>:


----------
resolution:  -> fixed
stage: patch review -> commit review
status: open -> closed
versions: +Python 3.7, Python 3.8 -Python 3.4, Python 3.5

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

From report at bugs.python.org  Sun Nov 18 12:28:37 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 18 Nov 2018 17:28:37 +0000
Subject: [docs] [issue9842] Document ... used in recursive repr of containers
In-Reply-To: <1284336324.93.0.400210409006.issue9842@psf.upfronthosting.co.za>
Message-ID: <1542562117.92.0.788709270274.issue9842@psf.upfronthosting.co.za>


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

Could anybody please look at PR 10330?

----------

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

From report at bugs.python.org  Sun Nov 18 12:45:32 2018
From: report at bugs.python.org (Sanyam Khurana)
Date: Sun, 18 Nov 2018 17:45:32 +0000
Subject: [docs] [issue32035] Documentation of zipfile.ZipFile().writestr()
 fails to mention that 'data' may also be bytes
In-Reply-To: <1510757660.91.0.213398074469.issue32035@psf.upfronthosting.co.za>
Message-ID: <1542563132.57.0.788709270274.issue32035@psf.upfronthosting.co.za>


Sanyam Khurana <sanyam.khurana01 at gmail.com> added the comment:

The change in current PR is very minor and looks good enough that aligns the docs with the docstring and functionality of `ZipFile.writestr` as described.

Can a core-contributor, please look at this?

Also, I'm adding 3.8 for this change.

----------
nosy: +CuriousLearner
versions: +Python 3.8

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

From report at bugs.python.org  Sun Nov 18 14:08:59 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 18 Nov 2018 19:08:59 +0000
Subject: [docs] [issue32035] Documentation of zipfile.ZipFile().writestr()
 fails to mention that 'data' may also be bytes
In-Reply-To: <1510757660.91.0.213398074469.issue32035@psf.upfronthosting.co.za>
Message-ID: <1542568139.3.0.702299269573.issue32035@psf.upfronthosting.co.za>


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


----------
pull_requests: +9838

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

From report at bugs.python.org  Sun Nov 18 14:11:19 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 18 Nov 2018 19:11:19 +0000
Subject: [docs] [issue32035] Documentation of zipfile.ZipFile().writestr()
 fails to mention that 'data' may also be bytes
In-Reply-To: <1510757660.91.0.213398074469.issue32035@psf.upfronthosting.co.za>
Message-ID: <1542568279.21.0.788709270274.issue32035@psf.upfronthosting.co.za>


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

Since the docstring contains more information, it is better to just copy words from the docstring to the documentation.

There are also other places where string is improperly used instead of bytes or the type is not specified. The note about file name encoding doesn't make sense in Python 3, since ZipFile.write() doesn't support bytes as a file name.

PR 10592 fixed this.

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

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

From report at bugs.python.org  Mon Nov 19 06:50:11 2018
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 19 Nov 2018 11:50:11 +0000
Subject: [docs] [issue35276] Document thread safety
Message-ID: <1542628208.58.0.788709270274.issue35276@psf.upfronthosting.co.za>


New submission from STINNER Victor <vstinner at redhat.com>:

Many developers only discover that a Python function/module is not thread safe because they have a bug in production...

Some examples:

* bpo-7672: ssl
* bpo-8865: select.poll is not thread safe
* bpo-539175, bpo-21216: socket.gethostbyname()
* bpo-7980: time.strptime()
* bpo-6647: warnings.catch_warnings()
* bpo-11077, bpo-33479: Tkinter
* bpo-1336, bpo-19809: subprocess on Python 2
* bpo-15329: deque
* bpo-35275: os.umask()

Hopefully, sometimes it was possible to fix it:

* bpo-3139: bytearray, buffer protocol
* bpo-28969: @functools.lru_cache
* bpo-21291: subprocess.Popen.wait()

In the asyncio documentation, I explicitly documented that, by design, most classes are not thread-safe. For example, asyncio.Lock() is *NOT* thread-safe:
https://docs.python.org/dev/library/asyncio-sync.html#asyncio.Lock

Maybe we should start to use a standard way to describe "thread safety". See "POSIX Safety Concepts" of the GNU libc:

https://www.gnu.org/software/libc/manual/html_node/POSIX-Safety-Concepts.html#POSIX-Safety-Concepts

Example with setlocale, "MT-Unsafe":

https://www.gnu.org/software/libc/manual/html_node/Setting-the-Locale.html

--

My own (incomplete) list of "process-wide states":
https://vstinner.readthedocs.io/threads.html#process-wide

----------
assignee: docs at python
components: Documentation
messages: 330093
nosy: docs at python, vstinner
priority: normal
severity: normal
status: open
title: Document thread safety
versions: Python 3.8

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

From report at bugs.python.org  Mon Nov 19 06:53:08 2018
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 19 Nov 2018 11:53:08 +0000
Subject: [docs] [issue35276] Document thread safety
In-Reply-To: <1542628208.58.0.788709270274.issue35276@psf.upfronthosting.co.za>
Message-ID: <1542628388.2.0.788709270274.issue35276@psf.upfronthosting.co.za>


STINNER Victor <vstinner at redhat.com> added the comment:

"Proces-wide" vs "thread-safe" is one thing. Another interesting property is "reentrant", but maybe that's too wide?

Somehow related, iterating on a container and modify it may or may not work depending on the container type and the kind of modifications.

--

> bpo-8865: select.poll is not thread safe

I checked select documentation, it doesn't mention "thread" anywhere :-(

https://docs.python.org/dev/library/select.html#poll-objects

----------

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

From report at bugs.python.org  Mon Nov 19 14:14:33 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 19 Nov 2018 19:14:33 +0000
Subject: [docs] [issue35276] Document thread safety
In-Reply-To: <1542628208.58.0.788709270274.issue35276@psf.upfronthosting.co.za>
Message-ID: <1542654873.03.0.788709270274.issue35276@psf.upfronthosting.co.za>


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

The general rule in Python is that nothing can be considered atomic unless specifically documented as atomic (such as the queue module or lru_cache which have internal locks).  The only safe action is to put locks around all accesses to shared resources.  We should have a FAQ entry to that effect.  It should also note that "thread-safe" means different things to different people.

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

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

From report at bugs.python.org  Mon Nov 19 17:13:05 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 19 Nov 2018 22:13:05 +0000
Subject: [docs] [issue35276] Document thread safety
In-Reply-To: <1542628208.58.0.788709270274.issue35276@psf.upfronthosting.co.za>
Message-ID: <1542665585.63.0.788709270274.issue35276@psf.upfronthosting.co.za>


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

One idea is that you could author a threading HOWTO document that covers atomicity, locks, queues, reentrancy, etc.  This is a thorny topic and it would be nice to have the principles and techniques collected in one place.

Ideally, it would include examples of what to expect in various situations.  For example, the pure python OrderedDict can be put in an inconsistent state if two threads make updates without a mutex; however, the containers implemented in C can never be broken even if they don't guarantee atomicity (i.e. a dict update making a pure python callback to __hash__ will never result in a broken dict).

ISTM that the docs have presumed that people using threading know what they're doing; however, we know that isn't always true ;-)

----------

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

From report at bugs.python.org  Mon Nov 19 19:27:33 2018
From: report at bugs.python.org (Windson Yang)
Date: Tue, 20 Nov 2018 00:27:33 +0000
Subject: [docs] [issue35251] FTPHandler.ftp_open documentation error
In-Reply-To: <1542233187.5.0.788709270274.issue35251@psf.upfronthosting.co.za>
Message-ID: <1542673653.04.0.702299269573.issue35251@psf.upfronthosting.co.za>


Change by Windson Yang <wiwindson at outlook.com>:


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

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

From report at bugs.python.org  Tue Nov 20 05:21:15 2018
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 20 Nov 2018 10:21:15 +0000
Subject: [docs] [issue35276] Document thread safety
In-Reply-To: <1542628208.58.0.788709270274.issue35276@psf.upfronthosting.co.za>
Message-ID: <1542709275.26.0.788709270274.issue35276@psf.upfronthosting.co.za>


STINNER Victor <vstinner at redhat.com> added the comment:

I don't think that it would make sense to annotate *each* function in the documentation, that would require too much work. I suggest to start to annotate functions which are known to have "side effects" or are not safe whereas users can be surprised to read that they are unsafe in the context of multithreading.

For example, document that os.chdir() is "process-wide" (I'm not sure how to document it). I think that everybody agrees that it's the case, and IMHO it's an useful information. At least, one user has been surprised to read that os.umask() is process-wide:

"I would be great, if the python standard library would provide correspondig thread safe method."
https://bugs.python.org/issue35275

> One idea is that you could author a threading HOWTO document that covers atomicity, locks, queues, reentrancy, etc.  This is a thorny topic and it would be nice to have the principles and techniques collected in one place.

Yes. About the definition of atomicity, thread-safe, process-wide, etc. There is an existing example: contextlib describes "Reentrant context managers".
https://docs.python.org/dev/library/contextlib.html#reentrant-cms

> Ideally, it would include examples of what to expect in various situations.  For example, the pure python OrderedDict can be put in an inconsistent state if two threads make updates without a mutex; however, the containers implemented in C can never be broken even if they don't guarantee atomicity (i.e. a dict update making a pure python callback to __hash__ will never result in a broken dict).

This is where Python becomes obscure. Depending on the implementation, a method can be atomic or not :-/ Maybe atomicity should be documented as a "CPython implementation detail"!?

> ISTM that the docs have presumed that people using threading know what they're doing; however, we know that isn't always true ;-)

I don't understand threads and I have no idea which method are thread-safe or not. Each time, I should look at the doc, read the implementation, etc. :-)

----------

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

From report at bugs.python.org  Tue Nov 20 08:24:19 2018
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 20 Nov 2018 13:24:19 +0000
Subject: [docs] [issue35276] Document thread safety
In-Reply-To: <1542628208.58.0.788709270274.issue35276@psf.upfronthosting.co.za>
Message-ID: <1542720259.95.0.788709270274.issue35276@psf.upfronthosting.co.za>


STINNER Victor <vstinner at redhat.com> added the comment:

Aha, another strange beast: in Python 3, locale.localeconv() now changes temporarily the LC_CTYPE locale is some cases, and this change affects other threads. That's not something expected.

----------

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

From report at bugs.python.org  Tue Nov 20 11:18:41 2018
From: report at bugs.python.org (Julien Palard)
Date: Tue, 20 Nov 2018 16:18:41 +0000
Subject: [docs] [issue31146] Docs: On non-public translations,
 language picker fallback to "English"
In-Reply-To: <1502206180.29.0.859774070814.issue31146@psf.upfronthosting.co.za>
Message-ID: <1542730721.71.0.788709270274.issue31146@psf.upfronthosting.co.za>


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


New changeset 6b73bb523a176123a819e4ebac3727d31d861515 by Julien Palard in branch 'master':
bpo-31146: Don't fallback switcher to english on not-yet pusblished languages. (GH-10558)
https://github.com/python/cpython/commit/6b73bb523a176123a819e4ebac3727d31d861515


----------

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

From report at bugs.python.org  Tue Nov 20 11:19:05 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 20 Nov 2018 16:19:05 +0000
Subject: [docs] [issue31146] Docs: On non-public translations,
 language picker fallback to "English"
In-Reply-To: <1502206180.29.0.859774070814.issue31146@psf.upfronthosting.co.za>
Message-ID: <1542730745.8.0.702299269573.issue31146@psf.upfronthosting.co.za>


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


----------
pull_requests: +9852

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

From report at bugs.python.org  Tue Nov 20 11:19:20 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 20 Nov 2018 16:19:20 +0000
Subject: [docs] [issue31146] Docs: On non-public translations,
 language picker fallback to "English"
In-Reply-To: <1502206180.29.0.859774070814.issue31146@psf.upfronthosting.co.za>
Message-ID: <1542730760.98.0.702299269573.issue31146@psf.upfronthosting.co.za>


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


----------
pull_requests: +9853

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

From report at bugs.python.org  Tue Nov 20 11:19:33 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 20 Nov 2018 16:19:33 +0000
Subject: [docs] [issue31146] Docs: On non-public translations,
 language picker fallback to "English"
In-Reply-To: <1502206180.29.0.859774070814.issue31146@psf.upfronthosting.co.za>
Message-ID: <1542730773.22.0.702299269573.issue31146@psf.upfronthosting.co.za>


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


----------
pull_requests: +9854

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

From report at bugs.python.org  Tue Nov 20 12:26:14 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 20 Nov 2018 17:26:14 +0000
Subject: [docs] [issue9842] Document ... used in recursive repr of containers
In-Reply-To: <1284336324.93.0.400210409006.issue9842@psf.upfronthosting.co.za>
Message-ID: <1542734774.03.0.788709270274.issue9842@psf.upfronthosting.co.za>


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


New changeset 6c48bf2d9e1e18dfbfa35f7582ddd32f11f75129 by Serhiy Storchaka in branch 'master':
bpo-9842: Add references for using "..." as a placeholder to the index. (GH-10330)
https://github.com/python/cpython/commit/6c48bf2d9e1e18dfbfa35f7582ddd32f11f75129


----------

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

From report at bugs.python.org  Tue Nov 20 12:26:22 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 20 Nov 2018 17:26:22 +0000
Subject: [docs] [issue9842] Document ... used in recursive repr of containers
In-Reply-To: <1284336324.93.0.400210409006.issue9842@psf.upfronthosting.co.za>
Message-ID: <1542734782.14.0.702299269573.issue9842@psf.upfronthosting.co.za>


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


----------
pull_requests: +9855

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

From report at bugs.python.org  Tue Nov 20 12:26:30 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 20 Nov 2018 17:26:30 +0000
Subject: [docs] [issue9842] Document ... used in recursive repr of containers
In-Reply-To: <1284336324.93.0.400210409006.issue9842@psf.upfronthosting.co.za>
Message-ID: <1542734790.16.0.702299269573.issue9842@psf.upfronthosting.co.za>


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


----------
pull_requests: +9856

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

From report at bugs.python.org  Tue Nov 20 13:07:57 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 20 Nov 2018 18:07:57 +0000
Subject: [docs] [issue9842] Document ... used in recursive repr of containers
In-Reply-To: <1284336324.93.0.400210409006.issue9842@psf.upfronthosting.co.za>
Message-ID: <1542737277.88.0.788709270274.issue9842@psf.upfronthosting.co.za>


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


New changeset f8f9915f9585a5d4f4a4457ef43ac66607c5f380 by Miss Islington (bot) in branch '3.7':
bpo-9842: Add references for using "..." as a placeholder to the index. (GH-10330)
https://github.com/python/cpython/commit/f8f9915f9585a5d4f4a4457ef43ac66607c5f380


----------

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

From report at bugs.python.org  Tue Nov 20 13:08:11 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 20 Nov 2018 18:08:11 +0000
Subject: [docs] [issue9842] Document ... used in recursive repr of containers
In-Reply-To: <1284336324.93.0.400210409006.issue9842@psf.upfronthosting.co.za>
Message-ID: <1542737291.37.0.788709270274.issue9842@psf.upfronthosting.co.za>


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


New changeset dac5124ba498b51a2c46e2bda751150ae244ed47 by Miss Islington (bot) in branch '3.6':
bpo-9842: Add references for using "..." as a placeholder to the index. (GH-10330)
https://github.com/python/cpython/commit/dac5124ba498b51a2c46e2bda751150ae244ed47


----------

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

From report at bugs.python.org  Tue Nov 20 14:19:37 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 20 Nov 2018 19:19:37 +0000
Subject: [docs] [issue9842] Document ... used in recursive repr of containers
In-Reply-To: <1284336324.93.0.400210409006.issue9842@psf.upfronthosting.co.za>
Message-ID: <1542741577.88.0.702299269573.issue9842@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/issue9842>
_______________________________________

From julien at palard.fr  Wed Nov 21 05:09:13 2018
From: julien at palard.fr (Julien Palard)
Date: Wed, 21 Nov 2018 10:09:13 +0000
Subject: [docs] Python Documentation 3.7.1 concerning Spinbox
In-Reply-To: <a723effcc6ca4a9aa258da5d513d940e@SI0SWIEXMB3A.bsh.corp.bshg.com>
References: <a723effcc6ca4a9aa258da5d513d940e@SI0SWIEXMB3A.bsh.corp.bshg.com>
Message-ID: <OLvBy2BukTgpDbVtKjEkGBaxPC3NJdE0nEpgWkau6jyfWZtBaOO_bSLMkDCT-Yh-ALa0ye36i6B7MXSk7OEbeUrbuxioJoZY4-J_Sb6K13M=@palard.fr>

Hi thanks for reporting.

You wrote:
> Theres no set() command for spinboxes.

Sadly I don't get it, as I can see the set method on a Spinbox:

??? >>> ttk.Spinbox().set
??? <bound method Spinbox.set of <tkinter.ttk.Spinbox object .!spinbox>>

and I can see it in the documentation too: https://docs.python.org/3.7/library/tkinter.ttk.html#tkinter.ttk.Spinbox.set

Can you give me more details about the issue?

--?
Julien Palard
https://mdk.fr

From report at bugs.python.org  Wed Nov 21 06:55:03 2018
From: report at bugs.python.org (Lysandros Nikolaou)
Date: Wed, 21 Nov 2018 11:55:03 +0000
Subject: [docs] [issue21314] Document '/' in signatures
In-Reply-To: <1397988439.5.0.703056699862.issue21314@psf.upfronthosting.co.za>
Message-ID: <1542801303.42.0.788709270274.issue21314@psf.upfronthosting.co.za>


Lysandros Nikolaou <lisandrosnik at gmail.com> added the comment:

Noah, are you working on this?

----------
nosy: +lys.nikolaou

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

From report at bugs.python.org  Wed Nov 21 07:41:14 2018
From: report at bugs.python.org (Julien Palard)
Date: Wed, 21 Nov 2018 12:41:14 +0000
Subject: [docs] [issue35035] Documentation for email.utils is named
 email.util.rst
In-Reply-To: <1540102639.17.0.788709270274.issue35035@psf.upfronthosting.co.za>
Message-ID: <1542804074.03.0.788709270274.issue35035@psf.upfronthosting.co.za>


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


New changeset 361e8683e7340c600b22f4a514b81448ccec66dc by Julien Palard (Zhiming Wang) in branch 'master':
bpo-35035: Rename email.utils documentation to email.utils.rst (GH-10023)
https://github.com/python/cpython/commit/361e8683e7340c600b22f4a514b81448ccec66dc


----------
nosy: +mdk

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

From report at bugs.python.org  Wed Nov 21 07:41:21 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 21 Nov 2018 12:41:21 +0000
Subject: [docs] [issue35035] Documentation for email.utils is named
 email.util.rst
In-Reply-To: <1540102639.17.0.788709270274.issue35035@psf.upfronthosting.co.za>
Message-ID: <1542804081.36.0.702299269573.issue35035@psf.upfronthosting.co.za>


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


----------
pull_requests: +9882

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

From report at bugs.python.org  Wed Nov 21 07:41:30 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 21 Nov 2018 12:41:30 +0000
Subject: [docs] [issue35035] Documentation for email.utils is named
 email.util.rst
In-Reply-To: <1540102639.17.0.788709270274.issue35035@psf.upfronthosting.co.za>
Message-ID: <1542804090.78.0.702299269573.issue35035@psf.upfronthosting.co.za>


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


----------
pull_requests: +9883

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

From report at bugs.python.org  Wed Nov 21 07:51:30 2018
From: report at bugs.python.org (Julien Palard)
Date: Wed, 21 Nov 2018 12:51:30 +0000
Subject: [docs] [issue35035] Documentation for email.utils is named
 email.util.rst
In-Reply-To: <1540102639.17.0.788709270274.issue35035@psf.upfronthosting.co.za>
Message-ID: <1542804690.81.0.788709270274.issue35035@psf.upfronthosting.co.za>


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


New changeset 27c16e33b1acac55641a27faa5a11508ee605adc by Julien Palard (Miss Islington (bot)) in branch '3.6':
bpo-35035: Rename email.utils documentation to email.utils.rst (GH-10023)
https://github.com/python/cpython/commit/27c16e33b1acac55641a27faa5a11508ee605adc


----------

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

From report at bugs.python.org  Wed Nov 21 07:54:20 2018
From: report at bugs.python.org (Julien Palard)
Date: Wed, 21 Nov 2018 12:54:20 +0000
Subject: [docs] [issue35035] Documentation for email.utils is named
 email.util.rst
In-Reply-To: <1540102639.17.0.788709270274.issue35035@psf.upfronthosting.co.za>
Message-ID: <1542804859.97.0.788709270274.issue35035@psf.upfronthosting.co.za>


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


New changeset 3b7258a5a5fddc6c46f71a89b7c8ce89f4b79641 by Julien Palard (Miss Islington (bot)) in branch '3.7':
[3.7] bpo-35035: Rename email.utils documentation to email.utils.rst (GH-10023)
https://github.com/python/cpython/commit/3b7258a5a5fddc6c46f71a89b7c8ce89f4b79641


----------

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

From report at bugs.python.org  Wed Nov 21 11:53:24 2018
From: report at bugs.python.org (Noah Haasis)
Date: Wed, 21 Nov 2018 16:53:24 +0000
Subject: [docs] [issue21314] Document '/' in signatures
In-Reply-To: <1397988439.5.0.703056699862.issue21314@psf.upfronthosting.co.za>
Message-ID: <1542819203.92.0.788709270274.issue21314@psf.upfronthosting.co.za>


Noah Haasis <haasis_noah at yahoo.de> added the comment:

I don?t have the time right now. Feel free to work on it!

----------

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

From report at bugs.python.org  Wed Nov 21 17:06:38 2018
From: report at bugs.python.org (Lysandros Nikolaou)
Date: Wed, 21 Nov 2018 22:06:38 +0000
Subject: [docs] [issue21314] Document '/' in signatures
In-Reply-To: <1397988439.5.0.703056699862.issue21314@psf.upfronthosting.co.za>
Message-ID: <1542837996.03.0.702299269573.issue21314@psf.upfronthosting.co.za>


Change by Lysandros Nikolaou <lisandrosnik at gmail.com>:


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

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

From report at bugs.python.org  Wed Nov 21 17:06:48 2018
From: report at bugs.python.org (Lysandros Nikolaou)
Date: Wed, 21 Nov 2018 22:06:48 +0000
Subject: [docs] [issue21314] Document '/' in signatures
In-Reply-To: <1397988439.5.0.703056699862.issue21314@psf.upfronthosting.co.za>
Message-ID: <1542838007.07.0.702299269573.issue21314@psf.upfronthosting.co.za>


Change by Lysandros Nikolaou <lisandrosnik at gmail.com>:


----------
keywords: +patch, patch
pull_requests: +9891, 9892
stage: needs patch -> patch review

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

From report at bugs.python.org  Wed Nov 21 17:06:58 2018
From: report at bugs.python.org (Lysandros Nikolaou)
Date: Wed, 21 Nov 2018 22:06:58 +0000
Subject: [docs] [issue21314] Document '/' in signatures
In-Reply-To: <1397988439.5.0.703056699862.issue21314@psf.upfronthosting.co.za>
Message-ID: <1542838016.08.0.702299269573.issue21314@psf.upfronthosting.co.za>


Change by Lysandros Nikolaou <lisandrosnik at gmail.com>:


----------
keywords: +patch, patch, patch
pull_requests: +9891, 9892, 9893
stage: needs patch -> patch review

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

From report at bugs.python.org  Wed Nov 21 17:11:23 2018
From: report at bugs.python.org (Yury Selivanov)
Date: Wed, 21 Nov 2018 22:11:23 +0000
Subject: [docs] [issue21314] Document '/' in signatures
In-Reply-To: <1397988439.5.0.703056699862.issue21314@psf.upfronthosting.co.za>
Message-ID: <1542838282.67.0.702299269573.issue21314@psf.upfronthosting.co.za>


Change by Yury Selivanov <yselivanov at gmail.com>:


----------
nosy:  -yselivanov

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

From report at bugs.python.org  Wed Nov 21 17:46:34 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 21 Nov 2018 22:46:34 +0000
Subject: [docs] [issue31146] Docs: On non-public translations,
 language picker fallback to "English"
In-Reply-To: <1502206180.29.0.859774070814.issue31146@psf.upfronthosting.co.za>
Message-ID: <1542840394.02.0.788709270274.issue31146@psf.upfronthosting.co.za>


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


New changeset df6374e15aadff7eb547fc210c0f4f28bbff7010 by Miss Islington (bot) in branch '3.7':
bpo-31146: Don't fallback switcher to english on not-yet pusblished languages. (GH-10558)
https://github.com/python/cpython/commit/df6374e15aadff7eb547fc210c0f4f28bbff7010


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

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

From report at bugs.python.org  Wed Nov 21 17:47:00 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 21 Nov 2018 22:47:00 +0000
Subject: [docs] [issue31146] Docs: On non-public translations,
 language picker fallback to "English"
In-Reply-To: <1502206180.29.0.859774070814.issue31146@psf.upfronthosting.co.za>
Message-ID: <1542840419.75.0.788709270274.issue31146@psf.upfronthosting.co.za>


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


New changeset c487cf9261c61f0db4e5d1df3c83a60384b330db by Miss Islington (bot) in branch '3.6':
bpo-31146: Don't fallback switcher to english on not-yet pusblished languages. (GH-10558)
https://github.com/python/cpython/commit/c487cf9261c61f0db4e5d1df3c83a60384b330db


----------

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

From report at bugs.python.org  Wed Nov 21 17:47:13 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 21 Nov 2018 22:47:13 +0000
Subject: [docs] [issue31146] Docs: On non-public translations,
 language picker fallback to "English"
In-Reply-To: <1502206180.29.0.859774070814.issue31146@psf.upfronthosting.co.za>
Message-ID: <1542840432.7.0.788709270274.issue31146@psf.upfronthosting.co.za>


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


New changeset fcbcebadff46f907b38fcf2d79adb3209c5a205d by Miss Islington (bot) in branch '2.7':
bpo-31146: Don't fallback switcher to english on not-yet pusblished languages. (GH-10558)
https://github.com/python/cpython/commit/fcbcebadff46f907b38fcf2d79adb3209c5a205d


----------

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

From report at bugs.python.org  Wed Nov 21 18:06:13 2018
From: report at bugs.python.org (Julien Palard)
Date: Wed, 21 Nov 2018 23:06:13 +0000
Subject: [docs] [issue31146] Docs: On non-public translations,
 language picker fallback to "English"
In-Reply-To: <1502206180.29.0.859774070814.issue31146@psf.upfronthosting.co.za>
Message-ID: <1542841573.31.0.702299269573.issue31146@psf.upfronthosting.co.za>


Change by Julien Palard <julien+python at palard.fr>:


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

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

From report at bugs.python.org  Thu Nov 22 07:12:44 2018
From: report at bugs.python.org (Marcin Kowalczyk)
Date: Thu, 22 Nov 2018 12:12:44 +0000
Subject: [docs] [issue35295] Please clarify whether
 PyUnicode_AsUTF8AndSize() or PyUnicode_AsUTF8String() is preferred
Message-ID: <1542888764.29.0.788709270274.issue35295@psf.upfronthosting.co.za>


New submission from Marcin Kowalczyk <qrczakmk at gmail.com>:

The documentation is silent whether PyUnicode_AsUTF8AndSize() or PyUnicode_AsUTF8String() is preferred.

We are under the assumption that both are acceptable for the given caller, i.e. the caller wants to access just the sequence of UTF-8 code units (e.g. for calling a C++ function which takes std::string_view or std::string as a parameter), and the caller either will copy the UTF-8 code units immediately or is willing to own a temporary object to ensure a lifetime of the UTF-8 code units.

File comments in unicodeobject.h about PyUnicode_AsUTF8AndSize() have a warning:

   *** This API is for interpreter INTERNAL USE ONLY and will likely
   *** be removed or changed in the future.
   *** If you need to access the Unicode object as UTF-8 bytes string,
   *** please use PyUnicode_AsUTF8String() instead.

The discrepancy between these comments and the documentation should be fixed. Either the documentation is correct and the comment is outdated, or the comment is correct and the documentation is lacking guidance.

It is not even clear which function is better technically:

- PyUnicode_AsUTF8String() always allocates the string. PyUnicode_AsUTF8AndSize() does not allocate the string if the unicode object is ASCII-only (this is common) or if PyUnicode_AsUTF8AndSize() was already called before.

- If conversion must be performed, then PyUnicode_AsUTF8String() makes a single allocation, while PyUnicode_AsUTF8AndSize() first calls PyUnicode_AsUTF8String() and then copies the string.

- If the string is converted multiple times, then PyUnicode_AsUTF8AndSize() caches the result - faster. If the string is converted once, then the result persists as long as the string persists - wastes memory.

I see the following possible resolutions:

1a. Declare both functions equally acceptable. Remove comments claiming that PyUnicode_AsUTF8AndSize() should be avoided.

1b. 1a, and change the implementation of PyUnicode_AsUTF8AndSize() to avoid allocating the string twice if it needs to be materialized, so that PyUnicode_AsUTF8AndSize() is never significantly slower than PyUnicode_AsUTF8String().

2a. Declare PyUnicode_AsUTF8String() preferred. Indicate this in the documentation.

2b. 2a, and provide a public interface to check and access UTF-8 code units without allocating a new string in case this is possible (I think PyUnicode_READY() + PyUnicode_IS_ASCII() + PyUnicode_DATA() + PyUnicode_GET_LENGTH() would work, but they are not documented; or possibly also check if the string has a cached UTF-8 representation without populating that cached representation), so that a combination of the check with PyUnicode_AsUTF8String() is rarely or never significantly slower than PyUnicode_AsUTF8AndSize().

----------
assignee: docs at python
components: Documentation, Interpreter Core, Unicode
messages: 330249
nosy: Marcin Kowalczyk, docs at python, ezio.melotti, vstinner
priority: normal
severity: normal
status: open
title: Please clarify whether PyUnicode_AsUTF8AndSize() or PyUnicode_AsUTF8String() is preferred
type: performance
versions: Python 3.8

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

From report at bugs.python.org  Thu Nov 22 16:24:28 2018
From: report at bugs.python.org (Julien Palard)
Date: Thu, 22 Nov 2018 21:24:28 +0000
Subject: [docs] [issue35035] Documentation for email.utils is named
 email.util.rst
In-Reply-To: <1540102639.17.0.788709270274.issue35035@psf.upfronthosting.co.za>
Message-ID: <1542921868.51.0.702299269573.issue35035@psf.upfronthosting.co.za>


Change by Julien Palard <julien+python at palard.fr>:


----------
pull_requests: +9920

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

From report at bugs.python.org  Thu Nov 22 16:25:02 2018
From: report at bugs.python.org (Zsolt Cserna)
Date: Thu, 22 Nov 2018 21:25:02 +0000
Subject: [docs] [issue35297] untokenize documentation is not correct
Message-ID: <1542921902.22.0.788709270274.issue35297@psf.upfronthosting.co.za>


New submission from Zsolt Cserna <cserna.zsolt at gmail.com>:

untokenize documentation (https://docs.python.org/3/library/tokenize.html#tokenize.untokenize) states the following:

"""
Converts tokens back into Python source code. The iterable must return sequences with at least two elements, the token type and the token string. Any additional sequence elements are ignored.
"""

This last sentence is clearly not true because here:
https://github.com/python/cpython/blob/master/Lib/tokenize.py#L242

The code checks for the length of the input token there, and the code behaves differently, in terms of whitespace, when an iterator of 2-tuples are given and when there are more elements in the tuple. When there are more elements in the tuple, the function renders whitespaces as the same as they were present in the original source.

So this code:
tokenize.untokenize(tokenize.tokenize(source.readline))

And this:
tokenize.untokenize([x[:2] for x in tokenize.tokenize(source.readline)])

Have different results.

I don't know that it is a documentation issue  or a bug in the module itself, so I created this bugreport to seek for assistance in this regard.

----------
assignee: docs at python
components: Documentation
messages: 330281
nosy: csernazs, docs at python
priority: normal
severity: normal
status: open
title: untokenize documentation is not correct
versions: Python 3.7

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

From report at bugs.python.org  Thu Nov 22 16:25:34 2018
From: report at bugs.python.org (Zsolt Cserna)
Date: Thu, 22 Nov 2018 21:25:34 +0000
Subject: [docs] [issue35297] untokenize documentation is not correct
In-Reply-To: <1542921902.22.0.788709270274.issue35297@psf.upfronthosting.co.za>
Message-ID: <1542921934.97.0.702299269573.issue35297@psf.upfronthosting.co.za>


Change by Zsolt Cserna <cserna.zsolt at gmail.com>:


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

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

From report at bugs.python.org  Thu Nov 22 17:12:56 2018
From: report at bugs.python.org (Utkarsh Gupta)
Date: Thu, 22 Nov 2018 22:12:56 +0000
Subject: [docs] [issue30951] Documentation error in inspect module
In-Reply-To: <1500312575.69.0.52467451771.issue30951@psf.upfronthosting.co.za>
Message-ID: <1542924776.35.0.702299269573.issue30951@psf.upfronthosting.co.za>


Change by Utkarsh Gupta <guptautkarsh2102 at gmail.com>:


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

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

From report at bugs.python.org  Thu Nov 22 17:18:09 2018
From: report at bugs.python.org (miss-islington)
Date: Thu, 22 Nov 2018 22:18:09 +0000
Subject: [docs] [issue35035] Documentation for email.utils is named
 email.util.rst
In-Reply-To: <1540102639.17.0.788709270274.issue35035@psf.upfronthosting.co.za>
Message-ID: <1542925089.19.0.788709270274.issue35035@psf.upfronthosting.co.za>


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


New changeset daa34b84e9f6680a4012d5138068236ccdd2d1bd by Miss Islington (bot) (Julien Palard) in branch '2.7':
[2.7] bpo-35035: Rename email.utils documentation to email.utils.rst (GH-10023) (GH-10667)
https://github.com/python/cpython/commit/daa34b84e9f6680a4012d5138068236ccdd2d1bd


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

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

From report at bugs.python.org  Thu Nov 22 17:28:52 2018
From: report at bugs.python.org (Julien Palard)
Date: Thu, 22 Nov 2018 22:28:52 +0000
Subject: [docs] [issue35083] Fix documentation for __instancecheck__
In-Reply-To: <1540671281.62.0.788709270274.issue35083@psf.upfronthosting.co.za>
Message-ID: <1542925731.93.0.788709270274.issue35083@psf.upfronthosting.co.za>


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

Currently [1] there's no concensus about:

- Is this a documentation issue and we should document the optimisation?
- Is the optimisation over-zealeous?

[1]: https://mail.python.org/pipermail/python-ideas/2018-October/054342.html

----------
nosy: +mdk

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

From report at bugs.python.org  Thu Nov 22 17:29:08 2018
From: report at bugs.python.org (Julien Palard)
Date: Thu, 22 Nov 2018 22:29:08 +0000
Subject: [docs] [issue35035] Documentation for email.utils is named
 email.util.rst
In-Reply-To: <1540102639.17.0.788709270274.issue35035@psf.upfronthosting.co.za>
Message-ID: <1542925748.28.0.702299269573.issue35035@psf.upfronthosting.co.za>


Change by Julien Palard <julien+python at palard.fr>:


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

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

From report at bugs.python.org  Thu Nov 22 17:41:40 2018
From: report at bugs.python.org (Utkarsh Gupta)
Date: Thu, 22 Nov 2018 22:41:40 +0000
Subject: [docs] [issue30951] Documentation error in inspect module
In-Reply-To: <1500312575.69.0.52467451771.issue30951@psf.upfronthosting.co.za>
Message-ID: <1542926500.63.0.702299269573.issue30951@psf.upfronthosting.co.za>


Change by Utkarsh Gupta <guptautkarsh2102 at gmail.com>:


----------
nosy: +utkarsh2102

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

From report at bugs.python.org  Thu Nov 22 18:55:13 2018
From: report at bugs.python.org (=?utf-8?b?R8Opcnk=?=)
Date: Thu, 22 Nov 2018 23:55:13 +0000
Subject: [docs] [issue35181] Doc: Namespace Packages: Inconsistent
 documentation of __loader__ being None
In-Reply-To: <1541543349.68.0.788709270274.issue35181@psf.upfronthosting.co.za>
Message-ID: <1542930913.72.0.702299269573.issue35181@psf.upfronthosting.co.za>


Change by G?ry <gery.ogam at gmail.com>:


----------
nosy: +eric.smith

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

From report at bugs.python.org  Thu Nov 22 21:59:07 2018
From: report at bugs.python.org (Danish Prakash)
Date: Fri, 23 Nov 2018 02:59:07 +0000
Subject: [docs] [issue20582] socket.getnameinfo() does not document flags
In-Reply-To: <1392042265.22.0.885252016144.issue20582@psf.upfronthosting.co.za>
Message-ID: <1542941947.32.0.788709270274.issue20582@psf.upfronthosting.co.za>


Danish Prakash <grafitykoncept at gmail.com> added the comment:

I would like to work on this if nobody else has.

----------
nosy: +danishprakash

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

From report at bugs.python.org  Thu Nov 22 22:17:02 2018
From: report at bugs.python.org (Danish Prakash)
Date: Fri, 23 Nov 2018 03:17:02 +0000
Subject: [docs] [issue31823] Opaque default value for close_fds argument in
 Popen.__init__
In-Reply-To: <1508445256.4.0.213398074469.issue31823@psf.upfronthosting.co.za>
Message-ID: <1542943021.97.0.788709270274.issue31823@psf.upfronthosting.co.za>


Danish Prakash <grafitykoncept at gmail.com> added the comment:

I'd like to work on this.

I get that the 3.7+ doc still has the irrelevant change from 3.6 which needs to be removed but I'm not sure what's wrong with the 3.6 doc.

> The signature is indeed awkward for 3.6,

----------
nosy: +danishprakash

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

From report at bugs.python.org  Fri Nov 23 00:13:27 2018
From: report at bugs.python.org (Tal Einat)
Date: Fri, 23 Nov 2018 05:13:27 +0000
Subject: [docs] [issue31823] Opaque default value for close_fds argument in
 Popen.__init__
In-Reply-To: <1508445256.4.0.213398074469.issue31823@psf.upfronthosting.co.za>
Message-ID: <1542950007.01.0.788709270274.issue31823@psf.upfronthosting.co.za>


Tal Einat <taleinat at gmail.com> added the comment:

Danish, see Martin's previous comment (msg314413):

"... the signature at [the 3.6 docs] should not show close_fds=True, because that is not necessarily the default on Windows."

----------

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

From report at bugs.python.org  Fri Nov 23 03:58:28 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 23 Nov 2018 08:58:28 +0000
Subject: [docs] [issue30951] Documentation error in inspect module
In-Reply-To: <1500312575.69.0.52467451771.issue30951@psf.upfronthosting.co.za>
Message-ID: <1542963508.14.0.788709270274.issue30951@psf.upfronthosting.co.za>


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

co_names contains not only names of global variables. It contains also local names in the class scope, attribute names, names of imported modules, etc.

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

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

From report at bugs.python.org  Fri Nov 23 11:57:01 2018
From: report at bugs.python.org (Mathieu Dupuy)
Date: Fri, 23 Nov 2018 16:57:01 +0000
Subject: [docs] [issue35220] delete "how do I emulate os.kill" section in
 Windows FAQ
In-Reply-To: <1542055518.86.0.788709270274.issue35220@psf.upfronthosting.co.za>
Message-ID: <1542992221.8.0.788709270274.issue35220@psf.upfronthosting.co.za>


Mathieu Dupuy <deronnax at gmail.com> added the comment:

My PR has been merged, thanks

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

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

From report at bugs.python.org  Fri Nov 23 20:36:03 2018
From: report at bugs.python.org (INADA Naoki)
Date: Sat, 24 Nov 2018 01:36:03 +0000
Subject: [docs] [issue35295] Please clarify whether
 PyUnicode_AsUTF8AndSize() or PyUnicode_AsUTF8String() is preferred
In-Reply-To: <1542888764.29.0.788709270274.issue35295@psf.upfronthosting.co.za>
Message-ID: <1543023363.45.0.702299269573.issue35295@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Nov 24 05:11:50 2018
From: report at bugs.python.org (HolgerFrey)
Date: Sat, 24 Nov 2018 10:11:50 +0000
Subject: [docs] [issue35307] Command line help example is missing "--prompt"
 option
Message-ID: <1543054310.5.0.788709270274.issue35307@psf.upfronthosting.co.za>


New submission from HolgerFrey <python at holgerfrey.de>:

In the documentation of the command line options of the "vent" module, the option "--prompt" is missing:
    
Current text:
> [...]
> 
> The command, if run with -h, will show the available options:
> 
> usage: venv [-h] [--system-site-packages] [--symlinks | --copies] [--clear]
>              [--upgrade] [--without-pip]
>              ENV_DIR [ENV_DIR ...]
> 
> [...]

The prompt option is also missing in the rest of the example output

output of python3 -m venv -h:
> python3 -m venv -h
> usage: venv [-h] [--system-site-packages] [--symlinks | --copies] [--clear]
>             [--upgrade] [--without-pip] [--prompt PROMPT]
>             ENV_DIR [ENV_DIR ...]
> [...]

----------
assignee: docs at python
components: Documentation
messages: 330376
nosy: daftwullie, docs at python
priority: normal
severity: normal
status: open
title: Command line help example  is missing "--prompt" option
type: enhancement
versions: Python 3.7

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

From report at bugs.python.org  Sun Nov 25 02:51:22 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 25 Nov 2018 07:51:22 +0000
Subject: [docs] [issue32035] Documentation of zipfile.ZipFile().writestr()
 fails to mention that 'data' may also be bytes
In-Reply-To: <1510757660.91.0.213398074469.issue32035@psf.upfronthosting.co.za>
Message-ID: <1543132282.04.0.788709270274.issue32035@psf.upfronthosting.co.za>


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


New changeset 4bb186d7e253ad4def875305e06690181e923dfd by Serhiy Storchaka in branch 'master':
bpo-32035: Fix words about strings and bytes in zipfile documentation. (GH-10592)
https://github.com/python/cpython/commit/4bb186d7e253ad4def875305e06690181e923dfd


----------

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

From report at bugs.python.org  Sun Nov 25 02:51:48 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 25 Nov 2018 07:51:48 +0000
Subject: [docs] [issue32035] Documentation of zipfile.ZipFile().writestr()
 fails to mention that 'data' may also be bytes
In-Reply-To: <1510757660.91.0.213398074469.issue32035@psf.upfronthosting.co.za>
Message-ID: <1543132308.45.0.702299269573.issue32035@psf.upfronthosting.co.za>


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


----------
pull_requests: +9947

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

From report at bugs.python.org  Sun Nov 25 02:52:02 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 25 Nov 2018 07:52:02 +0000
Subject: [docs] [issue32035] Documentation of zipfile.ZipFile().writestr()
 fails to mention that 'data' may also be bytes
In-Reply-To: <1510757660.91.0.213398074469.issue32035@psf.upfronthosting.co.za>
Message-ID: <1543132322.43.0.702299269573.issue32035@psf.upfronthosting.co.za>


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


----------
pull_requests: +9948

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

From report at bugs.python.org  Sun Nov 25 04:30:49 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 25 Nov 2018 09:30:49 +0000
Subject: [docs] [issue32035] Documentation of zipfile.ZipFile().writestr()
 fails to mention that 'data' may also be bytes
In-Reply-To: <1510757660.91.0.213398074469.issue32035@psf.upfronthosting.co.za>
Message-ID: <1543138249.48.0.788709270274.issue32035@psf.upfronthosting.co.za>


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


New changeset af009fbcdb00fffced653792eb7af6b72f2521e3 by Miss Islington (bot) in branch '3.6':
bpo-32035: Fix words about strings and bytes in zipfile documentation. (GH-10592)
https://github.com/python/cpython/commit/af009fbcdb00fffced653792eb7af6b72f2521e3


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

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

From report at bugs.python.org  Sun Nov 25 04:30:49 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 25 Nov 2018 09:30:49 +0000
Subject: [docs] [issue32035] Documentation of zipfile.ZipFile().writestr()
 fails to mention that 'data' may also be bytes
In-Reply-To: <1510757660.91.0.213398074469.issue32035@psf.upfronthosting.co.za>
Message-ID: <1543138249.66.0.788709270274.issue32035@psf.upfronthosting.co.za>


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


New changeset 89a3087d40feed3ca78033319389437bb4b5bcd7 by Miss Islington (bot) in branch '3.7':
bpo-32035: Fix words about strings and bytes in zipfile documentation. (GH-10592)
https://github.com/python/cpython/commit/89a3087d40feed3ca78033319389437bb4b5bcd7


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

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

From report at bugs.python.org  Sun Nov 25 05:16:20 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 25 Nov 2018 10:16:20 +0000
Subject: [docs] [issue32035] Documentation of zipfile.ZipFile().writestr()
 fails to mention that 'data' may also be bytes
In-Reply-To: <1510757660.91.0.213398074469.issue32035@psf.upfronthosting.co.za>
Message-ID: <1543140980.61.0.702299269573.issue32035@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/issue32035>
_______________________________________

From report at bugs.python.org  Mon Nov 26 01:28:43 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Mon, 26 Nov 2018 06:28:43 +0000
Subject: [docs] [issue35307] Command line help example is missing "--prompt"
 option
In-Reply-To: <1543054310.5.0.788709270274.issue35307@psf.upfronthosting.co.za>
Message-ID: <1543213723.05.0.788709270274.issue35307@psf.upfronthosting.co.za>


Karthikeyan Singaravelan <tir.karthi at gmail.com> added the comment:

Thanks for the report. Would you like to propose a PR for this? I think this is an easy issue where the new help string for --help needs to be updated at https://github.com/python/cpython/blob/master/Doc/using/venv-create.inc

----------
nosy: +vinay.sajip, xtreak

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

From report at bugs.python.org  Mon Nov 26 03:39:10 2018
From: report at bugs.python.org (Julien Palard)
Date: Mon, 26 Nov 2018 08:39:10 +0000
Subject: [docs] [issue35035] Documentation for email.utils is named
 email.util.rst
In-Reply-To: <1540102639.17.0.788709270274.issue35035@psf.upfronthosting.co.za>
Message-ID: <1543221550.59.0.702299269573.issue35035@psf.upfronthosting.co.za>


Change by Julien Palard <julien+python at palard.fr>:


----------
stage: resolved -> patch review

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

From report at bugs.python.org  Mon Nov 26 04:14:21 2018
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 26 Nov 2018 09:14:21 +0000
Subject: [docs] [issue35307] Command line help example is missing "--prompt"
 option
In-Reply-To: <1543054310.5.0.788709270274.issue35307@psf.upfronthosting.co.za>
Message-ID: <1543223661.94.0.702299269573.issue35307@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Mon Nov 26 05:17:48 2018
From: report at bugs.python.org (Martin Panter)
Date: Mon, 26 Nov 2018 10:17:48 +0000
Subject: [docs] [issue14418] Document differences in SocketServer between
 Python 2.6 and 2.7
In-Reply-To: <1332795225.64.0.202093290254.issue14418@psf.upfronthosting.co.za>
Message-ID: <1543227468.43.0.788709270274.issue14418@psf.upfronthosting.co.za>


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

Regarding the first point, ?finish? is no longer called after an exception. This was apparently changed in 2.7.4 (see Issue 14574), but Geoffrey was referring to older documentation.

Regarding the second point, about ECONNRESET vs graceful shutdown, this seems to be due to the ?shutdown? call added to in ?TCPServer.close_request? in Issue 6267.

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

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

From report at bugs.python.org  Mon Nov 26 07:01:11 2018
From: report at bugs.python.org (Mark Lawrence)
Date: Mon, 26 Nov 2018 12:01:11 +0000
Subject: [docs] [issue14418] Document differences in SocketServer between
 Python 2.6 and 2.7
In-Reply-To: <1332795225.64.0.202093290254.issue14418@psf.upfronthosting.co.za>
Message-ID: <1543233671.18.0.702299269573.issue14418@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/issue14418>
_______________________________________

From uniservmr at gmail.com  Sat Nov 10 12:55:24 2018
From: uniservmr at gmail.com (Ousmane)
Date: Sat, 10 Nov 2018 17:55:24 -0000
Subject: [docs] breaked links
Message-ID: <7bd47cf2-4246-6fc9-001b-688e0a0c0c1b@gmail.com>

Hello,

I will to download for frequent offline consultation the doc on version 3.5.
But any download link on the 
https://docs.python.org/en/3.5/download.html works.

Thanks

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181110/7cc4153c/attachment-0001.html>

From ccsapp.tux at gmail.com  Wed Nov 14 11:48:22 2018
From: ccsapp.tux at gmail.com (Areoot Tux)
Date: Thu, 15 Nov 2018 00:48:22 +0800
Subject: [docs] documentation bug
Message-ID: <CAO710LEojYwPeDJKrYKBu8AKtG_0D9ynHbNwoRdkekK7Mu=U+w@mail.gmail.com>

I would like to submit a documentation bug, which is a typo; Visit
following URL:

https://docs.python.org/3/library/functools.html#functools.lru_cache

Then at the first line, there is a typo, which is a word. "memoizing"
should be memorizing, Is it right?
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181115/99aa1f72/attachment-0001.html>

From sayan.kundu564 at gmail.com  Fri Nov 23 03:14:35 2018
From: sayan.kundu564 at gmail.com (Sayan Kundu)
Date: Fri, 23 Nov 2018 13:44:35 +0530
Subject: [docs] Improvement Request
Message-ID: <CAKcOmdzjhzffPXitY_g6RWQL=HRuXUZirh0JWVernC1_Uc_5Kg@mail.gmail.com>

*** Please make "Table of Contents" an independent scrolling panel*
For a long documentation, users have to scroll up all the way to navigate a
different sub-topic.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181123/05aa00bc/attachment.html>

From deronnax at gmail.com  Sat Nov 24 12:01:28 2018
From: deronnax at gmail.com (Mathieu Dupuy)
Date: Sat, 24 Nov 2018 18:01:28 +0100
Subject: [docs] move https://www.python.org/download/releases/2.3/mro/ into
 documentation
Message-ID: <CAKJVQ8-u0FYrS-cpb7ii2g+hOA6YMiGyvJhB96c4=QPZO3G+mw@mail.gmail.com>

Hello documentation fellows.
In Python documentation, many times, when talking about MRO, the
documentation invite you read an article located at
https://www.python.org/download/releases/2.3/mro/.

I think this is wrong many levels :
* It should be in the documentation itself
* why the is it under "download/release" ??
* I know new style classes come with Python 2.3 but we drop references to
that ?

* bonus : in the current state it cannot be translated (that's while I was
translating that I ran into many references to it)
(and I since MRO is already not simple by itself, it's something non-native
English speaker would *love* to read in their native language)

For what I've read of Python documentation, that article is the only one
really explaining the MRO, it's kind of the reference.
I think that's a pretty serious issue and it should be quickly copied into
the documentation and links to it be dropped.

If you agree, I'll open an issue

To locate the references to the link:
$ grep '\/mro' -r Doc
Doc/glossary.rst:      <https://www.python.org/download/releases/2.3/mro/>`_
for details of the
Doc/reference/datamodel.rst:
https://www.python.org/download/releases/2.3/mro/.
Doc/tutorial/classes.rst:https://www.python.org/download/releases/2.3/mro/.
Doc/whatsnew/2.3.rst:  `"Python 2.3 Method Resolution Order" <
http://www.phyast.pitt.edu/~micheles/mro.html>`_, or
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181124/c51d03be/attachment.html>

From jules.lasne at gmail.com  Mon Nov 26 09:16:25 2018
From: jules.lasne at gmail.com (Jules Lasne)
Date: Mon, 26 Nov 2018 15:16:25 +0100
Subject: [docs] documentation bug
In-Reply-To: <CAO710LEojYwPeDJKrYKBu8AKtG_0D9ynHbNwoRdkekK7Mu=U+w@mail.gmail.com>
References: <CAO710LEojYwPeDJKrYKBu8AKtG_0D9ynHbNwoRdkekK7Mu=U+w@mail.gmail.com>
Message-ID: <CAC=u-ijf8KTmR5Leb6wfa0XeiQtKDgszumYUmE6ztYZZmepitQ@mail.gmail.com>

I was about to agree with you about this typo when I looked up the word (in
french and english) and it seems to exist
https://en.wikipedia.org/wiki/Memoization

regards,
Jules Lasne
+33640736355
jules.lasne at gmail.com
juleslasne.com


Le lun. 26 nov. 2018 ? 15:08, Areoot Tux <ccsapp.tux at gmail.com> a ?crit :

> I would like to submit a documentation bug, which is a typo; Visit
> following URL:
>
> https://docs.python.org/3/library/functools.html#functools.lru_cache
>
> Then at the first line, there is a typo, which is a word. "memoizing"
> should be memorizing, Is it right?
> _______________________________________________
> docs mailing list
> docs at python.org
> https://mail.python.org/mailman/listinfo/docs
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181126/e160cd35/attachment.html>

From jules.lasne at gmail.com  Mon Nov 26 09:19:13 2018
From: jules.lasne at gmail.com (Jules Lasne)
Date: Mon, 26 Nov 2018 15:19:13 +0100
Subject: [docs] Improvement Request
In-Reply-To: <CAKcOmdzjhzffPXitY_g6RWQL=HRuXUZirh0JWVernC1_Uc_5Kg@mail.gmail.com>
References: <CAKcOmdzjhzffPXitY_g6RWQL=HRuXUZirh0JWVernC1_Uc_5Kg@mail.gmail.com>
Message-ID: <CAC=u-ij=MmvLXh+ditsm-Hd_gO2ga-aTe0JGi3Q=19xtUTnoRg@mail.gmail.com>

I thinks this is sphinx related, not the python doc team :)

Regards,
Jules Lasne
+33640736355
jules.lasne at gmail.com
juleslasne.com


Le lun. 26 nov. 2018 ? 15:08, Sayan Kundu <sayan.kundu564 at gmail.com> a
?crit :

> *** Please make "Table of Contents" an independent scrolling panel*
> For a long documentation, users have to scroll up all the way to navigate
> a different sub-topic.
> _______________________________________________
> docs mailing list
> docs at python.org
> https://mail.python.org/mailman/listinfo/docs
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181126/02751b97/attachment.html>

From report at bugs.python.org  Mon Nov 26 12:05:43 2018
From: report at bugs.python.org (Julien Palard)
Date: Mon, 26 Nov 2018 17:05:43 +0000
Subject: [docs] [issue35255] delete "How do I extract the downloaded
 documentation" section in Windows FAQ
In-Reply-To: <1542281478.85.0.788709270274.issue35255@psf.upfronthosting.co.za>
Message-ID: <1543251943.54.0.702299269573.issue35255@psf.upfronthosting.co.za>


Change by Julien Palard <julien+python at palard.fr>:


----------
pull_requests: +9972

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

From report at bugs.python.org  Mon Nov 26 12:05:52 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 26 Nov 2018 17:05:52 +0000
Subject: [docs] [issue35255] delete "How do I extract the downloaded
 documentation" section in Windows FAQ
In-Reply-To: <1542281478.85.0.788709270274.issue35255@psf.upfronthosting.co.za>
Message-ID: <1543251952.71.0.788709270274.issue35255@psf.upfronthosting.co.za>


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


New changeset 6f8cab0db044132c6192d6ac1536d28cf72c9d27 by Miss Islington (bot) (Julien Palard) in branch '3.7':
[3.7] bpo-35255: Doc: Delete now useless Windows FAQ section (GH-10557) (GH-10722)
https://github.com/python/cpython/commit/6f8cab0db044132c6192d6ac1536d28cf72c9d27


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

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

From report at bugs.python.org  Mon Nov 26 12:07:47 2018
From: report at bugs.python.org (Julien Palard)
Date: Mon, 26 Nov 2018 17:07:47 +0000
Subject: [docs] [issue35255] delete "How do I extract the downloaded
 documentation" section in Windows FAQ
In-Reply-To: <1542281478.85.0.788709270274.issue35255@psf.upfronthosting.co.za>
Message-ID: <1543252067.71.0.702299269573.issue35255@psf.upfronthosting.co.za>


Change by Julien Palard <julien+python at palard.fr>:


----------
pull_requests: +9973

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

From report at bugs.python.org  Mon Nov 26 12:09:30 2018
From: report at bugs.python.org (Julien Palard)
Date: Mon, 26 Nov 2018 17:09:30 +0000
Subject: [docs] [issue35255] delete "How do I extract the downloaded
 documentation" section in Windows FAQ
In-Reply-To: <1542281478.85.0.788709270274.issue35255@psf.upfronthosting.co.za>
Message-ID: <1543252170.53.0.702299269573.issue35255@psf.upfronthosting.co.za>


Change by Julien Palard <julien+python at palard.fr>:


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

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

From report at bugs.python.org  Mon Nov 26 12:09:57 2018
From: report at bugs.python.org (Julien Palard)
Date: Mon, 26 Nov 2018 17:09:57 +0000
Subject: [docs] [issue35035] Documentation for email.utils is named
 email.util.rst
In-Reply-To: <1540102639.17.0.788709270274.issue35035@psf.upfronthosting.co.za>
Message-ID: <1543252197.1.0.702299269573.issue35035@psf.upfronthosting.co.za>


Change by Julien Palard <julien+python at palard.fr>:


----------
stage: patch review -> resolved

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

From report at bugs.python.org  Mon Nov 26 12:16:16 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 26 Nov 2018 17:16:16 +0000
Subject: [docs] [issue35255] delete "How do I extract the downloaded
 documentation" section in Windows FAQ
In-Reply-To: <1542281478.85.0.788709270274.issue35255@psf.upfronthosting.co.za>
Message-ID: <1543252576.37.0.788709270274.issue35255@psf.upfronthosting.co.za>


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


New changeset 7f93f93fa68f54c1bc128d58fa17536245396de3 by Miss Islington (bot) (Julien Palard) in branch '3.6':
[3.6] bpo-35255: Doc: Delete now useless Windows FAQ section (GH-10557) (GH-10725)
https://github.com/python/cpython/commit/7f93f93fa68f54c1bc128d58fa17536245396de3


----------

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

From report at bugs.python.org  Mon Nov 26 13:49:06 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 26 Nov 2018 18:49:06 +0000
Subject: [docs] [issue35318] Check accuracy of str() doc string for its
 encoding argument
Message-ID: <1543258146.71.0.788709270274.issue35318@psf.upfronthosting.co.za>


New submission from Raymond Hettinger <raymond.hettinger at gmail.com>:

The "encoding" parameter is documented to default to sys.getdefaultencoding(). That may be true but there doesn't seem to be a way to use that default because objects will all have a __str__ or __repr__ that will be run instead.

-------------------------------------------
>>> import sys
>>> sys.getdefaultencoding()     # Default encoding is utf-8
'utf-8'
>>> buffer = b'lim x \xe2\x9f\xb6 \xe2\x88\x9e, 1/sin\xc2\xb2(x)'
>>> str(buffer, 'utf-8')         # Explicit argument decodes properly
'lim x ? ?, 1/sin?(x)'   
>>> str(buffer)                  # Despite the default, repr is shown 
"b'lim x \\xe2\\x9f\\xb6 \\xe2\\x88\\x9e, 1/sin\\xc2\\xb2(x)'"

>>> print(str.__doc__)
str(object='') -> str
str(bytes_or_buffer[, encoding[, errors]]) -> str

Create a new string object from the given object. If encoding or
errors is specified, then the object must expose a data buffer
that will be decoded using the given encoding and error handler.
Otherwise, returns the result of object.__str__() (if defined)
or repr(object).
encoding defaults to sys.getdefaultencoding().
errors defaults to 'strict'.

----------
assignee: docs at python
components: Documentation
messages: 330454
nosy: docs at python, rhettinger
priority: normal
severity: normal
status: open
title: Check accuracy of str() doc string for its encoding argument
versions: Python 3.6, Python 3.7, Python 3.8

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

From report at bugs.python.org  Mon Nov 26 14:07:25 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 26 Nov 2018 19:07:25 +0000
Subject: [docs] [issue35318] Check accuracy of str() doc string for its
 encoding argument
In-Reply-To: <1543258146.71.0.788709270274.issue35318@psf.upfronthosting.co.za>
Message-ID: <1543259245.26.0.788709270274.issue35318@psf.upfronthosting.co.za>


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

>>> str(buffer, errors='strict')
'lim x ? ?, 1/sin?(x)'

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

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

From report at bugs.python.org  Mon Nov 26 14:15:58 2018
From: report at bugs.python.org (Kevin Norris)
Date: Mon, 26 Nov 2018 19:15:58 +0000
Subject: [docs] [issue35319] pkgutil.get_data() is a wrapper for a
 deprecated class
Message-ID: <1543259758.29.0.788709270274.issue35319@psf.upfronthosting.co.za>


New submission from Kevin Norris <nykevin.norris at gmail.com>:

pkgutil.get_data()'s documentation[1] says it is a wrapper for importlib.abc.ResourceLoader.get_data(), but the latter's documentation[2] says the whole class is deprecated since 3.7.

Please either:

A. Formally deprecate pkgutil.get_data() (and ideally provide a "nice" alternative wrapper, so that I don't have to muck about with importlib's endless heterarchy of opaque objects which return other opaque objects).
B. Modify pkgutil.get_data() to use ResourceReader instead of ResourceLoader.
C. (A) or (B) has already been done, just document it.

[1]: https://docs.python.org/3/library/pkgutil.html#pkgutil.get_data
[2]: https://docs.python.org/3.8/library/importlib.html#importlib.abc.ResourceLoader

----------
assignee: docs at python
components: Documentation, Library (Lib)
messages: 330456
nosy: Kevin.Norris, docs at python
priority: normal
severity: normal
status: open
title: pkgutil.get_data() is a wrapper for a deprecated class
type: behavior
versions: Python 3.7, Python 3.8

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

From report at bugs.python.org  Mon Nov 26 14:20:31 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 26 Nov 2018 19:20:31 +0000
Subject: [docs] [issue35318] Check accuracy of str() doc string for its
 encoding argument
In-Reply-To: <1543258146.71.0.788709270274.issue35318@psf.upfronthosting.co.za>
Message-ID: <1543260031.0.0.788709270274.issue35318@psf.upfronthosting.co.za>


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

We may need to reword this a bit to show that the default system encoding only applies if "errors" is specified; otherwise, the argument pattern is mysterious.

----------

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

From report at bugs.python.org  Mon Nov 26 14:37:58 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 26 Nov 2018 19:37:58 +0000
Subject: [docs] [issue35318] Check accuracy of str() doc string for its
 encoding argument
In-Reply-To: <1543258146.71.0.788709270274.issue35318@psf.upfronthosting.co.za>
Message-ID: <1543261078.09.0.788709270274.issue35318@psf.upfronthosting.co.za>


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

Is not it exactly what the docsting says?

> If encoding or
> errors is specified, then the object must expose a data buffer
> that will be decoded using the given encoding and error handler.
> Otherwise, returns the result of object.__str__() (if defined)
> or repr(object).

----------

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

From Amani.slamaa at fci.svu.edu.eg  Mon Nov 26 08:41:20 2018
From: Amani.slamaa at fci.svu.edu.eg (Amani slamaa)
Date: Mon, 26 Nov 2018 13:41:20 +0000
Subject: [docs] How to use python in the web book
Message-ID: <AM0PR03MB4916708F62A3351F73836D70E9D70@AM0PR03MB4916.eurprd03.prod.outlook.com>


Hello
I need the full PDF of " how to use python in the web" book , where the contents of it is available. I use python language in my labs with my students. And the content of book refer to an easy and helpful
Eng.Amani A.Slamaa
Lecture assistance
Information system department
Computer and information sciences faculty
South valley university
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181126/3544290e/attachment.html>

From jules.lasne at gmail.com  Mon Nov 26 09:18:25 2018
From: jules.lasne at gmail.com (Jules Lasne)
Date: Mon, 26 Nov 2018 15:18:25 +0100
Subject: [docs] move https://www.python.org/download/releases/2.3/mro/
 into documentation
In-Reply-To: <CAKJVQ8-u0FYrS-cpb7ii2g+hOA6YMiGyvJhB96c4=QPZO3G+mw@mail.gmail.com>
References: <CAKJVQ8-u0FYrS-cpb7ii2g+hOA6YMiGyvJhB96c4=QPZO3G+mw@mail.gmail.com>
Message-ID: <CAC=u-ihaiNe=0FS_9bCCGyr833OC6iU=JT5vGVTF99m-UXqh1g@mail.gmail.com>

I totally agree with you Mathieu and I'd be pleased to help/translate if
needed.

Regards,
Jules Lasne
+33640736355
jules.lasne at gmail.com
juleslasne.com


Le lun. 26 nov. 2018 ? 15:09, Mathieu Dupuy <deronnax at gmail.com> a ?crit :

> Hello documentation fellows.
> In Python documentation, many times, when talking about MRO, the
> documentation invite you read an article located at
> https://www.python.org/download/releases/2.3/mro/.
>
> I think this is wrong many levels :
> * It should be in the documentation itself
> * why the is it under "download/release" ??
> * I know new style classes come with Python 2.3 but we drop references to
> that ?
>
> * bonus : in the current state it cannot be translated (that's while I was
> translating that I ran into many references to it)
> (and I since MRO is already not simple by itself, it's something
> non-native English speaker would *love* to read in their native language)
>
> For what I've read of Python documentation, that article is the only one
> really explaining the MRO, it's kind of the reference.
> I think that's a pretty serious issue and it should be quickly copied into
> the documentation and links to it be dropped.
>
> If you agree, I'll open an issue
>
> To locate the references to the link:
> $ grep '\/mro' -r Doc
> Doc/glossary.rst:      <https://www.python.org/download/releases/2.3/mro/>`_
> for details of the
> Doc/reference/datamodel.rst:
> https://www.python.org/download/releases/2.3/mro/.
> Doc/tutorial/classes.rst:https://www.python.org/download/releases/2.3/mro/
> .
> Doc/whatsnew/2.3.rst:  `"Python 2.3 Method Resolution Order" <
> http://www.phyast.pitt.edu/~micheles/mro.html>`_, or
>
> _______________________________________________
> docs mailing list
> docs at python.org
> https://mail.python.org/mailman/listinfo/docs
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181126/cfa1fc3c/attachment-0001.html>

From will8clark at gmail.com  Wed Nov 21 05:33:38 2018
From: will8clark at gmail.com (Will Clark)
Date: Wed, 21 Nov 2018 10:33:38 +0000
Subject: [docs] What are the rules for local and global variables in Python?
Message-ID: <2771A4C7-D66B-4205-9AF8-978A8B5F9A7D@gmail.com>

I am a new programmer so feel I have a great propensity to be wrong here, but I wonder if the phrasing here is correct, emphasis mine:

https://docs.python.org/3/faq/programming.html#what-are-the-rules-for-local-and-global-variables-in-python



??"
What are the rules for local and global variables in Python?

In Python, variables that are only referenced __inside__ a function are implicitly global. If a variable is assigned a value anywhere within the function?s body, it?s assumed to be a local unless explicitly declared as global. ...
???



The text reads that variables which are _only_ referenced *inside* a function will be global, surely this should be *outside*, which I think would also make the following sentence make more sense.






Cheers,
Will





-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181121/14d050f8/attachment.html>

From report at bugs.python.org  Mon Nov 26 18:00:16 2018
From: report at bugs.python.org (=?utf-8?b?R8Opcnk=?=)
Date: Mon, 26 Nov 2018 23:00:16 +0000
Subject: [docs] [issue35320] Writable __spec__.has_location attribute
Message-ID: <1543273216.1.0.788709270274.issue35320@psf.upfronthosting.co.za>


New submission from G?ry <gery.ogam at gmail.com>:

How to reproduce:
Assign the __spec__.has_location attribute of any module.

Observed result:
__spec__.has_location is a writable.

Expected result:
__spec__.has_location should be read-only, as defined in PEP 451: https://www.python.org/dev/peps/pep-0451/#attributes

----------
components: Library (Lib)
messages: 330474
nosy: barry, brett.cannon, docs at python, eric.snow, maggyero, mdk, ncoghlan
priority: normal
severity: normal
status: open
title: Writable __spec__.has_location attribute
type: behavior
versions: Python 3.7

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

From report at bugs.python.org  Mon Nov 26 18:18:26 2018
From: report at bugs.python.org (=?utf-8?b?R8Opcnk=?=)
Date: Mon, 26 Nov 2018 23:18:26 +0000
Subject: [docs] [issue35320] Writable __spec__.has_location attribute
In-Reply-To: <1543273216.1.0.788709270274.issue35320@psf.upfronthosting.co.za>
Message-ID: <1543274306.86.0.702299269573.issue35320@psf.upfronthosting.co.za>


Change by G?ry <gery.ogam at gmail.com>:


----------
nosy:  -maggyero

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

From report at bugs.python.org  Mon Nov 26 18:19:31 2018
From: report at bugs.python.org (=?utf-8?b?R8Opcnk=?=)
Date: Mon, 26 Nov 2018 23:19:31 +0000
Subject: [docs] [issue35321] None _frozen_importlib.__spec__.origin attribute
Message-ID: <1543274371.24.0.788709270274.issue35321@psf.upfronthosting.co.za>


New submission from G?ry <gery.ogam at gmail.com>:

How to reproduce:
In Python:
> import _frozen_importlib
> print(_frozen_importlib.__spec__.origin)

Observed result:
The __spec__.origin attribute of the _frozen_importlib module is None.

Expected result:
The __spec__.origin attribute of the _frozen_importlib module should be 'frozen', like it is already the case for the _frozen_importlib_external module and documented for all frozen modules in PEP 451: https://www.python.org/dev/peps/pep-0451/#origin

----------
components: Library (Lib)
messages: 330479
nosy: barry, brett.cannon, docs at python, eric.snow, maggyero, mdk, ncoghlan
priority: normal
severity: normal
status: open
title: None _frozen_importlib.__spec__.origin attribute
versions: Python 3.7

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

From report at bugs.python.org  Mon Nov 26 18:20:11 2018
From: report at bugs.python.org (=?utf-8?b?R8Opcnk=?=)
Date: Mon, 26 Nov 2018 23:20:11 +0000
Subject: [docs] [issue35320] Writable __spec__.has_location attribute
In-Reply-To: <1543273216.1.0.788709270274.issue35320@psf.upfronthosting.co.za>
Message-ID: <1543274411.19.0.702299269573.issue35320@psf.upfronthosting.co.za>


Change by G?ry <gery.ogam at gmail.com>:


----------
nosy: +maggyero

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

From report at bugs.python.org  Tue Nov 27 01:10:06 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Tue, 27 Nov 2018 06:10:06 +0000
Subject: [docs] [issue35320] Writable __spec__.has_location attribute
In-Reply-To: <1543273216.1.0.788709270274.issue35320@psf.upfronthosting.co.za>
Message-ID: <1543299006.58.0.702299269573.issue35320@psf.upfronthosting.co.za>


Change by Karthikeyan Singaravelan <tir.karthi at gmail.com>:


----------
nosy: +xtreak

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

From report at bugs.python.org  Tue Nov 27 01:54:08 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Tue, 27 Nov 2018 06:54:08 +0000
Subject: [docs] [issue35320] Writable __spec__.has_location attribute
In-Reply-To: <1543273216.1.0.788709270274.issue35320@psf.upfronthosting.co.za>
Message-ID: <1543301648.28.0.788709270274.issue35320@psf.upfronthosting.co.za>


Karthikeyan Singaravelan <tir.karthi at gmail.com> added the comment:

I think a setter was added for has_location (msg205384) and docs were updated as part of the patch but the PEP was not updated? . A setter for has_location : https://hg.python.org/cpython/rev/e961a166dc70

----------

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

From report at bugs.python.org  Tue Nov 27 02:27:04 2018
From: report at bugs.python.org (Stefan Bauer (TraceTronic))
Date: Tue, 27 Nov 2018 07:27:04 +0000
Subject: [docs] [issue35325] imp.find_module() return value documentation
 discrepancy
Message-ID: <1543303624.81.0.788709270274.issue35325@psf.upfronthosting.co.za>


New submission from Stefan Bauer (TraceTronic) <stefan.bauer at tracetronic.de>:

I?d like to report a discrepancy between the documentation and implementation of the method imp.find_module().

The documentation <https://docs.python.org/3.7/library/imp.html#imp.find_module> currently says ?If the module does not live in a file, the returned file is None, pathname is the __empty_string__, [?]?

The implementation <https://github.com/python/cpython/blob/master/Lib/imp.py#L272>, on the other hand, returns __None__ for built-in and frozen modules.

Yours,
Stefan

----------
assignee: docs at python
components: Documentation
messages: 330495
nosy: StefanBauerTT, docs at python
priority: normal
severity: normal
status: open
title: imp.find_module() return value documentation discrepancy
versions: Python 3.7, Python 3.8

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

From jules.lasne at gmail.com  Tue Nov 27 03:02:33 2018
From: jules.lasne at gmail.com (Jules Lasne)
Date: Tue, 27 Nov 2018 09:02:33 +0100
Subject: [docs] What are the rules for local and global variables in
 Python?
In-Reply-To: <2771A4C7-D66B-4205-9AF8-978A8B5F9A7D@gmail.com>
References: <2771A4C7-D66B-4205-9AF8-978A8B5F9A7D@gmail.com>
Message-ID: <CAC=u-iiREiZ0NJeX49TFdzQ7Q=AxRwrKL_hPnAjgsNycSLrAPQ@mail.gmail.com>

Hi Will,

I agree with you, although I am not a Python expert either

Regards,
Jules Lasne
+33640736355
jules.lasne at gmail.com
juleslasne.com


Le lun. 26 nov. 2018 ? 22:57, Will Clark <will8clark at gmail.com> a ?crit :

> I am a new programmer so feel I have a great propensity to be wrong here,
> but I wonder if the phrasing here is correct, emphasis mine:
>
>
> https://docs.python.org/3/faq/programming.html#what-are-the-rules-for-local-and-global-variables-in-python
>
>
>
> ??"
> What are the rules for local and global variables in Python?
>
> In Python, variables that are only referenced __inside__ a function are
> implicitly global. If a variable is assigned a value anywhere within the
> function?s body, it?s assumed to be a local unless explicitly declared as
> global. ...
> ???
>
>
>
> The text reads that variables which are _only_ referenced *inside* a
> function will be global, surely this should be *outside*, which I think
> would also make the following sentence make more sense.
>
>
>
>
>
>
> Cheers,
> Will
>
>
>
>
>
> _______________________________________________
> docs mailing list
> docs at python.org
> https://mail.python.org/mailman/listinfo/docs
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181127/b367150f/attachment.html>

From report at bugs.python.org  Tue Nov 27 11:43:56 2018
From: report at bugs.python.org (Hans Strijker)
Date: Tue, 27 Nov 2018 16:43:56 +0000
Subject: [docs] [issue35329] Documentation - capitalization issue
Message-ID: <1543337036.72.0.788709270274.issue35329@psf.upfronthosting.co.za>


New submission from Hans Strijker <hans at stry.org>:

In the documentation I noticed "from Package import specific_submodule". I recon package should be all lowercase in accordance with pep8.
(https://www.python.org/dev/peps/pep-0008/#package-and-module-names)

It may be far from the most important bug ever, but it's my first bug reported, and gotta start small... :-)

https://docs.python.org/3/tutorial/modules.html#importing-from-a-package

6.4.1. Importing * From a Package
...
Remember, there is nothing wrong with using from Package import specific_submodule! In fact, this is the recommended notation unless the importing module needs to use submodules with the same name from different packages.

----------
assignee: docs at python
components: Documentation
messages: 330537
nosy: Strijker, docs at python
priority: normal
severity: normal
status: open
title: Documentation - capitalization issue
versions: Python 3.7

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

From report at bugs.python.org  Tue Nov 27 18:32:49 2018
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 27 Nov 2018 23:32:49 +0000
Subject: [docs] [issue35320] Writable __spec__.has_location attribute
In-Reply-To: <1543273216.1.0.788709270274.issue35320@psf.upfronthosting.co.za>
Message-ID: <1543361569.89.0.788709270274.issue35320@psf.upfronthosting.co.za>


Brett Cannon <brett at python.org> added the comment:

The docs do not specify that has_location is read-only: https://docs.python.org/3/library/importlib.html#importlib.machinery.ModuleSpec.has_location .

And PEPs are not updated once they are implemented as that would mean we would have to perpetually update docs in at least two different places.

----------
resolution:  -> out of date
stage:  -> resolved
status: open -> closed

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

From report at bugs.python.org  Tue Nov 27 18:43:17 2018
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 27 Nov 2018 23:43:17 +0000
Subject: [docs] [issue35319] pkgutil.get_data() is a wrapper for a
 deprecated class
In-Reply-To: <1543259758.29.0.788709270274.issue35319@psf.upfronthosting.co.za>
Message-ID: <1543362197.79.0.788709270274.issue35319@psf.upfronthosting.co.za>


Brett Cannon <brett at python.org> added the comment:

You can use importlib.resources to read data files and such from within a package as an alternative.

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

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

From sbarter510 at gmail.com  Tue Nov 27 23:07:40 2018
From: sbarter510 at gmail.com (stephen barter)
Date: Tue, 27 Nov 2018 20:07:40 -0800
Subject: [docs] Help with docs
Message-ID: <CADNPf6Rd1sZunE+pM=yr_jDNNudsq=1W5OuAWBTfiZkh=mbDxg@mail.gmail.com>

Hello, I have noticed a few modules that lack documentation and would love
to contribute. Please let me know how I can help. Cheers.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181127/3cb89e14/attachment.html>

From julien at palard.fr  Wed Nov 28 10:47:50 2018
From: julien at palard.fr (Julien Palard)
Date: Wed, 28 Nov 2018 15:47:50 +0000
Subject: [docs] Help with docs
In-Reply-To: <CADNPf6Rd1sZunE+pM=yr_jDNNudsq=1W5OuAWBTfiZkh=mbDxg@mail.gmail.com>
References: <CADNPf6Rd1sZunE+pM=yr_jDNNudsq=1W5OuAWBTfiZkh=mbDxg@mail.gmail.com>
Message-ID: <hsVMMxQObvhnbKBynGSOzmZg3hcVa12q8bwtFB3HbWgWZYdQ7WeIMQkcgQ1Y_KlcYBcywYZp3t4hCibJyyF4-iZSg1Ix5LM9jD4An6XznEg=@palard.fr>

Hi and welcome,

> I have noticed a few modules that lack documentation and would love to contribute. Please let me know how I can help.

Documentation lies in the cpython repository [1] in the Doc/ directory.

In the devguide [2] there's a whole section on how to help with the documentation, and how to build it locally so you can proofread yourself in the HTML version.

[1]: https://github.com/python/cpython/
[2]: https://devguide.python.org/docquality/

Bests,
--?
Julien Palard
https://mdk.fr


From g.brandl at gmx.net  Thu Nov 29 11:39:11 2018
From: g.brandl at gmx.net (Georg Brandl)
Date: Thu, 29 Nov 2018 17:39:11 +0100
Subject: [docs] subscribe_policy ?
In-Reply-To: <CAKJDb-P_rtteBnnHvGragpPZ1zQzitRgpi+XB-KeLX1H7_u7kw@mail.gmail.com>
References: <BiXOAdybU9SQjR3TNhQd6JN9Ms0FAgOsZiI1z-RHDqV1cisyO09kH5-FAk_tqcERG7b8T-7KSeNqxskOVyYbHavkhj12T_gMEnvgMWCR3YM=@palard.fr>
 <CAKJDb-P_rtteBnnHvGragpPZ1zQzitRgpi+XB-KeLX1H7_u7kw@mail.gmail.com>
Message-ID: <3575344b-5227-0e04-8d47-e006122abad7@gmx.net>

On 11/29/18 4:06 PM, Zachary Ware wrote:
> On Thu, Nov 29, 2018 at 1:10 AM Julien Palard <julien at palard.fr> wrote:
>>
>> Hi docs-owner (zware?)
>>
>> Was asking myself why this list have a subscribe_policy requiring manual approval (there's currently one held subscription)?
> 
> Don't know.  I'm also not sure who actually owns this list these days
> (I'm only a moderator) :)

You do, now.  Have fun :)

Georg

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 195 bytes
Desc: OpenPGP digital signature
URL: <http://mail.python.org/pipermail/docs/attachments/20181129/bb09ce95/attachment.sig>

From report at bugs.python.org  Thu Nov 29 13:16:58 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 29 Nov 2018 18:16:58 +0000
Subject: [docs] [issue35190] collections.abc.Sequence cannot be used to test
 whether a class provides a particular interface (doc issue)
In-Reply-To: <1541688086.42.0.788709270274.issue35190@psf.upfronthosting.co.za>
Message-ID: <1543515418.79.0.788709270274.issue35190@psf.upfronthosting.co.za>


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

This looks like a duplicate of issue23864 and issue25737.

----------

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

From jonathanberger at gmail.com  Thu Nov 29 12:10:34 2018
From: jonathanberger at gmail.com (Jonathan Berger)
Date: Thu, 29 Nov 2018 09:10:34 -0800
Subject: [docs] Could I help make the sidebar more useful?
Message-ID: <CAN1jqrLeYaaG3ynzGfrRr5+__J1miq0Ct3J_FARzK5++dWFDGg@mail.gmail.com>

Hello,

Thank you for your work on Python and its documentation. It sets an
amazingly high bar and serves as an example to all.

I'd love to improve it. Good reference documents have tables of contents so
readers can quickly grasp the scope of the reference and jump to relevant
parts. A good example is the table at the top of this page:
https://docs.python.org/3/library/functions.html

On the other hand, this page (and most of the standard library pages)
suffer:
https://docs.python.org/3/library/os.path.html
There's no quick way for a reader to scan all of the functions in the
module or jump to a relevant function.

A good place to put such a function list would be the lefthand sidebar.

Assuming this idea has been discussed before, could someone share whether
there is support for it and the effort involved? I could imagine starting
with just one standard library page as a prototype.

Thanks,
Jonathan
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181129/f5c2b017/attachment.html>

From report at bugs.python.org  Thu Nov 29 18:29:04 2018
From: report at bugs.python.org (Ivan Levkivskyi)
Date: Thu, 29 Nov 2018 23:29:04 +0000
Subject: [docs] [issue35190] collections.abc.Sequence cannot be used to test
 whether a class provides a particular interface (doc issue)
In-Reply-To: <1541688086.42.0.788709270274.issue35190@psf.upfronthosting.co.za>
Message-ID: <1543534144.4.0.788709270274.issue35190@psf.upfronthosting.co.za>


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

I would propose to keep this one open as a superseding https://bugs.python.org/issue23864 and close the latter (assuming we are not going to make all classes protocols, we I think we really shouldn't, and instead we should improve the docs).

----------

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

From report at bugs.python.org  Thu Nov 29 19:40:10 2018
From: report at bugs.python.org (Windson Yang)
Date: Fri, 30 Nov 2018 00:40:10 +0000
Subject: [docs] [issue35325] imp.find_module() return value documentation
 discrepancy
In-Reply-To: <1543303624.81.0.788709270274.issue35325@psf.upfronthosting.co.za>
Message-ID: <1543538410.81.0.788709270274.issue35325@psf.upfronthosting.co.za>


Windson Yang <wiwindson at outlook.com> added the comment:

If I understand correctly, this may be better.

Try to find the module name. If path is omitted or None, the list of directory names given by sys.path is searched. If path is built-in or frozen modules, return None instead.

BTW, the dosstring should also be updated, I will not continue search the path if the path in build-in or frozen. and this module is deprecated since version 3.4

----------
nosy: +Windson Yang
versions: +Python 3.4, Python 3.5, Python 3.6

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

From report at bugs.python.org  Fri Nov 30 04:38:07 2018
From: report at bugs.python.org (Lysandros Nikolaou)
Date: Fri, 30 Nov 2018 09:38:07 +0000
Subject: [docs] [issue30410] Documentation for sys.stdout encoding does not
 reflect the new Windows behavior in Python 3.6+
In-Reply-To: <1495270729.75.0.717879181788.issue30410@psf.upfronthosting.co.za>
Message-ID: <1543570687.11.0.788709270274.issue30410@psf.upfronthosting.co.za>


Lysandros Nikolaou <lisandrosnik at gmail.com> added the comment:

Ping.

----------

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

From report at bugs.python.org  Fri Nov 30 04:58:49 2018
From: report at bugs.python.org (Paul Moore)
Date: Fri, 30 Nov 2018 09:58:49 +0000
Subject: [docs] [issue30410] Documentation for sys.stdout encoding does not
 reflect the new Windows behavior in Python 3.6+
In-Reply-To: <1495270729.75.0.717879181788.issue30410@psf.upfronthosting.co.za>
Message-ID: <1543571929.76.0.788709270274.issue30410@psf.upfronthosting.co.za>


Paul Moore <p.f.moore at gmail.com> added the comment:

The proposed wording seems a bit over-complex to me. Maybe the following re-wording would be easier to understand?

    The character encoding is platform-dependent. Non-Windows 
    platforms use the locale encoding (see 
    locale.getpreferredencoding()).

    On Windows, UTF-8 is used for the console device.  Non-character
    devices such as disk files and pipes use the system locale
    encoding (i.e. the ANSI codepage).  Non-console character
    devices such as NUL (i.e. where isatty() returns True) use the
    value of the console input and output codepages at startup,
    respectively for stdin and stdout/stderr. This defaults to the
    system locale encoding if the process is not initially attached
    to a console.

    The special behaviour of the console can be overridden
    by setting the environment variable PYTHONLEGACYWINDOWSSTDIO
    before starting Python. In that case, the console codepages are
    used as for any other character device.

    Under all platforms, you can override this value by
    setting the PYTHONIOENCODING environment variable before
    starting Python. However, for the Windows console, this
    only applies when PYTHONLEGACYWINDOWSSTDIO is also set.

----------

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

From report at bugs.python.org  Fri Nov 30 14:55:18 2018
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 30 Nov 2018 19:55:18 +0000
Subject: [docs] [issue35358] Document that importlib.import_module accepts
 names that are not valid Python syntax
In-Reply-To: <1543566651.92.0.788709270274.issue35358@psf.upfronthosting.co.za>
Message-ID: <1543607718.32.0.788709270274.issue35358@psf.upfronthosting.co.za>


Brett Cannon <brett at python.org> added the comment:

I agree that this shouldn't change and at best can be a documentation update to mention the fact that importlib.import_module() doesn't restrict itself to valid syntax names on purpose.

----------
assignee:  -> docs at python
components: +Documentation
nosy: +docs at python
priority: normal -> low
title: avoid '-' in importlib.import_module and builtins.__import__ -> Document that importlib.import_module accepts names that are not valid Python syntax

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

From report at bugs.python.org  Fri Nov 30 22:48:04 2018
From: report at bugs.python.org (Ben Finney)
Date: Sat, 01 Dec 2018 03:48:04 +0000
Subject: [docs] [issue33130] functools.reduce signature uses `iterable`,
 documentation should use the same term
In-Reply-To: <1521849944.24.0.467229070634.issue33130@psf.upfronthosting.co.za>
Message-ID: <1543636084.7.0.788709270274.issue33130@psf.upfronthosting.co.za>


Ben Finney <ben+python at benfinney.id.au> added the comment:

The library documentation (e.g. file:///usr/share/doc/python3/html/library/functools.html#functools.reduce ) also has this dissonance:

>  functools.reduce(`function`, `iterable` [, `initializer` ])
>
>    Apply function of two arguments cumulatively to the items of `sequence`, from left to right, so as to reduce the sequence to a single value.

----------
nosy: +bignose
title: functools.reduce signature/docstring discordance -> functools.reduce signature uses `iterable`, documentation should use the same term

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

From report at bugs.python.org  Fri Nov 30 22:49:52 2018
From: report at bugs.python.org (Ben Finney)
Date: Sat, 01 Dec 2018 03:49:52 +0000
Subject: [docs] [issue33130] functools.reduce signature uses `iterable`,
 documentation should use the same term
In-Reply-To: <1521849944.24.0.467229070634.issue33130@psf.upfronthosting.co.za>
Message-ID: <1543636192.2.0.788709270274.issue33130@psf.upfronthosting.co.za>


Ben Finney <ben+python at benfinney.id.au> added the comment:

Hah, sorry to use a local-filesystem URL. (Hooray for locally-installed developer documentation!)

The same section is online at https://docs.python.org/3/library/functools.html#functools.reduce .

----------

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