From report at bugs.python.org  Mon Jun  3 15:31:26 2013
From: report at bugs.python.org (Yury V. Zaytsev)
Date: Mon, 03 Jun 2013 13:31:26 +0000
Subject: [docs] [issue18126] Update links to NumPy resources in documentation
Message-ID: <1370266286.34.0.85536188421.issue18126@psf.upfronthosting.co.za>


New submission from Yury V. Zaytsev:

Hi,

The links to NumPy sites and documentation are outdated. I replaced them with www.numpy.org, and also the canonical location for documentation (docs.scipy.org).

I removed the explicit mention of the PDF file, because the documentation has been split in several guides, so I think it no longer makes sense, and it's better to link docs.scipy.org instead.

Thanks!

----------
assignee: docs at python
components: Documentation
files: doc-numpy.patch
keywords: patch
messages: 190543
nosy: docs at python, eric.araujo, ezio.melotti, georg.brandl, zaytsev
priority: normal
severity: normal
status: open
title: Update links to NumPy resources in documentation
type: enhancement
Added file: http://bugs.python.org/file30455/doc-numpy.patch

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

From bgailer at gmail.com  Tue Jun  4 15:15:39 2013
From: bgailer at gmail.com (bob gailer)
Date: Tue, 04 Jun 2013 09:15:39 -0400
Subject: [docs] Function Int()
In-Reply-To: <001f01ce142f$5039b260$f0ad1720$@demon.co.uk>
References: <001f01ce142f$5039b260$f0ad1720$@demon.co.uk>
Message-ID: <51ADE87B.8080806@gmail.com>

On 2/26/2013 9:41 AM, Colin Morley wrote:
> Hi
I just found your post - and see no reply, so I will reply.
>
>
> I'm not a Python expert -- barely a novice, but the entry for the 
> function INT() on both 2.7 and 3.3 versions is headed
>
> INT(x=0)...
actually it is int(x=0). Python is case sensitive!
>
>
> Which does not seem to make much sense to me -- shouldn't it be INT(x)?
>
> (X=0) is true or false (1 or 0)  depending on the value of x.
actually comparison uses ==. x==0 would yiels True or False. Note again 
case is important.
>
>
> Apologies if this is nonsense
Just not clearly understanding.

When you define a function you can make a parameter optional by the 
syntax parameter = default value.

int(x=0) thus is shorthand for saying "if you don't provide a value for 
x it will be assigned the value 0.

You could have discovered this by reading the docs. "Convert a number or 
string x to an integer, or return 0 if no arguments are given."


-- 
Bob Gailer
919-636-4239
Chapel Hill NC

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20130604/9237a084/attachment.html>

From report at bugs.python.org  Thu Jun  6 06:16:09 2013
From: report at bugs.python.org (hanks)
Date: Thu, 06 Jun 2013 04:16:09 +0000
Subject: [docs] [issue18146] Document miss,
	Stats objects has no method called "print_results"
Message-ID: <1370492169.32.0.572100165636.issue18146@psf.upfronthosting.co.za>


New submission from hanks:

link: http://docs.python.org/2/library/profile.html

The example in this page:

import cProfile, pstats, io
pr = cProfile.Profile()
pr.enable()
... do something ...
pr.disable()
s = io.StringIO()
ps = pstats.Stats(pr, stream=s)
ps.print_results()  # actually Stats objects has no method called "print_results"

----------
assignee: docs at python
components: Documentation
messages: 190705
nosy: docs at python, hanks
priority: normal
severity: normal
status: open
title: Document miss, Stats objects has no method called "print_results"
type: enhancement
versions: Python 2.7

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

From report at bugs.python.org  Thu Jun  6 11:08:56 2013
From: report at bugs.python.org (Dmi Baranov)
Date: Thu, 06 Jun 2013 09:08:56 +0000
Subject: [docs] [issue18146] Document miss,
	Stats objects has no method called "print_results"
In-Reply-To: <1370492169.32.0.572100165636.issue18146@psf.upfronthosting.co.za>
Message-ID: <1370509736.28.0.799950604602.issue18146@psf.upfronthosting.co.za>


Dmi Baranov added the comment:

Duplication of issue 18033

----------
nosy: +dmi.baranov

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

From report at bugs.python.org  Thu Jun  6 11:14:13 2013
From: report at bugs.python.org (hanks)
Date: Thu, 06 Jun 2013 09:14:13 +0000
Subject: [docs] [issue18146] Document miss,
	Stats objects has no method called "print_results"
In-Reply-To: <1370492169.32.0.572100165636.issue18146@psf.upfronthosting.co.za>
Message-ID: <1370510053.8.0.585248143211.issue18146@psf.upfronthosting.co.za>


Changes by hanks <zhouhan315 at gmail.com>:


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

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

From report at bugs.python.org  Thu Jun  6 11:40:47 2013
From: report at bugs.python.org (R. David Murray)
Date: Thu, 06 Jun 2013 09:40:47 +0000
Subject: [docs] [issue18146] Document miss,
	Stats objects has no method called "print_results"
In-Reply-To: <1370492169.32.0.572100165636.issue18146@psf.upfronthosting.co.za>
Message-ID: <1370511647.44.0.300968092151.issue18146@psf.upfronthosting.co.za>


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


----------
resolution:  -> duplicate
stage:  -> committed/rejected
superseder:  -> Example for Profile Module shows incorrect method

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

From report at bugs.python.org  Sat Jun  8 10:36:14 2013
From: report at bugs.python.org (Ethan Furman)
Date: Sat, 08 Jun 2013 08:36:14 +0000
Subject: [docs] [issue17947] Code, test, and doc review for PEP-0435 Enum
In-Reply-To: <1368168600.94.0.409104207023.issue17947@psf.upfronthosting.co.za>
Message-ID: <1370680573.47.0.911099794216.issue17947@psf.upfronthosting.co.za>


Ethan Furman added the comment:

Hopefully the final bit of code, plus docs.

Code changes:  

  _names_ are reserved

  
Doc changes (different from the PEP):

  examples of AutoEnum, UniqueEnum, and OrderedEnum

----------
Added file: http://bugs.python.org/file30504/pep-0435.08.stoneleaf.patch

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

From report at bugs.python.org  Sat Jun  8 10:38:01 2013
From: report at bugs.python.org (Ethan Furman)
Date: Sat, 08 Jun 2013 08:38:01 +0000
Subject: [docs] [issue17947] Code, test, and doc review for PEP-0435 Enum
In-Reply-To: <1368168600.94.0.409104207023.issue17947@psf.upfronthosting.co.za>
Message-ID: <1370680681.95.0.87366758293.issue17947@psf.upfronthosting.co.za>


Changes by Ethan Furman <ethan at stoneleaf.us>:


Removed file: http://bugs.python.org/file30504/pep-0435.08.stoneleaf.patch

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

From report at bugs.python.org  Sat Jun  8 10:38:46 2013
From: report at bugs.python.org (Ethan Furman)
Date: Sat, 08 Jun 2013 08:38:46 +0000
Subject: [docs] [issue17947] Code, test, and doc review for PEP-0435 Enum
In-Reply-To: <1368168600.94.0.409104207023.issue17947@psf.upfronthosting.co.za>
Message-ID: <1370680725.54.0.170694655924.issue17947@psf.upfronthosting.co.za>


Changes by Ethan Furman <ethan at stoneleaf.us>:


Added file: http://bugs.python.org/file30505/pep-0435.08.stoneleaf.patch

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

From report at bugs.python.org  Sat Jun  8 10:39:34 2013
From: report at bugs.python.org (Ethan Furman)
Date: Sat, 08 Jun 2013 08:39:34 +0000
Subject: [docs] [issue17947] Code, test, and doc review for PEP-0435 Enum
In-Reply-To: <1368168600.94.0.409104207023.issue17947@psf.upfronthosting.co.za>
Message-ID: <1370680774.7.0.0279775861584.issue17947@psf.upfronthosting.co.za>


Changes by Ethan Furman <ethan at stoneleaf.us>:


Removed file: http://bugs.python.org/file30505/pep-0435.08.stoneleaf.patch

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

From report at bugs.python.org  Sat Jun  8 10:41:10 2013
From: report at bugs.python.org (Ethan Furman)
Date: Sat, 08 Jun 2013 08:41:10 +0000
Subject: [docs] [issue17947] Code, test, and doc review for PEP-0435 Enum
In-Reply-To: <1368168600.94.0.409104207023.issue17947@psf.upfronthosting.co.za>
Message-ID: <1370680868.28.0.36333500032.issue17947@psf.upfronthosting.co.za>


Ethan Furman added the comment:

Apologies for the noise -- was having trouble getting the correct patch attached.  :/

----------
Added file: http://bugs.python.org/file30506/pep-0435.09.stoneleaf.patch

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

From report at bugs.python.org  Sat Jun  8 17:55:42 2013
From: report at bugs.python.org (Ethan Furman)
Date: Sat, 08 Jun 2013 15:55:42 +0000
Subject: [docs] [issue17947] Code, test, and doc review for PEP-0435 Enum
In-Reply-To: <1368168600.94.0.409104207023.issue17947@psf.upfronthosting.co.za>
Message-ID: <1370706942.8.0.57690941379.issue17947@psf.upfronthosting.co.za>


Ethan Furman added the comment:

So, which is better?

To have a @unique class decorator as part of the module, or to have a UniqueEnum recipe in the docs?

A decorator is immediately usable, but requires remembering an extra line of code.

An example requires being put into a local utility module, but also serves as a guide to customising Enums.  (Took be about five tries to get it right. :/ )

----------

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

From report at bugs.python.org  Sat Jun  8 17:56:47 2013
From: report at bugs.python.org (Eli Bendersky)
Date: Sat, 08 Jun 2013 15:56:47 +0000
Subject: [docs] [issue17375] Add docstrings to methods in the threading
	module
In-Reply-To: <1362648255.88.0.520762515957.issue17375@psf.upfronthosting.co.za>
Message-ID: <1370707007.99.0.299152279751.issue17375@psf.upfronthosting.co.za>


Changes by Eli Bendersky <eliben at gmail.com>:


----------
nosy:  -eli.bendersky

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

From report at bugs.python.org  Sat Jun  8 18:00:19 2013
From: report at bugs.python.org (Eli Bendersky)
Date: Sat, 08 Jun 2013 16:00:19 +0000
Subject: [docs] [issue17947] Code, test, and doc review for PEP-0435 Enum
In-Reply-To: <1368168600.94.0.409104207023.issue17947@psf.upfronthosting.co.za>
Message-ID: <1370707219.47.0.187037191393.issue17947@psf.upfronthosting.co.za>


Eli Bendersky added the comment:

Nick prudently moved the unique discussion to its own issue - 18042. Let's get the initial implementation & docs committed first (without unique in the implementation, although it's fine to have it as an example in the docs for now), close this issue, and then discuss in 18042 whether unique should be part of the stdlib-provided API or not.

----------

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

From report at bugs.python.org  Sat Jun  8 18:05:17 2013
From: report at bugs.python.org (Ethan Furman)
Date: Sat, 08 Jun 2013 16:05:17 +0000
Subject: [docs] [issue17947] Code, test, and doc review for PEP-0435 Enum
In-Reply-To: <1368168600.94.0.409104207023.issue17947@psf.upfronthosting.co.za>
Message-ID: <1370707517.87.0.517944875566.issue17947@psf.upfronthosting.co.za>


Ethan Furman added the comment:

Good idea, thanks.

----------

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

From report at bugs.python.org  Sat Jun  8 18:20:11 2013
From: report at bugs.python.org (Eli Bendersky)
Date: Sat, 08 Jun 2013 16:20:11 +0000
Subject: [docs] [issue17947] Code, test, and doc review for PEP-0435 Enum
In-Reply-To: <1368168600.94.0.409104207023.issue17947@psf.upfronthosting.co.za>
Message-ID: <1370708411.43.0.0989171078931.issue17947@psf.upfronthosting.co.za>


Eli Bendersky added the comment:

I sent a fresh review - nothing major; it's very near commit readiness now. Additional changes can be done after the initial commit. We have time until 3.4 beta (November 2013) to tweak stuff (and the documentation whenever...)

----------

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

From report at bugs.python.org  Sat Jun  8 19:50:41 2013
From: report at bugs.python.org (A.M. Kuchling)
Date: Sat, 08 Jun 2013 17:50:41 +0000
Subject: [docs] [issue14015] surrogateescape largely missing from
	documentation
In-Reply-To: <1329245790.15.0.430373154575.issue14015@psf.upfronthosting.co.za>
Message-ID: <1370713841.74.0.162863889126.issue14015@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Jun  8 21:45:59 2013
From: report at bugs.python.org (Ezio Melotti)
Date: Sat, 08 Jun 2013 19:45:59 +0000
Subject: [docs] [issue18034] Last two entries in the programming FAQ are out
	of date	(import related)
In-Reply-To: <1369244115.61.0.298181094271.issue18034@psf.upfronthosting.co.za>
Message-ID: <1370720759.93.0.936600677809.issue18034@psf.upfronthosting.co.za>


Ezio Melotti added the comment:

imp.reload() doesn't seem to be deprecated, and importlib.reload() doesn't exist.  Is there another alternative or it just hasn't been moved somewhere else?

----------

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

From report at bugs.python.org  Sat Jun  8 21:48:40 2013
From: report at bugs.python.org (Ezio Melotti)
Date: Sat, 08 Jun 2013 19:48:40 +0000
Subject: [docs] [issue18034] Last two entries in the programming FAQ are out
	of date	(import related)
In-Reply-To: <1369244115.61.0.298181094271.issue18034@psf.upfronthosting.co.za>
Message-ID: <1370720920.52.0.00645459340538.issue18034@psf.upfronthosting.co.za>


Ezio Melotti added the comment:

FTR here is a link to the FAQs: http://docs.python.org/3/faq/programming.html#import-x-y-z-returns-module-x-how-do-i-get-z

----------

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

From report at bugs.python.org  Sat Jun  8 22:26:52 2013
From: report at bugs.python.org (Ezio Melotti)
Date: Sat, 08 Jun 2013 20:26:52 +0000
Subject: [docs] [issue18033] Example for Profile Module shows incorrect
	method
In-Reply-To: <1369235558.14.0.532987051887.issue18033@psf.upfronthosting.co.za>
Message-ID: <1370723212.4.0.844275738785.issue18033@psf.upfronthosting.co.za>


Ezio Melotti added the comment:

Thanks for the patches, however the Python 2 example doesn't work.
I think a BytesIO should be used instead of a StringIO, and print_stats() only returns a pstats.Stats instance, without actually printing any result.
I wonder if print_results was an old method that has been removed and if now there's another way to print the results.
I haven't tried on Python 3 yet, but the same comment might apply there too.

----------
stage: needs patch -> patch review
versions: +Python 3.3

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

From report at bugs.python.org  Sun Jun  9 00:05:37 2013
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 08 Jun 2013 22:05:37 +0000
Subject: [docs] [issue18126] Update links to NumPy resources in documentation
In-Reply-To: <1370266286.34.0.85536188421.issue18126@psf.upfronthosting.co.za>
Message-ID: <3bSZRh2ZkSz7LlH@mail.python.org>


Roundup Robot added the comment:

New changeset dacd8f430e0e by Ezio Melotti in branch '2.7':
#18126: update NumPy links in the documentation.  Patch by Yury V. Zaytsev.
http://hg.python.org/cpython/rev/dacd8f430e0e

New changeset aafa11c1dd61 by Ezio Melotti in branch '3.3':
#18126: update NumPy links in the documentation.  Patch by Yury V. Zaytsev.
http://hg.python.org/cpython/rev/aafa11c1dd61

New changeset 1f0b6462ea3c by Ezio Melotti in branch 'default':
#18126: merge with 3.3.
http://hg.python.org/cpython/rev/1f0b6462ea3c

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

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

From report at bugs.python.org  Sun Jun  9 00:07:19 2013
From: report at bugs.python.org (Ezio Melotti)
Date: Sat, 08 Jun 2013 22:07:19 +0000
Subject: [docs] [issue18126] Update links to NumPy resources in documentation
In-Reply-To: <1370266286.34.0.85536188421.issue18126@psf.upfronthosting.co.za>
Message-ID: <1370729239.44.0.00117214720138.issue18126@psf.upfronthosting.co.za>


Ezio Melotti added the comment:

Fixed, thanks for the report and the patch!

----------
assignee: docs at python -> ezio.melotti
resolution:  -> fixed
stage:  -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Sun Jun  9 00:35:23 2013
From: report at bugs.python.org (Brett Cannon)
Date: Sat, 08 Jun 2013 22:35:23 +0000
Subject: [docs] [issue18034] Last two entries in the programming FAQ are out
	of date	(import related)
In-Reply-To: <1369244115.61.0.298181094271.issue18034@psf.upfronthosting.co.za>
Message-ID: <1370730923.28.0.482557266698.issue18034@psf.upfronthosting.co.za>


Brett Cannon added the comment:

Hasn't been moved yet. And the __import__ question should probably be rephrased as "don't do this".

----------

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

From report at bugs.python.org  Sun Jun  9 00:35:29 2013
From: report at bugs.python.org (Brett Cannon)
Date: Sat, 08 Jun 2013 22:35:29 +0000
Subject: [docs] [issue18034] Last two entries in the programming FAQ are out
	of date	(import related)
In-Reply-To: <1369244115.61.0.298181094271.issue18034@psf.upfronthosting.co.za>
Message-ID: <1370730929.55.0.600034315539.issue18034@psf.upfronthosting.co.za>


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


----------
dependencies: +Document/deprecate imp

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

From report at bugs.python.org  Sun Jun  9 06:46:00 2013
From: report at bugs.python.org (Ethan Furman)
Date: Sun, 09 Jun 2013 04:46:00 +0000
Subject: [docs] [issue17947] Code, test, and doc review for PEP-0435 Enum
In-Reply-To: <1368168600.94.0.409104207023.issue17947@psf.upfronthosting.co.za>
Message-ID: <1370753160.18.0.800531127113.issue17947@psf.upfronthosting.co.za>


Ethan Furman added the comment:

Doc updates are in.

I removed the 'unique, constant' from the first line of the intro, as neither of those things are necessarily true.

----------
Added file: http://bugs.python.org/file30511/pep-0435.10.stoneleaf.patch

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

From report at bugs.python.org  Sun Jun  9 07:25:16 2013
From: report at bugs.python.org (Ethan Furman)
Date: Sun, 09 Jun 2013 05:25:16 +0000
Subject: [docs] [issue17947] Code, test, and doc review for PEP-0435 Enum
In-Reply-To: <1368168600.94.0.409104207023.issue17947@psf.upfronthosting.co.za>
Message-ID: <1370755516.35.0.641275115605.issue17947@psf.upfronthosting.co.za>


Ethan Furman added the comment:

Hmm -- I was confusing member names with member values;  I'll put 'unique' back in.

----------

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

From report at bugs.python.org  Sun Jun  9 08:20:44 2013
From: report at bugs.python.org (Ethan Furman)
Date: Sun, 09 Jun 2013 06:20:44 +0000
Subject: [docs] [issue17947] Code, test, and doc review for PEP-0435 Enum
In-Reply-To: <1368168600.94.0.409104207023.issue17947@psf.upfronthosting.co.za>
Message-ID: <1370758842.14.0.0876247145752.issue17947@psf.upfronthosting.co.za>


Ethan Furman added the comment:

Hopefully the last update.  :)

----------
Added file: http://bugs.python.org/file30512/pep-0435.11.stoneleaf.patch

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

From aurelien at replicant.io  Sun Jun  9 19:37:54 2013
From: aurelien at replicant.io (=?utf-8?Q?Aur=C3=A9lien_DESBRI=C3=88RES?=)
Date: Sun, 09 Jun 2013 11:37:54 -0600
Subject: [docs] bug find in the documention
Message-ID: <87zjuzw5fx.fsf@replicant.replicant>


Hi,

It seems there is a bug in the documentation search tool bar.

It asked me to activate javascript in my web browser, but i don't wish
to send information.

Please can you respect my privacy ?

CC: prism liberty fuckers and nytimes ;-)

-- 
Aur?lien DESBRI?RES
Run free! Run GNU.ORG

From report at bugs.python.org  Sun Jun  9 18:05:28 2013
From: report at bugs.python.org (A.M. Kuchling)
Date: Sun, 09 Jun 2013 16:05:28 +0000
Subject: [docs] [issue14015] surrogateescape largely missing from
	documentation
In-Reply-To: <1329245790.15.0.430373154575.issue14015@psf.upfronthosting.co.za>
Message-ID: <1370793928.47.0.485055115179.issue14015@psf.upfronthosting.co.za>


A.M. Kuchling added the comment:

Here's a proposed patch that touches the Sphinx documentation and a docstring in codecs.py.  The text is slightly revised from my current revisions to the Unicode howto.

help(open) says "See the documentation for codecs.register for a list of the permitted encoding error strings".  This is strictly correct: the Sphinx documentation features this info.  But help(codecs.register) doesn't; it's more helpful to look at help(codecs.Codec).  

So maybe the docstring for open() should say: "See help(codecs.Codec) for a list of the permitted..." instead.

----------
Added file: http://bugs.python.org/file30514/patch14015.txt

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

From report at bugs.python.org  Sun Jun  9 18:26:50 2013
From: report at bugs.python.org (Eli Bendersky)
Date: Sun, 09 Jun 2013 16:26:50 +0000
Subject: [docs] [issue17947] Code, test, and doc review for PEP-0435 Enum
In-Reply-To: <1368168600.94.0.409104207023.issue17947@psf.upfronthosting.co.za>
Message-ID: <1370795210.23.0.758850835511.issue17947@psf.upfronthosting.co.za>


Eli Bendersky added the comment:

LGTM.

I suggest you wait for a couple of days to see if others have any critical comments and then commit.

----------

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

From report at bugs.python.org  Sun Jun  9 21:06:51 2013
From: report at bugs.python.org (Zachary Ware)
Date: Sun, 09 Jun 2013 19:06:51 +0000
Subject: [docs] [issue17947] Code, test, and doc review for PEP-0435 Enum
In-Reply-To: <1368168600.94.0.409104207023.issue17947@psf.upfronthosting.co.za>
Message-ID: <1370804811.44.0.267891613738.issue17947@psf.upfronthosting.co.za>


Zachary Ware added the comment:

enum.rst will need to be added to a table of contents page somewhere, I would guess possibly Development Tools (Doc/library/development.rst) or maybe Data Types (Doc/library/datatypes.rst).  I would trust almost anybody else's opinion over mine on where it should go, though :)

----------

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

From report at bugs.python.org  Mon Jun 10 04:03:00 2013
From: report at bugs.python.org (icedream91)
Date: Mon, 10 Jun 2013 02:03:00 +0000
Subject: [docs] [issue18177] Typo in Documents
Message-ID: <1370829780.84.0.0627044566719.issue18177@psf.upfronthosting.co.za>


New submission from icedream91:

In library.pdf file(Release 3.3.2, June 09, 2013), I found a typo in page 149: I think the quotation marks are wrong in "datetime.isoformat(sep=?T?)" sentence, they should both be "'".
But it's right in online documents (http://docs.python.org/3/library/datetime.html#datetime.datetime.isoformat).

Thanks.

----------
assignee: docs at python
components: Documentation
messages: 190882
nosy: docs at python, icedream91
priority: normal
severity: normal
status: open
title: Typo in Documents
versions: Python 3.3

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

From report at bugs.python.org  Mon Jun 10 12:24:29 2013
From: report at bugs.python.org (Jonas H.)
Date: Mon, 10 Jun 2013 10:24:29 +0000
Subject: [docs] [issue18179] SMTP.local_hostname is undocumented
Message-ID: <1370859868.96.0.822120662228.issue18179@psf.upfronthosting.co.za>


New submission from Jonas H.:

The Sphinx docs don't contain any explanation for `local_hostname`.

----------
assignee: docs at python
components: Documentation
messages: 190898
nosy: docs at python, jonash
priority: normal
severity: normal
status: open
title: SMTP.local_hostname is undocumented
versions: Python 2.6, 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/issue18179>
_______________________________________

From report at bugs.python.org  Mon Jun 10 13:47:04 2013
From: report at bugs.python.org (Berker Peksag)
Date: Mon, 10 Jun 2013 11:47:04 +0000
Subject: [docs] [issue18179] SMTP.local_hostname is undocumented
In-Reply-To: <1370859868.96.0.822120662228.issue18179@psf.upfronthosting.co.za>
Message-ID: <1370864824.72.0.665337356244.issue18179@psf.upfronthosting.co.za>


Berker Peksag added the comment:

The docstring of the SMTP class says:

"If specified, `local_hostname` is used as the FQDN of the local host.  By default, the local hostname is found using socket.getfqdn()."

See Lib/smtplib.py:226.

----------
nosy: +berker.peksag
versions:  -Python 2.6, Python 3.1, Python 3.2, Python 3.5

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

From report at bugs.python.org  Mon Jun 10 14:48:54 2013
From: report at bugs.python.org (R. David Murray)
Date: Mon, 10 Jun 2013 12:48:54 +0000
Subject: [docs] [issue18179] SMTP.local_hostname is undocumented
In-Reply-To: <1370859868.96.0.822120662228.issue18179@psf.upfronthosting.co.za>
Message-ID: <1370868534.85.0.877963086399.issue18179@psf.upfronthosting.co.za>


R. David Murray added the comment:

SMTP.local_hostname is probably a private attribute of the SMTP class, dating from before we started getting strict about having private attributes start with '_'.  However, I see no reason to keep it private; we might as well just document it, since I'm sure people are using it and there is no reason to expect to want to change its behavior.

----------
components: +email
nosy: +barry, r.david.murray
stage:  -> needs patch
type:  -> enhancement

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

From report at bugs.python.org  Mon Jun 10 16:26:02 2013
From: report at bugs.python.org (A.M. Kuchling)
Date: Mon, 10 Jun 2013 14:26:02 +0000
Subject: [docs] [issue18177] Typo in Documents
In-Reply-To: <1370829780.84.0.0627044566719.issue18177@psf.upfronthosting.co.za>
Message-ID: <1370874362.17.0.368713820114.issue18177@psf.upfronthosting.co.za>


A.M. Kuchling added the comment:

Confirmed.  I think this is a general typographic issue in the PDF documentation.  If I cut-and-paste the datetime.isoformat(sep='T') line from the PDF, the single quotes are pasted as U+2019 RIGHT SINGLE QUOTE.  

Looking at the library.tex file built by "make pdflatex", it contains the ASCII single quotes, so LaTeX is responsible for turning the quotes into smart quotes.

I don't know if this is worth fixing and can see arguments both ways.  The smart quotes are readable and I doubt a reader will be confused and try to actually type them in their source code.  OTOH it's annoying that cut-and-pasting code from the PDFs won't work.

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

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

From report at bugs.python.org  Mon Jun 10 16:38:17 2013
From: report at bugs.python.org (R. David Murray)
Date: Mon, 10 Jun 2013 14:38:17 +0000
Subject: [docs] [issue18177] Typo in Documents
In-Reply-To: <1370829780.84.0.0627044566719.issue18177@psf.upfronthosting.co.za>
Message-ID: <1370875097.58.0.589492361658.issue18177@psf.upfronthosting.co.za>


R. David Murray added the comment:

I presume that tex doesn't do quote-transformation on code blocks (it is not really smart quotes, since IIRC in tex you actually have to specify ` and ' in the correct places yourself).  So perhaps the problem is that the function headers &c aren't being properly marked up as code in the latex output engine of Sphinx?

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

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

From report at bugs.python.org  Mon Jun 10 16:39:00 2013
From: report at bugs.python.org (R. David Murray)
Date: Mon, 10 Jun 2013 14:39:00 +0000
Subject: [docs] [issue18177] Incorect quote marks in code section-headers in
	PDF	version of docs
In-Reply-To: <1370829780.84.0.0627044566719.issue18177@psf.upfronthosting.co.za>
Message-ID: <1370875140.59.0.658130392614.issue18177@psf.upfronthosting.co.za>


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


----------
title: Typo in Documents -> Incorect quote marks in code section-headers in PDF version of docs

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

From report at bugs.python.org  Mon Jun 10 20:51:28 2013
From: report at bugs.python.org (Alexander Belopolsky)
Date: Mon, 10 Jun 2013 18:51:28 +0000
Subject: [docs] [issue18176] Builtins documentation refers to old version of
	UCD.
In-Reply-To: <1370823303.7.0.563688972804.issue18176@psf.upfronthosting.co.za>
Message-ID: <1370890288.27.0.240268861865.issue18176@psf.upfronthosting.co.za>


Alexander Belopolsky added the comment:

This is a trivial change, but I would like someone to review this in case there is a better solution to keep this in sync with unicodedata.unidata_version.

----------
assignee:  -> docs at python
keywords: +needs review
nosy: +docs at python
stage:  -> commit review

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

From report at bugs.python.org  Mon Jun 10 23:22:51 2013
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 10 Jun 2013 21:22:51 +0000
Subject: [docs] [issue18176] Builtins documentation refers to old version of
	UCD.
In-Reply-To: <1370823303.7.0.563688972804.issue18176@psf.upfronthosting.co.za>
Message-ID: <1370899371.64.0.338136045209.issue18176@psf.upfronthosting.co.za>


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


----------
components: +Documentation, Unicode
nosy: +ezio.melotti

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

From report at bugs.python.org  Tue Jun 11 11:46:41 2013
From: report at bugs.python.org (Armin Rigo)
Date: Tue, 11 Jun 2013 09:46:41 +0000
Subject: [docs] [issue18033] Example for Profile Module shows incorrect
	method
In-Reply-To: <1369235558.14.0.532987051887.issue18033@psf.upfronthosting.co.za>
Message-ID: <1370944001.51.0.311573042144.issue18033@psf.upfronthosting.co.za>


Armin Rigo added the comment:

A slightly more complete example that I tested:

http://stackoverflow.com/a/16077568/1556290

----------
nosy: +arigo

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

From report at bugs.python.org  Tue Jun 11 12:11:42 2013
From: report at bugs.python.org (Berker Peksag)
Date: Tue, 11 Jun 2013 10:11:42 +0000
Subject: [docs] [issue18187] Fix broken link in Doc/library/venv.rst
Message-ID: <1370945502.31.0.379254379799.issue18187@psf.upfronthosting.co.za>


New submission from Berker Peksag:

The correct location of the venv module is Lib/venv, not Lib/venv.py.

Attaching a simple patch that fixes the location.

----------
assignee: docs at python
components: Documentation
files: venv-location.diff
keywords: patch
messages: 190958
nosy: berker.peksag, docs at python
priority: normal
severity: normal
status: open
title: Fix broken link in Doc/library/venv.rst
versions: Python 3.3, Python 3.4
Added file: http://bugs.python.org/file30543/venv-location.diff

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

From report at bugs.python.org  Tue Jun 11 20:40:20 2013
From: report at bugs.python.org (Ethan Furman)
Date: Tue, 11 Jun 2013 18:40:20 +0000
Subject: [docs] [issue17947] Code, test, and doc review for PEP-0435 Enum
In-Reply-To: <1368168600.94.0.409104207023.issue17947@psf.upfronthosting.co.za>
Message-ID: <1370976020.25.0.616772240821.issue17947@psf.upfronthosting.co.za>


Ethan Furman added the comment:

Final (hopefully! ;) patch.

I stuck the toc reference in datatypes.

If no more edits are necessary I'll commit on Friday (three days from now).

----------
Added file: http://bugs.python.org/file30548/pep-0435.12.stoneleaf.patch

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

From report at bugs.python.org  Tue Jun 11 23:40:53 2013
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 11 Jun 2013 21:40:53 +0000
Subject: [docs] [issue18187] Fix broken link in Doc/library/venv.rst
In-Reply-To: <1370945502.31.0.379254379799.issue18187@psf.upfronthosting.co.za>
Message-ID: <3bVPlm3xzWz7Ljy@mail.python.org>


Roundup Robot added the comment:

New changeset b1eeda9db91d by Ned Deily in branch '3.3':
Issue #18187: Fix broken link in venv documentation. Patch by Berker Peksag.
http://hg.python.org/cpython/rev/b1eeda9db91d

New changeset e6fc120012e5 by Ned Deily in branch 'default':
Issue #18187: merge from 3.3
http://hg.python.org/cpython/rev/e6fc120012e5

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

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

From report at bugs.python.org  Tue Jun 11 23:41:37 2013
From: report at bugs.python.org (Ned Deily)
Date: Tue, 11 Jun 2013 21:41:37 +0000
Subject: [docs] [issue18187] Fix broken link in Doc/library/venv.rst
In-Reply-To: <1370945502.31.0.379254379799.issue18187@psf.upfronthosting.co.za>
Message-ID: <1370986897.04.0.586035246162.issue18187@psf.upfronthosting.co.za>


Ned Deily added the comment:

Thanks for the patch!

----------
nosy: +ned.deily
resolution:  -> fixed
stage:  -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Wed Jun 12 16:57:31 2013
From: report at bugs.python.org (Ronald Oussoren)
Date: Wed, 12 Jun 2013 14:57:31 +0000
Subject: [docs] [issue17860] subprocess docs lack info how to use output
	result
In-Reply-To: <1367159799.26.0.456231833917.issue17860@psf.upfronthosting.co.za>
Message-ID: <1371049051.09.0.960610724802.issue17860@psf.upfronthosting.co.za>


Ronald Oussoren added the comment:

The attached patch explicitly mentions that stdin/stdout/stderr are opened as binary streams when universal_newlines is False. 

I'm not convinced that adding this text will solve the confusion, subprocess has fairly complex documentation due to the rich API and it is easy to mis information when you don't read carefully. That said, the documentation for check_output (which is likely the most common way to run a command and fetch its output) is already clear about the types of the returned data, both in prose and example code.

----------
nosy: +ronaldoussoren
Added file: http://bugs.python.org/file30562/issue17860.txt

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

From report at bugs.python.org  Wed Jun 12 21:48:48 2013
From: report at bugs.python.org (anatoly techtonik)
Date: Wed, 12 Jun 2013 19:48:48 +0000
Subject: [docs] [issue17860] subprocess docs lack info how to use output
	result
In-Reply-To: <1367159799.26.0.456231833917.issue17860@psf.upfronthosting.co.za>
Message-ID: <1371066528.34.0.588995395805.issue17860@psf.upfronthosting.co.za>


anatoly techtonik added the comment:

The only thing that can save the docs is pictures. Or tables.

          +---------+---------------------------+
          |         | universal_newlines = True |
   +------+---------+---------------------------+
   |Py.2  |   str   |         str               |
   +------+         |                           |
   |Py.3  |  bytes  |         str               |
   +------+---------+---------------------------+

----------

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

From report at bugs.python.org  Thu Jun 13 08:02:19 2013
From: report at bugs.python.org (Ronald Oussoren)
Date: Thu, 13 Jun 2013 06:02:19 +0000
Subject: [docs] [issue17860] subprocess docs lack info how to use output
	result
In-Reply-To: <1367159799.26.0.456231833917.issue17860@psf.upfronthosting.co.za>
Message-ID: <1371103339.82.0.177834978723.issue17860@psf.upfronthosting.co.za>


Ronald Oussoren added the comment:

I don't agree that adding a table/picture is the only thing that can be done, or even that it is a good idea.

IMHO the subprocess documentation is clear enough about the distinction between bytes and string, especially in the section about convenience functions that is right at the top of the page.

----------

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

From report at bugs.python.org  Thu Jun 13 08:20:37 2013
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 13 Jun 2013 06:20:37 +0000
Subject: [docs] [issue17860] subprocess docs lack info how to use output
	result
In-Reply-To: <1367159799.26.0.456231833917.issue17860@psf.upfronthosting.co.za>
Message-ID: <1371104437.18.0.433695740446.issue17860@psf.upfronthosting.co.za>


Ezio Melotti added the comment:

Also in the Python 3 docs we don't compare the current behavior with Python 2.  Ronald patch LGTM.

----------

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

From report at bugs.python.org  Thu Jun 13 08:32:14 2013
From: report at bugs.python.org (Serhiy Storchaka)
Date: Thu, 13 Jun 2013 06:32:14 +0000
Subject: [docs] [issue17860] subprocess docs lack info how to use output
	result
In-Reply-To: <1367159799.26.0.456231833917.issue17860@psf.upfronthosting.co.za>
Message-ID: <1371105134.54.0.725746379358.issue17860@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

LGTM.

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

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

From report at bugs.python.org  Thu Jun 13 10:34:40 2013
From: report at bugs.python.org (Berker Peksag)
Date: Thu, 13 Jun 2013 08:34:40 +0000
Subject: [docs] [issue18179] SMTP.local_hostname is undocumented
In-Reply-To: <1370859868.96.0.822120662228.issue18179@psf.upfronthosting.co.za>
Message-ID: <1371112480.2.0.853378298374.issue18179@psf.upfronthosting.co.za>


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


----------
keywords: +patch
stage: needs patch -> patch review
Added file: http://bugs.python.org/file30572/issue18179.diff

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

From report at bugs.python.org  Thu Jun 13 10:50:55 2013
From: report at bugs.python.org (Ronald Oussoren)
Date: Thu, 13 Jun 2013 08:50:55 +0000
Subject: [docs] [issue17860] subprocess docs lack info how to use output
	result
In-Reply-To: <1367159799.26.0.456231833917.issue17860@psf.upfronthosting.co.za>
Message-ID: <1371113455.64.0.139401073352.issue17860@psf.upfronthosting.co.za>


Changes by Ronald Oussoren <ronaldoussoren at mac.com>:


----------
assignee: docs at python -> ronaldoussoren
stage: needs patch -> commit review

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

From report at bugs.python.org  Thu Jun 13 12:31:52 2013
From: report at bugs.python.org (Martin Panter)
Date: Thu, 13 Jun 2013 10:31:52 +0000
Subject: [docs] [issue8402] Add a function to escape metacharacters in
	glob/fnmatch
In-Reply-To: <1271292687.68.0.249436327738.issue8402@psf.upfronthosting.co.za>
Message-ID: <1371119512.04.0.764330711644.issue8402@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/issue8402>
_______________________________________

From report at bugs.python.org  Thu Jun 13 12:40:42 2013
From: report at bugs.python.org (anatoly techtonik)
Date: Thu, 13 Jun 2013 10:40:42 +0000
Subject: [docs] [issue17860] subprocess docs lack info how to use output
	result
In-Reply-To: <1371104437.18.0.433695740446.issue17860@psf.upfronthosting.co.za>
Message-ID: <CAPkN8xJHTgBoTdQ3PMvrTE8Y=92yDmDXZBxhtDs0DUpCVtcptg@mail.gmail.com>


anatoly techtonik added the comment:

On Thu, Jun 13, 2013 at 9:20 AM, Ezio Melotti <report at bugs.python.org>wrote:

>
> Also in the Python 3 docs we don't compare the current behavior with
> Python 2.
>

That's most unfortunate. Major PITA comes from attempts to port existing
code.

----------

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

From report at bugs.python.org  Thu Jun 13 12:41:38 2013
From: report at bugs.python.org (anatoly techtonik)
Date: Thu, 13 Jun 2013 10:41:38 +0000
Subject: [docs] [issue17860] subprocess docs lack info how to use output
	result
In-Reply-To: <CAPkN8xJHTgBoTdQ3PMvrTE8Y=92yDmDXZBxhtDs0DUpCVtcptg@mail.gmail.com>
Message-ID: <CAPkN8xL=rEXYqbNXoudRb-8kT1uRq6ogoL8_avyB49kcpe5ReQ@mail.gmail.com>


anatoly techtonik added the comment:

_failed_ attempts to port existing code.

----------

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

From report at bugs.python.org  Thu Jun 13 13:16:33 2013
From: report at bugs.python.org (Amaury Forgeot d'Arc)
Date: Thu, 13 Jun 2013 11:16:33 +0000
Subject: [docs] [issue17860] subprocess docs lack info how to use output
	result
In-Reply-To: <1367159799.26.0.456231833917.issue17860@psf.upfronthosting.co.za>
Message-ID: <1371122193.1.0.706055107024.issue17860@psf.upfronthosting.co.za>


Amaury Forgeot d'Arc added the comment:

Surely there are already good places to help with 2->3 transition?
The Library Reference is not such a place.

----------
nosy: +amaury.forgeotdarc

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

From report at bugs.python.org  Fri Jun 14 00:29:20 2013
From: report at bugs.python.org (py.user)
Date: Thu, 13 Jun 2013 22:29:20 +0000
Subject: [docs] [issue18206] There is no license.html on www.python.org
Message-ID: <1371162560.09.0.685782864566.issue18206@psf.upfronthosting.co.za>


New submission from py.user:

[guest at localhost ~]$ python3
Python 3.3.0 (default, Sep 29 2012, 22:07:38)
[GCC 4.7.2 20120921 (Red Hat 4.7.2-2)] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> license()
See http://www.python.org/3.3/license.html
>>>

404


answer from webmaster at python.org:

Hello,

When I use the version of Python distributed by python.org and type "license()" I get the full license text and not the url.

It seems like this might be a change made by Red Hat? Either way, the proper place to discuss issues like this is on the Python bug tracker:

	http://bugs.python.org/

Feel free to report an issue there and the developers can look at it.

This email address is actually for reporting problems with the Python.org website!

All the best,

Michael Foord



in Lib/site.py:
[guest at localhost cpython]$ sed -n '453,456p' Lib/site.py
    builtins.license = _Printer(
        "license", "See http://www.python.org/%.3s/license.html" % sys.version,
        ["LICENSE.txt", "LICENSE"],
        [os.path.join(here, os.pardir), here, os.curdir])
[guest at localhost cpython]$

----------
assignee: docs at python
components: Documentation, Library (Lib)
messages: 191095
nosy: docs at python, py.user
priority: normal
severity: normal
status: open
title: There is no license.html on www.python.org
type: behavior
versions: Python 3.3

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

From report at bugs.python.org  Fri Jun 14 00:30:25 2013
From: report at bugs.python.org (STINNER Victor)
Date: Thu, 13 Jun 2013 22:30:25 +0000
Subject: [docs] [issue18206] There is no license.html on www.python.org
In-Reply-To: <1371162560.09.0.685782864566.issue18206@psf.upfronthosting.co.za>
Message-ID: <1371162625.46.0.35414139686.issue18206@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Jun 14 00:52:34 2013
From: report at bugs.python.org (Georg Brandl)
Date: Thu, 13 Jun 2013 22:52:34 +0000
Subject: [docs] [issue18206] There is no license.html on www.python.org
In-Reply-To: <1371162560.09.0.685782864566.issue18206@psf.upfronthosting.co.za>
Message-ID: <1371163954.66.0.67667616531.issue18206@psf.upfronthosting.co.za>


Georg Brandl added the comment:

This broke because we now have release 3.3.0 instead of 3.3.
But it's easy to add a redirect, which I've done now.

In the future, site.py should be fixed to say 3.3.0 or 3.3.X depending on the current bugfix version.

----------

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

From report at bugs.python.org  Fri Jun 14 01:26:02 2013
From: report at bugs.python.org (R. David Murray)
Date: Thu, 13 Jun 2013 23:26:02 +0000
Subject: [docs] [issue18206] license url in site.py should always use X.Y.Z
	form of	version number
In-Reply-To: <1371162560.09.0.685782864566.issue18206@psf.upfronthosting.co.za>
Message-ID: <1371165962.91.0.496619617311.issue18206@psf.upfronthosting.co.za>


R. David Murray added the comment:

For anyone who wants to work on this: the license URL is printed if only if the license file can't be found.

----------
keywords: +easy
nosy: +r.david.murray
stage:  -> needs patch
title: There is no license.html on www.python.org -> license url in site.py should always use X.Y.Z form of version number
versions: +Python 3.4

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

From report at bugs.python.org  Fri Jun 14 09:31:14 2013
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 14 Jun 2013 07:31:14 +0000
Subject: [docs] [issue17947] Code, test, and doc review for PEP-0435 Enum
In-Reply-To: <1368168600.94.0.409104207023.issue17947@psf.upfronthosting.co.za>
Message-ID: <3bWtm1093QzRhj@mail.python.org>


Roundup Robot added the comment:

New changeset fae92309c3be by Ethan Furman in branch 'default':
Closes issue 17947.  Adds PEP-0435 (Enum, IntEnum) to the stdlib.
http://hg.python.org/cpython/rev/fae92309c3be

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

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

From report at bugs.python.org  Fri Jun 14 09:44:40 2013
From: report at bugs.python.org (Nick Coghlan)
Date: Fri, 14 Jun 2013 07:44:40 +0000
Subject: [docs] [issue17947] Code, test, and doc review for PEP-0435 Enum
In-Reply-To: <1368168600.94.0.409104207023.issue17947@psf.upfronthosting.co.za>
Message-ID: <1371195880.73.0.241305977392.issue17947@psf.upfronthosting.co.za>


Nick Coghlan added the comment:

That commit looks just a touch incomplete...

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

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

From report at bugs.python.org  Fri Jun 14 13:08:34 2013
From: report at bugs.python.org (Ronald Oussoren)
Date: Fri, 14 Jun 2013 11:08:34 +0000
Subject: [docs] [issue12743] C API marshalling doc contains XXX
In-Reply-To: <1313160183.82.0.137409262179.issue12743@psf.upfronthosting.co.za>
Message-ID: <1371208114.59.0.477225283094.issue12743@psf.upfronthosting.co.za>


Ronald Oussoren added the comment:

>From reading the source of Python/marshal.c it seems that the read function's raise an exception on I/O errors, but don't return a specific value (that is, sentence starting with "It appears that" is wrong). 

PyMarshal_ReadLongFromFile calls r_long, this calls r_string without checking for errors and calculates the return value from the buffer passed to r_string. On I/O errors the buffer may not have been filled at all and contains random data (whatever happened to be on the stack).

Likewise for PyMarhal_ReadShortFromFile (through r_short instead of r_long).

r_string does raise an exception on I/O errors or short reads, but reading from FILE* and Python objects.

The most straightforward documentation update would be:

* Remove the entire XXX paragraph

* Add text to the documentation for PyMarshal_ReadLongFromFile and PyMarshal_ReadShortFromFile:  On error sets the appopriate exception (:exc:`EOFError`), but does not return a specific value. Use :func:`PyErr_Occurred` to check for errors.

----------
nosy: +ronaldoussoren

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

From report at bugs.python.org  Fri Jun 14 15:48:33 2013
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 14 Jun 2013 13:48:33 +0000
Subject: [docs] [issue15172] Document nasm-2.10.01 as required version for
	openssl
In-Reply-To: <1340569947.64.0.165180800824.issue15172@psf.upfronthosting.co.za>
Message-ID: <3bX37N2BWtz7Ljr@mail.python.org>


Roundup Robot added the comment:

New changeset ee3952965934 by Christian Heimes in branch '3.3':
Issue #15172: Document NASM 2.10+ as requirement for building OpenSSL 1.0.1 on Windows
http://hg.python.org/cpython/rev/ee3952965934

New changeset 1b2cbdc9c1d4 by Christian Heimes in branch 'default':
Issue #15172: Document NASM 2.10+ as requirement for building OpenSSL 1.0.1 on Windows
http://hg.python.org/cpython/rev/1b2cbdc9c1d4

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

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

From report at bugs.python.org  Fri Jun 14 15:50:11 2013
From: report at bugs.python.org (Christian Heimes)
Date: Fri, 14 Jun 2013 13:50:11 +0000
Subject: [docs] [issue15172] Document nasm-2.10.01 as required version for
	openssl
In-Reply-To: <1340569947.64.0.165180800824.issue15172@psf.upfronthosting.co.za>
Message-ID: <1371217811.61.0.4284569107.issue15172@psf.upfronthosting.co.za>


Christian Heimes added the comment:

I got bitten by the bug, too. NASM 2.10 or newer as requirement is now documented in PCbuild/readme.txt.

----------
nosy: +christian.heimes

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

From report at bugs.python.org  Fri Jun 14 16:29:19 2013
From: report at bugs.python.org (Eli Bendersky)
Date: Fri, 14 Jun 2013 14:29:19 +0000
Subject: [docs] [issue17947] Code, test, and doc review for PEP-0435 Enum
In-Reply-To: <1371195880.73.0.241305977392.issue17947@psf.upfronthosting.co.za>
Message-ID: <CAF-Rda99LMHJtPp0bCaVc0_NFqt=e0uNeXwqo7KEWj88B3t_ZA@mail.gmail.com>


Eli Bendersky added the comment:

Ethan, did you forget to "hg add" ?

On Fri, Jun 14, 2013 at 12:44 AM, Nick Coghlan <report at bugs.python.org>wrote:

>
> Nick Coghlan added the comment:
>
> That commit looks just a touch incomplete...
>
> ----------
> resolution: fixed ->
> stage: committed/rejected -> commit review
> status: closed -> open
>
> _______________________________________
> Python tracker <report at bugs.python.org>
> <http://bugs.python.org/issue17947>
> _______________________________________
>

----------

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

From report at bugs.python.org  Fri Jun 14 17:56:15 2013
From: report at bugs.python.org (Ethan Furman)
Date: Fri, 14 Jun 2013 15:56:15 +0000
Subject: [docs] [issue17947] Code, test, and doc review for PEP-0435 Enum
In-Reply-To: <1368168600.94.0.409104207023.issue17947@psf.upfronthosting.co.za>
Message-ID: <1371225375.42.0.887293388546.issue17947@psf.upfronthosting.co.za>


Ethan Furman added the comment:

Well, that made me laugh first thing in the morning!

I had nuked and redone my clone, and yeah, forgot to re-add the files.  :/

Trying again...

Commit message was okay?

----------

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

From report at bugs.python.org  Fri Jun 14 22:24:06 2013
From: report at bugs.python.org (A.M. Kuchling)
Date: Fri, 14 Jun 2013 20:24:06 +0000
Subject: [docs] [issue18179] SMTP.local_hostname is undocumented
In-Reply-To: <1370859868.96.0.822120662228.issue18179@psf.upfronthosting.co.za>
Message-ID: <1371241446.47.0.820903383918.issue18179@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Jun 14 22:42:45 2013
From: report at bugs.python.org (A.M. Kuchling)
Date: Fri, 14 Jun 2013 20:42:45 +0000
Subject: [docs] [issue11352] Update cgi module doc
In-Reply-To: <1298895261.86.0.965235067518.issue11352@psf.upfronthosting.co.za>
Message-ID: <1371242565.23.0.522911876254.issue11352@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Jun 15 01:56:11 2013
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 14 Jun 2013 23:56:11 +0000
Subject: [docs] [issue17947] Code, test, and doc review for PEP-0435 Enum
In-Reply-To: <1368168600.94.0.409104207023.issue17947@psf.upfronthosting.co.za>
Message-ID: <3bXJcV0KVMz7LjQ@mail.python.org>


Roundup Robot added the comment:

New changeset e7a01c7f69fe by Ethan Furman in branch 'default':
Closes issue 17947.  Adds PEP-0435 (Adding an Enum type to the Python standard library).
http://hg.python.org/cpython/rev/e7a01c7f69fe

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

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

From report at bugs.python.org  Sat Jun 15 01:57:43 2013
From: report at bugs.python.org (STINNER Victor)
Date: Fri, 14 Jun 2013 23:57:43 +0000
Subject: [docs] [issue17947] Code, test, and doc review for PEP-0435 Enum
In-Reply-To: <1368168600.94.0.409104207023.issue17947@psf.upfronthosting.co.za>
Message-ID: <1371254262.81.0.793037115769.issue17947@psf.upfronthosting.co.za>


STINNER Victor added the comment:

> New changeset e7a01c7f69fe by Ethan Furman in branch 'default':
> Closes issue 17947.  Adds PEP-0435 (Adding an Enum type to the Python standard library).
> http://hg.python.org/cpython/rev/e7a01c7f69fe

Great job :-)

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

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

From report at bugs.python.org  Sat Jun 15 02:57:57 2013
From: report at bugs.python.org (Nick Coghlan)
Date: Sat, 15 Jun 2013 00:57:57 +0000
Subject: [docs] [issue17947] Code, test, and doc review for PEP-0435 Enum
In-Reply-To: <1368168600.94.0.409104207023.issue17947@psf.upfronthosting.co.za>
Message-ID: <1371257877.1.0.312878137366.issue17947@psf.upfronthosting.co.za>


Nick Coghlan added the comment:

Nicely done - you can also mark the PEP as Final now :)

----------

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

From report at bugs.python.org  Sat Jun 15 06:29:37 2013
From: report at bugs.python.org (py.user)
Date: Sat, 15 Jun 2013 04:29:37 +0000
Subject: [docs] [issue18218] In itertools.count() clarify the starting point
Message-ID: <1371270577.83.0.291953378937.issue18218@psf.upfronthosting.co.za>


New submission from py.user:

http://docs.python.org/3/library/itertools.html#itertools.count
"itertools.count(start=0, step=1)
Make an iterator that returns evenly spaced values starting with n."

starting with start

----------
assignee: docs at python
components: Documentation
files: issue.patch
keywords: patch
messages: 191196
nosy: docs at python, py.user
priority: normal
severity: normal
status: open
title: In itertools.count() clarify the starting point
type: enhancement
versions: Python 3.3, Python 3.4
Added file: http://bugs.python.org/file30596/issue.patch

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

From report at bugs.python.org  Sat Jun 15 07:08:20 2013
From: report at bugs.python.org (py.user)
Date: Sat, 15 Jun 2013 05:08:20 +0000
Subject: [docs] [issue18218] In itertools.count() clarify the starting point
In-Reply-To: <1371270577.83.0.291953378937.issue18218@psf.upfronthosting.co.za>
Message-ID: <1371272900.47.0.700957040298.issue18218@psf.upfronthosting.co.za>


Changes by py.user <bugzilla-mail-box at yandex.ru>:


Added file: http://bugs.python.org/file30597/issue18218.patch

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

From report at bugs.python.org  Sat Jun 15 07:10:51 2013
From: report at bugs.python.org (py.user)
Date: Sat, 15 Jun 2013 05:10:51 +0000
Subject: [docs] [issue18218] In itertools.count() clarify the starting point
In-Reply-To: <1371270577.83.0.291953378937.issue18218@psf.upfronthosting.co.za>
Message-ID: <1371273051.36.0.630619041626.issue18218@psf.upfronthosting.co.za>


Changes by py.user <bugzilla-mail-box at yandex.ru>:


Removed file: http://bugs.python.org/file30596/issue18218.patch

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

From report at bugs.python.org  Sat Jun 15 07:29:55 2013
From: report at bugs.python.org (Eric Snow)
Date: Sat, 15 Jun 2013 05:29:55 +0000
Subject: [docs] [issue14303] Incorrect documentation for socket.py on linux
In-Reply-To: <1331744298.15.0.025379356395.issue14303@psf.upfronthosting.co.za>
Message-ID: <1371274195.31.0.439604233857.issue14303@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Jun 15 08:29:33 2013
From: report at bugs.python.org (py.user)
Date: Sat, 15 Jun 2013 06:29:33 +0000
Subject: [docs] [issue18220] In itertools.islice() make prototype like in
	help()
Message-ID: <1371277773.13.0.969293608974.issue18220@psf.upfronthosting.co.za>


New submission from py.user:

http://docs.python.org/3/library/itertools.html#itertools.islice
" itertools.islice(iterable, stop)
itertools.islice(iterable, start, stop[, step])"

>>> print(itertools.islice.__doc__)
islice(iterable, [start,] stop [, step]) --> islice object
...

----------
assignee: docs at python
components: Documentation
files: issue.patch
keywords: patch
messages: 191199
nosy: docs at python, py.user
priority: normal
severity: normal
status: open
title: In itertools.islice() make prototype like in help()
type: enhancement
versions: Python 3.3, Python 3.4
Added file: http://bugs.python.org/file30599/issue.patch

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

From report at bugs.python.org  Sat Jun 15 08:42:36 2013
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 15 Jun 2013 06:42:36 +0000
Subject: [docs] [issue18220] In itertools.islice() make prototype like in
	help()
In-Reply-To: <1371277773.13.0.969293608974.issue18220@psf.upfronthosting.co.za>
Message-ID: <1371278556.34.0.947381933102.issue18220@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Jun 15 09:29:56 2013
From: report at bugs.python.org (py.user)
Date: Sat, 15 Jun 2013 07:29:56 +0000
Subject: [docs] [issue18220] In itertools.islice() make prototype like in
	help()
In-Reply-To: <1371277773.13.0.969293608974.issue18220@psf.upfronthosting.co.za>
Message-ID: <1371281396.19.0.787483916751.issue18220@psf.upfronthosting.co.za>


py.user added the comment:

same thing with range():
http://docs.python.org/3/library/stdtypes.html?highlight=range#range
http://docs.python.org/3//library/functions.html#func-range

and with slice():
http://docs.python.org/3/library/functions.html?highlight=slice#slice
http://docs.python.org/3//library/functions.html#slice

can't patch them, because comma doesn't get into brackets
"class range([start], stop[, step])"

----------

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

From report at bugs.python.org  Sat Jun 15 09:50:34 2013
From: report at bugs.python.org (R. David Murray)
Date: Sat, 15 Jun 2013 07:50:34 +0000
Subject: [docs] [issue18220] In itertools.islice() make prototype like in
	help()
In-Reply-To: <1371277773.13.0.969293608974.issue18220@psf.upfronthosting.co.za>
Message-ID: <1371282634.46.0.909134309107.issue18220@psf.upfronthosting.co.za>


R. David Murray added the comment:

The documentation is correct, it is the docstrings that need to be changed.

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

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

From report at bugs.python.org  Sat Jun 15 21:01:02 2013
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 15 Jun 2013 19:01:02 +0000
Subject: [docs] [issue14944] Setup & Usage documentation for pydoc,
	idle & 2to3
In-Reply-To: <1338256058.02.0.10025521772.issue14944@psf.upfronthosting.co.za>
Message-ID: <1371322862.79.0.282042060867.issue14944@psf.upfronthosting.co.za>


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


----------
versions: +Python 3.4 -Python 3.2

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

From report at bugs.python.org  Sat Jun 15 21:06:59 2013
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 15 Jun 2013 19:06:59 +0000
Subject: [docs] [issue15457] consistent treatment of generator terminology
In-Reply-To: <1343302676.51.0.168761959505.issue15457@psf.upfronthosting.co.za>
Message-ID: <1371323219.65.0.0735417529213.issue15457@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Jun 15 21:12:42 2013
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 15 Jun 2013 19:12:42 +0000
Subject: [docs] [issue16893] Create IDLE help.txt from Doc/library/idle.rst
In-Reply-To: <1357663512.19.0.739336896498.issue16893@psf.upfronthosting.co.za>
Message-ID: <1371323562.6.0.0186336405958.issue16893@psf.upfronthosting.co.za>


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


----------
assignee: docs at python -> 
versions: +Python 2.7, Python 3.3

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

From report at bugs.python.org  Sat Jun 15 23:19:38 2013
From: report at bugs.python.org (Ezio Melotti)
Date: Sat, 15 Jun 2013 21:19:38 +0000
Subject: [docs] [issue18176] Builtins documentation refers to old version of
	UCD.
In-Reply-To: <1370823303.7.0.563688972804.issue18176@psf.upfronthosting.co.za>
Message-ID: <1371331178.61.0.625105865644.issue18176@psf.upfronthosting.co.za>


Ezio Melotti added the comment:

If all the versions are up to date it shouldn't be difficult to grep for '6.2.0' at the next update, and I would expect people to do it when it happens.  Maybe adding a comment where unidata_version is defined as a remainder to update the rest will suffice.

That said there might be some rst trick to define constants and use them around but I don't know it off the top of my head and if there is, I'm not sure it can be used in links.

----------
nosy: +eric.araujo, georg.brandl
type:  -> enhancement

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

From report at bugs.python.org  Sat Jun 15 23:21:25 2013
From: report at bugs.python.org (Ezio Melotti)
Date: Sat, 15 Jun 2013 21:21:25 +0000
Subject: [docs] [issue18177] Incorect quote marks in code section-headers in
	PDF	version of docs
In-Reply-To: <1370829780.84.0.0627044566719.issue18177@psf.upfronthosting.co.za>
Message-ID: <1371331285.51.0.750790044975.issue18177@psf.upfronthosting.co.za>


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


----------
nosy: +ezio.melotti
type:  -> enhancement
versions: +Python 3.4

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

From report at bugs.python.org  Sun Jun 16 11:59:21 2013
From: report at bugs.python.org (Jordan Szubert)
Date: Sun, 16 Jun 2013 09:59:21 +0000
Subject: [docs] [issue18229] attribute headers of
	http.server.BaseHTTPRequestHandler	sometimes does not exists
Message-ID: <1371376761.5.0.41138715811.issue18229@psf.upfronthosting.co.za>


New submission from Jordan Szubert:

it seems that problem is someone connecting to port 8080 with non-http client, could not find warning in documentation


---fragment of `less access.log`------------
81.172.30.254 - - [16/Jun/2013 11:36:58] "^SBitTorrent protocol^@^@^@^@^@^X^@^Ej
81.172.30.254 - - [16/Jun/2013 11:38:11] "^N<U+008E>^@f????Q;?x<U+0092>b^C^H?A7
81.172.30.254 - - [16/Jun/2013 11:39:22] "^SBitTorrent protocol^@^@^@^@^@^X^@^Ej
81.172.30.254 - - [16/Jun/2013 11:40:35] "?<U+008D>?0?z<U+0093>zr^D<U+009B>2]WQ



Exception happened during processing of request from ('81.172.30.254', 63650)
Traceback (most recent call last):
  File "c:\Python33\lib\socketserver.py", line 306, in _handle_request_noblock
    self.process_request(request, client_address)
  File "c:\Python33\lib\socketserver.py", line 332, in process_request
    self.finish_request(request, client_address)
  File "c:\Python33\lib\socketserver.py", line 345, in finish_request
    self.RequestHandlerClass(request, client_address, self)
  File "c:\Python33\lib\socketserver.py", line 666, in __init__
    self.handle()
  File "c:\Python33\lib\http\server.py", line 400, in handle
    self.handle_one_request()
  File "c:\Python33\lib\http\server.py", line 380, in handle_one_request
    if not self.parse_request():
  File "c:\Python33\lib\http\server.py", line 283, in parse_request
    self.send_error(400, "Bad request version (%r)" % version)
  File "c:\Python33\lib\http\server.py", line 428, in send_error
    self.send_response(code, message)
  File "c:\Python33\lib\http\server.py", line 443, in send_response
    self.log_request(code)
  File "c:\Users\joru\Dropbox\programowanie\demoniszcze\server\_lowerHTTP.py", line 30, in log_request
    xff=req.headers.get('X-Forwarded-For')
AttributeError: '_HNDL_3' object has no attribute 'headers'
# _HNLD_3 derives from http.server.BaseHTTPRequestHandler

----------
assignee: docs at python
components: Documentation
messages: 191264
nosy: docs at python, joru
priority: normal
severity: normal
status: open
title: attribute headers of http.server.BaseHTTPRequestHandler sometimes does not exists
type: behavior
versions: Python 3.3

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

From report at bugs.python.org  Sun Jun 16 19:00:53 2013
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 16 Jun 2013 17:00:53 +0000
Subject: [docs] [issue14015] surrogateescape largely missing from
	documentation
In-Reply-To: <1329245790.15.0.430373154575.issue14015@psf.upfronthosting.co.za>
Message-ID: <3bYMJN5DV4z7Ljb@mail.python.org>


Roundup Robot added the comment:

New changeset 55f611f55952 by Andrew Kuchling in branch '3.3':
Describe 'surrogateescape' in the documentation.
http://hg.python.org/cpython/rev/55f611f55952

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

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

From report at bugs.python.org  Sun Jun 16 19:31:50 2013
From: report at bugs.python.org (Alexander Belopolsky)
Date: Sun, 16 Jun 2013 17:31:50 +0000
Subject: [docs] [issue18176] Builtins documentation refers to old version of
	UCD.
In-Reply-To: <1370823303.7.0.563688972804.issue18176@psf.upfronthosting.co.za>
Message-ID: <1371403910.4.0.818287859625.issue18176@psf.upfronthosting.co.za>


Changes by Alexander Belopolsky <alexander.belopolsky at gmail.com>:


Added file: http://bugs.python.org/file30608/bd092995907c.diff

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

From report at bugs.python.org  Sun Jun 16 19:38:42 2013
From: report at bugs.python.org (Alexander Belopolsky)
Date: Sun, 16 Jun 2013 17:38:42 +0000
Subject: [docs] [issue18176] Builtins documentation refers to old version of
	UCD.
In-Reply-To: <1370823303.7.0.563688972804.issue18176@psf.upfronthosting.co.za>
Message-ID: <1371404322.72.0.560114246685.issue18176@psf.upfronthosting.co.za>


Alexander Belopolsky added the comment:

Here is what grep revealed:

$ find Doc -name \*.rst | xargs grep -n '6\.2\.0'
Doc/library/stdtypes.rst:357:   See http://www.unicode.org/Public/6.2.0/ucd/extracted/DerivedNumericType.txt
Doc/library/unicodedata.rst:18:this database is compiled from the `UCD version 6.2.0
Doc/library/unicodedata.rst:19:<http://www.unicode.org/Public/6.2.0/ucd>`_.
Doc/library/unicodedata.rst:169:.. [#] http://www.unicode.org/Public/6.2.0/ucd/NameAliases.txt
Doc/library/unicodedata.rst:171:.. [#] http://www.unicode.org/Public/6.2.0/ucd/NamedSequences.txt

I added a note next to UNIDATA_VERSION = "6.2.0" in makeunicodedata.py script. The makeunicodedata.py would be a place to put code that would update the docs automatically, but with only two affected files I don't think this is worth the effort.  Chances are at least unicodedata.rst will benefit from a manual review to reflect any substantive changes in the UCD.

----------

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

From report at bugs.python.org  Sun Jun 16 20:10:53 2013
From: report at bugs.python.org (Alexander Belopolsky)
Date: Sun, 16 Jun 2013 18:10:53 +0000
Subject: [docs] [issue18231] What's new in Python should explain what's new
	in UCD
Message-ID: <1371406253.35.0.589040711268.issue18231@psf.upfronthosting.co.za>


New submission from Alexander Belopolsky:

At the minimum, we should refer to unicode.org:

http://www.unicode.org/versions/Unicode6.1.0/#Database_Changes (for Python 3.3),
http://www.unicode.org/versions/Unicode6.2.0/#Database_Changes (for Python 3.4).

We may also want to highlight changes that directly affect python programs.  For example addition of new characters accepted as decimal digits in UCD 6.1.0.

----------
assignee: docs at python
messages: 191278
nosy: belopolsky, docs at python
priority: normal
severity: normal
status: open
title: What's new in Python should explain what's new in UCD
versions: Python 3.3, Python 3.4

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

From report at bugs.python.org  Sun Jun 16 20:20:11 2013
From: report at bugs.python.org (Ezio Melotti)
Date: Sun, 16 Jun 2013 18:20:11 +0000
Subject: [docs] [issue18231] What's new in Python should explain what's new
	in UCD
In-Reply-To: <1371406253.35.0.589040711268.issue18231@psf.upfronthosting.co.za>
Message-ID: <1371406811.19.0.811847649873.issue18231@psf.upfronthosting.co.za>


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


----------
components: +Documentation
keywords: +easy
nosy: +ezio.melotti
stage:  -> needs patch
type:  -> enhancement

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

From report at bugs.python.org  Sun Jun 16 20:28:29 2013
From: report at bugs.python.org (Alexander Belopolsky)
Date: Sun, 16 Jun 2013 18:28:29 +0000
Subject: [docs] [issue18231] What's new in Python should explain what's new
	in UCD
In-Reply-To: <1371406253.35.0.589040711268.issue18231@psf.upfronthosting.co.za>
Message-ID: <1371407309.53.0.132661040119.issue18231@psf.upfronthosting.co.za>


Alexander Belopolsky added the comment:

Here is another change that I think deserves an explicit mention in "What's New":

Python 3.3.2
>>> exec('a\u17B4 = 5')
>>> eval('a\u17B4')
5

Python 3.2.5
>>> exec('a\u17B4 = 5')
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "<string>", line 1
    a? = 5
       ^
SyntaxError: invalid character in identifier

----------

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

From report at bugs.python.org  Mon Jun 17 01:04:01 2013
From: report at bugs.python.org (Alexander Belopolsky)
Date: Sun, 16 Jun 2013 23:04:01 +0000
Subject: [docs] [issue18176] Builtins documentation refers to old version of
	UCD.
In-Reply-To: <1370823303.7.0.563688972804.issue18176@psf.upfronthosting.co.za>
Message-ID: <1371423841.0.0.644454682573.issue18176@psf.upfronthosting.co.za>


Alexander Belopolsky added the comment:

I have found another place where explicit UCD version is used in the docs:

Doc/reference/lexical_analysis.rst:729:.. [#] http://www.unicode.org/Public/6.1.0/ucd/NameAliases.txt

I am not sure how this case should be handled.  The language reference was deliberately written so that it avoids mentioning specific version of Unicode.  For example, PropList.txt in the "Identifiers and keywords" section is linked to the location of the latest published PropList.txt: <http://unicode.org/Public/UNIDATA/PropList.txt>.  This means that as of today, all versions of documentation (3.0 through 3.4) refere to Unicode 6.2.0 version of this file.  This may be misleading for the users of the older python versions.

In the same section, there is a reference top a "non-normative HTML file listing all valid identifier characters for Unicode 4.1."

I would suggest that instead of linking to an external resource we generate a similar table (possibly in ReST format) in makeunicodedata.py and include it with documentation.

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

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

From report at bugs.python.org  Mon Jun 17 03:34:57 2013
From: report at bugs.python.org (Jeff Tratner)
Date: Mon, 17 Jun 2013 01:34:57 +0000
Subject: [docs] [issue18237] unittest.assertRaisesRegex(p) example is wrong
	in docs
Message-ID: <1371432897.82.0.367432880569.issue18237@psf.upfronthosting.co.za>


New submission from Jeff Tratner:

One of the examples for assertRaisesRegex(p) is wrong by one character.

Current is:

self.assertRaisesRegexp(ValueError, 'invalid literal for.*XYZ$',
                        int, 'XYZ')

The $ at the end is wrong because the actual error message is "ValueError: invalid literal for int() with base 10: 'XYZ'" (with a ``'`` at the end).  Two options for fixing.

Option 1 - remove $
self.assertRaisesRegexp(ValueError, 'invalid literal for.*XYZ',
                        int, 'XYZ')
Option 2 - add '

self.assertRaisesRegexp(ValueError, 'invalid literal for.*XYZ\'$',
                        int, 'XYZ')

Same example is shown for assertRaisesRegex, so applies to both.

And for completeness...here's something you can run to see the error [couldn't figure out how to attach two files]:

import unittest
class MyTest(unittest.TestCase):
    def test_example(self):
        # this fails
        self.assertRaisesRegexp(ValueError, 'invalid literal for.*XYZ$',
                        int, 'XYZ')
    def test_option1(self):
        self.assertRaisesRegexp(ValueError, 'invalid literal for.*XYZ',
                                int, 'XYZ')
    def test_option2(self):
        self.assertRaisesRegexp(ValueError, 'invalid literal for.*XYZ\'$',
                                int, 'XYZ')

unittest.main()

----------
assignee: docs at python
components: Documentation
files: unittest.patch
keywords: patch
messages: 191306
nosy: docs at python, jtratner
priority: normal
severity: normal
status: open
title: unittest.assertRaisesRegex(p) example is wrong in docs
versions: Python 2.7, Python 3.1, Python 3.2, Python 3.3, Python 3.4, Python 3.5
Added file: http://bugs.python.org/file30615/unittest.patch

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

From report at bugs.python.org  Mon Jun 17 07:42:25 2013
From: report at bugs.python.org (=?utf-8?q?Martin_v=2E_L=C3=B6wis?=)
Date: Mon, 17 Jun 2013 05:42:25 +0000
Subject: [docs] [issue18231] What's new in Python should explain what's new
	in UCD
In-Reply-To: <1371406253.35.0.589040711268.issue18231@psf.upfronthosting.co.za>
Message-ID: <1371447745.42.0.269740397119.issue18231@psf.upfronthosting.co.za>


Martin v. L?wis added the comment:

Are you sure that the permission to use "KHMER VOWEL INHERENT AQ" in an identifier is worth mentioning? Very few of the Python developers speak Khmer in the first place, let alone have the desire to use it in a Python identifier.

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

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

From report at bugs.python.org  Mon Jun 17 08:52:51 2013
From: report at bugs.python.org (py.user)
Date: Mon, 17 Jun 2013 06:52:51 +0000
Subject: [docs] [issue18220] In itertools.islice() make prototype like in
	help()
In-Reply-To: <1371277773.13.0.969293608974.issue18220@psf.upfronthosting.co.za>
Message-ID: <1371451971.9.0.0131066354272.issue18220@psf.upfronthosting.co.za>


Changes by py.user <bugzilla-mail-box at yandex.ru>:


Removed file: http://bugs.python.org/file30599/issue18220.patch

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

From report at bugs.python.org  Mon Jun 17 08:53:08 2013
From: report at bugs.python.org (py.user)
Date: Mon, 17 Jun 2013 06:53:08 +0000
Subject: [docs] [issue18220] In itertools.islice() make prototype like in
	help()
In-Reply-To: <1371277773.13.0.969293608974.issue18220@psf.upfronthosting.co.za>
Message-ID: <1371451988.13.0.122952774274.issue18220@psf.upfronthosting.co.za>


Changes by py.user <bugzilla-mail-box at yandex.ru>:


Added file: http://bugs.python.org/file30616/issue18220.patch

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

From report at bugs.python.org  Mon Jun 17 08:54:56 2013
From: report at bugs.python.org (py.user)
Date: Mon, 17 Jun 2013 06:54:56 +0000
Subject: [docs] [issue18220] In itertools.islice() make prototype like in
	help()
In-Reply-To: <1371277773.13.0.969293608974.issue18220@psf.upfronthosting.co.za>
Message-ID: <1371452096.0.0.821426307646.issue18220@psf.upfronthosting.co.za>


py.user added the comment:

range and slice are normal in python3.4

----------

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

From report at bugs.python.org  Mon Jun 17 09:04:25 2013
From: report at bugs.python.org (py.user)
Date: Mon, 17 Jun 2013 07:04:25 +0000
Subject: [docs] [issue18239] In itertools docstring update arguments in
	count()	example
Message-ID: <1371452665.1.0.633243797151.issue18239@psf.upfronthosting.co.za>


New submission from py.user:

>>> print(itertools.__doc__)
Functional tools for creating and using iterators.

Infinite iterators:
count([n]) --> n, n+1, n+2, ...

...

----------
assignee: docs at python
components: Documentation, Library (Lib)
files: issue.patch
keywords: patch
messages: 191317
nosy: docs at python, py.user
priority: normal
severity: normal
status: open
title: In itertools docstring update arguments in count() example
type: enhancement
versions: Python 3.3, Python 3.4
Added file: http://bugs.python.org/file30617/issue.patch

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

From report at bugs.python.org  Mon Jun 17 11:08:10 2013
From: report at bugs.python.org (Berker Peksag)
Date: Mon, 17 Jun 2013 09:08:10 +0000
Subject: [docs] [issue18237] unittest.assertRaisesRegex(p) example is wrong
	in docs
In-Reply-To: <1371432897.82.0.367432880569.issue18237@psf.upfronthosting.co.za>
Message-ID: <1371460090.11.0.787211721533.issue18237@psf.upfronthosting.co.za>


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


----------
versions:  -Python 3.1, Python 3.2, Python 3.5

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

From report at bugs.python.org  Mon Jun 17 17:24:02 2013
From: report at bugs.python.org (Jakub Wilk)
Date: Mon, 17 Jun 2013 15:24:02 +0000
Subject: [docs] [issue18243] mktime_tz documentation out-of-date
Message-ID: <1371482642.16.0.49381484414.issue18243@psf.upfronthosting.co.za>


New submission from Jakub Wilk:

email.utils.mktime_tz documentations says:
"Minor deficiency: mktime_tz() interprets the first 8 elements of tuple as a local time and then compensates for the timezone difference. This may yield a slight error around changes in daylight savings time, though not worth worrying about for common use."

But now that issue #14653 is fixed, this is no longer true.

----------
assignee: docs at python
components: Documentation
messages: 191346
nosy: docs at python, jwilk
priority: normal
severity: normal
status: open
title: mktime_tz documentation out-of-date

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

From report at bugs.python.org  Mon Jun 17 17:31:21 2013
From: report at bugs.python.org (R. David Murray)
Date: Mon, 17 Jun 2013 15:31:21 +0000
Subject: [docs] [issue18243] mktime_tz documentation out-of-date
In-Reply-To: <1371482642.16.0.49381484414.issue18243@psf.upfronthosting.co.za>
Message-ID: <1371483081.15.0.321451215564.issue18243@psf.upfronthosting.co.za>


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


----------
components: +email
nosy: +barry, r.david.murray
versions: +Python 3.3, Python 3.4

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

From report at bugs.python.org  Mon Jun 17 18:59:24 2013
From: report at bugs.python.org (Berker Peksag)
Date: Mon, 17 Jun 2013 16:59:24 +0000
Subject: [docs] [issue18206] license url in site.py should always use X.Y.Z
	form of	version number
In-Reply-To: <1371162560.09.0.685782864566.issue18206@psf.upfronthosting.co.za>
Message-ID: <1371488364.07.0.985533926367.issue18206@psf.upfronthosting.co.za>


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


----------
keywords: +patch
nosy: +berker.peksag
stage: needs patch -> patch review
Added file: http://bugs.python.org/file30621/issue18206.diff

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

From report at bugs.python.org  Mon Jun 17 20:21:39 2013
From: report at bugs.python.org (Alexander Belopolsky)
Date: Mon, 17 Jun 2013 18:21:39 +0000
Subject: [docs] [issue18231] What's new in Python should explain what's new
	in UCD
In-Reply-To: <1371406253.35.0.589040711268.issue18231@psf.upfronthosting.co.za>
Message-ID: <1371493299.48.0.0254090066392.issue18231@psf.upfronthosting.co.za>


Alexander Belopolsky added the comment:

MvL> Are you sure that the permission to use "KHMER VOWEL INHERENT AQ"
MvL> in an identifier is worth mentioning?

No, but it is worth mentioning that there are no more substantial changes.  I don't think the change from 6.1.0 to 6.2.0 has any effect on python programs that don't explicitly use unicodedata module. ("Version 6.2 of the Unicode Standard is a special release dedicated to the early publication of the newly encoded Turkish lira sign.") If this is true, I think What's New in 3.4 can just say that.  The change from 6.1.0 to 6.2.0 is more substantial, so I think it is worth mentioning a few effects so that users don't have to wonder what the upgrade means for them.  The effect of the change on Python language and builtins is not at all obvious from the Unicode's own summary of changes.

----------

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

From report at bugs.python.org  Mon Jun 17 20:33:25 2013
From: report at bugs.python.org (py.user)
Date: Mon, 17 Jun 2013 18:33:25 +0000
Subject: [docs] [issue18245] In itertools.groupby() make data plural
Message-ID: <1371494005.37.0.121371971068.issue18245@psf.upfronthosting.co.za>


New submission from py.user:

http://en.wiktionary.org/wiki/data
"data (uncountable) or plural noun"

----------
assignee: docs at python
components: Documentation
files: issue.diff
keywords: patch
messages: 191354
nosy: docs at python, py.user
priority: normal
severity: normal
status: open
title: In itertools.groupby() make data plural
versions: Python 3.3, Python 3.4
Added file: http://bugs.python.org/file30624/issue.diff

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

From report at bugs.python.org  Mon Jun 17 20:35:43 2013
From: report at bugs.python.org (Ned Batchelder)
Date: Mon, 17 Jun 2013 18:35:43 +0000
Subject: [docs] [issue18245] In itertools.groupby() make data plural
In-Reply-To: <1371494005.37.0.121371971068.issue18245@psf.upfronthosting.co.za>
Message-ID: <1371494143.74.0.925661267825.issue18245@psf.upfronthosting.co.za>


Ned Batchelder added the comment:

Please don't make this change.  "Data" is used as a singular collective noun, especially in software contexts.  "Data" as a plural noun sounds archaic, or at best, scientific.

----------
nosy: +nedbat

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

From report at bugs.python.org  Mon Jun 17 20:50:04 2013
From: report at bugs.python.org (R. David Murray)
Date: Mon, 17 Jun 2013 18:50:04 +0000
Subject: [docs] [issue18245] In itertools.groupby() make data plural
In-Reply-To: <1371494005.37.0.121371971068.issue18245@psf.upfronthosting.co.za>
Message-ID: <1371495004.75.0.9644705459.issue18245@psf.upfronthosting.co.za>


R. David Murray added the comment:

Yes, the way it is now is normal written english, regardless of what any older official stylebooks may say :)

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

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

From report at bugs.python.org  Mon Jun 17 21:04:32 2013
From: report at bugs.python.org (Aaron Oakley)
Date: Mon, 17 Jun 2013 19:04:32 +0000
Subject: [docs] [issue17902] Document that _elementtree C API cannot use
	custom	TreeBuilder for iterparse or IncrementalParser
In-Reply-To: <1367614578.64.0.34953241054.issue17902@psf.upfronthosting.co.za>
Message-ID: <1371495872.85.0.585056421771.issue17902@psf.upfronthosting.co.za>


Aaron Oakley added the comment:

So sorry, I just found the emails from the bug tracker in my spam folder. Anyhow, I've now signed the CLA.

----------

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

From report at bugs.python.org  Mon Jun 17 21:17:12 2013
From: report at bugs.python.org (Mark Dickinson)
Date: Mon, 17 Jun 2013 19:17:12 +0000
Subject: [docs] [issue18245] In itertools.groupby() make data plural
In-Reply-To: <1371494005.37.0.121371971068.issue18245@psf.upfronthosting.co.za>
Message-ID: <1371496632.3.0.543155398436.issue18245@psf.upfronthosting.co.za>


Mark Dickinson added the comment:

In any case, the patch only gives half of the correction.  The corrected test would have to be "if *those* data are needed later" rather than "if that data are needed later".

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

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

From report at bugs.python.org  Mon Jun 17 21:18:23 2013
From: report at bugs.python.org (Mark Dickinson)
Date: Mon, 17 Jun 2013 19:18:23 +0000
Subject: [docs] [issue18245] In itertools.groupby() make data plural
In-Reply-To: <1371494005.37.0.121371971068.issue18245@psf.upfronthosting.co.za>
Message-ID: <1371496702.97.0.965157759909.issue18245@psf.upfronthosting.co.za>


Mark Dickinson added the comment:

Bah.  s/test/text.

----------

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

From report at bugs.python.org  Mon Jun 17 22:30:15 2013
From: report at bugs.python.org (Serhiy Storchaka)
Date: Mon, 17 Jun 2013 20:30:15 +0000
Subject: [docs] [issue18239] In itertools docstring update arguments in
	count()	example
In-Reply-To: <1371452665.1.0.633243797151.issue18239@psf.upfronthosting.co.za>
Message-ID: <1371501015.35.0.905374740488.issue18239@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Tue Jun 18 02:55:10 2013
From: report at bugs.python.org (Dave Angel)
Date: Tue, 18 Jun 2013 00:55:10 +0000
Subject: [docs] [issue18249] Incorrect and incomplete help docs for close()
	method
Message-ID: <1371516910.55.0.109427807192.issue18249@psf.upfronthosting.co.za>


New submission from Dave Angel:

Python 3.3.0 (default, Mar  7 2013, 00:24:38) 
[GCC 4.6.3] on linux

q = open('/dev/null')
help(q.close)

the entire output is:
-------------------------------
Help on built-in function close:

close(...)
(END)
-------------------------------

But close() is NOT a built-in, it's a method.

(In Python 2.7.*  the output is:

-------------------------------
Help on built-in function close:

close(...)
    close() -> None or (perhaps) an integer.  Close the file.
    
    Sets data attribute .closed to True.  A closed file cannot be used for
    further I/O operations.  close() may be called more than once without
    error.  Some kinds of file objects (for example, opened by popen())
    may return an exit status upon closing.
(END)
-------------------------------
which is only partially wrong.

----------
assignee: docs at python
components: Documentation
messages: 191382
nosy: DaveA, docs at python
priority: normal
severity: normal
status: open
title: Incorrect and incomplete help docs for close() method

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

From report at bugs.python.org  Tue Jun 18 03:09:13 2013
From: report at bugs.python.org (Christian Heimes)
Date: Tue, 18 Jun 2013 01:09:13 +0000
Subject: [docs] [issue18249] Incorrect and incomplete help docs for close()
	method
In-Reply-To: <1371516910.55.0.109427807192.issue18249@psf.upfronthosting.co.za>
Message-ID: <1371517753.74.0.0500629604228.issue18249@psf.upfronthosting.co.za>


Christian Heimes added the comment:

In fact it is a built-in method without a doc string:

>>> f = open("/dev/null")
>>> f.close
<built-in method close of _io.TextIOWrapper object at 0x7feefaab42f0>
>>> f.close.__doc__

All functions and methods that are implemented in C are referred to as built-in functions. It's an implementation detail.

----------
nosy: +christian.heimes
priority: normal -> low
type:  -> behavior
versions: +Python 3.4

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

From report at bugs.python.org  Tue Jun 18 03:16:44 2013
From: report at bugs.python.org (py.user)
Date: Tue, 18 Jun 2013 01:16:44 +0000
Subject: [docs] [issue18250] In itertools.repeat() object shadows object()
Message-ID: <1371518204.34.0.993952678875.issue18250@psf.upfronthosting.co.za>


New submission from py.user:

>>> object
<class 'object'>
>>>

----------
assignee: docs at python
components: Documentation
files: issue.diff
keywords: patch
messages: 191384
nosy: docs at python, py.user
priority: normal
severity: normal
status: open
title: In itertools.repeat() object shadows object()
type: enhancement
versions: Python 3.4
Added file: http://bugs.python.org/file30630/issue.diff

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

From report at bugs.python.org  Tue Jun 18 08:43:53 2013
From: report at bugs.python.org (Martin Panter)
Date: Tue, 18 Jun 2013 06:43:53 +0000
Subject: [docs] [issue16901] In http.cookiejar.FileCookieJar() the .load()
	and	.revert() methods don't work
In-Reply-To: <1357688221.9.0.622857187739.issue16901@psf.upfronthosting.co.za>
Message-ID: <1371537833.04.0.441505814109.issue16901@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/issue16901>
_______________________________________

From report at bugs.python.org  Tue Jun 18 22:28:38 2013
From: report at bugs.python.org (Terry J. Reedy)
Date: Tue, 18 Jun 2013 20:28:38 +0000
Subject: [docs] [issue1159] os.getenv() not updated after external module
	uses C	putenv()
In-Reply-To: <1189668127.19.0.0258251668017.issue1159@psf.upfronthosting.co.za>
Message-ID: <1371587318.16.0.00558218722651.issue1159@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

The problem is the 'putenv' and 'getenv' appear to be parallel, and seem to be documented as being parallel
"Set the environment variable named key to the string value."
"Return the value of the environment variable key if it exists,"
but they are not. Getenv actually looks up the key in the internal os.environ copy while putenv puts to the actual external environment.

This tripped-up someone today on python-list, who did putenv(key, val); getenv(key) and wondered why putenv seemed to have no effect.

I think the solution for this should be to document the asymmetry by adding ' in os.environ' after 'key' in the getenv doc.

--
putenv should not also update os.environ because one can already do that with "os.environ[key] = value" (as recommended) and because the latter uses putenv *if available* to also update the external environment *if possible*. Note that at the time this system was designed, not all systems supported putenv (and perhaps not 'true' getenv either).

getenv(key) is not the same as os.environ[key] because the former has an optional 'default' parameter that defaults to None. So aside from back-compatibility, I do not think the behavior of existing code should change.

A new parameter might be possible. To implement it, one would have to augment the underlying, undocumented, C-coded (for CPython) os-specific module --  posix, nt, os2, ce -- to define a new os-specific getenv function that parallels the os-specific putenv function.

Adding os.environ.update (or .synchronize) to resynchronize os.environ with the external environment would also require a new os-specific function. Currently, the original os.environ is imported as a *data* attribute of the os-specific module.

However, neither of these changes are needed for python code that used os.environ as intended. I don't think we should necessarily cater to badly written C libraries that modify the enviroment in a way that cannot be easily intercepted or controlled. So after making a doc change, I would be inclined to close this pending a python-ideas discussion that supported a new feature.

----------
assignee:  -> docs at python
components: +Documentation
nosy: +docs at python, terry.reedy
versions: +Python 2.7, Python 3.3, Python 3.4 -Python 2.6

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

From report at bugs.python.org  Wed Jun 19 07:29:27 2013
From: report at bugs.python.org (Emcisq Zhao)
Date: Wed, 19 Jun 2013 05:29:27 +0000
Subject: [docs] [issue18261] Confusing description in Minimal DOM
	implementation
Message-ID: <1371619767.63.0.501848749792.issue18261@psf.upfronthosting.co.za>


New submission from Emcisq Zhao:

Visit http://docs.python.org/2.7/library/xml.dom.minidom.html, please notice the first paragraph. The last sentence is " should consider using the xml.etree.ElementTree module for their XML processing instead". Shouldn't it be " should consider using the xml.dom.minidom module for their XML processing instead"?

----------
assignee: docs at python
components: Documentation
messages: 191444
nosy: docs at python, zhjweizhjwei
priority: normal
severity: normal
status: open
title: Confusing description in Minimal DOM implementation
type: resource usage
versions: Python 2.7

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

From report at bugs.python.org  Wed Jun 19 08:06:31 2013
From: report at bugs.python.org (Ned Deily)
Date: Wed, 19 Jun 2013 06:06:31 +0000
Subject: [docs] [issue18261] Confusing description in Minimal DOM
	implementation
In-Reply-To: <1371619767.63.0.501848749792.issue18261@psf.upfronthosting.co.za>
Message-ID: <1371621991.37.0.963846447023.issue18261@psf.upfronthosting.co.za>


Ned Deily added the comment:

No, the intent really is to suggest using the ElementTree module rather than either minidom or any of the other XML modules in the standard library.  Many people find the ElementTree API easier to understand and to use.

----------
nosy: +ned.deily
resolution:  -> rejected
stage:  -> committed/rejected
status: open -> closed
type: resource usage -> 

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

From report at bugs.python.org  Wed Jun 19 08:19:22 2013
From: report at bugs.python.org (anatoly techtonik)
Date: Wed, 19 Jun 2013 06:19:22 +0000
Subject: [docs] [issue18262] ZipInfo.external_attr are not documented
Message-ID: <1371622762.23.0.278457180872.issue18262@psf.upfronthosting.co.za>


New submission from anatoly techtonik:

zipfile doesn't restore file attributes when extracting. Documentation should at least contain example how to do this manually, because the ony way to do this - through ZipInfo.external_attr is too cryptic.

----------
assignee: docs at python
components: Documentation
messages: 191447
nosy: docs at python, techtonik
priority: normal
severity: normal
status: open
title: ZipInfo.external_attr are not documented
versions: Python 2.6, 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/issue18262>
_______________________________________

From report at bugs.python.org  Wed Jun 19 09:01:18 2013
From: report at bugs.python.org (anatoly techtonik)
Date: Wed, 19 Jun 2013 07:01:18 +0000
Subject: [docs] [issue18262] ZipInfo.external_attr are not documented
In-Reply-To: <1371622762.23.0.278457180872.issue18262@psf.upfronthosting.co.za>
Message-ID: <1371625278.14.0.412624376877.issue18262@psf.upfronthosting.co.za>


anatoly techtonik added the comment:

Here is the doc - 
http://stackoverflow.com/questions/434641/how-do-i-set-permissions-attributes-on-a-file-in-a-zip-file-using-pythons-zip/6297838#6297838

----------

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

From report at bugs.python.org  Wed Jun 19 10:07:25 2013
From: report at bugs.python.org (Amaury Forgeot d'Arc)
Date: Wed, 19 Jun 2013 08:07:25 +0000
Subject: [docs] [issue1159] os.getenv() not updated after external module
	uses C	putenv()
In-Reply-To: <1189668127.19.0.0258251668017.issue1159@psf.upfronthosting.co.za>
Message-ID: <1371629245.61.0.0310463447902.issue1159@psf.upfronthosting.co.za>


Amaury Forgeot d'Arc added the comment:

FYI, PyPy recently got bitten by this: https://bugs.pypy.org/issue1518
A posix.libc_getenv() function could be a solution.

----------
nosy: +amaury.forgeotdarc

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

From report at bugs.python.org  Wed Jun 19 10:24:16 2013
From: report at bugs.python.org (Ronald Oussoren)
Date: Wed, 19 Jun 2013 08:24:16 +0000
Subject: [docs] [issue18262] ZipInfo.external_attr are not documented
In-Reply-To: <1371622762.23.0.278457180872.issue18262@psf.upfronthosting.co.za>
Message-ID: <1371630256.06.0.200559325885.issue18262@psf.upfronthosting.co.za>


Ronald Oussoren added the comment:

I'd be +1 on extending the zipfile API in 3.4 (with a documentation update in older releases as suggested by anatoly):

* Add a method or property to ZipInfo for (un)packing 
  the external_attr field

* Add an keyword argument to Zipfile.extract and Zipfile.extractall that
  toggles restoring file permissions. This should be off by default for
  backward compatibility.

  The code that restores the file permissions should be careful to avoid
  security problems, IMHO it should by default ignore the SUID en SGID
  bits.

----------
components: +Library (Lib)
nosy: +ronaldoussoren
stage:  -> needs patch
type:  -> enhancement
versions:  -Python 3.5

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

From report at bugs.python.org  Wed Jun 19 10:24:51 2013
From: report at bugs.python.org (Ronald Oussoren)
Date: Wed, 19 Jun 2013 08:24:51 +0000
Subject: [docs] [issue18262] ZipInfo.external_attr are not documented
In-Reply-To: <1371622762.23.0.278457180872.issue18262@psf.upfronthosting.co.za>
Message-ID: <1371630291.3.0.96848844939.issue18262@psf.upfronthosting.co.za>


Ronald Oussoren added the comment:

See also #15795

----------

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

From report at bugs.python.org  Wed Jun 19 10:26:50 2013
From: report at bugs.python.org (Ronald Oussoren)
Date: Wed, 19 Jun 2013 08:26:50 +0000
Subject: [docs] [issue18262] ZipInfo.external_attr are not documented
In-Reply-To: <1371622762.23.0.278457180872.issue18262@psf.upfronthosting.co.za>
Message-ID: <1371630410.72.0.536256457964.issue18262@psf.upfronthosting.co.za>


Ronald Oussoren added the comment:

Closing this as a duplicate of #15795 (which already has a patch)

----------
resolution:  -> duplicate
superseder:  -> Zipfile.extractall does not preserve file permissions

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

From report at bugs.python.org  Wed Jun 19 10:44:58 2013
From: report at bugs.python.org (Tshepang Lekhonkhobe)
Date: Wed, 19 Jun 2013 08:44:58 +0000
Subject: [docs] [issue17894] Edits to descriptor howto
In-Reply-To: <1367547112.04.0.920947702161.issue17894@psf.upfronthosting.co.za>
Message-ID: <1371631498.25.0.45331522814.issue17894@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/issue17894>
_______________________________________

From report at bugs.python.org  Wed Jun 19 14:58:46 2013
From: report at bugs.python.org (Jakub Wilk)
Date: Wed, 19 Jun 2013 12:58:46 +0000
Subject: [docs] [issue18263] python.man: no documentation for -b, -X
Message-ID: <1371646726.0.0.233284633234.issue18263@psf.upfronthosting.co.za>


New submission from Jakub Wilk:

The -b and -X options are not documented in Misc/python.man.

----------
assignee: docs at python
components: Documentation
messages: 191463
nosy: docs at python, jwilk
priority: normal
severity: normal
status: open
title: python.man: no documentation for -b, -X

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

From report at bugs.python.org  Wed Jun 19 18:04:56 2013
From: report at bugs.python.org (R. David Murray)
Date: Wed, 19 Jun 2013 16:04:56 +0000
Subject: [docs] [issue18263] python.man: no documentation for -b, -X
In-Reply-To: <1371646726.0.0.233284633234.issue18263@psf.upfronthosting.co.za>
Message-ID: <1371657896.61.0.0221336605072.issue18263@psf.upfronthosting.co.za>


R. David Murray added the comment:

I think we tend to forget that that page exists.

Patches welcome.

----------
keywords: +easy
nosy: +r.david.murray
stage:  -> needs patch
type:  -> behavior

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

From report at bugs.python.org  Wed Jun 19 20:22:03 2013
From: report at bugs.python.org (anatoly techtonik)
Date: Wed, 19 Jun 2013 18:22:03 +0000
Subject: [docs] [issue18262] ZipInfo.external_attr are not documented
In-Reply-To: <1371622762.23.0.278457180872.issue18262@psf.upfronthosting.co.za>
Message-ID: <1371666123.6.0.0353356138225.issue18262@psf.upfronthosting.co.za>


anatoly techtonik added the comment:

3.4+ feature is not a replacement for proper documentation for 2.7-3.4

----------
resolution: duplicate -> 

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

From report at bugs.python.org  Wed Jun 19 20:54:47 2013
From: report at bugs.python.org (Corey Brune)
Date: Wed, 19 Jun 2013 18:54:47 +0000
Subject: [docs] [issue18263] python.man: no documentation for -b, -X
In-Reply-To: <1371646726.0.0.233284633234.issue18263@psf.upfronthosting.co.za>
Message-ID: <1371668087.91.0.649958944675.issue18263@psf.upfronthosting.co.za>


Corey Brune added the comment:

Hello,
I added the two options requested in python.man in the patch file created from "hg diff > python.man.patch".

----------
keywords: +patch
nosy: +cbrune
Added file: http://bugs.python.org/file30649/python.man.patch

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

From report at bugs.python.org  Wed Jun 19 23:03:25 2013
From: report at bugs.python.org (Bernhard Reiter)
Date: Wed, 19 Jun 2013 21:03:25 +0000
Subject: [docs] [issue18267] xmlrpc.client documentation multicall
	example	missleading for division behaviour of python3
Message-ID: <1371675805.26.0.18697522409.issue18267@psf.upfronthosting.co.za>


New submission from Bernhard Reiter:

http://docs.python.org/3.4/library/xmlrpc.client.html as of 2013-06-19 20:35 UTC
has a divide example and the output can misslead the learning reader
towards the new behaviour of python3 with the '/' binary operator for division.

server code:
  def divide(x, y):
    return x/y
client code:
  multicall.divide(7,3)
[..]
  print("7+3=%d, 7-3=%d, 7*3=%d, 7/3=%d" % tuple(result))

The client call results into:
  python3 client.py 
7+3=10, 7-3=4, 7*3=21, 7/3=2

This is missleading because '7/3' is now resulting to a float in python3 (see PEP238).The example probably was copied over from the python2 documentation
where '7/3' result to int. The implicit conversion from float to int is done
in the string formatting.

Proposal replace the print line with
  print("7+3=%d, 7-3=%d, 7*3=%d, 7/3=%g" % tuple(result))
to get 
  7+3=10, 7-3=4, 7*3=21, 7/3=2.33333
or
  print(repr(tuple(result)))
to get
(10, 4, 21, 2.3333333333333335)

----------
assignee: docs at python
components: Documentation
messages: 191495
nosy: ber, docs at python
priority: normal
severity: normal
status: open
title: xmlrpc.client documentation multicall example missleading for division behaviour of python3
versions: Python 3.1, Python 3.2, Python 3.3, Python 3.4

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

From report at bugs.python.org  Thu Jun 20 05:21:33 2013
From: report at bugs.python.org (Senthil Kumaran)
Date: Thu, 20 Jun 2013 03:21:33 +0000
Subject: [docs] [issue18263] python.man: no documentation for -b, -X
In-Reply-To: <1371646726.0.0.233284633234.issue18263@psf.upfronthosting.co.za>
Message-ID: <1371698493.59.0.919637375775.issue18263@psf.upfronthosting.co.za>


Senthil Kumaran added the comment:

Thanks for the patch. Committed these changes in:

changeset dfead0696a71
changeset e26b00adb7ba

----------
nosy: +orsenthil
resolution:  -> fixed
stage: needs patch -> committed/rejected
status: open -> closed
versions: +Python 3.3, Python 3.4

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

From report at bugs.python.org  Thu Jun 20 08:24:57 2013
From: report at bugs.python.org (anatoly techtonik)
Date: Thu, 20 Jun 2013 06:24:57 +0000
Subject: [docs] [issue18269] Clarify which integer is required in os.chmod()
	exception
Message-ID: <1371709497.35.0.24521044136.issue18269@psf.upfronthosting.co.za>


New submission from anatoly techtonik:

(<type 'int'>, '0755')
(<type 'int'>, '0644')
Traceback (most recent call last):
  File "./tools/bootstrap.py", line 185, in extract_zip
    os.fchmod(outfile, unixperm)
TypeError: an integer is required


Here the integer that is required is not `unixperm`, but `outfile`.

----------
assignee: docs at python
components: Documentation
messages: 191502
nosy: docs at python, techtonik
priority: normal
severity: normal
status: open
title: Clarify which integer is required in os.chmod() exception
versions: Python 2.6, 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/issue18269>
_______________________________________

From report at bugs.python.org  Thu Jun 20 10:33:40 2013
From: report at bugs.python.org (Antoine Pitrou)
Date: Thu, 20 Jun 2013 08:33:40 +0000
Subject: [docs] [issue18250] In itertools.repeat() object shadows object()
In-Reply-To: <1371518204.34.0.993952678875.issue18250@psf.upfronthosting.co.za>
Message-ID: <1371717220.19.0.769001200722.issue18250@psf.upfronthosting.co.za>


Antoine Pitrou added the comment:

I don't think this is a problem, since it is only a local variable in a function.

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

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

From report at bugs.python.org  Thu Jun 20 14:32:24 2013
From: report at bugs.python.org (=?utf-8?q?Martin_v=2E_L=C3=B6wis?=)
Date: Thu, 20 Jun 2013 12:32:24 +0000
Subject: [docs] [issue18231] What's new in Python should explain what's new
	in UCD
In-Reply-To: <1371406253.35.0.589040711268.issue18231@psf.upfronthosting.co.za>
Message-ID: <1371731544.74.0.786162353352.issue18231@psf.upfronthosting.co.za>


Martin v. L?wis added the comment:

I don't think anything of this is worth mentioning, except to mention the precise version number of the database. Anybody interested in the consequences of the change should read the announcement of the Unicode Consortium.

----------

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

From report at bugs.python.org  Thu Jun 20 16:55:29 2013
From: report at bugs.python.org (Brett Cannon)
Date: Thu, 20 Jun 2013 14:55:29 +0000
Subject: [docs] [issue18269] Clarify which integer is required in os.chmod()
	exception
In-Reply-To: <1371709497.35.0.24521044136.issue18269@psf.upfronthosting.co.za>
Message-ID: <1371740129.41.0.421821107444.issue18269@psf.upfronthosting.co.za>


Brett Cannon added the comment:

os.chmod is implemented in posixmodule.c and the argument parsing code can be found at http://hg.python.org/cpython/file/3acbb23c73bc/Modules/posixmodule.c#l2605 . You will notice that the argument parsing is specified as "O&i|$O&p". That means the first argument is parsed as a Python object which is passed through a converter function and the second argument is required to be an integer. That converter function can be found at http://hg.python.org/cpython/file/3acbb23c73bc/Modules/posixmodule.c#l681. Looking at that code doesn't suggest that TypeError is raised with that message.

What were the exact arguments you passed into os.chmod() that triggered the exception?

----------
assignee: docs at python -> 
components: +Library (Lib) -Documentation
nosy: +brett.cannon
status: open -> pending
versions:  -Python 2.6, Python 2.7, Python 3.1, Python 3.2, Python 3.3, Python 3.5

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

From report at bugs.python.org  Thu Jun 20 19:35:45 2013
From: report at bugs.python.org (anatoly techtonik)
Date: Thu, 20 Jun 2013 17:35:45 +0000
Subject: [docs] [issue18269] Clarify which integer is required in os.chmod()
	exception
In-Reply-To: <1371709497.35.0.24521044136.issue18269@psf.upfronthosting.co.za>
Message-ID: <1371749745.5.0.987229552237.issue18269@psf.upfronthosting.co.za>


anatoly techtonik added the comment:

>>> v = open("VERSION")
>>> import os
>>> os.fchmod(v, 0664)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: an integer is required

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

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

From report at bugs.python.org  Thu Jun 20 20:35:46 2013
From: report at bugs.python.org (py.user)
Date: Thu, 20 Jun 2013 18:35:46 +0000
Subject: [docs] [issue18272] In itertools recipes there is a typo in
	__builtins__
Message-ID: <1371753346.0.0.321196012203.issue18272@psf.upfronthosting.co.za>


New submission from py.user:

http://docs.python.org/3/library/itertools.html#itertools-recipes
"Like __builtin__.iter(func, sentinel)"

----------
assignee: docs at python
components: Documentation
files: issue.diff
keywords: patch
messages: 191530
nosy: docs at python, py.user
priority: normal
severity: normal
status: open
title: In itertools recipes there is a typo in __builtins__
type: enhancement
versions: Python 3.4
Added file: http://bugs.python.org/file30656/issue.diff

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

From report at bugs.python.org  Thu Jun 20 20:45:36 2013
From: report at bugs.python.org (Zachary Ware)
Date: Thu, 20 Jun 2013 18:45:36 +0000
Subject: [docs] [issue18272] In itertools recipes there is a typo in
	__builtins__
In-Reply-To: <1371753346.0.0.321196012203.issue18272@psf.upfronthosting.co.za>
Message-ID: <1371753936.9.0.651227012947.issue18272@psf.upfronthosting.co.za>


Zachary Ware added the comment:

Being Python 3, it should actually be "builtins" rather than "__builtins__".

Also, imp.rst and importlib.rst have the same issue in the description of reload().

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

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

From report at bugs.python.org  Thu Jun 20 20:46:17 2013
From: report at bugs.python.org (Zachary Ware)
Date: Thu, 20 Jun 2013 18:46:17 +0000
Subject: [docs] [issue18272] In itertools recipes there is a typo in
	__builtins__
In-Reply-To: <1371753346.0.0.321196012203.issue18272@psf.upfronthosting.co.za>
Message-ID: <1371753977.24.0.543821499239.issue18272@psf.upfronthosting.co.za>


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


----------
versions: +Python 3.3

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

From report at bugs.python.org  Thu Jun 20 21:10:27 2013
From: report at bugs.python.org (Brett Cannon)
Date: Thu, 20 Jun 2013 19:10:27 +0000
Subject: [docs] [issue18269] Clarify which integer is required in os.chmod()
	exception
In-Reply-To: <1371709497.35.0.24521044136.issue18269@psf.upfronthosting.co.za>
Message-ID: <1371755427.23.0.892689258705.issue18269@psf.upfronthosting.co.za>


Brett Cannon added the comment:

That's expected with that kind of argument. os.fchmod() and os.chmod() only accept a path as a string or a file descriptor as an integer as specified in the docs: http://docs.python.org/3/library/os.html#os.chmod

----------
resolution:  -> invalid
status: open -> closed

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

From report at bugs.python.org  Fri Jun 21 00:02:59 2013
From: report at bugs.python.org (anatoly techtonik)
Date: Thu, 20 Jun 2013 22:02:59 +0000
Subject: [docs] [issue18269] Clarify which integer is required in os.chmod()
	exception
In-Reply-To: <1371709497.35.0.24521044136.issue18269@psf.upfronthosting.co.za>
Message-ID: <1371765779.3.0.276411925742.issue18269@psf.upfronthosting.co.za>


anatoly techtonik added the comment:

Right. This report is about improving error message. It doesn't say what is expected where. If you have a call like:

    os.fchmod(outfile, unixperm)

it is easy to assume that unixperm is not integer, while in fact the problem is in outfile. This could not be actual for Python 3, but it seems that there is bug with it as well.

>>> v = open("VERSION")
>>> import os
>>> os.fchmod(v, 0664)
  File "<stdin>", line 1
    os.fchmod(v, 0664)
                    ^
SyntaxError: invalid token
>>>

----------
assignee:  -> docs at python
components: +Documentation
resolution: invalid -> 
status: closed -> open
versions: +Python 2.7, Python 3.3

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

From report at bugs.python.org  Fri Jun 21 00:54:33 2013
From: report at bugs.python.org (Brett Cannon)
Date: Thu, 20 Jun 2013 22:54:33 +0000
Subject: [docs] [issue18269] Add new parameter format for converter function
	w/	position number
In-Reply-To: <1371709497.35.0.24521044136.issue18269@psf.upfronthosting.co.za>
Message-ID: <1371768873.47.0.974058702807.issue18269@psf.upfronthosting.co.za>


Brett Cannon added the comment:

That is not a documentation bug (i.e. a problem with what is written at docs.python.org), this is a feature request to try to improve the exception message. That would require adding a new parameter format (http://docs.python.org/3/c-api/arg.html?highlight=pyarg_parse#other-objects) which allows for a converter function which also takes the positional number and/or keyword argument that the converter function was called for.

----------
assignee: docs at python -> 
components: +Interpreter Core -Documentation, Library (Lib)
priority: normal -> low
title: Clarify which integer is required in os.chmod() exception -> Add new parameter format for converter function w/ position number
type:  -> enhancement
versions:  -Python 2.7, Python 3.3

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

From report at bugs.python.org  Fri Jun 21 01:00:28 2013
From: report at bugs.python.org (STINNER Victor)
Date: Thu, 20 Jun 2013 23:00:28 +0000
Subject: [docs] [issue18272] In itertools recipes there is a typo in
	__builtins__
In-Reply-To: <1371753346.0.0.321196012203.issue18272@psf.upfronthosting.co.za>
Message-ID: <1371769228.49.0.955262883974.issue18272@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Jun 21 03:19:29 2013
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 21 Jun 2013 01:19:29 +0000
Subject: [docs] [issue18272] In itertools recipes there is a typo in
	__builtins__
In-Reply-To: <1371753346.0.0.321196012203.issue18272@psf.upfronthosting.co.za>
Message-ID: <3bc29q6lv3zSWv@mail.python.org>


Roundup Robot added the comment:

New changeset b805506b11e0 by Andrew Kuchling in branch '3.3':
Closes #18272: use 'builtins' for 3.3 instead of __builtin__
http://hg.python.org/cpython/rev/b805506b11e0

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

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

From report at bugs.python.org  Fri Jun 21 03:22:06 2013
From: report at bugs.python.org (A.M. Kuchling)
Date: Fri, 21 Jun 2013 01:22:06 +0000
Subject: [docs] [issue18272] In itertools recipes there is a typo in
	__builtins__
In-Reply-To: <1371753346.0.0.321196012203.issue18272@psf.upfronthosting.co.za>
Message-ID: <1371777726.6.0.95485331745.issue18272@psf.upfronthosting.co.za>


A.M. Kuchling added the comment:

Thanks for your report!  I've corrected the error on the 3.3 and 3.4 branches.

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

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

From report at bugs.python.org  Fri Jun 21 03:26:42 2013
From: report at bugs.python.org (A.M. Kuchling)
Date: Fri, 21 Jun 2013 01:26:42 +0000
Subject: [docs] [issue18250] In itertools.repeat() object shadows object()
In-Reply-To: <1371518204.34.0.993952678875.issue18250@psf.upfronthosting.co.za>
Message-ID: <1371778002.01.0.81672038044.issue18250@psf.upfronthosting.co.za>


A.M. Kuchling added the comment:

Thanks for your bug report and patch, but I agree that we can't change this.  The repeat() function really does take 'object' as the keyword argument:

>>> from itertools import *
>>> list(repeat(times=3, object='abc'))
['abc', 'abc', 'abc']
>>> repeat(times=3, element='abc')
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: Required argument 'object' (pos 1) not found

Using 'object' is a minor wart, but I think it's not worth the backward
compatibility risk of changing it.  So the documentation needs to describe the actual keyword argument.

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

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

From report at bugs.python.org  Fri Jun 21 03:40:26 2013
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 21 Jun 2013 01:40:26 +0000
Subject: [docs] [issue18267] xmlrpc.client documentation multicall
	example	missleading for division behaviour of python3
In-Reply-To: <1371675805.26.0.18697522409.issue18267@psf.upfronthosting.co.za>
Message-ID: <3bc2f11vgmzQbC@mail.python.org>


Roundup Robot added the comment:

New changeset 2a3bc6eb2e13 by Andrew Kuchling in branch '3.3':
Closes #18267: use floor division in code example
http://hg.python.org/cpython/rev/2a3bc6eb2e13

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

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

From report at bugs.python.org  Fri Jun 21 13:33:45 2013
From: report at bugs.python.org (A.M. Kuchling)
Date: Fri, 21 Jun 2013 11:33:45 +0000
Subject: [docs] [issue18220] In itertools.islice() make prototype like in
	help()
In-Reply-To: <1371277773.13.0.969293608974.issue18220@psf.upfronthosting.co.za>
Message-ID: <1371814425.95.0.569555638464.issue18220@psf.upfronthosting.co.za>


A.M. Kuchling added the comment:

This bug is entirely too cryptic.  What exactly is the problem you're trying to fix?

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

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

From report at bugs.python.org  Fri Jun 21 14:05:57 2013
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 21 Jun 2013 12:05:57 +0000
Subject: [docs] [issue18239] In itertools docstring update arguments in
	count()	example
In-Reply-To: <1371452665.1.0.633243797151.issue18239@psf.upfronthosting.co.za>
Message-ID: <3bcJWm53dfz7LjQ@mail.python.org>


Roundup Robot added the comment:

New changeset ad0b44cdae41 by Andrew Kuchling in branch '3.3':
Closes #18239: correct description of count() in module docstring
http://hg.python.org/cpython/rev/ad0b44cdae41

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

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

From report at bugs.python.org  Fri Jun 21 14:05:58 2013
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 21 Jun 2013 12:05:58 +0000
Subject: [docs] [issue18218] In itertools.count() clarify the starting point
In-Reply-To: <1371270577.83.0.291953378937.issue18218@psf.upfronthosting.co.za>
Message-ID: <3bcJWn3BFkz7LjQ@mail.python.org>


Roundup Robot added the comment:

New changeset 12478f549ed8 by Andrew Kuchling in branch '3.3':
Closes #18218: use correct variable name for starting point
http://hg.python.org/cpython/rev/12478f549ed8

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

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

From report at bugs.python.org  Fri Jun 21 15:29:13 2013
From: report at bugs.python.org (anatoly techtonik)
Date: Fri, 21 Jun 2013 13:29:13 +0000
Subject: [docs] [issue18269] Add new parameter format for converter function
	w/	position number
In-Reply-To: <1371709497.35.0.24521044136.issue18269@psf.upfronthosting.co.za>
Message-ID: <1371821353.71.0.0261073321963.issue18269@psf.upfronthosting.co.za>


anatoly techtonik added the comment:

This is more sophisticated that I thought. Thank for the explanation.

----------

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

From report at bugs.python.org  Fri Jun 21 16:42:10 2013
From: report at bugs.python.org (Ronald Oussoren)
Date: Fri, 21 Jun 2013 14:42:10 +0000
Subject: [docs] [issue18269] Add new parameter format for converter function
	w/	position number
In-Reply-To: <1371709497.35.0.24521044136.issue18269@psf.upfronthosting.co.za>
Message-ID: <1371825730.24.0.270146840533.issue18269@psf.upfronthosting.co.za>


Ronald Oussoren added the comment:

I don't think that a new parameter format is sufficient. For the message in this call the new parameter isn't even needed, you'd "just" have to ensure that enough information is available in convertsimple to create a more useful message.

That said, that is far from a trivial change, more so because the PyArg_Parse family of functions can parse fairly complicated argument structures in one go (such as using ``PyArg_Parse(args, "(si)", &host, port)`` to unpack the tuple in the first (and only) argument).

----------
nosy: +ronaldoussoren

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

From report at bugs.python.org  Fri Jun 21 17:02:04 2013
From: report at bugs.python.org (A.M. Kuchling)
Date: Fri, 21 Jun 2013 15:02:04 +0000
Subject: [docs] [issue12716] Reorganize os docs for files/dirs/fds
In-Reply-To: <1312900904.97.0.581848486096.issue12716@psf.upfronthosting.co.za>
Message-ID: <1371826924.35.0.201735824982.issue12716@psf.upfronthosting.co.za>


A.M. Kuchling added the comment:

Mike Hoy: a later patch (http://bugs.python.org/issue14626) changed the API in the os module so that the wrappers for *at() functions went away; fchmod() now takes several different forms of argument and calls the correct function under the hood.

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

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

From report at bugs.python.org  Fri Jun 21 17:50:14 2013
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 21 Jun 2013 15:50:14 +0000
Subject: [docs] [issue12716] Reorganize os docs for files/dirs/fds
In-Reply-To: <1312900904.97.0.581848486096.issue12716@psf.upfronthosting.co.za>
Message-ID: <3bcPVY4LgVz7Ljs@mail.python.org>


Roundup Robot added the comment:

New changeset 88edac3bc2fc by Andrew Kuchling in branch 'default':
#12716: reorganize docs for os module a bit
http://hg.python.org/cpython/rev/88edac3bc2fc

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

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

From report at bugs.python.org  Fri Jun 21 17:51:48 2013
From: report at bugs.python.org (A.M. Kuchling)
Date: Fri, 21 Jun 2013 15:51:48 +0000
Subject: [docs] [issue12716] Reorganize os docs for files/dirs/fds
In-Reply-To: <1312900904.97.0.581848486096.issue12716@psf.upfronthosting.co.za>
Message-ID: <1371829908.08.0.557527273688.issue12716@psf.upfronthosting.co.za>


A.M. Kuchling added the comment:

I didn't see any other constants that aren't close to the function they're used with.  Can this issue be closed, or are there other changes to make?

----------

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

From report at bugs.python.org  Fri Jun 21 19:31:33 2013
From: report at bugs.python.org (py.user)
Date: Fri, 21 Jun 2013 17:31:33 +0000
Subject: [docs] [issue18220] In itertools.islice() make prototype like in
	help()
In-Reply-To: <1371277773.13.0.969293608974.issue18220@psf.upfronthosting.co.za>
Message-ID: <1371835893.84.0.35746444083.issue18220@psf.upfronthosting.co.za>


py.user added the comment:

[guest at localhost cpython]$ ./python
Python 3.4.0a0 (default, Jun 22 2013, 04:24:17) 
[GCC 4.7.2 20121109 (Red Hat 4.7.2-8)] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> 
>>> import itertools
>>> print(range.__doc__, slice.__doc__, itertools.islice.__doc__, sep='\n***\n')     
range(stop) -> range object
range(start, stop[, step]) -> range object

Returns a virtual sequence of numbers from start to stop by step.
***
slice(stop)
slice(start, stop[, step])

Create a slice object.  This is used for extended slicing (e.g. a[0:10:2]).
***
islice(iterable, [start,] stop [, step]) --> islice object

Return an iterator whose next() method returns selected values from an
iterable.  If start is specified, will skip all preceding elements;
otherwise, start defaults to zero.  Step defaults to one.  If
specified as another value, step determines how many values are 
skipped between successive calls.  Works like a slice() on a list
but returns an iterator.
>>>

I have updated the patch

----------

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

From report at bugs.python.org  Fri Jun 21 21:55:52 2013
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 21 Jun 2013 19:55:52 +0000
Subject: [docs] [issue18220] Expand itertools.islice docstring signature to
	2 lines
In-Reply-To: <1371277773.13.0.969293608974.issue18220@psf.upfronthosting.co.za>
Message-ID: <1371844552.22.0.797785297748.issue18220@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

The problem with all of range, slice, and islice is that 
[start,] stop [, step] is an impossible signature and needed to be changed.

The actual signature is
start_or_stop, [stop, [step]]
with customized processing to interpret start_or_stop according to the presence of stop (which is not really optional). We suggestion to doc it this was rejected as equally confusing.

In 3.3, we decided to stop trying to force all signatures presented to the user into one line and instead use multiple lines to present what are multiple signatures from a user view. So this alternative was used for range and slice (and other functions).

For islice, the islice entry has
itertools.islice(iterable, stop)
itertools.islice(iterable, start, stop[, step])

Py.user is corrrect in suggesting the same change for islice docstring. I have changed the title to be clearer.

The itertools function table has
islice() 	seq, [start,] stop [, step] 	elements from ...

I thing this should be changed also. A new line for arguments 'seq, stop' would say
'elements from seq[0:stop]'   example 'islice('ABCDEFG', 2) --> A B
Then remove brackets from [start] in the current line.

Py.user: To accept non-trival patches (typos, grammar corrections are trivial) we need a signed contributor agreement
http://www.python.org/psf/contrib/  and
http://www.python.org/psf/contrib/contrib-form/  new electronic form
An '*' will appear after your name here when it is processed.
I presume this will need a real (legal) name on the form, even though not in the tracker user list.

----------
nosy: +terry.reedy
stage:  -> patch review
title: In itertools.islice() make prototype like in help() -> Expand itertools.islice docstring signature to 2 lines

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

From report at bugs.python.org  Fri Jun 21 23:57:46 2013
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 21 Jun 2013 21:57:46 +0000
Subject: [docs] [issue18237] unittest.assertRaisesRegex(p) example is wrong
	in docs
In-Reply-To: <1371432897.82.0.367432880569.issue18237@psf.upfronthosting.co.za>
Message-ID: <1371851866.99.0.712682092943.issue18237@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/issue18237>
_______________________________________

From report at bugs.python.org  Sat Jun 22 01:33:12 2013
From: report at bugs.python.org (Brett Cannon)
Date: Fri, 21 Jun 2013 23:33:12 +0000
Subject: [docs] [issue15693] expose glossary link on hover
In-Reply-To: <1345132108.78.0.567099034623.issue15693@psf.upfronthosting.co.za>
Message-ID: <1371857592.84.0.879958085174.issue15693@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Jun 22 02:44:25 2013
From: report at bugs.python.org (Brett Cannon)
Date: Sat, 22 Jun 2013 00:44:25 +0000
Subject: [docs] [issue18056] Document importlib._bootstrap.NamespaceLoader
In-Reply-To: <1369496751.81.0.344197180241.issue18056@psf.upfronthosting.co.za>
Message-ID: <1371861865.66.0.439209358981.issue18056@psf.upfronthosting.co.za>


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


----------
assignee: barry -> docs at python
keywords: +easy -3.3regression
nosy: +docs at python
versions: +Python 3.4

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

From report at bugs.python.org  Sat Jun 22 10:28:34 2013
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 22 Jun 2013 08:28:34 +0000
Subject: [docs] [issue18280] Documentation is too personalized
Message-ID: <1371889714.5.0.753258621658.issue18280@psf.upfronthosting.co.za>


New submission from Serhiy Storchaka:

Some documentation files contain a number of I/my/me. Looks like they grew from personal modules and personal articles. Perhaps the official documentation needs more depersonalized style. Here is full list of such files:

Doc/c-api/exceptions.rst
Doc/c-api/long.rst
Doc/distutils/builtdist.rst
Doc/extending/extending.rst
Doc/extending/windows.rst
Doc/howto/argparse.rst
Doc/howto/curses.rst
Doc/howto/functional.rst
Doc/howto/regex.rst
Doc/howto/sockets.rst
Doc/howto/urllib2.rst
Doc/install/index.rst
Doc/library/audioop.rst
Doc/library/ctypes.rst
Doc/library/doctest.rst
Doc/library/heapq.rst
Doc/library/numbers.rst
Doc/library/ossaudiodev.rst
Doc/library/tk.rst
Doc/library/unittest.mock-examples.rst
Doc/library/unittest.mock.rst
Doc/reference/introduction.rst
Doc/tutorial/classes.rst

The list doesn't include FAQs where it may be appropriate and whatsnew files.

Andrew Kuchling recently has fixed Doc/howto/unicode.rst for this issue (as part of issue4153).

----------
assignee: docs at python
components: Documentation
messages: 191636
nosy: akuchling, docs at python, eric.araujo, ezio.melotti, georg.brandl, serhiy.storchaka
priority: normal
severity: normal
status: open
title: Documentation is too personalized
versions: Python 2.7, Python 3.3, Python 3.4

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

From report at bugs.python.org  Sat Jun 22 10:31:08 2013
From: report at bugs.python.org (Serhiy Storchaka)
Date: Sat, 22 Jun 2013 08:31:08 +0000
Subject: [docs] [issue18280] Documentation is too personalized
In-Reply-To: <1371889714.5.0.753258621658.issue18280@psf.upfronthosting.co.za>
Message-ID: <1371889867.41.0.893149600917.issue18280@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

Here is a filtered results of

   find * -name '*.rst' -exec egrep -n -w -B1 -A1 'I|me|my' '{}' +

----------
Added file: http://bugs.python.org/file30665/Imemy.grep

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

From report at bugs.python.org  Sat Jun 22 16:41:55 2013
From: report at bugs.python.org (R. David Murray)
Date: Sat, 22 Jun 2013 14:41:55 +0000
Subject: [docs] [issue18206] license url in site.py should always use X.Y.Z
	form of	version number
In-Reply-To: <1371162560.09.0.685782864566.issue18206@psf.upfronthosting.co.za>
Message-ID: <1371912115.6.0.281684250297.issue18206@psf.upfronthosting.co.za>


R. David Murray added the comment:

It would be nice to add a test (guarded by the network resource) that checks that the generated url in license is not a 404.  Would you be interested in tackling that, Berker?

----------

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

From report at bugs.python.org  Sat Jun 22 20:44:35 2013
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 22 Jun 2013 18:44:35 +0000
Subject: [docs] [issue18284] Doc make html: KeyError: 'howto/advocacy'
Message-ID: <1371926675.0.0.253994093951.issue18284@psf.upfronthosting.co.za>


New submission from Terry J. Reedy:

Win 7, make html, 2.7 and 3.3.

writing output... [ 20%] howto/advocacy

Exception occurred:
  File "F:\Python\dev\py33\Doc\tools\sphinx\environment.py", line 1063, in get_toc_for
    toc = self.tocs[docname].deepcopy()
KeyError: 'howto/advocacy'

and process stops. Since update did not change the sphinx install that worked when I last tried this (April), I presume error is in our sources rather than Sphinx.

----------
assignee: docs at python
components: Documentation
files: sphinx-err-xoinkq.log
messages: 191654
nosy: docs at python, eric.araujo, ezio.melotti, georg.brandl, terry.reedy
priority: normal
severity: normal
status: open
title: Doc make html: KeyError: 'howto/advocacy'
type: behavior
versions: Python 2.7, Python 3.3, Python 3.4
Added file: http://bugs.python.org/file30668/sphinx-err-xoinkq.log

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

From report at bugs.python.org  Sat Jun 22 20:51:56 2013
From: report at bugs.python.org (R. David Murray)
Date: Sat, 22 Jun 2013 18:51:56 +0000
Subject: [docs] [issue18284] Doc make html: KeyError: 'howto/advocacy'
In-Reply-To: <1371926675.0.0.253994093951.issue18284@psf.upfronthosting.co.za>
Message-ID: <1371927116.24.0.988877585137.issue18284@psf.upfronthosting.co.za>


R. David Murray added the comment:

I just did a clean doc build on 2.7 (on linux) on 2.7 head without error.  Maybe you need to do a 'make clean' and rebuild?  Our Makefile ought to have a target that just throws away the build dir, instead of throwing away the checked out software as well, but it doesn't.  So instead of make clean you might want to try just deleting the build dir and rebuilding first.

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

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

From report at bugs.python.org  Sat Jun 22 20:53:06 2013
From: report at bugs.python.org (R. David Murray)
Date: Sat, 22 Jun 2013 18:53:06 +0000
Subject: [docs] [issue18284] Doc make html: KeyError: 'howto/advocacy'
In-Reply-To: <1371926675.0.0.253994093951.issue18284@psf.upfronthosting.co.za>
Message-ID: <1371927186.41.0.43651345215.issue18284@psf.upfronthosting.co.za>


R. David Murray added the comment:

Oh, right, the advocacy howto was deleted recently.  So it is almost certainly your stale pickles in the build dir that are the issue.

----------
resolution:  -> invalid
stage:  -> committed/rejected
status: open -> pending

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

From report at bugs.python.org  Sat Jun 22 20:55:09 2013
From: report at bugs.python.org (py.user)
Date: Sat, 22 Jun 2013 18:55:09 +0000
Subject: [docs] [issue18285] In itertools.product() add argument repeat to
	the	docstring
Message-ID: <1371927309.79.0.490510498207.issue18285@psf.upfronthosting.co.za>


New submission from py.user:

>>> import itertools
>>> print(itertools.product.__doc__)
product(*iterables) --> product object

Cartesian product of input iterables.  Equivalent to nested for-loops.
...

----------
assignee: docs at python
components: Documentation
messages: 191658
nosy: docs at python, py.user
priority: normal
severity: normal
status: open
title: In itertools.product() add argument repeat to the docstring
versions: Python 3.3, Python 3.4

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

From report at bugs.python.org  Sat Jun 22 20:55:45 2013
From: report at bugs.python.org (py.user)
Date: Sat, 22 Jun 2013 18:55:45 +0000
Subject: [docs] [issue18285] In itertools.product() add argument repeat to
	the	docstring
In-Reply-To: <1371927309.79.0.490510498207.issue18285@psf.upfronthosting.co.za>
Message-ID: <1371927345.82.0.301327374519.issue18285@psf.upfronthosting.co.za>


Changes by py.user <bugzilla-mail-box at yandex.ru>:


----------
keywords: +patch
Added file: http://bugs.python.org/file30669/issue18285.diff

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

From report at bugs.python.org  Sat Jun 22 20:56:47 2013
From: report at bugs.python.org (py.user)
Date: Sat, 22 Jun 2013 18:56:47 +0000
Subject: [docs] [issue18285] In itertools.product() add argument repeat to
	the	docstring
In-Reply-To: <1371927309.79.0.490510498207.issue18285@psf.upfronthosting.co.za>
Message-ID: <1371927407.97.0.622414803003.issue18285@psf.upfronthosting.co.za>


Changes by py.user <bugzilla-mail-box at yandex.ru>:


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

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

From report at bugs.python.org  Sat Jun 22 22:34:42 2013
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 22 Jun 2013 20:34:42 +0000
Subject: [docs] [issue18284] Doc make html: KeyError: 'howto/advocacy'
In-Reply-To: <1371926675.0.0.253994093951.issue18284@psf.upfronthosting.co.za>
Message-ID: <1371933282.04.0.930606245832.issue18284@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

Nuking build worked. So did, with less re-work, deleting the advocacy doctree and html files ;-). Too bad this is not somehow automated.

----------
status: pending -> closed

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

From report at bugs.python.org  Sat Jun 22 23:00:02 2013
From: report at bugs.python.org (R. David Murray)
Date: Sat, 22 Jun 2013 21:00:02 +0000
Subject: [docs] [issue18284] Doc make html: KeyError: 'howto/advocacy'
In-Reply-To: <1371926675.0.0.253994093951.issue18284@psf.upfronthosting.co.za>
Message-ID: <1371934802.44.0.753790119763.issue18284@psf.upfronthosting.co.za>


R. David Murray added the comment:

Automating it could be a sphinx enhancement request.  Or maybe a bug report.

----------

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

From report at bugs.python.org  Sun Jun 23 01:26:09 2013
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 22 Jun 2013 23:26:09 +0000
Subject: [docs] [issue18285] In itertools.product() add argument repeat to
	the	docstring
In-Reply-To: <1371927309.79.0.490510498207.issue18285@psf.upfronthosting.co.za>
Message-ID: <3bdCZ86cVnz7Lk3@mail.python.org>


Roundup Robot added the comment:

New changeset 1fad7a709aae by Andrew Kuchling in branch '3.3':
Close #18285: add 'repeat' parameter to docstring for product
http://hg.python.org/cpython/rev/1fad7a709aae

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

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

From report at bugs.python.org  Sun Jun 23 01:26:10 2013
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 22 Jun 2013 23:26:10 +0000
Subject: [docs] [issue18220] Expand itertools.islice docstring signature to
	2 lines
In-Reply-To: <1371277773.13.0.969293608974.issue18220@psf.upfronthosting.co.za>
Message-ID: <3bdCZ94s7nz7LjQ@mail.python.org>


Roundup Robot added the comment:

New changeset 7ecca1a98220 by Andrew Kuchling in branch '3.3':
Closes #18220: expand itertools.islice docstring to 2 lines
http://hg.python.org/cpython/rev/7ecca1a98220

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

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

From report at bugs.python.org  Sun Jun 23 02:37:00 2013
From: report at bugs.python.org (A.M. Kuchling)
Date: Sun, 23 Jun 2013 00:37:00 +0000
Subject: [docs] [issue18280] Documentation is too personalized
In-Reply-To: <1371889714.5.0.753258621658.issue18280@psf.upfronthosting.co.za>
Message-ID: <1371947820.73.0.458835500193.issue18280@psf.upfronthosting.co.za>


A.M. Kuchling added the comment:

I've looked through the matches.  "I/O" and the -I command-line switch are false positives.  Many references in the FAQ ("How do I do X?"), but those don't need to be fixed.  

I think personalized references are most problematic when they're expressing uncertainty ("I don't know if we implement all of the spec") or opinions.  Sentences like "When I run this command under Linux, I see..." could be rewritten as "When *you* run this command...", but they don't seem worth fixing to me.

Files with personalized text are:

c-api/exceptions.rst
c-api/long.rst
distutils/builtdist.rst
extending/extending.rst
install/index.rst
library/audioop.rst
library/ctypes.rst
library/doctest.rst
library/heapq.rst
library/imaplib.rst
library/numbers.rst
library/ossaudiodev.rst
library/unittest.mock-examples.rst
library/unittest.mock.rst
reference/introduction.rst
tutorial/classes.rst

----------

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

From report at bugs.python.org  Sun Jun 23 22:12:49 2013
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 23 Jun 2013 20:12:49 +0000
Subject: [docs] [issue18179] SMTP.local_hostname is undocumented
In-Reply-To: <1370859868.96.0.822120662228.issue18179@psf.upfronthosting.co.za>
Message-ID: <3bdlDd0S6fz7Lk5@mail.python.org>


Roundup Robot added the comment:

New changeset 3685d8074203 by R David Murray in branch '3.3':
#18179: document the local_hostname parameter.
http://hg.python.org/cpython/rev/3685d8074203

New changeset b10fae8c185c by R David Murray in branch 'default':
Merge #18179: document the local_hostname parameter.
http://hg.python.org/cpython/rev/b10fae8c185c

New changeset c8914dbe6ead by R David Murray in branch '2.7':
#18179: document the local_hostname parameter.
http://hg.python.org/cpython/rev/c8914dbe6ead

New changeset ffcf46316e1f by R David Murray in branch '3.3':
#18179: reflow paragraphs.
http://hg.python.org/cpython/rev/ffcf46316e1f

New changeset 627e3096340e by R David Murray in branch 'default':
Merge #18179: reflow paragraphs.
http://hg.python.org/cpython/rev/627e3096340e

New changeset 9f1f83d23ec4 by R David Murray in branch '2.7':
#18179: reflow paragraphs.
http://hg.python.org/cpython/rev/9f1f83d23ec4

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

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

From report at bugs.python.org  Sun Jun 23 22:16:19 2013
From: report at bugs.python.org (R. David Murray)
Date: Sun, 23 Jun 2013 20:16:19 +0000
Subject: [docs] [issue18179] SMTP.local_hostname is undocumented
In-Reply-To: <1370859868.96.0.822120662228.issue18179@psf.upfronthosting.co.za>
Message-ID: <1372018579.59.0.0953731390534.issue18179@psf.upfronthosting.co.za>


R. David Murray added the comment:

Thanks Berker.  I edited your patch to (a) use 'Otherwise' instead of 'By default', which is a change from the original docstring that I think makes it clearer, (b) add words about what the local_hostname is used for (the HELO/EHLO commands) and (c) in SMTP_SSL and LMTP, just refer to the SMTP class (like LMTP already did).  I also updated the docstrings similarly.

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

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

From report at bugs.python.org  Sun Jun 23 23:09:23 2013
From: report at bugs.python.org (Bernhard Reiter)
Date: Sun, 23 Jun 2013 21:09:23 +0000
Subject: [docs] [issue18267] xmlrpc.client documentation multicall
	example	missleading for division behaviour of python3
In-Reply-To: <1371675805.26.0.18697522409.issue18267@psf.upfronthosting.co.za>
Message-ID: <1372021763.36.0.750255345973.issue18267@psf.upfronthosting.co.za>


Bernhard Reiter added the comment:

Andrew,
thanks for caring!

Seeing your fix 2a3bc6eb2e13 I believe it does not fully resolv the issue.
Now the code reads
 "return x // y"
  "multicall.divide(7,3)"
and the client prints
 "7/3=2"

I think you probably should change "7/3=" to "7//3=" in the client code as well
to be instructive to learners.

By the way: your change also introduced whitespace around the operator. Now it is the only one out of the four. I guess they should be consistent.

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

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

From report at bugs.python.org  Mon Jun 24 16:44:41 2013
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 24 Jun 2013 14:44:41 +0000
Subject: [docs] [issue15818] multiprocessing documentation of
	Process.exitcode
In-Reply-To: <1346294988.32.0.746763914895.issue15818@psf.upfronthosting.co.za>
Message-ID: <3bfCvX1bYPz7LmF@mail.python.org>


Roundup Robot added the comment:

New changeset f50bbae95bc8 by Richard Oudkerk in branch '2.7':
Issue #15818: Typo in docs.
http://hg.python.org/cpython/rev/f50bbae95bc8

New changeset 3a5e2f1dce5c by Richard Oudkerk in branch '3.3':
Issue #15818: Typo in docs.
http://hg.python.org/cpython/rev/3a5e2f1dce5c

New changeset 4f08d4647f75 by Richard Oudkerk in branch 'default':
Issue #15818: Merge.
http://hg.python.org/cpython/rev/4f08d4647f75

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

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

From report at bugs.python.org  Mon Jun 24 16:45:54 2013
From: report at bugs.python.org (Richard Oudkerk)
Date: Mon, 24 Jun 2013 14:45:54 +0000
Subject: [docs] [issue15818] multiprocessing documentation of
	Process.exitcode
In-Reply-To: <1346294988.32.0.746763914895.issue15818@psf.upfronthosting.co.za>
Message-ID: <1372085154.04.0.65923167012.issue15818@psf.upfronthosting.co.za>


Changes by Richard Oudkerk <shibturn at gmail.com>:


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

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

From report at bugs.python.org  Mon Jun 24 19:20:36 2013
From: report at bugs.python.org (Richard Oudkerk)
Date: Mon, 24 Jun 2013 17:20:36 +0000
Subject: [docs] [issue18277] Queue is empty right after put from the
	same	process/thread
In-Reply-To: <1371814216.9.0.944814100336.issue18277@psf.upfronthosting.co.za>
Message-ID: <1372094436.6.0.519418492393.issue18277@psf.upfronthosting.co.za>


Changes by Richard Oudkerk <shibturn at gmail.com>:


----------
assignee:  -> docs at python
components: +Documentation -IO, Interpreter Core
nosy: +docs at python
resolution:  -> fixed
stage:  -> committed/rejected
status: open -> closed
type: behavior -> 

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

From report at bugs.python.org  Mon Jun 24 23:35:58 2013
From: report at bugs.python.org (Ned Deily)
Date: Mon, 24 Jun 2013 21:35:58 +0000
Subject: [docs] [issue1040439] Missing documentation on how to link with
	libpython
Message-ID: <1372109758.42.0.275960150487.issue1040439@psf.upfronthosting.co.za>


Ned Deily added the comment:

I've now backported the 3.x update to the 2.7 docs in Issue18164 (I hadn't noticed that this issue was still open).  As Eli noted, if any updates are needed to cover Windows, a separate issue should be opened. I'm closing this one.

----------
nosy: +ned.deily
resolution:  -> fixed
stage: patch review -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Tue Jun 25 07:03:53 2013
From: report at bugs.python.org (py.user)
Date: Tue, 25 Jun 2013 05:03:53 +0000
Subject: [docs] [issue18297] In range.sample() correct the ValueError
	message for	negative k
Message-ID: <1372136633.71.0.576354132285.issue18297@psf.upfronthosting.co.za>


New submission from py.user:

>>> random.sample('ABC', -1)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "/usr/lib64/python3.3/random.py", line 302, in sample
    raise ValueError("Sample larger than population")
ValueError: Sample larger than population
>>>

----------
assignee: docs at python
components: Documentation, Library (Lib)
messages: 191832
nosy: docs at python, py.user
priority: normal
severity: normal
status: open
title: In range.sample() correct the ValueError message for negative k
type: enhancement
versions: Python 3.3, Python 3.4

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

From report at bugs.python.org  Tue Jun 25 07:04:19 2013
From: report at bugs.python.org (py.user)
Date: Tue, 25 Jun 2013 05:04:19 +0000
Subject: [docs] [issue18297] In range.sample() correct the ValueError
	message for	negative k
In-Reply-To: <1372136633.71.0.576354132285.issue18297@psf.upfronthosting.co.za>
Message-ID: <1372136659.78.0.924139147546.issue18297@psf.upfronthosting.co.za>


Changes by py.user <bugzilla-mail-box at yandex.ru>:


----------
keywords: +patch
Added file: http://bugs.python.org/file30697/issue18297.diff

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

From report at bugs.python.org  Tue Jun 25 07:14:51 2013
From: report at bugs.python.org (Eric Snow)
Date: Tue, 25 Jun 2013 05:14:51 +0000
Subject: [docs] [issue12633] sys.modules doc entry should reflect
	restrictions
In-Reply-To: <1311569390.98.0.906064511142.issue12633@psf.upfronthosting.co.za>
Message-ID: <1372137291.22.0.26341960245.issue12633@psf.upfronthosting.co.za>


Eric Snow added the comment:

issue17953 addressed part of this.

----------

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

From report at bugs.python.org  Tue Jun 25 09:30:37 2013
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 25 Jun 2013 07:30:37 +0000
Subject: [docs] [issue18297] In range.sample() correct the ValueError
	message for	negative k
In-Reply-To: <1372136633.71.0.576354132285.issue18297@psf.upfronthosting.co.za>
Message-ID: <1372145437.08.0.389490551689.issue18297@psf.upfronthosting.co.za>


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


----------
nosy: +mark.dickinson, rhettinger

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

From report at bugs.python.org  Tue Jun 25 09:35:40 2013
From: report at bugs.python.org (Serhiy Storchaka)
Date: Tue, 25 Jun 2013 07:35:40 +0000
Subject: [docs] [issue18297] In random.sample() correct the ValueError
	message for	negative k
In-Reply-To: <1372136633.71.0.576354132285.issue18297@psf.upfronthosting.co.za>
Message-ID: <1372145740.31.0.677086763998.issue18297@psf.upfronthosting.co.za>


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


----------
title: In range.sample() correct the ValueError message for negative k -> In random.sample() correct the ValueError message for negative k

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

From report at bugs.python.org  Tue Jun 25 10:22:56 2013
From: report at bugs.python.org (Mark Dickinson)
Date: Tue, 25 Jun 2013 08:22:56 +0000
Subject: [docs] [issue18297] In random.sample() correct the ValueError
	message for	negative k
In-Reply-To: <1372136633.71.0.576354132285.issue18297@psf.upfronthosting.co.za>
Message-ID: <1372148576.02.0.345668428287.issue18297@psf.upfronthosting.co.za>


Mark Dickinson added the comment:

This has been proposed and rejected before:  see issue #17388.

----------

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

From report at bugs.python.org  Tue Jun 25 13:14:14 2013
From: report at bugs.python.org (Mark Dickinson)
Date: Tue, 25 Jun 2013 11:14:14 +0000
Subject: [docs] [issue18297] In random.sample() correct the ValueError
	message for	negative k
In-Reply-To: <1372136633.71.0.576354132285.issue18297@psf.upfronthosting.co.za>
Message-ID: <1372158854.87.0.448148827347.issue18297@psf.upfronthosting.co.za>


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


----------
resolution:  -> duplicate
status: open -> closed
superseder:  -> Providing invalid value to random.sample can result in incorrect error message

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

From report at bugs.python.org  Tue Jun 25 19:08:36 2013
From: report at bugs.python.org (py.user)
Date: Tue, 25 Jun 2013 17:08:36 +0000
Subject: [docs] [issue18297] In random.sample() correct the ValueError
	message for	negative k
In-Reply-To: <1372136633.71.0.576354132285.issue18297@psf.upfronthosting.co.za>
Message-ID: <1372180116.76.0.709396433793.issue18297@psf.upfronthosting.co.za>


py.user added the comment:

it was rejected by Raymond Hettinger because the proposed message wasn't informative

----------

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

From report at bugs.python.org  Tue Jun 25 20:58:43 2013
From: report at bugs.python.org (py.user)
Date: Tue, 25 Jun 2013 18:58:43 +0000
Subject: [docs] [issue18301] In itertools.chain.from_iterable() there is no
	cls	argument
Message-ID: <1372186723.21.0.67533324157.issue18301@psf.upfronthosting.co.za>


New submission from py.user:

http://docs.python.org/2/library/itertools.html#itertools.chain.from_iterable

>>> class A:
...   @classmethod
...   def from_iterable(iterables):
...     for it in iterables:
...       for element in it:
...         yield element
... 
>>> A.from_iterable(['ABC', 'DEF'])
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: from_iterable() takes 1 positional argument but 2 were given
>>>

----------
assignee: docs at python
components: Documentation
files: issue.diff
keywords: patch
messages: 191874
nosy: docs at python, py.user
priority: normal
severity: normal
status: open
title: In itertools.chain.from_iterable() there is no cls argument
type: enhancement
versions: Python 3.3, Python 3.4
Added file: http://bugs.python.org/file30702/issue.diff

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

From report at bugs.python.org  Tue Jun 25 20:59:22 2013
From: report at bugs.python.org (py.user)
Date: Tue, 25 Jun 2013 18:59:22 +0000
Subject: [docs] [issue18301] In itertools.chain.from_iterable() there is no
	cls	argument
In-Reply-To: <1372186723.21.0.67533324157.issue18301@psf.upfronthosting.co.za>
Message-ID: <1372186762.59.0.370856530625.issue18301@psf.upfronthosting.co.za>


py.user added the comment:

http://docs.python.org/3/library/itertools.html#itertools.chain.from_iterable

----------

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

From report at bugs.python.org  Tue Jun 25 22:35:31 2013
From: report at bugs.python.org (R. David Murray)
Date: Tue, 25 Jun 2013 20:35:31 +0000
Subject: [docs] [issue18301] In itertools.chain.from_iterable() there is no
	cls	argument
In-Reply-To: <1372186723.21.0.67533324157.issue18301@psf.upfronthosting.co.za>
Message-ID: <1372192531.22.0.322141259374.issue18301@psf.upfronthosting.co.za>


R. David Murray added the comment:

It is implemented as a classmethod, but the "equivalent" code doesn't need to be part of the class all.  I'm not sure what should be done here (say @staticmethod?  Leave the decorator off?).  We should probably see what Raymond thinks.  I lean toward the latter, that's the way it is in the python2 docs, and it doesn't seem to have caused any confusion.

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

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

From report at bugs.python.org  Wed Jun 26 20:47:27 2013
From: report at bugs.python.org (mp)
Date: Wed, 26 Jun 2013 18:47:27 +0000
Subject: [docs] [issue18311] Typo in SSL documentation
Message-ID: <1372272447.34.0.872105507579.issue18311@psf.upfronthosting.co.za>


New submission from mp:

Under http://docs.python.org/3.4/library/ssl.html#ssl.SSLContext.set_npn_protocols

"avertise" should be "advertise".  This is in documentation for both 3.4 and 3.3

----------
assignee: docs at python
components: Documentation
messages: 191913
nosy: docs at python, pfista
priority: normal
severity: normal
status: open
title: Typo in SSL documentation
versions: Python 3.3, Python 3.4

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

From report at bugs.python.org  Wed Jun 26 21:11:54 2013
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 26 Jun 2013 19:11:54 +0000
Subject: [docs] [issue18311] Typo in SSL documentation
In-Reply-To: <1372272447.34.0.872105507579.issue18311@psf.upfronthosting.co.za>
Message-ID: <3bgYkx2hngz7LjZ@mail.python.org>


Roundup Robot added the comment:

New changeset d7ae8a84f443 by R David Murray in branch '3.3':
#18311: fix typo.
http://hg.python.org/cpython/rev/d7ae8a84f443

New changeset 16fe29689f3f by R David Murray in branch 'default':
Merge #18311: fix typo.
http://hg.python.org/cpython/rev/16fe29689f3f

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

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

From report at bugs.python.org  Wed Jun 26 21:12:26 2013
From: report at bugs.python.org (R. David Murray)
Date: Wed, 26 Jun 2013 19:12:26 +0000
Subject: [docs] [issue18311] Typo in SSL documentation
In-Reply-To: <1372272447.34.0.872105507579.issue18311@psf.upfronthosting.co.za>
Message-ID: <1372273946.33.0.244517635989.issue18311@psf.upfronthosting.co.za>


R. David Murray added the comment:

Fixed, thanks.

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

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

From report at bugs.python.org  Thu Jun 27 07:01:01 2013
From: report at bugs.python.org (py.user)
Date: Thu, 27 Jun 2013 05:01:01 +0000
Subject: [docs] [issue18313] In itertools recipes repeatfunc() defines a
	non-keyword	argument as keyword
Message-ID: <1372309261.95.0.7034101172.issue18313@psf.upfronthosting.co.za>


New submission from py.user:

http://docs.python.org/3/library/itertools.html#itertools-recipes
"def repeatfunc(func, times=None, *args):"

>>> repeatfunc(lambda x: x, times=None, 1)
  File "<stdin>", line 1
SyntaxError: non-keyword arg after keyword arg
>>>
>>> repeatfunc(lambda x: x, 1, times=None)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: repeatfunc() got multiple values for argument 'times'
>>>

----------
assignee: docs at python
components: Documentation
messages: 191930
nosy: docs at python, py.user
priority: normal
severity: normal
status: open
title: In itertools recipes repeatfunc() defines a non-keyword argument as keyword
type: enhancement
versions: Python 3.3, Python 3.4

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

From report at bugs.python.org  Thu Jun 27 09:35:56 2013
From: report at bugs.python.org (Ned Deily)
Date: Thu, 27 Jun 2013 07:35:56 +0000
Subject: [docs] [issue18313] In itertools recipes repeatfunc() defines a
	non-keyword	argument as keyword
In-Reply-To: <1372309261.95.0.7034101172.issue18313@psf.upfronthosting.co.za>
Message-ID: <1372318556.45.0.0354022593919.issue18313@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Jun 27 17:05:56 2013
From: report at bugs.python.org (Eric V. Smith)
Date: Thu, 27 Jun 2013 15:05:56 +0000
Subject: [docs] [issue18313] In itertools recipes repeatfunc() defines a
	non-keyword	argument as keyword
In-Reply-To: <1372309261.95.0.7034101172.issue18313@psf.upfronthosting.co.za>
Message-ID: <1372345556.35.0.295077115838.issue18313@psf.upfronthosting.co.za>


Eric V. Smith added the comment:

I'm not sure what you're saying. Given the function definition, the way you're calling it is incorrect, and the error messages explain why.

Are you saying that these ways to call repeatfunc() are documented somewhere that needs fixing? I couldn't find that on the itertools documentation.

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

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

From report at bugs.python.org  Thu Jun 27 17:08:20 2013
From: report at bugs.python.org (Eric V. Smith)
Date: Thu, 27 Jun 2013 15:08:20 +0000
Subject: [docs] [issue18313] In itertools recipes repeatfunc() defines a
	non-keyword	argument as keyword
In-Reply-To: <1372309261.95.0.7034101172.issue18313@psf.upfronthosting.co.za>
Message-ID: <1372345700.33.0.824611832386.issue18313@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Jun 27 17:15:49 2013
From: report at bugs.python.org (py.user)
Date: Thu, 27 Jun 2013 15:15:49 +0000
Subject: [docs] [issue18313] In itertools recipes repeatfunc() defines a
	non-keyword	argument as keyword
In-Reply-To: <1372309261.95.0.7034101172.issue18313@psf.upfronthosting.co.za>
Message-ID: <1372346149.21.0.514239276119.issue18313@psf.upfronthosting.co.za>


py.user added the comment:

it should be: "def repeatfunc(func, times, *args):"
and None for times described in the docstring

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

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

From report at bugs.python.org  Thu Jun 27 17:19:03 2013
From: report at bugs.python.org (py.user)
Date: Thu, 27 Jun 2013 15:19:03 +0000
Subject: [docs] [issue18313] In itertools recipes repeatfunc() defines a
	non-keyword	argument as keyword
In-Reply-To: <1372309261.95.0.7034101172.issue18313@psf.upfronthosting.co.za>
Message-ID: <1372346343.94.0.463630151413.issue18313@psf.upfronthosting.co.za>


Changes by py.user <bugzilla-mail-box at yandex.ru>:


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

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

From report at bugs.python.org  Thu Jun 27 17:25:44 2013
From: report at bugs.python.org (Eric V. Smith)
Date: Thu, 27 Jun 2013 15:25:44 +0000
Subject: [docs] [issue18313] In itertools recipes repeatfunc() defines a
	non-keyword	argument as keyword
In-Reply-To: <1372309261.95.0.7034101172.issue18313@psf.upfronthosting.co.za>
Message-ID: <1372346744.87.0.0687595013439.issue18313@psf.upfronthosting.co.za>


Eric V. Smith added the comment:

I see. You can't call repeatfunc() and specify times with a named argument because of *args. Interesting. I'll let Raymond weigh in.

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

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

From report at bugs.python.org  Thu Jun 27 17:59:58 2013
From: report at bugs.python.org (Terrel Shumway)
Date: Thu, 27 Jun 2013 15:59:58 +0000
Subject: [docs] [issue18315] bufsize parameter not documented in 2.7.5
Message-ID: <1372348798.45.0.272594255655.issue18315@psf.upfronthosting.co.za>


New submission from Terrel Shumway:

for line in fileinput.input(files,inplace,backup,"rU"):
  File "/usr/lib/python2.7/fileinput.py", line 253, in next
    line = self.readline()
  File "/usr/lib/python2.7/fileinput.py", line 346, in readline
    self._buffer = self._file.readlines(self._bufsize)
TypeError: an integer is required

According to the documentation, my code was correct. But somewhere along the line, someone added a 'bufsize' parameter and didn't update the docstrings.

It's an easy fix, but I'll have to investigate when this broke.

----------
assignee: docs at python
components: Documentation
messages: 191952
nosy: Terrel.Shumway, docs at python
priority: normal
severity: normal
status: open
title: bufsize parameter not documented in 2.7.5
type: behavior
versions: Python 2.7

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

From report at bugs.python.org  Thu Jun 27 18:12:57 2013
From: report at bugs.python.org (Terrel Shumway)
Date: Thu, 27 Jun 2013 16:12:57 +0000
Subject: [docs] [issue18315] bufsize parameter not documented in 2.7.5
In-Reply-To: <1372348798.45.0.272594255655.issue18315@psf.upfronthosting.co.za>
Message-ID: <1372349577.24.0.1954413209.issue18315@psf.upfronthosting.co.za>


Terrel Shumway added the comment:

http://hg.python.org/cpython/file/4dbbf322a9df/Lib/fileinput.py

>In the process, I added an optional bufsize argument to the input()
>function and the FileInput class.

----------

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

From report at bugs.python.org  Thu Jun 27 18:19:41 2013
From: report at bugs.python.org (R. David Murray)
Date: Thu, 27 Jun 2013 16:19:41 +0000
Subject: [docs] [issue18315] bufsize parameter not documented in 2.7.5
In-Reply-To: <1372348798.45.0.272594255655.issue18315@psf.upfronthosting.co.za>
Message-ID: <1372349981.49.0.298196758866.issue18315@psf.upfronthosting.co.za>


R. David Murray added the comment:

A quick look at the VCS history indicates bufsize has been in there for a long time.  The sphinx docs are wrong as well.  This is correctly documented in python3, apparently as part of the conversion from [] notation to keyword notation in d143eb624cf5.

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

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

From report at bugs.python.org  Thu Jun 27 18:34:47 2013
From: report at bugs.python.org (Terrel Shumway)
Date: Thu, 27 Jun 2013 16:34:47 +0000
Subject: [docs] [issue18315] bufsize parameter not documented in 2.7.5
In-Reply-To: <1372348798.45.0.272594255655.issue18315@psf.upfronthosting.co.za>
Message-ID: <1372350887.93.0.518397630862.issue18315@psf.upfronthosting.co.za>


Terrel Shumway added the comment:

http://hg.python.org/cpython/file/68c776ba5ea5/Lib/fileinput.py

This is where the incorrect docstrings get added.

----------

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

From report at bugs.python.org  Thu Jun 27 19:21:03 2013
From: report at bugs.python.org (Terrel Shumway)
Date: Thu, 27 Jun 2013 17:21:03 +0000
Subject: [docs] [issue18315] bufsize parameter not documented in 2.7.5
In-Reply-To: <1372348798.45.0.272594255655.issue18315@psf.upfronthosting.co.za>
Message-ID: <1372353662.99.0.100391735215.issue18315@psf.upfronthosting.co.za>


Terrel Shumway added the comment:

Here is a patch against the 2.7 branch.  It will probably also apply to 2.6 if anyone cares.

----------
keywords: +patch
Added file: http://bugs.python.org/file30712/fileinput-document-bufsize.patch

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

From report at bugs.python.org  Thu Jun 27 19:25:00 2013
From: report at bugs.python.org (Terrel Shumway)
Date: Thu, 27 Jun 2013 17:25:00 +0000
Subject: [docs] [issue18315] bufsize parameter not documented in 2.7.5
In-Reply-To: <1372348798.45.0.272594255655.issue18315@psf.upfronthosting.co.za>
Message-ID: <1372353900.71.0.768353636567.issue18315@psf.upfronthosting.co.za>


Terrel Shumway added the comment:

Oops. I messed up, even on such a tiny fix. #:(

----------
Added file: http://bugs.python.org/file30713/fileinput-document-bufsize.patch

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

From report at bugs.python.org  Thu Jun 27 23:54:59 2013
From: report at bugs.python.org (Jakub Wilk)
Date: Thu, 27 Jun 2013 21:54:59 +0000
Subject: [docs] [issue10529] Write argparse i18n howto
In-Reply-To: <1290688089.28.0.749623528369.issue10529@psf.upfronthosting.co.za>
Message-ID: <1372370099.01.0.459280099957.issue10529@psf.upfronthosting.co.za>


Changes by Jakub Wilk <jwilk at jwilk.net>:


----------
nosy: +jwilk

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

From report at bugs.python.org  Fri Jun 28 03:28:13 2013
From: report at bugs.python.org (Andrew Berg)
Date: Fri, 28 Jun 2013 01:28:13 +0000
Subject: [docs] [issue9938] Documentation for argparse interactive use
In-Reply-To: <1285338690.84.0.283413950067.issue9938@psf.upfronthosting.co.za>
Message-ID: <1372382892.91.0.0960670570489.issue9938@psf.upfronthosting.co.za>


Andrew Berg added the comment:

What is the status of this? If the patch looks good, then will it be pushed into 3.4?

----------
nosy: +aberg

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

From report at bugs.python.org  Fri Jun 28 03:41:47 2013
From: report at bugs.python.org (R. David Murray)
Date: Fri, 28 Jun 2013 01:41:47 +0000
Subject: [docs] [issue9938] Documentation for argparse interactive use
In-Reply-To: <1285338690.84.0.283413950067.issue9938@psf.upfronthosting.co.za>
Message-ID: <1372383707.7.0.0459281803557.issue9938@psf.upfronthosting.co.za>


R. David Murray added the comment:

It's great that this patch was provided.  Xuanji, can you submit a contributor agreement, please?

The patch is missing an update to the documentation.

(Really the patch should have been in a separate issue, as requested, since this one is about improving the documentation for the existing released versions.  I guess we'll have to open a new issue for updating the docs in the existing versions).

----------
nosy: +r.david.murray
stage:  -> needs patch
versions: +Python 3.4 -Python 3.2

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

From report at bugs.python.org  Fri Jun 28 06:26:24 2013
From: report at bugs.python.org (Andrew Berg)
Date: Fri, 28 Jun 2013 04:26:24 +0000
Subject: [docs] [issue9938] Documentation for argparse interactive use
In-Reply-To: <1285338690.84.0.283413950067.issue9938@psf.upfronthosting.co.za>
Message-ID: <1372393584.91.0.0264729895372.issue9938@psf.upfronthosting.co.za>


Andrew Berg added the comment:

The patch doesn't work for 3.3 (I think it's just because the line numbers are different), but looking over what the patch does, it looks like parse_known_args will return a value for args if there is an unrecognized argument, which will cause parse_args to call error() (it should raise ArgumentError instead).

----------

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

From report at bugs.python.org  Fri Jun 28 09:48:00 2013
From: report at bugs.python.org (Ethan Furman)
Date: Fri, 28 Jun 2013 07:48:00 +0000
Subject: [docs] [issue9938] Documentation for argparse interactive use
In-Reply-To: <1285338690.84.0.283413950067.issue9938@psf.upfronthosting.co.za>
Message-ID: <1372405680.05.0.758511664241.issue9938@psf.upfronthosting.co.za>


Ethan Furman added the comment:

It doesn't look like xuanji has signed a CLA.

Should we create a new issue, and have someone else create a new patch, and let this issue just be about the docs?

----------
nosy: +ethan.furman

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

From report at bugs.python.org  Fri Jun 28 17:19:51 2013
From: report at bugs.python.org (R. David Murray)
Date: Fri, 28 Jun 2013 15:19:51 +0000
Subject: [docs] [issue9938] Documentation for argparse interactive use
In-Reply-To: <1285338690.84.0.283413950067.issue9938@psf.upfronthosting.co.za>
Message-ID: <1372432791.45.0.716764016092.issue9938@psf.upfronthosting.co.za>


R. David Murray added the comment:

Yes, I think opening a new issue at this point might be a good idea.  The reason is that there are a changes either in place or pending in other issues that involve the parse_know_args code, so a new patch is probably required regardless.

I wish I had time to review and commit all the argparse patches, but so far I haven't gotten to them.  They are on my todo list somewhere, though :)

----------

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

From report at bugs.python.org  Fri Jun 28 20:17:14 2013
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 28 Jun 2013 18:17:14 +0000
Subject: [docs] [issue18280] Documentation is too personalized
In-Reply-To: <1371889714.5.0.753258621658.issue18280@psf.upfronthosting.co.za>
Message-ID: <1372443433.92.0.569404411607.issue18280@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

I find some anonymous I references (Guido? 20 years ago?) off-putting when reading the doc as formal reference.

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

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

From report at bugs.python.org  Fri Jun 28 20:53:53 2013
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 28 Jun 2013 18:53:53 +0000
Subject: [docs] [issue18301] In itertools.chain.from_iterable() there is no
	cls	argument
In-Reply-To: <1372186723.21.0.67533324157.issue18301@psf.upfronthosting.co.za>
Message-ID: <1372445633.7.0.24115891989.issue18301@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

The 2.7 doc says 'Roughly equivalent to' rather than 'Equivalent to'.
The undecorated Python version of from_iterable actually works as an attribute of the Python version of chain: chain.from_iterable = from_iterable. I would just remove the decorator. The entire itertools doc exploits that fact that generator functions are analogous to classes, but it does not work to mix the two in the way that the 3.x chain entry does.

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

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

From report at bugs.python.org  Fri Jun 28 21:52:06 2013
From: report at bugs.python.org (Serhiy Storchaka)
Date: Fri, 28 Jun 2013 19:52:06 +0000
Subject: [docs] [issue18301] In itertools.chain.from_iterable() there is no
	cls	argument
In-Reply-To: <1372186723.21.0.67533324157.issue18301@psf.upfronthosting.co.za>
Message-ID: <1372449126.04.0.769743817039.issue18301@psf.upfronthosting.co.za>


Serhiy Storchaka added the comment:

Perhaps it should be staticmethod, not classmethod.

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

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

From report at bugs.python.org  Fri Jun 28 23:20:36 2013
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 28 Jun 2013 21:20:36 +0000
Subject: [docs] [issue18315] bufsize parameter not documented in 2.7.5
In-Reply-To: <1372348798.45.0.272594255655.issue18315@psf.upfronthosting.co.za>
Message-ID: <1372454436.58.0.653525305948.issue18315@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

If you think you will ever contribute another patch (and we hope you do), and you have not yet submitted a contributor agreement, please do.
http://www.python.org/psf/contrib/contrib-form/ 
http://www.python.org/psf/contrib/
Once processed, a * will appear after your name.
In the meanwhile, I will fix this. (2.6 is security patches only.)

Your patch missed the doc, as opposed to the docstrings, but your report with tracker research was unusually complete. Thanks.

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

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

From report at bugs.python.org  Fri Jun 28 23:27:19 2013
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 28 Jun 2013 21:27:19 +0000
Subject: [docs] [issue18315] bufsize parameter not documented in 2.7.5
In-Reply-To: <1372348798.45.0.272594255655.issue18315@psf.upfronthosting.co.za>
Message-ID: <1372454839.44.0.71323219604.issue18315@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

David, with the addition, this line
    """class FileInput([files[, inplace[, backup[, bufsize[, mode[, openhook]]]]]])
ends at position 83 instead of 80. It should stay on one line. I could reduce that by removing blanks after ,s. Is it better to be a bit too long or a bit too compressed?

----------

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

From report at bugs.python.org  Fri Jun 28 23:34:17 2013
From: report at bugs.python.org (R. David Murray)
Date: Fri, 28 Jun 2013 21:34:17 +0000
Subject: [docs] [issue18315] bufsize parameter not documented in 2.7.5
In-Reply-To: <1372348798.45.0.272594255655.issue18315@psf.upfronthosting.co.za>
Message-ID: <1372455257.35.0.983340914795.issue18315@psf.upfronthosting.co.za>


R. David Murray added the comment:

At 83 it is a judgement call whether to leave it long or wrap it.  I wouldn't compress it.  (Wrapping is done by putting a '\' at the end of the line you want to wrap, if you don't already know that).

----------

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

From report at bugs.python.org  Fri Jun 28 23:35:41 2013
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 28 Jun 2013 21:35:41 +0000
Subject: [docs] [issue18315] bufsize parameter not documented in 2.7.5
In-Reply-To: <1372348798.45.0.272594255655.issue18315@psf.upfronthosting.co.za>
Message-ID: <1372455341.81.0.572949825499.issue18315@psf.upfronthosting.co.za>


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


Added file: http://bugs.python.org/file30727/18315-fileinput-27.diff

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

From report at bugs.python.org  Fri Jun 28 23:50:48 2013
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 28 Jun 2013 21:50:48 +0000
Subject: [docs] [issue18315] Fix fileinput doc and docstrings (add 'buffer'
	in 2.7)
In-Reply-To: <1372348798.45.0.272594255655.issue18315@psf.upfronthosting.co.za>
Message-ID: <1372456247.96.0.989763967138.issue18315@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

I just remembered: the first list of a .py file docstring should be a one line summary of what the callable does. It should not give the signature because (unlike C function currently) help does that for us from the callable itself (using the inspect module). Putting it in the docstring just repeats it. On 3.3.2:

>>> help(fileinput.input)
Help on function input in module fileinput:

input(files=None, inplace=False, backup='', bufsize=0, mode='r', openhook=None)
    input(files=None, inplace=False, backup="", bufsize=0, mode="r", openhook=None)
...
So the 3.x files need correcting also.
For .doc, the signature does need to be present and correct.

----------
title: bufsize parameter not documented in 2.7.5 -> Fix fileinput doc and docstrings (add 'buffer' in 2.7)
versions: +Python 3.3, Python 3.4

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

From report at bugs.python.org  Sat Jun 29 01:00:19 2013
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 28 Jun 2013 23:00:19 +0000
Subject: [docs] [issue18315] Fix fileinput doc and docstrings (add 'buffer'
	in 2.7)
In-Reply-To: <1372348798.45.0.272594255655.issue18315@psf.upfronthosting.co.za>
Message-ID: <3bhtjZ2YMZzRrF@mail.python.org>


Roundup Robot added the comment:

New changeset 80b1c5b25ff0 by Terry Jan Reedy in branch '2.7':
Issue #18315: Improve fileinput docs by adding 'bufsize' where missing and
http://hg.python.org/cpython/rev/80b1c5b25ff0

New changeset 0760b58526ba by Terry Jan Reedy in branch '3.3':
Issue #18315: Improve fileinput docs by adding 'bufsize' where missing and
http://hg.python.org/cpython/rev/0760b58526ba

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

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

From report at bugs.python.org  Sat Jun 29 01:01:29 2013
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 28 Jun 2013 23:01:29 +0000
Subject: [docs] [issue18315] Fix fileinput doc and docstrings (add 'buffer'
	in 2.7)
In-Reply-To: <1372348798.45.0.272594255655.issue18315@psf.upfronthosting.co.za>
Message-ID: <1372460489.18.0.119245747204.issue18315@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

There was one missing 'bufsize' in 3.x also.

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

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

From report at bugs.python.org  Sat Jun 29 09:20:47 2013
From: report at bugs.python.org (paul j3)
Date: Sat, 29 Jun 2013 07:20:47 +0000
Subject: [docs] [issue16418] argparse with many choices can generate
	absurdly long	usage message
In-Reply-To: <1352157111.52.0.432994430995.issue16418@psf.upfronthosting.co.za>
Message-ID: <1372490447.08.0.942606646412.issue16418@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Jun 29 15:05:36 2013
From: report at bugs.python.org (icedream91)
Date: Sat, 29 Jun 2013 13:05:36 +0000
Subject: [docs] [issue18326] Not Clear Docs
Message-ID: <1372511136.61.0.278425078947.issue18326@psf.upfronthosting.co.za>


New submission from icedream91:

I think the documents talking about list.sort() in page 
http://docs.python.org/3/library/stdtypes.html#list.sort is not clear enough. What asterisk means in "sort(*, key=None, reverse=None)", may be cmp argument from Python 2, or anything else? Or it is a typo?

I think document should explain what this asterisk means.

Thanks.

----------
assignee: docs at python
components: Documentation
messages: 192034
nosy: docs at python, icedream91
priority: normal
severity: normal
status: open
title: Not Clear Docs
versions: Python 3.3

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

From report at bugs.python.org  Sat Jun 29 15:27:03 2013
From: report at bugs.python.org (R. David Murray)
Date: Sat, 29 Jun 2013 13:27:03 +0000
Subject: [docs] [issue18326] Not Clear Docs
In-Reply-To: <1372511136.61.0.278425078947.issue18326@psf.upfronthosting.co.za>
Message-ID: <1372512423.8.0.145150226683.issue18326@psf.upfronthosting.co.za>


R. David Murray added the comment:

It means they are keyword-only arguments.  This could be mentioned in the text, with the term 'keyword-only arguments' linked to an appropriate glossary entry (which appears to need to be added).

----------
keywords: +easy
nosy: +r.david.murray
stage:  -> needs patch
versions: +Python 3.4

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

From report at bugs.python.org  Sat Jun 29 15:57:50 2013
From: report at bugs.python.org (Antoine Pitrou)
Date: Sat, 29 Jun 2013 13:57:50 +0000
Subject: [docs] [issue18280] Documentation is too personalized
In-Reply-To: <1371889714.5.0.753258621658.issue18280@psf.upfronthosting.co.za>
Message-ID: <1372514269.87.0.537952307552.issue18280@psf.upfronthosting.co.za>


Antoine Pitrou added the comment:

The sockets tutorial deserves a good overhaul :-)

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

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

From report at bugs.python.org  Sat Jun 29 19:16:43 2013
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 29 Jun 2013 17:16:43 +0000
Subject: [docs] [issue18237] unittest.assertRaisesRegex(p) example is wrong
	in docs
In-Reply-To: <1371432897.82.0.367432880569.issue18237@psf.upfronthosting.co.za>
Message-ID: <3bjM2f2rBgz7Ljj@mail.python.org>


Roundup Robot added the comment:

New changeset 4a714fea95ef by Terry Jan Reedy in branch '2.7':
Issue #18237: Fix assertRaisesRegexp error caought by Jeff Tratner.
http://hg.python.org/cpython/rev/4a714fea95ef

New changeset b3d19f0494e7 by Terry Jan Reedy in branch '3.3':
Issue #18237: Fix assertRaisesRegexp error caought by Jeff Tratner.
http://hg.python.org/cpython/rev/b3d19f0494e7

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

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

From report at bugs.python.org  Sat Jun 29 19:21:52 2013
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 29 Jun 2013 17:21:52 +0000
Subject: [docs] [issue18237] unittest.assertRaisesRegex(p) example is wrong
	in docs
In-Reply-To: <1371432897.82.0.367432880569.issue18237@psf.upfronthosting.co.za>
Message-ID: <1372526512.47.0.384655526442.issue18237@psf.upfronthosting.co.za>


Terry J. Reedy added the comment:

I went with adding ' after changing '...' to "...".

If you think you might ever submit a more substantial patch, and we hope you do, please submit a Contributor Agreement (now optionally electronic). http://www.python.org/psf/contrib/
When processed (a week?), an * will appear after your name.

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

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

From report at bugs.python.org  Sat Jun 29 21:22:51 2013
From: report at bugs.python.org (Demian Brecht)
Date: Sat, 29 Jun 2013 19:22:51 +0000
Subject: [docs] [issue18206] license url in site.py should always use X.Y.Z
	form of	version number
In-Reply-To: <1371162560.09.0.685782864566.issue18206@psf.upfronthosting.co.za>
Message-ID: <1372533771.0.0.243398413852.issue18206@psf.upfronthosting.co.za>


Changes by Demian Brecht <demianbrecht at gmail.com>:


----------
nosy: +dbrecht

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

From report at bugs.python.org  Sat Jun 29 23:44:17 2013
From: report at bugs.python.org (A.M. Kuchling)
Date: Sat, 29 Jun 2013 21:44:17 +0000
Subject: [docs] [issue12716] Reorganize os docs for files/dirs/fds
In-Reply-To: <1312900904.97.0.581848486096.issue12716@psf.upfronthosting.co.za>
Message-ID: <1372542257.15.0.498235995415.issue12716@psf.upfronthosting.co.za>


A.M. Kuchling added the comment:

Closing this issue after a week.  Mike Hoy: thanks for your patch.

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

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

From report at bugs.python.org  Sun Jun 30 08:00:45 2013
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 30 Jun 2013 06:00:45 +0000
Subject: [docs] [issue11945] Adopt and document consistent semantics for
	handling NaN	values in containers
In-Reply-To: <1303962145.0.0.00759154980454.issue11945@psf.upfronthosting.co.za>
Message-ID: <1372572045.83.0.739113323734.issue11945@psf.upfronthosting.co.za>


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


----------
versions: +Python 3.4 -Python 3.2

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

From report at bugs.python.org  Sun Jun 30 08:02:28 2013
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 30 Jun 2013 06:02:28 +0000
Subject: [docs] [issue12211] Better document math.copysign behavior.
In-Reply-To: <1306710150.53.0.509116993934.issue12211@psf.upfronthosting.co.za>
Message-ID: <1372572148.52.0.0503988818376.issue12211@psf.upfronthosting.co.za>


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


----------
versions: +Python 3.4 -Python 3.2

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

From alex.macaulay at gmail.com  Tue Jun  4 15:37:52 2013
From: alex.macaulay at gmail.com (Alex MacAulay)
Date: Tue, 04 Jun 2013 13:37:52 -0000
Subject: [docs] Bug in last httplib example in Python 2.7.5 docs in section
	20.7.3
Message-ID: <CAFU4XYdkojKSqptBw-CZS-A155r6d-JQFyuNEqjb_RL7kcA_9g@mail.gmail.com>

On the following page in the Python 2.7.5 docs:
    http://docs.python.org/2/library/httplib.html
In section 20.7.3, the last example has:

>>> response = conn.getresponse()>>> print resp.status, response.reason


However it should be:

>>> response = conn.getresponse()>>> print response.status, response.reason


Hope it helps!

Alex.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20130604/99e8ea1d/attachment-0001.html>

From aseembansal at ymail.com  Tue Jun 11 11:50:43 2013
From: aseembansal at ymail.com (aseem bansal)
Date: Tue, 11 Jun 2013 09:50:43 -0000
Subject: [docs] Lambda Forms' explanation should be improved
Message-ID: <1370944063.33555.YahooMailNeo@web142704.mail.bf1.yahoo.com>

In the documentation of Python 2.7.5 I was going through the tutorials and read 4.7.5 Lambda Forms. After reading it I was completely lost about what is this thing. The explanation about features of functional programming being added isn't helpful at all for someone without functional programming experience. The explanation should be improved.

The explanation at codecademy.com at
http://www.codecademy.com/courses/python-beginner-en-KAgt5?curriculum_id=4f89dab3d788890003000096
is better than the official documentation. Perhaps some ideas can be taken from the website?
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20130611/6ea73b9e/attachment-0001.html>

From agus3985 at gmail.com  Thu Jun 13 10:40:09 2013
From: agus3985 at gmail.com (=?ISO-8859-1?Q?Jos=E9_Agust=EDn_Terol_Sanchis?=)
Date: Thu, 13 Jun 2013 08:40:09 -0000
Subject: [docs] Documentation bug
Message-ID: <CAJZZAVtei_d8AOgETKXDF3BDwtxLF1YqTPSYHQLVuXJjF4c8Mg@mail.gmail.com>

At section 15.4.2.11. add_help (
http://docs.python.org/2/library/argparse.html#add-help ) there is an error
on the last piece of code. Where it is written:



>>> parser = argparse.ArgumentParser(prog='PROG', prefix_chars='+/')

>>> parser.print_help()

usage: PROG [-h]



optional arguments:

  -h, --help  show this help message and exit



Should be:



>>> parser = argparse.ArgumentParser(prog='PROG', prefix_chars='+/')

>>> parser.print_help()

usage: PROG [-h]



optional arguments:

  +h, ++help  show this help message and exit



As it is described in the previous paragraph. The second way works for me
for Python 2.7.2 on Windows 7 64 bits.


Regars,

Agus Terol
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20130613/c71bbf67/attachment-0001.html>

From begbie00 at gmail.com  Sun Jun 16 03:27:07 2013
From: begbie00 at gmail.com (Michael Rand)
Date: Sun, 16 Jun 2013 01:27:07 -0000
Subject: [docs] venv 3.3.2 docs - "create_directories" should be
	"ensure_directories"
Message-ID: <CANKxYhu3iKcXo6xbH+VysmTKZ+YDoG2dxUSoNSPGYvtQ=oeqUg@mail.gmail.com>

To whom it may concern,

When subclassing venv.EnvBuilder and customizing create(), the docs say
that one should use "self.create_directories(env_dir)".

This call raises an AttributeError. When looking at the subclass, I don't
see "create_directories" but instead I see the method "ensure_directories",
which has the following docstring:

"Create the directories for the environment".

It seems like either the docs should be fixed to reflect
"ensure_directories" as the appropriate method name or the method should be
renamed "create_directories".

Apologies if I'm mistaken on this ... this is my first doc bug report.

Thanks,

Mike Rand
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20130616/c767d3c1/attachment.html>

From alex.heger at gmail.com  Thu Jun 27 02:26:03 2013
From: alex.heger at gmail.com (Alexander Heger)
Date: Thu, 27 Jun 2013 00:26:03 -0000
Subject: [docs] bug in re documentation (python 3.3.2)
Message-ID: <CALMUFh9oKi_W6TWTD08B9jbs-eZ019ipxftzksMP_zFH_u8vxQ@mail.gmail.com>

http://docs.python.org/3.3/library/re.html

6.2.1. Regular Expression Syntax

(way down)

it says:

\number
Matches the contents of the group of the same number. Groups are numbered
starting from 1. For example, (.+) \1 matches 'the the' or '55 55', but not
'the end' (note the space after the group). This special sequence can only
be used to match one of the first 99 groups. If the first digit of number
is 0, or number is 3 octal digits long, it will not be interpreted as a
group match, but as the character with octal value number. Inside the '['
and ']' of a character class, all numeric escapes are treated as characters.

The example of what does not work is wrong

In [1]: import re

In [2]: re.findall(r'(.+) \1','the end')
Out[2]: ['e']

It probably should be

\number
Matches the contents of the group of the same number. Groups are numbered
starting from 1. For example, (.+) \1 matches 'the the' or '55 55', but not
'thethe' (note the space after the group). This special sequence can only
be used to match one of the first 99 groups. If the first digit of number
is 0, or number is 3 octal digits long, it will not be interpreted as a
group match, but as the character with octal value number. Inside the '['
and ']' of a character class, all numeric escapes are treated as characters.

-Alexander
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20130627/8699f3fa/attachment-0001.html>

From brad.aylsworth at gmail.com  Tue Jun 11 20:03:45 2013
From: brad.aylsworth at gmail.com (Brad Aylsworth)
Date: Tue, 11 Jun 2013 18:03:45 -0000
Subject: [docs] Trivial error in documentation
Message-ID: <51B76675.5070703@gmail.com>

On http://docs.python.org/3.3/tutorial/introduction.html#strings I found 
an error that really doesn't matter and that most people can probably 
understand as a typo, but I thought I'd report it.

>>>word[0:2]   # characters from position 0 (included) to 2 (excluded)
'Py'
>>>word[2:*5*]   # characters from position 2 (included) to*4*  (excluded)
'tho'

As far as I can tell, that should say "5 (excluded)".
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20130611/133732a5/attachment-0001.html>

From c.n.brautigam at googlemail.com  Tue Jun 18 00:19:44 2013
From: c.n.brautigam at googlemail.com (Christopher Brautigam)
Date: Mon, 17 Jun 2013 22:19:44 -0000
Subject: [docs] Error in Section 3.1.2. of The Python Tutorial
Message-ID: <CAKWV12TWquPJq4k6TNCHKp0L8H5ggWG7YQ0O+1s=woY15Lwm+Q@mail.gmail.com>

To whom it may concern,

I believe I have found a minor error in the example given on String
"slicing" in section 3.1.2. "Strings" of "The Python Tutorial"
documentation.

The error concerns the first example of slicing given (where the variable
"word" is equal to "Python"), which reads:

>>> word[0:2]  # characters from position 0 (included) to 2 (excluded)'Py'>>> word[2:5]  # characters from position 2 (included) to 4 (excluded)'tho'

I believe the second comment is incorrect as the character at the 4th index
"o" is included. I propose that the comment should be changed so that
"excluded" is changed to "included" as below:

>>> word[0:2]  # characters from position 0 (included) to 2 (excluded)'Py'>>> word[2:5]  # characters from position 2 (included) to 4 (included)'tho'

This could also be solved by changing the 4 to a 5 however that statement
would be making the same point as the first and would therefore be
redundant.

Kind Regards,

Christopher Brautigam
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20130617/7eafda14/attachment-0001.html>

From daviewales at gmail.com  Fri Jun 21 17:11:20 2013
From: daviewales at gmail.com (David Wales)
Date: Fri, 21 Jun 2013 15:11:20 -0000
Subject: [docs] Broken link at
	http://docs.python.org/devguide/documenting.html
Message-ID: <A9152DE9-715A-48CD-8031-DF186FF3CFDA@gmail.com>

Hi there.

I just found that the following link is broken.

http://docs.python.org/devguide/documenting.html#style-guide


I think the replacement is here:

https://help.apple.com/asg/mac/2013/#

(maybe?)


Regards,
David Wales.

From dreamingforward at gmail.com  Fri Jun 28 01:50:35 2013
From: dreamingforward at gmail.com (Mark Janssen)
Date: Thu, 27 Jun 2013 23:50:35 -0000
Subject: [docs] bytearray and language usage.
Message-ID: <CAMjeLr9vrc0zUPrk4vkvZ4+UmCgtZb=xPM15bV2TocWGUNvZ0Q@mail.gmail.com>

Looking at the Python docs for v2.7.5.

Section 2.

bytearray([source[, encoding[, errors]]])

"  Return a new array of bytes. The bytearray type is a mutable
sequence of integers in the range 0 <= x < 256."

This should not be called a "mutable sequence of integers", because to
call them "integers" already casts raw bits into a particular *type*.
They could, hypothetically be very short floats, for example.

More accurately, they are merely "uninterpreted bits presented to the
user in 8-bit chunks, with a consistent starting boundary" (held by
the machine storage address).

-- 
MarkJ
Tacoma, Washington

From dreamingforward at gmail.com  Sat Jun 29 23:50:01 2013
From: dreamingforward at gmail.com (Mark Janssen)
Date: Sat, 29 Jun 2013 21:50:01 -0000
Subject: [docs] bytearray and language usage.
In-Reply-To: <CAMjeLr9vrc0zUPrk4vkvZ4+UmCgtZb=xPM15bV2TocWGUNvZ0Q@mail.gmail.com>
References: <CAMjeLr9vrc0zUPrk4vkvZ4+UmCgtZb=xPM15bV2TocWGUNvZ0Q@mail.gmail.com>
Message-ID: <CAMjeLr-jbn7oxf4fmS2jeQgdDvyWnJ-11eR6rKxiGhFwHoVVPQ@mail.gmail.com>

> This should not be called a "mutable sequence of integers", because to
> call them "integers" already casts raw bits into a particular *type*.
> They could, hypothetically be very short floats, for example.
>
> More accurately, they are merely "uninterpreted bits presented to the
> user in 8-bit chunks, with a consistent starting boundary" (held by
> the machine storage address).

Perhaps a better suggestion is to call them an 'uninterpreted sequence
of bits, presented to the user in 8-bit "chunks" (i.e. bytes).'
-- 
MarkJ
Tacoma, Washington

From h.stenstrom at gmail.com  Mon Jun  3 13:37:41 2013
From: h.stenstrom at gmail.com (=?ISO-8859-1?Q?Helge_Stenstr=F6m?=)
Date: Mon, 03 Jun 2013 11:37:41 -0000
Subject: [docs] Wrong toolkit for PythonCAD
Message-ID: <CAMoy75XFqKzjfouvNZ=AyEU=NsgJQzaxXT2Ti5Y0vQjVm6-cig@mail.gmail.com>

According to http://docs.python.org/2/library/othergui.html, PythonCAD is
written in pygtk, but according to the project page,
http://sourceforge.net/projects/pythoncad/, it uses PyQt.

Kind regardss,
Helge Stenstr?m
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20130603/7be57da8/attachment-0001.html>

From info at bing-elektro.nl  Mon Jun  3 14:21:21 2013
From: info at bing-elektro.nl (info at bing-elektro.nl)
Date: Mon, 03 Jun 2013 12:21:21 -0000
Subject: [docs] Documentation issue
Message-ID: <51AC8A38.2090508@bing-elektro.nl>

Dear Python documentarians,

First of all, I would like to thank you for the very well written Python 
documentation. It is very clear, concise and easy to read for non native 
English speaking persons, like myself.

I noticed an inconsistency in the nomenclature used in section 6 
/Modules/ of 'The Python Tutorial'.
Both the terms /module/ and /submodule/ are used seemingly 
interchangeably. The term /submodule/ would imply it is part of another 
module. However, a module is defined as a file containing python code, 
having the extension /.py/. A file cannot contain other files, hence, 
the term /submodule/ is not defined in this context. The term 
/submodule/ adds unnecessary complexity to the tutorial.
I would suggest to replace all occurrences of /submodule/ by /module/.

Note:
The term subpackage (used for packages within another package) is used 
correctly because a package, which is a (special type of) directory, can 
contain subdirectories that are packages themselves.

Harrie Guikers
harrie at dinde.nl

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

From kenshin.manabu at gmail.com  Tue Jun  4 23:20:19 2013
From: kenshin.manabu at gmail.com (=?UTF-8?B?6LOi6YCy5a2m?=)
Date: Tue, 04 Jun 2013 21:20:19 -0000
Subject: [docs] Bad EPUB
Message-ID: <CAL5jeunNwMUev6+h0fb43JcnuvR=WRHFEQV52udZ5ZRU-TBezw@mail.gmail.com>

I tried to download the EPUB located at
http://docs.python.org/3/archives/python-3.3.2-docs-epub.zip and my reader
was unable to open it. I checked the file at http://validator.idpf.org/ and
received many errors. Please republish the file in the EPUB format.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20130604/95f52d57/attachment.html>

From Liying.Chen at windriver.com  Wed Jun  5 13:00:51 2013
From: Liying.Chen at windriver.com (Chen, Liying)
Date: Wed, 05 Jun 2013 11:00:51 -0000
Subject: [docs] binascii.b2a_base64 can convert data length more than 57
Message-ID: <C56D1F42E5FDF943894DEECA8D1D03547BD65084@ALA-MBA.corp.ad.wrs.com>

Hi,

In the document binascii.b2a_base64(data) said the data length should less than 57.But I can use it for more than 57.Can you give me an explain?

>>> import struct
>>> import binascii
>>> payload = struct.pack('>hhiii',4,0,0,0,0)
>>> payload = payload*10
>>> len(payload)
160
>>> binascii.b2a_base64(payload)
'AAQAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAEAAAAAAAAAAAAAAAAAAAABAAAAAAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAA==\n'
>>> a = binascii.b2a_base64(payload)
>>> len(a)
217
>>>

Thanks
Chen Liying
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20130605/28ab970c/attachment-0001.html>

From eliben at gmail.com  Sat Jun  8 18:18:42 2013
From: eliben at gmail.com (eliben at gmail.com)
Date: Sat, 08 Jun 2013 16:18:42 -0000
Subject: [docs] Code, test,
	and doc review for PEP-0435 Enum (issue 17947)
Message-ID: <20130608161842.18905.27537@psf.upfronthosting.co.za>


http://bugs.python.org/review/17947/diff/8332/Doc/library/enum.rst
File Doc/library/enum.rst (right):

http://bugs.python.org/review/17947/diff/8332/Doc/library/enum.rst#newcode240
Doc/library/enum.rst:240: of *_sunder_* names, *__dunder__* names, and
descriptors; methods are
The specific rules are not well-enough defined. sunder names are
forbidden, dunders are not - is this explained elsewhere?

http://bugs.python.org/review/17947/diff/8332/Doc/library/enum.rst#newcode245
Doc/library/enum.rst:245: methods.
This needs some more explanation and/or example, perhaps somewhere in
the end in "advanced customization"

http://bugs.python.org/review/17947/diff/8332/Doc/library/enum.rst#newcode260
Doc/library/enum.rst:260: But this is allowed::
Can this have a sensical example? (like, some simple example of where
this actually makes sense)

http://bugs.python.org/review/17947/diff/8332/Doc/library/enum.rst#newcode280
Doc/library/enum.rst:280: A variation of :class:`Enum` is proposed which
is also a subclass of :class:`int`.
80 col

http://bugs.python.org/review/17947/diff/8332/Doc/library/enum.rst#newcode331
Doc/library/enum.rst:331: Other derived enumerations
I think this should be merged somehow with the "interesting examples",
perhaps in a higher-level header: "Creating custom enumerations" with
some dry explanation of the semantics, followed by examples. And this
should definitely be the last section of the document :-)

http://bugs.python.org/review/17947/diff/8332/Doc/library/enum.rst#newcode340
Doc/library/enum.rst:340: This demonstrates how similar derived
enumerations can be defined, for example
; instead of , after "defined" ?

http://bugs.python.org/review/17947/diff/8332/Doc/library/enum.rst#newcode443
Doc/library/enum.rst:443: ...                     )
just append this to the previous line

http://bugs.python.org/review/17947/diff/8332/Lib/enum.py
File Lib/enum.py (right):

http://bugs.python.org/review/17947/diff/8332/Lib/enum.py#newcode42
Lib/enum.py:42: """Returns True if a sunder name, False otherwise."""
Unlike "dunder", "sunder" has no historical meaning for python
programmers. I suggest a more consistent documentation then, like:

"Returns True if a __dunder__ name, False otherwise"
"Returns True if a _sunder_ name, False otherwise"

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

From ethan at stoneleaf.us  Sun Jun  9 02:02:52 2013
From: ethan at stoneleaf.us (ethan at stoneleaf.us)
Date: Sun, 09 Jun 2013 00:02:52 -0000
Subject: [docs] Code, test,
	and doc review for PEP-0435 Enum (issue 17947)
Message-ID: <20130609000252.15139.61775@psf.upfronthosting.co.za>

I'll try to have the changes in place later tonight; otherwise it will
be tomorrow.


http://bugs.python.org/review/17947/diff/8332/Doc/library/enum.rst
File Doc/library/enum.rst (right):

http://bugs.python.org/review/17947/diff/8332/Doc/library/enum.rst#newcode240
Doc/library/enum.rst:240: of *_sunder_* names, *__dunder__* names, and
descriptors; methods are
Ah, yes.  _sunder_names_ are completely forbidden, __dunder_names__ are
only forbidden from being enum members.

I'll clarify.

http://bugs.python.org/review/17947/diff/8332/Doc/library/enum.rst#newcode245
Doc/library/enum.rst:245: methods.
I'll add something.

http://bugs.python.org/review/17947/diff/8332/Doc/library/enum.rst#newcode260
Doc/library/enum.rst:260: But this is allowed::
I'll see what I can dream up.  :)

http://bugs.python.org/review/17947/diff/8332/Doc/library/enum.rst#newcode280
Doc/library/enum.rst:280: A variation of :class:`Enum` is proposed which
is also a subclass of :class:`int`.
Done.

http://bugs.python.org/review/17947/diff/8332/Doc/library/enum.rst#newcode331
Doc/library/enum.rst:331: Other derived enumerations
Will do.

http://bugs.python.org/review/17947/diff/8332/Doc/library/enum.rst#newcode340
Doc/library/enum.rst:340: This demonstrates how similar derived
enumerations can be defined, for example
Done.

http://bugs.python.org/review/17947/diff/8332/Doc/library/enum.rst#newcode443
Doc/library/enum.rst:443: ...                     )
Done.

http://bugs.python.org/review/17947/diff/8332/Lib/enum.py
File Lib/enum.py (right):

http://bugs.python.org/review/17947/diff/8332/Lib/enum.py#newcode42
Lib/enum.py:42: """Returns True if a sunder name, False otherwise."""
Done.

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

From hjsmall at hotmail.com  Sun Jun  9 15:44:00 2013
From: hjsmall at hotmail.com (Howard Small)
Date: Sun, 09 Jun 2013 13:44:00 -0000
Subject: [docs] Documentation manual suggestion
Message-ID: <BLU169-W225A4359E247D075A1990BB29B0@phx.gbl>

I'm still relatively new to Python, and find myself frequently referring to the documentation manual.  Would it be possible to add a bookmark feature so that I don't have repeat searching an item that I might want to reference again?

 

On a larger scope and greater undertaking, it would be nice to see more code snippets in the manual.  For a newbee like me the explanation of feature can often be a little too abstract to understand.
 		 	   		  
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20130609/29f5a24d/attachment-0001.html>

From ethan at stoneleaf.us  Mon Jun 10 16:13:01 2013
From: ethan at stoneleaf.us (ethan at stoneleaf.us)
Date: Mon, 10 Jun 2013 14:13:01 -0000
Subject: [docs] Code, test,
	and doc review for PEP-0435 Enum (issue 17947)
Message-ID: <20130610141301.4484.28478@psf.upfronthosting.co.za>


http://bugs.python.org/review/17947/diff/8339/Doc/library/enum.rst
File Doc/library/enum.rst (right):

http://bugs.python.org/review/17947/diff/8339/Doc/library/enum.rst#newcode60
Doc/library/enum.rst:60: Enums also have a property that contains just
their item name::
Fixed this one and the other further down.

http://bugs.python.org/review/17947/diff/8339/Doc/library/enum.rst#newcode314
Doc/library/enum.rst:314: >>> Animals = Enum('Animals', 'ant bee cat
dog', module=__name__)
Moved, and reworded:

Pickling enums created with the functional API can be tricky as frame
stack
implementation details are used to try and figure out which module the
enumeration is being created in (e.g. it will fail if you use a utility
function in separate module, and also may not work on IronPython or
Jython).
The solution is to specify the module name explicitly as follows::

http://bugs.python.org/review/17947/diff/8339/Doc/library/enum.rst#newcode337
Doc/library/enum.rst:337: A variation of :class:`Enum` is proposed which
is also a subclass of
Done.

http://bugs.python.org/review/17947/diff/8339/Doc/library/enum.rst#newcode423
Doc/library/enum.rst:423: One frequent request is to not have to specify
values for enum members::
Major rewrite:

Interesting examples
====================

While :class:`Enum` and :class:`IntEnum` are expected to cover the
majority of
use-cases, they cannot cover them all.  Here are recipes for some
different
types of enumerations that can be used directly, or as examples for
creating
one's own.


AutoNumber
----------

Avoids having to specify the value for each enumeration member::

.
.
.

UniqueEnum
----------

Raises an error if a duplicate member name is found instead of creating
an
alias::

.
.
.

OrderedEnum
-----------

An ordered enumeration that is not based on :class:`IntEnum` and so
maintains
the normal :class:`Enum` invariants (such as not being comparable to
other
enumerations)::

.
.
.

Planet
------

If :meth:`__new__` or :meth:`__init__` is defined the value of the enum
member
will be passed to those methods::

http://bugs.python.org/review/17947/diff/8339/Lib/test/test_enum.py
File Lib/test/test_enum.py (right):

http://bugs.python.org/review/17947/diff/8339/Lib/test/test_enum.py#newcode474
Lib/test/test_enum.py:474: _reserved_ = 0
Removed.

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

From ethan at stoneleaf.us  Mon Jun 10 16:52:27 2013
From: ethan at stoneleaf.us (ethan at stoneleaf.us)
Date: Mon, 10 Jun 2013 14:52:27 -0000
Subject: [docs] Code, test,
	and doc review for PEP-0435 Enum (issue 17947)
Message-ID: <20130610145227.15461.93324@psf.upfronthosting.co.za>


http://bugs.python.org/review/17947/diff/8339/Doc/library/enum.rst
File Doc/library/enum.rst (right):

http://bugs.python.org/review/17947/diff/8339/Doc/library/enum.rst#newcode292
Doc/library/enum.rst:292: 
Added:

.. warning::

    In order to support the singleton nature of enumeration members,
pickle
    protocol version 2 or higher must be used.

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

From justin.high at gsaapplications.com  Tue Jun 11 18:15:49 2013
From: justin.high at gsaapplications.com (Justin High)
Date: Tue, 11 Jun 2013 16:15:49 -0000
Subject: [docs] Collin Winter's functional module
	(http://docs.python.org/2.6/howto/functional.html#the-functional-module)
Message-ID: <000c01ce66bd$fca8dc20$f5fa9460$@gsaapplications.com>

The links for Collin Winter's module appear broken in the 2.6 documentation
here: http://docs.python.org/2.6/howto/functional.html#the-functional-module

 

They currently link to a GoDaddy.com landing page.

 

http://oakwinter.com/?nr=0

 

 

 

-           Justin High

 

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

From mcguiganj at ualberta.ca  Thu Jun 13 03:40:12 2013
From: mcguiganj at ualberta.ca (John McGuigan)
Date: Thu, 13 Jun 2013 01:40:12 -0000
Subject: [docs] OpenBSD Instructions
Message-ID: <CACgoL4f6h_JPkF932OhGKzEBhQcHV8-MoAZsd6uXF2r668ctNA@mail.gmail.com>

Hey there,

This is less of a bug but more of an enhancement. The instructions for
OpenBSD here (
http://docs.python.org/2/using/unix.html#on-freebsd-and-openbsd):

pkg_add ftp://ftp.openbsd.org/pub/OpenBSD/4.2/packages/<insert your
architecture here>/python-<version>.tgz

Are correct, but kinda specific to version 4.2 which is pretty old (5.3
came out on May 1st, 2013 -- releases are every 6 months). I would
recommend either:

pkg_add python (because newer versions autoset the package source in
/etc/pkg.conf)

and/or

pkg_add ftp://ftp.OpenBSD.org/pub/OpenBSD/`uname -r`/packages/`uname -p`/

They can also run "pkg_info python" if pkg.conf is working and get the
package info for python (current version for OpenBSD is python-2.7.3p1).

Openports.se is also good to check out packages / versions.

Thanks!

John
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20130613/cf5305e8/attachment.html>

From kneilk at gmail.com  Sun Jun 16 22:33:06 2013
From: kneilk at gmail.com (Neil Kelleher)
Date: Sun, 16 Jun 2013 20:33:06 -0000
Subject: [docs] Typo in 3.3 tutorial
Message-ID: <000001ce6ad0$b440cad0$1cc26070$@gmail.com>

File: http://docs.python.org/3.3/tutorial/introduction.html
Section: 3.1.2. Strings

There is a typo in this block
===BLOCK START===
In addition to indexing, slicing is also supported. While indexing is used
to obtain individual characters, slicing allows you to obtain substring:

>>>
>>> word[0:2]  # characters from position 0 (included) to 2 (excluded)
'Py'
>>> word[2:5]  # characters from position 2 (included) to 4 (excluded)
'tho'
===BLOCK END===
The comment on the 2nd last line should read
# characters from position 2 (included) to 5 (excluded)

Regards
Neil


From hamid.eftekhari at outlook.com  Tue Jun 25 10:32:17 2013
From: hamid.eftekhari at outlook.com (Hamid Eftekhari)
Date: Tue, 25 Jun 2013 08:32:17 -0000
Subject: [docs] Typo on "3. An Informal Introduction to Python" [version
	3.2.2]
Message-ID: <COL126-W2271B284AFBAE9F43429B0F08B0@phx.gbl>

Hi there,

I believe there's a tiny typo on this page, section 3.1.2. Strings, where string slicing is introduced. There we read:

>>> word[0:2]  # characters from position 0 (included) to 2 (excluded)
'Py'
>>> word[2:5]  # characters from position 2 (included) to 4 (excluded)
'tho'I think the second comment must read:

# characters from position 2 (included) to 5 (excluded)



Thanks,
Regards.
 		 	   		  
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20130625/7173b669/attachment-0001.html>

From m.gilson1 at gmail.com  Fri Jun 28 21:43:22 2013
From: m.gilson1 at gmail.com (Matthew Gilson)
Date: Fri, 28 Jun 2013 19:43:22 -0000
Subject: [docs] Comparison of sequences
Message-ID: <51CDE752.8060503@gmail.com>

It seems to me that the documentation on comparison for sequences could 
be improved slightly.

(reference)
http://docs.python.org/3/reference/expressions.html#not-in

"""
Tuples and lists are compared lexicographically using comparison of 
corresponding elements. This means that to compare equal, each element 
must compare equal and the two sequences must be of the same type and 
have the same length.

If not equal, the sequences are ordered the same as their first 
differing elements. For example, [1,2,x] <= [1,2,y] has the same value 
as x <= y. If the corresponding element does not exist, the shorter 
sequence is ordered first (for example, [1,2] < [1,2,3]).
"""

The first paragraph is clear -- if you compare two sequences 
(lists/tuples) which are of different type then they aren't equal. 
However, the second paragraph is not quite as clear what the result of 
rich comparisons should be if you compare a list and a tuple. e.g. what 
should the result of `[2] > (1,)` be?  In python3.x, this results in a 
TypeError (presumably because the rich comparison methods aren't 
overloaded to allow that behavior -- But documentation reader doesn't 
really have a good way of knowing that), but on python2.x the ordering 
is not based on their elements as implied by the documentation but are 
instead ordered based on their type.

I propose that the documentation should say something like this:

Python3.x:

"If not equal, the sequences are ordered the same as their first 
differing elements if they have the same type.  Otherwise the comparison 
results in a `TypeError`".

Python2.7:

"If not equal, the sequences are ordered the same as their first 
differing elements if they have the same type.  Otherwise the result is 
the same as comparing the sequence types."



From qsolo825 at gmail.com  Wed Jun  5 19:16:18 2013
From: qsolo825 at gmail.com (=?KOI8-R?B?7cnIwcnMIOfPzNXCxdc=?=)
Date: Wed, 05 Jun 2013 17:16:18 -0000
Subject: [docs] Typo in collections.Counter class example
Message-ID: <CADzNYBef4TKqA-NH-r2dbHfKnS675R5RYyEFxFGw4pXOaAMnRg@mail.gmail.com>

Hello,

It seems that I found micro bug in Python documentation describing
collections.Counter
class<http://docs.python.org/3.3/library/collections.html#counter-objects>
.
There is the following snippet of code

c.most_common()[:-n:-1]         # n least common elements

Actually this expression returns not *n* least common elements, but rather *n
- 1,* beacuse second boundary  is not included (as usual with slices).
You probably meant c.most_common()[-n:] or c.most_common()[:-n-1:-1] if
reverse ordering is nesessary.

-- 
Best regards
Mikhail Golubev
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20130605/c4c9d8e3/attachment-0001.html>

From pedro at tastytronic.net  Fri Jun  7 04:39:10 2013
From: pedro at tastytronic.net (Peter A. H. Peterson)
Date: Fri, 07 Jun 2013 02:39:10 -0000
Subject: [docs] minor typo in http://docs.python.org/2/library/gzip.html
Message-ID: <20130607023012.GC15768@tastytronic.net>

Hi,

Under the class gzip.GzipFile documentation, the text reads:

"When fileobj is not None, the filename argument is only used to be
included in the gzip file header, which may includes the original
filename of the uncompressed file."

It says "which may includes the original filename" which should either
read:

"which may include the original filename"

...or...

"which includes the original filename"

I would also suggest that "the filename argument is only used to be
included in the gzip file header" should be changed to

"is only used in the gzip file header"

...or...

"is only included in the gzip file header"

It seems to me that the implication is that the gzip file header *may*
include the filename but is not required to do so. If that is the
case, I would suggest that the text read:

"When fileobj is not None, the filename argument is only used in the
gzip file header, which may include the original filename of the
uncompressed file."

Thanks for all your hard work,

Sincerely,

Peter

-- 
Peter A. H. Peterson
Graduate Student Researcher
Laboratory for Advanced Systems Research
University of California, Los Angeles

From r.kelsall at millstream.com  Sat Jun  8 16:32:34 2013
From: r.kelsall at millstream.com (Richard Kelsall)
Date: Sat, 08 Jun 2013 14:32:34 -0000
Subject: [docs] Should say 'REAL' not 'FLOAT' as the SQLite datatype in
 11.13.1 of sqlite3.
Message-ID: <51B33EF1.6090601@millstream.com>

Hello Python Docs,


TLDR: I think it should probably say 'REAL' not 'FLOAT' as the SQLite
       datatype in 11.13.1 of sqlite3.


I am reading the sqlite3 page

http://docs.python.org/2/library/sqlite3.html

for Python v2.7.5. It says in 11.13.1:

"SQLite natively supports only the types TEXT, INTEGER, FLOAT, BLOB and
NULL."

This made me wonder, is this a double or single FLOAT? (I have not used
this database or this Python module before.) And I looked in the SQLite
documentation here

http://sqlite.org/datatype3.html

This says that SQLite version 3 uses an 8 byte (i.e. double) float and
has this as type REAL. So I go back to the python page thinking maybe
this is an earlier version of SQLite - maybe Python 2 provides SQLite 2
for backwards compatibility and the module name 'sqlite3' does not
follow the SQLite version number for some reason. I cannot see on this
page mention of what version of SQLite this module provides, maybe I
missed that? But I see in 11.13.5.1:

"SQLite natively supports the following types: NULL, INTEGER, REAL,
TEXT, BLOB."

So this internal contradiction makes me think section 11.13.1 is
incorrect.

I feel posting to this public list, of unknown proportions, may
be a rather loud way of reporting such a minor problem, but the
documentation page seems to ask me to do this. A wiki might have
been an easier and less noisy way to suggest corrections. I expect
many people would not go to the trouble of emailing a public mailing
list to get a detail like this corrected and that there are many
similar bugs which are found but not immediately reported for this
reason.


Richard.


From zachary.ware at gmail.com  Mon Jun 10 07:00:12 2013
From: zachary.ware at gmail.com (zachary.ware at gmail.com)
Date: Mon, 10 Jun 2013 05:00:12 -0000
Subject: [docs] Code, test,
	and doc review for PEP-0435 Enum (issue 17947)
Message-ID: <20130610050011.4484.69809@psf.upfronthosting.co.za>

A few nitpicks and a suggestion.  Everything else looks good to me.


http://bugs.python.org/review/17947/diff/8339/Doc/library/enum.rst
File Doc/library/enum.rst (right):

http://bugs.python.org/review/17947/diff/8339/Doc/library/enum.rst#newcode60
Doc/library/enum.rst:60: Enums also have a property that contains just
their item name::
Conflict with the note on nomenclature above; should be 'Enum members
...'.

http://bugs.python.org/review/17947/diff/8339/Doc/library/enum.rst#newcode314
Doc/library/enum.rst:314: >>> Animals = Enum('Animals', 'ant bee cat
dog', module=__name__)
This bit about pickling should be at the end of this section (just as
the 'module' argument is last in the call).

http://bugs.python.org/review/17947/diff/8339/Doc/library/enum.rst#newcode337
Doc/library/enum.rst:337: A variation of :class:`Enum` is proposed which
is also a subclass of
s/proposed/provided/

http://bugs.python.org/review/17947/diff/8339/Doc/library/enum.rst#newcode423
Doc/library/enum.rst:423: One frequent request is to not have to specify
values for enum members::
The obvious thing that comes to mind when reading "One frequent request"
or "Some have asked...", etc., is "Then why are these not provided in
the module?"  I wonder if it might be better to wrap these examples up
into a demo file for Tools/demo, and shorten this section to "Some
interesting Enum subclasses can be found in the Tools/demo folder of
your Python installation or source distribution."

Alternately, I'd advise finding a different wording, though I
unfortunately can't come up with any myself.

http://bugs.python.org/review/17947/diff/8339/Lib/test/test_enum.py
File Lib/test/test_enum.py (right):

http://bugs.python.org/review/17947/diff/8339/Lib/test/test_enum.py#newcode474
Lib/test/test_enum.py:474: _reserved_ = 0
This test is covered by test_invalid_names above.

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

From ruslan_baratov at yahoo.com  Mon Jun 10 14:53:39 2013
From: ruslan_baratov at yahoo.com (Ruslan Baratov)
Date: Mon, 10 Jun 2013 12:53:39 -0000
Subject: [docs] comments in documentation misprint
Message-ID: <51B5CBDF.6070507@yahoo.com>

Hello, I think I've found misprint in this page:
http://docs.python.org/3/tutorial/introduction.html

>>> word = 'Python'

>>>word[0:2]   # characters from position 0 (included) to 2 (excluded)
'Py'
>>>word[2:5]   # characters from position 2 (included) to 4 (excluded)
'tho'


I think it should be:

>>>word[2:5]   # characters from position 2 (included) to 4 (included)
'tho'

or

>>>word[2:5]   # characters from position 2 (included) to 5 (excluded)
'tho'


From zachary.ware at gmail.com  Mon Jun 10 16:54:20 2013
From: zachary.ware at gmail.com (zachary.ware at gmail.com)
Date: Mon, 10 Jun 2013 14:54:20 -0000
Subject: [docs] Code, test,
	and doc review for PEP-0435 Enum (issue 17947)
Message-ID: <20130610145420.4485.91587@psf.upfronthosting.co.za>

Barring any typos in the not-yet-uploaded v12 patch, everything looks
good to me now.  Thanks, Ethan!


http://bugs.python.org/review/17947/diff/8339/Doc/library/enum.rst
File Doc/library/enum.rst (right):

http://bugs.python.org/review/17947/diff/8339/Doc/library/enum.rst#newcode423
Doc/library/enum.rst:423: One frequent request is to not have to specify
values for enum members::
On 2013/06/10 16:13:01, stoneleaf wrote:
> Major rewrite:

Much better :)

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

From fgabogados at terra.com  Wed Jun 12 17:06:48 2013
From: fgabogados at terra.com (=?iso-8859-1?Q?Francisco_Garc=EDa_Mart=EDn?=)
Date: Wed, 12 Jun 2013 15:06:48 -0000
Subject: [docs] =?iso-8859-1?q?Tutorial_Python_2=2E7=2E3=2E_PDF_Espa=F1ol?=
	=?iso-8859-1?q?=2E?=
Message-ID: <000001ce6777$eba3e900$c2ebbb00$@terra.com>

               Buenas tardes, ?hay forma de obtener el tutorial de Python
2.7.3 en formato PDF e idioma Espa?ol?

 

               Un saludo.

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

From cclauss at me.com  Thu Jun 13 09:09:48 2013
From: cclauss at me.com (cclauss)
Date: Thu, 13 Jun 2013 07:09:48 -0000
Subject: [docs] Showing the Python 3 migration of most requested packages
Message-ID: <1F358B3F-323F-457C-A2E0-66EF7AC0D6C4@me.com>

Hi Folks,

    On the page http://www.python.org/3kpoll there is a list of requests to migrate packages to Python 3.  Next to each package in that list, it would be quite useful to add the status of Python 3 support.  This page currently leaves the uniformed reader with the impression that all these requests remain unfulfilled.

    Thanks.

From arielbro at mail.tau.ac.il  Sun Jun 16 17:44:21 2013
From: arielbro at mail.tau.ac.il (Ariel Bronner)
Date: Sun, 16 Jun 2013 15:44:21 -0000
Subject: [docs] IDLE tooltip using python 2.7.5
Message-ID: <CAOT6=7A=et6QHb_YDV00zwSNZamxZ-Ux_DhXyhF_t=HQjmdsUw@mail.gmail.com>

Hey guys,

I want to report what I believe to be a bug with IDLE.

When calling a function in IDLE, it shows a tool-tip describing the
function's parameters, including optional parameters and their default
value. Using python 2.7.5 on Windows 7 with IDLE, I've found out the
tool-tips for optional parameters with fractional default value is quite
strange. Using this definition -

def foo(x=1.5):
    pass

Calling foo will produce the tool-tip (x=1<tuple>). This "tuple" thing will
appear when using several default parameters, even when nested inside
parametrs (def foo([[0.3]])) .

I first thought it is some feature I'm misunderstanding, so I've opened a
question on stackoverflow<http://stackoverflow.com/questions/17053492/pythons-idle-behavior-while-defining-fractional-default-values-to-function-para>.
It appears this problem also appears using python 2.7.3.

Hope this information helps,
Ariel.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20130616/57425826/attachment-0001.html>

From Will.Watson at morganstanley.com  Wed Jun 12 15:12:19 2013
From: Will.Watson at morganstanley.com (Watson, Will)
Date: Wed, 12 Jun 2013 13:12:19 -0000
Subject: [docs] Documentation Error
Message-ID: <ACED8567804BE847B3330B258FF07F130C5295@OZWEX0202N2.msad.ms.com>

>>> word[2:5]  # characters from position 2 (included) to 4 (excluded)

On page

http://docs.python.org/3/tutorial/introduction.html

should be "to 5 (excluded)"



Will Watson
Consultant | ISG Technology
25 Cabot Square | Canary Wharf | Floor 03
London, E14 4QA
Phone: +44 20 7425-8353
Mobile: +44 77878-92439
Will.Watson at morganstanley.com<mailto:Will.Watson at morganstanley.com>


Be carbon conscious. Please consider our environment before printing this email.



________________________________

NOTICE: Morgan Stanley is not acting as a municipal advisor and the opinions or views contained herein are not intended to be, and do not constitute, advice within the meaning of Section 975 of the Dodd-Frank Wall Street Reform and Consumer Protection Act. If you have received this communication in error, please destroy all electronic and paper copies and notify the sender immediately. Mistransmission is not intended to waive confidentiality or privilege. Morgan Stanley reserves the right, to the extent permitted under applicable law, to monitor electronic communications. This message is subject to terms available at the following link: http://www.morganstanley.com/disclaimers If you cannot access these links, please notify us by reply message and we will send the contents to you. By messaging with Morgan Stanley you consent to the foregoing.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20130612/931abfbe/attachment-0001.html>

From vinc.pii at gmail.com  Wed Jun 12 16:06:39 2013
From: vinc.pii at gmail.com (Vincenzo Pii)
Date: Wed, 12 Jun 2013 14:06:39 -0000
Subject: [docs] Improvement on argparse documentation
Message-ID: <CALOiZS2zj0bY5T2mUfJYsTAoiRrB2S30yysJfYQMzEkd3m-s9w@mail.gmail.com>

In the "short options" paragraph (
http://docs.python.org/2/howto/argparse.html#short-options), please specify
that when only the short option is provided for one argument, the value of
the option can be accessed by using the name of the short option without
the '-' character.

Example:

parser.add_argument("-b", help="builds the application",
action="store_true")

if (args.b == True):

Thanks,
Vincenzo.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20130612/bbac0390/attachment-0001.html>

From tintypemolly at gmail.com  Fri Jun 28 08:10:01 2013
From: tintypemolly at gmail.com (=?UTF-8?B?7Jik7KeE6reg?=)
Date: Fri, 28 Jun 2013 06:10:01 -0000
Subject: [docs] I found bugs in the Queue documentation
Message-ID: <CAEpyERub=nGZ3eptdK9L5ZEHCzqmSHzYa3OjiUtgxS1kUe6JHA@mail.gmail.com>

http://docs.python.org/2/library/queue.html

There are two typing errors in this document

http://docs.python.org/2/library/queue.html#Queue.Queue.put
http://docs.python.org/2/library/queue.html#Queue.Queue.get

there is a same sentence within this two function descriptions,

If optional args *block* is true and *timeout* is None (the default)

In this sentence, I think it should be "True" not "true" because it stands
for actual python Boolean value.

Thanks.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20130628/5f13d702/attachment-0001.html>

From support at oeko.net  Mon Jun  3 22:22:24 2013
From: support at oeko.net (Toni Mueller)
Date: Mon, 03 Jun 2013 20:22:24 -0000
Subject: [docs] Python license table
Message-ID: <20130603201355.GD26798@spruce.wiehl.oeko.net>


Hi,

I notice that the table with Python licenses ends at 2.7, and makes no
mentioning of licenses for Python 3.

It would be nice if you could amend the table.



Kind regards,
--Toni++