From report at bugs.python.org  Mon Oct  1 04:53:42 2018
From: report at bugs.python.org (INADA Naoki)
Date: Mon, 01 Oct 2018 08:53:42 +0000
Subject: [docs] [issue34538] Remove encouragement to author a base class for
 all Exception subclasses in a module
In-Reply-To: <1535488851.13.0.56676864532.issue34538@psf.upfronthosting.co.za>
Message-ID: <1538384022.12.0.545547206417.issue34538@psf.upfronthosting.co.za>


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

Thanks, Nathaniel.  I totally concur with you.

This is tutorial section.  We should focus on readers of the tutorial.

----------

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

From report at bugs.python.org  Mon Oct  1 05:10:12 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 01 Oct 2018 09:10:12 +0000
Subject: [docs] [issue34538] Remove encouragement to author a base class for
 all Exception subclasses in a module
In-Reply-To: <1535488851.13.0.56676864532.issue34538@psf.upfronthosting.co.za>
Message-ID: <1538385012.81.0.545547206417.issue34538@psf.upfronthosting.co.za>


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

Guido, the check-in message for this section indicates that Fred Drake added this wording at your behest.  Do you still agree with the guidance and examples or would you like to have it removed from all active versions of the documentation as proposed?

https://docs.python.org/3.8/tutorial/errors.html#user-defined-exceptions

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

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

From report at bugs.python.org  Mon Oct  1 06:09:43 2018
From: report at bugs.python.org (Andrew Svetlov)
Date: Mon, 01 Oct 2018 10:09:43 +0000
Subject: [docs] [issue34476] asyncio.sleep(0) not documented
In-Reply-To: <1535035287.88.0.56676864532.issue34476@psf.upfronthosting.co.za>
Message-ID: <1538388582.93.0.545547206417.issue34476@psf.upfronthosting.co.za>


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


New changeset cd602b8af2d14ff686261eeb18b80f718bb16550 by Andrew Svetlov (Hrvoje Nik?i?) in branch 'master':
bpo-34476: Document that asyncio.sleep() always suspends. (#9643)
https://github.com/python/cpython/commit/cd602b8af2d14ff686261eeb18b80f718bb16550


----------

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

From report at bugs.python.org  Mon Oct  1 06:09:57 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 01 Oct 2018 10:09:57 +0000
Subject: [docs] [issue34476] asyncio.sleep(0) not documented
In-Reply-To: <1535035287.88.0.56676864532.issue34476@psf.upfronthosting.co.za>
Message-ID: <1538388597.37.0.668975606942.issue34476@psf.upfronthosting.co.za>


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


----------
pull_requests: +9045

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

From report at bugs.python.org  Mon Oct  1 06:19:37 2018
From: report at bugs.python.org (Andrew Svetlov)
Date: Mon, 01 Oct 2018 10:19:37 +0000
Subject: [docs] [issue34476] asyncio.sleep(0) not documented
In-Reply-To: <1535035287.88.0.56676864532.issue34476@psf.upfronthosting.co.za>
Message-ID: <1538389177.08.0.545547206417.issue34476@psf.upfronthosting.co.za>


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


New changeset 655608a1112e592cd6a9155ebe774dd285f561f3 by Andrew Svetlov (Miss Islington (bot)) in branch '3.7':
bpo-34476: Document that asyncio.sleep() always suspends. (GH-9643) (#9654)
https://github.com/python/cpython/commit/655608a1112e592cd6a9155ebe774dd285f561f3


----------

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

From report at bugs.python.org  Mon Oct  1 06:20:04 2018
From: report at bugs.python.org (Andrew Svetlov)
Date: Mon, 01 Oct 2018 10:20:04 +0000
Subject: [docs] [issue34476] asyncio.sleep(0) not documented
In-Reply-To: <1535035287.88.0.56676864532.issue34476@psf.upfronthosting.co.za>
Message-ID: <1538389204.31.0.545547206417.issue34476@psf.upfronthosting.co.za>


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

thanks!

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

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

From report at bugs.python.org  Mon Oct  1 06:20:13 2018
From: report at bugs.python.org (Andrew Svetlov)
Date: Mon, 01 Oct 2018 10:20:13 +0000
Subject: [docs] [issue34476] asyncio.sleep(0) not documented
In-Reply-To: <1535035287.88.0.56676864532.issue34476@psf.upfronthosting.co.za>
Message-ID: <1538389213.76.0.668975606942.issue34476@psf.upfronthosting.co.za>


Change by Andrew Svetlov <andrew.svetlov at gmail.com>:


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

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

From report at bugs.python.org  Mon Oct  1 06:31:19 2018
From: report at bugs.python.org (Caleb Hattingh)
Date: Mon, 01 Oct 2018 10:31:19 +0000
Subject: [docs] [issue34831] Asyncio Tutorial
In-Reply-To: <1538134577.09.0.545547206417.issue34831@psf.upfronthosting.co.za>
Message-ID: <1538389879.46.0.545547206417.issue34831@psf.upfronthosting.co.za>


Caleb Hattingh <caleb.hattingh at gmail.com> added the comment:

> * I think we should stick to your structure and push things to docs.python.org as soon as every next section is somewhat ready.

Ok. I'll get a PR going for the start page of the tutorial.

> * Every big section should probably have its own page, linking prev/next tutorial pages.
> * I'd organize the tutorial in a dedicated directory like "Doc/library/asyncio-tutorial/".

Agree.

> BTW, maybe we should consider using the new iPythonn async repl: https://blog.jupyter.org/ipython-7-0-async-repl-a35ce050f7f7   What do you think about that?

I saw ?Matthias' tweets about that recently too. It's cool! but...for teaching purposes it's not great to introduce a whole new complex tool (ipython) to explain a different complex tool (asyncio). My experience is that *every* single new thing that is mentioned adds cognitive load for learners. For this tutorial my feeling is to keep as much to "ordinary" Python stuff as possible, i.e., stdlib.

> Just a quick note: I'd try to not mention the low-level loop APIs as long as possible (e.g. no loop.run_until_complete() etc).

For sure, I agree with you 100% on this. But I find it hard to do as soon as I have to make a real thing. I think you're right that we focus initially on only high-level stuff first (and for most of the tut). That is doable.

> I think we'll collapse first two section into one ("Coroutines" and "Awaitables" into "Awaitables") and link the tutorial from that new section.

ok

> Yay for streams!
> I never use tkinter myself :( I remember trying to use it and it didn't work on my macOS.  So I'd try to either:
> * build a simple browser app (that would require us to implement HTTP 0.9 which can be fun);
> * build a terminal app;
> * use iPython repl to connect to our asyncio server (might end up being more complicated than the first two options).

I too have bashed my head for many hours over the years trying to get Tkinter to work on Mac, but a lot of work has gone into this recently and the newer (release) Python's have bundled Tk 8.6: https://www.python.org/download/mac/tcltk/ (this is what learners will prob use on Mac)

Tkinter gets a bad rap, but it's really quite powerful--and portable. Runs great on a Raspberry Pi for example.

Noticing your hesitation towards tkinter ;) , I spent a few hours on Sunday sketching out my "chat server/client" idea a little more, using Tkinter for the client UI:

https://github.com/cjrh/chat

(Notice especially in the README all the different aspects of asyncio, streams etc. that we would be able to cover and explain with an actual use-case. THESE are the kinds of tricky things people desperately want help with.)

It's still rough obviously (I can prob reduce the total LOC footprint by 20% & I'm sure you can improve on some parts) but I just wanted to show you something runnable you can prod and poke to give a concrete idea of what I'm suggesting. It works on Windows, should work on Linux but I haven't tested yet.

My proposal is that we slowly build up towards this, starting with the "hello world" simple case (asyncio.run calling main() which prints out "hello world" or something), and then adding the necessary features, piece by piece, with commentary along the way on what each piece does, and why it is done in a particular way. (I specifically like to write like this: simplistic case first, and then improve incrementally)

- Only requires stdlib (so we don't have to explain or link to pip/virtualenv etc. etc.)
- shows a wide range of *interoperating* asyncio features in a condensed app
- client has a proper GUI, i.e. "looks" like an actual application, not just an ugly CLI thing
- client handles reconnection, if the server goes down and comes back later.
- using signal handling to trigger shutdown (esp. the server)
- signal handling works on Windows (CTRL-C and CTRL-BREAK near-instant controlled shutdown)
- server is 100% asyncio (so that situation is covered), but client requires marrying two loops (so this situation is also covered), one for tkinter and one for asyncio. (This is a common problem, not just with UI frameworks but also with game programming frameworks like pygame, pyarcade and so on. Again, this is the kind of problem many people ask for help with.)
- thus, an example showing how to run asyncio in a thread. (asyncio.run works great in a thread, nice job!)
- an actual SSL example that works (this was surprisingly hard to find, eventually found one at PyMOTW)

I fully realise that this case study implementation might look weird and ugly, and we don't really want to mention threads at all, and we don't want to explicitly refer to the loop, or create a Future instance, etc., but this is the kind of case study that will give people guidance on how to handle these *actual problems* that they are going to come across.

If you have a look and still don't want to go this way, that's ok, I'm happy to go with a different suggestion.

----------

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

From report at bugs.python.org  Mon Oct  1 07:39:31 2018
From: report at bugs.python.org (Andrew Svetlov)
Date: Mon, 01 Oct 2018 11:39:31 +0000
Subject: [docs] [issue33117] asyncio example uses non-existing/documented
 method
In-Reply-To: <1521666406.67.0.467229070634.issue33117@psf.upfronthosting.co.za>
Message-ID: <1538393971.37.0.545547206417.issue33117@psf.upfronthosting.co.za>


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

@xtreak is right, `run_coroutine_threadsafe()` returns `concurrent.futures.Future` object.

Personally, I like the fact that `fut.result()` is called with timeout parameter to reflect the fact of the different object type.

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

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

From report at bugs.python.org  Mon Oct  1 11:14:07 2018
From: report at bugs.python.org (Guido van Rossum)
Date: Mon, 01 Oct 2018 15:14:07 +0000
Subject: [docs] [issue34538] Remove encouragement to author a base class for
 all Exception subclasses in a module
In-Reply-To: <1535488851.13.0.56676864532.issue34538@psf.upfronthosting.co.za>
Message-ID: <1538406847.66.0.545547206417.issue34538@psf.upfronthosting.co.za>


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

I think as a general recommendation it is not such a good idea that we should specifically mention it. (Is it in PEP 8 too? If so it should be removed there too.)

It's a pattern that is sometimes helpful, sometimes not. I don't think that people need to hear about it from the official docs about exceptions. People can learn from the standard exception hierarchy that sometimes it's useful to have a common base class *for exceptions that are related in some way*, in particular if there would be a reason to catch all of them with the same handler.

So I'm in agreement with Nathaniel M here.

----------

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

From report at bugs.python.org  Mon Oct  1 11:22:07 2018
From: report at bugs.python.org (Marc-Andre Lemburg)
Date: Mon, 01 Oct 2018 15:22:07 +0000
Subject: [docs] [issue34538] Remove encouragement to author a base class for
 all Exception subclasses in a module
In-Reply-To: <1535488851.13.0.56676864532.issue34538@psf.upfronthosting.co.za>
Message-ID: <1538407327.6.0.545547206417.issue34538@psf.upfronthosting.co.za>


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

Just as extra data point:

It is fairly common to have a common exception class which is then used a mixin class together with the standard exception classes, so that you can indeed identify the source of an exception and catch errors based on the source (e.g. say you want to catch database errors coming from MySQL specifically).

The Python DB-API also requires to create a separate hierarchy for this purpose.

Overall, I wouldn't call this a non-best practice. It depends on the use case, whether it's useful or not.

----------
nosy: +lemburg

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

From report at bugs.python.org  Mon Oct  1 12:12:27 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 01 Oct 2018 16:12:27 +0000
Subject: [docs] [issue33729] Hashlib/blake2* missing 'data' keyword argument
In-Reply-To: <1527842171.52.0.682650639539.issue33729@psf.upfronthosting.co.za>
Message-ID: <1538410347.34.0.668975606942.issue33729@psf.upfronthosting.co.za>


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


----------
pull_requests: +9049

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

From report at bugs.python.org  Mon Oct  1 19:56:52 2018
From: report at bugs.python.org (Ezio Melotti)
Date: Mon, 01 Oct 2018 23:56:52 +0000
Subject: [docs] [issue31865] html.unescape does not work as per documentation
In-Reply-To: <1508899606.23.0.213398074469.issue31865@psf.upfronthosting.co.za>
Message-ID: <1538438212.5.0.668975606942.issue31865@psf.upfronthosting.co.za>


Change by Ezio Melotti <ezio.melotti at gmail.com>:


----------
assignee: docs at python -> ezio.melotti
keywords: +easy
stage:  -> needs patch

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

From report at bugs.python.org  Mon Oct  1 20:28:05 2018
From: report at bugs.python.org (Ezio Melotti)
Date: Tue, 02 Oct 2018 00:28:05 +0000
Subject: [docs] [issue31865] html.unescape does not work as per documentation
In-Reply-To: <1508899606.23.0.213398074469.issue31865@psf.upfronthosting.co.za>
Message-ID: <1538440085.06.0.668975606942.issue31865@psf.upfronthosting.co.za>


Change by Ezio Melotti <ezio.melotti at gmail.com>:


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

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

From report at bugs.python.org  Mon Oct  1 20:34:52 2018
From: report at bugs.python.org (Ezio Melotti)
Date: Tue, 02 Oct 2018 00:34:52 +0000
Subject: [docs] [issue31865] html.unescape does not work as per documentation
In-Reply-To: <1508899606.23.0.213398074469.issue31865@psf.upfronthosting.co.za>
Message-ID: <1538440492.04.0.545547206417.issue31865@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:


New changeset 30534cc7172f36092e0002bb7df482edc0d539ce by Ezio Melotti in branch 'master':
bpo-31865: Fix a couple of typos in the html.unescape() docs. (GH-9662)
https://github.com/python/cpython/commit/30534cc7172f36092e0002bb7df482edc0d539ce


----------

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

From report at bugs.python.org  Mon Oct  1 20:35:05 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 02 Oct 2018 00:35:05 +0000
Subject: [docs] [issue31865] html.unescape does not work as per documentation
In-Reply-To: <1508899606.23.0.213398074469.issue31865@psf.upfronthosting.co.za>
Message-ID: <1538440505.05.0.668975606942.issue31865@psf.upfronthosting.co.za>


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


----------
pull_requests: +9056

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

From report at bugs.python.org  Mon Oct  1 20:35:12 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 02 Oct 2018 00:35:12 +0000
Subject: [docs] [issue31865] html.unescape does not work as per documentation
In-Reply-To: <1508899606.23.0.213398074469.issue31865@psf.upfronthosting.co.za>
Message-ID: <1538440512.27.0.668975606942.issue31865@psf.upfronthosting.co.za>


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


----------
pull_requests: +9057

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

From report at bugs.python.org  Mon Oct  1 20:43:58 2018
From: report at bugs.python.org (Ezio Melotti)
Date: Tue, 02 Oct 2018 00:43:58 +0000
Subject: [docs] [issue31865] html.unescape does not work as per documentation
In-Reply-To: <1508899606.23.0.213398074469.issue31865@psf.upfronthosting.co.za>
Message-ID: <1538441038.8.0.545547206417.issue31865@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:


New changeset 27d7f93f633f0163b96d0a95e312f0eb5615abfd by Ezio Melotti (Miss Islington (bot)) in branch '3.7':
bpo-31865: Fix a couple of typos in the html.unescape() docs. (GH-9663)
https://github.com/python/cpython/commit/27d7f93f633f0163b96d0a95e312f0eb5615abfd


----------

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

From report at bugs.python.org  Mon Oct  1 20:44:36 2018
From: report at bugs.python.org (Ezio Melotti)
Date: Tue, 02 Oct 2018 00:44:36 +0000
Subject: [docs] [issue31865] html.unescape does not work as per documentation
In-Reply-To: <1508899606.23.0.213398074469.issue31865@psf.upfronthosting.co.za>
Message-ID: <1538441076.25.0.545547206417.issue31865@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:


New changeset 56c102596f01ecbbe5cca6339d2ae16695b083ff by Ezio Melotti (Miss Islington (bot)) in branch '3.6':
bpo-31865: Fix a couple of typos in the html.unescape() docs. (GH-9664)
https://github.com/python/cpython/commit/56c102596f01ecbbe5cca6339d2ae16695b083ff


----------

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

From report at bugs.python.org  Mon Oct  1 20:49:10 2018
From: report at bugs.python.org (Ezio Melotti)
Date: Tue, 02 Oct 2018 00:49:10 +0000
Subject: [docs] [issue31865] html.unescape does not work as per documentation
In-Reply-To: <1508899606.23.0.213398074469.issue31865@psf.upfronthosting.co.za>
Message-ID: <1538441350.84.0.545547206417.issue31865@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

Fixed, thanks for the report!

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

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

From report at bugs.python.org  Tue Oct  2 12:35:30 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Tue, 02 Oct 2018 16:35:30 +0000
Subject: [docs] [issue34843] logging cookbook docs: remove 'recent' when
 referring to multiprocessing
In-Reply-To: <1538227702.53.0.545547206417.issue34843@psf.upfronthosting.co.za>
Message-ID: <1538498130.05.0.668975606942.issue34843@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Tue Oct  2 17:01:29 2018
From: report at bugs.python.org (Antoine Pitrou)
Date: Tue, 02 Oct 2018 21:01:29 +0000
Subject: [docs] [issue34172] multiprocessing.Pool and ThreadPool leak
 resources after being deleted
In-Reply-To: <1532105129.76.0.56676864532.issue34172@psf.upfronthosting.co.za>
Message-ID: <1538514088.99.0.545547206417.issue34172@psf.upfronthosting.co.za>


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


New changeset 97bfe8d3ebb0a54c8798f57555cb4152f9b2e1d0 by Antoine Pitrou (tzickel) in branch 'master':
bpo-34172: multiprocessing.Pool leaks resources after being deleted (GH-8450)
https://github.com/python/cpython/commit/97bfe8d3ebb0a54c8798f57555cb4152f9b2e1d0


----------

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

From report at bugs.python.org  Tue Oct  2 17:01:48 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 02 Oct 2018 21:01:48 +0000
Subject: [docs] [issue34172] multiprocessing.Pool and ThreadPool leak
 resources after being deleted
In-Reply-To: <1532105129.76.0.56676864532.issue34172@psf.upfronthosting.co.za>
Message-ID: <1538514108.39.0.668975606942.issue34172@psf.upfronthosting.co.za>


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


----------
pull_requests: +9064

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

From report at bugs.python.org  Tue Oct  2 17:01:58 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 02 Oct 2018 21:01:58 +0000
Subject: [docs] [issue34172] multiprocessing.Pool and ThreadPool leak
 resources after being deleted
In-Reply-To: <1532105129.76.0.56676864532.issue34172@psf.upfronthosting.co.za>
Message-ID: <1538514118.3.0.668975606942.issue34172@psf.upfronthosting.co.za>


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


----------
pull_requests: +9065

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

From report at bugs.python.org  Tue Oct  2 17:17:09 2018
From: report at bugs.python.org (Antoine Pitrou)
Date: Tue, 02 Oct 2018 21:17:09 +0000
Subject: [docs] [issue34172] multiprocessing.Pool and ThreadPool leak
 resources after being deleted
In-Reply-To: <1532105129.76.0.56676864532.issue34172@psf.upfronthosting.co.za>
Message-ID: <1538515029.65.0.545547206417.issue34172@psf.upfronthosting.co.za>


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


New changeset 97f998a4dfd6db6d867f446daa62445d0782bf39 by Antoine Pitrou (Miss Islington (bot)) in branch '3.7':
bpo-34172: multiprocessing.Pool leaks resources after being deleted (GH-8450) (GH-9676)
https://github.com/python/cpython/commit/97f998a4dfd6db6d867f446daa62445d0782bf39


----------

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

From report at bugs.python.org  Tue Oct  2 17:36:21 2018
From: report at bugs.python.org (Antoine Pitrou)
Date: Tue, 02 Oct 2018 21:36:21 +0000
Subject: [docs] [issue34172] multiprocessing.Pool and ThreadPool leak
 resources after being deleted
In-Reply-To: <1532105129.76.0.56676864532.issue34172@psf.upfronthosting.co.za>
Message-ID: <1538516181.32.0.545547206417.issue34172@psf.upfronthosting.co.za>


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


New changeset 07b96a95db78eff3557d1bfed1df9ebecc40815b by Antoine Pitrou (Miss Islington (bot)) in branch '3.6':
bpo-34172: multiprocessing.Pool leaks resources after being deleted (GH-8450) (GH-9677)
https://github.com/python/cpython/commit/07b96a95db78eff3557d1bfed1df9ebecc40815b


----------

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

From report at bugs.python.org  Tue Oct  2 17:37:42 2018
From: report at bugs.python.org (Antoine Pitrou)
Date: Tue, 02 Oct 2018 21:37:42 +0000
Subject: [docs] [issue34172] multiprocessing.Pool and ThreadPool leak
 resources after being deleted
In-Reply-To: <1532105129.76.0.56676864532.issue34172@psf.upfronthosting.co.za>
Message-ID: <1538516262.32.0.545547206417.issue34172@psf.upfronthosting.co.za>


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

Thanks tzickler for the report and pull request, and sorry for the delay.

This is now fixed in all 3.x branches.  I will close this now as multiprocessing in 2.7 diverges quite a bit from 3.x.  If you want to fix the issue in 2.7 as well, please say so and I'll reopen.

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

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

From report at bugs.python.org  Tue Oct  2 17:38:11 2018
From: report at bugs.python.org (Antoine Pitrou)
Date: Tue, 02 Oct 2018 21:38:11 +0000
Subject: [docs] [issue34172] multiprocessing.Pool and ThreadPool leak
 resources after being deleted
In-Reply-To: <1532105129.76.0.56676864532.issue34172@psf.upfronthosting.co.za>
Message-ID: <1538516291.1.0.545547206417.issue34172@psf.upfronthosting.co.za>


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

(tzickel, sorry for mistyping your handle :-/)

----------

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

From report at bugs.python.org  Tue Oct  2 19:41:46 2018
From: report at bugs.python.org (ulrich.stern)
Date: Tue, 02 Oct 2018 23:41:46 +0000
Subject: [docs] [issue34878] Lock Objects documentation bug
Message-ID: <1538523706.16.0.545547206417.issue34878@psf.upfronthosting.co.za>


New submission from ulrich.stern <ulrich.stern at gmail.com>:

The first sentence of the documentation for Lock Objects (https://docs.python.org/2/library/threading.html#lock-objects) seems incorrect.  It currently states "A primitive lock is a synchronization primitive that is not owned by a particular thread when locked."  The "not" should be deleted.  (Alternatively, one could change "locked" to "unlocked.")

----------
assignee: docs at python
components: Documentation
messages: 326926
nosy: docs at python, ulrich.stern
priority: normal
severity: normal
status: open
title: Lock Objects documentation bug
versions: Python 2.7, Python 3.4, Python 3.5, Python 3.6, Python 3.7, Python 3.8

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

From report at bugs.python.org  Tue Oct  2 22:53:20 2018
From: report at bugs.python.org (Sangbae Nam)
Date: Wed, 03 Oct 2018 02:53:20 +0000
Subject: [docs] [issue32174] nonASCII punctuation characters can not display
 in python363.chm.
In-Reply-To: <1512013530.29.0.213398074469.issue32174@psf.upfronthosting.co.za>
Message-ID: <1538535200.0.0.545547206417.issue32174@psf.upfronthosting.co.za>


Sangbae Nam <sangbae.nam at gmail.com> added the comment:

This issue still persists in 3.6 and 3.7.

----------
assignee:  -> docs at python
components: +Documentation
nosy: +Sangbae Nam, docs at python
versions: +Python 3.7
Added file: https://bugs.python.org/file47844/py37chm.png

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

From report at bugs.python.org  Wed Oct  3 00:48:40 2018
From: report at bugs.python.org (Benjamin Peterson)
Date: Wed, 03 Oct 2018 04:48:40 +0000
Subject: [docs] [issue34878] Lock Objects documentation bug
In-Reply-To: <1538523706.16.0.545547206417.issue34878@psf.upfronthosting.co.za>
Message-ID: <1538542120.61.0.545547206417.issue34878@psf.upfronthosting.co.za>


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

The current documentation is correct. While conceptually one may think of a lock as being held ("owned") by a particular thread, the lock internally has no idea what thread owns it?operations on a lock are influenced only by its current state not what thread is performing the operation. It's perfectly possible, if inadvisable, to release a lock on a thread different from the one it was acquired on. The description of ownership is meant to draw a distinction with recursive locks, which do have an internal notion of ownership.

----------
nosy: +benjamin.peterson
resolution:  -> not a bug
stage:  -> resolved
status: open -> closed

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

From report at bugs.python.org  Wed Oct  3 04:52:45 2018
From: report at bugs.python.org (tzickel)
Date: Wed, 03 Oct 2018 08:52:45 +0000
Subject: [docs] [issue34172] multiprocessing.Pool and ThreadPool leak
 resources after being deleted
In-Reply-To: <1532105129.76.0.56676864532.issue34172@psf.upfronthosting.co.za>
Message-ID: <1538556765.02.0.668975606942.issue34172@psf.upfronthosting.co.za>


Change by tzickel <icebreak at yahoo.com>:


----------
pull_requests: +9072

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

From report at bugs.python.org  Wed Oct  3 04:59:43 2018
From: report at bugs.python.org (tzickel)
Date: Wed, 03 Oct 2018 08:59:43 +0000
Subject: [docs] [issue34172] multiprocessing.Pool and ThreadPool leak
 resources after being deleted
In-Reply-To: <1532105129.76.0.56676864532.issue34172@psf.upfronthosting.co.za>
Message-ID: <1538557183.58.0.545547206417.issue34172@psf.upfronthosting.co.za>


tzickel <icebreak at yahoo.com> added the comment:

Its ok, you only did it twice :) I've submitted a manual 2.7 fix on GH.

----------

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

From report at bugs.python.org  Wed Oct  3 07:46:52 2018
From: report at bugs.python.org (Antoine Pitrou)
Date: Wed, 03 Oct 2018 11:46:52 +0000
Subject: [docs] [issue34172] multiprocessing.Pool and ThreadPool leak
 resources after being deleted
In-Reply-To: <1532105129.76.0.56676864532.issue34172@psf.upfronthosting.co.za>
Message-ID: <1538567212.53.0.668975606942.issue34172@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Wed Oct  3 07:47:00 2018
From: report at bugs.python.org (Antoine Pitrou)
Date: Wed, 03 Oct 2018 11:47:00 +0000
Subject: [docs] [issue34172] multiprocessing.Pool and ThreadPool leak
 resources after being deleted
In-Reply-To: <1532105129.76.0.56676864532.issue34172@psf.upfronthosting.co.za>
Message-ID: <1538567220.08.0.668975606942.issue34172@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Wed Oct  3 07:50:13 2018
From: report at bugs.python.org (Antoine Pitrou)
Date: Wed, 03 Oct 2018 11:50:13 +0000
Subject: [docs] [issue34172] multiprocessing.Pool and ThreadPool leak
 resources after being deleted
In-Reply-To: <1532105129.76.0.56676864532.issue34172@psf.upfronthosting.co.za>
Message-ID: <1538567413.34.0.545547206417.issue34172@psf.upfronthosting.co.za>


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


New changeset 4a7dd30f5810e8861a3834159a222ab32d5c97d0 by Antoine Pitrou (tzickel) in branch '2.7':
[2.7] bpo-34172: multiprocessing.Pool leaks resources after being deleted (GH-9686)
https://github.com/python/cpython/commit/4a7dd30f5810e8861a3834159a222ab32d5c97d0


----------

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

From report at bugs.python.org  Wed Oct  3 07:50:21 2018
From: report at bugs.python.org (Antoine Pitrou)
Date: Wed, 03 Oct 2018 11:50:21 +0000
Subject: [docs] [issue34172] multiprocessing.Pool and ThreadPool leak
 resources after being deleted
In-Reply-To: <1532105129.76.0.56676864532.issue34172@psf.upfronthosting.co.za>
Message-ID: <1538567421.2.0.668975606942.issue34172@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Wed Oct  3 08:08:00 2018
From: report at bugs.python.org (Amirouche Boubekki)
Date: Wed, 03 Oct 2018 12:08:00 +0000
Subject: [docs] [issue34885] asycnio documention has lost its paragraph
 about cancellation
Message-ID: <1538568479.97.0.545547206417.issue34885@psf.upfronthosting.co.za>


New submission from Amirouche Boubekki <amirouche.boubekki at gmail.com>:

The paragraph was still there in 3.6 https://docs.python.org/3.6/library/asyncio-dev.html#cancellation

----------
assignee: docs at python
components: Documentation, asyncio
messages: 326966
nosy: abki, asvetlov, docs at python, yselivanov
priority: normal
severity: normal
status: open
title: asycnio documention has lost its paragraph about cancellation
type: enhancement
versions: Python 3.7, Python 3.8

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

From report at bugs.python.org  Wed Oct  3 08:08:24 2018
From: report at bugs.python.org (Amirouche Boubekki)
Date: Wed, 03 Oct 2018 12:08:24 +0000
Subject: [docs] [issue34885] asyncio documention has lost its paragraph
 about cancellation
In-Reply-To: <1538568479.97.0.545547206417.issue34885@psf.upfronthosting.co.za>
Message-ID: <1538568504.1.0.668975606942.issue34885@psf.upfronthosting.co.za>


Change by Amirouche Boubekki <amirouche.boubekki at gmail.com>:


----------
title: asycnio documention has lost its paragraph about cancellation -> asyncio documention has lost its paragraph about cancellation

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

From report at bugs.python.org  Wed Oct  3 08:11:27 2018
From: report at bugs.python.org (Andrew Svetlov)
Date: Wed, 03 Oct 2018 12:11:27 +0000
Subject: [docs] [issue34885] asyncio documention has lost its paragraph
 about cancellation
In-Reply-To: <1538568479.97.0.545547206417.issue34885@psf.upfronthosting.co.za>
Message-ID: <1538568687.89.0.545547206417.issue34885@psf.upfronthosting.co.za>


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

Yuri, can you take a look?

----------

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

From report at bugs.python.org  Wed Oct  3 10:30:06 2018
From: report at bugs.python.org (Yury Selivanov)
Date: Wed, 03 Oct 2018 14:30:06 +0000
Subject: [docs] [issue34885] asyncio documention has lost its paragraph
 about cancellation
In-Reply-To: <1538568479.97.0.545547206417.issue34885@psf.upfronthosting.co.za>
Message-ID: <1538577006.38.0.545547206417.issue34885@psf.upfronthosting.co.za>


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

The cancellation is now discussed in this section:https://docs.python.org/3/library/asyncio-task.html (search for "cancel") and in particular in the Task subsection.

Is there any important detail that was covered in the old documentation and is missing in the new one?

----------

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

From report at bugs.python.org  Wed Oct  3 10:39:12 2018
From: report at bugs.python.org (Yury Selivanov)
Date: Wed, 03 Oct 2018 14:39:12 +0000
Subject: [docs] [issue34831] Asyncio Tutorial
In-Reply-To: <1538134577.09.0.545547206417.issue34831@psf.upfronthosting.co.za>
Message-ID: <1538577552.67.0.545547206417.issue34831@psf.upfronthosting.co.za>


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

> I too have bashed my head for many hours over the years trying to get Tkinter to work on Mac, but a lot of work has gone into this recently and the newer (release) Python's have bundled Tk 8.6: https://www.python.org/download/mac/tcltk/ (this is what learners will prob use on Mac)


I've tried to run it and here's what I have on my system:

    ~/d/t/chat (master) ? python3.7 client.py
    Traceback (most recent call last):
      File "client.py", line 7, in <module>
        from tkinter import *
      File "/opt/local/Library/Frameworks/Python.framework/Versions/3.7/lib/python3.7/tkinter/__init__.py", line 36, in <module>
        import _tkinter # If this fails your Python may not be configured for Tk
    ModuleNotFoundError: No module named '_tkinter'


How about we write the tutorial and implement terminal clients first.  Then we can have two branches of the tutorial -- one implementing a Tk client, one implementing a web client?

----------

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

From report at bugs.python.org  Wed Oct  3 12:26:25 2018
From: report at bugs.python.org (ZooDSS)
Date: Wed, 03 Oct 2018 16:26:25 +0000
Subject: [docs] [issue34682] Typo reports on docs@
In-Reply-To: <1536943787.72.0.956365154283.issue34682@psf.upfronthosting.co.za>
Message-ID: <1538583985.44.0.545547206417.issue34682@psf.upfronthosting.co.za>


ZooDSS <ZooDSS at yandex.ru> added the comment:

Found new one.

https://docs.python.org/3/reference/lexical_analysis.html#comments
"Comments are ignored by the syntax; they are not tokens." - I honestly think, that this is misleading, by the fact that we have next words.

https://docs.python.org/3/library/token.html#token.COMMENT
"Token value used to indicate a comment." - this means, that system mentions the comment as a token, but still ch.2 of LR says backwards. May be I am wrong. Correct me, please.

----------

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

From report at bugs.python.org  Wed Oct  3 19:47:24 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Wed, 03 Oct 2018 23:47:24 +0000
Subject: [docs] [issue11233] clarifying Availability: Unix
In-Reply-To: <1297969399.53.0.187875867799.issue11233@psf.upfronthosting.co.za>
Message-ID: <1538610444.19.0.545547206417.issue11233@psf.upfronthosting.co.za>


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

Hello,

It doesn't appear that this patch was ever merged.  If there's still interest, would it be OK for me to convert it to a PR?

Thanks!

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

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

From report at bugs.python.org  Wed Oct  3 20:01:08 2018
From: report at bugs.python.org (Fred L. Drake, Jr.)
Date: Thu, 04 Oct 2018 00:01:08 +0000
Subject: [docs] [issue11233] clarifying Availability: Unix
In-Reply-To: <1297969399.53.0.187875867799.issue11233@psf.upfronthosting.co.za>
Message-ID: <1538611268.01.0.545547206417.issue11233@psf.upfronthosting.co.za>


Fred L. Drake, Jr. <fdrake at gmail.com> added the comment:

A PR for this would be good, and would certainly accelerate getting this accomplished.  Thanks, Cheryl!

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

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

From report at bugs.python.org  Wed Oct  3 20:42:02 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 04 Oct 2018 00:42:02 +0000
Subject: [docs] [issue11233] clarifying Availability: Unix
In-Reply-To: <1297969399.53.0.187875867799.issue11233@psf.upfronthosting.co.za>
Message-ID: <1538613722.85.0.668975606942.issue11233@psf.upfronthosting.co.za>


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


----------
pull_requests: +9079

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

From report at bugs.python.org  Wed Oct  3 20:42:46 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 04 Oct 2018 00:42:46 +0000
Subject: [docs] [issue11233] clarifying Availability: Unix
In-Reply-To: <1297969399.53.0.187875867799.issue11233@psf.upfronthosting.co.za>
Message-ID: <1538613766.52.0.545547206417.issue11233@psf.upfronthosting.co.za>


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

Thanks, Fred.  I've submitted the PR.

----------

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

From report at bugs.python.org  Wed Oct  3 20:42:57 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 04 Oct 2018 00:42:57 +0000
Subject: [docs] [issue11233] clarifying Availability: Unix
In-Reply-To: <1297969399.53.0.187875867799.issue11233@psf.upfronthosting.co.za>
Message-ID: <1538613777.01.0.668975606942.issue11233@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Oct  4 06:40:06 2018
From: report at bugs.python.org (Anthony Flury)
Date: Thu, 04 Oct 2018 10:40:06 +0000
Subject: [docs] [issue34891] Multi-processing example inaccurate warning
Message-ID: <1538649606.04.0.545547206417.issue34891@psf.upfronthosting.co.za>


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

On the Multi-processing page <https://docs.python.org/3/library/multiprocessing.html> (just above the reference section) there is a warning that the examples wont work from the interpreter.

This is not entirely accurate in that the examples do work, in the interpreter within Linux (and Mac OS I think), where the O/S supports processes being forked.

In fact it is only in Windows, where a brand new process needs to be started and the source is effectively re-imported is there an issue running the examples in the interpreter.

Should the documentation make this clearer ?

----------
assignee: docs at python
components: Documentation
messages: 327046
nosy: anthony-flury, docs at python
priority: normal
severity: normal
status: open
title: Multi-processing example inaccurate warning
versions: Python 3.8

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

From report at bugs.python.org  Thu Oct  4 08:02:08 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Thu, 04 Oct 2018 12:02:08 +0000
Subject: [docs] [issue34891] Multi-processing example inaccurate warning
In-Reply-To: <1538649606.04.0.545547206417.issue34891@psf.upfronthosting.co.za>
Message-ID: <1538654528.7.0.545547206417.issue34891@psf.upfronthosting.co.za>


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

Thanks for the report. Are you referring to the below warning?

> Functionality within this package requires that the __main__ module be importable by the children. This is covered in Programming guidelines however it is worth pointing out here. This means that some examples, such as the multiprocessing.pool.Pool examples will not work in the interactive interpreter. For example:

I tried the example and it throws the AttributeError as shown in the example in Linux and MacOS. Maybe I am wrong on the above. Can you please add in the specific example that is shown as not executable from the interpreter but actually works?

Thanks

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

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

From report at bugs.python.org  Thu Oct  4 11:44:12 2018
From: report at bugs.python.org (ulrich.stern)
Date: Thu, 04 Oct 2018 15:44:12 +0000
Subject: [docs] [issue34878] Lock Objects documentation bug
In-Reply-To: <1538523706.16.0.545547206417.issue34878@psf.upfronthosting.co.za>
Message-ID: <1538667852.11.0.545547206417.issue34878@psf.upfronthosting.co.za>


ulrich.stern <ulrich.stern at gmail.com> added the comment:

I still think the documentation should be changed, and an improved version would look more like your comment than what it looks now.  I assume to most people "owning" means exclusively holding the lock, and a particular thread can do this for Lock Objects.  For example, here what my #1 Google result for "lock ownership" (https://www.justsoftwaresolutions.co.uk/threading/locks-mutexes-semaphores.html) says:

> What it means to "own" a lock depends on the precise type of the lockable object. For some lockable objects...  In other cases, the definition is more fluid, and the ownership of the lock is more conceptual. In these cases, ownership can be relinquished by a different thread or object than the thread or object that acquired the lock.

In my opinion, the Python documentation currently takes the unusual point of view "a thread cannot 'own' a lock since it could be 'stolen' (released) by another thread."  And the Lock Objects documentation has no explanation for this view, which makes it possibly confusing.  Since multithreading is often tricky, documentation improvement seems worthwhile.  Happy to propose wording that incorporates our discussion if you are interested.

----------

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

From report at bugs.python.org  Thu Oct  4 12:33:38 2018
From: report at bugs.python.org (Marcus)
Date: Thu, 04 Oct 2018 16:33:38 +0000
Subject: [docs] [issue34895] Mark optional stdlib modules in documentation
Message-ID: <1538670818.19.0.545547206417.issue34895@psf.upfronthosting.co.za>


New submission from Marcus <of4tvziy at online.de>:

Some stdlib modules have external build time dependencies and will be automatically disabled if the dependencies can't be met (cf. detect_modules() in setup.py).
>From a user's perspective there is no reason to assume that the presence of a stdlib module may not be relied upon. See also the discussion on python-ideas (https://mail.python.org/pipermail/python-ideas/2018-October/054008.html).
A rather simple to implement debugging aid would be to add a note to the affected modules' documentation, stating that these modules may not be available on all systems.

----------
assignee: docs at python
components: Documentation
messages: 327065
nosy: docs at python, of4tvziy
priority: normal
severity: normal
status: open
title: Mark optional stdlib modules in documentation
type: enhancement
versions: Python 3.8

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

From report at bugs.python.org  Thu Oct  4 17:20:11 2018
From: report at bugs.python.org (Martin Panter)
Date: Thu, 04 Oct 2018 21:20:11 +0000
Subject: [docs] [issue26005] Denial of Service in SimpleHTTPServer and
 BaseHTTPServer
In-Reply-To: <1451897650.58.0.64883073344.issue26005@psf.upfronthosting.co.za>
Message-ID: <1538688011.77.0.545547206417.issue26005@psf.upfronthosting.co.za>


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

Issue 34576 was recently opened about adding a security warning.

----------
resolution:  -> duplicate
stage:  -> resolved
status: open -> closed
superseder:  -> [EASY doc] http.server, SimpleHTTPServer: warn users on security

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

From report at bugs.python.org  Fri Oct  5 00:16:40 2018
From: report at bugs.python.org (Danish Prakash)
Date: Fri, 05 Oct 2018 04:16:40 +0000
Subject: [docs] [issue34901] Missing isolated (-I) flag in sys.flags table
Message-ID: <1538713000.07.0.668975606942.issue34901@psf.upfronthosting.co.za>


Change by Danish Prakash <grafitykoncept at gmail.com>:


----------
assignee: docs at python
components: Documentation
nosy: danishprakash, docs at python
priority: normal
severity: normal
status: open
title: Missing isolated (-I) flag in sys.flags table
versions: Python 2.7, Python 3.4, Python 3.5, Python 3.6, Python 3.7, Python 3.8

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

From report at bugs.python.org  Fri Oct  5 00:20:30 2018
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 05 Oct 2018 04:20:30 +0000
Subject: [docs] [issue34901] Missing isolated (-I) flag in sys.flags table
Message-ID: <1538713230.43.0.668975606942.issue34901@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Oct  5 01:53:45 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Fri, 05 Oct 2018 05:53:45 +0000
Subject: [docs] [issue34901] Missing isolated (-I) flag in sys.flags table
Message-ID: <1538718824.99.0.545547206417.issue34901@psf.upfronthosting.co.za>


New submission from Karthikeyan Singaravelan <tir.karthi at gmail.com>:

Thanks for the PR @danishprakash . `-I` was added as part of 3.4 with commit ad73a9cf977 and not backported to 2.7 . Also 3.4 and 3.5 branches are in security fixes mode. So I am removing 2.7, 3.4 and 3.5 .

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

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

From report at bugs.python.org  Fri Oct  5 02:14:04 2018
From: report at bugs.python.org (Neil Schemenauer)
Date: Fri, 05 Oct 2018 06:14:04 +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: <1538720044.32.0.545547206417.issue22232@psf.upfronthosting.co.za>


Neil Schemenauer <nas-python at arctrix.com> added the comment:

If we introduce a keyword parameter, I think the default of str.splitlines() should be changed to match bytes.splitlines (and match Python 2 str.splitlines()).  I.e. split on \r and \n by default.  I looked through the stdline and I can't find any calls that should actually by splitting on the extra characters.  I will check it again though.

Does anyone have an example of where the current behaviour is actually wanted?

----------
nosy: +nascheme

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

From report at bugs.python.org  Fri Oct  5 02:42:35 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 05 Oct 2018 06:42:35 +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: <1538721754.98.0.545547206417.issue22232@psf.upfronthosting.co.za>


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

If change the default behavior we need to wait several releases after adding this option. Users should be able to pick the current behavior explicitly.

Currently the workaround is using regular expressions.

For s.splitlines(keepends=False):

    re.split(r'\n|\r\n?', s)

For s.splitlines(keepends=True):

    re.split(r'(?<=\n)|(?<=\r)(?!\n)', s)

----------

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

From report at bugs.python.org  Fri Oct  5 02:57:35 2018
From: report at bugs.python.org (Danish Prakash)
Date: Fri, 05 Oct 2018 06:57:35 +0000
Subject: [docs] [issue34901] Missing isolated (-I) flag in sys.flags table
In-Reply-To: <1538718824.99.0.545547206417.issue34901@psf.upfronthosting.co.za>
Message-ID: <1538722655.87.0.545547206417.issue34901@psf.upfronthosting.co.za>


Danish Prakash <grafitykoncept at gmail.com> added the comment:

thank you for for making the corrections, however, what's with a version being in security fixes mode? I would like to read more about that.

----------

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

From report at bugs.python.org  Fri Oct  5 03:31:26 2018
From: report at bugs.python.org (Mike Gleen)
Date: Fri, 05 Oct 2018 07:31:26 +0000
Subject: [docs] [issue34903] strptime %d handling of single digit day of
 month
Message-ID: <1538724686.61.0.545547206417.issue34903@psf.upfronthosting.co.za>


New submission from Mike Gleen <mike.gleen at gmail.com>:

strptime correctly parses single digit day-of-month values (at least in the case of "%d %b %Y") which is the behavior I want. However, the documentation seems to say that the field must be two digits with a leading zero if necessary. So I hope that this is the intended behavior rather than just an accidental artifact. If so, then my suggestion is that the documentation be updated to reflect this.

----------
assignee: docs at python
components: Documentation
messages: 327109
nosy: Mike Gleen, docs at python
priority: normal
severity: normal
status: open
title: strptime %d handling of single digit day of month
type: behavior
versions: Python 3.6

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

From report at bugs.python.org  Fri Oct  5 03:39:52 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Fri, 05 Oct 2018 07:39:52 +0000
Subject: [docs] [issue34903] strptime %d handling of single digit day of
 month
In-Reply-To: <1538724686.61.0.545547206417.issue34903@psf.upfronthosting.co.za>
Message-ID: <1538725192.15.0.545547206417.issue34903@psf.upfronthosting.co.za>


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

Hi Mike,

Thank you for your issue, but could you add the link to the documentation, just because we have time.strptime and datetime.datetime.strptime.

Thank you,

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

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

From report at bugs.python.org  Fri Oct  5 03:59:57 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Fri, 05 Oct 2018 07:59:57 +0000
Subject: [docs] [issue34901] Missing isolated (-I) flag in sys.flags table
In-Reply-To: <1538718824.99.0.545547206417.issue34901@psf.upfronthosting.co.za>
Message-ID: <1538726397.78.0.545547206417.issue34901@psf.upfronthosting.co.za>


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

Every release has a PEP associated with it from 3.6 and above that says about the lifespan of the release with bug fix releases and the time where it enters security fixes only mode. Now 3.4 and 3.5 are in security fixes mode where only security updates for the most part are accepted and the changes are pulled in by the release manager to the respective branches. Also there will be no binary releases and only source releases for security only branches.

Python 3.5.6 security announcement : https://www.python.org/downloads/release/python-356/

> Python 3.5 has now entered "security fixes only" mode, and as such the only changes since Python 3.5.4 are security fixes. Also, Python 3.5.6 has only been released in source code form; no more official binary installers will be produced.

Python 3.8 release lifespan : https://www.python.org/dev/peps/pep-0569/#lifespan

So I have removed 3.4 and 3.5 but it's up to the reviewer to decide if this needs to be backported or not to those branches. I hope I am correct on the above.

----------

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

From report at bugs.python.org  Fri Oct  5 04:17:42 2018
From: report at bugs.python.org (Marc-Andre Lemburg)
Date: Fri, 05 Oct 2018 08:17:42 +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: <1538727462.0.0.545547206417.issue22232@psf.upfronthosting.co.za>


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

I am -1 on changing the default behavior. The Unicode standard defines what a linebreak code point is (all code points with character properties Zl or bidirectional property B) and we adhere to that. This may confuse parsers coming from the ASCII world, but that's really a problem with those parsers assuming that .splitlines() only splits on ASCII line breaks, i.e. they are not written in a Unicode compatible way.

As mentioned in https://bugs.python.org/issue18291 we could add a parameter to .splitlines(), but this would render the method not much faster than re.split().

Using re.split() is not a work-around in his case, it's an explicit form  of defining the character you want to split lines on, if the standards defining your file format as only accepting ASCII line break characters.

Since there are many such file formats, perhaps adding a parameter asciionly=True/False would make sense. .splitlines() could then be made to only split on ASCII linebreak characters. This new parameter would then have to default to False to maintain compatibility with Unicode and all previous releases.

----------
nosy: +lemburg

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

From report at bugs.python.org  Fri Oct  5 10:04:22 2018
From: report at bugs.python.org (Neil Schemenauer)
Date: Fri, 05 Oct 2018 14:04:22 +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: <1538748261.98.0.545547206417.issue22232@psf.upfronthosting.co.za>


Neil Schemenauer <nas-python at arctrix.com> added the comment:

I've created a topic on this inside the "Ideas" area of discuss.python.org.  Sorry if that wasn't appropriate, not sure if I should have keep the discussion here.

Inada Naoki suggests creating a new method str.iterlines{[keepends]).  Given that people are -1 on changing str.splitlines, I think that's a good solution.  A new method is better yet if it would only split on '\n', that way fp.read().iterlines() matches fp.readlines().  It is what people seem to expect and is the most handy behaviour.  So, str and bytes would both get the new method and they would both split on only '\n'.

If we do that, I think nearly every use of splitlines() should get changed to iterlines().

----------

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

From report at bugs.python.org  Fri Oct  5 11:23:49 2018
From: report at bugs.python.org (Marc-Andre Lemburg)
Date: Fri, 05 Oct 2018 15:23:49 +0000
Subject: [docs] [issue22232] str.splitlines splitting on non-\r\n characters
In-Reply-To: <1538748261.98.0.545547206417.issue22232@psf.upfronthosting.co.za>
Message-ID: <dd8ecfe0-4d43-940a-b8fc-624831609dce@egenix.com>


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

Why not simply add a new parameter, to make people who want
ASCII linebreaks continue to use .splitlines() ?

It think it would be less than ideal to have one method break on
all Unicode line breaks and another only on ASCII ones.

----------

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

From report at bugs.python.org  Fri Oct  5 11:24:16 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 05 Oct 2018 15:24:16 +0000
Subject: [docs] [issue34825] Add more entries to os module to pathlib
 reference table
In-Reply-To: <1538071222.64.0.545547206417.issue34825@psf.upfronthosting.co.za>
Message-ID: <1538753056.65.0.545547206417.issue34825@psf.upfronthosting.co.za>


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


New changeset 6f9c55d1c0bb399911ded00bb6b3e6f43a514ea2 by Miss Islington (bot) (Xtreak) in branch 'master':
bpo-34825: Add more entries to os to pathlib reference table (GH-9608)
https://github.com/python/cpython/commit/6f9c55d1c0bb399911ded00bb6b3e6f43a514ea2


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

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

From report at bugs.python.org  Fri Oct  5 11:24:25 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 05 Oct 2018 15:24:25 +0000
Subject: [docs] [issue34825] Add more entries to os module to pathlib
 reference table
In-Reply-To: <1538071222.64.0.545547206417.issue34825@psf.upfronthosting.co.za>
Message-ID: <1538753065.48.0.668975606942.issue34825@psf.upfronthosting.co.za>


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


----------
pull_requests: +9100

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

From report at bugs.python.org  Fri Oct  5 12:06:20 2018
From: report at bugs.python.org (Andrew Svetlov)
Date: Fri, 05 Oct 2018 16:06:20 +0000
Subject: [docs] [issue34825] Add more entries to os module to pathlib
 reference table
In-Reply-To: <1538071222.64.0.545547206417.issue34825@psf.upfronthosting.co.za>
Message-ID: <1538755580.86.0.545547206417.issue34825@psf.upfronthosting.co.za>


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


New changeset 29c40c73143fee3612147959779b6927cd1be7e1 by Andrew Svetlov (Miss Islington (bot)) in branch '3.7':
bpo-34825: Add more entries to os to pathlib reference table (GH-9608) (#9717)
https://github.com/python/cpython/commit/29c40c73143fee3612147959779b6927cd1be7e1


----------
nosy: +asvetlov

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

From report at bugs.python.org  Fri Oct  5 12:07:36 2018
From: report at bugs.python.org (Andrew Svetlov)
Date: Fri, 05 Oct 2018 16:07:36 +0000
Subject: [docs] [issue34825] Add more entries to os module to pathlib
 reference table
In-Reply-To: <1538071222.64.0.545547206417.issue34825@psf.upfronthosting.co.za>
Message-ID: <1538755656.31.0.668975606942.issue34825@psf.upfronthosting.co.za>


Change by Andrew Svetlov <andrew.svetlov at gmail.com>:


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

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

From report at bugs.python.org  Fri Oct  5 13:31:21 2018
From: report at bugs.python.org (Mike Gleen)
Date: Fri, 05 Oct 2018 17:31:21 +0000
Subject: [docs] [issue34903] strptime %d handling of single digit day of
 month
In-Reply-To: <1538724686.61.0.545547206417.issue34903@psf.upfronthosting.co.za>
Message-ID: <1538760681.08.0.545547206417.issue34903@psf.upfronthosting.co.za>


Mike Gleen <mike.gleen at gmail.com> added the comment:

Sorry for the omission. This refers to datetime.datetime.strptime. The documentation I referenced is: https://docs.python.org/3/library/datetime.html; I did not test 2.7.

----------

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

From report at bugs.python.org  Fri Oct  5 13:38:17 2018
From: report at bugs.python.org (Felipe Rodrigues)
Date: Fri, 05 Oct 2018 17:38:17 +0000
Subject: [docs] [issue26005] Denial of Service in SimpleHTTPServer and
 BaseHTTPServer
In-Reply-To: <1451897650.58.0.64883073344.issue26005@psf.upfronthosting.co.za>
Message-ID: <1538761097.38.0.427663881802.issue26005@psf.upfronthosting.co.za>


Change by Felipe Rodrigues <felipe at felipevr.com>:


----------
pull_requests: +9104

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

From report at bugs.python.org  Fri Oct  5 14:13:08 2018
From: report at bugs.python.org (Neil Schemenauer)
Date: Fri, 05 Oct 2018 18:13:08 +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: <1538763188.26.0.545547206417.issue22232@psf.upfronthosting.co.za>


Neil Schemenauer <nas-python at arctrix.com> added the comment:

> Why not simply add a new parameter, to make people who want ASCII linebreaks continue to use .splitlines() ?

That could work but I think in nearly every case you don't want to use splitlines() without supplying the parameter.  So, it seems like a bit of trap for new users.  Worse, because in Python 2, str.splitlines() does what they want, they will do the simple thing which is likely wrong.

If we do stick with just splitlines(), perhaps it should get a 'newline' parameter that mostly matches io.open (i.e. it controls universal newline behavior).  So if you don't want to change behavior, str.splitlines(newline=None) would split as it currently does.  To make it split like io files do, you would have to do newline='\n'.

To me, it seems attractive that:
fp.readlines() == fp.read().iterlines()

You suggestion would make it something like:
fp.readlines() == fp.read().splitlines(newline='\n')

I guess I could live with that but it seems unnecessarily ugly and verbose for what is the most common usage.

----------

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

From report at bugs.python.org  Fri Oct  5 14:54:50 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 05 Oct 2018 18:54:50 +0000
Subject: [docs] [issue34839] doctest: Change example under warnings section
In-Reply-To: <1538180284.16.0.545547206417.issue34839@psf.upfronthosting.co.za>
Message-ID: <1538765690.79.0.545547206417.issue34839@psf.upfronthosting.co.za>


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

To me, the question is whether to delete the dict example, or qualify it with "Before 3.7 (or 3.6 for CPython)" but leave the illustration of workarounds. Raymond, what do you thing?

----------
nosy: +rhettinger, terry.reedy

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

From report at bugs.python.org  Fri Oct  5 14:59:03 2018
From: report at bugs.python.org (Tim Peters)
Date: Fri, 05 Oct 2018 18:59:03 +0000
Subject: [docs] [issue34839] doctest: Change example under warnings section
In-Reply-To: <1538180284.16.0.545547206417.issue34839@psf.upfronthosting.co.za>
Message-ID: <1538765943.66.0.545547206417.issue34839@psf.upfronthosting.co.za>


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

Add a comment along the lines you (Terry) suggested.  Some people need to write doctests that run under many versions of Python, so the info is still supremely relevant to them.

----------
nosy: +tim.peters

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

From report at bugs.python.org  Fri Oct  5 17:00:13 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 05 Oct 2018 21:00:13 +0000
Subject: [docs] [issue34895] Mark optional stdlib modules in documentation
In-Reply-To: <1538670818.19.0.545547206417.issue34895@psf.upfronthosting.co.za>
Message-ID: <1538773213.75.0.545547206417.issue34895@psf.upfronthosting.co.za>


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

Some modules are marked 'unix-only' or 'windows-only'.  The Windows installer includes all dependencies unless one asks that tcl/tk, tkinter, IDLE, (and turtle?) not be installed.  I believe the situation is now similar on Mac.  Please give specific examples of doc you think is deficient.

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

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

From report at bugs.python.org  Fri Oct  5 17:14:33 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Fri, 05 Oct 2018 21:14:33 +0000
Subject: [docs] [issue34839] doctest: Change example under warnings section
In-Reply-To: <1538180284.16.0.545547206417.issue34839@psf.upfronthosting.co.za>
Message-ID: <1538774073.23.0.545547206417.issue34839@psf.upfronthosting.co.za>


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

Thanks for the discussion.  I'll mark this as 'easy' for a first-time contribution.

----------
keywords: +easy
stage:  -> needs patch

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

From report at bugs.python.org  Fri Oct  5 17:29:50 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 05 Oct 2018 21:29:50 +0000
Subject: [docs] [issue34839] doctest: Change example under warnings section
In-Reply-To: <1538180284.16.0.545547206417.issue34839@psf.upfronthosting.co.za>
Message-ID: <1538774989.98.0.545547206417.issue34839@psf.upfronthosting.co.za>


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

I am posting this on core-mentorship. If you want to do this, post here and submit the PR within a day.  I will do the merge is no-one else does.

----------
versions: +Python 3.7

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

From report at bugs.python.org  Fri Oct  5 17:43:57 2018
From: report at bugs.python.org (Lysandros Nikolaou)
Date: Fri, 05 Oct 2018 21:43:57 +0000
Subject: [docs] [issue34839] doctest: Change example under warnings section
In-Reply-To: <1538180284.16.0.545547206417.issue34839@psf.upfronthosting.co.za>
Message-ID: <1538775837.76.0.545547206417.issue34839@psf.upfronthosting.co.za>


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

I would be happy to change this. I will submit a PR ASAP.

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

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

From report at bugs.python.org  Fri Oct  5 18:57:07 2018
From: report at bugs.python.org (Alexander Belopolsky)
Date: Fri, 05 Oct 2018 22:57:07 +0000
Subject: [docs] [issue34158] Documentation of datetime '%z' format code is
 odd
In-Reply-To: <1532036087.85.0.56676864532.issue34158@psf.upfronthosting.co.za>
Message-ID: <1538780226.98.0.545547206417.issue34158@psf.upfronthosting.co.za>


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


New changeset 92878829c31ab2fc71c60555ce87a5f6cbc876f0 by Alexander Belopolsky (Christophe Nanteuil) in branch 'master':
bpo-34158: Documentation UTC offset update (GH-8377)
https://github.com/python/cpython/commit/92878829c31ab2fc71c60555ce87a5f6cbc876f0


----------
nosy: +belopolsky

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

From report at bugs.python.org  Fri Oct  5 18:57:13 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 05 Oct 2018 22:57:13 +0000
Subject: [docs] [issue34158] Documentation of datetime '%z' format code is
 odd
In-Reply-To: <1532036087.85.0.56676864532.issue34158@psf.upfronthosting.co.za>
Message-ID: <1538780233.94.0.668975606942.issue34158@psf.upfronthosting.co.za>


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


----------
pull_requests: +9118

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

From report at bugs.python.org  Fri Oct  5 19:44:31 2018
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 05 Oct 2018 23:44:31 +0000
Subject: [docs] [issue34903] strptime %d handling of single digit day of
 month
In-Reply-To: <1538724686.61.0.545547206417.issue34903@psf.upfronthosting.co.za>
Message-ID: <1538783071.51.0.545547206417.issue34903@psf.upfronthosting.co.za>


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

So the documentation reads that way because it was originally written for strftime and has been repurposed to represent both. If the code does the right thing then adding a note that strptime supports single digits accurately would probably be a welcome pull request!

----------
nosy: +brett.cannon

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

From report at bugs.python.org  Fri Oct  5 22:44:29 2018
From: report at bugs.python.org (Ned Deily)
Date: Sat, 06 Oct 2018 02:44:29 +0000
Subject: [docs] [issue34158] Documentation of datetime '%z' format code is
 odd
In-Reply-To: <1532036087.85.0.56676864532.issue34158@psf.upfronthosting.co.za>
Message-ID: <1538793869.34.0.545547206417.issue34158@psf.upfronthosting.co.za>


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


New changeset 0991b9bb94036e0f271d223c8db7d81980c76736 by Ned Deily (Miss Islington (bot)) in branch '3.7':
[3.7] bpo-34158: Documentation UTC offset update (GH-8377) (GH-9732)
https://github.com/python/cpython/commit/0991b9bb94036e0f271d223c8db7d81980c76736


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

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

From report at bugs.python.org  Fri Oct  5 22:50:56 2018
From: report at bugs.python.org (Ned Deily)
Date: Sat, 06 Oct 2018 02:50:56 +0000
Subject: [docs] [issue33729] Hashlib/blake2* missing 'data' keyword argument
In-Reply-To: <1527842171.52.0.682650639539.issue33729@psf.upfronthosting.co.za>
Message-ID: <1538794255.99.0.545547206417.issue33729@psf.upfronthosting.co.za>


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

What's the status of this issue for 3.7 and for 3.6?  Is everyone OK with what is currently in 3.7, i.e. no revert needed or has it already been reverted elsewhere?  Also, there is the open PR for 3.6.

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

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

From report at bugs.python.org  Sat Oct  6 01:12:25 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Sat, 06 Oct 2018 05:12:25 +0000
Subject: [docs] [issue34839] doctest: Change example under warnings section
In-Reply-To: <1538180284.16.0.545547206417.issue34839@psf.upfronthosting.co.za>
Message-ID: <1538802745.59.0.545547206417.issue34839@psf.upfronthosting.co.za>


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

Hi Terry,

You say we need to keep this illustration with a section 'before 3.6' but in think it's a bad thing.

1. when you read a documentation, you just copy the example, and sometimes you don't read the requirements.
2. why do we need to keep an illustration for a previous version of Python? since >= 3.6 we keep the order (officially in 3.7), in this case, the example is useless, because you read the documentation of >= 3.7.

I would prefer to remove this example for >= 3.6 and keep the illustration for the previous version.

I am really interested by the feedback of Tim, Cheryl and Raymond.

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

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

From report at bugs.python.org  Sat Oct  6 01:13:33 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Sat, 06 Oct 2018 05:13:33 +0000
Subject: [docs] [issue34839] doctest: Change example under warnings section
In-Reply-To: <1538180284.16.0.545547206417.issue34839@psf.upfronthosting.co.za>
Message-ID: <1538802813.91.0.545547206417.issue34839@psf.upfronthosting.co.za>


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

> Raymond, what do you think?

I concur with Tim.

----------

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

From report at bugs.python.org  Sat Oct  6 01:15:12 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Sat, 06 Oct 2018 05:15:12 +0000
Subject: [docs] [issue34839] doctest: Change example under warnings section
In-Reply-To: <1538180284.16.0.545547206417.issue34839@psf.upfronthosting.co.za>
Message-ID: <1538802912.48.0.545547206417.issue34839@psf.upfronthosting.co.za>


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

FWIW, set objects are still unordered, so they too require sorting for a reproducible doctest.

----------

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

From report at bugs.python.org  Sat Oct  6 01:20:12 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Sat, 06 Oct 2018 05:20:12 +0000
Subject: [docs] [issue34839] doctest: Change example under warnings section
In-Reply-To: <1538180284.16.0.545547206417.issue34839@psf.upfronthosting.co.za>
Message-ID: <1538803212.55.0.668975606942.issue34839@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Oct  6 01:21:17 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Sat, 06 Oct 2018 05:21:17 +0000
Subject: [docs] [issue34839] doctest: Change example under warnings section
In-Reply-To: <1538180284.16.0.545547206417.issue34839@psf.upfronthosting.co.za>
Message-ID: <1538803277.35.0.545547206417.issue34839@psf.upfronthosting.co.za>


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

Hi Raymond,

Ok, if you agree with Tim, I just created a PR. 

Have a nice day,

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

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

From report at bugs.python.org  Sat Oct  6 01:27:28 2018
From: report at bugs.python.org (Tim Peters)
Date: Sat, 06 Oct 2018 05:27:28 +0000
Subject: [docs] [issue34839] doctest: Change example under warnings section
In-Reply-To: <1538180284.16.0.545547206417.issue34839@psf.upfronthosting.co.za>
Message-ID: <1538803648.03.0.545547206417.issue34839@psf.upfronthosting.co.za>


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

Stephane, it's not deep.  People who need to write doctests that work across N versions of Python shouldn't need to read N versions of the documentation.  This is hardly unique to doctest.  We routinely add "Changed in version m.n" blurbs all over the place.

Ways that were _necessary_ for robust dict testing continue to work fine in 3.6 and 3.7, so it doesn't harm anything if people mindlessly copy an example that _could_ be spelled some other way under 3.6+.  It's not like there's even anything slightly obscure about, e.g.,

>>> foo() == {"Hermione": "hippogryph", "Harry": "broomstick"}
True

----------

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

From report at bugs.python.org  Sat Oct  6 01:37:42 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Sat, 06 Oct 2018 05:37:42 +0000
Subject: [docs] [issue34839] doctest: Change example under warnings section
In-Reply-To: <1538180284.16.0.545547206417.issue34839@psf.upfronthosting.co.za>
Message-ID: <1538804262.23.0.545547206417.issue34839@psf.upfronthosting.co.za>


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

Tim,

I understand. It's just my experience, I have seen a lot of new comers (in my python trainings), they just copy the examples and don't read the total explanation. sometimes, because english is not their native language and in this case, they try to find an example, copy/paste and run it and when there is an exception, they will try to read the doc.

so, I have pushed a PR, I just changed sentences, I am waiting for your suggestions.

Thank you for your explanation.

----------

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

From report at bugs.python.org  Sat Oct  6 02:09:25 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Sat, 06 Oct 2018 06:09:25 +0000
Subject: [docs] [issue34903] strptime %d handling of single digit day of
 month
In-Reply-To: <1538724686.61.0.545547206417.issue34903@psf.upfronthosting.co.za>
Message-ID: <1538806165.27.0.545547206417.issue34903@psf.upfronthosting.co.za>


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

In addition to %d there are also other items that support single digit though zero padding is mentioned with strptime as below in the context of strftime : 

>>> import datetime
>>> datetime.datetime.strptime("1/1/2018 1:1:1", "%d/%m/%Y %I:%M:%S")
datetime.datetime(2018, 1, 1, 1, 1, 1)


>>> datetime.datetime.strftime(datetime.datetime(year=2018, month=1, day=1, hour=1, second=1, minute=1), "%d/%m/%Y %I:%M:%S")
'01/01/2018 01:01:01'

I couldn't find exact set of words that can be used to denote that zero padding is optional in strptime and it's returned as zero padded in strftime but if we are changing %d then I propose changing other items too with similar wording.

Thanks

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

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

From report at bugs.python.org  Sat Oct  6 03:06:04 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Sat, 06 Oct 2018 07:06:04 +0000
Subject: [docs] [issue34913] Document gzip command line interface
Message-ID: <1538809564.11.0.545547206417.issue34913@psf.upfronthosting.co.za>


New submission from Karthikeyan Singaravelan <tir.karthi at gmail.com>:

gzip supports command line interface with `python -m gzip` like zipfile and tarfile but there is no help available from the command line which can be covered when issue23596 is merged that uses argparse along with tests for which are also lacking at the moment. There can be at least docs about command line arguments at https://docs.python.org/3/library/gzip.html. Currently there is no way to know how the command line interface works for gzip without looking at the source code.

----------
assignee: docs at python
components: Documentation
messages: 327230
nosy: docs at python, xtreak
priority: normal
severity: normal
status: open
title: Document gzip command line interface
versions: Python 3.8

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

From report at bugs.python.org  Sat Oct  6 03:51:27 2018
From: report at bugs.python.org (Vinodhini)
Date: Sat, 06 Oct 2018 07:51:27 +0000
Subject: [docs] [issue29341] Missing accepting path-like object in
 docstrings of os module functions
In-Reply-To: <1485064061.59.0.597221589705.issue29341@psf.upfronthosting.co.za>
Message-ID: <1538812287.63.0.545547206417.issue29341@psf.upfronthosting.co.za>


Vinodhini <me.vinob at gmail.com> added the comment:

This is now carried forward in 3.8 also. Is anyone working on this issue ?
It needs to be corrected in doc-string for all method where its applicable

----------
nosy: +Vinu2003

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

From report at bugs.python.org  Sat Oct  6 04:06:57 2018
From: report at bugs.python.org (Nick Coghlan)
Date: Sat, 06 Oct 2018 08:06:57 +0000
Subject: [docs] [issue34914] Clarify text encoding used to enable UTF-8 mode
Message-ID: <1538813217.24.0.545547206417.issue34914@psf.upfronthosting.co.za>


New submission from Nick Coghlan <ncoghlan at gmail.com>:

While working on the docs updates for bpo-34589 (clarifying that "PYTHONCOERCECLOCALE=0" and "PYTHONCOERCELOCALE=warn" need both the environment variable name and the value to be encoded as ASCII in order to have any effect), I realised that it was less explicit how to reliably enable UTF-8 mode, since that can be enabled even when the current locale is a nominally ASCII-incompatible one like gb18030, and the command line settings get processed as wchar strings rather than 8-bit char strings.

>From what I've been able to figure out, the environment variable case is the same as for locale coercion: both the environment variable name and the value need to be encoded as ASCII. This actually happens implicitly, as even encodings like gb18030 still encode ASCII letters and numbers the same way ASCII does - their incompatibilities with ASCII lie elsewhere. Fully incompatible encodings like UTF-16 and UTF-32 don't get used as locale encodings in the first place because they'd break too many applications.

I believe the same holds true for the command line arguments, just in the other direction: they get converted to wchar* with either mbstowcs or mrbtowc, and then compared using wcscmp or wcsncmp, but for all encodings that actually get used as locale encodings, the ASCII code points that CPython cares about get mapped directly to the corresponding UTF-16-LE or UTF-32 code point at both compile time (in the code) and at runtime (when reading the arg string).

Given that simply not thinking about the problem will actually do the right thing in all cases, I don't think this needs to be documented prominently, but I do think it would be good to explicitly address the point somewhere.

----------
assignee: docs at python
components: Documentation
messages: 327236
nosy: docs at python, eric.snow, ncoghlan, vstinner
priority: low
severity: normal
stage: needs patch
status: open
title: Clarify text encoding used to enable UTF-8 mode
type: enhancement
versions: Python 3.7, Python 3.8

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

From report at bugs.python.org  Sat Oct  6 04:56:27 2018
From: report at bugs.python.org (Mike Gleen)
Date: Sat, 06 Oct 2018 08:56:27 +0000
Subject: [docs] [issue34903] strptime %d handling of single digit day of
 month
In-Reply-To: <1538806165.27.0.545547206417.issue34903@psf.upfronthosting.co.za>
Message-ID: <CAAap01JRCdYtQsQVwBn6ZhxUgHgQa4_SQAGprPEuJKZJzRucuw@mail.gmail.com>


Mike Gleen <mike.gleen at gmail.com> added the comment:

Thanks for the quick response. I would be happy to write a pull request for
the doc change. I've never done this before so it'll take a little while to
get my head around the process, but the "Helping with Documentation"
chapter seems good.

Mike

On Sat, Oct 6, 2018 at 7:09 AM Karthikeyan Singaravelan <
report at bugs.python.org> wrote:

>
> Karthikeyan Singaravelan <tir.karthi at gmail.com> added the comment:
>
> In addition to %d there are also other items that support single digit
> though zero padding is mentioned with strptime as below in the context of
> strftime :
>
> >>> import datetime
> >>> datetime.datetime.strptime("1/1/2018 1:1:1", "%d/%m/%Y %I:%M:%S")
> datetime.datetime(2018, 1, 1, 1, 1, 1)
>
>
> >>> datetime.datetime.strftime(datetime.datetime(year=2018, month=1,
> day=1, hour=1, second=1, minute=1), "%d/%m/%Y %I:%M:%S")
> '01/01/2018 01:01:01'
>
> I couldn't find exact set of words that can be used to denote that zero
> padding is optional in strptime and it's returned as zero padded in
> strftime but if we are changing %d then I propose changing other items too
> with similar wording.
>
> Thanks
>
> ----------
> nosy: +xtreak
>
> _______________________________________
> Python tracker <report at bugs.python.org>
> <https://bugs.python.org/issue34903>
> _______________________________________
>

----------

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

From report at bugs.python.org  Sat Oct  6 05:05:47 2018
From: report at bugs.python.org (Anthony Flury)
Date: Sat, 06 Oct 2018 09:05:47 +0000
Subject: [docs] [issue34891] Multi-processing example inaccurate warning
In-Reply-To: <1538649606.04.0.545547206417.issue34891@psf.upfronthosting.co.za>
Message-ID: <1538816747.49.0.545547206417.issue34891@psf.upfronthosting.co.za>


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

An example that does work : 

    $ python3

      Python 3.6.6 (default, Sep 12 2018, 18:26:19) 
      [GCC 8.0.1 20180414 (experimental) [trunk revision 259383]] on linux
      Type "help", "copyright", "credits" or "license" for more information.

      >>> from multiprocessing import Pool
      >>> def f(x): 
      ...     return x**2
      ...
      >>> with Pool(10) as p:
      ...     print(p.map(f, range(1,10)))
      [1, 4, 9, 16, 25, 36, 49, 64, 81]

So something about having Pool as a context manager means it works - very odd then.

BTW - with the exception of the example saying 'don't do this it doesn't work', none of the examples on the page are shown on the command line interpreter; but the first example uses a Pool context manager - which works as above.

----------

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

From report at bugs.python.org  Sat Oct  6 07:49:15 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Sat, 06 Oct 2018 11:49:15 +0000
Subject: [docs] [issue34848] range.index only takes one argument when it's
 documented as taking the usual 3
In-Reply-To: <1538279738.27.0.545547206417.issue34848@psf.upfronthosting.co.za>
Message-ID: <1538826555.03.0.668975606942.issue34848@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Oct  6 08:03:47 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 06 Oct 2018 12:03:47 +0000
Subject: [docs] [issue34848] range.index only takes one argument when it's
 documented as taking the usual 3
In-Reply-To: <1538279738.27.0.545547206417.issue34848@psf.upfronthosting.co.za>
Message-ID: <1538827427.35.0.545547206417.issue34848@psf.upfronthosting.co.za>


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

One bug or feature request per issue please. If you want to change list.index() or operator.indexOf(), open new issues for this. This issue is for the error in the range.index() docstring.

----------

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

From report at bugs.python.org  Sat Oct  6 10:30:54 2018
From: report at bugs.python.org (Steve Dower)
Date: Sat, 06 Oct 2018 14:30:54 +0000
Subject: [docs] [issue32174] nonASCII punctuation characters can not display
 in python363.chm.
In-Reply-To: <1512013530.29.0.213398074469.issue32174@psf.upfronthosting.co.za>
Message-ID: <1538836254.3.0.545547206417.issue32174@psf.upfronthosting.co.za>


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

Until someone creates and enables a Sphinx extension/option to only generate ASCII output, it will remain. Volunteers are welcome

----------

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

From report at bugs.python.org  Sat Oct  6 11:47:30 2018
From: report at bugs.python.org (Vinodhini)
Date: Sat, 06 Oct 2018 15:47:30 +0000
Subject: [docs] [issue32995] Add a glossary entry for context variables
In-Reply-To: <1520244692.22.0.467229070634.issue32995@psf.upfronthosting.co.za>
Message-ID: <1538840850.41.0.668975606942.issue32995@psf.upfronthosting.co.za>


Change by Vinodhini <me.vinob at gmail.com>:


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

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

From report at bugs.python.org  Sat Oct  6 12:53:10 2018
From: report at bugs.python.org (Vinodhini)
Date: Sat, 06 Oct 2018 16:53:10 +0000
Subject: [docs] [issue32995] Add a glossary entry for context variables
In-Reply-To: <1520244692.22.0.467229070634.issue32995@psf.upfronthosting.co.za>
Message-ID: <1538844790.69.0.668975606942.issue32995@psf.upfronthosting.co.za>


Change by Vinodhini <me.vinob at gmail.com>:


----------
pull_requests: +9130

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

From report at bugs.python.org  Sat Oct  6 13:52:13 2018
From: report at bugs.python.org (Christian Heimes)
Date: Sat, 06 Oct 2018 17:52:13 +0000
Subject: [docs] [issue33729] Hashlib/blake2* missing 'data' keyword argument
In-Reply-To: <1527842171.52.0.682650639539.issue33729@psf.upfronthosting.co.za>
Message-ID: <1538848333.4.0.545547206417.issue33729@psf.upfronthosting.co.za>


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

Ned, I'm currently travelling until next weekend. The PR is rather large and I don't have any means or time to review it properly. Perhaps Gregory or Dmitry Chestnykh (original author of pyblake2) are able to assist.

----------
nosy: +gregory.p.smith

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

From report at bugs.python.org  Sat Oct  6 17:48:10 2018
From: report at bugs.python.org (Paul Hoffman)
Date: Sat, 06 Oct 2018 21:48:10 +0000
Subject: [docs] [issue30588] Missing documentation for codecs.escape_decode
In-Reply-To: <1496847775.57.0.842403144977.issue30588@psf.upfronthosting.co.za>
Message-ID: <1538862490.25.0.545547206417.issue30588@psf.upfronthosting.co.za>


Paul Hoffman <phoffman at proper.com> added the comment:

Bumping this thread a bit. It appears that this "internal" function is being talked about out in the real world. I came across it in a recent blog post, saw that it wasn't in the official documentation, and went looking here.

I propose that it be documented even if it feels like a tad of a kludge.

----------
nosy: +paulehoffman

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

From report at bugs.python.org  Sun Oct  7 01:46:19 2018
From: report at bugs.python.org (Caleb Hattingh)
Date: Sun, 07 Oct 2018 05:46:19 +0000
Subject: [docs] [issue34831] Asyncio Tutorial
In-Reply-To: <1538134577.09.0.545547206417.issue34831@psf.upfronthosting.co.za>
Message-ID: <1538891178.94.0.545547206417.issue34831@psf.upfronthosting.co.za>


Caleb Hattingh <caleb.hattingh at gmail.com> added the comment:

A CLI client is a necessary step along the way anyway, so that sounds good by me.

You suggested:

> I'd organize the tutorial in a dedicated directory like "Doc/library/asyncio-tutorial/" 

I had a look at the source tree, there is an existing "howto" directory; do you still prefer your suggestion of using "Doc/library/" over something like "Doc/howto/asyncio.rst"?

----------

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

From report at bugs.python.org  Sun Oct  7 02:03:54 2018
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 07 Oct 2018 06:03:54 +0000
Subject: [docs] [issue34903] strptime %d handling of single digit day of
 month
In-Reply-To: <1538724686.61.0.545547206417.issue34903@psf.upfronthosting.co.za>
Message-ID: <1538892234.5.0.668975606942.issue34903@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sun Oct  7 03:58:25 2018
From: report at bugs.python.org (Andrew Svetlov)
Date: Sun, 07 Oct 2018 07:58:25 +0000
Subject: [docs] [issue30588] Missing documentation for codecs.escape_decode
In-Reply-To: <1496847775.57.0.842403144977.issue30588@psf.upfronthosting.co.za>
Message-ID: <1538899105.25.0.545547206417.issue30588@psf.upfronthosting.co.za>


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

-1
Internal function means: you can use it on your risk but the function can be changed or even removed in any Python release.
I see no point in documenting and making it public.

----------
nosy: +asvetlov

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

From report at bugs.python.org  Sun Oct  7 04:49:54 2018
From: report at bugs.python.org (Steven D'Aprano)
Date: Sun, 07 Oct 2018 08:49:54 +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: <1538902193.95.0.545547206417.issue22232@psf.upfronthosting.co.za>


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

I don't like the idea of adding a second bool parameter to splitlines. Guido has a rough rule of thumb (which I agree with) of "no constant bool parameters". If people will typically call a function with some sort of "mode" parameter using a hard-coded bool, then we should usually prefer to split the two modes into distinct functions.

As an example, we have statistics.stdev and pstdev rather than stdev(data, population=False).

Obviously this is a guideline, not a hard rule, and there are exceptions. Such as str.splitlines :-)

In any case, I suggest a separate string method. Even though the name is slightly inaccurate, I suggest "ascii_splitlines" which I think is accurate enough to capture the spirit of what we intend (split on *only* \n \r and \r\n) and we can leave the details in the docs.

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

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

From report at bugs.python.org  Sun Oct  7 06:25:37 2018
From: report at bugs.python.org (Caleb Hattingh)
Date: Sun, 07 Oct 2018 10:25:37 +0000
Subject: [docs] [issue34831] Asyncio Tutorial
In-Reply-To: <1538134577.09.0.545547206417.issue34831@psf.upfronthosting.co.za>
Message-ID: <1538907937.92.0.668975606942.issue34831@psf.upfronthosting.co.za>


Change by Caleb Hattingh <caleb.hattingh at gmail.com>:


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

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

From report at bugs.python.org  Sun Oct  7 06:29:07 2018
From: report at bugs.python.org (Caleb Hattingh)
Date: Sun, 07 Oct 2018 10:29:07 +0000
Subject: [docs] [issue34831] Asyncio Tutorial
In-Reply-To: <1538134577.09.0.545547206417.issue34831@psf.upfronthosting.co.za>
Message-ID: <1538908146.95.0.545547206417.issue34831@psf.upfronthosting.co.za>


Caleb Hattingh <caleb.hattingh at gmail.com> added the comment:

I set up a basic structure under "Doc/library/asyncio-tutorial" as suggested, and opened a PR to show you how that looks. When I make
more progress on a section, I'll post an update here.

----------

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

From report at bugs.python.org  Sun Oct  7 07:31:35 2018
From: report at bugs.python.org (Danish Prakash)
Date: Sun, 07 Oct 2018 11:31:35 +0000
Subject: [docs] [issue34901] Missing isolated (-I) flag in sys.flags table
In-Reply-To: <1538718824.99.0.545547206417.issue34901@psf.upfronthosting.co.za>
Message-ID: <1538911895.55.0.545547206417.issue34901@psf.upfronthosting.co.za>


Danish Prakash <grafitykoncept at gmail.com> added the comment:

Thanks for the concise explanation, that makes sense.

> Also there will be no binary releases and only source releases for security only branches.

Is there any particular reason as to why this happens? IS it just to make it easier for the team to focus on the development of current versions or something else?

----------

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

From report at bugs.python.org  Sun Oct  7 07:48:20 2018
From: report at bugs.python.org (Caleb Hattingh)
Date: Sun, 07 Oct 2018 11:48:20 +0000
Subject: [docs] [issue34831] Asyncio Tutorial
In-Reply-To: <1538134577.09.0.545547206417.issue34831@psf.upfronthosting.co.za>
Message-ID: <1538912900.78.0.545547206417.issue34831@psf.upfronthosting.co.za>


Caleb Hattingh <caleb.hattingh at gmail.com> added the comment:

I tested the Python 3.7.0 release version for Mac, the download called "macOS 64-bit installer" with checksum ae0717a02efea3b0eb34aadc680dc498 on this page:

https://www.python.org/downloads/release/python-370/

I downloaded, installed that on a mac, and the chat client app launched no problem. (I added a screenshot to my github repo readme).

Your error "ModuleNotFoundError: No module named '_tkinter'" suggests that the python you were using is a different one, because in the release download, Tk 8.6.8 is bundled and the _tkinter module was built against it and must exist.

Anyway, I just wanted to check that it does work on mac :)

----------

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

From report at bugs.python.org  Sun Oct  7 12:18:22 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 07 Oct 2018 16:18:22 +0000
Subject: [docs] [issue34901] Missing isolated (-I) flag in sys.flags table
In-Reply-To: <1538718824.99.0.545547206417.issue34901@psf.upfronthosting.co.za>
Message-ID: <1538929102.0.0.668975606942.issue34901@psf.upfronthosting.co.za>


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


----------
pull_requests: +9135

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

From report at bugs.python.org  Sun Oct  7 12:18:24 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 07 Oct 2018 16:18:24 +0000
Subject: [docs] [issue34901] Missing isolated (-I) flag in sys.flags table
In-Reply-To: <1538718824.99.0.545547206417.issue34901@psf.upfronthosting.co.za>
Message-ID: <1538929104.08.0.545547206417.issue34901@psf.upfronthosting.co.za>


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


New changeset c59e75ccf0ea8d882738214e0385f41eed51e3c7 by Miss Islington (bot) in branch '3.7':
bpo-34901: add isolated (-I) flag to sys.flags (GH-9708)
https://github.com/python/cpython/commit/c59e75ccf0ea8d882738214e0385f41eed51e3c7


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

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

From report at bugs.python.org  Sun Oct  7 12:31:16 2018
From: report at bugs.python.org (Ned Deily)
Date: Sun, 07 Oct 2018 16:31:16 +0000
Subject: [docs] [issue34831] Asyncio Tutorial
In-Reply-To: <1538134577.09.0.545547206417.issue34831@psf.upfronthosting.co.za>
Message-ID: <1538929876.89.0.545547206417.issue34831@psf.upfronthosting.co.za>


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

Yury, based on the file paths, you appear to be running a MacPorts python3.7.  Like many other third-party distributors (but unlike the python.org installers), MacPorts separates Tkinter support into a separately-installable component.  Try:

port install py37-tkinter

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

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

From report at bugs.python.org  Sun Oct  7 12:33:51 2018
From: report at bugs.python.org (Yury Selivanov)
Date: Sun, 07 Oct 2018 16:33:51 +0000
Subject: [docs] [issue34831] Asyncio Tutorial
In-Reply-To: <1538134577.09.0.545547206417.issue34831@psf.upfronthosting.co.za>
Message-ID: <1538930031.92.0.545547206417.issue34831@psf.upfronthosting.co.za>


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

> Yury, based on the file paths, you appear to be running a MacPorts python3.7.  Like many other third-party distributors (but unlike the python.org installers), MacPorts separates Tkinter support into a separately-installable component.  Try:


Thanks, Ned!  Yeah, I know why my python37 doesn't have Tk and how to fix it.  It's just I don't think the tutorial should require some component that we know is missing when python is installed through certain channels (with default flags/config).

----------

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

From report at bugs.python.org  Sun Oct  7 12:42:16 2018
From: report at bugs.python.org (Ned Deily)
Date: Sun, 07 Oct 2018 16:42:16 +0000
Subject: [docs] [issue33729] Hashlib/blake2* missing 'data' keyword argument
In-Reply-To: <1527842171.52.0.682650639539.issue33729@psf.upfronthosting.co.za>
Message-ID: <1538930536.28.0.545547206417.issue33729@psf.upfronthosting.co.za>


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

OK. This is now blocking the release of 3.7.1rc2 and 3.6.7rc2.  See also Issue34922.

----------
priority: normal -> release blocker

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

From report at bugs.python.org  Sun Oct  7 14:01:17 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Sun, 07 Oct 2018 18:01:17 +0000
Subject: [docs] [issue34901] Missing isolated (-I) flag in sys.flags table
In-Reply-To: <1538718824.99.0.545547206417.issue34901@psf.upfronthosting.co.za>
Message-ID: <1538935277.4.0.545547206417.issue34901@psf.upfronthosting.co.za>


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

>> Also there will be no binary releases and only source releases for security only branches.

> Is there any particular reason as to why this happens? IS it just to make it easier for the team to focus on the development of current versions or something else?

Sorry, I don't have a better explanation over the workflow.

----------

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

From report at bugs.python.org  Sun Oct  7 15:08:07 2018
From: report at bugs.python.org (Ned Deily)
Date: Sun, 07 Oct 2018 19:08:07 +0000
Subject: [docs] [issue33729] Hashlib/blake2* missing 'data' keyword argument
In-Reply-To: <1527842171.52.0.682650639539.issue33729@psf.upfronthosting.co.za>
Message-ID: <1538939287.75.0.545547206417.issue33729@psf.upfronthosting.co.za>


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

The question remains if Christian's and Victor's concern with 3.7 compatibility have been satisfied by Serihy's response in msg322798. While there is plenty of time to resolve concerns about what was merged into master by PR 8346, we shouldn't release the PR 8581 changes in 3.7.1 if there are still valid compatibility concerns.  Since PR 9657 for 3.6 hasn't been reviewed or merged, the only pressing issue for 3.6.7 is ensuring the segfault documented in Issue34922 is blocked, correct?  And PR 8581 prevents the segfault for 3.7 so we would only need a similar fix for it if the PR were reverted, correct?

----------

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

From report at bugs.python.org  Sun Oct  7 15:37:01 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 07 Oct 2018 19:37:01 +0000
Subject: [docs] [issue33729] Hashlib/blake2* missing 'data' keyword argument
In-Reply-To: <1527842171.52.0.682650639539.issue33729@psf.upfronthosting.co.za>
Message-ID: <1538941021.27.0.545547206417.issue33729@psf.upfronthosting.co.za>


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

I have reviewed PR 8346 yet one time. No documented working behavior was changed. Some documentation was updated to match the code, some code was updated to match the documentation, and other minor errors were fixed. I don't think this change breaks compatibility.

----------

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

From report at bugs.python.org  Sun Oct  7 15:40:47 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 07 Oct 2018 19:40:47 +0000
Subject: [docs] [issue33729] Hashlib/blake2* missing 'data' keyword argument
In-Reply-To: <1527842171.52.0.682650639539.issue33729@psf.upfronthosting.co.za>
Message-ID: <1538941247.48.0.545547206417.issue33729@psf.upfronthosting.co.za>


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

Other variant of the crash in issue34922 still is reproducible in 3.7.

----------

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

From report at bugs.python.org  Sun Oct  7 16:48:13 2018
From: report at bugs.python.org (Neil Schemenauer)
Date: Sun, 07 Oct 2018 20:48:13 +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: <1538945293.62.0.545547206417.issue22232@psf.upfronthosting.co.za>


Neil Schemenauer <nas-python at arctrix.com> added the comment:

I too would prefer a new method name rather than overloading splitlines() with more keyword args (passed as hardcoded constants, usually).  Again, I think we want:

list(open(..).read().<splitmethod>()) == list(open(..))

readlines() returns a list but I think this method should return an iterator (seems more Python 3 like to me, call list if you want a list).  In that case, iterlines() seems like the right name to me.  I think it should take a 'newline' keyword that behaves the same as the open() version of the keyword.

----------

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

From report at bugs.python.org  Mon Oct  8 02:24:01 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Mon, 08 Oct 2018 06:24:01 +0000
Subject: [docs] [issue34817] Ellipsis docs has extra dot in the markdown
 that makes it look like .... (four dots)
In-Reply-To: <1538032499.31.0.545547206417.issue34817@psf.upfronthosting.co.za>
Message-ID: <1538979841.52.0.668975606942.issue34817@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Mon Oct  8 02:26:42 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Mon, 08 Oct 2018 06:26:42 +0000
Subject: [docs] [issue34817] Ellipsis docs has extra dot in the markdown
 that makes it look like .... (four dots)
In-Reply-To: <1538032499.31.0.545547206417.issue34817@psf.upfronthosting.co.za>
Message-ID: <1538980002.63.0.545547206417.issue34817@psf.upfronthosting.co.za>


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

Thanks Martin for the suggestion. I have created a PR with your suggestion and added a description in the PR that shows the visual distinction between the current doc and suggested change.

----------

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

From report at bugs.python.org  Mon Oct  8 02:53:38 2018
From: report at bugs.python.org (Carol Willing)
Date: Mon, 08 Oct 2018 06:53:38 +0000
Subject: [docs] [issue33014] Clarify str.isidentifier docstring;
 fix keyword.iskeyword docstring
In-Reply-To: <1520351440.06.0.467229070634.issue33014@psf.upfronthosting.co.za>
Message-ID: <1538981617.81.0.545547206417.issue33014@psf.upfronthosting.co.za>


Carol Willing <willingc at gmail.com> added the comment:


New changeset ffc5a14d00db984c8e72c7b67da8a493e17e2c14 by Carol Willing (Sanyam Khurana) in branch 'master':
bpo-33014: Clarify str.isidentifier docstring (GH-6088)
https://github.com/python/cpython/commit/ffc5a14d00db984c8e72c7b67da8a493e17e2c14


----------

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

From report at bugs.python.org  Mon Oct  8 05:33:46 2018
From: report at bugs.python.org (Marc Richter)
Date: Mon, 08 Oct 2018 09:33:46 +0000
Subject: [docs] [issue13828] Further improve casefold documentation
In-Reply-To: <1326992763.46.0.576190503242.issue13828@psf.upfronthosting.co.za>
Message-ID: <1538991226.32.0.545547206417.issue13828@psf.upfronthosting.co.za>


Marc Richter <marc.richter.1982 at googlemail.com> added the comment:

+1 as well.

To be honest, I did not understand what this function does in detail yet.
Since not too long ago (2017) in Germany, there was an uppercase-variant for the special letter from this function's example (?) been added to the official orthography [1].
Is this something that needs to be changed in this function's behavior now or stays this expected behavior? I'm still puzzled and I think the whole function should get a more clear description.

[1]: https://en.wikipedia.org/wiki/Capital_%E1%BA%9E

----------
nosy: +Marc Richter

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

From report at bugs.python.org  Mon Oct  8 05:38:44 2018
From: report at bugs.python.org (Ma Lin)
Date: Mon, 08 Oct 2018 09:38:44 +0000
Subject: [docs] [issue32174] nonASCII punctuation characters can not display
 in python363.chm.
In-Reply-To: <1512013530.29.0.213398074469.issue32174@psf.upfronthosting.co.za>
Message-ID: <1538991523.92.0.545547206417.issue32174@psf.upfronthosting.co.za>


Ma Lin <malincns at 163.com> added the comment:

I will create a PR to fix this within a day.

----------

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

From report at bugs.python.org  Mon Oct  8 06:27:07 2018
From: report at bugs.python.org (Lele Gaifax)
Date: Mon, 08 Oct 2018 10:27:07 +0000
Subject: [docs] [issue33014] Clarify str.isidentifier docstring;
 fix keyword.iskeyword docstring
In-Reply-To: <1520351440.06.0.467229070634.issue33014@psf.upfronthosting.co.za>
Message-ID: <1538994427.84.0.668975606942.issue33014@psf.upfronthosting.co.za>


Change by Lele Gaifax <lelegaifax at gmail.com>:


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

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

From report at bugs.python.org  Mon Oct  8 07:21:20 2018
From: report at bugs.python.org (Ma Lin)
Date: Mon, 08 Oct 2018 11:21:20 +0000
Subject: [docs] [issue32174] nonASCII punctuation characters can not display
 in python363.chm.
In-Reply-To: <1512013530.29.0.213398074469.issue32174@psf.upfronthosting.co.za>
Message-ID: <1538997680.47.0.668975606942.issue32174@psf.upfronthosting.co.za>


Change by Ma Lin <malincns at 163.com>:


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

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

From report at bugs.python.org  Mon Oct  8 07:43:56 2018
From: report at bugs.python.org (Ma Lin)
Date: Mon, 08 Oct 2018 11:43:56 +0000
Subject: [docs] [issue32174] nonASCII punctuation characters can not display
 in python363.chm.
In-Reply-To: <1512013530.29.0.213398074469.issue32174@psf.upfronthosting.co.za>
Message-ID: <1538999036.83.0.545547206417.issue32174@psf.upfronthosting.co.za>


Ma Lin <malincns at 163.com> added the comment:

It seems impossible to specify the encoding of .chm to ASCII [1], the available encodings of .chm are limited to a list [2].

So I wrote a Sphinx extension for .chm output, it escapes the characters which (codepoint > 0x7F) to 7-bit ASCII. Most escaped characters are: ??????

[1] https://github.com/sphinx-doc/sphinx/blob/master/sphinx/builders/htmlhelp.py#L203-L206
[2] https://github.com/sphinx-doc/sphinx/blob/master/sphinx/builders/htmlhelp.py#L136-L170

----------

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

From report at bugs.python.org  Mon Oct  8 08:20:00 2018
From: report at bugs.python.org (Ma Lin)
Date: Mon, 08 Oct 2018 12:20:00 +0000
Subject: [docs] [issue32174] nonASCII punctuation characters can not display
 in python363.chm.
In-Reply-To: <1512013530.29.0.213398074469.issue32174@psf.upfronthosting.co.za>
Message-ID: <1539001200.78.0.668975606942.issue32174@psf.upfronthosting.co.za>


Change by Ma Lin <malincns at 163.com>:


Added file: https://bugs.python.org/file47858/PR 9758 effects.png

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

From report at bugs.python.org  Mon Oct  8 10:59:35 2018
From: report at bugs.python.org (Brian Curtin)
Date: Mon, 08 Oct 2018 14:59:35 +0000
Subject: [docs] [issue13407] tarfile doesn't support multistream bzipped tar
 files
In-Reply-To: <1321352961.33.0.0944615995053.issue13407@psf.upfronthosting.co.za>
Message-ID: <1539010775.71.0.668975606942.issue13407@psf.upfronthosting.co.za>


Change by Brian Curtin <brian at python.org>:


----------
assignee: docs at python -> brian.curtin
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

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

From report at bugs.python.org  Mon Oct  8 11:08:14 2018
From: report at bugs.python.org (Paul Ganssle)
Date: Mon, 08 Oct 2018 15:08:14 +0000
Subject: [docs] [issue34903] strptime %d handling of single digit day of
 month
In-Reply-To: <1538724686.61.0.545547206417.issue34903@psf.upfronthosting.co.za>
Message-ID: <1539011294.75.0.668975606942.issue34903@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Mon Oct  8 11:28:17 2018
From: report at bugs.python.org (Sanyam Khurana)
Date: Mon, 08 Oct 2018 15:28:17 +0000
Subject: [docs] [issue33014] Clarify str.isidentifier docstring;
 fix keyword.iskeyword docstring
In-Reply-To: <1520351440.06.0.467229070634.issue33014@psf.upfronthosting.co.za>
Message-ID: <1539012497.86.0.545547206417.issue33014@psf.upfronthosting.co.za>


Sanyam Khurana <sanyam.khurana01 at gmail.com> added the comment:

Marking this fixed via https://github.com/python/cpython/commit/ffc5a14d00db984c8e72c7b67da8a493e17e2c14 and https://github.com/python/cpython/commit/fc8205cb4b87edd1c19e1bcc26deaa1570f87988

Thanks, everyone!

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

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

From report at bugs.python.org  Mon Oct  8 17:21:04 2018
From: report at bugs.python.org (Steve Dower)
Date: Mon, 08 Oct 2018 21:21:04 +0000
Subject: [docs] [issue32174] nonASCII punctuation characters can not display
 in python363.chm.
In-Reply-To: <1512013530.29.0.213398074469.issue32174@psf.upfronthosting.co.za>
Message-ID: <1539033664.25.0.545547206417.issue32174@psf.upfronthosting.co.za>


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


New changeset 6261ae9b01fb8429b779169f8de37ff567c144e8 by Steve Dower (animalize) in branch 'master':
bpo-32174: Let .chm document display non-ASCII characters properly (GH-9758)
https://github.com/python/cpython/commit/6261ae9b01fb8429b779169f8de37ff567c144e8


----------

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

From report at bugs.python.org  Mon Oct  8 17:21:19 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 08 Oct 2018 21:21:19 +0000
Subject: [docs] [issue32174] nonASCII punctuation characters can not display
 in python363.chm.
In-Reply-To: <1512013530.29.0.213398074469.issue32174@psf.upfronthosting.co.za>
Message-ID: <1539033679.54.0.668975606942.issue32174@psf.upfronthosting.co.za>


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


----------
pull_requests: +9148

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

From report at bugs.python.org  Mon Oct  8 17:21:26 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 08 Oct 2018 21:21:26 +0000
Subject: [docs] [issue32174] nonASCII punctuation characters can not display
 in python363.chm.
In-Reply-To: <1512013530.29.0.213398074469.issue32174@psf.upfronthosting.co.za>
Message-ID: <1539033686.14.0.668975606942.issue32174@psf.upfronthosting.co.za>


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


----------
pull_requests: +9149

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

From report at bugs.python.org  Mon Oct  8 17:21:26 2018
From: report at bugs.python.org (Steve Dower)
Date: Mon, 08 Oct 2018 21:21:26 +0000
Subject: [docs] [issue32174] nonASCII punctuation characters can not display
 in python363.chm.
In-Reply-To: <1512013530.29.0.213398074469.issue32174@psf.upfronthosting.co.za>
Message-ID: <1539033686.7.0.545547206417.issue32174@psf.upfronthosting.co.za>


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

Thanks, that looks perfect!

----------

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

From report at bugs.python.org  Mon Oct  8 17:26:49 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 08 Oct 2018 21:26:49 +0000
Subject: [docs] [issue32174] nonASCII punctuation characters can not display
 in python363.chm.
In-Reply-To: <1512013530.29.0.213398074469.issue32174@psf.upfronthosting.co.za>
Message-ID: <1539034009.72.0.545547206417.issue32174@psf.upfronthosting.co.za>


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


New changeset 64bcedce8d61e1daa9ff7980cc07988574049b1f by Miss Islington (bot) in branch '3.6':
bpo-32174: Let .chm document display non-ASCII characters properly (GH-9758)
https://github.com/python/cpython/commit/64bcedce8d61e1daa9ff7980cc07988574049b1f


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

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

From report at bugs.python.org  Mon Oct  8 17:26:58 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 08 Oct 2018 21:26:58 +0000
Subject: [docs] [issue32174] nonASCII punctuation characters can not display
 in python363.chm.
In-Reply-To: <1512013530.29.0.213398074469.issue32174@psf.upfronthosting.co.za>
Message-ID: <1539034018.68.0.545547206417.issue32174@psf.upfronthosting.co.za>


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


New changeset c4c86fad8024dc91af8d785c33187c092b4e49d9 by Miss Islington (bot) in branch '3.7':
bpo-32174: Let .chm document display non-ASCII characters properly (GH-9758)
https://github.com/python/cpython/commit/c4c86fad8024dc91af8d785c33187c092b4e49d9


----------

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

From report at bugs.python.org  Mon Oct  8 19:18:03 2018
From: report at bugs.python.org (Steve Dower)
Date: Mon, 08 Oct 2018 23:18:03 +0000
Subject: [docs] [issue32174] nonASCII punctuation characters can not display
 in python363.chm.
In-Reply-To: <1512013530.29.0.213398074469.issue32174@psf.upfronthosting.co.za>
Message-ID: <1539040683.65.0.668975606942.issue32174@psf.upfronthosting.co.za>


Change by Steve Dower <steve.dower at python.org>:


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

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

From report at bugs.python.org  Mon Oct  8 19:34:18 2018
From: report at bugs.python.org (Jack)
Date: Mon, 08 Oct 2018 23:34:18 +0000
Subject: [docs] [issue9694] argparse required arguments displayed under
 "optional arguments"
In-Reply-To: <1282846759.11.0.900867962743.issue9694@psf.upfronthosting.co.za>
Message-ID: <1539041658.08.0.545547206417.issue9694@psf.upfronthosting.co.za>


Jack <jackenneking at gmail.com> added the comment:

I'd like to note that this also happens with a required mutually exclusive group:

group = parser.add_mutually_exclusive_group(required=True)

The arguments in the group are listed under ?optional arguments:?.

I'm guessing the mechanism is the same.

----------
nosy: +Jacktose

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

From report at bugs.python.org  Tue Oct  9 06:06:51 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Tue, 09 Oct 2018 10:06:51 +0000
Subject: [docs] [issue34942] Add an FAQ note about floating point
 representation
Message-ID: <1539079611.42.0.545547206417.issue34942@psf.upfronthosting.co.za>


New submission from Karthikeyan Singaravelan <tir.karthi at gmail.com>:

There have been tickets raised due to floating point representation being misleading where "0.1 + 0.2" returns 0.30000000000000004 and "0.1 + 0.3" returns 0.4. This is explained at [0] but I think it's worth to add this as a question to FAQ and link to the tutorial and possibly to some external links like [1] and [2] so that the user can understand the limitation instead of assuming it's a bug in CPython. Searching for "floatingpoint.html" gives 64 issues [4] were the documentation was linked out of which 3 were reported in the past one month.

If there is also any other page where this can be linked to get better visibility then this could avoid a lot of confusion especially for beginners where "0.1 + 0.3" silently seems to work fine but "0.1 + 0.2" has a misleading representation along with variations in other floating point arithmetic operations making the user think it's a CPython bug.

Adding Raymond to see if it's worth adding it in FAQ or any other place and also that he might have more feedback on teaching users and wording this in a better way.

[0] https://docs.python.org/3/tutorial/floatingpoint.html
[1] https://docs.oracle.com/cd/E19957-01/806-3568/ncg_goldberg.html
[2] https://0.30000000000000004.com/
[4] https://bugs.python.org/issue?%40columns=id%2Cactivity%2Ctitle%2Ccreator%2Cassignee%2Cstatus%2Ctype&%40sort=-activity&%40filter=status&%40action=searchid&ignore=file%3Acontent&%40search_text=floatingpoint.html&submit=search&status=-1%2C1%2C2%2C3

----------
assignee: docs at python
components: Documentation
messages: 327390
nosy: docs at python, rhettinger, xtreak
priority: normal
severity: normal
status: open
title: Add an FAQ note about floating point representation
versions: Python 3.8

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

From report at bugs.python.org  Tue Oct  9 06:32:11 2018
From: report at bugs.python.org (Martin Panter)
Date: Tue, 09 Oct 2018 10:32:11 +0000
Subject: [docs] [issue34942] Add an FAQ note about floating point
 representation
In-Reply-To: <1539079611.42.0.545547206417.issue34942@psf.upfronthosting.co.za>
Message-ID: <1539081131.04.0.545547206417.issue34942@psf.upfronthosting.co.za>


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

Have you seen <https://docs.python.org/3/faq/design.html#why-are-floating-point-calculations-so-inaccurate>? It already links to the tutorial.

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

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

From report at bugs.python.org  Tue Oct  9 06:37:59 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Tue, 09 Oct 2018 10:37:59 +0000
Subject: [docs] [issue34942] Add an FAQ note about floating point
 representation
In-Reply-To: <1539079611.42.0.545547206417.issue34942@psf.upfronthosting.co.za>
Message-ID: <1539081478.95.0.545547206417.issue34942@psf.upfronthosting.co.za>


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

Thanks Martin, I was searching in the general and programming FAQ for this and did a general search with the link and nothing showed up in the bug tracker or search engine in FAQ. My bad, I will close this.

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

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

From report at bugs.python.org  Tue Oct  9 07:13:59 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 09 Oct 2018 11:13:59 +0000
Subject: [docs] [issue34942] Add an FAQ note about floating point
 representation
In-Reply-To: <1539079611.42.0.545547206417.issue34942@psf.upfronthosting.co.za>
Message-ID: <1539083639.87.0.668975606942.issue34942@psf.upfronthosting.co.za>


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


----------
resolution: fixed -> out of date

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

From report at bugs.python.org  Tue Oct  9 09:12:01 2018
From: report at bugs.python.org (Jeroen Demeyer)
Date: Tue, 09 Oct 2018 13:12:01 +0000
Subject: [docs] [issue25592] distutils docs: data_files always uses
 sys.prefix
In-Reply-To: <1447135572.7.0.138478279434.issue25592@psf.upfronthosting.co.za>
Message-ID: <1539090721.63.0.668975606942.issue25592@psf.upfronthosting.co.za>


Change by Jeroen Demeyer <J.Demeyer at UGent.be>:


----------
pull_requests: +9154

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

From report at bugs.python.org  Tue Oct  9 09:15:34 2018
From: report at bugs.python.org (Jeroen Demeyer)
Date: Tue, 09 Oct 2018 13:15:34 +0000
Subject: [docs] [issue25592] distutils docs: data_files always uses
 sys.prefix
In-Reply-To: <1447135572.7.0.138478279434.issue25592@psf.upfronthosting.co.za>
Message-ID: <1539090934.77.0.668975606942.issue25592@psf.upfronthosting.co.za>


Change by Jeroen Demeyer <J.Demeyer at UGent.be>:


Removed file: https://bugs.python.org/file40993/data_files_doc.patch

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

From report at bugs.python.org  Tue Oct  9 10:05:31 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 09 Oct 2018 14:05:31 +0000
Subject: [docs] [issue28234] In xml.etree.ElementTree docs there are many
 absent Element class links
In-Reply-To: <1474453668.8.0.0192177985612.issue28234@psf.upfronthosting.co.za>
Message-ID: <1539093931.89.0.668975606942.issue28234@psf.upfronthosting.co.za>


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


----------
pull_requests: +9156

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

From report at bugs.python.org  Tue Oct  9 10:10:19 2018
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Tue, 09 Oct 2018 14:10:19 +0000
Subject: [docs] [issue25592] distutils docs: data_files always uses
 sys.prefix
In-Reply-To: <1447135572.7.0.138478279434.issue25592@psf.upfronthosting.co.za>
Message-ID: <1539094219.52.0.545547206417.issue25592@psf.upfronthosting.co.za>


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

If you?re not sure about the reason for that sentence, I think you should not remove it from the docs but investigate more (look at the history, test the conditions (package with extension module), etc).

----------

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

From report at bugs.python.org  Tue Oct  9 10:18:09 2018
From: report at bugs.python.org (Josh Rosenberg)
Date: Tue, 09 Oct 2018 14:18:09 +0000
Subject: [docs] [issue19270] Document that sched.cancel() doesn't
 distinguish equal events and can break order
In-Reply-To: <1381913252.24.0.629122693277.issue19270@psf.upfronthosting.co.za>
Message-ID: <1539094689.47.0.545547206417.issue19270@psf.upfronthosting.co.za>


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

Victor: "I would be interested of the same test on Windows."

Looks like someone performed it by accident, and filed #34943 in response (because time.monotonic() did in fact return the exact same time twice in a row on Windows).

----------

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

From report at bugs.python.org  Tue Oct  9 10:23:53 2018
From: report at bugs.python.org (Jeroen Demeyer)
Date: Tue, 09 Oct 2018 14:23:53 +0000
Subject: [docs] [issue25592] distutils docs: data_files always uses
 sys.prefix
In-Reply-To: <1447135572.7.0.138478279434.issue25592@psf.upfronthosting.co.za>
Message-ID: <1539095033.02.0.545547206417.issue25592@psf.upfronthosting.co.za>


Jeroen Demeyer <J.Demeyer at UGent.be> added the comment:

> If you?re not sure about the reason for that sentence, I think you should not remove it from the docs

If the docs are wrong, their history doesn't matter that much: the docs should be fixed regardless.

> test the conditions (package with extension module)

I did that before posting this bug report. I also looked at the distutils sources. I couldn't find any evidence that data_files are ever installed in sys.exec_prefix.

----------

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

From report at bugs.python.org  Tue Oct  9 10:24:44 2018
From: report at bugs.python.org (Jeroen Demeyer)
Date: Tue, 09 Oct 2018 14:24:44 +0000
Subject: [docs] [issue25592] distutils docs: data_files always uses
 sys.prefix
In-Reply-To: <1447135572.7.0.138478279434.issue25592@psf.upfronthosting.co.za>
Message-ID: <1539095084.2.0.545547206417.issue25592@psf.upfronthosting.co.za>


Jeroen Demeyer <J.Demeyer at UGent.be> added the comment:

Just for fun, let's look at the history. That piece of documentation goes back to

commit 632bda3aa06879396561dde5ed3d93ee8fb8900c
Author: Fred Drake <fdrake at acm.org>
Date:   Fri Mar 8 22:02:06 2002 +0000

    Add more explanation of how data_files is used (esp. where the files end up
    in the installation and how that location is determined).

I haven't tried to compile that Python version from 2002 but the distutils sources from that time look quite close to what they are today (scary, no?). So my gut feeling is that those docs were wrong even at the time that they were written.

----------

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

From report at bugs.python.org  Tue Oct  9 10:40:16 2018
From: report at bugs.python.org (Jeroen Demeyer)
Date: Tue, 09 Oct 2018 14:40:16 +0000
Subject: [docs] [issue25592] distutils docs: data_files always uses
 sys.prefix
In-Reply-To: <1447135572.7.0.138478279434.issue25592@psf.upfronthosting.co.za>
Message-ID: <1539096016.48.0.545547206417.issue25592@psf.upfronthosting.co.za>


Jeroen Demeyer <J.Demeyer at UGent.be> added the comment:

There is also

commit fa2f4b6d8e297eda09d8ee52dc4a3600b7d458e7
Author: Greg Ward <gward at python.net>
Date:   Sat Jun 24 17:22:39 2000 +0000

    Changed the default installation directory for data files (used by
    the "install_data" command to the installation base, which is usually just
    sys.prefix.  (Any setup scripts out there that specify data files will have
    to set the installation directory, relative to the base, explicitly.)

with commit message stating that data_files are installed in sys.prefix.

----------

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

From report at bugs.python.org  Tue Oct  9 10:45:21 2018
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Tue, 09 Oct 2018 14:45:21 +0000
Subject: [docs] [issue25592] distutils docs: data_files always uses
 sys.prefix
In-Reply-To: <1447135572.7.0.138478279434.issue25592@psf.upfronthosting.co.za>
Message-ID: <1539096321.62.0.545547206417.issue25592@psf.upfronthosting.co.za>


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

> If the docs are wrong, their history doesn't matter that much

What I was saying is that I am not sure that the docs are wrong.

Distutils is more touchy that the rest of the stdlib and I err on the side of caution.

----------

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

From report at bugs.python.org  Tue Oct  9 11:00:07 2018
From: report at bugs.python.org (Jeroen Demeyer)
Date: Tue, 09 Oct 2018 15:00:07 +0000
Subject: [docs] [issue25592] distutils docs: data_files always uses
 sys.prefix
In-Reply-To: <1447135572.7.0.138478279434.issue25592@psf.upfronthosting.co.za>
Message-ID: <1539097207.04.0.545547206417.issue25592@psf.upfronthosting.co.za>


Jeroen Demeyer <J.Demeyer at UGent.be> added the comment:

Well, I did try it on a minimal Python project. I also read the distutils sources and understood why it installs data_files in sys.prefix by default. So what more do you need to be convinced?

----------

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

From report at bugs.python.org  Tue Oct  9 11:02:05 2018
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Tue, 09 Oct 2018 15:02:05 +0000
Subject: [docs] [issue25592] distutils docs: data_files always uses
 sys.prefix
In-Reply-To: <1447135572.7.0.138478279434.issue25592@psf.upfronthosting.co.za>
Message-ID: <1539097325.35.0.545547206417.issue25592@psf.upfronthosting.co.za>


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

Did you try with a minimal project containing a C extension?

Did you install in a system where sys.prefix != sys.exec_prefix?

----------

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

From report at bugs.python.org  Tue Oct  9 18:59:25 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Tue, 09 Oct 2018 22:59:25 +0000
Subject: [docs] [issue34913] Document gzip command line interface
In-Reply-To: <1538809564.11.0.545547206417.issue34913@psf.upfronthosting.co.za>
Message-ID: <1539125965.68.0.668975606942.issue34913@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Tue Oct  9 19:41:47 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Tue, 09 Oct 2018 23:41:47 +0000
Subject: [docs] [issue26441] email.charset: to_splittable and
 from_splittable are not there anymore!
In-Reply-To: <1456440480.97.0.346838980393.issue26441@psf.upfronthosting.co.za>
Message-ID: <1539128507.15.0.668975606942.issue26441@psf.upfronthosting.co.za>


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


----------
assignee:  -> docs at python
components: +Documentation -email
keywords: +easy
nosy: +docs at python
stage:  -> needs patch
type:  -> enhancement
versions: +Python 3.8 -Python 3.5, Python 3.6

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

From report at bugs.python.org  Tue Oct  9 23:45:09 2018
From: report at bugs.python.org (Benjamin Peterson)
Date: Wed, 10 Oct 2018 03:45:09 +0000
Subject: [docs] [issue34878] Lock Objects documentation clarification
In-Reply-To: <1538523706.16.0.545547206417.issue34878@psf.upfronthosting.co.za>
Message-ID: <1539143109.16.0.702299269573.issue34878@psf.upfronthosting.co.za>


Change by Benjamin Peterson <benjamin at python.org>:


----------
priority: normal -> low
resolution: not a bug -> 
status: closed -> open
title: Lock Objects documentation bug -> Lock Objects documentation clarification

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

From report at bugs.python.org  Wed Oct 10 02:16:01 2018
From: report at bugs.python.org (Jeroen Demeyer)
Date: Wed, 10 Oct 2018 06:16:01 +0000
Subject: [docs] [issue25592] distutils docs: data_files always uses
 sys.prefix
In-Reply-To: <1447135572.7.0.138478279434.issue25592@psf.upfronthosting.co.za>
Message-ID: <1539152161.4.0.788709270274.issue25592@psf.upfronthosting.co.za>


Jeroen Demeyer <J.Demeyer at UGent.be> added the comment:

> Did you try with a minimal project containing a C extension?
> Did you install in a system where sys.prefix != sys.exec_prefix?

Yes to both questions.

----------

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

From report at bugs.python.org  Wed Oct 10 02:28:32 2018
From: report at bugs.python.org (Julien Palard)
Date: Wed, 10 Oct 2018 06:28:32 +0000
Subject: [docs] [issue34913] Document gzip command line interface
In-Reply-To: <1538809564.11.0.545547206417.issue34913@psf.upfronthosting.co.za>
Message-ID: <1539152912.75.0.788709270274.issue34913@psf.upfronthosting.co.za>


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


New changeset 7c817e620be9013466d4dd008a2f1dbffcf7517e by Julien Palard (St?phane Wirtel) in branch 'master':
bpo-34913: Document gzip command line interface (GH-9782)
https://github.com/python/cpython/commit/7c817e620be9013466d4dd008a2f1dbffcf7517e


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

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

From report at bugs.python.org  Wed Oct 10 02:44:38 2018
From: report at bugs.python.org (Julien Palard)
Date: Wed, 10 Oct 2018 06:44:38 +0000
Subject: [docs] [issue34913] Document gzip command line interface
In-Reply-To: <1538809564.11.0.545547206417.issue34913@psf.upfronthosting.co.za>
Message-ID: <1539153878.21.0.702299269573.issue34913@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Wed Oct 10 06:06:13 2018
From: report at bugs.python.org (Lysandros Nikolaou)
Date: Wed, 10 Oct 2018 10:06:13 +0000
Subject: [docs] [issue34748] Incorrect HTML link in functools.partial
In-Reply-To: <1537442713.28.0.956365154283.issue34748@psf.upfronthosting.co.za>
Message-ID: <1539165972.97.0.788709270274.issue34748@psf.upfronthosting.co.za>


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

Can I submit a PR for this or is anybody else on it?

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

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

From report at bugs.python.org  Wed Oct 10 09:31:52 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Wed, 10 Oct 2018 13:31:52 +0000
Subject: [docs] [issue34839] doctest: Change example under warnings section
In-Reply-To: <1538180284.16.0.545547206417.issue34839@psf.upfronthosting.co.za>
Message-ID: <1539178312.27.0.788709270274.issue34839@psf.upfronthosting.co.za>


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

Hi Raymond and Tim,

I just updated the PR with your recommendations.

Have a nice day,

----------

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

From report at bugs.python.org  Wed Oct 10 10:35:13 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Wed, 10 Oct 2018 14:35:13 +0000
Subject: [docs] [issue34878] Lock Objects documentation clarification
In-Reply-To: <1538523706.16.0.545547206417.issue34878@psf.upfronthosting.co.za>
Message-ID: <1539182113.37.0.788709270274.issue34878@psf.upfronthosting.co.za>


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

I concur with Benjamin that the docs are reasonable as-is.

----------
nosy: +rhettinger
resolution:  -> rejected
status: open -> closed

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

From report at bugs.python.org  Wed Oct 10 17:43:38 2018
From: report at bugs.python.org (STINNER Victor)
Date: Wed, 10 Oct 2018 21:43:38 +0000
Subject: [docs] [issue34914] Clarify text encoding used to enable UTF-8 mode
In-Reply-To: <1538813217.24.0.545547206417.issue34914@psf.upfronthosting.co.za>
Message-ID: <1539207818.03.0.788709270274.issue34914@psf.upfronthosting.co.za>


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

I'm not sure that I understand your issue. There are 3 ways to enable the UTF-8 Mode:

* if the LC_CTYPE locale is "C" or "POSIX"
* if PYTHONUTF8 env var is equal to "1"
* using -X utf8 or -X utf8=1 command line option

For the first 2 cases are fine if the locale encoding is gb18030.

For the command line argument, first Python decodes the command line from gb18030. If -X utf8 is present, the command line is decoded again from UTF-8 (and the old configuration is removed, to parse the new configuration).

I understand that your question if is decoding the command line argument from gb18030 can miss -X utf8 or enable UTF-8 by mistake.

It seems like gb18030 encodes "-X utf8" text the same way than ASCII:

>>> "-X utf8".encode("gb18030")
b'-X utf8'
>>> b'-X utf8'.decode("gb18030")
'-X utf8'

I'm aware of mojibake causing a security issue, but it was for a function checking for a single byte, not a substring:

https://unicodebook.readthedocs.io/issues.html#check-byte-strings-before-decoding-them-to-character-strings

I don't know well gb18030, so maybe I missed something. To me, using gb18030 with the UTF-8 mode doesn't seem to cause any issue to decode the command line arguments.

----------

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

From report at bugs.python.org  Wed Oct 10 17:47:34 2018
From: report at bugs.python.org (STINNER Victor)
Date: Wed, 10 Oct 2018 21:47:34 +0000
Subject: [docs] [issue34914] Clarify text encoding used to enable UTF-8 mode
In-Reply-To: <1538813217.24.0.545547206417.issue34914@psf.upfronthosting.co.za>
Message-ID: <1539208054.87.0.788709270274.issue34914@psf.upfronthosting.co.za>


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

Well, I'm not saying that using gb18030 with UTF-8 will be just fine for everything. Mojibake is likely around the corner :-) C locale coercion and the UTF-8 mode are workarounds for the crappy and wild Unix world :-)

----------

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

From report at bugs.python.org  Wed Oct 10 22:43:46 2018
From: report at bugs.python.org (Senthil Kumaran)
Date: Thu, 11 Oct 2018 02:43:46 +0000
Subject: [docs] [issue26005] Denial of Service in SimpleHTTPServer and
 BaseHTTPServer
In-Reply-To: <1451897650.58.0.64883073344.issue26005@psf.upfronthosting.co.za>
Message-ID: <1539225826.15.0.702299269573.issue26005@psf.upfronthosting.co.za>


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


New changeset 1d26c72e6a9c5b28b27c158f2f196217707dbb0f by Senthil Kumaran (Felipe Rodrigues) in branch 'master':
bpo-34576 warn users on security for http.server (#9720)
https://github.com/python/cpython/commit/1d26c72e6a9c5b28b27c158f2f196217707dbb0f


----------

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

From report at bugs.python.org  Wed Oct 10 22:44:21 2018
From: report at bugs.python.org (miss-islington)
Date: Thu, 11 Oct 2018 02:44:21 +0000
Subject: [docs] [issue26005] Denial of Service in SimpleHTTPServer and
 BaseHTTPServer
In-Reply-To: <1451897650.58.0.64883073344.issue26005@psf.upfronthosting.co.za>
Message-ID: <1539225861.55.0.023849094327.issue26005@psf.upfronthosting.co.za>


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


----------
pull_requests: +9177

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

From report at bugs.python.org  Wed Oct 10 22:44:28 2018
From: report at bugs.python.org (miss-islington)
Date: Thu, 11 Oct 2018 02:44:28 +0000
Subject: [docs] [issue26005] Denial of Service in SimpleHTTPServer and
 BaseHTTPServer
In-Reply-To: <1451897650.58.0.64883073344.issue26005@psf.upfronthosting.co.za>
Message-ID: <1539225868.49.0.023849094327.issue26005@psf.upfronthosting.co.za>


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


----------
pull_requests: +9179

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

From report at bugs.python.org  Wed Oct 10 23:10:54 2018
From: report at bugs.python.org (Gus Goulart)
Date: Thu, 11 Oct 2018 03:10:54 +0000
Subject: [docs] [issue34203] documentation: recommend Python 3 over 2 in faq
In-Reply-To: <1532397328.96.0.56676864532.issue34203@psf.upfronthosting.co.za>
Message-ID: <1539227454.94.0.702299269573.issue34203@psf.upfronthosting.co.za>


Change by Gus Goulart <augusto at goulart.me>:


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

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

From report at bugs.python.org  Wed Oct 10 23:17:13 2018
From: report at bugs.python.org (Gus Goulart)
Date: Thu, 11 Oct 2018 03:17:13 +0000
Subject: [docs] [issue34203] documentation: recommend Python 3 over 2 in faq
In-Reply-To: <1532397328.96.0.56676864532.issue34203@psf.upfronthosting.co.za>
Message-ID: <1539227833.64.0.788709270274.issue34203@psf.upfronthosting.co.za>


Gus Goulart <augusto at goulart.me> added the comment:

Thanks for pointing that out. If you don't mind, I have created a PR to address your requests.

----------
nosy: +gus, taleinat

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

From report at bugs.python.org  Wed Oct 10 23:31:34 2018
From: report at bugs.python.org (miss-islington)
Date: Thu, 11 Oct 2018 03:31:34 +0000
Subject: [docs] [issue26005] Denial of Service in SimpleHTTPServer and
 BaseHTTPServer
In-Reply-To: <1451897650.58.0.64883073344.issue26005@psf.upfronthosting.co.za>
Message-ID: <1539228694.4.0.702299269573.issue26005@psf.upfronthosting.co.za>


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


New changeset 3baee3b39765f5e8ec616b2b71b731b140486394 by Miss Islington (bot) in branch '3.6':
bpo-34576 warn users on security for http.server (GH-9720)
https://github.com/python/cpython/commit/3baee3b39765f5e8ec616b2b71b731b140486394


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

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

From report at bugs.python.org  Wed Oct 10 23:55:37 2018
From: report at bugs.python.org (miss-islington)
Date: Thu, 11 Oct 2018 03:55:37 +0000
Subject: [docs] [issue26005] Denial of Service in SimpleHTTPServer and
 BaseHTTPServer
In-Reply-To: <1451897650.58.0.64883073344.issue26005@psf.upfronthosting.co.za>
Message-ID: <1539230137.9.0.702299269573.issue26005@psf.upfronthosting.co.za>


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


New changeset 57038bcb24407abbbb46e6d278d0ab4b6ad25bbf by Miss Islington (bot) in branch '3.7':
bpo-34576 warn users on security for http.server (GH-9720)
https://github.com/python/cpython/commit/57038bcb24407abbbb46e6d278d0ab4b6ad25bbf


----------

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

From report at bugs.python.org  Thu Oct 11 00:56:11 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 11 Oct 2018 04:56:11 +0000
Subject: [docs] [issue33729] Hashlib/blake2* missing 'data' keyword argument
In-Reply-To: <1527842171.52.0.682650639539.issue33729@psf.upfronthosting.co.za>
Message-ID: <1539233771.64.0.788709270274.issue33729@psf.upfronthosting.co.za>


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


New changeset f543e18708efb04ed3a0b78c8dc31fbb1404ac7d by Serhiy Storchaka in branch '3.6':
[3.6] bpo-33729: Fix issues with arguments parsing in hashlib. (GH-8346) (GH-8581) (GH-9657)
https://github.com/python/cpython/commit/f543e18708efb04ed3a0b78c8dc31fbb1404ac7d


----------

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

From bgailer at gmail.com  Thu Oct 11 09:00:50 2018
From: bgailer at gmail.com (bob gailer)
Date: Thu, 11 Oct 2018 09:00:50 -0400
Subject: [docs] definition of expression_nocond and lambda_expr_nocond
Message-ID: <5ee813b4-8221-98c8-e137-a8b1a02ff508@gmail.com>

In section 6.12 of the python documentation? (Conditional expressions) 
the term expression_nocond is defined as? or_test | lambda_expr_nocond.

Clicking takes me to lambda_expr_nocond ::=? "lambda" [parameter_list]: 
expression_nocond

Clicking that takes me back to the definition of expression_nocond.

Seems (a) circular and (b) leaves me wondering what lambda_expr_nocond 
and lambda_expr_nocond are.

Any ideas?

Bob Gailer

From bgailer at gmail.com  Thu Oct 11 09:03:56 2018
From: bgailer at gmail.com (bob gailer)
Date: Thu, 11 Oct 2018 09:03:56 -0400
Subject: [docs] error in 6:12 Conditional expressions
Message-ID: <cfbae6f7-bd88-355b-21cb-b5292d0e5f76@gmail.com>

conditional_expression ::=? or_test ["if" or_test "else" expression]

should be

conditional_expression ::= expression ["if" or_test "else" expression]

Bob Gailer

From report at bugs.python.org  Thu Oct 11 20:19:23 2018
From: report at bugs.python.org (Gus Goulart)
Date: Fri, 12 Oct 2018 00:19:23 +0000
Subject: [docs] [issue27741] datetime.datetime.strptime functionality
 description incorrect
In-Reply-To: <1470941311.19.0.0562450492824.issue27741@psf.upfronthosting.co.za>
Message-ID: <1539303563.75.0.788709270274.issue27741@psf.upfronthosting.co.za>


Gus Goulart <augusto at goulart.me> added the comment:

It is true that time.srtptime() does not return microseconds, but as the documentation suggests, it will return the microseconds after you wrap it up with datetime().
I have attached a walkthrough of how I see that section of the docs. Please let me know if you have anything else in mind. Thanks!

----------
nosy: +gus
Added file: https://bugs.python.org/file47863/datetime_docs.PNG

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

From report at bugs.python.org  Thu Oct 11 20:20:16 2018
From: report at bugs.python.org (Gus Goulart)
Date: Fri, 12 Oct 2018 00:20:16 +0000
Subject: [docs] [issue27741] datetime.datetime.strptime functionality
 description incorrect
In-Reply-To: <1470941311.19.0.0562450492824.issue27741@psf.upfronthosting.co.za>
Message-ID: <1539303616.77.0.702299269573.issue27741@psf.upfronthosting.co.za>


Change by Gus Goulart <augusto at goulart.me>:


----------
nosy: +taleinat

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

From report at bugs.python.org  Thu Oct 11 21:38:01 2018
From: report at bugs.python.org (Ned Deily)
Date: Fri, 12 Oct 2018 01:38:01 +0000
Subject: [docs] [issue27741] datetime.datetime.strptime functionality
 description incorrect
In-Reply-To: <1470941311.19.0.0562450492824.issue27741@psf.upfronthosting.co.za>
Message-ID: <1539308281.36.0.702299269573.issue27741@psf.upfronthosting.co.za>


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


----------
nosy: +belopolsky

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

From report at bugs.python.org  Thu Oct 11 23:53:09 2018
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 12 Oct 2018 03:53:09 +0000
Subject: [docs] [issue34748] Incorrect HTML link in functools.partial
In-Reply-To: <1537442713.28.0.956365154283.issue34748@psf.upfronthosting.co.za>
Message-ID: <1539316389.17.0.702299269573.issue34748@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Oct 12 00:04:47 2018
From: report at bugs.python.org (Andrei Petre)
Date: Fri, 12 Oct 2018 04:04:47 +0000
Subject: [docs] [issue34748] Incorrect HTML link in functools.partial
In-Reply-To: <1537442713.28.0.956365154283.issue34748@psf.upfronthosting.co.za>
Message-ID: <1539317087.07.0.788709270274.issue34748@psf.upfronthosting.co.za>


Andrei Petre <p31andrei at gmail.com> added the comment:

Hi, I've also looked into this and I've added a patch addressing both updates (mentioned by xitop and xtreak).

----------
nosy: +andreip

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

From report at bugs.python.org  Fri Oct 12 04:52:17 2018
From: report at bugs.python.org (Tal Einat)
Date: Fri, 12 Oct 2018 08:52:17 +0000
Subject: [docs] [issue27741] datetime.datetime.strptime functionality
 description incorrect
In-Reply-To: <1470941311.19.0.0562450492824.issue27741@psf.upfronthosting.co.za>
Message-ID: <1539334337.59.0.788709270274.issue27741@psf.upfronthosting.co.za>


Tal Einat <taleinat at gmail.com> added the comment:

At least with Python 3.7.0, the equivalence is not complete: datetime.strptime() is better, since it retains both microseconds and timezone data. See examples below.

>>> from datetime import datetime, timezone
>>> import time
>>> s = datetime.strftime(datetime.now(), '%a %b %d %H:%M:%S %f')
>>> s
'Fri Oct 12 11:33:32 999810'
>>> datetime.strptime(s, '%a %b %d %H:%M:%S %f')
datetime.datetime(1900, 10, 12, 11, 33, 32, 999810)
>>> datetime(*time.strptime(s, '%a %b %d %H:%M:%S %f')[:6])
datetime.datetime(1900, 10, 12, 11, 33, 32)
>>> s2 = datetime.strftime(datetime.now(timezone(timedelta(hours=1))), '%a %b %d %H:%M:%S %f%z')
>>> s2
'Fri Oct 12 09:48:40 347076+0100'
>>> datetime.strptime(s2, '%a %b %d %H:%M:%S %f%z')
datetime.datetime(1900, 10, 12, 9, 48, 40, 347076, tzinfo=datetime.timezone(datetime.timedelta(seconds=3600)))
>>> datetime(*time.strptime(s2, '%a %b %d %H:%M:%S %f%z')[:6])
datetime.datetime(1900, 10, 12, 9, 48, 40)

----------

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

From report at bugs.python.org  Fri Oct 12 05:16:55 2018
From: report at bugs.python.org (Tal Einat)
Date: Fri, 12 Oct 2018 09:16:55 +0000
Subject: [docs] [issue34203] documentation: recommend Python 3 over 2 in faq
In-Reply-To: <1532397328.96.0.56676864532.issue34203@psf.upfronthosting.co.za>
Message-ID: <1539335814.92.0.788709270274.issue34203@psf.upfronthosting.co.za>


Tal Einat <taleinat at gmail.com> added the comment:


New changeset 4505f65ae7807f2420ed14d4f060e7cd5c4039d3 by Tal Einat (Gus Goulart) in branch 'master':
bpo-34203: FAQ now recommends python 3.x over 2.x (GH-9796)
https://github.com/python/cpython/commit/4505f65ae7807f2420ed14d4f060e7cd5c4039d3


----------

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

From report at bugs.python.org  Fri Oct 12 05:16:55 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 12 Oct 2018 09:16:55 +0000
Subject: [docs] [issue34203] documentation: recommend Python 3 over 2 in faq
In-Reply-To: <1532397328.96.0.56676864532.issue34203@psf.upfronthosting.co.za>
Message-ID: <1539335815.69.0.702299269573.issue34203@psf.upfronthosting.co.za>


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


----------
pull_requests: +9193

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

From report at bugs.python.org  Fri Oct 12 05:17:02 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 12 Oct 2018 09:17:02 +0000
Subject: [docs] [issue34203] documentation: recommend Python 3 over 2 in faq
In-Reply-To: <1532397328.96.0.56676864532.issue34203@psf.upfronthosting.co.za>
Message-ID: <1539335822.54.0.702299269573.issue34203@psf.upfronthosting.co.za>


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


----------
pull_requests: +9194

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

From report at bugs.python.org  Fri Oct 12 05:17:10 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 12 Oct 2018 09:17:10 +0000
Subject: [docs] [issue34203] documentation: recommend Python 3 over 2 in faq
In-Reply-To: <1532397328.96.0.56676864532.issue34203@psf.upfronthosting.co.za>
Message-ID: <1539335830.62.0.702299269573.issue34203@psf.upfronthosting.co.za>


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


----------
pull_requests: +9195

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

From report at bugs.python.org  Fri Oct 12 08:06:12 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 12 Oct 2018 12:06:12 +0000
Subject: [docs] [issue34203] documentation: recommend Python 3 over 2 in faq
In-Reply-To: <1532397328.96.0.56676864532.issue34203@psf.upfronthosting.co.za>
Message-ID: <1539345972.22.0.788709270274.issue34203@psf.upfronthosting.co.za>


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


New changeset d4ed8809ddfaa23fe5edf2987c03afc32f5576c0 by Miss Islington (bot) in branch '3.7':
bpo-34203: FAQ now recommends python 3.x over 2.x (GH-9796)
https://github.com/python/cpython/commit/d4ed8809ddfaa23fe5edf2987c03afc32f5576c0


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

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

From report at bugs.python.org  Fri Oct 12 08:06:16 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 12 Oct 2018 12:06:16 +0000
Subject: [docs] [issue34203] documentation: recommend Python 3 over 2 in faq
In-Reply-To: <1532397328.96.0.56676864532.issue34203@psf.upfronthosting.co.za>
Message-ID: <1539345976.25.0.788709270274.issue34203@psf.upfronthosting.co.za>


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


New changeset 86cfac47cf736fae90a617959288ccade18fd07e by Miss Islington (bot) in branch '3.6':
bpo-34203: FAQ now recommends python 3.x over 2.x (GH-9796)
https://github.com/python/cpython/commit/86cfac47cf736fae90a617959288ccade18fd07e


----------

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

From report at bugs.python.org  Fri Oct 12 08:06:20 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 12 Oct 2018 12:06:20 +0000
Subject: [docs] [issue34203] documentation: recommend Python 3 over 2 in faq
In-Reply-To: <1532397328.96.0.56676864532.issue34203@psf.upfronthosting.co.za>
Message-ID: <1539345980.11.0.788709270274.issue34203@psf.upfronthosting.co.za>


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


New changeset 6198976ec807cf3b658e902fd63db88a3ac99b8c by Miss Islington (bot) in branch '2.7':
bpo-34203: FAQ now recommends python 3.x over 2.x (GH-9796)
https://github.com/python/cpython/commit/6198976ec807cf3b658e902fd63db88a3ac99b8c


----------

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

From report at bugs.python.org  Fri Oct 12 08:18:38 2018
From: report at bugs.python.org (Tal Einat)
Date: Fri, 12 Oct 2018 12:18:38 +0000
Subject: [docs] [issue34203] documentation: recommend Python 3 over 2 in faq
In-Reply-To: <1532397328.96.0.56676864532.issue34203@psf.upfronthosting.co.za>
Message-ID: <1539346718.19.0.702299269573.issue34203@psf.upfronthosting.co.za>


Change by Tal Einat <taleinat at gmail.com>:


----------
pull_requests: +9198

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

From report at bugs.python.org  Fri Oct 12 10:55:25 2018
From: report at bugs.python.org (STINNER Victor)
Date: Fri, 12 Oct 2018 14:55:25 +0000
Subject: [docs] [issue11233] clarifying Availability: Unix
In-Reply-To: <1297969399.53.0.187875867799.issue11233@psf.upfronthosting.co.za>
Message-ID: <1539356125.33.0.788709270274.issue11233@psf.upfronthosting.co.za>


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


New changeset 2d6097d027e0dd3debbabc702aa9c98d94ba32a3 by Victor Stinner (Cheryl Sabella) in branch 'master':
bpo-11233: Create availability directive for documentation (GH-9692)
https://github.com/python/cpython/commit/2d6097d027e0dd3debbabc702aa9c98d94ba32a3


----------

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

From report at bugs.python.org  Fri Oct 12 11:09:47 2018
From: report at bugs.python.org (Mayank Asthana)
Date: Fri, 12 Oct 2018 15:09:47 +0000
Subject: [docs] [issue29341] Missing accepting path-like object in
 docstrings of os module functions
In-Reply-To: <1485064061.59.0.597221589705.issue29341@psf.upfronthosting.co.za>
Message-ID: <1539356987.3.0.702299269573.issue29341@psf.upfronthosting.co.za>


Change by Mayank Asthana <mayankasthana1993 at gmail.com>:


----------
nosy: +masthana

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

From report at bugs.python.org  Fri Oct 12 13:06:16 2018
From: report at bugs.python.org (Julien Palard)
Date: Fri, 12 Oct 2018 17:06:16 +0000
Subject: [docs] [issue34967] Sphinx is deprecating add_description_unit
Message-ID: <1539363976.13.0.788709270274.issue34967@psf.upfronthosting.co.za>


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

When running `make -C Doc/ autobuild-dev-html` with a recent Sphinx, I'm getting:

    /.../site-packages/sphinx/application.py:927: RemovedInSphinx20Warning: app.add_description_unit() is now deprecated. Use app.add_object_type() instead.

Looks easy to fix.

----------
assignee: docs at python
components: Documentation
keywords: easy
messages: 327600
nosy: docs at python, mdk
priority: normal
severity: normal
status: open
title: Sphinx is deprecating add_description_unit
versions: Python 3.8

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

From report at bugs.python.org  Fri Oct 12 13:54:26 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Fri, 12 Oct 2018 17:54:26 +0000
Subject: [docs] [issue34967] Sphinx is deprecating add_description_unit
In-Reply-To: <1539363976.13.0.788709270274.issue34967@psf.upfronthosting.co.za>
Message-ID: <1539366866.61.0.702299269573.issue34967@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Oct 12 18:09:55 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Fri, 12 Oct 2018 22:09:55 +0000
Subject: [docs] [issue23554] EchoServerClientProtocol class should be called
 EchoServerProtocol
In-Reply-To: <1425189572.41.0.939168822868.issue23554@psf.upfronthosting.co.za>
Message-ID: <1539382195.59.0.788709270274.issue23554@psf.upfronthosting.co.za>


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

Here's a link to the example that the original OP is referring to:
https://docs.python.org/3/library/asyncio-protocol.html?highlight=echoserverclientprotocol#tcp-echo-server

Since this doc page was recently rewritten, I'm not sure if this should be considered a typo.

----------
nosy: +cheryl.sabella, yselivanov
versions: +Python 3.8 -Python 3.4

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

From report at bugs.python.org  Fri Oct 12 18:17:34 2018
From: report at bugs.python.org (Andrew Svetlov)
Date: Fri, 12 Oct 2018 22:17:34 +0000
Subject: [docs] [issue23554] EchoServerClientProtocol class should be called
 EchoServerProtocol
In-Reply-To: <1425189572.41.0.939168822868.issue23554@psf.upfronthosting.co.za>
Message-ID: <1539382654.31.0.788709270274.issue23554@psf.upfronthosting.co.za>


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

Agree, EchoServer is the better name

----------
nosy: +asvetlov

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

From report at bugs.python.org  Fri Oct 12 18:56:16 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Fri, 12 Oct 2018 22:56:16 +0000
Subject: [docs] [issue11233] clarifying Availability: Unix
In-Reply-To: <1297969399.53.0.187875867799.issue11233@psf.upfronthosting.co.za>
Message-ID: <1539384976.88.0.702299269573.issue11233@psf.upfronthosting.co.za>


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


----------
pull_requests: +9204

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

From report at bugs.python.org  Fri Oct 12 19:00:22 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Fri, 12 Oct 2018 23:00:22 +0000
Subject: [docs] [issue23554] EchoServerClientProtocol class should be called
 EchoServerProtocol
In-Reply-To: <1425189572.41.0.939168822868.issue23554@psf.upfronthosting.co.za>
Message-ID: <1539385222.52.0.788709270274.issue23554@psf.upfronthosting.co.za>


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

Thanks @asvetlov.  I'm going to mark this as an Easy Documentation issue, good for a first-time contributor.

----------
keywords: +easy
stage:  -> needs patch
type:  -> enhancement

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

From report at bugs.python.org  Fri Oct 12 19:50:11 2018
From: report at bugs.python.org (Andrew Svetlov)
Date: Fri, 12 Oct 2018 23:50:11 +0000
Subject: [docs] [issue23554] EchoServerClientProtocol class should be called
 EchoServerProtocol
In-Reply-To: <1425189572.41.0.939168822868.issue23554@psf.upfronthosting.co.za>
Message-ID: <1539388211.8.0.788709270274.issue23554@psf.upfronthosting.co.za>


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

Cool! Thanks!

----------

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

From report at bugs.python.org  Sat Oct 13 02:14:13 2018
From: report at bugs.python.org (Julien Palard)
Date: Sat, 13 Oct 2018 06:14:13 +0000
Subject: [docs] [issue34967] Sphinx is deprecating add_description_unit
In-Reply-To: <1539363976.13.0.788709270274.issue34967@psf.upfronthosting.co.za>
Message-ID: <1539411253.12.0.788709270274.issue34967@psf.upfronthosting.co.za>


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


New changeset e385d0661ecf8bc9ba95c4395d9a11262c2cbfec by Julien Palard (St?phane Wirtel) in branch 'master':
bpo-34967: Sphinx is deprecating add_description_unit, use add_object_type (GH-9827)
https://github.com/python/cpython/commit/e385d0661ecf8bc9ba95c4395d9a11262c2cbfec


----------

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

From report at bugs.python.org  Sat Oct 13 02:14:21 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 13 Oct 2018 06:14:21 +0000
Subject: [docs] [issue34967] Sphinx is deprecating add_description_unit
In-Reply-To: <1539363976.13.0.788709270274.issue34967@psf.upfronthosting.co.za>
Message-ID: <1539411261.67.0.702299269573.issue34967@psf.upfronthosting.co.za>


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


----------
pull_requests: +9208

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

From report at bugs.python.org  Sat Oct 13 02:14:32 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 13 Oct 2018 06:14:32 +0000
Subject: [docs] [issue34967] Sphinx is deprecating add_description_unit
In-Reply-To: <1539363976.13.0.788709270274.issue34967@psf.upfronthosting.co.za>
Message-ID: <1539411272.23.0.702299269573.issue34967@psf.upfronthosting.co.za>


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


----------
pull_requests: +9209

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

From report at bugs.python.org  Sat Oct 13 02:14:40 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 13 Oct 2018 06:14:40 +0000
Subject: [docs] [issue34967] Sphinx is deprecating add_description_unit
In-Reply-To: <1539363976.13.0.788709270274.issue34967@psf.upfronthosting.co.za>
Message-ID: <1539411280.83.0.702299269573.issue34967@psf.upfronthosting.co.za>


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


----------
pull_requests: +9210

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

From report at bugs.python.org  Sat Oct 13 08:11:14 2018
From: report at bugs.python.org (Martin Panter)
Date: Sat, 13 Oct 2018 12:11:14 +0000
Subject: [docs] [issue30250] StringIO module truncate behavior of current
 position
In-Reply-To: <1493803286.93.0.729183089652.issue30250@psf.upfronthosting.co.za>
Message-ID: <1539432674.45.0.702299269573.issue30250@psf.upfronthosting.co.za>


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


----------
assignee:  -> docs at python
components: +Documentation
nosy: +docs at python
title: StreamIO truncate behavior of current position -> StringIO module truncate behavior of current position

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

From report at bugs.python.org  Sat Oct 13 17:58:54 2018
From: report at bugs.python.org (Ned Deily)
Date: Sat, 13 Oct 2018 21:58:54 +0000
Subject: [docs] [issue33729] Hashlib/blake2* missing 'data' keyword argument
In-Reply-To: <1527842171.52.0.682650639539.issue33729@psf.upfronthosting.co.za>
Message-ID: <1539467933.99.0.788709270274.issue33729@psf.upfronthosting.co.za>


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

Serhiy's fixes (thanks!) are now released in 3.7.0rc2 and 3.6.7rc2 so I'm removing the "release blocker" status.  If there is nothing more to be done for this issue, can we close it?

----------
priority: release blocker -> 

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

From report at bugs.python.org  Sat Oct 13 19:46:53 2018
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 13 Oct 2018 23:46:53 +0000
Subject: [docs] [issue23554] EchoServerClientProtocol class should be called
 EchoServerProtocol
In-Reply-To: <1425189572.41.0.939168822868.issue23554@psf.upfronthosting.co.za>
Message-ID: <1539474413.23.0.702299269573.issue23554@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Oct 13 21:44:43 2018
From: report at bugs.python.org (Braden Groom)
Date: Sun, 14 Oct 2018 01:44:43 +0000
Subject: [docs] [issue26441] email.charset: to_splittable and
 from_splittable are not there anymore!
In-Reply-To: <1456440480.97.0.346838980393.issue26441@psf.upfronthosting.co.za>
Message-ID: <1539481483.18.0.702299269573.issue26441@psf.upfronthosting.co.za>


Change by Braden Groom <braden.groom at gmail.com>:


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

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

From report at bugs.python.org  Sun Oct 14 14:55:45 2018
From: report at bugs.python.org (Srinivas Reddy T)
Date: Sun, 14 Oct 2018 18:55:45 +0000
Subject: [docs] [issue34848] range.index only takes one argument when it's
 documented as taking the usual 3
In-Reply-To: <1538279738.27.0.545547206417.issue34848@psf.upfronthosting.co.za>
Message-ID: <1539543345.54.0.702299269573.issue34848@psf.upfronthosting.co.za>


Change by Srinivas  Reddy T <thatiparthysreenivas at gmail.com>:


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

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

From report at bugs.python.org  Sun Oct 14 17:05:45 2018
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 14 Oct 2018 21:05:45 +0000
Subject: [docs] [issue34848] range.index only takes one argument when it's
 documented as taking the usual 3
In-Reply-To: <1538279738.27.0.545547206417.issue34848@psf.upfronthosting.co.za>
Message-ID: <1539551145.25.0.702299269573.issue34848@psf.upfronthosting.co.za>


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


----------
pull_requests: +9243

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

From report at bugs.python.org  Sun Oct 14 17:18:03 2018
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 14 Oct 2018 21:18:03 +0000
Subject: [docs] [issue34848] range.index only takes one argument when it's
 documented as taking the usual 3
In-Reply-To: <1538279738.27.0.545547206417.issue34848@psf.upfronthosting.co.za>
Message-ID: <1539551883.68.0.702299269573.issue34848@psf.upfronthosting.co.za>


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


----------
pull_requests: +9244

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

From report at bugs.python.org  Sun Oct 14 18:11:20 2018
From: report at bugs.python.org (Srinivas Reddy T)
Date: Sun, 14 Oct 2018 22:11:20 +0000
Subject: [docs] [issue24653] Mock.assert_has_calls([]) is surprising for
 users
In-Reply-To: <1437126004.09.0.453747784975.issue24653@psf.upfronthosting.co.za>
Message-ID: <1539555080.89.0.702299269573.issue24653@psf.upfronthosting.co.za>


Change by Srinivas  Reddy T <thatiparthysreenivas at gmail.com>:


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

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

From report at bugs.python.org  Mon Oct 15 16:52:39 2018
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 15 Oct 2018 20:52:39 +0000
Subject: [docs] [issue11233] clarifying Availability: Unix
In-Reply-To: <1297969399.53.0.187875867799.issue11233@psf.upfronthosting.co.za>
Message-ID: <1539636758.91.0.788709270274.issue11233@psf.upfronthosting.co.za>


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


New changeset b248a8c9a5e7cf6b8e84a3efda493fccfc511316 by Victor Stinner (Cheryl Sabella) in branch '3.7':
[3.7] bpo-11233: Create availability directive for documentation (GH-9692) (GH-9830)
https://github.com/python/cpython/commit/b248a8c9a5e7cf6b8e84a3efda493fccfc511316


----------

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

From report at bugs.python.org  Mon Oct 15 17:14:28 2018
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 15 Oct 2018 21:14:28 +0000
Subject: [docs] [issue11233] clarifying Availability: Unix
In-Reply-To: <1297969399.53.0.187875867799.issue11233@psf.upfronthosting.co.za>
Message-ID: <1539638067.94.0.788709270274.issue11233@psf.upfronthosting.co.za>


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

Thank you Sandro Tosi for the bug report, thanks Georg Brandl for initial patch, and thanks Cheryl Sabella for the final changes in 3.7 and master!

According to Yury Selivanov, it's not need to backport this change to 2.7 and 3.6, so I close the issue.
https://github.com/python/cpython/pull/9692#issuecomment-429364037

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

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

From report at bugs.python.org  Mon Oct 15 17:39:20 2018
From: report at bugs.python.org (Yury Selivanov)
Date: Mon, 15 Oct 2018 21:39:20 +0000
Subject: [docs] [issue23554] EchoServerClientProtocol class should be called
 EchoServerProtocol
In-Reply-To: <1425189572.41.0.939168822868.issue23554@psf.upfronthosting.co.za>
Message-ID: <1539639560.39.0.788709270274.issue23554@psf.upfronthosting.co.za>


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


New changeset 43a5bd7b458f0ad2d62b00b033d025689d48d591 by Yury Selivanov (Braden Groom) in branch 'master':
bpo-23554: Change echo server example class name from EchoServerClientProtocol to EchoServerProtocol (GH-9859)
https://github.com/python/cpython/commit/43a5bd7b458f0ad2d62b00b033d025689d48d591


----------

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

From report at bugs.python.org  Mon Oct 15 17:39:28 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 15 Oct 2018 21:39:28 +0000
Subject: [docs] [issue23554] EchoServerClientProtocol class should be called
 EchoServerProtocol
In-Reply-To: <1425189572.41.0.939168822868.issue23554@psf.upfronthosting.co.za>
Message-ID: <1539639568.19.0.702299269573.issue23554@psf.upfronthosting.co.za>


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


----------
pull_requests: +9262

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

From report at bugs.python.org  Mon Oct 15 17:40:26 2018
From: report at bugs.python.org (Yury Selivanov)
Date: Mon, 15 Oct 2018 21:40:26 +0000
Subject: [docs] [issue23554] EchoServerClientProtocol class should be called
 EchoServerProtocol
In-Reply-To: <1425189572.41.0.939168822868.issue23554@psf.upfronthosting.co.za>
Message-ID: <1539639626.72.0.702299269573.issue23554@psf.upfronthosting.co.za>


Change by Yury Selivanov <yselivanov at gmail.com>:


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

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

From report at bugs.python.org  Mon Oct 15 17:59:55 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 15 Oct 2018 21:59:55 +0000
Subject: [docs] [issue23554] EchoServerClientProtocol class should be called
 EchoServerProtocol
In-Reply-To: <1425189572.41.0.939168822868.issue23554@psf.upfronthosting.co.za>
Message-ID: <1539640795.21.0.788709270274.issue23554@psf.upfronthosting.co.za>


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


New changeset 802de12d99d16e621537d454eac942d2f448afee by Miss Islington (bot) in branch '3.7':
bpo-23554: Change echo server example class name from EchoServerClientProtocol to EchoServerProtocol (GH-9859)
https://github.com/python/cpython/commit/802de12d99d16e621537d454eac942d2f448afee


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

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

From report at bugs.python.org  Mon Oct 15 19:02:03 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Mon, 15 Oct 2018 23:02:03 +0000
Subject: [docs] [issue11233] clarifying Availability: Unix
In-Reply-To: <1297969399.53.0.187875867799.issue11233@psf.upfronthosting.co.za>
Message-ID: <1539644523.28.0.788709270274.issue11233@psf.upfronthosting.co.za>


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

And thank you, Victor, for reviewing and merging!  :-)

----------

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

From report at bugs.python.org  Mon Oct 15 19:14:06 2018
From: report at bugs.python.org (Ned Deily)
Date: Mon, 15 Oct 2018 23:14:06 +0000
Subject: [docs] [issue34158] Documentation of datetime '%z' format code is
 odd
In-Reply-To: <1532036087.85.0.56676864532.issue34158@psf.upfronthosting.co.za>
Message-ID: <1539645246.85.0.788709270274.issue34158@psf.upfronthosting.co.za>


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

I assume this can now be closed. Thanks, everyone!

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

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

From report at bugs.python.org  Tue Oct 16 02:46:44 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 16 Oct 2018 06:46:44 +0000
Subject: [docs] [issue34967] Sphinx is deprecating add_description_unit
In-Reply-To: <1539363976.13.0.788709270274.issue34967@psf.upfronthosting.co.za>
Message-ID: <1539672403.96.0.788709270274.issue34967@psf.upfronthosting.co.za>


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


New changeset 514bbfc7fc4dcb868d4364632ad14c0533af154f by Miss Islington (bot) in branch '3.7':
bpo-34967: Sphinx is deprecating add_description_unit, use add_object_type (GH-9827)
https://github.com/python/cpython/commit/514bbfc7fc4dcb868d4364632ad14c0533af154f


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

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

From report at bugs.python.org  Tue Oct 16 02:47:10 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 16 Oct 2018 06:47:10 +0000
Subject: [docs] [issue34967] Sphinx is deprecating add_description_unit
In-Reply-To: <1539363976.13.0.788709270274.issue34967@psf.upfronthosting.co.za>
Message-ID: <1539672430.62.0.788709270274.issue34967@psf.upfronthosting.co.za>


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


New changeset e2c3bc7e79c3506609845f7f62ba102e6c7e9993 by Miss Islington (bot) in branch '3.6':
bpo-34967: Sphinx is deprecating add_description_unit, use add_object_type (GH-9827)
https://github.com/python/cpython/commit/e2c3bc7e79c3506609845f7f62ba102e6c7e9993


----------

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

From report at bugs.python.org  Tue Oct 16 02:47:29 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 16 Oct 2018 06:47:29 +0000
Subject: [docs] [issue34967] Sphinx is deprecating add_description_unit
In-Reply-To: <1539363976.13.0.788709270274.issue34967@psf.upfronthosting.co.za>
Message-ID: <1539672449.79.0.788709270274.issue34967@psf.upfronthosting.co.za>


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


New changeset f82c9f1e1af8d35056a6961281d72467b4c46b8d by Miss Islington (bot) in branch '2.7':
bpo-34967: Sphinx is deprecating add_description_unit, use add_object_type (GH-9827)
https://github.com/python/cpython/commit/f82c9f1e1af8d35056a6961281d72467b4c46b8d


----------

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

From report at bugs.python.org  Tue Oct 16 02:47:49 2018
From: report at bugs.python.org (Julien Palard)
Date: Tue, 16 Oct 2018 06:47:49 +0000
Subject: [docs] [issue34967] Sphinx is deprecating add_description_unit
In-Reply-To: <1539363976.13.0.788709270274.issue34967@psf.upfronthosting.co.za>
Message-ID: <1539672469.66.0.702299269573.issue34967@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Tue Oct 16 14:39:56 2018
From: report at bugs.python.org (thautwarm)
Date: Tue, 16 Oct 2018 18:39:56 +0000
Subject: [docs] [issue35001] ImportFrom level cannot be optional
Message-ID: <1539715196.88.0.788709270274.issue35001@psf.upfronthosting.co.za>


New submission from thautwarm <yaoxiansamma at gmail.com>:

This issue is found from a type hinting problem:

```
class ImportFrom(stmt):	class ImportFrom(stmt):
    module = ...  # type: Optional[_identifier]	    module = ...  # type: Optional[_identifier]
    names = ...  # type: typing.List[alias]	    names = ...  # type: typing.List[alias]
    level = ...  # type: Optional[int]
```

As we can see that `level` here is optional, and it's strange.

I tried `ast.parse` on both Python 3.5/3.6, and found that None of `from a import *`, `from .a import *`, `from ..a import *` and other regular cases result into an ImportFrom AST whose `level` is None.


Then I went to Python-asdl: https://github.com/python/cpython/blob/137b0632dccb992ca11e9445142fb33a29c33a51/Parser/Python.asdl#L44

and got 
   
   ImportFrom(identifier? module, alias* names, int? level)


It seems like a bug. To validate it, I went to https://github.com/python/cpython/blob/97cf0828727ac2a269c89c5aa09570a69a22c83c/Python/ast.c#L3311

and got 

    static stmt_ty
    ast_for_import_stmt(struct compiling *c, const node *n){
       int idx, ndots = 0;
       ...
       return ImportFrom(modname, aliases, ndots, lineno, col_offset, c->c_arena);
       ...
    }

It seems that no reason for `level` being None.

If it's really a bug, IMO it could be also an example that type hinting helps to error detection :-)

----------
assignee: docs at python
components: Documentation
messages: 327840
nosy: docs at python, thautwarm
priority: normal
severity: normal
status: open
title: ImportFrom level cannot be optional
type: enhancement
versions: Python 3.6, Python 3.7, Python 3.8

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

From report at bugs.python.org  Tue Oct 16 20:26:15 2018
From: report at bugs.python.org (Sebastian Rittau)
Date: Wed, 17 Oct 2018 00:26:15 +0000
Subject: [docs] [issue35001] ImportFrom level cannot be optional
In-Reply-To: <1539715196.88.0.788709270274.issue35001@psf.upfronthosting.co.za>
Message-ID: <1539735975.8.0.702299269573.issue35001@psf.upfronthosting.co.za>


Change by Sebastian Rittau <srittau at rittau.biz>:


----------
nosy: +srittau

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

From report at bugs.python.org  Tue Oct 16 21:42:04 2018
From: report at bugs.python.org (Vinay Sajip)
Date: Wed, 17 Oct 2018 01:42:04 +0000
Subject: [docs] [issue34590] "Logging HOWTO" should share an example of best
 practices for using logging in a library
In-Reply-To: <1536179966.39.0.56676864532.issue34590@psf.upfronthosting.co.za>
Message-ID: <1539740524.75.0.788709270274.issue34590@psf.upfronthosting.co.za>


Vinay Sajip <vinay_sajip at yahoo.co.uk> added the comment:

Closing, as no specific proposals received.

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

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

From report at bugs.python.org  Tue Oct 16 23:22:03 2018
From: report at bugs.python.org (Anthony Sottile)
Date: Wed, 17 Oct 2018 03:22:03 +0000
Subject: [docs] [issue35001] ImportFrom level cannot be optional
In-Reply-To: <1539715196.88.0.788709270274.issue35001@psf.upfronthosting.co.za>
Message-ID: <1539746523.7.0.788709270274.issue35001@psf.upfronthosting.co.za>


Anthony Sottile <asottile at umich.edu> added the comment:

It appears it has always had this bug since introduction of absolute/relative imports in https://github.com/python/cpython/commit/f7f438ba3b05eb4356e7511401686b07d9dfb6d8

Agree with changing this to `# type: int` and correcting the documentation

----------
nosy: +Anthony Sottile

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

From report at bugs.python.org  Tue Oct 16 23:26:42 2018
From: report at bugs.python.org (Anthony Sottile)
Date: Wed, 17 Oct 2018 03:26:42 +0000
Subject: [docs] [issue35001] ImportFrom level cannot be optional
In-Reply-To: <1539715196.88.0.788709270274.issue35001@psf.upfronthosting.co.za>
Message-ID: <1539746802.44.0.788709270274.issue35001@psf.upfronthosting.co.za>


Anthony Sottile <asottile at umich.edu> added the comment:

In fact, trying to use an `ImportFrom` without an integer `level` results in a `ValueError`:

>>> x = ast.parse('from os import path')
>>> x.body[0].level = None
>>> compile(x, '<string>', 'exec')
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ValueError: invalid integer value: None

----------

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

From report at bugs.python.org  Wed Oct 17 01:07:29 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 17 Oct 2018 05:07:29 +0000
Subject: [docs] [issue35001] ImportFrom level cannot be optional
In-Reply-To: <1539715196.88.0.788709270274.issue35001@psf.upfronthosting.co.za>
Message-ID: <1539752849.79.0.788709270274.issue35001@psf.upfronthosting.co.za>


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

None is not integer. This field is optional:

>>> from ast import *
>>> x = Module(body=[ImportFrom(names=[alias(name='path', asname=None)], lineno=1, col_offset=0)])
>>> compile(x, '<string>', 'exec')
<code object <module> at 0x7f73b754da00, file "<string>", line 1>

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

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

From report at bugs.python.org  Wed Oct 17 01:25:42 2018
From: report at bugs.python.org (Anthony Sottile)
Date: Wed, 17 Oct 2018 05:25:42 +0000
Subject: [docs] [issue35001] ImportFrom level cannot be optional
In-Reply-To: <1539715196.88.0.788709270274.issue35001@psf.upfronthosting.co.za>
Message-ID: <1539753942.77.0.788709270274.issue35001@psf.upfronthosting.co.za>


Anthony Sottile <asottile at umich.edu> added the comment:

Hmmm, I don't think mypy has an annotation for "sometimes has an attribute" -- `Optional[T]` is `Union[T, None]` (why I tried `None`).

But you're right, `FromImport` is constructable without a `level` -- it seems to behave as `level=0` (I guess as expected!)

----------

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

From report at bugs.python.org  Wed Oct 17 01:48:33 2018
From: report at bugs.python.org (Frank Millman)
Date: Wed, 17 Oct 2018 05:48:33 +0000
Subject: [docs] [issue35007] Minor change to weakref docs
Message-ID: <1539755313.9.0.788709270274.issue35007@psf.upfronthosting.co.za>


New submission from Frank Millman <frank at chagford.com>:

weakref.WeakKeyDictionary.keyrefs() -

The documentation says 'Return an iterable of the weak references to the keys'.

I was not sure if this would expose me to the 'dictionary changed size while iterating' error, so I checked the source. The source shows that it returns a list, and the docstring says 'Return a list of weak references to the keys'.

I suggest that the documentation be changed to match the docstring.

The same applies to valuerefs().

----------
assignee: docs at python
components: Documentation
messages: 327863
nosy: docs at python, frankmillman
priority: normal
severity: normal
status: open
title: Minor change to weakref docs
type: behavior
versions: Python 3.7

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

From report at bugs.python.org  Wed Oct 17 04:21:25 2018
From: report at bugs.python.org (thautwarm)
Date: Wed, 17 Oct 2018 08:21:25 +0000
Subject: [docs] [issue35001] ImportFrom level cannot be optional
In-Reply-To: <1539715196.88.0.788709270274.issue35001@psf.upfronthosting.co.za>
Message-ID: <1539764485.4.0.788709270274.issue35001@psf.upfronthosting.co.za>


thautwarm <yaoxiansamma at gmail.com> added the comment:

Hi, Serhiy, for Python-asdl has made `level` able to optional, certainly we could construct an ImportFrom AST without giving `level`.

Moreover, this might evidence that `level` cannot be optional in fact:

https://github.com/python/cpython/blob/8e73ad38ab7d218b9ef8976032865928dfad00f1/Python/compile.c#L2918

----------

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

From report at bugs.python.org  Wed Oct 17 04:27:08 2018
From: report at bugs.python.org (thautwarm)
Date: Wed, 17 Oct 2018 08:27:08 +0000
Subject: [docs] [issue35001] ImportFrom level cannot be optional
In-Reply-To: <1539715196.88.0.788709270274.issue35001@psf.upfronthosting.co.za>
Message-ID: <1539764828.78.0.788709270274.issue35001@psf.upfronthosting.co.za>


thautwarm <yaoxiansamma at gmail.com> added the comment:

@Anthony

> I don't think mypy has an annotation for "sometimes has an attribute"

Yes.. The annotation for an attribute that **maybe exist** cannot be expressed by mypy..

----------

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

From report at bugs.python.org  Wed Oct 17 05:58:10 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 17 Oct 2018 09:58:10 +0000
Subject: [docs] [issue35001] ImportFrom level cannot be optional
In-Reply-To: <1539715196.88.0.788709270274.issue35001@psf.upfronthosting.co.za>
Message-ID: <1539770290.0.0.788709270274.issue35001@psf.upfronthosting.co.za>


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

The level argument of ast.ImportFrom is optional. If it is not specified or None is passes, the corresponding attribute is set to the default value 0.

Type hints are not used in the stdlib. If this is a bug in mypy, this is not the proper tracker for reporting it.

----------

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

From report at bugs.python.org  Wed Oct 17 06:10:34 2018
From: report at bugs.python.org (thautwarm)
Date: Wed, 17 Oct 2018 10:10:34 +0000
Subject: [docs] [issue35001] ImportFrom level cannot be optional
In-Reply-To: <1539715196.88.0.788709270274.issue35001@psf.upfronthosting.co.za>
Message-ID: <1539771034.05.0.788709270274.issue35001@psf.upfronthosting.co.za>


thautwarm <yaoxiansamma at gmail.com> added the comment:

Firstly, allowing to construct ImportFrom without `level` specified could be the result of referring Python-asdl.

Secondly, in C level, `level` is always an integer.

Last but not the least, when you can access `level` from an ImportFrom AST, it must be an integer, not None.

----------

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

From report at bugs.python.org  Wed Oct 17 12:20:05 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Wed, 17 Oct 2018 16:20:05 +0000
Subject: [docs] [issue34901] Missing isolated (-I) flag in sys.flags table
In-Reply-To: <1538718824.99.0.545547206417.issue34901@psf.upfronthosting.co.za>
Message-ID: <1539793205.52.0.788709270274.issue34901@psf.upfronthosting.co.za>


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

In spite of what is said above, PR 9708 was merged before the auto-backport.

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

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

From report at bugs.python.org  Wed Oct 17 12:24:19 2018
From: report at bugs.python.org (Danish Prakash)
Date: Wed, 17 Oct 2018 16:24:19 +0000
Subject: [docs] [issue34901] Missing isolated (-I) flag in sys.flags table
In-Reply-To: <1538718824.99.0.545547206417.issue34901@psf.upfronthosting.co.za>
Message-ID: <1539793459.53.0.702299269573.issue34901@psf.upfronthosting.co.za>


Change by Danish Prakash <grafitykoncept at gmail.com>:


----------
pull_requests: +9283

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

From report at bugs.python.org  Wed Oct 17 18:00:33 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Wed, 17 Oct 2018 22:00:33 +0000
Subject: [docs] [issue14911] generator.throw() documentation inaccurate
In-Reply-To: <1337943736.85.0.146138312281.issue14911@psf.upfronthosting.co.za>
Message-ID: <1539813632.95.0.788709270274.issue14911@psf.upfronthosting.co.za>


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

It seems that this patch was close to being merged.  Would it be helpful for me to create a PR for it over 3.8?  Thanks!

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

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

From report at bugs.python.org  Wed Oct 17 18:27:27 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Wed, 17 Oct 2018 22:27:27 +0000
Subject: [docs] [issue20582] socket.getnameinfo() does not document flags
In-Reply-To: <1392042265.22.0.885252016144.issue20582@psf.upfronthosting.co.za>
Message-ID: <1539815247.01.0.702299269573.issue20582@psf.upfronthosting.co.za>


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


----------
keywords: +easy
stage:  -> needs patch
type:  -> enhancement
versions: +Python 3.8 -Python 2.7, Python 3.3, Python 3.4

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

From report at bugs.python.org  Wed Oct 17 20:22:39 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Thu, 18 Oct 2018 00:22:39 +0000
Subject: [docs] [issue24568] Misc/NEWS: "free-after-use" -> "use-after-free"
In-Reply-To: <1436098037.39.0.99506662274.issue24568@psf.upfronthosting.co.za>
Message-ID: <1539822159.15.0.702299269573.issue24568@psf.upfronthosting.co.za>


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


----------
pull_requests: +9288

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

From report at bugs.python.org  Thu Oct 18 04:06:11 2018
From: report at bugs.python.org (Nick Coghlan)
Date: Thu, 18 Oct 2018 08:06:11 +0000
Subject: [docs] [issue34914] Clarify text encoding used to enable UTF-8 mode
In-Reply-To: <1539208054.87.0.788709270274.issue34914@psf.upfronthosting.co.za>
Message-ID: <CADiSq7d3Nn5TEg7Xiy9VEoRS86iABmLgfc3Gj5qiN_yYJUwuqQ@mail.gmail.com>


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

Your explanation is why this is a docs enhancement proposal rather than a
bug report: as far as we're aware, all encodings that get used as locale
encodings have the property that encoding "-X utf8" with the locale
encoding gives the same answer as encoding it with ASCII.

Encodings where this isn't true (like UTF-16-LE) don't get used as locale
encodings.

----------

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

From report at bugs.python.org  Thu Oct 18 04:50:28 2018
From: report at bugs.python.org (Julien Palard)
Date: Thu, 18 Oct 2018 08:50:28 +0000
Subject: [docs] [issue35015] availability directive breaks po files
Message-ID: <1539852628.85.0.788709270274.issue35015@psf.upfronthosting.co.za>


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

The new availability directive introduced in  2d6097d027e0dd3debbabc702aa9c98d94ba32a3 (https://bugs.python.org/issue11233) breaks po files (sphinx-build -b gettext):

Here's the diff I'm getting on os.po from os.rst:

 msgid ""
-"Availability: Unix, Windows.  :func:`spawnlp`, :func:`spawnlpe`, :func:"
-"`spawnvp` and :func:`spawnvpe` are not available on Windows.  :func:"
-"`spawnle` and :func:`spawnve` are not thread-safe on Windows; we advise you "
-"to use the :mod:`subprocess` module instead."
+"Availability: Unix, Windows.  spawnlp(), spawnlpe(), spawnvp() and "
+"spawnvpe() are not available on Windows.  spawnle() and spawnve() are not "
+"thread-safe on Windows; we advise you to use the subprocess module instead."

The roles has been removed in the po files (but not in the original rst files), so it looks like the availability directive caused the drop of roles, but I still don't understand why.

----------
assignee: docs at python
components: Documentation
messages: 327946
nosy: docs at python, georg.brandl, mdk
priority: normal
severity: normal
status: open
title: availability directive breaks po files
versions: Python 3.8

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

From report at bugs.python.org  Thu Oct 18 06:25:04 2018
From: report at bugs.python.org (Vinay Sajip)
Date: Thu, 18 Oct 2018 10:25:04 +0000
Subject: [docs] [issue32789] Note missing from logging.debug() docs
In-Reply-To: <1518018819.58.0.467229070634.issue32789@psf.upfronthosting.co.za>
Message-ID: <1539858304.53.0.702299269573.issue32789@psf.upfronthosting.co.za>


Change by Vinay Sajip <vinay_sajip at yahoo.co.uk>:


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

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

From report at bugs.python.org  Thu Oct 18 06:33:59 2018
From: report at bugs.python.org (Gus Goulart)
Date: Thu, 18 Oct 2018 10:33:59 +0000
Subject: [docs] [issue27741] datetime.datetime.strptime functionality
 description incorrect
In-Reply-To: <1470941311.19.0.0562450492824.issue27741@psf.upfronthosting.co.za>
Message-ID: <1539858839.21.0.788709270274.issue27741@psf.upfronthosting.co.za>


Gus Goulart <augusto at goulart.me> added the comment:

As far as I can see, every time something changes on datetime.strptime(), it will invalidate that section of the documentation. On the other hand, I believe the comparison with datetime(*(time.strptime(date_string, format)[0:6])" is interesting and valuable to keep.
Given that, instead of "This is equivalent to [...]", I would suggest something like:
"This is similar to [...], but datetime.strptime() is better since it retains both microseconds and timezone data."

----------

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

From report at bugs.python.org  Thu Oct 18 06:56:13 2018
From: report at bugs.python.org (Vinay Sajip)
Date: Thu, 18 Oct 2018 10:56:13 +0000
Subject: [docs] [issue32789] Note missing from logging.debug() docs
In-Reply-To: <1518018819.58.0.467229070634.issue32789@psf.upfronthosting.co.za>
Message-ID: <1539860173.94.0.788709270274.issue32789@psf.upfronthosting.co.za>


Vinay Sajip <vinay_sajip at yahoo.co.uk> added the comment:

Documentation for 3.6/3.7/3.8 updated. 3.5 is out of scope for this.

----------
nosy: +vinay.sajip
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

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

From report at bugs.python.org  Thu Oct 18 08:19:37 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 18 Oct 2018 12:19:37 +0000
Subject: [docs] [issue35015] availability directive breaks po files
In-Reply-To: <1539852628.85.0.788709270274.issue35015@psf.upfronthosting.co.za>
Message-ID: <1539865177.19.0.788709270274.issue35015@psf.upfronthosting.co.za>


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

Do you think it needs to be added to Doc\tools\templates?

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

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

From report at bugs.python.org  Thu Oct 18 08:21:09 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 18 Oct 2018 12:21:09 +0000
Subject: [docs] [issue35015] availability directive breaks po files
In-Reply-To: <1539852628.85.0.788709270274.issue35015@psf.upfronthosting.co.za>
Message-ID: <1539865269.16.0.788709270274.issue35015@psf.upfronthosting.co.za>


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

Sorry, I meant dummy.html in Docs\tools\templates.

----------

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

From report at bugs.python.org  Thu Oct 18 08:25:46 2018
From: report at bugs.python.org (Julien Palard)
Date: Thu, 18 Oct 2018 12:25:46 +0000
Subject: [docs] [issue35015] availability directive breaks po files
In-Reply-To: <1539852628.85.0.788709270274.issue35015@psf.upfronthosting.co.za>
Message-ID: <1539865546.95.0.788709270274.issue35015@psf.upfronthosting.co.za>


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

No, at first glance it looks like the implementation of the directive in pyspecific.py is "removing" the roles.

It's however not removing the roles while building the html, only removing it from po files, so there's a subtility I can't catch here (just spotted this, didn't have time to diagnose it in depth myself).

----------

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

From report at bugs.python.org  Thu Oct 18 08:57:45 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Thu, 18 Oct 2018 12:57:45 +0000
Subject: [docs] [issue35015] availability directive breaks po files
In-Reply-To: <1539852628.85.0.788709270274.issue35015@psf.upfronthosting.co.za>
Message-ID: <1539867465.57.0.702299269573.issue35015@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Oct 18 12:41:31 2018
From: report at bugs.python.org (paul j3)
Date: Thu, 18 Oct 2018 16:41:31 +0000
Subject: [docs] [issue20039] Missing documentation for
 argparse.ArgumentTypeError
In-Reply-To: <1387622425.21.0.562750433804.issue20039@psf.upfronthosting.co.za>
Message-ID: <1539880891.81.0.788709270274.issue20039@psf.upfronthosting.co.za>


paul j3 <ajipanca at gmail.com> added the comment:

A related closed request: https://bugs.python.org/issue30220

that wants to test ValueError for non-generic message, instead of using ArgumentTypeError.

----------

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

From report at bugs.python.org  Thu Oct 18 13:07:51 2018
From: report at bugs.python.org (Ned Deily)
Date: Thu, 18 Oct 2018 17:07:51 +0000
Subject: [docs] [issue35015] availability directive breaks po files
In-Reply-To: <1539852628.85.0.788709270274.issue35015@psf.upfronthosting.co.za>
Message-ID: <1539882471.39.0.702299269573.issue35015@psf.upfronthosting.co.za>


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


----------
nosy: +vstinner
priority: normal -> deferred blocker
versions: +Python 3.7

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

From report at bugs.python.org  Thu Oct 18 13:13:38 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Thu, 18 Oct 2018 17:13:38 +0000
Subject: [docs] [issue35020] Add multisort recipe to sorting docs
Message-ID: <1539882818.57.0.788709270274.issue35020@psf.upfronthosting.co.za>


New submission from Karthikeyan Singaravelan <tir.karthi at gmail.com>:

This issue handles the below : 

1. Adding a link to sorting HOWTO from list.sort docs as per msg327901
2. Adding multisort recipe to sorting HOWTO with an example as per msg327925.

I have raised a PR (GH-9931) for #1 but the issue35010 was closed and hence I will link to this issue. I would also suggest adding single pass sorting example

multisort recipe : https://mail.python.org/pipermail/python-ideas/2016-October/043045.html
single pass recipe : https://mail.python.org/pipermail/python-ideas/2016-October/043126.html

Since English is not my first language feedback welcome on the wording.

Thanks

----------
assignee: docs at python
components: Documentation
messages: 327988
nosy: docs at python, xtreak
priority: normal
severity: normal
status: open
title: Add multisort recipe to sorting docs
type: enhancement
versions: Python 2.7, Python 3.6, Python 3.7, Python 3.8

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

From report at bugs.python.org  Thu Oct 18 13:14:07 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Thu, 18 Oct 2018 17:14:07 +0000
Subject: [docs] [issue35020] Add multisort recipe to sorting docs
In-Reply-To: <1539882818.57.0.788709270274.issue35020@psf.upfronthosting.co.za>
Message-ID: <1539882847.25.0.702299269573.issue35020@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Oct 18 15:07:38 2018
From: report at bugs.python.org (Brett Cannon)
Date: Thu, 18 Oct 2018 19:07:38 +0000
Subject: [docs] [issue35001] ImportFrom level cannot be optional
In-Reply-To: <1539715196.88.0.788709270274.issue35001@psf.upfronthosting.co.za>
Message-ID: <1539889658.28.0.788709270274.issue35001@psf.upfronthosting.co.za>


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

There aren't any type hints in the 'ast' module in Python itself, so this is an issue with typeshed. Closing as "third party".

----------
nosy: +brett.cannon
resolution:  -> third party
stage:  -> resolved
status: open -> closed

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

From report at bugs.python.org  Thu Oct 18 15:43:42 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 18 Oct 2018 19:43:42 +0000
Subject: [docs] [issue35015] availability directive breaks po files
In-Reply-To: <1539852628.85.0.788709270274.issue35015@psf.upfronthosting.co.za>
Message-ID: <1539891822.61.0.788709270274.issue35015@psf.upfronthosting.co.za>


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

I found this in the Sphinx doc.  This works on the English-language build OK, so I'm not sure if it's the cause of the issue.

http://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#gotchas

> No nested inline markup: Something like *see :func:`foo`* is not possible.

----------

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

From report at bugs.python.org  Thu Oct 18 17:14:09 2018
From: report at bugs.python.org (STINNER Victor)
Date: Thu, 18 Oct 2018 21:14:09 +0000
Subject: [docs] [issue35015] availability directive breaks po files
In-Reply-To: <1539852628.85.0.788709270274.issue35015@psf.upfronthosting.co.za>
Message-ID: <1539897249.64.0.788709270274.issue35015@psf.upfronthosting.co.za>


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

Hum, the english HTML rendering looks good to me:
https://docs.python.org/dev/library/os.html#os.spawnvpe

So only the PO files are broken, right?

----------

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

From report at bugs.python.org  Thu Oct 18 17:28:23 2018
From: report at bugs.python.org (Matej Cepl)
Date: Thu, 18 Oct 2018 21:28:23 +0000
Subject: [docs] [issue32174] nonASCII punctuation characters can not display
 in python363.chm.
In-Reply-To: <1512013530.29.0.213398074469.issue32174@psf.upfronthosting.co.za>
Message-ID: <1539898100.57.0.788709270274.issue32174@psf.upfronthosting.co.za>


Matej Cepl <mcepl at cepl.eu> added the comment:

It seems to me that this adds escape4chm as unconditional dependency on all platforms. Which seems like a bad idea to me, I don't think users on Linux or Mac OS X are that keen on *.chm files.

I think this change broke my build of python3-doc package on openSUSE (which built until now absolutely perfectly).

I don't even know, where the escape4chm plugin comes from. ???

----------
nosy: +mcepl
Added file: https://bugs.python.org/file47881/python3-doc-3-7-rc2-log.txt

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

From report at bugs.python.org  Thu Oct 18 18:05:30 2018
From: report at bugs.python.org (Zachary Ware)
Date: Thu, 18 Oct 2018 22:05:30 +0000
Subject: [docs] [issue32174] nonASCII punctuation characters can not display
 in python363.chm.
In-Reply-To: <1512013530.29.0.213398074469.issue32174@psf.upfronthosting.co.za>
Message-ID: <1539900330.39.0.788709270274.issue32174@psf.upfronthosting.co.za>


Zachary Ware <zachary.ware at gmail.com> added the comment:

What version of Python are you running Sphinx with?  Your error is that `html.entities` does not exist, which makes it sound like Python 2; bump it to Python 3 and you'll be fine.

----------

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

From report at bugs.python.org  Thu Oct 18 20:13:29 2018
From: report at bugs.python.org (R. David Murray)
Date: Fri, 19 Oct 2018 00:13:29 +0000
Subject: [docs] [issue26441] email.charset: to_splittable and
 from_splittable are not there anymore!
In-Reply-To: <1456440480.97.0.346838980393.issue26441@psf.upfronthosting.co.za>
Message-ID: <1539908009.41.0.788709270274.issue26441@psf.upfronthosting.co.za>


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


New changeset 5be00247ae0de2e24dd14bbe4d9ca159434a1710 by R. David Murray (Braden Groom) in branch 'master':
bpo-26441: Remove documentation for deleted to_splittable and from_splittable methods (#9865)
https://github.com/python/cpython/commit/5be00247ae0de2e24dd14bbe4d9ca159434a1710


----------

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

From report at bugs.python.org  Thu Oct 18 20:14:38 2018
From: report at bugs.python.org (R. David Murray)
Date: Fri, 19 Oct 2018 00:14:38 +0000
Subject: [docs] [issue26441] email.charset: to_splittable and
 from_splittable are not there anymore!
In-Reply-To: <1456440480.97.0.346838980393.issue26441@psf.upfronthosting.co.za>
Message-ID: <1539908078.08.0.788709270274.issue26441@psf.upfronthosting.co.za>


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

Thanks, Braden.

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

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

From report at bugs.python.org  Thu Oct 18 21:29:58 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Fri, 19 Oct 2018 01:29:58 +0000
Subject: [docs] [issue35015] availability directive breaks po files
In-Reply-To: <1539852628.85.0.788709270274.issue35015@psf.upfronthosting.co.za>
Message-ID: <1539912598.04.0.788709270274.issue35015@psf.upfronthosting.co.za>


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

@Cheryl I think it's about nested inline markup. The func is wrapped inside a * and the markup is normal is not nested here. I tried a sample directive as below :

..availability: :func:`len`

PO file

Availability: len()

Expected

Availability: :func:`len`

@Victor Yes, PO files are broken and markup is good. They have :func:`len` converted to len() like a method call in the output. Since markdown works fine I guess there is some configuration missing in the custom directive code to ensure translations work the same since there are directives like versionadded that have :func: that work fine in PO files. I tried debugging gettext.py in sphinx where catalog of messages are returned without markup as noted for Availablity directive and then written to the file. I don't know how to go little above the call stack to debug further since sphinx configuration looks very complicated.

Thanks

P.S. On mobile please ignore formatting errors if any

----------

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

From report at bugs.python.org  Thu Oct 18 23:01:12 2018
From: report at bugs.python.org (Ma Lin)
Date: Fri, 19 Oct 2018 03:01:12 +0000
Subject: [docs] [issue32174] nonASCII punctuation characters can not display
 in python363.chm.
In-Reply-To: <1512013530.29.0.213398074469.issue32174@psf.upfronthosting.co.za>
Message-ID: <1539918072.01.0.788709270274.issue32174@psf.upfronthosting.co.za>


Ma Lin <malincns at 163.com> added the comment:

> It seems to me that this adds escape4chm as unconditional dependency on all platforms.

`Doc/Makefile` also includes `htmlhelp` command, it generates .chm materials.

BTW, the related navigation bar still has corrputed characters, see the attached file. This can't be fix via Sphinx extension.
I'm writing a Sphinx patch, if they accept it, we can revert this commit, a new option will sovle this perfectly: htmlhelp_ascii_output = True

----------
Added file: https://bugs.python.org/file47883/not perfect yet.png

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

From report at bugs.python.org  Fri Oct 19 02:41:00 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Fri, 19 Oct 2018 06:41:00 +0000
Subject: [docs] [issue35020] Add multisort recipe to sorting docs
In-Reply-To: <1539882818.57.0.788709270274.issue35020@psf.upfronthosting.co.za>
Message-ID: <1539931260.93.0.702299269573.issue35020@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Oct 19 02:42:04 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 19 Oct 2018 06:42:04 +0000
Subject: [docs] [issue35020] Add multisort recipe to sorting docs
In-Reply-To: <1539882818.57.0.788709270274.issue35020@psf.upfronthosting.co.za>
Message-ID: <1539931324.4.0.702299269573.issue35020@psf.upfronthosting.co.za>


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


----------
nosy: +tim.peters

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

From report at bugs.python.org  Fri Oct 19 02:46:29 2018
From: report at bugs.python.org (Tal Einat)
Date: Fri, 19 Oct 2018 06:46:29 +0000
Subject: [docs] [issue27741] datetime.datetime.strptime functionality
 description incorrect
In-Reply-To: <1470941311.19.0.0562450492824.issue27741@psf.upfronthosting.co.za>
Message-ID: <1539931589.48.0.788709270274.issue27741@psf.upfronthosting.co.za>


Tal Einat <taleinat at gmail.com> added the comment:

I agree with Gus, such new wording would be great. Gus, would you like to make a PR?

I'd split the comparison into a second paragraph, and avoid the word "better", instead using something like "but datetime.strptime() also retains both microseconds and timezone data."

Note that such a change of the wording to "similar" rather than "equivalent" will also future-proof this wording from minor future changes to either function.

----------

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

From report at bugs.python.org  Fri Oct 19 05:14:10 2018
From: report at bugs.python.org (George Fischhof)
Date: Fri, 19 Oct 2018 09:14:10 +0000
Subject: [docs] [issue35026] Winreg's documentation lacks mentioning
 required permission at some points
Message-ID: <1539940450.92.0.788709270274.issue35026@psf.upfronthosting.co.za>


New submission from George Fischhof <george at fischhof.hu>:

Winreg's documentation lacks mentioning required permission at some points

Hi there,

on page 
https://docs.python.org/3/library/winreg.html
it is not mentioned in the description of the following functions:
winreg.DeleteKey
winreg.DeleteKeyEx
winreg.DeleteValue

that they require KEY_SET_VALUE when the registry key is opened.

It is mentioned for example at:
winreg.SetValue

with the following text:
The key identified by the key parameter must have been opened with KEY_SET_VALUE access.


BR,
George

----------
assignee: docs at python
components: Documentation
messages: 328034
nosy: docs at python, georgefischhof
priority: normal
severity: normal
status: open
title: Winreg's documentation lacks mentioning required permission at some points
type: enhancement
versions: Python 3.7

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

From report at bugs.python.org  Fri Oct 19 07:18:24 2018
From: report at bugs.python.org (Gus Goulart)
Date: Fri, 19 Oct 2018 11:18:24 +0000
Subject: [docs] [issue27741] datetime.datetime.strptime functionality
 description incorrect
In-Reply-To: <1470941311.19.0.0562450492824.issue27741@psf.upfronthosting.co.za>
Message-ID: <1539947904.24.0.788709270274.issue27741@psf.upfronthosting.co.za>


Gus Goulart <augusto at goulart.me> added the comment:

Thanks, Tal. I will open up a PR for it.

----------

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

From report at bugs.python.org  Fri Oct 19 09:07:50 2018
From: report at bugs.python.org (Julien Palard)
Date: Fri, 19 Oct 2018 13:07:50 +0000
Subject: [docs] [issue35015] availability directive breaks po files
In-Reply-To: <1539852628.85.0.788709270274.issue35015@psf.upfronthosting.co.za>
Message-ID: <1539954470.43.0.788709270274.issue35015@psf.upfronthosting.co.za>


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

Cross-posting here in case it's a sphinx issue: https://github.com/sphinx-doc/sphinx/issues/5554

Tried to debug it a bit at lunch time but the docutils API is still opaque to my eyes :(

----------

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

From report at bugs.python.org  Fri Oct 19 11:04:03 2018
From: report at bugs.python.org (Matej Cepl)
Date: Fri, 19 Oct 2018 15:04:03 +0000
Subject: [docs] [issue32174] nonASCII punctuation characters can not display
 in python363.chm.
In-Reply-To: <1512013530.29.0.213398074469.issue32174@psf.upfronthosting.co.za>
Message-ID: <1539961443.01.0.788709270274.issue32174@psf.upfronthosting.co.za>


Matej Cepl <mcepl at cepl.eu> added the comment:

Sorry, my mistake, it seems I was using python2 Sphinx even for building python3 documentation, which is a bad idea, I guess.

----------

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

From report at bugs.python.org  Fri Oct 19 19:31:20 2018
From: report at bugs.python.org (STINNER Victor)
Date: Fri, 19 Oct 2018 23:31:20 +0000
Subject: [docs] [issue33726] Add short descriptions to PEP references in
 seealso
In-Reply-To: <1527822205.22.0.682650639539.issue33726@psf.upfronthosting.co.za>
Message-ID: <1539991880.91.0.788709270274.issue33726@psf.upfronthosting.co.za>


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


New changeset 0f14fc1a7cb2ea0012d0a943e4460acdee2108d7 by Victor Stinner (Andr?s Delfino) in branch 'master':
bpo-33726, doc: Add short descriptions to PEP references in seealso (GH-7294)
https://github.com/python/cpython/commit/0f14fc1a7cb2ea0012d0a943e4460acdee2108d7


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

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

From report at bugs.python.org  Fri Oct 19 19:31:29 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 19 Oct 2018 23:31:29 +0000
Subject: [docs] [issue33726] Add short descriptions to PEP references in
 seealso
In-Reply-To: <1527822205.22.0.682650639539.issue33726@psf.upfronthosting.co.za>
Message-ID: <1539991889.71.0.702299269573.issue33726@psf.upfronthosting.co.za>


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


----------
pull_requests: +9321

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

From report at bugs.python.org  Fri Oct 19 19:31:41 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 19 Oct 2018 23:31:41 +0000
Subject: [docs] [issue33726] Add short descriptions to PEP references in
 seealso
In-Reply-To: <1527822205.22.0.682650639539.issue33726@psf.upfronthosting.co.za>
Message-ID: <1539991901.82.0.702299269573.issue33726@psf.upfronthosting.co.za>


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


----------
pull_requests: +9322

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

From report at bugs.python.org  Fri Oct 19 19:36:03 2018
From: report at bugs.python.org (STINNER Victor)
Date: Fri, 19 Oct 2018 23:36:03 +0000
Subject: [docs] [issue33708] Doc: Asyncio's Event documentation typo.
In-Reply-To: <1527756494.64.0.682650639539.issue33708@psf.upfronthosting.co.za>
Message-ID: <1539992163.18.0.788709270274.issue33708@psf.upfronthosting.co.za>


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

The asyncio documentation has been rewritten. It seems like the missing references issue is gone.

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

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

From report at bugs.python.org  Fri Oct 19 19:40:51 2018
From: report at bugs.python.org (STINNER Victor)
Date: Fri, 19 Oct 2018 23:40:51 +0000
Subject: [docs] [issue33594] add deprecation since 3.5 for a few methods of
 inspect.
In-Reply-To: <1526938472.55.0.682650639539.issue33594@psf.upfronthosting.co.za>
Message-ID: <1539992450.88.0.788709270274.issue33594@psf.upfronthosting.co.za>


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


New changeset ded87d804e2a85b2a3ea9e7a11384b41fafdfa29 by Victor Stinner (Matthias Bussonnier) in branch 'master':
bpo-33594: Add deprecation info in inspect.py module (GH-7036)
https://github.com/python/cpython/commit/ded87d804e2a85b2a3ea9e7a11384b41fafdfa29


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

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

From report at bugs.python.org  Fri Oct 19 19:41:12 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 19 Oct 2018 23:41:12 +0000
Subject: [docs] [issue33594] add deprecation since 3.5 for a few methods of
 inspect.
In-Reply-To: <1526938472.55.0.682650639539.issue33594@psf.upfronthosting.co.za>
Message-ID: <1539992472.65.0.702299269573.issue33594@psf.upfronthosting.co.za>


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


----------
pull_requests: +9323

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

From report at bugs.python.org  Fri Oct 19 19:41:19 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 19 Oct 2018 23:41:19 +0000
Subject: [docs] [issue33594] add deprecation since 3.5 for a few methods of
 inspect.
In-Reply-To: <1526938472.55.0.682650639539.issue33594@psf.upfronthosting.co.za>
Message-ID: <1539992479.87.0.702299269573.issue33594@psf.upfronthosting.co.za>


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


----------
pull_requests: +9324

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

From report at bugs.python.org  Fri Oct 19 19:43:58 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 19 Oct 2018 23:43:58 +0000
Subject: [docs] [issue33726] Add short descriptions to PEP references in
 seealso
In-Reply-To: <1527822205.22.0.682650639539.issue33726@psf.upfronthosting.co.za>
Message-ID: <1539992638.74.0.788709270274.issue33726@psf.upfronthosting.co.za>


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


New changeset 2a6cf446802079a3ee57147de8273c84d63767e9 by Miss Islington (bot) in branch '3.7':
bpo-33726, doc: Add short descriptions to PEP references in seealso (GH-7294)
https://github.com/python/cpython/commit/2a6cf446802079a3ee57147de8273c84d63767e9


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

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

From report at bugs.python.org  Fri Oct 19 19:44:34 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 19 Oct 2018 23:44:34 +0000
Subject: [docs] [issue33726] Add short descriptions to PEP references in
 seealso
In-Reply-To: <1527822205.22.0.682650639539.issue33726@psf.upfronthosting.co.za>
Message-ID: <1539992674.76.0.788709270274.issue33726@psf.upfronthosting.co.za>


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


New changeset 70102ff18817dd3db79cf73a1028251bbf2106f2 by Miss Islington (bot) in branch '3.6':
bpo-33726, doc: Add short descriptions to PEP references in seealso (GH-7294)
https://github.com/python/cpython/commit/70102ff18817dd3db79cf73a1028251bbf2106f2


----------

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

From report at bugs.python.org  Fri Oct 19 19:59:56 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 19 Oct 2018 23:59:56 +0000
Subject: [docs] [issue33594] add deprecation since 3.5 for a few methods of
 inspect.
In-Reply-To: <1526938472.55.0.682650639539.issue33594@psf.upfronthosting.co.za>
Message-ID: <1539993596.49.0.788709270274.issue33594@psf.upfronthosting.co.za>


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


New changeset 932ebc1e0ef9b0d5cd17370f5183bad0257d36f9 by Miss Islington (bot) in branch '3.6':
bpo-33594: Add deprecation info in inspect.py module (GH-7036)
https://github.com/python/cpython/commit/932ebc1e0ef9b0d5cd17370f5183bad0257d36f9


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

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

From report at bugs.python.org  Fri Oct 19 20:05:28 2018
From: report at bugs.python.org (STINNER Victor)
Date: Sat, 20 Oct 2018 00:05:28 +0000
Subject: [docs] [issue33726] Add short descriptions to PEP references in
 seealso
In-Reply-To: <1527822205.22.0.682650639539.issue33726@psf.upfronthosting.co.za>
Message-ID: <1539993928.54.0.788709270274.issue33726@psf.upfronthosting.co.za>


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

Thanks Andr?s Delfino!

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

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

From report at bugs.python.org  Fri Oct 19 20:05:58 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 20 Oct 2018 00:05:58 +0000
Subject: [docs] [issue33594] add deprecation since 3.5 for a few methods of
 inspect.
In-Reply-To: <1526938472.55.0.682650639539.issue33594@psf.upfronthosting.co.za>
Message-ID: <1539993957.4.0.788709270274.issue33594@psf.upfronthosting.co.za>


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


New changeset c8348fb6d2ef1b5bb91d6eb5fbafdf42c4ae16ce by Miss Islington (bot) in branch '3.7':
bpo-33594: Add deprecation info in inspect.py module (GH-7036)
https://github.com/python/cpython/commit/c8348fb6d2ef1b5bb91d6eb5fbafdf42c4ae16ce


----------

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

From report at bugs.python.org  Fri Oct 19 20:08:16 2018
From: report at bugs.python.org (STINNER Victor)
Date: Sat, 20 Oct 2018 00:08:16 +0000
Subject: [docs] [issue33594] add deprecation since 3.5 for a few methods of
 inspect.
In-Reply-To: <1526938472.55.0.682650639539.issue33594@psf.upfronthosting.co.za>
Message-ID: <1539994096.25.0.788709270274.issue33594@psf.upfronthosting.co.za>


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

Thanks Matthias Bussonnier!

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

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

From report at bugs.python.org  Fri Oct 19 20:22:37 2018
From: report at bugs.python.org (STINNER Victor)
Date: Sat, 20 Oct 2018 00:22:37 +0000
Subject: [docs] [issue10344] codecs.open() buffering doc needs fix
In-Reply-To: <1289084418.05.0.231852584468.issue10344@psf.upfronthosting.co.za>
Message-ID: <1539994956.89.0.663665092547.issue10344@psf.upfronthosting.co.za>


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


New changeset a2670565d8f5c502388378aba1fe73023fd8c8d4 by Victor Stinner (Alexey Izbyshev) in branch 'master':
bpo-32236: open() emits RuntimeWarning if buffering=1 for binary mode (GH-4842)
https://github.com/python/cpython/commit/a2670565d8f5c502388378aba1fe73023fd8c8d4


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

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

From report at bugs.python.org  Fri Oct 19 20:33:52 2018
From: report at bugs.python.org (STINNER Victor)
Date: Sat, 20 Oct 2018 00:33:52 +0000
Subject: [docs] [issue21196] Name mangling example in Python tutorial
In-Reply-To: <1397133080.37.0.870141660622.issue21196@psf.upfronthosting.co.za>
Message-ID: <1539995632.48.0.788709270274.issue21196@psf.upfronthosting.co.za>


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


New changeset 13ae4d44381a647aadd09b70b24833052659be41 by Victor Stinner (Berker Peksag) in branch 'master':
bpo-21196: Clarify name mangling rules in tutorial (GH-5667)
https://github.com/python/cpython/commit/13ae4d44381a647aadd09b70b24833052659be41


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

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

From report at bugs.python.org  Fri Oct 19 20:34:00 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 20 Oct 2018 00:34:00 +0000
Subject: [docs] [issue21196] Name mangling example in Python tutorial
In-Reply-To: <1397133080.37.0.870141660622.issue21196@psf.upfronthosting.co.za>
Message-ID: <1539995640.78.0.702299269573.issue21196@psf.upfronthosting.co.za>


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


----------
pull_requests: +9327

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

From report at bugs.python.org  Fri Oct 19 20:34:09 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 20 Oct 2018 00:34:09 +0000
Subject: [docs] [issue21196] Name mangling example in Python tutorial
In-Reply-To: <1397133080.37.0.870141660622.issue21196@psf.upfronthosting.co.za>
Message-ID: <1539995649.12.0.702299269573.issue21196@psf.upfronthosting.co.za>


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


----------
pull_requests: +9328

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

From report at bugs.python.org  Fri Oct 19 20:35:46 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 20 Oct 2018 00:35:46 +0000
Subject: [docs] [issue21196] Name mangling example in Python tutorial
In-Reply-To: <1397133080.37.0.870141660622.issue21196@psf.upfronthosting.co.za>
Message-ID: <1539995745.92.0.702299269573.issue21196@psf.upfronthosting.co.za>


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


----------
pull_requests: +9329

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

From report at bugs.python.org  Fri Oct 19 20:38:00 2018
From: report at bugs.python.org (STINNER Victor)
Date: Sat, 20 Oct 2018 00:38:00 +0000
Subject: [docs] [issue32798] mmap.flush() on Linux does not accept the
 "offset" and "size" args
In-Reply-To: <1518102419.01.0.467229070634.issue32798@psf.upfronthosting.co.za>
Message-ID: <1539995880.4.0.788709270274.issue32798@psf.upfronthosting.co.za>


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


New changeset 027664a3d5ebad575aafe5fcc572e3b05f7f24e5 by Victor Stinner (Pablo Galindo) in branch 'master':
bpo-32798: Add restriction on the offset parameter for mmap.flush in the docs (#5621)
https://github.com/python/cpython/commit/027664a3d5ebad575aafe5fcc572e3b05f7f24e5


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

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

From report at bugs.python.org  Fri Oct 19 20:38:09 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 20 Oct 2018 00:38:09 +0000
Subject: [docs] [issue32798] mmap.flush() on Linux does not accept the
 "offset" and "size" args
In-Reply-To: <1518102419.01.0.467229070634.issue32798@psf.upfronthosting.co.za>
Message-ID: <1539995889.21.0.702299269573.issue32798@psf.upfronthosting.co.za>


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


----------
pull_requests: +9330

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

From report at bugs.python.org  Fri Oct 19 20:38:17 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 20 Oct 2018 00:38:17 +0000
Subject: [docs] [issue32798] mmap.flush() on Linux does not accept the
 "offset" and "size" args
In-Reply-To: <1518102419.01.0.467229070634.issue32798@psf.upfronthosting.co.za>
Message-ID: <1539995897.26.0.702299269573.issue32798@psf.upfronthosting.co.za>


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


----------
pull_requests: +9331

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

From report at bugs.python.org  Fri Oct 19 20:39:55 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 20 Oct 2018 00:39:55 +0000
Subject: [docs] [issue32798] mmap.flush() on Linux does not accept the
 "offset" and "size" args
In-Reply-To: <1518102419.01.0.467229070634.issue32798@psf.upfronthosting.co.za>
Message-ID: <1539995995.1.0.702299269573.issue32798@psf.upfronthosting.co.za>


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


----------
pull_requests: +9332

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

From report at bugs.python.org  Fri Oct 19 20:42:01 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 20 Oct 2018 00:42:01 +0000
Subject: [docs] [issue21196] Name mangling example in Python tutorial
In-Reply-To: <1397133080.37.0.870141660622.issue21196@psf.upfronthosting.co.za>
Message-ID: <1539996121.84.0.788709270274.issue21196@psf.upfronthosting.co.za>


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


New changeset 3e5bcd12f661bdf363c025b52a3d515829e64ed2 by Miss Islington (bot) in branch '3.7':
bpo-21196: Clarify name mangling rules in tutorial (GH-5667)
https://github.com/python/cpython/commit/3e5bcd12f661bdf363c025b52a3d515829e64ed2


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

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

From report at bugs.python.org  Fri Oct 19 20:43:40 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 20 Oct 2018 00:43: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: <1539996220.64.0.788709270274.issue21196@psf.upfronthosting.co.za>


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


New changeset efc09a9701543f7180fc7ea0b6c45cf198c29cb8 by Miss Islington (bot) in branch '3.6':
bpo-21196: Clarify name mangling rules in tutorial (GH-5667)
https://github.com/python/cpython/commit/efc09a9701543f7180fc7ea0b6c45cf198c29cb8


----------

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

From report at bugs.python.org  Fri Oct 19 20:45:11 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 20 Oct 2018 00:45:11 +0000
Subject: [docs] [issue21196] Name mangling example in Python tutorial
In-Reply-To: <1397133080.37.0.870141660622.issue21196@psf.upfronthosting.co.za>
Message-ID: <1539996311.07.0.788709270274.issue21196@psf.upfronthosting.co.za>


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


New changeset b0f7fa1dda61ae7519deed816993ac5d55870958 by Miss Islington (bot) in branch '2.7':
bpo-21196: Clarify name mangling rules in tutorial (GH-5667)
https://github.com/python/cpython/commit/b0f7fa1dda61ae7519deed816993ac5d55870958


----------

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

From report at bugs.python.org  Fri Oct 19 20:47:19 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 20 Oct 2018 00:47:19 +0000
Subject: [docs] [issue32798] mmap.flush() on Linux does not accept the
 "offset" and "size" args
In-Reply-To: <1518102419.01.0.467229070634.issue32798@psf.upfronthosting.co.za>
Message-ID: <1539996439.71.0.788709270274.issue32798@psf.upfronthosting.co.za>


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


New changeset 75ee130c39e73730535d94923fd8322ef616cb83 by Miss Islington (bot) in branch '3.6':
bpo-32798: Add restriction on the offset parameter for mmap.flush in the docs (GH-5621)
https://github.com/python/cpython/commit/75ee130c39e73730535d94923fd8322ef616cb83


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

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

From report at bugs.python.org  Fri Oct 19 20:48:09 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 20 Oct 2018 00:48:09 +0000
Subject: [docs] [issue32798] mmap.flush() on Linux does not accept the
 "offset" and "size" args
In-Reply-To: <1518102419.01.0.467229070634.issue32798@psf.upfronthosting.co.za>
Message-ID: <1539996489.43.0.788709270274.issue32798@psf.upfronthosting.co.za>


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


New changeset 557a68789b97bf281aa7b7e96f083982c01a5f7e by Miss Islington (bot) in branch '3.7':
bpo-32798: Add restriction on the offset parameter for mmap.flush in the docs (GH-5621)
https://github.com/python/cpython/commit/557a68789b97bf281aa7b7e96f083982c01a5f7e


----------

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

From report at bugs.python.org  Fri Oct 19 20:49:43 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 20 Oct 2018 00:49:43 +0000
Subject: [docs] [issue32798] mmap.flush() on Linux does not accept the
 "offset" and "size" args
In-Reply-To: <1518102419.01.0.467229070634.issue32798@psf.upfronthosting.co.za>
Message-ID: <1539996582.96.0.788709270274.issue32798@psf.upfronthosting.co.za>


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


New changeset 2bad7acdfebb87a6eef238a7acca636cfb648a02 by Miss Islington (bot) in branch '2.7':
bpo-32798: Add restriction on the offset parameter for mmap.flush in the docs (GH-5621)
https://github.com/python/cpython/commit/2bad7acdfebb87a6eef238a7acca636cfb648a02


----------

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

From report at bugs.python.org  Fri Oct 19 20:52:12 2018
From: report at bugs.python.org (STINNER Victor)
Date: Sat, 20 Oct 2018 00:52:12 +0000
Subject: [docs] [issue32798] mmap.flush() on Linux does not accept the
 "offset" and "size" args
In-Reply-To: <1518102419.01.0.467229070634.issue32798@psf.upfronthosting.co.za>
Message-ID: <1539996732.52.0.788709270274.issue32798@psf.upfronthosting.co.za>


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

The documentation has been clarified, thanks Pablo Galindo!

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

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

From report at bugs.python.org  Fri Oct 19 20:53:09 2018
From: report at bugs.python.org (STINNER Victor)
Date: Sat, 20 Oct 2018 00:53:09 +0000
Subject: [docs] [issue21196] Name mangling example in Python tutorial
In-Reply-To: <1397133080.37.0.870141660622.issue21196@psf.upfronthosting.co.za>
Message-ID: <1539996789.37.0.788709270274.issue21196@psf.upfronthosting.co.za>


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

Thanks Chandan Kumar and Berker Peksag. The documentation has been clarified.

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

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

From report at bugs.python.org  Fri Oct 19 21:34:39 2018
From: report at bugs.python.org (Gus Goulart)
Date: Sat, 20 Oct 2018 01:34:39 +0000
Subject: [docs] [issue27741] datetime.datetime.strptime functionality
 description incorrect
In-Reply-To: <1470941311.19.0.0562450492824.issue27741@psf.upfronthosting.co.za>
Message-ID: <1539999279.89.0.702299269573.issue27741@psf.upfronthosting.co.za>


Change by Gus Goulart <augusto at goulart.me>:


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

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

From report at bugs.python.org  Sat Oct 20 00:43:09 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Sat, 20 Oct 2018 04:43:09 +0000
Subject: [docs] [issue35026] Winreg's documentation lacks mentioning
 required permission at some points
In-Reply-To: <1539940450.92.0.788709270274.issue35026@psf.upfronthosting.co.za>
Message-ID: <1540010589.28.0.788709270274.issue35026@psf.upfronthosting.co.za>


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

Thanks for the report. I am adding windows component since it's a windows specific doc issue.

RegDeleteValueW

> A handle to an open registry key. The key must have been opened with the KEY_SET_VALUE access right. For more information, see Registry Key Security and Access Rights.

https://docs.microsoft.com/en-us/windows/desktop/api/winreg/nf-winreg-regdeletevaluew#parameters

RegDeleteKeyExA

https://docs.microsoft.com/en-us/windows/desktop/api/winreg/nf-winreg-regdeletekeyexa#parameters

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

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

From report at bugs.python.org  Sat Oct 20 04:43:38 2018
From: report at bugs.python.org (Julien Palard)
Date: Sat, 20 Oct 2018 08:43:38 +0000
Subject: [docs] [issue34839] doctest: Change example under warnings section
In-Reply-To: <1538180284.16.0.545547206417.issue34839@psf.upfronthosting.co.za>
Message-ID: <1540025018.29.0.788709270274.issue34839@psf.upfronthosting.co.za>


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


New changeset 0522fd81dc6e3482c2d4c8719f1f85ad5924eede by Julien Palard (St?phane Wirtel) in branch 'master':
bpo-34839: Add a 'before 3.6' in the section 'warnings' of doctest (GH-9736)
https://github.com/python/cpython/commit/0522fd81dc6e3482c2d4c8719f1f85ad5924eede


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

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

From report at bugs.python.org  Sat Oct 20 04:46:27 2018
From: report at bugs.python.org (Julien Palard)
Date: Sat, 20 Oct 2018 08:46:27 +0000
Subject: [docs] [issue34839] doctest: Change example under warnings section
In-Reply-To: <1538180284.16.0.545547206417.issue34839@psf.upfronthosting.co.za>
Message-ID: <1540025187.78.0.702299269573.issue34839@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Oct 20 10:30:55 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Sat, 20 Oct 2018 14:30:55 +0000
Subject: [docs] [issue35032] Remove the videos from faq/Windows
Message-ID: <1540045855.07.0.788709270274.issue35032@psf.upfronthosting.co.za>


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

In the FAQ of Windows, there are two references to external videos for the configuration of a dev environment for Windows, but these videos are no longer available because the domain name no longer exists.

----------
assignee: docs at python
components: Documentation, Windows
messages: 328139
nosy: docs at python, matrixise, paul.moore, steve.dower, tim.golden, zach.ware
priority: normal
severity: normal
status: open
title: Remove the videos from faq/Windows
versions: Python 2.7, Python 3.6, Python 3.7, Python 3.8

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

From report at bugs.python.org  Sat Oct 20 10:32:24 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Sat, 20 Oct 2018 14:32:24 +0000
Subject: [docs] [issue35032] Remove the videos from faq/Windows
In-Reply-To: <1540045855.07.0.788709270274.issue35032@psf.upfronthosting.co.za>
Message-ID: <1540045944.47.0.702299269573.issue35032@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Oct 20 11:27:07 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 20 Oct 2018 15:27:07 +0000
Subject: [docs] [issue35032] Remove the videos from faq/Windows
In-Reply-To: <1540045855.07.0.788709270274.issue35032@psf.upfronthosting.co.za>
Message-ID: <1540049227.43.0.788709270274.issue35032@psf.upfronthosting.co.za>


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


New changeset d262250d0732bdf36cb92091e37360cf8ff40f7c by Miss Islington (bot) (St?phane Wirtel) in branch 'master':
bpo-35032: Remove inaccessible videos from faq/Windows (GH-10004)
https://github.com/python/cpython/commit/d262250d0732bdf36cb92091e37360cf8ff40f7c


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

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

From report at bugs.python.org  Sat Oct 20 11:27:18 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 20 Oct 2018 15:27:18 +0000
Subject: [docs] [issue35032] Remove the videos from faq/Windows
In-Reply-To: <1540045855.07.0.788709270274.issue35032@psf.upfronthosting.co.za>
Message-ID: <1540049238.58.0.702299269573.issue35032@psf.upfronthosting.co.za>


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


----------
pull_requests: +9347

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

From report at bugs.python.org  Sat Oct 20 11:27:27 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 20 Oct 2018 15:27:27 +0000
Subject: [docs] [issue35032] Remove the videos from faq/Windows
In-Reply-To: <1540045855.07.0.788709270274.issue35032@psf.upfronthosting.co.za>
Message-ID: <1540049247.67.0.702299269573.issue35032@psf.upfronthosting.co.za>


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


----------
pull_requests: +9348

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

From report at bugs.python.org  Sat Oct 20 11:27:36 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 20 Oct 2018 15:27:36 +0000
Subject: [docs] [issue35032] Remove the videos from faq/Windows
In-Reply-To: <1540045855.07.0.788709270274.issue35032@psf.upfronthosting.co.za>
Message-ID: <1540049256.36.0.702299269573.issue35032@psf.upfronthosting.co.za>


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


----------
pull_requests: +9349

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

From report at bugs.python.org  Sat Oct 20 11:32:24 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 20 Oct 2018 15:32:24 +0000
Subject: [docs] [issue35032] Remove the videos from faq/Windows
In-Reply-To: <1540045855.07.0.788709270274.issue35032@psf.upfronthosting.co.za>
Message-ID: <1540049544.91.0.788709270274.issue35032@psf.upfronthosting.co.za>


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


New changeset 76e8582fca17b89d2709ad7f4e1ad658ee839962 by Miss Islington (bot) in branch '3.6':
bpo-35032: Remove inaccessible videos from faq/Windows (GH-10004)
https://github.com/python/cpython/commit/76e8582fca17b89d2709ad7f4e1ad658ee839962


----------

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

From report at bugs.python.org  Sat Oct 20 11:32:25 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 20 Oct 2018 15:32:25 +0000
Subject: [docs] [issue35032] Remove the videos from faq/Windows
In-Reply-To: <1540045855.07.0.788709270274.issue35032@psf.upfronthosting.co.za>
Message-ID: <1540049545.21.0.788709270274.issue35032@psf.upfronthosting.co.za>


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


New changeset b53edb12f7176c58960d5ebaf48e740bea72a500 by Miss Islington (bot) in branch '2.7':
bpo-35032: Remove inaccessible videos from faq/Windows (GH-10004)
https://github.com/python/cpython/commit/b53edb12f7176c58960d5ebaf48e740bea72a500


----------

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

From report at bugs.python.org  Sat Oct 20 11:32:32 2018
From: report at bugs.python.org (miss-islington)
Date: Sat, 20 Oct 2018 15:32:32 +0000
Subject: [docs] [issue35032] Remove the videos from faq/Windows
In-Reply-To: <1540045855.07.0.788709270274.issue35032@psf.upfronthosting.co.za>
Message-ID: <1540049552.2.0.788709270274.issue35032@psf.upfronthosting.co.za>


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


New changeset 34a5ed5c0abbe75af2b75ad8bd03b68fd7e2f596 by Miss Islington (bot) in branch '3.7':
bpo-35032: Remove inaccessible videos from faq/Windows (GH-10004)
https://github.com/python/cpython/commit/34a5ed5c0abbe75af2b75ad8bd03b68fd7e2f596


----------

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

From report at bugs.python.org  Sat Oct 20 12:28:35 2018
From: report at bugs.python.org (Julien Palard)
Date: Sat, 20 Oct 2018 16:28:35 +0000
Subject: [docs] [issue35033] Column or row spanning cells are not
 implemented.
Message-ID: <1540052915.48.0.788709270274.issue35033@psf.upfronthosting.co.za>


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

Recent tables introduced in Doc/c-api/typeobj.rst are using columns spanning.

But columns spanning is not implemented in the sphinx text builder, resulting in:

$ cd Doc
$ sphinx-build -b text -d build/doctrees -W -D latex_elements.papersize= -Ea -A daily=1 -A switchers=1 . build/text
Running Sphinx v1.8.1
building [mo]: all of 0 po files
building [text]: all source files
updating environment: 475 added, 0 changed, 0 removed
reading sources... [100%] whatsnew/index                                                                                                           
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
preparing documents... done
writing output... [ 12%] c-api/typeobj                                                                                                             
Exception occurred:
  File "/home/mdk/.venvs/mdk/lib/python3.6/site-packages/sphinx/writers/text.py", line 623, in visit_entry
    raise NotImplementedError('Column or row spanning cells are '
NotImplementedError: Column or row spanning cells are not implemented.
The full traceback has been saved in /tmp/sphinx-err-3q24uv89.log, if you want to report the issue to the developers.
Please also report this if it was a user error, so that a better error message can be provided next time.
A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!

we could either try to remove our column spannings (but they're usefull, first table, 2nd header line), either implement it sphinx-side.

----------
assignee: docs at python
components: Documentation
messages: 328159
nosy: docs at python, mdk
priority: normal
severity: normal
status: open
title: Column or row spanning cells are not implemented.
versions: Python 3.8

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

From report at bugs.python.org  Sat Oct 20 12:40:32 2018
From: report at bugs.python.org (Julien Palard)
Date: Sat, 20 Oct 2018 16:40:32 +0000
Subject: [docs] [issue35033] Column or row spanning cells are not
 implemented.
In-Reply-To: <1540052915.48.0.788709270274.issue35033@psf.upfronthosting.co.za>
Message-ID: <1540053632.61.0.788709270274.issue35033@psf.upfronthosting.co.za>


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

Oh and we're also using raw spanning, in the same place, as the table header is two raws height and almost all cells but the last spans on two raws.

----------

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

From report at bugs.python.org  Sat Oct 20 14:50:07 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Sat, 20 Oct 2018 18:50:07 +0000
Subject: [docs] [issue35033] Column or row spanning cells are not
 implemented.
In-Reply-To: <1540052915.48.0.788709270274.issue35033@psf.upfronthosting.co.za>
Message-ID: <1540061407.7.0.702299269573.issue35033@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Oct 20 17:39:06 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Sat, 20 Oct 2018 21:39:06 +0000
Subject: [docs] [issue35020] Add multisort recipe to sorting docs
In-Reply-To: <1539882818.57.0.788709270274.issue35020@psf.upfronthosting.co.za>
Message-ID: <1540071546.87.0.788709270274.issue35020@psf.upfronthosting.co.za>


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


New changeset 890a4b92933be8e7c554222d99ef829c88fa8637 by Raymond Hettinger (Xtreak) in branch 'master':
bpo-35020: Link to sorting examples from list.sort() (GH-9931)
https://github.com/python/cpython/commit/890a4b92933be8e7c554222d99ef829c88fa8637


----------

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

From report at bugs.python.org  Sat Oct 20 17:40:19 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Sat, 20 Oct 2018 21:40:19 +0000
Subject: [docs] [issue35020] Add multisort recipe to sorting docs
In-Reply-To: <1539882818.57.0.788709270274.issue35020@psf.upfronthosting.co.za>
Message-ID: <1540071619.03.0.702299269573.issue35020@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Oct 20 19:46:09 2018
From: report at bugs.python.org (Benjamin Peterson)
Date: Sat, 20 Oct 2018 23:46:09 +0000
Subject: [docs] [issue35020] Add multisort recipe to sorting docs
In-Reply-To: <1539882818.57.0.788709270274.issue35020@psf.upfronthosting.co.za>
Message-ID: <1540079169.81.0.702299269573.issue35020@psf.upfronthosting.co.za>


Change by Benjamin Peterson <benjamin at python.org>:


----------
pull_requests: +9353

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

From report at bugs.python.org  Sun Oct 21 02:17:19 2018
From: report at bugs.python.org (Zhiming Wang)
Date: Sun, 21 Oct 2018 06:17:19 +0000
Subject: [docs] [issue35035] Documentation for email.utils is named
 email.util.rst
Message-ID: <1540102639.17.0.788709270274.issue35035@psf.upfronthosting.co.za>


New submission from Zhiming Wang <zmwangx at gmail.com>:

Documentation for PSL module email.utils is named email.util.rst. See <https://docs.python.org/3/library/email.util.html>.

This seems to violate the principle of least surprise. (I have a command line tool to open documentation for any PSL module, and I found this name mismatch when I used that with email.utils.) It should be named email.utils.rst instead, unless there's a specific reason not to.

----------
assignee: docs at python
components: Documentation
messages: 328190
nosy: docs at python, zmwangx
priority: normal
severity: normal
status: open
title: Documentation for email.utils is named email.util.rst
versions: Python 3.7, Python 3.8

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

From report at bugs.python.org  Sun Oct 21 02:25:02 2018
From: report at bugs.python.org (Zhiming Wang)
Date: Sun, 21 Oct 2018 06:25:02 +0000
Subject: [docs] [issue35035] Documentation for email.utils is named
 email.util.rst
In-Reply-To: <1540102639.17.0.788709270274.issue35035@psf.upfronthosting.co.za>
Message-ID: <1540103102.53.0.702299269573.issue35035@psf.upfronthosting.co.za>


Change by Zhiming Wang <zmwangx at gmail.com>:


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

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

From report at bugs.python.org  Sun Oct 21 05:23:10 2018
From: report at bugs.python.org (Caleb Hattingh)
Date: Sun, 21 Oct 2018 09:23:10 +0000
Subject: [docs] [issue34831] Asyncio Tutorial
In-Reply-To: <1538134577.09.0.545547206417.issue34831@psf.upfronthosting.co.za>
Message-ID: <1540113790.48.0.788709270274.issue34831@psf.upfronthosting.co.za>


Caleb Hattingh <caleb.hattingh at gmail.com> added the comment:

I've added a few ideas for items in the "cookbook" page, which you'll see in the PR. If anyone has suggestions for more or better cookbook entries (recipes?), feel free to mention here or in the PR, I check both places. I expect to get more time to work on this next weekend, so it would be great to get ideas and reviews in during the week.

----------

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

From report at bugs.python.org  Sun Oct 21 10:54:56 2018
From: report at bugs.python.org (Julien Palard)
Date: Sun, 21 Oct 2018 14:54:56 +0000
Subject: [docs] [issue34081] Sphinx duplicate label warning in docs
In-Reply-To: <1531211521.37.0.56676864532.issue34081@psf.upfronthosting.co.za>
Message-ID: <1540133696.46.0.788709270274.issue34081@psf.upfronthosting.co.za>


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


New changeset 121eb1694cab14df857ba6abe9839654cada15cf by Julien Palard (Xtreak) in branch 'master':
bpo-34081: Fix wrong example link that was linking to distutils (GH-8248)
https://github.com/python/cpython/commit/121eb1694cab14df857ba6abe9839654cada15cf


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

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

From report at bugs.python.org  Sun Oct 21 10:55:20 2018
From: report at bugs.python.org (Julien Palard)
Date: Sun, 21 Oct 2018 14:55:20 +0000
Subject: [docs] [issue34081] Sphinx duplicate label warning in docs
In-Reply-To: <1531211521.37.0.56676864532.issue34081@psf.upfronthosting.co.za>
Message-ID: <1540133720.14.0.702299269573.issue34081@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sun Oct 21 11:02:02 2018
From: report at bugs.python.org (Adrien)
Date: Sun, 21 Oct 2018 15:02:02 +0000
Subject: [docs] [issue35038] AttributeError: 'frame' object has no attribute
 'f_restricted'
Message-ID: <1540134122.28.0.788709270274.issue35038@psf.upfronthosting.co.za>


New submission from Adrien <delgan.py at gmail.com>:

In the documentation (https://docs.python.org/3/library/inspect.html#types-and-members), the attribute `f_restricted` is listed as a member of `frame` objects. However, while trying to access it or even when calling `help()`, the object does not seem to have such attribute.

Is it a issue with the documentation that has not been updated?

I'm using Python 3.6.3 on Linux.

----------
assignee: docs at python
components: Documentation
messages: 328217
nosy: Delgan, docs at python
priority: normal
severity: normal
status: open
title: AttributeError: 'frame' object has no attribute 'f_restricted'
type: enhancement
versions: Python 3.6

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

From report at bugs.python.org  Sun Oct 21 11:12:55 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 21 Oct 2018 15:12:55 +0000
Subject: [docs] [issue35038] AttributeError: 'frame' object has no attribute
 'f_restricted'
In-Reply-To: <1540134122.28.0.788709270274.issue35038@psf.upfronthosting.co.za>
Message-ID: <1540134775.36.0.788709270274.issue35038@psf.upfronthosting.co.za>


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

It is an issue with the documentation.

----------
keywords: +easy
nosy: +serhiy.storchaka

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

From report at bugs.python.org  Sun Oct 21 11:13:32 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 21 Oct 2018 15:13:32 +0000
Subject: [docs] [issue35038] AttributeError: 'frame' object has no attribute
 'f_restricted'
In-Reply-To: <1540134122.28.0.788709270274.issue35038@psf.upfronthosting.co.za>
Message-ID: <1540134812.72.0.702299269573.issue35038@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sun Oct 21 19:26:40 2018
From: report at bugs.python.org (Julien Palard)
Date: Sun, 21 Oct 2018 23:26:40 +0000
Subject: [docs] [issue35033] Column or row spanning cells are not
 implemented.
In-Reply-To: <1540052915.48.0.788709270274.issue35033@psf.upfronthosting.co.za>
Message-ID: <1540164400.92.0.788709270274.issue35033@psf.upfronthosting.co.za>


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

Started implementing a POC sphinx-side so we may not have to "fix" our doc: https://github.com/JulienPalard/sphinx/tree/text-colspan-rowspan

----------

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

From report at bugs.python.org  Mon Oct 22 04:11:03 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Mon, 22 Oct 2018 08:11:03 +0000
Subject: [docs] [issue35042] Use the role :pep: for the PEP \d+
Message-ID: <1540195863.27.0.788709270274.issue35042@psf.upfronthosting.co.za>


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

In the doc, we write PEP XYZ but there is a sphinx role for that, just replace PEP XYZ by :pep:`XYZ` and convert the :PEP: by :pep:

----------
assignee: docs at python
components: Documentation
messages: 328240
nosy: docs at python, matrixise
priority: normal
severity: normal
status: open
title: Use the role :pep: for the PEP \d+
versions: Python 3.6, Python 3.7, Python 3.8

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

From report at bugs.python.org  Mon Oct 22 05:47:52 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Mon, 22 Oct 2018 09:47:52 +0000
Subject: [docs] [issue35042] Use the role :pep: for the PEP \d+
In-Reply-To: <1540195863.27.0.788709270274.issue35042@psf.upfronthosting.co.za>
Message-ID: <1540201672.74.0.702299269573.issue35042@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Mon Oct 22 06:52:03 2018
From: report at bugs.python.org (beautifuljose)
Date: Mon, 22 Oct 2018 10:52:03 +0000
Subject: [docs] [issue28960] Small typo in Thread.join docs
In-Reply-To: <1481636284.79.0.913462681395.issue28960@psf.upfronthosting.co.za>
Message-ID: <1540205523.31.0.788709270274.issue28960@psf.upfronthosting.co.za>


beautifuljose <terryjosephinee at gmail.com> added the comment:

I think both dash and comma should be removed
Found a similar problem here: 
https://www.paperhelp.org/essay/buy-argumentative-essay.html

----------
nosy: +beautifuljose

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

From report at bugs.python.org  Mon Oct 22 07:38:00 2018
From: report at bugs.python.org (=?utf-8?b?U3Jpbml2YXMgIFJlZGR5IFRoYXRpcGFydGh5KOCwtuCxjeCwsOCxgOCwqA==?= =?utf-8?b?4LC/4LC14LC+4LC44LGNIOCwsOCxhuCwoeCxjeCwoeCwvyDgsKTgsL7gsJ8=?= =?utf-8?b?4LC/4LCq4LCw4LGN4LCk4LC/KQ==?=)
Date: Mon, 22 Oct 2018 11:38:00 +0000
Subject: [docs] [issue35042] Use the role :pep: for the PEP \d+
In-Reply-To: <1540195863.27.0.788709270274.issue35042@psf.upfronthosting.co.za>
Message-ID: <1540208280.85.0.788709270274.issue35042@psf.upfronthosting.co.za>


Srinivas  Reddy Thatiparthy(?????????? ?????? ?????????) <thatiparthysreenivas at gmail.com> added the comment:

This gives us the hyperlink everywhere a PEP is referenced?

----------
nosy: +thatiparthy

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

From report at bugs.python.org  Mon Oct 22 07:47:27 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Mon, 22 Oct 2018 11:47:27 +0000
Subject: [docs] [issue35042] Use the role :pep: for the PEP \d+
In-Reply-To: <1540195863.27.0.788709270274.issue35042@psf.upfronthosting.co.za>
Message-ID: <1540208847.12.0.788709270274.issue35042@psf.upfronthosting.co.za>


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

sure, it's the default behavior of this role, I have a PR with the fix, but Github has a big issue with the PRs :/

----------

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

From report at bugs.python.org  Mon Oct 22 08:07:50 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Mon, 22 Oct 2018 12:07:50 +0000
Subject: [docs] [issue35044] Use the :exc: role for the exceptions in the doc
Message-ID: <1540210070.18.0.788709270274.issue35044@psf.upfronthosting.co.za>


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

In the doc, there is some locations where we do not use the :exc: role for the exceptions, I try to fix that with this PR.

----------
assignee: docs at python
components: Documentation
messages: 328249
nosy: docs at python, matrixise
priority: normal
severity: normal
status: open
title: Use the :exc: role for the exceptions in the doc
versions: Python 3.6, Python 3.7, Python 3.8

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

From report at bugs.python.org  Mon Oct 22 08:47:52 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 22 Oct 2018 12:47:52 +0000
Subject: [docs] [issue35042] Use the role :pep: for the PEP \d+
In-Reply-To: <1540195863.27.0.788709270274.issue35042@psf.upfronthosting.co.za>
Message-ID: <1540212472.47.0.788709270274.issue35042@psf.upfronthosting.co.za>


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

What is wrong with the current code? Why replace :PEP: with :pep:?

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

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

From report at bugs.python.org  Mon Oct 22 08:54:19 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Mon, 22 Oct 2018 12:54:19 +0000
Subject: [docs] [issue35042] Use the role :pep: for the PEP \d+
In-Reply-To: <1540195863.27.0.788709270274.issue35042@psf.upfronthosting.co.za>
Message-ID: <1540212859.66.0.788709270274.issue35042@psf.upfronthosting.co.za>


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

in fact, in the doc of Sphinx, it's just :pep: and not :PEP:

see http://www.sphinx-doc.org/en/master/usage/restructuredtext/roles.html?highlight=%3Apep%3A#role-pep

in this case, I think it's better to use the "reference" and use pep in lowercase.

----------

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

From report at bugs.python.org  Mon Oct 22 10:46:14 2018
From: report at bugs.python.org (=?utf-8?b?U3Jpbml2YXMgIFJlZGR5IFRoYXRpcGFydGh5KOCwtuCxjeCwsOCxgOCwqA==?= =?utf-8?b?4LC/4LC14LC+4LC44LGNIOCwsOCxhuCwoeCxjeCwoeCwvyDgsKTgsL7gsJ8=?= =?utf-8?b?4LC/4LCq4LCw4LGN4LCk4LC/KQ==?=)
Date: Mon, 22 Oct 2018 14:46:14 +0000
Subject: [docs] [issue35042] Use the role :pep: for the PEP \d+
In-Reply-To: <1540195863.27.0.788709270274.issue35042@psf.upfronthosting.co.za>
Message-ID: <1540219574.26.0.788709270274.issue35042@psf.upfronthosting.co.za>


Srinivas  Reddy Thatiparthy(?????????? ?????? ?????????) <thatiparthysreenivas at gmail.com> added the comment:

I am -0 on this. I want to hear a more compelling argument than wanting to leverage an existing feature.

IMHO, when i am reading the documentation i never bothered to go into the PEP docs - most of the times. I explicitly visited a PEP when i want to understand the rationale of a feature.

My 2 cents.

----------

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

From report at bugs.python.org  Mon Oct 22 10:53:58 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Mon, 22 Oct 2018 14:53:58 +0000
Subject: [docs] [issue35042] Use the role :pep: for the PEP \d+
In-Reply-To: <1540195863.27.0.788709270274.issue35042@psf.upfronthosting.co.za>
Message-ID: <1540220038.81.0.788709270274.issue35042@psf.upfronthosting.co.za>


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

@thatiparthy

When you start to contribute to Python, and you see there is a PEP in the doc.

1. What's a PEP?
2. Where can I find the PEP XYZ?
3. Am I on the right website for the PEP?

if you don't know the concept of the PEPs, you will check with your favorite search engine because you are a developer. This is not the case for everybody.

For a newcomer/beginner, read the right information just with a click, it's just the founding principles of the Web.

create a link is not a real problem for a computer and for the end-user will be happy.

----------

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

From report at bugs.python.org  Mon Oct 22 10:57:58 2018
From: report at bugs.python.org (Julien Palard)
Date: Mon, 22 Oct 2018 14:57:58 +0000
Subject: [docs] [issue35042] Use the role :pep: for the PEP \d+
In-Reply-To: <1540195863.27.0.788709270274.issue35042@psf.upfronthosting.co.za>
Message-ID: <1540220278.48.0.788709270274.issue35042@psf.upfronthosting.co.za>


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

When mentionning a PEP I see no reason not to point to it, and as it's easy to do with the pep role, I'm +1 on this.

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

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

From report at bugs.python.org  Mon Oct 22 13:34:00 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Mon, 22 Oct 2018 17:34:00 +0000
Subject: [docs] [issue35042] Use the role :pep: for the PEP \d+
In-Reply-To: <1540195863.27.0.788709270274.issue35042@psf.upfronthosting.co.za>
Message-ID: <1540229640.14.0.788709270274.issue35042@psf.upfronthosting.co.za>


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

If I am understanding this correctly the :pep: role is already present and only that PEP references that don't have this role are being updated now?

?  cpython git:(master) rg ':pep:`\d+`' | grep 'rst' | grep -Ev 'NEWS|whatsnew' | wc
     324    2686   27228

References that don't have the role are being updated along with :PEP: changed to :pep: in the PR? (Around 30 entries) 

?  cpython git:(master) rg 'PEP \d+' | grep 'rst' | grep -Ev 'NEWS|whatsnew' | wc
      21     228    1891
?  cpython git:(master) rg ':PEP:`\d+`' | grep 'rst' | grep -Ev 'NEWS|whatsnew' | wc
       6      51     517

I think older NEWS entries can be left behind like the PR changes whatsnew for Python 2.0, 2.1, 2.5 and they won't be back ported I personally feel little value in changing them though doc changes have been done on those files in 2016 and up to the reviewer.

Thanks

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

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

From report at bugs.python.org  Mon Oct 22 14:36:18 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Mon, 22 Oct 2018 18:36:18 +0000
Subject: [docs] [issue35044] Use the :exc: role for the exceptions in the doc
In-Reply-To: <1540210070.18.0.788709270274.issue35044@psf.upfronthosting.co.za>
Message-ID: <1540233378.83.0.702299269573.issue35044@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Mon Oct 22 16:13:19 2018
From: report at bugs.python.org (Martin Panter)
Date: Mon, 22 Oct 2018 20:13:19 +0000
Subject: [docs] [issue28960] Small typo in Thread.join docs
In-Reply-To: <1481636284.79.0.913462681395.issue28960@psf.upfronthosting.co.za>
Message-ID: <1540239199.24.0.702299269573.issue28960@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Mon Oct 22 17:40:50 2018
From: report at bugs.python.org (Julien Palard)
Date: Mon, 22 Oct 2018 21:40:50 +0000
Subject: [docs] [issue35033] Column or row spanning cells are not
 implemented.
In-Reply-To: <1540052915.48.0.788709270274.issue35033@psf.upfronthosting.co.za>
Message-ID: <1540244450.39.0.788709270274.issue35033@psf.upfronthosting.co.za>


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

POC is now a PR: https://github.com/sphinx-doc/sphinx/pull/5559

----------

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

From report at bugs.python.org  Mon Oct 22 18:00:19 2018
From: report at bugs.python.org (Ned Deily)
Date: Mon, 22 Oct 2018 22:00:19 +0000
Subject: [docs] [issue34901] Missing isolated (-I) flag in sys.flags table
In-Reply-To: <1538718824.99.0.545547206417.issue34901@psf.upfronthosting.co.za>
Message-ID: <1540245619.31.0.788709270274.issue34901@psf.upfronthosting.co.za>


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


New changeset da7d7d0ccc2e7cab62080e146cab027f2aa6fd03 by Ned Deily (danishprakash) in branch '3.6':
[3.6] bpo-34901: add -I flag to sys.flags (GH-9755)
https://github.com/python/cpython/commit/da7d7d0ccc2e7cab62080e146cab027f2aa6fd03


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

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

From report at bugs.python.org  Mon Oct 22 18:01:57 2018
From: report at bugs.python.org (Ned Deily)
Date: Mon, 22 Oct 2018 22:01:57 +0000
Subject: [docs] [issue34901] Missing isolated (-I) flag in sys.flags table
In-Reply-To: <1538718824.99.0.545547206417.issue34901@psf.upfronthosting.co.za>
Message-ID: <1540245717.17.0.788709270274.issue34901@psf.upfronthosting.co.za>


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

Thanks, Danish and everyone else!

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

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

From report at bugs.python.org  Tue Oct 23 02:11:26 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Tue, 23 Oct 2018 06:11:26 +0000
Subject: [docs] [issue34748] Incorrect HTML link in functools.partial
In-Reply-To: <1537442713.28.0.956365154283.issue34748@psf.upfronthosting.co.za>
Message-ID: <1540275085.76.0.788709270274.issue34748@psf.upfronthosting.co.za>


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


New changeset 83a07652e0033f0d9994ae7634b91d6581c56b00 by Xiang Zhang (Andrei Petre) in branch 'master':
bpo-34748: link to :ref:`partial-objects` in functools.partial doc. (GH-9809)
https://github.com/python/cpython/commit/83a07652e0033f0d9994ae7634b91d6581c56b00


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

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

From report at bugs.python.org  Tue Oct 23 02:11:39 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 23 Oct 2018 06:11:39 +0000
Subject: [docs] [issue34748] Incorrect HTML link in functools.partial
In-Reply-To: <1537442713.28.0.956365154283.issue34748@psf.upfronthosting.co.za>
Message-ID: <1540275099.48.0.702299269573.issue34748@psf.upfronthosting.co.za>


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


----------
pull_requests: +9384

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

From report at bugs.python.org  Tue Oct 23 02:11:49 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 23 Oct 2018 06:11:49 +0000
Subject: [docs] [issue34748] Incorrect HTML link in functools.partial
In-Reply-To: <1537442713.28.0.956365154283.issue34748@psf.upfronthosting.co.za>
Message-ID: <1540275109.06.0.702299269573.issue34748@psf.upfronthosting.co.za>


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


----------
pull_requests: +9385

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

From report at bugs.python.org  Tue Oct 23 02:16:47 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 23 Oct 2018 06:16:47 +0000
Subject: [docs] [issue34748] Incorrect HTML link in functools.partial
In-Reply-To: <1537442713.28.0.956365154283.issue34748@psf.upfronthosting.co.za>
Message-ID: <1540275407.37.0.788709270274.issue34748@psf.upfronthosting.co.za>


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


New changeset fc62c7223ed1ecd422e870cf7bfc23060444450a by Miss Islington (bot) in branch '3.7':
bpo-34748: link to :ref:`partial-objects` in functools.partial doc. (GH-9809)
https://github.com/python/cpython/commit/fc62c7223ed1ecd422e870cf7bfc23060444450a


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

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

From report at bugs.python.org  Tue Oct 23 02:16:55 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 23 Oct 2018 06:16:55 +0000
Subject: [docs] [issue34748] Incorrect HTML link in functools.partial
In-Reply-To: <1537442713.28.0.956365154283.issue34748@psf.upfronthosting.co.za>
Message-ID: <1540275415.09.0.788709270274.issue34748@psf.upfronthosting.co.za>


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


New changeset 42892a2a38bb97c41e7b1b154e2b5b6f13d27b57 by Miss Islington (bot) in branch '3.6':
bpo-34748: link to :ref:`partial-objects` in functools.partial doc. (GH-9809)
https://github.com/python/cpython/commit/42892a2a38bb97c41e7b1b154e2b5b6f13d27b57


----------

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

From report at bugs.python.org  Tue Oct 23 02:17:44 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Tue, 23 Oct 2018 06:17:44 +0000
Subject: [docs] [issue34748] Incorrect HTML link in functools.partial
In-Reply-To: <1537442713.28.0.956365154283.issue34748@psf.upfronthosting.co.za>
Message-ID: <1540275464.67.0.702299269573.issue34748@psf.upfronthosting.co.za>


Change by Xiang Zhang <angwerzx at 126.com>:


----------
pull_requests: +9386

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

From report at bugs.python.org  Tue Oct 23 02:43:14 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Tue, 23 Oct 2018 06:43:14 +0000
Subject: [docs] [issue34748] Incorrect HTML link in functools.partial
In-Reply-To: <1537442713.28.0.956365154283.issue34748@psf.upfronthosting.co.za>
Message-ID: <1540276994.12.0.788709270274.issue34748@psf.upfronthosting.co.za>


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


New changeset 56a4a3aa555b3abc756cf837eddac4c0bf545db7 by Xiang Zhang in branch '2.7':
[2.7] bpo-34748: link to :ref:`partial-objects` in functools.partial doc. (GH-9809)
https://github.com/python/cpython/commit/56a4a3aa555b3abc756cf837eddac4c0bf545db7


----------

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

From report at bugs.python.org  Tue Oct 23 02:47:19 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Tue, 23 Oct 2018 06:47:19 +0000
Subject: [docs] [issue34748] Incorrect HTML link in functools.partial
In-Reply-To: <1537442713.28.0.956365154283.issue34748@psf.upfronthosting.co.za>
Message-ID: <1540277238.97.0.788709270274.issue34748@psf.upfronthosting.co.za>


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

Thanks all. :-)

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

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

From report at bugs.python.org  Tue Oct 23 07:56:12 2018
From: report at bugs.python.org (=?utf-8?b?U3Jpbml2YXMgIFJlZGR5IFRoYXRpcGFydGh5KOCwtuCxjeCwsOCxgOCwqA==?= =?utf-8?b?4LC/4LC14LC+4LC44LGNIOCwsOCxhuCwoeCxjeCwoeCwvyDgsKTgsL7gsJ8=?= =?utf-8?b?4LC/4LCq4LCw4LGN4LCk4LC/KQ==?=)
Date: Tue, 23 Oct 2018 11:56:12 +0000
Subject: [docs] [issue29341] Missing accepting path-like object in
 docstrings of os module functions
In-Reply-To: <1485064061.59.0.597221589705.issue29341@psf.upfronthosting.co.za>
Message-ID: <1540295772.0.0.702299269573.issue29341@psf.upfronthosting.co.za>


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


----------
nosy: +thatiparthy

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

From report at bugs.python.org  Tue Oct 23 13:45:03 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 23 Oct 2018 17:45:03 +0000
Subject: [docs] [issue35054] Add more index entries for symbols
Message-ID: <1540316703.62.0.788709270274.issue35054@psf.upfronthosting.co.za>


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

The proposed PR adds index entries for all operators, syntax elements and keywords. It also adds index entries for symbols in related minilanguages:

* escape sequences in string literals
* metacharacters and escape sequences in regular expressions
* symbols in printf-style formatting, string formatting, f-strings and template strings
* special symbols for OS (pathnames and interpolation)
* special symbols in doctests
* and others

Also fixed several errors in formatting.

----------
assignee: docs at python
components: Documentation
messages: 328329
nosy: docs at python, eric.araujo, ezio.melotti, georg.brandl, serhiy.storchaka, willingc
priority: normal
severity: normal
status: open
title: Add more index entries for symbols
type: enhancement
versions: Python 3.6, Python 3.7, Python 3.8

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

From report at bugs.python.org  Tue Oct 23 13:46:24 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 23 Oct 2018 17:46:24 +0000
Subject: [docs] [issue35054] Add more index entries for symbols
In-Reply-To: <1540316703.62.0.788709270274.issue35054@psf.upfronthosting.co.za>
Message-ID: <1540316784.68.0.702299269573.issue35054@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Tue Oct 23 15:38:54 2018
From: report at bugs.python.org (Luna Chen)
Date: Tue, 23 Oct 2018 19:38:54 +0000
Subject: [docs] [issue29341] Missing accepting path-like object in
 docstrings of os module functions
In-Reply-To: <1485064061.59.0.597221589705.issue29341@psf.upfronthosting.co.za>
Message-ID: <1540323533.98.0.788709270274.issue29341@psf.upfronthosting.co.za>


Luna Chen <luna at bnmetrics.com> added the comment:

Farhaan Bukhsh: you said you wanted to work on this but that was over a month ago, so I presume you've directed your attention elsewhere, and I'd like to give this a try.

----------
nosy: +BNMetrics -thatiparthy

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

From report at bugs.python.org  Wed Oct 24 12:31:13 2018
From: report at bugs.python.org (Marcus)
Date: Wed, 24 Oct 2018 16:31:13 +0000
Subject: [docs] [issue34895] Mark optional stdlib modules in documentation
In-Reply-To: <1538670818.19.0.545547206417.issue34895@psf.upfronthosting.co.za>
Message-ID: <1540398673.4.0.788709270274.issue34895@psf.upfronthosting.co.za>


Marcus <of4tvziy at online.de> added the comment:

My concern is that certain missing build-time dependencies do not stop the build but trigger an easy to miss message at the end of the build stage (only). Also the end user doesn't get to see this. At the same time these modules are sort of expected to be part of a complete Python distribution.

Two issues I see with this: 1. By omission, the distributor might inadvertently create an incomplete distribution. 2. The enduser, running a script (possibly created elsewhere) receives a standard ?ModuleNotFoundError? and is left in the dark about its origin as the documentation seems to confirm that the affected module ought to be available.

$ grep -F missing.append setup.py
             missing.append('spwd')
             missing.append('readline')
             missing.append('_ssl')
             missing.append('_hashlib')
             missing.append('_sqlite3')
                 missing.append('_dbm')
             missing.append('_gdbm')
             missing.append('nis')
             missing.append('_curses')
             missing.append('_curses_panel')
                     missing.append('zlib')
                 missing.append('zlib')
             missing.append('zlib')
             missing.append('_bz2')
             missing.append('_lzma')
             missing.append('_elementtree')
             missing.append('ossaudiodev')
             missing.append('_tkinter')
             missing.append('_uuid')

All modules in the above list are potentially affected, although some (ossaudiodev, nis) might be considered platform specific. Arguably availablility some of these modules could be perhaps turned into build-time requirements with opt-out mechanics.

In any case a hint to the end user debugging such issues would be rather helpful and a big timesaver (see initial report).

----------

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

From report at bugs.python.org  Wed Oct 24 16:05:10 2018
From: report at bugs.python.org (Sergey Fedoseev)
Date: Wed, 24 Oct 2018 20:05:10 +0000
Subject: [docs] [issue23460] Decimals do not obey ':g' exponential notation
 formatting rules
In-Reply-To: <1423847721.13.0.666007782647.issue23460@psf.upfronthosting.co.za>
Message-ID: <1540411510.94.0.702299269573.issue23460@psf.upfronthosting.co.za>


Change by Sergey Fedoseev <fedoseev.sergey at gmail.com>:


----------
nosy: +sir-sigurd

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

From report at bugs.python.org  Thu Oct 25 11:46:39 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Thu, 25 Oct 2018 15:46:39 +0000
Subject: [docs] [issue35038] AttributeError: 'frame' object has no attribute
 'f_restricted'
In-Reply-To: <1540134122.28.0.788709270274.issue35038@psf.upfronthosting.co.za>
Message-ID: <1540482399.28.0.702299269573.issue35038@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Oct 25 11:47:05 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Thu, 25 Oct 2018 15:47:05 +0000
Subject: [docs] [issue35038] AttributeError: 'frame' object has no attribute
 'f_restricted'
In-Reply-To: <1540134122.28.0.788709270274.issue35038@psf.upfronthosting.co.za>
Message-ID: <1540482425.2.0.788709270274.issue35038@psf.upfronthosting.co.za>


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

I have proposed a PR.

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

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

From rajagopal3806 at gmail.com  Thu Oct  4 09:12:29 2018
From: rajagopal3806 at gmail.com (Rajagopal Aswin)
Date: Thu, 04 Oct 2018 13:12:29 -0000
Subject: [docs] Request for language reference - regds
Message-ID: <CAMX94-sBZZ40ydYJt_+FXKBgQXn2-AVTEWhRwsap0mH05AE6BQ@mail.gmail.com>

Dear Sir/Madam,

Hi, I am Rajagopal, @ Aswin, I'm doing my Post Graduate in Salem,
Tamilnadu, India. I requesting you to send me the Core & advanced level of
Python Documentation for my Educational and Development Purpose. Kindly
I'm asking you for the language reference of Python.

I search in your website but I don't know that is the full documentation or
either else.

please send me this as soon. as possible.




--
Rajagopal V
Mobile No: 9443195053
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181004/d703fa9f/attachment-0001.html>

From Bill_Tonnies at Jabil.com  Fri Oct 12 07:41:26 2018
From: Bill_Tonnies at Jabil.com (Bill Tonnies)
Date: Fri, 12 Oct 2018 11:41:26 +0000
Subject: [docs] Out-of-date URL
Message-ID: <BLUPR02MB1700D6EF5B7EF50A1F50C1C8E9E20@BLUPR02MB1700.namprd02.prod.outlook.com>

Hello,

I tried the example (around the middle of the page) on https://docs.python.org/3/library/pprint.html. http://pypi.org/project/Twisted/json doesn't seem to be a valid URL any more.

Regards,

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

From meetsivanagaraju at gmail.com  Mon Oct 15 13:10:31 2018
From: meetsivanagaraju at gmail.com (SIVANAGARAJU G)
Date: Mon, 15 Oct 2018 22:40:31 +0530
Subject: [docs] Unable to download document
Message-ID: <CAHoU5g=k+FxrzgNL_0erxWRffZ_a973firCiX2QmhawO3L7qdQ@mail.gmail.com>

Hi,

When I am trying to download A4 size .zip format file I'm getting the below
message on screen, 404- not found.

https://docs.python.org/3/archives/python-3.7.1rc2-docs-pdf-a4.zip

Please work it out ASAP
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181015/8df0d02f/attachment-0001.html>

From rj.amdphreak at gmail.com  Mon Oct 15 19:27:24 2018
From: rj.amdphreak at gmail.com (Ryan Johnson)
Date: Mon, 15 Oct 2018 18:27:24 -0500
Subject: [docs] EPub documentation is missing
Message-ID: <2A579FFD-B0C4-47D7-B9CE-4BEC6CBA553A@gmail.com>

Wanted to download EPub, but the link is dead. Checked the directory where the text and pdfs are stored and the file does not exist. Would appreciate it being added back.

From ranajitnath7 at gmail.com  Tue Oct 16 03:23:51 2018
From: ranajitnath7 at gmail.com (Ranajit)
Date: Tue, 16 Oct 2018 12:53:51 +0530
Subject: [docs] Documentation Download option not Working [HTTP 404]
Message-ID: <1965d573-5920-70d3-c338-c565f2da6886@gmail.com>

Dear Developers,

 ??? ??? ??? As a user, we need full documentation sometime in offline 
mode. But download link is not working right now... Please solve this 
error for us...

 ??? ??? ??? ??? ??? ??? ??? ??? ??? ??? ??? ??? ??? Thanking You

R.Nath


From ldg.sardoni at gmail.com  Tue Oct 16 07:31:29 2018
From: ldg.sardoni at gmail.com (Gabriele Sardoni)
Date: Tue, 16 Oct 2018 13:31:29 +0200
Subject: [docs] Download PDF docs for Python 3.6
Message-ID: <CAOdbQe-5rs6heeWN=TPLKhM-v-xu44AjRSGdpdG1xE3wq+Vsqg@mail.gmail.com>

Hello,
I try to download PDF docs for Python 3.6 but it seem does not exists.
At
https://docs.python.org/3.6/download.html
all document are linked but in
https://docs.python.org/3.6/archives/
there are html and text only.

Can you help me?
Thanks
Gabriele Sardoni (Italy)
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181016/858e931b/attachment-0001.html>

From donovan.d at hotmail.co.uk  Tue Oct 16 17:01:17 2018
From: donovan.d at hotmail.co.uk (Daniel Donovan)
Date: Tue, 16 Oct 2018 21:01:17 +0000
Subject: [docs] Download Docs Links
Message-ID: <AM6PR05MB490243B9318379EAB4E84048ABFE0@AM6PR05MB4902.eurprd05.prod.outlook.com>

Hi

The download links for the documents are raising 404s. Specifically the 
PDF download links.

Thanks

Daniel Donovan


From steve at constantlynew.net  Tue Oct 16 19:59:05 2018
From: steve at constantlynew.net (Steve Turpin)
Date: Tue, 16 Oct 2018 17:59:05 -0600
Subject: [docs] Download Python 3.7.1rc2 Documentation
Message-ID: <E45A71AD-0543-415C-91FF-B08026C33142@constantlynew.net>

Only the html files exist.

Steve

From sebastian.aberastury at outlook.com  Tue Oct 16 21:58:33 2018
From: sebastian.aberastury at outlook.com (=?iso-8859-1?Q?Sebasti=E1n_Aberastury?=)
Date: Wed, 17 Oct 2018 01:58:33 +0000
Subject: [docs] Hello Documentation download link give 404
Message-ID: <DM5PR01MB22831DCF9AF7EE93A71F2F4B8AFF0@DM5PR01MB2283.prod.exchangelabs.com>

Hello,

I'm trying to download the documentation from https<https://docs.python.org/3.6/download.html>://<https://docs.python.org/3.6/download.html>docs.python.org<https://docs.python.org/3.6/download.html>/3.6/<https://docs.python.org/3.6/download.html>download.html<https://docs.python.org/3.6/download.html> but a 404 error appears.

Thank you!

Get Outlook for Android<https://aka.ms/ghei36>

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

From spolischook at gmail.com  Wed Oct 17 02:05:45 2018
From: spolischook at gmail.com (Serhii Polishchuk)
Date: Wed, 17 Oct 2018 09:05:45 +0300
Subject: [docs] 404 link to doc
Message-ID: <CAGJ6LO7_OnsSOUVGqJTv6szfmqz1+=iU89Gk=2o0LV=JXP5QBg@mail.gmail.com>

https://docs.python.org/3.6/download.html epub link return 404. Same for 3.7
-- 

---
Regards
Serhii Polishchuk
+380 93 418 75 75
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181017/c0d3ca9d/attachment-0001.html>

From joeydanieldarko at gmail.com  Thu Oct 18 11:18:30 2018
From: joeydanieldarko at gmail.com (Joey daniel darko)
Date: Thu, 18 Oct 2018 16:18:30 +0100
Subject: [docs] File not Found
Message-ID: <CAHJqn5zutvC2JEYOb_-8bd0MoquzD+v_TOW-xp_KgNaNoV6naQ@mail.gmail.com>

Hi, trying to download the  PDF lin
<https://docs.python.org/3/archives/python-3.7.1rc2-docs-pdf-letter.zip>k
copy of the python3.7 docs but  files cannot be found . Nginx seems to
throw a 404 error.

Thanks
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181018/5789bd74/attachment-0001.html>

From pol.mollitor at education.lu  Fri Oct 19 04:06:44 2018
From: pol.mollitor at education.lu (Pol Mollitor)
Date: Fri, 19 Oct 2018 10:06:44 +0200
Subject: [docs] documentation pdf
Message-ID: <5a9d02ec-649a-b3fa-7834-953fb2845f5a@education.lu>

Good morning,

I wanted to let you know that the python documentation in pdf format is 
currently not available.

Could you please update the link?

Best regards,

Pol Mollitor


From egger at cs.fau.de  Fri Oct 19 05:53:23 2018
From: egger at cs.fau.de (Christoph Egger)
Date: Fri, 19 Oct 2018 11:53:23 +0200
Subject: [docs] ssl.create_default_context
Message-ID: <6952F732-C7D2-43A3-8FB7-1AEDB1CE4FF3@cs.fau.de>

Hi!

```
The settings are: PROTOCOL_TLS, OP_NO_SSLv2, and OP_NO_SSLv3 with high encryption cipher suites without RC4 and without unauthenticated cipher suites. Passing SERVER_AUTH as purpose sets verify_mode to CERT_REQUIRED and either loads CA certificates (when at least one of cafile, capath or cadata is given) or uses SSLContext.load_default_certs() to load default CA certificates.
```

`SERVER_AUTH` not only sets `CERT_REQUIRED` but also `check_hostname` to `True`. As this is critical information for users with some familiarity with python?s SSL library the documentation should mention it (especially as it talks explicitly about the `CERT_REQUIRED` part)

https://github.com/python/cpython/blob/master/Lib/ssl.py#L567

Thanks!

  Christoph
-------------- next part --------------
A non-text attachment was scrubbed...
Name: smime.p7s
Type: application/pkcs7-signature
Size: 5315 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20181019/1037b70a/attachment-0001.bin>

From chinnathan at gmail.com  Fri Oct 19 06:41:35 2018
From: chinnathan at gmail.com (Chinnathan Chongsujiphan)
Date: Fri, 19 Oct 2018 17:41:35 +0700
Subject: [docs] The links for Download Python 3.7.1rc2 Documentation are not
 working
Message-ID: <1F549ECC-8DCD-49C1-A7B5-7286E4914444@gmail.com>

https://docs.python.org/3/download.html

From bit.nebulae at gmail.com  Fri Oct 19 15:53:19 2018
From: bit.nebulae at gmail.com (Sorin Szabo)
Date: Fri, 19 Oct 2018 20:53:19 +0100
Subject: [docs] Missing documentation in PDF format
Message-ID: <CA+vrZ_fkLukpv9uzKD0yEBrW9e446oB6P5eeivWPeupX8pBMiQ@mail.gmail.com>

Hi,
I've been trying to download the python documentation in pdf format without
success. The files appear to be missing.
This is the page where I'm trying to access the files
https://docs.python.org/3.6/download.html
The link to the file is this one:
https://docs.python.org/3.6/archives/python-3.6.7rc2-docs-pdf-letter.zip
There may be more than one file missing.
Thanks!
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181019/f842e594/attachment-0001.html>

From wonil at google.com  Sat Oct 20 09:15:29 2018
From: wonil at google.com (Wonil Kim)
Date: Sat, 20 Oct 2018 22:15:29 +0900
Subject: [docs] Document download link broken
Message-ID: <CAEF_iNwrFJMv8NVR9KS42hkwcYh0WGm9F_xZXGNYbLoFzpS-Jg@mail.gmail.com>

https://docs.python.org/3/download.html

Download links in the above page broken.

https://docs.python.org/3/archives/python-3.7.1rc2-docs-pdf-letter.zip

It shows 404 Not Found. Thanks.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181020/fda7fae4/attachment-0001.html>

From internet3 at protonmail.com  Sat Oct 20 20:28:28 2018
From: internet3 at protonmail.com (Internet3)
Date: Sun, 21 Oct 2018 00:28:28 +0000
Subject: [docs] documentation download links are broken
Message-ID: <BxbOLknwSeX9G4jNA5ub5AL37dng1W258vORLR5b951NZir6bdgu5q1x_n5kP0y1xffS8M_c71G_gCAhS_rD9-mX5h-O4wfZCVUiIr4b-aY=@protonmail.com>

Hello,

The html and US Letter PDF download links are broken. Would you please fix them and email me when they are working again?

Thank you!

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

From buraphalinuxserver at gmail.com  Sun Oct 21 02:23:41 2018
From: buraphalinuxserver at gmail.com (Somchai Smythe)
Date: Sun, 21 Oct 2018 13:23:41 +0700
Subject: [docs] python 3.6.7 and 3.7.1 PDF downloads do not exist
Message-ID: <CAFJqGkOw4pmJAGErDSLmBjAxtVLO+zpP7V_Fs+OUVA7GHONQ-g@mail.gmail.com>

python 3.6.7 and 3.7.1 PDF downloads do not exist in either letter or
A4, in either tarball or zip file formats.  Please make them available
at least for A4 tarball format.

From sushma.mukherjee at gmail.com  Sun Oct 21 02:46:45 2018
From: sushma.mukherjee at gmail.com (Sushma Mukherjee)
Date: Sun, 21 Oct 2018 12:16:45 +0530
Subject: [docs] Problem with Python 3.7.0
Message-ID: <CANe7tZXf+e30LUx0fhcn5iT5_yjm+QmGrRbHbXZjjE70=Ry5yQ@mail.gmail.com>

Sir/Madam,

I have installed Python 3.7 in my machine (OS- win7) .The interpreter
screen is working fine. Presently, I am writing scripts using notepad.

I want to work on the IDE to write scripts. Since I am a teacher I think an
IDE would be easier for the students.

Please help.

-- 
Sushma Mukherjee
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181021/c17f3b9c/attachment-0001.html>

From chris.r.nahon at gmail.com  Sun Oct 21 05:26:20 2018
From: chris.r.nahon at gmail.com (Chris N)
Date: Sun, 21 Oct 2018 20:26:20 +1100
Subject: [docs] Broken Doc Links
Message-ID: <5bcc463c.1c69fb81.79090.2916@mx.google.com>

Page:
Download Python 3.7.1 Documentation
https://docs.python.org/3/download.html

404 for all .pdf and .epub links on page.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181021/12bf6984/attachment-0001.html>

From andreas at kagedal.org  Sun Oct 21 06:54:22 2018
From: andreas at kagedal.org (=?UTF-8?Q?Andreas_K=C3=A5gedal?=)
Date: Sun, 21 Oct 2018 12:54:22 +0200
Subject: [docs] (no subject)
Message-ID: <CAC0DRKS=7PXhc-nYaccJxB3hUsP-QWRuHFsQdGSRSK3kLe84QQ@mail.gmail.com>

Hi, the download links on https://docs.python.org/3/download.html don't
seem to work. I get 404 errors.

Is this a known problem?

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

From farzand.ranchi at gmail.com  Sun Oct 21 11:47:15 2018
From: farzand.ranchi at gmail.com (Farzand Ahmad Khan)
Date: Sun, 21 Oct 2018 21:17:15 +0530
Subject: [docs] Error while trying to download PDF of python docs
Message-ID: <CAMVcD3bmPUNN41bvXOtFjQQScnbf7eFYm2+2MVacpOcj7i-d2w@mail.gmail.com>

Hi
I was trying to download PDF for python docs but in the process, I
encountered a 404 NOT FOUND. Please look into it. I have also attached a
screenshot of the incident with this email.

Aapka Apna
Farzand
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181021/82ffe221/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: error.jpg
Type: image/jpeg
Size: 68767 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20181021/82ffe221/attachment-0001.jpg>

From jofra.figueroa at gmail.com  Sun Oct 21 12:01:31 2018
From: jofra.figueroa at gmail.com (Jofra Figueroa C)
Date: Sun, 21 Oct 2018 11:01:31 -0500
Subject: [docs] Manual Python 3.7.1
Message-ID: <CAO3q1BS2bSsrFgmRECN081ua1JKpGGegTLNHSB1bO8bVhVqJmw@mail.gmail.com>

Python Team ....
I request your support
with the Python manuals See 3.7.1
in order to acquire the knowledge
to make developments on this platform.
You could send me this documentation.

Tutorial

Libary Reference

Lenguage Reference



-- 
Saludos . . .
Jofra Figueroa Candelaria
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181021/570284bc/attachment-0001.html>

From joconnor.pt at gmail.com  Sun Oct 21 18:48:10 2018
From: joconnor.pt at gmail.com (James O'Connor)
Date: Mon, 22 Oct 2018 09:48:10 +1100
Subject: [docs] Links broken on docs download page
Message-ID: <C5A1E4CC-F9F2-4C9C-AAE0-1F94A4B18106@gmail.com>

Hi,

I was just trying to download the documentation from https://docs.python.org/3/download.html <https://docs.python.org/3/download.html> and got a 404 error on both of the PDF .zip versions.

Kind regards

James O'Connor
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181022/7dde0321/attachment-0001.html>

From Bjorn.Madsen at dematic.com  Mon Oct 22 03:57:48 2018
From: Bjorn.Madsen at dematic.com (Madsen, Bjorn)
Date: Mon, 22 Oct 2018 07:57:48 +0000
Subject: [docs] Missing introduction in
 https://docs.python.org/3/library/concurrency.html
Message-ID: <CWXP265MB1654DD2E4D8C3A73ED3D8B5583F40@CWXP265MB1654.GBRP265.PROD.OUTLOOK.COM>

Hello Python docs,
I meet a lot of engineers who start working with python (from Java, C++, ...) due to its higher productivity.  However I've seen a number of examples where the code is "slow" so the engineers seek to use libraries to speed the code up.

Hence why they come to the chapter about concurrency.

Could you, perhaps, extend the documentation of https://docs.python.org/3/library/concurrency.html to include an introduction along the line of this post:

https://stackoverflow.com/a/16031801/1186019 (the author has given permissions in a footnote)

Kind regards

Bjorn Madsen, Ph.D.
Head of System Design Tools
[Beschreibung: Beschreibung: Beschreibung: Dematic Logo]
We Optimise Your Supply Chain

Dematic Limited
Banbury Business Park
Trinity Way
Adderbury
Banbury
OX17 3SN
bjorn.madsen at dematic.com<mailto:bjorn.madsen at dematic.com>
www.dematic.com
________________________________
[dematic][Robotics Signature v4]
[Beschreibung: Beschreibung: Beschreibung: cid:image008.png at 01CD9FF8.7203F460]<http://www.facebook.com/DematicEurope>   [Beschreibung: Beschreibung: Beschreibung: cid:image010.png at 01CD9FF8.7203F460] <http://twitter.com/DematicEurope>    [Beschreibung: Beschreibung: Beschreibung: cid:image012.png at 01CD9FF8.7203F460] <http://www.youtube.com/DematicEurope>    [Beschreibung: Beschreibung: Beschreibung: cid:image014.png at 01CD9FF8.7203F460] <http://plus.google.com/115304913379835534579>    [Beschreibung: Beschreibung: Beschreibung: cid:image005.png at 01CD9FF7.B0B47F50] <http://www.linkedin.com/company/dematic-europe>    News and events on our website<https://www.dematic.com/en-gb/news-and-downloads/news-and-events/>

________________________________
Dematic Limited
Managing Director: Andy Blandford
Registered Office: Banbury Business Park, Trinity Way, Adderbury, Banbury, OX17 3SN Registered in England: 58 56 366
VAT-Reg. No. GB 887674843 | IE 9571438K | DK 30830849
[Beschreibung: Beschreibung: Beschreibung: Description: Description: Tree Icon]   PLEASE CONSIDER THE ENVIRONMENT BEFORE YOU PRINT THIS E-MAIL!
Important Note: This e-mail may contain trade secrets or privileged, undisclosed or otherwise confidential information. If you have received this e-mail in error, you are hereby notified that any review, copying or distribution of it is strictly prohibited. Please inform us immediately and destroy the original transmittal. Thank you for your cooperation.

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181022/964b7bc1/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image001.gif
Type: image/gif
Size: 5942 bytes
Desc: image001.gif
URL: <http://mail.python.org/pipermail/docs/attachments/20181022/964b7bc1/attachment-0001.gif>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image002.jpg
Type: image/jpeg
Size: 8061 bytes
Desc: image002.jpg
URL: <http://mail.python.org/pipermail/docs/attachments/20181022/964b7bc1/attachment-0003.jpg>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image005.png
Type: image/png
Size: 1271 bytes
Desc: image005.png
URL: <http://mail.python.org/pipermail/docs/attachments/20181022/964b7bc1/attachment-0005.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image006.png
Type: image/png
Size: 1353 bytes
Desc: image006.png
URL: <http://mail.python.org/pipermail/docs/attachments/20181022/964b7bc1/attachment-0006.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image007.png
Type: image/png
Size: 1220 bytes
Desc: image007.png
URL: <http://mail.python.org/pipermail/docs/attachments/20181022/964b7bc1/attachment-0007.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image008.png
Type: image/png
Size: 1559 bytes
Desc: image008.png
URL: <http://mail.python.org/pipermail/docs/attachments/20181022/964b7bc1/attachment-0008.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image009.png
Type: image/png
Size: 1334 bytes
Desc: image009.png
URL: <http://mail.python.org/pipermail/docs/attachments/20181022/964b7bc1/attachment-0009.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image010.jpg
Type: image/jpeg
Size: 964 bytes
Desc: image010.jpg
URL: <http://mail.python.org/pipermail/docs/attachments/20181022/964b7bc1/attachment-0004.jpg>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image011.jpg
Type: image/jpeg
Size: 12906 bytes
Desc: image011.jpg
URL: <http://mail.python.org/pipermail/docs/attachments/20181022/964b7bc1/attachment-0005.jpg>

From outlook_6D89FEBB5FB0DF4F at outlook.com  Mon Oct 22 07:01:31 2018
From: outlook_6D89FEBB5FB0DF4F at outlook.com (Lucienne Lawrence)
Date: Mon, 22 Oct 2018 11:01:31 +0000
Subject: [docs] Download Python 3.7.1 Documentation
Message-ID: <AM0PR10MB2386D09E810A6D10E332EE24EBF40@AM0PR10MB2386.EURPRD10.PROD.OUTLOOK.COM>

Good Day

When trying to download the documentation, I get an error 404 ?Not Found?.

IS there another link for me to download the PDF (A4 Paper Size) documentation?

Regards

Sent from Mail<https://go.microsoft.com/fwlink/?LinkId=550986> for Windows 10

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

From ankit.jaiswal07 at gmail.com  Mon Oct 22 12:03:13 2018
From: ankit.jaiswal07 at gmail.com (Ankit Jaiswal)
Date: Mon, 22 Oct 2018 21:33:13 +0530
Subject: [docs] Documentation download links broken
Message-ID: <CAE+OURpx2Wb-di+MZ5F=nQf=aoHGgZVeFNrmRR6wYAb88n+fdw@mail.gmail.com>

Hi,

Looks like the download links for Python 3.7.1 documentation are all
broken. I tried all the possible options from the link
https://docs.python.org/3/download.html but none seem to work.

Regards
Ankit
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181022/28a25552/attachment-0001.html>

From ankit.jaiswal07 at gmail.com  Mon Oct 22 12:05:07 2018
From: ankit.jaiswal07 at gmail.com (Ankit Jaiswal)
Date: Mon, 22 Oct 2018 21:35:07 +0530
Subject: [docs] Documentation download links broken
In-Reply-To: <CAE+OURpx2Wb-di+MZ5F=nQf=aoHGgZVeFNrmRR6wYAb88n+fdw@mail.gmail.com>
References: <CAE+OURpx2Wb-di+MZ5F=nQf=aoHGgZVeFNrmRR6wYAb88n+fdw@mail.gmail.com>
Message-ID: <CAE+OURoma+5JZkbRmJiN9B4Z-pTiv4z64S4=YhqbwBV8CW1y1Q@mail.gmail.com>

Sorry, some of them like HTML version seem to download. However I'm more
interested in the PDF versions.

On Mon, Oct 22, 2018, 21:33 Ankit Jaiswal <ankit.jaiswal07 at gmail.com> wrote:

> Hi,
>
> Looks like the download links for Python 3.7.1 documentation are all
> broken. I tried all the possible options from the link
> https://docs.python.org/3/download.html but none seem to work.
>
> Regards
> Ankit
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181022/fb573015/attachment-0001.html>

From marvin.deutz at yahoo.com  Mon Oct 22 13:29:45 2018
From: marvin.deutz at yahoo.com (Marvin Deutz)
Date: Mon, 22 Oct 2018 19:29:45 +0200
Subject: [docs] Download posting 404
Message-ID: <2AC6550E-4A06-4234-81DE-79083D96E0D8@yahoo.com>

When trying to download the Docs as a PDF it posts the error code 404.

From obamaolu1200 at gmail.com  Mon Oct 22 19:37:22 2018
From: obamaolu1200 at gmail.com (muyiwa david)
Date: Tue, 23 Oct 2018 00:37:22 +0100
Subject: [docs] Python 3.7.1 Doc
Message-ID: <CAL0BV5zhoR7r4zeo1A4ZPZJzOe2gN4cJVGM50tEimo3btvi9aQ@mail.gmail.com>

Hello, I write to you regarding the python 3.7.1 pdf document up for
download, as I wasn't able to download the file, the download link provided
a 404 error message.
Please how can I get the pdf file to the python 3.7.1 doc.

Thanks for your quick response.
Cheers
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181023/96510b37/attachment-0001.html>

From gneuber at physnet.uni-hamburg.de  Tue Oct 23 08:35:15 2018
From: gneuber at physnet.uni-hamburg.de (Gerd Neuber)
Date: Tue, 23 Oct 2018 14:35:15 +0200
Subject: [docs] Python Docs
Message-ID: <24e901b6-94ac-c2c9-1777-edb52efbcf24@physnet.uni-hamburg.de>

Hello,

unfortunately, on the web page

https://docs.python.org/3/download.html,

when trying to download the PDF- or EPUB-format files, I get a 404 error.

May I ask for a fix?

With best regards

G. Neuber

-- 
Dr. Gerd Neuber

University of Hamburg
CHyN - Center for Hybrid Nanostructures

Building 600, Room R2 02 (office) & Room TRO 03 (Helium liquefier)
Luruper Chaussee 149
22761 Hamburg, Germany

Phone +49 40 42838-1587 (office)
       +49 40 42838-5676 (liquefier)


From emilykarp12 at gmail.com  Tue Oct 23 15:03:13 2018
From: emilykarp12 at gmail.com (Emily Karp)
Date: Tue, 23 Oct 2018 15:03:13 -0400
Subject: [docs] Python Tutorial Download
Message-ID: <CAJx1GXhMsSzSOjEgow4HBduw960jjq7VnXLAwLEFteRHKDiwqA@mail.gmail.com>

Hello,

I am trying to download the latest Python documents here:
https://docs.python.org/3/download.html. When I try to download from any of
the links, I get a "404 Not Found" message. How can I download the
documentation? Thank you.

- Emily Karp
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181023/09343cb6/attachment-0001.html>

From katia.seiko at gmail.com  Tue Oct 23 15:53:05 2018
From: katia.seiko at gmail.com (Katia Nakamura)
Date: Tue, 23 Oct 2018 16:53:05 -0300
Subject: [docs] Python Documentation Download
Message-ID: <CALj2bi7AVcjS_qh9w=5QTD5cUBG35H5mWrS7nYc7wAfmdXRg2w@mail.gmail.com>

Hey!

I was trying to download one of the archives containing the documentation
but it seems that all download links are broken.

Could you fix them?

Thanks in advance,

-- 
Katia Nakamura
(11) 972491310
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181023/e85a5d9a/attachment-0001.html>

From andreas at kagedal.org  Tue Oct 23 16:57:58 2018
From: andreas at kagedal.org (=?UTF-8?Q?Andreas_K=C3=A5gedal?=)
Date: Tue, 23 Oct 2018 22:57:58 +0200
Subject: [docs] EPUB links do not work
In-Reply-To: <CAC0DRKS=7PXhc-nYaccJxB3hUsP-QWRuHFsQdGSRSK3kLe84QQ@mail.gmail.com>
References: <CAC0DRKS=7PXhc-nYaccJxB3hUsP-QWRuHFsQdGSRSK3kLe84QQ@mail.gmail.com>
Message-ID: <CAC0DRKRQF0H=xyDKT8Ozvs0=+Jg2z=aLMO+0xYR7DzowAa88Jw@mail.gmail.com>

Hi, to clarify, it is the download links for EPUB and PDFs which do not
work. The others works fine.

Is this according to plan for python 3?
The EPUB link for 3.5.6 works, but the dowloaded file is not possible to
import into my google books library (which is the way I read e-books). I do
not know why.

The EPUB links for 3.6.7
<https://docs.python.org/3.6/archives/python-3.6.7-docs.epub> and 3.7
<https://docs.python.org/3.7/archives/python-3.7.1-docs.epub> do not work
at all.

regards
/Andreas

s?n 21 okt. 2018 kl 12:54 skrev Andreas K?gedal <andreas at kagedal.org>:

> Hi, the download links on https://docs.python.org/3/download.html don't
> seem to work. I get 404 errors.
>
> Is this a known problem?
>
> Andreas
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181023/7f8bfa4f/attachment-0001.html>

From zhangqp at sdas.org  Wed Oct 24 13:55:38 2018
From: zhangqp at sdas.org (=?gbk?B?1cXH78a8?=)
Date: Wed, 24 Oct 2018 13:55:38 +0800(CST)
Subject: [docs] =?gbk?q?cant_download_python_3=2E6=2E7_documentation_pdf?=
Message-ID: <20181024055538.B32B91000CA@mail1.sdas.org>

An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181024/04aa9fb1/attachment-0001.html>

From zhangqiupingsdhz at 163.com  Wed Oct 24 01:57:37 2018
From: zhangqiupingsdhz at 163.com (=?GBK?B?1cXH78a8?=)
Date: Wed, 24 Oct 2018 13:57:37 +0800 (CST)
Subject: [docs] get  python 3.6.7 documentation pdf file failed
Message-ID: <79410953.dc36.166a4a65a22.Coremail.zhangqiupingsdhz@163.com>

hello,
    I tried to download pdf file of python 3.6.7 documentation (PDF (A4 paper size) orPDF (US-Letter paper size)) from website https://docs.python.org/3.6/download.html,
    but it response 404 not found, so how can I get the file now.
    thanks!!!


Cliare Chueng
Mail: zhangqiupingsdhz at 163.com



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

From igor.trawow at mail.ru  Wed Oct 24 02:38:30 2018
From: igor.trawow at mail.ru (=?UTF-8?B?aWdvciB0cmF3b3c=?=)
Date: Wed, 24 Oct 2018 09:38:30 +0300
Subject: [docs] =?utf-8?q?could_not_download_the_documentanion_3=2E7=2E1_?=
 =?utf-8?q?in_pdf_format?=
Message-ID: <1540363110.664691772@f545.i.mail.ru>

-- igor trawow

404 Not Found
----------------------------------------------------------------------
nginx

I could not download the documentanion 3.7.1 in pdf format

but earliar I can download that format of documentation and have on my notebook docs-pdf with? python3.7.0 
-- 
igor trawow
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181024/d8c2e15d/attachment-0001.html>

From john.quirke at gmail.com  Wed Oct 24 09:20:54 2018
From: john.quirke at gmail.com (john q)
Date: Wed, 24 Oct 2018 14:20:54 +0100
Subject: [docs] 404
Message-ID: <CAKLqbTdORdgudZNRibDLMhE7-ftgm+8eO7TmJZ9FAM_ViE_EwA@mail.gmail.com>

The following is returning a 404 on the docs website:
https://docs.python.org/3.7/archives/python-3.7.1-docs.epub
-

*Regardshttps://docs.python.org/3.7/archives/python-3.7.1-docs.epub
<http://docs.python.org/3.7/archives/python-3.7.1-docs.epub>,*

*John Quirke*
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181024/b6f38b4e/attachment-0001.html>

From beatriz.aux.miranda at gmail.com  Wed Oct 24 14:08:04 2018
From: beatriz.aux.miranda at gmail.com (Beatriz Miranda)
Date: Wed, 24 Oct 2018 12:08:04 -0600
Subject: [docs] Problem downloading documentation
Message-ID: <4AC28B36-C664-41A7-A349-1EA80093D002@gmail.com>

Hello,

I?ve been trying to download the following documentation: https://docs.python.org/3/download.html <https://docs.python.org/3/download.html> but it seems like none of the download links are working properly, I get the 404 Not Found error. Is it possible to receive the documentation by email or can you let me know when it is fixed to be able to download the documents?

Thanks in advance!
Beatriz
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181024/33478c86/attachment-0001.html>

From ankit.desai24 at gmail.com  Wed Oct 24 15:50:42 2018
From: ankit.desai24 at gmail.com (ankit desai)
Date: Thu, 25 Oct 2018 01:20:42 +0530
Subject: [docs] Download Links are leading to 404 Error
Message-ID: <CAM9++2e9Mw+1PUYhht-6aoUun2ChU_2v4sNuj8T_FnprfLHjEg@mail.gmail.com>

Hello Sir/Madam,
The download links for pdf version of the Python 3.6.7 lead to 404 not
found error.
Please look into the matter at the earliest.

Thank You,
Ankit Desai
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181025/004486a6/attachment-0001.html>

From t_mike at t-online.de  Wed Oct 24 22:00:17 2018
From: t_mike at t-online.de (Mr. TMike)
Date: Thu, 25 Oct 2018 04:00:17 +0200
Subject: [docs] pdf-download not possible
Message-ID: <A27C9AD5-F0CB-4018-940C-8F79353EE3B1@t-online.de>

Hi guys;

I've tried to download the Python 3.7.1 Documentation as a pdf-file several times;
No chance ;-)
Every time, I get the "404 Not Found" message.
On the page itself, I can read "nginx".

HTML & Plain Text are working.

'Cause I prefer the pdf-option, when do we get the pdf-files?

Kind regards!
Have a good time ;-)

Mike


From Peter at Wannheden.net  Thu Oct 25 03:15:11 2018
From: Peter at Wannheden.net (Peter Wannheden)
Date: Thu, 25 Oct 2018 09:15:11 +0200
Subject: [docs] Download fails
Message-ID: <B8D25B00-1D61-49D9-97D9-9BC4ECDA071B@wannheden.net>

Hello,

I tried to download Python 3.7.1 Documentation from this site:
https://docs.python.org/3/download.html

I was sent here:
https://docs.python.org/3/archives/python-3.7.1-docs-pdf-a4.zip

from where I received "404 Not Found - nginx?.

What?s wrong? Where can I find documents in PDF form?

Regards
Peter Wannheden


From Wannes.Goethals at UGent.be  Thu Oct 25 10:02:59 2018
From: Wannes.Goethals at UGent.be (Wannes Goethals)
Date: Thu, 25 Oct 2018 14:02:59 +0000
Subject: [docs] numpy array division type error
Message-ID: <1540476180182.92538@UGent.be>

Dear beloved reader


I've encountered a problem in python 2.7.13, numpy version 1.15.2


?[cid:36da3939-9ba0-4eb3-8972-a51e563c4c04]?


in the most simple form, it looks like the figure above. When I add the // 1, the dictionary doesn't recognize the type as the normal numpy.int32 even though it says it is.

I don't have a clue what can cause this behaviour, though I can probably work around the problem


Kind regards,

Wannes
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181025/34bf0631/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: pastedImage.png
Type: image/png
Size: 21611 bytes
Desc: pastedImage.png
URL: <http://mail.python.org/pipermail/docs/attachments/20181025/34bf0631/attachment-0001.png>

From zachary.ware+pydocs at gmail.com  Thu Oct 25 12:04:45 2018
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Thu, 25 Oct 2018 11:04:45 -0500
Subject: [docs] Non-working Resources at dkerr.com
In-Reply-To: <CACFK9SsGf9ZgC_aWgrzd5CJOY6HoxKiobOLsnwg5nr4xXQrRXg@mail.gmail.com>
References: <CACFK9SsGf9ZgC_aWgrzd5CJOY6HoxKiobOLsnwg5nr4xXQrRXg@mail.gmail.com>
Message-ID: <CAKJDb-MxKgqg5=Csar5N1AJFtj9jF_7+6Q5dusArcBx-pjePKQ@mail.gmail.com>

Hi Judith,

On Thu, Oct 25, 2018 at 10:56 AM Judith Bennett
<judith.bennett at wilmunimail.org> wrote:
> Good morning, hope you're doing great.
> Not sure if you're the right person, but I was on your guys' website dkerr.com and there are some links that didn't load.
> I made a list of them - do you know who would be the best person to take care of that and who should I send them to?

dkerr.com is not related to python.org, and I have no idea who runs
it.  You'll be much better served to use the official (up to date! :))
Python documentation at docs.python.org.

Regards,
-- 
Zach

From Lauren.Ko at unt.edu  Thu Oct 25 12:32:05 2018
From: Lauren.Ko at unt.edu (Ko, Lauren)
Date: Thu, 25 Oct 2018 16:32:05 +0000
Subject: [docs] Downloading Python documentation
Message-ID: <CY4PR0101MB2950DC916E8259C9D5731646E4F70@CY4PR0101MB2950.prod.exchangelabs.com>

When I try to download the pdf versions of the Python 2 documentation at https://docs.python.org/2/download.html, I get a 403 forbidden error.


Thanks,

Lauren Ko

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181025/4187ca1c/attachment.html>

From zachary.ware+pydocs at gmail.com  Thu Oct 25 12:52:31 2018
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Thu, 25 Oct 2018 11:52:31 -0500
Subject: [docs] Downloading Python documentation
In-Reply-To: <CY4PR0101MB2950DC916E8259C9D5731646E4F70@CY4PR0101MB2950.prod.exchangelabs.com>
References: <CY4PR0101MB2950DC916E8259C9D5731646E4F70@CY4PR0101MB2950.prod.exchangelabs.com>
Message-ID: <CAKJDb-Ow_JVf+gE+wt2T_N55TjLOYZATY3kTOm9KDgKAfvEzUg@mail.gmail.com>

Hi Lauren,

On Thu, Oct 25, 2018 at 11:39 AM Ko, Lauren <Lauren.Ko at unt.edu> wrote:
> When I try to download the pdf versions of the Python 2 documentation at https://docs.python.org/2/download.html, I get a 403 forbidden error.

Thanks for the report!  This should now be fixed.

-- 
Zach

From julien at palard.fr  Thu Oct 25 12:58:38 2018
From: julien at palard.fr (Julien Palard)
Date: Thu, 25 Oct 2018 16:58:38 +0000
Subject: [docs] Download PDF docs for Python 3.6
Message-ID: <_d_5Dggq06kcwiJtZIXUWCP04PKEilkhNrMpD_uxh7VdRWd1PIpSEoIyw3GkH0umq9zMpfH7WFrYmFWwvpoJxJzjk-9lcYZ9QBZ58O9jJWA=@palard.fr>

Hi Gabriele, thanks for reporting,

I fixed them, you should be able to download them now.

For the record, here's the issue our docs build server is hitting: https://github.com/sphinx-doc/sphinx/issues/5561

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



From julien at palard.fr  Thu Oct 25 13:08:07 2018
From: julien at palard.fr (Julien Palard)
Date: Thu, 25 Oct 2018 17:08:07 +0000
Subject: [docs] [Announce] PDF downloads are back on tracks
Message-ID: <v8XTN7SoLbOiS5U3-l8lTeTu6MooXn4nn3zn8T6lm8ZoPSXJQz-_4GpP_sPer0OGabKRR_kBcyNPLSRZceymaCfWQue-jpw8ifT4ptFK-Ks=@palard.fr>

Hi everybody,

Thank you for reporting!

The downloads link are now fixed (don't hesitate if you find an exception, to send me the exact link that does not work).

If you're interested in fixing the root cause, it's probably due to: https://github.com/sphinx-doc/sphinx/issues/5561

In the meantime I used a temporary fix to make the builds work, so it should be OK now \o/

Sorry for the inconvenience :-(
--?
Julien Palard
https://mdk.fr



From report at bugs.python.org  Thu Oct 25 15:51:19 2018
From: report at bugs.python.org (Luna Chen)
Date: Thu, 25 Oct 2018 19:51:19 +0000
Subject: [docs] [issue29341] Missing accepting path-like object in
 docstrings of os module functions
In-Reply-To: <1485064061.59.0.597221589705.issue29341@psf.upfronthosting.co.za>
Message-ID: <1540497079.36.0.702299269573.issue29341@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Oct 25 17:13:50 2018
From: report at bugs.python.org (miss-islington)
Date: Thu, 25 Oct 2018 21:13:50 +0000
Subject: [docs] [issue35038] AttributeError: 'frame' object has no attribute
 'f_restricted'
In-Reply-To: <1540134122.28.0.788709270274.issue35038@psf.upfronthosting.co.za>
Message-ID: <1540502030.48.0.788709270274.issue35038@psf.upfronthosting.co.za>


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


New changeset 1770d1c5121ed6c64d7072875738f97e07eede8a by Miss Islington (bot) (St?phane Wirtel) in branch 'master':
bpo-35038: AttributeError: 'frame' object has no attribute 'f_restricted'. (GH-10098)
https://github.com/python/cpython/commit/1770d1c5121ed6c64d7072875738f97e07eede8a


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

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

From report at bugs.python.org  Thu Oct 25 17:13:59 2018
From: report at bugs.python.org (miss-islington)
Date: Thu, 25 Oct 2018 21:13:59 +0000
Subject: [docs] [issue35038] AttributeError: 'frame' object has no attribute
 'f_restricted'
In-Reply-To: <1540134122.28.0.788709270274.issue35038@psf.upfronthosting.co.za>
Message-ID: <1540502039.69.0.702299269573.issue35038@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Oct 25 17:14:08 2018
From: report at bugs.python.org (miss-islington)
Date: Thu, 25 Oct 2018 21:14:08 +0000
Subject: [docs] [issue35038] AttributeError: 'frame' object has no attribute
 'f_restricted'
In-Reply-To: <1540134122.28.0.788709270274.issue35038@psf.upfronthosting.co.za>
Message-ID: <1540502048.58.0.702299269573.issue35038@psf.upfronthosting.co.za>


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


----------
pull_requests: +9436

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

From report at bugs.python.org  Thu Oct 25 17:19:35 2018
From: report at bugs.python.org (miss-islington)
Date: Thu, 25 Oct 2018 21:19:35 +0000
Subject: [docs] [issue35038] AttributeError: 'frame' object has no attribute
 'f_restricted'
In-Reply-To: <1540134122.28.0.788709270274.issue35038@psf.upfronthosting.co.za>
Message-ID: <1540502375.4.0.788709270274.issue35038@psf.upfronthosting.co.za>


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


New changeset c64c4056c1fce0a18e5810fc6352712612a64010 by Miss Islington (bot) in branch '3.7':
bpo-35038: AttributeError: 'frame' object has no attribute 'f_restricted'. (GH-10098)
https://github.com/python/cpython/commit/c64c4056c1fce0a18e5810fc6352712612a64010


----------

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

From report at bugs.python.org  Thu Oct 25 17:22:04 2018
From: report at bugs.python.org (miss-islington)
Date: Thu, 25 Oct 2018 21:22:04 +0000
Subject: [docs] [issue35038] AttributeError: 'frame' object has no attribute
 'f_restricted'
In-Reply-To: <1540134122.28.0.788709270274.issue35038@psf.upfronthosting.co.za>
Message-ID: <1540502524.65.0.788709270274.issue35038@psf.upfronthosting.co.za>


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


New changeset 3b87151879adb795c3c0372832c87da84ee93974 by Miss Islington (bot) in branch '3.6':
bpo-35038: AttributeError: 'frame' object has no attribute 'f_restricted'. (GH-10098)
https://github.com/python/cpython/commit/3b87151879adb795c3c0372832c87da84ee93974


----------

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

From report at bugs.python.org  Thu Oct 25 18:34:27 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Thu, 25 Oct 2018 22:34:27 +0000
Subject: [docs] [issue35038] AttributeError: 'frame' object has no attribute
 'f_restricted'
In-Reply-To: <1540134122.28.0.788709270274.issue35038@psf.upfronthosting.co.za>
Message-ID: <1540506867.57.0.788709270274.issue35038@psf.upfronthosting.co.za>


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

all the PRs have been merged, we can close this issue.

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

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

From report at bugs.python.org  Thu Oct 25 20:23:17 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Fri, 26 Oct 2018 00:23:17 +0000
Subject: [docs] [issue35007] Minor change to weakref docs
In-Reply-To: <1539755313.9.0.788709270274.issue35007@psf.upfronthosting.co.za>
Message-ID: <1540513397.09.0.702299269573.issue35007@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Oct 26 02:00:55 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 26 Oct 2018 06:00:55 +0000
Subject: [docs] [issue35054] Add more index entries for symbols
In-Reply-To: <1540316703.62.0.788709270274.issue35054@psf.upfronthosting.co.za>
Message-ID: <1540533655.13.0.788709270274.issue35054@psf.upfronthosting.co.za>


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


New changeset ddb961d2abe5d5fde76d85b21a77e4e91e0043ad by Serhiy Storchaka in branch 'master':
bpo-35054: Add more index entries for symbols. (GH-10064)
https://github.com/python/cpython/commit/ddb961d2abe5d5fde76d85b21a77e4e91e0043ad


----------

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

From report at bugs.python.org  Fri Oct 26 03:03:43 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 26 Oct 2018 07:03:43 +0000
Subject: [docs] [issue35054] Add more index entries for symbols
In-Reply-To: <1540316703.62.0.788709270274.issue35054@psf.upfronthosting.co.za>
Message-ID: <1540537423.17.0.702299269573.issue35054@psf.upfronthosting.co.za>


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


----------
pull_requests: +9451

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

From report at bugs.python.org  Fri Oct 26 03:03:51 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 26 Oct 2018 07:03:51 +0000
Subject: [docs] [issue35054] Add more index entries for symbols
In-Reply-To: <1540316703.62.0.788709270274.issue35054@psf.upfronthosting.co.za>
Message-ID: <1540537431.73.0.702299269573.issue35054@psf.upfronthosting.co.za>


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


----------
pull_requests: +9452

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

From report at bugs.python.org  Fri Oct 26 03:40:43 2018
From: report at bugs.python.org (INADA Naoki)
Date: Fri, 26 Oct 2018 07:40:43 +0000
Subject: [docs] [issue35075] Doc: pprint example uses dead URL
Message-ID: <1540539643.28.0.788709270274.issue35075@psf.upfronthosting.co.za>


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

https://mail.python.org/pipermail/docs/2018-October/037913.html

Dead URL: http://pypi.org/project/Twisted/json
Valid URL: https://pypi.org/pypi/Twisted/json

But JSON returned by the valid URL seems too long for the example.
Is there a better sample JSON we can use in the example?

----------
assignee: docs at python
components: Documentation
messages: 328517
nosy: docs at python, inada.naoki
priority: normal
severity: normal
status: open
title: Doc: pprint example uses dead URL
versions: Python 3.6, Python 3.7, Python 3.8

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

From songofacandy at gmail.com  Fri Oct 26 03:41:09 2018
From: songofacandy at gmail.com (INADA Naoki)
Date: Fri, 26 Oct 2018 16:41:09 +0900
Subject: [docs] Out-of-date URL
In-Reply-To: <BLUPR02MB1700D6EF5B7EF50A1F50C1C8E9E20@BLUPR02MB1700.namprd02.prod.outlook.com>
References: <BLUPR02MB1700D6EF5B7EF50A1F50C1C8E9E20@BLUPR02MB1700.namprd02.prod.outlook.com>
Message-ID: <CAEfz+TyT-FjhOKEa72KPnu6BztuTaZRtbKDr=U400LbChyAHDQ@mail.gmail.com>

Thanks for reporting.

I filed a new issue: https://bugs.python.org/issue35075

Regards,
On Fri, Oct 26, 2018 at 12:56 AM Bill Tonnies <Bill_Tonnies at jabil.com> wrote:
>
> Hello,
>
> I tried the example (around the middle of the page) on https://docs.python.org/3/library/pprint.html. http://pypi.org/project/Twisted/json doesn't seem to be a valid URL any more.
>
>
> Regards,
>
> Bill
>
> _______________________________________________
> docs mailing list
> docs at python.org
> https://mail.python.org/mailman/listinfo/docs



-- 
INADA Naoki  <songofacandy at gmail.com>

From report at bugs.python.org  Fri Oct 26 03:52:27 2018
From: report at bugs.python.org (Julien Palard)
Date: Fri, 26 Oct 2018 07:52:27 +0000
Subject: [docs] [issue35007] Minor change to weakref docs
In-Reply-To: <1539755313.9.0.788709270274.issue35007@psf.upfronthosting.co.za>
Message-ID: <1540540347.73.0.788709270274.issue35007@psf.upfronthosting.co.za>


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

In the other end that's true that's an iterable, and that's what's count.

So if we want to change the implementation in the future, we still can, as long as we still return an iterable, it won't break asumptions.

So I'll keep the "iterable" word in the documentation, and it looks OK to me that the docstring tells more about the implementation than the interface, so I'll leave it as is too.

Relying on what you read in the current implementation is relying on an implementation detail that may change in the future, this weakens your code, please just consider it's an iterable?

Anyway the key set of the WeakKeyDictionary can change at any time, according to the actions you're doing while iterating over the keys, so better write solid code here, and be prepred for the worse, don't rely on implementation details.

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

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

From report at bugs.python.org  Fri Oct 26 04:18:55 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 26 Oct 2018 08:18:55 +0000
Subject: [docs] [issue35054] Add more index entries for symbols
In-Reply-To: <1540316703.62.0.788709270274.issue35054@psf.upfronthosting.co.za>
Message-ID: <1540541935.8.0.788709270274.issue35054@psf.upfronthosting.co.za>


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


New changeset 9a75b8470a2e0de5406edcabba140f023c99c6a9 by Serhiy Storchaka in branch '3.7':
[3.7] bpo-35054: Add more index entries for symbols. (GH-10064). (GH-10120)
https://github.com/python/cpython/commit/9a75b8470a2e0de5406edcabba140f023c99c6a9


----------

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

From report at bugs.python.org  Fri Oct 26 04:19:02 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 26 Oct 2018 08:19:02 +0000
Subject: [docs] [issue35054] Add more index entries for symbols
In-Reply-To: <1540316703.62.0.788709270274.issue35054@psf.upfronthosting.co.za>
Message-ID: <1540541941.66.0.788709270274.issue35054@psf.upfronthosting.co.za>


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


New changeset e825b4e1a9bbe1d4c561f4cbbe6857653ef13a15 by Serhiy Storchaka in branch '3.6':
[3.6] bpo-35054: Add more index entries for symbols. (GH-10064). (GH-10119)
https://github.com/python/cpython/commit/e825b4e1a9bbe1d4c561f4cbbe6857653ef13a15


----------

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

From report at bugs.python.org  Fri Oct 26 06:19:35 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Fri, 26 Oct 2018 10:19:35 +0000
Subject: [docs] [issue35075] Doc: pprint example uses dead URL
In-Reply-To: <1540539643.28.0.788709270274.issue35075@psf.upfronthosting.co.za>
Message-ID: <1540549175.14.0.702299269573.issue35075@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Oct 26 06:38:06 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 26 Oct 2018 10:38:06 +0000
Subject: [docs] [issue35054] Add more index entries for symbols
In-Reply-To: <1540316703.62.0.788709270274.issue35054@psf.upfronthosting.co.za>
Message-ID: <1540550286.92.0.702299269573.issue35054@psf.upfronthosting.co.za>


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


----------
pull_requests: +9453

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

From report at bugs.python.org  Fri Oct 26 06:41:37 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 26 Oct 2018 10:41:37 +0000
Subject: [docs] [issue35054] Add more index entries for symbols
In-Reply-To: <1540316703.62.0.788709270274.issue35054@psf.upfronthosting.co.za>
Message-ID: <1540550497.1.0.788709270274.issue35054@psf.upfronthosting.co.za>


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

PR 10121 adds names for single-character symbols (e.g. "* (asterisk)"). It also adds more indices for symbols in fnmatch, glob, struct, argparse, sqlite3, etc.

----------

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

From report at bugs.python.org  Fri Oct 26 06:52:17 2018
From: report at bugs.python.org (STINNER Victor)
Date: Fri, 26 Oct 2018 10:52:17 +0000
Subject: [docs] [issue35044] Use the :exc: role for the exceptions in the doc
In-Reply-To: <1540210070.18.0.788709270274.issue35044@psf.upfronthosting.co.za>
Message-ID: <1540551137.33.0.788709270274.issue35044@psf.upfronthosting.co.za>


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


New changeset e483f02423917dc4dfd25f46e5b9e6fce304777d by Victor Stinner (St?phane Wirtel) in branch 'master':
bpo-35044, doc: Use the :exc: role for the exceptions (GH-10037)
https://github.com/python/cpython/commit/e483f02423917dc4dfd25f46e5b9e6fce304777d


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

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

From report at bugs.python.org  Fri Oct 26 06:52:28 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 26 Oct 2018 10:52:28 +0000
Subject: [docs] [issue35044] Use the :exc: role for the exceptions in the doc
In-Reply-To: <1540210070.18.0.788709270274.issue35044@psf.upfronthosting.co.za>
Message-ID: <1540551148.23.0.702299269573.issue35044@psf.upfronthosting.co.za>


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


----------
pull_requests: +9454

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

From report at bugs.python.org  Fri Oct 26 06:56:32 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 26 Oct 2018 10:56:32 +0000
Subject: [docs] [issue35044] Use the :exc: role for the exceptions in the doc
In-Reply-To: <1540210070.18.0.788709270274.issue35044@psf.upfronthosting.co.za>
Message-ID: <1540551392.72.0.788709270274.issue35044@psf.upfronthosting.co.za>


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


New changeset ec10b70ea66e738ccb5c28f75a9c5d2b1c197de7 by Miss Islington (bot) in branch '3.7':
bpo-35044, doc: Use the :exc: role for the exceptions (GH-10037)
https://github.com/python/cpython/commit/ec10b70ea66e738ccb5c28f75a9c5d2b1c197de7


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

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

From report at bugs.python.org  Fri Oct 26 07:30:08 2018
From: report at bugs.python.org (STINNER Victor)
Date: Fri, 26 Oct 2018 11:30:08 +0000
Subject: [docs] [issue35044] Use the :exc: role for the exceptions in the doc
In-Reply-To: <1540210070.18.0.788709270274.issue35044@psf.upfronthosting.co.za>
Message-ID: <1540553408.53.0.702299269573.issue35044@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Oct 26 09:12:07 2018
From: report at bugs.python.org (Tal Einat)
Date: Fri, 26 Oct 2018 13:12:07 +0000
Subject: [docs] [issue34789] Make xml.sax.make_parser accept iterables
In-Reply-To: <1537805047.54.0.956365154283.issue34789@psf.upfronthosting.co.za>
Message-ID: <1540559526.88.0.788709270274.issue34789@psf.upfronthosting.co.za>


Tal Einat <taleinat at gmail.com> added the comment:


New changeset 1487b651caa62647f8f8c9e8432e475e3566130c by Tal Einat (Andr?s Delfino) in branch '3.7':
[3.7] bpo-34789: xml.sax.make_parser expects a list not just any sequence (GH-9542)
https://github.com/python/cpython/commit/1487b651caa62647f8f8c9e8432e475e3566130c


----------
nosy: +taleinat

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

From report at bugs.python.org  Fri Oct 26 09:12:26 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 26 Oct 2018 13:12:26 +0000
Subject: [docs] [issue34789] Make xml.sax.make_parser accept iterables
In-Reply-To: <1537805047.54.0.956365154283.issue34789@psf.upfronthosting.co.za>
Message-ID: <1540559546.88.0.702299269573.issue34789@psf.upfronthosting.co.za>


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


----------
pull_requests: +9455

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

From report at bugs.python.org  Fri Oct 26 09:12:38 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 26 Oct 2018 13:12:38 +0000
Subject: [docs] [issue34789] Make xml.sax.make_parser accept iterables
In-Reply-To: <1537805047.54.0.956365154283.issue34789@psf.upfronthosting.co.za>
Message-ID: <1540559558.44.0.702299269573.issue34789@psf.upfronthosting.co.za>


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


----------
pull_requests: +9456

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

From report at bugs.python.org  Fri Oct 26 09:27:22 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 26 Oct 2018 13:27:22 +0000
Subject: [docs] [issue34789] Make xml.sax.make_parser accept iterables
In-Reply-To: <1537805047.54.0.956365154283.issue34789@psf.upfronthosting.co.za>
Message-ID: <1540560442.19.0.788709270274.issue34789@psf.upfronthosting.co.za>


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


New changeset 38d7620baab96c702243cfa193377a38888ec10f by Miss Islington (bot) in branch '3.6':
[3.7] bpo-34789: xml.sax.make_parser expects a list not just any sequence (GH-9542)
https://github.com/python/cpython/commit/38d7620baab96c702243cfa193377a38888ec10f


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

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

From report at bugs.python.org  Fri Oct 26 09:29:47 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 26 Oct 2018 13:29:47 +0000
Subject: [docs] [issue34789] Make xml.sax.make_parser accept iterables
In-Reply-To: <1537805047.54.0.956365154283.issue34789@psf.upfronthosting.co.za>
Message-ID: <1540560587.64.0.788709270274.issue34789@psf.upfronthosting.co.za>


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


New changeset 9dcb517f8ebba16a46ec2a6a97bb3e4a97daeae9 by Miss Islington (bot) in branch '2.7':
[3.7] bpo-34789: xml.sax.make_parser expects a list not just any sequence (GH-9542)
https://github.com/python/cpython/commit/9dcb517f8ebba16a46ec2a6a97bb3e4a97daeae9


----------

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

From report at bugs.python.org  Fri Oct 26 10:37:17 2018
From: report at bugs.python.org (Christian Tismer)
Date: Fri, 26 Oct 2018 14:37:17 +0000
Subject: [docs] [issue26979] The danger of PyType_FromSpec()
In-Reply-To: <1462731878.82.0.9073654009.issue26979@psf.upfronthosting.co.za>
Message-ID: <1540564637.28.0.788709270274.issue26979@psf.upfronthosting.co.za>


Christian Tismer <tismer at stackless.com> added the comment:

The default of PyType_FromSpec for tp_dealloc is wrong!
-------------------------------------------------------

After a long struggle with crashes and leaks, the situation
was finally clarified:

When a type is converted from a static type to a heaptype
via PyType_FromSpec, and the tp_dealloc field is NULL,
then subtype_dealloc is inserted.

This is not correct.
The reasoning in the code is that a heaptype has subtype_dealloc.
But before the conversion, the type was static, and for
static types the function object_dealloc was inserted.

In the given type, the only change is to become a heaptype.
The by default inserted object_dealloc should not be changed,
since the existing code was written with object_dealloc in 
mind and not the consequences of replacing it with subtype_dealloc.

Before this solution, I used a dummy function to prevend
subpype_dealloc being inserted, but that caused leaks.

It was hard to understand that the default for a static type
is object_dealloc. After that, it was easy to fix that:

The now correctly working workaround is to explicitly insert
an object_dealloc function whenever the default for tp_dealloc
is NULL.

Again, in order to use this fix, it is necessary to break the
Limited API, because in order to write an object_dealloc function
(it is not public) you need access to type objects.

----------

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

From report at bugs.python.org  Fri Oct 26 10:57:02 2018
From: report at bugs.python.org (Tal Einat)
Date: Fri, 26 Oct 2018 14:57:02 +0000
Subject: [docs] [issue34789] Make xml.sax.make_parser accept iterables
In-Reply-To: <1537805047.54.0.956365154283.issue34789@psf.upfronthosting.co.za>
Message-ID: <1540565822.87.0.788709270274.issue34789@psf.upfronthosting.co.za>


Tal Einat <taleinat at gmail.com> added the comment:


New changeset a6dc531063efe3a8d47ff4639729060c72a3688c by Tal Einat (Andr?s Delfino) in branch 'master':
bpo-34789: make xml.sax.make_parser accept iterables of all types (GH-9576)
https://github.com/python/cpython/commit/a6dc531063efe3a8d47ff4639729060c72a3688c


----------

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

From report at bugs.python.org  Fri Oct 26 10:57:58 2018
From: report at bugs.python.org (Tal Einat)
Date: Fri, 26 Oct 2018 14:57:58 +0000
Subject: [docs] [issue34789] Make xml.sax.make_parser accept iterables
In-Reply-To: <1537805047.54.0.956365154283.issue34789@psf.upfronthosting.co.za>
Message-ID: <1540565878.39.0.788709270274.issue34789@psf.upfronthosting.co.za>


Tal Einat <taleinat at gmail.com> added the comment:

Thanks for reporting the issue and making the PRs, Andr?s!

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

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

From report at bugs.python.org  Fri Oct 26 14:36:19 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 26 Oct 2018 18:36:19 +0000
Subject: [docs] [issue35035] Documentation for email.utils is named
 email.util.rst
In-Reply-To: <1540102639.17.0.788709270274.issue35035@psf.upfronthosting.co.za>
Message-ID: <1540578979.08.0.702299269573.issue35035@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Oct 26 16:24:38 2018
From: report at bugs.python.org (R. David Murray)
Date: Fri, 26 Oct 2018 20:24:38 +0000
Subject: [docs] [issue35035] Documentation for email.utils is named
 email.util.rst
In-Reply-To: <1540102639.17.0.788709270274.issue35035@psf.upfronthosting.co.za>
Message-ID: <1540585478.12.0.788709270274.issue35035@psf.upfronthosting.co.za>


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

Sure, this is fine with me.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35035>
_______________________________________

From report at bugs.python.org  Fri Oct 26 17:01:52 2018
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 26 Oct 2018 21:01:52 +0000
Subject: [docs] [issue35042] Use the role :pep: for the PEP \d+
In-Reply-To: <1540195863.27.0.788709270274.issue35042@psf.upfronthosting.co.za>
Message-ID: <1540587712.53.0.788709270274.issue35042@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

Docutils itself parses `RFC nnnn` and `PEP nnn` to replace with links.

In some parts of the docs with many references, some devs (I think Raymond Hettinger for example) use tricks like `PEP\ nnn` to avoid getting twenty links in a row.

So I don?t see what the replacement of `PEP nnn` with `:pep:`nnn`` adds.

----------
nosy: +eric.araujo

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35042>
_______________________________________

From report at bugs.python.org  Fri Oct 26 17:36:14 2018
From: report at bugs.python.org (Guido van Rossum)
Date: Fri, 26 Oct 2018 21:36:14 +0000
Subject: [docs] [issue29341] Missing accepting path-like object in
 docstrings of os module functions
In-Reply-To: <1485064061.59.0.597221589705.issue29341@psf.upfronthosting.co.za>
Message-ID: <1540589773.99.0.702299269573.issue29341@psf.upfronthosting.co.za>


Change by Guido van Rossum <guido at python.org>:


----------
nosy: +gvanrossum

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue29341>
_______________________________________

From report at bugs.python.org  Fri Oct 26 18:58:35 2018
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 26 Oct 2018 22:58:35 +0000
Subject: [docs] [issue35042] Use the role :pep: for the PEP \d+
In-Reply-To: <1540195863.27.0.788709270274.issue35042@psf.upfronthosting.co.za>
Message-ID: <1540594715.8.0.788709270274.issue35042@psf.upfronthosting.co.za>


Brett Cannon <brett at python.org> added the comment:


New changeset 12e696b4f071ffe0d585b7f0d0d8020fd328bfdd by Brett Cannon (St?phane Wirtel) in branch 'master':
bpo-35042: Use the :pep: role where a PEP is specified (#10036)
https://github.com/python/cpython/commit/12e696b4f071ffe0d585b7f0d0d8020fd328bfdd


----------
nosy: +brett.cannon

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35042>
_______________________________________

From report at bugs.python.org  Sat Oct 27 01:31:15 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 27 Oct 2018 05:31:15 +0000
Subject: [docs] [issue10536] Enhancements to gettext docs
In-Reply-To: <1290730924.88.0.289473332428.issue10536@psf.upfronthosting.co.za>
Message-ID: <1540618275.29.0.788709270274.issue10536@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:

?ric, do you mind to create a PR? But please avoid unnecessary formatting changes like adding a second space between sequences. While I prefer such style, these changes doesn't affect the result output and distract attention from significant changes.

----------
nosy: +serhiy.storchaka

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue10536>
_______________________________________

From report at bugs.python.org  Sat Oct 27 01:38:00 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 27 Oct 2018 05:38:00 +0000
Subject: [docs] [issue31544] gettext.Catalog title is not flagged as a class
In-Reply-To: <1506007626.15.0.9927755066.issue31544@psf.upfronthosting.co.za>
Message-ID: <1540618680.31.0.702299269573.issue31544@psf.upfronthosting.co.za>


Change by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
resolution:  -> not a bug
stage:  -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue31544>
_______________________________________

From report at bugs.python.org  Sat Oct 27 16:14:41 2018
From: report at bugs.python.org (Joy Diamond)
Date: Sat, 27 Oct 2018 20:14:41 +0000
Subject: [docs] [issue35083] Fix documentation for __instancecheck__
Message-ID: <1540671281.62.0.788709270274.issue35083@psf.upfronthosting.co.za>


New submission from Joy Diamond <python.gem at gmail.com>:

This is a request to fix the documentation for __instancecheck__.

Please add the following:

"""
(Note that any object `x` is always considered to be an instance of
`type(x)`, and this cannot be overridden.)
"""

Consider the following program:

class M(type):
    def __instancecheck__(m, t):
        print('instancecheck(%s, %s)' % (m, t))
        return False                                    #   LIE!

Test = M('Test', ((object,)), {})

something = Test()

print('Does *NOT* call __instancecheck__:')
print('isinstance(something, Test): %s' % isinstance(something, Test))

print()
print('Does call __instancecheck__:')
print('isinstance(0, Test):         %s' % isinstance(0,         Test))

Under python 2, python 3, and pypy, in all cases, the first examples does *NOT* call __instancecheck__.

You can see the optimization here:

https://github.com/python/cpython/blob/master/Objects/abstract.c#L2397-L2405

Which reads:

int
PyObject_IsInstance(PyObject *inst, PyObject *cls)
{
_Py_IDENTIFIER(__instancecheck__);
PyObject *checker;

/* Quick test for an exact match */
if (Py_TYPE(inst) == (PyTypeObject *)cls)
return 1;

I'm fine with the optimization -- I am not suggesting to get rid of it.

I just want the documentation to match the actual implementation.

The following documentation needs to be fixed:

https://docs.python.org/2/reference/datamodel.html
https://docs.python.org/3/reference/datamodel.html
https://www.python.org/dev/peps/pep-3119/

It took me half an hour to figure out why my version of __instancecheck__ was not working, as I tried to test it using the super simple code above ...

One of the best things about python is how accurate and consistent the documentation is.

This request is to keep these high standards.

----------
assignee: docs at python
components: Documentation
messages: 328658
nosy: docs at python, joydiamond
priority: normal
severity: normal
status: open
title: Fix documentation for __instancecheck__
type: enhancement
versions: Python 2.7, Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35083>
_______________________________________

From report at bugs.python.org  Sun Oct 28 03:46:04 2018
From: report at bugs.python.org (Julien Palard)
Date: Sun, 28 Oct 2018 07:46:04 +0000
Subject: [docs] [issue35042] Use the role :pep: for the PEP \d+
In-Reply-To: <1540195863.27.0.788709270274.issue35042@psf.upfronthosting.co.za>
Message-ID: <1540712764.87.0.702299269573.issue35042@psf.upfronthosting.co.za>


Change by Julien Palard <julien+python at palard.fr>:


----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35042>
_______________________________________

From report at bugs.python.org  Sun Oct 28 07:40:23 2018
From: report at bugs.python.org (Sebastian Rittau)
Date: Sun, 28 Oct 2018 11:40:23 +0000
Subject: [docs] [issue35089] Remove typing.io and typing.re from
 documentation
Message-ID: <1540726823.63.0.788709270274.issue35089@psf.upfronthosting.co.za>


New submission from Sebastian Rittau <srittau at rittau.biz>:

Per the discussion in https://github.com/python/typing/issues/589 and https://github.com/python/typeshed/issues/1652, IO, BinaryIO, TextIO, Pattern, and Match should be imported directly from typing, not from typing.io and typing.re. The documentation needs to be adjusted accordingly.

----------
assignee: docs at python
components: Documentation
messages: 328683
nosy: docs at python, srittau
priority: normal
severity: normal
status: open
title: Remove typing.io and typing.re from documentation

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35089>
_______________________________________

From report at bugs.python.org  Sun Oct 28 07:41:35 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 28 Oct 2018 11:41:35 +0000
Subject: [docs] [issue35054] Add more index entries for symbols
In-Reply-To: <1540316703.62.0.788709270274.issue35054@psf.upfronthosting.co.za>
Message-ID: <1540726895.21.0.788709270274.issue35054@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:


New changeset 913876d824d969f8c7431e8a9d4610a9a11a786e by Serhiy Storchaka in branch 'master':
bpo-35054: Add yet more index entries for symbols. (GH-10121)
https://github.com/python/cpython/commit/913876d824d969f8c7431e8a9d4610a9a11a786e


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35054>
_______________________________________

From report at bugs.python.org  Sun Oct 28 07:41:39 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 28 Oct 2018 11:41:39 +0000
Subject: [docs] [issue35054] Add more index entries for symbols
In-Reply-To: <1540316703.62.0.788709270274.issue35054@psf.upfronthosting.co.za>
Message-ID: <1540726899.36.0.702299269573.issue35054@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +9495

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35054>
_______________________________________

From report at bugs.python.org  Sun Oct 28 08:04:36 2018
From: report at bugs.python.org (Sebastian Rittau)
Date: Sun, 28 Oct 2018 12:04:36 +0000
Subject: [docs] [issue35089] Remove typing.io and typing.re from
 documentation
In-Reply-To: <1540726823.63.0.788709270274.issue35089@psf.upfronthosting.co.za>
Message-ID: <1540728276.98.0.702299269573.issue35089@psf.upfronthosting.co.za>


Change by Sebastian Rittau <srittau at rittau.biz>:


----------
keywords: +patch
pull_requests: +9496
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35089>
_______________________________________

From report at bugs.python.org  Sun Oct 28 08:57:35 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Sun, 28 Oct 2018 12:57:35 +0000
Subject: [docs] [issue35083] Fix documentation for __instancecheck__
In-Reply-To: <1540671281.62.0.788709270274.issue35083@psf.upfronthosting.co.za>
Message-ID: <1540731455.14.0.788709270274.issue35083@psf.upfronthosting.co.za>


Karthikeyan Singaravelan <tir.karthi at gmail.com> added the comment:

python-ideas thread for the issue : https://mail.python.org/pipermail/python-ideas/2018-October/054335.html

----------
nosy: +xtreak

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35083>
_______________________________________

From report at bugs.python.org  Sun Oct 28 10:47:32 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 28 Oct 2018 14:47:32 +0000
Subject: [docs] [issue35089] Remove typing.io and typing.re from
 documentation
In-Reply-To: <1540726823.63.0.788709270274.issue35089@psf.upfronthosting.co.za>
Message-ID: <1540738052.52.0.702299269573.issue35089@psf.upfronthosting.co.za>


Change by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
nosy: +gvanrossum, levkivskyi

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35089>
_______________________________________

From report at bugs.python.org  Sun Oct 28 12:03:33 2018
From: report at bugs.python.org (Ivan Levkivskyi)
Date: Sun, 28 Oct 2018 16:03:33 +0000
Subject: [docs] [issue35089] Remove typing.io and typing.re from
 documentation
In-Reply-To: <1540726823.63.0.788709270274.issue35089@psf.upfronthosting.co.za>
Message-ID: <1540742613.36.0.788709270274.issue35089@psf.upfronthosting.co.za>


Ivan Levkivskyi <levkivskyi at gmail.com> added the comment:


New changeset c8a8d6b347d5a6899feb7c810d28f22f3cb151b8 by Ivan Levkivskyi (Sebastian Rittau) in branch 'master':
bpo-35089: Don't mention typing.io and typing.re (GH-10173)
https://github.com/python/cpython/commit/c8a8d6b347d5a6899feb7c810d28f22f3cb151b8


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35089>
_______________________________________

From report at bugs.python.org  Sun Oct 28 12:03:45 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 28 Oct 2018 16:03:45 +0000
Subject: [docs] [issue35089] Remove typing.io and typing.re from
 documentation
In-Reply-To: <1540726823.63.0.788709270274.issue35089@psf.upfronthosting.co.za>
Message-ID: <1540742625.83.0.702299269573.issue35089@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +9500

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35089>
_______________________________________

From report at bugs.python.org  Sun Oct 28 12:03:57 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 28 Oct 2018 16:03:57 +0000
Subject: [docs] [issue35089] Remove typing.io and typing.re from
 documentation
In-Reply-To: <1540726823.63.0.788709270274.issue35089@psf.upfronthosting.co.za>
Message-ID: <1540742637.55.0.702299269573.issue35089@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +9501

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35089>
_______________________________________

From report at bugs.python.org  Sun Oct 28 12:16:40 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 28 Oct 2018 16:16:40 +0000
Subject: [docs] [issue35089] Remove typing.io and typing.re from
 documentation
In-Reply-To: <1540726823.63.0.788709270274.issue35089@psf.upfronthosting.co.za>
Message-ID: <1540743400.4.0.788709270274.issue35089@psf.upfronthosting.co.za>


miss-islington <mariatta.wijaya+miss-islington at gmail.com> added the comment:


New changeset c516dc6e57341f24d2494514c650f4a240c1c95f by Miss Islington (bot) in branch '3.7':
bpo-35089: Don't mention typing.io and typing.re (GH-10173)
https://github.com/python/cpython/commit/c516dc6e57341f24d2494514c650f4a240c1c95f


----------
nosy: +miss-islington

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35089>
_______________________________________

From report at bugs.python.org  Sun Oct 28 12:17:11 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 28 Oct 2018 16:17:11 +0000
Subject: [docs] [issue35089] Remove typing.io and typing.re from
 documentation
In-Reply-To: <1540726823.63.0.788709270274.issue35089@psf.upfronthosting.co.za>
Message-ID: <1540743431.01.0.788709270274.issue35089@psf.upfronthosting.co.za>


miss-islington <mariatta.wijaya+miss-islington at gmail.com> added the comment:


New changeset a36f04cedbbbe776deb478114c1bc0e4a6fe9380 by Miss Islington (bot) in branch '3.6':
bpo-35089: Don't mention typing.io and typing.re (GH-10173)
https://github.com/python/cpython/commit/a36f04cedbbbe776deb478114c1bc0e4a6fe9380


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35089>
_______________________________________

From report at bugs.python.org  Sun Oct 28 12:43:35 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 28 Oct 2018 16:43:35 +0000
Subject: [docs] [issue35054] Add more index entries for symbols
In-Reply-To: <1540316703.62.0.788709270274.issue35054@psf.upfronthosting.co.za>
Message-ID: <1540745015.87.0.788709270274.issue35054@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:


New changeset fdf48b6b88f44a3ae6dc3e5eaea40c226c7df6c7 by Serhiy Storchaka (Miss Islington (bot)) in branch '3.7':
bpo-35054: Add yet more index entries for symbols. (GH-10121) (GH-10171)
https://github.com/python/cpython/commit/fdf48b6b88f44a3ae6dc3e5eaea40c226c7df6c7


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35054>
_______________________________________

From report at bugs.python.org  Sun Oct 28 12:50:41 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 28 Oct 2018 16:50:41 +0000
Subject: [docs] [issue35054] Add more index entries for symbols
In-Reply-To: <1540316703.62.0.788709270274.issue35054@psf.upfronthosting.co.za>
Message-ID: <1540745441.62.0.702299269573.issue35054@psf.upfronthosting.co.za>


Change by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
pull_requests: +9505

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35054>
_______________________________________

From report at bugs.python.org  Sun Oct 28 12:51:58 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 28 Oct 2018 16:51:58 +0000
Subject: [docs] [issue35054] Add more index entries for symbols
In-Reply-To: <1540316703.62.0.788709270274.issue35054@psf.upfronthosting.co.za>
Message-ID: <1540745518.64.0.702299269573.issue35054@psf.upfronthosting.co.za>


Change by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35054>
_______________________________________

From report at bugs.python.org  Sun Oct 28 13:35:36 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 28 Oct 2018 17:35:36 +0000
Subject: [docs] [issue35054] Add more index entries for symbols
In-Reply-To: <1540316703.62.0.788709270274.issue35054@psf.upfronthosting.co.za>
Message-ID: <1540748136.85.0.788709270274.issue35054@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:


New changeset 5b2e1cfde28cce7f4b9275ec1b3757c561eef94e by Serhiy Storchaka in branch '3.6':
[3.6] bpo-35054: Add yet more index entries for symbols. (GH-10121). (GH-10182)
https://github.com/python/cpython/commit/5b2e1cfde28cce7f4b9275ec1b3757c561eef94e


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35054>
_______________________________________

From report at bugs.python.org  Sun Oct 28 13:38:41 2018
From: report at bugs.python.org (Ivan Levkivskyi)
Date: Sun, 28 Oct 2018 17:38:41 +0000
Subject: [docs] [issue35089] Remove typing.io and typing.re from
 documentation
In-Reply-To: <1540726823.63.0.788709270274.issue35089@psf.upfronthosting.co.za>
Message-ID: <1540748321.19.0.702299269573.issue35089@psf.upfronthosting.co.za>


Change by Ivan Levkivskyi <levkivskyi at gmail.com>:


----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35089>
_______________________________________

From report at bugs.python.org  Sun Oct 28 14:42:09 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 28 Oct 2018 18:42:09 +0000
Subject: [docs] [issue35093] IDLE: document the help document viewer
Message-ID: <1540752129.6.0.788709270274.issue35093@psf.upfronthosting.co.za>


New submission from Terry J. Reedy <tjreedy at udel.edu>:

Implement issue 33396 item 6: document the IDLE Doc viewer.

----------
assignee: docs at python
components: Documentation, IDLE
messages: 328725
nosy: docs at python, terry.reedy
priority: normal
severity: normal
stage: needs patch
status: open
title: IDLE: document the help document viewer
type: enhancement
versions: Python 3.6, Python 3.7, Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35093>
_______________________________________

From report at bugs.python.org  Sun Oct 28 14:42:46 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 28 Oct 2018 18:42:46 +0000
Subject: [docs] [issue35093] IDLE: document the help document viewer
In-Reply-To: <1540752129.6.0.788709270274.issue35093@psf.upfronthosting.co.za>
Message-ID: <1540752166.03.0.702299269573.issue35093@psf.upfronthosting.co.za>


Change by Terry J. Reedy <tjreedy at udel.edu>:


----------
assignee: docs at python -> terry.reedy
components:  -Documentation

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35093>
_______________________________________

From report at bugs.python.org  Sun Oct 28 14:50:52 2018
From: report at bugs.python.org (Romain Geissler)
Date: Sun, 28 Oct 2018 18:50:52 +0000
Subject: [docs] [issue14956] custom PYTHONPATH may break apps embedding
 Python
In-Reply-To: <1338321412.45.0.331737203349.issue14956@psf.upfronthosting.co.za>
Message-ID: <1540752652.48.0.788709270274.issue14956@psf.upfronthosting.co.za>


Romain Geissler <romain.geissler at amadeus.com> added the comment:

Hi,

Just updating this 6 year old bug report. The last comment says it's not possible to ignore environment when using the C-API. I don't know back then, but today it is possible. I have just built gdb 8.2 against python 3.7.1, and patched gdb with this simple patch, which apparently works:

--- gdb/python/python.c
+++ gdb/python/python.c
@@ -1726,6 +1726,9 @@
 #endif
 #endif

+  // Force using the toolchain python without being troubled by $PYTHONHOME or $PYTHONPATH.
+  Py_IgnoreEnvironmentFlag = 1;
+
   Py_Initialize ();
   PyEval_InitThreads ();

Cheers,
Romain

----------
nosy: +RomainGeissler1A

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue14956>
_______________________________________

From report at bugs.python.org  Sun Oct 28 14:56:24 2018
From: report at bugs.python.org (Joannah Nanjekye)
Date: Sun, 28 Oct 2018 18:56:24 +0000
Subject: [docs] [issue22021] shutil.make_archive()  root_dir do not work
In-Reply-To: <1405936213.68.0.143186152462.issue22021@psf.upfronthosting.co.za>
Message-ID: <1540752984.58.0.702299269573.issue22021@psf.upfronthosting.co.za>


Change by Joannah Nanjekye <nanjekyejoannah at gmail.com>:


----------
pull_requests: +9509
stage: needs patch -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue22021>
_______________________________________

From report at bugs.python.org  Sun Oct 28 15:58:33 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 28 Oct 2018 19:58:33 +0000
Subject: [docs] [issue35093] IDLE: document the help document viewer
In-Reply-To: <1540752129.6.0.788709270274.issue35093@psf.upfronthosting.co.za>
Message-ID: <1540756713.84.0.702299269573.issue35093@psf.upfronthosting.co.za>


Change by Terry J. Reedy <tjreedy at udel.edu>:


----------
keywords: +patch
pull_requests: +9513
stage: needs patch -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35093>
_______________________________________

From report at bugs.python.org  Sun Oct 28 16:30:13 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 28 Oct 2018 20:30:13 +0000
Subject: [docs] [issue35093] IDLE: document the help document viewer
In-Reply-To: <1540752129.6.0.788709270274.issue35093@psf.upfronthosting.co.za>
Message-ID: <1540758613.67.0.702299269573.issue35093@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +9516

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35093>
_______________________________________

From report at bugs.python.org  Sun Oct 28 16:30:49 2018
From: report at bugs.python.org (miss-islington)
Date: Sun, 28 Oct 2018 20:30:49 +0000
Subject: [docs] [issue35093] IDLE: document the help document viewer
In-Reply-To: <1540752129.6.0.788709270274.issue35093@psf.upfronthosting.co.za>
Message-ID: <1540758649.26.0.702299269573.issue35093@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +9517

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35093>
_______________________________________

From report at bugs.python.org  Sun Oct 28 16:44:38 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 28 Oct 2018 20:44:38 +0000
Subject: [docs] [issue35093] IDLE: document the help document viewer
In-Reply-To: <1540752129.6.0.788709270274.issue35093@psf.upfronthosting.co.za>
Message-ID: <1540759478.51.0.702299269573.issue35093@psf.upfronthosting.co.za>


Change by Terry J. Reedy <tjreedy at udel.edu>:


----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35093>
_______________________________________

From report at bugs.python.org  Sun Oct 28 17:17:47 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Sun, 28 Oct 2018 21:17:47 +0000
Subject: [docs] [issue35075] Doc: pprint example uses dead URL
In-Reply-To: <1540539643.28.0.788709270274.issue35075@psf.upfronthosting.co.za>
Message-ID: <1540761467.08.0.702299269573.issue35075@psf.upfronthosting.co.za>


Change by Pablo Galindo Salgado <pablogsal at gmail.com>:


----------
keywords: +patch
pull_requests: +9519
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35075>
_______________________________________

From report at bugs.python.org  Sun Oct 28 17:32:55 2018
From: report at bugs.python.org (Lysandros Nikolaou)
Date: Sun, 28 Oct 2018 21:32:55 +0000
Subject: [docs] [issue35075] Doc: pprint example uses dead URL
In-Reply-To: <1540539643.28.0.788709270274.issue35075@psf.upfronthosting.co.za>
Message-ID: <1540762375.47.0.788709270274.issue35075@psf.upfronthosting.co.za>


Lysandros Nikolaou <lisandrosnik at gmail.com> added the comment:

Also this throws a TypeError, because http_info.get_content_charset() returns None with the new link. I think, this should be fixed as well.

----------
nosy: +lys.nikolaou

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35075>
_______________________________________

From report at bugs.python.org  Sun Oct 28 18:13:42 2018
From: report at bugs.python.org (Lysandros Nikolaou)
Date: Sun, 28 Oct 2018 22:13:42 +0000
Subject: [docs] [issue32804] urllib.retrieve documentation doesn't mention
 context parameter
In-Reply-To: <1518140001.56.0.467229070634.issue32804@psf.upfronthosting.co.za>
Message-ID: <1540764822.16.0.702299269573.issue32804@psf.upfronthosting.co.za>


Change by Lysandros Nikolaou <lisandrosnik at gmail.com>:


----------
keywords: +patch
pull_requests: +9521
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32804>
_______________________________________

From report at bugs.python.org  Sun Oct 28 18:24:59 2018
From: report at bugs.python.org (Lysandros Nikolaou)
Date: Sun, 28 Oct 2018 22:24:59 +0000
Subject: [docs] [issue30410] Documentation for sys.stdout encoding does not
 reflect the new Windows behavior in Python 3.6+
In-Reply-To: <1495270729.75.0.717879181788.issue30410@psf.upfronthosting.co.za>
Message-ID: <1540765499.51.0.788709270274.issue30410@psf.upfronthosting.co.za>


Lysandros Nikolaou <lisandrosnik at gmail.com> added the comment:

Shall I create a PR for this?

----------
nosy: +lys.nikolaou

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue30410>
_______________________________________

From report at bugs.python.org  Sun Oct 28 20:56:34 2018
From: report at bugs.python.org (Braden Groom)
Date: Mon, 29 Oct 2018 00:56:34 +0000
Subject: [docs] [issue19376] document that strptime() does not support the
 Feb 29 if the format does not contain the year
In-Reply-To: <1382608937.44.0.992947795428.issue19376@psf.upfronthosting.co.za>
Message-ID: <1540774593.8.0.788709270274.issue19376@psf.upfronthosting.co.za>


Braden Groom <braden.groom at gmail.com> added the comment:

> In other words, the documentation looks sufficient to me as-is, and adding special wording for this would only make it longer than it should be.

I agree with Victor here. It seems like this can be closed. There haven't been any comments from other people hitting this issue for 5 years.

----------
nosy: +bradengroom

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue19376>
_______________________________________

From report at bugs.python.org  Mon Oct 29 02:54:40 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 29 Oct 2018 06:54:40 +0000
Subject: [docs] [issue25205] setattr accepts invalid identifiers
In-Reply-To: <1442861960.51.0.201067879836.issue25205@psf.upfronthosting.co.za>
Message-ID: <1540796080.86.0.702299269573.issue25205@psf.upfronthosting.co.za>


Change by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
resolution:  -> not a bug
stage:  -> resolved
status: pending -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue25205>
_______________________________________

From report at bugs.python.org  Mon Oct 29 05:16:26 2018
From: report at bugs.python.org (Julien Palard)
Date: Mon, 29 Oct 2018 09:16:26 +0000
Subject: [docs] [issue35007] Minor change to weakref docs
In-Reply-To: <1539755313.9.0.788709270274.issue35007@psf.upfronthosting.co.za>
Message-ID: <1540804586.36.0.702299269573.issue35007@psf.upfronthosting.co.za>


Change by Julien Palard <julien+python at palard.fr>:


----------
resolution:  -> not a bug
stage:  -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35007>
_______________________________________

From report at bugs.python.org  Mon Oct 29 06:34:17 2018
From: report at bugs.python.org (Steve Dower)
Date: Mon, 29 Oct 2018 10:34:17 +0000
Subject: [docs] [issue30410] Documentation for sys.stdout encoding does not
 reflect the new Windows behavior in Python 3.6+
In-Reply-To: <1495270729.75.0.717879181788.issue30410@psf.upfronthosting.co.za>
Message-ID: <1540809257.8.0.788709270274.issue30410@psf.upfronthosting.co.za>


Steve Dower <steve.dower at python.org> added the comment:

Please do!

----------
versions: +Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue30410>
_______________________________________

From report at bugs.python.org  Mon Oct 29 07:43:42 2018
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 29 Oct 2018 11:43:42 +0000
Subject: [docs] [issue19376] document that strptime() does not support the
 Feb 29 if the format does not contain the year
In-Reply-To: <1382608937.44.0.992947795428.issue19376@psf.upfronthosting.co.za>
Message-ID: <1540813422.32.0.788709270274.issue19376@psf.upfronthosting.co.za>


STINNER Victor <vstinner at redhat.com> added the comment:

Paul Ganssle: Do you want to work on a PR? Or should we close the issue?

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue19376>
_______________________________________

From report at bugs.python.org  Mon Oct 29 07:49:56 2018
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 29 Oct 2018 11:49:56 +0000
Subject: [docs] [issue27741] datetime.datetime.strptime functionality
 description incorrect
In-Reply-To: <1470941311.19.0.0562450492824.issue27741@psf.upfronthosting.co.za>
Message-ID: <1540813796.4.0.788709270274.issue27741@psf.upfronthosting.co.za>


STINNER Victor <vstinner at redhat.com> added the comment:


New changeset c0799ec973530ad2492bb1d6c7287ffc428f0348 by Victor Stinner (Gus Goulart) in branch 'master':
bpo-27741: Better wording for datetime.strptime() (GH-9994)
https://github.com/python/cpython/commit/c0799ec973530ad2492bb1d6c7287ffc428f0348


----------
nosy: +vstinner

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue27741>
_______________________________________

From report at bugs.python.org  Mon Oct 29 07:50:32 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 29 Oct 2018 11:50:32 +0000
Subject: [docs] [issue27741] datetime.datetime.strptime functionality
 description incorrect
In-Reply-To: <1470941311.19.0.0562450492824.issue27741@psf.upfronthosting.co.za>
Message-ID: <1540813832.88.0.702299269573.issue27741@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +9529

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue27741>
_______________________________________

From report at bugs.python.org  Mon Oct 29 07:50:42 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 29 Oct 2018 11:50:42 +0000
Subject: [docs] [issue27741] datetime.datetime.strptime functionality
 description incorrect
In-Reply-To: <1470941311.19.0.0562450492824.issue27741@psf.upfronthosting.co.za>
Message-ID: <1540813842.71.0.702299269573.issue27741@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +9530

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue27741>
_______________________________________

From report at bugs.python.org  Mon Oct 29 07:50:57 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 29 Oct 2018 11:50:57 +0000
Subject: [docs] [issue27741] datetime.datetime.strptime functionality
 description incorrect
In-Reply-To: <1470941311.19.0.0562450492824.issue27741@psf.upfronthosting.co.za>
Message-ID: <1540813857.72.0.702299269573.issue27741@psf.upfronthosting.co.za>


Change by miss-islington <mariatta.wijaya+miss-islington at gmail.com>:


----------
pull_requests: +9531

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue27741>
_______________________________________

From report at bugs.python.org  Mon Oct 29 07:52:56 2018
From: report at bugs.python.org (Tal Einat)
Date: Mon, 29 Oct 2018 11:52:56 +0000
Subject: [docs] [issue19376] document that strptime() does not support the
 Feb 29 if the format does not contain the year
In-Reply-To: <1382608937.44.0.992947795428.issue19376@psf.upfronthosting.co.za>
Message-ID: <1540813976.04.0.788709270274.issue19376@psf.upfronthosting.co.za>


Tal Einat <taleinat at gmail.com> added the comment:

This is a great, easy, doc-only issue for a new contributor to handle.

----------
keywords: +easy
nosy: +taleinat
versions: +Python 3.6, Python 3.7, Python 3.8 -Python 3.2, Python 3.3

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue19376>
_______________________________________

From report at bugs.python.org  Mon Oct 29 07:54:57 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 29 Oct 2018 11:54:57 +0000
Subject: [docs] [issue27741] datetime.datetime.strptime functionality
 description incorrect
In-Reply-To: <1470941311.19.0.0562450492824.issue27741@psf.upfronthosting.co.za>
Message-ID: <1540814097.26.0.788709270274.issue27741@psf.upfronthosting.co.za>


miss-islington <mariatta.wijaya+miss-islington at gmail.com> added the comment:


New changeset 0a53a067dc4eb86ecf94c50582b3e22359c601a9 by Miss Islington (bot) in branch '3.6':
bpo-27741: Better wording for datetime.strptime() (GH-9994)
https://github.com/python/cpython/commit/0a53a067dc4eb86ecf94c50582b3e22359c601a9


----------
nosy: +miss-islington

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue27741>
_______________________________________

From report at bugs.python.org  Mon Oct 29 07:55:10 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 29 Oct 2018 11:55:10 +0000
Subject: [docs] [issue27741] datetime.datetime.strptime functionality
 description incorrect
In-Reply-To: <1470941311.19.0.0562450492824.issue27741@psf.upfronthosting.co.za>
Message-ID: <1540814110.63.0.788709270274.issue27741@psf.upfronthosting.co.za>


miss-islington <mariatta.wijaya+miss-islington at gmail.com> added the comment:


New changeset a02bc719ebc496bc527e9e46de2f2e83f68bfd77 by Miss Islington (bot) in branch '3.7':
bpo-27741: Better wording for datetime.strptime() (GH-9994)
https://github.com/python/cpython/commit/a02bc719ebc496bc527e9e46de2f2e83f68bfd77


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue27741>
_______________________________________

From report at bugs.python.org  Mon Oct 29 07:55:17 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 29 Oct 2018 11:55:17 +0000
Subject: [docs] [issue27741] datetime.datetime.strptime functionality
 description incorrect
In-Reply-To: <1470941311.19.0.0562450492824.issue27741@psf.upfronthosting.co.za>
Message-ID: <1540814117.76.0.788709270274.issue27741@psf.upfronthosting.co.za>


miss-islington <mariatta.wijaya+miss-islington at gmail.com> added the comment:


New changeset 4ec427b005036dab0a380de20f31774394ca4dd6 by Miss Islington (bot) in branch '2.7':
bpo-27741: Better wording for datetime.strptime() (GH-9994)
https://github.com/python/cpython/commit/4ec427b005036dab0a380de20f31774394ca4dd6


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue27741>
_______________________________________

From report at bugs.python.org  Mon Oct 29 08:24:51 2018
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 29 Oct 2018 12:24:51 +0000
Subject: [docs] [issue35105] Document that CPython accepts "invalid"
 identifiers
Message-ID: <1540815891.13.0.788709270274.issue35105@psf.upfronthosting.co.za>


New submission from STINNER Victor <vstinner at redhat.com>:

The Python 3 language has a strict definition for an identifier:
https://docs.python.org/dev/reference/lexical_analysis.html#identifiers

... but in practice, it's possible to create "invalid" identifiers using setattr().

Example with PyPy:

$ pypy
Python 2.7.13 (0e7ea4fe15e82d5124e805e2e4a37cae1a402d4b, Apr 12 2018, 14:50:12)
>>>> class A: pass
>>>> 
>>>> a=A()
>>>> setattr(a, "1", 2)
>>>> getattr(a, "1")
2

>>>> vars(a)
{'1': 2}
>>>> a.__dict__
{'1': 2}

>>>> a.1
  File "<stdin>", line 1
    a.1
    ^
SyntaxError: invalid syntax


The exact definition of "identifiers" is a common question. Recent examples:

* bpo-25205
* [Python-Dev] Arbitrary non-identifier string keys when using **kwargs
  https://mail.python.org/pipermail/python-dev/2018-October/155435.html

It would be nice to document the answer. Maybe in the Langage Specification, maybe in the setattr() documentation, maybe in a FAQ, maybe everywhere?

----------
assignee: docs at python
components: Documentation
messages: 328816
nosy: docs at python, serhiy.storchaka, steven.daprano, vstinner
priority: normal
severity: normal
status: open
title: Document that CPython accepts "invalid" identifiers
versions: Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35105>
_______________________________________

From report at bugs.python.org  Mon Oct 29 08:25:09 2018
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 29 Oct 2018 12:25:09 +0000
Subject: [docs] [issue25205] setattr accepts invalid identifiers
In-Reply-To: <1442861960.51.0.201067879836.issue25205@psf.upfronthosting.co.za>
Message-ID: <1540815909.9.0.788709270274.issue25205@psf.upfronthosting.co.za>


STINNER Victor <vstinner at redhat.com> added the comment:

I created bpo-35105 to propose to document the behavior.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue25205>
_______________________________________

From report at bugs.python.org  Mon Oct 29 08:26:08 2018
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 29 Oct 2018 12:26:08 +0000
Subject: [docs] [issue27741] datetime.datetime.strptime functionality
 description incorrect
In-Reply-To: <1470941311.19.0.0562450492824.issue27741@psf.upfronthosting.co.za>
Message-ID: <1540815968.51.0.788709270274.issue27741@psf.upfronthosting.co.za>


STINNER Victor <vstinner at redhat.com> added the comment:

Thanks Nicholas Colclasure for the bug report and Gus Goulart for the fix.

----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue27741>
_______________________________________

From report at bugs.python.org  Mon Oct 29 08:34:16 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Mon, 29 Oct 2018 12:34:16 +0000
Subject: [docs] [issue35105] Document that CPython accepts "invalid"
 identifiers
In-Reply-To: <1540815891.13.0.788709270274.issue35105@psf.upfronthosting.co.za>
Message-ID: <1540816456.41.0.702299269573.issue35105@psf.upfronthosting.co.za>


Change by Karthikeyan Singaravelan <tir.karthi at gmail.com>:


----------
nosy: +xtreak

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35105>
_______________________________________

From report at bugs.python.org  Mon Oct 29 14:20:27 2018
From: report at bugs.python.org (Joy Diamond)
Date: Mon, 29 Oct 2018 18:20:27 +0000
Subject: [docs] [issue35106] Add documentation for `type.__subclasses__` to
 docs.python.org
Message-ID: <1540837227.59.0.788709270274.issue35106@psf.upfronthosting.co.za>


New submission from Joy Diamond <python.gem at gmail.com>:

Add documentation for `type.__subclasses__` to docs.python.org

Python ideas discussion:

https://mail.python.org/pipermail/python-ideas/2018-October/054361.html

----------
assignee: docs at python
components: Documentation
messages: 328848
nosy: docs at python, joydiamond
priority: normal
severity: normal
status: open
title: Add documentation for `type.__subclasses__` to docs.python.org
versions: Python 2.7, Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35106>
_______________________________________

From report at bugs.python.org  Mon Oct 29 14:24:20 2018
From: report at bugs.python.org (Joy Diamond)
Date: Mon, 29 Oct 2018 18:24:20 +0000
Subject: [docs] [issue35106] Add documentation for `type.__subclasses__` to
 docs.python.org
In-Reply-To: <1540837227.59.0.788709270274.issue35106@psf.upfronthosting.co.za>
Message-ID: <1540837460.02.0.788709270274.issue35106@psf.upfronthosting.co.za>


Joy Diamond <python.gem at gmail.com> added the comment:

Documented here: https://docs.python.org/3/library/stdtypes.html#class.__subclasses__

(Though does not appear in google searches)

----------
stage:  -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35106>
_______________________________________

From report at bugs.python.org  Mon Oct 29 15:37:41 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Mon, 29 Oct 2018 19:37:41 +0000
Subject: [docs] [issue23220] IDLE: Document how Shell displays user code
 output
In-Reply-To: <1420937687.17.0.885670059147.issue23220@psf.upfronthosting.co.za>
Message-ID: <1540841860.93.0.788709270274.issue23220@psf.upfronthosting.co.za>


Terry J. Reedy <tjreedy at udel.edu> added the comment:

While editing 'IDLE-console differences' (added in the patch above) for #35099, I decided that it should be renamed (to, say, 'Executing user code') and limited to the effect of executing user code in IDLE's execution process instead of a standard python process. Except for a intentional change to make developing tkinter code easier, such effects are unintended and possibly bad for developers using IDLE.

This issue is about one aspect of how IDLE's Shell, in the GUI process, displays strings and bytes sent from the execution process via sys.stdout and sys.stderr.  My previous revision of the title was wrong and my previous patch not directly relevant.

I will make a new patch to add a new section ('Displaying user code output'?) describing various aspects of how Shell displays std text output, starting with this one.  Most of the differences from various consoles and terminal are intentional and considered to be net positives.

While the handling of control characters is inherited from tk, Serhiy and I have claimed on other issues that displaying one glyph per character has advantages for development as well as disadvantages.  (Being about to display all but only the BMP subset of unicode is also inherited from tcl/tk.)

One of my unposted ideas is to add an option to the run menu to run edited code in the system console/terminal, detached from IDLE, the same as if the file were run from a command line or directory listing.  This would bypass both IDLE's execution and display effects.

----------
title: Documents input/output effects of how IDLE runs user code -> IDLE: Document how Shell displays user code output
versions: +Python 3.6, Python 3.7, Python 3.8 -Python 2.7, Python 3.4, Python 3.5

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue23220>
_______________________________________

From report at bugs.python.org  Mon Oct 29 15:59:01 2018
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 29 Oct 2018 19:59:01 +0000
Subject: [docs] [issue22021] shutil.make_archive()  root_dir do not work
In-Reply-To: <1405936213.68.0.143186152462.issue22021@psf.upfronthosting.co.za>
Message-ID: <1540843141.7.0.788709270274.issue22021@psf.upfronthosting.co.za>


STINNER Victor <vstinner at redhat.com> added the comment:

FYI.

Joannah Nanjekye converted Issue22021.patch into a PR: PR 10191.

Serhiy Storchaka closed the PR: "The current behavior looks correct to me. It is consistent with the behavior of the tar command. This change breaks tests and I think it will break user code. Read the discussion on bpo-22021."
https://github.com/python/cpython/pull/10191#issuecomment-434040367

----------
nosy: +vstinner

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue22021>
_______________________________________

From report at bugs.python.org  Mon Oct 29 16:11:23 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 29 Oct 2018 20:11:23 +0000
Subject: [docs] [issue22021] shutil.make_archive()  root_dir do not work
In-Reply-To: <1405936213.68.0.143186152462.issue22021@psf.upfronthosting.co.za>
Message-ID: <1540843883.31.0.788709270274.issue22021@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:

This is a documentation issue.

----------
stage: patch review -> needs patch
versions: +Python 3.7, Python 3.8 -Python 3.5

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue22021>
_______________________________________

From report at bugs.python.org  Tue Oct 30 04:34:25 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Tue, 30 Oct 2018 08:34:25 +0000
Subject: [docs] [issue35109] Doctest in CI uses python binary built from
 master causing DeprecationWarnings
Message-ID: <1540888465.31.0.788709270274.issue35109@psf.upfronthosting.co.za>


New submission from Karthikeyan Singaravelan <tir.karthi at gmail.com>:

Currently we run doctest in CI and we use the environment variable PYTHON to get the path of python binary to be used for virtualenv creation. We set PYTHON=../python in .travis.yml at [0] before running tests thus this causes the CI to use development version of the binary. Some of the modules used for doctest have incompatible changes related to importing from collections. The DeprecationWarning related code will be removed in 3.8 thus it will cause the doctest to fail while using the modules in CI. Since I have enabled -W in issue34081 they are visible now.

I propose using stable version of Python like python 3.7 so that when we remove collections import related code in master the doctest doesn't fail on Travis. There are respective PRs for this warnings in the repo but using stable version will fix this. We don't need to test the modules against the master branch of Python for doctest which is currently doing.

Sample warning : https://travis-ci.org/python/cpython/jobs/448195459#L2603

> /home/travis/build/python/cpython/Doc/venv/lib/python3.8/site-packages/babel/localedata.py:17: DeprecationWarning: Using or importing the ABCs from 'collections' instead of from 'collections.abc' is deprecated, and in 3.8 it will stop working
>  from collections import MutableMapping

On local machine the .travis.yml is not executed thus it uses PYTHON=python3 in Doc/Makefile and thus this not a problem locally building the docs that uses a stable version of Python.


Adding @mdk for feedback on this.

[0] https://github.com/python/cpython/blob/master/.travis.yml#L164

----------
assignee: docs at python
components: Build, Documentation
messages: 328886
nosy: docs at python, mdk, xtreak
priority: normal
severity: normal
status: open
title: Doctest in CI uses python binary built from master causing DeprecationWarnings
versions: Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35109>
_______________________________________

From report at bugs.python.org  Tue Oct 30 05:40:33 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 30 Oct 2018 09:40:33 +0000
Subject: [docs] [issue35110] Fix more spaces around hyphens and dashes
Message-ID: <1540892433.13.0.788709270274.issue35110@psf.upfronthosting.co.za>


New submission from Serhiy Storchaka <storchaka+cpython at gmail.com>:

The following PR fixes several common errors in reStructuredText formatting.

* When the line is broken after or before a hyphen or dash, a space will be inserted after or before a hyphen or dash in the rendered text. This is not always appropriate. It is a common error when use old blurb (was blurb with the fix released?), but can be introduced also manually.

* Backslash followed by a space is used as a separator after a mark up, which doesn't insert a space. But when the line was broken on this space, this is not always work.

Fixed also other similar errors.

----------
assignee: docs at python
components: Documentation
messages: 328889
nosy: docs at python, mdk, serhiy.storchaka
priority: normal
severity: normal
status: open
title: Fix more spaces around hyphens and dashes
versions: Python 3.6, Python 3.7, Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35110>
_______________________________________

From report at bugs.python.org  Tue Oct 30 05:44:01 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 30 Oct 2018 09:44:01 +0000
Subject: [docs] [issue35110] Fix more spaces around hyphens and dashes
In-Reply-To: <1540892433.13.0.788709270274.issue35110@psf.upfronthosting.co.za>
Message-ID: <1540892641.12.0.702299269573.issue35110@psf.upfronthosting.co.za>


Change by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
keywords: +patch
pull_requests: +9543
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35110>
_______________________________________

From report at bugs.python.org  Tue Oct 30 07:13:55 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 30 Oct 2018 11:13:55 +0000
Subject: [docs] [issue35110] Fix more spaces around hyphens and dashes
In-Reply-To: <1540892433.13.0.788709270274.issue35110@psf.upfronthosting.co.za>
Message-ID: <1540898035.37.0.788709270274.issue35110@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:

Previous fixes for similar issues: PR 7002, PR 7579.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35110>
_______________________________________

From report at bugs.python.org  Tue Oct 30 08:21:55 2018
From: report at bugs.python.org (Felipe Rodrigues)
Date: Tue, 30 Oct 2018 12:21:55 +0000
Subject: [docs] [issue19376] document that strptime() does not support the
 Feb 29 if the format does not contain the year
In-Reply-To: <1382608937.44.0.992947795428.issue19376@psf.upfronthosting.co.za>
Message-ID: <1540902115.5.0.788709270274.issue19376@psf.upfronthosting.co.za>


Felipe Rodrigues <felipe at felipevr.com> added the comment:

What about adding some more information in the exception message in addition to the docs? I mean, if we're raising an issue because someone inserted Feb 29, we add a note about leap year in the exception message

----------
nosy: +fbidu

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue19376>
_______________________________________

From report at bugs.python.org  Tue Oct 30 09:40:17 2018
From: report at bugs.python.org (Josh Rosenberg)
Date: Tue, 30 Oct 2018 13:40:17 +0000
Subject: [docs] [issue35114] ssl.RAND_status docs describe it as returning
 True/False; actually returns 1/0
Message-ID: <1540906817.06.0.788709270274.issue35114@psf.upfronthosting.co.za>


New submission from Josh Rosenberg <shadowranger+python at gmail.com>:

The ssl.RAND_status online docs say (with code format on True/False):

"Return True if the SSL pseudo-random number generator has been seeded with ?enough? randomness, and False otherwise."

This is incorrect; the function actually returns 1 or 0 (and the docstring agrees).

Fix can be one of:

1. Update docs to be less specific about the return type (use true/false, not True/False)
2. Update docs to match docstring (which specifically says 1/0, not True/False)
3. Update implementation and docstring to actually return True/False (replacing PyLong_FromLong with PyBool_FromLong and changing docstring to use True/False to match online docs)

#3 involves a small amount of code churn, but it also means we're not needlessly replicating a C API's use of int return values when the function is logically bool (there is no error status for the C API AFAICT, so it's not like returning int gains us anything on flexibility). bool would be mathematically equivalent to the original 1/0 return value in the rare cases someone uses it mathematically.

----------
assignee: docs at python
components: Documentation, SSL
messages: 328917
nosy: docs at python, josh.r
priority: low
severity: normal
status: open
title: ssl.RAND_status docs describe it as returning True/False; actually returns 1/0
type: behavior

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35114>
_______________________________________

From report at bugs.python.org  Tue Oct 30 10:03:47 2018
From: report at bugs.python.org (Paul Ganssle)
Date: Tue, 30 Oct 2018 14:03:47 +0000
Subject: [docs] [issue19376] document that strptime() does not support the
 Feb 29 if the format does not contain the year
In-Reply-To: <1382608937.44.0.992947795428.issue19376@psf.upfronthosting.co.za>
Message-ID: <1540908227.6.0.702299269573.issue19376@psf.upfronthosting.co.za>


Change by Paul Ganssle <p.ganssle at gmail.com>:


----------
nosy: +p-ganssle

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue19376>
_______________________________________

From report at bugs.python.org  Tue Oct 30 10:39:55 2018
From: report at bugs.python.org (Paul Ganssle)
Date: Tue, 30 Oct 2018 14:39:55 +0000
Subject: [docs] [issue19376] document that strptime() does not support the
 Feb 29 if the format does not contain the year
In-Reply-To: <1382608937.44.0.992947795428.issue19376@psf.upfronthosting.co.za>
Message-ID: <1540910395.64.0.788709270274.issue19376@psf.upfronthosting.co.za>


Paul Ganssle <p.ganssle at gmail.com> added the comment:

@Victor: You mean a PR to fix the *issue* or a PR to add this to the docs?

The current behavior is pretty counter-intuitive, particularly because it also fails because of the (relatively) little-known fact that 1900 happens to not be a leap year because it is evenly divisible by 100 but not by 400.

I think it's pretty simple for end-users to work around this:

def strptime_smarter(dtstr, fmt):
    try:
        return datetime.strptime(dtstr, fmt)
    except ValueError:
        tt = time.strptime(dtstr, fmt)
        if tt[0:3] == (1900, 2, 29):
            return datetime(1904, *tt[1:6])
        raise


But this is largely a problem that arises because we don't have any concept of a "partial datetime", see this dateutil issue: https://github.com/dateutil/dateutil/issues/449

What users want when they do `datetime.strptime("Feb 29", "%b %d")` is something like `(None, 2, 29)`, but we're both specifying an arbitrary default year *and* enforcing that the final date be legal. I think the best solution would be to change the default year to 2000 for *all* dates, but for historical reasons that is just not feasible. :(

Another option is that we could allow specifying a "default date" from which missing values would be drawn. We have done this in dateutil.parser.parse: https://dateutil.readthedocs.io/en/stable/parser.html#dateutil.parser.parse

The biggest problem in dateutil is that the default value for "default date" is the *current date*, which causes many problems with reproducibility. For `datetime.strptime`, the default value would be `datetime(1900, 1, 1)`, which has none of those same problems.

Still, adding such a parameter to `datetime.strptime` seems like a lot of effort to go through to just to make it *easier* for people to work around this bug in `strptime`, particularly since in this case you can *kinda* do the same thing with:

    strptime('1904 ' + dtstr, '%Y %b %d')

Long-winded carping on about datetime issues aside, I think my final vote is for leaving the behavior as-is and documenting it. Looking at the documentation, the only documentation I see for what happens when you don't have %Y, %m or %d is:

    For time objects, the format codes for year, month, and day should not be used,
    as time objects have no such values. If they?re used anyway, 1900 is substituted
    for the year, and 1 for the month and day.

This only makes sense in the context of `strftime`. I think for starters we should document the behavior of strptime when no year, month or day are specified. As part of that documentation, we can add a footnote about Feb 29th.

I can make a PR for this, but as Tal mentions, I think this is a good issue for a first-time contributor, so I'd like to give someone else an opportunity to take a crack at this.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue19376>
_______________________________________

From report at bugs.python.org  Tue Oct 30 11:20:51 2018
From: report at bugs.python.org (abhishek)
Date: Tue, 30 Oct 2018 15:20:51 +0000
Subject: [docs] [issue19376] document that strptime() does not support the
 Feb 29 if the format does not contain the year
In-Reply-To: <1382608937.44.0.992947795428.issue19376@psf.upfronthosting.co.za>
Message-ID: <1540912851.41.0.702299269573.issue19376@psf.upfronthosting.co.za>


Change by abhishek <abhishek4bhopati at gmail.com>:


----------
keywords: +patch
pull_requests: +9556
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue19376>
_______________________________________

From report at bugs.python.org  Tue Oct 30 14:48:53 2018
From: report at bugs.python.org (Matthew Belisle)
Date: Tue, 30 Oct 2018 18:48:53 +0000
Subject: [docs] [issue35116] Doc/library entries for cgi.FieldStorage
 max_num_fields
Message-ID: <1540925333.22.0.788709270274.issue35116@psf.upfronthosting.co.za>


New submission from Matthew Belisle <matthew.belisle at workiva.com>:

vstinner pointed out that cgi.FieldStorage max_num_fields needs documentation added to Doc/library.

https://bugs.python.org/issue34866#msg328401

----------
assignee: docs at python
components: Documentation
messages: 328937
nosy: Matthew Belisle, docs at python
priority: normal
severity: normal
status: open
title: Doc/library entries for cgi.FieldStorage max_num_fields
type: enhancement
versions: Python 3.6, Python 3.7, Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35116>
_______________________________________

From report at bugs.python.org  Tue Oct 30 14:49:52 2018
From: report at bugs.python.org (Matthew Belisle)
Date: Tue, 30 Oct 2018 18:49:52 +0000
Subject: [docs] [issue35116] Doc/library entries for cgi.FieldStorage
 max_num_fields
In-Reply-To: <1540925333.22.0.788709270274.issue35116@psf.upfronthosting.co.za>
Message-ID: <1540925392.11.0.702299269573.issue35116@psf.upfronthosting.co.za>


Change by Matthew Belisle <matthew.belisle at workiva.com>:


----------
keywords: +patch
pull_requests: +9560
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35116>
_______________________________________

From report at bugs.python.org  Tue Oct 30 14:57:12 2018
From: report at bugs.python.org (Matthew Belisle)
Date: Tue, 30 Oct 2018 18:57:12 +0000
Subject: [docs] [issue35116] Doc/library entries for cgi.FieldStorage
 max_num_fields
In-Reply-To: <1540925333.22.0.788709270274.issue35116@psf.upfronthosting.co.za>
Message-ID: <1540925832.26.0.702299269573.issue35116@psf.upfronthosting.co.za>


Change by Matthew Belisle <matthew.belisle at workiva.com>:


----------
pull_requests: +9561

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35116>
_______________________________________

From report at bugs.python.org  Tue Oct 30 15:01:44 2018
From: report at bugs.python.org (Matthew Belisle)
Date: Tue, 30 Oct 2018 19:01:44 +0000
Subject: [docs] [issue35116] Doc/library entries for cgi.FieldStorage
 max_num_fields
In-Reply-To: <1540925333.22.0.788709270274.issue35116@psf.upfronthosting.co.za>
Message-ID: <1540926104.0.0.702299269573.issue35116@psf.upfronthosting.co.za>


Change by Matthew Belisle <matthew.belisle at workiva.com>:


----------
pull_requests: +9562

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35116>
_______________________________________

From report at bugs.python.org  Tue Oct 30 16:30:24 2018
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 30 Oct 2018 20:30:24 +0000
Subject: [docs] [issue35116] Doc/library entries for cgi.FieldStorage
 max_num_fields
In-Reply-To: <1540925333.22.0.788709270274.issue35116@psf.upfronthosting.co.za>
Message-ID: <1540931424.88.0.788709270274.issue35116@psf.upfronthosting.co.za>


STINNER Victor <vstinner at redhat.com> added the comment:


New changeset 68f323715e6627c550d1e8ffed7e36f1bb4aa42b by Victor Stinner (matthewbelisle-wf) in branch 'master':
bpo-35116, urllib.parse: Document the new max_num_fields parameter (GH-10247)
https://github.com/python/cpython/commit/68f323715e6627c550d1e8ffed7e36f1bb4aa42b


----------
nosy: +vstinner

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35116>
_______________________________________

From report at bugs.python.org  Tue Oct 30 17:15:23 2018
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 30 Oct 2018 21:15:23 +0000
Subject: [docs] [issue35116] Doc/library entries for cgi.FieldStorage
 max_num_fields
In-Reply-To: <1540925333.22.0.788709270274.issue35116@psf.upfronthosting.co.za>
Message-ID: <1540934123.1.0.788709270274.issue35116@psf.upfronthosting.co.za>


STINNER Victor <vstinner at redhat.com> added the comment:


New changeset 691196d1af6a7e9d218e3281a8f3385616b2ca86 by Victor Stinner (matthewbelisle-wf) in branch '3.6':
bpo-35116, urllib.parse: Document the new max_num_fields parameter (GH-10248)
https://github.com/python/cpython/commit/691196d1af6a7e9d218e3281a8f3385616b2ca86


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35116>
_______________________________________

From report at bugs.python.org  Tue Oct 30 17:15:30 2018
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 30 Oct 2018 21:15:30 +0000
Subject: [docs] [issue35116] Doc/library entries for cgi.FieldStorage
 max_num_fields
In-Reply-To: <1540925333.22.0.788709270274.issue35116@psf.upfronthosting.co.za>
Message-ID: <1540934130.88.0.788709270274.issue35116@psf.upfronthosting.co.za>


STINNER Victor <vstinner at redhat.com> added the comment:


New changeset aa0a21a7c81cb4eca723b0f400e860a0e8e730b5 by Victor Stinner (matthewbelisle-wf) in branch '3.7':
bpo-35116, urllib.parse: Document the new max_num_fields parameter (GH-10246)
https://github.com/python/cpython/commit/aa0a21a7c81cb4eca723b0f400e860a0e8e730b5


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35116>
_______________________________________

From report at bugs.python.org  Tue Oct 30 17:16:58 2018
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 30 Oct 2018 21:16:58 +0000
Subject: [docs] [issue35116] Doc/library entries for cgi.FieldStorage
 max_num_fields
In-Reply-To: <1540925333.22.0.788709270274.issue35116@psf.upfronthosting.co.za>
Message-ID: <1540934218.43.0.702299269573.issue35116@psf.upfronthosting.co.za>


Change by STINNER Victor <vstinner at redhat.com>:


----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35116>
_______________________________________

From report at bugs.python.org  Tue Oct 30 18:36:37 2018
From: report at bugs.python.org (Julien Palard)
Date: Tue, 30 Oct 2018 22:36:37 +0000
Subject: [docs] [issue35109] Doctest in CI uses python binary built from
 master causing DeprecationWarnings
In-Reply-To: <1540888465.31.0.788709270274.issue35109@psf.upfronthosting.co.za>
Message-ID: <1540938997.36.0.702299269573.issue35109@psf.upfronthosting.co.za>


Change by Julien Palard <julien+python at palard.fr>:


----------
nosy: +matrixise

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35109>
_______________________________________

From report at bugs.python.org  Tue Oct 30 18:45:46 2018
From: report at bugs.python.org (Julien Palard)
Date: Tue, 30 Oct 2018 22:45:46 +0000
Subject: [docs] [issue35109] Doctest in CI uses python binary built from
 master causing DeprecationWarnings
In-Reply-To: <1540888465.31.0.788709270274.issue35109@psf.upfronthosting.co.za>
Message-ID: <1540939546.89.0.788709270274.issue35109@psf.upfronthosting.co.za>


Julien Palard <julien+python at palard.fr> added the comment:

> I propose using stable version of Python like python 3.7

If we do so, we won't be able to write doctest about new features (existing in 3.8, not existing in 3.7), which is worse than having warnings.

I think the right move is to do some PR on remote projects (like babel) to fix the warning, future-proofing them from having a real issue in 3.8.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35109>
_______________________________________

From report at bugs.python.org  Tue Oct 30 19:11:47 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Tue, 30 Oct 2018 23:11:47 +0000
Subject: [docs] [issue35109] Doctest in CI uses python binary built from
 master causing DeprecationWarnings
In-Reply-To: <1540888465.31.0.788709270274.issue35109@psf.upfronthosting.co.za>
Message-ID: <1540941107.72.0.788709270274.issue35109@psf.upfronthosting.co.za>


Karthikeyan Singaravelan <tir.karthi at gmail.com> added the comment:

I have an open PR for babel https://github.com/python-babel/babel/pull/608 . The problem is merging them and cutting a new release depends on the maintainers availability. Once it's fixed we have to make sure dependencies of babel like sphinx use the latest version and also make a release if needed. I agree it has to be fixed on those projects but coordinating release across various projects depends on the maintainers availability and shouldn't end up as a blocker for CPython's development here and in future with these type of deprecation warnings. I suggested using a stable version because when ran locally make venv for doctest uses python3 as binary name and on CI it uses python built from master branch that might cause confusion. Also it's not necessarily CPython's responsibility to make sure all our external projects work well on development branch.

We can keep this as an open issue while the warnings are fixed in the projects and also use this for reference when the collections import related code has to be removed.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35109>
_______________________________________

From report at bugs.python.org  Tue Oct 30 19:19:54 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Tue, 30 Oct 2018 23:19:54 +0000
Subject: [docs] [issue35109] Doctest in CI uses python binary built from
 master causing DeprecationWarnings
In-Reply-To: <1540888465.31.0.788709270274.issue35109@psf.upfronthosting.co.za>
Message-ID: <1540941594.03.0.788709270274.issue35109@psf.upfronthosting.co.za>


Karthikeyan Singaravelan <tir.karthi at gmail.com> added the comment:

> If we do so, we won't be able to write doctest about new features (existing in 3.8, not existing in 3.7), which is worse than having warnings.

I agree with the same. Maybe I am running doctest wrong locally? I use make venv and make doctest. Sorry for the confusion on this.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35109>
_______________________________________

From report at bugs.python.org  Tue Oct 30 19:29:27 2018
From: report at bugs.python.org (Julien Palard)
Date: Tue, 30 Oct 2018 23:29:27 +0000
Subject: [docs] [issue35109] Doctest in CI uses python binary built from
 master causing DeprecationWarnings
In-Reply-To: <1540888465.31.0.788709270274.issue35109@psf.upfronthosting.co.za>
Message-ID: <1540942167.44.0.788709270274.issue35109@psf.upfronthosting.co.za>


Julien Palard <julien+python at palard.fr> added the comment:

> Maybe I am running doctest wrong locally?

Dunno. IIRC we had problems running doctest with a Python 3.7 on the 3.8 branch, which make sense.

Anyway, if it works today, the first developper writing doctest about a 3.8 feature will cause a doctest failure so no we can't use 3.7 to test 3.8.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35109>
_______________________________________

From report at bugs.python.org  Tue Oct 30 19:37:20 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Tue, 30 Oct 2018 23:37:20 +0000
Subject: [docs] [issue35109] Doctest in CI uses python binary built from
 master causing DeprecationWarnings
In-Reply-To: <1540888465.31.0.788709270274.issue35109@psf.upfronthosting.co.za>
Message-ID: <1540942640.36.0.788709270274.issue35109@psf.upfronthosting.co.za>


Karthikeyan Singaravelan <tir.karthi at gmail.com> added the comment:

> Anyway, if it works today, the first developper writing doctest about a 3.8 feature will cause a doctest failure so no we can't use 3.7 to test 3.8.

Agreed that we need to run on the master branch binary for 3.8 only features like PEP 572 which is a language level change. Sorry, I forgot about that scenario. I guess it's then the right way to fix the dependencies upstream so that they work properly on development branch going forward.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35109>
_______________________________________

From report at bugs.python.org  Tue Oct 30 19:49:36 2018
From: report at bugs.python.org (Lisa Roach)
Date: Tue, 30 Oct 2018 23:49:36 +0000
Subject: [docs] [issue34788] ipaddress module fails on rfc4007 scoped IPv6
 addresses
In-Reply-To: <1537799403.03.0.956365154283.issue34788@psf.upfronthosting.co.za>
Message-ID: <1540943376.71.0.788709270274.issue34788@psf.upfronthosting.co.za>


Lisa Roach <lisaroach14 at gmail.com> added the comment:

I think this is something that would be good to have. Jeremy would you care to make a PR for this?

----------
nosy: +lisroach

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue34788>
_______________________________________

From report at bugs.python.org  Tue Oct 30 20:26:10 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 31 Oct 2018 00:26:10 +0000
Subject: [docs] [issue35110] Fix more spaces around hyphens and dashes
In-Reply-To: <1540892433.13.0.788709270274.issue35110@psf.upfronthosting.co.za>
Message-ID: <1540945570.93.0.788709270274.issue35110@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:


New changeset 3f819ca138db6945ee4271bf13e42db9f9b3b1e4 by Serhiy Storchaka in branch 'master':
bpo-35110: Fix unintentional spaces around hyphens and dashes. (GH-10231)
https://github.com/python/cpython/commit/3f819ca138db6945ee4271bf13e42db9f9b3b1e4


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35110>
_______________________________________

From report at bugs.python.org  Tue Oct 30 23:20:18 2018
From: report at bugs.python.org (Windson Yang)
Date: Wed, 31 Oct 2018 03:20:18 +0000
Subject: [docs] [issue35118] Add peek() or first() method in queue
Message-ID: <1540956018.19.0.788709270274.issue35118@psf.upfronthosting.co.za>


New submission from Windson Yang <wiwindson at gmail.com>:

I found other languages like Java and C++ have the method to access the first value in Queue like first() and peek(). Since we use deque_ to create Queue now, it's easy to implement in python using the index. Otherwise, we can add this to the document? I also found some discussion_ here.


.. _deque: 
 https://github.com/python/cpython/blob/master/Lib/queue.py#L205

.. _discussion https://mail.python.org/pipermail/python-list/2010-March/569930.html

----------
assignee: docs at python
components: Documentation
messages: 328963
nosy: Windson Yang, docs at python
priority: normal
severity: normal
status: open
title: Add peek() or first() method in queue
type: enhancement
versions: Python 2.7, Python 3.4, Python 3.5, Python 3.6, Python 3.7, Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35118>
_______________________________________

From report at bugs.python.org  Tue Oct 30 23:38:13 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Wed, 31 Oct 2018 03:38:13 +0000
Subject: [docs] [issue35118] Add peek() or first() method in queue
In-Reply-To: <1540956018.19.0.788709270274.issue35118@psf.upfronthosting.co.za>
Message-ID: <1540957093.25.0.702299269573.issue35118@psf.upfronthosting.co.za>


Change by Raymond Hettinger <raymond.hettinger at gmail.com>:


----------
assignee: docs at python -> rhettinger
nosy: +rhettinger

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35118>
_______________________________________

From report at bugs.python.org  Wed Oct 31 00:06:35 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Wed, 31 Oct 2018 04:06:35 +0000
Subject: [docs] [issue35118] Add peek() or first() method in queue
In-Reply-To: <1540956018.19.0.788709270274.issue35118@psf.upfronthosting.co.za>
Message-ID: <1540958795.56.0.788709270274.issue35118@psf.upfronthosting.co.za>


Raymond Hettinger <raymond.hettinger at gmail.com> added the comment:

For deque, we have d[0].  Is anything more needed?  Even lists don't require a peek.

For Queue, I'm not sure I've ever seen any use case for peek.  What do you have in mind?  

* https://docs.oracle.com/javase/7/docs/api/java/util/Queue.html#peek()

----------
versions:  -Python 2.7, Python 3.4, Python 3.5, Python 3.6, Python 3.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35118>
_______________________________________

From report at bugs.python.org  Wed Oct 31 00:26:14 2018
From: report at bugs.python.org (Denis Osipov)
Date: Wed, 31 Oct 2018 04:26:14 +0000
Subject: [docs] [issue35119] Customizing module attribute access example
 raises RecursionError
Message-ID: <1540959974.35.0.788709270274.issue35119@psf.upfronthosting.co.za>


New submission from Denis Osipov <osipov_d at list.ru>:

Customizing module attribute access example raises RecursionError:

>>> import sys
>>> from types import ModuleType
>>> class VerboseModule(ModuleType):
...     def __repr__(self):
...         return f'Verbose {self.__name__}'
...     def __setattr__(self, attr, value):
...         print(f'Setting {attr}...')
...         setattr(self, attr, value)
...
>>> sys.modules[__name__].__class__ = VerboseModule
>>> sys.modules[__name__].a = 5
Setting a...
<...>
Setting a...
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "<stdin>", line 6, in __setattr__
  File "<stdin>", line 6, in __setattr__
  File "<stdin>", line 6, in __setattr__
  [Previous line repeated 495 more times]
  File "<stdin>", line 5, in __setattr__
RecursionError: maximum recursion depth exceeded while calling a Python object
Setting a...>>>

Something like this can fix it:

def __setattr__(self, attr, value):
...         print(f'Setting {attr}...')
...         super().setattr(self, attr, value)

----------
assignee: docs at python
components: Documentation
messages: 328966
nosy: denis-osipov, docs at python
priority: normal
severity: normal
status: open
title: Customizing module attribute access example raises RecursionError
type: behavior
versions: Python 3.7, Python 3.8

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35119>
_______________________________________

From report at bugs.python.org  Wed Oct 31 01:23:49 2018
From: report at bugs.python.org (Windson Yang)
Date: Wed, 31 Oct 2018 05:23:49 +0000
Subject: [docs] [issue35118] Add peek() or first() method in queue
In-Reply-To: <1540956018.19.0.788709270274.issue35118@psf.upfronthosting.co.za>
Message-ID: <1540963429.35.0.788709270274.issue35118@psf.upfronthosting.co.za>


Windson Yang <wiwindson at gmail.com> added the comment:

For deque, we can add peek() function to deque or just make it clear in the document that we can use deque[0] to access the first element(I can only find index method in the document)

For Queue, I found Java and C++ has the function like first() or peek(), I'm not sure should we also implement a method like this.


* http://www.cplusplus.com/reference/queue/queue/

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35118>
_______________________________________

From report at bugs.python.org  Wed Oct 31 01:38:13 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Wed, 31 Oct 2018 05:38:13 +0000
Subject: [docs] [issue35118] Add peek() or first() method in queue
In-Reply-To: <1540956018.19.0.788709270274.issue35118@psf.upfronthosting.co.za>
Message-ID: <1540964293.38.0.788709270274.issue35118@psf.upfronthosting.co.za>


Raymond Hettinger <raymond.hettinger at gmail.com> added the comment:

In the absence of good use cases, I'll decline the API expansion.

Feel free to post a PR to have the deque documentation to mention d[0] indexing more prominently.  Am not really sure that is needed though, we don't have to point out the same thing for lists and I haven't encountered any misunderstandings on the topic.  This would be just a minor usage note.

----------
priority: normal -> low

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35118>
_______________________________________

From report at bugs.python.org  Wed Oct 31 04:22:39 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 31 Oct 2018 08:22:39 +0000
Subject: [docs] [issue35110] Fix more spaces around hyphens and dashes
In-Reply-To: <1540892433.13.0.788709270274.issue35110@psf.upfronthosting.co.za>
Message-ID: <1540974159.22.0.702299269573.issue35110@psf.upfronthosting.co.za>


Change by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
pull_requests: +9566

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35110>
_______________________________________

From report at bugs.python.org  Wed Oct 31 04:26:15 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 31 Oct 2018 08:26:15 +0000
Subject: [docs] [issue35110] Fix more spaces around hyphens and dashes
In-Reply-To: <1540892433.13.0.788709270274.issue35110@psf.upfronthosting.co.za>
Message-ID: <1540974375.49.0.702299269573.issue35110@psf.upfronthosting.co.za>


Change by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
pull_requests: +9567

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35110>
_______________________________________

From report at bugs.python.org  Wed Oct 31 05:00:28 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 31 Oct 2018 09:00:28 +0000
Subject: [docs] [issue35110] Fix more spaces around hyphens and dashes
In-Reply-To: <1540892433.13.0.788709270274.issue35110@psf.upfronthosting.co.za>
Message-ID: <1540976428.72.0.788709270274.issue35110@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:


New changeset b183750f999953bac7738b1fff114e0a2615d970 by Serhiy Storchaka in branch '3.7':
[3.7] bpo-35110: Fix unintentional spaces around hyphens and dashes. (GH-10231). (GH-10253)
https://github.com/python/cpython/commit/b183750f999953bac7738b1fff114e0a2615d970


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35110>
_______________________________________

From report at bugs.python.org  Wed Oct 31 05:00:42 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 31 Oct 2018 09:00:42 +0000
Subject: [docs] [issue35110] Fix more spaces around hyphens and dashes
In-Reply-To: <1540892433.13.0.788709270274.issue35110@psf.upfronthosting.co.za>
Message-ID: <1540976442.0.0.788709270274.issue35110@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:


New changeset 1e8c18509eb15efb8e80971b9935d17e7bbeabf4 by Serhiy Storchaka in branch '3.6':
[3.6] bpo-35110: Fix unintentional spaces around hyphens and dashes. (GH-10231). (GH-10254)
https://github.com/python/cpython/commit/1e8c18509eb15efb8e80971b9935d17e7bbeabf4


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35110>
_______________________________________

From report at bugs.python.org  Wed Oct 31 05:01:30 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 31 Oct 2018 09:01:30 +0000
Subject: [docs] [issue35110] Fix more spaces around hyphens and dashes
In-Reply-To: <1540892433.13.0.788709270274.issue35110@psf.upfronthosting.co.za>
Message-ID: <1540976490.04.0.702299269573.issue35110@psf.upfronthosting.co.za>


Change by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
pull_requests: +9568

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35110>
_______________________________________

From report at bugs.python.org  Wed Oct 31 05:14:41 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 31 Oct 2018 09:14:41 +0000
Subject: [docs] [issue35110] Fix more spaces around hyphens and dashes
In-Reply-To: <1540892433.13.0.788709270274.issue35110@psf.upfronthosting.co.za>
Message-ID: <1540977281.23.0.788709270274.issue35110@psf.upfronthosting.co.za>


Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:


New changeset 511747bec3aca4ad7930005e3adece9196c1cd39 by Serhiy Storchaka in branch 'master':
bpo-35110: Fix yet few spaces before dashes. (GH-10255)
https://github.com/python/cpython/commit/511747bec3aca4ad7930005e3adece9196c1cd39


----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35110>
_______________________________________

From report at bugs.python.org  Wed Oct 31 05:15:14 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 31 Oct 2018 09:15:14 +0000
Subject: [docs] [issue35110] Fix more spaces around hyphens and dashes
In-Reply-To: <1540892433.13.0.788709270274.issue35110@psf.upfronthosting.co.za>
Message-ID: <1540977314.2.0.702299269573.issue35110@psf.upfronthosting.co.za>


Change by Serhiy Storchaka <storchaka+cpython at gmail.com>:


----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35110>
_______________________________________

From report at bugs.python.org  Wed Oct 31 07:08:44 2018
From: report at bugs.python.org (Pradyun Gedam)
Date: Wed, 31 Oct 2018 11:08:44 +0000
Subject: [docs] [issue21314] Document '/' in signatures
In-Reply-To: <1397988439.5.0.703056699862.issue21314@psf.upfronthosting.co.za>
Message-ID: <1540984124.67.0.788709270274.issue21314@psf.upfronthosting.co.za>


Pradyun Gedam <pradyunsg at gmail.com> added the comment:

We now have a PEP for this; just noting this here since I don't see a cross reference between them.

https://www.python.org/dev/peps/pep-0570/

----------
nosy: +pradyunsg

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue21314>
_______________________________________

From report at bugs.python.org  Wed Oct 31 08:52:22 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Wed, 31 Oct 2018 12:52:22 +0000
Subject: [docs] [issue35119] Customizing module attribute access example
 raises RecursionError
In-Reply-To: <1540959974.35.0.788709270274.issue35119@psf.upfronthosting.co.za>
Message-ID: <1540990342.68.0.788709270274.issue35119@psf.upfronthosting.co.za>


Karthikeyan Singaravelan <tir.karthi at gmail.com> added the comment:

Thanks for the report Denis. Would you like to propose a PR for this? The file is at https://github.com/python/cpython/blob/master/Doc/reference/datamodel.rst . This was added as part of 5364b5cd757. I am adding Ivan who added the example for confirmation and review.

----------
nosy: +levkivskyi, xtreak

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35119>
_______________________________________

From report at bugs.python.org  Wed Oct 31 09:29:59 2018
From: report at bugs.python.org (Tal Einat)
Date: Wed, 31 Oct 2018 13:29:59 +0000
Subject: [docs] [issue19376] document that strptime() does not support the
 Feb 29 if the format does not contain the year
In-Reply-To: <1382608937.44.0.992947795428.issue19376@psf.upfronthosting.co.za>
Message-ID: <1540992599.81.0.788709270274.issue19376@psf.upfronthosting.co.za>


Tal Einat <taleinat at gmail.com> added the comment:

> I think for starters we should document the behavior of strptime when no year, month or day are specified. As part of that documentation, we can add a footnote about Feb 29th.

This sounds good to me.

We could also improve the exception raised in the specific case of Feb 29th; IMO this should be a separate PR.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue19376>
_______________________________________

From report at bugs.python.org  Wed Oct 31 11:58:55 2018
From: report at bugs.python.org (Julien Palard)
Date: Wed, 31 Oct 2018 15:58:55 +0000
Subject: [docs] [issue35033] Column or row spanning cells are not
 implemented.
In-Reply-To: <1540052915.48.0.788709270274.issue35033@psf.upfronthosting.co.za>
Message-ID: <1541001535.65.0.788709270274.issue35033@psf.upfronthosting.co.za>


Julien Palard <julien+python at palard.fr> added the comment:

https://github.com/sphinx-doc/sphinx/pull/5559 has been merged, let's wait for a release of Sphinx and we'll be able to build Python 3.8 documentation as text again.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35033>
_______________________________________

From report at bugs.python.org  Wed Oct 31 11:59:07 2018
From: report at bugs.python.org (Ronald Oussoren)
Date: Wed, 31 Oct 2018 15:59:07 +0000
Subject: [docs] [issue35119] Customizing module attribute access example
 raises RecursionError
In-Reply-To: <1540959974.35.0.788709270274.issue35119@psf.upfronthosting.co.za>
Message-ID: <1541001547.24.0.788709270274.issue35119@psf.upfronthosting.co.za>


Ronald Oussoren <ronaldoussoren at mac.com> added the comment:

I'm not convinced that any change is needed, this is completely expected behaviour (and not special to modules).

The following code also raises RecursionError:

class VerboseObject:
    def __setattr__(self, nm, value):
        print(f"Setting {nm} to {value}")
        setattr(self, nm, value)

o = VerboseObject()
o.a = 42

This is because setattr() calls the __setattr__ method, which calls setattr() again, ... .


The fix is to call super().__setattr__ instead:

class VerboseObject:
    def __setattr__(self, nm, value):
        print(f"Setting {nm} to {value}")
        super().__setattr__(nm, value)

o = VerboseObject()
o.a = 42

----------
nosy: +ronaldoussoren

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35119>
_______________________________________

From report at bugs.python.org  Wed Oct 31 13:07:39 2018
From: report at bugs.python.org (Pawel)
Date: Wed, 31 Oct 2018 17:07:39 +0000
Subject: [docs] [issue35126] Mistake in FAQ about converting number to
 string.
Message-ID: <1541005659.07.0.788709270274.issue35126@psf.upfronthosting.co.za>


New submission from Pawel <grottrumsel at gmail.com>:

In this question:
https://docs.python.org/2.7/faq/programming.html#how-do-i-convert-a-number-to-a-string

There is a statement:
"{:.3f}".format(1/3) yields '0.333'

While

In [2]: "{:.3f}".format(1/3)
Out[2]: '0.000'

In [3]: "{:.3f}".format(1/3.0)
Out[3]: '0.333'

----------
assignee: docs at python
components: Documentation
messages: 329000
nosy: docs at python, grottrumsel
priority: normal
severity: normal
status: open
title: Mistake in FAQ about converting number to string.
versions: Python 2.7

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35126>
_______________________________________

From report at bugs.python.org  Wed Oct 31 16:01:50 2018
From: report at bugs.python.org (Lysandros Nikolaou)
Date: Wed, 31 Oct 2018 20:01:50 +0000
Subject: [docs] [issue30410] Documentation for sys.stdout encoding does not
 reflect the new Windows behavior in Python 3.6+
In-Reply-To: <1495270729.75.0.717879181788.issue30410@psf.upfronthosting.co.za>
Message-ID: <1541016110.03.0.702299269573.issue30410@psf.upfronthosting.co.za>


Change by Lysandros Nikolaou <lisandrosnik at gmail.com>:


----------
keywords: +patch
pull_requests: +9575
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue30410>
_______________________________________

From report at bugs.python.org  Wed Oct 31 16:14:01 2018
From: report at bugs.python.org (Windson Yang)
Date: Wed, 31 Oct 2018 20:14:01 +0000
Subject: [docs] [issue35118] Add peek() or first() method in queue
In-Reply-To: <1540956018.19.0.788709270274.issue35118@psf.upfronthosting.co.za>
Message-ID: <1541016841.07.0.702299269573.issue35118@psf.upfronthosting.co.za>


Change by Windson Yang <wiwindson at gmail.com>:


----------
keywords: +patch
pull_requests: +9576
stage:  -> patch review

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35118>
_______________________________________

From report at bugs.python.org  Wed Oct 31 16:22:17 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Wed, 31 Oct 2018 20:22:17 +0000
Subject: [docs] [issue35105] Document that CPython accepts "invalid"
 identifiers
In-Reply-To: <1540815891.13.0.788709270274.issue35105@psf.upfronthosting.co.za>
Message-ID: <1541017337.05.0.702299269573.issue35105@psf.upfronthosting.co.za>


Change by Pablo Galindo Salgado <pablogsal at gmail.com>:


----------
nosy: +pablogsal

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35105>
_______________________________________

From report at bugs.python.org  Wed Oct 31 16:25:46 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Wed, 31 Oct 2018 20:25:46 +0000
Subject: [docs] [issue35126] Mistake in FAQ about converting number to
 string.
In-Reply-To: <1541005659.07.0.788709270274.issue35126@psf.upfronthosting.co.za>
Message-ID: <1541017546.68.0.788709270274.issue35126@psf.upfronthosting.co.za>


Pablo Galindo Salgado <pablogsal at gmail.com> added the comment:

Yep, this is incorrect in Python 2 unless `from __future__ import division` is imported at the beginning. Would you want to make a PR against the 2.7 branch to correct this?

----------
nosy: +pablogsal

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35126>
_______________________________________

From report at bugs.python.org  Wed Oct 31 18:33:23 2018
From: report at bugs.python.org (Ivan Levkivskyi)
Date: Wed, 31 Oct 2018 22:33:23 +0000
Subject: [docs] [issue35119] Customizing module attribute access example
 raises RecursionError
In-Reply-To: <1540959974.35.0.788709270274.issue35119@psf.upfronthosting.co.za>
Message-ID: <1541025203.13.0.788709270274.issue35119@psf.upfronthosting.co.za>


Ivan Levkivskyi <levkivskyi at gmail.com> added the comment:

Yes, this is expected, you should use ``super().__setattr__()``.

----------
resolution:  -> not a bug
stage:  -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35119>
_______________________________________

From report at bugs.python.org  Wed Oct 31 21:49:13 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Thu, 01 Nov 2018 01:49:13 +0000
Subject: [docs] [issue32804] urllib.retrieve documentation doesn't mention
 context parameter
In-Reply-To: <1518140001.56.0.467229070634.issue32804@psf.upfronthosting.co.za>
Message-ID: <1541036953.23.0.788709270274.issue32804@psf.upfronthosting.co.za>


Xiang Zhang <angwerzx at 126.com> added the comment:


New changeset aa39c1ab6de6d3fb0204741efdde9b7eed25b093 by Xiang Zhang (Lysandros Nikolaou) in branch '2.7':
[2.7] bpo-32804: Include the context parameter in urlretrieve documentation (GH-10203)
https://github.com/python/cpython/commit/aa39c1ab6de6d3fb0204741efdde9b7eed25b093


----------
nosy: +xiang.zhang

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32804>
_______________________________________

From report at bugs.python.org  Wed Oct 31 21:49:45 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Thu, 01 Nov 2018 01:49:45 +0000
Subject: [docs] [issue32804] urllib.retrieve documentation doesn't mention
 context parameter
In-Reply-To: <1518140001.56.0.467229070634.issue32804@psf.upfronthosting.co.za>
Message-ID: <1541036985.48.0.702299269573.issue32804@psf.upfronthosting.co.za>


Change by Xiang Zhang <angwerzx at 126.com>:


----------
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue32804>
_______________________________________

From report at bugs.python.org  Wed Oct 31 22:06:58 2018
From: report at bugs.python.org (orlnub123)
Date: Thu, 01 Nov 2018 02:06:58 +0000
Subject: [docs] [issue35105] Document that CPython accepts "invalid"
 identifiers
In-Reply-To: <1540815891.13.0.788709270274.issue35105@psf.upfronthosting.co.za>
Message-ID: <1541038018.41.0.788709270274.issue35105@psf.upfronthosting.co.za>


orlnub123 <orlnub123 at gmail.com> added the comment:

I'd argue that it's an implementation detail. Documenting it might be nice as some projects such as pytest do use it but I don't think it would make sense in setattr() or getattr() since all they do (at least in this case) is assign/retrieve from the __dict__. One thing to note is that __slots__ doesn't accept them.

----------
nosy: +orlnub123

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35105>
_______________________________________

From report at bugs.python.org  Wed Oct 31 22:42:41 2018
From: report at bugs.python.org (STINNER Victor)
Date: Thu, 01 Nov 2018 02:42:41 +0000
Subject: [docs] [issue35105] Document that CPython accepts "invalid"
 identifiers
In-Reply-To: <1540815891.13.0.788709270274.issue35105@psf.upfronthosting.co.za>
Message-ID: <1541040161.62.0.788709270274.issue35105@psf.upfronthosting.co.za>


STINNER Victor <vstinner at redhat.com> added the comment:

> I'd argue that it's an implementation detail. Documenting it might be nice as some projects such as pytest do use it but I don't think it would make sense in setattr() or getattr() since all they do (at least in this case) is assign/retrieve from the __dict__. One thing to note is that __slots__ doesn't accept them.

Maybe it's obvious to you, but the question is asked again and again, at least once per year. So it seems like we need to document it somewhere.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35105>
_______________________________________

From report at bugs.python.org  Wed Oct 31 22:45:14 2018
From: report at bugs.python.org (Windson Yang)
Date: Thu, 01 Nov 2018 02:45:14 +0000
Subject: [docs] [issue35105] Document that CPython accepts "invalid"
 identifiers
In-Reply-To: <1540815891.13.0.788709270274.issue35105@psf.upfronthosting.co.za>
Message-ID: <1541040314.68.0.788709270274.issue35105@psf.upfronthosting.co.za>


Windson Yang <wiwindson at gmail.com> added the comment:

I agreed we should document it, it' not obvious to me at least.

----------
nosy: +Windson Yang

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35105>
_______________________________________

From report at bugs.python.org  Wed Oct 31 23:19:54 2018
From: report at bugs.python.org (orlnub123)
Date: Thu, 01 Nov 2018 03:19:54 +0000
Subject: [docs] [issue35105] Document that CPython accepts "invalid"
 identifiers
In-Reply-To: <1540815891.13.0.788709270274.issue35105@psf.upfronthosting.co.za>
Message-ID: <1541042394.03.0.788709270274.issue35105@psf.upfronthosting.co.za>


orlnub123 <orlnub123 at gmail.com> added the comment:

The customizing attribute access section of the data model might be a suitable place.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<https://bugs.python.org/issue35105>
_______________________________________

From Lauren.Ko at unt.edu  Thu Oct 25 15:02:40 2018
From: Lauren.Ko at unt.edu (Ko, Lauren)
Date: Thu, 25 Oct 2018 19:02:40 +0000
Subject: [docs] [EXT] Re:  Downloading Python documentation
In-Reply-To: <CAKJDb-Ow_JVf+gE+wt2T_N55TjLOYZATY3kTOm9KDgKAfvEzUg@mail.gmail.com>
References: <CY4PR0101MB2950DC916E8259C9D5731646E4F70@CY4PR0101MB2950.prod.exchangelabs.com>,
 <CAKJDb-Ow_JVf+gE+wt2T_N55TjLOYZATY3kTOm9KDgKAfvEzUg@mail.gmail.com>
Message-ID: <CY4PR0101MB29501C869B4C901C2D7060DDE4F70@CY4PR0101MB2950.prod.exchangelabs.com>

Thank you!

________________________________
From: Zachary Ware <zachary.ware+pydocs at gmail.com>
Sent: Thursday, October 25, 2018 11:52:31 AM
To: docs
Cc: Ko, Lauren
Subject: [EXT] Re: [docs] Downloading Python documentation

Hi Lauren,

On Thu, Oct 25, 2018 at 11:39 AM Ko, Lauren <Lauren.Ko at unt.edu> wrote:
> When I try to download the pdf versions of the Python 2 documentation at https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fdocs.python.org%2F2%2Fdownload.html&amp;data=02%7C01%7CLauren.Ko%40unt.edu%7C0caa296c4cb2409959e008d63a9a486e%7C70de199207c6480fa318a1afcba03983%7C0%7C0%7C636760831646222766&amp;sdata=d7vjKFQmJy18hBOT9GvnDmrE7gqAfzuHs%2BaYF4yOQVY%3D&amp;reserved=0, I get a 403 forbidden error.

Thanks for the report!  This should now be fixed.

--
Zach
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181025/48d988ce/attachment-0001.html>

From jjwong0915 at gmail.com  Tue Oct 30 00:15:50 2018
From: jjwong0915 at gmail.com (=?UTF-8?B?6buD5omN5bGV?=)
Date: Tue, 30 Oct 2018 12:15:50 +0800
Subject: [docs] Python Document EPUB version problem
Message-ID: <CAOGSfKX8z40ahfvS2OCz3sWT4MkRR4Ppj8K4=Xvu2JCUosGZqQ@mail.gmail.com>

Hello, I'm new to learning python and the tutorial on docs.python.org looks
good for beginners. I downloaded the epub format on
https://docs.python.org/3/download.html and opened with my reader on phone.
However, all my epub reader reported that the epub file was broken. I've
checked the file with online epub validator and here is the result.
[image: image.png]
Please fix the error, or the epub file cannot be used. Thanks for your time
reading this mail.

J.J. Wong
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181030/d7d738d0/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image.png
Type: image/png
Size: 153223 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20181030/d7d738d0/attachment-0001.png>