From report at bugs.python.org  Sat Dec  1 21:59:24 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Sun, 02 Dec 2018 02:59:24 +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: <1543719564.18.0.788709270274.issue34172@psf.upfronthosting.co.za>


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

multiprocessing.Pool.imap hangs in MacOs after applying this commit:

import multiprocessing

def the_test():
    print("Begin")
    for x in multiprocessing.Pool().imap(int,
            ["4", "3"]):
        print(x)
    print("End")

the_test()

This also happens in the backported branches.

----------
nosy: +pablogsal
status: closed -> open

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

From report at bugs.python.org  Sat Dec  1 22:01:15 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Sun, 02 Dec 2018 03:01:15 +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: <1543719675.2.0.788709270274.issue34172@psf.upfronthosting.co.za>


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

Bisecting between 3.7.0(good) and 3.7.1(bad) with the code in my previous commit points to:

97f998a4dfd6db6d867f446daa62445d0782bf39 is the first bad commit
commit 97f998a4dfd6db6d867f446daa62445d0782bf39
Author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
Date:   Tue Oct 2 14:17:04 2018 -0700

    bpo-34172: multiprocessing.Pool leaks resources after being deleted (GH-8450) (GH-9676)

    Fix a reference issue inside multiprocessing.Pool that caused the pool to remain alive if it was deleted without being closed or terminated explicitly.
    (cherry picked from commit 97bfe8d3ebb0a54c8798f57555cb4152f9b2e1d0)

    Co-authored-by: tzickel <tzickel at users.noreply.github.com>

:040000 040000 90e0af29e82d0fcc1c1d7e19b3659f9602596e3e d997cfb00c1c44bbd87ce15edfd391203362a1d7 M      Lib
:040000 040000 6aa4273821c2c563ea69370a59284ed48576416f b6d46f14b6bb36cc5ae62b3ca74025c24d683bb5 M      Misc
bisect run success

----------

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

From report at bugs.python.org  Sat Dec  1 22:14:54 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Sun, 02 Dec 2018 03:14:54 +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: <1543720494.03.0.788709270274.issue34172@psf.upfronthosting.co.za>


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

This also happens on Linux, hanging in different moments:

? ./python test.py
Begin
4
[hangs]

? ./python test.py
Begin
4
3
[hangs]

? ./python test.py
[hangs]

----------

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

From report at bugs.python.org  Sun Dec  2 00:37:15 2018
From: report at bugs.python.org (Ma Lin)
Date: Sun, 02 Dec 2018 05:37:15 +0000
Subject: [docs] [issue35228] Index search in CHM help crashes viewer
In-Reply-To: <1542107217.87.0.788709270274.issue35228@psf.upfronthosting.co.za>
Message-ID: <1543729035.52.0.788709270274.issue35228@psf.upfronthosting.co.za>


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

I suffered this problem more than one years.
Here is a solution, before compiling the chm, modify like this:

--- D:\Python-3.7.1\Doc\build\htmlhelp\python371.hhp	Sun Dec 02 13:12:37 2018
+++ D:\fix_crash\python371.hhp	Sun Dec 02 13:05:57 2018
@@ -1,6 +1,6 @@
 [OPTIONS]
 Binary TOC=No
-Binary Index=No
+Binary Index=Yes
 Compiled file=python371.chm
 Contents file=python371.hhc
 Default Window=python371
 
The chm will generate a binary file python371.chw in the same folder when first opened.
No longer crash, but duplicated entries don't show Title anymore, see the attached picture.

----------
nosy: +Ma Lin
Added file: https://bugs.python.org/file47967/binary_index.png

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

From report at bugs.python.org  Sun Dec  2 02:30:10 2018
From: report at bugs.python.org (tzickel)
Date: Sun, 02 Dec 2018 07:30:10 +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: <1543735810.6.0.788709270274.issue34172@psf.upfronthosting.co.za>


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

A. It would be nice to add a test that tests this.
B. Now that Pool is cleaning up properly, any of it's functions which return another object (like imap's IMapIterator) need to hold a reference to the Pool, so it won't get cleanedup before computing.

----------

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

From report at bugs.python.org  Sun Dec  2 02:49:20 2018
From: report at bugs.python.org (tzickel)
Date: Sun, 02 Dec 2018 07:49:20 +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: <1543736960.24.0.788709270274.issue34172@psf.upfronthosting.co.za>


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

here is something quick I did to check if it works (it works) but I'm not fluent in multiprocessing code, so If i'm missing something or doing something wrong feel free to tell me:

https://github.com/tzickel/cpython/commit/ec63a43706f3bf615ab7ed30fb095607f6101e26

----------

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

From report at bugs.python.org  Sun Dec  2 04:23:30 2018
From: report at bugs.python.org (Christian Ullrich)
Date: Sun, 02 Dec 2018 09:23:30 +0000
Subject: [docs] [issue35228] Index search in CHM help crashes viewer
In-Reply-To: <1542107217.87.0.788709270274.issue35228@psf.upfronthosting.co.za>
Message-ID: <1543742610.01.0.788709270274.issue35228@psf.upfronthosting.co.za>


Christian Ullrich <chris at chrullrich.net> added the comment:

Ma Lin, thanks for the suggestion!

Yes, it looks like this option fixes the problem. I can reproduce the crash at will with a .chm built without this option, and not at all with one that has it on.

If the .chm's directory is not writable, the .chw will be created, and later reused from, %APPDATA%\Microsoft\HTML Help.

Unfortunately, sphinx apparently has no facility for setting this option to Yes in the generated .hhp file, so it will have to be modified before compilation.

----------

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

From report at bugs.python.org  Sun Dec  2 04:42:08 2018
From: report at bugs.python.org (Christian Ullrich)
Date: Sun, 02 Dec 2018 09:42:08 +0000
Subject: [docs] [issue35374] Windows doc build does not find autodetected
 hhc.exe
Message-ID: <1543743728.61.0.788709270274.issue35374@psf.upfronthosting.co.za>


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

If hhc.exe is on the PATH when HTML Help is being built, the build fails because make.bat does not correctly remember the fact. The set command is very finicky with trailing spaces, leading to this:

'"hhc "' is not recognized as an internal or external command,
operable program or batch file.

I suppose the "official" build does not rely on autodetection. In that case, a better fix would be to require setting HTMLHELP explicitly.

PR (for the single-character fix) incoming.

----------
assignee: docs at python
components: Documentation
messages: 330872
nosy: chrullrich, docs at python
priority: normal
severity: normal
status: open
title: Windows doc build does not find autodetected hhc.exe
type: compile error

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

From report at bugs.python.org  Sun Dec  2 04:43:29 2018
From: report at bugs.python.org (Christian Ullrich)
Date: Sun, 02 Dec 2018 09:43:29 +0000
Subject: [docs] [issue35374] Windows doc build does not find autodetected
 hhc.exe
In-Reply-To: <1543743728.61.0.788709270274.issue35374@psf.upfronthosting.co.za>
Message-ID: <1543743809.75.0.702299269573.issue35374@psf.upfronthosting.co.za>


Change by Christian Ullrich <chris at chrullrich.net>:


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

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

From report at bugs.python.org  Sun Dec  2 05:40:49 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Sun, 02 Dec 2018 10:40:49 +0000
Subject: [docs] [issue35374] Windows doc build does not find autodetected
 hhc.exe
In-Reply-To: <1543743728.61.0.788709270274.issue35374@psf.upfronthosting.co.za>
Message-ID: <1543747249.14.0.702299269573.issue35374@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sun Dec  2 07:41:32 2018
From: report at bugs.python.org (Eryk Sun)
Date: Sun, 02 Dec 2018 12:41:32 +0000
Subject: [docs] [issue35374] Windows doc build does not find autodetected
 hhc.exe
In-Reply-To: <1543743728.61.0.788709270274.issue35374@psf.upfronthosting.co.za>
Message-ID: <1543754492.13.0.702299269573.issue35374@psf.upfronthosting.co.za>


Change by Eryk Sun <eryksun at gmail.com>:


----------
nosy: +eryksun

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

From report at bugs.python.org  Sun Dec  2 11:43:47 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Sun, 02 Dec 2018 16:43:47 +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: <1543769027.75.0.788709270274.issue34172@psf.upfronthosting.co.za>


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

As this issue was somehow still present previous to this commit, I am going to track this problem in a new issue:

issue35378

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

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

From report at bugs.python.org  Sun Dec  2 17:06:32 2018
From: report at bugs.python.org (Lysandros Nikolaou)
Date: Sun, 02 Dec 2018 22:06:32 +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: <1543788392.71.0.788709270274.issue30410@psf.upfronthosting.co.za>


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

I updated the PR with the new wording by Paul, since I found it easier to understand as well.

----------

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

From report at bugs.python.org  Sun Dec  2 17:14:30 2018
From: report at bugs.python.org (Lysandros Nikolaou)
Date: Sun, 02 Dec 2018 22:14:30 +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: <1543788870.35.0.788709270274.issue22021@psf.upfronthosting.co.za>


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

Ping.

----------

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

From michaeltsayre at gmail.com  Sun Dec  2 16:50:56 2018
From: michaeltsayre at gmail.com (michaeltsayre at gmail.com)
Date: Sun, 2 Dec 2018 15:50:56 -0600
Subject: [docs] Learning to code
Message-ID: <006501d48a89$1b96d750$52c485f0$@gmail.com>

Greetings,

 

I'm not sure if this is the proper channel to communicate this; so I hope
someone doesn't mind taking the time to read this, forward to whomever might
need to see this, and of course possibly reply. My cause for reaching out is
because I'm left wondering if this
(https://docs.python.org/2/library/index.html) is or isn't the "bible" or
"rulebook" on python usage and if it is; then would it be correct to
consider this source as a technical "textbook" of sorts?

 

As silly as that question might sound; the reason I ask is because I'm
presently enrolled in a Data Analysis and Visualization Coding Bootcamp that
is partnered with the University of Texas - Austin and I don't recall being
formally introduced to this document. In fact, I stumbled across this while
conducting a number of Google searches; trying to locate documentation for
the various functions I've been exposed to at this point.

 

Assuming that I am correct in referring to this document as a python
"textbook"; then I am left with questioning the instructional reliance I've
seen with Googling solutions to issues that resemble a chat forum where one
user files an issue and multiple users respond with solutions/advice. If
it's possible; I'd prefer to learn off of the official documentation before
attempting to interpret solutions from people in forums. 

 

Thank you for your time. I look forward to a response!

 

Very Respectfully,

Michael Sayre


Cell: (682)712-9741

https://www.linkedin.com/in/michaelsayre1/

 

"We have become a nation of employees. We are dependent upon others for our
means of livelihood, and most of our people have become completely dependent
upon wages. If they lose their jobs they lose every resource except for the
relief supplied by the various forms of social security. Such dependence of
the mass of the people upon others for all of their income is something new
in the world. For our generation, the substance of life is in another man's
hands."

 

F. Tannenbaum, A Philosophy of Labor (1951)

 

 

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181202/34050f67/attachment.html>

From report at bugs.python.org  Mon Dec  3 04:42:23 2018
From: report at bugs.python.org (Denton Liu)
Date: Mon, 03 Dec 2018 09:42:23 +0000
Subject: [docs] [issue35155] Clarify Protocol Handlers in urllib.request Docs
In-Reply-To: <1541286673.86.0.788709270274.issue35155@psf.upfronthosting.co.za>
Message-ID: <1543830143.2.0.788709270274.issue35155@psf.upfronthosting.co.za>


Denton Liu <liu.denton at gmail.com> added the comment:

Pinging for updates.

----------

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

From report at bugs.python.org  Mon Dec  3 11:24:54 2018
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 03 Dec 2018 16:24:54 +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: <1543854294.67.0.788709270274.issue34172@psf.upfronthosting.co.za>


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

I suggest to revert this change, since it caused a regression: 
"multiprocessing.Pool.imap hangs in MacOs after applying this commit: (...)"

----------
nosy: +benjamin.peterson, ned.deily, vstinner
priority: normal -> release blocker
resolution: fixed -> 
status: closed -> open

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

From report at bugs.python.org  Mon Dec  3 11:28:50 2018
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 03 Dec 2018 16:28:50 +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: <1543854530.21.0.788709270274.issue34172@psf.upfronthosting.co.za>


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

"""
def the_test():
    print("Begin")
    for x in multiprocessing.Pool().imap(int,
            ["4", "3"]):
        print(x)
    print("End")
"""

Side-note: Is it correct to use a pool without calling terminate() nor close()? Should we start to emit a ResourceWarning if a pool is not closed explicitly, as we did for files, sockets, asyncio event loops and subprocess.Popen objects?

----------

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

From report at bugs.python.org  Mon Dec  3 11:48:29 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Mon, 03 Dec 2018 16:48: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: <1543855709.15.0.788709270274.issue34172@psf.upfronthosting.co.za>


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

V?ctor, I have a PR fixing this in:

issue35378

Even if is not correct to not call close or join on the Pool, this behaviour was working before while now it hangs. The fix is really simple, si I think we should fix it and not revert the change on this case.

----------

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

From report at bugs.python.org  Mon Dec  3 12:31:12 2018
From: report at bugs.python.org (tzickel)
Date: Mon, 03 Dec 2018 17:31:12 +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: <1543858272.87.0.788709270274.issue34172@psf.upfronthosting.co.za>


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

The previous posts here touch all this subjects:
A. The documentation explicitly says: "When the pool object is garbage collected terminate() will be called immediately." (Happened till a code refactor 9 years ago introduced this bug).

B. Large amount of code was developed for this technique:
https://github.com/python/cpython/blob/master/Lib/multiprocessing/util.py#L147 (Till the end of the file almost)

C. The reason I opened this bug was because I was called to see why a long running process crashes after a while, and found out it leaked tons of subprocesses / pool._cache memory.

D. The quoted code, will currently simply leak each invocation lots of subprocesses... 

I too, think we should push for the said fix.

----------

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

From report at bugs.python.org  Mon Dec  3 14:39:20 2018
From: report at bugs.python.org (Filip Bengtsson)
Date: Mon, 03 Dec 2018 19:39:20 +0000
Subject: [docs] [issue35393] Typo in documentation
Message-ID: <1543865960.77.0.788709270274.issue35393@psf.upfronthosting.co.za>


New submission from Filip Bengtsson <filipbengtsson at live.se>:

There are 256 characters in the range 0?255.

----------
assignee: docs at python
components: Documentation
messages: 330975
nosy: autom, docs at python
priority: normal
pull_requests: 10114
severity: normal
status: open
title: Typo in documentation

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

From report at bugs.python.org  Mon Dec  3 15:20:09 2018
From: report at bugs.python.org (Eric V. Smith)
Date: Mon, 03 Dec 2018 20:20:09 +0000
Subject: [docs] [issue35393] Typo in documentation
In-Reply-To: <1543865960.77.0.788709270274.issue35393@psf.upfronthosting.co.za>
Message-ID: <1543868409.71.0.788709270274.issue35393@psf.upfronthosting.co.za>


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

Can you be more specific? There's not enough information here to take any action.

----------
nosy: +eric.smith

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

From report at bugs.python.org  Mon Dec  3 15:30:25 2018
From: report at bugs.python.org (Filip Bengtsson)
Date: Mon, 03 Dec 2018 20:30:25 +0000
Subject: [docs] [issue35393] Typo in documentation
In-Reply-To: <1543865960.77.0.788709270274.issue35393@psf.upfronthosting.co.za>
Message-ID: <1543869025.15.0.788709270274.issue35393@psf.upfronthosting.co.za>


Filip Bengtsson <filipbengtsson at live.se> added the comment:

https://github.com/python/cpython/pull/10876/commits/00f39c15a13377f3920c72267b2b78a043d9b8ab

----------

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

From report at bugs.python.org  Mon Dec  3 17:29:53 2018
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 03 Dec 2018 22:29:53 +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: <1543876193.27.0.788709270274.issue34172@psf.upfronthosting.co.za>


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

tzickel:
> A. The documentation explicitly says: "When the pool object is garbage collected terminate() will be called immediately." (Happened till a code refactor 9 years ago introduced this bug).

It is a *very bad* practice to rely on __del__. Don't do that. That's why we introduced ResourceWarning.


tzickel:
> https://github.com/python/cpython/blob/master/Lib/multiprocessing/util.py#L147 (Till the end of the file almost)

Is this API *incompatible* with pool.close()? Explicitly release resources?


Pablo:
> V?ctor, I have a PR fixing this in: (...) The fix is really simple, so I think we should fix it and not revert the change on this case.

I'm not comfortable with the fix. I cannot explain why but I feel like adding a strong dependency from a child to its parent is going to lead to more bugs, not less. It sounds like a recipe for reference cycles. Maybe I'm just plain wrong.

At this point, I would like that someone explains me what the problem is. https://github.com/python/cpython/pull/10852 is a solution, ok, but what is the problem? What does the code hangs, whereas previously it was fine? Is the example code really correct? Do we want to support such usage?

I understand that msg330864 rely on black magic to expect that it's going to be fine. The lifetime of the pool is implicit and it sounds like a bad design. I don't want to endorse that.

----------

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

From report at bugs.python.org  Mon Dec  3 17:30:52 2018
From: report at bugs.python.org (Naglis)
Date: Mon, 03 Dec 2018 22:30:52 +0000
Subject: [docs] [issue35395] Typo in asyncio eventloop documentation
Message-ID: <1543876252.15.0.788709270274.issue35395@psf.upfronthosting.co.za>


New submission from Naglis <naglis at mailbox.org>:

loop.add_writer and loop.add_signal_handler have *callback* in their signatures, but in their documentation regarding functools.partial usage the function is referred to as *func*.

----------
assignee: docs at python
components: Documentation
messages: 330989
nosy: docs at python, naglis
priority: normal
severity: normal
status: open
title: Typo in asyncio eventloop documentation

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

From report at bugs.python.org  Mon Dec  3 17:33:12 2018
From: report at bugs.python.org (Naglis)
Date: Mon, 03 Dec 2018 22:33:12 +0000
Subject: [docs] [issue35395] Typo in asyncio eventloop documentation
In-Reply-To: <1543876252.15.0.788709270274.issue35395@psf.upfronthosting.co.za>
Message-ID: <1543876392.56.0.702299269573.issue35395@psf.upfronthosting.co.za>


Change by Naglis <naglis at mailbox.org>:


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

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

From report at bugs.python.org  Mon Dec  3 17:36:17 2018
From: report at bugs.python.org (Andrew Svetlov)
Date: Mon, 03 Dec 2018 22:36:17 +0000
Subject: [docs] [issue35395] Typo in asyncio eventloop documentation
In-Reply-To: <1543876252.15.0.788709270274.issue35395@psf.upfronthosting.co.za>
Message-ID: <1543876577.1.0.788709270274.issue35395@psf.upfronthosting.co.za>


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

Would you create a PR with a fix?

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

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

From report at bugs.python.org  Mon Dec  3 17:36:51 2018
From: report at bugs.python.org (Andrew Svetlov)
Date: Mon, 03 Dec 2018 22:36:51 +0000
Subject: [docs] [issue35395] Typo in asyncio eventloop documentation
In-Reply-To: <1543876252.15.0.788709270274.issue35395@psf.upfronthosting.co.za>
Message-ID: <1543876611.61.0.788709270274.issue35395@psf.upfronthosting.co.za>


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

Sorry, you did already

----------

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

From report at bugs.python.org  Mon Dec  3 17:59:08 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Mon, 03 Dec 2018 22:59:08 +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: <1543877948.22.0.788709270274.issue34172@psf.upfronthosting.co.za>


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

> I'm not comfortable with the fix. I cannot explain why but I feel like adding a strong dependency from a child to its parent is going to lead to more bugs, not less. It sounds like a recipe for reference cycles. Maybe I'm just plain wrong.

The pool child objects (imap iterators, async results...etc) need to keep a reference to the parent because if not, the caller is in charge of doing that and that may lead to bugs. Is the same scenario as if I get a dictionary iterator and then I destroy my reference to the dictionary: if the iterator does not keep a reference to the parent (the dictionary) it will not be possible to be used in the future. Indeed, we can see that this is what happens:

I'm not comfortable with the fix. I cannot explain why but I feel like adding a strong dependency from a child to its parent is going to lead to more bugs, not less. It sounds like a recipe for reference cycles. Maybe I'm just plain wrong.

>>> x = {1:2}
>>> y = iter(x)
>>> gc.get_referrents(x)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
AttributeError: module 'gc' has no attribute 'get_referrents'
>>> gc.get_referrers(x)
[<dict_keyiterator object at 0x0000024447D6D598>, 
{'__name__': '__main__', '__doc__': None, '__package__': None, '__loader__': <class '_frozen_importlib.BuiltinImporter'>, '__spec__': None, '__annotations__': {}, '__builtins__': <module 'builtins' (built-in)>, 'y': <dict_keyiterator object at 0x0000024447D6D598>, 'gc': <module 'gc' (built-in)>, 'x': {1: 2}}
]

We can see that the dict_keyiterator refers to the dictionary, keeping it alive.

Here we have the same situation: if we do not keep the pool alive, the iterator will hang when iterating because the jobs won't get finished.

>At this point, I would like that someone explains to me what the problem is. https://github.com/python/cpython/pull/10852 is a solution, ok, but what is the problem? What does the code hangs, whereas >previously it was fine? Is the example code really correct? Do we want to support such usage?

The code hangs because the pool was not being destroyed before due to the reference cycle between the pool and an internal object (a Thread). Now it hangs because the worker thread is destroyed with the pool as no references are kept to it and the job that the iterator is waiting on is never finished.

>I understand that msg330864 rely on black magic to expect that it's going to be fine. The lifetime of the pool is implicit and it sounds like a bad design. I don't want to endorse that.

I found the weird code in the example in several projects. I have corrected it to use the pool as a context manager or to call close(), but this means that users are doing this and it used to work and not it does not: technically is a regression.

----------

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

From report at bugs.python.org  Mon Dec  3 17:59:45 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Mon, 03 Dec 2018 22:59: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: <1543877985.12.0.702299269573.issue34172@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Mon Dec  3 17:59:57 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Mon, 03 Dec 2018 22:59:57 +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: <1543877997.33.0.788709270274.issue34172@psf.upfronthosting.co.za>


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

> I'm not comfortable with the fix. I cannot explain why but I feel like adding a strong dependency from a child to its parent is going to lead to more bugs, not less. It sounds like a recipe for reference cycles. Maybe I'm just plain wrong.

The pool child objects (imap iterators, async results...etc) need to keep a reference to the parent because if not, the caller is in charge of doing that and that may lead to bugs. Is the same scenario as if I get a dictionary iterator and then I destroy my reference to the dictionary: if the iterator does not keep a reference to the parent (the dictionary) it will not be possible to be used in the future. Indeed, we can see that this is what happens:

>>> x = {1:2}
>>> y = iter(x)
>>> gc.get_referrents(x)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
AttributeError: module 'gc' has no attribute 'get_referrents'
>>> gc.get_referrers(x)
[<dict_keyiterator object at 0x0000024447D6D598>, 
{'__name__': '__main__', '__doc__': None, '__package__': None, '__loader__': <class '_frozen_importlib.BuiltinImporter'>, '__spec__': None, '__annotations__': {}, '__builtins__': <module 'builtins' (built-in)>, 'y': <dict_keyiterator object at 0x0000024447D6D598>, 'gc': <module 'gc' (built-in)>, 'x': {1: 2}}
]

We can see that the dict_keyiterator refers to the dictionary, keeping it alive.

Here we have the same situation: if we do not keep the pool alive, the iterator will hang when iterating because the jobs won't get finished.

>At this point, I would like that someone explains to me what the problem is. https://github.com/python/cpython/pull/10852 is a solution, ok, but what is the problem? What does the code hangs, whereas >previously it was fine? Is the example code really correct? Do we want to support such usage?

The code hangs because the pool was not being destroyed before due to the reference cycle between the pool and an internal object (a Thread). Now it hangs because the worker thread is destroyed with the pool as no references are kept to it and the job that the iterator is waiting on is never finished.

>I understand that msg330864 rely on black magic to expect that it's going to be fine. The lifetime of the pool is implicit and it sounds like a bad design. I don't want to endorse that.

I found the weird code in the example in several projects. I have corrected it to use the pool as a context manager or to call close(), but this means that users are doing this and it used to work and not it does not: technically is a regression.

----------

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

From report at bugs.python.org  Mon Dec  3 18:00:15 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Mon, 03 Dec 2018 23:00:15 +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: <1543878015.75.0.702299269573.issue34172@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Mon Dec  3 18:00:26 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Mon, 03 Dec 2018 23:00:26 +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: <1543878026.48.0.788709270274.issue34172@psf.upfronthosting.co.za>


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

> I'm not comfortable with the fix. I cannot explain why but I feel like adding a strong dependency from a child to its parent is going to lead to more bugs, not less. It sounds like a recipe for reference cycles. Maybe I'm just plain wrong.

The pool child objects (imap iterators, async results...etc) need to keep a reference to the parent because if not, the caller is in charge of doing that and that may lead to bugs. Is the same scenario as if I get a dictionary iterator and then I destroy my reference to the dictionary: if the iterator does not keep a reference to the parent (the dictionary) it will not be possible to be used in the future. Indeed, we can see that this is what happens:

I'm not comfortable with the fix. I cannot explain why but I feel like adding a strong dependency from a child to its parent is going to lead to more bugs, not less. It sounds like a recipe for reference cycles. Maybe I'm just plain wrong.

>>> x = {1:2}
>>> y = iter(x)
>>> gc.get_referrers(x)
[<dict_keyiterator object at 0x0000024447D6D598>, 
{'__name__': '__main__', '__doc__': None, '__package__': None, '__loader__': <class '_frozen_importlib.BuiltinImporter'>, '__spec__': None, '__annotations__': {}, '__builtins__': <module 'builtins' (built-in)>, 'y': <dict_keyiterator object at 0x0000024447D6D598>, 'gc': <module 'gc' (built-in)>, 'x': {1: 2}}
]

We can see that the dict_keyiterator refers to the dictionary, keeping it alive.

Here we have the same situation: if we do not keep the pool alive, the iterator will hang when iterating because the jobs won't get finished.

>At this point, I would like that someone explains to me what the problem is. https://github.com/python/cpython/pull/10852 is a solution, ok, but what is the problem? What does the code hangs, whereas >previously it was fine? Is the example code really correct? Do we want to support such usage?

The code hangs because the pool was not being destroyed before due to the reference cycle between the pool and an internal object (a Thread). Now it hangs because the worker thread is destroyed with the pool as no references are kept to it and the job that the iterator is waiting on is never finished.

>I understand that msg330864 rely on black magic to expect that it's going to be fine. The lifetime of the pool is implicit and it sounds like a bad design. I don't want to endorse that.

I found the weird code in the example in several projects. I have corrected it to use the pool as a context manager or to call close(), but this means that users are doing this and it used to work and not it does not: technically is a regression.

----------

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

From report at bugs.python.org  Mon Dec  3 18:07:58 2018
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 03 Dec 2018 23:07: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: <1543878478.86.0.788709270274.issue34172@psf.upfronthosting.co.za>


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

> I found the weird code in the example in several projects. I have corrected it to use the pool as a context manager or to call close(), but this means that users are doing this and it used to work and not it does not: technically is a regression.

That's why I'm asking for a revert :-) I suggest to revert this change immediately from 2.7, 3.6 and 3.7, and later see what can be done for master.

Even if we design carefully an API, there will be always someone to misuse it :-) I would prefer to stop promoting such bad code and find a transition to more correct code.

I disagree that a child should keep its parent alive.

I would be ok to use a *weak reference* from the child to the parent to detect when the parent goes away, and maybe trigger an action in that case. For example, raise an exception or log a warning.

----------

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

From report at bugs.python.org  Mon Dec  3 18:11:42 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Mon, 03 Dec 2018 23:11: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: <1543878702.44.0.788709270274.issue34172@psf.upfronthosting.co.za>


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

> I disagree that a child should keep its parent alive.

But this is normal across the standard library. For example, here is how a deque iterator keeps the deque alive:

>>> x = deque([1,2,3])
>>> deque_iter = iter(x)
>>> deque_weakref = weakref.ref(x)
>>> del x
>>> gc.collect()
>>> gc.get_referrers(deque_weakref())
[<_collections._deque_iterator object at 0x0000024447ED6EA8>]

Here, the deque iterator is the *only* reference to the deque. When we destroy it, the deque is destroyed:
>>> del deque_iter
>>> gc.collect()
>>> deque_weakref()
None

----------

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

From report at bugs.python.org  Tue Dec  4 01:53:19 2018
From: report at bugs.python.org (tzickel)
Date: Tue, 04 Dec 2018 06:53:19 +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: <1543906399.28.0.788709270274.issue34172@psf.upfronthosting.co.za>


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

Reverting the code will cause another class of problems, like the reason I fixed it. Programs written such as the example that Pablo gave (and what I've seen) will quietly leak child processes, file descriptors (for the pipes) and memory to a variety degree might not be detected, or in the end detected in a big error or crash.

Also in some ResourceWarnings (if not all), the resources are closed in the end (like in sockets), here without this code patch you cannot implicitly reclaim the resources (because there is a Thread involved here), which I think is a high bar for the user to think about.

You can also enable multiprocessing's debug logging to see how the code behaves with and without the fix:
https://stackoverflow.com/a/1353037

I also agree with Pablo that there is code in the stdlib that holdes reference between child and parent. There is also code that has circular reference (for example Python 2's OrderedDict) and that is ok as well (not that this is the situation here).

----------

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

From report at bugs.python.org  Tue Dec  4 02:31:20 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 04 Dec 2018 07:31:20 +0000
Subject: [docs] [issue35395] Typo in asyncio eventloop documentation
In-Reply-To: <1543876252.15.0.788709270274.issue35395@psf.upfronthosting.co.za>
Message-ID: <1543908680.04.0.788709270274.issue35395@psf.upfronthosting.co.za>


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


New changeset 17473347942353946fe455f797a2197cb89c1090 by Miss Islington (bot) (Naglis) in branch 'master':
bpo-35395: fix typos in asyncio eventloop documentation (GH-10880)
https://github.com/python/cpython/commit/17473347942353946fe455f797a2197cb89c1090


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

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

From report at bugs.python.org  Tue Dec  4 02:31:29 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 04 Dec 2018 07:31:29 +0000
Subject: [docs] [issue35395] Typo in asyncio eventloop documentation
In-Reply-To: <1543876252.15.0.788709270274.issue35395@psf.upfronthosting.co.za>
Message-ID: <1543908689.67.0.702299269573.issue35395@psf.upfronthosting.co.za>


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


----------
pull_requests: +10123

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

From report at bugs.python.org  Tue Dec  4 02:36:34 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 04 Dec 2018 07:36:34 +0000
Subject: [docs] [issue35395] Typo in asyncio eventloop documentation
In-Reply-To: <1543876252.15.0.788709270274.issue35395@psf.upfronthosting.co.za>
Message-ID: <1543908994.14.0.788709270274.issue35395@psf.upfronthosting.co.za>


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


New changeset 6627d3ae1e151095fda4ec2592c7cfb759f23669 by Miss Islington (bot) in branch '3.7':
bpo-35395: fix typos in asyncio eventloop documentation (GH-10880)
https://github.com/python/cpython/commit/6627d3ae1e151095fda4ec2592c7cfb759f23669


----------

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

From report at bugs.python.org  Tue Dec  4 04:01:35 2018
From: report at bugs.python.org (Charles-Axel Dein)
Date: Tue, 04 Dec 2018 09:01:35 +0000
Subject: [docs] [issue35404] Document how to import _structure in
 email.message
Message-ID: <1543914095.32.0.788709270274.issue35404@psf.upfronthosting.co.za>


New submission from Charles-Axel Dein <charlesaxel.dein at gmail.com>:

The example for `walk()` in `email.message.EmailMessage` makes use of the `_structure` function but does not clarify how to import it.

I can make a patch adding a line:

  from email.iterators import _structure

----------
assignee: docs at python
components: Documentation
messages: 331018
nosy: charlax, docs at python
priority: normal
severity: normal
status: open
title: Document how to import _structure in email.message
type: enhancement
versions: Python 3.7

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

From report at bugs.python.org  Tue Dec  4 04:02:59 2018
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 04 Dec 2018 09:02:59 +0000
Subject: [docs] [issue35404] Document how to import _structure in
 email.message
In-Reply-To: <1543914095.32.0.788709270274.issue35404@psf.upfronthosting.co.za>
Message-ID: <1543914179.25.0.702299269573.issue35404@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Tue Dec  4 04:10:33 2018
From: report at bugs.python.org (Andrew Svetlov)
Date: Tue, 04 Dec 2018 09:10:33 +0000
Subject: [docs] [issue35395] Typo in asyncio eventloop documentation
In-Reply-To: <1543876252.15.0.788709270274.issue35395@psf.upfronthosting.co.za>
Message-ID: <1543914633.14.0.788709270274.issue35395@psf.upfronthosting.co.za>


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

Thanks Naglis

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

From report at bugs.python.org  Tue Dec  4 05:32:43 2018
From: report at bugs.python.org (Pablo Galindo Salgado)
Date: Tue, 04 Dec 2018 10:32: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: <1543919563.34.0.788709270274.issue34172@psf.upfronthosting.co.za>


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

> that there is code in the stdlib that holdes reference between child and parent

Just to clarify: is not that is just code in the stdlib that keeps a reference between child and parent. The examples I have given are the exact same situation that we have here: the iterator object associated with another needs to keep its parent alive to work correctly.

----------

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

From report at bugs.python.org  Tue Dec  4 20:37:36 2018
From: report at bugs.python.org (STINNER Victor)
Date: Wed, 05 Dec 2018 01:37:36 +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: <1543973856.01.0.788709270274.issue34172@psf.upfronthosting.co.za>


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

multiprocessing should help the developer to detect when the API is misused. For example, emit a ResourceWarning if a pool is not released explicitly. It might help to detect such bugs:

* bpo-33676
* bpo-35413

----------

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

From report at bugs.python.org  Wed Dec  5 14:16:39 2018
From: report at bugs.python.org (mattip)
Date: Wed, 05 Dec 2018 19:16:39 +0000
Subject: [docs] [issue35420] how to migrate a c-extension module to one that
 supports subinerpreters?
Message-ID: <1544037399.3.0.788709270274.issue35420@psf.upfronthosting.co.za>


New submission from mattip <matti.picus at gmail.com>:

NumPy does not currently support subinterpreters, it has global state that is not cleaned up when releasing the module. I could not find a description of the steps I need to take to modernize the C-extension module to be able to used under a subinterpreter. It would be nice to describe this in the Python documentation, or does such documentation exist?

----------
assignee: docs at python
components: Documentation
messages: 331142
nosy: docs at python, eric.snow, mattip
priority: normal
severity: normal
status: open
title: how to migrate a c-extension module to one that supports subinerpreters?
type: enhancement

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

From report at bugs.python.org  Wed Dec  5 14:55:48 2018
From: report at bugs.python.org (Eric Snow)
Date: Wed, 05 Dec 2018 19:55:48 +0000
Subject: [docs] [issue35420] how to migrate a c-extension module to one that
 supports subinerpreters?
In-Reply-To: <1544037399.3.0.788709270274.issue35420@psf.upfronthosting.co.za>
Message-ID: <1544039748.8.0.702299269573.issue35420@psf.upfronthosting.co.za>


Change by Eric Snow <ericsnowcurrently at gmail.com>:


----------
nosy: +petr.viktorin

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

From report at bugs.python.org  Wed Dec  5 15:00:56 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 05 Dec 2018 20:00:56 +0000
Subject: [docs] [issue35250] Minor parameter documentation mismatch for
 turtle
In-Reply-To: <1542228045.84.0.788709270274.issue35250@psf.upfronthosting.co.za>
Message-ID: <1544040056.76.0.702299269573.issue35250@psf.upfronthosting.co.za>


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


----------
pull_requests: +10195

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

From report at bugs.python.org  Wed Dec  5 16:10:38 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 05 Dec 2018 21:10:38 +0000
Subject: [docs] [issue35250] Minor parameter documentation mismatch for
 turtle
In-Reply-To: <1542228045.84.0.788709270274.issue35250@psf.upfronthosting.co.za>
Message-ID: <1544044238.53.0.788709270274.issue35250@psf.upfronthosting.co.za>


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


New changeset abe74feb912292aa4df4e70d39e85d0bcd425436 by Serhiy Storchaka in branch '2.7':
[2.7] bpo-35250: Correct argument name "num" -> "btn" in turtle docs. (GH-10565). (GH-10943)
https://github.com/python/cpython/commit/abe74feb912292aa4df4e70d39e85d0bcd425436


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

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

From report at bugs.python.org  Wed Dec  5 16:14:51 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 05 Dec 2018 21:14:51 +0000
Subject: [docs] [issue35250] Minor parameter documentation mismatch for
 turtle
In-Reply-To: <1542228045.84.0.788709270274.issue35250@psf.upfronthosting.co.za>
Message-ID: <1544044491.28.0.702299269573.issue35250@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/issue35250>
_______________________________________

From yinon.me at gmail.com  Wed Dec  5 04:53:53 2018
From: yinon.me at gmail.com (Yinon Ehrlich)
Date: Wed, 5 Dec 2018 11:53:53 +0200
Subject: [docs] Typo and comment for subprocess documentation
Message-ID: <CAGE=tZEakpgLa1pQZptCPmmh2Ec+UQ5gE2d+-0mNFv5mbjx8AA@mail.gmail.com>

Hi,

Please have a look at the following 2 tiny pull requests for subprocess
documentation at https://github.com/Tiksagol/cpython/pulls

Thanks,
   Yinon
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181205/940f42e7/attachment.html>

From mariatta at python.org  Wed Dec  5 18:08:47 2018
From: mariatta at python.org (Mariatta Wijaya)
Date: Wed, 5 Dec 2018 15:08:47 -0800
Subject: [docs] Typo and comment for subprocess documentation
In-Reply-To: <CAGE=tZEakpgLa1pQZptCPmmh2Ec+UQ5gE2d+-0mNFv5mbjx8AA@mail.gmail.com>
References: <CAGE=tZEakpgLa1pQZptCPmmh2Ec+UQ5gE2d+-0mNFv5mbjx8AA@mail.gmail.com>
Message-ID: <CAGbohnb+NdSMsook5DQn06E-vCfE9NodaBZ6cmF7hgZ9Z63ETg@mail.gmail.com>

Hi, please open the pull requests against python/cpython instead of your
own fork.

Thanks.
?

On Wed, Dec 5, 2018 at 2:48 PM Yinon Ehrlich <yinon.me at gmail.com> wrote:

> Hi,
>
> Please have a look at the following 2 tiny pull requests for subprocess
> documentation at https://github.com/Tiksagol/cpython/pulls
>
> Thanks,
>    Yinon
> _______________________________________________
> docs mailing list
> docs at python.org
> https://mail.python.org/mailman/listinfo/docs
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181205/83803302/attachment-0001.html>

From report at bugs.python.org  Wed Dec  5 18:09:05 2018
From: report at bugs.python.org (STINNER Victor)
Date: Wed, 05 Dec 2018 23:09:05 +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: <1544051345.9.0.788709270274.issue34172@psf.upfronthosting.co.za>


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

Another example of complex issue related to object lifetime, resources (file descriptors) and multiprocessing: bpo-30966, add SimpleQueue.close().

----------

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

From report at bugs.python.org  Wed Dec  5 18:23:30 2018
From: report at bugs.python.org (STINNER Victor)
Date: Wed, 05 Dec 2018 23:23:30 +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: <1544052210.43.0.702299269573.issue34172@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Wed Dec  5 18:25:23 2018
From: report at bugs.python.org (STINNER Victor)
Date: Wed, 05 Dec 2018 23:25:23 +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: <1544052323.78.0.702299269573.issue34172@psf.upfronthosting.co.za>


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


----------
pull_requests: +10211

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

From report at bugs.python.org  Wed Dec  5 18:39:16 2018
From: report at bugs.python.org (STINNER Victor)
Date: Wed, 05 Dec 2018 23:39:16 +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: <1544053156.22.0.702299269573.issue34172@psf.upfronthosting.co.za>


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


----------
pull_requests: +10212

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

From report at bugs.python.org  Wed Dec  5 18:41:43 2018
From: report at bugs.python.org (STINNER Victor)
Date: Wed, 05 Dec 2018 23:41: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: <1544053303.46.0.702299269573.issue34172@psf.upfronthosting.co.za>


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


----------
pull_requests: +10213

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

From report at bugs.python.org  Wed Dec  5 19:47:37 2018
From: report at bugs.python.org (Jeremy Kloth)
Date: Thu, 06 Dec 2018 00:47:37 +0000
Subject: [docs] [issue35420] how to migrate a c-extension module to one that
 supports subinerpreters?
In-Reply-To: <1544037399.3.0.788709270274.issue35420@psf.upfronthosting.co.za>
Message-ID: <1544057257.61.0.702299269573.issue35420@psf.upfronthosting.co.za>


Change by Jeremy Kloth <jeremy.kloth+python-tracker at gmail.com>:


----------
nosy: +jkloth

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

From report at bugs.python.org  Wed Dec  5 19:49:07 2018
From: report at bugs.python.org (STINNER Victor)
Date: Thu, 06 Dec 2018 00:49:07 +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: <1544057347.89.0.788709270274.issue34172@psf.upfronthosting.co.za>


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


New changeset 3c6b0d967eb4c95e06c4f1beddfca4f6300d92ce by Victor Stinner in branch '3.7':
[3.7] Revert "bpo-34172: multiprocessing.Pool leaks resources after being deleted (GH-8450) (GH-9676)" (#10968)
https://github.com/python/cpython/commit/3c6b0d967eb4c95e06c4f1beddfca4f6300d92ce


----------

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

From report at bugs.python.org  Wed Dec  5 19:49:37 2018
From: report at bugs.python.org (STINNER Victor)
Date: Thu, 06 Dec 2018 00:49:37 +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: <1544057376.98.0.788709270274.issue34172@psf.upfronthosting.co.za>


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


New changeset eb38ee052e2273568d0041e969aa851ee44e43ce by Victor Stinner in branch '3.6':
[3.6] Revert "bpo-34172: multiprocessing.Pool leaks resources after being deleted (GH-8450) (GH-9677)" (GH-10969)
https://github.com/python/cpython/commit/eb38ee052e2273568d0041e969aa851ee44e43ce


----------

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

From report at bugs.python.org  Wed Dec  5 19:49:44 2018
From: report at bugs.python.org (STINNER Victor)
Date: Thu, 06 Dec 2018 00:49:44 +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: <1544057384.0.0.788709270274.issue34172@psf.upfronthosting.co.za>


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


New changeset 358fc87f53cf97a1768d5b1ded08f2a564f9fd85 by Victor Stinner in branch '2.7':
Revert "[2.7] bpo-34172: multiprocessing.Pool leaks resources after being deleted (GH-9686)" (GH-10970)
https://github.com/python/cpython/commit/358fc87f53cf97a1768d5b1ded08f2a564f9fd85


----------

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

From report at bugs.python.org  Thu Dec  6 02:51:53 2018
From: report at bugs.python.org (STINNER Victor)
Date: Thu, 06 Dec 2018 07:51:53 +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: <1544082713.61.0.788709270274.issue34172@psf.upfronthosting.co.za>


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


New changeset 9dfc754d61c55a526304e10a328bad448efa9ee9 by Victor Stinner in branch 'master':
Revert "bpo-34172: multiprocessing.Pool leaks resources after being deleted (GH-8450)" (GH-10971)
https://github.com/python/cpython/commit/9dfc754d61c55a526304e10a328bad448efa9ee9


----------

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

From report at bugs.python.org  Thu Dec  6 04:42:04 2018
From: report at bugs.python.org (STINNER Victor)
Date: Thu, 06 Dec 2018 09:42:04 +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: <1544089324.47.0.788709270274.issue34172@psf.upfronthosting.co.za>


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

I reverted the change in 2.7, 3.6, 3.7 and master branches because it introduces a regression and we are very close to a release:
https://mail.python.org/pipermail/python-dev/2018-December/155920.html

I don't want to have the pressure to push a quick fix. I would like to make sure that we have enough time to design a proper fix. I'm not saying that Pablo's fix is not correct, it's just bad timing.

This bug is likely here for a long time, so I think that it's ok to still have it in the next 3.6 and 3.7 bugfix releases.

I suggest to open a discussion on the python-dev mailing list about multiprocessing relying on the garbage collector and lifetime of multiprocessing objects (Pool, Process, result, etc.). It seems like I disagree with Pablo and tzickel, whereas Armin Rigo (PyPy which has a different GC) is more on my side (release explicitly resources) :-) I would prefer to move towards explicit resource managment instead of relying on destructors and the garbage collector. For example, it's a bad practice to rely on these when using PyPy.

See my previous comments about issues related to multiprocessing objects lifetime.

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

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

From report at bugs.python.org  Thu Dec  6 04:44:08 2018
From: report at bugs.python.org (Antoine Pitrou)
Date: Thu, 06 Dec 2018 09:44:08 +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: <1544089448.13.0.788709270274.issue34172@psf.upfronthosting.co.za>


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

I agree that reverting in bugfix branches was the right thing to do.  I think the fix should have remained in master, though.

----------
stage: patch review -> 
versions:  -Python 2.7, Python 3.6, Python 3.7

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

From report at bugs.python.org  Thu Dec  6 05:29:58 2018
From: report at bugs.python.org (STINNER Victor)
Date: Thu, 06 Dec 2018 10:29: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: <1544092198.04.0.788709270274.issue34172@psf.upfronthosting.co.za>


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

See also bpo-35424: "multiprocessing.Pool: emit ResourceWarning".

I wrote 10986 to fix 2 tests which leak resources.

I have a question. Why do tests have to call "pool.join()" after "with pool:"? When I use a file, I know that the resources are released after "with file:".

Should Pool.__exit__() call Pool.join()?

This question reminds me my fix in socketserver (bpo-31151 and bpo-31233) which leaked processes and threads, and my bug bpo-34037 (asyncio leaks threads).

----------

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

From report at bugs.python.org  Thu Dec  6 23:46:28 2018
From: report at bugs.python.org (Josh Rosenberg)
Date: Fri, 07 Dec 2018 04:46:28 +0000
Subject: [docs] [issue35434] Wrong bpo linked in What's New in 3.8
Message-ID: <1544157988.47.0.788709270274.issue35434@psf.upfronthosting.co.za>


New submission from Josh Rosenberg <shadowranger+python at gmail.com>:

https://docs.python.org/3.8/whatsnew/3.8.html#optimizations begins with:

shutil.copyfile(), shutil.copy(), shutil.copy2(), shutil.copytree() and shutil.move() use platform-specific ?fast-copy? syscalls on Linux, macOS and Solaris in order to copy the file more efficiently. ... more explanation ... (Contributed by Giampaolo Rodola? in bpo-25427.)

That's all correct, except bpo-25427 is about removing the pyvenv script; it should be referencing bpo-33671.

----------
assignee: docs at python
components: Documentation
keywords: easy
messages: 331264
nosy: docs at python, giampaolo.rodola, josh.r
priority: low
severity: normal
status: open
title: Wrong bpo linked in What's New in 3.8
versions: Python 3.8

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

From report at bugs.python.org  Fri Dec  7 00:54:18 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 07 Dec 2018 05:54:18 +0000
Subject: [docs] [issue35434] Wrong bpo linked in What's New in 3.8
In-Reply-To: <1544157988.47.0.788709270274.issue35434@psf.upfronthosting.co.za>
Message-ID: <1544162058.24.0.702299269573.issue35434@psf.upfronthosting.co.za>


Change by Mariatta Wijaya <mariatta at python.org>:


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

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

From report at bugs.python.org  Fri Dec  7 00:55:59 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 07 Dec 2018 05:55:59 +0000
Subject: [docs] [issue35434] Wrong bpo linked in What's New in 3.8
In-Reply-To: <1544157988.47.0.788709270274.issue35434@psf.upfronthosting.co.za>
Message-ID: <1544162159.32.0.788709270274.issue35434@psf.upfronthosting.co.za>


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

Thanks! This has been fixed.

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

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

From report at bugs.python.org  Fri Dec  7 00:59:46 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 07 Dec 2018 05:59:46 +0000
Subject: [docs] [issue35434] Wrong bpo linked in What's New in 3.8
In-Reply-To: <1544157988.47.0.788709270274.issue35434@psf.upfronthosting.co.za>
Message-ID: <1544162386.0.0.788709270274.issue35434@psf.upfronthosting.co.za>


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


New changeset 16501b70826695991b3a151dfc538f010be5c765 by Miss Islington (bot) (Mariatta) in branch 'master':
bpo-35434 Fix wrong issue number in what's new in 3.8 (GH-11012)
https://github.com/python/cpython/commit/16501b70826695991b3a151dfc538f010be5c765


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

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

From report at bugs.python.org  Fri Dec  7 01:30:59 2018
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Fri, 07 Dec 2018 06:30:59 +0000
Subject: [docs] [issue35435] Documentation of 3.3 is available
Message-ID: <1544164258.79.0.788709270274.issue35435@psf.upfronthosting.co.za>


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

Today, I was looking for the doc of unittest.mock and the result from DuckDuckGo was this link: https://docs.python.org/3.3/library/unittest.mock-examples.html

In the devguide, we stopped the support and everything about this version, in the bug tracker, 3.3 is not available.

Maybe we could remove the doc from the server.

----------
assignee: docs at python
components: Documentation
messages: 331271
nosy: docs at python, matrixise, mdk
priority: normal
severity: normal
status: open
title: Documentation of 3.3 is available

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

From report at bugs.python.org  Fri Dec  7 01:43:45 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 07 Dec 2018 06:43:45 +0000
Subject: [docs] [issue35435] Documentation of 3.3 is available
In-Reply-To: <1544164258.79.0.788709270274.issue35435@psf.upfronthosting.co.za>
Message-ID: <1544165025.88.0.788709270274.issue35435@psf.upfronthosting.co.za>


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

It seems like all other versions (3.2, 3.1, 3.0) are still available too, just not updated anymore.

I'm thinking it's ok to leave these documentation.
While we don't support these versions anymore,  they still exists, and they're even still available for download from python.org/downloads. It doesn't hurt to keep these docs.

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

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

From report at bugs.python.org  Fri Dec  7 01:53:21 2018
From: report at bugs.python.org (Steven D'Aprano)
Date: Fri, 07 Dec 2018 06:53:21 +0000
Subject: [docs] [issue35435] Documentation of 3.3 is available
In-Reply-To: <1544164258.79.0.788709270274.issue35435@psf.upfronthosting.co.za>
Message-ID: <1544165601.22.0.788709270274.issue35435@psf.upfronthosting.co.za>


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

Documentation is available for all versions going back to Python 1.4.

https://docs.python.org/release/1.4/

As it should be: I'm surely not the only person who has need to check old versions of the documentation from time to time. Not everyone is using the latest version of Python, and some times we need to write code that supports old versions. Leaving the old docs available is not merely "doesn't hurt", but is positively a GOOD thing to do.

We shouldn't remove the docs from the server, and we shouldn't break existing URLs.

I don't think there's much we can do about search engines: they have their secret algorithms for ranking pages, and whatever comes up is what comes up, and I doubt we can control that.

I expect that the only thing we could do is put a prominent note at the top of each page "This is an unsupported version of the docs, for the latest version see blah blah blah" and link to the most recent version.

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

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

From report at bugs.python.org  Fri Dec  7 03:23:20 2018
From: report at bugs.python.org (Julien Palard)
Date: Fri, 07 Dec 2018 08:23:20 +0000
Subject: [docs] [issue35435] Documentation of 3.3 is available
In-Reply-To: <1544164258.79.0.788709270274.issue35435@psf.upfronthosting.co.za>
Message-ID: <1544171000.03.0.788709270274.issue35435@psf.upfronthosting.co.za>


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

> I expect that the only thing we could do is put a prominent note at the top of each page "This is an unsupported version of the docs, for the latest version see blah blah blah" and link to the most recent version.

I'm +1 on this, and it can even help search engine algorithms to rank the right pages (as receiving more links than the old page).

----------

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

From report at bugs.python.org  Fri Dec  7 07:49:48 2018
From: report at bugs.python.org (Giampaolo Rodola')
Date: Fri, 07 Dec 2018 12:49:48 +0000
Subject: [docs] [issue35434] Wrong bpo linked in What's New in 3.8
In-Reply-To: <1544157988.47.0.788709270274.issue35434@psf.upfronthosting.co.za>
Message-ID: <1544186988.43.0.788709270274.issue35434@psf.upfronthosting.co.za>


Giampaolo Rodola' <g.rodola at gmail.com> added the comment:

My bad. Thanks for fixing it.

----------

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

From report at bugs.python.org  Fri Dec  7 15:07:39 2018
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 07 Dec 2018 20:07:39 +0000
Subject: [docs] [issue35435] Documentation of 3.3 is available
In-Reply-To: <1544164258.79.0.788709270274.issue35435@psf.upfronthosting.co.za>
Message-ID: <1544213259.23.0.788709270274.issue35435@psf.upfronthosting.co.za>


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

> put a prominent note at the top of each page "This is an unsupported version of the docs, for the latest version see blah blah blah" and link to the most recent version.


Not sure how straightforward it will be to do this, and whether it will worth the trouble. Julien, perhaps you know more about this and can provide assessment. Perhaps it needs to be done from within python-docs-theme?

FWIW, the landing page of each version (example https://docs.python.org/3.3/) states when it was last built. It can be an indication that it is outdated.

There's also a related issue in python.org to better inform people of which Python versions are still maintained or not: https://github.com/python/pythondotorg/issues/1302

I think as it stands, this ticket is "not a bug".

----------

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

From report at bugs.python.org  Fri Dec  7 16:11:44 2018
From: report at bugs.python.org (Ned Deily)
Date: Fri, 07 Dec 2018 21:11:44 +0000
Subject: [docs] [issue35435] Documentation of 3.3 is available
In-Reply-To: <1544164258.79.0.788709270274.issue35435@psf.upfronthosting.co.za>
Message-ID: <1544217104.77.0.788709270274.issue35435@psf.upfronthosting.co.za>


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

> I think as it stands, this ticket is "not a bug".

Indeed, this is not only not a bug, it's a feature that the docs for every Python release family are available on-line.  That said, we do have two sets of URLs that point to these docs:

1. https://docs.python.org/release/x.y.z/ which is the canonical link to the docs for a particular release and linked to from https://www.python.org/doc/versions/

2. https://docs.python.org/x.y/ (along with /x) which points to the most recent top of branch doc build for that branch.  For the next feature release branch (master) and branches still in bug-fix mode, the docs are automatically updated several times a day.  For 2.x and 3.x branches in security-fix mode or at end-of-life (retired), there are symlinks here that point to the doc set for the most recent release of that branch, i.e. the same doc set available in https://docs.python.org/release/x.y.z/.

There is already in place a restriction in the robots.txt file for the docs.python.org server to not webcrawl anything under /release but there is nothing (AFAICT) telling webcrawlers to ignore the "symlinked" aliases at /x.y, and that would seem to be the case here.

Without spending too much time on it, it seems to me there are s number of issues here:
1. What URL schemes do we have and want to continue to support?
2. What things do we want to show up in search engine results?
3. How do we make that happen?
4. How do we maintain this going forward?

One possibility that comes to mind:
1. unchanged from today
2. just the most current 3.x maintenance release (e.g. today 3.7)?  People needing accessing to other current or security-fix branches (dev, 3.6, 2.7, 3.5) can access those docsets through the version switcher pulldown on the doc webpages.
3. What isn't so obvious today is how to get to docsets for other, older releases.  For that, perhaps we could add an "Other ..." or some such item to the version switcher list that would link to the complete list at https://www.python.org/doc/versions/ ?
4. If we think it is important to indefinitely provide the links at https://docs.python.org/x.y/ even after the release is retired, we could add a step to the release process to add an entry to robots.txt when a release enters security-fix-mode ?  Or earlier?  That gets back to question 2.

I think this all is something for our release docs expert, Julien, to look into.

----------
assignee: docs at python -> mdk
nosy: +ned.deily

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

From report at bugs.python.org  Fri Dec  7 18:10:25 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 07 Dec 2018 23:10:25 +0000
Subject: [docs] [issue35435] Discourage external links to old docs.
In-Reply-To: <1544164258.79.0.788709270274.issue35435@psf.upfronthosting.co.za>
Message-ID: <1544224225.13.0.788709270274.issue35435@psf.upfronthosting.co.za>


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

I changed the title to better state the actual issue and goal of action.

The termination solution is rejected, but further revisions to docs and site need not be.  Adding the auto updated https://docs.python.org/3/ was a good move (and a reason to not casually go to a 4.0 release) but not the end of what we could do.

I agree with Ned that easier internal access, such as through 'other...', would be nice.

----------
nosy: +terry.reedy
stage:  -> needs patch
title: Documentation of 3.3 is available -> Discourage external links to old docs.
type:  -> enhancement

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

From report at bugs.python.org  Sat Dec  8 05:24:08 2018
From: report at bugs.python.org (Julien Palard)
Date: Sat, 08 Dec 2018 10:24:08 +0000
Subject: [docs] [issue35435] Discourage external links to old docs.
In-Reply-To: <1544164258.79.0.788709270274.issue35435@psf.upfronthosting.co.za>
Message-ID: <1544264648.38.0.788709270274.issue35435@psf.upfronthosting.co.za>


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

> Without spending too much time on it, it seems to me there are s number of issues here:
> 1. What URL schemes do we have and want to continue to support?
> 2. What things do we want to show up in search engine results?
> 3. How do we make that happen?
> 4. How do we maintain this going forward?

1. unchanged from today is good: let's not break things.
2. agree too: just the most current 3.x maintenance release
3. By adding links from old releases to new releases, go new releases get weight (from a search engine point of view) and should rank better. Also by checking if the canonical header is configured properly on all releases.
4. I don't think hiding old pages from search engine is a good idea, it's lying to them. I'd prefer the way of linking from old to new, which is both user friendly (a) and search engine friendly (b).

a) A nice text like "This is the documentation of an unmaintained version of Python, [switch to the latest version]" will not only help people landing from this old page from a search engine but also from favorites, links from articles, ...
b) Search engine compute the "weight" of a page by adding weights of pages linking to it. Our old pages are linked from a lot of articles and various sources, they have a huge weight. Linking from those pages to our new pages will forward a part of this weight to our new pages, ranking them a bit better. Which is I think better than hiding the old pages from them and loosing the weight they accumulated (risk: get old blogs articles rank better than new official documentation).

About the canonical, I'm having an issue opened indirectly about it (https://github.com/python/docsbuild-scripts/issues/51), by rebuilding old releases we could upgrade their headers and properly set a canonical link, typically from /3.4/ to /3/, like we're currently having from /3.5/ to /3/.

I have an opened issue about handling the /release/ directory from docsbuild-scripts instead of it being a manual step in the release process (https://github.com/python/docsbuild-scripts/issues/48).

I opened an issue in python-docs-theme about displaying a message pointing from old releases to new releases https://github.com/python/python-docs-theme/issues/24 mainly not to forgot about it.

----------

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

From report at bugs.python.org  Sat Dec  8 09:59:08 2018
From: report at bugs.python.org (Danish Prakash)
Date: Sat, 08 Dec 2018 14:59:08 +0000
Subject: [docs] [issue31823] Opaque default value for close_fds argument in
 Popen.__init__
In-Reply-To: <1508445256.4.0.213398074469.issue31823@psf.upfronthosting.co.za>
Message-ID: <1544281148.45.0.702299269573.issue31823@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Dec  8 20:53:16 2018
From: report at bugs.python.org (Windson Yang)
Date: Sun, 09 Dec 2018 01:53:16 +0000
Subject: [docs] [issue35325] imp.find_module() return value documentation
 discrepancy
In-Reply-To: <1543303624.81.0.788709270274.issue35325@psf.upfronthosting.co.za>
Message-ID: <1544320396.57.0.702299269573.issue35325@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Dec  8 21:01:23 2018
From: report at bugs.python.org (Windson Yang)
Date: Sun, 09 Dec 2018 02:01:23 +0000
Subject: [docs] [issue35105] Document that CPython accepts "invalid"
 identifiers
In-Reply-To: <1540815891.13.0.788709270274.issue35105@psf.upfronthosting.co.za>
Message-ID: <1544320883.49.0.788709270274.issue35105@psf.upfronthosting.co.za>


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

Any ideas? Or I will create a PR in a week without 'CPython implementation detail'

----------

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

From report at bugs.python.org  Sat Dec  8 21:18:53 2018
From: report at bugs.python.org (Steven D'Aprano)
Date: Sun, 09 Dec 2018 02:18:53 +0000
Subject: [docs] [issue35105] Document that CPython accepts "invalid"
 identifiers
In-Reply-To: <1544320883.49.0.788709270274.issue35105@psf.upfronthosting.co.za>
Message-ID: <20181209021847.GR13061@ando.pearwood.info>


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

> Any ideas? Or I will create a PR in a week without 'CPython implementation detail'

I don't think we want to give any stability guarantees for this. Perhaps 
we should explicitly state that this is not guaranteed behaviour and may 
change in the future.

I would be happy for it to be stated as an CPython implementation 
detail. If PyPy or any other implementation happen to duplicate it, 
we're not responsible for documenting that fact.

Please go ahead and make a PR.

----------

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

From report at bugs.python.org  Sun Dec  9 07:40:06 2018
From: report at bugs.python.org (Alistsair Lenhard)
Date: Sun, 09 Dec 2018 12:40:06 +0000
Subject: [docs] [issue35446] incorrect example
Message-ID: <1544359206.53.0.788709270274.issue35446@psf.upfronthosting.co.za>


New submission from Alistsair Lenhard <alistair.lenhard at googlemail.com>:

under: https://docs.python.org/3/tutorial/errors.html

Original it says:
"Note that if the except clauses were reversed (with except B first), it would have printed B, B, B ? the first matching except clause is triggered."

It should read:
"Note that if the except clauses were reversed (with except B first), it would have printed D, D, D ? the first matching except clause is triggered."
 
As D is the first expression in the print statement.
So if the expression is changed to "except B:"

class B(Exception):
    pass

class C(B):
    pass

class D(C):
    pass

for cls in [B, C, D]:
    try:
        raise cls()
    except B:
        print("D")
    except C:
        print("C")
    except B:
        print("B")

Result is:
D
D
D

----------
assignee: docs at python
components: Documentation
messages: 331428
nosy: Alistair, docs at python
priority: normal
severity: normal
status: open
title: incorrect example
versions: Python 3.7

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

From report at bugs.python.org  Sun Dec  9 13:05:37 2018
From: report at bugs.python.org (Marcin)
Date: Sun, 09 Dec 2018 18:05:37 +0000
Subject: [docs] [issue35450] venv module doesn't create a copy of python
 binary by default
Message-ID: <1544378737.46.0.788709270274.issue35450@psf.upfronthosting.co.za>


New submission from Marcin <marcin2006 at gmail.com>:

Hello,
from documentation:
https://docs.python.org/3/library/venv.html

"python3 -m venv /path/to/new/virtual/environment

Running this command creates the target directory (creating any parent directories that don?t exist already) and places a pyvenv.cfg file in it with a home key pointing to the Python installation from which the command was run. It also creates a bin (or Scripts on Windows) subdirectory containing **a copy** of the python binary (or binaries, in the case of Windows)."

This is not true. In my case it creates symlinks to python binary by default. This is quite different. Upgrading system's python version broke my virtual environment because I believed I'm having a static copy of python binary in my virtual environment.

----------
assignee: docs at python
components: Documentation
messages: 331445
nosy: docs at python, mkkot
priority: normal
severity: normal
status: open
title: venv module doesn't create a copy of python binary by default
versions: Python 3.7

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

From report at bugs.python.org  Sun Dec  9 13:24:42 2018
From: report at bugs.python.org (Ned Deily)
Date: Sun, 09 Dec 2018 18:24:42 +0000
Subject: [docs] [issue35450] venv module doesn't create a copy of python
 binary by default
In-Reply-To: <1544378737.46.0.788709270274.issue35450@psf.upfronthosting.co.za>
Message-ID: <1544379882.85.0.702299269573.issue35450@psf.upfronthosting.co.za>


Change by Ned Deily <nad at python.org>:


----------
nosy: +vinay.sajip

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

From report at bugs.python.org  Sun Dec  9 19:16:52 2018
From: report at bugs.python.org (=?utf-8?b?R8Opcnk=?=)
Date: Mon, 10 Dec 2018 00:16:52 +0000
Subject: [docs] [issue23864] issubclass without registration only works for
 "one-trick pony" collections ABCs.
In-Reply-To: <1428145067.47.0.0726533343331.issue23864@psf.upfronthosting.co.za>
Message-ID: <1544401012.45.0.788709270274.issue23864@psf.upfronthosting.co.za>


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

Guido, could we add those missing __subclasshook__ for consistency?

----------
nosy: +gvanrossum, maggyero

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

From report at bugs.python.org  Sun Dec  9 21:01:27 2018
From: report at bugs.python.org (Guido van Rossum)
Date: Mon, 10 Dec 2018 02:01:27 +0000
Subject: [docs] [issue23864] issubclass without registration only works for
 "one-trick pony" collections ABCs.
In-Reply-To: <1428145067.47.0.0726533343331.issue23864@psf.upfronthosting.co.za>
Message-ID: <1544407287.37.0.788709270274.issue23864@psf.upfronthosting.co.za>


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

No, I consider this is a documentation problem. I don't recall why the docs say that (I don't even know if they still say that or whether Martijn misread them), but IMO this should not be changed.

----------

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

From report at bugs.python.org  Mon Dec 10 04:42:41 2018
From: report at bugs.python.org (Martin Panter)
Date: Mon, 10 Dec 2018 09:42:41 +0000
Subject: [docs] [issue35446] incorrect example
In-Reply-To: <1544359206.53.0.788709270274.issue35446@psf.upfronthosting.co.za>
Message-ID: <1544434961.68.0.788709270274.issue35446@psf.upfronthosting.co.za>


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

It doesn?t make sense to move the ?except? line without moving the matching ?print? line. According to <https://docs.python.org/3.7/reference/compound_stmts.html#index-1>, ?A clause consists of a header and a ?suite?.? So when it talks about reversing the ?except? clauses, that includes reversing the corresponding ?print? lines, so they condinue to identify which exception handler was triggered.

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

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

From report at bugs.python.org  Mon Dec 10 05:05:09 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 10 Dec 2018 10:05:09 +0000
Subject: [docs] [issue35446] incorrect example
In-Reply-To: <1544359206.53.0.788709270274.issue35446@psf.upfronthosting.co.za>
Message-ID: <1544436309.84.0.788709270274.issue35446@psf.upfronthosting.co.za>


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

The example is correct. If the except clauses were reversed

for cls in [B, C, D]:
    try:
        raise cls()
    except B:
        print("B")
    except C:
        print("C")
    except D:
        print("D")

it would have printed B, B, B.

----------
nosy: +serhiy.storchaka
resolution:  -> not a bug
stage:  -> resolved
status: open -> closed

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

From report at bugs.python.org  Mon Dec 10 05:45:28 2018
From: report at bugs.python.org (Stefan Bauer (TraceTronic))
Date: Mon, 10 Dec 2018 10:45:28 +0000
Subject: [docs] [issue35325] imp.find_module() return value documentation
 discrepancy
In-Reply-To: <1543303624.81.0.788709270274.issue35325@psf.upfronthosting.co.za>
Message-ID: <1544438728.59.0.788709270274.issue35325@psf.upfronthosting.co.za>


Stefan Bauer (TraceTronic) <stefan.bauer at tracetronic.de> added the comment:

Hi, thank you for your proposal. However, your version still contains the discepancy. Maybe I formulated the problem not clear, so let's try again:

The documentation should state that "pathname" will be None (not the empty string) for built-in and frozen modules in order to be in line with the implementation.

Thank you very much for your efforts.
Kind regards, Stefan

----------

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

From report at bugs.python.org  Mon Dec 10 12:32:07 2018
From: report at bugs.python.org (Gregory P. Smith)
Date: Mon, 10 Dec 2018 17:32:07 +0000
Subject: [docs] [issue31823] Opaque default value for close_fds argument in
 Popen.__init__
In-Reply-To: <1508445256.4.0.213398074469.issue31823@psf.upfronthosting.co.za>
Message-ID: <1544463127.37.0.702299269573.issue31823@psf.upfronthosting.co.za>


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


----------
versions:  -Python 3.6

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

From report at bugs.python.org  Mon Dec 10 12:38:09 2018
From: report at bugs.python.org (Gregory P. Smith)
Date: Mon, 10 Dec 2018 17:38:09 +0000
Subject: [docs] [issue31823] Opaque default value for close_fds argument in
 Popen.__init__
In-Reply-To: <1508445256.4.0.213398074469.issue31823@psf.upfronthosting.co.za>
Message-ID: <1544463489.0.0.788709270274.issue31823@psf.upfronthosting.co.za>


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

In 3.6 this help(subprocess.Popen.__init__) is accurate and encourages looking at the docs.  In 3.7 and later it'll simply report close_fds=True in the siguature as that is the case in 3.7 onwards.

I see nothing to fix here.

----------
nosy: +gregory.p.smith
resolution:  -> wont fix
stage: patch review -> resolved
status: open -> closed

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

From report at bugs.python.org  Tue Dec 11 08:27:28 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 11 Dec 2018 13:27:28 +0000
Subject: [docs] [issue35461] Document C API functions which swallow
 exceptions
Message-ID: <1544534848.15.0.788709270274.issue35461@psf.upfronthosting.co.za>


New submission from Serhiy Storchaka <storchaka+cpython at gmail.com>:

C API functions like PyDict_GetItem() and PyObject_HasAttr() suppresses all errors that may occur, including MemoryError and KeyboardInterrupt. They can return incorrect result when the memory is exhausted or the user presses Ctrl-C. The proposed PR documents such functions and suggests the C API which do not swallow unrelated exceptions.

Previous attempt to document this (for PyDict_GetItem() only) was in issue20615.

----------
assignee: docs at python
components: Documentation
messages: 331620
nosy: docs at python, rhettinger, ronaldoussoren, serhiy.storchaka, vstinner
priority: normal
severity: normal
status: open
title: Document C API functions which swallow exceptions
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/issue35461>
_______________________________________

From report at bugs.python.org  Tue Dec 11 08:29:32 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 11 Dec 2018 13:29:32 +0000
Subject: [docs] [issue35461] Document C API functions which swallow
 exceptions
In-Reply-To: <1544534848.15.0.788709270274.issue35461@psf.upfronthosting.co.za>
Message-ID: <1544534972.1.0.702299269573.issue35461@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Tue Dec 11 09:22:10 2018
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 11 Dec 2018 14:22:10 +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: <1544538130.22.0.788709270274.issue34172@psf.upfronthosting.co.za>


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

I started a thread on python-dev to discuss these issues:
https://mail.python.org/pipermail/python-dev/2018-December/155946.html

----------

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

From report at bugs.python.org  Tue Dec 11 14:21:33 2018
From: report at bugs.python.org (=?utf-8?b?SHJ2b2plIE5pa8WhacSH?=)
Date: Tue, 11 Dec 2018 19:21:33 +0000
Subject: [docs] [issue35465] Document add_signal_handler
Message-ID: <1544556093.28.0.788709270274.issue35465@psf.upfronthosting.co.za>


New submission from Hrvoje Nik?i? <hniksic at gmail.com>:

In https://stackoverflow.com/q/53704709/1600898 a StackOverflow user asked how the add_signal_handler event loop method differs from the signal.signal normally used by Python code.

The add_signal_handler documentation is quite brief - if we exclude the parts that explain the exceptions raised and how to pass keyword arguments to the callback, the meat is this sentence:

    Set callback as the handler for the signum signal.

It is only after looking at the source, and understanding asyncio, that one comes to the conclusion that the idea is to run the handler along with other event loop callbacks and coroutines, at the time when it is actually safe to invoke asyncio code.

I think this deserves to be mentioned explicitly, for example:

    Set callback as the handler for the signum signal.

    The callback will be invoked in the thread that runs the event
    loop, along with other queued callbacks and runnable coroutines.
    Unlike signal handlers registered using signal.signal(), a 
    callback registered with this function is allowed to interact
    with the event loop.

----------
assignee: docs at python
components: Documentation
messages: 331645
nosy: docs at python, hniksic
priority: normal
severity: normal
status: open
title: Document add_signal_handler
versions: Python 3.7, Python 3.8

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

From report at bugs.python.org  Tue Dec 11 15:02:01 2018
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 11 Dec 2018 20:02:01 +0000
Subject: [docs] [issue35450] venv module doesn't create a copy of python
 binary by default
In-Reply-To: <1544378737.46.0.788709270274.issue35450@psf.upfronthosting.co.za>
Message-ID: <1544558521.01.0.702299269573.issue35450@psf.upfronthosting.co.za>


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


----------
stage:  -> needs patch
versions: +Python 3.5, Python 3.6, Python 3.8

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

From report at bugs.python.org  Tue Dec 11 15:03:41 2018
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 11 Dec 2018 20:03:41 +0000
Subject: [docs] [issue35450] venv module doesn't create a copy of python
 binary by default
In-Reply-To: <1544378737.46.0.788709270274.issue35450@psf.upfronthosting.co.za>
Message-ID: <1544558621.22.0.788709270274.issue35450@psf.upfronthosting.co.za>


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

Correct, that should say something like "copy/symlink of the Python binary/binaries (as appropriate by the platform or arguments used at environment creation time)."

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

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

From report at bugs.python.org  Tue Dec 11 15:04:13 2018
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 11 Dec 2018 20:04:13 +0000
Subject: [docs] [issue35450] venv module doesn't create a copy of python
 binary by default
In-Reply-To: <1544378737.46.0.788709270274.issue35450@psf.upfronthosting.co.za>
Message-ID: <1544558653.94.0.788709270274.issue35450@psf.upfronthosting.co.za>


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

Obviously if you're willing to create a PR, Marcin, that would be great!

----------

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

From luca-niederstadt at web.de  Tue Dec 11 09:09:57 2018
From: luca-niederstadt at web.de (luca-niederstadt at web.de)
Date: Tue, 11 Dec 2018 15:09:57 +0100
Subject: [docs] bug report, dividing a number by 100 and adding 1
Message-ID: <trinity-282b3284-90c2-42aa-82fa-3c95ccfc6b5d-1544537397795@3c-app-webde-bs46>

An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181211/3d297d22/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: screenshot1.JPG
Type: image/jpeg
Size: 31426 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20181211/3d297d22/attachment-0002.jpe>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: screenshot2.JPG
Type: image/jpeg
Size: 36054 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20181211/3d297d22/attachment-0003.jpe>

From julien at palard.fr  Tue Dec 11 16:23:25 2018
From: julien at palard.fr (Julien Palard)
Date: Tue, 11 Dec 2018 21:23:25 +0000
Subject: [docs] bug report, dividing a number by 100 and adding 1
In-Reply-To: <trinity-282b3284-90c2-42aa-82fa-3c95ccfc6b5d-1544537397795@3c-app-webde-bs46>
References: <trinity-282b3284-90c2-42aa-82fa-3c95ccfc6b5d-1544537397795@3c-app-webde-bs46>
Message-ID: <byLCvSW6Mt9ONe-hGXzstMxNEugna_2ldVQztSgrnSAa3OfqXXeExKIkgY29YigS18mypGIKUvSA4x3TVw3WzOdzXEg3MVAq1MzLn8CyKQM=@palard.fr>

Hi!

> Similar errors happend with other numers as well, for example 1.3599999999999999 and 1.6800000000000002.

I'd love to write you a long explanation on this subject. But there's already a huge section on the documentation about it: https://docs.python.org/3.7/tutorial/floatingpoint.html

Hope it helps, don't hesitate to ask again in details if something is not settled after reading it.

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

From report at bugs.python.org  Tue Dec 11 17:14:08 2018
From: report at bugs.python.org (Eric Snow)
Date: Tue, 11 Dec 2018 22:14:08 +0000
Subject: [docs] [issue35446] incorrect example
In-Reply-To: <1544359206.53.0.788709270274.issue35446@psf.upfronthosting.co.za>
Message-ID: <1544566448.6.0.702299269573.issue35446@psf.upfronthosting.co.za>


Change by Eric Snow <ericsnowcurrently at gmail.com>:


----------
pull_requests: +10353

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

From report at bugs.python.org  Tue Dec 11 17:16:44 2018
From: report at bugs.python.org (Eric Snow)
Date: Tue, 11 Dec 2018 22:16:44 +0000
Subject: [docs] [issue35446] incorrect example
In-Reply-To: <1544359206.53.0.788709270274.issue35446@psf.upfronthosting.co.za>
Message-ID: <1544566604.31.0.702299269573.issue35446@psf.upfronthosting.co.za>


Change by Eric Snow <ericsnowcurrently at gmail.com>:


----------
pull_requests:  -10353

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

From manpreet at bhatti.net  Wed Dec 12 02:12:23 2018
From: manpreet at bhatti.net (Manpreet Singh)
Date: Wed, 12 Dec 2018 02:12:23 -0500
Subject: [docs] 404 Not Found
Message-ID: <CAAZQkVBkB9e31OQ+1gWorPtLeD8ZV05b_=WHnM2EDMjFVM_P2A@mail.gmail.com>

When downloading the Python 3.7 documentation for EPUB and PDF, I was
redirected to a 404 Not Found page. Please fix this. Thanks!
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181212/45f6729e/attachment.html>

From report at bugs.python.org  Wed Dec 12 03:39:56 2018
From: report at bugs.python.org (Tal Einat)
Date: Wed, 12 Dec 2018 08:39:56 +0000
Subject: [docs] [issue31823] Opaque default value for close_fds argument in
 Popen.__init__
In-Reply-To: <1508445256.4.0.213398074469.issue31823@psf.upfronthosting.co.za>
Message-ID: <1544603995.9.0.788709270274.issue31823@psf.upfronthosting.co.za>


Tal Einat <taleinat at gmail.com> added the comment:

Gregory, this issue was about the docs, not the doc-string (help()). Are you sure it should be closed?

----------

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

From jules.lasne at gmail.com  Wed Dec 12 09:02:16 2018
From: jules.lasne at gmail.com (Jules Lasne)
Date: Wed, 12 Dec 2018 15:02:16 +0100
Subject: [docs] 404 Not Found
In-Reply-To: <CAAZQkVBkB9e31OQ+1gWorPtLeD8ZV05b_=WHnM2EDMjFVM_P2A@mail.gmail.com>
References: <CAAZQkVBkB9e31OQ+1gWorPtLeD8ZV05b_=WHnM2EDMjFVM_P2A@mail.gmail.com>
Message-ID: <CAC=u-iisMvW8sbwO9+BvA9h4M7Dm+LdKok9foKkvEunuQVBdwg@mail.gmail.com>

Hi there ! Thanks for letting us know !

We are investigating and it seems it's not only on the PDF and EPUB but
spread to all download formats. It seems linked to the 3.7.2rc1 that has
been released yesterday.
It seems to have also broken downloads to older documentation releases.
We are looking into fixing it right now, and we thank you a lot for
pointing this out to us

Best,
Jules Lasne
+33640736355
jules.lasne at gmail.com
juleslasne.com


Le mer. 12 d?c. 2018 ? 09:07, Manpreet Singh <manpreet at bhatti.net> a ?crit :

> When downloading the Python 3.7 documentation for EPUB and PDF, I was
> redirected to a 404 Not Found page. Please fix this. Thanks!
> _______________________________________________
> docs mailing list
> docs at python.org
> https://mail.python.org/mailman/listinfo/docs
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181212/ddea38fd/attachment.html>

From julien at palard.fr  Wed Dec 12 08:49:05 2018
From: julien at palard.fr (Julien Palard)
Date: Wed, 12 Dec 2018 13:49:05 +0000
Subject: [docs] 404 Not Found
In-Reply-To: <CAAZQkVBkB9e31OQ+1gWorPtLeD8ZV05b_=WHnM2EDMjFVM_P2A@mail.gmail.com>
References: <CAAZQkVBkB9e31OQ+1gWorPtLeD8ZV05b_=WHnM2EDMjFVM_P2A@mail.gmail.com>
Message-ID: <-eVFxnU_aX_FHis6jrIANWkP7eE5LpMMLvBCawPgaY_OMhhCXodobZlrK3oR6qPq4PllO2u1J9A5MhMi-qSkjJ0eUe_bhs4NCVFpmy3v-Ks=@palard.fr>

Hi, thanks for reporting,

It's probably a temporary issue while waiting for the doc server to build it. In the meantime I fixed it manually. I'll take a look later on how to avoid this happening again.

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

??????? Original Message ???????
On Wednesday, December 12, 2018 8:12 AM, Manpreet Singh <manpreet at bhatti.net> wrote:

> When downloading the Python 3.7 documentation for EPUB and PDF, I was redirected to a 404 Not Found page. Please fix this. Thanks!
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181212/b76e961b/attachment-0001.html>

From report at bugs.python.org  Wed Dec 12 11:04:17 2018
From: report at bugs.python.org (STINNER Victor)
Date: Wed, 12 Dec 2018 16:04:17 +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: <1544630657.78.0.788709270274.issue34172@psf.upfronthosting.co.za>


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

The new test_del_pool() test of the fix failed on a buildbot: bpo-35413 "test_multiprocessing_fork: test_del_pool() leaks dangling threads and processes on AMD64 FreeBSD CURRENT Shared 3.x".

----------

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

From report at bugs.python.org  Wed Dec 12 11:30:41 2018
From: report at bugs.python.org (Matthias Klose)
Date: Wed, 12 Dec 2018 16:30:41 +0000
Subject: [docs] [issue35472] python 3.7.2 rc1 bumped the build requirements
 for no reason
Message-ID: <1544632241.86.0.788709270274.issue35472@psf.upfronthosting.co.za>


New submission from Matthias Klose <doko at debian.org>:

python 3.7.2 rc1 bumped the build requirements apparently for no reason, now requiring sphinx 1.7 instead of 1.6.x before.  This is a major pain, if you want to provide the build including the documentation on a stable release.  Pretty please can we avoid such version bumps on the branches?

Plus the documentation seems to build fine with 1.6.7.

----------
assignee: docs at python
components: Documentation
keywords: 3.7regression
messages: 331705
nosy: docs at python, doko, ned.deily
priority: release blocker
severity: normal
status: open
title: python 3.7.2 rc1 bumped the build requirements for no reason
versions: Python 3.7

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

From report at bugs.python.org  Wed Dec 12 11:32:18 2018
From: report at bugs.python.org (STINNER Victor)
Date: Wed, 12 Dec 2018 16:32:18 +0000
Subject: [docs] [issue35472] python 3.7.2 rc1 bumped the build requirements
 for no reason
In-Reply-To: <1544632241.86.0.788709270274.issue35472@psf.upfronthosting.co.za>
Message-ID: <1544632338.8.0.702299269573.issue35472@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Wed Dec 12 11:35:30 2018
From: report at bugs.python.org (STINNER Victor)
Date: Wed, 12 Dec 2018 16:35:30 +0000
Subject: [docs] [issue35472] python 3.7.2 rc1 bumped the build requirements
 for no reason
In-Reply-To: <1544632241.86.0.788709270274.issue35472@psf.upfronthosting.co.za>
Message-ID: <1544632530.17.0.788709270274.issue35472@psf.upfronthosting.co.za>


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

"for no reason"

I guess that it's related to this change:

commit c03bf0ae794c3bec9b56f38164535fd1f5bfc04a
Author: Adrian Liaw <adrianliaw2000 at gmail.com>
Date:   Mon Nov 5 05:04:51 2018 +0800

    Doc: Disable smartquotes for zh-tw, zh-cn, fr and ja translations (GH-9423)

Extract:

diff --git a/Doc/conf.py b/Doc/conf.py
index 6060ac176c..eb57ee0c93 100644
--- a/Doc/conf.py
+++ b/Doc/conf.py
@@ -41,13 +41,18 @@ today_fmt = '%B %d, %Y'
 # By default, highlight as Python 3.
 highlight_language = 'python3'
 
-# Require Sphinx 1.2 for build.
-needs_sphinx = '1.2'
+# Require Sphinx 1.7 for build.
+needs_sphinx = '1.7'
 
 # Ignore any .rst files in the venv/ directory.
 venvdir = os.getenv('VENVDIR', 'venv')
 exclude_patterns = [venvdir+'/*', 'README.rst']
 
+# Disable Docutils smartquotes for several translations
+smartquotes_excludes = {
+    'languages': ['ja', 'fr', 'zh_TW', 'zh_CN'], 'builders': ['man', 'text'],
+}
+


According to Sphinx changelog, smartquotes_excludes is a new feature of Sphinx 1.6.6:

https://www.sphinx-doc.org/en/master/changes.html#release-1-6-6-released-jan-08-2018

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

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

From report at bugs.python.org  Wed Dec 12 11:43:30 2018
From: report at bugs.python.org (Andrew Svetlov)
Date: Wed, 12 Dec 2018 16:43:30 +0000
Subject: [docs] [issue35465] Document add_signal_handler
In-Reply-To: <1544556093.28.0.788709270274.issue35465@psf.upfronthosting.co.za>
Message-ID: <1544633010.03.0.788709270274.issue35465@psf.upfronthosting.co.za>


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

The proposal sounds great!
Would you prepare a pull request for docs update?

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

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

From report at bugs.python.org  Wed Dec 12 12:17:07 2018
From: report at bugs.python.org (Ned Deily)
Date: Wed, 12 Dec 2018 17:17:07 +0000
Subject: [docs] [issue35472] python 3.7.2 rc1 bumped the build requirements
 for no reason
In-Reply-To: <1544632241.86.0.788709270274.issue35472@psf.upfronthosting.co.za>
Message-ID: <1544635027.28.0.788709270274.issue35472@psf.upfronthosting.co.za>


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

Julien can give the definite answer.  But, sorry, I don't see this as a release blocker.  We've had to bump Sphinx versions for a number of reasons as the documentation has become more sophisticated between cycles and over a release cycle.  In fact, we're now using 1.8.2 for release builds.  And it shouldn't be an issue at all if one uses the doc Makefile venv target:

make venv
make html

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

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

From report at bugs.python.org  Wed Dec 12 14:11:41 2018
From: report at bugs.python.org (Eric Snow)
Date: Wed, 12 Dec 2018 19:11:41 +0000
Subject: [docs] [issue35475] Docs do not show PyImport_AddModuleObject()
 returns a borrowed reference.
Message-ID: <1544641901.4.0.788709270274.issue35475@psf.upfronthosting.co.za>


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

In the C-API documentation the entry for PyImport_AddModuleObject[1] does not indicate that it returns a borrowed reference.

[1] https://docs.python.org/3/c-api/import.html#c.PyImport_AddModuleObject

----------
assignee: docs at python
components: Documentation
keywords: easy
messages: 331716
nosy: docs at python, eric.snow
priority: normal
severity: normal
stage: needs patch
status: open
title: Docs do not show PyImport_AddModuleObject() returns a borrowed reference.
type: enhancement
versions: Python 3.5, Python 3.6, Python 3.7, Python 3.8

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

From report at bugs.python.org  Wed Dec 12 15:18:36 2018
From: report at bugs.python.org (Brett Cannon)
Date: Wed, 12 Dec 2018 20:18:36 +0000
Subject: [docs] [issue35465] [asyncio] Document loop.add_signal_handler
In-Reply-To: <1544556093.28.0.788709270274.issue35465@psf.upfronthosting.co.za>
Message-ID: <1544645916.5.0.702299269573.issue35465@psf.upfronthosting.co.za>


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


----------
title: Document add_signal_handler -> [asyncio] Document loop.add_signal_handler

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

From report at bugs.python.org  Wed Dec 12 15:57:26 2018
From: report at bugs.python.org (Andrew Svetlov)
Date: Wed, 12 Dec 2018 20:57:26 +0000
Subject: [docs] [issue35465] [asyncio] Document loop.add_signal_handler
In-Reply-To: <1544556093.28.0.788709270274.issue35465@psf.upfronthosting.co.za>
Message-ID: <1544648246.47.0.702299269573.issue35465@psf.upfronthosting.co.za>


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


----------
components: +asyncio
nosy: +yselivanov

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

From report at bugs.python.org  Wed Dec 12 16:26:57 2018
From: report at bugs.python.org (Julien Palard)
Date: Wed, 12 Dec 2018 21:26:57 +0000
Subject: [docs] [issue35472] python 3.7.2 rc1 bumped the build requirements
 for no reason
In-Reply-To: <1544632241.86.0.788709270274.issue35472@psf.upfronthosting.co.za>
Message-ID: <1544650017.25.0.788709270274.issue35472@psf.upfronthosting.co.za>


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

Hi Matthias,

Sorry to hear it's a pain for you. Can you explain in more details what hurt your workflow?

We bumped Sphinx, as Victor said, to fix rendering issues in those documentation translations: zh-tw, zh-cn, fr and ja, so it's not a feature or an ideology of "being up-to-date", we were fixing an issue in those 4 translations.

Please also note that in the near future we'll probably stick to a fresh version of Sphinx as we're expecting other fixes or features to land, I don't have all of them in mind but at least:

- https://github.com/sphinx-doc/sphinx/issues/5561 (release in 1.8.2)
- https://github.com/sphinx-doc/sphinx/pull/5559 (to be released in 2.0.0)

The colspan/rowspan thing is needed for the documentation of Python 3.8, so we'll have to bump to sphinx 2.0 for Python 3.8.

----------

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

From report at bugs.python.org  Wed Dec 12 18:30:35 2018
From: report at bugs.python.org (Gregory P. Smith)
Date: Wed, 12 Dec 2018 23:30:35 +0000
Subject: [docs] [issue31823] Opaque default value for close_fds argument in
 Popen.__init__
In-Reply-To: <1508445256.4.0.213398074469.issue31823@psf.upfronthosting.co.za>
Message-ID: <1544657435.61.0.788709270274.issue31823@psf.upfronthosting.co.za>


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

Only if someone can point to a concrete problem to be fixed in the 3.7+ docs.  Looking at all references to close_fds in https://docs.python.org/3/library/subprocess.html I don't see one.

(I'm not going to touch the 3.6 docs)

----------

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

From report at bugs.python.org  Thu Dec 13 02:39:11 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 13 Dec 2018 07:39:11 +0000
Subject: [docs] [issue35461] Document C API functions which swallow
 exceptions
In-Reply-To: <1544534848.15.0.788709270274.issue35461@psf.upfronthosting.co.za>
Message-ID: <1544686751.86.0.702299269573.issue35461@psf.upfronthosting.co.za>


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


----------
nosy: +eric.snow

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

From report at bugs.python.org  Thu Dec 13 02:51:23 2018
From: report at bugs.python.org (Aaqa Ishtyaq)
Date: Thu, 13 Dec 2018 07:51:23 +0000
Subject: [docs] [issue35475] Docs do not show PyImport_AddModuleObject()
 returns a borrowed reference.
In-Reply-To: <1544641901.4.0.788709270274.issue35475@psf.upfronthosting.co.za>
Message-ID: <1544687483.54.0.788709270274.issue35475@psf.upfronthosting.co.za>


Aaqa Ishtyaq <aaqaishtyaq at gmail.com> added the comment:

Hi, I want to work on this issue, but I'm confused about how to apply to PyImport_AddModuleObject.

I was also going through c_annotations.py[1].

[1] https://github.com/python/cpython/blob/master/Doc/tools/extensions/c_annotations.py

----------
nosy: +aaqaishtyaq

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

From report at bugs.python.org  Thu Dec 13 03:04:18 2018
From: report at bugs.python.org (Ammar Askar)
Date: Thu, 13 Dec 2018 08:04:18 +0000
Subject: [docs] [issue35475] Docs do not show PyImport_AddModuleObject()
 returns a borrowed reference.
In-Reply-To: <1544641901.4.0.788709270274.issue35475@psf.upfronthosting.co.za>
Message-ID: <1544688257.93.0.788709270274.issue35475@psf.upfronthosting.co.za>


Ammar Askar <ammar at ammaraskar.com> added the comment:

A good place to start might be to search for a function that says it returns a borrowed reference in the source tree. For example, "PyImport_AddModule" says it returns a borrowed reference. 

In the search you'll find the relevant file here:

https://github.com/python/cpython/blob/e42b705188271da108de42b55d9344642170aa2b/Doc/data/refcounts.dat#L569

----------
nosy: +ammar2

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

From report at bugs.python.org  Thu Dec 13 03:13:06 2018
From: report at bugs.python.org (Martin Panter)
Date: Thu, 13 Dec 2018 08:13:06 +0000
Subject: [docs] [issue31823] Opaque default value for close_fds argument in
 Popen.__init__
In-Reply-To: <1508445256.4.0.213398074469.issue31823@psf.upfronthosting.co.za>
Message-ID: <1544688786.13.0.788709270274.issue31823@psf.upfronthosting.co.za>


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

The only problem with the 3.7+ documentation is the note about 3.2. Several paragraphs under <https://docs.python.org/release/3.7.1/library/subprocess.html#subprocess.Popen>, it still says

?Changed in version 3.2: The default for ?close_fds? was changed from False to what is described above.?

However the description it refers to was removed in 3.6. IMO it would make sense to add the description to the note:

?Changed in version 3.2: The default for ?close_fds? was changed from False to True on Unix. On Windows the default was changed from False to True when stdin/stdout/stderr are None.?

----------

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

From julien at palard.fr  Thu Dec 13 03:28:41 2018
From: julien at palard.fr (Julien Palard)
Date: Thu, 13 Dec 2018 08:28:41 +0000
Subject: [docs] subscribe_policy ?
In-Reply-To: <3575344b-5227-0e04-8d47-e006122abad7@gmx.net>
References: <BiXOAdybU9SQjR3TNhQd6JN9Ms0FAgOsZiI1z-RHDqV1cisyO09kH5-FAk_tqcERG7b8T-7KSeNqxskOVyYbHavkhj12T_gMEnvgMWCR3YM=@palard.fr>
 <CAKJDb-P_rtteBnnHvGragpPZ1zQzitRgpi+XB-KeLX1H7_u7kw@mail.gmail.com>
 <3575344b-5227-0e04-8d47-e006122abad7@gmx.net>
Message-ID: <nuM-8jZ9zCSl5CEkNlaSwilOu2vPItsGszzyY1lciqVTJT9iBvFCmJZu4SWnYiBlxqjnDReAws4gLF7D2TZ8zh6MyoSbWg6V5Pf833Xf_yI=@palard.fr>

Thanks!

Still have a question: what about the subscribe_policy and default_member_moderation?

I mean, why do we moderate subscriptions to the list manually? Couldn't we let user subscribe freely?

And if so, default_member_moderation should probably be set to "on" (if not already) so new subscribed member are still moderated and cannot spam.

There's currently one pending subscription, joshuarwong at gmail.com, don't know the guy.


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


From report at bugs.python.org  Thu Dec 13 04:54:31 2018
From: report at bugs.python.org (Aaqa Ishtyaq)
Date: Thu, 13 Dec 2018 09:54:31 +0000
Subject: [docs] [issue35475] Docs do not show PyImport_AddModuleObject()
 returns a borrowed reference.
In-Reply-To: <1544641901.4.0.788709270274.issue35475@psf.upfronthosting.co.za>
Message-ID: <1544694871.55.0.788709270274.issue35475@psf.upfronthosting.co.za>


Aaqa Ishtyaq <aaqaishtyaq at gmail.com> added the comment:

I was going through the source code to understand what is going on, but I can't find any function that returns a borrowed reference for 'PyImport_AddModuleObject'.

Also, should I need to familiar with these macros and how they work?
https://docs.python.org/3/c-api/refcounting.html

----------

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

From report at bugs.python.org  Thu Dec 13 05:19:32 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 13 Dec 2018 10:19:32 +0000
Subject: [docs] [issue35475] Docs do not show PyImport_AddModuleObject()
 returns a borrowed reference.
In-Reply-To: <1544641901.4.0.788709270274.issue35475@psf.upfronthosting.co.za>
Message-ID: <1544696372.83.0.702299269573.issue35475@psf.upfronthosting.co.za>


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


----------
assignee: docs at python -> serhiy.storchaka
nosy: +serhiy.storchaka

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

From report at bugs.python.org  Thu Dec 13 05:24:05 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 13 Dec 2018 10:24:05 +0000
Subject: [docs] [issue35475] Docs do not show PyImport_AddModuleObject()
 returns a borrowed reference.
In-Reply-To: <1544641901.4.0.788709270274.issue35475@psf.upfronthosting.co.za>
Message-ID: <1544696645.34.0.702299269573.issue35475@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Dec 13 05:26:37 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 13 Dec 2018 10:26:37 +0000
Subject: [docs] [issue35475] Docs do not show PyImport_AddModuleObject()
 returns a borrowed reference.
In-Reply-To: <1544641901.4.0.788709270274.issue35475@psf.upfronthosting.co.za>
Message-ID: <1544696797.75.0.788709270274.issue35475@psf.upfronthosting.co.za>


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

Information about borrowed references is taken from Doc/data/refcounts.dat.

----------

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

From report at bugs.python.org  Thu Dec 13 06:11:33 2018
From: report at bugs.python.org (Matthias Klose)
Date: Thu, 13 Dec 2018 11:11:33 +0000
Subject: [docs] [issue35472] python 3.7.2 rc1 bumped the build requirements
 for no reason
In-Reply-To: <1544632241.86.0.788709270274.issue35472@psf.upfronthosting.co.za>
Message-ID: <1544699493.81.0.788709270274.issue35472@psf.upfronthosting.co.za>


Matthias Klose <doko at debian.org> added the comment:

"if one uses the doc Makefile venv target". which is not possible for distributions which are not allowed to use anything but the distro to build the distro.

so why bumping the version requirement to 1.7 instead of 1.6.6? Afaicu this is the required version.

I don't argue against introducing new build requirements in major versions, but having them introduced on the branches.

----------

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

From g.brandl at gmx.net  Thu Dec 13 06:55:48 2018
From: g.brandl at gmx.net (Georg Brandl)
Date: Thu, 13 Dec 2018 12:55:48 +0100
Subject: [docs] subscribe_policy ?
Message-ID: <trinity-a55e0dfa-804d-4583-9b0d-27d3e140c2e6-1544702148219@msvc-mesg-gmx123>

An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181213/f446b1e3/attachment.html>

From laurens at channable.com  Thu Dec 13 04:54:49 2018
From: laurens at channable.com (Laurens Duijvesteijn)
Date: Thu, 13 Dec 2018 10:54:49 +0100
Subject: [docs] Path.resolve() unclear about backwards incompatibility
Message-ID: <CABYkHVviBA3yO++ABAqttcfSNQb5wG_0ykhkj7LQ5T0CVJ6bhg@mail.gmail.com>

Hi,

The `Path.resolve()` method behaves differently on Python 3.5 vs Python 3.6.

The docs https://docs.python.org/3/library/pathlib.html#pathlib.Path.resolve
fail to mention this.

This is the behavior on 3.5:

```
Python 3.5.2 (default, Nov 12 2018, 13:43:14)
[GCC 5.4.0 20160609] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> from pathlib import Path
>>> p = Path('/var/../doesnotexist.txt')
>>> p.resolve()
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "/usr/lib/python3.5/pathlib.py", line 1109, in resolve
    s = self._flavour.resolve(self)
  File "/usr/lib/python3.5/pathlib.py", line 330, in resolve
    return _resolve(base, str(path)) or sep
  File "/usr/lib/python3.5/pathlib.py", line 315, in _resolve
    target = accessor.readlink(newpath)
  File "/usr/lib/python3.5/pathlib.py", line 422, in readlink
    return os.readlink(path)
FileNotFoundError: [Errno 2] No such file or directory: '/doesnotexist.txt'
```

This is the behavior on 3.6:

```
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 pathlib import Path
>>> p = Path('/var/../doesnotexist.txt')
>>> p.resolve()
PosixPath('/doesnotexist.txt')
```

I'd even say this change is a bug in the standard lib (if done on purpose,
it is not listed as a backwards incompatible change in the release notes,
didn't dig further).

The docs mention "New in version 3.6: The strict argument". IMO the docs
should also mention that before 3.5, this method would raise FileNotFound
by default.

Thanks and kind regards,
Laurens Duijvesteijn
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181213/16eaa165/attachment.html>

From report at bugs.python.org  Thu Dec 13 09:34:02 2018
From: report at bugs.python.org (Ma Lin)
Date: Thu, 13 Dec 2018 14:34:02 +0000
Subject: [docs] [issue35482] python372rc1.chm is ill
Message-ID: <1544711642.5.0.788709270274.issue35482@psf.upfronthosting.co.za>


New submission from Ma Lin <malincns at 163.com>:

python372rc1.chm can't be opened, it seems the compiling is not successful.

Compare to python371.chm, the file size reduced a lot:
python371.chm      8,534,435 bytes
python372rc1.chm   5,766,102 bytes

Some files in chm are missing, see attached pictures:
371_chm_files.png
372rc1_chm_files.png

After switch "Display compile progress" to Yes in .hhp file, the output is abnormal, see attached pictures:
371_compile_progress.png
372rc1_compile_progress.png

----------
assignee: docs at python
components: Documentation
files: 371_chm_files.png
messages: 331761
nosy: Ma Lin, docs at python
priority: normal
severity: normal
status: open
title: python372rc1.chm is ill
versions: Python 3.7
Added file: https://bugs.python.org/file47988/371_chm_files.png

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

From report at bugs.python.org  Thu Dec 13 09:34:16 2018
From: report at bugs.python.org (Ma Lin)
Date: Thu, 13 Dec 2018 14:34:16 +0000
Subject: [docs] [issue35482] python372rc1.chm is ill
In-Reply-To: <1544711642.5.0.788709270274.issue35482@psf.upfronthosting.co.za>
Message-ID: <1544711656.82.0.702299269573.issue35482@psf.upfronthosting.co.za>


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


Added file: https://bugs.python.org/file47989/372rc1_chm_files.png

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

From report at bugs.python.org  Thu Dec 13 09:34:28 2018
From: report at bugs.python.org (Ma Lin)
Date: Thu, 13 Dec 2018 14:34:28 +0000
Subject: [docs] [issue35482] python372rc1.chm is ill
In-Reply-To: <1544711642.5.0.788709270274.issue35482@psf.upfronthosting.co.za>
Message-ID: <1544711668.4.0.702299269573.issue35482@psf.upfronthosting.co.za>


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


Added file: https://bugs.python.org/file47990/371_compile_progress.png

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

From report at bugs.python.org  Thu Dec 13 09:34:41 2018
From: report at bugs.python.org (Ma Lin)
Date: Thu, 13 Dec 2018 14:34:41 +0000
Subject: [docs] [issue35482] python372rc1.chm is ill
In-Reply-To: <1544711642.5.0.788709270274.issue35482@psf.upfronthosting.co.za>
Message-ID: <1544711681.01.0.702299269573.issue35482@psf.upfronthosting.co.za>


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


Added file: https://bugs.python.org/file47991/372rc1_compile_progress.png

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

From report at bugs.python.org  Thu Dec 13 13:24:22 2018
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 13 Dec 2018 18:24:22 +0000
Subject: [docs] [issue35450] venv module doesn't create a copy of python
 binary by default
In-Reply-To: <1544378737.46.0.788709270274.issue35450@psf.upfronthosting.co.za>
Message-ID: <1544725462.43.0.702299269573.issue35450@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Dec 13 13:32:12 2018
From: report at bugs.python.org (Marcin)
Date: Thu, 13 Dec 2018 18:32:12 +0000
Subject: [docs] [issue35450] venv module doesn't create a copy of python
 binary by default
In-Reply-To: <1544378737.46.0.788709270274.issue35450@psf.upfronthosting.co.za>
Message-ID: <1544725932.73.0.788709270274.issue35450@psf.upfronthosting.co.za>


Marcin <marcin2006 at gmail.com> added the comment:

I'm very honoured with your request. Doing this for the first time with Python, hope you can accept it despite warnings.

https://github.com/python/cpython/pull/11144

----------

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

From report at bugs.python.org  Thu Dec 13 14:54:27 2018
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 13 Dec 2018 19:54:27 +0000
Subject: [docs] [issue35465] [asyncio] Document loop.add_signal_handler
In-Reply-To: <1544556093.28.0.788709270274.issue35465@psf.upfronthosting.co.za>
Message-ID: <1544730867.63.0.702299269573.issue35465@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Dec 13 14:55:58 2018
From: report at bugs.python.org (=?utf-8?b?SHJ2b2plIE5pa8WhacSH?=)
Date: Thu, 13 Dec 2018 19:55:58 +0000
Subject: [docs] [issue35465] [asyncio] Document loop.add_signal_handler
In-Reply-To: <1544556093.28.0.788709270274.issue35465@psf.upfronthosting.co.za>
Message-ID: <1544730957.82.0.788709270274.issue35465@psf.upfronthosting.co.za>


Hrvoje Nik?i? <hniksic at gmail.com> added the comment:

Done, https://github.com/python/cpython/pull/11145

----------

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

From juanmlleras at gmail.com  Thu Dec 13 19:16:03 2018
From: juanmlleras at gmail.com (Juan Manuel Lleras)
Date: Thu, 13 Dec 2018 19:16:03 -0500
Subject: [docs] Math module is not always available
Message-ID: <F5C6B0CD-FEC9-457D-B2E2-7CF807087C65@gmail.com>

The math module is not always available.

One needs to import the module

import math

for the module to become available in Python 3.7.

Best regards,

Juan Manuel Lleras

From julien at palard.fr  Fri Dec 14 03:50:29 2018
From: julien at palard.fr (Julien Palard)
Date: Fri, 14 Dec 2018 08:50:29 +0000
Subject: [docs] Math module is not always available
In-Reply-To: <F5C6B0CD-FEC9-457D-B2E2-7CF807087C65@gmail.com>
References: <F5C6B0CD-FEC9-457D-B2E2-7CF807087C65@gmail.com>
Message-ID: <PorBQtXaYAJocPnrKxkNvsDyxmQrVETx0f_wwIPKk1rgiaB2N4ftRaiiQsKFaFWmXfI6GxYlyvh9zEtLmUopdAsbgFEyCnrw8tyMJb3D73c=@palard.fr>

Hi Juan, thanks for writing us!

> The math module is not always available.

Yes, this is true and has always been. Are you trying to report that some page of the documentation is telling you the opposite? Could you be precise about which page / which paragraph exactly?

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


From report at bugs.python.org  Fri Dec 14 06:22:35 2018
From: report at bugs.python.org (Jules Lasne)
Date: Fri, 14 Dec 2018 11:22:35 +0000
Subject: [docs] [issue35492] Missing colon on func statement in library/sys
 doc
Message-ID: <1544786555.59.0.788709270274.issue35492@psf.upfronthosting.co.za>


New submission from Jules Lasne <jules.lasne at gmail.com>:

As you can see here, a `:` is missing for the href to be created. https://docs.python.org/3/library/sys.html#sys.get_coroutine_origin_tracking_depth

----------
assignee: docs at python
components: Documentation
messages: 331796
nosy: docs at python, mdk, seluj78
priority: normal
severity: normal
status: open
title: Missing colon on func statement in library/sys doc
versions: Python 3.7

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

From report at bugs.python.org  Fri Dec 14 06:23:17 2018
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 14 Dec 2018 11:23:17 +0000
Subject: [docs] [issue35492] Missing colon on func statement in library/sys
 doc
In-Reply-To: <1544786555.59.0.788709270274.issue35492@psf.upfronthosting.co.za>
Message-ID: <1544786597.28.0.702299269573.issue35492@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Dec 14 06:28:34 2018
From: report at bugs.python.org (STINNER Victor)
Date: Fri, 14 Dec 2018 11:28:34 +0000
Subject: [docs] [issue35492] Missing colon on func statement in library/sys
 doc
In-Reply-To: <1544786555.59.0.788709270274.issue35492@psf.upfronthosting.co.za>
Message-ID: <1544786914.31.0.702299269573.issue35492@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Dec 14 06:28:46 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 14 Dec 2018 11:28:46 +0000
Subject: [docs] [issue35492] Missing colon on func statement in library/sys
 doc
In-Reply-To: <1544786555.59.0.788709270274.issue35492@psf.upfronthosting.co.za>
Message-ID: <1544786926.41.0.788709270274.issue35492@psf.upfronthosting.co.za>


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


New changeset cb0f5e29e37c081e9bba91a9858370e2504e9e8e by Miss Islington (bot) (Jules Lasne (jlasne)) in branch 'master':
Fixed missing colun in library/sys.po (GH-11153)
https://github.com/python/cpython/commit/cb0f5e29e37c081e9bba91a9858370e2504e9e8e


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

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

From report at bugs.python.org  Fri Dec 14 06:29:02 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 14 Dec 2018 11:29:02 +0000
Subject: [docs] [issue35492] Missing colon on func statement in library/sys
 doc
In-Reply-To: <1544786555.59.0.788709270274.issue35492@psf.upfronthosting.co.za>
Message-ID: <1544786942.8.0.702299269573.issue35492@psf.upfronthosting.co.za>


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


----------
pull_requests: +10385

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

From report at bugs.python.org  Fri Dec 14 06:35:57 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 14 Dec 2018 11:35:57 +0000
Subject: [docs] [issue35492] Missing colon on func statement in library/sys
 doc
In-Reply-To: <1544786555.59.0.788709270274.issue35492@psf.upfronthosting.co.za>
Message-ID: <1544787357.07.0.788709270274.issue35492@psf.upfronthosting.co.za>


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


New changeset 527008599dca9377aa3e71da5e5068433ae2222e by Miss Islington (bot) in branch '3.7':
Fixed missing colun in library/sys.po (GH-11153)
https://github.com/python/cpython/commit/527008599dca9377aa3e71da5e5068433ae2222e


----------

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

From report at bugs.python.org  Fri Dec 14 15:28:55 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 14 Dec 2018 20:28:55 +0000
Subject: [docs] [issue35450] venv module doesn't create a copy of python
 binary by default
In-Reply-To: <1544378737.46.0.788709270274.issue35450@psf.upfronthosting.co.za>
Message-ID: <1544819335.88.0.788709270274.issue35450@psf.upfronthosting.co.za>


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


New changeset f5107dfd42121ef40b13eb678705802f0ff02cf9 by Miss Islington (bot) (mkkot) in branch 'master':
bpo-35450: reflect in docs that venv module is not always creating a ? (GH-11144)
https://github.com/python/cpython/commit/f5107dfd42121ef40b13eb678705802f0ff02cf9


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

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

From report at bugs.python.org  Fri Dec 14 15:29:14 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 14 Dec 2018 20:29:14 +0000
Subject: [docs] [issue35450] venv module doesn't create a copy of python
 binary by default
In-Reply-To: <1544378737.46.0.788709270274.issue35450@psf.upfronthosting.co.za>
Message-ID: <1544819354.04.0.702299269573.issue35450@psf.upfronthosting.co.za>


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


----------
pull_requests: +10404

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

From report at bugs.python.org  Fri Dec 14 15:29:26 2018
From: report at bugs.python.org (miss-islington)
Date: Fri, 14 Dec 2018 20:29:26 +0000
Subject: [docs] [issue35450] venv module doesn't create a copy of python
 binary by default
In-Reply-To: <1544378737.46.0.788709270274.issue35450@psf.upfronthosting.co.za>
Message-ID: <1544819366.35.0.702299269573.issue35450@psf.upfronthosting.co.za>


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


----------
pull_requests: +10405

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

From report at bugs.python.org  Fri Dec 14 15:37:47 2018
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 14 Dec 2018 20:37:47 +0000
Subject: [docs] [issue35450] venv module doesn't create a copy of python
 binary by default
In-Reply-To: <1544378737.46.0.788709270274.issue35450@psf.upfronthosting.co.za>
Message-ID: <1544819867.0.0.788709270274.issue35450@psf.upfronthosting.co.za>


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


New changeset 1fb312ce1f147ea84ecb6f5993a20d1a85c53dc3 by Brett Cannon (Miss Islington (bot)) in branch '3.6':
bpo-35450: reflect in docs that venv module is not always creating a copy of the Python binary (GH-11144) (GH-11168)
https://github.com/python/cpython/commit/1fb312ce1f147ea84ecb6f5993a20d1a85c53dc3


----------

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

From report at bugs.python.org  Fri Dec 14 15:38:25 2018
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 14 Dec 2018 20:38:25 +0000
Subject: [docs] [issue35450] venv module doesn't create a copy of python
 binary by default
In-Reply-To: <1544378737.46.0.788709270274.issue35450@psf.upfronthosting.co.za>
Message-ID: <1544819905.31.0.788709270274.issue35450@psf.upfronthosting.co.za>


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


New changeset d5176fe2bcd35dc8d70d13220b58fa7ccd05b47a by Brett Cannon (Miss Islington (bot)) in branch '3.7':
bpo-35450: reflect in docs that venv module is not always creating a copy of the Python binary (GH-11144) (GH-11167)
https://github.com/python/cpython/commit/d5176fe2bcd35dc8d70d13220b58fa7ccd05b47a


----------

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

From report at bugs.python.org  Fri Dec 14 15:44:19 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 14 Dec 2018 20:44:19 +0000
Subject: [docs] [issue35450] venv module doesn't create a copy of python
 binary by default
In-Reply-To: <1544378737.46.0.788709270274.issue35450@psf.upfronthosting.co.za>
Message-ID: <1544820258.96.0.788709270274.issue35450@psf.upfronthosting.co.za>


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

Close this?

----------
nosy: +terry.reedy
versions:  -Python 3.5

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

From report at bugs.python.org  Fri Dec 14 16:44:43 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 14 Dec 2018 21:44:43 +0000
Subject: [docs] [issue35472] python 3.7.2 rc1 bumped the build requirements
 for no reason
In-Reply-To: <1544632241.86.0.788709270274.issue35472@psf.upfronthosting.co.za>
Message-ID: <1544823883.18.0.788709270274.issue35472@psf.upfronthosting.co.za>


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

Should we add '(subject to change in any release)' after
# Require Sphinx 1.7 for build.

Matthias, I presume you are on some Linux. Would a script to temporarily change conf.py to build the docs work for you?

To be reasonably sure that 1.6.6 is sufficient for all translations on all systems that care, I would think it should be part of a .rc release first.

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

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

From report at bugs.python.org  Fri Dec 14 16:49:51 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 14 Dec 2018 21:49:51 +0000
Subject: [docs] [issue35482] python372rc1.chm is ill
In-Reply-To: <1544711642.5.0.788709270274.issue35482@psf.upfronthosting.co.za>
Message-ID: <1544824191.53.0.702299269573.issue35482@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Dec 14 16:55:42 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 14 Dec 2018 21:55:42 +0000
Subject: [docs] [issue35492] Missing colon on func statement in library/sys
 doc
In-Reply-To: <1544786555.59.0.788709270274.issue35492@psf.upfronthosting.co.za>
Message-ID: <1544824542.5.0.702299269573.issue35492@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/issue35492>
_______________________________________

From report at bugs.python.org  Fri Dec 14 17:41:01 2018
From: report at bugs.python.org (Marcin)
Date: Fri, 14 Dec 2018 22:41:01 +0000
Subject: [docs] [issue35450] venv module doesn't create a copy of python
 binary by default
In-Reply-To: <1544378737.46.0.788709270274.issue35450@psf.upfronthosting.co.za>
Message-ID: <1544827261.73.0.788709270274.issue35450@psf.upfronthosting.co.za>


Marcin <marcin2006 at gmail.com> added the comment:

Actually the documentation hasn't been regenerated yet. I hope it will over night?

----------

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

From report at bugs.python.org  Fri Dec 14 17:57:20 2018
From: report at bugs.python.org (Steve Dower)
Date: Fri, 14 Dec 2018 22:57:20 +0000
Subject: [docs] [issue35482] python372rc1.chm is ill
In-Reply-To: <1544711642.5.0.788709270274.issue35482@psf.upfronthosting.co.za>
Message-ID: <1544828240.83.0.788709270274.issue35482@psf.upfronthosting.co.za>


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

You're right, this is doing something weird on master as well.

I'll take a look when I get a chance, but if anyone else wants to dive in feel free.

In both cases, the doc file cannot be opened. Marking this as a release blocker and adding RM to the bug for awareness.

----------
nosy: +ned.deily
priority: normal -> release blocker
versions: +Python 3.8

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

From report at bugs.python.org  Fri Dec 14 20:38:24 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sat, 15 Dec 2018 01:38:24 +0000
Subject: [docs] [issue35506] Doc: fix keyword `as` link from `import` and
 `try`
Message-ID: <1544837904.07.0.788709270274.issue35506@psf.upfronthosting.co.za>


New submission from Cheryl Sabella <cheryl.sabella at gmail.com>:

In the documentation, using the :keyword:`as` role links to the `as` defined for the `with` statement, which could be confusing when it was used in the `import` or `try` section of the docs.

https://docs.python.org/3/reference/simple_stmts.html#the-import-statement

----------
assignee: docs at python
components: Documentation
messages: 331883
nosy: cheryl.sabella, docs at python
priority: normal
severity: normal
status: open
title: Doc: fix keyword `as` link from `import` and `try`
type: enhancement
versions: Python 3.8

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

From report at bugs.python.org  Fri Dec 14 20:42:30 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sat, 15 Dec 2018 01:42:30 +0000
Subject: [docs] [issue35506] Doc: fix keyword `as` link from `import` and
 `try`
In-Reply-To: <1544837904.07.0.788709270274.issue35506@psf.upfronthosting.co.za>
Message-ID: <1544838150.32.0.702299269573.issue35506@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Dec 14 23:28:32 2018
From: report at bugs.python.org (Ma Lin)
Date: Sat, 15 Dec 2018 04:28:32 +0000
Subject: [docs] [issue35482] can't open python368rc1.chm and python372rc1.chm
In-Reply-To: <1544711642.5.0.788709270274.issue35482@psf.upfronthosting.co.za>
Message-ID: <1544848112.72.0.788709270274.issue35482@psf.upfronthosting.co.za>


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

python368rc1.chm has the same problem.

I did a git bisect.
On 3.6 branch, e825b4e1a9bbe1d4c561f4cbbe6857653ef13a15 is the first bad commit
On 3.7 branch, 9a75b8470a2e0de5406edcabba140f023c99c6a9 is the first bad commit

----------
title: python372rc1.chm is ill -> can't open python368rc1.chm and python372rc1.chm
versions: +Python 3.6

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

From report at bugs.python.org  Fri Dec 14 23:43:48 2018
From: report at bugs.python.org (Ma Lin)
Date: Sat, 15 Dec 2018 04:43:48 +0000
Subject: [docs] [issue35482] can't open python368rc1.chm and python372rc1.chm
In-Reply-To: <1544711642.5.0.788709270274.issue35482@psf.upfronthosting.co.za>
Message-ID: <1544849028.14.0.788709270274.issue35482@psf.upfronthosting.co.za>


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

These first bad commits come from issue35054

----------

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

From report at bugs.python.org  Sat Dec 15 06:45:43 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 15 Dec 2018 11:45:43 +0000
Subject: [docs] [issue35506] Doc: fix keyword `as` link from `import` and
 `try`
In-Reply-To: <1544837904.07.0.788709270274.issue35506@psf.upfronthosting.co.za>
Message-ID: <1544874343.2.0.702299269573.issue35506@psf.upfronthosting.co.za>


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


----------
pull_requests: +10415

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

From report at bugs.python.org  Sat Dec 15 07:04:07 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 15 Dec 2018 12:04:07 +0000
Subject: [docs] [issue35506] Doc: fix keyword `as` link from `import` and
 `try`
In-Reply-To: <1544837904.07.0.788709270274.issue35506@psf.upfronthosting.co.za>
Message-ID: <1544875447.26.0.788709270274.issue35506@psf.upfronthosting.co.za>


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

I think links from "as" are not needed. They are just refer to the beginning of the same section. In all occurrences of "as" the corresponding "with", "import", or "try"/"except" keywords are mentioned too, and links from them refer to the correct section. I think it is better to remove links from "as" at all.

There are same issues with the "else" keyword which is used in the "if", "while", "for" and "try" statements and in the "if" expression. There are same issues with the "if" and "for" keyword in the context of comprehensions, with the "if" keyword in the context of the "if" expression, and with the "in" keyword in the context of "for".

The proposed PR removes redundant and incorrect links from keywords. It removes also redundant links if the same keyword is mentioned several times in the single paragraph (in same cases there were up to 5 links to the same target). It fixes also some other minor bugs.

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

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

From report at bugs.python.org  Sat Dec 15 08:49:17 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sat, 15 Dec 2018 13:49:17 +0000
Subject: [docs] [issue35450] venv module doesn't create a copy of python
 binary by default
In-Reply-To: <1544378737.46.0.788709270274.issue35450@psf.upfronthosting.co.za>
Message-ID: <1544881757.19.0.788709270274.issue35450@psf.upfronthosting.co.za>


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

It looks like the documentation has regenerated.  Thanks!

----------
nosy: +cheryl.sabella
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed

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

From report at bugs.python.org  Sun Dec 16 01:48:24 2018
From: report at bugs.python.org (bombs)
Date: Sun, 16 Dec 2018 06:48:24 +0000
Subject: [docs] [issue35511] Some methods of profile.Profile are not
 supported but the docs doesn't mention it.
Message-ID: <1544942903.87.0.788709270274.issue35511@psf.upfronthosting.co.za>


New submission from bombs <bluewhale8202 at gmail.com>:

Currently enable, disable methods are only supported by Profile class of cProfile module, not profile module. But the docs doesn't give this information. I think we should, at least mention it, in the docs.

----------
assignee: docs at python
components: Documentation
messages: 331917
nosy: asvetlov, bluewhale8202, docs at python
priority: normal
severity: normal
status: open
title: Some methods of profile.Profile are not supported but the docs doesn't mention it.
versions: Python 3.8

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

From report at bugs.python.org  Sun Dec 16 01:49:06 2018
From: report at bugs.python.org (bombs)
Date: Sun, 16 Dec 2018 06:49:06 +0000
Subject: [docs] [issue35511] Some methods of profile.Profile are not
 supported but the docs doesn't mention it.
In-Reply-To: <1544942903.87.0.788709270274.issue35511@psf.upfronthosting.co.za>
Message-ID: <1544942946.04.0.702299269573.issue35511@psf.upfronthosting.co.za>


Change by bombs <bluewhale8202 at gmail.com>:


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

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

From report at bugs.python.org  Sun Dec 16 01:54:02 2018
From: report at bugs.python.org (bombs)
Date: Sun, 16 Dec 2018 06:54:02 +0000
Subject: [docs] [issue35511] Some methods of profile.Profile are not
 supported but the docs doesn't mention it.
In-Reply-To: <1544942903.87.0.788709270274.issue35511@psf.upfronthosting.co.za>
Message-ID: <1544943242.4.0.788709270274.issue35511@psf.upfronthosting.co.za>


bombs <bluewhale8202 at gmail.com> added the comment:

To elaborate, the docs simply says "Both the profile and cProfile modules provide the following functions... enable(), disable(), create_stats() ..."

----------

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

From report at bugs.python.org  Sun Dec 16 06:34:46 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sun, 16 Dec 2018 11:34:46 +0000
Subject: [docs] [issue20164] Undocumented KeyError from os.path.expanduser
In-Reply-To: <1389111327.1.0.12442170212.issue20164@psf.upfronthosting.co.za>
Message-ID: <1544960086.02.0.788709270274.issue20164@psf.upfronthosting.co.za>


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

The behavior was changed in f2f4555d8287ad217a1dba7bbd93103ad4daf3a8 as a part of issue10496.

----------
nosy: +serhiy.storchaka, vstinner
status: open -> pending

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

From report at bugs.python.org  Sun Dec 16 14:34:12 2018
From: report at bugs.python.org (Andrew Svetlov)
Date: Sun, 16 Dec 2018 19:34:12 +0000
Subject: [docs] [issue35511] Some methods of profile.Profile are not
 supported but the docs doesn't mention it.
In-Reply-To: <1544942903.87.0.788709270274.issue35511@psf.upfronthosting.co.za>
Message-ID: <1544988852.54.0.788709270274.issue35511@psf.upfronthosting.co.za>


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


New changeset b912f9342e7a37d170ba659c13c959115c11545a by Andrew Svetlov (Beomsoo Kim) in branch 'master':
bpo-35511: Trivial docs updates for profile and resource library modules. (GH-11124)
https://github.com/python/cpython/commit/b912f9342e7a37d170ba659c13c959115c11545a


----------

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

From report at bugs.python.org  Sun Dec 16 14:57:12 2018
From: report at bugs.python.org (Andrew Svetlov)
Date: Sun, 16 Dec 2018 19:57:12 +0000
Subject: [docs] [issue35511] Some methods of profile.Profile are not
 supported but the docs doesn't mention it.
In-Reply-To: <1544942903.87.0.788709270274.issue35511@psf.upfronthosting.co.za>
Message-ID: <1544990232.4.0.702299269573.issue35511@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/issue35511>
_______________________________________

From report at bugs.python.org  Sun Dec 16 16:59:17 2018
From: report at bugs.python.org (STINNER Victor)
Date: Sun, 16 Dec 2018 21:59:17 +0000
Subject: [docs] [issue20164] Undocumented KeyError from os.path.expanduser
In-Reply-To: <1389111327.1.0.12442170212.issue20164@psf.upfronthosting.co.za>
Message-ID: <1544997557.8.0.788709270274.issue20164@psf.upfronthosting.co.za>


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

Even if it's not exactly a duplicate of bpo-10496, the reported bug has been fixed. I close the issue.

----------
resolution:  -> duplicate
stage: test needed -> resolved
status: pending -> closed
superseder:  -> Python startup should not require passwd entry

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

From report at bugs.python.org  Sun Dec 16 23:45:31 2018
From: report at bugs.python.org (bombs)
Date: Mon, 17 Dec 2018 04:45:31 +0000
Subject: [docs] [issue35514] Docs on reference count detail. enhancement.
Message-ID: <1545021931.75.0.788709270274.issue35514@psf.upfronthosting.co.za>


New submission from bombs <bluewhale8202 at gmail.com>:

https://docs.python.org/3/c-api/intro.html#reference-count-details

When I read that section of the docs first time, I found it hard to grasp what transferring of ownership is, which is an important and repeating concept throughout the docs. Some explanations were confusing. For example,

> When a function passes ownership of a reference on to its caller, the
> caller is said to receive a new reference

This part tries to explain what is to receive a new reference, in terms of passing ownership, when readers have no ideas of what transferring of ownership is. I think it is kind of a circular definition fallacy.

I think this section should've explained transferring of ownership, a high level concept, in terms of reference count changes, which are concrete operations.


(original version)
When a function passes ownership of a reference on to its caller, the caller is said to receive a new reference. When no ownership is transferred, the caller is said to borrow the reference. Nothing needs to be done for a borrowed reference.
Conversely, when a calling function passes in a reference to an object, there are two possibilities: the function steals a reference to the object, or it does not. Stealing a reference means that when you pass a reference to a function, that function assumes that it now owns that reference, and you are not responsible for it any longer.

(revision)
When a function returns an object and effectively increases the reference count of it, the function is said to give ownership of a new reference to its caller. When a function returns an object without changing the reference count of it, the caller is said to borrow the reference. Nothing needs to be done for a borrowed reference.
Conversely, if a function decreases the reference count of an object, it is said to steal the ownership of the reference from its owner. Stealing a reference means that when you pass a reference to a stealing function, that function assumes that it now owns that reference, and you are not responsible for it any longer.

----------
assignee: docs at python
components: Documentation
messages: 331946
nosy: bluewhale8202, docs at python
priority: normal
severity: normal
status: open
title: Docs on reference count detail. enhancement.
type: enhancement
versions: Python 3.8

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

From report at bugs.python.org  Mon Dec 17 06:13:29 2018
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 17 Dec 2018 11:13:29 +0000
Subject: [docs] [issue35276] Document thread safety
In-Reply-To: <1542628208.58.0.788709270274.issue35276@psf.upfronthosting.co.za>
Message-ID: <1545045209.32.0.788709270274.issue35276@psf.upfronthosting.co.za>


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

About system-wide: see also PR 11190, "time.monotonic() is now always available and always system-wide."

----------

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

From report at bugs.python.org  Mon Dec 17 06:17:32 2018
From: report at bugs.python.org (Julien Palard)
Date: Mon, 17 Dec 2018 11:17:32 +0000
Subject: [docs] [issue35472] python 3.7.2 rc1 bumped the build requirements
 for no reason
In-Reply-To: <1544632241.86.0.788709270274.issue35472@psf.upfronthosting.co.za>
Message-ID: <1545045452.16.0.788709270274.issue35472@psf.upfronthosting.co.za>


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

Hi Matthias,

I agree that for the smartquotes issue the 1.6.6 should be enough. But we had multiple small issues fixed in some versions of Sphinx. But mostly for translation and I don't think you're building the translations?

Also the needs_sphinx is only the minimum required version to build, it won't disallow me using sphinx 1.7 or 1.8 on docs.python.org to build the documentation.

The needs_sphinx flag only supports "micro" value since 1.4, but looks compatible with it before (04a8c26eabba3e728a5b74afd15f328f9235b2d0 in the sphinx repo).

So it looks OK to allow 1.6.6 as a minimum required version for 3.7, opening a PR on it.

----------

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

From report at bugs.python.org  Mon Dec 17 06:22:16 2018
From: report at bugs.python.org (Julien Palard)
Date: Mon, 17 Dec 2018 11:22:16 +0000
Subject: [docs] [issue35472] python 3.7.2 rc1 bumped the build requirements
 for no reason
In-Reply-To: <1544632241.86.0.788709270274.issue35472@psf.upfronthosting.co.za>
Message-ID: <1545045736.65.0.702299269573.issue35472@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Mon Dec 17 06:24:13 2018
From: report at bugs.python.org (Julien Palard)
Date: Mon, 17 Dec 2018 11:24:13 +0000
Subject: [docs] [issue35472] python 3.7.2 rc1 bumped sphinx requirements a
 bit too much
In-Reply-To: <1544632241.86.0.788709270274.issue35472@psf.upfronthosting.co.za>
Message-ID: <1545045853.44.0.702299269573.issue35472@psf.upfronthosting.co.za>


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


----------
title: python 3.7.2 rc1 bumped the build requirements for no reason -> python 3.7.2 rc1 bumped sphinx requirements a bit too much

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

From report at bugs.python.org  Mon Dec 17 10:30:06 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 17 Dec 2018 15:30:06 +0000
Subject: [docs] [issue35475] Docs do not show PyImport_AddModuleObject()
 returns a borrowed reference.
In-Reply-To: <1544641901.4.0.788709270274.issue35475@psf.upfronthosting.co.za>
Message-ID: <1545060606.01.0.788709270274.issue35475@psf.upfronthosting.co.za>


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


New changeset bdabb0737c631835b246c9823852d20331243315 by Serhiy Storchaka in branch 'master':
bpo-35475: Add more PyImport* functions in refcounts.dat. (GH-11142)
https://github.com/python/cpython/commit/bdabb0737c631835b246c9823852d20331243315


----------

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

From report at bugs.python.org  Mon Dec 17 10:30:20 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 17 Dec 2018 15:30:20 +0000
Subject: [docs] [issue35475] Docs do not show PyImport_AddModuleObject()
 returns a borrowed reference.
In-Reply-To: <1544641901.4.0.788709270274.issue35475@psf.upfronthosting.co.za>
Message-ID: <1545060620.86.0.702299269573.issue35475@psf.upfronthosting.co.za>


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


----------
pull_requests: +10437

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

From report at bugs.python.org  Mon Dec 17 10:30:36 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 17 Dec 2018 15:30:36 +0000
Subject: [docs] [issue35475] Docs do not show PyImport_AddModuleObject()
 returns a borrowed reference.
In-Reply-To: <1544641901.4.0.788709270274.issue35475@psf.upfronthosting.co.za>
Message-ID: <1545060636.44.0.702299269573.issue35475@psf.upfronthosting.co.za>


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


----------
pull_requests: +10438

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

From report at bugs.python.org  Mon Dec 17 10:48:31 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 17 Dec 2018 15:48:31 +0000
Subject: [docs] [issue35475] Docs do not show PyImport_AddModuleObject()
 returns a borrowed reference.
In-Reply-To: <1544641901.4.0.788709270274.issue35475@psf.upfronthosting.co.za>
Message-ID: <1545061711.53.0.788709270274.issue35475@psf.upfronthosting.co.za>


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


New changeset 605ef6e534f05925ff826f65518abf163ed3900a by Miss Islington (bot) in branch '3.7':
bpo-35475: Add more PyImport* functions in refcounts.dat. (GH-11142)
https://github.com/python/cpython/commit/605ef6e534f05925ff826f65518abf163ed3900a


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

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

From report at bugs.python.org  Mon Dec 17 19:31:46 2018
From: report at bugs.python.org (Steve Dower)
Date: Tue, 18 Dec 2018 00:31:46 +0000
Subject: [docs] [issue35482] can't open python368rc1.chm and python372rc1.chm
In-Reply-To: <1544711642.5.0.788709270274.issue35482@psf.upfronthosting.co.za>
Message-ID: <1545093106.63.0.788709270274.issue35482@psf.upfronthosting.co.za>


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

I did a quick look and couldn't find anything obvious in logs while building, so I guess the next step is to try taking out those new index entries to figure out which one causes the problem.

(Adding Serhiy for awareness, not necessarily trying to nominate him to do the work unless he wants to.)

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

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

From report at bugs.python.org  Tue Dec 18 00:26:30 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Tue, 18 Dec 2018 05:26:30 +0000
Subject: [docs] [issue35497] Libary select docs enhance
In-Reply-To: <1544804352.43.0.788709270274.issue35497@psf.upfronthosting.co.za>
Message-ID: <1545110790.16.0.702299269573.issue35497@psf.upfronthosting.co.za>


Change by Xiang Zhang <angwerzx at 126.com>:


----------
assignee:  -> docs at python
components: +Documentation -Library (Lib)
nosy: +docs at python, xiang.zhang
versions: +Python 3.8

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

From report at bugs.python.org  Tue Dec 18 01:05:24 2018
From: report at bugs.python.org (Ma Lin)
Date: Tue, 18 Dec 2018 06:05:24 +0000
Subject: [docs] [issue35482] can't open python368rc1.chm and python372rc1.chm
In-Reply-To: <1544711642.5.0.788709270274.issue35482@psf.upfronthosting.co.za>
Message-ID: <5C188E20.5E3BFF.24870@m50-138.163.com>


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

> I guess the next step is to try taking out those new index entries to figure out which one causes the problem.

Very big amount of work..., I would suggest to revert them.
chm is a successful product, but it out of support, and no replacement yet, it's regrettable.

----------

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

From Paul.Lowe at ADP.com  Mon Dec 17 17:37:23 2018
From: Paul.Lowe at ADP.com (Lowe, Paul (CORP))
Date: Mon, 17 Dec 2018 22:37:23 +0000
Subject: [docs] Python Documentation: Grammar Error in 'unittest'
 documentation: "associate -> associated"
Message-ID: <811FA051DD879246A0641815A7AA250A347D15@DC2PRMBX01A.ES.AD.ADP.com>

FYI:

https://docs.python.org/3/library/unittest.html

A test fixture represents the preparation needed to perform one or more tests, and any ***associated*** cleanup actions. This may involve, for example, creating temporary or proxy databases, directories, or starting a server process.

---------------------------------------------------------------------------------

unittest<https://docs.python.org/3/library/unittest.html#module-unittest> - Unit testing framework

Source code: Lib/unittest/__init__.py<https://github.com/python/cpython/tree/3.7/Lib/unittest/__init__.py>

________________________________

(If you are already familiar with the basic concepts of testing, you might want to skip to the list of assert methods<https://docs.python.org/3/library/unittest.html#assert-methods>.)

The unittest<https://docs.python.org/3/library/unittest.html#module-unittest> unit testing framework was originally inspired by JUnit and has a similar flavor as major unit testing frameworks in other languages. It supports test automation, sharing of setup and shutdown code for tests, aggregation of tests into collections, and independence of the tests from the reporting framework.

To achieve this, unittest<https://docs.python.org/3/library/unittest.html#module-unittest> supports some important concepts in an object-oriented way:
test fixture
A test fixture represents the preparation needed to perform one or more tests, and any ***associated*** cleanup actions. This may involve, for example, creating temporary or proxy databases, directories, or starting a server process.

----------------------------------------------------------------------
This message and any attachments are intended only for the use of the addressee and may contain information that is privileged and confidential. If the reader of the message is not the intended recipient or an authorized representative of the intended recipient, you are hereby notified that any dissemination of this communication is strictly prohibited. If you have received this communication in error, notify the sender immediately by return email and delete the message and any attachments from your system.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181217/c804c094/attachment.html>

From report at bugs.python.org  Tue Dec 18 05:51:11 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 18 Dec 2018 10:51:11 +0000
Subject: [docs] [issue35482] can't open python368rc1.chm and python372rc1.chm
In-Reply-To: <1544711642.5.0.788709270274.issue35482@psf.upfronthosting.co.za>
Message-ID: <1545130271.13.0.702299269573.issue35482@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Tue Dec 18 05:54:38 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 18 Dec 2018 10:54:38 +0000
Subject: [docs] [issue35482] can't open python368rc1.chm and python372rc1.chm
In-Reply-To: <1544711642.5.0.788709270274.issue35482@psf.upfronthosting.co.za>
Message-ID: <1545130478.36.0.788709270274.issue35482@psf.upfronthosting.co.za>


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

The breakage was caused by the index entry for ''' (triple single quote). After removing it a correct CHM file is created.

----------

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

From report at bugs.python.org  Tue Dec 18 06:06:17 2018
From: report at bugs.python.org (Ma Lin)
Date: Tue, 18 Dec 2018 11:06:17 +0000
Subject: [docs] [issue35482] can't open python368rc1.chm and python372rc1.chm
In-Reply-To: <1544711642.5.0.788709270274.issue35482@psf.upfronthosting.co.za>
Message-ID: <1545131177.5.0.788709270274.issue35482@psf.upfronthosting.co.za>


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

amazing, you did find it.

----------

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

From report at bugs.python.org  Tue Dec 18 06:57:19 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 18 Dec 2018 11:57:19 +0000
Subject: [docs] [issue35461] Document C API functions which swallow
 exceptions
In-Reply-To: <1544534848.15.0.788709270274.issue35461@psf.upfronthosting.co.za>
Message-ID: <1545134239.53.0.788709270274.issue35461@psf.upfronthosting.co.za>


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


New changeset 3fcc1e08db6fb7e17acc4a8f63be3e42f52f094b by Serhiy Storchaka in branch 'master':
bpo-35461: Document C API functions which suppress exceptions. (GH-11119)
https://github.com/python/cpython/commit/3fcc1e08db6fb7e17acc4a8f63be3e42f52f094b


----------

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

From report at bugs.python.org  Tue Dec 18 06:57:40 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 18 Dec 2018 11:57:40 +0000
Subject: [docs] [issue35461] Document C API functions which swallow
 exceptions
In-Reply-To: <1544534848.15.0.788709270274.issue35461@psf.upfronthosting.co.za>
Message-ID: <1545134260.85.0.702299269573.issue35461@psf.upfronthosting.co.za>


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


----------
pull_requests: +10446

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

From report at bugs.python.org  Tue Dec 18 06:57:47 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 18 Dec 2018 11:57:47 +0000
Subject: [docs] [issue35461] Document C API functions which swallow
 exceptions
In-Reply-To: <1544534848.15.0.788709270274.issue35461@psf.upfronthosting.co.za>
Message-ID: <1545134267.34.0.702299269573.issue35461@psf.upfronthosting.co.za>


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


----------
pull_requests: +10447

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

From report at bugs.python.org  Tue Dec 18 07:15:02 2018
From: report at bugs.python.org (Jules Lasne)
Date: Tue, 18 Dec 2018 12:15:02 +0000
Subject: [docs] [issue35524] using/windows launcher image might be deprecated
Message-ID: <1545135302.84.0.788709270274.issue35524@psf.upfronthosting.co.za>


New submission from Jules Lasne <jules.lasne at gmail.com>:

https://docs.python.org/3/_images/win_installer.png

This image corresponds to the Python 3.5 installer. Would it be useful to get a new screenshot of the latest installer ?

I can do it if needed

----------
assignee: docs at python
components: Documentation
messages: 332055
nosy: docs at python, seluj78
priority: normal
severity: normal
status: open
title: using/windows launcher image might be deprecated
type: enhancement
versions: Python 3.7

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

From report at bugs.python.org  Tue Dec 18 07:20:56 2018
From: report at bugs.python.org (Jules Lasne)
Date: Tue, 18 Dec 2018 12:20:56 +0000
Subject: [docs] [issue35524] using/windows launcher image might be deprecated
In-Reply-To: <1545135302.84.0.788709270274.issue35524@psf.upfronthosting.co.za>
Message-ID: <1545135656.26.0.788709270274.issue35524@psf.upfronthosting.co.za>


Jules Lasne <jules.lasne at gmail.com> added the comment:

There is also a conflict between the image and the text:

Under `Selecting a custom install`, a line says
```
To perform an all-users installation, you should select ?Customize installation?. In this case:
```

But the screenshot of the installer shows that you can select an option on the main menu to install for all users.

What should be done about this conflict ? I cannot currently run the latest installer on Windows but will be able to tonight or tomorrow to check it if no one did before.

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

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

From report at bugs.python.org  Tue Dec 18 10:28:06 2018
From: report at bugs.python.org (Colin McPhail)
Date: Tue, 18 Dec 2018 15:28:06 +0000
Subject: [docs] [issue35525] Incorrect keyword name in NNTP.starttls()
 documentation
Message-ID: <1545146886.62.0.788709270274.issue35525@psf.upfronthosting.co.za>


New submission from Colin McPhail <colin.mcphail at mac.com>:

The library documentation for nntplib.NNTP.starttls() says that it takes a keyword parameter called ssl_context. The source code referenced via the link at the top of the nntplib documentation shows the keyword is actually called context. The result is a TypeError if the documented name is used:
    TypeError: starttls() got an unexpected keyword argument 'ssl_context'

----------
assignee: docs at python
components: Documentation
messages: 332066
nosy: cmcp22, docs at python
priority: normal
severity: normal
status: open
title: Incorrect keyword name in NNTP.starttls() documentation
versions: Python 3.7

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

From report at bugs.python.org  Tue Dec 18 11:41:48 2018
From: report at bugs.python.org (Zachary Ware)
Date: Tue, 18 Dec 2018 16:41:48 +0000
Subject: [docs] [issue35524] using/windows launcher image might be deprecated
In-Reply-To: <1545135302.84.0.788709270274.issue35524@psf.upfronthosting.co.za>
Message-ID: <1545151308.43.0.702299269573.issue35524@psf.upfronthosting.co.za>


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


----------
assignee: docs at python -> steve.dower
components: +Windows
nosy: +paul.moore, steve.dower, tim.golden, zach.ware

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

From report at bugs.python.org  Tue Dec 18 13:14:47 2018
From: report at bugs.python.org (Steve Dower)
Date: Tue, 18 Dec 2018 18:14:47 +0000
Subject: [docs] [issue35524] using/windows launcher image might be deprecated
In-Reply-To: <1545135302.84.0.788709270274.issue35524@psf.upfronthosting.co.za>
Message-ID: <1545156886.84.0.788709270274.issue35524@psf.upfronthosting.co.za>


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

That option is only for the py.exe launcher and not the whole installation (notice the target path is still under C:\Users).

Having an updated image would be fine, though the only difference should be the version number. If you can provide a similar sized image of the 3.7 installer (screen scaling at 100%) then I'll add the drop shadow, cover the username and update the docs.

----------

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

From report at bugs.python.org  Tue Dec 18 15:24:43 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 18 Dec 2018 20:24:43 +0000
Subject: [docs] [issue35461] Document C API functions which swallow
 exceptions
In-Reply-To: <1544534848.15.0.788709270274.issue35461@psf.upfronthosting.co.za>
Message-ID: <1545164683.22.0.788709270274.issue35461@psf.upfronthosting.co.za>


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


New changeset f265afec1c2a5acb8cb9c9ddb6cd45f7465c6eb5 by Miss Islington (bot) in branch '3.7':
bpo-35461: Document C API functions which suppress exceptions. (GH-11119)
https://github.com/python/cpython/commit/f265afec1c2a5acb8cb9c9ddb6cd45f7465c6eb5


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

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

From crusarovid at gmail.com  Tue Dec 18 16:20:54 2018
From: crusarovid at gmail.com (Ovidiu Durbalau)
Date: Tue, 18 Dec 2018 13:20:54 -0800
Subject: [docs] Bug in documentation
Message-ID: <CAFKeqk4TnNuWyvODv=7XCwnj-oH=06vDBaGdu944SS4Vz_A9LQ@mail.gmail.com>

In the following page:

https://docs.python.org/3.5/howto/regex.html#matching-characters



The following 2 paragraphs are contradictory:



Metacharacters are not active inside classes. For example, [akm$] will
match any of the characters 'a', 'k', 'm', or '$'; '$' is usually a
metacharacter, but inside a character class it?s stripped of its special
nature.

You can match the characters not listed within the class by *complementing* the
set. This is indicated by including a '^' as the first character of the
class; '^' outside a character class will simply match the '^'character. For
example, [^5] will match any character except '5'.

The first paragraph says metacharacters are not active inside character
classes.

The second paragraph shows an example of a metacharacter in a character
class having some ?special nature?. In the example, it is treated as the
inverse or complement.

-- 
Ovidiu Durbalau


Software Developer | Houle <http://www.houle.ca>
Computing Science Major | Simon Fraser University <http://sfu.ca>
604 754 9116 | LinkedIn
<http://ca.linkedin.com/pub/ovidiu-durbalau/5b/709/463> | Twitter
<https://twitter.com/divodurbalau>| Facebook
<https://www.facebook.com/crusarovid>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181218/09dc4676/attachment.html>

From report at bugs.python.org  Tue Dec 18 16:31:37 2018
From: report at bugs.python.org (Yury Selivanov)
Date: Tue, 18 Dec 2018 21:31:37 +0000
Subject: [docs] [issue35465] [asyncio] Document loop.add_signal_handler
In-Reply-To: <1544556093.28.0.788709270274.issue35465@psf.upfronthosting.co.za>
Message-ID: <1545168697.05.0.788709270274.issue35465@psf.upfronthosting.co.za>


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


New changeset e3666fc8effb05b555121f4ab7388df59e21f8b4 by Yury Selivanov (Hrvoje Nik?i?) in branch 'master':
bpo-35465: Document _UnixSelectorEventLoop.add_signal_handler. (GH-11145)
https://github.com/python/cpython/commit/e3666fc8effb05b555121f4ab7388df59e21f8b4


----------

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

From report at bugs.python.org  Tue Dec 18 16:31:41 2018
From: report at bugs.python.org (miss-islington)
Date: Tue, 18 Dec 2018 21:31:41 +0000
Subject: [docs] [issue35465] [asyncio] Document loop.add_signal_handler
In-Reply-To: <1544556093.28.0.788709270274.issue35465@psf.upfronthosting.co.za>
Message-ID: <1545168701.63.0.702299269573.issue35465@psf.upfronthosting.co.za>


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


----------
pull_requests: +10456

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

From report at bugs.python.org  Tue Dec 18 16:32:49 2018
From: report at bugs.python.org (Yury Selivanov)
Date: Tue, 18 Dec 2018 21:32:49 +0000
Subject: [docs] [issue35465] [asyncio] Document loop.add_signal_handler
In-Reply-To: <1544556093.28.0.788709270274.issue35465@psf.upfronthosting.co.za>
Message-ID: <1545168769.06.0.702299269573.issue35465@psf.upfronthosting.co.za>


Change by Yury Selivanov <yselivanov at gmail.com>:


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

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

From report at bugs.python.org  Tue Dec 18 16:40:38 2018
From: report at bugs.python.org (ChrisRands)
Date: Tue, 18 Dec 2018 21:40:38 +0000
Subject: [docs] [issue34764] Improve documentation example for using iter()
 with sentinel value
In-Reply-To: <1537544491.72.0.956365154283.issue34764@psf.upfronthosting.co.za>
Message-ID: <1545169238.11.0.702299269573.issue34764@psf.upfronthosting.co.za>


Change by ChrisRands <chrisrands0 at gmail.com>:


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

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

From report at bugs.python.org  Tue Dec 18 16:47:20 2018
From: report at bugs.python.org (Steve Dower)
Date: Tue, 18 Dec 2018 21:47:20 +0000
Subject: [docs] [issue35482] can't open python368rc1.chm and python372rc1.chm
In-Reply-To: <1544711642.5.0.788709270274.issue35482@psf.upfronthosting.co.za>
Message-ID: <1545169640.13.0.788709270274.issue35482@psf.upfronthosting.co.za>


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

It looks like generally the &#x27; entity does not work in the CHM index - there should be b' and u' entries as well, but they show up as b and u (whereas b" and u" are fine).

Substituting &#39; seems to work fine, but I had to do that manually in the hhk file and then rebuild the hhp directly. I'm not sure the best way to integrate it into our entire build process is.

----------

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

From report at bugs.python.org  Tue Dec 18 16:52:40 2018
From: report at bugs.python.org (Yury Selivanov)
Date: Tue, 18 Dec 2018 21:52:40 +0000
Subject: [docs] [issue35465] [asyncio] Document loop.add_signal_handler
In-Reply-To: <1544556093.28.0.788709270274.issue35465@psf.upfronthosting.co.za>
Message-ID: <1545169960.67.0.788709270274.issue35465@psf.upfronthosting.co.za>


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


New changeset 12f3979b3807b448ca070b44bbc1597cf800f8a4 by Yury Selivanov (Miss Islington (bot)) in branch '3.7':
bpo-35465: Document _UnixSelectorEventLoop.add_signal_handler. (GH-11145) (GH-11221)
https://github.com/python/cpython/commit/12f3979b3807b448ca070b44bbc1597cf800f8a4


----------

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

From report at bugs.python.org  Tue Dec 18 17:04:03 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 18 Dec 2018 22:04:03 +0000
Subject: [docs] [issue35482] can't open python368rc1.chm and python372rc1.chm
In-Reply-To: <1544711642.5.0.788709270274.issue35482@psf.upfronthosting.co.za>
Message-ID: <1545170643.72.0.788709270274.issue35482@psf.upfronthosting.co.za>


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

I think this is a Sphinx bug. It should work around limitations of the CHM compiler.

----------

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

From report at bugs.python.org  Tue Dec 18 17:15:46 2018
From: report at bugs.python.org (Steve Dower)
Date: Tue, 18 Dec 2018 22:15:46 +0000
Subject: [docs] [issue35482] can't open python368rc1.chm and python372rc1.chm
In-Reply-To: <1544711642.5.0.788709270274.issue35482@psf.upfronthosting.co.za>
Message-ID: <1545171346.21.0.788709270274.issue35482@psf.upfronthosting.co.za>


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

I've got an alternate PR to do the fixup in an extension, as well as fixing two other minor build problems for docs (on Windows).

----------

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

From report at bugs.python.org  Tue Dec 18 17:16:17 2018
From: report at bugs.python.org (Steve Dower)
Date: Tue, 18 Dec 2018 22:16:17 +0000
Subject: [docs] [issue35482] can't open python368rc1.chm and python372rc1.chm
In-Reply-To: <1544711642.5.0.788709270274.issue35482@psf.upfronthosting.co.za>
Message-ID: <1545171377.5.0.702299269573.issue35482@psf.upfronthosting.co.za>


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


----------
pull_requests: +10459

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

From report at bugs.python.org  Tue Dec 18 17:34:32 2018
From: report at bugs.python.org (jfbu)
Date: Tue, 18 Dec 2018 22:34:32 +0000
Subject: [docs] [issue35528] [DOC] [LaTeX] Sphinx 2.0 uses GNU FreeFont as
 default for xelatex
Message-ID: <1545172472.78.0.788709270274.issue35528@psf.upfronthosting.co.za>


New submission from jfbu <jfbu at free.fr>:

Not sure if any issue at all, but as said in title, starting with Sphinx 2.0 (Spring 2019), XeLaTeX will be configured to use by default GNU FreeFont, (see https://github.com/sphinx-doc/sphinx/blob/master/CHANGES), and this means new dependency (for documentation builds on Ubuntu, package fonts-freefont-otf; for builds on Fedora 29 it is texlive-gnu-freefont).  Indeed currently CPython PDFs are built using ``xelatex``.

----------
assignee: docs at python
components: Documentation
messages: 332092
nosy: docs at python, jfbu
priority: normal
severity: normal
status: open
title: [DOC] [LaTeX] Sphinx 2.0 uses GNU FreeFont as default for xelatex

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

From report at bugs.python.org  Tue Dec 18 22:00:55 2018
From: report at bugs.python.org (Ma Lin)
Date: Wed, 19 Dec 2018 03:00:55 +0000
Subject: [docs] [issue35482] can't open python368rc1.chm and python372rc1.chm
In-Reply-To: <1544711642.5.0.788709270274.issue35482@psf.upfronthosting.co.za>
Message-ID: <1545188454.99.0.788709270274.issue35482@psf.upfronthosting.co.za>


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

&#x27; comes from html.escape(s, quote=True)
https://github.com/python/cpython/blob/4a9ee26750aa8cb37b5072b2bb4dd328819febb4/Lib/html/__init__.py#L24
Of course, it's not a bug.

It would be better to patch in Sphinx, I will do it at some point.

----------

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

From report at bugs.python.org  Wed Dec 19 01:09:48 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 19 Dec 2018 06:09:48 +0000
Subject: [docs] [issue35506] Doc: fix keyword `as` link from `import` and
 `try`
In-Reply-To: <1544837904.07.0.788709270274.issue35506@psf.upfronthosting.co.za>
Message-ID: <1545199788.41.0.788709270274.issue35506@psf.upfronthosting.co.za>


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


New changeset 2b57c43f21f891df4c6f2294a3b9e1b9029a16b6 by Serhiy Storchaka in branch 'master':
bpo-35506: Remove redundant and incorrect links from keywords. (GH-11174)
https://github.com/python/cpython/commit/2b57c43f21f891df4c6f2294a3b9e1b9029a16b6


----------

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

From report at bugs.python.org  Wed Dec 19 01:14:45 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 19 Dec 2018 06:14:45 +0000
Subject: [docs] [issue35506] Doc: fix keyword `as` link from `import` and
 `try`
In-Reply-To: <1544837904.07.0.788709270274.issue35506@psf.upfronthosting.co.za>
Message-ID: <1545200085.79.0.702299269573.issue35506@psf.upfronthosting.co.za>


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


----------
pull_requests: +10466

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

From report at bugs.python.org  Wed Dec 19 02:28:16 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 19 Dec 2018 07:28:16 +0000
Subject: [docs] [issue35506] Doc: fix keyword `as` link from `import` and
 `try`
In-Reply-To: <1544837904.07.0.788709270274.issue35506@psf.upfronthosting.co.za>
Message-ID: <1545204496.24.0.788709270274.issue35506@psf.upfronthosting.co.za>


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


New changeset 1e47fbcf78c4d66fbe1fc7b4ea91a6b147ff83d2 by Serhiy Storchaka in branch '3.7':
[3.7] bpo-35506: Remove redundant and incorrect links from keywords. (GH-11174). (GH-11232)
https://github.com/python/cpython/commit/1e47fbcf78c4d66fbe1fc7b4ea91a6b147ff83d2


----------

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

From report at bugs.python.org  Wed Dec 19 02:28:48 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 19 Dec 2018 07:28:48 +0000
Subject: [docs] [issue35506] Doc: fix keyword `as` link from `import` and
 `try`
In-Reply-To: <1544837904.07.0.788709270274.issue35506@psf.upfronthosting.co.za>
Message-ID: <1545204528.59.0.702299269573.issue35506@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Wed Dec 19 04:24:15 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 19 Dec 2018 09:24:15 +0000
Subject: [docs] [issue35461] Document C API functions which swallow
 exceptions
In-Reply-To: <1544534848.15.0.788709270274.issue35461@psf.upfronthosting.co.za>
Message-ID: <1545211455.06.0.788709270274.issue35461@psf.upfronthosting.co.za>


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

There are too much differences in the C API and the documentation between 3.x and 2.7, so backporting to 2.7 is not practical.

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

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

From report at bugs.python.org  Wed Dec 19 04:27:20 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 19 Dec 2018 09:27:20 +0000
Subject: [docs] [issue35475] Docs do not show PyImport_AddModuleObject()
 returns a borrowed reference.
In-Reply-To: <1544641901.4.0.788709270274.issue35475@psf.upfronthosting.co.za>
Message-ID: <1545211640.48.0.702299269573.issue35475@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/issue35475>
_______________________________________

From report at bugs.python.org  Wed Dec 19 05:14:59 2018
From: report at bugs.python.org (Julien Palard)
Date: Wed, 19 Dec 2018 10:14:59 +0000
Subject: [docs] [issue35472] python 3.7.2 rc1 bumped sphinx requirements a
 bit too much
In-Reply-To: <1544632241.86.0.788709270274.issue35472@psf.upfronthosting.co.za>
Message-ID: <1545214499.37.0.788709270274.issue35472@psf.upfronthosting.co.za>


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


New changeset a9ed8fcdbaeccdb82593525b170fb0544202eeda by Julien Palard in branch '3.7':
bpo-35472: Doc: For Python 3.7 Sphinx 1.6.6 is enough. (GH-11192)
https://github.com/python/cpython/commit/a9ed8fcdbaeccdb82593525b170fb0544202eeda


----------

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

From report at bugs.python.org  Wed Dec 19 05:18:01 2018
From: report at bugs.python.org (Julien Palard)
Date: Wed, 19 Dec 2018 10:18:01 +0000
Subject: [docs] [issue35472] python 3.7.2 rc1 bumped sphinx requirements a
 bit too much
In-Reply-To: <1544632241.86.0.788709270274.issue35472@psf.upfronthosting.co.za>
Message-ID: <1545214681.85.0.788709270274.issue35472@psf.upfronthosting.co.za>


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

Matthias, I downgraded the needs_sphinx to 1.6.6, as it does not disallow me to use an up-to-date sphinx in the doc server I'm ok with this.

Hope it helps.

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

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

From report at bugs.python.org  Wed Dec 19 05:48:39 2018
From: report at bugs.python.org (Jules Lasne)
Date: Wed, 19 Dec 2018 10:48:39 +0000
Subject: [docs] [issue35524] using/windows launcher image might be deprecated
In-Reply-To: <1545135302.84.0.788709270274.issue35524@psf.upfronthosting.co.za>
Message-ID: <1545216519.16.0.788709270274.issue35524@psf.upfronthosting.co.za>


Jules Lasne <jules.lasne at gmail.com> added the comment:

Here is the image, it should be the same size (by a few pixels).

Oddly enough, I couldn't get the bottom part to unfold and I can't figure out why

----------
Added file: https://bugs.python.org/file48005/win_install_python.png

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

From report at bugs.python.org  Wed Dec 19 06:47:10 2018
From: report at bugs.python.org (Philip Rowlands)
Date: Wed, 19 Dec 2018 11:47:10 +0000
Subject: [docs] [issue35533] argparse standard error usage for exit / error
Message-ID: <1545220030.92.0.788709270274.issue35533@psf.upfronthosting.co.za>


New submission from Philip Rowlands <pythonbugs at dimebar.com>:

Because error() mentions standard error and exit() does not, I assumed exit() did not use stderr, but it does.

Please mention standard error in the description of exit().

Relevant code at:
https://github.com/python/cpython/blob/3.7/Lib/argparse.py#L2482

----------
assignee: docs at python
components: Documentation
messages: 332128
nosy: docs at python, philiprowlands
priority: normal
severity: normal
status: open
title: argparse standard error usage for exit / error
type: enhancement
versions: Python 3.7

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

From report at bugs.python.org  Wed Dec 19 06:59:56 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Wed, 19 Dec 2018 11:59:56 +0000
Subject: [docs] [issue35497] Libary select docs enhance
In-Reply-To: <1544804352.43.0.788709270274.issue35497@psf.upfronthosting.co.za>
Message-ID: <1545220795.87.0.788709270274.issue35497@psf.upfronthosting.co.za>


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


New changeset 92330c0b6d6c253c41a133cc50caea4853c7e311 by Xiang Zhang (Manjusaka) in branch 'master':
bpo-35497: add versionadded tag for EPOLLEXCLUSIVE (GH-11162)
https://github.com/python/cpython/commit/92330c0b6d6c253c41a133cc50caea4853c7e311


----------

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

From report at bugs.python.org  Wed Dec 19 07:00:04 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 19 Dec 2018 12:00:04 +0000
Subject: [docs] [issue35497] Libary select docs enhance
In-Reply-To: <1544804352.43.0.788709270274.issue35497@psf.upfronthosting.co.za>
Message-ID: <1545220804.14.0.702299269573.issue35497@psf.upfronthosting.co.za>


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


----------
pull_requests: +10469

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

From report at bugs.python.org  Wed Dec 19 07:05:52 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 19 Dec 2018 12:05:52 +0000
Subject: [docs] [issue35497] Libary select docs enhance
In-Reply-To: <1544804352.43.0.788709270274.issue35497@psf.upfronthosting.co.za>
Message-ID: <1545221152.27.0.788709270274.issue35497@psf.upfronthosting.co.za>


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


New changeset a11d44056e4f9b64d28efec295e1c1c45d4cb9e1 by Miss Islington (bot) in branch '3.7':
bpo-35497: add versionadded tag for EPOLLEXCLUSIVE (GH-11162)
https://github.com/python/cpython/commit/a11d44056e4f9b64d28efec295e1c1c45d4cb9e1


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

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

From report at bugs.python.org  Wed Dec 19 07:06:44 2018
From: report at bugs.python.org (Xiang Zhang)
Date: Wed, 19 Dec 2018 12:06:44 +0000
Subject: [docs] [issue35497] Libary select docs enhance
In-Reply-To: <1544804352.43.0.788709270274.issue35497@psf.upfronthosting.co.za>
Message-ID: <1545221204.85.0.702299269573.issue35497@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/issue35497>
_______________________________________

From anatoli at rainforce.org  Wed Dec 19 07:53:45 2018
From: anatoli at rainforce.org (Anatoli Babenia)
Date: Wed, 19 Dec 2018 15:53:45 +0300
Subject: [docs] Disconnected HTTPConnection and HTTPResponse docs
Message-ID: <CAK=cShjNyn_=7gwWd95EgW7ROHvKGPjkX9UhAUEu4LxF3nMXJw@mail.gmail.com>

Hello.

Found this email in documentation page.

It is hard to find parameters for HTTPResponse, because texts
describing its parameters are separated by differen documentaion
block and are not linked together.
https://docs.python.org/3/library/http.client.html#http.client.HTTPResponse
https://docs.python.org/3/library/http.client.html#httpresponse-objects

The same is true for HTTPConnection.
https://docs.python.org/3/library/http.client.html#http.client.HTTPConnection
https://docs.python.org/3/library/http.client.html#httpconnection-objects

-- 
Anatoli Babenia

+1 (650) 605-3365
+375 (29) 320-4241
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181219/23d1f051/attachment-0001.html>

From report at bugs.python.org  Wed Dec 19 09:01:24 2018
From: report at bugs.python.org (Steve Dower)
Date: Wed, 19 Dec 2018 14:01:24 +0000
Subject: [docs] [issue35524] using/windows launcher image might be deprecated
In-Reply-To: <1545135302.84.0.788709270274.issue35524@psf.upfronthosting.co.za>
Message-ID: <1545228084.39.0.788709270274.issue35524@psf.upfronthosting.co.za>


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

It looks like display scaling, which you'll need to disable for this. The UI for the installer is slightly aware of scaling, but not enough to resize multiline elements automatically.

----------

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

From report at bugs.python.org  Wed Dec 19 09:11:26 2018
From: report at bugs.python.org (Jules Lasne)
Date: Wed, 19 Dec 2018 14:11:26 +0000
Subject: [docs] [issue35524] using/windows launcher image might be deprecated
In-Reply-To: <1545135302.84.0.788709270274.issue35524@psf.upfronthosting.co.za>
Message-ID: <1545228686.65.0.788709270274.issue35524@psf.upfronthosting.co.za>


Jules Lasne <jules.lasne at gmail.com> added the comment:

Here it is again, with display scaling disabled ! :)

----------
Added file: https://bugs.python.org/file48007/Screenshot_2.png

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

From report at bugs.python.org  Wed Dec 19 11:23:37 2018
From: report at bugs.python.org (Petr Viktorin)
Date: Wed, 19 Dec 2018 16:23:37 +0000
Subject: [docs] [issue35420] how to migrate a c-extension module to one that
 supports subinerpreters?
In-Reply-To: <1544037399.3.0.788709270274.issue35420@psf.upfronthosting.co.za>
Message-ID: <1545236617.63.0.788709270274.issue35420@psf.upfronthosting.co.za>


Petr Viktorin <encukou at gmail.com> added the comment:

Hi (and sorry for the delay -- it's a busy time of year).

Unfortunately, there's no good documentation yet. Python's standard library itself is not free of global state, and I don't think we want to start documenting before that's fixed.

----------

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

From report at bugs.python.org  Wed Dec 19 12:02:23 2018
From: report at bugs.python.org (Mathew M.)
Date: Wed, 19 Dec 2018 17:02:23 +0000
Subject: [docs] [issue32077] Documentation: Some Unicode object functions
 don't indicate whether they return a new reference
In-Reply-To: <1511136014.35.0.213398074469.issue32077@psf.upfronthosting.co.za>
Message-ID: <1545238943.33.0.702299269573.issue32077@psf.upfronthosting.co.za>


Change by Mathew M. <mathew1800 at gmail.com>:


----------
pull_requests: +10473

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

From report at bugs.python.org  Wed Dec 19 12:19:36 2018
From: report at bugs.python.org (Lew Kurtz)
Date: Wed, 19 Dec 2018 17:19:36 +0000
Subject: [docs] [issue33460] "..." is used to confusingly indicate many
 different things in chapter 3
In-Reply-To: <1525995197.73.0.682650639539.issue33460@psf.upfronthosting.co.za>
Message-ID: <1545239976.25.0.788709270274.issue33460@psf.upfronthosting.co.za>


Lew Kurtz <lew.kurtz at icloud.com> added the comment:

Removed the ellipses from the examples, so not confused with continuation prompt. Is clearer now.

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

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

From report at bugs.python.org  Wed Dec 19 14:13:25 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 19 Dec 2018 19:13:25 +0000
Subject: [docs] [issue32077] Documentation: Some Unicode object functions
 don't indicate whether they return a new reference
In-Reply-To: <1511136014.35.0.213398074469.issue32077@psf.upfronthosting.co.za>
Message-ID: <1545246805.59.0.788709270274.issue32077@psf.upfronthosting.co.za>


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


New changeset b2f642ccd2f65d2f3bf77bbaa103dd2bc2733734 by Serhiy Storchaka (Mat M) in branch 'master':
bpo-32077: Update refcounts.dat for Unicode object functions. (GH-11243)
https://github.com/python/cpython/commit/b2f642ccd2f65d2f3bf77bbaa103dd2bc2733734


----------

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

From report at bugs.python.org  Wed Dec 19 14:13:27 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 19 Dec 2018 19:13:27 +0000
Subject: [docs] [issue32077] Documentation: Some Unicode object functions
 don't indicate whether they return a new reference
In-Reply-To: <1511136014.35.0.213398074469.issue32077@psf.upfronthosting.co.za>
Message-ID: <1545246807.92.0.702299269573.issue32077@psf.upfronthosting.co.za>


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


----------
pull_requests: +10474

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

From report at bugs.python.org  Wed Dec 19 14:13:33 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 19 Dec 2018 19:13:33 +0000
Subject: [docs] [issue32077] Documentation: Some Unicode object functions
 don't indicate whether they return a new reference
In-Reply-To: <1511136014.35.0.213398074469.issue32077@psf.upfronthosting.co.za>
Message-ID: <1545246813.38.0.702299269573.issue32077@psf.upfronthosting.co.za>


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


----------
pull_requests: +10475

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

From report at bugs.python.org  Wed Dec 19 15:01:46 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 19 Dec 2018 20:01:46 +0000
Subject: [docs] [issue18085] Verifying refcounts.dat
In-Reply-To: <1369768958.38.0.697954786488.issue18085@psf.upfronthosting.co.za>
Message-ID: <1545249703.74.0.702299269573.issue18085@psf.upfronthosting.co.za>


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


----------
pull_requests: +10476
stage:  -> patch review

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

From report at bugs.python.org  Wed Dec 19 15:01:48 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 19 Dec 2018 20:01:48 +0000
Subject: [docs] [issue18085] Verifying refcounts.dat
In-Reply-To: <1369768958.38.0.697954786488.issue18085@psf.upfronthosting.co.za>
Message-ID: <1545249707.65.0.702299269573.issue18085@psf.upfronthosting.co.za>


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


----------
pull_requests: +10476, 10477
stage:  -> patch review

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

From report at bugs.python.org  Wed Dec 19 15:01:51 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 19 Dec 2018 20:01:51 +0000
Subject: [docs] [issue18085] Verifying refcounts.dat
In-Reply-To: <1369768958.38.0.697954786488.issue18085@psf.upfronthosting.co.za>
Message-ID: <1545249710.23.0.702299269573.issue18085@psf.upfronthosting.co.za>


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


----------
pull_requests: +10476, 10477, 10478
stage:  -> patch review

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

From report at bugs.python.org  Wed Dec 19 15:03:25 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 19 Dec 2018 20:03:25 +0000
Subject: [docs] [issue32077] Documentation: Some Unicode object functions
 don't indicate whether they return a new reference
In-Reply-To: <1511136014.35.0.213398074469.issue32077@psf.upfronthosting.co.za>
Message-ID: <1545249805.72.0.788709270274.issue32077@psf.upfronthosting.co.za>


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


New changeset 29d4e309b1b4dfb26d65d83c683002911c066dec by Miss Islington (bot) in branch '3.7':
bpo-32077: Update refcounts.dat for Unicode object functions. (GH-11243)
https://github.com/python/cpython/commit/29d4e309b1b4dfb26d65d83c683002911c066dec


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

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

From report at bugs.python.org  Wed Dec 19 15:13:43 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 19 Dec 2018 20:13:43 +0000
Subject: [docs] [issue32077] Documentation: Some Unicode object functions
 don't indicate whether they return a new reference
In-Reply-To: <1511136014.35.0.213398074469.issue32077@psf.upfronthosting.co.za>
Message-ID: <1545250422.43.0.788709270274.issue32077@psf.upfronthosting.co.za>


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

Sorry, I forget about this issue and remembered it only after creating similar patch from scratch. PR 11247 is what left from it after merging your patch.

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

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

From report at bugs.python.org  Wed Dec 19 15:23:07 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 19 Dec 2018 20:23:07 +0000
Subject: [docs] [issue18085] Verifying refcounts.dat
In-Reply-To: <1369768958.38.0.697954786488.issue18085@psf.upfronthosting.co.za>
Message-ID: <1545250985.29.0.702299269573.issue18085@psf.upfronthosting.co.za>


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


----------
pull_requests:  -10477

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

From report at bugs.python.org  Wed Dec 19 15:23:22 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 19 Dec 2018 20:23:22 +0000
Subject: [docs] [issue18085] Verifying refcounts.dat
In-Reply-To: <1369768958.38.0.697954786488.issue18085@psf.upfronthosting.co.za>
Message-ID: <1545251000.31.0.702299269573.issue18085@psf.upfronthosting.co.za>


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


----------
pull_requests:  -10478

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

From report at bugs.python.org  Wed Dec 19 15:25:01 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 19 Dec 2018 20:25:01 +0000
Subject: [docs] [issue18085] Verifying refcounts.dat
In-Reply-To: <1369768958.38.0.697954786488.issue18085@psf.upfronthosting.co.za>
Message-ID: <1545251097.17.0.788709270274.issue18085@psf.upfronthosting.co.za>


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

PR 11247 adds more functions and fixes some errors.

----------

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

From report at bugs.python.org  Wed Dec 19 17:23:37 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Wed, 19 Dec 2018 22:23:37 +0000
Subject: [docs] [issue17972] inspect module docs omits many functions
In-Reply-To: <1368501068.91.0.677640111487.issue17972@psf.upfronthosting.co.za>
Message-ID: <1545258214.58.0.788709270274.issue17972@psf.upfronthosting.co.za>


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

issue12317 discusses inspect.getabsfile()

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

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

From report at bugs.python.org  Thu Dec 20 02:34:00 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 20 Dec 2018 07:34:00 +0000
Subject: [docs] [issue18085] Verifying refcounts.dat
In-Reply-To: <1369768958.38.0.697954786488.issue18085@psf.upfronthosting.co.za>
Message-ID: <1545291240.34.0.788709270274.issue18085@psf.upfronthosting.co.za>


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


New changeset 83dd4e87a62311cfea5fdd37e8a945b6b07bccee by Serhiy Storchaka in branch 'master':
bpo-18085: Update refcounts.dat. (GH-11247)
https://github.com/python/cpython/commit/83dd4e87a62311cfea5fdd37e8a945b6b07bccee


----------

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

From report at bugs.python.org  Thu Dec 20 02:34:10 2018
From: report at bugs.python.org (miss-islington)
Date: Thu, 20 Dec 2018 07:34:10 +0000
Subject: [docs] [issue18085] Verifying refcounts.dat
In-Reply-To: <1369768958.38.0.697954786488.issue18085@psf.upfronthosting.co.za>
Message-ID: <1545291250.3.0.702299269573.issue18085@psf.upfronthosting.co.za>


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


----------
pull_requests: +10487

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

From report at bugs.python.org  Thu Dec 20 02:43:29 2018
From: report at bugs.python.org (miss-islington)
Date: Thu, 20 Dec 2018 07:43:29 +0000
Subject: [docs] [issue18085] Verifying refcounts.dat
In-Reply-To: <1369768958.38.0.697954786488.issue18085@psf.upfronthosting.co.za>
Message-ID: <1545291809.7.0.788709270274.issue18085@psf.upfronthosting.co.za>


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


New changeset 73fc14d1f8441aef5ee03be627c63e74a6d915d6 by Miss Islington (bot) in branch '3.7':
bpo-18085: Update refcounts.dat. (GH-11247)
https://github.com/python/cpython/commit/73fc14d1f8441aef5ee03be627c63e74a6d915d6


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

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

From report at bugs.python.org  Thu Dec 20 03:14:48 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 20 Dec 2018 08:14:48 +0000
Subject: [docs] [issue18085] Verifying refcounts.dat
In-Reply-To: <1369768958.38.0.697954786488.issue18085@psf.upfronthosting.co.za>
Message-ID: <1545293688.26.0.702299269573.issue18085@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Dec 20 08:54:16 2018
From: report at bugs.python.org (Windson Yang)
Date: Thu, 20 Dec 2018 13:54: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: <1545314056.17.0.702299269573.issue35105@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Dec 20 12:27:14 2018
From: report at bugs.python.org (miss-islington)
Date: Thu, 20 Dec 2018 17:27:14 +0000
Subject: [docs] [issue35482] can't open python368rc1.chm and python372rc1.chm
In-Reply-To: <1544711642.5.0.788709270274.issue35482@psf.upfronthosting.co.za>
Message-ID: <1545326834.6.0.702299269573.issue35482@psf.upfronthosting.co.za>


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


----------
pull_requests: +10499

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

From report at bugs.python.org  Thu Dec 20 12:27:18 2018
From: report at bugs.python.org (miss-islington)
Date: Thu, 20 Dec 2018 17:27:18 +0000
Subject: [docs] [issue35482] can't open python368rc1.chm and python372rc1.chm
In-Reply-To: <1544711642.5.0.788709270274.issue35482@psf.upfronthosting.co.za>
Message-ID: <1545326838.55.0.788709270274.issue35482@psf.upfronthosting.co.za>


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


New changeset aae2e85af772a409bf8904bddc17efe9bf809174 by Miss Islington (bot) in branch '3.7':
bpo-35482: Fixes HTML escaping in CHM index and build location of NEWS file (GH-11224)
https://github.com/python/cpython/commit/aae2e85af772a409bf8904bddc17efe9bf809174


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

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

From report at bugs.python.org  Thu Dec 20 14:07:15 2018
From: report at bugs.python.org (Steve Dower)
Date: Thu, 20 Dec 2018 19:07:15 +0000
Subject: [docs] [issue35482] can't open python368rc1.chm and python372rc1.chm
In-Reply-To: <1544711642.5.0.788709270274.issue35482@psf.upfronthosting.co.za>
Message-ID: <1545332835.48.0.702299269573.issue35482@psf.upfronthosting.co.za>


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


----------
pull_requests: +10501

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

From report at bugs.python.org  Thu Dec 20 14:09:27 2018
From: report at bugs.python.org (Steve Dower)
Date: Thu, 20 Dec 2018 19:09:27 +0000
Subject: [docs] [issue35482] can't open python368rc1.chm and python372rc1.chm
In-Reply-To: <1544711642.5.0.788709270274.issue35482@psf.upfronthosting.co.za>
Message-ID: <1545332967.29.0.788709270274.issue35482@psf.upfronthosting.co.za>


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

The 3.6 PR is blocked from merging, so looking to Ned to resolve.

----------

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

From report at bugs.python.org  Thu Dec 20 14:11:53 2018
From: report at bugs.python.org (Ned Deily)
Date: Thu, 20 Dec 2018 19:11:53 +0000
Subject: [docs] [issue35482] can't open python368rc1.chm and python372rc1.chm
In-Reply-To: <1544711642.5.0.788709270274.issue35482@psf.upfronthosting.co.za>
Message-ID: <1545333113.91.0.788709270274.issue35482@psf.upfronthosting.co.za>


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


New changeset 789b0ee023f14385a2fd635272768c3b55a99773 by Ned Deily (Steve Dower) in branch '3.6':
bpo-35482: Fixes HTML escaping in CHM index and build location of NEWS file (GH-11224) (GH-11251)
https://github.com/python/cpython/commit/789b0ee023f14385a2fd635272768c3b55a99773


----------

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

From report at bugs.python.org  Thu Dec 20 15:48:16 2018
From: report at bugs.python.org (Steve Dower)
Date: Thu, 20 Dec 2018 20:48:16 +0000
Subject: [docs] [issue35482] can't open python368rc1.chm and python372rc1.chm
In-Reply-To: <1544711642.5.0.788709270274.issue35482@psf.upfronthosting.co.za>
Message-ID: <1545338896.92.0.702299269573.issue35482@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/issue35482>
_______________________________________

From report at bugs.python.org  Thu Dec 20 15:50:02 2018
From: report at bugs.python.org (Ned Deily)
Date: Thu, 20 Dec 2018 20:50:02 +0000
Subject: [docs] [issue35475] Docs do not show PyImport_AddModuleObject()
 returns a borrowed reference.
In-Reply-To: <1544641901.4.0.788709270274.issue35475@psf.upfronthosting.co.za>
Message-ID: <1545339002.3.0.788709270274.issue35475@psf.upfronthosting.co.za>


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


New changeset 75f187478603de33c15f501a947207bfe8ba833f by Ned Deily (Miss Islington (bot)) in branch '3.6':
bpo-35475: Add more PyImport* functions in refcounts.dat. (GH-11142) (GH-11199)
https://github.com/python/cpython/commit/75f187478603de33c15f501a947207bfe8ba833f


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

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

From report at bugs.python.org  Thu Dec 20 16:28:33 2018
From: report at bugs.python.org (Ned Deily)
Date: Thu, 20 Dec 2018 21:28:33 +0000
Subject: [docs] [issue35461] Document C API functions which swallow
 exceptions
In-Reply-To: <1544534848.15.0.788709270274.issue35461@psf.upfronthosting.co.za>
Message-ID: <1545341312.96.0.788709270274.issue35461@psf.upfronthosting.co.za>


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


New changeset ff740db42326082fac7d415ae9aff148628a83ed by Ned Deily (Miss Islington (bot)) in branch '3.6':
bpo-35461: Document C API functions which suppress exceptions. (GH-11119) (GH-11210)
https://github.com/python/cpython/commit/ff740db42326082fac7d415ae9aff148628a83ed


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

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

From eldadcohenil at gmail.com  Fri Dec 21 05:40:48 2018
From: eldadcohenil at gmail.com (Eldad Cohen)
Date: Fri, 21 Dec 2018 12:40:48 +0200
Subject: [docs] Source - Doc
Message-ID: <CABCkxgosU5R778ctdCH8Fw0BLgzKTk04B5gWiDbYA024FhR0uw@mail.gmail.com>

Hi,

Is it possible to get documentation source . In order to built it in our
env ?
I want to create the site on our offline server.

Thanks
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181221/43b34fbd/attachment.html>

From julien at palard.fr  Fri Dec 21 06:46:38 2018
From: julien at palard.fr (Julien Palard)
Date: Fri, 21 Dec 2018 11:46:38 +0000
Subject: [docs] Source - Doc
In-Reply-To: <CABCkxgosU5R778ctdCH8Fw0BLgzKTk04B5gWiDbYA024FhR0uw@mail.gmail.com>
References: <CABCkxgosU5R778ctdCH8Fw0BLgzKTk04B5gWiDbYA024FhR0uw@mail.gmail.com>
Message-ID: <g3PpKHv18iu_psn1SVwANUWT0SG3bNvcFy24jOwISRLPkFUbKoS5sAimMw41dDjypEu7ZSJwf47v_K1xRT7d6Jalk-cj5i1_CiZVOC8pOLc=@palard.fr>

Hi,

> Is it possible to get documentation source . In order to built it in our env ?
> I want to create the site on our offline server.

Yes, the sources are in the Doc/ directory of https://github.com/python/cpython/

The translations (po files) can be found in http://github.com/python/python-docs-fr, http://github.com/python/python-docs-ja, http://github.com/python/python-docs-ko.

You can build them locally by following this documentation: https://devguide.python.org/documenting/#building-the-documentation

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


From cpython at roundup.psfhosted.org  Fri Dec 21 10:38:07 2018
From: cpython at roundup.psfhosted.org (STINNER Victor)
Date: Fri, 21 Dec 2018 15:38:07 +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: <1545406683.93.0.443784625336.issue34172@roundup.psfhosted.org>


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

multiprocessing.Pool destructor now emits a ResourceWarning if it is still running: if .close() nor .terminate() have been called, see bpo- 35424.

It is a first alarm that the problematic example is wrong.

Should reconsider to fix this bug in the master branch? If yes, we should carefully document this backward incompatible change.

----------

______________________________________________
Python tracker <cpython at roundup.psfhosted.org>
<https://bugs.python.org/issue34172>
______________________________________________

From cpython at roundup.psfhosted.org  Fri Dec 21 16:46:32 2018
From: cpython at roundup.psfhosted.org (Terry J. Reedy)
Date: Fri, 21 Dec 2018 21:46:32 +0000
Subject: [docs] [issue35533] argparse standard error usage for exit / error
In-Reply-To: <1545220030.92.0.788709270274.issue35533@psf.upfronthosting.co.za>
Message-ID: <1545428792.98.0.479531316528.issue35533@roundup.psfhosted.org>


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


----------
nosy: +bethard
versions: +Python 3.8

______________________________________________
Python tracker <cpython at roundup.psfhosted.org>
<https://bugs.python.org/issue35533>
______________________________________________

From cpython at roundup.psfhosted.org  Fri Dec 21 16:44:15 2018
From: cpython at roundup.psfhosted.org (Terry J. Reedy)
Date: Fri, 21 Dec 2018 21:44:15 +0000
Subject: [docs] [issue35514] Docs on reference count detail. enhancement.
In-Reply-To: <1545021931.75.0.788709270274.issue35514@psf.upfronthosting.co.za>
Message-ID: <1545428653.96.0.479531316528.issue35514@roundup.psfhosted.org>


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


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

______________________________________________
Python tracker <cpython at roundup.psfhosted.org>
<https://bugs.python.org/issue35514>
______________________________________________

From report at bugs.python.org  Sat Dec 22 03:32:47 2018
From: report at bugs.python.org (Antti Haapala)
Date: Sat, 22 Dec 2018 08:32:47 +0000
Subject: [docs] [issue13927] Extra spaces in the output of time.ctime
In-Reply-To: <1328215776.48.0.974828105123.issue13927@psf.upfronthosting.co.za>
Message-ID: <1545467564.16.0.98272194251.issue13927@roundup.psfhosted.org>


Antti Haapala <antti at haapala.name> added the comment:

This should be added to `asctime` too.

The space-padded behaviour complies with the C standard which was the intent - after all, before it was using C `asctime` directly, and says that unlike C asctime, it doesn't have the newline character, meaning that as a rule, it should then behave similar to it, and only exception is marked.

Unfortunately MSVC asctime has been incorrectly using leading zeros (https://stackoverflow.com/q/53894148/918959).

----------
nosy: +ztane

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

From report at bugs.python.org  Sat Dec 22 13:33:34 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sat, 22 Dec 2018 18:33:34 +0000
Subject: [docs] [issue35563] Doc: warnings.rst - add links to references
Message-ID: <1545503608.31.0.0770528567349.issue35563@roundup.psfhosted.org>


New submission from Cheryl Sabella <cheryl.sabella at gmail.com>:

In the docs for the warnings module, there is some text referencing other areas of the documentation that would be more helpful as links.

----------
assignee: docs at python
components: Documentation
messages: 332362
nosy: cheryl.sabella, docs at python
priority: normal
severity: normal
status: open
title: Doc: warnings.rst - add links to references
versions: Python 3.8

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

From report at bugs.python.org  Sat Dec 22 14:04:34 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sat, 22 Dec 2018 19:04:34 +0000
Subject: [docs] [issue35563] Doc: warnings.rst - add links to references
In-Reply-To: <1545503608.31.0.0770528567349.issue35563@roundup.psfhosted.org>
Message-ID: <1545505471.15.0.0770528567349.issue35563@roundup.psfhosted.org>


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

I created a pull request for this, but it didn't attach it:
https://github.com/python/cpython/pull/11289

----------

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

From report at bugs.python.org  Sat Dec 22 14:24:30 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Sat, 22 Dec 2018 19:24:30 +0000
Subject: [docs] [issue35563] Doc: warnings.rst - add links to references
In-Reply-To: <1545503608.31.0.0770528567349.issue35563@roundup.psfhosted.org>
Message-ID: <1545506668.06.0.76008791178.issue35563@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Sat Dec 22 14:29:54 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sat, 22 Dec 2018 19:29:54 +0000
Subject: [docs] [issue35563] Doc: warnings.rst - add links to references
In-Reply-To: <1545503608.31.0.0770528567349.issue35563@roundup.psfhosted.org>
Message-ID: <1545506991.22.0.0770528567349.issue35563@roundup.psfhosted.org>


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

@xtreak, thanks for adding the PR link.  I was going to ask you how to do it, but I see it now.  Completely missed it before.

----------

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

From report at bugs.python.org  Sat Dec 22 14:38:21 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Sat, 22 Dec 2018 19:38:21 +0000
Subject: [docs] [issue35563] Doc: warnings.rst - add links to references
In-Reply-To: <1545503608.31.0.0770528567349.issue35563@roundup.psfhosted.org>
Message-ID: <1545507497.24.0.0770528567349.issue35563@roundup.psfhosted.org>


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

@cheryl.sabella You're welcome. PR was not automatically added to couple of my issues too today though the PR description and issue number check was updated by bedevere-bot. I don't know if it's a random issue.

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

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

From report at bugs.python.org  Sat Dec 22 14:43:37 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sat, 22 Dec 2018 19:43:37 +0000
Subject: [docs] [issue35563] Doc: warnings.rst - add links to references
In-Reply-To: <1545503608.31.0.0770528567349.issue35563@roundup.psfhosted.org>
Message-ID: <1545507812.9.0.0770528567349.issue35563@roundup.psfhosted.org>


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

@xtreak, maybe it's related to the maintenance Ernest did yesterday on the bugs.python.org server?  Not sure the best way to ping him.

----------

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

From report at bugs.python.org  Sat Dec 22 15:39:50 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Sat, 22 Dec 2018 20:39:50 +0000
Subject: [docs] [issue35563] Doc: warnings.rst - add links to references
In-Reply-To: <1545503608.31.0.0770528567349.issue35563@roundup.psfhosted.org>
Message-ID: <1545511188.19.0.0770528567349.issue35563@roundup.psfhosted.org>


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

You can bring this up at https://python.zulipchat.com/#narrow/stream/116501-workflow and someone might help.

----------

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

From report at bugs.python.org  Sat Dec 22 16:24:14 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sat, 22 Dec 2018 21:24:14 +0000
Subject: [docs] [issue35514] Docs on reference count detail. enhancement.
In-Reply-To: <1545021931.75.0.788709270274.issue35514@psf.upfronthosting.co.za>
Message-ID: <1545513853.09.0.76008791178.issue35514@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Sat Dec 22 16:30:01 2018
From: report at bugs.python.org (jfbu)
Date: Sat, 22 Dec 2018 21:30:01 +0000
Subject: [docs] [issue35564] [DOC] Sphinx 2.0 will require master_doc
 variable set in conf.py
Message-ID: <1545514198.61.0.0770528567349.issue35564@roundup.psfhosted.org>


New submission from jfbu <jfbu at free.fr>:

When building CPython doc with master branch of dev repo of Sphinx (future Sphinx 2.0) one gets this warning:

WARNING: Since v2.0, Sphinx uses "index" as master_doc by default. Please add "master_doc = 'contents'" to your conf.py.

Fix will be to do as Sphinx says :)

----------
assignee: docs at python
components: Documentation
messages: 332371
nosy: docs at python, jfbu
priority: normal
severity: normal
status: open
title: [DOC] Sphinx 2.0 will require master_doc variable set in conf.py

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

From report at bugs.python.org  Sat Dec 22 20:23:15 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 23 Dec 2018 01:23:15 +0000
Subject: [docs] [issue35566] DOC: Add links to annotation glossary term
Message-ID: <1545528192.75.0.0770528567349.issue35566@roundup.psfhosted.org>


New submission from Cheryl Sabella <cheryl.sabella at gmail.com>:

Add links to glossary term when `annotation` is used.

----------
assignee: docs at python
components: Documentation
messages: 332379
nosy: cheryl.sabella, docs at python
priority: normal
severity: normal
status: open
title: DOC: Add links to annotation glossary term
type: enhancement
versions: Python 3.8

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

From report at bugs.python.org  Sat Dec 22 20:26:21 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 23 Dec 2018 01:26:21 +0000
Subject: [docs] [issue35566] DOC: Add links to annotation glossary term
In-Reply-To: <1545528192.75.0.0770528567349.issue35566@roundup.psfhosted.org>
Message-ID: <1545528379.88.0.76008791178.issue35566@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Sun Dec 23 05:52:08 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Sun, 23 Dec 2018 10:52:08 +0000
Subject: [docs] [issue35564] [DOC] Sphinx 2.0 will require master_doc
 variable set in conf.py
In-Reply-To: <1545514198.61.0.0770528567349.issue35564@roundup.psfhosted.org>
Message-ID: <1545562328.19.0.76008791178.issue35564@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Sun Dec 23 06:51:09 2018
From: report at bugs.python.org (jfbu)
Date: Sun, 23 Dec 2018 11:51:09 +0000
Subject: [docs] [issue35564] [DOC] Sphinx 2.0 will require master_doc
 variable set in conf.py
In-Reply-To: <1545514198.61.0.0770528567349.issue35564@roundup.psfhosted.org>
Message-ID: <1545565868.76.0.0770528567349.issue35564@roundup.psfhosted.org>


jfbu <jfbu at free.fr> added the comment:

GitHub PR #11290 has been merged into master

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

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

From report at bugs.python.org  Sun Dec 23 06:53:58 2018
From: report at bugs.python.org (jfbu)
Date: Sun, 23 Dec 2018 11:53:58 +0000
Subject: [docs] [issue35564] [DOC] Sphinx 2.0 will require master_doc
 variable set in conf.py
In-Reply-To: <1545514198.61.0.0770528567349.issue35564@roundup.psfhosted.org>
Message-ID: <1545566038.13.0.76008791178.issue35564@roundup.psfhosted.org>


Change by jfbu <jfbu at free.fr>:


----------
pull_requests:  -10524

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

From report at bugs.python.org  Sun Dec 23 06:57:17 2018
From: report at bugs.python.org (jfbu)
Date: Sun, 23 Dec 2018 11:57:17 +0000
Subject: [docs] [issue35564] [DOC] Sphinx 2.0 will require master_doc
 variable set in conf.py
In-Reply-To: <1545514198.61.0.0770528567349.issue35564@roundup.psfhosted.org>
Message-ID: <1545566235.31.0.0770528567349.issue35564@roundup.psfhosted.org>


jfbu <jfbu at free.fr> added the comment:

sorry for previous message whose text mentioned the GitHub pull request number but this links to bpo issue of that number, of course completely unrelated

----------
pull_requests: +10525

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

From report at bugs.python.org  Mon Dec 24 00:19:15 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 24 Dec 2018 05:19:15 +0000
Subject: [docs] [issue35566] DOC: Add links to annotation glossary term
In-Reply-To: <1545528192.75.0.0770528567349.issue35566@roundup.psfhosted.org>
Message-ID: <1545628753.24.0.76008791178.issue35566@roundup.psfhosted.org>


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

From report at bugs.python.org  Mon Dec 24 00:20:55 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 24 Dec 2018 05:20:55 +0000
Subject: [docs] [issue34764] Improve documentation example for using iter()
 with sentinel value
In-Reply-To: <1537544491.72.0.956365154283.issue34764@psf.upfronthosting.co.za>
Message-ID: <1545628853.67.0.76008791178.issue34764@roundup.psfhosted.org>


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

From report at bugs.python.org  Mon Dec 24 02:42:15 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 24 Dec 2018 07:42:15 +0000
Subject: [docs] [issue35105] Document that CPython accepts "invalid"
 identifiers
In-Reply-To: <1540815891.13.0.788709270274.issue35105@psf.upfronthosting.co.za>
Message-ID: <1545637331.58.0.0770528567349.issue35105@roundup.psfhosted.org>


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

I don't think we can mark this as an implementation detail for setattr(). The details are downstream and determined by the target object, not by setattr() itself.

Suggested wording:

'''
Note, setattr() attempts to update the object with the given attr/value pair.
Whether this succeeds and what its affect is is determined by the target object.
If an object's class defines `__slots__`, the attribute may not be writeable.
If an object's class defines property with a setter method, the *setattr()*
will trigger the setter method which may or may not actually write the attribute.
For objects that have a regular dictionary (which is the typical case), the
*setattr()* call can make any string keyed update allowed by the dictionary
including keys that aren't valid identifiers -- for example setattr(a, '1', 'one')
will be the equivalent of vars()['1'] ='one'.
This issue has little to do with setattr() and is more related to the fact that instance dictionaries can hold any valid key. In a way, it is no different than a user writing a.__dict__['1'] = 'one'. That has always been allowed and the __dict__ attribute is documented as writeable, so a user is also allowed to write `a.dict = {'1': 'one'}.
'''

In short, we can talk about this in the setattr() docs but it isn't really a setattr() issue. Also, the behavior is effectively guaranteed by the other things users are allowed to do, so there is no merit in marking this as an implementation detail. Non-identifier keys can make it into an instance dictionary via multiple paths that are guaranteed to work.

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

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

From report at bugs.python.org  Mon Dec 24 02:47:57 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 24 Dec 2018 07:47:57 +0000
Subject: [docs] [issue32070] Clarify the behavior of the staticmethod builtin
In-Reply-To: <1511028255.0.0.213398074469.issue32070@psf.upfronthosting.co.za>
Message-ID: <1545637677.89.0.76008791178.issue32070@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Mon Dec 24 02:59:41 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 24 Dec 2018 07:59:41 +0000
Subject: [docs] [issue29886] links between binascii.{un, }hexlify / bytes.{,
 to}hex
In-Reply-To: <1490282084.27.0.505150099985.issue29886@psf.upfronthosting.co.za>
Message-ID: <1545638378.96.0.0770528567349.issue29886@roundup.psfhosted.org>


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

This is a reasonable suggestion.  Will apply the patch shortly.

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

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

From report at bugs.python.org  Mon Dec 24 03:02:37 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 24 Dec 2018 08:02:37 +0000
Subject: [docs] [issue35105] Document that CPython accepts "invalid"
 identifiers
In-Reply-To: <1540815891.13.0.788709270274.issue35105@psf.upfronthosting.co.za>
Message-ID: <1545638554.95.0.0770528567349.issue35105@roundup.psfhosted.org>


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

FWIW, the only restriction added by setattr() is that *name* must be a string.

----------

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

From report at bugs.python.org  Mon Dec 24 04:07:19 2018
From: report at bugs.python.org (Harmandeep Singh)
Date: Mon, 24 Dec 2018 09:07:19 +0000
Subject: [docs] [issue13927] Extra spaces in the output of time.ctime
In-Reply-To: <1328215776.48.0.974828105123.issue13927@psf.upfronthosting.co.za>
Message-ID: <1545642435.86.0.0770528567349.issue13927@roundup.psfhosted.org>


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

I have created the PR as mentioned, I have added the example for time.ctime() and also added the note to time.asctime.

----------
pull_requests: +10527
stage:  -> patch review
versions: +Python 3.4, Python 3.5, Python 3.6, Python 3.7, Python 3.8

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

From report at bugs.python.org  Mon Dec 24 08:15:46 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 24 Dec 2018 13:15:46 +0000
Subject: [docs] [issue33830] Error in the output of one example in the
 httplib docs
In-Reply-To: <1528713903.44.0.592728768989.issue33830@psf.upfronthosting.co.za>
Message-ID: <1545657343.29.0.712150888896.issue33830@roundup.psfhosted.org>


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


New changeset f0af4c54e32d963e1ccbac005bcbcab1913e051f by Serhiy Storchaka (Xtreak) in branch 'master':
bpo-33830: Fix an example in http.client docs for 404. (GH-7780)
https://github.com/python/cpython/commit/f0af4c54e32d963e1ccbac005bcbcab1913e051f


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

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

From report at bugs.python.org  Mon Dec 24 08:16:39 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 24 Dec 2018 13:16:39 +0000
Subject: [docs] [issue33830] Error in the output of one example in the
 httplib docs
In-Reply-To: <1528713903.44.0.592728768989.issue33830@psf.upfronthosting.co.za>
Message-ID: <1545657396.49.0.712150888896.issue33830@roundup.psfhosted.org>


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


New changeset f0af4c54e32d963e1ccbac005bcbcab1913e051f by Serhiy Storchaka (Xtreak) in branch 'master':
bpo-33830: Fix an example in http.client docs for 404. (GH-7780)
https://github.com/python/cpython/commit/f0af4c54e32d963e1ccbac005bcbcab1913e051f


----------

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

From report at bugs.python.org  Mon Dec 24 08:16:59 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 24 Dec 2018 13:16:59 +0000
Subject: [docs] [issue33830] Error in the output of one example in the
 httplib docs
In-Reply-To: <1528713903.44.0.592728768989.issue33830@psf.upfronthosting.co.za>
Message-ID: <1545657417.38.0.712150888896.issue33830@roundup.psfhosted.org>


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


New changeset f0af4c54e32d963e1ccbac005bcbcab1913e051f by Serhiy Storchaka (Xtreak) in branch 'master':
bpo-33830: Fix an example in http.client docs for 404. (GH-7780)
https://github.com/python/cpython/commit/f0af4c54e32d963e1ccbac005bcbcab1913e051f


----------

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

From report at bugs.python.org  Mon Dec 24 08:17:18 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 24 Dec 2018 13:17:18 +0000
Subject: [docs] [issue33830] Error in the output of one example in the
 httplib docs
In-Reply-To: <1528713903.44.0.592728768989.issue33830@psf.upfronthosting.co.za>
Message-ID: <1545657436.42.0.556460119503.issue33830@roundup.psfhosted.org>


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


----------
pull_requests: +10528

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

From report at bugs.python.org  Mon Dec 24 08:25:06 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 24 Dec 2018 13:25:06 +0000
Subject: [docs] [issue33830] Error in the output of one example in the
 httplib docs
In-Reply-To: <1528713903.44.0.592728768989.issue33830@psf.upfronthosting.co.za>
Message-ID: <1545657903.25.0.712150888896.issue33830@roundup.psfhosted.org>


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


New changeset 26ab036098cc0f9e884ef87894f064268a24da0f by Miss Islington (bot) in branch '3.7':
bpo-33830: Fix an example in http.client docs for 404. (GH-7780)
https://github.com/python/cpython/commit/26ab036098cc0f9e884ef87894f064268a24da0f


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

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

From report at bugs.python.org  Mon Dec 24 08:25:24 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 24 Dec 2018 13:25:24 +0000
Subject: [docs] [issue33830] Error in the output of one example in the
 httplib docs
In-Reply-To: <1528713903.44.0.592728768989.issue33830@psf.upfronthosting.co.za>
Message-ID: <1545657922.0.0.712150888896.issue33830@roundup.psfhosted.org>


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


New changeset 26ab036098cc0f9e884ef87894f064268a24da0f by Miss Islington (bot) in branch '3.7':
bpo-33830: Fix an example in http.client docs for 404. (GH-7780)
https://github.com/python/cpython/commit/26ab036098cc0f9e884ef87894f064268a24da0f


----------

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

From report at bugs.python.org  Mon Dec 24 08:25:42 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 24 Dec 2018 13:25:42 +0000
Subject: [docs] [issue33830] Error in the output of one example in the
 httplib docs
In-Reply-To: <1528713903.44.0.592728768989.issue33830@psf.upfronthosting.co.za>
Message-ID: <1545657939.02.0.712150888896.issue33830@roundup.psfhosted.org>


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


New changeset 26ab036098cc0f9e884ef87894f064268a24da0f by Miss Islington (bot) in branch '3.7':
bpo-33830: Fix an example in http.client docs for 404. (GH-7780)
https://github.com/python/cpython/commit/26ab036098cc0f9e884ef87894f064268a24da0f


----------

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

From report at bugs.python.org  Mon Dec 24 08:26:13 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 24 Dec 2018 13:26:13 +0000
Subject: [docs] [issue33830] Error in the output of one example in the
 httplib docs
In-Reply-To: <1528713903.44.0.592728768989.issue33830@psf.upfronthosting.co.za>
Message-ID: <1545657972.01.0.712150888896.issue33830@roundup.psfhosted.org>


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


New changeset 26ab036098cc0f9e884ef87894f064268a24da0f by Miss Islington (bot) in branch '3.7':
bpo-33830: Fix an example in http.client docs for 404. (GH-7780)
https://github.com/python/cpython/commit/26ab036098cc0f9e884ef87894f064268a24da0f


----------

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

From report at bugs.python.org  Mon Dec 24 08:26:32 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 24 Dec 2018 13:26:32 +0000
Subject: [docs] [issue33830] Error in the output of one example in the
 httplib docs
In-Reply-To: <1528713903.44.0.592728768989.issue33830@psf.upfronthosting.co.za>
Message-ID: <1545657990.71.0.712150888896.issue33830@roundup.psfhosted.org>


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


New changeset 26ab036098cc0f9e884ef87894f064268a24da0f by Miss Islington (bot) in branch '3.7':
bpo-33830: Fix an example in http.client docs for 404. (GH-7780)
https://github.com/python/cpython/commit/26ab036098cc0f9e884ef87894f064268a24da0f


----------

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

From report at bugs.python.org  Mon Dec 24 08:27:05 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 24 Dec 2018 13:27:05 +0000
Subject: [docs] [issue33830] Error in the output of one example in the
 httplib docs
In-Reply-To: <1528713903.44.0.592728768989.issue33830@psf.upfronthosting.co.za>
Message-ID: <1545658022.42.0.712150888896.issue33830@roundup.psfhosted.org>


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


New changeset 26ab036098cc0f9e884ef87894f064268a24da0f by Miss Islington (bot) in branch '3.7':
bpo-33830: Fix an example in http.client docs for 404. (GH-7780)
https://github.com/python/cpython/commit/26ab036098cc0f9e884ef87894f064268a24da0f


----------

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

From report at bugs.python.org  Mon Dec 24 08:27:32 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 24 Dec 2018 13:27:32 +0000
Subject: [docs] [issue33830] Error in the output of one example in the
 httplib docs
In-Reply-To: <1528713903.44.0.592728768989.issue33830@psf.upfronthosting.co.za>
Message-ID: <1545658048.46.0.712150888896.issue33830@roundup.psfhosted.org>


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


New changeset 26ab036098cc0f9e884ef87894f064268a24da0f by Miss Islington (bot) in branch '3.7':
bpo-33830: Fix an example in http.client docs for 404. (GH-7780)
https://github.com/python/cpython/commit/26ab036098cc0f9e884ef87894f064268a24da0f


----------

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

From report at bugs.python.org  Mon Dec 24 08:27:48 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 24 Dec 2018 13:27:48 +0000
Subject: [docs] [issue33830] Error in the output of one example in the
 httplib docs
In-Reply-To: <1528713903.44.0.592728768989.issue33830@psf.upfronthosting.co.za>
Message-ID: <1545658066.68.0.712150888896.issue33830@roundup.psfhosted.org>


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


New changeset 26ab036098cc0f9e884ef87894f064268a24da0f by Miss Islington (bot) in branch '3.7':
bpo-33830: Fix an example in http.client docs for 404. (GH-7780)
https://github.com/python/cpython/commit/26ab036098cc0f9e884ef87894f064268a24da0f


----------

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

From eyalmler at gmail.com  Mon Dec 24 07:35:46 2018
From: eyalmler at gmail.com (Eyal Miller)
Date: Mon, 24 Dec 2018 14:35:46 +0200
Subject: [docs] spelling mistake
Message-ID: <CAFBFwJnDoxJZ8mL_9baXjSrbvguepbp9YrNbDLs-_0rYLXxgkQ@mail.gmail.com>

hi,
i think in the first line of this page is a spelling error
https://docs.python.org/3.8/library/types.html

"This module defines utility function to assist in dynamic creation of new
types."
shouldn't it be:
...defines *a* utility function
or
defines utility function*s*
?

i hope I'm not wrong
eyal
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181224/8d387ac4/attachment.html>

From report at bugs.python.org  Mon Dec 24 09:57:31 2018
From: report at bugs.python.org (Julien Palard)
Date: Mon, 24 Dec 2018 14:57:31 +0000
Subject: [docs] [issue35564] [DOC] Sphinx 2.0 will require master_doc
 variable set in conf.py
In-Reply-To: <1545514198.61.0.0770528567349.issue35564@roundup.psfhosted.org>
Message-ID: <1545663449.65.0.712150888896.issue35564@roundup.psfhosted.org>


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


New changeset fc8284e22074af8154e9865c8391b955f13a308b by Julien Palard (Jean-Fran?ois B) in branch 'master':
bpo-35564: add master_doc='contents' to conf.py (GH-11290)
https://github.com/python/cpython/commit/fc8284e22074af8154e9865c8391b955f13a308b


----------

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

From report at bugs.python.org  Mon Dec 24 10:19:59 2018
From: report at bugs.python.org (Julien Palard)
Date: Mon, 24 Dec 2018 15:19:59 +0000
Subject: [docs] [issue35564] [DOC] Sphinx 2.0 will require master_doc
 variable set in conf.py
In-Reply-To: <1545514198.61.0.0770528567349.issue35564@roundup.psfhosted.org>
Message-ID: <1545664799.46.0.556460119503.issue35564@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Mon Dec 24 10:49:31 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 24 Dec 2018 15:49:31 +0000
Subject: [docs] [issue34764] Improve documentation example for using iter()
 with sentinel value
In-Reply-To: <1537544491.72.0.956365154283.issue34764@psf.upfronthosting.co.za>
Message-ID: <1545666567.84.0.712150888896.issue34764@roundup.psfhosted.org>


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


New changeset d378b1f8ed7919f65a89f026bc899204be3773d4 by Raymond Hettinger (Chris Rands) in branch 'master':
bpo-34764: improve docs example of iter() with sentinel value (GH-11222)
https://github.com/python/cpython/commit/d378b1f8ed7919f65a89f026bc899204be3773d4


----------

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

From report at bugs.python.org  Mon Dec 24 10:50:09 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 24 Dec 2018 15:50:09 +0000
Subject: [docs] [issue34764] Improve documentation example for using iter()
 with sentinel value
In-Reply-To: <1537544491.72.0.956365154283.issue34764@psf.upfronthosting.co.za>
Message-ID: <1545666607.04.0.556460119503.issue34764@roundup.psfhosted.org>


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


----------
pull_requests: +10536

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

From report at bugs.python.org  Mon Dec 24 11:04:48 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 24 Dec 2018 16:04:48 +0000
Subject: [docs] [issue35566] DOC: Add links to annotation glossary term
In-Reply-To: <1545528192.75.0.0770528567349.issue35566@roundup.psfhosted.org>
Message-ID: <1545667485.64.0.712150888896.issue35566@roundup.psfhosted.org>


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


New changeset b7105c9c9663637e4500bfcac75c911e78d9a1c0 by Raymond Hettinger (Cheryl Sabella) in branch 'master':
bpo-35566: Add links to annotation glossary term (GH-11291)
https://github.com/python/cpython/commit/b7105c9c9663637e4500bfcac75c911e78d9a1c0


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

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

From report at bugs.python.org  Mon Dec 24 11:07:41 2018
From: report at bugs.python.org (miss-islington)
Date: Mon, 24 Dec 2018 16:07:41 +0000
Subject: [docs] [issue35566] DOC: Add links to annotation glossary term
In-Reply-To: <1545528192.75.0.0770528567349.issue35566@roundup.psfhosted.org>
Message-ID: <1545667659.14.0.556460119503.issue35566@roundup.psfhosted.org>


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


----------
pull_requests: +10537

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

From report at bugs.python.org  Mon Dec 24 11:12:48 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 24 Dec 2018 16:12:48 +0000
Subject: [docs] [issue35566] DOC: Add links to annotation glossary term
In-Reply-To: <1545528192.75.0.0770528567349.issue35566@roundup.psfhosted.org>
Message-ID: <1545667965.76.0.712150888896.issue35566@roundup.psfhosted.org>


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


New changeset bc64123335a4b6e2c1e4be532c60e5e1086db59a by Raymond Hettinger (Miss Islington (bot)) in branch '3.7':
bpo-35566: Add links to annotation glossary term (GH-11291) (GH-11302)
https://github.com/python/cpython/commit/bc64123335a4b6e2c1e4be532c60e5e1086db59a


----------

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

From report at bugs.python.org  Mon Dec 24 11:13:24 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 24 Dec 2018 16:13:24 +0000
Subject: [docs] [issue34764] Improve documentation example for using iter()
 with sentinel value
In-Reply-To: <1537544491.72.0.956365154283.issue34764@psf.upfronthosting.co.za>
Message-ID: <1545668001.84.0.712150888896.issue34764@roundup.psfhosted.org>


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


New changeset 00a48d57dfd52a968b357d68f63c51db3a451566 by Raymond Hettinger (Miss Islington (bot)) in branch '3.7':
bpo-34764: improve docs example of iter() with sentinel value (GH-11222) (#11301)
https://github.com/python/cpython/commit/00a48d57dfd52a968b357d68f63c51db3a451566


----------

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

From report at bugs.python.org  Mon Dec 24 11:29:55 2018
From: report at bugs.python.org (Harmandeep Singh)
Date: Mon, 24 Dec 2018 16:29:55 +0000
Subject: [docs] [issue20001] pathlib inheritance diagram too large
In-Reply-To: <1387221538.52.0.488414928183.issue20001@psf.upfronthosting.co.za>
Message-ID: <1545668994.55.0.556460119503.issue20001@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Mon Dec 24 11:31:44 2018
From: report at bugs.python.org (Ned Deily)
Date: Mon, 24 Dec 2018 16:31:44 +0000
Subject: [docs] [issue35472] python 3.7.2 rc1 bumped sphinx requirements a
 bit too much
In-Reply-To: <1544632241.86.0.788709270274.issue35472@psf.upfronthosting.co.za>
Message-ID: <1545669102.21.0.712150888896.issue35472@roundup.psfhosted.org>


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


New changeset 371ca0bb8f5eaa0dcbd3fa2f878398285488d47f by Ned Deily (Julien Palard) in branch '3.7':
bpo-35472: Doc: For Python 3.7 Sphinx 1.6.6 is enough. (GH-11192)
https://github.com/python/cpython/commit/371ca0bb8f5eaa0dcbd3fa2f878398285488d47f


----------

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

From report at bugs.python.org  Mon Dec 24 11:32:35 2018
From: report at bugs.python.org (Ned Deily)
Date: Mon, 24 Dec 2018 16:32:35 +0000
Subject: [docs] [issue35492] Missing colon on func statement in library/sys
 doc
In-Reply-To: <1544786555.59.0.788709270274.issue35492@psf.upfronthosting.co.za>
Message-ID: <1545669154.56.0.731108326251.issue35492@roundup.psfhosted.org>


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


New changeset c53e5f6ab988a74d60273d9130f233d1c446a93c by Ned Deily (Miss Islington (bot)) in branch '3.7':
Fixed missing colun in library/sys.po (GH-11153)
https://github.com/python/cpython/commit/c53e5f6ab988a74d60273d9130f233d1c446a93c


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

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

From report at bugs.python.org  Mon Dec 24 11:32:44 2018
From: report at bugs.python.org (Ned Deily)
Date: Mon, 24 Dec 2018 16:32:44 +0000
Subject: [docs] [issue35482] can't open python368rc1.chm and python372rc1.chm
In-Reply-To: <1544711642.5.0.788709270274.issue35482@psf.upfronthosting.co.za>
Message-ID: <1545669163.27.0.116572831345.issue35482@roundup.psfhosted.org>


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


New changeset 4db9a3fffa232e88fcc2ad3b5ce35e9f8657bbe5 by Ned Deily (Miss Islington (bot)) in branch '3.7':
bpo-35482: Fixes HTML escaping in CHM index and build location of NEWS file (GH-11224)
https://github.com/python/cpython/commit/4db9a3fffa232e88fcc2ad3b5ce35e9f8657bbe5


----------

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

From report at bugs.python.org  Mon Dec 24 11:44:05 2018
From: report at bugs.python.org (Antoine Wecxsteen)
Date: Mon, 24 Dec 2018 16:44:05 +0000
Subject: [docs] [issue35579] Typo in in asyncio-task documentation
Message-ID: <1545669840.38.0.712150888896.issue35579@roundup.psfhosted.org>


New submission from Antoine Wecxsteen <wecxsteen.antoine at gmail.com>:

I believe there is a typo in the library/asyncio-task documentation

https://docs.python.org/3.8/library/asyncio-task.html#scheduling-from-other-threads

"Unlike other asyncio functions this functions requires the loop argument to be passed explicitly."

It should be "this function", without "s".

----------
assignee: docs at python
components: Documentation, asyncio
messages: 332495
nosy: Antoine Wecxsteen, asvetlov, docs at python, eric.araujo, ezio.melotti, mdk, willingc, yselivanov
priority: normal
severity: normal
status: open
title: Typo in in asyncio-task documentation
versions: Python 3.7, Python 3.8

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

From report at bugs.python.org  Mon Dec 24 12:53:49 2018
From: report at bugs.python.org (Cheryl Sabella)
Date: Mon, 24 Dec 2018 17:53:49 +0000
Subject: [docs] [issue23864] issubclass without registration only works for
 "one-trick pony" collections ABCs.
In-Reply-To: <1428145067.47.0.0726533343331.issue23864@psf.upfronthosting.co.za>
Message-ID: <1545674024.53.0.712150888896.issue23864@roundup.psfhosted.org>


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

This isn't meant as a comment from any previous posts.  It's simply meant to correct a statement (based on new information in the past 2 years) from the original post.

Since this original report, some ABCs that are not "One Trick Ponies" have been added which implement  __subclasshook__.  `Collection` is one of those, so using the original example:

>>> from collections.abc import Sequence, Container, Sized, Collection
>>> class MySequence(object):
...     def __contains__(self, item): pass
...     def __len__(self): pass
...     def __iter__(self): pass
...     def __getitem__(self, index): pass
...     def __len__(self): pass
...     def __reversed__(self): pass
...     def index(self, item): pass
...     def count(self, item): pass
... 
>>> issubclass(MySequence, Container)
True
>>> issubclass(MySequence, Sized)
True
>>> issubclass(MySequence, Sequence)
False
>>> issubclass(MySequence, Collection)
True

Collection is not a "One Trick Pony" because it is used for Sized, Iterable Containers.

Generator, Coroutine, and ASyncGenerator are also not "One Trick Ponies" (although they are defined under that section in _collections_abc.py).

Again, for reference, the definition of One Trick Pony from PEP3119 is:
These abstract classes represent single methods like __iter__ or __len__.

If only One Trick Ponies implemented __subclasshook__, then the original documentation issue:
> These ABCs allow us to ask classes or instances if they provide particular functionality, for example:

maybe could have been changed to:
> These ABCs allow us to ask classes or instances if they provide singular functionality, for example:

But, that's not really correct anymore.

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

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

From report at bugs.python.org  Mon Dec 24 18:15:45 2018
From: report at bugs.python.org (Andrew Svetlov)
Date: Mon, 24 Dec 2018 23:15:45 +0000
Subject: [docs] [issue35579] Typo in in asyncio-task documentation
In-Reply-To: <1545669840.38.0.712150888896.issue35579@roundup.psfhosted.org>
Message-ID: <1545693340.36.0.712150888896.issue35579@roundup.psfhosted.org>


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

You are correct.
Would you make a patch?

----------

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

From mariatta at python.org  Mon Dec 24 18:53:20 2018
From: mariatta at python.org (Mariatta Wijaya)
Date: Mon, 24 Dec 2018 15:53:20 -0800
Subject: [docs] spelling mistake
In-Reply-To: <CAFBFwJnDoxJZ8mL_9baXjSrbvguepbp9YrNbDLs-_0rYLXxgkQ@mail.gmail.com>
References: <CAFBFwJnDoxJZ8mL_9baXjSrbvguepbp9YrNbDLs-_0rYLXxgkQ@mail.gmail.com>
Message-ID: <CAGbohnbaZbWdGPo0RkFAceyAJgTtbLLia6GW5PurwU718aFtgw@mail.gmail.com>

Thanks for catching that. I've fixed it in this PR.

https://github.com/python/cpython/pull/11308


?

On Mon, Dec 24, 2018 at 5:47 AM Eyal Miller <eyalmler at gmail.com> wrote:

> hi,
> i think in the first line of this page is a spelling error
> https://docs.python.org/3.8/library/types.html
>
> "This module defines utility function to assist in dynamic creation of new
> types."
> shouldn't it be:
> ...defines *a* utility function
> or
> defines utility function*s*
> ?
>
> i hope I'm not wrong
> eyal
> _______________________________________________
> docs mailing list
> docs at python.org
> https://mail.python.org/mailman/listinfo/docs
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181224/e00486c2/attachment.html>

From report at bugs.python.org  Mon Dec 24 23:05:04 2018
From: report at bugs.python.org (Harmandeep Singh)
Date: Tue, 25 Dec 2018 04:05:04 +0000
Subject: [docs] [issue35525] Incorrect keyword name in NNTP.starttls()
 documentation
In-Reply-To: <1545146886.62.0.788709270274.issue35525@psf.upfronthosting.co.za>
Message-ID: <1545710702.65.0.556460119503.issue35525@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Mon Dec 24 23:05:07 2018
From: report at bugs.python.org (Harmandeep Singh)
Date: Tue, 25 Dec 2018 04:05:07 +0000
Subject: [docs] [issue35525] Incorrect keyword name in NNTP.starttls()
 documentation
In-Reply-To: <1545146886.62.0.788709270274.issue35525@psf.upfronthosting.co.za>
Message-ID: <1545710706.61.0.556460119503.issue35525@roundup.psfhosted.org>


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


----------
keywords: +patch, patch
pull_requests: +10553, 10554
stage:  -> patch review

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

From report at bugs.python.org  Mon Dec 24 23:05:11 2018
From: report at bugs.python.org (Harmandeep Singh)
Date: Tue, 25 Dec 2018 04:05:11 +0000
Subject: [docs] [issue35525] Incorrect keyword name in NNTP.starttls()
 documentation
In-Reply-To: <1545146886.62.0.788709270274.issue35525@psf.upfronthosting.co.za>
Message-ID: <1545710710.74.0.556460119503.issue35525@roundup.psfhosted.org>


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


----------
keywords: +patch, patch, patch
pull_requests: +10553, 10554, 10555
stage:  -> patch review

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

From bw at activustech.com  Mon Dec 24 19:15:38 2018
From: bw at activustech.com (Brian Wolf)
Date: Mon, 24 Dec 2018 19:15:38 -0500
Subject: [docs] typo
Message-ID: <fd2672ac-a1f8-1e96-1c2b-120e9bb39398@activustech.com>

On this page:
https://docs.python.org/3.6/library/unittest.mock.html#auto-speccing

Same typo is repeated:
mock.*assret*_called_once_with(4, 5, 6)

Should be assert

-- 

Thank you,
Brian

------------------------------------------------------------------------

Activus Technologies
Email: bw at activustech.com
Phone: 410.367.2958
Software solutions
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181224/1c0d8db1/attachment.html>

From report at bugs.python.org  Tue Dec 25 07:52:41 2018
From: report at bugs.python.org (Sebastian Rittau)
Date: Tue, 25 Dec 2018 12:52:41 +0000
Subject: [docs] [issue35581] Document @typing.type_check_only
Message-ID: <1545742357.2.0.712150888896.issue35581@roundup.psfhosted.org>


New submission from Sebastian Rittau <srittau at rittau.biz>:

Document @typing.type_check_only per https://github.com/python/typing/issues/597.

----------
assignee: docs at python
components: Documentation
messages: 332508
nosy: docs at python, srittau
priority: normal
severity: normal
status: open
title: Document @typing.type_check_only
versions: Python 3.7, Python 3.8

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

From report at bugs.python.org  Tue Dec 25 07:56:44 2018
From: report at bugs.python.org (Sebastian Rittau)
Date: Tue, 25 Dec 2018 12:56:44 +0000
Subject: [docs] [issue35581] Document @typing.type_check_only
In-Reply-To: <1545742357.2.0.712150888896.issue35581@roundup.psfhosted.org>
Message-ID: <1545742604.48.0.556460119503.issue35581@roundup.psfhosted.org>


Change by Sebastian Rittau <srittau at rittau.biz>:


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

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

From report at bugs.python.org  Tue Dec 25 07:56:49 2018
From: report at bugs.python.org (Sebastian Rittau)
Date: Tue, 25 Dec 2018 12:56:49 +0000
Subject: [docs] [issue35581] Document @typing.type_check_only
In-Reply-To: <1545742357.2.0.712150888896.issue35581@roundup.psfhosted.org>
Message-ID: <1545742609.31.0.556460119503.issue35581@roundup.psfhosted.org>


Change by Sebastian Rittau <srittau at rittau.biz>:


----------
keywords: +patch, patch
pull_requests: +10559, 10560
stage:  -> patch review

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

From report at bugs.python.org  Tue Dec 25 07:56:52 2018
From: report at bugs.python.org (Sebastian Rittau)
Date: Tue, 25 Dec 2018 12:56:52 +0000
Subject: [docs] [issue35581] Document @typing.type_check_only
In-Reply-To: <1545742357.2.0.712150888896.issue35581@roundup.psfhosted.org>
Message-ID: <1545742612.59.0.556460119503.issue35581@roundup.psfhosted.org>


Change by Sebastian Rittau <srittau at rittau.biz>:


----------
keywords: +patch, patch, patch
pull_requests: +10559, 10560, 10561
stage:  -> patch review

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

From report at bugs.python.org  Tue Dec 25 07:59:41 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Tue, 25 Dec 2018 12:59:41 +0000
Subject: [docs] [issue35581] Document @typing.type_check_only
In-Reply-To: <1545742357.2.0.712150888896.issue35581@roundup.psfhosted.org>
Message-ID: <1545742781.64.0.556460119503.issue35581@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Tue Dec 25 11:06:57 2018
From: report at bugs.python.org (Vaibhav Gupta)
Date: Tue, 25 Dec 2018 16:06:57 +0000
Subject: [docs] [issue35579] Typo in in asyncio-task documentation
In-Reply-To: <1545669840.38.0.712150888896.issue35579@roundup.psfhosted.org>
Message-ID: <1545754012.48.0.712150888896.issue35579@roundup.psfhosted.org>


Vaibhav Gupta <vaibhgupt199 at gmail.com> added the comment:

I am totally new to the community here and would like to start with a easy issue.
Can i make a PR for this?

----------
nosy: +Vaibhav Gupta

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

From report at bugs.python.org  Tue Dec 25 13:30:56 2018
From: report at bugs.python.org (=?utf-8?q?Andr=C3=A9s_Delfino?=)
Date: Tue, 25 Dec 2018 18:30:56 +0000
Subject: [docs] [issue32070] Clarify the behavior of the staticmethod builtin
In-Reply-To: <1511028255.0.0.213398074469.issue32070@psf.upfronthosting.co.za>
Message-ID: <1545762653.66.0.712150888896.issue32070@roundup.psfhosted.org>


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

Also see #34085 that deals with the same issue in functions.rst.

----------
nosy: +adelfino

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

From wangzhezhijie2 at gmail.com  Tue Dec 25 13:33:02 2018
From: wangzhezhijie2 at gmail.com (=?UTF-8?B?546L6LaK?=)
Date: Tue, 25 Dec 2018 12:33:02 -0600
Subject: [docs] Doc errors
Message-ID: <CA+cNobHJPvChvkan1GD3WGEaB4efLWywYjPGgih4Opq60hMQOQ@mail.gmail.com>

Hi, I find a mistake on https://docs.python.org/zh-cn/3.7/bugs.html, maybe
it is because the translation.
In the forth paragraph, "??????? Python ??????????????????? 'r' ??????????,
?????????? ??,``r"n"`` ????? '\' ? 'n' ???????, ? "\n" ???????????????
????????????????" while the original express is " So r"\n" is a
two-character string containing".
There is a missing "\" and should be "r"\n"".
Thank you!

Best Wishes,
Bruce Wang
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181225/1342067c/attachment.html>

From report at bugs.python.org  Tue Dec 25 16:36:32 2018
From: report at bugs.python.org (Andrew Svetlov)
Date: Tue, 25 Dec 2018 21:36:32 +0000
Subject: [docs] [issue35579] Typo in in asyncio-task documentation
In-Reply-To: <1545669840.38.0.712150888896.issue35579@roundup.psfhosted.org>
Message-ID: <1545773788.33.0.712150888896.issue35579@roundup.psfhosted.org>


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

Sure!

----------

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

From report at bugs.python.org  Tue Dec 25 16:37:52 2018
From: report at bugs.python.org (Julien Palard)
Date: Tue, 25 Dec 2018 21:37:52 +0000
Subject: [docs] [issue35579] Typo in in asyncio-task documentation
In-Reply-To: <1545669840.38.0.712150888896.issue35579@roundup.psfhosted.org>
Message-ID: <1545773867.48.0.712150888896.issue35579@roundup.psfhosted.org>


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

Looks like you can (no one objected to it).

----------

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

From julien at palard.fr  Tue Dec 25 16:47:21 2018
From: julien at palard.fr (Julien Palard)
Date: Tue, 25 Dec 2018 21:47:21 +0000
Subject: [docs] Doc errors
In-Reply-To: <CA+cNobHJPvChvkan1GD3WGEaB4efLWywYjPGgih4Opq60hMQOQ@mail.gmail.com>
References: <CA+cNobHJPvChvkan1GD3WGEaB4efLWywYjPGgih4Opq60hMQOQ@mail.gmail.com>
Message-ID: <0o_uVkrbAR1wA2XOfeAXhQW4fYtdYRxt_lu_daksTDOI77xqrqLZVHOd7ia7P6TaHRoN8Yt1_P_VGl7XwDPHEK01sTz1u_LzP1RsFWIbJOI=@palard.fr>

Hi and thanks for reporting.

> Hi, I find a mistake on https://docs.python.org/zh-cn/3.7/bugs.html, maybe it is because the translation.

I forwarded your issue on the zh-cn bug tracker here: https://github.com/python/python-docs-zh-cn/issues/11

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


From julien at palard.fr  Tue Dec 25 16:49:09 2018
From: julien at palard.fr (Julien Palard)
Date: Tue, 25 Dec 2018 21:49:09 +0000
Subject: [docs] typo
In-Reply-To: <fd2672ac-a1f8-1e96-1c2b-120e9bb39398@activustech.com>
References: <fd2672ac-a1f8-1e96-1c2b-120e9bb39398@activustech.com>
Message-ID: <P3HM4vYYWPBnY4EhV1_uRUhEHt2Uhjv-KEdN_uBBtQkW_ax4e3IWMVaKOmEpjsqHzL7Ou6sEIQk8R3OgiZqnu0ppe9KCMM9vgDLIXOt2msI=@palard.fr>

Hi Brian, thanks for reporting,

> mock.assret_called_once_with(4, 5, 6)
> Should be assert

The misspelling is intentional, that section is talking about what happens when an "assert_" method is misspelled.

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


From julien at palard.fr  Tue Dec 25 16:52:38 2018
From: julien at palard.fr (Julien Palard)
Date: Tue, 25 Dec 2018 21:52:38 +0000
Subject: [docs] Disconnected HTTPConnection and HTTPResponse docs
In-Reply-To: <CAK=cShjNyn_=7gwWd95EgW7ROHvKGPjkX9UhAUEu4LxF3nMXJw@mail.gmail.com>
References: <CAK=cShjNyn_=7gwWd95EgW7ROHvKGPjkX9UhAUEu4LxF3nMXJw@mail.gmail.com>
Message-ID: <vTzf-Ts1U7hBfZSPxz3UPmyKnqMZ1NWxe5fEhWA3PsDPzqZW9aTghXHHV05AuXf4pmLebGjPZOlRIWmApWaVvUMNlUwyxVuKKBiifdgvUwg=@palard.fr>

Hi Anatoli, thanks for reporting,

Looks like the 2nd word of https://docs.python.org/3/library/http.client.html#httpresponse-objects is a link to https://docs.python.org/3/library/http.client.html#http.client.HTTPResponse, isn't this enough? Or did I understand your message wrong?

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

??????? Original Message ???????
On Wednesday 19 December 2018 13:53, Anatoli Babenia <anatoli at rainforce.org> wrote:

> Hello.
>
> Found this email in documentation page.
>
> It is hard to find parameters for HTTPResponse, because texts
> describing its parameters are separated by differen documentaion
> block and are not linked together.
> https://docs.python.org/3/library/http.client.html#http.client.HTTPResponse
> https://docs.python.org/3/library/http.client.html#httpresponse-objects
>
> The same is true for HTTPConnection.
> https://docs.python.org/3/library/http.client.html#http.client.HTTPConnection
> https://docs.python.org/3/library/http.client.html#httpconnection-objects
>
> --
> Anatoli Babenia
>
> +1 (650) 605-3365
> +375 (29) 320-4241
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181225/69fa9b3c/attachment.html>

From report at bugs.python.org  Tue Dec 25 17:10:51 2018
From: report at bugs.python.org (Julien Palard)
Date: Tue, 25 Dec 2018 22:10:51 +0000
Subject: [docs] [issue35584] Wrong statement about ^ in howto/regex.rst
Message-ID: <1545775848.12.0.712150888896.issue35584@roundup.psfhosted.org>


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

In howto/regex.rst I read:

> '^' outside a character class will simply match the '^' character.

Which looks wrong, '^' is the "begin anchor", it's a metacharacter that typically won't match '^'.

I propose to simply remove the statement, if nobody finds a better idea.

----------
assignee: docs at python
components: Documentation
messages: 332520
nosy: Vaibhav Gupta, docs at python, mdk
priority: normal
severity: normal
status: open
title: Wrong statement about ^ in howto/regex.rst
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/issue35584>
_______________________________________

From julien at palard.fr  Tue Dec 25 17:11:32 2018
From: julien at palard.fr (Julien Palard)
Date: Tue, 25 Dec 2018 22:11:32 +0000
Subject: [docs] Bug in documentation
In-Reply-To: <CAFKeqk4TnNuWyvODv=7XCwnj-oH=06vDBaGdu944SS4Vz_A9LQ@mail.gmail.com>
References: <CAFKeqk4TnNuWyvODv=7XCwnj-oH=06vDBaGdu944SS4Vz_A9LQ@mail.gmail.com>
Message-ID: <LUeX9uTpPXvaM1GH1S5b-tP7UxHULUrvjSjp7HW3PEqMju6XgREUroeWnl4WwrObYhdqrq_5gDytsVBpxVkvkYG2k1Cp9SJonRLDecwFmeA=@palard.fr>

Hi Ovidiu,

> In the following page:
>
> https://docs.python.org/3.5/howto/regex.html#matching-characters
>
> The following 2 paragraphs are contradictory:
>
> Metacharacters are not active inside classes. For example,[akm$] will match any of the characters 'a', 'k', 'm', or '$'; '$' is usually a metacharacter, but inside a character class it?s stripped of its special nature.
>
> You can match the characters not listed within the class by complementing the set. This is indicated by including a '^' as the first character of the class; '^' outside a character class will simply match the '^'character. For example, [^5] will match any character except '5'.

Thanks for reporting. I don't think the `^` in classes is a metacharacter, I see it more like a syntax. Anyway to enhance this, we could add a warning in the first paragraph telling that '^' is a kind of an exception. But I don't think it would help a lot, as the second paragraph is here to do the job.

So I don't really see how we can enhance the situation. I'm more conserned by the

>  '^' outside a character class will simply match the '^' character.

which seems plain wrong, so I opened an issue about it: https://bugs.python.org/issue35584

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


From julien at palard.fr  Tue Dec 25 17:23:37 2018
From: julien at palard.fr (Julien Palard)
Date: Tue, 25 Dec 2018 22:23:37 +0000
Subject: [docs] Path.resolve() unclear about backwards incompatibility
In-Reply-To: <CABYkHVviBA3yO++ABAqttcfSNQb5wG_0ykhkj7LQ5T0CVJ6bhg@mail.gmail.com>
References: <CABYkHVviBA3yO++ABAqttcfSNQb5wG_0ykhkj7LQ5T0CVJ6bhg@mail.gmail.com>
Message-ID: <0HL4eydfRbAqA2hA608qRZ-wDiRyUki9TdjEh0TPiTkrdlojKXSmDYAyV4YivFzTeVO3bjE9yTBYtQm--TkZe2WuoIIIgfT6ShbvgQGJXeA=@palard.fr>

Hi,

Thanks for reporting, this is due to the resolution of https://bugs.python.org/issue19717, I opened a PR to explicitly tell about it in the documentation: https://github.com/python/cpython/pull/11316

Can you proofread it?

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

??????? Original Message ???????
On Thursday 13 December 2018 10:54, Laurens Duijvesteijn <laurens at channable.com> wrote:

> Hi,
>
> The `Path.resolve()` method behaves differently on Python 3.5 vs Python 3.6.
>
> The docs https://docs.python.org/3/library/pathlib.html#pathlib.Path.resolve
> fail to mention this.
>
> This is the behavior on 3.5:
>
> ```
> Python 3.5.2 (default, Nov 12 2018, 13:43:14)
> [GCC 5.4.0 20160609] on linux
> Type "help", "copyright", "credits" or "license" for more information.
>>>> from pathlib import Path
>>>> p = Path('/var/../doesnotexist.txt')
>>>> p.resolve()
> Traceback (most recent call last):
>   File "<stdin>", line 1, in <module>
>   File "/usr/lib/python3.5/pathlib.py", line 1109, in resolve
>     s = self._flavour.resolve(self)
>   File "/usr/lib/python3.5/pathlib.py", line 330, in resolve
>     return _resolve(base, str(path)) or sep
>   File "/usr/lib/python3.5/pathlib.py", line 315, in _resolve
>     target = accessor.readlink(newpath)
>   File "/usr/lib/python3.5/pathlib.py", line 422, in readlink
>     return os.readlink(path)
> FileNotFoundError: [Errno 2] No such file or directory: '/doesnotexist.txt'
> ```
>
> This is the behavior on 3.6:
>
> ```
> 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 pathlib import Path
>>>> p = Path('/var/../doesnotexist.txt')
>>>> p.resolve()
> PosixPath('/doesnotexist.txt')
> ```
>
> I'd even say this change is a bug in the standard lib (if done on purpose,
> it is not listed as a backwards incompatible change in the release notes,
> didn't dig further).
>
> The docs mention "New in version 3.6: The strict argument". IMO the docs
> should also mention that before 3.5, this method would raise FileNotFound
> by default.
>
> Thanks and kind regards,
> Laurens Duijvesteijn
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181225/6c645d97/attachment-0001.html>

From julien at palard.fr  Tue Dec 25 17:15:00 2018
From: julien at palard.fr (Julien Palard)
Date: Tue, 25 Dec 2018 22:15:00 +0000
Subject: [docs] Python Documentation: Grammar Error in 'unittest'
 documentation: "associate -> associated"
In-Reply-To: <811FA051DD879246A0641815A7AA250A347D15@DC2PRMBX01A.ES.AD.ADP.com>
References: <811FA051DD879246A0641815A7AA250A347D15@DC2PRMBX01A.ES.AD.ADP.com>
Message-ID: <ZBBkIeTqvr5eEgH8RwWjzvxA33p0v9C1AChXCpVcgZWIj0WQVTZ_lNgTg4wIa7zJSWqjHZVae4aHa781k6m_duL354GN3T3-elZg4OHbgCE=@palard.fr>

Hi, thanks for reporting.

> A test fixture represents the preparation needed to perform one or more tests, and any ***associated*** cleanup actions. This may involve, for example, creating temporary or proxy databases, directories, or starting a server process.

I opened a PR about it here: https://github.com/python/cpython/pull/11315 does it looks OK?

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


From report at bugs.python.org  Tue Dec 25 18:00:44 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Tue, 25 Dec 2018 23:00:44 +0000
Subject: [docs] [issue35584] Wrong statement about ^ in howto/regex.rst
In-Reply-To: <1545775848.12.0.712150888896.issue35584@roundup.psfhosted.org>
Message-ID: <1545778842.3.0.712150888896.issue35584@roundup.psfhosted.org>


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

The caret has several meanings:

* Generally, it is a beginning of string: r'^bol'

* When MULTILINE is on, it is a beginning of line: r'^bos'

* Escaped with a backslash, it is just a caret: r'a\^b'

* Immediately after a left bracket, it inverts a character set: r'[^aeiou]'

* Elsewhere in brackets, it is just a caret: r'[ab^d]'

----------
nosy: +rhettinger
versions:  -Python 3.4, Python 3.5

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

From report at bugs.python.org  Tue Dec 25 20:46:28 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Wed, 26 Dec 2018 01:46:28 +0000
Subject: [docs] [issue29886] links between binascii.{un, }hexlify / bytes.{,
 to}hex
In-Reply-To: <1490282084.27.0.505150099985.issue29886@psf.upfronthosting.co.za>
Message-ID: <1545788787.76.0.556460119503.issue29886@roundup.psfhosted.org>


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


----------
pull_requests: +10570

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

From report at bugs.python.org  Tue Dec 25 20:46:35 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Wed, 26 Dec 2018 01:46:35 +0000
Subject: [docs] [issue29886] links between binascii.{un, }hexlify / bytes.{,
 to}hex
In-Reply-To: <1490282084.27.0.505150099985.issue29886@psf.upfronthosting.co.za>
Message-ID: <1545788793.9.0.556460119503.issue29886@roundup.psfhosted.org>


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


----------
pull_requests: +10570, 10571

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

From report at bugs.python.org  Tue Dec 25 20:46:39 2018
From: report at bugs.python.org (Raymond Hettinger)
Date: Wed, 26 Dec 2018 01:46:39 +0000
Subject: [docs] [issue29886] links between binascii.{un, }hexlify / bytes.{,
 to}hex
In-Reply-To: <1490282084.27.0.505150099985.issue29886@psf.upfronthosting.co.za>
Message-ID: <1545788798.9.0.556460119503.issue29886@roundup.psfhosted.org>


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


----------
pull_requests: +10570, 10571, 10572

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

From report at bugs.python.org  Tue Dec 25 20:56:25 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 26 Dec 2018 01:56:25 +0000
Subject: [docs] [issue29886] links between binascii.{un, }hexlify / bytes.{,
 to}hex
In-Reply-To: <1490282084.27.0.505150099985.issue29886@psf.upfronthosting.co.za>
Message-ID: <1545789383.31.0.556460119503.issue29886@roundup.psfhosted.org>


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


----------
pull_requests: +10573

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

From report at bugs.python.org  Tue Dec 25 20:56:31 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 26 Dec 2018 01:56:31 +0000
Subject: [docs] [issue29886] links between binascii.{un, }hexlify / bytes.{,
 to}hex
In-Reply-To: <1490282084.27.0.505150099985.issue29886@psf.upfronthosting.co.za>
Message-ID: <1545789389.28.0.556460119503.issue29886@roundup.psfhosted.org>


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


----------
pull_requests: +10573, 10574

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

From report at bugs.python.org  Tue Dec 25 20:56:39 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 26 Dec 2018 01:56:39 +0000
Subject: [docs] [issue29886] links between binascii.{un, }hexlify / bytes.{,
 to}hex
In-Reply-To: <1490282084.27.0.505150099985.issue29886@psf.upfronthosting.co.za>
Message-ID: <1545789397.18.0.556460119503.issue29886@roundup.psfhosted.org>


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


----------
pull_requests: +10573, 10574, 10575

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

From report at bugs.python.org  Tue Dec 25 21:10:34 2018
From: report at bugs.python.org (Ma Lin)
Date: Wed, 26 Dec 2018 02:10:34 +0000
Subject: [docs] [issue35228] Index search in CHM help crashes viewer
In-Reply-To: <1542107217.87.0.788709270274.issue35228@psf.upfronthosting.co.za>
Message-ID: <1545790230.58.0.712150888896.issue35228@roundup.psfhosted.org>


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

I solved this thoroughly: Format disk C: and install a clean Windows 10.

Don't forget to backup important files in C:\Users\<user name>\ folder.

----------

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

From wangzhezhijie2 at gmail.com  Tue Dec 25 17:21:31 2018
From: wangzhezhijie2 at gmail.com (=?UTF-8?B?546L6LaK?=)
Date: Tue, 25 Dec 2018 16:21:31 -0600
Subject: [docs] Doc errors
In-Reply-To: <0o_uVkrbAR1wA2XOfeAXhQW4fYtdYRxt_lu_daksTDOI77xqrqLZVHOd7ia7P6TaHRoN8Yt1_P_VGl7XwDPHEK01sTz1u_LzP1RsFWIbJOI=@palard.fr>
References: <CA+cNobHJPvChvkan1GD3WGEaB4efLWywYjPGgih4Opq60hMQOQ@mail.gmail.com>
 <0o_uVkrbAR1wA2XOfeAXhQW4fYtdYRxt_lu_daksTDOI77xqrqLZVHOd7ia7P6TaHRoN8Yt1_P_VGl7XwDPHEK01sTz1u_LzP1RsFWIbJOI=@palard.fr>
Message-ID: <CA+cNobHASRz=zbfoX3wMnPv=tF_dFWT8_JBm4J3uZzwV3VtDtg@mail.gmail.com>

Thank you!

Julien Palard <julien at palard.fr> ?2018?12?25??? ??3:47???

> Hi and thanks for reporting.
>
> > Hi, I find a mistake on https://docs.python.org/zh-cn/3.7/bugs.html,
> maybe it is because the translation.
>
> I forwarded your issue on the zh-cn bug tracker here:
> https://github.com/python/python-docs-zh-cn/issues/11
>
> Bests,
> --
> Julien Palard
> https://mdk.fr
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181225/13e11fd9/attachment.html>

From report at bugs.python.org  Wed Dec 26 03:20:15 2018
From: report at bugs.python.org (Vaibhav Gupta)
Date: Wed, 26 Dec 2018 08:20:15 +0000
Subject: [docs] [issue35579] Typo in in asyncio-task documentation
In-Reply-To: <1545669840.38.0.712150888896.issue35579@roundup.psfhosted.org>
Message-ID: <1545812411.93.0.556460119503.issue35579@roundup.psfhosted.org>


Change by Vaibhav Gupta <vaibhgupt199 at gmail.com>:


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

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

From report at bugs.python.org  Wed Dec 26 03:20:32 2018
From: report at bugs.python.org (Vaibhav Gupta)
Date: Wed, 26 Dec 2018 08:20:32 +0000
Subject: [docs] [issue35579] Typo in in asyncio-task documentation
In-Reply-To: <1545669840.38.0.712150888896.issue35579@roundup.psfhosted.org>
Message-ID: <1545812428.74.0.556460119503.issue35579@roundup.psfhosted.org>


Change by Vaibhav Gupta <vaibhgupt199 at gmail.com>:


----------
keywords: +patch, patch
pull_requests: +10578, 10579
stage:  -> patch review

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

From report at bugs.python.org  Wed Dec 26 03:20:46 2018
From: report at bugs.python.org (Vaibhav Gupta)
Date: Wed, 26 Dec 2018 08:20:46 +0000
Subject: [docs] [issue35579] Typo in in asyncio-task documentation
In-Reply-To: <1545669840.38.0.712150888896.issue35579@roundup.psfhosted.org>
Message-ID: <1545812443.39.0.556460119503.issue35579@roundup.psfhosted.org>


Change by Vaibhav Gupta <vaibhgupt199 at gmail.com>:


----------
keywords: +patch, patch, patch
pull_requests: +10578, 10579, 10580
stage:  -> patch review

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

From report at bugs.python.org  Wed Dec 26 03:20:58 2018
From: report at bugs.python.org (Vaibhav Gupta)
Date: Wed, 26 Dec 2018 08:20:58 +0000
Subject: [docs] [issue35579] Typo in in asyncio-task documentation
In-Reply-To: <1545669840.38.0.712150888896.issue35579@roundup.psfhosted.org>
Message-ID: <1545812455.28.0.556460119503.issue35579@roundup.psfhosted.org>


Change by Vaibhav Gupta <vaibhgupt199 at gmail.com>:


----------
keywords: +patch, patch, patch, patch
pull_requests: +10578, 10579, 10580, 10581
stage:  -> patch review

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

From report at bugs.python.org  Wed Dec 26 09:47:45 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 26 Dec 2018 14:47:45 +0000
Subject: [docs] [issue35579] Typo in in asyncio-task documentation
In-Reply-To: <1545669840.38.0.712150888896.issue35579@roundup.psfhosted.org>
Message-ID: <1545835661.42.0.675853037811.issue35579@roundup.psfhosted.org>


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


----------
pull_requests: +10585

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

From report at bugs.python.org  Wed Dec 26 09:48:03 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 26 Dec 2018 14:48:03 +0000
Subject: [docs] [issue35579] Typo in in asyncio-task documentation
In-Reply-To: <1545669840.38.0.712150888896.issue35579@roundup.psfhosted.org>
Message-ID: <1545835679.67.0.86051721016.issue35579@roundup.psfhosted.org>


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


----------
pull_requests: +10585, 10586

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

From report at bugs.python.org  Wed Dec 26 09:53:09 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 26 Dec 2018 14:53:09 +0000
Subject: [docs] [issue35579] Typo in in asyncio-task documentation
In-Reply-To: <1545669840.38.0.712150888896.issue35579@roundup.psfhosted.org>
Message-ID: <1545835985.83.0.91241974202.issue35579@roundup.psfhosted.org>


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


New changeset dcf14d1a9875143747cd87c66fae6e693b21c6de by Miss Islington (bot) in branch '3.7':
bpo-35579: Fix typo in in asyncio-task documentation (GH-11321)
https://github.com/python/cpython/commit/dcf14d1a9875143747cd87c66fae6e693b21c6de


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

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

From report at bugs.python.org  Wed Dec 26 09:53:57 2018
From: report at bugs.python.org (Andrew Svetlov)
Date: Wed, 26 Dec 2018 14:53:57 +0000
Subject: [docs] [issue35579] Typo in in asyncio-task documentation
In-Reply-To: <1545669840.38.0.712150888896.issue35579@roundup.psfhosted.org>
Message-ID: <1545836035.9.0.369000135038.issue35579@roundup.psfhosted.org>


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

From report at bugs.python.org  Wed Dec 26 09:56:40 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 26 Dec 2018 14:56:40 +0000
Subject: [docs] [issue35579] Typo in in asyncio-task documentation
In-Reply-To: <1545669840.38.0.712150888896.issue35579@roundup.psfhosted.org>
Message-ID: <1545836197.81.0.320169395345.issue35579@roundup.psfhosted.org>


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


New changeset 3a81076bbf899b1a549f005dd9299e7ae0946321 by Miss Islington (bot) (Vaibhav Gupta) in branch 'master':
bpo-35579: Fix typo in in asyncio-task documentation (GH-11321)
https://github.com/python/cpython/commit/3a81076bbf899b1a549f005dd9299e7ae0946321


----------

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

From report at bugs.python.org  Wed Dec 26 09:57:00 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 26 Dec 2018 14:57:00 +0000
Subject: [docs] [issue35579] Typo in in asyncio-task documentation
In-Reply-To: <1545669840.38.0.712150888896.issue35579@roundup.psfhosted.org>
Message-ID: <1545836216.11.0.428523250849.issue35579@roundup.psfhosted.org>


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


New changeset 3a81076bbf899b1a549f005dd9299e7ae0946321 by Miss Islington (bot) (Vaibhav Gupta) in branch 'master':
bpo-35579: Fix typo in in asyncio-task documentation (GH-11321)
https://github.com/python/cpython/commit/3a81076bbf899b1a549f005dd9299e7ae0946321


----------

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

From report at bugs.python.org  Wed Dec 26 09:59:52 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 26 Dec 2018 14:59:52 +0000
Subject: [docs] [issue35579] Typo in in asyncio-task documentation
In-Reply-To: <1545669840.38.0.712150888896.issue35579@roundup.psfhosted.org>
Message-ID: <1545836388.72.0.962757613988.issue35579@roundup.psfhosted.org>


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


New changeset 3a81076bbf899b1a549f005dd9299e7ae0946321 by Miss Islington (bot) (Vaibhav Gupta) in branch 'master':
bpo-35579: Fix typo in in asyncio-task documentation (GH-11321)
https://github.com/python/cpython/commit/3a81076bbf899b1a549f005dd9299e7ae0946321


----------

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

From report at bugs.python.org  Wed Dec 26 10:02:01 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 26 Dec 2018 15:02:01 +0000
Subject: [docs] [issue35579] Typo in in asyncio-task documentation
In-Reply-To: <1545669840.38.0.712150888896.issue35579@roundup.psfhosted.org>
Message-ID: <1545836515.18.0.0786683742414.issue35579@roundup.psfhosted.org>


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


New changeset 3a81076bbf899b1a549f005dd9299e7ae0946321 by Miss Islington (bot) (Vaibhav Gupta) in branch 'master':
bpo-35579: Fix typo in in asyncio-task documentation (GH-11321)
https://github.com/python/cpython/commit/3a81076bbf899b1a549f005dd9299e7ae0946321


----------

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

From report at bugs.python.org  Wed Dec 26 10:03:59 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 26 Dec 2018 15:03:59 +0000
Subject: [docs] [issue35579] Typo in in asyncio-task documentation
In-Reply-To: <1545669840.38.0.712150888896.issue35579@roundup.psfhosted.org>
Message-ID: <1545836635.47.0.473774060442.issue35579@roundup.psfhosted.org>


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


New changeset dcf14d1a9875143747cd87c66fae6e693b21c6de by Miss Islington (bot) in branch '3.7':
bpo-35579: Fix typo in in asyncio-task documentation (GH-11321)
https://github.com/python/cpython/commit/dcf14d1a9875143747cd87c66fae6e693b21c6de


----------

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

From report at bugs.python.org  Wed Dec 26 10:11:16 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 26 Dec 2018 15:11:16 +0000
Subject: [docs] [issue35579] Typo in in asyncio-task documentation
In-Reply-To: <1545669840.38.0.712150888896.issue35579@roundup.psfhosted.org>
Message-ID: <1545837072.31.0.162668076573.issue35579@roundup.psfhosted.org>


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


New changeset dcf14d1a9875143747cd87c66fae6e693b21c6de by Miss Islington (bot) in branch '3.7':
bpo-35579: Fix typo in in asyncio-task documentation (GH-11321)
https://github.com/python/cpython/commit/dcf14d1a9875143747cd87c66fae6e693b21c6de


----------

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

From report at bugs.python.org  Wed Dec 26 10:23:59 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 26 Dec 2018 15:23:59 +0000
Subject: [docs] [issue35579] Typo in in asyncio-task documentation
In-Reply-To: <1545669840.38.0.712150888896.issue35579@roundup.psfhosted.org>
Message-ID: <1545837834.36.0.770858420497.issue35579@roundup.psfhosted.org>


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


New changeset 3a81076bbf899b1a549f005dd9299e7ae0946321 by Miss Islington (bot) (Vaibhav Gupta) in branch 'master':
bpo-35579: Fix typo in in asyncio-task documentation (GH-11321)
https://github.com/python/cpython/commit/3a81076bbf899b1a549f005dd9299e7ae0946321


----------

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

From report at bugs.python.org  Wed Dec 26 10:24:47 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 26 Dec 2018 15:24:47 +0000
Subject: [docs] [issue35579] Typo in in asyncio-task documentation
In-Reply-To: <1545669840.38.0.712150888896.issue35579@roundup.psfhosted.org>
Message-ID: <1545837882.07.0.0731571945779.issue35579@roundup.psfhosted.org>


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


New changeset 3a81076bbf899b1a549f005dd9299e7ae0946321 by Miss Islington (bot) (Vaibhav Gupta) in branch 'master':
bpo-35579: Fix typo in in asyncio-task documentation (GH-11321)
https://github.com/python/cpython/commit/3a81076bbf899b1a549f005dd9299e7ae0946321


----------

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

From report at bugs.python.org  Wed Dec 26 11:46:01 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 26 Dec 2018 16:46:01 +0000
Subject: [docs] [issue35579] Typo in in asyncio-task documentation
In-Reply-To: <1545669840.38.0.712150888896.issue35579@roundup.psfhosted.org>
Message-ID: <1545842756.08.0.44699306818.issue35579@roundup.psfhosted.org>


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


New changeset 3a81076bbf899b1a549f005dd9299e7ae0946321 by Miss Islington (bot) (Vaibhav Gupta) in branch 'master':
bpo-35579: Fix typo in in asyncio-task documentation (GH-11321)
https://github.com/python/cpython/commit/3a81076bbf899b1a549f005dd9299e7ae0946321


----------

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

From report at bugs.python.org  Wed Dec 26 11:46:18 2018
From: report at bugs.python.org (miss-islington)
Date: Wed, 26 Dec 2018 16:46:18 +0000
Subject: [docs] [issue35579] Typo in in asyncio-task documentation
In-Reply-To: <1545669840.38.0.712150888896.issue35579@roundup.psfhosted.org>
Message-ID: <1545842774.36.0.18991582336.issue35579@roundup.psfhosted.org>


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


New changeset dcf14d1a9875143747cd87c66fae6e693b21c6de by Miss Islington (bot) in branch '3.7':
bpo-35579: Fix typo in in asyncio-task documentation (GH-11321)
https://github.com/python/cpython/commit/dcf14d1a9875143747cd87c66fae6e693b21c6de


----------

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

From tljarolimek at gmail.com  Wed Dec 26 20:06:25 2018
From: tljarolimek at gmail.com (Todd 308)
Date: Wed, 26 Dec 2018 17:06:25 -0800
Subject: [docs] Involvement with Development, Document Development
Message-ID: <CAH+z9PYw3xjaPGv6nydJfYA8NKKnp+HvZ4F3GSyQ3FJTEPb5Sg@mail.gmail.com>

Hello,

If this is Guido, thanks for your contribution to the world of programming.
Otherwise, thanks for your contribution too.

I'd like to become involved in the development of python and the
development of documentation type things and such.

Can you offer a pointer to where I can begin doing this?

Best regards,
Todd Jarolimek
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181226/405cd1f7/attachment.html>

From report at bugs.python.org  Thu Dec 27 03:59:31 2018
From: report at bugs.python.org (miss-islington)
Date: Thu, 27 Dec 2018 08:59:31 +0000
Subject: [docs] [issue35579] Typo in in asyncio-task documentation
In-Reply-To: <1545669840.38.0.712150888896.issue35579@roundup.psfhosted.org>
Message-ID: <1545901168.67.0.873776594352.issue35579@roundup.psfhosted.org>


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


New changeset 3a81076bbf899b1a549f005dd9299e7ae0946321 by Miss Islington (bot) (Vaibhav Gupta) in branch 'master':
bpo-35579: Fix typo in in asyncio-task documentation (GH-11321)
https://github.com/python/cpython/commit/3a81076bbf899b1a549f005dd9299e7ae0946321


----------

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

From report at bugs.python.org  Thu Dec 27 03:59:45 2018
From: report at bugs.python.org (miss-islington)
Date: Thu, 27 Dec 2018 08:59:45 +0000
Subject: [docs] [issue35579] Typo in in asyncio-task documentation
In-Reply-To: <1545669840.38.0.712150888896.issue35579@roundup.psfhosted.org>
Message-ID: <1545901181.22.0.922257577777.issue35579@roundup.psfhosted.org>


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


New changeset dcf14d1a9875143747cd87c66fae6e693b21c6de by Miss Islington (bot) in branch '3.7':
bpo-35579: Fix typo in in asyncio-task documentation (GH-11321)
https://github.com/python/cpython/commit/dcf14d1a9875143747cd87c66fae6e693b21c6de


----------

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

From report at bugs.python.org  Thu Dec 27 05:18:25 2018
From: report at bugs.python.org (Antoine Wecxsteen)
Date: Thu, 27 Dec 2018 10:18:25 +0000
Subject: [docs] [issue35579] Typo in in asyncio-task documentation
In-Reply-To: <1545669840.38.0.712150888896.issue35579@roundup.psfhosted.org>
Message-ID: <1545905902.48.0.605104656428.issue35579@roundup.psfhosted.org>


Antoine Wecxsteen <antoine at wecxsteen.net> added the comment:

Thank you all.

----------

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

From mariatta.wijaya at gmail.com  Thu Dec 27 11:46:59 2018
From: mariatta.wijaya at gmail.com (Mariatta Wijaya)
Date: Thu, 27 Dec 2018 08:46:59 -0800
Subject: [docs] Involvement with Development, Document Development
In-Reply-To: <CAH+z9PYw3xjaPGv6nydJfYA8NKKnp+HvZ4F3GSyQ3FJTEPb5Sg@mail.gmail.com>
References: <CAH+z9PYw3xjaPGv6nydJfYA8NKKnp+HvZ4F3GSyQ3FJTEPb5Sg@mail.gmail.com>
Message-ID: <CAGbohnYB9VqR+F-3wQ1_wntFewBGFotWUC4pby2U6nBsUkJaZA@mail.gmail.com>

Welcome and thanks for your interest in contributing.

You can check Python DevGuide (https://devguide.python.org/) to get started
in contributing, and there is a section on contributing to documentation. (
https://devguide.python.org/docquality/)


On Wed, Dec 26, 2018, 11:44 PM Todd 308 <tljarolimek at gmail.com wrote:

> Hello,
>
> If this is Guido, thanks for your contribution to the world of
> programming. Otherwise, thanks for your contribution too.
>
> I'd like to become involved in the development of python and the
> development of documentation type things and such.
>
> Can you offer a pointer to where I can begin doing this?
>
> Best regards,
> Todd Jarolimek
> _______________________________________________
> docs mailing list
> docs at python.org
> https://mail.python.org/mailman/listinfo/docs
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181227/dff7be3c/attachment.html>

From calam12 at gmail.com  Thu Dec 27 18:36:47 2018
From: calam12 at gmail.com (Carlo Lam)
Date: Thu, 27 Dec 2018 15:36:47 -0800
Subject: [docs] horrible example for shlex .... rm -rf?
Message-ID: <CAGJFCaLqgdCW5bMT9zJ+dShhEo69gCEWL2DtGNdnWYZyWKp+KA@mail.gmail.com>

Hello Python Docs,

I am no expert of python, but i do know linux quite a bit, and I was
astonished to see that you show as example a rm -rf ~ , i will suggest to
perhaps find a better example as this could be terrible for someone who
does not know linux either.

https://docs.python.org/3/library/shlex.html
look in the quote example.

Thank you,
Carlo
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181227/c9943bc3/attachment.html>

From mariatta.wijaya at gmail.com  Fri Dec 28 00:33:46 2018
From: mariatta.wijaya at gmail.com (Mariatta Wijaya)
Date: Thu, 27 Dec 2018 21:33:46 -0800
Subject: [docs] horrible example for shlex .... rm -rf?
In-Reply-To: <CAGJFCaLqgdCW5bMT9zJ+dShhEo69gCEWL2DtGNdnWYZyWKp+KA@mail.gmail.com>
References: <CAGJFCaLqgdCW5bMT9zJ+dShhEo69gCEWL2DtGNdnWYZyWKp+KA@mail.gmail.com>
Message-ID: <CAGbohnayauMUjdpXGVk4uwy+YyTLTqQhXHMkTLpTkJn3V_hZzA@mail.gmail.com>

I think the example of `rm -rf` was chosen mainly to demonstrate that it is
unsafe, and therefore you need to use shlex.quote.

But if people can recommend another example that is not as severe as `rm
-rf`, perhaps we can consider changing it.

On Thu, Dec 27, 2018, 6:30 PM Carlo Lam <calam12 at gmail.com wrote:

> Hello Python Docs,
>
> I am no expert of python, but i do know linux quite a bit, and I was
> astonished to see that you show as example a rm -rf ~ , i will suggest to
> perhaps find a better example as this could be terrible for someone who
> does not know linux either.
>
> https://docs.python.org/3/library/shlex.html
> look in the quote example.
>
> Thank you,
> Carlo
> _______________________________________________
> docs mailing list
> docs at python.org
> https://mail.python.org/mailman/listinfo/docs
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181227/ce100ac0/attachment.html>

From report at bugs.python.org  Fri Dec 28 05:20:26 2018
From: report at bugs.python.org (manchun kumar)
Date: Fri, 28 Dec 2018 10:20:26 +0000
Subject: [docs] [issue35604] Is python used more than Java Nowadays?
Message-ID: <1545992421.85.0.893262731106.issue35604@roundup.psfhosted.org>


New submission from manchun kumar <manchun.pandit at janbask.com>:

Whether we should choose Python or Java! Which one is easy or which is used more often?

These questions are natural if you belong to this industry where everyone is talking about this. Programmers community endlessly debate about these two languages and the discussion about which language is best seems endless.

But yes, Python has become the talk of the town and used by so many programmers. 

I think it?s totally worth looking differences and similarities they share, advantages, disadvantages, ideal use cases and other factors. Using Java or Python actually depends on the experience and interest of developer like experience with respect to coding style, language, application-development requirements, etc. 

I have consistently observed both of them are equally important but yes, in today?s condition, it is great to say that I know Python like a Pro. Python adds a lot of value to your profile. This is all due to the huge demand for Data mining, big data, machine learning, IOT, Artificial intelligence, etc. The reason for Python?s preference is the widely spread scientific community, academic institutions and other efficient sources that have availed thousands of different ways to learn python with ease. This also makes people bag good job opportunities with Python. Thanks to the tons of libraries!
https://www.janbasktraining.com/blog/python-programming-tutorial/
Businesses, organizations as well as the people have very well accepted that Python is easy to use and can be efficiently used for tricky tasks like writing a mobile app, making high-end games as well as writing web server without a hitch.

----------
assignee: docs at python
components: Documentation
messages: 332651
nosy: docs at python, manchun
priority: normal
severity: normal
status: open
title: Is python used more than Java Nowadays?
type: performance
versions: Python 3.7

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

From anatoli at rainforce.org  Fri Dec 28 02:32:38 2018
From: anatoli at rainforce.org (Anatoli Babenia)
Date: Fri, 28 Dec 2018 10:32:38 +0300
Subject: [docs] Disconnected HTTPConnection and HTTPResponse docs
In-Reply-To: <vTzf-Ts1U7hBfZSPxz3UPmyKnqMZ1NWxe5fEhWA3PsDPzqZW9aTghXHHV05AuXf4pmLebGjPZOlRIWmApWaVvUMNlUwyxVuKKBiifdgvUwg=@palard.fr>
References: <CAK=cShjNyn_=7gwWd95EgW7ROHvKGPjkX9UhAUEu4LxF3nMXJw@mail.gmail.com>
 <vTzf-Ts1U7hBfZSPxz3UPmyKnqMZ1NWxe5fEhWA3PsDPzqZW9aTghXHHV05AuXf4pmLebGjPZOlRIWmApWaVvUMNlUwyxVuKKBiifdgvUwg=@palard.fr>
Message-ID: <CAK=cShjyVv-nz6gxj-Ry1skE_XWOLsraKvK2RdwfswEKxRc00A@mail.gmail.com>

Hello Julien.

There is no backlink from class definitions to class explanations. The rest
of the documentation links to class definitions making methods
non-discoverable.

On Wed, 26 Dec 2018 at 00:52, Julien Palard <julien at palard.fr> wrote:

> Hi Anatoli, thanks for reporting,
>
> Looks like the 2nd word of
> https://docs.python.org/3/library/http.client.html#httpresponse-objects
> is a link to
> https://docs.python.org/3/library/http.client.html#http.client.HTTPResponse,
> isn't this enough? Or did I understand your message wrong?
>
> Bests,
> --
> Julien Palard
> https://mdk.fr
>
>
> ??????? Original Message ???????
> On Wednesday 19 December 2018 13:53, Anatoli Babenia <
> anatoli at rainforce.org> wrote:
>
> Hello.
>
> Found this email in documentation page.
>
> It is hard to find parameters for HTTPResponse, because texts
> describing its parameters are separated by differen documentaion
> block and are not linked together.
> https://docs.python.org/3/library/http.client.html#http.client.HTTPResponse
> https://docs.python.org/3/library/http.client.html#httpresponse-objects
>
> The same is true for HTTPConnection.
>
> https://docs.python.org/3/library/http.client.html#http.client.HTTPConnection
> https://docs.python.org/3/library/http.client.html#httpconnection-objects
>
> --
> Anatoli Babenia
>
> +1 (650) 605-3365
> +375 (29) 320-4241
>
>
>

-- 
Anatoli Babenia

+1 (650) 605-3365
+375 (29) 320-4241
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20181228/720c4b47/attachment-0001.html>

From report at bugs.python.org  Fri Dec 28 06:50:35 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Fri, 28 Dec 2018 11:50:35 +0000
Subject: [docs] [issue35604] Is python used more than Java Nowadays?
In-Reply-To: <1545992421.85.0.893262731106.issue35604@roundup.psfhosted.org>
Message-ID: <1545997833.14.0.70658257566.issue35604@roundup.psfhosted.org>


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

Please add some context over what this has to do with performance and docs category. The tracker might not be the appropriate place to have language debates. Please specify the outcome of the issue since your description has no actionable item or the problem you are trying to solve with the issue.

Thanks

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

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

From report at bugs.python.org  Fri Dec 28 08:35:35 2018
From: report at bugs.python.org (Steven D'Aprano)
Date: Fri, 28 Dec 2018 13:35:35 +0000
Subject: [docs] [issue35604] Is python used more than Java Nowadays?
In-Reply-To: <1545992421.85.0.893262731106.issue35604@roundup.psfhosted.org>
Message-ID: <1546004133.05.0.200890289605.issue35604@roundup.psfhosted.org>


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

This is spam.

----------
nosy: +steven.daprano
resolution:  -> not a bug
stage:  -> resolved
status: open -> closed

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

From report at bugs.python.org  Fri Dec 28 12:00:40 2018
From: report at bugs.python.org (Anthony Sottile)
Date: Fri, 28 Dec 2018 17:00:40 +0000
Subject: [docs] [issue35605] backported patch requires new sphinx,
 minimum sphinx version was not bumped
Message-ID: <1546016436.32.0.942702382011.issue35605@roundup.psfhosted.org>


New submission from Anthony Sottile <asottile at umich.edu>:

Noticed this while packaging 3.6.8 for deadsnakes (ubuntu ppa)

This patch: https://github.com/python/cpython/pull/11251

Requires a version of sphinx where `sphinx.util.logging.getLogger` is available.  It appears that the first version which that was available was 1.6: https://github.com/sphinx-doc/sphinx/commit/6d4e6454093953943e79d4db6efeb17390870e62#diff-db360b033c6011189d978db1a4b7dcb7

For example, on ubuntu xenial (16.04) the newest packaged version of python3-sphinx available is 1.3.6 (released 2016-02) which satisfies the "minimum version": https://github.com/python/cpython/blob/3c6b436a57893dd1fae4e072768f41a199076252/Doc/conf.py#L36-L37

I hacked around it in this case by just using `logging.getLogger`: https://github.com/deadsnakes/python3.6/commit/9ba2234f35087a4bf67e3aecf2bd8dd0e3f67186

I'm not sure what the right answer is here, bumping the minimum version will make it _harder_ for packagers -- though I understand continuing to support old (2 years ago) things can be cumbersome.

----------
assignee: docs at python
components: Build, Documentation
messages: 332665
nosy: Anthony Sottile, docs at python
priority: normal
severity: normal
status: open
title: backported patch requires new sphinx, minimum sphinx version was not bumped
versions: Python 3.6

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

From report at bugs.python.org  Fri Dec 28 12:02:33 2018
From: report at bugs.python.org (Anthony Sottile)
Date: Fri, 28 Dec 2018 17:02:33 +0000
Subject: [docs] [issue35605] backported patch requires new sphinx,
 minimum sphinx version was not bumped
In-Reply-To: <1546016436.32.0.942702382011.issue35605@roundup.psfhosted.org>
Message-ID: <1546016548.11.0.582419139648.issue35605@roundup.psfhosted.org>


Anthony Sottile <asottile at umich.edu> added the comment:

oops, pressed the button too quickly, meant to mention that sphinx 1.6 was released 2017-05

----------

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

From report at bugs.python.org  Fri Dec 28 12:09:45 2018
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Fri, 28 Dec 2018 17:09:45 +0000
Subject: [docs] [issue35605] backported patch requires new sphinx,
 minimum sphinx version was not bumped
In-Reply-To: <1546016436.32.0.942702382011.issue35605@roundup.psfhosted.org>
Message-ID: <1546016983.96.0.823125918433.issue35605@roundup.psfhosted.org>


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


----------
nosy: +mdk, steve.dower

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

From report at bugs.python.org  Fri Dec 28 14:13:16 2018
From: report at bugs.python.org (Steve Dower)
Date: Fri, 28 Dec 2018 19:13:16 +0000
Subject: [docs] [issue35605] backported patch requires new sphinx,
 minimum sphinx version was not bumped
In-Reply-To: <1546016436.32.0.942702382011.issue35605@roundup.psfhosted.org>
Message-ID: <1546024393.48.0.595767529932.issue35605@roundup.psfhosted.org>


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

We need Ned's approval to fix anything in 3.6 now. Typically we do consider build issues, and this one is fairly innocent (the affected code should only be used on Windows, but the import may trigger elsewhere).

I'd be happy to take a patch to use logging when the sphinx one is not found. We more or less enforce a newer version of Sphinx on the platforms where it matters, but for those restricted by their distros we can pretty easily help out.

----------
keywords: +easy
nosy: +ned.deily
priority: normal -> low

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

From report at bugs.python.org  Fri Dec 28 15:00:40 2018
From: report at bugs.python.org (Ned Deily)
Date: Fri, 28 Dec 2018 20:00:40 +0000
Subject: [docs] [issue35605] backported patch requires new sphinx,
 minimum sphinx version was not bumped
In-Reply-To: <1546016436.32.0.942702382011.issue35605@roundup.psfhosted.org>
Message-ID: <1546027235.79.0.600170375242.issue35605@roundup.psfhosted.org>


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

I would view this as a build regression in 3.6.8 so I would accept a fix for the 3.6 branch.

----------

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

From report at bugs.python.org  Fri Dec 28 16:16:59 2018
From: report at bugs.python.org (Anthony Sottile)
Date: Fri, 28 Dec 2018 21:16:59 +0000
Subject: [docs] [issue35605] backported patch requires new sphinx,
 minimum sphinx version was not bumped
In-Reply-To: <1546016436.32.0.942702382011.issue35605@roundup.psfhosted.org>
Message-ID: <1546031817.46.0.36955512684.issue35605@roundup.psfhosted.org>


Anthony Sottile <asottile at umich.edu> added the comment:

If I add a patch which is essentially:


try:  # sphinx>=1.6
    from sphinx.util.logging import getLogger
except ImportError:  # sphinx<1.6
    from logging import getLogger

will that be fine?

and should I open that against 3.7 to be backported or just against 3.6 (I also ran into the same issue when backporting 3.7.2 for xenial -- but there I adjusted the minimum sphinx version: https://github.com/deadsnakes/python3.7/commit/c27b89bc7032d0b072b46c7425e5b32788f1c0fd )

----------

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

From report at bugs.python.org  Fri Dec 28 17:00:52 2018
From: report at bugs.python.org (Steve Dower)
Date: Fri, 28 Dec 2018 22:00:52 +0000
Subject: [docs] [issue35605] backported patch requires new sphinx,
 minimum sphinx version was not bumped
In-Reply-To: <1546016436.32.0.942702382011.issue35605@roundup.psfhosted.org>
Message-ID: <1546034448.46.0.0386732259546.issue35605@roundup.psfhosted.org>


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

I think we're okay to increase the minimum version on the active branches.

----------

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

From report at bugs.python.org  Fri Dec 28 17:06:17 2018
From: report at bugs.python.org (Anthony Sottile)
Date: Fri, 28 Dec 2018 22:06:17 +0000
Subject: [docs] [issue35605] backported patch requires new sphinx,
 minimum sphinx version was not bumped
In-Reply-To: <1546016436.32.0.942702382011.issue35605@roundup.psfhosted.org>
Message-ID: <1546034772.29.0.388378152109.issue35605@roundup.psfhosted.org>


Anthony Sottile <asottile at umich.edu> added the comment:

I assume that means I should only target 3.6 -- does the patch look like the right approach? I can make a PR

----------

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

From report at bugs.python.org  Fri Dec 28 18:01:38 2018
From: report at bugs.python.org (Ned Deily)
Date: Fri, 28 Dec 2018 23:01:38 +0000
Subject: [docs] [issue35605] backported patch requires new sphinx,
 minimum sphinx version was not bumped
In-Reply-To: <1546016436.32.0.942702382011.issue35605@roundup.psfhosted.org>
Message-ID: <1546038093.95.0.0072144956295.issue35605@roundup.psfhosted.org>


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

Julien (@mdk) is the doc builds expert.

----------
assignee: docs at python -> mdk

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

From report at bugs.python.org  Fri Dec 28 22:05:55 2018
From: report at bugs.python.org (Emmanuel Arias)
Date: Sat, 29 Dec 2018 03:05:55 +0000
Subject: [docs] [issue35609] Improve of abc.py docstring
Message-ID: <1546052751.93.0.333388893142.issue35609@roundup.psfhosted.org>


New submission from Emmanuel Arias <emmanuelarias30 at gmail.com>:

Hi!

I prepare a little improve. I added some samples usage, some clarification and delete some whitespace unnecessary.

Attach patch. 

Regards

----------
assignee: docs at python
components: Documentation
files: 0001-improve-abc.py-docstring.patch
keywords: patch
messages: 332693
nosy: docs at python, eamanu
priority: normal
severity: normal
status: open
title: Improve of abc.py docstring
type: enhancement
versions: Python 3.8
Added file: https://bugs.python.org/file48021/0001-improve-abc.py-docstring.patch

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

From report at bugs.python.org  Fri Dec 28 22:15:52 2018
From: report at bugs.python.org (Emmanuel Arias)
Date: Sat, 29 Dec 2018 03:15:52 +0000
Subject: [docs] [issue35609] Improve of abc.py docstring
In-Reply-To: <1546052751.93.0.333388893142.issue35609@roundup.psfhosted.org>
Message-ID: <1546053352.63.0.0309836333975.issue35609@roundup.psfhosted.org>


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


----------
pull_requests: +10653
stage:  -> patch review

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

From report at bugs.python.org  Fri Dec 28 22:15:58 2018
From: report at bugs.python.org (Emmanuel Arias)
Date: Sat, 29 Dec 2018 03:15:58 +0000
Subject: [docs] [issue35609] Improve of abc.py docstring
In-Reply-To: <1546052751.93.0.333388893142.issue35609@roundup.psfhosted.org>
Message-ID: <1546053358.38.0.734407257173.issue35609@roundup.psfhosted.org>


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


----------
pull_requests: +10653, 10654
stage:  -> patch review

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

From report at bugs.python.org  Fri Dec 28 22:16:04 2018
From: report at bugs.python.org (Emmanuel Arias)
Date: Sat, 29 Dec 2018 03:16:04 +0000
Subject: [docs] [issue35609] Improve of abc.py docstring
In-Reply-To: <1546052751.93.0.333388893142.issue35609@roundup.psfhosted.org>
Message-ID: <1546053364.23.0.579510036304.issue35609@roundup.psfhosted.org>


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


----------
pull_requests: +10653, 10654, 10655
stage:  -> patch review

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

From report at bugs.python.org  Sat Dec 29 02:56:40 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 29 Dec 2018 07:56:40 +0000
Subject: [docs] [issue35609] Improve of abc.py docstring
In-Reply-To: <1546052751.93.0.333388893142.issue35609@roundup.psfhosted.org>
Message-ID: <1546070199.17.0.0775909462125.issue35609@roundup.psfhosted.org>


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

Double spaces between sentences increase readability. This is not a bug.

Since abstractclassmethod and like are deprecated and should not be used in new code, I do not see a value of extending their docstrings. Too verbose docstrings make using the module help less convenient. I would rather remove existing examples from docstrings. The module documentation contains more modern examples.

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

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

From report at bugs.python.org  Sat Dec 29 07:12:26 2018
From: report at bugs.python.org (Denton Liu)
Date: Sat, 29 Dec 2018 12:12:26 +0000
Subject: [docs] [issue35155] Clarify Protocol Handlers in urllib.request Docs
In-Reply-To: <1541286673.86.0.788709270274.issue35155@psf.upfronthosting.co.za>
Message-ID: <1546085544.81.0.0759815665841.issue35155@roundup.psfhosted.org>


Denton Liu <liu.denton at gmail.com> added the comment:

Pinging again for updates. Would appreciate a PR review. Thanks!

----------

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

From report at bugs.python.org  Sat Dec 29 08:51:00 2018
From: report at bugs.python.org (Emmanuel Arias)
Date: Sat, 29 Dec 2018 13:51:00 +0000
Subject: [docs] [issue35609] Improve of abc.py docstring
In-Reply-To: <1546052751.93.0.333388893142.issue35609@roundup.psfhosted.org>
Message-ID: <1546091458.56.0.0967322741102.issue35609@roundup.psfhosted.org>


Emmanuel Arias <emmanuelarias30 at gmail.com> added the comment:

> Double spaces between sentences increase readability. This is not a bug.

hmm ok. I can see other docstring with not double spaces. But I will ignore. 

> Since abstractclassmethod and like are deprecated and should not be used in new code, I do not see a value of extending their docstrings. 

Ok, you are right. 

> Too verbose docstrings make using the module help less convenient. I would rather remove existing examples from docstrings. The module documentation contains more modern examples.

Do you say that is convenient remove the examples? I can do it! But in defense of the examples on docstring I think those are good, because the are the most quickly reference when coding and those are use by IDE.

----------

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

From report at bugs.python.org  Sat Dec 29 09:39:58 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 29 Dec 2018 14:39:58 +0000
Subject: [docs] [issue35609] Improve of abc.py docstring
In-Reply-To: <1546052751.93.0.333388893142.issue35609@roundup.psfhosted.org>
Message-ID: <1546094396.87.0.464961533254.issue35609@roundup.psfhosted.org>


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

These examples teach you how to use abstractclassmethod and similar decorators. But first, docstrings are not tutorial, and second, you should not use them in new code at all, because they are deprecated.

----------

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

From report at bugs.python.org  Sat Dec 29 10:28:20 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 29 Dec 2018 15:28:20 +0000
Subject: [docs] [issue35609] Improve of abc.py docstring
In-Reply-To: <1546052751.93.0.333388893142.issue35609@roundup.psfhosted.org>
Message-ID: <1546097300.59.0.111182296837.issue35609@roundup.psfhosted.org>


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


----------
pull_requests: +10664

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

From report at bugs.python.org  Sat Dec 29 10:28:28 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 29 Dec 2018 15:28:28 +0000
Subject: [docs] [issue35609] Improve of abc.py docstring
In-Reply-To: <1546052751.93.0.333388893142.issue35609@roundup.psfhosted.org>
Message-ID: <1546097308.2.0.154361539842.issue35609@roundup.psfhosted.org>


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


----------
pull_requests: +10664, 10665

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

From report at bugs.python.org  Sat Dec 29 10:28:35 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 29 Dec 2018 15:28:35 +0000
Subject: [docs] [issue35609] Improve of abc.py docstring
In-Reply-To: <1546052751.93.0.333388893142.issue35609@roundup.psfhosted.org>
Message-ID: <1546097315.26.0.859034954114.issue35609@roundup.psfhosted.org>


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


----------
pull_requests: +10664, 10665, 10666

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

From report at bugs.python.org  Sat Dec 29 17:00:10 2018
From: report at bugs.python.org (Julien Palard)
Date: Sat, 29 Dec 2018 22:00:10 +0000
Subject: [docs] [issue35605] backported patch requires new sphinx,
 minimum sphinx version was not bumped
In-Reply-To: <1546016436.32.0.942702382011.issue35605@roundup.psfhosted.org>
Message-ID: <1546120806.69.0.0548198365463.issue35605@roundup.psfhosted.org>


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

The patch (try/except) to make https://github.com/python/cpython/pull/11251/files work with what Doc/conf.py says about minimum sphinx version (1.2) is OK for me.

No need to apply it on 3.7 which needs_sphinx 1.6.6 according to its Doc/conf.py.

----------

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

From report at bugs.python.org  Sat Dec 29 23:52:25 2018
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 30 Dec 2018 04:52:25 +0000
Subject: [docs] [issue35616] Change references to '4.0'.
Message-ID: <1546145542.58.0.745728606206.issue35616@roundup.psfhosted.org>


New submission from Terry J. Reedy <tjreedy at udel.edu>:

https://docs.python.org/3/c-api/unicode.html#deprecated-py-unicode-apis
says "Deprecated since version 3.3, will be removed in version 4.0."
(I am aware that the quote above was written before we decided that '3.9' should be followed by '3.10' rather than '4.0' to avoid giving mis-impressions.)

There is currently no plan for a '4.0' and part of the reason is that it stirs up unnecessary negative feeling in people.  For example:
https://stackoverflow.com/questions/53899931/why-does-an-empty-string-in-python-sometimes-take-up-49-bytes-and-sometimes-51
The second most upvoted comment (9) is "seeing a reference to a "[Python] 4.0" is giving me anxiety..." ? Mike Caron (11000+ reputation).  We, as well as they, don't need this.

When '4.0' was used in an asyncio deprecation, it was changed.  Let us do the same elsewhere.

----------
assignee: docs at python
components: Documentation
messages: 332745
nosy: docs at python, terry.reedy, vstinner
priority: normal
severity: normal
stage: needs patch
status: open
title: Change references to '4.0'.
versions: Python 3.7, Python 3.8

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

From report at bugs.python.org  Sun Dec 30 00:50:28 2018
From: report at bugs.python.org (Emmanuel Arias)
Date: Sun, 30 Dec 2018 05:50:28 +0000
Subject: [docs] [issue35616] Change references to '4.0'.
In-Reply-To: <1546145542.58.0.745728606206.issue35616@roundup.psfhosted.org>
Message-ID: <1546149028.9.0.752106570431.issue35616@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Sun Dec 30 00:50:34 2018
From: report at bugs.python.org (Emmanuel Arias)
Date: Sun, 30 Dec 2018 05:50:34 +0000
Subject: [docs] [issue35616] Change references to '4.0'.
In-Reply-To: <1546145542.58.0.745728606206.issue35616@roundup.psfhosted.org>
Message-ID: <1546149034.89.0.111761569026.issue35616@roundup.psfhosted.org>


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


----------
keywords: +patch, patch
pull_requests: +10688, 10689
stage: needs patch -> patch review

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

From report at bugs.python.org  Sun Dec 30 00:50:40 2018
From: report at bugs.python.org (Emmanuel Arias)
Date: Sun, 30 Dec 2018 05:50:40 +0000
Subject: [docs] [issue35616] Change references to '4.0'.
In-Reply-To: <1546145542.58.0.745728606206.issue35616@roundup.psfhosted.org>
Message-ID: <1546149040.94.0.756115997662.issue35616@roundup.psfhosted.org>


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


----------
keywords: +patch, patch, patch
pull_requests: +10688, 10689, 10690
stage: needs patch -> patch review

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

From report at bugs.python.org  Sun Dec 30 01:19:41 2018
From: report at bugs.python.org (Emmanuel Arias)
Date: Sun, 30 Dec 2018 06:19:41 +0000
Subject: [docs] [issue35616] Change references to '4.0'.
In-Reply-To: <1546145542.58.0.745728606206.issue35616@roundup.psfhosted.org>
Message-ID: <1546150780.31.0.513711490323.issue35616@roundup.psfhosted.org>


Emmanuel Arias <emmanuelarias30 at gmail.com> added the comment:

Same similar occur with other docs

$ git grep 'deprecated-removed::.*4\.0'
Doc/c-api/arg.rst:   .. deprecated-removed:: 3.3 4.0
Doc/c-api/arg.rst:   .. deprecated-removed:: 3.3 4.0
Doc/c-api/arg.rst:   .. deprecated-removed:: 3.3 4.0
Doc/c-api/arg.rst:   .. deprecated-removed:: 3.3 4.0
Doc/c-api/long.rst:   .. deprecated-removed:: 3.3 4.0
Doc/library/array.rst:   .. deprecated-removed:: 3.3 4.0
Doc/library/functions.rst:   .. deprecated-removed:: 3.4 4.0

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

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

From report at bugs.python.org  Sun Dec 30 12:59:19 2018
From: report at bugs.python.org (Anthony Sottile)
Date: Sun, 30 Dec 2018 17:59:19 +0000
Subject: [docs] [issue35605] backported patch requires new sphinx,
 minimum sphinx version was not bumped
In-Reply-To: <1546016436.32.0.942702382011.issue35605@roundup.psfhosted.org>
Message-ID: <1546192758.08.0.482472832716.issue35605@roundup.psfhosted.org>


Change by Anthony Sottile <asottile at umich.edu>:


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

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

From report at bugs.python.org  Sun Dec 30 12:59:27 2018
From: report at bugs.python.org (Anthony Sottile)
Date: Sun, 30 Dec 2018 17:59:27 +0000
Subject: [docs] [issue35605] backported patch requires new sphinx,
 minimum sphinx version was not bumped
In-Reply-To: <1546016436.32.0.942702382011.issue35605@roundup.psfhosted.org>
Message-ID: <1546192766.1.0.266088499352.issue35605@roundup.psfhosted.org>


Change by Anthony Sottile <asottile at umich.edu>:


----------
keywords: +patch, patch
pull_requests: +10704, 10705
stage:  -> patch review

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

From report at bugs.python.org  Sun Dec 30 12:59:34 2018
From: report at bugs.python.org (Anthony Sottile)
Date: Sun, 30 Dec 2018 17:59:34 +0000
Subject: [docs] [issue35605] backported patch requires new sphinx,
 minimum sphinx version was not bumped
In-Reply-To: <1546016436.32.0.942702382011.issue35605@roundup.psfhosted.org>
Message-ID: <1546192773.82.0.252590626398.issue35605@roundup.psfhosted.org>


Change by Anthony Sottile <asottile at umich.edu>:


----------
keywords: +patch, patch, patch
pull_requests: +10704, 10705, 10706
stage:  -> patch review

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

From report at bugs.python.org  Mon Dec 31 02:56:25 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 31 Dec 2018 07:56:25 +0000
Subject: [docs] [issue35609] Improve of abc.py docstring
In-Reply-To: <1546052751.93.0.333388893142.issue35609@roundup.psfhosted.org>
Message-ID: <1546242983.76.0.890004571264.issue35609@roundup.psfhosted.org>


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


New changeset 5c117dd227e1b4c4f0a62564d8592f1ba45c91eb by Serhiy Storchaka in branch 'master':
bpo-35609: Remove examples for deprecated decorators in the abc module. (GH-11355)
https://github.com/python/cpython/commit/5c117dd227e1b4c4f0a62564d8592f1ba45c91eb


----------

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

From report at bugs.python.org  Mon Dec 31 03:26:05 2018
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 31 Dec 2018 08:26:05 +0000
Subject: [docs] [issue35609] Improve of abc.py docstring
In-Reply-To: <1546052751.93.0.333388893142.issue35609@roundup.psfhosted.org>
Message-ID: <1546244765.5.0.326079630914.issue35609@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Mon Dec 31 05:48:03 2018
From: report at bugs.python.org (bzip2)
Date: Mon, 31 Dec 2018 10:48:03 +0000
Subject: [docs] [issue35625] documentation of list,
 set & dict comprehension make no mention of buggy class scope
 behavior
Message-ID: <1546253280.49.0.920078772343.issue35625@roundup.psfhosted.org>


New submission from bzip2 <adnan.derti at gmail.com>:

The sections on list, set and dict comprehensions in the tutorial on data structures (ref. 1) state repeatedly that they are equivalent to for loops, but do not mention that this is not true in classes. In fact, the example used for nested list comprehensions (section 5.1.4) will work in a function, but not in a class. Similarly, there seems to be no mention of this scope "limitation" in the tutorial on classes (ref. 2), despite a section on scopes and namespaces (section 9.2) and another that mentions list comprehensions (section 9.10). The scope "limitation" is mentioned at the end of a section on resolution of names on a page about the execution model in the reference guide (ref. 3), and of course in various forums, where people may perhaps eventually find them after wasting time trying to figure out what they've done wrong.

If comprehensions are "equivalent" to for loops only under certain conditions (in a class, but only in a class, only one variable from outside the comprehension is accessible in the comprehension, and it must be the outermost iterable), they are not equivalent and should not be described as such. This "limitation" should be mentioned prominently wherever comprehensions are described, since both classes and comprehensions are presumably common constructs. When people read "is equivalent to" without a qualifier, they assume "is always equivalent to".

Returning to section 9.10 in ref. 2, the unique_words example is misleading because it strongly implies that nested for loops in a comprehension should work in a class. Since that's only true in some cases, the example should be qualified. More broadly, because that tutorial is about classes, the relevance of the last three sections should be revisited.

As an aside, I agree with the developers who consider this scope "limitation" a bug and not (paraphrasing) "just how the language works", since the exact same two lines of code, which depend on no other variables or functions, work in a function or module but not in a class.

1. https://docs.python.org/3/tutorial/datastructures.html
2. https://docs.python.org/3/tutorial/classes.html
3. https://docs.python.org/3/reference/executionmodel.html

----------
assignee: docs at python
components: Documentation
messages: 332808
nosy: bzip2, docs at python
priority: normal
severity: normal
status: open
title: documentation of list, set & dict comprehension make no mention of buggy class scope behavior
type: behavior
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/issue35625>
_______________________________________

From report at bugs.python.org  Mon Dec 31 09:52:27 2018
From: report at bugs.python.org (=?utf-8?q?R=C3=A9mi_Lapeyre?=)
Date: Mon, 31 Dec 2018 14:52:27 +0000
Subject: [docs] [issue33039] int() and math.trunc don't accept objects that
 only define __index__
In-Reply-To: <1520672231.04.0.467229070634.issue33039@psf.upfronthosting.co.za>
Message-ID: <1546267944.45.0.377257569981.issue33039@roundup.psfhosted.org>


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

>I think we should also consider changing the type creation behaviour in 3.8

@ncoghlan is this what's being done in PyTypeReady?

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

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

From report at bugs.python.org  Mon Dec 31 15:53:13 2018
From: report at bugs.python.org (Suriyaa Sundararuban)
Date: Mon, 31 Dec 2018 20:53:13 +0000
Subject: [docs] [issue35630] Missing code tag for "python3" in README.rst
Message-ID: <1546289591.73.0.0479486789763.issue35630@roundup.psfhosted.org>


New submission from Suriyaa Sundararuban <python at suriyaa.tk>:

Currently there is no code tag for "python3" in the sentence "This will install Python as python3." (Location: https://github.com/python/cpython#build-instructions).

I'm working on this small improvement.

----------
assignee: docs at python
components: Documentation
messages: 332832
nosy: docs at python, suriyaa
priority: normal
severity: normal
status: open
title: Missing code tag for "python3" in README.rst
versions: Python 3.8

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

From report at bugs.python.org  Mon Dec 31 15:58:20 2018
From: report at bugs.python.org (Suriyaa Sundararuban)
Date: Mon, 31 Dec 2018 20:58:20 +0000
Subject: [docs] [issue35630] Missing code tag for "python3" in README.rst
In-Reply-To: <1546289591.73.0.0479486789763.issue35630@roundup.psfhosted.org>
Message-ID: <1546289900.85.0.335369936945.issue35630@roundup.psfhosted.org>


Change by Suriyaa Sundararuban <python at suriyaa.tk>:


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

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

From report at bugs.python.org  Mon Dec 31 15:58:25 2018
From: report at bugs.python.org (Suriyaa Sundararuban)
Date: Mon, 31 Dec 2018 20:58:25 +0000
Subject: [docs] [issue35630] Missing code tag for "python3" in README.rst
In-Reply-To: <1546289591.73.0.0479486789763.issue35630@roundup.psfhosted.org>
Message-ID: <1546289905.31.0.544211198574.issue35630@roundup.psfhosted.org>


Change by Suriyaa Sundararuban <python at suriyaa.tk>:


----------
keywords: +patch, patch
pull_requests: +10767, 10768
stage:  -> patch review

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

From report at bugs.python.org  Mon Dec 31 15:58:28 2018
From: report at bugs.python.org (Suriyaa Sundararuban)
Date: Mon, 31 Dec 2018 20:58:28 +0000
Subject: [docs] [issue35630] Missing code tag for "python3" in README.rst
In-Reply-To: <1546289591.73.0.0479486789763.issue35630@roundup.psfhosted.org>
Message-ID: <1546289908.62.0.467881436064.issue35630@roundup.psfhosted.org>


Change by Suriyaa Sundararuban <python at suriyaa.tk>:


----------
keywords: +patch, patch, patch
pull_requests: +10767, 10768, 10769
stage:  -> patch review

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

From report at bugs.python.org  Mon Dec 31 16:01:02 2018
From: report at bugs.python.org (Suriyaa Sundararuban)
Date: Mon, 31 Dec 2018 21:01:02 +0000
Subject: [docs] [issue35630] Missing code tag for "python3" in README.rst
In-Reply-To: <1546289591.73.0.0479486789763.issue35630@roundup.psfhosted.org>
Message-ID: <1546290061.14.0.288740124017.issue35630@roundup.psfhosted.org>


Suriyaa Sundararuban <python at suriyaa.tk> added the comment:

Done.

----------

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