From report at bugs.python.org  Tue Apr  1 17:36:16 2014
From: report at bugs.python.org (Glenn Maynard)
Date: Tue, 01 Apr 2014 15:36:16 +0000
Subject: [docs] [issue21125] traceback.extract_tb says "quadruple" when it
	means	"tuple"
Message-ID: <1396366576.76.0.132198557562.issue21125@psf.upfronthosting.co.za>


New submission from Glenn Maynard:

https://docs.python.org/2/library/traceback.html

"A ?pre-processed? stack trace entry is a quadruple (filename, line number, function name, text) representing the information that is usually printed for a stack trace."

There's no such thing as a "quadruple".  This should be "tuple".

----------
assignee: docs at python
components: Documentation
messages: 215326
nosy: Glenn.Maynard, docs at python
priority: normal
severity: normal
status: open
title: traceback.extract_tb says "quadruple" when it means "tuple"

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

From report at bugs.python.org  Tue Apr  1 18:02:28 2014
From: report at bugs.python.org (R. David Murray)
Date: Tue, 01 Apr 2014 16:02:28 +0000
Subject: [docs] [issue21125] traceback.extract_tb says "quadruple" when it
	means	"tuple"
In-Reply-To: <1396366576.76.0.132198557562.issue21125@psf.upfronthosting.co.za>
Message-ID: <1396368148.28.0.800262190439.issue21125@psf.upfronthosting.co.za>


R. David Murray added the comment:

A google for quadruple got me wikipedia as the first hit, with this as the match text:

    "Quadruple may refer to: A 4-tuple, ..."

So, it's tech-speak.  The alternative would be to say either "a 4-tuple" or "a tuple of four elements".  I'm fine with someone making that change, but I don't think it is terrible that the word is used the way it is.

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

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

From report at bugs.python.org  Tue Apr  1 19:23:02 2014
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 01 Apr 2014 17:23:02 +0000
Subject: [docs] [issue15067] Clean up the sqlite3 docs
In-Reply-To: <1339687148.5.0.0456329910944.issue15067@psf.upfronthosting.co.za>
Message-ID: <3fyy6Y3VNyz7LjT@mail.python.org>


Roundup Robot added the comment:

New changeset 2e13f0d49b8e by Zachary Ware in branch '2.7':
Issue #15067: Remove reference to a rejected PEP.
http://hg.python.org/cpython/rev/2e13f0d49b8e

New changeset 4a2dabac976d by Zachary Ware in branch '3.4':
Issue #15067: Port 2.7 sqlite3 docs to 3.4
http://hg.python.org/cpython/rev/4a2dabac976d

New changeset 2c7ebb930b64 by Zachary Ware in branch 'default':
Closes #15067: Merge port of 2.7 sqlite3 docs.
http://hg.python.org/cpython/rev/2c7ebb930b64

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

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

From report at bugs.python.org  Wed Apr  2 07:07:33 2014
From: report at bugs.python.org (Raymond Hettinger)
Date: Wed, 02 Apr 2014 05:07:33 +0000
Subject: [docs] [issue21125] traceback.extract_tb says "quadruple" when it
	means	"tuple"
In-Reply-To: <1396366576.76.0.132198557562.issue21125@psf.upfronthosting.co.za>
Message-ID: <1396415253.51.0.242171628735.issue21125@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

I'll make the change to 4-tuple.

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

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

From report at bugs.python.org  Wed Apr  2 07:11:44 2014
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 02 Apr 2014 05:11:44 +0000
Subject: [docs] [issue21125] traceback.extract_tb says "quadruple" when it
	means	"tuple"
In-Reply-To: <1396366576.76.0.132198557562.issue21125@psf.upfronthosting.co.za>
Message-ID: <3fzFrH3ZZDz7Lk7@mail.python.org>


Roundup Robot added the comment:

New changeset 1c112eb4eb56 by Raymond Hettinger in branch '2.7':
Issue 21125: minor wording tweak.
http://hg.python.org/cpython/rev/1c112eb4eb56

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

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

From report at bugs.python.org  Wed Apr  2 07:18:13 2014
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 02 Apr 2014 05:18:13 +0000
Subject: [docs] [issue21125] traceback.extract_tb says "quadruple" when it
	means	"tuple"
In-Reply-To: <1396366576.76.0.132198557562.issue21125@psf.upfronthosting.co.za>
Message-ID: <3fzFzm5qVnz7LjW@mail.python.org>


Roundup Robot added the comment:

New changeset dfa399e74fcf by Raymond Hettinger in branch '3.4':
Issue 21125: minor documentation tweak.
http://hg.python.org/cpython/rev/dfa399e74fcf

----------

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

From report at bugs.python.org  Wed Apr  2 07:19:11 2014
From: report at bugs.python.org (Raymond Hettinger)
Date: Wed, 02 Apr 2014 05:19:11 +0000
Subject: [docs] [issue21125] traceback.extract_tb says "quadruple" when it
	means	"tuple"
In-Reply-To: <1396366576.76.0.132198557562.issue21125@psf.upfronthosting.co.za>
Message-ID: <1396415950.91.0.316796789439.issue21125@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

Thanks for the bug report, Glenn.

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

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

From eliben at gmail.com  Wed Apr  2 15:26:31 2014
From: eliben at gmail.com (eliben at gmail.com)
Date: Wed, 02 Apr 2014 13:26:31 -0000
Subject: [docs] ElementTree: Document handling processing instructions
	(issue 20375)
Message-ID: <20140402132631.1816.85054@psf.upfronthosting.co.za>


http://bugs.python.org/review/20375/diff/11483/Doc/library/xml.etree.elementtree.rst
File Doc/library/xml.etree.elementtree.rst (right):

http://bugs.python.org/review/20375/diff/11483/Doc/library/xml.etree.elementtree.rst#newcode114
Doc/library/xml.etree.elementtree.rst:114: input. Processing
instructions and comments can nevertheless be
I think this could be made clearer. Something like "trees built using
this module's API rather than parsing from XML test can have comments
and processing instructions in them, and are included...."

http://bugs.python.org/review/20375/diff/11483/Doc/library/xml.etree.elementtree.rst#newcode396
Doc/library/xml.etree.elementtree.rst:396: Note that the element tree
XML parser skips over comments in the
Replace "the element tree XML parser" with a properly ReST-linked
"ElementTree", as done elsewhere in the document.

http://bugs.python.org/review/20375/diff/11483/Doc/library/xml.etree.elementtree.rst#newcode399
Doc/library/xml.etree.elementtree.rst:399: into to the tree using
:meth:`~Element.insert`,
I don't think this listing is necessary - there are many ways to create
new Element nodes...

http://bugs.python.org/review/20375/diff/11483/Doc/library/xml.etree.elementtree.rst#newcode483
Doc/library/xml.etree.elementtree.rst:483: instructions in the input
instead of creating objects for them. An
same comments here as for the previous block.

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

From report at bugs.python.org  Wed Apr  2 15:27:23 2014
From: report at bugs.python.org (Eli Bendersky)
Date: Wed, 02 Apr 2014 13:27:23 +0000
Subject: [docs] [issue20375] ElementTree: Document handling processing
	instructions
In-Reply-To: <1390539216.23.0.0362813865609.issue20375@psf.upfronthosting.co.za>
Message-ID: <1396445243.38.0.173826350487.issue20375@psf.upfronthosting.co.za>


Eli Bendersky added the comment:

I left some comments in Rietveld.

There shouldn't be a problem getting these into 3.4 too - doc changes are usually excempt from most restrictions.

----------

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

From report at bugs.python.org  Wed Apr  2 19:45:31 2014
From: report at bugs.python.org (Tshepang Lekhonkhobe)
Date: Wed, 02 Apr 2014 17:45:31 +0000
Subject: [docs] [issue21034] Python docs reference the Distribute package
	which has	been deprecated in favor of Setuptools
In-Reply-To: <1395564519.98.0.0028723182567.issue21034@psf.upfronthosting.co.za>
Message-ID: <1396460731.97.0.139667561629.issue21034@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/issue21034>
_______________________________________

From report at bugs.python.org  Thu Apr  3 03:46:36 2014
From: report at bugs.python.org (Nikolaus Rath)
Date: Thu, 03 Apr 2014 01:46:36 +0000
Subject: [docs] [issue20375] ElementTree: Document handling processing
	instructions
In-Reply-To: <1390539216.23.0.0362813865609.issue20375@psf.upfronthosting.co.za>
Message-ID: <1396489595.95.0.60932034769.issue20375@psf.upfronthosting.co.za>


Nikolaus Rath added the comment:

Thanks for your feedback! I've attached an updated patch.

----------
Added file: http://bugs.python.org/file34708/issue20375.diff

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

From report at bugs.python.org  Thu Apr  3 03:58:58 2014
From: report at bugs.python.org (Nikolaus Rath)
Date: Thu, 03 Apr 2014 01:58:58 +0000
Subject: [docs] [issue20375] ElementTree: Document handling processing
	instructions
In-Reply-To: <1390539216.23.0.0362813865609.issue20375@psf.upfronthosting.co.za>
Message-ID: <1396490338.76.0.917524529018.issue20375@psf.upfronthosting.co.za>


Changes by Nikolaus Rath <Nikolaus at rath.org>:


Added file: http://bugs.python.org/file34709/issue20375.diff

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

From Nikolaus at rath.org  Thu Apr  3 03:45:47 2014
From: Nikolaus at rath.org (Nikolaus at rath.org)
Date: Thu, 03 Apr 2014 01:45:47 -0000
Subject: [docs] ElementTree: Document handling processing instructions
	(issue 20375)
Message-ID: <20140403014547.1816.39257@psf.upfronthosting.co.za>

Thanks for your feedback! I've attached an updated patch.


http://bugs.python.org/review/20375/diff/11483/Doc/library/xml.etree.elementtree.rst
File Doc/library/xml.etree.elementtree.rst (right):

http://bugs.python.org/review/20375/diff/11483/Doc/library/xml.etree.elementtree.rst#newcode114
Doc/library/xml.etree.elementtree.rst:114: input. Processing
instructions and comments can nevertheless be
On 2014/04/02 15:26:31, eli.bendersky wrote:
> I think this could be made clearer. Something like "trees built using
this
> module's API rather than parsing from XML test can have comments and
processing
> instructions in them, and are included...."
> 

Done.

http://bugs.python.org/review/20375/diff/11483/Doc/library/xml.etree.elementtree.rst#newcode396
Doc/library/xml.etree.elementtree.rst:396: Note that the element tree
XML parser skips over comments in the
On 2014/04/02 15:26:31, eli.bendersky wrote:
> Replace "the element tree XML parser" with a properly ReST-linked
"ElementTree",
> as done elsewhere in the document.

Done.

http://bugs.python.org/review/20375/diff/11483/Doc/library/xml.etree.elementtree.rst#newcode399
Doc/library/xml.etree.elementtree.rst:399: into to the tree using
:meth:`~Element.insert`,
On 2014/04/02 15:26:31, eli.bendersky wrote:
> I don't think this listing is necessary - there are many ways to
create new
> Element nodes...

Done.

http://bugs.python.org/review/20375/diff/11483/Doc/library/xml.etree.elementtree.rst#newcode483
Doc/library/xml.etree.elementtree.rst:483: instructions in the input
instead of creating objects for them. An
On 2014/04/02 15:26:31, eli.bendersky wrote:
> same comments here as for the previous block.

Done.

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

From report at bugs.python.org  Thu Apr  3 11:54:45 2014
From: report at bugs.python.org (Jyrki Pulliainen)
Date: Thu, 03 Apr 2014 09:54:45 +0000
Subject: [docs] [issue21143] Copy-paste error in documentation of
	__builtin__.max
Message-ID: <1396518885.59.0.164691798901.issue21143@psf.upfronthosting.co.za>


New submission from Jyrki Pulliainen:

Looks like the documentation of the __builtin__.max() got copied over from the __builtin__.min.

Instead of "the smallest of the positional arguments" it should say "the largest of the positional arguments".

This was introduced in 3.4. Patch attached.

Thanks to chiman@#python.fi for spotting this!

----------
assignee: docs at python
components: Documentation
files: fix-typo-in-max.patch
keywords: patch
messages: 215434
nosy: docs at python, nailor
priority: normal
severity: normal
status: open
title: Copy-paste error in documentation of __builtin__.max
versions: Python 3.4, Python 3.5
Added file: http://bugs.python.org/file34712/fix-typo-in-max.patch

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

From report at bugs.python.org  Thu Apr  3 11:57:57 2014
From: report at bugs.python.org (Berker Peksag)
Date: Thu, 03 Apr 2014 09:57:57 +0000
Subject: [docs] [issue21143] Copy-paste error in documentation of
	__builtin__.max
In-Reply-To: <1396518885.59.0.164691798901.issue21143@psf.upfronthosting.co.za>
Message-ID: <1396519077.72.0.687265714084.issue21143@psf.upfronthosting.co.za>


Berker Peksag added the comment:

I also fixed this as part of issue 20620.

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

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

From report at bugs.python.org  Thu Apr  3 12:40:06 2014
From: report at bugs.python.org (Wolfgang Maier)
Date: Thu, 03 Apr 2014 10:40:06 +0000
Subject: [docs] [issue21146] update gzip usage examples in docs
Message-ID: <1396521606.53.0.161098821761.issue21146@psf.upfronthosting.co.za>


New submission from Wolfgang Maier:

The current documentation of the gzip module should have its section "12.2.1. Examples of usage" updated to reflect the changes made to the module in Python3.2 (https://docs.python.org/3.2/whatsnew/3.2.html#gzip-and-zipfile).

Currently, the recipe given for gz-compressing a file is:

import gzip
with open('/home/joe/file.txt', 'rb') as f_in:
    with gzip.open('/home/joe/file.txt.gz', 'wb') as f_out:
        f_out.writelines(f_in)

which is clearly sub-optimal because it is line-based.

An equally simple, but more efficient recipe would be:

chunk_size = 1024
with open('/home/joe/file.txt', 'rb') as f_in:
    with gzip.open('/home/joe/file.txt.gz', 'wb') as f_out:
        while True:
            c = f_in.read(chunk_size)
            if not c: break
            d = f_out.write(c)

Comparing the two examples I find a >= 2x performance gain (both in terms of CPU time and wall time).

In the inverse scenario of file *de*-compression (which is not part of the docs though), the performance increase of substituting:

with gzip.open('/home/joe/file.txt.gz', 'rb') as f_in:
    with open('/home/joe/file.txt', 'wb') as f_out:
        f_out.writelines(f_in)

with:

with gzip.open('/home/joe/file.txt.gz', 'rb') as f_in:
    with open('/home/joe/file.txt', 'wb') as f_out:
        while True:
            c = f_in.read(chunk_size)
            if not c: break
            d = f_out.write(c)

is even higher (4-5x speed-ups).

In the de-compression case, another >= 2x speed-up can be achieved by avoiding the gzip module completely and going through a zlib.decompressobj instead, but of course this is a bit more complicated and should be documented in the zlib docs rather than the gzip docs (if you're interested, I could provide my code for it though).
Using the zlib library compression/decompression speed gets comparable to linux gzip/gunzip.

----------
assignee: docs at python
components: Documentation
messages: 215440
nosy: docs at python, wolma
priority: normal
severity: normal
status: open
title: update gzip usage examples in docs
type: performance
versions: Python 3.2, Python 3.3, Python 3.4

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

From report at bugs.python.org  Thu Apr  3 13:57:06 2014
From: report at bugs.python.org (INADA Naoki)
Date: Thu, 03 Apr 2014 11:57:06 +0000
Subject: [docs] [issue21146] update gzip usage examples in docs
In-Reply-To: <1396521606.53.0.161098821761.issue21146@psf.upfronthosting.co.za>
Message-ID: <1396526226.27.0.54006365625.issue21146@psf.upfronthosting.co.za>


INADA Naoki added the comment:

Maybe, shutil.copyfileobj() is good.

import gzip
import shutil

with open(src, 'rb') as f_in:
    with gzip.open(dst, 'wb') as f_out:
        shutil.copyfileobj(f_in, f_out)

----------
nosy: +naoki

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

From report at bugs.python.org  Thu Apr  3 14:44:39 2014
From: report at bugs.python.org (Wolfgang Maier)
Date: Thu, 03 Apr 2014 12:44:39 +0000
Subject: [docs] [issue21146] update gzip usage examples in docs
In-Reply-To: <1396521606.53.0.161098821761.issue21146@psf.upfronthosting.co.za>
Message-ID: <1396529079.15.0.147890465893.issue21146@psf.upfronthosting.co.za>


Wolfgang Maier added the comment:

>> with open(src, 'rb') as f_in:
>>     with gzip.open(dst, 'wb') as f_out:
>>        shutil.copyfileobj(f_in, f_out)

+1 !!
exactly as fast as my suggestion (with compression and de-compression), but a lot clearer !
Hadn't thought of it.

----------

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

From report at bugs.python.org  Thu Apr  3 14:50:40 2014
From: report at bugs.python.org (Wolfgang Maier)
Date: Thu, 03 Apr 2014 12:50:40 +0000
Subject: [docs] [issue21146] update gzip usage examples in docs
In-Reply-To: <1396521606.53.0.161098821761.issue21146@psf.upfronthosting.co.za>
Message-ID: <1396529440.86.0.581260801454.issue21146@psf.upfronthosting.co.za>


Wolfgang Maier added the comment:

same speed is not surprising though as shutil.copyfileobj is implemented like this:

def copyfileobj(fsrc, fdst, length=16*1024):
    """copy data from file-like object fsrc to file-like object fdst"""
    while 1:
        buf = fsrc.read(length)
        if not buf:
            break
        fdst.write(buf)

which is essentially what I was proposing :)

----------

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

From report at bugs.python.org  Thu Apr  3 15:15:29 2014
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 03 Apr 2014 13:15:29 +0000
Subject: [docs] [issue20375] ElementTree: Document handling processing
	instructions
In-Reply-To: <1390539216.23.0.0362813865609.issue20375@psf.upfronthosting.co.za>
Message-ID: <3g04X00STGzQPC@mail.python.org>


Roundup Robot added the comment:

New changeset 871278b87c62 by Eli Bendersky in branch '3.4':
Issue #20375: Clarify ET's parsing of comments and processing instructions.
http://hg.python.org/cpython/rev/871278b87c62

New changeset 5c3166ec80e1 by Eli Bendersky in branch 'default':
Issue #20375: Clarify ET's parsing of comments and processing instructions.
http://hg.python.org/cpython/rev/5c3166ec80e1

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

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

From report at bugs.python.org  Thu Apr  3 15:16:19 2014
From: report at bugs.python.org (Eli Bendersky)
Date: Thu, 03 Apr 2014 13:16:19 +0000
Subject: [docs] [issue20375] ElementTree: Document handling processing
	instructions
In-Reply-To: <1390539216.23.0.0362813865609.issue20375@psf.upfronthosting.co.za>
Message-ID: <1396530979.26.0.370811004256.issue20375@psf.upfronthosting.co.za>


Eli Bendersky added the comment:

Thanks. Doc patch committed with some slight rewording.

Would you like to prepare a separate patch for the tests, default branch only this time?

----------
versions:  -Python 3.4

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

From report at bugs.python.org  Thu Apr  3 16:19:04 2014
From: report at bugs.python.org (Benjamin Peterson)
Date: Thu, 03 Apr 2014 14:19:04 +0000
Subject: [docs] [issue21034] Python docs reference the Distribute package
	which has	been deprecated in favor of Setuptools
In-Reply-To: <1395564519.98.0.0028723182567.issue21034@psf.upfronthosting.co.za>
Message-ID: <1396534744.64.0.369882999089.issue21034@psf.upfronthosting.co.za>


Benjamin Peterson added the comment:

Good point. Perhaps we should reccomend https://raw.github.com/pypa/pip/master/contrib/get-pip.py instead, though?

----------
nosy: +benjamin.peterson

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

From report at bugs.python.org  Thu Apr  3 17:01:52 2014
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 03 Apr 2014 15:01:52 +0000
Subject: [docs] [issue21143] Copy-paste error in documentation of
	__builtin__.max
In-Reply-To: <1396518885.59.0.164691798901.issue21143@psf.upfronthosting.co.za>
Message-ID: <3g06tl5jVqz7Ljj@mail.python.org>


Roundup Robot added the comment:

New changeset 8fe2bb0c5851 by Raymond Hettinger in branch '3.4':
Issue 21143: Fix typo in docs for max().
http://hg.python.org/cpython/rev/8fe2bb0c5851

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

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

From report at bugs.python.org  Thu Apr  3 17:02:20 2014
From: report at bugs.python.org (Raymond Hettinger)
Date: Thu, 03 Apr 2014 15:02:20 +0000
Subject: [docs] [issue21143] Copy-paste error in documentation of
	__builtin__.max
In-Reply-To: <1396518885.59.0.164691798901.issue21143@psf.upfronthosting.co.za>
Message-ID: <1396537340.28.0.683208891883.issue21143@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

Thanks for the report.

----------
nosy: +rhettinger
resolution:  -> fixed
status: open -> closed

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

From report at bugs.python.org  Thu Apr  3 18:13:38 2014
From: report at bugs.python.org (=?utf-8?q?Jurko_Gospodneti=C4=87?=)
Date: Thu, 03 Apr 2014 16:13:38 +0000
Subject: [docs] [issue21034] Python docs reference the Distribute package
	which has	been deprecated in favor of Setuptools
In-Reply-To: <1395564519.98.0.0028723182567.issue21034@psf.upfronthosting.co.za>
Message-ID: <1396541618.35.0.465984316861.issue21034@psf.upfronthosting.co.za>


Jurko Gospodneti? added the comment:

Or, if you do not want to get into the specifics of how
to manually install setuptools/pip, it would probably be
better to just refer the user to the 'ensurepip' module
for the initial installation and tell him to upgrade
whatever is needed from there without going in to any
further details here.

'ensurepip' module itself is documented elsewhere (https://docs.python.org/3.4/library/ensurepip.html),
and that documentation should perhaps be updated to
include enough information (or references to external
documentation containing that information) for the
user to be able to perform the upgrades.

Best regards,
  Jurko Gospodneti?

----------

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

From oxhazaroglu at ualr.edu  Thu Apr  3 19:13:47 2014
From: oxhazaroglu at ualr.edu (Onder Hazaroglu)
Date: Thu, 3 Apr 2014 12:13:47 -0500
Subject: [docs] threading
Message-ID: <CAChsEZQqhrp1TGjKow=o3ht9i2EcTMH9sTeZUCd6-ty+5-dMqQ@mail.gmail.com>

Hello,
I've been using threading library to run some experiments parallel. There
is no message passing between my threads but still it messes up somehow.
The results are different than running it separated. Basically I experiment
with three threads working on three different files but the results are
different than running three of them sequentially. Is there a way to make
sure that there is no memory sharing between threads?

-- 
Best Regards,

Onder HAZAROGLU | Graduate Student | Ph.D. Candidate
University of Arkansas at Little Rock | Computer Science Department
EIT Bldg. | (501) 615-3851 | oxhazaroglu at ualr.edu, onderhazaroglu at gmail.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140403/7d09cd83/attachment.html>

From zachary.ware+pydocs at gmail.com  Thu Apr  3 21:10:30 2014
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Thu, 3 Apr 2014 14:10:30 -0500
Subject: [docs] threading
In-Reply-To: <CAChsEZQqhrp1TGjKow=o3ht9i2EcTMH9sTeZUCd6-ty+5-dMqQ@mail.gmail.com>
References: <CAChsEZQqhrp1TGjKow=o3ht9i2EcTMH9sTeZUCd6-ty+5-dMqQ@mail.gmail.com>
Message-ID: <CAKJDb-O_-h+mw4nQK5xL6CECZ4wnH3uMt7mWvJ06JuJgoYniXA@mail.gmail.com>

Hi Onder,

On Thu, Apr 3, 2014 at 12:13 PM, Onder Hazaroglu <oxhazaroglu at ualr.edu> wrote:
> Hello,
> I've been using threading library to run some experiments parallel. There is
> no message passing between my threads but still it messes up somehow. The
> results are different than running it separated. Basically I experiment with
> three threads working on three different files but the results are different
> than running three of them sequentially. Is there a way to make sure that
> there is no memory sharing between threads?

This list is not the correct place to ask this kind of question; it is
meant for discussion of the Python documentation.  You may have better
luck asking your question on python-list (python-list at python.org).

Regards,
-- 
Zach

From report at bugs.python.org  Thu Apr  3 21:21:57 2014
From: report at bugs.python.org (Ned Deily)
Date: Thu, 03 Apr 2014 19:21:57 +0000
Subject: [docs] [issue21034] Python docs reference the Distribute package
	which has	been deprecated in favor of Setuptools
In-Reply-To: <1395564519.98.0.0028723182567.issue21034@psf.upfronthosting.co.za>
Message-ID: <1396552917.03.0.418053977898.issue21034@psf.upfronthosting.co.za>


Changes by Ned Deily <nad at acm.org>:


----------
nosy: +ncoghlan

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

From report at bugs.python.org  Thu Apr  3 22:19:02 2014
From: report at bugs.python.org (Nikolaus Rath)
Date: Thu, 03 Apr 2014 20:19:02 +0000
Subject: [docs] [issue20375] ElementTree: Document handling processing
	instructions
In-Reply-To: <1390539216.23.0.0362813865609.issue20375@psf.upfronthosting.co.za>
Message-ID: <1396556342.73.0.498414755914.issue20375@psf.upfronthosting.co.za>


Nikolaus Rath added the comment:

Thanks for the commit!

My intention is to fix the behavior itself for 3.5 (see issue 9521), so I think adding testcases for the old behavior in the meantime isn't necessary.

----------

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

From report at bugs.python.org  Thu Apr  3 22:47:15 2014
From: report at bugs.python.org (Raymond Hettinger)
Date: Thu, 03 Apr 2014 20:47:15 +0000
Subject: [docs] [issue21150] Add quick links table to argparse docs
Message-ID: <1396558035.28.0.485991636726.issue21150@psf.upfronthosting.co.za>


New submission from Raymond Hettinger:

The argparse module has many functions and options.

It would benefit from a summary and quick links table at the top of the page just like we have for the itertools module docs and the builtins module docs.

----------
assignee: docs at python
components: Documentation
keywords: easy
messages: 215468
nosy: docs at python, rhettinger
priority: normal
severity: normal
stage: needs patch
status: open
title: Add quick links table to argparse docs
versions: Python 3.5

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

From report at bugs.python.org  Thu Apr  3 23:39:15 2014
From: report at bugs.python.org (Eli Bendersky)
Date: Thu, 03 Apr 2014 21:39:15 +0000
Subject: [docs] [issue20375] ElementTree: Document handling processing
	instructions
In-Reply-To: <1396556342.73.0.498414755914.issue20375@psf.upfronthosting.co.za>
Message-ID: <CAF-Rda-GQKiS1Vug2Dg+0iZ6shCsKDpKmAvWTZdoubphNLnQpA@mail.gmail.com>


Eli Bendersky added the comment:

On Thu, Apr 3, 2014 at 1:19 PM, Nikolaus Rath <report at bugs.python.org>wrote:

>
> Nikolaus Rath added the comment:
>
> Thanks for the commit!
>
> My intention is to fix the behavior itself for 3.5 (see issue 9521), so I
> think adding testcases for the old behavior in the meantime isn't necessary.
>

Fair enough. So you can close this issue, then.

----------

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

From report at bugs.python.org  Fri Apr  4 02:05:10 2014
From: report at bugs.python.org (Nikolaus Rath)
Date: Fri, 04 Apr 2014 00:05:10 +0000
Subject: [docs] [issue20375] ElementTree: Document handling processing
	instructions
In-Reply-To: <1390539216.23.0.0362813865609.issue20375@psf.upfronthosting.co.za>
Message-ID: <1396569910.56.0.740850638993.issue20375@psf.upfronthosting.co.za>


Changes by Nikolaus Rath <Nikolaus at rath.org>:


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

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

From report at bugs.python.org  Fri Apr  4 08:34:34 2014
From: report at bugs.python.org (Christian Clauss)
Date: Fri, 04 Apr 2014 06:34:34 +0000
Subject: [docs] [issue20969] Author of EPUB version of Python docs is set to
	Unknown	instead of PSF
In-Reply-To: <1395153249.12.0.327856107433.issue20969@psf.upfronthosting.co.za>
Message-ID: <1396593274.18.0.674979582544.issue20969@psf.upfronthosting.co.za>


Christian Clauss added the comment:

Makefile and make.bat in https://github.com/python/pythondotorg/blob/master/docs are NOT the correct files to modify.  It is unclear to where the correct files are.

----------

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

From report at bugs.python.org  Fri Apr  4 09:01:28 2014
From: report at bugs.python.org (Berker Peksag)
Date: Fri, 04 Apr 2014 07:01:28 +0000
Subject: [docs] [issue20375] ElementTree: Document handling processing
	instructions
In-Reply-To: <1390539216.23.0.0362813865609.issue20375@psf.upfronthosting.co.za>
Message-ID: <1396594888.77.0.505907332185.issue20375@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/issue20375>
_______________________________________

From report at bugs.python.org  Fri Apr  4 11:37:12 2014
From: report at bugs.python.org (Antoine Pitrou)
Date: Fri, 04 Apr 2014 09:37:12 +0000
Subject: [docs] [issue20969] Author of EPUB version of Python docs is set to
	Unknown	instead of PSF
In-Reply-To: <1395153249.12.0.327856107433.issue20969@psf.upfronthosting.co.za>
Message-ID: <1396604232.56.0.223321385502.issue20969@psf.upfronthosting.co.za>


Antoine Pitrou added the comment:

The PSF is not the author of the docs. Perhaps something like "Python documentation authors".

----------
nosy: +pitrou

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

From report at bugs.python.org  Fri Apr  4 15:00:04 2014
From: report at bugs.python.org (Armin Rigo)
Date: Fri, 04 Apr 2014 13:00:04 +0000
Subject: [docs] [issue21154] Small fix in 2.7.6 lang ref
Message-ID: <1396616403.97.0.334401802689.issue21154@psf.upfronthosting.co.za>


New submission from Armin Rigo:

The docs still say that the default __hash__() is equal to id(), but that's not the case since Python 2.7.

----------
assignee: docs at python
components: Documentation
files: lang-ref-fix.diff
keywords: patch
messages: 215517
nosy: arigo, docs at python
priority: normal
severity: normal
status: open
title: Small fix in 2.7.6 lang ref
versions: Python 2.7
Added file: http://bugs.python.org/file34723/lang-ref-fix.diff

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

From report at bugs.python.org  Fri Apr  4 15:59:56 2014
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 04 Apr 2014 13:59:56 +0000
Subject: [docs] [issue21154] Small fix in 2.7.6 lang ref
In-Reply-To: <1396616403.97.0.334401802689.issue21154@psf.upfronthosting.co.za>
Message-ID: <3g0jSq3ShpzT1f@mail.python.org>


Roundup Robot added the comment:

New changeset 6809b434752a by Benjamin Peterson in branch '2.7':
note that the hash of an arbitrary object is only derived from its address (closes #21154)
http://hg.python.org/cpython/rev/6809b434752a

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

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

From report at bugs.python.org  Fri Apr  4 16:20:42 2014
From: report at bugs.python.org (Georg Brandl)
Date: Fri, 04 Apr 2014 14:20:42 +0000
Subject: [docs] [issue20969] Author of EPUB version of Python docs is set to
	Unknown	instead of PSF
In-Reply-To: <1395153249.12.0.327856107433.issue20969@psf.upfronthosting.co.za>
Message-ID: <1396621242.37.0.201302797789.issue20969@psf.upfronthosting.co.za>


Georg Brandl added the comment:

The repository is http://hg.python.org/cpython.

If you make a patch, please set the appropriate values in Doc/conf.py, not the makefiles.

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

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

From report at bugs.python.org  Fri Apr  4 17:23:44 2014
From: report at bugs.python.org (Hanxue Lee)
Date: Fri, 04 Apr 2014 15:23:44 +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: <1396625024.64.0.99706187276.issue10976@psf.upfronthosting.co.za>


Hanxue Lee added the comment:

This seems to be an issue (bug?) for Python 3.3 When calling json.loads() with a byte array, this is the error

json.loads(response.data, 'latin-1')

TypeError: can't use a string pattern on a bytes-like object


When I decode the byte array to string

json.loads(response.data.decode(), 'latin-1')

I get this error

TypeError: bytes or integer address expected instead of str instance

----------
nosy: +Hanxue.Lee

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

From report at bugs.python.org  Fri Apr  4 23:05:31 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 04 Apr 2014 21:05:31 +0000
Subject: [docs] [issue21150] Add quick links table to argparse docs
In-Reply-To: <1396558035.28.0.485991636726.issue21150@psf.upfronthosting.co.za>
Message-ID: <1396645531.42.0.979834035906.issue21150@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/issue21150>
_______________________________________

From report at bugs.python.org  Fri Apr  4 23:47:29 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 04 Apr 2014 21:47:29 +0000
Subject: [docs] [issue21150] Add quick links table to argparse docs
In-Reply-To: <1396558035.28.0.485991636726.issue21150@psf.upfronthosting.co.za>
Message-ID: <1396648049.15.0.211102868375.issue21150@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

I have used both quick link tables and agree that more would be nice in spite of the added maintenance burden. The re module is one I would like to see indexed.

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

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

From report at bugs.python.org  Sat Apr  5 15:46:20 2014
From: report at bugs.python.org (Nitika Agarwal)
Date: Sat, 05 Apr 2014 13:46:20 +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: <1396705580.41.0.436245342648.issue18478@psf.upfronthosting.co.za>


Nitika Agarwal added the comment:

Hi,
I have attached the patch for the issue.Please someone review my patch.

----------

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

From report at bugs.python.org  Sat Apr  5 15:51:22 2014
From: report at bugs.python.org (Nitika Agarwal)
Date: Sat, 05 Apr 2014 13:51:22 +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: <1396705882.17.0.127948865264.issue4744@psf.upfronthosting.co.za>


Nitika Agarwal added the comment:

Hi,
I hvae attached the patch for review.I am waiting for reviewal.Please review the attached patch as soon as possible.

----------

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

From report at bugs.python.org  Sat Apr  5 16:24:16 2014
From: report at bugs.python.org (Nitika Agarwal)
Date: Sat, 05 Apr 2014 14:24:16 +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: <1396707856.41.0.597598330857.issue18566@psf.upfronthosting.co.za>


Nitika Agarwal added the comment:

Hi,
Please review the patch attached.

----------

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

From report at bugs.python.org  Sat Apr  5 21:25:05 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 05 Apr 2014 19:25:05 +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: <1396725905.36.0.45595628631.issue18478@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

After seeing my suggestion applied, I decided I don't like it. Sorry. A 'function code block' is a 'function suite'. A deeper problem is that the revision now omits the rules for classes. The base problem is that I don't know what the rules are when classes and functions are nested within each other (does anybody, without reading the code?). A puzzling example was posted on python-list yesterday, which I will try to find.

----------

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

From levgilman at hotmail.com  Sat Apr  5 03:51:58 2014
From: levgilman at hotmail.com (Lev Gilman)
Date: Sat, 5 Apr 2014 01:51:58 +0000
Subject: [docs] offline browsing
Message-ID: <DUB129-W50D2F154E90A8749247780B06E0@phx.gbl>

Since your site moved to https it became inaccessible for Teleport Pro. 		 	   		  
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140405/1df2d48d/attachment.html>

From compute at hulbert-web.org.uk  Sat Apr  5 12:09:16 2014
From: compute at hulbert-web.org.uk (John Hulbert)
Date: Sat, 05 Apr 2014 11:09:16 +0100
Subject: [docs] Problem With Python Arithmetic
Message-ID: <533FD64C.5040901@hulbert-web.org.uk>

Hello.

I don't know if this is a bug in Python, or my own misuse of the language.

I have the following code:

p=3470494144279007
p=(p*3+1)/2
print(p)

p=3470494144279007.0
p=(p*3+1)/2
print(p)

These should give the same answer, but I get the following 2 answers, 
with the first one correct, and the second one wrong. (They differ in 
the last integer digit):

5205741216418511.0
5205741216418510.0

Also, can you tell me (a Python beginner), how I can force Python to use 
long integer arithmetic throughout an algorithm?

Regards

John Hulbert,
(Reading, UK)



From compute at hulbert-web.org.uk  Sat Apr  5 14:04:14 2014
From: compute at hulbert-web.org.uk (John Hulbert)
Date: Sat, 05 Apr 2014 13:04:14 +0100
Subject: [docs] Problem With Python Arithmetic (Solved?)
Message-ID: <533FF13E.2040204@hulbert-web.org.uk>

Hello.

I wrote to you earlier today with the following problem:-

I have the following code:

p=3470494144279007
p=(p*3+1)/2
print(p)

p=3470494144279007.0
p=(p*3+1)/2
print(p)

These should give the same answer, but I get the following 2 answers, 
with the first one correct, and the second one wrong. (They differ in 
the last integer digit):

5205741216418511.0
5205741216418510.0

I have now discovered that I should have been using integer division, 
(//), instead of ordinary division, (/).

My algorithm now seems to work perfectly.  It arose in a study of the 
Collatz Conjecture.

Regards

John Hulbert,
(Reading, UK)



From cocoatomo77 at gmail.com  Sat Apr  5 18:45:54 2014
From: cocoatomo77 at gmail.com (tomo cocoa)
Date: Sun, 6 Apr 2014 01:45:54 +0900
Subject: [docs] trace module accepts --count option,
	but not --counts option when invoked
Message-ID: <CAN_7T0K3s-kJ0E14x-S0O3KKXhfqrW-J6KOMGogs21hYZqj4Xw@mail.gmail.com>

Hello,

I am a Japanese translator for Python documents.

In the first paragraph of the subsubsection "27.6.1.1. Main options",
a "--counts" option is explained, but trace module does not have that
option.

"--count" option may be misspelt with "--counts".

https://docs.python.org/3.3/library/trace.html#main-options


Thank you,

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/20140406/025ebe68/attachment.html>

From kir_per at rambler.ru  Sat Apr  5 20:07:40 2014
From: kir_per at rambler.ru (Kirill)
Date: Sat, 5 Apr 2014 22:07:40 +0400
Subject: [docs] issue with itertools leads the crash
Message-ID: <1396721260.939007.13044.8221@mail.rambler.ru>

The following code leads to system failure and crash on Ubuntu 12.04.3 with
Python 2.7.6.

import itertools

r = range (1,10)

r[1:9:2] = itertools.cycle([0])

Kirill .
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140405/136a31fe/attachment.html>

From senthil at uthcode.com  Sun Apr  6 19:50:42 2014
From: senthil at uthcode.com (Senthil Kumaran)
Date: Sun, 6 Apr 2014 10:50:42 -0700
Subject: [docs] Problem With Python Arithmetic
In-Reply-To: <533FD64C.5040901@hulbert-web.org.uk>
References: <533FD64C.5040901@hulbert-web.org.uk>
Message-ID: <CAPOVWOTfFi+S_3azarR42XvAJ=mvMgGUJE4qRDjqLYRHWDg5Yw@mail.gmail.com>

On Sat, Apr 5, 2014 at 3:09 AM, John Hulbert <compute at hulbert-web.org.uk>wrote:

>
> Also, can you tell me (a Python beginner), how I can force Python to use
> long integer arithmetic throughout an algorithm?


https://docs.python.org/2/tutorial/floatingpoint.html

This document tries to explain the issues well. Not a bug with Python
interpreter.

-- 
Senthil
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140406/0bf40047/attachment.html>

From senthil at uthcode.com  Sun Apr  6 19:51:58 2014
From: senthil at uthcode.com (Senthil Kumaran)
Date: Sun, 6 Apr 2014 10:51:58 -0700
Subject: [docs] issue with itertools leads the crash
In-Reply-To: <1396721260.939007.13044.8221@mail.rambler.ru>
References: <1396721260.939007.13044.8221@mail.rambler.ru>
Message-ID: <CAPOVWOTT+DxQs31LubJ3CHysLRjyVg678TXkvDWmHaAR7oZb1g@mail.gmail.com>

You have sent this to docs list. Is there is anywhere in the documentation
that it needs to be corrected?


On Sat, Apr 5, 2014 at 11:07 AM, Kirill <kir_per at rambler.ru> wrote:

>  The following code leads to system failure and crash on Ubuntu 12.04.3
> with Python 2.7.6.
>
> import itertools
>
> r = range (1,10)
>
> r[1:9:2] = itertools.cycle([0])
>
>  Kirill .
>
> _______________________________________________
> docs mailing list
> docs at python.org
> https://mail.python.org/mailman/listinfo/docs
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140406/e597ab89/attachment.html>

From senthil at uthcode.com  Sun Apr  6 20:02:07 2014
From: senthil at uthcode.com (Senthil Kumaran)
Date: Sun, 6 Apr 2014 11:02:07 -0700
Subject: [docs] trace module accepts --count option,
 but not --counts option when invoked
In-Reply-To: <CAN_7T0K3s-kJ0E14x-S0O3KKXhfqrW-J6KOMGogs21hYZqj4Xw@mail.gmail.com>
References: <CAN_7T0K3s-kJ0E14x-S0O3KKXhfqrW-J6KOMGogs21hYZqj4Xw@mail.gmail.com>
Message-ID: <CAPOVWORv5pnioprdgafyjMT1NODN8nwij+iTLGimEzRiPFoaNQ@mail.gmail.com>

On Sat, Apr 5, 2014 at 9:45 AM, tomo cocoa <cocoatomo77 at gmail.com> wrote:

> "--count" option may be misspelt with "--counts".


Thanks for the report.

Corrected them at

changeset c5aa95c7b5e5
changeset b49d990aaa9d
changeset d1d4bcf87e59
changeset b466fd273625

In all the applicable versions.

Thank you,
Senthil
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140406/21ed0c90/attachment-0001.html>

From report at bugs.python.org  Mon Apr  7 16:39:19 2014
From: report at bugs.python.org (Volodymyr Sapsai)
Date: Mon, 07 Apr 2014 14:39:19 +0000
Subject: [docs] [issue21170] Incorrect signature
	for	unittest.TestResult.startTestRun(), .stopTestRun()
Message-ID: <1396881559.52.0.157201741461.issue21170@psf.upfronthosting.co.za>


New submission from Volodymyr Sapsai:

Steps to reproduce:
1. Open docs for unittest.TestResult class.
2. Look at startTestRun() and stopTestRun() methods signatures (https://docs.python.org/3.4/library/unittest.html#unittest.TestResult.startTestRun)

Actual result:
It is stated that aforementioned methods accept 1 argument 'test'.

Expected result:
These methods don't accept any arguments, it should be stated so in the docs.

----------
assignee: docs at python
components: Documentation
messages: 215710
nosy: Volodymyr.Sapsai, docs at python
priority: normal
severity: normal
status: open
title: Incorrect signature for unittest.TestResult.startTestRun(), .stopTestRun()
versions: Python 2.7, Python 3.4

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

From report at bugs.python.org  Mon Apr  7 23:10:31 2014
From: report at bugs.python.org (=?utf-8?q?Bo=C5=A1tjan_Mejak?=)
Date: Mon, 07 Apr 2014 21:10:31 +0000
Subject: [docs] [issue21174] A typo in the docs for "exception GeneratorExit"
Message-ID: <1396905031.09.0.19522982785.issue21174@psf.upfronthosting.co.za>


New submission from Bo?tjan Mejak:

The docs for the exception GeneratorExit starts like this:
Raise when a generator?s close() method is called.

The sentece should start with the first word "Raise" to say "Raised". You can find this particular doc sentence on this link: https://docs.python.org/2/library/exceptions.html#exceptions.GeneratorExit

This is a small fix. Just add the letter "d".

----------
assignee: docs at python
components: Documentation
messages: 215717
nosy: Zvezdoslovec, docs at python
priority: normal
severity: normal
status: open
title: A typo in the docs for "exception GeneratorExit"
type: enhancement
versions: Python 3.3, Python 3.4, Python 3.5

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

From report at bugs.python.org  Tue Apr  8 01:35:44 2014
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 07 Apr 2014 23:35:44 +0000
Subject: [docs] [issue21174] A typo in the docs for "exception GeneratorExit"
In-Reply-To: <1396905031.09.0.19522982785.issue21174@psf.upfronthosting.co.za>
Message-ID: <3g2p5q0XlWz7LjR@mail.python.org>


Roundup Robot added the comment:

New changeset aff368b58a98 by Benjamin Peterson in branch '2.7':
fix verb (closes #21174)
http://hg.python.org/cpython/rev/aff368b58a98

New changeset 33528b9520e6 by Benjamin Peterson in branch '3.4':
fix verb (closes #21174)
http://hg.python.org/cpython/rev/33528b9520e6

New changeset c48164710ed5 by Benjamin Peterson in branch 'default':
merge 3.4 (#21174)
http://hg.python.org/cpython/rev/c48164710ed5

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

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

From report at bugs.python.org  Tue Apr  8 06:38:22 2014
From: report at bugs.python.org (Josh Rosenberg)
Date: Tue, 08 Apr 2014 04:38:22 +0000
Subject: [docs] [issue16395] Documentation claims that PySequence_Fast
	returns a	tuple, when it actually returns a list.
In-Reply-To: <1351955901.81.0.627286470446.issue16395@psf.upfronthosting.co.za>
Message-ID: <1396931902.43.0.965270021363.issue16395@psf.upfronthosting.co.za>


Josh Rosenberg added the comment:

Any news on this? I was about to open a bug of my own for this, since the docs and code are still out of sync.

----------
nosy: +josh.rosenberg

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

From report at bugs.python.org  Tue Apr  8 06:40:19 2014
From: report at bugs.python.org (Josh Rosenberg)
Date: Tue, 08 Apr 2014 04:40:19 +0000
Subject: [docs] [issue16395] Documentation claims that PySequence_Fast
	returns a	tuple, when it actually returns a list.
In-Reply-To: <1351955901.81.0.627286470446.issue16395@psf.upfronthosting.co.za>
Message-ID: <1396932019.23.0.538813881643.issue16395@psf.upfronthosting.co.za>


Josh Rosenberg added the comment:

As far as performance goes, presumably the length hinting API reduces the number of cases in which we're working with completely unsized iterables, right?

----------

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

From report at bugs.python.org  Tue Apr  8 12:58:58 2014
From: report at bugs.python.org (Clinton Curry)
Date: Tue, 08 Apr 2014 10:58:58 +0000
Subject: [docs] [issue21179] Rounding half to even
Message-ID: <1396954738.37.0.54879370291.issue21179@psf.upfronthosting.co.za>


New submission from Clinton Curry:

In the current Python 2.7 documentation, Section 5.4

https://docs.python.org/2.7/library/stdtypes.html

the result of the round function is described as "x rounded to n digits, rounding half to even. If n is omitted, it defaults to 0."  However, my observed behavior (Python 2.7.4 (default, Apr  6 2013, 19:55:15) [MSC v.1500 64 bit (AMD64)] on win32) does not round half to even, but rounds half away from zero.

>>> round(1.5)
2.0
>>> round(2.5)
3.0
>>> round(-1.5)
-2.0
>>> round(-2.5)
-3.0

I observe similar behavior on other platforms.

----------
assignee: docs at python
components: Documentation
messages: 215753
nosy: Clinton.Curry, docs at python, eric.araujo, ezio.melotti, georg.brandl
priority: normal
severity: normal
status: open
title: Rounding half to even
versions: Python 2.7

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

From report at bugs.python.org  Tue Apr  8 15:15:20 2014
From: report at bugs.python.org (Paul Sokolovsky)
Date: Tue, 08 Apr 2014 13:15:20 +0000
Subject: [docs] [issue17145] memoryview(array.array)
In-Reply-To: <1360170754.31.0.614797074916.issue17145@psf.upfronthosting.co.za>
Message-ID: <1396962920.51.0.87049177488.issue17145@psf.upfronthosting.co.za>


Changes by Paul Sokolovsky <pfalcon at users.sourceforge.net>:


----------
nosy: +pfalcon

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

From report at bugs.python.org  Tue Apr  8 16:40:45 2014
From: report at bugs.python.org (Larry Hastings)
Date: Tue, 08 Apr 2014 14:40:45 +0000
Subject: [docs] [issue16395] Documentation claims that PySequence_Fast
	returns a	tuple, when it actually returns a list.
In-Reply-To: <1351955901.81.0.627286470446.issue16395@psf.upfronthosting.co.za>
Message-ID: <1396968045.51.0.977178672021.issue16395@psf.upfronthosting.co.za>


Larry Hastings added the comment:

I have no objections to someone backporting this.

----------

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

From report at bugs.python.org  Tue Apr  8 16:49:17 2014
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 08 Apr 2014 14:49:17 +0000
Subject: [docs] [issue16395] Documentation claims that PySequence_Fast
	returns a	tuple, when it actually returns a list.
In-Reply-To: <1351955901.81.0.627286470446.issue16395@psf.upfronthosting.co.za>
Message-ID: <3g3BMw58kzz7Ljj@mail.python.org>


Roundup Robot added the comment:

New changeset b2187b82a658 by Benjamin Peterson in branch '3.4':
PySequence_Fast generally returns a list not a tuple (closes #16395)
http://hg.python.org/cpython/rev/b2187b82a658

New changeset b235db467cd5 by Benjamin Peterson in branch '2.7':
PySequence_Fast generally returns a list not a tuple (closes #16395)
http://hg.python.org/cpython/rev/b235db467cd5

New changeset c833c35aa13a by Benjamin Peterson in branch 'default':
merge 3.4 (#16395)
http://hg.python.org/cpython/rev/c833c35aa13a

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

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

From report at bugs.python.org  Tue Apr  8 18:49:08 2014
From: report at bugs.python.org (Wolfgang Maier)
Date: Tue, 08 Apr 2014 16:49:08 +0000
Subject: [docs] [issue21146] update gzip usage examples in docs
In-Reply-To: <1396521606.53.0.161098821761.issue21146@psf.upfronthosting.co.za>
Message-ID: <1396975748.53.0.920546970479.issue21146@psf.upfronthosting.co.za>


Wolfgang Maier added the comment:

ok, I've prepared the patch using the elegant shutil solution.

----------
keywords: +patch
Added file: http://bugs.python.org/file34765/gzip_example_usage_patch.diff

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

From jhyingli at mail.ustc.edu.cn  Tue Apr  8 16:02:16 2014
From: jhyingli at mail.ustc.edu.cn (=?GBK?B?wO7Tog==?=)
Date: Tue, 8 Apr 2014 22:02:16 +0800 (CST)
Subject: [docs] how to transfer a xml format file to txt format
Message-ID: <16233595.3488711396965736200.JavaMail.coremail@mailweb>


Hi, here I want to extrat the flag of a xml file, to transfer to a txt file
Such as:

<html>
    <head>
        <title>Example page</title>
    </head>
    <body>
        <p>Moved to <a href="http://example.org/">example.org</a>
        or <a href="http://example.com/">example.com</a>.</p>
    </body>
</html>

To:
Example page
Moved to example.org or example.com

with Python xml,how to do ? Thanks!
--
Regards
Ying Li

From report at bugs.python.org  Wed Apr  9 03:50:03 2014
From: report at bugs.python.org (Josh Rosenberg)
Date: Wed, 09 Apr 2014 01:50:03 +0000
Subject: [docs] [issue21179] Rounding half to even
In-Reply-To: <1396954738.37.0.54879370291.issue21179@psf.upfronthosting.co.za>
Message-ID: <1397008203.44.0.574883847655.issue21179@psf.upfronthosting.co.za>


Josh Rosenberg added the comment:

Python 3.2-3.4 (probably all of 3.x) use round half even, but testing 2.7.3 on Ubuntu confirms what you say. In terms of the decimal constants, Py2.7 round() appears to use decimal.ROUND_HALF_UP behavior while 3.x uses decimal.ROUND_HALF_EVEN behavior.

Looks like someone accidentally copied Py3 docs down to Py2; according to https://docs.python.org/3/whatsnew/3.0.html :

>The round() function rounding strategy and return type have changed. Exact halfway cases are now rounded to the nearest even result instead of away from zero. (For example, round(2.5) now returns 2 rather than 3.) round(x[, n]) now delegates to x.__round__([n]) instead of always returning a float. It generally returns an integer when called with a single argument and a value of the same type as x when called with two arguments.

Looks like the behaviors never changed, but the docs for round in Py2 are incorrect.

----------
nosy: +josh.rosenberg

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

From report at bugs.python.org  Wed Apr  9 05:08:03 2014
From: report at bugs.python.org (Kushal Das)
Date: Wed, 09 Apr 2014 03:08:03 +0000
Subject: [docs] [issue21170] Incorrect signature
	for	unittest.TestResult.startTestRun(), .stopTestRun()
In-Reply-To: <1396881559.52.0.157201741461.issue21170@psf.upfronthosting.co.za>
Message-ID: <1397012883.05.0.292371600901.issue21170@psf.upfronthosting.co.za>


Kushal Das added the comment:

Here is a patch which fixes the documentation for unittest.

----------
keywords: +patch
nosy: +kushaldas
Added file: http://bugs.python.org/file34772/issue21170.patch

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

From berker.peksag at gmail.com  Wed Apr  9 06:50:20 2014
From: berker.peksag at gmail.com (=?UTF-8?Q?Berker_Peksa=C4=9F?=)
Date: Wed, 9 Apr 2014 07:50:20 +0300
Subject: [docs] how to transfer a xml format file to txt format
In-Reply-To: <16233595.3488711396965736200.JavaMail.coremail@mailweb>
References: <16233595.3488711396965736200.JavaMail.coremail@mailweb>
Message-ID: <CAF4280KvnYUVJGo7K_ZmR459zUtk-e0t61PM+ztzzZajdkxUeQ@mail.gmail.com>

On Tue, Apr 8, 2014 at 5:02 PM, ?? <jhyingli at mail.ustc.edu.cn> wrote:
>
> Hi, here I want to extrat the flag of a xml file, to transfer to a txt file

Hi,

Please ask your question on python-list[1]. This list is for
discussion of the Python documentation.

[1] https://mail.python.org/mailman/listinfo/python-list

--Berker

From report at bugs.python.org  Wed Apr  9 07:19:24 2014
From: report at bugs.python.org (Berker Peksag)
Date: Wed, 09 Apr 2014 05:19:24 +0000
Subject: [docs] [issue21170] Incorrect signature
	for	unittest.TestResult.startTestRun(), .stopTestRun()
In-Reply-To: <1396881559.52.0.157201741461.issue21170@psf.upfronthosting.co.za>
Message-ID: <1397020764.59.0.913570449611.issue21170@psf.upfronthosting.co.za>


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


----------
nosy: +ezio.melotti, michael.foord
stage:  -> patch review
versions: +Python 3.5

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

From report at bugs.python.org  Wed Apr  9 13:04:13 2014
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 09 Apr 2014 11:04:13 +0000
Subject: [docs] [issue21179] Rounding half to even
In-Reply-To: <1396954738.37.0.54879370291.issue21179@psf.upfronthosting.co.za>
Message-ID: <3g3jKm5h4Qz7LjQ@mail.python.org>


Roundup Robot added the comment:

New changeset 7ec8c4555772 by Mark Dickinson in branch '2.7':
Issue #21179: Fix description of 'round' function for numbers.Real.
http://hg.python.org/cpython/rev/7ec8c4555772

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

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

From report at bugs.python.org  Wed Apr  9 13:05:52 2014
From: report at bugs.python.org (Mark Dickinson)
Date: Wed, 09 Apr 2014 11:05:52 +0000
Subject: [docs] [issue21179] Rounding half to even
In-Reply-To: <1396954738.37.0.54879370291.issue21179@psf.upfronthosting.co.za>
Message-ID: <1397041552.6.0.568137756458.issue21179@psf.upfronthosting.co.za>


Mark Dickinson added the comment:

Yep, 2.7 does round-ties-away-from-zero.  There's even special code for that: the underlying machinery does a round-ties-to-even, and then there's a hack on top of that to convert to round-ties-away-from-zero.

Looks like this error went unnoticed for quite a while.

Now fixed.  Thanks for the report!

----------
nosy: +mark.dickinson
resolution:  -> fixed
status: open -> closed

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

From report at bugs.python.org  Wed Apr  9 15:42:56 2014
From: report at bugs.python.org (LtWorf)
Date: Wed, 09 Apr 2014 13:42:56 +0000
Subject: [docs] [issue21189] Broken link to patch
Message-ID: <1397050976.2.0.0354182649484.issue21189@psf.upfronthosting.co.za>


New submission from LtWorf:

This page

https://mail.python.org/mailman/listinfo/patches

suggests to go here: http://www.python.org/patches/ to know how to send patches. However that page doesn't exist.

----------
assignee: docs at python
components: Documentation
messages: 215819
nosy: docs at python, tiposchi
priority: normal
severity: normal
status: open
title: Broken link to patch
type: enhancement

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

From report at bugs.python.org  Wed Apr  9 16:48:36 2014
From: report at bugs.python.org (Selena Deckelmann)
Date: Wed, 09 Apr 2014 14:48:36 +0000
Subject: [docs] [issue21190] Broken download link on README for CPython docs
Message-ID: <1397054916.95.0.591389338462.issue21190@psf.upfronthosting.co.za>


New submission from Selena Deckelmann:

The page: https://github.com/python/cpython/blob/master/Doc/README.txt

Links to: http://docs.python.org/download/

Which is now a 404. A URL which may be correct is: https://docs.python.org/3/download.html

I'm unsure what the org policy is on linking most recent documentation, however. In the Postgres community, we have a 'current' symlink that always links to the most recent version.

----------
assignee: docs at python
components: Documentation
messages: 215821
nosy: Selena.Deckelmann, docs at python
priority: normal
severity: normal
status: open
title: Broken download link on README for CPython docs
type: enhancement

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

From report at bugs.python.org  Wed Apr  9 16:53:10 2014
From: report at bugs.python.org (Alex Gaynor)
Date: Wed, 09 Apr 2014 14:53:10 +0000
Subject: [docs] [issue21190] Broken download link on README for CPython docs
In-Reply-To: <1397054916.95.0.591389338462.issue21190@psf.upfronthosting.co.za>
Message-ID: <1397055189.93.0.879323099945.issue21190@psf.upfronthosting.co.za>


Alex Gaynor added the comment:

It looks like https://docs.python.org/3/download.html (and I suppose the 2.x variant) are the right URLs to use this.

----------
nosy: +alex

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

From report at bugs.python.org  Wed Apr  9 17:45:26 2014
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 09 Apr 2014 15:45:26 +0000
Subject: [docs] [issue21190] Broken download link on README for CPython docs
In-Reply-To: <1397054916.95.0.591389338462.issue21190@psf.upfronthosting.co.za>
Message-ID: <3g3qZF4jh0z7LkD@mail.python.org>


Roundup Robot added the comment:

New changeset aec35c0d308b by Senthil Kumaran in branch '2.7':
issue #21190: Fix the docs README link
http://hg.python.org/cpython/rev/aec35c0d308b

New changeset df8f49f8cdd2 by Senthil Kumaran in branch '3.4':
issue #21190: Fix the broken docs download link
http://hg.python.org/cpython/rev/df8f49f8cdd2

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

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

From report at bugs.python.org  Wed Apr  9 17:46:01 2014
From: report at bugs.python.org (Senthil Kumaran)
Date: Wed, 09 Apr 2014 15:46:01 +0000
Subject: [docs] [issue21190] Broken download link on README for CPython docs
In-Reply-To: <1397054916.95.0.591389338462.issue21190@psf.upfronthosting.co.za>
Message-ID: <1397058361.31.0.213437732844.issue21190@psf.upfronthosting.co.za>


Senthil Kumaran added the comment:

Fixed this all active versions. Thanks for the report.

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

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

From report at bugs.python.org  Wed Apr  9 19:55:17 2014
From: report at bugs.python.org (Georg Brandl)
Date: Wed, 09 Apr 2014 17:55:17 +0000
Subject: [docs] [issue21189] Broken link to patch
In-Reply-To: <1397050976.2.0.0354182649484.issue21189@psf.upfronthosting.co.za>
Message-ID: <1397066117.65.0.480135488953.issue21189@psf.upfronthosting.co.za>


Georg Brandl added the comment:

Barry, you "run the list", so please change this to a link to bugs.python.org (and maybe docs.python.org/devguide).

----------
assignee: docs at python -> barry
nosy: +barry, georg.brandl

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

From report at bugs.python.org  Thu Apr 10 02:12:07 2014
From: report at bugs.python.org (paul j3)
Date: Thu, 10 Apr 2014 00:12:07 +0000
Subject: [docs] [issue21150] Add quick links table to argparse docs
In-Reply-To: <1396558035.28.0.485991636726.issue21150@psf.upfronthosting.co.za>
Message-ID: <1397088727.57.0.268077051074.issue21150@psf.upfronthosting.co.za>


paul j3 added the comment:

While 'argparse' is complex, its organization is quite different from 'itertools'.  For most purposes there is one starting point:

    parser = argparse.ArgumentParser(...)

Nearly everything else invokes a 'parser'  method.  Most complex and common is 'add_argument'.

Some summary tables might be useful, but 'itertools' might not be best model.

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

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

From report at bugs.python.org  Thu Apr 10 14:19:35 2014
From: report at bugs.python.org (Eric O. LEBIGOT)
Date: Thu, 10 Apr 2014 12:19:35 +0000
Subject: [docs] [issue21195] None float format: incomplete documentation
Message-ID: <1397132375.36.0.349385981395.issue21195@psf.upfronthosting.co.za>


New submission from Eric O. LEBIGOT:

The documentation for a None (empty) format for floats indicates that it is equivalent to the g format. This does not appear to be correct (http://stackoverflow.com/questions/16525924/precise-definition-of-float-string-formatting).

The Python?3.4 documentation (https://docs.python.org/3.4/library/string.html#format-specification-mini-language) seems to be much closer to what Python?2.7 does.

It would be useful to have a more correct documentation for the effect of a None format for floats in Python?2.7 (maybe by copying the Python?3.4 documentation if it applies).

----------
assignee: docs at python
components: Documentation
messages: 215871
nosy: docs at python, lebigot
priority: normal
severity: normal
status: open
title: None float format: incomplete documentation
type: enhancement
versions: Python 2.7

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

From report at bugs.python.org  Thu Apr 10 14:31:20 2014
From: report at bugs.python.org (Chandan Kumar)
Date: Thu, 10 Apr 2014 12:31:20 +0000
Subject: [docs] [issue21196] Name mangling example in Python tutorial
Message-ID: <1397133080.37.0.870141660622.issue21196@psf.upfronthosting.co.za>


New submission from Chandan Kumar:

The example used for demonstrating name mangling could be better if two versions of code are shown - one with name mangling and one without.  I have modified the original example to incorporate this (see attached).

----------
assignee: docs at python
components: Documentation
files: name_mangling_works.py
messages: 215872
nosy: chandan, docs at python, rhettinger
priority: normal
severity: normal
status: open
title: Name mangling example in Python tutorial
type: enhancement
Added file: http://bugs.python.org/file34781/name_mangling_works.py

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

From report at bugs.python.org  Thu Apr 10 14:32:27 2014
From: report at bugs.python.org (Chandan Kumar)
Date: Thu, 10 Apr 2014 12:32:27 +0000
Subject: [docs] [issue21196] Name mangling example in Python tutorial
In-Reply-To: <1397133080.37.0.870141660622.issue21196@psf.upfronthosting.co.za>
Message-ID: <1397133147.94.0.18142895908.issue21196@psf.upfronthosting.co.za>


Chandan Kumar added the comment:

Adding the second code sample, since only one attachment allowed at one go.

----------
Added file: http://bugs.python.org/file34782/without_name_mangling.py

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

From report at bugs.python.org  Thu Apr 10 14:37:10 2014
From: report at bugs.python.org (Chandan Kumar)
Date: Thu, 10 Apr 2014 12:37:10 +0000
Subject: [docs] [issue21196] Name mangling example in Python tutorial
In-Reply-To: <1397133080.37.0.870141660622.issue21196@psf.upfronthosting.co.za>
Message-ID: <1397133430.68.0.524083831829.issue21196@psf.upfronthosting.co.za>


Chandan Kumar added the comment:

Here is a link to the documentation section in question: https://docs.python.org/2/tutorial/classes.html#private-variables-and-class-local-references

----------

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

From report at bugs.python.org  Thu Apr 10 15:18:48 2014
From: report at bugs.python.org (Eric V. Smith)
Date: Thu, 10 Apr 2014 13:18:48 +0000
Subject: [docs] [issue21195] None float format: incomplete documentation
In-Reply-To: <1397132375.36.0.349385981395.issue21195@psf.upfronthosting.co.za>
Message-ID: <1397135928.65.0.475423333041.issue21195@psf.upfronthosting.co.za>


Eric V. Smith added the comment:

An empty format specifier can (and to my knowledge, does) match str(). So you get:

>>> format(1e10, '')
'10000000000.0'
>>> format(1e10, 'g')
'1e+10'
>>> str(1e10)
'10000000000.0'

The SO question is asking about an empty "presentation type", which is indeed similar to 'g' for floats.

I think this is all the same in 2.7 and 3.4, with the exception of how str() might operate on floats.

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

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

From report at bugs.python.org  Thu Apr 10 15:30:26 2014
From: report at bugs.python.org (Eric O. LEBIGOT)
Date: Thu, 10 Apr 2014 13:30:26 +0000
Subject: [docs] [issue21195] None float format: incomplete documentation
In-Reply-To: <1397132375.36.0.349385981395.issue21195@psf.upfronthosting.co.za>
Message-ID: <1397136626.22.0.131322963183.issue21195@psf.upfronthosting.co.za>


Eric O. LEBIGOT added the comment:

These examples are good.

I am confused, though, about "The SO question is asking about an empty "presentation type", which is indeed similar to 'g' for floats.": the question is actually about why the '' format gives a result that differs from the 'g' format despite the Python?2.7 documentation saying that a "None" format type is "The same as 'g'.". Both the SO question and your examples show that the Python?2.7 documentation is incorrect, unless the other commenters and I were missing something?

Clarifying the documentation would in any case be useful, as the comments to the SO question show?

----------

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

From report at bugs.python.org  Thu Apr 10 16:47:17 2014
From: report at bugs.python.org (Mark Dickinson)
Date: Thu, 10 Apr 2014 14:47:17 +0000
Subject: [docs] [issue21195] None float format: incomplete documentation
In-Reply-To: <1397132375.36.0.349385981395.issue21195@psf.upfronthosting.co.za>
Message-ID: <1397141237.66.0.757638861201.issue21195@psf.upfronthosting.co.za>


Changes by Mark Dickinson <dickinsm at gmail.com>:


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

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

From report at bugs.python.org  Thu Apr 10 16:47:25 2014
From: report at bugs.python.org (Brigitta S)
Date: Thu, 10 Apr 2014 14:47:25 +0000
Subject: [docs] [issue11975] Fix referencing of built-in types (list, int,
	...)
In-Reply-To: <1304281262.53.0.265979216697.issue11975@psf.upfronthosting.co.za>
Message-ID: <1397141244.98.0.54433368179.issue11975@psf.upfronthosting.co.za>


Brigitta S added the comment:

I would like to reference the list methods in a documentation using intersphinx-ing e.g ":meth:`list.append`" etc. However there are no links generated for these. 

I may underestimate issues raised in this thread, but it naively seems that removing the :noindex: lines from datastructures.rst would solve the problem.

thanks

----------
nosy: +bsipocz

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

From report at bugs.python.org  Thu Apr 10 17:04:53 2014
From: report at bugs.python.org (Eric V. Smith)
Date: Thu, 10 Apr 2014 15:04:53 +0000
Subject: [docs] [issue21195] None float format: incomplete documentation
In-Reply-To: <1397132375.36.0.349385981395.issue21195@psf.upfronthosting.co.za>
Message-ID: <1397142293.74.0.208420838357.issue21195@psf.upfronthosting.co.za>


Eric V. Smith added the comment:

The rule is:
- if the entire format specifier is the empty string (not None, but ''), then return str(value)
- else, look at the presentation type. if it is missing, set it to something like 'g'
- do the normal float formatting using the presentation type

The first of these has an empty string for the format specifier (so uses str(1e10), the rest do not:

>>> format(1e10, '')
'10000000000.0'
>>> format(1e10, ' ')
' 10000000000.0'
>>> format(1e10, ' g')
' 1e+10'
>>> format(1e10, ' e')
' 1.000000e+10'
>>> format(1e10, ' f')
' 10000000000.000000'

Now, how much the "something like g" part of the above is true is debatable.

----------

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

From report at bugs.python.org  Thu Apr 10 17:33:09 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 10 Apr 2014 15:33:09 +0000
Subject: [docs] [issue11975] Fix referencing of built-in types (list, int,
	...)
In-Reply-To: <1304281262.53.0.265979216697.issue11975@psf.upfronthosting.co.za>
Message-ID: <1397143989.17.0.937704131133.issue11975@psf.upfronthosting.co.za>


?ric Araujo added the comment:

> I may underestimate issues raised in this thread

I re-read the discussion, these are the two main issues:

1) We?d like list/tuple/etc. documented in two different pages (as functions and as types), which causes issues when Sphinx builds its index of referenceable objects, as investigated by Jonas.

2) We?d like to have link targets for list.count/tuple.count/etc. but the existing doc has one place only to document all sequence types? count method, so the fix is not simple.


For 1), I now think that Ezio?s builtins.list/list hack could be a good idea, as long as ?list? (i.e. not ?builtins.list?) is always displayed in the text for humans (I don?t care about URIs or rst source), and that people using intersphinx can write ?:meth:`list.append`? and don?t have to go with ?:meth:`builtins.list.append <list.append>`?.

For 2), I would be fine with adding mostly empty method directives to make links work, without duplicating the info in the existing ?common sequence operations? table and footnotes.  For example, in https://docs.python.org/3/library/stdtypes.html#tuples after ?Tuples implement all of the :ref:`common <typesseq-common>` sequence operations?, I?d add directives for tuple.index and tuple.count.


On a related note, it?s unfortunate that the global index has one entry for ?tuple (built-in function)?, seven entries for ?tuple object?, but none for ?tuple.count? (and search doesn?t find it either) or ?tuple class?.

----------
stage: patch review -> needs patch
versions: +Python 3.5 -Python 3.2, Python 3.3

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

From report at bugs.python.org  Thu Apr 10 18:43:47 2014
From: report at bugs.python.org (Andrew Scheller)
Date: Thu, 10 Apr 2014 16:43:47 +0000
Subject: [docs] [issue21198] Minor tarfile documentation bug
Message-ID: <1397148227.41.0.631676560193.issue21198@psf.upfronthosting.co.za>


New submission from Andrew Scheller:

I've just noticed that the documentation for TarInfo.type says
"To determine the type of a TarInfo object more conveniently, use the is_*() methods below."

However none of the methods mentioned actually contain an underscore, so I believe the documentation should be updated to "...use the is*() methods below."

(for comparison, the documentation for stat.S_IFMT correctly talks about "is*() functions")

----------
assignee: docs at python
components: Documentation
messages: 215892
nosy: docs at python, lurchman
priority: normal
severity: normal
status: open
title: Minor tarfile documentation bug
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/issue21198>
_______________________________________

From report at bugs.python.org  Thu Apr 10 19:01:25 2014
From: report at bugs.python.org (Berker Peksag)
Date: Thu, 10 Apr 2014 17:01:25 +0000
Subject: [docs] [issue21198] Minor tarfile documentation bug
In-Reply-To: <1397148227.41.0.631676560193.issue21198@psf.upfronthosting.co.za>
Message-ID: <1397149285.79.0.137370195221.issue21198@psf.upfronthosting.co.za>


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


----------
type: enhancement -> 
versions:  -Python 3.1, Python 3.2, Python 3.3

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

From report at bugs.python.org  Fri Apr 11 00:35:02 2014
From: report at bugs.python.org (Charles-Axel Dein)
Date: Thu, 10 Apr 2014 22:35:02 +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: <1397169302.41.0.426531252975.issue20351@psf.upfronthosting.co.za>


Charles-Axel Dein added the comment:

Hey - is there anything else I need to do here?

----------

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

From report at bugs.python.org  Fri Apr 11 04:41:29 2014
From: report at bugs.python.org (Eric O. LEBIGOT)
Date: Fri, 11 Apr 2014 02:41:29 +0000
Subject: [docs] [issue21195] None float format: incomplete documentation
In-Reply-To: <1397132375.36.0.349385981395.issue21195@psf.upfronthosting.co.za>
Message-ID: <1397184088.99.0.684159332077.issue21195@psf.upfronthosting.co.za>


Eric O. LEBIGOT added the comment:

The Python 2.7 goes even as far as to say that format(1e10, ' ') should give "the same as" format(1e10, ' g') (not something "similar to g"), which is obviously incorrect.

If the Python 3.4 documentation for the empty presentation type of floats were used in the Python?2.7 documentation, it would be closer to the real behavior of Python?2.7, so that would be an improvement.

Now, the real question is whether the Python?3.4 documentation applies exactly to Python?2.7, here, or whether improving the Python?2.7 documentation would require a different description.

----------

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

From report at bugs.python.org  Fri Apr 11 19:57:22 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 11 Apr 2014 17:57:22 +0000
Subject: [docs] [issue21170] Incorrect signature
	for	unittest.TestResult.startTestRun(), .stopTestRun()
In-Reply-To: <1396881559.52.0.157201741461.issue21170@psf.upfronthosting.co.za>
Message-ID: <1397239042.64.0.712895941716.issue21170@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

Good catch. I verified in code that patch is correct.

----------
assignee: docs at python -> terry.reedy
nosy: +terry.reedy

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

From report at bugs.python.org  Fri Apr 11 20:05:52 2014
From: report at bugs.python.org (Madison May)
Date: Fri, 11 Apr 2014 18:05:52 +0000
Subject: [docs] [issue21202] Naming a file` io.py` causes cryptic error
	message
Message-ID: <1397239551.94.0.578791540537.issue21202@psf.upfronthosting.co.za>


New submission from Madison May:

Naming a file `io.py` in the root directory of a project causes the following error on 2.7: 

    AttributeError: 'module' object has no attribute 'BufferedIOBase'

Similar issues arise on 3.x., although the error message is a bit more useful:

    Fatal Python error: Py_Initialize: can't initialize sys standard streams
    AttributeError: 'module' object has no attribute 'OpenWrapper'

At the very least we should ensure that the error message is a bit more straightforward and clear, as I imagine its not all that uncommon to cause this kind of conflict.

----------
assignee: docs at python
components: Documentation, IO
messages: 215940
nosy: docs at python, madison.may
priority: normal
severity: normal
status: open
title: Naming a file` io.py` causes cryptic error message
versions: Python 2.7

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

From report at bugs.python.org  Fri Apr 11 20:06:04 2014
From: report at bugs.python.org (Madison May)
Date: Fri, 11 Apr 2014 18:06:04 +0000
Subject: [docs] [issue21202] Naming a file` io.py` causes cryptic error
	message
In-Reply-To: <1397239551.94.0.578791540537.issue21202@psf.upfronthosting.co.za>
Message-ID: <1397239564.82.0.445230563681.issue21202@psf.upfronthosting.co.za>


Changes by Madison May <madison.may at students.olin.edu>:


----------
versions: +Python 3.5

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

From report at bugs.python.org  Fri Apr 11 20:12:10 2014
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 11 Apr 2014 18:12:10 +0000
Subject: [docs] [issue21170] Incorrect signature
	for	unittest.TestResult.startTestRun(), .stopTestRun()
In-Reply-To: <1396881559.52.0.157201741461.issue21170@psf.upfronthosting.co.za>
Message-ID: <3g56kc5MqJz7LjP@mail.python.org>


Roundup Robot added the comment:

New changeset c1ea2846a564 by Terry Jan Reedy in branch '2.7':
Issue #21170: Removed invalid parameter names from unittest doc.
http://hg.python.org/cpython/rev/c1ea2846a564

New changeset 5734175a87d1 by Terry Jan Reedy in branch '3.4':
Issue #21170: Removed invalid parameter names from unittest doc.
http://hg.python.org/cpython/rev/5734175a87d1

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

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

From report at bugs.python.org  Fri Apr 11 20:12:59 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 11 Apr 2014 18:12:59 +0000
Subject: [docs] [issue21170] Incorrect signature
	for	unittest.TestResult.startTestRun(), .stopTestRun()
In-Reply-To: <1396881559.52.0.157201741461.issue21170@psf.upfronthosting.co.za>
Message-ID: <1397239979.62.0.374491251185.issue21170@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Apr 11 20:58:02 2014
From: report at bugs.python.org (Ned Deily)
Date: Fri, 11 Apr 2014 18:58:02 +0000
Subject: [docs] [issue21202] Naming a file` io.py` causes cryptic error
	message
In-Reply-To: <1397239551.94.0.578791540537.issue21202@psf.upfronthosting.co.za>
Message-ID: <1397242682.67.0.185637016322.issue21202@psf.upfronthosting.co.za>


Ned Deily added the comment:

Using a local module name that shadows one in the standard library is a very common "import trap".  See, for example, https://ncoghlan_devs-python-notes.readthedocs.org/en/latest/python_concepts/import_traps.html#the-name-shadowing-trap.  I did a quick search through the documentation and didn't find an explicit reference to the general topic.  If it isn't already, it probably should be mentioned in the tutorial and the FAQ.  I don't think that 'io' should be special-cased.

----------
components:  -IO
nosy: +ned.deily

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

From report at bugs.python.org  Fri Apr 11 21:01:04 2014
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 11 Apr 2014 19:01:04 +0000
Subject: [docs] [issue21202] Naming a file` io.py` causes cryptic error
	message
In-Reply-To: <1397239551.94.0.578791540537.issue21202@psf.upfronthosting.co.za>
Message-ID: <1397242864.41.0.399333677425.issue21202@psf.upfronthosting.co.za>


Brett Cannon added the comment:

While mentioning something in the FAQ and/or tutorial is fine, I wouldn't want to change Python's message too much to deal with this unless it was extremely fast (e.g. we pre-generated a set and check that on ImportError and then modified the message only in those instances).

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

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

From report at bugs.python.org  Fri Apr 11 21:07:01 2014
From: report at bugs.python.org (Ezio Melotti)
Date: Fri, 11 Apr 2014 19:07:01 +0000
Subject: [docs] [issue21202] Naming a file` io.py` causes cryptic error
	message
In-Reply-To: <1397239551.94.0.578791540537.issue21202@psf.upfronthosting.co.za>
Message-ID: <1397243221.92.0.0076368522884.issue21202@psf.upfronthosting.co.za>


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


----------
nosy: +ezio.melotti, ncoghlan
type:  -> behavior

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

From report at bugs.python.org  Fri Apr 11 22:03:17 2014
From: report at bugs.python.org (Madison May)
Date: Fri, 11 Apr 2014 20:03:17 +0000
Subject: [docs] [issue21202] Naming a file` io.py` causes cryptic error
	message
In-Reply-To: <1397239551.94.0.578791540537.issue21202@psf.upfronthosting.co.za>
Message-ID: <1397246597.13.0.750000012717.issue21202@psf.upfronthosting.co.za>


Madison May added the comment:

I definitely agree that io shouldn't be special cased, as it's more about the name shadowing issue that this specific example.

A simple docs addition would make me happy, to be honest.

----------

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

From report at bugs.python.org  Sat Apr 12 07:55:10 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Sat, 12 Apr 2014 05:55:10 +0000
Subject: [docs] [issue21196] Name mangling example in Python tutorial
In-Reply-To: <1397133080.37.0.870141660622.issue21196@psf.upfronthosting.co.za>
Message-ID: <1397282110.7.0.521700678326.issue21196@psf.upfronthosting.co.za>


?ric Araujo added the comment:

Thanks for the report and proposed fix!  Could you upload a patch file that we could directly apply to the documentation instead of Python files?  More information about how to do that is found here: https://docs.python.org/devguide/#quick-start

If you need any kind of help, the devguide has the address of the core-mentorship mailing list where many friendly people can answer questions.  You can also ask in this issue page.

----------
nosy: +eric.araujo
stage:  -> patch review
versions: +Python 2.7, Python 3.4, Python 3.5

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

From report at bugs.python.org  Sat Apr 12 08:28:32 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Sat, 12 Apr 2014 06:28:32 +0000
Subject: [docs] [issue21198] Minor tarfile documentation bug
In-Reply-To: <1397148227.41.0.631676560193.issue21198@psf.upfronthosting.co.za>
Message-ID: <1397284112.39.0.137299392355.issue21198@psf.upfronthosting.co.za>


?ric Araujo added the comment:

Thanks for the report.  Is it an issue in the docstrings, the HTML documentation or both?

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

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

From report at bugs.python.org  Sat Apr 12 11:58:57 2014
From: report at bugs.python.org (Florent Xicluna)
Date: Sat, 12 Apr 2014 09:58:57 +0000
Subject: [docs] [issue21202] Naming a file` io.py` causes cryptic error
	message
In-Reply-To: <1397239551.94.0.578791540537.issue21202@psf.upfronthosting.co.za>
Message-ID: <1397296737.7.0.959943404252.issue21202@psf.upfronthosting.co.za>


Changes by Florent Xicluna <florent.xicluna at gmail.com>:


----------
nosy: +flox

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

From report at bugs.python.org  Sat Apr 12 15:10:19 2014
From: report at bugs.python.org (Mark Dickinson)
Date: Sat, 12 Apr 2014 13:10:19 +0000
Subject: [docs] [issue20624] Clarify recommendation to inherit from Exception
In-Reply-To: <1392377489.91.0.767550317256.issue20624@psf.upfronthosting.co.za>
Message-ID: <1397308219.82.0.79925381287.issue20624@psf.upfronthosting.co.za>


Changes by Mark Dickinson <dickinsm at gmail.com>:


----------
assignee: docs at python -> mark.dickinson

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

From report at bugs.python.org  Sat Apr 12 16:06:01 2014
From: report at bugs.python.org (Eric V. Smith)
Date: Sat, 12 Apr 2014 14:06:01 +0000
Subject: [docs] [issue7951] Should str.format allow negative indexes when
	used for	__getitem__ access?
In-Reply-To: <1266450859.13.0.906832569526.issue7951@psf.upfronthosting.co.za>
Message-ID: <1397311561.76.0.948420441471.issue7951@psf.upfronthosting.co.za>


Changes by Eric V. Smith <eric at trueblade.com>:


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

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

From bgailer at gmail.com  Sun Apr 13 03:49:43 2014
From: bgailer at gmail.com (bob gailer)
Date: Sat, 12 Apr 2014 21:49:43 -0400
Subject: [docs] str.translate documentation error 3.3.3
Message-ID: <5349ED37.2080808@gmail.com>

str.translate(map)
Return a copy of the s where all characters have been mapped through the 
map which must be a dictionary of Unicode ordinals (integers) to Unicode 
ordinals, strings or None.

However map can also be a string or byte string of arbitrary length!

 >>> 'asdf'.translate('qwer')
'asdf'
 >>> 'asdf'.translate(b'qwer')
'asdf'
 >>> 'asdf'.translate('qwer'*100)
'wrqe'
 >>> 'asdf'.translate(b'qwer'*100)
'wrqe'

From report at bugs.python.org  Sun Apr 13 06:11:09 2014
From: report at bugs.python.org (R. David Murray)
Date: Sun, 13 Apr 2014 04:11:09 +0000
Subject: [docs] [issue21204] published examples don't work
In-Reply-To: <1397267440.3.0.253901505287.issue21204@psf.upfronthosting.co.za>
Message-ID: <1397362269.0.0.028197556952.issue21204@psf.upfronthosting.co.za>


R. David Murray added the comment:

Testing the documentation examples is a long term goal, which people occasionally contribute to.  I think there is an open issue about using the Sphinx doctest support, that for a long time was blocked by the documentation tool chain not using python3.  Some examples are very hard to run in an automated fashion, as well.  Perhaps the examples can be tweaked...but in some cases they can't, without losing their teaching value.  I have a feeling the multiprocessing examples fall into this category, as I seem to remember doing a pass of testing of them a (python3) release or two ago.  I did not test them on windows, though.

----------
assignee:  -> docs at python
components: +Documentation -Cross-Build
nosy: +docs at python, r.david.murray

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

From report at bugs.python.org  Sun Apr 13 09:15:40 2014
From: report at bugs.python.org (=?utf-8?q?Martin_v=2E_L=C3=B6wis?=)
Date: Sun, 13 Apr 2014 07:15:40 +0000
Subject: [docs] [issue21204] published examples don't work
In-Reply-To: <1397267440.3.0.253901505287.issue21204@psf.upfronthosting.co.za>
Message-ID: <1397373340.91.0.910922785081.issue21204@psf.upfronthosting.co.za>


Martin v. L?wis added the comment:

jmaki: not sure what the issue is that you are reporting. I can see three different possible issues.
1. "Would you consider putting examples...". As R. David said: yes, we consider it. If you really wanted to know whether we consider it, we could close the issue as fixed.

2. "Please make examples ...". This would be a (near) duplicate of #15939, so I should close this issue as a duplicate.

3. "The specific example does not work on Windows". This issue should stay open until it is analysed an possibly fixed. If that is the issue, then it would be helpful if you could report how exactly the example fails.

I'd like to see a strict "one issue at a time" policy in this tracker, so please let us know how you would like us to proceed.

----------
nosy: +loewis

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

From report at bugs.python.org  Sun Apr 13 10:50:51 2014
From: report at bugs.python.org (=?utf-8?q?Martin_v=2E_L=C3=B6wis?=)
Date: Sun, 13 Apr 2014 08:50:51 +0000
Subject: [docs] [issue21202] Naming a file` io.py` causes cryptic error
	message
In-Reply-To: <1397239551.94.0.578791540537.issue21202@psf.upfronthosting.co.za>
Message-ID: <1397379051.13.0.493358577177.issue21202@psf.upfronthosting.co.za>


Martin v. L?wis added the comment:

I think the AttributeError message should improve, and special-case certain common types, in particular modules. E.g. it could read

    AttributeError: module 'io' has no attribute 'BufferedIOBase'

or even

   AttributeError: <module 'io' from 'C:\\Program Files\\Python34\\lib\\io.py'> has no attribute 'BufferedIOBase'

IIUC, the first version would already have helped the OP, and the second version would have been dead-clear (except that it is a little verbose).

----------
nosy: +loewis

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

From report at bugs.python.org  Sun Apr 13 12:19:01 2014
From: report at bugs.python.org (Arfrever Frehtes Taifersar Arahesis)
Date: Sun, 13 Apr 2014 10:19:01 +0000
Subject: [docs] [issue20701] warning in compileall.rst
In-Reply-To: <1392912685.12.0.93082248857.issue20701@psf.upfronthosting.co.za>
Message-ID: <1397384341.11.0.258222938774.issue20701@psf.upfronthosting.co.za>


Arfrever Frehtes Taifersar Arahesis added the comment:

It seems to have been fixed by:

New changeset f8dbec87dbfe by Georg Brandl in branch '3.4':
Fix option description that is a warning in new Sphinx versions.
http://hg.python.org/cpython/rev/f8dbec87dbfe

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

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

From report at bugs.python.org  Sun Apr 13 12:19:13 2014
From: report at bugs.python.org (Arfrever Frehtes Taifersar Arahesis)
Date: Sun, 13 Apr 2014 10:19:13 +0000
Subject: [docs] [issue20702] warning in cmdline.rst
In-Reply-To: <1392912711.56.0.068160127769.issue20702@psf.upfronthosting.co.za>
Message-ID: <1397384353.9.0.491916151639.issue20702@psf.upfronthosting.co.za>


Arfrever Frehtes Taifersar Arahesis added the comment:

I cannot reproduce it with Sphinx 1.2.2. Can you still reproduce it? Which version of Sphinx?

----------
nosy: +Arfrever

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

From report at bugs.python.org  Sun Apr 13 12:19:27 2014
From: report at bugs.python.org (Arfrever Frehtes Taifersar Arahesis)
Date: Sun, 13 Apr 2014 10:19:27 +0000
Subject: [docs] [issue21210] Warnings in Doc/library/json.rst
Message-ID: <1397384367.1.0.38760092166.issue21210@psf.upfronthosting.co.za>


New submission from Arfrever Frehtes Taifersar Arahesis:

Warnings during building of documentation (with Sphinx 1.2.2):

${cpython_working_copy}/Doc/library/json.rst:593: WARNING: Malformed option description '[<infile>]', should look like "opt", "-opt args", "--opt args" or "/opt args"
${cpython_working_copy}/Doc/library/json.rst:609: WARNING: Malformed option description '[<outfile>]', should look like "opt", "-opt args", "--opt args" or "/opt args"


Probably introduced by:

New changeset a2ad16e86e60 by Benjamin Peterson in branch 'default':
improve the command-line interface of json.tool (closes #21000)
http://hg.python.org/cpython/rev/a2ad16e86e60

----------
assignee: docs at python
components: Documentation
messages: 216012
nosy: Arfrever, benjamin.peterson, berker.peksag, docs at python
priority: normal
severity: normal
status: open
title: Warnings in Doc/library/json.rst
versions: Python 3.5

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

From report at bugs.python.org  Sun Apr 13 12:43:18 2014
From: report at bugs.python.org (Berker Peksag)
Date: Sun, 13 Apr 2014 10:43:18 +0000
Subject: [docs] [issue21210] Warnings in Doc/library/json.rst
In-Reply-To: <1397384367.1.0.38760092166.issue21210@psf.upfronthosting.co.za>
Message-ID: <1397385798.64.0.392426531947.issue21210@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Thanks for the report Arfrever. Here's a patch to silence the warnings.

----------
keywords: +patch
Added file: http://bugs.python.org/file34797/issue21210.diff

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

From bgailer at gmail.com  Sun Apr 13 16:18:18 2014
From: bgailer at gmail.com (bob gailer)
Date: Sun, 13 Apr 2014 10:18:18 -0400
Subject: [docs] str.translate documentation error 3.3.3 ADDENDUM
Message-ID: <534A9CAA.2050806@gmail.com>

str.translate(map)
Return a copy of the s where all characters have been mapped through the 
map which must be
INSERT either
  a dictionary of Unicode ordinals (integers) to Unicode ordinals, 
strings or None
DELETE .

ADD: , or a string, bytes or bytearray. In this case the ord of each 
character in s is used as an index into map; the corresponding element 
of map replaces the character

From report at bugs.python.org  Sun Apr 13 22:51:46 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 13 Apr 2014 20:51:46 +0000
Subject: [docs] [issue7951] Should str.format allow negative indexes when
	used for	__getitem__ access?
In-Reply-To: <1266450859.13.0.906832569526.issue7951@psf.upfronthosting.co.za>
Message-ID: <1397422306.0.0.700082577391.issue7951@psf.upfronthosting.co.za>


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


----------
assignee: docs at python -> terry.reedy

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

From report at bugs.python.org  Mon Apr 14 01:43:30 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 13 Apr 2014 23:43:30 +0000
Subject: [docs] [issue7951] Should str.format allow negative indexes when
	used for	__getitem__ access?
In-Reply-To: <1266450859.13.0.906832569526.issue7951@psf.upfronthosting.co.za>
Message-ID: <1397432610.84.0.465837716319.issue7951@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

The doc bug is that the grammar block uses 'integer' (linked to https://docs.python.org/3/reference/lexical_analysis.html#grammar-token-integer) in
  arg_name          ::=  [identifier | integer]
  element_index     ::=  integer | index_string
when it should use 'decimalinteger' or even more exactly 'digit+'. The int() builtin uses the same relaxed rule when no base is given.
>>> 011
SyntaxError: invalid token
>>> int('011')
11
>>> '{[011]}'.format('abcdefghijlmn')
'm'

One possibity is to replace 'integer' in the grammar block with 'digit+' and perhaps leave the text alone. Another is to replace 'integer' with 'index_number', to go with 'index_string, and add the production "index_number ::= digit+". My though for the latter is that 'index_number' would connect better with 'number' as used in the text. A further option would be to actually replace 'number' in the text with 'index_number'.


PS to Todd. As much as possible, doc content changes should be separated from re-formatting. I believe the first block of your patch is purely a re-format

----------

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

From report at bugs.python.org  Mon Apr 14 01:52:25 2014
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 13 Apr 2014 23:52:25 +0000
Subject: [docs] [issue21210] Warnings in Doc/library/json.rst
In-Reply-To: <1397384367.1.0.38760092166.issue21210@psf.upfronthosting.co.za>
Message-ID: <3g6VBJ40N1z7LjX@mail.python.org>


Roundup Robot added the comment:

New changeset 399bf1638911 by Benjamin Peterson in branch 'default':
correct sphinx mark up for cmdline options (closes #21210)
http://hg.python.org/cpython/rev/399bf1638911

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

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

From report at bugs.python.org  Mon Apr 14 08:48:45 2014
From: report at bugs.python.org (Chandan Kumar)
Date: Mon, 14 Apr 2014 06:48:45 +0000
Subject: [docs] [issue21196] Name mangling example in Python tutorial
In-Reply-To: <1397133080.37.0.870141660622.issue21196@psf.upfronthosting.co.za>
Message-ID: <1397458125.27.0.484689314626.issue21196@psf.upfronthosting.co.za>


Chandan Kumar added the comment:

Uploading the patch for the improvement to the name mangling section of the Python tutorial.  Please note that the modification is much smaller than I proposed earlier.

----------
keywords: +patch
Added file: http://bugs.python.org/file34814/docs_name_mangling.patch

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

From report at bugs.python.org  Mon Apr 14 12:27:52 2014
From: report at bugs.python.org (Bill)
Date: Mon, 14 Apr 2014 10:27:52 +0000
Subject: [docs] [issue21212] Documentation of octal representation
Message-ID: <1397471272.26.0.476582477816.issue21212@psf.upfronthosting.co.za>


New submission from Bill:

This documentation section:
https://docs.python.org/3/faq/programming.html?highlight=octal#how-do-i-convert-a-string-to-a-number
seems still to refer to Python 2 octal representation rules.  So I think it needs updating.

----------
assignee: docs at python
components: Documentation
messages: 216069
nosy: docs at python, ees1wc
priority: normal
severity: normal
status: open
title: Documentation of octal representation
versions: Python 3.5

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

From report at bugs.python.org  Mon Apr 14 13:46:45 2014
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 14 Apr 2014 11:46:45 +0000
Subject: [docs] [issue21212] Documentation of octal representation
In-Reply-To: <1397471272.26.0.476582477816.issue21212@psf.upfronthosting.co.za>
Message-ID: <3g6p2Y0l1qz7LjN@mail.python.org>


Roundup Robot added the comment:

New changeset fb7bc8fe0d49 by Eric V. Smith in branch '3.4':
Fix text about int() with octal numbers. Closes #21212.
http://hg.python.org/cpython/rev/fb7bc8fe0d49

New changeset 6107a727c60a by Eric V. Smith in branch 'default':
Merge 3.4: Fix text about int() with octal numbers. Closes #21212.
http://hg.python.org/cpython/rev/6107a727c60a

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

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

From report at bugs.python.org  Mon Apr 14 13:47:23 2014
From: report at bugs.python.org (Eric V. Smith)
Date: Mon, 14 Apr 2014 11:47:23 +0000
Subject: [docs] [issue21212] Documentation of octal representation
In-Reply-To: <1397471272.26.0.476582477816.issue21212@psf.upfronthosting.co.za>
Message-ID: <1397476043.24.0.292131297627.issue21212@psf.upfronthosting.co.za>


Eric V. Smith added the comment:

Fixed. Thanks!

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

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

From report at bugs.python.org  Mon Apr 14 14:11:27 2014
From: report at bugs.python.org (Berker Peksag)
Date: Mon, 14 Apr 2014 12:11:27 +0000
Subject: [docs] [issue21212] Documentation of octal representation
In-Reply-To: <1397471272.26.0.476582477816.issue21212@psf.upfronthosting.co.za>
Message-ID: <1397477487.72.0.402973101875.issue21212@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Mon Apr 14 16:43:48 2014
From: report at bugs.python.org (Jessica McKellar)
Date: Mon, 14 Apr 2014 14:43:48 +0000
Subject: [docs] [issue19980] Improve help('non-topic') response
In-Reply-To: <1386984892.27.0.919528696836.issue19980@psf.upfronthosting.co.za>
Message-ID: <1397486628.48.0.807014364675.issue19980@psf.upfronthosting.co.za>


Jessica McKellar added the comment:

Elias, thanks for your patch!

I think it's important to add the second part of Terry's suggestion which gives the user a specific next step to take, namely:

> Try help('help') for information on recognized strings or help(str) for help on the str class.

Can you add that to your patch?

Additionally, we'll want to make sure we don't accidentally break this new functionality. Can you add a few test cases, for example what happens when you run help on a module (e.g. help("os"), 2) help on an instance of a class (e.g. help(1)), and help on a string that doesn't have a special meaning, (e.g. help("abcxyz"))?

I don't see any existing tests for help(), but it is an instance of site._Helper (as reported by type(help)), and site tests live in Lib/test/test_site.py. It also gets loaded into builtins, so tests could also live in Lib/test/test_builtins.py.

----------
nosy: +Jessica.McKellar, jesstess

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

From report at bugs.python.org  Mon Apr 14 17:20:59 2014
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 14 Apr 2014 15:20:59 +0000
Subject: [docs] [issue20624] Clarify recommendation to inherit from Exception
In-Reply-To: <1392377489.91.0.767550317256.issue20624@psf.upfronthosting.co.za>
Message-ID: <3g6tnk5sgkzQ5y@mail.python.org>


Roundup Robot added the comment:

New changeset 8dc1b45bd467 by Mark Dickinson in branch '3.4':
Issue #20624: Exception docs wording tweak - clarify that it's okay to inherit from a subclass of Exception.
http://hg.python.org/cpython/rev/8dc1b45bd467

New changeset 262204877004 by Mark Dickinson in branch 'default':
Issue #20624: Merge exception docs tweak from 3.4 branch.
http://hg.python.org/cpython/rev/262204877004

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

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

From report at bugs.python.org  Mon Apr 14 17:34:04 2014
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 14 Apr 2014 15:34:04 +0000
Subject: [docs] [issue20624] Clarify recommendation to inherit from Exception
In-Reply-To: <1392377489.91.0.767550317256.issue20624@psf.upfronthosting.co.za>
Message-ID: <3g6v4q3j5Pz7LjP@mail.python.org>


Roundup Robot added the comment:

New changeset f729a0e90c4f by Mark Dickinson in branch '2.7':
Issue #20624: Merge exception docs tweak from 3.4 branch.
http://hg.python.org/cpython/rev/f729a0e90c4f

----------

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

From report at bugs.python.org  Mon Apr 14 17:35:34 2014
From: report at bugs.python.org (Mark Dickinson)
Date: Mon, 14 Apr 2014 15:35:34 +0000
Subject: [docs] [issue20624] Clarify recommendation to inherit from Exception
In-Reply-To: <1392377489.91.0.767550317256.issue20624@psf.upfronthosting.co.za>
Message-ID: <1397489734.05.0.562219304177.issue20624@psf.upfronthosting.co.za>


Mark Dickinson added the comment:

Fixed.  Closing.

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

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

From report at bugs.python.org  Mon Apr 14 17:46:08 2014
From: report at bugs.python.org (Sam Lucidi)
Date: Mon, 14 Apr 2014 15:46:08 +0000
Subject: [docs] [issue15104] Unclear language in __main__ description
In-Reply-To: <1340092965.02.0.675870286607.issue15104@psf.upfronthosting.co.za>
Message-ID: <1397490368.2.0.288258037028.issue15104@psf.upfronthosting.co.za>


Sam Lucidi added the comment:

I've attempted to synthesize the ideas in this thread into a clearer explanation of __main__. What I've written doesn't attempt to explain anything else about module naming, but it does try to address the common package and module uses of __main__.

----------
keywords: +patch
nosy: +mansam
Added file: http://bugs.python.org/file34820/clarify-__main__-documentation.patch

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

From report at bugs.python.org  Mon Apr 14 18:01:34 2014
From: report at bugs.python.org (R. David Murray)
Date: Mon, 14 Apr 2014 16:01:34 +0000
Subject: [docs] [issue15104] Unclear language in __main__ description
In-Reply-To: <1340092965.02.0.675870286607.issue15104@psf.upfronthosting.co.za>
Message-ID: <1397491294.78.0.377454560177.issue15104@psf.upfronthosting.co.za>


R. David Murray added the comment:

I've made some review comments.

----------

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

From report at bugs.python.org  Mon Apr 14 18:01:54 2014
From: report at bugs.python.org (R. David Murray)
Date: Mon, 14 Apr 2014 16:01:54 +0000
Subject: [docs] [issue15104] Unclear language in __main__ description
In-Reply-To: <1340092965.02.0.675870286607.issue15104@psf.upfronthosting.co.za>
Message-ID: <1397491314.98.0.60385248393.issue15104@psf.upfronthosting.co.za>


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


----------
stage: needs patch -> patch review
versions: +Python 3.5 -Python 3.2, Python 3.3

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

From report at bugs.python.org  Mon Apr 14 18:10:55 2014
From: report at bugs.python.org (Sam Lucidi)
Date: Mon, 14 Apr 2014 16:10:55 +0000
Subject: [docs] [issue15104] Unclear language in __main__ description
In-Reply-To: <1340092965.02.0.675870286607.issue15104@psf.upfronthosting.co.za>
Message-ID: <1397491855.28.0.213070014535.issue15104@psf.upfronthosting.co.za>


Sam Lucidi added the comment:

Thanks, I've revised the change based on your comments.

----------
Added file: http://bugs.python.org/file34822/clarify-__main__-documentation.patch

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

From rdmurray at bitdance.com  Mon Apr 14 18:01:10 2014
From: rdmurray at bitdance.com (rdmurray at bitdance.com)
Date: Mon, 14 Apr 2014 16:01:10 -0000
Subject: [docs] Unclear language in __main__ description (issue 15104)
Message-ID: <20140414160110.9364.46206@psf.upfronthosting.co.za>


http://bugs.python.org/review/15104/diff/11565/Doc/library/__main__.rst
File Doc/library/__main__.rst (right):

http://bugs.python.org/review/15104/diff/11565/Doc/library/__main__.rst#newcode8
Doc/library/__main__.rst:8: __main__ is the name of the scope in which
top-level code executes.
Since this is the name, it should be in quotes.

http://bugs.python.org/review/15104/diff/11565/Doc/library/__main__.rst#newcode9
Doc/library/__main__.rst:9: A module's __name__ becomes equal to
'__main__' when read from
I think "is set equal to" would be better here.

http://bugs.python.org/review/15104/diff/11565/Doc/library/__main__.rst#newcode12
Doc/library/__main__.rst:12: A module can discover whether or not it is
the __main__ module by
'whether or not it is running in the main scope' would probably be more
accurate and consistent with the previous wording.  (A 'script' file can
also be a non-__main__ module if it is imported, which is the point of
the 'if' phrase.)

http://bugs.python.org/review/15104/diff/11565/Doc/library/__main__.rst#newcode21
Doc/library/__main__.rst:21: Alternatively, a package may include a
__main__.py module, the
I don't think this is an 'alternatively'.  How about, "For a package,
the same effect can be achieved by including a __main__.py module".

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

From report at bugs.python.org  Mon Apr 14 18:49:34 2014
From: report at bugs.python.org (jonathan ferretti)
Date: Mon, 14 Apr 2014 16:49:34 +0000
Subject: [docs] [issue18518] return-ing within code timed with timeit.timeit
	causes	wrong return value of timeit.timeit
In-Reply-To: <1374400020.0.0.45788018989.issue18518@psf.upfronthosting.co.za>
Message-ID: <1397494174.89.0.815689373994.issue18518@psf.upfronthosting.co.za>


jonathan ferretti added the comment:

Added note to timeit function briefly explaining how to avoid it the issue and the cause

----------
keywords: +patch
nosy: +jonathan.ferretti
type: enhancement -> behavior
Added file: http://bugs.python.org/file34823/timeit.patch

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

From report at bugs.python.org  Mon Apr 14 18:53:09 2014
From: report at bugs.python.org (Matt Chaput)
Date: Mon, 14 Apr 2014 16:53:09 +0000
Subject: [docs] [issue21198] Minor tarfile documentation bug
In-Reply-To: <1397148227.41.0.631676560193.issue21198@psf.upfronthosting.co.za>
Message-ID: <1397494389.36.0.588887654788.issue21198@psf.upfronthosting.co.za>


Matt Chaput added the comment:

Simple patch to remove the underscore in tarfile.rst.

----------
keywords: +patch
nosy: +maatt
Added file: http://bugs.python.org/file34824/issue21198.patch

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

From report at bugs.python.org  Mon Apr 14 18:54:57 2014
From: report at bugs.python.org (Matt Chaput)
Date: Mon, 14 Apr 2014 16:54:57 +0000
Subject: [docs] [issue21146] update gzip usage examples in docs
In-Reply-To: <1396521606.53.0.161098821761.issue21146@psf.upfronthosting.co.za>
Message-ID: <1397494497.22.0.444231942153.issue21146@psf.upfronthosting.co.za>


Matt Chaput added the comment:

The patch looks good to me.

----------
nosy: +maatt

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

From report at bugs.python.org  Mon Apr 14 18:56:18 2014
From: report at bugs.python.org (R. David Murray)
Date: Mon, 14 Apr 2014 16:56:18 +0000
Subject: [docs] [issue17009] "Thread Programming With Python" should be
	removed
In-Reply-To: <1358799622.32.0.0901338309925.issue17009@psf.upfronthosting.co.za>
Message-ID: <1397494578.74.0.496681015593.issue17009@psf.upfronthosting.co.za>


R. David Murray added the comment:

Well, with the new website the url now returns a 404, so I guess we can close this.  If someone wants to see it restored as a historical document, that would be an issue for the web site bug tracker.  But, since other essays exist, it looks like it was a conscious decision on someone's part to omit this one.

----------
nosy: +r.david.murray
resolution:  -> fixed
stage:  -> committed/rejected
status: open -> closed

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

From matt at whoosh.ca  Mon Apr 14 18:47:26 2014
From: matt at whoosh.ca (matt at whoosh.ca)
Date: Mon, 14 Apr 2014 16:47:26 -0000
Subject: [docs] Add doc examples for DictReader and DictWriter (issue
	20351)
Message-ID: <20140414164726.9364.15559@psf.upfronthosting.co.za>


http://bugs.python.org/review/20351/diff/11072/Doc/library/csv.rst
File Doc/library/csv.rst (right):

http://bugs.python.org/review/20351/diff/11072/Doc/library/csv.rst#newcode161
Doc/library/csv.rst:161: ...     reader = csv.DictReader(csvfile)
Don't you need to pass a list of column names here? If I just do
csv.DictReader(csvfile), I get row dicts like {None: ['Baked',
'Beans']}.

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

From report at bugs.python.org  Mon Apr 14 19:14:06 2014
From: report at bugs.python.org (Ned Deily)
Date: Mon, 14 Apr 2014 17:14:06 +0000
Subject: [docs] [issue17009] "Thread Programming With Python" should be
	removed
In-Reply-To: <1358799622.32.0.0901338309925.issue17009@psf.upfronthosting.co.za>
Message-ID: <1397495646.21.0.098667350487.issue17009@psf.upfronthosting.co.za>


Ned Deily added the comment:

I don't think it was a conscious decision. Unlike most of the others, the link for this essay is to the 2.2 docs tree.  I'm guessing there was a redirect there that has gone AWOL.

----------

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

From report at bugs.python.org  Mon Apr 14 19:23:50 2014
From: report at bugs.python.org (Guido van Rossum)
Date: Mon, 14 Apr 2014 17:23:50 +0000
Subject: [docs] [issue17009] "Thread Programming With Python" should be
	removed
In-Reply-To: <1358799622.32.0.0901338309925.issue17009@psf.upfronthosting.co.za>
Message-ID: <1397496230.73.0.133424858735.issue17009@psf.upfronthosting.co.za>


Changes by Guido van Rossum <guido at python.org>:


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

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

From report at bugs.python.org  Mon Apr 14 19:25:44 2014
From: report at bugs.python.org (Sam Lucidi)
Date: Mon, 14 Apr 2014 17:25:44 +0000
Subject: [docs] [issue18628] Better index entry for encoding declarations
In-Reply-To: <1375418984.87.0.318628832877.issue18628@psf.upfronthosting.co.za>
Message-ID: <1397496344.11.0.546657287462.issue18628@psf.upfronthosting.co.za>


Sam Lucidi added the comment:

Here's a patch which changes the entry in the index to "encoding declarations (source file)" per Terry's third point.

----------
keywords: +patch
nosy: +mansam
Added file: http://bugs.python.org/file34826/encoding-declarations-index.patch

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

From report at bugs.python.org  Mon Apr 14 19:40:06 2014
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 14 Apr 2014 17:40:06 +0000
Subject: [docs] [issue18518] return-ing within code timed with timeit.timeit
	causes	wrong return value of timeit.timeit
In-Reply-To: <1374400020.0.0.45788018989.issue18518@psf.upfronthosting.co.za>
Message-ID: <3g6xtD4zqNz7LjQ@mail.python.org>


Roundup Robot added the comment:

New changeset 7e2708484ea5 by Andrew Kuchling in branch '3.4':
#18518: mention that including a return statement changes/breaks the behaviour
http://hg.python.org/cpython/rev/7e2708484ea5

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

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

From report at bugs.python.org  Mon Apr 14 19:49:47 2014
From: report at bugs.python.org (jmaki)
Date: Mon, 14 Apr 2014 17:49:47 +0000
Subject: [docs] [issue21204] published examples don't work
In-Reply-To: <1397267440.3.0.253901505287.issue21204@psf.upfronthosting.co.za>
Message-ID: <1397497787.7.0.397495327613.issue21204@psf.upfronthosting.co.za>


jmaki added the comment:

loewis, r.david.murray: Please proceed in terms of #3--"The specific example does not work on Windows".  I am using python 2.7.6 on Windows 7.

Below is the failing message that happens immediately on startup, specifically, when hitting this line:
        Process(target=serve_forever, args=(server,)).start()

Thank you for the attention.

----- error message -----
Traceback (most recent call last):
  File "C:/Python27/httpthreadpool.py", line 75, in <module>
    test()
  File "C:/Python27/httpthreadpool.py", line 70, in test
    runpool(ADDRESS, NUMBER_OF_PROCESSES)
  File "C:/Python27/httpthreadpool.py", line 51, in runpool
    Process(target=serve_forever, args=(server,)).start()
  File "C:\Python27\lib\multiprocessing\process.py", line 130, in start
    self._popen = Popen(self)
  File "C:\Python27\lib\multiprocessing\forking.py", line 277, in __init__
    dump(process_obj, to_child, HIGHEST_PROTOCOL)
  File "C:\Python27\lib\multiprocessing\forking.py", line 199, in dump
    ForkingPickler(file, protocol).dump(obj)
  File "C:\Python27\lib\pickle.py", line 224, in dump
    self.save(obj)
  File "C:\Python27\lib\pickle.py", line 331, in save
    self.save_reduce(obj=obj, *rv)
  File "C:\Python27\lib\pickle.py", line 419, in save_reduce
    save(state)
  File "C:\Python27\lib\pickle.py", line 286, in save
    f(self, obj) # Call unbound method with explicit self
  File "C:\Python27\lib\pickle.py", line 649, in save_dict
    self._batch_setitems(obj.iteritems())
  File "C:\Python27\lib\pickle.py", line 681, in _batch_setitems
    save(v)
  File "C:\Python27\lib\pickle.py", line 286, in save
    f(self, obj) # Call unbound method with explicit self
  File "C:\Python27\lib\pickle.py", line 548, in save_tuple
    save(element)
  File "C:\Python27\lib\pickle.py", line 286, in save
    f(self, obj) # Call unbound method with explicit self
  File "C:\Python27\lib\pickle.py", line 725, in save_inst
    save(stuff)
  File "C:\Python27\lib\pickle.py", line 286, in save
    f(self, obj) # Call unbound method with explicit self
  File "C:\Python27\lib\pickle.py", line 649, in save_dict
    self._batch_setitems(obj.iteritems())
  File "C:\Python27\lib\pickle.py", line 681, in _batch_setitems
    save(v)
  File "C:\Python27\lib\pickle.py", line 331, in save
    self.save_reduce(obj=obj, *rv)
  File "C:\Python27\lib\pickle.py", line 419, in save_reduce
    save(state)
  File "C:\Python27\lib\pickle.py", line 286, in save
    f(self, obj) # Call unbound method with explicit self
  File "C:\Python27\lib\pickle.py", line 649, in save_dict
    self._batch_setitems(obj.iteritems())
  File "C:\Python27\lib\pickle.py", line 681, in _batch_setitems
    save(v)
  File "C:\Python27\lib\pickle.py", line 331, in save
    self.save_reduce(obj=obj, *rv)
  File "C:\Python27\lib\pickle.py", line 419, in save_reduce
    save(state)
  File "C:\Python27\lib\pickle.py", line 286, in save
    f(self, obj) # Call unbound method with explicit self
  File "C:\Python27\lib\pickle.py", line 649, in save_dict
    self._batch_setitems(obj.iteritems())
  File "C:\Python27\lib\pickle.py", line 681, in _batch_setitems
    save(v)
  File "C:\Python27\lib\pickle.py", line 331, in save
    self.save_reduce(obj=obj, *rv)
  File "C:\Python27\lib\pickle.py", line 396, in save_reduce
    save(cls)
  File "C:\Python27\lib\pickle.py", line 286, in save
    f(self, obj) # Call unbound method with explicit self
  File "C:\Python27\lib\pickle.py", line 748, in save_global
    (obj, module, name))
PicklingError: Can't pickle <type 'thread.lock'>: it's not found as thread.lock

----------

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

From report at bugs.python.org  Mon Apr 14 19:54:39 2014
From: report at bugs.python.org (R. David Murray)
Date: Mon, 14 Apr 2014 17:54:39 +0000
Subject: [docs] [issue18518] return-ing within code timed with timeit.timeit
	causes	wrong return value of timeit.timeit
In-Reply-To: <1374400020.0.0.45788018989.issue18518@psf.upfronthosting.co.za>
Message-ID: <1397498079.22.0.0372480378871.issue18518@psf.upfronthosting.co.za>


R. David Murray added the comment:

The suggestion was to make this a footnote, not a note.  Also, it should probably say that the stmt is executed inside a function, meaning that instead of being a syntax error it changes the return value of the internal timeit function.

I understand Raymond's desire not to clutter the docs, but I consider the footnote worth it, not to pre-inform the user, but to let them know that it is not a bug if they check the docs *after* things don't work right.  It may be naive of me to think that they would do so.

----------

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

From report at bugs.python.org  Mon Apr 14 20:00:48 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 14 Apr 2014 18:00:48 +0000
Subject: [docs] [issue18628] Better index entry for encoding declarations
In-Reply-To: <1375418984.87.0.318628832877.issue18628@psf.upfronthosting.co.za>
Message-ID: <1397498448.54.0.992485391269.issue18628@psf.upfronthosting.co.za>


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


----------
nosy: +eric.araujo
stage: needs patch -> patch review
versions: +Python 3.5 -Python 3.3

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

From report at bugs.python.org  Mon Apr 14 20:00:56 2014
From: report at bugs.python.org (A.M. Kuchling)
Date: Mon, 14 Apr 2014 18:00:56 +0000
Subject: [docs] [issue18518] return-ing within code timed with timeit.timeit
	causes	wrong return value of timeit.timeit
In-Reply-To: <1374400020.0.0.45788018989.issue18518@psf.upfronthosting.co.za>
Message-ID: <1397498456.29.0.10445435325.issue18518@psf.upfronthosting.co.za>


A.M. Kuchling added the comment:

I dislike footnotes and prefer to put things in the text whenever possible.  The text for this change struck as relevant enough -- it notes a property of the *stmt* parameter -- that it doesn't belong in a footnote.  (I'd be happy to just make it a paragraph instead of a highlighted note: I dislike notes too!)

----------
nosy: +akuchling

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

From report at bugs.python.org  Mon Apr 14 20:01:14 2014
From: report at bugs.python.org (A.M. Kuchling)
Date: Mon, 14 Apr 2014 18:01:14 +0000
Subject: [docs] [issue18518] return-ing within code timed with timeit.timeit
	causes	wrong return value of timeit.timeit
In-Reply-To: <1374400020.0.0.45788018989.issue18518@psf.upfronthosting.co.za>
Message-ID: <1397498473.95.0.149664197696.issue18518@psf.upfronthosting.co.za>


A.M. Kuchling added the comment:

BTW, this change is also relevant to 2.7.  Previously I wouldn't have bothered to commit it to 2.7 since the branch was largely closed, but now we're talking about some corporate maintainer eventually going through and backporting fixes to the newly-extended 2.7 branch.  So should I go ahead and apply it to 2.7?

----------

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

From report at bugs.python.org  Mon Apr 14 20:03:18 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Mon, 14 Apr 2014 18:03:18 +0000
Subject: [docs] [issue19980] Improve help('non-topic') response
In-Reply-To: <1386984892.27.0.919528696836.issue19980@psf.upfronthosting.co.za>
Message-ID: <1397498598.07.0.0981081234346.issue19980@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

help() uses lib/pydoc.py and pydoc tests are in test/test_pydoc.py
I think tests for things help does that pydoc does not do (help on topics?) should be in site.py.

----------

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

From report at bugs.python.org  Mon Apr 14 20:07:19 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 14 Apr 2014 18:07:19 +0000
Subject: [docs] [issue21146] update gzip usage examples in docs
In-Reply-To: <1396521606.53.0.161098821761.issue21146@psf.upfronthosting.co.za>
Message-ID: <1397498839.66.0.970428091575.issue21146@psf.upfronthosting.co.za>


?ric Araujo added the comment:

Isn?t there a buffering argument in open that can be used to avoid line buffering?

----------
nosy: +eric.araujo
versions: +Python 3.5 -Python 3.2, Python 3.3

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

From report at bugs.python.org  Mon Apr 14 20:12:52 2014
From: report at bugs.python.org (Sam Lucidi)
Date: Mon, 14 Apr 2014 18:12:52 +0000
Subject: [docs] [issue15104] Unclear language in __main__ description
In-Reply-To: <1340092965.02.0.675870286607.issue15104@psf.upfronthosting.co.za>
Message-ID: <1397499172.23.0.989405516125.issue15104@psf.upfronthosting.co.za>


Changes by Sam Lucidi <mansam at csh.rit.edu>:


Added file: http://bugs.python.org/file34831/clarify-__main__-documentation-backticks.patch

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

From report at bugs.python.org  Mon Apr 14 20:12:57 2014
From: report at bugs.python.org (Andrew Scheller)
Date: Mon, 14 Apr 2014 18:12:57 +0000
Subject: [docs] [issue21198] Minor tarfile documentation bug
In-Reply-To: <1397148227.41.0.631676560193.issue21198@psf.upfronthosting.co.za>
Message-ID: <1397499177.95.0.286368198042.issue21198@psf.upfronthosting.co.za>


Andrew Scheller added the comment:

?ric - appears to be only Doc/library/tarfile.rst that is affected.

Matt - looks like your "simple patch" contains a lot more than you intended?!

----------

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

From mansam at csh.rit.edu  Mon Apr 14 20:15:27 2014
From: mansam at csh.rit.edu (mansam at csh.rit.edu)
Date: Mon, 14 Apr 2014 18:15:27 -0000
Subject: [docs] Better index entry for encoding declarations (issue
	18628)
Message-ID: <20140414181527.16789.89844@psf.upfronthosting.co.za>


http://bugs.python.org/review/18628/diff/11570/Doc/reference/lexical_analysis.rst
File Doc/reference/lexical_analysis.rst (right):

http://bugs.python.org/review/18628/diff/11570/Doc/reference/lexical_analysis.rst#newcode79
Doc/reference/lexical_analysis.rst:79: .. index:: source character set,
encoding declarations (source file)
On 2014/04/14 20:00:27, eric.araujo wrote:
> Minor: I would use the singular here, ?declaration? (there is only one
in a
> file).

I used the plural to be consistent with the section header above, but I
am happy to change it if you like.

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

From report at bugs.python.org  Mon Apr 14 20:16:10 2014
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Mon, 14 Apr 2014 18:16:10 +0000
Subject: [docs] [issue21219] WARNING: Inline literal start-string without
	end-string.
Message-ID: <1397499370.92.0.332930990444.issue21219@psf.upfronthosting.co.za>


New submission from St?phane Wirtel:

When I build the documentation, I get a warning about the NEWS file. Just add a new patch for this warning.


> (sphinx) make html
sphinx-build -b html -d build/doctrees -D latex_paper_size=  . build/html
Making output directory...
Running Sphinx v1.2.2
loading pickled environment... not yet created
building [html]: targets for 455 source files that are out of date
updating environment: 455 added, 0 changed, 0 removed
reading sources... [100%] whatsnew/index
../../Misc/NEWS:44: WARNING: Inline literal start-string without end-string.
looking for now-outdated files... none found
pickling environment... done
checking consistency... done
preparing documents... done

----------
assignee: docs at python
components: Documentation
messages: 216149
nosy: docs at python, matrixise
priority: normal
severity: normal
status: open
title: WARNING: Inline literal start-string without end-string.
type: compile error
versions: Python 3.5

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

From report at bugs.python.org  Mon Apr 14 20:17:02 2014
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Mon, 14 Apr 2014 18:17:02 +0000
Subject: [docs] [issue21219] WARNING: Inline literal start-string without
	end-string.
In-Reply-To: <1397499370.92.0.332930990444.issue21219@psf.upfronthosting.co.za>
Message-ID: <1397499422.41.0.473193017999.issue21219@psf.upfronthosting.co.za>


St?phane Wirtel added the comment:

Here is the patch for this bug.

----------
keywords: +patch
Added file: http://bugs.python.org/file34833/issue21219_1.patch

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

From report at bugs.python.org  Mon Apr 14 20:19:31 2014
From: report at bugs.python.org (Zachary Ware)
Date: Mon, 14 Apr 2014 18:19:31 +0000
Subject: [docs] [issue21219] WARNING: Inline literal start-string without
	end-string.
In-Reply-To: <1397499370.92.0.332930990444.issue21219@psf.upfronthosting.co.za>
Message-ID: <1397499571.35.0.340912568014.issue21219@psf.upfronthosting.co.za>


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


----------
nosy: +orsenthil

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

From report at bugs.python.org  Mon Apr 14 20:21:57 2014
From: report at bugs.python.org (Sam Kimbrel)
Date: Mon, 14 Apr 2014 18:21:57 +0000
Subject: [docs] [issue10481] subprocess PIPEs are byte streams
In-Reply-To: <1290319024.08.0.519309863324.issue10481@psf.upfronthosting.co.za>
Message-ID: <1397499717.3.0.836867393453.issue10481@psf.upfronthosting.co.za>


Sam Kimbrel added the comment:

I've created a patch that updates the docs to reflect the behavior of communicate() and check_output(), which is that both the "input" argument and stdin/stdout/stderr PIPEs will convert to and from strings when self.univeral_newlines is True and must be bytes otherwise.

----------
keywords: +patch
nosy: +sam.kimbrel
Added file: http://bugs.python.org/file34834/10481-subprocess-docs.diff

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

From report at bugs.python.org  Mon Apr 14 20:22:49 2014
From: report at bugs.python.org (Senthil Kumaran)
Date: Mon, 14 Apr 2014 18:22:49 +0000
Subject: [docs] [issue21219] WARNING: Inline literal start-string without
	end-string.
In-Reply-To: <1397499370.92.0.332930990444.issue21219@psf.upfronthosting.co.za>
Message-ID: <1397499769.26.0.925181339471.issue21219@psf.upfronthosting.co.za>


Senthil Kumaran added the comment:

Oops did not notice. Thanks for catching.

----------

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

From report at bugs.python.org  Mon Apr 14 20:22:58 2014
From: report at bugs.python.org (Rafael Mejia)
Date: Mon, 14 Apr 2014 18:22:58 +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: <1397499778.8.0.472643413854.issue20874@psf.upfronthosting.co.za>


Rafael Mejia added the comment:

Please review that attached patch.  Feedback is welcome.

----------
keywords: +patch
nosy: +Israfil
Added file: http://bugs.python.org/file34835/issue_20874.patch

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

From report at bugs.python.org  Mon Apr 14 20:29:01 2014
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Mon, 14 Apr 2014 18:29:01 +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: <1397500141.43.0.674025238291.issue4744@psf.upfronthosting.co.za>


St?phane Wirtel added the comment:

Could you review your patch, there is a mistake in the name of the project, it's asynchat and not asychat. The content seems to be right, not the reference and the title.

Thank you so much for your help.

----------
nosy: +matrixise
versions: +Python 3.5 -Python 2.7, Python 3.3, Python 3.4

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

From report at bugs.python.org  Mon Apr 14 20:29:20 2014
From: report at bugs.python.org (Andrew Scheller)
Date: Mon, 14 Apr 2014 18:29:20 +0000
Subject: [docs] [issue21221] Minor struct_time documentation bug
Message-ID: <1397500160.88.0.743491348049.issue21221@psf.upfronthosting.co.za>


New submission from Andrew Scheller:

The documentation for time.struct_time (in Doc/library/time.rst) explains tm_isdst as "0, 1 or -1; see below" but then doesn't really go into further detail below, other than to say "A -1 argument as the daylight savings flag, passed to mktime() will usually result in the correct daylight savings state to be filled in.".

In Modules/timemodule.c there's a section which says:
{"tm_isdst", "1 if summer time is in effect, 0 if not, and -1 if unknown"},

IMHO it would be nice if this more accurate info was also present in the HTML documentation.

----------
assignee: docs at python
components: Documentation
messages: 216158
nosy: docs at python, lurchman
priority: normal
severity: normal
status: open
title: Minor struct_time documentation bug
type: enhancement
versions: Python 2.7, Python 3.4, Python 3.5

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

From report at bugs.python.org  Mon Apr 14 20:34:37 2014
From: report at bugs.python.org (Ned Deily)
Date: Mon, 14 Apr 2014 18:34:37 +0000
Subject: [docs] [issue10224] Build 3.x documentation using python3.x
In-Reply-To: <1288304199.49.0.7053863257.issue10224@psf.upfronthosting.co.za>
Message-ID: <1397500477.45.0.551759251549.issue10224@psf.upfronthosting.co.za>


Ned Deily added the comment:

For 3.4.1 and 3.5, the Doc/Makefile no longer explicitly vendors sphinx and its dependencies (via svn), rather it assumes that an externally-supplied sphinx-build is available, for example, via a venv and pip.  And the current versions of sphinx and its dependencies are all supported on current Py3's.  So can this issue be closed, Georg?

----------
assignee: docs at python -> 
nosy: +ned.deily
versions: +Python 3.5

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

From report at bugs.python.org  Mon Apr 14 20:35:02 2014
From: report at bugs.python.org (Senthil Kumaran)
Date: Mon, 14 Apr 2014 18:35:02 +0000
Subject: [docs] [issue21219] WARNING: Inline literal start-string without
	end-string.
In-Reply-To: <1397499370.92.0.332930990444.issue21219@psf.upfronthosting.co.za>
Message-ID: <1397500502.08.0.641847856648.issue21219@psf.upfronthosting.co.za>


Senthil Kumaran added the comment:

Fixed:
3.5 a85606b6de32
3.4 fb5516cbc522

----------
resolution:  -> fixed
stage:  -> committed/rejected
status: open -> closed
type: compile error -> behavior

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

From report at bugs.python.org  Mon Apr 14 20:58:51 2014
From: report at bugs.python.org (A.M. Kuchling)
Date: Mon, 14 Apr 2014 18:58:51 +0000
Subject: [docs] [issue10481] subprocess PIPEs are byte streams
In-Reply-To: <1290319024.08.0.519309863324.issue10481@psf.upfronthosting.co.za>
Message-ID: <1397501931.97.0.271348969421.issue10481@psf.upfronthosting.co.za>


Changes by A.M. Kuchling <amk at amk.ca>:


----------
versions: +Python 3.5 -Python 3.2

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

From report at bugs.python.org  Mon Apr 14 20:59:36 2014
From: report at bugs.python.org (=?utf-8?q?Martin_v=2E_L=C3=B6wis?=)
Date: Mon, 14 Apr 2014 18:59:36 +0000
Subject: [docs] [issue21204] multiprocessing example does not work on Windows
In-Reply-To: <1397267440.3.0.253901505287.issue21204@psf.upfronthosting.co.za>
Message-ID: <1397501976.49.0.724394702694.issue21204@psf.upfronthosting.co.za>


Changes by Martin v. L?wis <martin at v.loewis.de>:


----------
title: published examples don't work -> multiprocessing example does not work on Windows

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

From report at bugs.python.org  Mon Apr 14 21:00:24 2014
From: report at bugs.python.org (Christian Hudon)
Date: Mon, 14 Apr 2014 19:00:24 +0000
Subject: [docs] [issue20103] Documentation of itertools.accumulate is
	confused
In-Reply-To: <1388592720.87.0.970906154406.issue20103@psf.upfronthosting.co.za>
Message-ID: <1397502024.19.0.0715521165939.issue20103@psf.upfronthosting.co.za>


Christian Hudon added the comment:

The following patch improves (I hope) the documentation of itertools.accumulate. Comments and feedback welcome.

Terry, I did not implement your suggestion of changing "returns" to "yields", as it would have made things inconsistent with the documentation (and docstrings) of pretty much all the other generators in the itertools module, as they all use this idiom also. If one of the Python documentation experts thinks this change is also a good idea, please just open a new bug report for that and put me in the nosy list, and I'll do the change for all relevant generators in the itertools module.

----------
keywords: +patch
nosy: +chrish42
Added file: http://bugs.python.org/file34839/accumulate_doc.patch

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

From report at bugs.python.org  Mon Apr 14 21:06:09 2014
From: report at bugs.python.org (Sam Kimbrel)
Date: Mon, 14 Apr 2014 19:06:09 +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: <1397502369.74.0.344581652074.issue20956@psf.upfronthosting.co.za>


Sam Kimbrel added the comment:

Attached patch to update 2.7 docs to refer to the plain-old-tuple returned from generate_tokens().

----------
keywords: +patch
nosy: +sam.kimbrel
Added file: http://bugs.python.org/file34841/20956-tokenize-docs.diff

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

From report at bugs.python.org  Mon Apr 14 21:06:17 2014
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 14 Apr 2014 19:06:17 +0000
Subject: [docs] [issue15104] Unclear language in __main__ description
In-Reply-To: <1340092965.02.0.675870286607.issue15104@psf.upfronthosting.co.za>
Message-ID: <3g6znh4Wx0z7Lk7@mail.python.org>


Roundup Robot added the comment:

New changeset 4f23648b7c97 by R David Murray in branch '3.4':
#15104: improve the discussion of __main__.
http://hg.python.org/cpython/rev/4f23648b7c97

New changeset 94ac365bf1b7 by R David Murray in branch 'default':
Merge: #15104: improve the discussion of __main__.
http://hg.python.org/cpython/rev/94ac365bf1b7

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

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

From report at bugs.python.org  Mon Apr 14 21:07:33 2014
From: report at bugs.python.org (R. David Murray)
Date: Mon, 14 Apr 2014 19:07:33 +0000
Subject: [docs] [issue15104] Unclear language in __main__ description
In-Reply-To: <1340092965.02.0.675870286607.issue15104@psf.upfronthosting.co.za>
Message-ID: <1397502453.2.0.377289178481.issue15104@psf.upfronthosting.co.za>


R. David Murray added the comment:

Thanks, Sam.  I did not apply this to 2.7 because I'm not sure if the __main__.py is supported there.  Can someone check?

----------
type: enhancement -> behavior
versions:  -Python 3.4, Python 3.5

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

From report at bugs.python.org  Mon Apr 14 21:07:35 2014
From: report at bugs.python.org (R. David Murray)
Date: Mon, 14 Apr 2014 19:07:35 +0000
Subject: [docs] [issue15104] Unclear language in __main__ description
In-Reply-To: <1340092965.02.0.675870286607.issue15104@psf.upfronthosting.co.za>
Message-ID: <1397502455.32.0.271123478634.issue15104@psf.upfronthosting.co.za>


R. David Murray added the comment:

Thanks, Sam.  I did not apply this to 2.7 because I'm not sure if the __main__.py is supported there.  Can someone check?

----------

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

From report at bugs.python.org  Mon Apr 14 21:07:55 2014
From: report at bugs.python.org (R. David Murray)
Date: Mon, 14 Apr 2014 19:07:55 +0000
Subject: [docs] [issue15104] Unclear language in __main__ description
In-Reply-To: <1340092965.02.0.675870286607.issue15104@psf.upfronthosting.co.za>
Message-ID: <1397502475.66.0.830146467536.issue15104@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Mon Apr 14 21:08:42 2014
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 14 Apr 2014 19:08:42 +0000
Subject: [docs] [issue10481] subprocess PIPEs are byte streams
In-Reply-To: <1290319024.08.0.519309863324.issue10481@psf.upfronthosting.co.za>
Message-ID: <3g6zrV0bc7z7LjQ@mail.python.org>


Roundup Robot added the comment:

New changeset 267fff541bda by Andrew Kuchling in branch 'default':
#10481: describe universal_newlines' effect on communicate()/check_output() output (alternately bytes or strings)
http://hg.python.org/cpython/rev/267fff541bda

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

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

From report at bugs.python.org  Mon Apr 14 21:10:18 2014
From: report at bugs.python.org (A.M. Kuchling)
Date: Mon, 14 Apr 2014 19:10:18 +0000
Subject: [docs] [issue10481] subprocess PIPEs are byte streams
In-Reply-To: <1290319024.08.0.519309863324.issue10481@psf.upfronthosting.co.za>
Message-ID: <1397502618.23.0.0228750729991.issue10481@psf.upfronthosting.co.za>


A.M. Kuchling added the comment:

Thanks for your patch!

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

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

From report at bugs.python.org  Mon Apr 14 21:11:42 2014
From: report at bugs.python.org (Caelyn McAulay)
Date: Mon, 14 Apr 2014 19:11:42 +0000
Subject: [docs] [issue15840] Ambiguity with regard to the effect of
	accessing a	closed IOBase instance
In-Reply-To: <1346524424.76.0.407141547435.issue15840@psf.upfronthosting.co.za>
Message-ID: <1397502702.87.0.867205752599.issue15840@psf.upfronthosting.co.za>


Caelyn McAulay added the comment:

Changed documentation to state that ValueError should be raised if any operation (excluding close()) is called on a closed stream.

This appears to be what is done in iobase.c; and some investigation of inheriting types (rawiobase, fileio, bufferedio, etc.) indicates that there is nowhere where an IOError is being raised instead.

Sphinx documentation appears to already be update to date.

Is there any known place where operations on a closed stream raise IOError? I am currently assuming no.

----------
keywords: +patch
nosy: +math_foo
Added file: http://bugs.python.org/file34843/comment15840.patch

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

From report at bugs.python.org  Mon Apr 14 21:19:30 2014
From: report at bugs.python.org (A.M. Kuchling)
Date: Mon, 14 Apr 2014 19:19:30 +0000
Subject: [docs] [issue17380] initproc return value is unclear
In-Reply-To: <1362676337.45.0.36627137275.issue17380@psf.upfronthosting.co.za>
Message-ID: <1397503170.15.0.374786611578.issue17380@psf.upfronthosting.co.za>


Changes by A.M. Kuchling <amk at amk.ca>:


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

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

From report at bugs.python.org  Mon Apr 14 21:24:00 2014
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Mon, 14 Apr 2014 19:24:00 +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: <1397503440.2.0.255190786145.issue20874@psf.upfronthosting.co.za>


St?phane Wirtel added the comment:

In your patch, you do not explain how to enable the command line editing. Can you add this part, or just add the reference to the existing doc?

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

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

From report at bugs.python.org  Mon Apr 14 21:24:45 2014
From: report at bugs.python.org (Georg Brandl)
Date: Mon, 14 Apr 2014 19:24:45 +0000
Subject: [docs] [issue10224] Build 3.x documentation using python3.x
In-Reply-To: <1288304199.49.0.7053863257.issue10224@psf.upfronthosting.co.za>
Message-ID: <1397503485.48.0.578735096789.issue10224@psf.upfronthosting.co.za>


Georg Brandl added the comment:

Yep, thanks for the reminder.

----------
resolution:  -> out of date
status: open -> closed

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

From report at bugs.python.org  Mon Apr 14 21:26:43 2014
From: report at bugs.python.org (=?utf-8?q?Martin_v=2E_L=C3=B6wis?=)
Date: Mon, 14 Apr 2014 19:26:43 +0000
Subject: [docs] [issue21204] multiprocessing example does not work on Windows
In-Reply-To: <1397267440.3.0.253901505287.issue21204@psf.upfronthosting.co.za>
Message-ID: <1397503603.75.0.708397922887.issue21204@psf.upfronthosting.co.za>


Martin v. L?wis added the comment:

Ah, Python 2.7. Note that the example is gone in Python 3, as part of the large change in issue8713.

----------

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

From report at bugs.python.org  Mon Apr 14 21:27:02 2014
From: report at bugs.python.org (=?utf-8?q?Martin_v=2E_L=C3=B6wis?=)
Date: Mon, 14 Apr 2014 19:27:02 +0000
Subject: [docs] [issue21204] multiprocessing example does not work on Windows
In-Reply-To: <1397267440.3.0.253901505287.issue21204@psf.upfronthosting.co.za>
Message-ID: <1397503622.61.0.0138049164018.issue21204@psf.upfronthosting.co.za>


Changes by Martin v. L?wis <martin at v.loewis.de>:


----------
nosy:  -loewis

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

From report at bugs.python.org  Mon Apr 14 21:36:13 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 14 Apr 2014 19:36:13 +0000
Subject: [docs] [issue10224] Build 3.x documentation using python3.x
In-Reply-To: <1288304199.49.0.7053863257.issue10224@psf.upfronthosting.co.za>
Message-ID: <1397504173.86.0.384846300811.issue10224@psf.upfronthosting.co.za>


?ric Araujo added the comment:

Do we need to change Doc/Makefile to have ?PYTHON = python3? or even ?PYTHON = ./python? (so doctests run with the development version)?

----------

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

From report at bugs.python.org  Mon Apr 14 22:01:55 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Mon, 14 Apr 2014 20:01:55 +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: <1397505715.02.0.277758902163.issue20956@psf.upfronthosting.co.za>


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


----------
assignee: docs at python -> terry.reedy

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

From report at bugs.python.org  Mon Apr 14 22:09:35 2014
From: report at bugs.python.org (jmaki)
Date: Mon, 14 Apr 2014 20:09:35 +0000
Subject: [docs] [issue21204] multiprocessing example does not work on Windows
In-Reply-To: <1397267440.3.0.253901505287.issue21204@psf.upfronthosting.co.za>
Message-ID: <1397506175.74.0.337373284291.issue21204@psf.upfronthosting.co.za>


jmaki added the comment:

Upon further investigation, this may be related to:
http://bugs.python.org/issue1378
However, it seems the issue is not checked-in to Windows release for 2.x?

Regards,
John

----------

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

From report at bugs.python.org  Mon Apr 14 22:17:44 2014
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 14 Apr 2014 20:17:44 +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: <3g71N80JVzz7LjS@mail.python.org>


Roundup Robot added the comment:

New changeset d4f5a88b94b4 by Terry Jan Reedy in branch '2.7':
Closes #20956: 2.7 tokenize does not produce named tuples. Patch by Sam Kimbrel.
http://hg.python.org/cpython/rev/d4f5a88b94b4

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

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

From report at bugs.python.org  Mon Apr 14 22:19:23 2014
From: report at bugs.python.org (R. David Murray)
Date: Mon, 14 Apr 2014 20:19:23 +0000
Subject: [docs] [issue18518] return-ing within code timed with timeit.timeit
	causes	wrong return value of timeit.timeit
In-Reply-To: <1374400020.0.0.45788018989.issue18518@psf.upfronthosting.co.za>
Message-ID: <1397506763.25.0.615482887178.issue18518@psf.upfronthosting.co.za>


R. David Murray added the comment:

OK, if you think it is worthwhile in the text, then sure.  But yeah, not as a ..note.  And yes, I think we should keep backporting relevant doc patches.  Especially since Google results still land one on the 2.7 docs...

----------

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

From report at bugs.python.org  Mon Apr 14 23:00:22 2014
From: report at bugs.python.org (R. David Murray)
Date: Mon, 14 Apr 2014 21:00:22 +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: <1397509222.93.0.601158205848.issue20874@psf.upfronthosting.co.za>


R. David Murray added the comment:

Just as a point of information, when making a patch like this it is best to change the smallest number of lines possible, without worrying about line wrapping.  This allows us to see just what was changed.  The committer can then reflow the paragraph (actually I prefer to commit the minimum change and then do a separate reflow commit).

The patch itself looks fine.  St?phane: the original docs didn't explain it either, and in 3.4 you don't have to do anything to enable it.  (That is, if it isn't automatically enabled, it *can't* be turned on, because readline isn't available.)

----------

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

From report at bugs.python.org  Mon Apr 14 23:04:07 2014
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Mon, 14 Apr 2014 21:04:07 +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: <1397509447.04.0.342586199567.issue20874@psf.upfronthosting.co.za>


St?phane Wirtel added the comment:

David, thank you for this comment about the automatic activation of the command line editing.

----------

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

From report at bugs.python.org  Mon Apr 14 23:04:25 2014
From: report at bugs.python.org (R. David Murray)
Date: Mon, 14 Apr 2014 21:04:25 +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: <1397509465.26.0.209843110175.issue20874@psf.upfronthosting.co.za>


R. David Murray added the comment:

Actually I take it back, the patch as a patch also has a couple issues: the line lengths are not in fact less than 80 characters in any case, and there is trailing whitespace on several lines.

Could you redo it with just the minimum lines changed and no trailing whitespace?

----------

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

From report at bugs.python.org  Mon Apr 14 23:05:31 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Mon, 14 Apr 2014 21:05:31 +0000
Subject: [docs] [issue15104] Unclear language in __main__ description
In-Reply-To: <1340092965.02.0.675870286607.issue15104@psf.upfronthosting.co.za>
Message-ID: <1397509531.15.0.931303906516.issue15104@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

I am a bit puzzled. According to
https://docs.python.org/2.7/using/cmdline.html#interface-options __main__.py (not indexed) has been supported since 2.5. On the other hand, recursively grepping Lib for 'e' in __main__.py files hits about 20 files in 3.4 but only 2 in 2.7. Moreover, those two files fail for trying to do relative imports: "from .main import main, TestProgram, USAGE_AS_MAIN".

----------

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

From report at bugs.python.org  Mon Apr 14 23:45:51 2014
From: report at bugs.python.org (Senthil Kumaran)
Date: Mon, 14 Apr 2014 21:45:51 +0000
Subject: [docs] [issue10318] "make altinstall" installs many files with
	incorrect	shebangs
In-Reply-To: <1288926610.35.0.932494150274.issue10318@psf.upfronthosting.co.za>
Message-ID: <1397511951.86.0.735769574744.issue10318@psf.upfronthosting.co.za>


Changes by Senthil Kumaran <senthil at uthcode.com>:


----------
nosy:  -orsenthil

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

From report at bugs.python.org  Mon Apr 14 23:46:48 2014
From: report at bugs.python.org (Senthil Kumaran)
Date: Mon, 14 Apr 2014 21:46:48 +0000
Subject: [docs] [issue16278] Improve os.rename documentation and tests
In-Reply-To: <1350581776.08.0.668682100781.issue16278@psf.upfronthosting.co.za>
Message-ID: <1397512008.63.0.650592926328.issue16278@psf.upfronthosting.co.za>


Changes by Senthil Kumaran <senthil at uthcode.com>:


----------
nosy:  -orsenthil

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

From report at bugs.python.org  Tue Apr 15 00:12:39 2014
From: report at bugs.python.org (Rafael Mejia)
Date: Mon, 14 Apr 2014 22:12:39 +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: <1397513559.71.0.106291924225.issue20874@psf.upfronthosting.co.za>


Rafael Mejia added the comment:

I've resubmitted the patch with the minimum lines changed and no trailing white space.

----------
Added file: http://bugs.python.org/file34856/issue_20874_2.patch

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

From report at bugs.python.org  Tue Apr 15 00:23:12 2014
From: report at bugs.python.org (Matt Chaput)
Date: Mon, 14 Apr 2014 22:23:12 +0000
Subject: [docs] [issue21198] Minor tarfile documentation bug
In-Reply-To: <1397148227.41.0.631676560193.issue21198@psf.upfronthosting.co.za>
Message-ID: <1397514192.86.0.0265822079495.issue21198@psf.upfronthosting.co.za>


Changes by Matt Chaput <matt at whoosh.ca>:


Removed file: http://bugs.python.org/file34824/issue21198.patch

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

From report at bugs.python.org  Tue Apr 15 00:23:56 2014
From: report at bugs.python.org (Matt Chaput)
Date: Mon, 14 Apr 2014 22:23:56 +0000
Subject: [docs] [issue21198] Minor tarfile documentation bug
In-Reply-To: <1397148227.41.0.631676560193.issue21198@psf.upfronthosting.co.za>
Message-ID: <1397514236.8.0.7096283997.issue21198@psf.upfronthosting.co.za>


Matt Chaput added the comment:

Oops! Yes, I accidentally included a bunch of other crap.

----------

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

From report at bugs.python.org  Tue Apr 15 00:32:18 2014
From: report at bugs.python.org (R. David Murray)
Date: Mon, 14 Apr 2014 22:32:18 +0000
Subject: [docs] [issue21204] multiprocessing example does not work on Windows
In-Reply-To: <1397267440.3.0.253901505287.issue21204@psf.upfronthosting.co.za>
Message-ID: <1397514738.61.0.795685487075.issue21204@psf.upfronthosting.co.za>


R. David Murray added the comment:

If you look at the source code for 2.7, it is clear that patch has been applied.

----------

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

From report at bugs.python.org  Tue Apr 15 00:35:35 2014
From: report at bugs.python.org (R. David Murray)
Date: Mon, 14 Apr 2014 22:35:35 +0000
Subject: [docs] [issue21204] multiprocessing example does not work on Windows
In-Reply-To: <1397267440.3.0.253901505287.issue21204@psf.upfronthosting.co.za>
Message-ID: <1397514935.93.0.20931366251.issue21204@psf.upfronthosting.co.za>


R. David Murray added the comment:

To clarify, the commit in that issue is in 2.7.  So if there is something else that isn't in 2.7, it is a different issue.

----------

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

From report at bugs.python.org  Tue Apr 15 00:53:44 2014
From: report at bugs.python.org (Alex Lord)
Date: Mon, 14 Apr 2014 22:53:44 +0000
Subject: [docs] [issue18262] ZipInfo.external_attr are not documented
In-Reply-To: <1371622762.23.0.278457180872.issue18262@psf.upfronthosting.co.za>
Message-ID: <1397516024.03.0.521194755334.issue18262@psf.upfronthosting.co.za>


Alex Lord added the comment:

Here's a documentation patch for 2.7 that informs the users that Zipfile.extra and Zipfile.extraall don't save permissions and that Zipfile.writestr will use ZipInfo.extra_attr or default to chmod permission set of 0600.

----------
keywords: +patch
nosy: +Alex.Lord
versions:  -Python 2.6, Python 3.1, Python 3.2, Python 3.3, Python 3.4
Added file: http://bugs.python.org/file34858/Issue18262_27.patch

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

From report at bugs.python.org  Tue Apr 15 00:54:32 2014
From: report at bugs.python.org (Alex Lord)
Date: Mon, 14 Apr 2014 22:54:32 +0000
Subject: [docs] [issue18262] ZipInfo.external_attr are not documented
In-Reply-To: <1371622762.23.0.278457180872.issue18262@psf.upfronthosting.co.za>
Message-ID: <1397516072.17.0.9747231512.issue18262@psf.upfronthosting.co.za>


Alex Lord added the comment:

And here's the 3.4 and 3.5 patch

----------
Added file: http://bugs.python.org/file34859/Issue18262_34_35.patch

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

From report at bugs.python.org  Tue Apr 15 00:54:42 2014
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 14 Apr 2014 22:54:42 +0000
Subject: [docs] [issue15104] Unclear language in __main__ description
In-Reply-To: <1340092965.02.0.675870286607.issue15104@psf.upfronthosting.co.za>
Message-ID: <3g74sF6cx2z7LjS@mail.python.org>


Roundup Robot added the comment:

New changeset 008486e18e90 by R David Murray in branch '3.4':
#15104: add backtick code markup.
http://hg.python.org/cpython/rev/008486e18e90

New changeset 14e874736d3a by R David Murray in branch 'default':
Merge: #15104: add backtick code markup.
http://hg.python.org/cpython/rev/14e874736d3a

----------

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

From report at bugs.python.org  Tue Apr 15 02:02:39 2014
From: report at bugs.python.org (leewz)
Date: Tue, 15 Apr 2014 00:02:39 +0000
Subject: [docs] [issue21227] Decimal class error messages for integer
	division aren't	good
Message-ID: <1397520159.39.0.440264883295.issue21227@psf.upfronthosting.co.za>


New submission from leewz:

Python's `decimal.Decimal` doesn't seem to like taking modulo or intdiv of large Decimals by integers (where "large" depends on how many digits are internally stored).

    >>> from decimal import *
    >>> getcontext().prec
    28
    >>> Decimal(10**29)%1
    Traceback (most recent call last):
      File "<stdin>", line 1, in <module>
    decimal.InvalidOperation: [<class 'decimal.DivisionImpossible'>]
    >>> getcontext().prec=50
    >>> Decimal(10**29)%1
    Decimal('0')

Same for `Decimal(10**29)//1`

This is a logical problem: "Alice has a 100-digit number which begins with 1543256. What is the last digit?"

But I found the error hard to understand. Searching for "DivisionImpossible" didn't turn up anything immediate (it wasn't added to the official docs?). I was most of the way through writing out a question to StackOverflow when it clicked. (Also, why is it an InvalidOperation that holds an exception as a message? Never saw that before.)

Suggestions:
- Improve docs with further examples. The examples of InvalidOperation are logical MATH errors (e.g. division by 0), not logical PROGRAMMING errors.
- Uh, maybe the error message could be changed to something like, "The answer you seek lies beyond the mantissa." Or more sanely, "Not enough precision to compute the answer." Or something else that hints to me to look into precision.

----------
assignee: docs at python
components: Documentation, Library (Lib)
messages: 216253
nosy: docs at python, leewz
priority: normal
severity: normal
status: open
title: Decimal class error messages for integer division aren't good
type: enhancement
versions: Python 3.3, Python 3.4

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

From report at bugs.python.org  Tue Apr 15 02:08:03 2014
From: report at bugs.python.org (=?utf-8?q?Evens_Fortun=C3=A9?=)
Date: Tue, 15 Apr 2014 00:08:03 +0000
Subject: [docs] [issue21228] Missing enumeration of HTTPResponse Objects
	methods of	urllib.request.urlopen's http.client.HTTPResponse?
Message-ID: <1397520483.48.0.224250148615.issue21228@psf.upfronthosting.co.za>


New submission from Evens Fortun?:

In the Python Library documentation, in section "21.6. urllib.request ? Extensible library for opening URLs", in the description of the urllib.request.urlopen() function it is writen:

---------

[?]
For http and https urls, this function returns a http.client.HTTPResponse object which has the following HTTPResponse Objects methods.

For ftp, file, and data urls and requests explicity handled by legacy [?]

---------

The first sentence seemed to imply that something is supposed to be specified if I understand correctly. Is it me missing something??

----------
assignee: docs at python
components: Documentation
messages: 216254
nosy: EvensF, docs at python
priority: normal
severity: normal
status: open
title: Missing enumeration of HTTPResponse Objects methods of urllib.request.urlopen's http.client.HTTPResponse?
type: enhancement
versions: Python 3.2, Python 3.3, Python 3.4, Python 3.5

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

From report at bugs.python.org  Tue Apr 15 02:36:23 2014
From: report at bugs.python.org (=?utf-8?q?Evens_Fortun=C3=A9?=)
Date: Tue, 15 Apr 2014 00:36:23 +0000
Subject: [docs] [issue21229] Path used for HTTP PUT request doesn't match
	the	description
Message-ID: <1397522183.41.0.398189687255.issue21229@psf.upfronthosting.co.za>


New submission from Evens Fortun?:

In the Python Standard Library, at the end of :
 - Section "20.7.3. Examples" of "20.7. httplib ? HTTP protocol client" (for Python 2.7.6) 
 - Section "20.10.3. Examples" of "20.10. http.client ? HTTP protocol client" (for Python 3.2.5)
 - Section "21.12.3. Examples" of "21.12. http.client ? HTTP protocol client" (for Python 3.3.5, Python 3.4.0, and Python 3.5a0)

the last example is described this way (change httplib for http.client for Python 3.2+):

--------

>>> # This creates an HTTP message
>>> # with the content of BODY as the enclosed representation
>>> # for the resource http://localhost:8080/foobar
...
>>> import httplib
>>> BODY = "***filecontents***"
>>> conn = httplib.HTTPConnection("localhost", 8080)
>>> conn.request("PUT", "/file", BODY)
>>> response = conn.getresponse()
>>> print response.status, response.reason
200, OK

--------

Is it possible that the request method should have been called this way:

conn.request("PUT", "/foobar", BODY)
                      ^^^^^^
Thank you

----------
assignee: docs at python
components: Documentation
messages: 216257
nosy: EvensF, docs at python
priority: normal
severity: normal
status: open
title: Path used for HTTP PUT request doesn't match the description
type: enhancement
versions: Python 2.7, Python 3.2, Python 3.3, Python 3.4, Python 3.5

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

From report at bugs.python.org  Tue Apr 15 02:39:01 2014
From: report at bugs.python.org (=?utf-8?q?Evens_Fortun=C3=A9?=)
Date: Tue, 15 Apr 2014 00:39:01 +0000
Subject: [docs] [issue21228] Missing enumeration of HTTPResponse Objects
	methods of	urllib.request.urlopen's http.client.HTTPResponse?
In-Reply-To: <1397520483.48.0.224250148615.issue21228@psf.upfronthosting.co.za>
Message-ID: <1397522341.82.0.843004249316.issue21228@psf.upfronthosting.co.za>


Evens Fortun? added the comment:

I forgot to tell that it is in section "20.5. urllib.request ? Extensible library for opening URLs" for Python 3.2.5

----------

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

From report at bugs.python.org  Tue Apr 15 03:27:22 2014
From: report at bugs.python.org (Senthil Kumaran)
Date: Tue, 15 Apr 2014 01:27:22 +0000
Subject: [docs] [issue21228] Missing enumeration of HTTPResponse Objects
	methods of	urllib.request.urlopen's http.client.HTTPResponse?
In-Reply-To: <1397520483.48.0.224250148615.issue21228@psf.upfronthosting.co.za>
Message-ID: <1397525242.8.0.87755638739.issue21228@psf.upfronthosting.co.za>


Senthil Kumaran added the comment:

Hello Evens,
If you can, then please attach a doc to this and we and fix this soon.

----------
nosy: +orsenthil

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

From report at bugs.python.org  Tue Apr 15 03:27:49 2014
From: report at bugs.python.org (Senthil Kumaran)
Date: Tue, 15 Apr 2014 01:27:49 +0000
Subject: [docs] [issue21229] Path used for HTTP PUT request doesn't match
	the	description
In-Reply-To: <1397522183.41.0.398189687255.issue21229@psf.upfronthosting.co.za>
Message-ID: <1397525269.49.0.792744059138.issue21229@psf.upfronthosting.co.za>


Senthil Kumaran added the comment:

A simple docs patch would definitely help here. Thanks for the bug report.

----------
nosy: +orsenthil

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

From report at bugs.python.org  Tue Apr 15 03:49:00 2014
From: report at bugs.python.org (=?utf-8?q?Evens_Fortun=C3=A9?=)
Date: Tue, 15 Apr 2014 01:49:00 +0000
Subject: [docs] [issue21228] Missing enumeration of HTTPResponse Objects
	methods of	urllib.request.urlopen's http.client.HTTPResponse?
In-Reply-To: <1397520483.48.0.224250148615.issue21228@psf.upfronthosting.co.za>
Message-ID: <1397526540.2.0.623542805553.issue21228@psf.upfronthosting.co.za>


Evens Fortun? added the comment:

I don't quite understand what you are asking me. You need a copy of the document?? 

You can find an example at this link: https://docs.python.org/3/library/urllib.request.html#urllib.request.urlopen

----------

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

From report at bugs.python.org  Tue Apr 15 03:51:24 2014
From: report at bugs.python.org (=?utf-8?q?Evens_Fortun=C3=A9?=)
Date: Tue, 15 Apr 2014 01:51:24 +0000
Subject: [docs] [issue21229] Path used for HTTP PUT request doesn't match
	the	description
In-Reply-To: <1397522183.41.0.398189687255.issue21229@psf.upfronthosting.co.za>
Message-ID: <1397526684.48.0.549343302048.issue21229@psf.upfronthosting.co.za>


Evens Fortun? added the comment:

Do you have some documentation on how to do a "docs patch"??

I'm sorry this is the first time I'm reporting a bug.

----------

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

From report at bugs.python.org  Tue Apr 15 05:20:46 2014
From: report at bugs.python.org (Kushal Das)
Date: Tue, 15 Apr 2014 03:20:46 +0000
Subject: [docs] [issue21229] Path used for HTTP PUT request doesn't match
	the	description
In-Reply-To: <1397522183.41.0.398189687255.issue21229@psf.upfronthosting.co.za>
Message-ID: <1397532046.68.0.776139247272.issue21229@psf.upfronthosting.co.za>


Kushal Das added the comment:

You should have a look at the following guides:

https://docs.python.org/devguide/docquality.html
https://docs.python.org/devguide/patch.html

----------
nosy: +kushal.das

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

From report at bugs.python.org  Tue Apr 15 05:22:21 2014
From: report at bugs.python.org (Senthil Kumaran)
Date: Tue, 15 Apr 2014 03:22:21 +0000
Subject: [docs] [issue21229] Path used for HTTP PUT request doesn't match
	the	description
In-Reply-To: <1397522183.41.0.398189687255.issue21229@psf.upfronthosting.co.za>
Message-ID: <1397532141.67.0.0534104821889.issue21229@psf.upfronthosting.co.za>


Senthil Kumaran added the comment:

Sure, here is the information on how to create a patch - https://docs.python.org/devguide/

It could feel that there are multiple steps, but the process is easy.

----------

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

From report at bugs.python.org  Tue Apr 15 08:06:37 2014
From: report at bugs.python.org (Jayanth Koushik)
Date: Tue, 15 Apr 2014 06:06:37 +0000
Subject: [docs] [issue21232] Use of '1' instead of 'True' as 'splitlines'
	argument in	difflib documentation
Message-ID: <1397541997.99.0.769146092829.issue21232@psf.upfronthosting.co.za>


Changes by Jayanth Koushik <jnkoushik at gmail.com>:


----------
assignee: docs at python
components: Documentation
nosy: docs at python, jayanthkoushik
priority: normal
severity: normal
status: open
title: Use of '1' instead of 'True' as 'splitlines' argument in difflib documentation
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/issue21232>
_______________________________________

From report at bugs.python.org  Tue Apr 15 08:10:31 2014
From: report at bugs.python.org (Jayanth Koushik)
Date: Tue, 15 Apr 2014 06:10:31 +0000
Subject: [docs] [issue21232] Use of '1' instead of 'True' as 'splitlines'
	argument in	difflib documentation
Message-ID: <1397542231.28.0.662234584475.issue21232@psf.upfronthosting.co.za>


New submission from Jayanth Koushik:

In the difflib documentation, multiple uses of 'splitlines' use '1' as the 'keepends' argument. In Python 2.x, 1 is not guaranteed to be True and while this is guaranteed in 3.x, it would be much clearer to specify the argument as 'True'.

----------

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

From report at bugs.python.org  Tue Apr 15 09:43:34 2014
From: report at bugs.python.org (Wolfgang Maier)
Date: Tue, 15 Apr 2014 07:43:34 +0000
Subject: [docs] [issue21146] update gzip usage examples in docs
In-Reply-To: <1396521606.53.0.161098821761.issue21146@psf.upfronthosting.co.za>
Message-ID: <1397547814.4.0.674633278349.issue21146@psf.upfronthosting.co.za>


Wolfgang Maier added the comment:

well, buffering is not the issue here. It's that the file iterator used in the current example is line-based, so whatever the buffer size you're doing unnecessary inspection to find and split on line terminators.

----------

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

From report at bugs.python.org  Tue Apr 15 11:42:52 2014
From: report at bugs.python.org (Stefan Krah)
Date: Tue, 15 Apr 2014 09:42:52 +0000
Subject: [docs] [issue21227] Decimal class error messages for integer
	division aren't	good
In-Reply-To: <1397520159.39.0.440264883295.issue21227@psf.upfronthosting.co.za>
Message-ID: <1397554972.88.0.405705433943.issue21227@psf.upfronthosting.co.za>


Changes by Stefan Krah <stefan-usenet at bytereef.org>:


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

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

From report at bugs.python.org  Tue Apr 15 17:29:05 2014
From: report at bugs.python.org (A.M. Kuchling)
Date: Tue, 15 Apr 2014 15:29:05 +0000
Subject: [docs] [issue20103] Documentation of itertools.accumulate is
	confused
In-Reply-To: <1388592720.87.0.970906154406.issue20103@psf.upfronthosting.co.za>
Message-ID: <1397575745.92.0.285234345264.issue20103@psf.upfronthosting.co.za>


Changes by A.M. Kuchling <amk at amk.ca>:


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

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

From report at bugs.python.org  Tue Apr 15 17:52:21 2014
From: report at bugs.python.org (Christian Hudon)
Date: Tue, 15 Apr 2014 15:52:21 +0000
Subject: [docs] [issue20103] Documentation of itertools.accumulate is
	confused
In-Reply-To: <1388592720.87.0.970906154406.issue20103@psf.upfronthosting.co.za>
Message-ID: <1397577141.53.0.79783187451.issue20103@psf.upfronthosting.co.za>


Christian Hudon added the comment:

Second revision, incorporating comments. Also document the behavior when passed an empty input iterable.

----------
Added file: http://bugs.python.org/file34878/accumulate2.diff

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

From report at bugs.python.org  Tue Apr 15 17:57:26 2014
From: report at bugs.python.org (Eric Snow)
Date: Tue, 15 Apr 2014 15:57:26 +0000
Subject: [docs] [issue21240] Add an abstactmethod directive to the Python
	ReST domain
Message-ID: <1397577446.45.0.129673687933.issue21240@psf.upfronthosting.co.za>


New submission from Eric Snow:

I'd like to be able to mark abstract methods in the docs more explicitly and have their presentation in the docs be more obvious.  So I'd like to propose "abstractmethod" as a new directive to join the existing ones (classmethod, staticmethod, etc.).

(This is motivated by msg216314.)

----------
assignee: docs at python
components: Documentation
messages: 216323
nosy: docs at python, eric.snow
priority: normal
severity: normal
status: open
title: Add an abstactmethod directive to the Python ReST domain
type: enhancement
versions: Python 3.4, Python 3.5

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

From report at bugs.python.org  Tue Apr 15 18:02:42 2014
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 15 Apr 2014 16:02:42 +0000
Subject: [docs] [issue21240] Add an abstactmethod directive to the Python
	ReST domain
In-Reply-To: <1397577446.45.0.129673687933.issue21240@psf.upfronthosting.co.za>
Message-ID: <1397577762.92.0.310393948524.issue21240@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Tue Apr 15 18:39:54 2014
From: report at bugs.python.org (Berker Peksag)
Date: Tue, 15 Apr 2014 16:39:54 +0000
Subject: [docs] [issue16236] Doc/Makefile should have $PYTHON=python2
In-Reply-To: <1350252917.6.0.180225296667.issue16236@psf.upfronthosting.co.za>
Message-ID: <1397579994.79.0.654531939217.issue16236@psf.upfronthosting.co.za>


Berker Peksag added the comment:

You can now build the Python documentation with using Python 3. See msg216161 in issue 10224 for more information.

----------
nosy: +berker.peksag
resolution:  -> out of date
stage:  -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Tue Apr 15 19:58:44 2014
From: report at bugs.python.org (Caelyn McAulay)
Date: Tue, 15 Apr 2014 17:58:44 +0000
Subject: [docs] [issue18229] attribute headers of
	http.server.BaseHTTPRequestHandler	sometimes does not exists
In-Reply-To: <1371376761.5.0.41138715811.issue18229@psf.upfronthosting.co.za>
Message-ID: <1397584724.26.0.211351743201.issue18229@psf.upfronthosting.co.za>


Caelyn McAulay added the comment:

Added comment to documentation concerning when the headers attribute gets set. 

I confirmed that the headers attribute is only ever set in the parse_request method of BaseHTTPRequestHandler and only if the request is successfully parsed as HTTP.

----------
keywords: +patch
nosy: +math_foo
Added file: http://bugs.python.org/file34884/documentation18229.patch

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

From report at bugs.python.org  Tue Apr 15 22:12:02 2014
From: report at bugs.python.org (Michael Foord)
Date: Tue, 15 Apr 2014 20:12:02 +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: <1397592721.88.0.371837820514.issue18566@psf.upfronthosting.co.za>


Michael Foord added the comment:

Patch looks good to me.

----------

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

From report at bugs.python.org  Tue Apr 15 22:16:03 2014
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 15 Apr 2014 20:16:03 +0000
Subject: [docs] [issue15840] Ambiguity with regard to the effect of
	accessing a	closed IOBase instance
In-Reply-To: <1346524424.76.0.407141547435.issue15840@psf.upfronthosting.co.za>
Message-ID: <3g7dHk0t9qz7Ljd@mail.python.org>


Roundup Robot added the comment:

New changeset 0c7cf0e598e7 by Andrew Kuchling in branch '2.7':
#15840: make docs consistent by saying operations on closed files raise ValueError.
http://hg.python.org/cpython/rev/0c7cf0e598e7

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

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

From report at bugs.python.org  Tue Apr 15 22:19:59 2014
From: report at bugs.python.org (Cameron Lee)
Date: Tue, 15 Apr 2014 20:19:59 +0000
Subject: [docs] [issue21245] Logging Logger.exception documentation
Message-ID: <1397593199.67.0.956489214078.issue21245@psf.upfronthosting.co.za>


New submission from Cameron Lee:

The documentation doesn't indicate that the Logger.exception method can accept kwargs like the other logging methods (Logger.debug, Logger.info, etc...) such as exc_info, stack_info, and extra.

https://docs.python.org/2.7/library/logging.html#logging.Logger.exception

The method signature is documented as: 

Logger.exception(msg, *args)

It should be:

Logger.exception(msg, *args, **kwargs)

It appears that this functionality was added in between Python 2.7.3 and 2.7.4 (http://bugs.python.org/issue15541) but that the documentation was never changed for the newer versions.

----------
assignee: docs at python
components: Documentation
messages: 216379
nosy: Cameron.Lee, docs at python
priority: normal
severity: normal
status: open
title: Logging Logger.exception documentation
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/issue21245>
_______________________________________

From report at bugs.python.org  Tue Apr 15 22:20:36 2014
From: report at bugs.python.org (Yury Selivanov)
Date: Tue, 15 Apr 2014 20:20:36 +0000
Subject: [docs] [issue21245] Logging Logger.exception documentation
In-Reply-To: <1397593199.67.0.956489214078.issue21245@psf.upfronthosting.co.za>
Message-ID: <1397593236.48.0.330264726927.issue21245@psf.upfronthosting.co.za>


Changes by Yury Selivanov <yselivanov.ml at gmail.com>:


----------
nosy: +vinay.sajip, yselivanov

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

From report at bugs.python.org  Tue Apr 15 23:17:15 2014
From: report at bugs.python.org (Vinay Sajip)
Date: Tue, 15 Apr 2014 21:17:15 +0000
Subject: [docs] [issue21245] Logging Logger.exception documentation
In-Reply-To: <1397593199.67.0.956489214078.issue21245@psf.upfronthosting.co.za>
Message-ID: <1397596635.38.0.81457537323.issue21245@psf.upfronthosting.co.za>


Vinay Sajip added the comment:

Removed Python versions which are not receiving changes.

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

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

From report at bugs.python.org  Tue Apr 15 23:37:05 2014
From: report at bugs.python.org (David Turner)
Date: Tue, 15 Apr 2014 21:37:05 +0000
Subject: [docs] [issue21248] BROWSER env var described inaccurately in
	webbrowser docs
Message-ID: <1397597825.94.0.182594358629.issue21248@psf.upfronthosting.co.za>


New submission from David Turner:

https://docs.python.org/2/library/webbrowser.html says "If the environment variable BROWSER exists, it is interpreted to override the platform default list of browsers, as a os.pathsep-separated list of browsers to try in order."

This is not actually what happens; instead, it is prepended to the platform-default list of browsers.

----------
assignee: docs at python
components: Documentation
messages: 216393
nosy: docs at python, dturner-tw
priority: normal
severity: normal
status: open
title: BROWSER env var described inaccurately in webbrowser docs
versions: Python 2.7

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

From report at bugs.python.org  Tue Apr 15 23:40:38 2014
From: report at bugs.python.org (Senthil Kumaran)
Date: Tue, 15 Apr 2014 21:40:38 +0000
Subject: [docs] [issue21248] BROWSER env var described inaccurately in
	webbrowser docs
In-Reply-To: <1397597825.94.0.182594358629.issue21248@psf.upfronthosting.co.za>
Message-ID: <1397598038.71.0.626350938362.issue21248@psf.upfronthosting.co.za>


Senthil Kumaran added the comment:

Which may be sane thing thing do.

So the docs could be made better. Like - the list of browsers specified in env var BROWSER is tried first before looking at the platform defaults.

----------
nosy: +orsenthil

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

From report at bugs.python.org  Wed Apr 16 00:14:09 2014
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 15 Apr 2014 22:14:09 +0000
Subject: [docs] [issue21245] Logging Logger.exception documentation
In-Reply-To: <1397593199.67.0.956489214078.issue21245@psf.upfronthosting.co.za>
Message-ID: <3g7gw100Dyz7LjM@mail.python.org>


Roundup Robot added the comment:

New changeset dcb5ca1f1b44 by Vinay Sajip in branch '2.7':
Issue #21245: updated documentation on exception() method and function.
http://hg.python.org/cpython/rev/dcb5ca1f1b44

New changeset eee4fd2012ae by Vinay Sajip in branch '3.4':
Issue #21245: updated documentation on exception() method and function.
http://hg.python.org/cpython/rev/eee4fd2012ae

New changeset a0ec713964b1 by Vinay Sajip in branch 'default':
Closes #21245: merged update from 3.4.
http://hg.python.org/cpython/rev/a0ec713964b1

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

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

From report at bugs.python.org  Wed Apr 16 00:22:22 2014
From: report at bugs.python.org (Cameron Lee)
Date: Tue, 15 Apr 2014 22:22:22 +0000
Subject: [docs] [issue21245] Logging Logger.exception documentation
In-Reply-To: <1397593199.67.0.956489214078.issue21245@psf.upfronthosting.co.za>
Message-ID: <1397600542.25.0.210297113088.issue21245@psf.upfronthosting.co.za>


Cameron Lee added the comment:

Are you sure that Python 3.2 and Python 3.3 don't need updated documentation? I don't know for sure if these two version have the code change or not but the http://bugs.python.org/issue15541 seems to indicate that 3.2 at least does.

Thanks for the amazing response!

----------

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

From report at bugs.python.org  Wed Apr 16 00:36:31 2014
From: report at bugs.python.org (Vinay Sajip)
Date: Tue, 15 Apr 2014 22:36:31 +0000
Subject: [docs] [issue21245] Logging Logger.exception documentation
In-Reply-To: <1397593199.67.0.956489214078.issue21245@psf.upfronthosting.co.za>
Message-ID: <1397601391.9.0.147767135792.issue21245@psf.upfronthosting.co.za>


Vinay Sajip added the comment:

> Are you sure that Python 3.2 and Python 3.3 don't need updated documentation?

As I understand it, the policy is not to do documentation updates for Python versions that will never see new releases. If a 3.x release manager says otherwise, I can revisit it - obviously the changes are easy to make :-)

----------

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

From report at bugs.python.org  Wed Apr 16 02:00:36 2014
From: report at bugs.python.org (=?utf-8?q?Evens_Fortun=C3=A9?=)
Date: Wed, 16 Apr 2014 00:00:36 +0000
Subject: [docs] [issue21229] Path used for HTTP PUT request doesn't match
	the	description
In-Reply-To: <1397522183.41.0.398189687255.issue21229@psf.upfronthosting.co.za>
Message-ID: <1397606436.48.0.264874946888.issue21229@psf.upfronthosting.co.za>


Evens Fortun? added the comment:

Is it what you asked?

----------
keywords: +patch
Added file: http://bugs.python.org/file34901/issue21229.patch

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

From report at bugs.python.org  Wed Apr 16 02:30:14 2014
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 16 Apr 2014 00:30:14 +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: <3g7kwy5mlfz7LjV@mail.python.org>


Roundup Robot added the comment:

New changeset cbe0cf95fe37 by R David Murray in branch '3.4':
#20874: update tutorial wording: sophisticated line editing is now standard.
http://hg.python.org/cpython/rev/cbe0cf95fe37

New changeset b5f4ab357ff9 by R David Murray in branch '3.4':
#20874: reflow paragraph.
http://hg.python.org/cpython/rev/b5f4ab357ff9

New changeset d4e3bea03f9f by R David Murray in branch 'default':
Merge #20874 fix.
http://hg.python.org/cpython/rev/d4e3bea03f9f

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

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

From report at bugs.python.org  Wed Apr 16 02:31:51 2014
From: report at bugs.python.org (R. David Murray)
Date: Wed, 16 Apr 2014 00:31:51 +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: <1397608311.33.0.572245933991.issue20874@psf.upfronthosting.co.za>


R. David Murray added the comment:

Thanks, Rafael.

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

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

From report at bugs.python.org  Wed Apr 16 03:13:20 2014
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 16 Apr 2014 01:13:20 +0000
Subject: [docs] [issue15840] Ambiguity with regard to the effect of
	accessing a	closed IOBase instance
In-Reply-To: <1346524424.76.0.407141547435.issue15840@psf.upfronthosting.co.za>
Message-ID: <3g7ltl3sRpz7LjP@mail.python.org>


Roundup Robot added the comment:

New changeset 7a27039e4a42 by Andrew Kuchling in branch '3.4':
#15840: make docs consistent by saying operations on closed files raise ValueError.
http://hg.python.org/cpython/rev/7a27039e4a42

----------

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

From report at bugs.python.org  Wed Apr 16 03:30:54 2014
From: report at bugs.python.org (A.M. Kuchling)
Date: Wed, 16 Apr 2014 01:30:54 +0000
Subject: [docs] [issue15840] Ambiguity with regard to the effect of
	accessing a	closed IOBase instance
In-Reply-To: <1346524424.76.0.407141547435.issue15840@psf.upfronthosting.co.za>
Message-ID: <1397611854.15.0.269634592811.issue15840@psf.upfronthosting.co.za>


A.M. Kuchling added the comment:

Committed to 2.7, 3.4, and default.  Thanks for your patch!

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

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

From report at bugs.python.org  Wed Apr 16 04:29:15 2014
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 16 Apr 2014 02:29:15 +0000
Subject: [docs] [issue20103] Documentation of itertools.accumulate is
	confused
In-Reply-To: <1388592720.87.0.970906154406.issue20103@psf.upfronthosting.co.za>
Message-ID: <3g7nZL3zvyz7LkJ@mail.python.org>


Roundup Robot added the comment:

New changeset 9e1d2150fff2 by Andrew Kuchling in branch 'default':
#20103: Rewrite description of itertools.accumulate().
http://hg.python.org/cpython/rev/9e1d2150fff2

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

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

From report at bugs.python.org  Wed Apr 16 04:30:21 2014
From: report at bugs.python.org (A.M. Kuchling)
Date: Wed, 16 Apr 2014 02:30:21 +0000
Subject: [docs] [issue20103] Documentation of itertools.accumulate is
	confused
In-Reply-To: <1388592720.87.0.970906154406.issue20103@psf.upfronthosting.co.za>
Message-ID: <1397615421.77.0.65718874246.issue20103@psf.upfronthosting.co.za>


A.M. Kuchling added the comment:

Thanks for your patch!

----------
assignee: rhettinger -> akuchling
nosy: +akuchling
resolution:  -> fixed
stage: patch review -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Wed Apr 16 05:28:58 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Wed, 16 Apr 2014 03:28:58 +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: <1397618938.86.0.388611961863.issue18566@psf.upfronthosting.co.za>


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


----------
assignee: docs at python -> terry.reedy

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

From report at bugs.python.org  Wed Apr 16 05:45:22 2014
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 16 Apr 2014 03:45:22 +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: <3g7qG970Ztz7LjM@mail.python.org>


Roundup Robot added the comment:

New changeset fdadc152b964 by Terry Jan Reedy in branch '2.7':
Issue #18566: Clarify unittest setUp, tearDown doc. Patch by Nitika Agarwal.
http://hg.python.org/cpython/rev/fdadc152b964

New changeset 9ab66a7f654a by Terry Jan Reedy in branch '3.4':
Issue #18566: Clarify unittest setUp, tearDown doc. Patch by Nitika Agarwal.
http://hg.python.org/cpython/rev/9ab66a7f654a

New changeset 72b1715e18c1 by Terry Jan Reedy in branch '2.7':
#18566: Whitespace
http://hg.python.org/cpython/rev/72b1715e18c1

New changeset a37440dec1b6 by Terry Jan Reedy in branch '3.4':
#18566: Whitespace
http://hg.python.org/cpython/rev/a37440dec1b6

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

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

From report at bugs.python.org  Wed Apr 16 05:47:01 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Wed, 16 Apr 2014 03:47:01 +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: <1397620021.22.0.91383268902.issue18566@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

Nitika, congrats on first patch. One minor problem: spaces at end of lines. It it my fault for not checking, but try to avoid them anyway.

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

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

From report at bugs.python.org  Wed Apr 16 07:08:56 2014
From: report at bugs.python.org (=?utf-8?q?Evens_Fortun=C3=A9?=)
Date: Wed, 16 Apr 2014 05:08:56 +0000
Subject: [docs] [issue21228] Missing enumeration of HTTPResponse Objects
	methods of	urllib.request.urlopen's http.client.HTTPResponse?
In-Reply-To: <1397520483.48.0.224250148615.issue21228@psf.upfronthosting.co.za>
Message-ID: <1397624936.5.0.8510531097.issue21228@psf.upfronthosting.co.za>


Changes by Evens Fortun? <evens.fortune at gmail.com>:


Added file: http://bugs.python.org/file34905/urllib.request.rst

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

From report at bugs.python.org  Wed Apr 16 17:20:40 2014
From: report at bugs.python.org (Martin Dengler)
Date: Wed, 16 Apr 2014 15:20:40 +0000
Subject: [docs] [issue15414] os.path.join behavior on Windows (ntpath.join)
	is	unexpected and not well documented
In-Reply-To: <1342903268.21.0.193498975528.issue15414@psf.upfronthosting.co.za>
Message-ID: <1397661640.06.0.368379732979.issue15414@psf.upfronthosting.co.za>


Changes by Martin Dengler <martin at martindengler.com>:


----------
nosy: +mdengler

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

From report at bugs.python.org  Wed Apr 16 18:38:51 2014
From: report at bugs.python.org (Stefan Krah)
Date: Wed, 16 Apr 2014 16:38:51 +0000
Subject: [docs] [issue21227] Decimal class error messages for integer
	division aren't	good
In-Reply-To: <1397520159.39.0.440264883295.issue21227@psf.upfronthosting.co.za>
Message-ID: <1397666331.08.0.987567264205.issue21227@psf.upfronthosting.co.za>


Stefan Krah added the comment:

It is hard to get fine grained error messages in _decimal, since
the errors come from libmpdec.  A clean solution would require
changes to libmpdec, and I'm reluctant to do that right now.

It is certainly possible to document DivisionImpossible etc.

----------

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

From report at bugs.python.org  Wed Apr 16 18:48:14 2014
From: report at bugs.python.org (Stefan Krah)
Date: Wed, 16 Apr 2014 16:48:14 +0000
Subject: [docs] [issue21227] Decimal class error messages for integer
	division aren't	good
In-Reply-To: <1397520159.39.0.440264883295.issue21227@psf.upfronthosting.co.za>
Message-ID: <1397666894.57.0.3999180999.issue21227@psf.upfronthosting.co.za>


Stefan Krah added the comment:

Meanwhile, the pure Python decimal versions prior to Python 3.2
have better error messages.

Right now in Python 3.3+ it is hard to import the Python version
without going into contortions, but that may be fixed in #19232.

----------
dependencies: +Speed up _decimal import

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

From report at bugs.python.org  Wed Apr 16 19:35:52 2014
From: report at bugs.python.org (leewz)
Date: Wed, 16 Apr 2014 17:35:52 +0000
Subject: [docs] [issue21227] Decimal class error messages for integer
	division aren't	good
In-Reply-To: <1397520159.39.0.440264883295.issue21227@psf.upfronthosting.co.za>
Message-ID: <1397669752.09.0.1867148711.issue21227@psf.upfronthosting.co.za>


leewz added the comment:

Fine grained? Do you mean that the error can't be distinguished from other such errors? Or that it's difficult to attach the message to DivisionError? I thought DivisionError was always about precision.

I looked up the error in libmpdec:
"This occurs and signals invalid-operation if the integer result of a divide-integer or remainder operation had too many digits (would be longer than precision). The result is [0,qNaN]." (http://speleotrove.com/decimal/daexcep.html)

Now I'm more confused. Though it mentions precision, it is talking about the *result's* precision being too large (something which shouldn't happen with Python's unbounded ints, right?), rather than being unable to give a sane answer due to not having *enough* digits. That's also what the 2.7 error is:
    decimal.InvalidOperation: quotient too large in //, % or divmod

I'm very much content with documenting it, but if possible, I'd like to understand whether this is an issue to take up with libmpdec.

P.S.: As a side-note to others, Python floats allows float%int even when precision isn't high enough, and seems to always returns 0.0 with no warning. So behavior is inconsistent, if that's important to anyone here.

----------

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

From report at bugs.python.org  Wed Apr 16 19:55:08 2014
From: report at bugs.python.org (Stefan Krah)
Date: Wed, 16 Apr 2014 17:55:08 +0000
Subject: [docs] [issue21227] Decimal class error messages for integer
	division aren't	good
In-Reply-To: <1397669752.09.0.1867148711.issue21227@psf.upfronthosting.co.za>
Message-ID: <20140416175507.GA21044@sleipnir.bytereef.org>


Stefan Krah added the comment:

My apologies if that wasn't clear: "fine grained" refers to the exception
messages.  A function can raise InvalidOperation for different reasons.

decimal.py gives a specific error message in each case. libmpdec just
signals the standard conforming InvalidOperation.

The relevant passage from the standard is here:

http://speleotrove.com/decimal/daops.html#refremain

  "This operation will fail under the same conditions as integer division."

decimal.py, decNumber and libmpdec all do the same thing, so there is no
libmpdec issue other than that the error *messages* could be improved.

I fully understand if you find the behavior surprising (after all the remainder
fits in the precision), but as long as we follow the standard we can't change
that.

----------

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

From report at bugs.python.org  Wed Apr 16 19:56:55 2014
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 16 Apr 2014 17:56:55 +0000
Subject: [docs] [issue18229] attribute headers of
	http.server.BaseHTTPRequestHandler	sometimes does not exists
In-Reply-To: <1371376761.5.0.41138715811.issue18229@psf.upfronthosting.co.za>
Message-ID: <3g8B8k4dDYz7LkZ@mail.python.org>


Roundup Robot added the comment:

New changeset 104fab0143e9 by Senthil Kumaran in branch '3.4':
Address issue 18229 - Explain http.server.BaseHTTPRequestHandler's .headers attribute further.
http://hg.python.org/cpython/rev/104fab0143e9

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

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

From report at bugs.python.org  Wed Apr 16 19:58:02 2014
From: report at bugs.python.org (Senthil Kumaran)
Date: Wed, 16 Apr 2014 17:58:02 +0000
Subject: [docs] [issue18229] attribute headers of
	http.server.BaseHTTPRequestHandler	sometimes does not exists
In-Reply-To: <1371376761.5.0.41138715811.issue18229@psf.upfronthosting.co.za>
Message-ID: <1397671082.02.0.419994570624.issue18229@psf.upfronthosting.co.za>


Changes by Senthil Kumaran <senthil at uthcode.com>:


----------
resolution:  -> fixed
stage:  -> committed/rejected
status: open -> closed
versions: +Python 3.5 -Python 2.7, Python 3.3

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

From report at bugs.python.org  Wed Apr 16 20:04:46 2014
From: report at bugs.python.org (leewz)
Date: Wed, 16 Apr 2014 18:04:46 +0000
Subject: [docs] [issue21227] Decimal class error messages for integer
	division aren't	good
In-Reply-To: <1397520159.39.0.440264883295.issue21227@psf.upfronthosting.co.za>
Message-ID: <1397671486.29.0.194582292222.issue21227@psf.upfronthosting.co.za>


leewz added the comment:

Nah. I found it surprising at first, but like I said, it's like the computer is given the first 28 digits of a number and then asked to figure out the 30th digit.

What I'm confused about is how it fits the definition of "division impossible" given by libmpdec's docs (about the result size), and whether you're saying it's difficult to translate the `[<class 'decimal.DivisionImpossible'>]` part to an error message.

----------

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

From r1m1l1d1 at hotmail.com  Wed Apr 16 20:55:28 2014
From: r1m1l1d1 at hotmail.com (renato dias)
Date: Wed, 16 Apr 2014 19:55:28 +0100
Subject: [docs] Bug in tutorial
Message-ID: <DUB121-W12701D2088BA7CF39AE0EAD8530@phx.gbl>

Hello, 
First of all I want ask forgiveness because my english is a little bad
I am new at python and whyen I was searching for some tutorials, I found one on my language (portuguese). In this tutorial I found a bug in topic 3.1.2, referred to strings. the problem is that when I put this command in python interpreter (palavra[4]) it doesn't work. I think that 
   quotation marks ("") are missing in the word.
Attached I send the URL and some images for you better locate the error.

URL:   http://turing.com.br/pydoc/2.7/tutorial/introduction.html

 		 	   		  
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140416/b682719d/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: python1.png
Type: image/png
Size: 125674 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20140416/b682719d/attachment-0002.png>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: python.png
Type: image/png
Size: 33596 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20140416/b682719d/attachment-0003.png>

From report at bugs.python.org  Wed Apr 16 21:01:26 2014
From: report at bugs.python.org (Berker Peksag)
Date: Wed, 16 Apr 2014 19:01:26 +0000
Subject: [docs] [issue21240] Add an abstactmethod directive to the Python
	ReST domain
In-Reply-To: <1397577446.45.0.129673687933.issue21240@psf.upfronthosting.co.za>
Message-ID: <1397674886.61.0.921722274333.issue21240@psf.upfronthosting.co.za>


Berker Peksag added the comment:

Here's patch. The new PyAbstractMethod class is basically a subclass of the sphinx.domains.python.PyClassmember class which implements the method, classmethod and staticmethod directives.

----------
keywords: +patch
nosy: +berker.peksag
stage:  -> patch review
Added file: http://bugs.python.org/file34920/issue21240.diff

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

From zachary.ware+pydocs at gmail.com  Wed Apr 16 21:11:16 2014
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Wed, 16 Apr 2014 14:11:16 -0500
Subject: [docs] Bug in tutorial
In-Reply-To: <DUB121-W12701D2088BA7CF39AE0EAD8530@phx.gbl>
References: <DUB121-W12701D2088BA7CF39AE0EAD8530@phx.gbl>
Message-ID: <CAKJDb-Nv5+OAAzN00HvObQBe60CMiAdEgnJLWgFo6m8SPKeWsw@mail.gmail.com>

On Wed, Apr 16, 2014 at 1:55 PM, renato dias <r1m1l1d1 at hotmail.com> wrote:
> Hello,
> First of all I want ask forgiveness because my english is a little bad
> I am new at python and whyen I was searching for some tutorials, I found one
> on my language (portuguese). In this tutorial I found a bug in topic 3.1.2,
> referred to strings. the problem is that when I put this command in python
> interpreter (palavra[4]) it doesn't work. I think that
> quotation marks ("") are missing in the word.
> Attached I send the URL and some images for you better locate the error.
>
> URL:   http://turing.com.br/pydoc/2.7/tutorial/introduction.html

Hi Renato,

There is no bug here, what you're seeing is because the example you
are trying is a follow-on from an above example.  In the example
following "Strings podem ser concatenadas (coladas) com o operador +,
e repetidas com *:", the name "palavra" is bound to 'AjudaZ'.  The
example you tried then assumes "palavra" is still bound to that
string.  If you go through all of the examples on the page in order
using the same interpreter session, they should all work.

Hope this helps,
-- 
Zach

From report at bugs.python.org  Wed Apr 16 21:40:03 2014
From: report at bugs.python.org (Nitika Agarwal)
Date: Wed, 16 Apr 2014 19:40:03 +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: <1397677203.01.0.597798451277.issue18566@psf.upfronthosting.co.za>


Nitika Agarwal added the comment:

@Terry J.Reedy
Thanks a lot.And yes, I will take care of it next time.

----------

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

From report at bugs.python.org  Wed Apr 16 21:46:18 2014
From: report at bugs.python.org (Stefan Krah)
Date: Wed, 16 Apr 2014 19:46:18 +0000
Subject: [docs] [issue21227] Decimal class error messages for integer
	division aren't	good
In-Reply-To: <1397671486.29.0.194582292222.issue21227@psf.upfronthosting.co.za>
Message-ID: <20140416194617.GA17983@sleipnir.bytereef.org>


Stefan Krah added the comment:

In the case of DivisionImpossible it would actually be possible to use
the error message 'quotient too large in //, % or divmod'.

But that's just one condition.  In the case of InvalidOperation there
are something like 30 different error messages.

----------

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

From report at bugs.python.org  Wed Apr 16 21:47:16 2014
From: report at bugs.python.org (Nitika Agarwal)
Date: Wed, 16 Apr 2014 19:47:16 +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: <1397677636.03.0.535771612789.issue4744@psf.upfronthosting.co.za>


Nitika Agarwal added the comment:

@St?phane Wirtel (matrixise)
I am really sorry but i just couldn't find where have i done a typo and have written 'asychat' insstead of asynchat.Will you please help me out in pointing out my error.

----------

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

From report at bugs.python.org  Wed Apr 16 22:03:31 2014
From: report at bugs.python.org (Raymond Hettinger)
Date: Wed, 16 Apr 2014 20:03:31 +0000
Subject: [docs] [issue21227] Decimal class error messages for integer
	division aren't	good
In-Reply-To: <1397520159.39.0.440264883295.issue21227@psf.upfronthosting.co.za>
Message-ID: <1397678610.97.0.368024294246.issue21227@psf.upfronthosting.co.za>


Raymond Hettinger added the comment:

> It is certainly possible to document DivisionImpossible etc.

This should not be done.  We've made strong efforts to not extend the Decimal Arithmetic Specification.

Also, the API already suffers from high complexity.  Adding more exceptions to the mix just makes the module harder to learn.

Instead, you are welcome to add more specific text messages to the existing (and standards compliant) exceptions:

   raise InvalidOperation("Not enough precision to compute the answer.")

> I found it surprising at first, but like I said, it's like 
> the computer is given the first 28 digits of a number and 
> then asked to figure out the 30th digit.

People are always surprised when their mental model conflicts with the actual design model.  That doesn't mean the implementation should change.

There may be a documentation issue, but then again, people who are "surprised" usually haven't studied the docs in detail.

My overall sense for this bug report is that there isn't a real problem that needs to be solved.  AFAICT, this particular "confusion" has never arisen before (i.e. bug reports, questions in python classes, posts on stackoverlow, blog posts, etc).  Likewise, the issue does not seem to have ever arisen in the many other non-Python implementations of the decimal spec.

I recommend that this either be closed or be limited to tweaking some of the error messages for existing exceptions.

----------
nosy: +facundobatista, rhettinger, tim.peters
priority: normal -> low
versions: +Python 3.5 -Python 3.3, Python 3.4

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

From report at bugs.python.org  Wed Apr 16 22:26:52 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 16 Apr 2014 20:26:52 +0000
Subject: [docs] [issue21268] Update pydoc module docstring
Message-ID: <1397680012.16.0.887791975702.issue21268@psf.upfronthosting.co.za>


New submission from ?ric Araujo:

?In the Python interpreter, do "from pydoc import help" to provide online help.?

?online? has changed meaning in the last decades, and help is a semi-builtin automatically added by the site module on startup.

----------
assignee: docs at python
components: Documentation
keywords: easy
messages: 216581
nosy: docs at python, eric.araujo
priority: normal
severity: normal
stage: needs patch
status: open
title: Update pydoc module docstring
versions: Python 2.7, Python 3.4, Python 3.5

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

From report at bugs.python.org  Wed Apr 16 22:28:42 2014
From: report at bugs.python.org (Stefan Krah)
Date: Wed, 16 Apr 2014 20:28:42 +0000
Subject: [docs] [issue21227] Decimal class error messages for integer
	division aren't	good
In-Reply-To: <1397678610.97.0.368024294246.issue21227@psf.upfronthosting.co.za>
Message-ID: <20140416202841.GA18310@sleipnir.bytereef.org>


Stefan Krah added the comment:

Raymond Hettinger <report at bugs.python.org> wrote:
> > It is certainly possible to document DivisionImpossible etc.
> 
> This should not be done.  We've made strong efforts to not extend the Decimal Arithmetic Specification.

The exceptions are already there:

Python 2.7.3 (default, Mar 13 2014, 11:03:55)
[GCC 4.7.2] on linux2
Type "help", "copyright", "credits" or "license" for more information.
>>> import decimal
>>> print(decimal.DivisionImpossible.__doc__)
Cannot perform the division adequately.

    This occurs and signals invalid-operation if the integer result of a
    divide-integer or remainder operation had too many digits (would be
    longer than precision).  The result is [0,qNaN].

The specification distinguishes between "conditions" and "signals". It is
true that the conditions are not technically raised, but they are very
much "subclasses" of InvalidOperation.

Cowlishaw himself makes the distinction between InvalidOperation
and IEEEInvalidOperation. The latter groups all conditions together:

#define DEC_IEEE_754_Invalid_operation (DEC_Conversion_syntax |     \
                                        DEC_Division_impossible |   \
                                        DEC_Division_undefined |    \
                                        DEC_Insufficient_storage |  \
                                        DEC_Invalid_context |       \
                                        DEC_Invalid_operation)

So while I don't particularly care whether we document the conditions or
not, I don't think doing so would extend the specification.

----------

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

From report at bugs.python.org  Wed Apr 16 22:48:18 2014
From: report at bugs.python.org (Mark Dickinson)
Date: Wed, 16 Apr 2014 20:48:18 +0000
Subject: [docs] [issue21227] Decimal class error messages for integer
	division aren't	good
In-Reply-To: <1397520159.39.0.440264883295.issue21227@psf.upfronthosting.co.za>
Message-ID: <1397681298.26.0.282647572983.issue21227@psf.upfronthosting.co.za>


Changes by Mark Dickinson <dickinsm at gmail.com>:


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

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

From report at bugs.python.org  Wed Apr 16 22:48:41 2014
From: report at bugs.python.org (=?utf-8?q?St=C3=A9phane_Wirtel?=)
Date: Wed, 16 Apr 2014 20:48:41 +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: <1397681321.73.0.328620266325.issue4744@psf.upfronthosting.co.za>


St?phane Wirtel added the comment:

In your issue4744_2.patch, the anchor contains 'asychat' and not 'asynchat'.

----------

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

From report at bugs.python.org  Wed Apr 16 22:52:28 2014
From: report at bugs.python.org (leewz)
Date: Wed, 16 Apr 2014 20:52:28 +0000
Subject: [docs] [issue21227] Decimal class error messages for integer
	division aren't	good
In-Reply-To: <1397520159.39.0.440264883295.issue21227@psf.upfronthosting.co.za>
Message-ID: <1397681548.14.0.431648250759.issue21227@psf.upfronthosting.co.za>


leewz added the comment:

Total list of issues now:
- Error message for `DivisionImpossible` is
      [<class 'decimal.DivisionImpossible'>]
  instead of an actual error message.
- `decimal.DivisionImpossible.__doc__` is empty.
- Calling `help(decimal.DivisionImpossible)` turns up nothing useful.

I checked all of these just now on my 3.2.3 (Windows). These issues are a CHANGE from 3.2 to 3.3. For example:
- Old error:
  decimal.InvalidOperation: quotient too large in //, % or divmod
- New error:
  InvalidOperation: [<class 'decimal.DivisionImpossible'>]

I assume that the issues also apply to the other InvalidOperation types. So I guess what I'm really asking for is to pull forward the 3.2 docs and messages.

> That doesn't mean the implementation should change.

Er, I was explaining why it wasn't really surprising once I thought about it.

> There may be a documentation issue, but then again, people who are "surprised" usually haven't studied the docs in detail.

To clarify:
- I looked at the Decimal docs
    - skimmed for references to modulo and division
    - looked for `DivisionImpossible`
- Then looked on Google for '"DivisionImpossible" Python'.
- Experimented with changing precision and fooling around with bigger and smaller numbers, and realized why the operation was logically impossible.
- Came here, posted, got a response that it was a flag raised by libmpdec.

I'm not asking for a change in behavior. I did point out that it was inconsistent with regular floats, in case consistency with Pyfloats was a thing that mattered. But I don't care about that. I only worry about anyone else who would use Decimal coming across the same unhelpful error.

> AFAICT, this particular "confusion" has never arisen before (i.e. bug reports, questions in python classes, posts on stackoverlow, blog posts, etc).  Likewise, the issue does not seem to have ever arisen in the many other non-Python implementations of the decimal spec.

I agree it'd be (very) rare, but part of the reason why it might not appear online is that the issues at the top of this email are relatively new (3.3).

----------

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

From report at bugs.python.org  Wed Apr 16 23:06:58 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 16 Apr 2014 21:06:58 +0000
Subject: [docs] [issue21190] Broken download link on README for CPython docs
In-Reply-To: <1397054916.95.0.591389338462.issue21190@psf.upfronthosting.co.za>
Message-ID: <1397682418.14.0.723525169584.issue21190@psf.upfronthosting.co.za>


?ric Araujo added the comment:

For the record, there is a convention (and server config) to have ?current version? links: http://legacy.python.org/dev/peps/pep-0430/

Senthil: What do you think about using /3/ instead of /3.4/ in the link so that it does not become another thing that needs to change with each release?

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

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

From report at bugs.python.org  Wed Apr 16 23:22:34 2014
From: report at bugs.python.org (akira)
Date: Wed, 16 Apr 2014 21:22:34 +0000
Subject: [docs] [issue18243] mktime_tz documentation out-of-date
In-Reply-To: <1371482642.16.0.49381484414.issue18243@psf.upfronthosting.co.za>
Message-ID: <1397683354.88.0.386141664187.issue18243@psf.upfronthosting.co.za>


akira added the comment:

I've added the documentation patch with the outdated remark removed from mktime_tz docs.

----------
keywords: +patch
nosy: +akira
type:  -> behavior
versions: +Python 3.2, Python 3.5
Added file: http://bugs.python.org/file34929/mktime_tz-doc.patch

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

From report at bugs.python.org  Wed Apr 16 23:24:25 2014
From: report at bugs.python.org (Senthil Kumaran)
Date: Wed, 16 Apr 2014 21:24:25 +0000
Subject: [docs] [issue21190] Broken download link on README for CPython docs
In-Reply-To: <1397054916.95.0.591389338462.issue21190@psf.upfronthosting.co.za>
Message-ID: <1397683465.42.0.263366351253.issue21190@psf.upfronthosting.co.za>


Senthil Kumaran added the comment:

?ric, no preference. I thought this was explicit and if you would like to change it back to /3/, fine, no problem with me. Just think of any redirection issue, if we may accidentally stumble upon, that's it.

----------

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

From report at bugs.python.org  Thu Apr 17 00:45:52 2014
From: report at bugs.python.org (Stefan Krah)
Date: Wed, 16 Apr 2014 22:45:52 +0000
Subject: [docs] [issue21227] Decimal class error messages for integer
	division aren't	good
In-Reply-To: <1397681548.14.0.431648250759.issue21227@psf.upfronthosting.co.za>
Message-ID: <20140416224551.GA20042@sleipnir.bytereef.org>


Stefan Krah added the comment:

leewz <report at bugs.python.org> wrote:
> - Error message for `DivisionImpossible` is
>       [<class 'decimal.DivisionImpossible'>]
>   instead of an actual error message.

No, the error message for the *signal*  that is raised (InvalidOperation) lists
the *condition* that triggered the signal (DivisionImpossible).

I followed the recommendation at:

http://speleotrove.com/decimal/daexcep.html#refexcep

"It is recommended that implementations distinguish the different conditions
 listed above, and also provide additional information about exceptional
 conditions where possible (for example, the operation being attempted and
 the values of the operand or operands involved)."

Distinguishing the conditions is easy, adding additional information in
all cases would require changes to libmpdec.

----------

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

From report at bugs.python.org  Thu Apr 17 00:49:00 2014
From: report at bugs.python.org (Christian Theune)
Date: Wed, 16 Apr 2014 22:49:00 +0000
Subject: [docs] [issue21202] Naming a file` io.py` causes cryptic error
	message
In-Reply-To: <1397239551.94.0.578791540537.issue21202@psf.upfronthosting.co.za>
Message-ID: <1397688540.81.0.595156503894.issue21202@psf.upfronthosting.co.za>


Changes by Christian Theune <ct at gocept.com>:


----------
hgrepos: +238

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

From report at bugs.python.org  Thu Apr 17 01:04:04 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 16 Apr 2014 23:04:04 +0000
Subject: [docs] [issue21240] Add an abstactmethod directive to the Python
	ReST domain
In-Reply-To: <1397577446.45.0.129673687933.issue21240@psf.upfronthosting.co.za>
Message-ID: <1397689444.47.0.733919643701.issue21240@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/issue21240>
_______________________________________

From report at bugs.python.org  Thu Apr 17 01:15:06 2014
From: report at bugs.python.org (Christian Theune)
Date: Wed, 16 Apr 2014 23:15:06 +0000
Subject: [docs] [issue21202] Naming a file` io.py` causes cryptic error
	message
In-Reply-To: <1397239551.94.0.578791540537.issue21202@psf.upfronthosting.co.za>
Message-ID: <1397690106.85.0.0107009173641.issue21202@psf.upfronthosting.co.za>


Christian Theune added the comment:

I managed to create a patch that relies (in hopefully reasonably safe manner) on embedding an object repr for identification in this and similar cases. This is basically what implements what Martin suggested.

Caveat emptor: my C knowledge is only good enough to be dangerous. Thomas Wouters and RDM helped me through it.

I haven't adapted the tests yet (lots of failures due to the output change) but I managed them to stop crashing.

The 'repr.py' in the root is my current testbed to see what's going on.

----------
nosy: +ctheune, r.david.murray, twouters

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

From report at bugs.python.org  Thu Apr 17 01:15:23 2014
From: report at bugs.python.org (Christian Theune)
Date: Wed, 16 Apr 2014 23:15:23 +0000
Subject: [docs] [issue21202] Naming a file` io.py` causes cryptic error
	message
In-Reply-To: <1397239551.94.0.578791540537.issue21202@psf.upfronthosting.co.za>
Message-ID: <1397690123.63.0.619501213914.issue21202@psf.upfronthosting.co.za>


Changes by Christian Theune <ct at gocept.com>:


----------
keywords: +patch
Added file: http://bugs.python.org/file34937/4ae151db1bd9.diff

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

From report at bugs.python.org  Thu Apr 17 01:17:35 2014
From: report at bugs.python.org (Stefan Krah)
Date: Wed, 16 Apr 2014 23:17:35 +0000
Subject: [docs] [issue21227] Decimal class error messages for integer
	division aren't	good
In-Reply-To: <20140416224551.GA20042@sleipnir.bytereef.org>
Message-ID: <20140416231734.GA20364@sleipnir.bytereef.org>


Stefan Krah added the comment:

The idea behind the list as the exception message is this:  If multiple
conditions would have raised the signal they are all listed, while the
"highest ranking" signal is the one that is ultimately raised.

>>> from decimal import *
>>> c = getcontext()
>>> for v in c.traps:
...     c.traps[v] = True
... 
>>> 
>>> Decimal(8) ** 1000000000000000
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
decimal.Overflow: [<class 'decimal.Overflow'>, <class 'decimal.Inexact'>, <class 'decimal.Rounded'>]

Exception precedence is listed here at the bottom of the page:

http://speleotrove.com/decimal/daexcep.html

----------

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

From report at bugs.python.org  Thu Apr 17 01:43:35 2014
From: report at bugs.python.org (Caelyn McAulay)
Date: Wed, 16 Apr 2014 23:43:35 +0000
Subject: [docs] [issue12148] Clarify "or-ing together" doctest option flags
In-Reply-To: <1306058966.52.0.456848115548.issue12148@psf.upfronthosting.co.za>
Message-ID: <1397691815.87.0.476941970596.issue12148@psf.upfronthosting.co.za>


Caelyn McAulay added the comment:

I grepped for 's together' and found two instances of "or's together" in the docs which I reworded to use bitwise-or instead, in the attached patch.

----------
keywords: +patch
nosy: +math_foo
Added file: http://bugs.python.org/file34938/issue12148.patch

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

From report at bugs.python.org  Thu Apr 17 02:25:08 2014
From: report at bugs.python.org (Caelyn McAulay)
Date: Thu, 17 Apr 2014 00:25:08 +0000
Subject: [docs] [issue5904] strftime docs do not explain locale effect on
	result	string
In-Reply-To: <1241270739.12.0.286821632978.issue5904@psf.upfronthosting.co.za>
Message-ID: <1397694308.48.0.888001844137.issue5904@psf.upfronthosting.co.za>


Caelyn McAulay added the comment:

Added to Docs that strftime will return a locale dependent byte string.

----------
keywords: +patch
nosy: +math_foo
Added file: http://bugs.python.org/file34940/issue5904.patch

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

From report at bugs.python.org  Thu Apr 17 02:34:43 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Thu, 17 Apr 2014 00:34:43 +0000
Subject: [docs] [issue12148] Clarify "or-ing together" doctest option flags
In-Reply-To: <1306058966.52.0.456848115548.issue12148@psf.upfronthosting.co.za>
Message-ID: <1397694883.86.0.583480603797.issue12148@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Apr 17 03:01:22 2014
From: report at bugs.python.org (bob gailer)
Date: Thu, 17 Apr 2014 01:01:22 +0000
Subject: [docs] [issue21279] str.translate documentation incomplete
Message-ID: <1397696482.87.0.486412592823.issue21279@psf.upfronthosting.co.za>


New submission from bob gailer:

Documentation for str.translate only mentions a dictionary for the translation table. Actually any iterable can be used, as long as its elements are integer, None or str.

Recommend wording:

str.translate(translation_table)

Return a copy of the s where all characters have been "mapped" through the translation_table - which must be either a dictionary mapping Unicode ordinals (integers) to Unicode ordinals, strings or None,
or an iterable. In this case the ord() of each character in s is used as an index into the iterable; the corresponding element of the iterable replaces the character. If ord() of the character exceeds the index range of the iterator, no substitution is made.

Example: to shift any of the first 255 ASCII characters to the next:

>>> 'Now is the time for all good men'.translate(range(1, 256))
'Opx!jt!uif!ujnf!gps!bmm!hppe!nfo'

COMMENT: I placed mapped in quotes as technically this only applies to dictionaries. Not sure what the best word is.

----------
assignee: docs at python
components: Documentation
messages: 216630
nosy: bgailer, docs at python
priority: normal
severity: normal
status: open
title: str.translate documentation incomplete
type: enhancement
versions: Python 3.3

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

From report at bugs.python.org  Thu Apr 17 03:06:05 2014
From: report at bugs.python.org (Raymond Hettinger)
Date: Thu, 17 Apr 2014 01:06:05 +0000
Subject: [docs] [issue21279] str.translate documentation incomplete
In-Reply-To: <1397696482.87.0.486412592823.issue21279@psf.upfronthosting.co.za>
Message-ID: <1397696765.5.0.248158309691.issue21279@psf.upfronthosting.co.za>


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


----------
keywords: +easy
stage:  -> patch review
versions: +Python 3.4, Python 3.5 -Python 3.3

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

From report at bugs.python.org  Thu Apr 17 03:58:21 2014
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 17 Apr 2014 01:58:21 +0000
Subject: [docs] [issue18628] Better index entry for encoding declarations
In-Reply-To: <1375418984.87.0.318628832877.issue18628@psf.upfronthosting.co.za>
Message-ID: <3g8NrD6Vvgz7LjS@mail.python.org>


Roundup Robot added the comment:

New changeset 0413e0b1f76d by R David Murray in branch '3.4':
#18628: clarify index entry for source file encoding declaration.
http://hg.python.org/cpython/rev/0413e0b1f76d

New changeset 7c2dcb18146c by R David Murray in branch 'default':
Merge: #18628: clarify index entry for source file encoding declaration.
http://hg.python.org/cpython/rev/7c2dcb18146c

New changeset 2a793df32be5 by R David Murray in branch '2.7':
#18628: clarify index entry for source file encoding declaration.
http://hg.python.org/cpython/rev/2a793df32be5

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

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

From report at bugs.python.org  Thu Apr 17 04:15:14 2014
From: report at bugs.python.org (R. David Murray)
Date: Thu, 17 Apr 2014 02:15:14 +0000
Subject: [docs] [issue18628] Better index entry for encoding declarations
In-Reply-To: <1375418984.87.0.318628832877.issue18628@psf.upfronthosting.co.za>
Message-ID: <1397700914.69.0.992595491804.issue18628@psf.upfronthosting.co.za>


R. David Murray added the comment:

Thanks, Sam.

----------
nosy: +r.david.murray
resolution:  -> fixed
stage: patch review -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Thu Apr 17 05:33:40 2014
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 17 Apr 2014 03:33:40 +0000
Subject: [docs] [issue21229] Path used for HTTP PUT request doesn't match
	the	description
In-Reply-To: <1397522183.41.0.398189687255.issue21229@psf.upfronthosting.co.za>
Message-ID: <3g8QyC2bFgz7Lkc@mail.python.org>


Roundup Robot added the comment:

New changeset 57c66f85942d by Senthil Kumaran in branch '3.4':
Correct the URL in the http.client example. Noted by Evens Fortun?. Closes #21229
http://hg.python.org/cpython/rev/57c66f85942d

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

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

From report at bugs.python.org  Thu Apr 17 05:34:25 2014
From: report at bugs.python.org (Senthil Kumaran)
Date: Thu, 17 Apr 2014 03:34:25 +0000
Subject: [docs] [issue21229] Path used for HTTP PUT request doesn't match
	the	description
In-Reply-To: <1397522183.41.0.398189687255.issue21229@psf.upfronthosting.co.za>
Message-ID: <1397705665.86.0.173460643438.issue21229@psf.upfronthosting.co.za>


Senthil Kumaran added the comment:

Yes. And thanks for the patch. I applied a slight variation of it.

----------

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

From report at bugs.python.org  Thu Apr 17 05:44:12 2014
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 17 Apr 2014 03:44:12 +0000
Subject: [docs] [issue21248] BROWSER env var described inaccurately in
	webbrowser docs
In-Reply-To: <1397597825.94.0.182594358629.issue21248@psf.upfronthosting.co.za>
Message-ID: <3g8RBM34JCz7Ljf@mail.python.org>


Roundup Robot added the comment:

New changeset 503bf9dee28e by Senthil Kumaran in branch '3.4':
Clarify BROWSER envar behavior in webbrowser.py. Noted by David Turner. Closes #21248
http://hg.python.org/cpython/rev/503bf9dee28e

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

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

From report at bugs.python.org  Thu Apr 17 05:45:08 2014
From: report at bugs.python.org (Senthil Kumaran)
Date: Thu, 17 Apr 2014 03:45:08 +0000
Subject: [docs] [issue21248] BROWSER env var described inaccurately in
	webbrowser docs
In-Reply-To: <1397597825.94.0.182594358629.issue21248@psf.upfronthosting.co.za>
Message-ID: <1397706308.53.0.364209833793.issue21248@psf.upfronthosting.co.za>


Senthil Kumaran added the comment:

Thanks for the bug report. The documentation has been fixed in the active versions.

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

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

From report at bugs.python.org  Thu Apr 17 06:50:41 2014
From: report at bugs.python.org (Martin Panter)
Date: Thu, 17 Apr 2014 04:50:41 +0000
Subject: [docs] [issue21279] str.translate documentation incomplete
In-Reply-To: <1397696482.87.0.486412592823.issue21279@psf.upfronthosting.co.za>
Message-ID: <1397710241.69.0.376564673868.issue21279@psf.upfronthosting.co.za>


Martin Panter added the comment:

I suspect ?iterable? is the wrong term.

>>> isinstance(set(), Iterable)
True
>>> "abc".translate(set())
TypeError: 'set' object does not support indexing
>>> "abc".translate(object())
TypeError: 'object' object is not subscriptable

Maybe ?indexable? or ?subscriptable? would be more correct? If this behaviour is part of the API, it would be nice to document, because it would have saved me a few times from implementing the __len__() and __iter__() methods of the mapping interface in my custom lookup tables.

Here is my suggestion:

str.translate(table):

Return a copy of the string where all characters have been mapped through ?table?, a lookup table. The lookup table must be a subscriptable object, for instance a dictionary or list, mapping Unicode ordinals (integers) to Unicode ordinals, strings or None. If a character is not in the table, the subscript operation should raise LookupError, and the character is left untouched. Characters mapped to None are deleted.

----------
nosy: +vadmium

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

From report at bugs.python.org  Thu Apr 17 07:08:45 2014
From: report at bugs.python.org (Martin Panter)
Date: Thu, 17 Apr 2014 05:08:45 +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: <1397711325.69.0.802957117126.issue21071@psf.upfronthosting.co.za>


Martin Panter added the comment:

This is closely related to Issue 16349. If format strings were explicitly allowed to be byte strings there would be less conflict, but documenting the data type of the ?format? attribute is better than nothing.

----------
nosy: +vadmium

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

From report at bugs.python.org  Thu Apr 17 08:02:31 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 17 Apr 2014 06:02:31 +0000
Subject: [docs] [issue5904] strftime docs do not explain locale effect on
	result	string
In-Reply-To: <1241270739.12.0.286821632978.issue5904@psf.upfronthosting.co.za>
Message-ID: <1397714551.55.0.719281911398.issue5904@psf.upfronthosting.co.za>


?ric Araujo added the comment:

This may help: http://blog.codekills.net/2013/04/13/strftime--table-of-locale-aware-formatters-in-different-locales/

----------
nosy: +wolever

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

From report at bugs.python.org  Thu Apr 17 08:20:32 2014
From: report at bugs.python.org (Georg Brandl)
Date: Thu, 17 Apr 2014 06:20:32 +0000
Subject: [docs] [issue21240] Add an abstactmethod directive to the Python
	ReST domain
In-Reply-To: <1397577446.45.0.129673687933.issue21240@psf.upfronthosting.co.za>
Message-ID: <1397715632.42.0.566376177406.issue21240@psf.upfronthosting.co.za>


Georg Brandl added the comment:

LGTM without having tested it.

----------

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

From report at bugs.python.org  Thu Apr 17 08:23:14 2014
From: report at bugs.python.org (David Wolever)
Date: Thu, 17 Apr 2014 06:23:14 +0000
Subject: [docs] [issue5904] strftime docs do not explain locale effect on
	result	string
In-Reply-To: <1241270739.12.0.286821632978.issue5904@psf.upfronthosting.co.za>
Message-ID: <1397715794.15.0.739173015587.issue5904@psf.upfronthosting.co.za>


David Wolever added the comment:

It may also be worth noting that the strftime formatters table now includes examples from different locales: https://docs.python.org/2/library/datetime.html#strftime-strptime-behavior

This change was introduced about a year ago.

----------

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

From report at bugs.python.org  Thu Apr 17 09:05:32 2014
From: report at bugs.python.org (Martin Panter)
Date: Thu, 17 Apr 2014 07:05:32 +0000
Subject: [docs] [issue21108] Add examples for importlib in doc
In-Reply-To: <1396240944.13.0.279884654032.issue21108@psf.upfronthosting.co.za>
Message-ID: <1397718332.74.0.86474967364.issue21108@psf.upfronthosting.co.za>


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


----------
nosy: +vadmium

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

From report at bugs.python.org  Thu Apr 17 09:13:34 2014
From: report at bugs.python.org (Nitika Agarwal)
Date: Thu, 17 Apr 2014 07:13:34 +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: <1397718814.75.0.479089429887.issue4744@psf.upfronthosting.co.za>


Nitika Agarwal added the comment:

But then I have submitted another patch issue4744_3 with the corrections.Please review my patch issue4744_3.patch

----------

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

From report at bugs.python.org  Thu Apr 17 12:43:16 2014
From: report at bugs.python.org (Josh Rosenberg)
Date: Thu, 17 Apr 2014 10:43:16 +0000
Subject: [docs] [issue21279] str.translate documentation incomplete
In-Reply-To: <1397696482.87.0.486412592823.issue21279@psf.upfronthosting.co.za>
Message-ID: <1397731396.33.0.0205968308226.issue21279@psf.upfronthosting.co.za>


Josh Rosenberg added the comment:

For the record, I have intentionally used bytes.maketrans to make translation table for str.translate for precisely this reason; it's much faster to look up a ordinal in a bytes object than in a dictionary. Before the recent (partial) patch for str.translate performance (#21118), this was a huge improvement if you only needed to worry about latin-1 characters (though encoding to latin-1, using bytes.translate, then decoding again was still faster). It's still faster than using a dictionary even with the patch from #21118, but it's not nearly as significant.

----------
nosy: +josh.rosenberg

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

From report at bugs.python.org  Thu Apr 17 17:57:12 2014
From: report at bugs.python.org (Glenn Jones)
Date: Thu, 17 Apr 2014 15:57:12 +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: <1397750232.07.0.811476189378.issue9364@psf.upfronthosting.co.za>


Changes by Glenn Jones <glenn at millenniumhand.co.uk>:


Added file: http://bugs.python.org/file34947/_sitebuiltins-2.patch

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

From report at bugs.python.org  Thu Apr 17 17:57:22 2014
From: report at bugs.python.org (Glenn Jones)
Date: Thu, 17 Apr 2014 15:57:22 +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: <1397750242.42.0.384392011647.issue9364@psf.upfronthosting.co.za>


Changes by Glenn Jones <glenn at millenniumhand.co.uk>:


Added file: http://bugs.python.org/file34948/pydoc-2.patch

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

From report at bugs.python.org  Thu Apr 17 17:58:53 2014
From: report at bugs.python.org (Glenn Jones)
Date: Thu, 17 Apr 2014 15:58:53 +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: <1397750333.22.0.246693520766.issue9364@psf.upfronthosting.co.za>


Glenn Jones added the comment:

I have added patches that replace the previous ones and apply to head. It appears that the other changes discussed (crosslinking and improving documentation) have already been done.

----------
nosy: +Glenn.Jones

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

From report at bugs.python.org  Thu Apr 17 18:06:52 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 17 Apr 2014 16:06:52 +0000
Subject: [docs] [issue21268] Update pydoc module docstring
In-Reply-To: <1397680012.16.0.887791975702.issue21268@psf.upfronthosting.co.za>
Message-ID: <1397750812.59.0.281784369672.issue21268@psf.upfronthosting.co.za>


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


----------
resolution:  -> duplicate
stage: needs patch -> committed/rejected
status: open -> closed
superseder:  -> some problems with the documentation of pydoc

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

From report at bugs.python.org  Thu Apr 17 18:38:55 2014
From: report at bugs.python.org (Mark Dickinson)
Date: Thu, 17 Apr 2014 16:38:55 +0000
Subject: [docs] [issue21286] Refcounting information missing in docs for
	Python 3.4	and above.
Message-ID: <1397752734.97.0.965637829315.issue21286@psf.upfronthosting.co.za>


New submission from Mark Dickinson:

It looks as though the information from refcounts.dat isn't making it into the online docs for 3.4 and 3.5.  See e.g., the documentation for PyList_GetItem.  For 3.3 [2], there's a "Return value: Borrowed reference." annotation supplied by Sphinx's refcounting extension.  For the 3.4 and 3.5 docs that annotation is missing.

Issue originally reported by Jianfeng Mao on the python-dev mailing list [1].

[1] https://mail.python.org/pipermail/python-dev/2014-April/134089.html
[2] https://docs.python.org/3.3/c-api/list.html?highlight=pylist_getitem#PyList_GetItem

----------
assignee: docs at python
components: Documentation
messages: 216707
nosy: docs at python, mark.dickinson
priority: normal
severity: normal
status: open
title: Refcounting information missing in docs for Python 3.4 and above.
versions: Python 3.4, Python 3.5

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

From report at bugs.python.org  Thu Apr 17 18:40:45 2014
From: report at bugs.python.org (STINNER Victor)
Date: Thu, 17 Apr 2014 16:40:45 +0000
Subject: [docs] [issue21286] Refcounting information missing in docs for
	Python 3.4	and above.
In-Reply-To: <1397752734.97.0.965637829315.issue21286@psf.upfronthosting.co.za>
Message-ID: <1397752845.63.0.903498604616.issue21286@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Apr 17 18:44:23 2014
From: report at bugs.python.org (Mark Dickinson)
Date: Thu, 17 Apr 2014 16:44:23 +0000
Subject: [docs] [issue21286] Refcounting information missing in docs for
	Python 3.4	and above.
In-Reply-To: <1397752734.97.0.965637829315.issue21286@psf.upfronthosting.co.za>
Message-ID: <1397753063.87.0.907646158856.issue21286@psf.upfronthosting.co.za>


Mark Dickinson added the comment:

N.B.  When I build the docs locally on the default branch (using 'make html' from the Docs directory on a clean checkout), I *do* see the refcounting annotations in the html output.

----------

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

From report at bugs.python.org  Thu Apr 17 19:54:15 2014
From: report at bugs.python.org (Ned Deily)
Date: Thu, 17 Apr 2014 17:54:15 +0000
Subject: [docs] [issue21286] Refcounting information missing in docs for
	Python 3.4	and above.
In-Reply-To: <1397752734.97.0.965637829315.issue21286@psf.upfronthosting.co.za>
Message-ID: <1397757255.5.0.133138552641.issue21286@psf.upfronthosting.co.za>


Changes by Ned Deily <nad at acm.org>:


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

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

From report at bugs.python.org  Thu Apr 17 22:14:03 2014
From: report at bugs.python.org (Dave Sawyer)
Date: Thu, 17 Apr 2014 20:14:03 +0000
Subject: [docs] [issue21289] make.bat not building documentation
Message-ID: <1397765643.91.0.331086007996.issue21289@psf.upfronthosting.co.za>


New submission from Dave Sawyer:

With Python 3.5, some refactoring of the documentation structure has been done. Building the documentation targets directly works, but using the supplied make.bat fails, not finding the sphinx python file.

----------
assignee: docs at python
components: Documentation
messages: 216737
nosy: docs at python, dsawyer
priority: normal
severity: normal
status: open
title: make.bat not building documentation
type: compile error
versions: Python 3.5

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

From report at bugs.python.org  Thu Apr 17 22:15:48 2014
From: report at bugs.python.org (Dave Sawyer)
Date: Thu, 17 Apr 2014 20:15:48 +0000
Subject: [docs] [issue21289] make.bat not building documentation
In-Reply-To: <1397765643.91.0.331086007996.issue21289@psf.upfronthosting.co.za>
Message-ID: <1397765748.87.0.190333845556.issue21289@psf.upfronthosting.co.za>


Changes by Dave Sawyer <dsawyer at box.com>:


----------
type: compile error -> behavior

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

From report at bugs.python.org  Thu Apr 17 22:53:45 2014
From: report at bugs.python.org (Dave Sawyer)
Date: Thu, 17 Apr 2014 20:53:45 +0000
Subject: [docs] [issue21289] make.bat not building documentation
In-Reply-To: <1397765643.91.0.331086007996.issue21289@psf.upfronthosting.co.za>
Message-ID: <1397768025.21.0.753436388903.issue21289@psf.upfronthosting.co.za>


Changes by Dave Sawyer <dsawyer at box.com>:


----------
keywords: +patch
Added file: http://bugs.python.org/file34954/mywork.patch

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

From report at bugs.python.org  Thu Apr 17 22:55:12 2014
From: report at bugs.python.org (Dave Sawyer)
Date: Thu, 17 Apr 2014 20:55:12 +0000
Subject: [docs] [issue21289] make.bat not building documentation
In-Reply-To: <1397765643.91.0.331086007996.issue21289@psf.upfronthosting.co.za>
Message-ID: <1397768112.49.0.74978456284.issue21289@psf.upfronthosting.co.za>


Dave Sawyer added the comment:

Removed the use of python in the make, calling the sphinx-build executable. Also the Doc directory was called "Docs" in the readme.txt

----------

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

From zachary.ware at gmail.com  Thu Apr 17 23:03:54 2014
From: zachary.ware at gmail.com (zachary.ware at gmail.com)
Date: Thu, 17 Apr 2014 21:03:54 -0000
Subject: [docs] make.bat not building documentation (issue 21289)
Message-ID: <20140417210354.16789.50147@psf.upfronthosting.co.za>

One comment, otherwise looks good to me.


http://bugs.python.org/review/21289/diff/11664/Doc/make.bat
File Doc/make.bat (right):

http://bugs.python.org/review/21289/diff/11664/Doc/make.bat#newcode5
Doc/make.bat:5: if "%DISTVERSION%" EQU "" for /f "usebackq" %%v in
(`%PYTHON% tools/sphinxext/patchlevel.py`) do set DISTVERSION=%%v
%PYTHON% is still necessary here for htmlhelp builds.  The '-2'
qualifier can be dropped, though; any version of Python will work with
patchlevel.py.

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

From report at bugs.python.org  Thu Apr 17 23:09:59 2014
From: report at bugs.python.org (Zachary Ware)
Date: Thu, 17 Apr 2014 21:09:59 +0000
Subject: [docs] [issue21289] make.bat not building documentation
In-Reply-To: <1397765643.91.0.331086007996.issue21289@psf.upfronthosting.co.za>
Message-ID: <1397768999.7.0.277432636098.issue21289@psf.upfronthosting.co.za>


Zachary Ware added the comment:

I left a review on Rietveld, which should have sent you an email.

Thanks for the report and patch!  If you plan on submitting anything more than the most trivial of patches, could you please sign the contributor agreement[1][2]?  Thanks!


[1]The form: https://www.python.org/psf/contrib/contrib-form/
[2]More information: https://www.python.org/psf/contrib/

----------
assignee: docs at python -> zach.ware
nosy: +zach.ware
stage:  -> patch review
versions: +Python 3.4

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

From report at bugs.python.org  Thu Apr 17 23:47:16 2014
From: report at bugs.python.org (Dave Sawyer)
Date: Thu, 17 Apr 2014 21:47:16 +0000
Subject: [docs] [issue15414] os.path.join behavior on Windows (ntpath.join)
	is	unexpected and not well documented
In-Reply-To: <1342903268.21.0.193498975528.issue15414@psf.upfronthosting.co.za>
Message-ID: <1397771236.07.0.185695605958.issue15414@psf.upfronthosting.co.za>


Dave Sawyer added the comment:

http://bugs.python.org/issue1669539 has been partially fixed. On Windows os.path.join('foo', 'a:bar') gives 'a:bar' not 'foo\\a:bar'. However os.path.isabs('a:bar') returns False yet it causes a reset in the join like an absolute path.

'\foo' is considered an absolute path even though calling os.path.abspath on it can yield different results - as if it were a relative path. At minimum we should amend the wording about what resets the join.

----------
nosy: +dsawyer

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

From report at bugs.python.org  Fri Apr 18 00:29:34 2014
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 17 Apr 2014 22:29:34 +0000
Subject: [docs] [issue21286] Refcounting information missing in docs for
	Python 3.4	and above.
In-Reply-To: <1397752734.97.0.965637829315.issue21286@psf.upfronthosting.co.za>
Message-ID: <3g8w8s4hH1z7LjM@mail.python.org>


Roundup Robot added the comment:

New changeset 8c12d3e0f1de by Benjamin Peterson in branch '3.4':
fix ref count annotations on sphinx >= 1.2.1 (closes #21286)
http://hg.python.org/cpython/rev/8c12d3e0f1de

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

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

From report at bugs.python.org  Fri Apr 18 00:31:40 2014
From: report at bugs.python.org (Dave Sawyer)
Date: Thu, 17 Apr 2014 22:31:40 +0000
Subject: [docs] [issue15414] os.path.join behavior on Windows (ntpath.join)
	is	unexpected and not well documented
In-Reply-To: <1342903268.21.0.193498975528.issue15414@psf.upfronthosting.co.za>
Message-ID: <1397773900.81.0.766528551901.issue15414@psf.upfronthosting.co.za>


Changes by Dave Sawyer <dsawyer at box.com>:


----------
keywords: +patch
Added file: http://bugs.python.org/file34956/joindoc.patch

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

From report at bugs.python.org  Fri Apr 18 00:46:06 2014
From: report at bugs.python.org (Dave Sawyer)
Date: Thu, 17 Apr 2014 22:46:06 +0000
Subject: [docs] [issue15414] os.path.join behavior on Windows (ntpath.join)
	is	unexpected and not well documented
In-Reply-To: <1342903268.21.0.193498975528.issue15414@psf.upfronthosting.co.za>
Message-ID: <1397774766.12.0.607251943237.issue15414@psf.upfronthosting.co.za>


Changes by Dave Sawyer <dsawyer at box.com>:


----------
versions: +Python 3.4, Python 3.5 -Python 2.7, Python 3.2, Python 3.3

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

From report at bugs.python.org  Fri Apr 18 01:35:51 2014
From: report at bugs.python.org (Dave Sawyer)
Date: Thu, 17 Apr 2014 23:35:51 +0000
Subject: [docs] [issue21289] make.bat not building documentation
In-Reply-To: <1397765643.91.0.331086007996.issue21289@psf.upfronthosting.co.za>
Message-ID: <1397777751.74.0.135839218675.issue21289@psf.upfronthosting.co.za>


Changes by Dave Sawyer <dsawyer at box.com>:


Added file: http://bugs.python.org/file34957/mywork.patch

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

From report at bugs.python.org  Fri Apr 18 01:37:36 2014
From: report at bugs.python.org (Dave Sawyer)
Date: Thu, 17 Apr 2014 23:37:36 +0000
Subject: [docs] [issue21289] make.bat not building documentation
In-Reply-To: <1397765643.91.0.331086007996.issue21289@psf.upfronthosting.co.za>
Message-ID: <1397777856.79.0.0447519097216.issue21289@psf.upfronthosting.co.za>


Dave Sawyer added the comment:

Thanks Zach! The bug tracker was nice enough to prompt me to go look in my email for the agreement too.

----------

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

From report at bugs.python.org  Fri Apr 18 03:55:57 2014
From: report at bugs.python.org (=?utf-8?b?SmVzw7pzIENlYSBBdmnDs24=?=)
Date: Fri, 18 Apr 2014 01:55:57 +0000
Subject: [docs] [issue21202] Naming a file` io.py` causes cryptic error
	message
In-Reply-To: <1397239551.94.0.578791540537.issue21202@psf.upfronthosting.co.za>
Message-ID: <1397786157.96.0.407054838402.issue21202@psf.upfronthosting.co.za>


Changes by Jes?s Cea Avi?n <jcea at jcea.es>:


----------
nosy: +jcea

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

From report at bugs.python.org  Fri Apr 18 06:19:33 2014
From: report at bugs.python.org (=?utf-8?b?VmVkcmFuIMSMYcSNacSH?=)
Date: Fri, 18 Apr 2014 04:19:33 +0000
Subject: [docs] [issue21294] len wrong help
Message-ID: <1397794773.2.0.687727547467.issue21294@psf.upfronthosting.co.za>


New submission from Vedran ?a?i?:

>From recently, help(len) gives the wrong signature of len.

Help on built-in function len in module builtins:

len(...)
    len(module, object)
        ^^^^^^^^
    Return the number of items of a sequence or mapping.

I tried to track it down, I think it happened here: http://bugs.python.org/file33655/larry.support.text_signature.on.more.types.6.txt

I realize it was a part of some big fix, so I don't know how easy it is to fix independently. Also, you might think it's not so big an issue. But I teach Python, and my pupils are really confused because of this. Please fix it if anyhow possible. Tnx.

----------
assignee: docs at python
components: Documentation
messages: 216771
nosy: Vedran.?a?i?, docs at python
priority: normal
severity: normal
status: open
title: len wrong help
versions: Python 3.4

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

From report at bugs.python.org  Fri Apr 18 06:28:49 2014
From: report at bugs.python.org (Ned Deily)
Date: Fri, 18 Apr 2014 04:28:49 +0000
Subject: [docs] [issue21294] len wrong help
In-Reply-To: <1397794773.2.0.687727547467.issue21294@psf.upfronthosting.co.za>
Message-ID: <1397795329.59.0.727605782977.issue21294@psf.upfronthosting.co.za>


Changes by Ned Deily <nad at acm.org>:


----------
nosy: +larry
stage:  -> needs patch

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

From report at bugs.python.org  Fri Apr 18 06:37:08 2014
From: report at bugs.python.org (Yury Selivanov)
Date: Fri, 18 Apr 2014 04:37:08 +0000
Subject: [docs] [issue21294] len wrong help
In-Reply-To: <1397794773.2.0.687727547467.issue21294@psf.upfronthosting.co.za>
Message-ID: <1397795828.43.0.710459655503.issue21294@psf.upfronthosting.co.za>


Changes by Yury Selivanov <yselivanov.ml at gmail.com>:


----------
nosy: +ncoghlan, yselivanov

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

From report at bugs.python.org  Fri Apr 18 07:02:25 2014
From: report at bugs.python.org (Georg Brandl)
Date: Fri, 18 Apr 2014 05:02:25 +0000
Subject: [docs] [issue21286] Refcounting information missing in docs for
	Python 3.4	and above.
In-Reply-To: <1397752734.97.0.965637829315.issue21286@psf.upfronthosting.co.za>
Message-ID: <1397797345.57.0.38808914604.issue21286@psf.upfronthosting.co.za>


Georg Brandl added the comment:

Thanks!

----------

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

From report at bugs.python.org  Fri Apr 18 07:04:16 2014
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 18 Apr 2014 05:04:16 +0000
Subject: [docs] [issue21294] len wrong help
In-Reply-To: <1397794773.2.0.687727547467.issue21294@psf.upfronthosting.co.za>
Message-ID: <3g94wH1Nlhz7Ljf@mail.python.org>


Roundup Robot added the comment:

New changeset 679319e3f42b by Benjamin Peterson in branch '3.4':
correct len signature in docstring (closes #21294)
http://hg.python.org/cpython/rev/679319e3f42b

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

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

From report at bugs.python.org  Fri Apr 18 07:20:12 2014
From: report at bugs.python.org (=?utf-8?b?VmVkcmFuIMSMYcSNacSH?=)
Date: Fri, 18 Apr 2014 05:20:12 +0000
Subject: [docs] [issue21294] len wrong help
In-Reply-To: <1397794773.2.0.687727547467.issue21294@psf.upfronthosting.co.za>
Message-ID: <1397798412.43.0.0267292003315.issue21294@psf.upfronthosting.co.za>


Vedran ?a?i? added the comment:

1. Was it really _that_ easy? I mean, there obviously was a reason for previous change... someone wouldn't add a parameter to documentation out of thin air. As far as I can see, it was because automatic argument inspection didn't work in some cases...

2. If it really is that easy, when will the fixed version be available? I know I can compile from source, but my pupils are not so comfortable with this. Will it be in 3.4.1?

----------

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

From report at bugs.python.org  Fri Apr 18 07:46:17 2014
From: report at bugs.python.org (Larry Hastings)
Date: Fri, 18 Apr 2014 05:46:17 +0000
Subject: [docs] [issue21294] len wrong help
In-Reply-To: <1397794773.2.0.687727547467.issue21294@psf.upfronthosting.co.za>
Message-ID: <1397799977.85.0.75098590404.issue21294@psf.upfronthosting.co.za>


Larry Hastings added the comment:

It's really that easy, it was a stupid bug that is probably my fault, the fix will be in 3.4.1.

----------

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

From report at bugs.python.org  Fri Apr 18 13:52:21 2014
From: report at bugs.python.org (Daniel Andersson)
Date: Fri, 18 Apr 2014 11:52:21 +0000
Subject: [docs] [issue21297] skipinitialspace in the csv module only skips
	spaces, not "whitespace" in general
Message-ID: <1397821941.61.0.706896478348.issue21297@psf.upfronthosting.co.za>


New submission from Daniel Andersson:

Regarding the `skipinitialspace` parameter to the different CSV reader dialects in the `csv` module, the official documentation asserts:

    When True, whitespace immediately following the delimiter is ignored.

and the `help(csv)` style module documentation says:

    * skipinitialspace - specifies how to interpret whitespace which
      immediately follows a delimiter.  It defaults to False, which
      means that whitespace immediately following a delimiter is part
      of the following field.

"Whitespace" is a bit too general in both cases (at least a red herring in the second case), since it only skips spaces and not e.g. tabs [1].

In `Modules/_csv.c`, it more correctly describes the parameter. At line 81:

    int skipinitialspace;       /* ignore spaces following delimiter? */

and the actual implementation at line 638:

    else if (c == ' ' && dialect->skipinitialspace)
        /* ignore space at start of field */
        ;

No-one will probably assume that the whole UTF-8 spectrum of "whitespace" is skipped, but at least I initially assumed that the tab character was included.

[1]: http://en.wikipedia.org/wiki/Whitespace_character

----------
assignee: docs at python
components: Documentation, Library (Lib)
messages: 216780
nosy: Daniel.Andersson, docs at python
priority: normal
severity: normal
status: open
title: skipinitialspace in the csv module only skips spaces, not "whitespace" in general
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/issue21297>
_______________________________________

From report at bugs.python.org  Fri Apr 18 15:51:28 2014
From: report at bugs.python.org (Merlijn van Deen)
Date: Fri, 18 Apr 2014 13:51:28 +0000
Subject: [docs] [issue21300] Docs (incorrectly) suggest email.policy.default
	is the	default policy
Message-ID: <1397829088.9.0.524887326408.issue21300@psf.upfronthosting.co.za>


New submission from Merlijn van Deen:

Which would make sense, but email.policy.Compat32 is *actually* the default policy. This patch adapts the documentation to reflect this.

----------
assignee: docs at python
components: Documentation
files: defaultpolicy.diff
keywords: patch
messages: 216783
nosy: docs at python, r.david.murray, valhallasw
priority: normal
severity: normal
status: open
title: Docs (incorrectly) suggest email.policy.default is the default policy
versions: Python 3.3, Python 3.4, Python 3.5
Added file: http://bugs.python.org/file34964/defaultpolicy.diff

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

From report at bugs.python.org  Fri Apr 18 18:41:17 2014
From: report at bugs.python.org (Zachary Ware)
Date: Fri, 18 Apr 2014 16:41:17 +0000
Subject: [docs] [issue21289] make.bat not building documentation
In-Reply-To: <1397765643.91.0.331086007996.issue21289@psf.upfronthosting.co.za>
Message-ID: <1397839277.86.0.157692041784.issue21289@psf.upfronthosting.co.za>


Zachary Ware added the comment:

Your more recent patch looks like it's missing the changes to Doc/make.bat, which I assume was unintentional :).  Also, thinking about it again, it would be good to use a %SPHINXBUILD% variable rather than hard-coding "sphinx-build" into the script, the same way %PYTHON% is used currently.

----------

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

From report at bugs.python.org  Fri Apr 18 22:03:21 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 18 Apr 2014 20:03:21 +0000
Subject: [docs] [issue21204] multiprocessing example does not work on Windows
In-Reply-To: <1397267440.3.0.253901505287.issue21204@psf.upfronthosting.co.za>
Message-ID: <1397851401.7.0.789989793274.issue21204@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

When quoting from the docs, it is helpful to give a link.
https://docs.python.org/2/library/multiprocessing.html#examples
That also identifies the version.

I verified that the example fails on my 2.7.6 Windows 7 with
PicklingError: Can't pickle <type 'thread.lock'>: it's not found as thread.lock 

Since the example has been removed for 3.x, a possible minimal fix would be to say that it does not work on Windows and remove the statement that implies that it does.
  if sys.platform == 'win32': import multiprocessing.reduction
  # make sockets pickable/inheritable

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

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

From report at bugs.python.org  Fri Apr 18 22:45:47 2014
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 18 Apr 2014 20:45:47 +0000
Subject: [docs] [issue21289] make.bat not building documentation
In-Reply-To: <1397765643.91.0.331086007996.issue21289@psf.upfronthosting.co.za>
Message-ID: <3g9Tpf3Yrpz7LjS@mail.python.org>


Roundup Robot added the comment:

New changeset 02fec733f760 by Zachary Ware in branch '3.4':
Issue #21289: Fix documentation building on Windows using Doc/make.bat.
http://hg.python.org/cpython/rev/02fec733f760

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

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

From report at bugs.python.org  Fri Apr 18 22:48:13 2014
From: report at bugs.python.org (Zachary Ware)
Date: Fri, 18 Apr 2014 20:48:13 +0000
Subject: [docs] [issue21289] make.bat not building documentation
In-Reply-To: <1397765643.91.0.331086007996.issue21289@psf.upfronthosting.co.za>
Message-ID: <1397854093.02.0.812052926649.issue21289@psf.upfronthosting.co.za>


Zachary Ware added the comment:

Fixed, thanks for the patch!  I went ahead and implemented my comments and committed it.

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

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

From report at bugs.python.org  Fri Apr 18 22:55:12 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 18 Apr 2014 20:55:12 +0000
Subject: [docs] [issue21232] Use of '1' instead of 'True' as 'splitlines'
	argument in	difflib documentation
In-Reply-To: <1397542231.28.0.662234584475.issue21232@psf.upfronthosting.co.za>
Message-ID: <1397854512.7.0.475973864643.issue21232@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

In 2.x, 1 is guaranteed to be true, in that sense that
  if 1: print 'true'
is guaranteed to print 'true', while True is not necessarily true.
>>> True = 0
>>> if True: print 'yes'

>>>
So 2.x docs should not be changed.

----------
nosy: +terry.reedy
versions:  -Python 2.7, Python 3.1, Python 3.2, Python 3.3

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

From report at bugs.python.org  Fri Apr 18 22:55:23 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 18 Apr 2014 20:55:23 +0000
Subject: [docs] [issue21232] Use of '1' instead of 'True' as 'splitlines'
	argument in	difflib documentation
In-Reply-To: <1397542231.28.0.662234584475.issue21232@psf.upfronthosting.co.za>
Message-ID: <1397854523.61.0.735569920408.issue21232@psf.upfronthosting.co.za>


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


----------
assignee: docs at python -> terry.reedy

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

From report at bugs.python.org  Fri Apr 18 23:01:33 2014
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 18 Apr 2014 21:01:33 +0000
Subject: [docs] [issue21232] Use of '1' instead of 'True' as 'splitlines'
	argument in	difflib documentation
In-Reply-To: <1397542231.28.0.662234584475.issue21232@psf.upfronthosting.co.za>
Message-ID: <3g9V8r3pk1z7Ljf@mail.python.org>


Roundup Robot added the comment:

New changeset 604b74f9a07d by Terry Jan Reedy in branch '3.4':
Issue #21232: Replace .splitlines arg '1' with 'keepends=True'.
http://hg.python.org/cpython/rev/604b74f9a07d

New changeset c82dcad83438 by Terry Jan Reedy in branch 'default':
Merge with 3.4. Closes #21232.
http://hg.python.org/cpython/rev/c82dcad83438

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

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

From report at bugs.python.org  Fri Apr 18 23:35:12 2014
From: report at bugs.python.org (Dave Sawyer)
Date: Fri, 18 Apr 2014 21:35:12 +0000
Subject: [docs] [issue21289] make.bat not building documentation
In-Reply-To: <1397854093.02.0.812052926649.issue21289@psf.upfronthosting.co.za>
Message-ID: <3b00f5f7200cac843a68095b0fac9274@mail.gmail.com>


Dave Sawyer added the comment:

Thanks Zach, I'm used to Git and this was my first foray with Hg and trying
to rebase (I knew I shoulda branched before starting on another patch). BTW,
the devs at PyCon Montreal said "Zach's a good guy. One of maybe 4 Windows
devs."

-Dave

----------

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

From report at bugs.python.org  Fri Apr 18 23:35:46 2014
From: report at bugs.python.org (Ned Batchelder)
Date: Fri, 18 Apr 2014 21:35:46 +0000
Subject: [docs] [issue21232] Use of '1' instead of 'True' as 'splitlines'
	argument in	difflib documentation
In-Reply-To: <1397542231.28.0.662234584475.issue21232@psf.upfronthosting.co.za>
Message-ID: <1397856946.41.0.557940450465.issue21232@psf.upfronthosting.co.za>


Ned Batchelder added the comment:

Although the OP was incorrect about 1 being guaranteed to be True, it is still better documentation to use True rather than 1 for a boolean argument.

----------
nosy: +nedbat

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

From report at bugs.python.org  Sat Apr 19 00:47:23 2014
From: report at bugs.python.org (Kinga Farkas)
Date: Fri, 18 Apr 2014 22:47:23 +0000
Subject: [docs] [issue21279] str.translate documentation incomplete
In-Reply-To: <1397696482.87.0.486412592823.issue21279@psf.upfronthosting.co.za>
Message-ID: <1397861242.93.0.340464957671.issue21279@psf.upfronthosting.co.za>


Kinga Farkas added the comment:

I have created a patch based on Martin Panter's suggestions.  Please let me know if it is off or there should be additional changes included.

----------
keywords: +patch
nosy: +lilbludot
Added file: http://bugs.python.org/file34966/issue21279.patch

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

From report at bugs.python.org  Sat Apr 19 02:08:48 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 19 Apr 2014 00:08:48 +0000
Subject: [docs] [issue21279] str.translate documentation incomplete
In-Reply-To: <1397696482.87.0.486412592823.issue21279@psf.upfronthosting.co.za>
Message-ID: <1397866128.12.0.739102602152.issue21279@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

The docstring is more accurate.
">>> str.translate.__doc__
'S.translate(table) -> str\n\nReturn a copy of the string S, where all characters have been mapped\nthrough the given translation table, which must be a mapping of\nUnicode ordinals to Unicode ordinals, strings, or None.\nUnmapped characters are left untouched. Characters mapped to None\nare deleted.'""

To me, even this is a bit unclear on exceptions and 'unmapped'. Based on experiments and then reading the C source, I determined that LookupErrors mean 'unmapped' while other exceptions are passed on and terminate the translation.

"Return a copy of the string S, where all characters have been mapped through the given translation table. When subscripted by a Unicode ordinal (integer in range(1048576)), the table must return a Unicode ordinal, string, or None, or else raise a LookupError. A LookupError, which includes instances of subclasses IndexError and KeyError, indicates that the character is unmapped and should be left untouched. Characters mapped to None are deleted."

class Table:
    def __getitem__(self, key):
        if key == 99:   raise LookupError() #'c'
        elif key == 100: return None  # 'd'
        elif key == 101: return 'xyz'  # 'e'
        else: return key+1
                
print('abcdef'.translate(Table()))
# bccxyzg

The current doc ends with "Note
An even more flexible approach is to create a custom character mapping codec using the codecs module (see encodings.cp1251 for an example)."

I don't see how this is supposed to help. Encodings.cp1251 uses a string of 256 chars as a lookup table.

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

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

From report at bugs.python.org  Sat Apr 19 02:10:18 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 19 Apr 2014 00:10:18 +0000
Subject: [docs] [issue21279] str.translate documentation incomplete
In-Reply-To: <1397696482.87.0.486412592823.issue21279@psf.upfronthosting.co.za>
Message-ID: <1397866217.97.0.342892705466.issue21279@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

I see that we mostly added the same info.

----------

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

From report at bugs.python.org  Sat Apr 19 02:35:27 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 19 Apr 2014 00:35:27 +0000
Subject: [docs] [issue21297] csv.skipinitialspace only skips spaces,
	not "whitespace" in general
In-Reply-To: <1397821941.61.0.706896478348.issue21297@psf.upfronthosting.co.za>
Message-ID: <1397867727.01.0.298725400673.issue21297@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

Do I understand correctly that only one space is ignored?

----------
nosy: +terry.reedy
stage:  -> needs patch
title: skipinitialspace in the csv module only skips spaces, not "whitespace" in general -> csv.skipinitialspace only skips spaces, not "whitespace" in general
versions:  -Python 3.1, Python 3.2, Python 3.3

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

From report at bugs.python.org  Sat Apr 19 02:53:02 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 19 Apr 2014 00:53:02 +0000
Subject: [docs] [issue21232] Use of '1' instead of 'True' as 'splitlines'
	argument in	difflib documentation
In-Reply-To: <1397542231.28.0.662234584475.issue21232@psf.upfronthosting.co.za>
Message-ID: <1397868782.64.0.257254209549.issue21232@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

I believe that there have been discussions on this point and my memory is to leave 1 alone in 2.x docs. I could be mistaken though.

----------

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

From vadmium+py at gmail.com  Sat Apr 19 03:27:59 2014
From: vadmium+py at gmail.com (vadmium+py at gmail.com)
Date: Sat, 19 Apr 2014 01:27:59 -0000
Subject: [docs] str.translate documentation incomplete (issue 21279)
Message-ID: <20140419012759.16788.3370@psf.upfronthosting.co.za>


http://bugs.python.org/review/21279/diff/11671/Doc/library/stdtypes.rst
File Doc/library/stdtypes.rst (right):

http://bugs.python.org/review/21279/diff/11671/Doc/library/stdtypes.rst#newcode1914
Doc/library/stdtypes.rst:1914: for instance a dictionary or or a list,
mapping  Unicode ordinals (integers)
?or or a list?: Just one ?or? should get the point across :)

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

From report at bugs.python.org  Sat Apr 19 03:48:03 2014
From: report at bugs.python.org (Charles-Axel Dein)
Date: Sat, 19 Apr 2014 01:48:03 +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: <1397872083.69.0.00519960920259.issue20351@psf.upfronthosting.co.za>


Charles-Axel Dein added the comment:

New version of the patch.

----------
Added file: http://bugs.python.org/file34969/add_csvdict_examples.patch

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

From andrew.svetlov at gmail.com  Sat Apr 19 11:59:22 2014
From: andrew.svetlov at gmail.com (andrew.svetlov at gmail.com)
Date: Sat, 19 Apr 2014 09:59:22 -0000
Subject: [docs] Add doc examples for DictReader and DictWriter (issue
	20351)
Message-ID: <20140419095922.16789.62247@psf.upfronthosting.co.za>

review


http://bugs.python.org/review/20351/diff/11674/Doc/library/csv.rst
File Doc/library/csv.rst (right):

http://bugs.python.org/review/20351/diff/11674/Doc/library/csv.rst#newcode162
Doc/library/csv.rst:162: A short usage example::
Just use ::

http://bugs.python.org/review/20351/diff/11674/Doc/library/csv.rst#newcode195
Doc/library/csv.rst:195: A short usage example::
:: again

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

From report at bugs.python.org  Sat Apr 19 17:55:30 2014
From: report at bugs.python.org (Senthil Kumaran)
Date: Sat, 19 Apr 2014 15:55:30 +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: <1397922930.5.0.00560842047566.issue16827@psf.upfronthosting.co.za>


Senthil Kumaran added the comment:

For this bug, I think, section 2.2.4 and section 2.2.5 can be moved to section 13 and inserted between section 13.1 and 13.2 as it seem to be fit in naturally there.

----------

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

From report at bugs.python.org  Sat Apr 19 19:06:47 2014
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 19 Apr 2014 17:06: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: <3gB0vV35BLz7Ljf@mail.python.org>


Roundup Robot added the comment:

New changeset 16207b8495bf by R David Murray in branch '3.4':
#9364: Improve the text printed by help(pydoc) and help(help).
http://hg.python.org/cpython/rev/16207b8495bf

New changeset 256c782ab078 by R David Murray in branch 'default':
Merge: #9364: Improve the text printed by help(pydoc) and help(help).
http://hg.python.org/cpython/rev/256c782ab078

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

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

From report at bugs.python.org  Sat Apr 19 19:09:30 2014
From: report at bugs.python.org (R. David Murray)
Date: Sat, 19 Apr 2014 17:09:30 +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: <1397927370.48.0.940544256572.issue9364@psf.upfronthosting.co.za>


R. David Murray added the comment:

Thanks, Glenn.  I tweaked the wording further.  If someone thinks it is worth the effort to backport this to 2.7, they can do so and reopen the issue.

----------
assignee: eric.araujo -> 
nosy: +r.david.murray
resolution:  -> fixed
stage: needs patch -> resolved
status: open -> closed
versions: +Python 3.4, Python 3.5 -Python 2.7, Python 3.1, Python 3.2, Python 3.3

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

From report at bugs.python.org  Sat Apr 19 23:25:35 2014
From: report at bugs.python.org (R. David Murray)
Date: Sat, 19 Apr 2014 21:25:35 +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: <1397942735.77.0.480694894075.issue4744@psf.upfronthosting.co.za>


R. David Murray added the comment:

The change covered by the patch (which patch rejected as garbage, by the way, I have no idea why) has already been applied by Serhiy Storchaka, apparently as a blanked change of 'empty string' to 'empty bytes object'.

There are several other places in the asynchat doc page that mention string.  I suspect that none of them is correct, but I haven't read through the page to be sure.

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

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

From report at bugs.python.org  Sat Apr 19 23:26:39 2014
From: report at bugs.python.org (R. David Murray)
Date: Sat, 19 Apr 2014 21:26:39 +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: <1397942799.24.0.717518936368.issue4744@psf.upfronthosting.co.za>


R. David Murray added the comment:

The change covered by the patch (which patch rejected as garbage, by the way, I have no idea why) has already been applied by Serhiy Storchaka, apparently as a blanket change of 'empty string' to 'empty bytes object'.

There are several other places in the asynchat doc page that mention string.  I suspect that none of them is correct, but I haven't read through the page to be sure.

----------

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

From report at bugs.python.org  Sat Apr 19 23:26:49 2014
From: report at bugs.python.org (R. David Murray)
Date: Sat, 19 Apr 2014 21:26:49 +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: <1397942809.07.0.817108509952.issue4744@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sun Apr 20 03:42:02 2014
From: report at bugs.python.org (Jessica McKellar)
Date: Sun, 20 Apr 2014 01:42:02 +0000
Subject: [docs] [issue8387] use universal newline mode in csv module examples
In-Reply-To: <1271193086.18.0.201846291594.issue8387@psf.upfronthosting.co.za>
Message-ID: <1397958122.62.0.20409058935.issue8387@psf.upfronthosting.co.za>


Jessica McKellar added the comment:

I ran some experiments to see what the state of the world is. I generated a test.csv by exporting a CSV file from Numbers on OSX. This generated a file with Windows-style \r\n-terminated lines. The attached test_csv.py tries to open this CSV file in binary and universal newlines modes. Here's what happens on various platforms

Python 3:
* Linux: both binary and universal work
* OSX: binary errors out, universal works
* Windows: binary errors out, universal works

In both cases, the error was:

$ python3 test_csv.py
Traceback (most recent call last):
  File "test_csv.py", line 5, in <module>
    for row in spamreader:
_csv.Error: iterator should return strings, not bytes (did you open the file in text mode?)

Python 2:
* Linux: both binary and universal work
* OSX: both binary and universal
* Windows: wasn't readily able to test

If I manually create a CSV file using TextEdit in plaintext mode on OSX, that produces a file with Mac-style \r-terminated lines. test_csv.py has the same results on this file on OSX (errors out in binary mode in Python 3).

----------
nosy: +jesstess
Added file: http://bugs.python.org/file34981/test_csv.py

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

From report at bugs.python.org  Sun Apr 20 03:42:14 2014
From: report at bugs.python.org (Jessica McKellar)
Date: Sun, 20 Apr 2014 01:42:14 +0000
Subject: [docs] [issue8387] use universal newline mode in csv module examples
In-Reply-To: <1271193086.18.0.201846291594.issue8387@psf.upfronthosting.co.za>
Message-ID: <1397958134.64.0.803979492272.issue8387@psf.upfronthosting.co.za>


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


Added file: http://bugs.python.org/file34982/test.csv

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

From report at bugs.python.org  Sun Apr 20 04:07:22 2014
From: report at bugs.python.org (Jessica McKellar)
Date: Sun, 20 Apr 2014 02:07:22 +0000
Subject: [docs] [issue8387] use universal newline mode in csv module examples
In-Reply-To: <1271193086.18.0.201846291594.issue8387@psf.upfronthosting.co.za>
Message-ID: <1397959642.16.0.855965731118.issue8387@psf.upfronthosting.co.za>


Jessica McKellar added the comment:

All of the examples from https://docs.python.org/3/library/csv.html run without issue on OSX, though.

In summary, the Python 2 examples error out on OSX and switching them to use 'U' instead of 'b' would fix this. I don't think any action needs to be taken for Python 3.

My one remaining question is about binary files on Windows. The Python 2 csv docs say "If csvfile is a file object, it must be opened with the ?b? flag on platforms where that makes a difference." I don't readily have a Windows machine to play with this -- do "binary" CSV files exist, or can we eliminate the 'b' language entirely and just talk about 'U'?

----------

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

From report at bugs.python.org  Sun Apr 20 04:23:14 2014
From: report at bugs.python.org (Mark Lawrence)
Date: Sun, 20 Apr 2014 02:23:14 +0000
Subject: [docs] [issue8387] use universal newline mode in csv module examples
In-Reply-To: <1271193086.18.0.201846291594.issue8387@psf.upfronthosting.co.za>
Message-ID: <1397960594.51.0.877164418681.issue8387@psf.upfronthosting.co.za>


Mark Lawrence added the comment:

I think that it's complete nonsense to talk about binary csv files on Windows.  They are just plain text files that can be manipulated with any old editor or a spreadsheet.

----------
nosy: +BreamoreBoy

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

From report at bugs.python.org  Sun Apr 20 04:27:56 2014
From: report at bugs.python.org (R. David Murray)
Date: Sun, 20 Apr 2014 02:27:56 +0000
Subject: [docs] [issue8387] use universal newline mode in csv module examples
In-Reply-To: <1271193086.18.0.201846291594.issue8387@psf.upfronthosting.co.za>
Message-ID: <1397960876.64.0.837132738426.issue8387@psf.upfronthosting.co.za>


R. David Murray added the comment:

The magic of newline='' in python3 is that it *preserves* the line end characters, which is the same thing binary mode does on windows.  The place that matters, as I remember it, is when there is a newline embedded inside a quoted string.  I don't remember *why* that matters, though :(.  But it had something to do with how the csv module processes the data internally.

----------

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

From report at bugs.python.org  Sun Apr 20 07:57:42 2014
From: report at bugs.python.org (R. David Murray)
Date: Sun, 20 Apr 2014 05:57:42 +0000
Subject: [docs] [issue21221] Minor struct_time documentation bug
In-Reply-To: <1397500160.88.0.743491348049.issue21221@psf.upfronthosting.co.za>
Message-ID: <1397973462.85.0.694378345669.issue21221@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sun Apr 20 12:07:19 2014
From: report at bugs.python.org (=?utf-8?b?VmVkcmFuIMSMYcSNacSH?=)
Date: Sun, 20 Apr 2014 10:07:19 +0000
Subject: [docs] [issue21314] Bizarre help
Message-ID: <1397988439.5.0.703056699862.issue21314@psf.upfronthosting.co.za>


New submission from Vedran ?a?i?:

Please look at the output of help(object.__ge__).

1. What's that $ in front of self? lt and gt don't have it.

2. What's that / as a third argument? Many wrapper functions have it (for example, see help(tuple.__len__).

3. What's that -- as the first line of doc? Similar methods don't have it.

----------
assignee: docs at python
components: Documentation
messages: 216899
nosy: Vedran.?a?i?, docs at python
priority: normal
severity: normal
status: open
title: Bizarre help
versions: Python 3.4

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

From report at bugs.python.org  Sun Apr 20 13:29:20 2014
From: report at bugs.python.org (Georg Brandl)
Date: Sun, 20 Apr 2014 11:29:20 +0000
Subject: [docs] [issue21314] Bizarre help
In-Reply-To: <1397988439.5.0.703056699862.issue21314@psf.upfronthosting.co.za>
Message-ID: <1397993360.78.0.126974177231.issue21314@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sun Apr 20 14:47:07 2014
From: report at bugs.python.org (Josh Rosenberg)
Date: Sun, 20 Apr 2014 12:47:07 +0000
Subject: [docs] [issue21314] Bizarre help
In-Reply-To: <1397988439.5.0.703056699862.issue21314@psf.upfronthosting.co.za>
Message-ID: <1397998027.13.0.470690397567.issue21314@psf.upfronthosting.co.za>


Josh Rosenberg added the comment:

I don't know about the other bits, but that trailing '/' is how Argument Clinic (which makes full featured inspection available to built-in functions) notes that the parameters are positional only, and cannot be passed by keyword. See PEP436.

----------
nosy: +josh.rosenberg

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

From report at bugs.python.org  Sun Apr 20 14:49:30 2014
From: report at bugs.python.org (Zachary Ware)
Date: Sun, 20 Apr 2014 12:49:30 +0000
Subject: [docs] [issue21314] Bizarre help
In-Reply-To: <1397988439.5.0.703056699862.issue21314@psf.upfronthosting.co.za>
Message-ID: <1397998170.5.0.56329850665.issue21314@psf.upfronthosting.co.za>


Zachary Ware added the comment:

1) This was due to a typo. The release of Python 3.4 saw the introduction of new introspection information on many C-implemented functions thanks to Argument Clinic (see PEP 436, I think it is). As part of that (still ongoing) transition, the default doctrings for type slots like __ge__ were given Argument Clinic-style signatures, and __ge__ had a typo.

I fixed that typo on Friday (actually prompted by your previous issue about len's bad signature).

2) That marker now shows that all proceeding arguments are positional-only.  We should probably make sure that is well documented somewhere, possibly in the tutorial.

3) This was also due to the typo I fixed.

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

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

From report at bugs.python.org  Sun Apr 20 17:08:57 2014
From: report at bugs.python.org (Antoine Pitrou)
Date: Sun, 20 Apr 2014 15:08:57 +0000
Subject: [docs] [issue8387] use universal newline mode in csv module examples
In-Reply-To: <1271193086.18.0.201846291594.issue8387@psf.upfronthosting.co.za>
Message-ID: <1398006537.55.0.886619097659.issue8387@psf.upfronthosting.co.za>


Antoine Pitrou added the comment:

Note that 'U' is a no-op under Python 3, it's just there for compatibility reasons; i.e. 'rU' is the same as 'r'.

Also, from a quick glance, the CSV parser in _csv.c looks newline-agnostic.

@sfinnie: can you explain which problems you encountered running the examples? Please also post the resulting exception tracebacks, if any.

----------
nosy: +pitrou

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

From report at bugs.python.org  Sun Apr 20 17:47:57 2014
From: report at bugs.python.org (Daniel Andersson)
Date: Sun, 20 Apr 2014 15:47:57 +0000
Subject: [docs] [issue21297] csv.skipinitialspace only skips spaces,
	not "whitespace" in general
In-Reply-To: <1397821941.61.0.706896478348.issue21297@psf.upfronthosting.co.za>
Message-ID: <1398008877.48.0.789379045576.issue21297@psf.upfronthosting.co.za>


Daniel Andersson added the comment:

No, multiple spaces are ignored as advertised (according to actual tests; not just reading the code), but only spaces (U+0020) and not e.g. tabs (U+0009), which are also included in the term "whitespace", along with several other characters.

In light of your followup question, the internal comment at `Modules/_csv.c`, line 639:

    /* ignore space at start of field */

could perhaps be clarified to say "spaces" instead of "space", but the code context makes it quite clear, and it does not face the users anyway. The main point of this issue is meant to be the wording in the module docstring and the official docs regarding "whitespace" contra "space".

----------

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

From report at bugs.python.org  Sun Apr 20 18:22:59 2014
From: report at bugs.python.org (Jessica McKellar)
Date: Sun, 20 Apr 2014 16:22:59 +0000
Subject: [docs] [issue8387] use universal newline mode in csv module examples
In-Reply-To: <1271193086.18.0.201846291594.issue8387@psf.upfronthosting.co.za>
Message-ID: <1398010979.29.0.378066370088.issue8387@psf.upfronthosting.co.za>


Jessica McKellar added the comment:

I realized that I typo'd 2 instead of 3 in http://bugs.python.org/issue8387#msg216888 which makes that message confusing. Here's a restatement of my findings:

* All of the Python 3 csv examples work in Python 3 on all platforms.
* The Python 2 binary-mode csv examples work in Python 2.7 on all platforms.
* The Python 2 binary-mode csv examples error out on Windows and OSX when run under Python 3. We could do nothing to address this, or, if we determine that there's no negative impact to removing the 'b', update the examples to accommodate readers who are running Python 2 examples using Python 3 for whatever reason.

Which does bring me to the same question as @pitrou, which is what data and code cause an error for @sfinnie on Python 2. :)

----------

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

From report at bugs.python.org  Mon Apr 21 00:38:28 2014
From: report at bugs.python.org (Ezio Melotti)
Date: Sun, 20 Apr 2014 22:38:28 +0000
Subject: [docs] [issue20969] Author of EPUB version of Python docs is set to
	Unknown	instead of PSF
In-Reply-To: <1395153249.12.0.327856107433.issue20969@psf.upfronthosting.co.za>
Message-ID: <1398033508.72.0.489222327527.issue20969@psf.upfronthosting.co.za>


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


----------
keywords: +easy
nosy: +ezio.melotti
stage:  -> needs patch
versions: +Python 3.5

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

From report at bugs.python.org  Mon Apr 21 00:42:42 2014
From: report at bugs.python.org (Ezio Melotti)
Date: Sun, 20 Apr 2014 22:42:42 +0000
Subject: [docs] [issue20997] Wrong URL fragment identifier in search result
In-Reply-To: <1395327003.08.0.0901954371896.issue20997@psf.upfronthosting.co.za>
Message-ID: <1398033762.07.0.132149714544.issue20997@psf.upfronthosting.co.za>


Ezio Melotti added the comment:

It might be a bug in the older Sphinx version used to build the 2.x docs.  If this is the case, it's probably not worth fixing.  Georg?

----------
nosy: +ezio.melotti, georg.brandl
resolution:  -> wont fix
status: open -> pending

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

From report at bugs.python.org  Mon Apr 21 00:57:25 2014
From: report at bugs.python.org (Ezio Melotti)
Date: Sun, 20 Apr 2014 22:57:25 +0000
Subject: [docs] [issue21221] Minor struct_time documentation bug
In-Reply-To: <1397500160.88.0.743491348049.issue21221@psf.upfronthosting.co.za>
Message-ID: <1398034645.8.0.454150353888.issue21221@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Mon Apr 21 01:03:08 2014
From: report at bugs.python.org (Ezio Melotti)
Date: Sun, 20 Apr 2014 23:03:08 +0000
Subject: [docs] [issue21232] Use of '1' instead of 'True' as 'splitlines'
	argument in	difflib documentation
In-Reply-To: <1397542231.28.0.662234584475.issue21232@psf.upfronthosting.co.za>
Message-ID: <1398034987.89.0.0993143752529.issue21232@psf.upfronthosting.co.za>


Ezio Melotti added the comment:

I think that the general consensus is that changing the value of True and False is not supported, and the result of doing it is undefined, so I think Ned request is reasonable.

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

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

From report at bugs.python.org  Mon Apr 21 01:54:15 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 20 Apr 2014 23:54:15 +0000
Subject: [docs] [issue21232] Use of '1' instead of 'True' as 'splitlines'
	argument in	difflib documentation
In-Reply-To: <1397542231.28.0.662234584475.issue21232@psf.upfronthosting.co.za>
Message-ID: <1398038055.09.0.63988960948.issue21232@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

If you want to backport, go ahead.

----------

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

From report at bugs.python.org  Mon Apr 21 02:18:07 2014
From: report at bugs.python.org (Dolda2000)
Date: Mon, 21 Apr 2014 00:18:07 +0000
Subject: [docs] [issue21317] Home page certificate troubles
Message-ID: <1398039487.2.0.185470776483.issue21317@psf.upfronthosting.co.za>


New submission from Dolda2000:

This is misfiled under "Documentation" since it affects the documentation peripherally and I couldn't find any better component to file it under.

To get to the point, the website seems to have certificate troubles for some URLs affecting the older versions of documentation. For instance, at this URL:

    <https://docs.python.org/3.0/c-api/arg.html>

For me at least, it says "400 Bad Request // The SSL certificate error [sic] // nginx". I am also not allowed to access it over HTTP, since that just redirects me to the HTTPS version.

(As an aside, you may also want to fix the typo in the error message while your at it. ;)

----------
assignee: docs at python
components: Documentation
messages: 216928
nosy: Dolda2000, docs at python
priority: normal
severity: normal
status: open
title: Home page certificate troubles
type: crash

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

From report at bugs.python.org  Mon Apr 21 02:20:25 2014
From: report at bugs.python.org (Alex Gaynor)
Date: Mon, 21 Apr 2014 00:20:25 +0000
Subject: [docs] [issue21317] Home page certificate troubles
In-Reply-To: <1398039487.2.0.185470776483.issue21317@psf.upfronthosting.co.za>
Message-ID: <1398039625.81.0.731460435458.issue21317@psf.upfronthosting.co.za>


Alex Gaynor added the comment:

The infra team is looking into this, and I believe it should be fixed by now. (None of the infra people really are on this issue tracker, so I'm closing this, sorry :-/)

----------
nosy: +alex
resolution:  -> fixed
status: open -> closed

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

From charlesaxel.dein at gmail.com  Mon Apr 21 06:32:40 2014
From: charlesaxel.dein at gmail.com (charlesaxel.dein at gmail.com)
Date: Mon, 21 Apr 2014 04:32:40 -0000
Subject: [docs] Add doc examples for DictReader and DictWriter (issue
	20351)
Message-ID: <20140421043240.329.1136@psf.upfronthosting.co.za>


http://bugs.python.org/review/20351/diff/11674/Doc/library/csv.rst
File Doc/library/csv.rst (right):

http://bugs.python.org/review/20351/diff/11674/Doc/library/csv.rst#newcode162
Doc/library/csv.rst:162: A short usage example::
You mean without `A short usage example`? I wanted to mimick the other
examples for `csv.reader`.

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

From report at bugs.python.org  Mon Apr 21 07:17:44 2014
From: report at bugs.python.org (Yury Selivanov)
Date: Mon, 21 Apr 2014 05:17:44 +0000
Subject: [docs] [issue21314] Bizarre help
In-Reply-To: <1397988439.5.0.703056699862.issue21314@psf.upfronthosting.co.za>
Message-ID: <1398057464.96.0.39762854715.issue21314@psf.upfronthosting.co.za>


Changes by Yury Selivanov <yselivanov.ml at gmail.com>:


----------
nosy: +yselivanov

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

From report at bugs.python.org  Tue Apr 22 00:40:07 2014
From: report at bugs.python.org (R. David Murray)
Date: Mon, 21 Apr 2014 22:40:07 +0000
Subject: [docs] [issue21228] Missing enumeration of HTTPResponse Objects
	methods of	urllib.request.urlopen's http.client.HTTPResponse?
In-Reply-To: <1397520483.48.0.224250148615.issue21228@psf.upfronthosting.co.za>
Message-ID: <1398120007.8.0.174967957611.issue21228@psf.upfronthosting.co.za>


R. David Murray added the comment:

That section of the docs is indeed rather confusing.  Probably it just needs to be changed to say "for the methods supported by this object, see HTTPResponse Objects.

I'd like to see the docs reorganized so that the '.. class' declaration in the docs is immediately followed by the class's methods, but that's a much bigger project.

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

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

From report at bugs.python.org  Tue Apr 22 02:14:19 2014
From: report at bugs.python.org (Sam Vilain)
Date: Tue, 22 Apr 2014 00:14:19 +0000
Subject: [docs] [issue18617] TLS and Intermediate Certificates
In-Reply-To: <1375376317.99.0.429350247521.issue18617@psf.upfronthosting.co.za>
Message-ID: <1398125658.05.0.461169474156.issue18617@psf.upfronthosting.co.za>


Sam Vilain added the comment:

Perhaps the simplest thing here is to add a standard verify callback that catches verification errors, and returns the parsed server certificate as an attribute of the raised exception object.  From python, the exception can be caught and then the certificate data info used to fetch the intermediate certificate, and pass it into SSLContext.load_verify_locations().

This would force an extra client connection, but be less insane than trying to fetch and return the certificate from inside the SSL_CTX_set_verify() callback IMHO.

Does that sound workable?  Any hints for a would-be drive-by patcher?

----------
nosy: +samv
versions: +Python 3.5

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

From report at bugs.python.org  Tue Apr 22 05:31:54 2014
From: report at bugs.python.org (Martin Panter)
Date: Tue, 22 Apr 2014 03:31:54 +0000
Subject: [docs] [issue21228] Missing enumeration of HTTPResponse Objects
	methods of	urllib.request.urlopen's http.client.HTTPResponse?
In-Reply-To: <1397520483.48.0.224250148615.issue21228@psf.upfronthosting.co.za>
Message-ID: <1398137514.95.0.700980870513.issue21228@psf.upfronthosting.co.za>


Martin Panter added the comment:

I interpreted it more along the lines of ?. . . returns a http.client.HTTPResponse object [with] the following [additional] methods.? Indeed, a HTTP urlopen() response I just tried does have info(), geturl() and getcode() methods, and I know the info() method is used in the real world.

Also, it would be good to document that the HTTP response?s ?msg? attribute does not actually hold the header, despite the HTTPResponse documentation. Further, the return value of BaseHandler.default_open() is defined to be the same as urlopen(), but when a HTTP error occurs I have found the ?msg? attribute is meant to be the HTTP status text phrase (e.g. ?Not Found?).

Perhaps it would be good to add something like these two points wherever they belong:

* The ?msg? attribute returned by urlopen() does not hold the HTTP header, despite the ?HTTPResponse? documentation
* The ?msg? attribute should be set to the HTTP status text phrase (HTTPResponse.reason)

----------
nosy: +vadmium

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

From r1m1l1d1 at hotmail.com  Thu Apr 17 00:29:03 2014
From: r1m1l1d1 at hotmail.com (renato dias)
Date: Wed, 16 Apr 2014 23:29:03 +0100
Subject: [docs] Bug in tutorial
In-Reply-To: <CAKJDb-Nv5+OAAzN00HvObQBe60CMiAdEgnJLWgFo6m8SPKeWsw@mail.gmail.com>
References: <DUB121-W12701D2088BA7CF39AE0EAD8530@phx.gbl>,
 <CAKJDb-Nv5+OAAzN00HvObQBe60CMiAdEgnJLWgFo6m8SPKeWsw@mail.gmail.com>
Message-ID: <DUB121-W372E338D3643FB25BBC03BD8530@phx.gbl>



> From: zachary.ware+pydocs at gmail.com
> Date: Wed, 16 Apr 2014 14:11:16 -0500
> Subject: Re: [docs] Bug in tutorial
> To: docs at python.org
> CC: r1m1l1d1 at hotmail.com
> 
> On Wed, Apr 16, 2014 at 1:55 PM, renato dias <r1m1l1d1 at hotmail.com> wrote:
> > Hello,
> > First of all I want ask forgiveness because my english is a little bad
> > I am new at python and whyen I was searching for some tutorials, I found one
> > on my language (portuguese). In this tutorial I found a bug in topic 3.1.2,
> > referred to strings. the problem is that when I put this command in python
> > interpreter (palavra[4]) it doesn't work. I think that
> > quotation marks ("") are missing in the word.
> > Attached I send the URL and some images for you better locate the error.
> >
> > URL:   http://turing.com.br/pydoc/2.7/tutorial/introduction.html
> 
> Hi Renato,
> 
> There is no bug here, what you're seeing is because the example you
> are trying is a follow-on from an above example.  In the example
> following "Strings podem ser concatenadas (coladas) com o operador +,
> e repetidas com *:", the name "palavra" is bound to 'AjudaZ'.  The
> example you tried then assumes "palavra" is still bound to that
> string.  If you go through all of the examples on the page in order
> using the same interpreter session, they should all work.
> 
> Hope this helps,
> -- 
> Zach

Hi, sorry for my mistake. I didn't used the same session so it didn't work.
Thanks for help.
 		 	   		  
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140416/489bdbb0/attachment.html>

From vadmium+py at gmail.com  Thu Apr 17 09:03:48 2014
From: vadmium+py at gmail.com (vadmium+py at gmail.com)
Date: Thu, 17 Apr 2014 07:03:48 -0000
Subject: [docs] Add doc examples for DictReader and DictWriter (issue
	20351)
Message-ID: <20140417070348.16788.19238@psf.upfronthosting.co.za>


https://bugs.python.org/review/20351/diff/11072/Doc/library/csv.rst
File Doc/library/csv.rst (right):

https://bugs.python.org/review/20351/diff/11072/Doc/library/csv.rst#newcode161
Doc/library/csv.rst:161: ...     reader = csv.DictReader(csvfile)
I did a quick test of this code on Arch Linux with Python 3.4, and it
worked as advertised. The column names are documented to be taken from
the first row if you omit ?fieldnames?, so where did your first row go?

https://bugs.python.org/review/20351/diff/11072/Doc/library/csv.rst#newcode163
Doc/library/csv.rst:163: ...         print(row['first_name'],
row['last_name'].upper())
I think the upper() call is more of a distraction than an illustration;
I suggest just
    print(row['first_name'], row['last_name'])

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

From charlesaxel.dein at gmail.com  Sat Apr 19 03:49:28 2014
From: charlesaxel.dein at gmail.com (charlesaxel.dein at gmail.com)
Date: Sat, 19 Apr 2014 01:49:28 -0000
Subject: [docs] Add doc examples for DictReader and DictWriter (issue
	20351)
Message-ID: <20140419014928.16789.58309@psf.upfronthosting.co.za>

Reviewers: francismb, vadmium, maatt,


https://bugs.python.org/review/20351/diff/11072/Doc/library/csv.rst
File Doc/library/csv.rst (right):

https://bugs.python.org/review/20351/diff/11072/Doc/library/csv.rst#newcode163
Doc/library/csv.rst:163: ...         print(row['first_name'],
row['last_name'].upper())
Sure! Fixed.



Please review this at https://bugs.python.org/review/20351/

Affected files:
  Doc/library/csv.rst


diff -r 9a98ff4a2290 Doc/library/csv.rst
--- a/Doc/library/csv.rst	Wed Jan 22 05:49:11 2014 -0800
+++ b/Doc/library/csv.rst	Wed Jan 22 10:05:24 2014 -0800
@@ -154,6 +154,17 @@
    *restval* parameter.  Any other optional or keyword arguments are passed to
    the underlying :class:`reader` instance.
 
+   A short usage example::
+
+       >>> import csv
+       >>> with open('names.csv') as csvfile:
+       ...     reader = csv.DictReader(csvfile)
+       ...     for row in reader:
+       ...         print(row['first_name'], row['last_name'].upper())
+       Baked BEANS
+       Lovely SPAM
+       Wonderful SPAM
+
 
 .. class:: DictWriter(csvfile, fieldnames, restval='', extrasaction='raise', dialect='excel', *args, **kwds)
 
@@ -173,6 +184,19 @@
    are not ordered, there is not enough information available to deduce the order
    in which the row should be written to the *csvfile*.
 
+   A short usage example::
+
+       import csv
+
+       with open('names.csv', 'w') as csvfile:
+           fieldnames = ['first_name', 'last_name']
+           writer = csv.DictWriter(csvfile, fieldnames=fieldnames)
+
+           writer.writeheader()
+           writer.writerow({'first_name': 'Baked', 'last_name': 'Beans'})
+           writer.writerow({'first_name': 'Lovely', 'last_name': 'Spam'})
+           writer.writerow({'first_name': 'Wonderful', 'last_name': 'Spam'})
+
 
 .. class:: Dialect
 



From jgehrs at gmail.com  Sun Apr 20 10:52:10 2014
From: jgehrs at gmail.com (Johannes Gehrs)
Date: Sun, 20 Apr 2014 10:52:10 +0200
Subject: [docs] Python 2 docs link to Python 3.3 as being the current stable
 version and 3.4 being the current dev release (EOM)
Message-ID: <CAMQRiAqQ46uhcQV7grsjFqdBn+dp-Ed5hX-ceH92yU4LgG5Z9A@mail.gmail.com>


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140420/1f6e7c65/attachment.html>

From report at bugs.python.org  Tue Apr 22 21:18:51 2014
From: report at bugs.python.org (Jayanth Raman)
Date: Tue, 22 Apr 2014 19:18:51 +0000
Subject: [docs] [issue21330] Typo in "Unicode HOWTO" documentation
Message-ID: <1398194331.3.0.966698777318.issue21330@psf.upfronthosting.co.za>


New submission from Jayanth Raman:

It should be "128 such characters" in the following sentence:

For example, you can?t fit both the accented characters used in Western Europe and the Cyrillic alphabet used for Russian into the 128-255 range because there are more than 127 such characters.

----------
assignee: docs at python
components: Documentation
messages: 217016
nosy: docs at python, jayanth
priority: normal
severity: normal
status: open
title: Typo in "Unicode HOWTO" documentation
type: behavior
versions: Python 2.7, Python 3.2, Python 3.3, Python 3.4, Python 3.5

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

From report at bugs.python.org  Wed Apr 23 03:56:16 2014
From: report at bugs.python.org (Benjamin Peterson)
Date: Wed, 23 Apr 2014 01:56:16 +0000
Subject: [docs] [issue21330] Typo in "Unicode HOWTO" documentation
In-Reply-To: <1398194331.3.0.966698777318.issue21330@psf.upfronthosting.co.za>
Message-ID: <1398218176.6.0.439489562077.issue21330@psf.upfronthosting.co.za>


Benjamin Peterson added the comment:

http://hg.python.org/cpython/rev/b428b803f71f
http://hg.python.org/cpython/rev/660d53bfb332
http://hg.python.org/cpython/rev/ae4a9000e925

----------
nosy: +benjamin.peterson
resolution:  -> fixed
status: open -> closed

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

From report at bugs.python.org  Wed Apr 23 07:57:14 2014
From: report at bugs.python.org (Stefan Schwarzer)
Date: Wed, 23 Apr 2014 05:57:14 +0000
Subject: [docs] [issue21333] Document recommended exception for objects
	that	shouldn't be pickled
Message-ID: <1398232634.34.0.847410110548.issue21333@psf.upfronthosting.co.za>


New submission from Stefan Schwarzer:

I recently was confused whether to raise a `PicklingError` or `TypeError` in `__getstate__` if objects of my class can't and shouldn't be pickled. [1]

Terry Reedy advised I should use `TypeError`. [2]

I wonder if the `pickle` module documention should explicitly recommend using `TypeError` if a class wants to say that its objects can't be pickled. What do you think?

[1] https://mail.python.org/pipermail/python-list/2014-April/670987.html
[2] https://mail.python.org/pipermail/python-list/2014-April/671002.html

----------
assignee: docs at python
components: Documentation
messages: 217054
nosy: docs at python, sschwarzer
priority: normal
severity: normal
status: open
title: Document recommended exception for objects that shouldn't be pickled
type: enhancement
versions: Python 3.5

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

From report at bugs.python.org  Wed Apr 23 15:24:41 2014
From: report at bugs.python.org (Berker Peksag)
Date: Wed, 23 Apr 2014 13:24:41 +0000
Subject: [docs] [issue21333] Document recommended exception for objects
	that	shouldn't be pickled
In-Reply-To: <1398232634.34.0.847410110548.issue21333@psf.upfronthosting.co.za>
Message-ID: <1398259481.97.0.210498510472.issue21333@psf.upfronthosting.co.za>


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


----------
nosy: +alexandre.vassalotti, pitrou

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

From report at bugs.python.org  Wed Apr 23 18:32:04 2014
From: report at bugs.python.org (Zachary Ware)
Date: Wed, 23 Apr 2014 16:32:04 +0000
Subject: [docs] [issue17386] Bring Doc/make.bat as close to Doc/Makefile as
	possible
In-Reply-To: <1362781994.31.0.121984055749.issue17386@psf.upfronthosting.co.za>
Message-ID: <1398270723.88.0.0669809239646.issue17386@psf.upfronthosting.co.za>


Zachary Ware added the comment:

Having looked at this again, the current patch is just far bigger than it needs to be and tries to do too much, not to mention being rather out of date now.

So, here's a much less ambitious, much simpler patch with many fewer ways it can go wrong (but also not quite as close a match to using Makefile).  Instead of only allowing specific targets, the script now only specifies non-Sphinx-builder targets (like clean, check, help, htmlview, and serve) and assumes that any first argument it doesn't recognize is supposed to be a Sphinx builder.  "htmlhelp" is still special-cased in the "build" target.  Not listing all the Sphinx builder targets explicitly means that builders like "dirhtml", "pickle", or "json", or any builders added in future Sphinx versions will just work without our having to do anything for them.

----------
assignee: docs at python -> zach.ware
stage: commit review -> patch review
versions: +Python 3.5
Added file: http://bugs.python.org/file35010/issue17386.diff

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

From report at bugs.python.org  Thu Apr 24 05:38:56 2014
From: report at bugs.python.org (James Brewer)
Date: Thu, 24 Apr 2014 03:38:56 +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: <1398310735.63.0.346967311527.issue16827@psf.upfronthosting.co.za>


James Brewer added the comment:

It seems like this issue lost traction, so I decided to go ahead and apply Eric's feedback. I've attached the relevant patch.

With that said, I agree with Senthil that sections 2.2.4 and 2.2.5 would be better off between sections 13.1 and 13.2

----------
nosy: +brwr
Added file: http://bugs.python.org/file35015/tutorial-docs-update.patch

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

From mark.h.dewey at gmail.com  Thu Apr 24 07:12:55 2014
From: mark.h.dewey at gmail.com (Mark Hamilton Dewey)
Date: Wed, 23 Apr 2014 23:12:55 -0600
Subject: [docs] Python 3.4 documentation issue tkinter.text
Message-ID: <53589D57.5070509@gmail.com>

Hello,

You may already be aware of what I'm about to tell you, but I thought 
I'd report it, just in case.

I was searching the documentation for methods I can use with Tkinter's 
ScrolledText widget:
https://docs.python.org/3.4/library/tkinter.scrolledtext.html

but it referred to the Text widget that it inherits from for the vast 
majority of its methods. That's not a problem. However, the Text widget 
doesn't appear to be documented in Python 3.4. It doesn't show up in the 
search or anything. Even looking at the source code where 
scrolledtext.py is on my computer, it's difficult to find where the code 
for the Text widget is from there, and how it's able to be imported.

Anyway, I'm not meaning to ask a question, per se. I'm just meaning to 
report that this doesn't appear to be documented, and if it is, the 
documentation on the Text widget isn't easy to find for this version of 
Python.

Thanks!

Mark

From berker.peksag at gmail.com  Thu Apr 24 14:55:56 2014
From: berker.peksag at gmail.com (berker.peksag at gmail.com)
Date: Thu, 24 Apr 2014 12:55:56 -0000
Subject: [docs] Remove the relatively advanced content from section 2 in
 tutorial (issue 16827)
Message-ID: <20140424125556.12676.89034@psf.upfronthosting.co.za>


http://bugs.python.org/review/16827/diff/11699/Doc/tutorial/appendix.rst
File Doc/tutorial/appendix.rst (right):

http://bugs.python.org/review/16827/diff/11699/Doc/tutorial/appendix.rst#newcode43
Doc/tutorial/appendix.rst:43: #! /usr/bin/env python3.5
Minor nit: I would remove the whitespace after the "#!" part. See
https://en.wikipedia.org/wiki/Shebang_%28Unix%29 for example usages.

http://bugs.python.org/review/16827/diff/11699/Doc/tutorial/appendix.rst#newcode53
Doc/tutorial/appendix.rst:53: :program:`chmod` command::
Another nit: You could use a ``.. code-block:: bash`` directive to
highlight the examples.

http://bugs.python.org/review/16827/diff/11699/Doc/tutorial/appendix.rst#newcode92
Doc/tutorial/appendix.rst:92: exec(open(filename).read())
It would be good to use more Pythonic code here:

    with open(filename) as fobj:
        startup_file = fobj.read()
    exec(startup_file)

http://bugs.python.org/review/16827/diff/11699/Doc/tutorial/appendix.rst#newcode102
Doc/tutorial/appendix.rst:102: of your user site-packages directory. 
Start Python and run this code:
code: -> code::

http://bugs.python.org/review/16827/diff/11699/Doc/tutorial/appendix.rst#newcode106
Doc/tutorial/appendix.rst:106:
'/home/user/.local/lib/python3.2/site-packages'
python3.2 -> python3.5

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

From report at bugs.python.org  Thu Apr 24 21:08:42 2014
From: report at bugs.python.org (akira)
Date: Thu, 24 Apr 2014 19:08:42 +0000
Subject: [docs] [issue21347] Don't use a list argument together with
	shell=True in	subprocess' docs
Message-ID: <1398366522.65.0.954174735085.issue21347@psf.upfronthosting.co.za>


New submission from akira:

*Popen(["something"], shell=True)* works but it is similar to
*Popen(["something", "arg"], shell=True)* that passes "arg" to /bin/sh on POSIX systems instead of "something".

It is best to always use a string if `shell=True` is necessary.

It is a common confusion #20344, msg98732, #7839

http://stackoverflow.com/questions/21029154/understanding-python-subprocess-check-outputs-first-argument-and-shell-true
http://stackoverflow.com/questions/20787712/start-openoffice-process-with-python-to-use-with-pyuno-using-subprocess
http://stackoverflow.com/questions/17880847/python-subprocess-error-in-using-cp
http://stackoverflow.com/questions/17226912/why-does-simple-echo-in-subprocess-not-working
http://stackoverflow.com/questions/15109665/subprocess-call-using-string-vs-using-list
http://stackoverflow.com/questions/20128114/pythons-subprocess-does-not-interpret-as-expected-on-cygwin
http://stackoverflow.com/questions/16840427/python-on-linux-subprocess-popen-works-weird-with-shell-true
...

----------
assignee: docs at python
components: Documentation
files: docs-subprocess-dont_use_list_with_shell_true.patch
keywords: patch
messages: 217136
nosy: akira, docs at python
priority: normal
severity: normal
status: open
title: Don't use a list argument together with shell=True in subprocess' docs
type: behavior
versions: Python 3.5
Added file: http://bugs.python.org/file35026/docs-subprocess-dont_use_list_with_shell_true.patch

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

From zachary.ware at gmail.com  Thu Apr 24 21:37:06 2014
From: zachary.ware at gmail.com (zachary.ware at gmail.com)
Date: Thu, 24 Apr 2014 19:37:06 -0000
Subject: [docs] Bring Doc/using/windows up to date (issue 20265)
Message-ID: <20140424193706.12676.46563@psf.upfronthosting.co.za>

I'm so sorry, I had a review half-finished a month ago, but I never got
it posted.


http://bugs.python.org/review/20265/diff/11414/Doc/faq/windows.rst
File Doc/faq/windows.rst (right):

http://bugs.python.org/review/20265/diff/11414/Doc/faq/windows.rst#newcode46
Doc/faq/windows.rst:46: Command Prompt followed by (Admin).  You should
be able to recognize when
This isn't good advice, not all users will be able to use the Admin
prompt (or necessarily have it available; I'm not sure about that
though).  I've confirmed that the administrative prompt is not an
absolute necessity for using Python on Windows 8+.

http://bugs.python.org/review/20265/diff/11414/Doc/faq/windows.rst#newcode75
Doc/faq/windows.rst:75: Python 3.4.0 (v3.4.0:bd8afb90ebf2, Sep 29 2012,
10:55:48) [MSC v.1600 32 bit (Intel)] on win32
Let's not lie about the revision id :). v3.4.0 is 04f714765c13, with a
date and time of Mar 16 2014, 19:24:06.  Or we can replace the whole
revision id with "default" (a current date would be good, though).

http://bugs.python.org/review/20265/diff/11414/Doc/faq/windows.rst#newcode131
Doc/faq/windows.rst:131: like ``C:\Python33``.  Otherwise you will be
reduced to a search of your whole
s/33/34/

http://bugs.python.org/review/20265/diff/11414/Doc/faq/windows.rst#newcode134
Doc/faq/windows.rst:134: installed in the ``C:\Python33`` directory (the
default at the time of writing),
s/33/34/

http://bugs.python.org/review/20265/diff/11414/Doc/faq/windows.rst#newcode137
Doc/faq/windows.rst:137: c:\Python33\python
s/33/34/

http://bugs.python.org/review/20265/diff/11414/Doc/faq/windows.rst#newcode213
Doc/faq/windows.rst:213: number such as "33" for Python 3.4.
"33" should be "34"

http://bugs.python.org/review/20265/diff/11414/Doc/using/windows.rst
File Doc/using/windows.rst (right):

http://bugs.python.org/review/20265/diff/11414/Doc/using/windows.rst#newcode85
Doc/using/windows.rst:85: * Select Python through File Explorer
Is "File Explorer" what "Windows Explorer" is called in Win8?  Also, how
does this differ from "Find the Python directory and double click
python"?

http://bugs.python.org/review/20265/diff/11414/Doc/using/windows.rst#newcode113
Doc/using/windows.rst:113: installer to choose it.  The alternative is
manually modifying the :envvar:`%PATH%`.  See the
Long line.

http://bugs.python.org/review/20265/diff/11414/Doc/using/windows.rst#newcode188
Doc/using/windows.rst:188: administrative rights):
Nix this parenthetical

http://bugs.python.org/review/20265/diff/11414/Doc/using/windows.rst#newcode190
Doc/using/windows.rst:190: #. Launch a command prompt with administrator
rights.
s/administrator/administrative/

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

From report at bugs.python.org  Fri Apr 25 05:58:20 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 25 Apr 2014 03:58:20 +0000
Subject: [docs] [issue15569] Doc doc: incorrect description of some roles
	as	format-only
In-Reply-To: <1344302647.18.0.307450045197.issue15569@psf.upfronthosting.co.za>
Message-ID: <1398398299.97.0.283120658862.issue15569@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

There are no versions for the devguide. There is another misplaced role:
:
option
    A command-line option of Python. The leading hyphen(s) must be included. If a matching cmdoption directive exists, it is linked to. For options of other programs or scripts, use simple ``code`` markup.

I think "The following role does possibly create a cross-reference, but does not refer to objects:" should be changed to something like "The following roles do not refer to module objects, but possibly create cross-references or internal links:". Move the three misplaced roles here, along with token and term.

----------
nosy: +terry.reedy
versions:  -Python 2.7, Python 3.2, Python 3.3, Python 3.4

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

From report at bugs.python.org  Fri Apr 25 06:16:56 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 25 Apr 2014 04:16:56 +0000
Subject: [docs] [issue16574] clarify policy on updates to final peps
In-Reply-To: <1354150615.68.0.531483999972.issue16574@psf.upfronthosting.co.za>
Message-ID: <1398399416.69.0.492010423581.issue16574@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

With respect to editing final peps, I think this issue should be closed. The current PEP 1 statement accurately describes what we do, which is that in general we do not edit final peps. Moreover, Chris has not submitted a patch and I doubt anyone else knows what he thought he might add or where,

The only related question I have is in relation to Martin's point 3.
https://docs.python.org/devguide/documenting.html#id3
has the following:

pep
    A reference to a Python Enhancement Proposal. This generates appropriate index entries. The text ?PEP number? is generated; in the HTML output, this text is a hyperlink to an online copy of the specified PEP.

Should we add something like "Such links should not be a substitute for properly documenting the language in the manuals."

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

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

From kathleen at kweaver.org  Fri Apr 25 18:12:49 2014
From: kathleen at kweaver.org (Kathleen Weaver)
Date: Fri, 25 Apr 2014 16:12:49 +0000
Subject: [docs] Bring Doc/using/windows up to date (issue 20265)
In-Reply-To: <20140424193706.12676.46563@psf.upfronthosting.co.za>
References: <20140424193706.12676.46563@psf.upfronthosting.co.za>
Message-ID: <8e10464c6f3b463bbbd53611ba27c947@BLUPR04MB419.namprd04.prod.outlook.com>

No problem -- I just was holding off on starting anything new until we got these bugs killed.  I'll work on it over the weekend.

-----Original Message-----
From: zachary.ware at gmail.com [mailto:zachary.ware at gmail.com] 
Sent: Thursday, April 24, 2014 2:37 PM
To: merwok at netwok.org; Kathleen Weaver; martin at v.loewis.de
Cc: ncoghlan at gmail.com; ezio.melotti at gmail.com; merwok at netwok.org; docs at python.org; breamoreboy at yahoo.co.uk; anikom15 at gmail.com; devnull at psf.upfronthosting.co.za; Kathleen Weaver
Subject: Re: Bring Doc/using/windows up to date (issue 20265)

I'm so sorry, I had a review half-finished a month ago, but I never got it posted.


http://bugs.python.org/review/20265/diff/11414/Doc/faq/windows.rst
File Doc/faq/windows.rst (right):

http://bugs.python.org/review/20265/diff/11414/Doc/faq/windows.rst#newcode46
Doc/faq/windows.rst:46: Command Prompt followed by (Admin).  You should be able to recognize when This isn't good advice, not all users will be able to use the Admin prompt (or necessarily have it available; I'm not sure about that though).  I've confirmed that the administrative prompt is not an absolute necessity for using Python on Windows 8+.

http://bugs.python.org/review/20265/diff/11414/Doc/faq/windows.rst#newcode75
Doc/faq/windows.rst:75: Python 3.4.0 (v3.4.0:bd8afb90ebf2, Sep 29 2012,
10:55:48) [MSC v.1600 32 bit (Intel)] on win32 Let's not lie about the revision id :). v3.4.0 is 04f714765c13, with a date and time of Mar 16 2014, 19:24:06.  Or we can replace the whole revision id with "default" (a current date would be good, though).

http://bugs.python.org/review/20265/diff/11414/Doc/faq/windows.rst#newcode131
Doc/faq/windows.rst:131: like ``C:\Python33``.  Otherwise you will be reduced to a search of your whole s/33/34/

http://bugs.python.org/review/20265/diff/11414/Doc/faq/windows.rst#newcode134
Doc/faq/windows.rst:134: installed in the ``C:\Python33`` directory (the default at the time of writing), s/33/34/

http://bugs.python.org/review/20265/diff/11414/Doc/faq/windows.rst#newcode137
Doc/faq/windows.rst:137: c:\Python33\python s/33/34/

http://bugs.python.org/review/20265/diff/11414/Doc/faq/windows.rst#newcode213
Doc/faq/windows.rst:213: number such as "33" for Python 3.4.
"33" should be "34"

http://bugs.python.org/review/20265/diff/11414/Doc/using/windows.rst
File Doc/using/windows.rst (right):

http://bugs.python.org/review/20265/diff/11414/Doc/using/windows.rst#newcode85
Doc/using/windows.rst:85: * Select Python through File Explorer Is "File Explorer" what "Windows Explorer" is called in Win8?  Also, how does this differ from "Find the Python directory and double click python"?

http://bugs.python.org/review/20265/diff/11414/Doc/using/windows.rst#newcode113
Doc/using/windows.rst:113: installer to choose it.  The alternative is manually modifying the :envvar:`%PATH%`.  See the Long line.

http://bugs.python.org/review/20265/diff/11414/Doc/using/windows.rst#newcode188
Doc/using/windows.rst:188: administrative rights):
Nix this parenthetical

http://bugs.python.org/review/20265/diff/11414/Doc/using/windows.rst#newcode190
Doc/using/windows.rst:190: #. Launch a command prompt with administrator rights.
s/administrator/administrative/

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

From report at bugs.python.org  Fri Apr 25 21:22:50 2014
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 25 Apr 2014 19:22:50 +0000
Subject: [docs] [issue21347] Don't use a list argument together with
	shell=True in	subprocess' docs
In-Reply-To: <1398366522.65.0.954174735085.issue21347@psf.upfronthosting.co.za>
Message-ID: <1398453770.32.0.222445170403.issue21347@psf.upfronthosting.co.za>


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


----------
nosy: +eric.araujo
versions: +Python 2.7, Python 3.4

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

From report at bugs.python.org  Fri Apr 25 22:27:41 2014
From: report at bugs.python.org (bob gailer)
Date: Fri, 25 Apr 2014 20:27:41 +0000
Subject: [docs] [issue21352] improve indexing
Message-ID: <1398457661.12.0.679738685491.issue21352@psf.upfronthosting.co.za>


New submission from bob gailer:

Inconsistencies / confusion with documentation Index Tab. Example (line numbers added for comments that follow):

1 max
2   built-in function
3 max  (datetime.date attribute)
4   (datetime.datetime attribute)
5   (datetime.time attribute)
6 max() built-in function
7   (decimal.Context method)
8   (decimal.Decimal method)
9   (in module audioloop)

The following all lead to confusion and frustration:
Having 3 rows (1, 3, 6)that begin with max. 
Having an entry (1) that does nothing when double-clicked.
double-clicking (2) takes us to a reference rather than a definition.

RECOMMENDATION:
change to:
max() built-in function
  (sequence operation)
  (decimal.Context method)
  (decimal.Decimal method)
max
  (datetime.date attribute)
  (datetime.datetime attribute)
  (datetime.time attribute)

where double-clicking the first line goes to the max() definition
in 2. Built-in Functions


These comments apply, with a number of variations, to most built-in functions index entries.

----------
assignee: docs at python
components: Documentation
messages: 217170
nosy: bgailer, docs at python
priority: normal
severity: normal
status: open
title: improve indexing
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/issue21352>
_______________________________________

From report at bugs.python.org  Fri Apr 25 22:34:48 2014
From: report at bugs.python.org (Zachary Ware)
Date: Fri, 25 Apr 2014 20:34:48 +0000
Subject: [docs] [issue21352] improve indexing
In-Reply-To: <1398457661.12.0.679738685491.issue21352@psf.upfronthosting.co.za>
Message-ID: <1398458088.94.0.232736492864.issue21352@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Apr 26 00:22:28 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 25 Apr 2014 22:22:28 +0000
Subject: [docs] [issue21314] Document '/' in signatures
In-Reply-To: <1397988439.5.0.703056699862.issue21314@psf.upfronthosting.co.za>
Message-ID: <1398464548.76.0.873755333701.issue21314@psf.upfronthosting.co.za>


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


----------
status: open -> 
title: Bizarre help -> Document '/' in signatures

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

From report at bugs.python.org  Sat Apr 26 02:09:44 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 26 Apr 2014 00:09:44 +0000
Subject: [docs] [issue8387] use universal newline mode in csv module examples
In-Reply-To: <1271193086.18.0.201846291594.issue8387@psf.upfronthosting.co.za>
Message-ID: <1398470984.0.0.67265055859.issue8387@psf.upfronthosting.co.za>


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


----------
versions:  -Python 3.1, Python 3.2

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

From report at bugs.python.org  Sat Apr 26 05:02:54 2014
From: report at bugs.python.org (akira)
Date: Sat, 26 Apr 2014 03:02:54 +0000
Subject: [docs] [issue21353] document Popen.args attribute
Message-ID: <1398481373.88.0.978177813548.issue21353@psf.upfronthosting.co.za>


New submission from akira:

It is convenient to have Popen.args available. Especially when dealing 
with multiple processes e.g., to log failures mentioning the command
that was used to spawn the child process.

subprocess module itself uses it while raising CalledProcessError or TimeoutExpired exceptions.

The documentation patch is attached.

----------
assignee: docs at python
components: Documentation
files: docs-subprocess-document_Popen_args_attribute.patch
keywords: patch
messages: 217183
nosy: akira, docs at python
priority: normal
severity: normal
status: open
title: document Popen.args attribute
type: enhancement
versions: Python 3.3, Python 3.4, Python 3.5
Added file: http://bugs.python.org/file35042/docs-subprocess-document_Popen_args_attribute.patch

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

From report at bugs.python.org  Sat Apr 26 15:08:17 2014
From: report at bugs.python.org (Antoine Pitrou)
Date: Sat, 26 Apr 2014 13:08:17 +0000
Subject: [docs] [issue21352] improve documentation indexing
In-Reply-To: <1398457661.12.0.679738685491.issue21352@psf.upfronthosting.co.za>
Message-ID: <1398517697.47.0.577973237158.issue21352@psf.upfronthosting.co.za>


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


----------
title: improve indexing -> improve documentation indexing

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

From report at bugs.python.org  Sat Apr 26 22:38:59 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 26 Apr 2014 20:38:59 +0000
Subject: [docs] [issue21358] Augmented assignment doc: clarify 'only
	evaluated once'
Message-ID: <1398544739.49.0.840910165962.issue21358@psf.upfronthosting.co.za>


New submission from Terry J. Reedy:

https://docs.python.org/3/reference/simple_stmts.html#augmented-assignment-statements
"An augmented assignment expression like x += 1 can be rewritten as x = x + 1 to achieve a similar, but not exactly equal effect. In the augmented version, x is only evaluated once."

As discussed and demonstrated as part of #21101 (see msg 215560) and following, this is not exactly true in current CPython. If the expression 'x' is 'y[k]', then the subscription is performed twice, once to get and once to set. Both y and k are still evaluated just once.

def ob():
   print('ob fetched')
   return d

def key():
   print('key called')
   return 0

d = [[]]
ob()[key()] += [1]
print(d)

# prints
ob fetched
key called
[[1]]

I suggest changing "x is only evaluated once." to something like

"x is usually only evaluated once. However, if x has the form y[k], y and k are evaluated once but the subscription may be done twice, once to get and once to set."

I intentionally said 'subscription may be' rather than 'subscription is' because implementations should remain free to do the subscription (and the whole expression x) just once -- by directly replacing the reference to the old value in the internals of the mapping structure with a reference to the new value.

#16701 discusses possible ambiguity in the next sentence, about 'in place'.

----------
assignee: docs at python
components: Documentation
messages: 217212
nosy: docs at python, terry.reedy
priority: normal
severity: normal
stage: needs patch
status: open
title: Augmented assignment doc: clarify 'only evaluated once'
type: enhancement
versions: Python 2.7, Python 3.4, Python 3.5

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

From report at bugs.python.org  Sat Apr 26 22:41:43 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 26 Apr 2014 20:41:43 +0000
Subject: [docs] [issue16701] Docs missing the behavior of += (in-place add)
	for lists.
In-Reply-To: <1355690474.0.0.76209480062.issue16701@psf.upfronthosting.co.za>
Message-ID: <1398544903.25.0.123542153626.issue16701@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

Augmented assignment confuses enough people that I think we can improve the doc. In #21358 I suggest an augmented version of the previous claim, about evaluation just once. I think something here is needed perhaps even more. I have not decided what just yet.

----------
nosy: +terry.reedy
versions: +Python 3.5 -Python 2.6, Python 3.2, Python 3.3

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

From report at bugs.python.org  Sat Apr 26 22:51:08 2014
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 26 Apr 2014 20:51:08 +0000
Subject: [docs] [issue17145] memoryview(array.array)
In-Reply-To: <1360170754.31.0.614797074916.issue17145@psf.upfronthosting.co.za>
Message-ID: <3gGPY74lRsz7Ljn@mail.python.org>


Roundup Robot added the comment:

New changeset 0a2ac61729d2 by Stefan Krah in branch '2.7':
Issue #17145:  Document array.array buffer interface limitations.
http://hg.python.org/cpython/rev/0a2ac61729d2

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

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

From report at bugs.python.org  Sat Apr 26 22:53:53 2014
From: report at bugs.python.org (Stefan Krah)
Date: Sat, 26 Apr 2014 20:53:53 +0000
Subject: [docs] [issue17145] memoryview(array.array)
In-Reply-To: <1360170754.31.0.614797074916.issue17145@psf.upfronthosting.co.za>
Message-ID: <1398545633.02.0.170849703937.issue17145@psf.upfronthosting.co.za>


Stefan Krah added the comment:

I pushed a minimal patch that focuses on the array.array issue. For
broader changes, I suggest to use #14198 (though it is unlikely
tha anyone will work on it).

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

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

From report at bugs.python.org  Sat Apr 26 23:03:57 2014
From: report at bugs.python.org (=?utf-8?q?Martin_v=2E_L=C3=B6wis?=)
Date: Sat, 26 Apr 2014 21:03:57 +0000
Subject: [docs] [issue21358] Augmented assignment doc: clarify 'only
	evaluated once'
In-Reply-To: <1398544739.49.0.840910165962.issue21358@psf.upfronthosting.co.za>
Message-ID: <1398546237.47.0.497573586139.issue21358@psf.upfronthosting.co.za>


Martin v. L?wis added the comment:

This is not limited to dictionaries. Augmented assignment *always* involves a read operation and a write operation. 
So Antoine's remark in msg215573 is more general;

a.x += 1

has a get and a set, and even

x += 1

has a get and a set.

I still agree that the original statement is confusing. It (implicitly) claims that 

  x = x + 1

evaluates x twice, which it does not. Instead, x is only *evaluated* once, and then written to. Only if x has subexpressions, they get evaluated only once ("evaluation" being the thing that produces a "value").

----------
nosy: +loewis

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

From report at bugs.python.org  Sun Apr 27 01:05:28 2014
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 26 Apr 2014 23:05:28 +0000
Subject: [docs] [issue18243] mktime_tz documentation out-of-date
In-Reply-To: <1371482642.16.0.49381484414.issue18243@psf.upfronthosting.co.za>
Message-ID: <3gGSX71tctz7LjS@mail.python.org>


Roundup Robot added the comment:

New changeset d24f1fb256a3 by R David Murray in branch '3.4':
#18243: Remove obsolete cautionary note from email mktime_tz docs.
http://hg.python.org/cpython/rev/d24f1fb256a3

New changeset 462470859e57 by R David Murray in branch 'default':
Merge: #18243: Remove obsolete cautionary note from email mktime_tz docs.
http://hg.python.org/cpython/rev/462470859e57

New changeset d1a641ecbe33 by R David Murray in branch '2.7':
#18243: Remove obsolete cautionary note from email mktime_tz docs.
http://hg.python.org/cpython/rev/d1a641ecbe33

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

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

From report at bugs.python.org  Sun Apr 27 01:06:45 2014
From: report at bugs.python.org (R. David Murray)
Date: Sat, 26 Apr 2014 23:06:45 +0000
Subject: [docs] [issue18243] mktime_tz documentation out-of-date
In-Reply-To: <1371482642.16.0.49381484414.issue18243@psf.upfronthosting.co.za>
Message-ID: <1398553605.38.0.0100066878947.issue18243@psf.upfronthosting.co.za>


R. David Murray added the comment:

Thanks, Akira.

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

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

From report at bugs.python.org  Sun Apr 27 11:30:49 2014
From: report at bugs.python.org (akira)
Date: Sun, 27 Apr 2014 09:30:49 +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: <1398591049.4.0.0916886472257.issue19940@psf.upfronthosting.co.za>


akira added the comment:

Here's a new patch with a simplified ssl.cert_time_to_seconds()
implementation that brings strptime() back.

The behaviour is changed:

- accept both %e and %d strftime formats for days as strptime-based implementation did before
- return an integer instead of a float (input date has not fractions of a second)

I've added more tests.

Please, review.

----------
Added file: http://bugs.python.org/file35050/ssl_cert_time_to_seconds-462470859e57.patch

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

From report at bugs.python.org  Sun Apr 27 11:49:47 2014
From: report at bugs.python.org (akira)
Date: Sun, 27 Apr 2014 09:49:47 +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: <1398592187.37.0.890023946035.issue19940@psf.upfronthosting.co.za>


akira added the comment:

Replace IndexError with ValueError in the patch because tuple.index raises ValueError.

----------
Added file: http://bugs.python.org/file35051/ssl_cert_time_to_seconds-ps5.patch

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

From report at bugs.python.org  Sun Apr 27 11:59:39 2014
From: report at bugs.python.org (Claudiu.Popa)
Date: Sun, 27 Apr 2014 09:59:39 +0000
Subject: [docs] [issue19950] Document that unittest.TestCase.__init__ is
	called once	per test
In-Reply-To: <1386714858.72.0.878231586551.issue19950@psf.upfronthosting.co.za>
Message-ID: <1398592779.16.0.305572564568.issue19950@psf.upfronthosting.co.za>


Claudiu.Popa added the comment:

In Python 3 docs there is a hint in the documentation for `loadTestsFromModule`:

"This method searches module for classes derived from TestCase and creates an instance of the class for each test method defined for the class."

The phrase with a fixture per test from Python 2 docs is gone though. It would be nice if the same explanation from loadTestsFromModule could be applied to TestCase documentation.

----------

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

From report at bugs.python.org  Sun Apr 27 17:38:18 2014
From: report at bugs.python.org (Paul Sokolovsky)
Date: Sun, 27 Apr 2014 15:38:18 +0000
Subject: [docs] [issue21365] asyncio.Task reference misses the most
	important fact	about it,
	related info spread around intros and example commentary instead
Message-ID: <1398613098.75.0.265677522517.issue21365@psf.upfronthosting.co.za>


New submission from Paul Sokolovsky:

It caused me a big surprise that asyncio.Task object automatically schedules itself in the main loop for execution upon creation (i.e. in constructor).

Nowhere in the main reference part of section "18.5.2.4. Task" (https://docs.python.org/3.5/library/asyncio-task.html#task) does it mention that fact. Vice versa, it explicitly says that Task is merely "A coroutine object wrapped in a Future.", which surely sets grounds for surprise when finding that Task is not just coroutine wrapped in Future, but exhibits extra behavior unexpected of plain Future.

Docs cursorily mention this property of Task outside main reference section for it. Specifically:

1) "18.5.2.1. Coroutines", end of intro section:

"In the case of a coroutine object, there are two basic ways to start it running: call yield from coroutine from another coroutine (assuming the other coroutine is already running!), or convert it to a Task."

I would argue that this is way too cursorily and doesn't put strong enough emphasis on the property of self-scheduling, to catch attention of novice or casual reader. For example, my entailments after reading the passage above are: "... or convert it to a Task, to schedule it in a loop [explicitly], because a coroutine can't be scheduled in a loop directly, but Task can be".

2) Very end of subsection "18.5.2.4.1. Example: Parallel execution of tasks", a short line squeezed between colored example block and new section heading - a place where some user will miss it outright: "A task is automatically scheduled for execution when it is created."



Based on case study above, I would like to propose:

1). In section "18.5.2.4. Task", in class description, make unmissable fact that instantiating an object makes it scheduled. For example, append after: "A coroutine object wrapped in a Future. Subclass of Future." following: "Instantiating object of this class automatically schedules it to be run in an event loop specified by 'loop' parameter (or default event loop)."

2) Ideally, update 2 excerpts above to convey more explicit information, and be more visible (for case 2, for example, move it before the example, not after).

----------
assignee: docs at python
components: Documentation
messages: 217272
nosy: docs at python, pfalcon
priority: normal
severity: normal
status: open
title: asyncio.Task reference misses the most important fact about it, related info spread around intros and example commentary instead
type: enhancement
versions: Python 3.5

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

From report at bugs.python.org  Sun Apr 27 17:44:45 2014
From: report at bugs.python.org (Paul Sokolovsky)
Date: Sun, 27 Apr 2014 15:44:45 +0000
Subject: [docs] [issue21365] asyncio.Task reference misses the most
	important fact	about it,
	related info spread around intros and example commentary instead
In-Reply-To: <1398613098.75.0.265677522517.issue21365@psf.upfronthosting.co.za>
Message-ID: <1398613485.44.0.527820272992.issue21365@psf.upfronthosting.co.za>


Paul Sokolovsky added the comment:

Based on discussion https://groups.google.com/forum/#!topic/python-tulip/zfMQIUcIR-0 . That discussion actually questions the grounds of such Task behavior, and points it as a violation of "Explicit is better than implicit" principle, and as inconsistent behavior wrt to similar objects in Python stdlib (threads, processes, etc.)

This ticket however assumes that there're very good reasons for such behavior, and/or it just should be accepted as API idiosyncrasy which is late to fix, and just tries to make sure that docs are not culprit for mismatching user expectations.

----------

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

From report at bugs.python.org  Sun Apr 27 18:12:19 2014
From: report at bugs.python.org (Jon Brandvein)
Date: Sun, 27 Apr 2014 16:12:19 +0000
Subject: [docs] [issue21366] Document that return in finally overwrites prev
	value
Message-ID: <1398615139.09.0.290952002497.issue21366@psf.upfronthosting.co.za>


New submission from Jon Brandvein:

def foo():
    try:
      return 1
    finally;
      return 2
  print(foo())  # 2

I've seen this peculiar case discussed on a few blogs lately, but was unable to find confirmation that this behavior is defined.

In the try/finally section of Doc/reference/compound_stmts.rst, immediately after the sentence beginning

> When a return, break, or continue statement is executed

I propose adding something to the effect of:

> A return statement in a finally clause overrides the value of any return statement executed in the try suite.

This wording also handles the case of nested try/finally blocks.

----------
assignee: docs at python
components: Documentation
messages: 217277
nosy: brandjon, docs at python
priority: normal
severity: normal
status: open
title: Document that return in finally overwrites prev value
type: behavior

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

From report at bugs.python.org  Sun Apr 27 18:27:05 2014
From: report at bugs.python.org (Berker Peksag)
Date: Sun, 27 Apr 2014 16:27:05 +0000
Subject: [docs] [issue21365] asyncio.Task reference misses the most
	important fact	about it,
	related info spread around intros and example commentary instead
In-Reply-To: <1398613098.75.0.265677522517.issue21365@psf.upfronthosting.co.za>
Message-ID: <1398616025.62.0.946564036471.issue21365@psf.upfronthosting.co.za>


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


----------
nosy: +giampaolo.rodola, gvanrossum, haypo, pitrou, yselivanov

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

From report at bugs.python.org  Mon Apr 28 00:14:43 2014
From: report at bugs.python.org (Kathleen Weaver)
Date: Sun, 27 Apr 2014 22:14:43 +0000
Subject: [docs] [issue20265] Bring Windows docs up to date
In-Reply-To: <1389757265.26.0.116885263001.issue20265@psf.upfronthosting.co.za>
Message-ID: <1398636882.55.0.971055674706.issue20265@psf.upfronthosting.co.za>


Kathleen Weaver added the comment:

Latest update

----------
Added file: http://bugs.python.org/file35061/mywork.patch

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

From report at bugs.python.org  Mon Apr 28 15:35:44 2014
From: report at bugs.python.org (akira)
Date: Mon, 28 Apr 2014 13:35:44 +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: <1398692143.84.0.415818266118.issue19940@psf.upfronthosting.co.za>


akira added the comment:

I've updated the patch:

- fixed the code example in the documentation to use int instead of
  float result
- removed assertion on the int returned type (float won't lose precision
  for the practical dates but guaranteeing an integer would be nice)
- reworded the scary comment
- removed tests that test the tests

Ready for review.

----------
Added file: http://bugs.python.org/file35075/ssl_cert_time_to_seconds-ps6.patch

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

From pitrou at free.fr  Sun Apr 27 14:15:37 2014
From: pitrou at free.fr (pitrou at free.fr)
Date: Sun, 27 Apr 2014 12:15:37 -0000
Subject: [docs] ssl.cert_time_to_seconds() returns wrong results if
 local timezone is not UTC (issue 19940)
Message-ID: <20140427121537.10710.42636@psf.upfronthosting.co.za>

Thanks for the patch! I think it looks mostly good. A couple of very
minor comments below.



http://bugs.python.org/review/19940/diff/11721/Doc/library/ssl.rst
File Doc/library/ssl.rst (right):

http://bugs.python.org/review/19940/diff/11721/Doc/library/ssl.rst#newcode397
Doc/library/ssl.rst:397: previously. Return an integer (no fractions of
a second in the
You say "return an integer" but your example shows a floating-point
number.

http://bugs.python.org/review/19940/diff/11721/Lib/ssl.py
File Lib/ssl.py (right):

http://bugs.python.org/review/19940/diff/11721/Lib/ssl.py#newcode906
Lib/ssl.py:906: # return an integer, break compatibility with the
previous
This comment sounds a bit scary, but returning an integer shouldn't
really "break compatibility". I suggest to reword it and make it
lighter.

http://bugs.python.org/review/19940/diff/11721/Lib/test/test_ssl.py
File Lib/test/test_ssl.py (right):

http://bugs.python.org/review/19940/diff/11721/Lib/test/test_ssl.py#newcode675
Lib/test/test_ssl.py:675: def
test_cert_time_to_seconds_returned_type(self):
I don't think checking that an int (rather than a float) is returned is
useful. Float timestamps are perfectly normal in Python.

http://bugs.python.org/review/19940/diff/11721/Lib/test/test_ssl.py#newcode688
Lib/test/test_ssl.py:688: self.assertEqual(timestring.replace(' 5',
'05'), d_timestring)
This assertEqual looks a bit pointless.

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

From anastasia at kislova.spb.ru  Mon Apr 28 16:37:13 2014
From: anastasia at kislova.spb.ru (=?UTF-8?B?0JDQvdCw0YHRgtCw0YHQuNGPINCa0LjRgdC70L7QstCw?=)
Date: Mon, 28 Apr 2014 18:37:13 +0400
Subject: [docs] Server side errors in "Errors and Exceptions" tutorial page
Message-ID: <CAG5o+W-_W_BSfSO3f0BsnZdKuXxB2bNN3CP0sfiqmLt9Eqa9OA@mail.gmail.com>

Hi there!

There is a problem on opening Errors and
Exceptions<https://docs.python.org/2/tutorial/errors.html>
 (https://docs.python.org/2/tutorial/errors.html) page of the Tutorial.
The page has Fast Debug "gibberish" at the top. After this the "regular"
text starts with "The
try<https://docs.python.org/2/reference/compound_stmts.html#try>
 ... except <https://docs.python.org/2/reference/compound_stmts.html#except>
statement
has an optional *else clause*" and goes on all right till the end*. *No css
styles are applied, as expected.

Other pages of the Tutorial (including the previous, the next and a couple
of other random ones) work fine.

Sadly, I can't tell, how long ago the error had appeared.

-----
Best regards,
Anastasia Kislova
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140428/56e460e1/attachment.html>

From zachary.ware+pydocs at gmail.com  Mon Apr 28 16:52:58 2014
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Mon, 28 Apr 2014 09:52:58 -0500
Subject: [docs] Server side errors in "Errors and Exceptions" tutorial
	page
In-Reply-To: <CAG5o+W-_W_BSfSO3f0BsnZdKuXxB2bNN3CP0sfiqmLt9Eqa9OA@mail.gmail.com>
References: <CAG5o+W-_W_BSfSO3f0BsnZdKuXxB2bNN3CP0sfiqmLt9Eqa9OA@mail.gmail.com>
Message-ID: <CAKJDb-PABDbCt8x4TtadKchOm3_TBZi2JD736QaGkg_OSW4aEw@mail.gmail.com>

Hi Anastasia,

On Mon, Apr 28, 2014 at 9:37 AM, ????????? ???????
<anastasia at kislova.spb.ru> wrote:
> Hi there!
>
> There is a problem on opening Errors and Exceptions
> (https://docs.python.org/2/tutorial/errors.html) page of the Tutorial.
> The page has Fast Debug "gibberish" at the top. After this the "regular"
> text starts with "The try ... except statement has an optional else clause"
> and goes on all right till the end. No css styles are applied, as expected.
>
> Other pages of the Tutorial (including the previous, the next and a couple
> of other random ones) work fine.

I don't see the same error, do you still see it?  If you do a full
reload (Ctrl+F5 in Firefox, not sure about other browsers), do you
still get the message?

-- 
Zach

From report at bugs.python.org  Mon Apr 28 17:14:44 2014
From: report at bugs.python.org (Jim Jewett)
Date: Mon, 28 Apr 2014 15:14:44 +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: <1398698084.36.0.576592463925.issue20974@psf.upfronthosting.co.za>


Jim Jewett added the comment:

I don't know for sure if the compatibility claims are correct, but the patch looks good.

----------
stage:  -> commit review

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

From anastasia at kislova.spb.ru  Mon Apr 28 17:13:30 2014
From: anastasia at kislova.spb.ru (=?UTF-8?B?0JDQvdCw0YHRgtCw0YHQuNGPINCa0LjRgdC70L7QstCw?=)
Date: Mon, 28 Apr 2014 19:13:30 +0400
Subject: [docs] Server side errors in "Errors and Exceptions" tutorial
	page
In-Reply-To: <CAKJDb-PABDbCt8x4TtadKchOm3_TBZi2JD736QaGkg_OSW4aEw@mail.gmail.com>
References: <CAG5o+W-_W_BSfSO3f0BsnZdKuXxB2bNN3CP0sfiqmLt9Eqa9OA@mail.gmail.com>
 <CAKJDb-PABDbCt8x4TtadKchOm3_TBZi2JD736QaGkg_OSW4aEw@mail.gmail.com>
Message-ID: <CAG5o+W9-t_JL9z-zUpXZb44w_2uMSnnoKM-=veP99PT70W3uWw@mail.gmail.com>

Hi, Zachary!

You're right, it's OK now. Must've been some glitch. Sorry for bothering
then :)

PS In case you find it useful for some reason, there is a copy of the
corrupted html page in attachment.

-----
? ?????????,
????????? ???????
???. +7(951)683-31-33


On Mon, Apr 28, 2014 at 6:52 PM, Zachary Ware <zachary.ware+pydocs at gmail.com
> wrote:

> Hi Anastasia,
>
> On Mon, Apr 28, 2014 at 9:37 AM, ????????? ???????
> <anastasia at kislova.spb.ru> wrote:
> > Hi there!
> >
> > There is a problem on opening Errors and Exceptions
> > (https://docs.python.org/2/tutorial/errors.html) page of the Tutorial.
> > The page has Fast Debug "gibberish" at the top. After this the "regular"
> > text starts with "The try ... except statement has an optional else
> clause"
> > and goes on all right till the end. No css styles are applied, as
> expected.
> >
> > Other pages of the Tutorial (including the previous, the next and a
> couple
> > of other random ones) work fine.
>
> I don't see the same error, do you still see it?  If you do a full
> reload (Ctrl+F5 in Firefox, not sure about other browsers), do you
> still get the message?
>
> --
> Zach
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140428/342e4e2b/attachment-0002.html>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20140428/342e4e2b/attachment-0003.html>

From zachary.ware+pydocs at gmail.com  Mon Apr 28 19:07:52 2014
From: zachary.ware+pydocs at gmail.com (Zachary Ware)
Date: Mon, 28 Apr 2014 12:07:52 -0500
Subject: [docs] Server side errors in "Errors and Exceptions" tutorial
	page
In-Reply-To: <CAG5o+W9-t_JL9z-zUpXZb44w_2uMSnnoKM-=veP99PT70W3uWw@mail.gmail.com>
References: <CAG5o+W-_W_BSfSO3f0BsnZdKuXxB2bNN3CP0sfiqmLt9Eqa9OA@mail.gmail.com>
 <CAKJDb-PABDbCt8x4TtadKchOm3_TBZi2JD736QaGkg_OSW4aEw@mail.gmail.com>
 <CAG5o+W9-t_JL9z-zUpXZb44w_2uMSnnoKM-=veP99PT70W3uWw@mail.gmail.com>
Message-ID: <CAKJDb-PbO80xQvTJLEg+uJPrNj63LLwaxMw3pt7uLYk19Nm2Tg@mail.gmail.com>

On Mon, Apr 28, 2014 at 10:13 AM, ????????? ???????
<anastasia at kislova.spb.ru> wrote:
> Hi, Zachary!
>
> You're right, it's OK now. Must've been some glitch. Sorry for bothering
> then :)

No problem, thanks for the report!

> PS In case you find it useful for some reason, there is a copy of the
> corrupted html page in attachment.

That is a strange one; do let us know if it happens again,
particularly if it's repeatable.

Regards,
-- 
Zach

From report at bugs.python.org  Mon Apr 28 20:05:57 2014
From: report at bugs.python.org (Philip Sequeira)
Date: Mon, 28 Apr 2014 18:05:57 +0000
Subject: [docs] [issue21376] asyncio docs refer to wrong TimeoutError
Message-ID: <1398708357.06.0.922465155945.issue21376@psf.upfronthosting.co.za>


New submission from Philip Sequeira:

Example: https://docs.python.org/3.4/library/asyncio-task.html
TimeoutError is mentioned several times, and links to the OSError subclass. However, the actual TimeoutError raised by asyncio stuff is the one from concurrent.futures, which is not compatible. The docs as they are seem to suggest that something like "except TimeoutError" would be appropriate, when in fact that would not produce the expected behavior; "except asyncio.TimeoutError" is what you'd want.

----------
assignee: docs at python
components: Documentation
messages: 217390
nosy: docs at python, qmega
priority: normal
severity: normal
status: open
title: asyncio docs refer to wrong TimeoutError
versions: Python 3.4, Python 3.5

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

From report at bugs.python.org  Mon Apr 28 20:49:35 2014
From: report at bugs.python.org (Antoine Pitrou)
Date: Mon, 28 Apr 2014 18:49:35 +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: <1398710975.22.0.829915775901.issue19940@psf.upfronthosting.co.za>


Antoine Pitrou added the comment:

Thanks for the updated patch, Akira! I'm gonna take a look right now.

----------

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

From report at bugs.python.org  Mon Apr 28 20:57:46 2014
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 28 Apr 2014 18:57:46 +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: <3gHZxQ0R3Qz7Ljx@mail.python.org>


Roundup Robot added the comment:

New changeset 7191c37238d5 by Antoine Pitrou in branch 'default':
Issue #19940: ssl.cert_time_to_seconds() now interprets the given time string in the UTC timezone (as specified in RFC 5280), not the local timezone.
http://hg.python.org/cpython/rev/7191c37238d5

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

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

From report at bugs.python.org  Mon Apr 28 20:58:18 2014
From: report at bugs.python.org (Antoine Pitrou)
Date: Mon, 28 Apr 2014 18:58:18 +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: <1398711497.97.0.65241231873.issue19940@psf.upfronthosting.co.za>


Antoine Pitrou added the comment:

I've committed the patch. Thank you very much for contributing!

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

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

From report at bugs.python.org  Mon Apr 28 21:20:55 2014
From: report at bugs.python.org (Antoine Pitrou)
Date: Mon, 28 Apr 2014 19:20:55 +0000
Subject: [docs] [issue21376] asyncio docs refer to wrong TimeoutError
In-Reply-To: <1398708357.06.0.922465155945.issue21376@psf.upfronthosting.co.za>
Message-ID: <1398712855.45.0.47796802283.issue21376@psf.upfronthosting.co.za>


Antoine Pitrou added the comment:

Gasp. Perhaps concurrent.futures.TimeoutError can inherit from the standard TimeoutError? The following patch doesn't seem to disrupt the test suite:

diff --git a/Lib/concurrent/futures/_base.py b/Lib/concurrent/futures/_base.py
--- a/Lib/concurrent/futures/_base.py
+++ b/Lib/concurrent/futures/_base.py
@@ -49,7 +49,7 @@ class CancelledError(Error):
     """The Future was cancelled."""
     pass
 
-class TimeoutError(Error):
+class TimeoutError(Error, TimeoutError):
     """The operation exceeded the given deadline."""
     pass

----------
assignee: docs at python -> 
components: +Library (Lib)
nosy: +giampaolo.rodola, gvanrossum, haypo, pitrou, yselivanov

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

From report at bugs.python.org  Mon Apr 28 21:26:12 2014
From: report at bugs.python.org (Guido van Rossum)
Date: Mon, 28 Apr 2014 19:26:12 +0000
Subject: [docs] [issue21376] asyncio docs refer to wrong TimeoutError
In-Reply-To: <1398708357.06.0.922465155945.issue21376@psf.upfronthosting.co.za>
Message-ID: <1398713172.24.0.553137259656.issue21376@psf.upfronthosting.co.za>


Guido van Rossum added the comment:

I considered this, and decided against unifying the two TimeoutErrors.

First the builtin TimeoutError is specifically a subclass of OSError representing the case where errno is ETIMEDOUT.  But asyncio.TimeoutError means nothing of the sort.

Second, the precedent is concurrent.futures.TimeoutError. The asyncio one is used under the same conditions as that one.

I think we should just update the links in the docs to be correct.

----------

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

From report at bugs.python.org  Mon Apr 28 23:05:49 2014
From: report at bugs.python.org (Zachary Ware)
Date: Mon, 28 Apr 2014 21:05:49 +0000
Subject: [docs] [issue17386] Bring Doc/make.bat as close to Doc/Makefile as
	possible
In-Reply-To: <1362781994.31.0.121984055749.issue17386@psf.upfronthosting.co.za>
Message-ID: <1398719148.86.0.297577108003.issue17386@psf.upfronthosting.co.za>


Zachary Ware added the comment:

New patch, fixes a typo bug in a useless statement (by removing the statement) and a few pesky tabs that made their way into make.bat.  Also, a little better organization in the vars at the top.

----------
Added file: http://bugs.python.org/file35079/issue17386.v2.diff

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

From report at bugs.python.org  Tue Apr 29 00:24:24 2014
From: report at bugs.python.org (Antoine Pitrou)
Date: Mon, 28 Apr 2014 22:24:24 +0000
Subject: [docs] [issue21353] document Popen.args attribute
In-Reply-To: <1398481373.88.0.978177813548.issue21353@psf.upfronthosting.co.za>
Message-ID: <1398723864.44.0.518571350021.issue21353@psf.upfronthosting.co.za>


Antoine Pitrou added the comment:

Gregory, do you think this is ok to document?

----------
nosy: +gregory.p.smith, pitrou
stage:  -> patch review
versions:  -Python 3.3

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

From report at bugs.python.org  Tue Apr 29 00:46:14 2014
From: report at bugs.python.org (akira)
Date: Mon, 28 Apr 2014 22:46:14 +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: <1398725174.1.0.00725632963364.issue19940@psf.upfronthosting.co.za>


akira added the comment:

Antoine, thank you for reviewing. I appreciate the patience.

----------

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

From report at bugs.python.org  Tue Apr 29 01:39:32 2014
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 28 Apr 2014 23:39:32 +0000
Subject: [docs] [issue9307] Py_TPFLAGS_LONG_SUBCLASS is not documented
In-Reply-To: <1279561825.23.0.120090245801.issue9307@psf.upfronthosting.co.za>
Message-ID: <3gHjBW1Tv4z7LjQ@mail.python.org>


Roundup Robot added the comment:

New changeset 37786ae8cc1c by Antoine Pitrou in branch '3.4':
Issue #9307: document the various Py_TPFLAGS_*_SUBCLASS flags.  Patch by Yury V. Zaytsev.
http://hg.python.org/cpython/rev/37786ae8cc1c

New changeset d1a03834cec7 by Antoine Pitrou in branch 'default':
Issue #9307: document the various Py_TPFLAGS_*_SUBCLASS flags.  Patch by Yury V. Zaytsev.
http://hg.python.org/cpython/rev/d1a03834cec7

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

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

From report at bugs.python.org  Tue Apr 29 01:39:58 2014
From: report at bugs.python.org (Antoine Pitrou)
Date: Mon, 28 Apr 2014 23:39:58 +0000
Subject: [docs] [issue9307] Py_TPFLAGS_LONG_SUBCLASS is not documented
In-Reply-To: <1279561825.23.0.120090245801.issue9307@psf.upfronthosting.co.za>
Message-ID: <1398728398.12.0.871238239576.issue9307@psf.upfronthosting.co.za>


Antoine Pitrou added the comment:

This is committed, thank you.

----------
resolution:  -> fixed
stage: needs patch -> resolved
status: open -> closed
versions: +Python 3.4 -Python 2.7, Python 3.1, Python 3.2

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

From report at bugs.python.org  Tue Apr 29 01:40:34 2014
From: report at bugs.python.org (Antoine Pitrou)
Date: Mon, 28 Apr 2014 23:40:34 +0000
Subject: [docs] [issue20064] PyObject_Malloc is not documented
In-Reply-To: <1387913960.58.0.680621486861.issue20064@psf.upfronthosting.co.za>
Message-ID: <1398728434.54.0.0527665193411.issue20064@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Tue Apr 29 02:04:08 2014
From: report at bugs.python.org (Antoine Pitrou)
Date: Tue, 29 Apr 2014 00:04:08 +0000
Subject: [docs] [issue15088] PyGen_NeedsFinalizing is public,
	but undocumented
In-Reply-To: <1339906861.99.0.42415214654.issue15088@psf.upfronthosting.co.za>
Message-ID: <1398729847.93.0.683049449561.issue15088@psf.upfronthosting.co.za>


Antoine Pitrou added the comment:

For the record, PyGen_NeedsFinalizing still exists but it isn't used anymore in the code base (following PEP 442).

----------
nosy: +pitrou

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

From report at bugs.python.org  Tue Apr 29 06:38:51 2014
From: report at bugs.python.org (Terry J. Reedy)
Date: Tue, 29 Apr 2014 04:38:51 +0000
Subject: [docs] [issue21352] improve documentation indexing
In-Reply-To: <1398457661.12.0.679738685491.issue21352@psf.upfronthosting.co.za>
Message-ID: <1398746331.72.0.686818962126.issue21352@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/issue21352>
_______________________________________

From report at bugs.python.org  Tue Apr 29 10:17:16 2014
From: report at bugs.python.org (rsevcan)
Date: Tue, 29 Apr 2014 08:17:16 +0000
Subject: [docs] [issue21382] Signal module doesnt raises ValueError Exception
Message-ID: <1398759436.39.0.420418396293.issue21382@psf.upfronthosting.co.za>


New submission from rsevcan:

signal.signal() built-in function doesnt throws a ValueError exception in Windows when is called with a different signal than SIGABRT, SIGFPE, SIGILL, SIGINT, SIGSEGV, or SIGTERM, as it is written in the documentation.

https://docs.python.org/2/library/signal.html#signal.signal
https://docs.python.org/3/library/signal.html#signal.signal

It throws an AttributeError Exception

>>> import signal
>>> import sys
>>> sys.platform
'win32'
>>> signal.signal(signal.SIGPIPE, lambda signum, frame: sys.exit(1))
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
AttributeError: 'module' object has no attribute 'SIGPIPE'
>>>

Regards

----------
assignee: docs at python
components: Documentation
messages: 217486
nosy: docs at python, rsevcan
priority: normal
severity: normal
status: open
title: Signal module doesnt raises ValueError Exception
type: enhancement
versions: Python 2.7

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

From report at bugs.python.org  Tue Apr 29 16:47:55 2014
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 29 Apr 2014 14:47:55 +0000
Subject: [docs] [issue17386] Bring Doc/make.bat as close to Doc/Makefile as
	possible
In-Reply-To: <1362781994.31.0.121984055749.issue17386@psf.upfronthosting.co.za>
Message-ID: <3gJ5Lf4thVz7Ljw@mail.python.org>


Roundup Robot added the comment:

New changeset c75a2282166f by Zachary Ware in branch '3.4':
Issue #17386: List the 'htmlview' target in the Doc/Makefile help output.
http://hg.python.org/cpython/rev/c75a2282166f

New changeset c378c67c4170 by Zachary Ware in branch '3.4':
Issue #17386: Update Doc/README.txt to list all targets
http://hg.python.org/cpython/rev/c378c67c4170

New changeset a172f26195f6 by Zachary Ware in branch '3.4':
Issue #17386: Expand Doc/make.bat to be much more similar to Doc/Makefile
http://hg.python.org/cpython/rev/a172f26195f6

New changeset 2b2577d79e80 by Zachary Ware in branch 'default':
Closes #17386: Merge with 3.4
http://hg.python.org/cpython/rev/2b2577d79e80

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

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

From report at bugs.python.org  Tue Apr 29 17:31:11 2014
From: report at bugs.python.org (Zachary Ware)
Date: Tue, 29 Apr 2014 15:31:11 +0000
Subject: [docs] [issue21314] Document '/' in signatures
In-Reply-To: <1397988439.5.0.703056699862.issue21314@psf.upfronthosting.co.za>
Message-ID: <1398785471.97.0.951012060327.issue21314@psf.upfronthosting.co.za>


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


----------
keywords: +easy
stage:  -> needs patch
status:  -> open
type:  -> enhancement
versions: +Python 3.5

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

From report at bugs.python.org  Tue Apr 29 18:39:02 2014
From: report at bugs.python.org (Florent Xicluna)
Date: Tue, 29 Apr 2014 16:39:02 +0000
Subject: [docs] [issue21382] Signal module doesnt raises ValueError Exception
In-Reply-To: <1398759436.39.0.420418396293.issue21382@psf.upfronthosting.co.za>
Message-ID: <1398789542.5.0.806975466487.issue21382@psf.upfronthosting.co.za>


Changes by Florent Xicluna <florent.xicluna at gmail.com>:


----------
components: +Library (Lib), Windows
nosy: +flox
type: enhancement -> behavior

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

From report at bugs.python.org  Tue Apr 29 19:16:49 2014
From: report at bugs.python.org (Florent Xicluna)
Date: Tue, 29 Apr 2014 17:16:49 +0000
Subject: [docs] [issue21382] Signal module doesnt raises ValueError Exception
In-Reply-To: <1398759436.39.0.420418396293.issue21382@psf.upfronthosting.co.za>
Message-ID: <1398791809.52.0.850759217678.issue21382@psf.upfronthosting.co.za>


Florent Xicluna added the comment:

It's about documentation only.

The sentence is not wrong, but it is slightly confusing, and there's no hint which signals are defined on Windows.

"On Windows, signal() can only be called with SIGABRT, SIGFPE, SIGILL, SIGINT, SIGSEGV, or SIGTERM. A ValueError will be raised in any other case."

Reading only this documentation, if the developer doesn't have a test platform on Windows, he could blindly write:

try:
    signal.signal(signal.SIGPIPE, lambda signum, frame: sys.exit(1))
except ValueError:
    pass

... until a Windows user detects the issue (thank you rsevcan)


Now I just found this page which is relevant here ... either we could link to the page in a "See also" section, or give an hint about which signals are defined or not.
http://msdn.microsoft.com/en-us/library/xdkz3x12.aspx

----------
components:  -Library (Lib)
priority: normal -> low
versions: +Python 3.4, Python 3.5

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

From report at bugs.python.org  Tue Apr 29 20:34:25 2014
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 29 Apr 2014 18:34:25 +0000
Subject: [docs] [issue21353] document Popen.args attribute
In-Reply-To: <1398481373.88.0.978177813548.issue21353@psf.upfronthosting.co.za>
Message-ID: <3gJBN01f4Mz7LjT@mail.python.org>


Roundup Robot added the comment:

New changeset 0a4b211b927e by Gregory P. Smith in branch '3.3':
Document the subprocess Popen.args attribute (issue21353)
http://hg.python.org/cpython/rev/0a4b211b927e

New changeset 182b869283a5 by Gregory P. Smith in branch '3.4':
Document the subprocess Popen.args attribute (issue21353)
http://hg.python.org/cpython/rev/182b869283a5

New changeset 0b2e199ad088 by Gregory P. Smith in branch 'default':
Document the subprocess Popen.args attribute (issue21353)
http://hg.python.org/cpython/rev/0b2e199ad088

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

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

From report at bugs.python.org  Tue Apr 29 20:35:05 2014
From: report at bugs.python.org (Gregory P. Smith)
Date: Tue, 29 Apr 2014 18:35:05 +0000
Subject: [docs] [issue21353] document Popen.args attribute
In-Reply-To: <1398481373.88.0.978177813548.issue21353@psf.upfronthosting.co.za>
Message-ID: <1398796505.44.0.497565848693.issue21353@psf.upfronthosting.co.za>


Gregory P. Smith added the comment:

yes. this was overlooked. thanks!

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

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

From report at bugs.python.org  Wed Apr 30 14:31:38 2014
From: report at bugs.python.org (R. David Murray)
Date: Wed, 30 Apr 2014 12:31:38 +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: <1398861098.76.0.907920775546.issue20974@psf.upfronthosting.co.za>


R. David Murray added the comment:

Like I said, the compatibility claims are almost certainly incorrect.

----------

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