From report at bugs.python.org  Fri Mar  1 11:36:40 2019
From: report at bugs.python.org (Eric Snow)
Date: Fri, 01 Mar 2019 16:36:40 +0000
Subject: [docs] [issue36157] Document PyInterpreterState_Main().
Message-ID: <1551458200.72.0.727788487318.issue36157@roundup.psfhosted.org>


New submission from Eric Snow <ericsnowcurrently at gmail.com>:

PyInterpreterState_Main() is a function in the public C-API that returns a pointer to the main interpreter's state.  The main interpreter is the first one created by the CPython runtime during startup (e.g. when the "python" command is run).

Documentation for PyInterpreterState_Main() should be on the "Initialization, Finalization, and Threads" page of the C-API docs, probably in the "Sub-interpreter support" section. [1]  It could also possibly go in the "Advanced Debugger Support" section. [2]

FYI, I added PyInterpreterState_Main() at PyCon US 2017 (commit f5df46d701d29baf738365da6fcf1b8a3ceabb71) when I merged Nick Coghlan's internal implementation of PEP 432.  So it has been available since 3.7.


[1] https://docs.python.org/3/c-api/init.html#sub-interpreter-support
[2] https://docs.python.org/3/c-api/init.html#advanced-debugger-support

----------
assignee: docs at python
components: Documentation
keywords: easy
messages: 336929
nosy: docs at python, eric.snow
priority: normal
severity: normal
stage: needs patch
status: open
title: Document PyInterpreterState_Main().
versions: Python 3.7, Python 3.8

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

From report at bugs.python.org  Fri Mar  1 12:01:12 2019
From: report at bugs.python.org (Sridhar Iyer)
Date: Fri, 01 Mar 2019 17:01:12 +0000
Subject: [docs] [issue36153] Freeze support documentation is misleading.
In-Reply-To: <1551401372.79.0.134624139836.issue36153@roundup.psfhosted.org>
Message-ID: <1551459672.59.0.436145812276.issue36153@roundup.psfhosted.org>


Sridhar Iyer <sridhar.v.iyer at gmail.com> added the comment:

Please find the attached python file where the issue is seen.
The cli to create an executable was:
$pyinstaller run_server_min.spec

Here are the contents of the file (this doesn't support multiple file uploads):
================
# -*- mode: python ; coding: utf-8 -*-

block_cipher = None


a = Analysis(['run_server_min.py'],
             pathex=['<PUT ABSOLUTE PATH OF ABOVE FILE HERE>'],
             binaries=[],
             datas=[],
             hiddenimports=['sklearn.neighbors.typedefs', 'sklearn.neighbors.quad_tree', 'sklearn.tree._utils', 'xgboost', 'xgboost.libpath'],
             hookspath=['pyhooks'],
             runtime_hooks=[],
             excludes=[],
             win_no_prefer_redirects=False,
             win_private_assemblies=False,
             cipher=block_cipher,
             noarchive=False)
pyz = PYZ(a.pure, a.zipped_data,
             cipher=block_cipher)
exe = EXE(pyz,
          a.scripts,
          a.binaries,
          a.zipfiles,
          a.datas,
          [],
          name='run_server_min',
          debug=False,
          bootloader_ignore_signals=False,
          strip=False,
          upx=False,
          runtime_tmpdir=None,
          console=True )
=========

$ pyinstaller run_server_min.spec
69 INFO: PyInstaller: 3.5.dev0+cb8d10af6
69 INFO: Python: 3.6.7
70 INFO: Platform: Linux-3.16.0-77-generic-x86_64-with-debian-jessie-sid
...

When your run ./dist/run_server_min that is generated, it'll spawn the process multiple times. The issue goes away when you add freeze_support on the top.

----------
Added file: https://bugs.python.org/file48182/run_server_min.py

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

From report at bugs.python.org  Fri Mar  1 15:32:53 2019
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 01 Mar 2019 20:32:53 +0000
Subject: [docs] [issue36153] Freeze support documentation is misleading.
In-Reply-To: <1551401372.79.0.134624139836.issue36153@roundup.psfhosted.org>
Message-ID: <1551472373.41.0.484275299196.issue36153@roundup.psfhosted.org>


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


----------
nosy: +davin, pitrou

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

From report at bugs.python.org  Fri Mar  1 15:36:54 2019
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 01 Mar 2019 20:36:54 +0000
Subject: [docs] [issue35843] importlib.util docs for namespace packages
 innaccurate
In-Reply-To: <1548698590.94.0.426601552573.issue35843@roundup.psfhosted.org>
Message-ID: <1551472614.17.0.553938492092.issue35843@roundup.psfhosted.org>


Brett Cannon <brett at python.org> added the comment:

Anyone have an opinion about the __getitem__ proposal? I'm fine with it but I wanted to make sure other import + namespace folks don't disagree.

----------

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

From report at bugs.python.org  Fri Mar  1 21:29:09 2019
From: report at bugs.python.org (Yasser Alshalaan)
Date: Sat, 02 Mar 2019 02:29:09 +0000
Subject: [docs] [issue36138] Improve documentation about converting
 datetime.timedelta to scalars
In-Reply-To: <1551279277.78.0.420201199405.issue36138@roundup.psfhosted.org>
Message-ID: <1551493749.42.0.253086368425.issue36138@roundup.psfhosted.org>


Yasser Alshalaan <yalshalaan at gmail.com> added the comment:

I'll do this in a moment I'll have the PR

----------
nosy: +Yasser Alshalaan

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

From report at bugs.python.org  Fri Mar  1 22:29:25 2019
From: report at bugs.python.org (Yasser Alshalaan)
Date: Sat, 02 Mar 2019 03:29:25 +0000
Subject: [docs] [issue36138] Improve documentation about converting
 datetime.timedelta to scalars
In-Reply-To: <1551279277.78.0.420201199405.issue36138@roundup.psfhosted.org>
Message-ID: <1551497365.83.0.791273544482.issue36138@roundup.psfhosted.org>


Change by Yasser Alshalaan <yalshalaan at gmail.com>:


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

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

From report at bugs.python.org  Fri Mar  1 23:58:48 2019
From: report at bugs.python.org (Yasser Alshalaan)
Date: Sat, 02 Mar 2019 04:58:48 +0000
Subject: [docs] [issue36138] Improve documentation about converting
 datetime.timedelta to scalars
In-Reply-To: <1551279277.78.0.420201199405.issue36138@roundup.psfhosted.org>
Message-ID: <1551502728.3.0.922254542912.issue36138@roundup.psfhosted.org>


Change by Yasser Alshalaan <yalshalaan at gmail.com>:


----------
pull_requests: +12139

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

From report at bugs.python.org  Sat Mar  2 00:42:27 2019
From: report at bugs.python.org (Yasser Alshalaan)
Date: Sat, 02 Mar 2019 05:42:27 +0000
Subject: [docs] [issue36138] Improve documentation about converting
 datetime.timedelta to scalars
In-Reply-To: <1551279277.78.0.420201199405.issue36138@roundup.psfhosted.org>
Message-ID: <1551505347.29.0.435593854611.issue36138@roundup.psfhosted.org>


Change by Yasser Alshalaan <yalshalaan at gmail.com>:


----------
pull_requests:  -12138

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

From report at bugs.python.org  Sat Mar  2 01:49:17 2019
From: report at bugs.python.org (Joannah Nanjekye)
Date: Sat, 02 Mar 2019 06:49:17 +0000
Subject: [docs] [issue36008] [good first issue] Update documentation for 3.8
In-Reply-To: <1550278435.56.0.94881175235.issue36008@roundup.psfhosted.org>
Message-ID: <1551509357.65.0.662820435132.issue36008@roundup.psfhosted.org>


Joannah Nanjekye <nanjekyejoannah at gmail.com> added the comment:

@Mariatta this issue https://bugs.python.org/issue36157 also looks like one you can track for the mentored sprint at PyCon.

----------
nosy: +nanjekyejoannah

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

From report at bugs.python.org  Sat Mar  2 01:50:40 2019
From: report at bugs.python.org (Joannah Nanjekye)
Date: Sat, 02 Mar 2019 06:50:40 +0000
Subject: [docs] [issue36157] Document PyInterpreterState_Main().
In-Reply-To: <1551458200.72.0.727788487318.issue36157@roundup.psfhosted.org>
Message-ID: <1551509440.2.0.759094063107.issue36157@roundup.psfhosted.org>


Joannah Nanjekye <nanjekyejoannah at gmail.com> added the comment:

@Mariatta do you want to keep this for the mentored sprint at PyCon?

----------
nosy: +nanjekyejoannah

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

From report at bugs.python.org  Sat Mar  2 13:42:19 2019
From: report at bugs.python.org (Lysandros Nikolaou)
Date: Sat, 02 Mar 2019 18:42:19 +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: <1551552139.9.0.593993702828.issue22021@roundup.psfhosted.org>


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

Pinging once more for review.

----------

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

From report at bugs.python.org  Sat Mar  2 13:43:58 2019
From: report at bugs.python.org (Lysandros Nikolaou)
Date: Sat, 02 Mar 2019 18:43:58 +0000
Subject: [docs] [issue21314] Document '/' in signatures
In-Reply-To: <1397988439.5.0.703056699862.issue21314@psf.upfronthosting.co.za>
Message-ID: <1551552238.52.0.280748182371.issue21314@roundup.psfhosted.org>


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

Ping for review.

----------

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

From report at bugs.python.org  Sat Mar  2 16:50:48 2019
From: report at bugs.python.org (A.M. Kuchling)
Date: Sat, 02 Mar 2019 21:50:48 +0000
Subject: [docs] [issue34484] Unicode HOWTO incorrectly refers to Private Use
 Area for surrogateescape
In-Reply-To: <1535058879.5.0.56676864532.issue34484@psf.upfronthosting.co.za>
Message-ID: <1551563448.67.0.0389706043023.issue34484@roundup.psfhosted.org>


Change by A.M. Kuchling <amk at amk.ca>:


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

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

From report at bugs.python.org  Sun Mar  3 02:55:40 2019
From: report at bugs.python.org (Mark Williams)
Date: Sun, 03 Mar 2019 07:55:40 +0000
Subject: [docs] [issue36170] posix_spawn doesn't exist in 3.7
Message-ID: <1551599740.43.0.520469271456.issue36170@roundup.psfhosted.org>


New submission from Mark Williams <mrw at enotuniq.org>:

The 3.8 docs claim that os.posix_spawn was introduced in 3.7, but it wasn't; it will be introduced in 3.8.

https://docs.python.org/3.8/library/os.html#os.posix_spawn

----------
assignee: docs at python
components: Documentation
messages: 337027
nosy: Mark.Williams, docs at python
priority: normal
severity: normal
status: open
title: posix_spawn doesn't exist in 3.7
versions: Python 3.8

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

From report at bugs.python.org  Sun Mar  3 02:57:40 2019
From: report at bugs.python.org (Mark Williams)
Date: Sun, 03 Mar 2019 07:57:40 +0000
Subject: [docs] [issue36170] posix_spawn doesn't exist in 3.7
In-Reply-To: <1551599740.43.0.520469271456.issue36170@roundup.psfhosted.org>
Message-ID: <1551599860.73.0.179525740153.issue36170@roundup.psfhosted.org>


Change by Mark Williams <mrw at enotuniq.org>:


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

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

From report at bugs.python.org  Sun Mar  3 04:18:41 2019
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Sun, 03 Mar 2019 09:18:41 +0000
Subject: [docs] [issue36170] posix_spawn doesn't exist in 3.7
In-Reply-To: <1551599740.43.0.520469271456.issue36170@roundup.psfhosted.org>
Message-ID: <1551604721.81.0.472590533489.issue36170@roundup.psfhosted.org>


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

This was merged into 3.7 and later reverted after 3.7 first beta as per https://bugs.python.org/issue20104#msg316588 . Adding Pablo for review.

----------
nosy: +pablogsal, xtreak

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

From report at bugs.python.org  Sun Mar  3 12:42:28 2019
From: report at bugs.python.org (Ned Deily)
Date: Sun, 03 Mar 2019 17:42:28 +0000
Subject: [docs] [issue36170] posix_spawn doesn't exist in 3.7
In-Reply-To: <1551599740.43.0.520469271456.issue36170@roundup.psfhosted.org>
Message-ID: <1551634948.14.0.330560716199.issue36170@roundup.psfhosted.org>


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


New changeset 8b50400fbe607ef558d6c0033efa697c99417507 by Ned Deily (Mark Williams) in branch 'master':
bpo-36170: posix_spawn doesn't exist on 3.7 (GH-12143)
https://github.com/python/cpython/commit/8b50400fbe607ef558d6c0033efa697c99417507


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

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

From report at bugs.python.org  Sun Mar  3 12:43:19 2019
From: report at bugs.python.org (Ned Deily)
Date: Sun, 03 Mar 2019 17:43:19 +0000
Subject: [docs] [issue36170] posix_spawn doesn't exist in 3.7
In-Reply-To: <1551599740.43.0.520469271456.issue36170@roundup.psfhosted.org>
Message-ID: <1551634999.29.0.641947105543.issue36170@roundup.psfhosted.org>


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

Thanks for the report, Mark!

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

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

From report at bugs.python.org  Sun Mar  3 17:36:45 2019
From: report at bugs.python.org (Brennan D Baraban)
Date: Sun, 03 Mar 2019 22:36:45 +0000
Subject: [docs] [issue23460] Decimals do not obey ':g' exponential notation
 formatting rules
In-Reply-To: <1423847721.13.0.666007782647.issue23460@psf.upfronthosting.co.za>
Message-ID: <1551652605.89.0.356383901235.issue23460@roundup.psfhosted.org>


Brennan D Baraban <375 at holbertonschool.com> added the comment:

Hi Stefan. Is there an update you would like me to make on this PR? Otherwise, pinging for review.

----------

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

From report at bugs.python.org  Sun Mar  3 18:24:07 2019
From: report at bugs.python.org (Barry A. Warsaw)
Date: Sun, 03 Mar 2019 23:24:07 +0000
Subject: [docs] [issue35843] importlib.util docs for namespace packages
 innaccurate
In-Reply-To: <1548698590.94.0.426601552573.issue35843@roundup.psfhosted.org>
Message-ID: <1551655447.81.0.478584232198.issue35843@roundup.psfhosted.org>


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

+1

----------

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

From report at bugs.python.org  Sun Mar  3 23:10:38 2019
From: report at bugs.python.org (A.M. Kuchling)
Date: Mon, 04 Mar 2019 04:10:38 +0000
Subject: [docs] [issue20906] Issues in Unicode HOWTO
In-Reply-To: <1394702187.81.0.00522221343959.issue20906@psf.upfronthosting.co.za>
Message-ID: <1551672638.09.0.009972748448.issue20906@roundup.psfhosted.org>


A.M. Kuchling <amk at amk.ca> added the comment:


New changeset 97c288df614dd7856f5a0336925f56a7a2a5bc74 by Andrew Kuchling in branch 'master':
bpo-20906: Various revisions to the Unicode howto  (#8394)
https://github.com/python/cpython/commit/97c288df614dd7856f5a0336925f56a7a2a5bc74


----------

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

From report at bugs.python.org  Sun Mar  3 23:10:38 2019
From: report at bugs.python.org (A.M. Kuchling)
Date: Mon, 04 Mar 2019 04:10:38 +0000
Subject: [docs] [issue34484] Unicode HOWTO incorrectly refers to Private Use
 Area for surrogateescape
In-Reply-To: <1535058879.5.0.56676864532.issue34484@psf.upfronthosting.co.za>
Message-ID: <1551672638.25.0.522354054177.issue34484@roundup.psfhosted.org>


A.M. Kuchling <amk at amk.ca> added the comment:


New changeset 97c288df614dd7856f5a0336925f56a7a2a5bc74 by Andrew Kuchling in branch 'master':
bpo-20906: Various revisions to the Unicode howto  (#8394)
https://github.com/python/cpython/commit/97c288df614dd7856f5a0336925f56a7a2a5bc74


----------

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

From report at bugs.python.org  Sun Mar  3 23:10:40 2019
From: report at bugs.python.org (miss-islington)
Date: Mon, 04 Mar 2019 04:10:40 +0000
Subject: [docs] [issue20906] Issues in Unicode HOWTO
In-Reply-To: <1394702187.81.0.00522221343959.issue20906@psf.upfronthosting.co.za>
Message-ID: <1551672640.09.0.731277271879.issue20906@roundup.psfhosted.org>


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


----------
pull_requests: +12153

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

From report at bugs.python.org  Sun Mar  3 23:10:40 2019
From: report at bugs.python.org (miss-islington)
Date: Mon, 04 Mar 2019 04:10:40 +0000
Subject: [docs] [issue34484] Unicode HOWTO incorrectly refers to Private Use
 Area for surrogateescape
In-Reply-To: <1535058879.5.0.56676864532.issue34484@psf.upfronthosting.co.za>
Message-ID: <1551672640.19.0.426782338232.issue34484@roundup.psfhosted.org>


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


----------
keywords: +patch
pull_requests: +12154

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

From siuolsiuol3 at gmail.com  Sun Mar  3 15:27:16 2019
From: siuolsiuol3 at gmail.com (MrSiuol Siuol)
Date: Sun, 3 Mar 2019 21:27:16 +0100
Subject: [docs] Problem: Order of operations with a list
Message-ID: <CADGtm3yuEGMDnfES=McseLQ2qU7AzHG3pKUcYKotPMBsp5UeSQ@mail.gmail.com>

There is a problem with: [0]*4/2

"Traceback (most recent call last):
  File "<pyshell#5>", line 1, in <module>
    [0]*4/2
TypeError: unsupported operand type(s) for /: 'list' and 'int'"


Solution: prioritize calcul without list, before duplicate list
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190303/402bc268/attachment.html>

From report at bugs.python.org  Mon Mar  4 07:51:21 2019
From: report at bugs.python.org (Lysandros Nikolaou)
Date: Mon, 04 Mar 2019 12:51:21 +0000
Subject: [docs] [issue36182] Path.write_text() docs do not include the case
 that a file exists
Message-ID: <1551703881.69.0.0731434428442.issue36182@roundup.psfhosted.org>


New submission from Lysandros Nikolaou <lisandrosnik at gmail.com>:

Hi,

in the pathlib.Path.write_bytes() documentation it is clearly stated that "An existing file of the same name is overwritten." Wouldn't it make sense to include something similar to the pathlib.Path.write_text() docs. I had to quickly test it manually to find out what's happening as it wasn't clear to me if the statement applies to write_text() as well.

----------
assignee: docs at python
components: Documentation
messages: 337100
nosy: docs at python, lys.nikolaou
priority: normal
severity: normal
status: open
title: Path.write_text() docs do not include the case that a file exists
versions: Python 3.8

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

From report at bugs.python.org  Mon Mar  4 07:51:48 2019
From: report at bugs.python.org (Lysandros Nikolaou)
Date: Mon, 04 Mar 2019 12:51:48 +0000
Subject: [docs] [issue36182] Path.write_text() docs do not include the case
 that a file exists
In-Reply-To: <1551703881.69.0.0731434428442.issue36182@roundup.psfhosted.org>
Message-ID: <1551703907.99.0.0578453589473.issue36182@roundup.psfhosted.org>


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

For reference, https://docs.python.org/3/library/pathlib.html#pathlib.Path.write_bytes.

----------

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

From report at bugs.python.org  Mon Mar  4 08:01:50 2019
From: report at bugs.python.org (miss-islington)
Date: Mon, 04 Mar 2019 13:01:50 +0000
Subject: [docs] [issue20906] Issues in Unicode HOWTO
In-Reply-To: <1394702187.81.0.00522221343959.issue20906@psf.upfronthosting.co.za>
Message-ID: <1551704510.37.0.877126759878.issue20906@roundup.psfhosted.org>


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


New changeset 84fa6b9e5932af981cb299c0c5ac80b9cc37c3fa by Miss Islington (bot) in branch '3.7':
bpo-20906: Various revisions to the Unicode howto  (GH-8394)
https://github.com/python/cpython/commit/84fa6b9e5932af981cb299c0c5ac80b9cc37c3fa


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

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

From report at bugs.python.org  Mon Mar  4 08:01:50 2019
From: report at bugs.python.org (miss-islington)
Date: Mon, 04 Mar 2019 13:01:50 +0000
Subject: [docs] [issue34484] Unicode HOWTO incorrectly refers to Private Use
 Area for surrogateescape
In-Reply-To: <1535058879.5.0.56676864532.issue34484@psf.upfronthosting.co.za>
Message-ID: <1551704510.53.0.667867448451.issue34484@roundup.psfhosted.org>


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


New changeset 84fa6b9e5932af981cb299c0c5ac80b9cc37c3fa by Miss Islington (bot) in branch '3.7':
bpo-20906: Various revisions to the Unicode howto  (GH-8394)
https://github.com/python/cpython/commit/84fa6b9e5932af981cb299c0c5ac80b9cc37c3fa


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

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

From report at bugs.python.org  Mon Mar  4 08:02:34 2019
From: report at bugs.python.org (Inada Naoki)
Date: Mon, 04 Mar 2019 13:02:34 +0000
Subject: [docs] [issue36182] Path.write_text() docs do not include the case
 that a file exists
In-Reply-To: <1551703881.69.0.0731434428442.issue36182@roundup.psfhosted.org>
Message-ID: <1551704554.53.0.454578790995.issue36182@roundup.psfhosted.org>


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

It may be removed accidentally by this commit.

https://github.com/python/cpython/commit/8477ed60486a22f79f257ee49f0bc18d0e73f216#diff-56cd2f82cd518e7baf1edab64771f619

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

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

From report at bugs.python.org  Mon Mar  4 08:07:57 2019
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Mon, 04 Mar 2019 13:07:57 +0000
Subject: [docs] [issue36182] Path.write_text() docs do not include the case
 that a file exists
In-Reply-To: <1551703881.69.0.0731434428442.issue36182@roundup.psfhosted.org>
Message-ID: <1551704877.77.0.847891760737.issue36182@roundup.psfhosted.org>


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

I was searching along similar lines since this was present as part of the original commit : https://hg.python.org/cpython/rev/a4da150fbfd4 . I guess it makes sense to restore the text.

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

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

From report at bugs.python.org  Mon Mar  4 08:12:49 2019
From: report at bugs.python.org (Lysandros Nikolaou)
Date: Mon, 04 Mar 2019 13:12:49 +0000
Subject: [docs] [issue36182] Path.write_text() docs do not include the case
 that a file exists
In-Reply-To: <1551703881.69.0.0731434428442.issue36182@roundup.psfhosted.org>
Message-ID: <1551705169.5.0.150841587019.issue36182@roundup.psfhosted.org>


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

I'll submit a PR shortly.

----------

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

From report at bugs.python.org  Mon Mar  4 08:22:15 2019
From: report at bugs.python.org (Lysandros Nikolaou)
Date: Mon, 04 Mar 2019 13:22:15 +0000
Subject: [docs] [issue36182] Path.write_text() docs do not include the case
 that a file exists
In-Reply-To: <1551703881.69.0.0731434428442.issue36182@roundup.psfhosted.org>
Message-ID: <1551705735.04.0.964531908173.issue36182@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Mon Mar  4 09:43:18 2019
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 04 Mar 2019 14:43:18 +0000
Subject: [docs] [issue36185] [EASY DOC] typo: Doc/c-api/objbuffer.rst: There
 is a typo in "corresponding"
Message-ID: <1551710598.51.0.139249207264.issue36185@roundup.psfhosted.org>


New submission from STINNER Victor <vstinner at redhat.com>:

Issue reported at:
https://github.com/python/cpython/pull/11119/files/650ed79e9dcd6f12b2cd0adcc9d6e3fd1ea929d0#diff-dec96ce8ae89cc364fa198f94357a1ab

> There is a typo in "corresponding"

Does someone want to write a PR?

----------
assignee: docs at python
components: Documentation
keywords: easy
messages: 337122
nosy: docs at python, vstinner
priority: normal
severity: normal
status: open
title: [EASY DOC] typo: Doc/c-api/objbuffer.rst:  There is a typo in "corresponding"
versions: Python 3.7, Python 3.8

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

From report at bugs.python.org  Mon Mar  4 09:51:31 2019
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 04 Mar 2019 14:51:31 +0000
Subject: [docs] [issue20906] Issues in Unicode HOWTO
In-Reply-To: <1394702187.81.0.00522221343959.issue20906@psf.upfronthosting.co.za>
Message-ID: <1551711091.03.0.188996664099.issue20906@roundup.psfhosted.org>


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

I see a change, so I guess that this old issue can now be fixed. Anything, the issue didn't get much activity last years.

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

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

From report at bugs.python.org  Mon Mar  4 10:15:13 2019
From: report at bugs.python.org (=?utf-8?q?R=C3=A9mi_Lapeyre?=)
Date: Mon, 04 Mar 2019 15:15:13 +0000
Subject: [docs] [issue36185] [EASY DOC] typo: Doc/c-api/objbuffer.rst: There
 is a typo in "corresponding"
In-Reply-To: <1551710598.51.0.139249207264.issue36185@roundup.psfhosted.org>
Message-ID: <1551712513.78.0.663363024879.issue36185@roundup.psfhosted.org>


R?mi Lapeyre <remi.lapeyre at henki.fr> added the comment:

Shouldn't this be kept for the documentation sprint?

----------
nosy: +cheryl.sabella, remi.lapeyre

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

From report at bugs.python.org  Mon Mar  4 17:39:11 2019
From: report at bugs.python.org (Thomas Jollans)
Date: Mon, 04 Mar 2019 22:39:11 +0000
Subject: [docs] [issue36191] pubkeys.txt contains bogus keys
Message-ID: <1551739151.95.0.42643346766.issue36191@roundup.psfhosted.org>


New submission from Thomas Jollans <tjol at tjol.eu>:

The file https://www.python.org/static/files/pubkeys.txt contains some bogus GPG keys with 32-bit key IDs identical to actual release manager key IDs. (see below) I imagine these slipped in by accident and may have been created by someone trying to make a point. (see also: https://evil32.com/)

This is obviously not a serious security concern, but it would be a better look if the file contained only the real keys, and if https://www.python.org/downloads/ listed fingerprints.

Pointed out by Peter Otten on python-list. https://mail.python.org/pipermail/python-list/2019-March/739788.html

These are the obvious fake keys included: 

pub:-:1024:1:2056FF2E487034E5:1137310238:::-:
fpr:::::::::BA749AC731BE5A28A65446C02056FF2E487034E5:
uid:::::::::Totally Legit Signing Key <mallory at example.org>:
pub:-:1024:1:C2E8D739F73C700D:1245930666:::-:
fpr:::::::::7F54F95AC61EE1465CFE7A1FC2E8D739F73C700D:
uid:::::::::Totally Legit Signing Key <mallory at example.org>:
pub:-:1024:1:FABF4E7B6F5E1540:1512586955:::-:
fpr:::::::::FD01BA54AE5D9B9C468E65E3FABF4E7B6F5E1540:
uid:::::::::Totally Legit Signing Key <mallory at example.org>:
pub:-:1024:1:0E93AA73AA65421D:1202230939:::-:
fpr:::::::::41A239476ABD6CBA8FC8FCA90E93AA73AA65421D:
uid:::::::::Totally Legit Signing Key <mallory at example.org>:
pub:-:1024:1:79B457E4E6DF025C:1357547701:::-:
fpr:::::::::9EB49DC166F6400EF5DA53F579B457E4E6DF025C:
uid:::::::::Totally Legit Signing Key <mallory at example.org>:
pub:-:1024:1:FEA3DC6DEA5BBD71:1432286066:::-:
fpr:::::::::801BD5AE93D392E22DDC6C7AFEA3DC6DEA5BBD71:
uid:::::::::Totally Legit Signing Key <mallory at example.org>:
pub:-:1024:1:236A434AA74B06BF:1366844479:::-:
fpr:::::::::B43A1F9EDE867FE48AD1D718236A434AA74B06BF:
uid:::::::::Totally Legit Signing Key <mallory at example.org>:
pub:-:1024:1:F5F4351EA4135B38:1250910569:::-:
fpr:::::::::4F3B83264BC0C99EDADBF91FF5F4351EA4135B38:
uid:::::::::Totally Legit Signing Key <mallory at example.org>:
pub:-:1024:1:D84E17F918ADD4FF:1484232656:::-:
fpr:::::::::3A3E83C9DB23EF8B5E5DADBED84E17F918ADD4FF:
uid:::::::::Totally Legit Signing Key <mallory at example.org>:
pub:-:1024:1:876CCCE17D9DC8D2:1164804081:::-:
fpr:::::::::C1FCAEABC21C54C03120EF6A876CCCE17D9DC8D2:
uid:::::::::Totally Legit Signing Key <mallory at example.org>:
pub:-:1024:1:0F7232D036580288:1140898452:::-:
fpr:::::::::12FF24C7BCEE1AE82EC38B3A0F7232D036580288:
uid:::::::::Totally Legit Signing Key <mallory at example.org>:
pub:-:1024:1:27801D7E6A45C816:1287310846:::-:
fpr:::::::::8CA98EEE6FE14D11DF37694927801D7E6A45C816:
uid:::::::::Totally Legit Signing Key <mallory at example.org>:

----------
assignee: docs at python
components: Documentation
messages: 337156
nosy: docs at python, tjollans
priority: normal
severity: normal
status: open
title: pubkeys.txt contains bogus keys
type: enhancement
versions: Python 3.7

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

From report at bugs.python.org  Tue Mar  5 07:03:05 2019
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Tue, 05 Mar 2019 12:03:05 +0000
Subject: [docs] [issue36191] pubkeys.txt contains bogus keys
In-Reply-To: <1551739151.95.0.42643346766.issue36191@roundup.psfhosted.org>
Message-ID: <1551787385.35.0.748250323323.issue36191@roundup.psfhosted.org>


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

Thanks for the report but the tracker deals with bugs in CPython. python.org website has a Github repo and I think this can be reported at https://github.com/python/pythondotorg where it could get a better resolution. I would propose closing it as third party.

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

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

From report at bugs.python.org  Tue Mar  5 09:31:26 2019
From: report at bugs.python.org (Joris VAN HOUTVEN)
Date: Tue, 05 Mar 2019 14:31:26 +0000
Subject: [docs] [issue36196] sys.executable does not return python3
 executable when using uwsgi
Message-ID: <1551796286.02.0.860933813615.issue36196@roundup.psfhosted.org>


New submission from Joris VAN HOUTVEN <joris.vanhoutven at uhasselt.be>:

when serving a Flask app with uwsgi, using
`sys.executable`
will provide you the path to your uwsgi executable, not your python executable.
However, the docs specify that it should always return the python interpreter: https://docs.python.org/3/library/sys.html#sys.executable

----------
assignee: docs at python
components: Documentation
messages: 337190
nosy: Joris VAN HOUTVEN, docs at python
priority: normal
severity: normal
status: open
title: sys.executable does not return python3 executable when using uwsgi
type: behavior

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

From report at bugs.python.org  Tue Mar  5 09:32:56 2019
From: report at bugs.python.org (Harmandeep Singh)
Date: Tue, 05 Mar 2019 14:32:56 +0000
Subject: [docs] [issue36195] initializer is not a valid param in
 ThreadPoolExecutor
In-Reply-To: <1551796082.49.0.510573730128.issue36195@roundup.psfhosted.org>
Message-ID: <1551796376.51.0.0619956702301.issue36195@roundup.psfhosted.org>


Change by Harmandeep Singh <harmandeep3091 at gmail.com>:


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

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

From report at bugs.python.org  Tue Mar  5 09:34:50 2019
From: report at bugs.python.org (Han)
Date: Tue, 05 Mar 2019 14:34:50 +0000
Subject: [docs] [issue36198] Misleading in library/sets document
Message-ID: <1551796490.3.0.534050934709.issue36198@roundup.psfhosted.org>


New submission from Han <phoenix.seek at gmail.com>:

Doc/library/sets.rst said operation s.update(t)'s result is "return set s with elements added from t".
But update()'s return value is None.
I think change it to "set s with elements added from t" would be better.
So are operations intersection_update(), difference_update(), and symmetric_difference_update().

----------
assignee: docs at python
components: Documentation
messages: 337192
nosy: DeadmanWalking, docs at python
priority: normal
severity: normal
status: open
title: Misleading in library/sets document
versions: Python 2.7

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

From report at bugs.python.org  Tue Mar  5 09:44:42 2019
From: report at bugs.python.org (Peter Otten)
Date: Tue, 05 Mar 2019 14:44:42 +0000
Subject: [docs] [issue36191] pubkeys.txt contains bogus keys
In-Reply-To: <1551739151.95.0.42643346766.issue36191@roundup.psfhosted.org>
Message-ID: <1551797082.57.0.214741005278.issue36191@roundup.psfhosted.org>


Change by Peter Otten <__peter__ at web.de>:


----------
nosy: +peter.otten

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

From report at bugs.python.org  Tue Mar  5 10:05:08 2019
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Tue, 05 Mar 2019 15:05:08 +0000
Subject: [docs] [issue36195] initializer is not a valid param in
 ThreadPoolExecutor
In-Reply-To: <1551796082.49.0.510573730128.issue36195@roundup.psfhosted.org>
Message-ID: <1551798308.56.0.692033769164.issue36195@roundup.psfhosted.org>


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

Thanks for the report. You are correct. The parameters were introduced in issue21423 in 3.7. It seems that this backported by mistake with PR 10958 where minor grammar was fixed with 40a61da40d252626f8b9ff524d76c1f0ccb3a4f7 but backporting caused the whole paragraph to be added to 3.6.

3.6 is in security fixes only mode. So I am not sure about the fix being merged. I am adding Ned to take a call on this.

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

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

From report at bugs.python.org  Tue Mar  5 10:19:43 2019
From: report at bugs.python.org (Ned Deily)
Date: Tue, 05 Mar 2019 15:19:43 +0000
Subject: [docs] [issue36195] initializer is not a valid param in
 ThreadPoolExecutor
In-Reply-To: <1551796082.49.0.510573730128.issue36195@roundup.psfhosted.org>
Message-ID: <1551799183.06.0.0494231219178.issue36195@roundup.psfhosted.org>


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

If someone is willing to make a doc fix PR for this, I will merge it for 3.6.

----------

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

From report at bugs.python.org  Tue Mar  5 10:23:42 2019
From: report at bugs.python.org (Harmandeep Singh)
Date: Tue, 05 Mar 2019 15:23:42 +0000
Subject: [docs] [issue36195] initializer is not a valid param in
 ThreadPoolExecutor
In-Reply-To: <1551796082.49.0.510573730128.issue36195@roundup.psfhosted.org>
Message-ID: <1551799422.32.0.732403776367.issue36195@roundup.psfhosted.org>


Harmandeep Singh <harmandeep3091 at gmail.com> added the comment:

I will raise a PR

----------

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

From report at bugs.python.org  Tue Mar  5 10:25:53 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Tue, 05 Mar 2019 15:25:53 +0000
Subject: [docs] [issue36195] initializer is not a valid param in
 ThreadPoolExecutor
In-Reply-To: <1551796082.49.0.510573730128.issue36195@roundup.psfhosted.org>
Message-ID: <1551799553.82.0.693193687965.issue36195@roundup.psfhosted.org>


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

ok, I was working on a PR for this issue. but I am going to classify it as easy.

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

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

From report at bugs.python.org  Tue Mar  5 10:26:01 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Tue, 05 Mar 2019 15:26:01 +0000
Subject: [docs] [issue36195] initializer is not a valid param in
 ThreadPoolExecutor
In-Reply-To: <1551796082.49.0.510573730128.issue36195@roundup.psfhosted.org>
Message-ID: <1551799561.36.0.784165987494.issue36195@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Tue Mar  5 10:27:27 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Tue, 05 Mar 2019 15:27:27 +0000
Subject: [docs] [issue36195] initializer is not a valid param in
 ThreadPoolExecutor
In-Reply-To: <1551796082.49.0.510573730128.issue36195@roundup.psfhosted.org>
Message-ID: <1551799647.89.0.484979321794.issue36195@roundup.psfhosted.org>


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

harman786 good luck for your PR, if you need a review.

Have a nice day,

----------

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

From report at bugs.python.org  Tue Mar  5 10:27:56 2019
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Tue, 05 Mar 2019 15:27:56 +0000
Subject: [docs] [issue36198] Misleading in library/sets document
In-Reply-To: <1551796490.3.0.534050934709.issue36198@roundup.psfhosted.org>
Message-ID: <1551799676.81.0.779849231677.issue36198@roundup.psfhosted.org>


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

To add to this is actually present in sets module documentation which has been deprecated since 2.6 though the report is true that the methods don't return a set.

Link : https://docs.python.org/2/library/sets.html#set-objects

----------
nosy: +rhettinger, xtreak

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

From report at bugs.python.org  Tue Mar  5 10:33:58 2019
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Tue, 05 Mar 2019 15:33:58 +0000
Subject: [docs] [issue36196] sys.executable does not return python3
 executable when using uwsgi
In-Reply-To: <1551796286.02.0.860933813615.issue36196@roundup.psfhosted.org>
Message-ID: <1551800038.36.0.949538462601.issue36196@roundup.psfhosted.org>


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

related uwsgi issue : https://github.com/unbit/uwsgi/issues/670

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

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

From dimkouv at protonmail.com  Tue Mar  5 09:33:00 2019
From: dimkouv at protonmail.com (Dimitrios N. Kouveris)
Date: Tue, 05 Mar 2019 14:33:00 +0000
Subject: [docs] Error 404 | Prebuilt Docs
Message-ID: <KSx_3iuCBYxOj5ToBBeYgVi6DGlNkufjcfozQxTzxBIt99RrYEVZmbZFeFO5SFuXgBes9335AJnqqYxZrWhsbL4gnMdZZ64MgfQC7nFlIZo=@protonmail.com>

Hello,

The download links at https://docs.python.org/dev/download.html are responding with error 404.
Why this happens?

Thank you,

Kouveris N. Dimitrios MEng Candidate, UOI
https://[dimkouv.com](http://www.dimkouv.com/)

Sent with [ProtonMail](https://protonmail.com) Secure Email.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190305/40ece982/attachment.html>

From julien at palard.fr  Tue Mar  5 10:48:34 2019
From: julien at palard.fr (Julien Palard)
Date: Tue, 05 Mar 2019 15:48:34 +0000
Subject: [docs] Error 404 | Prebuilt Docs
In-Reply-To: <KSx_3iuCBYxOj5ToBBeYgVi6DGlNkufjcfozQxTzxBIt99RrYEVZmbZFeFO5SFuXgBes9335AJnqqYxZrWhsbL4gnMdZZ64MgfQC7nFlIZo=@protonmail.com>
References: <KSx_3iuCBYxOj5ToBBeYgVi6DGlNkufjcfozQxTzxBIt99RrYEVZmbZFeFO5SFuXgBes9335AJnqqYxZrWhsbL4gnMdZZ64MgfQC7nFlIZo=@protonmail.com>
Message-ID: <01k2xaCI-wHV7Wros_ufhg8tFie5GtWekK8Enp7munUdyVPPA8DwxFxOAbcOpVIePyrDWVedmi8STElSjb-m41vUCJjxOUZ_mnh47lwkaRs=@palard.fr>

Hi,

> The download links at https://docs.python.org/dev/download.html are responding with error 404.

Thanks for reporting! This should be fixed around the next month (we're just waiting a new release of Sphinx fixing issue), but only /dev/ is broken, other versions should be available.

For more informations see:

- https://bugs.python.org/issue35033
- https://github.com/sphinx-doc/sphinx/pull/5559

> Why this happens?

Because since Python 3.8 we started using column and row spanning in tables in our documentation, which will only be supported in the next Sphinx version, hopefully next month. This is breaking the build process, after the HTML build but before the PDF build.

Bests,
--?
Julien Palard
https://mdk.fr


From report at bugs.python.org  Tue Mar  5 10:58:02 2019
From: report at bugs.python.org (Inada Naoki)
Date: Tue, 05 Mar 2019 15:58:02 +0000
Subject: [docs] [issue36196] sys.executable does not return python3
 executable when using uwsgi
In-Reply-To: <1551796286.02.0.860933813615.issue36196@roundup.psfhosted.org>
Message-ID: <1551801482.73.0.837270365404.issue36196@roundup.psfhosted.org>


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

I don't think this is a documentation bug.  They insert "uwsgi" to "sys.executable" manually.

https://github.com/unbit/uwsgi/blob/3149df02ed443131c54ea6afb29fcbb0ed4d1139/plugins/python/pyutils.c#L398-402

#ifdef PYTHREE
	PyDict_SetItemString(sys_dict, "executable", PyUnicode_FromString(uwsgi.binary_path));
#else
	PyDict_SetItemString(sys_dict, "executable", PyString_FromString(uwsgi.binary_path));
#endif

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

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

From report at bugs.python.org  Tue Mar  5 11:32:35 2019
From: report at bugs.python.org (Mark Dickinson)
Date: Tue, 05 Mar 2019 16:32:35 +0000
Subject: [docs] [issue34484] Unicode HOWTO incorrectly refers to Private Use
 Area for surrogateescape
In-Reply-To: <1535058879.5.0.56676864532.issue34484@psf.upfronthosting.co.za>
Message-ID: <1551803555.3.0.909601586111.issue34484@roundup.psfhosted.org>


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

Thanks for the fix. @akuchling: safe to close this issue?

----------

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

From report at bugs.python.org  Tue Mar  5 12:09:56 2019
From: report at bugs.python.org (Harmandeep Singh)
Date: Tue, 05 Mar 2019 17:09:56 +0000
Subject: [docs] [issue36195] initializer is not a valid param in
 ThreadPoolExecutor
In-Reply-To: <1551796082.49.0.510573730128.issue36195@roundup.psfhosted.org>
Message-ID: <1551805796.22.0.568187568266.issue36195@roundup.psfhosted.org>


Change by Harmandeep Singh <harmandeep3091 at gmail.com>:


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

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

From report at bugs.python.org  Tue Mar  5 14:34:58 2019
From: report at bugs.python.org (Giampaolo Rodola')
Date: Tue, 05 Mar 2019 19:34:58 +0000
Subject: [docs] [issue27409] List socket.SO_*, SCM_*, MSG_*,
 IPPROTO_* symbols
In-Reply-To: <1467168896.94.0.840314714269.issue27409@psf.upfronthosting.co.za>
Message-ID: <1551814498.56.0.548275662.issue27409@roundup.psfhosted.org>


Change by Giampaolo Rodola' <g.rodola at gmail.com>:


----------
nosy: +giampaolo.rodola

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

From report at bugs.python.org  Tue Mar  5 22:57:00 2019
From: report at bugs.python.org (Josh Rosenberg)
Date: Wed, 06 Mar 2019 03:57:00 +0000
Subject: [docs] [issue36198] Misleading in library/sets document
In-Reply-To: <1551796490.3.0.534050934709.issue36198@roundup.psfhosted.org>
Message-ID: <1551844620.31.0.882758636016.issue36198@roundup.psfhosted.org>


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

The "returns" bit is accurate when referring to the in-place operator overloads (__ior__), so those lines may have been written referring to the overloads described on the same line (they shouldn't have been written that way, but that would explain why only the methods with in-place overload equivalents use the word "returns").

Either way, sets was deprecated in 2.6, largely pointless in every version but 2.3 (module added in 2.3, built-in set/frozenset types added 2.4), and gone in 3.0+ (and 2.7 is EOL within the year). Do we even do doc updates for stuff this dead?

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

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

From report at bugs.python.org  Wed Mar  6 00:24:43 2019
From: report at bugs.python.org (Han)
Date: Wed, 06 Mar 2019 05:24:43 +0000
Subject: [docs] [issue36198] Misleading in library/sets document
In-Reply-To: <1551796490.3.0.534050934709.issue36198@roundup.psfhosted.org>
Message-ID: <1551849883.87.0.955389759718.issue36198@roundup.psfhosted.org>


Han <phoenix.seek at gmail.com> added the comment:

Thanks, I didn't notice the Deprecated sign on the Sets page.

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

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

From report at bugs.python.org  Wed Mar  6 02:38:12 2019
From: report at bugs.python.org (SilentGhost)
Date: Wed, 06 Mar 2019 07:38:12 +0000
Subject: [docs] [issue36203] PyWeakref_NewRef docs are misleading
In-Reply-To: <1551834230.67.0.926562735048.issue36203@roundup.psfhosted.org>
Message-ID: <1551857892.93.0.897624381407.issue36203@roundup.psfhosted.org>


Change by SilentGhost <ghost.adh at runbox.com>:


----------
assignee:  -> docs at python
components: +Documentation, ctypes
nosy: +docs at python
type:  -> behavior

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

From budmaddock at gmail.com  Tue Mar  5 11:32:05 2019
From: budmaddock at gmail.com (Bud Maddock)
Date: Tue, 5 Mar 2019 17:32:05 +0100
Subject: [docs] Section 5 of Python 2.7.16 documentation errors
Message-ID: <2799d069-4136-788a-6f0e-7b47a838086b@gmail.com>

Most notable, section 5. Expressions

def f(a,b):

 ??? print a,b? # raises an error and should read print(a,b)


Section 5.4? Raising a negative number to a fractional power does not 
return an error as stated in the documentation but appears to 
functioning correctly.


Section 5.9? <> returns a syntax error and is no longer usable to replace !=


Bud


From arthur.p.goldberg at mssm.edu  Tue Mar  5 17:36:39 2019
From: arthur.p.goldberg at mssm.edu (Goldberg, Arthur P)
Date: Tue, 5 Mar 2019 22:36:39 +0000
Subject: [docs] https://docs.python.org/3/library/multiprocessing.html
Message-ID: <66AC0F1E-851E-4C63-BE9D-8E5B55D1F183@mssm.edu>

Great package. I?ve some suggested documentation improvements:

s/necessary to run the process objects/necessary to run the process object's/
s/Given this blocks/Given this blocking/

in class multiprocessing.pool.AsyncResult, the behavior of get() when timeout is None needs to be documented.

Also, in my opinion, the signatures of get() and wait() should be written

get(timeout=None)
wait(timeout=None)

to make it clear that the default values of timeout is None.

Thanks for your good work.

Arthur





Arthur Goldberg, PhD
Associate Professor of Genetics and Data Science
Institute for Data Science and Genomic Technology
Mount Sinai School of Medicine
1255 Fifth Ave., Suite C-2
New York, NY 10029
646 526 5020
Karr Lab
Arthur.Goldberg at mssm.edu<mailto:Arthur.Goldberg at mssm.edu>

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

From report at bugs.python.org  Wed Mar  6 04:47:28 2019
From: report at bugs.python.org (Joris VAN HOUTVEN)
Date: Wed, 06 Mar 2019 09:47:28 +0000
Subject: [docs] [issue36196] sys.executable does not return python3
 executable when using uwsgi
In-Reply-To: <1551796286.02.0.860933813615.issue36196@roundup.psfhosted.org>
Message-ID: <1551865648.03.0.3264641341.issue36196@roundup.psfhosted.org>


Joris VAN HOUTVEN <joris.vanhoutven at uhasselt.be> added the comment:

OK, so it is indeed uwsgi interfering with the sys.executable value.
In the github pst Inada Naoki refers to:

  "uwsgi is your current python interpreter, as it links the libpython.so. Getting sys.executable is not possibile as there is no binary path hard-encoded in library by itself"

So I suppose this issue can be closed here. I will comment on the uwsgi github.

----------

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

From report at bugs.python.org  Wed Mar  6 05:02:42 2019
From: report at bugs.python.org (Inada Naoki)
Date: Wed, 06 Mar 2019 10:02:42 +0000
Subject: [docs] [issue36196] sys.executable does not return python3
 executable when using uwsgi
In-Reply-To: <1551796286.02.0.860933813615.issue36196@roundup.psfhosted.org>
Message-ID: <1551866562.66.0.198036594017.issue36196@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Wed Mar  6 05:02:51 2019
From: report at bugs.python.org (Inada Naoki)
Date: Wed, 06 Mar 2019 10:02:51 +0000
Subject: [docs] [issue36196] sys.executable does not return python3
 executable when using uwsgi
In-Reply-To: <1551796286.02.0.860933813615.issue36196@roundup.psfhosted.org>
Message-ID: <1551866571.44.0.33988085048.issue36196@roundup.psfhosted.org>


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


----------
resolution: fixed -> not a bug

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

From report at bugs.python.org  Wed Mar  6 05:09:08 2019
From: report at bugs.python.org (Joannah Nanjekye)
Date: Wed, 06 Mar 2019 10:09:08 +0000
Subject: [docs] [issue36191] pubkeys.txt contains bogus keys
In-Reply-To: <1551739151.95.0.42643346766.issue36191@roundup.psfhosted.org>
Message-ID: <1551866948.84.0.430026824238.issue36191@roundup.psfhosted.org>


Joannah Nanjekye <nanjekyejoannah at gmail.com> added the comment:

Agreed @xtreak, I have moved this issue to the respective Github repository https://github.com/python/pythondotorg/issues/1395 .

I will close this issue.

----------
nosy: +nanjekyejoannah

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

From report at bugs.python.org  Wed Mar  6 05:14:17 2019
From: report at bugs.python.org (Joannah Nanjekye)
Date: Wed, 06 Mar 2019 10:14:17 +0000
Subject: [docs] [issue36191] pubkeys.txt contains bogus keys
In-Reply-To: <1551739151.95.0.42643346766.issue36191@roundup.psfhosted.org>
Message-ID: <1551867257.67.0.606704678743.issue36191@roundup.psfhosted.org>


Change by Joannah Nanjekye <nanjekyejoannah at gmail.com>:


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

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

From report at bugs.python.org  Wed Mar  6 06:06:29 2019
From: report at bugs.python.org (STINNER Victor)
Date: Wed, 06 Mar 2019 11:06:29 +0000
Subject: [docs] [issue36209] [EASY Doc] Typo in hashlib error message
Message-ID: <1551870389.36.0.98944095722.issue36209@roundup.psfhosted.org>


New submission from STINNER Victor <vstinner at redhat.com>:

Seen on a custom builder:

BUILDSTDERR: ======================================================================
BUILDSTDERR: ERROR: test_scrypt (test.test_hashlib.KDFTests)
BUILDSTDERR: ----------------------------------------------------------------------
BUILDSTDERR: Traceback (most recent call last):
BUILDSTDERR:   File "/builddir/build/BUILD/Python-3.7.2/Lib/test/test_hashlib.py", line 942, in test_scrypt
BUILDSTDERR:     result = hashlib.scrypt(password, salt=salt, n=n, r=r, p=p)
BUILDSTDERR: ValueError: Invalid paramemter combination for n, r, p, maxmem.

There is a typo in "paramemter".

----------
assignee: docs at python
components: Documentation
keywords: easy
messages: 337290
nosy: docs at python, vstinner
priority: normal
severity: normal
status: open
title: [EASY Doc] Typo in hashlib error message
versions: Python 3.8

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

From report at bugs.python.org  Wed Mar  6 06:32:12 2019
From: report at bugs.python.org (Windson Yang)
Date: Wed, 06 Mar 2019 11:32:12 +0000
Subject: [docs] [issue36203] PyWeakref_NewRef docs are misleading
In-Reply-To: <1551834230.67.0.926562735048.issue36203@roundup.psfhosted.org>
Message-ID: <1551871932.98.0.33354477409.issue36203@roundup.psfhosted.org>


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

Yes, Maxwell. I guess the docs are misleading, the code locate in https://github.com/python/cpython/blob/master/Objects/weakrefobject.c#L748

if (callback == Py_None)
        callback = NULL;
    if (callback == NULL)
        /* return existing weak reference if it exists */
        result = ref;
    if (result != NULL)
        Py_INCREF(result);
    else {
        ...
    }

However, I'm not sure we should fix the docs or the code here.

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

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

From report at bugs.python.org  Wed Mar  6 07:12:51 2019
From: report at bugs.python.org (Emmanuel Arias)
Date: Wed, 06 Mar 2019 12:12:51 +0000
Subject: [docs] [issue36209] [EASY Doc] Typo in hashlib error message
In-Reply-To: <1551870389.36.0.98944095722.issue36209@roundup.psfhosted.org>
Message-ID: <1551874371.04.0.983156861342.issue36209@roundup.psfhosted.org>


Change by Emmanuel Arias <emmanuelarias30 at gmail.com>:


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

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

From report at bugs.python.org  Wed Mar  6 07:16:02 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Wed, 06 Mar 2019 12:16:02 +0000
Subject: [docs] [issue36209] [EASY Doc] Typo in hashlib error message
In-Reply-To: <1551870389.36.0.98944095722.issue36209@roundup.psfhosted.org>
Message-ID: <1551874562.38.0.231351986953.issue36209@roundup.psfhosted.org>


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

Thank you @eamanu.

----------
keywords:  -patch
nosy: +matrixise
stage: patch review -> 

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

From report at bugs.python.org  Wed Mar  6 07:16:37 2019
From: report at bugs.python.org (Emmanuel Arias)
Date: Wed, 06 Mar 2019 12:16:37 +0000
Subject: [docs] [issue36209] [EASY Doc] Typo in hashlib error message
In-Reply-To: <1551870389.36.0.98944095722.issue36209@roundup.psfhosted.org>
Message-ID: <1551874597.86.0.157232507467.issue36209@roundup.psfhosted.org>


Change by Emmanuel Arias <emmanuelarias30 at gmail.com>:


----------
nosy: +eamanu

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

From report at bugs.python.org  Wed Mar  6 09:35:42 2019
From: report at bugs.python.org (STINNER Victor)
Date: Wed, 06 Mar 2019 14:35:42 +0000
Subject: [docs] [issue36209] [EASY Doc] Typo in hashlib error message
In-Reply-To: <1551870389.36.0.98944095722.issue36209@roundup.psfhosted.org>
Message-ID: <1551882942.43.0.981339442113.issue36209@roundup.psfhosted.org>


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


New changeset b71e28ea91259ca3914e2ff84fc126795ea6b848 by Victor Stinner (Emmanuel Arias) in branch 'master':
bpo-36209: Fix typo on hashlib error message (GH-12194)
https://github.com/python/cpython/commit/b71e28ea91259ca3914e2ff84fc126795ea6b848


----------

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

From report at bugs.python.org  Wed Mar  6 09:35:51 2019
From: report at bugs.python.org (miss-islington)
Date: Wed, 06 Mar 2019 14:35:51 +0000
Subject: [docs] [issue36209] [EASY Doc] Typo in hashlib error message
In-Reply-To: <1551870389.36.0.98944095722.issue36209@roundup.psfhosted.org>
Message-ID: <1551882951.75.0.810242626225.issue36209@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Wed Mar  6 09:54:58 2019
From: report at bugs.python.org (miss-islington)
Date: Wed, 06 Mar 2019 14:54:58 +0000
Subject: [docs] [issue36209] [EASY Doc] Typo in hashlib error message
In-Reply-To: <1551870389.36.0.98944095722.issue36209@roundup.psfhosted.org>
Message-ID: <1551884098.58.0.20651368365.issue36209@roundup.psfhosted.org>


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


New changeset 42c649347a11789666c461ecbd3bdca27b957c9b by Miss Islington (bot) in branch '3.7':
bpo-36209: Fix typo on hashlib error message (GH-12194)
https://github.com/python/cpython/commit/42c649347a11789666c461ecbd3bdca27b957c9b


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

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

From report at bugs.python.org  Wed Mar  6 09:57:53 2019
From: report at bugs.python.org (STINNER Victor)
Date: Wed, 06 Mar 2019 14:57:53 +0000
Subject: [docs] [issue36209] [EASY Doc] Typo in hashlib error message
In-Reply-To: <1551870389.36.0.98944095722.issue36209@roundup.psfhosted.org>
Message-ID: <1551884273.93.0.212184875849.issue36209@roundup.psfhosted.org>


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

Thanks Emmanuel Arias.

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

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

From report at bugs.python.org  Wed Mar  6 11:33:20 2019
From: report at bugs.python.org (Maxwell Bernstein)
Date: Wed, 06 Mar 2019 16:33:20 +0000
Subject: [docs] [issue36203] PyWeakref_NewRef docs are misleading
In-Reply-To: <1551871932.98.0.33354477409.issue36203@roundup.psfhosted.org>
Message-ID: <CANZ2YWVq4xQ+=UUjD4NEJXN0RNnFdoa1wtZe6E-uVyt4E4SjJw@mail.gmail.com>


Maxwell Bernstein <tekk.nolagi at gmail.com> added the comment:

NewProxy checks if it's callable, so I suppose the code should be fixed.

On Wed, Mar 6, 2019, 03:32 Windson Yang <report at bugs.python.org> wrote:

>
> Windson Yang <wiwindson at outlook.com> added the comment:
>
> Yes, Maxwell. I guess the docs are misleading, the code locate in
> https://github.com/python/cpython/blob/master/Objects/weakrefobject.c#L748
>
> if (callback == Py_None)
>         callback = NULL;
>     if (callback == NULL)
>         /* return existing weak reference if it exists */
>         result = ref;
>     if (result != NULL)
>         Py_INCREF(result);
>     else {
>         ...
>     }
>
> However, I'm not sure we should fix the docs or the code here.
>
> ----------
> nosy: +Windson Yang
>
> _______________________________________
> Python tracker <report at bugs.python.org>
> <https://bugs.python.org/issue36203>
> _______________________________________
>

----------

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

From report at bugs.python.org  Wed Mar  6 21:08:29 2019
From: report at bugs.python.org (Emmanuel Arias)
Date: Thu, 07 Mar 2019 02:08:29 +0000
Subject: [docs] [issue36185] [EASY DOC] typo: Doc/c-api/objbuffer.rst: There
 is a typo in "corresponding"
In-Reply-To: <1551710598.51.0.139249207264.issue36185@roundup.psfhosted.org>
Message-ID: <1551924509.15.0.614079190492.issue36185@roundup.psfhosted.org>


Change by Emmanuel Arias <emmanuelarias30 at gmail.com>:


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

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

From report at bugs.python.org  Thu Mar  7 00:16:49 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 07 Mar 2019 05:16:49 +0000
Subject: [docs] [issue36185] [EASY DOC] typo: Doc/c-api/objbuffer.rst: There
 is a typo in "corresponding"
In-Reply-To: <1551710598.51.0.139249207264.issue36185@roundup.psfhosted.org>
Message-ID: <1551935809.78.0.0136030167047.issue36185@roundup.psfhosted.org>


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


New changeset ecc161d1209bf6d21f0fd6bef28476eda7cdaf79 by Serhiy Storchaka (Emmanuel Arias) in branch 'master':
bpo-36185: Fix typo in Doc/c-api/objbuffer.rst. (GH-12204)
https://github.com/python/cpython/commit/ecc161d1209bf6d21f0fd6bef28476eda7cdaf79


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

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

From report at bugs.python.org  Thu Mar  7 00:17:52 2019
From: report at bugs.python.org (miss-islington)
Date: Thu, 07 Mar 2019 05:17:52 +0000
Subject: [docs] [issue36185] [EASY DOC] typo: Doc/c-api/objbuffer.rst: There
 is a typo in "corresponding"
In-Reply-To: <1551710598.51.0.139249207264.issue36185@roundup.psfhosted.org>
Message-ID: <1551935872.26.0.613267081042.issue36185@roundup.psfhosted.org>


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


----------
pull_requests: +12200

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

From report at bugs.python.org  Thu Mar  7 00:24:57 2019
From: report at bugs.python.org (miss-islington)
Date: Thu, 07 Mar 2019 05:24:57 +0000
Subject: [docs] [issue36185] [EASY DOC] typo: Doc/c-api/objbuffer.rst: There
 is a typo in "corresponding"
In-Reply-To: <1551710598.51.0.139249207264.issue36185@roundup.psfhosted.org>
Message-ID: <1551936297.15.0.601438665437.issue36185@roundup.psfhosted.org>


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


New changeset ca5ba3c8ac1dad511461d4251ffffc6a1ca19de2 by Miss Islington (bot) in branch '3.7':
bpo-36185: Fix typo in Doc/c-api/objbuffer.rst. (GH-12204)
https://github.com/python/cpython/commit/ca5ba3c8ac1dad511461d4251ffffc6a1ca19de2


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

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

From report at bugs.python.org  Thu Mar  7 02:17:21 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 07 Mar 2019 07:17:21 +0000
Subject: [docs] [issue36185] [EASY DOC] typo: Doc/c-api/objbuffer.rst: There
 is a typo in "corresponding"
In-Reply-To: <1551710598.51.0.139249207264.issue36185@roundup.psfhosted.org>
Message-ID: <1551943041.03.0.872820338651.issue36185@roundup.psfhosted.org>


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/issue36185>
_______________________________________

From report at bugs.python.org  Thu Mar  7 03:20:45 2019
From: report at bugs.python.org (Windson Yang)
Date: Thu, 07 Mar 2019 08:20:45 +0000
Subject: [docs] [issue36203] PyWeakref_NewRef docs are misleading
In-Reply-To: <1551834230.67.0.926562735048.issue36203@roundup.psfhosted.org>
Message-ID: <1551946845.24.0.767600129727.issue36203@roundup.psfhosted.org>


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

It looks to me the fix is easy, we just will return NULL and raise TypeError when the callback is not callable, None, or NULL. I'm not an expert in C, but I would love to create a PR for it if you don't have time.

----------

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

From report at bugs.python.org  Thu Mar  7 03:23:58 2019
From: report at bugs.python.org (Maxwell Bernstein)
Date: Thu, 07 Mar 2019 08:23:58 +0000
Subject: [docs] [issue36203] PyWeakref_NewRef docs are misleading
In-Reply-To: <1551946845.24.0.767600129727.issue36203@roundup.psfhosted.org>
Message-ID: <CANZ2YWW-mUc4i9R_abuL75=+y86_gcg+Gnzzmg_zTtYSAic8Sg@mail.gmail.com>


Maxwell Bernstein <tekk.nolagi at gmail.com> added the comment:

I can likely do it tomorrow. If not I'll update this.

On Thu, Mar 7, 2019, 00:20 Windson Yang <report at bugs.python.org> wrote:

>
> Windson Yang <wiwindson at outlook.com> added the comment:
>
> It looks to me the fix is easy, we just will return NULL and raise
> TypeError when the callback is not callable, None, or NULL. I'm not an
> expert in C, but I would love to create a PR for it if you don't have time.
>
> ----------
>
> _______________________________________
> Python tracker <report at bugs.python.org>
> <https://bugs.python.org/issue36203>
> _______________________________________
>

----------

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

From report at bugs.python.org  Thu Mar  7 15:34:00 2019
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Thu, 07 Mar 2019 20:34:00 +0000
Subject: [docs] [issue30831] Inconsistent or wrong documentation around
 Asynchronous Context Manager
In-Reply-To: <1499069619.82.0.462830851571.issue30831@psf.upfronthosting.co.za>
Message-ID: <1551990840.98.0.283043261145.issue30831@roundup.psfhosted.org>


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


----------
nosy: +adelfino, yselivanov
versions: +Python 3.8

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

From report at bugs.python.org  Thu Mar  7 15:42:44 2019
From: report at bugs.python.org (Yury Selivanov)
Date: Thu, 07 Mar 2019 20:42:44 +0000
Subject: [docs] [issue30831] Inconsistent or wrong documentation around
 Asynchronous Context Manager
In-Reply-To: <1499069619.82.0.462830851571.issue30831@psf.upfronthosting.co.za>
Message-ID: <1551991364.45.0.383274671147.issue30831@roundup.psfhosted.org>


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

There's no inconsistency here and the docs are correct.

If you have a function:

  async def foo():
    pass

Then "foo()" call returns a "coroutine", which is an awaitable.  So

  async def __aenter__():
    ...

always returns an awaitable (regardless if there's a return statement or not).


> On the other hand, actual CPython implementation won't do that; it won't await the returned objects.

If always does await the returned object.

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

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

From report at bugs.python.org  Thu Mar  7 15:46:30 2019
From: report at bugs.python.org (Yury Selivanov)
Date: Thu, 07 Mar 2019 20:46:30 +0000
Subject: [docs] [issue30831] Inconsistent or wrong documentation around
 Asynchronous Context Manager
In-Reply-To: <1499069619.82.0.462830851571.issue30831@psf.upfronthosting.co.za>
Message-ID: <1551991590.82.0.183658109803.issue30831@roundup.psfhosted.org>


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

I also recommend reading this page https://docs.python.org/3/library/asyncio-task.html to get a better grasp on coroutines and how they are evaluated.

----------

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

From report at bugs.python.org  Thu Mar  7 18:06:43 2019
From: report at bugs.python.org (Terry J. Reedy)
Date: Thu, 07 Mar 2019 23:06:43 +0000
Subject: [docs] [issue35435] Discourage external links to old docs.
In-Reply-To: <1544164258.79.0.788709270274.issue35435@psf.upfronthosting.co.za>
Message-ID: <1552000003.37.0.478074534158.issue35435@roundup.psfhosted.org>


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

James Lu today posted to python-ideas
'Make Python 2.7?s online docs optionally redirect to  Python 3 online docs'

Andra Roberge: There exists browser extensions that do this:
https://addons.mozilla.org/en-US/firefox/addon/py3direct/
https://chrome.google.com/webstore/detail/py3redirect/codfjigcljdnlklcaopdciclmmdandig?hl=en

Steven D'Aprano pointed to this issue and gave some 3 first and 2 first examples.  I discovered that the only first page 3.x link for me for
https://www.startpage.com/do/search?q=python+docs+netrc
only points
to https://docs.python.org/3.1/library/netrc.html
with no clicky way to get to the current .../3/..., so we still need links added.

Julien, do we still need this issue open, or is this superceded by
https://github.com/python/python-docs-theme/issues/24 ?

----------

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

From report at bugs.python.org  Fri Mar  8 07:38:31 2019
From: report at bugs.python.org (jt)
Date: Fri, 08 Mar 2019 12:38:31 +0000
Subject: [docs] [issue36237] data_files / Install Additional Files written
 unclearly such that it's not obvious what parameter is what
Message-ID: <1552048711.94.0.561477211584.issue36237@roundup.psfhosted.org>


New submission from jt <jonas at thiem.email>:

I find the following doc section found at https://docs.python.org/3.7/distutils/setupscript.html#installing-additional-files about data_files somewhat unclear:

```
setup(...,
      data_files=[('bitmaps', ['bm/b1.gif', 'bm/b2.gif']),
                  ('config', ['cfg/data.cfg']),
                  ('/etc/init.d', ['init-script'])]
     )

Each (directory, files) pair in the sequence specifies the installation directory and the files to install there.

...

The directory should be a relative path. It is interpreted relative to the installation prefix (Python?s sys.prefix for system installations; site.USER_BASE for user installations).
```

This gives me no clue what the installation actually is relative to, since e.g. sys.prefix is just `/usr` - surely I'm not supposed to specify "lib64/python3.7/site-packages/<mypackage-name>/file" as a target?

That is probably not how that text is supposed to be read and I'm sure packaging expert understand what sort of prefix is actually meant, but could this be more elaborated on, maybe an actual example for a fake package of whether this is e.g. the package folder root after the install inside the site packages, or the site packages folder itself, or ...?

----------
assignee: docs at python
components: Documentation
messages: 337471
nosy: docs at python, jt
priority: normal
severity: normal
status: open
title: data_files / Install Additional Files written unclearly such that it's not obvious what parameter is what
versions: Python 3.7

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

From report at bugs.python.org  Fri Mar  8 08:55:43 2019
From: report at bugs.python.org (jt)
Date: Fri, 08 Mar 2019 13:55:43 +0000
Subject: [docs] [issue36237] data_files / Install Additional Files written
 unclearly such that it's not obvious what parameter is what
In-Reply-To: <1552048711.94.0.561477211584.issue36237@roundup.psfhosted.org>
Message-ID: <1552053343.29.0.751870263194.issue36237@roundup.psfhosted.org>


jt <jonas at thiem.email> added the comment:

Ok I am now realizing after more tests I actually read the docs correctly, and in that sense they're not ambiguous.

It's just that I tried to use data_files for something that it's not for: I did look at package_data first and I get that's what I SHOULD be using, however I want to add in a file that isn't in the package root in the original source folder. (package is in "./src", file I want to add in is in "./") package_data seems unable to do this, so I thought data_files would get me there, but apparently not in any reasonable way.

Closing this since I was apparently just surprised it didn't do what I want, and didn't actually misread anything as I thought I had

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

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

From report at bugs.python.org  Fri Mar  8 09:28:59 2019
From: report at bugs.python.org (Robert Billing)
Date: Fri, 08 Mar 2019 14:28:59 +0000
Subject: [docs] [issue36240] Definitions of time
Message-ID: <1552055339.11.0.882485944217.issue36240@roundup.psfhosted.org>


New submission from Robert Billing <robertthebilling at googlemail.com>:

https://docs.python.org/3.7/library/time.html contains the text "UTC is Coordinated Universal Time (formerly known as Greenwich Mean Time, or GMT)". This is not strictly true. Referring to https://en.wikipedia.org/wiki/Coordinated_Universal_Time the definition of UTC is in terms of frequency standards, GMT in terms of astronomy. Hence with GMT each minute has exactly 60 seconds, but the length of the second may vary slightly to account for changes in the Earth's rotation. With UTC each second is the same length, but "leap seconds" can be inserted or removed giving 59 and 61 second minutes. The leap seconds keep the two systems in sync to less than one second.

This of course only matters for the most critical applications, but it would be worth documenting correctly.

----------
assignee: docs at python
components: Documentation
messages: 337482
nosy: Robert Billing, docs at python
priority: normal
severity: normal
status: open
title: Definitions of time
type: enhancement
versions: Python 3.7

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

From report at bugs.python.org  Fri Mar  8 09:30:55 2019
From: report at bugs.python.org (Julien Palard)
Date: Fri, 08 Mar 2019 14:30:55 +0000
Subject: [docs] [issue35435] Discourage external links to old docs.
In-Reply-To: <1544164258.79.0.788709270274.issue35435@psf.upfronthosting.co.za>
Message-ID: <1552055455.48.0.364767662477.issue35435@roundup.psfhosted.org>


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

Let's not have duplicate issues, so I'm closing this in favor of https://github.com/python/python-docs-theme/issues/24.

Thanks Terry for noticing.

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

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

From report at bugs.python.org  Fri Mar  8 10:30:54 2019
From: report at bugs.python.org (Joannah Nanjekye)
Date: Fri, 08 Mar 2019 15:30:54 +0000
Subject: [docs] [issue36157] Document PyInterpreterState_Main().
In-Reply-To: <1551458200.72.0.727788487318.issue36157@roundup.psfhosted.org>
Message-ID: <1552059054.1.0.260720212424.issue36157@roundup.psfhosted.org>


Change by Joannah Nanjekye <nanjekyejoannah at gmail.com>:


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

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

From report at bugs.python.org  Fri Mar  8 10:43:45 2019
From: report at bugs.python.org (Joannah Nanjekye)
Date: Fri, 08 Mar 2019 15:43:45 +0000
Subject: [docs] [issue36157] Document PyInterpreterState_Main().
In-Reply-To: <1551458200.72.0.727788487318.issue36157@roundup.psfhosted.org>
Message-ID: <1552059825.91.0.388913306966.issue36157@roundup.psfhosted.org>


Joannah Nanjekye <nanjekyejoannah at gmail.com> added the comment:

Since there was no response, I decided to  open a PR for this.

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

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

From report at bugs.python.org  Fri Mar  8 13:58:19 2019
From: report at bugs.python.org (miss-islington)
Date: Fri, 08 Mar 2019 18:58:19 +0000
Subject: [docs] [issue35843] importlib.util docs for namespace packages
 innaccurate
In-Reply-To: <1548698590.94.0.426601552573.issue35843@roundup.psfhosted.org>
Message-ID: <1552071499.71.0.556563915986.issue35843@roundup.psfhosted.org>


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


New changeset ab9b31f94737895f0121f26ba3ad718ebbc24fe1 by Miss Islington (bot) (Anthony Sottile) in branch 'master':
bpo-35843: Implement __getitem__ for _NamespacePath (GH-11690)
https://github.com/python/cpython/commit/ab9b31f94737895f0121f26ba3ad718ebbc24fe1


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

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

From report at bugs.python.org  Fri Mar  8 13:58:36 2019
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 08 Mar 2019 18:58:36 +0000
Subject: [docs] [issue35843] importlib.util docs for namespace packages
 innaccurate
In-Reply-To: <1548698590.94.0.426601552573.issue35843@roundup.psfhosted.org>
Message-ID: <1552071516.7.0.689788132276.issue35843@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Fri Mar  8 18:53:52 2019
From: report at bugs.python.org (Jurjen N.E. Bos)
Date: Fri, 08 Mar 2019 23:53:52 +0000
Subject: [docs] [issue35880] math.sin has no backward error;
 this isn't documented
In-Reply-To: <1549021657.57.0.382503652198.issue35880@roundup.psfhosted.org>
Message-ID: <1552089232.55.0.48442192675.issue35880@roundup.psfhosted.org>


Jurjen N.E. Bos <jneb at users.sourceforge.net> added the comment:

I stand corrected; more on that later.

"backward error" is the mathematical term used for the accuracy of a
function. (Forward error is in the result proper; backward error means that you calculate the correct result for a number that is very close to the input.)
Since pi is not a machine representable number, it is pretty hard to
implement the trig functions with a zero backward error, since you need to divide by 2*pi in any reasonable implementation. For some reason, I was in the impression that the backward error of the sine was zero. 

I wrote a program to demonstrate the matter, only to find out that I was wrong :P
Maybe in the 32 bit version, but not in the 64 bits? Anyway, it is more implementation dependent than I though.

Althougth the backward error of the builtin sine function isn't zero, it is still a cool 21 digits, as the program shows.
- Jurjen

----------
resolution:  -> rejected
status: pending -> open
Added file: https://bugs.python.org/file48199/sindemo.py

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

From report at bugs.python.org  Fri Mar  8 19:04:19 2019
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 09 Mar 2019 00:04:19 +0000
Subject: [docs] [issue36203] PyWeakref_NewRef docs are misleading
In-Reply-To: <1551834230.67.0.926562735048.issue36203@roundup.psfhosted.org>
Message-ID: <1552089859.88.0.115051953391.issue36203@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Fri Mar  8 19:46:49 2019
From: report at bugs.python.org (Tim Peters)
Date: Sat, 09 Mar 2019 00:46:49 +0000
Subject: [docs] [issue35880] math.sin has no backward error;
 this isn't documented
In-Reply-To: <1549021657.57.0.382503652198.issue35880@roundup.psfhosted.org>
Message-ID: <1552092409.93.0.370032844258.issue35880@roundup.psfhosted.org>


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

Jurjen, the errors you see in Python's sin() are _entirely_ due to your platform C's libm.  Python just calls the platform C's sin.  So nothing can be said about it in general.

The better libm trig functions today do indeed perform trig argument reduction "as if" an infinite precision pi were used.  In practice, even for IEEE double precision no more than a few thousand bits are ever needed in the worst case, and the better libm trig functions use something much cheaper than that for arguments in a "reasonably small" range.  But, again, Python has nothing to do with that.

The better libm implementations guarantee worst-case error strictly less than 1 ULP away from the infinitely precise result.  But correctly rounded ("nearest-even") in all cases is still beyond what most of the better libms guarantee.

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

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

From report at bugs.python.org  Sat Mar  9 01:08:01 2019
From: report at bugs.python.org (Stefan Seefeld)
Date: Sat, 09 Mar 2019 06:08:01 +0000
Subject: [docs] [issue35830] building multiple (binary) packages from a
 single project
In-Reply-To: <1548464133.32.0.379789250574.issue35830@roundup.psfhosted.org>
Message-ID: <1552111681.13.0.18500346863.issue35830@roundup.psfhosted.org>


Change by Stefan Seefeld <stefan at seefeld.name>:


----------
resolution:  -> works for me
stage:  -> resolved
status: open -> closed

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

From report at bugs.python.org  Sat Mar  9 01:24:24 2019
From: report at bugs.python.org (Windson Yang)
Date: Sat, 09 Mar 2019 06:24:24 +0000
Subject: [docs] [issue36248] document about `or`, `and` operator.
Message-ID: <1552112664.77.0.64046371975.issue36248@roundup.psfhosted.org>


New submission from Windson Yang <wiwindson at outlook.com>:

I think we should document the behavior as below, (maybe at https://docs.python.org/3/reference/expressions.html#operator-precedence)

>>> 1 or 0 and 3
1
>>> 0 or 1 and 3
3

Please correct me if we already document it.

----------
assignee: docs at python
components: Documentation
messages: 337555
nosy: Windson Yang, docs at python
priority: normal
severity: normal
status: open
title: document about `or`, `and` operator.
type: enhancement
versions: Python 3.8

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

From report at bugs.python.org  Sat Mar  9 01:30:11 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 09 Mar 2019 06:30:11 +0000
Subject: [docs] [issue36248] document about `or`, `and` operator.
In-Reply-To: <1552112664.77.0.64046371975.issue36248@roundup.psfhosted.org>
Message-ID: <1552113011.16.0.595285777788.issue36248@roundup.psfhosted.org>


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

It is already documented. Just follow the link from "or" or "and".

https://docs.python.org/3/reference/expressions.html

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

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

From report at bugs.python.org  Sat Mar  9 01:50:16 2019
From: report at bugs.python.org (Steven D'Aprano)
Date: Sat, 09 Mar 2019 06:50:16 +0000
Subject: [docs] [issue36248] document about `or`, `and` operator.
In-Reply-To: <1552112664.77.0.64046371975.issue36248@roundup.psfhosted.org>
Message-ID: <1552114216.6.0.142096732596.issue36248@roundup.psfhosted.org>


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

Document *what* about the behaviour shown?

I'm sure you don't mean to say that we should document the fact the *literally* `1 or 0 and 3` returns 1, but I don't know what you think we should document beyond what is already stated in the existing docs.

It might be obvious to you, but it isn't obvious to me.

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

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

From report at bugs.python.org  Sat Mar  9 04:06:11 2019
From: report at bugs.python.org (Windson Yang)
Date: Sat, 09 Mar 2019 09:06:11 +0000
Subject: [docs] [issue36248] document about `or`, `and` operator.
In-Reply-To: <1552112664.77.0.64046371975.issue36248@roundup.psfhosted.org>
Message-ID: <1552122371.21.0.960455224145.issue36248@roundup.psfhosted.org>


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

Thank you Serhiy, we did document here: 

> The expression x and y first evaluates x; if x is false, its value is returned; otherwise, y is evaluated and the resulting value is returned.

> The expression x or y first evaluates x; if x is true, its value is returned; otherwise, y is evaluated and the resulting value is returned.

Sorry, Steven. I should make it clear. I think the output of the example(1, 3) depends on the input order of number(1 or 0, 0 or 1) is not an expected behavior to me. Maybe we can add an example/note in the document. 

"Sometimes this will cause unexpected behavior when you put `or` and `and` together..."

----------

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

From report at bugs.python.org  Sat Mar  9 04:27:45 2019
From: report at bugs.python.org (SilentGhost)
Date: Sat, 09 Mar 2019 09:27:45 +0000
Subject: [docs] [issue36248] document about `or`, `and` operator.
In-Reply-To: <1552112664.77.0.64046371975.issue36248@roundup.psfhosted.org>
Message-ID: <1552123665.91.0.519186690818.issue36248@roundup.psfhosted.org>


SilentGhost <ghost.adh at runbox.com> added the comment:

Windson, it still is not clear what exactly you find unexpected in view of supplied links:

1 or 0 and 3
or has higher precedence than and, therefore it's evaluated first. It's first argument (1) is truthy, therefore it's returned. End of comparison.

0 or 1 and 3
starts the same, but now the second argument (1 and 3) needs evaluating and its return value (3) will be the end result. End of comparison.

I certainly think the suggested wording is a no go.

----------
nosy: +SilentGhost

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

From report at bugs.python.org  Sat Mar  9 04:55:27 2019
From: report at bugs.python.org (Windson Yang)
Date: Sat, 09 Mar 2019 09:55:27 +0000
Subject: [docs] [issue36248] document about `or`, `and` operator.
In-Reply-To: <1552112664.77.0.64046371975.issue36248@roundup.psfhosted.org>
Message-ID: <1552125327.9.0.793424242678.issue36248@roundup.psfhosted.org>


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

SilentGhost, I think you give a great example to explain this behavior. If the behavior is obvious to you, we can close this issue.

----------

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

From report at bugs.python.org  Sat Mar  9 06:33:10 2019
From: report at bugs.python.org (SilentGhost)
Date: Sat, 09 Mar 2019 11:33:10 +0000
Subject: [docs] [issue36248] document about `or`, `and` operator.
In-Reply-To: <1552112664.77.0.64046371975.issue36248@roundup.psfhosted.org>
Message-ID: <1552131190.08.0.713290215711.issue36248@roundup.psfhosted.org>


Change by SilentGhost <ghost.adh at runbox.com>:


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

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

From report at bugs.python.org  Sat Mar  9 21:41:12 2019
From: report at bugs.python.org (Windson Yang)
Date: Sun, 10 Mar 2019 02:41:12 +0000
Subject: [docs] [issue18697] Unify arguments names in Unicode object C API
 documentation
In-Reply-To: <1376074126.58.0.40251146149.issue18697@psf.upfronthosting.co.za>
Message-ID: <1552185672.78.0.712765604119.issue18697@roundup.psfhosted.org>


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

I agreed with @Matheus, it would be better than the current implementation

----------
nosy: +Windson Yang
versions: +Python 3.6, Python 3.7 -Python 2.7, Python 3.4, Python 3.5

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

From report at bugs.python.org  Sat Mar  9 21:41:26 2019
From: report at bugs.python.org (Windson Yang)
Date: Sun, 10 Mar 2019 02:41:26 +0000
Subject: [docs] [issue18697] Unify arguments names in Unicode object C API
 documentation
In-Reply-To: <1376074126.58.0.40251146149.issue18697@psf.upfronthosting.co.za>
Message-ID: <1552185686.18.0.54326046327.issue18697@roundup.psfhosted.org>


Change by Windson Yang <wiwindson at outlook.com>:


----------
versions: +Python 2.7, Python 3.4, Python 3.5

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

From report at bugs.python.org  Sat Mar  9 21:41:57 2019
From: report at bugs.python.org (Windson Yang)
Date: Sun, 10 Mar 2019 02:41:57 +0000
Subject: [docs] [issue18697] Unify arguments names in Unicode object C API
 documentation
In-Reply-To: <1376074126.58.0.40251146149.issue18697@psf.upfronthosting.co.za>
Message-ID: <1552185717.32.0.840899212604.issue18697@roundup.psfhosted.org>


Change by Windson Yang <wiwindson at outlook.com>:


----------
versions:  -Python 2.7

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

From report at bugs.python.org  Sat Mar  9 22:36:12 2019
From: report at bugs.python.org (Windson Yang)
Date: Sun, 10 Mar 2019 03:36:12 +0000
Subject: [docs] [issue26018] documentation of ZipFile file name encoding
In-Reply-To: <1452038801.7.0.594053315947.issue26018@psf.upfronthosting.co.za>
Message-ID: <1552188972.56.0.536529634852.issue26018@roundup.psfhosted.org>


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

I can't find the Note in the current document

----------
nosy: +Windson Yang
versions: +Python 3.4, Python 3.5 -Python 3.7, Python 3.8

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

From report at bugs.python.org  Sat Mar  9 22:36:56 2019
From: report at bugs.python.org (Windson Yang)
Date: Sun, 10 Mar 2019 03:36:56 +0000
Subject: [docs] [issue26018] documentation of ZipFile file name encoding
In-Reply-To: <1452038801.7.0.594053315947.issue26018@psf.upfronthosting.co.za>
Message-ID: <1552189016.72.0.745960226581.issue26018@roundup.psfhosted.org>


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

Please ignore the last message, the docs locate in 3.4 and 3.5

----------

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

From report at bugs.python.org  Sun Mar 10 04:24:30 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 10 Mar 2019 08:24:30 +0000
Subject: [docs] [issue26018] documentation of ZipFile file name encoding
In-Reply-To: <1452038801.7.0.594053315947.issue26018@psf.upfronthosting.co.za>
Message-ID: <1552206270.14.0.919017505824.issue26018@roundup.psfhosted.org>


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

This not have been removed in issue32035. 3.4 and 3.5 currently take only security fixes.

----------
nosy: +serhiy.storchaka
resolution:  -> out of date
stage: needs patch -> resolved
status: open -> closed

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

From syedafrid756 at gmail.com  Sun Mar 10 01:22:32 2019
From: syedafrid756 at gmail.com (SYED AFRID)
Date: Sun, 10 Mar 2019 11:52:32 +0530
Subject: [docs] For tutorial
Message-ID: <CAJpd7PE=UHSnMuioqQtd9HYaY4b1zuqL6Ep-JtYM5BFryUi1sw@mail.gmail.com>

Python 3 tutorial available? Is it good as of now to learn?
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190310/0281fde9/attachment-0001.html>

From report at bugs.python.org  Sun Mar 10 07:30:16 2019
From: report at bugs.python.org (Nick Coghlan)
Date: Sun, 10 Mar 2019 11:30:16 +0000
Subject: [docs] [issue21314] Document '/' in signatures
In-Reply-To: <1397988439.5.0.703056699862.issue21314@psf.upfronthosting.co.za>
Message-ID: <1552217415.97.0.672857017823.issue21314@roundup.psfhosted.org>


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


New changeset 1aeeaeb79efa4de41f97b58547e23c2965ecabc5 by Nick Coghlan (Lysandros Nikolaou) in branch 'master':
bpo-21314: Add a FAQ entry about positional only parameters (GH-10641)
https://github.com/python/cpython/commit/1aeeaeb79efa4de41f97b58547e23c2965ecabc5


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

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

From report at bugs.python.org  Sun Mar 10 07:30:24 2019
From: report at bugs.python.org (miss-islington)
Date: Sun, 10 Mar 2019 11:30:24 +0000
Subject: [docs] [issue21314] Document '/' in signatures
In-Reply-To: <1397988439.5.0.703056699862.issue21314@psf.upfronthosting.co.za>
Message-ID: <1552217424.65.0.265072043429.issue21314@roundup.psfhosted.org>


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


----------
pull_requests: +12250

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

From report at bugs.python.org  Sun Mar 10 07:36:20 2019
From: report at bugs.python.org (miss-islington)
Date: Sun, 10 Mar 2019 11:36:20 +0000
Subject: [docs] [issue21314] Document '/' in signatures
In-Reply-To: <1397988439.5.0.703056699862.issue21314@psf.upfronthosting.co.za>
Message-ID: <1552217780.69.0.849692545926.issue21314@roundup.psfhosted.org>


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


New changeset 87f5255cdc9aa737d445b5813e52c41e5266a862 by Miss Islington (bot) in branch '3.7':
bpo-21314: Add a FAQ entry about positional only parameters (GH-10641)
https://github.com/python/cpython/commit/87f5255cdc9aa737d445b5813e52c41e5266a862


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

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

From report at bugs.python.org  Sun Mar 10 07:46:02 2019
From: report at bugs.python.org (Nick Coghlan)
Date: Sun, 10 Mar 2019 11:46:02 +0000
Subject: [docs] [issue21314] Document '/' in signatures
In-Reply-To: <1397988439.5.0.703056699862.issue21314@psf.upfronthosting.co.za>
Message-ID: <1552218362.82.0.405955706768.issue21314@roundup.psfhosted.org>


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

I went ahead and merged Lysandros's new FAQ entry (Thank you Lysandros!), as having some level of documentation for this notation is markedly better than the previous "none at all", and the PR added cross-references from the builtins and inspect module docs in addition to adding the FAQ itself.

However, I'm not closing the issue yet as:

- the exact wording could likely stand to be tweaked a bit (in particular, I'm not sure it's a good idea to reference PEP 570 from the FAQ entry)

- we may want to enhance pydoc itself to explain the notation inline (e.g. by appending a footer saying "Note: parameters to the left of ``/`` entries are positional only and cannot be passed by name" after the docstring being displayed when positional only parameters are found, and "Note: parameters to the right of ``*`` and ``*name`` entries are keyword only and can only be passed by name" when keyword only parameters are found)

- we may want to file a follow-up issue proposing that `pydoc` go back to either not marking positional-only parameters at all, or marking them differently (e.g. with "Note: *x*, *y*, and *z* are positional only parameters that cannot be passed by name" after the individual callable docstrings)

----------
nosy: +rhettinger -miss-islington
stage: patch review -> commit review

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

From report at bugs.python.org  Sun Mar 10 18:19:05 2019
From: report at bugs.python.org (Ofek Lev)
Date: Sun, 10 Mar 2019 22:19:05 +0000
Subject: [docs] [issue36258] Incorrect docstring of the ssl module
Message-ID: <1552256345.94.0.910242914596.issue36258@roundup.psfhosted.org>


New submission from Ofek Lev <ofekmeister at gmail.com>:

The docstring refers to the function `fetch_server_certificate` that no longer exists. Context from https://github.com/python/cpython/pull/12168#issuecomment-469488585:

"""
In the commit on 8/28/2007, the ssl.py module was first added and it contained the fetch_server_certificate() function. That function was removed with commit r57680 on 8/30/2007. The function get_server_certificate() was added in commit r58164 on 9/18/2007.
...
Additionally, there are more than just 2 functions now, so it seems to me that the entire module docstring should be reviewed and updated to reflect the current state of the module or else it should be removed since it hasn't been kept in sync.
"""

----------
assignee: docs at python
components: Documentation
messages: 337639
nosy: Ofekmeister, cheryl.sabella, docs at python
priority: normal
severity: normal
status: open
title: Incorrect docstring of the ssl module
type: behavior
versions: Python 2.7, Python 3.4, Python 3.5, Python 3.6, Python 3.7, Python 3.8

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

From report at bugs.python.org  Mon Mar 11 04:01:41 2019
From: report at bugs.python.org (Mark Dickinson)
Date: Mon, 11 Mar 2019 08:01:41 +0000
Subject: [docs] [issue36240] Definitions of time
In-Reply-To: <1552055339.11.0.882485944217.issue36240@roundup.psfhosted.org>
Message-ID: <1552291301.72.0.686272431211.issue36240@roundup.psfhosted.org>


Change by Mark Dickinson <dickinsm at gmail.com>:


----------
nosy: +belopolsky, mark.dickinson

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

From chengnian at zkfurong.com  Mon Mar 11 04:42:12 2019
From: chengnian at zkfurong.com (=?utf-8?B?56iL5b+1?=)
Date: Mon, 11 Mar 2019 16:42:12 +0800
Subject: [docs] example error--port  inconsistent
Message-ID: <tencent_5416308446C6AC9D2282B017@qq.com>

docs  url: https://docs.python.org/3/library/multiprocessing.html
describe?The connection ports are inconsistent
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190311/cf9c3e4c/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: B06B718C at 7D59C548.641F865C.png
Type: application/octet-stream
Size: 53416 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20190311/cf9c3e4c/attachment-0001.obj>

From julien at palard.fr  Mon Mar 11 05:58:22 2019
From: julien at palard.fr (Julien Palard)
Date: Mon, 11 Mar 2019 09:58:22 +0000
Subject: [docs] example error--port  inconsistent
In-Reply-To: <tencent_5416308446C6AC9D2282B017@qq.com>
References: <tencent_5416308446C6AC9D2282B017@qq.com>
Message-ID: <DCDF0Uz81Upvgrx80f8qc503ejai5aVCDpeaYcGYlC7v_PNgu_khMgx8_dien0Z849WP8P-qaN8f_pXtoAtOKX0A8DAz-l6FffiecIEsdEc=@palard.fr>

Hi!

Thanks for reporting, I'm fixing this here: https://github.com/python/cpython/pull/12273 does it looks OK to you?

Bests,
--?
Julien Palard
https://mdk.fr


From chengnian at zkfurong.com  Mon Mar 11 06:39:05 2019
From: chengnian at zkfurong.com (=?utf-8?B?56iL5b+1?=)
Date: Mon, 11 Mar 2019 18:39:05 +0800
Subject: [docs] =?utf-8?b?5Zue5aSNOlJlOiAgZXhhbXBsZSBlcnJvci0tcG9ydCAg?=
 =?utf-8?q?inconsistent?=
Message-ID: <tencent_358354CB1165D0B1473CC45B@qq.com>

Hi, very good!


--------------????--------------
????"Julien Palard "<julien at palard.fr>;
?????2019?3?11?(???) ??5:58
????"??" <chengnian at zkfurong.com>;
???"docs at python.org "<docs at python.org>;
???Re: [docs] example error--port  inconsistent
-----------------------------------

 Hi!

Thanks for reporting, I'm fixing this here: https://github.com/python/cpython/pull/12273 does it looks OK to you?

Bests,
-- 
Julien Palard
https://mdk.fr
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190311/93d34930/attachment.html>

From report at bugs.python.org  Mon Mar 11 11:09:46 2019
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Mon, 11 Mar 2019 15:09:46 +0000
Subject: [docs] [issue36240] Definitions of time
In-Reply-To: <1552055339.11.0.882485944217.issue36240@roundup.psfhosted.org>
Message-ID: <1552316986.28.0.00442474401812.issue36240@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Mon Mar 11 11:22:08 2019
From: report at bugs.python.org (Alexander Belopolsky)
Date: Mon, 11 Mar 2019 15:22:08 +0000
Subject: [docs] [issue36240] Definitions of time
In-Reply-To: <1552055339.11.0.882485944217.issue36240@roundup.psfhosted.org>
Message-ID: <1552317728.32.0.984948502791.issue36240@roundup.psfhosted.org>


Alexander Belopolsky <alexander.belopolsky at gmail.com> added the comment:

How about replacing "formerly known as Greenwich Mean Time, or GMT" with "which superseded Greenwich Mean Time or GMT as the basis of international timekeeping"?

I don't think Python reference manual is the right place to explain the difference between UTC and GMT, but since we have time.gmtime() function, GMT should still be mentioned.

----------

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

From report at bugs.python.org  Mon Mar 11 14:51:12 2019
From: report at bugs.python.org (Paul Ganssle)
Date: Mon, 11 Mar 2019 18:51:12 +0000
Subject: [docs] [issue36240] Definitions of time
In-Reply-To: <1552055339.11.0.882485944217.issue36240@roundup.psfhosted.org>
Message-ID: <1552330272.92.0.0357194808934.issue36240@roundup.psfhosted.org>


Paul Ganssle <p.ganssle at gmail.com> added the comment:

I also think it would be ideal to avoid getting into too much detail about the definitions of UTC and GMT in a general sense. Instead, we should probably refer to some better source on the matter and maybe focus on how UTC and GMT are used *in this document*?

For example, the `gmtime` function is explicitly defined in terms of UTC in the documentation, and just has a possibly slightly inaccurate name. Perhaps a wording like "Occasionally the abbreviations 'GMT' and 'UTC' are used interchangeably, despite the fact that this is somewhat inaccurate. For more information about the difference between UTC and GMT, see <external source>."

As something of an aside, the same bullet point says this:

> The acronym UTC is not a mistake but a compromise between English and French.

This came up recently on the tz mailing list, where it was claimed that there is no contemporary evidence to support this: https://mm.icann.org/pipermail/tz/2019-March/027736.html

It may be worth removing this sentence or rewording it to be more neutral, like "The acronym UTC is not a mistake but conforms to an earlier, language-agnostic naming scheme for time standards: UT0, UT1, etc." I can move the discussion of the "UTC acronym" wording into a separate ticket if it's distracting from this one.

----------

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

From julien at palard.fr  Mon Mar 11 17:31:19 2019
From: julien at palard.fr (Julien Palard)
Date: Mon, 11 Mar 2019 21:31:19 +0000
Subject: [docs] For tutorial
In-Reply-To: <CAJpd7PE=UHSnMuioqQtd9HYaY4b1zuqL6Ep-JtYM5BFryUi1sw@mail.gmail.com>
References: <CAJpd7PE=UHSnMuioqQtd9HYaY4b1zuqL6Ep-JtYM5BFryUi1sw@mail.gmail.com>
Message-ID: <qWOtJKcjYW1mgvNRT9loO1NhHhR6u5kzOjYvuDT0AYXQwEUGzzAE5GtP-OBtEFMdlUK82J25pyIIJhPzTEEuAlpsQGEjKQeWh7F7TpHorts=@palard.fr>

Hi,

> Python 3 tutorial available? Is it good as of now to learn?

Yes, the Python 3 tutorial is available here in various languages: http://docs.python.org/3/tutorial/

and yes, it's a good start to learn Python, and it's up-to-date, well maintained.

Bests,
--?
Julien Palard
https://mdk.fr





From julien at palard.fr  Mon Mar 11 17:49:39 2019
From: julien at palard.fr (Julien Palard)
Date: Mon, 11 Mar 2019 21:49:39 +0000
Subject: [docs] Section 5 of Python 2.7.16 documentation errors
In-Reply-To: <2799d069-4136-788a-6f0e-7b47a838086b@gmail.com>
References: <2799d069-4136-788a-6f0e-7b47a838086b@gmail.com>
Message-ID: <bRKDxctM4oQ4DDdNypdnaP9vdSjPxMTZ7cqLAj6l2-c0AnXnnVNHdQY3NwPVppmyh_juf9FevakxysSEKlfhs-qFKbP4bRyM4BRfPM7Dnto=@palard.fr>

Hi Bud!

Thanks for taking the time to report issues, it's appreciated!


> Most notable, section 5. Expressions
>
> def f(a,b):
>
>     print a,b  # raises an error and should read print(a,b)

Your mail subject indicates you found those errors in the Python 2.7 documentation, but it looks like you're trying with a Python 3.

print a, b is a Python 2 syntax, and print(a, b) is a Python 3 syntax, there's a whole lot of changes that happened between Python 2 and Python 3 ten years ago, you probably want to focus on Python 3 noadays, while reading the Python 3 documentation.

> Section 5.4  Raising a negative number to a fractional power does not
> return an error as stated in the documentation but appears to
> functioning correctly.

Again, you may have tried with a Python 3:

# Python 2.7.16

>>> (-1) ** .5
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ValueError: negative number cannot be raised to a fractional power

# Python 3.7.2

>>> (-1) ** .5
(6.123233995736766e-17+1j)


> Section 5.9  <> returns a syntax error and is no longer usable to replace !=

# Python 2.7.16

>>> 1 <> 2
True

# Python 3.7.2

>>> 1 <> 2
  File "<stdin>", line 1
    1 <> 2
       ^
SyntaxError: invalid syntax

Bests,
--?
Julien Palard
https://mdk.fr







From julien at palard.fr  Mon Mar 11 18:02:20 2019
From: julien at palard.fr (Julien Palard)
Date: Mon, 11 Mar 2019 22:02:20 +0000
Subject: [docs] Problem: Order of operations with a list
In-Reply-To: <CADGtm3yuEGMDnfES=McseLQ2qU7AzHG3pKUcYKotPMBsp5UeSQ@mail.gmail.com>
References: <CADGtm3yuEGMDnfES=McseLQ2qU7AzHG3pKUcYKotPMBsp5UeSQ@mail.gmail.com>
Message-ID: <nkY9evdm-ORJwIeNweCilXis6ekblSvBZMkqnFO2VcFm1xybIWZPCITSiTygGYZIR6fucxvugkd3VNs0LatUIflf4JRKpFgZItk48B4UdA0=@palard.fr>

Hi MrSiuol,

> There is a problem with: [0]*4/2
>
> "Traceback (most recent call last):
>   File "<pyshell#5>", line 1, in <module>
>     [0]*4/2
> TypeError: unsupported operand type(s) for /: 'list' and 'int'"
>
> Solution: prioritize calcul without list, before duplicate list

Did you find [0]*4/2 in the documentation? I can't find it (this is a mailing list about documentation, to report bugs about the language please use https://bugs.python.org).

A good solution for your problem would be: `[0] * int(4 / 2)`, assuming either 4 or 2 are variables in your code, else just write `[0, 0]` :)

Bests,
--?
Julien Palard
https://mdk.fr


From julien at palard.fr  Mon Mar 11 18:17:23 2019
From: julien at palard.fr (Julien Palard)
Date: Mon, 11 Mar 2019 22:17:23 +0000
Subject: [docs] Possible Documentation bug: Chapter 8. Errors and
 Exceptions
In-Reply-To: <CAOdCNHfA-dVvQY7SVw=NG_8Z=gsmFebfhr9eCrXzNTvTorFdqQ@mail.gmail.com>
References: <CAOdCNHfA-dVvQY7SVw=NG_8Z=gsmFebfhr9eCrXzNTvTorFdqQ@mail.gmail.com>
Message-ID: <4O9vZ6xarAAjcaEjn45VtodhVXEnONcBLohU7VyQ3uHH8sBahGwbmDc8rVOViJqD9XaVJyE5oolF0Ho2YwblK66NPo6h7el47ntXYBNho1I=@palard.fr>

Hi Rahul, thanks for asking,


> I was going through the chapter as per the below link :
> https://docs.python.org/3/tutorial/errors.html#handling-exceptions
> [...]
> I think this elaboration needs to be done.
>
> I would request you to provide your insights on this.

A simple way to think of it is to remember the exception hiearchy: https://docs.python.org/3/library/exceptions.html?highlight=baseexception#exception-hierarchy

For example, here, ArithmeticError inherits Exception, it's more specific, and ZeroDivisionError inherits from ArithmeticError, is really specific. So we have something like:

class ArithmeticError(Exception):
    pass

class ZeroDivisionError(ArithmeticError):
    pass

expecting Exception will catch Exception, ArithmeticError and ZeroDivisionError
expecting ArithmeticError will catch ArithmeticError and ZeroDivisionError
expecting ZeroDivisionError will only catch ZeroDivisionError.

Back to the example with B, C, D: D is the most specific, and B the most generic exception, so writing:

    except D:
        print("D")
    except C:
        print("C")
    except B:
        print("B")

tries the most specific first, which have a chance to catch D.

writing it the other way around, we're getting "except B" first, the generic one, which will catch B, C, and D, thus printing B three times.

Hope it helps,

Bests,
--?
Julien Palard
https://mdk.fr


From report at bugs.python.org  Mon Mar 11 18:50:38 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Mon, 11 Mar 2019 22:50:38 +0000
Subject: [docs] [issue28124] Rework SSL module documentation
In-Reply-To: <1473762840.76.0.666078412099.issue28124@psf.upfronthosting.co.za>
Message-ID: <1552344637.99.0.547727541762.issue28124@roundup.psfhosted.org>


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

Can this issue be closed as resolved?  It looks like the changes have been merged even though the first PR still has an 'open' status.  Thanks!

----------
nosy: +cheryl.sabella

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

From report at bugs.python.org  Mon Mar 11 18:54:54 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Mon, 11 Mar 2019 22:54:54 +0000
Subject: [docs] [issue21314] Document '/' in signatures
In-Reply-To: <1397988439.5.0.703056699862.issue21314@psf.upfronthosting.co.za>
Message-ID: <1552344894.76.0.141900598237.issue21314@roundup.psfhosted.org>


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

There are a few other open issues about positional-only keywords (for example, #10789 and #8350).  I wasn't sure what, if anything, could be done with those now that the '/' is available and documented.

----------
nosy: +cheryl.sabella

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

From rahulvinay51 at gmail.com  Mon Mar 11 23:40:55 2019
From: rahulvinay51 at gmail.com (Rahul Babtiwale)
Date: Tue, 12 Mar 2019 09:10:55 +0530
Subject: [docs] Possible Documentation bug: Chapter 8. Errors and
 Exceptions
In-Reply-To: <4O9vZ6xarAAjcaEjn45VtodhVXEnONcBLohU7VyQ3uHH8sBahGwbmDc8rVOViJqD9XaVJyE5oolF0Ho2YwblK66NPo6h7el47ntXYBNho1I=@palard.fr>
References: <CAOdCNHfA-dVvQY7SVw=NG_8Z=gsmFebfhr9eCrXzNTvTorFdqQ@mail.gmail.com>
 <4O9vZ6xarAAjcaEjn45VtodhVXEnONcBLohU7VyQ3uHH8sBahGwbmDc8rVOViJqD9XaVJyE5oolF0Ho2YwblK66NPo6h7el47ntXYBNho1I=@palard.fr>
Message-ID: <CAOdCNHcr=Ao+g08U2Lm6Mq-Cu3o3FY816R4Rt=0sMjS9VzBAYw@mail.gmail.com>

Hello Julien,

Thank you for the clarification. I appreciate your help.

Best Regards,
Rahul


On Tue, 12 Mar 2019, 03:47 Julien Palard, <julien at palard.fr> wrote:

> Hi Rahul, thanks for asking,
>
>
> > I was going through the chapter as per the below link :
> > https://docs.python.org/3/tutorial/errors.html#handling-exceptions
> > [...]
> > I think this elaboration needs to be done.
> >
> > I would request you to provide your insights on this.
>
> A simple way to think of it is to remember the exception hiearchy:
> https://docs.python.org/3/library/exceptions.html?highlight=baseexception#exception-hierarchy
>
> For example, here, ArithmeticError inherits Exception, it's more specific,
> and ZeroDivisionError inherits from ArithmeticError, is really specific. So
> we have something like:
>
> class ArithmeticError(Exception):
>     pass
>
> class ZeroDivisionError(ArithmeticError):
>     pass
>
> expecting Exception will catch Exception, ArithmeticError and
> ZeroDivisionError
> expecting ArithmeticError will catch ArithmeticError and ZeroDivisionError
> expecting ZeroDivisionError will only catch ZeroDivisionError.
>
> Back to the example with B, C, D: D is the most specific, and B the most
> generic exception, so writing:
>
>     except D:
>         print("D")
>     except C:
>         print("C")
>     except B:
>         print("B")
>
> tries the most specific first, which have a chance to catch D.
>
> writing it the other way around, we're getting "except B" first, the
> generic one, which will catch B, C, and D, thus printing B three times.
>
> Hope it helps,
>
> Bests,
> --
> Julien Palard
> https://mdk.fr
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190312/0a215008/attachment.html>

From laura.hike at gmail.com  Mon Mar 11 19:37:24 2019
From: laura.hike at gmail.com (Laura Hinkelman)
Date: Mon, 11 Mar 2019 16:37:24 -0700
Subject: [docs] Definition of Julian day
Message-ID: <CANGk9wzKmRBgs-U7PRjE6HE_=XudtAW0C7P0xp7m5xEC7DnfVA@mail.gmail.com>

Hi,

On your documentation web page

  https://docs.python.org/2/library/time.html

it says:

  The Julian day *n* (1 <= *n* <= 365). ....

Despite common usage, what you are defining is the day of the year, not the
"Julian day."  Julian time is a complete time/date definition system based
on a reference time of noon Universal Time on January 1, 4713 BC (on the
Julian calendar).  This system originates in the astronomical community.
(See references below.) I'm really surprised that there aren't native
Python functions to convert in and out of Julian time, given that there are
plenty of astronomers writing code in Python.  Anyway, you might want to
write "day of year, sometimes (erroneously) referred to as Julian day," or
something like that.

https://aa.usno.navy.mil/data/docs/JulianDate.php
https://en.wikipedia.org/wiki/Julian_day

Along the same lines, I think it's silly to use a start year of 1970 for
your time reference, even if that's a UNIX convention.  A few things we
care about happened before 1970 -- and a few more will happen after 2038.
Hard endpoints are incredibly limiting.  This is why Matlab defines a
reference date of Jan. 1, 0000, and other people use Julian time, which has
an admittedly bizarre reference time.

Thanks,

Laura H.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190311/617ca504/attachment.html>

From syedafrid756 at gmail.com  Mon Mar 11 22:38:37 2019
From: syedafrid756 at gmail.com (SYED AFRID)
Date: Tue, 12 Mar 2019 08:08:37 +0530
Subject: [docs] For tutorial
In-Reply-To: <qWOtJKcjYW1mgvNRT9loO1NhHhR6u5kzOjYvuDT0AYXQwEUGzzAE5GtP-OBtEFMdlUK82J25pyIIJhPzTEEuAlpsQGEjKQeWh7F7TpHorts=@palard.fr>
References: <CAJpd7PE=UHSnMuioqQtd9HYaY4b1zuqL6Ep-JtYM5BFryUi1sw@mail.gmail.com>
 <qWOtJKcjYW1mgvNRT9loO1NhHhR6u5kzOjYvuDT0AYXQwEUGzzAE5GtP-OBtEFMdlUK82J25pyIIJhPzTEEuAlpsQGEjKQeWh7F7TpHorts=@palard.fr>
Message-ID: <CAJpd7PG_sH6y3DYfVVqAV+NC+ob+2FSW-445McUh9iGC7f=uSQ@mail.gmail.com>

Thank you!

On Tue 12 Mar, 2019, 3:01 AM Julien Palard, <julien at palard.fr> wrote:

> Hi,
>
> > Python 3 tutorial available? Is it good as of now to learn?
>
> Yes, the Python 3 tutorial is available here in various languages:
> http://docs.python.org/3/tutorial/
>
> and yes, it's a good start to learn Python, and it's up-to-date, well
> maintained.
>
> Bests,
> --
> Julien Palard
> https://mdk.fr
>
>
>
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190312/d09d9da9/attachment-0001.html>

From anurag05081996 at gmail.com  Tue Mar 12 04:30:42 2019
From: anurag05081996 at gmail.com (Anurag Sharma)
Date: Tue, 12 Mar 2019 14:00:42 +0530
Subject: [docs] next() and count() method don't work.
Message-ID: <CANdP7HVX0CR4eno3C62cfrUCj0SpCSFoNo2cBVV6oEGTJzO2qg@mail.gmail.com>

Hon'able Python Team,
I am learning python, and I was trying to build an algorithm that could
count the recurrence of the items in a set at run-time, that is, counting
the the number of occurrence in the set defined by the user, I tried using
multiple next() and count() method. As next() method works only within the
code, that is, it doesn't accept external values outside the loop, I tried
using while loop, but still didn't get the desired output. I am using
Python 3.7.2 and I am sending you screenshots as an attachment. Kindly look
into the same and let me know.
Thank You. Regards.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190312/bc74a710/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: Screenshot (5).png
Type: image/png
Size: 92230 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20190312/bc74a710/attachment-0002.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: Screenshot (6).png
Type: image/png
Size: 92561 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20190312/bc74a710/attachment-0003.png>

From bgailer at gmail.com  Tue Mar 12 10:46:39 2019
From: bgailer at gmail.com (Bob Gailer)
Date: Tue, 12 Mar 2019 10:46:39 -0400
Subject: [docs] next() and count() method don't work.
In-Reply-To: <CANdP7HVX0CR4eno3C62cfrUCj0SpCSFoNo2cBVV6oEGTJzO2qg@mail.gmail.com>
References: <CANdP7HVX0CR4eno3C62cfrUCj0SpCSFoNo2cBVV6oEGTJzO2qg@mail.gmail.com>
Message-ID: <CAP1rxO7VL_G4+87tsXj+ZdJgNUeRr+koQjh-FP0juHna8pL86A@mail.gmail.com>

> count the recurrence of the items in a set
I am redirecting this to the python help list.

Your question is unclear since normally the word recurrence would imply two
or more of the same item whereas a set has only one of each item.

If you want to know how many items there are in a set use the len function,
e.g. len(myset)

As an aside when asking a question like this keep it simple: how do I
determine the size of a set?
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190312/c113afec/attachment.html>

From report at bugs.python.org  Tue Mar 12 12:43:29 2019
From: report at bugs.python.org (=?utf-8?q?R=C3=A9mi_Lapeyre?=)
Date: Tue, 12 Mar 2019 16:43:29 +0000
Subject: [docs] [issue34713] csvwriter.writerow()'s return type is
 undocumented
In-Reply-To: <1537204445.4.0.956365154283.issue34713@psf.upfronthosting.co.za>
Message-ID: <1552409009.75.0.15415535103.issue34713@roundup.psfhosted.org>


R?mi Lapeyre <remi.lapeyre at henki.fr> added the comment:

csvwriter.writerows() does not return anything.

The return value of csv.writecsv() is the return value of the write() method of the file object given as parameter in csv.writer(). I'm not sure it's safe to document it, should we return None instead?

----------
nosy: +remi.lapeyre

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

From report at bugs.python.org  Tue Mar 12 21:21:31 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Wed, 13 Mar 2019 01:21:31 +0000
Subject: [docs] [issue36157] Document PyInterpreterState_Main().
In-Reply-To: <1551458200.72.0.727788487318.issue36157@roundup.psfhosted.org>
Message-ID: <1552440091.19.0.138922137067.issue36157@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Tue Mar 12 21:41:37 2019
From: report at bugs.python.org (Antony Lee)
Date: Wed, 13 Mar 2019 01:41:37 +0000
Subject: [docs] [issue36277] pdb's recursive debug command is not listed in
 the docs
Message-ID: <1552441297.14.0.332408963845.issue36277@roundup.psfhosted.org>


New submission from Antony Lee <anntzer.lee at gmail.com>:

pdb's recursive debug command (mentioned e.g. in https://bugs.python.org/issue35931) is not listed in https://docs.python.org/3/library/pdb.html#debugger-commands.
(I haven't checked whether any other command is missing.)

----------
assignee: docs at python
components: Documentation
messages: 337828
nosy: Antony.Lee, docs at python
priority: normal
severity: normal
status: open
title: pdb's recursive debug command is not listed in the docs

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

From thomaspatno at gmail.com  Tue Mar 12 19:52:51 2019
From: thomaspatno at gmail.com (Thomas Patno)
Date: Tue, 12 Mar 2019 16:52:51 -0700
Subject: [docs] full The Python Tutorial on one page option?
Message-ID: <CAFpvwb1eiorD_gf5eH6YTKGptYHkEALO+cYE24H36N1k4uEUqQ@mail.gmail.com>

Hi:

Please show me how or add the feature to show the full The Python Tutorial
on one page.

I noticed this was available for the index & would greatly appreciate it
for the tutorial page also.

Thanks for your consideration!
Thomas Patno
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190312/b53a1e83/attachment.html>

From report at bugs.python.org  Wed Mar 13 06:11:40 2019
From: report at bugs.python.org (=?utf-8?q?R=C3=A9mi_Lapeyre?=)
Date: Wed, 13 Mar 2019 10:11:40 +0000
Subject: [docs] [issue34713] csvwriter.writerow()'s return type is
 undocumented
In-Reply-To: <1537204445.4.0.956365154283.issue34713@psf.upfronthosting.co.za>
Message-ID: <1552471900.95.0.890769223581.issue34713@roundup.psfhosted.org>


R?mi Lapeyre <remi.lapeyre at henki.fr> added the comment:

Issue #27497 is related, it adds documentation a return value and documentation to csv.DictWriter.writeheader which uses writerow internally. 

In the discussion, @lsowen found code that uses it at https://docs.djangoproject.com/en/1.9/howto/outputting-csv/#streaming-large-csv-files.

Given that this behavior has been added to csv.DictWriter.writeheader it makes sense to document csv.Writer.writerow. Do you want to post a pull request?

----------

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

From report at bugs.python.org  Wed Mar 13 10:19:12 2019
From: report at bugs.python.org (=?utf-8?q?R=C3=A9mi_Lapeyre?=)
Date: Wed, 13 Mar 2019 14:19:12 +0000
Subject: [docs] [issue36277] pdb's recursive debug command is not listed in
 the docs
In-Reply-To: <1552441297.14.0.332408963845.issue36277@roundup.psfhosted.org>
Message-ID: <1552486752.14.0.462989355852.issue36277@roundup.psfhosted.org>


R?mi Lapeyre <remi.lapeyre at henki.fr> added the comment:

As far as I can tell, the list of pdb commands is:
  - commands
  - break
  - tbreak
  - enable
  - disable
  - condition
  - ignore
  - clear
  - where
  - up
  - down
  - until
  - step
  - next
  - run
  - return
  - continue
  - jump
  - debug
  - quit
  - args
  - retval
  - p
  - pp
  - list
  - longlist
  - source
  - whatis
  - display
  - undisplay
  - interact
  - alias
  - unalias
  - help

Those not in the documentation are debug and retval.

Can you open a new pull request to document them?

----------
nosy: +remi.lapeyre
versions: +Python 3.8

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

From report at bugs.python.org  Wed Mar 13 11:50:04 2019
From: report at bugs.python.org (Antony Lee)
Date: Wed, 13 Mar 2019 15:50:04 +0000
Subject: [docs] [issue36277] pdb's recursive debug command is not listed in
 the docs
In-Reply-To: <1552441297.14.0.332408963845.issue36277@roundup.psfhosted.org>
Message-ID: <1552492204.42.0.0981926805101.issue36277@roundup.psfhosted.org>


Antony Lee <anntzer.lee at gmail.com> added the comment:

I'll pass on that for now.

----------

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

From report at bugs.python.org  Wed Mar 13 13:09:31 2019
From: report at bugs.python.org (Nicholas Chammas)
Date: Wed, 13 Mar 2019 17:09:31 +0000
Subject: [docs] [issue34713] csvwriter.writerow()'s return type is
 undocumented
In-Reply-To: <1537204445.4.0.956365154283.issue34713@psf.upfronthosting.co.za>
Message-ID: <1552496971.27.0.592087258357.issue34713@roundup.psfhosted.org>


Nicholas Chammas <nicholas.chammas at gmail.com> added the comment:

Nope, go ahead.

----------

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

From report at bugs.python.org  Wed Mar 13 18:17:14 2019
From: report at bugs.python.org (Lysandros Nikolaou)
Date: Wed, 13 Mar 2019 22:17:14 +0000
Subject: [docs] [issue21314] Document '/' in signatures
In-Reply-To: <1397988439.5.0.703056699862.issue21314@psf.upfronthosting.co.za>
Message-ID: <1552515434.24.0.765293871692.issue21314@roundup.psfhosted.org>


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

I agree with Nick, that pydoc should somehow be updated to mark positional-only parameters as such. I believe that the third approach proposed by Nick is the most sensible one, as it makes the life of new developers easier by explicitly listing all the positional-only parameters. I could open a new issue and work on a PR, if you all agree that that is the way to go.

----------

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

From booleanoganesson205 at gmail.com  Wed Mar 13 18:40:39 2019
From: booleanoganesson205 at gmail.com (Boolean Oganesson)
Date: Thu, 14 Mar 2019 06:40:39 +0800
Subject: [docs] Can't download Python Documentation
Message-ID: <CAPekm0PLWVt_DHBDA_ddfay57VS63F8G-PrzMQWQrv5Nwyr2NA@mail.gmail.com>

Could you help me?....why I can't download the documentation....thank you!
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190314/07f94614/attachment.html>

From julien at palard.fr  Thu Mar 14 04:45:21 2019
From: julien at palard.fr (Julien Palard)
Date: Thu, 14 Mar 2019 08:45:21 +0000
Subject: [docs] Can't download Python Documentation
In-Reply-To: <CAPekm0PLWVt_DHBDA_ddfay57VS63F8G-PrzMQWQrv5Nwyr2NA@mail.gmail.com>
References: <CAPekm0PLWVt_DHBDA_ddfay57VS63F8G-PrzMQWQrv5Nwyr2NA@mail.gmail.com>
Message-ID: <zLm9T__sJAiSWBxL8UGR0ZoI_ZPSPgf0e0USBk6ZQ5aX4cxnwcG6o6WfBQLKvCK1LFZ7vb4geLQd-wqJlowZvKrVMx83Zj3Yh5URsMzmbuQ=@palard.fr>

Hi! Thanks for reporting!

Can you please tell me which version, which format, and which language, of the Python documentation you can't download?

Pyhton 3.8 PDF versions are known not to build due to https://bugs.python.org/issue35033
Korean version currently have some build problems too.

Other versions looks OK to me., can you give more details?
Bests,
--
Julien Palard
https://mdk.fr
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190314/70a15055/attachment.html>

From AlexShevchenko at mail.ru  Fri Mar 15 09:21:06 2019
From: AlexShevchenko at mail.ru (Aleksandr Shevchenko)
Date: Fri, 15 Mar 2019 17:21:06 +0400
Subject: [docs] The Python Tutorial - 9.8. Iterators
Message-ID: <b009c11b-e9f8-4430-93ac-9df28c3d8017@mail.ru>

Hi.

The Python Tutorial
9.8. Iterators

class Reverse:
     """Iterator for looping over a sequence backwards."""
     def __init__(self, data):
         self.data = data
         self.index = len(data)

     def __iter__(self):
         return self

     def __next__(self):
         if self.index == 0:
             raise StopIteration
         self.index = self.index - 1
         return self.data[self.index]


this example not reusable


but
     def __iter__(self):
         self.index = len(self.data)
         return self

made it reusabled


-- 
Best regards,
Aleksandr Shevchenko

From julien at palard.fr  Fri Mar 15 09:48:37 2019
From: julien at palard.fr (Julien Palard)
Date: Fri, 15 Mar 2019 13:48:37 +0000
Subject: [docs] The Python Tutorial - 9.8. Iterators
In-Reply-To: <b009c11b-e9f8-4430-93ac-9df28c3d8017@mail.ru>
References: <b009c11b-e9f8-4430-93ac-9df28c3d8017@mail.ru>
Message-ID: <NfGSTd38TTMLI61J1kwfhpzX5ty_bSfddmcLiIbNtrP9GkDuNKg8mWFFijhSpsj_wco2dz1nRK64TV_auaFPs7gAKz0aVWXSXli1Y3fotj8=@palard.fr>

Hi, thanks for your message!

I'm not sure it's worth it, I mean, if we want a nice Reverse, let's not just enhance a single step, let's allow for a same reverse to be iterated by multiple iterators in the same time, this mean implementing a ReverseIterator keeping track of the current position.

But let's keep the Tutorial simple. I'll be OK though to add a line *after* the example, right before 9.9, telling that this example is basic and could be enhanced by returning a dedicated ReverseIterator instead of returning self, so every one could track the position.

If you want to open a PR on http://github.com/python/cpython/ to add this sentense I'll happily merge it.

Bests,
--?
Julien Palard
https://mdk.fr


From report at bugs.python.org  Fri Mar 15 17:08:19 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Fri, 15 Mar 2019 21:08:19 +0000
Subject: [docs] [issue34464] There are inconsitencies in the treatment of
 True, False, None, and __debug__ keywords in the docs
In-Reply-To: <1534964930.72.0.56676864532.issue34464@psf.upfronthosting.co.za>
Message-ID: <1552684099.43.0.157689603258.issue34464@roundup.psfhosted.org>


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

@serhiy

The issue about the assigment operator is closed https://bugs.python.org/issue36052

could we close this issue?

thank you

----------

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

From report at bugs.python.org  Fri Mar 15 18:01:57 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Fri, 15 Mar 2019 22:01:57 +0000
Subject: [docs] [issue12020] Attribute error with flush on stdout,stderr
In-Reply-To: <1304703877.7.0.898555574271.issue12020@psf.upfronthosting.co.za>
Message-ID: <1552687317.33.0.570915287223.issue12020@roundup.psfhosted.org>


Change by Mark Lawrence <breamoreboy at gmail.com>:


----------
nosy:  -BreamoreBoy

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

From report at bugs.python.org  Fri Mar 15 18:06:56 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Fri, 15 Mar 2019 22:06:56 +0000
Subject: [docs] [issue20749] shutil.unpack_archive(): security concerns not
 documented
In-Reply-To: <1393190017.96.0.0939250007559.issue20749@psf.upfronthosting.co.za>
Message-ID: <1552687616.63.0.763604423079.issue20749@roundup.psfhosted.org>


Change by Mark Lawrence <breamoreboy at gmail.com>:


----------
nosy:  -BreamoreBoy

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

From report at bugs.python.org  Fri Mar 15 18:24:57 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Fri, 15 Mar 2019 22:24:57 +0000
Subject: [docs] [issue16834] ioctl mutate_flag behavior in regard to the
 buffer size limit
In-Reply-To: <1357052189.92.0.352175087043.issue16834@psf.upfronthosting.co.za>
Message-ID: <1552688697.35.0.963297597373.issue16834@roundup.psfhosted.org>


Change by Mark Lawrence <breamoreboy at gmail.com>:


----------
nosy:  -BreamoreBoy

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

From report at bugs.python.org  Fri Mar 15 18:43:46 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Fri, 15 Mar 2019 22:43:46 +0000
Subject: [docs] [issue21889]
 https://docs.python.org/2/library/multiprocessing.html#process-and-exceptions
 doesn't explain exception
In-Reply-To: <1404165638.91.0.279596288902.issue21889@psf.upfronthosting.co.za>
Message-ID: <1552689826.94.0.0767170708549.issue21889@roundup.psfhosted.org>


Change by Mark Lawrence <breamoreboy at gmail.com>:


----------
nosy:  -BreamoreBoy

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

From report at bugs.python.org  Fri Mar 15 19:09:37 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Fri, 15 Mar 2019 23:09:37 +0000
Subject: [docs] [issue23311] Update PC/example_nt and extending/windows.rst
In-Reply-To: <1422121201.94.0.918332856849.issue23311@psf.upfronthosting.co.za>
Message-ID: <1552691377.26.0.726735660958.issue23311@roundup.psfhosted.org>


Change by Mark Lawrence <breamoreboy at gmail.com>:


----------
nosy:  -BreamoreBoy

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

From report at bugs.python.org  Fri Mar 15 19:13:01 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Fri, 15 Mar 2019 23:13:01 +0000
Subject: [docs] [issue7057] tkinter doc: more 3.x updates
In-Reply-To: <1254697168.63.0.205098696566.issue7057@psf.upfronthosting.co.za>
Message-ID: <1552691581.89.0.552383612951.issue7057@roundup.psfhosted.org>


Change by Mark Lawrence <breamoreboy at gmail.com>:


----------
nosy:  -BreamoreBoy

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

From report at bugs.python.org  Fri Mar 15 19:15:28 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Fri, 15 Mar 2019 23:15:28 +0000
Subject: [docs] [issue14759] BSDDB license missing from liscense page in 2.7.
In-Reply-To: <1336525700.66.0.626657341837.issue14759@psf.upfronthosting.co.za>
Message-ID: <1552691728.8.0.766106659448.issue14759@roundup.psfhosted.org>


Change by Mark Lawrence <breamoreboy at gmail.com>:


----------
nosy:  -BreamoreBoy

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

From report at bugs.python.org  Fri Mar 15 19:19:19 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Fri, 15 Mar 2019 23:19:19 +0000
Subject: [docs] [issue8822] datetime naive and aware types should have a
 well-defined definition that can be cross-referenced
In-Reply-To: <1274875647.87.0.219158529549.issue8822@psf.upfronthosting.co.za>
Message-ID: <1552691959.36.0.343683710688.issue8822@roundup.psfhosted.org>


Change by Mark Lawrence <breamoreboy at gmail.com>:


----------
nosy:  -BreamoreBoy

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

From report at bugs.python.org  Fri Mar 15 19:22:34 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Fri, 15 Mar 2019 23:22:34 +0000
Subject: [docs] [issue9499] Python C/API Execution namespace undocumented.
 (patch included)
In-Reply-To: <1280873534.19.0.920563075759.issue9499@psf.upfronthosting.co.za>
Message-ID: <1552692154.88.0.151531087798.issue9499@roundup.psfhosted.org>


Change by Mark Lawrence <breamoreboy at gmail.com>:


----------
nosy:  -BreamoreBoy

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

From report at bugs.python.org  Fri Mar 15 19:23:07 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Fri, 15 Mar 2019 23:23:07 +0000
Subject: [docs] [issue8997] Write documentation for
 codecs.readbuffer_encode()
In-Reply-To: <1276543120.6.0.338687874276.issue8997@psf.upfronthosting.co.za>
Message-ID: <1552692187.66.0.792172720407.issue8997@roundup.psfhosted.org>


Change by Mark Lawrence <breamoreboy at gmail.com>:


----------
nosy:  -BreamoreBoy

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

From report at bugs.python.org  Fri Mar 15 19:31:42 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Fri, 15 Mar 2019 23:31:42 +0000
Subject: [docs] [issue1576313] os.execvp[e] on win32 fails for current
 directory
Message-ID: <1552692702.23.0.755139342048.issue1576313@roundup.psfhosted.org>


Change by Mark Lawrence <breamoreboy at gmail.com>:


----------
nosy:  -BreamoreBoy

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

From report at bugs.python.org  Fri Mar 15 19:32:49 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Fri, 15 Mar 2019 23:32:49 +0000
Subject: [docs] [issue16272] C-API documentation clarification for
 tp_dictoffset
In-Reply-To: <1350520063.61.0.687481658196.issue16272@psf.upfronthosting.co.za>
Message-ID: <1552692769.23.0.380811682954.issue16272@roundup.psfhosted.org>


Change by Mark Lawrence <breamoreboy at gmail.com>:


----------
nosy:  -BreamoreBoy

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

From report at bugs.python.org  Fri Mar 15 19:35:14 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Fri, 15 Mar 2019 23:35:14 +0000
Subject: [docs] [issue9739] Output of help(...) is wider than 80 characters
In-Reply-To: <1283403700.53.0.514117826781.issue9739@psf.upfronthosting.co.za>
Message-ID: <1552692914.29.0.159252604822.issue9739@roundup.psfhosted.org>


Change by Mark Lawrence <breamoreboy at gmail.com>:


----------
nosy:  -BreamoreBoy

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

From report at bugs.python.org  Fri Mar 15 19:36:08 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Fri, 15 Mar 2019 23:36:08 +0000
Subject: [docs] [issue18017] ctypes.PyDLL documentation
In-Reply-To: <1369010319.69.0.913023030404.issue18017@psf.upfronthosting.co.za>
Message-ID: <1552692968.93.0.33982845577.issue18017@roundup.psfhosted.org>


Change by Mark Lawrence <breamoreboy at gmail.com>:


----------
nosy:  -BreamoreBoy

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

From report at bugs.python.org  Fri Mar 15 19:44:02 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Fri, 15 Mar 2019 23:44:02 +0000
Subject: [docs] [issue12622] failfast argument to TextTestRunner not
 documented
In-Reply-To: <1311448108.9.0.673600380151.issue12622@psf.upfronthosting.co.za>
Message-ID: <1552693442.32.0.151755562932.issue12622@roundup.psfhosted.org>


Change by Mark Lawrence <breamoreboy at gmail.com>:


----------
nosy:  -BreamoreBoy

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

From report at bugs.python.org  Fri Mar 15 19:53:33 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Fri, 15 Mar 2019 23:53:33 +0000
Subject: [docs] [issue13074] Improve documentation of locale encoding
 functions
In-Reply-To: <1317370534.21.0.426762958064.issue13074@psf.upfronthosting.co.za>
Message-ID: <1552694013.56.0.167253115117.issue13074@roundup.psfhosted.org>


Change by Mark Lawrence <breamoreboy at gmail.com>:


----------
nosy:  -BreamoreBoy

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

From report at bugs.python.org  Fri Mar 15 19:54:44 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Fri, 15 Mar 2019 23:54:44 +0000
Subject: [docs] [issue8387] use universal newline mode in csv module examples
In-Reply-To: <1271193086.18.0.201846291594.issue8387@psf.upfronthosting.co.za>
Message-ID: <1552694084.89.0.454592983658.issue8387@roundup.psfhosted.org>


Change by Mark Lawrence <breamoreboy at gmail.com>:


----------
nosy:  -BreamoreBoy

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

From report at bugs.python.org  Fri Mar 15 20:00:55 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Sat, 16 Mar 2019 00:00:55 +0000
Subject: [docs] [issue13277] tzinfo subclasses information
In-Reply-To: <1319733607.49.0.8093265907.issue13277@psf.upfronthosting.co.za>
Message-ID: <1552694455.64.0.0859079576706.issue13277@roundup.psfhosted.org>


Change by Mark Lawrence <breamoreboy at gmail.com>:


----------
nosy:  -BreamoreBoy

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

From report at bugs.python.org  Fri Mar 15 20:02:52 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Sat, 16 Mar 2019 00:02:52 +0000
Subject: [docs] [issue13421] PyCFunction_* are not documented anywhere
In-Reply-To: <1321553683.63.0.825049607384.issue13421@psf.upfronthosting.co.za>
Message-ID: <1552694572.26.0.310639128537.issue13421@roundup.psfhosted.org>


Change by Mark Lawrence <breamoreboy at gmail.com>:


----------
nosy:  -BreamoreBoy

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

From report at bugs.python.org  Fri Mar 15 20:05:01 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Sat, 16 Mar 2019 00:05:01 +0000
Subject: [docs] [issue14547] Python symlink to script behaves unexpectedly
In-Reply-To: <1334155369.29.0.554259242167.issue14547@psf.upfronthosting.co.za>
Message-ID: <1552694701.01.0.128748499268.issue14547@roundup.psfhosted.org>


Change by Mark Lawrence <breamoreboy at gmail.com>:


----------
nosy:  -BreamoreBoy

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

From report at bugs.python.org  Fri Mar 15 20:07:20 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Sat, 16 Mar 2019 00:07:20 +0000
Subject: [docs] [issue13649] termios.ICANON is not documented
In-Reply-To: <1324566585.96.0.744911903947.issue13649@psf.upfronthosting.co.za>
Message-ID: <1552694840.02.0.660992446113.issue13649@roundup.psfhosted.org>


Change by Mark Lawrence <breamoreboy at gmail.com>:


----------
nosy:  -BreamoreBoy

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

From report at bugs.python.org  Fri Mar 15 20:09:20 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Sat, 16 Mar 2019 00:09:20 +0000
Subject: [docs] [issue13231] sys.settrace - document 'some other code
 blocks' for 'call' event type
In-Reply-To: <1319096421.5.0.420840017987.issue13231@psf.upfronthosting.co.za>
Message-ID: <1552694960.43.0.982014586543.issue13231@roundup.psfhosted.org>


Change by Mark Lawrence <breamoreboy at gmail.com>:


----------
nosy:  -BreamoreBoy

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

From report at bugs.python.org  Fri Mar 15 20:12:58 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Sat, 16 Mar 2019 00:12:58 +0000
Subject: [docs] [issue14189] Documentation for some C APIs is missing clear
 specification of the type of reference they return
In-Reply-To: <1330834739.26.0.103894619612.issue14189@psf.upfronthosting.co.za>
Message-ID: <1552695178.27.0.829702670543.issue14189@roundup.psfhosted.org>


Change by Mark Lawrence <breamoreboy at gmail.com>:


----------
nosy:  -BreamoreBoy

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

From report at bugs.python.org  Fri Mar 15 23:57:00 2019
From: report at bugs.python.org (Nick Coghlan)
Date: Sat, 16 Mar 2019 03:57:00 +0000
Subject: [docs] [issue36138] Improve documentation about converting
 datetime.timedelta to scalars
In-Reply-To: <1551279277.78.0.420201199405.issue36138@roundup.psfhosted.org>
Message-ID: <1552708620.86.0.738016685722.issue36138@roundup.psfhosted.org>


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


New changeset f40b4a0b6277b2779b9ded3736325489f2af93e4 by Nick Coghlan (Yasser A) in branch 'master':
bpo-36138: Clarify docs about converting datetime.timedelta to scalars. (GH-12137)
https://github.com/python/cpython/commit/f40b4a0b6277b2779b9ded3736325489f2af93e4


----------

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

From report at bugs.python.org  Fri Mar 15 23:57:57 2019
From: report at bugs.python.org (miss-islington)
Date: Sat, 16 Mar 2019 03:57:57 +0000
Subject: [docs] [issue36138] Improve documentation about converting
 datetime.timedelta to scalars
In-Reply-To: <1551279277.78.0.420201199405.issue36138@roundup.psfhosted.org>
Message-ID: <1552708677.61.0.903366537188.issue36138@roundup.psfhosted.org>


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


----------
pull_requests: +12329

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

From report at bugs.python.org  Sat Mar 16 00:03:46 2019
From: report at bugs.python.org (miss-islington)
Date: Sat, 16 Mar 2019 04:03:46 +0000
Subject: [docs] [issue36138] Improve documentation about converting
 datetime.timedelta to scalars
In-Reply-To: <1551279277.78.0.420201199405.issue36138@roundup.psfhosted.org>
Message-ID: <1552709026.22.0.50503351885.issue36138@roundup.psfhosted.org>


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


New changeset e213cd6325f2d6f116b6c3dce109cdf21f6263d5 by Miss Islington (bot) in branch '3.7':
bpo-36138: Clarify docs about converting datetime.timedelta to scalars. (GH-12137)
https://github.com/python/cpython/commit/e213cd6325f2d6f116b6c3dce109cdf21f6263d5


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

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

From report at bugs.python.org  Sat Mar 16 01:34:12 2019
From: report at bugs.python.org (Nick Coghlan)
Date: Sat, 16 Mar 2019 05:34:12 +0000
Subject: [docs] [issue36138] Improve documentation about converting
 datetime.timedelta to scalars
In-Reply-To: <1551279277.78.0.420201199405.issue36138@roundup.psfhosted.org>
Message-ID: <1552714452.17.0.780686096074.issue36138@roundup.psfhosted.org>


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

I've merged Yasser's PR (thank you!), but in the review discussion for that, we noticed something else: the `total_seconds()` documentation mentions the floating point dynamic resolution problem, but doesn't mention using `//` or `divmod()` as the fix for that, while the operator table doesn't mention the dynamic resolution problem at all.

So I haven't closed the issue yet, as fixing that feel in-scope for this issue, even though I didn't want to hold up the initial PR for it.

----------

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

From report at bugs.python.org  Sat Mar 16 04:07:36 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Sat, 16 Mar 2019 08:07:36 +0000
Subject: [docs] [issue14189] Documentation for some C APIs is missing clear
 specification of the type of reference they return
In-Reply-To: <1330834739.26.0.103894619612.issue14189@psf.upfronthosting.co.za>
Message-ID: <1552723656.63.0.0732447374616.issue14189@roundup.psfhosted.org>


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

I would like to work on this issue.

----------
nosy: +matrixise
versions: +Python 3.8 -Python 2.7

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

From report at bugs.python.org  Sat Mar 16 04:22:30 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 16 Mar 2019 08:22:30 +0000
Subject: [docs] [issue14189] Documentation for some C APIs is missing clear
 specification of the type of reference they return
In-Reply-To: <1330834739.26.0.103894619612.issue14189@psf.upfronthosting.co.za>
Message-ID: <1552724550.54.0.922574291473.issue14189@roundup.psfhosted.org>


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

This may be fixed recently (see issue18085, issue32077, issue35475 etc). Just check that this is true for all reported functions.

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

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

From report at bugs.python.org  Sun Mar 17 07:57:15 2019
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Sun, 17 Mar 2019 11:57:15 +0000
Subject: [docs] [issue12622] failfast argument to TextTestRunner not
 documented
In-Reply-To: <1311448108.9.0.673600380151.issue12622@psf.upfronthosting.co.za>
Message-ID: <1552823835.91.0.403978483682.issue12622@roundup.psfhosted.org>


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

failfast was added to the TextTestRunner signature in docs with issue17871 for 3.x and issue26097 for 2.7 . I guess the original issue was about signature missing in the docs and if so would propose closing this issue since it's fixed now.

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

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

From report at bugs.python.org  Sun Mar 17 10:53:46 2019
From: report at bugs.python.org (Christian Clauss)
Date: Sun, 17 Mar 2019 14:53:46 +0000
Subject: [docs] [issue36327] Remove EOLed Py34 from "Status of Python
 branches"
Message-ID: <1552834426.21.0.72238975198.issue36327@roundup.psfhosted.org>


New submission from Christian Clauss <cclauss at me.com>:

Remove Python 3.4 https://devguide.python.org/#branchstatus

Add Python 3.4 https://devguide.python.org/devcycle/#end-of-life-branches

----------
assignee: docs at python
components: Documentation
messages: 338131
nosy: cclauss, docs at python
priority: normal
severity: normal
status: open
title: Remove EOLed Py34 from "Status of Python branches"
versions: Python 3.4

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

From report at bugs.python.org  Sun Mar 17 11:03:40 2019
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Sun, 17 Mar 2019 15:03:40 +0000
Subject: [docs] [issue36327] Remove EOLed Py34 from "Status of Python
 branches"
In-Reply-To: <1552834426.21.0.72238975198.issue36327@roundup.psfhosted.org>
Message-ID: <1552835020.59.0.396635755277.issue36327@roundup.psfhosted.org>


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

The tracker is for CPython and the devguide has it's own issue tracker where this could be raised : https://github.com/python/devguide . I am just adding Larry who is release manager for 3.4 and closing this as third party. Feel free to reopen if needed.

----------
nosy: +larry, xtreak
resolution:  -> third party
stage:  -> resolved
status: open -> closed

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

From report at bugs.python.org  Sun Mar 17 14:57:56 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Sun, 17 Mar 2019 18:57:56 +0000
Subject: [docs] [issue36329] use the right python "make -C Doc/ serve"
In-Reply-To: <1552849058.57.0.633692372704.issue36329@roundup.psfhosted.org>
Message-ID: <1552849076.57.0.449480311766.issue36329@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Sun Mar 17 15:03:16 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Sun, 17 Mar 2019 19:03:16 +0000
Subject: [docs] [issue36329] use the right python "make -C Doc/ serve"
In-Reply-To: <1552849058.57.0.633692372704.issue36329@roundup.psfhosted.org>
Message-ID: <1552849396.09.0.267799700076.issue36329@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Sun Mar 17 21:53:11 2019
From: report at bugs.python.org (Ned Deily)
Date: Mon, 18 Mar 2019 01:53:11 +0000
Subject: [docs] [issue36195] initializer is not a valid param in
 ThreadPoolExecutor
In-Reply-To: <1551796082.49.0.510573730128.issue36195@roundup.psfhosted.org>
Message-ID: <1552873991.91.0.7558069531.issue36195@roundup.psfhosted.org>


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


New changeset e601ef0fa384d149f6759fff3c18762a8c63851e by Ned Deily (Harmandeep Singh) in branch '3.6':
bpo-36195: Remove the ThreadPoolExecutor documentation mentioning the initializer feature added in Python 3.7 (GH-12182)
https://github.com/python/cpython/commit/e601ef0fa384d149f6759fff3c18762a8c63851e


----------

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

From report at bugs.python.org  Sun Mar 17 21:54:01 2019
From: report at bugs.python.org (Ned Deily)
Date: Mon, 18 Mar 2019 01:54:01 +0000
Subject: [docs] [issue36195] initializer is not a valid param in
 ThreadPoolExecutor
In-Reply-To: <1551796082.49.0.510573730128.issue36195@roundup.psfhosted.org>
Message-ID: <1552874040.99.0.944936829106.issue36195@roundup.psfhosted.org>


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

Thanks for the PR!

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

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

From report at bugs.python.org  Mon Mar 18 06:38:18 2019
From: report at bugs.python.org (Carl Bordum Hansen)
Date: Mon, 18 Mar 2019 10:38:18 +0000
Subject: [docs] [issue23984] Documentation error: Descriptors
In-Reply-To: <1429245728.01.0.810263114275.issue23984@psf.upfronthosting.co.za>
Message-ID: <1552905498.15.0.515534339441.issue23984@roundup.psfhosted.org>


Change by Carl Bordum Hansen <carl at bordum.dk>:


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

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

From report at bugs.python.org  Mon Mar 18 06:38:58 2019
From: report at bugs.python.org (Carl Bordum Hansen)
Date: Mon, 18 Mar 2019 10:38:58 +0000
Subject: [docs] [issue23984] Documentation error: Descriptors
In-Reply-To: <1429245728.01.0.810263114275.issue23984@psf.upfronthosting.co.za>
Message-ID: <1552905538.78.0.462182388117.issue23984@roundup.psfhosted.org>


Carl Bordum Hansen <carl at bordum.dk> added the comment:

I submitted a PR that addresses this and the next example, which also uses print unnecessarily.

To answer your last comment rhettinger; the preceding text tells you /why/ one might want to use a staticmethod:

"""
Good candidates for static methods are methods that do not reference the
``self`` variable.

For instance, a statistics package may include a container class for
experimental data.  The class provides normal methods for computing the average,
mean, median, and other descriptive statistics that depend on the data. However,
there may be useful functions which are conceptually related but do not depend
on the data.  For instance, ``erf(x)`` is handy conversion routine that comes up
in statistical work but does not directly depend on a particular dataset.
It can be called either from an object or the class:  ``s.erf(1.5) --> .9332`` or
``Sample.erf(1.5) --> .9332``.

Since staticmethods return the underlying function with no changes, the example
calls are unexciting::
"""

----------
nosy: +carlbordum
versions: +Python 3.6, Python 3.7, Python 3.8

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

From report at bugs.python.org  Mon Mar 18 06:48:05 2019
From: report at bugs.python.org (Julien Palard)
Date: Mon, 18 Mar 2019 10:48:05 +0000
Subject: [docs] [issue36329] use the right python "make -C Doc/ serve"
In-Reply-To: <1552849058.57.0.633692372704.issue36329@roundup.psfhosted.org>
Message-ID: <1552906085.01.0.670435640123.issue36329@roundup.psfhosted.org>


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


New changeset 09a9f1799c8c58f573c50cb2d526422436b8658b by Julien Palard (St?phane Wirtel) in branch 'master':
bpo-36329: Declare the version of Python to use for Tools/scripts/serve.py (#12385)
https://github.com/python/cpython/commit/09a9f1799c8c58f573c50cb2d526422436b8658b


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

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

From report at bugs.python.org  Mon Mar 18 08:23:34 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Mon, 18 Mar 2019 12:23:34 +0000
Subject: [docs] [issue23984] Documentation error: Descriptors
In-Reply-To: <1429245728.01.0.810263114275.issue23984@psf.upfronthosting.co.za>
Message-ID: <1552911814.56.0.171917061234.issue23984@roundup.psfhosted.org>


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

@carlbordum, thank you for the PR, but the original PR already addresses the issues.  In a code review message on that PR (https://github.com/python/cpython/pull/1034#pullrequestreview-32006381), @rhettinger commented on the removal of the print statement in the method call, which was addressed by the creator of that PR.  PR1034 was just waiting for final review and approval.

The difference between this and the print in the classmethod example is that having to two prints in this example resulted in output of:
  >>> E.f(3)
  3
  >>> print(E.f(3))
  3
  None

whereas the classmethod example doesn't have the issue of printing `None`.

I don't think the second PR is necessary.

----------
nosy: +cheryl.sabella
versions:  -Python 3.4, Python 3.5, Python 3.6

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

From report at bugs.python.org  Mon Mar 18 08:40:51 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Mon, 18 Mar 2019 12:40:51 +0000
Subject: [docs] [issue12622] failfast argument to TextTestRunner not
 documented
In-Reply-To: <1311448108.9.0.673600380151.issue12622@psf.upfronthosting.co.za>
Message-ID: <1552912851.5.0.254923735722.issue12622@roundup.psfhosted.org>


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

I agree with @xtreak.  Closing this as a duplicate.

----------
nosy: +cheryl.sabella
resolution:  -> duplicate
stage: needs patch -> resolved
status: open -> closed
superseder:  -> Wrong signature of TextTestRunner's init function

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

From report at bugs.python.org  Mon Mar 18 09:28:17 2019
From: report at bugs.python.org (Larry Hastings)
Date: Mon, 18 Mar 2019 13:28:17 +0000
Subject: [docs] [issue36327] Remove EOLed Py34 from "Status of Python
 branches"
In-Reply-To: <1552834426.21.0.72238975198.issue36327@roundup.psfhosted.org>
Message-ID: <1552915697.48.0.695463893646.issue36327@roundup.psfhosted.org>


Larry Hastings <larry at hastings.org> added the comment:

Python 3.4.10 has not been released yet, and so it hasn't reached EOL yet, so this is jumping the gun a little.  All things in time.

----------

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

From report at bugs.python.org  Mon Mar 18 09:57:39 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Mon, 18 Mar 2019 13:57:39 +0000
Subject: [docs] [issue36345] Deprecate Tools/scripts/serve.py in favour of
 python -m http.server -d
Message-ID: <1552917459.29.0.295748589939.issue36345@roundup.psfhosted.org>


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

The Makefile of Doc/ has a `serve` target. Currently, this one uses `Tools/scripts/serve.py`. But since 3.7, this script could be replaced by `python -m http.server -d directory`.

@mdk and myself thinking we could deprecate `Tools/scripts/serve.py` with a warning and propose to use `-m http.server -d directory`

----------
assignee: docs at python
components: Documentation
messages: 338224
nosy: docs at python, matrixise
priority: normal
severity: normal
status: open
title: Deprecate Tools/scripts/serve.py in favour of python -m http.server -d
versions: Python 3.8

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

From report at bugs.python.org  Mon Mar 18 10:00:38 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Mon, 18 Mar 2019 14:00:38 +0000
Subject: [docs] [issue36345] Deprecate Tools/scripts/serve.py in favour of
 python -m http.server -d
In-Reply-To: <1552917459.29.0.295748589939.issue36345@roundup.psfhosted.org>
Message-ID: <1552917638.7.0.00237947889617.issue36345@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Mon Mar 18 10:14:45 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Mon, 18 Mar 2019 14:14:45 +0000
Subject: [docs] [issue36345] Deprecate Tools/scripts/serve.py in favour of
 python -m http.server -d
In-Reply-To: <1552917459.29.0.295748589939.issue36345@roundup.psfhosted.org>
Message-ID: <1552918485.92.0.528836997753.issue36345@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Mon Mar 18 11:43:07 2019
From: report at bugs.python.org (Julien Palard)
Date: Mon, 18 Mar 2019 15:43:07 +0000
Subject: [docs] [issue35605] backported patch requires new sphinx,
 minimum sphinx version was not bumped
In-Reply-To: <1546016436.32.0.942702382011.issue35605@roundup.psfhosted.org>
Message-ID: <1552923787.81.0.990324650978.issue35605@roundup.psfhosted.org>


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


----------
pull_requests: +12367

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

From a.finch at lancaster.ac.uk  Mon Mar 18 10:26:42 2019
From: a.finch at lancaster.ac.uk (Finch, Alex)
Date: Mon, 18 Mar 2019 14:26:42 +0000
Subject: [docs] ntuple forward reference
Message-ID: <a10fce76-1842-a9fc-ab0f-70167be893ce@lancaster.ac.uk>


 In the Python Tutorial, the  term "tuple" is used a number of times long  before it is defined.  It is defined at 5.3. It is mentioned in 5.1.3 , and 4.7.2 among others. In one case there is a forward reference to where it is defined, but not all. This is rather confusing as tuple is not a common term.


Alex

--
[cid:part1.717B75BB.C866C0B6 at lancaster.ac.uk]
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190318/f656ba85/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: lusignature.png
Type: image/png
Size: 28431 bytes
Desc: lusignature.png
URL: <http://mail.python.org/pipermail/docs/attachments/20190318/f656ba85/attachment-0001.png>

From report at bugs.python.org  Mon Mar 18 11:46:55 2019
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 18 Mar 2019 15:46:55 +0000
Subject: [docs] [issue36345] Deprecate Tools/scripts/serve.py in favour of
 python -m http.server -d
In-Reply-To: <1552917459.29.0.295748589939.issue36345@roundup.psfhosted.org>
Message-ID: <1552924015.65.0.144029029263.issue36345@roundup.psfhosted.org>


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

I'm ok with modifying "make server" to reuse http.server, but I'm not sure about deprecating Tools/scripts/serve.py.

serve.py uses wsgiref which is different than http.server. Does anyone use it? I would prefer to keep it. If you want to remove it, please send an email to python-dev to ask who uses it.


"make serve" has been added by bpo-8004 which added Tools/scripts/serve.py.

commit e4c74e1ea26e77b065a8999b7192160595474211
Author: Dirkjan Ochtman <dirkjan at ochtman.nl>
Date:   Wed Feb 24 04:12:11 2010 +0000

    Issue #8004: add a serve target to the Doc Makefile.

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

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

From report at bugs.python.org  Mon Mar 18 12:53:37 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 18 Mar 2019 16:53:37 +0000
Subject: [docs] [issue36345] Deprecate Tools/scripts/serve.py in favour of
 python -m http.server -d
In-Reply-To: <1552917459.29.0.295748589939.issue36345@roundup.psfhosted.org>
Message-ID: <1552928017.38.0.326112598793.issue36345@roundup.psfhosted.org>


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

I disagree with deprecating serve.py. It is a demo for the wsgiref module.

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

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

From report at bugs.python.org  Mon Mar 18 12:58:20 2019
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 18 Mar 2019 16:58:20 +0000
Subject: [docs] [issue23984] Documentation error: Descriptors
In-Reply-To: <1429245728.01.0.810263114275.issue23984@psf.upfronthosting.co.za>
Message-ID: <1552928300.58.0.139015715964.issue23984@roundup.psfhosted.org>


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

FWIW, I'm in the middle of a major update to this howto add will address this example there.

----------
resolution:  -> postponed

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

From report at bugs.python.org  Mon Mar 18 14:11:34 2019
From: report at bugs.python.org (Julien Palard)
Date: Mon, 18 Mar 2019 18:11:34 +0000
Subject: [docs] [issue35605] backported patch requires new sphinx,
 minimum sphinx version was not bumped
In-Reply-To: <1546016436.32.0.942702382011.issue35605@roundup.psfhosted.org>
Message-ID: <1552932694.21.0.827734968801.issue35605@roundup.psfhosted.org>


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


New changeset 869652b426bb34a30ce7b39f0a0ac242ed5b1016 by Julien Palard in branch '2.7':
[2.7] bpo-35605: Fix documentation build for sphinx<1.6 (GH-12413)
https://github.com/python/cpython/commit/869652b426bb34a30ce7b39f0a0ac242ed5b1016


----------

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

From report at bugs.python.org  Mon Mar 18 14:18:00 2019
From: report at bugs.python.org (Julien Palard)
Date: Mon, 18 Mar 2019 18:18:00 +0000
Subject: [docs] [issue36345] Deprecate Tools/scripts/serve.py in favour of
 python -m http.server -d
In-Reply-To: <1552917459.29.0.295748589939.issue36345@roundup.psfhosted.org>
Message-ID: <1552933080.6.0.212603688049.issue36345@roundup.psfhosted.org>


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

If it's appreciated as a demo for wsgiref, wouldn't it be better to move it inside Doc/library/wsgiref.rst?

It was written specifically for the Doc/Makefile, it's no longer needed for the Doc/Makefile, so the question pops: is it usefull to anyone? If not it's better to drop it (or move it to the documentation as a nice, time-proven example).

----------

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

From report at bugs.python.org  Mon Mar 18 15:18:19 2019
From: report at bugs.python.org (Josh Rosenberg)
Date: Mon, 18 Mar 2019 19:18:19 +0000
Subject: [docs] [issue36355] Remove documentation and internal use of the
 RESTRICTED constants for PyMemberDef's flags field
Message-ID: <1552936699.26.0.01319442845.issue36355@roundup.psfhosted.org>


New submission from Josh Rosenberg <shadowranger+python at gmail.com>:

While looking up background info for #36347, I noticed that the docs for PyMemberDef ( https://docs.python.org/3/extending/newtypes.html#generic-attribute-management ) define the following flags:

* READONLY
* READ_RESTRICTED
* WRITE_RESTRICTED
* RESTRICTED

Of those, WRITE_RESTRICTED has been documented incorrectly since Python 3.0a2 (it got renamed to PY_WRITE_RESTRICTED in structmember.h, apparently due to a name clash with VS 2008 on Windows).

Luckily, the constants are useless; AFAICT they were there solely to support restricted mode (via the rexec and Bastion modules). The modules were apparently disabled in Python 2.3 "due to various known and not readily fixable security holes" ( https://docs.python.org/2/library/restricted.html ), and the modules themselves officially deprecated in 2.6, and removed completely in 3.0.

Rather than fixing up the docs, maybe it's time to kill these constants for good? Probably shouldn't remove the definitions in structmember.h (if someone wrote code using them, we shouldn't needlessly break compilation), but the interpreter and standard library should stop setting them, and the documentation for them should be removed.

----------
assignee: docs at python
components: Documentation, Extension Modules, Interpreter Core
messages: 338282
nosy: docs at python, josh.r
priority: normal
severity: normal
status: open
title: Remove documentation and internal use of the RESTRICTED constants for PyMemberDef's flags field
versions: Python 3.8

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

From report at bugs.python.org  Mon Mar 18 15:20:23 2019
From: report at bugs.python.org (Josh Rosenberg)
Date: Mon, 18 Mar 2019 19:20:23 +0000
Subject: [docs] [issue36355] Remove documentation and internal use of the
 *RESTRICTED constants for PyMemberDef's flags field
In-Reply-To: <1552936699.26.0.01319442845.issue36355@roundup.psfhosted.org>
Message-ID: <1552936823.55.0.491065220553.issue36355@roundup.psfhosted.org>


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

To be clear, only the constants that include the substring RESTRICTED are useless; READONLY remains useful and should not be removed (though per my suggestion on #36347, it might be good to add an alias for it named PY_READONLY to match the Python C API naming conventions).

----------
title: Remove documentation and internal use of the RESTRICTED constants for PyMemberDef's flags field -> Remove documentation and internal use of the *RESTRICTED constants for PyMemberDef's flags field

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

From report at bugs.python.org  Tue Mar 19 03:26:24 2019
From: report at bugs.python.org (Hameer Abbasi)
Date: Tue, 19 Mar 2019 07:26:24 +0000
Subject: [docs] [issue36359] contextvars documentation unclear on
 thread-locality
Message-ID: <1552980384.32.0.0684370672008.issue36359@roundup.psfhosted.org>


New submission from Hameer Abbasi <habbasi at quansight.com>:

The documentation here: https://docs.python.org/3/library/contextvars.html does not mention anything about context-variables being thread-local or not. It should definitely make that more clear.

I was told by Freenode user njs (I strongly suspect its Nathaniel J. Smith) that they are.

----------
assignee: docs at python
components: Documentation
messages: 338322
nosy: Hameer Abbasi2, docs at python, yselivanov
priority: normal
severity: normal
status: open
title: contextvars documentation unclear on thread-locality
type: enhancement
versions: Python 3.7, Python 3.8

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

From report at bugs.python.org  Tue Mar 19 10:21:25 2019
From: report at bugs.python.org (Ma Lin)
Date: Tue, 19 Mar 2019 14:21:25 +0000
Subject: [docs] [issue25361] Is python-3-5-0.exe compiled with SSE2
 instrutions? If so should we mention this?
In-Reply-To: <1444473804.35.0.126289501902.issue25361@psf.upfronthosting.co.za>
Message-ID: <1553005285.31.0.974257259267.issue25361@roundup.psfhosted.org>


Change by Ma Lin <malincns at 163.com>:


----------
pull_requests: +12393

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

From report at bugs.python.org  Tue Mar 19 10:22:18 2019
From: report at bugs.python.org (Ma Lin)
Date: Tue, 19 Mar 2019 14:22:18 +0000
Subject: [docs] [issue25361] Is python-3-5-0.exe compiled with SSE2
 instrutions? If so should we mention this?
In-Reply-To: <1444473804.35.0.126289501902.issue25361@psf.upfronthosting.co.za>
Message-ID: <1553005338.04.0.444527781938.issue25361@roundup.psfhosted.org>


Ma Lin <malincns at 163.com> added the comment:

It seems SSE2 can be re-enabled for 3.8 branch.

> Starting with the March 2018 Windows 7 updates,
> security patches will only install on SSE2 or higher
> computing devices. This change only affects a small #
> of users on 15-20 year old legacy PCs.

https://blogs.msmvps.com/harrywaldron/2018/06/25/windows-7-sse2-compliance-required-for-security-updates/

----------
nosy: +Ma Lin
versions:  -Python 3.5

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

From report at bugs.python.org  Tue Mar 19 10:24:43 2019
From: report at bugs.python.org (Ma Lin)
Date: Tue, 19 Mar 2019 14:24:43 +0000
Subject: [docs] [issue25361] Is python-3-5-0.exe compiled with SSE2
 instrutions? If so should we mention this?
In-Reply-To: <1444473804.35.0.126289501902.issue25361@psf.upfronthosting.co.za>
Message-ID: <1553005483.64.0.491844590926.issue25361@roundup.psfhosted.org>


Change by Ma Lin <malincns at 163.com>:


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

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

From report at bugs.python.org  Tue Mar 19 10:39:57 2019
From: report at bugs.python.org (Pierre Glaser)
Date: Tue, 19 Mar 2019 14:39:57 +0000
Subject: [docs] [issue36364] errors in multiprocessing.shared_memory examples
Message-ID: <1553006397.24.0.439789667635.issue36364@roundup.psfhosted.org>


New submission from Pierre Glaser <pierreglaser at msn.com>:

The examples of the new shared_memory module using SharedMemoryManager try to import the class from multiprocessing.shared_memory instead of multiprocessing.managers, making them fail.

----------
assignee: docs at python
components: Documentation
files: 0001-DOC-fix-SharedMemoryManager-examples.patch
keywords: patch
messages: 338360
nosy: docs at python, pierreglaser
priority: normal
severity: normal
status: open
title: errors in multiprocessing.shared_memory examples
versions: Python 3.8
Added file: https://bugs.python.org/file48221/0001-DOC-fix-SharedMemoryManager-examples.patch

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

From report at bugs.python.org  Tue Mar 19 10:44:24 2019
From: report at bugs.python.org (Pierre Glaser)
Date: Tue, 19 Mar 2019 14:44:24 +0000
Subject: [docs] [issue36364] errors in multiprocessing.shared_memory examples
In-Reply-To: <1553006397.24.0.439789667635.issue36364@roundup.psfhosted.org>
Message-ID: <1553006664.14.0.268975428686.issue36364@roundup.psfhosted.org>


Change by Pierre Glaser <pierreglaser at msn.com>:


----------
pull_requests: +12394
stage:  -> patch review

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

From report at bugs.python.org  Tue Mar 19 11:04:10 2019
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Tue, 19 Mar 2019 15:04:10 +0000
Subject: [docs] [issue36364] errors in multiprocessing.shared_memory examples
In-Reply-To: <1553006397.24.0.439789667635.issue36364@roundup.psfhosted.org>
Message-ID: <1553007850.28.0.961888534106.issue36364@roundup.psfhosted.org>


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


----------
nosy: +davin, pitrou

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

From report at bugs.python.org  Tue Mar 19 14:55:30 2019
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 19 Mar 2019 18:55:30 +0000
Subject: [docs] [issue36345] Deprecate Tools/scripts/serve.py in favour of
 python -m http.server -d
In-Reply-To: <1552917459.29.0.295748589939.issue36345@roundup.psfhosted.org>
Message-ID: <1553021730.29.0.4351901705.issue36345@roundup.psfhosted.org>


Brett Cannon <brett at python.org> added the comment:

I agree that if it's a good example of using wsgiref then it should exist in the wsgiref docs as an example. Then that would mean dropping the script and updating the Makefile.

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

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

From report at bugs.python.org  Tue Mar 19 15:55:35 2019
From: report at bugs.python.org (dtrauma)
Date: Tue, 19 Mar 2019 19:55:35 +0000
Subject: [docs] [issue36373] asyncio.gather: no docs for deprecated loop
 parameter
Message-ID: <1553025335.55.0.640410639085.issue36373@roundup.psfhosted.org>


New submission from dtrauma <python-bugs at digital-trauma.de>:

https://docs.python.org/3.7/library/asyncio-task.html#running-tasks-concurrently

For asyncio.gather, the docs should probably say

The loop argument is deprecated and scheduled for removal in Python 3.10.

as they do for all the other loop arguments of other functions.

----------
assignee: docs at python
components: Documentation
messages: 338406
nosy: docs at python, dtrauma
priority: normal
severity: normal
status: open
title: asyncio.gather: no docs for deprecated loop parameter
type: enhancement
versions: Python 3.7

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

From report at bugs.python.org  Tue Mar 19 20:19:34 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Wed, 20 Mar 2019 00:19:34 +0000
Subject: [docs] [issue26103] Contradiction in definition of "data
 descriptor" between (dotted lookup behavior/datamodel documentation) and
 (inspect lib/descriptor how-to)
In-Reply-To: <1452718612.1.0.925403449689.issue26103@psf.upfronthosting.co.za>
Message-ID: <1553041174.54.0.10375623739.issue26103@roundup.psfhosted.org>


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

It looks like this issue can be closed now that it's merged?

----------
nosy: +cheryl.sabella

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

From report at bugs.python.org  Tue Mar 19 22:30:09 2019
From: report at bugs.python.org (parkito)
Date: Wed, 20 Mar 2019 02:30:09 +0000
Subject: [docs] [issue36377] Python 'datastructures.html' docs page needs
 improvement because of ambiguity
Message-ID: <1553049009.71.0.761140685062.issue36377@roundup.psfhosted.org>


New submission from parkito <shoark7 at gmail.com>:

Hi, I have lots of interests in python data structures and their inheritance relationships so I often look around in python collections and collections.abc module.

```
https://docs.python.org/3/tutorial/datastructures.html#comparing-sequences-and-other-types
```

Please see the last section of the page. I know all Python users are well aware of Sequence comparisons like in tuples and list. This page also mentions that 

'Sequence objects may be compared to other objects with the same sequence type' in the very first line of the page.

However, we have to know that 'range' is also a subclass of 'Sequence' but 'range' objects are not comparable to each other.

I tested 'range(1, 3) < 'range(3)' in my interpreter. If it compares correctly as both are same Sequence types, result would be 'False'. Instead, TypeError was raised. It's because comparision methods(__gt__, __lte__, etc) are not impleneted here. I thought range objects would compare the values with peeking. But they don't. 


So, I recommend you to implement 5.8 section in this page as follows:
  
   -> Please specify that 'not all' Sequence subclass are comparable to the same classes: typically, 'range'.

'range' is a good example because every Python user uses 'range' in for loop.

----------
assignee: docs at python
components: Documentation
hgrepos: 382
messages: 338433
nosy: docs at python, shoark7
priority: normal
severity: normal
status: open
title: Python 'datastructures.html' docs page needs improvement because of ambiguity
type: enhancement
versions: Python 3.7

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

From report at bugs.python.org  Tue Mar 19 22:40:42 2019
From: report at bugs.python.org (parkito)
Date: Wed, 20 Mar 2019 02:40:42 +0000
Subject: [docs] [issue36377] Python 'datastructures.html' docs page needs
 improvement because of ambiguity
In-Reply-To: <1553049009.71.0.761140685062.issue36377@roundup.psfhosted.org>
Message-ID: <1553049642.04.0.0203333220949.issue36377@roundup.psfhosted.org>


parkito <shoark7 at gmail.com> added the comment:

Hi, I have lots of interests in python data structures and their inheritance relationships so I often look around in python collections and collections.abc module.

```
https://docs.python.org/3/tutorial/datastructures.html#comparing-sequences-and-other-types
```

Please see the last section of the page. I know all Python users are well aware of Sequence comparisons like in tuples and list. This page also mentions that 

'Sequence objects may be compared to other objects with the same sequence type' in the very first line of the page.

However, we have to know that 'range' is also a subclass of 'Sequence' but 'range' objects are not comparable to each other.

I tested 'range(1, 3) < 'range(3)' in my interpreter. If it compares correctly as both are same Sequence types, result would be 'False'. Instead, TypeError was raised. It's because comparison methods(__gt__, __lte__, etc) are not impleneted here. I thought range objects would compare the values with peeking. But they don't. 


So, I recommend you to improve 5.8 section as follows:
  
   -> Please specify that 'not all' Sequence subclass are comparable to the same classes: typically, 'range'.

'range' is a good example because every Python user uses 'range' in for loop.

----------

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

From report at bugs.python.org  Tue Mar 19 22:45:36 2019
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Wed, 20 Mar 2019 02:45:36 +0000
Subject: [docs] [issue36377] Python 'datastructures.html' docs page needs
 improvement because of ambiguity
In-Reply-To: <1553049009.71.0.761140685062.issue36377@roundup.psfhosted.org>
Message-ID: <1553049936.69.0.974647163643.issue36377@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Tue Mar 19 22:47:58 2019
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Wed, 20 Mar 2019 02:47:58 +0000
Subject: [docs] [issue36373] asyncio.gather: no docs for deprecated loop
 parameter
In-Reply-To: <1553025335.55.0.640410639085.issue36373@roundup.psfhosted.org>
Message-ID: <1553050078.48.0.405253526669.issue36373@roundup.psfhosted.org>


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


----------
components: +asyncio
nosy: +asvetlov, yselivanov

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

From report at bugs.python.org  Tue Mar 19 22:56:09 2019
From: report at bugs.python.org (miss-islington)
Date: Wed, 20 Mar 2019 02:56:09 +0000
Subject: [docs] [issue23984] Documentation error: Descriptors
In-Reply-To: <1429245728.01.0.810263114275.issue23984@psf.upfronthosting.co.za>
Message-ID: <1553050568.99.0.824046524742.issue23984@roundup.psfhosted.org>


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


New changeset abbdd1fc5c2017683da8d2ed3e8843e8c159bc8c by Miss Islington (bot) (Shubham Aggarwal) in branch 'master':
bpo-23984: Improve descriptor documentation (GH-1034)
https://github.com/python/cpython/commit/abbdd1fc5c2017683da8d2ed3e8843e8c159bc8c


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

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

From report at bugs.python.org  Tue Mar 19 22:56:51 2019
From: report at bugs.python.org (miss-islington)
Date: Wed, 20 Mar 2019 02:56:51 +0000
Subject: [docs] [issue23984] Documentation error: Descriptors
In-Reply-To: <1429245728.01.0.810263114275.issue23984@psf.upfronthosting.co.za>
Message-ID: <1553050611.82.0.973633138125.issue23984@roundup.psfhosted.org>


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


----------
pull_requests: +12412

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

From report at bugs.python.org  Wed Mar 20 03:40:18 2019
From: report at bugs.python.org (Julien Palard)
Date: Wed, 20 Mar 2019 07:40:18 +0000
Subject: [docs] [issue35564] [DOC] Sphinx 2.0 will require master_doc
 variable set in conf.py
In-Reply-To: <1545514198.61.0.0770528567349.issue35564@roundup.psfhosted.org>
Message-ID: <1553067618.98.0.337190250923.issue35564@roundup.psfhosted.org>


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


----------
pull_requests: +12413

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

From report at bugs.python.org  Wed Mar 20 03:43:39 2019
From: report at bugs.python.org (Julien Palard)
Date: Wed, 20 Mar 2019 07:43:39 +0000
Subject: [docs] [issue35564] [DOC] Sphinx 2.0 will require master_doc
 variable set in conf.py
In-Reply-To: <1545514198.61.0.0770528567349.issue35564@roundup.psfhosted.org>
Message-ID: <1553067819.27.0.600248501841.issue35564@roundup.psfhosted.org>


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


----------
pull_requests: +12414

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

From report at bugs.python.org  Wed Mar 20 03:44:40 2019
From: report at bugs.python.org (Julien Palard)
Date: Wed, 20 Mar 2019 07:44:40 +0000
Subject: [docs] [issue35564] [DOC] Sphinx 2.0 will require master_doc
 variable set in conf.py
In-Reply-To: <1545514198.61.0.0770528567349.issue35564@roundup.psfhosted.org>
Message-ID: <1553067880.44.0.351359092052.issue35564@roundup.psfhosted.org>


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


----------
pull_requests: +12415

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

From report at bugs.python.org  Wed Mar 20 05:40:34 2019
From: report at bugs.python.org (Julien Palard)
Date: Wed, 20 Mar 2019 09:40:34 +0000
Subject: [docs] [issue35564] [DOC] Sphinx 2.0 will require master_doc
 variable set in conf.py
In-Reply-To: <1545514198.61.0.0770528567349.issue35564@roundup.psfhosted.org>
Message-ID: <1553074834.4.0.824212833048.issue35564@roundup.psfhosted.org>


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


New changeset 756cfd88920c2349d4546024856c406409b0ab7b by Julien Palard in branch '3.7':
[3.7] bpo-35564: add master_doc='contents' to conf.py (GH-12460)
https://github.com/python/cpython/commit/756cfd88920c2349d4546024856c406409b0ab7b


----------

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

From report at bugs.python.org  Wed Mar 20 05:41:01 2019
From: report at bugs.python.org (Julien Palard)
Date: Wed, 20 Mar 2019 09:41:01 +0000
Subject: [docs] [issue35564] [DOC] Sphinx 2.0 will require master_doc
 variable set in conf.py
In-Reply-To: <1545514198.61.0.0770528567349.issue35564@roundup.psfhosted.org>
Message-ID: <1553074861.73.0.383461489406.issue35564@roundup.psfhosted.org>


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


New changeset 07b8018d75f3d4495708cf1d4175f33b40e13d30 by Julien Palard in branch '2.7':
[2.7] bpo-35564: add master_doc='contents' to conf.py (GH-12462)
https://github.com/python/cpython/commit/07b8018d75f3d4495708cf1d4175f33b40e13d30


----------

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

From report at bugs.python.org  Wed Mar 20 06:15:50 2019
From: report at bugs.python.org (Emmanuel Arias)
Date: Wed, 20 Mar 2019 10:15:50 +0000
Subject: [docs] [issue36373] asyncio.gather: no docs for deprecated loop
 parameter
In-Reply-To: <1553025335.55.0.640410639085.issue36373@roundup.psfhosted.org>
Message-ID: <1553076950.02.0.869357428599.issue36373@roundup.psfhosted.org>


Emmanuel Arias <emmanuelarias30 at gmail.com> added the comment:

Hi,

Reading the asyncio.gather code not seem to be deprecrated.
loop is used on a lot of line of code. 

Maybe, the deprecate idea is on other place where I don't know.

----------
nosy: +eamanu

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

From report at bugs.python.org  Wed Mar 20 06:36:27 2019
From: report at bugs.python.org (Emmanuel Arias)
Date: Wed, 20 Mar 2019 10:36:27 +0000
Subject: [docs] [issue36377] Python 'datastructures.html' docs page needs
 improvement because of ambiguity
In-Reply-To: <1553049009.71.0.761140685062.issue36377@roundup.psfhosted.org>
Message-ID: <1553078187.69.0.189843678815.issue36377@roundup.psfhosted.org>


Change by Emmanuel Arias <emmanuelarias30 at gmail.com>:


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

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

From report at bugs.python.org  Wed Mar 20 06:46:22 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Wed, 20 Mar 2019 10:46:22 +0000
Subject: [docs] [issue36355] Remove documentation and internal use of the
 *RESTRICTED constants for PyMemberDef's flags field
In-Reply-To: <1552936699.26.0.01319442845.issue36355@roundup.psfhosted.org>
Message-ID: <1553078782.93.0.786478415662.issue36355@roundup.psfhosted.org>


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

Josh, I don't know for the uselessness or not of these macros, but these macros are used.

RESTRICTED is used in Objects/classobject.c and Objects/funcobject.c

PY_WRITE_RESTRICTED is used in Objects/funcobject.c and Objects/methodobject.c

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

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

From report at bugs.python.org  Wed Mar 20 11:41:40 2019
From: report at bugs.python.org (Ned Deily)
Date: Wed, 20 Mar 2019 15:41:40 +0000
Subject: [docs] [issue35564] [DOC] Sphinx 2.0 will require master_doc
 variable set in conf.py
In-Reply-To: <1545514198.61.0.0770528567349.issue35564@roundup.psfhosted.org>
Message-ID: <1553096500.01.0.530418706932.issue35564@roundup.psfhosted.org>


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


New changeset 4508bc37dd80c71adfaa0925a67c438389817076 by Ned Deily (Julien Palard) in branch '3.6':
[3.6] bpo-35564: add master_doc='contents' to conf.py (GH-11290). (GH-12461)
https://github.com/python/cpython/commit/4508bc37dd80c71adfaa0925a67c438389817076


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

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

From report at bugs.python.org  Wed Mar 20 13:15:04 2019
From: report at bugs.python.org (Terry J. Reedy)
Date: Wed, 20 Mar 2019 17:15:04 +0000
Subject: [docs] [issue14944] Setup & Usage documentation for pydoc, IDLE,
 & 2to3
In-Reply-To: <1338256058.02.0.10025521772.issue14944@psf.upfronthosting.co.za>
Message-ID: <1553102104.86.0.444577644688.issue14944@roundup.psfhosted.org>


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

idle.html, derived from idle.rst, is now the IDLE help file.

pip also has pip3 command; perhaps ensurepip should be mentioned.

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

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

From report at bugs.python.org  Wed Mar 20 16:16:37 2019
From: report at bugs.python.org (Aaron Hall)
Date: Wed, 20 Mar 2019 20:16:37 +0000
Subject: [docs] [issue26103] Contradiction in definition of "data
 descriptor" between (dotted lookup behavior/datamodel documentation) and
 (inspect lib/descriptor how-to)
In-Reply-To: <1452718612.1.0.925403449689.issue26103@psf.upfronthosting.co.za>
Message-ID: <1553112997.43.0.057696554761.issue26103@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Wed Mar 20 20:24:46 2019
From: report at bugs.python.org (Josh Rosenberg)
Date: Thu, 21 Mar 2019 00:24:46 +0000
Subject: [docs] [issue36355] Remove documentation and internal use of the
 *RESTRICTED constants for PyMemberDef's flags field
In-Reply-To: <1552936699.26.0.01319442845.issue36355@roundup.psfhosted.org>
Message-ID: <1553127886.23.0.0732209646588.issue36355@roundup.psfhosted.org>


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

Yes, they're set. They're never *read* anywhere. My suggestion was to stop setting them (because it gives the impression they do something when reading the docs, when in fact they do nothing), and remove them from the docs.

----------

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

From report at bugs.python.org  Wed Mar 20 20:25:24 2019
From: report at bugs.python.org (Josh Rosenberg)
Date: Thu, 21 Mar 2019 00:25:24 +0000
Subject: [docs] [issue36355] Remove documentation and internal use of the
 *RESTRICTED constants for PyMemberDef's flags field
In-Reply-To: <1552936699.26.0.01319442845.issue36355@roundup.psfhosted.org>
Message-ID: <1553127924.93.0.0276885312293.issue36355@roundup.psfhosted.org>


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

Sorry, that should have been "it gives the impression they do something when reading the *source code*"

----------

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

From report at bugs.python.org  Thu Mar 21 10:22:10 2019
From: report at bugs.python.org (Hanno Boeck)
Date: Thu, 21 Mar 2019 14:22:10 +0000
Subject: [docs] [issue36391] XSS in bugs.python.org 404 error page
Message-ID: <1553178130.9.0.715646132461.issue36391@roundup.psfhosted.org>


New submission from Hanno Boeck <hanno at hboeck.de>:

There's an XSS on the 404 error page:

https://bugs.python.org/%3Cimg%20src=x%20onerror=alert(1)%3E

(For lack of a webpage / bug tracker category I chose "Documentation" as the closest category I could find)

----------
assignee: docs at python
components: Documentation
messages: 338543
nosy: docs at python, hanno
priority: normal
severity: normal
status: open
title: XSS in bugs.python.org 404 error page
type: security

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

From report at bugs.python.org  Thu Mar 21 15:18:21 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 21 Mar 2019 19:18:21 +0000
Subject: [docs] [issue30903] IPv4Network's hostmask attribute doesn't
 returns string value as mentioned in Documentation.
In-Reply-To: <1499776782.68.0.13911603646.issue30903@psf.upfronthosting.co.za>
Message-ID: <1553195901.34.0.491382685663.issue30903@roundup.psfhosted.org>


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

Thank you for the report.  This was fixed as part of PR6021.  There was no bpo ticket for that pull request.

----------
nosy: +cheryl.sabella
resolution:  -> fixed
stage:  -> resolved
status: open -> closed

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

From report at bugs.python.org  Thu Mar 21 15:45:54 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 21 Mar 2019 19:45:54 +0000
Subject: [docs] [issue35528] [DOC] [LaTeX] Sphinx 2.0 uses GNU FreeFont as
 default for xelatex
In-Reply-To: <1545172472.78.0.788709270274.issue35528@psf.upfronthosting.co.za>
Message-ID: <1553197554.07.0.456020114703.issue35528@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Thu Mar 21 15:48:37 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 21 Mar 2019 19:48:37 +0000
Subject: [docs] [issue32142] heapq.heappop - documentation misleading or
 doesn't work
In-Reply-To: <1511712348.11.0.213398074469.issue32142@psf.upfronthosting.co.za>
Message-ID: <1553197717.47.0.808066953895.issue32142@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Thu Mar 21 18:55:58 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 21 Mar 2019 22:55:58 +0000
Subject: [docs] [issue31369] re.RegexFlag is not included in __all__
In-Reply-To: <1504730402.58.0.544251648863.issue31369@psf.upfronthosting.co.za>
Message-ID: <1553208958.38.0.659717771614.issue31369@roundup.psfhosted.org>


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

@ethan.furman, since you had originally added RegexFlag in #28082, do have an opinion on this?  Thanks.

----------
nosy: +cheryl.sabella, ethan.furman
versions: +Python 3.8 -Python 3.6

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

From report at bugs.python.org  Thu Mar 21 19:05:12 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 21 Mar 2019 23:05:12 +0000
Subject: [docs] [issue31470] Py_Initialize documentation wrong
In-Reply-To: <1505406662.03.0.797586512068.issue31470@psf.upfronthosting.co.za>
Message-ID: <1553209512.48.0.46885829291.issue31470@roundup.psfhosted.org>


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

Issue 32124 changed the documentation to define the C functions that are safe to call before Py_Initialize.  I am going to close this with that as a superseder.  Please reopen this if that issue didn't address all the concerns.  Thanks!

----------
nosy: +cheryl.sabella
resolution:  -> duplicate
stage:  -> resolved
status: open -> closed
superseder:  -> Document functions safe to be called before Py_Initialize()

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

From report at bugs.python.org  Thu Mar 21 21:33:57 2019
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Fri, 22 Mar 2019 01:33:57 +0000
Subject: [docs] [issue18249] Incorrect and incomplete help docs for close()
 method
In-Reply-To: <1371516910.55.0.109427807192.issue18249@psf.upfronthosting.co.za>
Message-ID: <1553218437.05.0.850496204893.issue18249@roundup.psfhosted.org>


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

Closing with Victor Stinner's approval.

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

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

From report at bugs.python.org  Thu Mar 21 23:28:12 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 22 Mar 2019 03:28:12 +0000
Subject: [docs] [issue31369] re.RegexFlag is not included in __all__
In-Reply-To: <1504730402.58.0.544251648863.issue31369@psf.upfronthosting.co.za>
Message-ID: <1553225292.51.0.199365272718.issue31369@roundup.psfhosted.org>


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

I concur with David. This is an imlementation detail. No need to prefix it with a _ if the module uses __all__for public names.

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

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

From report at bugs.python.org  Fri Mar 22 04:04:26 2019
From: report at bugs.python.org (Raymond Hettinger)
Date: Fri, 22 Mar 2019 08:04:26 +0000
Subject: [docs] [issue23984] Documentation error: Descriptors
In-Reply-To: <1429245728.01.0.810263114275.issue23984@psf.upfronthosting.co.za>
Message-ID: <1553241866.13.0.156871846026.issue23984@roundup.psfhosted.org>


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


New changeset cb2d71b28e5cac04bbd59b8b6dbec220c4da7beb by Raymond Hettinger (Miss Islington (bot)) in branch '3.7':
bpo-23984: Improve descriptor documentation (GH-1034) (GH-12459)
https://github.com/python/cpython/commit/cb2d71b28e5cac04bbd59b8b6dbec220c4da7beb


----------

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

From bjartur at adversary.io  Fri Mar 22 10:25:28 2019
From: bjartur at adversary.io (Bjartur Thorlacius)
Date: Fri, 22 Mar 2019 14:25:28 +0000
Subject: [docs] Please document sqlite3 return values
Message-ID: <fb1961fa-5ca6-cbd7-1f0e-4c3a1885d683@adversary.io>

Dear Python 3 documentation team.

The documentation for Python 3.7.3rc1 and 3.6.8 describes the 
sqlite3.Cursor.fetchone as follows:

|fetchone|()? 
<https://docs.python.org/3/library/sqlite3.html#sqlite3.Cursor.fetchone>

    Fetches the next row of a query result set, returning a single
    sequence, or None when no more data is available.

However, when I use the Python 3.7 from the public Docker image 
2afe3d389ba0, fetchone seems to return (0,) when no row matches the 
query. Confusingly, fetchmany and fetchall are only documented as 
returnig "a list". A more specific type declaration or description of 
the hierarchical return type would be appreciated.

Best regards,
Bjartur Thorlacius

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190322/dff9cad5/attachment.html>

From report at bugs.python.org  Fri Mar 22 14:56:36 2019
From: report at bugs.python.org (Julien Palard)
Date: Fri, 22 Mar 2019 18:56:36 +0000
Subject: [docs] [issue35528] [DOC] [LaTeX] Sphinx 2.0 uses GNU FreeFont as
 default for xelatex
In-Reply-To: <1545172472.78.0.788709270274.issue35528@psf.upfronthosting.co.za>
Message-ID: <1553280996.86.0.354124468168.issue35528@roundup.psfhosted.org>


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

Thanks a lot for the heads up jfbu!

Opened a PR here: https://github.com/python/psf-salt/pull/167

----------

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

From report at bugs.python.org  Fri Mar 22 14:56:53 2019
From: report at bugs.python.org (Julien Palard)
Date: Fri, 22 Mar 2019 18:56:53 +0000
Subject: [docs] [issue35528] [DOC] [LaTeX] Sphinx 2.0 uses GNU FreeFont as
 default for xelatex
In-Reply-To: <1545172472.78.0.788709270274.issue35528@psf.upfronthosting.co.za>
Message-ID: <1553281013.44.0.0576344039949.issue35528@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Fri Mar 22 17:49:57 2019
From: report at bugs.python.org (miss-islington)
Date: Fri, 22 Mar 2019 21:49:57 +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: <1553291397.4.0.355243810455.issue35155@roundup.psfhosted.org>


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


New changeset dd7c4ceed90792f711347024852d4cf883a9ab9e by Miss Islington (bot) (Denton Liu) in branch 'master':
bpo-35155: clarify protocol handler method naming (GH-10313)
https://github.com/python/cpython/commit/dd7c4ceed90792f711347024852d4cf883a9ab9e


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

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

From report at bugs.python.org  Fri Mar 22 18:51:32 2019
From: report at bugs.python.org (Denton Liu)
Date: Fri, 22 Mar 2019 22:51:32 +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: <1553295092.36.0.953258005398.issue35155@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Fri Mar 22 19:24:14 2019
From: report at bugs.python.org (Senthil Kumaran)
Date: Fri, 22 Mar 2019 23:24:14 +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: <1553297054.2.0.436389495137.issue35155@roundup.psfhosted.org>


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

We could backport this to older versions too. This documentation change is helpful, and backporting this will help with future backport patches against these files.

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

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

From report at bugs.python.org  Fri Mar 22 19:24:36 2019
From: report at bugs.python.org (miss-islington)
Date: Fri, 22 Mar 2019 23:24:36 +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: <1553297076.71.0.4872561619.issue35155@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Fri Mar 22 19:24:47 2019
From: report at bugs.python.org (miss-islington)
Date: Fri, 22 Mar 2019 23:24: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: <1553297087.13.0.533726894265.issue35155@roundup.psfhosted.org>


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


----------
pull_requests: +12452

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

From report at bugs.python.org  Fri Mar 22 19:30:07 2019
From: report at bugs.python.org (miss-islington)
Date: Fri, 22 Mar 2019 23:30:07 +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: <1553297407.0.0.530217808729.issue35155@roundup.psfhosted.org>


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


New changeset 868581ee7687ad25af70c0cb9cd6a0f2077e6422 by Miss Islington (bot) in branch '3.7':
bpo-35155: clarify protocol handler method naming (GH-10313)
https://github.com/python/cpython/commit/868581ee7687ad25af70c0cb9cd6a0f2077e6422


----------

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

From report at bugs.python.org  Fri Mar 22 20:16:53 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Sat, 23 Mar 2019 00:16:53 +0000
Subject: [docs] [issue36345] Deprecate Tools/scripts/serve.py in favour of
 python -m http.server -d
In-Reply-To: <1552917459.29.0.295748589939.issue36345@roundup.psfhosted.org>
Message-ID: <1553300213.31.0.456921746608.issue36345@roundup.psfhosted.org>


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

Hi @mdk and @brett

with your suggestions, I will move the serve.py in the documentation of wsgiref and change Doc/Makefile.

----------

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

From report at bugs.python.org  Fri Mar 22 20:17:59 2019
From: report at bugs.python.org (Martin Panter)
Date: Sat, 23 Mar 2019 00:17:59 +0000
Subject: [docs] [issue27464] Document that SplitResult & friends are
 namedtuples
In-Reply-To: <1467934956.52.0.328129985005.issue27464@psf.upfronthosting.co.za>
Message-ID: <1553300279.74.0.987086126674.issue27464@roundup.psfhosted.org>


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

Suggest merging this with Issue 31822, which seems to have more progress, and where Raymond also seems to be involed.

----------
resolution:  -> duplicate
stage: needs patch -> resolved
status: open -> closed
superseder:  -> Document that urllib.parse.{Defrag,Split,Parse}Result are namedtuples

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

From report at bugs.python.org  Fri Mar 22 20:53:20 2019
From: report at bugs.python.org (Martin Panter)
Date: Sat, 23 Mar 2019 00:53:20 +0000
Subject: [docs] [issue33319] `subprocess.run` documentation doesn't tell is
 using `stdout=PIPE` safe
In-Reply-To: <1524229514.84.0.682650639539.issue33319@psf.upfronthosting.co.za>
Message-ID: <1553302400.77.0.246231614541.issue33319@roundup.psfhosted.org>


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

This is a regression in the 3.7+ documentation. It previously said ?To [capture output], pass PIPE for the ?stdout? and/or ?stderr? arguments?. This was removed by Bo Bayles in Issue 32102.

----------
keywords: +3.7regression
nosy: +bbayles, gregory.p.smith, martin.panter
stage:  -> needs patch
versions: +Python 3.7, Python 3.8, Python 3.9

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

From report at bugs.python.org  Fri Mar 22 21:01:14 2019
From: report at bugs.python.org (STINNER Victor)
Date: Sat, 23 Mar 2019 01:01:14 +0000
Subject: [docs] [issue36345] Deprecate Tools/scripts/serve.py in favour of
 python -m http.server -d
In-Reply-To: <1552917459.29.0.295748589939.issue36345@roundup.psfhosted.org>
Message-ID: <1553302874.48.0.339358626855.issue36345@roundup.psfhosted.org>


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

> with your suggestions, I will move the serve.py in the documentation of wsgiref and change Doc/Makefile.

I suggest to write two separated PRs for each change.

----------

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

From report at bugs.python.org  Fri Mar 22 22:05:15 2019
From: report at bugs.python.org (Inada Naoki)
Date: Sat, 23 Mar 2019 02:05:15 +0000
Subject: [docs] [issue36404] Document PendingDeprecationWarning as deprecated
Message-ID: <1553306715.63.0.145913567045.issue36404@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Fri Mar 22 22:06:28 2019
From: report at bugs.python.org (Inada Naoki)
Date: Sat, 23 Mar 2019 02:06:28 +0000
Subject: [docs] [issue36404] Document PendingDeprecationWarning as deprecated
Message-ID: <1553306788.63.0.361150564179.issue36404@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Sat Mar 23 01:53:26 2019
From: report at bugs.python.org (Fred L. Drake, Jr.)
Date: Sat, 23 Mar 2019 05:53:26 +0000
Subject: [docs] [issue31822] Document that urllib.parse.{Defrag, Split,
 Parse}Result are namedtuples
In-Reply-To: <1508439273.05.0.213398074469.issue31822@psf.upfronthosting.co.za>
Message-ID: <1553320406.17.0.942938305349.issue31822@roundup.psfhosted.org>


Fred L. Drake, Jr. <fdrake at gmail.com> added the comment:

Unfortunately, when the implementation was migrated to use collections.namedtuple (a benefit), the _replace method wasn't extended to support the additional computed addresses for these types.

That would really be useful.

----------
nosy: +fdrake

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

From report at bugs.python.org  Sat Mar 23 01:59:29 2019
From: report at bugs.python.org (Fred L. Drake, Jr.)
Date: Sat, 23 Mar 2019 05:59:29 +0000
Subject: [docs] [issue31822] Document that urllib.parse.{Defrag, Split,
 Parse}Result are namedtuples
In-Reply-To: <1508439273.05.0.213398074469.issue31822@psf.upfronthosting.co.za>
Message-ID: <1553320769.37.0.477633780568.issue31822@roundup.psfhosted.org>


Fred L. Drake, Jr. <fdrake at gmail.com> added the comment:

To clarify: I'm not suggesting that an API expansion should be considered as part of this issue.

----------

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

From report at bugs.python.org  Sat Mar 23 03:25:47 2019
From: report at bugs.python.org (Gregory P. Smith)
Date: Sat, 23 Mar 2019 07:25:47 +0000
Subject: [docs] [issue33319] `subprocess.run` documentation doesn't tell is
 using `stdout=PIPE` safe
In-Reply-To: <1524229514.84.0.682650639539.issue33319@psf.upfronthosting.co.za>
Message-ID: <1553325947.28.0.891966109599.issue33319@roundup.psfhosted.org>


Change by Gregory P. Smith <greg at krypto.org>:


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

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

From report at bugs.python.org  Sat Mar 23 03:40:33 2019
From: report at bugs.python.org (Gregory P. Smith)
Date: Sat, 23 Mar 2019 07:40:33 +0000
Subject: [docs] [issue33319] `subprocess.run` documentation doesn't tell is
 using `stdout=PIPE` safe
In-Reply-To: <1524229514.84.0.682650639539.issue33319@psf.upfronthosting.co.za>
Message-ID: <1553326833.0.0.501939822172.issue33319@roundup.psfhosted.org>


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


New changeset 7a2e84c3488cfd6c108c6b41ff040825f1757566 by Gregory P. Smith in branch 'master':
bpo-33319: Clarify subprocess call docs. (GH-12508)
https://github.com/python/cpython/commit/7a2e84c3488cfd6c108c6b41ff040825f1757566


----------

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

From report at bugs.python.org  Sat Mar 23 03:40:47 2019
From: report at bugs.python.org (miss-islington)
Date: Sat, 23 Mar 2019 07:40:47 +0000
Subject: [docs] [issue33319] `subprocess.run` documentation doesn't tell is
 using `stdout=PIPE` safe
In-Reply-To: <1524229514.84.0.682650639539.issue33319@psf.upfronthosting.co.za>
Message-ID: <1553326847.49.0.960154899663.issue33319@roundup.psfhosted.org>


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


----------
pull_requests: +12460

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

From report at bugs.python.org  Sat Mar 23 03:46:18 2019
From: report at bugs.python.org (miss-islington)
Date: Sat, 23 Mar 2019 07:46:18 +0000
Subject: [docs] [issue33319] `subprocess.run` documentation doesn't tell is
 using `stdout=PIPE` safe
In-Reply-To: <1524229514.84.0.682650639539.issue33319@psf.upfronthosting.co.za>
Message-ID: <1553327177.99.0.754993266482.issue33319@roundup.psfhosted.org>


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


New changeset 9cdac5ced68f1d6ef5e1eee7552bb200b46adc23 by Miss Islington (bot) in branch '3.7':
bpo-33319: Clarify subprocess call docs. (GH-12508)
https://github.com/python/cpython/commit/9cdac5ced68f1d6ef5e1eee7552bb200b46adc23


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

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

From report at bugs.python.org  Sat Mar 23 03:51:13 2019
From: report at bugs.python.org (Gregory P. Smith)
Date: Sat, 23 Mar 2019 07:51:13 +0000
Subject: [docs] [issue33319] `subprocess.run` documentation doesn't tell is
 using `stdout=PIPE` safe
In-Reply-To: <1524229514.84.0.682650639539.issue33319@psf.upfronthosting.co.za>
Message-ID: <1553327473.3.0.719808745506.issue33319@roundup.psfhosted.org>


Change by Gregory P. Smith <greg at krypto.org>:


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

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

From report at bugs.python.org  Sat Mar 23 05:22:33 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Sat, 23 Mar 2019 09:22:33 +0000
Subject: [docs] [issue36345] Deprecate Tools/scripts/serve.py in favour of
 python -m http.server -d
In-Reply-To: <1552917459.29.0.295748589939.issue36345@roundup.psfhosted.org>
Message-ID: <1553332953.63.0.845228242995.issue36345@roundup.psfhosted.org>


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


----------
pull_requests: +12462

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

From report at bugs.python.org  Sat Mar 23 06:10:58 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Sat, 23 Mar 2019 10:10:58 +0000
Subject: [docs] [issue36345] Deprecate Tools/scripts/serve.py in favour of
 python -m http.server -d
In-Reply-To: <1552917459.29.0.295748589939.issue36345@roundup.psfhosted.org>
Message-ID: <1553335858.26.0.291223968777.issue36345@roundup.psfhosted.org>


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

@vstinner

I propose two PRs.

The first one will remove the Tools/scripts/serve.py file and update the Makefile.

The second and independent PR just add a new example in the documentation of wsgiref, the example is based on Tools/scripts/serve.py

----------

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

From report at bugs.python.org  Sat Mar 23 06:47:04 2019
From: report at bugs.python.org (Julien Palard)
Date: Sat, 23 Mar 2019 10:47:04 +0000
Subject: [docs] [issue35528] [DOC] [LaTeX] Sphinx 2.0 uses GNU FreeFont as
 default for xelatex
In-Reply-To: <1545172472.78.0.788709270274.issue35528@psf.upfronthosting.co.za>
Message-ID: <1553338024.19.0.516713728913.issue35528@roundup.psfhosted.org>


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/issue35528>
_______________________________________

From report at bugs.python.org  Sat Mar 23 07:07:40 2019
From: report at bugs.python.org (STINNER Victor)
Date: Sat, 23 Mar 2019 11:07:40 +0000
Subject: [docs] [issue36345] Deprecate Tools/scripts/serve.py in favour of
 python -m http.server -d
In-Reply-To: <1553335858.26.0.291223968777.issue36345@roundup.psfhosted.org>
Message-ID: <CA+3bQGEHKvzJxpD_CNSOCX1ZUT0hCTgrc_j6YfzjzW40suj=Tw@mail.gmail.com>


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

I would remove to move the script into the doc in 1 PR and just modify
Makefile in the other one. So the Makefile can be updated first.

----------

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

From report at bugs.python.org  Sat Mar 23 07:09:16 2019
From: report at bugs.python.org (STINNER Victor)
Date: Sat, 23 Mar 2019 11:09:16 +0000
Subject: [docs] [issue36345] Deprecate Tools/scripts/serve.py in favour of
 python -m http.server -d
In-Reply-To: <CA+3bQGEHKvzJxpD_CNSOCX1ZUT0hCTgrc_j6YfzjzW40suj=Tw@mail.gmail.com>
Message-ID: <CA+3bQGER6tRnis4ErNdE887dhcrHf=-Aug38MKQM7bMf1N7FBQ@mail.gmail.com>


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

Maybe others prefer to do both changes at once. I don't know.

----------

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

From report at bugs.python.org  Sat Mar 23 12:53:58 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Sat, 23 Mar 2019 16:53:58 +0000
Subject: [docs] [issue13828] Further improve casefold documentation
In-Reply-To: <1326992763.46.0.576190503242.issue13828@psf.upfronthosting.co.za>
Message-ID: <1553360038.0.0.121277147421.issue13828@roundup.psfhosted.org>


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

Assigning to @Mariatta for the sprints.

----------
assignee: docs at python -> Mariatta
nosy: +Mariatta, cheryl.sabella
stage:  -> needs patch
versions: +Python 3.7, Python 3.8 -Python 3.3

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

From report at bugs.python.org  Sat Mar 23 15:31:31 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Sat, 23 Mar 2019 19:31:31 +0000
Subject: [docs] =?utf-8?q?=5Bissue11644=5D_Cross-link_2to3_documentation?=
 =?utf-8?q?=2C_what=E2=80=99s_new_and_pyporting_howto?=
In-Reply-To: <1300838396.67.0.863213339568.issue11644@psf.upfronthosting.co.za>
Message-ID: <1553369491.49.0.317860927556.issue11644@roundup.psfhosted.org>


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

Since the HOWTO for Porting from 2 to 3 was created in February 2011, there have been many updates over time to improve that document.  It seems to me that it is thorough in its explanation, including the suggestion of upgrading to 2.7 before converting to Python 3.  As such, I believe this issue can be closed, but wanted to make sure others agreed before I changed the status.  Thanks!

https://docs.python.org/3.7/howto/pyporting.html

----------
nosy: +cheryl.sabella

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

From report at bugs.python.org  Sat Mar 23 15:33:09 2019
From: report at bugs.python.org (Eric V. Smith)
Date: Sat, 23 Mar 2019 19:33:09 +0000
Subject: [docs] =?utf-8?q?=5Bissue11644=5D_Cross-link_2to3_documentation?=
 =?utf-8?q?=2C_what=E2=80=99s_new_and_pyporting_howto?=
In-Reply-To: <1300838396.67.0.863213339568.issue11644@psf.upfronthosting.co.za>
Message-ID: <1553369589.05.0.414863557755.issue11644@roundup.psfhosted.org>


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

I agree we should close this.

----------

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

From report at bugs.python.org  Sat Mar 23 16:15:07 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Sat, 23 Mar 2019 20:15:07 +0000
Subject: [docs] =?utf-8?q?=5Bissue11644=5D_Cross-link_2to3_documentation?=
 =?utf-8?q?=2C_what=E2=80=99s_new_and_pyporting_howto?=
In-Reply-To: <1300838396.67.0.863213339568.issue11644@psf.upfronthosting.co.za>
Message-ID: <1553372107.65.0.897782447917.issue11644@roundup.psfhosted.org>


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

Thanks, Eric!

----------
resolution:  -> out of date
stage: needs patch -> resolved
status: open -> closed

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

From report at bugs.python.org  Sun Mar 24 01:06:03 2019
From: report at bugs.python.org (YasirA)
Date: Sun, 24 Mar 2019 05:06:03 +0000
Subject: [docs] =?utf-8?q?=5Bissue36413=5D_Brief_Tour_of_the_Standard_Lib?=
 =?utf-8?q?rary_=E2=80=94_Part_II_example_problem?=
Message-ID: <1553403963.41.0.192009865496.issue36413@roundup.psfhosted.org>


New submission from YasirA <yarsanukaev at gmail.com>:

In the Template example, there's no placeholder to be substituted with date. I think it should be rewritten along the following lines:

    >>> import time, os.path
    >>> photofiles = ['img_1074.jpg', 'img_1076.jpg', 'img_1077.jpg']
    >>> class BatchRename(Template):
    ...     delimiter = '%'
    >>> fmt = input('Enter rename style (%d-date %n-seqnum %f-format):  ')
    Enter rename style (%d-date %n-seqnum %f-format):  Ashley_%d%n%f

    >>> t = BatchRename(fmt)
    >>> date = time.strftime('%d%b%y')
    >>> for i, filename in enumerate(photofiles):
    ...     base, ext = os.path.splitext(filename)
    ...     newname = t.substitute(d=date+'_', n=i, f=ext)
    ...     print('{0} --> {1}'.format(filename, newname))

    img_1074.jpg --> Ashley_0.jpg
    img_1076.jpg --> Ashley_1.jpg
    img_1077.jpg --> Ashley_2.jpg

Yasir.

----------
assignee: docs at python
components: Documentation
messages: 338714
nosy: YasirA, docs at python
priority: normal
severity: normal
status: open
title: Brief Tour of the Standard Library ? Part II example problem
versions: Python 3.7

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

From report at bugs.python.org  Sun Mar 24 01:45:17 2019
From: report at bugs.python.org (Raymond Hettinger)
Date: Sun, 24 Mar 2019 05:45:17 +0000
Subject: [docs] =?utf-8?q?=5Bissue36413=5D_Brief_Tour_of_the_Standard_Lib?=
 =?utf-8?q?rary_=E2=80=94_Part_II_example_problem?=
In-Reply-To: <1553403963.41.0.192009865496.issue36413@roundup.psfhosted.org>
Message-ID: <1553406317.26.0.374148991291.issue36413@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Sun Mar 24 01:51:39 2019
From: report at bugs.python.org (Raymond Hettinger)
Date: Sun, 24 Mar 2019 05:51:39 +0000
Subject: [docs] =?utf-8?q?=5Bissue36413=5D_Brief_Tour_of_the_Standard_Lib?=
 =?utf-8?q?rary_=E2=80=94_Part_II_example_problem?=
In-Reply-To: <1553403963.41.0.192009865496.issue36413@roundup.psfhosted.org>
Message-ID: <1553406699.41.0.11825960934.issue36413@roundup.psfhosted.org>


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

Thank you for the suggestion, but the point of having the input() is that the end user can select their own rename style with arbitrary text and either including or excluding possible data substitutions of their own choice.

The photo processing software I was using at the time I wrote the example works just like this.

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

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

From report at bugs.python.org  Sun Mar 24 02:00:34 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Sun, 24 Mar 2019 06:00:34 +0000
Subject: [docs] [issue13850] Summary tables for argparse add_argument options
In-Reply-To: <1327384498.23.0.981832544617.issue13850@psf.upfronthosting.co.za>
Message-ID: <1553407234.49.0.217455790735.issue13850@roundup.psfhosted.org>


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

I close my PR, if anyone wants to submit an other PR, feel free to do it.

----------

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

From report at bugs.python.org  Sun Mar 24 08:29:44 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Sun, 24 Mar 2019 12:29:44 +0000
Subject: [docs] [issue36345] Deprecate Tools/scripts/serve.py in favour of
 python -m http.server -d
In-Reply-To: <1552917459.29.0.295748589939.issue36345@roundup.psfhosted.org>
Message-ID: <1553430584.62.0.118014947398.issue36345@roundup.psfhosted.org>


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


----------
pull_requests: +12473

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

From report at bugs.python.org  Sun Mar 24 10:23:47 2019
From: report at bugs.python.org (PEW's Corner)
Date: Sun, 24 Mar 2019 14:23:47 +0000
Subject: [docs] [issue36416] bytes.rpartition bug in online documentation
Message-ID: <1553437427.15.0.469399643284.issue36416@roundup.psfhosted.org>


New submission from PEW's Corner <pewscorner at gmail.com>:

The online Python 3 documentation for bytes.rpartition and bytearray.rpartition (https://docs.python.org/3/library/stdtypes.html#bytes.rpartition) incorrectly states:

"If the separator is not found, return a 3-tuple containing a copy of the original sequence, followed by two empty bytes or bytearray objects."

This seems to have been copied without modification from bytes.partition where the statement is correct. The statement for rpartition should be:

"If the separator is not found, return a 3-tuple containing two empty bytes or bytearray objects, followed by a copy of the original sequence."

----------
assignee: docs at python
components: Documentation
messages: 338734
nosy: docs at python, pewscorner
priority: normal
severity: normal
status: open
title: bytes.rpartition bug in online documentation
type: behavior
versions: Python 3.7

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

From report at bugs.python.org  Sun Mar 24 10:46:58 2019
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Sun, 24 Mar 2019 14:46:58 +0000
Subject: [docs] [issue36416] bytes.rpartition bug in online documentation
In-Reply-To: <1553437427.15.0.469399643284.issue36416@roundup.psfhosted.org>
Message-ID: <1553438818.21.0.768022401489.issue36416@roundup.psfhosted.org>


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

Thanks for the report. Would you like to create a PR for this?

The test for this behavior is at https://github.com/python/cpython/blob/3d07c1ee1d2d475b74816117981d6ec752c26c23/Lib/test/test_bytes.py#L655
Doc file to be changed : https://github.com/python/cpython/blob/master/Doc/library/stdtypes.rst

----------
nosy: +xtreak
versions: +Python 3.8

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

From report at bugs.python.org  Sun Mar 24 10:47:13 2019
From: report at bugs.python.org (PEW's Corner)
Date: Sun, 24 Mar 2019 14:47:13 +0000
Subject: [docs] [issue36417] unicode.isdecimal bug in online Python 2
 documentation
Message-ID: <1553438833.3.0.95385374587.issue36417@roundup.psfhosted.org>


New submission from PEW's Corner <pewscorner at gmail.com>:

The online Python 2 documentation for unicode.isdecimal (https://docs.python.org/2/library/stdtypes.html#unicode.isdecimal) incorrectly states:

"Decimal characters include digit characters".

This is wrong (decimal characters are actually a subset of digit characters), and u'\u00b3' is an example of a character that is a digit but not a decimal.

Issue 26483 (https://bugs.python.org/issue26483) corrected the same bug in the Python 3 documentation, and a similar correction should be applied to the Python 2 documentation.

----------
assignee: docs at python
components: Documentation
messages: 338736
nosy: docs at python, pewscorner
priority: normal
severity: normal
status: open
title: unicode.isdecimal bug in online Python 2 documentation
type: behavior
versions: Python 2.7

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

From report at bugs.python.org  Sun Mar 24 11:14:18 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 24 Mar 2019 15:14:18 +0000
Subject: [docs] [issue36416] bytes.rpartition bug in online documentation
In-Reply-To: <1553437427.15.0.469399643284.issue36416@roundup.psfhosted.org>
Message-ID: <1553440458.83.0.0778553168428.issue36416@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Sun Mar 24 11:15:10 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 24 Mar 2019 15:15:10 +0000
Subject: [docs] [issue36417] unicode.isdecimal bug in online Python 2
 documentation
In-Reply-To: <1553438833.3.0.95385374587.issue36417@roundup.psfhosted.org>
Message-ID: <1553440510.37.0.243758025609.issue36417@roundup.psfhosted.org>


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


----------
keywords: +easy
stage:  -> needs patch

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

From report at bugs.python.org  Sun Mar 24 12:25:16 2019
From: report at bugs.python.org (Ned Deily)
Date: Sun, 24 Mar 2019 16:25:16 +0000
Subject: [docs] [issue36345] Deprecate Tools/scripts/serve.py in favour of
 python -m http.server -d
In-Reply-To: <1552917459.29.0.295748589939.issue36345@roundup.psfhosted.org>
Message-ID: <1553444716.84.0.547323082206.issue36345@roundup.psfhosted.org>


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

The files in the Tools directory are installed on user systems by various distributions: for example, in Debian, as part of the python3.x-examples package and by the macOS python.org installer.  If you move serve.py, it will no longer be available to end users there.  I don't think there is any benefit to removing the file in Tools/scripts and there is some downside; let's leave it there.

https://packages.debian.org/sid/all/python3.7-examples/filelist

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

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

From report at bugs.python.org  Sun Mar 24 12:26:19 2019
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Sun, 24 Mar 2019 16:26:19 +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: <1553444779.31.0.987096566109.issue33130@roundup.psfhosted.org>


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

The original report for documentation seems to have been fixed with https://github.com/python/cpython/pull/9634 and the linked PR is closed with no changes to be merged. So I would propose closing if this was only with respect to changing documentation and not docstring. As an additional note issue32321 added a python fallback implementation of functools.reduce that uses the same docstring like the C implementation. 

Thanks @vreuter for the report.

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

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

From report at bugs.python.org  Sun Mar 24 12:29:16 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Sun, 24 Mar 2019 16:29:16 +0000
Subject: [docs] [issue36345] Deprecate Tools/scripts/serve.py in favour of
 python -m http.server -d
In-Reply-To: <1553444716.84.0.547323082206.issue36345@roundup.psfhosted.org>
Message-ID: <9D03BC3D-105F-4A11-A9C4-E5E21F11B605@wirtel.be>


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

Hi Ned,

There are 3 PRs, part-0, part-1 and part-2

We can ignore the part-1, this one remove serve.py and the two others are independent.

----------

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

From report at bugs.python.org  Sun Mar 24 14:41:10 2019
From: report at bugs.python.org (Ned Deily)
Date: Sun, 24 Mar 2019 18:41:10 +0000
Subject: [docs] [issue36345] Deprecate Tools/scripts/serve.py in favour of
 python -m http.server -d
In-Reply-To: <1552917459.29.0.295748589939.issue36345@roundup.psfhosted.org>
Message-ID: <1553452870.73.0.0105084484743.issue36345@roundup.psfhosted.org>


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

Just dropping part-1 is fine with me, thanks.

----------

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

From report at bugs.python.org  Sun Mar 24 15:56:41 2019
From: report at bugs.python.org (PEW's Corner)
Date: Sun, 24 Mar 2019 19:56:41 +0000
Subject: [docs] [issue36416] bytes.rpartition bug in online documentation
In-Reply-To: <1553437427.15.0.469399643284.issue36416@roundup.psfhosted.org>
Message-ID: <1553457401.54.0.812732521412.issue36416@roundup.psfhosted.org>


PEW's Corner <pewscorner at gmail.com> added the comment:

OK, I can give it a try. I need to read up on the procedures for doing so, first, though, so it may take a while.

----------

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

From report at bugs.python.org  Sun Mar 24 16:08:49 2019
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Sun, 24 Mar 2019 20:08:49 +0000
Subject: [docs] [issue36416] bytes.rpartition bug in online documentation
In-Reply-To: <1553437427.15.0.469399643284.issue36416@roundup.psfhosted.org>
Message-ID: <1553458129.3.0.0955271807161.issue36416@roundup.psfhosted.org>


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

You can find more information about the process at https://devguide.python.org/

----------

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

From report at bugs.python.org  Sun Mar 24 17:28:51 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 24 Mar 2019 21:28:51 +0000
Subject: [docs] [issue31822] Document that urllib.parse.{Defrag, Split,
 Parse}Result are namedtuples
In-Reply-To: <1508439273.05.0.213398074469.issue31822@psf.upfronthosting.co.za>
Message-ID: <1553462931.07.0.818840367591.issue31822@roundup.psfhosted.org>


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


New changeset 13c1f72cd1d91fdc2654f2f57356b2eacb75f164 by Cheryl Sabella (Lisa Roach) in branch 'master':
bpo-31822: Document that urllib.parse.{Defrag,Split,Parse}Result are namedtuples (GH-4434)
https://github.com/python/cpython/commit/13c1f72cd1d91fdc2654f2f57356b2eacb75f164


----------
nosy: +cheryl.sabella

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

From report at bugs.python.org  Sun Mar 24 17:50:54 2019
From: report at bugs.python.org (miss-islington)
Date: Sun, 24 Mar 2019 21:50:54 +0000
Subject: [docs] [issue31822] Document that urllib.parse.{Defrag, Split,
 Parse}Result are namedtuples
In-Reply-To: <1508439273.05.0.213398074469.issue31822@psf.upfronthosting.co.za>
Message-ID: <1553464254.13.0.689907447822.issue31822@roundup.psfhosted.org>


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


----------
pull_requests: +12479

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

From report at bugs.python.org  Sun Mar 24 17:56:31 2019
From: report at bugs.python.org (miss-islington)
Date: Sun, 24 Mar 2019 21:56:31 +0000
Subject: [docs] [issue31822] Document that urllib.parse.{Defrag, Split,
 Parse}Result are namedtuples
In-Reply-To: <1508439273.05.0.213398074469.issue31822@psf.upfronthosting.co.za>
Message-ID: <1553464591.08.0.461859634996.issue31822@roundup.psfhosted.org>


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


New changeset fc0010236341a32db7a3703f21e0bddbb36103dd by Miss Islington (bot) in branch '3.7':
bpo-31822: Document that urllib.parse.{Defrag,Split,Parse}Result are namedtuples (GH-4434)
https://github.com/python/cpython/commit/fc0010236341a32db7a3703f21e0bddbb36103dd


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

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

From report at bugs.python.org  Sun Mar 24 18:07:59 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 24 Mar 2019 22:07:59 +0000
Subject: [docs] [issue31822] Document that urllib.parse.{Defrag, Split,
 Parse}Result are namedtuples
In-Reply-To: <1508439273.05.0.213398074469.issue31822@psf.upfronthosting.co.za>
Message-ID: <1553465279.81.0.147588681786.issue31822@roundup.psfhosted.org>


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

Thanks @Allen Li for the initial report, @lisroach for the PR, and @eric.araujo for the review.

Issue 36418 has been opened to track @fdrake's request in msg338645.

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

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

From fwchapman at gmail.com  Mon Mar 25 01:52:09 2019
From: fwchapman at gmail.com (Fred Chapman)
Date: Mon, 25 Mar 2019 01:52:09 -0400
Subject: [docs] Documentation bug in 'property' function
Message-ID: <CANqkDDyzt2pWoRFAeHy4G4Z8GT8+aw2+hdR1ihMvShSNJPE1dw@mail.gmail.com>

Hello,

I believe I've found a mistake in the documentation for the *property*
function:

https://docs.python.org/3/library/functions.html#property

The relevant excerpt is right at the top:

*class *property(*fget=None*, *fset=None*, *fdel=None*, *doc=None*)
<https://docs.python.org/3/library/functions.html#property>

Return a property attribute.

*I believe attribute should actually say object.*

According to the first word of the first line of the property function
documentation (*class*), the property function is a class constructor.
Consequently, its function call returns an *instance of the class*, which
is an *object*. In fact, the documentation for the property function uses
the phrase *property object* three times.

Moreover, a property object has *three* method attributes, not just one:
*getter*, *setter*, and *deleter*. "Return a property attribute" is
singular (one) rather than plural (three), which makes no sense here.

Am I correct or have I misunderstood something?

Thank you,

Fred Chapman
Content Editor
fwchapman.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190325/17ccf28e/attachment.html>

From report at bugs.python.org  Mon Mar 25 13:26:49 2019
From: report at bugs.python.org (Shengjing Zhu)
Date: Mon, 25 Mar 2019 17:26:49 +0000
Subject: [docs] [issue36425] Add Simplified Chinese to the language switcher
Message-ID: <1553534809.43.0.761682009724.issue36425@roundup.psfhosted.org>


New submission from Shengjing Zhu <zsj950618 at gmail.com>:

Just checked on transifex, the Simplified Chinese translation has reached

- 100% of bugs.html
- 100% of tutorial
- 100% of library/functions (builtins)

So, let's add it to the language switcher

{
    'zh-cn': 'Simplified Chinese'
}

And backport it to 3.7 branch.

----------
assignee: docs at python
components: Documentation
messages: 338811
nosy: docs at python, mdk, xiang.zhang, zhsj
priority: normal
severity: normal
status: open
title: Add Simplified Chinese to the language switcher
versions: Python 3.7

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

From report at bugs.python.org  Mon Mar 25 13:34:40 2019
From: report at bugs.python.org (Shengjing Zhu)
Date: Mon, 25 Mar 2019 17:34:40 +0000
Subject: [docs] [issue36425] Add Simplified Chinese to the language switcher
In-Reply-To: <1553534809.43.0.761682009724.issue36425@roundup.psfhosted.org>
Message-ID: <1553535280.6.0.744039208354.issue36425@roundup.psfhosted.org>


Change by Shengjing Zhu <zsj950618 at gmail.com>:


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

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

From report at bugs.python.org  Mon Mar 25 14:05:39 2019
From: report at bugs.python.org (Ethan Furman)
Date: Mon, 25 Mar 2019 18:05:39 +0000
Subject: [docs] [issue31369] re.RegexFlag is not included in __all__,
 makes type inference less useful
In-Reply-To: <1504730402.58.0.544251648863.issue31369@psf.upfronthosting.co.za>
Message-ID: <1553537139.58.0.155800620662.issue31369@roundup.psfhosted.org>


Ethan Furman <ethan at stoneleaf.us> added the comment:

I see no reason no prefix `RegexFlag` with an `_`.

As far as adding it to `__all__` -- I didn't originally because I was trying to mirror the original implementation, but I am not against it.  I would defer that decision to those that work on typing.

----------
assignee: docs at python -> 
components:  -Documentation
nosy: +gvanrossum, levkivskyi
title: re.RegexFlag is not included in __all__ -> re.RegexFlag is not included in __all__, makes type inference less useful

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

From report at bugs.python.org  Mon Mar 25 14:31:55 2019
From: report at bugs.python.org (Brett Cannon)
Date: Mon, 25 Mar 2019 18:31:55 +0000
Subject: [docs] [issue36404] Document PendingDeprecationWarning as deprecated
Message-ID: <1553538715.04.0.681297249125.issue36404@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Mon Mar 25 14:39:37 2019
From: report at bugs.python.org (Rohit travels and tours)
Date: Mon, 25 Mar 2019 18:39:37 +0000
Subject: [docs] [issue36425] Add Simplified Chinese to the language switcher
In-Reply-To: <1553534809.43.0.761682009724.issue36425@roundup.psfhosted.org>
Message-ID: <1553539177.61.0.309901400389.issue36425@roundup.psfhosted.org>


Change by Rohit travels and tours <roufique at rtat.net>:


----------
type:  -> resource usage

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

From report at bugs.python.org  Mon Mar 25 18:35:35 2019
From: report at bugs.python.org (PEW's Corner)
Date: Mon, 25 Mar 2019 22:35:35 +0000
Subject: [docs] [issue36416] bytes.rpartition bug in online documentation
In-Reply-To: <1553437427.15.0.469399643284.issue36416@roundup.psfhosted.org>
Message-ID: <1553553335.26.0.735691296674.issue36416@roundup.psfhosted.org>


Change by PEW's Corner <pewscorner at gmail.com>:


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

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

From report at bugs.python.org  Mon Mar 25 18:53:05 2019
From: report at bugs.python.org (Brett Cannon)
Date: Mon, 25 Mar 2019 22:53:05 +0000
Subject: [docs] [issue36345] Deprecate Tools/scripts/serve.py in favour of
 python -m http.server -d
In-Reply-To: <1552917459.29.0.295748589939.issue36345@roundup.psfhosted.org>
Message-ID: <1553554385.37.0.690844659003.issue36345@roundup.psfhosted.org>


Brett Cannon <brett at python.org> added the comment:


New changeset 360e1e4c519cfc139de707bcdd1e6c871eec79ee by Brett Cannon (St?phane Wirtel) in branch 'master':
bpo-36345: Add a new example in the documentation of wsgiref (#12511)
https://github.com/python/cpython/commit/360e1e4c519cfc139de707bcdd1e6c871eec79ee


----------

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

From report at bugs.python.org  Mon Mar 25 18:53:46 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Mon, 25 Mar 2019 22:53:46 +0000
Subject: [docs] [issue34085] doc Improve wording on classmethod/staticmethod
In-Reply-To: <1531240423.32.0.56676864532.issue34085@psf.upfronthosting.co.za>
Message-ID: <1553554426.63.0.0452850287976.issue34085@roundup.psfhosted.org>


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


New changeset 548cb6060ab9d5a66931ea2be4da08c2c72c9176 by Cheryl Sabella (Andre Delfino) in branch 'master':
bpo-34085: Improve wording on classmethod/staticmethod (#8228)
https://github.com/python/cpython/commit/548cb6060ab9d5a66931ea2be4da08c2c72c9176


----------
nosy: +cheryl.sabella

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

From report at bugs.python.org  Mon Mar 25 18:53:56 2019
From: report at bugs.python.org (miss-islington)
Date: Mon, 25 Mar 2019 22:53:56 +0000
Subject: [docs] [issue34085] doc Improve wording on classmethod/staticmethod
In-Reply-To: <1531240423.32.0.56676864532.issue34085@psf.upfronthosting.co.za>
Message-ID: <1553554436.78.0.992898445847.issue34085@roundup.psfhosted.org>


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


----------
pull_requests: +12493

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

From report at bugs.python.org  Mon Mar 25 18:54:06 2019
From: report at bugs.python.org (miss-islington)
Date: Mon, 25 Mar 2019 22:54:06 +0000
Subject: [docs] [issue34085] doc Improve wording on classmethod/staticmethod
In-Reply-To: <1531240423.32.0.56676864532.issue34085@psf.upfronthosting.co.za>
Message-ID: <1553554446.24.0.199331472687.issue34085@roundup.psfhosted.org>


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


----------
pull_requests: +12494

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

From report at bugs.python.org  Mon Mar 25 18:58:43 2019
From: report at bugs.python.org (miss-islington)
Date: Mon, 25 Mar 2019 22:58:43 +0000
Subject: [docs] [issue34085] doc Improve wording on classmethod/staticmethod
In-Reply-To: <1531240423.32.0.56676864532.issue34085@psf.upfronthosting.co.za>
Message-ID: <1553554723.55.0.208239901389.issue34085@roundup.psfhosted.org>


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


New changeset bd96393cda54044d81054225dcfc1b26374589a8 by Miss Islington (bot) in branch '2.7':
bpo-34085: Improve wording on classmethod/staticmethod (GH-8228)
https://github.com/python/cpython/commit/bd96393cda54044d81054225dcfc1b26374589a8


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

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

From report at bugs.python.org  Mon Mar 25 19:00:05 2019
From: report at bugs.python.org (miss-islington)
Date: Mon, 25 Mar 2019 23:00:05 +0000
Subject: [docs] [issue34085] doc Improve wording on classmethod/staticmethod
In-Reply-To: <1531240423.32.0.56676864532.issue34085@psf.upfronthosting.co.za>
Message-ID: <1553554805.15.0.567319217084.issue34085@roundup.psfhosted.org>


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


New changeset b23b08623a46cef841038ee32948020692ef1b35 by Miss Islington (bot) in branch '3.7':
bpo-34085: Improve wording on classmethod/staticmethod (GH-8228)
https://github.com/python/cpython/commit/b23b08623a46cef841038ee32948020692ef1b35


----------

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

From report at bugs.python.org  Mon Mar 25 19:23:35 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Mon, 25 Mar 2019 23:23:35 +0000
Subject: [docs] [issue34085] doc Improve wording on classmethod/staticmethod
In-Reply-To: <1531240423.32.0.56676864532.issue34085@psf.upfronthosting.co.za>
Message-ID: <1553556215.91.0.0608211777572.issue34085@roundup.psfhosted.org>


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

Thanks for the report and the PR, Andr?s!

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

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

From report at bugs.python.org  Mon Mar 25 19:23:44 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Mon, 25 Mar 2019 23:23:44 +0000
Subject: [docs] [issue34085] doc Improve wording on classmethod/staticmethod
In-Reply-To: <1531240423.32.0.56676864532.issue34085@psf.upfronthosting.co.za>
Message-ID: <1553556224.59.0.968770994825.issue34085@roundup.psfhosted.org>


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


----------
versions:  -Python 3.6

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

From report at bugs.python.org  Tue Mar 26 05:08:30 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Tue, 26 Mar 2019 09:08:30 +0000
Subject: [docs] [issue36345] Deprecate Tools/scripts/serve.py in favour of
 python -m http.server -d
In-Reply-To: <1553554385.37.0.690844659003.issue36345@roundup.psfhosted.org>
Message-ID: <53c7176c-8237-9a70-a1a2-d50dd585e8a5@wirtel.be>


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

Thank you for the merge.

St?phane

----------

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

From report at bugs.python.org  Tue Mar 26 07:20:58 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Tue, 26 Mar 2019 11:20:58 +0000
Subject: [docs] [issue13282] the table of contents in epub file is too long
In-Reply-To: <1319796506.79.0.347343158897.issue13282@psf.upfronthosting.co.za>
Message-ID: <1553599258.89.0.935120116278.issue13282@roundup.psfhosted.org>


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


----------
nosy: +ezio.melotti, mdk, willingc
type:  -> enhancement
versions: +Python 3.7, Python 3.8 -Python 2.7, Python 3.2

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

From report at bugs.python.org  Tue Mar 26 08:33:51 2019
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 26 Mar 2019 12:33:51 +0000
Subject: [docs] [issue36345] Deprecate Tools/scripts/serve.py in favour of
 python -m http.server -d
In-Reply-To: <1552917459.29.0.295748589939.issue36345@roundup.psfhosted.org>
Message-ID: <1553603631.04.0.807956074749.issue36345@roundup.psfhosted.org>


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

Would it me sense to use ".. literalinclude:: ../../Tools/scripts/serve.py" in the wsgi doc to keep serve.py and and this example up to date? It seems like serve.py is going to stay.

----------

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

From report at bugs.python.org  Tue Mar 26 10:10:31 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Tue, 26 Mar 2019 14:10:31 +0000
Subject: [docs] [issue36345] Deprecate Tools/scripts/serve.py in favour of
 python -m http.server -d
In-Reply-To: <1552917459.29.0.295748589939.issue36345@roundup.psfhosted.org>
Message-ID: <1553609431.69.0.02790714955.issue36345@roundup.psfhosted.org>


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


----------
pull_requests: +12507

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

From report at bugs.python.org  Tue Mar 26 14:19:48 2019
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 26 Mar 2019 18:19:48 +0000
Subject: [docs] [issue36345] Deprecate Tools/scripts/serve.py in favour of
 python -m http.server -d
In-Reply-To: <1552917459.29.0.295748589939.issue36345@roundup.psfhosted.org>
Message-ID: <1553624388.89.0.684401669265.issue36345@roundup.psfhosted.org>


Brett Cannon <brett at python.org> added the comment:

I actually still think we should remove serve.py as the person who had needed to clean up that directory when we realized we had massive bitrot in /Tools. :) I don't' think that just because Debian packages means we need to continue supporting and maintaining it (e.g. if wsgiref was changed who is going to remember to update this script?).

----------

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

From report at bugs.python.org  Tue Mar 26 15:12:49 2019
From: report at bugs.python.org (miss-islington)
Date: Tue, 26 Mar 2019 19:12:49 +0000
Subject: [docs] [issue36364] errors in multiprocessing.shared_memory examples
In-Reply-To: <1553006397.24.0.439789667635.issue36364@roundup.psfhosted.org>
Message-ID: <1553627569.23.0.154114670863.issue36364@roundup.psfhosted.org>


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


New changeset 3b7e47aea9b29f2669e7178a461426d18bce349e by Miss Islington (bot) (Pierre Glaser) in branch 'master':
bpo-36364: fix SharedMemoryManager examples (GH-12439)
https://github.com/python/cpython/commit/3b7e47aea9b29f2669e7178a461426d18bce349e


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

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

From report at bugs.python.org  Tue Mar 26 15:13:44 2019
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 26 Mar 2019 19:13:44 +0000
Subject: [docs] [issue36364] errors in multiprocessing.shared_memory examples
In-Reply-To: <1553006397.24.0.439789667635.issue36364@roundup.psfhosted.org>
Message-ID: <1553627624.74.0.538592490554.issue36364@roundup.psfhosted.org>


Brett Cannon <brett at python.org> added the comment:

I've gone ahead and merged Pierre's fix (thanks!), but I'm not sure if SharedMemoryManager should stay in the shared_memory docs or if it should move over to multiprocessing.manager.

Davin, any input on that?

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

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

From report at bugs.python.org  Tue Mar 26 17:10:50 2019
From: report at bugs.python.org (Tal Einat)
Date: Tue, 26 Mar 2019 21:10:50 +0000
Subject: [docs] [issue34203] documentation: recommend Python 3 over 2 in faq
In-Reply-To: <1532397328.96.0.56676864532.issue34203@psf.upfronthosting.co.za>
Message-ID: <1553634650.27.0.410177759402.issue34203@roundup.psfhosted.org>


Tal Einat <taleinat at gmail.com> added the comment:


New changeset 6cd658b1a5cb2413230dbc2d9395d20498be8518 by Tal Einat in branch 'master':
bpo-34203: FAQ: improve wording of paragraph about 2.x vs. 3.x (GH-9821)
https://github.com/python/cpython/commit/6cd658b1a5cb2413230dbc2d9395d20498be8518


----------

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

From report at bugs.python.org  Tue Mar 26 17:11:14 2019
From: report at bugs.python.org (miss-islington)
Date: Tue, 26 Mar 2019 21:11:14 +0000
Subject: [docs] [issue34203] documentation: recommend Python 3 over 2 in faq
In-Reply-To: <1532397328.96.0.56676864532.issue34203@psf.upfronthosting.co.za>
Message-ID: <1553634674.64.0.51169693373.issue34203@roundup.psfhosted.org>


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


----------
pull_requests: +12512

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

From report at bugs.python.org  Tue Mar 26 17:11:27 2019
From: report at bugs.python.org (miss-islington)
Date: Tue, 26 Mar 2019 21:11:27 +0000
Subject: [docs] [issue34203] documentation: recommend Python 3 over 2 in faq
In-Reply-To: <1532397328.96.0.56676864532.issue34203@psf.upfronthosting.co.za>
Message-ID: <1553634687.44.0.879098292828.issue34203@roundup.psfhosted.org>


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


----------
pull_requests: +12513

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

From report at bugs.python.org  Tue Mar 26 17:17:21 2019
From: report at bugs.python.org (miss-islington)
Date: Tue, 26 Mar 2019 21:17:21 +0000
Subject: [docs] [issue34203] documentation: recommend Python 3 over 2 in faq
In-Reply-To: <1532397328.96.0.56676864532.issue34203@psf.upfronthosting.co.za>
Message-ID: <1553635041.33.0.539739227107.issue34203@roundup.psfhosted.org>


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


New changeset 5a3316931c6042df44b3b342df956cd6a77e8dcd by Miss Islington (bot) in branch '2.7':
[2.7] bpo-34203: FAQ: improve wording of paragraph about 2.x vs. 3.x (GH-9821) (GH-12568)
https://github.com/python/cpython/commit/5a3316931c6042df44b3b342df956cd6a77e8dcd


----------

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

From report at bugs.python.org  Tue Mar 26 17:20:33 2019
From: report at bugs.python.org (miss-islington)
Date: Tue, 26 Mar 2019 21:20:33 +0000
Subject: [docs] [issue34203] documentation: recommend Python 3 over 2 in faq
In-Reply-To: <1532397328.96.0.56676864532.issue34203@psf.upfronthosting.co.za>
Message-ID: <1553635233.89.0.00585094754954.issue34203@roundup.psfhosted.org>


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


New changeset 5ac626350e2bfe5f283e7322bc31045062680d2b by Miss Islington (bot) in branch '3.7':
bpo-34203: FAQ: improve wording of paragraph about 2.x vs. 3.x (GH-9821)
https://github.com/python/cpython/commit/5ac626350e2bfe5f283e7322bc31045062680d2b


----------

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

From zxenderock at gmail.com  Tue Mar 26 07:17:59 2019
From: zxenderock at gmail.com (Zxenderock)
Date: Tue, 26 Mar 2019 11:17:59 +0000
Subject: [docs] Problem with Tab
Message-ID: <CANUn25q+dihmSqXcNZ75H1PRM8W6=pHLhUfZiMkdYKMXijtTtQ@mail.gmail.com>

Dear Python Development Team,
I found that "\t" ot TAB is not a proper tab but combination of spaces due
to which I am facing lot of problems.

I think this should be improved.

THANK YOU

-- 

-------------------
*ZxenderocK*
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190326/8e2244a4/attachment.html>

From report at bugs.python.org  Tue Mar 26 18:11:40 2019
From: report at bugs.python.org (Julien Palard)
Date: Tue, 26 Mar 2019 22:11:40 +0000
Subject: [docs] [issue36425] Add Simplified Chinese to the language switcher
In-Reply-To: <1553534809.43.0.761682009724.issue36425@roundup.psfhosted.org>
Message-ID: <1553638300.87.0.865262418345.issue36425@roundup.psfhosted.org>


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

That's nice to read!

Once you've added a NEWS (see PR) entry I'll be happy to merge this.

----------
assignee: docs at python -> mdk

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

From report at bugs.python.org  Tue Mar 26 18:58:01 2019
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 26 Mar 2019 22:58:01 +0000
Subject: [docs] [issue33601] [EASY DOC] Py_UTF8Mode is not documented
In-Reply-To: <1526996981.47.0.682650639539.issue33601@psf.upfronthosting.co.za>
Message-ID: <1553641081.0.0.997330342804.issue33601@roundup.psfhosted.org>


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

PR 7143 has been closed. So is there another candidate to write the doc?

----------

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

From report at bugs.python.org  Tue Mar 26 19:00:32 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Tue, 26 Mar 2019 23:00:32 +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: <1553641232.17.0.327671339962.issue35165@roundup.psfhosted.org>


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

> Or maybe just link to https://docs.python.org/3/reference/datamodel.html#object.__getattr__ (which mention about it) will be enough.

In section 6.3.1, __getattr__() is already linked to the datamodel page referenced.  

As your suggested change is already in the docs, I'm going to close this.

----------
nosy: +cheryl.sabella
resolution:  -> not a bug
stage:  -> resolved
status: open -> closed

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

From report at bugs.python.org  Tue Mar 26 19:44:24 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Tue, 26 Mar 2019 23:44:24 +0000
Subject: [docs] [issue30337] Vague wording of pkgutil.walk_packages
 parameter 'prefix'
In-Reply-To: <1494449389.02.0.790150087603.issue30337@psf.upfronthosting.co.za>
Message-ID: <1553643864.69.0.477230894678.issue30337@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Tue Mar 26 21:15:00 2019
From: report at bugs.python.org (Rune Tynan)
Date: Wed, 27 Mar 2019 01:15:00 +0000
Subject: [docs] [issue18697] Unify arguments names in Unicode object C API
 documentation
In-Reply-To: <1376074126.58.0.40251146149.issue18697@psf.upfronthosting.co.za>
Message-ID: <1553649300.54.0.228289344775.issue18697@roundup.psfhosted.org>


Change by Rune Tynan <runetynan at gmail.com>:


----------
nosy: +Rune Tynan

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

From report at bugs.python.org  Tue Mar 26 21:21:30 2019
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 27 Mar 2019 01:21:30 +0000
Subject: [docs] [issue33832] doc Add "magic method" entry to Glossary
In-Reply-To: <1528718191.62.0.592728768989.issue33832@psf.upfronthosting.co.za>
Message-ID: <1553649690.1.0.673366820937.issue33832@roundup.psfhosted.org>


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


New changeset f760610bddd7e8f8ac0914d5d59ef806bc16a73b by ?ric Araujo (Andre Delfino) in branch 'master':
bpo-33832: Add "magic method" glossary entry (GH-7630)
https://github.com/python/cpython/commit/f760610bddd7e8f8ac0914d5d59ef806bc16a73b


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

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

From report at bugs.python.org  Tue Mar 26 21:21:39 2019
From: report at bugs.python.org (miss-islington)
Date: Wed, 27 Mar 2019 01:21:39 +0000
Subject: [docs] [issue33832] doc Add "magic method" entry to Glossary
In-Reply-To: <1528718191.62.0.592728768989.issue33832@psf.upfronthosting.co.za>
Message-ID: <1553649699.23.0.261862286298.issue33832@roundup.psfhosted.org>


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


----------
pull_requests: +12518

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

From report at bugs.python.org  Tue Mar 26 21:21:49 2019
From: report at bugs.python.org (miss-islington)
Date: Wed, 27 Mar 2019 01:21:49 +0000
Subject: [docs] [issue33832] doc Add "magic method" entry to Glossary
In-Reply-To: <1528718191.62.0.592728768989.issue33832@psf.upfronthosting.co.za>
Message-ID: <1553649709.57.0.982375028269.issue33832@roundup.psfhosted.org>


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


----------
pull_requests: +12519

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

From report at bugs.python.org  Tue Mar 26 21:26:17 2019
From: report at bugs.python.org (miss-islington)
Date: Wed, 27 Mar 2019 01:26:17 +0000
Subject: [docs] [issue33832] doc Add "magic method" entry to Glossary
In-Reply-To: <1528718191.62.0.592728768989.issue33832@psf.upfronthosting.co.za>
Message-ID: <1553649977.09.0.65771581452.issue33832@roundup.psfhosted.org>


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


New changeset 6cbb4c0795099b79f0a7c7d20df4ba1c1ec0ac24 by Miss Islington (bot) in branch '2.7':
bpo-33832: Add "magic method" glossary entry (GH-7630)
https://github.com/python/cpython/commit/6cbb4c0795099b79f0a7c7d20df4ba1c1ec0ac24


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

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

From report at bugs.python.org  Tue Mar 26 21:26:54 2019
From: report at bugs.python.org (miss-islington)
Date: Wed, 27 Mar 2019 01:26:54 +0000
Subject: [docs] [issue33832] doc Add "magic method" entry to Glossary
In-Reply-To: <1528718191.62.0.592728768989.issue33832@psf.upfronthosting.co.za>
Message-ID: <1553650014.45.0.295163939555.issue33832@roundup.psfhosted.org>


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


New changeset ead15795986972690217e52087eb946b8a5bbcda by Miss Islington (bot) in branch '3.7':
bpo-33832: Add "magic method" glossary entry (GH-7630)
https://github.com/python/cpython/commit/ead15795986972690217e52087eb946b8a5bbcda


----------

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

From zachary.ware+pydocs at gmail.com  Tue Mar 26 21:38:53 2019
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Tue, 26 Mar 2019 20:38:53 -0500
Subject: [docs] Problem with Tab
In-Reply-To: <CANUn25q+dihmSqXcNZ75H1PRM8W6=pHLhUfZiMkdYKMXijtTtQ@mail.gmail.com>
References: <CANUn25q+dihmSqXcNZ75H1PRM8W6=pHLhUfZiMkdYKMXijtTtQ@mail.gmail.com>
Message-ID: <CAKJDb-P13DR3SjU2CXVkS5PZWGXdozvCJn4NmrUb=tAi5k=-cQ@mail.gmail.com>

Hi,

On Tue, Mar 26, 2019 at 4:42 PM Zxenderock <zxenderock at gmail.com> wrote:
> Dear Python Development Team,
> I found that "\t" ot TAB is not a proper tab but combination of spaces due to which I am facing lot of problems.
>
> I think this should be improved.

Unfortunately, you're going to have to be a lot more specific about
what's going on before anything can be improved.  The string `"\t"`
really is a tab character; try `ord('\t')`.

-- 
Zach

From report at bugs.python.org  Tue Mar 26 22:01:57 2019
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 27 Mar 2019 02:01:57 +0000
Subject: [docs] [issue33832] doc Add "magic method" entry to Glossary
In-Reply-To: <1528718191.62.0.592728768989.issue33832@psf.upfronthosting.co.za>
Message-ID: <1553652117.62.0.195984475028.issue33832@roundup.psfhosted.org>


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

Thanks for the patch!

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

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

From report at bugs.python.org  Wed Mar 27 02:35:00 2019
From: report at bugs.python.org (Jeroen Demeyer)
Date: Wed, 27 Mar 2019 06:35:00 +0000
Subject: [docs] [issue29986] Documentation recommends raising TypeError from
 tp_richcompare
In-Reply-To: <1491346313.99.0.131506773991.issue29986@psf.upfronthosting.co.za>
Message-ID: <1553668500.52.0.762895199674.issue29986@roundup.psfhosted.org>


Jeroen Demeyer <J.Demeyer at UGent.be> added the comment:

The consensus is clearly to return NotImplemented in this case, also because that's what most builtins do, like the object() example that you mentioned.

However, I would rather keep that note and change it to say return NotImplemented. It's an important difference between tp_richcompare and the 6 Python methods __eq__ and friends. Explicitly saying what do you if you only want __eq__ and __ne__ but no other operators (which is not exceptional at all) looks useful to me.

----------
nosy: +jdemeyer

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

From report at bugs.python.org  Wed Mar 27 02:44:35 2019
From: report at bugs.python.org (Terry J. Reedy)
Date: Wed, 27 Mar 2019 06:44:35 +0000
Subject: [docs] [issue33832] doc Add "magic method" entry to Glossary
In-Reply-To: <1528718191.62.0.592728768989.issue33832@psf.upfronthosting.co.za>
Message-ID: <1553669075.45.0.180100574092.issue33832@roundup.psfhosted.org>


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

Several hours ago, I read the unittest.mock doc, which uses 'magic methods' to explain MagicMock.  So I decided an entry really was needed.  Andr?s, thanks for sticking with this,

----------
versions:  -Python 3.6

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

From 11612833 at mail.sustc.edu.cn  Tue Mar 26 21:12:08 2019
From: 11612833 at mail.sustc.edu.cn (=?gb2312?B?ydDB9be9vaM=?=)
Date: Wed, 27 Mar 2019 09:12:08 +0800
Subject: [docs] How to download the Python 3.7.3 Documentation in Chinese?
Message-ID: <C32BECD2-2845-40CE-B82B-982CCB03A7F3@mail.sustc.edu.cn>

I have downloaded the Documentation in the format of PDF, but the documentation I downloaded is written by English. How can I downloaded the Chinese version?


From report at bugs.python.org  Wed Mar 27 16:41:07 2019
From: report at bugs.python.org (dtrauma)
Date: Wed, 27 Mar 2019 20:41:07 +0000
Subject: [docs] [issue36373] asyncio.gather: no docs for deprecated loop
 parameter
In-Reply-To: <1553025335.55.0.640410639085.issue36373@roundup.psfhosted.org>
Message-ID: <1553719266.97.0.519486621707.issue36373@roundup.psfhosted.org>


dtrauma <python-bugs at digital-trauma.de> added the comment:

Just to be clear, I don't know if loop is deprecated on this function like on all the others, I just suspect it to be. But it currently is completely undocumented, which either way is a bug. :)

----------

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

From report at bugs.python.org  Wed Mar 27 16:52:44 2019
From: report at bugs.python.org (Emmanuel Arias)
Date: Wed, 27 Mar 2019 20:52:44 +0000
Subject: [docs] [issue36373] asyncio.gather: no docs for deprecated loop
 parameter
In-Reply-To: <1553025335.55.0.640410639085.issue36373@roundup.psfhosted.org>
Message-ID: <1553719964.13.0.568768280548.issue36373@roundup.psfhosted.org>


Emmanuel Arias <emmanuelarias30 at gmail.com> added the comment:

@dtrauma jus for clarify. You say that if loop is not deprecated document it else document it.


Right?

----------

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

From report at bugs.python.org  Wed Mar 27 16:54:16 2019
From: report at bugs.python.org (dtrauma)
Date: Wed, 27 Mar 2019 20:54:16 +0000
Subject: [docs] [issue36373] asyncio.gather: no docs for deprecated loop
 parameter
In-Reply-To: <1553025335.55.0.640410639085.issue36373@roundup.psfhosted.org>
Message-ID: <1553720056.04.0.301485242455.issue36373@roundup.psfhosted.org>


dtrauma <python-bugs at digital-trauma.de> added the comment:

Yes, exactly, document deprecation status XOR what it does :)

----------

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

From report at bugs.python.org  Wed Mar 27 18:29:39 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Wed, 27 Mar 2019 22:29:39 +0000
Subject: [docs] [issue33953] The DEFAULT_ENTROPY variable used to store the
 current default random bytes value should be documented for `secrets`
 module
In-Reply-To: <1529913551.53.0.56676864532.issue33953@psf.upfronthosting.co.za>
Message-ID: <1553725779.19.0.179729163992.issue33953@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Wed Mar 27 18:49:07 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Wed, 27 Mar 2019 22:49:07 +0000
Subject: [docs] [issue31327] bug in dateutil\tz\tz.py
In-Reply-To: <1504286649.82.0.482783873664.issue31327@psf.upfronthosting.co.za>
Message-ID: <1553726947.68.0.538334375995.issue31327@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Wed Mar 27 19:00:50 2019
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Wed, 27 Mar 2019 23:00:50 +0000
Subject: [docs] [issue31327] bug in dateutil\tz\tz.py
In-Reply-To: <1504286649.82.0.482783873664.issue31327@psf.upfronthosting.co.za>
Message-ID: <1553727650.48.0.947190561019.issue31327@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Thu Mar 28 04:27:52 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Thu, 28 Mar 2019 08:27:52 +0000
Subject: [docs] [issue31327] bug in dateutil\tz\tz.py
In-Reply-To: <1553727650.48.0.947190561019.issue31327@roundup.psfhosted.org>
Message-ID: <20190328082749.GB26095@xps>


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

nosy: -matrixise

----------

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

From report at bugs.python.org  Thu Mar 28 04:28:43 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Thu, 28 Mar 2019 08:28:43 +0000
Subject: [docs] [issue31327] bug in dateutil\tz\tz.py
In-Reply-To: <1553727650.48.0.947190561019.issue31327@roundup.psfhosted.org>
Message-ID: <20190328082840.GC26095@xps>


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

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

----------

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

From report at bugs.python.org  Thu Mar 28 04:29:22 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Thu, 28 Mar 2019 08:29:22 +0000
Subject: [docs] [issue31327] bug in dateutil\tz\tz.py
In-Reply-To: <1504286649.82.0.482783873664.issue31327@psf.upfronthosting.co.za>
Message-ID: <1553761762.16.0.0713799007698.issue31327@roundup.psfhosted.org>


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

sorry for the spam, I wanted to be removed from the noisy list via the mail gateway but my two tests did not work :/

----------

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

From zxenderock at gmail.com  Thu Mar 28 00:25:28 2019
From: zxenderock at gmail.com (Zxenderock)
Date: Thu, 28 Mar 2019 04:25:28 +0000
Subject: [docs] Problem with Tab
In-Reply-To: <CAKJDb-P13DR3SjU2CXVkS5PZWGXdozvCJn4NmrUb=tAi5k=-cQ@mail.gmail.com>
References: <CANUn25q+dihmSqXcNZ75H1PRM8W6=pHLhUfZiMkdYKMXijtTtQ@mail.gmail.com>
 <CAKJDb-P13DR3SjU2CXVkS5PZWGXdozvCJn4NmrUb=tAi5k=-cQ@mail.gmail.com>
Message-ID: <CANUn25orVoDaxv3Tu5j8fJ4HE+q1-pBhYhQ=HxP-=TxQ5gS5Ug@mail.gmail.com>

Dear Zachary,
you are right that ord('\t') and ord('[tab]') gives same result that is 9.
But, when I copied a string from python IDLE for e.g " a        b
 c" (here spaces are for tabs) and then I tried paste it in a notepad then
I found this tab spacing is different from the spacing that I am getting by
typing same string directly in notepad. but when I tried this with Java it
is a proper tab.
my point is that the result string that I am getting is a combination of
spaces character while I am copying and pasting.

sorry, if I am asking something silly, but please help.

Regards


On Wed, Mar 27, 2019 at 1:39 AM Zachary Ware <zachary.ware+pydocs at gmail.com>
wrote:

> Hi,
>
> On Tue, Mar 26, 2019 at 4:42 PM Zxenderock <zxenderock at gmail.com> wrote:
> > Dear Python Development Team,
> > I found that "\t" ot TAB is not a proper tab but combination of spaces
> due to which I am facing lot of problems.
> >
> > I think this should be improved.
>
> Unfortunately, you're going to have to be a lot more specific about
> what's going on before anything can be improved.  The string `"\t"`
> really is a tab character; try `ord('\t')`.
>
> --
> Zach
>


-- 

-------------------
*ZxenderocK*
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190328/f2dfc22b/attachment.html>

From report at bugs.python.org  Thu Mar 28 08:27:55 2019
From: report at bugs.python.org (Inada Naoki)
Date: Thu, 28 Mar 2019 12:27:55 +0000
Subject: [docs] [issue17110] sys.argv docs should explaining how to handle
 encoding issues
In-Reply-To: <1359864071.69.0.659089821533.issue17110@psf.upfronthosting.co.za>
Message-ID: <1553776075.61.0.728137301109.issue17110@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Thu Mar 28 09:52:04 2019
From: report at bugs.python.org (Paul Ganssle)
Date: Thu, 28 Mar 2019 13:52:04 +0000
Subject: [docs] [issue31327] bug in dateutil\tz\tz.py
In-Reply-To: <1504286649.82.0.482783873664.issue31327@psf.upfronthosting.co.za>
Message-ID: <1553781124.39.0.0438027248272.issue31327@roundup.psfhosted.org>


Paul Ganssle <p.ganssle at gmail.com> added the comment:

Can we change the title of this to something like, "Add example of platform-specific support for negative timestamps to the time documentation"?

That might be a bit wordy, but as it is now, this looks like it's reporting a bug in dateutil, which is not part of the standard library, which may be confusing people looking for something to solve.

As for the meat of the documentation change, I think we can adapt the wording from `datetime.fromtimestamp`, which actually has a very similar example called out: https://docs.python.org/3.7/library/datetime.html#datetime.datetime.fromtimestamp

> fromtimestamp() may raise OverflowError, if the timestamp is out of the range of values supported by the platform C localtime() or gmtime() functions, and OSError on localtime() or gmtime() failure. It?s common for this to be restricted to years in 1970 through 2038.

----------

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

From report at bugs.python.org  Thu Mar 28 11:32:40 2019
From: report at bugs.python.org (Julien Palard)
Date: Thu, 28 Mar 2019 15:32:40 +0000
Subject: [docs] [issue36425] Add Simplified Chinese to the language switcher
In-Reply-To: <1553534809.43.0.761682009724.issue36425@roundup.psfhosted.org>
Message-ID: <1553787160.53.0.940564575559.issue36425@roundup.psfhosted.org>


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


New changeset 45a5fdb91cee665161a8b1980bb4e6ccb999f58f by Julien Palard (zhsj) in branch 'master':
bpo-36425: Add Simplified Chinese to the language switcher (GH-12537)
https://github.com/python/cpython/commit/45a5fdb91cee665161a8b1980bb4e6ccb999f58f


----------

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

From report at bugs.python.org  Thu Mar 28 11:36:03 2019
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 28 Mar 2019 15:36:03 +0000
Subject: [docs] [issue36425] Add Simplified Chinese to the language switcher
In-Reply-To: <1553534809.43.0.761682009724.issue36425@roundup.psfhosted.org>
Message-ID: <1553787363.45.0.924138161784.issue36425@roundup.psfhosted.org>


Change by Ezio Melotti <ezio.melotti at gmail.com>:


----------
nosy: +ezio.melotti

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

From report at bugs.python.org  Thu Mar 28 13:16:06 2019
From: report at bugs.python.org (miss-islington)
Date: Thu, 28 Mar 2019 17:16:06 +0000
Subject: [docs] [issue36425] Add Simplified Chinese to the language switcher
In-Reply-To: <1553534809.43.0.761682009724.issue36425@roundup.psfhosted.org>
Message-ID: <1553793366.42.0.523737120468.issue36425@roundup.psfhosted.org>


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


----------
pull_requests: +12547

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

From report at bugs.python.org  Thu Mar 28 14:12:49 2019
From: report at bugs.python.org (miss-islington)
Date: Thu, 28 Mar 2019 18:12:49 +0000
Subject: [docs] [issue36425] Add Simplified Chinese to the language switcher
In-Reply-To: <1553534809.43.0.761682009724.issue36425@roundup.psfhosted.org>
Message-ID: <1553796769.14.0.421419775796.issue36425@roundup.psfhosted.org>


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


New changeset 1d9f1a0c9690f4e53003dc5e625a2867715c828a by Miss Islington (bot) in branch '3.7':
bpo-36425: Add Simplified Chinese to the language switcher (GH-12537)
https://github.com/python/cpython/commit/1d9f1a0c9690f4e53003dc5e625a2867715c828a


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

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

From report at bugs.python.org  Thu Mar 28 17:05:54 2019
From: report at bugs.python.org (Julien Palard)
Date: Thu, 28 Mar 2019 21:05:54 +0000
Subject: [docs] [issue36425] Add Simplified Chinese to the language switcher
In-Reply-To: <1553534809.43.0.761682009724.issue36425@roundup.psfhosted.org>
Message-ID: <1553807154.7.0.127560880299.issue36425@roundup.psfhosted.org>


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/issue36425>
_______________________________________

From report at bugs.python.org  Thu Mar 28 21:16:42 2019
From: report at bugs.python.org (Rune Tynan)
Date: Fri, 29 Mar 2019 01:16:42 +0000
Subject: [docs] [issue18697] Unify arguments names in Unicode object C API
 documentation
In-Reply-To: <1376074126.58.0.40251146149.issue18697@psf.upfronthosting.co.za>
Message-ID: <1553822202.89.0.559996232688.issue18697@roundup.psfhosted.org>


Rune Tynan <runetynan at gmail.com> added the comment:

I have some interest in making a fix for this. From discussion, I'm thinking that, barring names that already have clear meaning (EG, left/right for things with two parameters):
- PyObject* that is unknown type remains `obj`
- PyObject* with unicode string is `unicode`
- const char*, const Py_UNICODE*, and const wchar* becomes `str`
- const char, const Py_UNICODE, and const wchar become `ch`

Those seem to be the intersect of most common and most descriptive names already seen.

----------

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

From report at bugs.python.org  Thu Mar 28 21:55:29 2019
From: report at bugs.python.org (Carol Willing)
Date: Fri, 29 Mar 2019 01:55:29 +0000
Subject: [docs] [issue33043] Add a 'Contributing to Docs' link at the bottom
 of docs.python.org
In-Reply-To: <1520703028.47.0.467229070634.issue33043@psf.upfronthosting.co.za>
Message-ID: <1553824529.59.0.765645678247.issue33043@roundup.psfhosted.org>


Carol Willing <willingc at gmail.com> added the comment:


New changeset 081158e3ba20dfa95d09cd652a44e271b95eb14c by Carol Willing (Susan Su) in branch 'master':
bpo-33043: Add a Contributing to Docs link and Update the Found a Bug Page (#12006)
https://github.com/python/cpython/commit/081158e3ba20dfa95d09cd652a44e271b95eb14c


----------

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

From report at bugs.python.org  Thu Mar 28 21:57:26 2019
From: report at bugs.python.org (Carol Willing)
Date: Fri, 29 Mar 2019 01:57:26 +0000
Subject: [docs] [issue33043] Add a 'Contributing to Docs' link at the bottom
 of docs.python.org
In-Reply-To: <1520703028.47.0.467229070634.issue33043@psf.upfronthosting.co.za>
Message-ID: <1553824646.86.0.60090894773.issue33043@roundup.psfhosted.org>


Change by Carol Willing <willingc at gmail.com>:


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

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

From report at bugs.python.org  Thu Mar 28 22:15:36 2019
From: report at bugs.python.org (Carol Willing)
Date: Fri, 29 Mar 2019 02:15:36 +0000
Subject: [docs] [issue36064] docs: urllib.request.Request not accepting
 iterables data type
In-Reply-To: <1550744621.39.0.0634252256257.issue36064@roundup.psfhosted.org>
Message-ID: <1553825736.75.0.547461969334.issue36064@roundup.psfhosted.org>


Carol Willing <willingc at gmail.com> added the comment:


New changeset 9e30fbac019d9c0a31d444a711e845c7e883caf5 by Carol Willing (Julien Palard) in branch 'master':
bpo-36064: Clarify allowed data types for urllib.request.Request. (GH-11990)
https://github.com/python/cpython/commit/9e30fbac019d9c0a31d444a711e845c7e883caf5


----------
nosy: +willingc

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

From report at bugs.python.org  Thu Mar 28 22:18:42 2019
From: report at bugs.python.org (Carol Willing)
Date: Fri, 29 Mar 2019 02:18:42 +0000
Subject: [docs] [issue36064] docs: urllib.request.Request not accepting
 iterables data type
In-Reply-To: <1550744621.39.0.0634252256257.issue36064@roundup.psfhosted.org>
Message-ID: <1553825922.39.0.138119740662.issue36064@roundup.psfhosted.org>


Carol Willing <willingc at gmail.com> added the comment:

I've merged Julien Palard's doc PR. Is this sufficient to close this issue?

----------

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

From report at bugs.python.org  Fri Mar 29 00:53:31 2019
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Fri, 29 Mar 2019 04:53:31 +0000
Subject: [docs] [issue36064] docs: urllib.request.Request not accepting
 iterables data type
In-Reply-To: <1550744621.39.0.0634252256257.issue36064@roundup.psfhosted.org>
Message-ID: <1553835211.84.0.353235221636.issue36064@roundup.psfhosted.org>


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

I would propose closing it since docs were made improved and if type checking needs to be enforced then it can be discussed in the linked open issues that have patches.

----------

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

From szhu at ipp.ac.cn  Fri Mar 29 00:17:52 2019
From: szhu at ipp.ac.cn (sizheng_zhu)
Date: Fri, 29 Mar 2019 12:17:52 +0800 (GMT+08:00)
Subject: [docs] =?utf-8?b?5peg5rOV5LiL6L295Yiw5Lit5paH54mI55qEUHl0aG9u?=
 =?utf-8?b?IDMuNy4z5paH5qGj?=
Message-ID: <21488f20.2c085.169c7ab16bf.Coremail.szhu@ipp.ac.cn>

?????????Python 3.7.3??????https://docs.python.org/zh-cn/3.7/download.html??????????

?????????????

???


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190329/2683b180/attachment.html>

From julien at palard.fr  Fri Mar 29 04:40:34 2019
From: julien at palard.fr (Julien Palard)
Date: Fri, 29 Mar 2019 08:40:34 +0000
Subject: [docs] =?utf-8?b?5peg5rOV5LiL6L295Yiw5Lit5paH54mI55qEUHl0aG9u?=
 =?utf-8?b?IDMuNy4z5paH5qGj?=
In-Reply-To: <21488f20.2c085.169c7ab16bf.Coremail.szhu@ipp.ac.cn>
References: <21488f20.2c085.169c7ab16bf.Coremail.szhu@ipp.ac.cn>
Message-ID: <nPf383pkAu-uxBbRVKILl9rVcShxvHhU1WCytKmaxVBKrkBt59xMrDscUXsHR-x1cQoOGbBC8iT66kAVkh0Ipx6q0nIuwyQjB9ZEogftgYY=@palard.fr>

Hi,

I'm sorry I don't understand you, could you please write in english?

Bests,
--
Julien Palard
https://mdk.fr
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190329/83b2395f/attachment.html>

From julien at palard.fr  Fri Mar 29 04:35:06 2019
From: julien at palard.fr (Julien Palard)
Date: Fri, 29 Mar 2019 08:35:06 +0000
Subject: [docs] Problem with Tab
In-Reply-To: <CANUn25orVoDaxv3Tu5j8fJ4HE+q1-pBhYhQ=HxP-=TxQ5gS5Ug@mail.gmail.com>
References: <CANUn25q+dihmSqXcNZ75H1PRM8W6=pHLhUfZiMkdYKMXijtTtQ@mail.gmail.com>
 <CAKJDb-P13DR3SjU2CXVkS5PZWGXdozvCJn4NmrUb=tAi5k=-cQ@mail.gmail.com>
 <CANUn25orVoDaxv3Tu5j8fJ4HE+q1-pBhYhQ=HxP-=TxQ5gS5Ug@mail.gmail.com>
Message-ID: <WKu1vjMDR_iRNVdTCFJKzt-HRjcBNkYoVLv8tUEfjAzdulsqyvSN02y8F7KhaWIasAQu-8e9fl3zLejnou-Bgx8AICzi4gaWo5Y6A7Uq7M8=@palard.fr>

Hi Zxenderock,

I'm trying to reproduce your issue but for the moment I can't, here what's I tried, please try to follow on your computer so we could find where the bug really lies:

- Open IDLE
- type print("a\tb\tc")
- See "a        b        c" with my eyes, can't tell if it's spaces or tabs so like you I'm copying it
- On a bash, I type "cat -A"
- I paste the previously copied string, type the enter key, and I see: a^Ib^Ic$

I conclude that what I copied is in fact the letter "a" followed by a single horizontal tab followed by the letter "b" and so on.

Few questions and answers:

# Why did I used cat -A instead of notepad?

- Because I do *not* trust notepad not modifying what I past to it
- Because I'm using Debian, so I do *not* have notepad

# What is this cat -A thing?

cat is in fact aimed at concatenating files, but with the -A flag (from the manual: -A, --show-all  equivalent to -vET) it's a nice way to get non-printable character nicely represented.

# How can I try your cat -A thing on Windows to tell if it's notepad that messed up with the tabs?

You should try with "git bash", I bet it comes with cat: https://gitforwindows.org/

# How did you interpret the mess out of cat -A?

The $ at the end means "end of line", no magic here it's from the cat manual: "-E, --show-ends   display $ at end of each line", and -A implies -E.
(There was *no* newline out of what I copied, it's my typing the enter key after pasting so cat ingest the line.)

The ^I thing is bit harder to understand at first, but fortunately it's in the manual page too: "-T, --show-tabs display TAB characters as ^I", and -A also implies -T

# Is there a better way to check than cat -A?

Yes I should have used hexdump, but I don't think git bash comes with hexdump, and I prefer a way you can reproduce on your machine. Using hexdump it looks like this:

    $ xclip -o | hexdump -C
    00000000  61 09 62 09 63                                    |a.b.c|
    00000005

(xclip is a way to get the content of the copy/paste buffer, I don't think you'll have it using git bash neither)
As you can see, a b and c letters are only separated by a single 09 character. and according to the `man ascii` manual page, it's an horizontal tab: `09    HT  '\t' (horizontal tab).

So for me, IDLE is doing the right thing, and I bet your notepad is messing with the stirng while you're pasting it, which I can't verify here.

Bests,
--
Julien Palard
https://mdk.fr
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190329/026401d8/attachment-0001.html>

From julien at palard.fr  Fri Mar 29 04:46:06 2019
From: julien at palard.fr (Julien Palard)
Date: Fri, 29 Mar 2019 08:46:06 +0000
Subject: [docs] How to download the Python 3.7.3 Documentation in
 Chinese?
In-Reply-To: <C32BECD2-2845-40CE-B82B-982CCB03A7F3@mail.sustc.edu.cn>
References: <C32BECD2-2845-40CE-B82B-982CCB03A7F3@mail.sustc.edu.cn>
Message-ID: <2NtE5IFB-TB2Vm4plSWy7cKu44IKs4B2CxwqIz3cNhl2owDsMItZmT5iJZkHVM4j4l_HiYrOGNPWL5klj5YG2L4d5UHgSoTXIBYXwxCru9k=@palard.fr>

Hi,

The chinese documentation is downloadable from here: https://docs.python.org/zh-cn/3/download.html

There may be some build problems, see: https://github.com/python/docsbuild-scripts/issues/71 and https://github.com/python/docsbuild-scripts/pull/70 don't hesitate to give feedback.

There's also only 17% of the documentation translated in Chinese, you may help translating the other parts here: https://www.transifex.com/python-doc/public/

Bests,
--?
Julien Palard
https://mdk.fr


From julien at palard.fr  Fri Mar 29 05:11:47 2019
From: julien at palard.fr (Julien Palard)
Date: Fri, 29 Mar 2019 09:11:47 +0000
Subject: [docs] Documentation bug in 'property' function
In-Reply-To: <CANqkDDyzt2pWoRFAeHy4G4Z8GT8+aw2+hdR1ihMvShSNJPE1dw@mail.gmail.com>
References: <CANqkDDyzt2pWoRFAeHy4G4Z8GT8+aw2+hdR1ihMvShSNJPE1dw@mail.gmail.com>
Message-ID: <Slj8VfvrXk7-Xf1tm4oPdYQ_AscYlsXsisp4tCFuQq5ujel6ArFSZI24l1bayqtDRAgarryyUjbBCs7TgQOdsI0NHFIfCOjd2ZTOONq_h_Y=@palard.fr>

Hi Fred, thanks for reporting this clearly!

First, please remember everything, literally everything in Python is an object. So an attribute is an object, but an int is an object:

>>> (42).__class__
<class 'int'>

a class is an object (so yes, a class is an instance of type):

>>> class Foo: pass
...
>>> Foo.__class__
<class 'type'>

A function is an object, and so on, and so on.

So yes, we could use "object" literally everywhere in the documentation, but it won't help the reader a lot.

I bet what "Return a property attribute" means is that the returned value is meant to be used as an attribute of a class. (It's obvisouly an object, everything is an object, it's not worth mentionning). Which may not be obvious at first as it's documented in a "list of functions" page (not correlated with the documentation of classes).

Then, a question could be: How that object can work as an attribute of the class? How this property object survives someone affecting the attribute where's it's stored?

The answer is that the returned object implements the descriptor protocol, see https://docs.python.org/3/howto/descriptor.html, and the machinery for the affectation calling the property methods "instead of replacing the property object" is implemented in object.__getattribute__(), I mean this *only* works when the returned object is used as an attribute. A bit of a long sentense to say "it works only when it's an attribute".

So it's useless when not an attribute. So let's call it an attribute?

Bests,
--
Julien Palard
https://mdk.fr


From report at bugs.python.org  Fri Mar 29 05:13:51 2019
From: report at bugs.python.org (Julien Palard)
Date: Fri, 29 Mar 2019 09:13:51 +0000
Subject: [docs] [issue36064] docs: urllib.request.Request not accepting
 iterables data type
In-Reply-To: <1550744621.39.0.0634252256257.issue36064@roundup.psfhosted.org>
Message-ID: <1553850831.01.0.998006086022.issue36064@roundup.psfhosted.org>


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/issue36064>
_______________________________________

From report at bugs.python.org  Fri Mar 29 17:20:17 2019
From: report at bugs.python.org (Eric Snow)
Date: Fri, 29 Mar 2019 21:20:17 +0000
Subject: [docs] [issue36157] Document PyInterpreterState_Main().
In-Reply-To: <1551458200.72.0.727788487318.issue36157@roundup.psfhosted.org>
Message-ID: <1553894417.91.0.053095949943.issue36157@roundup.psfhosted.org>


Eric Snow <ericsnowcurrently at gmail.com> added the comment:

As I noted on the PR, this might be a good chance to make sure the C-API docs are clear about what the "main" interpreter is.

----------

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

From report at bugs.python.org  Sat Mar 30 01:32:11 2019
From: report at bugs.python.org (Inada Naoki)
Date: Sat, 30 Mar 2019 05:32:11 +0000
Subject: [docs] [issue17110] sys.argv docs should explaining how to handle
 encoding issues
In-Reply-To: <1359864071.69.0.659089821533.issue17110@psf.upfronthosting.co.za>
Message-ID: <1553923931.02.0.893244422371.issue17110@roundup.psfhosted.org>


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


New changeset 38f4e468d4b55551e135c67337c18ae142193ba8 by Inada Naoki in branch 'master':
bpo-17110: doc: add note how to get bytes from sys.argv (GH-12602)
https://github.com/python/cpython/commit/38f4e468d4b55551e135c67337c18ae142193ba8


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

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

From report at bugs.python.org  Sat Mar 30 01:32:36 2019
From: report at bugs.python.org (miss-islington)
Date: Sat, 30 Mar 2019 05:32:36 +0000
Subject: [docs] [issue17110] sys.argv docs should explaining how to handle
 encoding issues
In-Reply-To: <1359864071.69.0.659089821533.issue17110@psf.upfronthosting.co.za>
Message-ID: <1553923956.99.0.724272779169.issue17110@roundup.psfhosted.org>


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


----------
pull_requests: +12559

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

From report at bugs.python.org  Sat Mar 30 01:38:17 2019
From: report at bugs.python.org (miss-islington)
Date: Sat, 30 Mar 2019 05:38:17 +0000
Subject: [docs] [issue17110] sys.argv docs should explaining how to handle
 encoding issues
In-Reply-To: <1359864071.69.0.659089821533.issue17110@psf.upfronthosting.co.za>
Message-ID: <1553924297.05.0.62162709237.issue17110@roundup.psfhosted.org>


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


New changeset 5b80cb5584a72044424f2d82d0ae79c720f24c47 by Miss Islington (bot) in branch '3.7':
bpo-17110: doc: add note how to get bytes from sys.argv (GH-12602)
https://github.com/python/cpython/commit/5b80cb5584a72044424f2d82d0ae79c720f24c47


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

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

From report at bugs.python.org  Sat Mar 30 02:25:04 2019
From: report at bugs.python.org (Inada Naoki)
Date: Sat, 30 Mar 2019 06:25:04 +0000
Subject: [docs] [issue17110] sys.argv docs should explaining how to handle
 encoding issues
In-Reply-To: <1359864071.69.0.659089821533.issue17110@psf.upfronthosting.co.za>
Message-ID: <1553927104.19.0.575307997183.issue17110@roundup.psfhosted.org>


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


----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed
versions: +Python 3.7, Python 3.8 -Python 3.2, Python 3.3, Python 3.4

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

From report at bugs.python.org  Sat Mar 30 03:59:38 2019
From: report at bugs.python.org (=?utf-8?q?Luis_Mu=C3=B1oz?=)
Date: Sat, 30 Mar 2019 07:59:38 +0000
Subject: [docs] [issue36483] Missing line in documentation example
Message-ID: <1553932778.03.0.764892422134.issue36483@roundup.psfhosted.org>


New submission from Luis Mu?oz <luismu78 at gmail.com>:

Hi,

https://docs.python.org/3/tutorial/controlflow.html#break-and-continue-statements-and-else-clauses-on-loops

The example is missing a break at the end of the else statement.

First time reporting here. If there is an error in formating or anything else please accept my apologies.

Luis Mu?oz

----------
assignee: docs at python
components: Documentation
messages: 339184
nosy: Luis Mu?oz, docs at python
priority: normal
severity: normal
status: open
title: Missing line in documentation example
type: behavior
versions: Python 3.9

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

From report at bugs.python.org  Sat Mar 30 05:12:02 2019
From: report at bugs.python.org (Martin Panter)
Date: Sat, 30 Mar 2019 09:12:02 +0000
Subject: [docs] [issue36483] Missing line in documentation example
In-Reply-To: <1553932778.03.0.764892422134.issue36483@roundup.psfhosted.org>
Message-ID: <1553937122.96.0.837050715622.issue36483@roundup.psfhosted.org>


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

Did you read the bracketed paragraph directly below, or try running the code with your ?break? statement? I expect it would stop at the first prime number (two). But the output continues with more prime numbers.

----------
nosy: +martin.panter
resolution:  -> not a bug
stage:  -> resolved
status: open -> closed

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

From report at bugs.python.org  Sat Mar 30 08:23:10 2019
From: report at bugs.python.org (Nick Coghlan)
Date: Sat, 30 Mar 2019 12:23:10 +0000
Subject: [docs] [issue30661] Support tarfile.PAX_FORMAT in
 shutil.make_archive
In-Reply-To: <1497403539.2.0.760105950979.issue30661@psf.upfronthosting.co.za>
Message-ID: <1553948590.08.0.960098405907.issue30661@roundup.psfhosted.org>


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

Aye, I agree that changing the default resolves the feature request here. I've recategorised this as a documentation issue, as the initial PR only changed the `tarfile` documentation, so the impact on `shutil` isn't obvious.

So the changes needed will be:

* add a "What's New" entry for shutil, noting that shtuil.make_archive inherited the change in default archive format from tarfile
* corresponding "version changed" note in the shutil.make_archive documentation


An addition to the "Porting" section in What's New may also be needed, depending on how tarfile.Tarfile behaves if you tell it to open a PAX_FORMAT archive using GNU_FORMAT or vice-versa (tarfile.open and shutil.unpack_archive will be fine, since they query the file's own metadata to find out which format to use)

----------
assignee:  -> docs at python
components: +Documentation -Library (Lib)
nosy: +docs at python
stage: patch review -> needs patch

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

From report at bugs.python.org  Sat Mar 30 09:12:53 2019
From: report at bugs.python.org (=?utf-8?q?Luis_Mu=C3=B1oz?=)
Date: Sat, 30 Mar 2019 13:12:53 +0000
Subject: [docs] [issue36483] Missing line in documentation example
In-Reply-To: <1553932778.03.0.764892422134.issue36483@roundup.psfhosted.org>
Message-ID: <1553951573.36.0.52237020837.issue36483@roundup.psfhosted.org>


Luis Mu?oz <luismu78 at gmail.com> added the comment:

My bad. 
Sorry for the inconvenience.

----------

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

From report at bugs.python.org  Sat Mar 30 10:41:13 2019
From: report at bugs.python.org (David Corbett)
Date: Sat, 30 Mar 2019 14:41:13 +0000
Subject: [docs] [issue36486] Bugs and inconsistencies in unicodedata
Message-ID: <1553956873.19.0.268771747568.issue36486@roundup.psfhosted.org>


New submission from David Corbett <corbett.dav at husky.neu.edu>:

In `unicodedata`, the functions `lookup` and `name` have some bugs and inconsistencies.

`lookup` matches case-insensitively, except for the algorithmic names of Hangul syllables and CJK unified ideographs, which must be in all caps. The documentation does not explain how character names are fuzzily matched.

`lookup` accepts names like ?CJK UNIFIED IDEOGRAPH-04E00?, where the code point has a leading zero.

`lookup` and `name` don?t implement rule NR2, defined in chapter 4 of Unicode, for Tangut ideographs? names.

----------
assignee: docs at python
components: Documentation, Unicode
messages: 339203
nosy: docs at python, dscorbett, ezio.melotti, vstinner
priority: normal
severity: normal
status: open
title: Bugs and inconsistencies in unicodedata
type: behavior
versions: Python 3.7

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

From report at bugs.python.org  Sat Mar 30 10:48:43 2019
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Sat, 30 Mar 2019 14:48:43 +0000
Subject: [docs] [issue36486] Bugs and inconsistencies in unicodedata
In-Reply-To: <1553956873.19.0.268771747568.issue36486@roundup.psfhosted.org>
Message-ID: <1553957323.64.0.962735665773.issue36486@roundup.psfhosted.org>


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


----------
nosy: +lemburg

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

From report at bugs.python.org  Sat Mar 30 12:07:43 2019
From: report at bugs.python.org (Joannah Nanjekye)
Date: Sat, 30 Mar 2019 16:07:43 +0000
Subject: [docs] [issue36157] Document PyInterpreterState_Main().
In-Reply-To: <1551458200.72.0.727788487318.issue36157@roundup.psfhosted.org>
Message-ID: <1553962063.34.0.614556163836.issue36157@roundup.psfhosted.org>


Joannah Nanjekye <nanjekyejoannah at gmail.com> added the comment:

I will work on this in a separate PR.

I opened #issue36487 (https://bugs.python.org/issue36487) to track this.

----------

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

From report at bugs.python.org  Sat Mar 30 13:36:23 2019
From: report at bugs.python.org (C.A.M. Gerlach)
Date: Sat, 30 Mar 2019 17:36:23 +0000
Subject: [docs] [issue30661] Support tarfile.PAX_FORMAT in
 shutil.make_archive
In-Reply-To: <1497403539.2.0.760105950979.issue30661@psf.upfronthosting.co.za>
Message-ID: <1553967383.85.0.196009861424.issue30661@roundup.psfhosted.org>


Change by C.A.M. Gerlach <CAM.Gerlach at Gerlach.CAM>:


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

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

From report at bugs.python.org  Sat Mar 30 14:47:13 2019
From: report at bugs.python.org (C.A.M. Gerlach)
Date: Sat, 30 Mar 2019 18:47:13 +0000
Subject: [docs] [issue30661] Support tarfile.PAX_FORMAT in
 shutil.make_archive
In-Reply-To: <1497403539.2.0.760105950979.issue30661@psf.upfronthosting.co.za>
Message-ID: <1553971633.88.0.335638574412.issue30661@roundup.psfhosted.org>


C.A.M. Gerlach <CAM.Gerlach at Gerlach.CAM> added the comment:

I opened a PR to implement both those changes, and also added some minor related clarifications and fixes to the format section of the tarfile docs.

> how tarfile.Tarfile behaves if you tell it to open a PAX_FORMAT archive using GNU_FORMAT or vice-versa

I tested tarfile.Tarfile() and extract_all() on the resulting object with several different simple- to moderately-complex (including Unicode filenames) real-world pax- and GNU-format archives packed with different archivers, with both format=GNU_FORMAT and format=PAX_FORMAT for each one, got no warnings or errors with debug=3 and errorlevel=2, and extraction was successful and yielded identical results for either format argument, and did not get a PAXHEADERS file output for either one. Furthermore, tracing the code, its not clear that Tarfile() (with 'r') and extract, etc. use the passed `format`.

Even if so, in order to produce an error after this change but not before, all of the following would seem to have to be the case:

* The tarfile being read would have to be in GNU format, i.e. from an external source or produced with an older version of Python
* The tarfile would have to make use of specific extended/non-standard GNU tar features not tested above
* The user would have to use Tarfile() to open the tarfile, rather than one of the other, more common/higher-level methods
* The user's call to Tarfile() would have to have used DEFAULT_FORMAT rather than being explicitly specified. and implicitly relied DEFAULT_FORMAT == GNU_FORMAT

Therefore, this seems like a very specific corner-case. However, if you think I should include it, I'll go ahead with it. Also, let me know if these doc changes should have a separate NEWS entry or the previous one adequately covers it.

----------

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

From report at bugs.python.org  Sun Mar 31 00:08:08 2019
From: report at bugs.python.org (C.A.M. Gerlach)
Date: Sun, 31 Mar 2019 04:08:08 +0000
Subject: [docs] [issue36490] Modernize function signature format in
 Archiving section of shutil doc
Message-ID: <1554005288.19.0.789880523073.issue36490@roundup.psfhosted.org>


New submission from C.A.M. Gerlach <CAM.Gerlach at Gerlach.CAM>:

In the process of updating the documentation for another issue, I noticed that unlike the rest of the shutil doc (and the Python docs in general, not to mention those of virtually every Python package), all the functions in the [Archiving operations section](https://docs.python.org/3/library/shutil.html#archiving-operations) uses the old style, difficult to parse nested-bracket notation for the function signatures, rather then the modern style displaying them as they would be expected to appear in Python code, with clearly and explicitly indicated defaults.

Therefore, given all bracketed items are keyword arguments with defaults, and there are no cases more complex then the standard linearly-nested brackets, is there a particular reason why this was retained? Otherwise, I can go ahead and submit a PR to update this.

----------
assignee: docs at python
components: Documentation
messages: 339243
nosy: CAM-Gerlach, docs at python
priority: normal
severity: normal
status: open
title: Modernize function signature format in Archiving section of shutil doc
versions: Python 3.8

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

From report at bugs.python.org  Sun Mar 31 02:19:40 2019
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Sun, 31 Mar 2019 06:19:40 +0000
Subject: [docs] [issue36490] Modernize function signature format in
 Archiving section of shutil doc
In-Reply-To: <1554005288.19.0.789880523073.issue36490@roundup.psfhosted.org>
Message-ID: <1554013180.14.0.564521599469.issue36490@roundup.psfhosted.org>


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


----------
nosy: +giampaolo.rodola, tarek

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