From report at bugs.python.org  Fri Feb  1 03:36:12 2019
From: report at bugs.python.org (Martin Panter)
Date: Fri, 01 Feb 2019 08:36:12 +0000
Subject: [docs] [issue35869] io.BufferReader.read() returns None
In-Reply-To: <1548948110.23.0.999331035986.issue35869@roundup.psfhosted.org>
Message-ID: <1549010171.14.0.306231721234.issue35869@roundup.psfhosted.org>


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

This is covered by Issue 13322. There are a few other BufferedReader methods that contradict the documentation for non-blocking mode.

A while ago I posted a patch to change the implementation to match the documentation, but nobody reviewed it or gave their opinion. These days I would prefer to just documentat the reality: the methods might raise an exception rather than returning None, or perhaps no particular behaviour at all is expected in general in the non-blocking case. But I don?t spend much time on Python now, so you might have to find someone else to move this forward.

Regarding the entry for ?BufferedReader.read?, it would make more sense to remove the last ?if?: ?if ?size? is not given . . ., until EOF, or the ?read? call would block?. But I don?t think even that is complete, because it should also say the read stops and returns short in the non-blocking case even when ?size? is positive.

----------
assignee:  -> docs at python
components: +Documentation, IO
nosy: +docs at python, martin.panter
superseder:  -> buffered read() and write() does not raise BlockingIOError

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

From report at bugs.python.org  Fri Feb  1 04:03:35 2019
From: report at bugs.python.org (Antony Lee)
Date: Fri, 01 Feb 2019 09:03:35 +0000
Subject: [docs] [issue35874] Clarify that the (...) convertor to
 PyArg_ParseTuple... accepts any sequence.
Message-ID: <1549011809.83.0.066679441781.issue35874@roundup.psfhosted.org>


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

The documentation for the accepted types for each format unit in PyArg_ParseTuple (and its variants) is usually quite detailed; compare for example

    y* (bytes-like object) [Py_buffer]
    This variant on s* doesn?t accept Unicode objects, only bytes-like objects. This is the recommended way to accept binary data.

and

    S (bytes) [PyBytesObject *]
    Requires that the Python object is a bytes object, without attempting any conversion. Raises TypeError if the object is not a bytes object. The C variable may also be declared as PyObject*.

There, the type in parenthesis (which is explained as "the entry in (round) parentheses is the Python object type that matches the format unit") differentiates between "bytes-like object" and "bytes".

However, the documentation for "(...)" is a bit more confusing:

    (items) (tuple) [matching-items]
    The object must be a Python sequence whose length is the number of format units in items. The C arguments must correspond to the individual format units in items. Format units for sequences may be nested.

The type in parenthesis is "tuple" (exactly), but the paragraph says "sequence".  The actual behavior appears indeed to be that any sequence (e.g., list, numpy array) is accepted, so I'd suggest changing the type in the parenthesis to "sequence".

----------
assignee: docs at python
components: Documentation
messages: 334660
nosy: Antony.Lee, docs at python
priority: normal
severity: normal
status: open
title: Clarify that the (...) convertor to PyArg_ParseTuple... accepts any sequence.

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

From report at bugs.python.org  Fri Feb  1 06:47:40 2019
From: report at bugs.python.org (Jurjen N.E. Bos)
Date: Fri, 01 Feb 2019 11:47:40 +0000
Subject: [docs] [issue35880] math.sin has no backward error;
 this isn't documented
Message-ID: <1549021657.57.0.382503652198.issue35880@roundup.psfhosted.org>


New submission from Jurjen N.E. Bos <jneb at users.sourceforge.net>:

The documentation of math.sin (and related trig functions) doesn't speak about backward error.
In cPython, as far as I can see, there is no backward error at all, which is quite uncommon.
This may vary between implementations; many math libraries of other languages have a backward error, resulting in large errors for large arguments.
e.g. sin(1<<500) is correctly computed as 0.42925739234242827, where a backward error as small as 1e-150 can give a completely wrong result.

Some text could be added (which I am happy to produce) that explains what backward error means, and under which circumstances you can expect an accurate result.

----------
assignee: docs at python
components: Documentation
messages: 334672
nosy: docs at python, jneb
priority: normal
severity: normal
status: open
title: math.sin has no backward error; this isn't documented
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/issue35880>
_______________________________________

From report at bugs.python.org  Fri Feb  1 07:41:11 2019
From: report at bugs.python.org (Mark Dickinson)
Date: Fri, 01 Feb 2019 12:41:11 +0000
Subject: [docs] [issue35880] math.sin has no backward error;
 this isn't documented
In-Reply-To: <1549021657.57.0.382503652198.issue35880@roundup.psfhosted.org>
Message-ID: <1549024867.87.0.654314965426.issue35880@roundup.psfhosted.org>


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

There's not a whole lot that we can usefully say about the accuracy of `math.sin`, since CPython just wraps C's sin function. So we just inherit the behaviour of the platform libm.

I don't think I understand what you mean by "backward error" in this context. What do you mean by: "as far as I can see, there is no backward error at all"? It may indeed be the case that math.sin is correctly rounded, or at least close to correctly rounded (e.g., errors consistently within 0.503 ulp or some such) on some platforms, but that's entirely platform dependent.

----------
nosy: +mark.dickinson

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

From report at bugs.python.org  Fri Feb  1 11:29:20 2019
From: report at bugs.python.org (Jeroen Demeyer)
Date: Fri, 01 Feb 2019 16:29:20 +0000
Subject: [docs] [issue25592] distutils docs: data_files always uses
 sys.prefix
In-Reply-To: <1447135572.7.0.138478279434.issue25592@psf.upfronthosting.co.za>
Message-ID: <1549038555.42.0.4480452097.issue25592@roundup.psfhosted.org>


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

> Could you still give it a quick check?

I did just that. For reference, these are the steps:
- Checkout the "2.7" branch of the cpython git repo
- ./configure --prefix=/tmp/prefix --exec-prefix=/tmp/eprefix && make && make install
- Install pip (https://pip.pypa.io/en/stable/installing/#installing-with-get-pip-py)
- /tmp/prefix/pip install --no-deps --verbose pari_jupyter  # This requires the PARI/GP library to be installed
- Note that all Jupyter stuff is installed in /tmp/prefix/share/jupyter while the directory /tmp/eprefix/share does not exist

----------

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

From report at bugs.python.org  Fri Feb  1 11:30:51 2019
From: report at bugs.python.org (Jeroen Demeyer)
Date: Fri, 01 Feb 2019 16:30:51 +0000
Subject: [docs] [issue25592] distutils docs: data_files always uses
 sys.prefix
In-Reply-To: <1447135572.7.0.138478279434.issue25592@psf.upfronthosting.co.za>
Message-ID: <1549038645.28.0.506223239879.issue25592@roundup.psfhosted.org>


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

(note typo in the above: /tmp/prefix/pip should be /tmp/prefix/bin/pip)

----------

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

From report at bugs.python.org  Fri Feb  1 12:20:20 2019
From: report at bugs.python.org (Steven D'Aprano)
Date: Fri, 01 Feb 2019 17:20:20 +0000
Subject: [docs] [issue35880] math.sin has no backward error;
 this isn't documented
In-Reply-To: <1549021657.57.0.382503652198.issue35880@roundup.psfhosted.org>
Message-ID: <1549041617.21.0.32978280942.issue35880@roundup.psfhosted.org>


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

> sin(1<<500) is correctly computed as 0.42925739234242827

py> math.sin(1<<500)
0.9996230490249484

Wolfram Alpha says it is 0.429257392342428277735329299112473759079115476327819897...

https://www.wolframalpha.com/input/?i=sin%282^500%29&assumption=%22TrigRD%22+-%3E+%22R%22


> Some text could be added (which I am happy to produce) that explains what backward error means

You could start by telling us here what you mean by backward error. Are you talking about this?

https://en.wikipedia.org/wiki/Numerical_stability#Stability_in_numerical_linear_algebra

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

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

From report at bugs.python.org  Fri Feb  1 12:35:45 2019
From: report at bugs.python.org (Tim Peters)
Date: Fri, 01 Feb 2019 17:35:45 +0000
Subject: [docs] [issue35880] math.sin has no backward error;
 this isn't documented
In-Reply-To: <1549021657.57.0.382503652198.issue35880@roundup.psfhosted.org>
Message-ID: <1549042542.94.0.331089618823.issue35880@roundup.psfhosted.org>


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

As Mark said, the behavior of Python's floating-point math functions (not just trig, but also log, pow, exp, ...) is inherited almost entirely from the platform C's math libraries.  Python itself guarantees nothing about what `math.sin(x)` returns for any `x` - and it can, & does, vary across platforms.

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

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

From report at bugs.python.org  Fri Feb  1 18:34:03 2019
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 01 Feb 2019 23:34:03 +0000
Subject: [docs] [issue35880] math.sin has no backward error;
 this isn't documented
In-Reply-To: <1549021657.57.0.382503652198.issue35880@roundup.psfhosted.org>
Message-ID: <1549064042.68.0.328358333613.issue35880@roundup.psfhosted.org>


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


----------
stage:  -> needs patch
versions:  -Python 3.4, Python 3.5, Python 3.6

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

From report at bugs.python.org  Fri Feb  1 18:37:21 2019
From: report at bugs.python.org (kernc)
Date: Fri, 01 Feb 2019 23:37:21 +0000
Subject: [docs] [issue17972] inspect module docs omits many functions
In-Reply-To: <1368501068.91.0.677640111487.issue17972@psf.upfronthosting.co.za>
Message-ID: <1549064238.38.0.333541923064.issue17972@roundup.psfhosted.org>


Change by kernc <kerncece at gmail.com>:


----------
nosy: +kernc

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

From report at bugs.python.org  Sat Feb  2 05:01:10 2019
From: report at bugs.python.org (miss-islington)
Date: Sat, 02 Feb 2019 10:01:10 +0000
Subject: [docs] [issue25592] distutils docs: data_files always uses
 sys.prefix
In-Reply-To: <1447135572.7.0.138478279434.issue25592@psf.upfronthosting.co.za>
Message-ID: <1549101667.49.0.888105406035.issue25592@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Sat Feb  2 05:01:22 2019
From: report at bugs.python.org (miss-islington)
Date: Sat, 02 Feb 2019 10:01:22 +0000
Subject: [docs] [issue25592] distutils docs: data_files always uses
 sys.prefix
In-Reply-To: <1447135572.7.0.138478279434.issue25592@psf.upfronthosting.co.za>
Message-ID: <1549101679.03.0.137833503061.issue25592@roundup.psfhosted.org>


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


----------
pull_requests: +11633, 11634
stage: resolved -> patch review

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

From report at bugs.python.org  Sat Feb  2 05:01:34 2019
From: report at bugs.python.org (miss-islington)
Date: Sat, 02 Feb 2019 10:01:34 +0000
Subject: [docs] [issue25592] distutils docs: data_files always uses
 sys.prefix
In-Reply-To: <1447135572.7.0.138478279434.issue25592@psf.upfronthosting.co.za>
Message-ID: <1549101691.24.0.471852789868.issue25592@roundup.psfhosted.org>


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


----------
pull_requests: +11633, 11634, 11635
stage: resolved -> patch review

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

From vavrek at vavrek.com  Fri Feb  1 11:27:54 2019
From: vavrek at vavrek.com (vavrek)
Date: Fri, 1 Feb 2019 18:27:54 +0200
Subject: [docs] Tiny Typo in "Strings" Documentation
Message-ID: <4d01c6aa-24e1-a836-d7bd-72b3fc0ee9bb@vavrek.com>

Warm wishes Python friends!

Found a small documentation bug:

https://docs.python.org/3/tutorial/introduction.html#strings

"In addition to indexing, slicing is also supported. While indexing is 
used to obtain individual characters, slicing allows you to obtain <a> 
substring:"

This sentence is merely missing an "a" as indicated.

Cheers!

Andrew Vavrek
https://vavrek.com

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190201/2575c3d8/attachment.html>

From report at bugs.python.org  Sat Feb  2 05:16:18 2019
From: report at bugs.python.org (Antoine Pitrou)
Date: Sat, 02 Feb 2019 10:16:18 +0000
Subject: [docs] [issue25592] distutils docs: data_files always uses
 sys.prefix
In-Reply-To: <1447135572.7.0.138478279434.issue25592@psf.upfronthosting.co.za>
Message-ID: <1549102574.39.0.577591484271.issue25592@roundup.psfhosted.org>


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


New changeset 40a101df8c64a1e55cca2780248d7a92bdcccd57 by Antoine Pitrou (Miss Islington (bot)) in branch '2.7':
bpo-25592: Improve documentation of distutils data_files (GH-9767) (GH-11734)
https://github.com/python/cpython/commit/40a101df8c64a1e55cca2780248d7a92bdcccd57


----------

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

From report at bugs.python.org  Sat Feb  2 05:16:35 2019
From: report at bugs.python.org (Antoine Pitrou)
Date: Sat, 02 Feb 2019 10:16:35 +0000
Subject: [docs] [issue25592] distutils docs: data_files always uses
 sys.prefix
In-Reply-To: <1447135572.7.0.138478279434.issue25592@psf.upfronthosting.co.za>
Message-ID: <1549102591.16.0.422012980132.issue25592@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Sat Feb  2 05:17:17 2019
From: report at bugs.python.org (Antoine Pitrou)
Date: Sat, 02 Feb 2019 10:17:17 +0000
Subject: [docs] [issue25592] distutils docs: data_files always uses
 sys.prefix
In-Reply-To: <1447135572.7.0.138478279434.issue25592@psf.upfronthosting.co.za>
Message-ID: <1549102632.83.0.211483575689.issue25592@roundup.psfhosted.org>


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

Ok, this is now pushed to 2.7 as well. Thank you Jeroen!

----------

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

From report at bugs.python.org  Sat Feb  2 09:37:47 2019
From: report at bugs.python.org (Stefan Krah)
Date: Sat, 02 Feb 2019 14:37:47 +0000
Subject: [docs] [issue26256] Fast decimalisation and conversion to other
 bases
In-Reply-To: <1454322513.41.0.794136944555.issue26256@psf.upfronthosting.co.za>
Message-ID: <1549118263.22.0.890356610827.issue26256@roundup.psfhosted.org>


Stefan Krah <stefan at bytereef.org> added the comment:


New changeset 00e9c55d27aff3e445ab4c8629cf4d59f46ff945 by Stefan Krah (Cheryl Sabella) in branch 'master':
bpo-26256: Document algorithm speed for the Decimal module. (#4808)
https://github.com/python/cpython/commit/00e9c55d27aff3e445ab4c8629cf4d59f46ff945


----------

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

From report at bugs.python.org  Sat Feb  2 09:40:26 2019
From: report at bugs.python.org (miss-islington)
Date: Sat, 02 Feb 2019 14:40:26 +0000
Subject: [docs] [issue26256] Fast decimalisation and conversion to other
 bases
In-Reply-To: <1454322513.41.0.794136944555.issue26256@psf.upfronthosting.co.za>
Message-ID: <1549118424.04.0.205385483416.issue26256@roundup.psfhosted.org>


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


----------
pull_requests: +11639

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

From report at bugs.python.org  Sat Feb  2 09:40:38 2019
From: report at bugs.python.org (miss-islington)
Date: Sat, 02 Feb 2019 14:40:38 +0000
Subject: [docs] [issue26256] Fast decimalisation and conversion to other
 bases
In-Reply-To: <1454322513.41.0.794136944555.issue26256@psf.upfronthosting.co.za>
Message-ID: <1549118435.13.0.13210155002.issue26256@roundup.psfhosted.org>


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


----------
pull_requests: +11639, 11640

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

From report at bugs.python.org  Sat Feb  2 09:40:50 2019
From: report at bugs.python.org (miss-islington)
Date: Sat, 02 Feb 2019 14:40:50 +0000
Subject: [docs] [issue26256] Fast decimalisation and conversion to other
 bases
In-Reply-To: <1454322513.41.0.794136944555.issue26256@psf.upfronthosting.co.za>
Message-ID: <1549118446.9.0.834302964462.issue26256@roundup.psfhosted.org>


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


----------
pull_requests: +11639, 11640, 11641

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

From report at bugs.python.org  Sat Feb  2 09:46:15 2019
From: report at bugs.python.org (Stefan Krah)
Date: Sat, 02 Feb 2019 14:46:15 +0000
Subject: [docs] [issue26256] Fast decimalisation and conversion to other
 bases
In-Reply-To: <1454322513.41.0.794136944555.issue26256@psf.upfronthosting.co.za>
Message-ID: <1549118771.3.0.577770188694.issue26256@roundup.psfhosted.org>


Stefan Krah <stefan at bytereef.org> added the comment:


New changeset a2f4c4023314f69333d2e8cee68e316619f3d68e by Stefan Krah (Miss Islington (bot)) in branch '3.7':
bpo-26256: Document algorithm speed for the Decimal module. (GH-4808) (#11736)
https://github.com/python/cpython/commit/a2f4c4023314f69333d2e8cee68e316619f3d68e


----------

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

From report at bugs.python.org  Sat Feb  2 09:50:01 2019
From: report at bugs.python.org (Stefan Krah)
Date: Sat, 02 Feb 2019 14:50:01 +0000
Subject: [docs] [issue26256] Fast decimalisation and conversion to other
 bases
In-Reply-To: <1454322513.41.0.794136944555.issue26256@psf.upfronthosting.co.za>
Message-ID: <1549118998.05.0.14937600788.issue26256@roundup.psfhosted.org>


Change by Stefan Krah <stefan at bytereef.org>:


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

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

From report at bugs.python.org  Sun Feb  3 08:59:59 2019
From: report at bugs.python.org (Julien Palard)
Date: Sun, 03 Feb 2019 13:59:59 +0000
Subject: [docs] [issue35851] Make search result in online docs keep their
 position when search finishes
In-Reply-To: <1548772807.63.0.497905321537.issue35851@roundup.psfhosted.org>
Message-ID: <1549202397.3.0.764481995049.issue35851@roundup.psfhosted.org>


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

Hi Roel,

I like the idea, but as xtreak told, it's a sphinx issue we cannot easy fix on our side, better fix it sphinx side. Would you please repoen it on the sphinx bug tracker at https://github.com/sphinx-doc/sphinx/issues?

----------

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

From report at bugs.python.org  Sun Feb  3 10:33:36 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 03 Feb 2019 15:33:36 +0000
Subject: [docs] [issue12374] Execution model should explain compile vs
 definition vs execution time
In-Reply-To: <1308582911.55.0.701954968644.issue12374@psf.upfronthosting.co.za>
Message-ID: <1549208014.6.0.219535646164.issue12374@roundup.psfhosted.org>


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

Hi Nick,

Would you be able to update the link as http://svn.python.org/view/sandbox/trunk/userref/ODF/ isn't valid anymore?  Have things changed even more since you created this issue or are you still interested in pursuing this?  Thanks!

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

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

From report at bugs.python.org  Sun Feb  3 15:19:21 2019
From: report at bugs.python.org (paul j3)
Date: Sun, 03 Feb 2019 20:19:21 +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: <1549225159.48.0.432690966564.issue35533@roundup.psfhosted.org>


Change by paul j3 <ajipanca at gmail.com>:


----------
nosy: +paul.j3

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

From report at bugs.python.org  Sun Feb  3 18:22:59 2019
From: report at bugs.python.org (Ned Deily)
Date: Sun, 03 Feb 2019 23:22: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: <1549236176.57.0.535708865804.issue35605@roundup.psfhosted.org>


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


New changeset 9bacdce451618a5f0bf62cb1b6f966ebde0492c6 by Ned Deily (Anthony Sottile) in branch '3.6':
[3.6] bpo-35605: Fix documentation build for sphinx<1.6 (GH-11368)
https://github.com/python/cpython/commit/9bacdce451618a5f0bf62cb1b6f966ebde0492c6


----------

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

From report at bugs.python.org  Sun Feb  3 18:26:54 2019
From: report at bugs.python.org (Ned Deily)
Date: Sun, 03 Feb 2019 23:26:54 +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: <1549236411.68.0.270934144897.issue35605@roundup.psfhosted.org>


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

I agree that this can go into 3.6. Thanks, everyone!

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

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

From report at bugs.python.org  Mon Feb  4 05:23:14 2019
From: report at bugs.python.org (Roel Schroeven)
Date: Mon, 04 Feb 2019 10:23:14 +0000
Subject: [docs] [issue35851] Make search result in online docs keep their
 position when search finishes
In-Reply-To: <1548772807.63.0.497905321537.issue35851@roundup.psfhosted.org>
Message-ID: <1549275793.9.0.651940886806.issue35851@roundup.psfhosted.org>


Roel Schroeven <roel at roelschroeven.net> added the comment:

Issue opened on the Sphinx bug tracker: https://github.com/sphinx-doc/sphinx/issues/6016

----------

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

From report at bugs.python.org  Mon Feb  4 07:13:57 2019
From: report at bugs.python.org (Nick Coghlan)
Date: Mon, 04 Feb 2019 12:13:57 +0000
Subject: [docs] [issue12374] Execution model should explain compile vs
 definition vs execution time
In-Reply-To: <1308582911.55.0.701954968644.issue12374@psf.upfronthosting.co.za>
Message-ID: <1549282433.31.0.452195836181.issue12374@roundup.psfhosted.org>


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

https://github.com/ncoghlan/python-userref/blob/master/ODF/Chapter01_EssentialConcepts.odt is the Chapter 1 userref link now that the PSF SVN server has shut down.

Depending on what you mean by "Pursuing this...":

1. I'd definitely still love to see the content from the user reference converted into a collaborative documentation project and brought up to speed with modern Python - it's just a large enough task that I've shied away from doing it myself.

2. For this ticket itself, I'm thinking this kind of explanatory material might find a better home in the Developer's Guide these days, as there it could also provide pointers to the different parts of CPython that implement each phase.

----------

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

From report at bugs.python.org  Mon Feb  4 14:12:28 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 04 Feb 2019 19:12:28 +0000
Subject: [docs] [issue15248] Better explain "TypeError: 'tuple' object is
 not callable"
In-Reply-To: <1341379722.78.0.0866285571225.issue15248@psf.upfronthosting.co.za>
Message-ID: <1549307544.53.0.386940095962.issue15248@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Mon Feb  4 14:12:45 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 04 Feb 2019 19:12:45 +0000
Subject: [docs] [issue15248] Better explain "TypeError: 'tuple' object is
 not callable"
In-Reply-To: <1341379722.78.0.0866285571225.issue15248@psf.upfronthosting.co.za>
Message-ID: <1549307562.31.0.760279926126.issue15248@roundup.psfhosted.org>


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


----------
pull_requests: +11702, 11703
stage: needs patch -> patch review

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

From report at bugs.python.org  Tue Feb  5 05:16:21 2019
From: report at bugs.python.org (INADA Naoki)
Date: Tue, 05 Feb 2019 10:16:21 +0000
Subject: [docs] [issue20001] pathlib inheritance diagram too large
In-Reply-To: <1387221538.52.0.488414928183.issue20001@psf.upfronthosting.co.za>
Message-ID: <1549361778.53.0.0997432962862.issue20001@roundup.psfhosted.org>


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


New changeset cd90f6a3692e0f7ef0a13aae651e19a08d1f9b31 by Inada Naoki (Harmandeep Singh) in branch 'master':
bpo-20001: update pathlib landing image (GH-11304)
https://github.com/python/cpython/commit/cd90f6a3692e0f7ef0a13aae651e19a08d1f9b31


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

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

From report at bugs.python.org  Tue Feb  5 05:17:06 2019
From: report at bugs.python.org (INADA Naoki)
Date: Tue, 05 Feb 2019 10:17:06 +0000
Subject: [docs] [issue20001] pathlib inheritance diagram too large
In-Reply-To: <1387221538.52.0.488414928183.issue20001@psf.upfronthosting.co.za>
Message-ID: <1549361824.9.0.320820111232.issue20001@roundup.psfhosted.org>


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


----------
nosy:  -inada.naoki
versions: +Python 3.7, Python 3.8 -Python 3.5, Python 3.6

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

From report at bugs.python.org  Tue Feb  5 05:30:25 2019
From: report at bugs.python.org (INADA Naoki)
Date: Tue, 05 Feb 2019 10:30:25 +0000
Subject: [docs] [issue20001] pathlib inheritance diagram too large
In-Reply-To: <1387221538.52.0.488414928183.issue20001@psf.upfronthosting.co.za>
Message-ID: <1549362623.47.0.073724010998.issue20001@roundup.psfhosted.org>


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


----------
pull_requests: +11710

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

From report at bugs.python.org  Tue Feb  5 05:30:38 2019
From: report at bugs.python.org (INADA Naoki)
Date: Tue, 05 Feb 2019 10:30:38 +0000
Subject: [docs] [issue20001] pathlib inheritance diagram too large
In-Reply-To: <1387221538.52.0.488414928183.issue20001@psf.upfronthosting.co.za>
Message-ID: <1549362636.99.0.517670318086.issue20001@roundup.psfhosted.org>


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


----------
pull_requests: +11710, 11711

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

From report at bugs.python.org  Tue Feb  5 05:30:52 2019
From: report at bugs.python.org (INADA Naoki)
Date: Tue, 05 Feb 2019 10:30:52 +0000
Subject: [docs] [issue20001] pathlib inheritance diagram too large
In-Reply-To: <1387221538.52.0.488414928183.issue20001@psf.upfronthosting.co.za>
Message-ID: <1549362650.43.0.253481285793.issue20001@roundup.psfhosted.org>


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


----------
pull_requests: +11710, 11711, 11712

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

From report at bugs.python.org  Tue Feb  5 05:39:50 2019
From: report at bugs.python.org (INADA Naoki)
Date: Tue, 05 Feb 2019 10:39:50 +0000
Subject: [docs] [issue20001] pathlib inheritance diagram too large
In-Reply-To: <1387221538.52.0.488414928183.issue20001@psf.upfronthosting.co.za>
Message-ID: <1549363186.74.0.704609267425.issue20001@roundup.psfhosted.org>


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


New changeset 21ab7744ae30bff24bcc9e075a96e98137b90a37 by Inada Naoki in branch '3.7':
bpo-20001: update pathlib landing image (GH-11304)
https://github.com/python/cpython/commit/21ab7744ae30bff24bcc9e075a96e98137b90a37


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

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

From report at bugs.python.org  Tue Feb  5 06:55:43 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Tue, 05 Feb 2019 11:55:43 +0000
Subject: [docs] [issue35358] Document that importlib.import_module accepts
 names that are not valid Python syntax
In-Reply-To: <1543566651.92.0.788709270274.issue35358@psf.upfronthosting.co.za>
Message-ID: <1549367739.4.0.853489865234.issue35358@roundup.psfhosted.org>


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

I close this issue, thank you for your feedback.

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

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

From report at bugs.python.org  Tue Feb  5 18:08:45 2019
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Tue, 05 Feb 2019 23:08:45 +0000
Subject: [docs] [issue35851] Make search result in online docs keep their
 position when search finishes
In-Reply-To: <1548772807.63.0.497905321537.issue35851@roundup.psfhosted.org>
Message-ID: <1549408124.65.0.408777250755.issue35851@roundup.psfhosted.org>


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

This is fixed upstream and will be available as Sphinx is upgraded. Closing it now. Thanks @roelschroeven for the report.

Upstream PR : https://github.com/sphinx-doc/sphinx/pull/6018

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

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

From report at bugs.python.org  Tue Feb  5 19:12:24 2019
From: report at bugs.python.org (Jason R. Coombs)
Date: Wed, 06 Feb 2019 00:12:24 +0000
Subject: [docs] [issue35905] macOS build docs need refresh (2019)
Message-ID: <1549411942.7.0.0722764247373.issue35905@roundup.psfhosted.org>


New submission from Jason R. Coombs <jaraco at jaraco.com>:

In https://github.com/python/devguide/issues/453#issuecomment-460848565, I understand that Ned wishes to update the macOS build docs prior to linking to them from the dev guide.

----------
assignee: docs at python
components: Documentation
messages: 334895
nosy: docs at python, jason.coombs, ned.deily
priority: normal
severity: normal
status: open
title: macOS build docs need refresh (2019)
versions: Python 3.8

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

From report at bugs.python.org  Tue Feb  5 19:13:47 2019
From: report at bugs.python.org (Ned Deily)
Date: Wed, 06 Feb 2019 00:13:47 +0000
Subject: [docs] [issue35905] macOS build docs need refresh (2019)
In-Reply-To: <1549411942.7.0.0722764247373.issue35905@roundup.psfhosted.org>
Message-ID: <1549412027.85.0.108930819085.issue35905@roundup.psfhosted.org>


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


----------
assignee: docs at python -> ned.deily

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

From report at bugs.python.org  Tue Feb  5 20:50:10 2019
From: report at bugs.python.org (Barry A. Warsaw)
Date: Wed, 06 Feb 2019 01:50:10 +0000
Subject: [docs] [issue35905] macOS build docs need refresh (2019)
In-Reply-To: <1549411942.7.0.0722764247373.issue35905@roundup.psfhosted.org>
Message-ID: <1549417808.66.0.901367986727.issue35905@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Tue Feb  5 20:51:34 2019
From: report at bugs.python.org (Barry A. Warsaw)
Date: Wed, 06 Feb 2019 01:51:34 +0000
Subject: [docs] [issue35905] macOS build docs need refresh (2019)
In-Reply-To: <1549411942.7.0.0722764247373.issue35905@roundup.psfhosted.org>
Message-ID: <1549417891.99.0.975607243764.issue35905@roundup.psfhosted.org>


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

All I know is that for 3.7 and 3.8 (3.6 is different), I have this little helper script to build against Homebrew libraries.

#!/bin/sh

export CPPFLAGS="-I$(brew --prefix sqlite3)/include -I$(brew --prefix zlib)/include"
export LDFLAGS="-L$(brew --prefix sqlite3)/lib -L$(brew --prefix zlib)/lib"
export PKG_CONFIG_PATH="/usr/local/opt/openssl/lib/pkgconfig"

./configure

----------

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

From harketti at afia.fr  Sat Feb  2 00:30:56 2019
From: harketti at afia.fr (Harketti BENDAOUD)
Date: Sat, 2 Feb 2019 05:30:56 +0000
Subject: [docs] =?iso-8859-1?q?Liens_cass=E9s_!!!?=
Message-ID: <AM0PR08MB39375F77E0D1CC770471945CD3930@AM0PR08MB3937.eurprd08.prod.outlook.com>


Format

Packed as .zip

Packed as .tar.bz2

PDF (US-Letter paper size)

Download<https://docs.python.org/fr/3/archives/python-3.7.2-docs-pdf-letter.zip> (ca. 13 MiB)

Download<https://docs.python.org/fr/3/archives/python-3.7.2-docs-pdf-letter.tar.bz2> (ca. 13 MiB)

PDF (A4 paper size)

Download<https://docs.python.org/fr/3/archives/python-3.7.2-docs-pdf-a4.zip> (ca. 13 MiB)

Download<https://docs.python.org/fr/3/archives/python-3.7.2-docs-pdf-a4.tar.bz2> (ca. 13 MiB)



Provenance : Courrier<https://go.microsoft.com/fwlink/?LinkId=550986> pour Windows 10

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

From kai.grossjohann at gmail.com  Sun Feb  3 12:18:56 2019
From: kai.grossjohann at gmail.com (Kai =?utf-8?q?Gro=C3=9Fjohann?=)
Date: Sun, 03 Feb 2019 18:18:56 +0100
Subject: [docs] logging.basicConfig: wrong table headings
Message-ID: <D0FA2C83-35D8-468D-8F29-9B211C3F5B74@gmail.com>

https://docs.python.org/2.7/library/logging.html?highlight=logging.basicconfig#logging.basicConfig

The description of logging.basicConfig has a table, and the table 
heading is wrong for the first column.  It says "format", but it should 
say "argument" or something like this.

The same issue exists in the 3.7 documentation:
https://docs.python.org/3.7/library/logging.html?highlight=logging.basicconfig#logging.basicConfig

Thanks,
Kai

From me at lunorian.is  Sun Feb  3 17:55:51 2019
From: me at lunorian.is (Nathaniel Suchy)
Date: Sun, 3 Feb 2019 23:55:51 +0100 (CET)
Subject: [docs] UX Issue in Docs (Google Chrome 72 on macOS 10.14.3)
Message-ID: <LXpZncJ--3-1@lunorian.is>

Hi,

I noticed a minor issue in the Python Docs website. I'm using Google Chrome 72 on macOS 10.14.3 and the scrollbar of the docs website appears white/clear and is difficult to see. This may present an accessibility challenge for visually impaired and colorblind people. I attached a screenshot of the issue occurring.

Example Page where issue occurs:?https://docs.python.org/2.7/tutorial/modules.html <https://docs.python.org/2.7/tutorial/modules.html>

Would appreciate someone looking into this, thanks for all you do :)
Cordially,
Nathaniel Suchy
-------------- next part --------------
A non-text attachment was scrubbed...
Name: Screen Shot 2019-02-03 at 5.54.50 PM.png
Type: image/png
Size: 1198065 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20190203/eb1b8b07/attachment-0001.png>

From lyle_z at hotmail.com  Mon Feb  4 04:32:14 2019
From: lyle_z at hotmail.com (lyle_z hotmail.com)
Date: Mon, 4 Feb 2019 09:32:14 +0000
Subject: [docs] Documentation error/ambiguity
Message-ID: <BYAPR02MB52374B5544ACD6CF9301ECB4F66D0@BYAPR02MB5237.namprd02.prod.outlook.com>

Hi

In https://docs.python.org/3/tutorial/stdlib2.html it states, "By default, informational and debugging messages are suppressed and the output is sent to standard error."

That's a contradiction. If the output is sent to standard error, then it's not suppressed, it's redirected.


Lyle

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190204/53df794f/attachment.html>

From report at bugs.python.org  Wed Feb  6 09:42:47 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Wed, 06 Feb 2019 14:42:47 +0000
Subject: [docs] [issue34398] Docs search does not index glossary items
In-Reply-To: <1534233148.48.0.56676864532.issue34398@psf.upfronthosting.co.za>
Message-ID: <1549464163.19.0.345388600582.issue34398@roundup.psfhosted.org>


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

@ammar2, this looks like a great addition to the docs.  Would you be able to address Berker's request and also fix the merge conflict on the PR?

Also adding Julien and Carol from the expert's index for documentation.

----------
nosy: +cheryl.sabella, mdk, willingc
versions:  -Python 3.6

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

From report at bugs.python.org  Wed Feb  6 10:50:30 2019
From: report at bugs.python.org (Jason R. Coombs)
Date: Wed, 06 Feb 2019 15:50:30 +0000
Subject: [docs] [issue35905] macOS build docs need refresh (2019)
In-Reply-To: <1549411942.7.0.0722764247373.issue35905@roundup.psfhosted.org>
Message-ID: <1549468228.1.0.781467651168.issue35905@roundup.psfhosted.org>


Jason R. Coombs <jaraco at jaraco.com> added the comment:

I also have a script that does something very similar (https://github.com/jaraco/jaraco.develop/blob/master/jaraco/develop/macos-build-python.py), invoked with `python -m jaraco.develop.macos-build-python` (or `pip-run -m jaraco.develop -- -m jaraco.develop.macos-build-python` if you don't have it installed).

----------

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

From report at bugs.python.org  Wed Feb  6 13:25:07 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Wed, 06 Feb 2019 18:25:07 +0000
Subject: [docs] [issue27344] zipfile *does* support utf-8 filenames
In-Reply-To: <1466176126.21.0.0133629365393.issue27344@psf.upfronthosting.co.za>
Message-ID: <1549477503.15.0.758323786131.issue27344@roundup.psfhosted.org>


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

This wording was removed as part of issue 32035.

----------
nosy: +cheryl.sabella
resolution:  -> duplicate
stage: needs patch -> resolved
status: open -> closed
superseder:  -> Documentation of zipfile.ZipFile().writestr() fails to mention that 'data' may also be bytes

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

From ajna at ajna.me  Wed Feb  6 14:31:13 2019
From: ajna at ajna.me (Ajna Cackovic)
Date: Wed, 6 Feb 2019 11:31:13 -0800
Subject: [docs] core-mentorship mailing list link broken
Message-ID: <05B7927B-12D2-4891-BB28-89DEC433BABB@ajna.me>

The link to the core-mentorship mailing list listed in the docs:
https://docs.python.org/3/bugs.html <https://docs.python.org/3/bugs.html> 

points to:
https://mail.python.org/mailman/listinfo/core-mentorship/ <https://mail.python.org/mailman/listinfo/core-mentorship/> 

That page is a 301 and redirects to:
https://mail.python.org/mailman3/lists/core-mentorship.python.org// <https://mail.python.org/mailman3/lists/core-mentorship.python.org//>

Which is a 404. The actual page should be:
https://mail.python.org/mailman3/lists/core-mentorship.python.org/ <https://mail.python.org/mailman3/lists/core-mentorship.python.org/>

Without the double slash at the end.

This isn?t really a bug in a docs, but this seemed like the best place to report it. I hope that this helps.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190206/897dbaac/attachment.html>

From mariatta at python.org  Wed Feb  6 15:42:03 2019
From: mariatta at python.org (Mariatta Wijaya)
Date: Wed, 6 Feb 2019 12:42:03 -0800
Subject: [docs] core-mentorship mailing list link broken
In-Reply-To: <05B7927B-12D2-4891-BB28-89DEC433BABB@ajna.me>
References: <05B7927B-12D2-4891-BB28-89DEC433BABB@ajna.me>
Message-ID: <CAGbohnYWi9gBtEHeo1oqQkBWX3oFDg4wC_9ZCNZFMOOSpE2eyQ@mail.gmail.com>

Thanks for the report! I've made the PR (
https://github.com/python/cpython/pull/11775). This will get fixed shortly.

?

On Wed, Feb 6, 2019 at 12:04 PM Ajna Cackovic <ajna at ajna.me> wrote:

> The link to the core-mentorship mailing list listed in the docs:
> https://docs.python.org/3/bugs.html
>
> points to:
> https://mail.python.org/mailman/listinfo/core-mentorship/
>
> That page is a 301 and redirects to:
> https://mail.python.org/mailman3/lists/core-mentorship.python.org//
>
> Which is a 404. The actual page should be:
> https://mail.python.org/mailman3/lists/core-mentorship.python.org/
>
> Without the double slash at the end.
>
> This isn?t really a bug in a docs, but this seemed like the best place to
> report it. I hope that this helps.
> _______________________________________________
> 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/20190206/6d4527b1/attachment.html>

From report at bugs.python.org  Wed Feb  6 16:12:44 2019
From: report at bugs.python.org (Felipe Manzano)
Date: Wed, 06 Feb 2019 21:12:44 +0000
Subject: [docs] [issue19953] __iadd__() doc not strictly correct
In-Reply-To: <1386792788.94.0.272007303341.issue19953@psf.upfronthosting.co.za>
Message-ID: <1549487562.19.0.126106107653.issue19953@roundup.psfhosted.org>


Change by Felipe Manzano <felipe.andres.manzano at gmail.com>:


----------
pull_requests: +11750

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

From report at bugs.python.org  Wed Feb  6 16:12:52 2019
From: report at bugs.python.org (Felipe Manzano)
Date: Wed, 06 Feb 2019 21:12:52 +0000
Subject: [docs] [issue19953] __iadd__() doc not strictly correct
In-Reply-To: <1386792788.94.0.272007303341.issue19953@psf.upfronthosting.co.za>
Message-ID: <1549487570.85.0.947014937758.issue19953@roundup.psfhosted.org>


Change by Felipe Manzano <felipe.andres.manzano at gmail.com>:


----------
pull_requests: +11750, 11751

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

From report at bugs.python.org  Wed Feb  6 16:13:01 2019
From: report at bugs.python.org (Felipe Manzano)
Date: Wed, 06 Feb 2019 21:13:01 +0000
Subject: [docs] [issue19953] __iadd__() doc not strictly correct
In-Reply-To: <1386792788.94.0.272007303341.issue19953@psf.upfronthosting.co.za>
Message-ID: <1549487579.55.0.629874186133.issue19953@roundup.psfhosted.org>


Change by Felipe Manzano <felipe.andres.manzano at gmail.com>:


----------
pull_requests: +11750, 11751, 11752

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

From report at bugs.python.org  Wed Feb  6 19:39:27 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 07 Feb 2019 00:39:27 +0000
Subject: [docs] [issue22474] No explanation of how a task gets destroyed in
 asyncio 'task' documentation
In-Reply-To: <1411516943.46.0.304192335953.issue22474@psf.upfronthosting.co.za>
Message-ID: <1549499964.17.0.128879278741.issue22474@roundup.psfhosted.org>


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

It seems that the note about a warning being logged if a pending task is destroyed does not exist in the new, rewritten version of the asyncio docs.  Therefore, I'm going to close this as out of date.

----------
nosy: +cheryl.sabella
resolution:  -> out of date
stage:  -> resolved
status: open -> closed

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

From report at bugs.python.org  Wed Feb  6 23:38:35 2019
From: report at bugs.python.org (ADataGman)
Date: Thu, 07 Feb 2019 04:38:35 +0000
Subject: [docs] [issue35927] Intra-package References Documentation
 Incomplete
Message-ID: <1549514310.42.0.442993756904.issue35927@roundup.psfhosted.org>


New submission from ADataGman <aarongrossman at gmail.com>:

Attempting to follow https://docs.python.org/3.6/tutorial/modules.html#intra-package-references I was unable to recreate the intra-package reference as described. 

"For example, if the module sound.filters.vocoder needs to use the echo module in the sound.effects package, it can use from sound.effects import echo."

Creating the file structure described in https://docs.python.org/3.6/tutorial/modules.html#packages, with empty __init__.py files at all levels, or with __all__ defined as containing relevant file names, results in "No module named 'sound'". If I try to run this using "from ..effects import echo" then it results in "attempted relative import beyond top-level package".

At least one other user has run into this issue with this stack overflow post: https://stackoverflow.com/questions/53109627/python-intra-package-reference-doesnt-work-at-all

----------
assignee: docs at python
components: Documentation
files: sound.zip
messages: 335002
nosy: ADataGman, docs at python
priority: normal
severity: normal
status: open
title: Intra-package References Documentation Incomplete
type: behavior
versions: Python 3.6
Added file: https://bugs.python.org/file48109/sound.zip

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

From lyle_z at hotmail.com  Thu Feb  7 02:18:43 2019
From: lyle_z at hotmail.com (lyle_z hotmail.com)
Date: Thu, 7 Feb 2019 07:18:43 +0000
Subject: [docs] https://docs.python.org/3/tutorial/venv.html
Message-ID: <MN2PR02MB59675478B5EFB14CCC219E86F6680@MN2PR02MB5967.namprd02.prod.outlook.com>

Might want to mention that the way to exit a python virtual environment is with the "deactivate" command.

https://docs.python.org/3/tutorial/venv.html

Lyle

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190207/942b390e/attachment.html>

From report at bugs.python.org  Thu Feb  7 08:57:11 2019
From: report at bugs.python.org (Rohit travels and tours)
Date: Thu, 07 Feb 2019 13:57:11 +0000
Subject: [docs] [issue35929] rtat.net
Message-ID: <1549547830.43.0.503516150281.issue35929@roundup.psfhosted.org>


Change by Rohit travels and tours <roufique at rtat.net>:


----------
assignee: docs at python
components: 2to3 (2.x to 3.x conversion tool), Build, Demos and Tools, Distutils, Documentation, Extension Modules, FreeBSD, Library (Lib), SSL, email, macOS
nosy: barry, docs at python, dstufft, eric.araujo, koobs, ned.deily, r.david.murray, ronaldoussoren, roufique7
priority: normal
severity: normal
status: open
title: rtat.net
type: resource usage
versions: Python 3.6, Python 3.7, Python 3.8

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

From report at bugs.python.org  Thu Feb  7 10:45:33 2019
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 07 Feb 2019 15:45:33 +0000
Subject: [docs] [issue35929] rtat.net
Message-ID: <1549554329.22.0.782118981945.issue35929@roundup.psfhosted.org>


New submission from Mariatta Wijaya <mariatta at python.org>:

Please provide more info about the bug you're reporting.

As it is, this looks like spam, so I'm closing it.

----------
assignee: docs at python -> 
nosy: +Mariatta
resolution:  -> not a bug
stage:  -> resolved
status: open -> closed
type: resource usage -> 

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

From report at bugs.python.org  Thu Feb  7 12:55:25 2019
From: report at bugs.python.org (Pierre Glaser)
Date: Thu, 07 Feb 2019 17:55:25 +0000
Subject: [docs] [issue35933] python doc does not say that the state kwarg in
 Pickler.save_reduce can be a tuple (and not only a dict)
Message-ID: <1549562122.06.0.315178283617.issue35933@roundup.psfhosted.org>


New submission from Pierre Glaser <pierreglaser at msn.com>:

Hello all,
This 16-year old commit (*) allows an object's state to be updated
using its slots instead of its __dict__ at unpickling time. To use this
functionality, the state keyword-argument of Pickler.save_reduce (which maps to
the third item of the tuple returned by __reduce__) should be a length-2 tuple.
As far as I can tell, this is not mentioned in the documentation (**). I suggest having the docs updated. What do you think?

(*) https://github.com/python/cpython/commit/ac5b5d2e8b849c499d323b0263ace22e56b4f0d9
(**) https://docs.python.org/3.8/library/pickle.html#object.__reduce__

----------
assignee: docs at python
components: Documentation
messages: 335031
nosy: alexandre.vassalotti, docs at python, pierreglaser, pitrou, serhiy.storchaka
priority: normal
severity: normal
status: open
title: python doc does not say that the state kwarg in Pickler.save_reduce can be a tuple (and not only a dict)
versions: Python 3.8

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

From report at bugs.python.org  Thu Feb  7 13:18:59 2019
From: report at bugs.python.org (Antoine Pitrou)
Date: Thu, 07 Feb 2019 18:18:59 +0000
Subject: [docs] [issue35933] python doc does not say that the state kwarg in
 Pickler.save_reduce can be a tuple (and not only a dict)
In-Reply-To: <1549562122.06.0.315178283617.issue35933@roundup.psfhosted.org>
Message-ID: <1549563535.6.0.33345276465.issue35933@roundup.psfhosted.org>


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

Does it still work?  With both the C and Python pickler?
Can you post an example?

----------

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

From report at bugs.python.org  Thu Feb  7 15:59:08 2019
From: report at bugs.python.org (Pierre Glaser)
Date: Thu, 07 Feb 2019 20:59:08 +0000
Subject: [docs] [issue35933] python doc does not say that the state kwarg in
 Pickler.save_reduce can be a tuple (and not only a dict)
In-Reply-To: <1549562122.06.0.315178283617.issue35933@roundup.psfhosted.org>
Message-ID: <1549573144.13.0.200174121083.issue35933@roundup.psfhosted.org>


Pierre Glaser <pierreglaser at msn.com> added the comment:

It turns out that both pickle and _pickle implement this feature, but the behavior is inconsistent.

- As a reminder, instances of slotted classes do not have a dict attribute (1)
- On the other side, when pickling slotted class instances, __getstate__ can return a tuple of 2 dicts. The first dict represents the __dict__ attribute. Because of (1), this first dict should simply be a sentinel value. In pickle, the condition is that it evaluates to False, but in _pickle, it should be explicitly None.

(- Finally, The second dict in state contains the slotted attribute. )

Here are the lines in the two files causing the inconsistent behavior:
https://github.com/python/cpython/blob/master/Modules/_pickle.c#L6236
https://github.com/python/cpython/blob/master/Lib/pickle.py#L1549

I included an example that illustrates it.

----------
Added file: https://bugs.python.org/file48111/test_slots.py

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

From report at bugs.python.org  Thu Feb  7 16:00:31 2019
From: report at bugs.python.org (Pierre Glaser)
Date: Thu, 07 Feb 2019 21:00:31 +0000
Subject: [docs] [issue35933] python doc does not say that the state kwarg in
 Pickler.save_reduce can be a tuple (and not only a dict)
In-Reply-To: <1549562122.06.0.315178283617.issue35933@roundup.psfhosted.org>
Message-ID: <1549573229.52.0.921704853073.issue35933@roundup.psfhosted.org>


Change by Pierre Glaser <pierreglaser at msn.com>:


Removed file: https://bugs.python.org/file48111/test_slots.py

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

From report at bugs.python.org  Thu Feb  7 16:00:59 2019
From: report at bugs.python.org (Pierre Glaser)
Date: Thu, 07 Feb 2019 21:00:59 +0000
Subject: [docs] [issue35933] python doc does not say that the state kwarg in
 Pickler.save_reduce can be a tuple (and not only a dict)
In-Reply-To: <1549562122.06.0.315178283617.issue35933@roundup.psfhosted.org>
Message-ID: <1549573258.71.0.790871633707.issue35933@roundup.psfhosted.org>


Change by Pierre Glaser <pierreglaser at msn.com>:


Added file: https://bugs.python.org/file48112/test_slots.py

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

From report at bugs.python.org  Thu Feb  7 16:01:40 2019
From: report at bugs.python.org (Pierre Glaser)
Date: Thu, 07 Feb 2019 21:01:40 +0000
Subject: [docs] [issue35933] python doc does not say that the state kwarg in
 Pickler.save_reduce can be a tuple (and not only a dict)
In-Reply-To: <1549562122.06.0.315178283617.issue35933@roundup.psfhosted.org>
Message-ID: <1549573299.65.0.243542856061.issue35933@roundup.psfhosted.org>


Change by Pierre Glaser <pierreglaser at msn.com>:


Removed file: https://bugs.python.org/file48112/test_slots.py

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

From report at bugs.python.org  Thu Feb  7 16:02:02 2019
From: report at bugs.python.org (Pierre Glaser)
Date: Thu, 07 Feb 2019 21:02:02 +0000
Subject: [docs] [issue35933] python doc does not say that the state kwarg in
 Pickler.save_reduce can be a tuple (and not only a dict)
In-Reply-To: <1549562122.06.0.315178283617.issue35933@roundup.psfhosted.org>
Message-ID: <1549573321.94.0.274671014384.issue35933@roundup.psfhosted.org>


Change by Pierre Glaser <pierreglaser at msn.com>:


Added file: https://bugs.python.org/file48113/test_slots.py

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

From report at bugs.python.org  Thu Feb  7 17:21:37 2019
From: report at bugs.python.org (Antoine Pitrou)
Date: Thu, 07 Feb 2019 22:21:37 +0000
Subject: [docs] [issue35933] python doc does not say that the state kwarg in
 Pickler.save_reduce can be a tuple (and not only a dict)
In-Reply-To: <1549562122.06.0.315178283617.issue35933@roundup.psfhosted.org>
Message-ID: <1549578094.63.0.0378848598051.issue35933@roundup.psfhosted.org>


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

You can have both a dict and slots by subclassing:

>>> class A: 
...:     __slots__ = ('x',) 
...:                                                                                                                                                                   
>>> class B(A): pass                                                                                                                                                   
>>>                                                                                                                                                                    
>>> b = B()                                                                                                                                                            
>>> b.x = 5                                                                                                                                                            
>>> b.y = 6                                                                                                                                                            
>>> b.__dict__                                                                                                                                                         
{'y': 6}
>>> A.x                                                                                                                                                                
<member 'x' of 'A' objects>
>>> A.x.__get__(b)                                                                                                                                                     
5

----------

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

From report at bugs.python.org  Thu Feb  7 17:23:58 2019
From: report at bugs.python.org (Raymond Hettinger)
Date: Thu, 07 Feb 2019 22:23:58 +0000
Subject: [docs] [issue35933] python doc does not say that the state kwarg in
 Pickler.save_reduce can be a tuple (and not only a dict)
In-Reply-To: <1549562122.06.0.315178283617.issue35933@roundup.psfhosted.org>
Message-ID: <1549578236.37.0.0290751439768.issue35933@roundup.psfhosted.org>


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

Interestingly, you can also put an instance dict in slots:

>>> class A:
	__slots__ = ['x', '__dict__']
	
>>> a = A()
>>> a.x = 5
>>> a.y = 6
>>> a.__dict__
{'y': 6}
>>> a.x
5

----------
nosy: +rhettinger

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

From report at bugs.python.org  Fri Feb  8 00:44:03 2019
From: report at bugs.python.org (paul j3)
Date: Fri, 08 Feb 2019 05:44:03 +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: <1549604641.66.0.083032739241.issue35533@roundup.psfhosted.org>


paul j3 <ajipanca at gmail.com> added the comment:

The proposed PR does not address this issue.  It just adds comments to the method code, which aren't really needed.  The method is short and obvious.  We don't need, at this time, to get into questions of whether comments in argparse.py conform to one of the PEPs.

All this issue needs is a change to the documentation.  Changing:

ArgumentParser.exit(status=0, message=None)

This method terminates the program, exiting with the specified status and, if given, it prints a message before that.

to:

ArgumentParser.exit(status=0, message=None)

This method terminates the program, exiting with the specified status and, if given, it prints a message to **standard error** before that.

While I'm not opposed to this change, I don't think it is important.  

The documentation makes these two methods public, which I believe serves two purposes:

- developers may want to issue their own `parser.error('...')` call, during post-parsing value checking, or issue their own `parser.exit()` call in a custom 'Action' class (much like what '_HelpAction' does).

- developers might want to modify one or both of these in a ArgumentParser subclass.  The unittesting code in argparse does this to capture and redirect errors.

In both cases I expect the developer will want to read the code as well as the documentation.  The fact that `exit()` uses stderr is quite obvious from the code.  

It's worth keeping in mind that the documentation never replicates the code.  For example, in this case the documentation says error(), "terminates the program with a status code of 2.", when what it really does is "terminates with a call to exit(status=2)".

----------

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

From report at bugs.python.org  Fri Feb  8 04:34:36 2019
From: report at bugs.python.org (Pierre Glaser)
Date: Fri, 08 Feb 2019 09:34:36 +0000
Subject: [docs] [issue35933] python doc does not say that the state kwarg in
 Pickler.save_reduce can be a tuple (and not only a dict)
In-Reply-To: <1549562122.06.0.315178283617.issue35933@roundup.psfhosted.org>
Message-ID: <1549618472.29.0.99843932044.issue35933@roundup.psfhosted.org>


Pierre Glaser <pierreglaser at msn.com> added the comment:

Thanks Antoine and Raymond for the feedback.

Indeed, a subclass of a slotted class can have a dict: I enriched the script, pickling_depickling instances of such subclasses, with the length-2 tuple __getstate__ method, and made sure their attributes were properly retrieved.

Apart from the different checks on state carried out in the c load_build and the python load_build, AFAICT, it seems like this feature works :)

----------

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

From report at bugs.python.org  Fri Feb  8 04:34:53 2019
From: report at bugs.python.org (Pierre Glaser)
Date: Fri, 08 Feb 2019 09:34:53 +0000
Subject: [docs] [issue35933] python doc does not say that the state kwarg in
 Pickler.save_reduce can be a tuple (and not only a dict)
In-Reply-To: <1549562122.06.0.315178283617.issue35933@roundup.psfhosted.org>
Message-ID: <1549618492.28.0.233231234696.issue35933@roundup.psfhosted.org>


Change by Pierre Glaser <pierreglaser at msn.com>:


Removed file: https://bugs.python.org/file48113/test_slots.py

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

From report at bugs.python.org  Fri Feb  8 04:37:14 2019
From: report at bugs.python.org (Pierre Glaser)
Date: Fri, 08 Feb 2019 09:37:14 +0000
Subject: [docs] [issue35933] python doc does not say that the state kwarg in
 Pickler.save_reduce can be a tuple (and not only a dict)
In-Reply-To: <1549562122.06.0.315178283617.issue35933@roundup.psfhosted.org>
Message-ID: <1549618633.12.0.138037404513.issue35933@roundup.psfhosted.org>


Change by Pierre Glaser <pierreglaser at msn.com>:


Added file: https://bugs.python.org/file48114/test_slots.py

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

From report at bugs.python.org  Fri Feb  8 08:22:07 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Fri, 08 Feb 2019 13:22:07 +0000
Subject: [docs] [issue24087] Documentation doesn't explain the term
 "coroutine" (PEP 342)
In-Reply-To: <1430425552.31.0.779606074615.issue24087@psf.upfronthosting.co.za>
Message-ID: <1549632125.55.0.944994135625.issue24087@roundup.psfhosted.org>


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

While some of the proposed changes in this issue have been applied to the documentation under other issues, other changes have not been applied.  Is it still desirable to incorporate the other changes (such as native coroutine) or have the existing doc changes been enough to make this issue obsolete?

Thank you.

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

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

From report at bugs.python.org  Fri Feb  8 08:54:30 2019
From: report at bugs.python.org (Paul Moore)
Date: Fri, 08 Feb 2019 13:54:30 +0000
Subject: [docs] [issue24087] Documentation doesn't explain the term
 "coroutine" (PEP 342)
In-Reply-To: <1430425552.31.0.779606074615.issue24087@psf.upfronthosting.co.za>
Message-ID: <1549634067.0.0.903125061559.issue24087@roundup.psfhosted.org>


Paul Moore <p.f.moore at gmail.com> added the comment:

I'm OK that the basic glossary item is now covered. I don't know about any of the other issues Martin mentioned.

I've closed the issue as my original comment is addressed, but if Martin wants to reopen it to address his concerns, I'm OK with him doing that.

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

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

From report at bugs.python.org  Fri Feb  8 14:14:27 2019
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 08 Feb 2019 19:14:27 +0000
Subject: [docs] [issue35927] Intra-package References Documentation
 Incomplete
In-Reply-To: <1549514310.42.0.442993756904.issue35927@roundup.psfhosted.org>
Message-ID: <1549653261.55.0.860418125305.issue35927@roundup.psfhosted.org>


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

3.6 only gets security patches.

I cannot comment on relative imports as I never use them, but the absolute imports should work and do for me.  I just added to idlelib.idle_test a file a.py containing 'from idlelib.idle_test import htest' and it works find.  The idlelib and idle_test __init__.py files are not empty, but that should not make a difference.  In fact, many of the test_xyz modules already import from the non-test utility modules in the same directory.

The error messsage suggests that you did not put the top level package directory, 'sound', in a directory in sys.path, as you must.  What directory contains your sound package and what is your sys.path?  I suspect that this should be closed as 'not a bug'.

----------
nosy: +brett.cannon, eric.snow, ncoghlan, terry.reedy
versions: +Python 3.7, Python 3.8 -Python 3.6

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

From report at bugs.python.org  Fri Feb  8 14:31:05 2019
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 08 Feb 2019 19:31:05 +0000
Subject: [docs] [issue35927] Intra-package References Documentation
 Incomplete
In-Reply-To: <1549514310.42.0.442993756904.issue35927@roundup.psfhosted.org>
Message-ID: <1549654261.52.0.212780914748.issue35927@roundup.psfhosted.org>


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

When reporting problems, copy and paste into the report the complete exception traceback and error message.  For import problems, also copy and paste sys.path.  If you disagree that this should be closed, please do so.

----------

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

From report at bugs.python.org  Fri Feb  8 17:15:10 2019
From: report at bugs.python.org (Mark Forrer)
Date: Fri, 08 Feb 2019 22:15:10 +0000
Subject: [docs] [issue35946] Ambiguous documentation for assert_called_with()
Message-ID: <1549664108.48.0.268470561842.issue35946@roundup.psfhosted.org>


New submission from Mark Forrer <mark.forrer at lbl.gov>:

The documentation for assert_called_with() is ambiguous with regard to the fact that the method only checks the most recent call.  This behavior for assert_called_with() is only documented under assert_any_call(), which users are unlikely to read when making quick reference to the documentation.

----------
assignee: docs at python
components: Documentation
messages: 335112
nosy: chimaerase, docs at python
priority: normal
severity: normal
status: open
title: Ambiguous documentation for assert_called_with()
versions: Python 3.7

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

From report at bugs.python.org  Fri Feb  8 17:37:42 2019
From: report at bugs.python.org (=?utf-8?q?R=C3=A9mi_Lapeyre?=)
Date: Fri, 08 Feb 2019 22:37:42 +0000
Subject: [docs] [issue35946] Ambiguous documentation for assert_called_with()
In-Reply-To: <1549664108.48.0.268470561842.issue35946@roundup.psfhosted.org>
Message-ID: <1549665462.43.0.480720982228.issue35946@roundup.psfhosted.org>


Change by R?mi Lapeyre <remi.lapeyre at henki.fr>:


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

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

From report at bugs.python.org  Fri Feb  8 17:37:46 2019
From: report at bugs.python.org (=?utf-8?q?R=C3=A9mi_Lapeyre?=)
Date: Fri, 08 Feb 2019 22:37:46 +0000
Subject: [docs] [issue35946] Ambiguous documentation for assert_called_with()
In-Reply-To: <1549664108.48.0.268470561842.issue35946@roundup.psfhosted.org>
Message-ID: <1549665466.2.0.015008906667.issue35946@roundup.psfhosted.org>


Change by R?mi Lapeyre <remi.lapeyre at henki.fr>:


----------
keywords: +patch, patch
pull_requests: +11800, 11801
stage:  -> patch review

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

From report at bugs.python.org  Fri Feb  8 17:37:49 2019
From: report at bugs.python.org (=?utf-8?q?R=C3=A9mi_Lapeyre?=)
Date: Fri, 08 Feb 2019 22:37:49 +0000
Subject: [docs] [issue35946] Ambiguous documentation for assert_called_with()
In-Reply-To: <1549664108.48.0.268470561842.issue35946@roundup.psfhosted.org>
Message-ID: <1549665469.54.0.686248413505.issue35946@roundup.psfhosted.org>


Change by R?mi Lapeyre <remi.lapeyre at henki.fr>:


----------
keywords: +patch, patch, patch
pull_requests: +11800, 11801, 11802
stage:  -> patch review

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

From report at bugs.python.org  Fri Feb  8 17:39:21 2019
From: report at bugs.python.org (=?utf-8?q?R=C3=A9mi_Lapeyre?=)
Date: Fri, 08 Feb 2019 22:39:21 +0000
Subject: [docs] [issue35946] Ambiguous documentation for assert_called_with()
In-Reply-To: <1549664108.48.0.268470561842.issue35946@roundup.psfhosted.org>
Message-ID: <1549665560.43.0.0793436216434.issue35946@roundup.psfhosted.org>


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

Hi Mark Forrer, I opened a new PR to add this precision to assert_called_with documentation.

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

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

From report at bugs.python.org  Fri Feb  8 18:53:26 2019
From: report at bugs.python.org (Mark Forrer)
Date: Fri, 08 Feb 2019 23:53:26 +0000
Subject: [docs] [issue35946] Ambiguous documentation for assert_called_with()
In-Reply-To: <1549665560.43.0.0793436216434.issue35946@roundup.psfhosted.org>
Message-ID: <CANeujO0GFBMwLOaVVQ00gfA19ixR4o3+jAKAKXAgVWmAbrb1Vg@mail.gmail.com>


Mark Forrer <mark.forrer at lbl.gov> added the comment:

Thank you R?mi!

Thanks,

--Mark--

On Fri, Feb 8, 2019 at 2:39 PM R?mi Lapeyre <report at bugs.python.org> wrote:

>
> R?mi Lapeyre <remi.lapeyre at henki.fr> added the comment:
>
> Hi Mark Forrer, I opened a new PR to add this precision to
> assert_called_with documentation.
>
> ----------
> nosy: +remi.lapeyre
> versions: +Python 3.8
>
> _______________________________________
> Python tracker <report at bugs.python.org>
> <https://bugs.python.org/issue35946>
> _______________________________________
>

----------

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

From report at bugs.python.org  Sat Feb  9 01:16:28 2019
From: report at bugs.python.org (ADataGman)
Date: Sat, 09 Feb 2019 06:16:28 +0000
Subject: [docs] [issue35927] Intra-package References Documentation
 Incomplete
In-Reply-To: <1549654261.52.0.212780914748.issue35927@roundup.psfhosted.org>
Message-ID: <CAJnDJ=YLUAqwTHRdP7kOnNnLiogzJjmaXaQqeQZo8XmsaRPjVQ@mail.gmail.com>


ADataGman <aarongrossman at gmail.com> added the comment:

Here's the full error log I receive when using the code I submitted with
both ..effects and sound.effects. It also includes a print out of the sys
path as run from vocoder.

I tried running this in 3.7.2 and still get the same errors. It seems like
it's already on the sys path? I'm not saying there is a bug in python
itself, it's just not at all clear from the documentation that what is
described as being a way to access sibling packages actually works.

Given the attached code sample, as a newb I'd greatly appreciate an example
of how to take that sample and turn it into functioning code with whatever
modifiers is necessary. Ultimately whatever changes are made I'd like to
see reflected in the documentation for the intra-reference section.

PS C:\sound> &
C:/Users/user/AppData/Local/Programs/Python/Python37/python.exe
c:/sound/filters/vocoder.py
Traceback (most recent call last):
  File "c:/sound/filters/vocoder.py", line 7, in <module>
    vocoder.pp()
  File "c:/sound/filters/vocoder.py", line 4, in pp
    from ..effects import echo
ValueError: attempted relative import beyond top-level package
PS C:\sound> &
C:/Users/user/AppData/Local/Programs/Python/Python37/python.exe
c:/sound/filters/vocoder.py
Traceback (most recent call last):
  File "c:/sound/filters/vocoder.py", line 7, in <module>
    vocoder.pp()
  File "c:/sound/filters/vocoder.py", line 4, in pp
    from sound.effects import echo
ModuleNotFoundError: No module named 'sound'
PS C:\sound> &
C:/Users/user/AppData/Local/Programs/Python/Python37/python.exe
c:/sound/filters/vocoder.py
['c:\\sound\\filters',
'C:\\Users\\user\\AppData\\Local\\Programs\\Python\\Python37\\python37.zip',
'C:\\Users\\user\\AppData\\Local\\Programs\\Python\\Python37\\DLLs',
'C:\\Users\\user\\AppData\\Local\\Programs\\Python\\Python37\\lib',
'C:\\Users\\user\\AppData\\Local\\Programs\\Python\\Python37',
'C:\\Users\\user\\AppData\\Roaming\\Python\\Python37\\site-packages',
'C:\\Users\\user\\AppData\\Local\\Programs\\Python\\Python37\\lib\\site-packages']

On Fri, Feb 8, 2019 at 2:31 PM Terry J. Reedy <report at bugs.python.org>
wrote:

>
> Terry J. Reedy <tjreedy at udel.edu> added the comment:
>
> When reporting problems, copy and paste into the report the complete
> exception traceback and error message.  For import problems, also copy and
> paste sys.path.  If you disagree that this should be closed, please do so.
>
> ----------
>
> _______________________________________
> Python tracker <report at bugs.python.org>
> <https://bugs.python.org/issue35927>
> _______________________________________
>

----------

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

From report at bugs.python.org  Sun Feb 10 11:33:41 2019
From: report at bugs.python.org (fabrice salvaire)
Date: Sun, 10 Feb 2019 16:33:41 +0000
Subject: [docs] [issue35956] Sort documentation could be improved for
 complex sorting
Message-ID: <1549816419.03.0.97544553945.issue35956@roundup.psfhosted.org>


New submission from fabrice salvaire <fabrice.salvaire at orange.fr>:

I just implemented Graham Scan algorithm in Python 3 and have to read carefully the sort documentation.  Notice this is a good algorithm for a large audience language like Python.

Since Python 3, the old order function cmp is depicted as an old way to proceed.

But some sorting procedure require complex order like this

    def sort_by_y(p0, p1):
        return p0.x - p1.x if (p0.y == p1.y) else p0.y - p1.y
    sorted(points, key=cmp_to_key(sort_by_y))

which is less natural to implement than

    def sort_by_y(p0, p1):
        return p0.x < p1.x if (p0.y == p1.y) else p0.y < p1.y
    sorted(points, cmp=sort_by_y)

Since Python 3 we should do this

    points.sort(key=attrgetter('x'))
    points.sort(key=attrgetter('y'))

But we must take care to the chaining order !!! Here we must sort first on x then on y.

I think the documentation could explain much better how to perform complex sort and the performance of the Python sort algorithm.  Is the old way faster than the new one ???  What about short and large array ???  What happen when we sort a zillion of short array ???

----------
assignee: docs at python
components: Documentation
messages: 335163
nosy: FabriceSalvaire, docs at python
priority: normal
severity: normal
status: open
title: Sort documentation could be improved for complex sorting
type: enhancement
versions: Python 3.7

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

From report at bugs.python.org  Sun Feb 10 11:37:46 2019
From: report at bugs.python.org (SilentGhost)
Date: Sun, 10 Feb 2019 16:37:46 +0000
Subject: [docs] [issue35956] Sort documentation could be improved for
 complex sorting
In-Reply-To: <1549816419.03.0.97544553945.issue35956@roundup.psfhosted.org>
Message-ID: <1549816664.96.0.735387915438.issue35956@roundup.psfhosted.org>


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

Is this not equivalent to the following?

  sorted(points, key=lambda p: (p.y, p.x))

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

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

From report at bugs.python.org  Sun Feb 10 12:26:59 2019
From: report at bugs.python.org (=?utf-8?q?J=C3=A9r=C3=B4me_LAURENS?=)
Date: Sun, 10 Feb 2019 17:26:59 +0000
Subject: [docs] [issue35957] Indentation explanation is unclear
Message-ID: <1549819617.52.0.344509790006.issue35957@roundup.psfhosted.org>


New submission from J?r?me LAURENS <jerome.laurens.dev at gmail.com>:

https://docs.python.org/3/reference/lexical_analysis.html#indentation reads

Point 1:
"Tabs are replaced (from left to right) by one to eight spaces such that the total number of characters up to and including the replacement is a multiple of eight"

and in the next paragraph

Point 2:
"Indentation is rejected as inconsistent if a source file mixes tabs and spaces in a way that makes the meaning dependent on the worth of a tab in spaces"

In point 1, each tab has definitely a unique space counterpart, in point 2, tabs may have different space counterpart, which one is reliable ?

The documentation should state that Point 1 concerns cPython, or at least indicate that the 8 may depend on the implementation, which then gives sense to point 2.

----------
assignee: docs at python
components: Documentation
messages: 335165
nosy: J?r?me LAURENS, docs at python
priority: normal
severity: normal
status: open
title: Indentation explanation is unclear
type: enhancement
versions: Python 3.7

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

From report at bugs.python.org  Sun Feb 10 13:03:43 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 10 Feb 2019 18:03:43 +0000
Subject: [docs] [issue35956] Sort documentation could be improved for
 complex sorting
In-Reply-To: <1549816419.03.0.97544553945.issue35956@roundup.psfhosted.org>
Message-ID: <1549821820.83.0.468496430118.issue35956@roundup.psfhosted.org>


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

Take a look at issue 35020 which discusses multisort.

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

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

From MichaelBlankenship.ftw at outlook.com  Sun Feb 10 12:55:39 2019
From: MichaelBlankenship.ftw at outlook.com (Michael Blankenship)
Date: Sun, 10 Feb 2019 17:55:39 +0000
Subject: [docs] Correction for documentation reference
Message-ID: <CY1PR16MB07620A454F25B390D979F55E936B0@CY1PR16MB0762.namprd16.prod.outlook.com>

There is some text in this page... https://docs.python.org/3/tutorial/controlflow.html#lambda-forms ...which indicates:

Name your classes and functions consistently; the convention is to use CamelCase for classes and lower_case_with_underscores for functions and methods.

Technically, the term camelCase (without other decoration) does not begin with a capitalized letter since it now looks like a camel with a hump in the middle. Given the potential for ambiguity there are two distinctions which more clearly identify what happens with the first character: UpperCamelCase and lowe?rCamelCase.

I'm also pretty sure lowercase is now a single word rather than two.

I would suggest reviewing and replacing with:

Name your classes and functions consistently; the convention is to use UpperCamelCase for classes and lowercase_with_underscores for functions and methods.

More information:  https://en.wikipedia.org/wiki/Naming_convention_(programming)#Python_and_Ruby
Naming convention (programming) - Wikipedia<https://en.wikipedia.org/wiki/Naming_convention_(programming)#Python_and_Ruby>
In computer programming, a naming convention is a set of rules for choosing the character sequence to be used for identifiers which denote variables, types, functions, and other entities in source code and documentation.. Reasons for using a naming convention (as opposed to allowing programmers to choose any character sequence) include the following:
en.wikipedia.org


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

From report at bugs.python.org  Sun Feb 10 19:36:46 2019
From: report at bugs.python.org (Brennan D Baraban)
Date: Mon, 11 Feb 2019 00:36:46 +0000
Subject: [docs] [issue23460] Decimals do not obey ':g' exponential notation
 formatting rules
In-Reply-To: <1423847721.13.0.666007782647.issue23460@psf.upfronthosting.co.za>
Message-ID: <1549845402.63.0.511336486405.issue23460@roundup.psfhosted.org>


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

What is the status of this issue? I can submit a PR based on Tuomas Suutari's patch.

----------
nosy: +bdbaraban

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

From report at bugs.python.org  Sun Feb 10 20:39:54 2019
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 11 Feb 2019 01:39:54 +0000
Subject: [docs] [issue35956] Sort documentation could be improved for
 complex sorting
In-Reply-To: <1549816419.03.0.97544553945.issue35956@roundup.psfhosted.org>
Message-ID: <1549849191.43.0.52561484247.issue35956@roundup.psfhosted.org>


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

It seems to me that the sorting howto covers this topic.

If I'm reading the OP's task correctly, it isn't complex at all:

   points.sort(key=attrgetter('x', 'y'))  # x is primary key; y is secondary

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

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

From report at bugs.python.org  Mon Feb 11 03:12:28 2019
From: report at bugs.python.org (Tuomas Suutari)
Date: Mon, 11 Feb 2019 08:12:28 +0000
Subject: [docs] [issue23460] Decimals do not obey ':g' exponential notation
 formatting rules
In-Reply-To: <1549845402.63.0.511336486405.issue23460@roundup.psfhosted.org>
Message-ID: <CAPXCX8D7eY56E1+Lst503LGsdeWoAz_qExghpgHTG_tDMjKBXw@mail.gmail.com>


Tuomas Suutari <tuomas.suutari at gmail.com> added the comment:

> What is the status of this issue? I can submit a PR based on Tuomas Suutari's patch.

Don't know more about the status, but nobody seemed to care to take my
patch forward. If contributions are accepted as GitHub pull requests
these days, I can do it myself too.

----------

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

From report at bugs.python.org  Mon Feb 11 03:31:24 2019
From: report at bugs.python.org (Stefan Krah)
Date: Mon, 11 Feb 2019 08:31:24 +0000
Subject: [docs] [issue23460] Decimals do not obey ':g' exponential notation
 formatting rules
In-Reply-To: <1423847721.13.0.666007782647.issue23460@psf.upfronthosting.co.za>
Message-ID: <1549873881.16.0.820817165749.issue23460@roundup.psfhosted.org>


Stefan Krah <stefan at bytereef.org> added the comment:

The patch LGTM, but I'm not sure if we need to document __format__().
Personally I probably wouldn't.

----------

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

From report at bugs.python.org  Mon Feb 11 03:31:42 2019
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Mon, 11 Feb 2019 08:31:42 +0000
Subject: [docs] [issue23460] Decimals do not obey ':g' exponential notation
 formatting rules
In-Reply-To: <1423847721.13.0.666007782647.issue23460@psf.upfronthosting.co.za>
Message-ID: <1549873896.78.0.266308581997.issue23460@roundup.psfhosted.org>


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

> If contributions are accepted as GitHub pull requests
these days, I can do it myself too.

GitHub pull requests are accepted. Please see https://devguide.python.org/ .

Thanks

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

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

From report at bugs.python.org  Mon Feb 11 03:34:13 2019
From: report at bugs.python.org (Stefan Krah)
Date: Mon, 11 Feb 2019 08:34:13 +0000
Subject: [docs] [issue23460] Decimals do not obey ':g' exponential notation
 formatting rules
In-Reply-To: <1423847721.13.0.666007782647.issue23460@psf.upfronthosting.co.za>
Message-ID: <1549874050.22.0.540780258749.issue23460@roundup.psfhosted.org>


Stefan Krah <stefan at bytereef.org> added the comment:

Yes, these days PRs are the only way to get anything done. Before
GitHub it would have been possible to just commit the small diff
directly to master.

----------

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

From report at bugs.python.org  Mon Feb 11 05:12:43 2019
From: report at bugs.python.org (Magnien Sebastien)
Date: Mon, 11 Feb 2019 10:12:43 +0000
Subject: [docs] [issue35962] Slight error in words in [ 2.4.1. String and
 Bytes literals ]
Message-ID: <1549879959.7.0.265215879488.issue35962@roundup.psfhosted.org>


New submission from Magnien Sebastien <s.magnien at gmail.com>:

The documentation reads :

" The backslash (\) character is used to escape characters that otherwise have a special meaning, such as newline, backslash itself, or the quote character. "

However, 'n' does not "otherwise have a special meaning", nor does it represent a new line.

The backslash character does in fact do two different things :

1) It removes special meanings from characters that have one (\\).
2) It assigns a special meaning to normal characters (\n).

A better description would therefore be :

" The backslash (\) character is used to either escape characters that have a special meaning, such as backslash itself, or the quote character - or give special meaning to characters that do not have one, such as 'n', whose escapment '\n' means 'newline'. "

----------
assignee: docs at python
components: Documentation
messages: 335205
nosy: Magnien Sebastien, docs at python
priority: normal
severity: normal
status: open
title: Slight error in words in [ 2.4.1. String and Bytes literals ]
type: enhancement
versions: Python 2.7, Python 3.7

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

From report at bugs.python.org  Mon Feb 11 05:47:18 2019
From: report at bugs.python.org (miss-islington)
Date: Mon, 11 Feb 2019 10:47:18 +0000
Subject: [docs] [issue22062] Fix pathlib.Path.(r)glob doc glitches.
In-Reply-To: <1406239862.0.0.293742999811.issue22062@psf.upfronthosting.co.za>
Message-ID: <1549882034.63.0.0612698752435.issue22062@roundup.psfhosted.org>


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


New changeset 537b6caa565ec2fc304ba6f4400cd347ce2af64b by Miss Islington (bot) (Eivind Teig) in branch 'master':
bpo-22062: Updated docstring and documentation for pathlib (GH-8519)
https://github.com/python/cpython/commit/537b6caa565ec2fc304ba6f4400cd347ce2af64b


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

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

From report at bugs.python.org  Mon Feb 11 07:03:09 2019
From: report at bugs.python.org (miss-islington)
Date: Mon, 11 Feb 2019 12:03:09 +0000
Subject: [docs] [issue22062] Fix pathlib.Path.(r)glob doc glitches.
In-Reply-To: <1406239862.0.0.293742999811.issue22062@psf.upfronthosting.co.za>
Message-ID: <1549886585.38.0.524268084798.issue22062@roundup.psfhosted.org>


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


New changeset 2259b5af3c711b40d2b81eacc1b5d75cda1ae3e2 by Miss Islington (bot) in branch '3.7':
[3.7] bpo-22062: Updated docstring and documentation for pathlib (GH-8519) (GH-11817)
https://github.com/python/cpython/commit/2259b5af3c711b40d2b81eacc1b5d75cda1ae3e2


----------

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

From report at bugs.python.org  Mon Feb 11 13:44:47 2019
From: report at bugs.python.org (Brennan D Baraban)
Date: Mon, 11 Feb 2019 18:44:47 +0000
Subject: [docs] [issue23460] Decimals do not obey ':g' exponential notation
 formatting rules
In-Reply-To: <1423847721.13.0.666007782647.issue23460@psf.upfronthosting.co.za>
Message-ID: <1549910681.28.0.95204376788.issue23460@roundup.psfhosted.org>


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

Well, Tuomas, I defer submission of a PR to you, as its your original patch.

----------

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

From report at bugs.python.org  Tue Feb 12 01:52:09 2019
From: report at bugs.python.org (Joannah Nanjekye)
Date: Tue, 12 Feb 2019 06:52:09 +0000
Subject: [docs] [issue25461] Unclear language (the word ineffective) in the
 documentation for os.walk
In-Reply-To: <1445533538.52.0.421272081658.issue25461@psf.upfronthosting.co.za>
Message-ID: <1549954329.43.0.382268375983.issue25461@roundup.psfhosted.org>


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

What is the status on this? From this discussion, it looks like @vstinner pushed changes to resolve this. Do we close this? If this still needs a patch, then one of the patches can be reviewed in a PR on GitHub.

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

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

From report at bugs.python.org  Tue Feb 12 08:00:46 2019
From: report at bugs.python.org (=?utf-8?q?J=C3=A9r=C3=B4me_LAURENS?=)
Date: Tue, 12 Feb 2019 13:00:46 +0000
Subject: [docs] [issue35957] Indentation explanation is unclear
In-Reply-To: <1549819617.52.0.344509790006.issue35957@roundup.psfhosted.org>
Message-ID: <1549976445.99.0.841355747777.issue35957@roundup.psfhosted.org>


J?r?me LAURENS <jerome.laurens.dev at gmail.com> added the comment:

To be more precise, consider code

def f(x):
       \tx=0 # 7 spaces + one tab
        return x # 8 spaces

In cpython, both indentation levels are 8 and no indentation error is reported (this is the case where both tab size and alt tab size are equal)

If instead of 8 the tab would count for 6 spaces, then we would have 12 and 8 as indentation level, resulting in a mismatch and an indentation error being reported, according to the documentation. This is inconsistent.
Then either the documentation is faulty or cpython is.

Actually, cpython accepts a mix of space and tabs only when tabs are in 8, 16, 24... positions.

----------

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

From report at bugs.python.org  Tue Feb 12 08:01:27 2019
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 12 Feb 2019 13:01:27 +0000
Subject: [docs] [issue25461] Unclear language (the word ineffective) in the
 documentation for os.walk
In-Reply-To: <1445533538.52.0.421272081658.issue25461@psf.upfronthosting.co.za>
Message-ID: <1549976487.14.0.0850669139981.issue25461@roundup.psfhosted.org>


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

> What is the status on this? From this discussion, it looks like @vstinner pushed changes to resolve this. Do we close this? If this still needs a patch, then one of the patches can be reviewed in a PR on GitHub.

It seems like os_walk_doc.patch and issue25461.patch have been written after I pushed my changes. Would you be interested to convert these patches into a proper PR?

----------

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

From report at bugs.python.org  Tue Feb 12 08:17:57 2019
From: report at bugs.python.org (Nick Coghlan)
Date: Tue, 12 Feb 2019 13:17:57 +0000
Subject: [docs] [issue35927] Intra-package References Documentation
 Incomplete
In-Reply-To: <1549514310.42.0.442993756904.issue35927@roundup.psfhosted.org>
Message-ID: <1549977477.88.0.425083482491.issue35927@roundup.psfhosted.org>


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

As discussed in http://python-notes.curiousefficiency.org/en/latest/python_concepts/import_traps.html#executing-the-main-module-twice and https://www.python.org/dev/peps/pep-0395/#why-are-my-imports-broken the cryptic error message here is due to the relative import being resolved based on the module name "__main__", since the submodule was executed directly, rather than the intended "sound.filter.vocoder" name that it would have when imported or executed via the "-m" switch.

It's spectacularly unobvious what's going on if you're not deeply familiar with the intricacies of main module execution, but I haven't had any great ideas for practical ways to improve the error message.

I'm not sure we currently have access to the required info at the point this error is raised, but perhaps it would be enough to add the name of the module doing the import to the error message as a reminder that directly executing scripts inside packages does weird things to import resolution?

Something like:

  "Attempted relative import beyond top-level package '__main__'"

----------

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

From report at bugs.python.org  Tue Feb 12 14:39:07 2019
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 12 Feb 2019 19:39: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: <1550000347.09.0.128614334109.issue34172@roundup.psfhosted.org>


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

Pablo fixed bpo-35378 with:

New changeset 3766f18c524c57784eea7c0001602017d2122156 by Pablo Galindo in branch 'master':
bpo-35378: Fix multiprocessing.Pool references (GH-11627)
https://github.com/python/cpython/commit/3766f18c524c57784eea7c0001602017d2122156

Does this change also fix this issue? If not, can we attempt again to fix this issue?

Moreover, should we do something in Python 3.7? Sadly, I don't think that we can do anything for 3.7 and 2.7.

----------

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

From report at bugs.python.org  Tue Feb 12 15:15:16 2019
From: report at bugs.python.org (Terry J. Reedy)
Date: Tue, 12 Feb 2019 20:15:16 +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: <1550002516.67.0.987178703271.issue35155@roundup.psfhosted.org>


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

Cheryl, you know rst better than me.  Is there any markup to indicate that a word is a placeholder, not meant to be taken literally?  Or is Denton's '<placeholder>' instead of 'placeholder' the best choice? See the PR and answer there.

----------
nosy: +cheryl.sabella, orsenthil, terry.reedy
versions:  -Python 3.4, Python 3.5, Python 3.6

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

From report at bugs.python.org  Tue Feb 12 16:46:51 2019
From: report at bugs.python.org (Matthew Barnett)
Date: Tue, 12 Feb 2019 21:46:51 +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: <1550008011.57.0.0304101101712.issue35155@roundup.psfhosted.org>


Matthew Barnett <python at mrabarnett.plus.com> added the comment:

You could italicise the "protocol" part using asterisks, like this:

*protocol*_request

or this:

*protocol*\ _request

depending on the implementation of the rst software.

----------
nosy: +mrabarnett

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

From report at bugs.python.org  Tue Feb 12 17:32:24 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Tue, 12 Feb 2019 22:32:24 +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: <1550010744.28.0.000499006477221.issue35155@roundup.psfhosted.org>


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

I don't think there is anything specifically defined for a placeholder.  However, looking at the current urllib.request documentation, there are 2 places that use the ``<name>_`` method for a placeholder - <protocol>.proxy and <scheme>.proxy, with the latter explaining what <scheme> means.

> By default, ProxyHandler uses the environment variables named <scheme>_proxy, where <scheme> is the URL scheme involved.

That line was added by Georg Brandl (granted it was part of converting all the docs), which would lead me to believe that is the accepted way to do it.

Also, the argument clinic how-to has the following:
> The length of the string will be passed in to the impl function, just after the string parameter, as a parameter named ``<parameter_name>_length``.

I'll make a comment on the PR too.

----------

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

From report at bugs.python.org  Tue Feb 12 20:44:15 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Wed, 13 Feb 2019 01:44:15 +0000
Subject: [docs] [issue35962] Slight error in words in [ 2.4.1. String and
 Bytes literals ]
In-Reply-To: <1549879959.7.0.265215879488.issue35962@roundup.psfhosted.org>
Message-ID: <1550022255.52.0.204267719071.issue35962@roundup.psfhosted.org>


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


----------
nosy: +ncoghlan
versions: +Python 3.8

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

From report at bugs.python.org  Tue Feb 12 21:33:50 2019
From: report at bugs.python.org (Terry J. Reedy)
Date: Wed, 13 Feb 2019 02:33:50 +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: <1550025230.18.0.533647287072.issue35155@roundup.psfhosted.org>


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

unittest is another module with half-fixed and half-variable names.  The default (glob) pattern for test module names is given as "test*.py".  The fixed pattern for test methods is given as "starts with 'test'".  This could have been given, I believe, as re "test/w*", but it wasn't.  The former is clearer for more people.  So no guidance there.

I agree that we should follow the 2 precedents. Thank you both.

----------

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

From report at bugs.python.org  Tue Feb 12 23:35:36 2019
From: report at bugs.python.org (Terry J. Reedy)
Date: Wed, 13 Feb 2019 04:35:36 +0000
Subject: [docs] [issue35927] Intra-package References Documentation
 Incomplete
In-Reply-To: <1549514310.42.0.442993756904.issue35927@roundup.psfhosted.org>
Message-ID: <1550032536.55.0.41841593392.issue35927@roundup.psfhosted.org>


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

AData> You log and output show that you problem is as described: package 'sound' is in directory "C:/" and "C:/" is not is sys.path.  Possible remedies:
1. Add "C:/" to sys.path at the top of each module that imports sound.  This is a nuisance.
2. Move the sound package to 'C:\\Users\\user\\AppData\\Local\\Programs\\Python\\Python37\\lib\\site-packages'.  This can also a nuisance.
3. Add a file named 'C.pth' and containing "C:/" to the site-packages.  ('pth' abbreviates 'path'.)  This makes C:/ an extension of site-packages.  But all the non-python stuff in C: likely makes this a bad idea.
4 (3 improved). Add a directory such as "C:/pyprojects", make the contents of the .pth file "C:/pyprojects", and move sound to pyprojects.  
This is what I have done.  When I install a new version of Python, I copy the .pth file to the new site-packeges directory.  Works great.

----------

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

From report at bugs.python.org  Wed Feb 13 03:53:27 2019
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 13 Feb 2019 08:53:27 +0000
Subject: [docs] [issue25461] Unclear language (the word ineffective) in the
 documentation for os.walk
In-Reply-To: <1445533538.52.0.421272081658.issue25461@psf.upfronthosting.co.za>
Message-ID: <1550048007.98.0.647416127995.issue25461@roundup.psfhosted.org>


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


----------
pull_requests: +11867

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

From report at bugs.python.org  Wed Feb 13 07:26:53 2019
From: report at bugs.python.org (=?utf-8?b?5p2O56yR5p2l?=)
Date: Wed, 13 Feb 2019 12:26:53 +0000
Subject: [docs] [issue35986] print() documentation typo?
Message-ID: <1550060813.07.0.324151562751.issue35986@roundup.psfhosted.org>


New submission from ??? <lixiaolai at gmail.com>:

print(), default value sep, should be ' '(one space), rather than an empty str, ''.

----------
assignee: docs at python
components: Documentation
messages: 335428
nosy: docs at python, ???
priority: normal
severity: normal
status: open
title: print() documentation typo?
type: enhancement
versions: Python 3.7

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

From report at bugs.python.org  Wed Feb 13 07:28:00 2019
From: report at bugs.python.org (=?utf-8?b?5p2O56yR5p2l?=)
Date: Wed, 13 Feb 2019 12:28:00 +0000
Subject: [docs] [issue35986] print() documentation typo?
In-Reply-To: <1550060813.07.0.324151562751.issue35986@roundup.psfhosted.org>
Message-ID: <1550060880.5.0.465335373225.issue35986@roundup.psfhosted.org>


??? <lixiaolai at gmail.com> added the comment:

sep argument default value should be ' '(a space), rather than ''(an empty string).

----------
resolution:  -> remind

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

From report at bugs.python.org  Wed Feb 13 07:45:54 2019
From: report at bugs.python.org (Steven D'Aprano)
Date: Wed, 13 Feb 2019 12:45:54 +0000
Subject: [docs] [issue35986] print() documentation typo?
In-Reply-To: <1550060813.07.0.324151562751.issue35986@roundup.psfhosted.org>
Message-ID: <1550061954.66.0.987493047533.issue35986@roundup.psfhosted.org>


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

Which documentation are you referring to?

The docstring says:

print(value, ..., sep=' ', end='\n', file=sys.stdout, flush=False)

which is clearly a space. The docs here:

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

say something very similar:

print(*objects, sep=' ', end='\n', file=sys.stdout, flush=False)

but it is really hard to see the space on the website unless you look very carefully, because the font used is a proportional font instead of a monospaced font. So the space shown is a tiny little sliver of whitespace.

But if you copy and paste the function signature into your text editor, or somewhere you can set the font to use a fixed-width programmers font, you will see that there definitely is a space there.

So not a typo, but possibly a poor choice of font. It might be nice to rethink the choice of font for parameter lists.

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

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

From report at bugs.python.org  Wed Feb 13 09:04:52 2019
From: report at bugs.python.org (Nick Coghlan)
Date: Wed, 13 Feb 2019 14:04:52 +0000
Subject: [docs] [issue12374] Execution model should explain compile vs
 definition vs execution time
In-Reply-To: <1308582911.55.0.701954968644.issue12374@psf.upfronthosting.co.za>
Message-ID: <1550066692.84.0.704283346564.issue12374@roundup.psfhosted.org>


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

Cheryl has started the conversion process for the old user reference manuscript [1], so I think it makes sense to mark this as "postponed" for now, until we see how far we can get with this more usage-centric level of explanation as a separate project from the language reference.

[1] https://github.com/ncoghlan/python-userref/tree/master/converted

----------
resolution:  -> postponed
stage: needs patch -> resolved
status: open -> closed
type:  -> enhancement

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

From report at bugs.python.org  Wed Feb 13 09:05:47 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Wed, 13 Feb 2019 14:05:47 +0000
Subject: [docs] [issue35986] print() documentation typo?
In-Reply-To: <1550060813.07.0.324151562751.issue35986@roundup.psfhosted.org>
Message-ID: <1550066747.27.0.752297129598.issue35986@roundup.psfhosted.org>


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

@steven 

I have a solution with a css selector if we update the python-docs theme for Sphinx.

You can check my screenshot

----------
nosy: +matrixise
Added file: https://bugs.python.org/file48136/print_screenshot.png

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

From report at bugs.python.org  Wed Feb 13 19:38:19 2019
From: report at bugs.python.org (ADataGman)
Date: Thu, 14 Feb 2019 00:38:19 +0000
Subject: [docs] [issue35927] Intra-package References Documentation
 Incomplete
In-Reply-To: <1550032536.55.0.41841593392.issue35927@roundup.psfhosted.org>
Message-ID: <CAJnDJ=b48kAJT9aQ7viRokq1xA7quR7kajtwdzYNWXuaHTb4xg@mail.gmail.com>


ADataGman <aarongrossman at gmail.com> added the comment:

Terry, thank you for the detailed list of alternatives on how to approach
this, that's helpful in how to tackle this issue in my current development.

Nick, for the relative imports of relative imports I think the error
message is fine. It makes sense. It doesn't necessarily give you a lot of
hints on where to go next unfortunately, but it does explain why it doesn't
work.

For the absolute imports, a hint like, the module must be discoverable in
sys.path or the like if you wanted to make this clearer.

My biggest concern was just that the way the documentation is written for
https://docs.python.org/3.6/tutorial/modules.html#intra-package-references
. It implies that the code will run without any hint of needing to be
either run from a higher level, or a work around used like Terry suggested.
Now that I've spent a few days researching and reading more on my own, and
with help from you and Terry, I understand what's happening and have
options. But for others just reading the docs and not already familiar,
it's not clear why the current example wouldn't work when run from the
sibling level.

I'd like to see the documentation for intra-package references updated to
clearly state that the code is being run from a level above. "For example,
if the module sound.filters.vocoder needs to use the echo module in the
sound.effects package, it can use from sound.effects import echo." only
works if you run it from the sound module. Which is fine! It's just not
clear to a newb that it's being executed from the sound package rather than
the filters package. Perhaps modify
https://docs.python.org/3.6/tutorial/modules.html#packages to include a
"sound.py" at the top level folder, and in the explanation for the
intra-package reference, just mention that the example quoted above runs
from that new file.

If there is a optimal way to modify the path for adding in a sibling level
package, please include that. Otherwise just clarify that the example
relies on the code being run from something from another level up.

On Tue, Feb 12, 2019 at 11:35 PM Terry J. Reedy <report at bugs.python.org>
wrote:

>
> Terry J. Reedy <tjreedy at udel.edu> added the comment:
>
> AData> You log and output show that you problem is as described: package
> 'sound' is in directory "C:/" and "C:/" is not is sys.path.  Possible
> remedies:
> 1. Add "C:/" to sys.path at the top of each module that imports sound.
> This is a nuisance.
> 2. Move the sound package to
> 'C:\\Users\\user\\AppData\\Local\\Programs\\Python\\Python37\\lib\\site-packages'.
> This can also a nuisance.
> 3. Add a file named 'C.pth' and containing "C:/" to the site-packages.
> ('pth' abbreviates 'path'.)  This makes C:/ an extension of site-packages.
> But all the non-python stuff in C: likely makes this a bad idea.
> 4 (3 improved). Add a directory such as "C:/pyprojects", make the contents
> of the .pth file "C:/pyprojects", and move sound to pyprojects.
> This is what I have done.  When I install a new version of Python, I copy
> the .pth file to the new site-packeges directory.  Works great.
>
> ----------
>
> _______________________________________
> Python tracker <report at bugs.python.org>
> <https://bugs.python.org/issue35927>
> _______________________________________
>

----------

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

From report at bugs.python.org  Wed Feb 13 20:01:54 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 14 Feb 2019 01:01:54 +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: <1550106114.49.0.500241108743.issue35155@roundup.psfhosted.org>


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

I found this issue that Serhiy did on the devguide where he added {} around the placeholder:
https://github.com/python/devguide/pull/444

I think that might be the correct way to do it.

----------

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

From report at bugs.python.org  Wed Feb 13 20:39:20 2019
From: report at bugs.python.org (Denton Liu)
Date: Thu, 14 Feb 2019 01:39:20 +0000
Subject: [docs] [issue35155] Clarify Protocol Handlers in urllib.request Docs
In-Reply-To: <1550106114.49.0.500241108743.issue35155@roundup.psfhosted.org>
Message-ID: <CA+eFxx5GyHR5_92-8bT6jw-ff==21coLSBDW=HZ7ztggU7+-Gw@mail.gmail.com>


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

I gave that a try but it seems like it just outputs the {} literally in the
case of the method role.

----------

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

From report at bugs.python.org  Wed Feb 13 21:34:43 2019
From: report at bugs.python.org (Lisa Roach)
Date: Thu, 14 Feb 2019 02:34:43 +0000
Subject: [docs] [issue21150] Add quick links table to argparse docs
In-Reply-To: <1396558035.28.0.485991636726.issue21150@psf.upfronthosting.co.za>
Message-ID: <1550111683.08.0.598658772856.issue21150@roundup.psfhosted.org>


Lisa Roach <lisaroach14 at gmail.com> added the comment:

It looks like @louielu might not be around anymore to finish this PR? If there are no objections I'd like to give a new contributor @suhearsawho a shot at this.

----------
nosy: +lisroach

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

From report at bugs.python.org  Wed Feb 13 21:45:54 2019
From: report at bugs.python.org (Lisa Roach)
Date: Thu, 14 Feb 2019 02:45:54 +0000
Subject: [docs] [issue35962] Slight error in words in [ 2.4.1. String and
 Bytes literals ]
In-Reply-To: <1549879959.7.0.265215879488.issue35962@roundup.psfhosted.org>
Message-ID: <1550112354.65.0.646560716817.issue35962@roundup.psfhosted.org>


Lisa Roach <lisaroach14 at gmail.com> added the comment:

The updated line sounds good to me, please make a PR.

----------
nosy: +lisroach

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

From report at bugs.python.org  Wed Feb 13 23:54:42 2019
From: report at bugs.python.org (Terry J. Reedy)
Date: Thu, 14 Feb 2019 04:54:42 +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: <1550120082.04.0.909692554091.issue35155@roundup.psfhosted.org>


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

For file names, the result is <name> in italics.  Looking at https://devguide.python.org/exploring/, that seems to work well.  Can we just use *<name>*?

----------

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

From report at bugs.python.org  Thu Feb 14 01:09:00 2019
From: report at bugs.python.org (Susan Su)
Date: Thu, 14 Feb 2019 06:09:00 +0000
Subject: [docs] [issue21150] Add quick links table to argparse docs
In-Reply-To: <1396558035.28.0.485991636726.issue21150@psf.upfronthosting.co.za>
Message-ID: <1550124540.08.0.907316538988.issue21150@roundup.psfhosted.org>


Susan Su <susansu.software at gmail.com> added the comment:

I'm available to start working on this bug. Please let me know if any suggestions, concerns or comments come up! Thank you.

----------
nosy: +suhearsawho

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

From report at bugs.python.org  Thu Feb 14 01:09:55 2019
From: report at bugs.python.org (Susan Su)
Date: Thu, 14 Feb 2019 06:09:55 +0000
Subject: [docs] [issue33043] Add a 'Contributing to Docs' link at the bottom
 of docs.python.org
In-Reply-To: <1520703028.47.0.467229070634.issue33043@psf.upfronthosting.co.za>
Message-ID: <1550124595.98.0.522855580429.issue33043@roundup.psfhosted.org>


Susan Su <susansu.software at gmail.com> added the comment:

I am available to start working on this bug. Please let me know if any issues, concerns, or suggestions come up! Thank you.

----------
nosy: +suhearsawho

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

From report at bugs.python.org  Thu Feb 14 01:14:12 2019
From: report at bugs.python.org (Caleb Donovick)
Date: Thu, 14 Feb 2019 06:14:12 +0000
Subject: [docs] [issue35992] Metaclasses interfere with __class_getitem__
Message-ID: <1550124852.78.0.300044847884.issue35992@roundup.psfhosted.org>


New submission from Caleb Donovick <donovick at cs.stanford.edu>:

OS:
Debian testing

python3 -VV:
Python 3.7.2+ (default, Feb  2 2019, 14:31:48)
[gcc 8.2.0]


The following:
```
class Meta(type): pass

class X(metaclass=Meta):
    def __class_getitem__(cls, key):
        return key

X[10]
```
Results in 
```
TypeError: 'Meta' object does not support indexing
```

However, PEP 560 specifically states that __class_getitem__ should be used as fall back for when a metaclass does not implement __getitem__.

----------
assignee: docs at python
components: Documentation, Interpreter Core
messages: 335497
nosy: Donovick, docs at python
priority: normal
severity: normal
status: open
title: Metaclasses interfere with __class_getitem__
type: behavior
versions: Python 3.7

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

From report at bugs.python.org  Thu Feb 14 01:23:18 2019
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Thu, 14 Feb 2019 06:23:18 +0000
Subject: [docs] [issue35992] Metaclasses interfere with __class_getitem__
In-Reply-To: <1550124852.78.0.300044847884.issue35992@roundup.psfhosted.org>
Message-ID: <1550125398.89.0.981666386881.issue35992@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Thu Feb 14 02:05:30 2019
From: report at bugs.python.org (Brennan D Baraban)
Date: Thu, 14 Feb 2019 07:05:30 +0000
Subject: [docs] [issue23460] Decimals do not obey ':g' exponential notation
 formatting rules
In-Reply-To: <1423847721.13.0.666007782647.issue23460@psf.upfronthosting.co.za>
Message-ID: <1550127930.15.0.900182327468.issue23460@roundup.psfhosted.org>


Change by Brennan D Baraban <375 at holbertonschool.com>:


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

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

From report at bugs.python.org  Thu Feb 14 02:25:15 2019
From: report at bugs.python.org (Brennan D Baraban)
Date: Thu, 14 Feb 2019 07:25:15 +0000
Subject: [docs] [issue23460] Decimals do not obey ':g' exponential notation
 formatting rules
In-Reply-To: <1423847721.13.0.666007782647.issue23460@psf.upfronthosting.co.za>
Message-ID: <1550129115.89.0.980035664289.issue23460@roundup.psfhosted.org>


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

I submitted a PR just now. I only pushed the change to `string.rst`, as per Stefan Krah's suggestion.

----------

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

From report at bugs.python.org  Thu Feb 14 02:32:12 2019
From: report at bugs.python.org (Denton Liu)
Date: Thu, 14 Feb 2019 07:32:12 +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: <1550129532.78.0.215922254189.issue35155@roundup.psfhosted.org>


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

Unfortunately, inline markup can't be combined with roles. Using asterisks, it shows up as `*<protocol>*_open()` and using braces, `{<protocol>}_open`.

I'm not sure how this works but it _might_ be possible to change how :meth: role is interpreted but I believe that's outside the scope of this change.

----------

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

From report at bugs.python.org  Thu Feb 14 06:52:20 2019
From: report at bugs.python.org (Emmanuel Arias)
Date: Thu, 14 Feb 2019 11:52:20 +0000
Subject: [docs] [issue33043] Add a 'Contributing to Docs' link at the bottom
 of docs.python.org
In-Reply-To: <1520703028.47.0.467229070634.issue33043@psf.upfronthosting.co.za>
Message-ID: <1550145140.05.0.889200866901.issue33043@roundup.psfhosted.org>


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


----------
nosy: +eamanu
type:  -> enhancement

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

From report at bugs.python.org  Thu Feb 14 06:56:42 2019
From: report at bugs.python.org (Ivan Levkivskyi)
Date: Thu, 14 Feb 2019 11:56:42 +0000
Subject: [docs] [issue35992] Metaclasses interfere with __class_getitem__
In-Reply-To: <1550124852.78.0.300044847884.issue35992@roundup.psfhosted.org>
Message-ID: <1550145403.0.0.88105493513.issue35992@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Thu Feb 14 06:57:56 2019
From: report at bugs.python.org (Ivan Levkivskyi)
Date: Thu, 14 Feb 2019 11:57:56 +0000
Subject: [docs] [issue35992] Metaclasses interfere with __class_getitem__
In-Reply-To: <1550124852.78.0.300044847884.issue35992@roundup.psfhosted.org>
Message-ID: <1550145476.97.0.167835193378.issue35992@roundup.psfhosted.org>


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

Yes, I think this is a bug. Created a PR with a possible simple fix.

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

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

From report at bugs.python.org  Thu Feb 14 07:28:55 2019
From: report at bugs.python.org (Magnien Sebastien)
Date: Thu, 14 Feb 2019 12:28:55 +0000
Subject: [docs] [issue35962] Slight error in words in [ 2.4.1. String and
 Bytes literals ]
In-Reply-To: <1549879959.7.0.265215879488.issue35962@roundup.psfhosted.org>
Message-ID: <1550147335.27.0.667951636139.issue35962@roundup.psfhosted.org>


Magnien Sebastien <s.magnien at gmail.com> added the comment:

I'm all up for it; however I only ever worked on small solo projects. I don't really know where to start. Must I clone the whole python repo, or is there maybe a doc repo?

----------

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

From report at bugs.python.org  Thu Feb 14 08:11:13 2019
From: report at bugs.python.org (=?utf-8?q?R=C3=A9mi_Lapeyre?=)
Date: Thu, 14 Feb 2019 13:11:13 +0000
Subject: [docs] [issue35962] Slight error in words in [ 2.4.1. String and
 Bytes literals ]
In-Reply-To: <1549879959.7.0.265215879488.issue35962@roundup.psfhosted.org>
Message-ID: <1550149873.7.0.708632699666.issue35962@roundup.psfhosted.org>


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

Hi Magnien, if you have already used Git, everything should be familiar.

You have to clone the whole project, but the documentation leaves in the `Doc` folder. There is a lot of information that you can get at https://devguide.python.org/documenting/

If you get lost, please open the PR and tag me in the discussion, I will try and help you.

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

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

From report at bugs.python.org  Thu Feb 14 08:12:38 2019
From: report at bugs.python.org (=?utf-8?q?R=C3=A9mi_Lapeyre?=)
Date: Thu, 14 Feb 2019 13:12:38 +0000
Subject: [docs] [issue35962] Slight error in words in [ 2.4.1. String and
 Bytes literals ]
In-Reply-To: <1549879959.7.0.265215879488.issue35962@roundup.psfhosted.org>
Message-ID: <1550149958.74.0.6092490512.issue35962@roundup.psfhosted.org>


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

You will find the line you want to change in `Doc/reference/lexical_analysis.rst`

----------

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

From report at bugs.python.org  Thu Feb 14 08:58:54 2019
From: report at bugs.python.org (SilentGhost)
Date: Thu, 14 Feb 2019 13:58:54 +0000
Subject: [docs] [issue35962] Slight error in words in [ 2.4.1. String and
 Bytes literals ]
In-Reply-To: <1549879959.7.0.265215879488.issue35962@roundup.psfhosted.org>
Message-ID: <1550152734.48.0.748093167264.issue35962@roundup.psfhosted.org>


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

I don't think that's what the sentence say at all. It says, that a backslash can be used to escape a newline character (not "n"). This refers only to triple-quoted literals and is described in the first row of the table of escape sequences below.

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

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

From report at bugs.python.org  Thu Feb 14 08:59:33 2019
From: report at bugs.python.org (SilentGhost)
Date: Thu, 14 Feb 2019 13:59:33 +0000
Subject: [docs] [issue35962] Slight error in words in [ 2.4.1. String and
 Bytes literals ]
In-Reply-To: <1549879959.7.0.265215879488.issue35962@roundup.psfhosted.org>
Message-ID: <1550152773.7.0.517220754078.issue35962@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Thu Feb 14 09:20:10 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 14 Feb 2019 14:20:10 +0000
Subject: [docs] [issue35190] collections.abc.Sequence cannot be used to test
 whether a class provides a particular interface (doc issue)
In-Reply-To: <1541688086.42.0.788709270274.issue35190@psf.upfronthosting.co.za>
Message-ID: <1550154010.45.0.926713960438.issue35190@roundup.psfhosted.org>


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

The previous comment is a self-reference.  I believe the intention was to mark this as a duplicate of #17561.

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

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

From report at bugs.python.org  Thu Feb 14 09:20:33 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 14 Feb 2019 14:20:33 +0000
Subject: [docs] [issue35190] collections.abc.Sequence cannot be used to test
 whether a class provides a particular interface (doc issue)
In-Reply-To: <1541688086.42.0.788709270274.issue35190@psf.upfronthosting.co.za>
Message-ID: <1550154033.93.0.673263042231.issue35190@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Thu Feb 14 11:26:25 2019
From: report at bugs.python.org (Josh Rosenberg)
Date: Thu, 14 Feb 2019 16:26:25 +0000
Subject: [docs] [issue35190] collections.abc.Sequence cannot be used to test
 whether a class provides a particular interface (doc issue)
In-Reply-To: <1541688086.42.0.788709270274.issue35190@psf.upfronthosting.co.za>
Message-ID: <1550161585.58.0.461962533128.issue35190@roundup.psfhosted.org>


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

Wait, why should #25737 be closed? This bug is a docs issue; collections.abc shouldn't claim that all the ABCs do duck-typing checks since Sequence doesn't. But #25737 is specific: array.array *should* be registered as a Sequence, but isn't; that requires a code fix (to make array perform the registration), not a doc fix.

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

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

From report at bugs.python.org  Thu Feb 14 11:59:26 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 14 Feb 2019 16:59:26 +0000
Subject: [docs] [issue35874] Clarify that the (...) convertor to
 PyArg_ParseTuple... accepts any sequence.
In-Reply-To: <1549011809.83.0.066679441781.issue35874@roundup.psfhosted.org>
Message-ID: <1550163566.01.0.336996830202.issue35874@roundup.psfhosted.org>


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

Passing non-tuple can lead to reference counting error. See issue6083. I think that accepting a non-tuple should be deprecated, and finally disallowed.

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

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

From report at bugs.python.org  Thu Feb 14 15:51:11 2019
From: report at bugs.python.org (Brett Cannon)
Date: Thu, 14 Feb 2019 20:51:11 +0000
Subject: [docs] [issue35843] importlib.util docs for namespace packages
 innaccurate
In-Reply-To: <1548698590.94.0.426601552573.issue35843@roundup.psfhosted.org>
Message-ID: <1550177471.45.0.69683262059.issue35843@roundup.psfhosted.org>


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


----------
nosy: +barry, eric.smith, eric.snow, ncoghlan

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

From report at bugs.python.org  Thu Feb 14 18:35:28 2019
From: report at bugs.python.org (miss-islington)
Date: Thu, 14 Feb 2019 23:35:28 +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: <1550187328.19.0.0369711201925.issue30410@roundup.psfhosted.org>


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


New changeset 5723263a3a39a05b6a2f567e0e7771792e6e2f5b by Miss Islington (bot) (Lysandros Nikolaou) in branch 'master':
bpo-30410: Documentation of sys.stdin/out/err update to reflect change in 3.6 (GH-10264)
https://github.com/python/cpython/commit/5723263a3a39a05b6a2f567e0e7771792e6e2f5b


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

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

From report at bugs.python.org  Thu Feb 14 18:35:48 2019
From: report at bugs.python.org (miss-islington)
Date: Thu, 14 Feb 2019 23:35:48 +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: <1550187348.99.0.958825680684.issue30410@roundup.psfhosted.org>


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


----------
pull_requests: +11893

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

From report at bugs.python.org  Thu Feb 14 18:36:54 2019
From: report at bugs.python.org (Mariatta Wijaya)
Date: Thu, 14 Feb 2019 23:36:54 +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: <1550187414.79.0.708983280988.issue30410@roundup.psfhosted.org>


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

Fixed in 3.8 and 3.7.
Thanks!

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

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

From report at bugs.python.org  Thu Feb 14 18:45:23 2019
From: report at bugs.python.org (miss-islington)
Date: Thu, 14 Feb 2019 23:45:23 +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: <1550187923.36.0.416142387676.issue30410@roundup.psfhosted.org>


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


New changeset b8bcec35e01cac018f6ccfc8323d35886340efe0 by Miss Islington (bot) in branch '3.7':
bpo-30410: Documentation of sys.stdin/out/err update to reflect change in 3.6 (GH-10264)
https://github.com/python/cpython/commit/b8bcec35e01cac018f6ccfc8323d35886340efe0


----------

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

From report at bugs.python.org  Fri Feb 15 07:03:53 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Fri, 15 Feb 2019 12:03:53 +0000
Subject: [docs] [issue35986] print() documentation typo?
In-Reply-To: <1550060813.07.0.324151562751.issue35986@roundup.psfhosted.org>
Message-ID: <1550232233.69.0.379830653739.issue35986@roundup.psfhosted.org>


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

This was fixed with https://github.com/python/python-docs-theme/pull/25
by @matrixise.

----------
nosy: +cheryl.sabella
resolution: remind -> third party
stage:  -> resolved
status: open -> closed
versions: +Python 3.8

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

From report at bugs.python.org  Fri Feb 15 07:13:45 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Fri, 15 Feb 2019 12:13:45 +0000
Subject: [docs] [issue35986] print() documentation typo?
In-Reply-To: <1550060813.07.0.324151562751.issue35986@roundup.psfhosted.org>
Message-ID: <1550232825.88.0.250003271717.issue35986@roundup.psfhosted.org>


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

Thanks @cheryl

but we need to have a new package of python-docs-theme.

----------

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

From report at bugs.python.org  Fri Feb 15 08:43:25 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Fri, 15 Feb 2019 13:43:25 +0000
Subject: [docs] [issue35986] print() documentation typo?
In-Reply-To: <1550060813.07.0.324151562751.issue35986@roundup.psfhosted.org>
Message-ID: <1550238205.45.0.723604847518.issue35986@roundup.psfhosted.org>


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

Yes, but I thought that would be up to @theacodes to release a new version of python-docs-theme to PyPI?  Since the last release was 6 months ago and the previous one to that was February 2018, I was hoping the new release would come soon.

In any event, I didn't think there was anything else that could be done on this issue, which is why I closed it.  Is there something that needs to be updated in the CPython repository?

----------

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

From report at bugs.python.org  Fri Feb 15 08:45:36 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Fri, 15 Feb 2019 13:45:36 +0000
Subject: [docs] [issue35986] print() documentation typo?
In-Reply-To: <1550060813.07.0.324151562751.issue35986@roundup.psfhosted.org>
Message-ID: <1550238336.87.0.252922776984.issue35986@roundup.psfhosted.org>


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

not in the CPython repo, just ask to regenerate the PyPI package. thanks

----------

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

From report at bugs.python.org  Fri Feb 15 11:37:37 2019
From: report at bugs.python.org (Mark Dickinson)
Date: Fri, 15 Feb 2019 16:37:37 +0000
Subject: [docs] [issue35880] math.sin has no backward error;
 this isn't documented
In-Reply-To: <1549021657.57.0.382503652198.issue35880@roundup.psfhosted.org>
Message-ID: <1550248657.13.0.91995728874.issue35880@roundup.psfhosted.org>


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

@jneb: Please could you clarify what sort of addition to the documentation you're proposing? Again, it's not clear what you mean by "backward error" here, or what sort of addition would be useful given the divergence of math function behaviours across platforms. Any documentation addition should cover more than just sin here; sin isn't at all special.

Setting to pending.

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

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

From report at bugs.python.org  Fri Feb 15 13:08:32 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Fri, 15 Feb 2019 18:08:32 +0000
Subject: [docs] [issue36006] [good first issue] Align version changed for
 truncate in io module
Message-ID: <1550254112.89.0.985997369649.issue36006@roundup.psfhosted.org>


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

In the documentation page for the io module, under the truncate method, there is a version changed directive which is not properly aligned.

https://docs.python.org/3/library/io.html#io.IOBase.truncate

----------
assignee: docs at python
components: Documentation
keywords: easy
messages: 335633
nosy: cheryl.sabella, docs at python
priority: normal
severity: normal
stage: needs patch
status: open
title: [good first issue] Align version changed for truncate in io module
type: enhancement
versions: Python 3.7, Python 3.8

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

From report at bugs.python.org  Fri Feb 15 13:24:52 2019
From: report at bugs.python.org (Emmanuel Arias)
Date: Fri, 15 Feb 2019 18:24:52 +0000
Subject: [docs] [issue36006] [good first issue] Align version changed for
 truncate in io module
In-Reply-To: <1550254112.89.0.985997369649.issue36006@roundup.psfhosted.org>
Message-ID: <1550255092.36.0.637123203827.issue36006@roundup.psfhosted.org>


Emmanuel Arias <emmanuelarias30 at gmail.com> added the comment:

I take it

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

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

From report at bugs.python.org  Fri Feb 15 13:46:12 2019
From: report at bugs.python.org (Emmanuel Arias)
Date: Fri, 15 Feb 2019 18:46:12 +0000
Subject: [docs] [issue36006] [good first issue] Align version changed for
 truncate in io module
In-Reply-To: <1550254112.89.0.985997369649.issue36006@roundup.psfhosted.org>
Message-ID: <1550256372.97.0.433415960313.issue36006@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Fri Feb 15 13:52:06 2019
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 15 Feb 2019 18:52:06 +0000
Subject: [docs] [issue36006] [good first issue] Align version changed for
 truncate in io module
In-Reply-To: <1550254112.89.0.985997369649.issue36006@roundup.psfhosted.org>
Message-ID: <1550256726.17.0.331689162861.issue36006@roundup.psfhosted.org>


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

Thanks!

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

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

From report at bugs.python.org  Fri Feb 15 14:02:43 2019
From: report at bugs.python.org (miss-islington)
Date: Fri, 15 Feb 2019 19:02:43 +0000
Subject: [docs] [issue36006] [good first issue] Align version changed for
 truncate in io module
In-Reply-To: <1550254112.89.0.985997369649.issue36006@roundup.psfhosted.org>
Message-ID: <1550257362.98.0.906471970182.issue36006@roundup.psfhosted.org>


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


New changeset 522630a7462f606300f1e6e6818de191d9dc3fdf by Miss Islington (bot) (Emmanuel Arias) in branch 'master':
bpo-36006: Fix versionchanged directive alignment in io module documentation (GH-11881)
https://github.com/python/cpython/commit/522630a7462f606300f1e6e6818de191d9dc3fdf


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

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

From report at bugs.python.org  Fri Feb 15 14:02:54 2019
From: report at bugs.python.org (miss-islington)
Date: Fri, 15 Feb 2019 19:02:54 +0000
Subject: [docs] [issue36006] [good first issue] Align version changed for
 truncate in io module
In-Reply-To: <1550254112.89.0.985997369649.issue36006@roundup.psfhosted.org>
Message-ID: <1550257374.62.0.556312112515.issue36006@roundup.psfhosted.org>


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


----------
pull_requests: +11915

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

From report at bugs.python.org  Fri Feb 15 14:09:40 2019
From: report at bugs.python.org (miss-islington)
Date: Fri, 15 Feb 2019 19:09:40 +0000
Subject: [docs] [issue36006] [good first issue] Align version changed for
 truncate in io module
In-Reply-To: <1550254112.89.0.985997369649.issue36006@roundup.psfhosted.org>
Message-ID: <1550257780.67.0.331045752834.issue36006@roundup.psfhosted.org>


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


New changeset 05f41363d4876a63acd8016cbf56b4f4e809e41f by Miss Islington (bot) in branch '3.7':
bpo-36006: Fix versionchanged directive alignment in io module documentation (GH-11881)
https://github.com/python/cpython/commit/05f41363d4876a63acd8016cbf56b4f4e809e41f


----------

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

From report at bugs.python.org  Fri Feb 15 17:48:04 2019
From: report at bugs.python.org (Anthony Sottile)
Date: Fri, 15 Feb 2019 22:48:04 +0000
Subject: [docs] [issue36007] python3.8 a1 - docs build requires sphinx 1.7
 but uses a 1.8 feature
Message-ID: <1550270884.67.0.140749638005.issue36007@roundup.psfhosted.org>


New submission from Anthony Sottile <asottile at umich.edu>:

doctest `:skipif:` was added in https://github.com/sphinx-doc/sphinx/issues/5273

Used here: https://github.com/python/cpython/blame/36433221f06d649dbd7e13f5fec948be8ffb90af/Doc/library/turtle.rst#L252-L253

Sphinx minimum version configured here: https://github.com/python/cpython/blob/36433221f06d649dbd7e13f5fec948be8ffb90af/Doc/conf.py#L44-L45

Should this be upped to 1.8 or should the :skipif: be removed?  My guess is the former, I'd be happy to contribute a patch

I hit this while packaging 3.8.0a1 for deadsnakes

----------
assignee: docs at python
components: Build, Documentation
messages: 335654
nosy: Anthony Sottile, docs at python
priority: normal
severity: normal
status: open
title: python3.8 a1 - docs build requires sphinx 1.7 but uses a 1.8 feature
versions: Python 3.8

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

From report at bugs.python.org  Fri Feb 15 18:16:57 2019
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 15 Feb 2019 23:16:57 +0000
Subject: [docs] [issue36007] python3.8 a1 - docs build requires sphinx 1.7
 but uses a 1.8 feature
In-Reply-To: <1550270884.67.0.140749638005.issue36007@roundup.psfhosted.org>
Message-ID: <1550272617.33.0.709582144211.issue36007@roundup.psfhosted.org>


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

Let's up the sphinx version. 
Thanks.

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

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

From report at bugs.python.org  Fri Feb 15 18:34:44 2019
From: report at bugs.python.org (Anthony Sottile)
Date: Fri, 15 Feb 2019 23:34:44 +0000
Subject: [docs] [issue36007] python3.8 a1 - docs build requires sphinx 1.7
 but uses a 1.8 feature
In-Reply-To: <1550270884.67.0.140749638005.issue36007@roundup.psfhosted.org>
Message-ID: <1550273684.45.0.417252319031.issue36007@roundup.psfhosted.org>


Change by Anthony Sottile <asottile at umich.edu>:


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

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

From report at bugs.python.org  Fri Feb 15 18:36:05 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Fri, 15 Feb 2019 23:36:05 +0000
Subject: [docs] [issue30449] Improve __slots__ datamodel documentation
In-Reply-To: <1495587707.13.0.0998591622446.issue30449@psf.upfronthosting.co.za>
Message-ID: <1550273765.35.0.997779210283.issue30449@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Fri Feb 15 18:41:18 2019
From: report at bugs.python.org (miss-islington)
Date: Fri, 15 Feb 2019 23:41:18 +0000
Subject: [docs] [issue36007] python3.8 a1 - docs build requires sphinx 1.7
 but uses a 1.8 feature
In-Reply-To: <1550270884.67.0.140749638005.issue36007@roundup.psfhosted.org>
Message-ID: <1550274078.04.0.712802568778.issue36007@roundup.psfhosted.org>


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


New changeset a16ab00c0b8e126ab82e7cb5098af3ea32d315ff by Miss Islington (bot) (Anthony Sottile) in branch 'master':
bpo-36007: Bump minimum sphinx version to 1.8 (GH-11887)
https://github.com/python/cpython/commit/a16ab00c0b8e126ab82e7cb5098af3ea32d315ff


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

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

From report at bugs.python.org  Fri Feb 15 18:41:42 2019
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 15 Feb 2019 23:41:42 +0000
Subject: [docs] [issue36007] python3.8 a1 - docs build requires sphinx 1.7
 but uses a 1.8 feature
In-Reply-To: <1550270884.67.0.140749638005.issue36007@roundup.psfhosted.org>
Message-ID: <1550274102.71.0.866878694921.issue36007@roundup.psfhosted.org>


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

Thanks!

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

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

From report at bugs.python.org  Fri Feb 15 18:51:48 2019
From: report at bugs.python.org (Mariatta Wijaya)
Date: Fri, 15 Feb 2019 23:51:48 +0000
Subject: [docs] [issue36007] python3.8 a1 - docs build requires sphinx 1.7
 but uses a 1.8 feature
In-Reply-To: <1550270884.67.0.140749638005.issue36007@roundup.psfhosted.org>
Message-ID: <1550274708.24.0.510089452448.issue36007@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Fri Feb 15 19:19:38 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Sat, 16 Feb 2019 00:19:38 +0000
Subject: [docs] [issue21018] [patch] added missing documentation about
 escaping characters for configparser
In-Reply-To: <1395464420.76.0.68706986346.issue21018@psf.upfronthosting.co.za>
Message-ID: <1550276378.84.0.401560721927.issue21018@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Fri Feb 15 19:53:55 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Sat, 16 Feb 2019 00:53:55 +0000
Subject: [docs] [issue36008] [good first issue] Update documentation for 3.8
Message-ID: <1550278435.56.0.94881175235.issue36008@roundup.psfhosted.org>


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

Please save this issue for a new contributor.  If you have previously made a pull request to CPython, consider leaving this issue for someone else.  Thanks!

Similar to what PR 9501 did for updating references in the docs from 3.6 to 3.7, an update needs to be done for 3.8.

----------
assignee: docs at python
components: Documentation
keywords: easy
messages: 335663
nosy: cheryl.sabella, docs at python
priority: normal
severity: normal
stage: needs patch
status: open
title: [good first issue] Update documentation for 3.8
type: enhancement
versions: Python 3.8

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

From report at bugs.python.org  Fri Feb 15 21:09:01 2019
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sat, 16 Feb 2019 02:09:01 +0000
Subject: [docs] [issue36008] [good first issue] Update documentation for 3.8
In-Reply-To: <1550278435.56.0.94881175235.issue36008@roundup.psfhosted.org>
Message-ID: <1550282941.46.0.0148307319916.issue36008@roundup.psfhosted.org>


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

Assigning this to me, to be worked on the mentored sprint at PyCon US Cleveland.
Thanks.

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

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

From report at bugs.python.org  Sat Feb 16 01:12:24 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 16 Feb 2019 06:12:24 +0000
Subject: [docs] [issue15248] Better explain "TypeError: 'tuple' object is
 not callable"
In-Reply-To: <1341379722.78.0.0866285571225.issue15248@psf.upfronthosting.co.za>
Message-ID: <1550297544.2.0.509796653197.issue15248@roundup.psfhosted.org>


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


New changeset 62e4481238b82f111ffb1104a4b97099dd83ae2b by Serhiy Storchaka in branch 'master':
bpo-15248: Emit a compiler warning when missed a comma before tuple or list. (GH-11757)
https://github.com/python/cpython/commit/62e4481238b82f111ffb1104a4b97099dd83ae2b


----------

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

From report at bugs.python.org  Sat Feb 16 01:13:36 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 16 Feb 2019 06:13:36 +0000
Subject: [docs] [issue15248] Better explain "TypeError: 'tuple' object is
 not callable"
In-Reply-To: <1341379722.78.0.0866285571225.issue15248@psf.upfronthosting.co.za>
Message-ID: <1550297616.39.0.159292228994.issue15248@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/issue15248>
_______________________________________

From report at bugs.python.org  Sat Feb 16 08:31:38 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Sat, 16 Feb 2019 13:31:38 +0000
Subject: [docs] [issue36008] [good first issue] Update documentation for 3.8
In-Reply-To: <1550278435.56.0.94881175235.issue36008@roundup.psfhosted.org>
Message-ID: <1550323898.41.0.0922114085266.issue36008@roundup.psfhosted.org>


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

Awesome!  Thanks. If I find anything else, I'll flag it accordingly.

----------

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

From report at bugs.python.org  Sat Feb 16 13:01:40 2019
From: report at bugs.python.org (Nick Coghlan)
Date: Sat, 16 Feb 2019 18:01:40 +0000
Subject: [docs] [issue35962] Slight error in words in [ 2.4.1. String and
 Bytes literals ]
In-Reply-To: <1549879959.7.0.265215879488.issue35962@roundup.psfhosted.org>
Message-ID: <1550340100.65.0.788295884263.issue35962@roundup.psfhosted.org>


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

I agree the current text is ambiguous given how often folks refer to the newline escape sequence as a "newline", but it isn't wrong - it's just talking about escaping literal newlines in your source code like:

>>> "This is a \
... single-line string"
'This is a single-line string'

When this paragraph is being updated, it would be good to add a cross-reference down to the table of escape sequences later in the section.

----------

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

From report at bugs.python.org  Sat Feb 16 18:10:22 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Sat, 16 Feb 2019 23:10:22 +0000
Subject: [docs] [issue31869] commentary on ssl.PROTOCOL_TLS
In-Reply-To: <1508947295.4.0.213398074469.issue31869@psf.upfronthosting.co.za>
Message-ID: <1550358622.83.0.750165517299.issue31869@roundup.psfhosted.org>


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

Mariatta,

This might be another good issue for the mentored sprint, although it's applying a change to the 2.7 branch, so maybe it just needs Miss Islington?

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

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

From report at bugs.python.org  Sat Feb 16 18:34:53 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Sat, 16 Feb 2019 23:34:53 +0000
Subject: [docs] [issue28235] In xml.etree.ElementTree docs there is no
 parser argument in fromstring()
In-Reply-To: <1474457056.95.0.329737294315.issue28235@psf.upfronthosting.co.za>
Message-ID: <1550360093.5.0.475630654899.issue28235@roundup.psfhosted.org>


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

@py.user, would you be able to convert your patch to a Github pull request?  Thanks!

----------
nosy: +cheryl.sabella
type: behavior -> enhancement
versions: +Python 3.8 -Python 3.5, Python 3.6

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

From report at bugs.python.org  Sat Feb 16 19:19:03 2019
From: report at bugs.python.org (Mariatta Wijaya)
Date: Sun, 17 Feb 2019 00:19:03 +0000
Subject: [docs] [issue31869] commentary on ssl.PROTOCOL_TLS
In-Reply-To: <1508947295.4.0.213398074469.issue31869@psf.upfronthosting.co.za>
Message-ID: <1550362743.55.0.689290472304.issue31869@roundup.psfhosted.org>


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

Thanks. Yep this is good for the mentored sprint.

----------

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

From report at bugs.python.org  Sat Feb 16 21:07:58 2019
From: report at bugs.python.org (Manjusaka)
Date: Sun, 17 Feb 2019 02:07:58 +0000
Subject: [docs] [issue28235] In xml.etree.ElementTree docs there is no
 parser argument in fromstring()
In-Reply-To: <1474457056.95.0.329737294315.issue28235@psf.upfronthosting.co.za>
Message-ID: <1550369278.56.0.144035512542.issue28235@roundup.psfhosted.org>


Change by Manjusaka <lizheao940510 at gmail.com>:


----------
pull_requests: +11929

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

From report at bugs.python.org  Sat Feb 16 21:12:00 2019
From: report at bugs.python.org (Manjusaka)
Date: Sun, 17 Feb 2019 02:12:00 +0000
Subject: [docs] [issue28235] In xml.etree.ElementTree docs there is no
 parser argument in fromstring()
In-Reply-To: <1474457056.95.0.329737294315.issue28235@psf.upfronthosting.co.za>
Message-ID: <1550369520.77.0.371094058454.issue28235@roundup.psfhosted.org>


Manjusaka <lizheao940510 at gmail.com> added the comment:

I have already make a pull request on GitHub

----------
nosy: +Manjusaka

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

From farshid.mi at gmail.com  Sat Feb 16 13:55:23 2019
From: farshid.mi at gmail.com (Farshid Meidani)
Date: Sat, 16 Feb 2019 22:25:23 +0330
Subject: [docs] turtle document bug- screenmode
Message-ID: <CAE-Cd-70rfsk1Hy=9pHHFjCZ_tNFrRvtJyRf47xXnjq6KkmvUA@mail.gmail.com>

Hi

I think that there is a bug in this document:
https://docs.python.org/3/library/turtle.html#turtle.colormode

The *colormode *is a turtle method not a screen method. so  "screen.
colormode() " should be "turtle.colormode()". And all "screen" should be
change to "turtle".

To be more clear I attached a picture.

[image: image.png]


Regards
Farshid
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190216/f0fd544b/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image.png
Type: image/png
Size: 31473 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20190216/f0fd544b/attachment-0001.png>

From report at bugs.python.org  Sun Feb 17 18:13:55 2019
From: report at bugs.python.org (Ivan Levkivskyi)
Date: Sun, 17 Feb 2019 23:13:55 +0000
Subject: [docs] [issue35992] Metaclasses interfere with __class_getitem__
In-Reply-To: <1550124852.78.0.300044847884.issue35992@roundup.psfhosted.org>
Message-ID: <1550445235.19.0.0826588080454.issue35992@roundup.psfhosted.org>


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


New changeset ac28147e78c45a6217d348ce90ca5281d91f676f by Ivan Levkivskyi in branch 'master':
bpo-35992: Use PySequence_GetItem only if sq_item is not NULL (GH-11857)
https://github.com/python/cpython/commit/ac28147e78c45a6217d348ce90ca5281d91f676f


----------

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

From report at bugs.python.org  Sun Feb 17 18:14:07 2019
From: report at bugs.python.org (miss-islington)
Date: Sun, 17 Feb 2019 23:14:07 +0000
Subject: [docs] [issue35992] Metaclasses interfere with __class_getitem__
In-Reply-To: <1550124852.78.0.300044847884.issue35992@roundup.psfhosted.org>
Message-ID: <1550445247.21.0.38039693798.issue35992@roundup.psfhosted.org>


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


----------
pull_requests: +11936

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

From report at bugs.python.org  Sun Feb 17 18:33:09 2019
From: report at bugs.python.org (miss-islington)
Date: Sun, 17 Feb 2019 23:33:09 +0000
Subject: [docs] [issue35992] Metaclasses interfere with __class_getitem__
In-Reply-To: <1550124852.78.0.300044847884.issue35992@roundup.psfhosted.org>
Message-ID: <1550446389.03.0.309194342658.issue35992@roundup.psfhosted.org>


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


New changeset a7f929db605326da452fbdeebfe341afa9316d25 by Miss Islington (bot) in branch '3.7':
bpo-35992: Use PySequence_GetItem only if sq_item is not NULL (GH-11857)
https://github.com/python/cpython/commit/a7f929db605326da452fbdeebfe341afa9316d25


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

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

From report at bugs.python.org  Sun Feb 17 18:35:10 2019
From: report at bugs.python.org (Ivan Levkivskyi)
Date: Sun, 17 Feb 2019 23:35:10 +0000
Subject: [docs] [issue35992] Metaclasses interfere with __class_getitem__
In-Reply-To: <1550124852.78.0.300044847884.issue35992@roundup.psfhosted.org>
Message-ID: <1550446510.53.0.00800173658209.issue35992@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Mon Feb 18 02:21:17 2019
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Mon, 18 Feb 2019 07:21:17 +0000
Subject: [docs] [issue34817] Ellipsis docs has extra dot in the markdown
 that makes it look like .... (four dots)
In-Reply-To: <1538032499.31.0.545547206417.issue34817@psf.upfronthosting.co.za>
Message-ID: <1550474477.4.0.594395739641.issue34817@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Mon Feb 18 02:41:37 2019
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Mon, 18 Feb 2019 07:41:37 +0000
Subject: [docs] [issue35126] Mistake in FAQ about converting number to
 string.
In-Reply-To: <1541005659.07.0.788709270274.issue35126@psf.upfronthosting.co.za>
Message-ID: <1550475697.72.0.78049399273.issue35126@roundup.psfhosted.org>


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

This is a good first issue. Python 3 docs uses `{:.3f}".format(1.0/3.0)` that was changed as part of 04d8a245f162b33e6c861ba0869918d9262be63e. Python 2 docs could be changed too to use floats that makes the example correct.

----------
nosy: +Mariatta, cheryl.sabella

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

From report at bugs.python.org  Mon Feb 18 03:29:05 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Mon, 18 Feb 2019 08:29:05 +0000
Subject: [docs] [issue35126] Mistake in FAQ about converting number to
 string.
In-Reply-To: <1541005659.07.0.788709270274.issue35126@psf.upfronthosting.co.za>
Message-ID: <1550478545.32.0.286425400443.issue35126@roundup.psfhosted.org>


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

I am working on this issue.

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

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

From report at bugs.python.org  Mon Feb 18 04:17:17 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Mon, 18 Feb 2019 09:17:17 +0000
Subject: [docs] [issue35126] Mistake in FAQ about converting number to
 string.
In-Reply-To: <1541005659.07.0.788709270274.issue35126@psf.upfronthosting.co.za>
Message-ID: <1550481437.08.0.395821468923.issue35126@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Mon Feb 18 04:18:45 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Mon, 18 Feb 2019 09:18:45 +0000
Subject: [docs] [issue35126] Mistake in FAQ about converting number to
 string.
In-Reply-To: <1541005659.07.0.788709270274.issue35126@psf.upfronthosting.co.za>
Message-ID: <1550481525.89.0.186999413217.issue35126@roundup.psfhosted.org>


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

Hi @xtreak,

I have just submitted a PR but where I explain the change with Python2/3 and the division operator.

Have a nice day,

----------

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

From report at bugs.python.org  Mon Feb 18 10:17:11 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 18 Feb 2019 15:17:11 +0000
Subject: [docs] [issue28450] Misleading/inaccurate documentation about
 unknown escape sequences in regular expressions
In-Reply-To: <1476529213.17.0.132534478532.issue28450@psf.upfronthosting.co.za>
Message-ID: <1550503031.58.0.89661390265.issue28450@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Mon Feb 18 16:58:27 2019
From: report at bugs.python.org (abcdef)
Date: Mon, 18 Feb 2019 21:58:27 +0000
Subject: [docs] [issue34203] documentation: recommend Python 3 over 2 in faq
In-Reply-To: <1532397328.96.0.56676864532.issue34203@psf.upfronthosting.co.za>
Message-ID: <1550527107.48.0.24190468274.issue34203@roundup.psfhosted.org>


abcdef <x at mailinator.com> added the comment:

Thank you. I understand this is fixed now and I'm marking the ticket as closed.

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

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

From report at bugs.python.org  Tue Feb 19 01:32:50 2019
From: report at bugs.python.org (Carol Willing)
Date: Tue, 19 Feb 2019 06:32:50 +0000
Subject: [docs] [issue35957] Indentation explanation is unclear
In-Reply-To: <1549819617.52.0.344509790006.issue35957@roundup.psfhosted.org>
Message-ID: <1550557970.23.0.478801538306.issue35957@roundup.psfhosted.org>


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

Assigning this to @Mariatta, to be worked on the mentored sprint at PyCon US Cleveland. Verify behavior and update documentation.

----------
assignee: docs at python -> Mariatta
nosy: +Mariatta, willingc

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

From report at bugs.python.org  Tue Feb 19 03:12:20 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Tue, 19 Feb 2019 08:12:20 +0000
Subject: [docs] [issue35126] Mistake in FAQ about converting number to
 string.
In-Reply-To: <1541005659.07.0.788709270274.issue35126@psf.upfronthosting.co.za>
Message-ID: <1550563940.13.0.861034162082.issue35126@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Tue Feb 19 03:45:34 2019
From: report at bugs.python.org (Amit Amely)
Date: Tue, 19 Feb 2019 08:45:34 +0000
Subject: [docs] [issue36032] Wrong output in tutorial (3.1.2. Strings)
Message-ID: <1550565934.5.0.314572203435.issue36032@roundup.psfhosted.org>


New submission from Amit Amely <amit.amely at gmail.com>:

This is the tutorial text:

>>> prefix = 'Py'
>>> prefix 'thon'  # can't concatenate a variable and a string literal
  ...
SyntaxError: invalid syntax
>>> ('un' * 3) 'ium'
  ...
SyntaxError: invalid syntax

This is the actual result:

>>> prefix = 'Py'
>>> prefix 'thon'  # can't concatenate a variable and a string literal
  File "<stdin>", line 1
    prefix 'thon'  # can't concatenate a variable and a string literal
                ^
SyntaxError: invalid syntax

----------
assignee: docs at python
components: Documentation
messages: 335905
nosy: Amit Amely, docs at python
priority: normal
severity: normal
status: open
title: Wrong output in tutorial (3.1.2. Strings)
versions: Python 2.7

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

From report at bugs.python.org  Tue Feb 19 03:58:28 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 19 Feb 2019 08:58:28 +0000
Subject: [docs] [issue36032] Wrong output in tutorial (3.1.2. Strings)
In-Reply-To: <1550565934.5.0.314572203435.issue36032@roundup.psfhosted.org>
Message-ID: <1550566708.0.0.887735084388.issue36032@roundup.psfhosted.org>


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

The output in tutorial is correct. "..." means omitted output (we don't want to clutter examples with insignificant details).

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

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

From report at bugs.python.org  Tue Feb 19 04:26:06 2019
From: report at bugs.python.org (miss-islington)
Date: Tue, 19 Feb 2019 09:26:06 +0000
Subject: [docs] [issue35126] Mistake in FAQ about converting number to
 string.
In-Reply-To: <1541005659.07.0.788709270274.issue35126@psf.upfronthosting.co.za>
Message-ID: <1550568366.13.0.869230237098.issue35126@roundup.psfhosted.org>


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


New changeset c611db4942a07c81f54e6584615bbddc51034a77 by Miss Islington (bot) (St?phane Wirtel) in branch '2.7':
[2.7] bpo-35126: Fix a mistake in FAQ about converting number to string (GH-11911)
https://github.com/python/cpython/commit/c611db4942a07c81f54e6584615bbddc51034a77


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

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

From report at bugs.python.org  Tue Feb 19 04:27:54 2019
From: report at bugs.python.org (Amit Amely)
Date: Tue, 19 Feb 2019 09:27:54 +0000
Subject: [docs] [issue36032] Wrong output in tutorial (3.1.2. Strings)
In-Reply-To: <1550566708.0.0.887735084388.issue36032@roundup.psfhosted.org>
Message-ID: <CAFO8=PhqtwPEd9BVtWty1HdVAfaGDOV6ML=fbW8feG3-AAj_Gg@mail.gmail.com>


Amit Amely <amit.amely at gmail.com> added the comment:

But it also contains an error message part which has nothing to do with
this example (marked in dark green)

This only works with two literals though, not with variables or expressions:

>>> prefix = 'Py'>>> prefix 'thon'  # can't concatenate a variable and a string literal  ...SyntaxError: invalid syntax>>> ('un' * 3) 'ium'  ...SyntaxError: invalid syntax

If you want to concatenate variables or a variable and a literal, use +:

On Tue, Feb 19, 2019 at 10:58 AM Serhiy Storchaka <report at bugs.python.org>
wrote:

>
> Serhiy Storchaka <storchaka+cpython at gmail.com> added the comment:
>
> The output in tutorial is correct. "..." means omitted output (we don't
> want to clutter examples with insignificant details).
>
> ----------
> nosy: +serhiy.storchaka
> resolution:  -> not a bug
> stage:  -> resolved
> status: open -> closed
>
> _______________________________________
> Python tracker <report at bugs.python.org>
> <https://bugs.python.org/issue36032>
> _______________________________________
>

----------

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

From report at bugs.python.org  Tue Feb 19 04:41:24 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Tue, 19 Feb 2019 09:41:24 +0000
Subject: [docs] [issue36032] Wrong output in tutorial (3.1.2. Strings)
In-Reply-To: <1550565934.5.0.314572203435.issue36032@roundup.psfhosted.org>
Message-ID: <1550569284.95.0.0622690069698.issue36032@roundup.psfhosted.org>


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

@serhiy

I think Amit wants to say there is no triple point in these examples of the tutorial.

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

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

From report at bugs.python.org  Tue Feb 19 04:42:54 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Tue, 19 Feb 2019 09:42:54 +0000
Subject: [docs] [issue36032] Wrong output in tutorial (3.1.2. Strings)
In-Reply-To: <1550565934.5.0.314572203435.issue36032@roundup.psfhosted.org>
Message-ID: <1550569374.79.0.338048993514.issue36032@roundup.psfhosted.org>


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

and when you execute the examples, the REPL does not generate the triple points.

For me, the examples of the tuto are correct and we don't need to add '...' in the examples.

----------

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

From report at bugs.python.org  Tue Feb 19 06:08:26 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 19 Feb 2019 11:08:26 +0000
Subject: [docs] [issue15248] Better explain "TypeError: 'tuple' object is
 not callable"
In-Reply-To: <1341379722.78.0.0866285571225.issue15248@psf.upfronthosting.co.za>
Message-ID: <1550574506.2.0.275094877519.issue15248@roundup.psfhosted.org>


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


----------
pull_requests: +11957

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

From report at bugs.python.org  Tue Feb 19 06:47:35 2019
From: report at bugs.python.org (INADA Naoki)
Date: Tue, 19 Feb 2019 11:47:35 +0000
Subject: [docs] [issue36032] Wrong output in tutorial (3.1.2. Strings)
In-Reply-To: <1550565934.5.0.314572203435.issue36032@roundup.psfhosted.org>
Message-ID: <1550576855.88.0.561666134817.issue36032@roundup.psfhosted.org>


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

@Amit Please confirm docs.python.org before submitting issue.
#33460 fixed it already.

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

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

From report at bugs.python.org  Tue Feb 19 06:48:46 2019
From: report at bugs.python.org (INADA Naoki)
Date: Tue, 19 Feb 2019 11:48:46 +0000
Subject: [docs] [issue36032] Wrong output in tutorial (3.1.2. Strings)
In-Reply-To: <1550565934.5.0.314572203435.issue36032@roundup.psfhosted.org>
Message-ID: <1550576926.04.0.40356654618.issue36032@roundup.psfhosted.org>


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

Uh!  You meant Python 2.7!!
It doesn't make sense to improve Python 2.7 tutorial.
If you're reading Python 2 tutorial, please read 3.7 tutorial instead!!!

----------

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

From report at bugs.python.org  Tue Feb 19 06:49:13 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 19 Feb 2019 11:49:13 +0000
Subject: [docs] [issue15248] Better explain "TypeError: 'tuple' object is
 not callable"
In-Reply-To: <1341379722.78.0.0866285571225.issue15248@psf.upfronthosting.co.za>
Message-ID: <1550576953.34.0.914918415257.issue15248@roundup.psfhosted.org>


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


New changeset 8e79e6e56f516385ccb761e407dfff3a39253180 by Serhiy Storchaka in branch 'master':
Fix syntax warnings in tests introduced in bpo-15248. (GH-11932)
https://github.com/python/cpython/commit/8e79e6e56f516385ccb761e407dfff3a39253180


----------

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

From report at bugs.python.org  Tue Feb 19 06:49:21 2019
From: report at bugs.python.org (miss-islington)
Date: Tue, 19 Feb 2019 11:49:21 +0000
Subject: [docs] [issue15248] Better explain "TypeError: 'tuple' object is
 not callable"
In-Reply-To: <1341379722.78.0.0866285571225.issue15248@psf.upfronthosting.co.za>
Message-ID: <1550576961.69.0.0969676502601.issue15248@roundup.psfhosted.org>


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


----------
pull_requests: +11959

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

From report at bugs.python.org  Tue Feb 19 06:50:30 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 19 Feb 2019 11:50:30 +0000
Subject: [docs] [issue15248] Better explain "TypeError: 'tuple' object is
 not callable"
In-Reply-To: <1341379722.78.0.0866285571225.issue15248@psf.upfronthosting.co.za>
Message-ID: <1550577030.73.0.350064252723.issue15248@roundup.psfhosted.org>


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


----------
pull_requests: +11960

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

From report at bugs.python.org  Tue Feb 19 09:41:06 2019
From: report at bugs.python.org (Louis Michael)
Date: Tue, 19 Feb 2019 14:41:06 +0000
Subject: [docs] [issue36038] ^ used in inaccurate example in regex-howto
Message-ID: <1550587266.8.0.644762310509.issue36038@roundup.psfhosted.org>


New submission from Louis Michael <louism at vt.edu>:

at https://docs.python.org/3/howto/regex.html#regex-howto
and
https://docs.python.org/3.8/howto/regex.html#regex-howto
https://docs.python.org/3.7/howto/regex.html#regex-howto
https://docs.python.org/3.6/howto/regex.html#regex-howto
https://docs.python.org/3.5/howto/regex.html#regex-howto
https://docs.python.org/3.4/howto/regex.html#regex-howto
https://docs.python.org/2.7/howto/regex.html#regex-howto

The following paragraph seems to have a small issue:
"
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'.
"
^ does not simply match ^ outside a character class since is a special character that represents the start of the string. 

I think the paragraph should read: 
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; '^' will act differently outside a character class as explained later. For example, [^5] will match any character except '5'.

----------
assignee: docs at python
components: Documentation
messages: 335953
nosy: docs at python, eric.araujo, ezio.melotti, louism, mdk, willingc
priority: normal
severity: normal
status: open
title: ^ used in inaccurate example in regex-howto
type: enhancement
versions: Python 2.7, Python 3.4, Python 3.5, Python 3.6, Python 3.7, Python 3.8

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

From report at bugs.python.org  Tue Feb 19 09:47:59 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Tue, 19 Feb 2019 14:47:59 +0000
Subject: [docs] [issue35126] Mistake in FAQ about converting number to
 string.
In-Reply-To: <1541005659.07.0.788709270274.issue35126@psf.upfronthosting.co.za>
Message-ID: <1550587679.34.0.912821975576.issue35126@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Tue Feb 19 11:35:21 2019
From: report at bugs.python.org (Julien Palard)
Date: Tue, 19 Feb 2019 16:35:21 +0000
Subject: [docs] [issue36038] ^ used in inaccurate example in regex-howto
In-Reply-To: <1550587266.8.0.644762310509.issue36038@roundup.psfhosted.org>
Message-ID: <1550594121.67.0.564320949914.issue36038@roundup.psfhosted.org>


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

Hi, thanks for reporting!

It's a duplicate of https://bugs.python.org/issue35584, so I'm closing it, but if you feed like opening a PR on it, it would be appreciated.

Bests.

----------
resolution:  -> duplicate
stage:  -> resolved
status: open -> closed
superseder:  -> Wrong statement about ^ in howto/regex.rst

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

From report at bugs.python.org  Tue Feb 19 11:35:47 2019
From: report at bugs.python.org (Julien Palard)
Date: Tue, 19 Feb 2019 16:35:47 +0000
Subject: [docs] [issue35584] Wrong statement about ^ in howto/regex.rst
In-Reply-To: <1545775848.12.0.712150888896.issue35584@roundup.psfhosted.org>
Message-ID: <1550594147.41.0.910554563015.issue35584@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Tue Feb 19 13:02:45 2019
From: report at bugs.python.org (Denton Liu)
Date: Tue, 19 Feb 2019 18:02:45 +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: <1550599365.93.0.878666659161.issue35155@roundup.psfhosted.org>


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

If there aren't anymore comments, I think this PR is ready for a second round of reviews.

Thanks!

----------

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

From report at bugs.python.org  Tue Feb 19 13:16:41 2019
From: report at bugs.python.org (Raymond Hettinger)
Date: Tue, 19 Feb 2019 18:16:41 +0000
Subject: [docs] [issue35584] Wrong statement about ^ in howto/regex.rst
In-Reply-To: <1545775848.12.0.712150888896.issue35584@roundup.psfhosted.org>
Message-ID: <1550600201.53.0.724779263707.issue35584@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Tue Feb 19 13:32:41 2019
From: report at bugs.python.org (Louis Michael)
Date: Tue, 19 Feb 2019 18:32:41 +0000
Subject: [docs] [issue35584] Wrong statement about ^ in howto/regex.rst
In-Reply-To: <1545775848.12.0.712150888896.issue35584@roundup.psfhosted.org>
Message-ID: <1550601161.22.0.0925170283067.issue35584@roundup.psfhosted.org>


Change by Louis Michael <louism at vt.edu>:


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

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

From report at bugs.python.org  Tue Feb 19 14:26:43 2019
From: report at bugs.python.org (Raymond Hettinger)
Date: Tue, 19 Feb 2019 19:26:43 +0000
Subject: [docs] [issue35584] Wrong statement about ^ in howto/regex.rst
In-Reply-To: <1545775848.12.0.712150888896.issue35584@roundup.psfhosted.org>
Message-ID: <1550604403.47.0.93962930443.issue35584@roundup.psfhosted.org>


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


----------
pull_requests: +11970

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

From report at bugs.python.org  Tue Feb 19 14:32:21 2019
From: report at bugs.python.org (miss-islington)
Date: Tue, 19 Feb 2019 19:32:21 +0000
Subject: [docs] [issue35584] Wrong statement about ^ in howto/regex.rst
In-Reply-To: <1545775848.12.0.712150888896.issue35584@roundup.psfhosted.org>
Message-ID: <1550604741.78.0.347572197788.issue35584@roundup.psfhosted.org>


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


New changeset 3bacf6126522a9b3bcb6be0c4f3ee6a895dfe772 by Miss Islington (bot) (Raymond Hettinger) in branch 'master':
bpo-35584: Clarify role of caret in a class class (GH-11946)
https://github.com/python/cpython/commit/3bacf6126522a9b3bcb6be0c4f3ee6a895dfe772


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

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

From report at bugs.python.org  Tue Feb 19 14:32:30 2019
From: report at bugs.python.org (miss-islington)
Date: Tue, 19 Feb 2019 19:32:30 +0000
Subject: [docs] [issue35584] Wrong statement about ^ in howto/regex.rst
In-Reply-To: <1545775848.12.0.712150888896.issue35584@roundup.psfhosted.org>
Message-ID: <1550604750.45.0.352828852009.issue35584@roundup.psfhosted.org>


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


----------
pull_requests: +11971

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

From report at bugs.python.org  Tue Feb 19 14:32:43 2019
From: report at bugs.python.org (miss-islington)
Date: Tue, 19 Feb 2019 19:32:43 +0000
Subject: [docs] [issue35584] Wrong statement about ^ in howto/regex.rst
In-Reply-To: <1545775848.12.0.712150888896.issue35584@roundup.psfhosted.org>
Message-ID: <1550604763.65.0.511253978274.issue35584@roundup.psfhosted.org>


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


----------
pull_requests: +11972

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

From report at bugs.python.org  Tue Feb 19 15:25:56 2019
From: report at bugs.python.org (Raymond Hettinger)
Date: Tue, 19 Feb 2019 20:25:56 +0000
Subject: [docs] [issue35584] Wrong statement about ^ in howto/regex.rst
In-Reply-To: <1545775848.12.0.712150888896.issue35584@roundup.psfhosted.org>
Message-ID: <1550607956.8.0.970389468842.issue35584@roundup.psfhosted.org>


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


New changeset bb9ddee3d4e293f0717f8c167afdf5749ebf843d by Raymond Hettinger (Miss Islington (bot)) in branch '3.7':
bpo-35584: Clarify role of caret in a class class (GH-11946) (GH-11947)
https://github.com/python/cpython/commit/bb9ddee3d4e293f0717f8c167afdf5749ebf843d


----------

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

From report at bugs.python.org  Tue Feb 19 15:26:13 2019
From: report at bugs.python.org (Raymond Hettinger)
Date: Tue, 19 Feb 2019 20:26:13 +0000
Subject: [docs] [issue35584] Wrong statement about ^ in howto/regex.rst
In-Reply-To: <1545775848.12.0.712150888896.issue35584@roundup.psfhosted.org>
Message-ID: <1550607973.51.0.994651453001.issue35584@roundup.psfhosted.org>


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


New changeset 6ee41793d2204c54bdf8f477ae61d016a7eca932 by Raymond Hettinger (Miss Islington (bot)) in branch '2.7':
bpo-35584: Clarify role of caret in a class class (GH-11946) (GH-11948)
https://github.com/python/cpython/commit/6ee41793d2204c54bdf8f477ae61d016a7eca932


----------

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

From report at bugs.python.org  Tue Feb 19 15:26:45 2019
From: report at bugs.python.org (Raymond Hettinger)
Date: Tue, 19 Feb 2019 20:26:45 +0000
Subject: [docs] [issue35584] Wrong statement about ^ in howto/regex.rst
In-Reply-To: <1545775848.12.0.712150888896.issue35584@roundup.psfhosted.org>
Message-ID: <1550608005.45.0.362864189588.issue35584@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Wed Feb 20 01:56:34 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 20 Feb 2019 06:56:34 +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: <1550645794.05.0.184304206952.issue33039@roundup.psfhosted.org>


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

See also issue33039.

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

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

From report at bugs.python.org  Wed Feb 20 01:57:13 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 20 Feb 2019 06:57:13 +0000
Subject: [docs] [issue17576] PyNumber_Index() is not int-subclass friendly
 (or operator.index() docos lie)
In-Reply-To: <1364595911.19.0.826873230127.issue17576@psf.upfronthosting.co.za>
Message-ID: <1550645833.19.0.91577596984.issue17576@roundup.psfhosted.org>


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

See also issue33039.

----------

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

From report at bugs.python.org  Wed Feb 20 09:32:02 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Wed, 20 Feb 2019 14:32:02 +0000
Subject: [docs] [issue34464] There are inconsitencies in the treatment of
 True, False, None, and __debug__ keywords in the docs
In-Reply-To: <1534964930.72.0.56676864532.issue34464@psf.upfronthosting.co.za>
Message-ID: <1550673122.12.0.654538692006.issue34464@roundup.psfhosted.org>


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

Hi @David,

Maybe we could remove 3.6 from the list because 3.6 is in security mode and not bugfix.

Is there a security issue with this bug?

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

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

From report at bugs.python.org  Wed Feb 20 10:18:59 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 20 Feb 2019 15:18:59 +0000
Subject: [docs] [issue34464] There are inconsitencies in the treatment of
 True, False, None, and __debug__ keywords in the docs
In-Reply-To: <1534964930.72.0.56676864532.issue34464@psf.upfronthosting.co.za>
Message-ID: <1550675938.99.0.0120479234941.issue34464@roundup.psfhosted.org>


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

__debug__ is not a keyword. And the error message has been changed in 3.8.

But it is a special enough. You can not use this name in any assignment context:

>>> __debug__ = 1
  File "<stdin>", line 1
SyntaxError: cannot assign to __debug__
>>> for __debug__ in []: pass
... 
  File "<stdin>", line 1
SyntaxError: cannot assign to __debug__
>>> with cm() as __debug__: pass
... 
  File "<stdin>", line 1
SyntaxError: cannot assign to __debug__
>>> class __debug__: pass
... 
  File "<stdin>", line 1
SyntaxError: cannot assign to __debug__
>>> def __debug__(): pass
... 
  File "<stdin>", line 1
SyntaxError: cannot assign to __debug__
>>> def foo(__debug__): pass
... 
  File "<stdin>", line 1
SyntaxError: cannot assign to __debug__
>>> import __debug__
  File "<stdin>", line 1
SyntaxError: cannot assign to __debug__

You can not even assign to an attribute named __debug__!

>>> x.__debug__ = 1
  File "<stdin>", line 1
SyntaxError: cannot assign to __debug__

The assignment operator is the only exception here, and this looks like a bug.

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

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

From report at bugs.python.org  Wed Feb 20 10:24:05 2019
From: report at bugs.python.org (Pierre Glaser)
Date: Wed, 20 Feb 2019 15:24:05 +0000
Subject: [docs] [issue35933] python doc does not say that the state kwarg in
 Pickler.save_reduce can be a tuple (and not only a dict)
In-Reply-To: <1549562122.06.0.315178283617.issue35933@roundup.psfhosted.org>
Message-ID: <1550676245.73.0.99957137126.issue35933@roundup.psfhosted.org>


Change by Pierre Glaser <pierreglaser at msn.com>:


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

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

From report at bugs.python.org  Wed Feb 20 10:31:31 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 20 Feb 2019 15:31:31 +0000
Subject: [docs] [issue35933] python doc does not say that the state kwarg in
 Pickler.save_reduce can be a tuple (and not only a dict)
In-Reply-To: <1549562122.06.0.315178283617.issue35933@roundup.psfhosted.org>
Message-ID: <1550676691.85.0.839457025477.issue35933@roundup.psfhosted.org>


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

A slotted class will have a dict also when it inherits it from a non-slotted class. This is why the base class of slotted class should have slots if you do not want an instance dict.

__getstate__ and __setstate__ for slotted classes are described in PEP 307. Unfortunately this was not copied to the module documentation.

----------

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

From report at bugs.python.org  Wed Feb 20 10:41:42 2019
From: report at bugs.python.org (Pierre Glaser)
Date: Wed, 20 Feb 2019 15:41:42 +0000
Subject: [docs] [issue35933] python doc does not say that the state kwarg in
 Pickler.save_reduce can be a tuple (and not only a dict)
In-Reply-To: <1549562122.06.0.315178283617.issue35933@roundup.psfhosted.org>
Message-ID: <1550677302.32.0.102296500976.issue35933@roundup.psfhosted.org>


Pierre Glaser <pierreglaser at msn.com> added the comment:

I added a PR with a small patch to document this behavior and reconcile _pickle.c and pickle.py

Some explanations on why I am pushing this forward:
 
Pickling instances of classes/subclasses with slots is done natively for pickle protocol >= 2. Mentioning this behavior in the docs should *not* make the user worry about implementing custom __getstate__ methods just to preserve slots.

Here is the reason why I think this functionality (allowing state and slotstate) is worth documenting: pickle gives us a lot of flexibility for reducing thanks to the dispatch_table. But unpickling is rather rigid: if no __setstate__ exists, we have to deal with the default state updating procedure present in load_build. Might as well document all of it ;)

----------

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

From report at bugs.python.org  Wed Feb 20 10:46:30 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 20 Feb 2019 15:46:30 +0000
Subject: [docs] [issue35933] python doc does not say that the state kwarg in
 Pickler.save_reduce can be a tuple (and not only a dict)
In-Reply-To: <1549562122.06.0.315178283617.issue35933@roundup.psfhosted.org>
Message-ID: <1550677590.84.0.148148392799.issue35933@roundup.psfhosted.org>


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

See also issue26579 which propose to add a function or method for standard implementation of __getstate__ and use it consistently in custom __getstate__ implementations. I am not sure about API yet.

----------

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

From report at bugs.python.org  Wed Feb 20 11:59:10 2019
From: report at bugs.python.org (Raymond Hettinger)
Date: Wed, 20 Feb 2019 16:59:10 +0000
Subject: [docs] [issue35956] Sort documentation could be improved for
 complex sorting
In-Reply-To: <1549816419.03.0.97544553945.issue35956@roundup.psfhosted.org>
Message-ID: <1550681950.38.0.430315235603.issue35956@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Wed Feb 20 12:30:00 2019
From: report at bugs.python.org (R. David Murray)
Date: Wed, 20 Feb 2019 17:30:00 +0000
Subject: [docs] [issue34464] There are inconsitencies in the treatment of
 True, False, None, and __debug__ keywords in the docs
In-Reply-To: <1534964930.72.0.56676864532.issue34464@psf.upfronthosting.co.za>
Message-ID: <1550683800.45.0.53731748507.issue34464@roundup.psfhosted.org>


Change by R. David Murray <rdmurray at bitdance.com>:


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

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

From report at bugs.python.org  Wed Feb 20 16:42:18 2019
From: report at bugs.python.org (Raymond Hettinger)
Date: Wed, 20 Feb 2019 21:42:18 +0000
Subject: [docs] =?utf-8?b?W2lzc3VlMzE5ODJdIDguMy4gY29sbGVjdGlvbnMg4oCU?=
 =?utf-8?q?_Container_datatypes?=
In-Reply-To: <1510157451.94.0.213398074469.issue31982@psf.upfronthosting.co.za>
Message-ID: <1550698938.93.0.609083265281.issue31982@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Wed Feb 20 16:49:26 2019
From: report at bugs.python.org (miss-islington)
Date: Wed, 20 Feb 2019 21:49:26 +0000
Subject: [docs] =?utf-8?b?W2lzc3VlMzE5ODJdIDguMy4gY29sbGVjdGlvbnMg4oCU?=
 =?utf-8?q?_Container_datatypes?=
In-Reply-To: <1510157451.94.0.213398074469.issue31982@psf.upfronthosting.co.za>
Message-ID: <1550699366.65.0.0181331978111.issue31982@roundup.psfhosted.org>


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


New changeset 9b0c681e2d7e708a07e34d9c08e4424bdd4f5ebc by Miss Islington (bot) (Raymond Hettinger) in branch 'master':
bpo-31982: Improve sequence of presentation in ChainMap docs (GH-11960)
https://github.com/python/cpython/commit/9b0c681e2d7e708a07e34d9c08e4424bdd4f5ebc


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

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

From report at bugs.python.org  Wed Feb 20 16:49:59 2019
From: report at bugs.python.org (miss-islington)
Date: Wed, 20 Feb 2019 21:49:59 +0000
Subject: [docs] =?utf-8?b?W2lzc3VlMzE5ODJdIDguMy4gY29sbGVjdGlvbnMg4oCU?=
 =?utf-8?q?_Container_datatypes?=
In-Reply-To: <1510157451.94.0.213398074469.issue31982@psf.upfronthosting.co.za>
Message-ID: <1550699399.16.0.525741346404.issue31982@roundup.psfhosted.org>


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


----------
pull_requests: +11987

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

From report at bugs.python.org  Wed Feb 20 17:23:38 2019
From: report at bugs.python.org (Raymond Hettinger)
Date: Wed, 20 Feb 2019 22:23:38 +0000
Subject: [docs] =?utf-8?b?W2lzc3VlMzE5ODJdIDguMy4gY29sbGVjdGlvbnMg4oCU?=
 =?utf-8?q?_Container_datatypes?=
In-Reply-To: <1510157451.94.0.213398074469.issue31982@psf.upfronthosting.co.za>
Message-ID: <1550701418.29.0.79440346567.issue31982@roundup.psfhosted.org>


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


New changeset 14baf06febb9194dd76f694ec359ce94708ed861 by Raymond Hettinger (Miss Islington (bot)) in branch '3.7':
bpo-31982: Improve sequence of presentation in ChainMap docs (GH-11960) (GH-11961)
https://github.com/python/cpython/commit/14baf06febb9194dd76f694ec359ce94708ed861


----------

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

From report at bugs.python.org  Wed Feb 20 17:25:43 2019
From: report at bugs.python.org (Raymond Hettinger)
Date: Wed, 20 Feb 2019 22:25:43 +0000
Subject: [docs] =?utf-8?b?W2lzc3VlMzE5ODJdIDguMy4gY29sbGVjdGlvbnMg4oCU?=
 =?utf-8?q?_Container_datatypes?=
In-Reply-To: <1510157451.94.0.213398074469.issue31982@psf.upfronthosting.co.za>
Message-ID: <1550701543.62.0.565613332926.issue31982@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/issue31982>
_______________________________________

From report at bugs.python.org  Wed Feb 20 20:10:36 2019
From: report at bugs.python.org (py.user)
Date: Thu, 21 Feb 2019 01:10:36 +0000
Subject: [docs] [issue28235] In xml.etree.ElementTree docs there is no
 parser argument in fromstring()
In-Reply-To: <1474457056.95.0.329737294315.issue28235@psf.upfronthosting.co.za>
Message-ID: <1550711436.29.0.286671659739.issue28235@roundup.psfhosted.org>


py.user <bugzilla-mail-box at yandex.ru> added the comment:

@Cheryl Sabella, I guess Manjusaka has done it already and this looks fine.

----------

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

From report at bugs.python.org  Wed Feb 20 20:47:47 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 21 Feb 2019 01:47:47 +0000
Subject: [docs] [issue22865] Document how to make pty.spawn not copy data
In-Reply-To: <1415901686.09.0.50650588621.issue22865@psf.upfronthosting.co.za>
Message-ID: <1550713667.38.0.536313201925.issue22865@roundup.psfhosted.org>


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

@RadicalZephyr, are you interested in making a GitHub pull request with the recommended the documentation change?

----------
nosy: +cheryl.sabella
versions: +Python 3.7, Python 3.8 -Python 2.7, Python 3.4, Python 3.5, Python 3.6

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

From report at bugs.python.org  Thu Feb 21 01:34:58 2019
From: report at bugs.python.org (INADA Naoki)
Date: Thu, 21 Feb 2019 06:34:58 +0000
Subject: [docs] [issue35822] _queue _queuemodule.c is missing inside the
 Setup file
In-Reply-To: <1548374932.46.0.67529287669.issue35822@roundup.psfhosted.org>
Message-ID: <1550730898.21.0.186446452865.issue35822@roundup.psfhosted.org>


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


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

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

From tapio.koskinen at insta.fi  Thu Feb 21 02:34:10 2019
From: tapio.koskinen at insta.fi (Koskinen Tapio)
Date: Thu, 21 Feb 2019 07:34:10 +0000
Subject: [docs] Incorrect documentation in threading.Lock?
Message-ID: <fec663ea26e14011abe901a5fd85a617@mail01.insta.fi>

https://docs.python.org/3/library/threading.html#threading.Lock.acquire says:

"When invoked with the blocking argument set to True (the default), block until the lock is unlocked, then set it to locked and return True.

When invoked with the blocking argument set to False, do not block. If a call with blocking set to True would block, return False immediately; otherwise, set the lock to locked and return True.
"

Shouldn't the second paragraph's second sentence start with "If a call with blocking set to *False* would block..."? Or to avoid repetition, maybe something like "If such a call would block...".
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190221/9d3947cb/attachment-0001.html>

From JBOURGAULT at sii.fr  Thu Feb 21 02:54:51 2019
From: JBOURGAULT at sii.fr (Joel BOURGAULT)
Date: Thu, 21 Feb 2019 07:54:51 +0000
Subject: [docs] python 3.7.2 documentation : Typo error in `collections`
 module
Message-ID: <bf3196b028924ed4940216a18bf32d03@sii.fr>

Hello,

I just found a typo error in the French version of the python 3.7.2 documentation, namely "defaultdic" i.o. "defaultdict", see highlighting below:

class collections.defaultdict([default_factory[, ...]])
Renvoie un nouvel objet qui se comporte comme un dictionnaire. defaultdic est une sous-classe de la la classe native dict. Elle surcharge une m?thode et ajoute une variable d'instance mod

Thanks again for the tremendous documentation !

Best Regards,
--
Jo?l BOURGAULT
A400M Flight Management System Engineer              tel: +33 (0)5 82 95 75 60
On behalf of SII                                                                          @: jbourgault at sii.fr<mailto:jbourgault at sii.fr>
Subcontractor for EYAN4 - Airbus Operations SAS
[image signature SII-Toulouse rogn?e]
                                                         SII Toulouse
                                   7 rue Paulin Talabot | 31 100 Toulouse
                                                        groupe-sii.com<http://www.groupe-sii.com/>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190221/98b61608/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image001.jpg
Type: image/jpeg
Size: 12342 bytes
Desc: image001.jpg
URL: <http://mail.python.org/pipermail/docs/attachments/20190221/98b61608/attachment-0001.jpg>

From report at bugs.python.org  Thu Feb 21 05:23:41 2019
From: report at bugs.python.org (Lye)
Date: Thu, 21 Feb 2019 10:23:41 +0000
Subject: [docs] [issue36064] docs: urllib.request.Request not accepting
 iterables data type
Message-ID: <1550744621.39.0.0634252256257.issue36064@roundup.psfhosted.org>


New submission from Lye <sylye at yahoo.com>:

I found out in the docs 3.6, in the class urllib.request.Request, for the input of 'data' data types, it says :

"The supported object types include bytes, file-like objects, and iterables."

But after testing it with data type dict for the 'data' input, I got error of:

"can't concat str to bytes"

It seems the docs should't say the 'data' data types support iterables.

There more detail discussion is at : https://stackoverflow.com/questions/54802272/some-fundamental-concept-used-in-python-docs

Hope this helps, thanks !

----------
assignee: docs at python
components: Documentation
messages: 336198
nosy: docs at python, sylye
priority: normal
severity: normal
status: open
title: docs: urllib.request.Request not accepting iterables data type
type: enhancement
versions: Python 3.6, Python 3.7, Python 3.8

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

From report at bugs.python.org  Thu Feb 21 05:27:45 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Thu, 21 Feb 2019 10:27:45 +0000
Subject: [docs] [issue36064] docs: urllib.request.Request not accepting
 iterables data type
In-Reply-To: <1550744621.39.0.0634252256257.issue36064@roundup.psfhosted.org>
Message-ID: <1550744865.59.0.0887587978352.issue36064@roundup.psfhosted.org>


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

Thank you for your issue but could you provide an example file?

Have a nice day.

For the new contributors, this issue is marked as easy.

----------
keywords: +easy
nosy: +matrixise

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

From report at bugs.python.org  Thu Feb 21 05:44:36 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Thu, 21 Feb 2019 10:44:36 +0000
Subject: [docs] [issue36064] docs: urllib.request.Request not accepting
 iterables data type
In-Reply-To: <1550744621.39.0.0634252256257.issue36064@roundup.psfhosted.org>
Message-ID: <1550745876.01.0.720628445869.issue36064@roundup.psfhosted.org>


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

Hi Lye,

I didn't read your link, sorry you don't need to provide an example.
We can work with this example.

----------

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

From report at bugs.python.org  Thu Feb 21 05:45:51 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 21 Feb 2019 10:45:51 +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: <1550745951.71.0.125887474552.issue33039@roundup.psfhosted.org>


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

Is not this a duplicate of issue20092?

----------

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

From report at bugs.python.org  Thu Feb 21 05:53:34 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Thu, 21 Feb 2019 10:53:34 +0000
Subject: [docs] [issue36064] docs: urllib.request.Request not accepting
 iterables data type
In-Reply-To: <1550744621.39.0.0634252256257.issue36064@roundup.psfhosted.org>
Message-ID: <1550746414.75.0.284228790522.issue36064@roundup.psfhosted.org>


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

Hi Lye,

I am not sure it's a bug because I don't have any problem with your script.

Here is your script.

import urllib
import urllib.request

my_url = "https://api.foo.com"
my_headers = { "Content-Type" : "application/x-www-form-urlencoded" }
my_data = {
        "client_id" : "ppp",
        "client_secret" : "000",
        "grant_type" : "client_credentials" }

req = urllib.request.Request(url=my_url, data=my_data, headers=my_headers)
response = urllib.request.urlopen(req)
html = response.read()
print(html)

and here is the result with the version 3.6 of Python:

> docker run --rm -v $PWD:/src -it python:3.6 python /src/demo.py
Traceback (most recent call last):
  File "/usr/local/lib/python3.6/urllib/request.py", line 1318, in do_open
    encode_chunked=req.has_header('Transfer-encoding'))
  ...
  File "/usr/local/lib/python3.6/socket.py", line 713, in create_connection
    sock.connect(sa)
ConnectionRefusedError: [Errno 111] Connection refused

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "/src/demo.py", line 12, in <module>
    response = urllib.request.urlopen(req)
  ...
  File "/usr/local/lib/python3.6/urllib/request.py", line 1320, in do_open
    raise URLError(err)
urllib.error.URLError: <urlopen error [Errno 111] Connection refused>

I don't get your error. 

and the version of this docker image is 3.6.8

> docker run --rm -v $PWD:/src -it python:3.6 python --version
Python 3.6.8

----------

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

From report at bugs.python.org  Thu Feb 21 05:56:16 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Thu, 21 Feb 2019 10:56:16 +0000
Subject: [docs] [issue36064] docs: urllib.request.Request not accepting
 iterables data type
In-Reply-To: <1550744621.39.0.0634252256257.issue36064@roundup.psfhosted.org>
Message-ID: <1550746576.0.0.186883487447.issue36064@roundup.psfhosted.org>


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

and I get the same result with the python:3.6.7 image docker

> docker run --rm -v $PWD:/src -it python:3.6.7 python /src/demo.py
Traceback (most recent call last):
  File "/usr/local/lib/python3.6/urllib/request.py", line 1318, in do_open
    encode_chunked=req.has_header('Transfer-encoding'))
  ...
  File "/usr/local/lib/python3.6/socket.py", line 713, in create_connection
    sock.connect(sa)
ConnectionRefusedError: [Errno 111] Connection refused

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "/src/demo.py", line 12, in <module>
    response = urllib.request.urlopen(req)
  ...
  File "/usr/local/lib/python3.6/urllib/request.py", line 1320, in do_open
    raise URLError(err)
urllib.error.URLError: <urlopen error [Errno 111] Connection refused>

I am really sorry but I can't reproduce your issue.

What is your Linux distribution or OS?

Thank you

----------

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

From report at bugs.python.org  Thu Feb 21 06:32:58 2019
From: report at bugs.python.org (Lye)
Date: Thu, 21 Feb 2019 11:32:58 +0000
Subject: [docs] [issue36064] docs: urllib.request.Request not accepting
 iterables data type
In-Reply-To: <1550744621.39.0.0634252256257.issue36064@roundup.psfhosted.org>
Message-ID: <1550748778.14.0.249126474406.issue36064@roundup.psfhosted.org>


Lye <sylye at yahoo.com> added the comment:

Hi @matrixise,

Sorry that the example in that stackoverflow site is a dummy API server. I tested my code in a real API server so I can produce the error. I have re-tested my code with that dummy site and yes you won't able to get that error. To reproduce that error, you may try a valid API server, like 'https://httpbin.org/post' . I just tested again by replacing :

my_url = "https://api.foo.com"

with 

my_url = "https://httpbin.org/post"

and able to get the same error again. Apology for not using a real API server in my example :)

----------

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

From report at bugs.python.org  Thu Feb 21 06:34:00 2019
From: report at bugs.python.org (Lye)
Date: Thu, 21 Feb 2019 11:34:00 +0000
Subject: [docs] [issue36064] docs: urllib.request.Request not accepting
 iterables data type
In-Reply-To: <1550744621.39.0.0634252256257.issue36064@roundup.psfhosted.org>
Message-ID: <1550748840.28.0.279924479579.issue36064@roundup.psfhosted.org>


Lye <sylye at yahoo.com> added the comment:

And I tested in both :

Centos 6.10 
4.14.77-70.59.amzn1.x86_64

----------

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

From report at bugs.python.org  Thu Feb 21 07:00:29 2019
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Thu, 21 Feb 2019 12:00:29 +0000
Subject: [docs] [issue36064] docs: urllib.request.Request not accepting
 iterables data type
In-Reply-To: <1550744621.39.0.0634252256257.issue36064@roundup.psfhosted.org>
Message-ID: <1550750429.71.0.29589758022.issue36064@roundup.psfhosted.org>


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

I guess key should be bytes instead of a dict with string key. Maybe the docs could be improved about the case where key in case of dict should be bytes.

>>> from urllib.request import urlopen, Request
>>> r = Request("http://httpbin.org/post", data={b'a': 'a'})
>>> resp = urlopen(r)
>>> print(resp.read())
b'{\n  "args": {}, \n  "data": "", \n  "files": {}, \n  "form": {\n    "a": ""\n  }, \n  "headers": {\n    "Accept-Encoding": "identity", \n    "Content-Length": "1", \n    "Content-Type": "application/x-www-form-urlencoded", \n    "Host": "httpbin.org", \n    "User-Agent": "Python-urllib/3.8"\n  }, \n  "json": null, \n  "origin": "123.201.136.26, 123.201.136.26", \n  "url": "https://httpbin.org/post"\n}\n'

See https://bugs.python.org/issue25439 for an open patch to ensure this is type checked.

>>> from urllib.request import urlopen, Request
>>> r = Request("http://httpbin.org/post", data={'a': 'a'})
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "/Users/karthikeyansingaravelan/stuff/python/cpython/Lib/urllib/request.py", line 332, in __init__
    self.data = data
  File "/Users/karthikeyansingaravelan/stuff/python/cpython/Lib/urllib/request.py", line 370, in data
    raise TypeError("Key should be type of bytes in POST data")
TypeError: Key should be type of bytes in POST data

Current code is not checking the type makes it pass during construction and then throw an error later like below : 

>>> from urllib.request import urlopen, Request
>>> r = Request("http://httpbin.org/post", data={'a': 'a'})
>>> urlopen(r)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "/Library/Frameworks/Python.framework/Versions/3.7/lib/python3.7/urllib/request.py", line 222, in urlopen
    return opener.open(url, data, timeout)
  File "/Library/Frameworks/Python.framework/Versions/3.7/lib/python3.7/urllib/request.py", line 525, in open
    response = self._open(req, data)
  File "/Library/Frameworks/Python.framework/Versions/3.7/lib/python3.7/urllib/request.py", line 543, in _open
    '_open', req)
  File "/Library/Frameworks/Python.framework/Versions/3.7/lib/python3.7/urllib/request.py", line 503, in _call_chain
    result = func(*args)
  File "/Library/Frameworks/Python.framework/Versions/3.7/lib/python3.7/urllib/request.py", line 1345, in http_open
    return self.do_open(http.client.HTTPConnection, req)
  File "/Library/Frameworks/Python.framework/Versions/3.7/lib/python3.7/urllib/request.py", line 1317, in do_open
    encode_chunked=req.has_header('Transfer-encoding'))
  File "/Library/Frameworks/Python.framework/Versions/3.7/lib/python3.7/http/client.py", line 1229, in request
    self._send_request(method, url, body, headers, encode_chunked)
  File "/Library/Frameworks/Python.framework/Versions/3.7/lib/python3.7/http/client.py", line 1275, in _send_request
    self.endheaders(body, encode_chunked=encode_chunked)
  File "/Library/Frameworks/Python.framework/Versions/3.7/lib/python3.7/http/client.py", line 1224, in endheaders
    self._send_output(message_body, encode_chunked=encode_chunked)
  File "/Library/Frameworks/Python.framework/Versions/3.7/lib/python3.7/http/client.py", line 1054, in _send_output
    + b'\r\n'
TypeError: can't concat str to bytes

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

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

From report at bugs.python.org  Thu Feb 21 07:28:02 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Thu, 21 Feb 2019 12:28:02 +0000
Subject: [docs] [issue36064] docs: urllib.request.Request not accepting
 iterables data type
In-Reply-To: <1550744621.39.0.0634252256257.issue36064@roundup.psfhosted.org>
Message-ID: <1550752081.98.0.340103060391.issue36064@roundup.psfhosted.org>


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

ok, I confirm this issue, now, with httpbin.org I get the same issue.

and it's just when we try to send the stream to the server.

----------

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

From report at bugs.python.org  Thu Feb 21 07:38:27 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Thu, 21 Feb 2019 12:38:27 +0000
Subject: [docs] [issue36064] docs: urllib.request.Request not accepting
 iterables data type
In-Reply-To: <1550744621.39.0.0634252256257.issue36064@roundup.psfhosted.org>
Message-ID: <1550752707.61.0.0541130421261.issue36064@roundup.psfhosted.org>


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

@xtreak

ok because it's not related to the documentation, I have a fix for this issue but I am not sure about the title for this PR but what do you suggest?

"Fix the encoding in _send_output when sending an iterable object via urllib.request.Request" ?

----------

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

From report at bugs.python.org  Thu Feb 21 07:44:44 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Thu, 21 Feb 2019 12:44:44 +0000
Subject: [docs] [issue36064] docs: urllib.request.Request not accepting
 iterables data type
In-Reply-To: <1550744621.39.0.0634252256257.issue36064@roundup.psfhosted.org>
Message-ID: <1550753084.76.0.0573527522325.issue36064@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Thu Feb 21 07:46:23 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Thu, 21 Feb 2019 12:46:23 +0000
Subject: [docs] [issue36064] docs: urllib.request.Request not accepting
 iterables data type
In-Reply-To: <1550744621.39.0.0634252256257.issue36064@roundup.psfhosted.org>
Message-ID: <1550753183.19.0.449916062108.issue36064@roundup.psfhosted.org>


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

@xtreak

I have just pushed a PR, if you think it's an issue related to the documentation, you can ignore my PR and in this case I will close it.

now, it's not related to the doc, could you review it and give me your feedback?

Thank you,

----------

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

From report at bugs.python.org  Thu Feb 21 08:56:39 2019
From: report at bugs.python.org (Emmanuel Arias)
Date: Thu, 21 Feb 2019 13:56:39 +0000
Subject: [docs] [issue20582] socket.getnameinfo() does not document flags
In-Reply-To: <1392042265.22.0.885252016144.issue20582@psf.upfronthosting.co.za>
Message-ID: <1550757399.4.0.366606283185.issue20582@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Thu Feb 21 09:02:53 2019
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Thu, 21 Feb 2019 14:02:53 +0000
Subject: [docs] [issue36064] docs: urllib.request.Request not accepting
 iterables data type
In-Reply-To: <1550744621.39.0.0634252256257.issue36064@roundup.psfhosted.org>
Message-ID: <1550757773.8.0.501644792823.issue36064@roundup.psfhosted.org>


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

St?phane, I don't know much about urllib to review this. The reason I said it's better document this is that there was an extended discussion on issue25439 along with a PR about type checking breaking some behavior and ambiguity in what is allowed currently. This PR seems to encode str to bytes implicitly and it needs to be documented as such that this str is encoded to bytes under the hood. I am not sure of backporting it as a fix to stable releases. I think it's better to raise an error instead of doing something implicitly.  I am adding Martin and Senthil to the issue who might have a better context.

----------
nosy: +martin.panter, orsenthil

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

From report at bugs.python.org  Thu Feb 21 09:15:04 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Thu, 21 Feb 2019 14:15:04 +0000
Subject: [docs] [issue36064] docs: urllib.request.Request not accepting
 iterables data type
In-Reply-To: <1550744621.39.0.0634252256257.issue36064@roundup.psfhosted.org>
Message-ID: <1550758504.91.0.551366966238.issue36064@roundup.psfhosted.org>


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

Thank you @xtreak for adding Martin and Senthil.

----------

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

From report at bugs.python.org  Thu Feb 21 11:10:40 2019
From: report at bugs.python.org (=?utf-8?q?R=C3=A9mi_Lapeyre?=)
Date: Thu, 21 Feb 2019 16:10:40 +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: <1550765440.46.0.572272827082.issue33039@roundup.psfhosted.org>


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

Yes it is. Thanks for finding that @Serhiy.

Since nobody objected to the change on the mailing list and people seem to agree in issue 20092:

    [R. David Murray]
    To summarize for anyone like me who didn't follow that issue: __index__ means the object can be losslessly converted to an int (is a true int), while __int__ may be an approximate conversion.  Thus it makes sense for an object to have an __int__ but not __index__, but vice-versa does not make sense.


I will post my patch tonight.

----------

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

From report at bugs.python.org  Thu Feb 21 12:49:26 2019
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 21 Feb 2019 17:49:26 +0000
Subject: [docs] [issue22865] Document how to make pty.spawn not copy data
In-Reply-To: <1415901686.09.0.50650588621.issue22865@psf.upfronthosting.co.za>
Message-ID: <1550771366.81.0.439904865759.issue22865@roundup.psfhosted.org>


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


----------
pull_requests: +12004

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

From report at bugs.python.org  Thu Feb 21 12:50:50 2019
From: report at bugs.python.org (Geoff Shannon)
Date: Thu, 21 Feb 2019 17:50:50 +0000
Subject: [docs] [issue22865] Document how to make pty.spawn not copy data
In-Reply-To: <1415901686.09.0.50650588621.issue22865@psf.upfronthosting.co.za>
Message-ID: <1550771450.16.0.607316227685.issue22865@roundup.psfhosted.org>


Geoff Shannon <earthlingzephyr at gmail.com> added the comment:

It is submitted @cheryl.sabella. Thanks for reviving this, I had totally lost track of it.

----------

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

From report at bugs.python.org  Thu Feb 21 15:33:03 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Thu, 21 Feb 2019 20:33:03 +0000
Subject: [docs] [issue22865] Document how to make pty.spawn not copy data
In-Reply-To: <1415901686.09.0.50650588621.issue22865@psf.upfronthosting.co.za>
Message-ID: <1550781183.0.0.156301071687.issue22865@roundup.psfhosted.org>


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

Thanks @RadicalZephyr!  

@martin.panter, please review the PR when you get a chance.  Thank you!

----------

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

From report at bugs.python.org  Thu Feb 21 18:03:54 2019
From: report at bugs.python.org (Martin Panter)
Date: Thu, 21 Feb 2019 23:03:54 +0000
Subject: [docs] [issue22865] Document how to make pty.spawn not copy data
In-Reply-To: <1415901686.09.0.50650588621.issue22865@psf.upfronthosting.co.za>
Message-ID: <1550790233.98.0.269204935916.issue22865@roundup.psfhosted.org>


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

I'm not sure it is wise for the Python documentation to suggest inserting null bytes in general. This seems more like an application-specific hack. There is nothing in Python that handles these null bytes specially, and I expect they will be seen if the child reads the terminal in raw mode, or if the parent's output is redirected to a file, sent over the network or a real serial link.

----------

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

From report at bugs.python.org  Thu Feb 21 18:32:21 2019
From: report at bugs.python.org (=?utf-8?q?Mihai_Capot=C4=83?=)
Date: Thu, 21 Feb 2019 23:32:21 +0000
Subject: [docs] [issue35651] PEP 257 (active) references PEP 258 (rejected)
 as if it were active
In-Reply-To: <1546536866.6.0.633154963858.issue35651@roundup.psfhosted.org>
Message-ID: <1550791941.29.0.518633483049.issue35651@roundup.psfhosted.org>


Change by Mihai Capot? <mihai at mihaic.ro>:


----------
nosy: +mihaic

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

From report at bugs.python.org  Thu Feb 21 19:34:06 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Fri, 22 Feb 2019 00:34:06 +0000
Subject: [docs] [issue28235] In xml.etree.ElementTree docs there is no
 parser argument in fromstring()
In-Reply-To: <1474457056.95.0.329737294315.issue28235@psf.upfronthosting.co.za>
Message-ID: <1550795646.16.0.853518286379.issue28235@roundup.psfhosted.org>


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


New changeset e5458bdb6af81f9b98acecd8819c60016d3f1441 by Cheryl Sabella (Manjusaka) in branch 'master':
bpo-28235: Fix xml.etree.ElementTree.fromstring docs (GH-11903)
https://github.com/python/cpython/commit/e5458bdb6af81f9b98acecd8819c60016d3f1441


----------

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

From report at bugs.python.org  Thu Feb 21 19:34:20 2019
From: report at bugs.python.org (miss-islington)
Date: Fri, 22 Feb 2019 00:34:20 +0000
Subject: [docs] [issue28235] In xml.etree.ElementTree docs there is no
 parser argument in fromstring()
In-Reply-To: <1474457056.95.0.329737294315.issue28235@psf.upfronthosting.co.za>
Message-ID: <1550795660.12.0.755579826187.issue28235@roundup.psfhosted.org>


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


----------
pull_requests: +12007

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

From report at bugs.python.org  Thu Feb 21 19:45:34 2019
From: report at bugs.python.org (miss-islington)
Date: Fri, 22 Feb 2019 00:45:34 +0000
Subject: [docs] [issue28235] In xml.etree.ElementTree docs there is no
 parser argument in fromstring()
In-Reply-To: <1474457056.95.0.329737294315.issue28235@psf.upfronthosting.co.za>
Message-ID: <1550796334.42.0.549560557008.issue28235@roundup.psfhosted.org>


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


New changeset b046f1badaaffb7e526b937fa2192c449b9076ed by Miss Islington (bot) in branch '3.7':
bpo-28235: Fix xml.etree.ElementTree.fromstring docs (GH-11903)
https://github.com/python/cpython/commit/b046f1badaaffb7e526b937fa2192c449b9076ed


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

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

From report at bugs.python.org  Thu Feb 21 19:50:39 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Fri, 22 Feb 2019 00:50:39 +0000
Subject: [docs] [issue28235] In xml.etree.ElementTree docs there is no
 parser argument in fromstring()
In-Reply-To: <1474457056.95.0.329737294315.issue28235@psf.upfronthosting.co.za>
Message-ID: <1550796639.92.0.143213751877.issue28235@roundup.psfhosted.org>


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

Thank you @py.user for reporting this issue and for the original patch and thank you @Manjusaka for the PR!

This was my first merge! Woot! :-)

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

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

From report at bugs.python.org  Fri Feb 22 01:28:58 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 22 Feb 2019 06:28:58 +0000
Subject: [docs] [issue20582] socket.getnameinfo() does not document flags
In-Reply-To: <1392042265.22.0.885252016144.issue20582@psf.upfronthosting.co.za>
Message-ID: <1550816938.41.0.392931673299.issue20582@roundup.psfhosted.org>


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

You can use the special role :manpage: for referring man pages.

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

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

From report at bugs.python.org  Fri Feb 22 02:54:16 2019
From: report at bugs.python.org (Inada Naoki)
Date: Fri, 22 Feb 2019 07:54:16 +0000
Subject: [docs] [issue33961] Inconsistency in exceptions for
 dataclasses.dataclass documentation
In-Reply-To: <1529963695.74.0.56676864532.issue33961@psf.upfronthosting.co.za>
Message-ID: <1550822056.44.0.367810372863.issue33961@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Fri Feb 22 04:14:20 2019
From: report at bugs.python.org (Kevin Mai-Hsuan Chia)
Date: Fri, 22 Feb 2019 09:14:20 +0000
Subject: [docs] [issue36074] Result of `asyncio.Server.sockets` after
 `Server.close()` is not clear
Message-ID: <1550826860.7.0.550984466305.issue36074@roundup.psfhosted.org>


New submission from Kevin Mai-Hsuan Chia <kevin at mhchia.com>:

It seems the result of `asyncio.Server.sockets` after `asyncio.Server.close()` is performed becomes `[]` instead of `None` since python 3.7. However, in the [document 3.7 and 3.8](https://docs.python.org/3.8/library/asyncio-eventloop.html#asyncio.Server.sockets), it states
```
List of socket.socket objects the server is listening on, or None if the server is closed.

Changed in version 3.7: Prior to Python 3.7 Server.sockets used to return an internal list of server sockets directly. In 3.7 a copy of that list is returned.
```
For me, I think the comment `Changed in version 3.7: ...` only emphasizes the "copied list" is returned. IMO it will be more clear if the change from `None` to `[]` is mentioned in the comment as well. Sorry if this issue is not appropriate. Thanks!

----------
assignee: docs at python
components: Documentation
messages: 336287
nosy: docs at python, mhchia
priority: normal
severity: normal
status: open
title: Result of `asyncio.Server.sockets` after `Server.close()` is not clear
type: enhancement
versions: Python 3.7, Python 3.8

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

From report at bugs.python.org  Fri Feb 22 05:16:03 2019
From: report at bugs.python.org (Martin Panter)
Date: Fri, 22 Feb 2019 10:16:03 +0000
Subject: [docs] [issue36064] docs: urllib.request.Request not accepting
 iterables data type
In-Reply-To: <1550744621.39.0.0634252256257.issue36064@roundup.psfhosted.org>
Message-ID: <1550830563.95.0.999311082121.issue36064@roundup.psfhosted.org>


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

I agree the documentation is insufficient. It should have said if ?data? is iterated, it must yield bytes-like objects.

I agree it is unwise to yet more special cases for the uploaded data types. When Lye passed the dictionary of three keys and values, I suspect they weren?t expecting it to upload just the key names using one HTTP chunk for each key. See Issue 23740 about the mess of data types currently supported.

----------

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

From report at bugs.python.org  Fri Feb 22 06:09:55 2019
From: report at bugs.python.org (miss-islington)
Date: Fri, 22 Feb 2019 11:09:55 +0000
Subject: [docs] [issue35307] Command line help example is missing "--prompt"
 option
In-Reply-To: <1543054310.5.0.788709270274.issue35307@psf.upfronthosting.co.za>
Message-ID: <1550833795.86.0.0571253379208.issue35307@roundup.psfhosted.org>


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


----------
pull_requests: +12009

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

From report at bugs.python.org  Fri Feb 22 06:56:02 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Fri, 22 Feb 2019 11:56:02 +0000
Subject: [docs] [issue35307] Command line help example is missing "--prompt"
 option
In-Reply-To: <1543054310.5.0.788709270274.issue35307@psf.upfronthosting.co.za>
Message-ID: <1550836562.92.0.194500699303.issue35307@roundup.psfhosted.org>


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

Thank you @daftwullie for the report and for the PR!  And thank you, @xtreak for triaging and for the reminder.  :-)

----------
nosy: +cheryl.sabella
resolution:  -> fixed
stage: patch review -> resolved
status: open -> closed
versions: +Python 3.8

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

From report at bugs.python.org  Fri Feb 22 07:31:06 2019
From: report at bugs.python.org (Emmanuel Arias)
Date: Fri, 22 Feb 2019 12:31:06 +0000
Subject: [docs] [issue36074] Result of `asyncio.Server.sockets` after
 `Server.close()` is not clear
In-Reply-To: <1550826860.7.0.550984466305.issue36074@roundup.psfhosted.org>
Message-ID: <1550838666.03.0.291290833481.issue36074@roundup.psfhosted.org>


Emmanuel Arias <emmanuelarias30 at gmail.com> added the comment:

Yes, that is a problem (in principle) of the docs. But I think that would be appropriate return None if is closed.

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

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

From report at bugs.python.org  Fri Feb 22 07:46:58 2019
From: report at bugs.python.org (Emmanuel Arias)
Date: Fri, 22 Feb 2019 12:46:58 +0000
Subject: [docs] [issue36074] Result of `asyncio.Server.sockets` after
 `Server.close()` is not clear
In-Reply-To: <1550826860.7.0.550984466305.issue36074@roundup.psfhosted.org>
Message-ID: <1550839618.94.0.351854050962.issue36074@roundup.psfhosted.org>


Emmanuel Arias <emmanuelarias30 at gmail.com> added the comment:

hmm looking in depth when the server is closed, currently return None.

----------

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

From report at bugs.python.org  Fri Feb 22 07:48:31 2019
From: report at bugs.python.org (Emmanuel Arias)
Date: Fri, 22 Feb 2019 12:48:31 +0000
Subject: [docs] [issue36074] Result of `asyncio.Server.sockets` after
 `Server.close()` is not clear
In-Reply-To: <1550826860.7.0.550984466305.issue36074@roundup.psfhosted.org>
Message-ID: <1550839711.4.0.303470462122.issue36074@roundup.psfhosted.org>


Emmanuel Arias <emmanuelarias30 at gmail.com> added the comment:

Maybe would be great mention that the None is still return for closed server

----------

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

From kai.wassmuss at gmx.de  Thu Feb 21 12:04:38 2019
From: kai.wassmuss at gmx.de (=?UTF-8?B?S2FpIFdhw59tdcOf?=)
Date: Thu, 21 Feb 2019 18:04:38 +0100
Subject: [docs] context argument for multiprocessing.pool.Pool
Message-ID: <b7219f0f-3181-9832-6482-c76aee279cf9@gmx.de>

Hi,
there is an inconsistency between the documentation about 
multiprocessing pools and the way you can actually start pools with 
non-default contexts.

https://docs.python.org/3/library/multiprocessing.html#multiprocessing.pool.Pool
reads:
class multiprocessing.pool.Pool([processes[, initializer[, initargs[, 
maxtasksperchild[, context]]]]])
A process pool object which controls a pool of worker processes to which 
jobs can be submitted. It supports asynchronous results with timeouts 
and callbacks and has a parallel map implementation.

[...]
context can be used to specify the context used for starting the worker 
processes. Usually a pool is created using the function 
multiprocessing.Pool() or the Pool() method of a context object. In both 
cases context is set appropriately.

Note that the methods of the pool object should only be called by the 
process which created the pool.

New in version 3.2: maxtasksperchild

New in version 3.4: context

In the actual implementation however there is no argument context.
You can actually still start a pool with a non-default context with 
something like this:
with get_context("forkserver").Pool() as pool:
	do_something()

This should probably be fixed in the implementation rather than the 
documentation, but at the moment it's confusing that the documentation 
includes an option that isn't there.

Regards,
Kai Wassmuss


From report at bugs.python.org  Fri Feb 22 07:58:01 2019
From: report at bugs.python.org (Emmanuel Arias)
Date: Fri, 22 Feb 2019 12:58:01 +0000
Subject: [docs] [issue36074] Result of `asyncio.Server.sockets` after
 `Server.close()` is not clear
In-Reply-To: <1550826860.7.0.550984466305.issue36074@roundup.psfhosted.org>
Message-ID: <1550840281.95.0.0771061667863.issue36074@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Fri Feb 22 08:20:51 2019
From: report at bugs.python.org (Kevin Mai-Hsuan Chia)
Date: Fri, 22 Feb 2019 13:20:51 +0000
Subject: [docs] [issue36074] Result of `asyncio.Server.sockets` after
 `Server.close()` is not clear
In-Reply-To: <1550826860.7.0.550984466305.issue36074@roundup.psfhosted.org>
Message-ID: <1550841651.29.0.363333958227.issue36074@roundup.psfhosted.org>


Kevin Mai-Hsuan Chia <kevin at mhchia.com> added the comment:

Excuse me, I tried 3.7.2 and 3.8.0a1+ with the following code and still failed. Could you help me to try this? or can you give me a pointer to the code returning `None`? Sorry for the inconvenience and thanks a lot.
```
import asyncio
import platform


async def close_server():
    def handler(reader, writer):
        pass
    s = await asyncio.start_server(handler, host='127.0.0.1', port=34567)
    s.close()
    await s.wait_closed()
    assert s.sockets is None


print("version: ", platform.python_version())
asyncio.get_event_loop().run_until_complete(close_server())
```

----------

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

From report at bugs.python.org  Fri Feb 22 08:28:40 2019
From: report at bugs.python.org (Emmanuel Arias)
Date: Fri, 22 Feb 2019 13:28:40 +0000
Subject: [docs] [issue36074] Result of `asyncio.Server.sockets` after
 `Server.close()` is not clear
In-Reply-To: <1550826860.7.0.550984466305.issue36074@roundup.psfhosted.org>
Message-ID: <1550842120.55.0.678728102513.issue36074@roundup.psfhosted.org>


Emmanuel Arias <emmanuelarias30 at gmail.com> added the comment:

@mhchia yes! sorry! I was testing the .close() return. yes you are right is confused. I will modified the PR.

Thanks

----------

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

From report at bugs.python.org  Fri Feb 22 08:48:48 2019
From: report at bugs.python.org (Emmanuel Arias)
Date: Fri, 22 Feb 2019 13:48:48 +0000
Subject: [docs] [issue35826] Typo in example for async with statement with
 condition
In-Reply-To: <1548413052.91.0.387178410518.issue35826@roundup.psfhosted.org>
Message-ID: <1550843328.84.0.575867297424.issue35826@roundup.psfhosted.org>


Emmanuel Arias <emmanuelarias30 at gmail.com> added the comment:

This issue could be closed, right?

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

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

From report at bugs.python.org  Fri Feb 22 08:53:37 2019
From: report at bugs.python.org (Kevin Mai-Hsuan Chia)
Date: Fri, 22 Feb 2019 13:53:37 +0000
Subject: [docs] [issue36074] Result of `asyncio.Server.sockets` after
 `Server.close()` is not clear
In-Reply-To: <1550826860.7.0.550984466305.issue36074@roundup.psfhosted.org>
Message-ID: <1550843617.6.0.455997832417.issue36074@roundup.psfhosted.org>


Kevin Mai-Hsuan Chia <kevin at mhchia.com> added the comment:

Sure thing. Should it be discussed more detailed before the PR? If the document or the returned value is controversial, I would like to contribute if needed. Thanks :)

----------

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

From report at bugs.python.org  Fri Feb 22 08:56:54 2019
From: report at bugs.python.org (Emmanuel Arias)
Date: Fri, 22 Feb 2019 13:56:54 +0000
Subject: [docs] [issue36074] Result of `asyncio.Server.sockets` after
 `Server.close()` is not clear
In-Reply-To: <1550826860.7.0.550984466305.issue36074@roundup.psfhosted.org>
Message-ID: <1550843814.25.0.191267078894.issue36074@roundup.psfhosted.org>


Emmanuel Arias <emmanuelarias30 at gmail.com> added the comment:

> Sure thing. Should it be discussed more detailed before the PR? If the document or the returned value is controversial, I would like to contribute if needed. Thanks :)

Please, make the comments on the PR. This way, other reviewer can see your comments.

----------

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

From julien at palard.fr  Fri Feb 22 09:22:41 2019
From: julien at palard.fr (Julien Palard)
Date: Fri, 22 Feb 2019 14:22:41 +0000
Subject: [docs] context argument for multiprocessing.pool.Pool
In-Reply-To: <b7219f0f-3181-9832-6482-c76aee279cf9@gmx.de>
References: <b7219f0f-3181-9832-6482-c76aee279cf9@gmx.de>
Message-ID: <KG0R-2BsyBsI6ZCNcXn6UZa2heFJZ_-DsXIt7bWXmBIGACC8zYqefN_N0mzrT1Gab5L4vUzRfZJHHPPw3AkTFBeG4BYjhRtkQjViMQaSgf4=@palard.fr>

Hi and thanks for reporting!

> In the actual implementation however there is no argument context.

I can't "reproduce" this statement:

>>> from inspect import signature
>>> from multiprocessing.pool import Pool
>>> signature(Pool.__init__)
<Signature (self, processes=None, initializer=None, initargs=(), maxtasksperchild=None, context=None)>

I see a *context* here, can you be more explicit on how you though it was not here? Bests,

--
Julien Palard
https://mdk.fr


From julien at palard.fr  Fri Feb 22 09:25:48 2019
From: julien at palard.fr (Julien Palard)
Date: Fri, 22 Feb 2019 14:25:48 +0000
Subject: [docs] python 3.7.2 documentation : Typo error in `collections`
 module
In-Reply-To: <bf3196b028924ed4940216a18bf32d03@sii.fr>
References: <bf3196b028924ed4940216a18bf32d03@sii.fr>
Message-ID: <155RwGNw1ND6xKNbfKxUkiI_mi1E5aY8rSg7KE0g6eUOEZYuWrpHMPJhVa28GcSNai9rbw7Cybc6XiztJmU9aQeOurYM-VaeEH0V1gyu7_k=@palard.fr>

Hi Jo?l,

Thanks for reporting, I just fixed it: https://github.com/python/python-docs-fr/commit/2f63bab488d5e4d0e6991a7c0e02060247c75731

Il will be soon visible on docs.python.org.

Bonne journ?e,
--
Julien Palard
https://mdk.fr
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190222/659e5e97/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image001.jpg
Type: image/jpeg
Size: 12342 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20190222/659e5e97/attachment-0001.jpg>

From julien at palard.fr  Fri Feb 22 09:40:12 2019
From: julien at palard.fr (Julien Palard)
Date: Fri, 22 Feb 2019 14:40:12 +0000
Subject: [docs] Incorrect documentation in threading.Lock?
In-Reply-To: <fec663ea26e14011abe901a5fd85a617@mail01.insta.fi>
References: <fec663ea26e14011abe901a5fd85a617@mail01.insta.fi>
Message-ID: <RgQfuxCOmseEoKffBGspWaFkdDW2YKYhc6bHDiS9-UX9TGbai0B7P8JQKoVyXVgpiQz3_N_n5IaeIoBctcVMsH-dPZYtnKQFleP9SW6POu0=@palard.fr>

Hi Koskinen, thanks for asking!

> Shouldn't the second paragraph's second sentence start with "If a call with blocking set to *False* would block..."?

It would cover an unexisting case: calling with blocking set to *False* won't block anyway, so "if blocking is false would block" is the impossible case, only calls with blocking=True can block.

The idea of those tangled sentences is to state that when the function is called with blocking=False and the lock is already held, the function returns *False*.

Instead of writing "and the lock is already held" the documentation write the equivalent: if the call would have blocked if called with blocking=True ("If a call with blocking set to True would block" in the doc).

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

From report at bugs.python.org  Fri Feb 22 09:44:26 2019
From: report at bugs.python.org (Kevin Mai-Hsuan Chia)
Date: Fri, 22 Feb 2019 14:44:26 +0000
Subject: [docs] [issue35826] Typo in example for async with statement with
 condition
In-Reply-To: <1548413052.91.0.387178410518.issue35826@roundup.psfhosted.org>
Message-ID: <1550846666.23.0.326070650013.issue35826@roundup.psfhosted.org>


Kevin Mai-Hsuan Chia <kevin at mhchia.com> added the comment:

Cool! Thanks for the reminder.

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

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

From julien at palard.fr  Fri Feb 22 09:53:33 2019
From: julien at palard.fr (Julien Palard)
Date: Fri, 22 Feb 2019 14:53:33 +0000
Subject: [docs] turtle document bug- screenmode
In-Reply-To: <CAE-Cd-70rfsk1Hy=9pHHFjCZ_tNFrRvtJyRf47xXnjq6KkmvUA@mail.gmail.com>
References: <CAE-Cd-70rfsk1Hy=9pHHFjCZ_tNFrRvtJyRf47xXnjq6KkmvUA@mail.gmail.com>
Message-ID: <K8fLclbEPBA6PaPr0o5CgOVL2L6-30SIL9LoWQI3IwX8gYfb9DDYOuQNKqcOZVWi-l_dSzsUTvAt8mfRFpTZd846qIrEOqysRFqgQWJUptM=@palard.fr>

Hi, thanks for reporting!

> The colormodeis a turtle method not a screen method

In fact, colormode *is* a TurtleScreen method, but it exists both in turtle and TurtleScreen:

It is implemented in class TurtleScreen here: https://github.com/python/cpython/blob/master/Lib/turtle.py#L1180
And it is wrapped to the turtle module here: https://github.com/python/cpython/blob/master/Lib/turtle.py#L3970

so both should work, did you had a bug or did you just get surprised to see "screen." in the example?

--
Julien Palard
https://mdk.fr
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190222/62580a9f/attachment.html>

From report at bugs.python.org  Fri Feb 22 10:09:51 2019
From: report at bugs.python.org (Julien Palard)
Date: Fri, 22 Feb 2019 15:09:51 +0000
Subject: [docs] [issue36074] Result of `asyncio.Server.sockets` after
 `Server.close()` is not clear
In-Reply-To: <1550826860.7.0.550984466305.issue36074@roundup.psfhosted.org>
Message-ID: <1550848191.18.0.867642539515.issue36074@roundup.psfhosted.org>


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

Behavior changed in commit c9070d03f5169ad6e171e641b7fa8feab18bf229 (Jan 2018) but has been documented as returning None since 8ebeb03740dad4d9edd65de88f82840a05070941 (Jul 2014).

----------
nosy: +mdk, vstinner, yselivanov

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

From report at bugs.python.org  Fri Feb 22 10:22:31 2019
From: report at bugs.python.org (Julien Palard)
Date: Fri, 22 Feb 2019 15:22:31 +0000
Subject: [docs] [issue36064] docs: urllib.request.Request not accepting
 iterables data type
In-Reply-To: <1550744621.39.0.0634252256257.issue36064@roundup.psfhosted.org>
Message-ID: <1550848951.24.0.186763004961.issue36064@roundup.psfhosted.org>


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


----------
pull_requests: +12013

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

From kai.wassmuss at gmx.de  Fri Feb 22 10:40:18 2019
From: kai.wassmuss at gmx.de (=?UTF-8?B?S2FpIFdhw59tdcOf?=)
Date: Fri, 22 Feb 2019 16:40:18 +0100
Subject: [docs] context argument for multiprocessing.pool.Pool
In-Reply-To: <KG0R-2BsyBsI6ZCNcXn6UZa2heFJZ_-DsXIt7bWXmBIGACC8zYqefN_N0mzrT1Gab5L4vUzRfZJHHPPw3AkTFBeG4BYjhRtkQjViMQaSgf4=@palard.fr>
References: <b7219f0f-3181-9832-6482-c76aee279cf9@gmx.de>
 <KG0R-2BsyBsI6ZCNcXn6UZa2heFJZ_-DsXIt7bWXmBIGACC8zYqefN_N0mzrT1Gab5L4vUzRfZJHHPPw3AkTFBeG4BYjhRtkQjViMQaSgf4=@palard.fr>
Message-ID: <15df7e90-d68f-f308-2712-03bb60faab6c@gmx.de>

Hi,

the problem was that I followed the examples in the docs and used
 >>>> from multiprocessing import Pool
instead of
 >>>> from multiprocessing.pool import Pool
without realizing that those two are different.
This:
"context can be used to specify the context used for starting the worker 
processes. Usually a pool is created using the function 
multiprocessing.Pool() or the Pool() method of a context object. In both 
cases context is set appropriately."
could have given me a hint that I missed something but I tried to submit 
a context argument to the function multiprocessing.Pool directly and 
this function doesn't accept a context argument.

Regards,
Kai

On 22.02.19 15:22, Julien Palard wrote:
> Hi and thanks for reporting!
> 
>> In the actual implementation however there is no argument context.
> 
> I can't "reproduce" this statement:
> 
>>>> from inspect import signature
>>>> from multiprocessing.pool import Pool
>>>> signature(Pool.__init__)
> <Signature (self, processes=None, initializer=None, initargs=(), maxtasksperchild=None, context=None)>
> 
> I see a *context* here, can you be more explicit on how you though it was not here? Bests,
> 
> --
> Julien Palard
> https://mdk.fr
> 
> 


From report at bugs.python.org  Fri Feb 22 10:50:20 2019
From: report at bugs.python.org (STINNER Victor)
Date: Fri, 22 Feb 2019 15:50:20 +0000
Subject: [docs] [issue36074] Result of `asyncio.Server.sockets` after
 `Server.close()` is not clear
In-Reply-To: <1550826860.7.0.550984466305.issue36074@roundup.psfhosted.org>
Message-ID: <1550850620.75.0.50824328139.issue36074@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Fri Feb 22 11:14:52 2019
From: report at bugs.python.org (Kevin Mai-Hsuan Chia)
Date: Fri, 22 Feb 2019 16:14:52 +0000
Subject: [docs] [issue36074] Result of `asyncio.Server.sockets` after
 `Server.close()` is not clear
In-Reply-To: <1550826860.7.0.550984466305.issue36074@roundup.psfhosted.org>
Message-ID: <1550852092.84.0.899060215945.issue36074@roundup.psfhosted.org>


Kevin Mai-Hsuan Chia <kevin at mhchia.com> added the comment:

@mdk That's interesting. May I ask which one is the preferred behavior, `None` or `[]`? IMO both make sense, but `None` is more consistent with the behavior in previous versions. If it is the case, may I work on fixing this(`None` to `[]`) as a practice to contribute? Otherwise, the PR from @eamanu should be enough to fix the document. Thanks a lot for the review and the pointer!

----------

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

From report at bugs.python.org  Fri Feb 22 11:25:32 2019
From: report at bugs.python.org (Emmanuel Arias)
Date: Fri, 22 Feb 2019 16:25:32 +0000
Subject: [docs] [issue36074] Result of `asyncio.Server.sockets` after
 `Server.close()` is not clear
In-Reply-To: <1550826860.7.0.550984466305.issue36074@roundup.psfhosted.org>
Message-ID: <1550852732.6.0.0908358725026.issue36074@roundup.psfhosted.org>


Emmanuel Arias <emmanuelarias30 at gmail.com> added the comment:

> @mdk That's interesting. May I ask which one is the preferred behavior, `None` or `[]`?

IMO changing  the returned of the sockets could represent a big change, and I think that this need to be discuss

----------

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

From report at bugs.python.org  Fri Feb 22 12:34:43 2019
From: report at bugs.python.org (miss-islington)
Date: Fri, 22 Feb 2019 17:34:43 +0000
Subject: [docs] [issue36074] Result of `asyncio.Server.sockets` after
 `Server.close()` is not clear
In-Reply-To: <1550826860.7.0.550984466305.issue36074@roundup.psfhosted.org>
Message-ID: <1550856883.71.0.895716712489.issue36074@roundup.psfhosted.org>


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


New changeset df5cdc11123a35065bbf1636251447d0bfe789a5 by Miss Islington (bot) (Emmanuel Arias) in branch 'master':
bpo-36074: Result of  `asyncio.Server.sockets` after `Server.close()` after  is not clear (GH-11987)
https://github.com/python/cpython/commit/df5cdc11123a35065bbf1636251447d0bfe789a5


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

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

From report at bugs.python.org  Fri Feb 22 12:36:02 2019
From: report at bugs.python.org (Julien Palard)
Date: Fri, 22 Feb 2019 17:36:02 +0000
Subject: [docs] [issue36074] Result of `asyncio.Server.sockets` after
 `Server.close()` is not clear
In-Reply-To: <1550826860.7.0.550984466305.issue36074@roundup.psfhosted.org>
Message-ID: <1550856962.88.0.576220694984.issue36074@roundup.psfhosted.org>


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

Thanks Emmanuel for the PR (yes those PRs do not need NEWS).
Thanks Kevin for the proposition to try fixing it the other way around, that's appreciated, don't hesitate to filter on easy issues there's some others :)

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

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

From report at bugs.python.org  Fri Feb 22 13:42:43 2019
From: report at bugs.python.org (=?utf-8?q?Miro_Hron=C4=8Dok?=)
Date: Fri, 22 Feb 2019 18:42:43 +0000
Subject: [docs] =?utf-8?q?=5Bissue36083=5D_Misformated_manpage=3A_--check?=
 =?utf-8?b?LWhhc2gtYmFzZWQtcHljcyDCtGRlZmF1bHTCtHzCtGFsd2F5c8K0fMK0bmV2?=
 =?utf-8?q?er=C2=B4?=
Message-ID: <1550860963.76.0.541506927126.issue36083@roundup.psfhosted.org>


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

man python3.7 or man python3.8 says this in synopsis:

       python [ -B ] [ -b ] [ -d ] [ -E ] [ -h ] [ -i ] [ -I ]
              [ -m module-name ] [ -q ] [ -O ] [ -OO ] [ -s ] [ -S ] [ -u ]
              [ -v ] [ -V ] [ -W argument ] [ -x ] [ [ -X option ] -?  ]
              [ --check-hash-based-pycs ?default?|?always?|?never? ]
              [ -c command | script | - ] [ arguments ]

Some words are bold, some are underlined. However the ?default?|?always?|?never? bit after --check-hash-based-pycs is misformated. The backticks should not be there, they should be underline instead.

The source literally has:

       [
.B \--check-hash-based-pycs
\'default\'|\'always\'|\'never\'
]

since the original implementation of PEP 552 in 42aa93b8ff2f7879282b06efc73a31ec7785e602

I think it should be replaced with:

       [
.B \--check-hash-based-pycs
.I default|always|never
]

Shall I send a PR?

----------
assignee: docs at python
components: Documentation
messages: 336342
nosy: docs at python, hroncok
priority: normal
severity: normal
status: open
title: Misformated manpage: --check-hash-based-pycs ?default?|?always?|?never?
versions: Python 3.7, Python 3.8

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

From report at bugs.python.org  Fri Feb 22 22:02:12 2019
From: report at bugs.python.org (Alan Grgic)
Date: Sat, 23 Feb 2019 03:02:12 +0000
Subject: [docs] [issue36089] Formatting/Spelling errors in SimpleHTTPServer
 docs
Message-ID: <1550890932.86.0.256234354239.issue36089@roundup.psfhosted.org>


New submission from Alan Grgic <alan.grgic at gmail.com>:

The warning heading near the top of https://docs.python.org/2/library/simplehttpserver.html contains improperly formatted text and misspells SimpleHTTPServer as 'SimpleHTTServer'.

----------
assignee: docs at python
components: Documentation
messages: 336358
nosy: Alan Grgic, docs at python
priority: normal
severity: normal
status: open
title: Formatting/Spelling errors in SimpleHTTPServer docs
versions: Python 2.7

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

From report at bugs.python.org  Fri Feb 22 22:22:45 2019
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 23 Feb 2019 03:22:45 +0000
Subject: [docs] [issue36089] Formatting/Spelling errors in SimpleHTTPServer
 docs
In-Reply-To: <1550890932.86.0.256234354239.issue36089@roundup.psfhosted.org>
Message-ID: <1550892165.52.0.724601645929.issue36089@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Sat Feb 23 00:16:16 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 23 Feb 2019 05:16:16 +0000
Subject: [docs] [issue36089] Formatting/Spelling errors in SimpleHTTPServer
 docs
In-Reply-To: <1550890932.86.0.256234354239.issue36089@roundup.psfhosted.org>
Message-ID: <1550898976.76.0.413369395173.issue36089@roundup.psfhosted.org>


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


New changeset c7be55208b294e408ff625757198419af8914fdf by Serhiy Storchaka (Alan Grgic) in branch '2.7':
bpo-36089: Fix formatting/spelling on SimpleHTTPServer docs. (GH-11995)
https://github.com/python/cpython/commit/c7be55208b294e408ff625757198419af8914fdf


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

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

From report at bugs.python.org  Sat Feb 23 00:27:35 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 23 Feb 2019 05:27:35 +0000
Subject: [docs] [issue36089] Formatting/Spelling errors in SimpleHTTPServer
 docs
In-Reply-To: <1550890932.86.0.256234354239.issue36089@roundup.psfhosted.org>
Message-ID: <1550899655.11.0.290924723375.issue36089@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/issue36089>
_______________________________________

From hugcape at gmail.com  Fri Feb 22 16:19:26 2019
From: hugcape at gmail.com (Hug Capella)
Date: Fri, 22 Feb 2019 21:19:26 +0000
Subject: [docs] documentation bug
Message-ID: <CABrk78G+7H_kbXusx3RHhvvd_=E4pVN0vvxMjHxpag-TtoQZeQ@mail.gmail.com>

at the page with URL:
https://docs.python.org/3/library/stdtypes.html

that text:
Cast 1D/unsigned char to 2D/unsigned long:

should be:
Cast 1D/unsigned long to 2D/unsigned long:

From report at bugs.python.org  Sat Feb 23 15:08:51 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Sat, 23 Feb 2019 20:08:51 +0000
Subject: [docs] =?utf-8?q?=5Bissue36083=5D_Misformated_manpage=3A_--check?=
 =?utf-8?b?LWhhc2gtYmFzZWQtcHljcyDCtGRlZmF1bHTCtHzCtGFsd2F5c8K0fMK0bmV2?=
 =?utf-8?q?er=C2=B4?=
In-Reply-To: <1550860963.76.0.541506927126.issue36083@roundup.psfhosted.org>
Message-ID: <1550952531.52.0.786985635338.issue36083@roundup.psfhosted.org>


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

Thanks for the report, Miro!  Adding Benjamin Peterson to the nosy, since that was his commit.  I'd wait until he comments before making a PR.

----------
nosy: +benjamin.peterson, cheryl.sabella

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

From report at bugs.python.org  Sat Feb 23 17:24:46 2019
From: report at bugs.python.org (Benjamin Peterson)
Date: Sat, 23 Feb 2019 22:24:46 +0000
Subject: [docs] =?utf-8?q?=5Bissue36083=5D_Misformated_manpage=3A_--check?=
 =?utf-8?b?LWhhc2gtYmFzZWQtcHljcyDCtGRlZmF1bHTCtHzCtGFsd2F5c8K0fMK0bmV2?=
 =?utf-8?q?er=C2=B4?=
In-Reply-To: <1550952531.52.0.786985635338.issue36083@roundup.psfhosted.org>
Message-ID: <698ce2de-4477-430e-b9ee-24ddf283581a@www.fastmail.com>


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

A PR would be welcome.

On Sat, Feb 23, 2019, at 12:08, Cheryl Sabella wrote:
> 
> Cheryl Sabella <cheryl.sabella at gmail.com> added the comment:
> 
> Thanks for the report, Miro!  Adding Benjamin Peterson to the nosy, 
> since that was his commit.  I'd wait until he comments before making a 
> PR.
> 
> ----------
> nosy: +benjamin.peterson, cheryl.sabella
> 
> _______________________________________
> Python tracker <report at bugs.python.org>
> <https://bugs.python.org/issue36083>
> _______________________________________
>

----------

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

From report at bugs.python.org  Sat Feb 23 22:03:06 2019
From: report at bugs.python.org (Susan Su)
Date: Sun, 24 Feb 2019 03:03:06 +0000
Subject: [docs] [issue21150] Add quick links table to argparse docs
In-Reply-To: <1396558035.28.0.485991636726.issue21150@psf.upfronthosting.co.za>
Message-ID: <1550977386.29.0.388834237997.issue21150@roundup.psfhosted.org>


Change by Susan Su <susansu.software at gmail.com>:


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

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

From report at bugs.python.org  Sat Feb 23 22:10:57 2019
From: report at bugs.python.org (Susan Su)
Date: Sun, 24 Feb 2019 03:10:57 +0000
Subject: [docs] [issue33043] Add a 'Contributing to Docs' link at the bottom
 of docs.python.org
In-Reply-To: <1520703028.47.0.467229070634.issue33043@psf.upfronthosting.co.za>
Message-ID: <1550977857.66.0.0543849260138.issue33043@roundup.psfhosted.org>


Change by Susan Su <susansu.software at gmail.com>:


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

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

From report at bugs.python.org  Sat Feb 23 22:34:39 2019
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 24 Feb 2019 03:34:39 +0000
Subject: [docs] [issue24310] Idle documentation -- what to do if you do not
 see an underscore.
In-Reply-To: <1432789747.51.0.656358937266.issue24310@psf.upfronthosting.co.za>
Message-ID: <1550979279.6.0.324948141728.issue24310@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Sat Feb 23 22:39:59 2019
From: report at bugs.python.org (Steven D'Aprano)
Date: Sun, 24 Feb 2019 03:39:59 +0000
Subject: [docs] [issue36099] Clarify the difference between mu and xbar in
 the statistics documentation
Message-ID: <1550979599.93.0.0625062939228.issue36099@roundup.psfhosted.org>


New submission from Steven D'Aprano <steve+python at pearwood.info>:

The documentation isn't clear as to the difference between mu and xbar, and why one is used in variance and the other in pvariance.

See #36018 for discussion.

For the record: mu or ? is the population parameter, i.e. the mean of the entire population, if you could average every individual. xbar or x?  is the mean of a sample.

----------
assignee: docs at python
components: Documentation
messages: 336424
nosy: docs at python, steven.daprano
priority: normal
severity: normal
status: open
title: Clarify the difference between mu and xbar in the statistics documentation
type: behavior
versions: Python 3.8

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

From report at bugs.python.org  Sat Feb 23 22:51:27 2019
From: report at bugs.python.org (Ned Deily)
Date: Sun, 24 Feb 2019 03:51:27 +0000
Subject: [docs] [issue24310] Idle documentation -- what to do if you do not
 see an underscore.
In-Reply-To: <1432789747.51.0.656358937266.issue24310@psf.upfronthosting.co.za>
Message-ID: <1550980287.34.0.389074472649.issue24310@roundup.psfhosted.org>


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

Sorry this issue slipped off my radar.  Terry's new PR 12007 provides a more general documentation update such that the I no longer think the tcltk page should be updated.  Removing myself.

----------
assignee: ned.deily -> 
versions: +Python 3.7, Python 3.8 -Python 3.4, Python 3.5, Python 3.6

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

From report at bugs.python.org  Sat Feb 23 22:51:45 2019
From: report at bugs.python.org (Ned Deily)
Date: Sun, 24 Feb 2019 03:51:45 +0000
Subject: [docs] [issue24310] Idle documentation -- what to do if you do not
 see an underscore.
In-Reply-To: <1432789747.51.0.656358937266.issue24310@psf.upfronthosting.co.za>
Message-ID: <1550980305.2.0.695522430121.issue24310@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Sat Feb 23 22:55:57 2019
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 24 Feb 2019 03:55:57 +0000
Subject: [docs] [issue24310] Idle documentation -- what to do if you do not
 see an underscore.
In-Reply-To: <1432789747.51.0.656358937266.issue24310@psf.upfronthosting.co.za>
Message-ID: <1550980557.2.0.537652852142.issue24310@roundup.psfhosted.org>


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

I don't think one 4-years-old anonymous report missing essential details, and not verified since, is sufficient to drive a doc change, especially since the Mac installer has switched from recommending ActiveState 8.5.18 to installing our own compilation of 8.6.8.  

On my MacBook Air with Mohave and 3.7.2, I added 'p__g' to the top of IDLE settings dialog font tab text sample and looked for glitches with various fonts and sizes. The only thing I found was with Optima 13.  The 'g' was the double loop ('eyeglasses') form and a bit of the bottom of the lower loop was gone or thin.  It was still easily recognized and the 'p__' part was unaffected.

I decided to document use of the font sample, including the possibility of changing face and size to avoid glitches.  Since the procedure is generic for any platform or character, I did not specify Mac or 'p_g'.

----------
assignee:  -> terry.reedy
nosy: +ned.deily, terry.reedy
stage: patch review -> 
versions:  -Python 2.7

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

From report at bugs.python.org  Sat Feb 23 22:57:02 2019
From: report at bugs.python.org (Ned Deily)
Date: Sun, 24 Feb 2019 03:57:02 +0000
Subject: [docs] [issue24310] Idle documentation -- what to do if you do not
 see an underscore.
In-Reply-To: <1432789747.51.0.656358937266.issue24310@psf.upfronthosting.co.za>
Message-ID: <1550980622.43.0.693176245197.issue24310@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Sat Feb 23 23:05:00 2019
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 24 Feb 2019 04:05:00 +0000
Subject: [docs] [issue24310] Idle documentation -- what to do if you do not
 see an underscore.
In-Reply-To: <1432789747.51.0.656358937266.issue24310@psf.upfronthosting.co.za>
Message-ID: <1550981100.25.0.974444599222.issue24310@roundup.psfhosted.org>


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


New changeset d610116a2e48b55788b62e11f2e6956af06b3de0 by Terry Jan Reedy in branch 'master':
bpo-24310: Document IDLE settings dialog font tab sample (GH-12007)
https://github.com/python/cpython/commit/d610116a2e48b55788b62e11f2e6956af06b3de0


----------

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

From report at bugs.python.org  Sat Feb 23 23:05:27 2019
From: report at bugs.python.org (miss-islington)
Date: Sun, 24 Feb 2019 04:05:27 +0000
Subject: [docs] [issue24310] Idle documentation -- what to do if you do not
 see an underscore.
In-Reply-To: <1432789747.51.0.656358937266.issue24310@psf.upfronthosting.co.za>
Message-ID: <1550981127.51.0.0139630739763.issue24310@roundup.psfhosted.org>


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


----------
pull_requests: +12039
stage:  -> patch review

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

From report at bugs.python.org  Sat Feb 23 23:23:12 2019
From: report at bugs.python.org (miss-islington)
Date: Sun, 24 Feb 2019 04:23:12 +0000
Subject: [docs] [issue24310] Idle documentation -- what to do if you do not
 see an underscore.
In-Reply-To: <1432789747.51.0.656358937266.issue24310@psf.upfronthosting.co.za>
Message-ID: <1550982192.81.0.043319874435.issue24310@roundup.psfhosted.org>


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


New changeset 38aea4131f57769d2c3d136b09172760db097605 by Miss Islington (bot) in branch '3.7':
bpo-24310: Document IDLE settings dialog font tab sample (GH-12007)
https://github.com/python/cpython/commit/38aea4131f57769d2c3d136b09172760db097605


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

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

From report at bugs.python.org  Sat Feb 23 23:29:54 2019
From: report at bugs.python.org (Ned Deily)
Date: Sun, 24 Feb 2019 04:29:54 +0000
Subject: [docs] [issue33043] Add a 'Contributing to Docs' link at the bottom
 of docs.python.org
In-Reply-To: <1520703028.47.0.467229070634.issue33043@psf.upfronthosting.co.za>
Message-ID: <1550982594.35.0.298575028228.issue33043@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Sat Feb 23 23:56:06 2019
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 24 Feb 2019 04:56:06 +0000
Subject: [docs] [issue24310] Idle documentation -- what to do if you do not
 see an underscore.
In-Reply-To: <1432789747.51.0.656358937266.issue24310@psf.upfronthosting.co.za>
Message-ID: <1550984166.98.0.450888468338.issue24310@roundup.psfhosted.org>


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

From report at bugs.python.org  Sun Feb 24 00:30:53 2019
From: report at bugs.python.org (Davin Potts)
Date: Sun, 24 Feb 2019 05:30:53 +0000
Subject: [docs] [issue36099] Clarify the difference between mu and xbar in
 the statistics documentation
In-Reply-To: <1550979599.93.0.0625062939228.issue36099@roundup.psfhosted.org>
Message-ID: <1550986253.13.0.87734656556.issue36099@roundup.psfhosted.org>


Davin Potts <python at discontinuity.net> added the comment:

Without necessarily defining what each means, perhaps it is sufficient to change this clause in the docs:
    it should be the mean of data

For pvariance() it could read as:
    it should be the *population* mean of data

And for variance() it could read as:
    it should be the *sample* mean of data

----------
nosy: +davin

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

From report at bugs.python.org  Sun Feb 24 01:08:30 2019
From: report at bugs.python.org (Raymond Hettinger)
Date: Sun, 24 Feb 2019 06:08:30 +0000
Subject: [docs] [issue36099] Clarify the difference between mu and xbar in
 the statistics documentation
In-Reply-To: <1550979599.93.0.0625062939228.issue36099@roundup.psfhosted.org>
Message-ID: <1550988510.86.0.898137490477.issue36099@roundup.psfhosted.org>


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

> Without necessarily defining what each means, 
> perhaps it is sufficient to change this clause in the docs

+1 That is a simple way to address the concern.

----------
nosy: +rhettinger

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

From report at bugs.python.org  Sun Feb 24 03:05:25 2019
From: report at bugs.python.org (Steven D'Aprano)
Date: Sun, 24 Feb 2019 08:05:25 +0000
Subject: [docs] [issue36099] Clarify the difference between mu and xbar in
 the statistics documentation
In-Reply-To: <1550979599.93.0.0625062939228.issue36099@roundup.psfhosted.org>
Message-ID: <1550995525.13.0.580743927507.issue36099@roundup.psfhosted.org>


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

I'm happy with that doc change.

If nobody objects, this might make an easy "Good first issue" for the upcoming sprint. Assigning to Cheryl to stop anyone else grabbing it.

----------
assignee: docs at python -> cheryl.sabella
nosy: +cheryl.sabella

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

From hugcape at gmail.com  Sat Feb 23 15:09:34 2019
From: hugcape at gmail.com (Hug Capella)
Date: Sat, 23 Feb 2019 20:09:34 +0000
Subject: [docs] documentation bug
In-Reply-To: <CABrk78G+7H_kbXusx3RHhvvd_=E4pVN0vvxMjHxpag-TtoQZeQ@mail.gmail.com>
References: <CABrk78G+7H_kbXusx3RHhvvd_=E4pVN0vvxMjHxpag-TtoQZeQ@mail.gmail.com>
Message-ID: <CABrk78FGgr=6G5f6putHpioz0qZFq2OKxDB2kOP_arm2100Xew@mail.gmail.com>

at the page with URL:
https://docs.python.org/3/library/re.html

in that paragraph:
\W
    Matches any character which is not a word character. This is the
opposite of \w. If the ASCII flag is used this becomes the equivalent
of [^a-zA-Z0-9_]. If the LOCALE flag is used, matches characters
considered alphanumeric in the current locale and the underscore.

the last sentence should be:
[...] matches characters not considered [...]

From report at bugs.python.org  Sun Feb 24 06:27:48 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 24 Feb 2019 11:27:48 +0000
Subject: [docs] [issue36099] Clarify the difference between mu and xbar in
 the statistics documentation
In-Reply-To: <1550979599.93.0.0625062939228.issue36099@roundup.psfhosted.org>
Message-ID: <1551007668.42.0.00444897367431.issue36099@roundup.psfhosted.org>


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

Great!  Thank you, Steven.

----------

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

From report at bugs.python.org  Sun Feb 24 06:43:31 2019
From: report at bugs.python.org (=?utf-8?q?Miro_Hron=C4=8Dok?=)
Date: Sun, 24 Feb 2019 11:43:31 +0000
Subject: [docs] =?utf-8?q?=5Bissue36083=5D_Misformated_manpage=3A_--check?=
 =?utf-8?b?LWhhc2gtYmFzZWQtcHljcyDCtGRlZmF1bHTCtHzCtGFsd2F5c8K0fMK0bmV2?=
 =?utf-8?q?er=C2=B4?=
In-Reply-To: <1550860963.76.0.541506927126.issue36083@roundup.psfhosted.org>
Message-ID: <1551008611.11.0.401008515323.issue36083@roundup.psfhosted.org>


Change by Miro Hron?ok <miro at hroncok.cz>:


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

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

From report at bugs.python.org  Sun Feb 24 08:32:58 2019
From: report at bugs.python.org (Steven D'Aprano)
Date: Sun, 24 Feb 2019 13:32:58 +0000
Subject: [docs] [issue36100] Document the differences between str.isdigit,
 isdecimal and isnumeric
In-Reply-To: <1550998942.15.0.168903018656.issue36100@roundup.psfhosted.org>
Message-ID: <1551015178.54.0.39080661456.issue36100@roundup.psfhosted.org>


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

I'm re-opening the ticket with a change of subject, because I think this should be treated as a documentation enhancement:

- improve the docstrings for str.isdigit, isnumeric and isdecimal to make it clear what each does (e.g. what counts as a digit);

- similarly improve the documentation for int and float? although the existing comment may be sufficient

https://docs.python.org/3/library/stdtypes.html#numeric-types-int-float-complex

- add a FAQ summarizing the situation.

I don't think we need to worry about backporting the docs to Python 2, but if others disagree, I won't object.

----------
assignee:  -> docs at python
components: +Documentation -Library (Lib)
nosy: +docs at python
resolution: not a bug -> 
stage: resolved -> 
status: closed -> open
title: int() and float() should accept any isnumeric() digit -> Document the differences between str.isdigit, isdecimal and isnumeric
type: behavior -> enhancement
versions:  -Python 2.7, Python 3.4, Python 3.5, Python 3.6, Python 3.7, Python 3.8

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

From report at bugs.python.org  Sun Feb 24 08:36:09 2019
From: report at bugs.python.org (Ma Lin)
Date: Sun, 24 Feb 2019 13:36:09 +0000
Subject: [docs] [issue36101] remove non-ascii characters in docstring
Message-ID: <1551015369.9.0.190424926201.issue36101@roundup.psfhosted.org>


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

replace ?(\u2019) with '(\x27)

----------
assignee: docs at python
components: Documentation
messages: 336468
nosy: Ma Lin, docs at python
priority: normal
severity: normal
status: open
title: remove non-ascii characters in docstring
versions: Python 3.7, Python 3.8

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

From report at bugs.python.org  Sun Feb 24 08:38:03 2019
From: report at bugs.python.org (Ma Lin)
Date: Sun, 24 Feb 2019 13:38:03 +0000
Subject: [docs] [issue36101] remove non-ascii characters in docstring
In-Reply-To: <1551015369.9.0.190424926201.issue36101@roundup.psfhosted.org>
Message-ID: <1551015483.21.0.490406693161.issue36101@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Sun Feb 24 08:45:24 2019
From: report at bugs.python.org (Ma Lin)
Date: Sun, 24 Feb 2019 13:45:24 +0000
Subject: [docs] [issue36101] remove non-ascii characters in docstring
In-Reply-To: <1551015369.9.0.190424926201.issue36101@roundup.psfhosted.org>
Message-ID: <1551015924.9.0.123952957151.issue36101@roundup.psfhosted.org>


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

only 3.8 branch has those non-ascii characters.

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

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

From report at bugs.python.org  Sun Feb 24 08:53:55 2019
From: report at bugs.python.org (Stefan Krah)
Date: Sun, 24 Feb 2019 13:53:55 +0000
Subject: [docs] [issue23460] Decimals do not obey ':g' exponential notation
 formatting rules
In-Reply-To: <1423847721.13.0.666007782647.issue23460@psf.upfronthosting.co.za>
Message-ID: <1551016435.12.0.677323601592.issue23460@roundup.psfhosted.org>


Stefan Krah <stefan at bytereef.org> added the comment:

I just noticed that there are other differences, for example the "removal of trailing zeros" passage does not apply to Decimal:

>>> format(Decimal("1.000000e-6"), "g")
'0.000001000000'

Perhaps it would be easier to have separate docs for float and decimal after all, or a long footnote for decimal.

----------

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

From report at bugs.python.org  Sun Feb 24 09:05:33 2019
From: report at bugs.python.org (Stefan Krah)
Date: Sun, 24 Feb 2019 14:05:33 +0000
Subject: [docs] [issue23460] Decimals do not obey ':g' exponential notation
 formatting rules
In-Reply-To: <1423847721.13.0.666007782647.issue23460@psf.upfronthosting.co.za>
Message-ID: <1551017133.71.0.687674515559.issue23460@roundup.psfhosted.org>


Stefan Krah <stefan at bytereef.org> added the comment:

On the other hand, the docs say "insignificant trailing zeros are removed from the significand", so technically it *is* correct, because trailing zeros are significant in decimal.

----------

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

From report at bugs.python.org  Sun Feb 24 10:51:24 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 24 Feb 2019 15:51:24 +0000
Subject: [docs] [issue11776] Constructor signatures missing in types module
 documentation
In-Reply-To: <1302036805.33.0.506634428921.issue11776@psf.upfronthosting.co.za>
Message-ID: <1551023484.86.0.97975735126.issue11776@roundup.psfhosted.org>


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

@mikehoy, would you be interested in converting your patch to a GitHub pull request?  

For others, please give Mike at least a week to respond before opening a PR with his changes.  

Thank you!

----------
nosy: +cheryl.sabella
versions: +Python 3.7, Python 3.8 -Python 3.4, Python 3.5

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

From report at bugs.python.org  Sun Feb 24 11:06:28 2019
From: report at bugs.python.org (Karthikeyan Singaravelan)
Date: Sun, 24 Feb 2019 16:06:28 +0000
Subject: [docs] [issue32758] Stack overflow when parse long expression to AST
In-Reply-To: <1517682171.17.0.467229070634.issue32758@psf.upfronthosting.co.za>
Message-ID: <1551024388.93.0.815081982132.issue32758@roundup.psfhosted.org>


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

This seems like an easy issue that the warnings in docs for ast need to be manually backported to 2.7 since miss Islington cannot cherry pick two PRs for 2.7 in https://bugs.python.org/issue32758#msg313511 .

----------
nosy: +Mariatta, cheryl.sabella, xtreak

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

From report at bugs.python.org  Sun Feb 24 11:17:20 2019
From: report at bugs.python.org (Emmanuel Arias)
Date: Sun, 24 Feb 2019 16:17:20 +0000
Subject: [docs] [issue11776] Constructor signatures missing in types module
 documentation
In-Reply-To: <1302036805.33.0.506634428921.issue11776@psf.upfronthosting.co.za>
Message-ID: <1551025040.91.0.241396411938.issue11776@roundup.psfhosted.org>


Emmanuel Arias <emmanuelarias30 at gmail.com> added the comment:

> For others, please give Mike at least a week to respond before opening a PR with his changes.  

Okas!

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

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

From report at bugs.python.org  Sun Feb 24 12:25:23 2019
From: report at bugs.python.org (Tz a)
Date: Sun, 24 Feb 2019 17:25:23 +0000
Subject: [docs] [issue11776] Constructor signatures missing in types module
 documentation
In-Reply-To: <1302036805.33.0.506634428921.issue11776@psf.upfronthosting.co.za>
Message-ID: <1551029123.82.0.0248792933188.issue11776@roundup.psfhosted.org>


Change by Tz a <tza0987 at gmail.com>:


----------
nosy: +Tz a

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

From report at bugs.python.org  Sun Feb 24 17:09:25 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Sun, 24 Feb 2019 22:09:25 +0000
Subject: [docs] [issue20265] Bring Windows docs up to date
In-Reply-To: <1389757265.26.0.116885263001.issue20265@psf.upfronthosting.co.za>
Message-ID: <1551046165.46.0.104616899722.issue20265@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Sun Feb 24 17:10:26 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Sun, 24 Feb 2019 22:10:26 +0000
Subject: [docs] [issue23677] Mention dict and set comps in library reference
In-Reply-To: <1426495855.1.0.56894829498.issue23677@psf.upfronthosting.co.za>
Message-ID: <1551046226.57.0.737980348138.issue23677@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Sun Feb 24 17:13:05 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 24 Feb 2019 22:13:05 +0000
Subject: [docs] [issue31035] Document order of firing callbacks added with
 Future.add_done_callback()
In-Reply-To: <1500995618.96.0.99651815805.issue31035@psf.upfronthosting.co.za>
Message-ID: <1551046385.21.0.239860950881.issue31035@roundup.psfhosted.org>


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

The docs for asyncio were rewritten in September 2018.

@socketpair, please take a look at the new documentation and update this ticket if any of your requests are now explained.  If not, would you be able to provide more specific suggestions of what you would like to see included?

Thanks!

----------
assignee: docs at python -> 
nosy: +cheryl.sabella
versions: +Python 3.8 -Python 3.5, Python 3.6

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

From report at bugs.python.org  Sun Feb 24 17:14:24 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Sun, 24 Feb 2019 22:14:24 +0000
Subject: [docs] [issue20923] Explain ConfigParser 'valid section name' and
 .SECTCRE
In-Reply-To: <1394806905.89.0.637343755468.issue20923@psf.upfronthosting.co.za>
Message-ID: <1551046464.57.0.128025353953.issue20923@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Sun Feb 24 17:22:09 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Sun, 24 Feb 2019 22:22:09 +0000
Subject: [docs] [issue23677] Mention dict and set comps in library reference
In-Reply-To: <1426495855.1.0.56894829498.issue23677@psf.upfronthosting.co.za>
Message-ID: <1551046929.02.0.963003410551.issue23677@roundup.psfhosted.org>


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

Assigning to @Mariatta for the CPython mentored sprint.

----------
assignee: docs at python -> Mariatta
nosy: +Mariatta, cheryl.sabella
stage: patch review -> needs patch
versions: +Python 3.7, Python 3.8 -Python 3.5, Python 3.6

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

From report at bugs.python.org  Sun Feb 24 17:39:40 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Sun, 24 Feb 2019 22:39:40 +0000
Subject: [docs] [issue16473] quopri module differences in quoted-printable
 text with whitespace
In-Reply-To: <1352928126.09.0.115783436578.issue16473@psf.upfronthosting.co.za>
Message-ID: <1551047980.49.0.353677098253.issue16473@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Sun Feb 24 17:42:34 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Sun, 24 Feb 2019 22:42:34 +0000
Subject: [docs] [issue18697] Unify arguments names in Unicode object C API
 documentation
In-Reply-To: <1376074126.58.0.40251146149.issue18697@psf.upfronthosting.co.za>
Message-ID: <1551048154.87.0.516897048664.issue18697@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Sun Feb 24 17:53:58 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Sun, 24 Feb 2019 22:53:58 +0000
Subject: [docs] [issue11352] Update cgi module doc
In-Reply-To: <1298895261.86.0.965235067518.issue11352@psf.upfronthosting.co.za>
Message-ID: <1551048838.2.0.0638540681235.issue11352@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Sun Feb 24 17:56:09 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Sun, 24 Feb 2019 22:56:09 +0000
Subject: [docs] [issue13850] Summary tables for argparse add_argument options
In-Reply-To: <1327384498.23.0.981832544617.issue13850@psf.upfronthosting.co.za>
Message-ID: <1551048969.82.0.238098512958.issue13850@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Sun Feb 24 17:59:50 2019
From: report at bugs.python.org (Mark Lawrence)
Date: Sun, 24 Feb 2019 22:59:50 +0000
Subject: [docs] [issue13456] Providing a custom HTTPResponse class to
 HTTPConnection
In-Reply-To: <1321988533.96.0.72454390842.issue13456@psf.upfronthosting.co.za>
Message-ID: <1551049190.13.0.399099875026.issue13456@roundup.psfhosted.org>


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


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

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

From report at bugs.python.org  Sun Feb 24 18:18:52 2019
From: report at bugs.python.org (Inada Naoki)
Date: Sun, 24 Feb 2019 23:18:52 +0000
Subject: [docs] [issue36101] remove non-ascii characters in docstring
In-Reply-To: <1551015369.9.0.190424926201.issue36101@roundup.psfhosted.org>
Message-ID: <1551050332.4.0.468991848855.issue36101@roundup.psfhosted.org>


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


New changeset 463572c8beb59fd9d6850440af48a5c5f4c0c0c9 by Inada Naoki (animalize) in branch 'master':
bpo-36101: remove non-ascii characters in docstring (GH-12018)
https://github.com/python/cpython/commit/463572c8beb59fd9d6850440af48a5c5f4c0c0c9


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

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

From report at bugs.python.org  Sun Feb 24 18:20:06 2019
From: report at bugs.python.org (Inada Naoki)
Date: Sun, 24 Feb 2019 23:20:06 +0000
Subject: [docs] [issue36101] remove non-ascii characters in docstring
In-Reply-To: <1551015369.9.0.190424926201.issue36101@roundup.psfhosted.org>
Message-ID: <1551050406.32.0.886867988286.issue36101@roundup.psfhosted.org>


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

thanks

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

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

From report at bugs.python.org  Sun Feb 24 18:42:44 2019
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 24 Feb 2019 23:42:44 +0000
Subject: [docs] [issue11776] Constructor signatures missing in types module
 documentation
In-Reply-To: <1302036805.33.0.506634428921.issue11776@psf.upfronthosting.co.za>
Message-ID: <1551051764.71.0.291746304507.issue11776@roundup.psfhosted.org>


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

I agree that we should properly document all of the types, even if belately.

A PR is premature until we agree in more detail what 'properly' means.  The most recent patch 'complete-patch...' has multiple errors and needs major revision, to the point that a new patch will be 'based on' rather than 'an edit' of Hoy's work.

1. The table needs to be explained.  It should not just duplicate explanation elsewhere in the doc.  Currently it only lists classes with Python signatures that can be instantiated from Python.  It might make more sense to have a table of types that cannot be instantiated, and not list them elsewhere.

The table seems to be a response to an unreferenced and incomplete (and therefore non-authoritative) suggestion.  We should do what seems best now.

Perhaps there should be two tables for non-callable and callable (from Python) types.  The former without individual entries, the latter with, and with links thereto in the table.

Or perhaps skip tables and just make two subsections for the two groups of types/classes.  There are not currently alphabetical anyway.

2. The types that cannot be instantiated have wrong doc.
"+   This does support direct creation."
This seems to be Nick's
"This type does support direct creation "
However, 'this' referred to ModuleType, not to the 'do not call' type he listed previously.

Correct would be "This type cannot be instantiated by calling it." and I would prefer saying this just once and listing the modules in a table with short explanation.  Table intro might be
"The following types cannot be instantiated by calling them from Python.  Hence no argument signature is given."

3. The wrong initial comments are followed by the wrong 
"Please see :class:`XyzType` (imp.new_module).
Again, these are derived from Nick's comment that only applies to callable ModuleType.

The reference to imp is obsolete as imp is deprecated.  The imp.new_module(name) entry says to use importlib.util.module_from_spec(spec), but a name is not spec.  We don't need to add this; see below.

4. The patch does not touch the ModuleType entry, currently (3.7 online):

 class types.ModuleType(name, doc=None)
    The type of modules. Constructor takes the name of the module to be created and optionally its docstring.

    Note
    Use importlib.util.module_from_spec() to create a new module if you wish to set the various import-controlled attributes.

This looks fine.  The only thing we might change is the awkward 'Constructor takes' to 'A call takes' or something.

----------

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

From report at bugs.python.org  Sun Feb 24 19:50:33 2019
From: report at bugs.python.org (Benjamin Peterson)
Date: Mon, 25 Feb 2019 00:50:33 +0000
Subject: [docs] =?utf-8?q?=5Bissue36083=5D_Misformated_manpage=3A_--check?=
 =?utf-8?b?LWhhc2gtYmFzZWQtcHljcyDCtGRlZmF1bHTCtHzCtGFsd2F5c8K0fMK0bmV2?=
 =?utf-8?q?er=C2=B4?=
In-Reply-To: <1550860963.76.0.541506927126.issue36083@roundup.psfhosted.org>
Message-ID: <1551055833.31.0.625697561761.issue36083@roundup.psfhosted.org>


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


New changeset 16323cb2c3d315e02637cebebdc5ff46be32ecdf by Benjamin Peterson (Miro Hron?ok) in branch 'master':
closes bpo-36083: Fix formatting of the manpage Synopsis. (GH-12017)
https://github.com/python/cpython/commit/16323cb2c3d315e02637cebebdc5ff46be32ecdf


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

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

From report at bugs.python.org  Sun Feb 24 19:50:43 2019
From: report at bugs.python.org (miss-islington)
Date: Mon, 25 Feb 2019 00:50:43 +0000
Subject: [docs] =?utf-8?q?=5Bissue36083=5D_Misformated_manpage=3A_--check?=
 =?utf-8?b?LWhhc2gtYmFzZWQtcHljcyDCtGRlZmF1bHTCtHzCtGFsd2F5c8K0fMK0bmV2?=
 =?utf-8?q?er=C2=B4?=
In-Reply-To: <1550860963.76.0.541506927126.issue36083@roundup.psfhosted.org>
Message-ID: <1551055843.92.0.0196538805105.issue36083@roundup.psfhosted.org>


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


----------
pull_requests: +12058

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

From report at bugs.python.org  Sun Feb 24 19:56:16 2019
From: report at bugs.python.org (miss-islington)
Date: Mon, 25 Feb 2019 00:56:16 +0000
Subject: [docs] =?utf-8?q?=5Bissue36083=5D_Misformated_manpage=3A_--check?=
 =?utf-8?b?LWhhc2gtYmFzZWQtcHljcyDCtGRlZmF1bHTCtHzCtGFsd2F5c8K0fMK0bmV2?=
 =?utf-8?q?er=C2=B4?=
In-Reply-To: <1550860963.76.0.541506927126.issue36083@roundup.psfhosted.org>
Message-ID: <1551056175.98.0.0712561917112.issue36083@roundup.psfhosted.org>


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


New changeset ca5e6aaea5168bff274f3e98d7970bfa1bc366a2 by Miss Islington (bot) in branch '3.7':
closes bpo-36083: Fix formatting of the manpage Synopsis. (GH-12017)
https://github.com/python/cpython/commit/ca5e6aaea5168bff274f3e98d7970bfa1bc366a2


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

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

From bill.tigger at gmail.com  Sun Feb 24 16:20:38 2019
From: bill.tigger at gmail.com (Bill Calvin)
Date: Sun, 24 Feb 2019 16:20:38 -0500
Subject: [docs] Unexpected results from downloading Python 3.7.2 EPUB docs
Message-ID: <CADbcsvhfsrZa-fSaCzGjM3sOVKHE9Tt1CTh1yEBupNkS84ijtg@mail.gmail.com>

Hi,

I downloaded the Python 3.7.2 EPUB Docs from
https://docs.python.org/3/archives/python-3.7.2-docs.epub using windows 10.
After unzipping the file, I found a bunch of xhmtl files.  Is this
correct?  I expected .EPUB files.

Thanks,

Bill Calvin

[image: image.png]
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190224/7dc8c4a8/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image.png
Type: image/png
Size: 35602 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20190224/7dc8c4a8/attachment-0001.png>

From julien at palard.fr  Mon Feb 25 02:45:37 2019
From: julien at palard.fr (Julien Palard)
Date: Mon, 25 Feb 2019 07:45:37 +0000
Subject: [docs] Unexpected results from downloading Python 3.7.2 EPUB
 docs
In-Reply-To: <CADbcsvhfsrZa-fSaCzGjM3sOVKHE9Tt1CTh1yEBupNkS84ijtg@mail.gmail.com>
References: <CADbcsvhfsrZa-fSaCzGjM3sOVKHE9Tt1CTh1yEBupNkS84ijtg@mail.gmail.com>
Message-ID: <gGwMBkBPX8MJtrpKsNCfOYT52mhIOlM9oHtSYKLsReKCVNh6XNg_ZffdBUDko_bH3GwUh7Tsu5n81qqARFZ9RUVt2577DVUYfTnaDwgdo1Q=@palard.fr>

Hi,

> I downloaded the Python 3.7.2 EPUB Docs from https://docs.python.org/3/archives/python-3.7.2-docs.epub using windows 10. After unzipping the file, I found a bunch of xhmtl files.  Is this correct?  I expected .EPUB files.

>From https://docs.python.org/3/archives/python-3.7.2-docs.epub you're getting a single epub file, which is almost what you expected, just don't unzip it. And as you discovered the epub format is "a bunch of xhtml files in a zip" (https://fr.wikipedia.org/wiki/EPUB_%28format%29).

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


From tapio.koskinen at insta.fi  Mon Feb 25 03:00:21 2019
From: tapio.koskinen at insta.fi (Koskinen Tapio)
Date: Mon, 25 Feb 2019 08:00:21 +0000
Subject: [docs] Incorrect documentation in threading.Lock?
In-Reply-To: <RgQfuxCOmseEoKffBGspWaFkdDW2YKYhc6bHDiS9-UX9TGbai0B7P8JQKoVyXVgpiQz3_N_n5IaeIoBctcVMsH-dPZYtnKQFleP9SW6POu0=@palard.fr>
References: <fec663ea26e14011abe901a5fd85a617@mail01.insta.fi>
 <RgQfuxCOmseEoKffBGspWaFkdDW2YKYhc6bHDiS9-UX9TGbai0B7P8JQKoVyXVgpiQz3_N_n5IaeIoBctcVMsH-dPZYtnKQFleP9SW6POu0=@palard.fr>
Message-ID: <006280ba423348d9b480766e41babfb5@mail01.insta.fi>

Hi Julien,

Thank you for the clarification. It took a while but made sense in the end. IMHO it would we clearer if the paragraph explaining the blocking=False -case would not talk about blocking=True but instead referred to lock?s state like you mentioned, but maybe that?s just me.

Thanks,
Tapio Koskinen

From: Julien Palard <julien at palard.fr>
Sent: perjantai 22. helmikuuta 2019 16.40
To: Koskinen Tapio <tapio.koskinen at insta.fi>
Cc: docs at python.org
Subject: Re: [docs] Incorrect documentation in threading.Lock?

Hi Koskinen, thanks for asking!

> Shouldn't the second paragraph's second sentence start with "If a call with blocking set to *False* would block..."?

It would cover an unexisting case: calling with blocking set to *False* won't block anyway, so "if blocking is false would block" is the impossible case, only calls with blocking=True can block.

The idea of those tangled sentences is to state that when the function is called with blocking=False and the lock is already held, the function returns *False*.

Instead of writing "and the lock is already held" the documentation write the equivalent: if the call would have blocked if called with blocking=True ("If a call with blocking set to True would block" in the doc).

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


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190225/29b85a8a/attachment.html>

From report at bugs.python.org  Mon Feb 25 10:58:33 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 25 Feb 2019 15:58:33 +0000
Subject: [docs] [issue28450] Misleading/inaccurate documentation about
 unknown escape sequences in regular expressions
In-Reply-To: <1476529213.17.0.132534478532.issue28450@psf.upfronthosting.co.za>
Message-ID: <1551110313.36.0.791646597658.issue28450@roundup.psfhosted.org>


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


New changeset a180b007d96fe68b32f11dec720fbd0cd5b6758a by Serhiy Storchaka in branch 'master':
bpo-28450: Fix and improve the documentation for unknown escapes in RE. (GH-11920)
https://github.com/python/cpython/commit/a180b007d96fe68b32f11dec720fbd0cd5b6758a


----------

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

From report at bugs.python.org  Mon Feb 25 11:18:04 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 25 Feb 2019 16:18:04 +0000
Subject: [docs] [issue28450] Misleading/inaccurate documentation about
 unknown escape sequences in regular expressions
In-Reply-To: <1476529213.17.0.132534478532.issue28450@psf.upfronthosting.co.za>
Message-ID: <1551111484.1.0.585657408675.issue28450@roundup.psfhosted.org>


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


----------
pull_requests: +12060

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

From report at bugs.python.org  Mon Feb 25 11:28:55 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 25 Feb 2019 16:28:55 +0000
Subject: [docs] [issue28450] Misleading/inaccurate documentation about
 unknown escape sequences in regular expressions
In-Reply-To: <1476529213.17.0.132534478532.issue28450@psf.upfronthosting.co.za>
Message-ID: <1551112135.68.0.677842425391.issue28450@roundup.psfhosted.org>


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


New changeset 95fc8e687c487ecf97f4b1b98dfc0c05e3c9cbff by Serhiy Storchaka in branch '3.7':
[3.7] bpo-28450: Fix and improve the documentation for unknown escapes in RE. (GH-11920). (GH-12029)
https://github.com/python/cpython/commit/95fc8e687c487ecf97f4b1b98dfc0c05e3c9cbff


----------

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

From report at bugs.python.org  Mon Feb 25 11:30:13 2019
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 25 Feb 2019 16:30:13 +0000
Subject: [docs] [issue28450] Misleading/inaccurate documentation about
 unknown escape sequences in regular expressions
In-Reply-To: <1476529213.17.0.132534478532.issue28450@psf.upfronthosting.co.za>
Message-ID: <1551112213.94.0.690209582253.issue28450@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/issue28450>
_______________________________________

From report at bugs.python.org  Mon Feb 25 18:42:27 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Mon, 25 Feb 2019 23:42:27 +0000
Subject: [docs] [issue25337] weakref.finalize documentation refers to old
 interpreter shutdown behavior
In-Reply-To: <1444270840.16.0.813580393824.issue25337@psf.upfronthosting.co.za>
Message-ID: <1551138147.96.0.323600092006.issue25337@roundup.psfhosted.org>


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

Adding @pitrou to the nosylist as he implemented PEP442 in issue 18112.  If he agrees with the proposed change, then I believe this can be marked as 'easy'.

----------
nosy: +cheryl.sabella, pitrou
versions: +Python 3.7, Python 3.8 -Python 3.4, Python 3.5, Python 3.6

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

From report at bugs.python.org  Mon Feb 25 18:54:40 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Mon, 25 Feb 2019 23:54:40 +0000
Subject: [docs] [issue35033] Column or row spanning cells are not
 implemented.
In-Reply-To: <1540052915.48.0.788709270274.issue35033@psf.upfronthosting.co.za>
Message-ID: <1551138880.96.0.99447775812.issue35033@roundup.psfhosted.org>


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

> https://github.com/sphinx-doc/sphinx/pull/5559 has been merged, let's wait for a release of Sphinx and we'll be able to build Python 3.8 documentation as text again.

I tried running the sphinx-build command using Sphinx 1.8.4 and I got the same exception.

Running Sphinx v1.8.4
building [mo]: all of 0 po files
building [text]: all source files
updating environment: 475 added, 0 changed, 0 removed
reading sources... [100%] whatsnew/index
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
preparing documents... done
writing output... [ 12%] c-api/typeobj
Exception occurred:
  File "n:\projects\cpython-venv\lib\site-packages\sphinx\writers\text.py", line 623, in visit_entry
    raise NotImplementedError('Column or row spanning cells are '
NotImplementedError: Column or row spanning cells are not implemented.
The full traceback has been saved in C:\Users\cheka\AppData\Local\Temp\sphinx-err-222wk1in.log, if you want to report the issue to the developers.
Please also report this if it was a user error, so that a better error message can be provided next time.
A bug report can be filed in the tracker at <https://github.com/sphinx-doc/sphinx/issues>. Thanks!

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

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

From report at bugs.python.org  Mon Feb 25 18:56:19 2019
From: report at bugs.python.org (Julien Palard)
Date: Mon, 25 Feb 2019 23:56:19 +0000
Subject: [docs] [issue35033] Column or row spanning cells are not
 implemented.
In-Reply-To: <1540052915.48.0.788709270274.issue35033@psf.upfronthosting.co.za>
Message-ID: <1551138979.23.0.885535002204.issue35033@roundup.psfhosted.org>


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

IIRC this will be released in the next major sphinx version, planned for around march.

----------

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

From report at bugs.python.org  Mon Feb 25 19:08:01 2019
From: report at bugs.python.org (Cheryl Sabella)
Date: Tue, 26 Feb 2019 00:08:01 +0000
Subject: [docs] [issue35033] Column or row spanning cells are not
 implemented.
In-Reply-To: <1540052915.48.0.788709270274.issue35033@psf.upfronthosting.co.za>
Message-ID: <1551139681.57.0.909144073863.issue35033@roundup.psfhosted.org>


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

Apologies, I didn't realize it would be in the major version; I checked since there had been minor release versions since this ticket.  I'll check again once the major release is out.

Thanks!

----------

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

From rahulvinay51 at gmail.com  Tue Feb 26 09:00:41 2019
From: rahulvinay51 at gmail.com (Rahul Babtiwale)
Date: Tue, 26 Feb 2019 19:30:41 +0530
Subject: [docs] Possible Documentation bug: Chapter 8. Errors and Exceptions
Message-ID: <CAOdCNHfA-dVvQY7SVw=NG_8Z=gsmFebfhr9eCrXzNTvTorFdqQ@mail.gmail.com>

Hello,

I was going through the chapter as per the below link :
https://docs.python.org/3/tutorial/errors.html#handling-exceptions

The code shown is as below:

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

- Now as per the above code the statement written below confused me a little:


*"A class in an except
<https://docs.python.org/3/reference/compound_stmts.html#except>
clause is compatible with an exception if it is
the same class or a base class thereof (but not the other way around ? an
except clause listing a derived class is not compatible with a base class)."*

- A class in the except clause is compatible with an exception if it
is the same class: I agree to this.

- However, the next part "or a base class thereof" confused me. Does
this mean that if it is a base class
(i.e a class which inherits from the exception class and is the base
class of all the other classes C & D) only then will it be compatible?

- Because if i reverse the order of the except clauses, the only
prints would be 'B','B' and 'B'.

I think this elaboration needs to be done.

I would request you to provide your insights on this.

Thanks and Regards,

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

From mc4213 at gmail.com  Tue Feb 26 14:33:30 2019
From: mc4213 at gmail.com (Michel Court)
Date: Tue, 26 Feb 2019 20:33:30 +0100
Subject: [docs] problem downloading python's documentation
Message-ID: <CAMA=gfKWccMXU57abeGyT2cVvx3sBeQAS+ie4egJJ78hekDYhw@mail.gmail.com>

Hello,
i would download the python3.6.8 documentation in epub format from your
site, but there's a dead link on your site :
https://docs.python.org/fr/3.6/archives/python-3.6.8-docs.epub

Does the french documentation (in epub format) really exists ?

Thank you so much

-- 
Michel
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190226/7ad0e89b/attachment.html>

From julien at palard.fr  Tue Feb 26 17:03:46 2019
From: julien at palard.fr (Julien Palard)
Date: Tue, 26 Feb 2019 22:03:46 +0000
Subject: [docs] problem downloading python's documentation
In-Reply-To: <CAMA=gfKWccMXU57abeGyT2cVvx3sBeQAS+ie4egJJ78hekDYhw@mail.gmail.com>
References: <CAMA=gfKWccMXU57abeGyT2cVvx3sBeQAS+ie4egJJ78hekDYhw@mail.gmail.com>
Message-ID: <MYfJ_pL09eR4ghVhQt6FWBNvMBoxtF4z2h5p_gk81rMijOmNOfTPaDyjJsd5akjl34eHOzQfsDh3-tLXe81Fn8PHrvNdbKQlLRhbKfg5KAU=@palard.fr>

Hi Michel, thanks for reporting!

I'll have to diagnose this further :( In the meantime it's fixed, you can download the epubs :)

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

From report at bugs.python.org  Wed Feb 27 04:06:01 2019
From: report at bugs.python.org (Jules Lasne)
Date: Wed, 27 Feb 2019 09:06:01 +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: <1551258361.41.0.614010743325.issue35524@roundup.psfhosted.org>


Jules Lasne <jules.lasne at gmail.com> added the comment:

Hi there, any news on this ?

Of course it isn't top priority but might as well do it if you can :)

----------

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

From report at bugs.python.org  Wed Feb 27 08:51:30 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Wed, 27 Feb 2019 13:51:30 +0000
Subject: [docs] [issue13850] Summary tables for argparse add_argument options
In-Reply-To: <1327384498.23.0.981832544617.issue13850@psf.upfronthosting.co.za>
Message-ID: <1551275490.46.0.169330130502.issue13850@roundup.psfhosted.org>


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


----------
pull_requests: +12090

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

From report at bugs.python.org  Wed Feb 27 09:54:37 2019
From: report at bugs.python.org (Paul Ganssle)
Date: Wed, 27 Feb 2019 14:54:37 +0000
Subject: [docs] [issue36138] Improve documentation about converting
 datetime.timedelta to scalars
Message-ID: <1551279277.78.0.420201199405.issue36138@roundup.psfhosted.org>


New submission from Paul Ganssle <p.ganssle at gmail.com>:

In a recent python-dev thread, there was some confusion about how to get something like `timedelta.total_microseconds()`. There is already an existing, supported idiom for this, which is that `timedelta` implements division:

    td = timedelta(hours=1)
    num_microseconds = td / timedelta(microseconds=1)

In this e-mail ( https://mail.python.org/pipermail/python-dev/2019-February/156351.html ), Nick Coghlan proposed that we update the documentation and there were no objections, quoting:

    * In the "Supported Operations" section of https://docs.python.org/3/library/datetime.html#timedelta-objects,
      change "Division (3) of t2 by t3." to "Division (3) of overall
      duration t2 by interval unit t3."
    * In the total_seconds() documentation, add a sentence "For interval units
      other than seconds, use the division form directly (e.g. `td / timedelta(microseconds=1)`)"


I am starting this issue to track that change.

----------
assignee: docs at python
components: Documentation, Library (Lib)
messages: 336765
nosy: belopolsky, docs at python, ncoghlan, p-ganssle
priority: normal
severity: normal
status: open
title: Improve documentation about converting datetime.timedelta to scalars
versions: Python 3.7, Python 3.8

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

From report at bugs.python.org  Wed Feb 27 10:55:39 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Wed, 27 Feb 2019 15:55:39 +0000
Subject: [docs] [issue13850] Summary tables for argparse add_argument options
In-Reply-To: <1327384498.23.0.981832544617.issue13850@psf.upfronthosting.co.za>
Message-ID: <1551282939.2.0.358050829349.issue13850@roundup.psfhosted.org>


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

just for 2.7, 3.7 & 3.8 because they are in bugfix mode.

----------
versions: +Python 3.7, Python 3.8 -Python 3.4, Python 3.5

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

From report at bugs.python.org  Wed Feb 27 11:06:14 2019
From: report at bugs.python.org (Fred L. Drake, Jr.)
Date: Wed, 27 Feb 2019 16:06:14 +0000
Subject: [docs] [issue36138] Improve documentation about converting
 datetime.timedelta to scalars
In-Reply-To: <1551279277.78.0.420201199405.issue36138@roundup.psfhosted.org>
Message-ID: <1551283574.23.0.400158145823.issue36138@roundup.psfhosted.org>


Change by Fred L. Drake, Jr. <fdrake at gmail.com>:


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

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

From report at bugs.python.org  Wed Feb 27 15:32:05 2019
From: report at bugs.python.org (=?utf-8?q?Manuel_Cer=C3=B3n?=)
Date: Wed, 27 Feb 2019 20:32:05 +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: <1551299525.65.0.784144177729.issue23864@roundup.psfhosted.org>


Change by Manuel Cer?n <ceronman at gmail.com>:


----------
nosy: +ceronman

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

From mc4213 at gmail.com  Wed Feb 27 08:44:44 2019
From: mc4213 at gmail.com (Michel Court)
Date: Wed, 27 Feb 2019 14:44:44 +0100
Subject: [docs] problem downloading python's documentation
In-Reply-To: <MYfJ_pL09eR4ghVhQt6FWBNvMBoxtF4z2h5p_gk81rMijOmNOfTPaDyjJsd5akjl34eHOzQfsDh3-tLXe81Fn8PHrvNdbKQlLRhbKfg5KAU=@palard.fr>
References: <CAMA=gfKWccMXU57abeGyT2cVvx3sBeQAS+ie4egJJ78hekDYhw@mail.gmail.com>
 <MYfJ_pL09eR4ghVhQt6FWBNvMBoxtF4z2h5p_gk81rMijOmNOfTPaDyjJsd5akjl34eHOzQfsDh3-tLXe81Fn8PHrvNdbKQlLRhbKfg5KAU=@palard.fr>
Message-ID: <CAMA=gfKZeAA0K6iNdML6imYQaKTC6xpB43=h55pbgR==2eYrPQ@mail.gmail.com>

Great!
Thank you very much !


Le mar. 26 f?vr. 2019 ? 23:03, Julien Palard <julien at palard.fr> a ?crit :

> Hi Michel, thanks for reporting!
>
> I'll have to diagnose this further :( In the meantime it's fixed, you can
> download the epubs :)
>
> Bests,
> --
> Julien Palard
> https://mdk.fr
>
>
>

-- 
Michel
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20190227/9ffb248c/attachment.html>

From report at bugs.python.org  Thu Feb 28 01:37:19 2019
From: report at bugs.python.org (Raymond Hettinger)
Date: Thu, 28 Feb 2019 06:37:19 +0000
Subject: [docs] [issue13850] Summary tables for argparse add_argument options
In-Reply-To: <1327384498.23.0.981832544617.issue13850@psf.upfronthosting.co.za>
Message-ID: <1551335839.39.0.098546687262.issue13850@roundup.psfhosted.org>


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

I like the idea of having various summary tables for argparse, but the one in the PR isn't visually attractive or self-explanatory.

----------

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

From report at bugs.python.org  Thu Feb 28 03:15:59 2019
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Thu, 28 Feb 2019 08:15:59 +0000
Subject: [docs] [issue13850] Summary tables for argparse add_argument options
In-Reply-To: <1327384498.23.0.981832544617.issue13850@psf.upfronthosting.co.za>
Message-ID: <1551341759.78.0.813883655729.issue13850@roundup.psfhosted.org>


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

Hi @Raymond,

Yep, I understand about the "look", I have seen the result after the build of the doc but the patch was like that and I did not want to change the initial patch. 

Would you suggest one layout and I could update the PR with your recommendations?

Thanks for your review

----------

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

From report at bugs.python.org  Thu Feb 28 19:49:32 2019
From: report at bugs.python.org (Sridhar Iyer)
Date: Fri, 01 Mar 2019 00:49:32 +0000
Subject: [docs] [issue36153] Freeze support documentation is misleading.
Message-ID: <1551401372.79.0.134624139836.issue36153@roundup.psfhosted.org>


New submission from Sridhar Iyer <sridhar.v.iyer at gmail.com>:

The documentation on freeze_support listed on https://docs.python.org/3/library/multiprocessing.html need to be fixed

This mentions:
"Calling freeze_support() has no effect when invoked on any operating system other than Windows. In addition, if the module is being run normally by the Python interpreter on Windows (the program has not been frozen), then freeze_support() has no effect."

This is not true. Sklearn/tensorflow libraries tend to cause an infinite loop when frozen with pyinstaller (tested on python 3.6 on ubuntu 14.04). freeze_support is the only way to get around the situation and should be included before including any other module that includes a multiprocessing library (not just in main).

----------
assignee: docs at python
components: Documentation
messages: 336881
nosy: Sridhar Iyer, docs at python
priority: normal
severity: normal
status: open
title: Freeze support documentation is misleading.
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/issue36153>
_______________________________________

From report at bugs.python.org  Thu Feb 28 21:14:29 2019
From: report at bugs.python.org (Windson Yang)
Date: Fri, 01 Mar 2019 02:14:29 +0000
Subject: [docs] [issue36153] Freeze support documentation is misleading.
In-Reply-To: <1551401372.79.0.134624139836.issue36153@roundup.psfhosted.org>
Message-ID: <1551406469.03.0.806127799225.issue36153@roundup.psfhosted.org>


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

IIUC, your script (using Sklearn/tensorflow) will cause an infinite loop when building with pyinstaller. Would you mind upload an example script so I can try to reproduce it?

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

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

From report at bugs.python.org  Thu Feb 28 23:52:37 2019
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 01 Mar 2019 04:52:37 +0000
Subject: [docs] [issue36072] str.translate() behaves differently for
 ASCII-only and other strings
In-Reply-To: <1550813669.37.0.821443537849.issue36072@roundup.psfhosted.org>
Message-ID: <1551415956.99.0.118618592994.issue36072@roundup.psfhosted.org>


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

I agree.  The fact the CPython attempts to optimize all_ascii.translate(table) is a CPython implementation detail, not a language feature.

----------
assignee:  -> docs at python
components: +Documentation
nosy: +docs at python, terry.reedy
resolution:  -> not a bug
stage:  -> resolved
status: open -> closed
type:  -> enhancement

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