From report at bugs.python.org  Wed Jun  1 03:27:48 2016
From: report at bugs.python.org (Alexander Schrijver)
Date: Wed, 01 Jun 2016 07:27:48 +0000
Subject: [docs] [issue22232] str.splitlines splitting on non-\r\n characters
In-Reply-To: <1408528911.37.0.452679392827.issue22232@psf.upfronthosting.co.za>
Message-ID: <1464766068.05.0.358764336249.issue22232@psf.upfronthosting.co.za>


Alexander Schrijver added the comment:

I appeared to have missed the reference to that issue when I read this issue the first time. Re-opening that issue makes sense to me.

----------

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

From report at bugs.python.org  Wed Jun  1 03:42:29 2016
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 01 Jun 2016 07:42:29 +0000
Subject: [docs] [issue27174] Update URL to IPython in interactive.rst
In-Reply-To: <1464766576.17.0.0548919412603.issue27174@psf.upfronthosting.co.za>
Message-ID: <1464766949.1.0.326051869314.issue27174@psf.upfronthosting.co.za>


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


----------
assignee:  -> docs at python
components: +Documentation -Devguide
keywords: +easy
nosy: +docs at python
stage:  -> needs patch
type: enhancement -> behavior
versions: +Python 2.7, Python 3.5

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

From report at bugs.python.org  Wed Jun  1 03:55:13 2016
From: report at bugs.python.org (Martin Panter)
Date: Wed, 01 Jun 2016 07:55:13 +0000
Subject: [docs] [issue12855] linebreak sequences should be better documented
In-Reply-To: <1314654150.68.0.797504547224.issue12855@psf.upfronthosting.co.za>
Message-ID: <1464767713.18.0.291995761883.issue12855@psf.upfronthosting.co.za>


Martin Panter added the comment:

Reopening to change the Python 2 documentation. A starting point may be Matthew?s patch and/or Alexander?s patch in Issue 22232.

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

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

From report at bugs.python.org  Wed Jun  1 04:29:46 2016
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 01 Jun 2016 08:29:46 +0000
Subject: [docs] [issue25570] urllib.request > Request.add_header("abcd",
 "efgh") fails with character ":" in first parameter string
In-Reply-To: <1446842352.31.0.869437789925.issue25570@psf.upfronthosting.co.za>
Message-ID: <20160601082936.27251.35871.82B25B17@psf.io>


Roundup Robot added the comment:

New changeset 320b9a65ac07 by Martin Panter in branch '3.5':
Issue #25570: Add example of customizing User-Agent via add_header()
https://hg.python.org/cpython/rev/320b9a65ac07

New changeset 75dc64c8c22b by Martin Panter in branch 'default':
Issue #25570: Merge add_header() example from 3.5
https://hg.python.org/cpython/rev/75dc64c8c22b

New changeset 3aa49900869b by Martin Panter in branch '2.7':
Issue #25570: Add example of customizing User-Agent via add_header()
https://hg.python.org/cpython/rev/3aa49900869b

----------
nosy: +python-dev

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

From report at bugs.python.org  Wed Jun  1 05:26:13 2016
From: report at bugs.python.org (Martin Panter)
Date: Wed, 01 Jun 2016 09:26:13 +0000
Subject: [docs] [issue25570] urllib.request > Request.add_header("abcd",
 "efgh") fails with character ":" in first parameter string
In-Reply-To: <1446842352.31.0.869437789925.issue25570@psf.upfronthosting.co.za>
Message-ID: <1464773173.62.0.0508923998187.issue25570@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Wed Jun  1 05:44:04 2016
From: report at bugs.python.org (Martin Panter)
Date: Wed, 01 Jun 2016 09:44:04 +0000
Subject: [docs] [issue12855] linebreak sequences should be better documented
In-Reply-To: <1314654150.68.0.797504547224.issue12855@psf.upfronthosting.co.za>
Message-ID: <1464774244.34.0.193513064908.issue12855@psf.upfronthosting.co.za>


Martin Panter added the comment:

Here is an updated patch for Python 2, based on Benjamin?s commit, Matthew?s earlier py27 patch, and Alexander?s backport of related changes from Python 3. Let me know what you think.

----------
nosy: +Alexander Schrijver
stage: resolved -> patch review
Added file: http://bugs.python.org/file43080/linebreakdoc.v5.py2.7.patch

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

From report at bugs.python.org  Wed Jun  1 12:44:05 2016
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 01 Jun 2016 16:44:05 +0000
Subject: [docs] [issue27174] Update URL to IPython in interactive.rst
In-Reply-To: <1464766576.17.0.0548919412603.issue27174@psf.upfronthosting.co.za>
Message-ID: <20160601164240.17384.89546.AED57B3A@psf.io>


Roundup Robot added the comment:

New changeset 92fd6935e882 by Berker Peksag in branch '3.5':
Issue #27174: Update IPython URL in tutorial
https://hg.python.org/cpython/rev/92fd6935e882

New changeset 87d76611470c by Berker Peksag in branch 'default':
Issue #27174: Merge from 3.5
https://hg.python.org/cpython/rev/87d76611470c

----------
nosy: +python-dev

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

From report at bugs.python.org  Wed Jun  1 12:44:58 2016
From: report at bugs.python.org (Berker Peksag)
Date: Wed, 01 Jun 2016 16:44:58 +0000
Subject: [docs] [issue27174] Update URL to IPython in interactive.rst
In-Reply-To: <1464766576.17.0.0548919412603.issue27174@psf.upfronthosting.co.za>
Message-ID: <1464799498.41.0.927790540202.issue27174@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Thanks for the report, kulla.

----------
nosy: +berker.peksag
resolution:  -> fixed
stage: needs patch -> resolved
status: open -> closed

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

From report at bugs.python.org  Wed Jun  1 14:16:38 2016
From: report at bugs.python.org (Berker Peksag)
Date: Wed, 01 Jun 2016 18:16:38 +0000
Subject: [docs] [issue23116] Python Tutorial 4.7.1: Improve ask_ok() to
 cover more input values
In-Reply-To: <1419622934.77.0.489991713093.issue23116@psf.upfronthosting.co.za>
Message-ID: <1464804998.38.0.785306512961.issue23116@psf.upfronthosting.co.za>


Berker Peksag added the comment:

I agree with all of Carol's suggestions. Also, OSError could be replaced with a more appropriate exception such as ValueError.

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

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

From report at bugs.python.org  Wed Jun  1 14:22:19 2016
From: report at bugs.python.org (Fred L. Drake, Jr.)
Date: Wed, 01 Jun 2016 18:22:19 +0000
Subject: [docs] [issue23116] Python Tutorial 4.7.1: Improve ask_ok() to
 cover more input values
In-Reply-To: <1419622934.77.0.489991713093.issue23116@psf.upfronthosting.co.za>
Message-ID: <1464805339.5.0.327707409651.issue23116@psf.upfronthosting.co.za>


Fred L. Drake, Jr. added the comment:

+1 for ValueError instead of OSError.

----------
nosy: +fdrake

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

From report at bugs.python.org  Wed Jun  1 14:27:34 2016
From: report at bugs.python.org (Berker Peksag)
Date: Wed, 01 Jun 2016 18:27:34 +0000
Subject: [docs] [issue23116] Python Tutorial 4.7.1: Improve ask_ok() to
 cover more input values
In-Reply-To: <1419622934.77.0.489991713093.issue23116@psf.upfronthosting.co.za>
Message-ID: <1464805654.2.0.37188254898.issue23116@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Here is a patch.

----------
keywords: +patch
stage: needs patch -> patch review
Added file: http://bugs.python.org/file43088/issue23116.diff

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

From report at bugs.python.org  Wed Jun  1 14:43:46 2016
From: report at bugs.python.org (Terry J. Reedy)
Date: Wed, 01 Jun 2016 18:43:46 +0000
Subject: [docs] [issue22558] Missing doc links to source code for
 Python-coded modules.
In-Reply-To: <1412514337.47.0.069385783283.issue22558@psf.upfronthosting.co.za>
Message-ID: <1464806626.76.0.511929547993.issue22558@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

[David, could this be a sprint issue?] 

Here is the difference between python and C coded modules.  The x.y docs are for all implementations of x.y.  The python-coded modules are intended for use by all implementations, perhaps with minor modifications.  In any case, the users of all implementation can presumably read Python code.  The C implementations used by CPython are specific to CPython, and not necessarily meaningful to user of Jython, IronPython, PyPy, or any other alternatives.

In any case, Guido has unambiguiously pronounced on linking to Python source files.  Doing that is enough for one issue.  I changed the title to be specific.

----------
title: Missing doc links to source code -> Missing doc links to source code for Python-coded modules.

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

From report at bugs.python.org  Wed Jun  1 16:17:17 2016
From: report at bugs.python.org (R. David Murray)
Date: Wed, 01 Jun 2016 20:17:17 +0000
Subject: [docs] [issue22558] Missing doc links to source code for
 Python-coded modules.
In-Reply-To: <1412514337.47.0.069385783283.issue22558@psf.upfronthosting.co.za>
Message-ID: <1464812237.77.0.237890123433.issue22558@psf.upfronthosting.co.za>


R. David Murray added the comment:

You mean someone doing a file review at the sprints?  I can add it to the list.  No guarantees about it getting committed at the sprints, though.

If we are linking to the python version of modules that have both python and C versions, IMO the existence of the C version should be noted as a CPython implementation detail, since otherwise someone might think that the python code was what CPython was actually running.

----------

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

From report at bugs.python.org  Wed Jun  1 16:19:48 2016
From: report at bugs.python.org (R. David Murray)
Date: Wed, 01 Jun 2016 20:19:48 +0000
Subject: [docs] [issue22558] Missing doc links to source code for
 Python-coded modules.
In-Reply-To: <1412514337.47.0.069385783283.issue22558@psf.upfronthosting.co.za>
Message-ID: <1464812388.86.0.1762677869.issue22558@psf.upfronthosting.co.za>


R. David Murray added the comment:

I meant full review, not file review.

----------

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

From report at bugs.python.org  Wed Jun  1 17:20:04 2016
From: report at bugs.python.org (Nathan Harold)
Date: Wed, 01 Jun 2016 21:20:04 +0000
Subject: [docs] [issue27178] Unconverted RST marking in interpreter tutorial
Message-ID: <1464816004.4.0.533842963669.issue27178@psf.upfronthosting.co.za>


New submission from Nathan Harold:

There's a bit of uninterpreted RST markup:

3.6.. _tut-using:

at the top of the second section of the tutorial (https://docs.python.org/3.6/tutorial/interpreter.html) in the documentation for 3.6 only.  (I can see this in the offline copy I received with 3.6.0a1 as well.)

It appears that this originated in 96328:dfe62f685538, which changed various references to Python to say 3.6 instead of 3.5.  This line had formerly just said:

.. _tut-using:

My best guess is that this was just an accident.  I can't find a precedent or meaning for the changed notation, and there were no similar changes to any other files, either.  I've included a patch for this line.

----------
assignee: docs at python
components: Documentation
files: fix.diff
keywords: patch
messages: 266840
nosy: docs at python, nharold
priority: normal
severity: normal
status: open
title: Unconverted RST marking in interpreter tutorial
type: enhancement
versions: Python 3.6
Added file: http://bugs.python.org/file43093/fix.diff

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

From report at bugs.python.org  Wed Jun  1 17:28:26 2016
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 01 Jun 2016 21:28:26 +0000
Subject: [docs] [issue27178] Unconverted RST marking in interpreter tutorial
In-Reply-To: <1464816004.4.0.533842963669.issue27178@psf.upfronthosting.co.za>
Message-ID: <20160601212758.37256.15555.E70582A3@psf.io>


Roundup Robot added the comment:

New changeset a2ffc966363e by Berker Peksag in branch 'default':
Issue #27178: Fix markup in tutorial
https://hg.python.org/cpython/rev/a2ffc966363e

----------
nosy: +python-dev

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

From report at bugs.python.org  Wed Jun  1 17:29:08 2016
From: report at bugs.python.org (Berker Peksag)
Date: Wed, 01 Jun 2016 21:29:08 +0000
Subject: [docs] [issue27178] Unconverted RST marking in interpreter tutorial
In-Reply-To: <1464816004.4.0.533842963669.issue27178@psf.upfronthosting.co.za>
Message-ID: <1464816548.06.0.999139939823.issue27178@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Good catch! Thanks for patch, Nathan.

----------
nosy: +berker.peksag
resolution:  -> fixed
stage:  -> resolved
status: open -> closed
type: enhancement -> behavior

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

From report at bugs.python.org  Wed Jun  1 18:55:27 2016
From: report at bugs.python.org (R. David Murray)
Date: Wed, 01 Jun 2016 22:55:27 +0000
Subject: [docs] [issue26582] asyncio documentation links to wrong
 CancelledError
In-Reply-To: <1458225953.38.0.399231880747.issue26582@psf.upfronthosting.co.za>
Message-ID: <1464821727.45.0.149216422892.issue26582@psf.upfronthosting.co.za>


R. David Murray added the comment:

ping: Victor or Yuri, do agree that asyncio.CancelledError should be documented?  I know that this duality has confused me in the past as well.  I don't know if having it documented would have helped me ahead of time, but at least it could have cleared up my puzzlement as to why I was seeing a concurrent.futures exception when I didn't think I was using concurrent.futures :)

I do wonder what the OPs actual problem was with catching the exception.

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

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

From report at bugs.python.org  Wed Jun  1 19:44:20 2016
From: report at bugs.python.org (R. David Murray)
Date: Wed, 01 Jun 2016 23:44:20 +0000
Subject: [docs] [issue25931] os.fork() command distributed in windows
 Python27 (in SocketServer module)
In-Reply-To: <1450840231.57.0.83917358919.issue25931@psf.upfronthosting.co.za>
Message-ID: <1464824660.02.0.142857444956.issue25931@psf.upfronthosting.co.za>


R. David Murray added the comment:

They aren't currently defined conditionally, though, and haven't ever been, so I'm not sure it is worth chaning that.  However, we should probably add an 'availability' line, since they aren't (effectively) available on Windows.

----------
assignee:  -> docs at python
components: +Documentation -Library (Lib), Windows
nosy: +docs at python, r.david.murray
stage:  -> needs patch

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

From report at bugs.python.org  Wed Jun  1 19:46:25 2016
From: report at bugs.python.org (Terry J. Reedy)
Date: Wed, 01 Jun 2016 23:46:25 +0000
Subject: [docs] [issue22558] Missing doc links to source code for
 Python-coded modules.
In-Reply-To: <1412514337.47.0.069385783283.issue22558@psf.upfronthosting.co.za>
Message-ID: <1464824785.83.0.780456744315.issue22558@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

If someone does a full review (looks at each diff in Rietveld to see if it matches the intended format -- see Yoni's 4-19 message, with
:source:`Lib/mod.py` (lib2to3 is an exception) following **Source code:**
-- and then downloads patch, applies, builds new html doc, and tests a few of the new links, and find nothing wrong, and says 'ready for commit review) then I may take this, re-check, and commit.

----------

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

From report at bugs.python.org  Wed Jun  1 19:59:07 2016
From: report at bugs.python.org (Yoni Lavi)
Date: Wed, 01 Jun 2016 23:59:07 +0000
Subject: [docs] [issue22558] Missing doc links to source code for
 Python-coded modules.
In-Reply-To: <1412514337.47.0.069385783283.issue22558@psf.upfronthosting.co.za>
Message-ID: <1464825547.01.0.242686554165.issue22558@psf.upfronthosting.co.za>


Yoni Lavi added the comment:

Thank you for looking at this.

David, concerning modules that have multiple sources, are you referring to modules such as `stat` and `heapq`? In these, it's the Python source that tries to import the C module if it's available, so I'd consider it ok to leave just a link to the Python source.

----------

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

From report at bugs.python.org  Wed Jun  1 20:30:10 2016
From: report at bugs.python.org (R. David Murray)
Date: Thu, 02 Jun 2016 00:30:10 +0000
Subject: [docs] [issue22558] Missing doc links to source code for
 Python-coded modules.
In-Reply-To: <1412514337.47.0.069385783283.issue22558@psf.upfronthosting.co.za>
Message-ID: <1464827410.05.0.962048021123.issue22558@psf.upfronthosting.co.za>


R. David Murray added the comment:

Yes, those should be OK.  I was thinking of _pyio and _pydecimal, but I don't know if you are linking to those.

----------

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

From report at bugs.python.org  Wed Jun  1 21:16:29 2016
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 02 Jun 2016 01:16:29 +0000
Subject: [docs] [issue12243] getpass.getuser works on OSX
In-Reply-To: <1307029704.02.0.858553376312.issue12243@psf.upfronthosting.co.za>
Message-ID: <20160602011624.79366.6148.4969F37A@psf.io>


Roundup Robot added the comment:

New changeset c13198a2007e by Berker Peksag in branch '3.5':
Issue #12243: Remove redundant availability notes from getpass docs
https://hg.python.org/cpython/rev/c13198a2007e

New changeset 1bd3daae351d by Berker Peksag in branch 'default':
Issue #12243: Merge from 3.5
https://hg.python.org/cpython/rev/1bd3daae351d

----------
nosy: +python-dev

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

From report at bugs.python.org  Wed Jun  1 21:18:30 2016
From: report at bugs.python.org (Berker Peksag)
Date: Thu, 02 Jun 2016 01:18:30 +0000
Subject: [docs] [issue12243] getpass.getuser works on OSX
In-Reply-To: <1307029704.02.0.858553376312.issue12243@psf.upfronthosting.co.za>
Message-ID: <1464830310.74.0.780069243914.issue12243@psf.upfronthosting.co.za>


Berker Peksag added the comment:

See issue 11233 for the availability directive patch. Thanks for the patch, Bryce.

----------
nosy: +berker.peksag
resolution:  -> fixed
stage:  -> resolved
status: open -> closed
type:  -> behavior
versions: +Python 3.6 -Python 3.4

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

From report at bugs.python.org  Wed Jun  1 21:20:30 2016
From: report at bugs.python.org (Yoni Lavi)
Date: Thu, 02 Jun 2016 01:20:30 +0000
Subject: [docs] [issue22558] Missing doc links to source code for
 Python-coded modules.
In-Reply-To: <1412514337.47.0.069385783283.issue22558@psf.upfronthosting.co.za>
Message-ID: <1464830430.0.0.982129800794.issue22558@psf.upfronthosting.co.za>


Yoni Lavi added the comment:

Ah, thanks for the explanation. I think in this case we're ok too.
I linked io.rst to Lib/io.py, which relies on the C version. And in the case of decimal.rst, it was already linked to Lib/decimal.py which very explicitly attempts to load the C version and falls back to _pydecimal.

----------

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

From report at bugs.python.org  Wed Jun  1 21:23:18 2016
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 02 Jun 2016 01:23:18 +0000
Subject: [docs] [issue12243] getpass.getuser works on OSX
In-Reply-To: <1307029704.02.0.858553376312.issue12243@psf.upfronthosting.co.za>
Message-ID: <20160602012313.4689.84904.AC566C7C@psf.io>


Roundup Robot added the comment:

New changeset 98870f27d2ed by Berker Peksag in branch '2.7':
Issue #12243: Remove redundant availability notes from getpass docs
https://hg.python.org/cpython/rev/98870f27d2ed

----------

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

From report at bugs.python.org  Wed Jun  1 21:59:50 2016
From: report at bugs.python.org (Berker Peksag)
Date: Thu, 02 Jun 2016 01:59:50 +0000
Subject: [docs] [issue22374] Replace contextmanager example and improve
 explanation
In-Reply-To: <1410296292.35.0.34327651623.issue22374@psf.upfronthosting.co.za>
Message-ID: <1464832790.37.0.394024083058.issue22374@psf.upfronthosting.co.za>


Berker Peksag added the comment:

We also have swap_attr() and swap_item() helpers in Lib/test/support/__init__.py. I've used a simplified version of swap_attr() in my patch.

Since this is basically a document improvement I removed Python 2.7 from the versions field.

----------
keywords: +patch
nosy: +berker.peksag
stage:  -> patch review
type:  -> enhancement
versions: +Python 3.6 -Python 2.7, Python 3.4
Added file: http://bugs.python.org/file43095/issue22374.diff

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

From report at bugs.python.org  Wed Jun  1 22:03:14 2016
From: report at bugs.python.org (Berker Peksag)
Date: Thu, 02 Jun 2016 02:03:14 +0000
Subject: [docs] [issue8519] doc: termios and ioctl reference links
In-Reply-To: <1272125391.54.0.0119716465224.issue8519@psf.upfronthosting.co.za>
Message-ID: <1464832994.51.0.0553012008939.issue8519@psf.upfronthosting.co.za>


Berker Peksag added the comment:

+1 for using the manpage directives.

----------
keywords: +easy
nosy: +berker.peksag
stage:  -> needs patch
type:  -> enhancement
versions: +Python 3.5, Python 3.6

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

From report at bugs.python.org  Wed Jun  1 22:12:19 2016
From: report at bugs.python.org (Berker Peksag)
Date: Thu, 02 Jun 2016 02:12:19 +0000
Subject: [docs] [issue20693] Sidebar scrolls down 2x as fast as page content
In-Reply-To: <1392854470.16.0.730014647108.issue20693@psf.upfronthosting.co.za>
Message-ID: <1464833539.47.0.181668925459.issue20693@psf.upfronthosting.co.za>


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


----------
status: pending -> closed

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

From report at bugs.python.org  Wed Jun  1 22:46:18 2016
From: report at bugs.python.org (Berker Peksag)
Date: Thu, 02 Jun 2016 02:46:18 +0000
Subject: [docs] [issue18085] Verifying refcounts.dat
In-Reply-To: <1369768958.38.0.697954786488.issue18085@psf.upfronthosting.co.za>
Message-ID: <1464835578.33.0.107196013603.issue18085@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Can we now close this as a duplicate of issue 9755?

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

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

From report at bugs.python.org  Wed Jun  1 22:55:07 2016
From: report at bugs.python.org (Berker Peksag)
Date: Thu, 02 Jun 2016 02:55:07 +0000
Subject: [docs] [issue18384] Add devhelp build instructions to the
 documentation makefile
In-Reply-To: <1373126872.99.0.196855788769.issue18384@psf.upfronthosting.co.za>
Message-ID: <1464836107.37.0.252170816055.issue18384@psf.upfronthosting.co.za>


Berker Peksag added the comment:

I think we should avoid adding distro specific tools into CPython repository (and the another reason to reject this is that the other distros will probably want to add their tools).

----------
nosy: +berker.peksag
resolution:  -> rejected
stage: patch review -> resolved
status: open -> closed

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

From report at bugs.python.org  Wed Jun  1 23:03:40 2016
From: report at bugs.python.org (Fred L. Drake, Jr.)
Date: Thu, 02 Jun 2016 03:03:40 +0000
Subject: [docs] [issue9755] Fix refcounting details in Py3k C API
 documentation
In-Reply-To: <1283514224.53.0.325600320074.issue9755@psf.upfronthosting.co.za>
Message-ID: <1464836619.98.0.0909618144409.issue9755@psf.upfronthosting.co.za>


Fred L. Drake, Jr. added the comment:

As mentioned in issue 18085, the original file was not generated, but crafted by hand (though I don't think that really matters).

----------

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

From report at bugs.python.org  Wed Jun  1 23:07:53 2016
From: report at bugs.python.org (Fred L. Drake, Jr.)
Date: Thu, 02 Jun 2016 03:07:53 +0000
Subject: [docs] [issue18085] Verifying refcounts.dat
In-Reply-To: <1369768958.38.0.697954786488.issue18085@psf.upfronthosting.co.za>
Message-ID: <1464836873.65.0.268583975721.issue18085@psf.upfronthosting.co.za>


Fred L. Drake, Jr. added the comment:

I don't think this is a duplicate of issue 9755; this relates to verifying the data, and that revolves around possible process improvements.

Whether this issue should be closed is tied to whether the file has been verified, as the issue title suggests.

I don't know whether Serhiy verified everything when he made his changes or not; that's not explicit in the issue or commit comments.

----------

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

From report at bugs.python.org  Thu Jun  2 03:43:49 2016
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 02 Jun 2016 07:43:49 +0000
Subject: [docs] [issue18085] Verifying refcounts.dat
In-Reply-To: <1369768958.38.0.697954786488.issue18085@psf.upfronthosting.co.za>
Message-ID: <1464853429.62.0.922279667476.issue18085@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

No, I hadn't verified all names. I'm sure there are API functions not mentioned in refcounts.dat.

See also issue23903. It would be nice to have a tool that parses Python source headers and produce lists of all public names in different formats for manual updating python3.def, refcounts.dat, docs, etc.

----------

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

From report at bugs.python.org  Thu Jun  2 05:14:36 2016
From: report at bugs.python.org (STINNER Victor)
Date: Thu, 02 Jun 2016 09:14:36 +0000
Subject: [docs] [issue26582] asyncio documentation links to wrong
 CancelledError
In-Reply-To: <1464821727.45.0.149216422892.issue26582@psf.upfronthosting.co.za>
Message-ID: <CAMpsgwaUGi7hFeik9j8SUpKmgK5LKqvvehb+_ORbk6Hk0gtCFw@mail.gmail.com>


STINNER Victor added the comment:

> do agree that asyncio.CancelledError should be documented?

Yes, I would prefer to get the exception from asyncio, even if it is
officially an alias to an exception of a different module.

It would be surprising to have to import concurrent.futures in a
module written for asyncio, just to catch this exception.

----------

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

From report at bugs.python.org  Thu Jun  2 07:18:19 2016
From: report at bugs.python.org (Masato HASHIMOTO)
Date: Thu, 02 Jun 2016 11:18:19 +0000
Subject: [docs] [issue27180] Doc/pathlib: Please describe the behaviour of
 Path().rename() is depends on the platform (same as os.rename())
Message-ID: <1464866299.22.0.549959469595.issue27180@psf.upfronthosting.co.za>


New submission from Masato HASHIMOTO:

The behavior of Path().rename() is same as os.rename() (replaces silently if dest file is already existent on Unix) but it's difficult to catch from current pathlib documentation (I found it from source of pathlib) from comparing with replace().

IMHO, it should be described on pathlilb documentation.

----------
assignee: docs at python
components: Documentation
messages: 266883
nosy: docs at python, hashimo
priority: normal
severity: normal
status: open
title: Doc/pathlib: Please describe the behaviour of Path().rename()  is depends on the platform (same as os.rename())
type: enhancement
versions: Python 3.4, Python 3.5, Python 3.6

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

From report at bugs.python.org  Thu Jun  2 11:38:44 2016
From: report at bugs.python.org (Berker Peksag)
Date: Thu, 02 Jun 2016 15:38:44 +0000
Subject: [docs] [issue27180] Doc/pathlib: Please describe the behaviour of
 Path().rename() is depends on the platform (same as os.rename())
In-Reply-To: <1464866299.22.0.549959469595.issue27180@psf.upfronthosting.co.za>
Message-ID: <1464881924.79.0.619727393349.issue27180@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Jun  2 12:51:11 2016
From: report at bugs.python.org (Benjamin Peterson)
Date: Thu, 02 Jun 2016 16:51:11 +0000
Subject: [docs] [issue23116] Python Tutorial 4.7.1: Improve ask_ok() to
 cover more input values
In-Reply-To: <1419622934.77.0.489991713093.issue23116@psf.upfronthosting.co.za>
Message-ID: <1464886271.4.0.128202283518.issue23116@psf.upfronthosting.co.za>


Benjamin Peterson added the comment:

I think the patch is okay except for the use of "-=" instead of the more verbose version.

----------
nosy: +benjamin.peterson

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

From report at bugs.python.org  Thu Jun  2 13:05:51 2016
From: report at bugs.python.org (Nathan Harold)
Date: Thu, 02 Jun 2016 17:05:51 +0000
Subject: [docs] [issue22558] Missing doc links to source code for
 Python-coded modules.
In-Reply-To: <1412514337.47.0.069385783283.issue22558@psf.upfronthosting.co.za>
Message-ID: <1464887151.41.0.489400346126.issue22558@psf.upfronthosting.co.za>


Changes by Nathan Harold <penw81-ml at yahoo.com>:


----------
nosy: +nharold

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

From report at bugs.python.org  Thu Jun  2 13:21:48 2016
From: report at bugs.python.org (Petr Viktorin)
Date: Thu, 02 Jun 2016 17:21:48 +0000
Subject: [docs] [issue27183] Clarify that Py_VISIT(NULL) does nothing
Message-ID: <1464888108.12.0.251087616908.issue27183@psf.upfronthosting.co.za>


New submission from Petr Viktorin:

The Py_VISIT macro (in Include/objimpl.h) does nothing if passed NULL (and did this since its introduction). It would be nice to have this formally documented.

----------
assignee: docs at python
components: Documentation
files: 0001-Doc-c-api-Clarify-that-Py_VISIT-NULL-does-nothing.patch
keywords: patch
messages: 266894
nosy: docs at python, encukou, eric.araujo, ezio.melotti, georg.brandl
priority: normal
severity: normal
status: open
title: Clarify that Py_VISIT(NULL) does nothing
type: enhancement
versions: Python 3.6
Added file: http://bugs.python.org/file43102/0001-Doc-c-api-Clarify-that-Py_VISIT-NULL-does-nothing.patch

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

From report at bugs.python.org  Thu Jun  2 13:48:33 2016
From: report at bugs.python.org (Kushal Das)
Date: Thu, 02 Jun 2016 17:48:33 +0000
Subject: [docs] [issue19234] socket.fileno() documentation
In-Reply-To: <52597A2F.60807@python.org>
Message-ID: <1464889713.78.0.715870060362.issue19234@psf.upfronthosting.co.za>


Kushal Das added the comment:

Adds more lines to explain the behavior of socket.fileno() in  case of error.

----------
keywords: +patch
nosy: +kushal.das
Added file: http://bugs.python.org/file43103/issue19234.patch

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

From report at bugs.python.org  Thu Jun  2 14:21:35 2016
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 02 Jun 2016 18:21:35 +0000
Subject: [docs] [issue23116] Python Tutorial 4.7.1: Improve ask_ok() to
 cover more input values
In-Reply-To: <1419622934.77.0.489991713093.issue23116@psf.upfronthosting.co.za>
Message-ID: <20160602182123.10466.67512.0CE51CEE@psf.io>


Roundup Robot added the comment:

New changeset ef800c30e28c by Berker Peksag in branch '3.5':
Issue #23116: Improve ask_ok() example in the Python tutorial
https://hg.python.org/cpython/rev/ef800c30e28c

New changeset 174eae50b664 by Berker Peksag in branch 'default':
Issue #23116: Merge from 3.5
https://hg.python.org/cpython/rev/174eae50b664

----------
nosy: +python-dev

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

From report at bugs.python.org  Thu Jun  2 14:22:47 2016
From: report at bugs.python.org (Berker Peksag)
Date: Thu, 02 Jun 2016 18:22:47 +0000
Subject: [docs] [issue23116] Python Tutorial 4.7.1: Improve ask_ok() to
 cover more input values
In-Reply-To: <1419622934.77.0.489991713093.issue23116@psf.upfronthosting.co.za>
Message-ID: <1464891766.92.0.652160411633.issue23116@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Thanks for the review. I removed the "-=" part from the patch.

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

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

From report at bugs.python.org  Thu Jun  2 14:36:35 2016
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 02 Jun 2016 18:36:35 +0000
Subject: [docs] [issue27183] Clarify that Py_VISIT(NULL) does nothing
In-Reply-To: <1464888108.12.0.251087616908.issue27183@psf.upfronthosting.co.za>
Message-ID: <20160602183622.70607.53975.1B2227EA@psf.io>


Roundup Robot added the comment:

New changeset 7c67cb3b54b4 by Benjamin Peterson in branch '3.5':
note that Py_VISIT handles NULL (closes #27183)
https://hg.python.org/cpython/rev/7c67cb3b54b4

New changeset 42356e44af23 by Benjamin Peterson in branch '2.7':
note that Py_VISIT handles NULL (closes #27183)
https://hg.python.org/cpython/rev/42356e44af23

----------
nosy: +python-dev
resolution:  -> fixed
stage:  -> resolved
status: open -> closed

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

From report at bugs.python.org  Thu Jun  2 14:53:40 2016
From: report at bugs.python.org (Berker Peksag)
Date: Thu, 02 Jun 2016 18:53:40 +0000
Subject: [docs] [issue21196] Name mangling example in Python tutorial
In-Reply-To: <1397133080.37.0.870141660622.issue21196@psf.upfronthosting.co.za>
Message-ID: <1464893620.51.0.853337121316.issue21196@psf.upfronthosting.co.za>


Berker Peksag added the comment:

I think the text is fine, but the example is not needed. I've updated Chandan's patch to remove the example and tweak the text a bit.

----------
nosy: +berker.peksag
versions: +Python 3.6 -Python 3.4
Added file: http://bugs.python.org/file43108/issue21196.diff

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

From report at bugs.python.org  Thu Jun  2 14:54:05 2016
From: report at bugs.python.org (Emily Morehouse)
Date: Thu, 02 Jun 2016 18:54:05 +0000
Subject: [docs] [issue13784] Documentation of xml.sax.xmlreader:
 Locator.getLineNumber() and Locator.getColumnNumber()
In-Reply-To: <1326542534.95.0.205057982858.issue13784@psf.upfronthosting.co.za>
Message-ID: <1464893645.68.0.444049844146.issue13784@psf.upfronthosting.co.za>


Emily Morehouse added the comment:

The reported behavior has been verified -- the documented behavior is indeed incorrect for both Locator.getColumnNumber() and Locator.getLineNumber(). The beginning line and column numbers are returned, not the end.

This has been tested and verified for Python 2.7, Python 3.5.1 and a local build of the current default branch.

----------
keywords: +patch
nosy: +emilyemorehouse
versions: +Python 2.7, Python 3.2, Python 3.3, Python 3.6
Added file: http://bugs.python.org/file43109/13784.patch

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

From report at bugs.python.org  Thu Jun  2 15:04:47 2016
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 02 Jun 2016 19:04:47 +0000
Subject: [docs] [issue22374] Replace contextmanager example and improve
 explanation
In-Reply-To: <1410296292.35.0.34327651623.issue22374@psf.upfronthosting.co.za>
Message-ID: <1464894287.44.0.500979624604.issue22374@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

swap_attr() looks too general. I think something more concrete would be better. But the documentation already contain other examples for contextmanager. closing() is good example, and redirect_stdout() would be good example.

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

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

From report at bugs.python.org  Thu Jun  2 15:19:33 2016
From: report at bugs.python.org (R. David Murray)
Date: Thu, 02 Jun 2016 19:19:33 +0000
Subject: [docs] [issue13784] Documentation of xml.sax.xmlreader:
 Locator.getLineNumber() and Locator.getColumnNumber()
In-Reply-To: <1326542534.95.0.205057982858.issue13784@psf.upfronthosting.co.za>
Message-ID: <1464895173.73.0.987565893811.issue13784@psf.upfronthosting.co.za>


R. David Murray added the comment:

Thanks Emily.  For some reason the auto update of the tracker doesn't seem to have worked.  Maybe it is just delayed, but in case, the commit hashes are 2.7 97b76fe183f4, 3.5 9d6a9e2ae18b, and 3.6 cce04851d2e2.

----------
nosy: +r.david.murray
resolution:  -> fixed
stage:  -> resolved
status: open -> closed
versions:  -Python 3.2, Python 3.3, Python 3.4

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

From report at bugs.python.org  Thu Jun  2 15:20:18 2016
From: report at bugs.python.org (Emily Morehouse)
Date: Thu, 02 Jun 2016 19:20:18 +0000
Subject: [docs] [issue26829] update docs: when creating classes a new dict
 is created for the final class object
In-Reply-To: <1461333834.83.0.0321229546915.issue26829@psf.upfronthosting.co.za>
Message-ID: <1464895218.65.0.163481766099.issue26829@psf.upfronthosting.co.za>


Emily Morehouse added the comment:

Super straight-forward -- this simply adds to the docs on creating the class object that the values used in creation are copied to the final object (including the namespace).

----------
keywords: +patch
nosy: +emilyemorehouse
Added file: http://bugs.python.org/file43112/26829.patch

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

From report at bugs.python.org  Thu Jun  2 15:22:36 2016
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 02 Jun 2016 19:22:36 +0000
Subject: [docs] [issue13784] Documentation of xml.sax.xmlreader:
 Locator.getLineNumber() and Locator.getColumnNumber()
In-Reply-To: <1326542534.95.0.205057982858.issue13784@psf.upfronthosting.co.za>
Message-ID: <20160602191539.4968.98542.24BA9CCA@psf.io>


Roundup Robot added the comment:

New changeset 97b76fe183f4 by R David Murray in branch '2.7':
#13784: fix xml.sax.reader getColumn/LineNumber docs.
https://hg.python.org/cpython/rev/97b76fe183f4

New changeset 9d6a9e2ae18b by R David Murray in branch '3.5':
#13784: fix xml.sax.reader getColumn/LineNumber docs.
https://hg.python.org/cpython/rev/9d6a9e2ae18b

New changeset cce04851d2e2 by R David Murray in branch 'default':
Merge: #13784: fix xml.sax.reader getColumn/LineNumber docs.
https://hg.python.org/cpython/rev/cce04851d2e2

----------
nosy: +python-dev

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

From report at bugs.python.org  Thu Jun  2 16:04:22 2016
From: report at bugs.python.org (Zachary Ware)
Date: Thu, 02 Jun 2016 20:04:22 +0000
Subject: [docs] [issue19234] socket.fileno() documentation
In-Reply-To: <52597A2F.60807@python.org>
Message-ID: <1464897862.7.0.840064945368.issue19234@psf.upfronthosting.co.za>


Zachary Ware added the comment:

I think the additions are redundant; pick one or the other.  The first should be sufficient.

----------
nosy: +zach.ware
stage:  -> patch review
versions: +Python 2.7, Python 3.5, Python 3.6

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

From report at bugs.python.org  Thu Jun  2 16:10:21 2016
From: report at bugs.python.org (R. David Murray)
Date: Thu, 02 Jun 2016 20:10:21 +0000
Subject: [docs] [issue26829] update docs: when creating classes a new dict
 is created for the final class object
In-Reply-To: <1461333834.83.0.0321229546915.issue26829@psf.upfronthosting.co.za>
Message-ID: <1464898221.11.0.044145661089.issue26829@psf.upfronthosting.co.za>


R. David Murray added the comment:

Your suggested wording isn't correct, I'm afraid.  This subject is complex and somewhat obscure...I checked with Ethan to make sure my interpretation was correct.  The problem this issue is addressing is the fact that when type.__new__ is called (as in the metaclass example), whatever is passed in as the namespace has its *contents* copied into a new, standard python dict, and the original namespace object is discarded.  The metaclass example does this explicitly (by doing dict(namespace), but in fact type.__new__ does it implicitly (which IMO makes that example a bit confusing).

Also, that namespace is the only state.  The metaclass example obscures that by doing an attribute assignment after calling type.__new__, but that attribute assignment is actually updating the __dict__ of the new object ('result'), which is that new python dict containing the contents of namespace.

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

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

From report at bugs.python.org  Thu Jun  2 17:07:12 2016
From: report at bugs.python.org (Barry A. Warsaw)
Date: Thu, 02 Jun 2016 21:07:12 +0000
Subject: [docs] [issue27187] Relax __all__ location requirement in PEP 8
In-Reply-To: <1464901602.05.0.802918160149.issue27187@psf.upfronthosting.co.za>
Message-ID: <1464901632.07.0.744214669333.issue27187@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Jun  2 17:09:49 2016
From: report at bugs.python.org (Dave Sawyer)
Date: Thu, 02 Jun 2016 21:09:49 +0000
Subject: [docs] [issue27113] sqlite3 connect parameter "check_same_thread"
 not documented
In-Reply-To: <1464125789.84.0.570004715823.issue27113@psf.upfronthosting.co.za>
Message-ID: <1464901789.26.0.473579210948.issue27113@psf.upfronthosting.co.za>


Dave Sawyer added the comment:

The user probably has a recent enough version. This is guaranteed on Windows since Python bundles 3.6 or later. On mac or Linux it will use the version installed on the machine. I'll make a separate patch to check the version in sqlite3.py so it will give an error if attempted on too early a version. That's better than asking the user to verify ahead of time. The serialized mode is default on both Mac and Windows so we can probably skip validating that. I did like mentioning the user needs to serialize the writes. They could use one thread for writing only or use locking. So, I just said to serialize.

----------
Added file: http://bugs.python.org/file43116/sqlite_patch2.txt

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

From report at bugs.python.org  Thu Jun  2 17:12:53 2016
From: report at bugs.python.org (Dave Sawyer)
Date: Thu, 02 Jun 2016 21:12:53 +0000
Subject: [docs] [issue27113] sqlite3 connect parameter "check_same_thread"
 not documented
In-Reply-To: <1464125789.84.0.570004715823.issue27113@psf.upfronthosting.co.za>
Message-ID: <1464901973.37.0.107360021328.issue27113@psf.upfronthosting.co.za>


Dave Sawyer added the comment:

Changed doc to note that not only must it be used on 1 thread if true, but that thread must be the thread that created it.

----------

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

From report at bugs.python.org  Thu Jun  2 17:14:06 2016
From: report at bugs.python.org (Ian Lee)
Date: Thu, 02 Jun 2016 21:14:06 +0000
Subject: [docs] [issue27187] Relax __all__ location requirement in PEP 8
In-Reply-To: <1464901602.05.0.802918160149.issue27187@psf.upfronthosting.co.za>
Message-ID: <1464902046.73.0.067665642848.issue27187@psf.upfronthosting.co.za>


Changes by Ian Lee <ianlee1521 at gmail.com>:


----------
nosy: +IanLee1521

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

From report at bugs.python.org  Thu Jun  2 17:14:22 2016
From: report at bugs.python.org (Senthil Kumaran)
Date: Thu, 02 Jun 2016 21:14:22 +0000
Subject: [docs] [issue27113] sqlite3 connect parameter "check_same_thread"
 not documented
In-Reply-To: <1464125789.84.0.570004715823.issue27113@psf.upfronthosting.co.za>
Message-ID: <1464902062.5.0.34092859846.issue27113@psf.upfronthosting.co.za>


Senthil Kumaran added the comment:

Dave, your patch looks good to me.

Did you see the comment from Trevor on your first patch?

>> According to the sqlite docs (http://www.sqlite.org/threadsafe.html), the
default mode is 'serialized', which does the necessary locking for threads to
share a connection. Unless Python is overriding this to use one of the less
protected modes, it shouldn't be necessary to use extra locks around it.

This had prompted me to remove extra line on asking users to take care of synchronization.

----------

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

From report at bugs.python.org  Thu Jun  2 17:29:10 2016
From: report at bugs.python.org (Berker Peksag)
Date: Thu, 02 Jun 2016 21:29:10 +0000
Subject: [docs] [issue21864] Error in documentation of point 9.8 'Exceptions
 are classes too'
In-Reply-To: <1403653260.15.0.739232303856.issue21864@psf.upfronthosting.co.za>
Message-ID: <1464902950.66.0.935163055153.issue21864@psf.upfronthosting.co.za>


Berker Peksag added the comment:

I think the "Exceptions Are Classes Too" section can be removed now. Users already learned that exceptions are classes in the previous chapter: https://docs.python.org/3/tutorial/errors.html

I'm attaching a patch that removes the "Exceptions Are Classes Too" section and merges some of its content into https://docs.python.org/3/tutorial/errors.html

----------
keywords: +patch
nosy: +berker.peksag
stage: needs patch -> patch review
versions: +Python 3.6 -Python 3.4
Added file: http://bugs.python.org/file43117/issue21864.diff

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

From report at bugs.python.org  Thu Jun  2 17:39:21 2016
From: report at bugs.python.org (Thomas Kluyver)
Date: Thu, 02 Jun 2016 21:39:21 +0000
Subject: [docs] [issue27113] sqlite3 connect parameter "check_same_thread"
 not documented
In-Reply-To: <1464125789.84.0.570004715823.issue27113@psf.upfronthosting.co.za>
Message-ID: <1464903561.59.0.0560939318757.issue27113@psf.upfronthosting.co.za>


Thomas Kluyver added the comment:

Having watched the video of Dave's PyCon talk (thanks Dave), I think he's talking about using locking to control transactions, which presumably the sqlite bindings don't handle by themselves. But I don't *think* you need manual locking just to maintain database integrity. If that's the case, it's probably helpful to clarify it.

I'd probably suggest that if you want to write from multiple threads and control transactions (i.e. more than just individual INSERTs fired from different threads), it's probably easier to use separate connections and let sqlite handle the synchronisation than to synchronise them yourself.

----------

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

From report at bugs.python.org  Thu Jun  2 17:40:13 2016
From: report at bugs.python.org (Thomas Kluyver)
Date: Thu, 02 Jun 2016 21:40:13 +0000
Subject: [docs] [issue27113] sqlite3 connect parameter "check_same_thread"
 not documented
In-Reply-To: <1464125789.84.0.570004715823.issue27113@psf.upfronthosting.co.za>
Message-ID: <1464903613.97.0.350534511097.issue27113@psf.upfronthosting.co.za>


Thomas Kluyver added the comment:

That comment contained far too much 'probably'. Time for me to sleep...

----------

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

From report at bugs.python.org  Thu Jun  2 18:11:39 2016
From: report at bugs.python.org (Emily Morehouse)
Date: Thu, 02 Jun 2016 22:11:39 +0000
Subject: [docs] [issue26829] update docs: when creating classes a new dict
 is created for the final class object
In-Reply-To: <1461333834.83.0.0321229546915.issue26829@psf.upfronthosting.co.za>
Message-ID: <1464905499.2.0.711332698527.issue26829@psf.upfronthosting.co.za>


Emily Morehouse added the comment:

Second version of patch for this -- more clearly states the process and outcome for class creation. Also adds to https://docs.python.org/3.6/library/functions.html#type to clarify that the dictionary object is copied to a standard dict.

----------
Added file: http://bugs.python.org/file43122/26829-v2.patch

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

From report at bugs.python.org  Thu Jun  2 19:29:38 2016
From: report at bugs.python.org (R. David Murray)
Date: Thu, 02 Jun 2016 23:29:38 +0000
Subject: [docs] [issue26829] update docs: when creating classes a new dict
 is created for the final class object
In-Reply-To: <1461333834.83.0.0321229546915.issue26829@psf.upfronthosting.co.za>
Message-ID: <1464910178.82.0.918920241365.issue26829@psf.upfronthosting.co.za>


R. David Murray added the comment:

I can't get the rietveld review tool to work from this network, so I'll do this in a comment.  This looks pretty good to me, but in the following:

  +It is important to note that during the creation of the class, a copy of the
  +namespace object is used in the final class object and the original namespace
  +object is discarded. More explicitly, this means that when ``type.__new__`` is
  +called, the object provided as the namespace parameter has its contents copied
  +to a standard Python dictionary.

I think it is more in keeping with the style of the rest of the doc to boil this down as much as possible.  We can drop the "It is important to note that", and just state the issue once, using the "more explicit" version.  I think borrowing your revised language from the type docs would work well here, by adding "which becomes the __dict__ of the class object" to the end of that sentence.

----------

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

From report at bugs.python.org  Thu Jun  2 19:37:01 2016
From: report at bugs.python.org (Tommy Beadle)
Date: Thu, 02 Jun 2016 23:37:01 +0000
Subject: [docs] [issue15476] Index "code object" and link to code object
 definition
In-Reply-To: <1343459471.56.0.370073010984.issue15476@psf.upfronthosting.co.za>
Message-ID: <1464910621.71.0.64423620554.issue15476@psf.upfronthosting.co.za>


Tommy Beadle added the comment:

The attached patch makes it so that 'code object' is its own 'top-level' entry in the index instead of being 'code' with an 'object' sub-item.  It also makes the links from the index go to the location in the documents just before the header instead of having the header be off-screen when the user navigates to it.

One thing about the ordering of the generated links, though, is that sphinx appears to generate them based on the alphabetical ordering of the path to the files that they're in:

c-api/code.rst
library/marshal.rst
library/stdtypes.rst
reference/datamodel.rst

If the order is that important, I believe it would require us to create sub-items that could look like this:

code object
    C API
    built-in type
    type reference
    marshaling

It didn't seem like other indexed entries follow this breakout pattern, but if that's what's desired for this case, just let me know and I'll submit a different patch.

----------
keywords: +patch
nosy: +tbeadle
Added file: http://bugs.python.org/file43126/0001-Issue-15476-Make-code-object-its-own-entry-in-the-do.patch

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

From report at bugs.python.org  Thu Jun  2 19:42:54 2016
From: report at bugs.python.org (Emily Morehouse)
Date: Thu, 02 Jun 2016 23:42:54 +0000
Subject: [docs] [issue26829] update docs: when creating classes a new dict
 is created for the final class object
In-Reply-To: <1461333834.83.0.0321229546915.issue26829@psf.upfronthosting.co.za>
Message-ID: <1464910974.61.0.19774243616.issue26829@psf.upfronthosting.co.za>


Emily Morehouse added the comment:

Trimmed down by keeping the more explicit explanation and taking into account suggestions.

----------
Added file: http://bugs.python.org/file43127/26829-v3.patch

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

From report at bugs.python.org  Thu Jun  2 20:06:33 2016
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 03 Jun 2016 00:06:33 +0000
Subject: [docs] [issue26829] update docs: when creating classes a new dict
 is created for the final class object
In-Reply-To: <1461333834.83.0.0321229546915.issue26829@psf.upfronthosting.co.za>
Message-ID: <20160603000629.4951.61511.00256799@psf.io>


Roundup Robot added the comment:

New changeset 754118f8b3ce by R David Murray in branch '3.5':
#26829: Clarify that namespace is copied to a new __dict__ in instance creation.
https://hg.python.org/cpython/rev/754118f8b3ce

New changeset 5a4ace14b350 by R David Murray in branch 'default':
Merge: #26829: Clarify that namespace is copied to a new __dict__ in instance creation.
https://hg.python.org/cpython/rev/5a4ace14b350

----------
nosy: +python-dev

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

From report at bugs.python.org  Thu Jun  2 20:07:51 2016
From: report at bugs.python.org (R. David Murray)
Date: Fri, 03 Jun 2016 00:07:51 +0000
Subject: [docs] [issue26829] update docs: when creating classes a new dict
 is created for the final class object
In-Reply-To: <1461333834.83.0.0321229546915.issue26829@psf.upfronthosting.co.za>
Message-ID: <1464912471.77.0.26457827332.issue26829@psf.upfronthosting.co.za>


R. David Murray added the comment:

Thanks, Emily.

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

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

From report at bugs.python.org  Thu Jun  2 20:16:16 2016
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 03 Jun 2016 00:16:16 +0000
Subject: [docs] [issue25931] os.fork() command distributed in windows
 Python27 (in SocketServer module)
In-Reply-To: <1450840231.57.0.83917358919.issue25931@psf.upfronthosting.co.za>
Message-ID: <20160603001608.4561.66468.C8F1D4AE@psf.io>


Roundup Robot added the comment:

New changeset d772400a1211 by Gregory P. Smith in branch 'default':
Issue #25931: Don't defining socketserver.Forking* names on platforms such
https://hg.python.org/cpython/rev/d772400a1211

----------
nosy: +python-dev

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

From report at bugs.python.org  Thu Jun  2 20:18:15 2016
From: report at bugs.python.org (Alexander Liu)
Date: Fri, 03 Jun 2016 00:18:15 +0000
Subject: [docs] [issue22797] urllib.request.urlopen documentation falsely
 guarantees that a URLError will be raised on errors
In-Reply-To: <1415120697.65.0.296811511924.issue22797@psf.upfronthosting.co.za>
Message-ID: <1464913094.92.0.477144617865.issue22797@psf.upfronthosting.co.za>


Alexander Liu added the comment:

Fixed the docs to specifically note that only protocol related errors raise the UrlError exception.

----------
nosy: +alex_thebear
versions: +Python 3.6 -Python 3.4
Added file: http://bugs.python.org/file43131/urlopen_doc.patch

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

From report at bugs.python.org  Thu Jun  2 20:19:11 2016
From: report at bugs.python.org (Gregory P. Smith)
Date: Fri, 03 Jun 2016 00:19:11 +0000
Subject: [docs] [issue25931] os.fork() command distributed in windows
 Python27 (in SocketServer module)
In-Reply-To: <1450840231.57.0.83917358919.issue25931@psf.upfronthosting.co.za>
Message-ID: <1464913151.44.0.856230214506.issue25931@psf.upfronthosting.co.za>


Gregory P. Smith added the comment:

I made the change to not export the Forking names on Windows or other non-os.fork() supporting platforms in 3.6 only as it is arguably an API change, even though the names it removes would effectively be unusable on those platforms anyways.

the docs still need updating.

----------
nosy: +gregory.p.smith
versions:  -Python 3.6

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

From report at bugs.python.org  Thu Jun  2 20:20:07 2016
From: report at bugs.python.org (Ian Lee)
Date: Fri, 03 Jun 2016 00:20:07 +0000
Subject: [docs] [issue27187] Relax __all__ location requirement in PEP 8
In-Reply-To: <1464901602.05.0.802918160149.issue27187@psf.upfronthosting.co.za>
Message-ID: <1464913207.01.0.0181794500308.issue27187@psf.upfronthosting.co.za>


Ian Lee added the comment:

I think that it should be updated to specify that all dunders ('__all__', '__version__', '__author__', etc) should be placed after the module docstring and before any imports. See issue-27187-patch1.txt for a possible update.

----------
Added file: http://bugs.python.org/file43132/issue-27187-patch1.txt

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

From report at bugs.python.org  Thu Jun  2 20:23:53 2016
From: report at bugs.python.org (R. David Murray)
Date: Fri, 03 Jun 2016 00:23:53 +0000
Subject: [docs] [issue25931] os.fork() command distributed in windows
 Python27 (in SocketServer module)
In-Reply-To: <1450840231.57.0.83917358919.issue25931@psf.upfronthosting.co.za>
Message-ID: <1464913432.29.0.273944339219.issue25931@psf.upfronthosting.co.za>


R. David Murray added the comment:

Your news entry says "don't defining".  The doc note can say that the classes are only defined if the platform supports fork.

----------

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

From report at bugs.python.org  Thu Jun  2 20:24:51 2016
From: report at bugs.python.org (R. David Murray)
Date: Fri, 03 Jun 2016 00:24:51 +0000
Subject: [docs] [issue25931] os.fork() command distributed in windows
 Python27 (in SocketServer module)
In-Reply-To: <1450840231.57.0.83917358919.issue25931@psf.upfronthosting.co.za>
Message-ID: <1464913490.82.0.569371901894.issue25931@psf.upfronthosting.co.za>


R. David Murray added the comment:

Well, defined for 3.6, and "functional" for 2.7 and 3.5 docs.

----------

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

From report at bugs.python.org  Thu Jun  2 20:31:10 2016
From: report at bugs.python.org (Ian Lee)
Date: Fri, 03 Jun 2016 00:31:10 +0000
Subject: [docs] [issue27187] Relax __all__ location requirement in PEP 8
In-Reply-To: <1464901602.05.0.802918160149.issue27187@psf.upfronthosting.co.za>
Message-ID: <1464913870.27.0.333502495759.issue27187@psf.upfronthosting.co.za>


Ian Lee added the comment:

I might also suggest that the entire "Version bookkeeping" section could be removed in this case, as it would be covered by my newly added dunder section.

----------

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

From report at bugs.python.org  Thu Jun  2 20:43:05 2016
From: report at bugs.python.org (Dave Sawyer)
Date: Fri, 03 Jun 2016 00:43:05 +0000
Subject: [docs] [issue27113] sqlite3 connect parameter "check_same_thread"
 not documented
In-Reply-To: <1464125789.84.0.570004715823.issue27113@psf.upfronthosting.co.za>
Message-ID: <1464914585.79.0.966572859692.issue27113@psf.upfronthosting.co.za>


Dave Sawyer added the comment:

Hi Thomas and Senthil, for the serialized setting I mentioned earlier "The serialized mode is default on both Mac and Windows so we can probably skip validating that. I did like mentioning the user needs to serialize the writes. They could use one thread for writing only or use locking. So, I just said to serialize."

to go into more detail, when serialize is set you don't need to worry that using multiple threads will WRECK your database. But, you still need to make sure your own writes get serialized or you will mix transactions together. Each connection only has one transaction in progress so if you share that connection between threads... watch out for your writes. Now if only one thread in your application writes and the other threads read you have no serialization issues to worry about. If two threads make updates without a threading.Lock than you can get 1.5 changes committed (and perhaps 0.5 later or if that had an error you might rollback that 0.5 of a transaction). You could also get the first thread to commit both changes and when the later thread calls commit get an error that is "no transaction in progress."

I thought "serialize" neatly encapsulated the two most common strategies here for shared connections - either a dedicated writer thread or using a python lock around your transactions. As Thomas points out you can also opt to give each thread its own connection... but then you don't need the check_same_thread parameter set to False as you are not sharing the connection.

----------

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

From report at bugs.python.org  Thu Jun  2 20:43:16 2016
From: report at bugs.python.org (R. David Murray)
Date: Fri, 03 Jun 2016 00:43:16 +0000
Subject: [docs] [issue15476] Index "code object" and link to code object
 definition
In-Reply-To: <1343459471.56.0.370073010984.issue15476@psf.upfronthosting.co.za>
Message-ID: <1464914596.25.0.155882416315.issue15476@psf.upfronthosting.co.za>


R. David Murray added the comment:

Since the main object of the issue is to have a canonical reference to use for linking 'code object' from elsewhere in the text, I think that can be satisfied by existing _bltin-code-objects 'ref' link as Terry suggests, even though it is a bit awkward to use.  The changes to the index position are good, I think, as is having a direct index entry for 'code object'.  However, following the model laid down by 'class object', the existing index entries under object should not be lost, but instead the new 'code object' index links should be added.

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

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

From report at bugs.python.org  Thu Jun  2 20:44:51 2016
From: report at bugs.python.org (Ian Lee)
Date: Fri, 03 Jun 2016 00:44:51 +0000
Subject: [docs] [issue27187] Relax __all__ location requirement in PEP 8
In-Reply-To: <1464901602.05.0.802918160149.issue27187@psf.upfronthosting.co.za>
Message-ID: <1464914691.11.0.422456371822.issue27187@psf.upfronthosting.co.za>


Changes by Ian Lee <ianlee1521 at gmail.com>:


Added file: http://bugs.python.org/file43134/issue-27187-patch2.txt

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

From report at bugs.python.org  Thu Jun  2 20:47:48 2016
From: report at bugs.python.org (Ian Lee)
Date: Fri, 03 Jun 2016 00:47:48 +0000
Subject: [docs] [issue23061] Update pep8 to specify explicitly 'module
 level' imports at top of file
In-Reply-To: <1418703864.09.0.281927050653.issue23061@psf.upfronthosting.co.za>
Message-ID: <1464914867.95.0.544366592436.issue23061@psf.upfronthosting.co.za>


Ian Lee added the comment:

Are there any other concerns with the patch that I would be able to clean up?

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

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

From report at bugs.python.org  Thu Jun  2 20:59:26 2016
From: report at bugs.python.org (Ian Lee)
Date: Fri, 03 Jun 2016 00:59:26 +0000
Subject: [docs] [issue27187] Relax __all__ location requirement in PEP 8
In-Reply-To: <1464901602.05.0.802918160149.issue27187@psf.upfronthosting.co.za>
Message-ID: <1464915566.57.0.878195373558.issue27187@psf.upfronthosting.co.za>


Ian Lee added the comment:

I added a comment on a pull request related to this that shows some of the cases that we probably don't want to allow: https://github.com/PyCQA/pycodestyle/pull/523#issuecomment-223464775

----------

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

From report at bugs.python.org  Thu Jun  2 21:02:50 2016
From: report at bugs.python.org (Ian Lee)
Date: Fri, 03 Jun 2016 01:02:50 +0000
Subject: [docs] [issue27191] Add formatting around methods in PEP 8
Message-ID: <1464915770.62.0.255842565692.issue27191@psf.upfronthosting.co.za>


New submission from Ian Lee:

Noticed a couple methods in the text that aren't backtick quoted.

----------
assignee: docs at python
components: Documentation
files: rst-formatting.txt
messages: 267015
nosy: IanLee1521, barry, docs at python
priority: normal
severity: normal
status: open
title: Add formatting around methods in PEP 8
Added file: http://bugs.python.org/file43136/rst-formatting.txt

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

From report at bugs.python.org  Thu Jun  2 21:04:19 2016
From: report at bugs.python.org (Mark Lawrence)
Date: Fri, 03 Jun 2016 01:04:19 +0000
Subject: [docs] [issue15476] Index "code object" and link to code object
 definition
In-Reply-To: <1343459471.56.0.370073010984.issue15476@psf.upfronthosting.co.za>
Message-ID: <1464915859.53.0.999353030374.issue15476@psf.upfronthosting.co.za>


Changes by Mark Lawrence <breamoreboy at yahoo.co.uk>:


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

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

From report at bugs.python.org  Thu Jun  2 21:15:36 2016
From: report at bugs.python.org (John Mark Vandenberg)
Date: Fri, 03 Jun 2016 01:15:36 +0000
Subject: [docs] [issue27187] Relax __all__ location requirement in PEP 8
In-Reply-To: <1464901602.05.0.802918160149.issue27187@psf.upfronthosting.co.za>
Message-ID: <1464916536.73.0.508120220272.issue27187@psf.upfronthosting.co.za>


Changes by John Mark Vandenberg <jayvdb at gmail.com>:


----------
nosy: +jayvdb

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

From report at bugs.python.org  Thu Jun  2 22:03:29 2016
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 03 Jun 2016 02:03:29 +0000
Subject: [docs] [issue27191] Add formatting around methods in PEP 8
In-Reply-To: <1464915770.62.0.255842565692.issue27191@psf.upfronthosting.co.za>
Message-ID: <20160603020325.103107.35214.E83C5817@psf.io>


Roundup Robot added the comment:

New changeset bf7f369fb49a by Berker Peksag in branch 'default':
Issue #27191: Improve markup of PEP 8, patch by Ian Lee
https://hg.python.org/peps/rev/bf7f369fb49a

----------
nosy: +python-dev

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

From report at bugs.python.org  Thu Jun  2 22:03:59 2016
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 03 Jun 2016 02:03:59 +0000
Subject: [docs] [issue27191] Add formatting around methods in PEP 8
In-Reply-To: <1464915770.62.0.255842565692.issue27191@psf.upfronthosting.co.za>
Message-ID: <1464919438.95.0.082247705002.issue27191@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Thanks!

----------
nosy: +berker.peksag
resolution:  -> fixed
stage:  -> resolved
status: open -> closed

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

From report at bugs.python.org  Thu Jun  2 22:48:24 2016
From: report at bugs.python.org (Tommy Beadle)
Date: Fri, 03 Jun 2016 02:48:24 +0000
Subject: [docs] [issue15476] Index "code object" and link to code object
 definition
In-Reply-To: <1343459471.56.0.370073010984.issue15476@psf.upfronthosting.co.za>
Message-ID: <1464922104.57.0.568920379934.issue15476@psf.upfronthosting.co.za>


Tommy Beadle added the comment:

This restores the original code -> object items.

----------
Added file: http://bugs.python.org/file43137/0001-Issue-15476-Make-code-object-its-own-entry-in-the-do.patch

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

From report at bugs.python.org  Thu Jun  2 23:03:10 2016
From: report at bugs.python.org (Martin Panter)
Date: Fri, 03 Jun 2016 03:03:10 +0000
Subject: [docs] [issue25931] os.fork() command distributed in windows
 Python27 (in SocketServer module)
In-Reply-To: <1450840231.57.0.83917358919.issue25931@psf.upfronthosting.co.za>
Message-ID: <1464922990.45.0.268079060104.issue25931@psf.upfronthosting.co.za>


Martin Panter added the comment:

This broke test_socketserver:

http://buildbot.python.org/all/builders/AMD64%20Windows7%20SP1%203.x/builds/7709/steps/test/logs/stdio
0:08:57 [193/400/1] test_socketserver failed
test test_socketserver crashed -- Traceback (most recent call last):
  File "C:\buildbot.python.org\3.x.kloth-win64\build\lib\test\test_socketserver.py", line 371, in <module>
    class ForkingErrorTestServer(socketserver.ForkingMixIn, BaseErrorTestServer):
AttributeError: module 'socketserver' has no attribute 'ForkingMixIn'

I am with David that it may not be worthwhile churning the API like this. Just document the existing (in 3.5) status that even though the classes exist, they need a working os.fork(). Otherwise, everyone that references ForkingMixIn but doesn?t use it (like test_socketserver) will have to update their code for 3.6.

----------
nosy: +martin.panter
versions: +Python 3.6

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

From report at bugs.python.org  Thu Jun  2 23:53:38 2016
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 03 Jun 2016 03:53:38 +0000
Subject: [docs] [issue19489] move quick search box above TOC
In-Reply-To: <1383546510.68.0.587653327623.issue19489@psf.upfronthosting.co.za>
Message-ID: <1464926018.42.0.694977354084.issue19489@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Jun  3 00:21:51 2016
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 03 Jun 2016 04:21:51 +0000
Subject: [docs] [issue17352] Be clear that __prepare__ must be declared as a
 class method
In-Reply-To: <1362409892.83.0.717786566871.issue17352@psf.upfronthosting.co.za>
Message-ID: <1464927711.51.0.683632961937.issue17352@psf.upfronthosting.co.za>


Berker Peksag added the comment:

This is a duplicate of issue 15243.

----------
nosy: +berker.peksag
resolution:  -> duplicate
stage:  -> resolved
status: open -> closed
superseder:  -> Misleading documentation for __prepare__

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

From report at bugs.python.org  Fri Jun  3 00:22:56 2016
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 03 Jun 2016 04:22:56 +0000
Subject: [docs] [issue15243] Misleading documentation for __prepare__
In-Reply-To: <1341328118.33.0.670602196671.issue15243@psf.upfronthosting.co.za>
Message-ID: <1464927776.46.0.173456575423.issue15243@psf.upfronthosting.co.za>


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


----------
keywords: +easy
versions: +Python 3.6 -Python 3.4

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

From pbfuddle at comcast.net  Thu Jun  2 23:47:59 2016
From: pbfuddle at comcast.net (Glenn Travis)
Date: Thu, 2 Jun 2016 22:47:59 -0500
Subject: [docs] can't get fibo documentation to work ;
 https://docs.python.org/3/tutorial/modules.html
Message-ID: <F1DFB306-00DC-42BA-BBF2-E0C613E85AC9@comcast.net>



>>> import fibo
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "fibo.py", line 6
    print(b, end=' ')
                ^
SyntaxError: invalid syntax
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160602/7d0fa3f7/attachment-0001.html>

From berker.peksag at gmail.com  Fri Jun  3 00:58:01 2016
From: berker.peksag at gmail.com (=?UTF-8?Q?Berker_Peksa=C4=9F?=)
Date: Thu, 2 Jun 2016 21:58:01 -0700
Subject: [docs] can't get fibo documentation to work ;
 https://docs.python.org/3/tutorial/modules.html
In-Reply-To: <F1DFB306-00DC-42BA-BBF2-E0C613E85AC9@comcast.net>
References: <F1DFB306-00DC-42BA-BBF2-E0C613E85AC9@comcast.net>
Message-ID: <CAF4280JXT86JOLStc4KjLJwR6mOuJm8N4mhgXbJvV0im+cmD5g@mail.gmail.com>

On Thu, Jun 2, 2016 at 8:47 PM, Glenn Travis <pbfuddle at comcast.net> wrote:
>
>
>>>> import fibo
> Traceback (most recent call last):
>   File "<stdin>", line 1, in <module>
>   File "fibo.py", line 6
>     print(b, end=' ')
>                 ^
> SyntaxError: invalid syntax

Hi Glenn,

    print(b, end=' ')

is a Python 3 syntax so you'll either need to install Python 3 or try
the Python 2 version of the tutorial at
https://docs.python.org/2/tutorial/modules.html

--Berker

From report at bugs.python.org  Fri Jun  3 01:17:12 2016
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 03 Jun 2016 05:17:12 +0000
Subject: [docs] [issue20408] memoryview() constructor documentation error
In-Reply-To: <1390823591.54.0.904712473888.issue20408@psf.upfronthosting.co.za>
Message-ID: <1464931032.83.0.249228654962.issue20408@psf.upfronthosting.co.za>


Berker Peksag added the comment:

I think the safest solution is to change 'obj' to 'object' in memoryview documentation.

----------
assignee:  -> docs at python
components: +Documentation -Interpreter Core
keywords: +easy
nosy: +berker.peksag, docs at python
stage: patch review -> needs patch
versions: +Python 3.6

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

From report at bugs.python.org  Fri Jun  3 01:26:25 2016
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 03 Jun 2016 05:26:25 +0000
Subject: [docs] [issue25931] os.fork() command distributed in windows
 Python27 (in SocketServer module)
In-Reply-To: <1450840231.57.0.83917358919.issue25931@psf.upfronthosting.co.za>
Message-ID: <20160603052622.5068.44079.75E6802D@psf.io>


Roundup Robot added the comment:

New changeset 3145242bc81f by Gregory P. Smith in branch 'default':
Issue25931: fix tests broken by the conditional define of socketserver.Forking*
https://hg.python.org/cpython/rev/3145242bc81f

----------

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

From report at bugs.python.org  Fri Jun  3 01:37:55 2016
From: report at bugs.python.org (Gregory P. Smith)
Date: Fri, 03 Jun 2016 05:37:55 +0000
Subject: [docs] [issue25931] os.fork() command distributed in windows
 Python27 (in SocketServer module)
In-Reply-To: <1450840231.57.0.83917358919.issue25931@psf.upfronthosting.co.za>
Message-ID: <1464932275.52.0.682262378486.issue25931@psf.upfronthosting.co.za>


Gregory P. Smith added the comment:

It may be worth rolling back the above two commits.  I'm not sure.  I'd like to see if anything else falls out of this during the beta phases.

There is a chance that some library has code similar to that found in test_socketserver.py that defines classes that inherit from the Forking type(s) but which are conditionally never used on Windows.  The above commit would break that.  I'm not sure how common that'll be.

----------

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

From report at bugs.python.org  Fri Jun  3 01:45:08 2016
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 03 Jun 2016 05:45:08 +0000
Subject: [docs] [issue25931] os.fork() command distributed in windows
 Python27 (in SocketServer module)
In-Reply-To: <1450840231.57.0.83917358919.issue25931@psf.upfronthosting.co.za>
Message-ID: <20160603054505.5454.93988.B6BF7637@psf.io>


Roundup Robot added the comment:

New changeset 015b86646d8e by Gregory P. Smith in branch 'default':
issue25931: document that socketserver.Forking* are unavailable on platforms
https://hg.python.org/cpython/rev/015b86646d8e

----------

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

From report at bugs.python.org  Fri Jun  3 01:48:37 2016
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 03 Jun 2016 05:48:37 +0000
Subject: [docs] [issue25931] os.fork() command distributed in windows
 Python27 (in SocketServer module)
In-Reply-To: <1450840231.57.0.83917358919.issue25931@psf.upfronthosting.co.za>
Message-ID: <20160603054832.88921.17483.14C3E500@psf.io>


Roundup Robot added the comment:

New changeset a4c0208b10df by Gregory P. Smith in branch '2.7':
issue25931: document that socketserver.Forking* are unavailable on platforms
https://hg.python.org/cpython/rev/a4c0208b10df

----------

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

From report at bugs.python.org  Fri Jun  3 01:56:57 2016
From: report at bugs.python.org (Gregory P. Smith)
Date: Fri, 03 Jun 2016 05:56:57 +0000
Subject: [docs] [issue25931] os.fork() command distributed in windows
 Python27 (in SocketServer module)
In-Reply-To: <1450840231.57.0.83917358919.issue25931@psf.upfronthosting.co.za>
Message-ID: <1464933417.52.0.612925093793.issue25931@psf.upfronthosting.co.za>


Changes by Gregory P. Smith <greg at krypto.org>:


----------
resolution:  -> fixed
stage: needs patch -> commit review
status: open -> closed

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

From report at bugs.python.org  Fri Jun  3 02:25:54 2016
From: report at bugs.python.org (Martin Panter)
Date: Fri, 03 Jun 2016 06:25:54 +0000
Subject: [docs] [issue20699] Document that binary IO classes work with
 bytes-likes objects
In-Reply-To: <1392889792.36.0.922412998797.issue20699@psf.upfronthosting.co.za>
Message-ID: <1464935153.01.0.266596922354.issue20699@psf.upfronthosting.co.za>


Martin Panter added the comment:

I agree with avoiding the term ?bytes-like object? in 2.7. It is easy to be specific when talking about concrete classes like BufferedWriter and BytesIO. But the harder question is what to specify for the abstract base classes.

In patch v8, I propose to change the documentation to refer to ?sequences of bytes which are usable with ?memoryview? ?. Technically, some of the _pyio implementations assume more than this (e.g. len(), iteration and slice assignment), but I have left them alone.

----------
Added file: http://bugs.python.org/file43141/bytes-like-param.py2.v8.patch

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

From report at bugs.python.org  Fri Jun  3 02:50:17 2016
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 03 Jun 2016 06:50:17 +0000
Subject: [docs] [issue8519] doc: termios and ioctl reference links
In-Reply-To: <1272125391.54.0.0119716465224.issue8519@psf.upfronthosting.co.za>
Message-ID: <20160603065007.38660.31374.0428488F@psf.io>


Roundup Robot added the comment:

New changeset f53a0566a290 by Senthil Kumaran in branch '3.5':
issue8519 - Reference termios and ioctl manual pages in the library documentation.
https://hg.python.org/cpython/rev/f53a0566a290

New changeset 8db146bec24b by Senthil Kumaran in branch 'default':
[merge from 3.5] - issue8519 - Reference termios and ioctl manual pages in the library documentation.
https://hg.python.org/cpython/rev/8db146bec24b

----------
nosy: +python-dev

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

From report at bugs.python.org  Fri Jun  3 02:51:29 2016
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 03 Jun 2016 06:51:29 +0000
Subject: [docs] [issue8519] doc: termios and ioctl reference links
In-Reply-To: <1272125391.54.0.0119716465224.issue8519@psf.upfronthosting.co.za>
Message-ID: <20160603065126.14605.39027.AD1ED4D8@psf.io>


Roundup Robot added the comment:

New changeset 55886a6aed4b by Senthil Kumaran in branch '2.7':
[backport to 2.7] - issue8519 - Reference termios and ioctl manual pages in the library documentation.
https://hg.python.org/cpython/rev/55886a6aed4b

----------

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

From report at bugs.python.org  Fri Jun  3 02:52:37 2016
From: report at bugs.python.org (Senthil Kumaran)
Date: Fri, 03 Jun 2016 06:52:37 +0000
Subject: [docs] [issue8519] doc: termios and ioctl reference links
In-Reply-To: <1272125391.54.0.0119716465224.issue8519@psf.upfronthosting.co.za>
Message-ID: <1464936757.16.0.637140263312.issue8519@psf.upfronthosting.co.za>


Senthil Kumaran added the comment:

Thanks Angad and Anatoly for the patches discussions.
Thank you Berker for review.

Made the changes in all active versions of python. Let this issue reset in peace.

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

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

From report at bugs.python.org  Fri Jun  3 03:00:02 2016
From: report at bugs.python.org (Senthil Kumaran)
Date: Fri, 03 Jun 2016 07:00:02 +0000
Subject: [docs] [issue27113] sqlite3 connect parameter "check_same_thread"
 not documented
In-Reply-To: <1464125789.84.0.570004715823.issue27113@psf.upfronthosting.co.za>
Message-ID: <1464937202.2.0.955413093163.issue27113@psf.upfronthosting.co.za>


Senthil Kumaran added the comment:

Thanks for the explanation, Dave. Completely agree with those points. Let's go ahead with the latest patch.

----------

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

From report at bugs.python.org  Fri Jun  3 03:04:36 2016
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 03 Jun 2016 07:04:36 +0000
Subject: [docs] [issue27113] sqlite3 connect parameter "check_same_thread"
 not documented
In-Reply-To: <1464125789.84.0.570004715823.issue27113@psf.upfronthosting.co.za>
Message-ID: <20160603070432.24155.48862.CD1A13A2@psf.io>


Roundup Robot added the comment:

New changeset af1752e51a89 by Senthil Kumaran in branch '3.5':
issue27113 - Document "check_same_thread" parameter in sqlite3.connect api.
https://hg.python.org/cpython/rev/af1752e51a89

New changeset 17c8da643065 by Senthil Kumaran in branch 'default':
[merge from 3.5] - issue27113 - Document "check_same_thread" parameter in sqlite3.connect api.
https://hg.python.org/cpython/rev/17c8da643065

----------
nosy: +python-dev

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

From report at bugs.python.org  Fri Jun  3 03:05:06 2016
From: report at bugs.python.org (Senthil Kumaran)
Date: Fri, 03 Jun 2016 07:05:06 +0000
Subject: [docs] [issue27113] sqlite3 connect parameter "check_same_thread"
 not documented
In-Reply-To: <1464125789.84.0.570004715823.issue27113@psf.upfronthosting.co.za>
Message-ID: <1464937505.87.0.61217199989.issue27113@psf.upfronthosting.co.za>


Senthil Kumaran added the comment:

Thanks for your contribution. It's now documented.

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

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

From report at bugs.python.org  Fri Jun  3 03:14:31 2016
From: report at bugs.python.org (Martin Panter)
Date: Fri, 03 Jun 2016 07:14:31 +0000
Subject: [docs] [issue15476] Index "code object" and link to code object
 definition
In-Reply-To: <1343459471.56.0.370073010984.issue15476@psf.upfronthosting.co.za>
Message-ID: <1464938071.58.0.193791125671.issue15476@psf.upfronthosting.co.za>


Martin Panter added the comment:

I left some minor review suggestions. But a more serious problem is that the change to Doc/reference/datamodel.rst breaks the formatting for me. Instead of a HTML <dl>, I get a <p> followed by a <blockquote>. Unfortunately I don?t know of a way to get index entries to point to the definition list heading without breaking up a definition list like this.

IMO having entries under both ?code object? and ?code? is redundant, but I see that is debatable. :) If I was looking this up, I would probably look at ?code? first. If it wasn?t there, I might even miss a separate ?code object? entry, considering there is also a second ?code (. . .)? entry as well.

----------
nosy: +martin.panter
versions: +Python 2.7, Python 3.5, Python 3.6 -Python 3.3

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

From report at bugs.python.org  Fri Jun  3 03:18:49 2016
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 03 Jun 2016 07:18:49 +0000
Subject: [docs] [issue20699] Document that binary IO classes work with
 bytes-likes objects
In-Reply-To: <1392889792.36.0.922412998797.issue20699@psf.upfronthosting.co.za>
Message-ID: <1464938329.26.0.923562956212.issue20699@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

Since the _pyio implementation doesn't support general memoryview-like objects, I consider using the new buffer protocol in the C implementation an implementation detail. Other implementations can lack this support. I think it would be better to left the wording more general ("preallocated writable array of bytes"), but mention other concrete example (array('b'), are there other examples in the stdlib?).

----------

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

From report at bugs.python.org  Fri Jun  3 03:46:51 2016
From: report at bugs.python.org (Martin Panter)
Date: Fri, 03 Jun 2016 07:46:51 +0000
Subject: [docs] [issue20699] Document that binary IO classes work with
 bytes-likes objects
In-Reply-To: <1392889792.36.0.922412998797.issue20699@psf.upfronthosting.co.za>
Message-ID: <1464940011.11.0.454292635742.issue20699@psf.upfronthosting.co.za>


Martin Panter added the comment:

Actually this bug report was opened because an implementation that lacked memoryview support was broken by 2.7. The point is to document that (a subset of) memoryview objects may be passed to custom implementations.

Does this need a ?changed in 2.7? notice? I am not so familiar with the history of Python 2 or the various buffer APIs to be sure.

Also see <https://bugs.python.org/issue20699#msg266523>, where I discovered array('b') does not work with io.BytesIO.write(). It seems you have to wrap it in buffer() first, presumably because array() does not support the ?new? protocol, but buffer() does.

----------

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

From vadmium+py at gmail.com  Fri Jun  3 03:01:28 2016
From: vadmium+py at gmail.com (vadmium+py at gmail.com)
Date: Fri, 03 Jun 2016 07:01:28 -0000
Subject: [docs] Index "code object" and link to code object definition
 (issue 15476)
Message-ID: <20160603070128.2353.56989@psf.upfronthosting.co.za>


https://bugs.python.org/review/15476/diff/17455/Doc/library/marshal.rst
File Doc/library/marshal.rst (right):

https://bugs.python.org/review/15476/diff/17455/Doc/library/marshal.rst#newcode20
Doc/library/marshal.rst:20: object: code
I think the ?code? index point(s) should be attached to the following
paragraph, about support of code and other objects in marshal.

This paragraph is about the relationship with the pickle and shelve
modules.

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

https://bugs.python.org/review/15476/diff/17455/Doc/library/stdtypes.rst#newcode4445
Doc/library/stdtypes.rst:4445: 
The generated HTML seems to work better if you include the ?..
_bltin-code-objects:? label _after_ the index code, instead of before.
Otherwise, #bltin-code-objects points to the end of the previous
section, rather than into the new section.

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

From report at bugs.python.org  Fri Jun  3 04:09:47 2016
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 03 Jun 2016 08:09:47 +0000
Subject: [docs] [issue20699] Document that binary IO classes work with
 bytes-likes objects
In-Reply-To: <1392889792.36.0.922412998797.issue20699@psf.upfronthosting.co.za>
Message-ID: <1464941387.04.0.895630960918.issue20699@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

array is supported explicitly in the Python implementation of readinto().

What if write not "usable with memoryview", but mention memoryview as an example?

   The object *b* should be a pre-allocated, writable array of bytes,
   such as :class:`bytearray`, :class:`array.array` or
   :class:`memoryview`.

----------

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

From report at bugs.python.org  Fri Jun  3 04:54:31 2016
From: report at bugs.python.org (Mark Lawrence)
Date: Fri, 03 Jun 2016 08:54:31 +0000
Subject: [docs] [issue19489] move quick search box above TOC
In-Reply-To: <1383546510.68.0.587653327623.issue19489@psf.upfronthosting.co.za>
Message-ID: <1464944071.8.0.744756971514.issue19489@psf.upfronthosting.co.za>


Changes by Mark Lawrence <breamoreboy at yahoo.co.uk>:


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

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

From report at bugs.python.org  Fri Jun  3 04:54:58 2016
From: report at bugs.python.org (Mark Lawrence)
Date: Fri, 03 Jun 2016 08:54:58 +0000
Subject: [docs] [issue15243] Misleading documentation for __prepare__
In-Reply-To: <1341328118.33.0.670602196671.issue15243@psf.upfronthosting.co.za>
Message-ID: <1464944098.25.0.652781887633.issue15243@psf.upfronthosting.co.za>


Changes by Mark Lawrence <breamoreboy at yahoo.co.uk>:


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

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

From report at bugs.python.org  Fri Jun  3 04:55:49 2016
From: report at bugs.python.org (Mark Lawrence)
Date: Fri, 03 Jun 2016 08:55:49 +0000
Subject: [docs] [issue20408] memoryview() constructor documentation error
In-Reply-To: <1390823591.54.0.904712473888.issue20408@psf.upfronthosting.co.za>
Message-ID: <1464944149.49.0.102506173548.issue20408@psf.upfronthosting.co.za>


Changes by Mark Lawrence <breamoreboy at yahoo.co.uk>:


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

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

From report at bugs.python.org  Fri Jun  3 05:10:13 2016
From: report at bugs.python.org (Stefan Krah)
Date: Fri, 03 Jun 2016 09:10:13 +0000
Subject: [docs] [issue20408] memoryview() constructor documentation error
In-Reply-To: <1390823591.54.0.904712473888.issue20408@psf.upfronthosting.co.za>
Message-ID: <1464945013.0.0.379018179679.issue20408@psf.upfronthosting.co.za>


Stefan Krah added the comment:

Or pretend in the documentation that it's a positional arg and make it one later. There is a slight performance difference.

I agree with Damien that probably no one uses the keyword arg.

----------

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

From report at bugs.python.org  Fri Jun  3 05:11:04 2016
From: report at bugs.python.org (Stefan Krah)
Date: Fri, 03 Jun 2016 09:11:04 +0000
Subject: [docs] [issue20408] memoryview() constructor documentation error
In-Reply-To: <1390823591.54.0.904712473888.issue20408@psf.upfronthosting.co.za>
Message-ID: <1464945064.78.0.684730761622.issue20408@psf.upfronthosting.co.za>


Stefan Krah added the comment:

Sorry, I meant *Demian*.

----------

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

From report at bugs.python.org  Fri Jun  3 05:59:13 2016
From: report at bugs.python.org (Martin Panter)
Date: Fri, 03 Jun 2016 09:59:13 +0000
Subject: [docs] [issue20699] Document that binary IO classes work with
 bytes-likes objects
In-Reply-To: <1392889792.36.0.922412998797.issue20699@psf.upfronthosting.co.za>
Message-ID: <1464947953.07.0.919133525553.issue20699@psf.upfronthosting.co.za>


Martin Panter added the comment:

I don?t see the point of mentioning array() objects at all. It?s hard to support array in a Python 2 implementation, as demonstrated by readinto(). And the special support for array('b') won?t help if you pass in array('B') with values 128?255. I see this as an implementation detail of _pyio, rather than a need for others to follow its lead.

The array('b') code was added by r56225. I guess it is experimental code from an early phase of the io module. Also, test_array_writes() is disabled for _pyio in 2.7 (https://hg.python.org/cpython/diff/760a710eb6c1/Lib/test/test_io.py), and in 2.6 (http://svn.python.org/view/python/branches/trunk-bytearray/Lib/test/test_io.py?r1=61775&r2=61774&pathrev=61775&view=patch).

I think it is better to avoid ?such as? and be specific about what has to be supported. Perhaps:

readinto(b): The object *b* should be a pre-allocated, writable array of bytes, either :class:`bytearray` or :class:`memoryview`.

.. versionchanged:: 2.7
   Support for :class:`memoryview`.

write(b): The object *b* should be an array of bytes, either :class:`str`, :class:`bytearray`, or :class:`memoryview`.

.. versionchanged:: 2.7
   Support for :class:`memoryview`.

----------

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

From report at bugs.python.org  Fri Jun  3 06:10:01 2016
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 03 Jun 2016 10:10:01 +0000
Subject: [docs] [issue20699] Document that binary IO classes work with
 bytes-likes objects
In-Reply-To: <1392889792.36.0.922412998797.issue20699@psf.upfronthosting.co.za>
Message-ID: <1464948601.13.0.667999090206.issue20699@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

Why :class:`str` and not :class:`bytes`?

----------

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

From report at bugs.python.org  Fri Jun  3 06:15:54 2016
From: report at bugs.python.org (Martin Panter)
Date: Fri, 03 Jun 2016 10:15:54 +0000
Subject: [docs] [issue20699] Document that binary IO classes work with
 bytes-likes objects
In-Reply-To: <1392889792.36.0.922412998797.issue20699@psf.upfronthosting.co.za>
Message-ID: <1464948954.07.0.53381204945.issue20699@psf.upfronthosting.co.za>


Martin Panter added the comment:

I thought :class:`str` is better documented in Python 2, but I can write bytes if you prefer. I guess it is more consistent with the rest of io.rst.

----------

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

From report at bugs.python.org  Fri Jun  3 06:35:24 2016
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 03 Jun 2016 10:35:24 +0000
Subject: [docs] [issue20699] Document that binary IO classes work with
 bytes-likes objects
In-Reply-To: <1392889792.36.0.922412998797.issue20699@psf.upfronthosting.co.za>
Message-ID: <1464950124.8.0.0916049703055.issue20699@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

Current docs use "bytes or bytearray object" (without references). "bytes" is just an alias to "str" in 2.7, but I prefer to use this name, for consistency with 3.x and for accenting the binary nature of the data.

Your new wording LGTM.

----------

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

From report at bugs.python.org  Fri Jun  3 13:27:53 2016
From: report at bugs.python.org (Tommy Beadle)
Date: Fri, 03 Jun 2016 17:27:53 +0000
Subject: [docs] [issue15476] Index "code object" and link to code object
 definition
In-Reply-To: <1343459471.56.0.370073010984.issue15476@psf.upfronthosting.co.za>
Message-ID: <1464974873.48.0.177100326228.issue15476@psf.upfronthosting.co.za>


Changes by Tommy Beadle <tbeadle at gmail.com>:


Added file: http://bugs.python.org/file43152/0001-Issue-15476-Make-code-object-its-own-entry-in-the-do.patch

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

From report at bugs.python.org  Fri Jun  3 13:33:22 2016
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 03 Jun 2016 17:33:22 +0000
Subject: [docs] [issue22797] urllib.request.urlopen documentation falsely
 guarantees that a URLError will be raised on errors
In-Reply-To: <1415120697.65.0.296811511924.issue22797@psf.upfronthosting.co.za>
Message-ID: <20160603173318.21239.13216.402F3266@psf.io>


Roundup Robot added the comment:

New changeset aed4b9981fca by R David Murray in branch '3.5':
#22797: clarify when URLErrors are raised by urlopen.
https://hg.python.org/cpython/rev/aed4b9981fca

New changeset d085b4f779af by R David Murray in branch '3.5':
Merge: #22797: clarify when URLErrors are raised by urlopen.
https://hg.python.org/cpython/rev/d085b4f779af

----------
nosy: +python-dev

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

From report at bugs.python.org  Fri Jun  3 13:46:11 2016
From: report at bugs.python.org (R. David Murray)
Date: Fri, 03 Jun 2016 17:46:11 +0000
Subject: [docs] [issue15476] Index "code object" and link to code object
 definition
In-Reply-To: <1343459471.56.0.370073010984.issue15476@psf.upfronthosting.co.za>
Message-ID: <1464975970.93.0.820181217798.issue15476@psf.upfronthosting.co.za>


R. David Murray added the comment:

There are entries for code with object as a subentry?  That's not what I was talking about, I was talking about preserving the sub entries for 'code' under the 'object' main entry.

----------

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

From report at bugs.python.org  Fri Jun  3 13:52:40 2016
From: report at bugs.python.org (Nathan Harold)
Date: Fri, 03 Jun 2016 17:52:40 +0000
Subject: [docs] [issue22558] Missing doc links to source code for
 Python-coded modules.
In-Reply-To: <1412514337.47.0.069385783283.issue22558@psf.upfronthosting.co.za>
Message-ID: <1464976360.64.0.642590235103.issue22558@psf.upfronthosting.co.za>


Nathan Harold added the comment:

I'll give this a go, per Terry's instructions in msg266846.

I've noticed up front that, due to other changes near the headers of a couple of files (specifically fcntl.rst and termios.rst), the patch doesn't apply cleanly anymore.  Is it permissible for me to fix that myself and upload a new version, or is it preferable for a patch's original author to handle such things?  In any case, there are plenty of other files for me to look over for now.

----------

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

From report at bugs.python.org  Fri Jun  3 14:56:34 2016
From: report at bugs.python.org (Joshua Jay Herman)
Date: Fri, 03 Jun 2016 18:56:34 +0000
Subject: [docs] [issue24459] Mention PYTHONFAULTHANDLER in the man page
In-Reply-To: <1434487895.85.0.561507121326.issue24459@psf.upfronthosting.co.za>
Message-ID: <1464980194.44.0.531610453257.issue24459@psf.upfronthosting.co.za>


Joshua Jay Herman added the comment:

Ping.

----------

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

From report at bugs.python.org  Fri Jun  3 15:15:33 2016
From: report at bugs.python.org (Tommy Beadle)
Date: Fri, 03 Jun 2016 19:15:33 +0000
Subject: [docs] [issue15476] Index "code object" and link to code object
 definition
In-Reply-To: <1343459471.56.0.370073010984.issue15476@psf.upfronthosting.co.za>
Message-ID: <1464981333.28.0.594082138719.issue15476@psf.upfronthosting.co.za>


Tommy Beadle added the comment:

Using

.. index::
   object: code

puts a 'code' entry under 'object' as well as 'object' under 'code'.  That's the way it is for every other item that uses "object: XXX".  So if you want a new 'code object' top-level item and keep 'object -> code', you're going to get 'code -> object' as well.  It would seem to me that the 'code object' top-level item is redundant.

----------

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

From report at bugs.python.org  Fri Jun  3 15:17:55 2016
From: report at bugs.python.org (Dave Sawyer)
Date: Fri, 03 Jun 2016 19:17:55 +0000
Subject: [docs] [issue27113] sqlite3 connect parameter "check_same_thread"
 not documented
In-Reply-To: <1464125789.84.0.570004715823.issue27113@psf.upfronthosting.co.za>
Message-ID: <1464981475.8.0.74127650769.issue27113@psf.upfronthosting.co.za>


Dave Sawyer added the comment:

hurray! My first commit

----------

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

From report at bugs.python.org  Fri Jun  3 15:24:50 2016
From: report at bugs.python.org (Thomas Kluyver)
Date: Fri, 03 Jun 2016 19:24:50 +0000
Subject: [docs] [issue27113] sqlite3 connect parameter "check_same_thread"
 not documented
In-Reply-To: <1464125789.84.0.570004715823.issue27113@psf.upfronthosting.co.za>
Message-ID: <1464981890.5.0.305061277531.issue27113@psf.upfronthosting.co.za>


Thomas Kluyver added the comment:

Congrats! :-)

----------

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

From report at bugs.python.org  Fri Jun  3 15:32:06 2016
From: report at bugs.python.org (Laura Rupprecht)
Date: Fri, 03 Jun 2016 19:32:06 +0000
Subject: [docs] [issue17888] docs: more information on documentation team
In-Reply-To: <1367412914.06.0.588625037016.issue17888@psf.upfronthosting.co.za>
Message-ID: <1464982326.55.0.181995126593.issue17888@psf.upfronthosting.co.za>


Laura Rupprecht added the comment:

I've updated the patch from Terry with Berker's suggestion.

----------
nosy: +laura
Added file: http://bugs.python.org/file43162/issue17888_2.patch

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

From report at bugs.python.org  Fri Jun  3 15:42:45 2016
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 03 Jun 2016 19:42:45 +0000
Subject: [docs] [issue22558] Missing doc links to source code for
 Python-coded modules.
In-Reply-To: <1412514337.47.0.069385783283.issue22558@psf.upfronthosting.co.za>
Message-ID: <1464982965.38.0.828264274155.issue22558@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

For me, the issue is willingness, not permission ;-).  Reviewing a patch includes somehow indicating changes needed to apply it 'today', and a revised patch is the best way.  Please say whether the header changes are in 3.6 only (in which case a separate 3.5 patch is needed) or in both.  'Commit ready' means that you believe a core dev could (and should) download, apply without issue, and commit when satisfies.  I should do so within a week if no one else does.

----------

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

From report at bugs.python.org  Fri Jun  3 15:51:00 2016
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 03 Jun 2016 19:51:00 +0000
Subject: [docs] [issue22797] urllib.request.urlopen documentation falsely
 guarantees that a URLError will be raised on errors
In-Reply-To: <1415120697.65.0.296811511924.issue22797@psf.upfronthosting.co.za>
Message-ID: <20160603195057.16579.16176.0567CBB2@psf.io>


Roundup Robot added the comment:

New changeset 8b6b6add8e47 by R David Murray in branch 'default':
psuedo merge: #22797: clarify when URLErrors are raised by urlopen.
https://hg.python.org/cpython/rev/8b6b6add8e47

----------

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

From report at bugs.python.org  Fri Jun  3 16:27:32 2016
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 03 Jun 2016 20:27:32 +0000
Subject: [docs] [issue25931] os.fork() command distributed in windows
 Python27 (in SocketServer module)
In-Reply-To: <1450840231.57.0.83917358919.issue25931@psf.upfronthosting.co.za>
Message-ID: <1464985652.06.0.976840745022.issue25931@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Jun  3 16:36:47 2016
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 03 Jun 2016 20:36:47 +0000
Subject: [docs] [issue24459] Mention PYTHONFAULTHANDLER in the man page
In-Reply-To: <1434487895.85.0.561507121326.issue24459@psf.upfronthosting.co.za>
Message-ID: <1464986207.19.0.0847891982624.issue24459@psf.upfronthosting.co.za>


Berker Peksag added the comment:

> Hi, I have alphabetized and [...]

Can you please de-alphabetize the list to make patch review a little bit easier? Thanks!

----------
nosy: +berker.peksag
stage: needs patch -> patch review

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

From oddobert at gmail.com  Fri Jun  3 17:20:45 2016
From: oddobert at gmail.com (Odd Haaskjold)
Date: Fri, 3 Jun 2016 23:20:45 +0200
Subject: [docs] Downloads of documentation
Message-ID: <CAGEhuiJ5DMaUWY3Mg_mUgBZdT_8GCqr11W_uv0FWn1_5+fp8NQ@mail.gmail.com>

Hi,

The zip. download links on this page doesn't work->
https://docs.python.org/3/download.html

Thank you for maintaing Python, you do great work!

With kind regards,
Odd
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160603/d3fcb1e7/attachment.html>

From srhaterdogan at gmail.com  Fri Jun  3 13:20:41 2016
From: srhaterdogan at gmail.com (=?UTF-8?Q?Serhat_Erdo=C4=9Fan?=)
Date: Fri, 3 Jun 2016 20:20:41 +0300
Subject: [docs] Bug - Descriptor HowTo Guide
Message-ID: <CAPQYMBqmWvAO5K7zsGo-Ogy6f_6afd-UFJxbW8s8o4rWcp_=wA@mail.gmail.com>

Hi,

Descriptor HowTo Guide on page
https://docs.python.org/3/howto/descriptor.html#functions-and-methods still
mentions about unbound methods as the type of methods directly accessed as
a class protperty. However, class methods are not unbound methods, they are
returned as function objects when they are retreived from classes.

It would be nice to correct the guide so as not to confuse the readers.

Thank you
Serhat Erdo?an
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160603/209e79cb/attachment-0001.html>

From report at bugs.python.org  Fri Jun  3 17:44:25 2016
From: report at bugs.python.org (Joshua Jay Herman)
Date: Fri, 03 Jun 2016 21:44:25 +0000
Subject: [docs] [issue24459] Mention PYTHONFAULTHANDLER in the man page
In-Reply-To: <1434487895.85.0.561507121326.issue24459@psf.upfronthosting.co.za>
Message-ID: <1464990265.64.0.253002337569.issue24459@psf.upfronthosting.co.za>


Joshua Jay Herman added the comment:

Undid alphabetization and added additional missing environment variables including debug mode variables.

----------
Added file: http://bugs.python.org/file43166/addMissingEnvironmentVariables.patch

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

From report at bugs.python.org  Fri Jun  3 18:03:11 2016
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 03 Jun 2016 22:03:11 +0000
Subject: [docs] [issue24459] Mention PYTHONFAULTHANDLER in the man page
In-Reply-To: <1434487895.85.0.561507121326.issue24459@psf.upfronthosting.co.za>
Message-ID: <1464991391.68.0.386796136249.issue24459@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Thanks for the patch, Joshua. I did a quick review and it looks good to me. I will review and test it more carefully later today.

----------

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

From report at bugs.python.org  Fri Jun  3 18:04:23 2016
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 03 Jun 2016 22:04:23 +0000
Subject: [docs] [issue17888] docs: more information on documentation team
In-Reply-To: <1367412914.06.0.588625037016.issue17888@psf.upfronthosting.co.za>
Message-ID: <1464991463.44.0.551018006856.issue17888@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Thanks, Laura. I will commit issue17888_2.patch later today.

----------

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

From report at bugs.python.org  Fri Jun  3 18:08:43 2016
From: report at bugs.python.org (Nathan Harold)
Date: Fri, 03 Jun 2016 22:08:43 +0000
Subject: [docs] [issue22558] Missing doc links to source code for
 Python-coded modules.
In-Reply-To: <1412514337.47.0.069385783283.issue22558@psf.upfronthosting.co.za>
Message-ID: <1464991722.91.0.558596729793.issue22558@psf.upfronthosting.co.za>


Nathan Harold added the comment:

I went through all the diffs in Rietveld, checking it against msg228576 as I went.  There were (naturally) more source links added than there are in that list from 2014, and there were also many more files with slight header reorganizations for consistency.  Anything in the diffs I don't mention here looked fine to me.  I also built the docs to test links in general and to see how some specific things here looked.

A number of the new links are to __init__.py files, and others are to folders rather than individual source files.  I noticed a precedent for the former in the case of the http module; for the latter I'm less certain, but I can see that it makes sense in some cases, e.g. when __init__.py is empty.  I think these are probably good.

One thing I particularly noticed was that in imp.rst and optparse.rst, the deprecation notice occurred below the source link, whereas the versionadded notices are always above it.  I think it would be more consistent and look more natural to have the deprecation notices above the source links.

This could be taken a step farther by suggesting that the source link always be the last visible thing before the horizontal line.  The two other cases this would affect here are asyncio.rst (the notice that the module is provisional is between the source link and line) and getopt.rst (the note, now moved above the line, is after the source link).  But this is all fairly subjective.

Other details for individual files:

marshal.rst - Here an index block a bit farther down into the text was moved up into the header.  I think these might have been intended to point right where they were, not to the module as a whole; those things occur only in the paragraph (or two, in the case of 'code object') immediately following where the index originally pointed.

unittest.mock-examples.rst - A versionadded notice was completely removed from this file.  In fact, that was the only change to this file.  I think I can see why you did this, since the actual API documentation for the library is in unittest.mock.rst, which has that same version notice.

Smaller details:
array.rst - -------------- was inserted above .. index:
fcntl.rst - Patch appears to apply correctly, but with fuzz.
os.path.rst - It might be good to put a space in "WindowsNT"
termios.rst - Patch fails to apply because some other text near the header has changed recently.
venv.rst - The source code link (to a folder) works, but is missing a trailing slash.

Terry, I got the same results when I tried applying it to 3.5, so I think a single patch will do.

----------

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

From report at bugs.python.org  Fri Jun  3 18:49:33 2016
From: report at bugs.python.org (Martin Panter)
Date: Fri, 03 Jun 2016 22:49:33 +0000
Subject: [docs] [issue15476] Index "code object" and link to code object
 definition
In-Reply-To: <1343459471.56.0.370073010984.issue15476@psf.upfronthosting.co.za>
Message-ID: <1464994173.58.0.50538604149.issue15476@psf.upfronthosting.co.za>


Martin Panter added the comment:

I haven?t tested, but maybe this will do what you want:

.. index:: object; code, code object

or

.. index::
   single: object; code
   single: code object

----------

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

From report at bugs.python.org  Fri Jun  3 18:59:37 2016
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 03 Jun 2016 22:59:37 +0000
Subject: [docs] [issue22558] Missing doc links to source code for
 Python-coded modules.
In-Reply-To: <1412514337.47.0.069385783283.issue22558@psf.upfronthosting.co.za>
Message-ID: <1464994777.44.0.531870706041.issue22558@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

Great report.  It appears that the remaining questions are subjective decisions for a core developer: what is the best link, if any, for a package; should the link also be last thing in the section.

----------

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

From report at bugs.python.org  Fri Jun  3 19:35:07 2016
From: report at bugs.python.org (Martin Panter)
Date: Fri, 03 Jun 2016 23:35:07 +0000
Subject: [docs] [issue15476] Index "code object" and link to code object
 definition
In-Reply-To: <1343459471.56.0.370073010984.issue15476@psf.upfronthosting.co.za>
Message-ID: <1464996907.28.0.0900764931165.issue15476@psf.upfronthosting.co.za>


Martin Panter added the comment:

Not sure why it doesn?t come up in the code review, but in

diff --git a/Doc/reference/datamodel.rst b/Doc/reference/datamodel.rst
index c0b4930..f34ba9f 100644
--- a/Doc/reference/datamodel.rst
+++ b/Doc/reference/datamodel.rst
@@ -847,8 +847,10 @@ Internal types

    Code objects
+
       .. index::
          single: bytecode
+         single: code object
          object: code
 
       Code objects represent *byte-compiled* executable Python code, or :term:`bytecode`.

that added blank line seems to also cause the same definition list problem as before :(

----------

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

From report at bugs.python.org  Fri Jun  3 20:04:06 2016
From: report at bugs.python.org (Jelle Zijlstra)
Date: Sat, 04 Jun 2016 00:04:06 +0000
Subject: [docs] [issue27202] make doctest fails on 2.7 release notes
Message-ID: <1464998646.05.0.234628246633.issue27202@psf.upfronthosting.co.za>


New submission from Jelle Zijlstra:

Running `make doctest` in the Doc/ repository of master fails on the 2.7 release notes. This patch excludes these files from `make doctest`, because it doesn't seem worth it to try to get these running in Python 3.

----------
assignee: docs at python
components: Documentation
files: no27doctests.patch
keywords: patch
messages: 267190
nosy: Jelle Zijlstra, docs at python
priority: normal
severity: normal
status: open
title: make doctest fails on 2.7 release notes
versions: Python 3.6
Added file: http://bugs.python.org/file43170/no27doctests.patch

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

From report at bugs.python.org  Fri Jun  3 20:18:28 2016
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 04 Jun 2016 00:18:28 +0000
Subject: [docs] [issue22797] urllib.request.urlopen documentation falsely
 guarantees that a URLError will be raised on errors
In-Reply-To: <1415120697.65.0.296811511924.issue22797@psf.upfronthosting.co.za>
Message-ID: <20160604001820.21031.50434.35C63656@psf.io>


Roundup Robot added the comment:

New changeset b4df20312b78 by R David Murray in branch 'default':
Clean up urlopen doc string.
https://hg.python.org/cpython/rev/b4df20312b78

----------

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

From report at bugs.python.org  Fri Jun  3 20:19:22 2016
From: report at bugs.python.org (R. David Murray)
Date: Sat, 04 Jun 2016 00:19:22 +0000
Subject: [docs] [issue22797] urllib.request.urlopen documentation falsely
 guarantees that a URLError will be raised on errors
In-Reply-To: <1415120697.65.0.296811511924.issue22797@psf.upfronthosting.co.za>
Message-ID: <1464999562.17.0.456547781542.issue22797@psf.upfronthosting.co.za>


R. David Murray added the comment:

Thanks, Alexander.

----------
resolution:  -> fixed
stage:  -> resolved
status: open -> closed
versions: +Python 3.5

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

From report at bugs.python.org  Fri Jun  3 20:27:00 2016
From: report at bugs.python.org (Jelle Zijlstra)
Date: Sat, 04 Jun 2016 00:27:00 +0000
Subject: [docs] [issue27205] Failing doctests in Library/collections.rst
Message-ID: <1465000020.63.0.799580126218.issue27205@psf.upfronthosting.co.za>


New submission from Jelle Zijlstra:

Mostly due to unspecified sorting order. The patch sorts a few tests and skips others that can't easily be sorted (e.g. most_common and str() output).

----------
assignee: docs at python
components: Documentation
files: doctests-collections.patch
keywords: patch
messages: 267199
nosy: Jelle Zijlstra, docs at python
priority: normal
severity: normal
status: open
title: Failing doctests in Library/collections.rst
versions: Python 3.6
Added file: http://bugs.python.org/file43175/doctests-collections.patch

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

From report at bugs.python.org  Fri Jun  3 20:35:11 2016
From: report at bugs.python.org (Jelle Zijlstra)
Date: Sat, 04 Jun 2016 00:35:11 +0000
Subject: [docs] [issue27206] Failing doctests in Doc/tutorial/
Message-ID: <1465000511.18.0.692311972692.issue27206@psf.upfronthosting.co.za>


New submission from Jelle Zijlstra:

Patch adds an import.

----------
assignee: docs at python
components: Documentation
files: doctests-tutorial.patch
keywords: patch
messages: 267202
nosy: Jelle Zijlstra, docs at python
priority: normal
severity: normal
status: open
title: Failing doctests in Doc/tutorial/
versions: Python 3.6
Added file: http://bugs.python.org/file43176/doctests-tutorial.patch

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

From report at bugs.python.org  Fri Jun  3 20:37:54 2016
From: report at bugs.python.org (Jelle Zijlstra)
Date: Sat, 04 Jun 2016 00:37:54 +0000
Subject: [docs] [issue27207] Failing doctests in Doc/whatsnew/3.2.rst
Message-ID: <1465000673.79.0.877090352163.issue27207@psf.upfronthosting.co.za>


New submission from Jelle Zijlstra:

Mostly missing imports, some bad syntax, and a few typos. This patch fixes most but not all errors.

----------
assignee: docs at python
components: Documentation
files: doctests-whatsnew-32.patch
keywords: patch
messages: 267203
nosy: Jelle Zijlstra, docs at python
priority: normal
severity: normal
status: open
title: Failing doctests in Doc/whatsnew/3.2.rst
versions: Python 3.6
Added file: http://bugs.python.org/file43177/doctests-whatsnew-32.patch

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

From report at bugs.python.org  Fri Jun  3 20:41:56 2016
From: report at bugs.python.org (Jelle Zijlstra)
Date: Sat, 04 Jun 2016 00:41:56 +0000
Subject: [docs] [issue27208] Failing doctests in Library/traceback.rst
Message-ID: <1465000916.52.0.195426294226.issue27208@psf.upfronthosting.co.za>


New submission from Jelle Zijlstra:

Updated to the output of current 3.6.

----------
assignee: docs at python
components: Documentation
files: doctests-traceback.patch
keywords: patch
messages: 267205
nosy: Jelle Zijlstra, docs at python
priority: normal
severity: normal
status: open
title: Failing doctests in Library/traceback.rst
versions: Python 3.6
Added file: http://bugs.python.org/file43178/doctests-traceback.patch

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

From report at bugs.python.org  Fri Jun  3 20:43:48 2016
From: report at bugs.python.org (Jelle Zijlstra)
Date: Sat, 04 Jun 2016 00:43:48 +0000
Subject: [docs] [issue27209] Failing doctests in Library/email.*.rst
Message-ID: <1465001028.46.0.510411866353.issue27209@psf.upfronthosting.co.za>


Changes by Jelle Zijlstra <jelle.zijlstra at gmail.com>:


----------
assignee: docs at python
components: Documentation
files: doctests-email.patch
keywords: patch
nosy: Jelle Zijlstra, docs at python
priority: normal
severity: normal
status: open
title: Failing doctests in Library/email.*.rst
versions: Python 3.6
Added file: http://bugs.python.org/file43179/doctests-email.patch

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

From report at bugs.python.org  Fri Jun  3 20:46:55 2016
From: report at bugs.python.org (Jelle Zijlstra)
Date: Sat, 04 Jun 2016 00:46:55 +0000
Subject: [docs] [issue27210] Failing doctests due to environmental
 dependencies in Lib/*lib.rst
Message-ID: <1465001215.61.0.0775726145069.issue27210@psf.upfronthosting.co.za>


New submission from Jelle Zijlstra:

The difflib test fails because "False" is close enough to "apple". The ftplib and nntplib tests rely on things downloaded from the web that are inherently variable.

----------
assignee: docs at python
components: Documentation
files: doctests-libs.patch
keywords: patch
messages: 267208
nosy: Jelle Zijlstra, docs at python
priority: normal
severity: normal
status: open
title: Failing doctests due to environmental dependencies in Lib/*lib.rst
versions: Python 3.6
Added file: http://bugs.python.org/file43181/doctests-libs.patch

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

From report at bugs.python.org  Fri Jun  3 21:02:02 2016
From: report at bugs.python.org (Martin Panter)
Date: Sat, 04 Jun 2016 01:02:02 +0000
Subject: [docs] [issue27202] make doctest fails on 2.7 release notes
In-Reply-To: <1464998646.05.0.234628246633.issue27202@psf.upfronthosting.co.za>
Message-ID: <1465002122.76.0.57233860575.issue27202@psf.upfronthosting.co.za>


Martin Panter added the comment:

What failures are seeing, and what version of Sphinx are you using? Perhaps this is related to Issue 26638?

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

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

From report at bugs.python.org  Fri Jun  3 21:04:04 2016
From: report at bugs.python.org (Martin Panter)
Date: Sat, 04 Jun 2016 01:04:04 +0000
Subject: [docs] [issue27202] make doctest fails on 2.7 release notes
In-Reply-To: <1464998646.05.0.234628246633.issue27202@psf.upfronthosting.co.za>
Message-ID: <1465002244.52.0.259196665768.issue27202@psf.upfronthosting.co.za>


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


----------
Removed message: http://bugs.python.org/msg267213

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

From report at bugs.python.org  Fri Jun  3 21:06:21 2016
From: report at bugs.python.org (Martin Panter)
Date: Sat, 04 Jun 2016 01:06:21 +0000
Subject: [docs] [issue27202] make doctest fails on 2.7 release notes
In-Reply-To: <1464998646.05.0.234628246633.issue27202@psf.upfronthosting.co.za>
Message-ID: <1465002381.74.0.226463373732.issue27202@psf.upfronthosting.co.za>


Martin Panter added the comment:

Ignore my message; I was thinking of something different :)

I presume you are running something like the following, which seems to smoke-test the examples in the documentation:

make -C Doc doctest

----------

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

From report at bugs.python.org  Fri Jun  3 21:18:02 2016
From: report at bugs.python.org (Jelle Zijlstra)
Date: Sat, 04 Jun 2016 01:18:02 +0000
Subject: [docs] [issue27202] make doctest fails on 2.7 release notes
In-Reply-To: <1464998646.05.0.234628246633.issue27202@psf.upfronthosting.co.za>
Message-ID: <1465003082.13.0.874073761039.issue27202@psf.upfronthosting.co.za>


Jelle Zijlstra added the comment:

Yes, I've been attempting to get that make to fully succeed.

----------

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

From report at bugs.python.org  Fri Jun  3 21:46:25 2016
From: report at bugs.python.org (Martin Panter)
Date: Sat, 04 Jun 2016 01:46:25 +0000
Subject: [docs] [issue27202] make doctest fails on 2.7 release notes
In-Reply-To: <1464998646.05.0.234628246633.issue27202@psf.upfronthosting.co.za>
Message-ID: <1465004785.38.0.78215139117.issue27202@psf.upfronthosting.co.za>


Martin Panter added the comment:

Since I stuck my neck out, I will say that this seems reasonable to me. We could probably still run doctest in the actual 2.7 branch to detect any errors there.

----------
stage:  -> patch review
versions: +Python 3.5

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

From report at bugs.python.org  Sat Jun  4 01:31:34 2016
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 04 Jun 2016 05:31:34 +0000
Subject: [docs] [issue22797] urllib.request.urlopen documentation falsely
 guarantees that a URLError will be raised on errors
In-Reply-To: <1415120697.65.0.296811511924.issue22797@psf.upfronthosting.co.za>
Message-ID: <20160604053131.119955.79030.D5CA9ADB@psf.io>


Roundup Robot added the comment:

New changeset 2d69d0419879 by Martin Panter in branch 'default':
Issue #22797: Synchronize urlopen() doc string with RST documentation
https://hg.python.org/cpython/rev/2d69d0419879

----------

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

From report at bugs.python.org  Sat Jun  4 01:33:47 2016
From: report at bugs.python.org (alex0307)
Date: Sat, 04 Jun 2016 05:33:47 +0000
Subject: [docs] [issue27212] Doc for itertools,
 'islice()' implementation have unwanted behavior for recipe
 'consume()'
Message-ID: <1465018426.98.0.63725897135.issue27212@psf.upfronthosting.co.za>


New submission from alex0307:

In the doc for itertools, the python implementation of islice() doesn't actually perform the iteration when given an empty slice (e.g. islice(it,3,3)). 

This is not the expected behavior for 'consume()' in the recipe given below, i.e. consume(it,3) couldn't actually advance the iterator for 3 steps ahead. Instead, the iterator stays at its starting position.

As a simple fix, in the implementation of islice(), the length of the slice object should be checked first. If it's zero, the iterator should be advanced (slice.start-1) times, and return (See islice_my.py)

----------
assignee: docs at python
components: Documentation
files: islice_my.py
messages: 267236
nosy: alex0307, docs at python
priority: normal
severity: normal
status: open
title: Doc for itertools, 'islice()' implementation have unwanted behavior for recipe 'consume()'
type: behavior
versions: Python 2.7
Added file: http://bugs.python.org/file43184/islice_my.py

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

From report at bugs.python.org  Sat Jun  4 01:41:29 2016
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 04 Jun 2016 05:41:29 +0000
Subject: [docs] [issue27212] Doc for itertools,
 'islice()' implementation have unwanted behavior for recipe
 'consume()'
In-Reply-To: <1465018426.98.0.63725897135.issue27212@psf.upfronthosting.co.za>
Message-ID: <1465018889.14.0.174081673448.issue27212@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Jun  4 03:06:23 2016
From: report at bugs.python.org (Martin Panter)
Date: Sat, 04 Jun 2016 07:06:23 +0000
Subject: [docs] [issue24617] os.makedirs()'s [mode] not correct
In-Reply-To: <1436721223.66.0.229120395272.issue24617@psf.upfronthosting.co.za>
Message-ID: <1465023983.84.0.90158643176.issue24617@psf.upfronthosting.co.za>


Martin Panter added the comment:

I think it would be good to move the sentence about FileExistsError away from your new paragraph about *mode*. Also, I would try to make the hyperlink a bit more explicit and descriptive, maybe

The *mode* parameter is passed to :func:`mkdir`; see :ref:`the mkdir() description <mkdir_modebits>` for how it is interpreted.

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

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

From report at bugs.python.org  Sat Jun  4 06:11:25 2016
From: report at bugs.python.org (Alex Chan)
Date: Sat, 04 Jun 2016 10:11:25 +0000
Subject: [docs] [issue27216] Fix capitalisation of "Python runtime" in
 os.path.islink description
Message-ID: <1465035085.6.0.0369586412077.issue27216@psf.upfronthosting.co.za>


New submission from Alex Chan:

Since Python is a proper noun, it should be capitalised.  Fix a case where the docs used lowercase "python".

The phrase "by the python runtime" was added in the 2.7 docs; the 2.6 docs just say "if symbolic links are not supported".

----------
assignee: docs at python
components: Documentation
files: capitalisation.patch
keywords: patch
messages: 267251
nosy: alexwlchan, docs at python
priority: normal
severity: normal
status: open
title: Fix capitalisation of "Python runtime" in os.path.islink description
type: enhancement
versions: Python 2.7
Added file: http://bugs.python.org/file43194/capitalisation.patch

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

From report at bugs.python.org  Sat Jun  4 08:59:39 2016
From: report at bugs.python.org (ppperry)
Date: Sat, 04 Jun 2016 12:59:39 +0000
Subject: [docs] [issue27215] Docstrings of Sequence and MutableSequence
 seems not right
In-Reply-To: <1465032017.04.0.0861396062626.issue27215@psf.upfronthosting.co.za>
Message-ID: <1465045179.34.0.447133454552.issue27215@psf.upfronthosting.co.za>


Changes by ppperry <mapreader at olum.org>:


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

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

From report at bugs.python.org  Sat Jun  4 09:00:45 2016
From: report at bugs.python.org (ppperry)
Date: Sat, 04 Jun 2016 13:00:45 +0000
Subject: [docs] [issue27215] Docstrings of Sequence and MutableSequence
 seems not right
In-Reply-To: <1465032017.04.0.0861396062626.issue27215@psf.upfronthosting.co.za>
Message-ID: <1465045245.75.0.0470914362938.issue27215@psf.upfronthosting.co.za>


Changes by ppperry <mapreader at olum.org>:


----------
type:  -> behavior

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

From report at bugs.python.org  Sat Jun  4 11:44:19 2016
From: report at bugs.python.org (Jelle Zijlstra)
Date: Sat, 04 Jun 2016 15:44:19 +0000
Subject: [docs] [issue27203] Failing doctests in Doc/faq/programming.rst
In-Reply-To: <1464999592.59.0.0136488038508.issue27203@psf.upfronthosting.co.za>
Message-ID: <1465055059.78.0.0765249948195.issue27203@psf.upfronthosting.co.za>


Jelle Zijlstra added the comment:

Thanks for teaching me about `make suspicious`. The attached patch fixes the issue.

This doesn't fix all failures in the file but it gets us closer.

----------
assignee:  -> docs at python
components: +Documentation
nosy: +docs at python
versions: +Python 3.6
Added file: http://bugs.python.org/file43197/doctests-faq.patch

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

From report at bugs.python.org  Sat Jun  4 12:41:30 2016
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 04 Jun 2016 16:41:30 +0000
Subject: [docs] [issue27216] Fix capitalisation of "Python runtime" in
 os.path.islink description
In-Reply-To: <1465035085.6.0.0369586412077.issue27216@psf.upfronthosting.co.za>
Message-ID: <20160604164126.13690.40782.F5562B28@psf.io>


Roundup Robot added the comment:

New changeset 7c20ea2bdb3f by Ned Deily in branch '2.7':
Issue 27216: Fix typo (noticed by Alex Chan).
https://hg.python.org/cpython/rev/7c20ea2bdb3f

New changeset 5160d59a8f1c by Ned Deily in branch '3.5':
Issue 27216: Fix typo (noticed by Alex Chan).
https://hg.python.org/cpython/rev/5160d59a8f1c

New changeset 7fda2d76d947 by Ned Deily in branch 'default':
Issue 27216: Fix typo (noticed by Alex Chan).
https://hg.python.org/cpython/rev/7fda2d76d947

----------
nosy: +python-dev

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

From report at bugs.python.org  Sat Jun  4 12:42:37 2016
From: report at bugs.python.org (Ned Deily)
Date: Sat, 04 Jun 2016 16:42:37 +0000
Subject: [docs] [issue27216] Fix capitalisation of "Python runtime" in
 os.path.islink description
In-Reply-To: <1465035085.6.0.0369586412077.issue27216@psf.upfronthosting.co.za>
Message-ID: <1465058557.67.0.695459009678.issue27216@psf.upfronthosting.co.za>


Ned Deily added the comment:

Thanks for noticing!

----------
nosy: +ned.deily
resolution:  -> fixed
stage:  -> resolved
status: open -> closed
type: enhancement -> 
versions: +Python 3.5, Python 3.6

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

From report at bugs.python.org  Sat Jun  4 13:24:59 2016
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 04 Jun 2016 17:24:59 +0000
Subject: [docs] [issue19234] socket.fileno() documentation
In-Reply-To: <52597A2F.60807@python.org>
Message-ID: <20160604172455.52083.9211.C2A6BEB0@psf.io>


Roundup Robot added the comment:

New changeset d83007ab69e2 by Kushal Das in branch '3.5':
Issue #19234: Documents socket.fileno() returns -1 on failure
https://hg.python.org/cpython/rev/d83007ab69e2

New changeset 3c745b656dca by Kushal Das in branch 'default':
Issue #19234: Merge from 3.5
https://hg.python.org/cpython/rev/3c745b656dca

----------
nosy: +python-dev

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

From report at bugs.python.org  Sat Jun  4 15:42:42 2016
From: report at bugs.python.org (Memeplex)
Date: Sat, 04 Jun 2016 19:42:42 +0000
Subject: [docs] [issue27221] [multiprocessing] Doc is outdated regarding
 method picklability
Message-ID: <1465069362.83.0.142351405451.issue27221@psf.upfronthosting.co.za>


New submission from Memeplex:

The module documentation recommends...

More picklability

Ensure that all arguments to Process.__init__() are picklable. This means, in particular, that bound or unbound methods cannot be used directly as the target (unless you use the fork start method) ? just define a function and use that instead.

...but methods (bound and unbound) are now pickleable (given their self.object is picklable).

----------
assignee: docs at python
components: Documentation
messages: 267303
nosy: docs at python, memeplex
priority: normal
severity: normal
status: open
title: [multiprocessing] Doc is outdated regarding method picklability
versions: Python 3.5

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

From report at bugs.python.org  Sat Jun  4 15:42:52 2016
From: report at bugs.python.org (Jelle Zijlstra)
Date: Sat, 04 Jun 2016 19:42:52 +0000
Subject: [docs] [issue16851] Hint about correct ismethod and isfunction usage
In-Reply-To: <1357231289.77.0.0608728593688.issue16851@psf.upfronthosting.co.za>
Message-ID: <1465069372.66.0.983982755486.issue16851@psf.upfronthosting.co.za>


Jelle Zijlstra added the comment:

Sounds like this can be closed?

----------
nosy: +Jelle Zijlstra

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

From report at bugs.python.org  Sat Jun  4 18:36:03 2016
From: report at bugs.python.org (Berker Peksag)
Date: Sat, 04 Jun 2016 22:36:03 +0000
Subject: [docs] [issue16851] Hint about correct ismethod and isfunction usage
In-Reply-To: <1357231289.77.0.0608728593688.issue16851@psf.upfronthosting.co.za>
Message-ID: <1465079763.95.0.94958794181.issue16851@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Jun  4 23:08:16 2016
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 05 Jun 2016 03:08:16 +0000
Subject: [docs] [issue27203] Failing doctests in Doc/faq/programming.rst
In-Reply-To: <1464999592.59.0.0136488038508.issue27203@psf.upfronthosting.co.za>
Message-ID: <20160605030812.1235.31567.CBB5219D@psf.io>


Roundup Robot added the comment:

New changeset fea14da8442d by Senthil Kumaran in branch '3.5':
Issue27203 - Fix doctests Doc/faq/programming.rst.
https://hg.python.org/cpython/rev/fea14da8442d

New changeset 4a072fff6945 by Senthil Kumaran in branch 'default':
[merge from 3.5] - Issue27203 - Fix doctests Doc/faq/programming.rst.
https://hg.python.org/cpython/rev/4a072fff6945

----------
nosy: +python-dev

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

From report at bugs.python.org  Sat Jun  4 23:12:22 2016
From: report at bugs.python.org (Senthil Kumaran)
Date: Sun, 05 Jun 2016 03:12:22 +0000
Subject: [docs] [issue27203] Failing doctests in Doc/faq/programming.rst
In-Reply-To: <1464999592.59.0.0136488038508.issue27203@psf.upfronthosting.co.za>
Message-ID: <1465096342.45.0.430104107259.issue27203@psf.upfronthosting.co.za>


Senthil Kumaran added the comment:

Thanks for the patch, Jelle Zijlstra. 

We don't have warnings in Doc/faq/programming.rst now, and this issue was specific to fix the doctests for it. I find it complete. Closing this issue.

----------
nosy: +orsenthil
resolution:  -> fixed
stage:  -> resolved
status: open -> closed
type:  -> behavior

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

From report at bugs.python.org  Sat Jun  4 23:53:43 2016
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 05 Jun 2016 03:53:43 +0000
Subject: [docs] [issue27202] make doctest fails on 2.7 release notes
In-Reply-To: <1464998646.05.0.234628246633.issue27202@psf.upfronthosting.co.za>
Message-ID: <20160605035339.21051.71837.072EA732@psf.io>


Roundup Robot added the comment:

New changeset 70af472451cb by Senthil Kumaran in branch '3.5':
issue27202 - Exclude 2.x release notes from python3 make doctests.
https://hg.python.org/cpython/rev/70af472451cb

New changeset 2bb806539ca6 by Senthil Kumaran in branch 'default':
[merge from 3.5] - issue27202 - Exclude 2.x release notes from python3 make doctests.
https://hg.python.org/cpython/rev/2bb806539ca6

----------
nosy: +python-dev

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

From report at bugs.python.org  Sat Jun  4 23:54:15 2016
From: report at bugs.python.org (Senthil Kumaran)
Date: Sun, 05 Jun 2016 03:54:15 +0000
Subject: [docs] [issue27202] make doctest fails on 2.7 release notes
In-Reply-To: <1464998646.05.0.234628246633.issue27202@psf.upfronthosting.co.za>
Message-ID: <1465098855.53.0.669380838164.issue27202@psf.upfronthosting.co.za>


Senthil Kumaran added the comment:

Thanks for your contribution, Jelle.

----------
nosy: +orsenthil
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed
type:  -> behavior

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

From report at bugs.python.org  Sun Jun  5 00:03:23 2016
From: report at bugs.python.org (Berker Peksag)
Date: Sun, 05 Jun 2016 04:03:23 +0000
Subject: [docs] [issue27202] make doctest fails on 2.7 release notes
In-Reply-To: <1464998646.05.0.234628246633.issue27202@psf.upfronthosting.co.za>
Message-ID: <1465099403.35.0.346067293285.issue27202@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Perhaps it would be better to exclude all files in Doc/whatsnew.

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

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

From report at bugs.python.org  Sun Jun  5 00:33:07 2016
From: report at bugs.python.org (Berker Peksag)
Date: Sun, 05 Jun 2016 04:33:07 +0000
Subject: [docs] [issue27202] make doctest fails on 2.7 release notes
In-Reply-To: <1464998646.05.0.234628246633.issue27202@psf.upfronthosting.co.za>
Message-ID: <1465101186.98.0.181649824424.issue27202@psf.upfronthosting.co.za>


Berker Peksag added the comment:

By the way, after this I'm getting the following warnings:

/Users/berkerpeksag/projects/cpython/Doc/whatsnew/index.rst:11: WARNING: toctree contains reference to nonexisting document 'whatsnew/2.7'
/Users/berkerpeksag/projects/cpython/Doc/whatsnew/index.rst:11: WARNING: toctree contains reference to nonexisting document 'whatsnew/2.6'
/Users/berkerpeksag/projects/cpython/Doc/whatsnew/index.rst:11: WARNING: toctree contains reference to nonexisting document 'whatsnew/2.5'
/Users/berkerpeksag/projects/cpython/Doc/whatsnew/index.rst:11: WARNING: toctree contains reference to nonexisting document 'whatsnew/2.4'
/Users/berkerpeksag/projects/cpython/Doc/whatsnew/index.rst:11: WARNING: toctree contains reference to nonexisting document 'whatsnew/2.3'
/Users/berkerpeksag/projects/cpython/Doc/whatsnew/index.rst:11: WARNING: toctree contains reference to nonexisting document 'whatsnew/2.2'
/Users/berkerpeksag/projects/cpython/Doc/whatsnew/index.rst:11: WARNING: toctree contains reference to nonexisting document 'whatsnew/2.1'
/Users/berkerpeksag/projects/cpython/Doc/whatsnew/index.rst:11: WARNING: toctree contains reference to nonexisting document 'whatsnew/2.0'

----------

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

From report at bugs.python.org  Sun Jun  5 00:37:49 2016
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 05 Jun 2016 04:37:49 +0000
Subject: [docs] [issue17888] docs: more information on documentation team
In-Reply-To: <1367412914.06.0.588625037016.issue17888@psf.upfronthosting.co.za>
Message-ID: <20160605043745.21538.9226.2DD05934@psf.io>


Roundup Robot added the comment:

New changeset 3136c67eac4d by Berker Peksag in branch '3.5':
Issue #17888: Add a note about contributing to Python docs
https://hg.python.org/cpython/rev/3136c67eac4d

New changeset 1f8181e66b36 by Berker Peksag in branch 'default':
Issue #17888: Merge from 3.5
https://hg.python.org/cpython/rev/1f8181e66b36

----------
nosy: +python-dev

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

From report at bugs.python.org  Sun Jun  5 00:38:34 2016
From: report at bugs.python.org (Jelle Zijlstra)
Date: Sun, 05 Jun 2016 04:38:34 +0000
Subject: [docs] [issue27202] make doctest fails on 2.7 release notes
In-Reply-To: <1464998646.05.0.234628246633.issue27202@psf.upfronthosting.co.za>
Message-ID: <1465101514.46.0.0442068584282.issue27202@psf.upfronthosting.co.za>


Jelle Zijlstra added the comment:

Yes, I realized this patch is wrong: it excludes the 2.7 release notes from all make steps, not just `make doctest`.

The attached patch reverts the conf.py change and instead uses directives to skip most doctests in the 2.7 release notes. The other 2.x release notes have no failing doctests.

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

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

From report at bugs.python.org  Sun Jun  5 00:38:50 2016
From: report at bugs.python.org (Berker Peksag)
Date: Sun, 05 Jun 2016 04:38:50 +0000
Subject: [docs] [issue17888] docs: more information on documentation team
In-Reply-To: <1367412914.06.0.588625037016.issue17888@psf.upfronthosting.co.za>
Message-ID: <1465101529.96.0.495917133898.issue17888@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Thanks for the patches Terry and Laura.

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

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

From report at bugs.python.org  Sun Jun  5 00:53:53 2016
From: report at bugs.python.org (Jelle Zijlstra)
Date: Sun, 05 Jun 2016 04:53:53 +0000
Subject: [docs] [issue27202] make doctest fails on 2.7 release notes
In-Reply-To: <1464998646.05.0.234628246633.issue27202@psf.upfronthosting.co.za>
Message-ID: <1465102433.55.0.386011332393.issue27202@psf.upfronthosting.co.za>


Changes by Jelle Zijlstra <jelle.zijlstra at gmail.com>:


Added file: http://bugs.python.org/file43226/issue27202-revised.patch

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

From berker.peksag at gmail.com  Sun Jun  5 00:58:34 2016
From: berker.peksag at gmail.com (berker.peksag at gmail.com)
Date: Sun, 05 Jun 2016 04:58:34 -0000
Subject: [docs] Mention PYTHONFAULTHANDLER in the man page (issue 24459)
Message-ID: <20160605045834.13576.99182@psf.upfronthosting.co.za>


http://bugs.python.org/review/24459/diff/17478/Misc/python.man
File Misc/python.man (right):

http://bugs.python.org/review/24459/diff/17478/Misc/python.man#newcode434
Misc/python.man:434: Set the Python memory allocators and/or install
debug hooks.
I think we can make the PYTHONMALLOC documention a bit shorter.

Detailed descriptions of memory allocations and debug hooks can be
removed. It would more than enough to just say "these are the available
memory allocatos and those are the available debug hooks". If people
need more more information about what pymalloc or malloc_debug does they
should read the online documentation.

http://bugs.python.org/review/24459/diff/17478/Misc/python.man#newcode454
Misc/python.man:454: When Python is compiled in release mode, the
default is "pymalloc". When
This paragraph can stay.

http://bugs.python.org/review/24459/diff/17478/Misc/python.man#newcode458
Misc/python.man:458: If Python is configured without "pymalloc" support,
"pymalloc" and
This paragraph can stay.

http://bugs.python.org/review/24459/diff/17478/Misc/python.man#newcode469
Misc/python.man:469: This variable is ignored if the PYTHONMALLOC
environment variable
$PYTHONMALLOC

http://bugs.python.org/review/24459/diff/17478/Misc/python.man#newcode479
Misc/python.man:479: stored in a traceback of a trace. For example,
"PYTHONTRACEMALLOC=1"
.IB PYTHONTRACEMALLOC=1

http://bugs.python.org/review/24459/diff/17478/Misc/python.man#newcode481
Misc/python.man:481: .IR tracemalloc.start()
I think this is missing "documentation" here.

http://bugs.python.org/review/24459/diff/17478/Misc/python.man#newcode488
Misc/python.man:488: dump the Python traceback. This is equivalent to -X
"faulthandler" option.
Move "This is equivalent ..." part to a new paragraph.

http://bugs.python.org/review/24459/diff/17478/Misc/python.man#newcode490
Misc/python.man:490: If this environment variable is set, "sys.argv[0]"
will be set to its value instead of the value got through the C runtime.
Only works on Mac OS X.
.IB sys.argv[0}

http://bugs.python.org/review/24459/diff/17478/Misc/python.man#newcode490
Misc/python.man:490: If this environment variable is set, "sys.argv[0]"
will be set to its value instead of the value got through the C runtime.
Only works on Mac OS X.
Please also wrap these long lines.

http://bugs.python.org/review/24459/diff/17478/Misc/python.man#newcode493
Misc/python.man:493: Setting these variables only has an effect in a
debug build of Python, that is, if Python was configured with the
--with-pydebug build option.
fB\--with-pydebug\fP

http://bugs.python.org/review/24459/

From report at bugs.python.org  Sun Jun  5 00:59:07 2016
From: report at bugs.python.org (Berker Peksag)
Date: Sun, 05 Jun 2016 04:59:07 +0000
Subject: [docs] [issue24459] Mention PYTHONFAULTHANDLER in the man page
In-Reply-To: <1434487895.85.0.561507121326.issue24459@psf.upfronthosting.co.za>
Message-ID: <1465102747.55.0.761523252117.issue24459@psf.upfronthosting.co.za>


Berker Peksag added the comment:

I left some review comments on Rietveld: http://bugs.python.org/review/24459/

----------

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

From report at bugs.python.org  Sun Jun  5 01:23:23 2016
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 05 Jun 2016 05:23:23 +0000
Subject: [docs] [issue27202] make doctest fails on 2.7 release notes
In-Reply-To: <1464998646.05.0.234628246633.issue27202@psf.upfronthosting.co.za>
Message-ID: <20160605052320.120019.351.EB79690F@psf.io>


Roundup Robot added the comment:

New changeset 378c1d09b256 by Senthil Kumaran in branch '3.5':
issue27202 - Fix the mistake in changesets 70af472451cb (3.5) and 2bb806539ca6 (3.6)
https://hg.python.org/cpython/rev/378c1d09b256

New changeset 31573473a50e by Senthil Kumaran in branch 'default':
[merge from 3.5] - issue27202 - Fix the mistake in changesets 70af472451cb (3.5) and 2bb806539ca6 (3.6)
https://hg.python.org/cpython/rev/31573473a50e

----------

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

From report at bugs.python.org  Sun Jun  5 01:24:07 2016
From: report at bugs.python.org (Senthil Kumaran)
Date: Sun, 05 Jun 2016 05:24:07 +0000
Subject: [docs] [issue27202] make doctest fails on 2.7 release notes
In-Reply-To: <1464998646.05.0.234628246633.issue27202@psf.upfronthosting.co.za>
Message-ID: <1465104246.85.0.493382789118.issue27202@psf.upfronthosting.co.za>


Senthil Kumaran added the comment:

Addressed the problem with the previous commit.

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

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

From report at bugs.python.org  Sun Jun  5 02:34:58 2016
From: report at bugs.python.org (SilentGhost)
Date: Sun, 05 Jun 2016 06:34:58 +0000
Subject: [docs] [issue27188] sqlite3 execute* methods return value not
 documented
In-Reply-To: <1464904414.88.0.548243958784.issue27188@psf.upfronthosting.co.za>
Message-ID: <1465108498.46.0.798988647899.issue27188@psf.upfronthosting.co.za>


SilentGhost added the comment:

Thanks for the patch, Dave. For whatever reason it doesn't seem to apply cleanly to the current tip, would you mind preparing a new patch that does?

----------
assignee:  -> docs at python
components: +Documentation
nosy: +SilentGhost, berker.peksag, docs at python, ghaering
stage:  -> patch review
type: enhancement -> behavior

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

From report at bugs.python.org  Sun Jun  5 07:19:28 2016
From: report at bugs.python.org (Arno-Can Uestuensoez)
Date: Sun, 05 Jun 2016 11:19:28 +0000
Subject: [docs] [issue27228] just for clearing: os.path.normpath("file://a")
 returns "file:/a"
Message-ID: <1465125568.33.0.580386729971.issue27228@psf.upfronthosting.co.za>


New submission from Arno-Can Uestuensoez:

I am currently finishing a file system library and use 'os.path.normpath' for canonical input into match-operations.

So already found Issue26329 - IEEE-1003.1-Chap 4.2 and written a comment. But I guess this issue should be handled seperately.

Now have to deal by myself with the eventual prefix 'file://' for input, and guess it should be supported. I did not found a statement on this case, so issue this for clarification. The 'os.path.normpath' call simply replaces subsequent os.sep, when they are not leading as 1003.1 states. But how should the following examples be handled:

  file:////a   => /a OR //a ???

  file://///a  => /a  OK
  file:///a    => /a  OK

----------
assignee: docs at python
components: Documentation
messages: 267407
nosy: Fred Rolland, Winterflower, acue, docs at python, ebarry, lemburg, serhiy.storchaka
priority: normal
severity: normal
status: open
title: just for clearing: os.path.normpath("file://a") returns "file:/a"
type: behavior
versions: Python 2.7

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

From report at bugs.python.org  Sun Jun  5 07:47:30 2016
From: report at bugs.python.org (Steven D'Aprano)
Date: Sun, 05 Jun 2016 11:47:30 +0000
Subject: [docs] [issue27228] just for clearing: os.path.normpath("file://a")
 returns "file:/a"
In-Reply-To: <1465125568.33.0.580386729971.issue27228@psf.upfronthosting.co.za>
Message-ID: <1465127250.65.0.709098986639.issue27228@psf.upfronthosting.co.za>


Steven D'Aprano added the comment:

"file://a" is a valid relative file path, for a directory called "file:" and a file called "a", so normpath should return "file:/a".

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

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

From report at bugs.python.org  Sun Jun  5 08:11:02 2016
From: report at bugs.python.org (Georg Brandl)
Date: Sun, 05 Jun 2016 12:11:02 +0000
Subject: [docs] [issue27228] just for clearing: os.path.normpath("file://a")
 returns "file:/a"
In-Reply-To: <1465125568.33.0.580386729971.issue27228@psf.upfronthosting.co.za>
Message-ID: <1465128662.04.0.132225729501.issue27228@psf.upfronthosting.co.za>


Georg Brandl added the comment:

`os.path` does not handle URIs of any type, so this behavior is correct as Steven says.

----------
nosy: +georg.brandl
resolution:  -> not a bug
status: open -> closed

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

From report at bugs.python.org  Sun Jun  5 13:26:45 2016
From: report at bugs.python.org (Berker Peksag)
Date: Sun, 05 Jun 2016 17:26:45 +0000
Subject: [docs] [issue27188] sqlite3 execute* methods return value not
 documented
In-Reply-To: <1464904414.88.0.548243958784.issue27188@psf.upfronthosting.co.za>
Message-ID: <1465147605.14.0.234032712619.issue27188@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Could you also change the function signatures from

    .. method:: execute(sql, [parameters])

to

    .. method:: execute(sql[, parameters])

and document that parameters should be list (or sequence or iterable -- I'm a the airport now so I can't check what is the correct term)?

I'm not a native speaker but this sentence sounds a bit weird to me:

    This is a nonstandard shortcut that creates a cursor object by calling the cursor method, calls the cursor's :meth:`execute <Cursor.execute>` [...]

Perhaps it can be changed to


    This is a nonstandard shortcut that creates a cursor object by calling the cursor's :meth:`execute <Cursor.execute>` method [...]

Also, please change the following usages

    :meth:`execute <Cursor.execute>`

with

    :meth:`~Cursor.execute`

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

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

From report at bugs.python.org  Sun Jun  5 14:34:13 2016
From: report at bugs.python.org (Jelle Zijlstra)
Date: Sun, 05 Jun 2016 18:34:13 +0000
Subject: [docs] [issue27221] [multiprocessing] Doc is outdated regarding
 method picklability
In-Reply-To: <1465069362.83.0.142351405451.issue27221@psf.upfronthosting.co.za>
Message-ID: <1465151652.99.0.397655525494.issue27221@psf.upfronthosting.co.za>


Jelle Zijlstra added the comment:

Patch attached. I also checked that this case is tested, and it looks like the Bunch object in Lib/test/_test_multiprocessing.py uses a method as its target.

----------
keywords: +patch
nosy: +Jelle Zijlstra
Added file: http://bugs.python.org/file43243/issue27233.patch

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

From report at bugs.python.org  Sun Jun  5 14:35:46 2016
From: report at bugs.python.org (Jelle Zijlstra)
Date: Sun, 05 Jun 2016 18:35:46 +0000
Subject: [docs] [issue19234] socket.fileno() documentation
In-Reply-To: <52597A2F.60807@python.org>
Message-ID: <1465151746.68.0.619646703157.issue19234@psf.upfronthosting.co.za>


Jelle Zijlstra added the comment:

This looks fixed.

----------
nosy: +Jelle Zijlstra
resolution:  -> fixed
status: open -> closed

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

From report at bugs.python.org  Sun Jun  5 14:38:20 2016
From: report at bugs.python.org (Jelle Zijlstra)
Date: Sun, 05 Jun 2016 18:38:20 +0000
Subject: [docs] [issue27221] [multiprocessing] Doc is outdated regarding
 method picklability
In-Reply-To: <1465069362.83.0.142351405451.issue27221@psf.upfronthosting.co.za>
Message-ID: <1465151900.01.0.963148658935.issue27221@psf.upfronthosting.co.za>


Changes by Jelle Zijlstra <jelle.zijlstra at gmail.com>:


Removed file: http://bugs.python.org/file43243/issue27233.patch

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

From report at bugs.python.org  Sun Jun  5 14:38:40 2016
From: report at bugs.python.org (Jelle Zijlstra)
Date: Sun, 05 Jun 2016 18:38:40 +0000
Subject: [docs] [issue27221] [multiprocessing] Doc is outdated regarding
 method picklability
In-Reply-To: <1465069362.83.0.142351405451.issue27221@psf.upfronthosting.co.za>
Message-ID: <1465151920.44.0.419522787898.issue27221@psf.upfronthosting.co.za>


Changes by Jelle Zijlstra <jelle.zijlstra at gmail.com>:


Added file: http://bugs.python.org/file43244/issue27221.patch

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

From report at bugs.python.org  Sun Jun  5 14:45:09 2016
From: report at bugs.python.org (Jelle Zijlstra)
Date: Sun, 05 Jun 2016 18:45:09 +0000
Subject: [docs] [issue27215] Docstrings of Sequence and MutableSequence
 seems not right
In-Reply-To: <1465032017.04.0.0861396062626.issue27215@psf.upfronthosting.co.za>
Message-ID: <1465152309.73.0.0854071801086.issue27215@psf.upfronthosting.co.za>


Jelle Zijlstra added the comment:

The docstrings (at least in 3.6) say subclasses must override __new__ *or* __init__. However, I think this is wrong too. The following is a correct (if not very useful) implementation of Sequence:

>>> import collections.abc
>>> class MySequence(collections.abc.Sequence):
...     def __getitem__(self, key):
...             raise IndexError(key)
...     def __len__(self):
...             return 0
... 

Other abc docstrings also don't claim that __init__ or __new__ must be implemented. The attached patch fixes the docstrings.

----------
keywords: +patch
nosy: +Jelle Zijlstra
Added file: http://bugs.python.org/file43245/issue27215.patch

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

From report at bugs.python.org  Sun Jun  5 15:00:54 2016
From: report at bugs.python.org (Jelle Zijlstra)
Date: Sun, 05 Jun 2016 19:00:54 +0000
Subject: [docs] [issue15243] Misleading documentation for __prepare__
In-Reply-To: <1341328118.33.0.670602196671.issue15243@psf.upfronthosting.co.za>
Message-ID: <1465153254.87.0.957747195902.issue15243@psf.upfronthosting.co.za>


Jelle Zijlstra added the comment:

I think the current documentation is correct and doesn't need changes. There is also already an example of a working __prepare__ method.

----------
nosy: +Jelle Zijlstra

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

From report at bugs.python.org  Sun Jun  5 15:02:43 2016
From: report at bugs.python.org (Jelle Zijlstra)
Date: Sun, 05 Jun 2016 19:02:43 +0000
Subject: [docs] [issue19489] move quick search box above TOC
In-Reply-To: <1383546510.68.0.587653327623.issue19489@psf.upfronthosting.co.za>
Message-ID: <1465153363.04.0.634013653729.issue19489@psf.upfronthosting.co.za>


Jelle Zijlstra added the comment:

Yes, I don't think we control this, the layout is generated by sphinx.

----------
nosy: +Jelle Zijlstra

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

From report at bugs.python.org  Sun Jun  5 15:14:45 2016
From: report at bugs.python.org (Jelle Zijlstra)
Date: Sun, 05 Jun 2016 19:14:45 +0000
Subject: [docs] [issue26582] asyncio documentation links to wrong
 CancelledError
In-Reply-To: <1458225953.38.0.399231880747.issue26582@psf.upfronthosting.co.za>
Message-ID: <1465154084.97.0.271712572389.issue26582@psf.upfronthosting.co.za>


Jelle Zijlstra added the comment:

This patch documents CancelledError in the asyncio documentation.

----------
keywords: +patch
nosy: +Jelle Zijlstra
Added file: http://bugs.python.org/file43246/issue26582.patch

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

From report at bugs.python.org  Sun Jun  5 15:58:01 2016
From: report at bugs.python.org (Joshua Jay Herman)
Date: Sun, 05 Jun 2016 19:58:01 +0000
Subject: [docs] [issue24459] Mention PYTHONFAULTHANDLER in the man page
In-Reply-To: <1434487895.85.0.561507121326.issue24459@psf.upfronthosting.co.za>
Message-ID: <1465156681.03.0.237531719491.issue24459@psf.upfronthosting.co.za>


Joshua Jay Herman added the comment:

I have reviewed the comments on Rietveld and made the changes to the patch. Attached is the revised version.

----------
Added file: http://bugs.python.org/file43248/addMissingEnvironmentVariables-review-1.patch

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

From report at bugs.python.org  Sun Jun  5 20:10:02 2016
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 06 Jun 2016 00:10:02 +0000
Subject: [docs] [issue27215] Docstrings of Sequence and MutableSequence
 seems not right
In-Reply-To: <1465032017.04.0.0861396062626.issue27215@psf.upfronthosting.co.za>
Message-ID: <1465171802.71.0.105964255303.issue27215@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

I think you're reading too much into the docs.  Most useful classes provide a __new__ or __init__ to put data into instances.  The docs are simply saying that that responsibility lies with the implementer rather than with the ABC.

IMO, the docs are more useful as-is.  Were we to accept the patch, it wouldn't be long before another user reported a bug saying that the implemented the other methods but the class didn't do anything useful.

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

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

From report at bugs.python.org  Sun Jun  5 20:40:45 2016
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 06 Jun 2016 00:40:45 +0000
Subject: [docs] [issue26014] Guide users to the newer package install
 instructions
In-Reply-To: <1451999065.99.0.467691766338.issue26014@psf.upfronthosting.co.za>
Message-ID: <20160606004041.23482.86377.9C963D5B@psf.io>


Roundup Robot added the comment:

New changeset 71fc5b246f5b by Ned Deily in branch '2.7':
Issue #26014: Guide 2.7 users to the new packaging documentation:
https://hg.python.org/cpython/rev/71fc5b246f5b

New changeset f5fd646b265b by Ned Deily in branch '3.5':
Issue #26014: Update 3.x packaging documentation:
https://hg.python.org/cpython/rev/f5fd646b265b

New changeset 7583d65da2ad by Ned Deily in branch 'default':
Issue #26014: merge from 3.5
https://hg.python.org/cpython/rev/7583d65da2ad

----------
nosy: +python-dev

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

From report at bugs.python.org  Sun Jun  5 20:41:08 2016
From: report at bugs.python.org (Yoni Lavi)
Date: Mon, 06 Jun 2016 00:41:08 +0000
Subject: [docs] [issue22558] Missing doc links to source code for
 Python-coded modules.
In-Reply-To: <1412514337.47.0.069385783283.issue22558@psf.upfronthosting.co.za>
Message-ID: <1465173667.34.0.454925411894.issue22558@psf.upfronthosting.co.za>


Yoni Lavi added the comment:

Thank you very much for the detailed review, Nathan. Attached is a new patch that resolves the merge issues, and some of the other issues you mentioned. 

Concerning the index reference in marshal.rst , ah, yes, I missed that it only related to a single paragraph. I reverted that change.

Concerning versionadded in unittest.mock-examples.rst, you're right, I saw that this was already available elsewhere and removed it for consistency with other similar intro files. I'll revert if you tell me.

I think I fixed all the smaller issues you mentioned, too. I wasn't sure about the fuzz; I didn't see any issue, so I assume it was automatically resolved by `hg update`. 

I don't have any input to give concerning the 'subjective' issues and will be happy to wait for a decision.

----------
Added file: http://bugs.python.org/file43252/mywork3.patch

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

From report at bugs.python.org  Sun Jun  5 20:46:07 2016
From: report at bugs.python.org (Ned Deily)
Date: Mon, 06 Jun 2016 00:46:07 +0000
Subject: [docs] [issue26014] Guide users to the newer package install
 instructions
In-Reply-To: <1451999065.99.0.467691766338.issue26014@psf.upfronthosting.co.za>
Message-ID: <1465173967.42.0.0630825844669.issue26014@psf.upfronthosting.co.za>


Ned Deily added the comment:

Thanks, Susan, for your suggested patch.  I expanded on it to address all of the issues Nick brought up and then some, such as also updating to the changed setuptools doc link.  Pushed for release in 2.7.12, 3.5.2, and 3.6.0.

----------
nosy: +ned.deily
resolution:  -> fixed
stage: needs patch -> resolved
status: open -> closed
versions: +Python 2.7, Python 3.5, Python 3.6

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

From kenneth.hill at autodesk.com  Sat Jun  4 06:08:09 2016
From: kenneth.hill at autodesk.com (Kenneth Hill)
Date: Sat, 4 Jun 2016 10:08:09 +0000
Subject: [docs] Dead link
Message-ID: <9651B62C-A005-4D18-8919-E696C77FA98A@autodesk.com>

Greetings,

I noticed a dead link on the page https://docs.python.org/3/library/distutils.html#module-distutils.  Clicking on ?setuptools? brings you to a page https://setuptools.pypa.io/en/latest/setuptools.html, which complains that ?this page does not exist yet.?

Regards,
Ken
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160604/f0fed36e/attachment.html>

From report at bugs.python.org  Mon Jun  6 12:27:31 2016
From: report at bugs.python.org (Nathan Harold)
Date: Mon, 06 Jun 2016 16:27:31 +0000
Subject: [docs] [issue22558] Missing doc links to source code for
 Python-coded modules.
In-Reply-To: <1412514337.47.0.069385783283.issue22558@psf.upfronthosting.co.za>
Message-ID: <1465230451.52.0.5719099354.issue22558@psf.upfronthosting.co.za>


Nathan Harold added the comment:

I went over the sections I above called "Other/Smaller details" as addressed in mywork3.patch.  I think they look fine.  The patch applies seamlessly to both 3.5 and 3.6.

For reference, since I noted them when I reviewed mywork2.patch last week, here are the packages at issue in the question about links to packages:

Package docs in which the patch in this issue adds a link to __init__.py: dbm.rst, email.rst, importlib.rst, json.rst, msilib.rst, tkinter.rst, unittest.rst, xml.dom.rst, xml.sax.rst

Package docs in which the patch in this issue adds a link to a directory: 2to3.rst, email.mime.rst, idle.rst, multiprocessing.rst, sqlite3.rst, urllib.rst, venv.rst, xml.rst

Also, I noticed that asyncio.rst provides a precedent for linking to a source directory.  So both ways have been done before.

----------

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

From report at bugs.python.org  Mon Jun  6 14:59:27 2016
From: report at bugs.python.org (Emanuel Barry)
Date: Mon, 06 Jun 2016 18:59:27 +0000
Subject: [docs] [issue27242] Clarify the use cases of NotImplemented in the
 docs
Message-ID: <1465239567.69.0.773832868585.issue27242@psf.upfronthosting.co.za>


New submission from Emanuel Barry:

The NotImplemented docs aren't explicit enough when it comes to where it can/should be used. Patch attached.

----------
assignee: docs at python
components: Documentation
files: NotImplemented_wording_1.patch
keywords: patch
messages: 267543
nosy: docs at python, ebarry
priority: normal
severity: normal
stage: patch review
status: open
title: Clarify the use cases of NotImplemented in the docs
type: enhancement
versions: Python 3.6
Added file: http://bugs.python.org/file43263/NotImplemented_wording_1.patch

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

From report at bugs.python.org  Mon Jun  6 18:22:25 2016
From: report at bugs.python.org (Guido van Rossum)
Date: Mon, 06 Jun 2016 22:22:25 +0000
Subject: [docs] [issue27242] Clarify the use cases of NotImplemented in the
 docs
In-Reply-To: <1465239567.69.0.773832868585.issue27242@psf.upfronthosting.co.za>
Message-ID: <1465251744.99.0.834303108066.issue27242@psf.upfronthosting.co.za>


Guido van Rossum added the comment:

LGTM

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

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

From report at bugs.python.org  Mon Jun  6 18:31:53 2016
From: report at bugs.python.org (Ethan Furman)
Date: Mon, 06 Jun 2016 22:31:53 +0000
Subject: [docs] [issue27242] Clarify the use cases of NotImplemented in the
 docs
In-Reply-To: <1465239567.69.0.773832868585.issue27242@psf.upfronthosting.co.za>
Message-ID: <1465252313.41.0.7561804161.issue27242@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Mon Jun  6 18:44:37 2016
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 06 Jun 2016 22:44:37 +0000
Subject: [docs] [issue27242] Clarify the use cases of NotImplemented in the
 docs
In-Reply-To: <1465239567.69.0.773832868585.issue27242@psf.upfronthosting.co.za>
Message-ID: <1465253077.71.0.370645344613.issue27242@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

It would be nice to also clarify and differentiate NotImplementedError as well.

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

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

From report at bugs.python.org  Mon Jun  6 20:34:47 2016
From: report at bugs.python.org (Dave Sawyer)
Date: Tue, 07 Jun 2016 00:34:47 +0000
Subject: [docs] [issue27188] sqlite3 execute* methods return value not
 documented
In-Reply-To: <1464904414.88.0.548243958784.issue27188@psf.upfronthosting.co.za>
Message-ID: <1465259687.41.0.911358865173.issue27188@psf.upfronthosting.co.za>


Dave Sawyer added the comment:

Updated optional parameters. Fixed executescript which takes a single parameter. The English is correct - one needs to looks at the verbs to be sure they match in tense and number. Like "He OPENS the fridge, GRABS the milk, and DRINKS it." This method CREATES a cursor, CALLS the method, and RETURNS the cursor.

----------
Added file: http://bugs.python.org/file43269/issue27188_patch2.txt

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

From report at bugs.python.org  Mon Jun  6 20:39:58 2016
From: report at bugs.python.org (Dave Sawyer)
Date: Tue, 07 Jun 2016 00:39:58 +0000
Subject: [docs] [issue27188] sqlite3 execute* methods return value not
 documented
In-Reply-To: <1465108498.46.0.798988647899.issue27188@psf.upfronthosting.co.za>
Message-ID: <CADst8Z4061tkLaqK0f-zopc42g2VaFpVJFKnJ-KGBhQmUfFk4w@mail.gmail.com>


Dave Sawyer added the comment:

No problem. I did a pull and reposted with additional fixes suggested by
Berker and one copy/paste error I spotted.

On Sat, Jun 4, 2016 at 11:34 PM, SilentGhost <report at bugs.python.org> wrote:

>
> SilentGhost added the comment:
>
> Thanks for the patch, Dave. For whatever reason it doesn't seem to apply
> cleanly to the current tip, would you mind preparing a new patch that does?
>
> ----------
> assignee:  -> docs at python
> components: +Documentation
> nosy: +SilentGhost, berker.peksag, docs at python, ghaering
> stage:  -> patch review
> type: enhancement -> behavior
>
> _______________________________________
> Python tracker <report at bugs.python.org>
> <http://bugs.python.org/issue27188>
> _______________________________________
>

----------

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

From report at bugs.python.org  Mon Jun  6 22:38:20 2016
From: report at bugs.python.org (Berker Peksag)
Date: Tue, 07 Jun 2016 02:38:20 +0000
Subject: [docs] [issue19234] socket.fileno() documentation
In-Reply-To: <52597A2F.60807@python.org>
Message-ID: <1465267100.0.0.265987985366.issue19234@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Tue Jun  7 00:35:35 2016
From: report at bugs.python.org (Emanuel Barry)
Date: Tue, 07 Jun 2016 04:35:35 +0000
Subject: [docs] [issue27242] Make the docs for NotImplemented &
 NotImplementedError unambigous
In-Reply-To: <1465239567.69.0.773832868585.issue27242@psf.upfronthosting.co.za>
Message-ID: <1465274134.52.0.714413325106.issue27242@psf.upfronthosting.co.za>


Emanuel Barry added the comment:

Added further notes to `NotImplemented` and `NotImplementedError` to clearly state the differences between the two. I also added some more details to `TypeError` - I'm amazed at how little was described for such a common exception!

Maybe I explained a bit too thoroughly in some parts, but I like to have everything unambigous and well explained.

I haven't yet spent the time to learn how to build documentation (Soon?), so I'm going off the existing docs, and I try to follow the style as closely as possible.

----------
title: Clarify the use cases of NotImplemented in the docs -> Make the docs for NotImplemented & NotImplementedError unambigous
Added file: http://bugs.python.org/file43272/NotImplemented_exceptions_wording_2.patch

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

From report at bugs.python.org  Tue Jun  7 01:15:45 2016
From: report at bugs.python.org (Emanuel Barry)
Date: Tue, 07 Jun 2016 05:15:45 +0000
Subject: [docs] [issue27242] Make the docs for NotImplemented &
 NotImplementedError unambigous
In-Reply-To: <1465239567.69.0.773832868585.issue27242@psf.upfronthosting.co.za>
Message-ID: <1465276545.65.0.995340914626.issue27242@psf.upfronthosting.co.za>


Emanuel Barry added the comment:

New patch with small tweaks. Thanks Jelle for the comments!

----------
Added file: http://bugs.python.org/file43273/NotImplemented_exceptions_wording_3.patch

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

From berker.peksag at gmail.com  Tue Jun  7 03:35:10 2016
From: berker.peksag at gmail.com (berker.peksag at gmail.com)
Date: Tue, 07 Jun 2016 07:35:10 -0000
Subject: [docs] [multiprocessing] Doc is outdated regarding method
 picklability (issue 27221)
Message-ID: <20160607073510.986.39543@psf.upfronthosting.co.za>


http://bugs.python.org/review/27221/diff/17535/Doc/library/multiprocessing.rst
File Doc/library/multiprocessing.rst (right):

http://bugs.python.org/review/27221/diff/17535/Doc/library/multiprocessing.rst#newcode2736
Doc/library/multiprocessing.rst:2736: Before version 3.5, bound or
unbound methods could not be used directly
indendation is wrong here

     .. versionchanged:: 3.5
        Foo bar ...

http://bugs.python.org/review/27221/diff/17535/Doc/library/multiprocessing.rst#newcode2736
Doc/library/multiprocessing.rst:2736: Before version 3.5, bound or
unbound methods could not be used directly
"Before version 3.5," doesn't seem to be necessary.

``.. versionchanged:: 3.5`` will be rendered as "Changed in version
3.5:" so the sentence could be changed to match that.

http://bugs.python.org/review/27221/diff/17535/Doc/library/multiprocessing.rst#newcode2736
Doc/library/multiprocessing.rst:2736: Before version 3.5, bound or
unbound methods could not be used directly
AFAIK there are no unbound methods in Python 3 anymore.

http://bugs.python.org/review/27221/diff/17535/Doc/library/multiprocessing.rst#newcode2737
Doc/library/multiprocessing.rst:2737: as the ``target`` (unless you used
the *fork* start method), because they
``target`` -> *target*

http://bugs.python.org/review/27221/

From report at bugs.python.org  Tue Jun  7 03:35:38 2016
From: report at bugs.python.org (Berker Peksag)
Date: Tue, 07 Jun 2016 07:35:38 +0000
Subject: [docs] [issue27221] multiprocessing documentation is outdated
 regarding method picklability
In-Reply-To: <1465069362.83.0.142351405451.issue27221@psf.upfronthosting.co.za>
Message-ID: <1465284938.6.0.911492303567.issue27221@psf.upfronthosting.co.za>


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


----------
nosy: +berker.peksag
stage:  -> patch review
title: [multiprocessing] Doc is outdated regarding method picklability -> multiprocessing documentation is outdated regarding method picklability
type:  -> behavior
versions: +Python 3.6

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

From ethan at stoneleaf.us  Mon Jun  6 18:31:44 2016
From: ethan at stoneleaf.us (ethan at stoneleaf.us)
Date: Mon, 06 Jun 2016 22:31:44 -0000
Subject: [docs] Clarify the use cases of NotImplemented in the docs
 (issue 27242)
Message-ID: <20160606223144.8717.71724@psf.upfronthosting.co.za>

http://bugs.python.org/review/27242/

From guido at python.org  Mon Jun  6 18:22:14 2016
From: guido at python.org (guido at python.org)
Date: Mon, 06 Jun 2016 22:22:14 -0000
Subject: [docs] Clarify the use cases of NotImplemented in the docs (issue
 27242)
Message-ID: <20160606222214.8717.13507@psf.upfronthosting.co.za>

LGTM!

http://bugs.python.org/review/27242/

From jelle.zijlstra at gmail.com  Tue Jun  7 00:52:08 2016
From: jelle.zijlstra at gmail.com (jelle.zijlstra at gmail.com)
Date: Tue, 07 Jun 2016 04:52:08 -0000
Subject: [docs] Clarify the use cases of NotImplemented in the docs
 (issue 27242)
Message-ID: <20160607045208.3972.67450@psf.upfronthosting.co.za>

A few minor comments, looks good overall.

Also confirmed that the docs build correctly with this patch.


http://bugs.python.org/review/27242/diff/17554/Doc/library/exceptions.rst
File Doc/library/exceptions.rst (right):

http://bugs.python.org/review/27242/diff/17554/Doc/library/exceptions.rst#newcode241
Doc/library/exceptions.rst:241: an operation is :exc:`TypeError`.
I'm not sure that is necessarily accurate. For example, maybe you only
support some operation on integers smaller than some threshold, and
raise ValueError if the integer is too big.

islice() did this in Python 2:

>>> islice([], 100000000000)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ValueError: Stop argument for islice() must be None or an integer: 0 <=
x <= maxint.

http://bugs.python.org/review/27242/diff/17554/Doc/library/exceptions.rst#newcode243
Doc/library/exceptions.rst:243: The purposes of :data:`NotImplemented`
and of this exception tend to be mixed,
"confused" sounds better than "mixed" here

http://bugs.python.org/review/27242/

From report at bugs.python.org  Tue Jun  7 11:03:10 2016
From: report at bugs.python.org (Ned Deily)
Date: Tue, 07 Jun 2016 15:03:10 +0000
Subject: [docs] [issue27221] multiprocessing documentation is outdated
 regarding method picklability
In-Reply-To: <1465069362.83.0.142351405451.issue27221@psf.upfronthosting.co.za>
Message-ID: <1465311790.77.0.949606921643.issue27221@psf.upfronthosting.co.za>


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


----------
nosy: +davin

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

From ethan at stoneleaf.us  Tue Jun  7 13:38:46 2016
From: ethan at stoneleaf.us (ethan at stoneleaf.us)
Date: Tue, 07 Jun 2016 17:38:46 -0000
Subject: [docs] Clarify the use cases of NotImplemented in the docs
 (issue 27242)
Message-ID: <20160607173846.986.8151@psf.upfronthosting.co.za>


http://bugs.python.org/review/27242/diff/17555/Doc/library/constants.rst
File Doc/library/constants.rst (right):

http://bugs.python.org/review/27242/diff/17555/Doc/library/constants.rst#newcode48
Doc/library/constants.rst:48: is the encouraged way to do this.
Still not sure of above section.  Asked about it on Python-Dev.

http://bugs.python.org/review/27242/diff/17555/Doc/library/exceptions.rst
File Doc/library/exceptions.rst (right):

http://bugs.python.org/review/27242/diff/17555/Doc/library/exceptions.rst#newcode246
Doc/library/exceptions.rst:246: the requested operation, and that it
should try the reflected version.
of the other operand

http://bugs.python.org/review/27242/

From report at bugs.python.org  Tue Jun  7 13:45:50 2016
From: report at bugs.python.org (Evelyn Mitchell)
Date: Tue, 07 Jun 2016 17:45:50 +0000
Subject: [docs] [issue27180] Doc/pathlib: Please describe the behaviour of
 Path().rename() is depends on the platform (same as os.rename())
In-Reply-To: <1464866299.22.0.549959469595.issue27180@psf.upfronthosting.co.za>
Message-ID: <1465321550.41.0.299019605283.issue27180@psf.upfronthosting.co.za>


Evelyn Mitchell added the comment:

*** cpythonmod/Doc/library/pathlib.rst  2016-06-07 11:29:07.200774979 -0600
--- cpython/Doc/library/pathlib.rst     2016-06-07 11:29:59.372777817 -0600
***************
*** 887,896 ****
  
  .. method:: Path.rename(target)
  
!    Rename this file or directory to the given *target*. On Unix, 
!    if *target* exists and is a file, it will be replaced silently 
!    if the user has permission. *target* can be either a string or 
!    another path object::
  
        >>> p = Path('foo')
        >>> p.open('w').write('some text')
--- 887,894 ----
  
  .. method:: Path.rename(target)
  
!    Rename this file or directory to the given *target*.  *target* can be
!    either a string or another path object::
  
        >>> p = Path('foo')
        >>> p.open('w').write('some text')

----------
nosy: +Evelyn Mitchell

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

From report at bugs.python.org  Tue Jun  7 14:52:40 2016
From: report at bugs.python.org (Emanuel Barry)
Date: Tue, 07 Jun 2016 18:52:40 +0000
Subject: [docs] [issue27242] Make the docs for NotImplemented &
 NotImplementedError unambigous
In-Reply-To: <1465239567.69.0.773832868585.issue27242@psf.upfronthosting.co.za>
Message-ID: <1465325560.74.0.592056474793.issue27242@psf.upfronthosting.co.za>


Emanuel Barry added the comment:

More tweaks after Ethan's comments. This is starting to get way outside of the realm of NotImplemented, but it still makes for a good reference to point confused users at.

----------
Added file: http://bugs.python.org/file43284/NotImplemented_exceptions_wording_4.patch

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

From report at bugs.python.org  Tue Jun  7 15:55:04 2016
From: report at bugs.python.org (Mark Summerfield)
Date: Tue, 07 Jun 2016 19:55:04 +0000
Subject: [docs] [issue27259] Possible missing deprecation warnings?
Message-ID: <1465329304.45.0.636759597708.issue27259@psf.upfronthosting.co.za>


New submission from Mark Summerfield:

In the docs for the array module:
https://docs.python.org/dev/library/array.html#module-array
Note 1 in the table of type codes says that the 'u' type is deprecated and will go in Python 4.0.

Since the array.fromunicode() and array.tounicode() methods depend on type code 'u' shouldn't they also be marked as deprecated?

If people use the 'u' type code maybe it would be helpful to provide an example of how to store unicode chars in an array.array? (Presumably they'd use type code 'L' and use ord() and chr()?)

----------
assignee: docs at python
components: Documentation
messages: 267738
nosy: docs at python, mark
priority: normal
severity: normal
status: open
title: Possible missing deprecation warnings?
type: enhancement
versions: Python 3.6

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

From report at bugs.python.org  Tue Jun  7 16:25:26 2016
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 07 Jun 2016 20:25:26 +0000
Subject: [docs] [issue27187] Relax __all__ location requirement in PEP 8
In-Reply-To: <1464901602.05.0.802918160149.issue27187@psf.upfronthosting.co.za>
Message-ID: <20160607202522.39513.2656.F918B9D0@psf.io>


Roundup Robot added the comment:

New changeset cf8e888b9555 by Barry Warsaw in branch 'default':
Relax __all__ location.
https://hg.python.org/peps/rev/cf8e888b9555

----------
nosy: +python-dev
resolution:  -> fixed
stage:  -> resolved
status: open -> closed

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

From report at bugs.python.org  Tue Jun  7 16:26:13 2016
From: report at bugs.python.org (Barry A. Warsaw)
Date: Tue, 07 Jun 2016 20:26:13 +0000
Subject: [docs] [issue27187] Relax __all__ location requirement in PEP 8
In-Reply-To: <1464901602.05.0.802918160149.issue27187@psf.upfronthosting.co.za>
Message-ID: <1465331173.88.0.88629123354.issue27187@psf.upfronthosting.co.za>


Barry A. Warsaw added the comment:

Thanks for the patch!

----------

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

From report at bugs.python.org  Tue Jun  7 20:50:43 2016
From: report at bugs.python.org (John Mark Vandenberg)
Date: Wed, 08 Jun 2016 00:50:43 +0000
Subject: [docs] [issue27187] Relax __all__ location requirement in PEP 8
In-Reply-To: <1464901602.05.0.802918160149.issue27187@psf.upfronthosting.co.za>
Message-ID: <1465347042.85.0.162054842851.issue27187@psf.upfronthosting.co.za>


John Mark Vandenberg added the comment:

The revised text says __dunder__ should appear before any imports, however __future__ imports must appear first for obvious reasons.  Does this need to be mentioned in the pep?

----------

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

From report at bugs.python.org  Tue Jun  7 21:05:57 2016
From: report at bugs.python.org (Berker Peksag)
Date: Wed, 08 Jun 2016 01:05:57 +0000
Subject: [docs] [issue27180] Doc/pathlib: Please describe the behaviour of
 Path().rename() is depends on the platform (same as os.rename())
In-Reply-To: <1464866299.22.0.549959469595.issue27180@psf.upfronthosting.co.za>
Message-ID: <1465347957.62.0.799453495959.issue27180@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Could you please send your patch in unified diff format? See https://docs.python.org/devguide/patch.html for details.

----------
nosy: +berker.peksag
stage: needs patch -> patch review

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

From report at bugs.python.org  Tue Jun  7 21:19:30 2016
From: report at bugs.python.org (Evelyn Mitchell)
Date: Wed, 08 Jun 2016 01:19:30 +0000
Subject: [docs] [issue27180] Doc/pathlib: Please describe the behaviour of
 Path().rename() is depends on the platform (same as os.rename())
In-Reply-To: <1464866299.22.0.549959469595.issue27180@psf.upfronthosting.co.za>
Message-ID: <1465348770.31.0.980964994105.issue27180@psf.upfronthosting.co.za>


Changes by Evelyn Mitchell <efmphone at gmail.com>:


Added file: http://bugs.python.org/file43289/patch27180

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

From report at bugs.python.org  Tue Jun  7 23:08:35 2016
From: report at bugs.python.org (Evelyn Mitchell)
Date: Wed, 08 Jun 2016 03:08:35 +0000
Subject: [docs] [issue8491] Need readline command and keybinding information
In-Reply-To: <1271879913.89.0.268262009322.issue8491@psf.upfronthosting.co.za>
Message-ID: <1465355315.09.0.743293965885.issue8491@psf.upfronthosting.co.za>


Changes by Evelyn Mitchell <efmphone at gmail.com>:


Added file: http://bugs.python.org/file43293/patch8491

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

From report at bugs.python.org  Tue Jun  7 23:44:08 2016
From: report at bugs.python.org (Ian Lee)
Date: Wed, 08 Jun 2016 03:44:08 +0000
Subject: [docs] [issue27187] Relax __all__ location requirement in PEP 8
In-Reply-To: <1464901602.05.0.802918160149.issue27187@psf.upfronthosting.co.za>
Message-ID: <1465357448.47.0.880553033371.issue27187@psf.upfronthosting.co.za>


Ian Lee added the comment:

Good catch.

I'm uploading a new patch that addresses ``from __future__`` imports issue explicitly.

----------

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

From report at bugs.python.org  Tue Jun  7 23:44:54 2016
From: report at bugs.python.org (Ian Lee)
Date: Wed, 08 Jun 2016 03:44:54 +0000
Subject: [docs] [issue27187] Relax __all__ location requirement in PEP 8
In-Reply-To: <1464901602.05.0.802918160149.issue27187@psf.upfronthosting.co.za>
Message-ID: <1465357494.83.0.491969667697.issue27187@psf.upfronthosting.co.za>


Changes by Ian Lee <ianlee1521 at gmail.com>:


Added file: http://bugs.python.org/file43296/issue-27187-patch3.txt

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

From report at bugs.python.org  Tue Jun  7 23:51:34 2016
From: report at bugs.python.org (Tommy Beadle)
Date: Wed, 08 Jun 2016 03:51:34 +0000
Subject: [docs] [issue15476] Index "code object" and link to code object
 definition
In-Reply-To: <1343459471.56.0.370073010984.issue15476@psf.upfronthosting.co.za>
Message-ID: <1465357894.76.0.554115605195.issue15476@psf.upfronthosting.co.za>


Tommy Beadle added the comment:

Martin, thanks for the suggestion that worked.  I believe this patch should have all of the issues addressed.

----------
Added file: http://bugs.python.org/file43298/0001-Issue-15476-Make-code-object-its-own-entry-in-the-do.patch

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

From vadmium+py at gmail.com  Wed Jun  8 00:22:58 2016
From: vadmium+py at gmail.com (vadmium+py at gmail.com)
Date: Wed, 08 Jun 2016 04:22:58 -0000
Subject: [docs] Need readline command and keybinding information (issue 8491)
Message-ID: <20160608042258.7414.49546@psf.upfronthosting.co.za>


https://bugs.python.org/review/8491/diff/17570/Doc/library/readline.rst
File Doc/library/readline.rst (right):

https://bugs.python.org/review/8491/diff/17570/Doc/library/readline.rst#newcode31
Doc/library/readline.rst:31: .inputrc in your home directory; see 'GNU
readline
I think ?.inputrc? needs quotes or something around it, considering it
starts with a full stop

https://bugs.python.org/review/8491/diff/17570/Doc/library/readline.rst#newcode32
Doc/library/readline.rst:32:
<http://www.gnu.org/software/bash/manual/html_node/Readline-Init-File.html>`
I wonder if it would be better to link to just the Readline
documentation
(https://cnswww.cns.cwru.edu/php/chet/readline/rluserman.html#SEC9),
instead of the Bash documentation. Gnu Readline and Bash seem to be very
closely linked, but refering to the Bash documentation could be
confusing.

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

From report at bugs.python.org  Wed Jun  8 00:27:32 2016
From: report at bugs.python.org (Martin Panter)
Date: Wed, 08 Jun 2016 04:27:32 +0000
Subject: [docs] [issue8491] Need readline command and keybinding information
In-Reply-To: <1271879913.89.0.268262009322.issue8491@psf.upfronthosting.co.za>
Message-ID: <1465360052.41.0.793960147782.issue8491@psf.upfronthosting.co.za>


Martin Panter added the comment:

Thanks for the patch. I left a couple review comments.

Also, this new paragraph should be outside the ?Note? box, which is specifically about libedit aka Editline, not Gnu Readline.

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

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

From report at bugs.python.org  Wed Jun  8 00:38:01 2016
From: report at bugs.python.org (Martin Panter)
Date: Wed, 08 Jun 2016 04:38:01 +0000
Subject: [docs] [issue27242] Make the docs for NotImplemented &
 NotImplementedError unambigous
In-Reply-To: <1465239567.69.0.773832868585.issue27242@psf.upfronthosting.co.za>
Message-ID: <1465360681.74.0.347864254199.issue27242@psf.upfronthosting.co.za>


Martin Panter added the comment:

Emanuel, have you seen <https://docs.python.org/devguide/documenting.html#building-the-documentation>? From my experience, install Sphinx, and then ?make -C Doc/ html?.

About the patch, I think the ?.. note? boxes should be intended under the NotImplementedError heading. The current box looks wrong sandwiched between NotImplemnted and Ellipsis.

(Personally I think ?Note? boxes are an annoying distraction anyway, and should normally be written into the surrounding text. In this case ?Note that? inside a ?Note? box seems doubly redundant. But other people seem to like them, so I try to resist complaining :)

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

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

From report at bugs.python.org  Wed Jun  8 01:30:13 2016
From: report at bugs.python.org (Martin Panter)
Date: Wed, 08 Jun 2016 05:30:13 +0000
Subject: [docs] [issue15476] Index "code object" and link to code object
 definition
In-Reply-To: <1343459471.56.0.370073010984.issue15476@psf.upfronthosting.co.za>
Message-ID: <1465363813.26.0.434894265524.issue15476@psf.upfronthosting.co.za>


Martin Panter added the comment:

Yes it seems you even fixed the problem with the definition list, which I thought was not fixable :)

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

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

From report at bugs.python.org  Wed Jun  8 01:37:18 2016
From: report at bugs.python.org (Jelle Zijlstra)
Date: Wed, 08 Jun 2016 05:37:18 +0000
Subject: [docs] [issue24136] document PEP 448: unpacking generalization
In-Reply-To: <1430918327.69.0.579699866453.issue24136@psf.upfronthosting.co.za>
Message-ID: <1465364238.47.0.408293165973.issue24136@psf.upfronthosting.co.za>


Jelle Zijlstra added the comment:

Here's what I found reviewing what needs to be done here:

- Neil's What's New patch apparently made it into the 3.5 release notes.
- moigagoo's two patches haven't been committed. The text of both looks ok to me, but the patches don't apply cleanly.

Other areas that still need updates:
- https://docs.python.org/3/reference/expressions.html#list-displays and the sections for set, dict, and tuple displays need to mention PEP 448-style syntax.

----------
nosy: +Jelle Zijlstra

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

From report at bugs.python.org  Wed Jun  8 01:41:28 2016
From: report at bugs.python.org (Martin Panter)
Date: Wed, 08 Jun 2016 05:41:28 +0000
Subject: [docs] [issue20699] Document that binary IO classes work with
 bytes-likes objects
In-Reply-To: <1392889792.36.0.922412998797.issue20699@psf.upfronthosting.co.za>
Message-ID: <1465364487.89.0.682178448265.issue20699@psf.upfronthosting.co.za>


Martin Panter added the comment:

New patch that I plan to commit:

* Use bytes instead of str
* bytes, bytearray or memoryview for readinto() methods
* bytes or memoryview for write() methods
* Added single ?Changed in version 2.7? notice under the IOBase class (rather than every version of readinto and write)
* Since we only require 1-D byte array memoryviews, I resurrected the len(b) text
* Removed outdated XXX comment about supporting buffer API, since bytearray and memoryview of bytes is now all that is required

----------
stage: patch review -> commit review
Added file: http://bugs.python.org/file43301/bytes-like-param.py2.v9.patch

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

From report at bugs.python.org  Wed Jun  8 01:51:14 2016
From: report at bugs.python.org (Jelle Zijlstra)
Date: Wed, 08 Jun 2016 05:51:14 +0000
Subject: [docs] [issue24136] document PEP 448: unpacking generalization
In-Reply-To: <1430918327.69.0.579699866453.issue24136@psf.upfronthosting.co.za>
Message-ID: <1465365074.4.0.430718149426.issue24136@psf.upfronthosting.co.za>


Jelle Zijlstra added the comment:

This updates reference_calls_syntax_update.diff. The previous patch's grammard had a mistake; it was missing commas between arguments.

I believe all other patches in this diff are now obsolete.

----------
Added file: http://bugs.python.org/file43302/issue24136-expressions.patch

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

From report at bugs.python.org  Wed Jun  8 05:43:13 2016
From: report at bugs.python.org (Martin Panter)
Date: Wed, 08 Jun 2016 09:43:13 +0000
Subject: [docs] [issue24136] document PEP 448: unpacking generalization
In-Reply-To: <1430918327.69.0.579699866453.issue24136@psf.upfronthosting.co.za>
Message-ID: <1465378993.72.0.113329045794.issue24136@psf.upfronthosting.co.za>


Martin Panter added the comment:

Thanks for helping with this Jelle.

The documentation of unpacking sequences vs iterables was adjusted in 3.6 as part of Issue 23275. I guess part of revision 8a0754fed986 should be extracted to 3.5 as well.

Looking at the function call syntax, positional and starred should be optional. I don?t think your syntax would allow print(file=stderr).

----------

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

From vadmium+py at gmail.com  Wed Jun  8 05:40:56 2016
From: vadmium+py at gmail.com (vadmium+py at gmail.com)
Date: Wed, 08 Jun 2016 09:40:56 -0000
Subject: [docs] document PEP 448 (issue 24136)
Message-ID: <20160608094056.7446.34452@psf.upfronthosting.co.za>


https://bugs.python.org/review/24136/diff/17575/Doc/reference/expressions.rst
File Doc/reference/expressions.rst (right):

https://bugs.python.org/review/24136/diff/17575/Doc/reference/expressions.rst#newcode653
Doc/reference/expressions.rst:653: :   ("," `keyword_argument` |
`starred_argument`)*
There should probably be a comma before starred_(keyword_)argument. What
you did for positional_arguments below should work, although I think it
might read better expanded:

("," `keyword_argument` | "," `starred_argument`)*

https://bugs.python.org/review/24136/diff/17575/Doc/reference/expressions.rst#newcode655
Doc/reference/expressions.rst:655: positional_arguments:
(`positional_argument` | `starred_argument`)
positional_argument (singular) seems to be missing

https://bugs.python.org/review/24136/diff/17575/Doc/reference/expressions.rst#newcode664
Doc/reference/expressions.rst:664: Keyword arguments must follow
positional arguments, and ``**`` unpackings must follow ``*``
unpackings::
This rule might go better further down, where it discusses mixing
keyword arguments and starred arguments. Also, it would be good to
word-wrap to two lines.

https://bugs.python.org/review/24136/diff/17575/Doc/reference/expressions.rst#newcode672
Doc/reference/expressions.rst:672: See :pep:`448` for more details about
unpacking generalizations.
It would be good to include any missing details in the main
documentation (but a link is still good as a reference, and is better
than nothing :)

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

From report at bugs.python.org  Wed Jun  8 05:50:28 2016
From: report at bugs.python.org (Antoine Pitrou)
Date: Wed, 08 Jun 2016 09:50:28 +0000
Subject: [docs] [issue24136] document PEP 448: unpacking generalization
In-Reply-To: <1430918327.69.0.579699866453.issue24136@psf.upfronthosting.co.za>
Message-ID: <1465379428.4.0.436868661123.issue24136@psf.upfronthosting.co.za>


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


----------
nosy:  -pitrou

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

From report at bugs.python.org  Wed Jun  8 06:17:14 2016
From: report at bugs.python.org (Martin Panter)
Date: Wed, 08 Jun 2016 10:17:14 +0000
Subject: [docs] [issue22942] Language Reference - optional comma
In-Reply-To: <1416945158.04.0.329806790258.issue22942@psf.upfronthosting.co.za>
Message-ID: <1465381034.74.0.707272247727.issue22942@psf.upfronthosting.co.za>


Martin Panter added the comment:

Bug 1 is still present in 3.5. In 3.6 it is no longer relevant because the documentation was changed for Issue 9232 (allowing trailing commas in function definitions).

Bug 2 is present in 2.7, but is not relevant to 3.5+. Trailing commas are now allowed in function calls, probably thanks to PEP 448, unpacking generalizations.

Bug 3 has been fixed in Issue 27042.

----------
stage:  -> needs patch
versions: +Python 2.7, Python 3.5 -Python 3.4

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

From report at bugs.python.org  Wed Jun  8 06:36:51 2016
From: report at bugs.python.org (Berker Peksag)
Date: Wed, 08 Jun 2016 10:36:51 +0000
Subject: [docs] [issue20842] pkgutil docs should reference glossary terms
 not PEP 302
In-Reply-To: <1393846400.67.0.723549613222.issue20842@psf.upfronthosting.co.za>
Message-ID: <1465382211.42.0.262879821101.issue20842@psf.upfronthosting.co.za>


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


----------
keywords: +easy
versions: +Python 3.6 -Python 3.4

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

From report at bugs.python.org  Wed Jun  8 06:44:11 2016
From: report at bugs.python.org (Berker Peksag)
Date: Wed, 08 Jun 2016 10:44:11 +0000
Subject: [docs] [issue12962] TitledHelpFormatter and IndentedHelpFormatter
 are not documented
In-Reply-To: <1315812430.81.0.82881222836.issue12962@psf.upfronthosting.co.za>
Message-ID: <1465382651.59.0.828726033713.issue12962@psf.upfronthosting.co.za>


Berker Peksag added the comment:

optparse has been deprecated for years and I don't see any reason to document them now. Closing as rejected.

----------
assignee:  -> docs at python
components: +Documentation -Library (Lib)
nosy: +berker.peksag, docs at python
resolution:  -> rejected
stage:  -> resolved
status: open -> closed
type:  -> enhancement

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

From report at bugs.python.org  Wed Jun  8 07:01:06 2016
From: report at bugs.python.org (Berker Peksag)
Date: Wed, 08 Jun 2016 11:01:06 +0000
Subject: [docs] [issue26437] asyncio create_server() not always accepts the
 'port' parameter as str
In-Reply-To: <1456408319.2.0.804697554696.issue26437@psf.upfronthosting.co.za>
Message-ID: <1465383666.7.0.470378890066.issue26437@psf.upfronthosting.co.za>


Berker Peksag added the comment:

After changeset 3ec208c01418 this is no longer an issue:

>>> from asyncio import *
>>> loop = get_event_loop()
>>> coro = loop.create_server(Protocol(), '', '12345')
>>> loop.run_until_complete(coro)
<Server sockets=[<socket.socket fd=7, family=AddressFamily.AF_INET, type=2049, proto=6, laddr=('0.0.0.0', 
>>> coro = loop.create_server(Protocol(), '127.0.0.1', '12345')
>>> loop.run_until_complete(coro)
Traceback (most recent call last):
  File "/home/berker/projects/cpython/default/Lib/asyncio/base_events.py", line 981, in create_server
    sock.bind(sa)
OSError: [Errno 98] Address already in use

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "/home/berker/projects/cpython/default/Lib/asyncio/base_events.py", line 404, in run_until_complete
    return future.result()
  File "/home/berker/projects/cpython/default/Lib/asyncio/futures.py", line 274, in result
    raise self._exception
  File "/home/berker/projects/cpython/default/Lib/asyncio/tasks.py", line 240, in _step
    result = coro.send(None)
  File "/home/berker/projects/cpython/default/Lib/asyncio/base_events.py", line 985, in create_server
    % (sa, err.strerror.lower()))
OSError: [Errno 98] error while attempting to bind on address ('127.0.0.1', 12345): address already in use

The traceback looks a bit noisy though. Perhaps it needs ``... from None`` or something like that.

----------
nosy: +berker.peksag
resolution:  -> out of date
stage:  -> resolved
status: open -> closed

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

From report at bugs.python.org  Wed Jun  8 07:58:29 2016
From: report at bugs.python.org (Berker Peksag)
Date: Wed, 08 Jun 2016 11:58:29 +0000
Subject: [docs] [issue21593] Clarify re.search documentation first match
In-Reply-To: <1401287966.38.0.860641123785.issue21593@psf.upfronthosting.co.za>
Message-ID: <1465387109.55.0.0682936361936.issue21593@psf.upfronthosting.co.za>


Berker Peksag added the comment:

> This should also be applied to regex.search's docstring.

Done.

----------
nosy: +berker.peksag
resolution:  -> fixed
stage: commit review -> resolved
status: open -> closed

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

From report at bugs.python.org  Wed Jun  8 08:06:39 2016
From: report at bugs.python.org (Berker Peksag)
Date: Wed, 08 Jun 2016 12:06:39 +0000
Subject: [docs] [issue26985] Information about CodeType in inspect
 documentation is outdated
In-Reply-To: <1462803102.24.0.542356144335.issue26985@psf.upfronthosting.co.za>
Message-ID: <1465387599.33.0.983872292755.issue26985@psf.upfronthosting.co.za>


Berker Peksag added the comment:

I prefer to not duplicate the list in Lib/inspect.py. We did similar docstring cleanups in several modules (venv for example) recently.

----------
nosy: +berker.peksag
stage:  -> patch review
type:  -> behavior
versions: +Python 3.5

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

From report at bugs.python.org  Wed Jun  8 07:57:40 2016
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 08 Jun 2016 11:57:40 +0000
Subject: [docs] [issue21593] Clarify re.search documentation first match
In-Reply-To: <1401287966.38.0.860641123785.issue21593@psf.upfronthosting.co.za>
Message-ID: <20160608115731.19119.71437.7F4D61CB@psf.io>


Roundup Robot added the comment:

New changeset 48bb48e7499d by Berker Peksag in branch '3.5':
Issue #21593: Clarify that re.search() returns the first match
https://hg.python.org/cpython/rev/48bb48e7499d

New changeset 243b95782059 by Berker Peksag in branch 'default':
Issue #21593: Merge from 3.5
https://hg.python.org/cpython/rev/243b95782059

----------

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

From report at bugs.python.org  Wed Jun  8 08:59:56 2016
From: report at bugs.python.org (Emanuel Barry)
Date: Wed, 08 Jun 2016 12:59:56 +0000
Subject: [docs] [issue27242] Make the docs for NotImplemented &
 NotImplementedError unambigous
In-Reply-To: <1465239567.69.0.773832868585.issue27242@psf.upfronthosting.co.za>
Message-ID: <1465390796.76.0.181667824027.issue27242@psf.upfronthosting.co.za>


Emanuel Barry added the comment:

Martin: yes, I plan to install Sphinx soon enough, so that I can build the docs.

As for the notes part, I indented it exactly like it was indented for other existing notes boxes in the same file. I'll change that if needed though.

----------

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

From report at bugs.python.org  Wed Jun  8 09:01:43 2016
From: report at bugs.python.org (Tommy Beadle)
Date: Wed, 08 Jun 2016 13:01:43 +0000
Subject: [docs] [issue24617] os.makedirs()'s [mode] not correct
In-Reply-To: <1436721223.66.0.229120395272.issue24617@psf.upfronthosting.co.za>
Message-ID: <1465390903.71.0.969578246324.issue24617@psf.upfronthosting.co.za>


Changes by Tommy Beadle <tbeadle at gmail.com>:


Added file: http://bugs.python.org/file43305/0001-Issue-24617-Add-comment-for-os.makedirs-about-certai.patch

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

From report at bugs.python.org  Wed Jun  8 09:24:05 2016
From: report at bugs.python.org (Evelyn Mitchell)
Date: Wed, 08 Jun 2016 13:24:05 +0000
Subject: [docs] [issue8491] Need readline command and keybinding information
In-Reply-To: <1271879913.89.0.268262009322.issue8491@psf.upfronthosting.co.za>
Message-ID: <1465392245.18.0.295894786084.issue8491@psf.upfronthosting.co.za>


Evelyn Mitchell added the comment:

Revised patch following Martin Panter's review comments.

----------
nosy: +Evelyn Mitchell
Added file: http://bugs.python.org/file43306/patch8491a

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

From report at bugs.python.org  Wed Jun  8 09:41:52 2016
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 08 Jun 2016 13:41:52 +0000
Subject: [docs] [issue24617] os.makedirs()'s [mode] not correct
In-Reply-To: <1436721223.66.0.229120395272.issue24617@psf.upfronthosting.co.za>
Message-ID: <1465393312.34.0.134127642637.issue24617@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

See also issue19930.

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

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

From report at bugs.python.org  Wed Jun  8 09:44:51 2016
From: report at bugs.python.org (Martin Panter)
Date: Wed, 08 Jun 2016 13:44:51 +0000
Subject: [docs] [issue27242] Make the docs for NotImplemented &
 NotImplementedError unambigous
In-Reply-To: <1465239567.69.0.773832868585.issue27242@psf.upfronthosting.co.za>
Message-ID: <1465393491.79.0.643318798285.issue27242@psf.upfronthosting.co.za>


Martin Panter added the comment:

I think the box about NotImplementedError needs indenting too. See the box for <https://docs.python.org/3.5/library/functions.html#locals> for a better example.

----------

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

From report at bugs.python.org  Wed Jun  8 09:49:55 2016
From: report at bugs.python.org (Tommy Beadle)
Date: Wed, 08 Jun 2016 13:49:55 +0000
Subject: [docs] [issue24617] os.makedirs()'s [mode] not correct
In-Reply-To: <1436721223.66.0.229120395272.issue24617@psf.upfronthosting.co.za>
Message-ID: <1465393795.66.0.309506684015.issue24617@psf.upfronthosting.co.za>


Tommy Beadle added the comment:

I think that the documentation should be updated to reflect issue19930's change when that is actually committed, not as a part of this change.

----------

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

From report at bugs.python.org  Wed Jun  8 10:34:38 2016
From: report at bugs.python.org (Barry A. Warsaw)
Date: Wed, 08 Jun 2016 14:34:38 +0000
Subject: [docs] [issue27187] Relax __all__ location requirement in PEP 8
In-Reply-To: <1464901602.05.0.802918160149.issue27187@psf.upfronthosting.co.za>
Message-ID: <1465396478.67.0.627347107686.issue27187@psf.upfronthosting.co.za>


Barry A. Warsaw added the comment:

Thanks Ian.  I'm going to apply that, but rephrase it a bit.

----------

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

From report at bugs.python.org  Wed Jun  8 11:57:08 2016
From: report at bugs.python.org (Akira Li)
Date: Wed, 08 Jun 2016 15:57:08 +0000
Subject: [docs] [issue27050] Demote run() below the high level APIs in
 subprocess docs
In-Reply-To: <1463548305.72.0.232219818049.issue27050@psf.upfronthosting.co.za>
Message-ID: <1465401428.22.0.471604217529.issue27050@psf.upfronthosting.co.za>


Akira Li added the comment:

> setting "universal_newlines=True" switches to UTF-8 encoded text pipes

It uses locale.getpreferredencoding(False) encoding -- something like cp1252,cp1251,etc on Windows, and UTF-8 on *nix with proper locale settings.

It is ASCII (C/POSIX locale default) if the locale is not set in cron, ssh, init.d scripts, etc.

If you need a different character encoding, you could use (instead of universal_newlines=True):

  pipe = io.TextIOWrapper(process.stdout, encoding=character_encoding)

A better spelling for universal_newlines=True would be text_mode=True.

A summary table (like in itertools' module) would be nice.

check_output() name is unfortunate but it does the right thing and it is not hard to use for a beginner --
once somebody discovers it e.g., via "Running shell command from Python and capturing the output" Stack Overflow question
http://stackoverflow.com/questions/4760215/running-shell-command-from-python-and-capturing-the-output

Compare:

  output = check_output([sys.executable, '-c', 'print("abc")'])

and

  output = run([sys.executable, '-c', 'print("abc)'], stdout=PIPE).stdout

The latter command doesn't raise exception if the child process fails.
A beginner has to know about check=True to do the right thing:

  output = run([sys.executable, '-c', 'print("abc")'], stdout=PIPE, check=True).stdout

It is easier to refer to check_output() if someone asks "How do I get command's output in Python?"


I wish call() did what check_call() does and the current call() behavior would be achieved by
the opposite parameter e.g. no_raise_on_status=False being the default:

   rc = call(command, no_raise_on_status=True)

If we can't change the interface then check_call() is the answer to "Calling an external command in Python" question
http://stackoverflow.com/questions/89228/calling-an-external-command-in-python

  - check_call(command) -- run command, raise if it fails
  - output = check_output(command) -- get command's output, raise if it fails.
      To pass *data* to the command via its standard input, pass input=data.
      To get/pass text (Unicode) instead of bytes, pass universal_newlines=True
  - check_call("a -- *.jpg | b 2>&1 >output | c", shell=True) -- run a shell command as is
      It is a pity that a list argument such as ["ls", "-l"] is allowed with shell=True

These cover the most common operations with a subprocess.

Henceforth, run() is more convenient if we don't need to interact with the child process while it is running.

For example, if  we introduce the word PIPE (a magic object in the kernel that connects processes) then
to capture both standard and error streams of the command:

  cp = run(command, stdout=PIPE, stderr=PIPE)
  output, errors = cp.stdout, cp.stderr

run() allows to get the output and to get the exit status easily: cp.returncode.
Explicit cp.stdout_text, cp.stdout_bytes regardless the text mode would be nice.

To interact with a child process while it is running, Popen() have to be used directly.
There could be buffering and other issues (tty vs. pipe), see "Q: Why not just use a pipe (popen())?"
http://pexpect.readthedocs.io/en/latest/FAQ.html#whynotpipe

Working with both stdout/stderr or a non-blocking read require threads or asyncio, fcntl, etc.

A couple of words should be said about killing a command started with shell=True.
(to kill a process tree: set start_new_session=True parameter and call os.killpg()).
timeout option doesn't work in this case (it uses Popen.kill()).
check_output() unlike check_call() may wait for grandchildren if they inherit the pipe.
Mention Job object on Windows e.g.,
http://stackoverflow.com/questions/23434842/python-how-to-kill-child-processes-when-parent-dies

----------
nosy: +akira

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

From report at bugs.python.org  Wed Jun  8 13:37:29 2016
From: report at bugs.python.org (Raymond Hettinger)
Date: Wed, 08 Jun 2016 17:37:29 +0000
Subject: [docs] [issue27242] Make the docs for NotImplemented &
 NotImplementedError unambiguous
In-Reply-To: <1465239567.69.0.773832868585.issue27242@psf.upfronthosting.co.za>
Message-ID: <1465407449.38.0.714550481761.issue27242@psf.upfronthosting.co.za>


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


----------
title: Make the docs for NotImplemented & NotImplementedError unambigous -> Make the docs for NotImplemented & NotImplementedError unambiguous

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

From report at bugs.python.org  Thu Jun  9 05:14:21 2016
From: report at bugs.python.org (Arthur Carcano)
Date: Thu, 09 Jun 2016 09:14:21 +0000
Subject: [docs] [issue27280] Paste fail in ipaddress documentation
Message-ID: <1465463661.18.0.737340731231.issue27280@psf.upfronthosting.co.za>


New submission from Arthur Carcano:

There is a type in the `IPv6Network' constructor doc, fixed in attached patch.

----------
assignee: docs at python
components: Documentation
files: patch_doc_ipaddress.patch
keywords: patch
messages: 267999
nosy: NougatRillettes, docs at python
priority: normal
severity: normal
status: open
title: Paste fail in ipaddress documentation
type: enhancement
versions: Python 3.5
Added file: http://bugs.python.org/file43317/patch_doc_ipaddress.patch

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

From report at bugs.python.org  Thu Jun  9 06:00:48 2016
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 09 Jun 2016 10:00:48 +0000
Subject: [docs] [issue27280] Paste fail in ipaddress documentation
In-Reply-To: <1465463661.18.0.737340731231.issue27280@psf.upfronthosting.co.za>
Message-ID: <1465466448.45.0.786223959265.issue27280@psf.upfronthosting.co.za>


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


----------
nosy: +pmoody

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

From er.harpal at live.com  Wed Jun  8 22:00:20 2016
From: er.harpal at live.com (Harpal Singh)
Date: Thu, 9 Jun 2016 02:00:20 +0000
Subject: [docs] Bug found in python 3.5.1(Mac) in case of bit wise operator
Message-ID: <AM3PR06MB001543D76577C52F1BFAB9E9C5F0@AM3PR06MB001.eurprd06.prod.outlook.com>

Using latest version of python 3.5.1 (Mac)

x = 8

y= 5

result = x^y

print(result)

When I enter line 3 that is "result = x^y" it closes my window.


Singh Harpal

Mobile: +47-91688218

Email: er.harpal at live.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160609/8879a82c/attachment.html>

From report at bugs.python.org  Thu Jun  9 11:19:27 2016
From: report at bugs.python.org (Xiang Zhang)
Date: Thu, 09 Jun 2016 15:19:27 +0000
Subject: [docs] [issue26985] Information about CodeType in inspect
 documentation is outdated
In-Reply-To: <1462803102.24.0.542356144335.issue26985@psf.upfronthosting.co.za>
Message-ID: <1465485567.37.0.597527872935.issue26985@psf.upfronthosting.co.za>


Xiang Zhang added the comment:

So maybe remove the docstring entirely?

----------

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

From report at bugs.python.org  Thu Jun  9 11:41:05 2016
From: report at bugs.python.org (Berker Peksag)
Date: Thu, 09 Jun 2016 15:41:05 +0000
Subject: [docs] [issue26985] Information about CodeType in inspect
 documentation is outdated
In-Reply-To: <1462803102.24.0.542356144335.issue26985@psf.upfronthosting.co.za>
Message-ID: <1465486865.26.0.822840030251.issue26985@psf.upfronthosting.co.za>


Berker Peksag added the comment:

"Return true if the object is a code object." should stay. We can add a short sentence to refer people to the inspect documentation for the list of co_* attributes.

----------

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

From report at bugs.python.org  Thu Jun  9 16:25:06 2016
From: report at bugs.python.org (Alexander Belopolsky)
Date: Thu, 09 Jun 2016 20:25:06 +0000
Subject: [docs] [issue15657] Error in Python 3 docs for PyMethodDef
In-Reply-To: <1344970966.7.0.115664419243.issue15657@psf.upfronthosting.co.za>
Message-ID: <1465503906.85.0.285338438678.issue15657@psf.upfronthosting.co.za>


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


----------
nosy: +belopolsky

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

From report at bugs.python.org  Thu Jun  9 19:53:52 2016
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 09 Jun 2016 23:53:52 +0000
Subject: [docs] [issue15476] Index "code object" and link to code object
 definition
In-Reply-To: <1343459471.56.0.370073010984.issue15476@psf.upfronthosting.co.za>
Message-ID: <20160609235347.81005.417.5784C676@psf.io>


Roundup Robot added the comment:

New changeset 2e9aace7e10a by Tommy Beadle in branch '3.5':
[Issue 15476] Make "code object" its own entry in the index
https://hg.python.org/cpython/rev/2e9aace7e10a

New changeset 8455bbc6b4f2 by Martin Panter in branch 'default':
Issue #15476: Merge index entries from 3.5
https://hg.python.org/cpython/rev/8455bbc6b4f2

New changeset f89e96235a42 by Tommy Beadle in branch '2.7':
[Issue 15476] Make "code object" its own entry in the index
https://hg.python.org/cpython/rev/f89e96235a42

----------
nosy: +python-dev

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

From report at bugs.python.org  Thu Jun  9 20:45:07 2016
From: report at bugs.python.org (Martin Panter)
Date: Fri, 10 Jun 2016 00:45:07 +0000
Subject: [docs] [issue15476] Index "code object" and link to code object
 definition
In-Reply-To: <1343459471.56.0.370073010984.issue15476@psf.upfronthosting.co.za>
Message-ID: <1465519507.4.0.268400750234.issue15476@psf.upfronthosting.co.za>


Martin Panter added the comment:

Thanks for the patch Tommy. I think we can close this now.

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

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

From report at bugs.python.org  Thu Jun  9 20:46:32 2016
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 10 Jun 2016 00:46:32 +0000
Subject: [docs] [issue8491] Need readline command and keybinding information
In-Reply-To: <1271879913.89.0.268262009322.issue8491@psf.upfronthosting.co.za>
Message-ID: <20160610004620.87602.33425.780D5E11@psf.io>


Roundup Robot added the comment:

New changeset e981a4273cf6 by Martin Panter in branch '2.7':
Issue #8491: Add link to Gnu Readline configuration documentation
https://hg.python.org/cpython/rev/e981a4273cf6

New changeset 5bbb021450d7 by Martin Panter in branch '3.5':
Issue #8491: Add link to Gnu Readline configuration documentation
https://hg.python.org/cpython/rev/5bbb021450d7

New changeset 5b904920c2d1 by Martin Panter in branch 'default':
Issue #8491: Merge readline doc from 3.5
https://hg.python.org/cpython/rev/5b904920c2d1

----------
nosy: +python-dev

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

From report at bugs.python.org  Thu Jun  9 21:36:49 2016
From: report at bugs.python.org (Martin Panter)
Date: Fri, 10 Jun 2016 01:36:49 +0000
Subject: [docs] [issue8491] Need readline command and keybinding information
In-Reply-To: <1271879913.89.0.268262009322.issue8491@psf.upfronthosting.co.za>
Message-ID: <1465522609.83.0.123064745829.issue8491@psf.upfronthosting.co.za>


Martin Panter added the comment:

For the record, I removed some trailing spaces and reworded the link in the comitted version.

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

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

From report at bugs.python.org  Fri Jun 10 00:36:01 2016
From: report at bugs.python.org (Martin Panter)
Date: Fri, 10 Jun 2016 04:36:01 +0000
Subject: [docs] [issue24617] os.makedirs()'s [mode] not correct
In-Reply-To: <1436721223.66.0.229120395272.issue24617@psf.upfronthosting.co.za>
Message-ID: <1465533361.46.0.927080800099.issue24617@psf.upfronthosting.co.za>


Martin Panter added the comment:

This version of the patch looks good to me

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

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

From report at bugs.python.org  Fri Jun 10 01:56:23 2016
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 10 Jun 2016 05:56:23 +0000
Subject: [docs] [issue15657] Error in Python 3 docs for PyMethodDef
In-Reply-To: <1344970966.7.0.115664419243.issue15657@psf.upfronthosting.co.za>
Message-ID: <1465538183.65.0.456560062535.issue15657@psf.upfronthosting.co.za>


Berker Peksag added the comment:

I'm going to delete

    (but note that :const:`METH_KEYWORDS` alone is equivalent to ``METH_VARARGS | METH_KEYWORDS``)

from Doc/c-api/structures.rst in 3.5.

Then change the value of METH_KEYWORDS from 0x0002 to 0x0003 in 3.6.

Thanks for the review Serhiy.

----------
versions: +Python 3.6 -Python 3.4

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

From report at bugs.python.org  Fri Jun 10 03:49:04 2016
From: report at bugs.python.org (Steve Piercy)
Date: Fri, 10 Jun 2016 07:49:04 +0000
Subject: [docs] [issue27285] Deprecate pyvenv in favor of python3 -m venv
Message-ID: <1465544944.16.0.549761687921.issue27285@psf.upfronthosting.co.za>


New submission from Steve Piercy:

Per https://bugs.python.org/issue25154 `pyvenv` is deprecated in favor of `python3 -m venv`. The docs for Python 3.5+ need to be updated accordingly.

----------
assignee: docs at python
components: Documentation
messages: 268104
nosy: docs at python, stevepiercy
priority: normal
severity: normal
status: open
title: Deprecate pyvenv in favor of python3 -m venv
type: enhancement
versions: Python 3.5, Python 3.6

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

From report at bugs.python.org  Fri Jun 10 03:52:46 2016
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 10 Jun 2016 07:52:46 +0000
Subject: [docs] [issue27285] Deprecate pyvenv in favor of python3 -m venv
In-Reply-To: <1465544944.16.0.549761687921.issue27285@psf.upfronthosting.co.za>
Message-ID: <1465545166.67.0.155602900136.issue27285@psf.upfronthosting.co.za>


Berker Peksag added the comment:

It's actually deprecated in Python 3.6: https://docs.python.org/dev/whatsnew/3.6.html#deprecated-features

----------
keywords: +easy
nosy: +berker.peksag
stage:  -> needs patch
versions:  -Python 3.5

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

From report at bugs.python.org  Fri Jun 10 04:12:51 2016
From: report at bugs.python.org (Steve Piercy)
Date: Fri, 10 Jun 2016 08:12:51 +0000
Subject: [docs] [issue27285] Deprecate pyvenv in favor of python3 -m venv
In-Reply-To: <1465544944.16.0.549761687921.issue27285@psf.upfronthosting.co.za>
Message-ID: <1465546371.8.0.0424193532584.issue27285@psf.upfronthosting.co.za>


Steve Piercy added the comment:

I saw the patch in 3.6, yet the discussion in issue #25154 called for deprecation in 3.5.1.  Was deprecation of `pyvenv` supposed to be implemented in 3.5.1?

I couldn't find any other relevant discussion, so apologies for jumping in uninformed.

----------

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

From report at bugs.python.org  Fri Jun 10 04:32:36 2016
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 10 Jun 2016 08:32:36 +0000
Subject: [docs] [issue27285] Deprecate pyvenv in favor of python3 -m venv
In-Reply-To: <1465544944.16.0.549761687921.issue27285@psf.upfronthosting.co.za>
Message-ID: <1465547556.0.0.589493972403.issue27285@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Jun 10 04:49:42 2016
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 10 Jun 2016 08:49:42 +0000
Subject: [docs] [issue20699] Document that binary IO classes work with
 bytes-likes objects
In-Reply-To: <1392889792.36.0.922412998797.issue20699@psf.upfronthosting.co.za>
Message-ID: <20160610084918.27788.67103.9035AC7A@psf.io>


Roundup Robot added the comment:

New changeset ec69518aeebc by Martin Panter in branch '2.7':
Issue #20699: Document that ?io? methods should accept memoryview
https://hg.python.org/cpython/rev/ec69518aeebc

----------

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

From report at bugs.python.org  Fri Jun 10 04:49:42 2016
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 10 Jun 2016 08:49:42 +0000
Subject: [docs] [issue24617] os.makedirs()'s [mode] not correct
In-Reply-To: <1436721223.66.0.229120395272.issue24617@psf.upfronthosting.co.za>
Message-ID: <20160610084918.27788.30022.411779D7@psf.io>


Roundup Robot added the comment:

New changeset 4fc7753efc89 by Tommy Beadle in branch '2.7':
Issue #24617: Add comment for os.mkdir about mode quirks
https://hg.python.org/cpython/rev/4fc7753efc89

New changeset e6093676e93b by Tommy Beadle in branch '3.5':
Issue #24617: Add comment for os.mkdir about mode quirks
https://hg.python.org/cpython/rev/e6093676e93b

New changeset bfd77c6fc04f by Martin Panter in branch 'default':
Issue #24617: Merge os.mkdir() doc from 3.5
https://hg.python.org/cpython/rev/bfd77c6fc04f

----------
nosy: +python-dev

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

From report at bugs.python.org  Fri Jun 10 05:14:21 2016
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 10 Jun 2016 09:14:21 +0000
Subject: [docs] [issue24617] os.makedirs()'s [mode] not correct
In-Reply-To: <1436721223.66.0.229120395272.issue24617@psf.upfronthosting.co.za>
Message-ID: <1465550061.17.0.399018630672.issue24617@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Please use "hg import --no-commit" in the future. Since Mercurial doesn't keep committer's information it's hard to see who actually committed the patch in case of a problem.

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

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

From report at bugs.python.org  Fri Jun 10 05:47:11 2016
From: report at bugs.python.org (Martin Panter)
Date: Fri, 10 Jun 2016 09:47:11 +0000
Subject: [docs] [issue24617] os.makedirs()'s [mode] not correct
In-Reply-To: <1436721223.66.0.229120395272.issue24617@psf.upfronthosting.co.za>
Message-ID: <1465552031.26.0.197104903362.issue24617@psf.upfronthosting.co.za>


Martin Panter added the comment:

Okay I will avoid this problem in the future. I often use the mq extension, but I can reset the user and date with that.

----------

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

From report at bugs.python.org  Fri Jun 10 05:47:33 2016
From: report at bugs.python.org (Martin Panter)
Date: Fri, 10 Jun 2016 09:47:33 +0000
Subject: [docs] [issue24617] os.makedirs()'s [mode] not correct
In-Reply-To: <1436721223.66.0.229120395272.issue24617@psf.upfronthosting.co.za>
Message-ID: <1465552053.6.0.129081564961.issue24617@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Jun 10 07:26:33 2016
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 10 Jun 2016 11:26:33 +0000
Subject: [docs] [issue27280] Paste fail in ipaddress documentation
In-Reply-To: <1465463661.18.0.737340731231.issue27280@psf.upfronthosting.co.za>
Message-ID: <20160610112629.114316.12078.BBB8C438@psf.io>


Roundup Robot added the comment:

New changeset fcd9f6ffbeaf by Berker Peksag in branch '3.5':
Issue #27280: Fix typo in IPv6Network documentation
https://hg.python.org/cpython/rev/fcd9f6ffbeaf

New changeset 18f1012e0c56 by Berker Peksag in branch 'default':
Issue #27280: Merge from 3.5
https://hg.python.org/cpython/rev/18f1012e0c56

----------
nosy: +python-dev

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

From report at bugs.python.org  Fri Jun 10 07:27:01 2016
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 10 Jun 2016 11:27:01 +0000
Subject: [docs] [issue27280] Paste fail in ipaddress documentation
In-Reply-To: <1465463661.18.0.737340731231.issue27280@psf.upfronthosting.co.za>
Message-ID: <1465558021.34.0.113016761428.issue27280@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Good catch, thanks Arthur!

----------
nosy: +berker.peksag
resolution:  -> fixed
stage:  -> resolved
status: open -> closed
type: enhancement -> behavior
versions: +Python 3.6

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

From report at bugs.python.org  Fri Jun 10 07:33:48 2016
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 10 Jun 2016 11:33:48 +0000
Subject: [docs] [issue22822] IPv6Network constructor docs incorrect about
 valid input
In-Reply-To: <1415468629.6.0.255055357939.issue22822@psf.upfronthosting.co.za>
Message-ID: <1465558428.76.0.392954593668.issue22822@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Thanks for the report Chris. The patch in issue 18802 should solve this. It would be great if you'd have time to take a look at it (should we add a note that says we only support CIDR for IPv6?)

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

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

From report at bugs.python.org  Fri Jun 10 07:56:13 2016
From: report at bugs.python.org (Sergey Chvalyuk)
Date: Fri, 10 Jun 2016 11:56:13 +0000
Subject: [docs] [issue26545] os.walk is limited by python's recursion limit
In-Reply-To: <1457744340.04.0.931517157669.issue26545@psf.upfronthosting.co.za>
Message-ID: <1465559772.94.0.46339066849.issue26545@psf.upfronthosting.co.za>


Sergey Chvalyuk added the comment:

There is another limitation with os.walk
it also cannot go very deep inside tree because of scandir can throw 
OSError(36, 'File name too long')

I have wrote tests for both cases:

https://gist.github.com/grubberr/3367f1d605e292103b576a17a46ef3c3

tested on linux only

on MacOS it throw 'File name too long' for 1-st test too
set sys.settrecursionlimit to lower values

----------
nosy: +Sergey Chvalyuk

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

From report at bugs.python.org  Fri Jun 10 12:21:21 2016
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 10 Jun 2016 16:21:21 +0000
Subject: [docs] [issue27285] Document the deprecation of pyvenv in favor of
 `python3 -m venv`
In-Reply-To: <1465544944.16.0.549761687921.issue27285@psf.upfronthosting.co.za>
Message-ID: <1465575681.42.0.761286682653.issue27285@psf.upfronthosting.co.za>


Brett Cannon added the comment:

Basically I changed my mind about adding the code deprecation in 3.5.1 since it wasn't fair to people to run into that in a bugfix release. Documenting the deprecation, though, can happen in Python 3.5.1 as well as updating the documentation of the venv module to only use `python3 -m venv` which I missed the first time through.

----------
assignee: docs at python -> brett.cannon
title: Deprecate pyvenv in favor of python3 -m venv -> Document the deprecation of pyvenv in favor of `python3 -m venv`

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

From report at bugs.python.org  Fri Jun 10 12:50:04 2016
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 10 Jun 2016 16:50:04 +0000
Subject: [docs] [issue26213] Document BUILD_*_UNPACK opcodes
In-Reply-To: <1453851645.07.0.698993321818.issue26213@psf.upfronthosting.co.za>
Message-ID: <1465577404.18.0.532184024137.issue26213@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

And BUILD_MAP_UNPACK_WITH_CALL.

All these opcodes were added in issue2292 for implementing PEP 448, but are not documented even in the PEP.

----------
nosy: +Joshua.Landau, neil.g, serhiy.storchaka, twouters

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

From report at bugs.python.org  Fri Jun 10 13:57:57 2016
From: report at bugs.python.org (Steve Piercy)
Date: Fri, 10 Jun 2016 17:57:57 +0000
Subject: [docs] [issue27285] Document the deprecation of pyvenv in favor of
 `python3 -m venv`
In-Reply-To: <1465544944.16.0.549761687921.issue27285@psf.upfronthosting.co.za>
Message-ID: <1465581477.02.0.594427561153.issue27285@psf.upfronthosting.co.za>


Steve Piercy added the comment:

I forgot to include the specific URL to update:
https://docs.python.org/3/installing/

There may be other places.

----------

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

From report at bugs.python.org  Fri Jun 10 14:02:48 2016
From: report at bugs.python.org (Steve Piercy)
Date: Fri, 10 Jun 2016 18:02:48 +0000
Subject: [docs] [issue27285] Document the deprecation of pyvenv in favor of
 `python3 -m venv`
In-Reply-To: <1465544944.16.0.549761687921.issue27285@psf.upfronthosting.co.za>
Message-ID: <1465581768.5.0.276324700329.issue27285@psf.upfronthosting.co.za>


Steve Piercy added the comment:

One more.
https://docs.python.org/3/library/venv.html

Should that be updated for 3.5.1 as well as 3.6?

----------

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

From report at bugs.python.org  Fri Jun 10 14:05:11 2016
From: report at bugs.python.org (Steve Piercy)
Date: Fri, 10 Jun 2016 18:05:11 +0000
Subject: [docs] [issue27285] Document the deprecation of pyvenv in favor of
 `python3 -m venv`
In-Reply-To: <1465544944.16.0.549761687921.issue27285@psf.upfronthosting.co.za>
Message-ID: <1465581911.12.0.389563928221.issue27285@psf.upfronthosting.co.za>


Steve Piercy added the comment:

See also:
https://github.com/pypa/python-packaging-user-guide/issues/242

----------

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

From report at bugs.python.org  Fri Jun 10 14:14:02 2016
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 10 Jun 2016 18:14:02 +0000
Subject: [docs] [issue27285] Document the deprecation of pyvenv in favor of
 `python3 -m venv`
In-Reply-To: <1465544944.16.0.549761687921.issue27285@psf.upfronthosting.co.za>
Message-ID: <1465582442.21.0.761830905873.issue27285@psf.upfronthosting.co.za>


Brett Cannon added the comment:

Documenting the deprecation in 3.5 is fine.

----------

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

From report at bugs.python.org  Fri Jun 10 16:21:53 2016
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 10 Jun 2016 20:21:53 +0000
Subject: [docs] [issue15468] Edit docs to hide hashlib.md5()
In-Reply-To: <1343404007.83.0.817302008925.issue15468@psf.upfronthosting.co.za>
Message-ID: <1465590113.46.0.996475550871.issue15468@psf.upfronthosting.co.za>


Berker Peksag added the comment:

The looks good to me in general, but I'd suggest to refer to the new algorithms_guaranteed and algorithms_available attributes in the following paragraph:

    +:func:`sha512`. The :func:`md5` is typically available, but will be missing if
    +Python has been compiled in FIPS-compliant mode. If hashlib was compiled with
    +OpenSSL support then additional algorithms may also be available depending
    +upon the OpenSSL library that Python uses on your platform. OpenSSL
    +implementations of the builtin algorithms are used if available.

----------
assignee:  -> docs at python
components: +Documentation
nosy: +berker.peksag, docs at python
stage:  -> patch review
type:  -> enhancement
versions: +Python 3.5, Python 3.6 -Python 3.3

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

From report at bugs.python.org  Sat Jun 11 01:25:18 2016
From: report at bugs.python.org (Martin Panter)
Date: Sat, 11 Jun 2016 05:25:18 +0000
Subject: [docs] [issue24136] document PEP 448: unpacking generalization
In-Reply-To: <1430918327.69.0.579699866453.issue24136@psf.upfronthosting.co.za>
Message-ID: <1465622717.19.0.77941477666.issue24136@psf.upfronthosting.co.za>


Martin Panter added the comment:

Here is a new patch that also updates the documentation for list etc displays as well as function calls. Let me know what you think.

The 3.5 What?s New notes were written separately; Neil?s patch was never applied. But I have rescued his update for functools.partial() in my new patch.

While experimenting with the current behaviour, I found some surprising inconsistencies. The following syntaxes are allowed:

>>> x, *y
>>> a = x, *y
>>> f"{x, *y}"  # New in 3.6
>>> async def f(): await x, *y

But the following all produce ?SyntaxError: invalid syntax?:

>>> a += x, *y
>>> eval("x, *y")
>>> def f(): return x, *y
>>> def f(): yield x, *y
>>> for i in x, *y: ...

Also, the expressions allowed for unpacking in general are more limited than in function calls:

>>> f(x, *y == z)  # Allowed
>>> (x, *y == z)
SyntaxError: invalid syntax

----------
Added file: http://bugs.python.org/file43339/unpacking-doc.patch

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

From report at bugs.python.org  Sat Jun 11 01:28:45 2016
From: report at bugs.python.org (Martin Panter)
Date: Sat, 11 Jun 2016 05:28:45 +0000
Subject: [docs] [issue20699] Document that binary IO classes work with
 bytes-likes objects
In-Reply-To: <1392889792.36.0.922412998797.issue20699@psf.upfronthosting.co.za>
Message-ID: <1465622924.97.0.355148435402.issue20699@psf.upfronthosting.co.za>


Martin Panter added the comment:

Thanks for you help figuring this out Serhiy, especially for the Python 2 case.

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

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

From report at bugs.python.org  Sat Jun 11 01:58:43 2016
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 11 Jun 2016 05:58:43 +0000
Subject: [docs] [issue20699] Document that binary IO classes work with
 bytes-likes objects
In-Reply-To: <1392889792.36.0.922412998797.issue20699@psf.upfronthosting.co.za>
Message-ID: <1465624723.17.0.130572396384.issue20699@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

Oh, I forgot to say my LGTM on your last patch. It LGTM.

But I'm feeling the documentation epic about bytes-like objects is far from the end.

----------

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

From report at bugs.python.org  Sat Jun 11 03:33:22 2016
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 11 Jun 2016 07:33:22 +0000
Subject: [docs] [issue27263] Tkinter sets the HOME environment variable,
 breaking scripts
In-Reply-To: <1465352687.77.0.957460905896.issue27263@psf.upfronthosting.co.za>
Message-ID: <1465630402.78.0.944130097631.issue27263@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

#14576 is more or less about making better use of USERPROFILE when the value returned by expanduser to config.IdleConf.GetUserCfgDir fails.  Now that I know that tcl always sets HOME (or pieces that are joined back together to make HOME), so that expanduser never fails (?), this might make some sense - but only if they are not the same.

Zach, I was thinking that _tkinter read TCL_LIBRARY to start tcl, but your answer suggests that it is instead read by tcl.

The problem with bad TCL_LIBRARY is that if IDLE is started normally, there is no error message.  Even if the user tries starting in the console, the message is almost useless.  I "set TCL_LIBRARY=NONE" and got
   ...
  File "C:\Programs\Python35\lib\tkinter\__init__.py", line 1867, in __init__
    self.tk = _tkinter.create(screenName, baseName, className, interactive, wantobjects, useTk, sync, use)
_tkinter.TclError: Can't find a usable init.tcl in the following directories:
    NONE C:/Programs/Python35/lib/tcl8.6 C:/Programs/lib/tcl8.6 C:/lib/tcl8.6 C:/Programs/library C:/library C:/tcl8.6.4/library C:/tcl8.6.4/library

Everything after NONE is nonsensical.  The IDLE doc needs a new sections "If IDLE does not start:.  Now I could write a troubleshooting note explaining for this note to ignore everything after the first item, and that the first item is an unusable setting of TCL_LIBRARY set by something or someone other than Python/Tkinter/IDLE.

I tried the same experiment with TK_LIBRARY and could see no effect.

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

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

From report at bugs.python.org  Sat Jun 11 12:46:18 2016
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 11 Jun 2016 16:46:18 +0000
Subject: [docs] [issue22558] Missing doc links to source code for
 Python-coded modules.
In-Reply-To: <1412514337.47.0.069385783283.issue22558@psf.upfronthosting.co.za>
Message-ID: <1465663578.9.0.204416528484.issue22558@psf.upfronthosting.co.za>


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


----------
assignee: docs at python -> terry.reedy
stage: patch review -> commit review

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

From report at bugs.python.org  Sat Jun 11 15:06:32 2016
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 11 Jun 2016 19:06:32 +0000
Subject: [docs] [issue22558] Missing doc links to source code for
 Python-coded modules.
In-Reply-To: <1412514337.47.0.069385783283.issue22558@psf.upfronthosting.co.za>
Message-ID: <20160611190628.9860.32142.CCD55CAD@psf.io>


Roundup Robot added the comment:

New changeset 222c1d461aa8 by Terry Jan Reedy in branch '3.5':
Issue #22558: Add remaining doc links to source code for Python-coded modules.
https://hg.python.org/cpython/rev/222c1d461aa8

New changeset 2a01d7a488e9 by Terry Jan Reedy in branch 'default':
Merge Issue #22558.
https://hg.python.org/cpython/rev/2a01d7a488e9

----------
nosy: +python-dev

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

From report at bugs.python.org  Sat Jun 11 15:27:32 2016
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 11 Jun 2016 19:27:32 +0000
Subject: [docs] [issue22558] Missing doc links to source code for
 Python-coded modules.
In-Reply-To: <1412514337.47.0.069385783283.issue22558@psf.upfronthosting.co.za>
Message-ID: <1465673251.93.0.816376495144.issue22558@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

I committed the excellent patch.  It should appear in the upcoming 3.5 and 3.6 releases, and within a day online.  Thanks to both package author and also to reviewers.  I would like to see more patches like this.

I reverted the deletion of version added in mock examples.  It is a separate page, so the reminder is not inappropriate.

Minor nit: Yoni, you 'forgot' to run "python tools/scripts/patchcheck.py" on a patched  repository.  Not too surprisingly, the editing left trailing whitespace that needed to be removed.  See the devguide for more.

A possible follow-on.  Some of the packages that document contained modules do so on the main page rather than in separate pages.  If the source link is to the package __init__, rather than to the package directory, then it would be appropriate to add links to the module sections.  The particular example I am thinking of is importlib, where we linked to .__init__.  There may be another.  Multiprocessing is not, because we linked to the directory.

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

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

From report at bugs.python.org  Sat Jun 11 18:26:09 2016
From: report at bugs.python.org (ppperry)
Date: Sat, 11 Jun 2016 22:26:09 +0000
Subject: [docs] [issue27263] Tkinter sets the HOME environment variable,
 breaking scripts
In-Reply-To: <1465352687.77.0.957460905896.issue27263@psf.upfronthosting.co.za>
Message-ID: <1465683969.59.0.303705255233.issue27263@psf.upfronthosting.co.za>


Changes by ppperry <mapreader at olum.org>:


----------
components:  -IDLE

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

From report at bugs.python.org  Sat Jun 11 18:40:33 2016
From: report at bugs.python.org (Jelle Zijlstra)
Date: Sat, 11 Jun 2016 22:40:33 +0000
Subject: [docs] [issue24136] document PEP 448: unpacking generalization
In-Reply-To: <1430918327.69.0.579699866453.issue24136@psf.upfronthosting.co.za>
Message-ID: <1465684833.77.0.319160137175.issue24136@psf.upfronthosting.co.za>


Jelle Zijlstra added the comment:

Thanks for writing a better patch. The patch looks good to me and it builds correctly.

----------

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

From report at bugs.python.org  Sat Jun 11 18:54:50 2016
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 11 Jun 2016 22:54:50 +0000
Subject: [docs] [issue27263] Tkinter sets the HOME environment variable,
 breaking scripts
In-Reply-To: <1465352687.77.0.957460905896.issue27263@psf.upfronthosting.co.za>
Message-ID: <1465685690.42.0.0767071838201.issue27263@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

ppperry, when I changed this to a doc issue, I added IDLE back as a component because, as I said in my last message, I want to include the facts revealed here in the IDLE doc.

----------
nosy: +ppperry

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

From report at bugs.python.org  Sat Jun 11 19:02:35 2016
From: report at bugs.python.org (ppperry)
Date: Sat, 11 Jun 2016 23:02:35 +0000
Subject: [docs] [issue27263] Tkinter sets the HOME environment variable,
 breaking scripts
In-Reply-To: <1465352687.77.0.957460905896.issue27263@psf.upfronthosting.co.za>
Message-ID: <1465686155.94.0.612365726905.issue27263@psf.upfronthosting.co.za>


Changes by ppperry <mapreader at olum.org>:


----------
nosy:  -ppperry

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

From report at bugs.python.org  Sat Jun 11 19:03:06 2016
From: report at bugs.python.org (Jelle Zijlstra)
Date: Sat, 11 Jun 2016 23:03:06 +0000
Subject: [docs] [issue27221] multiprocessing documentation is outdated
 regarding method picklability
In-Reply-To: <1465069362.83.0.142351405451.issue27221@psf.upfronthosting.co.za>
Message-ID: <1465686186.84.0.623658354189.issue27221@psf.upfronthosting.co.za>


Jelle Zijlstra added the comment:

Thanks for the Rietveld comments. I have attached a new patch.

----------
Added file: http://bugs.python.org/file43350/issue27221-cr.patch

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

From report at bugs.python.org  Sat Jun 11 20:12:22 2016
From: report at bugs.python.org (Yoni Lavi)
Date: Sun, 12 Jun 2016 00:12:22 +0000
Subject: [docs] [issue22558] Missing doc links to source code for
 Python-coded modules.
In-Reply-To: <1412514337.47.0.069385783283.issue22558@psf.upfronthosting.co.za>
Message-ID: <1465690342.5.0.369037688864.issue22558@psf.upfronthosting.co.za>


Yoni Lavi added the comment:

Thank you Terry, Nathan and David for your work on this.
Sorry about the whitespace issue, I indeed forgot to run patchcheck when I prepared the 3rd patch.

Tery, would you like me to prepare a patch for the follow-on you suggested? If so, given that this one is now marked as fixed, we should open a new bug, right?

----------

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

From report at bugs.python.org  Sat Jun 11 20:23:53 2016
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 12 Jun 2016 00:23:53 +0000
Subject: [docs] [issue22558] Missing doc links to source code for
 Python-coded modules.
In-Reply-To: <1412514337.47.0.069385783283.issue22558@psf.upfronthosting.co.za>
Message-ID: <1465691029.19.0.136588874865.issue22558@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

Yes, new issue, make me nosy, assign to me if allowed, upload patch. Start with "This is a follow to #22558."

----------

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

From report at bugs.python.org  Sat Jun 11 20:56:57 2016
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 12 Jun 2016 00:56:57 +0000
Subject: [docs] [issue15468] Edit docs to hide hashlib.md5()
In-Reply-To: <1343404007.83.0.817302008925.issue15468@psf.upfronthosting.co.za>
Message-ID: <20160612005649.114300.99574.093AB243@psf.io>


Roundup Robot added the comment:

New changeset 13ea0a1d7dde by Gregory P. Smith in branch 'default':
issue15468 - use sha256 instead of md5 or sha1 in the examples.
https://hg.python.org/cpython/rev/13ea0a1d7dde

----------
nosy: +python-dev

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

From report at bugs.python.org  Sat Jun 11 21:02:23 2016
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 12 Jun 2016 01:02:23 +0000
Subject: [docs] [issue15468] Edit docs to hide hashlib.md5()
In-Reply-To: <1343404007.83.0.817302008925.issue15468@psf.upfronthosting.co.za>
Message-ID: <20160612010218.101877.21718.D0F7B22C@psf.io>


Roundup Robot added the comment:

New changeset 1cfd627bee05 by Gregory P. Smith in branch 'default':
Clarify that md5 is in the algorithms_guaranteed list despite what
https://hg.python.org/cpython/rev/1cfd627bee05

----------

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

From report at bugs.python.org  Sat Jun 11 21:03:13 2016
From: report at bugs.python.org (Gregory P. Smith)
Date: Sun, 12 Jun 2016 01:03:13 +0000
Subject: [docs] [issue15468] Edit docs to hide hashlib.md5()
In-Reply-To: <1343404007.83.0.817302008925.issue15468@psf.upfronthosting.co.za>
Message-ID: <1465693393.9.0.158697898637.issue15468@psf.upfronthosting.co.za>


Changes by Gregory P. Smith <greg at krypto.org>:


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

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

From report at bugs.python.org  Sat Jun 11 22:06:38 2016
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 12 Jun 2016 02:06:38 +0000
Subject: [docs] [issue24136] document PEP 448: unpacking generalization
In-Reply-To: <1430918327.69.0.579699866453.issue24136@psf.upfronthosting.co.za>
Message-ID: <20160612020634.9983.59650.1F9E56B8@psf.io>


Roundup Robot added the comment:

New changeset a7e04b4e51b2 by Martin Panter in branch '3.5':
Issue #24136: Document generalized unpacking, PEP 448
https://hg.python.org/cpython/rev/a7e04b4e51b2

New changeset 4cf3389cd8e6 by Martin Panter in branch 'default':
Issue #24136: Merge unpacking doc from 3.5
https://hg.python.org/cpython/rev/4cf3389cd8e6

New changeset 2c10f0e92256 by Martin Panter in branch 'default':
Issue #24136: Adjust f-strings doc for interable unpacking
https://hg.python.org/cpython/rev/2c10f0e92256

----------
nosy: +python-dev

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

From report at bugs.python.org  Sun Jun 12 03:17:55 2016
From: report at bugs.python.org (Martin Panter)
Date: Sun, 12 Jun 2016 07:17:55 +0000
Subject: [docs] [issue24136] document PEP 448: unpacking generalization
In-Reply-To: <1430918327.69.0.579699866453.issue24136@psf.upfronthosting.co.za>
Message-ID: <1465715875.85.0.060803962787.issue24136@psf.upfronthosting.co.za>


Martin Panter added the comment:

Thanks for the review. I committed my patch in the hope that it makes it into 3.5.2, but if people want to suggest further improvements etc that is okay.

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

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

From report at bugs.python.org  Sun Jun 12 04:49:05 2016
From: report at bugs.python.org (Berker Peksag)
Date: Sun, 12 Jun 2016 08:49:05 +0000
Subject: [docs] [issue27221] multiprocessing documentation is outdated
 regarding method picklability
In-Reply-To: <1465069362.83.0.142351405451.issue27221@psf.upfronthosting.co.za>
Message-ID: <1465721345.8.0.697007623545.issue27221@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Actually, we can remove the versionchanged directive. The attached script works fine with the spawn start method in Python 3.4.

I will commit the following version:

    Ensure that all arguments to :meth:`Process.__init__` are picklable.
    Also, if you subclass :class:`~multiprocessing.Process` then make sure that
    instances will be picklable when the :meth:`Process.start
    <multiprocessing.Process.start>` method is called.

----------
Added file: http://bugs.python.org/file43358/mm.py

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

From report at bugs.python.org  Sun Jun 12 05:19:30 2016
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 12 Jun 2016 09:19:30 +0000
Subject: [docs] [issue27221] multiprocessing documentation is outdated
 regarding method picklability
In-Reply-To: <1465069362.83.0.142351405451.issue27221@psf.upfronthosting.co.za>
Message-ID: <20160612091926.81413.84994.3B0EC977@psf.io>


Roundup Robot added the comment:

New changeset 97254031f0b7 by Berker Peksag in branch '3.5':
Issue #27221: Delete an outdated paragraph about pickle support of Process
https://hg.python.org/cpython/rev/97254031f0b7

New changeset 5b9d8b5b1139 by Berker Peksag in branch 'default':
Issue #27221: Merge from 3.5
https://hg.python.org/cpython/rev/5b9d8b5b1139

----------
nosy: +python-dev

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

From report at bugs.python.org  Sun Jun 12 05:20:14 2016
From: report at bugs.python.org (Berker Peksag)
Date: Sun, 12 Jun 2016 09:20:14 +0000
Subject: [docs] [issue27221] multiprocessing documentation is outdated
 regarding method picklability
In-Reply-To: <1465069362.83.0.142351405451.issue27221@psf.upfronthosting.co.za>
Message-ID: <1465723213.95.0.233384373321.issue27221@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Thanks!

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

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

From report at bugs.python.org  Sun Jun 12 05:51:54 2016
From: report at bugs.python.org (Berker Peksag)
Date: Sun, 12 Jun 2016 09:51:54 +0000
Subject: [docs] [issue15243] Misleading documentation for __prepare__
In-Reply-To: <1341328118.33.0.670602196671.issue15243@psf.upfronthosting.co.za>
Message-ID: <1465725114.83.0.0178399080532.issue15243@psf.upfronthosting.co.za>


Berker Peksag added the comment:

The documentation should mention that the __prepare__ method must be implemented as a classmethod (see msg164697 for the reference.)

The example at https://docs.python.org/dev/reference/datamodel.html#metaclass-example needs to be linked from the "Preparing the class namespace" section.

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

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

From report at bugs.python.org  Sun Jun 12 06:42:03 2016
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 12 Jun 2016 10:42:03 +0000
Subject: [docs] [issue27188] sqlite3 execute* methods return value not
 documented
In-Reply-To: <1464904414.88.0.548243958784.issue27188@psf.upfronthosting.co.za>
Message-ID: <20160612104200.26564.59873.49B7152C@psf.io>


Roundup Robot added the comment:

New changeset a825aee0721f by Berker Peksag in branch '3.5':
Issue #27188: Fix various sqlite3 documentation errors
https://hg.python.org/cpython/rev/a825aee0721f

New changeset 187b2bc0fe26 by Berker Peksag in branch 'default':
Issue #27188: Merge from 3.5
https://hg.python.org/cpython/rev/187b2bc0fe26

----------
nosy: +python-dev

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

From report at bugs.python.org  Sun Jun 12 06:44:25 2016
From: report at bugs.python.org (Berker Peksag)
Date: Sun, 12 Jun 2016 10:44:25 +0000
Subject: [docs] [issue27188] sqlite3 execute* methods return value not
 documented
In-Reply-To: <1464904414.88.0.548243958784.issue27188@psf.upfronthosting.co.za>
Message-ID: <1465728265.66.0.912833137394.issue27188@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Thanks for the patch Dave. I found a couple of more issues while reviewing the patch and fixed them.

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

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

From report at bugs.python.org  Sun Jun 12 09:35:31 2016
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 12 Jun 2016 13:35:31 +0000
Subject: [docs] [issue15657] Error in Python 3 docs for PyMethodDef
In-Reply-To: <1344970966.7.0.115664419243.issue15657@psf.upfronthosting.co.za>
Message-ID: <20160612133518.101651.12964.D4D22FF3@psf.io>


Roundup Robot added the comment:

New changeset 367b3f41710a by Berker Peksag in branch '3.5':
Issue #15657: Delete incorrect statement from PyMethodDef documentation
https://hg.python.org/cpython/rev/367b3f41710a

New changeset 7fa4986d8218 by Berker Peksag in branch 'default':
Issue #15657: Null merge from 3.5
https://hg.python.org/cpython/rev/7fa4986d8218

----------
nosy: +python-dev

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

From report at bugs.python.org  Sun Jun 12 09:37:56 2016
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 12 Jun 2016 13:37:56 +0000
Subject: [docs] [issue15657] Error in Python 3 docs for PyMethodDef
In-Reply-To: <1344970966.7.0.115664419243.issue15657@psf.upfronthosting.co.za>
Message-ID: <20160612133743.120669.38395.2061CE0E@psf.io>


Roundup Robot added the comment:

New changeset f520ae3b537b by Berker Peksag in branch '2.7':
Issue #15657: Delete incorrect statement from PyMethodDef documentation
https://hg.python.org/cpython/rev/f520ae3b537b

----------

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

From report at bugs.python.org  Sun Jun 12 09:54:40 2016
From: report at bugs.python.org (Berker Peksag)
Date: Sun, 12 Jun 2016 13:54:40 +0000
Subject: [docs] [issue15657] Error in Python 3 docs for PyMethodDef
In-Reply-To: <1344970966.7.0.115664419243.issue15657@psf.upfronthosting.co.za>
Message-ID: <1465739680.12.0.776023219308.issue15657@psf.upfronthosting.co.za>


Berker Peksag added the comment:

> Then change the value of METH_KEYWORDS from 0x0002 to 0x0003 in 3.6.

Here is a patch.

----------
Added file: http://bugs.python.org/file43364/issue15657_36.diff

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

From report at bugs.python.org  Mon Jun 13 00:14:43 2016
From: report at bugs.python.org (Yoni Lavi)
Date: Mon, 13 Jun 2016 04:14:43 +0000
Subject: [docs] [issue27304] Create "Source Code" links in module sections,
 where relevant
Message-ID: <1465791283.3.0.647535904935.issue27304@psf.upfronthosting.co.za>


New submission from Yoni Lavi:

This is a follow to #22558.

As per Terry's suggestion in #22558, for packages with multiple modules that are all documented on the same page and that currently have a "Source Code" link to an __init__ file (e.g. importlib), we should also add more specific "Source Code" links to the module sections.

Attached is a patch for the documentation of the 3 such packages that I found: importlib, dbm and json

----------
assignee: docs at python
components: Documentation
files: mywork.patch
keywords: patch
messages: 268417
nosy: Yoni Lavi, docs at python, terry.reedy
priority: normal
severity: normal
status: open
title: Create "Source Code" links in module sections, where relevant
versions: Python 3.5, Python 3.6
Added file: http://bugs.python.org/file43369/mywork.patch

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

From report at bugs.python.org  Mon Jun 13 00:16:21 2016
From: report at bugs.python.org (Yoni Lavi)
Date: Mon, 13 Jun 2016 04:16:21 +0000
Subject: [docs] [issue22558] Missing doc links to source code for
 Python-coded modules.
In-Reply-To: <1412514337.47.0.069385783283.issue22558@psf.upfronthosting.co.za>
Message-ID: <1465791381.34.0.725849230012.issue22558@psf.upfronthosting.co.za>


Yoni Lavi added the comment:

Created issue 27304 and uploaded a patch.

----------

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

From s1113967 at gmail.com  Mon Jun 13 08:00:21 2016
From: s1113967 at gmail.com (Mateusz Zan)
Date: Mon, 13 Jun 2016 13:00:21 +0100
Subject: [docs] 3.5 docs 404 error
In-Reply-To: <CAH1J6nB7vPskbhn+5Ep-wXaAfNB1iHWMo18Y0VJJ7_iGzMLhYw@mail.gmail.com>
References: <CAH1J6nB7vPskbhn+5Ep-wXaAfNB1iHWMo18Y0VJJ7_iGzMLhYw@mail.gmail.com>
Message-ID: <CAH1J6nCW4e=akGKeCY2=2+p__kr7znNFdj=3WJ0wGDyjjwv_xw@mail.gmail.com>

Hi
Im going for a long flight and will try to do some coding in the meantime.
Of course there is no internet on the plane so i thought i would download
yhr python docs for reference. I tried to do that but link is not working-
404 error. Any chance it will be fixed soon (i can see info on download
website updated 13.06- is it just temporal disability to download?)
Many thanks,
Mat
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160613/cbbd9877/attachment.html>

From report at bugs.python.org  Mon Jun 13 08:16:59 2016
From: report at bugs.python.org (Phil Jeffes)
Date: Mon, 13 Jun 2016 12:16:59 +0000
Subject: [docs] [issue27306] Grammatical Error in Documentation - Tarfile
 page
Message-ID: <1465820218.96.0.154135651878.issue27306@psf.upfronthosting.co.za>


New submission from Phil Jeffes:

On the tarfile page (https://docs.python.org/3.5/library/tarfile.html) there is a line which reads:

mode is either 'r' to read from an existing archive, 'a' to append data to an existing file, 'w' to create a new file overwriting an existing one or 'x' to create a new file only if it?s not exists.

and it should read:

mode is either 'r' to read from an existing archive, 'a' to append data to an existing file, 'w' to create a new file overwriting an existing one or 'x' to create a new file only if *it does not already exist*.

(Suggested changes surrounded by * *)

----------
assignee: docs at python
components: Documentation
messages: 268435
nosy: Phil Jeffes, docs at python
priority: normal
severity: normal
status: open
title: Grammatical Error in Documentation - Tarfile page
type: behavior
versions: Python 3.5

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

From report at bugs.python.org  Mon Jun 13 08:20:14 2016
From: report at bugs.python.org (SilentGhost)
Date: Mon, 13 Jun 2016 12:20:14 +0000
Subject: [docs] [issue27306] Grammatical Error in Documentation - Tarfile
 page
In-Reply-To: <1465820218.96.0.154135651878.issue27306@psf.upfronthosting.co.za>
Message-ID: <1465820414.77.0.891239551843.issue27306@psf.upfronthosting.co.za>


SilentGhost added the comment:

There are more occurrences of "it is already exists" in the first table.

----------
nosy: +SilentGhost
stage:  -> needs patch
versions: +Python 3.6

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

From report at bugs.python.org  Mon Jun 13 11:00:27 2016
From: report at bugs.python.org (Gareth Rees)
Date: Mon, 13 Jun 2016 15:00:27 +0000
Subject: [docs] [issue27306] Grammatical Error in Documentation - Tarfile
 page
In-Reply-To: <1465820218.96.0.154135651878.issue27306@psf.upfronthosting.co.za>
Message-ID: <1465830027.6.0.77279947091.issue27306@psf.upfronthosting.co.za>


Gareth Rees added the comment:

Here's a patch improving the grammar in the tarfile documentation.

----------
keywords: +patch
nosy: +Gareth.Rees
Added file: http://bugs.python.org/file43375/issue27306.patch

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

From william.b.minniear at boeing.com  Mon Jun 13 11:02:19 2016
From: william.b.minniear at boeing.com (Minniear, William B)
Date: Mon, 13 Jun 2016 15:02:19 +0000
Subject: [docs] Python 3.5 HTML Documentation
Message-ID: <d7bda50fa77e4c47a768345c5b8465ca@XCH15-05-12.nw.nos.boeing.com>

Hello,

I was currently searching your site for the 3.5 documentation to download in HTML format, but the website is giving me a 404 Not Found error. Would you happen to have that documentation available? Any help is greatly appreciated.

Thanks,

William Minniear
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160613/a1e60daf/attachment-0001.html>

From walter.tackett at gmail.com  Mon Jun 13 11:02:56 2016
From: walter.tackett at gmail.com (walter tackett)
Date: Mon, 13 Jun 2016 08:02:56 -0700
Subject: [docs] BUG: All links to PDF/ZIP python docs are 404,
 all versions / All Formats
Message-ID: <775AC38A-66B5-49FC-B268-B6AF9D381992@gmail.com>

Before:


AFTER (all formats, all 3.x versions (at least):

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160613/3ac8b582/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: Screen Shot 2016-06-13 at 8.00.10 AM.png
Type: image/png
Size: 254260 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20160613/3ac8b582/attachment-0002.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: Screen Shot 2016-06-13 at 8.01.23 AM.png
Type: image/png
Size: 88410 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20160613/3ac8b582/attachment-0003.png>

From report at bugs.python.org  Mon Jun 13 11:15:45 2016
From: report at bugs.python.org (SilentGhost)
Date: Mon, 13 Jun 2016 15:15:45 +0000
Subject: [docs] [issue27306] Grammatical Error in Documentation - Tarfile
 page
In-Reply-To: <1465820218.96.0.154135651878.issue27306@psf.upfronthosting.co.za>
Message-ID: <1465830945.75.0.417458963833.issue27306@psf.upfronthosting.co.za>


SilentGhost added the comment:

LGTM.

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

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

From cg.venus at gmail.com  Mon Jun 13 11:32:04 2016
From: cg.venus at gmail.com (cyb)
Date: Mon, 13 Jun 2016 16:32:04 +0100
Subject: [docs] tkinter
Message-ID: <CA+k=JpanNyc12WGHRyp=HAu02AbBaWK_t57RD9SKv87knfFM3A@mail.gmail.com>

Cannot find winfo_screenwidth in documentation. Cheers.

Working code:

import tkinter

window = tkinter.Tk()

screen_width = window.winfo_screenwidth()
screen_height = window.winfo_screenheight()

print(screen_width, screen_height)

window.geometry(str(screen_width-100)+"x256")
window.mainloop()
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160613/cda4d0cd/attachment.html>

From report at bugs.python.org  Mon Jun 13 17:48:48 2016
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 13 Jun 2016 21:48:48 +0000
Subject: [docs] [issue27306] Grammatical Error in Documentation - Tarfile
 page
In-Reply-To: <1465820218.96.0.154135651878.issue27306@psf.upfronthosting.co.za>
Message-ID: <20160613214844.20127.21533.1F1B646B@psf.io>


Roundup Robot added the comment:

New changeset 48052a140eed by Berker Peksag in branch '3.5':
Issue #27306: Fix typo in tarfile documentation
https://hg.python.org/cpython/rev/48052a140eed

New changeset 9c9ed326d981 by Berker Peksag in branch 'default':
Issue #27306: Merge from 3.5
https://hg.python.org/cpython/rev/9c9ed326d981

----------
nosy: +python-dev

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

From report at bugs.python.org  Mon Jun 13 17:49:10 2016
From: report at bugs.python.org (Berker Peksag)
Date: Mon, 13 Jun 2016 21:49:10 +0000
Subject: [docs] [issue27306] Grammatical Error in Documentation - Tarfile
 page
In-Reply-To: <1465820218.96.0.154135651878.issue27306@psf.upfronthosting.co.za>
Message-ID: <1465854550.08.0.624278788463.issue27306@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Thank you all!

----------
nosy: +berker.peksag
resolution:  -> fixed
stage: commit review -> resolved
status: open -> closed

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

From report at bugs.python.org  Mon Jun 13 17:57:18 2016
From: report at bugs.python.org (Jarrod Petz)
Date: Mon, 13 Jun 2016 21:57:18 +0000
Subject: [docs] [issue27263] Tkinter sets the HOME environment variable,
 breaking scripts
In-Reply-To: <1465352687.77.0.957460905896.issue27263@psf.upfronthosting.co.za>
Message-ID: <1465855038.4.0.260788381476.issue27263@psf.upfronthosting.co.za>


Jarrod Petz added the comment:

eryksun, now I understand this is a bit more challenging because tkinter is the underlying library doing this and it is shared by other apps.

Though I still don't feel that just because its been like this since 1995 means it should stay this way. This is something which breaks other code following the python os.path.expanduser way(and probably other thing looking at the evitonmeny HOME). Not all people will try getting to the bottom of why, esspecially if they are a new user. It should just work.

Would iy be possible for tkinter to allow the user/app to decide the behavior?

Ie. Have a setting(s)/switch which allows the default behavior of setting and using HOME to be overiden.

By doing that existing apps remain unchanged and apps like IDLE could change this behavior to whatever they want when they are ready.

I think os.path.expanduser() behavior is by far more logical. Preference USERPROFILE if HOME is missing. USERPROFILE on windows is needed to even login. HOMEDRIVE/HOMEPATH is not.

----------

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

From report at bugs.python.org  Mon Jun 13 20:42:21 2016
From: report at bugs.python.org (John Hagen)
Date: Tue, 14 Jun 2016 00:42:21 +0000
Subject: [docs] [issue27311] Incorrect documentation for zipfile.writestr()
Message-ID: <1465864941.05.0.345060177149.issue27311@psf.upfronthosting.co.za>


New submission from John Hagen:

The function signature and description for zipfile.writestr is incorrect:

https://docs.python.org/3.5/library/zipfile.html#zipfile.ZipFile.writestr

See:
https://github.com/python/cpython/blob/master/Lib/zipfile.py#L1610

The documentation calls the parameter 'bytes', but the real parameter name is 'data'.

Looks like this was not fixed when the source changed to Python 3:
https://github.com/python/cpython/blob/2.7/Lib/zipfile.py#L1208

----------
assignee: docs at python
components: Documentation
messages: 268490
nosy: John Hagen, docs at python
priority: normal
severity: normal
status: open
title: Incorrect documentation for zipfile.writestr()
versions: Python 3.4, Python 3.5, Python 3.6

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

From report at bugs.python.org  Mon Jun 13 20:44:22 2016
From: report at bugs.python.org (Martin Panter)
Date: Tue, 14 Jun 2016 00:44:22 +0000
Subject: [docs] [issue12855] linebreak sequences should be better documented
In-Reply-To: <1314654150.68.0.797504547224.issue12855@psf.upfronthosting.co.za>
Message-ID: <1465865062.2.0.163816844064.issue12855@psf.upfronthosting.co.za>


Martin Panter added the comment:

Alexander: does my latest patch linebreakdoc.v5.py2.7.patch address your concerns about the 2.7 documentation? If so, I can push it to the repository.

----------

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

From report at bugs.python.org  Mon Jun 13 21:06:53 2016
From: report at bugs.python.org (Martin Panter)
Date: Tue, 14 Jun 2016 01:06:53 +0000
Subject: [docs] [issue27311] Incorrect documentation for zipfile.writestr()
In-Reply-To: <1465864941.05.0.345060177149.issue27311@psf.upfronthosting.co.za>
Message-ID: <1465866413.37.0.420043453995.issue27311@psf.upfronthosting.co.za>


Martin Panter added the comment:

Looks like you are right. The change in the implementation happened in revision 19196cce1431.

----------
keywords: +easy
nosy: +martin.panter
stage:  -> needs patch
versions:  -Python 3.4

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

From report at bugs.python.org  Mon Jun 13 21:11:29 2016
From: report at bugs.python.org (Terry J. Reedy)
Date: Tue, 14 Jun 2016 01:11:29 +0000
Subject: [docs] [issue27263] Tkinter sets the HOME environment variable,
 breaking scripts
In-Reply-To: <1465352687.77.0.957460905896.issue27263@psf.upfronthosting.co.za>
Message-ID: <1465866689.49.0.20471560476.issue27263@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

How about wrapping the appropriate tkinter code with (untested yet)

import os
HOME = os.environ['HOME']
try:
    <run tkinter>
finally"
    os.environ['HOME'] = HOME  # will this unset?

or use a restore_env('HOME', ...) context manager?

Revising os.expanduser or apps to ignore HOME while tk is running is a related but different issue.

----------

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

From report at bugs.python.org  Mon Jun 13 21:12:05 2016
From: report at bugs.python.org (John Hagen)
Date: Tue, 14 Jun 2016 01:12:05 +0000
Subject: [docs] [issue27311] Incorrect documentation for zipfile.writestr()
In-Reply-To: <1465864941.05.0.345060177149.issue27311@psf.upfronthosting.co.za>
Message-ID: <1465866725.37.0.337377198746.issue27311@psf.upfronthosting.co.za>


John Hagen added the comment:

I'll submit a patch shortly.

----------

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

From jackhose1932 at aol.com  Mon Jun 13 17:41:35 2016
From: jackhose1932 at aol.com (Jack Hose)
Date: Mon, 13 Jun 2016 17:41:35 -0400
Subject: [docs] Documentation Downloads
Message-ID: <1554bb6710f-1ab9-1aa04@webprd-a32.mail.aol.com>

I get a 404 page not found when I try to download Documentation from the Python site.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160613/7cd24308/attachment.html>

From Stephan.Adolf at uni-oldenburg.de  Tue Jun 14 03:48:05 2016
From: Stephan.Adolf at uni-oldenburg.de (Stephan Adolf)
Date: Tue, 14 Jun 2016 09:48:05 +0200
Subject: [docs] Download Python 3.5.1 Documentation
Message-ID: <575FB6B5.3030004@uni-oldenburg.de>

Dear Sir or Madam,

the download of the Python 3.5.1 Documentation is offline (one simply
gets a 404 error, url: https://docs.python.org/3.5/download.html). When
will the pdf be online again?

Thank you!

Best wishes,

Stephan Adolf

From report at bugs.python.org  Tue Jun 14 15:39:26 2016
From: report at bugs.python.org (Alexander Schrijver)
Date: Tue, 14 Jun 2016 19:39:26 +0000
Subject: [docs] [issue12855] linebreak sequences should be better documented
In-Reply-To: <1314654150.68.0.797504547224.issue12855@psf.upfronthosting.co.za>
Message-ID: <1465933166.09.0.176586985272.issue12855@psf.upfronthosting.co.za>


Alexander Schrijver added the comment:

Martin: Yes, it does, thank you. Sorry, I didn't know you where waiting for my approval.

----------

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

From report at bugs.python.org  Tue Jun 14 19:10:30 2016
From: report at bugs.python.org (John Hagen)
Date: Tue, 14 Jun 2016 23:10:30 +0000
Subject: [docs] [issue27311] Incorrect documentation for zipfile.writestr()
In-Reply-To: <1465864941.05.0.345060177149.issue27311@psf.upfronthosting.co.za>
Message-ID: <1465945830.15.0.775446290174.issue27311@psf.upfronthosting.co.za>


John Hagen added the comment:

Patch attached.

----------
keywords: +patch
Added file: http://bugs.python.org/file43395/0001-Fix-ZipFile.writestr-data-argument-name.patch

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

From report at bugs.python.org  Tue Jun 14 19:35:10 2016
From: report at bugs.python.org (Martin Panter)
Date: Tue, 14 Jun 2016 23:35:10 +0000
Subject: [docs] [issue27311] Incorrect documentation for zipfile.writestr()
In-Reply-To: <1465864941.05.0.345060177149.issue27311@psf.upfronthosting.co.za>
Message-ID: <1465947310.72.0.639409051234.issue27311@psf.upfronthosting.co.za>


Martin Panter added the comment:

Thanks John

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

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

From report at bugs.python.org  Tue Jun 14 21:08:04 2016
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 15 Jun 2016 01:08:04 +0000
Subject: [docs] [issue27311] Incorrect documentation for zipfile.writestr()
In-Reply-To: <1465864941.05.0.345060177149.issue27311@psf.upfronthosting.co.za>
Message-ID: <20160615010759.20145.2506.EAC54E8F@psf.io>


Roundup Robot added the comment:

New changeset 32af78a8b88f by Martin Panter in branch '3.5':
Issue #27311: Fix ZipFile.writestr data argument name.
https://hg.python.org/cpython/rev/32af78a8b88f

New changeset e3bb87952c62 by Martin Panter in branch 'default':
Issue #27311: Merge zipfile doc from 3.5
https://hg.python.org/cpython/rev/e3bb87952c62

----------
nosy: +python-dev

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

From report at bugs.python.org  Tue Jun 14 21:43:37 2016
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 15 Jun 2016 01:43:37 +0000
Subject: [docs] [issue12855] linebreak sequences should be better documented
In-Reply-To: <1314654150.68.0.797504547224.issue12855@psf.upfronthosting.co.za>
Message-ID: <20160615014333.27977.85212.7AA03DCF@psf.io>


Roundup Robot added the comment:

New changeset 2e6fda267a20 by Martin Panter in branch '2.7':
Issue #12855: Document what exactly unicode.splitlines() splits on
https://hg.python.org/cpython/rev/2e6fda267a20

----------

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

From report at bugs.python.org  Tue Jun 14 21:43:58 2016
From: report at bugs.python.org (Martin Panter)
Date: Wed, 15 Jun 2016 01:43:58 +0000
Subject: [docs] [issue27311] Incorrect documentation for zipfile.writestr()
In-Reply-To: <1465864941.05.0.345060177149.issue27311@psf.upfronthosting.co.za>
Message-ID: <1465955038.1.0.247050689458.issue27311@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Tue Jun 14 22:01:19 2016
From: report at bugs.python.org (Martin Panter)
Date: Wed, 15 Jun 2016 02:01:19 +0000
Subject: [docs] [issue12855] linebreak sequences should be better documented
In-Reply-To: <1314654150.68.0.797504547224.issue12855@psf.upfronthosting.co.za>
Message-ID: <1465956079.57.0.401395989148.issue12855@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Wed Jun 15 04:34:18 2016
From: report at bugs.python.org (Berker Peksag)
Date: Wed, 15 Jun 2016 08:34:18 +0000
Subject: [docs] [issue26582] asyncio documentation links to wrong
 CancelledError
In-Reply-To: <1458225953.38.0.399231880747.issue26582@psf.upfronthosting.co.za>
Message-ID: <1465979658.76.0.384701708423.issue26582@psf.upfronthosting.co.za>


Berker Peksag added the comment:

CancelledError documentation needs to be updated to mention that it is an alias for 'concurrent.futures.CancelledError'. We also need to update all ``:exc:`~concurrent.futures.CancelledError``` usages in Doc/library/asyncio*.rst. I'd prefer to reuse the description of https://docs.python.org/3.5/library/concurrent.futures.html#concurrent.futures.CancelledError

----------
nosy: +berker.peksag
stage:  -> patch review
type:  -> enhancement

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

From christianbeasley0 at gmail.com  Tue Jun 14 17:31:49 2016
From: christianbeasley0 at gmail.com (Christian Beasley)
Date: Tue, 14 Jun 2016 16:31:49 -0500
Subject: [docs] https://docs.python.org/3/download.html 404
Message-ID: <A9CDAD07-A1A2-41E7-83C3-BE2F5A44B33A@gmail.com>

I get a 404 when trying to download any documentation format from https://docs.python.org/3/download.html <https://docs.python.org/3/download.html>.

I?m on OS X, Chrome 50.0. 
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160614/7a277649/attachment.html>

From pathanajaz at gmail.com  Wed Jun 15 00:54:10 2016
From: pathanajaz at gmail.com (Pathan Ajaz)
Date: Wed, 15 Jun 2016 10:24:10 +0530
Subject: [docs] Problem in Download a Document
Message-ID: <CAOb+OoSpTNuJY98hQmruDA=qqTV9=_viYhQdpD08w93c62OHNA@mail.gmail.com>

Hello Sir/ Madam

I hope You Doing Well. I want to Download Document. But Its Not. Please
Send me Python Document.

-- 











*Best Regards,*

*AJAZ PATHAN*
*Mo. : (+91) 992-401-0784*
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160615/a92591dd/attachment.html>

From list.python-docs at munkynet.org  Wed Jun 15 10:37:02 2016
From: list.python-docs at munkynet.org (Sam Hathaway)
Date: Wed, 15 Jun 2016 10:37:02 -0400
Subject: [docs] PATCH: make faq/general.rst gender-inclusive
Message-ID: <97959EC3-0BFF-4389-98CB-B9DE91758743@munkynet.org>

Hello,

The general FAQ uses a gendered pronoun in the answer to ?Is Python a 
good language for beginning programmers??. The following patch fixes 
this. Thanks for helping make Python more inclusive.
-sam

diff -r 4ef3a93e1be2 Doc/faq/general.rst
--- a/Doc/faq/general.rst	Wed Jun 15 11:35:29 2016 +0200
+++ b/Doc/faq/general.rst	Wed Jun 15 10:33:52 2016 -0400
@@ -438,7 +438,7 @@
    >>> L
     [1]

-With the interpreter, documentation is never far from the student as 
he's
+With the interpreter, documentation is never far from the student as 
they are
  programming.

  There are also good IDEs for Python.  IDLE is a cross-platform IDE for 
Python

From berker.peksag at gmail.com  Wed Jun 15 11:13:52 2016
From: berker.peksag at gmail.com (=?UTF-8?Q?Berker_Peksa=C4=9F?=)
Date: Wed, 15 Jun 2016 18:13:52 +0300
Subject: [docs] PATCH: make faq/general.rst gender-inclusive
In-Reply-To: <97959EC3-0BFF-4389-98CB-B9DE91758743@munkynet.org>
References: <97959EC3-0BFF-4389-98CB-B9DE91758743@munkynet.org>
Message-ID: <CAF4280+HCpUZ5XBmKxYBKqdv0ofqp6g27pz2M6sOZuUXGOAHPw@mail.gmail.com>

On Wed, Jun 15, 2016 at 5:37 PM, Sam Hathaway
<list.python-docs at munkynet.org> wrote:
> Hello,
>
> The general FAQ uses a gendered pronoun in the answer to ?Is Python a good
> language for beginning programmers??. The following patch fixes this. Thanks
> for helping make Python more inclusive.

Hi Sam,

Thanks for the patch. Pushed in https://hg.python.org/cpython/rev/e9fb7970f8b0

--Berker

From changxiaodong.cxd at gmail.com  Wed Jun 15 11:22:30 2016
From: changxiaodong.cxd at gmail.com (=?UTF-8?B?5bi45pmT5Yas?=)
Date: Wed, 15 Jun 2016 23:22:30 +0800
Subject: [docs] 404 error of documents download.
Message-ID: <CAC5Cje2We8QWkfVquZwyW76h9-CR70LmtA+zmE5wzFpAyvpfSw@mail.gmail.com>

I can't download documents of python 2.7.12 here
https://docs.python.org/2/download.html. Please check the link.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160615/1a06544a/attachment.html>

From changxiaodong.cxd at gmail.com  Wed Jun 15 11:18:21 2016
From: changxiaodong.cxd at gmail.com (=?gb18030?B?0KHPusPX?=)
Date: Wed, 15 Jun 2016 23:18:21 +0800
Subject: [docs] 404 error of documents download.
Message-ID: <tencent_4CE261BC01EC39614D5696EE@qq.com>

I can't download documents of python 2.7.12 here https://docs.python.org/2/download.html.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160615/5059a221/attachment.html>

From report at bugs.python.org  Wed Jun 15 17:38:39 2016
From: report at bugs.python.org (Jakub Wilk)
Date: Wed, 15 Jun 2016 21:38:39 +0000
Subject: [docs] [issue27327] re documentation: typo "escapes consist of"
Message-ID: <1466026719.49.0.251022149797.issue27327@psf.upfronthosting.co.za>


New submission from Jakub Wilk:

Documentation for the re module <https://docs.python.org/3/library/re.html> reads:

    Unknown escapes consist of '\' and ASCII letter now raise a deprecation warning ...

This should be:

    ... escapes consisting of ...

----------
assignee: docs at python
components: Documentation
messages: 268630
nosy: docs at python, jwilk
priority: normal
severity: normal
status: open
title: re documentation: typo "escapes consist of"
versions: Python 3.5

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

From report at bugs.python.org  Wed Jun 15 18:10:27 2016
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 15 Jun 2016 22:10:27 +0000
Subject: [docs] [issue27327] re documentation: typo "escapes consist of"
In-Reply-To: <1466026719.49.0.251022149797.issue27327@psf.upfronthosting.co.za>
Message-ID: <20160615221017.26579.21675.6DFDF293@psf.io>


Roundup Robot added the comment:

New changeset 2a7dd5414485 by Ned Deily in branch '3.5':
Issue #27327: fix doc typo, noted by Jakub Wilk.
https://hg.python.org/cpython/rev/2a7dd5414485

New changeset b3f97ed4a904 by Ned Deily in branch 'default':
Issue #27327: null merge from 3.5
https://hg.python.org/cpython/rev/b3f97ed4a904

----------
nosy: +python-dev

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

From report at bugs.python.org  Wed Jun 15 18:11:00 2016
From: report at bugs.python.org (Ned Deily)
Date: Wed, 15 Jun 2016 22:11:00 +0000
Subject: [docs] [issue27327] re documentation: typo "escapes consist of"
In-Reply-To: <1466026719.49.0.251022149797.issue27327@psf.upfronthosting.co.za>
Message-ID: <1466028660.12.0.666213688795.issue27327@psf.upfronthosting.co.za>


Ned Deily added the comment:

Thanks for the report!

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

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

From report at bugs.python.org  Thu Jun 16 00:38:10 2016
From: report at bugs.python.org (Jeffrey Esquivel Sibaja)
Date: Thu, 16 Jun 2016 04:38:10 +0000
Subject: [docs] [issue27329] Document behavior when CDLL is called with None
 as an argument on POSIX systems
Message-ID: <1466051890.42.0.656698778102.issue27329@psf.upfronthosting.co.za>


New submission from Jeffrey Esquivel Sibaja:

On POSIX systems, when CDLL is called with None as an argument, it will call the system's dlopen() library function with NULL as it's filename parameter, causing the following behavior (as documented on dlopen's manpage):

"If filename is NULL, then the returned handle is for the main  program.  When given to dlsym(), this handle causes a search for a symbol in the main program, followed by all shared objects loaded at program startup, and then all shared objects loaded by dlopen() with the flag RTLD_GLOBAL."

But right now, this behavior is not explicitly documented anywhere which means users need to read ctypes' source code to find out if this would work.

----------
assignee: docs at python
components: Documentation, ctypes
messages: 268641
nosy: Jeffrey Esquivel Sibaja, docs at python
priority: normal
severity: normal
status: open
title: Document behavior when CDLL is called  with None as an argument on POSIX systems
type: enhancement
versions: Python 2.7, Python 3.5, Python 3.6

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

From report at bugs.python.org  Thu Jun 16 00:48:22 2016
From: report at bugs.python.org (Martin Panter)
Date: Thu, 16 Jun 2016 04:48:22 +0000
Subject: [docs] [issue27329] Document behavior when CDLL is called with None
 as an argument on POSIX systems
In-Reply-To: <1466051890.42.0.656698778102.issue27329@psf.upfronthosting.co.za>
Message-ID: <1466052502.95.0.0114498256519.issue27329@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Jun 16 11:10:33 2016
From: report at bugs.python.org (Xiang Zhang)
Date: Thu, 16 Jun 2016 15:10:33 +0000
Subject: [docs] [issue26985] Information about CodeType in inspect
 documentation is outdated
In-Reply-To: <1462803102.24.0.542356144335.issue26985@psf.upfronthosting.co.za>
Message-ID: <1466089832.98.0.730084188025.issue26985@psf.upfronthosting.co.za>


Xiang Zhang added the comment:

Hmm, when I am going to delete the list in the docstring, I find other functions get lists too in inspect.py. So maybe we should open another issue to clean them after first merging this thread?

----------

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

From report at bugs.python.org  Thu Jun 16 13:35:01 2016
From: report at bugs.python.org (Steven D'Aprano)
Date: Thu, 16 Jun 2016 17:35:01 +0000
Subject: [docs] [issue27335] Clarify that writing to locals() inside a class
 body is supported
Message-ID: <1466098501.84.0.0349098094976.issue27335@psf.upfronthosting.co.za>


New submission from Steven D'Aprano:

The docs for locals() warn not to write to the dict returned, as it may not have the intended effect of modifying the actual variables seen by the interpreter.

https://docs.python.org/3/library/functions.html#locals

But as I understanding it, using locals() inside a class body is intentionally supported:

    class K:
        locals()['x'] = 1
    
    assert K.x == 1

is not just an accident of implementation, but the intended behaviour and a language guarantee.

----------
assignee: docs at python
components: Documentation
messages: 268682
nosy: docs at python, steven.daprano
priority: normal
severity: normal
status: open
title: Clarify that writing to locals() inside a class body is supported
versions: Python 2.7, Python 3.2, Python 3.3, Python 3.4, Python 3.5, Python 3.6

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

From report at bugs.python.org  Thu Jun 16 19:58:05 2016
From: report at bugs.python.org (Martin Panter)
Date: Thu, 16 Jun 2016 23:58:05 +0000
Subject: [docs] [issue27335] Clarify that writing to locals() inside a class
 body is supported
In-Reply-To: <1466098501.84.0.0349098094976.issue27335@psf.upfronthosting.co.za>
Message-ID: <1466121484.94.0.947740707426.issue27335@psf.upfronthosting.co.za>


Martin Panter added the comment:

I think my proposed patch for Issue 17546 addresses this. That patch was also written to address Issue 17960.

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

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

From report at bugs.python.org  Fri Jun 17 00:25:20 2016
From: report at bugs.python.org (Martin Panter)
Date: Fri, 17 Jun 2016 04:25:20 +0000
Subject: [docs] [issue27340] bytes-like objects with socket.sendall(), SSL,
 and http.client
Message-ID: <1466137520.57.0.744540833455.issue27340@psf.upfronthosting.co.za>


New submission from Martin Panter:

According to the documentation, HTTPSConnection.request() should accept arbitrary bytes-like objects, but this is not the case. Currently (since Issue 23756), a ?bytes-like object? is defined to be anything that works with Python?s buffer API, as long as it is C-contiguous. These objects can be passed to socket.sendall():

>>> byteslike = (ctypes.c_ubyte * 6).from_buffer_copy(b"DATA\r\n")
>>> s = socket.create_connection(("localhost", 80))
>>> s.sendall(byteslike)  # Server receives b"DATA\r\n"

This is not explicitly documented for socket objects. But since Issue 23539 (3.4+), HTTPConnection.request() does document support for bytes-like objects:

>>> h = HTTPConnection("localhost", 80)
>>> # Send Content-Length: 6 and body b"DATA\r\n"
>>> h.request("POST", "/", body=byteslike)

On its own, there is no problem with Python relying on its own undocumented behaviour. But Python?s ?ssl? module does not support arbitrary bytes-like objects, and as a result neither does HTTPSConnection:

>>> s = ssl.wrap_socket(socket.create_connection(("localhost", 443)))
>>> s.sendall(byteslike)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "/usr/lib/python3.5/ssl.py", line 886, in sendall
    v = self.send(data[count:])
  File "/usr/lib/python3.5/ssl.py", line 856, in send
    return self._sslobj.write(data)
  File "/usr/lib/python3.5/ssl.py", line 581, in write
    return self._sslobj.write(data)
TypeError: a bytes-like object is required, not 'list'
>>> c = ssl.create_default_context(cafile="/lib/python3.5/test/keycert.pem")
>>> h = HTTPSConnection("localhost", 443, context=c)
>>> h.request("POST", "/", body=byteslike)
Traceback (most recent call last):
  File "/usr/lib/python3.5/http/client.py", line 885, in send
    self.sock.sendall(data)
  File "/usr/lib/python3.5/ssl.py", line 886, in sendall
    v = self.send(data[count:])
  File "/usr/lib/python3.5/ssl.py", line 856, in send
    return self._sslobj.write(data)
  File "/usr/lib/python3.5/ssl.py", line 581, in write
    return self._sslobj.write(data)
TypeError: a bytes-like object is required, not 'list'

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "/usr/lib/python3.5/http/client.py", line 1083, in request
    self._send_request(method, url, body, headers)
  File "/usr/lib/python3.5/http/client.py", line 1128, in _send_request
    self.endheaders(body)
  File "/usr/lib/python3.5/http/client.py", line 1079, in endheaders
    self._send_output(message_body)
  File "/usr/lib/python3.5/http/client.py", line 913, in _send_output
    self.send(message_body)
  File "/usr/lib/python3.5/http/client.py", line 892, in send
    "or an iterable, got %r" % type(data))
TypeError: data should be a bytes-like object or an iterable, got <class '__main__.c_ubyte_Array_6'>

This could be fixed in the implementation of SSLSocket.sendall(). But I am not sure if that is an appropriate change for 3.5. Another option would be to adjust the documentation of HTTP(S)Connection in 3.5, either not mentioning bytes-like objects at all, or clarifying that they don?t work with SSL.

----------
assignee: docs at python
components: Documentation, Library (Lib)
messages: 268707
nosy: docs at python, martin.panter
priority: normal
severity: normal
status: open
title: bytes-like objects with socket.sendall(), SSL, and http.client
versions: Python 3.5, Python 3.6

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

From report at bugs.python.org  Fri Jun 17 01:33:04 2016
From: report at bugs.python.org (Martin Panter)
Date: Fri, 17 Jun 2016 05:33:04 +0000
Subject: [docs] [issue23360] Content-Type when sending data with urlopen()
In-Reply-To: <1422794612.5.0.505084736818.issue23360@psf.upfronthosting.co.za>
Message-ID: <1466141584.19.0.127925795169.issue23360@psf.upfronthosting.co.za>


Martin Panter added the comment:

Fixed conflicts with recent changes

----------
versions: +Python 2.7 -Python 3.4
Added file: http://bugs.python.org/file43428/non-urlencoded.6.patch

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

From report at bugs.python.org  Fri Jun 17 06:50:56 2016
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 17 Jun 2016 10:50:56 +0000
Subject: [docs] [issue23360] Content-Type when sending data with urlopen()
In-Reply-To: <1422794612.5.0.505084736818.issue23360@psf.upfronthosting.co.za>
Message-ID: <1466160656.73.0.0953598438665.issue23360@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Jun 17 07:04:37 2016
From: report at bugs.python.org (Jaysinh shukla)
Date: Fri, 17 Jun 2016 11:04:37 +0000
Subject: [docs] [issue15243] Misleading documentation for __prepare__
In-Reply-To: <1341328118.33.0.670602196671.issue15243@psf.upfronthosting.co.za>
Message-ID: <1466161477.39.0.761178403171.issue15243@psf.upfronthosting.co.za>


Jaysinh shukla added the comment:

Submitting patch according to this (http://bugs.python.org/issue15243#msg268356) message. Thanks!

----------
keywords: +patch
nosy: +jaysinh.shukla
Added file: http://bugs.python.org/file43432/issue15243_diff_python3.5_3.6_v1.diff

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

From pratikkgandhi at gmail.com  Thu Jun 16 18:40:22 2016
From: pratikkgandhi at gmail.com (Pratik Gandhi)
Date: Thu, 16 Jun 2016 18:40:22 -0400
Subject: [docs] Problems with Downloading documentation
Message-ID: <CAFPLr=vo4M+KMRTRn+8fnt=3fLbs4M-y0NREt_7_pCHy2GekEw@mail.gmail.com>

Hello there,

I am trying to download the documentation from python page but I am not
able to. It gives error 404. Is there some other source from where I can
download? Your help will be highly appreciated. Looking forward to hear
back from you!

Best Regards,
-- 
Pratik Gandhi
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160616/32984faa/attachment-0001.html>

From report at bugs.python.org  Fri Jun 17 11:08:46 2016
From: report at bugs.python.org (Daniel Holth)
Date: Fri, 17 Jun 2016 15:08:46 +0000
Subject: [docs] [issue27344] zipfile *does* support utf-8 filenames
Message-ID: <1466176126.21.0.0133629365393.issue27344@psf.upfronthosting.co.za>


New submission from Daniel Holth:

The zipfile documentation says "There is no official file name encoding for ZIP files." However ZIP and zipfile supports utf-8 filenames; this has been true for a long time, at least since Python 2.7.

----------
assignee: docs at python
components: Documentation
messages: 268727
nosy: dholth, docs at python
priority: normal
severity: normal
status: open
title: zipfile *does* support utf-8 filenames
versions: Python 2.7, Python 3.6

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

From wkschwartz at gmail.com  Fri Jun 17 11:58:10 2016
From: wkschwartz at gmail.com (wkschwartz at gmail.com)
Date: Fri, 17 Jun 2016 15:58:10 -0000
Subject: [docs] Misleading documentation for __prepare__ (issue 15243)
Message-ID: <20160617155810.15503.72659@psf.upfronthosting.co.za>

Reviewers: ,

Message:
This looks good and solves my original concern.



Please review this at http://bugs.python.org/review/15243/

Affected files:
  Doc/reference/datamodel.rst


diff -r 7efe1a5239e3 Doc/reference/datamodel.rst
--- a/Doc/reference/datamodel.rst	Fri Jun 17 11:13:03 2016 +0300
+++ b/Doc/reference/datamodel.rst	Fri Jun 17 16:26:41 2016 +0530
@@ -1687,7 +1687,9 @@
 Once the appropriate metaclass has been identified, then the class namespace
 is prepared. If the metaclass has a ``__prepare__`` attribute, it is called
 as ``namespace = metaclass.__prepare__(name, bases, **kwds)`` (where the
-additional keyword arguments, if any, come from the class definition).
+additional keyword arguments, if any, come from the class definition). The
+``__prepare__`` method should be implimented as :func:`classmethod`. Observe
+:ref:`metaclass-example` for demonstration.
 
 If the metaclass has no ``__prepare__`` attribute, then the class namespace
 is initialised as an empty :func:`dict` instance.
@@ -1744,6 +1746,8 @@
       Describes the implicit ``__class__`` closure reference
 
 
+.. _metaclass-example:
+
 Metaclass example
 ^^^^^^^^^^^^^^^^^
 



From report at bugs.python.org  Fri Jun 17 15:11:38 2016
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 17 Jun 2016 19:11:38 +0000
Subject: [docs] [issue27344] zipfile *does* support utf-8 filenames
In-Reply-To: <1466176126.21.0.0133629365393.issue27344@psf.upfronthosting.co.za>
Message-ID: <1466190698.72.0.486984117918.issue27344@psf.upfronthosting.co.za>


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


----------
nosy: +serhiy.storchaka
stage:  -> needs patch
versions: +Python 3.5

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

From burrows at preveil.com  Fri Jun 17 11:28:58 2016
From: burrows at preveil.com (Aaron Burrow)
Date: Fri, 17 Jun 2016 11:28:58 -0400
Subject: [docs] Docs bug for email.message
Message-ID: <CADFg8wXkZ1nFT8FRaReXE24bPX0Rmhgq7gf1Q9SuNSSKeUVaBw@mail.gmail.com>

>From this link,
https://docs.python.org/2/library/email.message.html#email.message.Message.__str__

*__str__*()

  Equivalent to as_string(unixfrom=True).


Looking at the source for the Message class.


class Message:

    def __str__(self):

        """Return the entire formatted message as a string.

        This includes the headers, body, and envelope header.

        """

        return self.as_string()

    def as_string(self, unixfrom=False, maxheaderlen=0):

        """Return the entire formatted message as a string.

        Optional `unixfrom' when True, means include the Unix From_ envelope

        header.


        This is a convenience method and may not generate the message
exactly

        as you intend.  For more flexibility, use the flatten() method of a

        Generator instance.

        """

        from email.generator import Generator

        fp = StringIO()

        g = Generator(fp, mangle_from_=False, maxheaderlen=maxheaderlen)

        g.flatten(self, unixfrom=unixfrom)

        return fp.getvalue()


__str__ is actually equivalent to Message.as_string(unixfrom=False)
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160617/1e5f13f1/attachment.html>

From mvaldeperez at gmail.com  Fri Jun 17 11:58:09 2016
From: mvaldeperez at gmail.com (=?UTF-8?B?TS4gVmFsZGVww6lyZXo=?=)
Date: Fri, 17 Jun 2016 17:58:09 +0200
Subject: [docs] Problems when downloading pdf documentation
Message-ID: <CAMVaMg3VsNVkGjd=LetWR=1ic-UmdSXOfEockH2Q93O3uHQU=g@mail.gmail.com>

Hi,

I am trying to download the python documentation from

https://docs.python.org/2/download.html

but it doesn't work:

[image: Im?genes integradas 1]

Would you mind sending me the pdf file for A4 paper size, please?

Thanks in advance.

Kind regards,



*Magali
Valdep?rez----------------------------------------------------------------------------------*Le
invito a que visite mi perfil en LinkedIn
http://es.linkedin.com/pub/magali-v/45/5a8/574
<http://es.linkedin.com/pub/m-valdep%C3%A9rez/45/5a8/574>
Yoy are invited to visit my LinkedIn profile
http://www.linkedin.com/pub/magali-v%C3%A9rez/45/5a8/574/en
<http://www.linkedin.com/pub/m-valdep%C3%A9rez/45/5a8/574/en>
Je vous invite ? visiter mon profil sur LinkedIn
http://www.linkedin.com/pub/magali-v%C3%A9rez/45/5a8/574/fr
<http://www.linkedin.com/pub/m-valdep%C3%A9rez/45/5a8/574/fr>
*-----------------------------------------------------------------------------------*
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160617/fff70ba5/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image.png
Type: image/png
Size: 21127 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20160617/fff70ba5/attachment-0001.png>

From berker.peksag at gmail.com  Fri Jun 17 15:57:53 2016
From: berker.peksag at gmail.com (=?UTF-8?Q?Berker_Peksa=C4=9F?=)
Date: Fri, 17 Jun 2016 22:57:53 +0300
Subject: [docs] Docs bug for email.message
In-Reply-To: <CADFg8wXkZ1nFT8FRaReXE24bPX0Rmhgq7gf1Q9SuNSSKeUVaBw@mail.gmail.com>
References: <CADFg8wXkZ1nFT8FRaReXE24bPX0Rmhgq7gf1Q9SuNSSKeUVaBw@mail.gmail.com>
Message-ID: <CAF4280+S7eNr-vPK-+ezV_DNHNa=ZhMufLy+m+8TqVhOw4TMrw@mail.gmail.com>

On Fri, Jun 17, 2016 at 6:28 PM, Aaron Burrow <burrows at preveil.com> wrote:
> From this link,
> https://docs.python.org/2/library/email.message.html#email.message.Message.__str__
>
> __str__()
>
>   Equivalent to as_string(unixfrom=True).
>
>
> Looking at the source for the Message class.
>
>
> class Message:
>
>     def __str__(self):
>
>         """Return the entire formatted message as a string.
>
>         This includes the headers, body, and envelope header.
>
>         """
>
>         return self.as_string()
>
>     def as_string(self, unixfrom=False, maxheaderlen=0):
>
>         """Return the entire formatted message as a string.
>
>         Optional `unixfrom' when True, means include the Unix From_ envelope
>
>         header.
>
>
>         This is a convenience method and may not generate the message
> exactly
>
>         as you intend.  For more flexibility, use the flatten() method of a
>
>         Generator instance.
>
>         """
>
>         from email.generator import Generator
>
>         fp = StringIO()
>
>         g = Generator(fp, mangle_from_=False, maxheaderlen=maxheaderlen)
>
>         g.flatten(self, unixfrom=unixfrom)
>
>         return fp.getvalue()
>
>
> __str__ is actually equivalent to Message.as_string(unixfrom=False)

Hi Aaron,

I think you are looking at Python 3 version of the code. The
documentation is correct:
https://hg.python.org/cpython/file/2.7/Lib/email/message.py#l122

--Berker

From report at bugs.python.org  Fri Jun 17 20:22:16 2016
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 18 Jun 2016 00:22:16 +0000
Subject: [docs] [issue27344] zipfile *does* support utf-8 filenames
In-Reply-To: <1466176126.21.0.0133629365393.issue27344@psf.upfronthosting.co.za>
Message-ID: <1466209336.26.0.529988235667.issue27344@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

There is a difference between 'official' and 'supported', and I don't quite know what you mean by the latter.

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

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

From report at bugs.python.org  Sat Jun 18 04:23:15 2016
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 18 Jun 2016 08:23:15 +0000
Subject: [docs] [issue24314] irrelevant cross-link in documentation of
 user-defined functions
In-Reply-To: <1432823234.49.0.975414233418.issue24314@psf.upfronthosting.co.za>
Message-ID: <20160618082311.67155.32637.9D963D5E@psf.io>


Roundup Robot added the comment:

New changeset 1ed4e4a168bb by Martin Panter in branch '2.7':
Issue #24314: Add links for general attributes like __name__, __dict__
https://hg.python.org/cpython/rev/1ed4e4a168bb

New changeset 4c361e189747 by Martin Panter in branch '3.5':
Issue #24314: Fix doc links for general attributes like __name__, __dict__
https://hg.python.org/cpython/rev/4c361e189747

New changeset 79a3aff60e37 by Martin Panter in branch 'default':
Issue #24314: Merge doc links from 3.5
https://hg.python.org/cpython/rev/79a3aff60e37

----------
nosy: +python-dev

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

From report at bugs.python.org  Sat Jun 18 05:04:45 2016
From: report at bugs.python.org (Martin Panter)
Date: Sat, 18 Jun 2016 09:04:45 +0000
Subject: [docs] [issue24314] irrelevant cross-link in documentation of
 user-defined functions
In-Reply-To: <1432823234.49.0.975414233418.issue24314@psf.upfronthosting.co.za>
Message-ID: <1466240684.97.0.316255004412.issue24314@psf.upfronthosting.co.za>


Martin Panter added the comment:

I also backported most of my changes to 2.7, although __name__ wasn?t originally linking to anything at all there.

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

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

From report at bugs.python.org  Sat Jun 18 05:40:42 2016
From: report at bugs.python.org (=?utf-8?b?0JzQsNGA0Log0JrQvtGA0LXQvdCx0LXRgNCz?=)
Date: Sat, 18 Jun 2016 09:40:42 +0000
Subject: [docs] [issue27021] It is not documented that os.writev() suffer
 from SC_IOV_MAX
In-Reply-To: <1463247246.11.0.121733863987.issue27021@psf.upfronthosting.co.za>
Message-ID: <1466242842.28.0.263952166297.issue27021@psf.upfronthosting.co.za>


???? ????????? added the comment:

Also it is not documented that os.writev() is not awailable on Windows (!)
Also see issue27346

----------

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

From report at bugs.python.org  Sat Jun 18 05:45:11 2016
From: report at bugs.python.org (=?utf-8?b?0JzQsNGA0Log0JrQvtGA0LXQvdCx0LXRgNCz?=)
Date: Sat, 18 Jun 2016 09:45:11 +0000
Subject: [docs] [issue27021] It is not documented that os.writev() suffer
 from SC_IOV_MAX
In-Reply-To: <1463247246.11.0.121733863987.issue27021@psf.upfronthosting.co.za>
Message-ID: <1466243111.01.0.115870914822.issue27021@psf.upfronthosting.co.za>


???? ????????? added the comment:

Oops. It is documented in latest version...

----------

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

From report at bugs.python.org  Sat Jun 18 05:54:18 2016
From: report at bugs.python.org (=?utf-8?b?0JzQsNGA0Log0JrQvtGA0LXQvdCx0LXRgNCz?=)
Date: Sat, 18 Jun 2016 09:54:18 +0000
Subject: [docs] [issue27021] It is not documented that os.writev() suffer
 from SC_IOV_MAX
In-Reply-To: <1463247246.11.0.121733863987.issue27021@psf.upfronthosting.co.za>
Message-ID: <1466243658.34.0.776924859076.issue27021@psf.upfronthosting.co.za>


???? ????????? added the comment:

Attached the patch. Please review.

----------
keywords: +patch
Added file: http://bugs.python.org/file43449/writev_doc.patch

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

From dbarts at pagedna.com  Fri Jun 17 16:49:10 2016
From: dbarts at pagedna.com (David Barts)
Date: Fri, 17 Jun 2016 13:49:10 -0700
Subject: [docs] Python documentation bug
Message-ID: <4cce0b9a-c1d4-f242-6543-bd9e2304ead1@pagedna.com>

This is definitely a documentation bug and it may point to a need for a 
new feature for subprocess.Popen objects as well.

Both the 2.x and 3.x library documentation online claims, in the section 
on the subprocess module:

> P_NOWAIT example:
>
> pid = os.spawnlp(os.P_NOWAIT, "/bin/mycmd", "mycmd", "myarg")
> ==>
> pid = Popen(["/bin/mycmd", "myarg"]).pid
This is not the case. The reason is that subprocess.Popen objects 
contain a __del__ method which causes exited processes to be 
gratuitously reaped at GC time. The recommended replacement code will 
immediately create an unrefed Popen object, setting in motion a race 
condition: which will run first after the process exits, Python's GC or 
the user code that calls os.wait()?

The __del__ method which does such reaping (arguably the correct 
behavior for the cases where the Popen objects are saved and used to 
subsequently manage the subprocess, something not the case in the above 
example) is still present in both the 2.7.12rc1 and 3.6.0a2 versions of 
the Python library.

To allow the subprocess module to be a true drop-in replacement for the 
os.spawn family, maybe a new feature (call it "noreap" or something 
similar) should to be added to the Popen constructor?

This one just bit me. Thankfully, I had been worried about the 
replacement code (which had occurred to me independently of the manual) 
working properly until I saw it in the Python manual and decided to use 
it given that endorsement, so the cause was fresh in my mind when my 
program started mysteriously "losing" its children.

--
David Barts
PageDNA, Inc.
Seattle, WA
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160617/c4c6e11f/attachment.html>

From fullmooon13 at gmail.com  Sat Jun 18 11:53:37 2016
From: fullmooon13 at gmail.com (bader alhashmi)
Date: Sat, 18 Jun 2016 19:53:37 +0400
Subject: [docs] docs cant be downloaded
Message-ID: <CAPjQBZYU7CsuHVAuS95Y01ZkpRE4jS_cYi2Pk18WrkrMD_hz=Q@mail.gmail.com>

Hello dear,

I'm a programmer and I am trying to download a version of your docs but
unfortunately I get 404 error. Could you please fix your links.

I used to find a local version on my machine (ubuntu) pre-downloaded but I
can't find the path of the docs!

Best regards,
Bader Nasser
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160618/aaf0d088/attachment.html>

From kenbloom at unl.edu  Fri Jun 17 16:37:38 2016
From: kenbloom at unl.edu (Ken Bloom)
Date: Fri, 17 Jun 2016 20:37:38 +0000
Subject: [docs] document archives do not download
Message-ID: <C3CE982D-9762-48F0-927A-ACA17E42216C@unl.edu>

Dear Python,

I tried to download some documentation from 

https://docs.python.org/2.7/download.html

but all of the links appear to be broken, as I get a ?404 Not Found?. Thanks, best wishes.

Ken Bloom


From phil.d.howard at gmail.com  Fri Jun 17 22:17:40 2016
From: phil.d.howard at gmail.com (Phil Howard)
Date: Fri, 17 Jun 2016 22:17:40 -0400
Subject: [docs] 404 error on 2.7.12rc1 docs
Message-ID: <CAA_-VDLL1F_SNeG=yekcCbmTKZmx00Sf_tZao0gkbwZ_jWantQ@mail.gmail.com>

on page https://docs.python.org/2/download.html all the URLs for .zip and
.tar.bz2 documentation archives are failing with a 404 error. these are for
2.7.12rc1.  2.7.11 works ok.

-- 
Phil Howard, KA9WGN
phil.d.howard at gmail.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160617/3b96cadf/attachment.html>

From report at bugs.python.org  Sat Jun 18 14:23:12 2016
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 18 Jun 2016 18:23:12 +0000
Subject: [docs] [issue27021] It is not documented that os.writev() suffer
 from SC_IOV_MAX
In-Reply-To: <1463247246.11.0.121733863987.issue27021@psf.upfronthosting.co.za>
Message-ID: <20160618182309.11596.79824.05150187@psf.io>


Roundup Robot added the comment:

New changeset eddbf14f451b by Senthil Kumaran in branch '3.5':
issue27021 - Document SC_IOV_MAX limitation imposed by OS on os.writev.
https://hg.python.org/cpython/rev/eddbf14f451b

New changeset 0b1cd695e7aa by Senthil Kumaran in branch 'default':
[merge from 3.5] - issue27021 - Document SC_IOV_MAX limitation imposed by OS on os.writev.
https://hg.python.org/cpython/rev/0b1cd695e7aa

----------
nosy: +python-dev

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

From report at bugs.python.org  Sat Jun 18 14:23:59 2016
From: report at bugs.python.org (Senthil Kumaran)
Date: Sat, 18 Jun 2016 18:23:59 +0000
Subject: [docs] [issue27021] It is not documented that os.writev() suffer
 from SC_IOV_MAX
In-Reply-To: <1463247246.11.0.121733863987.issue27021@psf.upfronthosting.co.za>
Message-ID: <1466274239.92.0.828071878921.issue27021@psf.upfronthosting.co.za>


Senthil Kumaran added the comment:

????, it's documented now. Thank you for the patch.

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

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

From p_derockere at hotmail.com  Sun Jun 19 05:10:53 2016
From: p_derockere at hotmail.com (Pieter De Rockere)
Date: Sun, 19 Jun 2016 09:10:53 +0000
Subject: [docs] Documentation
Message-ID: <VI1PR03MB11522406B7B7B22C3A527AF186290@VI1PR03MB1152.eurprd03.prod.outlook.com>

Hello,

Your documentation is not available on your site!
Please help.

Greetings,

Pieter

Not: I am interesting in Python.

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

From report at bugs.python.org  Sun Jun 19 18:34:37 2016
From: report at bugs.python.org (dg1727)
Date: Sun, 19 Jun 2016 22:34:37 +0000
Subject: [docs] [issue14191] argparse doesn't allow optionals within
 positionals
In-Reply-To: <1330843053.88.0.983162018395.issue14191@psf.upfronthosting.co.za>
Message-ID: <1466375677.14.0.0242192785731.issue14191@psf.upfronthosting.co.za>


Changes by dg1727 <dg1727 at hushmail.com>:


----------
nosy: +dg1727

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

From 1017041959 at qq.com  Sun Jun 19 23:09:09 2016
From: 1017041959 at qq.com (GainSky)
Date: Mon, 20 Jun 2016 11:09:09 +0800
Subject: [docs] The docs for 2.7 when i wanna to download them will be 404
Message-ID: <57675E55.9040906@qq.com>

Yes, you 
know:https://docs.python.org/2.7/archives/python-2.7.12rc1-docs-pdf-a4.tar.bz2


  404 Not Found

------------------------------------------------------------------------
nginx


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160620/5fb832f5/attachment.html>

From report at bugs.python.org  Mon Jun 20 22:10:31 2016
From: report at bugs.python.org (Martin Panter)
Date: Tue, 21 Jun 2016 02:10:31 +0000
Subject: [docs] [issue12833] Document the need to pass the prompt to
 raw_input() with readline
In-Reply-To: <1314205212.4.0.313319940132.issue12833@psf.upfronthosting.co.za>
Message-ID: <1466475031.09.0.622527107953.issue12833@psf.upfronthosting.co.za>


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


----------
stage: patch review -> needs patch
title: raw_input misbehaves when readline is imported -> Document the need to pass the prompt to raw_input() with readline
versions:  -Python 3.4

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

From report at bugs.python.org  Tue Jun 21 01:52:48 2016
From: report at bugs.python.org (Martin Panter)
Date: Tue, 21 Jun 2016 05:52:48 +0000
Subject: [docs] [issue10415] readline.insert_text documentation incomplete
In-Reply-To: <1289718734.94.0.0887962692453.issue10415@psf.upfronthosting.co.za>
Message-ID: <1466488368.08.0.378519919803.issue10415@psf.upfronthosting.co.za>


Martin Panter added the comment:

In Issue 6953, I updated the documentation to indicate which underlying Readline functions etc are accessed. So perhaps that helps, so the reader knows what function to look up in the Readline documentation.

Other than that, I?m not sure what else to do. It would be more helpful to suggest an improvement, rather than just quoting the existing documentation back.

----------
nosy: +martin.panter
stage:  -> needs patch
status: open -> pending

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

From report at bugs.python.org  Tue Jun 21 06:14:40 2016
From: report at bugs.python.org (Steve Piercy)
Date: Tue, 21 Jun 2016 10:14:40 +0000
Subject: [docs] [issue27285] Document the deprecation of pyvenv in favor of
 `python3 -m venv`
In-Reply-To: <1465544944.16.0.549761687921.issue27285@psf.upfronthosting.co.za>
Message-ID: <1466504080.83.0.992014343371.issue27285@psf.upfronthosting.co.za>


Steve Piercy added the comment:

I'd like to take on this issue and submit a patch for consideration by 2016-06-26.  Please let me know if anyone is working on it.

----------

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

From devldavydov at yandex.ru  Mon Jun 20 17:25:51 2016
From: devldavydov at yandex.ru (=?utf-8?B?0JTQtdC90LjRgSDQlNCw0LLRi9C00L7Qsg==?=)
Date: Tue, 21 Jun 2016 00:25:51 +0300
Subject: [docs] Python 2.7 docs download
Message-ID: <427351466457951@web23g.yandex.ru>

An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160621/30492b90/attachment.html>

From johnwclow at hotmail.com  Mon Jun 20 21:40:06 2016
From: johnwclow at hotmail.com (John Clow)
Date: Mon, 20 Jun 2016 18:40:06 -0700
Subject: [docs] 2.7.12 docs not found
Message-ID: <BAY402-EAS19F57FB7EEFA4EA716D3AEAC2B0@phx.gbl>

Dear Docs Support,

When clicking on the links (eg the HTML .zip link) in Chrome in the page linked below, I received a 404 from nginx.

https://docs.python.org/2.7/download.html 

Yours,
John Clow

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160620/014489e9/attachment.html>

From r.care at reply.it  Mon Jun 20 19:10:05 2016
From: r.care at reply.it (=?iso-8859-1?Q?Car=E8_Riccardo?=)
Date: Mon, 20 Jun 2016 23:10:05 +0000
Subject: [docs] Unable to download python documentation
Message-ID: <276C4E8890C09B49B6C92D9BCAAE10C91D9057E6@CED01MBXS07.replynet.prv>

Hello,

I tried to download all the archives at this page https://docs.python.org/2/download.html but the server gives error 404.
Maybe the resources were moved and the page is still referencing the old position?
Thank you very much in advance.

Best regards,
Riccardo



Riccardo Car?

Data Reply
Via Castellanza, 11
20151 - Milano - ITALY
phone: +39 02 535761
r.care at reply.it<mailto:r.care at reply.it>
www.reply.it

[Data Reply]

________________________________

--
The information transmitted is intended for the person or entity to which it is addressed and may contain confidential and/or privileged material. Any review, retransmission, dissemination or other use of, or taking of any action in reliance upon, this information by persons or entities other than the intended recipient is prohibited. If you received this in error, please contact the sender and delete the material from any computer.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160620/060cb806/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: data.png
Type: image/png
Size: 1681 bytes
Desc: data.png
URL: <http://mail.python.org/pipermail/docs/attachments/20160620/060cb806/attachment-0001.png>

From sergei3000 at inbox.ru  Tue Jun 21 03:55:31 2016
From: sergei3000 at inbox.ru (=?UTF-8?B?U2VyZ2V5?=)
Date: Tue, 21 Jun 2016 10:55:31 +0300
Subject: [docs] =?utf-8?q?Error_on_the_documentation_page?=
Message-ID: <1466495731.939933855@f65.i.mail.ru>

 Hi!

There seems to be some problem at this page:
https://docs.python.org/2/download.html ?
When I click the download links, I get error 404.



-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160621/17e3addf/attachment.html>

From villaa at carleton.edu  Mon Jun 20 14:02:06 2016
From: villaa at carleton.edu (Angel Villa)
Date: Mon, 20 Jun 2016 14:02:06 -0400 (EDT)
Subject: [docs] Python 2 PDF Documentation
In-Reply-To: <2080013522.17603952.1466445642265.JavaMail.zimbra@carleton.edu>
Message-ID: <890049422.17605397.1466445726653.JavaMail.zimbra@carleton.edu>

Hi,

Is there a way I can get a US letter size PDF and a plain text version of the Python 2.7 documentation? 

I tried the link (https://docs.python.org/2/download.html) but the download links lead to a 404.

Thanks
Angel

From report at bugs.python.org  Tue Jun 21 11:41:29 2016
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 21 Jun 2016 15:41:29 +0000
Subject: [docs] [issue27285] Document the deprecation of pyvenv in favor of
 `python3 -m venv`
In-Reply-To: <1465544944.16.0.549761687921.issue27285@psf.upfronthosting.co.za>
Message-ID: <1466523689.7.0.667827046996.issue27285@psf.upfronthosting.co.za>


Brett Cannon added the comment:

No one is working on it, Steve, so feel free to write a patch.

----------

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

From report at bugs.python.org  Tue Jun 21 20:24:24 2016
From: report at bugs.python.org (R. David Murray)
Date: Wed, 22 Jun 2016 00:24:24 +0000
Subject: [docs] [issue27344] zipfile *does* support utf-8 filenames
In-Reply-To: <1466176126.21.0.0133629365393.issue27344@psf.upfronthosting.co.za>
Message-ID: <1466555060.8.0.858742972459.issue27344@psf.upfronthosting.co.za>


R. David Murray added the comment:

See issue 10614 for the current state of play.  This issue should probably be closed in favor of that one.

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

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

From report at bugs.python.org  Tue Jun 21 22:50:33 2016
From: report at bugs.python.org (Daniel Holth)
Date: Wed, 22 Jun 2016 02:50:33 +0000
Subject: [docs] [issue27344] zipfile *does* support utf-8 filenames
In-Reply-To: <1466176126.21.0.0133629365393.issue27344@psf.upfronthosting.co.za>
Message-ID: <1466563833.53.0.92259532849.issue27344@psf.upfronthosting.co.za>


Daniel Holth added the comment:

This is a simple documentation bug about the ZIP file format supporting utf-8 and 'no encoding' filenames depending on whether two bits are set in a flag inside the archive member. Bug 10614 appears to be a different issue about out-of-band encoding information that you could pass to Python's zipfile implementation.

----------

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

From mandrecphd at gmail.com  Tue Jun 21 22:39:54 2016
From: mandrecphd at gmail.com (M Andrec)
Date: Tue, 21 Jun 2016 22:39:54 -0400
Subject: [docs] broken documentation links
Message-ID: <CAC0b_ZtEP1bXw3VpS1cQZbQhfXTpTVab=r02fSVK_pVyQheMog@mail.gmail.com>

Why are all of the download links on https://docs.python.org/2/download.html
returning a 404 error?


m


-- 
Michael Andrec, Ph.D.



*Interdisciplinary Computational Science and Statistics ConsultantWeb
WorkerCertified Archivist*
http://www.linkedin.com/in/michaelandrec
732-659-0705
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160621/362bb725/attachment.html>

From bbayles at gmail.com  Tue Jun 21 23:41:21 2016
From: bbayles at gmail.com (Bo Bayles)
Date: Tue, 21 Jun 2016 22:41:21 -0500
Subject: [docs] Mistake in urllib.parse docs
Message-ID: <CALqAb4yHE=UV7mia72g83wsa=Lr9Um-To3mzGbCxLWQBFkTo4A@mail.gmail.com>

The Python 2.7 docs have this example for urljoin:

>>> urljoin('https://www.cwi.nl/%7Eguido/Python.html',
...         '//www.python.org/%7Eguido')
'http://www.python.org/%7Eguido'


This is incorrect; the result is actually
'https://www.python.org/%7Eguido' - notice https instead of http. This
behavior is what the Note in which the example appears is trying to
explain, so the mistake is worse than it might otherwise be.

The Python 3.6 docs get this right, so they shouldn't need to be
updated in the same way.

Many thanks!
-Bo

From mkmishra1997 at gmail.com  Wed Jun 22 03:21:59 2016
From: mkmishra1997 at gmail.com (Manish Kumar Mishra)
Date: Wed, 22 Jun 2016 12:51:59 +0530
Subject: [docs] (no subject)
Message-ID: <CAGH_1SifvonOpda8VYX3xBazdNz5dS3bWVwttci40LxthTOeNA@mail.gmail.com>

Sir/Madam

The documentation pdf links provided in the website at
https://docs.python.org/2/download.html return "Error 404". Please fix the
issue.

-- 
Regards,
Manish Kumar Mishra
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160622/5ad56e5c/attachment.html>

From senthil at uthcode.com  Wed Jun 22 03:58:02 2016
From: senthil at uthcode.com (Senthil Kumaran)
Date: Wed, 22 Jun 2016 00:58:02 -0700
Subject: [docs] Mistake in urllib.parse docs
In-Reply-To: <CALqAb4yHE=UV7mia72g83wsa=Lr9Um-To3mzGbCxLWQBFkTo4A@mail.gmail.com>
References: <CALqAb4yHE=UV7mia72g83wsa=Lr9Um-To3mzGbCxLWQBFkTo4A@mail.gmail.com>
Message-ID: <CAPOVWOQDiRV7rDGmHD1GuwGbTHskPrJWGE5GSuOqdMPPqfDC2A@mail.gmail.com>

On Tue, Jun 21, 2016 at 8:41 PM, Bo Bayles <bbayles at gmail.com> wrote:

> This is incorrect; the result is actually
> 'https://www.python.org/%7Eguido' - notice https instead of http.
>

This is fixed in https://hg.python.org/cpython/rev/5cecd68851e8
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160622/405679e7/attachment.html>

From report at bugs.python.org  Wed Jun 22 14:29:00 2016
From: report at bugs.python.org (Andrew Cameron)
Date: Wed, 22 Jun 2016 18:29:00 +0000
Subject: [docs] [issue27370] Inconsistency in docs for list.extend
Message-ID: <1466620140.79.0.360465596161.issue27370@psf.upfronthosting.co.za>


New submission from Andrew Cameron:

The documentation for Mutable Sequence Types states that, for operation:
s.extend(x) or s += t

the expected result is:
for the most part the same as s[len(s):len(s)] = x

Note that if you perform operation 's += t' the result is not the same as 's[len(s):len(s)] = x' unless 't == x'.

This does not occur with the Python 3 docs, which uses exclusively 't' (not 'x'). However for people reading the Python 2 docs the variable mix-up could cause confusion.

----------
assignee: docs at python
components: Documentation
messages: 269080
nosy: Andrew Cameron, docs at python
priority: normal
severity: normal
status: open
title: Inconsistency in docs for list.extend
versions: Python 2.7

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

From report at bugs.python.org  Wed Jun 22 19:59:52 2016
From: report at bugs.python.org (Terry J. Reedy)
Date: Wed, 22 Jun 2016 23:59:52 +0000
Subject: [docs] [issue27304] Create "Source Code" links in module sections,
 where relevant
In-Reply-To: <1465791283.3.0.647535904935.issue27304@psf.upfronthosting.co.za>
Message-ID: <1466639992.3.0.757681062527.issue27304@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

Looks good at first review on Rietveld.  Will test next.

----------

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

From report at bugs.python.org  Wed Jun 22 20:57:58 2016
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 23 Jun 2016 00:57:58 +0000
Subject: [docs] [issue27370] Inconsistency in docs for list.extend
In-Reply-To: <1466620140.79.0.360465596161.issue27370@psf.upfronthosting.co.za>
Message-ID: <20160623005753.22331.98638.6326877C@psf.io>


Roundup Robot added the comment:

New changeset c91007ab3fda by Martin Panter in branch '2.7':
Issue #27370: Use t for an iterable in mutable sequence ops
https://hg.python.org/cpython/rev/c91007ab3fda

----------
nosy: +python-dev

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

From report at bugs.python.org  Wed Jun 22 21:11:07 2016
From: report at bugs.python.org (Martin Panter)
Date: Thu, 23 Jun 2016 01:11:07 +0000
Subject: [docs] [issue27370] Inconsistency in docs for list.extend
In-Reply-To: <1466620140.79.0.360465596161.issue27370@psf.upfronthosting.co.za>
Message-ID: <1466644267.56.0.459041650643.issue27370@psf.upfronthosting.co.za>


Martin Panter added the comment:

The t vs x mixup was introduced by my sloppy backport in Issue 16701. The other problem here is x is generally defined as any arbitrary object, but redefined as an iterable in the footnote. I think we should use t instead, as in the other two slice assignment operations and in Python 3. My commit should have fixed both these problems.

----------
nosy: +martin.panter
resolution:  -> fixed
stage:  -> resolved
status: open -> closed

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

From report at bugs.python.org  Wed Jun 22 22:47:16 2016
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 23 Jun 2016 02:47:16 +0000
Subject: [docs] [issue27304] Create "Source Code" links in module sections,
 where relevant
In-Reply-To: <1465791283.3.0.647535904935.issue27304@psf.upfronthosting.co.za>
Message-ID: <20160623024713.657.65257.9783C8A4@psf.io>


Roundup Robot added the comment:

New changeset e3b4033e0ea7 by Terry Jan Reedy in branch '3.5':
Issue #27304: Source code links for sub-packages in the same file.
https://hg.python.org/cpython/rev/e3b4033e0ea7

----------
nosy: +python-dev

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

From report at bugs.python.org  Wed Jun 22 22:55:14 2016
From: report at bugs.python.org (Terry J. Reedy)
Date: Thu, 23 Jun 2016 02:55:14 +0000
Subject: [docs] [issue27304] Create "Source Code" links in module sections,
 where relevant
In-Reply-To: <1465791283.3.0.647535904935.issue27304@psf.upfronthosting.co.za>
Message-ID: <1466650514.16.0.500950108195.issue27304@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

Three of the links are to one- or two- line modules that import the C implementation.  I considered dropping them, but decided that the only way to know that they are not worth looking at is to let someone take a look.  A counter argument is that we don't have links to CPython C implementations, and we could pretend that the Python wrappers are not there. Another core developer who feels strongly enough can remove the three.

Thanks for the nice patch.  I hope you do some more.

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

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

From report at bugs.python.org  Wed Jun 22 23:30:24 2016
From: report at bugs.python.org (Berker Peksag)
Date: Thu, 23 Jun 2016 03:30:24 +0000
Subject: [docs] [issue26547] Undocumented use of the term dictproxy in
 vars() documentation
In-Reply-To: <1457821404.83.0.465984707802.issue26547@psf.upfronthosting.co.za>
Message-ID: <1466652624.57.0.559773463643.issue26547@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Jun 23 11:24:39 2016
From: report at bugs.python.org (R. David Murray)
Date: Thu, 23 Jun 2016 15:24:39 +0000
Subject: [docs] [issue27344] zipfile *does* support utf-8 filenames
In-Reply-To: <1466176126.21.0.0133629365393.issue27344@psf.upfronthosting.co.za>
Message-ID: <1466695479.82.0.206684229247.issue27344@psf.upfronthosting.co.za>


R. David Murray added the comment:

OK, what do you propose as a documentation change?  The current doc is accurate, but incomplete.  New phrasing could include something about the two de-facto standards but that one can not be sure that filenames will be in one of those two encodings.  Issue 10614 addresses the fact that the zipfile module doesn't make it easy to specify the encoding of filenames when creating an archive, IIUC, which also still needs to be addressed in any documentation change.

----------

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

From report at bugs.python.org  Thu Jun 23 11:46:24 2016
From: report at bugs.python.org (Daniel Holth)
Date: Thu, 23 Jun 2016 15:46:24 +0000
Subject: [docs] [issue27344] zipfile *does* support utf-8 filenames
In-Reply-To: <1466176126.21.0.0133629365393.issue27344@psf.upfronthosting.co.za>
Message-ID: <1466696784.31.0.0667812978991.issue27344@psf.upfronthosting.co.za>


Daniel Holth added the comment:

The current documentation says "Note There is no official file name encoding for ZIP files. If you have unicode file names, you must convert them to byte strings in your desired encoding before passing them to write(). WinZip interprets all file names as encoded in CP437, also known as DOS Latin."

This is bad advice because if you convert the filenames to bytes before passing them to zipfile, it won't remember that they should be unicode. Instead it should say

"The ZIP file format supports Unicode filenames. If you have unicode filenames, zipfile will encode them to and from utf-8 internally. If you pass bytes filenames to write() then they will be stored without a specified encoding."

I am not sure what current versions of WinZip or Windows file manager do.

----------

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

From report at bugs.python.org  Thu Jun 23 11:47:30 2016
From: report at bugs.python.org (Daniel Holth)
Date: Thu, 23 Jun 2016 15:47:30 +0000
Subject: [docs] [issue27344] zipfile *does* support utf-8 filenames
In-Reply-To: <1466176126.21.0.0133629365393.issue27344@psf.upfronthosting.co.za>
Message-ID: <1466696849.98.0.303922499992.issue27344@psf.upfronthosting.co.za>


Daniel Holth added the comment:

" ... zipfile will encode them to and from utf-8 internally, and the encoding is marked in a standard flag inside the archive member."

----------

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

From report at bugs.python.org  Thu Jun 23 12:08:32 2016
From: report at bugs.python.org (Daniel Holth)
Date: Thu, 23 Jun 2016 16:08:32 +0000
Subject: [docs] [issue27344] zipfile *does* support utf-8 filenames
In-Reply-To: <1466176126.21.0.0133629365393.issue27344@psf.upfronthosting.co.za>
Message-ID: <1466698112.8.0.958381304649.issue27344@psf.upfronthosting.co.za>


Daniel Holth added the comment:

The documentation should read

The ZIP file format supports Unicode filenames. If you have unicode filenames, zipfile will encode them to and from utf-8 internally, but if you pass bytes filenames to write() then they will be stored without a specified encoding.

Even though the format itself supports Unicode, historically Windows' built-in ZIP utility has interpreted all ZIP filenames as CP437 also known as DOS Latin. There is a fix from Microsoft for Windows 7 available here: https://support.microsoft.com/en-us/kb/2704299

----------

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

From report at bugs.python.org  Thu Jun 23 13:03:02 2016
From: report at bugs.python.org (Jaysinh shukla)
Date: Thu, 23 Jun 2016 17:03:02 +0000
Subject: [docs] [issue20842] pkgutil docs should reference glossary terms
 not PEP 302
In-Reply-To: <1393846400.67.0.723549613222.issue20842@psf.upfronthosting.co.za>
Message-ID: <1466701382.45.0.604751170527.issue20842@psf.upfronthosting.co.za>


Jaysinh shukla added the comment:

Submitting the patch for this issue. I observed the last message of respected Kushal but because the message was posted too earlier decided to submit patch. Thanks!

----------
keywords: +patch
nosy: +jaysinh.shukla
Added file: http://bugs.python.org/file43521/issue20842_v1.diff

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

From report at bugs.python.org  Thu Jun 23 15:58:17 2016
From: report at bugs.python.org (Matt Morrison)
Date: Thu, 23 Jun 2016 19:58:17 +0000
Subject: [docs] [issue27378] remove ref to Phil Schwartz's 'Kodos' in regex
 HOWTO
Message-ID: <1466711896.95.0.020858113879.issue27378@psf.upfronthosting.co.za>


New submission from Matt Morrison:

In the Regular Expressions HOWTO (https://docs.python.org/3/howto/regex.html#performing-matches, Doc/howto/regex.rst), there is the following paragraph:

=====
You can learn about this by interactively experimenting with the :mod:`re`
module.  If you have :mod:`tkinter` available, you may also want to look at
:source:`Tools/demo/redemo.py`, a demonstration program included with the
Python distribution.  It allows you to enter REs and strings, and displays
whether the RE matches or fails. :file:`redemo.py` can be quite useful when
trying to debug a complicated RE.  Phil Schwartz's `Kodos
<http://kodos.sourceforge.net/>`_ is also an interactive tool for developing and
testing RE patterns.
=====

I checked the Kodos site on SourceForge, and the latest release is exactly 10 years old. I couldn't get it to work with 2.7.11 on Ubuntu 16.04 and PyQt4 - Qt3 is one of its requirements. I didn't bother running 2to3 on it. I propose we delete the last sentence of the above paragraph altogether. There are many good regex sites out there, including regex101, regexr, Debuggex, regexpal, and more (those are just the first few in my bookmarks list), and I don't feel we should be promoting one outdated tool.

Here is the diff:
=====
@@ -374,9 +374,7 @@
 :source:`Tools/demo/redemo.py`, a demonstration program included with the
 Python distribution.  It allows you to enter REs and strings, and displays
 whether the RE matches or fails. :file:`redemo.py` can be quite useful when
-trying to debug a complicated RE.  Phil Schwartz's `Kodos
-<http://kodos.sourceforge.net/>`_ is also an interactive tool for developing and
-testing RE patterns.
+trying to debug a complicated RE.

 This HOWTO uses the standard Python interpreter for its examples. First, run the
 Python interpreter, import the :mod:`re` module, and compile a RE::

=====

I've also attached it as a file.

----------
assignee: docs at python
components: Documentation
files: regex.diff
keywords: patch
messages: 269142
nosy: MattDMo, docs at python
priority: normal
severity: normal
status: open
title: remove ref to Phil Schwartz's 'Kodos' in regex HOWTO
type: enhancement
versions: Python 2.7, Python 3.2, Python 3.3, Python 3.4, Python 3.5, Python 3.6
Added file: http://bugs.python.org/file43525/regex.diff

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

From vadmium+py at gmail.com  Thu Jun 23 22:43:08 2016
From: vadmium+py at gmail.com (vadmium+py at gmail.com)
Date: Fri, 24 Jun 2016 02:43:08 -0000
Subject: [docs] pkgutil docs should reference glossary terms not PEP 302
 (issue 20842)
Message-ID: <20160624024308.13342.85458@psf.upfronthosting.co.za>


https://bugs.python.org/review/20842/diff/17723/Doc/library/pkgutil.rst
File Doc/library/pkgutil.rst (right):

https://bugs.python.org/review/20842/diff/17723/Doc/library/pkgutil.rst#newcode49
Doc/library/pkgutil.rst:49: :term:`importer` that wraps Python's
"classic" import algorithm.
Please start paragraphs and sentences with capital letters

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

From report at bugs.python.org  Thu Jun 23 22:43:21 2016
From: report at bugs.python.org (Martin Panter)
Date: Fri, 24 Jun 2016 02:43:21 +0000
Subject: [docs] [issue20842] pkgutil docs should reference glossary terms
 not PEP 302
In-Reply-To: <1393846400.67.0.723549613222.issue20842@psf.upfronthosting.co.za>
Message-ID: <1466736201.0.0.410024922796.issue20842@psf.upfronthosting.co.za>


Martin Panter added the comment:

See also Issue 26896. Apparently some of the terms you are linking are used wrongly.

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

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

From report at bugs.python.org  Fri Jun 24 01:53:51 2016
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 24 Jun 2016 05:53:51 +0000
Subject: [docs] [issue27378] remove ref to Phil Schwartz's 'Kodos' in regex
 HOWTO
In-Reply-To: <1466711896.95.0.020858113879.issue27378@psf.upfronthosting.co.za>
Message-ID: <20160624055347.102344.1289.29018AC8@psf.io>


Roundup Robot added the comment:

New changeset 23182404a85c by Berker Peksag in branch '3.5':
Issue #27378: Remove an outdated reference from regex HOWTO
https://hg.python.org/cpython/rev/23182404a85c

New changeset 21cb299a9626 by Berker Peksag in branch 'default':
Issue #27378: Merge from 3.5
https://hg.python.org/cpython/rev/21cb299a9626

----------
nosy: +python-dev

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

From report at bugs.python.org  Fri Jun 24 01:54:16 2016
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 24 Jun 2016 05:54:16 +0000
Subject: [docs] [issue27378] remove ref to Phil Schwartz's 'Kodos' in regex
 HOWTO
In-Reply-To: <1466711896.95.0.020858113879.issue27378@psf.upfronthosting.co.za>
Message-ID: <1466747656.19.0.0879268439981.issue27378@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Thanks!

----------
nosy: +berker.peksag
resolution:  -> fixed
stage:  -> resolved
status: open -> closed
versions:  -Python 2.7, Python 3.2, Python 3.3, Python 3.4

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

From report at bugs.python.org  Fri Jun 24 02:11:04 2016
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 24 Jun 2016 06:11:04 +0000
Subject: [docs] [issue26547] Undocumented use of the term dictproxy in
 vars() documentation
In-Reply-To: <1457821404.83.0.465984707802.issue26547@psf.upfronthosting.co.za>
Message-ID: <20160624061101.102161.93373.0CCDD853@psf.io>


Roundup Robot added the comment:

New changeset 79e4593ce746 by Berker Peksag in branch '3.5':
Issue #26547: Remove outdated term dictproxy from vars() documentation
https://hg.python.org/cpython/rev/79e4593ce746

New changeset 45544b868f7b by Berker Peksag in branch 'default':
Issue #26547: Merge from 3.5
https://hg.python.org/cpython/rev/45544b868f7b

----------
nosy: +python-dev

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

From report at bugs.python.org  Fri Jun 24 02:11:39 2016
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 24 Jun 2016 06:11:39 +0000
Subject: [docs] [issue26547] Undocumented use of the term dictproxy in
 vars() documentation
In-Reply-To: <1457821404.83.0.465984707802.issue26547@psf.upfronthosting.co.za>
Message-ID: <1466748699.11.0.854029918478.issue26547@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Thanks, Julien.

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

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

From report at bugs.python.org  Fri Jun 24 05:38:13 2016
From: report at bugs.python.org (Xiang Zhang)
Date: Fri, 24 Jun 2016 09:38:13 +0000
Subject: [docs] [issue27381] Typo in zipfile documentation
Message-ID: <1466761093.81.0.0650336824478.issue27381@psf.upfronthosting.co.za>


New submission from Xiang Zhang:

There is a redundant ')' in zipfile doc. Remove it.

----------
assignee: docs at python
components: Documentation
files: zipfile_doc.patch
keywords: patch
messages: 269166
nosy: docs at python, xiang.zhang
priority: normal
severity: normal
status: open
title: Typo in zipfile documentation
versions: Python 3.6
Added file: http://bugs.python.org/file43528/zipfile_doc.patch

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

From report at bugs.python.org  Fri Jun 24 05:56:03 2016
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 24 Jun 2016 09:56:03 +0000
Subject: [docs] [issue27381] Typo in zipfile documentation
In-Reply-To: <1466761093.81.0.0650336824478.issue27381@psf.upfronthosting.co.za>
Message-ID: <20160624095559.32735.51498.B263BD76@psf.io>


Roundup Robot added the comment:

New changeset be435520e493 by Berker Peksag in branch '3.5':
Issue #27381: Remove superfluous paren in zipfile documentation
https://hg.python.org/cpython/rev/be435520e493

New changeset f859380d4708 by Berker Peksag in branch 'default':
Issue #27381: Merge from 3.5
https://hg.python.org/cpython/rev/f859380d4708

----------
nosy: +python-dev

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

From report at bugs.python.org  Fri Jun 24 05:56:30 2016
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 24 Jun 2016 09:56:30 +0000
Subject: [docs] [issue27381] Typo in zipfile documentation
In-Reply-To: <1466761093.81.0.0650336824478.issue27381@psf.upfronthosting.co.za>
Message-ID: <1466762190.52.0.23048542509.issue27381@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Thanks!

----------
nosy: +berker.peksag
resolution:  -> fixed
stage:  -> resolved
status: open -> closed
type:  -> behavior
versions: +Python 3.5

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

From igrokk70 at gmail.com  Wed Jun 22 11:51:30 2016
From: igrokk70 at gmail.com (=?UTF-8?B?0J3QvtC20LrQuNC9INCY0LPQvtGA0Yw=?=)
Date: Wed, 22 Jun 2016 19:51:30 +0400
Subject: [docs] Download problems
Message-ID: <CAF-sx2R9YPj_MYSEfEyCDcG=+OF8jkbTJ0pvLMi3kaufOXCvTQ@mail.gmail.com>

If you're using 2.7.12rc1 version, you can't download the documentation (
https://docs.python.org/2/archives/python-2.7.12rc1-docs-pdf-letter.zip for
example). For other versions works fine. Could you please fix that?
[image: ?????????? ??????????? 1]
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160622/58bd5f30/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image.png
Type: image/png
Size: 56455 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20160622/58bd5f30/attachment-0001.png>

From report at bugs.python.org  Fri Jun 24 10:28:02 2016
From: report at bugs.python.org (R. David Murray)
Date: Fri, 24 Jun 2016 14:28:02 +0000
Subject: [docs] [issue27344] zipfile *does* support utf-8 filenames
In-Reply-To: <1466176126.21.0.0133629365393.issue27344@psf.upfronthosting.co.za>
Message-ID: <1466778482.54.0.127257876889.issue27344@psf.upfronthosting.co.za>


R. David Murray added the comment:

I bet the existing wording is just left over from the python2 docs.

I think cp437 should still be mentioned explicitly.  And mentioning "setting the utf-8 flag" would probably make the explanation clearer, though I'm not sure.

Tecnically speaking, I think zipfile supports utf8, not unicode.  Or it supports unicode via utf-8.

----------

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

From report at bugs.python.org  Fri Jun 24 12:24:41 2016
From: report at bugs.python.org (Daniel Holth)
Date: Fri, 24 Jun 2016 16:24:41 +0000
Subject: [docs] [issue27344] zipfile *does* support utf-8 filenames
In-Reply-To: <1466176126.21.0.0133629365393.issue27344@psf.upfronthosting.co.za>
Message-ID: <1466785481.0.0.148483398629.issue27344@psf.upfronthosting.co.za>


Daniel Holth added the comment:

https://hg.python.org/cpython/file/2.6/Lib/zipfile.py#l331

Python 2.6 zipfile supports utf8 properly. It has only improved since then.

----------

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

From report at bugs.python.org  Fri Jun 24 13:29:12 2016
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 24 Jun 2016 17:29:12 +0000
Subject: [docs] [issue27344] zipfile *does* support utf-8 filenames
In-Reply-To: <1466176126.21.0.0133629365393.issue27344@psf.upfronthosting.co.za>
Message-ID: <1466789351.97.0.808044726831.issue27344@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

This note looks outdated.

In 2.x 8-bit file names are written as is, implying cp437 or what your consumers expect. Unicode file names are encoded to ascii or utf-8 (with setting utf-8 flag). In 3.x only Unicode file names are accepted, and they always are encoded to ascii or utf-8. There is no way to write non-ascii non-utf-8 file names. cp437 is not used at all.

Maybe just remove this misleading note?

----------

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

From report at bugs.python.org  Fri Jun 24 16:58:00 2016
From: report at bugs.python.org (Grant Mathews)
Date: Fri, 24 Jun 2016 20:58:00 +0000
Subject: [docs] [issue27385] itertools.groupby has misleading doc string
Message-ID: <1466801880.76.0.293579802764.issue27385@psf.upfronthosting.co.za>


New submission from Grant Mathews:

The itertools.groupby function is generally well-documented, but the fact that it only groups consecutive occurrences of keys is not mentioned in the doc string, which is where that information is most needed.

----------
assignee: docs at python
components: Documentation
files: groupby_doc.patch
keywords: patch
messages: 269211
nosy: docs at python, gmathews
priority: normal
severity: normal
status: open
title: itertools.groupby has misleading doc string
versions: Python 2.7, Python 3.2, Python 3.3, Python 3.4, Python 3.5, Python 3.6
Added file: http://bugs.python.org/file43531/groupby_doc.patch

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

From report at bugs.python.org  Fri Jun 24 19:03:07 2016
From: report at bugs.python.org (Ned Deily)
Date: Fri, 24 Jun 2016 23:03:07 +0000
Subject: [docs] [issue27385] itertools.groupby has misleading doc string
In-Reply-To: <1466801880.76.0.293579802764.issue27385@psf.upfronthosting.co.za>
Message-ID: <1466809387.86.0.0629627285085.issue27385@psf.upfronthosting.co.za>


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


----------
nosy: +rhettinger
stage:  -> patch review
versions:  -Python 3.2, Python 3.3, Python 3.4

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

From report at bugs.python.org  Fri Jun 24 22:24:31 2016
From: report at bugs.python.org (Raymond Hettinger)
Date: Sat, 25 Jun 2016 02:24:31 +0000
Subject: [docs] [issue27385] itertools.groupby has misleading doc string
In-Reply-To: <1466801880.76.0.293579802764.issue27385@psf.upfronthosting.co.za>
Message-ID: <1466821471.2.0.847194718291.issue27385@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

The patch is fine.

----------
assignee: docs at python -> rhettinger
priority: normal -> low

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

From report at bugs.python.org  Sat Jun 25 06:52:02 2016
From: report at bugs.python.org (Jaysinh shukla)
Date: Sat, 25 Jun 2016 10:52:02 +0000
Subject: [docs] [issue20842] pkgutil docs should reference glossary terms
 not PEP 302
In-Reply-To: <1393846400.67.0.723549613222.issue20842@psf.upfronthosting.co.za>
Message-ID: <1466851922.66.0.986288662984.issue20842@psf.upfronthosting.co.za>


Jaysinh shukla added the comment:

Dear Martin,
    I observed your comment. I can see, issue mentioned by you http://bugs.python.org/issue26896 contains patch of clarifying the reference of Importer, Finder. The issue-26896 is still under review phase. It will be good step to update doc in this issue according to http://bugs.python.org/file42666/issue.diff patch?

Thanks!

----------

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

From vadmium+py at gmail.com  Sat Jun 25 08:41:47 2016
From: vadmium+py at gmail.com (vadmium+py at gmail.com)
Date: Sat, 25 Jun 2016 12:41:47 -0000
Subject: [docs] pkgutil docs should reference glossary terms not PEP 302
 (issue 20842)
Message-ID: <20160625124147.447.64466@psf.upfronthosting.co.za>


http://bugs.python.org/review/20842/diff/17723/Doc/library/pkgutil.rst
File Doc/library/pkgutil.rst (right):

http://bugs.python.org/review/20842/diff/17723/Doc/library/pkgutil.rst#newcode51
Doc/library/pkgutil.rst:51: If *dirname* is a string, a :term:`importer`
is created that searches that
IMO it is detrimental linking the same term over and over. Once per
section of text would be better.

http://bugs.python.org/review/20842/

From report at bugs.python.org  Sat Jun 25 08:41:51 2016
From: report at bugs.python.org (Martin Panter)
Date: Sat, 25 Jun 2016 12:41:51 +0000
Subject: [docs] [issue20842] pkgutil docs should reference glossary terms
 not PEP 302
In-Reply-To: <1393846400.67.0.723549613222.issue20842@psf.upfronthosting.co.za>
Message-ID: <1466858511.55.0.874899588966.issue20842@psf.upfronthosting.co.za>


Martin Panter added the comment:

I?m not sure what the best solution is. I am just pointing out the problem. It seems an ?importer? as mentioned in PEP 302 is more general than the current glossary definition. E.g. ImpImporter() returns an object that has a find_module() method (which partially makes it both a ?meta path finder? and a ?path entry finder?), but it has no load_module() method. So it fails the ?importer? definition according to the current glossary.

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

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

From report at bugs.python.org  Sun Jun 26 13:28:34 2016
From: report at bugs.python.org (Manuel Kaufmann)
Date: Sun, 26 Jun 2016 17:28:34 +0000
Subject: [docs] [issue27393] Command to activate venv in Windows has wrong
 path
Message-ID: <1466962113.91.0.904493080486.issue27393@psf.upfronthosting.co.za>


New submission from Manuel Kaufmann:

The `venv` module has a bug in the command to activate it on Windows.

In 3.3 and 3.4 the bar used is wrong: `/` instead `\`

* https://docs.python.org/3.4/library/venv.html#creating-virtual-environments
* https://docs.python.org/3.3/library/venv.html#creating-virtual-environments


In 3.5 and 3.6 that section was converted to a table with the commands and they are missing the `\` in the command path:

* https://docs.python.org/3.5/library/venv.html#creating-virtual-environments
* https://docs.python.org/dev/library/venv.html#creating-virtual-environments

----------
assignee: docs at python
components: Documentation
files: venv-windows-command.patch
keywords: patch
messages: 269299
nosy: docs at python, facundobatista, humitos
priority: normal
severity: normal
status: open
title: Command to activate venv in Windows has wrong path
type: enhancement
versions: Python 3.3, Python 3.4, Python 3.5, Python 3.6
Added file: http://bugs.python.org/file43543/venv-windows-command.patch

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

From report at bugs.python.org  Sun Jun 26 16:54:07 2016
From: report at bugs.python.org (R. David Murray)
Date: Sun, 26 Jun 2016 20:54:07 +0000
Subject: [docs] [issue27387] Thread hangs on str.encode() when locale is not
 set
In-Reply-To: <1466892219.46.0.416121805197.issue27387@psf.upfronthosting.co.za>
Message-ID: <1466974447.19.0.856768238866.issue27387@psf.upfronthosting.co.za>


R. David Murray added the comment:

This situation is warned about explicitly in the threading docs (https://docs.python.org/2/library/threading.html#importing-in-threaded-code).  The import deadlock is fixed in python3, but it is still a really bad idea to launch threads on module import.

What isn't obvious, of course, is that calling encode for the first time for a given encoding does an implicit import of the relevant encoding.  I don't think encodings is the only stdlib module that does implicit imports, but it is probably the most used case.  Maybe it is worth adding a warning to that section of the 2.7 docs about implicit imports in general and encode/decode in particular?

----------
assignee:  -> docs at python
components: +Documentation -Interpreter Core, Unicode
nosy: +docs at python, r.david.murray

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

From report at bugs.python.org  Mon Jun 27 02:50:35 2016
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 27 Jun 2016 06:50:35 +0000
Subject: [docs] [issue27393] Command to activate venv in Windows has wrong
 path
In-Reply-To: <1466962113.91.0.904493080486.issue27393@psf.upfronthosting.co.za>
Message-ID: <20160627065032.25345.81420.0D75B6E8@psf.io>


Roundup Robot added the comment:

New changeset fd1236294b88 by Berker Peksag in branch '3.5':
Issue #27393: Fix escaping of venv activate commands on Windows
https://hg.python.org/cpython/rev/fd1236294b88

New changeset cf560010e6f8 by Berker Peksag in branch 'default':
Issue #27393: Merge from 3.5
https://hg.python.org/cpython/rev/cf560010e6f8

----------
nosy: +python-dev

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

From report at bugs.python.org  Mon Jun 27 02:52:35 2016
From: report at bugs.python.org (Berker Peksag)
Date: Mon, 27 Jun 2016 06:52:35 +0000
Subject: [docs] [issue27393] Command to activate venv in Windows has wrong
 path
In-Reply-To: <1466962113.91.0.904493080486.issue27393@psf.upfronthosting.co.za>
Message-ID: <1467010355.68.0.605458270074.issue27393@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Thanks! 3.3 and 3.4 docs are not maintained anymore.

----------
nosy: +berker.peksag
resolution:  -> fixed
stage:  -> resolved
status: open -> closed
type: enhancement -> behavior
versions:  -Python 3.3, Python 3.4

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

From report at bugs.python.org  Mon Jun 27 05:07:38 2016
From: report at bugs.python.org (Eryk Sun)
Date: Mon, 27 Jun 2016 09:07:38 +0000
Subject: [docs] [issue27393] Command to activate venv in Windows has wrong
 path
In-Reply-To: <1466962113.91.0.904493080486.issue27393@psf.upfronthosting.co.za>
Message-ID: <1467018458.29.0.560764373005.issue27393@psf.upfronthosting.co.za>


Eryk Sun added the comment:

You missed "C:\\>".

----------
nosy: +eryksun
resolution: fixed -> 
stage: resolved -> 
status: closed -> open

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

From report at bugs.python.org  Mon Jun 27 06:09:43 2016
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 27 Jun 2016 10:09:43 +0000
Subject: [docs] [issue27393] Command to activate venv in Windows has wrong
 path
In-Reply-To: <1466962113.91.0.904493080486.issue27393@psf.upfronthosting.co.za>
Message-ID: <20160627100939.52453.43539.21E23EC1@psf.io>


Roundup Robot added the comment:

New changeset b82149953a8c by Berker Peksag in branch '3.5':
Issue #27393: Fix escaping of C:\ too
https://hg.python.org/cpython/rev/b82149953a8c

New changeset e1a0582896d6 by Berker Peksag in branch 'default':
Issue #27393: Merge from 3.5
https://hg.python.org/cpython/rev/e1a0582896d6

----------

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

From report at bugs.python.org  Mon Jun 27 06:12:17 2016
From: report at bugs.python.org (Berker Peksag)
Date: Mon, 27 Jun 2016 10:12:17 +0000
Subject: [docs] [issue27393] Command to activate venv in Windows has wrong
 path
In-Reply-To: <1466962113.91.0.904493080486.issue27393@psf.upfronthosting.co.za>
Message-ID: <1467022337.04.0.967482597279.issue27393@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Thanks, Eryk. By the way, there is no need to change the state of 'resolution' and 'stage' fields.

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

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

From report at bugs.python.org  Mon Jun 27 12:33:41 2016
From: report at bugs.python.org (Brett Cannon)
Date: Mon, 27 Jun 2016 16:33:41 +0000
Subject: [docs] [issue27387] Thread hangs on str.encode() when locale is not
 set
In-Reply-To: <1466892219.46.0.416121805197.issue27387@psf.upfronthosting.co.za>
Message-ID: <1467045221.68.0.297559326706.issue27387@psf.upfronthosting.co.za>


Brett Cannon added the comment:

Adding a note to the docs sounds reasonable.

----------

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

From report at bugs.python.org  Mon Jun 27 12:50:39 2016
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 27 Jun 2016 16:50:39 +0000
Subject: [docs] [issue27387] Thread hangs on str.encode() when locale is not
 set
In-Reply-To: <1467045221.68.0.297559326706.issue27387@psf.upfronthosting.co.za>
Message-ID: <CAMpsgwZdHRPEDfFCAL_wW19kHMXZcycSSBJAcdNDYDBPvjJ0AA@mail.gmail.com>


STINNER Victor added the comment:

> Maybe it is worth adding a warning to that section of the 2.7 docs about implicit imports in general and encode/decode in particular?

Ok to add a note to str.encode and str.decode methods to explain that
an import is needed the first time that an encoding is used.

I'm not ok for a warning, we should not discourage developers to use
these methods! They are not dangerous by themself.

----------

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

From report at bugs.python.org  Mon Jun 27 13:09:40 2016
From: report at bugs.python.org (Michael Lee)
Date: Mon, 27 Jun 2016 17:09:40 +0000
Subject: [docs] [issue27402] Sequence example in typing module documentation
 does not typecheck
Message-ID: <1467047380.43.0.562730585486.issue27402@psf.upfronthosting.co.za>


New submission from Michael Lee:

In the documentation for the `typing` module, the [entry for the `List` type][0] uses the following example to help demonstrate when to use `Sequence` vs `List`:

    T = TypeVar('T', int, float)

    def vec2(x: T, y: T) -> List[T]:
        return [x, y]

    def slice__to_4(vector: Sequence[T]) -> List[T]:
        return vector[0:4]

However, the `slice__to_4` function does not actually typecheck since there's no guarantee that a slice of a sequence will return a `List`. For example the vector could be a numpy array or a custom subclass of `collections.abc.Sequence` with an unusual `__getitem__`. (Mypy correctly catches this error and complains about an "Incompatible return value type").

The documentation should probably be updated to use an example that _does_ typecheck, though I'm not sure what exactly that example might look like? Maybe replace `slice__to_4` with something like this?

    def keep_positives(vector: Sequence[T]) -> List[T]:
        return [item for item in vector if item > 0]

----------
assignee: docs at python
components: Documentation
messages: 269389
nosy: docs at python, michael0x2a
priority: normal
severity: normal
status: open
title: Sequence example in typing module documentation does not typecheck
versions: Python 3.5, Python 3.6

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

From report at bugs.python.org  Mon Jun 27 13:12:11 2016
From: report at bugs.python.org (Michael Lee)
Date: Mon, 27 Jun 2016 17:12:11 +0000
Subject: [docs] [issue27402] Sequence example in typing module documentation
 does not typecheck
In-Reply-To: <1467047380.43.0.562730585486.issue27402@psf.upfronthosting.co.za>
Message-ID: <1467047531.67.0.579606064746.issue27402@psf.upfronthosting.co.za>


Michael Lee added the comment:

Whoops, forgot the link to the error in the docs: 

https://docs.python.org/3/library/typing.html#typing.List

----------

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

From report at bugs.python.org  Mon Jun 27 14:21:39 2016
From: report at bugs.python.org (R. David Murray)
Date: Mon, 27 Jun 2016 18:21:39 +0000
Subject: [docs] [issue27387] Thread hangs on str.encode() when locale is not
 set
In-Reply-To: <1466892219.46.0.416121805197.issue27387@psf.upfronthosting.co.za>
Message-ID: <1467051699.31.0.490070238931.issue27387@psf.upfronthosting.co.za>


R. David Murray added the comment:

No, I'm talking about the threading docs, not the encoding docs.  I think that's the only place it matters.  Specifically, in the section that I linked to, in the bullet point that warns against launching threads on import, it can note that even if you try to make your own code avoid the import lock, implicit imports such as the one done by encode/decode can trip you up.

----------

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

From jagdish1287 at gmail.com  Fri Jun 24 14:10:23 2016
From: jagdish1287 at gmail.com (Jagdish Choudhary)
Date: Fri, 24 Jun 2016 23:40:23 +0530
Subject: [docs] Seen bug in argparse module
Message-ID: <CALgKYe3whWoNCdm=+xRy-aBKPjVj73yXa59m_GFQdtcymmxd0A@mail.gmail.com>

Hi All,

When argument provided from user which doesn't match to right option which
is mentioned in help , it runs without issue..let me provide an example

https://docs.python.org/3.3/library/argparse.html

import argparse
parser = argparse.ArgumentParser(description='Process some
integers.')parser.add_argument('integers', metavar='N', type=int,
nargs='+',
                   help='an integer for the
accumulator')parser.add_argument('--sum', dest='accumulate',
action='store_const',
                   const=sum, default=max,
                   help='sum the integers (default: find the max)')
args = parser.parse_args()print(args.accumulate(args.integers))

python prog.py -h
usage: prog.py [-h] [--sum] N [N ...]

Process some integers.

positional arguments:
 N           an integer for the accumulator

optional arguments:
 -h, --help  show this help message and exit
 --sum       sum the integers (default: find the max)

If user run it like below-

JAGDISHs-MacBook-Pro:test_python jagdish$ python prog.py 12 3 4 --sum
19
JAGDISHs-MacBook-Pro:test_python jagdish$ python prog.py 12 3 4 --su
19
JAGDISHs-MacBook-Pro:test_python jagdish$ python prog.py 12 3 4 --s
19
JAGDISHs-MacBook-Pro:test_python jagdish$


If users provide s or su in place of sum it still works . Now consider the
case when some code may have few starting characters same , it will get be
confused . I think we should have proper check if user doesn't provide same
parameter as per help , it should throw error . thanks in advance !

-- 
Thanks and Regards,
Jagdish Choudhary
IBM India Pvt Ltd, Bangalore
M.No-8971011661
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160624/01951de2/attachment-0001.html>

From jagdish1287 at gmail.com  Fri Jun 24 14:40:29 2016
From: jagdish1287 at gmail.com (Jagdish Choudhary)
Date: Sat, 25 Jun 2016 00:10:29 +0530
Subject: [docs] Seen bug in argparse module
Message-ID: <CALgKYe2mB0J2doQMufjGekNnQL_TdP+8ogfYLJuk8xYd+86UDQ@mail.gmail.com>

Hi All,


When argument provided from user which doesn't match to right option which
is mentioned in help , it runs without issue..let me provide an example

https://docs.python.org/3.3/library/argparse.html

import argparse
parser = argparse.ArgumentParser(description='Process some
integers.')parser.add_argument('integers', metavar='N', type=int,
nargs='+',
                   help='an integer for the
accumulator')parser.add_argument('--sum', dest='accumulate',
action='store_const',
                   const=sum, default=max,
                   help='sum the integers (default: find the max)')
args = parser.parse_args()print(args.accumulate(args.integers))

python prog.py -h
usage: prog.py [-h] [--sum] N [N ...]

Process some integers.

positional arguments:
 N           an integer for the accumulator

optional arguments:
 -h, --help  show this help message and exit
 --sum       sum the integers (default: find the max)

If user run it like below-

JAGDISHs-MacBook-Pro:test_python jagdish$ python prog.py 12 3 4 --sum
19
JAGDISHs-MacBook-Pro:test_python jagdish$ python prog.py 12 3 4 --su
19
JAGDISHs-MacBook-Pro:test_python jag


-- 
Thanks and Regards,
Jagdish Choudhary
IBM India Pvt Ltd, Bangalore
M.No-8971011661
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160625/e5e6e1d9/attachment.html>

From report at bugs.python.org  Tue Jun 28 10:42:50 2016
From: report at bugs.python.org (Josh Rosenberg)
Date: Tue, 28 Jun 2016 14:42:50 +0000
Subject: [docs] [issue27385] itertools.groupby has misleading doc string
In-Reply-To: <1466801880.76.0.293579802764.issue27385@psf.upfronthosting.co.za>
Message-ID: <1467124970.63.0.136197748511.issue27385@psf.upfronthosting.co.za>


Josh Rosenberg added the comment:

While you're fixing, the docstring should say "groupby(iterable, key=None)", not "groupby(iterable[, keyfunc])"; the functions accepts the key function by name, and the name is key, not keyfunc. And it can be passed explicitly as None (equivalent to not passing it at all), so the [, keyfunc] approach that indicates it's positional only and can't be explicitly passed as a default is wrong. Gets a little confusing because it also returns a "key", but the argument is definitely named "key", so we can't go calling it "keyfunc".

Mind you, seems like this could also be fixed by just Clinic-ifying it.

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

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

From report at bugs.python.org  Tue Jun 28 10:50:23 2016
From: report at bugs.python.org (R. David Murray)
Date: Tue, 28 Jun 2016 14:50:23 +0000
Subject: [docs] [issue27385] itertools.groupby has misleading doc string
In-Reply-To: <1466801880.76.0.293579802764.issue27385@psf.upfronthosting.co.za>
Message-ID: <1467125423.02.0.45279463343.issue27385@psf.upfronthosting.co.za>


R. David Murray added the comment:

Please open a separate issue for that problem.

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

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

From report at bugs.python.org  Tue Jun 28 11:16:34 2016
From: report at bugs.python.org (Raymond Hettinger)
Date: Tue, 28 Jun 2016 15:16:34 +0000
Subject: [docs] [issue27385] itertools.groupby has misleading doc string
In-Reply-To: <1466801880.76.0.293579802764.issue27385@psf.upfronthosting.co.za>
Message-ID: <1467126994.31.0.294090093043.issue27385@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

That's okay.  I'm taking care of both in this issue.

----------

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

From report at bugs.python.org  Tue Jun 28 11:22:26 2016
From: report at bugs.python.org (Raymond Hettinger)
Date: Tue, 28 Jun 2016 15:22:26 +0000
Subject: [docs] [issue27385] itertools.groupby has misleading doc string
In-Reply-To: <1466801880.76.0.293579802764.issue27385@psf.upfronthosting.co.za>
Message-ID: <1467127346.2.0.144275259256.issue27385@psf.upfronthosting.co.za>


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


Added file: http://bugs.python.org/file43571/groupbydoc.diff

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

From report at bugs.python.org  Tue Jun 28 13:13:24 2016
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 28 Jun 2016 17:13:24 +0000
Subject: [docs] [issue27402] Sequence example in typing module documentation
 does not typecheck
In-Reply-To: <1467047380.43.0.562730585486.issue27402@psf.upfronthosting.co.za>
Message-ID: <20160628171309.28782.74096.A3C07A06@psf.io>


Roundup Robot added the comment:

New changeset 0aec17c8f434 by Guido van Rossum in branch '3.5':
Fix issue #27402: example for typing did not type-check.
https://hg.python.org/cpython/rev/0aec17c8f434

New changeset 57f3514564f6 by Guido van Rossum in branch 'default':
Fix issue #27402: example for typing did not type-check. (Merge 3.5->3.6)
https://hg.python.org/cpython/rev/57f3514564f6

----------
nosy: +python-dev

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

From report at bugs.python.org  Tue Jun 28 13:32:44 2016
From: report at bugs.python.org (Guido van Rossum)
Date: Tue, 28 Jun 2016 17:32:44 +0000
Subject: [docs] [issue27402] Sequence example in typing module documentation
 does not typecheck
In-Reply-To: <1467047380.43.0.562730585486.issue27402@psf.upfronthosting.co.za>
Message-ID: <1467135164.33.0.386384463667.issue27402@psf.upfronthosting.co.za>


Guido van Rossum added the comment:

Thanks!

----------
nosy: +gvanrossum
resolution:  -> fixed
status: open -> closed

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

From report at bugs.python.org  Tue Jun 28 22:22:03 2016
From: report at bugs.python.org (Brett Cannon)
Date: Wed, 29 Jun 2016 02:22:03 +0000
Subject: [docs] [issue27408] Document importlib.abc.ExecutionLoader
 implements get_data()
Message-ID: <1467166923.22.0.634971996974.issue27408@psf.upfronthosting.co.za>


New submission from Brett Cannon:

The fact that importlib.abc.ExectionLoader.get_data() is implemented is missing (or put another way, it isn't documented that get_source() still needs to be implemented).

----------
assignee: docs at python
components: Documentation
messages: 269458
nosy: brett.cannon, docs at python
priority: normal
severity: normal
stage: needs patch
status: open
title: Document importlib.abc.ExecutionLoader implements get_data()
versions: Python 3.5, Python 3.6

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

From report at bugs.python.org  Tue Jun 28 22:54:56 2016
From: report at bugs.python.org (Martin Panter)
Date: Wed, 29 Jun 2016 02:54:56 +0000
Subject: [docs] [issue27409] List socket.SO_*, SCM_*, MSG_*,
 IPPROTO_* symbols
Message-ID: <1467168896.94.0.840314714269.issue27409@psf.upfronthosting.co.za>


New submission from Martin Panter:

The documentation just says that SO_* etc constants are defined. However when people add new ones, they add them as new features to a specific version (not backported as bug fixes), but do not alter the documentation at all. IMO it is silly adding undocumented features. E.g. Issue 26907 was opened to add (among others) SO_PASSCRED, which was already added, undocumented, as part of Issue 6560.

This patch attempts to indicate which symbols are defined by Python (depending on OS availability), and therefore one can deduce if Python does not define a particular symbol. It could be adapted to the 2.7 documentation, but I am not really motivated for that on my own.

I also remove a redundant definition in the module, and removed a conditional because SO_REUSEADDR is required to always be defined according to the test suite. These specific changes should only be applied to 3.6.

I also found Issue 1732367, which has a patch documenting each AF_* symbol in a little more detail. That patch was never updated nor comitted, but it sounds like this kind of addition might be acceptable.

----------
assignee: docs at python
components: Documentation
files: socket-const.patch
keywords: patch
messages: 269460
nosy: docs at python, martin.panter
priority: normal
severity: normal
stage: patch review
status: open
title: List socket.SO_*, SCM_*, MSG_*, IPPROTO_* symbols
versions: Python 3.5, Python 3.6
Added file: http://bugs.python.org/file43573/socket-const.patch

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

From report at bugs.python.org  Wed Jun 29 02:37:57 2016
From: report at bugs.python.org (Steve Piercy)
Date: Wed, 29 Jun 2016 06:37:57 +0000
Subject: [docs] [issue27285] Document the deprecation of pyvenv in favor of
 `python3 -m venv`
In-Reply-To: <1465544944.16.0.549761687921.issue27285@psf.upfronthosting.co.za>
Message-ID: <1467182277.85.0.905832650991.issue27285@psf.upfronthosting.co.za>


Steve Piercy added the comment:

After looking into this issue, I need guidance to better define scope and intent, and how to go about submitting the changes. I found 81 occurrences of the term `pyvenv` in the documentation, either in reST files or docstrings, across about a dozen files.

1. Should I obliterate any mention of `pyvenv` (excluding HISTORY and whatsnew) or preserve a mention or two of it? For example, "`pyvenv` was the recommended tool for creating virtual environments for Python 3.3 and 3.4, and is deprecated in Python 3.6. Beginning in Python 3.5, the use of `venv` is recommended."

2. Is it preferred to submit one patch for all edited files, or one patch per edited file?

TIA for any guidance.

----------

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

From report at bugs.python.org  Wed Jun 29 10:04:26 2016
From: report at bugs.python.org (R. David Murray)
Date: Wed, 29 Jun 2016 14:04:26 +0000
Subject: [docs] [issue27285] Document the deprecation of pyvenv in favor of
 `python3 -m venv`
In-Reply-To: <1465544944.16.0.549761687921.issue27285@psf.upfronthosting.co.za>
Message-ID: <1467209066.56.0.919736270365.issue27285@psf.upfronthosting.co.za>


R. David Murray added the comment:

In this case I think one patch is good.  The deprecation should mention pyvenv in the main venv docs (and maybe installing), but probably nowhere else.  See the deprecated-removed sphinx tag.

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

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

From report at bugs.python.org  Wed Jun 29 11:04:30 2016
From: report at bugs.python.org (Paul Killey)
Date: Wed, 29 Jun 2016 15:04:30 +0000
Subject: [docs] [issue27416] typo / missing word in
 docs.python.org/2/library/copy.html
Message-ID: <1467212670.04.0.257355516163.issue27416@psf.upfronthosting.co.za>


New submission from Paul Killey:

I wonder if the word 'not' is missing between 'that' and 'should' in this sentence in https://docs.python.org/2/library/copy.html?

Because deep copy copies everything it may copy too much, e.g., administrative data structures that should be shared even between copies.

----------
assignee: docs at python
components: Documentation
messages: 269512
nosy: docs at python, paulkilley
priority: normal
severity: normal
status: open
title: typo / missing word in docs.python.org/2/library/copy.html
versions: Python 2.7

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

From report at bugs.python.org  Wed Jun 29 11:06:12 2016
From: report at bugs.python.org (Paul Killey)
Date: Wed, 29 Jun 2016 15:06:12 +0000
Subject: [docs] [issue27416] typo / missing word in
 docs.python.org/2/library/copy.html
In-Reply-To: <1467212670.04.0.257355516163.issue27416@psf.upfronthosting.co.za>
Message-ID: <1467212772.09.0.369592644005.issue27416@psf.upfronthosting.co.za>


Paul Killey added the comment:

I'm sorry, 'not' could be missing between 'should' and 'be' --- 'should not be shared'

----------

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

From report at bugs.python.org  Wed Jun 29 11:23:59 2016
From: report at bugs.python.org (R. David Murray)
Date: Wed, 29 Jun 2016 15:23:59 +0000
Subject: [docs] [issue27416] typo / missing word in
 docs.python.org/2/library/copy.html
In-Reply-To: <1467212670.04.0.257355516163.issue27416@psf.upfronthosting.co.za>
Message-ID: <1467213839.67.0.122008207973.issue27416@psf.upfronthosting.co.za>


R. David Murray added the comment:

No, the text is correct.  Perhaps it would be clearer if the 'even' were moved to the front of the phrase?

"...it may copy too much, even data structures that should be shared between copies."

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

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

From report at bugs.python.org  Wed Jun 29 12:40:37 2016
From: report at bugs.python.org (Paul Killey)
Date: Wed, 29 Jun 2016 16:40:37 +0000
Subject: [docs] [issue27416] typo / missing word in
 docs.python.org/2/library/copy.html
In-Reply-To: <1467212670.04.0.257355516163.issue27416@psf.upfronthosting.co.za>
Message-ID: <1467218437.04.0.294274509257.issue27416@psf.upfronthosting.co.za>


Paul Killey added the comment:

Ah, I see now -- your comment clarified it for me.  Thanks.

----------

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

From report at bugs.python.org  Thu Jun 30 05:51:09 2016
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 30 Jun 2016 09:51:09 +0000
Subject: [docs] [issue27416] typo / missing word in
 docs.python.org/2/library/copy.html
In-Reply-To: <1467212670.04.0.257355516163.issue27416@psf.upfronthosting.co.za>
Message-ID: <20160630095105.124085.77110.11276AC2@psf.io>


Roundup Robot added the comment:

New changeset 9efe0e718914 by Victor Stinner in branch '2.7':
Issue #27416: clarify copy doc
https://hg.python.org/cpython/rev/9efe0e718914

New changeset 54e9ca0a1639 by Victor Stinner in branch '3.5':
Issue #27416: clarify copy doc
https://hg.python.org/cpython/rev/54e9ca0a1639

----------
nosy: +python-dev

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

From report at bugs.python.org  Thu Jun 30 05:52:01 2016
From: report at bugs.python.org (STINNER Victor)
Date: Thu, 30 Jun 2016 09:52:01 +0000
Subject: [docs] [issue27416] typo / missing word in
 docs.python.org/2/library/copy.html
In-Reply-To: <1467212670.04.0.257355516163.issue27416@psf.upfronthosting.co.za>
Message-ID: <1467280321.2.0.0493814967031.issue27416@psf.upfronthosting.co.za>


STINNER Victor added the comment:

> Because deep copy copies everything it may copy too much, e.g., administrative data structures that should be shared even between copies.

I agree that the sentence sounds wrong. I applied David's patch, it also helped me to understand. Thanks :-)

----------
nosy: +haypo
resolution:  -> fixed
status: open -> closed

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

From report at bugs.python.org  Thu Jun 30 06:33:36 2016
From: report at bugs.python.org (Niall Mansfield)
Date: Thu, 30 Jun 2016 10:33:36 +0000
Subject: [docs] [issue27420] Docs for os.link - say what happens if link
 already exists
Message-ID: <1467282816.95.0.317527848578.issue27420@psf.upfronthosting.co.za>


New submission from Niall Mansfield:

In os.link(source, link_name)

Change
  Create a hard link pointing to source named link_name.

to
  Create a hard link pointing to source named link_name.
  If link_name already exists, OSError is raised.

----------
assignee: docs at python
components: Documentation
messages: 269572
nosy: docs at python, python-bugs-uit
priority: normal
severity: normal
status: open
title: Docs for os.link - say what happens if link already exists
type: enhancement
versions: Python 2.7

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

From report at bugs.python.org  Thu Jun 30 14:43:33 2016
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 30 Jun 2016 18:43:33 +0000
Subject: [docs] [issue26665] pip is not bootstrapped by default on 2.7
In-Reply-To: <1459261486.77.0.745706792357.issue26665@psf.upfronthosting.co.za>
Message-ID: <20160630184330.122165.94869.57F1E28A@psf.io>


Roundup Robot added the comment:

New changeset 4fc0154ec84a by Brett Cannon in branch '3.5':
Issue #26665: Remove mis-use of ``$`` in activate.fish.
https://hg.python.org/cpython/rev/4fc0154ec84a

----------
nosy: +python-dev

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

From report at bugs.python.org  Thu Jun 30 15:38:14 2016
From: report at bugs.python.org (Zachary Ware)
Date: Thu, 30 Jun 2016 19:38:14 +0000
Subject: [docs] [issue26665] pip is not bootstrapped by default on 2.7
In-Reply-To: <1459261486.77.0.745706792357.issue26665@psf.upfronthosting.co.za>
Message-ID: <1467315494.21.0.574874190779.issue26665@psf.upfronthosting.co.za>


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


----------
Removed message: http://bugs.python.org/msg269614

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

From report at bugs.python.org  Thu Jun 30 17:50:28 2016
From: report at bugs.python.org (Ivan Levkivskyi)
Date: Thu, 30 Jun 2016 21:50:28 +0000
Subject: [docs] [issue26141] typing module documentation incomplete
In-Reply-To: <1453049740.68.0.762293537242.issue26141@psf.upfronthosting.co.za>
Message-ID: <1467323428.58.0.541011427181.issue26141@psf.upfronthosting.co.za>


Ivan Levkivskyi added the comment:

I would like to do this (update the typing docs) at some point before 3.6 beta1. There probably will be some updates to the PEP (it is still provisional), and maybe to typing.py soon.

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

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

From report at bugs.python.org  Thu Jun 30 17:55:39 2016
From: report at bugs.python.org (Ivan Levkivskyi)
Date: Thu, 30 Jun 2016 21:55:39 +0000
Subject: [docs] [issue26696] Document collections.abc.ByteString
In-Reply-To: <1459881544.79.0.834895685887.issue26696@psf.upfronthosting.co.za>
Message-ID: <1467323739.06.0.37929675961.issue26696@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Jun 30 18:34:32 2016
From: report at bugs.python.org (Brett Cannon)
Date: Thu, 30 Jun 2016 22:34:32 +0000
Subject: [docs] [issue27428] Document WindowsRegistryFinder inherits from
 MetaPathFinder
Message-ID: <1467326072.76.0.431868228595.issue27428@psf.upfronthosting.co.za>


New submission from Brett Cannon:

Currently the docs claim it inherits from importlib.abc.Finder.

----------
assignee: docs at python
components: Documentation
messages: 269633
nosy: brett.cannon, docs at python
priority: normal
severity: normal
status: open
title: Document WindowsRegistryFinder inherits from MetaPathFinder
versions: Python 3.5, Python 3.6

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

From report at bugs.python.org  Thu Jun 30 20:37:13 2016
From: report at bugs.python.org (Martin Panter)
Date: Fri, 01 Jul 2016 00:37:13 +0000
Subject: [docs] [issue26665] pip is not bootstrapped by default on 2.7
In-Reply-To: <1459261486.77.0.745706792357.issue26665@psf.upfronthosting.co.za>
Message-ID: <1467333432.8.0.559422975025.issue26665@psf.upfronthosting.co.za>


Martin Panter added the comment:

Revision 4fc0154ec84a links here, but actually seems to be discussed in Issue 26348 and Issue 26664 instead.

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

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

From report at bugs.python.org  Thu Jun 30 23:59:12 2016
From: report at bugs.python.org (Paul Winkler)
Date: Fri, 01 Jul 2016 03:59:12 +0000
Subject: [docs] [issue1349732] urllib.urlencode provides two features in one
 param
Message-ID: <1467345552.16.0.42518391132.issue1349732@psf.upfronthosting.co.za>


Paul Winkler added the comment:

This was marked as a duplicate of http://bugs.python.org/issue8788 but the doc changes in that issue, and the current docs for 2.7, do not mention anything related to handling of unicode nor how `doseq` affects unicode-related behavior.  If we can agree on wording, does 2.7 still get documentation fixes?

----------
nosy: +slinkp

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

From eamost at gmail.com  Thu Jun 30 20:53:10 2016
From: eamost at gmail.com (Eli Most)
Date: Thu, 30 Jun 2016 17:53:10 -0700
Subject: [docs] Unicode Howto Doc Bug
Message-ID: <CACFhUWZ7f-K3mk6C-7zXAA-YaHi87Xt2LhqdwVO=T8x4KnsZbw@mail.gmail.com>

Hey,

I just noticed a small typo in the document:

"the language features a str
<https://docs.python.org/3/library/stdtypes.html#str> type that contain
Unicode characters"

where "contain" should read "contains"

Thanks,
Eli Most
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20160630/87b9fa7f/attachment.html>