From report at bugs.python.org  Sat Mar  1 10:06:39 2014
From: report at bugs.python.org (Jeong-Min Lee)
Date: Sat, 01 Mar 2014 09:06:39 +0000
Subject: [docs] [issue20814] tracemalloc example
Message-ID: <1393664799.77.0.847113430877.issue20814@psf.upfronthosting.co.za>


New submission from Jeong-Min Lee:

Running the Pretty top example (http://docs.python.org/dev/library/tracemalloc.html#pretty-top) in the tracemalloc module documentation causes a ValueError.


    Traceback (most recent call last):
      File "t.py", line 32, in <module>
        display_top(snapshot, 10)
      File "t.py", line 9, in display_top
        top_stats = snapshot.statistics(group_by)
      File "/home/falsetru/h/cpython/Lib/tracemalloc.py", line 449, in statistics
        grouped = self._group_by(key_type, cumulative)
      File "/home/falsetru/h/cpython/Lib/tracemalloc.py", line 395, in _group_by
        raise ValueError("unknown key_type: %r" % (key_type,))
    ValueError: unknown key_type: 10

The last line of the example should be:

    display_top(snapshot, limit=10)

or:

    display_top(snapshop)

----------
assignee: docs at python
components: Documentation
messages: 212493
nosy: Jeong-Min.Lee, docs at python
priority: normal
severity: normal
status: open
title: tracemalloc example
versions: Python 3.4, Python 3.5

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

From report at bugs.python.org  Sat Mar  1 10:14:51 2014
From: report at bugs.python.org (Jeong-Min Lee)
Date: Sat, 01 Mar 2014 09:14:51 +0000
Subject: [docs] [issue20814] tracemalloc example - Pretty Top
In-Reply-To: <1393664799.77.0.847113430877.issue20814@psf.upfronthosting.co.za>
Message-ID: <1393665291.26.0.620600440753.issue20814@psf.upfronthosting.co.za>


Changes by Jeong-Min Lee <falsetru at gmail.com>:


----------
title: tracemalloc example -> tracemalloc example - Pretty Top

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

From report at bugs.python.org  Sat Mar  1 10:36:30 2014
From: report at bugs.python.org (Berker Peksag)
Date: Sat, 01 Mar 2014 09:36:30 +0000
Subject: [docs] [issue20814] tracemalloc example - Pretty Top
In-Reply-To: <1393664799.77.0.847113430877.issue20814@psf.upfronthosting.co.za>
Message-ID: <1393666590.82.0.394350216787.issue20814@psf.upfronthosting.co.za>


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


----------
nosy: +haypo
versions:  -Python 3.5

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

From report at bugs.python.org  Sun Mar  2 09:46:06 2014
From: report at bugs.python.org (Peter Otten)
Date: Sun, 02 Mar 2014 08:46:06 +0000
Subject: [docs] [issue20823] Clarify copyreg.pickle() documentation
Message-ID: <1393749966.08.0.529137298895.issue20823@psf.upfronthosting.co.za>


New submission from Peter Otten:

The documentation for 

copyreg.pickle(type, function, constructor=None)

has the sentence

"TypeError will be raised if *object* is a class or *constructor* is not callable."

It's not clear to me what "object" refers to. I believe it refers to the first arg (called ob_type in 2.x) and classic classes which were handled with

def pickle(ob_type, pickle_function, constructor_ob=None):
    if type(ob_type) is _ClassType:
        raise TypeError("copy_reg is not intended for use with classes")

in 2.x If I'm right the above sentence should become.

"A TypeError will be raised if *constructor* is not callable."

in 3.x. If I'm wrong please think of way to express the intended meaning more clearly.

Another minor change: class C need not inherit from object explicitly in  3.x.

----------
assignee: docs at python
components: Documentation
messages: 212541
nosy: docs at python, peter.otten
priority: normal
severity: normal
status: open
title: Clarify copyreg.pickle() documentation
versions: Python 3.3

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

From report at bugs.python.org  Sun Mar  2 09:53:02 2014
From: report at bugs.python.org (Peter Otten)
Date: Sun, 02 Mar 2014 08:53:02 +0000
Subject: [docs] [issue20823] Clarify copyreg.pickle() documentation
In-Reply-To: <1393749966.08.0.529137298895.issue20823@psf.upfronthosting.co.za>
Message-ID: <1393750382.5.0.575534436025.issue20823@psf.upfronthosting.co.za>


Changes by Peter Otten <__peter__ at web.de>:


----------
keywords: +patch
Added file: http://bugs.python.org/file34263/copyreg.patch

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

From report at bugs.python.org  Sun Mar  2 15:39:27 2014
From: report at bugs.python.org (Chris Angelico)
Date: Sun, 02 Mar 2014 14:39:27 +0000
Subject: [docs] [issue5626] misleading comment in socket.gethostname()
	documentation
In-Reply-To: <1238515382.33.0.784525971679.issue5626@psf.upfronthosting.co.za>
Message-ID: <1393771166.95.0.888516441867.issue5626@psf.upfronthosting.co.za>


Chris Angelico added the comment:

Python doesn't currently have any sort of function for fetching all a computer's IPs, as far as I know, but if there is one (either now or in the future), it would be good to link to that from there. "Here's how to get your host name. And if you're interested, over there is how to get your IP addresses." Otherwise, removing the potentially-misleading information (this is going to return something in 127.0.0.0/8 for a lot of systems) seems the reasonable option.

----------
nosy: +Rosuav

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

From rosuav at gmail.com  Sun Mar  2 15:48:21 2014
From: rosuav at gmail.com (rosuav at gmail.com)
Date: Sun, 02 Mar 2014 14:48:21 -0000
Subject: [docs] misleading comment in socket.gethostname() documentation
	(issue 5626)
Message-ID: <20140302144821.15664.44911@psf.upfronthosting.co.za>

Looks fine to me. Per issue comment, removing the likely-unhelpful
should be fine.

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

From report at bugs.python.org  Sun Mar  2 16:23:13 2014
From: report at bugs.python.org (Chris Angelico)
Date: Sun, 02 Mar 2014 15:23:13 +0000
Subject: [docs] [issue14995] PyLong_FromString documentation should state
	that the	string must be null-terminated
In-Reply-To: <1338769973.67.0.784454345332.issue14995@psf.upfronthosting.co.za>
Message-ID: <1393773793.51.0.46225613062.issue14995@psf.upfronthosting.co.za>


Chris Angelico added the comment:

Patch doesn't apply to current Python trunk (18 months later). Do you know what version you wrote this against? The current wording is different.

----------
nosy: +Rosuav

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

From report at bugs.python.org  Sun Mar  2 20:15:00 2014
From: report at bugs.python.org (=?utf-8?q?Martin_v=2E_L=C3=B6wis?=)
Date: Sun, 02 Mar 2014 19:15:00 +0000
Subject: [docs] [issue14512] Pydocs module docs server not working on
	Windows.
In-Reply-To: <1333645625.74.0.578211515784.issue14512@psf.upfronthosting.co.za>
Message-ID: <1393787700.14.0.746683274887.issue14512@psf.upfronthosting.co.za>


Martin v. L?wis added the comment:

Nick: the menu entry currently launches tools\scripts\pydocgui.pyw, with no command line options.

----------

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

From report at bugs.python.org  Sun Mar  2 20:29:49 2014
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 02 Mar 2014 19:29:49 +0000
Subject: [docs] [issue14512] Pydocs module docs server not working on
	Windows.
In-Reply-To: <1333645625.74.0.578211515784.issue14512@psf.upfronthosting.co.za>
Message-ID: <3fcZLj1ZyNz7LkH@mail.python.org>


Roundup Robot added the comment:

New changeset de81e0fe4905 by Martin v. L?wis in branch 'default':
Issue #14512: Launch pydoc -b instead of pydocgui.pyw on Windows.
http://hg.python.org/cpython/rev/de81e0fe4905

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

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

From report at bugs.python.org  Sun Mar  2 20:34:35 2014
From: report at bugs.python.org (=?utf-8?q?Martin_v=2E_L=C3=B6wis?=)
Date: Sun, 02 Mar 2014 19:34:35 +0000
Subject: [docs] [issue14512] Pydocs module docs server not working on
	Windows.
In-Reply-To: <1333645625.74.0.578211515784.issue14512@psf.upfronthosting.co.za>
Message-ID: <1393788875.69.0.878984730063.issue14512@psf.upfronthosting.co.za>


Martin v. L?wis added the comment:

cherry-picking request in Issue20834.

I will personally not backport this to 3.3.

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

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

From report at bugs.python.org  Sun Mar  2 20:39:43 2014
From: report at bugs.python.org (=?utf-8?q?Martin_v=2E_L=C3=B6wis?=)
Date: Sun, 02 Mar 2014 19:39:43 +0000
Subject: [docs] [issue14512] Pydocs module docs server not working on
	Windows.
In-Reply-To: <1333645625.74.0.578211515784.issue14512@psf.upfronthosting.co.za>
Message-ID: <1393789183.63.0.057126686063.issue14512@psf.upfronthosting.co.za>


Martin v. L?wis added the comment:

FTR: the server itself works fine for me. I don't see an empty window, but the proper library index. Terry, if the issue persists for you even after the change to pydoc -b, please submit *another* issue.

----------

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

From francis.adelving at free.fr  Sun Mar  2 15:02:14 2014
From: francis.adelving at free.fr (Francis Adelving)
Date: Sun, 02 Mar 2014 15:02:14 +0100
Subject: [docs] No python 3.3 documentation archive
Message-ID: <531339E6.4060904@free.fr>

Hi,

All the links to Python 3.3 documentation (from 
http://docs.python.org/3/download.html)  are dead, for instance :
"The requested URL /3/archives/python-3.3.5rc2-docs-pdf-a4.zip was not found on 
this server."

Cheers

-- 
Francis Adelving



---
Ce courrier ?lectronique ne contient aucun virus ou logiciel malveillant parce que la protection avast! Antivirus est active.
http://www.avast.com


From BOHICAMAN at q.com  Sun Mar  2 21:33:00 2014
From: BOHICAMAN at q.com (Robert A. Cressman)
Date: Sun, 02 Mar 2014 13:33:00 -0700
Subject: [docs] Doc's
Message-ID: <5313957C.2000602@q.com>

Tried several times to download the Documents for Python, but keep 
getting the "Page not available" error message.

Bob Cressman
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140302/50ee9137/attachment.html>

From report at bugs.python.org  Sun Mar  2 23:50:19 2014
From: report at bugs.python.org (Hans Polak)
Date: Sun, 02 Mar 2014 22:50:19 +0000
Subject: [docs] [issue20836] Pickle Nonetype
Message-ID: <1393800619.38.0.666577692495.issue20836@psf.upfronthosting.co.za>


New submission from Hans Polak:

This simple code works, but I have two 'import pickle' lines.

The none working code has one 'import pickle' outside the class definition. This raises a Nonetype error in the pickle module, in the __del__ method. I'd like to know why and I think it's a bug, or is it?

class Login():
    users = {}
    
    def __init__(self):
        try:
            with open('user.data','rb') as f:
                import pickle
                self.users = pickle.load(f)
#                print('init: {}'.format(self.users))
        except Exception:
            #'user.data' file doesn't exist
            pass

    def __del__(self):
        try:
            with open('user.data','wb') as f:
#                print('del: {}'.format(self.users))
#                print(type(self.users))
#                print(type(f))
                import pickle
                pickle.dump(self.users, f, pickle.HIGHEST_PROTOCOL)
        except Exception as e:
            print('__del__ Shit happened: {}'.format(e))

----------
assignee: docs at python
components: Documentation
messages: 212598
nosy: Hans.Polak, docs at python
priority: normal
severity: normal
status: open
title: Pickle Nonetype
type: behavior
versions: Python 3.2

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

From report at bugs.python.org  Mon Mar  3 00:03:09 2014
From: report at bugs.python.org (R. David Murray)
Date: Sun, 02 Mar 2014 23:03:09 +0000
Subject: [docs] [issue20836] Pickle Nonetype
In-Reply-To: <1393800619.38.0.666577692495.issue20836@psf.upfronthosting.co.za>
Message-ID: <1393801389.14.0.896424908877.issue20836@psf.upfronthosting.co.za>


R. David Murray added the comment:

Before python 3.4, __del__ methods are problematic.  During interpreter shutdown various module attributes get set to None, which is probably what is triggering the error. 

It is unlikely there is a Python bug here: it is a known and documented issue that module attributes can disappear (get set to None) before __del__ methods are run, if objects are not GCed before interpreter shutdown starts.  (Pre 3.4.  In 3.4 this situation is much improved.)

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

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

From report at bugs.python.org  Mon Mar  3 00:38:20 2014
From: report at bugs.python.org (INADA Naoki)
Date: Sun, 02 Mar 2014 23:38:20 +0000
Subject: [docs] [issue20837] Ambiguity words in base64 documentation
Message-ID: <1393803500.52.0.641070246037.issue20837@psf.upfronthosting.co.za>


New submission from INADA Naoki:

http://docs.python.org/3/library/base64.html

> The modern interface supports encoding and decoding ASCII byte string objects using all three alphabets.

What "all three alphabets" means?
I think it is about *altchars*. But the sentence is too ambiguous to translate it in Japanese.

----------
assignee: docs at python
components: Documentation
messages: 212604
nosy: docs at python, naoki
priority: normal
severity: normal
status: open
title: Ambiguity words in base64 documentation
versions: Python 3.3, Python 3.4

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

From report at bugs.python.org  Mon Mar  3 01:05:30 2014
From: report at bugs.python.org (R. David Murray)
Date: Mon, 03 Mar 2014 00:05:30 +0000
Subject: [docs] [issue20837] Ambiguity words in base64 documentation
In-Reply-To: <1393803500.52.0.641070246037.issue20837@psf.upfronthosting.co.za>
Message-ID: <1393805130.52.0.0457574829094.issue20837@psf.upfronthosting.co.za>


R. David Murray added the comment:

There are three different 'base64 alphabets' defined in the standard.  The support for using them is via altchars. 'URL safe' and 'filename safe' are the two alternate alphabets defined in the standard, which you can see if you follow the link to the RFC.

A patch making this more explicit in the base64 docs themselves would almost certainly be accepted.

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

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

From report at bugs.python.org  Mon Mar  3 03:21:42 2014
From: report at bugs.python.org (INADA Naoki)
Date: Mon, 03 Mar 2014 02:21:42 +0000
Subject: [docs] [issue20837] Ambiguity words in base64 documentation
In-Reply-To: <1393803500.52.0.641070246037.issue20837@psf.upfronthosting.co.za>
Message-ID: <1393813302.67.0.885749162147.issue20837@psf.upfronthosting.co.za>


INADA Naoki added the comment:

Here's patch.

----------
keywords: +patch
Added file: http://bugs.python.org/file34272/base64.patch

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

From report at bugs.python.org  Mon Mar  3 03:36:23 2014
From: report at bugs.python.org (Christian Clauss)
Date: Mon, 03 Mar 2014 02:36:23 +0000
Subject: [docs] [issue20838] Documents disagree about release state of
	Python 3.3.5
Message-ID: <1393814183.86.0.154129689303.issue20838@psf.upfronthosting.co.za>


New submission from Christian Clauss:

http://python.org/download/releases/3.3.5 says that 3.3.5rc1 is current but

http://docs.python.org/3.3/whatsnew/changelog.html says that 3.3.5rc2 is current and

http://legacy.python.org/dev/peps/pep-0398/#id5 says that 3.3.5 should have been released two days ago.

----------
assignee: docs at python
components: Documentation
messages: 212608
nosy: Christian.Clauss, docs at python
priority: normal
severity: normal
status: open
title: Documents disagree about release state of Python 3.3.5
type: enhancement
versions: Python 3.3

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

From report at bugs.python.org  Mon Mar  3 03:40:47 2014
From: report at bugs.python.org (Christian Clauss)
Date: Mon, 03 Mar 2014 02:40:47 +0000
Subject: [docs] [issue20838] Documents disagree about release state of
	Python 3.3.5
In-Reply-To: <1393814183.86.0.154129689303.issue20838@psf.upfronthosting.co.za>
Message-ID: <1393814447.58.0.603463879696.issue20838@psf.upfronthosting.co.za>


Changes by Christian Clauss <cclauss at bluewin.ch>:


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

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

From report at bugs.python.org  Mon Mar  3 09:14:26 2014
From: report at bugs.python.org (=?utf-8?q?Martin_v=2E_L=C3=B6wis?=)
Date: Mon, 03 Mar 2014 08:14:26 +0000
Subject: [docs] [issue19861] Update What's New for Python 3.4
In-Reply-To: <1385986982.03.0.371652275474.issue19861@psf.upfronthosting.co.za>
Message-ID: <1393834465.92.0.688153769371.issue19861@psf.upfronthosting.co.za>


Martin v. L?wis added the comment:

I don't think this issue is actually release-critical. The current status of the document is fine for the release, any additions that people find can be added to bugfix releases (and online, of course).

The question also is how long this issue itself stays open. Serhiy, can you please update your original list to report which of the changes you had listed are still not documented? I suggest to close the issue when all changes from msg205005 have been dealt with.

----------
nosy: +loewis
priority: release blocker -> normal

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

From report at bugs.python.org  Mon Mar  3 10:41:29 2014
From: report at bugs.python.org (Georg Brandl)
Date: Mon, 03 Mar 2014 09:41:29 +0000
Subject: [docs] [issue20838] Documents disagree about release state of
	Python 3.3.5
In-Reply-To: <1393814183.86.0.154129689303.issue20838@psf.upfronthosting.co.za>
Message-ID: <1393839689.64.0.785578534954.issue20838@psf.upfronthosting.co.za>


Georg Brandl added the comment:

It's coming.

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

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

From report at bugs.python.org  Mon Mar  3 11:58:53 2014
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 03 Mar 2014 10:58:53 +0000
Subject: [docs] [issue20814] tracemalloc example - Pretty Top
In-Reply-To: <1393664799.77.0.847113430877.issue20814@psf.upfronthosting.co.za>
Message-ID: <3fcyyg2XNnz7LjQ@mail.python.org>


Roundup Robot added the comment:

New changeset a9058b772807 by Victor Stinner in branch 'default':
Close #20814: doc: Fix "Pretty top" example of tracemalloc
http://hg.python.org/cpython/rev/a9058b772807

----------
nosy: +python-dev
resolution:  -> fixed
stage:  -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Mon Mar  3 11:59:34 2014
From: report at bugs.python.org (STINNER Victor)
Date: Mon, 03 Mar 2014 10:59:34 +0000
Subject: [docs] [issue20814] tracemalloc example - Pretty Top
In-Reply-To: <1393664799.77.0.847113430877.issue20814@psf.upfronthosting.co.za>
Message-ID: <1393844374.28.0.659071040974.issue20814@psf.upfronthosting.co.za>


STINNER Victor added the comment:

Thank you Jeong-Min for your report, it's now fixed.

----------
resolution: fixed -> 
stage: committed/rejected -> 
status: closed -> open

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

From report at bugs.python.org  Mon Mar  3 12:33:20 2014
From: report at bugs.python.org (Nick Coghlan)
Date: Mon, 03 Mar 2014 11:33:20 +0000
Subject: [docs] [issue20842] pkgutil docs should reference glossary terms
	not PEP 302
Message-ID: <1393846400.67.0.723549613222.issue20842@psf.upfronthosting.co.za>


New submission from Nick Coghlan:

The pkgutil docs still point at PEP 302 when mentioning loaders, importers, etc. They should reference the glossary terms (:term:`loader`, etc) instead.

----------
assignee: docs at python
components: Documentation
messages: 212630
nosy: docs at python, ncoghlan
priority: normal
severity: normal
stage: needs patch
status: open
title: pkgutil docs should reference glossary terms not PEP 302
type: enhancement
versions: Python 3.4, Python 3.5

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

From report at bugs.python.org  Mon Mar  3 13:20:02 2014
From: report at bugs.python.org (Georg Brandl)
Date: Mon, 03 Mar 2014 12:20:02 +0000
Subject: [docs] [issue20814] tracemalloc example - Pretty Top
In-Reply-To: <1393664799.77.0.847113430877.issue20814@psf.upfronthosting.co.za>
Message-ID: <1393849202.66.0.0404944919081.issue20814@psf.upfronthosting.co.za>


Changes by Georg Brandl <georg at python.org>:


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

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

From report at bugs.python.org  Mon Mar  3 14:25:45 2014
From: report at bugs.python.org (Berker Peksag)
Date: Mon, 03 Mar 2014 13:25:45 +0000
Subject: [docs] [issue20814] tracemalloc example - Pretty Top
In-Reply-To: <1393664799.77.0.847113430877.issue20814@psf.upfronthosting.co.za>
Message-ID: <1393853145.95.0.483623357637.issue20814@psf.upfronthosting.co.za>


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


----------
resolution:  -> fixed
stage:  -> committed/rejected

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

From yevpod at gmail.com  Mon Mar  3 02:59:06 2014
From: yevpod at gmail.com (Yev Pod)
Date: Sun, 2 Mar 2014 20:59:06 -0500
Subject: [docs] Download pdf
Message-ID: <CAOcuTcQqw5xUuKXAhYxyae=RUL0WtBx=iqrwvhSBToHSF0KM+g@mail.gmail.com>

Hi,

Do you know why none of the downloads are available?

Thank you,

-- 
*Yev Podgayskiy*
yevpod at gmail.com
(540) 246-8310
www.yevstudios.com
http://yevpod.com/
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140302/e3c7becc/attachment.html>

From janverley at gmail.com  Mon Mar  3 10:02:12 2014
From: janverley at gmail.com (Jan Verley)
Date: Mon, 3 Mar 2014 10:02:12 +0100
Subject: [docs] Dead links for downloading the docs
Message-ID: <CAB5uqFw=bX6gX0hdKXkUr1yvtMZ9=n5C7nonS8k_nfBKCPRxXQ@mail.gmail.com>

http://docs.python.org/3/download.html ("Last updated on: Mar 02, 2014.")
links to
http://docs.python.org/3/archives/python-3.3.5rc2-docs-pdf-a4.zip
but I get
The requested URL /3/archives/python-3.3.5rc2-docs-pdf-a4.zip was not found
on this server.


Thanks!
jan
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140303/32d7911e/attachment.html>

From report at bugs.python.org  Mon Mar  3 20:21:11 2014
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 03 Mar 2014 19:21:11 +0000
Subject: [docs] [issue20501] fileinput module will read whole file into
	memory when	using fileinput.hook_encoded
In-Reply-To: <1391437653.41.0.935040025319.issue20501@psf.upfronthosting.co.za>
Message-ID: <3fdB6G39wFz7Ljy@mail.python.org>


Roundup Robot added the comment:

New changeset d37f963394aa by Serhiy Storchaka in branch '2.7':
Correct and improve comments in test_fileinput (closes #20501).
http://hg.python.org/cpython/rev/d37f963394aa

New changeset 204ef3bca9c8 by Serhiy Storchaka in branch '3.3':
Correct comments and improve failure reports in test_fileinput (closes #20501).
http://hg.python.org/cpython/rev/204ef3bca9c8

New changeset c47cc6351ce7 by Serhiy Storchaka in branch 'default':
Correct comments and improve failure reports in test_fileinput (closes #20501).
http://hg.python.org/cpython/rev/c47cc6351ce7

----------

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

From report at bugs.python.org  Mon Mar  3 20:24:04 2014
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 03 Mar 2014 19:24:04 +0000
Subject: [docs] [issue20501] fileinput module will read whole file into
	memory when	using fileinput.hook_encoded
In-Reply-To: <1391437653.41.0.935040025319.issue20501@psf.upfronthosting.co.za>
Message-ID: <1393874644.04.0.3379136743.issue20501@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

Thank you Vajrasky and Zachary.

----------

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

From report at bugs.python.org  Tue Mar  4 05:52:19 2014
From: report at bugs.python.org (Elias Zamaria)
Date: Tue, 04 Mar 2014 04:52:19 +0000
Subject: [docs] [issue19980] Improve help('non-topic') response
In-Reply-To: <1386984892.27.0.919528696836.issue19980@psf.upfronthosting.co.za>
Message-ID: <1393908739.33.0.781651665377.issue19980@psf.upfronthosting.co.za>


Elias Zamaria added the comment:

Here is a patch that addresses the empty string problem described by @BreamoreBoy. I am not sure if this is the best way to handle it but it is better than what we have now.

----------
Added file: http://bugs.python.org/file34281/empty-help-response.patch

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

From report at bugs.python.org  Tue Mar  4 16:14:46 2014
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 04 Mar 2014 15:14:46 +0000
Subject: [docs] [issue19861] Update What's New for Python 3.4
In-Reply-To: <1385986982.03.0.371652275474.issue19861@psf.upfronthosting.co.za>
Message-ID: <1393946086.21.0.222058905736.issue19861@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

David did and does a great job (many thanks to him), but surprisingly many of changes from msg205005 are still not mentioned in What's New.

Improvements and changes in modules:

aifc:  Any bytes-like objects are now accepted.

audioop:  Any bytes-like objects are now accepted.  Strings no more supported.

base64:  ascii85/base85 codecs.

codecs:  The cp1125 encoding.

collections:  New optional parameter in ChainMap.new_child().

dbm:  Support for the context management protocol.

dis:  Added the stack_effect() function.

email:  The policy keyword argument was added in email.message.Message 
constructor. The replace keyword argument was added in the set_param() 
method. 
The EmailPolicy.content_manager attribute was added 

filecmp:  Added the dircmp.DEFAULT_IGNORES  attribute.

functools:  total_ordering now supports the NotImplemented value.

glob:  Added the escape() function.

ipaddress:  Added the IPv4Address.is_global attribute.

json:  Used ``(',', ': ')`` as default in dump() and dumps() if indent is not 
None. I.e. trailing spaces no more produced by default.

logging:  An instance of a subclass of RawConfigParser is now accepted as a 
value for fname in the fileConfig() function. The verify argument was added in 
the listen() function.

multiprocessing:  Added following functions: get_all_start_methods(), 
get_context(), get_start_method(), and set_start_method(). set_executable() 
is now supported on Unix when the 'spawn' start method is used. Added the 
context parameter in Pool constructor.

operator:  Added the length_hint() function.

os:  Add O_TMPFILE constant on Linux.

plistlib:  Deprecated readPlist(), writePlist() readPlistFromBytes(), 
and writePlistToBytes() functions, the Data class.

shutil:  Added the SameFileError exception.

sunau:  Added support for 24-bit samples. Any bytes-like objects are now 
accepted.

sys:  Added the __interactivehook__ 
hook.

tarfile:  Added command-line interface.

urllib:  Added the HTTPError.headers attribute. Added the Request.full_url 
attribute and the Request.remove_header() and Request.get_full_url() methods.

venv:  Added the ``with_pip`` parameter in EnvBuilder.

wave:  Any bytes-like objects are now accepted. Added support for unseekable 
files.

zipfile:  ZIP64 extensions are enabled by default.


Deprecations:

The 'U' mode in open() for file objects, in the fileinput and zipfile modules. A couple of plistlib functions. The html argument of XMLParser() and the parser argument of iterparse() in the xml.etree.elementtree module.

----------

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

From report at bugs.python.org  Wed Mar  5 04:07:17 2014
From: report at bugs.python.org (Charles-Axel Dein)
Date: Wed, 05 Mar 2014 03:07:17 +0000
Subject: [docs] [issue20351] Add doc examples for DictReader and DictWriter
In-Reply-To: <1390414077.91.0.281809568509.issue20351@psf.upfronthosting.co.za>
Message-ID: <1393988837.38.0.877543296736.issue20351@psf.upfronthosting.co.za>


Charles-Axel Dein added the comment:

Any update?

----------

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

From report at bugs.python.org  Wed Mar  5 18:38:55 2014
From: report at bugs.python.org (Matheus Portela)
Date: Wed, 05 Mar 2014 17:38:55 +0000
Subject: [docs] [issue10415] readline.insert_text documentation incomplete
In-Reply-To: <1289718734.94.0.0887962692453.issue10415@psf.upfronthosting.co.za>
Message-ID: <1394041135.71.0.815452311379.issue10415@psf.upfronthosting.co.za>


Matheus Portela added the comment:

Apparently, the documentation was already changed to reflect the behaviour of startup_hook.

Should this issue be closed?

----------
nosy: +Matheus.Portela

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

From report at bugs.python.org  Wed Mar  5 19:41:52 2014
From: report at bugs.python.org (Berker Peksag)
Date: Wed, 05 Mar 2014 18:41:52 +0000
Subject: [docs] [issue10415] readline.insert_text documentation incomplete
In-Reply-To: <1289718734.94.0.0887962692453.issue10415@psf.upfronthosting.co.za>
Message-ID: <1394044912.07.0.884257625185.issue10415@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Documentations of insert_test and set_startup_hook functions are unchanged since 2007. See revision 9e1529bf0442 (warning, huge diff!).

----------
nosy: +berker.peksag
versions: +Python 3.3, Python 3.4 -Python 3.1, Python 3.2

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

From report at bugs.python.org  Thu Mar  6 22:29:09 2014
From: report at bugs.python.org (Fabian Kochem)
Date: Thu, 06 Mar 2014 21:29:09 +0000
Subject: [docs] [issue1398781] Example in section 5.3 "Pure Embedding"
	doesn't work.
Message-ID: <1394141349.04.0.801252817273.issue1398781@psf.upfronthosting.co.za>


Fabian Kochem added the comment:

I just fell over the PYTHONPATH='' bit aswell. So yes, this is still valid.

----------
nosy: +Fabian.Kochem

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

From report at bugs.python.org  Thu Mar  6 23:46:57 2014
From: report at bugs.python.org (Josh Rosenberg)
Date: Thu, 06 Mar 2014 22:46:57 +0000
Subject: [docs] [issue10977] Concrete object C API considered harmful to
	subclasses	of builtin types
In-Reply-To: <1295653779.62.0.836506069174.issue10977@psf.upfronthosting.co.za>
Message-ID: <1394146017.15.0.319709741391.issue10977@psf.upfronthosting.co.za>


Changes by Josh Rosenberg <shadowranger at gmail.com>:


----------
nosy: +ShadowRanger

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

From esrig-ia at esrig.com  Thu Mar  6 13:41:04 2014
From: esrig-ia at esrig.com (Bruce Esrig)
Date: Thu, 6 Mar 2014 07:41:04 -0500
Subject: [docs] Notation in 2.7 Library, Sec 5.6 Sequence Types
Message-ID: <CAGYcuDNDo9cgMLqLCPPHrivx=CaDBxhS3fGscqDz5rEVgUur2w@mail.gmail.com>

In the table explaining sequence types, the following two rows appear at
the end.

s.index(i) index of the first occurrence of *i* in *s*   s.count(i) total
number of occurrences of *i* in *s*
Conventionally, i is an index. An x is used to indicate an element.
I would suggest

s.index(x) index of the first occurrence of *x* in *s*   s.count(x) total
number of occurrences of *x* in *s*
Best wishes,

Bruce Esrig
Madison, NJ
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140306/cc53e3b2/attachment.html>

From danieloliverthomson at gmail.com  Fri Mar  7 17:59:49 2014
From: danieloliverthomson at gmail.com (Daniel Thomson)
Date: Fri, 7 Mar 2014 10:59:49 -0600
Subject: [docs] Typo or poor example on page
	docs.python.org/2/library/copy.html
Message-ID: <CACfWjvDg9bJpxLEGg_nQuW2jhopG8_SqnUTYKZj6Wx+v+o8brw@mail.gmail.com>

On http://docs.python.org/2/library/copy.html I found the following passage:


"""

Two problems often exist with deep copy operations that don't exist with
shallow copy operations:


Recursive objects (compound objects that, directly or indirectly, contain a
reference to themselves) may cause a recursive loop.

Because deep copy copies everything it may copy too much, e.g.,
administrative data structures that should be shared even between copies.

"""


I believe that last sentience should read, "... administrative data
structures that should not be shared even between copies."


If the administrative data structures should be shared even between copies,
then it is a very poor example of a problem caused by deepcopy(). It would
instead be a very good reason to use deepcopy().
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140307/aa368589/attachment.html>

From report at bugs.python.org  Fri Mar  7 23:00:54 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 07 Mar 2014 22:00:54 +0000
Subject: [docs] [issue20837] Ambiguity words in base64 documentation
In-Reply-To: <1393803500.52.0.641070246037.issue20837@psf.upfronthosting.co.za>
Message-ID: <1394229654.37.0.848865195012.issue20837@psf.upfronthosting.co.za>


?ric Araujo added the comment:

Additional edit to make the patch crystal-clear:

?using all three alphabets (normal, URL and Filesystem safe alphabet).?
? ?using all three alphabets defined in the RFC (normal, URL-safe and filesystem-safe)?

----------
nosy: +eric.araujo

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

From report at bugs.python.org  Sat Mar  8 18:54:17 2014
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 08 Mar 2014 17:54:17 +0000
Subject: [docs] [issue20837] Ambiguity words in base64 documentation
In-Reply-To: <1393803500.52.0.641070246037.issue20837@psf.upfronthosting.co.za>
Message-ID: <3fhCxj0HWsz7LjT@mail.python.org>


Roundup Robot added the comment:

New changeset 1853679c6f71 by R David Murray in branch 'default':
whatsnew: base65 encodings. (#17618)
http://hg.python.org/cpython/rev/1853679c6f71

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

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

From report at bugs.python.org  Sat Mar  8 18:56:05 2014
From: report at bugs.python.org (R. David Murray)
Date: Sat, 08 Mar 2014 17:56:05 +0000
Subject: [docs] [issue20837] Ambiguity words in base64 documentation
In-Reply-To: <1393803500.52.0.641070246037.issue20837@psf.upfronthosting.co.za>
Message-ID: <1394301365.24.0.143073756047.issue20837@psf.upfronthosting.co.za>


R. David Murray added the comment:

I had to edit that paragraph for another issue, so I fixed the wording along the lines ?ric suggested while I was at it.

Hmm.  But it still needs to be fixed in 3.3 (and 2.7, I presume) :(

----------
resolution:  -> fixed

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

From report at bugs.python.org  Sun Mar  9 10:23:59 2014
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 09 Mar 2014 09:23:59 +0000
Subject: [docs] [issue20735] Documentation: remove stringprep deprecation
	mark in docs
In-Reply-To: <1393107367.35.0.913025016095.issue20735@psf.upfronthosting.co.za>
Message-ID: <3fhcZL6x8Mz7LjS@mail.python.org>


Roundup Robot added the comment:

New changeset fadde95c134e by Georg Brandl in branch '2.7':
Closes #20735: remove erroneous deprecated marker from stringprep docs
http://hg.python.org/cpython/rev/fadde95c134e

----------

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

From report at bugs.python.org  Sun Mar  9 16:45:32 2014
From: report at bugs.python.org (R. David Murray)
Date: Sun, 09 Mar 2014 15:45:32 +0000
Subject: [docs] [issue20874] Tutorial section on starting python is out of
	date
Message-ID: <1394379932.36.0.812758095306.issue20874@psf.upfronthosting.co.za>


New submission from R. David Murray:

http://docs.python.org/dev/tutorial/interpreter.html does not talk about the fact that completion and history are now enabled by default on systems that support readline, and instead says that the command line editing features are "usually not very sophisticated".  This is no longer true.

----------
assignee: docs at python
components: Documentation
messages: 212962
nosy: docs at python, r.david.murray
priority: normal
severity: normal
stage: needs patch
status: open
title: Tutorial section on starting python is out of date
type: enhancement
versions: Python 3.4, Python 3.5

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

From nicbarros at hotmail.com  Sat Mar  8 16:10:19 2014
From: nicbarros at hotmail.com (Nicolas Barros)
Date: Sat, 8 Mar 2014 12:10:19 -0300
Subject: [docs] Error
Message-ID: <BLU0-SMTP33229316EC7D42A3343A543B48A0@phx.gbl>

Hello,

When I type a " the program suddenly closes, what should I do?

TKS

From morrie at morrie.id.au  Sun Mar  9 13:10:17 2014
From: morrie at morrie.id.au (Morrie Wyatt)
Date: Sun, 09 Mar 2014 23:10:17 +1100
Subject: [docs] Download of 3.3.5 documents
Message-ID: <531C5A29.3020606@morrie.id.au>

Hi.

There seems to be a problem with the complete document download
links. The 4 I tried, PDF A4 and HTML (both variants of each) all come
up with "not found" errors.

"The requested URL /3/archives/python-3.3.5-docs-html.zip was not found 
on this server."

http://docs.python.org/3/archives/python-3.3.5-docs-html.zip

Thanks all for your terrific work.

Best regards,
Morrie Wyatt.

From sonny.srii at gmail.com  Sun Mar  9 15:46:11 2014
From: sonny.srii at gmail.com (Sonny Valkeneers)
Date: Sun, 9 Mar 2014 15:46:11 +0100
Subject: [docs] Error downloading python docs
Message-ID: <CANbpVjEXpqo47yAHV+_e-gt0EgT8+u=EiL-y2+cWRe+3Xi_k1A@mail.gmail.com>

Hello,

I've encountered the following error whilst trying to download the docs.
(Image included as attachment.)

All links are not found on the server.

Probably nothing major, but I thought I'd let you know.

Kind regards,
Sonny
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140309/416231ce/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: python_error.png
Type: image/png
Size: 123779 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20140309/416231ce/attachment-0001.png>

From Matthias.Koehler.koe at t-online.de  Sun Mar  9 16:42:59 2014
From: Matthias.Koehler.koe at t-online.de (=?iso-8859-1?Q?Matthias_K=F6hler?=)
Date: Sun, 9 Mar 2014 16:42:59 +0100
Subject: [docs] download for 3.3.5 fails
Message-ID: <3F95054D1F6F4B67BB9B195B0A826035@KOE7LAPTOP1>

Hallo, 
 
for information:
 
the downloads on Page
http://docs.python.org/3/download.html
for version 3.3.5
fail.
 
Example:
http://docs.python.org/3/archives/python-3.3.5-docs-pdf-a4.zip
 
Best regards
Matthias K?hler :-)
 
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140309/f0dd8e5e/attachment.html>

From report at bugs.python.org  Sun Mar  9 18:42:45 2014
From: report at bugs.python.org (Kathleen Weaver)
Date: Sun, 09 Mar 2014 17:42:45 +0000
Subject: [docs] [issue20266] Bring Doc/faq/windows up to date
In-Reply-To: <1389758449.02.0.48240700444.issue20266@psf.upfronthosting.co.za>
Message-ID: <1394386965.38.0.763464552345.issue20266@psf.upfronthosting.co.za>


Kathleen Weaver added the comment:

Kathleen Weaver -- am beginning to Python but comfortable with Windows so will look at this.

----------
nosy: +kathweaver

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

From report at bugs.python.org  Sun Mar  9 19:33:53 2014
From: report at bugs.python.org (Jessica McKellar)
Date: Sun, 09 Mar 2014 18:33:53 +0000
Subject: [docs] [issue19363] Python 2.7's future_builtins.map is not
	compatible with	Python 3's map
In-Reply-To: <1382534189.14.0.63787411181.issue19363@psf.upfronthosting.co.za>
Message-ID: <1394390033.41.0.639508606154.issue19363@psf.upfronthosting.co.za>


Jessica McKellar added the comment:

Thanks for the patch, Gareth.Rees!

The patch applies cleanly and the docs build cleanly with it. I visually inspected the addition in the built HTML docs and it looks good.

=> patch review

----------
keywords: +needs review -patch
nosy: +jesstess
stage: needs patch -> patch review

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

From report at bugs.python.org  Sun Mar  9 20:01:29 2014
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 09 Mar 2014 19:01:29 +0000
Subject: [docs] [issue19363] Python 2.7's future_builtins.map is not
	compatible with	Python 3's map
In-Reply-To: <1382534189.14.0.63787411181.issue19363@psf.upfronthosting.co.za>
Message-ID: <3fhsNh6x7Bz7Ljj@mail.python.org>


Roundup Robot added the comment:

New changeset 16c5d7c289c6 by Benjamin Peterson in branch '2.7':
note that future_builtin's map is not quite like python 3's (closes #19363)
http://hg.python.org/cpython/rev/16c5d7c289c6

----------
nosy: +python-dev
resolution:  -> fixed
stage: patch review -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Sun Mar  9 20:24:09 2014
From: report at bugs.python.org (priya)
Date: Sun, 09 Mar 2014 19:24:09 +0000
Subject: [docs] [issue19953] __iadd__() doc not strictly correct
In-Reply-To: <1386792788.94.0.272007303341.issue19953@psf.upfronthosting.co.za>
Message-ID: <1394393049.08.0.180008270899.issue19953@psf.upfronthosting.co.za>


Changes by priya <priyapappachan010 at gmail.com>:


Added file: http://bugs.python.org/file34311/my.patch

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

From report at bugs.python.org  Sun Mar  9 20:42:33 2014
From: report at bugs.python.org (R. David Murray)
Date: Sun, 09 Mar 2014 19:42:33 +0000
Subject: [docs] [issue19953] __iadd__() doc not strictly correct
In-Reply-To: <1386792788.94.0.272007303341.issue19953@psf.upfronthosting.co.za>
Message-ID: <1394394153.62.0.585682758274.issue19953@psf.upfronthosting.co.za>


R. David Murray added the comment:

I wonder if it would be worth adding a sentence that says, "In certain situations, augmented assignment can result in unexpected errors (see http://docs.python.org/3/faq/programming.html#id44)."

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

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

From report at bugs.python.org  Sun Mar  9 21:35:16 2014
From: report at bugs.python.org (priya)
Date: Sun, 09 Mar 2014 20:35:16 +0000
Subject: [docs] [issue19953] __iadd__() doc not strictly correct
In-Reply-To: <1386792788.94.0.272007303341.issue19953@psf.upfronthosting.co.za>
Message-ID: <1394397316.78.0.752256116826.issue19953@psf.upfronthosting.co.za>


Changes by priya <priyapappachan010 at gmail.com>:


Added file: http://bugs.python.org/file34314/my.patch

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

From report at bugs.python.org  Sun Mar  9 21:53:27 2014
From: report at bugs.python.org (Milan Oberkirch)
Date: Sun, 09 Mar 2014 20:53:27 +0000
Subject: [docs] [issue20782] base64 module docs do not use the terms 'bytes'
	and	'string' consistently.
In-Reply-To: <1393427308.42.0.0461164572304.issue20782@psf.upfronthosting.co.za>
Message-ID: <1394398407.5.0.0446005408001.issue20782@psf.upfronthosting.co.za>


Milan Oberkirch added the comment:

changed 'bytes' and 'byte string' to `bytes-like object` and reviewed usage of 'byte' and 'string' (the letter made sense to me at some points, e.g. something like  "... altchar is a string with two or less letters ...").

----------
keywords: +patch
nosy: +zvyn
Added file: http://bugs.python.org/file34315/base64doc.diff

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

From report at bugs.python.org  Sun Mar  9 22:15:06 2014
From: report at bugs.python.org (Jill M)
Date: Sun, 09 Mar 2014 21:15:06 +0000
Subject: [docs] [issue18456] Documentation for PyDict_Update is incorrect
In-Reply-To: <1373854272.6.0.0142348360978.issue18456@psf.upfronthosting.co.za>
Message-ID: <1394399706.84.0.570113438718.issue18456@psf.upfronthosting.co.za>


Changes by Jill M <jillian.munson at gmail.com>:


----------
nosy: +Jill.M

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

From report at bugs.python.org  Sun Mar  9 23:16:40 2014
From: report at bugs.python.org (priya)
Date: Sun, 09 Mar 2014 22:16:40 +0000
Subject: [docs] [issue19953] __iadd__() doc not strictly correct
In-Reply-To: <1386792788.94.0.272007303341.issue19953@psf.upfronthosting.co.za>
Message-ID: <1394403400.35.0.721705782247.issue19953@psf.upfronthosting.co.za>


Changes by priya <priyapappachan010 at gmail.com>:


Added file: http://bugs.python.org/file34319/my.patch

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

From report at bugs.python.org  Sun Mar  9 23:52:08 2014
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 09 Mar 2014 22:52:08 +0000
Subject: [docs] [issue19953] __iadd__() doc not strictly correct
In-Reply-To: <1386792788.94.0.272007303341.issue19953@psf.upfronthosting.co.za>
Message-ID: <3fhyVv6ZYFz7Ljb@mail.python.org>


Roundup Robot added the comment:

New changeset f9cb5a44879c by R David Murray in branch '3.3':
#19953: Clarify the wording of the augmented assignment discussion.
http://hg.python.org/cpython/rev/f9cb5a44879c

New changeset 61ceb299a255 by R David Murray in branch 'default':
Merge #19953: Clarify the wording of the augmented assignment discussion.
http://hg.python.org/cpython/rev/61ceb299a255

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

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

From report at bugs.python.org  Sun Mar  9 23:57:21 2014
From: report at bugs.python.org (R. David Murray)
Date: Sun, 09 Mar 2014 22:57:21 +0000
Subject: [docs] [issue19953] __iadd__() doc not strictly correct
In-Reply-To: <1386792788.94.0.272007303341.issue19953@psf.upfronthosting.co.za>
Message-ID: <1394405841.58.0.631064017254.issue19953@psf.upfronthosting.co.za>


R. David Murray added the comment:

Thanks, Pryia.

----------
nosy:  -python-dev
resolution:  -> fixed
stage: needs patch -> committed/rejected
status: open -> closed
type:  -> enhancement

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

From report at bugs.python.org  Mon Mar 10 00:31:39 2014
From: report at bugs.python.org (M. Volz)
Date: Sun, 09 Mar 2014 23:31:39 +0000
Subject: [docs] [issue3849] FUD in documentation for urllib.urlopen()
In-Reply-To: <1221246343.23.0.128587140594.issue3849@psf.upfronthosting.co.za>
Message-ID: <1394407899.23.0.4232115515.issue3849@psf.upfronthosting.co.za>


Changes by M. Volz <marielle at gmail.com>:


----------
nosy: +mvolz

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

From report at bugs.python.org  Mon Mar 10 00:33:43 2014
From: report at bugs.python.org (M. Volz)
Date: Sun, 09 Mar 2014 23:33:43 +0000
Subject: [docs] [issue16508] include the "object" type in the lists of
	documented	types
In-Reply-To: <1353284081.12.0.684350303879.issue16508@psf.upfronthosting.co.za>
Message-ID: <1394408023.69.0.348367811786.issue16508@psf.upfronthosting.co.za>


Changes by M. Volz <marielle at gmail.com>:


----------
nosy: +mvolz

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

From report at bugs.python.org  Mon Mar 10 00:34:09 2014
From: report at bugs.python.org (M. Volz)
Date: Sun, 09 Mar 2014 23:34:09 +0000
Subject: [docs] [issue20135] FAQ need list mutation answers
In-Reply-To: <1388979444.45.0.0357103143169.issue20135@psf.upfronthosting.co.za>
Message-ID: <1394408049.5.0.776273168883.issue20135@psf.upfronthosting.co.za>


Changes by M. Volz <marielle at gmail.com>:


----------
nosy: +mvolz

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

From report at bugs.python.org  Mon Mar 10 02:35:02 2014
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 10 Mar 2014 01:35:02 +0000
Subject: [docs] [issue15204] Deprecate the 'U' open mode
In-Reply-To: <1340792991.22.0.497199331706.issue15204@psf.upfronthosting.co.za>
Message-ID: <3fj26q3r0bz7LjQ@mail.python.org>


Roundup Robot added the comment:

New changeset 2d5544afb510 by R David Murray in branch 'default':
whatsnew: 'U' mode deprecation (#15204).
http://hg.python.org/cpython/rev/2d5544afb510

----------

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

From report at bugs.python.org  Mon Mar 10 03:37:01 2014
From: report at bugs.python.org (Kathleen Weaver)
Date: Mon, 10 Mar 2014 02:37:01 +0000
Subject: [docs] [issue20265] Bring Doc/using/windows up to date
In-Reply-To: <1389757265.26.0.116885263001.issue20265@psf.upfronthosting.co.za>
Message-ID: <1394419021.92.0.482354478189.issue20265@psf.upfronthosting.co.za>


Kathleen Weaver added the comment:

I am very new to Python, but am wanting to work on Documentation.  I read through the current document and some of the revisions.

May I rewrite this section so that it is not as intimidating to the average Windows user?

I would direct users to use IDLE (Python GUI) or even Python (command line) before trying to use the Windows Systems Command Line.  

I can also add information on how to configure Windows 8, so that those items are easier to find.  I have just done that to my machine.

----------
nosy: +kathweaver

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

From report at bugs.python.org  Mon Mar 10 08:32:22 2014
From: report at bugs.python.org (Tracy Chang)
Date: Mon, 10 Mar 2014 07:32:22 +0000
Subject: [docs] [issue20090] slight ambiguity in README.txt instructions for
	building	docs
In-Reply-To: <1388243674.59.0.297728620179.issue20090@psf.upfronthosting.co.za>
Message-ID: <1394436742.33.0.770451333831.issue20090@psf.upfronthosting.co.za>


Tracy Chang added the comment:

Is this issue only to update the doc or need to update the Error message as well?  For error message, is it part of Sphinx?

----------
nosy: +tracy.chang

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

From report at bugs.python.org  Mon Mar 10 14:28:09 2014
From: report at bugs.python.org (Zachary Ware)
Date: Mon, 10 Mar 2014 13:28:09 +0000
Subject: [docs] [issue20090] slight ambiguity in README.txt instructions for
	building	docs
In-Reply-To: <1388243674.59.0.297728620179.issue20090@psf.upfronthosting.co.za>
Message-ID: <1394458089.7.0.766642730761.issue20090@psf.upfronthosting.co.za>


Zachary Ware added the comment:

For 2.7 and 3.3, the error message just needs to be fixed (s/3.0/3.x/); it lives in the sphinx-build.py script somewhere in Doc/.  For default, though, since we now rely on an installed version of Sphinx rather than a checked out version, the whole version check needs to be removed and just let Sphinx deal with version checking on its own.

----------
nosy: +zach.ware
versions: +Python 2.7, Python 3.3

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

From report at bugs.python.org  Mon Mar 10 14:38:35 2014
From: report at bugs.python.org (Zachary Ware)
Date: Mon, 10 Mar 2014 13:38:35 +0000
Subject: [docs] [issue20090] slight ambiguity in README.txt instructions for
	building	docs
In-Reply-To: <1388243674.59.0.297728620179.issue20090@psf.upfronthosting.co.za>
Message-ID: <1394458715.08.0.948474963291.issue20090@psf.upfronthosting.co.za>


Zachary Ware added the comment:

Doc/README.txt will also probably need an update, at least on default.

----------

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

From report at bugs.python.org  Mon Mar 10 15:40:31 2014
From: report at bugs.python.org (Zachary Ware)
Date: Mon, 10 Mar 2014 14:40:31 +0000
Subject: [docs] [issue20265] Bring Doc/using/windows up to date
In-Reply-To: <1389757265.26.0.116885263001.issue20265@psf.upfronthosting.co.za>
Message-ID: <1394462431.42.0.551711292187.issue20265@psf.upfronthosting.co.za>


Zachary Ware added the comment:

You can rewrite about as much you want.  The biggest restriction on that is trying to keep existing links intact, which means either avoiding renaming or removing sections, or being sure to keep a reference to the old name.

I have reservations about suggesting the "Python (command line)" Start menu entry over just using Command Prompt (since it's really just Python running inside a Command Prompt-like window with even fewer features that will disappear as soon as Python exits, which may make debugging a challenge in some cases), but I'd like to see what you have in mind before judging.

To generalize an idea that I touched on in my last message, I don't think the Python documentation should be trying to teach people how to use Windows.  We should provide links to good resources for learning particular topics that are necessary for what we need to teach on the Python side of things (such as how to set environment variables), but we shouldn't try to keep it in-line.

----------

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

From report at bugs.python.org  Mon Mar 10 16:24:58 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 10 Mar 2014 15:24:58 +0000
Subject: [docs] =?utf-8?q?=5Bissue20882=5D_Link_to_OpenHatch_=E2=80=9Cgett?=
 =?utf-8?q?ing_started=E2=80=9D_page_from_devguide?=
Message-ID: <1394465098.6.0.0841488663317.issue20882@psf.upfronthosting.co.za>


New submission from ?ric Araujo:

The OpenHatch project created this page for would-be GSoC/OPW participants: https://openhatch.org/wiki/Contributing_to_Python (it?s also useful for anyone wanting to contribute).

It contains platform-specific advice to install an IRC client and navigate using the command line, links to a Mercurial tutorial, recommends to join core-mentorship, and then defers to the devguide.

Nick Coghlan and IIRC R. David Murray suggested we link to that page from the devguide.  I think it makes sense, as we don?t want to include everything in it.

----------
assignee: docs at python
components: Documentation
keywords: easy
messages: 213038
nosy: docs at python, eric.araujo
priority: normal
severity: normal
stage: needs patch
status: open
title: Link to OpenHatch ?getting started? page from devguide
type: enhancement
versions: 3rd party

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

From report at bugs.python.org  Mon Mar 10 18:47:25 2014
From: report at bugs.python.org (M. Volz)
Date: Mon, 10 Mar 2014 17:47:25 +0000
Subject: [docs] [issue20135] FAQ need list mutation answers
In-Reply-To: <1388979444.45.0.0357103143169.issue20135@psf.upfronthosting.co.za>
Message-ID: <1394473644.95.0.572105153326.issue20135@psf.upfronthosting.co.za>


M. Volz added the comment:

I've written and attached a patch for the list mutation question. I took a little bit of a different tack on this and addressed a more general question whilst still including list mutation as an example. I know the language can get a little fussy on these sorts of things- let me know if there's anything that could be better worded. 

As for the second issue, as Ezio mentioned there's already an FAQ question regarding that- would there be any objection to just copying it into the programming section? Or should it be left where it is?

----------
Added file: http://bugs.python.org/file34336/defaultdoc_listmut.patch

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

From report at bugs.python.org  Mon Mar 10 19:21:49 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 10 Mar 2014 18:21:49 +0000
Subject: [docs] [issue20135] FAQ need list mutation answers
In-Reply-To: <1388979444.45.0.0357103143169.issue20135@psf.upfronthosting.co.za>
Message-ID: <1394475709.77.0.0579239781662.issue20135@psf.upfronthosting.co.za>


?ric Araujo added the comment:

Resources: http://nedbatchelder.com/text/names.html
           http://python.net/~mwh/hacks/objectthink.html

----------
nosy: +eric.araujo

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

From report at bugs.python.org  Mon Mar 10 19:26:10 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 10 Mar 2014 18:26:10 +0000
Subject: [docs] [issue16508] include the "object" type in the lists of
	documented	types
In-Reply-To: <1353284081.12.0.684350303879.issue16508@psf.upfronthosting.co.za>
Message-ID: <1394475970.88.0.622887029035.issue16508@psf.upfronthosting.co.za>


?ric Araujo added the comment:

I think there was another issue discussing a separation between object.__str__ and someobject.__bytes__, to make it clear which are existing methods of the object class and which are methods that one may implement in their classes.

----------

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

From report at bugs.python.org  Mon Mar 10 19:29:50 2014
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 10 Mar 2014 18:29:50 +0000
Subject: [docs] [issue20090] slight ambiguity in README.txt instructions for
	building	docs
In-Reply-To: <1388243674.59.0.297728620179.issue20090@psf.upfronthosting.co.za>
Message-ID: <3fjSdm72vjz7Ll7@mail.python.org>


Roundup Robot added the comment:

New changeset 0ae254c11921 by Georg Brandl in branch '2.7':
Closes #20090: update Doc/README and the error message in sphinx-build.py to make
http://hg.python.org/cpython/rev/0ae254c11921

----------
nosy: +python-dev
resolution:  -> fixed
stage:  -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Mon Mar 10 19:32:08 2014
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 10 Mar 2014 18:32:08 +0000
Subject: [docs] [issue20090] slight ambiguity in README.txt instructions for
	building	docs
In-Reply-To: <1388243674.59.0.297728620179.issue20090@psf.upfronthosting.co.za>
Message-ID: <3fjShR3VkRz7Lk3@mail.python.org>


Roundup Robot added the comment:

New changeset d975f50de5aa by Georg Brandl in branch '3.3':
Closes #20090: update Doc/README and the error message in sphinx-build.py to make
http://hg.python.org/cpython/rev/d975f50de5aa

New changeset 43820a4fcaba by Georg Brandl in branch 'default':
Closes #20090: update Doc/README.txt for the changes in the 3.4 branch.
http://hg.python.org/cpython/rev/43820a4fcaba

----------

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

From report at bugs.python.org  Mon Mar 10 19:32:34 2014
From: report at bugs.python.org (Georg Brandl)
Date: Mon, 10 Mar 2014 18:32:34 +0000
Subject: [docs] [issue20090] slight ambiguity in README.txt instructions for
	building	docs
In-Reply-To: <1388243674.59.0.297728620179.issue20090@psf.upfronthosting.co.za>
Message-ID: <1394476354.29.0.589863729712.issue20090@psf.upfronthosting.co.za>


Georg Brandl added the comment:

I think this should be sufficient.

----------

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

From report at bugs.python.org  Mon Mar 10 19:55:55 2014
From: report at bugs.python.org (Lita Cho)
Date: Mon, 10 Mar 2014 18:55:55 +0000
Subject: [docs] =?utf-8?q?=5Bissue20882=5D_Link_to_OpenHatch_=E2=80=9Cgett?=
 =?utf-8?q?ing_started=E2=80=9D_page_from_devguide?=
In-Reply-To: <1394465098.6.0.0841488663317.issue20882@psf.upfronthosting.co.za>
Message-ID: <1394477755.4.0.673469126071.issue20882@psf.upfronthosting.co.za>


Lita Cho added the comment:

I will go ahead and try to add the link to the page from the devguide. Thanks!

----------
nosy: +Lita.Cho

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

From report at bugs.python.org  Mon Mar 10 20:06:02 2014
From: report at bugs.python.org (Jessica McKellar)
Date: Mon, 10 Mar 2014 19:06:02 +0000
Subject: [docs] =?utf-8?q?=5Bissue20882=5D_Link_to_OpenHatch_=E2=80=9Cgett?=
 =?utf-8?q?ing_started=E2=80=9D_page_from_devguide?=
In-Reply-To: <1394465098.6.0.0841488663317.issue20882@psf.upfronthosting.co.za>
Message-ID: <1394478362.56.0.27445464859.issue20882@psf.upfronthosting.co.za>


Changes by Jessica McKellar <jesstess at mit.edu>:


----------
nosy: +jesstess

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

From report at bugs.python.org  Mon Mar 10 20:18:11 2014
From: report at bugs.python.org (R. David Murray)
Date: Mon, 10 Mar 2014 19:18:11 +0000
Subject: [docs] [issue20135] FAQ need list mutation answers
In-Reply-To: <1388979444.45.0.0357103143169.issue20135@psf.upfronthosting.co.za>
Message-ID: <1394479091.49.0.209920705881.issue20135@psf.upfronthosting.co.za>


R. David Murray added the comment:

I'm in favor of moving the FAQ answer Ezio identified to the Programming section, myself, but I'd like concurrence from at least one other committer before we do it.

----------

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

From report at bugs.python.org  Mon Mar 10 21:06:38 2014
From: report at bugs.python.org (Lita Cho)
Date: Mon, 10 Mar 2014 20:06:38 +0000
Subject: [docs] =?utf-8?q?=5Bissue20882=5D_Link_to_OpenHatch_=E2=80=9Cgett?=
 =?utf-8?q?ing_started=E2=80=9D_page_from_devguide?=
In-Reply-To: <1394465098.6.0.0841488663317.issue20882@psf.upfronthosting.co.za>
Message-ID: <1394481998.42.0.488960554556.issue20882@psf.upfronthosting.co.za>


Lita Cho added the comment:

I added a link to the OpenHatch's "Contributing to Python" page right next to the "Getting Started" link. I thought about adding it to Additional Resources, but someone on the mailing list suggested it go somewhere on the top. I also wanted to place it where it would have good exposure. That way, if people are completely new to contributing, then they find that link first.

Would like to get reviewed and feedback! Thanks!

----------
keywords: +patch
Added file: http://bugs.python.org/file34340/openhatch.patch

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

From report at bugs.python.org  Mon Mar 10 21:22:03 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 10 Mar 2014 20:22:03 +0000
Subject: [docs] =?utf-8?q?=5Bissue20882=5D_Link_to_OpenHatch_=E2=80=9Cgett?=
 =?utf-8?q?ing_started=E2=80=9D_page_from_devguide?=
In-Reply-To: <1394465098.6.0.0841488663317.issue20882@psf.upfronthosting.co.za>
Message-ID: <1394482923.05.0.555583143211.issue20882@psf.upfronthosting.co.za>


?ric Araujo added the comment:

I think it would make sense to have the link at the top of the setup.rst file instead, so that people being directly linked to that page would see the link too.

----------

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

From report at bugs.python.org  Mon Mar 10 21:35:22 2014
From: report at bugs.python.org (Lita Cho)
Date: Mon, 10 Mar 2014 20:35:22 +0000
Subject: [docs] [issue20030] unittest.TestLoader.discover return value
	incorrectly	documented.
In-Reply-To: <1387530145.58.0.951879545916.issue20030@psf.upfronthosting.co.za>
Message-ID: <1394483722.34.0.746561881889.issue20030@psf.upfronthosting.co.za>


Lita Cho added the comment:

Hello! I would like to tackle this. Does that mean the documentation needs to change such that it states that the TestSuite object is returned? It looks you can iterate over the unittest.suite.TestSuite object, as I am getting something like this:

<unittest.suite.TestSuite tests=[<unittest.suite.TestSuite tests=[<unittest.loader.ModuleImportFailure testMethod=badsyntax_3131>]>, <unittest.suite.TestSuite tests=[<unittest.loader.ModuleImportFailure testMethod=badsyntax_future10>]>, <unittest.suite.TestSuite tests=[<unittest.loader.ModuleImportFailure testMethod=badsyntax_future3>]>, <unittest.suite.TestSuite tests=[<unittest.loader.ModuleImportFailure testMethod=badsyntax_future4>]>, <unittest.suite.TestSuite tests=[<unittest.loader.ModuleImportFailure testMethod=badsyntax_future5>]>, <unittest.suite.TestSuite tests=[<unittest.loader.ModuleImportFailure testMethod=badsyntax_future6>]>, <unittest.suite.TestSuite tests=[<unittest.loader.ModuleImportFailure testMethod=badsyntax_future7>]>, <unittest.suite.TestSuite tests=[<unittest.loader.ModuleImportFailure testMethod=badsyntax_future8>]>, <unittest.suite.TestSuite tests=[<unittest.loader.ModuleImportFailure testMethod=badsyntax_future9>]>, <unittest.suite.TestSuite tests=[<unittest.loader.ModuleImportFailure testMethod=badsyntax_pep3120>]>]>

----------
nosy: +Lita.Cho

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

From report at bugs.python.org  Mon Mar 10 21:45:30 2014
From: report at bugs.python.org (Lita Cho)
Date: Mon, 10 Mar 2014 20:45:30 +0000
Subject: [docs] =?utf-8?q?=5Bissue20882=5D_Link_to_OpenHatch_=E2=80=9Cgett?=
 =?utf-8?q?ing_started=E2=80=9D_page_from_devguide?=
In-Reply-To: <1394465098.6.0.0841488663317.issue20882@psf.upfronthosting.co.za>
Message-ID: <1394484330.67.0.334229031672.issue20882@psf.upfronthosting.co.za>


Lita Cho added the comment:

Sure! I've changed it so that it is in the setup.rst. Does that work?

----------
Added file: http://bugs.python.org/file34342/openhatch_setup.patch

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

From report at bugs.python.org  Mon Mar 10 21:57:40 2014
From: report at bugs.python.org (R. David Murray)
Date: Mon, 10 Mar 2014 20:57:40 +0000
Subject: [docs] [issue20030] unittest.TestLoader.discover return value
	incorrectly	documented.
In-Reply-To: <1387530145.58.0.951879545916.issue20030@psf.upfronthosting.co.za>
Message-ID: <1394485060.88.0.446992313126.issue20030@psf.upfronthosting.co.za>


R. David Murray added the comment:

It should say that it finds all the test modules and returns a TestSuite containing them.

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

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

From report at bugs.python.org  Mon Mar 10 21:58:38 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 10 Mar 2014 20:58:38 +0000
Subject: [docs] =?utf-8?q?=5Bissue20882=5D_Link_to_OpenHatch_=E2=80=9Cgett?=
 =?utf-8?q?ing_started=E2=80=9D_page_from_devguide?=
In-Reply-To: <1394465098.6.0.0841488663317.issue20882@psf.upfronthosting.co.za>
Message-ID: <1394485118.09.0.00268957320835.issue20882@psf.upfronthosting.co.za>


Changes by ?ric Araujo <merwok at netwok.org>:


----------
assignee: docs at python -> eric.araujo
stage: needs patch -> commit review

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

From report at bugs.python.org  Mon Mar 10 22:33:13 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 10 Mar 2014 21:33:13 +0000
Subject: [docs] =?utf-8?q?=5Bissue20882=5D_Link_to_OpenHatch_=E2=80=9Cgett?=
 =?utf-8?q?ing_started=E2=80=9D_page_from_devguide?=
In-Reply-To: <1394465098.6.0.0841488663317.issue20882@psf.upfronthosting.co.za>
Message-ID: <1394487193.34.0.398042578801.issue20882@psf.upfronthosting.co.za>


?ric Araujo added the comment:

Thanks, I will change one detail and push this.

----------

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

From report at bugs.python.org  Mon Mar 10 22:34:13 2014
From: report at bugs.python.org (Lita Cho)
Date: Mon, 10 Mar 2014 21:34:13 +0000
Subject: [docs] =?utf-8?q?=5Bissue20882=5D_Link_to_OpenHatch_=E2=80=9Cgett?=
 =?utf-8?q?ing_started=E2=80=9D_page_from_devguide?=
In-Reply-To: <1394465098.6.0.0841488663317.issue20882@psf.upfronthosting.co.za>
Message-ID: <1394487253.01.0.431516245805.issue20882@psf.upfronthosting.co.za>


Lita Cho added the comment:

Thank you!!

----------

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

From report at bugs.python.org  Mon Mar 10 23:46:11 2014
From: report at bugs.python.org (Lita Cho)
Date: Mon, 10 Mar 2014 22:46:11 +0000
Subject: [docs] [issue20030] unittest.TestLoader.discover return value
	incorrectly	documented.
In-Reply-To: <1387530145.58.0.951879545916.issue20030@psf.upfronthosting.co.za>
Message-ID: <1394491571.49.0.361670427317.issue20030@psf.upfronthosting.co.za>


Lita Cho added the comment:

Hello!

I have created a patch for the new documentation. I would love it if I could get feedback. Thanks!

----------
keywords: +patch
Added file: http://bugs.python.org/file34345/unittest_doc.patch

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

From report at bugs.python.org  Tue Mar 11 01:03:52 2014
From: report at bugs.python.org (R. David Murray)
Date: Tue, 11 Mar 2014 00:03:52 +0000
Subject: [docs] [issue20030] unittest.TestLoader.discover return value
	incorrectly	documented.
In-Reply-To: <1387530145.58.0.951879545916.issue20030@psf.upfronthosting.co.za>
Message-ID: <1394496232.43.0.878992772926.issue20030@psf.upfronthosting.co.za>


R. David Murray added the comment:

'returns' should be 'return', but otherwise it looks good to me.

----------

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

From report at bugs.python.org  Tue Mar 11 02:51:16 2014
From: report at bugs.python.org (Lina Clark)
Date: Tue, 11 Mar 2014 01:51:16 +0000
Subject: [docs] [issue19627] python open built-in function - "updating" is
	not defined
In-Reply-To: <1384627981.21.0.789966534785.issue19627@psf.upfronthosting.co.za>
Message-ID: <1394502675.75.0.219132530078.issue19627@psf.upfronthosting.co.za>


Lina Clark added the comment:

I uploaded a patch to reflect reading and writing in the python 2.7 documentation for 'updating'.

----------
keywords: +patch
nosy: +linaclark
Added file: http://bugs.python.org/file34347/function_doc.patch

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

From report at bugs.python.org  Tue Mar 11 03:04:11 2014
From: report at bugs.python.org (Lita Cho)
Date: Tue, 11 Mar 2014 02:04:11 +0000
Subject: [docs] [issue20030] unittest.TestLoader.discover return value
	incorrectly	documented.
In-Reply-To: <1387530145.58.0.951879545916.issue20030@psf.upfronthosting.co.za>
Message-ID: <1394503450.86.0.243481950978.issue20030@psf.upfronthosting.co.za>


Lita Cho added the comment:

Good catch! I fixed that and loaded it in the attached patch!

----------
Added file: http://bugs.python.org/file34348/unittest_doc.patch

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

From report at bugs.python.org  Tue Mar 11 06:04:03 2014
From: report at bugs.python.org (Raymond Hettinger)
Date: Tue, 11 Mar 2014 05:04:03 +0000
Subject: [docs] [issue18456] Documentation for PyDict_Update is incorrect
In-Reply-To: <1373854272.6.0.0142348360978.issue18456@psf.upfronthosting.co.za>
Message-ID: <1394514243.86.0.758239014533.issue18456@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

Nice catch.

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

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

From report at bugs.python.org  Tue Mar 11 06:19:56 2014
From: report at bugs.python.org (Alexandre JABORSKA)
Date: Tue, 11 Mar 2014 05:19:56 +0000
Subject: [docs] [issue20889] asyncio.docs : asyncio.Condition
	acquire/release/locked	method undocumented
Message-ID: <1394515195.95.0.980364058865.issue20889@psf.upfronthosting.co.za>


New submission from Alexandre JABORSKA:

While the asyncio.Condition.acquire(), release() an locked() methods work as expected (on the underlying Lock), they are not mentioned in the documentation.

----------
assignee: docs at python
components: Documentation
messages: 213117
nosy: ajaborsk, docs at python
priority: normal
severity: normal
status: open
title: asyncio.docs : asyncio.Condition acquire/release/locked method undocumented
type: enhancement
versions: Python 3.4

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

From report at bugs.python.org  Tue Mar 11 08:09:50 2014
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 11 Mar 2014 07:09:50 +0000
Subject: [docs] [issue19861] Update What's New for Python 3.4
In-Reply-To: <1385986982.03.0.371652275474.issue19861@psf.upfronthosting.co.za>
Message-ID: <1394521790.64.0.277706895132.issue19861@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

Now almost all listed changes are documented. Great work, David!

But you perhaps forgot about changed multiprocessing.set_executable() and new urllib.error.HTTPError.headers.

----------

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

From report at bugs.python.org  Tue Mar 11 08:18:36 2014
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 11 Mar 2014 07:18:36 +0000
Subject: [docs] [issue19861] Update What's New for Python 3.4
In-Reply-To: <1385986982.03.0.371652275474.issue19861@psf.upfronthosting.co.za>
Message-ID: <1394522316.01.0.461013402885.issue19861@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

Ah, and please document backward-incompatible changes in OSError signature (issue20517).

----------

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

From report at bugs.python.org  Tue Mar 11 08:30:58 2014
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 11 Mar 2014 07:30:58 +0000
Subject: [docs] [issue20889] asyncio.docs : asyncio.Condition
	acquire/release/locked	method undocumented
In-Reply-To: <1394515195.95.0.980364058865.issue20889@psf.upfronthosting.co.za>
Message-ID: <1394523058.37.0.317015891524.issue20889@psf.upfronthosting.co.za>


STINNER Victor added the comment:

Here is a patch to document the 3 missing methods.

----------
keywords: +patch
nosy: +gvanrossum, haypo, yselivanov
Added file: http://bugs.python.org/file34351/asyncio_doc_cond.patch

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

From report at bugs.python.org  Tue Mar 11 10:24:06 2014
From: report at bugs.python.org (Till Maas)
Date: Tue, 11 Mar 2014 09:24:06 +0000
Subject: [docs] [issue13530] Docs for os.lseek neglect to mention what it
	returns
In-Reply-To: <1323055618.88.0.0662410004901.issue13530@psf.upfronthosting.co.za>
Message-ID: <1394529846.59.0.895024130334.issue13530@psf.upfronthosting.co.za>


Till Maas added the comment:

This is not fixed for Python 2.7 and 2.6.

----------
nosy: +till

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

From report at bugs.python.org  Tue Mar 11 10:29:13 2014
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 11 Mar 2014 09:29:13 +0000
Subject: [docs] [issue13530] Docs for os.lseek neglect to mention what it
	returns
In-Reply-To: <1323055618.88.0.0662410004901.issue13530@psf.upfronthosting.co.za>
Message-ID: <3fjrbX1nvRz7LkN@mail.python.org>


Roundup Robot added the comment:

New changeset 168e40af4a20 by Georg Brandl in branch '2.7':
#13530: port to 2.7 branch (document what os.lseek returns).
http://hg.python.org/cpython/rev/168e40af4a20

----------

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

From report at bugs.python.org  Tue Mar 11 12:25:31 2014
From: report at bugs.python.org (Sreepriya Chalakkal)
Date: Tue, 11 Mar 2014 11:25:31 +0000
Subject: [docs] [issue20692] Tutorial section 9.4 and FAQ: how to call a
	method on an	int
In-Reply-To: <1392850224.09.0.571764135364.issue20692@psf.upfronthosting.co.za>
Message-ID: <1394537131.8.0.310917050944.issue20692@psf.upfronthosting.co.za>


Sreepriya Chalakkal added the comment:

This is a patch that includes the faq.

----------
keywords: +patch
nosy: +sreepriya
Added file: http://bugs.python.org/file34352/doc1.patch

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

From report at bugs.python.org  Tue Mar 11 14:02:47 2014
From: report at bugs.python.org (R. David Murray)
Date: Tue, 11 Mar 2014 13:02:47 +0000
Subject: [docs] [issue19861] Update What's New for Python 3.4
In-Reply-To: <1385986982.03.0.371652275474.issue19861@psf.upfronthosting.co.za>
Message-ID: <1394542967.49.0.460702014507.issue19861@psf.upfronthosting.co.za>


R. David Murray added the comment:

I did not forget about set_executable...that method now works on unix *because* spawn is supported on unix now, so I don't see any need to document that separately.  (It didn't previously have an 'availability windows' line, so I think its docs need some improvement if it only applies to spawn, but that's a separate issue.)

HTTPError.headers I did forget about, thanks.

----------

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

From report at bugs.python.org  Tue Mar 11 14:07:09 2014
From: report at bugs.python.org (R. David Murray)
Date: Tue, 11 Mar 2014 13:07:09 +0000
Subject: [docs] [issue19861] Update What's New for Python 3.4
In-Reply-To: <1385986982.03.0.371652275474.issue19861@psf.upfronthosting.co.za>
Message-ID: <1394543229.0.0.365643455791.issue19861@psf.upfronthosting.co.za>


R. David Murray added the comment:

Not sure how I missed issue 20517, because I remember reading it.  Must have been a late night session ;)

----------

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

From report at bugs.python.org  Tue Mar 11 18:14:13 2014
From: report at bugs.python.org (Sreepriya Chalakkal)
Date: Tue, 11 Mar 2014 17:14:13 +0000
Subject: [docs] [issue20692] Tutorial section 9.4 and FAQ: how to call a
	method on an	int
In-Reply-To: <1392850224.09.0.571764135364.issue20692@psf.upfronthosting.co.za>
Message-ID: <1394558053.16.0.0111322357793.issue20692@psf.upfronthosting.co.za>


Sreepriya Chalakkal added the comment:

New patch after first review.

----------
Added file: http://bugs.python.org/file34355/doc2.patch

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

From report at bugs.python.org  Tue Mar 11 18:22:49 2014
From: report at bugs.python.org (Jim Jewett)
Date: Tue, 11 Mar 2014 17:22:49 +0000
Subject: [docs] [issue19861] Update What's New for Python 3.4
In-Reply-To: <1385986982.03.0.371652275474.issue19861@psf.upfronthosting.co.za>
Message-ID: <1394558569.76.0.766844944043.issue19861@psf.upfronthosting.co.za>


Jim Jewett added the comment:

Many people will not realize that the interactive help is affected by inspect or pydoc; it would be courteous to mention this.


(Viewing http://docs.python.org/dev/whatsnew/3.4.html#summary-release-highlights )

In the highlights (table of contents?) section, subsection "Significantly Improved Library Modules:"

"The inspect and pydoc modules are now capable of correct introspection of a much wider variety of callable objects"

-->

"The inspect and pydoc modules (and therefore interactive help) are now capable of correct introspection of a much wider variety of callable objects"

----------
nosy: +Jim.Jewett

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

From report at bugs.python.org  Tue Mar 11 18:54:15 2014
From: report at bugs.python.org (Jim Jewett)
Date: Tue, 11 Mar 2014 17:54:15 +0000
Subject: [docs] [issue19861] Update What's New for Python 3.4
In-Reply-To: <1385986982.03.0.371652275474.issue19861@psf.upfronthosting.co.za>
Message-ID: <1394560454.94.0.97064819588.issue19861@psf.upfronthosting.co.za>


Jim Jewett added the comment:

I do not think it is sufficient to mention the help change under "Other Language Changes", because the people who know to look at that level of detail (let alone that particular location) are not the ones who will be confused.

----------

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

From report at bugs.python.org  Tue Mar 11 18:58:00 2014
From: report at bugs.python.org (Jim Jewett)
Date: Tue, 11 Mar 2014 17:58:00 +0000
Subject: [docs] [issue19861] Update What's New for Python 3.4
In-Reply-To: <1385986982.03.0.371652275474.issue19861@psf.upfronthosting.co.za>
Message-ID: <1394560680.71.0.547640764874.issue19861@psf.upfronthosting.co.za>


Jim Jewett added the comment:

"(If the installation has Internet access, it is of course possible to upgrade pip to a release more recent than the bundled pip by using the bundled pip command itself once it is installed.)"

-->

"(If the installation has Internet access, it is of course possible to upgrade pip to an external installation of a release more recent than the bundled pip by using the bundled pip command itself once it is installed.)"


There may well be even better wording.  Or maybe the whole comment should be left for the ensurepip documentation.  But if the upgrade is mentioned, it would be best to warn that doing so means pip will no longer be *un*installed along with python.

----------

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

From report at bugs.python.org  Tue Mar 11 19:04:54 2014
From: report at bugs.python.org (Xavier Combelle)
Date: Tue, 11 Mar 2014 18:04:54 +0000
Subject: [docs] [issue3849] FUD in documentation for urllib.urlopen()
In-Reply-To: <1221246343.23.0.128587140594.issue3849@psf.upfronthosting.co.za>
Message-ID: <1394561094.46.0.731105981482.issue3849@psf.upfronthosting.co.za>


Changes by Xavier Combelle <xavier.combelle at gmail.com>:


----------
nosy: +xcombelle

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

From report at bugs.python.org  Tue Mar 11 19:07:05 2014
From: report at bugs.python.org (R. David Murray)
Date: Tue, 11 Mar 2014 18:07:05 +0000
Subject: [docs] [issue19861] Update What's New for Python 3.4
In-Reply-To: <1385986982.03.0.371652275474.issue19861@psf.upfronthosting.co.za>
Message-ID: <1394561225.93.0.943128603664.issue19861@psf.upfronthosting.co.za>


R. David Murray added the comment:

Add help mention to summary in 9ae1707d427a.

----------

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

From report at bugs.python.org  Tue Mar 11 19:18:39 2014
From: report at bugs.python.org (Zachary Ware)
Date: Tue, 11 Mar 2014 18:18:39 +0000
Subject: [docs] [issue19861] Update What's New for Python 3.4
In-Reply-To: <1385986982.03.0.371652275474.issue19861@psf.upfronthosting.co.za>
Message-ID: <1394561919.53.0.162292886135.issue19861@psf.upfronthosting.co.za>


Zachary Ware added the comment:

It may warrant a mention that doctest now checks method_descriptors' (C methods) __doc__ for doctests.

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

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

From report at bugs.python.org  Tue Mar 11 19:32:46 2014
From: report at bugs.python.org (priya)
Date: Tue, 11 Mar 2014 18:32:46 +0000
Subject: [docs] [issue17006] Warn users about hashing secrets?
In-Reply-To: <1358758082.76.0.415880124971.issue17006@psf.upfronthosting.co.za>
Message-ID: <1394562766.95.0.162650766492.issue17006@psf.upfronthosting.co.za>


Changes by priya <priyapappachan010 at gmail.com>:


----------
keywords: +patch
Added file: http://bugs.python.org/file34357/hashlib.patch

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

From report at bugs.python.org  Tue Mar 11 19:57:23 2014
From: report at bugs.python.org (Auke Willem Oosterhoff)
Date: Tue, 11 Mar 2014 18:57:23 +0000
Subject: [docs] [issue20892] Typo in howto/pyporting.rst
Message-ID: <1394564243.9.0.819925259163.issue20892@psf.upfronthosting.co.za>


New submission from Auke Willem Oosterhoff:

Somewere around the paragraph 'Projects to Consider'[1]:
"...level library for suppoting Python 2 &...".

Obviously this should be: "...level library for supporting Python 2 &...".

[1]:http://docs.python.org/3.4/howto/pyporting.html#projects-to-consider

----------
assignee: docs at python
components: Documentation
messages: 213162
nosy: OrangeTux, docs at python
priority: normal
severity: normal
status: open
title: Typo in howto/pyporting.rst
versions: Python 3.4

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

From report at bugs.python.org  Tue Mar 11 19:58:00 2014
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 11 Mar 2014 18:58:00 +0000
Subject: [docs] [issue19861] Update What's New for Python 3.4
In-Reply-To: <1385986982.03.0.371652275474.issue19861@psf.upfronthosting.co.za>
Message-ID: <3fk5Cp69t5z7LkJ@mail.python.org>


Roundup Robot added the comment:

New changeset 9ec36351f684 by R David Murray in branch 'default':
whatsnew: mention that upgrading PIP means it doesn't get unistalled.
http://hg.python.org/cpython/rev/9ec36351f684

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

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

From report at bugs.python.org  Tue Mar 11 20:00:06 2014
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 11 Mar 2014 19:00:06 +0000
Subject: [docs] [issue20892] Typo in howto/pyporting.rst
In-Reply-To: <1394564243.9.0.819925259163.issue20892@psf.upfronthosting.co.za>
Message-ID: <3fk5GD6Td3z7Ljl@mail.python.org>


Roundup Robot added the comment:

New changeset 2f149207d3cf by Benjamin Peterson in branch '3.3':
fix typo (closes #20892)
http://hg.python.org/cpython/rev/2f149207d3cf

New changeset e47646fca428 by Benjamin Peterson in branch 'default':
merge 3.3 (closes #20892)
http://hg.python.org/cpython/rev/e47646fca428

----------
nosy: +python-dev
resolution:  -> fixed
stage:  -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Tue Mar 11 20:13:33 2014
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 11 Mar 2014 19:13:33 +0000
Subject: [docs] [issue19861] Update What's New for Python 3.4
In-Reply-To: <1385986982.03.0.371652275474.issue19861@psf.upfronthosting.co.za>
Message-ID: <3fk5Yl5wczz7LjV@mail.python.org>


Roundup Robot added the comment:

New changeset 8520e0ff8e36 by R David Murray in branch 'default':
whatsnew: doctest finds tests in extension modules (#3158)
http://hg.python.org/cpython/rev/8520e0ff8e36

----------

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

From report at bugs.python.org  Tue Mar 11 20:46:32 2014
From: report at bugs.python.org (R. David Murray)
Date: Tue, 11 Mar 2014 19:46:32 +0000
Subject: [docs] [issue17006] Warn users about hashing secrets?
In-Reply-To: <1358758082.76.0.415880124971.issue17006@psf.upfronthosting.co.za>
Message-ID: <1394567192.28.0.460903897384.issue17006@psf.upfronthosting.co.za>


R. David Murray added the comment:

Priya: I see that there is already a 'warning' box at the top of the hashib page.  If Christian concurs, I suggest we add your note to that warning, with the link to the security considerations section as you have it, and removing the reference to the 'see also' section.  Then we move the security related 'see also' link into the new security section, with a sentence that says that it explains the weaknesses.

A note about the patch: you should wrap all lines to less than 80 characters.

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

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

From report at bugs.python.org  Tue Mar 11 22:55:01 2014
From: report at bugs.python.org (Anastasia.Filatova)
Date: Tue, 11 Mar 2014 21:55:01 +0000
Subject: [docs] [issue19060] docs: note that subprocess doesn't replace
	os.exec*
In-Reply-To: <1379748595.57.0.00736365306091.issue19060@psf.upfronthosting.co.za>
Message-ID: <1394574901.28.0.677164268859.issue19060@psf.upfronthosting.co.za>


Anastasia.Filatova added the comment:

Hello,
I've made patch which address this issue. Could you please review it?

----------
keywords: +patch
nosy: +Anastasia.Filatova
Added file: http://bugs.python.org/file34362/Issue19060.patch

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

From report at bugs.python.org  Tue Mar 11 23:47:11 2014
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 11 Mar 2014 22:47:11 +0000
Subject: [docs] [issue20030] unittest.TestLoader.discover return value
	incorrectly	documented.
In-Reply-To: <1387530145.58.0.951879545916.issue20030@psf.upfronthosting.co.za>
Message-ID: <3fkBJG34ZRz7LkV@mail.python.org>


Roundup Robot added the comment:

New changeset cc74393062f7 by R David Murray in branch '2.7':
#20030: doc that TestLoader.discover returns a TestSuite.
http://hg.python.org/cpython/rev/cc74393062f7

New changeset 71df53af61ec by R David Murray in branch '3.3':
#20030: doc that TestLoader.discover returns a TestSuite.
http://hg.python.org/cpython/rev/71df53af61ec

New changeset ecc26a050384 by R David Murray in branch 'default':
Merge #20030: doc that TestLoader.discover returns a TestSuite.
http://hg.python.org/cpython/rev/ecc26a050384

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

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

From report at bugs.python.org  Tue Mar 11 23:49:02 2014
From: report at bugs.python.org (R. David Murray)
Date: Tue, 11 Mar 2014 22:49:02 +0000
Subject: [docs] [issue20030] unittest.TestLoader.discover return value
	incorrectly	documented.
In-Reply-To: <1387530145.58.0.951879545916.issue20030@psf.upfronthosting.co.za>
Message-ID: <1394578142.12.0.743399784838.issue20030@psf.upfronthosting.co.za>


R. David Murray added the comment:

Thanks, Lita.

----------
resolution:  -> fixed
stage: needs patch -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Wed Mar 12 00:17:57 2014
From: report at bugs.python.org (R. David Murray)
Date: Tue, 11 Mar 2014 23:17:57 +0000
Subject: [docs] [issue19060] docs: note that subprocess doesn't replace
	os.exec*
In-Reply-To: <1379748595.57.0.00736365306091.issue19060@psf.upfronthosting.co.za>
Message-ID: <1394579877.92.0.0100984489774.issue19060@psf.upfronthosting.co.za>


R. David Murray added the comment:

Anastasia, thanks for the patch, but the change being suggested here is adding the note about it not replace os.exec or os.fork.  The listing of what things it does replace is already correct (it differs between python2 and python3, which is why Anatoly's list has things in it that aren't in the python3 doc).

Personally I don't think that adding the note is useful.  The list of things subprocess doesn't replace is much less well defined than what it does replace.  I think we should just list the former, as we do.

So, I prefer going with removing 'such as', and treating it as a bug if there is something in the stdlib that subprocess should (normally) be used in place of that is not included in this list.

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

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

From report at bugs.python.org  Wed Mar 12 00:19:41 2014
From: report at bugs.python.org (R. David Murray)
Date: Tue, 11 Mar 2014 23:19:41 +0000
Subject: [docs] [issue19060] docs: note that subprocess doesn't replace
	os.exec*
In-Reply-To: <1379748595.57.0.00736365306091.issue19060@psf.upfronthosting.co.za>
Message-ID: <1394579981.61.0.840806691041.issue19060@psf.upfronthosting.co.za>


R. David Murray added the comment:

Anastasia, thanks for the patch, but the change being suggested here is just the adding of the note that it does not replace os.exec or os.fork.  The listing of what things it does replace is already correct (it differs between python2 and python3, which is why Anatoly's list has things in it that aren't in the python3 doc).

Personally I don't think that adding the note is useful.  The list of things subprocess doesn't replace is much less well defined than what it does replace.  I think we should just list the former, as we do.

So, I prefer going with removing 'such as', and treating it as a bug if there is something in the stdlib that subprocess should (normally) be used in place of that is not included in this list.

----------

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

From report at bugs.python.org  Wed Mar 12 00:19:50 2014
From: report at bugs.python.org (R. David Murray)
Date: Tue, 11 Mar 2014 23:19:50 +0000
Subject: [docs] [issue19060] docs: note that subprocess doesn't replace
	os.exec*
In-Reply-To: <1379748595.57.0.00736365306091.issue19060@psf.upfronthosting.co.za>
Message-ID: <1394579990.9.0.501895680532.issue19060@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Wed Mar 12 02:49:10 2014
From: report at bugs.python.org (Jim Jewett)
Date: Wed, 12 Mar 2014 01:49:10 +0000
Subject: [docs] [issue19861] Update What's New for Python 3.4
In-Reply-To: <1385986982.03.0.371652275474.issue19861@psf.upfronthosting.co.za>
Message-ID: <1394588950.52.0.829169198034.issue19861@psf.upfronthosting.co.za>


Jim Jewett added the comment:

"wave can now write output to unssekable files. "
-->
"wave can now write output to unseekable files. "

----------

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

From report at bugs.python.org  Wed Mar 12 02:50:30 2014
From: report at bugs.python.org (Jim Jewett)
Date: Wed, 12 Mar 2014 01:50:30 +0000
Subject: [docs] [issue19861] Update What's New for Python 3.4
In-Reply-To: <1385986982.03.0.371652275474.issue19861@psf.upfronthosting.co.za>
Message-ID: <1394589029.95.0.809841742854.issue19861@psf.upfronthosting.co.za>


Jim Jewett added the comment:

Changes in the Python API:

"If you use pyvenv in a script and desire that pip not be installed, you must add --wihtout-pip to your command invocation."
-->
"If you use pyvenv in a script and desire that pip not be installed, you must add --without-pip to your command invocation."

----------

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

From report at bugs.python.org  Wed Mar 12 02:59:14 2014
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 12 Mar 2014 01:59:14 +0000
Subject: [docs] [issue19861] Update What's New for Python 3.4
In-Reply-To: <1385986982.03.0.371652275474.issue19861@psf.upfronthosting.co.za>
Message-ID: <3fkGYs5J4Yz7LjY@mail.python.org>


Roundup Robot added the comment:

New changeset 996652f3c136 by R David Murray in branch 'default':
whatsnew: spelling errors.
http://hg.python.org/cpython/rev/996652f3c136

----------

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

From report at bugs.python.org  Wed Mar 12 03:42:24 2014
From: report at bugs.python.org (Matheus Vieira Portela)
Date: Wed, 12 Mar 2014 02:42:24 +0000
Subject: [docs] [issue10415] readline.insert_text documentation incomplete
In-Reply-To: <1289718734.94.0.0887962692453.issue10415@psf.upfronthosting.co.za>
Message-ID: <1394592144.53.0.785633258894.issue10415@psf.upfronthosting.co.za>


Matheus Vieira Portela added the comment:

I could get readline.insert_text() to work, ish, without calling startup_hook. The script is attached to this message. Apparently, there is some need to call readline.redisplay() to update what's on screen.

However, I can't really understand what's happening... The script prints "Testing text" only when the input has exactly one character. Also, by calling redisplay() after insert_text(), the string is not on the command line buffer, but already printed on screen. I should take a look on the GNU Readline Library documentation to understand better how it works.

Anyway, I still think the documentation is unclear on these behaviours and should be updated.

----------
Added file: http://bugs.python.org/file34366/test_readline.py

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

From report at bugs.python.org  Wed Mar 12 03:44:07 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Wed, 12 Mar 2014 02:44:07 +0000
Subject: [docs] [issue19060] docs: note that subprocess doesn't replace
	os.exec*
In-Reply-To: <1379748595.57.0.00736365306091.issue19060@psf.upfronthosting.co.za>
Message-ID: <1394592247.16.0.959555468747.issue19060@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

I agree with David about not adding the note. Simplify "This module intends to replace several other, older modules and functions, such as:" to "This module replaces several older modules and functions:".

The 2.7 list has 'popen*', which would include 'popen', which exists in 3.x but is not in the 3.x list. The 2.7 docs mark 'popen' as deprecated and replaced by subprocess, the same as for popen2,3,4. The 3.3 docs no longer mark popen as deprecated. Did it become undeprecated? Should the 2.7 'popen*' be changed to 'popen[2-4]'?

----------

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

From report at bugs.python.org  Wed Mar 12 05:31:42 2014
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 12 Mar 2014 04:31:42 +0000
Subject: [docs] =?utf-8?q?=5Bissue20882=5D_Link_to_OpenHatch_=E2=80=9Cgett?=
 =?utf-8?q?ing_started=E2=80=9D_page_from_devguide?=
In-Reply-To: <1394465098.6.0.0841488663317.issue20882@psf.upfronthosting.co.za>
Message-ID: <3fkKxn109Wz7LjX@mail.python.org>


Roundup Robot added the comment:

New changeset 3ffbbbac0a4d by ?ric Araujo in branch 'default':
Link to OpenHatch setup guide (#20882).
http://hg.python.org/devguide/rev/3ffbbbac0a4d

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

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

From report at bugs.python.org  Wed Mar 12 05:41:38 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 12 Mar 2014 04:41:38 +0000
Subject: [docs] =?utf-8?q?=5Bissue20882=5D_Link_to_OpenHatch_=E2=80=9Cgett?=
 =?utf-8?q?ing_started=E2=80=9D_page_from_devguide?=
In-Reply-To: <1394465098.6.0.0841488663317.issue20882@psf.upfronthosting.co.za>
Message-ID: <1394599298.82.0.0400620545734.issue20882@psf.upfronthosting.co.za>


?ric Araujo added the comment:

Sorry for the delay, I was sick today.

The thing I changed: ?setup guide? is now the link text, as I think it makes more sense that ?OpenHatch? (and if one day we work more with OpenHatch, the word will be free to become another link).

Thanks for the patch!

----------
resolution:  -> fixed
stage: commit review -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Wed Mar 12 07:16:52 2014
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 12 Mar 2014 06:16:52 +0000
Subject: [docs] [issue19627] python open built-in function - "updating" is
	not defined
In-Reply-To: <1384627981.21.0.789966534785.issue19627@psf.upfronthosting.co.za>
Message-ID: <3fkNH74dckz7Ljb@mail.python.org>


Roundup Robot added the comment:

New changeset 1f823c1559bd by ?ric Araujo in branch '2.7':
Define what ?updating? means in docs for open (#19627).
http://hg.python.org/cpython/rev/1f823c1559bd

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

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

From report at bugs.python.org  Wed Mar 12 07:23:19 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 12 Mar 2014 06:23:19 +0000
Subject: [docs] [issue19627] python open built-in function - "updating" is
	not defined
In-Reply-To: <1384627981.21.0.789966534785.issue19627@psf.upfronthosting.co.za>
Message-ID: <1394605399.46.0.63405215132.issue19627@psf.upfronthosting.co.za>


?ric Araujo added the comment:

Edited slightly and committed, thank you!

----------
assignee: docs at python -> eric.araujo
resolution:  -> fixed
stage: needs patch -> committed/rejected

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

From report at bugs.python.org  Wed Mar 12 07:31:10 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 12 Mar 2014 06:31:10 +0000
Subject: [docs] [issue20135] FAQ need list mutation answers
In-Reply-To: <1388979444.45.0.0357103143169.issue20135@psf.upfronthosting.co.za>
Message-ID: <1394605870.66.0.583144092385.issue20135@psf.upfronthosting.co.za>


?ric Araujo added the comment:

I agree; if someone goes to the docs, ?Programming FAQ? looks more enticing than ?Design and History?.

----------

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

From report at bugs.python.org  Wed Mar 12 08:44:12 2014
From: report at bugs.python.org (Georg Brandl)
Date: Wed, 12 Mar 2014 07:44:12 +0000
Subject: [docs] [issue19627] python open built-in function - "updating" is
	not defined
In-Reply-To: <1384627981.21.0.789966534785.issue19627@psf.upfronthosting.co.za>
Message-ID: <1394610252.19.0.661339344661.issue19627@psf.upfronthosting.co.za>


Georg Brandl added the comment:

Can this be closed?

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

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

From report at bugs.python.org  Wed Mar 12 08:44:56 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 12 Mar 2014 07:44:56 +0000
Subject: [docs] [issue19627] python open built-in function - "updating" is
	not defined
In-Reply-To: <1384627981.21.0.789966534785.issue19627@psf.upfronthosting.co.za>
Message-ID: <1394610296.24.0.20553835785.issue19627@psf.upfronthosting.co.za>


Changes by ?ric Araujo <merwok at netwok.org>:


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

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

From report at bugs.python.org  Wed Mar 12 11:08:32 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 12 Mar 2014 10:08:32 +0000
Subject: [docs] [issue15231] update PyPI upload doc to say --no-raw passed
	to	rst2html.py
In-Reply-To: <1341110073.6.0.573832115517.issue15231@psf.upfronthosting.co.za>
Message-ID: <1394618912.83.0.0524924192335.issue15231@psf.upfronthosting.co.za>


?ric Araujo added the comment:

There?s no more distutils2 to port to, so this is done.

----------
resolution:  -> fixed
stage: commit review -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Wed Mar 12 12:54:49 2014
From: report at bugs.python.org (Anastasia.Filatova)
Date: Wed, 12 Mar 2014 11:54:49 +0000
Subject: [docs] [issue19060] docs: note that subprocess doesn't replace
	os.exec*
In-Reply-To: <1379748595.57.0.00736365306091.issue19060@psf.upfronthosting.co.za>
Message-ID: <1394625289.29.0.922388522271.issue19060@psf.upfronthosting.co.za>


Anastasia.Filatova added the comment:

David, Terry, thank you for my patch review. I took into consideration your comments and corrected text for specified versions as you said. I decided don't change 'popen*' to 'popen[2-4]' to keep text in one format but the final decision is up to you.

----------
Added file: http://bugs.python.org/file34371/Issue19060_py33.patch

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

From report at bugs.python.org  Wed Mar 12 12:55:03 2014
From: report at bugs.python.org (Anastasia.Filatova)
Date: Wed, 12 Mar 2014 11:55:03 +0000
Subject: [docs] [issue19060] docs: note that subprocess doesn't replace
	os.exec*
In-Reply-To: <1379748595.57.0.00736365306091.issue19060@psf.upfronthosting.co.za>
Message-ID: <1394625303.53.0.956109224417.issue19060@psf.upfronthosting.co.za>


Changes by Anastasia.Filatova <anastasia.n.filatova at gmail.com>:


Added file: http://bugs.python.org/file34372/Issue19060_py34.patch

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

From report at bugs.python.org  Wed Mar 12 12:55:17 2014
From: report at bugs.python.org (Anastasia.Filatova)
Date: Wed, 12 Mar 2014 11:55:17 +0000
Subject: [docs] [issue19060] docs: note that subprocess doesn't replace
	os.exec*
In-Reply-To: <1379748595.57.0.00736365306091.issue19060@psf.upfronthosting.co.za>
Message-ID: <1394625317.61.0.0603901950523.issue19060@psf.upfronthosting.co.za>


Changes by Anastasia.Filatova <anastasia.n.filatova at gmail.com>:


Added file: http://bugs.python.org/file34373/Issue19060_py27.patch

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

From report at bugs.python.org  Wed Mar 12 14:10:29 2014
From: report at bugs.python.org (Sreepriya Chalakkal)
Date: Wed, 12 Mar 2014 13:10:29 +0000
Subject: [docs] [issue20692] Tutorial section 9.4 and FAQ: how to call a
	method on an	int
In-Reply-To: <1392850224.09.0.571764135364.issue20692@psf.upfronthosting.co.za>
Message-ID: <1394629829.95.0.228249587412.issue20692@psf.upfronthosting.co.za>


Changes by Sreepriya Chalakkal <sreepriya1111 at gmail.com>:


Added file: http://bugs.python.org/file34375/doc3.patch

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

From report at bugs.python.org  Wed Mar 12 15:20:19 2014
From: report at bugs.python.org (R. David Murray)
Date: Wed, 12 Mar 2014 14:20:19 +0000
Subject: [docs] [issue19060] docs: note that subprocess doesn't replace
	os.exec*
In-Reply-To: <1379748595.57.0.00736365306091.issue19060@psf.upfronthosting.co.za>
Message-ID: <1394634019.61.0.815791874639.issue19060@psf.upfronthosting.co.za>


R. David Murray added the comment:

Terry: good point.  popen did become undeprecated, however, its implementation was replaced by calls to subprocess.  The reason it is kept is that it is an easy shorthand for various common operations...that is, it is a convenience function, even though it lives in the os module for historical reasons.

So, the 2.7 list is correct (popen still uses the syscall there), and the python3 list is correct (popen is fine to use in python3).  It is perhaps worth mentioning that os.popen is a convenience function in the subprocess docs, but I'm not sure where to put it.  (I see that the popen docs also need updating, but that should be a separate issue, if someone wants to create it.)

Anastasia: thanks, that patch looks good to me.

----------

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

From report at bugs.python.org  Wed Mar 12 16:54:27 2014
From: report at bugs.python.org (R. David Murray)
Date: Wed, 12 Mar 2014 15:54:27 +0000
Subject: [docs] [issue16508] include the "object" type in the lists of
	documented	types
In-Reply-To: <1353284081.12.0.684350303879.issue16508@psf.upfronthosting.co.za>
Message-ID: <1394639666.95.0.0154525367698.issue16508@psf.upfronthosting.co.za>


R. David Murray added the comment:

Doing this is going to be a bit tricky, since currently links like :meth:`object.__format__` go to the special methods section.  So I think making the distinction between available special methods and ones that object implements will need to be done at the same time as this, and there may be quite a few places in the documentation where reference will need to be changed.

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

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

From report at bugs.python.org  Wed Mar 12 19:57:19 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Wed, 12 Mar 2014 18:57:19 +0000
Subject: [docs] [issue20692] Tutorial section 9.4 and FAQ: how to call a
	method on an	int
In-Reply-To: <1392850224.09.0.571764135364.issue20692@psf.upfronthosting.co.za>
Message-ID: <1394650639.77.0.122698843025.issue20692@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

Replace 'The right way... with
----
To look up an attribute on an integer literal, separate the literal from the period with either a space or parentheses.

    >>> 3 .__class__
    <class 'int'>
    >>> (5).__class__
    <type 'int'>

----------

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

From report at bugs.python.org  Wed Mar 12 20:02:26 2014
From: report at bugs.python.org (R. David Murray)
Date: Wed, 12 Mar 2014 19:02:26 +0000
Subject: [docs] [issue20135] FAQ need list mutation answers
In-Reply-To: <1388979444.45.0.0357103143169.issue20135@psf.upfronthosting.co.za>
Message-ID: <1394650946.84.0.822700833135.issue20135@psf.upfronthosting.co.za>


R. David Murray added the comment:

M. Votz:  I like your entry, but I think it should be titled "Why did changing list 'a' also change list 'b'?"  That's the form I've always encountered this question in.  Then the answer can start of with "It didn't, 'a' and 'b' are the same list." and then go on with your text.

Since ?ric concurs, lets go ahead and move that other answer.  Probably to right before "How can I pass optional or keywords parameters from one function to another?"

----------

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

From report at bugs.python.org  Wed Mar 12 21:04:36 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 12 Mar 2014 20:04:36 +0000
Subject: [docs] [issue4744] asynchat documentation needs to be more precise
In-Reply-To: <1230168171.56.0.381937953807.issue4744@psf.upfronthosting.co.za>
Message-ID: <1394654676.18.0.351254508549.issue4744@psf.upfronthosting.co.za>


Changes by ?ric Araujo <merwok at netwok.org>:


----------
versions: +Python 3.3, Python 3.4 -Python 3.1, Python 3.2

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

From report at bugs.python.org  Wed Mar 12 21:10:33 2014
From: report at bugs.python.org (Nitika Agarwal)
Date: Wed, 12 Mar 2014 20:10:33 +0000
Subject: [docs] [issue13368] Possible problem in documentation of module
	subprocess, method send_signal
In-Reply-To: <1320722594.89.0.739080107592.issue13368@psf.upfronthosting.co.za>
Message-ID: <1394655033.44.0.272376906436.issue13368@psf.upfronthosting.co.za>


Nitika Agarwal added the comment:

Hi, I would like to propose a patch for this.

----------
nosy: +nitika

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

From report at bugs.python.org  Wed Mar 12 22:42:07 2014
From: report at bugs.python.org (Sreepriya Chalakkal)
Date: Wed, 12 Mar 2014 21:42:07 +0000
Subject: [docs] [issue20692] Tutorial section 9.4 and FAQ: how to call a
	method on an	int
In-Reply-To: <1392850224.09.0.571764135364.issue20692@psf.upfronthosting.co.za>
Message-ID: <1394660527.19.0.14346962368.issue20692@psf.upfronthosting.co.za>


Changes by Sreepriya Chalakkal <sreepriya1111 at gmail.com>:


Added file: http://bugs.python.org/file34382/doc4.patch

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

From report at bugs.python.org  Wed Mar 12 22:55:00 2014
From: report at bugs.python.org (Giacomo Alzetta)
Date: Wed, 12 Mar 2014 21:55:00 +0000
Subject: [docs] [issue20902] Which operand is preferred by set operations?
	Missing	information in the documentation
Message-ID: <1394661300.29.0.784191218762.issue20902@psf.upfronthosting.co.za>


New submission from Giacomo Alzetta:

Currently the documentation for set (at: http://docs.python.org/2/library/stdtypes.html#set) does not mention which operand is preferred when performing the usual binary operations.

For example the following sample code doesn't have a defined result according to the documentation:


class MyObj:
  def __init__(self, key, value):
     self.key = key
     self.value = value
  def __key(self):
    return self.key
  def __hash__(self):
    return hash(self.__key())
  def __eq__(self, other):
    return type(self) is type(other) and self.__key() == other.__key()

a = {MyObj(1, 'a')}

b = {MyObj(1, 'b')}

print((a & b).pop().value)  # 'a' or 'b'?


As far as I can tell currently there is no rule about this. Intersection prefers the second operand, while union prefers the first. These are the only operations where this is important since they include common elements.

I believe that this kind of information ought to be included explicitly near such operations. At the very least, if the behaviour should really be somehow undefined, it should be stated there so that people don't rely on such behaviour.

The same should be stated for |= and &=, since the first will not modify common elements while the latter will.


PS: I can't find any resource about the formatting of issues (e.g. if and which syntax is used for code blocks. Sorry for that.

----------
assignee: docs at python
components: Documentation
messages: 213305
nosy: Giacomo.Alzetta, docs at python
priority: normal
severity: normal
status: open
title: Which operand is preferred by set operations? Missing information in the documentation
type: enhancement

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

From report at bugs.python.org  Wed Mar 12 23:14:12 2014
From: report at bugs.python.org (R. David Murray)
Date: Wed, 12 Mar 2014 22:14:12 +0000
Subject: [docs] [issue20902] Which operand is preferred by set operations?
	Missing	information in the documentation
In-Reply-To: <1394661300.29.0.784191218762.issue20902@psf.upfronthosting.co.za>
Message-ID: <1394662452.19.0.957228075436.issue20902@psf.upfronthosting.co.za>


R. David Murray added the comment:

If you take the intersection or union of a set, it shouldn't matter which set the element "came from", by the axioms that apply to sets.  So it if does, that's an application bug, IMO.

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

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

From report at bugs.python.org  Wed Mar 12 23:18:36 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 12 Mar 2014 22:18:36 +0000
Subject: [docs] [issue20902] Which operand is preferred by set operations?
	Missing	information in the documentation
In-Reply-To: <1394661300.29.0.784191218762.issue20902@psf.upfronthosting.co.za>
Message-ID: <1394662716.6.0.305696975873.issue20902@psf.upfronthosting.co.za>


Changes by ?ric Araujo <merwok at netwok.org>:


----------
nosy: +stutzbach

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

From report at bugs.python.org  Wed Mar 12 23:29:58 2014
From: report at bugs.python.org (R. David Murray)
Date: Wed, 12 Mar 2014 22:29:58 +0000
Subject: [docs] [issue20902] Which operand is preferred by set operations?
	Missing	information in the documentation
In-Reply-To: <1394661300.29.0.784191218762.issue20902@psf.upfronthosting.co.za>
Message-ID: <1394663398.17.0.315642980017.issue20902@psf.upfronthosting.co.za>


R. David Murray added the comment:

Or, to put it another way, which set it comes from is not documented because it is an implementation detail and can not be depended on.

I'm sure someone will correct me if I'm wrong :)

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

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

From report at bugs.python.org  Wed Mar 12 23:46:20 2014
From: report at bugs.python.org (Steven D'Aprano)
Date: Wed, 12 Mar 2014 22:46:20 +0000
Subject: [docs] [issue20902] Which operand is preferred by set operations?
	Missing	information in the documentation
In-Reply-To: <1394661300.29.0.784191218762.issue20902@psf.upfronthosting.co.za>
Message-ID: <1394664380.11.0.813387581364.issue20902@psf.upfronthosting.co.za>


Steven D'Aprano added the comment:

If this is undefined, and I think it should be, the docs should explicitly say so. How is this?

The union and intersection operations select elements which appear in both operands, e.g. set([a, b, c]) & set([c, d, e]) returns set([c]). The selection is performed by equality, not object identity, and which specific object is returned (the c object from the first set or the second set) is an implementation detail and cannot be relied on.

----------
nosy: +stevenjd

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

From report at bugs.python.org  Thu Mar 13 00:11:33 2014
From: report at bugs.python.org (R. David Murray)
Date: Wed, 12 Mar 2014 23:11:33 +0000
Subject: [docs] [issue20902] Which operand is preferred by set operations?
	Missing	information in the documentation
In-Reply-To: <1394661300.29.0.784191218762.issue20902@psf.upfronthosting.co.za>
Message-ID: <1394665893.35.0.66977226882.issue20902@psf.upfronthosting.co.za>


R. David Murray added the comment:

Sounds good to me.

----------

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

From report at bugs.python.org  Thu Mar 13 00:30:43 2014
From: report at bugs.python.org (R. David Murray)
Date: Wed, 12 Mar 2014 23:30:43 +0000
Subject: [docs] [issue20903] smtplib.SMTP raises socket.timeout
In-Reply-To: <1394664754.18.0.260499838693.issue20903@psf.upfronthosting.co.za>
Message-ID: <1394667043.95.0.866549696472.issue20903@psf.upfronthosting.co.za>


R. David Murray added the comment:

In general we don't document what gets raised unless it is unique to a module or has non-obvious implications.  In this case, getting socket exceptions out of a network library should be "obvious" in some sense :).  In particular, both SMTPConnectError and socket.error are subclasses of OSError, so if you want to catch them all, catch OSError.

Now, that said, I have some sympathy to the idea that something triggered by a parameter to the call should perhaps result in an SMTPConnectError.  However, the argument *against* it is that it makes it difficult to differentiate the timeout error from other connection errors, which one might well want to do.  We've moved toward making it easier to tell classes of errors apart (see PEP 3151), so this would be a regression in that approach.

Given that the timeout is part of the signature, I think it does make sense to mention that the timeout will raise a socket.timeout error.

----------
assignee:  -> docs at python
components: +Documentation -Library (Lib)
keywords: +easy
nosy: +docs at python, r.david.murray
stage:  -> needs patch
versions: +Python 3.4, Python 3.5

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

From report at bugs.python.org  Thu Mar 13 00:36:17 2014
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 12 Mar 2014 23:36:17 +0000
Subject: [docs] [issue16805] when building docs on Debian 7 --> ERROR: Error
	in	"note" directive
In-Reply-To: <1356739435.76.0.304211925624.issue16805@psf.upfronthosting.co.za>
Message-ID: <3fkqLT18GvzQMV@mail.python.org>


Roundup Robot added the comment:

New changeset ca43fa662b0d by ?ric Araujo in branch '2.7':
Fix note markup (#16805).
http://hg.python.org/cpython/rev/ca43fa662b0d

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

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

From report at bugs.python.org  Thu Mar 13 00:42:55 2014
From: report at bugs.python.org (Chris Clark)
Date: Wed, 12 Mar 2014 23:42:55 +0000
Subject: [docs] [issue20903] smtplib.SMTP raises socket.timeout
In-Reply-To: <1394664754.18.0.260499838693.issue20903@psf.upfronthosting.co.za>
Message-ID: <1394667775.82.0.140828297977.issue20903@psf.upfronthosting.co.za>


Chris Clark added the comment:

I am concerned about the policy of not documenting all exceptions that are raised. It sounds like there is no straightforward way to write a comprehensive except statement without using a bare except or catching some base exception. I consider it dangerous to catch broad exception classes because it can hide some nasty bugs. And while I may be able to use OSError here, how can I be sure that you aren't forgetting about some other unexpected exception? Furthermore, I don't want to catch all OSErrors, only those relating to the SMTP server connection failing.

I definitely agree that it is preferable to be able to differentiate different types of exceptions. It seems to me that the best solution would be to make subclasses of SMTPConnectError so that I can catch SMTPConnectError if I don't care about the type or SMTPConnectTimeoutError if I do care about the type.

----------

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

From report at bugs.python.org  Thu Mar 13 00:45:24 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Wed, 12 Mar 2014 23:45:24 +0000
Subject: [docs] [issue16508] include the "object" type in the lists of
	documented	types
In-Reply-To: <1353284081.12.0.684350303879.issue16508@psf.upfronthosting.co.za>
Message-ID: <1394667924.5.0.272967273941.issue16508@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

What does not help is that help(ob) omits all the methods inherited from object, *even when ob is object*.  See #20285.

----------
versions:  -Python 3.2

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

From report at bugs.python.org  Thu Mar 13 00:48:22 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 12 Mar 2014 23:48:22 +0000
Subject: [docs] [issue18855] Inconsistent README filenames
In-Reply-To: <1377616570.1.0.108273179071.issue18855@psf.upfronthosting.co.za>
Message-ID: <1394668102.81.0.929109611746.issue18855@psf.upfronthosting.co.za>


?ric Araujo added the comment:

I?ve had co-workers get in trouble with file renames and case sensitivity on Mac OS X, but I?ve always been able to fix issues on Debian and tell them to hg pull --update.  I don?t remember if they had to create a new clone, or update to an older revision without the troublemaking files.

Anyhow, I don?t think this bug is important.  +0 for renaming the README to README.txt and configuring hgeol to make end-of-lines native.  That would solve the problem of a potential new contributor on Windows cloning the repo and not sure how to read the readme file at the repo root.  Changing the case of the readme.txt files would not solve any problem.

----------

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

From report at bugs.python.org  Thu Mar 13 00:52:04 2014
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 12 Mar 2014 23:52:04 +0000
Subject: [docs] [issue16805] when building docs on Debian 7 --> ERROR: Error
	in	"note" directive
In-Reply-To: <1356739435.76.0.304211925624.issue16805@psf.upfronthosting.co.za>
Message-ID: <3fkqhg3cmjz7LjS@mail.python.org>


Roundup Robot added the comment:

New changeset 9dc653f48357 by ?ric Araujo in branch '3.3':
Fix note markup (#16805).
http://hg.python.org/cpython/rev/9dc653f48357

New changeset 44e815a33ae3 by ?ric Araujo in branch 'default':
Merge 3.3 (#16805)
http://hg.python.org/cpython/rev/44e815a33ae3

----------

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

From report at bugs.python.org  Thu Mar 13 00:53:48 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 12 Mar 2014 23:53:48 +0000
Subject: [docs] [issue16805] when building docs on Debian 7 --> ERROR: Error
	in	"note" directive
In-Reply-To: <1356739435.76.0.304211925624.issue16805@psf.upfronthosting.co.za>
Message-ID: <1394668428.86.0.414019953955.issue16805@psf.upfronthosting.co.za>


?ric Araujo added the comment:

Georg said LGTM, I applied the patches.  Thanks!

----------
resolution:  -> fixed
stage: patch review -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Thu Mar 13 02:16:11 2014
From: report at bugs.python.org (Balakrishnan B)
Date: Thu, 13 Mar 2014 01:16:11 +0000
Subject: [docs] [issue20902] Which operand is preferred by set operations?
	Missing	information in the documentation
In-Reply-To: <1394661300.29.0.784191218762.issue20902@psf.upfronthosting.co.za>
Message-ID: <1394673370.62.0.525128258309.issue20902@psf.upfronthosting.co.za>


Changes by Balakrishnan B <balakrishnan.erode at gmail.com>:


----------
nosy: +Balakrishnan.B

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

From report at bugs.python.org  Thu Mar 13 03:36:57 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 13 Mar 2014 02:36:57 +0000
Subject: [docs] [issue8255] Packaging step-by-step tutorial
In-Reply-To: <1269787637.04.0.463586986817.issue8255@psf.upfronthosting.co.za>
Message-ID: <1394678217.8.0.799306947686.issue8255@psf.upfronthosting.co.za>


Changes by ?ric Araujo <merwok at netwok.org>:


----------
resolution:  -> out of date
stage:  -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Thu Mar 13 03:42:20 2014
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 13 Mar 2014 02:42:20 +0000
Subject: [docs] [issue19060] docs: note that subprocess doesn't replace
	os.exec*
In-Reply-To: <1379748595.57.0.00736365306091.issue19060@psf.upfronthosting.co.za>
Message-ID: <3fkvT76CS1z7LjT@mail.python.org>


Roundup Robot added the comment:

New changeset 1d31060f8a5c by Benjamin Peterson in branch '2.7':
remove unnecessary word (closes #19060)
http://hg.python.org/cpython/rev/1d31060f8a5c

New changeset 4d8a9d12edfa by Benjamin Peterson in branch '3.3':
remove unnecessary word (closes #19060)
http://hg.python.org/cpython/rev/4d8a9d12edfa

New changeset 6f93ab911d5d by Benjamin Peterson in branch 'default':
merge 3.3 (#19060)
http://hg.python.org/cpython/rev/6f93ab911d5d

----------
nosy: +python-dev
resolution:  -> fixed
stage: needs patch -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Thu Mar 13 03:54:06 2014
From: report at bugs.python.org (Benjamin Peterson)
Date: Thu, 13 Mar 2014 02:54:06 +0000
Subject: [docs] [issue20902] Which operand is preferred by set operations?
	Missing	information in the documentation
In-Reply-To: <1394661300.29.0.784191218762.issue20902@psf.upfronthosting.co.za>
Message-ID: <1394679246.79.0.944248554281.issue20902@psf.upfronthosting.co.za>


Changes by Benjamin Peterson <bp+pybugs at benjamin-peterson.org>:


----------
keywords: +easy

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

From report at bugs.python.org  Thu Mar 13 05:26:05 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 13 Mar 2014 04:26:05 +0000
Subject: [docs] [issue12354] packaging.pypi.simple docs use both client and
	crawler	name, which might be confusing
In-Reply-To: <1308334574.8.0.60329566716.issue12354@psf.upfronthosting.co.za>
Message-ID: <1394684765.25.0.240397525182.issue12354@psf.upfronthosting.co.za>


Changes by ?ric Araujo <merwok at netwok.org>:


----------
resolution:  -> out of date
stage:  -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Thu Mar 13 06:00:05 2014
From: report at bugs.python.org (Kathleen Weaver)
Date: Thu, 13 Mar 2014 05:00:05 +0000
Subject: [docs] [issue20265] Bring Doc/using/windows up to date
In-Reply-To: <1389757265.26.0.116885263001.issue20265@psf.upfronthosting.co.za>
Message-ID: <1394686804.51.0.587912770678.issue20265@psf.upfronthosting.co.za>


Kathleen Weaver added the comment:

Updated parts of the Windows using document, especially for Windows 7 and Windows 8.

Moved environment variables to FAQ/windows

Checked all links, removed broken references from Cygwin

Checked broken links referring to in ?Installing Python? in ?A Byte of Python? by Swaroop C H, 2003

Updated FAQ/windows also, adding environment section from using/windows

Also fact checked everything in FAQ/windows

----------
keywords: +patch
Added file: http://bugs.python.org/file34385/windowsDoc.patch

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

From report at bugs.python.org  Thu Mar 13 06:05:04 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 13 Mar 2014 05:05:04 +0000
Subject: [docs] [issue20266] Bring Doc/faq/windows up to date
In-Reply-To: <1389758449.02.0.48240700444.issue20266@psf.upfronthosting.co.za>
Message-ID: <1394687104.39.0.205811894629.issue20266@psf.upfronthosting.co.za>


?ric Araujo added the comment:

#20265 has more discussion as well as a patch that touches both Windows FAQ and Using Windows.  Closing this one.

----------
nosy: +eric.araujo
resolution:  -> fixed
stage: needs patch -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Thu Mar 13 06:05:39 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 13 Mar 2014 05:05:39 +0000
Subject: [docs] [issue20265] Bring Doc/using/windows up to date
In-Reply-To: <1389757265.26.0.116885263001.issue20265@psf.upfronthosting.co.za>
Message-ID: <1394687139.02.0.632746662122.issue20265@psf.upfronthosting.co.za>


?ric Araujo added the comment:

>From #20265:

The faq doesn't mention the new launcher for Windows.  Rather than write too much I'd simply cross reference this http://docs.python.org/3/using/windows.html#python-launcher-for-windows.  I think this also impacts on the section "How do I make Python scripts executable?".

----------
nosy: +eric.araujo

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

From report at bugs.python.org  Thu Mar 13 06:24:24 2014
From: report at bugs.python.org (Kathleen Weaver)
Date: Thu, 13 Mar 2014 05:24:24 +0000
Subject: [docs] [issue20265] Bring Doc/using/windows up to date
In-Reply-To: <1389757265.26.0.116885263001.issue20265@psf.upfronthosting.co.za>
Message-ID: <1394688263.05.0.308134352222.issue20265@psf.upfronthosting.co.za>


Kathleen Weaver added the comment:

Fixed end of line issue in both documents (I hope)

----------
Added file: http://bugs.python.org/file34386/windowsDoc.patch

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

From report at bugs.python.org  Thu Mar 13 06:24:47 2014
From: report at bugs.python.org (Kathleen Weaver)
Date: Thu, 13 Mar 2014 05:24:47 +0000
Subject: [docs] [issue20265] Bring Doc/using/windows up to date
In-Reply-To: <1389757265.26.0.116885263001.issue20265@psf.upfronthosting.co.za>
Message-ID: <1394688287.54.0.291834626173.issue20265@psf.upfronthosting.co.za>


Changes by Kathleen Weaver <kathleen at kweaver.org>:


Removed file: http://bugs.python.org/file34385/windowsDoc.patch

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

From report at bugs.python.org  Thu Mar 13 08:55:40 2014
From: report at bugs.python.org (Giacomo Alzetta)
Date: Thu, 13 Mar 2014 07:55:40 +0000
Subject: [docs] [issue20902] Which operand is preferred by set operations?
	Missing	information in the documentation
In-Reply-To: <1394661300.29.0.784191218762.issue20902@psf.upfronthosting.co.za>
Message-ID: <1394697340.64.0.303811655417.issue20902@psf.upfronthosting.co.za>


Giacomo Alzetta added the comment:

I asked this because, for example, in Haskell it *is* a well-defined behaviour (see its documentation at: http://hackage.haskell.org/package/containers-0.5.4.0/docs/Data-Set.html): the left operand is preferred by all operations.

In fact, working with Haskell, I also have used such behaviour in the past. For example when writing a simple type-checker it's quite convenient to use such behaviour when handling environments where you want inner blocks to hide outer variables. Not defining such behaviour means that you must re-implement the wheel in order to achieve the correct behaviour.

In any case, this information should be made explicit in the docs, whether we want to make the behaviour defined or not.

----------

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

From report at bugs.python.org  Thu Mar 13 10:11:51 2014
From: report at bugs.python.org (Anastasia.Filatova)
Date: Thu, 13 Mar 2014 09:11:51 +0000
Subject: [docs] [issue20112] The documentation for http.server
	error_message_format	is inadequate.
In-Reply-To: <1388701952.2.0.132957137739.issue20112@psf.upfronthosting.co.za>
Message-ID: <1394701911.52.0.00995720356491.issue20112@psf.upfronthosting.co.za>


Anastasia.Filatova added the comment:

I made a patch on this issue. I added a small example to the description. Should I provide a more detailed example or that one will be enough? Could someone please review the patch?

----------
keywords: +patch
nosy: +Anastasia.Filatova
Added file: http://bugs.python.org/file34389/Issue20112_py27.patch

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

From report at bugs.python.org  Thu Mar 13 10:12:03 2014
From: report at bugs.python.org (Anastasia.Filatova)
Date: Thu, 13 Mar 2014 09:12:03 +0000
Subject: [docs] [issue20112] The documentation for http.server
	error_message_format	is inadequate.
In-Reply-To: <1388701952.2.0.132957137739.issue20112@psf.upfronthosting.co.za>
Message-ID: <1394701923.26.0.914427509733.issue20112@psf.upfronthosting.co.za>


Changes by Anastasia.Filatova <anastasia.n.filatova at gmail.com>:


Added file: http://bugs.python.org/file34390/Issue20112_py33.patch

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

From report at bugs.python.org  Thu Mar 13 10:12:15 2014
From: report at bugs.python.org (Anastasia.Filatova)
Date: Thu, 13 Mar 2014 09:12:15 +0000
Subject: [docs] [issue20112] The documentation for http.server
	error_message_format	is inadequate.
In-Reply-To: <1388701952.2.0.132957137739.issue20112@psf.upfronthosting.co.za>
Message-ID: <1394701935.13.0.407829900878.issue20112@psf.upfronthosting.co.za>


Changes by Anastasia.Filatova <anastasia.n.filatova at gmail.com>:


Added file: http://bugs.python.org/file34391/Issue20112_py34.patch

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

From report at bugs.python.org  Thu Mar 13 10:16:28 2014
From: report at bugs.python.org (Graham Wideman)
Date: Thu, 13 Mar 2014 09:16:28 +0000
Subject: [docs] [issue20906] Unicode HOWTO
Message-ID: <1394702187.81.0.00522221343959.issue20906@psf.upfronthosting.co.za>


New submission from Graham Wideman:

The Unicode HOWTO article is an attempt to help users wrap their minds around Unicode. There are some opportunities for improvement. Issues presented in order of the narrative:

http://docs.python.org/3.3/howto/unicode.html

History of Character Codes
---------------------------

References to the 1980's are a bit off.

"In the mid-1980s an Apple II BASIC program..." 

Assuming the comment is about the state of play in the mid-80's, then: The Apple II appeared in 1977. By 1985 we already had Macs, and PCs running DOS, which were capable of various character sets (not to mention lowercase letters!)

"In the 1980s, almost all personal computers were 8-bit"

Both the PC (1983) and Mac (1984) had 16-bit processors.

Definitions:
------------
"Characters are abstractions": Not helpful unless one already knows what "abstraction" means in this specific context.

"the symbol for ohms (?) is usually drawn much like the capital letter omega (?) in the Greek alphabet [...] but these are two different characters that have different meanings."

Omega is a poor example for this concept. Omega is used as the identifier for a unit in the same way as "m" is used for meter, or "A" is used for ampere. Each is a specific use of a character, which, like any specific use, has a particular meaning. However, having a particular meaning doesn't necessarily require a separate character, and in the case of omega, the Unicode standard now says that the separate "ohm" character is deprecated. 

"The ohm sign is canonically equivalent to the capital omega, and normalization would remove any distinction."

http://www.unicode.org/versions/Unicode4.0.0/ch07.pdf#search=%22character%20U%2B2126%20maps%20OR%20map%20OR%20mapping%22

A better example might be the roman numerals, code points U+2160 and subsequent.

Definitions
------------

"A code point is an integer value, usually denoted in base 16."  

When trying to convey clearly the distinction between character, code point, and byte representation, the topic of "how it's denoted" is a potential distraction for the reader, so I suggest this point be a bit more explicitly  parenthetical, and less confusable with "16 bit".  Like:

"A code point value is an integer in the range 0 to over 0x10FFFF (about 1.1 million, with some 110 thousand assigned so far). In a narrative such as the current article, a code point value is usually written in hexadecimal. The Unicode standard displays code points with the notation U+265E to mean the character with value 0x265e (9822 decimal; "Black Chess Knight" character)."

(Also revise subsequent para to use same example character. I suggest not using "Ethiotic Syllable WI", because it's unfamiliar to most readers, and it muddies the topic by suggesting that Unicode in general captures _syllables_ rather than _characters_.)

Encodings:
-----------
"This sequence needs to be represented as a set of bytes"
--> ""This code point sequence needs to be represented as a sequence of bytes"

"4. Many Internet standards are defined in terms of textual data"

This is a vague claim. Probably what was intended was: "Many Internet standards define protocols in which the data must contain no zero bytes, or zero bytes have special meaning."  Is this actually true? Are there "many" such standards?

"Generally people don?t use this encoding,"
Probably "people" per se don't use any encoding, computers do.  --> "Because of these problems, other more efficient and convenient encodings have been devised and are commonly used.

For continuity, directly after that para should come the later paras starting with "UTF-8 is one of the most common".

"2. A Unicode string is turned into a string of bytes..."
--> "2. A Unicode string is turned into a sequence of bytes..."  (Ie: don't overload "string" in and article about strings and encodings.).

Create a new subhead "Converting from Unicode to non-Unicode encodings", and move under it the paras:

"Encodings don't have to..."
"Latin-1, also known as..."
"Encodings don't have to..."

But also revise:

"Encodings don?t have to handle every possible Unicode character, and most encodings don?t."

--> "Non-Unicode code systems usually don't handle all of the characters to be found in Unicode."

----------
assignee: docs at python
components: Documentation
messages: 213367
nosy: docs at python, gwideman
priority: normal
severity: normal
status: open
title: Unicode HOWTO
type: enhancement
versions: Python 2.7, Python 3.1, Python 3.2, Python 3.3, Python 3.4, Python 3.5

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

From report at bugs.python.org  Thu Mar 13 10:25:35 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 13 Mar 2014 09:25:35 +0000
Subject: [docs] [issue20464] Update distutils sample config file
	in	Doc/install/index.rst
In-Reply-To: <1391201711.97.0.184979826347.issue20464@psf.upfronthosting.co.za>
Message-ID: <1394702735.88.0.195019526304.issue20464@psf.upfronthosting.co.za>


Changes by ?ric Araujo <merwok at netwok.org>:


----------
assignee: docs at python -> eric.araujo
nosy: +eric.araujo

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

From report at bugs.python.org  Thu Mar 13 10:26:35 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 13 Mar 2014 09:26:35 +0000
Subject: [docs] [issue20091] An index entry for __main__ in "30.5 runpy" is
	missing
In-Reply-To: <1388243842.91.0.578293707742.issue20091@psf.upfronthosting.co.za>
Message-ID: <1394702795.41.0.26215205821.issue20091@psf.upfronthosting.co.za>


Changes by ?ric Araujo <merwok at netwok.org>:


----------
nosy: +eric.araujo, ncoghlan

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

From report at bugs.python.org  Thu Mar 13 10:27:58 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 13 Mar 2014 09:27:58 +0000
Subject: [docs] [issue20787] typo in asyncio docs for subprocess_exec()
In-Reply-To: <1393453658.86.0.247755965136.issue20787@psf.upfronthosting.co.za>
Message-ID: <1394702878.91.0.039376208453.issue20787@psf.upfronthosting.co.za>


Changes by ?ric Araujo <merwok at netwok.org>:


----------
keywords: +needs review
nosy: +haypo
stage:  -> patch review

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

From report at bugs.python.org  Thu Mar 13 10:28:24 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 13 Mar 2014 09:28:24 +0000
Subject: [docs] [issue20842] pkgutil docs should reference glossary terms
	not PEP 302
In-Reply-To: <1393846400.67.0.723549613222.issue20842@psf.upfronthosting.co.za>
Message-ID: <1394702904.78.0.882958352367.issue20842@psf.upfronthosting.co.za>


Changes by ?ric Araujo <merwok at netwok.org>:


----------
nosy: +eric.araujo

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

From report at bugs.python.org  Thu Mar 13 10:51:31 2014
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 13 Mar 2014 09:51:31 +0000
Subject: [docs] [issue20787] typo in asyncio docs for subprocess_exec()
In-Reply-To: <1393453658.86.0.247755965136.issue20787@psf.upfronthosting.co.za>
Message-ID: <3fl50L6Xkvz7Ljs@mail.python.org>


Roundup Robot added the comment:

New changeset 7a42fb12a736 by Victor Stinner in branch 'default':
Close #20787: asyncio doc: fix typo. Patch written by akira.
http://hg.python.org/cpython/rev/7a42fb12a736

----------
nosy: +python-dev
resolution:  -> fixed
stage: patch review -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Thu Mar 13 10:54:32 2014
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 13 Mar 2014 09:54:32 +0000
Subject: [docs] [issue20889] asyncio.docs : asyncio.Condition
	acquire/release/locked	method undocumented
In-Reply-To: <1394515195.95.0.980364058865.issue20889@psf.upfronthosting.co.za>
Message-ID: <3fl53q18n7z7LjV@mail.python.org>


Roundup Robot added the comment:

New changeset f22e1d89486d by Victor Stinner in branch 'default':
Close #20889: asyncio doc: Document acquire(), locked() and release() method of
http://hg.python.org/cpython/rev/f22e1d89486d

----------
nosy: +python-dev
resolution:  -> fixed
stage:  -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Thu Mar 13 10:55:07 2014
From: report at bugs.python.org (STINNER Victor)
Date: Thu, 13 Mar 2014 09:55:07 +0000
Subject: [docs] [issue20889] asyncio.docs : asyncio.Condition
	acquire/release/locked	method undocumented
In-Reply-To: <1394515195.95.0.980364058865.issue20889@psf.upfronthosting.co.za>
Message-ID: <1394704507.81.0.227602347447.issue20889@psf.upfronthosting.co.za>


STINNER Victor added the comment:

Thanks Alexandre for the report.

----------
stage: committed/rejected -> 

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

From report at bugs.python.org  Thu Mar 13 11:32:50 2014
From: report at bugs.python.org (Kushal Das)
Date: Thu, 13 Mar 2014 10:32:50 +0000
Subject: [docs] [issue20842] pkgutil docs should reference glossary terms
	not PEP 302
In-Reply-To: <1393846400.67.0.723549613222.issue20842@psf.upfronthosting.co.za>
Message-ID: <1394706770.01.0.528030203921.issue20842@psf.upfronthosting.co.za>


Kushal Das added the comment:

Will submit a patch for this.

----------
nosy: +kushaldas

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

From report at bugs.python.org  Thu Mar 13 11:34:07 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 13 Mar 2014 10:34:07 +0000
Subject: [docs] [issue12901] Nest class/methods directives in documentation
In-Reply-To: <1315241119.9.0.996780726209.issue12901@psf.upfronthosting.co.za>
Message-ID: <1394706846.95.0.52236852709.issue12901@psf.upfronthosting.co.za>


?ric Araujo added the comment:

I?m inclined to reject this patch: it doesn?t apply cleanly anymore, it does not cover all modules, and basically it?s markup changes without benefits for end users.

Our doc can recommend nesting class and methods directives for new doc, and existing doc may or may not be changed when someone improves the contents.

----------
status: open -> pending
versions:  -Python 3.2

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

From report at bugs.python.org  Thu Mar 13 15:29:14 2014
From: report at bugs.python.org (Zachary Ware)
Date: Thu, 13 Mar 2014 14:29:14 +0000
Subject: [docs] [issue20265] Bring Windows docs up to date
In-Reply-To: <1389757265.26.0.116885263001.issue20265@psf.upfronthosting.co.za>
Message-ID: <1394720954.62.0.930935518446.issue20265@psf.upfronthosting.co.za>


Zachary Ware added the comment:

?ric Araujo wrote:
> From #20265:

Correction, this is #20265, that message was from #20266 :)

Kathleen: both ?ric and I have left some review comments for you in Rietveld, which should have sent you an email with the comments and links to the Rietveld review.

Also, if you're having end-of-line issues, I would recommend turning on the Mercurial eol extension (either edit "%userprofile%\Mercurial.ini" manually, or use the Extensions section of File -> Settings... from TortoiseHg Workbench).  To work most effectively, you'll need to update to the 'null' revision, then update back to default after turning on eol.  That will ensure that most files have \r\n line endings and hg can keep line endings straight for you thereafter.

Here's a sample of my Mercurial.ini with some other things you may be interested in:

[extensions]
;keep eols straight
eol=

;delete untracked files (helps with starting from a clean slate)
purge=

;colorize output, including making trailing whitespace visible in diffs
color=

;create several clones that share history, useful for keeping
;separate clones per branch without having to pull individually
share=

[defaults]
;don't try to commit when importing a patch
import = --no-commit

----------
title: Bring Doc/using/windows up to date -> Bring Windows docs up to date

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

From report at bugs.python.org  Thu Mar 13 15:40:29 2014
From: report at bugs.python.org (Kathleen Weaver)
Date: Thu, 13 Mar 2014 14:40:29 +0000
Subject: [docs] [issue20265] Bring Windows docs up to date
In-Reply-To: <1394720954.62.0.930935518446.issue20265@psf.upfronthosting.co.za>
Message-ID: <4cd1cc724da44f34a9cb92c0b1c8307d@BLUPR04MB419.namprd04.prod.outlook.com>


Kathleen Weaver added the comment:

It was Visual Studio that messed up the end of line feeds, it keep telling me that there was a problem but I didn't know what it meant.  Erik and I were in #pyladies and he really helped me.

As soon as I get done with gym and other mundane errands I will get back on this.

I can't get over how helpful and nice everyone is! <smile>

Sent using OWA for iPhone
________________________________________
From: Zachary Ware <report at bugs.python.org>
Sent: Thursday, March 13, 2014 9:29:14 AM
To: Kathleen Weaver
Subject: [issue20265] Bring Windows docs up to date

Zachary Ware added the comment:

?ric Araujo wrote:
> From #20265:

Correction, this is #20265, that message was from #20266 :)

Kathleen: both ?ric and I have left some review comments for you in Rietveld, which should have sent you an email with the comments and links to the Rietveld review.

Also, if you're having end-of-line issues, I would recommend turning on the Mercurial eol extension (either edit "%userprofile%\Mercurial.ini" manually, or use the Extensions section of File -> Settings... from TortoiseHg Workbench).  To work most effectively, you'll need to update to the 'null' revision, then update back to default after turning on eol.  That will ensure that most files have \r\n line endings and hg can keep line endings straight for you thereafter.

Here's a sample of my Mercurial.ini with some other things you may be interested in:

[extensions]
;keep eols straight
eol=

;delete untracked files (helps with starting from a clean slate)
purge=

;colorize output, including making trailing whitespace visible in diffs
color=

;create several clones that share history, useful for keeping
;separate clones per branch without having to pull individually
share=

[defaults]
;don't try to commit when importing a patch
import = --no-commit

----------
title: Bring Doc/using/windows up to date -> Bring Windows docs up to date

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

----------

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

From report at bugs.python.org  Thu Mar 13 15:48:22 2014
From: report at bugs.python.org (R. David Murray)
Date: Thu, 13 Mar 2014 14:48:22 +0000
Subject: [docs] [issue19247] Describe surrogateescape algorithm in the
	Library	Reference
In-Reply-To: <1381673577.83.0.634006615694.issue19247@psf.upfronthosting.co.za>
Message-ID: <1394722102.91.0.70583201122.issue19247@psf.upfronthosting.co.za>


R. David Murray added the comment:

Looking at the PEP, I don't think there's anything in there that can just be copied to the docs.  I've suggested to one of the new contributors to do the break out of the error handlers into its own section, and then someone with more understanding of surrogate escape and how we use it can write up the description for the sub-section.

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

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

From report at bugs.python.org  Thu Mar 13 17:08:30 2014
From: report at bugs.python.org (R. David Murray)
Date: Thu, 13 Mar 2014 16:08:30 +0000
Subject: [docs] [issue19861] Update What's New for Python 3.4
In-Reply-To: <1385986982.03.0.371652275474.issue19861@psf.upfronthosting.co.za>
Message-ID: <1394726909.91.0.754265912384.issue19861@psf.upfronthosting.co.za>


R. David Murray added the comment:

I'm done with everything in my edit queue except the final copy-edit/formatting pass.  So if you know of anything missing, let me know.

----------

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

From report at bugs.python.org  Thu Mar 13 18:31:09 2014
From: report at bugs.python.org (Georg Brandl)
Date: Thu, 13 Mar 2014 17:31:09 +0000
Subject: [docs] [issue12901] Nest class/methods directives in documentation
In-Reply-To: <1315241119.9.0.996780726209.issue12901@psf.upfronthosting.co.za>
Message-ID: <1394731869.81.0.846055892415.issue12901@psf.upfronthosting.co.za>


Georg Brandl added the comment:

Agreed.

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

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

From report at bugs.python.org  Thu Mar 13 19:20:49 2014
From: report at bugs.python.org (Kathleen Weaver)
Date: Thu, 13 Mar 2014 18:20:49 +0000
Subject: [docs] [issue20265] Bring Windows docs up to date
In-Reply-To: <1389757265.26.0.116885263001.issue20265@psf.upfronthosting.co.za>
Message-ID: <1394734849.22.0.258833206358.issue20265@psf.upfronthosting.co.za>


Kathleen Weaver added the comment:

I have updated the files as reflected by the code review.

----------
Added file: http://bugs.python.org/file34403/windowsDoc.patch

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

From report at bugs.python.org  Thu Mar 13 19:22:20 2014
From: report at bugs.python.org (Kathleen Weaver)
Date: Thu, 13 Mar 2014 18:22:20 +0000
Subject: [docs] [issue20265] Bring Windows docs up to date
In-Reply-To: <1394734849.22.0.258833206358.issue20265@psf.upfronthosting.co.za>
Message-ID: <f86be61a2a2e4c7e8fde21b442836a4f@BLUPR04MB419.namprd04.prod.outlook.com>


Kathleen Weaver added the comment:

Could we make this a separate issue, and I will work on it next?

>From #20265:

The faq doesn't mention the new launcher for Windows.  Rather than write too much I'd simply cross reference this http://docs.python.org/3/using/windows.html#python-launcher-for-windows.  I think this also impacts on the section "How do I make Python scripts executable?".

----------

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

From report at bugs.python.org  Thu Mar 13 20:47:16 2014
From: report at bugs.python.org (Tshepang Lekhonkhobe)
Date: Thu, 13 Mar 2014 19:47:16 +0000
Subject: [docs] [issue16805] when building docs on Debian 7 --> ERROR: Error
	in	"note" directive
In-Reply-To: <1356739435.76.0.304211925624.issue16805@psf.upfronthosting.co.za>
Message-ID: <1394740036.23.0.679749389777.issue16805@psf.upfronthosting.co.za>


Tshepang Lekhonkhobe added the comment:

thanks much for the commit

----------

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

From report at bugs.python.org  Thu Mar 13 20:49:55 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 13 Mar 2014 19:49:55 +0000
Subject: [docs] [issue20906] Issues in Unicode HOWTO
In-Reply-To: <1394702187.81.0.00522221343959.issue20906@psf.upfronthosting.co.za>
Message-ID: <1394740195.19.0.786236771721.issue20906@psf.upfronthosting.co.za>


Changes by ?ric Araujo <merwok at netwok.org>:


----------
nosy: +benjamin.peterson, eric.araujo, ezio.melotti, haypo, lemburg, pitrou
title: Unicode HOWTO -> Issues in Unicode HOWTO
versions:  -Python 3.1, Python 3.2, Python 3.5

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

From report at bugs.python.org  Thu Mar 13 22:31:50 2014
From: report at bugs.python.org (Ya-Ting Huang)
Date: Thu, 13 Mar 2014 21:31:50 +0000
Subject: [docs] [issue17006] Warn users about hashing secrets?
In-Reply-To: <1358758082.76.0.415880124971.issue17006@psf.upfronthosting.co.za>
Message-ID: <1394746309.92.0.080091167084.issue17006@psf.upfronthosting.co.za>


Ya-Ting Huang added the comment:

Hi. this is my first patch. I tried to follow the instruction by David to add Christian's notes into a new security section.

----------
nosy: +yating.huang
Added file: http://bugs.python.org/file34406/hashlib.patch

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

From report at bugs.python.org  Thu Mar 13 22:41:13 2014
From: report at bugs.python.org (R. David Murray)
Date: Thu, 13 Mar 2014 21:41:13 +0000
Subject: [docs] [issue17006] Warn users about hashing secrets?
In-Reply-To: <1358758082.76.0.415880124971.issue17006@psf.upfronthosting.co.za>
Message-ID: <1394746873.37.0.869416332988.issue17006@psf.upfronthosting.co.za>


R. David Murray added the comment:

Please note what I said about wrapping lines to less than 80 characters.

Also, my thought was to move the 'see also' entry that is referenced in the existing warning text (the wikipedia link) into the 'security considerations' section, probably as a separate paragraph that consists of the current text that follows that reference, with 'wikipedia article' turned into a link to the actual article.  (See http://docutils.sourceforge.net/docs/user/rst/quickref.html#hyperlink-targets for information on how to make links to external urls in .rst files).

----------

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

From report at bugs.python.org  Thu Mar 13 23:18:12 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 13 Mar 2014 22:18:12 +0000
Subject: [docs] =?utf-8?q?=5Bissue17553=5D_Note_that_distutils=E2=80=99_bd?=
 =?utf-8?q?ist=5Frpm_command_is_not_used_to_build_a_CPython_rpm?=
In-Reply-To: <1364329717.96.0.312657268888.issue17553@psf.upfronthosting.co.za>
Message-ID: <1394749092.52.0.422417015568.issue17553@psf.upfronthosting.co.za>


?ric Araujo added the comment:

On second thought, it seems to me that packagers already know that they should use their usual tool to create a CPython RPM, and I would not want to confuse Python developers with a note in the bdist_rpm doc.

If someone thinks there really should be a note in some README, please reopen the issue.

----------
resolution:  -> rejected
stage: needs patch -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Thu Mar 13 23:34:12 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 13 Mar 2014 22:34:12 +0000
Subject: [docs] [issue6142] distutils2 clean command: Remove extension
	modules built	in-place
In-Reply-To: <1243612271.53.0.396822187567.issue6142@psf.upfronthosting.co.za>
Message-ID: <1394750052.31.0.139085870058.issue6142@psf.upfronthosting.co.za>


?ric Araujo added the comment:

distutils doc now warns about clean not removing extensions built in place.  distutils2 is no more.  Closing.

----------
assignee:  -> docs at python
components: +Documentation -Distutils2
nosy: +docs at python
resolution:  -> out of date
stage: needs patch -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Fri Mar 14 00:33:14 2014
From: report at bugs.python.org (Raymond Hettinger)
Date: Thu, 13 Mar 2014 23:33:14 +0000
Subject: [docs] [issue20902] Which operand is preferred by set operations?
	Missing	information in the documentation
In-Reply-To: <1394661300.29.0.784191218762.issue20902@psf.upfronthosting.co.za>
Message-ID: <1394753594.0.0.578223179423.issue20902@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Mar 14 00:49:36 2014
From: report at bugs.python.org (Raymond Hettinger)
Date: Thu, 13 Mar 2014 23:49:36 +0000
Subject: [docs] [issue20902] Which operand is preferred by set operations?
	Missing	information in the documentation
In-Reply-To: <1394661300.29.0.784191218762.issue20902@psf.upfronthosting.co.za>
Message-ID: <1394754576.88.0.499184076013.issue20902@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

> As far as I can tell currently there is no rule about this. 
> Intersection prefers the second operand, while union prefers the first.

The implementation uses the same logic as found in Lib/sets.py where the intersection operator loops over the SMALLER of the two input sets and does membership testing over the LARGER set.

> In any case, this information should be made explicit in the docs

Not really.  Historically, we've resisted the urge to over-specify or to declare something as undefined.  In general, we make affirmative guarantees when they are useful and when we're prepared to make sure the guarantee will always hold (for example, it took a long while before sorts were guaranteed to be stable).

Another consideration is that for most users, additional notes of "behavior xxx is undefined" is confusing, disconcerting, distracting, and rarely helpful.  Language lawyers tend to request this sort of wording out of some sense of completeness, but it doesn't actually make the docs better for users.

----------

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

From report at bugs.python.org  Fri Mar 14 03:47:25 2014
From: report at bugs.python.org (Kathleen Weaver)
Date: Fri, 14 Mar 2014 02:47:25 +0000
Subject: [docs] [issue20265] Bring Windows docs up to date
In-Reply-To: <1389757265.26.0.116885263001.issue20265@psf.upfronthosting.co.za>
Message-ID: <1394765245.04.0.180017246468.issue20265@psf.upfronthosting.co.za>


Kathleen Weaver added the comment:

I've added a paragraph to the FAQ that refers to the Python Launcher as ?ric Araujo suggested.

So sorry, but new patch.

----------
Added file: http://bugs.python.org/file34409/windowsDoc.patch

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

From report at bugs.python.org  Fri Mar 14 07:34:10 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 14 Mar 2014 06:34:10 +0000
Subject: [docs] [issue20265] Bring Windows docs up to date
In-Reply-To: <1389757265.26.0.116885263001.issue20265@psf.upfronthosting.co.za>
Message-ID: <1394778850.26.0.953380469947.issue20265@psf.upfronthosting.co.za>


Changes by ?ric Araujo <merwok at netwok.org>:


Removed file: http://bugs.python.org/file34386/windowsDoc.patch

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

From report at bugs.python.org  Fri Mar 14 07:34:13 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 14 Mar 2014 06:34:13 +0000
Subject: [docs] [issue20265] Bring Windows docs up to date
In-Reply-To: <1389757265.26.0.116885263001.issue20265@psf.upfronthosting.co.za>
Message-ID: <1394778853.84.0.676206780105.issue20265@psf.upfronthosting.co.za>


Changes by ?ric Araujo <merwok at netwok.org>:


Removed file: http://bugs.python.org/file34403/windowsDoc.patch

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

From report at bugs.python.org  Fri Mar 14 11:44:06 2014
From: report at bugs.python.org (Raymond Hettinger)
Date: Fri, 14 Mar 2014 10:44:06 +0000
Subject: [docs] [issue17006] Warn users about hashing secrets?
In-Reply-To: <1358758082.76.0.415880124971.issue17006@psf.upfronthosting.co.za>
Message-ID: <1394793846.29.0.297954903037.issue17006@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

If something gets added, please follow the dev-guide and word it affirmatively (here the recommended practices) instead of continuing to fill the docs with warnings and danger signs.

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

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

From report at bugs.python.org  Fri Mar 14 11:45:14 2014
From: report at bugs.python.org (Raymond Hettinger)
Date: Fri, 14 Mar 2014 10:45:14 +0000
Subject: [docs] [issue17006] Add advice on best practices for hashing secrets
In-Reply-To: <1358758082.76.0.415880124971.issue17006@psf.upfronthosting.co.za>
Message-ID: <1394793914.33.0.304586270611.issue17006@psf.upfronthosting.co.za>


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


----------
title: Warn users about hashing secrets? -> Add advice on best practices for hashing secrets

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

From report at bugs.python.org  Fri Mar 14 13:55:49 2014
From: report at bugs.python.org (R. David Murray)
Date: Fri, 14 Mar 2014 12:55:49 +0000
Subject: [docs] [issue17006] Add advice on best practices for hashing secrets
In-Reply-To: <1358758082.76.0.415880124971.issue17006@psf.upfronthosting.co.za>
Message-ID: <1394801749.64.0.619821939522.issue17006@psf.upfronthosting.co.za>


R. David Murray added the comment:

Good point.  There is an existing warning for hash weaknesses...the whole thing could be rephrased as "Please see the security considerations section for important information on the considerations involved in using the various hashing algorithms, and notes on best practices for message and password hashing."

The whole thing could then be turned into a note...except that there is a reason that it is a warning, because some of the hashes have known weaknesses yet still must be used for certain things.  So probably it should stay a warning in this particular case.

----------

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

From report at bugs.python.org  Fri Mar 14 14:23:47 2014
From: report at bugs.python.org (Raymond Hettinger)
Date: Fri, 14 Mar 2014 13:23:47 +0000
Subject: [docs] [issue17006] Add advice on best practices for hashing secrets
In-Reply-To: <1358758082.76.0.415880124971.issue17006@psf.upfronthosting.co.za>
Message-ID: <1394803427.42.0.233628026732.issue17006@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

> So probably it should stay a warning in this particular case.

Please don't.  Python's docs have become cluttered with warning and danger signs.  This stands in marked contrast with the docs for other languages which are much cleaner.  Our docs have also started to become "preachy", telling people how we think they should write programs rather than documenting what the language does.

----------

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

From report at bugs.python.org  Fri Mar 14 14:36:42 2014
From: report at bugs.python.org (R. David Murray)
Date: Fri, 14 Mar 2014 13:36:42 +0000
Subject: [docs] [issue17006] Add advice on best practices for hashing secrets
In-Reply-To: <1358758082.76.0.415880124971.issue17006@psf.upfronthosting.co.za>
Message-ID: <1394804202.07.0.945185404402.issue17006@psf.upfronthosting.co.za>


R. David Murray added the comment:

Raymond: I'm not talking about *adding* a warning.

Is it your opinion that the existing warning should be removed?

----------

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

From steve at holdenweb.com  Fri Mar 14 07:07:15 2014
From: steve at holdenweb.com (Steve Holden)
Date: Thu, 13 Mar 2014 23:07:15 -0700
Subject: [docs] http://docs.python.org/3/c-api/unicode.html
Message-ID: <50B8AFEB-2759-4066-BECA-39BB3D701EAE@holdenweb.com>

Under the heading "Character Map Codecs" is a paragraph beginning "This codec is special?".

"This type of codec is special ?" would make more sense since I believe we are effectively describing an interface here.

S


From vadashbengals at spin.net.au  Fri Mar 14 10:06:13 2014
From: vadashbengals at spin.net.au (vadashbengals)
Date: Fri, 14 Mar 2014 19:36:13 +1030
Subject: [docs] help
Message-ID: <15d45345291e011a4e8b2e883a0d518b@angel.comcen.com.au>

 

hi, i'm been trying to install python 3.3.2 on my intel laptop, which
runs windows 7 
but it wont install comes up with an error 
"The system administrator has set policies to prevent this installation"


can you help any way 

thanks 
david 
 
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140314/770ce335/attachment.html>

From report at bugs.python.org  Fri Mar 14 15:50:53 2014
From: report at bugs.python.org (Christian Heimes)
Date: Fri, 14 Mar 2014 14:50:53 +0000
Subject: [docs] [issue17006] Add advice on best practices for hashing secrets
In-Reply-To: <1358758082.76.0.415880124971.issue17006@psf.upfronthosting.co.za>
Message-ID: <1394808653.58.0.187244335443.issue17006@psf.upfronthosting.co.za>


Christian Heimes added the comment:

Raymond makes a good point. We mustn't clutter the docs with warnings. People are going to skip warning boxes if they occur too often. The documentation of the hashlib module contains three "note" boxes and one "warning box". That's far too many.

The first "note" box could be moved to "see also". The other two "note" could be removed and their content added to the documentation of update(). The warning box should follow the example of the ssl module and all further security considerations should be moved into a new section.

The Python stdlib documentation is the wrong place to teach users about crypto and security stuff. But in my opinion good documentation should point out that something is dangerous or may lure a user into false sense of security.

Perhaps I should start a howto with common security-related issues in Python software for 3.5.

----------

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

From report at bugs.python.org  Fri Mar 14 15:54:18 2014
From: report at bugs.python.org (Christian Heimes)
Date: Fri, 14 Mar 2014 14:54:18 +0000
Subject: [docs] [issue20925] Update TLS version connection table
Message-ID: <1394808858.87.0.746121175293.issue20925@psf.upfronthosting.co.za>


New submission from Christian Heimes:

The table at http://docs.python.org/3.4/library/ssl.html#ssl.wrap_socket doesn't contain information for TLS 1.1 and 1.2. I've attached a script that tests connection between all supported SSL protocol versions. (Note: my OpenSSL doesn't support SSLv2).

server     client     can connect
=========  =========  ===========
SSLv23     SSLv23     True
SSLv23     SSLv3      True
SSLv23     TLSv1      True
SSLv23     TLSv1_1    True
SSLv23     TLSv1_2    True
SSLv3      SSLv23     True
SSLv3      SSLv3      True
SSLv3      TLSv1      False
SSLv3      TLSv1_1    False
SSLv3      TLSv1_2    False
TLSv1      SSLv23     True
TLSv1      SSLv3      False
TLSv1      TLSv1      True
TLSv1      TLSv1_1    False
TLSv1      TLSv1_2    False
TLSv1_1    SSLv23     True
TLSv1_1    SSLv3      False
TLSv1_1    TLSv1      False
TLSv1_1    TLSv1_1    True
TLSv1_1    TLSv1_2    False
TLSv1_2    SSLv23     False
TLSv1_2    SSLv3      False
TLSv1_2    TLSv1      False
TLSv1_2    TLSv1_1    False
TLSv1_2    TLSv1_2    True

----------
assignee: docs at python
components: Documentation
files: ssltest.py
messages: 213559
nosy: christian.heimes, docs at python
priority: normal
severity: normal
stage: needs patch
status: open
title: Update TLS version connection table
type: enhancement
versions: Python 3.4, Python 3.5
Added file: http://bugs.python.org/file34417/ssltest.py

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

From report at bugs.python.org  Fri Mar 14 16:03:26 2014
From: report at bugs.python.org (STINNER Victor)
Date: Fri, 14 Mar 2014 15:03:26 +0000
Subject: [docs] [issue20925] Update TLS version connection table
In-Reply-To: <1394808858.87.0.746121175293.issue20925@psf.upfronthosting.co.za>
Message-ID: <1394809406.95.0.208942318565.issue20925@psf.upfronthosting.co.za>


STINNER Victor added the comment:

> The table at http://docs.python.org/3.4/library/ssl.html#ssl.wrap_socket doesn't contain information for TLS 1.1 and 1.2.

Ah? I see "TLSv1  TLSv1.1  TLSv1.2" columns and rows. What is missing?

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

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

From report at bugs.python.org  Fri Mar 14 16:19:36 2014
From: report at bugs.python.org (A.M. Kuchling)
Date: Fri, 14 Mar 2014 15:19:36 +0000
Subject: [docs] [issue17006] Add advice on best practices for hashing secrets
In-Reply-To: <1358758082.76.0.415880124971.issue17006@psf.upfronthosting.co.za>
Message-ID: <1394810376.19.0.095235222354.issue17006@psf.upfronthosting.co.za>


A.M. Kuchling added the comment:

+1 to reducing the number of notes, and to a security HOWTO.  (Christian: if you need writing help, please let me know; I'd be happy to help.)

----------
nosy: +akuchling

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

From report at bugs.python.org  Fri Mar 14 16:47:17 2014
From: report at bugs.python.org (Christian Heimes)
Date: Fri, 14 Mar 2014 15:47:17 +0000
Subject: [docs] [issue20925] Update TLS version connection table
In-Reply-To: <1394808858.87.0.746121175293.issue20925@psf.upfronthosting.co.za>
Message-ID: <1394812037.62.0.396784622711.issue20925@psf.upfronthosting.co.za>


Christian Heimes added the comment:

D'oh. I guess I looked at the http://docs.python.org/3/ docs which still forward to 3.3 and then posted the link to 3.4 ... :|

----------
resolution:  -> invalid
status: open -> closed

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

From report at bugs.python.org  Fri Mar 14 17:56:20 2014
From: report at bugs.python.org (Sreepriya Chalakkal)
Date: Fri, 14 Mar 2014 16:56:20 +0000
Subject: [docs] [issue18566] In unittest.TestCase docs for setUp() and
	tearDown()	don't mention AssertionError
In-Reply-To: <1374901937.1.0.747872580847.issue18566@psf.upfronthosting.co.za>
Message-ID: <1394816180.37.0.43945286667.issue18566@psf.upfronthosting.co.za>


Changes by Sreepriya Chalakkal <sreepriya1111 at gmail.com>:


Added file: http://bugs.python.org/file34420/doc18566.patch

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

From report at bugs.python.org  Fri Mar 14 17:59:45 2014
From: report at bugs.python.org (Jovik)
Date: Fri, 14 Mar 2014 16:59:45 +0000
Subject: [docs] [issue20927] Different behaviour on Posix and Windows when
	using	subprocess.Popen(..., cwd=path)
Message-ID: <1394816385.18.0.912805951896.issue20927@psf.upfronthosting.co.za>


New submission from Jovik:

This works on Linux as expected:
import subprocess
proc = subprocess.Popen(["./app"], stdout=subprocess.PIPE, cwd="workspace")

but on Windows I get:
FileNotFoundError: [WinError 2] The system cannot find the file specified

To successfully execute it on Windows I need to set shell=True first:
proc = subprocess.Popen(["app.exe"], stdout=subprocess.PIPE, cwd="workspace", shell=True)

which is odd since by default it should use cwd when searching for binary:
"If cwd is not None, the function changes the working directory to cwd before executing the child. In particular, the function looks for executable (or for the first item in args) relative to cwd if the executable path is a relative path."
from http://docs.python.org/3.3/library/subprocess.html

----------
assignee: docs at python
components: Documentation
messages: 213570
nosy: Jovik, docs at python
priority: normal
severity: normal
status: open
title: Different behaviour on Posix and Windows when using subprocess.Popen(..., cwd=path)
type: behavior
versions: Python 3.3

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

From report at bugs.python.org  Fri Mar 14 18:10:34 2014
From: report at bugs.python.org (R. David Murray)
Date: Fri, 14 Mar 2014 17:10:34 +0000
Subject: [docs] [issue20927] Different behaviour on Posix and Windows when
	using	subprocess.Popen(..., cwd=path)
In-Reply-To: <1394816385.18.0.912805951896.issue20927@psf.upfronthosting.co.za>
Message-ID: <1394817034.61.0.798617859277.issue20927@psf.upfronthosting.co.za>


R. David Murray added the comment:

Your cwd is relative.  What happens if you make it absolute?  (What I'm thinking is that the non-shell starting cwd may be different on windows than it is on unix...but I don't know windows very well, so this may be irrelevant...)

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

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

From report at bugs.python.org  Fri Mar 14 18:21:09 2014
From: report at bugs.python.org (Antoine Pitrou)
Date: Fri, 14 Mar 2014 17:21:09 +0000
Subject: [docs] [issue20692] Tutorial section 9.4 and FAQ: how to call a
	method on an	int
In-Reply-To: <1392850224.09.0.571764135364.issue20692@psf.upfronthosting.co.za>
Message-ID: <1394817669.88.0.878455855396.issue20692@psf.upfronthosting.co.za>


Antoine Pitrou added the comment:

I am not a native English speaker, but Sreepriya's latest patch looks ok to me (I am not sure the link from classes.rst is useful, though).

Sreepriya, have you already signed the contributor's agreement? Otherwise, you can sign it online at http://www.python.org/psf/contrib/contrib-form/

----------
nosy: +pitrou

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

From report at bugs.python.org  Fri Mar 14 18:38:17 2014
From: report at bugs.python.org (Antoine Pitrou)
Date: Fri, 14 Mar 2014 17:38:17 +0000
Subject: [docs] [issue17006] Add advice on best practices for hashing secrets
In-Reply-To: <1358758082.76.0.415880124971.issue17006@psf.upfronthosting.co.za>
Message-ID: <1394818697.44.0.670009990898.issue17006@psf.upfronthosting.co.za>


Antoine Pitrou added the comment:

Note boxes have nothing to do with warnings, we should discuss them separately if needed.
(I see nothing wrong with multiple notes, given that a note is generally something ancillary and optional)

----------
nosy: +pitrou

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

From report at bugs.python.org  Fri Mar 14 19:11:41 2014
From: report at bugs.python.org (Eric V. Smith)
Date: Fri, 14 Mar 2014 18:11:41 +0000
Subject: [docs] [issue20927] Different behaviour on Posix and Windows when
	using	subprocess.Popen(..., cwd=path)
In-Reply-To: <1394816385.18.0.912805951896.issue20927@psf.upfronthosting.co.za>
Message-ID: <1394820701.78.0.551424288303.issue20927@psf.upfronthosting.co.za>


Changes by Eric V. Smith <eric at trueblade.com>:


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

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

From report at bugs.python.org  Fri Mar 14 19:45:26 2014
From: report at bugs.python.org (R. David Murray)
Date: Fri, 14 Mar 2014 18:45:26 +0000
Subject: [docs] [issue20692] Tutorial section 9.4 and FAQ: how to call a
	method on an	int
In-Reply-To: <1392850224.09.0.571764135364.issue20692@psf.upfronthosting.co.za>
Message-ID: <1394822726.94.0.685872159564.issue20692@psf.upfronthosting.co.za>


R. David Murray added the comment:

I might tweak a couple words for flow, but it looks good.  I do wonder about the repetition of the bit about parenthesis or whitespace that now exists.  I wonder if the first occurrence of it should now be dropped.

----------

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

From report at bugs.python.org  Fri Mar 14 20:08:47 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 14 Mar 2014 19:08:47 +0000
Subject: [docs] [issue20692] Tutorial and FAQ: how to call a method on an int
In-Reply-To: <1392850224.09.0.571764135364.issue20692@psf.upfronthosting.co.za>
Message-ID: <1394824127.07.0.539805437636.issue20692@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

I agree with Antoine about the particular cross-link and would drop that one. Is there somewhere earlier in the tutorial that discusses .attribute access? That would be the place to mention the ints and dotted names. Rather than a link, I would just mention that ints need to be separated from the period.

I also agree with David. Here is a condensed answer that I think says just what is needed.

---
This is because the Python parser sees an integer literal followed by a period as a float literal and a float literal followed by a name, 
``5. __class__``, is a syntax error. To look up an attribute on an integer literal, separate the integer from the period with either a space or parentheses.

    >>> 5 .__class__
    <class 'int'>
    >>> (5).__class__
    <type 'int'>

----------
stage: needs patch -> patch review
title: Tutorial section 9.4 and FAQ: how to call a method on an int -> Tutorial and  FAQ: how to call a method on an int

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

From report at bugs.python.org  Fri Mar 14 20:36:47 2014
From: report at bugs.python.org (Nilovna Bascunan-Vasquez)
Date: Fri, 14 Mar 2014 19:36:47 +0000
Subject: [docs] [issue9364] some problems with the documentation of pydoc
In-Reply-To: <1279949027.26.0.1869842795.issue9364@psf.upfronthosting.co.za>
Message-ID: <1394825807.54.0.412173468769.issue9364@psf.upfronthosting.co.za>


Changes by Nilovna Bascunan-Vasquez <contact at nilovna.com>:


----------
nosy: +nilovna

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

From report at bugs.python.org  Fri Mar 14 22:37:22 2014
From: report at bugs.python.org (Sreepriya Chalakkal)
Date: Fri, 14 Mar 2014 21:37:22 +0000
Subject: [docs] [issue20692] Tutorial and FAQ: how to call a method on an int
In-Reply-To: <1392850224.09.0.571764135364.issue20692@psf.upfronthosting.co.za>
Message-ID: <1394833042.63.0.02597749233.issue20692@psf.upfronthosting.co.za>


Sreepriya Chalakkal added the comment:

In tutorials, under section 3.1.1 - Numbers, it is mentioned about the type of integers. And also a statement as "we will see more about numeric types later in the tutorial". May be we can mention about type class there. But it might be too early to mention about classes under Numbers for a learner. 

Otherwise, I also agree that the cross link is not very essential and could be dropped.

----------

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

From report at bugs.python.org  Fri Mar 14 22:52:06 2014
From: report at bugs.python.org (Jovik)
Date: Fri, 14 Mar 2014 21:52:06 +0000
Subject: [docs] [issue20927] Different behaviour on Posix and Windows when
	using	subprocess.Popen(..., cwd=path)
In-Reply-To: <1394816385.18.0.912805951896.issue20927@psf.upfronthosting.co.za>
Message-ID: <1394833926.53.0.677919380378.issue20927@psf.upfronthosting.co.za>


Jovik added the comment:

I did a test with cwd being set to full path, but the result was the same (still had to use shell=True to execute a command). Let me know if I can provide any more details.

----------

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

From report at bugs.python.org  Sat Mar 15 00:56:39 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 14 Mar 2014 23:56:39 +0000
Subject: [docs] [issue20902] Which operand is preferred by set operations?
	Missing	information in the documentation
In-Reply-To: <1394661300.29.0.784191218762.issue20902@psf.upfronthosting.co.za>
Message-ID: <1394841399.49.0.929605961713.issue20902@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

Defining equality to ignore the .value attribute (and the id), says that they *do not matter*. Python believes you and the interpreter does what it does. If we had made a 'first or second operand wins' claim, we would not have been able to optimize intersection by starting with the smaller set. I may mis-remember but I believe we changed after someone noticed that something like {1] & set(range(10000)) versus set(range(10000)) & {1} had very different run times.

I agree with Raymond that the docs for intersection and union should be left as is.

I could read the doc for A.intersection_update(B) as saying that it keeps all items in A that also appear in B, with appear defined on the basis of ==, so that the result is a subset of the actual items in A. If that is the intent, it could be made clearer.

The doc A.update(B) (union) come close to saying that all items in A remain and items in B not in A get added, so that the result all the items in A. Again, if that is the intent, it could be made explicit, and people who want to determine which operand wins could use the update functions to do so.

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

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

From report at bugs.python.org  Sat Mar 15 01:34:40 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Sat, 15 Mar 2014 00:34:40 +0000
Subject: [docs] [issue17462] argparse FAQ: how it is different from optparse
In-Reply-To: <1363624948.23.0.605198582935.issue17462@psf.upfronthosting.co.za>
Message-ID: <1394843680.97.0.757356630393.issue17462@psf.upfronthosting.co.za>


Changes by ?ric Araujo <merwok at netwok.org>:


----------
nosy: +eric.araujo
versions:  -Python 3.2

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

From report at bugs.python.org  Sat Mar 15 02:40:25 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 15 Mar 2014 01:40:25 +0000
Subject: [docs] [issue20927] Different behaviour on Posix and Windows when
	using	subprocess.Popen(..., cwd=path)
In-Reply-To: <1394816385.18.0.912805951896.issue20927@psf.upfronthosting.co.za>
Message-ID: <1394847624.98.0.663645464644.issue20927@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

I am sure that using / instead of \, which is to say, not using os.sep, is the problem as / is *not* allowed in Windows command names even though the substitution works for paths given as options. In a Windows console,
> python # works
> .\python # works
> ./python # see /python as an option for the . program, which does not exist.

I suspect that shell=True cause subprocess to execute "shell ./app" (howver 'shell' is spelled on the system), with whatever other options and quotation are needed to make ./app work as an option passed to shell instead of a command to be executed directly.

I also suspect that passing ".\\app" might work, which would mean that you should use .%sapp" % os.sep to get a cross-platform string. If so, please close this issue.

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

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

From report at bugs.python.org  Sat Mar 15 03:04:16 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Sat, 15 Mar 2014 02:04:16 +0000
Subject: [docs] [issue20874] Tutorial section on starting python is out of
	date
In-Reply-To: <1394379932.36.0.812758095306.issue20874@psf.upfronthosting.co.za>
Message-ID: <1394849056.14.0.363293018367.issue20874@psf.upfronthosting.co.za>


Changes by ?ric Araujo <merwok at netwok.org>:


----------
nosy: +eric.araujo

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

From report at bugs.python.org  Sat Mar 15 03:04:35 2014
From: report at bugs.python.org (Ned Deily)
Date: Sat, 15 Mar 2014 02:04:35 +0000
Subject: [docs] [issue20931] Confusing section title "New Expected Features
	for	Python Implementations" in 3.4 What's New doc
Message-ID: <1394849075.1.0.404974411409.issue20931@psf.upfronthosting.co.za>


New submission from Ned Deily:

The 3.4 What's New document has a section entitled "New expected features for Python implementations", a title not found in previous releases.  I believe that the intention is to document features expected to be implemented by all Python implementations, including non CPython ones, when they claim to support 3.4.  However, I think the wording is likely to be misunderstood by most readers as meaning "features expected to be in the 3.4 release (including CPython)", leaving a question in their minds as to whether all of the described features are actually in the 3.4 release.  On the other hand, AFAIK, the standard documentation set has never attempted to document all of the deviations from CPython for each particular non-CPython implementation; if the wording is understood as intended, it could be construed as implying something that isn't true.  So, under either reading, the wording can be misleading.  I think it should just be removed or reworded as "New Features".

http://docs.python.org/3.4/whatsnew/3.4.html#summary-release-highlights
http://docs.python.org/3.4/whatsnew/3.4.html#new-expected-features-for-python-implementations

----------
assignee: docs at python
components: Documentation
messages: 213617
nosy: docs at python, larry, ncoghlan, ned.deily
priority: normal
severity: normal
status: open
title: Confusing section title "New Expected Features for Python Implementations" in 3.4 What's New doc
versions: Python 3.4

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

From zachary.ware at gmail.com  Sat Mar 15 05:13:58 2014
From: zachary.ware at gmail.com (zachary.ware at gmail.com)
Date: Sat, 15 Mar 2014 04:13:58 -0000
Subject: [docs] Bring Doc/using/windows up to date (issue 20265)
Message-ID: <20140315041358.7831.56331@psf.upfronthosting.co.za>

This review turned out a lot longer than I expected it to, but we're
moving in the right direction!


http://bugs.python.org/review/20265/diff/11300/Doc/faq/windows.rst
File Doc/faq/windows.rst (right):

http://bugs.python.org/review/20265/diff/11300/Doc/faq/windows.rst#newcode14
Doc/faq/windows.rst:14: XXX need review for Windows Vista/Seven?
Reviewed Windows 7/8 by kw
Better to just remove the comment.  If we have XP and 7 covered, Vista
should be pretty well covered too.  The number of people still stuck
with Vista is pretty small compared to XP and 7+ anyway.

http://bugs.python.org/review/20265/diff/11300/Doc/faq/windows.rst#newcode23
Doc/faq/windows.rst:23: Some users may find that method more efficient
than the below method.
I think adding this paragraph before the next one makes the next one
make less sense.  I think it would be better to segue into this from the
end of the next paragraph, something like "The situation has been made
somewhat simpler since Python 3.3, which introduced the
:ref:`launcher`..."

http://bugs.python.org/review/20265/diff/11300/Doc/faq/windows.rst#newcode49
Doc/faq/windows.rst:49: "command prompt", which usually looks like
this::
Sorry, I wasn't entirely clear.  Lines that you've changed should be
wrapped at <80 characters, but lines that you haven't changed should be
left as is.  If you have to, you can leave a very short line in the
middle of a paragraph, and if it's really bad, the committer can reflow
the paragraph at commit time.

For instance, this paragraph could be left like this:

@@ -37,7 +38,8 @@
 *typing* Windows commands into what is variously referred to as a "DOS
window"
 or "Command prompt window".  Usually you can create such a window from
your
 Start menu; under Windows 7 the menu selection is :menuselection:`Start
-->
-Programs --> Accessories --> Command Prompt`.  You should be able to
recognize
+Programs --> Accessories --> Command Prompt`; under Windows 8 right
click the
+Windows Icon or type Command Prompt at the Start Menu.  You should be
able to
+recognize
 when you have started such a window because you will see a Windows
"command
 prompt", which usually looks like this::

http://bugs.python.org/review/20265/diff/11300/Doc/faq/windows.rst#newcode142
Doc/faq/windows.rst:142: an "Enter" to get out of it). Once you have
verified the directory, you can
This comment about needing Ctrl-Z to exit the interpreter isn't quite
right anymore, there is now exit() and quit().  Since this looks like a
reminder of a previous notice, that previous notice could stand to be
removed (or reworded) as well.

http://bugs.python.org/review/20265/diff/11300/Doc/faq/windows.rst#newcode147
Doc/faq/windows.rst:147: More information about environment variables
and path can be found
The added "and path" doesn't sound right to me, but I can't put my
finger on what's wrong with it.

http://bugs.python.org/review/20265/diff/11300/Doc/faq/windows.rst#newcode357
Doc/faq/windows.rst:357: How do I Change Environment Settings?
I still think we're better off linking to an outside tutorial instead of
trying to teach this one ourselves.

http://bugs.python.org/review/20265/diff/11300/Doc/faq/windows.rst#newcode361
Doc/faq/windows.rst:361: built-in dialog.  There is an alternative
method that works for prior
This isn't true, `set` and `setx` work just as well on 7+.

http://bugs.python.org/review/20265/diff/11300/Doc/faq/windows.rst#newcode375
Doc/faq/windows.rst:375: --> Advanced
This also works for 7, except "My Computer" is just "Computer" and
"Advanced" is "Advanced System Settings" in the left side menu.  I'm
pretty sure it also works on 8, but I've only tried it once and don't
remember for certain.

http://bugs.python.org/review/20265/diff/11300/Doc/faq/windows.rst#newcode378
Doc/faq/windows.rst:378: Windows 7: Right-click the Windows Icon, choose
:menuselection:`Contol Panel`.
What do you mean by "Windows Icon"? Is that the Start Menu button (that
hasn't said 'start' since Vista)?  If I right click on it in 7, I only
get "Properties" and "Open Windows Explorer".

http://bugs.python.org/review/20265/diff/11300/Doc/faq/windows.rst#newcode389
Doc/faq/windows.rst:389: Windows 8: Right-click the Windows Icon, choose
Same question about Windows Icon, though I haven't tested on 8.

http://bugs.python.org/review/20265/diff/11300/Doc/faq/windows.rst#newcode405
Doc/faq/windows.rst:405: Windows 7 and 8 is using the :command:`set`
This is still true for 7 and 8.

http://bugs.python.org/review/20265/diff/11300/Doc/faq/windows.rst#newcode412
Doc/faq/windows.rst:412: this file.
This paragraph should be removed entirely.  It is no longer recommended
to use autoexec.bat, and msconfig has nothing to do with setting
environment variables.  Instead, we should mention `setx`, which will
make the changes in the registry.

http://bugs.python.org/review/20265/diff/11300/Doc/faq/windows.rst#newcode414
Doc/faq/windows.rst:414: Viewing environment variables in all Windows
versions 8.1 and below can also
No need to specify "8.1 and below", since that's all of them (and
unlikely to change for any version of Windows that Python works with).

http://bugs.python.org/review/20265/diff/11300/Doc/faq/windows.rst#newcode415
Doc/faq/windows.rst:415: be done more straight-forward: The command
prompt will expand strings wrapped
Even more straightforward than `echo %var%` is to use `set` without an =
character.  `set` will list all currently set variables, `set abc` will
list all variables that start with "abc" (e.g., `set path` shows PATH
and PATHEXT, `set py` should show all variables that Python cares
about).

http://bugs.python.org/review/20265/diff/11300/Doc/using/windows.rst
File Doc/using/windows.rst (right):

http://bugs.python.org/review/20265/diff/11300/Doc/using/windows.rst#newcode23
Doc/using/windows.rst:23: 
A couple too many blank lines.

http://bugs.python.org/review/20265/diff/11300/Doc/using/windows.rst#newcode26
Doc/using/windows.rst:26: Start Menu under the title Python x.x where
x.x is the version number.
I think there is markup for something that expands to the version number
(`|version|` perhaps?) that would simplify this.  Or just hard code the
version and we'll add it as a place that needs to change at release
time.

http://bugs.python.org/review/20265/diff/11300/Doc/using/windows.rst#newcode28
Doc/using/windows.rst:28: * IDLE (Python GUI) - suitable for creating
and running Python Scripts along with being a command line interpreter
I think IDLE can be better described as "a simple IDE for Python,
written in Python using Tkinter"

http://bugs.python.org/review/20265/diff/11300/Doc/using/windows.rst#newcode32
Doc/using/windows.rst:32: 
The 'Module Docs' entry is missing.

http://bugs.python.org/review/20265/diff/11300/Doc/using/windows.rst#newcode33
Doc/using/windows.rst:33: All versions can be installed and will run
independently. The Windows command
I would reword this to something like "Multiple versions of Python can
be installed next to each other without interfering with each other."

http://bugs.python.org/review/20265/diff/11300/Doc/using/windows.rst#newcode34
Doc/using/windows.rst:34: prompt typically runs the last installed
version of Python.
This isn't really true: Command Prompt runs whichever one it finds first
when it checks PATH for 'python', which will be none of the above unless
you choose to let the installer change your PATH.  I'm not sure how best
to word that for this section, so it may be best to just nix this
sentence and cover it in more detail elsewhere.

http://bugs.python.org/review/20265/diff/11300/Doc/using/windows.rst#newcode60
Doc/using/windows.rst:60: in "`Installing Python"
<http://swaroopch.com/notes/python_en-installation/>`_"
This needs some work; the section in question no longer has "For Windows
users" in its title anywhere, and is "Python: Installation" rather than
"Installing Python".  Also, it looks like this guide doesn't say
anything that we aren't already saying here or in the FAQ.

http://bugs.python.org/review/20265/diff/11300/Doc/using/windows.rst#newcode91
Doc/using/windows.rst:91: Python through the Windows Command line and
set environment variables.
"the Windows Command line" -> "Command Prompt (cmd.exe)"

Also, set which environment variables? Why? Those are the questions we
need to answer here.  Thinking about it some, we don't really even
*need* to set any env vars to use Python, since the installer can take
care of changing PATH and the launcher is installed into a dir that is
*always* on PATH anyway.

http://bugs.python.org/review/20265/diff/11300/Doc/using/windows.rst#newcode97
Doc/using/windows.rst:97: window will close immediately, usually faster
than the user can read.
Both of these lines and several others have trailing whitespace.  You
can get rid of all trailing whitespace with relative ease by running
Tools\scripts\patchcheck.py using a repository build of Python
(PCbuild\python[_d].exe) before creating the patch file for upload.

http://bugs.python.org/review/20265/diff/11300/Doc/using/windows.rst#newcode200
Doc/using/windows.rst:200: #. Launch a command prompt [Windows 8 -
Launch Command Prompt (Admin)]
I still think any change here should be just moving the note about admin
rights from one line up to here.

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

From report at bugs.python.org  Sat Mar 15 06:28:15 2014
From: report at bugs.python.org (Nick Coghlan)
Date: Sat, 15 Mar 2014 05:28:15 +0000
Subject: [docs] [issue20931] Confusing section title "New Expected Features
	for	Python Implementations" in 3.4 What's New doc
In-Reply-To: <1394849075.1.0.404974411409.issue20931@psf.upfronthosting.co.za>
Message-ID: <CADiSq7cPoVAk5odFvw5yiW1ZeTx0CkoSnuCgHn0-sp32P-5CRA@mail.gmail.com>


Nick Coghlan added the comment:

The idea was to add a category for core interpreter behavioural changes
that aren't language or standard library changes. Inspiration just failed
me completely when coming up with a title for it, hence the current
monstrosity.

Something generic like "Changes to interpreter behaviour" might work.

----------

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

From report at bugs.python.org  Sat Mar 15 06:31:54 2014
From: report at bugs.python.org (Nitika Agarwal)
Date: Sat, 15 Mar 2014 05:31:54 +0000
Subject: [docs] [issue17188] Document 'from None' in raise statement doc.
In-Reply-To: <1360631999.8.0.76627095073.issue17188@psf.upfronthosting.co.za>
Message-ID: <1394861514.11.0.569092608058.issue17188@psf.upfronthosting.co.za>


Nitika Agarwal added the comment:

Hi,
As suggested by Petri,I have made some changes.
Please review the attached patch.Any comments and feedback are welcome.

----------
nosy: +nitika
Added file: http://bugs.python.org/file34431/issue17188.patch

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

From report at bugs.python.org  Sat Mar 15 07:38:07 2014
From: report at bugs.python.org (Nitika Agarwal)
Date: Sat, 15 Mar 2014 06:38:07 +0000
Subject: [docs] [issue17188] Document 'from None' in raise statement doc.
In-Reply-To: <1360631999.8.0.76627095073.issue17188@psf.upfronthosting.co.za>
Message-ID: <1394865487.15.0.887062999499.issue17188@psf.upfronthosting.co.za>


Changes by Nitika Agarwal <nitikaagarwal18 at gmail.com>:


Removed file: http://bugs.python.org/file34431/issue17188.patch

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

From report at bugs.python.org  Sat Mar 15 07:41:41 2014
From: report at bugs.python.org (Nitika Agarwal)
Date: Sat, 15 Mar 2014 06:41:41 +0000
Subject: [docs] [issue17188] Document 'from None' in raise statement doc.
In-Reply-To: <1360631999.8.0.76627095073.issue17188@psf.upfronthosting.co.za>
Message-ID: <1394865701.32.0.986836225935.issue17188@psf.upfronthosting.co.za>


Changes by Nitika Agarwal <nitikaagarwal18 at gmail.com>:


Added file: http://bugs.python.org/file34432/issue17188.patch

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

From report at bugs.python.org  Sat Mar 15 09:01:34 2014
From: report at bugs.python.org (Jovik)
Date: Sat, 15 Mar 2014 08:01:34 +0000
Subject: [docs] [issue20927] Different behaviour on Posix and Windows when
	using	subprocess.Popen(..., cwd=path)
In-Reply-To: <1394816385.18.0.912805951896.issue20927@psf.upfronthosting.co.za>
Message-ID: <1394870494.51.0.715046392804.issue20927@psf.upfronthosting.co.za>


Jovik added the comment:

I'm quite aware of the os.sep issues between the systems, but I checked both out of curiosity. Here are latest results:

All of the following commands raises the same exception:
>>> proc = subprocess.Popen("plink", stdout=subprocess.PIPE, cwd="c:\\python33\\workspace")
>>> proc = subprocess.Popen("plink", stdout=subprocess.PIPE, cwd="c:\\python33\\workspace\\")
>>> proc = subprocess.Popen(".\plink", stdout=subprocess.PIPE, cwd="c:\python33\workspace")
>>> proc = subprocess.Popen(".\\plink", stdout=subprocess.PIPE, cwd="c:\\python33\\workspace")
>>> proc = subprocess.Popen("plink", stdout=subprocess.PIPE, cwd="c:/python33/workspace")

Traceback (most recent call last):
  File "C:\Python33\lib\subprocess.py", line 1104, in _execute_child
    startupinfo)
FileNotFoundError: [WinError 2] The system cannot find the file specified

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "C:\Python33\lib\subprocess.py", line 819, in __init__
    restore_signals, start_new_session)
  File "C:\Python33\lib\subprocess.py", line 1110, in _execute_child
    raise WindowsError(*e.args)
FileNotFoundError: [WinError 2] The system cannot find the file specified

But, when I set shell=True, then everything works just fine:
>>> proc = subprocess.Popen("plink", stdout=subprocess.PIPE, cwd="c:\python33\workspace", shell=True)
>>> proc = subprocess.Popen(".\plink", stdout=subprocess.PIPE, cwd="c:\\python33\\workspace", shell=True)
>>> proc = subprocess.Popen(".\\plink", stdout=subprocess.PIPE, cwd="c:\\python33\\workspace", shell=True)
>>> proc = subprocess.Popen("plink", stdout=subprocess.PIPE, cwd="c:/python33/workspace", shell=True)
I can get plink's output afterwards with proc.communicate()

----------

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

From report at bugs.python.org  Sat Mar 15 09:14:26 2014
From: report at bugs.python.org (Ned Deily)
Date: Sat, 15 Mar 2014 08:14:26 +0000
Subject: [docs] [issue20931] Confusing section title "New Expected Features
	for	Python Implementations" in 3.4 What's New doc
In-Reply-To: <1394849075.1.0.404974411409.issue20931@psf.upfronthosting.co.za>
Message-ID: <1394871266.89.0.154708549765.issue20931@psf.upfronthosting.co.za>


Changes by Ned Deily <nad at acm.org>:


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

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

From georg at python.org  Sat Mar 15 10:12:26 2014
From: georg at python.org (Georg Brandl)
Date: Sat, 15 Mar 2014 10:12:26 +0100
Subject: [docs] Typo or poor example on page
	docs.python.org/2/library/copy.html
In-Reply-To: <CACfWjvDg9bJpxLEGg_nQuW2jhopG8_SqnUTYKZj6Wx+v+o8brw@mail.gmail.com>
References: <CACfWjvDg9bJpxLEGg_nQuW2jhopG8_SqnUTYKZj6Wx+v+o8brw@mail.gmail.com>
Message-ID: <5324197A.6090308@python.org>

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

Am 07.03.2014 17:59, schrieb Daniel Thomson:
> On http://docs.python.org/2/library/copy.html I found the following
> passage:
> 
> 
> """
> 
> Two problems often exist with deep copy operations that don?t exist with
> shallow copy operations:
> 
> 
> Recursive objects (compound objects that, directly or indirectly, contain
> a reference to themselves) may cause a recursive loop.
> 
> Because deep copy copies everything it may copy too much, e.g.,
> administrative data structures that should be shared even between copies.
> 
> """
> 
> 
> I believe that last sentience should read, "... administrative data
> structures that should not be shared even between copies."
> 
> 
> If the administrative data structures should be shared even between copies,
> then it is a very poor example of a problem caused by deepcopy(). It would
> instead be a very good reason to use deepcopy().

Hi Daniel,

thanks for your email.  I don't see your problem though; if the administrative
structures should be shared, deepcopy() would violate that requirement.

cheers,
Georg
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.22 (GNU/Linux)

iEYEARECAAYFAlMkGXoACgkQN9GcIYhpnLADOACggoEHOmWlwgK0ulEdvtjwjlhA
C9wAn28tNM+GfBFpGUXAVZyuiMjcqp3M
=uHJe
-----END PGP SIGNATURE-----

From report at bugs.python.org  Sat Mar 15 10:13:41 2014
From: report at bugs.python.org (Georg Brandl)
Date: Sat, 15 Mar 2014 09:13:41 +0000
Subject: [docs] [issue12901] Nest class/methods directives in documentation
In-Reply-To: <1315241119.9.0.996780726209.issue12901@psf.upfronthosting.co.za>
Message-ID: <1394874821.4.0.742226584977.issue12901@psf.upfronthosting.co.za>


Changes by Georg Brandl <georg at python.org>:


----------
resolution:  -> works for me
status: open -> closed

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

From report at bugs.python.org  Sat Mar 15 12:52:16 2014
From: report at bugs.python.org (Eric V. Smith)
Date: Sat, 15 Mar 2014 11:52:16 +0000
Subject: [docs] [issue20927] Different behaviour on Posix and Windows when
	using	subprocess.Popen(..., cwd=path)
In-Reply-To: <1394816385.18.0.912805951896.issue20927@psf.upfronthosting.co.za>
Message-ID: <1394884336.24.0.280247855695.issue20927@psf.upfronthosting.co.za>


Eric V. Smith added the comment:

In the first example, you switch from "./app" to "app.exe" when using shell=True.

What happens to any of your examples if you add ".exe" without shell=True?

Popen eventually calls CreateProcess on Windows. From: http://msdn.microsoft.com/en-us/library/windows/desktop/ms682425(v=vs.85).aspx, describing the lpApplicationName  parameter: "This parameter must include the file name extension; no default extension is assumed."

Running the shell though, you don't need the extension.

----------

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

From report at bugs.python.org  Sat Mar 15 12:55:14 2014
From: report at bugs.python.org (Eric V. Smith)
Date: Sat, 15 Mar 2014 11:55:14 +0000
Subject: [docs] [issue20927] Different behaviour on Posix and Windows when
	using	subprocess.Popen(..., cwd=path)
In-Reply-To: <1394816385.18.0.912805951896.issue20927@psf.upfronthosting.co.za>
Message-ID: <1394884514.51.0.292578650601.issue20927@psf.upfronthosting.co.za>


Eric V. Smith added the comment:

Assuming this is the problem, we should at least document this. It does make cross-platform coding difficult.

----------

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

From report at bugs.python.org  Sat Mar 15 15:57:29 2014
From: report at bugs.python.org (Kathleen Weaver)
Date: Sat, 15 Mar 2014 14:57:29 +0000
Subject: [docs] [issue20927] Different behaviour on Posix and Windows when
	using	subprocess.Popen(..., cwd=path)
In-Reply-To: <1394816385.18.0.912805951896.issue20927@psf.upfronthosting.co.za>
Message-ID: <1394895449.25.0.0872634941942.issue20927@psf.upfronthosting.co.za>


Changes by Kathleen Weaver <kathleen at kweaver.org>:


----------
nosy: +kathweaver

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

From report at bugs.python.org  Sat Mar 15 17:38:54 2014
From: report at bugs.python.org (R. David Murray)
Date: Sat, 15 Mar 2014 16:38:54 +0000
Subject: [docs] [issue20931] Confusing section title "New Expected Features
	for	Python Implementations" in 3.4 What's New doc
In-Reply-To: <1394849075.1.0.404974411409.issue20931@psf.upfronthosting.co.za>
Message-ID: <1394901534.76.0.789789713224.issue20931@psf.upfronthosting.co.za>


R. David Murray added the comment:

How about "Interpreter Improvements"?  The marshall format change isn't exactly a behavior change, but other implementations will need to be able to cope with it.  Or should that be moved to Library changes?

----------

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

From report at bugs.python.org  Sat Mar 15 18:42:12 2014
From: report at bugs.python.org (py.user)
Date: Sat, 15 Mar 2014 17:42:12 +0000
Subject: [docs] [issue18566] In unittest.TestCase docs for setUp() and
	tearDown()	don't mention AssertionError
In-Reply-To: <1374901937.1.0.747872580847.issue18566@psf.upfronthosting.co.za>
Message-ID: <1394905332.77.0.888250251204.issue18566@psf.upfronthosting.co.za>


py.user added the comment:

In proposed patches fix

Skiptest -> :exc:`SkipTest`
AssertionError -> :exc:`AssertionError`

----------

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

From report at bugs.python.org  Sat Mar 15 19:05:49 2014
From: report at bugs.python.org (Ned Deily)
Date: Sat, 15 Mar 2014 18:05:49 +0000
Subject: [docs] [issue20931] Confusing section title "New Expected Features
	for	Python Implementations" in 3.4 What's New doc
In-Reply-To: <1394849075.1.0.404974411409.issue20931@psf.upfronthosting.co.za>
Message-ID: <1394906749.51.0.906689270467.issue20931@psf.upfronthosting.co.za>


Ned Deily added the comment:

I think "New Features" works better.

----------

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

From report at bugs.python.org  Sat Mar 15 19:25:05 2014
From: report at bugs.python.org (Nitika Agarwal)
Date: Sat, 15 Mar 2014 18:25:05 +0000
Subject: [docs] [issue17188] Document 'from None' in raise statement doc.
In-Reply-To: <1360631999.8.0.76627095073.issue17188@psf.upfronthosting.co.za>
Message-ID: <1394907905.53.0.987822916459.issue17188@psf.upfronthosting.co.za>


Changes by Nitika Agarwal <nitikaagarwal18 at gmail.com>:


Removed file: http://bugs.python.org/file34432/issue17188.patch

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

From report at bugs.python.org  Sat Mar 15 19:27:07 2014
From: report at bugs.python.org (Nitika Agarwal)
Date: Sat, 15 Mar 2014 18:27:07 +0000
Subject: [docs] [issue17188] Document 'from None' in raise statement doc.
In-Reply-To: <1360631999.8.0.76627095073.issue17188@psf.upfronthosting.co.za>
Message-ID: <1394908027.31.0.797115877031.issue17188@psf.upfronthosting.co.za>


Changes by Nitika Agarwal <nitikaagarwal18 at gmail.com>:


Added file: http://bugs.python.org/file34434/issue17188.patch

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

From report at bugs.python.org  Sat Mar 15 19:27:45 2014
From: report at bugs.python.org (Jessica McKellar)
Date: Sat, 15 Mar 2014 18:27:45 +0000
Subject: [docs] [issue16665] doc for builtin hex() is poor
In-Reply-To: <1355257997.08.0.0348964643873.issue16665@psf.upfronthosting.co.za>
Message-ID: <1394908065.4.0.0845887304932.issue16665@psf.upfronthosting.co.za>


Jessica McKellar added the comment:

Thanks for the patch, Michael!

There's a small doc build issue with your patch: the note on int shows up inside the code block for the examples.

In response to rhettinger's feedback I've attached a slightly more compact patch that hits the highlights. I checked that the docs build cleanly with the patch and that the output looks visually as expected.

I think both patches are an improvement over the current docs.

=> review

----------
nosy: +jesstess
stage: needs patch -> patch review
Added file: http://bugs.python.org/file34435/issue16665_2.patch

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

From report at bugs.python.org  Sat Mar 15 19:31:27 2014
From: report at bugs.python.org (Ben W.)
Date: Sat, 15 Mar 2014 18:31:27 +0000
Subject: [docs] [issue20938] Broken link to editors page in General FAQ
Message-ID: <1394908287.36.0.782138888196.issue20938@psf.upfronthosting.co.za>


New submission from Ben W.:

The link to http://www.python.org/editors/ at the bottom of the answer to "Is Python a good language for beginning programmers?" in the General Python FAQ is broken.

----------
assignee: docs at python
components: Documentation
messages: 213671
nosy: docs at python, lopsided98
priority: normal
severity: normal
status: open
title: Broken link to editors page in General FAQ
type: enhancement
versions: Python 3.5

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

From report at bugs.python.org  Sat Mar 15 19:53:46 2014
From: report at bugs.python.org (Ned Deily)
Date: Sat, 15 Mar 2014 18:53:46 +0000
Subject: [docs] [issue20938] Broken link to editors page in General FAQ
In-Reply-To: <1394908287.36.0.782138888196.issue20938@psf.upfronthosting.co.za>
Message-ID: <1394909626.64.0.286720465503.issue20938@psf.upfronthosting.co.za>


Ned Deily added the comment:

Thanks for the report.  This is an issue with the new python.org website.  I've opened an issue on the website tracker on your behalf:  https://github.com/python/pythondotorg/issues/304

----------
nosy: +ned.deily
resolution:  -> 3rd party
stage:  -> committed/rejected
type: enhancement -> 
versions:  -Python 3.5

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

From report at bugs.python.org  Sat Mar 15 20:12:56 2014
From: report at bugs.python.org (Sreepriya Chalakkal)
Date: Sat, 15 Mar 2014 19:12:56 +0000
Subject: [docs] [issue17110] sys.argv docs should explaining how to handle
	encoding	issues
In-Reply-To: <1359864071.69.0.659089821533.issue17110@psf.upfronthosting.co.za>
Message-ID: <1394910776.29.0.957433192357.issue17110@psf.upfronthosting.co.za>


Sreepriya Chalakkal added the comment:

I tried running with Python 3.4 the following code

import sys

print(sys.argv[1])
print(b'bytes')

And I ran as follows trying to run with a different encoding. 
$ python ~/a.py `echo priya|iconv -t latin1`
priya
bytes

There was no unicode encode error generated! Is it because the problem is fixed?

----------
nosy: +sreepriya

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

From report at bugs.python.org  Sat Mar 15 21:19:39 2014
From: report at bugs.python.org (Benjamin Peterson)
Date: Sat, 15 Mar 2014 20:19:39 +0000
Subject: [docs] [issue20938] Broken link to editors page in General FAQ
In-Reply-To: <1394908287.36.0.782138888196.issue20938@psf.upfronthosting.co.za>
Message-ID: <1394914779.18.0.515383479955.issue20938@psf.upfronthosting.co.za>


Changes by Benjamin Peterson <bp+pybugs at benjamin-peterson.org>:


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

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

From report at bugs.python.org  Sat Mar 15 21:24:30 2014
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 15 Mar 2014 20:24:30 +0000
Subject: [docs] [issue20938] Broken link to editors page in General FAQ
In-Reply-To: <1394908287.36.0.782138888196.issue20938@psf.upfronthosting.co.za>
Message-ID: <3fmZxm707Kz7LjX@mail.python.org>


Roundup Robot added the comment:

New changeset 772404a89b88 by Benjamin Peterson in branch '2.7':
send people to the right editors page (#20938)
http://hg.python.org/cpython/rev/772404a89b88

New changeset 014c2a62c168 by Benjamin Peterson in branch '3.3':
send people to the right editors page (#20938)
http://hg.python.org/cpython/rev/014c2a62c168

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

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

From report at bugs.python.org  Sat Mar 15 21:28:56 2014
From: report at bugs.python.org (Raymond Hettinger)
Date: Sat, 15 Mar 2014 20:28:56 +0000
Subject: [docs] [issue16665] doc for builtin hex() is poor
In-Reply-To: <1355257997.08.0.0348964643873.issue16665@psf.upfronthosting.co.za>
Message-ID: <1394915336.74.0.41580797472.issue16665@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

Approved.  You can go ahead and apply this.

----------
assignee: rhettinger -> jesstess

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

From report at bugs.python.org  Sat Mar 15 21:52:23 2014
From: report at bugs.python.org (Raymond Hettinger)
Date: Sat, 15 Mar 2014 20:52:23 +0000
Subject: [docs] [issue20902] Which operand is preferred by set operations?
	Missing	information in the documentation
In-Reply-To: <1394661300.29.0.784191218762.issue20902@psf.upfronthosting.co.za>
Message-ID: <1394916743.0.0.408749687909.issue20902@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

Thanks Terry.  

And yes, your reading of the set.update() docs is correct, "Update the set, adding elements from all others" means that it updates the set by adding the elements from the other sets.

FWIW, getting into details about "which value wins" goes against the core concept of the data structure.  Sets (in a mathematical sense) are about treating elements of an equivalence class as being identical.  We intentionally treat {1, 1.1} as being of length one and equal to {1.1, 1} eventhough the integer 1 and the float 1.0 are actually distinguishable in ways not tested by equality.

This isn't just a concept with sets.  The dict.update() method works similarly as does other container operations that depend on a notion of equivalence that is independent of other distinctive traits (object identity, attached values, type, etc).

----------
resolution:  -> invalid
status: open -> closed

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

From report at bugs.python.org  Sat Mar 15 22:45:23 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 15 Mar 2014 21:45:23 +0000
Subject: [docs] [issue16665] doc for builtin hex() is poor
In-Reply-To: <1355257997.08.0.0348964643873.issue16665@psf.upfronthosting.co.za>
Message-ID: <1394919923.62.0.566701386017.issue16665@psf.upfronthosting.co.za>


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


----------
versions:  -Python 3.2

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

From report at bugs.python.org  Sun Mar 16 00:29:32 2014
From: report at bugs.python.org (Kathleen Weaver)
Date: Sat, 15 Mar 2014 23:29:32 +0000
Subject: [docs] [issue20265] Bring Windows docs up to date
In-Reply-To: <1389757265.26.0.116885263001.issue20265@psf.upfronthosting.co.za>
Message-ID: <1394926170.79.0.63686854009.issue20265@psf.upfronthosting.co.za>


Kathleen Weaver added the comment:

I've gone through everything and cleaned things up per zach.ware review.

----------
Added file: http://bugs.python.org/file34437/kweaver.patch

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

From report at bugs.python.org  Sun Mar 16 02:17:04 2014
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 16 Mar 2014 01:17:04 +0000
Subject: [docs] [issue16665] doc for builtin hex() is poor
In-Reply-To: <1355257997.08.0.0348964643873.issue16665@psf.upfronthosting.co.za>
Message-ID: <3fmjRB4CLLz7LjP@mail.python.org>


Roundup Robot added the comment:

New changeset 464c22bf9fe1 by Antoine Pitrou in branch '3.3':
Close #16665: improve documentation for hex().  Patch by Jessica McKellar.
http://hg.python.org/cpython/rev/464c22bf9fe1

New changeset d14beaf03f55 by Antoine Pitrou in branch '2.7':
Close #16665: improve documentation for hex().  Patch by Jessica McKellar.
http://hg.python.org/cpython/rev/d14beaf03f55

New changeset c267f4eb8173 by Antoine Pitrou in branch 'default':
Close #16665: improve documentation for hex().  Patch by Jessica McKellar.
http://hg.python.org/cpython/rev/c267f4eb8173

----------
nosy: +python-dev
resolution:  -> fixed
stage: patch review -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Sun Mar 16 02:20:05 2014
From: report at bugs.python.org (Antoine Pitrou)
Date: Sun, 16 Mar 2014 01:20:05 +0000
Subject: [docs] [issue16665] doc for builtin hex() is poor
In-Reply-To: <1355257997.08.0.0348964643873.issue16665@psf.upfronthosting.co.za>
Message-ID: <1394932805.17.0.410436512395.issue16665@psf.upfronthosting.co.za>


Antoine Pitrou added the comment:

Jessica doesn't have commit rights, so I committed this myself.
Also added an example of the funny hex(long) behaviour in Python 2.

----------
nosy: +pitrou

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

From report at bugs.python.org  Sun Mar 16 02:54:01 2014
From: report at bugs.python.org (Antoine Pitrou)
Date: Sun, 16 Mar 2014 01:54:01 +0000
Subject: [docs] [issue17110] sys.argv docs should explaining how to handle
	encoding	issues
In-Reply-To: <1359864071.69.0.659089821533.issue17110@psf.upfronthosting.co.za>
Message-ID: <1394934841.39.0.715073359011.issue17110@psf.upfronthosting.co.za>


Antoine Pitrou added the comment:

> There was no unicode encode error generated! Is it because the problem 
> is fixed?

No, it's not fixed.
First, it seems you are testing with Python 2 (otherwise you would get "b'bytes'", not "bytes"). Python 2 won't have a problem here, since it treats everything as bytestrings.
Second, to evidence the issue you must pass a non-ASCII string. For example:

$ ./python a.py `echo ?l?phant|iconv -t latin1`
Traceback (most recent call last):
  File "a.py", line 4, in <module>
    print(sys.argv[1])
UnicodeEncodeError: 'utf-8' codec can't encode character '\udce9' in position 0: surrogates not allowed

----------
nosy: +pitrou

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

From report at bugs.python.org  Sun Mar 16 03:11:34 2014
From: report at bugs.python.org (Nick Coghlan)
Date: Sun, 16 Mar 2014 02:11:34 +0000
Subject: [docs] [issue20931] Confusing section title "New Expected Features
	for	Python Implementations" in 3.4 What's New doc
In-Reply-To: <1394849075.1.0.404974411409.issue20931@psf.upfronthosting.co.za>
Message-ID: <1394935894.23.0.53632601313.issue20931@psf.upfronthosting.co.za>


Nick Coghlan added the comment:

Rereading that section (it has currently been adjusted to say "New Features"), I suggest:

- consistently using sentence case for those list headings
- tweaking that particular heading to say "Other new features:" (to contrast with the "New syntax features:" heading just above)
- losing the scare quotes from 'pip should always be "available"' (being a distro package install away counts as available in my book)

----------

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

From report at bugs.python.org  Sun Mar 16 03:51:43 2014
From: report at bugs.python.org (Larry Hastings)
Date: Sun, 16 Mar 2014 02:51:43 +0000
Subject: [docs] [issue20931] Confusing section title "New Expected Features
	for	Python Implementations" in 3.4 What's New doc
In-Reply-To: <1394849075.1.0.404974411409.issue20931@psf.upfronthosting.co.za>
Message-ID: <1394938303.06.0.0918797510537.issue20931@psf.upfronthosting.co.za>


Larry Hastings added the comment:

RDM's checkin ( 21ecc3d52806 ) renamed the subheading of "Summary -- Release Highlights" from "New Expected Features for Python Implementations" to "New features".  But there's still a major heading with that title.  Surely we want to rename that one too?

----------

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

From report at bugs.python.org  Sun Mar 16 04:12:27 2014
From: report at bugs.python.org (Larry Hastings)
Date: Sun, 16 Mar 2014 03:12:27 +0000
Subject: [docs] [issue20931] Confusing section title "New Expected Features
	for	Python Implementations" in 3.4 What's New doc
In-Reply-To: <1394849075.1.0.404974411409.issue20931@psf.upfronthosting.co.za>
Message-ID: <1394939547.21.0.553197092739.issue20931@psf.upfronthosting.co.za>


Larry Hastings added the comment:

I propose to check this in.

----------
keywords: +patch
Added file: http://bugs.python.org/file34438/larry.remove.other.instance.of.clumsy.wording.1.diff

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

From report at bugs.python.org  Sun Mar 16 04:14:23 2014
From: report at bugs.python.org (Ned Deily)
Date: Sun, 16 Mar 2014 03:14:23 +0000
Subject: [docs] [issue20931] Confusing section title "New Expected Features
	for	Python Implementations" in 3.4 What's New doc
In-Reply-To: <1394849075.1.0.404974411409.issue20931@psf.upfronthosting.co.za>
Message-ID: <1394939663.33.0.518506748582.issue20931@psf.upfronthosting.co.za>


Ned Deily added the comment:

LGTM

----------

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

From report at bugs.python.org  Sun Mar 16 04:16:00 2014
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 16 Mar 2014 03:16:00 +0000
Subject: [docs] [issue20931] Confusing section title "New Expected Features
	for	Python Implementations" in 3.4 What's New doc
In-Reply-To: <1394849075.1.0.404974411409.issue20931@psf.upfronthosting.co.za>
Message-ID: <3fmm4b6dZpz7LjM@mail.python.org>


Roundup Robot added the comment:

New changeset 3488a9fbe09e by Larry Hastings in branch 'default':
Issue #20931: Fix other confusingly-worded heading.
http://hg.python.org/cpython/rev/3488a9fbe09e

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

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

From report at bugs.python.org  Sun Mar 16 04:31:25 2014
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 16 Mar 2014 03:31:25 +0000
Subject: [docs] [issue20931] Confusing section title "New Expected Features
	for	Python Implementations" in 3.4 What's New doc
In-Reply-To: <1394849075.1.0.404974411409.issue20931@psf.upfronthosting.co.za>
Message-ID: <3fmmQN6TRpz7LjT@mail.python.org>


Roundup Robot added the comment:

New changeset 7e78e602ec73 by R David Murray in branch 'default':
whatsnew: Fix Features section title, use title/sentence case consistently.
http://hg.python.org/cpython/rev/7e78e602ec73

----------
resolution:  -> fixed
stage:  -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Sun Mar 16 05:40:38 2014
From: report at bugs.python.org (Nitika Agarwal)
Date: Sun, 16 Mar 2014 04:40:38 +0000
Subject: [docs] [issue18478] Class bodies: when does a name become local?
In-Reply-To: <1374017954.45.0.193690883208.issue18478@psf.upfronthosting.co.za>
Message-ID: <1394944838.81.0.658369327164.issue18478@psf.upfronthosting.co.za>


Nitika Agarwal added the comment:

Hey.
I am working on this patch.

----------
nosy: +nitika

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

From report at bugs.python.org  Sun Mar 16 05:41:29 2014
From: report at bugs.python.org (Nitika Agarwal)
Date: Sun, 16 Mar 2014 04:41:29 +0000
Subject: [docs] [issue4744] asynchat documentation needs to be more precise
In-Reply-To: <1230168171.56.0.381937953807.issue4744@psf.upfronthosting.co.za>
Message-ID: <1394944888.88.0.523397680586.issue4744@psf.upfronthosting.co.za>


Nitika Agarwal added the comment:

Hi,
I would like to propose a patch for this issue.

----------
nosy: +nitika

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

From report at bugs.python.org  Sun Mar 16 16:10:55 2014
From: report at bugs.python.org (Tshepang Lekhonkhobe)
Date: Sun, 16 Mar 2014 15:10:55 +0000
Subject: [docs] [issue20906] Issues in Unicode HOWTO
In-Reply-To: <1394702187.81.0.00522221343959.issue20906@psf.upfronthosting.co.za>
Message-ID: <1394982655.13.0.978347815384.issue20906@psf.upfronthosting.co.za>


Changes by Tshepang Lekhonkhobe <tshepang at gmail.com>:


----------
nosy: +tshepang

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

From report at bugs.python.org  Sun Mar 16 17:54:09 2014
From: report at bugs.python.org (Nitika Agarwal)
Date: Sun, 16 Mar 2014 16:54:09 +0000
Subject: [docs] [issue18478] Class bodies: when does a name become local?
In-Reply-To: <1374017954.45.0.193690883208.issue18478@psf.upfronthosting.co.za>
Message-ID: <1394988849.1.0.681455561272.issue18478@psf.upfronthosting.co.za>


Nitika Agarwal added the comment:

Hi,
Please review my patch attached.

----------
keywords: +patch
Added file: http://bugs.python.org/file34441/issue18478.patch

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

From report at bugs.python.org  Sun Mar 16 17:57:21 2014
From: report at bugs.python.org (Nitika Agarwal)
Date: Sun, 16 Mar 2014 16:57:21 +0000
Subject: [docs] [issue4744] asynchat documentation needs to be more precise
In-Reply-To: <1230168171.56.0.381937953807.issue4744@psf.upfronthosting.co.za>
Message-ID: <1394989041.57.0.0516849828199.issue4744@psf.upfronthosting.co.za>


Nitika Agarwal added the comment:

Hi,
Please review my patch attached.Any comments and feedback are welcome.

----------
keywords: +patch
Added file: http://bugs.python.org/file34442/issue4744_2.patch

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

From report at bugs.python.org  Sun Mar 16 18:35:54 2014
From: report at bugs.python.org (Antoine Pitrou)
Date: Sun, 16 Mar 2014 17:35:54 +0000
Subject: [docs] [issue20906] Issues in Unicode HOWTO
In-Reply-To: <1394702187.81.0.00522221343959.issue20906@psf.upfronthosting.co.za>
Message-ID: <1394991353.94.0.269076567873.issue20906@psf.upfronthosting.co.za>


Antoine Pitrou added the comment:

Do you want to provide a patch?

> In a narrative such as the current article, a code point value is usually written in hexadecimal.

I find use of the word "narrative" intimidating in the context of a technical documentation.

In general, I find it disappointing that the Unicode HOWTO only gives hexadecimal representations of non-ASCII characters and (almost) never represents them in their true form. This makes things more abstract than necessary.

> This is a vague claim. Probably what was intended was: "Many Internet standards define protocols in which the data must contain no zero bytes, or zero bytes have special meaning."  Is this actually true? Are there "many" such standards?

I think it actually means that Internet protocols assume an ASCII-compatible encoding (which UTF-8 is, but not UTF-16 or UTF-32 - nor EBCDIC :-)).

> --> "Non-Unicode code systems usually don't handle all of the characters to be found in Unicode."

The term *encoding* is used pervasively when dealing with the transformation of unicode to/from bytes, so I find it confusing to introduce another term here ("code systems"). I prefer the original sentence.

----------
nosy: +akuchling

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

From report at bugs.python.org  Sun Mar 16 19:26:01 2014
From: report at bugs.python.org (Nitika Agarwal)
Date: Sun, 16 Mar 2014 18:26:01 +0000
Subject: [docs] [issue17383] Possibly ambiguous phrasing
	in	tutorial/modules#more-on-modules
In-Reply-To: <1362700500.92.0.448355159104.issue17383@psf.upfronthosting.co.za>
Message-ID: <1394994361.2.0.41682038613.issue17383@psf.upfronthosting.co.za>


Nitika Agarwal added the comment:

Hi,
I would like to propose a patch for this issue.

----------
nosy: +nitika

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

From report at bugs.python.org  Sun Mar 16 21:04:18 2014
From: report at bugs.python.org (Nitika Agarwal)
Date: Sun, 16 Mar 2014 20:04:18 +0000
Subject: [docs] [issue17383] Possibly ambiguous phrasing
	in	tutorial/modules#more-on-modules
In-Reply-To: <1362700500.92.0.448355159104.issue17383@psf.upfronthosting.co.za>
Message-ID: <1395000258.33.0.700319228779.issue17383@psf.upfronthosting.co.za>


Nitika Agarwal added the comment:

Hello everyone,
I have tried creating a patch for the issue,
Please review the attached patch.

----------
keywords: +patch
Added file: http://bugs.python.org/file34446/issue17383.patch

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

From report at bugs.python.org  Sun Mar 16 21:17:10 2014
From: report at bugs.python.org (Alexandre JABORSKA)
Date: Sun, 16 Mar 2014 20:17:10 +0000
Subject: [docs] [issue20950] asyncio.docs :
	asyncio.subprocess.Process.wait() method	typo
Message-ID: <1395001030.61.0.991983384964.issue20950@psf.upfronthosting.co.za>


New submission from Alexandre JABORSKA:

The asyncio.subprocess.Process.wait() documentation mention "self" parameter (typo ?) and don't tell it's a coroutine.

----------
assignee: docs at python
components: Documentation
messages: 213753
nosy: ajaborsk, docs at python
priority: normal
severity: normal
status: open
title: asyncio.docs : asyncio.subprocess.Process.wait() method typo
type: enhancement
versions: Python 3.4

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

From report at bugs.python.org  Sun Mar 16 21:29:53 2014
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 16 Mar 2014 20:29:53 +0000
Subject: [docs] [issue20950] asyncio.docs :
	asyncio.subprocess.Process.wait() method	typo
In-Reply-To: <1395001030.61.0.991983384964.issue20950@psf.upfronthosting.co.za>
Message-ID: <3fnC1X31xTz7LjS@mail.python.org>


Roundup Robot added the comment:

New changeset 1009cf8cb304 by Victor Stinner in branch 'default':
Issue #20950: Fix typo asyncio doc, wait() has no self parameter
http://hg.python.org/cpython/rev/1009cf8cb304

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

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

From report at bugs.python.org  Sun Mar 16 21:30:33 2014
From: report at bugs.python.org (STINNER Victor)
Date: Sun, 16 Mar 2014 20:30:33 +0000
Subject: [docs] [issue20950] asyncio.docs :
	asyncio.subprocess.Process.wait() method	typo
In-Reply-To: <1395001030.61.0.991983384964.issue20950@psf.upfronthosting.co.za>
Message-ID: <1395001833.24.0.820387616979.issue20950@psf.upfronthosting.co.za>


STINNER Victor added the comment:

Thanks, it has been fixed (in 12 minutes ;-)). I also mentionned that communicate() and wait() are coroutines.

----------
nosy: +haypo
resolution:  -> fixed
status: open -> closed

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

From report at bugs.python.org  Sun Mar 16 21:56:35 2014
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 16 Mar 2014 20:56:35 +0000
Subject: [docs] [issue11448] docs for HTTPConnection.set_tunnel are ambiguous
In-Reply-To: <1299636529.48.0.302129596868.issue11448@psf.upfronthosting.co.za>
Message-ID: <3fnCcL6JJFz7LjN@mail.python.org>


Roundup Robot added the comment:

New changeset 68a257ca6be6 by Benjamin Peterson in branch '3.3':
improve set_tunnel docs (closes #11448)
http://hg.python.org/cpython/rev/68a257ca6be6

New changeset 5cab0ada97b2 by Benjamin Peterson in branch 'default':
merge 3.3 (#11448)
http://hg.python.org/cpython/rev/5cab0ada97b2

----------
nosy: +python-dev
resolution:  -> fixed
stage:  -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Sun Mar 16 23:27:03 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Sun, 16 Mar 2014 22:27:03 +0000
Subject: [docs] [issue17383] Possibly ambiguous phrasing
	in	tutorial/modules#more-on-modules
In-Reply-To: <1362700500.92.0.448355159104.issue17383@psf.upfronthosting.co.za>
Message-ID: <1395008823.15.0.241112695646.issue17383@psf.upfronthosting.co.za>


?ric Araujo added the comment:

Thanks for the patch.

+Enhancing the More on Modules documentation
+--------------------------------------------------------------------

This should not be in the patch.

-Modules can import other modules. It is customary but not required
-to place all import statements at the beginning of a module (or script, 
-for that matter). The imported module names are placed in the importing
-module?s global symbol table.
+Modules can import other modules. It is customary but not required
+to place all import statements at the beginning of a module (or script, 
+for that matter). The imported module names are placed in the importing
+module?s global symbol table.

These lines are not changed, I suspect the characters used for the end of lines have been changed by your text editor.  Please fix that (search for ?EOL? or ?hgeol? in the devguide).

+For more on namespace, follow the link :
+http://docs.python.org/2/tutorial/classes.html#python-scopes-and-namespaces

I don?t think adding this link solves the ambiguous phrasing.

----------

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

From report at bugs.python.org  Sun Mar 16 23:43:34 2014
From: report at bugs.python.org (R. David Murray)
Date: Sun, 16 Mar 2014 22:43:34 +0000
Subject: [docs] [issue20112] The documentation for http.server
	error_message_format	is inadequate.
In-Reply-To: <1388701952.2.0.132957137739.issue20112@psf.upfronthosting.co.za>
Message-ID: <1395009814.77.0.218266596092.issue20112@psf.upfronthosting.co.za>


R. David Murray added the comment:

My intent here was that the rewrite should specify where the data that gets placed into the template when it is used comes from.  That would be 'responses' by default, but can be overridden in 'send_error'.

----------

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

From report at bugs.python.org  Sun Mar 16 23:48:46 2014
From: report at bugs.python.org (R. David Murray)
Date: Sun, 16 Mar 2014 22:48:46 +0000
Subject: [docs] [issue20112] The documentation for http.server
	error_message_format	is inadequate.
In-Reply-To: <1388701952.2.0.132957137739.issue20112@psf.upfronthosting.co.za>
Message-ID: <1395010125.99.0.235623354434.issue20112@psf.upfronthosting.co.za>


R. David Murray added the comment:

Hmm.  Rereading your patch I see that that is what you are trying to do, but I find the order of presentation confusing.  I would rather see the text focus on the fact that the string is used by send_error, and that the variables are filled by default from responses based on the code passed to send_error, and that you can also specify an alternate explain message that overrides the one from responses when calling send_error.

----------

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

From report at bugs.python.org  Mon Mar 17 01:17:23 2014
From: report at bugs.python.org (Graham Wideman)
Date: Mon, 17 Mar 2014 00:17:23 +0000
Subject: [docs] [issue20906] Issues in Unicode HOWTO
In-Reply-To: <1394702187.81.0.00522221343959.issue20906@psf.upfronthosting.co.za>
Message-ID: <1395015442.97.0.938074016902.issue20906@psf.upfronthosting.co.za>


Graham Wideman added the comment:

> Do you want to provide a patch?

I would be happy to, but I'm not currently set up to create a patch. Also, I hoped that an author who has more history with this article would supervise, especially where I don't know what the original intent was.

> I find use of the word "narrative" intimidating in the context of a technical documentation.

Agreed. How about "In documentation such as the current article..."

> In general, I find it disappointing that the Unicode HOWTO only gives 
> hexadecimal representations of non-ASCII characters and (almost) never 
> represents them in their true form. This makes things more abstract 
> than necessary.

I concur with reducing unnecessary abstraction. No sure what you mean by "true form". Do you mean show the glyph which the code point represents? Or the sequence of bytes? Or display the code point value in decimal? 

> > This is a vague claim. Probably what was intended was: "Many 
> > Internet standards define protocols in which the data must 
> > contain no zero bytes, or zero bytes have special meaning."  
> > Is this actually true? Are there "many" such standards?

> I think it actually means that Internet protocols assume an ASCII-compatible 
> encoding (which UTF-8 is, but not UTF-16 or UTF-32 - nor EBCDIC :-)).

Ah -- yes that makes sense.

> > --> "Non-Unicode code systems usually don't handle all of 
> > the characters to be found in Unicode."

> The term *encoding* is used pervasively when dealing with the transformation 
> of unicode to/from bytes, so I find it confusing to introduce another term here 
> ("code systems"). I prefer the original sentence.

I see that my revision missed the target. There is a problem, but it is wider than this sentence.

One of the most essential points this article should make clear is the distinction between older schemes with a single mapping:

Characters <--> numbers in particular binary format. (eg: ASCII)

... versus Unicode with two levels of mapping...

Characters <--> code point numbers <--> particular binary format of the number data and sequences thereof.

In the older schemes, "encoding" referred to the one mapping: chars <--> numbers in particular binary format. In Unicode, "encoding" refers only to the mapping: code point numbers <--> binary format. It does not refer to the chars <--> code point mapping. (At least, I think that's the case. Regardless, the two mappings need to be rigorously distinguished.)

On review, there are many points in the article that muddy this up.  For example, "Unicode started out using 16-bit characters instead of 8-bit characters". Saying "so-an-so-bit characters" about Unicode, in the current article, is either wrong, or very confusing.  Unicode characters are associated with code points, NOT with any _particular_ bit level representation.

If I'm right about the preceding, then it would be good for that to be spelled out more explicitly, and used consistently throughout the article. (I won't try to list all the examples of this problem here -- too messy.)

----------

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

From report at bugs.python.org  Mon Mar 17 01:26:36 2014
From: report at bugs.python.org (Graham Wideman)
Date: Mon, 17 Mar 2014 00:26:36 +0000
Subject: [docs] [issue20906] Issues in Unicode HOWTO
In-Reply-To: <1394702187.81.0.00522221343959.issue20906@psf.upfronthosting.co.za>
Message-ID: <1395015996.83.0.917778771463.issue20906@psf.upfronthosting.co.za>


Graham Wideman added the comment:

A further issue regarding "one-to-one mappings".

Article: "Encodings don?t have to be simple one-to-one mappings like Latin-1. Consider IBM?s EBCDIC, which was used on IBM mainframes."

I don't think this paragraph is about one-to-one mappings per se. (ie: one character to one code.) It seems to be about whether ranges of characters whose code values are contiguous in one coding system are also contiguous in another coding system. The EBCDIC encoding is still one-to-one, I believe.

The subject of one-chararacter-to-one-code mapping is important (normalization etc), though perhaps beyond the current article. But I think the article should avoid suggesting that many-to-one or one-to-many scenarios are common.

----------

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

From report at bugs.python.org  Mon Mar 17 02:38:28 2014
From: report at bugs.python.org (A.M. Kuchling)
Date: Mon, 17 Mar 2014 01:38:28 +0000
Subject: [docs] [issue20906] Issues in Unicode HOWTO
In-Reply-To: <1394702187.81.0.00522221343959.issue20906@psf.upfronthosting.co.za>
Message-ID: <1395020308.52.0.873467320436.issue20906@psf.upfronthosting.co.za>


Changes by A.M. Kuchling <amk at amk.ca>:


----------
nosy:  -akuchling

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

From report at bugs.python.org  Mon Mar 17 04:34:12 2014
From: report at bugs.python.org (Alba Magallanes)
Date: Mon, 17 Mar 2014 03:34:12 +0000
Subject: [docs] [issue14332] Better explain "junk" concept in difflib doc
In-Reply-To: <1331877125.66.0.103153393744.issue14332@psf.upfronthosting.co.za>
Message-ID: <1395027251.98.0.514956939377.issue14332@psf.upfronthosting.co.za>


Alba Magallanes added the comment:

I would like to help with this issue. I'm attaching a patch for it.

----------
keywords: +patch
nosy: +albamagallanes
Added file: http://bugs.python.org/file34451/issue14332.patch

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

From report at bugs.python.org  Mon Mar 17 06:06:21 2014
From: report at bugs.python.org (Nick Coghlan)
Date: Mon, 17 Mar 2014 05:06:21 +0000
Subject: [docs] [issue20265] Bring Windows docs up to date
In-Reply-To: <1389757265.26.0.116885263001.issue20265@psf.upfronthosting.co.za>
Message-ID: <1395032781.07.0.0282252520072.issue20265@psf.upfronthosting.co.za>


Nick Coghlan added the comment:

Sorry I haven't had a chance to review this myself, but it would also be good if we could mention the free "Python Tools for Visual Studio" addon that Microsoft publish (https://pytools.codeplex.com/). That may be better handled as a separate patch/issue though.

(My apologies if that has already been mentioned in the updated docs)

----------
nosy: +ncoghlan

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

From report at bugs.python.org  Mon Mar 17 07:30:41 2014
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 17 Mar 2014 06:30:41 +0000
Subject: [docs] [issue20199] status of module_for_loader and
	utils._module_to_load
In-Reply-To: <1389233222.57.0.373422642128.issue20199@psf.upfronthosting.co.za>
Message-ID: <3fnSLm3cbFz7Lkj@mail.python.org>


Roundup Robot added the comment:

New changeset 1640e3b7def6 by R David Murray in branch '3.4':
whatsnew: importlib deprecations.
http://hg.python.org/cpython/rev/1640e3b7def6

----------

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

From report at bugs.python.org  Mon Mar 17 07:30:47 2014
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 17 Mar 2014 06:30:47 +0000
Subject: [docs] [issue20652] Example in asyncio task gives resource warning
In-Reply-To: <1392618802.39.0.436656290548.issue20652@psf.upfronthosting.co.za>
Message-ID: <3fnSLv1Rb8z7LjZ@mail.python.org>


Roundup Robot added the comment:

New changeset 36005fe2ab9b by Victor Stinner in branch '3.4':
Close #20652: asyncio doc: close the event loop in run_forever() example. Fix
http://hg.python.org/cpython/rev/36005fe2ab9b

----------

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

From report at bugs.python.org  Mon Mar 17 07:30:50 2014
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 17 Mar 2014 06:30:50 +0000
Subject: [docs] [issue14512] Pydocs module docs server not working on
	Windows.
In-Reply-To: <1333645625.74.0.578211515784.issue14512@psf.upfronthosting.co.za>
Message-ID: <3fnSLx3pfHz7Lkf@mail.python.org>


Roundup Robot added the comment:

New changeset fa34ea4e9e47 by Martin v. L?wis in branch '3.4':
Issue #14512: Launch pydoc -b instead of pydocgui.pyw on Windows.
http://hg.python.org/cpython/rev/fa34ea4e9e47

----------

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

From report at bugs.python.org  Mon Mar 17 07:30:52 2014
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 17 Mar 2014 06:30:52 +0000
Subject: [docs] [issue20694] asyncio.docs: Document subprocess_exec
	and	subprocess_shell
In-Reply-To: <1392856741.43.0.87091314637.issue20694@psf.upfronthosting.co.za>
Message-ID: <3fnSLz5ltxz7LkJ@mail.python.org>


Roundup Robot added the comment:

New changeset 2dfc383b4907 by Yury Selivanov in branch '3.4':
asyncio.docs: Document subprocess_exec and subprocess_shell. Issue #20694.
http://hg.python.org/cpython/rev/2dfc383b4907

----------

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

From report at bugs.python.org  Mon Mar 17 07:31:11 2014
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 17 Mar 2014 06:31:11 +0000
Subject: [docs] [issue19060] docs: note that subprocess doesn't replace
	os.exec*
In-Reply-To: <1379748595.57.0.00736365306091.issue19060@psf.upfronthosting.co.za>
Message-ID: <3fnSML5Dypz7LkP@mail.python.org>


Roundup Robot added the comment:

New changeset d2ad2e04dc9d by Benjamin Peterson in branch '3.4':
merge 3.3 (#19060)
http://hg.python.org/cpython/rev/d2ad2e04dc9d

----------

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

From report at bugs.python.org  Mon Mar 17 07:31:14 2014
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 17 Mar 2014 06:31:14 +0000
Subject: [docs] [issue20814] tracemalloc example - Pretty Top
In-Reply-To: <1393664799.77.0.847113430877.issue20814@psf.upfronthosting.co.za>
Message-ID: <3fnSMP034hz7LkB@mail.python.org>


Roundup Robot added the comment:

New changeset 027ca483a7e5 by Victor Stinner in branch '3.4':
Close #20814: doc: Fix "Pretty top" example of tracemalloc
http://hg.python.org/cpython/rev/027ca483a7e5

----------

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

From report at bugs.python.org  Mon Mar 17 10:23:55 2014
From: report at bugs.python.org (Mark Lawrence)
Date: Mon, 17 Mar 2014 09:23:55 +0000
Subject: [docs] [issue20265] Bring Windows docs up to date
In-Reply-To: <1389757265.26.0.116885263001.issue20265@psf.upfronthosting.co.za>
Message-ID: <1395048235.78.0.286867656518.issue20265@psf.upfronthosting.co.za>


Mark Lawrence added the comment:

IIRC PTVS can't be used with the express editions so please mention this.

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

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

From report at bugs.python.org  Mon Mar 17 12:56:05 2014
From: report at bugs.python.org (Curtis Maloney)
Date: Mon, 17 Mar 2014 11:56:05 +0000
Subject: [docs] [issue20956] tokenize module claims generate_tokens
	returns	namedtuple, but it doesn't
Message-ID: <1395057365.37.0.876415448459.issue20956@psf.upfronthosting.co.za>


New submission from Curtis Maloney:

Although 3.x does yield a named-tuple, 2.x does not, despite the documentation:

    The exact type can be determined by checking the token string field on the named tuple returned from tokenize.tokenize() for the character sequence that identifies a specific operator token.

(I'd much rather this functionality be back-ported from 3, as it's quite simple)

----------
assignee: docs at python
components: Documentation
messages: 213853
nosy: FunkyBob, docs at python
priority: normal
severity: normal
status: open
title: tokenize module claims generate_tokens returns namedtuple, but it doesn't
versions: Python 2.7

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

From report at bugs.python.org  Mon Mar 17 13:41:56 2014
From: report at bugs.python.org (Eric V. Smith)
Date: Mon, 17 Mar 2014 12:41:56 +0000
Subject: [docs] [issue20956] tokenize module claims generate_tokens
	returns	namedtuple, but it doesn't
In-Reply-To: <1395057365.37.0.876415448459.issue20956@psf.upfronthosting.co.za>
Message-ID: <1395060116.49.0.816567050264.issue20956@psf.upfronthosting.co.za>


Eric V. Smith added the comment:

The 2.x documentation says generate_tokens returns a 5-tuple, not a namedtuple:

http://docs.python.org/2/library/tokenize.html
"The generator produces 5-tuples with these members: ..."

The section you quote is talking about tokenize.tokenize, and I think that documentation should be fixed. Changing to namedtuple would be a new feature, which are not being added to 2.7.

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

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

From report at bugs.python.org  Mon Mar 17 13:57:21 2014
From: report at bugs.python.org (Curtis Maloney)
Date: Mon, 17 Mar 2014 12:57:21 +0000
Subject: [docs] [issue20956] tokenize module claims tokenize.tokenize
	returns	namedtuple, but it doesn't
In-Reply-To: <1395057365.37.0.876415448459.issue20956@psf.upfronthosting.co.za>
Message-ID: <1395061041.55.0.231662126523.issue20956@psf.upfronthosting.co.za>


Curtis Maloney added the comment:

Corrected title.

And, yeah, figured it wouldn't be added as a new feature, hence reporting this as a Documentation bug.

----------
title: tokenize module claims generate_tokens returns namedtuple, but it doesn't -> tokenize module claims tokenize.tokenize returns namedtuple, but it doesn't

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

From report at bugs.python.org  Mon Mar 17 14:24:15 2014
From: report at bugs.python.org (Jovik)
Date: Mon, 17 Mar 2014 13:24:15 +0000
Subject: [docs] [issue20927] Different behaviour on Posix and Windows when
	using	subprocess.Popen(..., cwd=path)
In-Reply-To: <1394816385.18.0.912805951896.issue20927@psf.upfronthosting.co.za>
Message-ID: <1395062655.47.0.921670320709.issue20927@psf.upfronthosting.co.za>


Jovik added the comment:

As requested I did extra tests with extension. Same result as before:
>>> proc = subprocess.Popen("plink.exe", stdout=subprocess.PIPE, cwd="c:\\python33\\workspace")
>>> proc = subprocess.Popen(".\plink.exe", stdout=subprocess.PIPE, cwd="c:\\python33\\workspace")
>>> proc = subprocess.Popen(".\\plink.exe", stdout=subprocess.PIPE, cwd="c:\\python33\\workspace")
>>> proc = subprocess.Popen(".\plink.exe", stdout=subprocess.PIPE, cwd="c:/python33/workspace")
>>> proc = subprocess.Popen("plink.exe", stdout=subprocess.PIPE, cwd="c:/python33/workspace")

Traceback (most recent call last):
  File "C:\Python33\lib\subprocess.py", line 1104, in _execute_child
    startupinfo)
FileNotFoundError: [WinError 2] The system cannot find the file specified

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "C:\Python33\lib\subprocess.py", line 819, in __init__
    restore_signals, start_new_session)
  File "C:\Python33\lib\subprocess.py", line 1110, in _execute_child
    raise WindowsError(*e.args)
FileNotFoundError: [WinError 2] The system cannot find the file specified

I believe it's a wider issue, since my colleagues insisted on using shell=True on Windows by default (I didn't understand why, until now)

----------

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

From report at bugs.python.org  Mon Mar 17 14:31:24 2014
From: report at bugs.python.org (Eric V. Smith)
Date: Mon, 17 Mar 2014 13:31:24 +0000
Subject: [docs] [issue20927] Different behaviour on Posix and Windows when
	using	subprocess.Popen(..., cwd=path)
In-Reply-To: <1394816385.18.0.912805951896.issue20927@psf.upfronthosting.co.za>
Message-ID: <1395063084.63.0.696375852556.issue20927@psf.upfronthosting.co.za>


Eric V. Smith added the comment:

Where is plink.exe? If it's not in cwd (c:\python33\workspace), note that the documentation for cwd says:
"If cwd is not None, the function changes the working directory to cwd before executing the child. In particular, the function looks for executable (or for the first item in args) relative to cwd if the executable path is a relative path."

Although confusingly, the 2.7 documentation says:
"If cwd is not None, the child?s current directory will be changed to cwd before it is executed. Note that this directory is not considered when searching the executable, so you can?t specify the program?s path relative to cwd."

----------

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

From report at bugs.python.org  Mon Mar 17 14:40:11 2014
From: report at bugs.python.org (Jovik)
Date: Mon, 17 Mar 2014 13:40:11 +0000
Subject: [docs] [issue20927] Different behaviour on Posix and Windows when
	using	subprocess.Popen(..., cwd=path)
In-Reply-To: <1394816385.18.0.912805951896.issue20927@psf.upfronthosting.co.za>
Message-ID: <1395063611.68.0.0267345337176.issue20927@psf.upfronthosting.co.za>


Jovik added the comment:

plink.exe is located in c:\python33\workspace. I'm aware of the docstring difference between Python 2 and 3, thus submitted the bug for Python 3 only.

----------

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

From report at bugs.python.org  Mon Mar 17 14:55:36 2014
From: report at bugs.python.org (Kathleen Weaver)
Date: Mon, 17 Mar 2014 13:55:36 +0000
Subject: [docs] [issue20265] Bring Windows docs up to date
In-Reply-To: <1389757265.26.0.116885263001.issue20265@psf.upfronthosting.co.za>
Message-ID: <1395064536.89.0.0181238873017.issue20265@psf.upfronthosting.co.za>


Kathleen Weaver added the comment:

There is also a separate version of the Python Tools depending on which version of Visual Studio.  I'm testing this out, and may add it to the current patch.

----------

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

From report at bugs.python.org  Mon Mar 17 15:06:23 2014
From: report at bugs.python.org (Eric V. Smith)
Date: Mon, 17 Mar 2014 14:06:23 +0000
Subject: [docs] [issue20927] Different behaviour on Posix and Windows when
	using	subprocess.Popen(..., cwd=path)
In-Reply-To: <1394816385.18.0.912805951896.issue20927@psf.upfronthosting.co.za>
Message-ID: <1395065183.54.0.241050156619.issue20927@psf.upfronthosting.co.za>


Eric V. Smith added the comment:

I think the 2.7 documentation is correct: the current directory when the call is made, and not cwd, is included in the search path. I'd suggest specifying args as ["c:\\python33\\workspace\\plink.exe"].

I think I may have mislead you earlier on the search path. The Windows call is:
CreateProcess(lpApplicationName, lpCommandLine, <other stuff>, lpCurrentDirectory, <other stuff>)

The first parameter to Popen ("args") becomes lpCommandLine. The "executable" parameter to Popen, which you're not setting, becomes lpApplicationName. So, you're calling CreateProcess(NULL, "plink.exe, ..., lpCurrentDirectory="c:\\python33\\workspace").

In this case, .exe would be added if missing. But, the search path rules seem to not include the directory pointed to by lpCurrentDirectory (aka cwd).

So I think this would work:
subprocess.Popen(["c:\\python33\\workspace\\plink.exe"], stdout=subprocess.PIPE, cwd="c:\\python33\\workspace")
or
subprocess.Popen(["plink"], executable="c:\\python33\\workspace\\plink.exe", stdout=subprocess.PIPE, cwd="c:\\python33\\workspace")

Unfortunately, I don't have a copy of 3.x on my Windows machine to test with.

----------

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

From cocoatomo77 at gmail.com  Sat Mar 15 07:42:17 2014
From: cocoatomo77 at gmail.com (tomo cocoa)
Date: Sat, 15 Mar 2014 15:42:17 +0900
Subject: [docs] An unmatched parenthesis
Message-ID: <CAN_7T0LE3uFXZHi-MUsBwA_yyFqyF_xEUfj6YTb5CgGhTRSqug@mail.gmail.com>

Hello,

I am a Japanese Python documents translator, cocoatomo.

"Embedding/Extending FAQ" has an unmatched closing parenthesis in the
fourth paragraph.

   PySequence_GetItem(), etc.)

http://docs.python.org/3.3/faq/extending.html#how-do-i-extract-c-values-from-a-python-object

I guess that removal of the closing parenthesis following a word "etc." is
a solution.


Thanks,

cocoatomo

-- 
class Cocoatomo:
    name = 'cocoatomo'
    email_address = 'cocoatomo77 at gmail.com'
    twitter_id = '@cocoatomo'
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140315/c97a655e/attachment.html>

From Tobias.Kaes at syncos.com  Mon Mar 17 10:47:56 2014
From: Tobias.Kaes at syncos.com (=?iso-8859-1?Q?Tobias_K=E4s?=)
Date: Mon, 17 Mar 2014 10:47:56 +0100
Subject: [docs] Typo in 3.4 doc for enum module
Message-ID: <F73B96943F49814AB847F777964141BD0A00FE09FB@srvexchange>

In section "8.13.12.2. Others":
> 3. When another data type is mixed in, the value attribute is not the same as the enum member itself, although it is equivalant and will compare equal.

"equivalant" probably should be "equivalent"


From report at bugs.python.org  Mon Mar 17 15:18:43 2014
From: report at bugs.python.org (Berker Peksag)
Date: Mon, 17 Mar 2014 14:18:43 +0000
Subject: [docs] [issue20960] Fix usage of the versionchanged directive in
	the	sys.hash_info documentation
Message-ID: <1395065923.54.0.239273515356.issue20960@psf.upfronthosting.co.za>


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


----------
assignee: docs at python
components: Documentation
files: sys-versionchanged.diff
keywords: patch
nosy: berker.peksag, docs at python
priority: normal
severity: normal
stage: patch review
status: open
title: Fix usage of the versionchanged directive in the sys.hash_info documentation
versions: Python 3.4, Python 3.5
Added file: http://bugs.python.org/file34463/sys-versionchanged.diff

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

From report at bugs.python.org  Mon Mar 17 15:21:03 2014
From: report at bugs.python.org (Jovik)
Date: Mon, 17 Mar 2014 14:21:03 +0000
Subject: [docs] [issue20927] Different behaviour on Posix and Windows when
	using	subprocess.Popen(..., cwd=path)
In-Reply-To: <1394816385.18.0.912805951896.issue20927@psf.upfronthosting.co.za>
Message-ID: <1395066063.73.0.718111148428.issue20927@psf.upfronthosting.co.za>


Jovik added the comment:

Why this feature works on Posix systems, but not Windows? If my memory is correct, it didn't work anywhere when I used Python 2.7 (according with docs).

----------

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

From report at bugs.python.org  Mon Mar 17 15:30:56 2014
From: report at bugs.python.org (Berker Peksag)
Date: Mon, 17 Mar 2014 14:30:56 +0000
Subject: [docs] [issue20961] Fix usages of the note directive in the
	documentation
Message-ID: <1395066655.93.0.683819910553.issue20961@psf.upfronthosting.co.za>


New submission from Berker Peksag:

Here's a patch to fix all "ERROR: Error in "note" directive:
invalid option block." errors in the stdlib documentation.

----------
assignee: docs at python
components: Documentation
files: fix-note-directive.diff
keywords: patch
messages: 213871
nosy: berker.peksag, docs at python
priority: normal
severity: normal
stage: patch review
status: open
title: Fix usages of the note directive in the documentation
versions: Python 3.4, Python 3.5
Added file: http://bugs.python.org/file34464/fix-note-directive.diff

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

From report at bugs.python.org  Mon Mar 17 15:32:09 2014
From: report at bugs.python.org (Anastasia.Filatova)
Date: Mon, 17 Mar 2014 14:32:09 +0000
Subject: [docs] [issue20112] The documentation for http.server
	error_message_format	is inadequate.
In-Reply-To: <1388701952.2.0.132957137739.issue20112@psf.upfronthosting.co.za>
Message-ID: <1395066729.64.0.351695421626.issue20112@psf.upfronthosting.co.za>


Anastasia.Filatova added the comment:

Thank you, David, for review! I understood your point of view, an updated patch will be added soon.

----------

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

From report at bugs.python.org  Mon Mar 17 15:35:44 2014
From: report at bugs.python.org (Eric V. Smith)
Date: Mon, 17 Mar 2014 14:35:44 +0000
Subject: [docs] [issue20927] Different behaviour on Posix and Windows when
	using	subprocess.Popen(..., cwd=path)
In-Reply-To: <1394816385.18.0.912805951896.issue20927@psf.upfronthosting.co.za>
Message-ID: <1395066944.9.0.628081636564.issue20927@psf.upfronthosting.co.za>


Eric V. Smith added the comment:

The underlying APIs are very different. It's debatable how much of a shim we should provide to make all platforms look alike.

I think first we should understand what it currently takes to make something work in both environments. Then we can talk about how or if we can make them look more similar.

----------

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

From report at bugs.python.org  Mon Mar 17 16:23:41 2014
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 17 Mar 2014 15:23:41 +0000
Subject: [docs] [issue20960] Fix usage of the versionchanged directive in
	the	sys.hash_info documentation
Message-ID: <3fnh9m0ySfz7Ljb@mail.python.org>


New submission from Roundup Robot:

New changeset a2fd7e452167 by R David Murray in branch '3.4':
closes #20960
http://hg.python.org/cpython/rev/a2fd7e452167

New changeset 3a3a5467baa9 by R David Murray in branch 'default':
Merge fix for #20960
http://hg.python.org/cpython/rev/3a3a5467baa9

----------
nosy: +python-dev
resolution:  -> fixed
stage: patch review -> committed/rejected
status: open -> closed

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

From cocoatomo77 at gmail.com  Mon Mar 17 16:44:51 2014
From: cocoatomo77 at gmail.com (tomo cocoa)
Date: Tue, 18 Mar 2014 00:44:51 +0900
Subject: [docs] a missed closing parenthesis
Message-ID: <CAN_7T0+S1iB6=e3o6nbwS5bme7rbbrzuvR6dxS4HQOUfJvo7Lg@mail.gmail.com>

Hello,

I am a Japanese translator on Python documents , cocoatomo.

http://docs.python.org/3.3/distutils/apiref.html#distutils.dir_util.copy_tree

The third paragraph may miss a closing parenthesis just after a word "page".

Thanks,

cocoatomo

-- 
class Cocoatomo:
    name = 'cocoatomo'
    email_address = 'cocoatomo77 at gmail.com'
    twitter_id = '@cocoatomo'
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140318/54e8c2f5/attachment.html>

From report at bugs.python.org  Mon Mar 17 20:15:46 2014
From: report at bugs.python.org (Anastasia.Filatova)
Date: Mon, 17 Mar 2014 19:15:46 +0000
Subject: [docs] [issue20112] The documentation for http.server
	error_message_format	is inadequate.
In-Reply-To: <1388701952.2.0.132957137739.issue20112@psf.upfronthosting.co.za>
Message-ID: <1395083746.01.0.407202675739.issue20112@psf.upfronthosting.co.za>


Changes by Anastasia.Filatova <anastasia.n.filatova at gmail.com>:


Removed file: http://bugs.python.org/file34389/Issue20112_py27.patch

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

From report at bugs.python.org  Mon Mar 17 20:15:54 2014
From: report at bugs.python.org (Anastasia.Filatova)
Date: Mon, 17 Mar 2014 19:15:54 +0000
Subject: [docs] [issue20112] The documentation for http.server
	error_message_format	is inadequate.
In-Reply-To: <1388701952.2.0.132957137739.issue20112@psf.upfronthosting.co.za>
Message-ID: <1395083754.14.0.792573565933.issue20112@psf.upfronthosting.co.za>


Changes by Anastasia.Filatova <anastasia.n.filatova at gmail.com>:


Removed file: http://bugs.python.org/file34391/Issue20112_py34.patch

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

From report at bugs.python.org  Mon Mar 17 20:16:00 2014
From: report at bugs.python.org (Anastasia.Filatova)
Date: Mon, 17 Mar 2014 19:16:00 +0000
Subject: [docs] [issue20112] The documentation for http.server
	error_message_format	is inadequate.
In-Reply-To: <1388701952.2.0.132957137739.issue20112@psf.upfronthosting.co.za>
Message-ID: <1395083760.55.0.623890468694.issue20112@psf.upfronthosting.co.za>


Changes by Anastasia.Filatova <anastasia.n.filatova at gmail.com>:


Removed file: http://bugs.python.org/file34390/Issue20112_py33.patch

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

From report at bugs.python.org  Mon Mar 17 20:16:28 2014
From: report at bugs.python.org (Anastasia.Filatova)
Date: Mon, 17 Mar 2014 19:16:28 +0000
Subject: [docs] [issue20112] The documentation for http.server
	error_message_format	is inadequate.
In-Reply-To: <1388701952.2.0.132957137739.issue20112@psf.upfronthosting.co.za>
Message-ID: <1395083788.66.0.56299828294.issue20112@psf.upfronthosting.co.za>


Changes by Anastasia.Filatova <anastasia.n.filatova at gmail.com>:


Added file: http://bugs.python.org/file34467/Issue20112_py27.patch

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

From report at bugs.python.org  Mon Mar 17 20:16:45 2014
From: report at bugs.python.org (Anastasia.Filatova)
Date: Mon, 17 Mar 2014 19:16:45 +0000
Subject: [docs] [issue20112] The documentation for http.server
	error_message_format	is inadequate.
In-Reply-To: <1388701952.2.0.132957137739.issue20112@psf.upfronthosting.co.za>
Message-ID: <1395083805.09.0.361948292906.issue20112@psf.upfronthosting.co.za>


Changes by Anastasia.Filatova <anastasia.n.filatova at gmail.com>:


Added file: http://bugs.python.org/file34468/Issue20112_py33.patch

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

From report at bugs.python.org  Mon Mar 17 20:16:56 2014
From: report at bugs.python.org (Anastasia.Filatova)
Date: Mon, 17 Mar 2014 19:16:56 +0000
Subject: [docs] [issue20112] The documentation for http.server
	error_message_format	is inadequate.
In-Reply-To: <1388701952.2.0.132957137739.issue20112@psf.upfronthosting.co.za>
Message-ID: <1395083816.15.0.463619437734.issue20112@psf.upfronthosting.co.za>


Changes by Anastasia.Filatova <anastasia.n.filatova at gmail.com>:


Added file: http://bugs.python.org/file34469/Issue20112_py34.patch

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

From report at bugs.python.org  Mon Mar 17 20:19:24 2014
From: report at bugs.python.org (Anastasia.Filatova)
Date: Mon, 17 Mar 2014 19:19:24 +0000
Subject: [docs] [issue20112] The documentation for http.server
	error_message_format	is inadequate.
In-Reply-To: <1388701952.2.0.132957137739.issue20112@psf.upfronthosting.co.za>
Message-ID: <1395083964.19.0.444885014248.issue20112@psf.upfronthosting.co.za>


Anastasia.Filatova added the comment:

So new patch is updated. Could someone please give me feedback on it?

----------

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

From report at bugs.python.org  Mon Mar 17 20:29:51 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 17 Mar 2014 19:29:51 +0000
Subject: [docs] [issue20112] The documentation for http.server
	error_message_format	is inadequate.
In-Reply-To: <1388701952.2.0.132957137739.issue20112@psf.upfronthosting.co.za>
Message-ID: <1395084591.37.0.97873895395.issue20112@psf.upfronthosting.co.za>


?ric Araujo added the comment:

Thanks, the doc is much clearer now.  Could you also address my comments?  (If you did not get email, the comments can be accessed with the ?review? link in the list of files attached to this report.)

----------
nosy: +eric.araujo

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

From e1ven at e1ven.com  Mon Mar 17 19:13:01 2014
From: e1ven at e1ven.com (Colin Davis)
Date: Mon, 17 Mar 2014 14:13:01 -0400
Subject: [docs] Documentation Bug in OS.makedirs?
Message-ID: <etPan.53273b2d.625558ec.426a@Passaconaway.local>

I'm trying to use os.makedirs on Py3 (3.3 or 3.4) and pass in a path-
This works when I do so positionally, but throws an exception when I do so by keyword.
You can see an example at https://gist.github.com/e1ven/bb269423a7043e6fdc77?

When you look in the code at (http://hg.python.org/cpython/file/3bb83f18851f/Lib/os.py) it looks like it's looking for the parameter "name", but the docs (http://docs.python.org/3.4/library/os.html) seem to say to pass "path".

Perhaps the Docs are incorrect here?

--?
Colin Davis
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140317/e11f1de6/attachment.html>

From report at bugs.python.org  Mon Mar 17 21:34:47 2014
From: report at bugs.python.org (chris-buccella)
Date: Mon, 17 Mar 2014 20:34:47 +0000
Subject: [docs] [issue20963] side_effects swapped in Mock example
Message-ID: <1395088487.87.0.432114186877.issue20963@psf.upfronthosting.co.za>


New submission from chris-buccella:

http://docs.python.org/3.4/library/unittest.mock-examples.html

Section 26.5.3.9. Mocking a dictionary with MagicMock

In the Note area:

>>> mock.__setitem__ = Mock(side_effect=getitem)
>>> mock.__getitem__ = Mock(side_effect=setitem)


I think these are swapped; should be:

>>> mock.__setitem__ = Mock(side_effect=setitem)
>>> mock.__getitem__ = Mock(side_effect=getitem)

----------
assignee: docs at python
components: Documentation
messages: 213891
nosy: chris-buccella, docs at python
priority: normal
severity: normal
status: open
title: side_effects swapped in Mock example
versions: Python 3.4, Python 3.5

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

From report at bugs.python.org  Mon Mar 17 21:46:29 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 17 Mar 2014 20:46:29 +0000
Subject: [docs] [issue20963] side_effects swapped in Mock example
In-Reply-To: <1395088487.87.0.432114186877.issue20963@psf.upfronthosting.co.za>
Message-ID: <1395089189.05.0.134596208301.issue20963@psf.upfronthosting.co.za>


?ric Araujo added the comment:

Thanks, will fix.

----------
assignee: docs at python -> eric.araujo
nosy: +eric.araujo

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

From report at bugs.python.org  Mon Mar 17 21:50:58 2014
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 17 Mar 2014 20:50:58 +0000
Subject: [docs] [issue20963] side_effects swapped in Mock example
In-Reply-To: <1395088487.87.0.432114186877.issue20963@psf.upfronthosting.co.za>
Message-ID: <3fnqRP1JRdz7Lkj@mail.python.org>


Roundup Robot added the comment:

New changeset e725de5a2760 by ?ric Araujo in branch '3.4':
Fix typo in example (#20963)
http://hg.python.org/cpython/rev/e725de5a2760

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

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

From report at bugs.python.org  Mon Mar 17 21:51:51 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 17 Mar 2014 20:51:51 +0000
Subject: [docs] [issue20963] side_effects swapped in Mock example
In-Reply-To: <1395088487.87.0.432114186877.issue20963@psf.upfronthosting.co.za>
Message-ID: <1395089511.02.0.950070823456.issue20963@psf.upfronthosting.co.za>


Changes by ?ric Araujo <merwok at netwok.org>:


----------
resolution:  -> fixed
stage:  -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Mon Mar 17 22:20:01 2014
From: report at bugs.python.org (Kathleen Weaver)
Date: Mon, 17 Mar 2014 21:20:01 +0000
Subject: [docs] [issue20265] Bring Windows docs up to date
In-Reply-To: <1389757265.26.0.116885263001.issue20265@psf.upfronthosting.co.za>
Message-ID: <1395091200.93.0.219307354481.issue20265@psf.upfronthosting.co.za>


Kathleen Weaver added the comment:

I just figured out why Windows 8 isn't behaving the way the documentation says.

You have to use Command Prompt (Admin).   Command Prompt (the first option IGNORES the path)

Now it's time to have a discussion with a Windows Project Manager.

----------

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

From Thuan.Truong at tasc.com  Mon Mar 17 22:27:45 2014
From: Thuan.Truong at tasc.com (Truong, Thuan V (TASC))
Date: Mon, 17 Mar 2014 21:27:45 +0000
Subject: [docs] Python MSI packages installation on Windows
Message-ID: <88917A57D2BDE64D8EE33C4F5460152801651341@TSEAMB02>

FYI,

I run Windows 7 64-bit.  I downloaded several versions of Python 2,7 through 3.3.5 MSI packages from www.python.org<http://www.python.org> .  But when I clicked on the downloaded files, they all say "This installation package could not be opened.   ..".  This the same error for all files>

Any idea why?

--
Thuan Truong
Cyber Incident Analyst
Ph: 703-449-3710
TASC/CSOC - 4801 Stonecroft Blvd
Chantilly, VA 20151


CONFIDENTIALITY NOTICE: This message and any attachments or files transmitted with it (collectively, the "Message") are intended only for the addressee and may contain information that is privileged, proprietary and/or prohibited from disclosure by law or contract. If you are not the intended recipient: (a) please do not read, copy or retransmit the Message; (b) permanently delete and/or destroy all electronic and hard copies of the Message; (c) notify us by return email; and (d) you are hereby notified that any dissemination, distribution or copying of the Message is strictly prohibited.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140317/ae23dc56/attachment.html>

From report at bugs.python.org  Tue Mar 18 00:01:03 2014
From: report at bugs.python.org (Sreepriya Chalakkal)
Date: Mon, 17 Mar 2014 23:01:03 +0000
Subject: [docs] [issue17110] sys.argv docs should explaining how to handle
	encoding	issues
In-Reply-To: <1359864071.69.0.659089821533.issue17110@psf.upfronthosting.co.za>
Message-ID: <1395097263.21.0.126801932082.issue17110@psf.upfronthosting.co.za>


Sreepriya Chalakkal added the comment:

You are right. Instead of running ./python inside the python directory, I ran the default python of older version! Based on the stackoverflow link given, I tried to make some documentation. I am attaching the patch!

----------
keywords: +patch
Added file: http://bugs.python.org/file34470/Issue17110.patch

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

From report at bugs.python.org  Tue Mar 18 01:46:12 2014
From: report at bugs.python.org (Jamayla Wiley)
Date: Tue, 18 Mar 2014 00:46:12 +0000
Subject: [docs] [issue16827] Remove the relatively advanced content from
	section 2 in	tutorial
In-Reply-To: <1356964896.19.0.673901752517.issue16827@psf.upfronthosting.co.za>
Message-ID: <1395103570.26.0.40637314281.issue16827@psf.upfronthosting.co.za>


Jamayla Wiley added the comment:

I moved the advanced content (all but 2.1, 2.2.3) from the 'Interpreter' tutorial to the 'Interactive' appendix mentioned above.

----------
keywords: +patch
nosy: +jdwiley
Added file: http://bugs.python.org/file34472/interpreter.patch

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

From report at bugs.python.org  Tue Mar 18 02:16:20 2014
From: report at bugs.python.org (Ya-Ting Huang)
Date: Tue, 18 Mar 2014 01:16:20 +0000
Subject: [docs] [issue16827] Remove the relatively advanced content from
	section 2 in	tutorial
In-Reply-To: <1356964896.19.0.673901752517.issue16827@psf.upfronthosting.co.za>
Message-ID: <1395105377.78.0.997420584494.issue16827@psf.upfronthosting.co.za>


Ya-Ting Huang added the comment:

Hi I just uploaded my patch. I add one file appendix.rst, and move every part except 2.1 and 2.2.3 to appendix. Also I add one line under the interactive section to advice readers see more information in appendix. Please let me know if I should reorganize anything else.

By the way the section 13 http://docs.python.org/3/tutorial/interactive.html is more about interactive Input editing, which is different concept from interactive mode. I think it would be good to make clearer of these two.

----------
nosy: +yating.huang
Added file: http://bugs.python.org/file34473/tutorial.patch

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

From report at bugs.python.org  Tue Mar 18 02:22:49 2014
From: report at bugs.python.org (Kathleen Weaver)
Date: Tue, 18 Mar 2014 01:22:49 +0000
Subject: [docs] [issue20265] Bring Windows docs up to date
In-Reply-To: <1389757265.26.0.116885263001.issue20265@psf.upfronthosting.co.za>
Message-ID: <1395105767.08.0.641085635596.issue20265@psf.upfronthosting.co.za>


Kathleen Weaver added the comment:

I think I've incorporated everything wanted, and simplified things.

Instead of going through how to change environment variables, I've pointed to another source.

I've added the VS tools.

----------
Added file: http://bugs.python.org/file34474/kweaver.patch

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

From report at bugs.python.org  Tue Mar 18 02:22:58 2014
From: report at bugs.python.org (Kathleen Weaver)
Date: Tue, 18 Mar 2014 01:22:58 +0000
Subject: [docs] [issue20265] Bring Windows docs up to date
In-Reply-To: <1389757265.26.0.116885263001.issue20265@psf.upfronthosting.co.za>
Message-ID: <1395105772.3.0.436152564411.issue20265@psf.upfronthosting.co.za>


Kathleen Weaver added the comment:

I think I've incorporated everything wanted, and simplified things.

Instead of going through how to change environment variables, I've pointed to another source.

I've added the VS tools.

----------
Added file: http://bugs.python.org/file34475/kweaver.patch

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

From report at bugs.python.org  Tue Mar 18 02:23:14 2014
From: report at bugs.python.org (Kathleen Weaver)
Date: Tue, 18 Mar 2014 01:23:14 +0000
Subject: [docs] [issue20265] Bring Windows docs up to date
In-Reply-To: <1389757265.26.0.116885263001.issue20265@psf.upfronthosting.co.za>
Message-ID: <1395105794.04.0.949848224619.issue20265@psf.upfronthosting.co.za>


Changes by Kathleen Weaver <kathleen at kweaver.org>:


Removed file: http://bugs.python.org/file34474/kweaver.patch

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

From report at bugs.python.org  Tue Mar 18 02:23:24 2014
From: report at bugs.python.org (Kathleen Weaver)
Date: Tue, 18 Mar 2014 01:23:24 +0000
Subject: [docs] [issue20265] Bring Windows docs up to date
In-Reply-To: <1389757265.26.0.116885263001.issue20265@psf.upfronthosting.co.za>
Message-ID: <1395105804.74.0.808610818822.issue20265@psf.upfronthosting.co.za>


Changes by Kathleen Weaver <kathleen at kweaver.org>:


Removed file: http://bugs.python.org/file34437/kweaver.patch

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

From report at bugs.python.org  Tue Mar 18 02:23:33 2014
From: report at bugs.python.org (Kathleen Weaver)
Date: Tue, 18 Mar 2014 01:23:33 +0000
Subject: [docs] [issue20265] Bring Windows docs up to date
In-Reply-To: <1389757265.26.0.116885263001.issue20265@psf.upfronthosting.co.za>
Message-ID: <1395105813.11.0.288004245229.issue20265@psf.upfronthosting.co.za>


Changes by Kathleen Weaver <kathleen at kweaver.org>:


Removed file: http://bugs.python.org/file34409/windowsDoc.patch

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

From report at bugs.python.org  Tue Mar 18 06:55:31 2014
From: report at bugs.python.org (Alba Magallanes)
Date: Tue, 18 Mar 2014 05:55:31 +0000
Subject: [docs] [issue14332] Better explain "junk" concept in difflib doc
In-Reply-To: <1331877125.66.0.103153393744.issue14332@psf.upfronthosting.co.za>
Message-ID: <1395122131.81.0.181517321788.issue14332@psf.upfronthosting.co.za>


Alba Magallanes added the comment:

I removed the References to 2.x version.

----------
Added file: http://bugs.python.org/file34479/issue14332_2.patch

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

From report at bugs.python.org  Tue Mar 18 09:23:55 2014
From: report at bugs.python.org (Anastasia.Filatova)
Date: Tue, 18 Mar 2014 08:23:55 +0000
Subject: [docs] [issue20112] The documentation for http.server
	error_message_format	is inadequate.
In-Reply-To: <1388701952.2.0.132957137739.issue20112@psf.upfronthosting.co.za>
Message-ID: <1395131035.99.0.170568383844.issue20112@psf.upfronthosting.co.za>


Changes by Anastasia.Filatova <anastasia.n.filatova at gmail.com>:


Removed file: http://bugs.python.org/file34469/Issue20112_py34.patch

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

From report at bugs.python.org  Tue Mar 18 09:24:02 2014
From: report at bugs.python.org (Anastasia.Filatova)
Date: Tue, 18 Mar 2014 08:24:02 +0000
Subject: [docs] [issue20112] The documentation for http.server
	error_message_format	is inadequate.
In-Reply-To: <1388701952.2.0.132957137739.issue20112@psf.upfronthosting.co.za>
Message-ID: <1395131042.62.0.206111152828.issue20112@psf.upfronthosting.co.za>


Changes by Anastasia.Filatova <anastasia.n.filatova at gmail.com>:


Removed file: http://bugs.python.org/file34468/Issue20112_py33.patch

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

From report at bugs.python.org  Tue Mar 18 09:24:09 2014
From: report at bugs.python.org (Anastasia.Filatova)
Date: Tue, 18 Mar 2014 08:24:09 +0000
Subject: [docs] [issue20112] The documentation for http.server
	error_message_format	is inadequate.
In-Reply-To: <1388701952.2.0.132957137739.issue20112@psf.upfronthosting.co.za>
Message-ID: <1395131049.41.0.433917781507.issue20112@psf.upfronthosting.co.za>


Changes by Anastasia.Filatova <anastasia.n.filatova at gmail.com>:


Removed file: http://bugs.python.org/file34467/Issue20112_py27.patch

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

From report at bugs.python.org  Tue Mar 18 09:24:30 2014
From: report at bugs.python.org (Anastasia.Filatova)
Date: Tue, 18 Mar 2014 08:24:30 +0000
Subject: [docs] [issue20112] The documentation for http.server
	error_message_format	is inadequate.
In-Reply-To: <1388701952.2.0.132957137739.issue20112@psf.upfronthosting.co.za>
Message-ID: <1395131070.79.0.535988704495.issue20112@psf.upfronthosting.co.za>


Changes by Anastasia.Filatova <anastasia.n.filatova at gmail.com>:


Added file: http://bugs.python.org/file34481/Issue20112_py34.patch

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

From report at bugs.python.org  Tue Mar 18 09:29:09 2014
From: report at bugs.python.org (Anastasia.Filatova)
Date: Tue, 18 Mar 2014 08:29:09 +0000
Subject: [docs] [issue20112] The documentation for http.server
	error_message_format	is inadequate.
In-Reply-To: <1388701952.2.0.132957137739.issue20112@psf.upfronthosting.co.za>
Message-ID: <1395131349.76.0.161236430374.issue20112@psf.upfronthosting.co.za>


Changes by Anastasia.Filatova <anastasia.n.filatova at gmail.com>:


Added file: http://bugs.python.org/file34482/Issue20112_py33.patch

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

From report at bugs.python.org  Tue Mar 18 09:29:24 2014
From: report at bugs.python.org (Anastasia.Filatova)
Date: Tue, 18 Mar 2014 08:29:24 +0000
Subject: [docs] [issue20112] The documentation for http.server
	error_message_format	is inadequate.
In-Reply-To: <1388701952.2.0.132957137739.issue20112@psf.upfronthosting.co.za>
Message-ID: <1395131364.09.0.425087297844.issue20112@psf.upfronthosting.co.za>


Anastasia.Filatova added the comment:

Thank you, Eric for your comments! I see now what doese the 'review' link mean :)   You are right the send_error should be a method not a class variable. I changed it in a new patch. As regards the responses I prefer don't change it to a class attribute because in documentation it is mentioned as a class variable in several places. I also checked that :attr:`send_error` does generate a link to send_error method in html.

----------

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

From report at bugs.python.org  Tue Mar 18 09:34:08 2014
From: report at bugs.python.org (Anastasia.Filatova)
Date: Tue, 18 Mar 2014 08:34:08 +0000
Subject: [docs] [issue20112] The documentation for http.server
	error_message_format	is inadequate.
In-Reply-To: <1388701952.2.0.132957137739.issue20112@psf.upfronthosting.co.za>
Message-ID: <1395131648.16.0.98645498646.issue20112@psf.upfronthosting.co.za>


Changes by Anastasia.Filatova <anastasia.n.filatova at gmail.com>:


Added file: http://bugs.python.org/file34483/Issue20112_py27.patch

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

From report at bugs.python.org  Tue Mar 18 09:56:15 2014
From: report at bugs.python.org (andy.ma)
Date: Tue, 18 Mar 2014 08:56:15 +0000
Subject: [docs] [issue17110] sys.argv docs should explaining how to handle
	encoding	issues
In-Reply-To: <1359864071.69.0.659089821533.issue17110@psf.upfronthosting.co.za>
Message-ID: <1395132975.9.0.566458392983.issue17110@psf.upfronthosting.co.za>


Changes by andy.ma <andy.junma at gmail.com>:


----------
nosy: +andyma

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

From report at bugs.python.org  Tue Mar 18 10:07:19 2014
From: report at bugs.python.org (andy.ma)
Date: Tue, 18 Mar 2014 09:07:19 +0000
Subject: [docs] [issue20966] Documentation Link for "Python Tkinter
	Resources" is	currently broken
Message-ID: <1395133639.04.0.49728308047.issue20966@psf.upfronthosting.co.za>


New submission from andy.ma:

The "Python Tkinter Resources" link(http://www.python.org/topics/tkinter/) resides in the topic of "tkinter ? Python interface to Tcl/Tk"(http://docs.python.org/2/library/tkinter.html) is currently broken.

It redirects to "https://www.python.org/topics/tkinter/" which presented a 404 error.

----------
assignee: docs at python
components: Documentation
messages: 213950
nosy: andyma, docs at python
priority: normal
severity: normal
status: open
title: Documentation Link for "Python Tkinter Resources" is currently broken
type: resource usage
versions: Python 2.7, Python 3.1, Python 3.2, Python 3.3, Python 3.4, Python 3.5

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

From report at bugs.python.org  Tue Mar 18 12:17:57 2014
From: report at bugs.python.org (Anastasia.Filatova)
Date: Tue, 18 Mar 2014 11:17:57 +0000
Subject: [docs] [issue17462] argparse FAQ: how it is different from optparse
In-Reply-To: <1363624948.23.0.605198582935.issue17462@psf.upfronthosting.co.za>
Message-ID: <1395141477.52.0.0520285482949.issue17462@psf.upfronthosting.co.za>


Anastasia.Filatova added the comment:

Now argparse documentation includes a paragraph about advantages of argparse module over optparse module.

----------
keywords: +patch
nosy: +Anastasia.Filatova
Added file: http://bugs.python.org/file34486/Issue17462_py27.patch

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

From report at bugs.python.org  Tue Mar 18 12:20:27 2014
From: report at bugs.python.org (Anastasia.Filatova)
Date: Tue, 18 Mar 2014 11:20:27 +0000
Subject: [docs] [issue17462] argparse FAQ: how it is different from optparse
In-Reply-To: <1363624948.23.0.605198582935.issue17462@psf.upfronthosting.co.za>
Message-ID: <1395141627.07.0.540807664762.issue17462@psf.upfronthosting.co.za>


Changes by Anastasia.Filatova <anastasia.n.filatova at gmail.com>:


Added file: http://bugs.python.org/file34487/Issue17462_py33.patch

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

From report at bugs.python.org  Tue Mar 18 12:22:46 2014
From: report at bugs.python.org (Anastasia.Filatova)
Date: Tue, 18 Mar 2014 11:22:46 +0000
Subject: [docs] [issue17462] argparse FAQ: how it is different from optparse
In-Reply-To: <1363624948.23.0.605198582935.issue17462@psf.upfronthosting.co.za>
Message-ID: <1395141766.91.0.706353676696.issue17462@psf.upfronthosting.co.za>


Changes by Anastasia.Filatova <anastasia.n.filatova at gmail.com>:


Added file: http://bugs.python.org/file34488/Issue17462_py34.patch

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

From techtonik at gmail.com  Tue Mar 18 13:39:15 2014
From: techtonik at gmail.com (techtonik at gmail.com)
Date: Tue, 18 Mar 2014 12:39:15 -0000
Subject: [docs] argparse FAQ: how it is different from optparse (issue 17462)
Message-ID: <20140318123915.27921.17381@psf.upfronthosting.co.za>

Reviewers: ,


http://bugs.python.org/review/17462/diff/11350/Doc/library/argparse.rst
File Doc/library/argparse.rst (right):

http://bugs.python.org/review/17462/diff/11350/Doc/library/argparse.rst#newcode1892
Doc/library/argparse.rst:1892: * Providing a much simpler interface for
custom ``type`` and ``action``.
This info is copy/pasted from
http://stackoverflow.com/questions/3217673/why-use-argparse-rather-than-optparse
which is `cc by-sa 3.0 with attribution required`, so please consult on
core mailing list how to handle that.



Please review this at http://bugs.python.org/review/17462/

Affected files:
  Doc/library/argparse.rst


diff -r 14c1ff6a8086 Doc/library/argparse.rst
--- a/Doc/library/argparse.rst	Tue Mar 11 08:12:48 2014 +0100
+++ b/Doc/library/argparse.rst	Tue Mar 18 12:22:01 2014 +0100
@@ -1915,6 +1915,16 @@
 :mod:`optparse` had either been copy-pasted over or monkey-patched, it no
 longer seemed practical to try to maintain the backwards compatibility.
 
+The :mod:`argparse` module improves on the standard library :mod:`optparse` 
+module in a number of ways including:
+
+* Handling positional arguments.
+* Supporting sub-commands.
+* Allowing alternative option prefixes like ``+`` and ``/``.
+* Handling zero-or-more and one-or-more style arguments.
+* Producing more informative usage messages.
+* Providing a much simpler interface for custom ``type`` and ``action``.
+
 A partial upgrade path from :mod:`optparse` to :mod:`argparse`:
 
 * Replace all :meth:`optparse.OptionParser.add_option` calls with



From merwok at netwok.org  Tue Mar 18 14:37:31 2014
From: merwok at netwok.org (merwok at netwok.org)
Date: Tue, 18 Mar 2014 13:37:31 -0000
Subject: [docs] argparse FAQ: how it is different from optparse (issue
	17462)
Message-ID: <20140318133731.27921.40985@psf.upfronthosting.co.za>

Not really, this list was copied from the argparse documentation (in the
StackOverflow response: ?argparse is better for all the reasons listed
on its original page (http://code.google.com/p/argparse/)?).

This doc was written by argparse?s author, who is a Python core
developer and signed a contributor agreement for argparse code, docs and
tests.  We can safely include this patch.

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

From report at bugs.python.org  Tue Mar 18 14:39:38 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Tue, 18 Mar 2014 13:39:38 +0000
Subject: [docs] [issue17462] argparse FAQ: how it is different from optparse
In-Reply-To: <1363624948.23.0.605198582935.issue17462@psf.upfronthosting.co.za>
Message-ID: <1395149978.59.0.317940037241.issue17462@psf.upfronthosting.co.za>


?ric Araujo added the comment:

Thanks for the patch, will apply.

----------
assignee: docs at python -> eric.araujo
stage: needs patch -> commit review

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

From kathleen at kweaver.org  Tue Mar 18 02:27:06 2014
From: kathleen at kweaver.org (kathleen at kweaver.org)
Date: Tue, 18 Mar 2014 01:27:06 -0000
Subject: [docs] Bring Doc/using/windows up to date (issue 20265)
Message-ID: <20140318012706.27921.79592@psf.upfronthosting.co.za>

I've just uploaded the new patches.


http://bugs.python.org/review/20265/diff/11287/Doc/faq/windows.rst
File Doc/faq/windows.rst (right):

http://bugs.python.org/review/20265/diff/11287/Doc/faq/windows.rst#newcode14
Doc/faq/windows.rst:14: XXX need review for Windows Vista/Seven?
On 2014/03/13 15:11:23, Zach Ware wrote:
> If you've confirmed that things are right for Python 3 and Windows
past Vista,
> you can remove these comments.

I left the comment since I just review for 7/8  I'm hoping no one has
Vista any more.

Done.

http://bugs.python.org/review/20265/diff/11287/Doc/faq/windows.rst#newcode42
Doc/faq/windows.rst:42: Windows Icon or type Command Prompt at the Start
Menu.  You should be able to recognize
On 2014/03/13 15:11:23, Zach Ware wrote:
> A general comment that applies throughout the docs: long lines should
be wrapped
> somewhere under 80 characters, matching what the rest of the file
does.  I would
> actually suggest wrapping at 78 characters, which should prevent line
wrapping
> in an 80 character wide Command Prompt when viewing a diff (80, minus
1 for the
> +/ /- diff character, and 1 for the two-character EOL on Windows).

Done.

http://bugs.python.org/review/20265/diff/11287/Doc/faq/windows.rst#newcode119
Doc/faq/windows.rst:119: a list of directories where Windows will look
for programs.
On 2014/03/13 06:34:55, eric.araujo wrote:
> Minor: trailing whitespace here.

Done.

http://bugs.python.org/review/20265/diff/11287/Doc/faq/windows.rst#newcode143
Doc/faq/windows.rst:143: :ref:`below<setting-envvars>` .
On 2014/03/13 06:34:55, eric.araujo wrote:
> Minor: please add a space before the <.

Done.

http://bugs.python.org/review/20265/diff/11287/Doc/faq/windows.rst#newcode352
Doc/faq/windows.rst:352: How do I Change Enviroment Settings?
On 2014/03/13 06:34:55, eric.araujo wrote:
> Typo: Environment

Done.

http://bugs.python.org/review/20265/diff/11287/Doc/faq/windows.rst#newcode359
Doc/faq/windows.rst:359: Windows XP: Right-click the icon for your
machine
On 2014/03/13 06:34:55, eric.araujo wrote:
> Indentation is like special markup in reStructuredText; here it would
mean
> ?quote block?, which is not your intent, I think.

I am not sure I understand.  I want to separate Windows XP directions
from Windows 7 and from Windows 8.  Please suggest a better way.

http://bugs.python.org/review/20265/diff/11287/Doc/using/windows.rst
File Doc/using/windows.rst (right):

http://bugs.python.org/review/20265/diff/11287/Doc/using/windows.rst#newcode49
Doc/using/windows.rst:49: .. see also::
On 2014/03/13 06:34:55, eric.araujo wrote:
> Roles and directives in reStructuredText are like keywords in Python
code:
> changing one letter or adding a space makes them invalid.  If you
build the doc,
> you?ll get a warning for that line.
> 
> http://sphinx-doc.org/rest.html#directives
> http://sphinx-doc.org/markup/para.html#directive-seealso

Didn't see one but put it back.

http://bugs.python.org/review/20265/diff/11287/Doc/using/windows.rst#newcode61
Doc/using/windows.rst:61: `For Windows users
<http://swaroopch.com/text/Byte_of_Python:Installing_Python#For_Windows_users>`_
On 2014/03/13 06:34:55, eric.araujo wrote:
> This link changed (the right address is used just below).

Done.

http://bugs.python.org/review/20265/diff/11287/Doc/using/windows.rst#newcode63
Doc/using/windows.rst:63: in "`A Byte of Python
<http://swaroopch.com/notes/python_en-installation/>`_"
On 2014/03/13 06:34:55, eric.araujo wrote:
> I see that the byteofpython.info domain name is not useful anymore; I
would
> remove that line.

Done.

http://bugs.python.org/review/20265/diff/11287/Doc/using/windows.rst#newcode83
Doc/using/windows.rst:83: .. sectionauthor:: Kathleen Weaver
<kathleen at kweaver.org>
On 2014/03/13 06:34:55, eric.araujo wrote:
> Sections are created by headings, so a directive applying to a section
should be
> after the heading.
> 
> In general, there aren?t many ?sectionauthor? directives in doc files,
but just
> one or two at the top of the file.

I removed those.  Is there a way I should indicate I made major
additions?

http://bugs.python.org/review/20265/diff/11287/Doc/using/windows.rst#newcode88
Doc/using/windows.rst:88: The following shortcuts are creating during
installation and can be used to run Python:
On 2014/03/13 15:11:23, Zach Ware wrote:
> creating -> created

Done.

http://bugs.python.org/review/20265/diff/11287/Doc/using/windows.rst#newcode105
Doc/using/windows.rst:105: raw_input()
On 2014/03/13 15:11:23, Zach Ware wrote:
> raw_input doesn't exist in Python 3, just input().  I'm not sure we
want to
> encourage this kind of workaround anyway.  If you need the output, run
from a
> Command Prompt window or write it to a file.  It'll quickly become
annoying
> having to remember to hit Enter at the end of every script run. 
Besides, this
> trick won't work in the most common case where you really want the
output:
> unhandled exceptions.

I will remove.  It was something I found in my research.

http://bugs.python.org/review/20265/diff/11287/Doc/using/windows.rst#newcode212
Doc/using/windows.rst:212: #. Launch a command prompt [Windows 8 -
Launch Command Prompt (Admin)]
On 2014/03/13 15:11:23, Zach Ware wrote:
> I don't think this new comment adds much, considering the "(might
require
> administrative rights)" comment a line above and the fact that it
probably
> applies to Vista and 7 as well as 8.  It may be better to move that
comment to
> this line, though; it fits better here since this is the step where
you would
> acquire admin privileges.

Actually it is a new available option for Windows 8 users, so it should
be there.  The average Windows 8 probably doesn't know there are two
choices, it had me scratching my head for a while.

http://bugs.python.org/review/20265/diff/11287/Doc/using/windows.rst#newcode220
Doc/using/windows.rst:220: 
On 2014/03/13 15:11:23, Zach Ware wrote:
> I don't think the blank line here should have been removed. 
Whitespace is even
> more important in reStructuredText than in Python: vertical whitespace
means
> something too in some situations :)

Done.

http://bugs.python.org/review/20265/diff/11300/Doc/faq/windows.rst
File Doc/faq/windows.rst (right):

http://bugs.python.org/review/20265/diff/11300/Doc/faq/windows.rst#newcode14
Doc/faq/windows.rst:14: XXX need review for Windows Vista/Seven?
Reviewed Windows 7/8 by kw
So when we accomplish a task on a comment, we delete the comment?

On 2014/03/15 05:13:58, Zach Ware wrote:
> Better to just remove the comment.  If we have XP and 7 covered, Vista
should be
> pretty well covered too.  The number of people still stuck with Vista
is pretty
> small compared to XP and 7+ anyway.

http://bugs.python.org/review/20265/diff/11300/Doc/faq/windows.rst#newcode23
Doc/faq/windows.rst:23: Some users may find that method more efficient
than the below method.
On 2014/03/15 05:13:58, Zach Ware wrote:
> I think adding this paragraph before the next one makes the next one
make less
> sense.  I think it would be better to segue into this from the end of
the next
> paragraph, something like "The situation has been made somewhat
simpler since
> Python 3.3, which introduced the :ref:`launcher`..."

Done.

http://bugs.python.org/review/20265/diff/11300/Doc/faq/windows.rst#newcode49
Doc/faq/windows.rst:49: "command prompt", which usually looks like
this::
On 2014/03/15 05:13:58, Zach Ware wrote:
> Sorry, I wasn't entirely clear.  Lines that you've changed should be
wrapped at
> <80 characters, but lines that you haven't changed should be left as
is.  If you
> have to, you can leave a very short line in the middle of a paragraph,
and if
> it's really bad, the committer can reflow the paragraph at commit
time.
> 
> For instance, this paragraph could be left like this:
> 
> @@ -37,7 +38,8 @@
>  *typing* Windows commands into what is variously referred to as a
"DOS window"
>  or "Command prompt window".  Usually you can create such a window
from your
>  Start menu; under Windows 7 the menu selection is
:menuselection:`Start -->
> -Programs --> Accessories --> Command Prompt`.  You should be able to
recognize
> +Programs --> Accessories --> Command Prompt`; under Windows 8 right
click the
> +Windows Icon or type Command Prompt at the Start Menu.  You should be
able to
> +recognize
>  when you have started such a window because you will see a Windows
"command
>  prompt", which usually looks like this::

Done.

http://bugs.python.org/review/20265/diff/11300/Doc/faq/windows.rst#newcode142
Doc/faq/windows.rst:142: an "Enter" to get out of it). Once you have
verified the directory, you can
On 2014/03/15 05:13:58, Zach Ware wrote:
> This comment about needing Ctrl-Z to exit the interpreter isn't quite
right
> anymore, there is now exit() and quit().  Since this looks like a
reminder of a
> previous notice, that previous notice could stand to be removed (or
reworded) as
> well.

Done.

http://bugs.python.org/review/20265/diff/11300/Doc/faq/windows.rst#newcode147
Doc/faq/windows.rst:147: More information about environment variables
and path can be found
On 2014/03/15 05:13:58, Zach Ware wrote:
> The added "and path" doesn't sound right to me, but I can't put my
finger on
> what's wrong with it.
I've decided to take the directions for environment variables out.

http://bugs.python.org/review/20265/diff/11300/Doc/faq/windows.rst#newcode361
Doc/faq/windows.rst:361: built-in dialog.  There is an alternative
method that works for prior
On 2014/03/15 05:13:58, Zach Ware wrote:
> This isn't true, `set` and `setx` work just as well on 7+.

Okay, it doesn't work on some of my machines. However, two of those
machines have been in an restricted environment, and they have added
oddly ever since.  It does work on this machine, which is Windows 8 and
it hasn't been exposed <grin>

http://bugs.python.org/review/20265/diff/11300/Doc/faq/windows.rst#newcode375
Doc/faq/windows.rst:375: --> Advanced
It does work, but the method for Windows 7 is shorter, and even shorter
for Windows 8.

On 2014/03/15 05:13:58, Zach Ware wrote:
> This also works for 7, except "My Computer" is just "Computer" and
"Advanced" is
> "Advanced System Settings" in the left side menu.  I'm pretty sure it
also works
> on 8, but I've only tried it once and don't remember for certain.

http://bugs.python.org/review/20265/diff/11300/Doc/faq/windows.rst#newcode378
Doc/faq/windows.rst:378: Windows 7: Right-click the Windows Icon, choose
:menuselection:`Contol Panel`.
Yes, there is a Windows Icon on Windows 7 that takes you to the start
menu.  That Icon went away on Windows 8 and came back on Windows 8.1  

You click on it for Windows 7 (my mistake) and right click on it for
Windows 8.

This is the shortest path to get there from the desktop.

On 2014/03/15 05:13:58, Zach Ware wrote:
> What do you mean by "Windows Icon"? Is that the Start Menu button
(that hasn't
> said 'start' since Vista)?  If I right click on it in 7, I only get
"Properties"
> and "Open Windows Explorer".

http://bugs.python.org/review/20265/diff/11300/Doc/faq/windows.rst#newcode389
Doc/faq/windows.rst:389: Windows 8: Right-click the Windows Icon, choose
On 2014/03/15 05:13:58, Zach Ware wrote:
> Same question about Windows Icon, though I haven't tested on 8.

Right click is correct.  Clicking takes you to the start menu.

http://bugs.python.org/review/20265/diff/11300/Doc/faq/windows.rst#newcode405
Doc/faq/windows.rst:405: Windows 7 and 8 is using the :command:`set`
On 2014/03/15 05:13:58, Zach Ware wrote:
> This is still true for 7 and 8.

Put it back, I tried it on an "unaffected" machine.

http://bugs.python.org/review/20265/diff/11300/Doc/using/windows.rst
File Doc/using/windows.rst (right):

http://bugs.python.org/review/20265/diff/11300/Doc/using/windows.rst#newcode23
Doc/using/windows.rst:23: 
On 2014/03/15 05:13:58, Zach Ware wrote:
> A couple too many blank lines.

Done.

http://bugs.python.org/review/20265/diff/11300/Doc/using/windows.rst#newcode26
Doc/using/windows.rst:26: Start Menu under the title Python x.x where
x.x is the version number.
On 2014/03/15 05:13:58, Zach Ware wrote:
> I think there is markup for something that expands to the version
number
> (`|version|` perhaps?) that would simplify this.  Or just hard code
the version
> and we'll add it as a place that needs to change at release time.

Yes, but we tell them that they can run multiple versions at once
sometime here....

http://bugs.python.org/review/20265/diff/11300/Doc/using/windows.rst#newcode28
Doc/using/windows.rst:28: * IDLE (Python GUI) - suitable for creating
and running Python Scripts along with being a command line interpreter
On 2014/03/15 05:13:58, Zach Ware wrote:
> I think IDLE can be better described as "a simple IDE for Python,
written in
> Python using Tkinter"

Done.

http://bugs.python.org/review/20265/diff/11300/Doc/using/windows.rst#newcode28
Doc/using/windows.rst:28: * IDLE (Python GUI) - suitable for creating
and running Python Scripts along with being a command line interpreter
On 2014/03/15 05:13:58, Zach Ware wrote:
> I think IDLE can be better described as "a simple IDE for Python,
written in
> Python using Tkinter"

Done.

http://bugs.python.org/review/20265/diff/11300/Doc/using/windows.rst#newcode32
Doc/using/windows.rst:32: 
On 2014/03/15 05:13:58, Zach Ware wrote:
> The 'Module Docs' entry is missing.

Done.

http://bugs.python.org/review/20265/diff/11300/Doc/using/windows.rst#newcode34
Doc/using/windows.rst:34: prompt typically runs the last installed
version of Python.
On 2014/03/15 05:13:58, Zach Ware wrote:
> This isn't really true: Command Prompt runs whichever one it finds
first when it
> checks PATH for 'python', which will be none of the above unless you
choose to
> let the installer change your PATH.  I'm not sure how best to word
that for this
> section, so it may be best to just nix this sentence and cover it in
more detail
> elsewhere.

Done.

http://bugs.python.org/review/20265/diff/11300/Doc/using/windows.rst#newcode60
Doc/using/windows.rst:60: in "`Installing Python"
<http://swaroopch.com/notes/python_en-installation/>`_"
I deleted it then.

On 2014/03/15 05:13:58, Zach Ware wrote:
> This needs some work; the section in question no longer has "For
Windows users"
> in its title anywhere, and is "Python: Installation" rather than
"Installing
> Python".  Also, it looks like this guide doesn't say anything that we
aren't
> already saying here or in the FAQ.

http://bugs.python.org/review/20265/diff/11300/Doc/using/windows.rst#newcode97
Doc/using/windows.rst:97: window will close immediately, usually faster
than the user can read.
On 2014/03/15 05:13:58, Zach Ware wrote:
> Both of these lines and several others have trailing whitespace.  You
can get
> rid of all trailing whitespace with relative ease by running
> Tools\scripts\patchcheck.py using a repository build of Python
> (PCbuild\python[_d].exe) before creating the patch file for upload.

Done.

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

From report at bugs.python.org  Tue Mar 18 15:20:46 2014
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 18 Mar 2014 14:20:46 +0000
Subject: [docs] [issue20966] Documentation Link for "Python Tkinter
	Resources" is	currently broken
In-Reply-To: <1395133639.04.0.49728308047.issue20966@psf.upfronthosting.co.za>
Message-ID: <3fpGkj34JGz7LjV@mail.python.org>


Roundup Robot added the comment:

New changeset be1e015a8405 by Zachary Ware in branch '2.7':
Issue #20966: Fix Tkinter Resources link
http://hg.python.org/cpython/rev/be1e015a8405

New changeset f28f63c5d30a by Zachary Ware in branch '3.4':
Issue #20966: Fix Tkinter Resources link
http://hg.python.org/cpython/rev/f28f63c5d30a

New changeset f8b40d33e45d by Zachary Ware in branch 'default':
Closes #20966: Fix Tkinter Resources link (merge from 3.4)
http://hg.python.org/cpython/rev/f8b40d33e45d

----------
nosy: +python-dev
resolution:  -> fixed
stage:  -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Tue Mar 18 15:21:32 2014
From: report at bugs.python.org (Zachary Ware)
Date: Tue, 18 Mar 2014 14:21:32 +0000
Subject: [docs] [issue20966] Documentation Link for "Python Tkinter
	Resources" is	currently broken
In-Reply-To: <1395133639.04.0.49728308047.issue20966@psf.upfronthosting.co.za>
Message-ID: <1395152492.35.0.501096470742.issue20966@psf.upfronthosting.co.za>


Zachary Ware added the comment:

Fixed, thanks for the report!

----------
nosy: +zach.ware
type: resource usage -> behavior
versions:  -Python 3.1, Python 3.2, Python 3.3

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

From report at bugs.python.org  Tue Mar 18 15:34:09 2014
From: report at bugs.python.org (Christian Clauss)
Date: Tue, 18 Mar 2014 14:34:09 +0000
Subject: [docs] [issue20969] Author of EPUB version of Python docs is set to
	Unknown	instead of PSF
Message-ID: <1395153249.12.0.327856107433.issue20969@psf.upfronthosting.co.za>


New submission from Christian Clauss:

http://docs.python.org/3/download.html has an EPUB version of the Python docs but the Author of the document is set to Unknown so this text appears on the cover page and is repeated on the top of every other page throughout the document (in the iBooks app at least). Perhaps something like The Python Software Foundation would be better than Unknown.

To fix this issue, both Makefile and make.bat in https://github.com/python/pythondotorg/blob/master/docs would need to be modified to add the Sphinx -A option to the EPUB make. Perhaps the Release (-R) and/or Version (-V) should also be set to the relevant Python version number.

----------
assignee: docs at python
components: Documentation
messages: 213972
nosy: Christian.Clauss, docs at python
priority: normal
severity: normal
status: open
title: Author of EPUB version of Python docs is set to Unknown instead of PSF
type: enhancement
versions: Python 3.4

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

From report at bugs.python.org  Tue Mar 18 16:54:49 2014
From: report at bugs.python.org (Jim Jewett)
Date: Tue, 18 Mar 2014 15:54:49 +0000
Subject: [docs] [issue11352] Update cgi module doc
In-Reply-To: <1298895261.86.0.965235067518.issue11352@psf.upfronthosting.co.za>
Message-ID: <1395158088.89.0.712734983476.issue11352@psf.upfronthosting.co.za>


Jim Jewett added the comment:

What is the status of this?

Have any of the changes been applied?
Are any of the other patches still appropriate?
Is this now dependent on any other issues/any non-doc updates?

----------
nosy: +Jim.Jewett

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

From report at bugs.python.org  Tue Mar 18 17:42:49 2014
From: report at bugs.python.org (Aaron Meurer)
Date: Tue, 18 Mar 2014 16:42:49 +0000
Subject: [docs] [issue20970] contradictory documentation for prog option of
	argparse
Message-ID: <1395160969.17.0.758674872934.issue20970@psf.upfronthosting.co.za>


New submission from Aaron Meurer:

I hope it's OK to report documentation issues on this tracker.  Reading http://docs.python.org/3.4/library/argparse.html#prog I had to do a double take. The documentation states, "By default, ArgumentParser objects uses sys.argv[0] to determine how to display the name of the program in help messages." The example then goes on to show it *not* using sys.argv[0] (sys.argv[0] in the second example would be 'subdir\myprogram.py'). 

Furthermore, even though the commands are apparently POSIX style, with a $ prompt and using cd, they use a backslash to access a subdirectory.

----------
assignee: docs at python
components: Documentation
messages: 213988
nosy: Aaron.Meurer, docs at python
priority: normal
severity: normal
status: open
title: contradictory documentation for prog option of argparse

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

From report at bugs.python.org  Tue Mar 18 19:01:59 2014
From: report at bugs.python.org (R. David Murray)
Date: Tue, 18 Mar 2014 18:01:59 +0000
Subject: [docs] [issue20970] contradictory documentation for prog option of
	argparse
In-Reply-To: <1395160969.17.0.758674872934.issue20970@psf.upfronthosting.co.za>
Message-ID: <1395165719.33.0.61301683888.issue20970@psf.upfronthosting.co.za>


R. David Murray added the comment:

You missed the part where it says "no matter where it is called from".  That is, the path is stripped off.  The sentence could be changed to emphasize that ("the :ref:`~os.basename` of sys.argv[0]").

The backslash is indeed a bit odd and probably should be changed.

----------
nosy: +r.david.murray
versions: +Python 2.7, Python 3.4, Python 3.5

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

From report at bugs.python.org  Tue Mar 18 20:40:45 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Tue, 18 Mar 2014 19:40:45 +0000
Subject: [docs] [issue20970] contradictory documentation for prog option of
	argparse
In-Reply-To: <1395160969.17.0.758674872934.issue20970@psf.upfronthosting.co.za>
Message-ID: <1395171645.2.0.360192960896.issue20970@psf.upfronthosting.co.za>


Changes by ?ric Araujo <merwok at netwok.org>:


----------
nosy: +eric.araujo

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

From report at bugs.python.org  Tue Mar 18 21:14:56 2014
From: report at bugs.python.org (paul j3)
Date: Tue, 18 Mar 2014 20:14:56 +0000
Subject: [docs] [issue20970] contradictory documentation for prog option of
	argparse
In-Reply-To: <1395160969.17.0.758674872934.issue20970@psf.upfronthosting.co.za>
Message-ID: <1395173696.69.0.3299657797.issue20970@psf.upfronthosting.co.za>


paul j3 added the comment:

Yes, the documentation is accurate but a bit vague.  It doesn't say how 'it uses sys.arg[0]'.  The example implies it uses 'basename'. So the question is, whether that implementation detail should be more explicit?

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

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

From report at bugs.python.org  Tue Mar 18 21:34:45 2014
From: report at bugs.python.org (R. David Murray)
Date: Tue, 18 Mar 2014 20:34:45 +0000
Subject: [docs] [issue20970] contradictory documentation for prog option of
	argparse
In-Reply-To: <1395160969.17.0.758674872934.issue20970@psf.upfronthosting.co.za>
Message-ID: <1395174885.63.0.48943638219.issue20970@psf.upfronthosting.co.za>


R. David Murray added the comment:

I didn't mean the basename reference as exposing an implementation detail (I didn't look) but rather as a shorthand for explaining what "regardless of where the program was invoked from" means.

----------

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

From report at bugs.python.org  Tue Mar 18 22:08:30 2014
From: report at bugs.python.org (Jim Jewett)
Date: Tue, 18 Mar 2014 21:08:30 +0000
Subject: [docs] [issue20974] email module docs say not compatible with
	current python	version
Message-ID: <1395176910.11.0.458502603486.issue20974@psf.upfronthosting.co.za>


New submission from Jim Jewett:

http://docs.python.org/3.4/library/email.html#package-history

The table ends with email version 5.1, distributed with Python 3.2, and compatible with Python 3.0 to 3.2.

Since Python 3.3 and 3.4 also distribute 5.1.0, I'm betting that the actual compatibility is at least 3.0-3.4.  (Currently, it is also used on the 3.5 tip, but I suppose we don't want to guarantee that yet.)

----------
assignee: docs at python
components: Documentation, email
keywords: easy
messages: 214018
nosy: Jim.Jewett, barry, docs at python, r.david.murray
priority: normal
severity: normal
status: open
title: email module docs say not compatible with current python version
versions: Python 3.3, Python 3.4, Python 3.5

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

From report at bugs.python.org  Tue Mar 18 22:33:01 2014
From: report at bugs.python.org (Antoine Pitrou)
Date: Tue, 18 Mar 2014 21:33:01 +0000
Subject: [docs] [issue17110] sys.argv docs should explaining how to handle
	encoding	issues
In-Reply-To: <1359864071.69.0.659089821533.issue17110@psf.upfronthosting.co.za>
Message-ID: <1395178381.63.0.914942833107.issue17110@psf.upfronthosting.co.za>


Antoine Pitrou added the comment:

Hmm, I'm not sure where those explanations belong but I'm not sure should be in the sys module docs (especially as they are quite lengthy, and they also apply to other data such as os.environ). Perhaps the Unicode HOWTO?

----------

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

From report at bugs.python.org  Tue Mar 18 22:38:21 2014
From: report at bugs.python.org (Antoine Pitrou)
Date: Tue, 18 Mar 2014 21:38:21 +0000
Subject: [docs] [issue20906] Issues in Unicode HOWTO
In-Reply-To: <1394702187.81.0.00522221343959.issue20906@psf.upfronthosting.co.za>
Message-ID: <1395178701.85.0.72133892695.issue20906@psf.upfronthosting.co.za>


Antoine Pitrou added the comment:

> Agreed. How about "In documentation such as the current article..."

It's better, but how about simply "In this article"?

> I concur with reducing unnecessary abstraction. No sure what you mean 
> by "true form". Do you mean show the glyph which the code point
> represents? Or the sequence of bytes? Or display the code point value 
> in decimal? 

I mean the glyph.

> In the older schemes, "encoding" referred to the one mapping: chars <-->
> numbers in particular binary format. In Unicode, "encoding" refers only to 
> the mapping: code point numbers <--> binary format. It does not refer to
> the chars <--> code point mapping. (At least, I think that's the case.
> Regardless, the two mappings need to be rigorously distinguished.)

This is true, but in this HOWTO's context the term "code system" is a confusing distraction, IMHO. For all intents and purposes, iso-8859-1 and friends *are* encodings (and this is how Python actually names them).

> On review, there are many points in the article that muddy this up.  For
> example, "Unicode started out using 16-bit characters instead of 8-bit
> characters". Saying "so-an-so-bit characters" about Unicode, in the
> current article, is either wrong, or very confusing.

So it should say "16-bit code points" instead, right?

> The subject of one-chararacter-to-one-code mapping is important
> (normalization etc), though perhaps beyond the current article. But I
> think the article should avoid suggesting that many-to-one or one-to-many 
> scenarios are common.

Agreed.

----------

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

From report at bugs.python.org  Tue Mar 18 22:49:58 2014
From: report at bugs.python.org (=?utf-8?q?Bo=C5=A1tjan_Mejak?=)
Date: Tue, 18 Mar 2014 21:49:58 +0000
Subject: [docs] [issue20975] Python 3.4 build info wrong in code snippet
Message-ID: <1395179398.5.0.851425870515.issue20975@psf.upfronthosting.co.za>


New submission from Bo?tjan Mejak:

Notice the wrong build info of Python 3.4 interpreter in the first code snippet at http://docs.python.org/3/tutorial/interpreter.html#interactive-mode. I know this snippet is just an example to show what does executing the command python3.4 do, but still. Anyone interested in fixing this little nuance?

----------
assignee: docs at python
components: Documentation
messages: 214029
nosy: Zvezdoslovec, docs at python
priority: normal
severity: normal
status: open
title: Python 3.4 build info wrong in code snippet
type: enhancement
versions: Python 3.4

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

From report at bugs.python.org  Tue Mar 18 22:51:27 2014
From: report at bugs.python.org (A.M. Kuchling)
Date: Tue, 18 Mar 2014 21:51:27 +0000
Subject: [docs] [issue13437] Provide links to the source code for every
	module in the	documentation
In-Reply-To: <1321748971.83.0.182041155467.issue13437@psf.upfronthosting.co.za>
Message-ID: <1395179487.88.0.914547012285.issue13437@psf.upfronthosting.co.za>


A.M. Kuchling added the comment:

Here's a patch for some of Julian's suggested modules.  I went through Julian's list and included code links for the ones that a) weren't packages or only written in C, b) only had one Python file (which excluded os.path = posixpath.py/ntpath.py) and c) had docstrings or comments that seemed useful.

datetime and difflib in particular have very good comments (and they're both by Tim Peters).  Possibly controversial: for CSV the patch links to both csv.py and _csv.c; for decimal it links to decimal.py and _decimal.c.  We could exclude these two.

----------
nosy: +akuchling
Added file: http://bugs.python.org/file34499/13437-patch.txt

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

From report at bugs.python.org  Tue Mar 18 23:28:59 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Tue, 18 Mar 2014 22:28:59 +0000
Subject: [docs] [issue20975] Python 3.4 build info wrong in code snippet
In-Reply-To: <1395179398.5.0.851425870515.issue20975@psf.upfronthosting.co.za>
Message-ID: <1395181739.65.0.197635752754.issue20975@psf.upfronthosting.co.za>


?ric Araujo added the comment:

I see two differences in my build, but I don?t think it?s really wrong, or that it does harm.  What exactly would you change?

----------
nosy: +eric.araujo

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

From report at bugs.python.org  Wed Mar 19 00:20:14 2014
From: report at bugs.python.org (A.M. Kuchling)
Date: Tue, 18 Mar 2014 23:20:14 +0000
Subject: [docs] [issue14332] Better explain "junk" concept in difflib doc
In-Reply-To: <1331877125.66.0.103153393744.issue14332@psf.upfronthosting.co.za>
Message-ID: <1395184813.94.0.974579787848.issue14332@psf.upfronthosting.co.za>


A.M. Kuchling added the comment:

Thanks for your patch!  I took it and added some more text describing what junk is, and clarifying that junk affects what's matched but doesn't cause any differences to be ignored.

----------
nosy: +akuchling
stage: needs patch -> patch review
Added file: http://bugs.python.org/file34502/14332.patch

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

From report at bugs.python.org  Wed Mar 19 01:18:18 2014
From: report at bugs.python.org (Aaron Meurer)
Date: Wed, 19 Mar 2014 00:18:18 +0000
Subject: [docs] [issue20970] contradictory documentation for prog option of
	argparse
In-Reply-To: <1395160969.17.0.758674872934.issue20970@psf.upfronthosting.co.za>
Message-ID: <1395188298.08.0.269538385609.issue20970@psf.upfronthosting.co.za>


Aaron Meurer added the comment:

The next sentence further confuses things, "This default is almost always desirable because it will make the help messages match how the program was invoked on the command line." It makes it sound like it really did intend to use sys.argv[0] literally.

----------

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

From report at bugs.python.org  Wed Mar 19 01:36:44 2014
From: report at bugs.python.org (paul j3)
Date: Wed, 19 Mar 2014 00:36:44 +0000
Subject: [docs] [issue20970] contradictory documentation for prog option of
	argparse
In-Reply-To: <1395160969.17.0.758674872934.issue20970@psf.upfronthosting.co.za>
Message-ID: <1395189404.47.0.704634026479.issue20970@psf.upfronthosting.co.za>


paul j3 added the comment:

The relevant code is:

    prog = _os.path.basename(_sys.argv[0])

----------

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

From report at bugs.python.org  Wed Mar 19 02:27:56 2014
From: report at bugs.python.org (R. David Murray)
Date: Wed, 19 Mar 2014 01:27:56 +0000
Subject: [docs] [issue20974] email module docs say not compatible with
	current python	version
In-Reply-To: <1395176910.11.0.458502603486.issue20974@psf.upfronthosting.co.za>
Message-ID: <1395192476.11.0.159799592617.issue20974@psf.upfronthosting.co.za>


R. David Murray added the comment:

That table is actually correct as it stands.  Post 5.1 I pretty much stopped tracking the email version independently of the python version.  So most likely the 3.3 python isn't compatible with 3.2, and the same for 3.4 and 3.3.  

Let's get Barry's agreement that that is OK, and I'll add a note to the docs to that effect.  If he wants separate version numbers I can increment it in 3.4, but it is probably too late for 3.3.  If we can drop the independent version, then we have to decide if we want to deprecate the __version__ string or just remove it.

----------

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

From report at bugs.python.org  Wed Mar 19 02:33:31 2014
From: report at bugs.python.org (Lina Clark)
Date: Wed, 19 Mar 2014 01:33:31 +0000
Subject: [docs] [issue20974] email module docs say not compatible with
	current python	version
In-Reply-To: <1395176910.11.0.458502603486.issue20974@psf.upfronthosting.co.za>
Message-ID: <1395192811.82.0.17211966216.issue20974@psf.upfronthosting.co.za>


Lina Clark added the comment:

I'm submitting a patch for review to show the updated table of email versions. If this is accepted, I'll update the docs for 2.7 as well.

----------
keywords: +patch
nosy: +linaclark
Added file: http://bugs.python.org/file34505/email.patch

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

From report at bugs.python.org  Wed Mar 19 02:35:47 2014
From: report at bugs.python.org (Kinga Farkas)
Date: Wed, 19 Mar 2014 01:35:47 +0000
Subject: [docs] [issue20970] contradictory documentation for prog option of
	argparse
In-Reply-To: <1395160969.17.0.758674872934.issue20970@psf.upfronthosting.co.za>
Message-ID: <1395192947.52.0.0295726979142.issue20970@psf.upfronthosting.co.za>


Kinga Farkas added the comment:

So, would it be helpful to rephrase the original text

"By default, ArgumentParser objects uses sys.argv[0] to determine how to display the name of the program in thehelp messages. This default is almost always desirable because it will make the help messages match how the program was invoked on the command line." 

 by 

"By default, ArgumentParser objects uses the base name of the path sys.argv[0] to determine how to display the name of the program in the help messages."

And then all that would remain is to change the backslash to a forward slash in the example that follows.

----------
nosy: +lilbludot

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

From report at bugs.python.org  Wed Mar 19 02:43:14 2014
From: report at bugs.python.org (R. David Murray)
Date: Wed, 19 Mar 2014 01:43:14 +0000
Subject: [docs] [issue20970] contradictory documentation for prog option of
	argparse
In-Reply-To: <1395160969.17.0.758674872934.issue20970@psf.upfronthosting.co.za>
Message-ID: <1395193394.76.0.103095401812.issue20970@psf.upfronthosting.co.za>


R. David Murray added the comment:

I think 'base name' should be defined somehow (perhaps "see :ref:`os.basename`?)  And I agree that that second sentence should be made less ambiguous.  Perhaps "make the help messages use the same name that was used to invoke the program on the command line".  (Many people won't know that you can invoke the same script by more than one name on unix by using symlinks, which is what makes that statement read wrong in its current form.)

----------

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

From report at bugs.python.org  Wed Mar 19 04:44:54 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 19 Mar 2014 03:44:54 +0000
Subject: [docs] [issue13437] Provide links to the source code for every
	module in the	documentation
In-Reply-To: <1321748971.83.0.182041155467.issue13437@psf.upfronthosting.co.za>
Message-ID: <1395200694.74.0.656264171428.issue13437@psf.upfronthosting.co.za>


?ric Araujo added the comment:

+1 on amk?s patch.  I trust his selection of modules, and linking to C module sources can be an interesting experiment.

----------
stage:  -> commit review
versions: +Python 3.4, Python 3.5 -Python 3.2, Python 3.3

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

From report at bugs.python.org  Wed Mar 19 05:38:00 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Wed, 19 Mar 2014 04:38:00 +0000
Subject: [docs] [issue13437] Provide links to the source code for every
	module in the	documentation
In-Reply-To: <1321748971.83.0.182041155467.issue13437@psf.upfronthosting.co.za>
Message-ID: <1395203880.88.0.64275271836.issue13437@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

Without actually looking, I am skeptical of _decimal.c as I expect the code to be highly technical. But maybe it has more helpful comments than I expect. But I am willing to let the person pushing decide. I am overall in favor of linking to python sources.

difflib I know should be linked. tokenize.py (not in the patch) probably should be linked eventually, but only after the docstrings (and doc) are fixed a bit. I will think about it after that is done.

----------

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

From report at bugs.python.org  Wed Mar 19 05:48:05 2014
From: report at bugs.python.org (Kinga Farkas)
Date: Wed, 19 Mar 2014 04:48:05 +0000
Subject: [docs] [issue20970] contradictory documentation for prog option of
	argparse
In-Reply-To: <1395160969.17.0.758674872934.issue20970@psf.upfronthosting.co.za>
Message-ID: <1395204485.9.0.472266147699.issue20970@psf.upfronthosting.co.za>


Kinga Farkas added the comment:

Would the second sentence sound good if phrased as:
"This default is almost always desirable because it will make the help messages use the same name that was used to invoke the program on the command line, whether it be the base name or a symlink.  
 
As I am working on my first contribution here, I am not quite sure of the conventions. 
In the official documentation:
1. would you create a reference to  os.basename or os.path.basename?
2. would you use the word symlink or the term symbolic link or it does not matter?

----------

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

From report at bugs.python.org  Wed Mar 19 07:44:49 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 19 Mar 2014 06:44:49 +0000
Subject: [docs] [issue16827] Remove the relatively advanced content from
	section 2 in	tutorial
In-Reply-To: <1356964896.19.0.673901752517.issue16827@psf.upfronthosting.co.za>
Message-ID: <1395211489.12.0.233463157825.issue16827@psf.upfronthosting.co.za>


?ric Araujo added the comment:

Thanks for the patch, I left a couple notes on the review site (http://bugs.python.org/review/16827/).

Ezio suggested moving the doc about floating point issues to an appendix too; what?s your opinion on that?

I wonder if the advanced contents should be placed in appendices in the tutorial or merged with the rest of the docs (language or library reference).  I guess the idea of tutorial appendices is that people can think they are not required reading and skip them, but know they are here if needed?  If that works, I?m all for it.

Jamayla, your patch is not in a form that?s easy to review.  This page gives help about how to use Merurial to track changes instead of working with copies of files: http://docs.python.org/devguide/patch.html

----------
versions: +Python 3.5 -Python 3.2, Python 3.3

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

From report at bugs.python.org  Wed Mar 19 07:49:19 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 19 Mar 2014 06:49:19 +0000
Subject: [docs] [issue14332] Better explain "junk" concept in difflib doc
In-Reply-To: <1331877125.66.0.103153393744.issue14332@psf.upfronthosting.co.za>
Message-ID: <1395211758.96.0.293772928321.issue14332@psf.upfronthosting.co.za>


?ric Araujo added the comment:

amk, if you?re satisfied with your patch, I think you can go ahead and commit it.

----------
versions: +Python 3.4 -Python 3.2

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

From report at bugs.python.org  Wed Mar 19 07:59:21 2014
From: report at bugs.python.org (Berker Peksag)
Date: Wed, 19 Mar 2014 06:59:21 +0000
Subject: [docs] [issue11352] Update cgi module doc
In-Reply-To: <1298895261.86.0.965235067518.issue11352@psf.upfronthosting.co.za>
Message-ID: <1395212361.16.0.579202877907.issue11352@psf.upfronthosting.co.za>


Berker Peksag added the comment:

> Have any of the changes been applied?

A modified version of cgi-doc-update.patch was committed. (see msg159700)

I left a couple of comments for cgi-doc.patch on Rietveld.

----------
nosy: +berker.peksag
versions: +Python 3.4, Python 3.5 -Python 3.2, Python 3.3

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

From report at bugs.python.org  Wed Mar 19 08:02:49 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 19 Mar 2014 07:02:49 +0000
Subject: [docs] [issue16827] Remove the relatively advanced content from
	section 2 in	tutorial
In-Reply-To: <1356964896.19.0.673901752517.issue16827@psf.upfronthosting.co.za>
Message-ID: <1395212569.89.0.773367427279.issue16827@psf.upfronthosting.co.za>


?ric Araujo added the comment:

> By the way the section 13 is more about interactive Input editing,
> which is different concept from interactive mode.

I think these are the same thing.  Can you explain more?

----------

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

From report at bugs.python.org  Wed Mar 19 08:41:54 2014
From: report at bugs.python.org (paul j3)
Date: Wed, 19 Mar 2014 07:41:54 +0000
Subject: [docs] [issue20970] contradictory documentation for prog option of
	argparse
In-Reply-To: <1395204485.9.0.472266147699.issue20970@psf.upfronthosting.co.za>
Message-ID: <CAOW0-7yOS9+ZMvqSnpedpjkY7OfytgoELv7aa_OOWEkfFZqa9w@mail.gmail.com>


paul j3 added the comment:

Cross reference for sys.argv[0] is

http://docs.python.org/3.4/library/sys.html

> _______________________________________
>

----------

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

From report at bugs.python.org  Wed Mar 19 09:44:14 2014
From: report at bugs.python.org (=?utf-8?q?Bo=C5=A1tjan_Mejak?=)
Date: Wed, 19 Mar 2014 08:44:14 +0000
Subject: [docs] [issue20975] Python 3.4 build info wrong in code snippet
In-Reply-To: <1395179398.5.0.851425870515.issue20975@psf.upfronthosting.co.za>
Message-ID: <1395218654.72.0.100424547095.issue20975@psf.upfronthosting.co.za>


Bo?tjan Mejak added the comment:

I would change only the date and time. There was no Python 3.4 back in 2012 so at least change the year. Well, my recommendation is this:

Python 3.4.0 (v3.4.0:04f714765c13, Mar 16 2014, 19:25:23) [MSC v.1600 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>>

This is how the build info looks like on Windows 7. The user should be presented with the actual build info. Well, at least fix the date and time to match the actual date and time the final version of Python 3.4 was actually built.

----------

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

From report at bugs.python.org  Wed Mar 19 11:42:27 2014
From: report at bugs.python.org (Jovik)
Date: Wed, 19 Mar 2014 10:42:27 +0000
Subject: [docs] [issue20927] Different behaviour on Posix and Windows when
	using	subprocess.Popen(..., cwd=path)
In-Reply-To: <1394816385.18.0.912805951896.issue20927@psf.upfronthosting.co.za>
Message-ID: <1395225746.96.0.200922397056.issue20927@psf.upfronthosting.co.za>


Jovik added the comment:

Isn't Python's crossplatform functionality a key feature? A quick fix would be to retry the call by adding cwd to arg[0] in case of FileNotFoundError.

----------

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

From pcmanticore at gmail.com  Wed Mar 19 11:48:55 2014
From: pcmanticore at gmail.com (pcmanticore at gmail.com)
Date: Wed, 19 Mar 2014 10:48:55 -0000
Subject: [docs] ElementTree: Document handling processing instructions
	(issue 20375)
Message-ID: <20140319104855.17116.71714@psf.upfronthosting.co.za>


http://bugs.python.org/review/20375/diff/10762/Lib/test/test_xml_etree.py
File Lib/test/test_xml_etree.py (right):

http://bugs.python.org/review/20375/diff/10762/Lib/test/test_xml_etree.py#newcode1628
Lib/test/test_xml_etree.py:1628:
self.assertTrue(len(tree2.getroot().getchildren()) == 0)
Why not self.assertEqual(len(tree..), 0)?

http://bugs.python.org/review/20375/diff/10762/Lib/test/test_xml_etree.py#newcode1639
Lib/test/test_xml_etree.py:1639: self.assertTrue(b'<!--not to be
rendered-->' in bytes(stream.getbuffer()))
self.assertIn(b'..', bytes(..)) is clearer.

http://bugs.python.org/review/20375/diff/10762/Lib/test/test_xml_etree.py#newcode1644
Lib/test/test_xml_etree.py:1644:
self.assertTrue(len(tree2.getroot().getchildren()) == 0)
As above.

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

From report at bugs.python.org  Wed Mar 19 12:03:04 2014
From: report at bugs.python.org (Claudiu.Popa)
Date: Wed, 19 Mar 2014 11:03:04 +0000
Subject: [docs] [issue20375] ElementTree: Document handling processing
	instructions
In-Reply-To: <1390539216.23.0.0362813865609.issue20375@psf.upfronthosting.co.za>
Message-ID: <1395226984.62.0.157044116868.issue20375@psf.upfronthosting.co.za>


Claudiu.Popa added the comment:

Hello. I left a couple of comments on Rietveld.

----------
nosy: +Claudiu.Popa

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

From report at bugs.python.org  Wed Mar 19 13:07:31 2014
From: report at bugs.python.org (Eric V. Smith)
Date: Wed, 19 Mar 2014 12:07:31 +0000
Subject: [docs] [issue20927] Different behaviour on Posix and Windows when
	using	subprocess.Popen(..., cwd=path)
In-Reply-To: <1394816385.18.0.912805951896.issue20927@psf.upfronthosting.co.za>
Message-ID: <1395230851.72.0.659962585343.issue20927@psf.upfronthosting.co.za>


Eric V. Smith added the comment:

We don't always provide fully cross-platform functionality (see the os module for many examples), but we might be able to do better here. It might be some functionality we can add, it might be a documentation issue.

Note, for example, the subprocess.STARTUPINFO and subprocess.Popen creationflags argument. These expose Windows-only functionality.

I'm opposed to trying again with cwd added. There's a long history of security problems doing exactly this. It's why '.' is not in the PATH by default on Unix.

On my list of things to do is trace through exactly which scenarios work and don't work on Windows.

If you really want a more cross-platform solution, Cygwin python might work for you.

----------

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

From report at bugs.python.org  Wed Mar 19 13:26:02 2014
From: report at bugs.python.org (A.M. Kuchling)
Date: Wed, 19 Mar 2014 12:26:02 +0000
Subject: [docs] [issue13437] Provide links to the source code for every
	module in the	documentation
In-Reply-To: <1321748971.83.0.182041155467.issue13437@psf.upfronthosting.co.za>
Message-ID: <1395231962.12.0.803185932941.issue13437@psf.upfronthosting.co.za>


A.M. Kuchling added the comment:

Terry: yes, the code for _decimal.c doesn't look especially helpful.  (_csv.c is a bit more straightforward, but still isn't highly commented.) The problem is that decimal.py does have long docstrings & discussions, so it's certainly useful.  Is it inconsistent to not link to all the relevant files?  Or is it better to only link to source files that we consider helpful?

----------

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

From report at bugs.python.org  Wed Mar 19 13:38:37 2014
From: report at bugs.python.org (R. David Murray)
Date: Wed, 19 Mar 2014 12:38:37 +0000
Subject: [docs] [issue20970] contradictory documentation for prog option of
	argparse
In-Reply-To: <1395160969.17.0.758674872934.issue20970@psf.upfronthosting.co.za>
Message-ID: <1395232717.75.0.0279104094689.issue20970@psf.upfronthosting.co.za>


R. David Murray added the comment:

You are correct, it is os.path.basename.

"base name or symlink" are not alternatives.  It would be the base name *of* the symlink if a symlink was used to invoke the program.  I'm not sure that introducing the concept of the symlink here is helpful...someone that knows about it will understand, someone that doesn't won't be sufficiently enlightened.  But I'm just one opinion.

Another way to clarify this would be to say "the name used by help will automatically change if the script is renamed".

----------

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

From report at bugs.python.org  Wed Mar 19 13:46:43 2014
From: report at bugs.python.org (Eli Bendersky)
Date: Wed, 19 Mar 2014 12:46:43 +0000
Subject: [docs] [issue14332] Better explain "junk" concept in difflib doc
In-Reply-To: <1331877125.66.0.103153393744.issue14332@psf.upfronthosting.co.za>
Message-ID: <1395233203.55.0.0688722928147.issue14332@psf.upfronthosting.co.za>


Eli Bendersky added the comment:

Revised patch LGTM.

----------

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

From berker.peksag at gmail.com  Wed Mar 19 07:45:59 2014
From: berker.peksag at gmail.com (berker.peksag at gmail.com)
Date: Wed, 19 Mar 2014 06:45:59 -0000
Subject: [docs] Update cgi module doc (issue 11352)
Message-ID: <20140319064559.15873.14150@psf.upfronthosting.co.za>


http://bugs.python.org/review/11352/diff/4862/Doc/library/cgi.rst
File Doc/library/cgi.rst (left):

http://bugs.python.org/review/11352/diff/4862/Doc/library/cgi.rst#oldcode255
Doc/library/cgi.rst:255: 
It would be great to add a complete working example to end of the
documentaton.

http://bugs.python.org/review/11352/diff/4862/Doc/library/cgi.rst
File Doc/library/cgi.rst (right):

http://bugs.python.org/review/11352/diff/4862/Doc/library/cgi.rst#newcode90
Doc/library/cgi.rst:90: .. class::
FieldStorage([encoding[,errors[,keep_blank_values]]])
Nit: Please add a space after commas.

http://bugs.python.org/review/11352/diff/4862/Doc/library/cgi.rst#newcode99
Doc/library/cgi.rst:99: is usually contained in the META tag in the HEAD
section of the HTML
META tag -> ``<meta>`` element

http://bugs.python.org/review/11352/diff/4862/Doc/library/cgi.rst#newcode99
Doc/library/cgi.rst:99: is usually contained in the META tag in the HEAD
section of the HTML
I would drop the "in the HEAD section" part.

http://bugs.python.org/review/11352/diff/4862/Doc/library/cgi.rst#newcode101
Doc/library/cgi.rst:101: argument indicates how to manage encoding
errors (see the :mod:`str`
You could add a link to
http://docs.python.org/3.4/library/stdtypes.html#str.encode or
http://docs.python.org/3.4/library/codecs.html#codec-base-classes

http://bugs.python.org/review/11352/diff/4862/Doc/library/cgi.rst#newcode105
Doc/library/cgi.rst:105: in the dictionary; to keep such values, provide
a true value for the
true -> ``True``

http://bugs.python.org/review/11352/diff/4862/Doc/library/cgi.rst#newcode110
Doc/library/cgi.rst:110: form field name to an object that can be :
Remove the space before the colon.

http://bugs.python.org/review/11352/diff/4862/Doc/library/cgi.rst#newcode112
Doc/library/cgi.rst:112: * another instance of :class:`FieldStorage` for
data sent in the body of a
I would remove the indentation here. It's looks a bit ugly in the HTML
version of the document.

http://bugs.python.org/review/11352/diff/4862/Doc/library/cgi.rst#newcode122
Doc/library/cgi.rst:122: A form submitted via POST that also has a query
string will contain both
"via POST request"?

http://bugs.python.org/review/11352/diff/4862/Doc/library/cgi.rst#newcode137
Doc/library/cgi.rst:137: Returns the value for the specified field name
; the optional argument
Returns -> Return

http://bugs.python.org/review/11352/diff/4862/Doc/library/cgi.rst#newcode137
Doc/library/cgi.rst:137: Returns the value for the specified field name
; the optional argument
"field name ;" -> field *name*;

http://bugs.python.org/review/11352/diff/4862/Doc/library/cgi.rst#newcode138
Doc/library/cgi.rst:138: *default* is returned if the requested name is
not present.
*name*

http://bugs.python.org/review/11352/diff/4862/Doc/library/cgi.rst#newcode157
Doc/library/cgi.rst:157: of the field
Needs a dot.

http://bugs.python.org/review/11352/diff/4862/Doc/library/cgi.rst#newcode164
Doc/library/cgi.rst:164: checkboxes with the same name::
I would use ``.. code-block:: html`` here.

http://bugs.python.org/review/11352/diff/4862/Doc/library/cgi.rst#newcode166
Doc/library/cgi.rst:166: <input type="checkbox" name="item" value="1" />
"/>" is not the best practice in HTML 5 these days.

http://bugs.python.org/review/11352/diff/4862/Doc/library/cgi.rst#newcode182
Doc/library/cgi.rst:182: .. method:: FieldStorage.getfirst(name,
default=None)
[, default]

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

From techtonik at gmail.com  Wed Mar 19 07:59:16 2014
From: techtonik at gmail.com (anatoly techtonik)
Date: Wed, 19 Mar 2014 09:59:16 +0300
Subject: [docs] argparse FAQ: how it is different from optparse (issue
	17462)
In-Reply-To: <20140318133731.27921.40985@psf.upfronthosting.co.za>
References: <20140318133731.27921.40985@psf.upfronthosting.co.za>
Message-ID: <CAPkN8xJTEoYzvWhvntrX1_jgdRYbg_8uaTYJRYEXKAefN2auMg@mail.gmail.com>

Ok. Then I would just add links to relevant sections and it will be good.

From report at bugs.python.org  Wed Mar 19 14:18:45 2014
From: report at bugs.python.org (Milan Oberkirch)
Date: Wed, 19 Mar 2014 13:18:45 +0000
Subject: [docs] [issue20903] smtplib.SMTP raises socket.timeout
In-Reply-To: <1394664754.18.0.260499838693.issue20903@psf.upfronthosting.co.za>
Message-ID: <1395235125.19.0.0178461860151.issue20903@psf.upfronthosting.co.za>


Milan Oberkirch added the comment:

The attached patch mentions the exception besides the description of the timeout parameter. It doesn't hurt and makes programmers aware of this common exception.

----------
keywords: +patch
nosy: +zvyn
Added file: http://bugs.python.org/file34516/doc_socket_timeout.patch

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

From report at bugs.python.org  Wed Mar 19 14:19:05 2014
From: report at bugs.python.org (R. David Murray)
Date: Wed, 19 Mar 2014 13:19:05 +0000
Subject: [docs] [issue20907] behavioral differences between
	shutil.unpack_archive and	ZipFile.extractall
In-Reply-To: <1394703965.34.0.603199781912.issue20907@psf.upfronthosting.co.za>
Message-ID: <1395235145.5.0.178866776252.issue20907@psf.upfronthosting.co.za>


R. David Murray added the comment:

First step would be to get rid of the warning in the zipfile docs and replace it with the info that the absolute path '/' and any relative path are stripped silently before the file is extracted.

It would also be worth adding an enhancement to zipfile to optionally not do it silently.

I hope the same considerations apply to tarfile, but I haven't checked.

In other words, I do think that code is a holdover from when zipfile *wasn't* safe, but since I didn't write it I don't know for sure.

----------
assignee:  -> docs at python
components: +Documentation
nosy: +docs at python, r.david.murray
stage: test needed -> needs patch

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

From report at bugs.python.org  Wed Mar 19 15:41:47 2014
From: report at bugs.python.org (Kinga Farkas)
Date: Wed, 19 Mar 2014 14:41:47 +0000
Subject: [docs] [issue20970] contradictory documentation for prog option of
	argparse
In-Reply-To: <1395160969.17.0.758674872934.issue20970@psf.upfronthosting.co.za>
Message-ID: <1395240107.59.0.540850981338.issue20970@psf.upfronthosting.co.za>


Changes by Kinga Farkas <lilbludot at gmail.com>:


----------
keywords: +patch
Added file: http://bugs.python.org/file34517/issue20970.patch

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

From report at bugs.python.org  Wed Mar 19 17:49:55 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Wed, 19 Mar 2014 16:49:55 +0000
Subject: [docs] [issue13437] Provide links to the source code for every
	module in the	documentation
In-Reply-To: <1321748971.83.0.182041155467.issue13437@psf.upfronthosting.co.za>
Message-ID: <1395247795.66.0.224697075063.issue13437@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

With rare exceptions*, my inclination is to only link .py files anyway. Those apply to all implementations that use them as is. Any Python programmer can read them and maybe learn something. The C files only apply to CPython. The possible existence of a _modname accelerator is evident in the Python file. So I suggest applying without the .c links.

*Non-module examples: yesterday on python-list, someone referenced comments in dictobject.c to explain seemingly peculiar behavior. I believe listobject.c has Tim's long comment on .sort.

----------

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

From report at bugs.python.org  Wed Mar 19 19:58:54 2014
From: report at bugs.python.org (Nitika Agarwal)
Date: Wed, 19 Mar 2014 18:58:54 +0000
Subject: [docs] [issue4744] asynchat documentation needs to be more precise
In-Reply-To: <1230168171.56.0.381937953807.issue4744@psf.upfronthosting.co.za>
Message-ID: <1395255533.94.0.00963725881457.issue4744@psf.upfronthosting.co.za>


Nitika Agarwal added the comment:

Attached patch with some corrections

----------
Added file: http://bugs.python.org/file34526/issue4744_3.patch

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

From report at bugs.python.org  Wed Mar 19 20:09:33 2014
From: report at bugs.python.org (Nitika Agarwal)
Date: Wed, 19 Mar 2014 19:09:33 +0000
Subject: [docs] [issue17188] Document 'from None' in raise statement doc.
In-Reply-To: <1360631999.8.0.76627095073.issue17188@psf.upfronthosting.co.za>
Message-ID: <1395256173.79.0.264152774936.issue17188@psf.upfronthosting.co.za>


Nitika Agarwal added the comment:

Patch with some corrections.
Please review the patch attached.

----------
Added file: http://bugs.python.org/file34527/issue17188_1.patch

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

From report at bugs.python.org  Wed Mar 19 20:24:30 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 19 Mar 2014 19:24:30 +0000
Subject: [docs] [issue20907] behavioral differences between
	shutil.unpack_archive and	ZipFile.extractall
In-Reply-To: <1394703965.34.0.603199781912.issue20907@psf.upfronthosting.co.za>
Message-ID: <1395257070.14.0.59352759587.issue20907@psf.upfronthosting.co.za>


?ric Araujo added the comment:

shutil.unpack_archive was extracted from distutils by Tarek.  I can do some Mercurial archaelogy to find more about the behaviour.

----------

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

From report at bugs.python.org  Wed Mar 19 21:15:02 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 19 Mar 2014 20:15:02 +0000
Subject: [docs] [issue13437] Provide links to the source code for every
	module in the	documentation
In-Reply-To: <1321748971.83.0.182041155467.issue13437@psf.upfronthosting.co.za>
Message-ID: <1395260102.65.0.39201393494.issue13437@psf.upfronthosting.co.za>


?ric Araujo added the comment:

Agreed with Terry.  Some Python modules are just wrappers for C modules, but datetime.py is standalone so we can dispense with the link to _datetime.c.

----------

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

From report at bugs.python.org  Wed Mar 19 21:25:58 2014
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 19 Mar 2014 20:25:58 +0000
Subject: [docs] [issue13437] Provide links to the source code for every
	module in the	documentation
In-Reply-To: <1321748971.83.0.182041155467.issue13437@psf.upfronthosting.co.za>
Message-ID: <3fq2nc6bQYz7Ljp@mail.python.org>


Roundup Robot added the comment:

New changeset bc107f5faedc by Andrew Kuchling in branch 'default':
#13437: link to the source code for a few more modules
http://hg.python.org/cpython/rev/bc107f5faedc

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

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

From report at bugs.python.org  Wed Mar 19 21:27:19 2014
From: report at bugs.python.org (A.M. Kuchling)
Date: Wed, 19 Mar 2014 20:27:19 +0000
Subject: [docs] [issue13437] Provide links to the source code for every
	module in the	documentation
In-Reply-To: <1321748971.83.0.182041155467.issue13437@psf.upfronthosting.co.za>
Message-ID: <1395260839.11.0.130157590399.issue13437@psf.upfronthosting.co.za>


Changes by A.M. Kuchling <amk at amk.ca>:


----------
resolution:  -> fixed
stage: commit review -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Wed Mar 19 21:44:25 2014
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 19 Mar 2014 20:44:25 +0000
Subject: [docs] [issue14332] Better explain "junk" concept in difflib doc
In-Reply-To: <1331877125.66.0.103153393744.issue14332@psf.upfronthosting.co.za>
Message-ID: <3fq3Bw43nvz7Lk4@mail.python.org>


Roundup Robot added the comment:

New changeset 0a69b1e8b7fe by Andrew Kuchling in branch 'default':
#14332: provide a better explanation of junk in difflib docs
http://hg.python.org/cpython/rev/0a69b1e8b7fe

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

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

From report at bugs.python.org  Wed Mar 19 21:45:07 2014
From: report at bugs.python.org (A.M. Kuchling)
Date: Wed, 19 Mar 2014 20:45:07 +0000
Subject: [docs] [issue14332] Better explain "junk" concept in difflib doc
In-Reply-To: <1331877125.66.0.103153393744.issue14332@psf.upfronthosting.co.za>
Message-ID: <1395261907.52.0.0756465442768.issue14332@psf.upfronthosting.co.za>


Changes by A.M. Kuchling <amk at amk.ca>:


----------
resolution:  -> fixed
stage: patch review -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Thu Mar 20 00:50:41 2014
From: report at bugs.python.org (Graham Wideman)
Date: Wed, 19 Mar 2014 23:50:41 +0000
Subject: [docs] [issue20906] Issues in Unicode HOWTO
In-Reply-To: <1394702187.81.0.00522221343959.issue20906@psf.upfronthosting.co.za>
Message-ID: <1395273041.74.0.181908712413.issue20906@psf.upfronthosting.co.za>


Graham Wideman added the comment:

Antoine:

Thanks for your comments -- this is slippery stuff.

> It's better, but how about simply "In this article"?

I was hoping to inform the reader that the hex representations are found in many articles, not just special to this one.

> [ showing the glyph ]

Agreed -- it would be good to show the glyphs mentioned. But in a way that isn't confusing if the user's web browser doesn't show it correctly.

> For all intents and purposes, iso-8859-1 and friends *are* encodings 
> (and this is how Python actually names them).

I am still mulling this over. iso-8859-1 is most literally an "encoding" in the old sense of the word (character <--> byte representation), and is not, per se, a unicode-related concept. 

I think part of the ambiguity problem here is that there are two subtly but importantly different ideas here:

1. Python string (capable of representing any unicode text) --> some full-fidelity and industry recognized unicode byte stream, like utf-8, or utf-32. I think this is legitimately described as an "encoding" of the unicode string.

versus:

2. 1. Python string --> some other code system, such as ASCII, cp1250, etc. The destination code system doesn't necessarily have anything to do with unicode, and whole ranges of unicode's characters either result in an exception, or get translated as escape sequences. Ie: This is more usefully seen as a translation operation, than "merely" encoding.

In 1, the encoding process results in data that stays within concepts defined within Unicode. In 2, encoding produces data that would be described by some code system outside of Unicode.

At the moment I think Python muddles these two ideas together, and I'm not sure how to clarify this. 

> So it should say "16-bit code points" instead, right?

I don't think Unicode code points should ever be described as having a particular number of bits. I think this is a core concept: Unicode separates the character <--> code point, and code point <--> bits/bytes mappings. 

At most, one might want to distinguish different ranges of unicode code points. Even if there is a need to distinguish code points <= 65535, I don't think this should be described as "16-bit", as it muddies the distinction between Unicode's two mappings.

----------

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

From Nikolaus at rath.org  Thu Mar 20 03:44:23 2014
From: Nikolaus at rath.org (Nikolaus at rath.org)
Date: Thu, 20 Mar 2014 02:44:23 -0000
Subject: [docs] ElementTree: Document handling processing instructions
	(issue 20375)
Message-ID: <20140320024423.27921.7154@psf.upfronthosting.co.za>

Reviewers: Claudiu.Popa,


http://bugs.python.org/review/20375/diff/10762/Lib/test/test_xml_etree.py
File Lib/test/test_xml_etree.py (right):

http://bugs.python.org/review/20375/diff/10762/Lib/test/test_xml_etree.py#newcode1628
Lib/test/test_xml_etree.py:1628:
self.assertTrue(len(tree2.getroot().getchildren()) == 0)
On 2014/03/19 11:48:55, Claudiu.Popa wrote:
> Why not self.assertEqual(len(tree..), 0)?

Done.

http://bugs.python.org/review/20375/diff/10762/Lib/test/test_xml_etree.py#newcode1639
Lib/test/test_xml_etree.py:1639: self.assertTrue(b'<!--not to be
rendered-->' in bytes(stream.getbuffer()))
On 2014/03/19 11:48:55, Claudiu.Popa wrote:
> self.assertIn(b'..', bytes(..)) is clearer.

Done.

http://bugs.python.org/review/20375/diff/10762/Lib/test/test_xml_etree.py#newcode1644
Lib/test/test_xml_etree.py:1644:
self.assertTrue(len(tree2.getroot().getchildren()) == 0)
On 2014/03/19 11:48:55, Claudiu.Popa wrote:
> As above.

Done.



Please review this at http://bugs.python.org/review/20375/

Affected files:
  Lib/test/test_xml_etree.py


diff --git a/Lib/test/test_xml_etree.py b/Lib/test/test_xml_etree.py
--- a/Lib/test/test_xml_etree.py
+++ b/Lib/test/test_xml_etree.py
@@ -1612,7 +1612,37 @@
         ET.register_namespace('test10777', 'http://myuri/')
         ET.register_namespace('test10777', 'http://myuri/')
 
-
+    def test_pi_treatment(self):
+        root = ET.Element('body', { 'text': 'some text'})
+        root.append(ET.ProcessingInstruction('verb', 'extra data'))
+        tree = ET.ElementTree(root)
+        stream = io.BytesIO()
+        tree.write(stream)
+
+        # PIs are serialized to XML..
+        self.assertTrue(b'<?verb extra data?>' in bytes(stream.getbuffer())) 
+
+        # ..but skipped when parsing XML
+        stream.seek(0)
+        tree2 = ET.parse(stream)
+        self.assertTrue(len(tree2.getroot().getchildren()) == 0)
+
+
+    def test_comment_treatment(self):
+        root = ET.Element('body', { 'text': 'some text'})
+        root.append(ET.Comment('not to be rendered'))
+        tree = ET.ElementTree(root)
+        stream = io.BytesIO()
+        tree.write(stream)
+
+        # PIs are serialized to XML..
+        self.assertTrue(b'<!--not to be rendered-->' in bytes(stream.getbuffer())) 
+
+        # ..but skipped when parsing XML
+        stream.seek(0)
+        tree2 = ET.parse(stream)
+        self.assertTrue(len(tree2.getroot().getchildren()) == 0)
+        
 # --------------------------------------------------------------------
 
 



From report at bugs.python.org  Thu Mar 20 03:44:58 2014
From: report at bugs.python.org (Nikolaus Rath)
Date: Thu, 20 Mar 2014 02:44:58 +0000
Subject: [docs] [issue20375] ElementTree: Document handling processing
	instructions
In-Reply-To: <1390539216.23.0.0362813865609.issue20375@psf.upfronthosting.co.za>
Message-ID: <1395283498.48.0.71700000816.issue20375@psf.upfronthosting.co.za>


Changes by Nikolaus Rath <Nikolaus at rath.org>:


Added file: http://bugs.python.org/file34528/issue20951.diff

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

From report at bugs.python.org  Thu Mar 20 05:37:21 2014
From: report at bugs.python.org (John Yeung)
Date: Thu, 20 Mar 2014 04:37:21 +0000
Subject: [docs] [issue20987] Python for AS/400 (OS/400) is actually 2.7
Message-ID: <1395290241.07.0.355599966375.issue20987@psf.upfronthosting.co.za>


New submission from John Yeung:

Not sure if this is the right place to report this, but the "other platforms" page <https://www.python.org/download/other/> says the AS/400 port by Per Gummedal is 2.5. While it's true that he did port 2.5 quite a while back, the 2.7 port has been available for 3 years now.

I will say that I'm happy to see any mention of this platform at all!

----------
assignee: docs at python
components: Documentation
messages: 214172
nosy: John.Yeung, docs at python
priority: normal
severity: normal
status: open
title: Python for AS/400 (OS/400) is actually 2.7
type: enhancement

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

From report at bugs.python.org  Thu Mar 20 05:45:39 2014
From: report at bugs.python.org (Nick Coghlan)
Date: Thu, 20 Mar 2014 04:45:39 +0000
Subject: [docs] [issue20988] Recommend ssl.create_default_context() in
	"Security	considerations"
Message-ID: <1395290739.65.0.71721715189.issue20988@psf.upfronthosting.co.za>


New submission from Nick Coghlan:

The ssl docs currently have a security warning at the top directing users to the Security Considerations section at http://docs.python.org/3/library/ssl#ssl-security

That section currently dives directly into the technical details of choosing suitable SSL settings, and doesn't reference back to the new http://docs.python.org/3/library/ssl#ssl.create_default_context helper function.

I believe this section should *start* with an example of using the create_default_context() to create an SSL wrapped socket with reasonable settings, and only *then* continue on with the technical details.

----------
assignee: docs at python
components: Documentation
messages: 214173
nosy: alex, christian.heimes, docs at python, giampaolo.rodola, janssen, ncoghlan, pitrou
priority: normal
severity: normal
stage: needs patch
status: open
title: Recommend ssl.create_default_context() in "Security considerations"
type: enhancement
versions: Python 3.4, Python 3.5

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

From report at bugs.python.org  Thu Mar 20 05:54:31 2014
From: report at bugs.python.org (Nick Coghlan)
Date: Thu, 20 Mar 2014 04:54:31 +0000
Subject: [docs] [issue20988] Recommend ssl.create_default_context() in
	"Security	considerations"
In-Reply-To: <1395290739.65.0.71721715189.issue20988@psf.upfronthosting.co.za>
Message-ID: <1395291271.39.0.569831547631.issue20988@psf.upfronthosting.co.za>


Nick Coghlan added the comment:

Potentially more controversial: we could also update that section and other parts of the docs to state that "create_default_context" is expected to become a true default context in a future release. (such that if you want insecure settings, you will have to opt in to them)

However, that change may be better handled as part of a more comprehensive PEP.

----------

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

From report at bugs.python.org  Thu Mar 20 06:13:36 2014
From: report at bugs.python.org (Ned Deily)
Date: Thu, 20 Mar 2014 05:13:36 +0000
Subject: [docs] [issue20987] Python for AS/400 (OS/400) is actually 2.7
In-Reply-To: <1395290241.07.0.355599966375.issue20987@psf.upfronthosting.co.za>
Message-ID: <1395292416.54.0.0217788890153.issue20987@psf.upfronthosting.co.za>


Ned Deily added the comment:

Thanks for the report.  The page is now updated.  For future reference, please report issues with the python.org website here:  https://github.com/python/pythondotorg/issues

----------
nosy: +ned.deily
resolution:  -> fixed
stage:  -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Thu Mar 20 08:10:41 2014
From: report at bugs.python.org (Petri Lehtinen)
Date: Thu, 20 Mar 2014 07:10:41 +0000
Subject: [docs] [issue17188] Document 'from None' in raise statement doc.
In-Reply-To: <1360631999.8.0.76627095073.issue17188@psf.upfronthosting.co.za>
Message-ID: <1395299441.04.0.712815043627.issue17188@psf.upfronthosting.co.za>


Petri Lehtinen added the comment:

The patch doesn't apply cleanly on 3.4 or default.

----------

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

From report at bugs.python.org  Thu Mar 20 08:47:56 2014
From: report at bugs.python.org (Marc-Andre Lemburg)
Date: Thu, 20 Mar 2014 07:47:56 +0000
Subject: [docs] [issue20906] Issues in Unicode HOWTO
In-Reply-To: <1395273041.74.0.181908712413.issue20906@psf.upfronthosting.co.za>
Message-ID: <532A9D27.8090702@egenix.com>


Marc-Andre Lemburg added the comment:

Just to clarify a few things:

On 20.03.2014 00:50, Graham Wideman wrote:
> 
> I think part of the ambiguity problem here is that there are two subtly but importantly different ideas here:
> 
> 1. Python string (capable of representing any unicode text) --> some full-fidelity and industry recognized unicode byte stream, like utf-8, or utf-32. I think this is legitimately described as an "encoding" of the unicode string.

Right, those are Unicode transformation format (UTF) encodings which are
capable of representing all Unicode code points.

> versus:
> 
> 2. 1. Python string --> some other code system, such as ASCII, cp1250, etc. The destination code system doesn't necessarily have anything to do with unicode, and whole ranges of unicode's characters either result in an exception, or get translated as escape sequences. Ie: This is more usefully seen as a translation operation, than "merely" encoding.

Those are encodings as well. The operation going from Unicode to one of
these encodings is called "encode" in Python. The other way around
"decode".

> In 1, the encoding process results in data that stays within concepts defined within Unicode. In 2, encoding produces data that would be described by some code system outside of Unicode.
>
> At the moment I think Python muddles these two ideas together, and I'm not sure how to clarify this. 

An encoding is a mapping of characters to ordinals, nothing more or
less. Unicode is such an encoding, but all others are as well. They
just happen to have different ranges of ordinals.

You are viewing all this from the a Unicode point of view, but please
realize that Unicode is rather new in the business and the many
other encodings Python supports have been around for decades.

>> So it should say "16-bit code points" instead, right?
> 
> I don't think Unicode code points should ever be described as having a particular number of bits. I think this is a core concept: Unicode separates the character <--> code point, and code point <--> bits/bytes mappings. 
>
> At most, one might want to distinguish different ranges of unicode code points. Even if there is a need to distinguish code points <= 65535, I don't think this should be described as "16-bit", as it muddies the distinction between Unicode's two mappings.

You have UCS-2 and UCS-4. UCS-2 representable in 16 bits, UCS-4
needs 21 bits, but is typically stored in 32-bit. Still,
you're right: it's better to use the correct terms UCS-2 vs. UCS-4
rather than refer to the number of bits.

----------

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

From report at bugs.python.org  Thu Mar 20 10:56:39 2014
From: report at bugs.python.org (Peter Santoro)
Date: Thu, 20 Mar 2014 09:56:39 +0000
Subject: [docs] [issue20907] behavioral differences between
	shutil.unpack_archive and	ZipFile.extractall
In-Reply-To: <1394703965.34.0.603199781912.issue20907@psf.upfronthosting.co.za>
Message-ID: <1395309399.04.0.749057082359.issue20907@psf.upfronthosting.co.za>


Peter Santoro added the comment:

It seems clear to me that the logic in shutil._unpack_zipfile that silently skips paths that start with '/' (indicates absolute path) or that contain references to the parent directory ('..') was added to prevent malicious zip files from making potential malicious/unwanted modifications to the filesystem (perhaps at a time when zipfile did not itself contain such logic).  This conservative approach works, but it can have unexpected results.  For example, if all entries in a zip file contain these invalid characters, then shutil._unpack_zipfile appears to do nothing (i.e. the zip file is not unpacked).  This is good (except for the silent part), if the zip file is truly malicious.  However, I recently had to deal with thousands of zip files created by well known software vendors where hundreds of the zip files were created incorrectly and contained these invalid characters.  These files were not malicious, but they were created improperly. Note that shutil._unpack_zipfile silently failed to unzip these files, but by using ZipFile.extractall I could unzip them.

It appears that most unzipping software today either either ignores (sometimes silently) potentially malicious zip entries (e.g. Windows 7 Explorer displays an invalid zip file error) or it attempts to filter out/replace known bad characters so that the zip entries can be extracted (e.g. WinZip, gnu unzip).  I created this issue because the Python library uses both approaches, which may need rethinking.

The newer logic in ZipFile._extract_member, which is used by ZipFile.extractall, takes a different approach.  Instead of silently ignoring potentially malicious zip entries, it attempts to filter out or replace known invalid characters before extracting the zip entries.

>From the Python zipfile docs:
---
If a member filename is an absolute path, a drive/UNC sharepoint and leading (back)slashes will be stripped, e.g.: ///foo/bar becomes foo/bar on Unix, and C:\foo\bar becomes foo\bar on Windows. And all ".." components in a member filename will be removed, e.g.: ../../foo../../ba..r becomes foo../ba..r. On Windows illegal characters (:, <, >, |, ", ?, and *) replaced by underscore (_).
---

As ZipFile._extract_member filters out/replaces more invalid characters than shutil._unpack_zipfile handles, one could argue that the (apparent older) approach used by shutil._unpack_zipfile is less safe.

The approaches used by shutil._unpack_zipfile and ZipFile.extractall to deal with potentially malicious zip file entries are different.  This issue could be closed if not deemed important by the Python core developers or it could be handled by documentation and/or coding changes.

----------

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

From report at bugs.python.org  Thu Mar 20 11:49:42 2014
From: report at bugs.python.org (Graham Wideman)
Date: Thu, 20 Mar 2014 10:49:42 +0000
Subject: [docs] [issue20906] Issues in Unicode HOWTO
In-Reply-To: <1394702187.81.0.00522221343959.issue20906@psf.upfronthosting.co.za>
Message-ID: <1395312581.99.0.0905034238681.issue20906@psf.upfronthosting.co.za>


Graham Wideman added the comment:

Marc-Andre:

Thanks for commenting:

> > 2. 1. Python string --> some other code system, such as 
> > ASCII, cp1250, etc. The destination code system doesn't 
> > necessarily have anything to do with unicode, and whole 
> > ranges of unicode's characters either result in an 
> > exception, or get translated as escape sequences. 
> > Ie: This is more usefully seen as a translation 
> > operation, than "merely" encoding.

> Those are encodings as well. The operation going from Unicode to one of
> these encodings is called "encode" in Python.

Yes I am certainly aware that in Python parlance these are also called "encode" (and achieved with encode()), which, I am arguing, is one reason we have confusion. These are not encoding into a recognized Unicode-defined byte stream, they entail translation and filtering into the allowed character set of a different code system and encoding into that code system's byte representation (encoding).

> > In 1, the encoding process results in data that stays within concepts 
> > defined within Unicode. In 2, encoding produces data that would be 
> > described by some code system outside of Unicode.
> > At the moment I think Python muddles these two ideas together, 
> > and I'm not sure how to clarify this. 

> An encoding is a mapping of characters to ordinals, nothing more or less.

In unicode, the mapping from characters to ordinals (code points) is not the encoding. It's the mapping from code points to bytes that's the encoding. While I wish this was a distinction reserved for pedants, unfortunately it's an aspect that's important for users of unicode to understand in order to make sense of how it works, and what the literature and the web says (correct and otherwise).

> You are viewing all this from the a Unicode point of view, but please
> realize that Unicode is rather new in the business and the many
> other encodings Python supports have been around for decades.

I'm advocating that the concepts be clear enough to understand that Unicode (UTF-whatever) works differently (two mappings) than non-Unicode systems (single mapping), so that users have some hope of understanding what happens in moving from one to the other.

> > > So it should say "16-bit code points" instead, right?
 
> > I don't think Unicode code points should ever be described as 
> > having a particular number of bits. I think this is a 
> > core concept: Unicode separates the character <--> code point, 
> > and code point <--> bits/bytes mappings. 

> You have UCS-2 and UCS-4. UCS-2 representable in 16 bits, UCS-4
> needs 21 bits, but is typically stored in 32-bit. Still,
> you're right: it's better to use the correct terms UCS-2 vs. UCS-4
> rather than refer to the number of bits.

I think mixing in UCS just adds confusion here. Unicode consortium has declared "UCS" obsolete, and even wants people to stop using that term:
http://www.unicode.org/faq/utf_bom.html
"UCS-2 is obsolete terminology... the term should now be avoided."
(That's a somewhat silly position -- we must still use the term to talk about legacy stuff. But probably not necessary here.)

So my point wasn't about UCS. It was about referring to code points as having a particular bit width. Fundamentally, code points are numbers, without regard to some particular computer number format. It is a separate matter that they can be encoded in 8, 16 or 32 bit encoding schemes (utf-8, 16, 32), and that is independent of the magnitude of the code point number. 

It _is_ the case that some code points are large enough integers that when encoded they _require_, say, 3 bytes in utf-8, or two 16-bit words in utf-16 and so on. But the number of bits used in the encoding does not necessarily correspond to the number of bits that would be required to represent the integer code point number in plain binary. (Only in UTF-32 is the encoded value simply the binary version of the code point value.)

----------

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

From report at bugs.python.org  Thu Mar 20 11:55:20 2014
From: report at bugs.python.org (Antoine Pitrou)
Date: Thu, 20 Mar 2014 10:55:20 +0000
Subject: [docs] [issue20988] Recommend ssl.create_default_context() in
	"Security	considerations"
In-Reply-To: <1395290739.65.0.71721715189.issue20988@psf.upfronthosting.co.za>
Message-ID: <1395312920.15.0.80830764218.issue20988@psf.upfronthosting.co.za>


Antoine Pitrou added the comment:

Duplicate of issue 20913.

----------
resolution:  -> duplicate
status: open -> closed
superseder:  -> Standard Library documentation needs SSL security best practices doc.

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

From report at bugs.python.org  Thu Mar 20 12:32:52 2014
From: report at bugs.python.org (Marc-Andre Lemburg)
Date: Thu, 20 Mar 2014 11:32:52 +0000
Subject: [docs] [issue20906] Issues in Unicode HOWTO
In-Reply-To: <1395312581.99.0.0905034238681.issue20906@psf.upfronthosting.co.za>
Message-ID: <532AD1DD.8090006@egenix.com>


Marc-Andre Lemburg added the comment:

On 20.03.2014 11:49, Graham Wideman wrote:
> 
>> An encoding is a mapping of characters to ordinals, nothing more or less.
> 
> In unicode, the mapping from characters to ordinals (code points) is not the encoding. It's the mapping from code points to bytes that's the encoding. While I wish this was a distinction reserved for pedants, unfortunately it's an aspect that's important for users of unicode to understand in order to make sense of how it works, and what the literature and the web says (correct and otherwise).

I know that Unicode terminology provides all kinds of ways to name
things and we can be arbitrarily pedantic about any of them and
the fact that the Unicode consortium changes its mind every few
years isn't helpful either :-)

We could also have called encodings: "character set", "code page",
"character encoding", "transformation", etc.

In Python keep it simple: you have Unicode (code points) and 8-bit strings
or bytes (code units).

Whenever you go from Unicode to bytes, you encode Unicode into some encoding.
Going back, you decode the encoding back into Unicode. This operation is
defined by the codec implementing the encoding and it's *not* guaranteed
to be lossless.

See here for how we ended up having Unicode support in Python:

http://www.egenix.com/library/presentations/#PythonAndUnicode

----------

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

From report at bugs.python.org  Thu Mar 20 13:45:25 2014
From: report at bugs.python.org (R. David Murray)
Date: Thu, 20 Mar 2014 12:45:25 +0000
Subject: [docs] [issue20907] behavioral differences between
	shutil.unpack_archive and	ZipFile.extractall
In-Reply-To: <1394703965.34.0.603199781912.issue20907@psf.upfronthosting.co.za>
Message-ID: <1395319525.81.0.770948773206.issue20907@psf.upfronthosting.co.za>


R. David Murray added the comment:

Note that unix unzip does exactly the same thing as zipfile extractall (except that it does issue warnings), and I believe this is considered "best practice" these days for extraction tools: strip out absolute/relative path components and extract to the destination directory.

----------

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

From report at bugs.python.org  Thu Mar 20 13:56:40 2014
From: report at bugs.python.org (Daniel U. Thibault)
Date: Thu, 20 Mar 2014 12:56:40 +0000
Subject: [docs] [issue20686] Confusing statement
In-Reply-To: <1392827095.92.0.836578340147.issue20686@psf.upfronthosting.co.za>
Message-ID: <1395320200.8.0.95320693293.issue20686@psf.upfronthosting.co.za>


Daniel U. Thibault added the comment:

"The default encoding is normally set to ASCII [...]. When a Unicode string is printed, written to a file, or converted with str(), conversion takes place using this default encoding."

>>> u"???"
u'\xe4\xf6\xfc'
   Printing a Unicode string uses ASCII encoding: false (the characters are not converted to their ASCII equivalents) (compare with str(), below)

>>> str(u"???")
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
UnicodeEncodeError: 'ascii' codec can't encode characters in position 0-2: ordinal not in range(128)
   Converting a Unicode string with str() uses ASCII encoding: true (if print (see above) behaved like str(), you'd get an error too)

>>> f = open('workfile', 'w')
>>> f.write('This is a ?test?\n')
>>> f.close()
   Writing a Unicode string to a file uses ASCII encoding: false (examination of the file reveals UTF-8 characters (hex dump: 54 68 69 73 20 69 73 20 61 20 C2 AB 74 65 73 74 C2 BB 0A))

----------

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

From report at bugs.python.org  Thu Mar 20 14:12:04 2014
From: report at bugs.python.org (R. David Murray)
Date: Thu, 20 Mar 2014 13:12:04 +0000
Subject: [docs] [issue20686] Confusing statement about unicode strings in
	tutorial	introduction
In-Reply-To: <1392827095.92.0.836578340147.issue20686@psf.upfronthosting.co.za>
Message-ID: <1395321124.62.0.288878671484.issue20686@psf.upfronthosting.co.za>


R. David Murray added the comment:

re: file.  You forgot the 'u' in front of the string:

>>> f.write(u'This is a ?test?\n')
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
UnicodeEncodeError: 'ascii' codec can't encode character u'\xab' in position 10: ordinal not in range(128)

So you were actually writing binary in your console encoding, which must have been utf-8.  (This kind of confusion is the main reason python3 exists).

----------
title: Confusing statement -> Confusing statement about unicode strings in tutorial introduction

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

From zachary.ware+pydocs at gmail.com  Thu Mar 20 14:45:50 2014
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Thu, 20 Mar 2014 08:45:50 -0500
Subject: [docs] Python MSI packages installation on Windows
In-Reply-To: <88917A57D2BDE64D8EE33C4F5460152801651341@TSEAMB02>
References: <88917A57D2BDE64D8EE33C4F5460152801651341@TSEAMB02>
Message-ID: <CAKJDb-O=j1+zZWpTW3fB5DWSD3k6CfBs8LQ6tt3vF1yixEk5tg@mail.gmail.com>

Hi Thuan,

On Mon, Mar 17, 2014 at 4:27 PM, Truong, Thuan V (TASC)
<Thuan.Truong at tasc.com> wrote:
> FYI,
>
> I run Windows 7 64-bit.  I downloaded several versions of Python 2,7 through
> 3.3.5 MSI packages from www.python.org .  But when I clicked on the
> downloaded files, they all say ?This installation package could not be
> opened.   ..?.  This the same error for all files>
>
> Any idea why?

This list is not the right place to ask usage questions like this, it
is meant for discussion of the Python documentation.  You may have
better luck asking on python-list or python-win32, both @python.org.

However, I would expect the most likely culprit to be either a
corrupted download or a local security policy of some sort.  I very
recently reinstalled all current versions of Python on a 64-bit
Windows 7 machine using the python.org installers with no issues.

Sorry I can't be of more help,
-- 
Zach

From report at bugs.python.org  Thu Mar 20 15:50:03 2014
From: report at bugs.python.org (Baptiste Mispelon)
Date: Thu, 20 Mar 2014 14:50:03 +0000
Subject: [docs] [issue20997] Wrong URL fragment identifier in search result
Message-ID: <1395327003.08.0.0901954371896.issue20997@psf.upfronthosting.co.za>


New submission from Baptiste Mispelon:

When doing a search for "PYTHONDONTWRITEBYTECODE" on the 2.7 docs (http://docs.python.org/2/search.html?q=PYTHONDONTWRITEBYTECODE), the first (and only) search result is the following link:

http://docs.python.org/2/using/cmdline.html?highlight=pythondontwritebytecode#PYTHONDONTWRITEBYTECODE

(note the `#PYTHONDONTWRITEBYTECODE` at the end)

Clicking this link takes you to the right page but the browser doesn't scroll to the correct position on the page as expected.

This is because there's no element with an `id` of `PYTHONDONTWRITEBYTECODE`. The correct id is `envvar-PYTHONDONTWRITEBYTECODE`.


Things work as expected when searching on version 3 docs (http://docs.python.org/3/search.html?q=PYTHONDONTWRITEBYTECODE), where the correct fragment identifier is generated in the search results.

----------
assignee: docs at python
components: Documentation
messages: 214245
nosy: bmispelon, docs at python
priority: normal
severity: normal
status: open
title: Wrong URL fragment identifier in search result
type: behavior
versions: Python 2.7

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

From zachary.ware+pydocs at gmail.com  Thu Mar 20 16:23:28 2014
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Thu, 20 Mar 2014 10:23:28 -0500
Subject: [docs] help
In-Reply-To: <15d45345291e011a4e8b2e883a0d518b@angel.comcen.com.au>
References: <15d45345291e011a4e8b2e883a0d518b@angel.comcen.com.au>
Message-ID: <CAKJDb-M+B0jKapqGAhFTaC0byxZGnBQcUxj5KDczDJZy9i7=PQ@mail.gmail.com>

Hi David,

On Fri, Mar 14, 2014 at 4:06 AM, vadashbengals
<vadashbengals at spin.net.au> wrote:
> hi, i'm been trying to install python 3.3.2 on my intel laptop, which runs
> windows 7
> but it wont install comes up with an error
> "The system administrator has set policies to prevent this installation"
>
> can you help any way

This is not the proper list for asking for this kind of help, this
list is meant for discussion of the Python documentation.

However, your problem looks to be most likely a permissions problem;
you will need to give the installer administrative privileges to
install Python "for all users".  That error message appears to be
coming from Windows, not Python's installer.

-- 
Zach

From zachary.ware+pydocs at gmail.com  Thu Mar 20 16:42:24 2014
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Thu, 20 Mar 2014 10:42:24 -0500
Subject: [docs] download for 3.3.5 fails
In-Reply-To: <3F95054D1F6F4B67BB9B195B0A826035@KOE7LAPTOP1>
References: <3F95054D1F6F4B67BB9B195B0A826035@KOE7LAPTOP1>
Message-ID: <CAKJDb-Mn9oexLTg8kGc9UBPih2y5p0qT97zicqywgPYFuUGB5w@mail.gmail.com>

On Sun, Mar 9, 2014 at 10:42 AM, Matthias K?hler
<Matthias.Koehler.koe at t-online.de> wrote:
> Hallo,
>
> for information:
>
> the downloads on Page
> http://docs.python.org/3/download.html
> for version 3.3.5
> fail.
>
> Example:
> http://docs.python.org/3/archives/python-3.3.5-docs-pdf-a4.zip

This appears to be working now.  Thanks for the report!

-- 
Zach

From zachary.ware+pydocs at gmail.com  Thu Mar 20 16:43:04 2014
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Thu, 20 Mar 2014 10:43:04 -0500
Subject: [docs] Error downloading python docs
In-Reply-To: <CANbpVjEXpqo47yAHV+_e-gt0EgT8+u=EiL-y2+cWRe+3Xi_k1A@mail.gmail.com>
References: <CANbpVjEXpqo47yAHV+_e-gt0EgT8+u=EiL-y2+cWRe+3Xi_k1A@mail.gmail.com>
Message-ID: <CAKJDb-Osn==X2e=mEfE3D5Wh2TF_AqB4q72kSDkh0AOAH+NR=Q@mail.gmail.com>

On Sun, Mar 9, 2014 at 9:46 AM, Sonny Valkeneers <sonny.srii at gmail.com> wrote:
> Hello,
>
> I've encountered the following error whilst trying to download the docs.
> (Image included as attachment.)
>
> All links are not found on the server.
>
> Probably nothing major, but I thought I'd let you know.

This appears to be working now.  Thanks for the report!

-- 
Zach

From zachary.ware+pydocs at gmail.com  Thu Mar 20 16:50:32 2014
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Thu, 20 Mar 2014 10:50:32 -0500
Subject: [docs] Error
In-Reply-To: <BLU0-SMTP33229316EC7D42A3343A543B48A0@phx.gbl>
References: <BLU0-SMTP33229316EC7D42A3343A543B48A0@phx.gbl>
Message-ID: <CAKJDb-Pvk-0nnhnVPNGsK-53O-=3asMU_+fQ=nX8-4hdXS_AOg@mail.gmail.com>

On Sat, Mar 8, 2014 at 9:10 AM, Nicolas Barros <nicbarros at hotmail.com> wrote:
> Hello,
>
> When I type a " the program suddenly closes, what should I do?

Ask for help on a different list :).  This mailing list is intended
for discussion of the Python documentation, not usage questions.  You
may have better luck asking on python-list at python.org or
tutor at python.org, but you'll need to provide more information about
your problem to get any help from either list.

Good luck,
-- 
Zach

From zachary.ware+pydocs at gmail.com  Thu Mar 20 16:51:17 2014
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Thu, 20 Mar 2014 10:51:17 -0500
Subject: [docs] Download of 3.3.5 documents
In-Reply-To: <531C5A29.3020606@morrie.id.au>
References: <531C5A29.3020606@morrie.id.au>
Message-ID: <CAKJDb-MX_ZWxhuF49eEp4_aKiaf6QZ27t3sthpm4ySWWbxfkxA@mail.gmail.com>

On Sun, Mar 9, 2014 at 7:10 AM, Morrie Wyatt <morrie at morrie.id.au> wrote:
> Hi.
>
> There seems to be a problem with the complete document download
> links. The 4 I tried, PDF A4 and HTML (both variants of each) all come
> up with "not found" errors.
>
> "The requested URL /3/archives/python-3.3.5-docs-html.zip was not found on
> this server."
>
> http://docs.python.org/3/archives/python-3.3.5-docs-html.zip
>
> Thanks all for your terrific work.

This appears to be working now.  Thanks for the report!

-- 
Zach

From zachary.ware+pydocs at gmail.com  Thu Mar 20 17:04:12 2014
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Thu, 20 Mar 2014 11:04:12 -0500
Subject: [docs] Dead links for downloading the docs
In-Reply-To: <CAB5uqFw=bX6gX0hdKXkUr1yvtMZ9=n5C7nonS8k_nfBKCPRxXQ@mail.gmail.com>
References: <CAB5uqFw=bX6gX0hdKXkUr1yvtMZ9=n5C7nonS8k_nfBKCPRxXQ@mail.gmail.com>
Message-ID: <CAKJDb-PhjgagmMucD4GW_zT5iYbRwXezhoaW_PM3RrF7Y-Yigg@mail.gmail.com>

On Mon, Mar 3, 2014 at 3:02 AM, Jan Verley <janverley at gmail.com> wrote:
> http://docs.python.org/3/download.html ("Last updated on: Mar 02, 2014.")
> links to
> http://docs.python.org/3/archives/python-3.3.5rc2-docs-pdf-a4.zip
> but I get
> The requested URL /3/archives/python-3.3.5rc2-docs-pdf-a4.zip was not found
> on this server.

This appears to be working now.  Thanks for the report!

-- 
Zach

From zachary.ware+pydocs at gmail.com  Thu Mar 20 17:04:55 2014
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Thu, 20 Mar 2014 11:04:55 -0500
Subject: [docs] Download pdf
In-Reply-To: <CAOcuTcQqw5xUuKXAhYxyae=RUL0WtBx=iqrwvhSBToHSF0KM+g@mail.gmail.com>
References: <CAOcuTcQqw5xUuKXAhYxyae=RUL0WtBx=iqrwvhSBToHSF0KM+g@mail.gmail.com>
Message-ID: <CAKJDb-PSksJCD=Qq6puj7yesMq7KRJ=PC81poUKhMNCdH-OXZg@mail.gmail.com>

On Sun, Mar 2, 2014 at 7:59 PM, Yev Pod <yevpod at gmail.com> wrote:
> Hi,
>
> Do you know why none of the downloads are available?

The docs downloads should be working now.

--
Zach

From zachary.ware+pydocs at gmail.com  Thu Mar 20 17:05:47 2014
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Thu, 20 Mar 2014 11:05:47 -0500
Subject: [docs] Doc's
In-Reply-To: <5313957C.2000602@q.com>
References: <5313957C.2000602@q.com>
Message-ID: <CAKJDb-OrBg+A-5kQ_ToKioL-8NyiJH=xgJwf-PYsuY5j-1315w@mail.gmail.com>

On Sun, Mar 2, 2014 at 2:33 PM, Robert A. Cressman <BOHICAMAN at q.com> wrote:
> Tried several times to download the Documents for Python, but keep getting
> the "Page not available" error message.

The downloads should be working now.

-- 
Zach

From zachary.ware+pydocs at gmail.com  Thu Mar 20 17:06:20 2014
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Thu, 20 Mar 2014 11:06:20 -0500
Subject: [docs] No python 3.3 documentation archive
In-Reply-To: <531339E6.4060904@free.fr>
References: <531339E6.4060904@free.fr>
Message-ID: <CAKJDb-OsvtXc-WKzsD6WCPFrAFdV+adZy9VwKG4vPYS0VKEpXw@mail.gmail.com>

On Sun, Mar 2, 2014 at 8:02 AM, Francis Adelving
<francis.adelving at free.fr> wrote:
> Hi,
>
> All the links to Python 3.3 documentation (from
> http://docs.python.org/3/download.html)  are dead, for instance :
> "The requested URL /3/archives/python-3.3.5rc2-docs-pdf-a4.zip was not found
> on this server."

The downloads should be working now.

-- 
Zach

From zachary.ware+pydocs at gmail.com  Thu Mar 20 17:26:13 2014
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Thu, 20 Mar 2014 11:26:13 -0500
Subject: [docs] maybe typo in C-API/type object
In-Reply-To: <CAN_7T0KW4NSdZrM8koz77r7FAaMrP+_4xO08G3-T5qZUxtpbWw@mail.gmail.com>
References: <CAN_7T0KW4NSdZrM8koz77r7FAaMrP+_4xO08G3-T5qZUxtpbWw@mail.gmail.com>
Message-ID: <CAKJDb-NsuK+02Mm3s5WU7SV5M8S4XZ+wV59uX_NhDwwEaSDApg@mail.gmail.com>

On Wed, Feb 26, 2014 at 8:55 PM, tomo cocoa <cocoatomo77 at gmail.com> wrote:
> Hello,
>
> I'am a Japanese translator for Python documents.
>
>
> In the PyTypeObject.tp_dictoffset explanation, the 6th paragraph contains a
> sentence
>
>    "Since the dictionary is always found via tp_dictoffset".
>
> But this may be
>
>    "Since the dictionary offset is always found via tp_dictoffset".
>
> http://docs.python.org/3.3/c-api/typeobj.html#PyTypeObject.tp_dictoffset

As far as I can tell, I think that page is actually right as is (or at
the very least, ambiguous).  If you can explain to me why it doesn't
work as is, I'm happy to reconsider :)

Thanks for the report!

-- 
Zach

From zachary.ware+pydocs at gmail.com  Thu Mar 20 18:00:23 2014
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Thu, 20 Mar 2014 12:00:23 -0500
Subject: [docs] a missed closing parenthesis
In-Reply-To: <CAN_7T0+S1iB6=e3o6nbwS5bme7rbbrzuvR6dxS4HQOUfJvo7Lg@mail.gmail.com>
References: <CAN_7T0+S1iB6=e3o6nbwS5bme7rbbrzuvR6dxS4HQOUfJvo7Lg@mail.gmail.com>
Message-ID: <CAKJDb-PA5Od=F4Gq66c4Wh=rboMa4uSZxonb+FGeky2C1Eauqw@mail.gmail.com>

On Mon, Mar 17, 2014 at 10:44 AM, tomo cocoa <cocoatomo77 at gmail.com> wrote:
> Hello,
>
> I am a Japanese translator on Python documents , cocoatomo.
>
> http://docs.python.org/3.3/distutils/apiref.html#distutils.dir_util.copy_tree
>
> The third paragraph may miss a closing parenthesis just after a word "page".

Good catch!  This has been fixed in 0a656d469284 and will be live
soon.  Thanks for the report!

-- 
Zach

From zachary.ware+pydocs at gmail.com  Thu Mar 20 18:00:18 2014
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Thu, 20 Mar 2014 12:00:18 -0500
Subject: [docs] Documentation Bug in OS.makedirs?
In-Reply-To: <etPan.53273b2d.625558ec.426a@Passaconaway.local>
References: <etPan.53273b2d.625558ec.426a@Passaconaway.local>
Message-ID: <CAKJDb-Oy8GywMhQhDfL5NvADSZ2oVms8Pgvyvvo9q8uKTYXGAQ@mail.gmail.com>

On Mon, Mar 17, 2014 at 1:13 PM, Colin Davis <e1ven at e1ven.com> wrote:
> I'm trying to use os.makedirs on Py3 (3.3 or 3.4) and pass in a path-
> This works when I do so positionally, but throws an exception when I do so
> by keyword.
> You can see an example at https://gist.github.com/e1ven/bb269423a7043e6fdc77
>
> When you look in the code at
> (http://hg.python.org/cpython/file/3bb83f18851f/Lib/os.py) it looks like
> it's looking for the parameter "name", but the docs
> (http://docs.python.org/3.4/library/os.html) seem to say to pass "path".
>
> Perhaps the Docs are incorrect here?

Indeed they are.  This has been fixed in 8d53d3f61b0c and will be live soon.

Thanks for the report!

-- 
Zach

From zachary.ware+pydocs at gmail.com  Thu Mar 20 18:00:34 2014
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Thu, 20 Mar 2014 12:00:34 -0500
Subject: [docs] An unmatched parenthesis
In-Reply-To: <CAN_7T0LE3uFXZHi-MUsBwA_yyFqyF_xEUfj6YTb5CgGhTRSqug@mail.gmail.com>
References: <CAN_7T0LE3uFXZHi-MUsBwA_yyFqyF_xEUfj6YTb5CgGhTRSqug@mail.gmail.com>
Message-ID: <CAKJDb-MwYXeYBLasCBa34UAbpmQ0cWnJUk8j5Lo+YTfXA_s=KA@mail.gmail.com>

On Sat, Mar 15, 2014 at 1:42 AM, tomo cocoa <cocoatomo77 at gmail.com> wrote:
> Hello,
>
> I am a Japanese Python documents translator, cocoatomo.
>
> "Embedding/Extending FAQ" has an unmatched closing parenthesis in the fourth
> paragraph.
>
>    PySequence_GetItem(), etc.)
>
> http://docs.python.org/3.3/faq/extending.html#how-do-i-extract-c-values-from-a-python-object
>
> I guess that removal of the closing parenthesis following a word "etc." is a
> solution.

This has been fixed in 3afa9116859c and will be live soon.  Thanks for
the report!

-- 
Zach

From zachary.ware+pydocs at gmail.com  Thu Mar 20 18:00:29 2014
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Thu, 20 Mar 2014 12:00:29 -0500
Subject: [docs] Typo in 3.4 doc for enum module
In-Reply-To: <F73B96943F49814AB847F777964141BD0A00FE09FB@srvexchange>
References: <F73B96943F49814AB847F777964141BD0A00FE09FB@srvexchange>
Message-ID: <CAKJDb-MOfeL4gkMM1GAHZwnAoP0t4aT-S8GKS8k829qPebNtRw@mail.gmail.com>

On Mon, Mar 17, 2014 at 4:47 AM, Tobias K?s <Tobias.Kaes at syncos.com> wrote:
> In section "8.13.12.2. Others":
>> 3. When another data type is mixed in, the value attribute is not the same as the enum member itself, although it is equivalant and will compare equal.
>
> "equivalant" probably should be "equivalent"

Thanks for the report!  This has been fixed as a part of 9d0d0de3161d
and will be live soon.

-- 
Zach

From zachary.ware+pydocs at gmail.com  Thu Mar 20 18:00:45 2014
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Thu, 20 Mar 2014 12:00:45 -0500
Subject: [docs] Notation in 2.7 Library, Sec 5.6 Sequence Types
In-Reply-To: <CAGYcuDNDo9cgMLqLCPPHrivx=CaDBxhS3fGscqDz5rEVgUur2w@mail.gmail.com>
References: <CAGYcuDNDo9cgMLqLCPPHrivx=CaDBxhS3fGscqDz5rEVgUur2w@mail.gmail.com>
Message-ID: <CAKJDb-PK0HoVkhLvOqTAsDnXWnCJTuN7iH4K2HgSPn+AMyYrqw@mail.gmail.com>

On Thu, Mar 6, 2014 at 6:41 AM, Bruce Esrig <esrig-ia at esrig.com> wrote:
>
> In the table explaining sequence types, the following two rows appear at the end.
>
> s.index(i) index of the first occurrence of i in s
> s.count(i) total number of occurrences of i in s
>
> Conventionally, i is an index. An x is used to indicate an element.
> I would suggest
>
> s.index(x) index of the first occurrence of x in s
> s.count(x) total number of occurrences of x in s

Thanks for the suggestion!  This has been fixed in babb9479b79f and
will be live soon.

-- 
Zach

From sonny.srii at gmail.com  Thu Mar 20 16:46:12 2014
From: sonny.srii at gmail.com (Sonny Valkeneers)
Date: Thu, 20 Mar 2014 16:46:12 +0100
Subject: [docs] Error downloading python docs
In-Reply-To: <CAKJDb-Osn==X2e=mEfE3D5Wh2TF_AqB4q72kSDkh0AOAH+NR=Q@mail.gmail.com>
References: <CANbpVjEXpqo47yAHV+_e-gt0EgT8+u=EiL-y2+cWRe+3Xi_k1A@mail.gmail.com>
 <CAKJDb-Osn==X2e=mEfE3D5Wh2TF_AqB4q72kSDkh0AOAH+NR=Q@mail.gmail.com>
Message-ID: <CANbpVjEqFcmVUSs0YhHx66n4xY17p7H2vM-syweqPBWRofWwQQ@mail.gmail.com>

Ok, thanks for letting me know. I had already downloaded the 2.7 docs,
though
On Mar 20, 2014 4:43 PM, "Zachary Ware" <zachary.ware+pydocs at gmail.com>
wrote:

> On Sun, Mar 9, 2014 at 9:46 AM, Sonny Valkeneers <sonny.srii at gmail.com>
> wrote:
> > Hello,
> >
> > I've encountered the following error whilst trying to download the docs.
> > (Image included as attachment.)
> >
> > All links are not found on the server.
> >
> > Probably nothing major, but I thought I'd let you know.
>
> This appears to be working now.  Thanks for the report!
>
> --
> Zach
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140320/706fd85c/attachment-0001.html>

From BOHICAMAN at q.com  Thu Mar 20 17:56:04 2014
From: BOHICAMAN at q.com (Robert A. Cressman)
Date: Thu, 20 Mar 2014 10:56:04 -0600
Subject: [docs] Doc's
In-Reply-To: <CAKJDb-OrBg+A-5kQ_ToKioL-8NyiJH=xgJwf-PYsuY5j-1315w@mail.gmail.com>
References: <5313957C.2000602@q.com>
 <CAKJDb-OrBg+A-5kQ_ToKioL-8NyiJH=xgJwf-PYsuY5j-1315w@mail.gmail.com>
Message-ID: <532B1DA4.4000106@q.com>

Zach,
I just tried again and they finally downloaded. Response from the web 
site was extremely slow (3 minutes) till download started. At first I 
got an error and Windows7 asked if I wanted to retry. When I indicated 
yes, it did download. Just an FYI.
Bob

On 3/20/2014 10:05 AM, Zachary Ware wrote:
> On Sun, Mar 2, 2014 at 2:33 PM, Robert A. Cressman <BOHICAMAN at q.com> wrote:
>> Tried several times to download the Documents for Python, but keep getting
>> the "Page not available" error message.
> The downloads should be working now.
>

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

From report at bugs.python.org  Thu Mar 20 19:37:41 2014
From: report at bugs.python.org (Zachary Ware)
Date: Thu, 20 Mar 2014 18:37:41 +0000
Subject: [docs] [issue19861] Update What's New for Python 3.4
In-Reply-To: <1385986982.03.0.371652275474.issue19861@psf.upfronthosting.co.za>
Message-ID: <1395340661.19.0.73056833783.issue19861@psf.upfronthosting.co.za>


Zachary Ware added the comment:

Thanks for the #3158 addition, David :)

We've been a week with no more major changes; is this issue done?

----------

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

From report at bugs.python.org  Thu Mar 20 19:44:32 2014
From: report at bugs.python.org (Arfrever Frehtes Taifersar Arahesis)
Date: Thu, 20 Mar 2014 18:44:32 +0000
Subject: [docs] [issue17188] Document 'from None' in raise statement doc.
In-Reply-To: <1360631999.8.0.76627095073.issue17188@psf.upfronthosting.co.za>
Message-ID: <1395341072.59.0.0373999088491.issue17188@psf.upfronthosting.co.za>


Changes by Arfrever Frehtes Taifersar Arahesis <Arfrever.FTA at GMail.Com>:


----------
nosy: +Arfrever

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

From report at bugs.python.org  Thu Mar 20 20:21:17 2014
From: report at bugs.python.org (R. David Murray)
Date: Thu, 20 Mar 2014 19:21:17 +0000
Subject: [docs] [issue19861] Update What's New for Python 3.4
In-Reply-To: <1385986982.03.0.371652275474.issue19861@psf.upfronthosting.co.za>
Message-ID: <1395343277.49.0.238314385164.issue19861@psf.upfronthosting.co.za>


R. David Murray added the comment:

Oh, yeah, it should be.  Any further changes should be independent bug reports.

----------
resolution:  -> fixed
stage:  -> committed/rejected
status: open -> closed

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

From jimjjewett at gmail.com  Thu Mar 20 20:37:33 2014
From: jimjjewett at gmail.com (jimjjewett at gmail.com)
Date: Thu, 20 Mar 2014 19:37:33 -0000
Subject: [docs] Update cgi module doc (issue 11352)
Message-ID: <20140320193733.15873.10397@psf.upfronthosting.co.za>


http://bugs.python.org/review/11352/diff/4862/Doc/library/cgi.rst
File Doc/library/cgi.rst (right):

http://bugs.python.org/review/11352/diff/4862/Doc/library/cgi.rst#newcode32
Doc/library/cgi.rst:32: submitted through an HTML ``<FORM>`` element.
Marking for posterity:  ISINDEX is obsolete, but still supported.  This
change is OK anyhow because of the "usually".

http://bugs.python.org/review/11352/diff/4862/Doc/library/cgi.rst#newcode95
Doc/library/cgi.rst:95: consume standard input, it should be
instantiated only once.
Once once per what?  Per Request?  Per process?  Per process until the
previous instantiation has finished its work, and can be finalized?

http://bugs.python.org/review/11352/diff/4862/Doc/library/cgi.rst#newcode99
Doc/library/cgi.rst:99: is usually contained in the META tag in the HEAD
section of the HTML
Also, "in a META element", rather than *the* element.

Also, encoding depends on the data uploaded, not just on the form sent. 
I'm not sure how to word that, but here is a try:

The *encoding* and *errors* parameters indicate how to decode the bytes
into text strings.  (See the :mod:`str` documentation.)  The default
assumption is ASCII, with any other characters causing an exception to
be raised.  Often, a better guess is available, typically from
application- (or form-) specific knowledge, a :mailheader:`Content-Type`
header's `charset` attribute, or a  ``<META>`` element.


Note that I agree a link might be better still; I'm just not sure how to
do it.

http://bugs.python.org/review/11352/diff/4862/Doc/make.bat
File Doc/make.bat (right):

http://bugs.python.org/review/11352/diff/4862/Doc/make.bat#newcode5
Doc/make.bat:5: if "%PYTHON%" EQU "" set PYTHON=c:/python27/python.exe
This seems like a change to for bootstrapping or cross-compiling --
unrelated to the doc changes.

http://bugs.python.org/review/11352/diff/4862/Lib/http/server.py
File Lib/http/server.py (right):

http://bugs.python.org/review/11352/diff/4862/Lib/http/server.py#newcode1167
Lib/http/server.py:1167: stdin=stdin,
This change is not just documentation, and should probably be discussed
separately.

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

From report at bugs.python.org  Thu Mar 20 20:38:57 2014
From: report at bugs.python.org (Jim Jewett)
Date: Thu, 20 Mar 2014 19:38:57 +0000
Subject: [docs] [issue11352] Update cgi module doc
In-Reply-To: <1298895261.86.0.965235067518.issue11352@psf.upfronthosting.co.za>
Message-ID: <1395344336.75.0.0870755306453.issue11352@psf.upfronthosting.co.za>


Jim Jewett added the comment:

I have now also looked at cgi-doc.patch, and it is not strictly documentation changes.  I have no informed opinion on the the additional changes, but I don't think they should go in as "doc change".

----------

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

From report at bugs.python.org  Thu Mar 20 20:58:34 2014
From: report at bugs.python.org (R. David Murray)
Date: Thu, 20 Mar 2014 19:58:34 +0000
Subject: [docs] [issue11352] Update cgi module doc
In-Reply-To: <1298895261.86.0.965235067518.issue11352@psf.upfronthosting.co.za>
Message-ID: <1395345514.7.0.811913093448.issue11352@psf.upfronthosting.co.za>


R. David Murray added the comment:

It looks like the non-doc stuff was accidental inclusions and should be ignored.  Or better, the patch author could address Berker and Jim's comments and resubmit a clean patch.

----------

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

From report at bugs.python.org  Thu Mar 20 21:00:38 2014
From: report at bugs.python.org (Daniel U. Thibault)
Date: Thu, 20 Mar 2014 20:00:38 +0000
Subject: [docs] [issue20686] Confusing statement about unicode strings in
	tutorial	introduction
In-Reply-To: <1392827095.92.0.836578340147.issue20686@psf.upfronthosting.co.za>
Message-ID: <1395345638.14.0.0710363520699.issue20686@psf.upfronthosting.co.za>


Daniel U. Thibault added the comment:

>>> mystring="???"
>>> myustring=u"???"

>>> mystring
'\xc3\xa4\xc3\xb6\xc3\xbc'
>>> myustring
u'\xe4\xf6\xfc'

>>> str(mystring)
'\xc3\xa4\xc3\xb6\xc3\xbc'
>>> str(myustring)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
UnicodeEncodeError: 'ascii' codec can't encode characters in position 0-2: ordinal not in range(128)

>>> f = open('workfile', 'w')
>>> f.write(mystring)
>>> f.close()
>>> f = open('workufile', 'w')
>>> f.write(myustring)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
UnicodeEncodeError: 'ascii' codec can't encode characters in position 0-2: ordinal not in range(128)
>>> f.close()

workfile contains C3 A4 C3 B6 C3 BC

So the Unicode string (myustring) does indeed try to convert to ASCII when written to file. But not when just printed.

It seems really strange that non-Unicode strings (mystring) should actually be more flexible than Unicode strings...

----------

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

From report at bugs.python.org  Fri Mar 21 00:14:58 2014
From: report at bugs.python.org (Georg Brandl)
Date: Thu, 20 Mar 2014 23:14:58 +0000
Subject: [docs] [issue20686] Confusing statement about unicode strings in
	tutorial	introduction
In-Reply-To: <1392827095.92.0.836578340147.issue20686@psf.upfronthosting.co.za>
Message-ID: <1395357298.1.0.39546714925.issue20686@psf.upfronthosting.co.za>


Georg Brandl added the comment:

First, entering a string at the command prompt like this is not considered "printing"; it's invoking the repr().

Then, when you say flexible, you say it as if it's a good thing.  In this context "flexible" means as much as "easy to produce mojibake" and is not desirable.

For all these use cases, there are ways to do the right thing with Unicode strings in Python 2 (e.g. using io.open instead of builtin open).  But making these the builtin case was the big gain of Python 3.

----------

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

From report at bugs.python.org  Fri Mar 21 03:30:19 2014
From: report at bugs.python.org (Graham Wideman)
Date: Fri, 21 Mar 2014 02:30:19 +0000
Subject: [docs] [issue20906] Issues in Unicode HOWTO
In-Reply-To: <1394702187.81.0.00522221343959.issue20906@psf.upfronthosting.co.za>
Message-ID: <1395369019.32.0.823040015509.issue20906@psf.upfronthosting.co.za>


Graham Wideman added the comment:

Marc-Andre: Thanks for your latest comments. 

> We could also have called encodings: "character set", "code page",
> "character encoding", "transformation", etc.

I concur with you that things _could_ be called all sorts of names, and the choices may be arbitrary. However, creating a clear explanation requires figuring out the distinct things of interest in the domain, picking terms for those things that are distinct, and then using those terms rigorously. (Usage in the field may vary, which in itself may warrant comment.)

I read your slide deck/time-capsule-from-2002,  with interest, on a number of points. (I realize that you were involved in the Python 2.x implementation of Unicode. Not sure about 3.x?)

Page 8 "What is a Character?" is lovely, showing very explicitly Unicode's two levels of mapping, and giving names to the separate parts. It strongly suggests this HOWTO page needs a similar figure.

That said, there are a few notes to make on that slide, useful in trying to arrive at consistent terms: 

1. The figure shows a more precise word for "what users regard as a character", namely "grapheme". I'd forgotten that.

2. It shows e-accent-acute to demonstrate a pair of code points representing a single grapheme. That's important, but should avoid suggesting this as the only way to form e-accent-acute (canonical equivalence, U+00E9).

3. The illustration identifies the series of code points (the middle row) as "the Unicode encoding of the string". Ie: The grapheme-to-code-points mapping is described as an encoding. Not a wrong use of general language. But inconsistent with the mapping that encode() pertains to. (And I don't think that the code-point-to-grapheme transform is ever called "decoding", but I could be wrong.)

4. The illustration of Code Units (in the third row) shows graphemes for the Code Units (byte values). This confusingly glosses over the fact that those graphemes correspond to what you would see if you _decoded_ these byte values using CP1252 or ISO 8859-1, suggesting that the result is reasonable or useful. It certainly happens that people do this, deliberately or accidentally, but it is a misuse of the data, and should be warned against, or at least explained as a confusion.

Returning to your most recent message:

> In Python keep it simple: you have Unicode (code points) and 
> 8-bit strings or bytes (code units).

I wish it _were_ that simple. And I agree that, in principle, (assuming Python 3+) there should "inside your program" where you have the str type which always acts as sequences of Unicode code points, and has string functions. And then there's "outside your program", where text is represented by sequences of bytes that specify or imply some encoding. And your program should use supplied library functions to mostly automatically convert on the way in and on the way out.

But there are enough situations where the Python programmer, having adopted Python 3's string = Unicode approach, sees unexpected results. That prompts reading this page, which is called upon to make the fine distinctions to allow figuring out what's going on.

I'm not sure what you mean by "8-bit strings" but I'm pretty sure that's not an available type in Python 3+. Ie: Some functions (eg: encode()) produce sequences of bytes, but those don't work entirely like strs. 

-----------
This discussion to try to revise the article piecemeal has become pretty diffuse, with perhaps competing notions of purpose, and what level of detail and precision are needed etc. I will try to suggest something productive in a subsequent message.

----------

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

From report at bugs.python.org  Fri Mar 21 04:49:52 2014
From: report at bugs.python.org (Graham Wideman)
Date: Fri, 21 Mar 2014 03:49:52 +0000
Subject: [docs] [issue20906] Issues in Unicode HOWTO
In-Reply-To: <1394702187.81.0.00522221343959.issue20906@psf.upfronthosting.co.za>
Message-ID: <1395373792.86.0.823185562406.issue20906@psf.upfronthosting.co.za>


Graham Wideman added the comment:

At the moment I've run out of time to exert much forward push on this.

By way of temporary summary/suggestion for regrouping: Focus on what this page is intending to deliver. What concepts should readers of this page be able to distinguish and understand when they are finished?

To scope out the needed concepts, I suggest identifying representative unicode-related stumbling blocks (possibly from stackoverflow questions).

Here's an example case: just trying to get trivial "beyond ASCII" functionality to work on Windows (Win7, Python 3.3):

--------------------
s = 'knight \u265E'
print('Hello ' + s)
--------------------

... which fails with:

"UnicodeEncodeError: 'charmap' codec can't encode character '\u265e' in position 13: character maps to undefined". 

A naive attempt to fix this by using s.encode() results in the "+" operation failing.

What paths forward do programmers explore in an effort to have this code (a) not throw an exception, and produce at least some output, and (b) make it produce the correct output?

And why does it work as intended on linux?

The set of concepts identified and explained in this article needs to be sufficient to underpin an understanding of the distinct data types, encodings, decodings, translations, settings etc relevant to this problem, and how to use them to get a desired result.

There are similar problems that occur at other Python-system boundaries, which would further illuminate the set of necessary concepts.

Thanks for all comments.

-- Graham

----------

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

From report at bugs.python.org  Fri Mar 21 09:11:51 2014
From: report at bugs.python.org (Tuomas Savolainen)
Date: Fri, 21 Mar 2014 08:11:51 +0000
Subject: [docs] [issue20344] subprocess.check_output() docs misrepresent
	what	shell=True does
In-Reply-To: <1390400705.04.0.503333173013.issue20344@psf.upfronthosting.co.za>
Message-ID: <1395389511.81.0.164134240785.issue20344@psf.upfronthosting.co.za>


Tuomas Savolainen added the comment:

Made a patch that throws exception as suggested:
"3- Make check_output() throw an Exception if the first argument is a list and shell=True"

----------
keywords: +patch
nosy: +Tuomas.Savolainen
Added file: http://bugs.python.org/file34543/issue20344.patch

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

From report at bugs.python.org  Fri Mar 21 09:45:52 2014
From: report at bugs.python.org (Jovik)
Date: Fri, 21 Mar 2014 08:45:52 +0000
Subject: [docs] [issue20927] Different behaviour on Posix and Windows when
	using	subprocess.Popen(..., cwd=path)
In-Reply-To: <1394816385.18.0.912805951896.issue20927@psf.upfronthosting.co.za>
Message-ID: <1395391552.08.0.011431891596.issue20927@psf.upfronthosting.co.za>


Jovik added the comment:

I appreciate your suggestion regarding cygwin, but in the new code base we want to avoid this dependency. Thanks for your time on this issue.

----------

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

From report at bugs.python.org  Fri Mar 21 09:54:34 2014
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 21 Mar 2014 08:54:34 +0000
Subject: [docs] [issue10240] dict.update.__doc__ is misleading
In-Reply-To: <1288406048.13.0.615215732385.issue10240@psf.upfronthosting.co.za>
Message-ID: <1395392074.98.0.944746345988.issue10240@psf.upfronthosting.co.za>


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


----------
assignee:  -> docs at python
components: +Documentation -Interpreter Core
nosy: +berker.peksag, docs at python
versions: +Python 3.4, Python 3.5 -Python 3.1, Python 3.2

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

From report at bugs.python.org  Fri Mar 21 11:42:40 2014
From: report at bugs.python.org (Alexandre JABORSKA)
Date: Fri, 21 Mar 2014 10:42:40 +0000
Subject: [docs] [issue21005] asyncio.docs : asyncio.subprocess.DEVNULL doc
	inadequate
Message-ID: <1395398560.63.0.792567362612.issue21005@psf.upfronthosting.co.za>


New submission from Alexandre JABORSKA:

asyncio.subprocess.DEVNULL documentation is the same as asyncio.subprocess.STDOUT one and (I guess) inadequate (cut & paste error ?).

----------
assignee: docs at python
components: Documentation
messages: 214338
nosy: ajaborsk, docs at python
priority: normal
severity: normal
status: open
title: asyncio.docs : asyncio.subprocess.DEVNULL doc inadequate
versions: Python 3.4

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

From report at bugs.python.org  Fri Mar 21 11:46:36 2014
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 21 Mar 2014 10:46:36 +0000
Subject: [docs] [issue21005] asyncio.docs : asyncio.subprocess.DEVNULL doc
	inadequate
In-Reply-To: <1395398560.63.0.792567362612.issue21005@psf.upfronthosting.co.za>
Message-ID: <3fr1rC3K2yz7Lk0@mail.python.org>


Roundup Robot added the comment:

New changeset 70c77ff64df1 by Victor Stinner in branch 'default':
Close #21005: Fix documentation of asyncio.subprocess.DEVNULL
http://hg.python.org/cpython/rev/70c77ff64df1

----------
nosy: +python-dev
resolution:  -> fixed
stage:  -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Fri Mar 21 11:46:57 2014
From: report at bugs.python.org (STINNER Victor)
Date: Fri, 21 Mar 2014 10:46:57 +0000
Subject: [docs] [issue21005] asyncio.docs : asyncio.subprocess.DEVNULL doc
	inadequate
In-Reply-To: <1395398560.63.0.792567362612.issue21005@psf.upfronthosting.co.za>
Message-ID: <1395398817.29.0.348854976461.issue21005@psf.upfronthosting.co.za>


STINNER Victor added the comment:

> and (I guess) inadequate (cut & paste error ?).

Correct, my bad. It's now fixed. Thanks for the report.

----------
nosy: +haypo
resolution: fixed -> 
stage: committed/rejected -> 
status: closed -> open

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

From report at bugs.python.org  Fri Mar 21 11:54:02 2014
From: report at bugs.python.org (Alexandre JABORSKA)
Date: Fri, 21 Mar 2014 10:54:02 +0000
Subject: [docs] [issue21006] asyncio.docs : create_subprocess_exec example
	does not	work on windows
Message-ID: <1395399242.2.0.683863961681.issue21006@psf.upfronthosting.co.za>


New submission from Alexandre JABORSKA:

The documentation example (getstatusoutput) does not work on windows because it use the default loop (based on select). The whole asyncio.ProactorEventLoop stuff is not really explained anywhere. Maybe a "How to use asyncio on Windows" could be useful.

----------
assignee: docs at python
components: Documentation
messages: 214341
nosy: ajaborsk, docs at python
priority: normal
severity: normal
status: open
title: asyncio.docs : create_subprocess_exec example does not work on windows
versions: Python 3.4

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

From report at bugs.python.org  Fri Mar 21 11:56:49 2014
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 21 Mar 2014 10:56:49 +0000
Subject: [docs] [issue21006] asyncio.docs : create_subprocess_exec example
	does not	work on windows
In-Reply-To: <1395399242.2.0.683863961681.issue21006@psf.upfronthosting.co.za>
Message-ID: <3fr24056Vgz7LjS@mail.python.org>


Roundup Robot added the comment:

New changeset 7cca663a72eb by Victor Stinner in branch 'default':
Issue #21006: Fix subprocess example on Windows in asyncio doc
http://hg.python.org/cpython/rev/7cca663a72eb

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

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

From report at bugs.python.org  Fri Mar 21 12:08:57 2014
From: report at bugs.python.org (STINNER Victor)
Date: Fri, 21 Mar 2014 11:08:57 +0000
Subject: [docs] [issue21006] asyncio.docs : create_subprocess_exec example
	does not	work on windows
In-Reply-To: <1395399242.2.0.683863961681.issue21006@psf.upfronthosting.co.za>
Message-ID: <1395400137.14.0.599325457556.issue21006@psf.upfronthosting.co.za>


STINNER Victor added the comment:

Oh, the limit parameter StreamReader is not documented! Here is a patch to document it.

----------
nosy: +gvanrossum, haypo, yselivanov

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

From report at bugs.python.org  Fri Mar 21 12:09:03 2014
From: report at bugs.python.org (STINNER Victor)
Date: Fri, 21 Mar 2014 11:09:03 +0000
Subject: [docs] [issue21006] asyncio.docs : create_subprocess_exec example
	does not	work on windows
In-Reply-To: <1395399242.2.0.683863961681.issue21006@psf.upfronthosting.co.za>
Message-ID: <1395400143.3.0.40893018676.issue21006@psf.upfronthosting.co.za>


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


----------
keywords: +patch
Added file: http://bugs.python.org/file34544/streamreader_limit.patch

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

From report at bugs.python.org  Fri Mar 21 12:11:33 2014
From: report at bugs.python.org (STINNER Victor)
Date: Fri, 21 Mar 2014 11:11:33 +0000
Subject: [docs] [issue21006] asyncio.docs : create_subprocess_exec example
	does not	work on windows
In-Reply-To: <1395399242.2.0.683863961681.issue21006@psf.upfronthosting.co.za>
Message-ID: <1395400293.67.0.380825491964.issue21006@psf.upfronthosting.co.za>


STINNER Victor added the comment:

> The whole asyncio.ProactorEventLoop stuff is not really explained
> anywhere. Maybe a "How to use asyncio on Windows" could be useful.

It is explained in the subprocess methods of the event loop.

Well, I expected this reaction: the subprocess documentation is currently splitted in two parts (event loop and asyncio.subprocess). IMO all functions related to subprocess must be moved to the subprocess page.

Here is a patch to group all subprocess documentation. I added a "Connect pipes" section, mentionned that event loop functions are the "low level API" whereas the asyncio.subprocess is the "high level API".

----------
Added file: http://bugs.python.org/file34545/asyncio_subprocess.patch

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

From report at bugs.python.org  Fri Mar 21 14:08:44 2014
From: report at bugs.python.org (Alexandre JABORSKA)
Date: Fri, 21 Mar 2014 13:08:44 +0000
Subject: [docs] [issue21006] asyncio.docs : create_subprocess_exec example
	does not	work on windows
In-Reply-To: <1395399242.2.0.683863961681.issue21006@psf.upfronthosting.co.za>
Message-ID: <1395407324.65.0.697088244659.issue21006@psf.upfronthosting.co.za>


Alexandre JABORSKA added the comment:

I saw the "low level" part with the warning. But what I mean is that I found no clear indication on how to change default loop to allow asyncio.subprocess usage with Windows Python. I guessed :

asyncio.set_event_loop(ProactorEventLoop())

but I'm not sure (it works for me).

----------

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

From report at bugs.python.org  Fri Mar 21 14:38:22 2014
From: report at bugs.python.org (R. David Murray)
Date: Fri, 21 Mar 2014 13:38:22 +0000
Subject: [docs] [issue20344] subprocess.check_output() docs misrepresent
	what	shell=True does
In-Reply-To: <1390400705.04.0.503333173013.issue20344@psf.upfronthosting.co.za>
Message-ID: <1395409102.78.0.769665868365.issue20344@psf.upfronthosting.co.za>


R. David Murray added the comment:

Thanks Tuomas, but we don't have any consensus that that kind of change will be accepted.  It's just my opinion that it should be...and if it was, it would have to start with a deprecation, not raising an exception.

What we need as a patch for this issue is a documentation patch explaining why using shell=True with a list is a bad idea in the 'frequently used arguments' section.  The paragraph about 'args' in the frequently used arguments section should say something like 'using shell=True with a list containing more than one element does not currently raise an error, but it will not do what you expect; only the first element of the list will be executed on unix, and on windows the quoting is likely to be incorrect.  See the Popen constructor documentation below for a more precise description.'

(You can see why I think this usage should be deprecated, I hope ;)

----------

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

From report at bugs.python.org  Fri Mar 21 14:56:13 2014
From: report at bugs.python.org (Ram Rachum)
Date: Fri, 21 Mar 2014 13:56:13 +0000
Subject: [docs] [issue21007] List of development releases in PEPs like 429
	should be	links to download pages
Message-ID: <1395410173.99.0.42942358858.issue21007@psf.upfronthosting.co.za>


Changes by Ram Rachum <ram at rachum.com>:


----------
assignee: docs at python
components: Documentation
nosy: cool-RR, docs at python
priority: normal
severity: normal
status: open
title: List of development releases in PEPs like 429 should be links to download pages
type: behavior
versions: Python 2.7, Python 3.1, Python 3.2, Python 3.3, Python 3.4, Python 3.5

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

From report at bugs.python.org  Fri Mar 21 15:08:34 2014
From: report at bugs.python.org (Benjamin Peterson)
Date: Fri, 21 Mar 2014 14:08:34 +0000
Subject: [docs] [issue21007] List of development releases in PEPs like 429
	should be	links to download pages
Message-ID: <1395410914.19.0.885357415435.issue21007@psf.upfronthosting.co.za>


New submission from Benjamin Peterson:

I disagree. They are easy enough to find on the website. Easier than the release schedule I hope! Of course, RMs are welcome to link to the download page if they want, but we needn't require it.

----------
nosy: +benjamin.peterson
resolution:  -> rejected
status: open -> closed

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

From report at bugs.python.org  Fri Mar 21 16:33:00 2014
From: report at bugs.python.org (Nitika Agarwal)
Date: Fri, 21 Mar 2014 15:33:00 +0000
Subject: [docs] [issue18566] In unittest.TestCase docs for setUp() and
	tearDown()	don't mention AssertionError
In-Reply-To: <1374901937.1.0.747872580847.issue18566@psf.upfronthosting.co.za>
Message-ID: <1395415979.9.0.171339285749.issue18566@psf.upfronthosting.co.za>


Nitika Agarwal added the comment:

Hi,
I am attaching a patch with the changes made as suggested by py.user.

----------
nosy: +nitika
Added file: http://bugs.python.org/file34550/document18566.patch

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

From report at bugs.python.org  Fri Mar 21 17:04:17 2014
From: report at bugs.python.org (Claudiu.Popa)
Date: Fri, 21 Mar 2014 16:04:17 +0000
Subject: [docs] [issue21010] asyncio doc typo
Message-ID: <1395417857.61.0.236262518907.issue21010@psf.upfronthosting.co.za>


New submission from Claudiu.Popa:

There is an invalid item "meth:`resume_reading`".

----------
assignee: docs at python
components: Documentation
files: asyncio_doc_fix.patch
keywords: patch
messages: 214381
nosy: Claudiu.Popa, docs at python
priority: normal
severity: normal
status: open
title: asyncio doc typo
versions: Python 3.5
Added file: http://bugs.python.org/file34552/asyncio_doc_fix.patch

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

From report at bugs.python.org  Fri Mar 21 17:16:21 2014
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 21 Mar 2014 16:16:21 +0000
Subject: [docs] [issue21005] asyncio.docs : asyncio.subprocess.DEVNULL doc
	inadequate
In-Reply-To: <1395398560.63.0.792567362612.issue21005@psf.upfronthosting.co.za>
Message-ID: <3fr98h2784z7LjR@mail.python.org>


Roundup Robot added the comment:

New changeset 230510d0cb92 by Victor Stinner in branch '3.4':
Close #21005: Fix documentation of asyncio.subprocess.DEVNULL
http://hg.python.org/cpython/rev/230510d0cb92

----------
resolution:  -> fixed
stage:  -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Fri Mar 21 17:16:22 2014
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 21 Mar 2014 16:16:22 +0000
Subject: [docs] [issue21006] asyncio.docs : create_subprocess_exec example
	does not	work on windows
In-Reply-To: <1395399242.2.0.683863961681.issue21006@psf.upfronthosting.co.za>
Message-ID: <3fr98j0m31z7LjR@mail.python.org>


Roundup Robot added the comment:

New changeset ab0aa412fca2 by Victor Stinner in branch '3.4':
Issue #21006: Fix subprocess example on Windows in asyncio doc
http://hg.python.org/cpython/rev/ab0aa412fca2

----------

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

From report at bugs.python.org  Fri Mar 21 17:17:39 2014
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 21 Mar 2014 16:17:39 +0000
Subject: [docs] [issue21010] asyncio doc typo
In-Reply-To: <1395417857.61.0.236262518907.issue21010@psf.upfronthosting.co.za>
Message-ID: <3fr9BB4SWRz7LjR@mail.python.org>


Roundup Robot added the comment:

New changeset ef4f460e3c9e by Victor Stinner in branch '3.4':
Close #21010: Fix typo in asyncio doc. Patch written by Claudiu Popa.
http://hg.python.org/cpython/rev/ef4f460e3c9e

New changeset 7761b3dff2e8 by Victor Stinner in branch 'default':
(Merge 3.4) Close #21010: Fix typo in asyncio doc. Patch written by Claudiu
http://hg.python.org/cpython/rev/7761b3dff2e8

----------
nosy: +python-dev
resolution:  -> fixed
stage:  -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Fri Mar 21 17:18:09 2014
From: report at bugs.python.org (STINNER Victor)
Date: Fri, 21 Mar 2014 16:18:09 +0000
Subject: [docs] [issue21010] asyncio doc typo
In-Reply-To: <1395417857.61.0.236262518907.issue21010@psf.upfronthosting.co.za>
Message-ID: <1395418689.04.0.140376062688.issue21010@psf.upfronthosting.co.za>


STINNER Victor added the comment:

Fix applied, thanks.

----------
nosy: +haypo
stage: committed/rejected -> 

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

From report at bugs.python.org  Fri Mar 21 17:26:57 2014
From: report at bugs.python.org (Ram Rachum)
Date: Fri, 21 Mar 2014 16:26:57 +0000
Subject: [docs] [issue21007] List of development releases in PEPs like 429
	should be	links to download pages
In-Reply-To: <1395410914.19.0.885357415435.issue21007@psf.upfronthosting.co.za>
Message-ID: <1395419217.75.0.895314442151.issue21007@psf.upfronthosting.co.za>


Ram Rachum added the comment:

I looked for it for 10 minutes but couldn't find the link. I ended up using a URL from an old script. I still don't know how I was supposed to find it.

----------

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

From report at bugs.python.org  Fri Mar 21 20:08:09 2014
From: report at bugs.python.org (Ned Deily)
Date: Fri, 21 Mar 2014 19:08:09 +0000
Subject: [docs] [issue21007] List of development releases in PEPs like 429
	should be	links to download pages
In-Reply-To: <1395410914.19.0.885357415435.issue21007@psf.upfronthosting.co.za>
Message-ID: <1395428889.11.0.727033909277.issue21007@psf.upfronthosting.co.za>


Ned Deily added the comment:

AFAIK, traditionally, there have not been separate download pages for each pre-release of a new feature (e.g. 3.4.0) or maintenance (e.g. 3.3.5) release.  The usual practice has been to create *one* release page at the usual URI (e.g. https://www.python.org/download/releases/3.3.5) for the first pre-release (alpha, beta, or rc) and then update the contents of that page for each subsequent pre-release through the final release.  The download links for the bits of earlier pre-releases are replaced on the page by those of later pre-releases or the final release.  Thus, even though the pre-release bits are still available to download at their original URIs, the links to them are no longer provided on a download page.  With the transition to the new python.org website near the end of the 3.4.0 release cycle, there were some experiments and changes in process.  In particular, separate download pages *were* created for 3.4.0rc{1,2,3} but not for earlier pre-releases of 3.4.0.  There is no guarantee at the moment that that will happen again for future releases.  If it is important that there be download links for pre-release bits, the release process needs to change and someone would need to go back and re-create those for previous releases somewhere.

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

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

From zachary.ware at gmail.com  Fri Mar 21 20:57:02 2014
From: zachary.ware at gmail.com (zachary.ware at gmail.com)
Date: Fri, 21 Mar 2014 19:57:02 -0000
Subject: [docs] Bring Doc/using/windows up to date (issue 20265)
Message-ID: <20140321195702.9409.92184@psf.upfronthosting.co.za>

Here's a review of the latest patch.


http://bugs.python.org/review/20265/diff/11340/Doc/faq/windows.rst
File Doc/faq/windows.rst (right):

http://bugs.python.org/review/20265/diff/11340/Doc/faq/windows.rst#newcode20
Doc/faq/windows.rst:20: The situation has been made somewhat simpler
since Python 3.3, which
This would make more sense if the old first sentence were kept, leading
into the new one.

http://bugs.python.org/review/20265/diff/11340/Doc/faq/windows.rst#newcode21
Doc/faq/windows.rst:21: introduced the launcher for windows.  Use is
discussed
Windows should be capitalized.  It would also be simpler to make "the
laucher for Windows" into the link to the discussion of it.

http://bugs.python.org/review/20265/diff/11340/Doc/faq/windows.rst#newcode40
Doc/faq/windows.rst:40: Unless you use some sort of integrated
development environment, you will end up
Trailing whitespace.

http://bugs.python.org/review/20265/diff/11340/Doc/faq/windows.rst#newcode46
Doc/faq/windows.rst:46: Command Prompt followed by (Admin)  You should
be able to recognize
Missing period after (Admin).

http://bugs.python.org/review/20265/diff/11340/Doc/faq/windows.rst#newcode75
Doc/faq/windows.rst:75: Python 3.3.0 (v3.3.0:bd8afb90ebf2, Sep 29 2012,
10:55:48) [MSC v.1600 32 bit (Intel)] on win32
If it hasn't already been, every instance of "3.3" or "python33" should
be updated to 3.4 (or 3.5 if you're working from the default branch)

http://bugs.python.org/review/20265/diff/11340/Doc/faq/windows.rst#newcode92
Doc/faq/windows.rst:92: Windows command prompt.
This should be updated to mention the quit and exit functions.

http://bugs.python.org/review/20265/diff/11340/Doc/faq/windows.rst#newcode147
Doc/faq/windows.rst:147: http://www.computerhope.com/issues/ch000549.htm
and note that both Windows
This should be made into a proper link with a title instead of a bare
text link.

http://bugs.python.org/review/20265/diff/11340/Doc/faq/windows.rst#newcode350
Doc/faq/windows.rst:350: http://www.winzip.com.)
No need for the change here, the file should always end with a blank
line.

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst
File Doc/using/windows.rst (right):

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode30
Doc/using/windows.rst:30: * Module Docs -Module Documentation
Missing a space in "-Module" to match the others.  Also, this line
should be  between IDLE and Python (alphabetical order, to match the
start menu entries).

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode83
Doc/using/windows.rst:83: * Find the Python directory and double click
python
These last two aren't really shortcuts.

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode86
Doc/using/windows.rst:86: Python through the launcher for windows.  Use
is discussed
Windows should be capitalized.

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode90
Doc/using/windows.rst:90: window will close immediately, usually faster
than the user can read.
The window will close as soon as the script exits.

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode92
Doc/using/windows.rst:92: Finding the Python executable
This section should get the ".. _setting-envvars:" marker, since it is
the closest thing resembling the former section on environment
variables.

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode100
Doc/using/windows.rst:100: in Windows 8, you must use the Command Prompt
(Admin).
I don't believe this added sentence is true.  If non-administrative
Command Prompt ignored PATH, it would be completely useless.  Either
way, it doesn't fit in this paragraph.

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode111
Doc/using/windows.rst:111: The alternative is manually modifying the
:envvar:`%PATH%`.  See the
I would combine this with the previous paragraph; "If you don't enable
this option at install time you can always re-run the installer to
choose it, or manually change :envvar:`PATH` yourself."

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode165
Doc/using/windows.rst:165: 
No need to remove the blank line here.

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode187
Doc/using/windows.rst:187: #. Launch a command prompt [Windows 8 -
Launch Command Prompt (Admin)]
On 2014/03/18 02:27:06, kathweaver wrote:
> Actually it is a new available option for Windows 8 users, so it
should be
> there.  The average Windows 8 probably doesn't know there are two
choices, it
> had me scratching my head for a while. 

The "Command Prompt (Admin)" option from right-clicking the start menu
button is just a shortcut for right clicking Command Prompt in the start
menu itself and choosing Run As Administrator, which is just as it was
in Windows 7 and Vista.  We should be trying to be version agnostic
anyway, so it's better to either leave this as it was, or remove "(might
require administrative rights)" from the preceding paragraph and add
"with administrative privileges" or similar where your added note is.

It should be reasonably obvious that "Command Prompt (Admin)" is a
Command Prompt with administrative privileges.

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode545
Doc/using/windows.rst:545: There is `Python Tools for Visual Studio
<https://pytools.codeplex.com/>`_ an addon published
"`Python Tools ...`_ is an add-on for Visual Studio published by
Microsoft that turns Visual Studio into a full-featured Python IDE.  It
is not compatible with Express editions of Visual Studio."

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode564
Doc/using/windows.rst:564: The proposal for the launcher to be included
in the Python distribution.
No need for the changes at the end here; the file should always end with
a blank line.

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

From report at bugs.python.org  Fri Mar 21 22:51:50 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 21 Mar 2014 21:51:50 +0000
Subject: [docs] [issue20956] tokenize module claims tokenize.tokenize
	returns	namedtuple, but it doesn't
In-Reply-To: <1395057365.37.0.876415448459.issue20956@psf.upfronthosting.co.za>
Message-ID: <1395438710.88.0.411940825683.issue20956@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/issue20956>
_______________________________________

From report at bugs.python.org  Fri Mar 21 23:09:31 2014
From: report at bugs.python.org (Raymond Hettinger)
Date: Fri, 21 Mar 2014 22:09:31 +0000
Subject: [docs] [issue10240] dict.update.__doc__ is misleading
In-Reply-To: <1288406048.13.0.615215732385.issue10240@psf.upfronthosting.co.za>
Message-ID: <1395439771.41.0.844257589245.issue10240@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

> Maybe the fastpath should do a strict check and not 
> be used for subclasses of dict?

This code is ancient and well-established.  IMO, nothing good can come from changing it (besides slowing down code that is already deployed and working fine).

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

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

From report at bugs.python.org  Sat Mar 22 01:56:45 2014
From: report at bugs.python.org (Antoine Pitrou)
Date: Sat, 22 Mar 2014 00:56:45 +0000
Subject: [docs] [issue20906] Issues in Unicode HOWTO
In-Reply-To: <1394702187.81.0.00522221343959.issue20906@psf.upfronthosting.co.za>
Message-ID: <1395449804.78.0.352952444937.issue20906@psf.upfronthosting.co.za>


Antoine Pitrou added the comment:

> "UnicodeEncodeError: 'charmap' codec can't encode character '\u265e' in position 13: character maps to undefined". 

That's because stdout is treated as a regular bytestream under Windows (as it is under POSIX), and it therefore uses the current "codepage" to encode unicode strings. See issue1602.

> And why does it work as intended on linux?

Because under most current Linux systems, stdout's encoding will be utf-8, and therefore it will be able to represent the given unicode chars.

----------

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

From report at bugs.python.org  Sat Mar 22 02:59:16 2014
From: report at bugs.python.org (Samuel Marks)
Date: Sat, 22 Mar 2014 01:59:16 +0000
Subject: [docs] [issue21014] `1` => `True`; for tutorial docs
Message-ID: <1395453556.85.0.399159850271.issue21014@psf.upfronthosting.co.za>


New submission from Samuel Marks:

Particularly for new programmers `True` makes more sense than `1` when doing boolean logic.

If you aren't going to accept this patch; at least add in a sentence explaining that: `> 1 == True`.

Best,

Samuel Marks

----------
assignee: docs at python
components: Documentation
files: Use_`True`_instead_of_`1`_.patch
hgrepos: 229
keywords: patch
messages: 214430
nosy: SamuelMarks, docs at python
priority: normal
severity: normal
status: open
title: `1` => `True`; for tutorial docs
type: enhancement
versions: Python 2.7
Added file: http://bugs.python.org/file34559/Use_`True`_instead_of_`1`_.patch

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

From report at bugs.python.org  Sat Mar 22 06:00:20 2014
From: report at bugs.python.org (Arun Persaud)
Date: Sat, 22 Mar 2014 05:00:20 +0000
Subject: [docs] [issue21018] [patch] added missing documentation about
	escaping	characters for configparser
Message-ID: <1395464420.76.0.68706986346.issue21018@psf.upfronthosting.co.za>


New submission from Arun Persaud:

Couldn't find how to escape % and $ in the documentation, so I thought I add a short patch.

----------
assignee: docs at python
components: Documentation
files: mywork.patch
keywords: patch
messages: 214442
nosy: Arun.Persaud, docs at python
priority: normal
severity: normal
status: open
title: [patch] added missing documentation about escaping characters for configparser
type: enhancement
Added file: http://bugs.python.org/file34562/mywork.patch

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

From report at bugs.python.org  Sat Mar 22 06:36:03 2014
From: report at bugs.python.org (R. David Murray)
Date: Sat, 22 Mar 2014 05:36:03 +0000
Subject: [docs] [issue21018] [patch] added missing documentation about
	escaping	characters for configparser
In-Reply-To: <1395464420.76.0.68706986346.issue21018@psf.upfronthosting.co.za>
Message-ID: <1395466563.03.0.368587805109.issue21018@psf.upfronthosting.co.za>


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


----------
nosy: +lukasz.langa

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

From googligerpete at gmail.com  Fri Mar 21 12:26:16 2014
From: googligerpete at gmail.com (Pete)
Date: Fri, 21 Mar 2014 12:26:16 +0100
Subject: [docs] array: magical number -0.0050385478258801655 --> ValueError:
 string length not a multiple of item size
Message-ID: <CAKNbEJScmTX5NX7Z-VmMuWvXipwgrZ-a=f+9bJ5C1gBXsR_uTw@mail.gmail.com>

Dear all,

Inspired by [0] I tried to write a binary file with the help of
array.tofile()
I wonder why my code is not working at re-importing the binary file,
handling a specific float:

<code>
from array import array

output_file = open('bug', 'wb')
float_array = array('d', [-0.0050385478258801655])#is not working
#float_array = array('d', [-0.0050385478258])#works
#float_array = array('d', [-0.012345678912345])#works, too
float_array.tofile(output_file)
output_file.close()


input_file = open('bug', 'r')
float_array = array('d')
float_array.fromstring(input_file.read())
input_file.close()
print float_array
</code>

The error is:
"ValueError: string length not a multiple of item size"

(Running Python(x,y) 2.7.2.1 on a Win7 64bit, code is executed within scite
IDE)

Best Regards,
Peter



[0]:
http://stackoverflow.com/questions/807863/how-to-output-list-of-floats-to-a-binary-file-in-python
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140321/404e09f9/attachment.html>

From report at bugs.python.org  Sat Mar 22 11:50:30 2014
From: report at bugs.python.org (Tshepang Lekhonkhobe)
Date: Sat, 22 Mar 2014 10:50:30 +0000
Subject: [docs] [issue20975] Python 3.4 build info wrong in code snippet
In-Reply-To: <1395179398.5.0.851425870515.issue20975@psf.upfronthosting.co.za>
Message-ID: <1395485430.42.0.570090560567.issue20975@psf.upfronthosting.co.za>


Changes by Tshepang Lekhonkhobe <tshepang at gmail.com>:


----------
nosy: +tshepang

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

From report at bugs.python.org  Sat Mar 22 11:55:23 2014
From: report at bugs.python.org (Graham Wideman)
Date: Sat, 22 Mar 2014 10:55:23 +0000
Subject: [docs] [issue20906] Issues in Unicode HOWTO
In-Reply-To: <1394702187.81.0.00522221343959.issue20906@psf.upfronthosting.co.za>
Message-ID: <1395485723.65.0.446839801521.issue20906@psf.upfronthosting.co.za>


Graham Wideman added the comment:

@Andre: 

_I_ know more or less the explanations behind all this. I am just putting it forward as an example which touches several concepts which are needed to explain it, and that a programmer might reason with to change a program (or the environment) to produce some output (instead of an exception), and possibly even the intended output.

For example, behind the brief explanation you provide, here are some of the related concepts:

1. print(s) sends output to stdout, which sends data to windows console (cmd.exe).

2. In the process, the output function that print --> stdout invokes attempts to encode s according to the encoding that the destination, cmd.exe reports that it expects.

3. On Windows (in English, or perhaps it's US locale), cmd.exe defaults to expecting encoding cp437.

4. cp437 is an encoding containing only 256 characters. Many Unicode code points obviously have no corresponding character in cp437.

5. The encoding process used by print() is set to exception on characters that have no mapping to the encoding wanted by stdout.

6. Consequently, print() throws an exception on code points outside of those representable in cp437.

Based on that, there are a number of moves the programmer might make, with varying results... possibly involving:

-- s.encode([various choices of options here]) --> s_as_bytes
-- print(s_as_bytes) (noting that 'Hello ' + s_as_bytes doesn't work)
-- Or maybe ascii(s)
-- Or possibly sys.stdout.buffer.write()

-- Pros and cons of the above, which require careful tracking of what the resulting strings or byte sequences "really mean" at each juncture.

-- cmd.exe chcp 65001 --> so print(unicode) won't exception, but still many chars will show as [?]
-- various font choices in cmd.exe which might be able to show the needed graphemes.
-- Automatic font substitution that occurs in some contexts when the selected font doesn't contain a requested code point and its grapheme.

... and probably more concepts that I've missed.

-- Graham

----------

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

From report at bugs.python.org  Sat Mar 22 12:07:00 2014
From: report at bugs.python.org (Tshepang Lekhonkhobe)
Date: Sat, 22 Mar 2014 11:07:00 +0000
Subject: [docs] [issue20961] Fix usages of the note directive in the
	documentation
In-Reply-To: <1395066655.93.0.683819910553.issue20961@psf.upfronthosting.co.za>
Message-ID: <1395486420.96.0.525868280221.issue20961@psf.upfronthosting.co.za>


Changes by Tshepang Lekhonkhobe <tshepang at gmail.com>:


----------
nosy: +tshepang

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

From report at bugs.python.org  Sat Mar 22 12:41:49 2014
From: report at bugs.python.org (Berker Peksag)
Date: Sat, 22 Mar 2014 11:41:49 +0000
Subject: [docs] [issue21014] `1` => `True`; for tutorial docs
In-Reply-To: <1395453556.85.0.399159850271.issue21014@psf.upfronthosting.co.za>
Message-ID: <1395488509.67.0.333323322316.issue21014@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/issue21014>
_______________________________________

From report at bugs.python.org  Sat Mar 22 13:22:20 2014
From: report at bugs.python.org (=?utf-8?q?Martin_v=2E_L=C3=B6wis?=)
Date: Sat, 22 Mar 2014 12:22:20 +0000
Subject: [docs] [issue20906] Issues in Unicode HOWTO
In-Reply-To: <1394702187.81.0.00522221343959.issue20906@psf.upfronthosting.co.za>
Message-ID: <1395490940.57.0.455094841821.issue20906@psf.upfronthosting.co.za>


Martin v. L?wis added the comment:

"4. Many Internet standards are defined in terms of textual data"

I believe the author was thinking of the "old" TCP-based protocols (ftp, smtp, RFC 822, HTTP), which have their commands/messages as ASCII-strings,  with a variable-length records (often terminated by line end).

I think bringing this up as an argument against UTF-32 somewhat flawed, for two reasons:
1. Historically, many of these protocols restricted themselves to pure ASCII, so using UTF-8 is as much a protocol violation as is using UTF-32.
2. The tricky part in this protocols is often not the risk of embedding NUL, but embedding CRLF (as 0D 0A might well appear in a character, a.g. MALAYALAM LETTER UU)

OTOH, it is a fact that several of these protocols got revised to support Unicode, and often re-interpreting the data as UTF-8 (with MIME being the notable exception that actually allows for UTF-32 on the wire if somebody choses to).

----------
nosy: +loewis

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

From report at bugs.python.org  Sat Mar 22 13:32:20 2014
From: report at bugs.python.org (=?utf-8?q?Martin_v=2E_L=C3=B6wis?=)
Date: Sat, 22 Mar 2014 12:32:20 +0000
Subject: [docs] [issue20975] Python 3.4 build info wrong in code snippet
In-Reply-To: <1395179398.5.0.851425870515.issue20975@psf.upfronthosting.co.za>
Message-ID: <1395491540.41.0.729707857863.issue20975@psf.upfronthosting.co.za>


Martin v. L?wis added the comment:

Bostjan: please understand that this is not possible. The build date is the date when Python interpreter was actually built. If I build Python on my Linux machine today, I get today's date. So there isn't any single one right "build date" - on Unix, people will typically see different strings.

FWIW, on my system, the prompt reads

Python 3.4.0 (v3.4.0:04f714765c13, Mar 22 2014, 13:30:59)
[GCC 4.7.2] on linux

----------
nosy: +loewis

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

From report at bugs.python.org  Sat Mar 22 13:37:32 2014
From: report at bugs.python.org (=?utf-8?q?Martin_v=2E_L=C3=B6wis?=)
Date: Sat, 22 Mar 2014 12:37:32 +0000
Subject: [docs] [issue20975] Python 3.4 build info wrong in code snippet
In-Reply-To: <1395179398.5.0.851425870515.issue20975@psf.upfronthosting.co.za>
Message-ID: <1395491852.25.0.0700007579975.issue20975@psf.upfronthosting.co.za>


Martin v. L?wis added the comment:

I don't mind changing the text now, but I observe that there is a chicken-and-egg problem with the hg changeset number. That changeset number is only set when the tag is made, which must happen after the documentation is updated (or else the updated documentation is not in the release). Hence, the documentation can't know what the changeset number will be for an about-to-released version of Python.

----------

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

From report at bugs.python.org  Sat Mar 22 13:38:39 2014
From: report at bugs.python.org (Geoffrey Spear)
Date: Sat, 22 Mar 2014 12:38:39 +0000
Subject: [docs] [issue20975] Python 3.4 build info wrong in code snippet
In-Reply-To: <1395179398.5.0.851425870515.issue20975@psf.upfronthosting.co.za>
Message-ID: <1395491919.75.0.954971405795.issue20975@psf.upfronthosting.co.za>


Geoffrey Spear added the comment:

There is no "correct" date and time Python 3.4 was built. I'm sure even the Windows binary installers weren't built simultaneously, and on Linux systems it will differ based on distro.

My Python 3.4 says it was built 5 minutes ago, because it was.

I suppose bumping to some date after 3.4 was released makes sense, but trying to get it to show the user exactly what they're going to see when they run Python is impossible.

----------
nosy: +geoffreyspear

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

From report at bugs.python.org  Sat Mar 22 15:49:54 2014
From: report at bugs.python.org (R. David Murray)
Date: Sat, 22 Mar 2014 14:49:54 +0000
Subject: [docs] [issue20906] Issues in Unicode HOWTO
In-Reply-To: <1394702187.81.0.00522221343959.issue20906@psf.upfronthosting.co.za>
Message-ID: <1395499794.92.0.907724651637.issue20906@psf.upfronthosting.co.za>


R. David Murray added the comment:

Although I agree that the Unicode Howto needs to provide enough information for someone to reason correctly about python3 unicode, I'd like to note that someone running into the encoding error on windows is *not* going to reach for the unicode howto to solve their problem.  Instead they will google the error message, and will find many helpful and unhelpful explanations and solutions.  But they currently won't find this document (at least not on the first page of results).

So, if you really want to help someone with this problem, you need to specifically include that error message in the text as example of a commonly encountered problem, and then give a directed solution.

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

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

From report at bugs.python.org  Sat Mar 22 16:07:23 2014
From: report at bugs.python.org (R. David Murray)
Date: Sat, 22 Mar 2014 15:07:23 +0000
Subject: [docs] [issue20906] Issues in Unicode HOWTO
In-Reply-To: <1394702187.81.0.00522221343959.issue20906@psf.upfronthosting.co.za>
Message-ID: <1395500843.68.0.575498686775.issue20906@psf.upfronthosting.co.za>


R. David Murray added the comment:

On the other hand, I wonder if such problem/solution pairs should go in the FAQ list rather than the howto, perhaps with a pointer to the howto for those wanting more general information.  Specifically the Python on Windows section in this case.

I realize that you were using it as an example to tease out the concepts needed to reason correctly about a problem, but I think approaching it from the point of view of how the user will reason about it is not optimal.  Instead, write the FAQ answer, and figure out what concepts you need to use to *explain* the problem, that you then feel the desire to further expand upon in the howto for those users who reach for a deeper understanding instead of just an immediate solution.

----------

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

From report at bugs.python.org  Sat Mar 22 20:23:18 2014
From: report at bugs.python.org (Graham Wideman)
Date: Sat, 22 Mar 2014 19:23:18 +0000
Subject: [docs] [issue20906] Issues in Unicode HOWTO
In-Reply-To: <1394702187.81.0.00522221343959.issue20906@psf.upfronthosting.co.za>
Message-ID: <1395516198.74.0.515886027697.issue20906@psf.upfronthosting.co.za>


Graham Wideman added the comment:

@R David:  I agree with you. Thanks for extending the line of thinking I outlined.

----------

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

From report at bugs.python.org  Sat Mar 22 20:36:54 2014
From: report at bugs.python.org (Georg Brandl)
Date: Sat, 22 Mar 2014 19:36:54 +0000
Subject: [docs] [issue20975] Python 3.4 build info wrong in code snippet
In-Reply-To: <1395179398.5.0.851425870515.issue20975@psf.upfronthosting.co.za>
Message-ID: <1395517014.76.0.684897847867.issue20975@psf.upfronthosting.co.za>


Georg Brandl added the comment:

I'd just make it the approximate release date of 3.4.  The version is adapted anyway as part of a new minor release, so the date can also be.

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

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

From report at bugs.python.org  Sat Mar 22 20:39:30 2014
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 22 Mar 2014 19:39:30 +0000
Subject: [docs] [issue20975] Python 3.4 build info wrong in code snippet
In-Reply-To: <1395179398.5.0.851425870515.issue20975@psf.upfronthosting.co.za>
Message-ID: <3frscf03Gfz7LjV@mail.python.org>


Roundup Robot added the comment:

New changeset 4476b7493ee4 by Georg Brandl in branch '3.4':
Closes #20975: make date in the interpreter banner a little more consistent
http://hg.python.org/cpython/rev/4476b7493ee4

----------
nosy: +python-dev
resolution:  -> fixed
stage:  -> committed/rejected
status: open -> closed

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

From kathleen at kweaver.org  Sun Mar 23 02:01:18 2014
From: kathleen at kweaver.org (kathleen at kweaver.org)
Date: Sun, 23 Mar 2014 01:01:18 -0000
Subject: [docs] Bring Doc/using/windows up to date (issue 20265)
Message-ID: <20140323010118.801.44903@psf.upfronthosting.co.za>


http://bugs.python.org/review/20265/diff/11340/Doc/faq/windows.rst
File Doc/faq/windows.rst (right):

http://bugs.python.org/review/20265/diff/11340/Doc/faq/windows.rst#newcode20
Doc/faq/windows.rst:20: The situation has been made somewhat simpler
since Python 3.3, which
On 2014/03/21 20:57:03, Zach Ware wrote:
> This would make more sense if the old first sentence were kept,
leading into the
> new one.

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/faq/windows.rst#newcode21
Doc/faq/windows.rst:21: introduced the launcher for windows.  Use is
discussed
On 2014/03/21 20:57:03, Zach Ware wrote:
> Windows should be capitalized.  It would also be simpler to make "the
laucher
> for Windows" into the link to the discussion of it.

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/faq/windows.rst#newcode40
Doc/faq/windows.rst:40: Unless you use some sort of integrated
development environment, you will end up
On 2014/03/21 20:57:03, Zach Ware wrote:
> Trailing whitespace.

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/faq/windows.rst#newcode46
Doc/faq/windows.rst:46: Command Prompt followed by (Admin)  You should
be able to recognize
On 2014/03/21 20:57:03, Zach Ware wrote:
> Missing period after (Admin).

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/faq/windows.rst#newcode75
Doc/faq/windows.rst:75: Python 3.3.0 (v3.3.0:bd8afb90ebf2, Sep 29 2012,
10:55:48) [MSC v.1600 32 bit (Intel)] on win32
On 2014/03/21 20:57:03, Zach Ware wrote:
> If it hasn't already been, every instance of "3.3" or "python33"
should be
> updated to 3.4 (or 3.5 if you're working from the default branch)

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/faq/windows.rst#newcode92
Doc/faq/windows.rst:92: Windows command prompt.
On 2014/03/21 20:57:03, Zach Ware wrote:
> This should be updated to mention the quit and exit functions.

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/faq/windows.rst#newcode350
Doc/faq/windows.rst:350: http://www.winzip.com.)
On 2014/03/21 20:57:03, Zach Ware wrote:
> No need for the change here, the file should always end with a blank
line.

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst
File Doc/using/windows.rst (right):

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode30
Doc/using/windows.rst:30: * Module Docs -Module Documentation
On 2014/03/21 20:57:03, Zach Ware wrote:
> Missing a space in "-Module" to match the others.  Also, this line
should be 
> between IDLE and Python (alphabetical order, to match the start menu
entries).

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode83
Doc/using/windows.rst:83: * Find the Python directory and double click
python
On 2014/03/21 20:57:03, Zach Ware wrote:
> These last two aren't really shortcuts.

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode86
Doc/using/windows.rst:86: Python through the launcher for windows.  Use
is discussed
On 2014/03/21 20:57:03, Zach Ware wrote:
> Windows should be capitalized.

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode92
Doc/using/windows.rst:92: Finding the Python executable
On 2014/03/21 20:57:03, Zach Ware wrote:
> This section should get the ".. _setting-envvars:" marker, since it is
the
> closest thing resembling the former section on environment variables.

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode100
Doc/using/windows.rst:100: in Windows 8, you must use the Command Prompt
(Admin).
Took it off, but for Python, I'm finding the "regular" Command Prompt
useless.

On 2014/03/21 20:57:03, Zach Ware wrote:
> I don't believe this added sentence is true.  If non-administrative
Command
> Prompt ignored PATH, it would be completely useless.  Either way, it
doesn't fit
> in this paragraph.

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode111
Doc/using/windows.rst:111: The alternative is manually modifying the
:envvar:`%PATH%`.  See the
On 2014/03/21 20:57:03, Zach Ware wrote:
> I would combine this with the previous paragraph; "If you don't enable
this
> option at install time you can always re-run the installer to choose
it, or
> manually change :envvar:`PATH` yourself."

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode165
Doc/using/windows.rst:165: 
On 2014/03/21 20:57:03, Zach Ware wrote:
> No need to remove the blank line here.

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode187
Doc/using/windows.rst:187: #. Launch a command prompt [Windows 8 -
Launch Command Prompt (Admin)]
On 2014/03/21 20:57:03, Zach Ware wrote:
> On 2014/03/18 02:27:06, kathweaver wrote:
> > Actually it is a new available option for Windows 8 users, so it
should be
> > there.  The average Windows 8 probably doesn't know there are two
choices, it
> > had me scratching my head for a while. 
> 
> The "Command Prompt (Admin)" option from right-clicking the start menu
button is
> just a shortcut for right clicking Command Prompt in the start menu
itself and
> choosing Run As Administrator, which is just as it was in Windows 7
and Vista. 
> We should be trying to be version agnostic anyway, so it's better to
either
> leave this as it was, or remove "(might require administrative
rights)" from the
> preceding paragraph and add "with administrative privileges" or
similar where
> your added note is.
> 
> It should be reasonably obvious that "Command Prompt (Admin)" is a
Command
> Prompt with administrative privileges.

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode545
Doc/using/windows.rst:545: There is `Python Tools for Visual Studio
<https://pytools.codeplex.com/>`_ an addon published
On 2014/03/21 20:57:03, Zach Ware wrote:
> "`Python Tools ...`_ is an add-on for Visual Studio published by
Microsoft that
> turns Visual Studio into a full-featured Python IDE.  It is not
compatible with
> Express editions of Visual Studio."

Done.

http://bugs.python.org/review/20265/diff/11340/Doc/using/windows.rst#newcode564
Doc/using/windows.rst:564: The proposal for the launcher to be included
in the Python distribution.
On 2014/03/21 20:57:03, Zach Ware wrote:
> No need for the changes at the end here; the file should always end
with a blank
> line.

Done.

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

From report at bugs.python.org  Sun Mar 23 02:02:24 2014
From: report at bugs.python.org (Kathleen Weaver)
Date: Sun, 23 Mar 2014 01:02:24 +0000
Subject: [docs] [issue20265] Bring Windows docs up to date
In-Reply-To: <1389757265.26.0.116885263001.issue20265@psf.upfronthosting.co.za>
Message-ID: <1395536544.27.0.772788459268.issue20265@psf.upfronthosting.co.za>


Kathleen Weaver added the comment:

New patch with corrections from review.

----------
Added file: http://bugs.python.org/file34574/windows.patch

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

From report at bugs.python.org  Sun Mar 23 02:10:31 2014
From: report at bugs.python.org (Mark Lawrence)
Date: Sun, 23 Mar 2014 01:10:31 +0000
Subject: [docs] [issue1581182] Definition of a "character" is wrong
Message-ID: <1395537031.12.0.231118680848.issue1581182@psf.upfronthosting.co.za>


Mark Lawrence added the comment:

Can this be tied in with the work being done on the unicode howto #20906?

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

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

From report at bugs.python.org  Sun Mar 23 09:48:40 2014
From: report at bugs.python.org (=?utf-8?q?Jurko_Gospodneti=C4=87?=)
Date: Sun, 23 Mar 2014 08:48:40 +0000
Subject: [docs] [issue21034] Python docs reference the Distribute package
	which has	been deprecated in favor of Setuptools
Message-ID: <1395564519.98.0.0028723182567.issue21034@psf.upfronthosting.co.za>


New submission from Jurko Gospodneti?:

In the Python documentation note:

  http://docs.python.org/3.4/library/venv.html#venv-def

the paragraph:

> Common installation tools such as Distribute and pip work
> as expected with venvs - i.e. when a venv is active, they
> install Python packages into the venv without needing to
> be told to do so explicitly. Of course, you need to
> install them into the venv first: this could be done by
> running distribute_setup.py with the venv activated,
> followed by running easy_install pip. Alternatively, you
> could download the source tarballs and run python setup.py
> install after unpacking, with the venv activated.

refers to the Distribute package and its specifics (how it
should be installed) but that package has been deprecated
in favor of the setuptools package. I suggest to change it
to something like:

> Common installation tools such as setuptools and pip work
> as expected with venvs - i.e. when a venv is active, they
> install Python packages into the venv without needing to
> be told to do so explicitly. Of course, you need to
> install them into the venv first: this could be done by
> running setuptools project's ez_setup.py with the venv
> activated, followed by running easy_install pip.
> Alternatively, you could download the source tarballs and
> run python setup.py install after unpacking, with the venv
> activated.

I'm attaching a patch based on the current tip in CPython's
development repository.

Hope this helps.

Best regards,
  Jurko Gospodneti?

----------
assignee: docs at python
components: Documentation
files: fix_Distribute_reference_in_venv_docs.patch
keywords: patch
messages: 214554
nosy: Jurko.Gospodneti?, docs at python
priority: normal
severity: normal
status: open
title: Python docs reference the Distribute package which has been deprecated in favor of Setuptools
versions: Python 3.4, Python 3.5
Added file: http://bugs.python.org/file34582/fix_Distribute_reference_in_venv_docs.patch

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

From report at bugs.python.org  Sun Mar 23 16:09:15 2014
From: report at bugs.python.org (Kathleen Weaver)
Date: Sun, 23 Mar 2014 15:09:15 +0000
Subject: [docs] [issue20265] Bring Windows docs up to date
In-Reply-To: <1389757265.26.0.116885263001.issue20265@psf.upfronthosting.co.za>
Message-ID: <1395587353.15.0.185584628388.issue20265@psf.upfronthosting.co.za>


Kathleen Weaver added the comment:

New patch

----------
Added file: http://bugs.python.org/file34587/windows.patch

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

From report at bugs.python.org  Sun Mar 23 17:36:38 2014
From: report at bugs.python.org (Raymond Hettinger)
Date: Sun, 23 Mar 2014 16:36:38 +0000
Subject: [docs] [issue21014] `1` => `True`; for tutorial docs
In-Reply-To: <1395453556.85.0.399159850271.issue21014@psf.upfronthosting.co.za>
Message-ID: <1395592597.94.0.0818949037698.issue21014@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

In Python 2.7, we're not changing all the "1" to "True" because that aren't quite the same (True is a global and not a builtin constant).

If you see these in 3.x, we should change them all :-)

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

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

From report at bugs.python.org  Sun Mar 23 22:51:24 2014
From: report at bugs.python.org (akira)
Date: Sun, 23 Mar 2014 21:51:24 +0000
Subject: [docs] [issue19940] ssl.cert_time_to_seconds() returns wrong
	results if	local timezone is not UTC
In-Reply-To: <1386660552.46.0.291263983729.issue19940@psf.upfronthosting.co.za>
Message-ID: <1395611484.52.0.861261043679.issue19940@psf.upfronthosting.co.za>


akira added the comment:

Antoine,  I haven't received the e-mail notification.

I've replied to the comments on Rietveld.

Here's the updated patch with the corresponding changes.

----------
Added file: http://bugs.python.org/file34594/ssl_cert_time_to_seconds-ps3.patch

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

From report at bugs.python.org  Mon Mar 24 00:50:30 2014
From: report at bugs.python.org (Alex Gaynor)
Date: Sun, 23 Mar 2014 23:50:30 +0000
Subject: [docs] [issue21043] Stop reccomending CACert.org in the SSL
	documentation
Message-ID: <1395618630.76.0.364791925712.issue21043@psf.upfronthosting.co.za>


New submission from Alex Gaynor:

CACert is not in the root trust store on *any* platform that I'm aware of, and has not passed any audits. See http://lwn.net/SubscriberLink/590879/ce23ed7bab68e489/ for more background.

In it's place I've added StartSSL, which is included in most (all?) root trust stores, and offers free certs.

----------
assignee: docs at python
components: Documentation
files: cacert.diff
keywords: patch
messages: 214656
nosy: alex, docs at python, dstufft
priority: normal
severity: normal
status: open
title: Stop reccomending CACert.org in the SSL documentation
type: enhancement
Added file: http://bugs.python.org/file34598/cacert.diff

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

From report at bugs.python.org  Mon Mar 24 00:51:18 2014
From: report at bugs.python.org (Donald Stufft)
Date: Sun, 23 Mar 2014 23:51:18 +0000
Subject: [docs] [issue21043] Stop reccomending CACert.org in the SSL
	documentation
In-Reply-To: <1395618630.76.0.364791925712.issue21043@psf.upfronthosting.co.za>
Message-ID: <1395618677.97.0.718346308439.issue21043@psf.upfronthosting.co.za>


Donald Stufft added the comment:

I completely agree, it seems less than good to recommend CACert.

----------

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

From report at bugs.python.org  Mon Mar 24 00:52:35 2014
From: report at bugs.python.org (Alex Gaynor)
Date: Sun, 23 Mar 2014 23:52:35 +0000
Subject: [docs] [issue21043] Stop reccomending CACert.org in the SSL
	documentation
In-Reply-To: <1395618630.76.0.364791925712.issue21043@psf.upfronthosting.co.za>
Message-ID: <1395618755.0.0.658032057722.issue21043@psf.upfronthosting.co.za>


Changes by Alex Gaynor <alex.gaynor at gmail.com>:


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

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

From report at bugs.python.org  Mon Mar 24 01:01:24 2014
From: report at bugs.python.org (Antoine Pitrou)
Date: Mon, 24 Mar 2014 00:01:24 +0000
Subject: [docs] [issue21043] Stop reccomending CACert.org in the SSL
	documentation
In-Reply-To: <1395618630.76.0.364791925712.issue21043@psf.upfronthosting.co.za>
Message-ID: <1395619284.03.0.182341454762.issue21043@psf.upfronthosting.co.za>


Antoine Pitrou added the comment:

That whole paragraph in the documentation is weird. Usually, you don't download select root certificates from various CAs, you just elect to trust a predetermined set of root certs (the system ones, usually).

I would suggest rewording it and dropping the various download URLs.

(and if the suggestion to provide the full chain is obsolete for SSLv3 and TLSv1, then similarly it may be dropped entirely - we needn't support SSLv2 specificities in the docs)

----------
nosy: +pitrou

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

From report at bugs.python.org  Mon Mar 24 01:02:48 2014
From: report at bugs.python.org (Donald Stufft)
Date: Mon, 24 Mar 2014 00:02:48 +0000
Subject: [docs] [issue21043] Stop reccomending CACert.org in the SSL
	documentation
In-Reply-To: <1395618630.76.0.364791925712.issue21043@psf.upfronthosting.co.za>
Message-ID: <1395619368.02.0.715830093012.issue21043@psf.upfronthosting.co.za>


Donald Stufft added the comment:

It's quite old (that paragraph) likely it was written that way because back then Python didn't have a way to load certificates.

----------

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

From report at bugs.python.org  Mon Mar 24 01:10:32 2014
From: report at bugs.python.org (Alex Gaynor)
Date: Mon, 24 Mar 2014 00:10:32 +0000
Subject: [docs] [issue21043] Stop reccomending CACert.org in the SSL
	documentation
In-Reply-To: <1395618630.76.0.364791925712.issue21043@psf.upfronthosting.co.za>
Message-ID: <1395619832.72.0.533382805439.issue21043@psf.upfronthosting.co.za>


Alex Gaynor added the comment:

I've attempted to modernize the paragraph.

----------
Added file: http://bugs.python.org/file34599/cacert.diff

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

From report at bugs.python.org  Mon Mar 24 01:10:54 2014
From: report at bugs.python.org (Alex Gaynor)
Date: Mon, 24 Mar 2014 00:10:54 +0000
Subject: [docs] [issue21043] Stop reccomending CACert.org in the SSL
	documentation
In-Reply-To: <1395618630.76.0.364791925712.issue21043@psf.upfronthosting.co.za>
Message-ID: <1395619854.54.0.359109773573.issue21043@psf.upfronthosting.co.za>


Alex Gaynor added the comment:

Removed 2.7 since there's no API for getting the platform certs.

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

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

From report at bugs.python.org  Mon Mar 24 01:11:24 2014
From: report at bugs.python.org (Alex Gaynor)
Date: Mon, 24 Mar 2014 00:11:24 +0000
Subject: [docs] [issue21043] Stop reccomending CACert.org in the SSL
	documentation
In-Reply-To: <1395618630.76.0.364791925712.issue21043@psf.upfronthosting.co.za>
Message-ID: <1395619884.55.0.850623174756.issue21043@psf.upfronthosting.co.za>


Changes by Alex Gaynor <alex.gaynor at gmail.com>:


Added file: http://bugs.python.org/file34600/cacert.diff

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

From report at bugs.python.org  Mon Mar 24 01:23:54 2014
From: report at bugs.python.org (Mark Lawrence)
Date: Mon, 24 Mar 2014 00:23:54 +0000
Subject: [docs] [issue21043] Stop recommending CACert.org in the SSL
	documentation
In-Reply-To: <1395618630.76.0.364791925712.issue21043@psf.upfronthosting.co.za>
Message-ID: <1395620634.48.0.256304092144.issue21043@psf.upfronthosting.co.za>


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


----------
title: Stop reccomending CACert.org in the SSL documentation -> Stop recommending CACert.org in the SSL documentation

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

From report at bugs.python.org  Mon Mar 24 02:58:44 2014
From: report at bugs.python.org (Jorge Araya Navarro)
Date: Mon, 24 Mar 2014 01:58:44 +0000
Subject: [docs] [issue21045] fix layout to generate documentation for Qt
	Assistant
Message-ID: <1395626324.01.0.108694815155.issue21045@psf.upfronthosting.co.za>


New submission from Jorge Araya Navarro:

Python use sphinx to generate its documentation, sphinx can generate documentation for Qt Assistant using the qthelp builder (and `qcollectiongenerator build/qthelp/Python.qhcp`). The thing is that using the default layout or static css files, the final results look very bad, and changing its theme doesn't help either.

----------
assignee: docs at python
components: Documentation
files: V6cXI.png
messages: 214664
nosy: docs at python, shackra
priority: normal
severity: normal
status: open
title: fix layout to generate documentation for Qt Assistant
versions: Python 2.7, Python 3.1, Python 3.2, Python 3.3, Python 3.4, Python 3.5
Added file: http://bugs.python.org/file34601/V6cXI.png

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

From cappy2112 at gmail.com  Sat Mar 22 20:02:20 2014
From: cappy2112 at gmail.com (Tony Cappellini)
Date: Sat, 22 Mar 2014 12:02:20 -0700
Subject: [docs] Ambiguity in 2.7.6 docs for multiprocessing documentation
Message-ID: <CABRXM4k2T__jNMuukOpGqu_d-D=vWzB9y2X9Z9boXSB1QmiD9g@mail.gmail.com>

Hello,

regarding the daemon flag in the multiprocessing manual

http://docs.python.org/2/library/multiprocessing.html#windows

The existing documentation is ambiguous as to the purpose of the daemon flag

"
daemon

The process's daemon flag, a Boolean value. This must be set before
start()<http://docs.python.org/2/library/multiprocessing.html#multiprocessing.Process.start>is
called.

The initial value is inherited from the creating process.

When a process exits, it attempts to terminate all of its daemonic child
processes."


How does the behavior of the process change when this flag is set to True?

How does the behavior of the process change when this flag is set to False?


I see no difference when setting this flag, and I'm starting to think
something is broken in the multiprocessing module- on Windows.

However, without clear documentation as to the flag's purpose an behavior
when the flag is changed, it's hard to know what to expect.


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

From martin at v.loewis.de  Sun Mar 23 11:36:40 2014
From: martin at v.loewis.de (martin at v.loewis.de)
Date: Sun, 23 Mar 2014 10:36:40 -0000
Subject: [docs] Bring Doc/using/windows up to date (issue 20265)
Message-ID: <20140323103640.17107.66887@psf.upfronthosting.co.za>


http://bugs.python.org/review/20265/diff/11405/Doc/using/windows.rst
File Doc/using/windows.rst (right):

http://bugs.python.org/review/20265/diff/11405/Doc/using/windows.rst#newcode104
Doc/using/windows.rst:104: Python 3.4, the installer has an option to
set that up for you.
It's actually available since 3.3.

http://bugs.python.org/review/20265/diff/11405/Doc/using/windows.rst#newcode106
Doc/using/windows.rst:106: At the "Customize Python 3.3" screen, an
option called
If you want to update the version number, this would be the place.

http://bugs.python.org/review/20265/diff/11405/Doc/using/windows.rst#newcode175
Doc/using/windows.rst:175: Executing scripts without the Python launcher
Why do we need this section? It's not possibly anymore to not install
the Python launcher. The use case of binding .py to the no-console
executable might be useful, but then the executable is pyw.exe, not
pythonw.exe.

There *could* be a use case of binding .py to a specific version,
however, I'd rather suggest to use launcher syntax in the script (e.g.
#!python3.3) to achieve that.

http://bugs.python.org/review/20265/diff/11405/Doc/using/windows.rst#newcode193
Doc/using/windows.rst:193: assoc .py=Python.File
Hmm. In the standard installation, .py is already associated with
Python.File, so this step is unnecessary. If the objective is to
associate .py with pythonw.exe, I'd rather do

assoc .py=Python.NoConFile

and not change the Open path for Python.File at all. But maybe I'm
missing something.

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

From cocoatomo77 at gmail.com  Sun Mar 23 13:10:53 2014
From: cocoatomo77 at gmail.com (tomo cocoa)
Date: Sun, 23 Mar 2014 21:10:53 +0900
Subject: [docs] an unmatched parenthesis
Message-ID: <CAN_7T0LX7zzuqjd5JokyeGWdmPry5T15d63ASJ=wshegAS+zPQ@mail.gmail.com>

Hello

I am a Japanese translator for Python documents.


A document about distutils, "Creating a Source Distribution", contains an
unmatched parenthesis.
The second element of the list in the section "4.1. Specifying the files to
distribute" ends with a opening parenthesis, which seems not to have a
corresponding closing parenthesis.

http://docs.python.org/3.5/distutils/sourcedist.html#specifying-the-files-to-distribute

Thanks,

cocoatomo

-- 
class Cocoatomo:
    name = 'cocoatomo'
    email_address = 'cocoatomo77 at gmail.com'
    twitter_id = '@cocoatomo'
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140323/2a94c941/attachment.html>

From kathleen at kweaver.org  Sun Mar 23 16:08:39 2014
From: kathleen at kweaver.org (kathleen at kweaver.org)
Date: Sun, 23 Mar 2014 15:08:39 -0000
Subject: [docs] Bring Doc/using/windows up to date (issue 20265)
Message-ID: <20140323150839.23968.46375@psf.upfronthosting.co.za>

I've fixed the minor changes, but am going to wait on the major ones
(removing parts of the documentation), until others have agreed.


http://bugs.python.org/review/20265/diff/11405/Doc/using/windows.rst
File Doc/using/windows.rst (right):

http://bugs.python.org/review/20265/diff/11405/Doc/using/windows.rst#newcode104
Doc/using/windows.rst:104: Python 3.4, the installer has an option to
set that up for you.
On 2014/03/23 11:36:40, loewis wrote:
> It's actually available since 3.3.

Done.

http://bugs.python.org/review/20265/diff/11405/Doc/using/windows.rst#newcode106
Doc/using/windows.rst:106: At the "Customize Python 3.3" screen, an
option called
On 2014/03/23 11:36:40, loewis wrote:
> If you want to update the version number, this would be the place.

Done.

http://bugs.python.org/review/20265/diff/11405/Doc/using/windows.rst#newcode175
Doc/using/windows.rst:175: Executing scripts without the Python launcher
What do we want to do on this?
 
On 2014/03/23 11:36:40, loewis wrote:
> Why do we need this section? It's not possibly anymore to not install
the Python
> launcher. The use case of binding .py to the no-console executable
might be
> useful, but then the executable is pyw.exe, not pythonw.exe.
> 
> There *could* be a use case of binding .py to a specific version,
however, I'd
> rather suggest to use launcher syntax in the script (e.g. #!python3.3)
to
> achieve that.

http://bugs.python.org/review/20265/diff/11405/Doc/using/windows.rst#newcode193
Doc/using/windows.rst:193: assoc .py=Python.File
Again, consensus?

On 2014/03/23 11:36:40, loewis wrote:
> Hmm. In the standard installation, .py is already associated with
Python.File,
> so this step is unnecessary. If the objective is to associate .py with
> pythonw.exe, I'd rather do
> 
> assoc .py=Python.NoConFile
> 
> and not change the Open path for Python.File at all. But maybe I'm
missing
> something.

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

From 4kir4.1i at gmail.com  Sun Mar 23 22:53:27 2014
From: 4kir4.1i at gmail.com (4kir4.1i at gmail.com)
Date: Sun, 23 Mar 2014 21:53:27 -0000
Subject: [docs] ssl.cert_time_to_seconds() returns wrong results if
 local timezone is not UTC (issue 19940)
Message-ID: <20140323215327.17155.51319@psf.upfronthosting.co.za>

Reviewers: AntoinePitrou,

Message:
Thank you for the review. Sorry for the delay. I have not received
e-mail notification.

I've updated the patch.


http://bugs.python.org/review/19940/diff/11142/Doc/library/ssl.rst
File Doc/library/ssl.rst (right):

http://bugs.python.org/review/19940/diff/11142/Doc/library/ssl.rst#newcode379
Doc/library/ssl.rst:379: "notBefore" or "notAfter" dates must use GMT
(:rfc:`3280`).
On 2014/02/27 20:44:43, AntoinePitrou wrote:
> It seems RFC 3280 was superseded by RFC 5280?

Yes. I've updated the rfc number

http://bugs.python.org/review/19940/diff/11142/Lib/test/test_ssl.py
File Lib/test/test_ssl.py (right):

http://bugs.python.org/review/19940/diff/11142/Lib/test/test_ssl.py#newcode654
Lib/test/test_ssl.py:654: class UtilityTests(unittest.TestCase):
On 2014/02/27 20:44:43, AntoinePitrou wrote:
> The tests can go in BasicSocketTests, which already has many tests for
> module-level utilities.

I've moved the tests back to BasicSocketTests

http://bugs.python.org/review/19940/diff/11142/Lib/test/test_ssl.py#newcode656
Lib/test/test_ssl.py:656: def good(self, timestring, timestamp):
On 2014/02/27 20:44:43, AntoinePitrou wrote:
> As a matter of naming, I would prefer something more explicit than
"good".
> "cert_time_ok" perhaps?

I've renamed the method

http://bugs.python.org/review/19940/diff/11142/Lib/test/test_ssl.py#newcode659
Lib/test/test_ssl.py:659: def bad(self, timestring):
On 2014/02/27 20:44:43, AntoinePitrou wrote:
> Same here.

I've renamed it to `cert_time_fail()`

http://bugs.python.org/review/19940/diff/11142/Lib/test/test_ssl.py#newcode663
Lib/test/test_ssl.py:663: @unittest.skipUnless(utc_offset(),
On 2014/02/27 20:44:43, AntoinePitrou wrote:
> I don't understand the skip. The test will work even if the local time
is UTC.
> (be assured that most computers running the tests, even our buildbots,
won't be
> set on an UTC timezone anyway)

The skip is a remainder that the bug is triggered iff utc offset is
non-zero. Otherwise it can be removed completely.

http://bugs.python.org/review/19940/diff/11142/Lib/test/test_ssl.py#newcode705
Lib/test/test_ssl.py:705: locale.setlocale(locale.LC_TIME, 'pl_PL.utf8')
On 2014/02/27 20:44:43, AntoinePitrou wrote:
> To maximize chances that the test is run, you could simply set the
locale to
> locale.getdefaultlocale().
> Below, you can use the result of `time.strftime('%b %d %H:%M:%S %Y
GMT')`
> instead of the hardcoded Polish time string.

`pl_PL` was used to make sure that `local_february_name()` is not
`'Feb'`. Otherwise the second skip is triggered. 

I've changed the code to use `LC_ALL, ''`



Please review this at http://bugs.python.org/review/19940/

Affected files:
  Doc/library/ssl.rst
  Lib/ssl.py
  Lib/test/test_ssl.py



From aaa5500 at ya.ru  Sun Mar 23 23:55:43 2014
From: aaa5500 at ya.ru (Alex)
Date: Mon, 24 Mar 2014 02:55:43 +0400
Subject: [docs] Statistics doc
Message-ID: <1936341395615343@web27h.yandex.ru>

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

From zachary.ware+pydocs at gmail.com  Mon Mar 24 04:11:51 2014
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Sun, 23 Mar 2014 22:11:51 -0500
Subject: [docs] Statistics doc
In-Reply-To: <1936341395615343@web27h.yandex.ru>
References: <1936341395615343@web27h.yandex.ru>
Message-ID: <CAKJDb-MFkAwxM_SZXvhX-hpaAZrRMt5-meExk+CevPog7o_Ktg@mail.gmail.com>

On Sun, Mar 23, 2014 at 5:55 PM, Alex <aaa5500 at ya.ru> wrote:
> http://docs.python.org/dev/library/statistics.html
>
> I know math. I ended the institute. But in Russia. Doc doesn't show me WHAT
> FORMULAS are used for mean, median, median_low , etc. I canot understand
> doc. Please write formulas:
>
> e.g. mean = sum(x[i] from i=1 to N) / N

Thank you for your message, Alex.  I have opened issue #21046
(http://bugs.python.org/issue21046) to track this issue.

-- 
Zach

From zachary.ware+pydocs at gmail.com  Mon Mar 24 04:23:06 2014
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Sun, 23 Mar 2014 22:23:06 -0500
Subject: [docs] an unmatched parenthesis
In-Reply-To: <CAN_7T0LX7zzuqjd5JokyeGWdmPry5T15d63ASJ=wshegAS+zPQ@mail.gmail.com>
References: <CAN_7T0LX7zzuqjd5JokyeGWdmPry5T15d63ASJ=wshegAS+zPQ@mail.gmail.com>
Message-ID: <CAKJDb-PBJgVbmxQGp9P2jnBdMTv36VCBYck_OmLjNaBPD_eNdQ@mail.gmail.com>

On Sun, Mar 23, 2014 at 7:10 AM, tomo cocoa <cocoatomo77 at gmail.com> wrote:
> Hello
>
> I am a Japanese translator for Python documents.
>
>
> A document about distutils, "Creating a Source Distribution", contains an
> unmatched parenthesis.
> The second element of the list in the section "4.1. Specifying the files to
> distribute" ends with a opening parenthesis, which seems not to have a
> corresponding closing parenthesis.
>
> http://docs.python.org/3.5/distutils/sourcedist.html#specifying-the-files-to-distribute

Fixed in aba42f4f19f4, thanks for the report!

-- 
Zach

From report at bugs.python.org  Mon Mar 24 15:41:16 2014
From: report at bugs.python.org (M. Volz)
Date: Mon, 24 Mar 2014 14:41:16 +0000
Subject: [docs] [issue20135] FAQ need list mutation answers
In-Reply-To: <1388979444.45.0.0357103143169.issue20135@psf.upfronthosting.co.za>
Message-ID: <1395672075.91.0.518289751941.issue20135@psf.upfronthosting.co.za>


M. Volz added the comment:

Thanks David,

I've updated the patch to move the default values question into the programming FAQ where you recommended it go, and also changed the title of the mutable list question.

----------
Added file: http://bugs.python.org/file34604/sortFAQ_defaultval.patch

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

From report at bugs.python.org  Mon Mar 24 17:49:27 2014
From: report at bugs.python.org (Donald Stufft)
Date: Mon, 24 Mar 2014 16:49:27 +0000
Subject: [docs] [issue21043] Stop recommending CACert.org in the SSL
	documentation
In-Reply-To: <1395618630.76.0.364791925712.issue21043@psf.upfronthosting.co.za>
Message-ID: <1395679767.45.0.62289240791.issue21043@psf.upfronthosting.co.za>


Donald Stufft added the comment:

The latest patch looks good to me.

----------

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

From report at bugs.python.org  Mon Mar 24 18:01:44 2014
From: report at bugs.python.org (Antoine Pitrou)
Date: Mon, 24 Mar 2014 17:01:44 +0000
Subject: [docs] [issue21043] Stop recommending CACert.org in the SSL
	documentation
In-Reply-To: <1395618630.76.0.364791925712.issue21043@psf.upfronthosting.co.za>
Message-ID: <1395680503.94.0.84148362837.issue21043@psf.upfronthosting.co.za>


Antoine Pitrou added the comment:

Looks good to me too.

----------

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

From report at bugs.python.org  Mon Mar 24 19:57:05 2014
From: report at bugs.python.org (hans.meine)
Date: Mon, 24 Mar 2014 18:57:05 +0000
Subject: [docs] [issue11481] The copy module already uses copyreg
In-Reply-To: <1300009670.98.0.0546201477777.issue11481@psf.upfronthosting.co.za>
Message-ID: <1395687424.86.0.830967347563.issue11481@psf.upfronthosting.co.za>


hans.meine added the comment:

Maybe some 2.7 backport is missing w.r.t. the documentation of the copy module?  At least, http://docs.python.org/2/library/copy.html still states: "The copy module does not use the copy_reg registration module."

----------
nosy: +hans-meine
versions:  -Python 3.2, Python 3.3

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

From report at bugs.python.org  Mon Mar 24 21:57:21 2014
From: report at bugs.python.org (Chris Rebert)
Date: Mon, 24 Mar 2014 20:57:21 +0000
Subject: [docs] [issue19871] json module won't parse a float that starts
	with a	decimal point
In-Reply-To: <1386058873.01.0.290791588539.issue19871@psf.upfronthosting.co.za>
Message-ID: <1395694641.54.0.664543678307.issue19871@psf.upfronthosting.co.za>


Changes by Chris Rebert <pybugs at rebertia.com>:


----------
nosy: +cvrebert

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

From report at bugs.python.org  Tue Mar 25 00:27:08 2014
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 24 Mar 2014 23:27:08 +0000
Subject: [docs] [issue21043] Stop recommending CACert.org in the SSL
	documentation
In-Reply-To: <1395618630.76.0.364791925712.issue21043@psf.upfronthosting.co.za>
Message-ID: <3ftBZM5HMzzSRT@mail.python.org>


Roundup Robot added the comment:

New changeset 6f776c91da08 by Donald Stufft in branch '3.4':
Issue #21043: Remove the recommendation for specific CA organizations
http://hg.python.org/cpython/rev/6f776c91da08

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

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

From report at bugs.python.org  Tue Mar 25 00:28:27 2014
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 24 Mar 2014 23:28:27 +0000
Subject: [docs] [issue21043] Stop recommending CACert.org in the SSL
	documentation
In-Reply-To: <1395618630.76.0.364791925712.issue21043@psf.upfronthosting.co.za>
Message-ID: <3ftBbq67klzSRT@mail.python.org>


Roundup Robot added the comment:

New changeset 0485552b487e by Donald Stufft in branch 'default':
Merge in 3.4 to bring forward the Issue #21043 changes.
http://hg.python.org/cpython/rev/0485552b487e

----------

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

From report at bugs.python.org  Tue Mar 25 00:29:29 2014
From: report at bugs.python.org (Donald Stufft)
Date: Mon, 24 Mar 2014 23:29:29 +0000
Subject: [docs] [issue21043] Stop recommending CACert.org in the SSL
	documentation
In-Reply-To: <1395618630.76.0.364791925712.issue21043@psf.upfronthosting.co.za>
Message-ID: <1395703769.83.0.845955799214.issue21043@psf.upfronthosting.co.za>


Changes by Donald Stufft <donald at stufft.io>:


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

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

From report at bugs.python.org  Tue Mar 25 00:49:56 2014
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 24 Mar 2014 23:49:56 +0000
Subject: [docs] [issue21043] Stop recommending CACert.org in the SSL
	documentation
In-Reply-To: <1395618630.76.0.364791925712.issue21043@psf.upfronthosting.co.za>
Message-ID: <3ftC4g73m0z7LjM@mail.python.org>


Roundup Robot added the comment:

New changeset 7ef262eafecd by Donald Stufft in branch '2.7':
Issue #21043 - Remove CACert.org from the recommendations
http://hg.python.org/cpython/rev/7ef262eafecd

----------

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

From report at bugs.python.org  Tue Mar 25 05:11:43 2014
From: report at bugs.python.org (NRGunby)
Date: Tue, 25 Mar 2014 04:11:43 +0000
Subject: [docs] [issue21056] csv documentation is incorrect
Message-ID: <1395720703.0.0.19592596057.issue21056@psf.upfronthosting.co.za>


New submission from NRGunby:

The documentation for the csv reader objects next() method is incorrect. It states '
csvreader.next()

Return the next row of the reader?s iterable object as a list, parsed according to the current dialect.'

Either the documentation for DictReader objects needs to be be made separate from normal reader objects, or this needs to be amended to say '
csvreader.next()

Return the next row of the reader?s iterable object as a list (if reader) or dict (if DictReader), parsed according to the current dialect.
'
 
I observed this in the 2.7 online docs, found it to be the case in the 3.4 online docs as well, and haven't checked other versions but assume it's the case.

----------
assignee: docs at python
components: Documentation
messages: 214775
nosy: NRGunby, docs at python
priority: normal
severity: normal
status: open
title: csv documentation is incorrect
type: behavior
versions: Python 2.7, Python 3.4

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

From report at bugs.python.org  Tue Mar 25 09:16:52 2014
From: report at bugs.python.org (priya)
Date: Tue, 25 Mar 2014 08:16:52 +0000
Subject: [docs] [issue18456] Documentation for PyDict_Update is incorrect
In-Reply-To: <1373854272.6.0.0142348360978.issue18456@psf.upfronthosting.co.za>
Message-ID: <1395735412.71.0.882165555545.issue18456@psf.upfronthosting.co.za>


Changes by priya <priyapappachan010 at gmail.com>:


----------
keywords: +patch
Added file: http://bugs.python.org/file34610/PyDict_Update.patch

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

From report at bugs.python.org  Tue Mar 25 09:35:13 2014
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 25 Mar 2014 08:35:13 +0000
Subject: [docs] [issue18456] Documentation for PyDict_Update is incorrect
In-Reply-To: <1373854272.6.0.0142348360978.issue18456@psf.upfronthosting.co.za>
Message-ID: <3ftQkm3W2Gz7LjY@mail.python.org>


Roundup Robot added the comment:

New changeset 8e1637e3a099 by Georg Brandl in branch '3.4':
Closes #18456: Doc fix: PyDict_Update only works with dict-like objects, not key-value sequences. Patch by priyapappachan.
http://hg.python.org/cpython/rev/8e1637e3a099

----------
nosy: +python-dev
resolution:  -> fixed
stage: needs patch -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Tue Mar 25 09:35:35 2014
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 25 Mar 2014 08:35:35 +0000
Subject: [docs] [issue18456] Documentation for PyDict_Update is incorrect
In-Reply-To: <1373854272.6.0.0142348360978.issue18456@psf.upfronthosting.co.za>
Message-ID: <3ftQlC13Lkz7Lk0@mail.python.org>


Roundup Robot added the comment:

New changeset 2e51845a99e2 by Georg Brandl in branch '2.7':
Closes #18456: Doc fix: PyDict_Update only works with dict-like objects, not key-value sequences. Patch by priyapappachan.
http://hg.python.org/cpython/rev/2e51845a99e2

----------

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

From report at bugs.python.org  Tue Mar 25 09:40:49 2014
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 25 Mar 2014 08:40:49 +0000
Subject: [docs] [issue21006] asyncio.docs : create_subprocess_exec example
	does not	work on windows
In-Reply-To: <1395399242.2.0.683863961681.issue21006@psf.upfronthosting.co.za>
Message-ID: <3ftQsD4Ty9z7Ljc@mail.python.org>


Roundup Robot added the comment:

New changeset dd2c7cca5980 by Victor Stinner in branch '3.4':
Issue #21006: asyncio doc: reorganize subprocess doc
http://hg.python.org/cpython/rev/dd2c7cca5980

New changeset c45b124e9af4 by Victor Stinner in branch 'default':
(Merge 3.4) Issue #21006: asyncio doc: reorganize subprocess doc
http://hg.python.org/cpython/rev/c45b124e9af4

----------

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

From report at bugs.python.org  Tue Mar 25 09:41:17 2014
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 25 Mar 2014 08:41:17 +0000
Subject: [docs] [issue21006] asyncio.docs : create_subprocess_exec example
	does not	work on windows
In-Reply-To: <1395399242.2.0.683863961681.issue21006@psf.upfronthosting.co.za>
Message-ID: <1395736877.14.0.747870850061.issue21006@psf.upfronthosting.co.za>


STINNER Victor added the comment:

I reorganized the doc. Thanks for the report.

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

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

From report at bugs.python.org  Tue Mar 25 10:13:10 2014
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 25 Mar 2014 09:13:10 +0000
Subject: [docs] [issue21045] fix layout to generate documentation for Qt
	Assistant
In-Reply-To: <1395626324.01.0.108694815155.issue21045@psf.upfronthosting.co.za>
Message-ID: <3ftRZY563Yz7LjM@mail.python.org>


Roundup Robot added the comment:

New changeset d6831d94dd1e by Georg Brandl in branch '2.7':
Closes #21045: make the Qt help build not look completely stupid
http://hg.python.org/cpython/rev/d6831d94dd1e

----------
nosy: +python-dev
resolution:  -> fixed
stage:  -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Tue Mar 25 10:13:56 2014
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 25 Mar 2014 09:13:56 +0000
Subject: [docs] [issue21045] fix layout to generate documentation for Qt
	Assistant
In-Reply-To: <1395626324.01.0.108694815155.issue21045@psf.upfronthosting.co.za>
Message-ID: <3ftRbR4HZMz7LjM@mail.python.org>


Roundup Robot added the comment:

New changeset 2a6c33592e40 by Georg Brandl in branch '3.4':
Closes #21045: make the Qt help build not look completely stupid
http://hg.python.org/cpython/rev/2a6c33592e40

----------

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

From report at bugs.python.org  Tue Mar 25 10:36:06 2014
From: report at bugs.python.org (Timothy Pederick)
Date: Tue, 25 Mar 2014 09:36:06 +0000
Subject: [docs] [issue21061] Is contextlib.redirect_stdout reentrant or not?
Message-ID: <1395740166.01.0.738234296915.issue21061@psf.upfronthosting.co.za>


New submission from Timothy Pederick:

The docs are contradictory on whether or not contextlib.redirect_stdout is reentrant, or reusable-but-not-reentrant. This would seem to be an oversight from issue19403, which probably should have changed "reusable but not reentrant" to "reentrant".

Present in both current and upcoming docs:
  http://docs.python.org/3/library/contextlib.html
  http://docs.python.org/3.5/library/contextlib.html

contextlib.redirect_stdout(new_target)
  ...
  This context manager is reusable but not reentrant.

29.6.3.1. Reentrant context managers
  ...
  threading.RLock is an example of a reentrant context manager, as are suppress() and redirect_stdout().
  ...
  Note also that being reentrant is not the same thing as being thread safe. redirect_stdout(), for example...

----------
assignee: docs at python
components: Documentation
messages: 214801
nosy: docs at python, perey
priority: normal
severity: normal
status: open
title: Is contextlib.redirect_stdout reentrant or not?
versions: Python 3.4, Python 3.5

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

From report at bugs.python.org  Tue Mar 25 11:21:04 2014
From: report at bugs.python.org (Berker Peksag)
Date: Tue, 25 Mar 2014 10:21:04 +0000
Subject: [docs] [issue21061] Is contextlib.redirect_stdout reentrant or not?
In-Reply-To: <1395740166.01.0.738234296915.issue21061@psf.upfronthosting.co.za>
Message-ID: <1395742864.85.0.405895724765.issue21061@psf.upfronthosting.co.za>


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


----------
nosy: +ncoghlan

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

From report at bugs.python.org  Tue Mar 25 11:33:37 2014
From: report at bugs.python.org (Stefan Behnel)
Date: Tue, 25 Mar 2014 10:33:37 +0000
Subject: [docs] [issue20375] ElementTree: Document handling processing
	instructions
In-Reply-To: <1390539216.23.0.0362813865609.issue20375@psf.upfronthosting.co.za>
Message-ID: <1395743617.24.0.367791194863.issue20375@psf.upfronthosting.co.za>


Stefan Behnel added the comment:

I think you attached the wrong file.

----------

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

From report at bugs.python.org  Tue Mar 25 11:34:03 2014
From: report at bugs.python.org (Nick Coghlan)
Date: Tue, 25 Mar 2014 10:34:03 +0000
Subject: [docs] [issue21061] Is contextlib.redirect_stdout reentrant or not?
In-Reply-To: <1395740166.01.0.738234296915.issue21061@psf.upfronthosting.co.za>
Message-ID: <1395743643.15.0.261253365301.issue21061@psf.upfronthosting.co.za>


Nick Coghlan added the comment:

Indeed, it is actually reentrant now - the part that claims it isn't needs to be tweaked appropriately.

----------

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

From report at bugs.python.org  Tue Mar 25 12:35:38 2014
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 25 Mar 2014 11:35:38 +0000
Subject: [docs] [issue12209] Minor edits to faulthandler doc
In-Reply-To: <1306690203.86.0.276499968085.issue12209@psf.upfronthosting.co.za>
Message-ID: <3ftVkx5BBPz7LjS@mail.python.org>


Roundup Robot added the comment:

New changeset a97dcdee35f9 by Victor Stinner in branch '3.4':
Issue #12209: Minor edits to faulthandler doc. Patch written by ?ric Araujo.
http://hg.python.org/cpython/rev/a97dcdee35f9

New changeset 6f80ca0012ae by Victor Stinner in branch 'default':
(Merge 3.4) Issue #12209: Minor edits to faulthandler doc. Patch written by
http://hg.python.org/cpython/rev/6f80ca0012ae

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

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

From report at bugs.python.org  Tue Mar 25 12:36:24 2014
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 25 Mar 2014 11:36:24 +0000
Subject: [docs] [issue12209] Minor edits to faulthandler doc
In-Reply-To: <1306690203.86.0.276499968085.issue12209@psf.upfronthosting.co.za>
Message-ID: <1395747384.64.0.964032920885.issue12209@psf.upfronthosting.co.za>


STINNER Victor added the comment:

Sorry for the delay. I applied your patch.

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

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

From report at bugs.python.org  Tue Mar 25 12:55:02 2014
From: report at bugs.python.org (priya)
Date: Tue, 25 Mar 2014 11:55:02 +0000
Subject: [docs] [issue20100] epoll docs are not clear with regards to
	CLOEXEC.
In-Reply-To: <1388505494.08.0.643576998185.issue20100@psf.upfronthosting.co.za>
Message-ID: <1395748502.3.0.553385625857.issue20100@psf.upfronthosting.co.za>


Changes by priya <priyapappachan010 at gmail.com>:


----------
keywords: +patch
Added file: http://bugs.python.org/file34611/epoll.patch

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

From report at bugs.python.org  Tue Mar 25 15:03:43 2014
From: report at bugs.python.org (priya)
Date: Tue, 25 Mar 2014 14:03:43 +0000
Subject: [docs] [issue20100] epoll docs are not clear with regards to
	CLOEXEC.
In-Reply-To: <1388505494.08.0.643576998185.issue20100@psf.upfronthosting.co.za>
Message-ID: <1395756223.9.0.715612866863.issue20100@psf.upfronthosting.co.za>


Changes by priya <priyapappachan010 at gmail.com>:


Added file: http://bugs.python.org/file34616/epoll.patch

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

From report at bugs.python.org  Tue Mar 25 15:44:08 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Tue, 25 Mar 2014 14:44:08 +0000
Subject: [docs] [issue12209] Minor edits to faulthandler doc
In-Reply-To: <1306690203.86.0.276499968085.issue12209@psf.upfronthosting.co.za>
Message-ID: <1395758648.55.0.762743315395.issue12209@psf.upfronthosting.co.za>


?ric Araujo added the comment:

Thanks!

----------

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

From report at bugs.python.org  Tue Mar 25 16:55:00 2014
From: report at bugs.python.org (priya)
Date: Tue, 25 Mar 2014 15:55:00 +0000
Subject: [docs] [issue20100] epoll docs are not clear with regards to
	CLOEXEC.
In-Reply-To: <1388505494.08.0.643576998185.issue20100@psf.upfronthosting.co.za>
Message-ID: <1395762900.55.0.490097724629.issue20100@psf.upfronthosting.co.za>


Changes by priya <priyapappachan010 at gmail.com>:


Added file: http://bugs.python.org/file34618/epoll.patch

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

From report at bugs.python.org  Tue Mar 25 17:00:11 2014
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 25 Mar 2014 16:00:11 +0000
Subject: [docs] [issue21063] Touch up one-line descriptions of modules for
	module	index
Message-ID: <1395763211.53.0.0504974625449.issue21063@psf.upfronthosting.co.za>


New submission from Brett Cannon:

E.g. linecache says "This module provides random access to individual lines from text files." That's a big awkward and could just drop "This module" to read more easily.

----------
assignee: docs at python
components: Documentation
keywords: easy
messages: 214834
nosy: brett.cannon, docs at python
priority: low
severity: normal
stage: needs patch
status: open
title: Touch up one-line descriptions of modules for module index
versions: Python 3.5

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

From report at bugs.python.org  Tue Mar 25 20:08:03 2014
From: report at bugs.python.org (Tuomas Savolainen)
Date: Tue, 25 Mar 2014 19:08:03 +0000
Subject: [docs] [issue20344] subprocess.check_output() docs misrepresent
	what	shell=True does
In-Reply-To: <1390400705.04.0.503333173013.issue20344@psf.upfronthosting.co.za>
Message-ID: <1395774483.53.0.672418183859.issue20344@psf.upfronthosting.co.za>


Tuomas Savolainen added the comment:

Created a patch that adds notice of using shell=True and iterable to the documentation. Please do comment if the formatting is wrong (this my first documentation patch).

----------
Added file: http://bugs.python.org/file34619/documentation20344.patch

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

From report at bugs.python.org  Tue Mar 25 22:06:29 2014
From: report at bugs.python.org (Nikolaus Rath)
Date: Tue, 25 Mar 2014 21:06:29 +0000
Subject: [docs] [issue20375] ElementTree: Document handling processing
	instructions
In-Reply-To: <1390539216.23.0.0362813865609.issue20375@psf.upfronthosting.co.za>
Message-ID: <1395781589.05.0.0205655824978.issue20375@psf.upfronthosting.co.za>


Changes by Nikolaus Rath <Nikolaus at rath.org>:


Removed file: http://bugs.python.org/file34528/issue20951.diff

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

From tjreedy at udel.edu  Mon Mar 24 06:18:18 2014
From: tjreedy at udel.edu (Terry Reedy)
Date: Mon, 24 Mar 2014 01:18:18 -0400
Subject: [docs] Redundant index entries?
Message-ID: <532FC01A.2090209@udel.edu>

I am just starting to create or patch index entries. In following from 
refernce/compound_stmts.rst, the last two lines appear redundant.

The :keyword:`if` statement
===========================

.. index::
    statement: if
    keyword: elif
    keyword: else
            keyword: elif
            keyword: else

From report at bugs.python.org  Tue Mar 25 22:53:23 2014
From: report at bugs.python.org (Josh Rosenberg)
Date: Tue, 25 Mar 2014 21:53:23 +0000
Subject: [docs] [issue21056] csv documentation is incorrect
In-Reply-To: <1395720703.0.0.19592596057.issue21056@psf.upfronthosting.co.za>
Message-ID: <1395784402.96.0.490110761461.issue21056@psf.upfronthosting.co.za>


Josh Rosenberg added the comment:

Aside from the method being named __next__(), it's the same flaw in all copies of the Py3 documentation.

I don't think explicitly enumerating types is the way to go though. I'd just remove the documentation for __next__, and leave it up to the per-type documentation to describe the data structure returned when iterating. None of the other built-in types in Py3 bother to explicitly document "internal" methods like __next__, but rather describe iteration while describing the type itself.

----------
nosy: +josh.rosenberg

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

From report at bugs.python.org  Tue Mar 25 23:42:26 2014
From: report at bugs.python.org (Cristian Baboi)
Date: Tue, 25 Mar 2014 22:42:26 +0000
Subject: [docs] [issue21066] The separate download version for the
	documentation	doesn't work
Message-ID: <1395787346.93.0.116419141266.issue21066@psf.upfronthosting.co.za>


New submission from Cristian Baboi:

I downloaded python 2.7.6 documentation file for Windows python276.chm and it doesn't display any documentation page. It shows only the table of content.

----------
assignee: docs at python
components: Documentation, Windows
messages: 214860
nosy: Cristian.Baboi, docs at python
priority: normal
severity: normal
status: open
title: The separate download version for the documentation doesn't work
versions: Python 2.7

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

From report at bugs.python.org  Wed Mar 26 01:32:12 2014
From: report at bugs.python.org (Nikolaus Rath)
Date: Wed, 26 Mar 2014 00:32:12 +0000
Subject: [docs] [issue20375] ElementTree: Document handling processing
	instructions
In-Reply-To: <1390539216.23.0.0362813865609.issue20375@psf.upfronthosting.co.za>
Message-ID: <1395793932.14.0.917016000432.issue20375@psf.upfronthosting.co.za>


Nikolaus Rath added the comment:

Indeed I did, here's the correct patch. Thanks!

----------
Added file: http://bugs.python.org/file34622/issue20375.diff

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

From report at bugs.python.org  Wed Mar 26 08:18:57 2014
From: report at bugs.python.org (Georg Brandl)
Date: Wed, 26 Mar 2014 07:18:57 +0000
Subject: [docs] [issue21045] fix layout to generate documentation for Qt
	Assistant
In-Reply-To: <1395626324.01.0.108694815155.issue21045@psf.upfronthosting.co.za>
Message-ID: <1395818337.75.0.853460834469.issue21045@psf.upfronthosting.co.za>


Georg Brandl added the comment:

Thanks for the report!

----------
nosy: +georg.brandl
resolution: fixed -> 
stage: committed/rejected -> 
status: closed -> open

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

From report at bugs.python.org  Wed Mar 26 08:20:24 2014
From: report at bugs.python.org (Georg Brandl)
Date: Wed, 26 Mar 2014 07:20:24 +0000
Subject: [docs] [issue21045] fix layout to generate documentation for Qt
	Assistant
In-Reply-To: <1395626324.01.0.108694815155.issue21045@psf.upfronthosting.co.za>
Message-ID: <1395818424.38.0.611139198082.issue21045@psf.upfronthosting.co.za>


Changes by Georg Brandl <georg at python.org>:


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

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

From steven.culp at nasa.gov  Wed Mar 26 01:44:44 2014
From: steven.culp at nasa.gov (Culp, Steven (ARC-PX)[Lockheed Martin Space OPNS])
Date: Wed, 26 Mar 2014 00:44:44 +0000
Subject: [docs] resource.getpagesize documentation error
Message-ID: <AFB575ABC16FAD4CA99F8FD0A74093B75E08D6@NDJSMBX103.ndc.nasa.gov>

Hi,

On http://docs.python.org/2/library/resource.html#resource.getrusage, it says
"resource.getpagesize()?<http://docs.python.org/2/library/resource.html#resource.getpagesize>
Returns the number of bytes in a system page. (This need not be the same as the hardware page size.) This function is useful for determining the number of bytes of memory a process is using. The third element of the tuple returned by getrusage()<http://docs.python.org/2/library/resource.html#resource.getrusage> describes memory usage in pages; multiplying by page size produces number of bytes."
The last sentence of the above appears to be incorrect - at least on my Windows PC running Cygwin with Python 2.6.8.  The third element of the tuple returned by getrusage (according to tests using Python and C getrusage functions) appears to be kbytes.

Hope this helps.

Thanks,
-Steve Culp
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140326/1047bd38/attachment.html>

From bothenta at gmail.com  Wed Mar 26 06:11:02 2014
From: bothenta at gmail.com (1 2)
Date: Wed, 26 Mar 2014 13:11:02 +0800
Subject: [docs] Bug in tutorial
Message-ID: <CAPKGKcMHoH=ec+Ukb2JqEuLZJ73tBTcE9p_o5c8y5OPcjTmwmw@mail.gmail.com>

There is a bug on chapter 3.1.2 on strings

"End of lines are automatically included in the string, but it's possible
to prevent this by adding a \at the end of the line. The following example:"

It said to add "\" at the end of the line.

But in the example, it added backslash at the begin of the line
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140326/ee92393c/attachment.html>

From aj.bieszczad at csuci.edu  Wed Mar 26 07:16:18 2014
From: aj.bieszczad at csuci.edu (Bieszczad, A.J.)
Date: Wed, 26 Mar 2014 06:16:18 +0000
Subject: [docs] Font not correct for snippets in epub for 3.4
Message-ID: <B4841F40-61C4-4AA7-B856-4162B4EC14C8@csuci.edu>

Most code snippets in Python 3.4 Tutorial are incorrectly formatted. They should be using Courier - like in the original html (and some snippets in this version; e.g., the first snippet in section 2.1.2, but not the second).

The PDF version looks great though!

ajb


From rigordo at comcast.net  Wed Mar 26 13:11:05 2014
From: rigordo at comcast.net (Richard S. Gordon)
Date: Wed, 26 Mar 2014 08:11:05 -0400
Subject: [docs] Python 2.7.6 and Python 3.2.3 Curses Modules do not handle
	256-color palette
Message-ID: <45F5F240-638C-4DDE-8EF8-6AFAE645AE0F@comcast.net>

Problem:

	Python 2.7.6 and Python 3.2.3 Curses Modules do not properly handle 256-color palette.

Symptoms:
I have installed my application on Linux (Fedora 20 and Ubuntu 12.04), Mac OS X  (10.7.5 and 10.9.1) and Windows 7 (after installing Cygwin).
My application properly displays normal 8-color palette with xterm and xterm-color.
My application defines, generates and properly displays 16-color palette for xterm-16color.
My application defines, generates but fails to display 71-color palette for xterm-88color. It displays wrong colors and is marred by various artifacts (lines) despite host terminals (Fedora 20 and Mac OS 10.9) that had been released with default to xterm-256-color.
My application defines, generates but fails to display 140-color palette for and xterm-256color. It displays wrong colors and is marred by various artifacts (lines) despite host terminals (Fedora 20 and Mac OS 10.9) that had been released with default to xterm-256-color.
I suspect that wide (Unicode) characters are not being supported.

Any suggestions?

Richard S. Gordon
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140326/e44d68d7/attachment.html>

From zachary.ware+pydocs at gmail.com  Wed Mar 26 15:41:06 2014
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Wed, 26 Mar 2014 09:41:06 -0500
Subject: [docs] Bug in tutorial
In-Reply-To: <CAPKGKcMHoH=ec+Ukb2JqEuLZJ73tBTcE9p_o5c8y5OPcjTmwmw@mail.gmail.com>
References: <CAPKGKcMHoH=ec+Ukb2JqEuLZJ73tBTcE9p_o5c8y5OPcjTmwmw@mail.gmail.com>
Message-ID: <CAKJDb-Mfm5xC4JCJ9TFzjFZCeN=V+2tOpPyAXqwyqbTSKi_25w@mail.gmail.com>

Hi,

On Wed, Mar 26, 2014 at 12:11 AM, 1 2 <bothenta at gmail.com> wrote:
> There is a bug on chapter 3.1.2 on strings
>
> "End of lines are automatically included in the string, but it?s possible to
> prevent this by adding a \at the end of the line. The following example:"
>
> It said to add "\" at the end of the line.
>
> But in the example, it added backslash at the begin of the line

The example looks correct to me.  Note that the backslash is at the
beginning of the string, not the beginning of a line.  Here is a
sample session that will hopefully make things a little clearer for
you:

   >>> """first line
   ... second line
   ... third line
   ... fourth line"""
   'first line\nsecond line\nthird line\nfourth line'
   >>> print(_)     # At the interactive prompt, _ is always the last result
   first line
   second line
   third line
   fourth line
   >>> """\
   ... first line
   ... second line
   ... third line (empty fourth line follows)
   ... """
   'first line\nsecond line\nthird line (empty fourth line follows)\n'
   >>> print(_)
   first line
   second line
   third line (empty fourth line follows)

   >>> """\
   ... first line
   ... second line\
   ...  still second line
   ... third line with no trailing newline\
   ... """
   'first line\nsecond line still second line\nthird line with no
trailing newline'
   >>> print(_)
   first line
   second line still second line
   third line with no trailing newline

Basically, a '\' at the end of a physical line causes the logical line
to continue.  Does that make sense?

The example above is way too long to add to the documentation, but if
you can suggest any way to tweak the docs to make things clearer,
please let us know!

Regards,

-- 
Zach

From report at bugs.python.org  Wed Mar 26 19:26:38 2014
From: report at bugs.python.org (R. David Murray)
Date: Wed, 26 Mar 2014 18:26:38 +0000
Subject: [docs] [issue21071] struct.Struct.format is bytes, but should be str
In-Reply-To: <1395856133.5.0.672707015318.issue21071@psf.upfronthosting.co.za>
Message-ID: <1395858398.08.0.412012669592.issue21071@psf.upfronthosting.co.za>


R. David Murray added the comment:

I agree that the implementation does not match the documentation in this case.  Especially the part about "the format string used to create this Struct object".  I don't see what having a flag would buy you: it doesn't help you in writing 2/3 shared code.  I think the best we can do here is a doc change.

----------
assignee:  -> docs at python
components: +Documentation
nosy: +docs at python, r.david.murray
stage:  -> needs patch
versions:  -Python 3.1, Python 3.2, Python 3.3

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

From report at bugs.python.org  Wed Mar 26 21:51:21 2014
From: report at bugs.python.org (Vyacheslav Rafalskiy)
Date: Wed, 26 Mar 2014 20:51:21 +0000
Subject: [docs] [issue20903] smtplib.SMTP raises socket.timeout
In-Reply-To: <1394664754.18.0.260499838693.issue20903@psf.upfronthosting.co.za>
Message-ID: <1395867081.1.0.406973399003.issue20903@psf.upfronthosting.co.za>


Vyacheslav Rafalskiy added the comment:

Take look at this one too: http://bugs.python.org/issue2118
It is supposed to be fixed.

----------
nosy: +Vyacheslav.Rafalskiy

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

From report at bugs.python.org  Wed Mar 26 23:27:03 2014
From: report at bugs.python.org (Leo Butcher)
Date: Wed, 26 Mar 2014 22:27:03 +0000
Subject: [docs] [issue21072] Python docs and downloads not available for
	Egypt
Message-ID: <1395872823.34.0.614292416852.issue21072@psf.upfronthosting.co.za>


New submission from Leo Butcher:

I can't seem to access docs.python.org, mail.python.org, or even legacy.python.org
from my ISP in Egypt "LinkDotNet" the usual dynamic IP range is 41.130.xx.xx
please tell me if you need any further info

----------
assignee: docs at python
components: Documentation
messages: 214917
nosy: Leo.Butcher, docs at python
priority: normal
severity: normal
status: open
title: Python docs and downloads not available for Egypt
type: resource usage
versions: Python 2.7, Python 3.1, Python 3.2, Python 3.3, Python 3.4, Python 3.5

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

From report at bugs.python.org  Thu Mar 27 01:25:30 2014
From: report at bugs.python.org (Benjamin Peterson)
Date: Thu, 27 Mar 2014 00:25:30 +0000
Subject: [docs] [issue21072] Python docs and downloads not available for
	Egypt
In-Reply-To: <1395872823.34.0.614292416852.issue21072@psf.upfronthosting.co.za>
Message-ID: <1395879930.37.0.25215224719.issue21072@psf.upfronthosting.co.za>


Benjamin Peterson added the comment:

What is the mode of failure? (what does traceroute give?)

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

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

From bothenta at gmail.com  Thu Mar 27 01:47:13 2014
From: bothenta at gmail.com (1 2)
Date: Thu, 27 Mar 2014 08:47:13 +0800
Subject: [docs] Bug in tutorial
In-Reply-To: <CAKJDb-Mfm5xC4JCJ9TFzjFZCeN=V+2tOpPyAXqwyqbTSKi_25w@mail.gmail.com>
References: <CAPKGKcMHoH=ec+Ukb2JqEuLZJ73tBTcE9p_o5c8y5OPcjTmwmw@mail.gmail.com>
 <CAKJDb-Mfm5xC4JCJ9TFzjFZCeN=V+2tOpPyAXqwyqbTSKi_25w@mail.gmail.com>
Message-ID: <CAPKGKcMW=1S+CLt4wb1tWnXvrQfYd8w9gXKe+aTnxa3SGfHhnA@mail.gmail.com>

  Well, I think I found the problem, it was because the text warping of my
epub reader, now I switch back to pdf which is much better.

  As for shortening the example, I think it could be like the following:

Pls remember the backslash always continues a physical line which would
combine the two physical line where it locates and the line below into the
same logical line.

>>> print("""\
... first line
... second line\
... still second line
... third line with no trailing newline
..."""
)
The result would be:

'first line
second line still second line
third line with no trailing newline
'

Hi,
>
> On Wed, Mar 26, 2014 at 12:11 AM, 1 2 <bothenta at gmail.com> wrote:
> > There is a bug on chapter 3.1.2 on strings
> >
> > "End of lines are automatically included in the string, but it's
> possible to
> > prevent this by adding a \at the end of the line. The following example:"
> >
> > It said to add "\" at the end of the line.
> >
> > But in the example, it added backslash at the begin of the line
>
> The example looks correct to me.  Note that the backslash is at the
> beginning of the string, not the beginning of a line.  Here is a
> sample session that will hopefully make things a little clearer for
> you:
>
>    >>> """first line
>    ... second line
>    ... third line
>    ... fourth line"""
>    'first line\nsecond line\nthird line\nfourth line'
>    >>> print(_)     # At the interactive prompt, _ is always the last
> result
>    first line
>    second line
>    third line
>    fourth line
>    >>> """\
>    ... first line
>    ... second line
>    ... third line (empty fourth line follows)
>    ... """
>    'first line\nsecond line\nthird line (empty fourth line follows)\n'
>    >>> print(_)
>    first line
>    second line
>    third line (empty fourth line follows)
>
>    >>> """\
>    ... first line
>    ... second line\
>    ...  still second line
>    ... third line with no trailing newline\
>    ... """
>    'first line\nsecond line still second line\nthird line with no
> trailing newline'
>    >>> print(_)
>    first line
>    second line still second line
>    third line with no trailing newline
>
> Basically, a '\' at the end of a physical line causes the logical line
> to continue.  Does that make sense?
>
> The example above is way too long to add to the documentation, but if
> you can suggest any way to tweak the docs to make things clearer,
> please let us know!
>
> Regards,
>
> --
> Zach
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140327/92575b31/attachment.html>

From report at bugs.python.org  Thu Mar 27 03:20:35 2014
From: report at bugs.python.org (Leo Butcher)
Date: Thu, 27 Mar 2014 02:20:35 +0000
Subject: [docs] [issue21072] Python docs and downloads not available for
	Egypt
In-Reply-To: <1395872823.34.0.614292416852.issue21072@psf.upfronthosting.co.za>
Message-ID: <1395886835.31.0.623261634717.issue21072@psf.upfronthosting.co.za>


Leo Butcher added the comment:

Here is traceroute docs.python.org output

traceroute to docs.python.org (82.94.164.162), 30 hops max, 60 byte packets
 1  192.168.1.1 (192.168.1.1)  0.599 ms  0.955 ms  1.306 ms
 2  * * *
 3  172.18.1.157 (172.18.1.157)  10.235 ms  11.689 ms  12.875 ms
 4  172.18.1.14 (172.18.1.14)  21.340 ms 172.18.1.10 (172.18.1.10)  24.101 ms  24.268 ms
 5  172.20.3.37 (172.20.3.37)  71.788 ms  73.218 ms 172.20.3.41 (172.20.3.41)  29.192 ms
 6  172.19.1.49 (172.19.1.49)  28.975 ms 172.19.1.22 (172.19.1.22)  9.621 ms  10.832 ms
 7  172.19.1.9 (172.19.1.9)  15.741 ms 172.19.1.61 (172.19.1.61)  16.168 ms 172.19.1.9 (172.19.1.9)  15.882 ms
 8  dsl-del-static-137.45.246.61.airtelbroadband.in (61.246.45.137)  77.347 ms dsl-del-static-005.45.246.61.airtelbroadband.in (61.246.45.5)  77.099 ms pos6-0.cr02.ldn01.pccwbtn.net (63.218.54.53)  89.124 ms
 9  * * xe-11-1-2.franco31.fra.seabone.net (89.221.34.55)  71.340 ms
10  100ge3-2.core1.ams1.he.net (72.52.92.214)  81.131 ms ffm-s2-rou-1041.DE.eurorings.net (134.222.249.25)  78.961 ms 100ge3-2.core1.ams1.he.net (72.52.92.214)  74.997 ms
11  ffm-s1-rou-1102.DE.eurorings.net (134.222.229.73)  89.695 ms 100ge3-2.core1.ams1.he.net (72.52.92.214)  88.814 ms ffm-s1-rou-1102.DE.eurorings.net (134.222.229.73)  96.210 ms
12  dssd-s2-rou-1102.DE.eurorings.net (134.222.232.154)  79.726 ms  81.474 ms *
13  * asd2-rou-1022.NL.eurorings.net (134.222.228.73)  69.048 ms *
14  asd2-rou-1044.NL.eurorings.net (134.222.199.83)  134.870 ms * *
15  * * *
16  * * *
17  * * *
18  * * *
19  * * *
20  * * *
21  * * *
22  * * *
23  * * *
24  * * *
25  * * *
26  * * *
27  * * *
28  * * *
29  * * *
30  * * *

----------

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

From report at bugs.python.org  Thu Mar 27 03:49:20 2014
From: report at bugs.python.org (Benjamin Peterson)
Date: Thu, 27 Mar 2014 02:49:20 +0000
Subject: [docs] [issue21072] Python docs and downloads not available for
	Egypt
In-Reply-To: <1395872823.34.0.614292416852.issue21072@psf.upfronthosting.co.za>
Message-ID: <1395888560.67.0.989787451518.issue21072@psf.upfronthosting.co.za>


Benjamin Peterson added the comment:

I guess that means the IP traffic is getting out. How do you know its failing?

----------

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

From report at bugs.python.org  Thu Mar 27 05:10:47 2014
From: report at bugs.python.org (Leo Butcher)
Date: Thu, 27 Mar 2014 04:10:47 +0000
Subject: [docs] [issue21072] Python docs and downloads not available for
	Egypt
In-Reply-To: <1395872823.34.0.614292416852.issue21072@psf.upfronthosting.co.za>
Message-ID: <1395893447.63.0.756481584735.issue21072@psf.upfronthosting.co.za>


Leo Butcher added the comment:

I tried different browsers/systems I can just get in with abroad VPN connection

----------

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

From report at bugs.python.org  Thu Mar 27 06:06:32 2014
From: report at bugs.python.org (Benjamin Peterson)
Date: Thu, 27 Mar 2014 05:06:32 +0000
Subject: [docs] [issue21072] Python docs and downloads not available for
	Egypt
In-Reply-To: <1395872823.34.0.614292416852.issue21072@psf.upfronthosting.co.za>
Message-ID: <1395896792.33.0.464815863239.issue21072@psf.upfronthosting.co.za>


Benjamin Peterson added the comment:

It's hard for me to do anything without more specific information. Maybe you can try the devtools on your browser.

----------

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

From report at bugs.python.org  Thu Mar 27 09:48:33 2014
From: report at bugs.python.org (Tobias Klausmann)
Date: Thu, 27 Mar 2014 08:48:33 +0000
Subject: [docs] [issue20344] subprocess.check_output() docs misrepresent
	what	shell=True does
In-Reply-To: <1395774483.53.0.672418183859.issue20344@psf.upfronthosting.co.za>
Message-ID: <20140327084832.GA15969@skade.schwarzvogel.de>


Tobias Klausmann added the comment:

Hi! 

On Tue, 25 Mar 2014, Tuomas Savolainen wrote:
> Created a patch that adds notice of using shell=True and iterable to the documentation. Please do comment if the formatting is wrong (this my first documentation patch).

I'd use articles, i.e. "and a list" and "does not raise an error" 

Also, s/except/expect/

Regards,
Tobias

----------

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

From report at bugs.python.org  Thu Mar 27 14:03:40 2014
From: report at bugs.python.org (R. David Murray)
Date: Thu, 27 Mar 2014 13:03:40 +0000
Subject: [docs] [issue20344] subprocess.check_output() docs misrepresent
	what	shell=True does
In-Reply-To: <1390400705.04.0.503333173013.issue20344@psf.upfronthosting.co.za>
Message-ID: <1395925420.73.0.113462130902.issue20344@psf.upfronthosting.co.za>


R. David Murray added the comment:

Also, the "see below" sentence is missing.

----------

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

From report at bugs.python.org  Thu Mar 27 14:05:51 2014
From: report at bugs.python.org (Tuomas Savolainen)
Date: Thu, 27 Mar 2014 13:05:51 +0000
Subject: [docs] [issue20344] subprocess.check_output() docs misrepresent
	what	shell=True does
In-Reply-To: <1390400705.04.0.503333173013.issue20344@psf.upfronthosting.co.za>
Message-ID: <1395925551.26.0.914622628757.issue20344@psf.upfronthosting.co.za>


Tuomas Savolainen added the comment:

Corrected the spelling of the patch.

----------
Added file: http://bugs.python.org/file34635/20344_3.patch

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

From report at bugs.python.org  Thu Mar 27 16:32:29 2014
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 27 Mar 2014 15:32:29 +0000
Subject: [docs] [issue19573] Fix the docstring of inspect.Parameter and
	the	implementation of _ParameterKind
In-Reply-To: <1384371223.06.0.467962768293.issue19573@psf.upfronthosting.co.za>
Message-ID: <3fvqvJ5W4Mz7Ljd@mail.python.org>


Roundup Robot added the comment:

New changeset c2b94f891c88 by Yury Selivanov in branch 'default':
inspect.signature: Use enum for parameter kind constants. Closes #19573
http://hg.python.org/cpython/rev/c2b94f891c88

----------
nosy: +python-dev
resolution:  -> fixed
stage: patch review -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Thu Mar 27 17:49:51 2014
From: report at bugs.python.org (Yuriy Taraday)
Date: Thu, 27 Mar 2014 16:49:51 +0000
Subject: [docs] [issue21078]
	multiprocessing.managers.BaseManager.__init__'s	"serializer"
	argument is not documented
Message-ID: <1395938991.3.0.211293361393.issue21078@psf.upfronthosting.co.za>


New submission from Yuriy Taraday:

We're going to use BaseManager for simple secure local RPC and for the "secure" part we can't use pickle, so we have to use "serializer" argument to switch to xmlrpclib.

We need to be sure that argument won't go away so we need it to be documented and supported on future versions.

----------
assignee: docs at python
components: Documentation
messages: 214967
nosy: docs at python, yorik.sar
priority: normal
severity: normal
status: open
title: multiprocessing.managers.BaseManager.__init__'s "serializer" argument is not documented
versions: Python 2.7, Python 3.1, Python 3.2, Python 3.3, Python 3.4, Python 3.5

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

From report at bugs.python.org  Thu Mar 27 17:57:48 2014
From: report at bugs.python.org (Brett Cannon)
Date: Thu, 27 Mar 2014 16:57:48 +0000
Subject: [docs] [issue21078]
	multiprocessing.managers.BaseManager.__init__'s	"serializer"
	argument is not documented
In-Reply-To: <1395938991.3.0.211293361393.issue21078@psf.upfronthosting.co.za>
Message-ID: <1395939468.5.0.780256720451.issue21078@psf.upfronthosting.co.za>


Brett Cannon added the comment:

Is there any reason it isn't documented, Richard? And are there proper tests?

----------
nosy: +brett.cannon, sbt

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

From report at bugs.python.org  Thu Mar 27 21:10:08 2014
From: report at bugs.python.org (Angad Singh)
Date: Thu, 27 Mar 2014 20:10:08 +0000
Subject: [docs] [issue21063] Touch up one-line descriptions of modules for
	module	index
In-Reply-To: <1395763211.53.0.0504974625449.issue21063@psf.upfronthosting.co.za>
Message-ID: <1395951008.16.0.495006838298.issue21063@psf.upfronthosting.co.za>


Angad Singh added the comment:

Interested in taking this up as my first patch -
@brett - are you only talking about the :synopsis: or the occurrence of "This module" at the beginning of the description as well?
-angad

----------
nosy: +angad

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

From report at bugs.python.org  Thu Mar 27 21:14:22 2014
From: report at bugs.python.org (Brett Cannon)
Date: Thu, 27 Mar 2014 20:14:22 +0000
Subject: [docs] [issue21063] Touch up one-line descriptions of modules for
	module	index
In-Reply-To: <1395763211.53.0.0504974625449.issue21063@psf.upfronthosting.co.za>
Message-ID: <1395951262.35.0.335894715749.issue21063@psf.upfronthosting.co.za>


Brett Cannon added the comment:

Just the synopsis lines for the modules.

----------

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

From report at bugs.python.org  Thu Mar 27 21:29:18 2014
From: report at bugs.python.org (Angad Singh)
Date: Thu, 27 Mar 2014 20:29:18 +0000
Subject: [docs] [issue21063] Touch up one-line descriptions of modules for
	module	index
In-Reply-To: <1395763211.53.0.0504974625449.issue21063@psf.upfronthosting.co.za>
Message-ID: <1395952158.75.0.888047268523.issue21063@psf.upfronthosting.co.za>


Angad Singh added the comment:

Not a lot of occurrences if I only look at the synopsis. Attaching a diff.
Also saw a weird "This subpackage" in apiref.rst line 1767. Fix that too?

----------
keywords: +patch
Added file: http://bugs.python.org/file34639/this_module_doc_fix.patch

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

From report at bugs.python.org  Thu Mar 27 21:31:18 2014
From: report at bugs.python.org (Brett Cannon)
Date: Thu, 27 Mar 2014 20:31:18 +0000
Subject: [docs] [issue21063] Touch up one-line descriptions of modules for
	module	index
In-Reply-To: <1395763211.53.0.0504974625449.issue21063@psf.upfronthosting.co.za>
Message-ID: <1395952278.1.0.501073498863.issue21063@psf.upfronthosting.co.za>


Brett Cannon added the comment:

Sure, if you are just looking for "This module" you won't find very many instances. The bug is more about doing a sweep through *every* module's synopsis and just cleaning them up to read better. The "this module" instance for linecache is just an example of why a cleanup would be good to do.

----------

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

From dg.latella at gmail.com  Fri Mar 28 21:41:04 2014
From: dg.latella at gmail.com (Diego Latella)
Date: Fri, 28 Mar 2014 21:41:04 +0100
Subject: [docs] Oops.. correction
Message-ID: <1A7D38BC-41ED-4BE2-864B-D19813FCB86D@fastwebnet.it>

I should like to report a bug on the module 'configparser.py' 
Python version: 3.4.0 run on Mac os 10.6.8

    ### Error in 'str' name and 'str' function
    def _write_section(self, fp, section_name, section_items, delimiter):
        """Write a single section to the specified `fp'."""
        #fp.write("[{}]\n".format(section_name))
        str = "[{}]\n".format(section_name)
        fp.write(str)
        for key, value in section_items:
            value = self._interpolation.before_write(self, section_name, key,
                                                     value)
            if value is not None or not self._allow_no_value:
                value = delimiter + str(value).replace("\n", "\n\t")
            else:
                value = ""
            fp.write("{}{}\n".format(key, value))
        fp.write("\n")
    
Proposed correction:
    ### Correction made by D. Latella 28/3/2014
    def _write_section(self, fp, section_name, section_items, delimiter):
        """Write a single section to the specified `fp'."""
        #fp.write("[{}]\n".format(section_name))
        strng = "[{}]\n".format(section_name)
        fp.write(strng)
        for key, value in section_items:
            value = self._interpolation.before_write(self, section_name, key,
                                                     value)
            if value is not None or not self._allow_no_value:
                value = delimiter + str(value).replace('\n', '\n\t')
            else:
                value = ""
            fp.write("{}{}\n".format(key, value))
        fp.write("\n")

This is the code to test bug:

import os
import configparser

def get_preferences_from_file():
    config = configparser.ConfigParser()
    print(config.sections())
    if not os.access('board.ini',os.F_OK):
        # no .ini file yet, so make one
        config['DEFAULT'] = {'font':'Arial',
                             'size':'12'}
        # Writing our configuration file to 'raven.ini'
        with open('board.ini', 'w') as configfile:
            config.write(configfile)
    config.read('board.ini')
    print('>>>>',config.sections())
    font = config['DEFAULT']['font']
    size = config['DEFAULT']['size']
    return font, size

if __name__ == '__main__':
    fs = get_preferences_from_file()
    print(fs)

Best wishes
Diego Latella
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140328/06876312/attachment.html>

From zachary.ware+pydocs at gmail.com  Fri Mar 28 21:56:41 2014
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Fri, 28 Mar 2014 15:56:41 -0500
Subject: [docs] Oops.. correction
In-Reply-To: <1A7D38BC-41ED-4BE2-864B-D19813FCB86D@fastwebnet.it>
References: <1A7D38BC-41ED-4BE2-864B-D19813FCB86D@fastwebnet.it>
Message-ID: <CAKJDb-Met1Aw6TbqH-F9Q1sj-g+M8jGxydM-1JM8k=P4aJgKOA@mail.gmail.com>

Hi Diego,

On Fri, Mar 28, 2014 at 3:41 PM, Diego Latella <dg.latella at gmail.com> wrote:
> I should like to report a bug on the module 'configparser.py'

This is not the proper venue for reporting library bugs; this list is
meant for discussion of the Python documentation.  In the future,
please direct library bugs to the issue tracker
(http://bugs.python.org/).

> Python version: 3.4.0 run on Mac os 10.6.8
>
>     ### Error in 'str' name and 'str' function
>     def _write_section(self, fp, section_name, section_items, delimiter):
>         """Write a single section to the specified `fp'."""
>         #fp.write("[{}]\n".format(section_name))
>         str = "[{}]\n".format(section_name)
>         fp.write(str)

Looking in the Mercurial history of configparser.py
(http://hg.python.org/cpython/annotate/default/Lib/configparser.py),
it has never contained the two lines that are in error.  The commented
out line is the real line (and would be the real way to fix things if
the two bad lines did exist :).

I don't know how your copy of configparser.py came to be patched like
that, but you can get a clean copy here:
http://hg.python.org/cpython/raw-file/v3.4.0/Lib/configparser.py

Regards,
-- 
Zach

From dg.latella at gmail.com  Fri Mar 28 21:31:50 2014
From: dg.latella at gmail.com (Diego Latella)
Date: Fri, 28 Mar 2014 21:31:50 +0100
Subject: [docs] Bug report
Message-ID: <BC11E3EA-DB32-4950-94AA-2E55E8C49B9D@fastwebnet.it>

I should like to report a bug on the module 'configparser.py' 
Python version: 3.4.0 run on Mac os 10.6.8

    ### Error in 'str' name and 'str' function
    def _write_section(self, fp, section_name, section_items, delimiter):
        """Write a single section to the specified `fp'."""
        #fp.write("[{}]\n".format(section_name))
        str = "[{}]\n".format(section_name)
        fp.write(str)
        for key, value in section_items:
            value = self._interpolation.before_write(self, section_name, key,
                                                     value)
            if value is not None or not self._allow_no_value:
                value = delimiter + str(value).replace("\n", "\n\t")
            else:
                value = ""
            fp.write("{}{}\n".format(key, value))
        fp.write("\n")
    
Proposed correction:
    ### Correction made by D. Latella 28/3/2014
    def _write_section(self, fp, section_name, section_items, delimiter):
        """Write a single section to the specified `fp'."""
        #fp.write("[{}]\n".format(section_name))
        strng = "[{}]\n".format(section_name)
        fp.write(strng)
        for key, value in section_items:
            value = self._interpolation.before_write(self, section_name, key,
                                                     value)
            if value is not None or not self._allow_no_value:
                value = delimiter + str(value).replace('\n', '\n\t')
            else:
                value = ""
            fp.write("{}{}\n".format(key, value))
        fp.write("\n")

This is the code to test bug:

import os
import configparser

def get_preferences_from_file():
    config = configparser.ConfigParser()
    print(config.sections())
    if not os.access('board.ini',os.F_OK):
        # no .ini file yet, so make one
        config['DEFAULT'] = {'font':'Arial',
                             'size':'12'}
        # Writing our configuration file to 'raven.ini'
        with open('board.ini', 'w') as configfile:
            config.write(configfile)
    config.read('raven.ini')
    print('>>>>',config.sections())
    font = config['DEFAULT']['font']
    size = config['DEFAULT']['size']
    return font, size

if __name__ == '__main__':
    fs = get_preferences_from_file()
    print(fs)

Best wishes
Diego Latella
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140328/220d30d0/attachment.html>

From report at bugs.python.org  Fri Mar 28 23:19:16 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 28 Mar 2014 22:19:16 +0000
Subject: [docs] [issue21014] `1` => `True`; for tutorial docs
In-Reply-To: <1395453556.85.0.399159850271.issue21014@psf.upfronthosting.co.za>
Message-ID: <1396045156.01.0.0618259637212.issue21014@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

Raymond, what I think you meant is that in 2.x, 'True' is a builtin name that can be shadowed by a user assignment "True = 'not true'" whereas in 3.x it is a keyword name like None that cannot be changed ("None = 'some'" fails even in 2.7).

I checked and the patch is needed in 3.4 and (I presume) 3.5.

----------
nosy: +terry.reedy
versions: +Python 3.4, Python 3.5 -Python 2.7

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

From report at bugs.python.org  Fri Mar 28 23:47:30 2014
From: report at bugs.python.org (Steve Holden)
Date: Fri, 28 Mar 2014 22:47:30 +0000
Subject: [docs] [issue19871] json module won't parse a float that starts
	with a	decimal point
In-Reply-To: <1386058873.01.0.290791588539.issue19871@psf.upfronthosting.co.za>
Message-ID: <1396046850.2.0.935691426552.issue19871@psf.upfronthosting.co.za>


Steve Holden added the comment:

How about: "A simple JSON decoder that converts between JSON string representations and Python data structures"?

----------
nosy: +holdenweb

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

From report at bugs.python.org  Sat Mar 29 00:39:57 2014
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 28 Mar 2014 23:39:57 +0000
Subject: [docs] [issue21014] `1` => `True`; for tutorial docs
In-Reply-To: <1395453556.85.0.399159850271.issue21014@psf.upfronthosting.co.za>
Message-ID: <3fwfgJ75Fhz7LlZ@mail.python.org>


Roundup Robot added the comment:

New changeset deb71529aad1 by Raymond Hettinger in branch '3.4':
Issue 21014:  Use booleans instead of 0 and 1 in examples.
http://hg.python.org/cpython/rev/deb71529aad1

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

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

From report at bugs.python.org  Sat Mar 29 00:43:19 2014
From: report at bugs.python.org (Raymond Hettinger)
Date: Fri, 28 Mar 2014 23:43:19 +0000
Subject: [docs] [issue21014] `1` => `True`; for tutorial docs
In-Reply-To: <1395453556.85.0.399159850271.issue21014@psf.upfronthosting.co.za>
Message-ID: <1396050199.06.0.291525187407.issue21014@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

Samuel, thanks for the patch.   And, Terry, thanks for looking at it.

Applied the first two changes to 3.4 and 3.5.  Skipped, the third suggested change in introduction.rst.  That was not a boolean example, it was just the number 1 in a section about how comments work, so it shouldn't change.

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

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

From report at bugs.python.org  Sat Mar 29 02:45:18 2014
From: report at bugs.python.org (Chris Rebert)
Date: Sat, 29 Mar 2014 01:45:18 +0000
Subject: [docs] [issue10976] json.loads() raises TypeError on bytes object
In-Reply-To: <1295636509.41.0.0138366952356.issue10976@psf.upfronthosting.co.za>
Message-ID: <1396057518.12.0.439409773431.issue10976@psf.upfronthosting.co.za>


Changes by Chris Rebert <pybugs at rebertia.com>:


----------
nosy: +cvrebert

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

From report at bugs.python.org  Sat Mar 29 03:02:12 2014
From: report at bugs.python.org (Chris Rebert)
Date: Sat, 29 Mar 2014 02:02:12 +0000
Subject: [docs] [issue21092] json serializer implicitly stringifies
	non-string keys
Message-ID: <1396058532.4.0.747084200104.issue21092@psf.upfronthosting.co.za>


New submission from Chris Rebert:

Python 3.3.4 (default, Feb 21 2014, 18:00:34) 
[GCC 4.2.1 Compatible Apple LLVM 5.0 (clang-500.2.79)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> from json import dumps
>>> dumps({True: True, False: False, None: None, 42: 42})
'{"false": false, "true": true, "42": 42, "null": null}'
>>>


This implicit stringification of non-string dictionary keys does not currently appear to be documented.

----------
assignee: docs at python
components: Documentation
messages: 215105
nosy: cvrebert, docs at python
priority: normal
severity: normal
status: open
title: json serializer implicitly stringifies non-string keys
versions: Python 3.5

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

From report at bugs.python.org  Sat Mar 29 08:38:50 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 29 Mar 2014 07:38:50 +0000
Subject: [docs] [issue21066] The separate download version for the
	documentation	doesn't work
In-Reply-To: <1395787346.93.0.116419141266.issue21066@psf.upfronthosting.co.za>
Message-ID: <1396078730.76.0.765767421375.issue21066@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

When I open it on Win7 from the start menu ('Python Manuals'), I see a page starting with 
"Welcome! This is the documentation for Python 2.7.6, last updated Nov 10, 2013. ".
Did you do something differnt? Can you access pages from the contents?

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

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

From report at bugs.python.org  Sat Mar 29 10:45:25 2014
From: report at bugs.python.org (Cristian Baboi)
Date: Sat, 29 Mar 2014 09:45:25 +0000
Subject: [docs] [issue21066] The separate download version for
	the	documentation	doesn't work
In-Reply-To: <1396078730.76.0.765767421375.issue21066@psf.upfronthosting.co.za>
Message-ID: <f6191255-7621-4726-8319-0b3cf839178f@email.android.com>


Cristian Baboi added the comment:

Yes. I downloaded the separate chm file and double clicked on the file. There is no entry on the start menu. The file included in the python installer is OK.

On 29 martie 2014 09:38:50 EET, "Terry J. Reedy" <report at bugs.python.org> wrote:
>
>Terry J. Reedy added the comment:
>
>When I open it on Win7 from the start menu ('Python Manuals'), I see a
>page starting with 
>"Welcome! This is the documentation for Python 2.7.6, last updated Nov
>10, 2013. ".
>Did you do something differnt? Can you access pages from the contents?
>
>----------
>nosy: +terry.reedy
>
>_______________________________________
>Python tracker <report at bugs.python.org>
><http://bugs.python.org/issue21066>
>_______________________________________

----------
title: The separate download version for the documentation doesn't work -> The separate download version for the documentation	doesn't work

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

From report at bugs.python.org  Sat Mar 29 11:26:48 2014
From: report at bugs.python.org (=?utf-8?q?Martin_v=2E_L=C3=B6wis?=)
Date: Sat, 29 Mar 2014 10:26:48 +0000
Subject: [docs] [issue21066] The separate download version for
	the	documentation	doesn't work
In-Reply-To: <1395787346.93.0.116419141266.issue21066@psf.upfronthosting.co.za>
Message-ID: <1396088808.75.0.693711651758.issue21066@psf.upfronthosting.co.za>


Martin v. L?wis added the comment:

Can you please provide a screenshot?

----------
nosy: +loewis

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

From report at bugs.python.org  Sat Mar 29 14:34:14 2014
From: report at bugs.python.org (Berker Peksag)
Date: Sat, 29 Mar 2014 13:34:14 +0000
Subject: [docs] [issue21092] json serializer implicitly stringifies
	non-string keys
In-Reply-To: <1396058532.4.0.747084200104.issue21092@psf.upfronthosting.co.za>
Message-ID: <1396100054.88.0.903178645801.issue21092@psf.upfronthosting.co.za>


Berker Peksag added the comment:

> This implicit stringification of non-string dictionary keys does not
> currently appear to be documented.

I think this is part of the JSON spec. See http://json.org/object.gif for example.

Also, this is already documented in the json.dumps() documentation:

> Keys in key/value pairs of JSON are always of the type str. When a
> dictionary is converted into JSON, all the keys of the dictionary are
> coerced to strings.

http://docs.python.org/3.4/library/json.html#json.dumps

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

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

From report at bugs.python.org  Sat Mar 29 14:39:11 2014
From: report at bugs.python.org (Brett Cannon)
Date: Sat, 29 Mar 2014 13:39:11 +0000
Subject: [docs] [issue21092] json serializer implicitly stringifies
	non-string keys
In-Reply-To: <1396058532.4.0.747084200104.issue21092@psf.upfronthosting.co.za>
Message-ID: <1396100351.6.0.896028083836.issue21092@psf.upfronthosting.co.za>


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


----------
resolution:  -> invalid
status: open -> closed

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

From report at bugs.python.org  Sat Mar 29 17:35:04 2014
From: report at bugs.python.org (Yuriy Taraday)
Date: Sat, 29 Mar 2014 16:35:04 +0000
Subject: [docs] [issue21078]
	multiprocessing.managers.BaseManager.__init__'s	"serializer"
	argument is not documented
In-Reply-To: <1395938991.3.0.211293361393.issue21078@psf.upfronthosting.co.za>
Message-ID: <1396110904.57.0.164532880165.issue21078@psf.upfronthosting.co.za>


Yuriy Taraday added the comment:

Adding Benjamin Peterson as original author of multiprocessing (according to hg logs)

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

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

From report at bugs.python.org  Sat Mar 29 17:49:23 2014
From: report at bugs.python.org (R. David Murray)
Date: Sat, 29 Mar 2014 16:49:23 +0000
Subject: [docs] [issue21078]
	multiprocessing.managers.BaseManager.__init__'s	"serializer"
	argument is not documented
In-Reply-To: <1395938991.3.0.211293361393.issue21078@psf.upfronthosting.co.za>
Message-ID: <1396111763.92.0.566979657122.issue21078@psf.upfronthosting.co.za>


R. David Murray added the comment:

He wasn't, sbt (with help) was.  Benjamin may have checked it in or something.

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

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

From report at bugs.python.org  Sat Mar 29 17:52:20 2014
From: report at bugs.python.org (Yuriy Taraday)
Date: Sat, 29 Mar 2014 16:52:20 +0000
Subject: [docs] [issue21078]
	multiprocessing.managers.BaseManager.__init__'s	"serializer"
	argument is not documented
In-Reply-To: <1395938991.3.0.211293361393.issue21078@psf.upfronthosting.co.za>
Message-ID: <1396111940.78.0.622012540897.issue21078@psf.upfronthosting.co.za>


Yuriy Taraday added the comment:

Oh, sorry.

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

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

From report at bugs.python.org  Sat Mar 29 21:30:34 2014
From: report at bugs.python.org (Richard Oudkerk)
Date: Sat, 29 Mar 2014 20:30:34 +0000
Subject: [docs] [issue21078]
	multiprocessing.managers.BaseManager.__init__'s	"serializer"
	argument is not documented
In-Reply-To: <1395938991.3.0.211293361393.issue21078@psf.upfronthosting.co.za>
Message-ID: <1396125034.0.0.194954157904.issue21078@psf.upfronthosting.co.za>


Richard Oudkerk added the comment:

No, the argument will not go away now.

However, I don't much like the API which is perhaps why I did not get round to documenting it.

It does have tests.  Currently 'xmlrpclib' is the only supported alternative, but JSON support could be added quite easily.

----------

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

From report at bugs.python.org  Sat Mar 29 21:33:41 2014
From: report at bugs.python.org (=?utf-8?q?Martin_v=2E_L=C3=B6wis?=)
Date: Sat, 29 Mar 2014 20:33:41 +0000
Subject: [docs] [issue21066] The separate download version for the
	documentation	doesn't work
In-Reply-To: <1395787346.93.0.116419141266.issue21066@psf.upfronthosting.co.za>
Message-ID: <1396125221.8.0.176066286656.issue21066@psf.upfronthosting.co.za>


Martin v. L?wis added the comment:

This is not a bug in Python, but a Windows limitation. In the first box, uncheck "Always ask before opening this file", then reopen. Alternatively, right-click on the file, open properties, and press "Unblock".

Microsoft imposes this behavior on all CHM files downloaded from the internet. For other file types (.exe, .msi) they allow the package author to use code signing to establish trust in the authenticity of the file, but not so for CHM.

Closing this as "3rd party".

----------
resolution:  -> 3rd party
status: open -> closed

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

From report at bugs.python.org  Sat Mar 29 21:41:02 2014
From: report at bugs.python.org (Nick Coghlan)
Date: Sat, 29 Mar 2014 20:41:02 +0000
Subject: [docs] [issue15331] Codecs docs should explain that the
	bytes-bytes	shorthand aliases are missing
In-Reply-To: <1342091074.63.0.386956250979.issue15331@psf.upfronthosting.co.za>
Message-ID: <1396125662.69.0.685186069068.issue15331@psf.upfronthosting.co.za>


Nick Coghlan added the comment:

The aliases are back in 3.4+

----------
resolution:  -> out of date
stage: needs patch -> committed/rejected
status: open -> closed
type: behavior -> 

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

From report at bugs.python.org  Sun Mar 30 08:00:26 2014
From: report at bugs.python.org (Nick Coghlan)
Date: Sun, 30 Mar 2014 06:00:26 +0000
Subject: [docs] [issue11704] functools.partial doesn't create bound methods
In-Reply-To: <1301348051.58.0.203467592285.issue11704@psf.upfronthosting.co.za>
Message-ID: <1396159226.26.0.119227442562.issue11704@psf.upfronthosting.co.za>


Nick Coghlan added the comment:

With the introduction of functools.partialmethod in 3.4, marking this older docs issue as a "won't fix"

----------
resolution:  -> wont fix
stage:  -> committed/rejected
status: open -> closed
type:  -> enhancement

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

From report at bugs.python.org  Sun Mar 30 11:25:42 2014
From: report at bugs.python.org (koobs)
Date: Sun, 30 Mar 2014 09:25:42 +0000
Subject: [docs] [issue21102] 3.4.0 PDF (a4,
	letter) and EPUB documentation missing
Message-ID: <1396171542.11.0.799932081672.issue21102@psf.upfronthosting.co.za>


New submission from koobs:

python-3.4.0-docs-pdf-letter.{zip,tar.bz2}
python-3.4.0-docs-pdf-letter.{zip,tar.bz2}

are missing from:

https://www.python.org/ftp/python/doc/3.4.0/

/current/ also still points to 3.3.x documentation:

https://www.python.org/ftp/python/doc/current/

----------
assignee: docs at python
components: Documentation
messages: 215176
nosy: docs at python, koobs
priority: normal
severity: normal
status: open
title: 3.4.0 PDF (a4,letter) and EPUB documentation missing
versions: Python 3.4

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

From report at bugs.python.org  Sun Mar 30 11:26:47 2014
From: report at bugs.python.org (koobs)
Date: Sun, 30 Mar 2014 09:26:47 +0000
Subject: [docs] [issue21102] 3.4.0 PDF (a4,
	letter) and EPUB documentation missing
In-Reply-To: <1396171542.11.0.799932081672.issue21102@psf.upfronthosting.co.za>
Message-ID: <1396171607.51.0.88082932122.issue21102@psf.upfronthosting.co.za>


koobs added the comment:

Missing files was supposed to read:

python-3.4.0-docs-pdf-a4.{zip,tar.bz2}
python-3.4.0-docs-pdf-letter.{zip,tar.bz2}
python-3.4.0-docs-epub.{zip,tar.bz2}

----------

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

From report at bugs.python.org  Sun Mar 30 16:41:43 2014
From: report at bugs.python.org (Georg Brandl)
Date: Sun, 30 Mar 2014 14:41:43 +0000
Subject: [docs] [issue21102] 3.4.0 PDF (a4,
	letter) and EPUB documentation missing
In-Reply-To: <1396171542.11.0.799932081672.issue21102@psf.upfronthosting.co.za>
Message-ID: <1396190503.89.0.809421045136.issue21102@psf.upfronthosting.co.za>


Georg Brandl added the comment:

Fixed the symlink. Larry, where did you put the other archives?

----------
assignee: docs at python -> larry
nosy: +georg.brandl, larry

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

From report at bugs.python.org  Sun Mar 30 16:52:02 2014
From: report at bugs.python.org (Benjamin Peterson)
Date: Sun, 30 Mar 2014 14:52:02 +0000
Subject: [docs] [issue21102] 3.4.0 PDF (a4,
	letter) and EPUB documentation missing
In-Reply-To: <1396171542.11.0.799932081672.issue21102@psf.upfronthosting.co.za>
Message-ID: <1396191122.31.0.49240315866.issue21102@psf.upfronthosting.co.za>


Benjamin Peterson added the comment:

Added missing docs releases.

----------
nosy: +benjamin.peterson
resolution:  -> fixed
status: open -> closed

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

From report at bugs.python.org  Sun Mar 30 20:15:13 2014
From: report at bugs.python.org (Alex Gaynor)
Date: Sun, 30 Mar 2014 18:15:13 +0000
Subject: [docs] [issue21105] functools.partialmethod example doesn't
	actually work
Message-ID: <1396203313.39.0.663002564911.issue21105@psf.upfronthosting.co.za>


New submission from Alex Gaynor:

Specifically the example at: https://docs.python.org/3/library/functools.html?highlight=functools#functools.partialmethod

``_alive`` isn't actually assigned before the example tries to read it. Running this code at a for-real REPL results in:

>>> class Cell(object):
...     @property
...     def alive(self):
...         return self._alive
...     def set_state(self, state):
...         self._alive = bool(state)
...     import functools
...     set_alive = functools.partialmethod(set_state, True)
...     set_dead = functools.partialmethod(set_state, False)
...
>>> c = Cell()
>>> c.alive
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "<stdin>", line 4, in alive
AttributeError: 'Cell' object has no attribute '_alive'

----------
assignee: docs at python
components: Documentation
keywords: easy
messages: 215191
nosy: alex, docs at python
priority: normal
severity: normal
status: open
title: functools.partialmethod example doesn't actually work
versions: Python 3.4, Python 3.5

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

From report at bugs.python.org  Sun Mar 30 21:07:39 2014
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 30 Mar 2014 19:07:39 +0000
Subject: [docs] [issue21105] functools.partialmethod example doesn't
	actually work
In-Reply-To: <1396203313.39.0.663002564911.issue21105@psf.upfronthosting.co.za>
Message-ID: <3fxmXB3CR1z7LkD@mail.python.org>


Roundup Robot added the comment:

New changeset ed81acc970d9 by Benjamin Peterson in branch '3.4':
make partialmethod example work (closes #21105)
http://hg.python.org/cpython/rev/ed81acc970d9

New changeset b8a76485b5ed by Benjamin Peterson in branch 'default':
merge 3.4 (#21105)
http://hg.python.org/cpython/rev/b8a76485b5ed

----------
nosy: +python-dev
resolution:  -> fixed
stage:  -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Mon Mar 31 06:42:24 2014
From: report at bugs.python.org (Saimadhav Heblikar)
Date: Mon, 31 Mar 2014 04:42:24 +0000
Subject: [docs] [issue21108] Add doc examples for importlib
Message-ID: <1396240944.13.0.279884654032.issue21108@psf.upfronthosting.co.za>


New submission from Saimadhav Heblikar:

The imp module was the defacto module to access the import internals,upto 3.3
It has been deprecated(pending) in 3.4 in favor of importlib.
There are plenty of examples on how to use imp around the web, but very little (even in doc.python.org), on how to use importlib. 

The proposed patch adds couple of examples. These examples are aimed towards people, who were earlier using imp's load_module().

Inspiration for the patch from this SO answer, where user had to go through source code.
http://stackoverflow.com/questions/19009932/import-abitrary-python-source-file-python-3-3

----------
assignee: docs at python
components: Documentation
files: importlib-example.patch
keywords: patch
messages: 215220
nosy: docs at python, sahutd
priority: normal
severity: normal
status: open
title: Add doc examples for importlib
versions: Python 3.4
Added file: http://bugs.python.org/file34675/importlib-example.patch

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

From report at bugs.python.org  Mon Mar 31 06:43:31 2014
From: report at bugs.python.org (Saimadhav Heblikar)
Date: Mon, 31 Mar 2014 04:43:31 +0000
Subject: [docs] [issue21108] Add examples for importlib in doc
In-Reply-To: <1396240944.13.0.279884654032.issue21108@psf.upfronthosting.co.za>
Message-ID: <1396241011.59.0.577345745846.issue21108@psf.upfronthosting.co.za>


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


----------
title: Add doc examples for importlib -> Add examples for importlib in doc

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

From report at bugs.python.org  Mon Mar 31 08:50:24 2014
From: report at bugs.python.org (Ned Deily)
Date: Mon, 31 Mar 2014 06:50:24 +0000
Subject: [docs] [issue21108] Add examples for importlib in doc
In-Reply-To: <1396240944.13.0.279884654032.issue21108@psf.upfronthosting.co.za>
Message-ID: <1396248624.98.0.169730084109.issue21108@psf.upfronthosting.co.za>


Changes by Ned Deily <nad at acm.org>:


----------
nosy: +brett.cannon, eric.snow, ncoghlan

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

From report at bugs.python.org  Mon Mar 31 15:25:21 2014
From: report at bugs.python.org (Eli Bendersky)
Date: Mon, 31 Mar 2014 13:25:21 +0000
Subject: [docs] [issue20375] ElementTree: Document handling processing
	instructions
In-Reply-To: <1390539216.23.0.0362813865609.issue20375@psf.upfronthosting.co.za>
Message-ID: <1396272321.41.0.443480693425.issue20375@psf.upfronthosting.co.za>


Eli Bendersky added the comment:

The patch appears to contain code (tests) along with the documentation. Is this intended? This issue is not tagged properly if it is.

I'd suggest to split them to separate patches.

----------
versions: +Python 3.5 -Python 2.7, Python 3.3, Python 3.4

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

From Jilin.Yang at student.oulu.fi  Mon Mar 31 15:12:26 2014
From: Jilin.Yang at student.oulu.fi (Jilin Yang)
Date: Mon, 31 Mar 2014 13:12:26 +0000
Subject: [docs] [Documentation bug found]
Message-ID: <d342a0446778489b958edf7b82c1e367@DB3PR05MB026.eurprd05.prod.outlook.com>

Url: <https://docs.python.org/2/tutorial/datastructures.html#tuples-and-sequences> https://docs.python.org/2/tutorial/datastructures.html#the-del-statement


Location : First example of 5.2


Description:

Found output after operation "del a[2:4]" is wrong, which should be [-1,1,333,1234.5], not [1,66.25,1234.5] if you type in "a" in python command line afterwards.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140331/13dd5071/attachment.html>

From zachary.ware+pydocs at gmail.com  Mon Mar 31 16:12:20 2014
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Mon, 31 Mar 2014 09:12:20 -0500
Subject: [docs] [Documentation bug found]
In-Reply-To: <d342a0446778489b958edf7b82c1e367@DB3PR05MB026.eurprd05.prod.outlook.com>
References: <d342a0446778489b958edf7b82c1e367@DB3PR05MB026.eurprd05.prod.outlook.com>
Message-ID: <CAKJDb-P5zOMu=6=eQXgWPAwdi6xoDdbgVEWQ9rqvaLveg-_FxA@mail.gmail.com>

Hi,

On Mon, Mar 31, 2014 at 8:12 AM, Jilin Yang <Jilin.Yang at student.oulu.fi> wrote:
> Url:
> https://docs.python.org/2/tutorial/datastructures.html#the-del-statement
>
>
> Location : First example of 5.2
>
>
> Description:
>
> Found output after operation "del a[2:4]" is wrong, which should be
> [-1,1,333,1234.5], not [1,66.25,1234.5] if you type in "a" in python command
> line afterwards.

Thanks for the report!  However, there is no bug here; notice that
before the 'del a[2:4]' operation, there is 'del a[0]', which removes
-1 from the beginning of ``a`` and leaves [1, 66.25, 333, 333,
1234.5].  At that point, a[2:4] == [333, 333], and deleting a[2:4]
leaves [1, 66.25, 1234.5] as shown in the documentation.

Hope this clears things up,
-- 
Zach

From report at bugs.python.org  Mon Mar 31 17:54:09 2014
From: report at bugs.python.org (Brett Cannon)
Date: Mon, 31 Mar 2014 15:54:09 +0000
Subject: [docs] [issue21108] Add examples for importlib in doc
In-Reply-To: <1396240944.13.0.279884654032.issue21108@psf.upfronthosting.co.za>
Message-ID: <1396281249.37.0.865129120199.issue21108@psf.upfronthosting.co.za>


Brett Cannon added the comment:

While I'm totally happy to add examples on usage, it is probably best to put them at the end of the class-level docs instead of trailing after the last method of the class. That way someone reading about what the class does can also see examples of how to use it.

Another point is that SourceFileLoader.load_module() is documented as deprecated as of Python 3.4 and so promoting it in an example is not good. Now that module creation has been broken out separately this "create a module from a file path" approach is becoming more and more difficult. If we care to continue to support this use case we will probably need to come up with a function(s) to make it easier and toss something up on PyPI that is Python 2.7-3.5 compatible.

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

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

From Jilin.Yang at student.oulu.fi  Mon Mar 31 16:50:29 2014
From: Jilin.Yang at student.oulu.fi (Jilin Yang)
Date: Mon, 31 Mar 2014 14:50:29 +0000
Subject: [docs] [Documentation bug found]
In-Reply-To: <CAKJDb-P5zOMu=6=eQXgWPAwdi6xoDdbgVEWQ9rqvaLveg-_FxA@mail.gmail.com>
References: <d342a0446778489b958edf7b82c1e367@DB3PR05MB026.eurprd05.prod.outlook.com>,
 <CAKJDb-P5zOMu=6=eQXgWPAwdi6xoDdbgVEWQ9rqvaLveg-_FxA@mail.gmail.com>
Message-ID: <b4b98930b5cc4a1394618c6cd3d103ee@DB3PR05MB026.eurprd05.prod.outlook.com>

Hi
That's really stupid of me. Anyway, thanks your reply and I got to say, it's real fast!

Sent from my Windows Phone
________________________________
From: Zachary Ware<mailto:zachary.ware+pydocs at gmail.com>
Sent: ?3/?31/?2014 17:12
To: docs at python.org<mailto:docs at python.org>
Cc: Jilin Yang<mailto:Jilin.Yang at student.oulu.fi>
Subject: Re: [docs] [Documentation bug found]

Hi,

On Mon, Mar 31, 2014 at 8:12 AM, Jilin Yang <Jilin.Yang at student.oulu.fi> wrote:
> Url:
> https://docs.python.org/2/tutorial/datastructures.html#the-del-statement
>
>
> Location : First example of 5.2
>
>
> Description:
>
> Found output after operation "del a[2:4]" is wrong, which should be
> [-1,1,333,1234.5], not [1,66.25,1234.5] if you type in "a" in python command
> line afterwards.

Thanks for the report!  However, there is no bug here; notice that
before the 'del a[2:4]' operation, there is 'del a[0]', which removes
-1 from the beginning of ``a`` and leaves [1, 66.25, 333, 333,
1234.5].  At that point, a[2:4] == [333, 333], and deleting a[2:4]
leaves [1, 66.25, 1234.5] as shown in the documentation.

Hope this clears things up,
--
Zach
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140331/ba545322/attachment-0001.html>

From zachary.ware+pydocs at gmail.com  Mon Mar 31 18:25:59 2014
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Mon, 31 Mar 2014 11:25:59 -0500
Subject: [docs] [Documentation bug found]
In-Reply-To: <b4b98930b5cc4a1394618c6cd3d103ee@DB3PR05MB026.eurprd05.prod.outlook.com>
References: <d342a0446778489b958edf7b82c1e367@DB3PR05MB026.eurprd05.prod.outlook.com>
 <CAKJDb-P5zOMu=6=eQXgWPAwdi6xoDdbgVEWQ9rqvaLveg-_FxA@mail.gmail.com>
 <b4b98930b5cc4a1394618c6cd3d103ee@DB3PR05MB026.eurprd05.prod.outlook.com>
Message-ID: <CAKJDb-PJ73OAQrYhibpAe31zcgtHe0o2AJ249W3Rj-QoiX-vzg@mail.gmail.com>

On Mon, Mar 31, 2014 at 9:50 AM, Jilin Yang <Jilin.Yang at student.oulu.fi> wrote:
> Hi
> That's really stupid of me. Anyway, thanks your reply and I got to say, it's
> real fast!

Don't worry, everybody misses something sometime :).  I'm glad I could
clear things up for you.

Regards,
--
Zach

From report at bugs.python.org  Mon Mar 31 18:37:57 2014
From: report at bugs.python.org (Nikolaus Rath)
Date: Mon, 31 Mar 2014 16:37:57 +0000
Subject: [docs] [issue20375] ElementTree: Document handling processing
	instructions
In-Reply-To: <1390539216.23.0.0362813865609.issue20375@psf.upfronthosting.co.za>
Message-ID: <1396283877.11.0.356114317916.issue20375@psf.upfronthosting.co.za>


Nikolaus Rath added the comment:

Yes, the new testcases were deliberately included. I submitted the patch prior to the 3.4 release, am I right that at that point this wouldn't have been a problem?

I have attached a new patch containing just the doc changes. I hope that's still acceptable for inclusion in 3.4 (and maybe 3.3? not sure if there'll be another bugfix release).

----------
versions: +Python 3.4
Added file: http://bugs.python.org/file34683/issue20375.diff

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