From report at bugs.python.org  Tue Sep  1 00:36:06 2015
From: report at bugs.python.org (Matheus Vieira Portela)
Date: Mon, 31 Aug 2015 22:36:06 +0000
Subject: [docs] [issue23406] interning and list comprehension leads to
 unexpected behavior
In-Reply-To: <1423313726.28.0.32804996181.issue23406@psf.upfronthosting.co.za>
Message-ID: <1441060566.16.0.709227780404.issue23406@psf.upfronthosting.co.za>


Matheus Vieira Portela added the comment:

Does anyone else think the note should be expanded? For me, it seems to be pretty accurate although it may indeed be confusing to beginners.

If anything, I can work on rewriting it to be more explanatory.

----------
nosy: +matheus.v.portela

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

From report at bugs.python.org  Tue Sep  1 01:03:57 2015
From: report at bugs.python.org (Matheus Vieira Portela)
Date: Mon, 31 Aug 2015 23:03:57 +0000
Subject: [docs] [issue18697] Unify arguments names in Unicode object C API
 documentation
In-Reply-To: <1376074126.58.0.40251146149.issue18697@psf.upfronthosting.co.za>
Message-ID: <1441062237.08.0.285887042101.issue18697@psf.upfronthosting.co.za>


Matheus Vieira Portela added the comment:

Just checking, it would be required to update Objects/unicodeobject.c, Include/unicodeobject.h, and Doc/c-api/unicode.rst, right?

As far as I saw, "unicode" means a Python object with unicode string, "u" is a UTF-8 encoded C string, "str" and "s" are encoded C strings (UTF-8, UTF-7, ASCII, Latin-1, among others). Is it alright to rename Python unicode objects to "unicode" and the others to simply "str"? These names are more meaningful than the single character alternatives.

The same logic would be applied to the other types, always keeping the longer name rather than the single character ones.

----------
nosy: +matheus.v.portela

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

From report at bugs.python.org  Tue Sep  1 03:49:14 2015
From: report at bugs.python.org (R. David Murray)
Date: Tue, 01 Sep 2015 01:49:14 +0000
Subject: [docs] [issue23406] interning and list comprehension leads to
 unexpected behavior
In-Reply-To: <1423313726.28.0.32804996181.issue23406@psf.upfronthosting.co.za>
Message-ID: <1441072154.45.0.657513007767.issue23406@psf.upfronthosting.co.za>


R. David Murray added the comment:

Interesting.  I usually start with a project's FAQ because I find they usually give me an overview of the project and an indication of its quality :)

The footnote looks very explanatory to me already (complete with examples).  The 'confusing to beginners' text could be made a link to the FAQ, though.

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

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

From report at bugs.python.org  Tue Sep  1 04:14:49 2015
From: report at bugs.python.org (Steven D'Aprano)
Date: Tue, 01 Sep 2015 02:14:49 +0000
Subject: [docs] [issue23406] interning and list comprehension leads to
 unexpected behavior
In-Reply-To: <1441060566.16.0.709227780404.issue23406@psf.upfronthosting.co.za>
Message-ID: <20150901021154.GC19373@ando.pearwood.info>


Steven D'Aprano added the comment:

Which note are you referring to? There are at least two mentioned in 
this thread, the FAQ and a footnote in the docs for stdtypes.

If you're referring to the table of operations just below these:

https://docs.python.org/2/library/stdtypes.html#sequence-types-str-unicode-list-tuple-bytearray-buffer-xrange

https://docs.python.org/3/library/stdtypes.html#common-sequence-operations

where the docs say:

	s * n, n * s	n shallow copies of s concatenated

I think that could be worded better. It is too easy to misread it 
as saying that the items of s are copied (as I just did now, despite 
knowing that they aren't). I would word it:

	repeat s n times and concatenate

which matches the common name of * as the sequence repetition operator, 
and avoids using the word prone to misinterpretation, "copy".

Given how error-prone sequence repetition is, I'd add an example 
directly in the table:

for example, [x]*3 returns [x, x, x] (note that x is not copied).

----------

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

From report at bugs.python.org  Tue Sep  1 05:08:33 2015
From: report at bugs.python.org (Matheus Vieira Portela)
Date: Tue, 01 Sep 2015 03:08:33 +0000
Subject: [docs] [issue23406] interning and list comprehension leads to
 unexpected behavior
In-Reply-To: <1423313726.28.0.32804996181.issue23406@psf.upfronthosting.co.za>
Message-ID: <1441076913.22.0.24475614441.issue23406@psf.upfronthosting.co.za>


Matheus Vieira Portela added the comment:

I was referring to the table of operations.

So, what if I replace "n shallow copies of s concatenated" by "repeat s n times and concatenate (to create a multidimensional list, refer to [link to FAQ])"?

----------

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

From report at bugs.python.org  Tue Sep  1 14:04:07 2015
From: report at bugs.python.org (Eugene)
Date: Tue, 01 Sep 2015 12:04:07 +0000
Subject: [docs] [issue24978] Contributing to Python 2x and 3x Documentation.
 Translation to Russian.
Message-ID: <1441109047.57.0.29993860249.issue24978@psf.upfronthosting.co.za>


New submission from Eugene:

I am very much begging pardon if this is not the place to ask for, but..

I would like to make a thorough translation of the official Library Reference and the beginners guide to Python 2.x 3.x in Russian language.

I am aware this type of translation will be placed at
https://wiki.python.org/moin/RussianLanguage
as current https://docs.python.org/2/ does not allow changing language.

I am pretty much aware the translation should not sound any differently from the original in terms of its style, form and overall attitude. And I would also like to know, if possible, can this link be promoted somewhere at python.org. I am not in the slightest have the intentions of promoting in anywhere but in the place where most russian programmers could most definitely find it - at the oficial Python website.

Kind regards, Evgeniy.

----------
assignee: docs at python
components: Documentation
messages: 249478
nosy: docs at python, overr1de
priority: normal
severity: normal
status: open
title: Contributing to Python 2x and 3x Documentation. Translation to Russian.
type: enhancement
versions: Python 2.7

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

From report at bugs.python.org  Tue Sep  1 17:54:15 2015
From: report at bugs.python.org (R. David Murray)
Date: Tue, 01 Sep 2015 15:54:15 +0000
Subject: [docs] [issue23406] interning and list comprehension leads to
 unexpected behavior
In-Reply-To: <1423313726.28.0.32804996181.issue23406@psf.upfronthosting.co.za>
Message-ID: <1441122855.25.0.170703722493.issue23406@psf.upfronthosting.co.za>


R. David Murray added the comment:

I agree that the table entry could be made more precise.  I would suggest replacing the table entry with "equivalent to adding s to itself n times".  This formulation serves to explain *why* the multiply operation works the way it does:

>>> a = [1, []]
>>> b = a * 4
>>> c = a + a + a + a
>>> b
[1, [], 1, [], 1, [], 1, []]
>>> c
[1, [], 1, [], 1, [], 1, []]
>>> a.append(2)
>>> a
[1, [], 2]
>>> b
[1, [], 1, [], 1, [], 1, []]
>>> c
[1, [], 1, [], 1, [], 1, []]
>>> a[1].append(3)
>>> a
[1, [3], 2]
>>> b
[1, [3], 1, [3], 1, [3], 1, [3]]
>>> c
[1, [3], 1, [3], 1, [3], 1, [3]]

I don't think it is appropriate to put an example in the table; IMO that belongs in the footnote where it currently is.  You could hyperlink the table entry to the FAQ entry, though.

----------

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

From report at bugs.python.org  Tue Sep  1 19:29:16 2015
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 01 Sep 2015 17:29:16 +0000
Subject: [docs] [issue24978] Contributing to Python 2x and 3x Documentation.
 Translation to Russian.
In-Reply-To: <1441109047.57.0.29993860249.issue24978@psf.upfronthosting.co.za>
Message-ID: <1441128556.54.0.261461205585.issue24978@psf.upfronthosting.co.za>


Brett Cannon added the comment:

Is it time we start managing translations somehow? Or at least have a link off of docs.python.org to various translations so they are easier to discover?

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

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

From report at bugs.python.org  Tue Sep  1 19:30:55 2015
From: report at bugs.python.org (Georg Brandl)
Date: Tue, 01 Sep 2015 17:30:55 +0000
Subject: [docs] [issue24978] Contributing to Python 2x and 3x Documentation.
 Translation to Russian.
In-Reply-To: <1441109047.57.0.29993860249.issue24978@psf.upfronthosting.co.za>
Message-ID: <1441128655.75.0.632048232529.issue24978@psf.upfronthosting.co.za>


Georg Brandl added the comment:

Someone will have to step up to manage this effort. The technical side is pretty much solved with sphinx-i18n.

I think this is something the PSF should sponsor. (I wrote a proposal to the board a while ago, but I couldn't find a candidate to do it.)

----------
nosy: +georg.brandl

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

From report at bugs.python.org  Wed Sep  2 18:06:50 2015
From: report at bugs.python.org (Tim Tisdall)
Date: Wed, 02 Sep 2015 16:06:50 +0000
Subject: [docs] [issue24984] document AF_BLUETOOTH socket address formats
Message-ID: <1441210010.76.0.198064903239.issue24984@psf.upfronthosting.co.za>


New submission from Tim Tisdall:

Currently https://docs.python.org/3.6/library/socket.html#socket-families only says "Certain other address families (AF_BLUETOOTH, AF_PACKET, AF_CAN) support specific representations." and there's a comment in the docs saying "document them!"...  So, I'm documenting the AF_BLUETOOTH.

I'm not sure about which versions this should be added to except for 3.6 so I'm listing the pertinent issues when changes were made: 

issue929192 seems to be where the current address format was added for L2CAP, RFCOMM, and SCO

issue1432399 seems to be where HCI was added

issue5510 seems to be where the alternate address format for HCI was added for NetBSD and DragonFlyBSD

It seems SCO used to accept a regular string but at 23ab586c427a it was changed to use a `bytes`...  I'm not sure the issue behind that.


This is my first contribution to CPython so I figured a patch to the docs would be easiest.  Please let me know if I'm doing anything wrong!

----------
assignee: docs at python
components: Documentation
files: bluetooth_socket_docs.patch
keywords: patch
messages: 249554
nosy: Tim.Tisdall, docs at python
priority: normal
severity: normal
status: open
title: document AF_BLUETOOTH socket address formats
Added file: http://bugs.python.org/file40320/bluetooth_socket_docs.patch

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

From report at bugs.python.org  Wed Sep  2 20:13:56 2015
From: report at bugs.python.org (Serhiy Storchaka)
Date: Wed, 02 Sep 2015 18:13:56 +0000
Subject: [docs] [issue23639] Not documented special names
In-Reply-To: <1426072501.09.0.6383465164.issue23639@psf.upfronthosting.co.za>
Message-ID: <1441217636.73.0.390784478775.issue23639@psf.upfronthosting.co.za>


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


----------
dependencies: +Clarify documentation of __getinitargs__, __self__ on built-in functions is not as documented

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

From report at bugs.python.org  Wed Sep  2 21:00:03 2015
From: report at bugs.python.org (Matheus Vieira Portela)
Date: Wed, 02 Sep 2015 19:00:03 +0000
Subject: [docs] [issue23406] interning and list comprehension leads to
 unexpected behavior
In-Reply-To: <1423313726.28.0.32804996181.issue23406@psf.upfronthosting.co.za>
Message-ID: <1441220403.72.0.796371387104.issue23406@psf.upfronthosting.co.za>


Matheus Vieira Portela added the comment:

I'm attaching a patch to update the stdtypes.rst documentation according to our discussion. I've replaced the table explanation to "equivalent to adding s to itself n times" and added a link to the FAQ entry.

I'm not sure, however, where to put the FAQ link. Should it be directly in the table? In this patch, I've put it after the last line of note #2.

----------
keywords: +patch
Added file: http://bugs.python.org/file40321/issue23406_doc_stdtypes.patch

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

From vadmium+py at gmail.com  Wed Sep  2 23:40:56 2015
From: vadmium+py at gmail.com (vadmium+py at gmail.com)
Date: Wed, 02 Sep 2015 21:40:56 -0000
Subject: [docs] interning and list comprehension leads to unexpected
	behavior (issue 23406)
Message-ID: <20150902214056.28807.53800@psf.upfronthosting.co.za>


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

https://bugs.python.org/review/23406/diff/15454/Doc/library/stdtypes.rst#newcode900
Doc/library/stdtypes.rst:900: sequence of the same type as *s*).  Note
also that the copies are shallow;
Objects are not even shallow-copied in the usual sense. Perhaps
something like this is better:

(.?. . same type as *s*). The *s* object is not copied; it is merely
referenced multiple times. This often haunts .?.?.

https://bugs.python.org/review/23406/diff/15454/Doc/library/stdtypes.rst#newcode924
Doc/library/stdtypes.rst:924: `FAQ
<https://docs.python.org/3/faq/programming.html#how-do-i-create-a-multidimensional-list>`_.
It will be better to do an internal link within the same copy of the
documentation. See
<https://docs.python.org/devguide/documenting.html#doc-ref-role>. In
particular, add something like this before the heading in
/Doc/faq/programming.rst:

.. _faq-multidimensional-list:

And then change the code here to

Further explanation is available in the FAQ entry
:ref:`faq-multidimensional-list`.

which should expand to the full heading title.

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

From report at bugs.python.org  Wed Sep  2 23:42:23 2015
From: report at bugs.python.org (Martin Panter)
Date: Wed, 02 Sep 2015 21:42:23 +0000
Subject: [docs] [issue23406] interning and list comprehension leads to
 unexpected behavior
In-Reply-To: <1423313726.28.0.32804996181.issue23406@psf.upfronthosting.co.za>
Message-ID: <1441230143.67.0.174640907969.issue23406@psf.upfronthosting.co.za>


Martin Panter added the comment:

Left some review comments. The positioning of the link to the FAQ entry seems sensible to me, just that the markup could be better :)

----------
nosy: +martin.panter
stage: needs patch -> patch review
versions: +Python 3.6

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

From report at bugs.python.org  Thu Sep  3 00:35:00 2015
From: report at bugs.python.org (Martin Panter)
Date: Wed, 02 Sep 2015 22:35:00 +0000
Subject: [docs] [issue24984] document AF_BLUETOOTH socket address formats
In-Reply-To: <1441210010.76.0.198064903239.issue24984@psf.upfronthosting.co.za>
Message-ID: <1441233300.69.0.162125892009.issue24984@psf.upfronthosting.co.za>


Martin Panter added the comment:

Thanks for the patch and the archeological research. I made some minor grammar nitpicks in the code review.

Documentation typically gets applied to all the open branches. In this case 3.4?3.6 should be applicable. Maybe 2.7 also if you are interested; it may need a modified patch though, with different notices about the versions things were introduced.

Sounds like most of these addresses were added in 2.4, so no need for a ?New in version? notice unless you add a 2.7 doc patch. But it maybe be useful to mention that the BSD support was added in 3.2.

Regarding revision 23ab586c427a (?Renamed PyString to PyBytes?, 2008), I haven?t checked, but you will probably find that was made before Python 3 was released, so it is just one of those differences between Python 2 and 3.

----------
nosy: +martin.panter
stage:  -> patch review
versions: +Python 3.4, Python 3.5, Python 3.6

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

From vadmium+py at gmail.com  Thu Sep  3 00:02:37 2015
From: vadmium+py at gmail.com (vadmium+py at gmail.com)
Date: Wed, 02 Sep 2015 22:02:37 -0000
Subject: [docs] document AF_BLUETOOTH socket address formats (issue 24984)
Message-ID: <20150902220237.28807.74385@psf.upfronthosting.co.za>


https://bugs.python.org/review/24984/diff/15453/Doc/library/socket.rst
File Doc/library/socket.rst (right):

https://bugs.python.org/review/24984/diff/15453/Doc/library/socket.rst#newcode120
Doc/library/socket.rst:120: interface (This depending on your OS; NetBSD
and DragonFlyBSD expects
Minor grammar fixes: Add a full stop: ?interface.? Move the other one
inside the brackets: ?(. . . an integer.)? Also, no S for ?expect?.

Also, I think ?This depends on the OS . . .? would be easier to read
(less assuming).

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

From report at bugs.python.org  Thu Sep  3 14:22:24 2015
From: report at bugs.python.org (Matheus Vieira Portela)
Date: Thu, 03 Sep 2015 12:22:24 +0000
Subject: [docs] [issue23406] interning and list comprehension leads to
 unexpected behavior
In-Reply-To: <1423313726.28.0.32804996181.issue23406@psf.upfronthosting.co.za>
Message-ID: <1441282944.34.0.335285884035.issue23406@psf.upfronthosting.co.za>


Matheus Vieira Portela added the comment:

Applying review comments. Now, there is an internal link to the FAQ entry on multidimensional lists.

----------
Added file: http://bugs.python.org/file40337/issue23406_doc_stdtypes_and_faq.patch

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

From report at bugs.python.org  Thu Sep  3 16:09:11 2015
From: report at bugs.python.org (Tim Tisdall)
Date: Thu, 03 Sep 2015 14:09:11 +0000
Subject: [docs] [issue24984] document AF_BLUETOOTH socket address formats
In-Reply-To: <1441210010.76.0.198064903239.issue24984@psf.upfronthosting.co.za>
Message-ID: <1441289351.45.0.835467886929.issue24984@psf.upfronthosting.co.za>


Tim Tisdall added the comment:

I'm not sure the proper way to update the patch... I can't seem to edit the existing one or replace it.  I'm uploading an updated one, but should I simply "unlink" (aka delete) the old one?

----------
Added file: http://bugs.python.org/file40339/bluetooth_socket_docs_2.patch

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

From report at bugs.python.org  Thu Sep  3 16:25:50 2015
From: report at bugs.python.org (Tim Tisdall)
Date: Thu, 03 Sep 2015 14:25:50 +0000
Subject: [docs] [issue24984] document AF_BLUETOOTH socket address formats
In-Reply-To: <1441210010.76.0.198064903239.issue24984@psf.upfronthosting.co.za>
Message-ID: <1441290350.26.0.26316988011.issue24984@psf.upfronthosting.co.za>


Tim Tisdall added the comment:

Martin, the odd thing with the SCO protocol is it's expecting an bluetooth address as a byte string (ex b'12:23:34:45:56:67' [note the `b`]) where the other 3 are expecting a regular string (ex '12:23:34:45:56:67').  I think it may have been a case of someone doing a blanket search-and-replace and missing the consequences there, but I'm really not sure.  However, this is somewhat besides the point as right now I'm trying to focus on just documenting the actual behaviour.  ;)

The issue is, what versions have the changes from 23ab586c427a in it, and what versions come before that where it's probably expecting a regular string.  Unfortunately I can't access the web interface for the repo at the moment so I can't even try to figure that out at right now.  (Though, I haven't confirmed that the old method was looking at regular strings or not...)

----------

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

From report at bugs.python.org  Thu Sep  3 16:33:29 2015
From: report at bugs.python.org (Tim Tisdall)
Date: Thu, 03 Sep 2015 14:33:29 +0000
Subject: [docs] [issue24984] document AF_BLUETOOTH socket address formats
In-Reply-To: <1441210010.76.0.198064903239.issue24984@psf.upfronthosting.co.za>
Message-ID: <1441290809.81.0.187344303608.issue24984@psf.upfronthosting.co.za>


Tim Tisdall added the comment:

I'm not really sure how to add a `versionadded` tag to specify that only the BSD-specific support was added in 3.2 (as general support was there prior to that).  If I just add the plain tag below that bullet point it would imply that the whole protocol was added in 3.2 .

Perhaps I should reword it to just list the original (prior to 3.2) documentation, then add the difference with BSD in a separate paragraph such that I can tag just that part?  Or maybe I shouldn't bother?

----------

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

From report at bugs.python.org  Thu Sep  3 17:03:17 2015
From: report at bugs.python.org (Tim Tisdall)
Date: Thu, 03 Sep 2015 15:03:17 +0000
Subject: [docs] [issue24984] document AF_BLUETOOTH socket address formats
In-Reply-To: <1441210010.76.0.198064903239.issue24984@psf.upfronthosting.co.za>
Message-ID: <1441292597.37.0.947583363473.issue24984@psf.upfronthosting.co.za>


Tim Tisdall added the comment:

I added a note to BTPROTO_SCO that it doesn't work in FreeBSD (I forgot to mention that).

----------
Added file: http://bugs.python.org/file40341/bluetooth_socket_docs_3.patch

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

From guettliml at thomas-guettler.de  Thu Sep  3 17:03:39 2015
From: guettliml at thomas-guettler.de (=?UTF-8?Q?Thomas_G=c3=bcttler?=)
Date: Thu, 3 Sep 2015 17:03:39 +0200
Subject: [docs] htmllib is deprecated: Newcomers need more advice
Message-ID: <55E8614B.9010007@thomas-guettler.de>

At the top of the htmllib module:

{{{
Deprecated since version 2.6: The htmllib module has been removed in Python 3.
}}}

Source: https://docs.python.org/2/library/htmllib.html#module-htmllib


Newcomers need more advice: Which library should be used?

I know there are many html parsing libraries.

But there should be a sane default for newcomers.

Is there already an agreement of a sane default html parsing library?

Regards,
   Thomas G?ttler

-- 
Thomas Guettler http://www.thomas-guettler.de/

From report at bugs.python.org  Thu Sep  3 17:14:34 2015
From: report at bugs.python.org (R. David Murray)
Date: Thu, 03 Sep 2015 15:14:34 +0000
Subject: [docs] [issue23406] interning and list comprehension leads to
 unexpected behavior
In-Reply-To: <1423313726.28.0.32804996181.issue23406@psf.upfronthosting.co.za>
Message-ID: <1441293274.23.0.647984121752.issue23406@psf.upfronthosting.co.za>


R. David Murray added the comment:

Looks good to me.

----------

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

From report at bugs.python.org  Thu Sep  3 17:23:45 2015
From: report at bugs.python.org (Tim Tisdall)
Date: Thu, 03 Sep 2015 15:23:45 +0000
Subject: [docs] [issue24984] document AF_BLUETOOTH socket address formats
In-Reply-To: <1441210010.76.0.198064903239.issue24984@psf.upfronthosting.co.za>
Message-ID: <1441293825.82.0.109429999649.issue24984@psf.upfronthosting.co.za>


Tim Tisdall added the comment:

changed "This protocol does not work under FreeBSD." to the more accurate "This protocol is not supported under FreeBSD."

----------
Added file: http://bugs.python.org/file40343/bluetooth_socket_docs_4.patch

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

From report at bugs.python.org  Thu Sep  3 17:55:41 2015
From: report at bugs.python.org (R. David Murray)
Date: Thu, 03 Sep 2015 15:55:41 +0000
Subject: [docs] [issue24984] document AF_BLUETOOTH socket address formats
In-Reply-To: <1441210010.76.0.198064903239.issue24984@psf.upfronthosting.co.za>
Message-ID: <1441295741.4.0.654050470592.issue24984@psf.upfronthosting.co.za>


R. David Murray added the comment:

Uploading new patches is correct.  We generally don't unlink the old ones unless the history starts to get really confusing.

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

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

From report at bugs.python.org  Fri Sep  4 07:11:54 2015
From: report at bugs.python.org (Paul Clarke)
Date: Fri, 04 Sep 2015 05:11:54 +0000
Subject: [docs] [issue24998] docs: subprocess.Popen example has
 extra/invalid parameter
Message-ID: <1441343514.48.0.676306018011.issue24998@psf.upfronthosting.co.za>


New submission from Paul Clarke:

in "subprocess" module documentation has a section for "replacing older functions with subprocess", specifically 17.1.4.5 "replacing os.popen", which includes the example on "return code handling", specifically this line:
--
process = Popen("cmd", 'w', shell=True, stdin=PIPE)
--

That 'w' shouldn't be there.

----------
assignee: docs at python
components: Documentation
messages: 249716
nosy: Paul Clarke, docs at python
priority: normal
severity: normal
status: open
title: docs: subprocess.Popen example has extra/invalid parameter
versions: Python 2.7

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

From report at bugs.python.org  Fri Sep  4 08:53:14 2015
From: report at bugs.python.org (eryksun)
Date: Fri, 04 Sep 2015 06:53:14 +0000
Subject: [docs] [issue24998] docs: subprocess.Popen example has
 extra/invalid parameter
In-Reply-To: <1441343514.48.0.676306018011.issue24998@psf.upfronthosting.co.za>
Message-ID: <1441349594.32.0.825526970776.issue24998@psf.upfronthosting.co.za>


Changes by eryksun <eryksun at gmail.com>:


----------
keywords: +easy
priority: normal -> low
versions: +Python 3.4, Python 3.5, Python 3.6

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

From report at bugs.python.org  Fri Sep  4 09:09:16 2015
From: report at bugs.python.org (Larry Hastings)
Date: Fri, 04 Sep 2015 07:09:16 +0000
Subject: [docs] [issue23623] Python 3.5 docs need to clarify how to set PATH,
	etc
In-Reply-To: <1425910467.52.0.177540191477.issue23623@psf.upfronthosting.co.za>
Message-ID: <1441350556.26.0.961820851531.issue23623@psf.upfronthosting.co.za>


Larry Hastings added the comment:

Can we close this out?

----------
nosy: +larry

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

From report at bugs.python.org  Fri Sep  4 10:55:47 2015
From: report at bugs.python.org (Ezio Melotti)
Date: Fri, 04 Sep 2015 08:55:47 +0000
Subject: [docs] [issue23144] html.parser.HTMLParser: setting
 'convert_charrefs = True' leads to dropped text
In-Reply-To: <1420138028.63.0.996553076818.issue23144@psf.upfronthosting.co.za>
Message-ID: <1441356947.7.0.388236634863.issue23144@psf.upfronthosting.co.za>


Ezio Melotti added the comment:

I'll try to take care of this during the weekend.
Feel free to ping me if I don't.

----------

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

From report at bugs.python.org  Fri Sep  4 11:53:33 2015
From: report at bugs.python.org (Paul Moore)
Date: Fri, 04 Sep 2015 09:53:33 +0000
Subject: [docs] [issue23623] Python 3.5 docs need to clarify how to set PATH,
	etc
In-Reply-To: <1425910467.52.0.177540191477.issue23623@psf.upfronthosting.co.za>
Message-ID: <1441360413.06.0.87696955302.issue23623@psf.upfronthosting.co.za>


Paul Moore added the comment:

Now that "Add Python to PATH" is an option on the front screen of the installer (not hidden behind the scary "customize" option) this can be closed.

I recall Steve suggesting there might be issues with the way a user install results in the path entries coming after the system path, but let's not worry about those unless we get specific issue reports.

----------
priority: deferred blocker -> normal
resolution:  -> fixed
status: open -> closed

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

From report at bugs.python.org  Fri Sep  4 13:48:46 2015
From: report at bugs.python.org (Martin Panter)
Date: Fri, 04 Sep 2015 11:48:46 +0000
Subject: [docs] [issue23406] interning and list comprehension leads to
 unexpected behavior
In-Reply-To: <1423313726.28.0.32804996181.issue23406@psf.upfronthosting.co.za>
Message-ID: <1441367326.63.0.570144590857.issue23406@psf.upfronthosting.co.za>


Martin Panter added the comment:

I was about to commit this, but I think I was wrong about one of my comments. The list that is multiplied is indeed shallow-copied. E.g. ?[x] * 1? copies the list, but the reference to x is the same. I propose to commit the second patch, except to revert one of the sentences to the first patch, so it reads:

Note also that the copies are shallow; nested structures are not copied but referenced.

----------

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

From report at bugs.python.org  Fri Sep  4 16:03:44 2015
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 04 Sep 2015 14:03:44 +0000
Subject: [docs] [issue24998] docs: subprocess.Popen example has
 extra/invalid parameter
In-Reply-To: <1441343514.48.0.676306018011.issue24998@psf.upfronthosting.co.za>
Message-ID: <20150904140341.12017.66883@psf.io>


Roundup Robot added the comment:

New changeset 0ff7aa9a438f by R David Murray in branch '2.7':
#24998: fix cut and paste error in subprocess example.
https://hg.python.org/cpython/rev/0ff7aa9a438f

New changeset 47e711a7416b by R David Murray in branch '3.4':
#24998: fix cut and paste error in subprocess example.
https://hg.python.org/cpython/rev/47e711a7416b

New changeset fa53edb32962 by R David Murray in branch '3.5':
Merge: #24998: fix cut and paste error in subprocess example.
https://hg.python.org/cpython/rev/fa53edb32962

New changeset 75e10a5cbf43 by R David Murray in branch 'default':
Merge: #24998: fix cut and paste error in subprocess example.
https://hg.python.org/cpython/rev/75e10a5cbf43

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

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

From report at bugs.python.org  Fri Sep  4 16:05:52 2015
From: report at bugs.python.org (R. David Murray)
Date: Fri, 04 Sep 2015 14:05:52 +0000
Subject: [docs] [issue24998] docs: subprocess.Popen example has
 extra/invalid parameter
In-Reply-To: <1441343514.48.0.676306018011.issue24998@psf.upfronthosting.co.za>
Message-ID: <1441375552.89.0.198339312677.issue24998@psf.upfronthosting.co.za>


R. David Murray added the comment:

Thanks for the report.  I'm surprised that hasn't been noticed before.  I'm also wondering why the 'shell=True' was removed from the example in the python3 docs (and why whoever did that didn't notice the bug :), but that would be a separate issue (someone would need to figure out why the change was made before undoing it...)

----------
nosy: +r.david.murray
resolution:  -> fixed
stage:  -> resolved
status: open -> closed

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

From report at bugs.python.org  Fri Sep  4 16:23:13 2015
From: report at bugs.python.org (R. David Murray)
Date: Fri, 04 Sep 2015 14:23:13 +0000
Subject: [docs] [issue23406] interning and list comprehension leads to
 unexpected behavior
In-Reply-To: <1423313726.28.0.32804996181.issue23406@psf.upfronthosting.co.za>
Message-ID: <1441376593.04.0.101670870642.issue23406@psf.upfronthosting.co.za>


R. David Murray added the comment:

What is actually happening is that the *contents* of the list are copied, but the list itself is not.  This is a consequence of the definition in terms of +.  So, yes, that is a shallow copy, but not quite in the sense that mylist.copy() is a shallow copy, since the references to the contents of s get appended to the list being constructed by *, not a new list that is a "copy" of s.

You are correct that "s is only referenced" is not really accurate.  But how about "Note that the contents of the *s* object are not copied, they are referenced multiple times".  I think that highlights the source of the confusion: that the *contents* are not copied.

----------

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

From report at bugs.python.org  Fri Sep  4 16:24:50 2015
From: report at bugs.python.org (R. David Murray)
Date: Fri, 04 Sep 2015 14:24:50 +0000
Subject: [docs] [issue23406] interning and list comprehension leads to
 unexpected behavior
In-Reply-To: <1423313726.28.0.32804996181.issue23406@psf.upfronthosting.co.za>
Message-ID: <1441376690.58.0.407548565848.issue23406@psf.upfronthosting.co.za>


R. David Murray added the comment:

Sorry, I meant "references to the content are copied" in my first sentence there.  This just goes to show why this is complicated to explain :)

----------

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

From report at bugs.python.org  Fri Sep  4 20:13:16 2015
From: report at bugs.python.org (R. David Murray)
Date: Fri, 04 Sep 2015 18:13:16 +0000
Subject: [docs] [issue23406] interning and list comprehension leads to
 unexpected behavior
In-Reply-To: <1423313726.28.0.32804996181.issue23406@psf.upfronthosting.co.za>
Message-ID: <1441390395.44.0.402840751485.issue23406@psf.upfronthosting.co.za>


R. David Murray added the comment:

Or better, "items in the list *s* are not copied..."

----------

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

From report at bugs.python.org  Sat Sep  5 01:34:54 2015
From: report at bugs.python.org (Wenzel Jakob)
Date: Fri, 04 Sep 2015 23:34:54 +0000
Subject: [docs] [issue25006] List pybind11 binding generator
Message-ID: <1441409694.33.0.221981890825.issue25006@psf.upfronthosting.co.za>


New submission from Wenzel Jakob:

Hi,

over the last few months, I've been developing a library ("pybind11") for creating Python bindings of C++ code. It is similar in spirit to Boost.Python but uses a very different minimalist approach.

It would be fantastic to get this library listed here: https://docs.python.org/3/faq/extending.html

The purpose of this ticket is that somebody with permissions might add it to this page.

pybind11 is here: https://github.com/wjakob/pybind11

Please let me know if you need any additional information.

Thank you,
Wenzel

----------
assignee: docs at python
components: Documentation
messages: 249865
nosy: docs at python, wenzel
priority: normal
severity: normal
status: open
title: List pybind11 binding generator
type: enhancement
versions: Python 2.7, Python 3.2, Python 3.3, Python 3.4, Python 3.5, Python 3.6

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

From report at bugs.python.org  Sat Sep  5 07:07:53 2015
From: report at bugs.python.org (Martin Panter)
Date: Sat, 05 Sep 2015 05:07:53 +0000
Subject: [docs] [issue23406] interning and list comprehension leads to
 unexpected behavior
In-Reply-To: <1423313726.28.0.32804996181.issue23406@psf.upfronthosting.co.za>
Message-ID: <1441429673.81.0.86258620331.issue23406@psf.upfronthosting.co.za>


Martin Panter added the comment:

That works for me. Here is a new patch using David?s new wording.

----------
Added file: http://bugs.python.org/file40369/issue23406_doc_stdtypes.v3.patch

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

From report at bugs.python.org  Sat Sep  5 07:51:03 2015
From: report at bugs.python.org (Martin Panter)
Date: Sat, 05 Sep 2015 05:51:03 +0000
Subject: [docs] [issue24984] document AF_BLUETOOTH socket address formats
In-Reply-To: <1441210010.76.0.198064903239.issue24984@psf.upfronthosting.co.za>
Message-ID: <1441432263.29.0.0687897557368.issue24984@psf.upfronthosting.co.za>


Martin Panter added the comment:

Here is a suggestion of how to add a versionchanged tag. Let me know if it is accurate or not. (I?m not actually familiar with the history.)

----------
Added file: http://bugs.python.org/file40370/bluetooth_socket_docs_5.patch

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

From report at bugs.python.org  Sat Sep  5 19:36:46 2015
From: report at bugs.python.org (Shaun Walbridge)
Date: Sat, 05 Sep 2015 17:36:46 +0000
Subject: [docs] [issue25010] minor typo in PCBuild readme.txt
Message-ID: <1441474606.12.0.269999159131.issue25010@psf.upfronthosting.co.za>


New submission from Shaun Walbridge:

A minor documentation fix. Currently, the top-level PCBuild readme.txt mentions in the final section 'Your Own Extension DLLs' that the example project is located in ../PC/example/, but the example location is ../PC/example_nt/.

----------
assignee: docs at python
components: Documentation
files: pyd-typo.diff
keywords: patch
messages: 249915
nosy: docs at python, scw
priority: normal
severity: normal
status: open
title: minor typo in PCBuild readme.txt
type: enhancement
versions: Python 3.5
Added file: http://bugs.python.org/file40374/pyd-typo.diff

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

From report at bugs.python.org  Sun Sep  6 20:55:36 2015
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 06 Sep 2015 18:55:36 +0000
Subject: [docs] [issue23144] html.parser.HTMLParser: setting
 'convert_charrefs = True' leads to dropped text
In-Reply-To: <1420138028.63.0.996553076818.issue23144@psf.upfronthosting.co.za>
Message-ID: <20150906185533.11262.98006@psf.io>


Roundup Robot added the comment:

New changeset ef82131d0c93 by Ezio Melotti in branch '3.4':
#23144: Make sure that HTMLParser.feed() returns all the data, even when convert_charrefs is True.
https://hg.python.org/cpython/rev/ef82131d0c93

New changeset 1f6155ffcaf6 by Ezio Melotti in branch '3.5':
#23144: merge with 3.4.
https://hg.python.org/cpython/rev/1f6155ffcaf6

New changeset 48ae9d66c720 by Ezio Melotti in branch 'default':
#23144: merge with 3.5.
https://hg.python.org/cpython/rev/48ae9d66c720

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

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

From report at bugs.python.org  Sun Sep  6 20:56:30 2015
From: report at bugs.python.org (Ezio Melotti)
Date: Sun, 06 Sep 2015 18:56:30 +0000
Subject: [docs] [issue23144] html.parser.HTMLParser: setting
 'convert_charrefs = True' leads to dropped text
In-Reply-To: <1420138028.63.0.996553076818.issue23144@psf.upfronthosting.co.za>
Message-ID: <1441565790.47.0.15300649897.issue23144@psf.upfronthosting.co.za>


Ezio Melotti added the comment:

Fixed, thanks for the report!

----------
resolution:  -> fixed
stage: commit review -> resolved
status: open -> closed
versions: +Python 3.6 -Python 2.7

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

From report at bugs.python.org  Sun Sep  6 22:24:17 2015
From: report at bugs.python.org (R. David Murray)
Date: Sun, 06 Sep 2015 20:24:17 +0000
Subject: [docs] [issue23406] interning and list comprehension leads to
 unexpected behavior
In-Reply-To: <1423313726.28.0.32804996181.issue23406@psf.upfronthosting.co.za>
Message-ID: <1441571057.36.0.567386586753.issue23406@psf.upfronthosting.co.za>


R. David Murray added the comment:

Looks good to me.

----------

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

From report at bugs.python.org  Mon Sep  7 04:18:14 2015
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 07 Sep 2015 02:18:14 +0000
Subject: [docs] [issue23406] interning and list comprehension leads to
 unexpected behavior
In-Reply-To: <1423313726.28.0.32804996181.issue23406@psf.upfronthosting.co.za>
Message-ID: <20150907021810.101480.53654@psf.io>


Roundup Robot added the comment:

New changeset 6c222848badd by Martin Panter <vadmium> in branch '2.7':
Issue #23406: Clarify documentation on multiplying a sequence
https://hg.python.org/cpython/rev/6c222848badd

New changeset 57f8c7ad7782 by Martin Panter <vadmium> in branch '3.4':
Issue #23406: Clarify documentation on multiplying a sequence
https://hg.python.org/cpython/rev/57f8c7ad7782

New changeset f624b7fd3b83 by Martin Panter <vadmium> in branch '3.5':
Issue #23406: Merge 3.4 into 3.5
https://hg.python.org/cpython/rev/f624b7fd3b83

New changeset d2b3c7c5ef02 by Martin Panter <vadmium> in branch 'default':
Issue #23406: Merge 3.5 into 3.6
https://hg.python.org/cpython/rev/d2b3c7c5ef02

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

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

From report at bugs.python.org  Mon Sep  7 04:21:17 2015
From: report at bugs.python.org (Martin Panter)
Date: Mon, 07 Sep 2015 02:21:17 +0000
Subject: [docs] [issue23406] interning and list comprehension leads to
 unexpected behavior
In-Reply-To: <1423313726.28.0.32804996181.issue23406@psf.upfronthosting.co.za>
Message-ID: <1441592477.08.0.523095198822.issue23406@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Mon Sep  7 06:18:00 2015
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 07 Sep 2015 04:18:00 +0000
Subject: [docs] [issue23406] interning and list comprehension leads to
 unexpected behavior
In-Reply-To: <1423313726.28.0.32804996181.issue23406@psf.upfronthosting.co.za>
Message-ID: <20150907041757.11268.55690@psf.io>


Roundup Robot added the comment:

New changeset 2640a4630e9e by Martin Panter <vadmium> in branch '3.5':
Issue #23406: Remove specific line number from susp-ignored.csv
https://hg.python.org/cpython/rev/2640a4630e9e

New changeset 48f1e9a47301 by Martin Panter <vadmium> in branch 'default':
Issue #23406: Merge 3.5 into 3.6
https://hg.python.org/cpython/rev/48f1e9a47301

----------

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

From report at bugs.python.org  Mon Sep  7 10:36:46 2015
From: report at bugs.python.org (Ivan Levkivskyi)
Date: Mon, 07 Sep 2015 08:36:46 +0000
Subject: [docs] [issue24272] PEP 484 docs
In-Reply-To: <1432415368.91.0.945654992881.issue24272@psf.upfronthosting.co.za>
Message-ID: <1441615005.92.0.528456714072.issue24272@psf.upfronthosting.co.za>


Ivan Levkivskyi added the comment:

Guido, are you going to commit our patches before 3.5.final? Is there a merge conflict now? Should I rebase my diff?

If necessary I could make a clean patch combining two patches (my and Daniel's) on top of what Zachary did.

----------

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

From report at bugs.python.org  Mon Sep  7 11:01:37 2015
From: report at bugs.python.org (Thomas Guettler)
Date: Mon, 07 Sep 2015 09:01:37 +0000
Subject: [docs] [issue25017] htmllib deprecated: Which library to use?
 Missing sane default in docs
Message-ID: <1441616497.34.0.0999815194375.issue25017@psf.upfronthosting.co.za>


New submission from Thomas Guettler:

At the top of the htmllib module:


> Deprecated since version 2.6: The htmllib module has been removed in
> Python 3.


Source: https://docs.python.org/2/library/htmllib.html#module-htmllib


Newcomers need more advice: Which library should be used?

I know there are many html parsing libraries.

But there should be a sane default for newcomers.

Is there already an agreement of a sane default html parsing library?

----------
assignee: docs at python
components: Documentation
messages: 250088
nosy: docs at python, guettli
priority: normal
severity: normal
status: open
title: htmllib deprecated: Which library to use? Missing sane default in docs

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

From guettliml at thomas-guettler.de  Mon Sep  7 11:02:42 2015
From: guettliml at thomas-guettler.de (=?UTF-8?Q?Thomas_G=c3=bcttler?=)
Date: Mon, 7 Sep 2015 11:02:42 +0200
Subject: [docs] htmllib is deprecated: Newcomers need more advice
In-Reply-To: <55E8614B.9010007@thomas-guettler.de>
References: <55E8614B.9010007@thomas-guettler.de>
Message-ID: <55ED52B2.1060306@thomas-guettler.de>

Sad, that no one cares.

I created an issue: http://bugs.python.org/issue25017

Am 03.09.2015 um 17:03 schrieb Thomas G?ttler:
> At the top of the htmllib module:
>
> {{{
> Deprecated since version 2.6: The htmllib module has been removed in Python 3.
> }}}
>
> Source: https://docs.python.org/2/library/htmllib.html#module-htmllib
>
>
> Newcomers need more advice: Which library should be used?
>
> I know there are many html parsing libraries.
>
> But there should be a sane default for newcomers.
>
> Is there already an agreement of a sane default html parsing library?

-- 
Thomas Guettler http://www.thomas-guettler.de/

From report at bugs.python.org  Mon Sep  7 11:50:08 2015
From: report at bugs.python.org (Martin Panter)
Date: Mon, 07 Sep 2015 09:50:08 +0000
Subject: [docs] [issue25017] htmllib deprecated: Which library to use?
 Missing sane default in docs
In-Reply-To: <1441616497.34.0.0999815194375.issue25017@psf.upfronthosting.co.za>
Message-ID: <1441619408.12.0.327367378565.issue25017@psf.upfronthosting.co.za>


Martin Panter added the comment:

PEP 3108 says ?Superseded by HTMLParser?. I presume this means Python 3?s ?html.parser? module (called ?HTMLParser? in Python 2). I guess a lot of work would be involved in changing existing code over, but it shouldn?t be much of a problem for someone writing new code.

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

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

From lac at openend.se  Mon Sep  7 17:58:51 2015
From: lac at openend.se (Laura Creighton)
Date: Mon, 7 Sep 2015 17:58:51 +0200
Subject: [docs] WCAG 2.0 from w3 consortium
Message-ID: <201509071558.t87Fwp1U021550@fido.openend.se>

Recently, webmaster received 2 queries from people who wanted to know
how compliant ?Python and the Python documentation were with the
Americans with Disabilities Act Provisions and with WCAG3
http://www.w3.org/WAI/intro/wcag.php

The real question was 'how hard is it for Blind people to use Python
and read the docs?'.  I sent the people who made the queries to some
blind programmers' mailing lists, to ask some real blind people, some
of whom I know use Python.  But the question got me wondering.  Was
WCAG considered when we redesigned the docs?  Is there something I
should also be telling such people?

Laura


From willingc at willingconsulting.com  Mon Sep  7 18:06:45 2015
From: willingc at willingconsulting.com (Carol Willing)
Date: Mon, 7 Sep 2015 09:06:45 -0700
Subject: [docs] WCAG 2.0 from w3 consortium
In-Reply-To: <201509071558.t87Fwp1U021550@fido.openend.se>
References: <201509071558.t87Fwp1U021550@fido.openend.se>
Message-ID: <55EDB615.6010105@willingconsulting.com>

On 9/7/15 8:58 AM, Laura Creighton wrote:
> Recently, webmaster received 2 queries from people who wanted to know
> how compliant ?Python and the Python documentation were with the
> Americans with Disabilities Act Provisions and with WCAG3
> http://www.w3.org/WAI/intro/wcag.php
>
> The real question was 'how hard is it for Blind people to use Python
> and read the docs?'.  I sent the people who made the queries to some
> blind programmers' mailing lists, to ask some real blind people, some
> of whom I know use Python.  But the question got me wondering.  Was
> WCAG considered when we redesigned the docs?  Is there something I
> should also be telling such people?
I'm not sure about the history. 18F has a good draft accessibility 
guide. There's also a page linking to accessibility testing tools: 
https://pages.18f.gov/accessibility/tools/

Running the tools on the existing docs would be a good project for a 
future sprint.

Carol


-- 
*Carol Willing*
Developer | Willing Consulting
https://willingconsulting.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20150907/2f6a7344/attachment.html>

From georg at python.org  Mon Sep  7 18:51:22 2015
From: georg at python.org (Georg Brandl)
Date: Mon, 7 Sep 2015 18:51:22 +0200
Subject: [docs] WCAG 2.0 from w3 consortium
In-Reply-To: <55EDB615.6010105@willingconsulting.com>
References: <201509071558.t87Fwp1U021550@fido.openend.se>
 <55EDB615.6010105@willingconsulting.com>
Message-ID: <55EDC08A.3080404@python.org>

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On 09/07/2015 06:06 PM, Carol Willing wrote:
> On 9/7/15 8:58 AM, Laura Creighton wrote:
>> Recently, webmaster received 2 queries from people who wanted to know how
>> compliant ?Python and the Python documentation were with the Americans
>> with Disabilities Act Provisions and with WCAG3 
>> http://www.w3.org/WAI/intro/wcag.php
>> 
>> The real question was 'how hard is it for Blind people to use Python and
>> read the docs?'.  I sent the people who made the queries to some blind
>> programmers' mailing lists, to ask some real blind people, some of whom I
>> know use Python.  But the question got me wondering.  Was WCAG considered
>> when we redesigned the docs?  Is there something I should also be telling
>> such people?

Short answer: no, I did not try to take anything like this into account.
In the case of American laws because they are of no consequence to me,
and in the case of the W3C guidelines because I am not familiar with them.

But of course the goal of being accessible is worthwhile, and contributions
in this direction are very welcome.

> I'm not sure about the history. 18F has a good draft accessibility guide. 
> There's also a page linking to accessibility testing tools: 
> https://pages.18f.gov/accessibility/tools/
> 
> Running the tools on the existing docs would be a good project for a future
> sprint.

Indeed!

cheers,
Georg
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2

iEYEARECAAYFAlXtwIoACgkQN9GcIYhpnLCQLACfWQjCHIg/2z8EdongWtNLHT8w
ry4AoJJyYrEA46e6y9nJys8kFAR7ETSm
=M5Hn
-----END PGP SIGNATURE-----

From report at bugs.python.org  Mon Sep  7 18:58:24 2015
From: report at bugs.python.org (Guido van Rossum)
Date: Mon, 07 Sep 2015 16:58:24 +0000
Subject: [docs] [issue24272] PEP 484 docs
In-Reply-To: <1432415368.91.0.945654992881.issue24272@psf.upfronthosting.co.za>
Message-ID: <1441645104.74.0.37444974581.issue24272@psf.upfronthosting.co.za>


Guido van Rossum added the comment:

I apologize, I've been distracted. I will try to get to this before 3.5.0 final goes out! I don't know if the fixes will end up in the tar ball but they will certainly be on docs.python.org.

----------

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

From report at bugs.python.org  Mon Sep  7 19:31:04 2015
From: report at bugs.python.org (Mark Roseman)
Date: Mon, 07 Sep 2015 17:31:04 +0000
Subject: [docs] [issue16893] Generate Idle help from Doc/library/idle.rst
In-Reply-To: <1357663512.19.0.739336896498.issue16893@psf.upfronthosting.co.za>
Message-ID: <1441647064.86.0.023283919776.issue16893@psf.upfronthosting.co.za>


Changes by Mark Roseman <mark at markroseman.com>:


----------
nosy: +markroseman

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

From report at bugs.python.org  Mon Sep  7 21:54:19 2015
From: report at bugs.python.org (Thomas Guettler)
Date: Mon, 07 Sep 2015 19:54:19 +0000
Subject: [docs] [issue25017] htmllib deprecated: Which library to use?
 Missing sane default in docs
In-Reply-To: <1441616497.34.0.0999815194375.issue25017@psf.upfronthosting.co.za>
Message-ID: <1441655659.3.0.28930443912.issue25017@psf.upfronthosting.co.za>


Thomas Guettler added the comment:

This issue is just about documentation. No code change is required for it.

How to update the docs, to point to html.parser?

----------

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

From report at bugs.python.org  Mon Sep  7 21:58:32 2015
From: report at bugs.python.org (Berker Peksag)
Date: Mon, 07 Sep 2015 19:58:32 +0000
Subject: [docs] [issue25017] htmllib deprecated: Which library to use?
 Missing sane default in docs
In-Reply-To: <1441616497.34.0.0999815194375.issue25017@psf.upfronthosting.co.za>
Message-ID: <1441655912.32.0.285227051385.issue25017@psf.upfronthosting.co.za>


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


----------
nosy: +ezio.melotti

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

From report at bugs.python.org  Mon Sep  7 22:07:55 2015
From: report at bugs.python.org (Ezio Melotti)
Date: Mon, 07 Sep 2015 20:07:55 +0000
Subject: [docs] [issue25017] htmllib deprecated: Which library to use?
 Missing sane default in docs
In-Reply-To: <1441616497.34.0.0999815194375.issue25017@psf.upfronthosting.co.za>
Message-ID: <1441656475.7.0.259959921882.issue25017@psf.upfronthosting.co.za>


Ezio Melotti added the comment:

If you want to create a patch, you have to edit the file Doc/library/htmllib.rst in the 2.7 branch.  You can find information about cloning the CPython repository and switching branch in the devguide.
The warning should suggest :mod:`HTMLParser` for Python 2 and the equivalent :mod:`html.parser` for Python 3.

----------

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

From report at bugs.python.org  Mon Sep  7 22:22:28 2015
From: report at bugs.python.org (Larry Hastings)
Date: Mon, 07 Sep 2015 20:22:28 +0000
Subject: [docs] [issue24272] PEP 484 docs
In-Reply-To: <1432415368.91.0.945654992881.issue24272@psf.upfronthosting.co.za>
Message-ID: <1441657348.13.0.887046234439.issue24272@psf.upfronthosting.co.za>


Larry Hastings added the comment:

Doc fixes are always welcome.  Barring mishaps I should tag 3.5.0 final on Saturday; it'd be sweet if you could get me your diff no later than Friday night.

----------

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

From report at bugs.python.org  Mon Sep  7 23:57:18 2015
From: report at bugs.python.org (Mark Roseman)
Date: Mon, 07 Sep 2015 21:57:18 +0000
Subject: [docs] [issue16893] Generate Idle help from Doc/library/idle.rst
In-Reply-To: <1357663512.19.0.739336896498.issue16893@psf.upfronthosting.co.za>
Message-ID: <1441663038.76.0.959949263903.issue16893@psf.upfronthosting.co.za>


Mark Roseman added the comment:

If it's useful, I quickly threw together a routine that takes the HTML generated by Sphinx, and using html.parser, strips out the navigation stuff, and stuffs it into a Tk text widget, doing appropriate things with the subset of the formatting it uses (lists, headings, etc.).

If something like that seems appropriate to use, let me know and I can clean it up a bit and post it as a patch.

----------

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

From report at bugs.python.org  Tue Sep  8 01:04:00 2015
From: report at bugs.python.org (Davin Potts)
Date: Mon, 07 Sep 2015 23:04:00 +0000
Subject: [docs] [issue24475] The docs never define what a pool "task" is
In-Reply-To: <1434733537.74.0.146405679971.issue24475@psf.upfronthosting.co.za>
Message-ID: <1441667040.5.0.485063103471.issue24475@psf.upfronthosting.co.za>


Changes by Davin Potts <python at discontinuity.net>:


----------
type:  -> enhancement

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

From report at bugs.python.org  Tue Sep  8 06:16:05 2015
From: report at bugs.python.org (Terry J. Reedy)
Date: Tue, 08 Sep 2015 04:16:05 +0000
Subject: [docs] [issue16893] Generate Idle help from Doc/library/idle.rst
In-Reply-To: <1357663512.19.0.739336896498.issue16893@psf.upfronthosting.co.za>
Message-ID: <1441685765.45.0.340670345241.issue16893@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

Trying to produce .txt from .rst or .html was the original idea but the result in the upload help.txt is not terribly good. We decided that it is reasonable these days to depend on a browser being present and use the webbrowser module to display the html in a browser. Some effort has been put into getting decent looking html from rst. On windows, the .chm installed with Python can be used as a backup should the browser not work.  

The reason for not simply starting a browser on the online Idle page is that the online docs reflect the repository version of Idle, which may have features not in the released version.  So a 'frozen' doc is needed.  (Note that the .chm is already frozen.) 

The steps and issues I see.

1. Should there be a separate idlehelp target, as in Zach's v4 patch, or should copying the one file be part of building the html files.  The issue here is making sure that the idlelib/help.html is rebuilt at the time of release.  Re-generating the html files is, I presume, part of the release process, whereas a separate step would have to somehow be added.

2. We already use webbrowser to start the online docs, I believe on all systems.  The code can be reused with a different target.

3. Is an exact copy ok, or should some nagivation be removed?  We need to try the file as is and see.

4. The html file should be added to .hgignore and not checked into the repository.

----------

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

From report at bugs.python.org  Tue Sep  8 06:32:23 2015
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 08 Sep 2015 04:32:23 +0000
Subject: [docs] [issue25010] minor typo in PCBuild readme.txt
In-Reply-To: <1441474606.12.0.269999159131.issue25010@psf.upfronthosting.co.za>
Message-ID: <20150908043220.68867.96382@psf.io>


Roundup Robot added the comment:

New changeset 7f4102a9818b by Zachary Ware in branch '3.4':
Issue #25010: Fix path for .pyd example project.
https://hg.python.org/cpython/rev/7f4102a9818b

New changeset 309c0331726b by Zachary Ware in branch '3.5':
Issue #25010: Merge with 3.4
https://hg.python.org/cpython/rev/309c0331726b

New changeset 3829f567d269 by Zachary Ware in branch 'default':
Closes #25010: Merge with 3.5
https://hg.python.org/cpython/rev/3829f567d269

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

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

From report at bugs.python.org  Tue Sep  8 06:33:33 2015
From: report at bugs.python.org (Zachary Ware)
Date: Tue, 08 Sep 2015 04:33:33 +0000
Subject: [docs] [issue25010] minor typo in PCBuild readme.txt
In-Reply-To: <1441474606.12.0.269999159131.issue25010@psf.upfronthosting.co.za>
Message-ID: <1441686813.55.0.761458498256.issue25010@psf.upfronthosting.co.za>


Zachary Ware added the comment:

Thanks for the report and patch!

Unfortunately, that example is so completely out of date we'd probably be better off to remove it, but we can at least point to the right path :)

----------
nosy: +zach.ware
versions: +Python 3.4, Python 3.6

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

From report at bugs.python.org  Tue Sep  8 06:42:30 2015
From: report at bugs.python.org (Zachary Ware)
Date: Tue, 08 Sep 2015 04:42:30 +0000
Subject: [docs] [issue25022] Remove PC/example_nt/
Message-ID: <1441687350.45.0.29239152419.issue25022@psf.upfronthosting.co.za>


New submission from Zachary Ware:

The instructions and examples in PC/example_nt/ are hopelessly outdated (the readme says "It has been tested with VC++ 7.1 on Python 2.4" on default!).  Is there any reason to keep and update the example, or can we just drop it?

----------
assignee: docs at python
components: Documentation, Windows
messages: 250156
nosy: docs at python, paul.moore, steve.dower, tim.golden, zach.ware
priority: normal
severity: normal
status: open
title: Remove PC/example_nt/
type: enhancement
versions: Python 2.7, Python 3.4, Python 3.5, Python 3.6

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

From report at bugs.python.org  Tue Sep  8 13:19:40 2015
From: report at bugs.python.org (Petr Viktorin)
Date: Tue, 08 Sep 2015 11:19:40 +0000
Subject: [docs] [issue24937] Multiple problems in getters & setters in
	capsulethunk.h
In-Reply-To: <1440520892.99.0.130273606833.issue24937@psf.upfronthosting.co.za>
Message-ID: <1441711179.53.0.865798468484.issue24937@psf.upfronthosting.co.za>


Petr Viktorin added the comment:

This patch removes capsulethunk.h from the docs, and directs the kind reader to the py3c project, which carries a fixed and tested version of it, along with the docs.


Larry, would you be OK with releasing capsulethunk.h under the MIT license? The PSF license is not suitable for external projects, and mixing licenses is somewhat awkward.

----------
versions:  -Python 3.3, Python 3.4
Added file: http://bugs.python.org/file40403/capsulethunk-py3c.patch

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

From report at bugs.python.org  Tue Sep  8 13:50:25 2015
From: report at bugs.python.org (Berker Peksag)
Date: Tue, 08 Sep 2015 11:50:25 +0000
Subject: [docs] [issue25017] htmllib deprecated: Which library to use?
 Missing sane default in docs
In-Reply-To: <1441616497.34.0.0999815194375.issue25017@psf.upfronthosting.co.za>
Message-ID: <1441713025.49.0.291571996344.issue25017@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Tue Sep  8 14:32:21 2015
From: report at bugs.python.org (Larry Hastings)
Date: Tue, 08 Sep 2015 12:32:21 +0000
Subject: [docs] [issue24937] Multiple problems in getters & setters in
	capsulethunk.h
In-Reply-To: <1440520892.99.0.130273606833.issue24937@psf.upfronthosting.co.za>
Message-ID: <1441715541.93.0.737194118992.issue24937@psf.upfronthosting.co.za>


Larry Hastings added the comment:

I'm the author of capsulethunk.h, and I am happy to relicense it under MIT.

How would you feel about leaving capsulethunk.h there, for posterity's sakes, but adding "for updates please see py3c"?  We could even update the capsulethunk.h there.  I'm not saying "we have to do it this way", I'm asking whether the users would be better served by leaving the example around vs removing it and forcing them to go looking on an external web site.

----------

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

From report at bugs.python.org  Tue Sep  8 14:47:45 2015
From: report at bugs.python.org (Mark Roseman)
Date: Tue, 08 Sep 2015 12:47:45 +0000
Subject: [docs] [issue16893] Generate Idle help from Doc/library/idle.rst
In-Reply-To: <1357663512.19.0.739336896498.issue16893@psf.upfronthosting.co.za>
Message-ID: <1441716465.43.0.389549641714.issue16893@psf.upfronthosting.co.za>


Mark Roseman added the comment:

Ok. In case you're curious or might find it useful elsewhere, I've attached sphinxview.py, which renders the HTML into a text widget (with formatting, it's not converted to plain text).

----------
Added file: http://bugs.python.org/file40405/sphinxview.py

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

From report at bugs.python.org  Tue Sep  8 15:20:09 2015
From: report at bugs.python.org (Steve Dower)
Date: Tue, 08 Sep 2015 13:20:09 +0000
Subject: [docs] [issue25022] Remove PC/example_nt/
In-Reply-To: <1441687350.45.0.29239152419.issue25022@psf.upfronthosting.co.za>
Message-ID: <1441718409.2.0.983767839036.issue25022@psf.upfronthosting.co.za>


Steve Dower added the comment:

Go for it.

----------

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

From report at bugs.python.org  Tue Sep  8 15:37:29 2015
From: report at bugs.python.org (Petr Viktorin)
Date: Tue, 08 Sep 2015 13:37:29 +0000
Subject: [docs] [issue24937] Multiple problems in getters & setters in
	capsulethunk.h
In-Reply-To: <1440520892.99.0.130273606833.issue24937@psf.upfronthosting.co.za>
Message-ID: <1441719449.32.0.468126844231.issue24937@psf.upfronthosting.co.za>


Petr Viktorin added the comment:

Thank you for the license.

I mentioned my project mainly as a place where this code can be *tested*. I have no problem with keeping capsulethunk.h in the Python docs, and synchronizing the two projects if changes are made on either side. In other words, feel free to use the first patch :)

Regarding users ? in my opinion, including a whole header directly in the docs is questionable (to me it smells of untested copy-paste code), and the link goes to hg.python.org ? an external site from the users' point of view.
Also, if someone needs to port CObject, their extension is very likely to be complicated enough to need much more material than the HOWTO provides.
See py3c's `modernization docs`_ for several things the HOWTO doesn't address.
So, in my obviously biased opinion, linking to py3c will help users.
(Perhaps a link to py3c should be at the top of the HOWTO, but that's not for this issue. I'm working to get to a point where I'm comfortable suggesting that.)

There's obviously the question of whether I should be improving the HOWTO rather than starting my own thing. I have three reasons: testability, the fact that py3c docs are already way too long for a HOWTO, and the fact that py3c is quite opinionated. (The more opinionated, the more more in-depth the solutions can be. I've been toning it down lately, though.)


_ modernization docs: http://py3c.readthedocs.org/en/latest/guide-modernization.html

----------

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

From report at bugs.python.org  Tue Sep  8 15:44:41 2015
From: report at bugs.python.org (shiyao.ma)
Date: Tue, 08 Sep 2015 13:44:41 +0000
Subject: [docs] [issue25030] io.[Text]IOBase.seek doesn't take keyword
	parameter
Message-ID: <1441719881.64.0.378247085729.issue25030@psf.upfronthosting.co.za>


New submission from shiyao.ma:

The doc is here: https://docs.python.org/3.5/library/io.html#io.IOBase.seek
and here: https://docs.python.org/3.5/library/io.html#io.TextIOBase.seek

It is said the parameter list is in the form of:
seek(offset, whence=SEEK_SET)

But actually only:
seek(offset) or seek(offset, whence) is allowed.

Passing seek(offset, whence=SEEK_FOOBAR) will throw an error.

The patch fixes the function signature as seek(offset[, whence])

----------
assignee: docs at python
components: Documentation
files: seek.patch
keywords: patch
messages: 250200
nosy: berker.peksag, docs at python, ezio.melotti, introom
priority: normal
severity: normal
status: open
title: io.[Text]IOBase.seek doesn't take keyword parameter
versions: Python 3.5
Added file: http://bugs.python.org/file40406/seek.patch

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

From i at introo.me  Tue Sep  8 15:45:54 2015
From: i at introo.me (Shiyao Ma)
Date: Tue, 8 Sep 2015 21:45:54 +0800
Subject: [docs] Should I fire a bug against io.IOBase.seek function sig ?
In-Reply-To: <CAF4280+f9oHhV1WJTkMgcm64BCKCquuE3KQQR5j=aBD+06=pHw@mail.gmail.com>
References: <CAJQX3DwgFUrD0dfV8tUzWGv9QYtwR-_TFaHJ-kZRHtHKmcxK7w@mail.gmail.com>
 <CAF4280+f9oHhV1WJTkMgcm64BCKCquuE3KQQR5j=aBD+06=pHw@mail.gmail.com>
Message-ID: <CAJQX3DxrQc1HgRpT3Tjc4G3CWM49Fk9sYnurJbvLmvjCrnZoRw@mail.gmail.com>

Hi,


On Fri, Aug 28, 2015 at 12:30 AM, Berker Peksa? <berker.peksag at gmail.com> wrote:

> Yes, please open a new issue at bugs.python.org. The correct syntax
> should be ``seek(offset[, SEEK_SET])``. Also, we can make seek()
> accept a whence keyword argument on Python 3.6(similar to what we did
> for codecs.{encode,decode} for Python 3.5).

The issue is here:

http://bugs.python.org/issue25030


I will work on the keyword argument support as in codecs.{encode,decode} soon.


Regards.




-- 

????????????????https://introo.me?

From report at bugs.python.org  Tue Sep  8 15:58:31 2015
From: report at bugs.python.org (Tim Tisdall)
Date: Tue, 08 Sep 2015 13:58:31 +0000
Subject: [docs] [issue24984] document AF_BLUETOOTH socket address formats
In-Reply-To: <1441210010.76.0.198064903239.issue24984@psf.upfronthosting.co.za>
Message-ID: <1441720711.36.0.0381367881096.issue24984@psf.upfronthosting.co.za>


Tim Tisdall added the comment:

Martin, looks good.  Thanks for pointing out how to properly tag the version change, and thanks for adding me to the ACKS file.

----------

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

From report at bugs.python.org  Tue Sep  8 18:59:53 2015
From: report at bugs.python.org (Terry J. Reedy)
Date: Tue, 08 Sep 2015 16:59:53 +0000
Subject: [docs] [issue16893] Generate Idle help from Doc/library/idle.rst
In-Reply-To: <1357663512.19.0.739336896498.issue16893@psf.upfronthosting.co.za>
Message-ID: <1441731593.16.0.514269923291.issue16893@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

This looks more maintainable than I expected, so I will definite try it out.

----------

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

From report at bugs.python.org  Tue Sep  8 20:36:46 2015
From: report at bugs.python.org (Adam)
Date: Tue, 08 Sep 2015 18:36:46 +0000
Subject: [docs] [issue24899] Add an os.path <=> pathlib equivalence table in
 pathlib docs
In-Reply-To: <1440050617.44.0.44226546659.issue24899@psf.upfronthosting.co.za>
Message-ID: <1441737406.43.0.739567337971.issue24899@psf.upfronthosting.co.za>


Changes by Adam <azsorkin at gmail.com>:


----------
nosy: +azsorkin

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

From report at bugs.python.org  Wed Sep  9 00:21:43 2015
From: report at bugs.python.org (Martin Panter)
Date: Tue, 08 Sep 2015 22:21:43 +0000
Subject: [docs] [issue23738] Clarify documentation of positional-only
	default values
In-Reply-To: <1427020261.31.0.215855760889.issue23738@psf.upfronthosting.co.za>
Message-ID: <1441750903.31.0.325196741539.issue23738@psf.upfronthosting.co.za>


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


----------
dependencies: +io.[Text]IOBase.seek doesn't take keyword parameter

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

From report at bugs.python.org  Wed Sep  9 00:41:12 2015
From: report at bugs.python.org (Martin Panter)
Date: Tue, 08 Sep 2015 22:41:12 +0000
Subject: [docs] [issue25030] io.[Text]IOBase.seek doesn't take keyword
	parameter
In-Reply-To: <1441719881.64.0.378247085729.issue25030@psf.upfronthosting.co.za>
Message-ID: <1441752072.25.0.0150141170486.issue25030@psf.upfronthosting.co.za>


Martin Panter added the comment:

This also bugs me, and the same problem exists in other parts of the documentation. Perhaps you might be interested in Issue 23738 and whether changing to the new notation used by PEP 457, pydoc, help(), Argument Clinic is any good:

seek(offset, whence=SEEK_SET, /)

But in the mean time, I think the proposed patch is okay, and would certainly benefit the Python 2 documetation where using the new PEP 457 slash indicator is less likely to be appropriate.

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

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

From report at bugs.python.org  Wed Sep  9 05:54:44 2015
From: report at bugs.python.org (Martin Panter)
Date: Wed, 09 Sep 2015 03:54:44 +0000
Subject: [docs] [issue23738] Clarify documentation of positional-only
	default values
In-Reply-To: <1427020261.31.0.215855760889.issue23738@psf.upfronthosting.co.za>
Message-ID: <1441770884.25.0.484407179002.issue23738@psf.upfronthosting.co.za>


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


----------
nosy: +berker.peksag
versions: +Python 3.6
Added file: http://bugs.python.org/file40417/pos-defaults.v3.patch

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

From report at bugs.python.org  Wed Sep  9 05:56:01 2015
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 09 Sep 2015 03:56:01 +0000
Subject: [docs] [issue23738] Clarify documentation of positional-only
	default values
In-Reply-To: <1427020261.31.0.215855760889.issue23738@psf.upfronthosting.co.za>
Message-ID: <20150909035557.15730.75199@psf.io>


Roundup Robot added the comment:

New changeset fdb5d84f9948 by Martin Panter <vadmium> in branch '3.4':
Issue #23738: Document and test actual keyword parameter names
https://hg.python.org/cpython/rev/fdb5d84f9948

New changeset 40bf1ca3f715 by Martin Panter <vadmium> in branch '3.5':
Issue #23738: Merge 3.4 into 3.5
https://hg.python.org/cpython/rev/40bf1ca3f715

New changeset 6177482ce6a1 by Martin Panter <vadmium> in branch 'default':
Issue #23738: Merge 3.5 into 3.6
https://hg.python.org/cpython/rev/6177482ce6a1

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

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

From report at bugs.python.org  Wed Sep  9 05:58:50 2015
From: report at bugs.python.org (Martin Panter)
Date: Wed, 09 Sep 2015 03:58:50 +0000
Subject: [docs] [issue23738] Clarify documentation of positional-only
	default values
In-Reply-To: <1427020261.31.0.215855760889.issue23738@psf.upfronthosting.co.za>
Message-ID: <1441771130.84.0.872947389563.issue23738@psf.upfronthosting.co.za>


Martin Panter added the comment:

I have committed the obvious keyword argument name fixes from my patch. Now patch v3 contains just the PEP 457 changes to be considered.

----------

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

From report at bugs.python.org  Wed Sep  9 06:22:57 2015
From: report at bugs.python.org (shiyao.ma)
Date: Wed, 09 Sep 2015 04:22:57 +0000
Subject: [docs] [issue25030] io.
In-Reply-To: <1441752072.25.0.0150141170486.issue25030@psf.upfronthosting.co.za>
Message-ID: <CAJQX3DwVn58Cktz3AwZze14yG_MVzS_NQgCeuGuKNstjq16vnQ@mail.gmail.com>


shiyao.ma added the comment:

Thanks for your comment.

I had a read of pep457. It's still in draft status, so incorporating
the / indicator is not much a concern AFAIK.

Any further modification for me to do to get that merged?

----------
title: io.[Text]IOBase.seek doesn't take keyword parameter -> io.

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

From report at bugs.python.org  Wed Sep  9 06:50:04 2015
From: report at bugs.python.org (Martin Panter)
Date: Wed, 09 Sep 2015 04:50:04 +0000
Subject: [docs] [issue25030] io.[Text]IOBase.seek doesn't take keyword
	parameter
In-Reply-To: <1441719881.64.0.378247085729.issue25030@psf.upfronthosting.co.za>
Message-ID: <1441774204.87.0.437968609443.issue25030@psf.upfronthosting.co.za>


Martin Panter added the comment:

I will try to commit your patch today when I up to it.

Maybe the ?draft? status of that PEP is out of date. The slash (/) indicator is already being used in some places in pydoc, e.g.

$ pydoc object.__eq__
Help on wrapper_descriptor in object:

object.__eq__ = __eq__(self, value, /)
    Return self==value.

----------
assignee: docs at python -> martin.panter
stage:  -> commit review
title: io. -> io.[Text]IOBase.seek doesn't take keyword parameter

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

From report at bugs.python.org  Wed Sep  9 08:50:05 2015
From: report at bugs.python.org (Martin Panter)
Date: Wed, 09 Sep 2015 06:50:05 +0000
Subject: [docs] [issue24984] document AF_BLUETOOTH socket address formats
In-Reply-To: <1441210010.76.0.198064903239.issue24984@psf.upfronthosting.co.za>
Message-ID: <1441781405.58.0.879458189502.issue24984@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Wed Sep  9 08:59:28 2015
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 09 Sep 2015 06:59:28 +0000
Subject: [docs] [issue24984] document AF_BLUETOOTH socket address formats
In-Reply-To: <1441210010.76.0.198064903239.issue24984@psf.upfronthosting.co.za>
Message-ID: <20150909065924.115088.9536@psf.io>


Roundup Robot added the comment:

New changeset da9b26670e44 by Martin Panter <vadmium> in branch '3.4':
Issue #24984: Document AF_BLUETOOTH socket address formats
https://hg.python.org/cpython/rev/da9b26670e44

New changeset 4ce8450da22d by Martin Panter <vadmium> in branch '3.5':
Issue #24984: Merge 3.4 into 3.5
https://hg.python.org/cpython/rev/4ce8450da22d

New changeset ec4ba0cb1ce0 by Martin Panter <vadmium> in branch 'default':
Issue #24984: Merge 3.5 into 3.6
https://hg.python.org/cpython/rev/ec4ba0cb1ce0

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

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

From report at bugs.python.org  Wed Sep  9 11:08:30 2015
From: report at bugs.python.org (Camilla Montonen)
Date: Wed, 09 Sep 2015 09:08:30 +0000
Subject: [docs] [issue25039] Docs: Link to Stackless Python in Design and
 History FAQ section is broken
Message-ID: <1441789710.22.0.139129124794.issue25039@psf.upfronthosting.co.za>


New submission from Camilla Montonen:

The link to Stackless Python here https://docs.python.org/2/faq/design.html#can-t-you-emulate-threads-in-the-interpreter-instead-of-relying-on-an-os-specific-thread-implementation
is broken. 
I get an "Internal Server Error" when trying to access it.

----------
assignee: docs at python
components: Documentation
messages: 250297
nosy: Winterflower, docs at python
priority: normal
severity: normal
status: open
title: Docs: Link to Stackless Python in Design and History FAQ section is broken
versions: Python 2.7

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

From report at bugs.python.org  Wed Sep  9 11:13:10 2015
From: report at bugs.python.org (Berker Peksag)
Date: Wed, 09 Sep 2015 09:13:10 +0000
Subject: [docs] [issue24984] document AF_BLUETOOTH socket address formats
In-Reply-To: <1441210010.76.0.198064903239.issue24984@psf.upfronthosting.co.za>
Message-ID: <1441789990.55.0.0236421427156.issue24984@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Thanks for the patch, Tim. I think we can also create separate issues for AF_PACKET and AF_CAN and mark them as "easy".

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

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

From report at bugs.python.org  Wed Sep  9 11:25:51 2015
From: report at bugs.python.org (Berker Peksag)
Date: Wed, 09 Sep 2015 09:25:51 +0000
Subject: [docs] [issue25039] Docs: Link to Stackless Python in Design and
 History FAQ section is broken
In-Reply-To: <1441789710.22.0.139129124794.issue25039@psf.upfronthosting.co.za>
Message-ID: <1441790750.96.0.192767534833.issue25039@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Thanks for the report, Camilla. This could be a temporary problem with the Stackless website. Can you ask on http://www.stackless.com/mailman/listinfo/stackless?

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

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

From report at bugs.python.org  Wed Sep  9 12:51:52 2015
From: report at bugs.python.org (Laura Creighton)
Date: Wed, 09 Sep 2015 10:51:52 +0000
Subject: [docs] [issue25039] Docs: Link to Stackless Python in Design and
 History FAQ section is broken
In-Reply-To: <1441789710.22.0.139129124794.issue25039@psf.upfronthosting.co.za>
Message-ID: <1441795912.86.0.0859190853417.issue25039@psf.upfronthosting.co.za>


Laura Creighton added the comment:

I do not think that asking there will help right now because the problem is that the whole site is down, and mailman isn't running either ...

----------
nosy: +lac

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

From report at bugs.python.org  Wed Sep  9 15:07:58 2015
From: report at bugs.python.org (Tim Tisdall)
Date: Wed, 09 Sep 2015 13:07:58 +0000
Subject: [docs] [issue25041] document AF_PACKET socket address format
Message-ID: <1441804077.41.0.782475265278.issue25041@psf.upfronthosting.co.za>


New submission from Tim Tisdall:

As mentioned in #24984, I'm making another issue to document the address format for AF_PACKET.  In this case there's already documentation in Modules/socketmodule.c that says:

- an AF_PACKET socket address is a tuple containing a string
  specifying the ethernet interface and an integer specifying
  the Ethernet protocol number to be received. For example:
  ("eth0",0x1234).  Optional 3rd,4th,5th elements in the tuple
  specify packet-type and ha-type/addr.

But nothing has been added to Doc/library/socket.rst .

The documentation needs to be confirmed with the code.  (It probably should be altered somewhat to state how you "specify packet-type and ha-type/addr"...  and maybe what a "ha-type/addr" is...  A quick Google search found this very useful reference: https://books.google.ca/books?id=Chr1NDlUcI8C&pg=PA472&ots=OCEwyjdXJo&sig=PuNG72WIvv4-A924f9MvzPtgQDc&hl=en&sa=X&ved=0CE8Q6AEwCGoVChMI6IiTyoDqxwIVCTs-Ch3bCAXy#v=onepage&q&f=false )

----------
assignee: docs at python
components: Documentation
messages: 250306
nosy: Tim.Tisdall, docs at python
priority: normal
severity: normal
status: open
title: document AF_PACKET socket address format
type: enhancement
versions: Python 3.4, Python 3.5, Python 3.6

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

From report at bugs.python.org  Wed Sep  9 15:09:58 2015
From: report at bugs.python.org (STINNER Victor)
Date: Wed, 09 Sep 2015 13:09:58 +0000
Subject: [docs] [issue25041] document AF_PACKET socket address format
In-Reply-To: <1441804077.41.0.782475265278.issue25041@psf.upfronthosting.co.za>
Message-ID: <1441804198.13.0.994197771343.issue25041@psf.upfronthosting.co.za>


Changes by STINNER Victor <victor.stinner at gmail.com>:


----------
nosy: +haypo

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

From report at bugs.python.org  Wed Sep  9 15:11:58 2015
From: report at bugs.python.org (Tim Tisdall)
Date: Wed, 09 Sep 2015 13:11:58 +0000
Subject: [docs] [issue25041] document AF_PACKET socket address format
In-Reply-To: <1441804077.41.0.782475265278.issue25041@psf.upfronthosting.co.za>
Message-ID: <1441804318.05.0.466039652782.issue25041@psf.upfronthosting.co.za>


Tim Tisdall added the comment:

Right now the docs say "Certain other address families (:const:`AF_PACKET`, :const:`AF_CAN`) support specific representations.".

I was going to create a separate issue for AF_CAN, but it seems that it's already documented...  When documentation is added for AF_PACKET, please remove the above mentioned line entirely as AF_CAN is already documented.

----------

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

From report at bugs.python.org  Wed Sep  9 15:13:12 2015
From: report at bugs.python.org (Tim Tisdall)
Date: Wed, 09 Sep 2015 13:13:12 +0000
Subject: [docs] [issue24984] document AF_BLUETOOTH socket address formats
In-Reply-To: <1441210010.76.0.198064903239.issue24984@psf.upfronthosting.co.za>
Message-ID: <1441804392.61.0.477129872513.issue24984@psf.upfronthosting.co.za>


Tim Tisdall added the comment:

I created #25041 to handle AF_PACKET.  It seems AF_CAN is already in the docs, so the person making the change for AF_PACKET can just remove that mention of AF_CAN farther down.

----------

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

From report at bugs.python.org  Wed Sep  9 15:51:04 2015
From: report at bugs.python.org (Larry Hastings)
Date: Wed, 09 Sep 2015 13:51:04 +0000
Subject: [docs] [issue23144] html.parser.HTMLParser: setting
 'convert_charrefs = True' leads to dropped text
In-Reply-To: <1420138028.63.0.996553076818.issue23144@psf.upfronthosting.co.za>
Message-ID: <1441806664.72.0.811421542199.issue23144@psf.upfronthosting.co.za>


Larry Hastings added the comment:

The Misc/NEWS entry for this was added under Python 3.5.0rc3.  But, since no pull request has been made for this change, this change hasn't been merged into 3.5.0.  It will ship as part of Python 3.5.1.  I've moved the Misc/NEWS entry accordingly.

----------
nosy: +larry

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

From report at bugs.python.org  Wed Sep  9 16:12:30 2015
From: report at bugs.python.org (Berker Peksag)
Date: Wed, 09 Sep 2015 14:12:30 +0000
Subject: [docs] [issue25041] document AF_PACKET socket address format
In-Reply-To: <1441804077.41.0.782475265278.issue25041@psf.upfronthosting.co.za>
Message-ID: <1441807950.38.0.658049516229.issue25041@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Wed Sep  9 17:00:39 2015
From: report at bugs.python.org (Tim Tisdall)
Date: Wed, 09 Sep 2015 15:00:39 +0000
Subject: [docs] [issue25043] document socket constants for Bluetooth
Message-ID: <1441810839.86.0.110626914047.issue25043@psf.upfronthosting.co.za>


New submission from Tim Tisdall:

further to #24984, I noticed there are constants that aren't mentioned in the docs.  Also BDADDR_ALL is missing (which is defined in Bluez's bluetooth.h) so I added it.

Now, I'm not totally clear on supplying multi-version patches...  I know 3.5 is in "freeze" so I'm guessing adding the BDADDR_ALL constant is a no-no.  I guess I checkout out the different version branches, make the changes, and then create a patch labelled for which version it's for?  (I see the patch has the hash for which commit it's to be applied to, but not which branch)

The repo is down right now, so I'll include a patch once I can update my local copy...  :(

----------
assignee: docs at python
components: Documentation, Library (Lib)
messages: 250314
nosy: Tim.Tisdall, docs at python
priority: normal
severity: normal
status: open
title: document socket constants for Bluetooth
type: enhancement
versions: Python 3.4, Python 3.5, Python 3.6

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

From report at bugs.python.org  Wed Sep  9 22:10:11 2015
From: report at bugs.python.org (Guido van Rossum)
Date: Wed, 09 Sep 2015 20:10:11 +0000
Subject: [docs] [issue24272] PEP 484 docs
In-Reply-To: <1432415368.91.0.945654992881.issue24272@psf.upfronthosting.co.za>
Message-ID: <1441829411.79.0.0852749482745.issue24272@psf.upfronthosting.co.za>


Guido van Rossum added the comment:

Pull Request: https://bitbucket.org/larry/cpython350/pull-requests/24/docs-update-for-typing-module/diff

----------

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

From report at bugs.python.org  Wed Sep  9 22:33:01 2015
From: report at bugs.python.org (Ivan Levkivskyi)
Date: Wed, 09 Sep 2015 20:33:01 +0000
Subject: [docs] [issue24272] PEP 484 docs
In-Reply-To: <1432415368.91.0.945654992881.issue24272@psf.upfronthosting.co.za>
Message-ID: <1441830781.3.0.453756310144.issue24272@psf.upfronthosting.co.za>


Ivan Levkivskyi added the comment:

Thank you, Guido!

I have noticed single quotes in line 38: 

type hinted using `Callable[[Arg1Type, Arg2Type], ReturnType]`

I think it would be logical to replace it with double quotes: 

``Callable[[Arg1Type, Arg2Type], ReturnType]`` 

as Zachary did in the rest of the text.

By the way, you have marked my patch as Daniels and vice versa in the commit descriptions, but that probably does not matter :)

----------

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

From report at bugs.python.org  Wed Sep  9 22:38:09 2015
From: report at bugs.python.org (Guido van Rossum)
Date: Wed, 09 Sep 2015 20:38:09 +0000
Subject: [docs] [issue24272] PEP 484 docs
In-Reply-To: <1432415368.91.0.945654992881.issue24272@psf.upfronthosting.co.za>
Message-ID: <1441831089.19.0.671815066885.issue24272@psf.upfronthosting.co.za>


Guido van Rossum added the comment:

I apologize for the mix-up! The code review tool didn't help.

Regarding the single quotes, there seem to be a bunch more of these, and as cutting a PR is a fair bit of labor I'd rather not fix that. We can fix this once 3.5.0 it out of the door (hopefully this weekend).

----------

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

From report at bugs.python.org  Wed Sep  9 23:35:00 2015
From: report at bugs.python.org (Marc Bouvier)
Date: Wed, 09 Sep 2015 21:35:00 +0000
Subject: [docs] [issue25048] %e Directive Missing in Datetime Documentation
Message-ID: <1441834500.22.0.00847516918827.issue25048@psf.upfronthosting.co.za>


New submission from Marc Bouvier:

The %e directive is missing in the Datetime documentation. I have tried this directive in 2.6.6, 2.7.2, and 2.7.10 using datetime.datetime.strftime(datetime.datetime.now(), '%A, %B %e, %Y') and it works in all cases.

The below documentation line is pulled from, http://linux.die.net/man/3/strftime. The behavior is the same.

%e

Like %d, the day of the month as a decimal number, but a leading zero is replaced by a space. (SU)

----------
assignee: docs at python
components: Documentation
messages: 250335
nosy: docs at python, marcrbouvier
priority: normal
severity: normal
status: open
title: %e Directive Missing in Datetime Documentation
type: enhancement
versions: Python 2.7, Python 3.2, Python 3.3, Python 3.4, Python 3.5, Python 3.6

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

From report at bugs.python.org  Wed Sep  9 23:38:23 2015
From: report at bugs.python.org (Marc Bouvier)
Date: Wed, 09 Sep 2015 21:38:23 +0000
Subject: [docs] [issue25048] %e Directive Missing in Datetime Documentation
In-Reply-To: <1441834500.22.0.00847516918827.issue25048@psf.upfronthosting.co.za>
Message-ID: <1441834703.4.0.840655521797.issue25048@psf.upfronthosting.co.za>


Marc Bouvier added the comment:

Sorry, the documentation page I am looking at is https://docs.python.org/2/library/datetime.html#strftime-and-strptime-behavior and https://docs.python.org/3/library/datetime.html#strftime-and-strptime-behavior.

----------

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

From report at bugs.python.org  Wed Sep  9 23:45:09 2015
From: report at bugs.python.org (R. David Murray)
Date: Wed, 09 Sep 2015 21:45:09 +0000
Subject: [docs] [issue25048] %e Directive Missing in Datetime Documentation
In-Reply-To: <1441834500.22.0.00847516918827.issue25048@psf.upfronthosting.co.za>
Message-ID: <1441835109.69.0.576415455335.issue25048@psf.upfronthosting.co.za>


R. David Murray added the comment:

strftime passes the string through to the OS, which sometimes supports more format codes than the ones documented as working on all platforms.  There is a note in the docs about this.

----------
nosy: +r.david.murray
resolution:  -> not a bug
status: open -> closed

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

From report at bugs.python.org  Wed Sep  9 23:45:17 2015
From: report at bugs.python.org (R. David Murray)
Date: Wed, 09 Sep 2015 21:45:17 +0000
Subject: [docs] [issue25048] %e Directive Missing in Datetime Documentation
In-Reply-To: <1441834500.22.0.00847516918827.issue25048@psf.upfronthosting.co.za>
Message-ID: <1441835117.36.0.650998675795.issue25048@psf.upfronthosting.co.za>


Changes by R. David Murray <rdmurray at bitdance.com>:


----------
stage:  -> resolved

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

From report at bugs.python.org  Thu Sep 10 00:29:34 2015
From: report at bugs.python.org (Martin Panter)
Date: Wed, 09 Sep 2015 22:29:34 +0000
Subject: [docs] [issue25043] document socket constants for Bluetooth
In-Reply-To: <1441810839.86.0.110626914047.issue25043@psf.upfronthosting.co.za>
Message-ID: <1441837774.79.0.977118401059.issue25043@psf.upfronthosting.co.za>


Martin Panter added the comment:

The new constant would probably have to go into 3.6 only. I suggest make two patches: your documentation patch to be applied to 3.4+, and the new constant, against 3.6 only. Also, it would be good to get a unit test for the new constant.

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

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

From report at bugs.python.org  Thu Sep 10 00:52:01 2015
From: report at bugs.python.org (Martin Panter)
Date: Wed, 09 Sep 2015 22:52:01 +0000
Subject: [docs] [issue24984] document AF_BLUETOOTH socket address formats
In-Reply-To: <1441210010.76.0.198064903239.issue24984@psf.upfronthosting.co.za>
Message-ID: <1441839121.84.0.674591159497.issue24984@psf.upfronthosting.co.za>


Martin Panter added the comment:

Hello again. The patch I committed says BTPROTO_SCO accepts a bytes-like object. However I suspect it is actually restricted to bytes only:

>>> s = socket(AF_BLUETOOTH, SOCK_SEQPACKET, BTPROTO_SCO)
>>> s.bind(bytearray(b"12:23:34:45:56:67"))
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
OSError: getsockaddrarg: wrong format
>>> s.bind(b"12:23:34:45:56:67")

If you can confirm this, I will update the documentation.

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

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

From report at bugs.python.org  Thu Sep 10 04:16:20 2015
From: report at bugs.python.org (Larry Hastings)
Date: Thu, 10 Sep 2015 02:16:20 +0000
Subject: [docs] [issue24272] PEP 484 docs
In-Reply-To: <1432415368.91.0.945654992881.issue24272@psf.upfronthosting.co.za>
Message-ID: <1441851380.08.0.855532321416.issue24272@psf.upfronthosting.co.za>


Larry Hastings added the comment:

Pull request accepted!  Please forward-merge, thanks!

----------

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

From report at bugs.python.org  Thu Sep 10 04:39:10 2015
From: report at bugs.python.org (Guido van Rossum)
Date: Thu, 10 Sep 2015 02:39:10 +0000
Subject: [docs] [issue24272] PEP 484 docs
In-Reply-To: <1432415368.91.0.945654992881.issue24272@psf.upfronthosting.co.za>
Message-ID: <1441852750.48.0.822316722716.issue24272@psf.upfronthosting.co.za>


Guido van Rossum added the comment:

Merged and pushed. Let's please use a new issue for any further patches.

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

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

From report at bugs.python.org  Thu Sep 10 15:02:37 2015
From: report at bugs.python.org (Tim Tisdall)
Date: Thu, 10 Sep 2015 13:02:37 +0000
Subject: [docs] [issue25043] document socket constants for Bluetooth
In-Reply-To: <1441810839.86.0.110626914047.issue25043@psf.upfronthosting.co.za>
Message-ID: <1441890157.31.0.806017964161.issue25043@psf.upfronthosting.co.za>


Tim Tisdall added the comment:

I'm not sure how to unit test a constant...  it's just a string.  If you're asking for a unit test for when you'd actually make use of the constant, I haven't been able to figure out that situation yet.  It seems like in Bluez 4.101 it's used to issue a command to all interfaces (but in contexts I don't quite understand), but in Bluez 5.XX there's no example or documentation of its use (it remains as a constant, though).  [looking through the Bluez git, I found where the constant was added in 2004 and the log message is simply "Add BDADDR_ALL constant"; http://git.kernel.org/cgit/bluetooth/bluez.git/commit/?id=c7b26f3e5d03e1d54dfb945e5ca0c041da524348 ]

----------

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

From report at bugs.python.org  Thu Sep 10 15:09:54 2015
From: report at bugs.python.org (Tim Tisdall)
Date: Thu, 10 Sep 2015 13:09:54 +0000
Subject: [docs] [issue25043] document socket constants for Bluetooth
In-Reply-To: <1441810839.86.0.110626914047.issue25043@psf.upfronthosting.co.za>
Message-ID: <1441890594.07.0.839379979726.issue25043@psf.upfronthosting.co.za>


Changes by Tim Tisdall <tisdall at gmail.com>:


----------
keywords: +patch
Added file: http://bugs.python.org/file40424/bdaddr_36_1.patch

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

From report at bugs.python.org  Thu Sep 10 15:10:04 2015
From: report at bugs.python.org (Tim Tisdall)
Date: Thu, 10 Sep 2015 13:10:04 +0000
Subject: [docs] [issue25043] document socket constants for Bluetooth
In-Reply-To: <1441810839.86.0.110626914047.issue25043@psf.upfronthosting.co.za>
Message-ID: <1441890604.71.0.0850325598397.issue25043@psf.upfronthosting.co.za>


Changes by Tim Tisdall <tisdall at gmail.com>:


Added file: http://bugs.python.org/file40425/bdaddr_34_1.patch

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

From report at bugs.python.org  Thu Sep 10 15:11:15 2015
From: report at bugs.python.org (Tim Tisdall)
Date: Thu, 10 Sep 2015 13:11:15 +0000
Subject: [docs] [issue25043] document socket constants for Bluetooth
In-Reply-To: <1441810839.86.0.110626914047.issue25043@psf.upfronthosting.co.za>
Message-ID: <1441890675.89.0.612838303607.issue25043@psf.upfronthosting.co.za>


Changes by Tim Tisdall <tisdall at gmail.com>:


Added file: http://bugs.python.org/file40426/bdaddr_35_1.patch

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

From report at bugs.python.org  Thu Sep 10 15:14:14 2015
From: report at bugs.python.org (Tim Tisdall)
Date: Thu, 10 Sep 2015 13:14:14 +0000
Subject: [docs] [issue24984] document AF_BLUETOOTH socket address formats
In-Reply-To: <1441210010.76.0.198064903239.issue24984@psf.upfronthosting.co.za>
Message-ID: <1441890854.06.0.374870743494.issue24984@psf.upfronthosting.co.za>


Tim Tisdall added the comment:

oops.  yeah, I got my terminology wrong.  It accepts only a byte-string.

----------

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

From report at bugs.python.org  Thu Sep 10 15:36:08 2015
From: report at bugs.python.org (Berker Peksag)
Date: Thu, 10 Sep 2015 13:36:08 +0000
Subject: [docs] [issue24272] PEP 484 docs
In-Reply-To: <1432415368.91.0.945654992881.issue24272@psf.upfronthosting.co.za>
Message-ID: <1441892168.75.0.63467850869.issue24272@psf.upfronthosting.co.za>


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


----------
resolution:  -> fixed
stage: patch review -> resolved

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

From report at bugs.python.org  Thu Sep 10 15:54:34 2015
From: report at bugs.python.org (Adam)
Date: Thu, 10 Sep 2015 13:54:34 +0000
Subject: [docs] [issue25041] document AF_PACKET socket address format
In-Reply-To: <1441804077.41.0.782475265278.issue25041@psf.upfronthosting.co.za>
Message-ID: <1441893274.95.0.935108965456.issue25041@psf.upfronthosting.co.za>


Changes by Adam <azsorkin at gmail.com>:


----------
nosy: +azsorkin

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

From report at bugs.python.org  Thu Sep 10 18:45:21 2015
From: report at bugs.python.org (Saimadhav Heblikar)
Date: Thu, 10 Sep 2015 16:45:21 +0000
Subject: [docs] [issue25059] Mistake in input-output tutorial regarding
 print() seperator
Message-ID: <1441903521.59.0.166588959306.issue25059@psf.upfronthosting.co.za>


New submission from Saimadhav Heblikar:

Feel free to make changes to the patch if you want to improve the sentence structure.

----------
assignee: docs at python
components: Documentation
messages: 250390
nosy: docs at python, sahutd
priority: normal
severity: normal
status: open
title: Mistake in input-output tutorial regarding print() seperator
versions: Python 3.5, Python 3.6

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

From report at bugs.python.org  Thu Sep 10 18:46:03 2015
From: report at bugs.python.org (Saimadhav Heblikar)
Date: Thu, 10 Sep 2015 16:46:03 +0000
Subject: [docs] [issue25059] Mistake in input-output tutorial regarding
 print() seperator
In-Reply-To: <1441903521.59.0.166588959306.issue25059@psf.upfronthosting.co.za>
Message-ID: <1441903563.21.0.32700059164.issue25059@psf.upfronthosting.co.za>


Changes by Saimadhav Heblikar <saimadhavheblikar at gmail.com>:


Added file: http://bugs.python.org/file40428/issue25059

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

From report at bugs.python.org  Thu Sep 10 19:11:14 2015
From: report at bugs.python.org (R. David Murray)
Date: Thu, 10 Sep 2015 17:11:14 +0000
Subject: [docs] [issue25059] Mistake in input-output tutorial regarding
 print() seperator
In-Reply-To: <1441903521.59.0.166588959306.issue25059@psf.upfronthosting.co.za>
Message-ID: <1441905074.19.0.108972211082.issue25059@psf.upfronthosting.co.za>


R. David Murray added the comment:

Well, it's a tutorial.  I'm not sure it makes sense to introduce sep at that point, that's more appropriate for when the user is more advanced and looking at the reference documentation.  (Frankly, I've *never* used that feature, and I've been using python for longer than it has had that feature :)  

I could see changing 'always' to 'by default' and leaving it at that, though.

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

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

From report at bugs.python.org  Thu Sep 10 19:17:50 2015
From: report at bugs.python.org (Eric V. Smith)
Date: Thu, 10 Sep 2015 17:17:50 +0000
Subject: [docs] [issue25059] Mistake in input-output tutorial regarding
 print() seperator
In-Reply-To: <1441903521.59.0.166588959306.issue25059@psf.upfronthosting.co.za>
Message-ID: <1441905470.27.0.410241243157.issue25059@psf.upfronthosting.co.za>


Eric V. Smith added the comment:

+1 on the "by default" change.

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

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

From report at bugs.python.org  Thu Sep 10 19:20:03 2015
From: report at bugs.python.org (Berker Peksag)
Date: Thu, 10 Sep 2015 17:20:03 +0000
Subject: [docs] [issue24272] PEP 484 docs
In-Reply-To: <1432415368.91.0.945654992881.issue24272@psf.upfronthosting.co.za>
Message-ID: <1441905603.4.0.932657817929.issue24272@psf.upfronthosting.co.za>


Berker Peksag added the comment:

By the way, for some reason the changes in revision e361130782d4 are not in Doc/library/typing.rst.

For example,

io documentation on current default branch: https://hg.python.org/cpython/file/default/Doc/library/typing.rst#l376
io documentation on current 3.5 branch: https://hg.python.org/cpython/file/3.5/Doc/library/typing.rst#l376
Updates to the io documntation in revision e361130782d4: https://hg.python.org/cpython/rev/e361130782d4#l1.67

Also, my clone is up-to-date:

changeset:   97855:d433d74e0377
tag:         tip
user:        Victor Stinner <victor.stinner at gmail.com>
date:        Thu Sep 10 16:00:06 2015 +0200
files:       Python/pytime.c
description:
pytime: oops, fix typos on Windows

----------

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

From report at bugs.python.org  Thu Sep 10 19:20:06 2015
From: report at bugs.python.org (Saimadhav Heblikar)
Date: Thu, 10 Sep 2015 17:20:06 +0000
Subject: [docs] [issue25059] Mistake in input-output tutorial regarding
 print() seperator
In-Reply-To: <1441903521.59.0.166588959306.issue25059@psf.upfronthosting.co.za>
Message-ID: <1441905606.1.0.265464796485.issue25059@psf.upfronthosting.co.za>


Saimadhav Heblikar added the comment:

Agreed with both David Murray and Eric.

----------

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

From report at bugs.python.org  Thu Sep 10 19:56:19 2015
From: report at bugs.python.org (Guido van Rossum)
Date: Thu, 10 Sep 2015 17:56:19 +0000
Subject: [docs] [issue24272] PEP 484 docs
In-Reply-To: <1441905603.4.0.932657817929.issue24272@psf.upfronthosting.co.za>
Message-ID: <CAP7+vJL73A1JEMU-tPycpUt==0n7Ng5sUVCMVzL4tnh3bxmwHg@mail.gmail.com>


Guido van Rossum added the comment:

I suck at merge. :-( No idea what happened. To fix it, I have now just
copied the file again from the larry branch and committed that in 3.5, then
merged up to 3.6 (default).

changeset:   97856:8a7814a3613b
branch:      3.5
parent:      97847:6c8e2c6e3a99
user:        Guido van Rossum <guido at python.org>
date:        Thu Sep 10 10:52:11 2015 -0700
summary:     Restore doc updates to typing.rst by Ivan Levkivskyi and
Daniel Andrade Groppe.

changeset:   97857:7fc4306d537b
tag:         tip
parent:      97855:d433d74e0377
parent:      97856:8a7814a3613b
user:        Guido van Rossum <guido at dropbox.com>
date:        Thu Sep 10 10:54:10 2015 -0700
summary:     Restore doc updates to typing.rst by Ivan Levkivskyi and
Daniel Andrade Groppe.

----------

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

From report at bugs.python.org  Thu Sep 10 20:33:32 2015
From: report at bugs.python.org (STINNER Victor)
Date: Thu, 10 Sep 2015 18:33:32 +0000
Subject: [docs] [issue25062] Doc linter error: [2] library/typing.rst:358:
 default role used
Message-ID: <1441910012.45.0.819788505611.issue25062@psf.upfronthosting.co.za>


New submission from STINNER Victor:

The Docs buildbot is red since the changeset 7fc4306d537b5feedb7f9dac54d96ed378c093a7.

http://buildbot.python.org/all/builders/Docs%203.x/builds/52

----------
assignee: docs at python
components: Documentation
messages: 250400
nosy: docs at python, gvanrossum, haypo
priority: normal
severity: normal
status: open
title: Doc linter error:  [2] library/typing.rst:358: default role used
versions: Python 3.6

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

From report at bugs.python.org  Thu Sep 10 21:16:34 2015
From: report at bugs.python.org (Guido van Rossum)
Date: Thu, 10 Sep 2015 19:16:34 +0000
Subject: [docs] [issue25062] Doc linter error: [2] library/typing.rst:358:
 default role used
In-Reply-To: <1441910012.45.0.819788505611.issue25062@psf.upfronthosting.co.za>
Message-ID: <1441912594.71.0.355699394793.issue25062@psf.upfronthosting.co.za>


Guido van Rossum added the comment:

That link gives me a timeout right now. How can I run the doc linter manually? "make html" in the Doc tree didn't alert me to this issue.

----------

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

From zachary.ware+pydocs at gmail.com  Thu Sep 10 21:24:18 2015
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Thu, 10 Sep 2015 14:24:18 -0500
Subject: [docs] [issue25062] Doc linter error: [2]
 library/typing.rst:358: default role used
In-Reply-To: <1441912594.71.0.355699394793.issue25062@psf.upfronthosting.co.za>
References: <1441910012.45.0.819788505611.issue25062@psf.upfronthosting.co.za>
 <1441912594.71.0.355699394793.issue25062@psf.upfronthosting.co.za>
Message-ID: <CAKJDb-NOd+CWGPhWZrgwk_5HfwvuTC=Z8P=zZa64yB+7V7Pavw@mail.gmail.com>

Guido van Rossum added the comment:
> That link gives me a timeout right now. How can I run the doc linter manually? "make html" in the Doc tree didn't alert me to this issue.

"make check" is the doc linter.

I've considered whether to back that buildbot off to only warn on
'lint' or 'suspicious' failure, but warnings aren't reported by the
IRC notifier.  Anyone else have an opinion on that?

From report at bugs.python.org  Thu Sep 10 21:25:01 2015
From: report at bugs.python.org (Guido van Rossum)
Date: Thu, 10 Sep 2015 19:25:01 +0000
Subject: [docs] [issue25062] Doc linter error: [2] library/typing.rst:358:
 default role used
In-Reply-To: <1441910012.45.0.819788505611.issue25062@psf.upfronthosting.co.za>
Message-ID: <1441913101.46.0.515135581893.issue25062@psf.upfronthosting.co.za>


Guido van Rossum added the comment:

Maybe Zach knows how to fix this since he fixed it for an earlier version? (Sorry Zach!)

----------
nosy: +zach.ware

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

From report at bugs.python.org  Thu Sep 10 21:26:39 2015
From: report at bugs.python.org (Zachary Ware)
Date: Thu, 10 Sep 2015 19:26:39 +0000
Subject: [docs] [issue25062] Doc linter error: [2] library/typing.rst:358:
 default role used
In-Reply-To: <1441910012.45.0.819788505611.issue25062@psf.upfronthosting.co.za>
Message-ID: <1441913199.12.0.854572272551.issue25062@psf.upfronthosting.co.za>


Zachary Ware added the comment:

Guido van Rossum added the comment:
> That link gives me a timeout right now. How can I run the doc linter manually? "make html" in the Doc tree didn't alert me to this issue.

"make check" is the doc linter.

I've considered whether to back that buildbot off to only warn on
'lint' or 'suspicious' failure, but warnings aren't reported by the
IRC notifier.  Anyone else have an opinion on that?


I'll try to get this fixed soonish, but if anyone can beat me to it, feel free :)

----------

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

From report at bugs.python.org  Thu Sep 10 21:31:58 2015
From: report at bugs.python.org (Zachary Ware)
Date: Thu, 10 Sep 2015 19:31:58 +0000
Subject: [docs] [issue25062] Doc linter error: [2] library/typing.rst:358:
 default role used
In-Reply-To: <1441910012.45.0.819788505611.issue25062@psf.upfronthosting.co.za>
Message-ID: <1441913518.36.0.988665835237.issue25062@psf.upfronthosting.co.za>


Zachary Ware added the comment:

Oh right, Berker already beat me to it:

changeset 97861:72e696bc480a 3.5

Fix typos and improve markup in typing.rst.
author 	Berker Peksag <berker.peksag at gmail.com>
date 	Thu, 10 Sep 2015 21:55:50 +0300 (35 minutes ago)
parents 	a380841644b2
children 	c52194da1ae2 47e9d7ddb06a
files 	Doc/library/typing.rst
diffstat 	1 files changed, 18 insertions(+), 19 deletions(-)

----------

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

From report at bugs.python.org  Thu Sep 10 21:32:58 2015
From: report at bugs.python.org (Zachary Ware)
Date: Thu, 10 Sep 2015 19:32:58 +0000
Subject: [docs] [issue25062] Doc linter error: [2] library/typing.rst:358:
 default role used
In-Reply-To: <1441910012.45.0.819788505611.issue25062@psf.upfronthosting.co.za>
Message-ID: <1441913578.53.0.171357871599.issue25062@psf.upfronthosting.co.za>


Changes by Zachary Ware <zachary.ware at gmail.com>:


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

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

From report at bugs.python.org  Thu Sep 10 21:37:04 2015
From: report at bugs.python.org (Guido van Rossum)
Date: Thu, 10 Sep 2015 19:37:04 +0000
Subject: [docs] [issue25062] Doc linter error: [2] library/typing.rst:358:
 default role used
In-Reply-To: <1441910012.45.0.819788505611.issue25062@psf.upfronthosting.co.za>
Message-ID: <1441913824.32.0.365105866026.issue25062@psf.upfronthosting.co.za>


Guido van Rossum added the comment:

Thanks everyone! This episode shows I should not try to commit CPython stuff. Period.

----------

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

From report at bugs.python.org  Thu Sep 10 22:03:49 2015
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 10 Sep 2015 20:03:49 +0000
Subject: [docs] [issue25022] Remove PC/example_nt/
In-Reply-To: <1441687350.45.0.29239152419.issue25022@psf.upfronthosting.co.za>
Message-ID: <20150910200346.12019.67628@psf.io>


Roundup Robot added the comment:

New changeset a30598e59964 by Zachary Ware in branch '2.7':
Issue #25022: Remove PC/example_nt/
https://hg.python.org/cpython/rev/a30598e59964

New changeset de3e1c81ecd7 by Zachary Ware in branch '3.4':
Issue #25022: Remove PC/example_nt/
https://hg.python.org/cpython/rev/de3e1c81ecd7

New changeset 2460fa584323 by Zachary Ware in branch '3.5':
Issue #25022: Merge with 3.4
https://hg.python.org/cpython/rev/2460fa584323

New changeset e1ddec83a311 by Zachary Ware in branch 'default':
Closes #25022: Merge with 3.5
https://hg.python.org/cpython/rev/e1ddec83a311

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

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

From report at bugs.python.org  Thu Sep 10 22:24:01 2015
From: report at bugs.python.org (Zachary Ware)
Date: Thu, 10 Sep 2015 20:24:01 +0000
Subject: [docs] [issue25022] Remove PC/example_nt/
In-Reply-To: <1441687350.45.0.29239152419.issue25022@psf.upfronthosting.co.za>
Message-ID: <1441916641.45.0.994907807269.issue25022@psf.upfronthosting.co.za>


Zachary Ware added the comment:

Erk...just discovered there's a section of Doc/extending/windows.rst that depends on example_nt that will need to be excised.

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

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

From report at bugs.python.org  Thu Sep 10 23:14:47 2015
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 10 Sep 2015 21:14:47 +0000
Subject: [docs] [issue25022] Remove PC/example_nt/
In-Reply-To: <1441687350.45.0.29239152419.issue25022@psf.upfronthosting.co.za>
Message-ID: <20150910211444.15714.12962@psf.io>


Roundup Robot added the comment:

New changeset 3456af022541 by Zachary Ware in branch '2.7':
Issue #25022: Add NEWS, fix docs to not mention the old example.
https://hg.python.org/cpython/rev/3456af022541

New changeset c535bf72aa60 by Zachary Ware in branch '3.4':
Issue #25022: Add NEWS, fix docs to not mention the old example.
https://hg.python.org/cpython/rev/c535bf72aa60

New changeset 70c97a626c41 by Zachary Ware in branch '3.5':
Issue #25022: Merge with 3.4
https://hg.python.org/cpython/rev/70c97a626c41

New changeset 8c436c36a4a7 by Zachary Ware in branch 'default':
Closes #25022 (again): Merge with 3.5
https://hg.python.org/cpython/rev/8c436c36a4a7

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

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

From report at bugs.python.org  Fri Sep 11 01:27:10 2015
From: report at bugs.python.org (Martin Panter)
Date: Thu, 10 Sep 2015 23:27:10 +0000
Subject: [docs] [issue25043] document socket constants for Bluetooth
In-Reply-To: <1441810839.86.0.110626914047.issue25043@psf.upfronthosting.co.za>
Message-ID: <1441927630.05.0.437480663971.issue25043@psf.upfronthosting.co.za>


Martin Panter added the comment:

Well if the constant is not very useful then maybe we shouldn?t add it :)

For testing, nothing complicated. Maybe check the module attributes exist, and are strings. In the past, people have converted module-level constants to enums, and introduced a typo in a name along the way. Even the simplest test case would pick up this sort of typo.

----------

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

From report at bugs.python.org  Fri Sep 11 04:07:25 2015
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 11 Sep 2015 02:07:25 +0000
Subject: [docs] [issue16893] Generate Idle help from Doc/library/idle.rst
In-Reply-To: <1357663512.19.0.739336896498.issue16893@psf.upfronthosting.co.za>
Message-ID: <1441937245.38.0.22781283014.issue16893@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

In msg185726 Ned said "Ironically, the Tk text widget is perfectly capable of rendering richer text styles." He was and is correct.  Mark Roseman offered to take up the challenge.  In spite of my skepticism, he went ahead and built sphinxview around HTMLParser.  This reduced the core of the problem to "for each tag, content, and end tag, what state change or text insertion is needed. The result is simple enough for me to understand and even edit.

I sent Mark a detailed comparison of the Firefox rendering of idle.html and his tk rendering.  He replied with a new version whose output is essentially identical to Firefox's (minus links), including the green example box.  I intend to use a third version and will work on a full patch.

When running in a repository clone, Idle could access ../../Doc/build/html/library/idle.html.  But for installations, idle.html needs to be in idlelib.  I guess the only was to guarantee this everywhere (excepting overt downstream removals) is to commit it into the repository, unlike most other files built from .rst files). 

To help make sure this happens, I would like to add a comment at the top of idle.rst.  The devguide sentence on comments is unclear to me. Will the following work?
.. # After editing this, also build html, copy idle.html to idlelib,
   test, and upload or commit the html diff also.

It would be nice if the copy and commit process were added to the release process, but I will go ahead even without that.  A nicely rendered, slightly out-of-date .html will be a great improvement over the current situation.

----------

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

From report at bugs.python.org  Fri Sep 11 04:36:39 2015
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 11 Sep 2015 02:36:39 +0000
Subject: [docs] [issue24984] document AF_BLUETOOTH socket address formats
In-Reply-To: <1441210010.76.0.198064903239.issue24984@psf.upfronthosting.co.za>
Message-ID: <20150911023636.15716.80430@psf.io>


Roundup Robot added the comment:

New changeset 00db99149cdd by Martin Panter <vadmium> in branch '3.4':
Issue #24984: BTPROTO_SCO supports only bytes objects
https://hg.python.org/cpython/rev/00db99149cdd

New changeset b507a7e79154 by Martin Panter <vadmium> in branch '3.5':
Issue #24984: Merge BTPROTO_SCO doc fix from 3.4 into 3.5
https://hg.python.org/cpython/rev/b507a7e79154

New changeset 7e4391155d9c by Martin Panter <vadmium> in branch 'default':
Issue #24984: Merge BTPROTO_SCO doc fix from 3.5
https://hg.python.org/cpython/rev/7e4391155d9c

----------

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

From report at bugs.python.org  Fri Sep 11 04:37:33 2015
From: report at bugs.python.org (Martin Panter)
Date: Fri, 11 Sep 2015 02:37:33 +0000
Subject: [docs] [issue24984] document AF_BLUETOOTH socket address formats
In-Reply-To: <1441210010.76.0.198064903239.issue24984@psf.upfronthosting.co.za>
Message-ID: <1441939053.14.0.7621804109.issue24984@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Sep 11 05:00:00 2015
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 11 Sep 2015 03:00:00 +0000
Subject: [docs] [issue25022] Remove PC/example_nt/
In-Reply-To: <1441687350.45.0.29239152419.issue25022@psf.upfronthosting.co.za>
Message-ID: <20150911025957.17981.39867@psf.io>


Roundup Robot added the comment:

New changeset 8ba735b018d2 by Martin Panter <vadmium> in branch '3.4':
Issue #25022: Avoid warning about unused suspicious rule
https://hg.python.org/cpython/rev/8ba735b018d2

New changeset b75b4a6e1c9b by Martin Panter <vadmium> in branch '3.5':
Issue #25022: Merge susp-ignored.csv from 3.4 into 3.5
https://hg.python.org/cpython/rev/b75b4a6e1c9b

New changeset 8902bcea59be by Martin Panter <vadmium> in branch 'default':
Issue #25022: Merge susp-ignored.csv from 3.5
https://hg.python.org/cpython/rev/8902bcea59be

New changeset 1a52db3ef0e8 by Martin Panter <vadmium> in branch '2.7':
Issue #25022: Avoid warning about unused suspicious rule
https://hg.python.org/cpython/rev/1a52db3ef0e8

----------

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

From report at bugs.python.org  Fri Sep 11 05:06:40 2015
From: report at bugs.python.org (Zachary Ware)
Date: Fri, 11 Sep 2015 03:06:40 +0000
Subject: [docs] [issue16893] Generate Idle help from Doc/library/idle.rst
In-Reply-To: <1357663512.19.0.739336896498.issue16893@psf.upfronthosting.co.za>
Message-ID: <1441940800.11.0.987500404001.issue16893@psf.upfronthosting.co.za>


Zachary Ware added the comment:

I'd be happy to work on making an 'idledoc' target for the Doc/ makefiles that works with Mark's viewer.  I can't guarantee any kind of timeframe, but the idledoc target wouldn't be necessary right off the bat; it could be done after the main bulk of the patch is committed.

As far as reST comments, the syntax is:

"""
.. This is a comment.
   This is still the same comment.
   And more of the same comment.

This is no longer part of the comment
"""

See http://docutils.sourceforge.net/docs/user/rst/quickref.html#comments

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

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

From report at bugs.python.org  Fri Sep 11 05:46:56 2015
From: report at bugs.python.org (Martin Panter)
Date: Fri, 11 Sep 2015 03:46:56 +0000
Subject: [docs] [issue25064] Adjust tempfile documentation for bytes
	filename support
Message-ID: <1441943216.0.0.731717269075.issue25064@psf.upfronthosting.co.za>


New submission from Martin Panter:

This is a followup to Issue 24230, which added support for bytes filenames to ?tempfile? module. Currently I think the documentation is misleading, for example it suggests the default values are prefix="tmp" and suffix="", when they are actually None to avoid forcing a text filename. I suggest this patch to fix the problem.

The patch also merges the paragraphs that describe ?suffix? and ?prefix?, and points out that mktemp() does not support these changes.

----------
assignee: docs at python
components: Documentation
files: tempfile-sig.patch
keywords: patch
messages: 250440
nosy: docs at python, gregory.p.smith, martin.panter
priority: normal
severity: normal
stage: patch review
status: open
title: Adjust tempfile documentation for bytes filename support
versions: Python 3.5, Python 3.6
Added file: http://bugs.python.org/file40431/tempfile-sig.patch

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

From report at bugs.python.org  Fri Sep 11 06:21:31 2015
From: report at bugs.python.org (=?utf-8?b?TWFydMOtbiBHYWl0w6Fu?=)
Date: Fri, 11 Sep 2015 04:21:31 +0000
Subject: [docs] [issue25065] https://docs.python.org/library should redirect
 to Python 3 doc
Message-ID: <1441945291.84.0.526704676456.issue25065@psf.upfronthosting.co.za>


New submission from Mart?n Gait?n:

The canonical link for documentation https://docs.python.org/ redirect to the index page of the stable Python 3's documentation 

However, https://docs.python.org/library still redirects to the Python 2 standard lib's docs. 

To be consequent https://docs.python.org/library should redirect to https://docs.python.org/3/library/

----------
assignee: docs at python
components: Documentation, Library (Lib)
messages: 250442
nosy: Mart?n Gait?n, docs at python
priority: normal
severity: normal
status: open
title: https://docs.python.org/library should redirect to Python 3 doc
type: enhancement

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

From report at bugs.python.org  Fri Sep 11 06:40:51 2015
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 11 Sep 2015 04:40:51 +0000
Subject: [docs] [issue25030] io.[Text]IOBase.seek doesn't take keyword
	parameter
In-Reply-To: <1441719881.64.0.378247085729.issue25030@psf.upfronthosting.co.za>
Message-ID: <20150911044047.101480.48575@psf.io>


Roundup Robot added the comment:

New changeset 0ca216f5276e by Martin Panter <vadmium> in branch '3.4':
Issue #25030: Do not document seek() as if it accepts keyword arguments
https://hg.python.org/cpython/rev/0ca216f5276e

New changeset 77784422da4d by Martin Panter <vadmium> in branch '2.7':
Issue #25030: Do not document seek() as if it accepts keyword arguments
https://hg.python.org/cpython/rev/77784422da4d

New changeset a0c6f5358029 by Martin Panter <vadmium> in branch '3.5':
Issue #25030: Merge seek() doc fixes from 3.4 into 3.5
https://hg.python.org/cpython/rev/a0c6f5358029

New changeset c4bb0da8b45e by Martin Panter <vadmium> in branch 'default':
Issue #25030: Merge seek() doc fixes from 3.5
https://hg.python.org/cpython/rev/c4bb0da8b45e

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

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

From report at bugs.python.org  Fri Sep 11 06:46:29 2015
From: report at bugs.python.org (Martin Panter)
Date: Fri, 11 Sep 2015 04:46:29 +0000
Subject: [docs] [issue25030] io.[Text]IOBase.seek doesn't take keyword
	parameter
In-Reply-To: <1441719881.64.0.378247085729.issue25030@psf.upfronthosting.co.za>
Message-ID: <1441946789.03.0.20831336994.issue25030@psf.upfronthosting.co.za>


Martin Panter added the comment:

Thanks for the patch. I took the liberty of also fixing the doc string of BytesIO.seek().

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

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

From report at bugs.python.org  Fri Sep 11 06:53:03 2015
From: report at bugs.python.org (Davin Potts)
Date: Fri, 11 Sep 2015 04:53:03 +0000
Subject: [docs] [issue23484] SemLock acquire() keyword arg 'blocking' is
	invalid
In-Reply-To: <1424345474.95.0.767809945273.issue23484@psf.upfronthosting.co.za>
Message-ID: <1441947183.45.0.0182199604267.issue23484@psf.upfronthosting.co.za>


Davin Potts added the comment:

@berker.peksag, @r.david.murray: Could I gently nudge one of you into committing the final versions of these patches?

----------

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

From report at bugs.python.org  Fri Sep 11 06:57:10 2015
From: report at bugs.python.org (Zachary Ware)
Date: Fri, 11 Sep 2015 04:57:10 +0000
Subject: [docs] [issue25065] https://docs.python.org/library should redirect
 to Python 3 doc
In-Reply-To: <1441945291.84.0.526704676456.issue25065@psf.upfronthosting.co.za>
Message-ID: <1441947430.0.0.259161594155.issue25065@psf.upfronthosting.co.za>


Zachary Ware added the comment:

This is by design, see PEP 430 for rationale.  Eventually the Python 3 docs will be the default, but that day isn't quite here yet.

----------
nosy: +zach.ware
resolution:  -> not a bug
stage:  -> resolved
status: open -> closed

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

From allardguillaume at orange.fr  Wed Sep  9 09:08:48 2015
From: allardguillaume at orange.fr (Guillaume ALLARD)
Date: Wed, 09 Sep 2015 09:08:48 +0200
Subject: [docs] [BUG REPORT 2.7.10] ValueError: invalid \x escape
Message-ID: <55EFDB00.8030205@orange.fr>

Hello,

Python 2.7.10, Windows 7

"ValueError: invalid \x escape"

Note that there is no indication of where is the error (no line number).


the faulty ligne is a # commented line inside a """ commented block.

"""
. . .
         #s.send("PRIVMSG bot :!voice %s\x\n" % n)
. . .
"""

changing "\x" to "\x12" (for example) fixes the error.



From kolesnikovichdn at gmail.com  Tue Sep  8 14:39:21 2015
From: kolesnikovichdn at gmail.com (Dmitry Kolesnikovich)
Date: Tue, 8 Sep 2015 15:39:21 +0300
Subject: [docs] Bug in web site
Message-ID: <CAJfQ8zACbmOwqKtuHbEgpj3QxqbrZ52DqOK--AiTxYYfZDCSnA@mail.gmail.com>

Bug in web site http://www.screencast.com/t/m4BGUJZc0
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20150908/aa333750/attachment-0001.html>

From report at bugs.python.org  Fri Sep 11 11:52:30 2015
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 11 Sep 2015 09:52:30 +0000
Subject: [docs] [issue23484] SemLock acquire() keyword arg 'blocking' is
	invalid
In-Reply-To: <1424345474.95.0.767809945273.issue23484@psf.upfronthosting.co.za>
Message-ID: <1441965150.1.0.862495900784.issue23484@psf.upfronthosting.co.za>


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


----------
assignee: docs at python -> berker.peksag
versions: +Python 3.6

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

From berker.peksag at gmail.com  Fri Sep 11 11:46:40 2015
From: berker.peksag at gmail.com (=?UTF-8?Q?Berker_Peksa=C4=9F?=)
Date: Fri, 11 Sep 2015 12:46:40 +0300
Subject: [docs] Bug in web site
In-Reply-To: <CAJfQ8zACbmOwqKtuHbEgpj3QxqbrZ52DqOK--AiTxYYfZDCSnA@mail.gmail.com>
References: <CAJfQ8zACbmOwqKtuHbEgpj3QxqbrZ52DqOK--AiTxYYfZDCSnA@mail.gmail.com>
Message-ID: <CAF4280LEkRtnhqB1h2JvX84iMbyEh9hddshFWevLUm3kpbUUbQ@mail.gmail.com>

On Tue, Sep 8, 2015 at 3:39 PM, Dmitry Kolesnikovich
<kolesnikovichdn at gmail.com> wrote:
> Bug in web site http://www.screencast.com/t/m4BGUJZc0

Thanks for the report and the screencast, Dmitry. Looks like this is
exactly http://bugs.python.org/issue24712 Can you please post the
screencast link to the issue?

--Berker

From julien.marechal at prng.nl  Fri Sep 11 14:52:09 2015
From: julien.marechal at prng.nl (Julien Marechal)
Date: Fri, 11 Sep 2015 14:52:09 +0200
Subject: [docs] encodings.aliases.aliases sjis2004 missing
Message-ID: <7D8FC46E-984E-4AE1-8EFF-1EF27151DF1B@prng.nl>

Hi,

In the documentation of the codecs module section standard encodings: https://docs.python.org/3/library/codecs.html#standard-encodings <https://docs.python.org/3/library/codecs.html#standard-encodings>

sjis2004 is listed as an alias for shift_jis_2004 but is not in ?encodings.aliases.aliases?
Therefore the lookup codecs.lookup('sjis2004?) fails and it?s inconsistent with the documentation.

I don?t know wether the doc or the code should be fixed, that up to you.

reply to: julien.marechal35 at gmail35.com <mailto:julien.marechal35 at gmail35.com> if need be.
Cheers,
Julien

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20150911/798b4cf1/attachment.html>

From report at bugs.python.org  Fri Sep 11 15:50:45 2015
From: report at bugs.python.org (Tim Tisdall)
Date: Fri, 11 Sep 2015 13:50:45 +0000
Subject: [docs] [issue25043] document socket constants for Bluetooth
In-Reply-To: <1441810839.86.0.110626914047.issue25043@psf.upfronthosting.co.za>
Message-ID: <1441979445.16.0.708399235375.issue25043@psf.upfronthosting.co.za>


Tim Tisdall added the comment:

Okay, since there's currently no existing tests for the Bluetooth components of socket and the only example for BDADDR_ALL seems to be for something I'm not sure you can do in socket, I'm just going to not bother including it.

I've attached a 3.6 patch without BDADDR_ALL.

----------
Added file: http://bugs.python.org/file40438/bdaddr_36_2.patch

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

From report at bugs.python.org  Fri Sep 11 15:50:48 2015
From: report at bugs.python.org (Antti Haapala)
Date: Fri, 11 Sep 2015 13:50:48 +0000
Subject: [docs] [issue25070] Python 2.6 - Python 3.4 allows unparenthesized
 generator with *args, **kw, forbidden in 3.5
In-Reply-To: <1441976624.09.0.810536371871.issue25070@psf.upfronthosting.co.za>
Message-ID: <1441979447.98.0.0509681377391.issue25070@psf.upfronthosting.co.za>


Antti Haapala added the comment:

Yeah, it is a bug in 2.5 too; https://docs.python.org/2.5/ref/calls.html

    call ::= primary "(" [argument_list [","]
		         | expression genexpr_for] ")"

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

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

From report at bugs.python.org  Fri Sep 11 16:27:51 2015
From: report at bugs.python.org (Nikita Klimov)
Date: Fri, 11 Sep 2015 14:27:51 +0000
Subject: [docs] [issue24899] Add an os.path <=> pathlib equivalence table in
 pathlib docs
In-Reply-To: <1440050617.44.0.44226546659.issue24899@psf.upfronthosting.co.za>
Message-ID: <1441981671.28.0.501358131973.issue24899@psf.upfronthosting.co.za>


Changes by Nikita Klimov <nikita at klimov.us>:


----------
nosy: +klimov

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

From report at bugs.python.org  Fri Sep 11 16:30:57 2015
From: report at bugs.python.org (Tim Tisdall)
Date: Fri, 11 Sep 2015 14:30:57 +0000
Subject: [docs] [issue25043] document socket constants for Bluetooth
In-Reply-To: <1441810839.86.0.110626914047.issue25043@psf.upfronthosting.co.za>
Message-ID: <1441981857.21.0.165501205044.issue25043@psf.upfronthosting.co.za>


Tim Tisdall added the comment:

okay, I talked to one of the Bluez developers and he recommended leaving out BDADDR_ALL since it doesn't seem to correspond to anything in the kernel.

----------

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

From pierre.wadier at turboconcept.com  Fri Sep 11 15:09:32 2015
From: pierre.wadier at turboconcept.com (Pierre Wadier)
Date: Fri, 11 Sep 2015 15:09:32 +0200
Subject: [docs] Bug in doc for python 3 / argparse module
Message-ID: <AF0093C5-D5F8-46C8-8C32-DC88423238BE@turboconcept.com>

For actions 'store_false' and 'store_true', python 2 doc mentioned the default values (true / false)
This info is no longer visible in python 3 doc: https://docs.python.org/3/library/argparse.html#action

Thanks,
Pierre

From ndunn at webucator.com  Fri Sep 11 17:17:25 2015
From: ndunn at webucator.com (Nat Dunn)
Date: Fri, 11 Sep 2015 11:17:25 -0400
Subject: [docs] Small typo on CSV documentation
Message-ID: <CALmHF7gXMW37ddRByNf+K6hJRtwEPQwjqPyOQrs_zvsH91LytA@mail.gmail.com>

Hello,

There is a small bug at https://docs.python.org/3/library/csv.html. The
word "be" is repeated. I believe the first one (in red) should be removed.

Dialect.doublequote
<https://docs.python.org/3/library/csv.html#csv.Dialect.doublequote>

Controls how instances of *quotechar* appearing inside a field should
be themselves
be quoted.
Nat

-- 
Nat Dunn
CIO, Webucator
https://www.webucator.com <http://www.webucator.com>
877-932-8228 x221
315-849-2724 x221
- - - - - - - - - - - - - - - - - -
View our Instructor-Led Online class schedule
<https://www.webucator.com/ilo/schedule.cfm>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20150911/8167fe51/attachment-0001.html>

From zachary.ware+pydocs at gmail.com  Fri Sep 11 17:49:35 2015
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Fri, 11 Sep 2015 10:49:35 -0500
Subject: [docs] [BUG REPORT 2.7.10] ValueError: invalid \x escape
In-Reply-To: <55EFDB00.8030205@orange.fr>
References: <55EFDB00.8030205@orange.fr>
Message-ID: <CAKJDb-OrRM-+aR_M1s-JzeK1OD9Ldqnf-D2V94itQTwYaBHHAw@mail.gmail.com>

Hi,

On Wed, Sep 9, 2015 at 2:08 AM, Guillaume ALLARD
<allardguillaume at orange.fr> wrote:
> Hello,
>
> Python 2.7.10, Windows 7
>
> "ValueError: invalid \x escape"
>
> Note that there is no indication of where is the error (no line number).
>
>
> the faulty ligne is a # commented line inside a """ commented block.
>
> """
> . . .
>         #s.send("PRIVMSG bot :!voice %s\x\n" % n)
> . . .
> """
>
> changing "\x" to "\x12" (for example) fixes the error.

This is not a bug.  Triple-quoted strings are strings, not comments,
and the '#' character in a string is just a '#', not a comment marker.

Also, for future reference, this is not the correct list for reporting
bugs (other than documentation bugs); see bugs.python.org for the
Python bug tracker.

Hope this helps,
-- 
Zach

From zachary.ware+pydocs at gmail.com  Fri Sep 11 17:54:09 2015
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Fri, 11 Sep 2015 10:54:09 -0500
Subject: [docs] Small typo on CSV documentation
In-Reply-To: <CALmHF7gXMW37ddRByNf+K6hJRtwEPQwjqPyOQrs_zvsH91LytA@mail.gmail.com>
References: <CALmHF7gXMW37ddRByNf+K6hJRtwEPQwjqPyOQrs_zvsH91LytA@mail.gmail.com>
Message-ID: <CAKJDb-MKSUu=LieXzt+3OrqYCWbggn8526Uxgip3_QkH9HaAPA@mail.gmail.com>

Hi,

On Fri, Sep 11, 2015 at 10:17 AM, Nat Dunn <ndunn at webucator.com> wrote:
> Hello,
>
> There is a small bug at https://docs.python.org/3/library/csv.html. The word
> "be" is repeated. I believe the first one (in red) should be removed.

Thanks for the report!  This has now been fixed.

-- 
Zach

From ndunn at webucator.com  Fri Sep 11 17:59:01 2015
From: ndunn at webucator.com (Nat Dunn)
Date: Fri, 11 Sep 2015 11:59:01 -0400
Subject: [docs] Small typo on CSV documentation
In-Reply-To: <CAKJDb-MKSUu=LieXzt+3OrqYCWbggn8526Uxgip3_QkH9HaAPA@mail.gmail.com>
References: <CALmHF7gXMW37ddRByNf+K6hJRtwEPQwjqPyOQrs_zvsH91LytA@mail.gmail.com>
 <CAKJDb-MKSUu=LieXzt+3OrqYCWbggn8526Uxgip3_QkH9HaAPA@mail.gmail.com>
Message-ID: <CALmHF7i+e3zYn0PJw=mEAwv1TyQn5tUQRtd3Wt2KUckCKiJ6SA@mail.gmail.com>

Cool beans. You're welcome.

Nat

On Fri, Sep 11, 2015 at 11:54 AM, Zachary Ware <
zachary.ware+pydocs at gmail.com> wrote:

> Hi,
>
> On Fri, Sep 11, 2015 at 10:17 AM, Nat Dunn <ndunn at webucator.com> wrote:
> > Hello,
> >
> > There is a small bug at https://docs.python.org/3/library/csv.html. The
> word
> > "be" is repeated. I believe the first one (in red) should be removed.
>
> Thanks for the report!  This has now been fixed.
>
> --
> Zach
>



-- 
Nat Dunn
CIO, Webucator
https://www.webucator.com <http://www.webucator.com>
877-932-8228 x221
315-849-2724 x221
- - - - - - - - - - - - - - - - - -
View our Instructor-Led Online class schedule
<https://www.webucator.com/ilo/schedule.cfm>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20150911/ce73c229/attachment.html>

From report at bugs.python.org  Fri Sep 11 20:09:38 2015
From: report at bugs.python.org (Zachary Ware)
Date: Fri, 11 Sep 2015 18:09:38 +0000
Subject: [docs] [issue25073] Document asyncio.test_utils
Message-ID: <1441994978.81.0.376266304966.issue25073@psf.upfronthosting.co.za>


New submission from Zachary Ware:

asyncio.test_utils is not documented.  I'm unsure as to whether that's because it's meant to be private, or if it just hasn't been done yet.

----------
assignee: docs at python
components: Documentation, asyncio
messages: 250482
nosy: docs at python, gvanrossum, haypo, yselivanov, zach.ware
priority: normal
severity: normal
stage: needs patch
status: open
title: Document asyncio.test_utils
type: enhancement
versions: Python 3.4, Python 3.5, Python 3.6

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

From report at bugs.python.org  Fri Sep 11 20:15:43 2015
From: report at bugs.python.org (Yury Selivanov)
Date: Fri, 11 Sep 2015 18:15:43 +0000
Subject: [docs] [issue25073] Document asyncio.test_utils
In-Reply-To: <1441994978.81.0.376266304966.issue25073@psf.upfronthosting.co.za>
Message-ID: <1441995343.59.0.862172934834.issue25073@psf.upfronthosting.co.za>


Yury Selivanov added the comment:

It's meant to be private.

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

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

From report at bugs.python.org  Fri Sep 11 20:17:01 2015
From: report at bugs.python.org (Guido van Rossum)
Date: Fri, 11 Sep 2015 18:17:01 +0000
Subject: [docs] [issue25073] Document asyncio.test_utils
In-Reply-To: <1441994978.81.0.376266304966.issue25073@psf.upfronthosting.co.za>
Message-ID: <1441995421.91.0.484835201408.issue25073@psf.upfronthosting.co.za>


Guido van Rossum added the comment:

Agreed, but then why isn't it in the tests directory? There are some examples in the asyncio repo on GitHub that use test_utils.dummy_ssl_context(), and that's probably why; but that's a fairly bad practice plus it's really a one-liner.

----------

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

From report at bugs.python.org  Fri Sep 11 21:32:05 2015
From: report at bugs.python.org (Yury Selivanov)
Date: Fri, 11 Sep 2015 19:32:05 +0000
Subject: [docs] [issue25073] Document asyncio.test_utils
In-Reply-To: <1441994978.81.0.376266304966.issue25073@psf.upfronthosting.co.za>
Message-ID: <1441999925.45.0.998905554996.issue25073@psf.upfronthosting.co.za>


Yury Selivanov added the comment:

> Agreed, but then why isn't it in the tests directory?

I think that the main reason is to make it possible for tests to import some common functionality from 'asyncio' package, when you run them from the cloned github asyncio repo.

In fact, I think we should prefix the module with an underscore.

----------

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

From report at bugs.python.org  Fri Sep 11 22:15:18 2015
From: report at bugs.python.org (Guido van Rossum)
Date: Fri, 11 Sep 2015 20:15:18 +0000
Subject: [docs] [issue25073] Document asyncio.test_utils
In-Reply-To: <1441994978.81.0.376266304966.issue25073@psf.upfronthosting.co.za>
Message-ID: <1442002518.7.0.161262743375.issue25073@psf.upfronthosting.co.za>


Guido van Rossum added the comment:

The _ is a good idea. Please do fix up the examples!

----------

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

From report at bugs.python.org  Fri Sep 11 23:36:19 2015
From: report at bugs.python.org (Martin Panter)
Date: Fri, 11 Sep 2015 21:36:19 +0000
Subject: [docs] [issue25043] document socket constants for Bluetooth
In-Reply-To: <1441810839.86.0.110626914047.issue25043@psf.upfronthosting.co.za>
Message-ID: <1442007379.84.0.380517989694.issue25043@psf.upfronthosting.co.za>


Martin Panter added the comment:

Thanks for your work on this. I think the patch is good, although I might add :const:`BDADDR_ANY` etc markup around the references within the text.

By the way, you don?t normally need to make separate patches for each branch. When I commit this I will just apply the 3.4 version, and then automatically merging to the other branches should be trivial.

----------
assignee: docs at python -> martin.panter
nosy: +berker.peksag
stage:  -> commit review

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

From report at bugs.python.org  Fri Sep 11 23:40:29 2015
From: report at bugs.python.org (R. David Murray)
Date: Fri, 11 Sep 2015 21:40:29 +0000
Subject: [docs] [issue25070] Python 2.6 - Python 3.4 allows unparenthesized
 generator with *args, **kw, forbidden in 3.5
In-Reply-To: <1441976624.09.0.810536371871.issue25070@psf.upfronthosting.co.za>
Message-ID: <1442007629.68.0.953844035676.issue25070@psf.upfronthosting.co.za>


R. David Murray added the comment:

If we have decided that this is a "fixed bug", it should indeed be mentioned in what's new for 3.5 since it is a behavior change.

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

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

From report at bugs.python.org  Sat Sep 12 01:32:13 2015
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 11 Sep 2015 23:32:13 +0000
Subject: [docs] [issue25043] document socket constants for Bluetooth
In-Reply-To: <1441810839.86.0.110626914047.issue25043@psf.upfronthosting.co.za>
Message-ID: <20150911233210.11272.73855@psf.io>


Roundup Robot added the comment:

New changeset 152568976062 by Martin Panter <vadmium> in branch '3.4':
Issue #25043: Document BDADDR_ and HCI_ Bluetooth socket constants
https://hg.python.org/cpython/rev/152568976062

New changeset 3f475417eadd by Martin Panter <vadmium> in branch '3.5':
Issue #25043: Merge Bluetooth doc from 3.4 into 3.5
https://hg.python.org/cpython/rev/3f475417eadd

New changeset 5325233f117d by Martin Panter <vadmium> in branch 'default':
Issue #25043: Merge Bluetooth doc from 3.5
https://hg.python.org/cpython/rev/5325233f117d

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

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

From report at bugs.python.org  Sat Sep 12 01:33:48 2015
From: report at bugs.python.org (Martin Panter)
Date: Fri, 11 Sep 2015 23:33:48 +0000
Subject: [docs] [issue25043] document socket constants for Bluetooth
In-Reply-To: <1441810839.86.0.110626914047.issue25043@psf.upfronthosting.co.za>
Message-ID: <1442014428.43.0.569542736762.issue25043@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Sep 12 02:50:28 2015
From: report at bugs.python.org (Martin Panter)
Date: Sat, 12 Sep 2015 00:50:28 +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: <1442019028.11.0.339658825491.issue16473@psf.upfronthosting.co.za>


Martin Panter added the comment:

Will commit a slightly modified version of my doc patch to 3.4+, since mentioning the wrong functions is confusing. But I think we still need to fix the ?binascii? decoding, and have a look at Alejandro?s test suite patch.

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

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

From report at bugs.python.org  Sat Sep 12 03:44:43 2015
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 12 Sep 2015 01:44:43 +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: <20150912014439.101474.27888@psf.io>


Roundup Robot added the comment:

New changeset de82f41d6669 by Martin Panter <vadmium> in branch '3.4':
Issue #16473: Fix byte transform codec documentation; test quotetabs=True
https://hg.python.org/cpython/rev/de82f41d6669

New changeset 28cd11dc2915 by Martin Panter <vadmium> in branch '3.5':
Issue #16473: Merge codecs doc and test from 3.4 into 3.5
https://hg.python.org/cpython/rev/28cd11dc2915

New changeset 3ecb5766ba15 by Martin Panter <vadmium> in branch 'default':
Issue #16473: Merge codecs doc and test from 3.5
https://hg.python.org/cpython/rev/3ecb5766ba15

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

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

From report at bugs.python.org  Sat Sep 12 04:56:31 2015
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 12 Sep 2015 02:56:31 +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: <20150912025628.101482.81649@psf.io>


Roundup Robot added the comment:

New changeset cfb0481c89d7 by Martin Panter <vadmium> in branch '2.7':
Issue #16473: Fix byte transform codec documentation; test quotetabs=True
https://hg.python.org/cpython/rev/cfb0481c89d7

----------

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

From report at bugs.python.org  Sat Sep 12 05:28:12 2015
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 12 Sep 2015 03:28:12 +0000
Subject: [docs] [issue25070] Python 2.6 - Python 3.4 allows unparenthesized
 generator with *args, **kw, forbidden in 3.5
In-Reply-To: <1441976624.09.0.810536371871.issue25070@psf.upfronthosting.co.za>
Message-ID: <1442028492.36.0.63963771503.issue25070@psf.upfronthosting.co.za>


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


----------
versions:  -Python 3.2, Python 3.3

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

From report at bugs.python.org  Sat Sep 12 05:36:39 2015
From: report at bugs.python.org (Yury Selivanov)
Date: Sat, 12 Sep 2015 03:36:39 +0000
Subject: [docs] [issue25070] Python 2.6 - Python 3.4 allows unparenthesized
 generator with *args, **kw, forbidden in 3.5
In-Reply-To: <1441976624.09.0.810536371871.issue25070@psf.upfronthosting.co.za>
Message-ID: <1442028999.19.0.556956771241.issue25070@psf.upfronthosting.co.za>


Yury Selivanov added the comment:

> If we have decided that this is a "fixed bug", [..]

I'd call this a bug fix.  The old syntax was completely unreadable.  

Should I close this issue?

> [..] it should indeed be mentioned in what's new for 3.5 since it is a behavior change.

Sure, I'll document it.

----------

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

From report at bugs.python.org  Sat Sep 12 06:41:06 2015
From: report at bugs.python.org (TAKASE Arihiro)
Date: Sat, 12 Sep 2015 04:41:06 +0000
Subject: [docs] [issue25076] Wrong parameter name in distutils documentation
Message-ID: <1442032866.5.0.225181106977.issue25076@psf.upfronthosting.co.za>


New submission from TAKASE Arihiro:

In Doc/distutils/apiref.rst, the palameter name of CCompiler.library_option is *lib*, but written *dir* in the documentation.

This also applies to the docstring of CCompiler.library_option().

The attached patch fixes it.

----------
assignee: docs at python
components: Documentation
files: library_option.patch
keywords: patch
messages: 250512
nosy: artakase, docs at python
priority: normal
severity: normal
status: open
title: Wrong parameter name in distutils documentation
type: behavior
versions: Python 2.7, Python 3.4, Python 3.5, Python 3.6
Added file: http://bugs.python.org/file40444/library_option.patch

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

From report at bugs.python.org  Sat Sep 12 10:13:33 2015
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 12 Sep 2015 08:13:33 +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: <1442045613.7.0.366954579249.issue16473@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

Mentioned functions are not exact equivalents of codecs. They are preferable way to to obtain the similar (apart from minor details) output.

----------
nosy: +ncoghlan, serhiy.storchaka

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

From report at bugs.python.org  Sat Sep 12 11:46:44 2015
From: report at bugs.python.org (Thomas Kluyver)
Date: Sat, 12 Sep 2015 09:46:44 +0000
Subject: [docs] [issue25078] Document InstallAllUsers installer parameter
	default 0
Message-ID: <1442051204.9.0.216289255081.issue25078@psf.upfronthosting.co.za>


New submission from Thomas Kluyver:

In testing the 3.5.0rc4 default installer, I found that the default for InstallAllUsers appears to be 0, whereas it's currently documented as 1.

----------
assignee: docs at python
components: Documentation
files: installallusers-default.patch
keywords: patch
messages: 250515
nosy: docs at python, steve.dower, takluyver
priority: normal
severity: normal
status: open
title: Document InstallAllUsers installer parameter default 0
versions: Python 3.5, Python 3.6
Added file: http://bugs.python.org/file40445/installallusers-default.patch

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

From report at bugs.python.org  Sat Sep 12 14:04:42 2015
From: report at bugs.python.org (Stefan Krah)
Date: Sat, 12 Sep 2015 12:04:42 +0000
Subject: [docs] [issue25079] Tokenize generates NL instead of NEWLINE for
	comments
In-Reply-To: <1442051359.49.0.451935650182.issue25079@psf.upfronthosting.co.za>
Message-ID: <1442059481.94.0.483118983059.issue25079@psf.upfronthosting.co.za>


Stefan Krah added the comment:

See:

https://docs.python.org/3/reference/lexical_analysis.html#blank-lines

----------
assignee:  -> docs at python
components: +Documentation -Interpreter Core
nosy: +docs at python, skrah
resolution:  -> not a bug
stage:  -> resolved
status: open -> closed
type: behavior -> 

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

From report at bugs.python.org  Sat Sep 12 14:08:35 2015
From: report at bugs.python.org (Kostis ankostis)
Date: Sat, 12 Sep 2015 12:08:35 +0000
Subject: [docs] [issue25080] The example-code for making XLM-RPC requests
 through proxy, fail!
Message-ID: <1442059715.67.0.31958758043.issue25080@psf.upfronthosting.co.za>


New submission from Kostis ankostis:

The example code provided at the bottom of the reference-page: 
  https://docs.python.org/2/library/xmlrpclib.html#example-of-client-usage
for making XML-RPC requests through a proxy by defining a custom transport fails (at least) in python-3.4!

Obviously it has been kept intact from `xmlrpclib` python-2 but `xmlrpc.client` API has changed and consequently the code fails.
Here is a IPython session demonstratin the problem:

    >>> import xmlrpc.client, http.client
    >>>
    >>> class ProxiedTransport(xmlrpc.client.Transport):
    ...     def set_proxy(self, proxy):
    ...         self.proxy = proxy
    ...     def make_connection(self, host):
    ...         self.realhost = host
    ...         h = http.client.HTTP(self.proxy)
    ...         return h
    ...     def send_request(self, connection, handler, request_body):
    ...         connection.putrequest("POST", 'http://%s%s' % (self.realhost, handler))
    ...     def send_host(self, connection, host):
    ...         connection.putheader('Host', self.realhost)
    ...
    >>> p = ProxiedTransport()
    >>> p.set_proxy('proxy-server:8080')
    >>> server = xmlrpc.client.Server('http://time.xmlrpc.com/RPC2', transport=p)
    >>> print(server.currentTime.getCurrentTime())
    Traceback (most recent call last):
      File "D:\Apps\WinPython-64bit-3.4.3.4\python-3.4.3.amd64\lib\site-packages\IPython\core\interactiveshell.py", line 3035, in run_code
        exec(code_obj, self.user_global_ns, self.user_ns)
      File "<ipython-input-43-7f4e26b6cd8f>", line 1, in <module>
        print(server.currentTime.getCurrentTime())
      File "D:\Apps\WinPython-64bit-3.4.3.4\python-3.4.3.amd64\lib\xmlrpc\client.py", line 1098, in __call__
        return self.__send(self.__name, args)
      File "D:\Apps\WinPython-64bit-3.4.3.4\python-3.4.3.amd64\lib\xmlrpc\client.py", line 1437, in __request
        verbose=self.__verbose
      File "D:\Apps\WinPython-64bit-3.4.3.4\python-3.4.3.amd64\lib\xmlrpc\client.py", line 1140, in request
        return self.single_request(host, handler, request_body, verbose)
      File "D:\Apps\WinPython-64bit-3.4.3.4\python-3.4.3.amd64\lib\xmlrpc\client.py", line 1152, in single_request
        http_conn = self.send_request(host, handler, request_body, verbose)
    TypeError: send_request() takes 4 positional arguments but 5 were given

----------
assignee: docs at python
components: Demos and Tools, Documentation
messages: 250518
nosy: Kostis ankostis, docs at python
priority: normal
severity: normal
status: open
title: The example-code for making XLM-RPC requests through proxy, fail!
versions: Python 3.4

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

From report at bugs.python.org  Sat Sep 12 14:10:46 2015
From: report at bugs.python.org (Stefan Krah)
Date: Sat, 12 Sep 2015 12:10:46 +0000
Subject: [docs] [issue25070] Python 2.6 - Python 3.4 allows unparenthesized
 generator with *args, **kw, forbidden in 3.5
In-Reply-To: <1441976624.09.0.810536371871.issue25070@psf.upfronthosting.co.za>
Message-ID: <1442059846.52.0.816387163894.issue25070@psf.upfronthosting.co.za>


Stefan Krah added the comment:

I think the issue can be closed (after updating "what's new").

Even if we wanted to keep backwards compatibility, it's too
late now.

----------

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

From report at bugs.python.org  Sat Sep 12 14:16:04 2015
From: report at bugs.python.org (Martin Panter)
Date: Sat, 12 Sep 2015 12:16:04 +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: <1442060164.44.0.759167319037.issue16473@psf.upfronthosting.co.za>


Martin Panter added the comment:

The list of functions were added in Issue 17844. I made the change today because I forgot that the listed functions weren?t exactly equivalent when investigating Issue 25075.

Base64-codec encodes to multiple lines, but b64encode() returns the raw encoding without line breaks. I see that base64.encodebytes() is listed as a ?legacy interface?, but as far as I can tell nothing outside the legacy interface does any line splitting.

Hex-codec encodes to lowercase, but b16encode() returns uppercase, following RFC 4648.

Quopri-codec encodes all whitespace, but quopri.encodestring() lets most whitespace through verbatim by default. In this case I think it would be reasonable to change back to encodestring() if we say that quotetabs=True is passed in.

----------

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

From report at bugs.python.org  Sat Sep 12 23:43:39 2015
From: report at bugs.python.org (Nikita Klimov)
Date: Sat, 12 Sep 2015 21:43:39 +0000
Subject: [docs] [issue24899] Add an os.path <=> pathlib equivalence table in
 pathlib docs
In-Reply-To: <1440050617.44.0.44226546659.issue24899@psf.upfronthosting.co.za>
Message-ID: <1442094219.17.0.304781285077.issue24899@psf.upfronthosting.co.za>


Nikita Klimov added the comment:

I make a correlation table, plan to finish by September 16 or earlier

----------

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

From report at bugs.python.org  Sat Sep 12 23:51:23 2015
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 12 Sep 2015 21:51:23 +0000
Subject: [docs] [issue25070] Python 2.6 - Python 3.4 allows unparenthesized
 generator with *args, **kw, forbidden in 3.5
In-Reply-To: <1441976624.09.0.810536371871.issue25070@psf.upfronthosting.co.za>
Message-ID: <20150912215120.114948.95940@psf.io>


Roundup Robot added the comment:

New changeset 10a9d4acd9cb by Yury Selivanov in branch '3.5':
whatsnew/3.5 More edits
https://hg.python.org/cpython/rev/10a9d4acd9cb

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

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

From report at bugs.python.org  Sat Sep 12 23:52:41 2015
From: report at bugs.python.org (Yury Selivanov)
Date: Sat, 12 Sep 2015 21:52:41 +0000
Subject: [docs] [issue25070] Python 2.6 - Python 3.4 allows unparenthesized
 generator with *args, **kw, forbidden in 3.5
In-Reply-To: <1441976624.09.0.810536371871.issue25070@psf.upfronthosting.co.za>
Message-ID: <1442094761.73.0.0734431626953.issue25070@psf.upfronthosting.co.za>


Yury Selivanov added the comment:

What's new is now updated with description of this issue.  Closing it now.

----------
resolution:  -> wont fix
stage:  -> resolved
status: open -> closed

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

From report at bugs.python.org  Sun Sep 13 02:22:09 2015
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 13 Sep 2015 00:22:09 +0000
Subject: [docs] [issue25076] Wrong parameter name in distutils documentation
In-Reply-To: <1442032866.5.0.225181106977.issue25076@psf.upfronthosting.co.za>
Message-ID: <20150913002153.11248.29096@psf.io>


Roundup Robot added the comment:

New changeset 1208c85af6d5 by Benjamin Peterson in branch '3.4':
fix name of argument in docstring and the docs (closes #25076)
https://hg.python.org/cpython/rev/1208c85af6d5

New changeset 63bbe9f80909 by Benjamin Peterson in branch '2.7':
fix name of argument in docstring and the docs (closes #25076)
https://hg.python.org/cpython/rev/63bbe9f80909

New changeset f4dc1b8bb4b6 by Benjamin Peterson in branch 'default':
merge 3.5 (#25076)
https://hg.python.org/cpython/rev/f4dc1b8bb4b6

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

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

From report at bugs.python.org  Sun Sep 13 23:42:11 2015
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 13 Sep 2015 21:42:11 +0000
Subject: [docs] [issue25078] Document InstallAllUsers installer parameter
	default 0
In-Reply-To: <1442051204.9.0.216289255081.issue25078@psf.upfronthosting.co.za>
Message-ID: <20150913214207.68857.7176@psf.io>


Roundup Robot added the comment:

New changeset 399b7d5616f1 by Steve Dower in branch '3.5':
Closes #25078: Document InstallAllUsers installer parameter default 0
https://hg.python.org/cpython/rev/399b7d5616f1

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

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

From report at bugs.python.org  Mon Sep 14 07:33:52 2015
From: report at bugs.python.org (m)
Date: Mon, 14 Sep 2015 05:33:52 +0000
Subject: [docs] [issue25104] Wrong documentation for "chr(i)" function.
Message-ID: <1442208832.43.0.566078957807.issue25104@psf.upfronthosting.co.za>


New submission from m:

The documentation of the "chr(i)" function is not correct, it states that The valid range for the argument is from 0 through 1,114,111 (0x10FFFF in base 16).

Correction: The valid range for the argument is from 0 through 255 (0xFF in base 16).

----------
assignee: docs at python
components: Documentation
messages: 250630
nosy: docs at python, m
priority: normal
severity: normal
status: open
title: Wrong documentation for "chr(i)" function.
type: compile error

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

From report at bugs.python.org  Mon Sep 14 07:41:05 2015
From: report at bugs.python.org (Zachary Ware)
Date: Mon, 14 Sep 2015 05:41:05 +0000
Subject: [docs] [issue25104] Wrong documentation for "chr(i)" function.
In-Reply-To: <1442208832.43.0.566078957807.issue25104@psf.upfronthosting.co.za>
Message-ID: <1442209265.45.0.345431576732.issue25104@psf.upfronthosting.co.za>


Zachary Ware added the comment:

You appear to be reading the Python 3 documentation and using Python 2:

$ python3
Python 3.4.3 (v3.4.3:9b73f1c3e601, Feb 23 2015, 02:52:03) 
[GCC 4.2.1 (Apple Inc. build 5666) (dot 3)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> chr(1234)
'?'
>>> ^D
$ python2
Python 2.7.10 (v2.7.10:15c95b7d81dc, May 23 2015, 09:33:12) 
[GCC 4.2.1 (Apple Inc. build 5666) (dot 3)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> chr(1234)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ValueError: chr() arg not in range(256)

----------
nosy: +zach.ware
resolution:  -> not a bug
stage:  -> resolved
status: open -> closed
type: compile error -> behavior

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

From report at bugs.python.org  Mon Sep 14 08:54:48 2015
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 14 Sep 2015 06:54:48 +0000
Subject: [docs] [issue25105] Docs 3.x buildbot:
Message-ID: <1442213688.52.0.64987156832.issue25105@psf.upfronthosting.co.za>


New submission from STINNER Victor:

It looks like the changeset 34f941df3476 introduced a bug:

http://buildbot.python.org/all/builders/Docs%203.x/builds/86/steps/suspicious/logs/stdio

writing output... [ 99%] whatsnew/3.5

WARNING: [whatsnew/3.5:924] ":root" found in "'WARNING:root:warning\n'"
WARNING: [whatsnew/3.5:924] ":warning" found in "'WARNING:root:warning\n'"
WARNING: [whatsnew/3.5:1244] "::" found in ">>> addr6 = ipaddress.IPv6Address('::1')"

----------
assignee: docs at python
components: Documentation
messages: 250637
nosy: docs at python, haypo, yselivanov
priority: normal
severity: normal
status: open
title: Docs 3.x buildbot:
versions: Python 3.5, Python 3.6

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

From report at bugs.python.org  Mon Sep 14 09:01:28 2015
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 14 Sep 2015 07:01:28 +0000
Subject: [docs] [issue25105] Docs 3.x buildbot: ":root" found in ...
In-Reply-To: <1442213688.52.0.64987156832.issue25105@psf.upfronthosting.co.za>
Message-ID: <1442214088.17.0.560266055444.issue25105@psf.upfronthosting.co.za>


Changes by STINNER Victor <victor.stinner at gmail.com>:


----------
title: Docs 3.x buildbot: -> Docs 3.x buildbot: ":root" found in ...

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

From report at bugs.python.org  Mon Sep 14 09:02:07 2015
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 14 Sep 2015 07:02:07 +0000
Subject: [docs] [issue25105] Docs 3.x buildbot: ":root" found in ...
In-Reply-To: <1442213688.52.0.64987156832.issue25105@psf.upfronthosting.co.za>
Message-ID: <1442214127.49.0.0330500431217.issue25105@psf.upfronthosting.co.za>


STINNER Victor added the comment:

It looks like a bug in the "suspicious" tool which should skip preformatted blocks (blocks starting with "::").


+don't provide any options to redirect it::

+

+    >>> import contextlib, io, logging

+    >>> f = io.StringIO()

+    >>> with contextlib.redirect_stderr(f):

+    ...     logging.warning('warning')

+    ...

+    >>> f.getvalue()

+    'WARNING:root:warning\n'

+

+(Contributed by Berker Peksag in :issue:`22389`.)

----------

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

From report at bugs.python.org  Mon Sep 14 16:12:56 2015
From: report at bugs.python.org (Florian Apolloner)
Date: Mon, 14 Sep 2015 14:12:56 +0000
Subject: [docs] [issue25110] Documentation sometimes still links to py3.4
In-Reply-To: <1442239967.4.0.711853703781.issue25110@psf.upfronthosting.co.za>
Message-ID: <1442239976.19.0.299716765224.issue25110@psf.upfronthosting.co.za>


Changes by Florian Apolloner <f.apolloner at gmail.com>:


----------
assignee:  -> docs at python
components: +Documentation
nosy: +docs at python
versions: +Python 3.5

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

From report at bugs.python.org  Mon Sep 14 16:20:25 2015
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 14 Sep 2015 14:20:25 +0000
Subject: [docs] [issue25110] Documentation sometimes still links to py3.4
In-Reply-To: <1442239967.4.0.711853703781.issue25110@psf.upfronthosting.co.za>
Message-ID: <1442240425.94.0.756111526479.issue25110@psf.upfronthosting.co.za>


Changes by STINNER Victor <victor.stinner at gmail.com>:


----------
nosy: +larry

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

From report at bugs.python.org  Mon Sep 14 17:02:15 2015
From: report at bugs.python.org (Larry Hastings)
Date: Mon, 14 Sep 2015 15:02:15 +0000
Subject: [docs] [issue25110] Documentation sometimes still links to py3.4
In-Reply-To: <1442239967.4.0.711853703781.issue25110@psf.upfronthosting.co.za>
Message-ID: <1442242935.4.0.53199930281.issue25110@psf.upfronthosting.co.za>


Larry Hastings added the comment:

Old version stuck in the CDN cache.  I cleared the cache, it's fine now.

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

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

From prat0088 at gmail.com  Mon Sep 14 17:17:39 2015
From: prat0088 at gmail.com (Tristan Pratt)
Date: Tue, 15 Sep 2015 00:17:39 +0900
Subject: [docs] Dead links on doc page
Message-ID: <CAMLuwQp3G7cSRaGEP7vjXk2MkjUUeo4-98iQRbY8Wt9+_xj66Q@mail.gmail.com>

https://docs.python.org/3/download.html

"HTML" link and some others return a 404.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20150915/54cd9ea2/attachment.html>

From berker.peksag at gmail.com  Mon Sep 14 18:56:11 2015
From: berker.peksag at gmail.com (=?UTF-8?Q?Berker_Peksa=C4=9F?=)
Date: Mon, 14 Sep 2015 19:56:11 +0300
Subject: [docs] Dead links on doc page
In-Reply-To: <CAMLuwQp3G7cSRaGEP7vjXk2MkjUUeo4-98iQRbY8Wt9+_xj66Q@mail.gmail.com>
References: <CAMLuwQp3G7cSRaGEP7vjXk2MkjUUeo4-98iQRbY8Wt9+_xj66Q@mail.gmail.com>
Message-ID: <CAF4280+2DTuXpV=72+aG28+V0EL7yi9FRhuW9vSE5U6YzJUHtw@mail.gmail.com>

On Mon, Sep 14, 2015 at 6:17 PM, Tristan Pratt <prat0088 at gmail.com> wrote:
> https://docs.python.org/3/download.html
>
> "HTML" link and some others return a 404.

Hi Tristan,

Thanks for the report. I'm now able to download them. Can you check again?

--Berker

From John.Jeffers at ge.com  Tue Sep 15 00:02:54 2015
From: John.Jeffers at ge.com (Jeffers, John (GE Oil & Gas))
Date: Mon, 14 Sep 2015 22:02:54 +0000
Subject: [docs] Python 3.5.0 Documentation
Message-ID: <A64A85CF2DC1DB4BB9D004B506CA2D0E0B3FFFC9@ALPURAPA12.e2k.ad.ge.com>

Dear Team

It appears that the 3.5.0 Documentation downloads have broken links since each one I tried had 404 error.

Best Regards

John

John Jeffers, P.Eng.
TRS Leader, Sr. Engineer
Lufkin Automation
A GE O&G WPS Company
811 Willow Oak Drive
Missouri City, TX 77489
Office (281) 495-1100
Cisco  (281) 410-6156
Cell:    (903) 445-5491

GE imagination at work!

"Any sufficiently advanced technology is indistinguishable from magic."-- Clarke's 3rd Law
CONFIDENTIALITY NOTICE: This email transmission, including any attachments, is intended only for the named recipient(s) and may contain information that is privileged, confidential and/or exempt from disclosure under applicable law. If you have received this transmission in error, or are not the named recipient(s), please notify sender immediately by return email and permanently delete this transmission, including any attachments.

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20150914/673db47d/attachment.html>

From mlisitza at gmail.com  Tue Sep 15 02:24:02 2015
From: mlisitza at gmail.com (Mateo Lisitza)
Date: Mon, 14 Sep 2015 17:24:02 -0700
Subject: [docs] 3.5.0 downloadable docs lead to HTTP 404. <EOM>
Message-ID: <CAFO-5YZvoEu=SPPY1wfEeqsKLx-ni0W7dgdps1+wrCicrOm5bQ@mail.gmail.com>


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

From report at bugs.python.org  Tue Sep 15 12:28:33 2015
From: report at bugs.python.org (Robin)
Date: Tue, 15 Sep 2015 10:28:33 +0000
Subject: [docs] [issue25123] Logging Documentation - dictConfig
 disable_existing_loggers
Message-ID: <1442312912.97.0.962237041326.issue25123@psf.upfronthosting.co.za>


New submission from Robin:

logging.config.dictConfig appears to share the same parameter as logging.config.fileConfig - disable_existing_loggers.

This parameter is documented for fileConfig but not dictConfig.

Suggest update to dictConfig documentation section.

----------
assignee: docs at python
components: Documentation
messages: 250755
nosy: coderobot, docs at python
priority: normal
severity: normal
status: open
title: Logging Documentation - dictConfig disable_existing_loggers
type: enhancement
versions: Python 2.7

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

From report at bugs.python.org  Tue Sep 15 15:30:32 2015
From: report at bugs.python.org (R. David Murray)
Date: Tue, 15 Sep 2015 13:30:32 +0000
Subject: [docs] [issue25123] Logging Documentation - dictConfig
 disable_existing_loggers
In-Reply-To: <1442312912.97.0.962237041326.issue25123@psf.upfronthosting.co.za>
Message-ID: <1442323832.11.0.275103101921.issue25123@psf.upfronthosting.co.za>


Changes by R. David Murray <rdmurray at bitdance.com>:


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

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

From report at bugs.python.org  Tue Sep 15 16:47:12 2015
From: report at bugs.python.org (Jakub Wilk)
Date: Tue, 15 Sep 2015 14:47:12 +0000
Subject: [docs] [issue25127] typo in concurrent.futures.Executor.shutdown()
	example
Message-ID: <1442328432.29.0.90090219234.issue25127@psf.upfronthosting.co.za>


New submission from Jakub Wilk:

Typo in the example code in <https://docs.python.org/3/library/concurrent.futures.html#concurrent.futures.Executor.shutdown>:
in the last line, it should be "src4.txt", not "src3.txt".

----------
assignee: docs at python
components: Documentation
messages: 250774
nosy: docs at python, jwilk
priority: normal
severity: normal
status: open
title: typo in concurrent.futures.Executor.shutdown() example

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

From report at bugs.python.org  Tue Sep 15 17:11:40 2015
From: report at bugs.python.org (yavvsy)
Date: Tue, 15 Sep 2015 15:11:40 +0000
Subject: [docs] [issue25128] https://docs.python.org/3/download.html
 incorrect links to files (cannot download)
Message-ID: <1442329900.03.0.985918373135.issue25128@psf.upfronthosting.co.za>


New submission from yavvsy:

When clicking on a download link in:
https://docs.python.org/3/download.html
The links point to files that don't exist (older document version)

For example:
https://docs.python.org/ftp/python/doc/3.5.0/python-3.5.0-docs-pdf-letter.zip
should be instead:
https://docs.python.org/ftp/python/doc/3.5.0/python-3.5.0a3-docs-pdf-letter.zip

----------
assignee: docs at python
components: Documentation
messages: 250777
nosy: docs at python, yavvsy
priority: normal
severity: normal
status: open
title: https://docs.python.org/3/download.html incorrect links to files (cannot download)
type: behavior
versions: Python 3.5

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

From report at bugs.python.org  Tue Sep 15 18:43:43 2015
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 15 Sep 2015 16:43:43 +0000
Subject: [docs] [issue25105] Docs 3.x buildbot: ":root" found in ...
In-Reply-To: <1442213688.52.0.64987156832.issue25105@psf.upfronthosting.co.za>
Message-ID: <20150915164338.11268.98057@psf.io>


Roundup Robot added the comment:

New changeset 953a14984aec by Berker Peksag in branch '3.5':
Issue #25105: Update susp-ignored.csv to avoid false positives
https://hg.python.org/cpython/rev/953a14984aec

New changeset efdbe17a9208 by Berker Peksag in branch 'default':
Issue #25105: Update susp-ignored.csv to avoid false positives
https://hg.python.org/cpython/rev/efdbe17a9208

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

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

From report at bugs.python.org  Tue Sep 15 18:56:41 2015
From: report at bugs.python.org (Berker Peksag)
Date: Tue, 15 Sep 2015 16:56:41 +0000
Subject: [docs] [issue25105] Docs 3.x buildbot: ":root" found in ...
In-Reply-To: <1442213688.52.0.64987156832.issue25105@psf.upfronthosting.co.za>
Message-ID: <1442336201.54.0.382154060051.issue25105@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Looks happy now: http://buildbot.python.org/all/builders/Docs%203.x/builds/104

Thanks for the report, Victor.

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

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

From report at bugs.python.org  Tue Sep 15 19:00:10 2015
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 15 Sep 2015 17:00:10 +0000
Subject: [docs] [issue25127] typo in concurrent.futures.Executor.shutdown()
	example
In-Reply-To: <1442328432.29.0.90090219234.issue25127@psf.upfronthosting.co.za>
Message-ID: <20150915170005.5937.45042@psf.io>


Roundup Robot added the comment:

New changeset 8f94e695f56b by Berker Peksag in branch '3.4':
Issue #25127: Fix typo in concurrent.futures.rst
https://hg.python.org/cpython/rev/8f94e695f56b

New changeset afe82e6f00df by Berker Peksag in branch '3.5':
Issue #25127: Fix typo in concurrent.futures.rst
https://hg.python.org/cpython/rev/afe82e6f00df

New changeset 23ad070a6a2d by Berker Peksag in branch 'default':
Issue #25127: Fix typo in concurrent.futures.rst
https://hg.python.org/cpython/rev/23ad070a6a2d

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

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

From report at bugs.python.org  Tue Sep 15 19:00:50 2015
From: report at bugs.python.org (Berker Peksag)
Date: Tue, 15 Sep 2015 17:00:50 +0000
Subject: [docs] [issue25127] typo in concurrent.futures.Executor.shutdown()
	example
In-Reply-To: <1442328432.29.0.90090219234.issue25127@psf.upfronthosting.co.za>
Message-ID: <1442336450.04.0.469345246493.issue25127@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Fixed. Thanks, Jakub.

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

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

From report at bugs.python.org  Tue Sep 15 19:42:42 2015
From: report at bugs.python.org (Berker Peksag)
Date: Tue, 15 Sep 2015 17:42:42 +0000
Subject: [docs] [issue25128] https://docs.python.org/3/download.html
 incorrect links to files (cannot download)
In-Reply-To: <1442329900.03.0.985918373135.issue25128@psf.upfronthosting.co.za>
Message-ID: <1442338962.93.0.919375715468.issue25128@psf.upfronthosting.co.za>


Berker Peksag added the comment:

The correct link for python-3.5.0-docs-pdf-letter.zip should be https://docs.python.org/3/archives/python-3.5.0-docs-pdf-letter.zip

It was a cache issue and should be resolved now. I can confirm that all links at https://docs.python.org/3/download.html are working for me. Can you please check again?

----------
nosy: +berker.peksag
resolution:  -> out of date
stage:  -> resolved
status: open -> closed

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

From report at bugs.python.org  Tue Sep 15 21:41:20 2015
From: report at bugs.python.org (Nikita Klimov)
Date: Tue, 15 Sep 2015 19:41:20 +0000
Subject: [docs] [issue24899] Add an os.path <=> pathlib equivalence table in
 pathlib docs
In-Reply-To: <1440050617.44.0.44226546659.issue24899@psf.upfronthosting.co.za>
Message-ID: <1442346080.33.0.719534229406.issue24899@psf.upfronthosting.co.za>


Nikita Klimov added the comment:

Patch in attach. Could anybody do review?

----------
keywords: +patch
Added file: http://bugs.python.org/file40476/pathlib-os-correlation-doc.patch

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

From report at bugs.python.org  Tue Sep 15 22:35:42 2015
From: report at bugs.python.org (Bar Harel)
Date: Tue, 15 Sep 2015 20:35:42 +0000
Subject: [docs] [issue25134] SSL asyncio
Message-ID: <1442349342.4.0.267068744355.issue25134@psf.upfronthosting.co.za>


New submission from Bar Harel:

Seems like at https://docs.python.org/3.5/library/asyncio-eventloop.html#creating-connections (Creating connections) in asyncio, it states that "On Windows with ProactorEventLoop, SSL/TLS is not supported."
But on the ProactorEventLoop it states that SSL support was added in 3.5
Please remove the "unsupported" statement in the docs of 3.5 and 3.6
p.s. Is there a way I can fix these errors myself instead of hassling other people?

----------
assignee: docs at python
components: Documentation
messages: 250803
nosy: Bar Harel, docs at python
priority: normal
severity: normal
status: open
title: SSL asyncio
versions: Python 3.5, Python 3.6

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

From report at bugs.python.org  Tue Sep 15 22:43:36 2015
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 15 Sep 2015 20:43:36 +0000
Subject: [docs] [issue25134] SSL asyncio
In-Reply-To: <1442349342.4.0.267068744355.issue25134@psf.upfronthosting.co.za>
Message-ID: <20150915204333.24035.15349@psf.io>


Roundup Robot added the comment:

New changeset d371ce905395 by Victor Stinner in branch '3.5':
Issue #25134: Update asyncio doc for SSL on Windows
https://hg.python.org/cpython/rev/d371ce905395

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

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

From report at bugs.python.org  Tue Sep 15 22:45:14 2015
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 15 Sep 2015 20:45:14 +0000
Subject: [docs] [issue25134] SSL asyncio
In-Reply-To: <1442349342.4.0.267068744355.issue25134@psf.upfronthosting.co.za>
Message-ID: <1442349914.23.0.446346466093.issue25134@psf.upfronthosting.co.za>


STINNER Victor added the comment:

> But on the ProactorEventLoop it states that SSL support was added in 3.5

Right, I forgot to update the doc. Thanks for the bug report.

> p.s. Is there a way I can fix these errors myself instead of hassling other people?

Sure, you can write patches and open an issue with your patch.

* Clone Python repository: hg clone http://hg.python.org/cpython/
* Edit the doc: Doc/library/asyncio*.rst
* Produce a patch: hg diff > patch

Don't hesitate to enhance asyncio doc! Patches are welcome!

----------
nosy: +haypo

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

From report at bugs.python.org  Tue Sep 15 22:45:25 2015
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 15 Sep 2015 20:45:25 +0000
Subject: [docs] [issue25134] SSL asyncio
In-Reply-To: <1442349342.4.0.267068744355.issue25134@psf.upfronthosting.co.za>
Message-ID: <1442349925.28.0.789645408619.issue25134@psf.upfronthosting.co.za>


Changes by STINNER Victor <victor.stinner at gmail.com>:


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

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

From report at bugs.python.org  Tue Sep 15 23:38:05 2015
From: report at bugs.python.org (Berker Peksag)
Date: Tue, 15 Sep 2015 21:38:05 +0000
Subject: [docs] [issue25080] The example-code for making XLM-RPC requests
 through proxy, fail!
In-Reply-To: <1442059715.67.0.31958758043.issue25080@psf.upfronthosting.co.za>
Message-ID: <1442353085.33.0.700814391732.issue25080@psf.upfronthosting.co.za>


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


----------
components:  -Demos and Tools
stage:  -> needs patch
type:  -> behavior
versions: +Python 3.5, Python 3.6

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

From report at bugs.python.org  Wed Sep 16 01:00:25 2015
From: report at bugs.python.org (Raymond Hettinger)
Date: Tue, 15 Sep 2015 23:00:25 +0000
Subject: [docs] [issue25080] The example-code for making XML-RPC requests
 through proxy, fail!
In-Reply-To: <1442059715.67.0.31958758043.issue25080@psf.upfronthosting.co.za>
Message-ID: <1442358025.74.0.940453351961.issue25080@psf.upfronthosting.co.za>


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


----------
title: The example-code for making XLM-RPC requests through proxy, fail! -> The example-code for making XML-RPC requests through proxy, fail!

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

From lac at openend.se  Wed Sep 16 09:35:55 2015
From: lac at openend.se (Laura Creighton)
Date: Wed, 16 Sep 2015 09:35:55 +0200
Subject: [docs] Troubleshooting Failed Python Installation on Windows
Message-ID: <201509160735.t8G7ZtLW029302@fido.openend.se>

webmaster gets a lot of mail from people who cannot install their
Pythons.  I can handle the obvious problems -- 'that download is for a
Mac -- your download is fine, your PATH is not -- Try looking for
Python3, because you are finding your old Python 2 install, not this
new one??' but most of the time, I have no clue.  I send the people to
python-list or the bug tracker, but mostly they never show up there.

How hard would it be for windows-using developers to write such a
thing?  It would make a lot of people's life a lot easier.

Laura


From j0hnwh1t3 at outlook.com  Wed Sep 16 12:16:37 2015
From: j0hnwh1t3 at outlook.com (John White)
Date: Wed, 16 Sep 2015 13:16:37 +0300
Subject: [docs] sorted() documentation possible improvement,
	un-'stable' cases
Message-ID: <BLU170-W8201FE83B58A63C5C068B7E95B0@phx.gbl>







sorted() documentation states: 

"The built-in sorted() function is guaranteed to be stable. A sort is
stable if it guarantees not to change the relative order of elements that
compare equal ? this is helpful for sorting in multiple passes (for
example, sort by department, then by salary grade). "

Some people might get the misconception that order will be stable even on different runs of the exact same code. 

e.g.  the code below: 

d = {'a': 0, 'b': 0, 'c': 0, 'd': 1}
print(sorted(d, key=lambda x: d[x]))

# It would print a different order on different runs (assuming PYTHONHASHSEED=random).

For more details see this StackOverflow question. 

Perhaps adding the following in the documentation might help: 

"It is not guaranteed to be stable on different runs  or when the order of the given iterable has changed (even if the iterable is a dict)."




 		 	   		  
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20150916/1986d24d/attachment.html>

From report at bugs.python.org  Wed Sep 16 23:32:38 2015
From: report at bugs.python.org (Robert Xiao)
Date: Wed, 16 Sep 2015 21:32:38 +0000
Subject: [docs] [issue25145] urllib how-to should be updated to remove
	PyGoogle
Message-ID: <1442439158.29.0.495500663722.issue25145@psf.upfronthosting.co.za>


New submission from Robert Xiao:

PyGoogle has been dead for 6-7 years at this point (probably longer), yet the newest urllib documentation (https://docs.python.org/3/howto/urllib2.html#id1) still refers to it in a footnote:

    [1] Like Google for example. The proper way to use google from a program is to use PyGoogle of course.

This should probably be amended to remove the outdated reference altogether (the footnote itself can probably just go).

While we're at it: the user agent version strings are _really_ old - MSIE 5.5 and MSIE 6.0. I know they are just illustrative, but couldn't we at least update them to something from the last decade? :P

----------
assignee: docs at python
components: Documentation
messages: 250863
nosy: docs at python, nneonneo
priority: normal
severity: normal
status: open
title: urllib how-to should be updated to remove PyGoogle
versions: Python 3.2, Python 3.3, Python 3.4, Python 3.5, Python 3.6

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

From report at bugs.python.org  Thu Sep 17 00:01:35 2015
From: report at bugs.python.org (Zachary Ware)
Date: Wed, 16 Sep 2015 22:01:35 +0000
Subject: [docs] [issue25145] urllib how-to should be updated to remove
	PyGoogle
In-Reply-To: <1442439158.29.0.495500663722.issue25145@psf.upfronthosting.co.za>
Message-ID: <1442440895.98.0.248951505161.issue25145@psf.upfronthosting.co.za>


Changes by Zachary Ware <zachary.ware at gmail.com>:


----------
stage:  -> needs patch
versions: +Python 2.7 -Python 3.2, Python 3.3

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

From report at bugs.python.org  Thu Sep 17 16:13:32 2015
From: report at bugs.python.org (Laura Creighton)
Date: Thu, 17 Sep 2015 14:13:32 +0000
Subject: [docs] [issue25152] venv documentation doesn't tell you how to
 specify a particular version of python
Message-ID: <1442499212.73.0.745656543772.issue25152@psf.upfronthosting.co.za>


New submission from Laura Creighton:

https://docs.python.org/3/library/venv.html nowhere explicitly states
how you are supposed to get a venv with a particular python version.
Users of virtualenv will be looking for a -p option.

The doc says:

"Creation of virtual environments is done by executing the pyvenv script:"

which undoubtably works if you _have_ a pyenv script, but I don't have
one.  It is nowhere stated where I should find one.

Fortunately, I can also run things as

some_python_version -m venv myvenv 

This, everybody is able to do.  (However, it may not work, see
issue 25151 --  but forget that for now.)

This is something that everybody ought to be able to do.
Thus I propose either deleting the mention of pyenv, (if it is exactly
equivalent to running python -m venv)  or expanding
the section, indicating where the script lives, and why you might
want to run it instead of python -m venv.

Then, before the line:
The command, if run with -h, will show the available options:

add the line:

The version of python used in the venv is determined at this time.
If the default version of python is not the one desired, use:

/path/to/the/python/I/want -m venv  myenv instead.

(Plus, if there is a way to do this with pyenv, then list that
part here).

----------
assignee: docs at python
components: Distutils, Documentation
messages: 250891
nosy: docs at python, dstufft, eric.araujo, lac
priority: normal
severity: normal
status: open
title: venv documentation doesn't tell you how to specify a particular version of python
versions: Python 3.3, Python 3.4, Python 3.5, Python 3.6

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

From report at bugs.python.org  Thu Sep 17 16:24:38 2015
From: report at bugs.python.org (R. David Murray)
Date: Thu, 17 Sep 2015 14:24:38 +0000
Subject: [docs] [issue25152] venv documentation doesn't tell you how to
 specify a particular version of python
In-Reply-To: <1442499212.73.0.745656543772.issue25152@psf.upfronthosting.co.za>
Message-ID: <1442499878.48.0.972935881132.issue25152@psf.upfronthosting.co.za>


R. David Murray added the comment:

Our documentation describes what you get if you install Python using our distribution of python.  If you do that, you (by default) get a pyvenv script, and it points to the version of python that you just (last) installed.

Distributions change this.  We can't document what every distribution does.

That said, I think it would be a good idea to move the description of calling it via 'python -m venv' to be the *first* mention, and *then* describing pyvenv (and noting that it is installed by our installers but a vendor install may do something different, including omit it).

----------
nosy: +r.david.murray
versions:  -Python 3.3

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

From report at bugs.python.org  Thu Sep 17 18:36:15 2015
From: report at bugs.python.org (Laura Creighton)
Date: Thu, 17 Sep 2015 16:36:15 +0000
Subject: [docs] [issue25152] venv documentation doesn't tell you how to
 specify a particular version of python
In-Reply-To: <1442499212.73.0.745656543772.issue25152@psf.upfronthosting.co.za>
Message-ID: <1442507775.5.0.681488817067.issue25152@psf.upfronthosting.co.za>


Laura Creighton added the comment:

On thinking things over, I think that venv is, as it stands now,
only able to work with python3.3 and greater.

If you want to build a virtualenv for python 2.7, then I think
venv is not for you.

I think this needs to be mentioned.

----------

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

From report at bugs.python.org  Thu Sep 17 18:40:02 2015
From: report at bugs.python.org (R. David Murray)
Date: Thu, 17 Sep 2015 16:40:02 +0000
Subject: [docs] [issue25152] venv documentation doesn't tell you how to
 specify a particular version of python
In-Reply-To: <1442499212.73.0.745656543772.issue25152@psf.upfronthosting.co.za>
Message-ID: <1442508002.3.0.0355401117993.issue25152@psf.upfronthosting.co.za>


R. David Murray added the comment:

Not in the python3 docs, it doesn't.  The python3 docs are documenting python3.  But, this is another reason the -m venv description should be first, to make it clear it is *part* of the python version, not a standalone package that might work with multiple python versions.

----------

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

From report at bugs.python.org  Thu Sep 17 18:51:34 2015
From: report at bugs.python.org (Laura Creighton)
Date: Thu, 17 Sep 2015 16:51:34 +0000
Subject: [docs] [issue25152] venv documentation doesn't tell you how to
 specify a particular version of python
In-Reply-To: <1442499212.73.0.745656543772.issue25152@psf.upfronthosting.co.za>
Message-ID: <1442508694.55.0.710819078935.issue25152@psf.upfronthosting.co.za>


Laura Creighton added the comment:

The problem is that people who run into venv will think that it is
virtualenv made into part of the standard library.  Thus they
will have a great expectation that there will be a -p option to
specify the python version that they want and that they can get 2.7.

As Josh Billings (American humourist) wrote:
"It ain't ignorance causes so much trouble; it's folks knowing so much that ain't so."

A 'this is not virtualenv' message would be useful.

----------

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

From report at bugs.python.org  Thu Sep 17 19:28:07 2015
From: report at bugs.python.org (Brett Cannon)
Date: Thu, 17 Sep 2015 17:28:07 +0000
Subject: [docs] [issue25152] venv documentation doesn't tell you how to
 specify a particular version of python
In-Reply-To: <1442499212.73.0.745656543772.issue25152@psf.upfronthosting.co.za>
Message-ID: <1442510887.29.0.483094099093.issue25152@psf.upfronthosting.co.za>


Brett Cannon added the comment:

Maybe we should consider dropping the generic pyvenv script or at least only install it with a full version suffix like pyvenv3.6 to prevent this kind of confusion (I have this issue all the time with pip and it drives me nuts).

At the very minimum we should do as David suggests and bump up the `python -m` suggestion up as the first one.

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

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

From report at bugs.python.org  Thu Sep 17 19:55:57 2015
From: report at bugs.python.org (R. David Murray)
Date: Thu, 17 Sep 2015 17:55:57 +0000
Subject: [docs] [issue25152] venv documentation doesn't tell you how to
 specify a particular version of python
In-Reply-To: <1442499212.73.0.745656543772.issue25152@psf.upfronthosting.co.za>
Message-ID: <1442512557.01.0.661079494906.issue25152@psf.upfronthosting.co.za>


R. David Murray added the comment:

I was surprised myself that pyvenv wasn't at least named pyvenv3.  I think I've only ever used it once, mostly I use the -m because then I *know* what version of python I'm getting.  I'd be in favor of dropping the script except that that would be a backward compatibility break.  (Gentoo at least would probably recreate it so that 'pyvenv' continued to work no matter which version of python you had selected as your system default).

----------

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

From report at bugs.python.org  Thu Sep 17 20:14:12 2015
From: report at bugs.python.org (Brett Cannon)
Date: Thu, 17 Sep 2015 18:14:12 +0000
Subject: [docs] [issue25152] venv documentation doesn't tell you how to
 specify a particular version of python
In-Reply-To: <1442499212.73.0.745656543772.issue25152@psf.upfronthosting.co.za>
Message-ID: <1442513652.91.0.569456143513.issue25152@psf.upfronthosting.co.za>


Brett Cannon added the comment:

It would break backwards-compatibility, but the fix is to simply switch to `python3 -m venv` which still gives you the same semantics of using the newest Python 3 installation you have so the work to change is minimal.

----------

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

From report at bugs.python.org  Thu Sep 17 20:16:04 2015
From: report at bugs.python.org (Brett Cannon)
Date: Thu, 17 Sep 2015 18:16:04 +0000
Subject: [docs] [issue25152] venv documentation doesn't tell you how to
 specify a particular version of python
In-Reply-To: <1442499212.73.0.745656543772.issue25152@psf.upfronthosting.co.za>
Message-ID: <1442513764.89.0.161102402922.issue25152@psf.upfronthosting.co.za>


Brett Cannon added the comment:

Actually, I like the idea of dropping pyvenv enough that I'm going to create an issue for it and bring it up on python-dev.

----------

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

From report at bugs.python.org  Fri Sep 18 09:21:31 2015
From: report at bugs.python.org (TAKASE Arihiro)
Date: Fri, 18 Sep 2015 07:21:31 +0000
Subject: [docs] [issue25161] Missing periods at the end of sentences
Message-ID: <1442560890.27.0.253223646248.issue25161@psf.upfronthosting.co.za>


New submission from TAKASE Arihiro:

The attached patch adds some periods in docs.
This applies to 3.x.

----------
assignee: docs at python
components: Documentation
files: periods.patch
keywords: patch
messages: 250951
nosy: artakase, docs at python
priority: normal
severity: normal
status: open
title: Missing periods at the end of sentences
type: behavior
versions: Python 2.7, Python 3.4, Python 3.5, Python 3.6
Added file: http://bugs.python.org/file40498/periods.patch

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

From report at bugs.python.org  Fri Sep 18 09:22:54 2015
From: report at bugs.python.org (TAKASE Arihiro)
Date: Fri, 18 Sep 2015 07:22:54 +0000
Subject: [docs] [issue25161] Missing periods at the end of sentences
In-Reply-To: <1442560890.27.0.253223646248.issue25161@psf.upfronthosting.co.za>
Message-ID: <1442560974.2.0.695927997477.issue25161@psf.upfronthosting.co.za>


TAKASE Arihiro added the comment:

Added patch for 2.7.

----------
Added file: http://bugs.python.org/file40499/periods-2.7.patch

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

From report at bugs.python.org  Fri Sep 18 16:54:36 2015
From: report at bugs.python.org (John Taylor)
Date: Fri, 18 Sep 2015 14:54:36 +0000
Subject: [docs] [issue25169] multiprocess documentation
Message-ID: <1442588076.4.0.907099744388.issue25169@psf.upfronthosting.co.za>


New submission from John Taylor:

In the Windows Help File for Python 3.5:

17.2 multiprocessing
17.2.1.1 The Process class
2nd code example: "To show the individual process IDs involved, here is an expanded example"

def info(title):
    print(title)
    print('module name:', __name__)
    if hasattr(os, 'getppid'):  # only available on Unix
        print('parent process:', os.getppid())
    print('process id:', os.getpid())

os.getppid() is now available on Windows, so you can remove the if statement.

----------
assignee: docs at python
components: Documentation
messages: 251002
nosy: docs at python, jftuga
priority: normal
severity: normal
status: open
title: multiprocess documentation
versions: Python 3.5

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

From report at bugs.python.org  Fri Sep 18 17:06:30 2015
From: report at bugs.python.org (John Taylor)
Date: Fri, 18 Sep 2015 15:06:30 +0000
Subject: [docs] [issue25169] multiprocess documentation
In-Reply-To: <1442588076.4.0.907099744388.issue25169@psf.upfronthosting.co.za>
Message-ID: <1442588790.01.0.818600131808.issue25169@psf.upfronthosting.co.za>


John Taylor added the comment:

To follow up on my previous message, I looked at the documentation for os.getppid().

It states:

Changed in version 3.2: Added support for Windows.

----------

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

From report at bugs.python.org  Fri Sep 18 18:59:24 2015
From: report at bugs.python.org (Bar Harel)
Date: Fri, 18 Sep 2015 16:59:24 +0000
Subject: [docs] [issue25169] multiprocess documentation
In-Reply-To: <1442588076.4.0.907099744388.issue25169@psf.upfronthosting.co.za>
Message-ID: <1442595564.05.0.88347494919.issue25169@psf.upfronthosting.co.za>


Bar Harel added the comment:

Here's a quick minor patch to fix, works on a re-compiled doc.

----------
keywords: +patch
nosy: +bar.harel
Added file: http://bugs.python.org/file40506/multiprocessing_patch.patch

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

From report at bugs.python.org  Fri Sep 18 19:26:32 2015
From: report at bugs.python.org (Bar Harel)
Date: Fri, 18 Sep 2015 17:26:32 +0000
Subject: [docs] [issue25145] urllib how-to should be updated to remove
	PyGoogle
In-Reply-To: <1442439158.29.0.495500663722.issue25145@psf.upfronthosting.co.za>
Message-ID: <1442597192.51.0.0125720273564.issue25145@psf.upfronthosting.co.za>


Bar Harel added the comment:

A quick patch updating the mime and removing the mentioning of PyGoogle. We can add a different example in the future if we wish.

----------
keywords: +patch
nosy: +bar.harel
Added file: http://bugs.python.org/file40508/urllib_howto.patch

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

From report at bugs.python.org  Fri Sep 18 19:32:16 2015
From: report at bugs.python.org (Bar Harel)
Date: Fri, 18 Sep 2015 17:32:16 +0000
Subject: [docs] [issue25145] urllib how-to should be updated to remove
	PyGoogle
In-Reply-To: <1442439158.29.0.495500663722.issue25145@psf.upfronthosting.co.za>
Message-ID: <1442597536.74.0.888252502155.issue25145@psf.upfronthosting.co.za>


Bar Harel added the comment:

Added a similar patch to 2.7

----------
Added file: http://bugs.python.org/file40509/urllib_howto27.patch

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

From report at bugs.python.org  Fri Sep 18 19:32:39 2015
From: report at bugs.python.org (Brendan Barnwell)
Date: Fri, 18 Sep 2015 17:32:39 +0000
Subject: [docs] [issue16701] Docs missing the behavior of += (in-place add)
	for lists.
In-Reply-To: <1355690474.0.0.76209480062.issue16701@psf.upfronthosting.co.za>
Message-ID: <1442597559.55.0.0510389405166.issue16701@psf.upfronthosting.co.za>


Brendan Barnwell added the comment:

This needs to be fixed.  The documentation for the behavior of +=  on lists needs to be with the documentation on lists.  The existing, vague documentation that += works in-place "when possible" is insufficient.

A central feature of Python is that the behavior of operators like + and += is overridable on a per-type basis.  Hence, the Language Reference is not the appropriate place for describing the behavior of += on a particular type.  The behavior of += on lists should be documented where the behavior of lists is documented (as, for instance, the behavior of + on lists already is), not where the syntax of += is documented.

Someone just asked a question on StackOverflow about this (http://stackoverflow.com/questions/32657637/python-changing-variables-vs-arrays-in-functions/32657770#32657770).  It is embarrassing to have to tell people, "To know what += does on a type, you need to look at the documentation for that type. . . except that the documentation for the builtin types doesn't document what some operators do."

----------
nosy: +BrenBarn

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

From report at bugs.python.org  Sat Sep 19 04:09:11 2015
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 19 Sep 2015 02:09:11 +0000
Subject: [docs] [issue25161] Missing periods at the end of sentences
In-Reply-To: <1442560890.27.0.253223646248.issue25161@psf.upfronthosting.co.za>
Message-ID: <1442628551.04.0.19207454333.issue25161@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Sep 19 04:10:03 2015
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 19 Sep 2015 02:10:03 +0000
Subject: [docs] [issue25169] multiprocess documentation
In-Reply-To: <1442588076.4.0.907099744388.issue25169@psf.upfronthosting.co.za>
Message-ID: <1442628603.45.0.499017419892.issue25169@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Sep 19 08:44:26 2015
From: report at bugs.python.org (Martin Panter)
Date: Sat, 19 Sep 2015 06:44:26 +0000
Subject: [docs] [issue25161] Missing periods at the end of sentences
In-Reply-To: <1442560890.27.0.253223646248.issue25161@psf.upfronthosting.co.za>
Message-ID: <1442645065.97.0.901573860566.issue25161@psf.upfronthosting.co.za>


Martin Panter added the comment:

All the changes in the non-2.7 patch look reasonable to me. I left two review comments suggesting a few extra minor edits.

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

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

From report at bugs.python.org  Sat Sep 19 08:44:47 2015
From: report at bugs.python.org (Martin Panter)
Date: Sat, 19 Sep 2015 06:44:47 +0000
Subject: [docs] [issue25161] Missing periods at the end of sentences
In-Reply-To: <1442560890.27.0.253223646248.issue25161@psf.upfronthosting.co.za>
Message-ID: <1442645087.42.0.0679828583068.issue25161@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Sep 19 12:01:04 2015
From: report at bugs.python.org (Rishit Bansal)
Date: Sat, 19 Sep 2015 10:01:04 +0000
Subject: [docs] [issue25175] Documentation-Tkinter wrong statement
Message-ID: <1442656864.32.0.801468754438.issue25175@psf.upfronthosting.co.za>


New submission from Rishit Bansal:

The statement required to check whether Tkinter is installed on a system is mentioned in the documentation as python -m tkinter , whereas it is supposed to be python -m Tkinter (with a big 't'). Please correct this error on the documentation here:https://docs.python.org/3/library/tkinter.html as it is very misleading to beginners.

----------
assignee: docs at python
components: Documentation
messages: 251070
nosy: Rishit Bansal, docs at python
priority: normal
severity: normal
status: open
title: Documentation-Tkinter wrong statement
type: compile error
versions: Python 2.7

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

From report at bugs.python.org  Sat Sep 19 12:14:47 2015
From: report at bugs.python.org (Martin Panter)
Date: Sat, 19 Sep 2015 10:14:47 +0000
Subject: [docs] [issue25175] Documentation-Tkinter wrong statement
In-Reply-To: <1442656864.32.0.801468754438.issue25175@psf.upfronthosting.co.za>
Message-ID: <1442657687.69.0.338426357275.issue25175@psf.upfronthosting.co.za>


Martin Panter added the comment:

The problem here is you have quoted the Python 3 documentation (see in the title, or the version switcher at the top), when you are presumably using Python 2. The module changed name to lowercase in Python 3.

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

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

From report at bugs.python.org  Sat Sep 19 12:17:02 2015
From: report at bugs.python.org (=?utf-8?q?Ville_Skytt=C3=A4?=)
Date: Sat, 19 Sep 2015 10:17:02 +0000
Subject: [docs] [issue25176] Link to urllib.parse.parse_qsl, not parse_qs,
 from cgi.parse_qsl doc
Message-ID: <1442657822.78.0.00192788068763.issue25176@psf.upfronthosting.co.za>


New submission from Ville Skytt?:

The docs for cgi.parse_qsl should link to urllib.parse.parse_qsl instead of urllib.parse.parse_qs, patch attached.

----------
assignee: docs at python
components: Documentation
files: cgi.parse_qsl.doc.patch
keywords: patch
messages: 251072
nosy: docs at python, scop
priority: normal
severity: normal
status: open
title: Link to urllib.parse.parse_qsl, not parse_qs, from cgi.parse_qsl doc
type: enhancement
versions: Python 3.6
Added file: http://bugs.python.org/file40514/cgi.parse_qsl.doc.patch

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

From report at bugs.python.org  Sat Sep 19 15:08:41 2015
From: report at bugs.python.org (Carol Willing)
Date: Sat, 19 Sep 2015 13:08:41 +0000
Subject: [docs] [issue25175] Documentation-Tkinter Clarify module spelling
 change in Python 3 docs
In-Reply-To: <1442656864.32.0.801468754438.issue25175@psf.upfronthosting.co.za>
Message-ID: <1442668120.97.0.769525267797.issue25175@psf.upfronthosting.co.za>


Carol Willing added the comment:

Although the documentation for Python 3 and Python 2 is correct as Martin shared, adding a note about capitalization in the Python 3 docs would be helpful for beginners for two reasons: 1) the name of the Tkinter project does start with a capital 'T' and 2) the python module name changed from Python 2 to 3.

Adding a note that the spelling of the module changed in version 3 to 'tkinter' from version 2's 'Tkinter' would be helpful for new users (especially since Tkinter is often used in educational applications).

I have updated the issue title, issue type, stage, and keywords to reflect that this issue is not a documentation error but a helpful, user friendly documentation enhancement.

----------
keywords: +easy
nosy: +willingc
stage:  -> needs patch
title: Documentation-Tkinter wrong statement -> Documentation-Tkinter Clarify module spelling change in Python 3 docs
type: compile error -> enhancement
versions: +Python 3.5, Python 3.6

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

From report at bugs.python.org  Sat Sep 19 20:23:30 2015
From: report at bugs.python.org (R. David Murray)
Date: Sat, 19 Sep 2015 18:23:30 +0000
Subject: [docs] [issue16701] Docs missing the behavior of += (in-place add)
	for lists.
In-Reply-To: <1355690474.0.0.76209480062.issue16701@psf.upfronthosting.co.za>
Message-ID: <1442687010.78.0.843993810305.issue16701@psf.upfronthosting.co.za>


R. David Murray added the comment:

I suggested updating the library reference in my first reply on this issue.  No one has proposed a patch yet, though.

----------

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

From report at bugs.python.org  Sat Sep 19 20:55:18 2015
From: report at bugs.python.org (Eric V. Smith)
Date: Sat, 19 Sep 2015 18:55:18 +0000
Subject: [docs] [issue25179] PEP 498 f-strings need to be documented
Message-ID: <1442688918.61.0.173837832796.issue25179@psf.upfronthosting.co.za>


New submission from Eric V. Smith:

Issue 24965 add f-strings (see PEP 498). They need to be documented.

----------
assignee: docs at python
components: Documentation
messages: 251101
nosy: docs at python, eric.smith
priority: normal
severity: normal
stage: needs patch
status: open
title: PEP 498 f-strings need to be documented
versions: Python 3.6

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

From report at bugs.python.org  Sat Sep 19 21:34:47 2015
From: report at bugs.python.org (Bar Harel)
Date: Sat, 19 Sep 2015 19:34:47 +0000
Subject: [docs] [issue25175] Documentation-Tkinter Clarify module spelling
 change in Python 3 docs
In-Reply-To: <1442656864.32.0.801468754438.issue25175@psf.upfronthosting.co.za>
Message-ID: <1442691287.91.0.372452639656.issue25175@psf.upfronthosting.co.za>


Bar Harel added the comment:

Is this good? :-)

----------
keywords: +patch
nosy: +bar.harel
Added file: http://bugs.python.org/file40520/Issue25175.patch

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

From report at bugs.python.org  Sat Sep 19 22:37:10 2015
From: report at bugs.python.org (Optimal BPM)
Date: Sat, 19 Sep 2015 20:37:10 +0000
Subject: [docs] [issue25079] Tokenize generates NL instead of NEWLINE for
	comments
In-Reply-To: <1442051359.49.0.451935650182.issue25079@psf.upfronthosting.co.za>
Message-ID: <1442695030.59.0.419698792893.issue25079@psf.upfronthosting.co.za>


Optimal BPM added the comment:

OK.
But just to make me understand, would that explain why an else statement gets its DEDENT before the else, instead of before an dedented comment just before it? 
Even if the comment is visually dedented as the else?

Example where tokenize returns the DEDENT in a separate place than where it is visually:

if a=b:
  statement
# Comment
else:
  other statement

In the above case, the DEDENT is reportet before the else, instead of before the comment.

----------

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

From report at bugs.python.org  Sun Sep 20 00:06:24 2015
From: report at bugs.python.org (Martin Panter)
Date: Sat, 19 Sep 2015 22:06:24 +0000
Subject: [docs] [issue25175] Documentation-Tkinter Clarify module spelling
 change in Python 3 docs
In-Reply-To: <1442656864.32.0.801468754438.issue25175@psf.upfronthosting.co.za>
Message-ID: <1442700384.52.0.389435217004.issue25175@psf.upfronthosting.co.za>


Martin Panter added the comment:

Normally the documentation doesn?t mention changes from Python 2. But in this case one often has to rely on other sources of documentation, which are often about Python 2, so I think the notice might be reasonable.

----------
components: +Tkinter
stage: needs patch -> patch review
versions: +Python 3.4 -Python 2.7

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

From report at bugs.python.org  Sun Sep 20 02:30:40 2015
From: report at bugs.python.org (Martin Panter)
Date: Sun, 20 Sep 2015 00:30:40 +0000
Subject: [docs] [issue25176] Link to urllib.parse.parse_qsl, not parse_qs,
 from cgi.parse_qsl doc
In-Reply-To: <1442657822.78.0.00192788068763.issue25176@psf.upfronthosting.co.za>
Message-ID: <1442709040.33.0.296382667365.issue25176@psf.upfronthosting.co.za>


Martin Panter added the comment:

Thanks for the patch. This only applies to the Python 3 doc; Python 2 does not have the error.

----------
assignee: docs at python -> martin.panter
nosy: +berker.peksag, martin.panter
stage:  -> commit review
versions: +Python 3.4, Python 3.5

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

From report at bugs.python.org  Sun Sep 20 02:37:37 2015
From: report at bugs.python.org (Mark Lawrence)
Date: Sun, 20 Sep 2015 00:37:37 +0000
Subject: [docs] [issue25175] Documentation-Tkinter Clarify module spelling
 change in Python 3 docs
In-Reply-To: <1442656864.32.0.801468754438.issue25175@psf.upfronthosting.co.za>
Message-ID: <1442709457.24.0.187159624436.issue25175@psf.upfronthosting.co.za>


Mark Lawrence added the comment:

Does this open a can of worms?  "You did it for Tkinter, why not do it for everything that was changed by PEP3108"?

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

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

From report at bugs.python.org  Sun Sep 20 03:19:34 2015
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 20 Sep 2015 01:19:34 +0000
Subject: [docs] [issue25176] Link to urllib.parse.parse_qsl, not parse_qs,
 from cgi.parse_qsl doc
In-Reply-To: <1442657822.78.0.00192788068763.issue25176@psf.upfronthosting.co.za>
Message-ID: <20150920011931.31205.48967@psf.io>


Roundup Robot added the comment:

New changeset 3ed2427758cf by Martin Panter <vadmium> in branch '3.4':
Issue #25176: Correct link for cgi.parse_qsl; patch from Ville Skytt?
https://hg.python.org/cpython/rev/3ed2427758cf

New changeset 138bbb7cf612 by Martin Panter <vadmium> in branch '3.5':
Issue #25176: Merge cgi.parse_qsl link from 3.4 into 3.5
https://hg.python.org/cpython/rev/138bbb7cf612

New changeset f08d56387982 by Martin Panter <vadmium> in branch 'default':
Issue #25176: Merge cgi.parse_qsl link from 3.5
https://hg.python.org/cpython/rev/f08d56387982

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

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

From report at bugs.python.org  Sun Sep 20 03:23:43 2015
From: report at bugs.python.org (Martin Panter)
Date: Sun, 20 Sep 2015 01:23:43 +0000
Subject: [docs] [issue25175] Documentation-Tkinter Clarify module spelling
 change in Python 3 docs
In-Reply-To: <1442656864.32.0.801468754438.issue25175@psf.upfronthosting.co.za>
Message-ID: <1442712223.33.0.305271000011.issue25175@psf.upfronthosting.co.za>


Martin Panter added the comment:

Perhaps it would be better to add the notice inside the big ?See also? box at the top. In particular I occasionally find myself looking at the NMT ?Tkinter reference: a GUI for Python? and Effbot sites as a substitute for the missing built-in documentation, and both these are written for Python 2. On the other hand, the TkDocs site is also useful, and seem to use Python 3.

----------

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

From report at bugs.python.org  Sun Sep 20 03:47:28 2015
From: report at bugs.python.org (Carol Willing)
Date: Sun, 20 Sep 2015 01:47:28 +0000
Subject: [docs] [issue25175] Documentation-Tkinter Clarify module spelling
 change in Python 3 docs
In-Reply-To: <1442656864.32.0.801468754438.issue25175@psf.upfronthosting.co.za>
Message-ID: <1442713648.52.0.233766420299.issue25175@psf.upfronthosting.co.za>


Carol Willing added the comment:

Thank you Bar Harel for submitting a patch.

Ultimately, I believe that the wording should be what is most helpful for the end users.

If you wish to avoid mentioning Python 2, then a simple note cautioning the user to take care that the case of the module should match the user's Python version. 

"Note: Python 3 uses all lowercase for the 'tkinter' module. Earlier versions of Python used 'Tkinter'. Please take care to use the correct module name that corresponds to the Python version being used."

----------

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

From report at bugs.python.org  Sun Sep 20 03:55:52 2015
From: report at bugs.python.org (Martin Panter)
Date: Sun, 20 Sep 2015 01:55:52 +0000
Subject: [docs] [issue25176] Link to urllib.parse.parse_qsl, not parse_qs,
 from cgi.parse_qsl doc
In-Reply-To: <1442657822.78.0.00192788068763.issue25176@psf.upfronthosting.co.za>
Message-ID: <1442714152.38.0.0776588568591.issue25176@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sun Sep 20 07:13:28 2015
From: report at bugs.python.org (Martin Panter)
Date: Sun, 20 Sep 2015 05:13:28 +0000
Subject: [docs] [issue23738] Clarify documentation of positional-only
	default values
In-Reply-To: <1427020261.31.0.215855760889.issue23738@psf.upfronthosting.co.za>
Message-ID: <1442726008.28.0.74910286679.issue23738@psf.upfronthosting.co.za>


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


----------
dependencies: +TypeError: truncate() takes no keyword arguments

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

From report at bugs.python.org  Sun Sep 20 07:24:31 2015
From: report at bugs.python.org (Martin Panter)
Date: Sun, 20 Sep 2015 05:24:31 +0000
Subject: [docs] [issue14586] TypeError: truncate() takes no keyword arguments
In-Reply-To: <1334455473.06.0.710562653974.issue14586@psf.upfronthosting.co.za>
Message-ID: <1442726671.09.0.508142098577.issue14586@psf.upfronthosting.co.za>


Martin Panter added the comment:

I agree with Guy?s earlier comments and would prefer this be fixed in the documentation. Otherwise, we would end up with third party IOBase implementations that use the wrong keyword name, or that don?t accept keywords at all. These would no longer be compatible with the new API.

Also the new patch competes with Issue 25057, also proposing keyword arguments for seek().

----------

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

From report at bugs.python.org  Sun Sep 20 08:17:30 2015
From: report at bugs.python.org (Martin Panter)
Date: Sun, 20 Sep 2015 06:17:30 +0000
Subject: [docs] [issue12922] StringIO and seek()
In-Reply-To: <1315342130.67.0.227650351498.issue12922@psf.upfronthosting.co.za>
Message-ID: <1442729850.03.0.556686135061.issue12922@psf.upfronthosting.co.za>


Martin Panter added the comment:

Opened Issue 25190 about the enhancing StringIO side of this.

----------

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

From tgoodchild at gmail.com  Fri Sep 18 21:35:09 2015
From: tgoodchild at gmail.com (Tony R.)
Date: Fri, 18 Sep 2015 15:35:09 -0400
Subject: [docs] Documentation Patch: Deprecations first
Message-ID: <78B97BF6-A15C-484C-B3FC-1A4D58B8764A@gmail.com>

SUMMARY
========

If a class, or a function, or *anything* is deprecated, I think the deprecation should be the first thing in the description.



Rationale
-----------

When preparing to use a module for the first time, I have often read through long, detailed documentation, only to discover that the subject of my attention was deprecated.  It would save time and frustration for the reader to have the deprecation notice at the beginning of the description, rather than the end.  

Often, deprecations include a message like ?[spam] is deprecated; use [eggs] instead?.  Even better!  Now the reader can do better than saving themselves the time they would have wasted reading the description; they can go directly to the intended replacement for the deprecated item.



Patch
-------

Attached is a patch that contains the modifications to the *.rst docs.

-------------- next part --------------
A non-text attachment was scrubbed...
Name: docs-deprecations-first.diff
Type: application/octet-stream
Size: 46674 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20150918/84f53350/attachment-0001.obj>
-------------- next part --------------




From vadmium+py at gmail.com  Sat Sep 19 08:44:14 2015
From: vadmium+py at gmail.com (vadmium+py at gmail.com)
Date: Sat, 19 Sep 2015 06:44:14 -0000
Subject: [docs] Missing periods at the end of sentences (issue 25161)
Message-ID: <20150919064414.6414.80643@psf.upfronthosting.co.za>


https://bugs.python.org/review/25161/diff/15569/Doc/library/http.cookiejar.rst
File Doc/library/http.cookiejar.rst (right):

https://bugs.python.org/review/25161/diff/15569/Doc/library/http.cookiejar.rst#newcode543
Doc/library/http.cookiejar.rst:543: apply RFC 2965 rules on unverifiable
transactions even to Netscape cookies.
This could also do with a capital letter at the start for Apply.

https://bugs.python.org/review/25161/diff/15569/Doc/library/tkinter.ttk.rst
File Doc/library/tkinter.ttk.rst (right):

https://bugs.python.org/review/25161/diff/15569/Doc/library/tkinter.ttk.rst#newcode114
Doc/library/tkinter.ttk.rst:114: |           | which may only be
specified when the window is created.      |
The whole sentence needs more editing. I suggest something like:

This option is read-only, and may only be specified when the window is
created.

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

From report at bugs.python.org  Sun Sep 20 11:30:17 2015
From: report at bugs.python.org (Petr Viktorin)
Date: Sun, 20 Sep 2015 09:30:17 +0000
Subject: [docs] [issue25079] Tokenize generates NL instead of NEWLINE for
	comments
In-Reply-To: <1442051359.49.0.451935650182.issue25079@psf.upfronthosting.co.za>
Message-ID: <1442741417.25.0.458920686327.issue25079@psf.upfronthosting.co.za>


Petr Viktorin added the comment:

As it says in the docs, a "logical line that contains only spaces, tabs, formfeeds and possibly a comment, is ignored."

If you write:

if a=b:
    statement
# Comment
    another statement

both statements belong to the "if" block.
In your example, the comment is similarly part of the "if" block, so the dedent comes after it.

----------
nosy: +encukou

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

From report at bugs.python.org  Sun Sep 20 19:32:40 2015
From: report at bugs.python.org (Prashant Tyagi)
Date: Sun, 20 Sep 2015 17:32:40 +0000
Subject: [docs] [issue24894] iso-8859-11 missing from codecs table
In-Reply-To: <1439964625.02.0.805508700241.issue24894@psf.upfronthosting.co.za>
Message-ID: <1442770360.31.0.352079085828.issue24894@psf.upfronthosting.co.za>


Prashant Tyagi added the comment:

As it is cleary stated itself into the wipikedia https://en.wikipedia.org/wiki/ISO/IEC_8859#The_Parts_of_ISO.2FIEC_8859.

"The work in making a part of 8859 for Devanagari was officially abandoned in 1997. ISCII and Unicode/ISO/IEC 10646 cover Devanagari."
so actually i dont think it should be a part of 8859_12.
 However 8859_11 is virtually identical to TIS 620 so it might be needed.

----------
nosy: +tyagi221295
versions:  -Python 2.7, Python 3.3, Python 3.4, Python 3.6

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

From report at bugs.python.org  Sun Sep 20 20:19:17 2015
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 20 Sep 2015 18:19:17 +0000
Subject: [docs] [issue25145] urllib how-to should be updated to remove
	PyGoogle
In-Reply-To: <1442439158.29.0.495500663722.issue25145@psf.upfronthosting.co.za>
Message-ID: <20150920181914.31195.49238@psf.io>


Roundup Robot added the comment:

New changeset 1fcdca298be9 by Benjamin Peterson in branch '3.4':
use a more modern UA (#25145)
https://hg.python.org/cpython/rev/1fcdca298be9

New changeset 2efd269b3eb8 by Benjamin Peterson in branch '3.4':
remove reference to PyGoogle (#25145)
https://hg.python.org/cpython/rev/2efd269b3eb8

New changeset 9b7bc13aed4e by Benjamin Peterson in branch '2.7':
remove reference to PyGoogle (#25145)
https://hg.python.org/cpython/rev/9b7bc13aed4e

New changeset 96eff21fc47e by Benjamin Peterson in branch '2.7':
use a more modern UA (#25145)
https://hg.python.org/cpython/rev/96eff21fc47e

New changeset 7f76c7d853be by Benjamin Peterson in branch '3.5':
merge 3.4 (#25145)
https://hg.python.org/cpython/rev/7f76c7d853be

New changeset 54ea36ce6eab by Benjamin Peterson in branch 'default':
merge 3.5 (#25145)
https://hg.python.org/cpython/rev/54ea36ce6eab

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

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

From report at bugs.python.org  Sun Sep 20 20:35:49 2015
From: report at bugs.python.org (Prashant Tyagi)
Date: Sun, 20 Sep 2015 18:35:49 +0000
Subject: [docs] [issue24894] iso-8859-11 missing from codecs table
In-Reply-To: <1439964625.02.0.805508700241.issue24894@psf.upfronthosting.co.za>
Message-ID: <1442774149.08.0.768692931617.issue24894@psf.upfronthosting.co.za>


Prashant Tyagi added the comment:

Here is my patch which includes iso8859_11 to the docs.

----------
keywords: +patch
Added file: http://bugs.python.org/file40528/Issue24894.patch

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

From report at bugs.python.org  Sun Sep 20 22:14:52 2015
From: report at bugs.python.org (Matthias Bussonnier)
Date: Sun, 20 Sep 2015 20:14:52 +0000
Subject: [docs] [issue25197] Allow documentation switcher to change url to
 /3/ and /dev/
Message-ID: <1442780092.62.0.798906880968.issue25197@psf.upfronthosting.co.za>


New submission from Matthias Bussonnier:

The current documentation  version switcher does not allow to get back to the `python.org/3/..`
and `python.org/dev/...` url who permanently track the stable/developement release of Python
the attached patch allows that and should permit  in the long term less link on the internet to be out of date.

----------
assignee: docs at python
components: Documentation
files: docp.patch
keywords: patch
messages: 251177
nosy: docs at python, mbussonn
priority: normal
severity: normal
status: open
title: Allow documentation switcher to change url to /3/ and /dev/
type: enhancement
Added file: http://bugs.python.org/file40529/docp.patch

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

From report at bugs.python.org  Sun Sep 20 22:20:14 2015
From: report at bugs.python.org (Benjamin Peterson)
Date: Sun, 20 Sep 2015 20:20:14 +0000
Subject: [docs] [issue25145] urllib how-to should be updated to remove
	PyGoogle
In-Reply-To: <1442439158.29.0.495500663722.issue25145@psf.upfronthosting.co.za>
Message-ID: <1442780414.19.0.3454758605.issue25145@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sun Sep 20 22:52:45 2015
From: report at bugs.python.org (Davin Potts)
Date: Sun, 20 Sep 2015 20:52:45 +0000
Subject: [docs] [issue25169] multiprocess documentation
In-Reply-To: <1442588076.4.0.907099744388.issue25169@psf.upfronthosting.co.za>
Message-ID: <1442782365.42.0.949899980512.issue25169@psf.upfronthosting.co.za>


Changes by Davin Potts <python at discontinuity.net>:


----------
stage:  -> patch review
type:  -> enhancement

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

From report at bugs.python.org  Mon Sep 21 00:27:32 2015
From: report at bugs.python.org (Davin Potts)
Date: Sun, 20 Sep 2015 22:27:32 +0000
Subject: [docs] [issue18620] multiprocessing page leaves out important part
 of Pool example
In-Reply-To: <1375389044.82.0.349700607179.issue18620@psf.upfronthosting.co.za>
Message-ID: <1442788052.87.0.739364818764.issue18620@psf.upfronthosting.co.za>


Changes by Davin Potts <python at discontinuity.net>:


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

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

From report at bugs.python.org  Mon Sep 21 00:30:06 2015
From: report at bugs.python.org (Davin Potts)
Date: Sun, 20 Sep 2015 22:30:06 +0000
Subject: [docs] [issue25169] multiprocess documentation
In-Reply-To: <1442588076.4.0.907099744388.issue25169@psf.upfronthosting.co.za>
Message-ID: <1442788206.92.0.193516752222.issue25169@psf.upfronthosting.co.za>


Davin Potts added the comment:

Good catch and agreed this should be cleaned up.

Patch looks good to me and given its nature is probably all we need although it's probably worth combining this minor documentation update so that it gets applied with some other documentation patch(es) at the same time.

----------
nosy: +davin
versions: +Python 3.4, Python 3.6

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

From report at bugs.python.org  Mon Sep 21 00:31:22 2015
From: report at bugs.python.org (Davin Potts)
Date: Sun, 20 Sep 2015 22:31:22 +0000
Subject: [docs] [issue25169] multiprocessing docs example still refs
 os.getppid as unix-only
In-Reply-To: <1442588076.4.0.907099744388.issue25169@psf.upfronthosting.co.za>
Message-ID: <1442788282.23.0.109068469436.issue25169@psf.upfronthosting.co.za>


Changes by Davin Potts <python at discontinuity.net>:


----------
title: multiprocess documentation -> multiprocessing docs example still refs os.getppid as unix-only

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

From report at bugs.python.org  Mon Sep 21 01:46:01 2015
From: report at bugs.python.org (Berker Peksag)
Date: Sun, 20 Sep 2015 23:46:01 +0000
Subject: [docs] [issue25145] urllib how-to should be updated to remove
	PyGoogle
In-Reply-To: <1442439158.29.0.495500663722.issue25145@psf.upfronthosting.co.za>
Message-ID: <1442792761.13.0.793633983825.issue25145@psf.upfronthosting.co.za>


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


----------
stage: needs patch -> resolved

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

From report at bugs.python.org  Mon Sep 21 02:06:17 2015
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 21 Sep 2015 00:06:17 +0000
Subject: [docs] [issue16893] Generate Idle help from Doc/library/idle.rst
In-Reply-To: <1357663512.19.0.739336896498.issue16893@psf.upfronthosting.co.za>
Message-ID: <20150921000612.94109.81188@psf.io>


Roundup Robot added the comment:

New changeset 4038508240a1 by Terry Jan Reedy in branch '2.7':
Issue #16893: Replace help.txt with idle.html for Idle doc display.
https://hg.python.org/cpython/rev/4038508240a1

New changeset 52510bc368f8 by Terry Jan Reedy in branch '2.7':
Issue #16893: include new files
https://hg.python.org/cpython/rev/52510bc368f8

New changeset 2d808b72996d by Terry Jan Reedy in branch '3.4':
Issue #16893: Replace help.txt with idle.html for Idle doc display.
https://hg.python.org/cpython/rev/2d808b72996d

New changeset e66fbfa282c6 by Terry Jan Reedy in branch '2.7':
Issue #16893: whitespace in idle.html.
https://hg.python.org/cpython/rev/e66fbfa282c6

New changeset 9b79a4901069 by Terry Jan Reedy in branch '3.4':
Issue #16893: whitespace in idle.html.
https://hg.python.org/cpython/rev/9b79a4901069

New changeset 1107e3ee6103 by Terry Jan Reedy in branch '2.7':
Issue #16893: whitespace in help.py.
https://hg.python.org/cpython/rev/1107e3ee6103

----------

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

From report at bugs.python.org  Mon Sep 21 03:02:15 2015
From: report at bugs.python.org (Terry J. Reedy)
Date: Mon, 21 Sep 2015 01:02:15 +0000
Subject: [docs] [issue16893] Generate Idle help from Doc/library/idle.rst
In-Reply-To: <1357663512.19.0.739336896498.issue16893@psf.upfronthosting.co.za>
Message-ID: <1442797334.79.0.700201879686.issue16893@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

I committed a patch that works well enough for release as it. I attached the diff for changed files in case anyone wants to view in Rietveld. 

Still to do for this issue:

* Automate getting the 2.7 and earliest 3.x idle.html copied to idlelib and whitespace-normalized. (Commit/push should stay manual.) Several lines have 1 to many blanks at the end, while the file lacks a final \n.  See e66fbfa282c6. (These anomalies come from Sphinx; idle.rst has been normalized to be checked in.)

I have a .bat file that builds any and copies as needed.  I will to add a pass through Idle's trailing-whitespace deleter, which did just what was needed to commit. (Patchcheck.normalize_docs_whitespace does a here unneeded comparision (always unequal), creates an unwanted and nuisance .bak, and does not appear to work when the last list has no '\n'.)

When I have automation working for me, I would like to add make targets for others to use (Zach's patch 4).

* Edit idle.rst

I will push NEWS and idlelib.NEWS entries separately, along with others for Idle.

I opened new issue #25198 for further viewer improvements (and bug fixes, if any).

----------
Added file: http://bugs.python.org/file40530/htmlhelp.diff

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

From report at bugs.python.org  Mon Sep 21 05:06:16 2015
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 21 Sep 2015 03:06:16 +0000
Subject: [docs] [issue16893] Generate Idle help from Doc/library/idle.rst
In-Reply-To: <1357663512.19.0.739336896498.issue16893@psf.upfronthosting.co.za>
Message-ID: <20150921030612.82638.37811@psf.io>


Roundup Robot added the comment:

New changeset e749080fa0f9 by Terry Jan Reedy in branch '2.7':
Issue #16893: finish deprecation.
https://hg.python.org/cpython/rev/e749080fa0f9

New changeset ff0270e9bdfb by Terry Jan Reedy in branch '3.4':
Issue #16893: finish deprecation.
https://hg.python.org/cpython/rev/ff0270e9bdfb

----------

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

From report at bugs.python.org  Mon Sep 21 05:13:35 2015
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 21 Sep 2015 03:13:35 +0000
Subject: [docs] [issue25169] multiprocessing docs example still refs
 os.getppid as unix-only
In-Reply-To: <1442588076.4.0.907099744388.issue25169@psf.upfronthosting.co.za>
Message-ID: <20150921031332.3644.44864@psf.io>


Roundup Robot added the comment:

New changeset 60b0bc23c69e by Berker Peksag in branch '3.4':
Issue #25169: os.getppid() is available on Windows since Python 3.2.
https://hg.python.org/cpython/rev/60b0bc23c69e

New changeset c6ccef432dc2 by Berker Peksag in branch '3.5':
Issue #25169: os.getppid() is available on Windows since Python 3.2.
https://hg.python.org/cpython/rev/c6ccef432dc2

New changeset 71a6d4c7cd01 by Berker Peksag in branch 'default':
Issue #25169: os.getppid() is available on Windows since Python 3.2.
https://hg.python.org/cpython/rev/71a6d4c7cd01

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

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

From report at bugs.python.org  Mon Sep 21 05:16:04 2015
From: report at bugs.python.org (Berker Peksag)
Date: Mon, 21 Sep 2015 03:16:04 +0000
Subject: [docs] [issue25169] multiprocessing docs example still refs
 os.getppid as unix-only
In-Reply-To: <1442588076.4.0.907099744388.issue25169@psf.upfronthosting.co.za>
Message-ID: <1442805364.66.0.985526739189.issue25169@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Fixed in 3.4, 3.5 and 3.6. Thanks all!

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

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

From report at bugs.python.org  Mon Sep 21 05:52:10 2015
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 21 Sep 2015 03:52:10 +0000
Subject: [docs] [issue23484] SemLock acquire() keyword arg 'blocking' is
	invalid
In-Reply-To: <1424345474.95.0.767809945273.issue23484@psf.upfronthosting.co.za>
Message-ID: <20150921035207.115438.19650@psf.io>


Roundup Robot added the comment:

New changeset f3faf0f355e0 by Berker Peksag in branch '3.4':
Issue #23484: Document differences between synchronization primitives of
https://hg.python.org/cpython/rev/f3faf0f355e0

New changeset 6cd030099966 by Berker Peksag in branch '3.5':
Issue #23484: Document differences between synchronization primitives of
https://hg.python.org/cpython/rev/6cd030099966

New changeset 020377a15708 by Berker Peksag in branch 'default':
Issue #23484: Document differences between synchronization primitives of
https://hg.python.org/cpython/rev/020377a15708

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

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

From report at bugs.python.org  Mon Sep 21 06:05:21 2015
From: report at bugs.python.org (Berker Peksag)
Date: Mon, 21 Sep 2015 04:05:21 +0000
Subject: [docs] [issue25201] lock of multiprocessing.Value is not a
 keyword-only argument
Message-ID: <1442808321.25.0.819772413422.issue25201@psf.upfronthosting.co.za>


New submission from Berker Peksag:

>From https://docs.python.org/3/library/multiprocessing.html#multiprocessing.Value

    Note that lock is a keyword-only argument.

But the signature of Value (in Lib/multiprocessing/context.py)

    def Value(self, typecode_or_type, *args, lock=True):

and (in Lib/multiprocessing/sharedctypes.py)

    def Value(typecode_or_type, *args, lock=True, ctx=None):

I'd suggest to remove that part of the documentation in 3.4+. We can also make it a keyword-only argument in Python 3.6. That will make the API more similar with https://docs.python.org/3/library/multiprocessing.html#multiprocessing.Array

----------
assignee: docs at python
components: Documentation
messages: 251196
nosy: berker.peksag, davin, docs at python, sbt
priority: normal
severity: normal
stage: needs patch
status: open
title: lock of multiprocessing.Value is not a keyword-only argument
type: behavior
versions: Python 3.4, Python 3.5, Python 3.6

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

From report at bugs.python.org  Mon Sep 21 06:15:49 2015
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 21 Sep 2015 04:15:49 +0000
Subject: [docs] [issue23484] SemLock acquire() keyword arg 'blocking' is
	invalid
In-Reply-To: <1424345474.95.0.767809945273.issue23484@psf.upfronthosting.co.za>
Message-ID: <20150921041546.11704.7230@psf.io>


Roundup Robot added the comment:

New changeset 92350a2a8b08 by Berker Peksag in branch '2.7':
Issue #23484: Document differences between synchronization primitives of
https://hg.python.org/cpython/rev/92350a2a8b08

----------

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

From report at bugs.python.org  Mon Sep 21 06:17:00 2015
From: report at bugs.python.org (Berker Peksag)
Date: Mon, 21 Sep 2015 04:17:00 +0000
Subject: [docs] [issue23484] SemLock acquire() keyword arg 'blocking' is
	invalid
In-Reply-To: <1424345474.95.0.767809945273.issue23484@psf.upfronthosting.co.za>
Message-ID: <1442809020.46.0.723669311651.issue23484@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Thanks, Teodor and Davin!

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

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

From report at bugs.python.org  Mon Sep 21 08:00:06 2015
From: report at bugs.python.org (Martin Panter)
Date: Mon, 21 Sep 2015 06:00:06 +0000
Subject: [docs] [issue25201] lock of multiprocessing.Value is not a
 keyword-only argument
In-Reply-To: <1442808321.25.0.819772413422.issue25201@psf.upfronthosting.co.za>
Message-ID: <1442815206.39.0.250714584878.issue25201@psf.upfronthosting.co.za>


Martin Panter added the comment:

I?m not familiar with this module, but I believe ?lock? is indeed keyword-only. If you were to try a positional argument, it would be picked up as part of *args:

>>> multiprocessing.Value("I")  # Default to 0, lock=True
<Synchronized wrapper for c_uint(0)>
>>> multiprocessing.Value("I", False)  # False == 0, still lock=True
<Synchronized wrapper for c_uint(0)>
>>> multiprocessing.Value("I", lock=False)
c_uint(0)

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

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

From report at bugs.python.org  Mon Sep 21 22:59:47 2015
From: report at bugs.python.org (Benjamin Hodgson)
Date: Mon, 21 Sep 2015 20:59:47 +0000
Subject: [docs] [issue25208] improvements to the asyncio documentation
Message-ID: <1442869187.79.0.516080462087.issue25208@psf.upfronthosting.co.za>


New submission from Benjamin Hodgson:

I spotted some grammatical errors in the "Develop with asyncio" page, so I improved the wording a bit. I also added a more explicit link to BaseEventLoop.set_debug().

----------
assignee: docs at python
components: Documentation
files: asynciodocs.patch
keywords: patch
messages: 251260
nosy: Benjamin Hodgson, docs at python
priority: normal
severity: normal
status: open
title: improvements to the asyncio documentation
versions: Python 3.4, Python 3.5
Added file: http://bugs.python.org/file40537/asynciodocs.patch

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

From report at bugs.python.org  Mon Sep 21 23:01:34 2015
From: report at bugs.python.org (Benjamin Hodgson)
Date: Mon, 21 Sep 2015 21:01:34 +0000
Subject: [docs] [issue25208] improvements to the asyncio documentation
In-Reply-To: <1442869187.79.0.516080462087.issue25208@psf.upfronthosting.co.za>
Message-ID: <1442869294.97.0.711871238058.issue25208@psf.upfronthosting.co.za>


Changes by Benjamin Hodgson <benhodgson91 at gmail.com>:


----------
type:  -> enhancement

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

From report at bugs.python.org  Mon Sep 21 23:41:18 2015
From: report at bugs.python.org (eryksun)
Date: Mon, 21 Sep 2015 21:41:18 +0000
Subject: [docs] [issue25205] setattr accepts invalid identifiers
In-Reply-To: <1442861960.51.0.201067879836.issue25205@psf.upfronthosting.co.za>
Message-ID: <1442871678.23.0.401485661448.issue25205@psf.upfronthosting.co.za>


eryksun added the comment:

The name can be any str/unicode string, including language keywords: 

    >>> setattr(o, 'def', 'allowed')
    >>> getattr(o, 'def')
    'allowed'
    >>> o.def
      File "<stdin>", line 1
        o.def
            ^
    SyntaxError: invalid syntax

and even an empty string:

    >>> setattr(o, '', 'mu')
    >>> getattr(o, '')
    'mu'

This includes instances of str and unicode subclasses, at least in CPython.

----------
assignee:  -> docs at python
components: +Documentation
nosy: +docs at python, eryksun
priority: normal -> low
versions:  -Python 2.7

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

From report at bugs.python.org  Mon Sep 21 23:51:15 2015
From: report at bugs.python.org (eryksun)
Date: Mon, 21 Sep 2015 21:51:15 +0000
Subject: [docs] [issue25205] setattr accepts invalid identifiers
In-Reply-To: <1442861960.51.0.201067879836.issue25205@psf.upfronthosting.co.za>
Message-ID: <1442872275.04.0.0848136476822.issue25205@psf.upfronthosting.co.za>


eryksun added the comment:

To clarify using a unicode name in 2.x, it has to be encodable using the default encoding, sys.getdefaultencoding(). Normally this is ASCII.

----------

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

From report at bugs.python.org  Mon Sep 21 23:56:08 2015
From: report at bugs.python.org (Josh Rosenberg)
Date: Mon, 21 Sep 2015 21:56:08 +0000
Subject: [docs] [issue25201] lock of multiprocessing.Value is not a
 keyword-only argument
In-Reply-To: <1442808321.25.0.819772413422.issue25201@psf.upfronthosting.co.za>
Message-ID: <1442872568.64.0.302550439021.issue25201@psf.upfronthosting.co.za>


Josh Rosenberg added the comment:

Agreed. Having a named positional varargs argument makes subsequently defined arguments keyword only automatically.

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

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

From report at bugs.python.org  Tue Sep 22 00:49:59 2015
From: report at bugs.python.org (Martin Panter)
Date: Mon, 21 Sep 2015 22:49:59 +0000
Subject: [docs] [issue25205] setattr accepts invalid identifiers
In-Reply-To: <1442861960.51.0.201067879836.issue25205@psf.upfronthosting.co.za>
Message-ID: <1442875799.46.0.981451424568.issue25205@psf.upfronthosting.co.za>


Martin Panter added the comment:

Previous report: Issue 14029

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

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

From report at bugs.python.org  Tue Sep 22 02:49:33 2015
From: report at bugs.python.org (Davin Potts)
Date: Tue, 22 Sep 2015 00:49:33 +0000
Subject: [docs] [issue25201] lock of multiprocessing.Value is not a
 keyword-only argument
In-Reply-To: <1442808321.25.0.819772413422.issue25201@psf.upfronthosting.co.za>
Message-ID: <1442882973.61.0.127575152905.issue25201@psf.upfronthosting.co.za>


Davin Potts added the comment:

Berker: It looks to me like the docs are indeed in sync with the code on Value in that lock really is a keyword-only argument.  It looks like it's been that way since at least 2.7 (I didn't look at earlier).  There are enough other things in the multiprocessing.sharedctypes, maybe it was one of the others that caught your attention instead?

I wished that block/blocking had turned out to be a keyword-only argument in multiprocessing.Lock as part of issue23484, which I immediately thought of when reading this issue.

----------

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

From report at bugs.python.org  Tue Sep 22 04:43:21 2015
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 22 Sep 2015 02:43:21 +0000
Subject: [docs] [issue16893] Generate Idle help from Doc/library/idle.rst
In-Reply-To: <1357663512.19.0.739336896498.issue16893@psf.upfronthosting.co.za>
Message-ID: <20150922024318.9953.95175@psf.io>


Roundup Robot added the comment:

New changeset 855484b55da3 by Terry Jan Reedy in branch '2.7':
Issue #16893: Add idlelib.help.copy_strip() to copy-rstrip Doc/.../idle.html.
https://hg.python.org/cpython/rev/855484b55da3

New changeset df987a0bc350 by Terry Jan Reedy in branch '3.4':
Issue #16893: Add idlelib.help.copy_strip() to copy-rstrip Doc/.../idle.html.
https://hg.python.org/cpython/rev/df987a0bc350

New changeset f08437278049 by Terry Jan Reedy in branch '3.5':
Issue #16893: Add idlelib.help.copy_strip() to copy-rstrip Doc/.../idle.html.
https://hg.python.org/cpython/rev/f08437278049

New changeset 09ebed6a8cb8 by Terry Jan Reedy in branch 'default':
Issue #16893: Add idlelib.help.copy_strip() to copy-rstrip Doc/.../idle.html.
https://hg.python.org/cpython/rev/09ebed6a8cb8

----------

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

From report at bugs.python.org  Tue Sep 22 04:52:38 2015
From: report at bugs.python.org (Terry J. Reedy)
Date: Tue, 22 Sep 2015 02:52:38 +0000
Subject: [docs] [issue16893] Generate Idle help from Doc/library/idle.rst
In-Reply-To: <1357663512.19.0.739336896498.issue16893@psf.upfronthosting.co.za>
Message-ID: <1442890358.26.0.450226769375.issue16893@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

NEWS entries are done.

I added a function, copy_strip, to help.py to rstrip (in bytes mode) idle.html as it copies to help.html.  (I changed the name to better remember which is which.)  In my .bat file, with Doc as current directory, I use
  ..\pcbuild\python_d.exe -c "from idlelib.help import copy_strip; copy_strip()"
I could change the if __name__ block so that
  ..\pcbuild\python_d.exe -m idlelib.help copy_strip
would work.  Either way, I would like to add 'idlehelp' to makefiles.  But not tonight.

----------

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

From report at bugs.python.org  Tue Sep 22 05:32:30 2015
From: report at bugs.python.org (Berker Peksag)
Date: Tue, 22 Sep 2015 03:32:30 +0000
Subject: [docs] [issue25201] lock of multiprocessing.Value is not a
 keyword-only argument
In-Reply-To: <1442808321.25.0.819772413422.issue25201@psf.upfronthosting.co.za>
Message-ID: <1442892750.46.0.357416752934.issue25201@psf.upfronthosting.co.za>


Berker Peksag added the comment:

I didn't test it carefully. It was a mistake on my part :) But I think the function signature could be clearer by changing that part to "*, lock=True".

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

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

From report at bugs.python.org  Tue Sep 22 14:18:18 2015
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Tue, 22 Sep 2015 12:18:18 +0000
Subject: [docs] [issue25212] Remove the double spaces in the C-API Intro
Message-ID: <1442924296.56.0.832273606217.issue25212@psf.upfronthosting.co.za>


New submission from St?phane Wirtel:

Remove the double spaces in the C-API intro in the documentation.

----------
assignee: docs at python
components: Documentation
files: remove_double_space_capi.patch
keywords: patch
messages: 251310
nosy: docs at python, matrixise
priority: normal
severity: normal
status: open
title: Remove the double spaces in the C-API Intro
versions: Python 3.6
Added file: http://bugs.python.org/file40548/remove_double_space_capi.patch

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

From report at bugs.python.org  Tue Sep 22 14:25:38 2015
From: report at bugs.python.org (Ezio Melotti)
Date: Tue, 22 Sep 2015 12:25:38 +0000
Subject: [docs] [issue25212] Remove the double spaces in the C-API Intro
In-Reply-To: <1442924296.56.0.832273606217.issue25212@psf.upfronthosting.co.za>
Message-ID: <1442924738.43.0.50899264257.issue25212@psf.upfronthosting.co.za>


Ezio Melotti added the comment:

Thanks for your contribution, however double spaces after a full stop should be kept, since they are intentional (they make the .rst source more readable).  Your patch also seems to include other instances that are not after a full stop.  In theory those could be kept, but I'm not sure if it's worth spending time preparing and applying a new patch.

----------
nosy: +ezio.melotti
priority: normal -> low
status: open -> pending
type:  -> enhancement

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

From report at bugs.python.org  Tue Sep 22 14:32:45 2015
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Tue, 22 Sep 2015 12:32:45 +0000
Subject: [docs] [issue25212] Remove the double spaces in the C-API Intro
In-Reply-To: <1442924296.56.0.832273606217.issue25212@psf.upfronthosting.co.za>
Message-ID: <1442925165.71.0.638810720181.issue25212@psf.upfronthosting.co.za>


St?phane Wirtel added the comment:

Hi Ezio,

What's a full stop ?

Thanks

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

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

From report at bugs.python.org  Tue Sep 22 14:34:17 2015
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Tue, 22 Sep 2015 12:34:17 +0000
Subject: [docs] [issue25212] Remove the double spaces in the C-API Intro
In-Reply-To: <1442924296.56.0.832273606217.issue25212@psf.upfronthosting.co.za>
Message-ID: <1442925257.41.0.143086369629.issue25212@psf.upfronthosting.co.za>


St?phane Wirtel added the comment:

ok, found: http://www.edufind.com/english-grammar/period-full-stop-or-point/

----------

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

From report at bugs.python.org  Tue Sep 22 14:36:25 2015
From: report at bugs.python.org (Ezio Melotti)
Date: Tue, 22 Sep 2015 12:36:25 +0000
Subject: [docs] [issue25212] Remove the double spaces in the C-API Intro
In-Reply-To: <1442924296.56.0.832273606217.issue25212@psf.upfronthosting.co.za>
Message-ID: <1442925385.04.0.653946132686.issue25212@psf.upfronthosting.co.za>


Ezio Melotti added the comment:

The `.` at the end of a sentence.

In the following example, the double space between "is" and "an" could be fixed (even though is not a big problem), whereas the one between "example." and "This" is OK and should be kept:

This is  an example.  This too.
       ^^           ^^
     Not OK         OK

----------

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

From report at bugs.python.org  Tue Sep 22 15:02:46 2015
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Tue, 22 Sep 2015 13:02:46 +0000
Subject: [docs] [issue25212] Remove the double spaces in the C-API Intro
In-Reply-To: <1442925385.04.0.653946132686.issue25212@psf.upfronthosting.co.za>
Message-ID: <E776F8B1-2E32-42C3-A8E4-517532F2263F@wirtel.be>


St?phane Wirtel added the comment:

And in this case:

?This is  an example.  This too?   will become ?This is an 
example.  This too?

Is it right?
Stef
On 22 Sep 2015, at 14:36, Ezio Melotti wrote:

> Ezio Melotti added the comment:
>
> The `.` at the end of a sentence.
>
> In the following example, the double space between "is" and "an" could 
> be fixed (even though is not a big problem), whereas the one between 
> "example." and "This" is OK and should be kept:
>
> This is  an example.  This too.
>    ^^           ^^
>  Not OK         OK
>
> ----------
>
> _______________________________________
> Python tracker <report at bugs.python.org>
> <http://bugs.python.org/issue25212>
> _______________________________________

----------

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

From report at bugs.python.org  Tue Sep 22 15:06:30 2015
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 22 Sep 2015 13:06:30 +0000
Subject: [docs] [issue25212] Remove the double spaces in the C-API Intro
In-Reply-To: <1442924296.56.0.832273606217.issue25212@psf.upfronthosting.co.za>
Message-ID: <1442927190.94.0.611129099049.issue25212@psf.upfronthosting.co.za>


STINNER Victor added the comment:

The vim editor *adds* two spaces between a full stop and the beginning of a new sentence. As a french, I was always distributed by this, but it's correct in english :-) As Ezio wrote, it may even be better to have two spaces than one, for readability.

Well well well, this issue is really border line because users don't read the .rst files but the HTML output which uses a single space.

Seriously, why really cares? Just close the issue as WONTFIX and try to enhance the doc differently ;-)

----------
nosy: +haypo

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

From report at bugs.python.org  Tue Sep 22 15:07:29 2015
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 22 Sep 2015 13:07:29 +0000
Subject: [docs] [issue25212] Remove the double spaces in the C-API Intro
In-Reply-To: <1442924296.56.0.832273606217.issue25212@psf.upfronthosting.co.za>
Message-ID: <1442927249.94.0.166879321388.issue25212@psf.upfronthosting.co.za>


STINNER Victor added the comment:

If you would like to contribute to the Python doc, please help to make the asyncio doc simpler for new comers. Maybe add a few more examples. Or explain better asyncio concepts like tasks, coroutines and futures.

----------

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

From report at bugs.python.org  Tue Sep 22 15:25:10 2015
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 22 Sep 2015 13:25:10 +0000
Subject: [docs] [issue25212] Remove the double spaces in the C-API Intro
In-Reply-To: <1442924296.56.0.832273606217.issue25212@psf.upfronthosting.co.za>
Message-ID: <1442928310.81.0.74501471654.issue25212@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

PEP 8: You should use two spaces after a sentence-ending period.

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

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

From report at bugs.python.org  Tue Sep 22 15:29:03 2015
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 22 Sep 2015 13:29:03 +0000
Subject: [docs] [issue25212] Remove the double spaces in the C-API Intro
In-Reply-To: <1442924296.56.0.832273606217.issue25212@psf.upfronthosting.co.za>
Message-ID: <1442928543.74.0.249287526813.issue25212@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

PEP 9: You must adhere to the Emacs convention of adding two spaces at the end of every sentence.

----------

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

From report at bugs.python.org  Tue Sep 22 15:32:07 2015
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Tue, 22 Sep 2015 13:32:07 +0000
Subject: [docs] [issue25212] Remove the double spaces in the C-API Intro
In-Reply-To: <1442924296.56.0.832273606217.issue25212@psf.upfronthosting.co.za>
Message-ID: <1442928727.32.0.050120914447.issue25212@psf.upfronthosting.co.za>


St?phane Wirtel added the comment:

ok, can I close this useless issue ?

Thank you for the details about the emacs convention and the rest.

----------

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

From report at bugs.python.org  Tue Sep 22 16:16:44 2015
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Tue, 22 Sep 2015 14:16:44 +0000
Subject: [docs] [issue25212] Remove the double spaces in the C-API Intro
In-Reply-To: <1442924296.56.0.832273606217.issue25212@psf.upfronthosting.co.za>
Message-ID: <1442931404.35.0.0463717581364.issue25212@psf.upfronthosting.co.za>


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


----------
resolution:  -> wont fix
status: open -> closed

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

From report at bugs.python.org  Tue Sep 22 16:25:04 2015
From: report at bugs.python.org (Ezio Melotti)
Date: Tue, 22 Sep 2015 14:25:04 +0000
Subject: [docs] [issue25212] Remove the double spaces in the C-API Intro
In-Reply-To: <1442924296.56.0.832273606217.issue25212@psf.upfronthosting.co.za>
Message-ID: <1442931904.46.0.736697002995.issue25212@psf.upfronthosting.co.za>


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


----------
stage:  -> resolved

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

From report at bugs.python.org  Tue Sep 22 19:23:36 2015
From: report at bugs.python.org (Georg Brandl)
Date: Tue, 22 Sep 2015 17:23:36 +0000
Subject: [docs] [issue25212] Remove the double spaces in the C-API Intro
In-Reply-To: <1442924296.56.0.832273606217.issue25212@psf.upfronthosting.co.za>
Message-ID: <1442942616.08.0.0180999561163.issue25212@psf.upfronthosting.co.za>


Georg Brandl added the comment:

> As a french, I was always distributed by this, but it's correct in english :-)

You know what you have to tell LaTeX to not put extra space after all full stops? \frenchspacing :)

----------
nosy: +georg.brandl

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

From report at bugs.python.org  Tue Sep 22 19:38:53 2015
From: report at bugs.python.org (W deW)
Date: Tue, 22 Sep 2015 17:38:53 +0000
Subject: [docs] [issue25205] setattr accepts invalid identifiers
In-Reply-To: <1442861960.51.0.201067879836.issue25205@psf.upfronthosting.co.za>
Message-ID: <1442943533.45.0.708595790602.issue25205@psf.upfronthosting.co.za>


W deW added the comment:

Thanks for the ref to issue14029. I think I see how it works. As long as the object's __dict__ accepts the attributeName as a key, it needs not be a valid string nor a string at all. Though the latter *is* checked for, and that in turn can be circumvented by adding the attribute to the __dict__ directly. An object can be made attribute to itself.

However, the documentation falls short here. So far, I haven't found where it defines "attribute". Is there any point in defining an attribute that cannot be addressed as an attribute if the parser doesn't allow it?

It seems to me that in order to catch programing errors early, the default behaviour should include checking the valid syntax of the attribute's name.

----------
components:  -Documentation
versions: +Python 2.7

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

From report at bugs.python.org  Tue Sep 22 20:08:44 2015
From: report at bugs.python.org (eryksun)
Date: Tue, 22 Sep 2015 18:08:44 +0000
Subject: [docs] [issue25205] setattr accepts invalid identifiers
In-Reply-To: <1442861960.51.0.201067879836.issue25205@psf.upfronthosting.co.za>
Message-ID: <1442945324.2.0.959058688889.issue25205@psf.upfronthosting.co.za>


eryksun added the comment:

This is a documentation issue and not specific to a particular version  of Python. What's the rule on version tagging in this case?

----------
components: +Documentation

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

From report at bugs.python.org  Tue Sep 22 23:32:48 2015
From: report at bugs.python.org (Martin Panter)
Date: Tue, 22 Sep 2015 21:32:48 +0000
Subject: [docs] [issue25205] setattr accepts invalid identifiers
In-Reply-To: <1442861960.51.0.201067879836.issue25205@psf.upfronthosting.co.za>
Message-ID: <1442957568.17.0.32200077735.issue25205@psf.upfronthosting.co.za>


Martin Panter added the comment:

Eryksun: If you mean tagging the bug report, I think we usually tag all the applicable open branches that are due for another release.

I?m not sure anything needs to be documented regarding setattr(). At best it is an implementation detail that should not be relied on, although making the implementation stricter could be a compatibility problem.

There are other places where troublesome names are allowed. One that caught my eye recently is os.sendfile(in=..., ...) is a syntax error, but you can still pass the ?in? keyword via os.sendfile(**{"in": ...}, ...).

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

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

From report at bugs.python.org  Wed Sep 23 03:07:24 2015
From: report at bugs.python.org (Martin Panter)
Date: Wed, 23 Sep 2015 01:07:24 +0000
Subject: [docs] [issue16701] Docs missing the behavior of += (in-place add)
	for lists.
In-Reply-To: <1355690474.0.0.76209480062.issue16701@psf.upfronthosting.co.za>
Message-ID: <1442970443.95.0.788827814438.issue16701@psf.upfronthosting.co.za>


Martin Panter added the comment:

Here is a patch documenting the += and *= mutable sequence operations. Please review my wording.

These operations already seem to be tested, at least on the basic mutable sequences: see /Lib/test/list_tests.py, test_array, test_collections, test_bytes (tests bytearray).

The only other places that I thought might be missing augmented assignment were for sets, but there is no problem there: <https://docs.python.org/dev/library/stdtypes.html#set.update>.

However, there are other operations that I think may be missing from this page of the documentation. But it might be better to handle those in a separate bug report. Some of this could build off the work in Issue 12067.

* Equality comparisons (mentioned for range and dict, but apparently not tuple, set, strings, etc)
* Ordering comparisons (not supported for range)
* min() and max() don?t really belong; maybe substitute with iter()

----------
keywords: +patch
nosy: +martin.panter
stage: needs patch -> patch review
versions: +Python 3.6
Added file: http://bugs.python.org/file40552/seq-inplace.patch

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

From report at bugs.python.org  Wed Sep 23 03:30:58 2015
From: report at bugs.python.org (Martin Panter)
Date: Wed, 23 Sep 2015 01:30:58 +0000
Subject: [docs] [issue16893] Generate Idle help from Doc/library/idle.rst
In-Reply-To: <1357663512.19.0.739336896498.issue16893@psf.upfronthosting.co.za>
Message-ID: <1442971858.24.0.518036288399.issue16893@psf.upfronthosting.co.za>


Martin Panter added the comment:

The tests seem to have grown a new Deprecation Warning (triggered when run with python -bWall). Looks like this may be a side effect of revision 2d808b72996d.

[160/392] test_idle
/media/disk/home/proj/python/cpython/Lib/idlelib/EditorWindow.py:88: DeprecationWarning: EditorWindow.HelpDialog is no longer used by Idle.
It will be removed in 3.6 or later.
It has been replaced by private help.HelpWindow

  helpDialog = HelpDialog()  # singleton instance, no longer used

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

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

From report at bugs.python.org  Wed Sep 23 04:40:03 2015
From: report at bugs.python.org (Martin Panter)
Date: Wed, 23 Sep 2015 02:40:03 +0000
Subject: [docs] [issue22052] Comparison operators called in reverse order
 for subclasses with no override.
In-Reply-To: <1406149410.09.0.756154064568.issue22052@psf.upfronthosting.co.za>
Message-ID: <1442976003.58.0.474172525266.issue22052@psf.upfronthosting.co.za>


Martin Panter added the comment:

Does anyone know enough about Python 2 to propose a fix? I don?t know enough about object classes versus ?instance? classes, and potential interference of the __cmp__() method. In Python 2 the order seems to depend on the class type:

(<__main__.A instance at 0x7f730d37f5f0>, <__main__.B instance at 0x7f730d37f518>)
(<__main__.B object at 0x7f730d37dc10>, <__main__.A object at 0x7f730d37d110>)

Or perhaps we should just close this now and forget about Python 2 ;)

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

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

From report at bugs.python.org  Wed Sep 23 05:00:30 2015
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 23 Sep 2015 03:00:30 +0000
Subject: [docs] [issue16893] Generate Idle help from Doc/library/idle.rst
In-Reply-To: <1357663512.19.0.739336896498.issue16893@psf.upfronthosting.co.za>
Message-ID: <20150923030026.115182.26561@psf.io>


Roundup Robot added the comment:

New changeset 26e819909891 by Terry Jan Reedy in branch '2.7':
Issue #16893: Move idlelib.EditorWindow.HelpDialog deprecation warning
https://hg.python.org/cpython/rev/26e819909891

New changeset c607004a98bf by Terry Jan Reedy in branch '3.4':
Issue #16893: Move idlelib.EditorWindow.HelpDialog deprecation warning
https://hg.python.org/cpython/rev/c607004a98bf

----------

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

From report at bugs.python.org  Wed Sep 23 05:19:28 2015
From: report at bugs.python.org (Terry J. Reedy)
Date: Wed, 23 Sep 2015 03:19:28 +0000
Subject: [docs] [issue16893] Generate Idle help from Doc/library/idle.rst
In-Reply-To: <1357663512.19.0.739336896498.issue16893@psf.upfronthosting.co.za>
Message-ID: <1442978368.25.0.341975302224.issue16893@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

Thank you for reporting this. My general problem is that idlelib was only informally private until PEP434 and I only started adding 'private' and 'deprecated' to the code a week ago.  So I am trying to make changes in existing versions while not breaking even unlikely uses of the current API. The specific problem is the the class init method *is* used -- to create an unused instance -- on import.

  helpDialog = HelpDialog()  # singleton instance, no longer used

The patch fixes the problem by moving the deprecation to the show method, which Idle really does not now call.

----------

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

From report at bugs.python.org  Wed Sep 23 06:10:23 2015
From: report at bugs.python.org (Terry J. Reedy)
Date: Wed, 23 Sep 2015 04:10:23 +0000
Subject: [docs] [issue16893] Generate Idle help from Doc/library/idle.rst
In-Reply-To: <1357663512.19.0.739336896498.issue16893@psf.upfronthosting.co.za>
Message-ID: <1442981423.19.0.0018101034034.issue16893@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

Through the contributions of several people, Zack's key idea, that Idle documentation should have a single source, idle.rst, has come to fruition. So I think it time to close this.  I already mentioned #25198 for improving the tkinter viewer. I also opened #25218 for revising Zack's patch and possibly using an 'idledoc' target in the release process.

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

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

From report at bugs.python.org  Wed Sep 23 07:53:38 2015
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 23 Sep 2015 05:53:38 +0000
Subject: [docs] [issue12067] Doc: remove errors about mixed-type comparisons.
In-Reply-To: <1305237573.86.0.646542413513.issue12067@psf.upfronthosting.co.za>
Message-ID: <20150923055335.16569.41613@psf.io>


Roundup Robot added the comment:

New changeset 1fc049e5ec14 by Martin Panter in branch '3.4':
Issue #12067: Rewrite Comparisons section in the language reference
https://hg.python.org/cpython/rev/1fc049e5ec14

New changeset b6698c00265b by Martin Panter in branch '3.5':
Issue #12067: Merge comparisons doc from 3.4 into 3.5
https://hg.python.org/cpython/rev/b6698c00265b

New changeset 294b8a7957e9 by Martin Panter in branch 'default':
Issue #12067: Merge comparisons doc from 3.5
https://hg.python.org/cpython/rev/294b8a7957e9

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

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

From report at bugs.python.org  Wed Sep 23 08:00:06 2015
From: report at bugs.python.org (Martin Panter)
Date: Wed, 23 Sep 2015 06:00:06 +0000
Subject: [docs] [issue12067] Doc: remove errors about mixed-type comparisons.
In-Reply-To: <1305237573.86.0.646542413513.issue12067@psf.upfronthosting.co.za>
Message-ID: <1442988006.28.0.99892229294.issue12067@psf.upfronthosting.co.za>


Martin Panter added the comment:

I committed the changes to expressions.rst for 3.4+. That still leaves the changes to test_compare.py, and possibly changes for 2.7.

Andy: In msg229721 you mentioned a potential 2.7 patch. Did you get anywhere with that? Even if it is only half finished, someone else may be able to keep working on it.

----------

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

From report at bugs.python.org  Wed Sep 23 09:02:07 2015
From: report at bugs.python.org (Mark Dickinson)
Date: Wed, 23 Sep 2015 07:02:07 +0000
Subject: [docs] [issue22052] Comparison operators called in reverse order
 for subclasses with no override.
In-Reply-To: <1406149410.09.0.756154064568.issue22052@psf.upfronthosting.co.za>
Message-ID: <1442991727.6.0.822100554615.issue22052@psf.upfronthosting.co.za>


Mark Dickinson added the comment:

For Python 2, I think the most we should do is document the behaviour somewhere; changing it in a bugfix release seems both unnecessary and potentially risky.

----------

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

From report at bugs.python.org  Wed Sep 23 09:04:05 2015
From: report at bugs.python.org (Mark Dickinson)
Date: Wed, 23 Sep 2015 07:04:05 +0000
Subject: [docs] [issue22052] Comparison operators called in reverse order
 for subclasses with no override.
In-Reply-To: <1406149410.09.0.756154064568.issue22052@psf.upfronthosting.co.za>
Message-ID: <1442991845.56.0.809441584278.issue22052@psf.upfronthosting.co.za>


Mark Dickinson added the comment:

> the most we should do is document the behaviour somewhere

And indeed, perhaps this issue counts as sufficient documentation...

----------

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

From cbpinheiro at ufmg.br  Wed Sep 23 18:50:50 2015
From: cbpinheiro at ufmg.br (Carlos Pinheiro)
Date: Wed, 23 Sep 2015 13:50:50 -0300
Subject: [docs] pygraphviz
Message-ID: <D30E1923-C58B-416C-B12B-06D96EC0B348@ufmg.br>

Dear

I am a not experienced user o Python, but  in order to run an application that requires Python,
I am trying to install some modules  in my OS X Yosimite  10.10.5.

The application requires  the following modules 
utidylib , matplotlib, levenshtein, pygraphviz , numpy, tidy , scipy, imaging , mechanize

Everything but  pygraphviz were installed smoothly.
Indeed to install pygraphviz  I first installed graphviz  using homebrew (library was placed in /usr/local/lib) 

>>   brew install  graphviz
>>  Warning: graphviz-2.38.0 already installed

To install pygraphviz i used 

>> python setup.py install --prefix=/usr/local/lib/graphviz/
 And I got the following error message,


==========
running install
sh-3.2# python setup.py install --prefix=/usr/local/lib/graphviz/
running install
Trying pkg-config
include_dirs=/usr/local/Cellar/graphviz/2.38.0/include/graphviz
library_dirs=/usr/local/Cellar/graphviz/2.38.0/lib
running build
running build_py
running egg_info
writing pygraphviz.egg-info/PKG-INFO
writing top-level names to pygraphviz.egg-info/top_level.txt
writing dependency_links to pygraphviz.egg-info/dependency_links.txt
reading manifest file 'pygraphviz.egg-info/SOURCES.txt'
reading manifest template 'MANIFEST.in'
warning: no previously-included files matching '*~' found anywhere in distribution
warning: no previously-included files matching '*.pyc' found anywhere in distribution
warning: no previously-included files matching '.svn' found anywhere in distribution
no previously-included directories found matching 'doc/build'
writing manifest file 'pygraphviz.egg-info/SOURCES.txt'
running build_ext
building 'pygraphviz._graphviz' extension
cc -fno-strict-aliasing -fno-common -dynamic -g -Os -pipe -fno-common -fno-strict-aliasing -fwrapv -DENABLE_DTRACE -DMACOSX -DNDEBUG -Wall -Wstrict-prototypes -Wshorten-64-to-32 -DNDEBUG -g -fwrapv -Os -Wall -Wstrict-prototypes -DENABLE_DTRACE -pipe -arch x86_64 -I/usr/local/Cellar/graphviz/2.38.0/include/graphviz -I/System/Library/Frameworks/Python.framework/Versions/2.7/include/python2.7 -c pygraphviz/graphviz_wrap.c -o build/temp.macosx-10.10-intel-2.7/pygraphviz/graphviz_wrap.o
pygraphviz/graphviz_wrap.c:2954:10: fatal error: 'graphviz/cgraph.h' file not found
#include "graphviz/cgraph.h"
         ^
1 error generated.
error: command 'cc' failed with exit status 1

==========

Can you help me to overcome this error?

Regards,
Carlos


From report at bugs.python.org  Wed Sep 23 20:10:41 2015
From: report at bugs.python.org (R. David Murray)
Date: Wed, 23 Sep 2015 18:10:41 +0000
Subject: [docs] [issue25205] setattr accepts invalid identifiers
In-Reply-To: <1442861960.51.0.201067879836.issue25205@psf.upfronthosting.co.za>
Message-ID: <1443031841.83.0.446173190096.issue25205@psf.upfronthosting.co.za>


R. David Murray added the comment:

I wouldn't call the sendfile case troublesome.  'in' is a keyword, so if you want to use it in function arguments, you have to pass it as a string.  Perfectly logical :)

IIRC pypy uses an optimized dictionary if there are no non-identifier keywords in the attribute __dict__.  I *think* it supports non-identifiers by falling back to a slower implementation, but I could be wrong.  I seem to remember a discussion where it was ruled that the fact that CPython's default __dict__ accepts non-identifiers is a CPython implementation detail and code should not rely on it working...but of course some code does, so we can't "fix" it :).

If I'm remembering right, and if __dict__'s permissiveness is not noted as a CPython implementation detail in the language reference, it should be, but I would expect that it is since that discussion was one of the ones that triggered the introduction such documentation notes.

But, as MvL pointed out, setattr does *not* have this restriction, even if the python implementation rejects it for default __dicts__, because an object can do anything it wants during in its __setattr__ method, and this is an important (and used in the wild!) feature of the language.

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

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

From report at bugs.python.org  Wed Sep 23 20:48:56 2015
From: report at bugs.python.org (eryksun)
Date: Wed, 23 Sep 2015 18:48:56 +0000
Subject: [docs] [issue25205] setattr accepts invalid identifiers
In-Reply-To: <1442861960.51.0.201067879836.issue25205@psf.upfronthosting.co.za>
Message-ID: <1443034136.44.0.890263561932.issue25205@psf.upfronthosting.co.za>


eryksun added the comment:

Even MvL appears to slip up when he states "some may accept non-strings as attribute names". That would be pointless in a __setattr__ method since setattr / PyObject_SetAttr reject non-string values as 'names'.

----------

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

From report at bugs.python.org  Wed Sep 23 21:49:00 2015
From: report at bugs.python.org (R. David Murray)
Date: Wed, 23 Sep 2015 19:49:00 +0000
Subject: [docs] [issue16701] Docs missing the behavior of += (in-place add)
	for lists.
In-Reply-To: <1355690474.0.0.76209480062.issue16701@psf.upfronthosting.co.za>
Message-ID: <1443037740.26.0.259092687884.issue16701@psf.upfronthosting.co.za>


R. David Murray added the comment:

Wording looks ok...except that technically it is not that 'n' is an integer, it's that 'n' can play the role of an integer (ie: it has an __index__ method).

----------

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

From report at bugs.python.org  Wed Sep 23 22:27:03 2015
From: report at bugs.python.org (R. David Murray)
Date: Wed, 23 Sep 2015 20:27:03 +0000
Subject: [docs] [issue25205] setattr accepts invalid identifiers
In-Reply-To: <1442861960.51.0.201067879836.issue25205@psf.upfronthosting.co.za>
Message-ID: <1443040023.04.0.640859374485.issue25205@psf.upfronthosting.co.za>


R. David Murray added the comment:

I did however make the same mistake without checking the docs or the behavior.  But the fact that I didn't look at it doesn't make the current documentation wrong :)

What change is it that you think would be beneficial?

----------

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

From report at bugs.python.org  Thu Sep 24 00:10:35 2015
From: report at bugs.python.org (STINNER Victor)
Date: Wed, 23 Sep 2015 22:10:35 +0000
Subject: [docs] [issue24894] iso-8859-11 missing from codecs table
In-Reply-To: <1439964625.02.0.805508700241.issue24894@psf.upfronthosting.co.za>
Message-ID: <1443046235.73.0.963044105182.issue24894@psf.upfronthosting.co.za>


STINNER Victor added the comment:

Issue24894.patch is wrong: latin is an alias to ISO 8859-1, not to ISO 8859-11.

>>> codecs.lookup('latin').name
'iso8859-1'

iso8859_11 has 3 aliases: thai, iso_8859_11, iso_8859_11_2001. You can mention iso-8859-11 and thai in the doc.

----------

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

From report at bugs.python.org  Thu Sep 24 00:29:49 2015
From: report at bugs.python.org (Prashant Tyagi)
Date: Wed, 23 Sep 2015 22:29:49 +0000
Subject: [docs] [issue24894] iso-8859-11 missing from codecs table
In-Reply-To: <1439964625.02.0.805508700241.issue24894@psf.upfronthosting.co.za>
Message-ID: <1443047389.93.0.666907650633.issue24894@psf.upfronthosting.co.za>


Prashant Tyagi added the comment:

That was mistake in previous patch,so here is new patch for the same.

----------
Added file: http://bugs.python.org/file40557/issue_24894.patch

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

From report at bugs.python.org  Thu Sep 24 03:23:51 2015
From: report at bugs.python.org (Martin Panter)
Date: Thu, 24 Sep 2015 01:23:51 +0000
Subject: [docs] [issue16701] Docs missing the behavior of += (in-place add)
	for lists.
In-Reply-To: <1355690474.0.0.76209480062.issue16701@psf.upfronthosting.co.za>
Message-ID: <1443057830.9.0.784113050659.issue16701@psf.upfronthosting.co.za>


Martin Panter added the comment:

New patch mentioning __index__()

----------
Added file: http://bugs.python.org/file40560/seq-inplace.v2.patch

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

From report at bugs.python.org  Thu Sep 24 07:40:30 2015
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 24 Sep 2015 05:40:30 +0000
Subject: [docs] [issue22820] RESTART line with no output
In-Reply-To: <1415445819.89.0.337025555913.issue22820@psf.upfronthosting.co.za>
Message-ID: <20150924054026.16599.25527@psf.io>


Roundup Robot added the comment:

New changeset e7bf0727f7df by Terry Jan Reedy in branch '2.7':
Issue #22820: Explain need for *print* when running file from Idle editor.
https://hg.python.org/cpython/rev/e7bf0727f7df

New changeset 824cb25448ab by Terry Jan Reedy in branch '3.4':
Issue #22820: Explain need for *print* when running file from Idle editor.
https://hg.python.org/cpython/rev/824cb25448ab

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

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

From report at bugs.python.org  Thu Sep 24 07:42:59 2015
From: report at bugs.python.org (Terry J. Reedy)
Date: Thu, 24 Sep 2015 05:42:59 +0000
Subject: [docs] [issue22820] RESTART line with no output
In-Reply-To: <1415445819.89.0.337025555913.issue22820@psf.upfronthosting.co.za>
Message-ID: <1443073379.6.0.0856357461928.issue22820@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

For anyone who reads the doc, the added explanation should help.

----------
assignee: docs at python -> terry.reedy
resolution:  -> fixed
stage:  -> resolved
status: open -> closed
versions: +Python 2.7, Python 3.6

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

From report at bugs.python.org  Thu Sep 24 09:05:39 2015
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 24 Sep 2015 07:05:39 +0000
Subject: [docs] [issue24894] iso-8859-11 missing from codecs table
In-Reply-To: <1439964625.02.0.805508700241.issue24894@psf.upfronthosting.co.za>
Message-ID: <20150924070536.11700.99775@psf.io>


Roundup Robot added the comment:

New changeset aa9e0dcbbcc2 by Victor Stinner in branch '3.4':
Issue #24894: Document the codec iso8859_11
https://hg.python.org/cpython/rev/aa9e0dcbbcc2

New changeset 84a918335fe5 by Victor Stinner in branch '3.5':
Merge 3.4 (codecs, issue #24894)
https://hg.python.org/cpython/rev/84a918335fe5

New changeset 97842831c635 by Victor Stinner in branch 'default':
Merge 3.5 (codecs, issue #24894)
https://hg.python.org/cpython/rev/97842831c635

New changeset ad560409c7d6 by Victor Stinner in branch '2.7':
Issue #24894: Document the codec iso8859_11
https://hg.python.org/cpython/rev/ad560409c7d6

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

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

From report at bugs.python.org  Thu Sep 24 09:07:42 2015
From: report at bugs.python.org (STINNER Victor)
Date: Thu, 24 Sep 2015 07:07:42 +0000
Subject: [docs] [issue24894] iso-8859-11 missing from codecs table
In-Reply-To: <1439964625.02.0.805508700241.issue24894@psf.upfronthosting.co.za>
Message-ID: <1443078462.7.0.709796923311.issue24894@psf.upfronthosting.co.za>


STINNER Victor added the comment:

> That was mistake in previous patch,so here is new patch for the same.

Don't be sorry, that's why we have reviews :-)


+| iso8859_11      | iso-8856-11, iso-8859-11-2001, | Thai languages                 |
+|                 | thai                           |                                |

I checked other ISO 8859 codecs: they also have an alias with the year, but it's not documented. So I prefer to not document iso-8859-11-2001 neither.

There was a typo in "iso-8856-11": it's 8859. I fixed it and pushed your change.

Thanks for your first contribution Prashant ;-)

----------

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

From report at bugs.python.org  Thu Sep 24 09:10:28 2015
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 24 Sep 2015 07:10:28 +0000
Subject: [docs] [issue21995] Idle: pseudofiles have no buffer attribute.
In-Reply-To: <1405550850.77.0.279876996055.issue21995@psf.upfronthosting.co.za>
Message-ID: <20150924071025.82664.74592@psf.io>


Roundup Robot added the comment:

New changeset ac6ade0c5927 by Terry Jan Reedy in branch '2.7':
Issue 21995: Explain some differences between IDLE and console Python.
https://hg.python.org/cpython/rev/ac6ade0c5927

New changeset ca6c9cc77c20 by Terry Jan Reedy in branch '3.4':
Issue 21995: Explain some differences between IDLE and console Python.
https://hg.python.org/cpython/rev/ca6c9cc77c20

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

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

From report at bugs.python.org  Thu Sep 24 09:11:44 2015
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 24 Sep 2015 07:11:44 +0000
Subject: [docs] [issue24894] iso-8859-11 missing from codecs table
In-Reply-To: <1439964625.02.0.805508700241.issue24894@psf.upfronthosting.co.za>
Message-ID: <1443078704.33.0.629166474011.issue24894@psf.upfronthosting.co.za>


Ezio Melotti added the comment:

Thanks Prashant for the patch and Victor for taking care of it!

----------
resolution:  -> fixed
stage: needs patch -> resolved
status: open -> closed
versions: +Python 2.7, Python 3.4

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

From report at bugs.python.org  Thu Sep 24 09:23:20 2015
From: report at bugs.python.org (Prashant Tyagi)
Date: Thu, 24 Sep 2015 07:23:20 +0000
Subject: [docs] [issue24894] iso-8859-11 missing from codecs table
In-Reply-To: <1443078462.7.0.709796923311.issue24894@psf.upfronthosting.co.za>
Message-ID: <CA+vDi+y20oJkR0GgtH70Z3k6q-RL6okS7-8jnJ8z+YaKTufy=w@mail.gmail.com>


Prashant Tyagi added the comment:

Typo error is very silly,because i am new to this developement of python
foundation .next time i will try my best.

On Thu, Sep 24, 2015 at 12:37 PM, STINNER Victor <report at bugs.python.org>
wrote:

>
> STINNER Victor added the comment:
>
> > That was mistake in previous patch,so here is new patch for the same.
>
> Don't be sorry, that's why we have reviews :-)
>
>
> +| iso8859_11      | iso-8856-11, iso-8859-11-2001, | Thai languages
>            |
> +|                 | thai                           |
>           |
>
> I checked other ISO 8859 codecs: they also have an alias with the year,
> but it's not documented. So I prefer to not document iso-8859-11-2001
> neither.
>
> There was a typo in "iso-8856-11": it's 8859. I fixed it and pushed your
> change.
>
> Thanks for your first contribution Prashant ;-)
>
> ----------
>
> _______________________________________
> Python tracker <report at bugs.python.org>
> <http://bugs.python.org/issue24894>
> _______________________________________
>

----------

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

From report at bugs.python.org  Thu Sep 24 09:24:22 2015
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 24 Sep 2015 07:24:22 +0000
Subject: [docs] [issue21995] Idle: pseudofiles have no buffer attribute.
In-Reply-To: <1405550850.77.0.279876996055.issue21995@psf.upfronthosting.co.za>
Message-ID: <1443079462.57.0.681185762606.issue21995@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

https://docs.python.org/3/library/io.html#io.TextIOBase.buffer
"""buffer

The underlying binary buffer (a BufferedIOBase instance) that TextIOBase deals with. This is not part of the TextIOBase API and may not exist in some implementations."""

It is common to replace standard streams with StringIO.

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

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

From report at bugs.python.org  Thu Sep 24 11:34:38 2015
From: report at bugs.python.org (NobilisVir)
Date: Thu, 24 Sep 2015 09:34:38 +0000
Subject: [docs] [issue25226] "suffix" attribute not documented in
 logging.TimedRotatingFileHandler
Message-ID: <1443087278.13.0.950277021973.issue25226@psf.upfronthosting.co.za>


New submission from NobilisVir:

The suffix attribute that controls the timestamp portion that gets appended to the file name is not documented (but it would be very useful to be). The documentation is here - https://docs.python.org/2/library/logging.handlers.html#timedrotatingfilehandler

I learned about this attribute from an SO answer after searching for a solution to how to control the file name (this answer - http://stackoverflow.com/a/338566/1006955).

----------
assignee: docs at python
components: Documentation
messages: 251503
nosy: NobilisVir, docs at python
priority: normal
severity: normal
status: open
title: "suffix" attribute not documented in logging.TimedRotatingFileHandler
type: enhancement
versions: Python 2.7

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

From report at bugs.python.org  Thu Sep 24 12:39:50 2015
From: report at bugs.python.org (Terry J. Reedy)
Date: Thu, 24 Sep 2015 10:39:50 +0000
Subject: [docs] [issue21995] Idle: pseudofiles have no buffer attribute.
In-Reply-To: <1405550850.77.0.279876996055.issue21995@psf.upfronthosting.co.za>
Message-ID: <1443091190.38.0.923181932406.issue21995@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

I believe this issue was derived from another were someone complained about something else being missing.  I will just look into the other two and see if they are supposed to be there.

----------

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

From report at bugs.python.org  Thu Sep 24 13:34:31 2015
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 24 Sep 2015 11:34:31 +0000
Subject: [docs] [issue25208] improvements to the asyncio documentation
In-Reply-To: <1442869187.79.0.516080462087.issue25208@psf.upfronthosting.co.za>
Message-ID: <20150924113427.82638.79738@psf.io>


Roundup Robot added the comment:

New changeset 3909d29d29fc by Andrew Svetlov in branch '3.4':
Fix #25208: Improve "Develop with asyncio" doc page.
https://hg.python.org/cpython/rev/3909d29d29fc

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

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

From report at bugs.python.org  Thu Sep 24 13:36:38 2015
From: report at bugs.python.org (Andrew Svetlov)
Date: Thu, 24 Sep 2015 11:36:38 +0000
Subject: [docs] [issue25208] improvements to the asyncio documentation
In-Reply-To: <1442869187.79.0.516080462087.issue25208@psf.upfronthosting.co.za>
Message-ID: <1443094598.1.0.786162050173.issue25208@psf.upfronthosting.co.za>


Andrew Svetlov added the comment:

Fixed. Thanks!

----------
nosy: +asvetlov
resolution:  -> fixed
stage:  -> resolved
status: open -> closed
versions: +Python 3.6

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

From report at bugs.python.org  Thu Sep 24 15:45:01 2015
From: report at bugs.python.org (R. David Murray)
Date: Thu, 24 Sep 2015 13:45:01 +0000
Subject: [docs] [issue16701] Docs missing the behavior of += (in-place add)
	for lists.
In-Reply-To: <1355690474.0.0.76209480062.issue16701@psf.upfronthosting.co.za>
Message-ID: <1443102301.26.0.713776641698.issue16701@psf.upfronthosting.co.za>


R. David Murray added the comment:

Something I missed on the first review: why did you change "the same as" to "usually the same as"?  When is it different?

----------

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

From report at bugs.python.org  Thu Sep 24 23:20:53 2015
From: report at bugs.python.org (Martin Panter)
Date: Thu, 24 Sep 2015 21:20:53 +0000
Subject: [docs] [issue16701] Docs missing the behavior of += (in-place add)
	for lists.
In-Reply-To: <1355690474.0.0.76209480062.issue16701@psf.upfronthosting.co.za>
Message-ID: <1443129653.4.0.0651421714502.issue16701@psf.upfronthosting.co.za>


Martin Panter added the comment:

The ?s += t? operation assigns the result back to s. So it could involve an extra __setattr__()/__setitem__() call, or an exception trying to modify a tuple item, etc. The extend() and slice assignment versions don?t have this extra stage.

----------

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

From report at bugs.python.org  Thu Sep 24 23:51:05 2015
From: report at bugs.python.org (R. David Murray)
Date: Thu, 24 Sep 2015 21:51:05 +0000
Subject: [docs] [issue16701] Docs missing the behavior of += (in-place add)
	for lists.
In-Reply-To: <1355690474.0.0.76209480062.issue16701@psf.upfronthosting.co.za>
Message-ID: <1443131465.75.0.793610907389.issue16701@psf.upfronthosting.co.za>


R. David Murray added the comment:

Ah, good point.  I'd say something like "for the most part" then instead of "usually", since what you describe always happens.

----------

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

From report at bugs.python.org  Fri Sep 25 22:10:38 2015
From: report at bugs.python.org (Brian O'Neill)
Date: Fri, 25 Sep 2015 20:10:38 +0000
Subject: [docs] [issue25236] str.maketrans wrong description for optional
 3rd parameter
Message-ID: <1443211838.26.0.822902603996.issue25236@psf.upfronthosting.co.za>


New submission from Brian O'Neill:

The doc says "If there is a third argument, it must be a string, whose characters will be mapped to None in the result." The characters of the optional third argument get mapped to '', of course, not to None.

----------
assignee: docs at python
components: Documentation
messages: 251603
nosy: BrianO, docs at python
priority: normal
severity: normal
status: open
title: str.maketrans wrong description for optional 3rd parameter
type: behavior
versions: Python 3.2, Python 3.3, Python 3.4, Python 3.5

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

From report at bugs.python.org  Fri Sep 25 22:14:48 2015
From: report at bugs.python.org (Brian O'Neill)
Date: Fri, 25 Sep 2015 20:14:48 +0000
Subject: [docs] [issue25236] str.maketrans wrong description for optional
 3rd parameter
In-Reply-To: <1443211838.26.0.822902603996.issue25236@psf.upfronthosting.co.za>
Message-ID: <1443212088.55.0.980422900611.issue25236@psf.upfronthosting.co.za>


Brian O'Neill added the comment:

Closed as this is a actually true of maketrans.

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

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

From report at bugs.python.org  Fri Sep 25 22:21:16 2015
From: report at bugs.python.org (Zachary Ware)
Date: Fri, 25 Sep 2015 20:21:16 +0000
Subject: [docs] [issue25236] str.maketrans wrong description for optional
 3rd parameter
In-Reply-To: <1443211838.26.0.822902603996.issue25236@psf.upfronthosting.co.za>
Message-ID: <1443212476.79.0.617900721829.issue25236@psf.upfronthosting.co.za>


Changes by Zachary Ware <zachary.ware at gmail.com>:


----------
stage:  -> resolved

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

From report at bugs.python.org  Fri Sep 25 23:21:45 2015
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 25 Sep 2015 21:21:45 +0000
Subject: [docs] [issue25175] Documentation-Tkinter Clarify module spelling
 change in Python 3 docs
In-Reply-To: <1442656864.32.0.801468754438.issue25175@psf.upfronthosting.co.za>
Message-ID: <1443216105.03.0.56708995312.issue25175@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

Martin> Normally the documentation doesn?t mention changes from Python 2

Right: forward notes in 2.7 doc, no backward notes in 3.x doc. The 2.7 doc has near the top "Note: Tkinter has been renamed to tkinter in Python 3. The 2to3 tool will automatically adapt imports when converting your sources to Python 3."  Perhaps this should be expanded to mention the other tkinter imports.

We collectively agreed that adding backward notes in 3.x docs is not needed for beginners who start with 3.x, and would actively confuse them with information most do not need. I think breaking this rule requires agreement of more than the nosy list here: at minimum, Georg Brandl and Serhiy Storchaka, but better pydev.

There are still occasional issues about removing 2.x mentions or, more likely now, revising leftover 2.x examples.  The OP is complaining about an example that was properly revised.  If a new 2.x note were added, someone might come along and remove it.

I agree with
Mark> Does this open a can of worms?
Just for tkinter, there is also "import tkFont" (2.x) versus "import tkinter.font" (3.x) and similar for other stuff in the 'tkinter' package.  Consequently, the proposed note is incomplete.

Carol> the Tkinter project does start with a capital 'T'
I am not aware of a 'Tkinter project' separate from the tkinter module in the stdlib, maintained by various people, though current mostly by Serhiy.  In any case, the Python project starts with 'P' while the python binaries start with 'p'.

The OP simply made a mistake; there is no bug in the 3.x doc.  The tkinter package (unlike idlelib) follows 3.x rules.  I think the issue should have been closed immediately as 'not a bug', and should be so closed now.

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

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

From report at bugs.python.org  Sat Sep 26 05:05:00 2015
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 26 Sep 2015 03:05:00 +0000
Subject: [docs] [issue15346] Tkinter extention modules have no documentation
In-Reply-To: <1342198047.2.0.619885102312.issue15346@psf.upfronthosting.co.za>
Message-ID: <1443236699.95.0.594322119132.issue15346@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

I opened #25237 for commondialog, messagebox, and colorchooser.

----------
dependencies: +Add doc for tkinter commondialog.Dialog and subclasses
nosy: +terry.reedy
versions: +Python 3.5, Python 3.6 -Python 2.6, Python 3.1, Python 3.2, Python 3.3

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

From orwa.diraneyya at gmail.com  Sat Sep 26 13:36:58 2015
From: orwa.diraneyya at gmail.com (Orwa D)
Date: Sat, 26 Sep 2015 15:36:58 +0400
Subject: [docs] A broken link in the documentation of the Python/C interface
Message-ID: <CAP8PTXQx2k1sCAn4ZZBvas+JyFw-Kg1NSCF4NLyBWpnK7edMpQ@mail.gmail.com>

The broken link is:

https://python-packaging-user-guide.readthedocs.org/en/latest/extensions.html

and the source documentation page is:

https://docs.python.org/2/extending/index.html#extending-index

Sorry for brevity but I don't have more time than this.

Regards,
Orwa Diraneyya
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20150926/1f49680b/attachment.html>

From berker.peksag at gmail.com  Sun Sep 27 11:10:35 2015
From: berker.peksag at gmail.com (=?UTF-8?Q?Berker_Peksa=C4=9F?=)
Date: Sun, 27 Sep 2015 12:10:35 +0300
Subject: [docs] A broken link in the documentation of the Python/C
	interface
In-Reply-To: <CAP8PTXQx2k1sCAn4ZZBvas+JyFw-Kg1NSCF4NLyBWpnK7edMpQ@mail.gmail.com>
References: <CAP8PTXQx2k1sCAn4ZZBvas+JyFw-Kg1NSCF4NLyBWpnK7edMpQ@mail.gmail.com>
Message-ID: <CAF4280L2NZ9ddkYseoMLR_6bSUo609w82C7NbwF5mJG1Vbfw3Q@mail.gmail.com>

On Sat, Sep 26, 2015 at 2:36 PM, Orwa D <orwa.diraneyya at gmail.com> wrote:
> The broken link is:
>
> https://python-packaging-user-guide.readthedocs.org/en/latest/extensions.html
>
> and the source documentation page is:
>
> https://docs.python.org/2/extending/index.html#extending-index

Hi Orba,

Thanks for the report! Fixed in https://hg.python.org/cpython/rev/6c66f88e994b

--Berker

From report at bugs.python.org  Mon Sep 28 10:05:18 2015
From: report at bugs.python.org (phelix bitcoin)
Date: Mon, 28 Sep 2015 08:05:18 +0000
Subject: [docs] [issue25255] Security of CPython Builds
Message-ID: <1443427518.11.0.403449402832.issue25255@psf.upfronthosting.co.za>


New submission from phelix bitcoin:

A description of the build and release process for CPython binaries (e.g. for Windows) would be great. Maybe I am missing something? I could not find any information other than the 14 years old PEP 101 which says: "Notify the experts that they can start building binaries." 

E.g. how is it ensured there are no backdoors in the binaries?

Background: For the Namecoin project we are currently discussing the potential necessity of reproducible builds.

----------
assignee: docs at python
components: Build, Devguide, Documentation, Windows
messages: 251753
nosy: docs at python, ezio.melotti, paul.moore, phelix bitcoin, steve.dower, tim.golden, willingc, zach.ware
priority: normal
severity: normal
status: open
title: Security of CPython Builds
type: enhancement

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

From report at bugs.python.org  Mon Sep 28 15:45:20 2015
From: report at bugs.python.org (Optimal BPM)
Date: Mon, 28 Sep 2015 13:45:20 +0000
Subject: [docs] [issue25079] Tokenize generates NL instead of NEWLINE for
	comments
In-Reply-To: <1442051359.49.0.451935650182.issue25079@psf.upfronthosting.co.za>
Message-ID: <1443447920.47.0.416368277622.issue25079@psf.upfronthosting.co.za>


Optimal BPM added the comment:

Ok, I'll work around that then. 
Thanks for your response!

----------

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

From report at bugs.python.org  Mon Sep 28 18:52:22 2015
From: report at bugs.python.org (Steve Dower)
Date: Mon, 28 Sep 2015 16:52:22 +0000
Subject: [docs] [issue25255] Security of CPython Builds
In-Reply-To: <1443427518.11.0.403449402832.issue25255@psf.upfronthosting.co.za>
Message-ID: <1443459142.6.0.414142531128.issue25255@psf.upfronthosting.co.za>


Steve Dower added the comment:

Basically through trusting the people who produce the builds.

You can also verify the hg changeset by looking at sys.version and matching it to the tagged release. If there are any differences between the tagged commit and the one used to build, there will be a "+" in the version (though honestly, there are ways to avoid showing that if someone really wants to hide it, so it isn't a guarantee).

----------

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

From report at bugs.python.org  Mon Sep 28 18:54:21 2015
From: report at bugs.python.org (Brett Cannon)
Date: Mon, 28 Sep 2015 16:54:21 +0000
Subject: [docs] [issue25255] Security of CPython Builds
In-Reply-To: <1443427518.11.0.403449402832.issue25255@psf.upfronthosting.co.za>
Message-ID: <1443459260.97.0.272007037214.issue25255@psf.upfronthosting.co.za>


Brett Cannon added the comment:

And just as an FYI, while PEP 101 was created 14 years ago, it has been updated regularly (last edit was 13 days ago): https://hg.python.org/peps/log/tip/pep-0101.txt

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

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

From report at bugs.python.org  Mon Sep 28 18:59:48 2015
From: report at bugs.python.org (Paul Moore)
Date: Mon, 28 Sep 2015 16:59:48 +0000
Subject: [docs] [issue25255] Security of CPython Builds
In-Reply-To: <1443427518.11.0.403449402832.issue25255@psf.upfronthosting.co.za>
Message-ID: <1443459588.23.0.565474237022.issue25255@psf.upfronthosting.co.za>


Paul Moore added the comment:

Also, the Windows build process is documented in PCBuild/readme.txt - see https://hg.python.org/cpython/file/tip/PCbuild/readme.txt

More generally the devguide documents how to build CPython - https://docs.python.org/devguide/setup.html#compiling

----------

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

From report at bugs.python.org  Mon Sep 28 20:53:23 2015
From: report at bugs.python.org (phelix)
Date: Mon, 28 Sep 2015 18:53:23 +0000
Subject: [docs] [issue25255] Security of CPython Builds
In-Reply-To: <1443427518.11.0.403449402832.issue25255@psf.upfronthosting.co.za>
Message-ID: <1443466403.53.0.210891042076.issue25255@psf.upfronthosting.co.za>


phelix added the comment:

@Brett: Thanks for the info, I had not noticed PEP 101 had been updated.

@Paul: Ah, I had not found PCBuild/readme.txt yet. I did look at the devguide but I got the impression it was mostly meant for debug builds.

> Basically through trusting the people who produce the builds.
I assume these builders are very experienced and well known developers (thanks btw I like Python very much). I would trust them a very long way.

But it is not their integrity that is in question. Python is so popular that there might be large monetary (and other) incentives to force builders into something. Just for Bitcoin alone probably millions of dollars.

I was only recently made aware about this from Namecoin team members (and this [1] video about reproducible builds from CCC14) but as far as I see it now there is a very valid core in their argumentation. 

Our well respected team member Joseph Bisch has looked into reproducible builds of CPython and concluded that it might a difficult thing to do with a project as large as Python [2]. But maybe there are other ways to make builds more secure? I realize it is a lot I am asking here but build security will certainly get more and more important with time. Could things be improved by getting several developers together to create a secure VM as a starting point that make reproducible builds easier?

[1] https://media.ccc.de/browse/congress/2014/31c3_-_6240_-_en_-_saal_g_-_201412271400_-_reproducible_builds_-_mike_perry_-_seth_schoen_-_hans_steiner.html#video&t=18
[2] https://forum.namecoin.info/viewtopic.php?p=15869#p15869

----------

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

From report at bugs.python.org  Mon Sep 28 21:16:50 2015
From: report at bugs.python.org (R. David Murray)
Date: Mon, 28 Sep 2015 19:16:50 +0000
Subject: [docs] [issue25255] Security of CPython Builds
In-Reply-To: <1443427518.11.0.403449402832.issue25255@psf.upfronthosting.co.za>
Message-ID: <1443467810.13.0.305332672157.issue25255@psf.upfronthosting.co.za>


R. David Murray added the comment:

Well, making the build process more automated would help us, so if someone wants to help make that kind of thing happen it will probably be well received.  The platform installer builds (OSX, Windows) are tricky things, though, and a fair amount of knowledge is unfortunately locked up (currently) in Steve and Ned's brains.  It would indeed be good to make that not so (bus factor, if nothing else), so support from additional people willing to put in effort on installer builds will (I'm assuming) be welcome. But, since anything along those lines would require additional time from Steve and Ned, it isn't obvious how best to go about it.

I haven't looked at your linked article, but there might be alternate pathways to your goal based on starting from the source and producing your own installers or embedded python installation.

----------
assignee: docs at python -> 
nosy: +ned.deily, r.david.murray

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

From report at bugs.python.org  Mon Sep 28 22:00:51 2015
From: report at bugs.python.org (Steve Dower)
Date: Mon, 28 Sep 2015 20:00:51 +0000
Subject: [docs] [issue25255] Security of CPython Builds
In-Reply-To: <1443427518.11.0.403449402832.issue25255@psf.upfronthosting.co.za>
Message-ID: <1443470451.71.0.784637813429.issue25255@psf.upfronthosting.co.za>


Steve Dower added the comment:

I do need to contribute some PEP 101 updates at some point, since the Windows build no longer resembles what is described there, but it's mostly about configuration.

* Install x, y, z
* Obtain extra externals
* Install signing certificate
* Configure non-default settings
* Check out correct repo/branch
* Run tools/msi/buildrelease.cmd
(Optional: install x, configure SSH key, run tools/msi/uploadrelease.cmd)

Since I can't release the PSF signing key or my own GPG key, there's only so automated this configuration can be. The "correct repo/branch/changeset" varies depending on the RM, and not all of the build tests are automatically verified (high chance of false positives that require manual inspection).

Probably the first thing I should do is put the extra externals (binutils, gpg, htmlhelp, redist and wix) onto svn.python.org with the others and grab them automatically. I can add checks for configuration (things like the eol extension not being enabled, for example) and the default build doesn't need a signing certificate, so that's optional too.

But the overriding point is, these things aren't required for most people, and automating them is going to be pretty restrictive. For example, I would have to automate it by detecting VS 2015 and failing if it's not there - otherwise you don't have repeatability - and that's going to prevent people using earlier or later versions of VS for their own uses. HTML Help is basically stable (a.k.a. dead), but gpg and binutils are frequently updated and locking them down is also restrictive. Also, people may want to use their own MinGW or GPG installs, while I don't want to do that, so the model I use for building would be restrictive there too.

Finally, so few people actually want to produce builds that I can do plenty of work to make it easy, and there may be major issues that are never discovered because nobody else uses it.

----------

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

From report at bugs.python.org  Mon Sep 28 22:04:41 2015
From: report at bugs.python.org (Steve Dower)
Date: Mon, 28 Sep 2015 20:04:41 +0000
Subject: [docs] [issue25255] Security of CPython Builds
In-Reply-To: <1443427518.11.0.403449402832.issue25255@psf.upfronthosting.co.za>
Message-ID: <1443470681.38.0.125675334572.issue25255@psf.upfronthosting.co.za>


Steve Dower added the comment:

Having read your link [2] above (at least briefly), it seems the aim is to compare hashes of builds from multiple people to verify that nobody maliciously modified the binaries.

That isn't going to work for Windows because we cryptographically sign the binaries. The only people who could produce bit-for-bit identical builds are those trusted by the PSF, and not independent people. So if you don't trust the PSF and implicitly the people trusted by the PSF, you can't actually do anything besides building your own version and using that.

However, the rest of the build is so automated that other personal variations will not occur. As I mentioned above, I have exactly one batch file to build the full span of releases for Windows, and I just run that. It's public and in the repo, so anyone else can also run it, they just won't get bit-for-bit identical builds because of timestamps, embedded paths, and certificates.

----------

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

From report at bugs.python.org  Mon Sep 28 23:19:20 2015
From: report at bugs.python.org (phelix)
Date: Mon, 28 Sep 2015 21:19:20 +0000
Subject: [docs] [issue25255] Security of CPython Builds
In-Reply-To: <1443427518.11.0.403449402832.issue25255@psf.upfronthosting.co.za>
Message-ID: <1443475160.02.0.508071886047.issue25255@psf.upfronthosting.co.za>


phelix added the comment:

Thank you all for your responses.

> Having read your link [2] above (at least briefly), it seems the aim is to compare hashes of builds from multiple people to verify that nobody maliciously modified the binaries.
Exactly. Also it might protect the people actually doing the builds from extortion and accusations from backdoor victims (e.g. in case of hacked build system).

> That isn't going to work for Windows because we cryptographically sign the binaries. The only people who could produce bit-for-bit identical builds are those trusted by the PSF, and not independent people. So if you don't trust the PSF and implicitly the people trusted by the PSF, you can't actually do anything besides building your own version and using that.
Joseph tried just that but ran into issues.

> However, the rest of the build is so automated that other personal variations will not occur. As I mentioned above, I have exactly one batch file to build the full span of releases for Windows, and I just run that. It's public and in the repo, so anyone else can also run it, they just won't get bit-for-bit identical builds because of timestamps, embedded paths, and certificates.
Timestamps and paths should be handled by the Gitian secure build system (cross compile).

>From my point this issue can be closed as my questions are answered. We will take another look at building reproducibly. If we run into problems I will create another issue here in the hope you can help again. :)

----------

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

From report at bugs.python.org  Mon Sep 28 23:24:34 2015
From: report at bugs.python.org (R. David Murray)
Date: Mon, 28 Sep 2015 21:24:34 +0000
Subject: [docs] [issue25255] Security of CPython Builds
In-Reply-To: <1443427518.11.0.403449402832.issue25255@psf.upfronthosting.co.za>
Message-ID: <1443475474.92.0.857692369302.issue25255@psf.upfronthosting.co.za>


Changes by R. David Murray <rdmurray at bitdance.com>:


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

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

From report at bugs.python.org  Tue Sep 29 08:43:12 2015
From: report at bugs.python.org (Terry J. Reedy)
Date: Tue, 29 Sep 2015 06:43:12 +0000
Subject: [docs] [issue21995] Idle: pseudofiles have no buffer attribute.
In-Reply-To: <1405550850.77.0.279876996055.issue21995@psf.upfronthosting.co.za>
Message-ID: <1443508992.85.0.861830934321.issue21995@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

Related #23220 has draft of part of what pushed.  I want to do more on the subject.

----------
assignee: docs at python -> terry.reedy

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

From report at bugs.python.org  Tue Sep 29 08:51:54 2015
From: report at bugs.python.org (Terry J. Reedy)
Date: Tue, 29 Sep 2015 06:51:54 +0000
Subject: [docs] [issue23220] Documents input/output effects of how IDLE runs
	user code
In-Reply-To: <1420937687.17.0.885670059147.issue23220@psf.upfronthosting.co.za>
Message-ID: <1443509514.72.0.667459337756.issue23220@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

Issue #21995 discussed same issue from cause side, as opposed to result. The new section is partly based on what I wrote above.  I am not satisfied with it yet.

New changeset ac6ade0c5927 by Terry Jan Reedy in branch '2.7':
Issue 21995: Explain some differences between IDLE and console Python.
https://hg.python.org/cpython/rev/ac6ade0c5927

New changeset ca6c9cc77c20 by Terry Jan Reedy in branch '3.4':
Issue 21995: Explain some differences between IDLE and console Python.
https://hg.python.org/cpython/rev/ca6c9cc77c20

----------
assignee: docs at python -> terry.reedy
stage: patch review -> needs patch

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

From report at bugs.python.org  Tue Sep 29 17:48:32 2015
From: report at bugs.python.org (Arnon Yaari)
Date: Tue, 29 Sep 2015 15:48:32 +0000
Subject: [docs] [issue19006] UnitTest docs should have a single list of
	assertions
In-Reply-To: <1378914335.13.0.0543263347661.issue19006@psf.upfronthosting.co.za>
Message-ID: <1443541712.6.0.0409094595451.issue19006@psf.upfronthosting.co.za>


Changes by Arnon Yaari <wiggin15 at gmail.com>:


----------
nosy: +wiggin15

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

From report at bugs.python.org  Wed Sep 30 07:19:46 2015
From: report at bugs.python.org (Shreevatsa R)
Date: Wed, 30 Sep 2015 05:19:46 +0000
Subject: [docs] [issue25275] Documentation v/s behaviour mismatch wrt
 integer literals containing non-ASCII characters
Message-ID: <1443590385.97.0.810723896221.issue25275@psf.upfronthosting.co.za>


New submission from Shreevatsa R:

Summary: This is about int(u'????') == 1234.

At https://docs.python.org/2/library/functions.html and also https://docs.python.org/3/library/functions.html the documentation for 

     class int(x=0)
     class int(x, base=10)

says (respectively):

> If x is not a number or if base is given, then x must be a string or Unicode object representing an integer literal in radix base.

> If x is not a number or if base is given, then x must be a string, bytes, or bytearray instance representing an integer literal in radix base.

If you follow the definition of "integer literal" into the reference (https://docs.python.org/2/reference/lexical_analysis.html#integers and https://docs.python.org/3/reference/lexical_analysis.html#integers respectively), the definitions ultimately involve

     nonzerodigit   ::=  "1"..."9"
     octdigit       ::=  "0"..."7"
     bindigit       ::=  "0" | "1"
     digit          ::=  "0"..."9"

So it looks like whether the behaviour of int() conforms to its documentation hinges on what "representing" means. Apparently it is some definition under which u'????' represents the integer literal 1234, but it would be great to either clarify the documentation of int() or change its behaviour.

----------
assignee: docs at python
components: Documentation, Interpreter Core, Unicode
messages: 251915
nosy: docs at python, ezio.melotti, haypo, shreevatsa
priority: normal
severity: normal
status: open
title: Documentation v/s behaviour mismatch wrt integer literals containing non-ASCII characters

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

From report at bugs.python.org  Wed Sep 30 15:16:34 2015
From: report at bugs.python.org (R. David Murray)
Date: Wed, 30 Sep 2015 13:16:34 +0000
Subject: [docs] [issue25275] Documentation v/s behaviour mismatch wrt
 integer literals containing non-ASCII characters
In-Reply-To: <1443590385.97.0.810723896221.issue25275@psf.upfronthosting.co.za>
Message-ID: <1443618994.4.0.699857306819.issue25275@psf.upfronthosting.co.za>


R. David Murray added the comment:

Apparently that documentation is simply wrong.  The actual definition of what 'int' handles is *different* from what the parser handles.  I think that difference must constitute a bug (not just a doc bug), but I'm not sure if it is something that we want to fix (changing the parser).

I think the *operational* definition of int conversion for both is the same as for isdigit in python3 (https://docs.python.org/3/library/stdtypes.html#str.isdigit).  (The python2 docs just say '8 bit strings may be locale dependent', which means the same thing but is less precise).

>>> ????
  File "<stdin>", line 1
    ????
       ^
SyntaxError: invalid character in identifier
>>> int('????')
1234
>>> '????'.isdigit()
True

The above behavior discrepancy doesn't apply to python2, since in python2 you can't use unicode in integer literals.

So, this is a bit of a mess :(.

The doc fix is simple: just replace the mention of integer literal with a link to isdigit, and fix the python2 isdigit docs to match python3's.

----------
nosy: +r.david.murray
stage:  -> needs patch
type:  -> behavior
versions: +Python 2.7, Python 3.4, Python 3.5, Python 3.6

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

From report at bugs.python.org  Wed Sep 30 15:18:15 2015
From: report at bugs.python.org (R. David Murray)
Date: Wed, 30 Sep 2015 13:18:15 +0000
Subject: [docs] [issue25275] Documentation v/s behaviour mismatch wrt
 integer literals containing non-ASCII characters
In-Reply-To: <1443590385.97.0.810723896221.issue25275@psf.upfronthosting.co.za>
Message-ID: <1443619095.86.0.786752806906.issue25275@psf.upfronthosting.co.za>


R. David Murray added the comment:

I mean, in python2 you can use unicode in python code, only in strings, as opposed to python3 where unicode is valid in identifiers (but not integer literals, obviously).

----------

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

From report at bugs.python.org  Wed Sep 30 15:18:48 2015
From: report at bugs.python.org (R. David Murray)
Date: Wed, 30 Sep 2015 13:18:48 +0000
Subject: [docs] [issue25275] Documentation v/s behaviour mismatch wrt
 integer literals containing non-ASCII characters
In-Reply-To: <1443590385.97.0.810723896221.issue25275@psf.upfronthosting.co.za>
Message-ID: <1443619128.81.0.8281287769.issue25275@psf.upfronthosting.co.za>


R. David Murray added the comment:

I mean, in python2 you can't use unicode in python code, only in strings, as opposed to python3 where unicode is valid in identifiers (but not integer literals, obviously).

----------

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

From report at bugs.python.org  Wed Sep 30 15:18:58 2015
From: report at bugs.python.org (R. David Murray)
Date: Wed, 30 Sep 2015 13:18:58 +0000
Subject: [docs] [issue25275] Documentation v/s behaviour mismatch wrt
 integer literals containing non-ASCII characters
In-Reply-To: <1443590385.97.0.810723896221.issue25275@psf.upfronthosting.co.za>
Message-ID: <1443619138.27.0.123791171207.issue25275@psf.upfronthosting.co.za>


Changes by R. David Murray <rdmurray at bitdance.com>:


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

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

From report at bugs.python.org  Wed Sep 30 22:26:47 2015
From: report at bugs.python.org (Andrej A Antonov)
Date: Wed, 30 Sep 2015 20:26:47 +0000
Subject: [docs] [issue24755] asyncio.wrap_future undocumented
In-Reply-To: <1438250618.09.0.00442439827356.issue24755@psf.upfronthosting.co.za>
Message-ID: <1443644807.13.0.33991935833.issue24755@psf.upfronthosting.co.za>


Changes by Andrej A Antonov <polymorphm at gmail.com>:


----------
nosy: +polymorphm

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

From report at bugs.python.org  Wed Sep 30 22:45:10 2015
From: report at bugs.python.org (Shreevatsa R)
Date: Wed, 30 Sep 2015 20:45:10 +0000
Subject: [docs] [issue25275] Documentation v/s behaviour mismatch wrt
 integer literals containing non-ASCII characters
In-Reply-To: <1443590385.97.0.810723896221.issue25275@psf.upfronthosting.co.za>
Message-ID: <1443645910.44.0.490510591942.issue25275@psf.upfronthosting.co.za>


Shreevatsa R added the comment:

Minor difference, but the relevant function for int() is not quite isdigit(), e.g.:

    >>> import unicodedata
    >>> s = u'\u2460'
    >>> unicodedata.name(s)
    'CIRCLED DIGIT ONE'
    >>> print s
    ?
    >>> s.isdigit()
    True
    >>> s.isdecimal()
    False
    >>> int(s)
    Traceback (most recent call last):
      File "<stdin>", line 1, in <module>
    UnicodeEncodeError: 'decimal' codec can't encode character u'\u2460' in position 0: invalid decimal Unicode string

It seems to be isdecimal(), plus if there are other digits in the string then many leading and trailing space-like characters are also allowed (e.g. 5760 OGHAM SPACE MARK or 8195 EM SPACE or 12288 IDEOGRAPHIC SPACE:

    >>> 987 == int(u'\u3000\n 987\u1680\t')
    True

----------

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

From report at bugs.python.org  Wed Sep 30 22:48:47 2015
From: report at bugs.python.org (Shreevatsa R)
Date: Wed, 30 Sep 2015 20:48:47 +0000
Subject: [docs] [issue25275] Documentation v/s behaviour mismatch wrt
 integer literals containing non-ASCII characters
In-Reply-To: <1443590385.97.0.810723896221.issue25275@psf.upfronthosting.co.za>
Message-ID: <1443646127.83.0.989131166378.issue25275@psf.upfronthosting.co.za>


Shreevatsa R added the comment:

About the mismatch: of course it's probably not a good idea to change the parser (so that simply typing ???? in Python 3 code is like typing 1234), but how about changing the behaviour of int()? Not sure whether anyone should be relying on int(u'????') being 1234, given that it is not documented as such.

----------

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

From report at bugs.python.org  Wed Sep 30 22:54:42 2015
From: report at bugs.python.org (R. David Murray)
Date: Wed, 30 Sep 2015 20:54:42 +0000
Subject: [docs] [issue25275] Documentation v/s behaviour mismatch wrt
 integer literals containing non-ASCII characters
In-Reply-To: <1443590385.97.0.810723896221.issue25275@psf.upfronthosting.co.za>
Message-ID: <1443646482.81.0.18638309334.issue25275@psf.upfronthosting.co.za>


R. David Murray added the comment:

Good catch.  Yes, it is already documented that Int ignores leading and trailing whitespace.

But, even that isn't quite correct:

>>> 'A'.isdecimal()
False
>>> int('A', 16)
10

I seem to vaguely recall a discussion somewhere in this tracker about what "should" count as digits for larger-than-decimal radii, but I don't remember the outcome.

----------

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

From report at bugs.python.org  Wed Sep 30 22:56:09 2015
From: report at bugs.python.org (R. David Murray)
Date: Wed, 30 Sep 2015 20:56:09 +0000
Subject: [docs] [issue25275] Documentation v/s behaviour mismatch wrt
 integer literals containing non-ASCII characters
In-Reply-To: <1443590385.97.0.810723896221.issue25275@psf.upfronthosting.co.za>
Message-ID: <1443646569.3.0.183483292613.issue25275@psf.upfronthosting.co.za>


R. David Murray added the comment:

No, we can't make it stop working for int, that would be a backward compatibility break.  Doing so was discussed at one point and rejected (another issue somewhere in this tracker :)

----------

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

From report at bugs.python.org  Wed Sep 30 23:17:48 2015
From: report at bugs.python.org (Guido van Rossum)
Date: Wed, 30 Sep 2015 21:17:48 +0000
Subject: [docs] [issue25284] Spec for BaseEventLoop.run_in_executor(executor,
 callback, *args) is outdated in documentation
In-Reply-To: <1443645237.96.0.144397118323.issue25284@psf.upfronthosting.co.za>
Message-ID: <1443647868.49.0.00721609103051.issue25284@psf.upfronthosting.co.za>


Guido van Rossum added the comment:

Someone please submit a patch...

----------
assignee:  -> docs at python
components: +Documentation -asyncio
keywords: +easy
nosy: +docs at python

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