From report at bugs.python.org  Fri Apr  1 18:30:19 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Fri, 01 Apr 2011 16:30:19 +0000
Subject: [docs] [issue11690] Devguide: Add "communication" FAQ
In-Reply-To: <1301188192.33.0.9529618781.issue11690@psf.upfronthosting.co.za>
Message-ID: <1301675419.66.0.291002741236.issue11690@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Apr  1 18:33:03 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Fri, 01 Apr 2011 16:33:03 +0000
Subject: [docs] [issue11710] Landing pages in docs for standard library
	packages
In-Reply-To: <1301401907.02.0.216152132906.issue11710@psf.upfronthosting.co.za>
Message-ID: <1301675583.7.0.184741420766.issue11710@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Apr  1 18:42:43 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 01 Apr 2011 16:42:43 +0000
Subject: [docs] [issue11710] Landing pages in docs for standard library
	packages
In-Reply-To: <1301401907.02.0.216152132906.issue11710@psf.upfronthosting.co.za>
Message-ID: <1301676163.42.0.298539827576.issue11710@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

It works with docs.python.org/py3k/library/urllib

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

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

From report at bugs.python.org  Fri Apr  1 18:51:02 2011
From: report at bugs.python.org (Nick Coghlan)
Date: Fri, 01 Apr 2011 16:51:02 +0000
Subject: [docs] [issue11710] Landing pages in docs for standard library
	packages
In-Reply-To: <1301401907.02.0.216152132906.issue11710@psf.upfronthosting.co.za>
Message-ID: <1301676662.49.0.393283805958.issue11710@psf.upfronthosting.co.za>


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

That link goes to a 404 error page for me.

----------

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

From report at bugs.python.org  Fri Apr  1 18:54:19 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 01 Apr 2011 16:54:19 +0000
Subject: [docs] [issue11710] Landing pages in docs for standard library
	packages
In-Reply-To: <1301401907.02.0.216152132906.issue11710@psf.upfronthosting.co.za>
Message-ID: <1301676859.24.0.523017484624.issue11710@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

Okay, now I understand your request: a spam package should have a page at library/spam in addition to submodules pages.  +1.

----------
versions: +Python 2.7, Python 3.1

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

From report at bugs.python.org  Fri Apr  1 19:06:25 2011
From: report at bugs.python.org (Nick Coghlan)
Date: Fri, 01 Apr 2011 17:06:25 +0000
Subject: [docs] [issue11710] Landing pages in docs for standard library
	packages
In-Reply-To: <1301401907.02.0.216152132906.issue11710@psf.upfronthosting.co.za>
Message-ID: <1301677585.74.0.78769663358.issue11710@psf.upfronthosting.co.za>


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

Oh, I see the confusion - yeah, the missing "library" in the URL in my first post was just a typo. It was actually present in my test URLs (otherwise the 4 packages with landing pages wouldn't have worked).

The problem in 2.7 is smaller, since there aren't as a many packages - only xml and xmlrpc are missing landing pages in that version.

----------

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

From report at bugs.python.org  Sat Apr  2 01:39:29 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 01 Apr 2011 23:39:29 +0000
Subject: [docs] [issue11676] Improve imp.load_module and submodules doc
In-Reply-To: <1301089227.12.0.157951103986.issue11676@psf.upfronthosting.co.za>
Message-ID: <1301701169.01.0.138798729959.issue11676@psf.upfronthosting.co.za>


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

I verified this for 3.2 (and IDLE) with

import sys, tkinter
"ttk" in dir(sys.modules['tkinter']) # False
import tkinter.ttk
"ttk" in dir(sys.modules['tkinter']) # True

====reload========

import sys,imp
imp.load_module('tkinter',*imp.find_module('tkinter'))
imp.load_module('tkinter.ttk',*imp.find_module('ttk',
  sys.modules["tkinter"].__path__))
"ttk" in dir(sys.modules['tkinter']) # False
from tkinter import ttk # ImportError

Given that 'ttk' is only added to the tkinter entry when ttk is imported via tkinter, I am not surprised that the direct import with imp fails to affect the tkinter entry. Imp would have to notice that ttk is in a directory with __init__, get the name of the parent directory, and then check to see whether or not that parent had already been imported. Unlike import

import ttk #fails

imp does not require such a previous import:

imp.load_module('ttk',*imp.find_module('ttk',
 ["C:/programs/python32/Lib/tkinter"]))

succeeds, which shows again that import and imp act differently.

Dave, can you suggest added text and a location to put it?

Hmmm. How about after "If the load ...", add "A successful load does not affect previously loaded package modules as this function operates independently of package structure."

----------
nosy: +terry.reedy
title: imp.load_module and submodules - doc issue, or bug? -> Improve imp.load_module and submodules doc
versions: +Python 3.1, Python 3.2, Python 3.3 -Python 2.5, Python 2.6

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

From report at bugs.python.org  Sat Apr  2 02:06:29 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 02 Apr 2011 00:06:29 +0000
Subject: [docs] [issue11699] Doc for optparse.OptionParser.get_option_group
	is wrong
In-Reply-To: <1301301829.71.0.0713641718569.issue11699@psf.upfronthosting.co.za>
Message-ID: <1301702789.36.0.228669920965.issue11699@psf.upfronthosting.co.za>


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


----------
title: Documentation for get_option_group is wrong -> Doc for optparse.OptionParser.get_option_group is wrong

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

From report at bugs.python.org  Sat Apr  2 03:08:39 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 02 Apr 2011 01:08:39 +0000
Subject: [docs] [issue11726] linecache becomes specific to Python scripts in
	Python 3
In-Reply-To: <1301566082.59.0.198488725536.issue11726@psf.upfronthosting.co.za>
Message-ID: <1301706519.79.0.702124743663.issue11726@psf.upfronthosting.co.za>


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

The help(linecache) Description is more specific as to the intention (based on traceback usage):

"This is intended to read lines from modules imported -- hence if a filename is not found, it will look down the module search path for a file by that name."

My experiments show that this is too specific. It *can* read any file that it can find and decode as utf-8 (default, or you say, locale encoding or coding in cookie line). 

Find = absolute path
>>> linecache.getline('c:/programs/pydev/py32/LICENSE', 1)
'A. HISTORY OF THE SOFTWARE\n'

or relative path on sys.path
>>> linecache.getline('idlelib/ChangeLog', 1)
'Please refer to the IDLEfork and IDLE CVS repositories for\n'
>>> linecache.getline('idlelib/extend.txt', 1)
'Writing an IDLE extension\n'

Decode fails on byte illegal for utf-8:
>>> linecache.getline('idlelib/CREDITS.txt', 1)
UnicodeDecodeError: 'utf8' codec can't decode byte 0xf6 in position 1566: invalid start byte

(It reads and decodes entire file even though only line 1 was requested. It choked on L?wis. I believe Py3 distributed text files should be utf-8 instead of latin-1.)

If I got rules right, doc should say "Filename must be an absolute path or relative path that can be found on sys.path." and "File must be utf-8 encoded or locale encoded or a Python file with a coding cookie."

(If you tried /etc/passwd, how did it fail?)

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

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

From report at bugs.python.org  Sat Apr  2 22:39:51 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Sat, 02 Apr 2011 20:39:51 +0000
Subject: [docs] [issue11282] 3.3 unittest document not kept consist with code
In-Reply-To: <1298354999.37.0.375525915954.issue11282@psf.upfronthosting.co.za>
Message-ID: <1301776791.49.0.126606079832.issue11282@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

Guido decided to leave the fail* methods and assertDictContainsSubset in 3.3 (and possibly even in the following versions), so that people moving from 2.7 to 3.3 don't have to change their code because these methods are missing.
Since assertSameElements is not in 2.7, it can be removed in 3.3.

I will therefore backout r88451 and add back the fail* methods and assertDictContainsSubset.

----------
nosy: +gvanrossum, rhettinger

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

From nick at subtlepath.org  Fri Apr  1 02:42:52 2011
From: nick at subtlepath.org (Nick Walker)
Date: Thu, 31 Mar 2011 17:42:52 -0700
Subject: [docs] documentation error
Message-ID: <20110401004252.GI7819@subtlepath.org>

page: http://docs.python.org/library/email-examples.html

In the first code sample:

s = smtplib.SMTP()
s.sendmail(me, [you], msg.as_string())
s.quit()

s.connect() is required before s.sendmail()

From j.kowalski at nencki.gov.pl  Fri Apr  1 10:56:31 2011
From: j.kowalski at nencki.gov.pl (Jakub Kowalski)
Date: Fri, 01 Apr 2011 10:56:31 +0200
Subject: [docs] A bug in Python v2.6.6 documentation
Message-ID: <4D95933F.5010709@nencki.gov.pl>

Hello,
I have found a bug in the chapter 9.7.1. Itertool functions:
product(A, B) is not equivalent to ((x,y) for x in A for y in B)

It is untrue for dependent iterators - and here is the proof:
 >>> class c:
...     def g(self):
...         for i in xrange(self.x):
...             yield i
...     def h(self, x):
...         for i in xrange(x):
...             self.x = i
...             yield i
 >>> for i in ((x, y) for x in d.h(4) for y in d.g()):
...     print i
(1, 0)
(2, 0)
(2, 1)
(3, 0)
(3, 1)
(3, 2)
 >>> for i in product(d.h(4), d.g()):
... print i
(0, 0)
(0, 1)
(0, 2)
(1, 0)
(1, 1)
(1, 2)
(2, 0)
(2, 1)
(2, 2)
(3, 0)
(3, 1)
(3, 2)

Greetings, J.Kowalski

From sandro.tosi at gmail.com  Sun Apr  3 15:17:49 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Sun, 3 Apr 2011 15:17:49 +0200
Subject: [docs] Error in The Python Tutorial
In-Reply-To: <AANLkTin_c0AD2kQdH+H_XOunF23fy7jg9imi9QNiwOBj@mail.gmail.com>
References: <AANLkTin_c0AD2kQdH+H_XOunF23fy7jg9imi9QNiwOBj@mail.gmail.com>
Message-ID: <BANLkTi=ENeJuhT0QzGbNizpyhYyU0dNcMw@mail.gmail.com>

Hi Dhaval,
thanks for your email.

On Mon, Mar 28, 2011 at 01:15, Dhaval Patel <dh.electro at gmail.com> wrote:
> Hi
>
> I am learning Python. As a part of my learning process, I found your
> tutorial very helpful.
>
> Today I have found error in section
>
> 4.4. break and continue Statements, and else Clauses on Loops
>
>>>> for n in range(2, 10):
> ...     for x in range(2, n):
> ...         if n % x == 0:
> ...             print n, 'equals', x, '*', n/x
> ...             break
> ...     else:
> ...         # loop fell through without finding a factor
> ...         print n, 'is a prime number'
> ...
> 2 is a prime number
> 3 is a prime number
> 4 equals 2 * 2
> 5 is a prime number
> 6 equals 2 * 3
> 7 is a prime number
> 8 equals 2 * 4
> 9 equals 3 * 3
>
>
>
> The first output
> 2 is a prime number is not coming out

do you mean this is not coming out when you're trying on your python
shell? what version of python are you using?

> I think when it goes in first inner for loop for x in range(2,2):
> range (2,2) is []

and that's correct, since it has to go into the 'else' branch.

> so it is not printing
> 2 is a prime number is not coming out
>
> I just want to make sure it my understanding is correct or there is mistake
> in document.

The doc is correct: I tried several times and it works as expected,
pay attention to the indentation of 'else' below the inner for loop.

Don't hesitate to ask further in case it's not clear enough.

Regards,
-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

From sandro.tosi at gmail.com  Sun Apr  3 16:52:55 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Sun, 3 Apr 2011 16:52:55 +0200
Subject: [docs] Typo in cProfile documentation
In-Reply-To: <310332436-1301286658-cardhu_decombobulator_blackberry.rim.net-799514591-@bda081.bisx.prod.on.blackberry>
References: <310332436-1301286658-cardhu_decombobulator_blackberry.rim.net-799514591-@bda081.bisx.prod.on.blackberry>
Message-ID: <BANLkTi=u8yfiD+hMTyYUcCpavTtVA39kCQ@mail.gmail.com>

Hi Kurt,
thanks for your email.

On Mon, Mar 28, 2011 at 06:30, Kurt McKee <contactme at kurtmckee.org> wrote:
> The note in section 26.3.1 uses the word "resonably" which should be spelled "reasonably".

Fixed in http://hg.python.org/cpython/rev/821244a44163

Regards,
-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

From report at bugs.python.org  Sun Apr  3 17:03:34 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 03 Apr 2011 15:03:34 +0000
Subject: [docs] [issue11282] 3.3 unittest document not kept consist with code
In-Reply-To: <1298354999.37.0.375525915954.issue11282@psf.upfronthosting.co.za>
Message-ID: <E1Q6Opw-0005gL-Q3@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 1fd736395df3 by Ezio Melotti in branch '3.2':
#11282: the fail* methods will stay around a few more versions.
http://hg.python.org/cpython/rev/1fd736395df3

New changeset 110bb604bc2f by Ezio Melotti in branch 'default':
#11282: merge with 3.2.
http://hg.python.org/cpython/rev/110bb604bc2f

New changeset aa658836e090 by Ezio Melotti in branch 'default':
#11282: add back the fail* methods and assertDictContainsSubset.
http://hg.python.org/cpython/rev/aa658836e090

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

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

From report at bugs.python.org  Sun Apr  3 19:01:33 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Sun, 03 Apr 2011 17:01:33 +0000
Subject: [docs] [issue11282] 3.3 unittest document not kept consist with code
In-Reply-To: <1298354999.37.0.375525915954.issue11282@psf.upfronthosting.co.za>
Message-ID: <1301850093.98.0.16610082279.issue11282@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Mon Apr  4 08:07:02 2011
From: report at bugs.python.org (Ned Deily)
Date: Mon, 04 Apr 2011 06:07:02 +0000
Subject: [docs] [issue10433] Document unique behavior of 'getgroups' on OSX
In-Reply-To: <1289916367.38.0.763799196023.issue10433@psf.upfronthosting.co.za>
Message-ID: <1301897221.89.0.978878476458.issue10433@psf.upfronthosting.co.za>


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

Here's a revised doc patch. As noted from my investigation in Issue7900, the key getgroups behavior change is with the OS X 10.6 ABI (so > 10.5), not 10.5.

----------
stage: needs patch -> commit review
Added file: http://bugs.python.org/file21528/issue10433-v2.patch

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

From report at bugs.python.org  Mon Apr  4 18:16:01 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Mon, 04 Apr 2011 16:16:01 +0000
Subject: [docs] [issue11762] Ast doc: warning and version number
In-Reply-To: <1301933761.05.0.937546235723.issue11762@psf.upfronthosting.co.za>
Message-ID: <1301933761.05.0.937546235723.issue11762@psf.upfronthosting.co.za>


New submission from Terry J. Reedy <tjreedy at udel.edu>:

Two related proposals.

1. Add a warning similar to the one for the dis module. As modified:

"CPython implementation detail: The ast definition is specific to the CPython interpreter! Ast nodes may be added, removed, or changed between versions. Use *ast.__version__* to work across versions."

I omitted " Use of this module should not be considered to work across Python VMs or Python releases." as redundant and too legalistic.
*ast.__version__* should link to its (new) entry).

2. Add a full entry for __version__. Currently (3.2):

"The module defines a string constant __version__ which is the decimal Subversion revision number of the file shown below."

Proposed replacement (with hidden reference point):

ast.__version__         [__version__ in normal entry boldface]
    String constant with version number of abstract grammar file.
    3.1: 67616; 3.2: 82163; 3.3: xxxxxxxxx

----------
assignee: docs at python
components: Documentation
messages: 132951
nosy: docs at python, terry.reedy
priority: normal
severity: normal
stage: needs patch
status: open
title: Ast doc: warning and version number
versions: Python 2.7, Python 3.2, Python 3.3

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

From report at bugs.python.org  Mon Apr  4 18:18:59 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Mon, 04 Apr 2011 16:18:59 +0000
Subject: [docs] [issue11762] Ast doc: warning and version number
In-Reply-To: <1301933761.05.0.937546235723.issue11762@psf.upfronthosting.co.za>
Message-ID: <1301933939.77.0.629346600192.issue11762@psf.upfronthosting.co.za>


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

Modify entry slightly to
    String constant with version number of the abstract grammar file.
    3.1: '67616'; 3.2: '82163'; 3.3: 'xxxxxxxxx'

----------
keywords: +patch

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

From report at bugs.python.org  Mon Apr  4 19:26:26 2011
From: report at bugs.python.org (Brian Curtin)
Date: Mon, 04 Apr 2011 17:26:26 +0000
Subject: [docs] [issue10175] vs version for win32 compilation of extension
	modules is	undocumented.
In-Reply-To: <1287795744.75.0.288699311556.issue10175@psf.upfronthosting.co.za>
Message-ID: <1301937986.91.0.0740889173517.issue10175@psf.upfronthosting.co.za>


Changes by Brian Curtin <brian at python.org>:


----------
nosy: +brian.curtin

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

From report at bugs.python.org  Tue Apr  5 22:46:46 2011
From: report at bugs.python.org (=?utf-8?q?=C5=81ukasz_Langa?=)
Date: Tue, 05 Apr 2011 20:46:46 +0000
Subject: [docs] [issue11670] configparser read_file now iterates over f,
	docs still say it calls readline
In-Reply-To: <1301047699.5.0.476245530251.issue11670@psf.upfronthosting.co.za>
Message-ID: <1302036405.94.0.382557737015.issue11670@psf.upfronthosting.co.za>


?ukasz Langa <lukasz at langa.pl> added the comment:

How about this? (available for review: http://codereview.appspot.com/4358054)

----------
keywords: +patch
Added file: http://bugs.python.org/file21547/issue11670.patch

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

From report at bugs.python.org  Tue Apr  5 22:53:25 2011
From: report at bugs.python.org (anatoly techtonik)
Date: Tue, 05 Apr 2011 20:53:25 +0000
Subject: [docs] [issue11776] types.MethodType() params and usage is not
	documented
In-Reply-To: <1302036805.33.0.506634428921.issue11776@psf.upfronthosting.co.za>
Message-ID: <1302036805.33.0.506634428921.issue11776@psf.upfronthosting.co.za>


New submission from anatoly techtonik <techtonik at gmail.com>:

types.MethodType(function, instance) is used as a replacement for new.instancemethod(function, instance, class), but this usage is not documented.

----------
assignee: docs at python
components: Documentation
messages: 133089
nosy: docs at python, techtonik
priority: normal
severity: normal
status: open
title: types.MethodType() params and usage is not documented
versions: Python 3.2

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

From report at bugs.python.org  Tue Apr  5 22:55:41 2011
From: report at bugs.python.org (Brian Curtin)
Date: Tue, 05 Apr 2011 20:55:41 +0000
Subject: [docs] [issue11776] types.MethodType() params and usage is not
	documented
In-Reply-To: <1302036805.33.0.506634428921.issue11776@psf.upfronthosting.co.za>
Message-ID: <1302036941.89.0.593430826948.issue11776@psf.upfronthosting.co.za>


Changes by Brian Curtin <brian at python.org>:


----------
stage:  -> needs patch
type:  -> behavior

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

From report at bugs.python.org  Wed Apr  6 16:59:37 2011
From: report at bugs.python.org (Nick Coghlan)
Date: Wed, 06 Apr 2011 14:59:37 +0000
Subject: [docs] [issue10977] Concrete object C API needs abstract path for
	subclasses	of builtin types
In-Reply-To: <1295653779.62.0.836506069174.issue10977@psf.upfronthosting.co.za>
Message-ID: <1302101977.27.0.139580416211.issue10977@psf.upfronthosting.co.za>


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

Changing the affected components. Antoine and Benjamin are right, this needs to be handled as a documentation and education problem.

Raymond's suggestion can too easily trigger infinite recursion and mine would block legitimate use cases in 3rd party code.

For heapq, we can just fix it to include the fallbacks to the abstract versions if PyList_CheckExact() fails.

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

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

From report at bugs.python.org  Wed Apr  6 17:14:52 2011
From: report at bugs.python.org (Patrick Sabin)
Date: Wed, 06 Apr 2011 15:14:52 +0000
Subject: [docs] [issue11784] multiprocessing.Process.join: timeout argument
	doesn't	specify time unit.
In-Reply-To: <1302102892.38.0.716462659094.issue11784@psf.upfronthosting.co.za>
Message-ID: <1302102892.38.0.716462659094.issue11784@psf.upfronthosting.co.za>


New submission from Patrick Sabin <patricksabin at gmx.at>:

The documentation of multiprocessing.Process.join doesn't tell the user
of which time unit the timeout argument is. It seems to be seconds.

----------
assignee: docs at python
components: Documentation
files: join-timeout-doc-improvement.patch
keywords: patch
messages: 133142
nosy: docs at python, pyfex
priority: normal
severity: normal
status: open
title: multiprocessing.Process.join: timeout argument doesn't specify time unit.
type: behavior
Added file: http://bugs.python.org/file21551/join-timeout-doc-improvement.patch

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

From report at bugs.python.org  Wed Apr  6 17:57:47 2011
From: report at bugs.python.org (ysj.ray)
Date: Wed, 06 Apr 2011 15:57:47 +0000
Subject: [docs] [issue11785] email subpackages documentation problems
In-Reply-To: <1302105466.45.0.930997240631.issue11785@psf.upfronthosting.co.za>
Message-ID: <1302105466.45.0.930997240631.issue11785@psf.upfronthosting.co.za>


New submission from ysj.ray <ysj.ray at gmail.com>:

All the module name in the first line of email subpackages' documentation files(Doc/library/email.xxx.rst) are incorrect: all of them are "email" but not "email.xxx"

Besides, the Doc/library/email-examples.rst is not a module and it uses ":mod:`email`: xxx"

----------
assignee: docs at python
components: Documentation
files: email_subpackages_document_problems.diff
keywords: patch
messages: 133143
nosy: docs at python, ysj.ray
priority: normal
severity: normal
status: open
title: email subpackages documentation problems
versions: Python 3.1, Python 3.2, Python 3.3
Added file: http://bugs.python.org/file21552/email_subpackages_document_problems.diff

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

From report at bugs.python.org  Wed Apr  6 18:01:11 2011
From: report at bugs.python.org (R. David Murray)
Date: Wed, 06 Apr 2011 16:01:11 +0000
Subject: [docs] [issue11785] email subpackages documentation problems
In-Reply-To: <1302105466.45.0.930997240631.issue11785@psf.upfronthosting.co.za>
Message-ID: <1302105671.17.0.665243278053.issue11785@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Wed Apr  6 18:01:41 2011
From: report at bugs.python.org (ysj.ray)
Date: Wed, 06 Apr 2011 16:01:41 +0000
Subject: [docs] [issue11785] email subpackages documentation problems
In-Reply-To: <1302105466.45.0.930997240631.issue11785@psf.upfronthosting.co.za>
Message-ID: <1302105701.62.0.0575938301293.issue11785@psf.upfronthosting.co.za>


ysj.ray <ysj.ray at gmail.com> added the comment:

And this causes the toctree in email doc(http://docs.python.org/dev/library/email.html) in correct. All of the tree elements' names are displayed as "email".

----------

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

From report at bugs.python.org  Wed Apr  6 19:17:57 2011
From: report at bugs.python.org (Adam Groszer)
Date: Wed, 06 Apr 2011 17:17:57 +0000
Subject: [docs] [issue11786] ConfigParser.[Raw]ConfigParser optionxform()
In-Reply-To: <1302110277.82.0.57770456199.issue11786@psf.upfronthosting.co.za>
Message-ID: <1302110277.82.0.57770456199.issue11786@psf.upfronthosting.co.za>


New submission from Adam Groszer <agroszer at gmail.com>:

The documentation http://docs.python.org/library/configparser.html states that optionxform() is used only beginning ConfigParser.ConfigParser, whereas it is ALSO in effect for ConfigParser.RawConfigParser. (As I checked in the source)

----------
assignee: docs at python
components: Documentation
messages: 133148
nosy: Adam.Groszer, docs at python
priority: normal
severity: normal
status: open
title: ConfigParser.[Raw]ConfigParser optionxform()
type: behavior
versions: Python 2.7

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

From report at bugs.python.org  Wed Apr  6 19:24:55 2011
From: report at bugs.python.org (=?utf-8?q?=C5=81ukasz_Langa?=)
Date: Wed, 06 Apr 2011 17:24:55 +0000
Subject: [docs] [issue11786] ConfigParser.[Raw]ConfigParser optionxform()
In-Reply-To: <1302110277.82.0.57770456199.issue11786@psf.upfronthosting.co.za>
Message-ID: <1302110695.56.0.299605209995.issue11786@psf.upfronthosting.co.za>


Changes by ?ukasz Langa <lukasz at langa.pl>:


----------
assignee: docs at python -> lukasz.langa
nosy: +lukasz.langa

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

From report at bugs.python.org  Wed Apr  6 19:43:33 2011
From: report at bugs.python.org (=?utf-8?q?=C5=81ukasz_Langa?=)
Date: Wed, 06 Apr 2011 17:43:33 +0000
Subject: [docs] [issue11786] ConfigParser.[Raw]ConfigParser optionxform()
In-Reply-To: <1302110277.82.0.57770456199.issue11786@psf.upfronthosting.co.za>
Message-ID: <1302111813.68.0.479273620258.issue11786@psf.upfronthosting.co.za>


?ukasz Langa <lukasz at langa.pl> added the comment:

The documentation may be poorly worded but `optionxform()` has always been used also by RawConfigParser. It has been that way since the introduction of this class in Python 2.3 (previously there was only one ConfigParser class which used `optionxform()` since at least Python 1.6).

Both the documentation and the code have seen significant updates in Python 3.2 and there the situation is more explicit.

I'll rephrase the docs for 2.7.

----------
resolution:  -> accepted

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

From report at bugs.python.org  Wed Apr  6 22:58:47 2011
From: report at bugs.python.org (R. David Murray)
Date: Wed, 06 Apr 2011 20:58:47 +0000
Subject: [docs] [issue11785] email subpackages documentation problems
In-Reply-To: <1302105466.45.0.930997240631.issue11785@psf.upfronthosting.co.za>
Message-ID: <1302123527.66.0.910497097029.issue11785@psf.upfronthosting.co.za>


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


----------
assignee: docs at python -> r.david.murray

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

From report at bugs.python.org  Wed Apr  6 23:55:21 2011
From: report at bugs.python.org (Carsten Klein)
Date: Wed, 06 Apr 2011 21:55:21 +0000
Subject: [docs] [issue11789] Extend upon metaclass/type class documentation,
	here: zope.interface and usage of instances of classes as base
	classes
In-Reply-To: <1302126921.15.0.0291977163306.issue11789@psf.upfronthosting.co.za>
Message-ID: <1302126921.15.0.0291977163306.issue11789@psf.upfronthosting.co.za>


New submission from Carsten Klein <carsten.klein at axn-software.de>:

In zope.interface, you have something the following construct:

class InterfaceBase:
  pass

Interface = InterfaceBase()



Using the above Interface as a derivation base for your own classes, will make that instance a type derived class:

class IFoo(Interface):
  pass

type(IFoo)
-> Interface

type(Interface)
-> type


I wonder why this behavior is not documented in the official documentation, or at least, I was unable to find it there...

----------
assignee: docs at python
components: Documentation
messages: 133173
nosy: carsten.klein, docs at python
priority: normal
severity: normal
status: open
title: Extend upon metaclass/type class documentation, here: zope.interface and usage of instances of classes as base classes
type: feature request
versions: Python 3.2

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

From report at bugs.python.org  Thu Apr  7 00:22:22 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Wed, 06 Apr 2011 22:22:22 +0000
Subject: [docs] [issue10977] Concrete object C API needs abstract path for
	subclasses	of builtin types
In-Reply-To: <1295653779.62.0.836506069174.issue10977@psf.upfronthosting.co.za>
Message-ID: <1302128542.41.0.206474137119.issue10977@psf.upfronthosting.co.za>


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

One thing that could be done is to have an optional warning in the mutating concrete C API functions that gets triggered whenever the input doesn't have an exact type match.  That will let people discover incorrect uses.

We could also scour our own stdlib code to see if there are any cases where there needs to be an alternate code patch for subclasses of builtin types.

I did a scan for PyList_SetItem and found that we were already pretty good about only using it when the target was known to be an exact list. Though those results were good, I'm not hopeful for a similar result with PyDict_SetItem.

In the mean time this bug will preclude a C version of OrderedDict from being a dict subclass.  That's unfortunate because it means that the C version can't be a drop-in replacement for the existing pure python OrderedDict.

----------

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

From report at bugs.python.org  Thu Apr  7 06:50:19 2011
From: report at bugs.python.org (Nick Coghlan)
Date: Thu, 07 Apr 2011 04:50:19 +0000
Subject: [docs] [issue10977] Concrete object C API needs abstract path for
	subclasses	of builtin types
In-Reply-To: <1295653779.62.0.836506069174.issue10977@psf.upfronthosting.co.za>
Message-ID: <1302151819.09.0.724675886969.issue10977@psf.upfronthosting.co.za>


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

I thought about a warning, but the problem is that a subclass using the concrete API as part of its *implementation* of the associated slot or method is actually perfectly correct usage.

I'm not sure this is enough to give up on the idea of OrderedDict being a dict subclass implemented in C, though. It seems to me that some defensive internal checks (to pick up state corruption due to this problem) would be a lesser evil than giving up on being a dict subclass.

----------

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

From report at bugs.python.org  Thu Apr  7 10:58:02 2011
From: report at bugs.python.org (Nick Coghlan)
Date: Thu, 07 Apr 2011 08:58:02 +0000
Subject: [docs] [issue11794] Backport new logging docs to 2.7
In-Reply-To: <1302166682.89.0.483892888748.issue11794@psf.upfronthosting.co.za>
Message-ID: <1302166682.89.0.483892888748.issue11794@psf.upfronthosting.co.za>


New submission from Nick Coghlan <ncoghlan at gmail.com>:

Vinay did some great work on the logging documentation for 3.2 (http://docs.python.org/py3k/library/logging).

However, a lot of people will currently miss it, since they land on the existing 2.7 documentation (http://docs.python.org/library/logging) instead.

A backport would update the web site immediately, and then be incorporated in the bundled documentation when 2.7.2 is released (presumably later this year).

Backporting should be relatively straightforward (since logging hasn't changed *that* much between 2.7 and 3.2), but isn't completely trivial (since details of the Python 3 only items will need to be removed and the "changed in" and "added in" notices will need to be updated to reflect the information in the existing 2.x series documentation)

----------
assignee: docs at python
components: Documentation
keywords: easy
messages: 133200
nosy: docs at python, ncoghlan
priority: normal
severity: normal
status: open
title: Backport new logging docs to 2.7
versions: Python 2.7

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

From report at bugs.python.org  Thu Apr  7 11:45:44 2011
From: report at bugs.python.org (Georg Brandl)
Date: Thu, 07 Apr 2011 09:45:44 +0000
Subject: [docs] [issue11762] Ast doc: warning and version number
In-Reply-To: <1301933761.05.0.937546235723.issue11762@psf.upfronthosting.co.za>
Message-ID: <1302169544.26.0.210991607077.issue11762@psf.upfronthosting.co.za>


Georg Brandl <georg at python.org> added the comment:

Sounds good to me, except for "Use *ast.__version__* to work across versions." which is not quite clear.

While talking about version numbers, we should probably also document *what changed* between those versions.

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

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

From report at bugs.python.org  Thu Apr  7 11:50:47 2011
From: report at bugs.python.org (Georg Brandl)
Date: Thu, 07 Apr 2011 09:50:47 +0000
Subject: [docs] [issue11789] Extend upon metaclass/type class documentation,
	here: zope.interface and usage of instances of classes as base
	classes
In-Reply-To: <1302126921.15.0.0291977163306.issue11789@psf.upfronthosting.co.za>
Message-ID: <1302169847.86.0.805690528451.issue11789@psf.upfronthosting.co.za>


Georg Brandl <georg at python.org> added the comment:

This doesn't work as you show.  What you probably meant was something like this:

class InterfaceBase(type):
    ...

Interface = InterfaceBase('Interface', (), {})

class IFoo(Interface):
    ...


which you can just as well do by using normal metaclass syntax.

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

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

From report at bugs.python.org  Fri Apr  8 11:59:10 2011
From: report at bugs.python.org (Vinay Sajip)
Date: Fri, 08 Apr 2011 09:59:10 +0000
Subject: [docs] [issue11794] Backport new logging docs to 2.7
In-Reply-To: <1302166682.89.0.483892888748.issue11794@psf.upfronthosting.co.za>
Message-ID: <1302256750.8.0.427389617507.issue11794@psf.upfronthosting.co.za>


Changes by Vinay Sajip <vinay_sajip at yahoo.co.uk>:


----------
assignee: docs at python -> vinay.sajip
nosy: +vinay.sajip

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

From report at bugs.python.org  Fri Apr  8 12:43:04 2011
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 08 Apr 2011 10:43:04 +0000
Subject: [docs] [issue11794] Backport new logging docs to 2.7
In-Reply-To: <1302166682.89.0.483892888748.issue11794@psf.upfronthosting.co.za>
Message-ID: <E1Q899b-0000pP-3w@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 6fb033af9310 by Vinay Sajip in branch '2.7':
Issue #11794: Reorganised logging documentation.
http://hg.python.org/cpython/rev/6fb033af9310

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

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

From report at bugs.python.org  Fri Apr  8 12:44:09 2011
From: report at bugs.python.org (Vinay Sajip)
Date: Fri, 08 Apr 2011 10:44:09 +0000
Subject: [docs] [issue11794] Backport new logging docs to 2.7
In-Reply-To: <1302166682.89.0.483892888748.issue11794@psf.upfronthosting.co.za>
Message-ID: <1302259449.88.0.462595640394.issue11794@psf.upfronthosting.co.za>


Changes by Vinay Sajip <vinay_sajip at yahoo.co.uk>:


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

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

From report at bugs.python.org  Fri Apr  8 17:15:56 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 08 Apr 2011 15:15:56 +0000
Subject: [docs] [issue11794] Backport new logging docs to 2.7
In-Reply-To: <1302166682.89.0.483892888748.issue11794@psf.upfronthosting.co.za>
Message-ID: <1302275756.75.0.447220670573.issue11794@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

Great stuff!

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

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

From report at bugs.python.org  Fri Apr  8 17:45:35 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 08 Apr 2011 15:45:35 +0000
Subject: [docs] [issue11785] email subpackages documentation problems
In-Reply-To: <1302105466.45.0.930997240631.issue11785@psf.upfronthosting.co.za>
Message-ID: <1302277535.8.0.605650476902.issue11785@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

See also http://sphinx.pocoo.org/domains.html#directive-py:currentmodule

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

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

From report at bugs.python.org  Fri Apr  8 17:46:16 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 08 Apr 2011 15:46:16 +0000
Subject: [docs] [issue11785] email subpackages documentation problems
In-Reply-To: <1302105466.45.0.930997240631.issue11785@psf.upfronthosting.co.za>
Message-ID: <1302277576.86.0.16877993012.issue11785@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

> Besides, the Doc/library/email-examples.rst is not a module and it
> uses ":mod:`email`: xxx"

Not a problem.  ?:mod:? is not ?.. module::?.  See above link.

----------

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

From report at bugs.python.org  Sat Apr  9 01:10:19 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 08 Apr 2011 23:10:19 +0000
Subject: [docs] [issue11776] types.MethodType() params and usage is not
	documented
In-Reply-To: <1302036805.33.0.506634428921.issue11776@psf.upfronthosting.co.za>
Message-ID: <1302304219.04.0.110922169366.issue11776@psf.upfronthosting.co.za>


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

All the types in the types module are, being types, potentially callable to produce instances of that type. But they are in types rather than builtins precisely because it is not expected that they be called directly. They are bound to names in types primarily for isinstance checks, and possibly issubclass checks. So none of their signatures are documented in types. It would be an anomaly to add something special for MethodType. So my first impulse is to close this. Do you have a source for your statement?

----------
nosy: +terry.reedy
type: behavior -> feature request

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

From report at bugs.python.org  Sat Apr  9 01:21:32 2011
From: report at bugs.python.org (anatoly techtonik)
Date: Fri, 08 Apr 2011 23:21:32 +0000
Subject: [docs] [issue11776] types.MethodType() params and usage is not
	documented
In-Reply-To: <1302036805.33.0.506634428921.issue11776@psf.upfronthosting.co.za>
Message-ID: <1302304892.21.0.7169493925.issue11776@psf.upfronthosting.co.za>


anatoly techtonik <techtonik at gmail.com> added the comment:

Message is classified as spam. I am not sure if you see it.

----------

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

From report at bugs.python.org  Sat Apr  9 02:22:10 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 09 Apr 2011 00:22:10 +0000
Subject: [docs] [issue11796] list and generator expressions in a class
	definition	fail if expression condition refers to a class variable
In-Reply-To: <1302180921.17.0.22284518515.issue11796@psf.upfronthosting.co.za>
Message-ID: <1302308530.88.0.0436116215518.issue11796@psf.upfronthosting.co.za>


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

Devs are aware that there is an exception to the general rule for the 'for' clause. There is a technical reason why the exception is possible, though I have forgotten it.

Since you already know that changing the general behavior has been rejected, are you asking that the exception be removed (for consistency) , so that your first example would fail? If so, that will be rejected also.

I am changing this to a doc issue in case you or someone else wishes to suggest a doc improvement.

The solution to the limitation on generator expressions, of course, is to write out the generator one is trying to abbreviate.

def clipper(max):
    for i in range(5):
        if i < max:
            yield i

class Foo:
    x = 3
    y = list(clipper(x))

print(Foo.y)
# [0, 1, 2]

----------
assignee:  -> docs at python
components: +Documentation -Interpreter Core
nosy: +docs at python, terry.reedy
stage:  -> needs patch
versions: +Python 3.3

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

From report at bugs.python.org  Sat Apr  9 02:31:27 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 09 Apr 2011 00:31:27 +0000
Subject: [docs] [issue11796] Comprehensions in a class definition mostly
	cannot	access class variable
In-Reply-To: <1302180921.17.0.22284518515.issue11796@psf.upfronthosting.co.za>
Message-ID: <1302309087.58.0.583584173045.issue11796@psf.upfronthosting.co.za>


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

Title changed.
Generator expressions had the same limitation in 2.x.
All comprehensions have the same limitation in 3.x.

----------
title: list and generator expressions in a class definition fail if expression condition refers to a class variable -> Comprehensions in a class definition mostly cannot access class variable

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

From report at bugs.python.org  Sat Apr  9 02:42:52 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Sat, 09 Apr 2011 00:42:52 +0000
Subject: [docs] [issue11796] Comprehensions in a class definition mostly
	cannot	access class variable
In-Reply-To: <1302180921.17.0.22284518515.issue11796@psf.upfronthosting.co.za>
Message-ID: <1302309772.6.0.910712882813.issue11796@psf.upfronthosting.co.za>


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

> Devs are aware that there is an exception to the general rule
>  for the 'for' clause. There is a technical reason why the 
> exception is possible, though I have forgotten it.

It is best understood when thinking about a gexexp that
gets run long after is created:

   ge = (result_exp(loop_var) for loop_var in iter_exp)
 
The idea was to have the body of the iterator expression, iter_exp, fail early, before the generator is run and while the local context is still set=up and available:

   ge = (1/0 for i in pow('a', 'b'))

We want the TypeError for pow to be raised immediately.  And if a valid expression were evaluated, we would want the body's ZeroDivisionError to be raised only when the generator is invoked using next(ge()).

In the former case, the local context is still available.  In the latter case, it could be long gone.

----------

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

From report at bugs.python.org  Sat Apr  9 03:00:03 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 09 Apr 2011 01:00:03 +0000
Subject: [docs] [issue11776] types.MethodType() params and usage is not
	documented
In-Reply-To: <1302036805.33.0.506634428921.issue11776@psf.upfronthosting.co.za>
Message-ID: <1302310803.64.0.348822747401.issue11776@psf.upfronthosting.co.za>


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

Messages that only consist of links are classified that way. To refer to other issues, use #xxxxx, as with #6040, but I have no idea which of the many messages you were referring to, so use msgxxxxxx.

The stack overflow link
http://stackoverflow.com/questions/972/adding-a-method-to-an-existing-object
which should be allowed given surrounding text, answers my question:
types.MethodType can be used as a replacement for 2.x new.instancemethod.

The question is where that should be mentioned. The types doc still seems like the wrong place. Perhaps somewhere in the language ref section on classes, if that is where bound methods are discussed.

----------

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

From report at bugs.python.org  Sat Apr  9 03:00:09 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 09 Apr 2011 01:00:09 +0000
Subject: [docs] [issue11776] types.MethodType() params and usage is not
	documented
In-Reply-To: <1302036805.33.0.506634428921.issue11776@psf.upfronthosting.co.za>
Message-ID: <1302310809.1.0.121208581686.issue11776@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Apr  9 03:01:19 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 09 Apr 2011 01:01:19 +0000
Subject: [docs] [issue11776] types.MethodType() params and usage is not
	documented
In-Reply-To: <1302036805.33.0.506634428921.issue11776@psf.upfronthosting.co.za>
Message-ID: <1302310879.93.0.354621290881.issue11776@psf.upfronthosting.co.za>


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

For anyone curious, I removed the falsely classified as spam message after copying the links into my previous message.

----------

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

From report at bugs.python.org  Sat Apr  9 03:55:31 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 09 Apr 2011 01:55:31 +0000
Subject: [docs] [issue11796] Comprehensions in a class definition mostly
	cannot	access class variable
In-Reply-To: <1302180921.17.0.22284518515.issue11796@psf.upfronthosting.co.za>
Message-ID: <1302314131.5.0.681504806361.issue11796@psf.upfronthosting.co.za>


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

Thanks. I remember now: the initial iter_exp is evaluated immediately because it always *can* be, because it is only evaluated once and can only involve 'outside' names, whereas the result expression and any conditional expressions and further iteration expressions cannot be (evaluated immediately) because in general they usually involve the loop_var and are evaluated many times, each time with a different value of the loop_var (which are not available until the code is run).

The current 3.2 doc more or less says this already, though in fewer words.

To put it another way, the iter_exp either becomes or is treated like a parameter default value expression, so that

ge = (result_exp(loop_var) for loop_var in iter_exp)

is like

def __gf__(_it=iter_exp):
    for loop_var in _it:
        yield result_exp(loop_var)
ge = __gf__()
del __gf__

I wonder if something like this should be added to 5.2.8. Generator expressions, with that section moved up before the set/list/dict displays sections, and with the comprehension grammar included therein.

If one does *not* want the immediately evaluation of the iter_exp (which does not normally happen in generator functions) then, again, one should write a generator function. 

I guess the real lesson is that in 3.x, while comprehensions (including g.e.'s are very similar to nested loops and conditions or generator functions with the same, they are not identical in scoping behavior and need to be thought of as their own thing and not only as syntactic sugar. This is probably easier for people who start with 3.x ;-).

Along that line, here is another replacement for the not-working example 2:

class Foo:
    x = 3
    y = []
    for z in range(5):
        if z < x:
            y.append(z)

print(Foo.y)
# [0, 1, 2]

----------

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

From report at bugs.python.org  Sat Apr  9 08:00:20 2011
From: report at bugs.python.org (anatoly techtonik)
Date: Sat, 09 Apr 2011 06:00:20 +0000
Subject: [docs] [issue11776] types.MethodType() params and usage is not
	documented
In-Reply-To: <1302036805.33.0.506634428921.issue11776@psf.upfronthosting.co.za>
Message-ID: <1302328820.11.0.463788395133.issue11776@psf.upfronthosting.co.za>


anatoly techtonik <techtonik at gmail.com> added the comment:

Nevermind about #6040 - I just used the same technique to provide a workaround and then remembered I've seen this recipe on StackOverflow.

To me types is the right place, because that's exactly where are you sent from the docs of new module:

  Deprecated since version 2.6: The new module has been removed in Python 3.0. Use the types module?s classes instead.

http://docs.python.org/library/new.html

----------

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

From report at bugs.python.org  Sat Apr  9 09:43:10 2011
From: report at bugs.python.org (Georg Brandl)
Date: Sat, 09 Apr 2011 07:43:10 +0000
Subject: [docs] [issue11776] types.MethodType() params and usage is not
	documented
In-Reply-To: <1302036805.33.0.506634428921.issue11776@psf.upfronthosting.co.za>
Message-ID: <1302334990.24.0.677134087993.issue11776@psf.upfronthosting.co.za>


Georg Brandl <georg at python.org> added the comment:

When we do document types, their constructors and methods should also be documented.  This is a valid request.

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

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

From report at bugs.python.org  Sat Apr  9 10:36:37 2011
From: report at bugs.python.org (=?utf-8?q?Bo=C5=A1tjan_Mejak?=)
Date: Sat, 09 Apr 2011 08:36:37 +0000
Subject: [docs] [issue11806] Missing 2 hyphens in the docs
In-Reply-To: <1302338197.1.0.100311254016.issue11806@psf.upfronthosting.co.za>
Message-ID: <1302338197.1.0.100311254016.issue11806@psf.upfronthosting.co.za>


New submission from Bo?tjan Mejak <bostjan.mejak at gmail.com>:

Please see  http://docs.python.org/py3k/library/argparse.html#module-argparse  and read the first sentence which goes...

"The argparse module makes it easy to write user friendly command line interfaces."

Please fix this to...

"The argparse module makes it easy to write user-friendly command-line interfaces."

Note: "user friendly" --> "user-friendly"
      "command line" --> "command-line"

----------
assignee: docs at python
components: Documentation
messages: 133377
nosy: Retro, docs at python
priority: normal
severity: normal
status: open
title: Missing 2 hyphens in the docs
versions: Python 3.2, Python 3.3, Python 3.4

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

From report at bugs.python.org  Sat Apr  9 11:04:50 2011
From: report at bugs.python.org (Menno Smits)
Date: Sat, 09 Apr 2011 09:04:50 +0000
Subject: [docs] [issue11796] Comprehensions in a class definition mostly
	cannot	access class variable
In-Reply-To: <1302180921.17.0.22284518515.issue11796@psf.upfronthosting.co.za>
Message-ID: <1302339890.02.0.540957324141.issue11796@psf.upfronthosting.co.za>


Menno Smits <menno at freshfoo.com> added the comment:

Thanks to everyone for the explanations.

I was hoping for behaviour along the lines of Python 2 (certainly not artificially blocking more cases in the name of consistency) but it doesn't look like that's going to happen. I think this is one slight and rare area where Python 3 has taken a step backwards when compared to Python 2 but I can live with it. As noted there's other ways to achieve the same thing.

The new Python 3 behaviour seems odd to me but perhaps that's just a bias due to many years of development with Python 2. A documentation improvement would help. 

Thanks.

----------

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

From report at bugs.python.org  Sat Apr  9 11:21:13 2011
From: report at bugs.python.org (=?utf-8?q?Filip_Gruszczy=C5=84ski?=)
Date: Sat, 09 Apr 2011 09:21:13 +0000
Subject: [docs] [issue11807] Documentation of add_subparsers lacks
	information about	parametres
In-Reply-To: <1302340872.99.0.0231583237732.issue11807@psf.upfronthosting.co.za>
Message-ID: <1302340872.99.0.0231583237732.issue11807@psf.upfronthosting.co.za>


New submission from Filip Gruszczy?ski <gruszczy at gmail.com>:

In argparse documentation parametres of add_subparsers are not listed. And yet there are some really useful parametres like parser_class. It would be useful, it they were described there well and one wouldn't have to look into the code to find them :-) I'll be happy to provide documentation patch tomorrow.

----------
assignee: docs at python
components: Documentation
messages: 133379
nosy: docs at python, gruszczy
priority: normal
severity: normal
status: open
title: Documentation of add_subparsers lacks information about parametres
versions: Python 3.2

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

From report at bugs.python.org  Sat Apr  9 11:22:12 2011
From: report at bugs.python.org (=?utf-8?q?Filip_Gruszczy=C5=84ski?=)
Date: Sat, 09 Apr 2011 09:22:12 +0000
Subject: [docs] [issue11807] Documentation of add_subparsers lacks
	information about	parametres
In-Reply-To: <1302340872.99.0.0231583237732.issue11807@psf.upfronthosting.co.za>
Message-ID: <1302340932.97.0.35712991497.issue11807@psf.upfronthosting.co.za>


Changes by Filip Gruszczy?ski <gruszczy at gmail.com>:


----------
nosy: +bethard

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

From report at bugs.python.org  Sun Apr 10 02:01:55 2011
From: report at bugs.python.org (Michael Foord)
Date: Sun, 10 Apr 2011 00:01:55 +0000
Subject: [docs] [issue11796] Comprehensions in a class definition mostly
	cannot	access class variable
In-Reply-To: <1302180921.17.0.22284518515.issue11796@psf.upfronthosting.co.za>
Message-ID: <1302393715.16.0.791676354166.issue11796@psf.upfronthosting.co.za>


Changes by Michael Foord <michael at voidspace.org.uk>:


----------
nosy: +michael.foord

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

From report at bugs.python.org  Sun Apr 10 09:10:39 2011
From: report at bugs.python.org (eduardo)
Date: Sun, 10 Apr 2011 07:10:39 +0000
Subject: [docs] [issue11818] tempfile.TemporaryFile example in docs doesnt
	work
In-Reply-To: <1302419439.43.0.340740214318.issue11818@psf.upfronthosting.co.za>
Message-ID: <1302419439.43.0.340740214318.issue11818@psf.upfronthosting.co.za>


New submission from eduardo <schettino72 at gmail.com>:

>From the example:
 http://docs.python.org/py3k/library/tempfile.html#examples

The error message is weird... but I guess the problem is the default mode 'w+b'.


Python 3.3a0 (default:78a66c98288d, Apr  9 2011, 16:13:31) 
[GCC 4.4.5] on linux2
Type "help", "copyright", "credits" or "license" for more information.
>>> import tempfile
>>> fp = tempfile.TemporaryFile()
>>> fp.write('hello')
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: 'str' does not support the buffer interface
>>> fp2 = tempfile.TemporaryFile('w+')
>>> fp2.write('hello')
5
>>>

----------
assignee: docs at python
components: Documentation, Library (Lib)
messages: 133447
nosy: docs at python, schettino72
priority: normal
severity: normal
status: open
title: tempfile.TemporaryFile example in docs doesnt work
versions: Python 3.2

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

From report at bugs.python.org  Sun Apr 10 09:41:49 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 10 Apr 2011 07:41:49 +0000
Subject: [docs] [issue11818] tempfile.TemporaryFile example in docs doesnt
	work
In-Reply-To: <1302419439.43.0.340740214318.issue11818@psf.upfronthosting.co.za>
Message-ID: <E1Q8pHH-0006yO-GW@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 87d89f767b23 by Ross Lagerwall in branch '3.2':
Issue #11818: Fix tempfile examples for Python 3.
http://hg.python.org/cpython/rev/87d89f767b23

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

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

From report at bugs.python.org  Sun Apr 10 09:43:38 2011
From: report at bugs.python.org (Ross Lagerwall)
Date: Sun, 10 Apr 2011 07:43:38 +0000
Subject: [docs] [issue11818] tempfile.TemporaryFile example in docs doesnt
	work
In-Reply-To: <1302419439.43.0.340740214318.issue11818@psf.upfronthosting.co.za>
Message-ID: <1302421418.0.0.418277783509.issue11818@psf.upfronthosting.co.za>


Ross Lagerwall <rosslagerwall at gmail.com> added the comment:

Fixed the examples for Python 3.

It writes and reads bytes now. Also fixed the old Python 2 print statement.

----------
assignee: docs at python -> rosslagerwall
nosy: +rosslagerwall
resolution:  -> fixed
status: open -> closed
versions: +Python 3.3

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

From report at bugs.python.org  Sun Apr 10 18:19:52 2011
From: report at bugs.python.org (=?utf-8?q?Filip_Gruszczy=C5=84ski?=)
Date: Sun, 10 Apr 2011 16:19:52 +0000
Subject: [docs] [issue11807] Documentation of add_subparsers lacks
	information about	parametres
In-Reply-To: <1302340872.99.0.0231583237732.issue11807@psf.upfronthosting.co.za>
Message-ID: <1302452392.57.0.0471306451998.issue11807@psf.upfronthosting.co.za>


Filip Gruszczy?ski <gruszczy at gmail.com> added the comment:

Here is a patch for this. I am not much of technical writer, so please be patient with me. I tried to provide all the information about parameters, that can be inferred from the code and experimenting. I have left out one parameter - action - because I don't see any use of it for a potential user and potential description seemed very complicated. I'll be happy to work further on the patch, if someone is willing to tutor me a little.

----------
keywords: +patch
Added file: http://bugs.python.org/file21604/11807.patch

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

From report at bugs.python.org  Mon Apr 11 10:38:17 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Mon, 11 Apr 2011 08:38:17 +0000
Subject: [docs] [issue11827] mention of list2cmdline() in docs of
	subprocess.Popen
In-Reply-To: <1302511097.53.0.993242324349.issue11827@psf.upfronthosting.co.za>
Message-ID: <1302511097.53.0.993242324349.issue11827@psf.upfronthosting.co.za>


New submission from Eli Bendersky <eliben at gmail.com>:

The documentation of subprocess.Popen mentions a function named list2cmdline():

----
  On Windows: the Popen class uses CreateProcess() to execute the child program, which operates on strings. If args is a sequence, it will be converted to a string using the list2cmdline() method. Please note that not all MS Windows applications interpret the command line the same way: list2cmdline() is designed for applications using the same rules as the MS C runtime.
----

I find this rather opaque and useless. list2cmdline() in subprocess is publicly accessible (doesn't begin with underscores) but it isn't documented.

The solution can be one of the following:

1. Document list2cmdline in the docs of subprocess, making the reference to is useful
2. Don't mention list2cmdline and instead mention what it does with the command-line list

----------
assignee: docs at python
components: Documentation
messages: 133507
nosy: docs at python, eli.bendersky
priority: normal
severity: normal
stage: needs patch
status: open
title: mention of list2cmdline() in docs of subprocess.Popen
type: behavior
versions: Python 3.2

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

From cocoatomo77 at gmail.com  Sun Apr  3 17:49:24 2011
From: cocoatomo77 at gmail.com (tomo cocoa)
Date: Mon, 4 Apr 2011 00:49:24 +0900
Subject: [docs] 2.6.6 documentation bug in Python/C API Reference
Message-ID: <AANLkTinAPchcNR__3WRNYBeMLDrxGH9Ksm9YmVXFvwBo@mail.gmail.com>

Hello

I am a Japanese Pythonista and also a member of the python-doc-ja project.

I found a trivial bug in "Unicode Objects and Codecs".

http://docs.python.org/release/2.6.6/c-api/unicode.html#utf-7-codecs

In a section "UTF-7 Codecs", we should do
s/PyUnicode_DecodeUTF8Stateful/PyUnicode_DecodeUTF7Stateful/.

Regards.

-- 
class Cocoatomo:
? ? name = 'cocoatomo'
? ? email_address = 'cocoatomo77 at gmail.com'
? ? twitter_id = '@cocoatomo'

From by.marcis at gmail.com  Tue Apr  5 19:05:03 2011
From: by.marcis at gmail.com (MR)
Date: Tue, 05 Apr 2011 20:05:03 +0300
Subject: [docs] 'General Python FAQ Python v2.7.1 documentation' translation
Message-ID: <4D9B4BBF.1080102@gmail.com>

Hi!

I'm willing to translate publication located at 
http://docs.python.org/faq/general.html to the Belorussian language (my 
mother tongue). What I'm asking for is your written permission, so you 
don't mind after I'll post the translation to my blog 'Libs' 
(http://webhostingrating.com/libs/). The translation is intended only 
for web, no print copies planned.
Visitors of your website, who come from Minsk (Belorussia) will be the 
ones, who will read this blogpost, that's the only way to spread them, 
no additional instruments we can use. Every translation we ever do does 
not costs a penny for the webpage, which is translated. All we ask is to 
link back in whatever way you feel confident about it.

Thank you for the article.
You can leave a voice message and I will call you back, if you prefer a 
call instead of emails.

Sincerely,
Bohdan Zograf
+(360) 488-0303

From cocoatomo77 at gmail.com  Thu Apr  7 18:53:34 2011
From: cocoatomo77 at gmail.com (tomo cocoa)
Date: Fri, 8 Apr 2011 01:53:34 +0900
Subject: [docs] documentation bug in "C/API Unicode Objects and Codecs"
Message-ID: <BANLkTine7Gc9q9iLCw7ZAi1T6k355A87Pg@mail.gmail.com>

Hello

I am a Japanese Pythonista and a Python documentation translator.

I found a bug in the documentation of UTF-16 Codecs.
http://docs.python.org/c-api/unicode.html#utf-16-codecs

The passages about the function PyUnicode_DecodeUTF16 starts with
"Decode length bytes from".
But I think s/length/size/, because there is no formal parameter named
"length" but "size".

Regards


-- 
class Cocoatomo:
? ? name = 'cocoatomo'
? ? email_address = 'cocoatomo77 at gmail.com'
? ? twitter_id = '@cocoatomo'

From martinf at underhill.ca  Fri Apr  8 00:08:14 2011
From: martinf at underhill.ca (Martin Feuchtwanger)
Date: Thu, 07 Apr 2011 15:08:14 -0700
Subject: [docs] "knights of Ni" bug
Message-ID: <4D9E35CE.3060100@underhill.ca>

Hello,

I'm very new to Python -- going through theTutorial  <http://docs.python.org/tutorial/index.html>
athttp://docs.python.org/tutorial/inputoutput.html
-- using 2.6.4 (r264:75708, Oct 26 2009, 08:23:19)
[MSC v.1500 32 bit (Intel)]

I think the following is wrong:

	>>>  print  'We are the {} who say "{}!"'.format('knights',  'Ni')
	We are the knights who say "Ni!"

and should be:

	>>>  print  'We are the {0} who say "{1}!"'.format('knights',  'Ni')
	We are the knights who say "Ni!"

or am i missing something?
You may be hearing a lot more from me.
Cheers,

-- 
Martin Feuchtwanger, PhD   martinf at underhill.ca   604-732-3384 x 206
Underhill Geomatics Ltd.   www.underhill.ca
210A, 3430 Brighton Ave.   Burnaby, BC            V5A 3H4

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

From martinf at underhill.ca  Fri Apr  8 00:15:34 2011
From: martinf at underhill.ca (Martin Feuchtwanger)
Date: Thu, 07 Apr 2011 15:15:34 -0700
Subject: [docs] knights of Pi
Message-ID: <4D9E3786.9030001@underhill.ca>

Similarly,

	print  'The value of PI is approximately {}.'.format(math.pi)

should be

	print  'The value of PI is approximately {0}.'.format(math.pi)

-- 
Martin Feuchtwanger, PhD   martinf at underhill.ca   604-732-3384 x 206
Underhill Geomatics Ltd.   www.underhill.ca
210A, 3430 Brighton Ave.   Burnaby, BC            V5A 3H4


From amirouche.boubekki at gmail.com  Sat Apr  9 16:09:32 2011
From: amirouche.boubekki at gmail.com (Amirouche Boubekki)
Date: Sat, 9 Apr 2011 16:09:32 +0200
Subject: [docs] Translation
Message-ID: <BANLkTikNZ=7W46veVLCmLxD4aiRJkVh4uw@mail.gmail.com>

H?llo,

I would like to participate to the french tranlation. I already have an
account on pootle is there anything else I should before starting ?

regards,

abki
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20110409/878f27d6/attachment.html>

From laughingman182 at gmail.com  Sun Apr 10 15:36:26 2011
From: laughingman182 at gmail.com (Lee Savide)
Date: Sun, 10 Apr 2011 08:36:26 -0500
Subject: [docs] Python Documentation Ebook
Message-ID: <-4381924641158269320@unknownmsgid>

Hi. I sent an email before about the issues concerning that the epub
file wasn't loading properly into my ereader. I think I can tell what
the problems are, and I think these suggestions would be a better
option for otherereader devices, too, not just my own device:
1. Remove the search page. Most epubs can be searched natively by the
device viewing them.
2. Remove all the Javascript, both inline & external scripts. Not all
ereaders are capable of Javascript, and even the ones that are might
also screw it up.
3. Don't limit the documentation to one epub file. Epubs are the XML/
XHTML equivalent to PDF files. Looking at it that way, each file in
the PDF version of the Python documentation should be the same name
and purpose as each epub file.
4. Include the means to let devices scale content appropriately.
What's the use if people have to squint to read it?
5. Remove the "_sources" folder, and links to the documents in
"_sources". Why do ereaders need the reStructured Text sources if
ereaders?

I hope this helps, and if not, then at least I tried to help. :) Thanks!
- Lee Savide

From report at bugs.python.org  Mon Apr 11 12:31:13 2011
From: report at bugs.python.org (R. David Murray)
Date: Mon, 11 Apr 2011 10:31:13 +0000
Subject: [docs] [issue11827] mention of list2cmdline() in docs of
	subprocess.Popen
In-Reply-To: <1302511097.53.0.993242324349.issue11827@psf.upfronthosting.co.za>
Message-ID: <1302517872.99.0.319677950301.issue11827@psf.upfronthosting.co.za>


R. David Murray <rdmurray at bitdance.com> added the comment:

I vote for (2) (I presume 'it' in that sentence is 'subprocess').  list2cmdline shouldn't be a "real" public method, at least not without the issues surrounding being given careful design attention.

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

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

From report at bugs.python.org  Mon Apr 11 12:37:51 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Mon, 11 Apr 2011 10:37:51 +0000
Subject: [docs] [issue11827] mention of list2cmdline() in docs of
	subprocess.Popen
In-Reply-To: <1302511097.53.0.993242324349.issue11827@psf.upfronthosting.co.za>
Message-ID: <1302518271.81.0.112447241164.issue11827@psf.upfronthosting.co.za>


Eli Bendersky <eliben at gmail.com> added the comment:

I also prefer (2) since I see no reason for the user to use list2cmdline() directly, let alone from subprocess (had there been rationale for such a public function it should probably be in another module).

As for 'it', I guess you can say it means 'subprocess' or 'list2cmdline', doesn't matter which.

----------

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

From report at bugs.python.org  Mon Apr 11 14:21:01 2011
From: report at bugs.python.org (R. David Murray)
Date: Mon, 11 Apr 2011 12:21:01 +0000
Subject: [docs] [issue11827] mention of list2cmdline() in docs of
	subprocess.Popen
In-Reply-To: <1302511097.53.0.993242324349.issue11827@psf.upfronthosting.co.za>
Message-ID: <1302524461.86.0.935093604946.issue11827@psf.upfronthosting.co.za>


R. David Murray <rdmurray at bitdance.com> added the comment:

Ah, right.  I guess I was advocating that the docs be written from the perspective that list2cmdline doesn't exist as an identifiable entity.  From the POV of the updated docs, it is just subprocess's behavior, and list2cmdline is an implementation detail.  Which is what you were saying.

----------

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

From benjamin at python.org  Mon Apr 11 15:33:39 2011
From: benjamin at python.org (Benjamin Peterson)
Date: Mon, 11 Apr 2011 08:33:39 -0500
Subject: [docs] knights of Pi
In-Reply-To: <4D9E3786.9030001@underhill.ca>
References: <4D9E3786.9030001@underhill.ca>
Message-ID: <BANLkTi=BjqAbQLmApO9YMPtigyqCJzqfNQ@mail.gmail.com>

Not in 2.7 and 3.1+

2011/4/7 Martin Feuchtwanger <martinf at underhill.ca>:
> Similarly,
>
> ? ? ? ?print ?'The value of PI is approximately {}.'.format(math.pi)
>
> should be
>
> ? ? ? ?print ?'The value of PI is approximately {0}.'.format(math.pi)
>
> --
> Martin Feuchtwanger, PhD ? martinf at underhill.ca ? 604-732-3384 x 206
> Underhill Geomatics Ltd. ? www.underhill.ca
> 210A, 3430 Brighton Ave. ? Burnaby, BC ? ? ? ? ? ?V5A 3H4
>
> _______________________________________________
> docs mailing list
> docs at python.org
> http://mail.python.org/mailman/listinfo/docs
>



-- 
Regards,
Benjamin

From report at bugs.python.org  Mon Apr 11 17:06:06 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 11 Apr 2011 15:06:06 +0000
Subject: [docs] [issue11818] tempfile.TemporaryFile example in docs doesnt
	work
In-Reply-To: <1302419439.43.0.340740214318.issue11818@psf.upfronthosting.co.za>
Message-ID: <1302534366.58.0.0644265144121.issue11818@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

May I ask why 3.1 was not fixed too?

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

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

From sandro.tosi at gmail.com  Mon Apr 11 20:24:50 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Mon, 11 Apr 2011 20:24:50 +0200
Subject: [docs] Translation
In-Reply-To: <BANLkTikNZ=7W46veVLCmLxD4aiRJkVh4uw@mail.gmail.com>
References: <BANLkTikNZ=7W46veVLCmLxD4aiRJkVh4uw@mail.gmail.com>
Message-ID: <BANLkTimpQi8Q6Fg2eAc4_67c6Nugfn-UXQ@mail.gmail.com>

Hi Amirouche,

On Sat, Apr 9, 2011 at 16:09, Amirouche Boubekki
<amirouche.boubekki at gmail.com> wrote:
> H?llo,
> I would like to participate to the french tranlation. I already have an
> account on pootle is there anything else I should before starting ?

Thanks for your offer! can you detail a bit more what you'd like to translate?

Regards,
-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

From sandro.tosi at gmail.com  Mon Apr 11 20:34:25 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Mon, 11 Apr 2011 20:34:25 +0200
Subject: [docs] "knights of Ni" bug
In-Reply-To: <4D9E35CE.3060100@underhill.ca>
References: <4D9E35CE.3060100@underhill.ca>
Message-ID: <BANLkTinWfXO7c2Gvu=Lx1t13jtX9umtkjg@mail.gmail.com>

Hi Martin,

On Fri, Apr 8, 2011 at 00:08, Martin Feuchtwanger <martinf at underhill.ca> wrote:
> Hello,
>
> I'm very new to Python -- going through the Tutorial
> at http://docs.python.org/tutorial/inputoutput.html
> -- using 2.6.4 (r264:75708, Oct 26 2009, 08:23:19)
> [MSC v.1500 32 bit (Intel)]
>
> I think the following is wrong:
>
> 	>>> print 'We are the {} who say "{}!"'.format('knights', 'Ni')
> 	We are the knights who say "Ni!"
>
> and should be:
>
> 	>>> print 'We are the {0} who say "{1}!"'.format('knights', 'Ni')
> 	We are the knights who say "Ni!"
>
> or am i missing something?

Benjamin already replied to the other email, and I'm here just to
reply also to this email.

Why do you think you have to explicitly state the position of the
objects in the {} format? the numbers can be use to specify a position
of the objects passed to the string, but if you want to print them as
they are passed, there's no need to enumerate them.

Regards,
-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

From amirouche.boubekki at gmail.com  Mon Apr 11 20:44:41 2011
From: amirouche.boubekki at gmail.com (Amirouche Boubekki)
Date: Mon, 11 Apr 2011 20:44:41 +0200
Subject: [docs] Translation
In-Reply-To: <BANLkTimpQi8Q6Fg2eAc4_67c6Nugfn-UXQ@mail.gmail.com>
References: <BANLkTikNZ=7W46veVLCmLxD4aiRJkVh4uw@mail.gmail.com>
	<BANLkTimpQi8Q6Fg2eAc4_67c6Nugfn-UXQ@mail.gmail.com>
Message-ID: <BANLkTi=ZoB0r-sudBVH7VDZYTuy7DDj0qQ@mail.gmail.com>

2011/4/11 Sandro Tosi <sandro.tosi at gmail.com>

> Hi Amirouche,
>
> On Sat, Apr 9, 2011 at 16:09, Amirouche Boubekki
> <amirouche.boubekki at gmail.com> wrote:
> > H?llo,
> > I would like to participate to the french tranlation. I already have an
> > account on pootle is there anything else I should before starting ?
>
> Thanks for your offer! can you detail a bit more what you'd like to
> translate?
>

I would like to work on the tutorial, but if you know a better choice, tell
me.



> Regards,
> --
> Sandro Tosi (aka morph, morpheus, matrixhasu)
> My website: http://matrixhasu.altervista.org/
> Me at Debian: http://wiki.debian.org/SandroTosi
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20110411/06e6a668/attachment-0001.html>

From sandro.tosi at gmail.com  Mon Apr 11 21:14:10 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Mon, 11 Apr 2011 21:14:10 +0200
Subject: [docs] Translation
In-Reply-To: <BANLkTi=ZoB0r-sudBVH7VDZYTuy7DDj0qQ@mail.gmail.com>
References: <BANLkTikNZ=7W46veVLCmLxD4aiRJkVh4uw@mail.gmail.com>
	<BANLkTimpQi8Q6Fg2eAc4_67c6Nugfn-UXQ@mail.gmail.com>
	<BANLkTi=ZoB0r-sudBVH7VDZYTuy7DDj0qQ@mail.gmail.com>
Message-ID: <BANLkTi=8mtcBVY2e1yN_oGSY197-FiT1gg@mail.gmail.com>

On Mon, Apr 11, 2011 at 20:44, Amirouche Boubekki
<amirouche.boubekki at gmail.com> wrote:
> I would like to work on the tutorial, but if you know a better choice, tell
> me.

Oh that's perfectly fine. The only thing I'm not sure is how
Python.org supports doc translations: I tried to google a bit but I
found only the wiki localized pages.

I think docs translations are maintained outside python.org, but I'd
like some more experience developer to comment on this.

Cheers,
-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

From sandro.tosi at gmail.com  Mon Apr 11 21:18:47 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Mon, 11 Apr 2011 21:18:47 +0200
Subject: [docs] 2.6.6 documentation bug in Python/C API Reference
In-Reply-To: <AANLkTinAPchcNR__3WRNYBeMLDrxGH9Ksm9YmVXFvwBo@mail.gmail.com>
References: <AANLkTinAPchcNR__3WRNYBeMLDrxGH9Ksm9YmVXFvwBo@mail.gmail.com>
Message-ID: <BANLkTinn-uPYqPwpwTns1jfoFR9GGPi9tA@mail.gmail.com>

Hi Tomo,
thanks for your email.

On Sun, Apr 3, 2011 at 17:49, tomo cocoa <cocoatomo77 at gmail.com> wrote:
> I found a trivial bug in "Unicode Objects and Codecs".
>
> http://docs.python.org/release/2.6.6/c-api/unicode.html#utf-7-codecs
>
> In a section "UTF-7 Codecs", we should do
> s/PyUnicode_DecodeUTF8Stateful/PyUnicode_DecodeUTF7Stateful/.

2.6 is currently in security fix only, so usually doc is no more
updated. In any case, I'm adding Barry (2.6 release manager) in the
loop, so he can decide if it's worth be fixed in 2.6 or not (all other
more recent branches are fine).

Cheers,
-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

From martinf at underhill.ca  Mon Apr 11 22:03:41 2011
From: martinf at underhill.ca (Martin Feuchtwanger)
Date: Mon, 11 Apr 2011 13:03:41 -0700
Subject: [docs] "knights of Ni" bug
In-Reply-To: <BANLkTinWfXO7c2Gvu=Lx1t13jtX9umtkjg@mail.gmail.com>
References: <4D9E35CE.3060100@underhill.ca>
	<BANLkTinWfXO7c2Gvu=Lx1t13jtX9umtkjg@mail.gmail.com>
Message-ID: <4DA35E9D.8030709@underhill.ca>

Hi Sandro, Benjamin, et al.,

Maybe you didn't notice -- i was using 2.6.4

IDLE 2.6.4
 >>> print 'We are the {} who say "{}!"'.format('knights', 'Ni')

Traceback (most recent call last):
   File "<pyshell#0>", line 1, in <module>
     print 'We are the {} who say "{}!"'.format('knights', 'Ni')
ValueError: zero length field name in format

If you're wondering why i'm using 2.6...
I was following the advice on http://wiki.python.org/moin/BeginnersGuide/Download so i downloaded 
and installed 2.6.4 on my windows work computer. I worked thru the web-based tutorial 
http://docs.python.org/tutorial/ and all was well until i got to the "knights of ni" example, hence 
my first email query.

Interestingly, on the weekend, when i decided to install python on my home computer, i never saw 
any advice re stability on windows {i now realize it is because, silly me, i was getting advice on 
two different python.org web sites}, so i downloaded and installed 3.2 on it. Unfortunately, none 
of the print examples in the web-based tutorial http://docs.python.org/tutorial/ work on 3.2

Python 3.2 (r32:88445, Feb 20 2011, 21:29:02) [MSC v.1500 32 bit (Intel)] on win32
 >>> print 'We are the {} who say "{}!"'.format('knights', 'Ni')
SyntaxError: invalid syntax

Now, i notice that the web tutorial is for python 2.7, and i'm well aware, from other parts of the 
web site, that there are significant changes from python 2 to python 3, and, yes, i know that in 
python 3 print follows strict function syntax, but may i suggest to you, and maybe to the entire 
docs/wiki team,

    * That each tutorial have this added at the beginning:  "Note that this tutorial is version N
      and many of the examples will not work with version N-1 or version N+1 because the silly
      bunts at python.org like to invent a new kind of python with each release".
    * That you explain on both wiki.python.org and docs.python.org that, although they (docs and
      wiki) look the same they are different web sites and contain conflicting information.


Thank you,

one confused cat,

Martin Feuchtwanger, PhD   martinf at underhill.ca   604-732-3384 x 206
Underhill Geomatics Ltd.   www.underhill.ca
210A, 3430 Brighton Ave.   Burnaby, BC            V5A 3H4


On 11/04/2011 11:34 AM, Sandro Tosi wrote:
> Hi Martin,
>
> On Fri, Apr 8, 2011 at 00:08, Martin Feuchtwanger<martinf at underhill.ca>  wrote:
>> Hello,
>>
>> I'm very new to Python -- going through the Tutorial
>> at http://docs.python.org/tutorial/inputoutput.html
>> -- using 2.6.4 (r264:75708, Oct 26 2009, 08:23:19)
>> [MSC v.1500 32 bit (Intel)]
>>
>> I think the following is wrong:
>>
>> 	>>>  print 'We are the {} who say "{}!"'.format('knights', 'Ni')
>> 	We are the knights who say "Ni!"
>>
>> and should be:
>>
>> 	>>>  print 'We are the {0} who say "{1}!"'.format('knights', 'Ni')
>> 	We are the knights who say "Ni!"
>>
>> or am i missing something?
> Benjamin already replied to the other email, and I'm here just to
> reply also to this email.
>
> Why do you think you have to explicitly state the position of the
> objects in the {} format? the numbers can be use to specify a position
> of the objects passed to the string, but if you want to print them as
> they are passed, there's no need to enumerate them.
>
> Regards,
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20110411/33dfe9aa/attachment.html>

From report at bugs.python.org  Tue Apr 12 06:21:52 2011
From: report at bugs.python.org (Ross Lagerwall)
Date: Tue, 12 Apr 2011 04:21:52 +0000
Subject: [docs] [issue11818] tempfile.TemporaryFile example in docs doesnt
	work
In-Reply-To: <1302419439.43.0.340740214318.issue11818@psf.upfronthosting.co.za>
Message-ID: <1302582112.18.0.30224418086.issue11818@psf.upfronthosting.co.za>


Ross Lagerwall <rosslagerwall at gmail.com> added the comment:

http://docs.python.org/release/3.1.3/library/tempfile.html doesn't to have an "Examples" section like 3.2 and 3.3.

It appears to have been introduced in b172d7537b99 with #5178.

----------

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

From report at bugs.python.org  Tue Apr 12 06:27:58 2011
From: report at bugs.python.org (Ross Lagerwall)
Date: Tue, 12 Apr 2011 04:27:58 +0000
Subject: [docs] [issue11827] mention of list2cmdline() in docs of
	subprocess.Popen
In-Reply-To: <1302511097.53.0.993242324349.issue11827@psf.upfronthosting.co.za>
Message-ID: <1302582478.84.0.555004563406.issue11827@psf.upfronthosting.co.za>


Ross Lagerwall <rosslagerwall at gmail.com> added the comment:

#10838 has a bit of discussion about list2cmdline and being part of the public api (generally agreeing that it should be made private, I think).

----------
nosy: +rosslagerwall

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

From barry at python.org  Tue Apr 12 00:39:05 2011
From: barry at python.org (Barry Warsaw)
Date: Mon, 11 Apr 2011 18:39:05 -0400
Subject: [docs] 2.6.6 documentation bug in Python/C API Reference
In-Reply-To: <BANLkTinn-uPYqPwpwTns1jfoFR9GGPi9tA@mail.gmail.com>
References: <AANLkTinAPchcNR__3WRNYBeMLDrxGH9Ksm9YmVXFvwBo@mail.gmail.com>
	<BANLkTinn-uPYqPwpwTns1jfoFR9GGPi9tA@mail.gmail.com>
Message-ID: <20110411183905.5c1a056c@neurotica.wooz.org>

Hi Sandro, Tomo.

On Apr 11, 2011, at 09:18 PM, Sandro Tosi wrote:

>Hi Tomo,
>thanks for your email.
>
>On Sun, Apr 3, 2011 at 17:49, tomo cocoa <cocoatomo77 at gmail.com> wrote:
>> I found a trivial bug in "Unicode Objects and Codecs".
>>
>> http://docs.python.org/release/2.6.6/c-api/unicode.html#utf-7-codecs
>>
>> In a section "UTF-7 Codecs", we should do
>> s/PyUnicode_DecodeUTF8Stateful/PyUnicode_DecodeUTF7Stateful/.
>
>2.6 is currently in security fix only, so usually doc is no more
>updated. In any case, I'm adding Barry (2.6 release manager) in the
>loop, so he can decide if it's worth be fixed in 2.6 or not (all other
>more recent branches are fine).

General consensus is to not fix documentation in security-only releases, so I
think we should not fix this in 2.6.

Cheers,
-Barry
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 836 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20110411/fd0b8eeb/attachment-0001.pgp>

From todddeluca at gmail.com  Tue Apr 12 04:29:25 2011
From: todddeluca at gmail.com (Todd DeLuca)
Date: Mon, 11 Apr 2011 22:29:25 -0400
Subject: [docs] json module documentation error
Message-ID: <BANLkTimtY8HvficNamDuM60V7j5cJLK32Q@mail.gmail.com>

Hi,

The 2.7 docs for the json module online (
http://docs.python.org/library/json.html) say:

If *indent* is a non-negative integer, then JSON array elements and object
members will be pretty-printed with that indent level. An indent level of 0
will only insert newlines. None (the default) selects the most compact
representation.
I believe it should read, "An indent level of less than zero will only
insert newlines."  Some example output follows:

>>> sys.version_info
sys.version_info(major=2, minor=7, micro=0, releaselevel='final', serial=0)
>>> print json.dumps((1,(2,3)), indent=0)
[1, [2, 3]]
>>> print json.dumps((1,(2,3)), indent=1)
[
 1,
 [
  2,
  3
 ]
]
>>> print json.dumps((1,(2,3)), indent=-2)
[
1,
[
2,
3
]
]

Have a great day and thanks for all your hard work and for the best
programming language docs on the internet!

-- 
Todd DeLuca
http://todddeluca.com
27 Clinton St #2
Cambridge MA 02139

Scientific Programmer
Wall Laboratory for Translational Bioinformatics
Center For Biomedical Informatics at Harvard Medical School
http://wall.hms.harvard.edu/
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20110411/e5c2ed24/attachment.html>

From report at bugs.python.org  Tue Apr 12 07:50:30 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Tue, 12 Apr 2011 05:50:30 +0000
Subject: [docs] [issue11827] mention of list2cmdline() in docs of
	subprocess.Popen
In-Reply-To: <1302511097.53.0.993242324349.issue11827@psf.upfronthosting.co.za>
Message-ID: <1302587430.75.0.239915440818.issue11827@psf.upfronthosting.co.za>


Eli Bendersky <eliben at gmail.com> added the comment:

Thanks for the pointer, Ross. 

So I propose to remove the mention of list2cmdline from the documentation of subprocess, explaining instead what it does to the path (since I think this should be publicly known, otherwise it's just black magic). 

I will prepare a patch for this and post it for review here before committing.

Do you folks think we should also prepend an underscore to list2cmdline, thus settling the doubt about its "public-ness" once and for all? Other private functions in subprocess do have underscores prepended.

----------

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

From report at bugs.python.org  Tue Apr 12 08:26:55 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Tue, 12 Apr 2011 06:26:55 +0000
Subject: [docs] [issue11827] mention of list2cmdline() in docs of
	subprocess.Popen
In-Reply-To: <1302511097.53.0.993242324349.issue11827@psf.upfronthosting.co.za>
Message-ID: <1302589615.07.0.276959700442.issue11827@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

If a _ is added to list2cmdline the old name should be kept and deprecated.
The function is also on 2.x and it's not deprecated there (and it's probably too late to deprecate it now), so we might have to wait a few versions before it will be possible to remove list2cmdline from 3.x.

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

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

From report at bugs.python.org  Tue Apr 12 12:47:36 2011
From: report at bugs.python.org (anatoly techtonik)
Date: Tue, 12 Apr 2011 10:47:36 +0000
Subject: [docs] [issue11834] wrong module installation dir on Windows
In-Reply-To: <1302605256.31.0.234550103785.issue11834@psf.upfronthosting.co.za>
Message-ID: <1302605256.31.0.234550103785.issue11834@psf.upfronthosting.co.za>


New submission from anatoly techtonik <techtonik at gmail.com>:

http://docs.python.org/install/index.html#how-installation-works

Correct standard installation location for third-party modules on Windows for Python 2.x is
    prefix/Lib/site-packages

----------
assignee: docs at python
components: Documentation
messages: 133571
nosy: docs at python, techtonik
priority: normal
severity: normal
status: open
title: wrong module installation dir on Windows
versions: Python 2.7

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

From report at bugs.python.org  Tue Apr 12 12:48:27 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Tue, 12 Apr 2011 10:48:27 +0000
Subject: [docs] [issue11834] wrong module installation dir on Windows
In-Reply-To: <1302605256.31.0.234550103785.issue11834@psf.upfronthosting.co.za>
Message-ID: <1302605307.24.0.187858991009.issue11834@psf.upfronthosting.co.za>


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


----------
nosy: +brian.curtin

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

From report at bugs.python.org  Tue Apr 12 13:12:05 2011
From: report at bugs.python.org (anatoly techtonik)
Date: Tue, 12 Apr 2011 11:12:05 +0000
Subject: [docs] [issue11834] wrong module installation dir on Windows
In-Reply-To: <1302605256.31.0.234550103785.issue11834@psf.upfronthosting.co.za>
Message-ID: <1302606725.35.0.913061702265.issue11834@psf.upfronthosting.co.za>


anatoly techtonik <techtonik at gmail.com> added the comment:

Other Windows prefixes are probably wrong too.

----------

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

From amirouche.boubekki at gmail.com  Tue Apr 12 13:55:41 2011
From: amirouche.boubekki at gmail.com (Amirouche Boubekki)
Date: Tue, 12 Apr 2011 13:55:41 +0200
Subject: [docs] Translation
In-Reply-To: <BANLkTi=8mtcBVY2e1yN_oGSY197-FiT1gg@mail.gmail.com>
References: <BANLkTikNZ=7W46veVLCmLxD4aiRJkVh4uw@mail.gmail.com>
	<BANLkTimpQi8Q6Fg2eAc4_67c6Nugfn-UXQ@mail.gmail.com>
	<BANLkTi=ZoB0r-sudBVH7VDZYTuy7DDj0qQ@mail.gmail.com>
	<BANLkTi=8mtcBVY2e1yN_oGSY197-FiT1gg@mail.gmail.com>
Message-ID: <BANLkTi=3ijuxvG-mM9e3xEePFtfN8-Vb2A@mail.gmail.com>

2011/4/11 Sandro Tosi <sandro.tosi at gmail.com>

> On Mon, Apr 11, 2011 at 20:44, Amirouche Boubekki
> <amirouche.boubekki at gmail.com> wrote:
> > I would like to work on the tutorial, but if you know a better choice,
> tell
> > me.
>
> Oh that's perfectly fine. The only thing I'm not sure is how
> Python.org supports doc translations: I tried to google a bit but I
> found only the wiki localized pages.
>
> I think docs translations are maintained outside python.org, but I'd
> like some more experience developer to comment on this.
>

I was directed to http://pootle.python.org/pootle on irc.


>
> Cheers,
> --
> Sandro Tosi (aka morph, morpheus, matrixhasu)
> My website: http://matrixhasu.altervista.org/
> Me at Debian: http://wiki.debian.org/SandroTosi
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20110412/bddcd943/attachment.html>

From report at bugs.python.org  Tue Apr 12 14:32:04 2011
From: report at bugs.python.org (Brian Curtin)
Date: Tue, 12 Apr 2011 12:32:04 +0000
Subject: [docs] [issue11834] wrong module installation dir on Windows
In-Reply-To: <1302605256.31.0.234550103785.issue11834@psf.upfronthosting.co.za>
Message-ID: <1302611524.52.0.912924252193.issue11834@psf.upfronthosting.co.za>


Changes by Brian Curtin <brian at python.org>:


----------
stage:  -> needs patch

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

From report at bugs.python.org  Tue Apr 12 14:50:52 2011
From: report at bugs.python.org (anatoly techtonik)
Date: Tue, 12 Apr 2011 12:50:52 +0000
Subject: [docs] [issue11834] wrong module installation dir on Windows
In-Reply-To: <1302605256.31.0.234550103785.issue11834@psf.upfronthosting.co.za>
Message-ID: <1302612652.39.0.431836705595.issue11834@psf.upfronthosting.co.za>


anatoly techtonik <techtonik at gmail.com> added the comment:

How about 'easy' keyword?

----------

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

From report at bugs.python.org  Tue Apr 12 14:51:20 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Tue, 12 Apr 2011 12:51:20 +0000
Subject: [docs] [issue11834] wrong module installation dir on Windows
In-Reply-To: <1302605256.31.0.234550103785.issue11834@psf.upfronthosting.co.za>
Message-ID: <1302612680.83.0.871183327284.issue11834@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Tue Apr 12 14:52:48 2011
From: report at bugs.python.org (R. David Murray)
Date: Tue, 12 Apr 2011 12:52:48 +0000
Subject: [docs] [issue11834] wrong module installation dir on Windows
In-Reply-To: <1302605256.31.0.234550103785.issue11834@psf.upfronthosting.co.za>
Message-ID: <1302612768.05.0.636965395892.issue11834@psf.upfronthosting.co.za>


R. David Murray <rdmurray at bitdance.com> added the comment:

It's a doc issue.  Doc issues are pretty much by definition easy in the sense of the easy keyword (doable in a day) (unless they are controversial), so we don't bother to attach the easy keyword to them.

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

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

From report at bugs.python.org  Tue Apr 12 15:00:28 2011
From: report at bugs.python.org (anatoly techtonik)
Date: Tue, 12 Apr 2011 13:00:28 +0000
Subject: [docs] [issue11834] wrong module installation dir on Windows
In-Reply-To: <1302605256.31.0.234550103785.issue11834@psf.upfronthosting.co.za>
Message-ID: <1302613228.94.0.380134157704.issue11834@psf.upfronthosting.co.za>


anatoly techtonik <techtonik at gmail.com> added the comment:

Target auditory for the `easy` keyword are largely unaware of this fact. It also may keep people off if they run into uneasy doc problem.

----------

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

From report at bugs.python.org  Tue Apr 12 15:08:16 2011
From: report at bugs.python.org (Brian Curtin)
Date: Tue, 12 Apr 2011 13:08:16 +0000
Subject: [docs] [issue11834] wrong module installation dir on Windows
In-Reply-To: <1302605256.31.0.234550103785.issue11834@psf.upfronthosting.co.za>
Message-ID: <1302613696.92.0.674284722808.issue11834@psf.upfronthosting.co.za>


Changes by Brian Curtin <brian at python.org>:


----------
nosy:  -brian.curtin

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

From report at bugs.python.org  Tue Apr 12 17:54:15 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Tue, 12 Apr 2011 15:54:15 +0000
Subject: [docs] [issue11827] mention of list2cmdline() in docs of
	subprocess.Popen
In-Reply-To: <1302511097.53.0.993242324349.issue11827@psf.upfronthosting.co.za>
Message-ID: <1302623655.29.0.538251410576.issue11827@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Tue Apr 12 17:55:34 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Tue, 12 Apr 2011 15:55:34 +0000
Subject: [docs] [issue11818] tempfile.TemporaryFile example in docs doesnt
	work
In-Reply-To: <1302419439.43.0.340740214318.issue11818@psf.upfronthosting.co.za>
Message-ID: <1302623734.4.0.930514372315.issue11818@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

Alright, thanks for replying :)

----------

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

From report at bugs.python.org  Tue Apr 12 17:56:25 2011
From: report at bugs.python.org (Antoine Pitrou)
Date: Tue, 12 Apr 2011 15:56:25 +0000
Subject: [docs] [issue11836] multiprocessing.queues.SimpleQueue is
	undocumented
In-Reply-To: <1302623785.46.0.16009713021.issue11836@psf.upfronthosting.co.za>
Message-ID: <1302623785.46.0.16009713021.issue11836@psf.upfronthosting.co.za>


New submission from Antoine Pitrou <pitrou at free.fr>:

multiprocessing.queues.SimpleQueue is undocumented and doesn't appear in multiprocessing.__all__.

----------
assignee: docs at python
components: Documentation, Library (Lib)
keywords: easy
messages: 133586
nosy: docs at python, pitrou
priority: normal
severity: normal
stage: needs patch
status: open
title: multiprocessing.queues.SimpleQueue is undocumented
versions: Python 3.1, Python 3.2, Python 3.3

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

From sandro.tosi at gmail.com  Tue Apr 12 18:45:10 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Tue, 12 Apr 2011 18:45:10 +0200
Subject: [docs] Translation
In-Reply-To: <BANLkTi=3ijuxvG-mM9e3xEePFtfN8-Vb2A@mail.gmail.com>
References: <BANLkTikNZ=7W46veVLCmLxD4aiRJkVh4uw@mail.gmail.com>
	<BANLkTimpQi8Q6Fg2eAc4_67c6Nugfn-UXQ@mail.gmail.com>
	<BANLkTi=ZoB0r-sudBVH7VDZYTuy7DDj0qQ@mail.gmail.com>
	<BANLkTi=8mtcBVY2e1yN_oGSY197-FiT1gg@mail.gmail.com>
	<BANLkTi=3ijuxvG-mM9e3xEePFtfN8-Vb2A@mail.gmail.com>
Message-ID: <BANLkTikdtJNriPsAvax7=9wXMoMzzVD97g@mail.gmail.com>

On Tue, Apr 12, 2011 at 13:55, Amirouche Boubekki
<amirouche.boubekki at gmail.com> wrote:
> I was directed to http://pootle.python.org/pootle on irc.

Oh that's an interesting project, still at an embryonic stage: we'll
see if we can make it grow :)

Regards,
-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

From sandro.tosi at gmail.com  Tue Apr 12 19:42:56 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Tue, 12 Apr 2011 19:42:56 +0200
Subject: [docs] json module documentation error
In-Reply-To: <BANLkTimtY8HvficNamDuM60V7j5cJLK32Q@mail.gmail.com>
References: <BANLkTimtY8HvficNamDuM60V7j5cJLK32Q@mail.gmail.com>
Message-ID: <BANLkTin90TQgbGp4yQG7j_uCnMyqFKU24Q@mail.gmail.com>

Hi Todd,
thanks for your email.

On Tue, Apr 12, 2011 at 04:29, Todd DeLuca <todddeluca at gmail.com> wrote:
> Hi,
> The 2.7 docs for the json module online
> (http://docs.python.org/library/json.html) say:
>
> If?indent?is a non-negative integer, then JSON array elements and object
> members will be pretty-printed with that indent level. An indent level of 0
> will only insert newlines.?None?(the default) selects the most compact
> representation.
>
> I believe it should read, "An indent level of less than zero will only
> insert newlines." ?Some example output follows:

The problem is mainly http://bugs.python.org/issue10019 but I'll try
to improve the doc too. I'm preparing an updated patch as of now.

Regards,
-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

From report at bugs.python.org  Tue Apr 12 19:56:44 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Tue, 12 Apr 2011 17:56:44 +0000
Subject: [docs] [issue11836] multiprocessing.queues.SimpleQueue is
	undocumented
In-Reply-To: <1302623785.46.0.16009713021.issue11836@psf.upfronthosting.co.za>
Message-ID: <1302631004.33.0.0306489213909.issue11836@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/issue11836>
_______________________________________

From amirouche.boubekki at gmail.com  Tue Apr 12 20:35:33 2011
From: amirouche.boubekki at gmail.com (Amirouche Boubekki)
Date: Tue, 12 Apr 2011 20:35:33 +0200
Subject: [docs] Translation
In-Reply-To: <BANLkTikdtJNriPsAvax7=9wXMoMzzVD97g@mail.gmail.com>
References: <BANLkTikNZ=7W46veVLCmLxD4aiRJkVh4uw@mail.gmail.com>
	<BANLkTimpQi8Q6Fg2eAc4_67c6Nugfn-UXQ@mail.gmail.com>
	<BANLkTi=ZoB0r-sudBVH7VDZYTuy7DDj0qQ@mail.gmail.com>
	<BANLkTi=8mtcBVY2e1yN_oGSY197-FiT1gg@mail.gmail.com>
	<BANLkTi=3ijuxvG-mM9e3xEePFtfN8-Vb2A@mail.gmail.com>
	<BANLkTikdtJNriPsAvax7=9wXMoMzzVD97g@mail.gmail.com>
Message-ID: <BANLkTin2WSruDyoDgqup5khW-LpeftW4hQ@mail.gmail.com>

2011/4/12 Sandro Tosi <sandro.tosi at gmail.com>

> On Tue, Apr 12, 2011 at 13:55, Amirouche Boubekki
> <amirouche.boubekki at gmail.com> wrote:
> > I was directed to http://pootle.python.org/pootle on irc.
>
> Oh that's an interesting project, still at an embryonic stage: we'll
> see if we can make it grow :)
>

Ok, because I started translating some string there, I hope the work won't
be lost.

Is there anyway to get a pdf or something for complete editing/reading ?

Regards,

abki
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20110412/48687851/attachment.html>

From sandro.tosi at gmail.com  Tue Apr 12 21:55:48 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Tue, 12 Apr 2011 21:55:48 +0200
Subject: [docs] 'General Python FAQ Python v2.7.1 documentation'
	translation
In-Reply-To: <4D9B4BBF.1080102@gmail.com>
References: <4D9B4BBF.1080102@gmail.com>
Message-ID: <BANLkTin-mkp7B3X0g=XFFSYmZB=BuDG1JQ@mail.gmail.com>

Hello,


On Tue, Apr 5, 2011 at 19:05, MR <by.marcis at gmail.com> wrote:
> Hi!
>
> I'm willing to translate publication located at
> http://docs.python.org/faq/general.html to the Belorussian language (my
> mother tongue).

Thanks for your interest in translating (part of) the doc of python. I
cannot tell you more about your request, but I'd like to point you to
http://pootle.python.org/pootle : it's still experimental, but you
might want to contribute there (note: translations can now be lost),
when ready.

Regards,
-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

From report at bugs.python.org  Tue Apr 12 22:18:53 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Tue, 12 Apr 2011 20:18:53 +0000
Subject: [docs] [issue11827] mention of list2cmdline() in docs of
	subprocess.Popen
In-Reply-To: <1302511097.53.0.993242324349.issue11827@psf.upfronthosting.co.za>
Message-ID: <1302639533.22.0.535305187589.issue11827@psf.upfronthosting.co.za>


Eli Bendersky <eliben at gmail.com> added the comment:

Attaching a proposed patch for 3.2, focusing only on the documentation for the time being (I realize that deprecation is a loaded issue and should be probably handled in a centralized manner).

The patch removes mention of list2cmdline, instead explaining its intention (using the docstring of list2cmdline quite literally). I realize this isn't an ideal approach, but IMHO it's much better than what we have now. Suggestions are most welcome.

----------
keywords: +patch
Added file: http://bugs.python.org/file21634/issue11827.1.patch

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

From report at bugs.python.org  Tue Apr 12 22:26:12 2011
From: report at bugs.python.org (=?utf-8?q?Bo=C5=A1tjan_Mejak?=)
Date: Tue, 12 Apr 2011 20:26:12 +0000
Subject: [docs] [issue11806] Missing 2 hyphens in the docs
In-Reply-To: <1302338197.1.0.100311254016.issue11806@psf.upfronthosting.co.za>
Message-ID: <1302639972.49.0.67493489946.issue11806@psf.upfronthosting.co.za>


Changes by Bo?tjan Mejak <bostjan.mejak at gmail.com>:


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

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

From report at bugs.python.org  Tue Apr 12 23:19:32 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Tue, 12 Apr 2011 21:19:32 +0000
Subject: [docs] [issue11840] Improvements to c-api/unicode documentation
In-Reply-To: <1302643172.01.0.948666081662.issue11840@psf.upfronthosting.co.za>
Message-ID: <1302643172.01.0.948666081662.issue11840@psf.upfronthosting.co.za>


New submission from Sandro Tosi <sandro.tosi at gmail.com>:

Hi,
After reading tomo cocoa mail at docs@ I gave a look at c-api/unicode file and fixed some minor editing issues.

Regards,
Sandro

----------
assignee: docs at python
components: Documentation
files: unicode_doc-default.patch
keywords: patch
messages: 133600
nosy: docs at python, sandro.tosi
priority: normal
severity: normal
stage: patch review
status: open
title: Improvements to c-api/unicode documentation
versions: Python 3.3
Added file: http://bugs.python.org/file21635/unicode_doc-default.patch

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

From report at bugs.python.org  Tue Apr 12 23:21:27 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Tue, 12 Apr 2011 21:21:27 +0000
Subject: [docs] [issue11840] Improvements to c-api/unicode documentation
In-Reply-To: <1302643172.01.0.948666081662.issue11840@psf.upfronthosting.co.za>
Message-ID: <1302643287.14.0.889819232295.issue11840@psf.upfronthosting.co.za>


Sandro Tosi <sandro.tosi at gmail.com> added the comment:

In addition, is there a reason for the sorting of UTF-8 UTF-32 UTF-16 and UTF-7 sections? why not alphabetically?

Also, several parts of the doc would need paragraph re-indentation (not done in this patch due to clarity).

----------

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

From report at bugs.python.org  Tue Apr 12 23:22:36 2011
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 12 Apr 2011 21:22:36 +0000
Subject: [docs] [issue11840] Improvements to c-api/unicode documentation
In-Reply-To: <1302643172.01.0.948666081662.issue11840@psf.upfronthosting.co.za>
Message-ID: <1302643356.92.0.230544293607.issue11840@psf.upfronthosting.co.za>


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


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

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

From sandro.tosi at gmail.com  Tue Apr 12 23:33:47 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Tue, 12 Apr 2011 23:33:47 +0200
Subject: [docs] Translation
In-Reply-To: <BANLkTin2WSruDyoDgqup5khW-LpeftW4hQ@mail.gmail.com>
References: <BANLkTikNZ=7W46veVLCmLxD4aiRJkVh4uw@mail.gmail.com>
	<BANLkTimpQi8Q6Fg2eAc4_67c6Nugfn-UXQ@mail.gmail.com>
	<BANLkTi=ZoB0r-sudBVH7VDZYTuy7DDj0qQ@mail.gmail.com>
	<BANLkTi=8mtcBVY2e1yN_oGSY197-FiT1gg@mail.gmail.com>
	<BANLkTi=3ijuxvG-mM9e3xEePFtfN8-Vb2A@mail.gmail.com>
	<BANLkTikdtJNriPsAvax7=9wXMoMzzVD97g@mail.gmail.com>
	<BANLkTin2WSruDyoDgqup5khW-LpeftW4hQ@mail.gmail.com>
Message-ID: <BANLkTimNCoWeVS=Rf4GOFiX699K=C-JQUQ@mail.gmail.com>

On Tue, Apr 12, 2011 at 20:35, Amirouche Boubekki
<amirouche.boubekki at gmail.com> wrote:
> Ok, because I started translating some string there, I hope the work won't
> be lost.

They say there's a chance your editing will be lost, I'm sorry I can't
say more (since I don't know :)

> Is there anyway to get a pdf or something for complete editing/reading ?

For reading sure, you can download PDFs (and other formats) from
http://docs.python.org/download.html (for 2.7, for 3.2 is at
http://docs.python.org/py3k/download.html , but for editing what
exactly do you mean, translation-made-easier? I don't think anything
like that exists.

Regards,
-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

From report at bugs.python.org  Tue Apr 12 23:34:24 2011
From: report at bugs.python.org (Marc-Andre Lemburg)
Date: Tue, 12 Apr 2011 21:34:24 +0000
Subject: [docs] [issue11840] Improvements to c-api/unicode documentation
In-Reply-To: <1302643287.14.0.889819232295.issue11840@psf.upfronthosting.co.za>
Message-ID: <4DA4C55A.50400@egenix.com>


Marc-Andre Lemburg <mal at egenix.com> added the comment:

Sandro Tosi wrote:
> 
> Sandro Tosi <sandro.tosi at gmail.com> added the comment:
> 
> In addition, is there a reason for the sorting of UTF-8 UTF-32 UTF-16 and UTF-7 sections? why not alphabetically?

No particular reason. Alphabetical order would be just as good.

Note that such changes would have to be backported in order to
keep the merge conflicts to a minimum.

> Also, several parts of the doc would need paragraph re-indentation (not done in this patch due to clarity).

Not sure what you mean here.

----------
nosy: +lemburg

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

From report at bugs.python.org  Tue Apr 12 23:34:44 2011
From: report at bugs.python.org (Marc-Andre Lemburg)
Date: Tue, 12 Apr 2011 21:34:44 +0000
Subject: [docs] [issue11840] Improvements to c-api/unicode documentation
In-Reply-To: <1302643172.01.0.948666081662.issue11840@psf.upfronthosting.co.za>
Message-ID: <4DA4C571.7080009@egenix.com>


Marc-Andre Lemburg <mal at egenix.com> added the comment:

Sandro Tosi wrote:
> 
> New submission from Sandro Tosi <sandro.tosi at gmail.com>:
> 
> Hi,
> After reading tomo cocoa mail at docs@ I gave a look at c-api/unicode file and fixed some minor editing issues.

Thanks. Looks good !

----------

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

From report at bugs.python.org  Tue Apr 12 23:44:45 2011
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 12 Apr 2011 21:44:45 +0000
Subject: [docs] [issue11186] pydoc: HTMLDoc.index() doesn't support PEP 383
In-Reply-To: <1297428909.69.0.247564466299.issue11186@psf.upfronthosting.co.za>
Message-ID: <E1Q9lO8-0005lY-AV@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 506cab8fc329 by Victor Stinner in branch 'default':
Issue #11186: pydoc ignores a module if its name contains a surrogate character
http://hg.python.org/cpython/rev/506cab8fc329

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

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

From report at bugs.python.org  Tue Apr 12 23:44:52 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Tue, 12 Apr 2011 21:44:52 +0000
Subject: [docs] [issue11840] Improvements to c-api/unicode documentation
In-Reply-To: <4DA4C55A.50400@egenix.com>
Message-ID: <BANLkTimTi2-qXotJtkkr96HNVdAJQp83Pw@mail.gmail.com>


Sandro Tosi <sandro.tosi at gmail.com> added the comment:

On Tue, Apr 12, 2011 at 23:34, Marc-Andre Lemburg
<report at bugs.python.org> wrote:
> Sandro Tosi wrote:
>>
>> Sandro Tosi <sandro.tosi at gmail.com> added the comment:
>>
>> In addition, is there a reason for the sorting of UTF-8 UTF-32 UTF-16 and UTF-7 sections? why not alphabetically?
>
> No particular reason. Alphabetical order would be just as good.
>
> Note that such changes would have to be backported in order to
> keep the merge conflicts to a minimum.

It applies cleanly on 3.2 (module some offsets), not as good on 3.1
and 2.7: do you want me to prepare patches specifically for those 2
brances?

>> Also, several parts of the doc would need paragraph re-indentation (not done in this patch due to clarity).
>
> Not sure what you mean here.

sorry, I meant wrap at 80th column (or so) :)

Cheers.
-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

----------

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

From report at bugs.python.org  Tue Apr 12 23:45:14 2011
From: report at bugs.python.org (STINNER Victor)
Date: Tue, 12 Apr 2011 21:45:14 +0000
Subject: [docs] [issue11186] pydoc: HTMLDoc.index() doesn't support PEP 383
In-Reply-To: <1297428909.69.0.247564466299.issue11186@psf.upfronthosting.co.za>
Message-ID: <1302644714.08.0.95898031794.issue11186@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Tue Apr 12 23:56:12 2011
From: report at bugs.python.org (Marc-Andre Lemburg)
Date: Tue, 12 Apr 2011 21:56:12 +0000
Subject: [docs] [issue11840] Improvements to c-api/unicode documentation
In-Reply-To: <BANLkTimTi2-qXotJtkkr96HNVdAJQp83Pw@mail.gmail.com>
Message-ID: <4DA4CA78.4090607@egenix.com>


Marc-Andre Lemburg <mal at egenix.com> added the comment:

Sandro Tosi wrote:
> 
> Sandro Tosi <sandro.tosi at gmail.com> added the comment:
> 
> On Tue, Apr 12, 2011 at 23:34, Marc-Andre Lemburg
> <report at bugs.python.org> wrote:
>> Sandro Tosi wrote:
>>>
>>> Sandro Tosi <sandro.tosi at gmail.com> added the comment:
>>>
>>> In addition, is there a reason for the sorting of UTF-8 UTF-32 UTF-16 and UTF-7 sections? why not alphabetically?
>>
>> No particular reason. Alphabetical order would be just as good.
>>
>> Note that such changes would have to be backported in order to
>> keep the merge conflicts to a minimum.
> 
> It applies cleanly on 3.2 (module some offsets), not as good on 3.1
> and 2.7: do you want me to prepare patches specifically for those 2
> brances?

I think you misunderstood: when reorganizing the contents of
a file, it's better to apply the patch to all branches, rather
than just the current, since otherwise future patches that do
have to be merged to all branches would cause lots of merge
conflicts.

>>> Also, several parts of the doc would need paragraph re-indentation (not done in this patch due to clarity).
>>
>> Not sure what you mean here.
> 
> sorry, I meant wrap at 80th column (or so) :)

Ah, ok.

That's the same category of change as the reorg above
(due to diff working line-based and not word based).

Such changes are fine, but should only be applied occasionally
and then preferably as one big commit to minimize disruption.

----------

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

From report at bugs.python.org  Wed Apr 13 01:00:37 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Tue, 12 Apr 2011 23:00:37 +0000
Subject: [docs] [issue11806] Missing 2 hyphens in the docs
In-Reply-To: <1302338197.1.0.100311254016.issue11806@psf.upfronthosting.co.za>
Message-ID: <1302649237.79.0.174051006311.issue11806@psf.upfronthosting.co.za>


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

IMO these are a waste of time and add zero value.  Also, the English hyphenation conventions vary depending on who you ask and they vary over time.

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

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

From report at bugs.python.org  Wed Apr 13 01:34:17 2011
From: report at bugs.python.org (=?utf-8?q?Bo=C5=A1tjan_Mejak?=)
Date: Tue, 12 Apr 2011 23:34:17 +0000
Subject: [docs] [issue11806] Missing 2 hyphens in the docs
In-Reply-To: <1302649237.79.0.174051006311.issue11806@psf.upfronthosting.co.za>
Message-ID: <BANLkTim3CPcxj5h7aCqkqTyDc5y=oOoSBg@mail.gmail.com>


Bo??tjan Mejak <bostjan.mejak at gmail.com> added the comment:

There are more of this typos in the same chapter. Just a little below the
one of the reported sentence. Check this out...

"Assuming the Python code above is saved into a file called prog.py, it can
be run at the !! command line !! and provides useful help messages:"  --> it
has to be: command-line

But then this...

"When run with the appropriate arguments, it prints either the sum or the
max of the !! command-line !! integers:"  --> here it is correct!

I don't get it. Please be consistent. Thanks.

----------
Added file: http://bugs.python.org/file21638/unnamed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue11806>
_______________________________________
-------------- next part --------------
There are more of this typos in the same chapter. Just a little below the one of the reported sentence. Check this out...<div><br></div><div><span class="Apple-style-span" style="font-family: sans-serif; font-size: 16px; line-height: 20px; ">&quot;Assuming the Python code above is saved into a file called??<tt class="docutils literal" style="background-color: rgb(236, 240, 243); padding-top: 0px; padding-right: 1px; padding-bottom: 0px; padding-left: 1px; font-size: 0.95em; "><span class="pre">prog.py</span></tt>, it can be run at the !! command line !! and provides useful help messages:&quot; ??--&gt; it has to be: command-line</span></div>
<div><span class="Apple-style-span" style="font-family: sans-serif; font-size: 16px; line-height: 20px; "><br></span></div><div><span class="Apple-style-span" style="font-family: sans-serif; font-size: 16px; line-height: 20px; ">But then this...</span></div>
<div><span class="Apple-style-span" style="font-family: sans-serif; font-size: 16px; line-height: 20px; "><br></span></div><div><span class="Apple-style-span" style="font-family: sans-serif; font-size: 16px; line-height: 20px; ">&quot;When run with the appropriate arguments, it prints either the sum or the max of the !! command-line !! integers:&quot; ??--&gt; here it is correct!</span></div>
<div><span class="Apple-style-span" style="font-family: sans-serif; font-size: 16px; line-height: 20px; "><br></span></div><div><span class="Apple-style-span" style="font-family: sans-serif; font-size: 16px; line-height: 20px; ">I don&#39;t get it. Please be consistent. Thanks.</span></div>

From benjamin at python.org  Wed Apr 13 02:15:42 2011
From: benjamin at python.org (Benjamin Peterson)
Date: Tue, 12 Apr 2011 19:15:42 -0500
Subject: [docs] [issue11806] Missing 2 hyphens in the docs
In-Reply-To: <BANLkTim3CPcxj5h7aCqkqTyDc5y=oOoSBg@mail.gmail.com>
References: <1302649237.79.0.174051006311.issue11806@psf.upfronthosting.co.za>
	<BANLkTim3CPcxj5h7aCqkqTyDc5y=oOoSBg@mail.gmail.com>
Message-ID: <BANLkTinVeD-LLVSfG1oFTdKVKCik06FJjA@mail.gmail.com>

2011/4/12 Bo?tjan Mejak <report at bugs.python.org>:
>
> Bo??tjan Mejak <bostjan.mejak at gmail.com> added the comment:
>
> There are more of this typos in the same chapter. Just a little below the
> one of the reported sentence. Check this out...
>
> "Assuming the Python code above is saved into a file called prog.py, it can
> be run at the !! command line !! and provides useful help messages:" ?--> it
> has to be: command-line
>
> But then this...
>
> "When run with the appropriate arguments, it prints either the sum or the
> max of the !! command-line !! integers:" ?--> here it is correct!
>
> I don't get it. Please be consistent. Thanks.

"A foolish consistency is the hobgoblin of little minds."



-- 
Regards,
Benjamin

From report at bugs.python.org  Wed Apr 13 04:04:31 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Wed, 13 Apr 2011 02:04:31 +0000
Subject: [docs] [issue11806] Missing 2 hyphens in the docs
In-Reply-To: <1302338197.1.0.100311254016.issue11806@psf.upfronthosting.co.za>
Message-ID: <1302660271.44.0.512254417762.issue11806@psf.upfronthosting.co.za>


Changes by Raymond Hettinger <raymond.hettinger at gmail.com>:


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

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

From report at bugs.python.org  Wed Apr 13 04:10:50 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Wed, 13 Apr 2011 02:10:50 +0000
Subject: [docs] [issue11840] Improvements to c-api/unicode documentation
In-Reply-To: <1302643172.01.0.948666081662.issue11840@psf.upfronthosting.co.za>
Message-ID: <1302660650.75.0.023595981504.issue11840@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Wed Apr 13 06:55:12 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Wed, 13 Apr 2011 04:55:12 +0000
Subject: [docs] [issue11840] Improvements to c-api/unicode documentation
In-Reply-To: <1302643172.01.0.948666081662.issue11840@psf.upfronthosting.co.za>
Message-ID: <1302670512.3.0.354475161366.issue11840@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

Rewrapping the paragraphs you are changing is fine, the others can be left as they are.
Patches should be against the oldest branch where they can be applied, and since this is a doc patch it can go in 2.7 and 3.1 too.
Regarding the order of the codecs, I would leave UTF-7 last because it's not commonly used, changing them to 8/16/32/7 is probably OK though.

----------

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

From report at bugs.python.org  Wed Apr 13 09:23:28 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Wed, 13 Apr 2011 07:23:28 +0000
Subject: [docs] [issue10976] json.loads() throws TypeError on bytes object
In-Reply-To: <1295636509.41.0.0138366952356.issue10976@psf.upfronthosting.co.za>
Message-ID: <1302679408.69.0.132075677423.issue10976@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

Now it's too late for 3.2, should this be done for 3.3?

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

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

From report at bugs.python.org  Wed Apr 13 09:36:02 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Wed, 13 Apr 2011 07:36:02 +0000
Subject: [docs] [issue9101] reference json format in file formats chapter
In-Reply-To: <1277739443.04.0.607128047102.issue9101@psf.upfronthosting.co.za>
Message-ID: <1302680162.2.0.612535033489.issue9101@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

The json module is listed in the Internet Data Handling section[0], and the description says:
"""
This chapter describes modules which support handling data formats commonly used on the Internet.
"""
This seems OK for json.


The File Format section[1] says:
"""
The modules described in this chapter parse various miscellaneous file formats that aren?t markup languages and are not related to e-mail.
"""
And this description might work for json too.

I'm not sure it's worth moving it though.


[0]: http://docs.python.org/py3k/library/netdata.html
[1]: http://docs.python.org/py3k/library/fileformats.html

----------
nosy: +ezio.melotti, georg.brandl

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

From report at bugs.python.org  Wed Apr 13 09:51:53 2011
From: report at bugs.python.org (=?utf-8?q?Bo=C5=A1tjan_Mejak?=)
Date: Wed, 13 Apr 2011 07:51:53 +0000
Subject: [docs] [issue11806] Missing 2 hyphens in the docs
In-Reply-To: <1302660271.44.0.512254417762.issue11806@psf.upfronthosting.co.za>
Message-ID: <BANLkTi=C2sRDiPQVZs6c68te+AfZhOV5nQ@mail.gmail.com>


Bo??tjan Mejak <bostjan.mejak at gmail.com> added the comment:

Georg Brandl, please fix this typos. You would understand. Thank you.

----------
Added file: http://bugs.python.org/file21643/unnamed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue11806>
_______________________________________
-------------- next part --------------
Georg Brandl, please fix this typos. You would understand. Thank you.

From report at bugs.python.org  Wed Apr 13 10:22:17 2011
From: report at bugs.python.org (anatoly techtonik)
Date: Wed, 13 Apr 2011 08:22:17 +0000
Subject: [docs] [issue9101] reference json format in file formats chapter
In-Reply-To: <1277739443.04.0.607128047102.issue9101@psf.upfronthosting.co.za>
Message-ID: <1302682937.6.0.434535386073.issue9101@psf.upfronthosting.co.za>


anatoly techtonik <techtonik at gmail.com> added the comment:

JSON is not file format, it is data-interchange format.

----------

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

From report at bugs.python.org  Wed Apr 13 10:24:19 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Wed, 13 Apr 2011 08:24:19 +0000
Subject: [docs] =?utf-8?q?=5Bissue4783=5D_document_that_json=2Eload/dump_c?=
 =?utf-8?q?an=E2=80=99t_be_used_twice_on_the_same_stream?=
In-Reply-To: <1230657409.93.0.0443603821797.issue4783@psf.upfronthosting.co.za>
Message-ID: <1302683058.98.0.549074512654.issue4783@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

Attached patch adds a note about the effects of using dump several times on the same file.

----------
keywords: +easy, needs review, patch
nosy: +ezio.melotti
stage:  -> patch review
Added file: http://bugs.python.org/file21645/issue4783.diff

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

From report at bugs.python.org  Wed Apr 13 10:28:56 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Wed, 13 Apr 2011 08:28:56 +0000
Subject: [docs] [issue9101] reference json format in file formats chapter
In-Reply-To: <1277739443.04.0.607128047102.issue9101@psf.upfronthosting.co.za>
Message-ID: <1302683336.03.0.617764705705.issue9101@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

We don't have a "Data-interchange Formats" section, so the "Internet Data Handling" section seems more appropriate than the "File Formats" one, right?

----------

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

From report at bugs.python.org  Wed Apr 13 10:43:28 2011
From: report at bugs.python.org (anatoly techtonik)
Date: Wed, 13 Apr 2011 08:43:28 +0000
Subject: [docs] [issue9101] reference json format in file formats chapter
In-Reply-To: <1277739443.04.0.607128047102.issue9101@psf.upfronthosting.co.za>
Message-ID: <1302684208.14.0.373451894716.issue9101@psf.upfronthosting.co.za>


anatoly techtonik <techtonik at gmail.com> added the comment:

Right.

----------

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

From report at bugs.python.org  Wed Apr 13 10:44:01 2011
From: report at bugs.python.org (anatoly techtonik)
Date: Wed, 13 Apr 2011 08:44:01 +0000
Subject: [docs] [issue9101] reference json format in file formats chapter
In-Reply-To: <1277739443.04.0.607128047102.issue9101@psf.upfronthosting.co.za>
Message-ID: <1302684241.47.0.763142234305.issue9101@psf.upfronthosting.co.za>


anatoly techtonik <techtonik at gmail.com> added the comment:

But having a reference from File Formats will help people find this information easier.

----------

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

From fdrake at acm.org  Wed Apr 13 12:22:30 2011
From: fdrake at acm.org (Fred Drake)
Date: Wed, 13 Apr 2011 06:22:30 -0400
Subject: [docs] [issue9101] reference json format in file formats chapter
In-Reply-To: <1302684241.47.0.763142234305.issue9101@psf.upfronthosting.co.za>
References: <1277739443.04.0.607128047102.issue9101@psf.upfronthosting.co.za>
	<1302684241.47.0.763142234305.issue9101@psf.upfronthosting.co.za>
Message-ID: <BANLkTimzCaTobwSDXS-bNzL4hXjreurCaA@mail.gmail.com>

And what are these people looking for?  "json"?  If so, there's
already an entry in the module index.  That seems sufficient.

From report at bugs.python.org  Wed Apr 13 13:54:03 2011
From: report at bugs.python.org (=?utf-8?q?Bo=C5=A1tjan_Mejak?=)
Date: Wed, 13 Apr 2011 11:54:03 +0000
Subject: [docs] [issue11806] Missing 2 hyphens in the docs
In-Reply-To: <BANLkTi=C2sRDiPQVZs6c68te+AfZhOV5nQ@mail.gmail.com>
Message-ID: <BANLkTin7HMUqE10AmQA_Bps4z0cONYcM=A@mail.gmail.com>


Bo??tjan Mejak <bostjan.mejak at gmail.com> added the comment:

Also, please fix the main title of the argparse section...

from
15.4. argparse<http://docs.python.org/dev/library/argparse.html#module-argparse>
???
Parser for command line options, arguments and sub-commands
to
15.4. argparse<http://docs.python.org/dev/library/argparse.html#module-argparse>
???
Parser for command-line options, arguments and sub-commands
Please note the added hyphen (-) for the word command-line. Since this is
actually one word, it needs the hyphen. This is not Python related, but is
orthology related. Please fix all this documentation imprecisions in the
section argparse. Won't take a minute.

----------
Added file: http://bugs.python.org/file21648/unnamed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue11806>
_______________________________________
-------------- next part --------------
Also, please fix the main title of the argparse section...<div><br></div><div>from</div><div><span class="Apple-style-span" style="font-family: sans-serif; font-size: 16px; "><h1 style="font-family: &#39;Trebuchet MS&#39;, sans-serif; background-color: rgb(242, 242, 242); font-weight: normal; color: rgb(32, 67, 92); border-bottom-width: 1px; border-bottom-style: solid; border-bottom-color: rgb(204, 204, 204); margin-top: 0px; margin-right: -20px; margin-bottom: 10px; margin-left: -20px; padding-top: 3px; padding-right: 0px; padding-bottom: 3px; padding-left: 10px; font-size: 32px; ">
15.4.??<a class="reference internal" href="http://docs.python.org/dev/library/argparse.html#module-argparse" title="argparse: Command-line option and argument parsing library." style="color: rgb(53, 95, 124); text-decoration: none; "><tt class="xref py py-mod docutils literal" style="background-color: transparent; padding-top: 0px; padding-right: 1px; padding-bottom: 0px; padding-left: 1px; font-size: 0.95em; font-weight: bold; "><span class="pre">argparse</span></tt></a>????? Parser for command line options, arguments and sub-commands</h1>
<div>to</div><div><h1 style="font-family: &#39;Trebuchet MS&#39;, sans-serif; background-color: rgb(242, 242, 242); font-weight: normal; color: rgb(32, 67, 92); border-bottom-width: 1px; border-bottom-style: solid; border-bottom-color: rgb(204, 204, 204); margin-top: 0px; margin-right: -20px; margin-bottom: 10px; margin-left: -20px; padding-top: 3px; padding-right: 0px; padding-bottom: 3px; padding-left: 10px; font-size: 32px; ">
15.4.??<a class="reference internal" href="http://docs.python.org/dev/library/argparse.html#module-argparse" title="argparse: Command-line option and argument parsing library." style="color: rgb(53, 95, 124); text-decoration: none; "><tt class="xref py py-mod docutils literal" style="background-color: transparent; padding-top: 0px; padding-right: 1px; padding-bottom: 0px; padding-left: 1px; font-size: 0.95em; font-weight: bold; "><span class="pre">argparse</span></tt></a>????? Parser for command-line options, arguments and sub-commands</h1>
</div><div>Please note the added hyphen (-) for the word command-line. Since this is actually one word, it needs the hyphen. This is not Python related, but is orthology related. Please fix all this documentation imprecisions in the section argparse. Won&#39;t take a minute.</div>
</span></div>

From report at bugs.python.org  Wed Apr 13 14:38:11 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Wed, 13 Apr 2011 12:38:11 +0000
Subject: [docs] [issue11806] Missing 2 hyphens in the docs
In-Reply-To: <BANLkTin7HMUqE10AmQA_Bps4z0cONYcM=A@mail.gmail.com>
Message-ID: <BANLkTikm_shp_-msVunjn5oLJpHoUKcYEw@mail.gmail.com>


Eli Bendersky <eliben at gmail.com> added the comment:

On Wed, Apr 13, 2011 at 14:54, Bo?tjan Mejak <report at bugs.python.org> wrote:
>
> Bo??tjan Mejak <bostjan.mejak at gmail.com> added the comment:
>
> Also, please fix the main title of the argparse section...
>
> from
> 15.4. argparse<http://docs.python.org/dev/library/argparse.html#module-argparse>
> ???
> Parser for command line options, arguments and sub-commands
> to
> 15.4. argparse<http://docs.python.org/dev/library/argparse.html#module-argparse>
> ???
> Parser for command-line options, arguments and sub-commands
> Please note the added hyphen (-) for the word command-line. Since this is
> actually one word, it needs the hyphen. This is not Python related, but is
> orthology related. Please fix all this documentation imprecisions in the
> section argparse. Won't take a minute.
>

Bo?tjan, please stop this trolling. You were told by two core-devs
that it won't be fixed. There's no use keeping spamming the mailing
list.

A short googling shows that the jury is still out on the question of
whether command-line is more correct than command line. Some places
use a hyphen, some don't. This really isn't important enough to call
for hunting out hyphen-less spellings throughout the docs.

If you want to contribute to Python, please find issues with substance
to raise. As it is now, you're only harming Python by wasting the time
of core developers.

Eli

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

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

From report at bugs.python.org  Wed Apr 13 17:12:33 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 13 Apr 2011 15:12:33 +0000
Subject: [docs] [issue11186] pydoc: HTMLDoc.index() doesn't support PEP 383
In-Reply-To: <1297428909.69.0.247564466299.issue11186@psf.upfronthosting.co.za>
Message-ID: <1302707553.69.0.741847199767.issue11186@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

The wording ?pydoc ignores a module? is confusing to me: I can?t tell whether it is a description of the bug (?pydoc ignored a module?) or the new, correct behavior (?pydoc now ignores a module?).

Regarding the problem and fix itself, I?m wondering.  If a user unknowingly creates such a module with an unencodable filename, will they understand why pydoc does not display it?

----------
nosy: +eric.araujo, lemburg, loewis

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

From report at bugs.python.org  Wed Apr 13 17:24:09 2011
From: report at bugs.python.org (STINNER Victor)
Date: Wed, 13 Apr 2011 15:24:09 +0000
Subject: [docs] [issue11186] pydoc: HTMLDoc.index() doesn't support PEP 383
In-Reply-To: <1297428909.69.0.247564466299.issue11186@psf.upfronthosting.co.za>
Message-ID: <1302708249.86.0.453357634007.issue11186@psf.upfronthosting.co.za>


STINNER Victor <victor.stinner at haypocalc.com> added the comment:

> If a user unknowingly creates such a module with an unencodable
> filename, will they understand why pydoc does not display it?

It is really a bad idea to choose an *undecodable* name for a module. You will not be able to write its name using "import name" syntax.

(It is possible to import such module using __import__, but it is just ugly)

For the changelog, feel free to rephrase it.

----------

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

From report at bugs.python.org  Wed Apr 13 17:40:47 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 13 Apr 2011 15:40:47 +0000
Subject: [docs] [issue10976] json.loads() throws TypeError on bytes object
In-Reply-To: <1295636509.41.0.0138366952356.issue10976@psf.upfronthosting.co.za>
Message-ID: <1302709247.01.0.847888785279.issue10976@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

If you?re talking about deprecating the obsolete encoding argument (maybe it?s time for a new bug report), +1.

----------
versions:  -Python 3.1

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

From report at bugs.python.org  Wed Apr 13 17:42:18 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 13 Apr 2011 15:42:18 +0000
Subject: [docs] [issue11827] mention of list2cmdline() in docs of
	subprocess.Popen
In-Reply-To: <1302511097.53.0.993242324349.issue11827@psf.upfronthosting.co.za>
Message-ID: <1302709338.92.0.94796661657.issue11827@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

LGTM.

----------
versions: +Python 2.7, Python 3.1, Python 3.3

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

From sandro.tosi at gmail.com  Wed Apr 13 18:36:47 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Wed, 13 Apr 2011 18:36:47 +0200
Subject: [docs] "knights of Ni" bug
In-Reply-To: <4DA35E9D.8030709@underhill.ca>
References: <4D9E35CE.3060100@underhill.ca>
	<BANLkTinWfXO7c2Gvu=Lx1t13jtX9umtkjg@mail.gmail.com>
	<4DA35E9D.8030709@underhill.ca>
Message-ID: <BANLkTim6K_Vp6isxnhYmks80scaA_cCh5w@mail.gmail.com>

Hi Martin,
thanks for your detailed email :)

On Mon, Apr 11, 2011 at 22:03, Martin Feuchtwanger <martinf at underhill.ca> wrote:
> Hi Sandro, Benjamin, et al.,
>
> Maybe you didn't notice -- i was using 2.6.4

I thought I was using 2.6 but I was on a 2.7, that's the difference in
behaviour :)

> IDLE 2.6.4
>>>> print 'We are the {} who say "{}!"'.format('knights', 'Ni')
>
> Traceback (most recent call last):
> ? File "<pyshell#0>", line 1, in <module>
> ??? print 'We are the {} who say "{}!"'.format('knights', 'Ni')
> ValueError: zero length field name in format

As you already know, the tutorial is for python 2.7 so the syntax can
be different than previous versions.

> If you're wondering why i'm using 2.6...
> I was following the advice on
> http://wiki.python.org/moin/BeginnersGuide/Download so i downloaded and
> installed 2.6.4 on my windows work computer. I worked thru the web-based
> tutorial http://docs.python.org/tutorial/ and all was well until i got to
> the "knights of ni" example, hence my first email query.

Wikis are an extremely powerful tools, but they need to be updated -
and reader should be aware (generally speaking) wiki can be outdated,
while official documentation is not.

> Interestingly, on the weekend, when i decided to install python on my home
> computer, i never saw any advice re stability on windows {i now realize it
> is because, silly me, i was getting advice on two different python.org web
> sites}, so i downloaded and installed 3.2 on it. Unfortunately, none of the
> print examples in the web-based tutorial http://docs.python.org/tutorial/
> work on 3.2
>
> Python 3.2 (r32:88445, Feb 20 2011, 21:29:02) [MSC v.1500 32 bit (Intel)] on
> win32
>>>> print 'We are the {} who say "{}!"'.format('knights', 'Ni')
> SyntaxError: invalid syntax
>
> Now, i notice that the web tutorial is for python 2.7,

exactly that's the problem :)

> and i'm well aware,
> from other parts of the web site, that there are significant changes from
> python 2 to python 3, and, yes, i know that in python 3 print follows strict
> function syntax, but may i suggest to you, and maybe to the entire docs/wiki
> team,
>
> That each tutorial have this added at the beginning:? "Note that this
> tutorial is version N and many of the examples will not work with version
> N-1 or version N+1 because the silly bunts at python.org like to invent a
> new kind of python with each release".

of course this won't happen. Please note that at the beginning of the
tutorial, there's the precise version of it: in your case:

Release:	2.7
Date:	April 13, 2011

> That you explain on both wiki.python.org and docs.python.org that, although
> they (docs and wiki) look the same they are different web sites and contain
> conflicting information.

Wiki.python.org is registration-free: you can create a user (or use an
openid provider, like google) and start updating the pages you feel
need a bit of attention. You'll convert your problematic experience in
a contribution to python, and that would be awesome!

Cheers,
-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

From mail at itziakos.gr  Tue Apr 12 17:09:28 2011
From: mail at itziakos.gr (Ioannis Tziakos)
Date: Tue, 12 Apr 2011 16:09:28 +0100
Subject: [docs] missing info for the documentation of set.add()
Message-ID: <op.vtty10i0f366wy@athina.eecs.qmul.ac.uk>

Hi All,

I have noticed that there is a difference in the current documentation for
python 2.7.1 and
the doc-string of set.add().

The documentation (http://docs.python.org/library/stdtypes.html#set) reads

--------
add(elem)
	Add element elem to the set.
--------


While python 2.7.1 doc string provides additional info

--------
Python 2.7.1 (r271:86832, Nov 27 2010, 18:30:46) [MSC v.1500 32 bit
(Intel)] on win32
Type "copyright", "credits" or "license()" for more information.
>>> help(set.add)
Help on method_descriptor:

add(...)
       Add an element to a set.

       This has no effect if the element is already present.

>>>
--------


Regards,
Ioannis Tziakos

From varghese85 at gmail.com  Wed Apr 13 17:22:35 2011
From: varghese85 at gmail.com (Matt | Varghese Mathew)
Date: Wed, 13 Apr 2011 10:22:35 -0500
Subject: [docs] Large print / small paper size (maybe A5) python docs.
Message-ID: <BANLkTin9F9NVk0-AcD7Saydok+udMMbS=g@mail.gmail.com>

Hi,

Would it be possible to release large print / small paper size python docs?
Would work well with something like a kindle or many tablets.
The A4 / US letter sizes make the print too tiny on a kindle.

/matt

-- 
Matt | Varghese Mathew
M.S. Computer Sciences (UW-Madison,2010)
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20110413/70317d55/attachment.html>

From martinf at underhill.ca  Wed Apr 13 19:42:08 2011
From: martinf at underhill.ca (Martin Feuchtwanger)
Date: Wed, 13 Apr 2011 10:42:08 -0700
Subject: [docs] method function or member function
Message-ID: <4DA5E070.8020207@underhill.ca>

Hi,

Just wondering if there's a mistake in http://docs.python.org/py3k/tutorial/classes.html

I have only limited experience of C++ objects, but i think classes have member variables (or data) 
and member functions (or methods). So shouldn't

"As in Modula-3, there are no shorthands for referencing the object's members from its methods: the 
*method *function is declared with an explicit first argument representing the object, which is 
provided implicitly by the call. As in Smalltalk, classes themselves are objects. This provides 
semantics for importing and renaming."

really be

"As in Modula-3, there are no shorthands for referencing the object's members from its methods: the 
*member *function is declared with an explicit first argument representing the object, which is 
provided implicitly by the call. As in Smalltalk, classes themselves are objects. This provides 
semantics for importing and renaming."
?

Cheers,

-- 
Martin Feuchtwanger, PhD   martinf at underhill.ca   604-732-3384 x 206
Underhill Geomatics Ltd.   www.underhill.ca
210A, 3430 Brighton Ave.   Burnaby, BC            V5A 3H4

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20110413/9e23668d/attachment.html>

From martinf at underhill.ca  Wed Apr 13 20:05:01 2011
From: martinf at underhill.ca (Martin Feuchtwanger)
Date: Wed, 13 Apr 2011 11:05:01 -0700
Subject: [docs] I or we, and credits
Message-ID: <4DA5E5CD.1050409@underhill.ca>

I notice the writer or writers of the excellent tutorial occasionally refer to themselves in the 
first person singular (I), but i see nobody credited.

Assuming it is a group effort, by Python Software Foundation, shouldn't the writers refer to 
themselves in the first person plural (we)?

I know i sound picky and critical, but overall, i just want to contribute ... to improve things.

cheers (and see PS, below)

-- 
Martin Feuchtwanger, PhD   martinf at underhill.ca   604-732-3384 x 206
Underhill Geomatics Ltd.   www.underhill.ca
210A, 3430 Brighton Ave.   Burnaby, BC            V5A 3H4


PS: I now see <linkrel="author" title="About these documents" href="../about.html 
<view-source:http://docs.python.org/py3k/about.html>" /> in the html source, so viewing the page in 
Opera, and showing the Navigation bar, i find the http://docs.python.org/py3k/about.html page :-)
I also now see the "About the documentation" link on the home page, but think it should also go on 
the page footer (along with Copyright and Found a bug).
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20110413/c837c3cc/attachment.html>

From fdrake at acm.org  Wed Apr 13 20:13:23 2011
From: fdrake at acm.org (Fred Drake)
Date: Wed, 13 Apr 2011 14:13:23 -0400
Subject: [docs] method function or member function
In-Reply-To: <4DA5E070.8020207@underhill.ca>
References: <4DA5E070.8020207@underhill.ca>
Message-ID: <BANLkTi=pPeVxabA0vULR_A5tcLiLC2d0MA@mail.gmail.com>

On Wed, Apr 13, 2011 at 1:42 PM, Martin Feuchtwanger
<martinf at underhill.ca> wrote:
> the method function

That is just a bit confusing.  I'd go with "method" instead of "member
function", both because the term is more common, and also shorter.

Well, it was more common the last time I ventured out, at least.


  -Fred

-- 
Fred L. Drake, Jr.? ? <fdrake at acm.org>
"Give me the luxuries of life and I will willingly do without the necessities."
?? --Frank Lloyd Wright

From martinf at underhill.ca  Wed Apr 13 20:52:12 2011
From: martinf at underhill.ca (Martin Feuchtwanger)
Date: Wed, 13 Apr 2011 11:52:12 -0700
Subject: [docs] "knights of Ni" bug
In-Reply-To: <BANLkTim6K_Vp6isxnhYmks80scaA_cCh5w@mail.gmail.com>
References: <4D9E35CE.3060100@underhill.ca>
	<BANLkTinWfXO7c2Gvu=Lx1t13jtX9umtkjg@mail.gmail.com>
	<4DA35E9D.8030709@underhill.ca>
	<BANLkTim6K_Vp6isxnhYmks80scaA_cCh5w@mail.gmail.com>
Message-ID: <4DA5F0DC.9080206@underhill.ca>

Sandro,

Thanks for all the thoughtful responses -- most helpful!

I still think that something like

"Note that this tutorial is version N and many of the examples will not work with version
N-1 or version N+1 because ..."

Placed at the beginning --and frequently throughout-- will be very useful to a beginner --or anyone 
for that matter-- and it would even be more useful than

"Python is an easy to learn, powerful programming language. It has efficient
high-level data structures and a simple but effective approach to
object-oriented programming. Python?s elegant syntax and dynamic typing,
together with its interpreted nature, make it an ideal language for scripting
and rapid application development in many areas on most platforms."

after all, it is supposed to be a tutorial on --not an advertisement for-- Python.

Cheers,

Martin Feuchtwanger


On 13/04/2011 9:36 AM, Sandro Tosi wrote:
> Hi Martin,
> thanks for your detailed email :)
>
> On Mon, Apr 11, 2011 at 22:03, Martin Feuchtwanger<martinf at underhill.ca>  wrote:
>> Hi Sandro, Benjamin, et al.,
>>
>> Maybe you didn't notice -- i was using 2.6.4
> I thought I was using 2.6 but I was on a 2.7, that's the difference in
> behaviour :)
>
>> IDLE 2.6.4
>>>>> print 'We are the {} who say "{}!"'.format('knights', 'Ni')
>> Traceback (most recent call last):
>>    File "<pyshell#0>", line 1, in<module>
>>      print 'We are the {} who say "{}!"'.format('knights', 'Ni')
>> ValueError: zero length field name in format
> As you already know, the tutorial is for python 2.7 so the syntax can
> be different than previous versions.
>
>> If you're wondering why i'm using 2.6...
>> I was following the advice on
>> http://wiki.python.org/moin/BeginnersGuide/Download so i downloaded and
>> installed 2.6.4 on my windows work computer. I worked thru the web-based
>> tutorial http://docs.python.org/tutorial/ and all was well until i got to
>> the "knights of ni" example, hence my first email query.
> Wikis are an extremely powerful tools, but they need to be updated -
> and reader should be aware (generally speaking) wiki can be outdated,
> while official documentation is not.
>
>> Interestingly, on the weekend, when i decided to install python on my home
>> computer, i never saw any advice re stability on windows {i now realize it
>> is because, silly me, i was getting advice on two different python.org web
>> sites}, so i downloaded and installed 3.2 on it. Unfortunately, none of the
>> print examples in the web-based tutorial http://docs.python.org/tutorial/
>> work on 3.2
>>
>> Python 3.2 (r32:88445, Feb 20 2011, 21:29:02) [MSC v.1500 32 bit (Intel)] on
>> win32
>>>>> print 'We are the {} who say "{}!"'.format('knights', 'Ni')
>> SyntaxError: invalid syntax
>>
>> Now, i notice that the web tutorial is for python 2.7,
> exactly that's the problem :)
>
>> and i'm well aware,
>> from other parts of the web site, that there are significant changes from
>> python 2 to python 3, and, yes, i know that in python 3 print follows strict
>> function syntax, but may i suggest to you, and maybe to the entire docs/wiki
>> team,
>>
>> That each tutorial have this added at the beginning:  "Note that this
>> tutorial is version N and many of the examples will not work with version
>> N-1 or version N+1 because the silly bunts at python.org like to invent a
>> new kind of python with each release".
> of course this won't happen. Please note that at the beginning of the
> tutorial, there's the precise version of it: in your case:
>
> Release:	2.7
> Date:	April 13, 2011
>
>> That you explain on both wiki.python.org and docs.python.org that, although
>> they (docs and wiki) look the same they are different web sites and contain
>> conflicting information.
> Wiki.python.org is registration-free: you can create a user (or use an
> openid provider, like google) and start updating the pages you feel
> need a bit of attention. You'll convert your problematic experience in
> a contribution to python, and that would be awesome!
>
> Cheers,

From martinf at underhill.ca  Wed Apr 13 21:22:39 2011
From: martinf at underhill.ca (Martin Feuchtwanger)
Date: Wed, 13 Apr 2011 12:22:39 -0700
Subject: [docs] green bugs and spam
Message-ID: <4DA5F7FF.1000406@underhill.ca>

Buglet:

In http://docs.python.org/py3k/tutorial/classes.html#scopes-and-namespaces-example the "nonlocal" 
statement  should be green.

     <span  class="k">def</span>  <span  class="nf">do_nonlocal</span><span  class="p">():</span>
         <span  class="*n*">nonlocal</span>  <span  class="n">spam</span>
         <span  class="n">spam</span>  <span  class="o">=</span>  <span  class="s">&quot;nonlocal spam&quot;</span>

That is, it should be in the "k" class

     <span  class="k">def</span>  <span  class="nf">do_nonlocal</span><span  class="p">():</span>
         <span  class="*k*">nonlocal</span>  <span  class="n">spam</span>
         <span  class="n">spam</span>  <span  class="o">=</span>  <span  class="s">&quot;nonlocal spam&quot;</span>

Great example, BTW -- helped me understand exactly.

-- 
Martin Feuchtwanger, PhD   martinf at underhill.ca   604-732-3384 x 206
Underhill Geomatics Ltd.   www.underhill.ca
210A, 3430 Brighton Ave.   Burnaby, BC            V5A 3H4

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

From fdrake at acm.org  Wed Apr 13 21:21:46 2011
From: fdrake at acm.org (Fred Drake)
Date: Wed, 13 Apr 2011 15:21:46 -0400
Subject: [docs] Large print / small paper size (maybe A5) python docs.
In-Reply-To: <BANLkTin9F9NVk0-AcD7Saydok+udMMbS=g@mail.gmail.com>
References: <BANLkTin9F9NVk0-AcD7Saydok+udMMbS=g@mail.gmail.com>
Message-ID: <BANLkTimfhOK5ys2cWsgivZqTycUUysARVA@mail.gmail.com>

On Wed, Apr 13, 2011 at 11:22 AM, Matt | Varghese Mathew
<varghese85 at gmail.com> wrote:
> Would it be possible to release large print / small paper size python docs?
> Would work well with something like a kindle or many tablets.
> The A4 / US letter sizes make the print too tiny on a kindle.

I think there's a plan in the works for an epub or mobi format
version; this should alleviate the pain of using the letter-size PDF
version on such devices.


  -Fred

-- 
Fred L. Drake, Jr.? ? <fdrake at acm.org>
"Give me the luxuries of life and I will willingly do without the necessities."
?? --Frank Lloyd Wright

From report at bugs.python.org  Wed Apr 13 22:25:42 2011
From: report at bugs.python.org (Bryce Verdier)
Date: Wed, 13 Apr 2011 20:25:42 +0000
Subject: [docs] =?utf-8?q?=5Bissue4783=5D_document_that_json=2Eload/dump_c?=
 =?utf-8?q?an=E2=80=99t_be_used_twice_on_the_same_stream?=
In-Reply-To: <1230657409.93.0.0443603821797.issue4783@psf.upfronthosting.co.za>
Message-ID: <1302726342.56.0.245369966892.issue4783@psf.upfronthosting.co.za>


Bryce Verdier <bryceverdier at gmail.com> added the comment:

Not to nitpick, but what about the wording used in the simplejson documentation that Bob wrote almost 3 years ago? 

Note
JSON is not a framed protocol so unlike pickle or marshal it does not make sense to serialize more than one JSON document without some container protocol to delimit them

I also feel that it sounds a little bit cleaner.

http://simplejson.github.com/simplejson/#simplejson.dump

----------
nosy: +louiscipher

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

From report at bugs.python.org  Wed Apr 13 22:48:15 2011
From: report at bugs.python.org (=?utf-8?q?Bo=C5=A1tjan_Mejak?=)
Date: Wed, 13 Apr 2011 20:48:15 +0000
Subject: [docs] [issue11806] Missing 2 hyphens in the docs
In-Reply-To: <BANLkTikm_shp_-msVunjn5oLJpHoUKcYEw@mail.gmail.com>
Message-ID: <BANLkTi=4W4qCiQNGL5CoCzm1PzkTSJ1Uzg@mail.gmail.com>


Bo??tjan Mejak <bostjan.mejak at gmail.com> added the comment:

If you'd look into the English dictionary, you'd find words like
coffee-table and command-line and built-in and user-friendly. The main
bother in this issue is the inconsistency with the wording "command-line".
Somewhere under the argparse section of the docs it is "command line" and
then shortly after it is "command-line". Make up your mind and be consistent
with one wording. I propose to let it be "command-line" as the major
dictionary of English language writes it, with a hyphen that is. Thank you.

----------
Added file: http://bugs.python.org/file21654/unnamed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue11806>
_______________________________________
-------------- next part --------------
If you&#39;d look into the English dictionary, you&#39;d find words like coffee-table and command-line and built-in and user-friendly. The main bother in this issue is the inconsistency with the wording &quot;command-line&quot;. Somewhere under the argparse section of the docs it is &quot;command line&quot; and then shortly after it is &quot;command-line&quot;. Make up your mind and be consistent with one wording. I propose to let it be &quot;command-line&quot; as the major dictionary of English language writes it, with a hyphen that is. Thank you.

From report at bugs.python.org  Wed Apr 13 23:43:39 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Wed, 13 Apr 2011 21:43:39 +0000
Subject: [docs] [issue11840] Improvements to c-api/unicode documentation
In-Reply-To: <4DA4CA78.4090607@egenix.com>
Message-ID: <BANLkTikfMrU7FmRLkf3sntnE2NXLAvUjeA@mail.gmail.com>


Sandro Tosi <sandro.tosi at gmail.com> added the comment:

On Tue, Apr 12, 2011 at 23:56, Marc-Andre Lemburg
<report at bugs.python.org> wrote:
> Marc-Andre Lemburg <mal at egenix.com> added the comment:
> I think you misunderstood: when reorganizing the contents of
> a file, it's better to apply the patch to all branches, rather
> than just the current, since otherwise future patches that do
> have to be merged to all branches would cause lots of merge
> conflicts.

the problem is: the file Doc/c-api/unicode.rst is already different
between all the "open" branches. I'll provide patches for each of
them, or specify where the patch can be merged (and from where).

> Ezio Melotti <ezio.melotti at gmail.com> added the comment:
>
> Rewrapping the paragraphs you are changing is fine, the others can be left as they are.

Once I was told not to, since in this case it will hide the changes I
made in between the rewrap.

> Patches should be against the oldest branch where they can be applied, and since this is a doc patch it can go in 2.7 and 3.1 too.

I'm just about to prepare patches for all the supported branches
(where a merge is not possible).

----------

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

From report at bugs.python.org  Thu Apr 14 00:26:46 2011
From: report at bugs.python.org (anatoly techtonik)
Date: Wed, 13 Apr 2011 22:26:46 +0000
Subject: [docs] [issue9101] reference json format in file formats chapter
In-Reply-To: <1277739443.04.0.607128047102.issue9101@psf.upfronthosting.co.za>
Message-ID: <1302733606.36.0.595284556787.issue9101@psf.upfronthosting.co.za>


anatoly techtonik <techtonik at gmail.com> added the comment:

These people look for alternative configuration format to .ini, for example.

----------

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

From report at bugs.python.org  Thu Apr 14 00:40:09 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Wed, 13 Apr 2011 22:40:09 +0000
Subject: [docs] [issue11840] Improvements to c-api/unicode documentation
In-Reply-To: <1302643172.01.0.948666081662.issue11840@psf.upfronthosting.co.za>
Message-ID: <1302734409.85.0.177148225247.issue11840@psf.upfronthosting.co.za>


Changes by Sandro Tosi <sandro.tosi at gmail.com>:


Added file: http://bugs.python.org/file21657/unicode_doc-2.7.patch

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

From report at bugs.python.org  Thu Apr 14 00:40:25 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Wed, 13 Apr 2011 22:40:25 +0000
Subject: [docs] [issue11840] Improvements to c-api/unicode documentation
In-Reply-To: <1302643172.01.0.948666081662.issue11840@psf.upfronthosting.co.za>
Message-ID: <1302734425.76.0.36069640339.issue11840@psf.upfronthosting.co.za>


Changes by Sandro Tosi <sandro.tosi at gmail.com>:


Added file: http://bugs.python.org/file21658/unicode_doc-3.1.patch

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

From report at bugs.python.org  Thu Apr 14 00:42:01 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Wed, 13 Apr 2011 22:42:01 +0000
Subject: [docs] [issue11840] Improvements to c-api/unicode documentation
In-Reply-To: <1302643172.01.0.948666081662.issue11840@psf.upfronthosting.co.za>
Message-ID: <1302734521.54.0.307180059817.issue11840@psf.upfronthosting.co.za>


Sandro Tosi <sandro.tosi at gmail.com> added the comment:

The status of the patches is this:

unicode_doc-2.7.patch - to be applied on 2.7
unicode_doc-3.1.patch - to be applied on 3.1
unicode_doc-default.patch - to be applied on 3.2 and then merged on default

I had to prepare multiple patches since the files are very different between supported branches.

----------

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

From report at bugs.python.org  Thu Apr 14 05:01:35 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 14 Apr 2011 03:01:35 +0000
Subject: [docs] =?utf-8?q?=5Bissue4783=5D_document_that_json=2Eload/dump_c?=
 =?utf-8?q?an=E2=80=99t_be_used_twice_on_the_same_stream?=
In-Reply-To: <1230657409.93.0.0443603821797.issue4783@psf.upfronthosting.co.za>
Message-ID: <1302750095.36.0.177143558894.issue4783@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

I saw that and found it not clear, that's why I rephrased it.
In order to understand that one has to know what is a "framed protocol", what can be considered a "JSON document" (is a single object a JSON document? or does it need to be serialized first?), what is a "container protocol" (can I use one? where can I find it? is there a default one for JSON?).

I think it's clearer to just say that you can't do json.dump(obj1, f); dump(obj2, f).
I also omitted the note on `load`, because if you can't add more objects to the same file using json.dump you won't even try to use json.load to extract them one by one.

----------

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

From report at bugs.python.org  Thu Apr 14 05:54:18 2011
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 14 Apr 2011 03:54:18 +0000
Subject: [docs] [issue9101] reference json format in file formats chapter
In-Reply-To: <1277739443.04.0.607128047102.issue9101@psf.upfronthosting.co.za>
Message-ID: <E1QADdH-0007gS-Qk@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset d0ada1e369cd by Ezio Melotti in branch '3.1':
#9101: backport json reference in configparser doc.
http://hg.python.org/cpython/rev/d0ada1e369cd

New changeset 5a09a335e8e7 by Ezio Melotti in branch '2.7':
#9101: backport json reference in configparser doc.
http://hg.python.org/cpython/rev/5a09a335e8e7

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

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

From report at bugs.python.org  Thu Apr 14 05:55:53 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 14 Apr 2011 03:55:53 +0000
Subject: [docs] [issue9101] reference json format in file formats chapter
In-Reply-To: <1277739443.04.0.607128047102.issue9101@psf.upfronthosting.co.za>
Message-ID: <1302753353.71.0.326526019133.issue9101@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Apr 14 06:52:12 2011
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 14 Apr 2011 04:52:12 +0000
Subject: [docs] [issue11840] Improvements to c-api/unicode documentation
In-Reply-To: <1302643172.01.0.948666081662.issue11840@psf.upfronthosting.co.za>
Message-ID: <E1QAEXL-0003ba-8u@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 11c72a305eb5 by Ezio Melotti in branch '3.1':
#11840: Improve c-api/unicode documentation. Patch by Sandro Tosi.
http://hg.python.org/cpython/rev/11c72a305eb5

New changeset 62679f2ca9e5 by Ezio Melotti in branch '3.2':
#11840: Merge with 3.1.
http://hg.python.org/cpython/rev/62679f2ca9e5

New changeset 1f767f834e67 by Ezio Melotti in branch 'default':
#11840: Merge with 3.2.
http://hg.python.org/cpython/rev/1f767f834e67

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

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

From report at bugs.python.org  Thu Apr 14 06:54:22 2011
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 14 Apr 2011 04:54:22 +0000
Subject: [docs] [issue11840] Improvements to c-api/unicode documentation
In-Reply-To: <1302643172.01.0.948666081662.issue11840@psf.upfronthosting.co.za>
Message-ID: <E1QAEZQ-0003f9-8S@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 7f873729484c by Ezio Melotti in branch '2.7':
#11840: Improve c-api/unicode documentation. Patch by Sandro Tosi.
http://hg.python.org/cpython/rev/7f873729484c

----------

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

From report at bugs.python.org  Thu Apr 14 07:02:16 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 14 Apr 2011 05:02:16 +0000
Subject: [docs] [issue11840] Improvements to c-api/unicode documentation
In-Reply-To: <1302643172.01.0.948666081662.issue11840@psf.upfronthosting.co.za>
Message-ID: <1302757336.07.0.798896772361.issue11840@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

Fixed, thanks for the patch!

About the rewrapping:
  * rewrapping what you change is OK, because I know that you changed something and had to rewrap it;
  * leaving what you changed badly-wrapped is not OK, because it makes the doc a mess after a while;
  * rewrapping unrelated things with no changes in the same patch is not OK, because it's hard to see if it's just rewrapping or changes+rewrapping;
  * doing rewrap-only changes might be OK but usually not worth it, and if done it should be done on all the branches.

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

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

From report at bugs.python.org  Thu Apr 14 07:05:00 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 14 Apr 2011 05:05:00 +0000
Subject: [docs] [issue11840] Improvements to c-api/unicode documentation
In-Reply-To: <1302643172.01.0.948666081662.issue11840@psf.upfronthosting.co.za>
Message-ID: <1302757500.55.0.479126449208.issue11840@psf.upfronthosting.co.za>


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


----------
assignee: docs at python -> ezio.melotti

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

From report at bugs.python.org  Thu Apr 14 08:55:07 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 14 Apr 2011 06:55:07 +0000
Subject: [docs] [issue11710] Landing pages in docs for standard library
	packages
In-Reply-To: <1301401907.02.0.216152132906.issue11710@psf.upfronthosting.co.za>
Message-ID: <1302764107.64.0.113685415154.issue11710@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

The packages without a landing page on 3.2 are:
  concurrent
  xml
  urllib
  http
  xmlrpc
  
In the concurrent case the problem could be solved with redirects too, since there's only one module in the package.  The other modules could provide a landing page that lists the modules in the package. (Note that the html page only lists html.escape, so the other modules could be added there too.)

----------

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

From report at bugs.python.org  Thu Apr 14 12:01:45 2011
From: report at bugs.python.org (anatoly techtonik)
Date: Thu, 14 Apr 2011 10:01:45 +0000
Subject: [docs] [issue9101] reference json format in file formats chapter
In-Reply-To: <1277739443.04.0.607128047102.issue9101@psf.upfronthosting.co.za>
Message-ID: <1302775305.28.0.415753499393.issue9101@psf.upfronthosting.co.za>


anatoly techtonik <techtonik at gmail.com> added the comment:

Wow. That's much better - python makes progress. Does this `robot` stuff flies back to Roundup? Is it possible to specify "closes bug #9101" directly in commit message?

----------

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

From report at bugs.python.org  Thu Apr 14 12:21:20 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 14 Apr 2011 10:21:20 +0000
Subject: [docs] [issue9101] reference json format in file formats chapter
In-Reply-To: <1277739443.04.0.607128047102.issue9101@psf.upfronthosting.co.za>
Message-ID: <1302776480.45.0.17823147764.issue9101@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

It's just a mercurial hook that sends email, and yes, it's possible to close the issues automatically writing "closes #xxxx" in the commit message, but I prefer to close the issue manually.

----------

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

From report at bugs.python.org  Thu Apr 14 12:57:56 2011
From: report at bugs.python.org (anatoly techtonik)
Date: Thu, 14 Apr 2011 10:57:56 +0000
Subject: [docs] [issue9101] reference json format in file formats chapter
In-Reply-To: <1277739443.04.0.607128047102.issue9101@psf.upfronthosting.co.za>
Message-ID: <1302778676.28.0.269963248451.issue9101@psf.upfronthosting.co.za>


anatoly techtonik <techtonik at gmail.com> added the comment:

Awesome. Especially links to actual changesets. BTW, there are only backport commits - where is the notification about the main one?

----------

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

From report at bugs.python.org  Thu Apr 14 12:59:31 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 14 Apr 2011 10:59:31 +0000
Subject: [docs] [issue9101] reference json format in file formats chapter
In-Reply-To: <1277739443.04.0.607128047102.issue9101@psf.upfronthosting.co.za>
Message-ID: <1302778770.94.0.844275329571.issue9101@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

In msg123296, r86976.

----------

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

From report at bugs.python.org  Thu Apr 14 13:53:58 2011
From: report at bugs.python.org (anatoly techtonik)
Date: Thu, 14 Apr 2011 11:53:58 +0000
Subject: [docs] [issue9101] reference json format in file formats chapter
In-Reply-To: <1277739443.04.0.607128047102.issue9101@psf.upfronthosting.co.za>
Message-ID: <1302782038.22.0.444621535534.issue9101@psf.upfronthosting.co.za>


anatoly techtonik <techtonik at gmail.com> added the comment:

Thanks.

----------

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

From report at bugs.python.org  Thu Apr 14 14:05:32 2011
From: report at bugs.python.org (Steven Samuel Cole)
Date: Thu, 14 Apr 2011 12:05:32 +0000
Subject: [docs] [issue11843] distutils doc: duplicate line in table
In-Reply-To: <1302782732.33.0.79290372609.issue11843@psf.upfronthosting.co.za>
Message-ID: <1302782732.33.0.79290372609.issue11843@psf.upfronthosting.co.za>


New submission from Steven Samuel Cole <steven.samuel.cole at gmail.com>:

in the first table on http://docs.python.org/distutils/builtdist.html (search for 'available formats for built distributions'), the line with 'rpm / RPM / (5)' is in there twice

----------
assignee: docs at python
components: Documentation
messages: 133730
nosy: docs at python, ssc
priority: normal
severity: normal
status: open
title: distutils doc: duplicate line in table
versions: Python 2.6, Python 2.7, Python 3.1, Python 3.2, Python 3.3

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

From report at bugs.python.org  Thu Apr 14 14:42:08 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 14 Apr 2011 12:42:08 +0000
Subject: [docs] [issue11843] distutils doc: duplicate line in table
In-Reply-To: <1302782732.33.0.79290372609.issue11843@psf.upfronthosting.co.za>
Message-ID: <1302784928.1.0.104316787889.issue11843@psf.upfronthosting.co.za>


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


----------
components: +Distutils
nosy: +eric.araujo
versions:  -Python 2.6

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

From report at bugs.python.org  Thu Apr 14 15:22:05 2011
From: report at bugs.python.org (=?utf-8?q?Filip_Gruszczy=C5=84ski?=)
Date: Thu, 14 Apr 2011 13:22:05 +0000
Subject: [docs] [issue9544] xdrlib.Packer().pack_fstring throws a TypeError
	when	called with a str()
In-Reply-To: <1281333086.43.0.820305754452.issue9544@psf.upfronthosting.co.za>
Message-ID: <1302787325.6.0.499462852472.issue9544@psf.upfronthosting.co.za>


Filip Gruszczy?ski <gruszczy at gmail.com> added the comment:

I'll provide docs patch.

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

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

From report at bugs.python.org  Thu Apr 14 17:38:00 2011
From: report at bugs.python.org (Daniel Urban)
Date: Thu, 14 Apr 2011 15:38:00 +0000
Subject: [docs] [issue11842] slice.indices with negative step and default
	stop
In-Reply-To: <1302727853.06.0.703796407001.issue11842@psf.upfronthosting.co.za>
Message-ID: <1302795480.42.0.573313464152.issue11842@psf.upfronthosting.co.za>


Daniel Urban <urban.dani+py at gmail.com> added the comment:

I see. Thanks for the explanation. If indeed this is the expected behaviour (as it seems), then I suggest clarifying the documentation. I think it would be good to mention that the returned values are for range(), and not for creating another slice object.

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

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

From report at bugs.python.org  Thu Apr 14 19:49:36 2011
From: report at bugs.python.org (Daniel Stutzbach)
Date: Thu, 14 Apr 2011 17:49:36 +0000
Subject: [docs] [issue6634] sys.exit() called from threads other than the
	main one:	undocumented behaviour
In-Reply-To: <1249327311.32.0.926815032903.issue6634@psf.upfronthosting.co.za>
Message-ID: <1302803376.06.0.394841239757.issue6634@psf.upfronthosting.co.za>


Changes by Daniel Stutzbach <stutzbach at google.com>:


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

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

From report at bugs.python.org  Thu Apr 14 21:11:56 2011
From: report at bugs.python.org (=?utf-8?q?Bo=C5=A1tjan_Mejak?=)
Date: Thu, 14 Apr 2011 19:11:56 +0000
Subject: [docs] [issue11806] Missing 2 hyphens in the docs
In-Reply-To: <BANLkTi=4W4qCiQNGL5CoCzm1PzkTSJ1Uzg@mail.gmail.com>
Message-ID: <BANLkTi=W7=PtvL2L_hYZ8gtewH+vu0oRfw@mail.gmail.com>


Bo??tjan Mejak <bostjan.mejak at gmail.com> added the comment:

I did a little mistake with the "coffee-table" thing. It's written as
"coffee table" (no hyphen). But other words listed are written with the
hyphen. Fix those damn things mentioned in the issue.

----------
Added file: http://bugs.python.org/file21664/unnamed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue11806>
_______________________________________
-------------- next part --------------
I did a little mistake with the &quot;coffee-table&quot; thing. It&#39;s written as &quot;coffee table&quot; (no hyphen). But other words listed are written with the hyphen. Fix those damn things mentioned in the issue.

From report at bugs.python.org  Fri Apr 15 00:54:21 2011
From: report at bugs.python.org (Senthil Kumaran)
Date: Thu, 14 Apr 2011 22:54:21 +0000
Subject: [docs] [issue11710] Landing pages in docs for standard library
	packages
In-Reply-To: <1301401907.02.0.216152132906.issue11710@psf.upfronthosting.co.za>
Message-ID: <1302821661.1.0.526010617735.issue11710@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Apr 15 01:41:43 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Thu, 14 Apr 2011 23:41:43 +0000
Subject: [docs] [issue11710] Landing pages in docs for standard library
	packages
In-Reply-To: <1301401907.02.0.216152132906.issue11710@psf.upfronthosting.co.za>
Message-ID: <1302824503.54.0.417766134761.issue11710@psf.upfronthosting.co.za>


Changes by Raymond Hettinger <raymond.hettinger at gmail.com>:


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

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

From report at bugs.python.org  Fri Apr 15 06:29:43 2011
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 15 Apr 2011 04:29:43 +0000
Subject: [docs] [issue11827] mention of list2cmdline() in docs of
	subprocess.Popen
In-Reply-To: <1302511097.53.0.993242324349.issue11827@psf.upfronthosting.co.za>
Message-ID: <E1QAaf5-0006ed-UJ@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset e7a55e236b8b by Eli Bendersky in branch '3.1':
Issue #11827: remove mention of list2cmdline in the doc of subprocess
http://hg.python.org/cpython/rev/e7a55e236b8b

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

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

From report at bugs.python.org  Fri Apr 15 06:35:05 2011
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 15 Apr 2011 04:35:05 +0000
Subject: [docs] [issue11827] mention of list2cmdline() in docs of
	subprocess.Popen
In-Reply-To: <1302511097.53.0.993242324349.issue11827@psf.upfronthosting.co.za>
Message-ID: <E1QAakI-0007BY-9x@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset f38489a3394f by Eli Bendersky in branch '2.7':
Issue #11827: remove mention of list2cmdline in the doc of subprocess
http://hg.python.org/cpython/rev/f38489a3394f

----------

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

From report at bugs.python.org  Fri Apr 15 06:36:54 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Fri, 15 Apr 2011 04:36:54 +0000
Subject: [docs] [issue11827] mention of list2cmdline() in docs of
	subprocess.Popen
In-Reply-To: <1302511097.53.0.993242324349.issue11827@psf.upfronthosting.co.za>
Message-ID: <1302842214.35.0.0537415423253.issue11827@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Apr 15 06:38:15 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Fri, 15 Apr 2011 04:38:15 +0000
Subject: [docs] [issue11827] mention of list2cmdline() in docs of
	subprocess.Popen
In-Reply-To: <1302511097.53.0.993242324349.issue11827@psf.upfronthosting.co.za>
Message-ID: <1302842294.92.0.849808467007.issue11827@psf.upfronthosting.co.za>


Eli Bendersky <eliben at gmail.com> added the comment:

Patch committed to 3.3, 3.2, 3.1, 2.7

In case no objections arise, I will close this issue in a couple of days

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

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

From report at bugs.python.org  Fri Apr 15 06:40:57 2011
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 15 Apr 2011 04:40:57 +0000
Subject: [docs] =?utf-8?q?=5Bissue4783=5D_document_that_json=2Eload/dump_c?=
 =?utf-8?q?an=E2=80=99t_be_used_twice_on_the_same_stream?=
In-Reply-To: <1230657409.93.0.0443603821797.issue4783@psf.upfronthosting.co.za>
Message-ID: <E1QAapy-0007wz-VK@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 8dbf072556b9 by Ezio Melotti in branch '2.7':
#4783: document that is not possible to use json.dump twice on the same stream.
http://hg.python.org/cpython/rev/8dbf072556b9

New changeset 2ec08aa2c566 by Ezio Melotti in branch '3.1':
#4783: document that is not possible to use json.dump twice on the same stream.
http://hg.python.org/cpython/rev/2ec08aa2c566

New changeset 1e315794ac8c by Ezio Melotti in branch '3.2':
#4783: Merge with 3.1.
http://hg.python.org/cpython/rev/1e315794ac8c

New changeset 91881e304e13 by Ezio Melotti in branch 'default':
#4783: Merge with 3.2.
http://hg.python.org/cpython/rev/91881e304e13

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

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

From report at bugs.python.org  Fri Apr 15 06:41:56 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Fri, 15 Apr 2011 04:41:56 +0000
Subject: [docs] =?utf-8?q?=5Bissue4783=5D_document_that_json=2Eload/dump_c?=
 =?utf-8?q?an=E2=80=99t_be_used_twice_on_the_same_stream?=
In-Reply-To: <1230657409.93.0.0443603821797.issue4783@psf.upfronthosting.co.za>
Message-ID: <1302842516.7.0.638491288685.issue4783@psf.upfronthosting.co.za>


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


----------
assignee: bob.ippolito -> ezio.melotti
resolution:  -> fixed
stage: patch review -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Fri Apr 15 17:00:12 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 15 Apr 2011 15:00:12 +0000
Subject: [docs] [issue11843] distutils doc: duplicate line in table
In-Reply-To: <1302782732.33.0.79290372609.issue11843@psf.upfronthosting.co.za>
Message-ID: <1302879612.91.0.859005449081.issue11843@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

Thanks for the report; I?ll fix it when I get Internet access without port 22 blocked, or any committer interested in documentation can do it.

----------

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

From report at bugs.python.org  Fri Apr 15 17:08:27 2011
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 15 Apr 2011 15:08:27 +0000
Subject: [docs] [issue11843] distutils doc: duplicate line in table
In-Reply-To: <1302782732.33.0.79290372609.issue11843@psf.upfronthosting.co.za>
Message-ID: <E1QAkdF-0005E1-Nd@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 9e49f4d81f54 by Ezio Melotti in branch '2.7':
#11843: remove duplicate line from table in distutil doc.
http://hg.python.org/cpython/rev/9e49f4d81f54

New changeset 1d6e28df2fb7 by Ezio Melotti in branch '3.1':
#11843: remove duplicate line from table in distutil doc.
http://hg.python.org/cpython/rev/1d6e28df2fb7

New changeset 850a659d9e6f by Ezio Melotti in branch '3.2':
#11843: Merge with 3.1.
http://hg.python.org/cpython/rev/850a659d9e6f

New changeset bf1bf8fb5d55 by Ezio Melotti in branch 'default':
#11843: Merge with 3.2.
http://hg.python.org/cpython/rev/bf1bf8fb5d55

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

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

From report at bugs.python.org  Fri Apr 15 17:09:45 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Fri, 15 Apr 2011 15:09:45 +0000
Subject: [docs] [issue11843] distutils doc: duplicate line in table
In-Reply-To: <1302782732.33.0.79290372609.issue11843@psf.upfronthosting.co.za>
Message-ID: <1302880184.99.0.285156925959.issue11843@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

Done, thanks for the report.

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

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

From report at bugs.python.org  Fri Apr 15 17:27:05 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 15 Apr 2011 15:27:05 +0000
Subject: [docs] [issue11843] distutils doc: duplicate line in table
In-Reply-To: <1302782732.33.0.79290372609.issue11843@psf.upfronthosting.co.za>
Message-ID: <1302881225.34.0.0923863511906.issue11843@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

Thanks Ezio.

----------

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

From report at bugs.python.org  Fri Apr 15 18:28:40 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Fri, 15 Apr 2011 16:28:40 +0000
Subject: [docs] [issue10665] Expand unicodedata module documentation
In-Reply-To: <1291930276.17.0.60709403086.issue10665@psf.upfronthosting.co.za>
Message-ID: <1302884920.14.0.458657401187.issue10665@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

Alexander suggested on IRC to use the 'unicode' directive[0], but even if that works in the HTML (only outside code blocks), it still breaks the PDF.
Another alternative that might work is the 'raw' role[1].

[0]: http://docutils.sourceforge.net/docs/ref/rst/directives.html#unicode-character-codes
[1]: http://docutils.sourceforge.net/docs/ref/rst/roles.html#specialized-roles

----------
keywords: +needs review

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

From report at bugs.python.org  Fri Apr 15 19:02:22 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 15 Apr 2011 17:02:22 +0000
Subject: [docs] [issue11834] wrong module installation dir on Windows
In-Reply-To: <1302605256.31.0.234550103785.issue11834@psf.upfronthosting.co.za>
Message-ID: <1302886942.78.0.49067362376.issue11834@psf.upfronthosting.co.za>


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


----------
components: +Distutils, Distutils2
nosy: +alexis, eric.araujo
versions: +Python 3.1, Python 3.2, Python 3.3

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

From report at bugs.python.org  Fri Apr 15 19:09:23 2011
From: report at bugs.python.org (Alexander Belopolsky)
Date: Fri, 15 Apr 2011 17:09:23 +0000
Subject: [docs] [issue10665] Expand unicodedata module documentation
In-Reply-To: <1291930276.17.0.60709403086.issue10665@psf.upfronthosting.co.za>
Message-ID: <1302887363.22.0.438317319467.issue10665@psf.upfronthosting.co.za>


Alexander Belopolsky <belopolsky at users.sourceforge.net> added the comment:

> The "PDF generator" is PDFLaTeX, whose range of Unicode characters
> is very limited, so no, I can't fix it.

My search for pdflatex and unicode has quickly revealed this 4-year old howto:

http://tclab.kaist.ac.kr/ipe/pdftex_2.html

I'll experiment with some recent LaTeX distributions before making further effort to work around current unicode limitations.  For example, XeTeX appears to have good unicode support:

http://scripts.sil.org/cms/scripts/page.php?site_id=nrsi&id=xetex

----------

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

From report at bugs.python.org  Fri Apr 15 19:09:30 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 15 Apr 2011 17:09:30 +0000
Subject: [docs] [issue11776] types.MethodType() params and usage is not
	documented
In-Reply-To: <1302036805.33.0.506634428921.issue11776@psf.upfronthosting.co.za>
Message-ID: <1302887370.19.0.800663280583.issue11776@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Apr 15 19:10:34 2011
From: report at bugs.python.org (Marc-Andre Lemburg)
Date: Fri, 15 Apr 2011 17:10:34 +0000
Subject: [docs] [issue10665] Expand unicodedata module documentation
In-Reply-To: <1302884920.14.0.458657401187.issue10665@psf.upfronthosting.co.za>
Message-ID: <4DA87BFF.2070401@egenix.com>


Marc-Andre Lemburg <mal at egenix.com> added the comment:

Ezio Melotti wrote:
> 
> Ezio Melotti <ezio.melotti at gmail.com> added the comment:
> 
> Alexander suggested on IRC to use the 'unicode' directive[0], but even if that works in the HTML (only outside code blocks), it still breaks the PDF.
> Another alternative that might work is the 'raw' role[1].
> 
> [0]: http://docutils.sourceforge.net/docs/ref/rst/directives.html#unicode-character-codes
> [1]: http://docutils.sourceforge.net/docs/ref/rst/roles.html#specialized-roles

I don't think we should include Unicode code points as literals
in Python source code examples, for much the same reason we
don't want them in the stdlib source code.

Why don't you use the standard literal escapes for the examples
and annotate the code points with the code point names ?

----------

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

From report at bugs.python.org  Fri Apr 15 19:13:52 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 15 Apr 2011 17:13:52 +0000
Subject: [docs] [issue11186] pydoc: HTMLDoc.index() doesn't support PEP 383
In-Reply-To: <1297428909.69.0.247564466299.issue11186@psf.upfronthosting.co.za>
Message-ID: <1302887632.84.0.533161165711.issue11186@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

> It is really a bad idea to choose an *undecodable* name for a module.
> You will not be able to write its name using "import name" syntax.

Okay, makes sense that pydoc ignores those.  You speak about a user choosing to create such a filename though; is it possible to create such a name without knowing it?

> For the changelog, feel free to rephrase it.

I don?t currently have SSH access, so please do it.

----------

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

From report at bugs.python.org  Fri Apr 15 19:15:47 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Fri, 15 Apr 2011 17:15:47 +0000
Subject: [docs] [issue10665] Expand unicodedata module documentation
In-Reply-To: <1291930276.17.0.60709403086.issue10665@psf.upfronthosting.co.za>
Message-ID: <1302887747.85.0.115725716249.issue10665@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

One reason is that unicodedata.lookup actually returns a unicode char, so if we want to show a code snippet that uses unicodedata.lookup we either have to use a unicode literal or limit the chars in the examples to latin1 to make sure it works nice with the PDF generator.

Using escape sequences elsewhere might work, but in some examples it's better to use the actual chars IMHO (except that they don't work with the PDF).

----------

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

From report at bugs.python.org  Fri Apr 15 19:23:36 2011
From: report at bugs.python.org (Marc-Andre Lemburg)
Date: Fri, 15 Apr 2011 17:23:36 +0000
Subject: [docs] [issue10665] Expand unicodedata module documentation
In-Reply-To: <1302887747.85.0.115725716249.issue10665@psf.upfronthosting.co.za>
Message-ID: <4DA87F0D.1050800@egenix.com>


Marc-Andre Lemburg <mal at egenix.com> added the comment:

Ezio Melotti wrote:
> 
> Ezio Melotti <ezio.melotti at gmail.com> added the comment:
> 
> One reason is that unicodedata.lookup actually returns a unicode char, so if we want to show a code snippet that uses unicodedata.lookup we either have to use a unicode literal or limit the chars in the examples to latin1 to make sure it works nice with the PDF generator.

Why not wrap the calls with a repr() ?

> Using escape sequences elsewhere might work, but in some examples it's better to use the actual chars IMHO (except that they don't work with the PDF).

Sure, it'll look nicer, but it will also make comparing the examples
with the actual output users see on the screen error-prone (e.g. if
the fonts don't have the necessary glyphs).

Copy&paste will also often fail.

I think it's more useful to show examples that more or less always
work, than ones which display all available goodies.

----------

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

From report at bugs.python.org  Fri Apr 15 19:25:01 2011
From: report at bugs.python.org (Alexander Belopolsky)
Date: Fri, 15 Apr 2011 17:25:01 +0000
Subject: [docs] [issue10665] Expand unicodedata module documentation
In-Reply-To: <4DA87BFF.2070401@egenix.com>
Message-ID: <BANLkTik-+O1GWjE52Nh+MjK4TROSG772Mw@mail.gmail.com>


Alexander Belopolsky <belopolsky at users.sourceforge.net> added the comment:

On Fri, Apr 15, 2011 at 1:10 PM, Marc-Andre Lemburg
<report at bugs.python.org> wrote:
>..
> Why don't you use the standard literal escapes for the examples
> and annotate the code points with the code point names ?

A am neutral on how to enter unicode characters in source reST.   In
the previous discussions most people seemed to prefer WISIWYG.  If
literal escapes solved the PDF issue, I would use it even at the
expense of loosing testability of the output displays.

Code point names as usually very long for exotic characters that
illustrate UCD features.  I like presenting them, but in tables I'd
rather present more examples and still keep column width reasonable.

----------

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

From report at bugs.python.org  Fri Apr 15 19:38:40 2011
From: report at bugs.python.org (Alexander Belopolsky)
Date: Fri, 15 Apr 2011 17:38:40 +0000
Subject: [docs] [issue10665] Expand unicodedata module documentation
In-Reply-To: <4DA87F0D.1050800@egenix.com>
Message-ID: <BANLkTi=zzNYo3M2Sfi=eb+LNZkG_2bbDJw@mail.gmail.com>


Alexander Belopolsky <belopolsky at users.sourceforge.net> added the comment:

On Fri, Apr 15, 2011 at 1:23 PM, Marc-Andre Lemburg
<report at bugs.python.org> wrote:
>..
> Why not wrap the calls with a repr() ?
>

Won't help:

"'?'"

I think you meant ascii(), but that's ugly IMO:

"'\\u04dc'"

Maybe

'\u04dc'

but that's too much of scaffolding.

..
> I think it's more useful to show examples that more or less always
> work, than ones which display all available goodies.

I disagree.  Users that are advanced enough to be interested in
reading unicodedata reference documentation should be capable of
either fixing their environment or understanding its limitations.

----------

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

From report at bugs.python.org  Fri Apr 15 23:23:34 2011
From: report at bugs.python.org (Santoso Wijaya)
Date: Fri, 15 Apr 2011 21:23:34 +0000
Subject: [docs] [issue9650] format codes in time.strptime docstrings
In-Reply-To: <1282319380.5.0.724924373031.issue9650@psf.upfronthosting.co.za>
Message-ID: <1302902614.37.0.466186376456.issue9650@psf.upfronthosting.co.za>


Changes by Santoso Wijaya <santoso.wijaya at gmail.com>:


----------
assignee:  -> docs at python
components: +Documentation -Library (Lib)
versions: +Python 3.3 -Python 3.2

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

From report at bugs.python.org  Sat Apr 16 08:46:12 2011
From: report at bugs.python.org (Georg Brandl)
Date: Sat, 16 Apr 2011 06:46:12 +0000
Subject: [docs] [issue10665] Expand unicodedata module documentation
In-Reply-To: <1291930276.17.0.60709403086.issue10665@psf.upfronthosting.co.za>
Message-ID: <1302936372.2.0.795197497285.issue10665@psf.upfronthosting.co.za>


Georg Brandl <georg at python.org> added the comment:

Can y'all please accept the limitation to latin-1?  Like Marc-Andre says, the more "exotic" the examples, the less likely it is that users reading the HTML can display it anyway.

----------

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

From report at bugs.python.org  Sat Apr 16 13:46:52 2011
From: report at bugs.python.org (=?utf-8?q?Bo=C5=A1tjan_Mejak?=)
Date: Sat, 16 Apr 2011 11:46:52 +0000
Subject: [docs] [issue11806] Missing 2 hyphens in the docs
In-Reply-To: <1302338197.1.0.100311254016.issue11806@psf.upfronthosting.co.za>
Message-ID: <1302954412.26.0.820176273075.issue11806@psf.upfronthosting.co.za>


Changes by Bo?tjan Mejak <bostjan.mejak at gmail.com>:


Removed file: http://bugs.python.org/file21638/unnamed

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

From report at bugs.python.org  Sat Apr 16 13:46:55 2011
From: report at bugs.python.org (=?utf-8?q?Bo=C5=A1tjan_Mejak?=)
Date: Sat, 16 Apr 2011 11:46:55 +0000
Subject: [docs] [issue11806] Missing 2 hyphens in the docs
In-Reply-To: <1302338197.1.0.100311254016.issue11806@psf.upfronthosting.co.za>
Message-ID: <1302954415.79.0.601759656864.issue11806@psf.upfronthosting.co.za>


Changes by Bo?tjan Mejak <bostjan.mejak at gmail.com>:


Removed file: http://bugs.python.org/file21643/unnamed

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

From report at bugs.python.org  Sat Apr 16 13:46:58 2011
From: report at bugs.python.org (=?utf-8?q?Bo=C5=A1tjan_Mejak?=)
Date: Sat, 16 Apr 2011 11:46:58 +0000
Subject: [docs] [issue11806] Missing 2 hyphens in the docs
In-Reply-To: <1302338197.1.0.100311254016.issue11806@psf.upfronthosting.co.za>
Message-ID: <1302954418.6.0.0812916823903.issue11806@psf.upfronthosting.co.za>


Changes by Bo?tjan Mejak <bostjan.mejak at gmail.com>:


Removed file: http://bugs.python.org/file21648/unnamed

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

From report at bugs.python.org  Sat Apr 16 13:47:01 2011
From: report at bugs.python.org (=?utf-8?q?Bo=C5=A1tjan_Mejak?=)
Date: Sat, 16 Apr 2011 11:47:01 +0000
Subject: [docs] [issue11806] Missing 2 hyphens in the docs
In-Reply-To: <1302338197.1.0.100311254016.issue11806@psf.upfronthosting.co.za>
Message-ID: <1302954421.42.0.000608571971482.issue11806@psf.upfronthosting.co.za>


Changes by Bo?tjan Mejak <bostjan.mejak at gmail.com>:


Removed file: http://bugs.python.org/file21654/unnamed

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

From report at bugs.python.org  Sat Apr 16 13:47:03 2011
From: report at bugs.python.org (=?utf-8?q?Bo=C5=A1tjan_Mejak?=)
Date: Sat, 16 Apr 2011 11:47:03 +0000
Subject: [docs] [issue11806] Missing 2 hyphens in the docs
In-Reply-To: <1302338197.1.0.100311254016.issue11806@psf.upfronthosting.co.za>
Message-ID: <1302954423.89.0.6796304864.issue11806@psf.upfronthosting.co.za>


Changes by Bo?tjan Mejak <bostjan.mejak at gmail.com>:


Removed file: http://bugs.python.org/file21664/unnamed

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

From report at bugs.python.org  Sat Apr 16 13:54:05 2011
From: report at bugs.python.org (=?utf-8?q?Bo=C5=A1tjan_Mejak?=)
Date: Sat, 16 Apr 2011 11:54:05 +0000
Subject: [docs] [issue11855] urlretrieve --> urlretrieve()
In-Reply-To: <1302954844.99.0.142574002037.issue11855@psf.upfronthosting.co.za>
Message-ID: <1302954844.99.0.142574002037.issue11855@psf.upfronthosting.co.za>


New submission from Bo?tjan Mejak <bostjan.mejak at gmail.com>:

A typo in the docs was found here: http://docs.python.org/library/urllib.html#urllib.urlretrieve

Two instances of the word "urlretrieve" need to be "urlretrieve()", as other instances of it are, with that fancy color and a link-like look. You know what I mean. If you care, please fix this.

----------
assignee: docs at python
components: Documentation
messages: 133887
nosy: Retro, docs at python
priority: normal
severity: normal
status: open
title: urlretrieve --> urlretrieve()
versions: Python 2.7, Python 3.1, Python 3.2, Python 3.3, Python 3.4

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

From report at bugs.python.org  Sat Apr 16 14:05:53 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Sat, 16 Apr 2011 12:05:53 +0000
Subject: [docs] [issue11855] urlretrieve --> urlretrieve()
In-Reply-To: <1302954844.99.0.142574002037.issue11855@psf.upfronthosting.co.za>
Message-ID: <1302955553.19.0.656612116792.issue11855@psf.upfronthosting.co.za>


Eli Bendersky <eliben at gmail.com> added the comment:

Agreed. Will fix

----------
keywords: +easy
nosy: +eli.bendersky
priority: normal -> low
resolution:  -> accepted
versions:  -Python 3.4

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

From report at bugs.python.org  Sat Apr 16 14:10:56 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 16 Apr 2011 12:10:56 +0000
Subject: [docs] [issue11855] urlretrieve --> urlretrieve()
In-Reply-To: <1302954844.99.0.142574002037.issue11855@psf.upfronthosting.co.za>
Message-ID: <E1QB4L0-0002FM-7b@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset d3e0bc155ca2 by Eli Bendersky in branch '2.7':
Issue #11855: Apply missing formatting for urlretrieve
http://hg.python.org/cpython/rev/d3e0bc155ca2

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

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

From report at bugs.python.org  Sat Apr 16 14:18:22 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 16 Apr 2011 12:18:22 +0000
Subject: [docs] [issue11855] urlretrieve --> urlretrieve()
In-Reply-To: <1302954844.99.0.142574002037.issue11855@psf.upfronthosting.co.za>
Message-ID: <E1QB4SC-0002hk-7G@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset a6d9f9329070 by Eli Bendersky in branch '3.1':
Issue #11855: Apply missing formatting for urlretrieve
http://hg.python.org/cpython/rev/a6d9f9329070

New changeset 0f1199858714 by Eli Bendersky in branch '3.2':
Issue #11855: merge from 3.1
http://hg.python.org/cpython/rev/0f1199858714

New changeset c49c595e4214 by Eli Bendersky in branch 'default':
Issue #11855: merge from 3.2
http://hg.python.org/cpython/rev/c49c595e4214

----------

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

From report at bugs.python.org  Sat Apr 16 14:19:50 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Sat, 16 Apr 2011 12:19:50 +0000
Subject: [docs] [issue11855] urlretrieve --> urlretrieve()
In-Reply-To: <1302954844.99.0.142574002037.issue11855@psf.upfronthosting.co.za>
Message-ID: <1302956390.82.0.625973473812.issue11855@psf.upfronthosting.co.za>


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


----------
resolution: accepted -> fixed
status: open -> pending

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

From report at bugs.python.org  Sat Apr 16 17:33:27 2011
From: report at bugs.python.org (=?utf-8?q?Bo=C5=A1tjan_Mejak?=)
Date: Sat, 16 Apr 2011 15:33:27 +0000
Subject: [docs] [issue11857] Hyphenate the argparse.rst file, patch added
In-Reply-To: <1302968007.13.0.0484662149603.issue11857@psf.upfronthosting.co.za>
Message-ID: <1302968007.13.0.0484662149603.issue11857@psf.upfronthosting.co.za>


New submission from Bo?tjan Mejak <bostjan.mejak at gmail.com>:

Please apply this patch. And fix the occurences where you think the word "command line" acts as a noun.

----------
assignee: docs at python
components: Documentation
files: argparse.patch
keywords: patch
messages: 133893
nosy: Retro, docs at python, georg.brandl
priority: normal
severity: normal
status: open
title: Hyphenate the argparse.rst file, patch added
versions: Python 3.2, Python 3.3, Python 3.4
Added file: http://bugs.python.org/file21682/argparse.patch

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

From report at bugs.python.org  Sat Apr 16 18:17:27 2011
From: report at bugs.python.org (=?utf-8?q?Westley_Mart=C3=ADnez?=)
Date: Sat, 16 Apr 2011 16:17:27 +0000
Subject: [docs] [issue11155] multiprocessing.Queue's put() signature differs
	from docs
In-Reply-To: <1297211747.04.0.707896670759.issue11155@psf.upfronthosting.co.za>
Message-ID: <1302970647.16.0.592545971092.issue11155@psf.upfronthosting.co.za>


Westley Mart?nez <anikom15 at gmail.com> added the comment:

Can this patch be commited?

----------

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

From report at bugs.python.org  Sat Apr 16 21:16:55 2011
From: report at bugs.python.org (=?utf-8?q?Bo=C5=A1tjan_Mejak?=)
Date: Sat, 16 Apr 2011 19:16:55 +0000
Subject: [docs] [issue11857] Hyphenate the argparse.rst file, patch added
In-Reply-To: <1302968007.13.0.0484662149603.issue11857@psf.upfronthosting.co.za>
Message-ID: <1302981415.63.0.135903319383.issue11857@psf.upfronthosting.co.za>


Changes by Bo?tjan Mejak <bostjan.mejak at gmail.com>:


Removed file: http://bugs.python.org/file21682/argparse.patch

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

From report at bugs.python.org  Sat Apr 16 21:44:24 2011
From: report at bugs.python.org (=?utf-8?q?Bo=C5=A1tjan_Mejak?=)
Date: Sat, 16 Apr 2011 19:44:24 +0000
Subject: [docs] [issue11857] Hyphenate the argparse.rst file, patch added
In-Reply-To: <1302968007.13.0.0484662149603.issue11857@psf.upfronthosting.co.za>
Message-ID: <1302983064.88.0.579069389658.issue11857@psf.upfronthosting.co.za>


Bo?tjan Mejak <bostjan.mejak at gmail.com> added the comment:

Added the new and improved patch. Now it is perfect. Please apply it.

----------
Added file: http://bugs.python.org/file21687/argparse.patch

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

From report at bugs.python.org  Sat Apr 16 22:16:06 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Sat, 16 Apr 2011 20:16:06 +0000
Subject: [docs] [issue11857] Hyphenate the argparse.rst file, patch added
In-Reply-To: <1302968007.13.0.0484662149603.issue11857@psf.upfronthosting.co.za>
Message-ID: <1302984966.68.0.668709365935.issue11857@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

Done in cc65cf9a9ce5, c33596e6f723, and fcce2f49ef6d. Thanks for the patch.

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

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

From report at bugs.python.org  Sat Apr 16 22:17:10 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Sat, 16 Apr 2011 20:17:10 +0000
Subject: [docs] [issue11855] urlretrieve --> urlretrieve()
In-Reply-To: <1302954844.99.0.142574002037.issue11855@psf.upfronthosting.co.za>
Message-ID: <1302985030.03.0.887836196295.issue11855@psf.upfronthosting.co.za>


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


----------
stage:  -> committed/rejected
status: pending -> closed

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

From report at bugs.python.org  Sun Apr 17 03:53:24 2011
From: report at bugs.python.org (Mike Kamermans)
Date: Sun, 17 Apr 2011 01:53:24 +0000
Subject: [docs] [issue11860] reference 2.3 has text that runs past the page
In-Reply-To: <1303005204.18.0.459182918365.issue11860@psf.upfronthosting.co.za>
Message-ID: <1303005204.18.0.459182918365.issue11860@psf.upfronthosting.co.za>


New submission from Mike Kamermans <nihongo at gmail.com>:

page 8 for the python 3.2 refernce document ("identifiers and keywords") has text that runs way past the page. This document (and probably every other document) should be run through LaTeX again with draft, to find all instances where text doesn't fit on the page, so that this can be fixed.

----------
assignee: docs at python
components: Documentation
messages: 133916
nosy: Mike.Kamermans, docs at python
priority: normal
severity: normal
status: open
title: reference 2.3 has text that runs past the page
type: feature request
versions: Python 3.2

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

From report at bugs.python.org  Sun Apr 17 13:20:25 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Sun, 17 Apr 2011 11:20:25 +0000
Subject: [docs] [issue11860] reference 2.3 has text that runs past the page
In-Reply-To: <1303005204.18.0.459182918365.issue11860@psf.upfronthosting.co.za>
Message-ID: <1303039225.21.0.781539447557.issue11860@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Mon Apr 18 05:40:45 2011
From: report at bugs.python.org (ysj.ray)
Date: Mon, 18 Apr 2011 03:40:45 +0000
Subject: [docs] [issue11785] email subpackages documentation problems
In-Reply-To: <1302105466.45.0.930997240631.issue11785@psf.upfronthosting.co.za>
Message-ID: <1303098045.35.0.505041501436.issue11785@psf.upfronthosting.co.za>


ysj.ray <ysj.ray at gmail.com> added the comment:

Oh, sorry, I didn't differ :mod:, :module:, :currentmodule: clearly.

But shouldn't the modules link titles in http://docs.python.org/dev/library/email.html display correct module names instead just the "email" package name?
"""email: Representing character sets""" seems a little wearied.

----------

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

From report at bugs.python.org  Mon Apr 18 08:51:14 2011
From: report at bugs.python.org (Zhiping Deng)
Date: Mon, 18 Apr 2011 06:51:14 +0000
Subject: [docs] [issue11865] typo in Py_AddPendingCall document
In-Reply-To: <1303109474.81.0.645690585196.issue11865@psf.upfronthosting.co.za>
Message-ID: <1303109474.81.0.645690585196.issue11865@psf.upfronthosting.co.za>


New submission from Zhiping Deng <kofreestyler at gmail.com>:

http://docs.python.org/c-api/init.html?highlight=py_addpendingcall#Py_AddPendingCall

void Py_AddPendingCall(int (*func)(void *, void *arg))
which should be 
void Py_AddPendingCall(int (*func)(void *), void *arg)

----------
assignee: docs at python
components: Documentation
messages: 133953
nosy: Zhiping.Deng, docs at python
priority: normal
severity: normal
status: open
title: typo in Py_AddPendingCall document
versions: Python 2.7

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

From report at bugs.python.org  Mon Apr 18 09:15:12 2011
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 18 Apr 2011 07:15:12 +0000
Subject: [docs] [issue11865] typo in Py_AddPendingCall document
In-Reply-To: <1303109474.81.0.645690585196.issue11865@psf.upfronthosting.co.za>
Message-ID: <E1QBifu-0000Ng-CC@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset fc2def15ab11 by Ezio Melotti in branch '2.7':
#11865: fix typo in init.rst.
http://hg.python.org/cpython/rev/fc2def15ab11

New changeset 6e090d78857c by Ezio Melotti in branch '3.1':
#11865: fix typo in init.rst.
http://hg.python.org/cpython/rev/6e090d78857c

New changeset ce804653c752 by Ezio Melotti in branch '3.2':
#11865: Merge with 3.1.
http://hg.python.org/cpython/rev/ce804653c752

New changeset d8dd02f6db1a by Ezio Melotti in branch 'default':
#11865: Merge with 3.2.
http://hg.python.org/cpython/rev/d8dd02f6db1a

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

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

From report at bugs.python.org  Mon Apr 18 09:16:12 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Mon, 18 Apr 2011 07:16:12 +0000
Subject: [docs] [issue11865] typo in Py_AddPendingCall document
In-Reply-To: <1303109474.81.0.645690585196.issue11865@psf.upfronthosting.co.za>
Message-ID: <1303110972.88.0.882210124933.issue11865@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

Fixed, thanks for the report!

----------
assignee: docs at python -> ezio.melotti
nosy: +ezio.melotti
resolution:  -> fixed
stage:  -> committed/rejected
status: open -> closed
versions: +Python 3.1, Python 3.2, Python 3.3

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

From report at bugs.python.org  Mon Apr 18 18:21:29 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 18 Apr 2011 16:21:29 +0000
Subject: [docs] [issue11785] email subpackages documentation problems
In-Reply-To: <1302105466.45.0.930997240631.issue11785@psf.upfronthosting.co.za>
Message-ID: <1303143689.4.0.097041435327.issue11785@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

Sure, +1 on using the submodule name in the module or currentmodule directive.

----------

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

From report at bugs.python.org  Tue Apr 19 13:29:41 2011
From: report at bugs.python.org (Steffen Daode Nurpmeso)
Date: Tue, 19 Apr 2011 11:29:41 +0000
Subject: [docs] [issue11300] mmap() large file failures on Mac OS X docfix
In-Reply-To: <1298493292.2.0.2203680343.issue11300@psf.upfronthosting.co.za>
Message-ID: <1303212581.21.0.811638968381.issue11300@psf.upfronthosting.co.za>


Steffen Daode Nurpmeso <sdaoden at googlemail.com> added the comment:

Outdated due to found #11277 solution.

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

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

From report at bugs.python.org  Tue Apr 19 17:31:49 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Tue, 19 Apr 2011 15:31:49 +0000
Subject: [docs] [issue8982] argparse docs cross reference Namespace as a
	class but	the Namespace class is not documented
In-Reply-To: <1276350269.78.0.816004374409.issue8982@psf.upfronthosting.co.za>
Message-ID: <1303227109.21.0.185633304096.issue8982@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

Attached patch adds a link target for :class:`Namespace` (already used in the docs) and adds a reference to it from for the first mentions of ?namespace object?.

Use ?hg import blah.diff? (after ?hg up 3.2?) to get the patch in the repo directly (with checkin message and my committer name) or usual patch(1) if you want to make amendments.

----------
keywords: +patch
Added file: http://bugs.python.org/file21723/fix-argparse-class-directive.diff

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

From sandro.tosi at gmail.com  Tue Apr 19 20:53:43 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Tue, 19 Apr 2011 20:53:43 +0200
Subject: [docs] green bugs and spam
In-Reply-To: <4DA5F7FF.1000406@underhill.ca>
References: <4DA5F7FF.1000406@underhill.ca>
Message-ID: <BANLkTin4vmkxuGUSxQ7=QzeYN0jnxycQhA@mail.gmail.com>

Hi Martin,
thanks for your report.

On Wed, Apr 13, 2011 at 21:22, Martin Feuchtwanger <martinf at underhill.ca> wrote:
> Buglet:
>
> In
> http://docs.python.org/py3k/tutorial/classes.html#scopes-and-namespaces-example
> the "nonlocal" statement? should be green.
>
>     <span class="k">def</span> <span class="nf">do_nonlocal</span><span
> class="p">():</span>
>         <span class="n">nonlocal</span> <span class="n">spam</span>
>         <span class="n">spam</span> <span class="o">=</span> <span
> class="s">&quot;nonlocal spam&quot;</span>
>
> That is, it should be in the "k" class
>
>     <span class="k">def</span> <span class="nf">do_nonlocal</span><span
> class="p">():</span>
>         <span class="k">nonlocal</span> <span class="n">spam</span>
>         <span class="n">spam</span> <span class="o">=</span> <span
> class="s">&quot;nonlocal spam&quot;</span>

This is a problem in pygments (used to syntax highlight code in the
examples) that doesn't recognize 'nonlocal': Georg, hi! :) I saw [1]:
since it's used to build documentation for python 3.x, do you think
you can reconsider your evaluation of the bug and add support for it?

[1] https://bitbucket.org/birkenfeld/pygments-main/issue/610/nonlocal-keyword-not-recognized-python

Regards,
-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

From sandro.tosi at gmail.com  Tue Apr 19 21:28:09 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Tue, 19 Apr 2011 21:28:09 +0200
Subject: [docs] bug about syntax of "if-else" statement in the IDLE shell
In-Reply-To: <285600.91091.qm@web43515.mail.sp1.yahoo.com>
References: <285600.91091.qm@web43515.mail.sp1.yahoo.com>
Message-ID: <BANLkTikXSA5_Zkyn1uBX1fb0tFS5bU091w@mail.gmail.com>

Hi Victor,

On Mon, Mar 7, 2011 at 03:19, Victor Paraschiv <victorywin5 at yahoo.com> wrote:
> So, it requires me to put "else" unindented. On the other hand, if the "if--else" statement is included in the definition of a function, then it requires that "else" be exactly under "if".
> This was frustrating, when trying to learn "if-else" statement, because it took me half an hour of experimenting, before I figurred out.
> Shouldn't it be consistent?
> Could you please reply me with an explanation, in case I am wrong?

I can try to explain what I think it's happening: python interpreter
shell makes a consistent use of a prompt (either '>>> ' or '... ')
that makes commands indented by default by 4 chars. IDLE just presents
the '>>> ' for the first commands, and multiline instructions has to
be at the same level of indentation, and so the 'else' has to be at
the beginning of the line, since 'if' has no indentation.

Regards,
--
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

From sandro.tosi at gmail.com  Tue Apr 19 21:31:38 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Tue, 19 Apr 2011 21:31:38 +0200
Subject: [docs] Please provide Python 2.5.5 documentation
In-Reply-To: <AANLkTinXT=RuZ1iShFxDLTwxkBRQoZbBbcw7UY33CRuE@mail.gmail.com>
References: <AANLkTinXT=RuZ1iShFxDLTwxkBRQoZbBbcw7UY33CRuE@mail.gmail.com>
Message-ID: <BANLkTin8VCT1u=f13rgXgvx2NTuwRuYOTQ@mail.gmail.com>

Hi Georg,

On Mon, Mar 7, 2011 at 23:21, Ulrik Sverdrup <ulrik.sverdrup at gmail.com> wrote:
> Hi,
>
> My Python2.5 installation (among the various versions installed)
> provides this link for documentation:
>
> FILE
> ? ?/usr/lib/python2.5/socket.py
>
> MODULE DOCS
> ? ?http://www.python.org/doc/2.5.5/lib/module-socket.html
>
>
> The above link is not active, there is no documentation for 2.5.5.
> Please understand that I'm looking for the documentation for 2.5. I
> also know that 2.5.4 docs are available and I will go there to read
> them now, but isn't it nice if the URLs in the latest version of 2.5
> work?

This is the second request (that I know of) on this list to provide
2.5.5 documentation on docs.python.org: what do you think about
building it, or adding a compatibiliy symlink (between 2.5.4 and
2.5.5)? the second could be a bit misleading for the users (looking
for 2.5.5 doc and getting 2.5.4 instead).

Thanks in advance,
-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

From sandro.tosi at gmail.com  Tue Apr 19 21:35:24 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Tue, 19 Apr 2011 21:35:24 +0200
Subject: [docs] documentation error/bug 7.1. Fancier Output Formatting
In-Reply-To: <AANLkTikj43=k7MK9LN7HD=TMUVtfLgeMFYK=fYsYRL6_@mail.gmail.com>
References: <AANLkTikj43=k7MK9LN7HD=TMUVtfLgeMFYK=fYsYRL6_@mail.gmail.com>
Message-ID: <BANLkTikAyY==MekErSvgduK=4Xo_D0D+xg@mail.gmail.com>

Hi Don,

On Mon, Mar 7, 2011 at 03:18, Dan Orton <d.orton5963 at gmail.com> wrote:
> hello,
> I think I may have found a bug in the documentation under?7.1. Fancier
> Output Formatting

http://docs.python.org/tutorial/inputoutput.html#fancier-output-formatting

> as I am a beginner, I really do not have many ideas on how to fix it.
> also as this is a simpleton error, there may already be discussion on a fix.
> 1)?You will see the following code.
>
>>>> import math
>>>> print 'The value of PI is approximately {}.'.format(math.pi)
> The value of PI is approximately 3.14159265359.
>>>> print 'The value of PI is approximately {!r}.'.format(math.pi)
> The value of PI is approximately 3.141592653589793.
>
> 2)
> When entered into Python, it complains
> Python 2.6.6 (r266:84292, Sep 15 2010, 15:52:39)

you're reading documentation for 2.7 and running the example on 2.6 .
format() has changed between those 2 versions:

$ python
Python 2.6.6 (r266:84292, Dec 26 2010, 22:31:48)
[GCC 4.4.5] on linux2
Type "help", "copyright", "credits" or "license" for more information.
>>> import math
>>> print 'The value of PI is approximately {0}.'.format(math.pi)
The value of PI is approximately 3.14159265359.

for 2.6 you have to number explicitly the fields, while in 2.7 onward
you don't need to (it will take the order in which they are passed).

Regards,
-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

From sandro.tosi at gmail.com  Tue Apr 19 21:48:27 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Tue, 19 Apr 2011 21:48:27 +0200
Subject: [docs] suggestion for
	http://docs.python.org/library/unittest.html#unittest.TestCase.assertRaises
In-Reply-To: <AANLkTi=UU5PfbKmuCiMWnsme-0qW169mcCkdFjpv4z=q@mail.gmail.com>
References: <AANLkTi=UU5PfbKmuCiMWnsme-0qW169mcCkdFjpv4z=q@mail.gmail.com>
Message-ID: <BANLkTikuNTxGm4eZv_UhGXcNpBnFeLSYcg@mail.gmail.com>

Hi Andrew,

On Wed, Mar 9, 2011 at 21:52, Andrew Hammond
<andrew.george.hammond at gmail.com> wrote:
> I suggest adding an example of using assertRaises to test a property:
>
> class MyObject(object):
> ? ?@property
> ? ?def myProperty():
> ? ? ? ?raise Exception()
>
> self.assertRaises(Exception, getattr, myObject, myProperty)
>
> Rationale: the naive approach doesn't work and I spent a good half
> hour figuring that out.

can you confirm you want something like:

class MyObject(object):
   @property
   def myProperty(self):
       raise Exception()

...
myObject = MyObject()
self.assertRaises(Exception, getattr, myObject, 'myProperty')

?

f.e:
>>> getattr(myObject, 'myProperty')
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
  File "<stdin>", line 4, in myProperty
Exception

Else I can't get it to work.

Regards,
-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

From sandro.tosi at gmail.com  Tue Apr 19 22:25:55 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Tue, 19 Apr 2011 22:25:55 +0200
Subject: [docs] Very small bug in python doc
In-Reply-To: <AANLkTi=p+KsR1h-+Ot843=K71sewALVbt58zOrXFCkuS@mail.gmail.com>
References: <AANLkTi=p+KsR1h-+Ot843=K71sewALVbt58zOrXFCkuS@mail.gmail.com>
Message-ID: <BANLkTimUjC3OA2faNpX4b__2wAuX6OCrNA@mail.gmail.com>

Hi Hiroshi,

On Wed, Mar 23, 2011 at 08:10, Hiroshi Araki <hilocark at gmail.com> wrote:
> At the first line in the section below
> http://docs.python.org/library/subprocess.html#convenience-functions
>
>> This module also defines two shortcut functions:
> But I can see three functions there, so this must be:
>
>> This module also defines three shortcut functions:

This has now been fixed: thanks!

Regards,
-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

From report at bugs.python.org  Tue Apr 19 22:59:23 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Tue, 19 Apr 2011 20:59:23 +0000
Subject: [docs] [issue11883] Call connect() before sending an email with
	smtplib
In-Reply-To: <1303246763.2.0.10135500331.issue11883@psf.upfronthosting.co.za>
Message-ID: <1303246763.2.0.10135500331.issue11883@psf.upfronthosting.co.za>


New submission from Sandro Tosi <sandro.tosi at gmail.com>:

Hi, following up http://mail.python.org/pipermail/docs/2011-April/003742.html here are a couple of patches to call connect() after smtplib.SMTP() and sendmail(). Patches are:

2.7: to be applied in 2.7 and merged into 3.1
3.2: to be applied in 3.2 and merged into default

That's because in 3.2 we have a change in the example to use send_message() instead of sendmail() (in order to allow binary contents), and so there's also a small fix to actually make use of send_message() email-simple.

----------
assignee: docs at python
components: Documentation
files: smtp_connect-2.7.patch
keywords: patch
messages: 134100
nosy: docs at python, r.david.murray, sandro.tosi
priority: normal
severity: normal
stage: patch review
status: open
title: Call connect() before sending an email with smtplib
Added file: http://bugs.python.org/file21731/smtp_connect-2.7.patch

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

From report at bugs.python.org  Tue Apr 19 23:00:43 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Tue, 19 Apr 2011 21:00:43 +0000
Subject: [docs] [issue11883] Call connect() before sending an email with
	smtplib
In-Reply-To: <1303246763.2.0.10135500331.issue11883@psf.upfronthosting.co.za>
Message-ID: <1303246843.15.0.69134077047.issue11883@psf.upfronthosting.co.za>


Changes by Sandro Tosi <sandro.tosi at gmail.com>:


Added file: http://bugs.python.org/file21732/smtp_connect-3.2.patch

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

From sandro.tosi at gmail.com  Tue Apr 19 23:00:35 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Tue, 19 Apr 2011 23:00:35 +0200
Subject: [docs] documentation error
In-Reply-To: <20110401004252.GI7819@subtlepath.org>
References: <20110401004252.GI7819@subtlepath.org>
Message-ID: <BANLkTinx+gGOvjR6AqGNxF33zL-eTaAKFg@mail.gmail.com>

Hi Nick,

On Fri, Apr 1, 2011 at 02:42, Nick Walker <nick at subtlepath.org> wrote:
> page: http://docs.python.org/library/email-examples.html
>
> In the first code sample:
>
> s = smtplib.SMTP()
> s.sendmail(me, [you], msg.as_string())
> s.quit()
>
> s.connect() is required before s.sendmail()

This issue has been opened to fix this: http://bugs.python.org/issue11883

Thanks!

-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

From report at bugs.python.org  Wed Apr 20 13:59:20 2011
From: report at bugs.python.org (=?utf-8?q?Bo=C5=A1tjan_Mejak?=)
Date: Wed, 20 Apr 2011 11:59:20 +0000
Subject: [docs] [issue11885] argparse docs needs fixing
In-Reply-To: <1303300720.91.0.791889164093.issue11885@psf.upfronthosting.co.za>
Message-ID: <1303300760.35.0.805554846015.issue11885@psf.upfronthosting.co.za>


Changes by Bo?tjan Mejak <bostjan.mejak at gmail.com>:


----------
assignee:  -> docs at python
components: +Documentation
nosy: +docs at python
versions: +Python 2.7, Python 3.2, Python 3.3, Python 3.4

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

From report at bugs.python.org  Wed Apr 20 14:00:17 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Wed, 20 Apr 2011 12:00:17 +0000
Subject: [docs] [issue11885] argparse docs needs fixing
In-Reply-To: <1303300720.91.0.791889164093.issue11885@psf.upfronthosting.co.za>
Message-ID: <1303300817.84.0.934191575145.issue11885@psf.upfronthosting.co.za>


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


----------
nosy: +eric.araujo, ezio.melotti

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

From report at bugs.python.org  Wed Apr 20 15:49:53 2011
From: report at bugs.python.org (=?utf-8?q?Bo=C5=A1tjan_Mejak?=)
Date: Wed, 20 Apr 2011 13:49:53 +0000
Subject: [docs] [issue11885] argparse docs needs fixing
In-Reply-To: <1303300720.91.0.791889164093.issue11885@psf.upfronthosting.co.za>
Message-ID: <1303307393.62.0.877111929217.issue11885@psf.upfronthosting.co.za>


Bo?tjan Mejak <bostjan.mejak at gmail.com> added the comment:

I have also discovered some non-capitalised "python" words in the very same argparse docs. These 2 subtitles have those typos:

1) 15.4.1.1. Creating a parser
2) 15.4.6. Upgrading optparse code


Please fix this as well.

----------

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

From sandro.tosi at gmail.com  Wed Apr 20 20:35:36 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Wed, 20 Apr 2011 20:35:36 +0200
Subject: [docs] Wrong API name in Python 3.2 doc Python/C API Reference
	Manual
In-Reply-To: <3DF93BC1E6EB2E45AD12B4DBF431E372C9B02BCABA@CSUKLEEXMB01.corp.group.local>
References: <AQHL6Jaiizx+fTZUrEGIzee0zM2kGQ==>
	<3DF93BC1E6EB2E45AD12B4DBF431E372C9B02BCABA@CSUKLEEXMB01.corp.group.local>
Message-ID: <BANLkTikr-GM3xyUm1juyZxPXsroTv0MEdw@mail.gmail.com>

Hi Clive,

On Tue, Mar 22, 2011 at 14:39, Darke, Clive <Clive.Darke at qa.com> wrote:
> Under "Initialization, Finalization, and Threads", "Non-Python created
> threads":
>
> "OS facilities such as posix_atfork() would need to be used "
>
> should be:
>
> "OS facilities such as pthread_atfork() would need to be used"
>
> (So far as I know there is no such function as posix_atfork())
> Forgive me if this report?is not in the required format.

This has now been fixed: thanks!

Regards,
-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

From report at bugs.python.org  Thu Apr 21 00:25:22 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Wed, 20 Apr 2011 22:25:22 +0000
Subject: [docs] [issue10977] Concrete object C API considered harmful to
	subclasses	of builtin types
In-Reply-To: <1295653779.62.0.836506069174.issue10977@psf.upfronthosting.co.za>
Message-ID: <1303338322.83.0.809467431618.issue10977@psf.upfronthosting.co.za>


Changes by Raymond Hettinger <raymond.hettinger at gmail.com>:


----------
title: Concrete object C API needs abstract path for subclasses of builtin types -> Concrete object C API considered harmful to subclasses of builtin types

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

From report at bugs.python.org  Thu Apr 21 12:09:21 2011
From: report at bugs.python.org (intgr)
Date: Thu, 21 Apr 2011 10:09:21 +0000
Subject: [docs] [issue11897] [PATCH] Documentation: fix typo,
	absolute_import not absolute_imports
In-Reply-To: <1303380560.99.0.860911638141.issue11897@psf.upfronthosting.co.za>
Message-ID: <1303380560.99.0.860911638141.issue11897@psf.upfronthosting.co.za>


New submission from intgr <marti at juffo.org>:

The "Porting Python 2 Code to Python 3" guide currently says:
   from __future__ import absolute_imports

However it should be singular:
   from __future__ import absolute_import

----------
assignee: docs at python
components: Documentation
files: absolute_import_singular.patch
keywords: patch
messages: 134206
nosy: docs at python, intgr
priority: normal
severity: normal
status: open
title: [PATCH] Documentation: fix typo, absolute_import not absolute_imports
versions: Python 3.2
Added file: http://bugs.python.org/file21746/absolute_import_singular.patch

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

From report at bugs.python.org  Thu Apr 21 13:50:39 2011
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 21 Apr 2011 11:50:39 +0000
Subject: [docs] [issue11897] [PATCH] Documentation: fix typo,
	absolute_import not absolute_imports
In-Reply-To: <1303380560.99.0.860911638141.issue11897@psf.upfronthosting.co.za>
Message-ID: <E1QCsP2-0001dk-OG@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 05a7d3048c49 by Ezio Melotti in branch '3.2':
#11897: Fix typo in porting howto. Patch by Marti Raudsepp.
http://hg.python.org/cpython/rev/05a7d3048c49

New changeset 968fba3f34b3 by Ezio Melotti in branch 'default':
#11897: Merge with 3.2.
http://hg.python.org/cpython/rev/968fba3f34b3

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

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

From report at bugs.python.org  Thu Apr 21 13:54:20 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 21 Apr 2011 11:54:20 +0000
Subject: [docs] [issue11897] [PATCH] Documentation: fix typo,
	absolute_import not absolute_imports
In-Reply-To: <1303380560.99.0.860911638141.issue11897@psf.upfronthosting.co.za>
Message-ID: <1303386860.28.0.335927560118.issue11897@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

Fixed, thanks for the patch!

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

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

From report at bugs.python.org  Thu Apr 21 14:29:45 2011
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 21 Apr 2011 12:29:45 +0000
Subject: [docs] [issue11885] argparse docs needs fixing
In-Reply-To: <1303300720.91.0.791889164093.issue11885@psf.upfronthosting.co.za>
Message-ID: <E1QCt0u-0005m2-WB@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 0f084f150198 by Ezio Melotti in branch '2.7':
#11885: capitalize Python.
http://hg.python.org/cpython/rev/0f084f150198

New changeset fb6affc7b973 by Ezio Melotti in branch '3.2':
#11885: capitalize Python.
http://hg.python.org/cpython/rev/fb6affc7b973

New changeset 9fece8c3a1a9 by Ezio Melotti in branch 'default':
#11885: Merge with 3.2.
http://hg.python.org/cpython/rev/9fece8c3a1a9

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

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

From report at bugs.python.org  Thu Apr 21 14:30:35 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 21 Apr 2011 12:30:35 +0000
Subject: [docs] [issue11885] argparse docs needs fixing
In-Reply-To: <1303300720.91.0.791889164093.issue11885@psf.upfronthosting.co.za>
Message-ID: <1303389035.62.0.164086565741.issue11885@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

Fixed, thanks for the report.

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

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

From report at bugs.python.org  Thu Apr 21 15:15:23 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 21 Apr 2011 13:15:23 +0000
Subject: [docs] [issue11885] argparse docs needs fixing
In-Reply-To: <1303300720.91.0.791889164093.issue11885@psf.upfronthosting.co.za>
Message-ID: <1303391723.87.0.769232472277.issue11885@psf.upfronthosting.co.za>


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


----------
assignee: docs at python -> ezio.melotti

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

From report at bugs.python.org  Thu Apr 21 17:01:45 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 21 Apr 2011 15:01:45 +0000
Subject: [docs] [issue11885] argparse docs needs fixing
In-Reply-To: <1303300720.91.0.791889164093.issue11885@psf.upfronthosting.co.za>
Message-ID: <1303398105.46.0.867592577357.issue11885@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

>> "When most in optparse had either been copy-pasted over or monkey-patched ..."
> Word "everything" was removed.
The result is grammatically incorrect :)  I?d suggest ?most of argparse?.

> comma was deleted after "that is".
Both versions were grammatically correct, it was a style thing, in which case I would respect the choice of the original author.

----------

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

From report at bugs.python.org  Thu Apr 21 17:02:02 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 21 Apr 2011 15:02:02 +0000
Subject: [docs] [issue11885] argparse docs needs fixing
In-Reply-To: <1303300720.91.0.791889164093.issue11885@psf.upfronthosting.co.za>
Message-ID: <1303398122.47.0.713384830746.issue11885@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

most of optparse*

----------

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

From report at bugs.python.org  Thu Apr 21 20:24:23 2011
From: report at bugs.python.org (R. David Murray)
Date: Thu, 21 Apr 2011 18:24:23 +0000
Subject: [docs] [issue11901] Docs for sys.hexversion should give the
	algorithm
In-Reply-To: <1303410263.92.0.721904855375.issue11901@psf.upfronthosting.co.za>
Message-ID: <1303410263.92.0.721904855375.issue11901@psf.upfronthosting.co.za>


New submission from R. David Murray <rdmurray at bitdance.com>:

I went to write a test that would trigger something if it was run on 3.3.0, and had to look in the source code to figure out what the hexversion for that would be.  I think the hexversion algorithm should be documented in its sys entry.

----------
assignee: docs at python
components: Documentation
messages: 134232
nosy: docs at python, r.david.murray
priority: normal
severity: normal
stage: needs patch
status: open
title: Docs for sys.hexversion should give the algorithm
type: feature request

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

From report at bugs.python.org  Thu Apr 21 20:33:57 2011
From: report at bugs.python.org (=?utf-8?q?Bo=C5=A1tjan_Mejak?=)
Date: Thu, 21 Apr 2011 18:33:57 +0000
Subject: [docs] [issue11885] argparse docs needs fixing
In-Reply-To: <1303398122.47.0.713384830746.issue11885@psf.upfronthosting.co.za>
Message-ID: <BANLkTimu7gR1rOatnxk_FCu9HSctUdC5uw@mail.gmail.com>


Bo??tjan Mejak <bostjan.mejak at gmail.com> added the comment:

Eric, you are great! Thanks for fixing the docs. ;)

----------
Added file: http://bugs.python.org/file21750/unnamed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue11885>
_______________________________________
-------------- next part --------------
Eric, you are great! Thanks for fixing the docs. ;)

From report at bugs.python.org  Thu Apr 21 21:15:50 2011
From: report at bugs.python.org (Vladimir Rutsky)
Date: Thu, 21 Apr 2011 19:15:50 +0000
Subject: [docs] [issue11902] typo in argparse doc's: "action.."
In-Reply-To: <1303413350.17.0.602462261272.issue11902@psf.upfronthosting.co.za>
Message-ID: <1303413350.17.0.602462261272.issue11902@psf.upfronthosting.co.za>


New submission from Vladimir Rutsky <altsysrq at gmail.com>:

There is a typo in argparse module documentation:
"The ``nargs`` keyword argument associates a different number of command-line arguments with a single action.." (two dots at end).

Patch based on official http://svn.python.org/projects/python/branches/py3k/ repository, but typo is also noted in Python 2.7 documentation.

----------
assignee: docs at python
components: Documentation
files: argparse_typo_action_dot_dot.patch
keywords: patch
messages: 134237
nosy: docs at python, rutsky
priority: normal
severity: normal
status: open
title: typo in argparse doc's: "action.."
versions: Python 2.7, Python 3.4
Added file: http://bugs.python.org/file21751/argparse_typo_action_dot_dot.patch

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

From report at bugs.python.org  Thu Apr 21 21:50:13 2011
From: report at bugs.python.org (Vladimir Rutsky)
Date: Thu, 21 Apr 2011 19:50:13 +0000
Subject: [docs] [issue11904] incorrect reStructuredText formatting in
	argparse module
In-Reply-To: <1303415412.97.0.882157170829.issue11904@psf.upfronthosting.co.za>
Message-ID: <1303415412.97.0.882157170829.issue11904@psf.upfronthosting.co.za>


New submission from Vladimir Rutsky <altsysrq at gmail.com>:

In Python 2.7 and 3 branch at http://svn.python.org/projects/python/branches/py3k/ file Doc/library/argparse.rst has incorrectly formatted list at line 648:

> * ``'store'`` - This just stores the argument's value.  This is the default
>    action. For example::

Second line must be indented according to first line.

Next item at line 656 has invalid indentation too.

----------
assignee: docs at python
components: Documentation
messages: 134240
nosy: docs at python, rutsky
priority: normal
severity: normal
status: open
title: incorrect reStructuredText formatting in argparse module
versions: Python 2.7, Python 3.4

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

From report at bugs.python.org  Thu Apr 21 21:57:18 2011
From: report at bugs.python.org (Vladimir Rutsky)
Date: Thu, 21 Apr 2011 19:57:18 +0000
Subject: [docs] [issue11905] typo in argparse doc's: missing dot at end of
	sentence
In-Reply-To: <1303415838.79.0.720051714713.issue11905@psf.upfronthosting.co.za>
Message-ID: <1303415838.79.0.720051714713.issue11905@psf.upfronthosting.co.za>


New submission from Vladimir Rutsky <altsysrq at gmail.com>:

There is missed dot at end of sentence in argparse module documentation. Please see attached patch for details.

Patch based on official http://svn.python.org/projects/python/branches/py3k/ repository, but typo is also noted in Python 2.7 documentation.

----------
assignee: docs at python
components: Documentation
files: argparse_typo_missing_dot.patch
keywords: patch
messages: 134241
nosy: docs at python, rutsky
priority: normal
severity: normal
status: open
title: typo in argparse doc's: missing dot at end of sentence
versions: Python 2.7, Python 3.4
Added file: http://bugs.python.org/file21752/argparse_typo_missing_dot.patch

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

From report at bugs.python.org  Thu Apr 21 21:59:28 2011
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 21 Apr 2011 19:59:28 +0000
Subject: [docs] [issue11902] typo in argparse doc's: "action.."
In-Reply-To: <1303413350.17.0.602462261272.issue11902@psf.upfronthosting.co.za>
Message-ID: <E1QD024-0001a5-C1@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset e8464256b4d7 by Ezio Melotti in branch '2.7':
#11902: Fix typo in argparse doc. Noticed by Vladimir Rutsky.
http://hg.python.org/cpython/rev/e8464256b4d7

New changeset 88df1ef4eec8 by Ezio Melotti in branch '3.2':
#11902: Fix typo in argparse doc. Noticed by Vladimir Rutsky.
http://hg.python.org/cpython/rev/88df1ef4eec8

New changeset 56825d54dc84 by Ezio Melotti in branch 'default':
#11902: Merge with 3.2.
http://hg.python.org/cpython/rev/56825d54dc84

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

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

From report at bugs.python.org  Thu Apr 21 22:02:35 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 21 Apr 2011 20:02:35 +0000
Subject: [docs] [issue11902] typo in argparse doc's: "action.."
In-Reply-To: <1303413350.17.0.602462261272.issue11902@psf.upfronthosting.co.za>
Message-ID: <1303416155.51.0.937060422874.issue11902@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

Fixed, thanks for the report.

BTW we are using HG now (http://hg.python.org/cpython) and patches should be submitted against the oldest applicable branch (either 2.7 or 3.2 is fine in this case).
More info at http://docs.python.org/devguide/.

----------
assignee: docs at python -> ezio.melotti
nosy: +ezio.melotti
resolution:  -> fixed
stage:  -> committed/rejected
status: open -> closed
versions: +Python 3.2, Python 3.3 -Python 3.4

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

From report at bugs.python.org  Thu Apr 21 22:13:35 2011
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 21 Apr 2011 20:13:35 +0000
Subject: [docs] [issue11904] incorrect reStructuredText formatting in
	argparse module
In-Reply-To: <1303415412.97.0.882157170829.issue11904@psf.upfronthosting.co.za>
Message-ID: <E1QD0Fp-0002mL-3o@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 79f3ae389dae by Ezio Melotti in branch '2.7':
#11904: fix indentation in argparse doc. Noticed by Vladimir Rutsky.
http://hg.python.org/cpython/rev/79f3ae389dae

New changeset 473fada5f1b7 by Ezio Melotti in branch '3.2':
#11904: fix indentation in argparse doc. Noticed by Vladimir Rutsky.
http://hg.python.org/cpython/rev/473fada5f1b7

New changeset 8568762381b4 by Ezio Melotti in branch 'default':
#11904-#11905: Merge typo fixes with 3.2.
http://hg.python.org/cpython/rev/8568762381b4

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

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

From report at bugs.python.org  Thu Apr 21 22:13:35 2011
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 21 Apr 2011 20:13:35 +0000
Subject: [docs] [issue11905] typo in argparse doc's: missing dot at end of
	sentence
In-Reply-To: <1303415838.79.0.720051714713.issue11905@psf.upfronthosting.co.za>
Message-ID: <E1QD0Fp-0002mL-3w@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset f6ea7abc4eb2 by Ezio Melotti in branch '2.7':
#11905: fix missing full stop in argparse doc. Noticed by Vladimir Rutsky.
http://hg.python.org/cpython/rev/f6ea7abc4eb2

New changeset 15f482996880 by Ezio Melotti in branch '3.2':
#11905: fix missing full stop in argparse doc. Noticed by Vladimir Rutsky.
http://hg.python.org/cpython/rev/15f482996880

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

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

From report at bugs.python.org  Thu Apr 21 22:15:10 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 21 Apr 2011 20:15:10 +0000
Subject: [docs] [issue11905] typo in argparse doc's: missing dot at end of
	sentence
In-Reply-To: <1303415838.79.0.720051714713.issue11905@psf.upfronthosting.co.za>
Message-ID: <1303416910.01.0.0477373508671.issue11905@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

Fixed, thanks for the report!

----------
assignee: docs at python -> ezio.melotti
nosy: +ezio.melotti
resolution:  -> fixed
stage:  -> committed/rejected
status: open -> closed
versions: +Python 3.2, Python 3.3 -Python 3.4

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

From report at bugs.python.org  Thu Apr 21 22:16:06 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 21 Apr 2011 20:16:06 +0000
Subject: [docs] [issue11904] incorrect reStructuredText formatting in
	argparse module
In-Reply-To: <1303415412.97.0.882157170829.issue11904@psf.upfronthosting.co.za>
Message-ID: <1303416966.54.0.788181167724.issue11904@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

Fixed, thanks for the report!

----------
assignee: docs at python -> ezio.melotti
nosy: +ezio.melotti
resolution:  -> fixed
stage:  -> committed/rejected
status: open -> closed
versions: +Python 3.2, Python 3.3 -Python 3.4

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

From report at bugs.python.org  Fri Apr 22 02:21:17 2011
From: report at bugs.python.org (Arfrever Frehtes Taifersar Arahesis)
Date: Fri, 22 Apr 2011 00:21:17 +0000
Subject: [docs] [issue9196] Improve docs for string interpolation "%s" re
	Unicode	strings
In-Reply-To: <1278572830.17.0.148747735024.issue9196@psf.upfronthosting.co.za>
Message-ID: <1303431677.03.0.596254425013.issue9196@psf.upfronthosting.co.za>


Changes by Arfrever Frehtes Taifersar Arahesis <Arfrever.FTA at GMail.Com>:


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

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

From report at bugs.python.org  Fri Apr 22 18:33:54 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 22 Apr 2011 16:33:54 +0000
Subject: [docs] [issue11885] argparse docs needs fixing
In-Reply-To: <1303300720.91.0.791889164093.issue11885@psf.upfronthosting.co.za>
Message-ID: <1303490034.19.0.84506087393.issue11885@psf.upfronthosting.co.za>


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


Removed file: http://bugs.python.org/file21750/unnamed

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

From report at bugs.python.org  Fri Apr 22 18:34:14 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 22 Apr 2011 16:34:14 +0000
Subject: [docs] [issue11885] argparse docs needs fixing
In-Reply-To: <1303300720.91.0.791889164093.issue11885@psf.upfronthosting.co.za>
Message-ID: <1303490054.46.0.4950404398.issue11885@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

No problem, it?s Ezio who did the work.

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

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

From report at bugs.python.org  Fri Apr 22 19:00:07 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 22 Apr 2011 17:00:07 +0000
Subject: [docs] [issue11901] Docs for sys.hexversion should give the
	algorithm
In-Reply-To: <1303410263.92.0.721904855375.issue11901@psf.upfronthosting.co.za>
Message-ID: <1303491607.3.0.469459240741.issue11901@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Apr 22 19:04:17 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Fri, 22 Apr 2011 17:04:17 +0000
Subject: [docs] [issue11901] Docs for sys.hexversion should give the
	algorithm
In-Reply-To: <1303410263.92.0.721904855375.issue11901@psf.upfronthosting.co.za>
Message-ID: <1303491857.26.0.122655013186.issue11901@psf.upfronthosting.co.za>


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

+1

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

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

From report at bugs.python.org  Fri Apr 22 19:37:26 2011
From: report at bugs.python.org (Ram Rachum)
Date: Fri, 22 Apr 2011 17:37:26 +0000
Subject: [docs] [issue11908] Weird `slice.stop or sys.maxint`
In-Reply-To: <1303493846.17.0.214651551769.issue11908@psf.upfronthosting.co.za>
Message-ID: <1303493846.17.0.214651551769.issue11908@psf.upfronthosting.co.za>


New submission from Ram Rachum <cool-rr at cool-rr.com>:

In the documentation for `itertools.islice` I see this line:

    it = iter(xrange(s.start or 0, s.stop or sys.maxint, s.step or 1))

Is it really okay to do `s.stop or sys.maxint`? I'm assuming this was targeting `None`, but what if `s.stop == 0`? And `s.step` could (pathologically) be `0` too, no?

----------
assignee: docs at python
components: Documentation
messages: 134276
nosy: cool-RR, docs at python
priority: normal
severity: normal
status: open
title: Weird `slice.stop or sys.maxint`
type: behavior
versions: Python 2.5, Python 2.6, Python 2.7, Python 3.1, Python 3.2, Python 3.3, Python 3.4

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

From report at bugs.python.org  Fri Apr 22 20:01:51 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Fri, 22 Apr 2011 18:01:51 +0000
Subject: [docs] [issue11908] Weird `slice.stop or sys.maxint`
In-Reply-To: <1303493846.17.0.214651551769.issue11908@psf.upfronthosting.co.za>
Message-ID: <1303495311.43.0.670220367655.issue11908@psf.upfronthosting.co.za>


Changes by Raymond Hettinger <raymond.hettinger at gmail.com>:


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

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

From report at bugs.python.org  Sat Apr 23 00:24:33 2011
From: report at bugs.python.org (=?utf-8?q?Bo=C5=A1tjan_Mejak?=)
Date: Fri, 22 Apr 2011 22:24:33 +0000
Subject: [docs] [issue11885] argparse docs needs fixing
In-Reply-To: <1303490054.46.0.4950404398.issue11885@psf.upfronthosting.co.za>
Message-ID: <BANLkTimvR_vsx3DipVRe=b6EzSzdBKfKtQ@mail.gmail.com>


Bo??tjan Mejak <bostjan.mejak at gmail.com> added the comment:

I ment to say Ezio. Got confused. Thanks, Ezio!

----------
Added file: http://bugs.python.org/file21758/unnamed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue11885>
_______________________________________
-------------- next part --------------
I ment to say Ezio. Got confused. Thanks, Ezio!

From report at bugs.python.org  Sat Apr 23 02:45:14 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 23 Apr 2011 00:45:14 +0000
Subject: [docs] [issue11860] reference 2.3 has text that runs past the page
In-Reply-To: <1303005204.18.0.459182918365.issue11860@psf.upfronthosting.co.za>
Message-ID: <1303519514.82.0.641720487818.issue11860@psf.upfronthosting.co.za>


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

I presume you are talking about long boxed grammar or example lines that run horizontally past the right edge of the window, like

id_start     ::=  <all characters in general categories Lu, Ll, Lt, Lm, Lo, Nl, the underscore, and characters with the Other_ID_Start property>

For both the .html (online) and .chm (windows help) versions of the docs, these boxes have horizontal scroll bars. For both types of files, regular text is wrapped according to the size of the window, which the user can change. Neither involved latex and there is no such thing as the width of the page, and there are no page numbers either.

Are you, possibly, referring to a .pdf version, which I believe is run through latex?

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

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

From report at bugs.python.org  Sat Apr 23 03:23:10 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Sat, 23 Apr 2011 01:23:10 +0000
Subject: [docs] [issue11860] reference 2.3 has text that runs past the page
In-Reply-To: <1303005204.18.0.459182918365.issue11860@psf.upfronthosting.co.za>
Message-ID: <1303521790.35.0.87596409089.issue11860@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

Yes, the problem is with the PDF. See also #4173.

----------

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

From report at bugs.python.org  Sat Apr 23 03:43:34 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 23 Apr 2011 01:43:34 +0000
Subject: [docs] [issue11860] reference 2.3 has text that runs past the page
In-Reply-To: <1303005204.18.0.459182918365.issue11860@psf.upfronthosting.co.za>
Message-ID: <1303523014.21.0.946835946021.issue11860@psf.upfronthosting.co.za>


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

Then this appears to be a duplicate. Closing

----------
resolution:  -> duplicate
status: open -> closed
superseder:  -> PDF documentation: long verbatim lines are cut off at right hand side

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

From report at bugs.python.org  Sat Apr 23 10:17:59 2011
From: report at bugs.python.org (anatoly techtonik)
Date: Sat, 23 Apr 2011 08:17:59 +0000
Subject: [docs] [issue11911] Interlink Python versions docs
In-Reply-To: <1303546679.67.0.126016913542.issue11911@psf.upfronthosting.co.za>
Message-ID: <1303546679.67.0.126016913542.issue11911@psf.upfronthosting.co.za>


New submission from anatoly techtonik <techtonik at gmail.com>:

I want to be able to jump from latest Python 2 docs to the same page in stable Python 3 doc in one click. E.g. from http://docs.python.org/library/string.html to http://docs.python.org/py3k/library/strings.html

----------
assignee: docs at python
components: Documentation
messages: 134296
nosy: docs at python, techtonik
priority: normal
severity: normal
status: open
title: Interlink Python versions docs
versions: Python 2.7, Python 3.2

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

From report at bugs.python.org  Sat Apr 23 10:18:11 2011
From: report at bugs.python.org (anatoly techtonik)
Date: Sat, 23 Apr 2011 08:18:11 +0000
Subject: [docs] [issue11911] Interlink Python versions docs
In-Reply-To: <1303546679.67.0.126016913542.issue11911@psf.upfronthosting.co.za>
Message-ID: <1303546691.09.0.0532223044566.issue11911@psf.upfronthosting.co.za>


anatoly techtonik <techtonik at gmail.com> added the comment:

sorry, to http://docs.python.org/py3k/library/string.html

----------

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

From report at bugs.python.org  Sat Apr 23 15:30:09 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Sat, 23 Apr 2011 13:30:09 +0000
Subject: [docs] [issue11911] Interlink Python versions docs
In-Reply-To: <1303546679.67.0.126016913542.issue11911@psf.upfronthosting.co.za>
Message-ID: <1303565409.1.0.502011521779.issue11911@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

This is a duplicated of #8040.

----------
nosy: +ezio.melotti
resolution:  -> duplicate
stage:  -> committed/rejected
status: open -> closed
superseder:  -> It would be nice if documentation pages linked to other versions of the same document

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

From report at bugs.python.org  Mon Apr 25 04:12:00 2011
From: report at bugs.python.org (=?utf-8?b?SmVzw7pzIENlYSBBdmnDs24=?=)
Date: Mon, 25 Apr 2011 02:12:00 +0000
Subject: [docs] [issue11901] Docs for sys.hexversion should give the
	algorithm
In-Reply-To: <1303410263.92.0.721904855375.issue11901@psf.upfronthosting.co.za>
Message-ID: <1303697520.49.0.747184149766.issue11901@psf.upfronthosting.co.za>


Jes?s Cea Avi?n <jcea at jcea.es> added the comment:

+1!.

----------
nosy: +jcea

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

From report at bugs.python.org  Mon Apr 25 08:24:39 2011
From: report at bugs.python.org (anatoly techtonik)
Date: Mon, 25 Apr 2011 06:24:39 +0000
Subject: [docs] [issue8040] It would be nice if documentation pages linked
	to other	versions of the same document
In-Reply-To: <1267543845.91.0.112810116218.issue8040@psf.upfronthosting.co.za>
Message-ID: <1303712679.5.0.147119224686.issue8040@psf.upfronthosting.co.za>


Changes by anatoly techtonik <techtonik at gmail.com>:


----------
nosy: +techtonik

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

From report at bugs.python.org  Mon Apr 25 09:09:14 2011
From: report at bugs.python.org (ysj.ray)
Date: Mon, 25 Apr 2011 07:09:14 +0000
Subject: [docs] [issue11908] Weird `slice.stop or sys.maxint`
In-Reply-To: <1303493846.17.0.214651551769.issue11908@psf.upfronthosting.co.za>
Message-ID: <1303715354.76.0.469654613413.issue11908@psf.upfronthosting.co.za>


ysj.ray <ysj.ray at gmail.com> added the comment:

`step` argument for xrange() could not be 0.

But `s.stop or sys.maxint` is really a problem, in the case of `s.stop == 0`.

So the given `Equivalent to` python code in the doc is not precisely equivalent to the c implementation. The doc needs a fix.

----------
nosy: +ysj.ray

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

From report at bugs.python.org  Mon Apr 25 09:51:05 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 25 Apr 2011 07:51:05 +0000
Subject: [docs] [issue11908] Weird `slice.stop or sys.maxint`
In-Reply-To: <1303493846.17.0.214651551769.issue11908@psf.upfronthosting.co.za>
Message-ID: <1303717865.59.0.442954527882.issue11908@psf.upfronthosting.co.za>


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

I've got from here.  Thanks.

----------

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

From sandro.tosi at gmail.com  Mon Apr 25 12:40:45 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Mon, 25 Apr 2011 12:40:45 +0200
Subject: [docs] Large print / small paper size (maybe A5) python docs.
In-Reply-To: <BANLkTimfhOK5ys2cWsgivZqTycUUysARVA@mail.gmail.com>
References: <BANLkTin9F9NVk0-AcD7Saydok+udMMbS=g@mail.gmail.com>
	<BANLkTimfhOK5ys2cWsgivZqTycUUysARVA@mail.gmail.com>
Message-ID: <BANLkTincK7qwAt9Bz7GiQn5PdBQ2WLvOBw@mail.gmail.com>

On Wed, Apr 13, 2011 at 21:21, Fred Drake <fdrake at acm.org> wrote:
> On Wed, Apr 13, 2011 at 11:22 AM, Matt | Varghese Mathew
> <varghese85 at gmail.com> wrote:
>> Would it be possible to release large print / small paper size python docs?
>> Would work well with something like a kindle or many tablets.
>> The A4 / US letter sizes make the print too tiny on a kindle.
>
> I think there's a plan in the works for an epub or mobi format
> version; this should alleviate the pain of using the letter-size PDF
> version on such devices.

Indeed: 3.2 was released with an EPUB documentation file available,
but AFAIK Kindle only support MOBI format, and so we need to write a
Sphinx plugin to otuput documentation in MOBI format too; does someone
volunteer for that? :)

Cheers,
-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

From report at bugs.python.org  Mon Apr 25 19:19:46 2011
From: report at bugs.python.org (Bryce Verdier)
Date: Mon, 25 Apr 2011 17:19:46 +0000
Subject: [docs] [issue11834] wrong module installation dir on Windows
In-Reply-To: <1302605256.31.0.234550103785.issue11834@psf.upfronthosting.co.za>
Message-ID: <1303751986.59.0.0404852483118.issue11834@psf.upfronthosting.co.za>


Bryce Verdier <bryceverdier at gmail.com> added the comment:

Here is a patch for the documentation. I'm not quite sure about the scripts and data part. Tested with Paramiko and a new install of 2.7 to see what would happen and that was the result.

----------
keywords: +patch
nosy: +louiscipher
Added file: http://bugs.python.org/file21773/issue133572.py33.patch

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

From report at bugs.python.org  Mon Apr 25 19:21:47 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Mon, 25 Apr 2011 17:21:47 +0000
Subject: [docs] [issue11922] Add General Index to Windows .chm help file
	Contents
In-Reply-To: <1303752107.55.0.594682028964.issue11922@psf.upfronthosting.co.za>
Message-ID: <1303752107.55.0.594682028964.issue11922@psf.upfronthosting.co.za>


New submission from Terry J. Reedy <tjreedy at udel.edu>:

The Windows distribution comes with the docs in a very nice Windows help file .chm form. When displayed, they is a left side bar with a Contents tab. The top entry is 'Python vx.y documentation' followed by 'Python Module Index' and 'What's New in Python' and so on down to 'History and Licence'. Everything on the "Python vx.y documentation' page is listed in the Contents EXCEPT the General Index. Consequently, if one only uses the contents lists, one might not even know it exists. In any case, it is harder to get to than anything else.

I presume the omission is unintentional. In any case, I would like to see it fixed, with 'General Index' added right after the module index entry. I presume this should be easy for someone who knows how the contents list is generated.

----------
assignee: docs at python
components: Documentation, Windows
keywords: easy
messages: 134398
nosy: docs at python, terry.reedy
priority: normal
severity: normal
stage: needs patch
status: open
title: Add General Index to Windows .chm help file Contents
versions: Python 2.7, Python 3.1, Python 3.2, Python 3.3

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

From report at bugs.python.org  Mon Apr 25 20:04:08 2011
From: report at bugs.python.org (Sijin Joseph)
Date: Mon, 25 Apr 2011 18:04:08 +0000
Subject: [docs] [issue11901] Docs for sys.hexversion should give the
	algorithm
In-Reply-To: <1303410263.92.0.721904855375.issue11901@psf.upfronthosting.co.za>
Message-ID: <1303754648.34.0.219879530833.issue11901@psf.upfronthosting.co.za>


Sijin Joseph <sijinjoseph at gmail.com> added the comment:

Patch attached.

----------
keywords: +patch
nosy: +sijinjoseph
Added file: http://bugs.python.org/file21774/11901.patch

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

From report at bugs.python.org  Mon Apr 25 20:06:16 2011
From: report at bugs.python.org (Sijin Joseph)
Date: Mon, 25 Apr 2011 18:06:16 +0000
Subject: [docs] [issue11901] Docs for sys.hexversion should give the
	algorithm
In-Reply-To: <1303410263.92.0.721904855375.issue11901@psf.upfronthosting.co.za>
Message-ID: <1303754776.97.0.701643439395.issue11901@psf.upfronthosting.co.za>


Changes by Sijin Joseph <sijinjoseph at gmail.com>:


Removed file: http://bugs.python.org/file21774/11901.patch

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

From report at bugs.python.org  Mon Apr 25 20:06:46 2011
From: report at bugs.python.org (Sijin Joseph)
Date: Mon, 25 Apr 2011 18:06:46 +0000
Subject: [docs] [issue11901] Docs for sys.hexversion should give the
	algorithm
In-Reply-To: <1303410263.92.0.721904855375.issue11901@psf.upfronthosting.co.za>
Message-ID: <1303754806.33.0.628544092427.issue11901@psf.upfronthosting.co.za>


Sijin Joseph <sijinjoseph at gmail.com> added the comment:

Fixed minor typo.

----------
Added file: http://bugs.python.org/file21775/11901.patch

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

From report at bugs.python.org  Mon Apr 25 20:10:51 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Mon, 25 Apr 2011 18:10:51 +0000
Subject: [docs] [issue11908] Weird `slice.stop or sys.maxint`
In-Reply-To: <1303493846.17.0.214651551769.issue11908@psf.upfronthosting.co.za>
Message-ID: <1303755051.15.0.782630384856.issue11908@psf.upfronthosting.co.za>


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


----------
versions:  -Python 2.5, Python 2.6, Python 3.4

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

From report at bugs.python.org  Mon Apr 25 22:15:02 2011
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 25 Apr 2011 20:15:02 +0000
Subject: [docs] [issue11901] Docs for sys.hexversion should give the
	algorithm
In-Reply-To: <1303410263.92.0.721904855375.issue11901@psf.upfronthosting.co.za>
Message-ID: <E1QESBP-0001bs-36@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 48758cd0769b by R David Murray in branch '2.7':
#11901: add description of how bitfields are laid out to hexversion docs
http://hg.python.org/cpython/rev/48758cd0769b

New changeset b84384fbdbf0 by R David Murray in branch '3.1':
#11901: add description of how bitfields are laid out to hexversion docs
http://hg.python.org/cpython/rev/b84384fbdbf0

New changeset cca4c92bf337 by R David Murray in branch '3.2':
Merge #11901: add description of how bitfields are laid out to hexversion docs
http://hg.python.org/cpython/rev/cca4c92bf337

New changeset 07149918bce1 by R David Murray in branch 'default':
Merge #11901: add description of how bitfields are laid out to hexversion docs
http://hg.python.org/cpython/rev/07149918bce1

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

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

From report at bugs.python.org  Mon Apr 25 22:19:36 2011
From: report at bugs.python.org (R. David Murray)
Date: Mon, 25 Apr 2011 20:19:36 +0000
Subject: [docs] [issue11901] Docs for sys.hexversion should give the
	algorithm
In-Reply-To: <1303410263.92.0.721904855375.issue11901@psf.upfronthosting.co.za>
Message-ID: <1303762776.03.0.805739847133.issue11901@psf.upfronthosting.co.za>


R. David Murray <rdmurray at bitdance.com> added the comment:

Thanks!  I tidied up the ReST formatting a bit and changed the bit numbering to the more standard left to right order (standard for bit fields...I realize hexversion is a number, but conceptually one deals with it as a bit field).

----------
resolution:  -> accepted
stage: needs patch -> committed/rejected
status: open -> closed
versions: +Python 2.7, Python 3.1, Python 3.2, Python 3.3

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

From report at bugs.python.org  Mon Apr 25 23:27:43 2011
From: report at bugs.python.org (=?utf-8?b?SmVzw7pzIENlYSBBdmnDs24=?=)
Date: Mon, 25 Apr 2011 21:27:43 +0000
Subject: [docs] [issue11924] Pickle and copyreg modules doesn't document the
	interface
In-Reply-To: <1303766863.75.0.154822649898.issue11924@psf.upfronthosting.co.za>
Message-ID: <1303766863.75.0.154822649898.issue11924@psf.upfronthosting.co.za>


New submission from Jes?s Cea Avi?n <jcea at jcea.es>:

Python 3.2 here.

"copyreg" module documentation says "See the pickle module for more details on the interface expected of function and constructor.", but I don't see any useful "copyreg" reference in pickle documentation.

Some examples would be useful here, too.

----------
assignee: docs at python
messages: 134416
nosy: docs at python, jcea
priority: normal
severity: normal
status: open
title: Pickle and copyreg modules doesn't document the interface
versions: Python 2.7, Python 3.2, Python 3.3

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

From report at bugs.python.org  Mon Apr 25 23:28:24 2011
From: report at bugs.python.org (=?utf-8?b?SmVzw7pzIENlYSBBdmnDs24=?=)
Date: Mon, 25 Apr 2011 21:28:24 +0000
Subject: [docs] [issue11924] Pickle and copyreg modules don't document the
	interface
In-Reply-To: <1303766863.75.0.154822649898.issue11924@psf.upfronthosting.co.za>
Message-ID: <1303766904.54.0.994295513689.issue11924@psf.upfronthosting.co.za>


Changes by Jes?s Cea Avi?n <jcea at jcea.es>:


----------
title: Pickle and copyreg modules doesn't document the interface -> Pickle and copyreg modules don't document the interface

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

From report at bugs.python.org  Tue Apr 26 03:56:00 2011
From: report at bugs.python.org (Carl M. Johnson)
Date: Tue, 26 Apr 2011 01:56:00 +0000
Subject: [docs] [issue11926] help("keywords") returns incomplete list of
	keywords
In-Reply-To: <1303782960.65.0.80653815306.issue11926@psf.upfronthosting.co.za>
Message-ID: <1303782960.65.0.80653815306.issue11926@psf.upfronthosting.co.za>


New submission from Carl M. Johnson <cmjohnson.mailinglist at gmail.com>:

In Python 3.2, help("keywords") returns the following:



Here is a list of the Python keywords.  Enter any keyword to get more help.

and                 elif                import              raise
as                  else                in                  return
assert              except              is                  try
break               finally             lambda              while
class               for                 nonlocal            with
continue            from                not                 yield
def                 global              or                  
del                 if                  pass                

- - - -

This list is missing True, False, and None.

----------
assignee: docs at python
components: Documentation
messages: 134440
nosy: Carl.M.Johnson, docs at python
priority: normal
severity: normal
status: open
title: help("keywords") returns incomplete list of keywords
versions: Python 3.2

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

From report at bugs.python.org  Tue Apr 26 04:00:26 2011
From: report at bugs.python.org (Chris Rebert)
Date: Tue, 26 Apr 2011 02:00:26 +0000
Subject: [docs] [issue11926] help("keywords") returns incomplete list of
	keywords
In-Reply-To: <1303782960.65.0.80653815306.issue11926@psf.upfronthosting.co.za>
Message-ID: <1303783226.55.0.00369473475907.issue11926@psf.upfronthosting.co.za>


Changes by Chris Rebert <pybugs at rebertia.com>:


----------
nosy: +cvrebert

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

From report at bugs.python.org  Tue Apr 26 04:03:55 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Tue, 26 Apr 2011 02:03:55 +0000
Subject: [docs] [issue11926] help("keywords") returns incomplete list of
	keywords
In-Reply-To: <1303782960.65.0.80653815306.issue11926@psf.upfronthosting.co.za>
Message-ID: <1303783435.29.0.491442975979.issue11926@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

True, False and None are also included in keyword.kwlist:
>>> keyword.kwlist
['False', 'None', 'True', 'and', 'as', 'assert', 'break', 'class', 'continue', 'def', 'del', 'elif', 'else', 'except', 'finally', 'for', 'from', 'global', 'if', 'import', 'in', 'is', 'lambda', 'nonlocal', 'not', 'or', 'pass', 'raise', 'return', 'try', 'while', 'with', 'yield']

The help() is also missing for 'None' and 'False', but works for 'True':

>>> help('None')
no Python documentation found for 'None'
>>> help('False')
no Python documentation found for 'False'
>>> help('True')
Help on bool object:

True = class bool(int)
 |  bool(x) -> bool
 ...

On 3.3 it's the same.

----------
nosy: +ezio.melotti
stage:  -> needs patch
versions: +Python 3.3

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

From nneonneo at gmail.com  Thu Apr 14 03:42:47 2011
From: nneonneo at gmail.com (Robert Xiao)
Date: Wed, 13 Apr 2011 21:42:47 -0400
Subject: [docs] Wrong method signature for Py_AddPendingCall
Message-ID: <BANLkTimkCwui+ro3JoYB1ZQpGYyvD6XDeA@mail.gmail.com>

On the page http://docs.python.org/py3k/c-api/init.html#asynchronous-notifications,
the method signature for Py_AddPendingCall is incorrect.

It reads
void Py_AddPendingCall(int (*func)(void *, void *arg))
when it should correctly read
int Py_AddPendingCall(int (*func)(void *), void *arg)

(the return type and the arguments are incorrectly listed).

Robert

From kastur at gmail.com  Thu Apr 14 05:15:18 2011
From: kastur at gmail.com (Kasturi R)
Date: Wed, 13 Apr 2011 23:15:18 -0400
Subject: [docs] groupindex should be groupdict in dict docs
Message-ID: <BANLkTimORDWNyfaqTs7JhVZZphZ4AR3nBw@mail.gmail.com>

http://docs.python.org/library/re.html#regular-expression-objects

/s/groupindex/groupdict

Thanks!
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20110413/9e9c30a4/attachment-0001.html>

From frallain at gmail.com  Thu Apr 14 14:09:32 2011
From: frallain at gmail.com (=?ISO-8859-1?Q?Fran=E7ois_ALLAIN?=)
Date: Thu, 14 Apr 2011 14:09:32 +0200
Subject: [docs] Addition of a very useful link about encodings
Message-ID: <BANLkTi=QmC8+sJZ7MLt8Jq0m1q8sY2Zwzw@mail.gmail.com>

Hello,

I would like to add this link at this page of the documentation
<http://docs.python.org/howto/unicode>:

http://sebsauvage.net/python/snyppets/index.html#unicode , this is not so
clear in the HOWTO how to deal efficiently with all these encoding problems.

Hope you will agree on this point,

Best regards,


Fran?ois ALLAIN

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

From ilkerargin1989 at gmail.com  Mon Apr 18 16:54:29 2011
From: ilkerargin1989 at gmail.com (=?ISO-8859-9?Q?=DDlker_Arg=FDn?=)
Date: Mon, 18 Apr 2011 17:54:29 +0300
Subject: [docs] Suggest for documentation
Message-ID: <BANLkTinHft5=hEsxrSvM3GkO+5M=DYLxmQ@mail.gmail.com>

Hi,
The documentation is very informative. However, I can not find the return
values of methods( for example: list methods ) in the documentation. It
would be a better documentation if you added them to the documentation.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20110418/8da8a2bc/attachment-0001.html>

From johnhall2.0 at gmail.com  Tue Apr 19 07:25:07 2011
From: johnhall2.0 at gmail.com (John Hall)
Date: Tue, 19 Apr 2011 01:25:07 -0400
Subject: [docs] Socket server example fails on second and sucessive runs.
 Please set SO_REUSEADDR flag.
Message-ID: <BANLkTik0Hq0xLe0+-9YD6+g4U5cU-i6i=w@mail.gmail.com>

Problem:
The sockets example runs once because but fails on successive runs because a
socket option flag that allows the port number to be readily reused again
after the program closed is not set.
http://docs.python.org/library/socket.html#example

Solution:
insert
s.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)

In between the following lines in the first example. Numbers
are approximate doc source line numbers

869  s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
870  s.bind((HOST, PORT))

and in all other server examples following socket creation prior to a call
to s.bind

Argument in favor of the change. It's confusing to figure out why the
examples run once then fail on successive runs. It's not enough to run once.
Examples should run correctly several times. Users of documentation
frequently run examples  once, then run them again with some changes and
tweaks to figure out how they work. This example is designed to confuse the
user of the documentation who then must figure out why their code fails only
to discover it's because the example as written only runs correctly
once. With an automatic bug built into the code for the second time it's run
this adds unnecessary confusion and justifies the extra line of code.

Considerable evidence of frequent user confusion can be found in forums,
blogs and websites by searching for the error message caused by the problem.

Consideration:
It may not be universally portable. It works well on Linux and according to
documentation should work on windows but I did not verify that or research
other platforms.
http://msdn.microsoft.com/en-us/library/ms740532%28v=vs.85%29.aspx
If there are platforms where this line would fail then a comment or
conditional logic may be needed.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20110419/e7cce309/attachment-0001.html>

From andrew.george.hammond at gmail.com  Tue Apr 19 23:24:35 2011
From: andrew.george.hammond at gmail.com (Andrew Hammond)
Date: Tue, 19 Apr 2011 17:24:35 -0400
Subject: [docs] suggestion for
	http://docs.python.org/library/unittest.html#unittest.TestCase.assertRaises
In-Reply-To: <BANLkTikuNTxGm4eZv_UhGXcNpBnFeLSYcg@mail.gmail.com>
References: <AANLkTi=UU5PfbKmuCiMWnsme-0qW169mcCkdFjpv4z=q@mail.gmail.com>
	<BANLkTikuNTxGm4eZv_UhGXcNpBnFeLSYcg@mail.gmail.com>
Message-ID: <BANLkTi=U4O12sr4eN1U6Sb1U+seKVEBLgA@mail.gmail.com>

Yeah, that looks perfect.

On Tuesday, April 19, 2011, Sandro Tosi <sandro.tosi at gmail.com> wrote:
> Hi Andrew,
>
> On Wed, Mar 9, 2011 at 21:52, Andrew Hammond
> <andrew.george.hammond at gmail.com> wrote:
>> I suggest adding an example of using assertRaises to test a property:
>>
>> class MyObject(object):
>> ? ?@property
>> ? ?def myProperty():
>> ? ? ? ?raise Exception()
>>
>> self.assertRaises(Exception, getattr, myObject, myProperty)
>>
>> Rationale: the naive approach doesn't work and I spent a good half
>> hour figuring that out.
>
> can you confirm you want something like:
>
> class MyObject(object):
>  ? @property
>  ? def myProperty(self):
>  ? ? ? raise Exception()
>
> ...
> myObject = MyObject()
> self.assertRaises(Exception, getattr, myObject, 'myProperty')
>
> ?
>
> f.e:
>>>> getattr(myObject, 'myProperty')
> Traceback (most recent call last):
>  ?File "<stdin>", line 1, in <module>
>  ?File "<stdin>", line 4, in myProperty
> Exception
>
> Else I can't get it to work.
>
> Regards,
> --
> Sandro Tosi (aka morph, morpheus, matrixhasu)
> My website: http://matrixhasu.altervista.org/
> Me at Debian: http://wiki.debian.org/SandroTosi
>

From webmaster at opzijnbest.nl  Wed Apr 20 14:46:08 2011
From: webmaster at opzijnbest.nl (webmaster at opzijnbest.nl)
Date: Wed, 20 Apr 2011 14:46:08 +0200
Subject: [docs] Please can you check your updated link?
Message-ID: <E1QCWnI-0000LM-MQ@srv1.opzijnbest.nl>


				Dear webmaster,
				Our linkchecker found a 301 direct on your website:
				http://www.python.org/doc/2.3.4/lib/lib.html 
				which now goes to:
				http://docs.python.org/release/2.3.4/lib/lib.html
				
				As portal we offer our visitors an 'up-to-date' summary of information and links.
				Our program has changed your data into:
				http://docs.python.org/release/2.3.4/lib/lib.html
				
				Also our program tried to import your new title and description from your HTML.
				Most of the times that works o.k. but it does not succeed always for 100%.
				
				Therefore I'd like to ask you to check if it's o.k.
				
				These are the new data:
				URL: http://docs.python.org/release/2.3.4/lib/lib.html
				Title: 
				Python Library Reference
				Description: 
				Python Library Reference
				
				With your login you can easily correct it:
				http://www.opzijnbest.nl/links/ale.php?L=LG_python.org&P=PW_01152010_56NW
				(linkmanagment ->edit->save)
				
				When your automatic login is broken by the mailprogram:
				Manual login:
				http://www.opzijnbest.nl/links/ale.php
				username: LG_python.org
				password: PW_01152010_56NW
				(linkmanagment ->edit->save)

				Thank you very much and with best regards,
				Jeroen Tijssen 
				www.opzijnbest.nl 		
				
				This email is send to: docs at python.org		
				

From Clive.Darke at qa.com  Thu Apr 21 09:57:05 2011
From: Clive.Darke at qa.com (Darke, Clive)
Date: Thu, 21 Apr 2011 08:57:05 +0100
Subject: [docs] Wrong API name in Python 3.2 doc Python/C API Reference
 Manual
In-Reply-To: <BANLkTikr-GM3xyUm1juyZxPXsroTv0MEdw@mail.gmail.com>
References: <AQHL6Jaiizx+fTZUrEGIzee0zM2kGQ==>
	<3DF93BC1E6EB2E45AD12B4DBF431E372C9B02BCABA@CSUKLEEXMB01.corp.group.local>,
	<BANLkTikr-GM3xyUm1juyZxPXsroTv0MEdw@mail.gmail.com>
Message-ID: <3DF93BC1E6EB2E45AD12B4DBF431E372EBBA555A45@CSUKLEEXMB01.corp.group.local>

Thanks for the feedback!

Clive Darke
Product Consultant
QA
Vale House Pynes Hill Exeter Devon EX2 5AZ

Email      clive.darke at qa.com
Web        http://www.qa.com/
________________________________________
From: matrixhasu at gmail.com [matrixhasu at gmail.com] On Behalf Of Sandro Tosi [sandro.tosi at gmail.com]
Sent: 20 April 2011 19:35
To: Darke, Clive
Cc: docs at python.org
Subject: Re: [docs] Wrong API name in Python 3.2 doc Python/C API Reference Manual

Hi Clive,

On Tue, Mar 22, 2011 at 14:39, Darke, Clive <Clive.Darke at qa.com> wrote:
> Under "Initialization, Finalization, and Threads", "Non-Python created
> threads":
>
> "OS facilities such as posix_atfork() would need to be used "
>
> should be:
>
> "OS facilities such as pthread_atfork() would need to be used"
>
> (So far as I know there is no such function as posix_atfork())
> Forgive me if this report is not in the required format.

This has now been fixed: thanks!

Regards,
--
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

QA works with organisations to transform performance through learning. We are dedicated to making our clients more successful through the provision of world-class training services.
To find out more visit www.qa.com

The information transmitted is intended only for the person or entity to which it is addressed and may contain confidential and/or privileged material. Any review, retransmission, dissemination or other use of, or taking of any action in reliance upon, this information by persons or entities other than the intended recipient is prohibited. If you received this in error, please contact the sender and delete the material from any computer.

QA Ltd. Rath House, 55-65 Uxbridge Road, Slough, Berkshire,SL1 1SG.
QA Ltd. is a company registered in England with company registration number:2413137
Scanned by ICRITICAL

From david at martinoblum.com  Thu Apr 21 21:09:54 2011
From: david at martinoblum.com (David Blum)
Date: Thu, 21 Apr 2011 15:09:54 -0400
Subject: [docs] Tutorial 6.1.2
Message-ID: <C2500123-F614-4E98-9DF5-4FB76588114E@martinoblum.com>

This is not a report of a bug in Python, but a criticism of the  
phrasing in the documentation.

In Python Tutorial 6.1.2 (docs.python.org/py3k/tutorial/ 
modules.html#the-module-search-path) the second paragraph beginning  
with "Actually," is very alarming and disconcerting. It seems to mean  
that the preceding paragraph is not "actually" true and should be  
disregarded! I doubt that's what was intended, but I cannot quite  
understand just what the intended meaning was. How do these two  
paragraphs relate to one another? Are they both true? Is each one  
only partially true? Is there supposed to be some way of combining or  
synthesizing them into one coherent explanation? If so, it is not  
adequately communicated by the word "actually".

From mesabon at gmail.com  Fri Apr 22 17:42:02 2011
From: mesabon at gmail.com (Sabon Me)
Date: Fri, 22 Apr 2011 17:42:02 +0200
Subject: [docs] bug report: can't paste in IDLE2.7
Message-ID: <F64A2AD2-F9E3-4829-985F-4931646050AC@gmail.com>

Hi,

I'm using Python 2.7 on my Mac OSX 10.6. I just installed from this link: http://www.python.org/ftp/python/2.7.1/python-2.7.1-macosx10.6.dmg

The problem is: If I start IDLE, I can't use cmd-V to paste: whenever I use cmd-V, the IDLE goes dead and is not responding at all, then I have to "force quit" the IDLE process using activity monitor. This is very annoying. Hope that you guys can fix soon!

Keep doing good work!

FN

From drew at rdd.name  Sat Apr 23 11:42:09 2011
From: drew at rdd.name (R. Drew Davis)
Date: Sat, 23 Apr 2011 05:42:09 -0400
Subject: [docs] Bad link to Ousterhout paper
Message-ID: <1303551729.2103.12.camel@drew-laptop>

On http://docs.python.org/howto/advocacy.html in the references section,
there's a link for Ousterhout's scripting paper.   As given,

http://home.pacbell.net/ouster/scripting.html

the link doesn't work.   I guess the page moved.   The paper can now be
found at:

http://www.tcl.tk/doc/scripting.html

Please fix the link.

Thanks.

Drew


From abcdenis at gmail.com  Mon Apr 25 10:31:42 2011
From: abcdenis at gmail.com (Denis Denisov)
Date: Mon, 25 Apr 2011 12:31:42 +0400
Subject: [docs] PEP8 conventions in documentation
Message-ID: <BANLkTi=_aprTKcxJpNuYmGZ-jFrybw7wHQ@mail.gmail.com>

Hi,

I've found a lot of PEP8 inconsistencies in datetime documentation:
http://docs.python.org/py3k/library/datetime.html?highlight=datetime#datetime

class FixedOffset(tzinfo):
    """Fixed offset in minutes east from UTC."""

    def __init__(self, offset, name):

        self.__offset = timedelta(minutes = offset) # <-- shall be:
minutes=offset

        self.__name = name

It might be a good idea to pass code samples through some sort of code
verificator (pylint).

Regards,
Denis
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20110425/f33d8c86/attachment.html>

From varghese85 at gmail.com  Mon Apr 25 15:16:00 2011
From: varghese85 at gmail.com (Matt | Varghese Mathew)
Date: Mon, 25 Apr 2011 08:16:00 -0500
Subject: [docs] Large print / small paper size (maybe A5) python docs.
In-Reply-To: <BANLkTincK7qwAt9Bz7GiQn5PdBQ2WLvOBw@mail.gmail.com>
References: <BANLkTin9F9NVk0-AcD7Saydok+udMMbS=g@mail.gmail.com>
	<BANLkTimfhOK5ys2cWsgivZqTycUUysARVA@mail.gmail.com>
	<BANLkTincK7qwAt9Bz7GiQn5PdBQ2WLvOBw@mail.gmail.com>
Message-ID: <BANLkTi=bJHc4StTNvCKKM8K-5anHK-QJBQ@mail.gmail.com>

I have a Kindle 3, and I personally have taken to getting A5 sized pdfs
(printing as pdfs off project gutenberg etc) and reading them rather than
using the epub/mobi formats primarily because it's nice to have a page
number and a very conveniently portable format. But that's just one thought.

On Mon, Apr 25, 2011 at 5:40 AM, Sandro Tosi <sandro.tosi at gmail.com> wrote:

> On Wed, Apr 13, 2011 at 21:21, Fred Drake <fdrake at acm.org> wrote:
> > On Wed, Apr 13, 2011 at 11:22 AM, Matt | Varghese Mathew
> > <varghese85 at gmail.com> wrote:
> >> Would it be possible to release large print / small paper size python
> docs?
> >> Would work well with something like a kindle or many tablets.
> >> The A4 / US letter sizes make the print too tiny on a kindle.
> >
> > I think there's a plan in the works for an epub or mobi format
> > version; this should alleviate the pain of using the letter-size PDF
> > version on such devices.
>
> Indeed: 3.2 was released with an EPUB documentation file available,
> but AFAIK Kindle only support MOBI format, and so we need to write a
> Sphinx plugin to otuput documentation in MOBI format too; does someone
> volunteer for that? :)
>
> Cheers,
> --
> Sandro Tosi (aka morph, morpheus, matrixhasu)
> My website: http://matrixhasu.altervista.org/
> Me at Debian: http://wiki.debian.org/SandroTosi
>



-- 
Matt | Varghese Mathew
M.S. Computer Sciences (UW-Madison,2010)
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20110425/b537b28e/attachment.html>

From sandro.tosi at gmail.com  Tue Apr 26 14:20:10 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Tue, 26 Apr 2011 14:20:10 +0200
Subject: [docs] bug report: can't paste in IDLE2.7
In-Reply-To: <F64A2AD2-F9E3-4829-985F-4931646050AC@gmail.com>
References: <F64A2AD2-F9E3-4829-985F-4931646050AC@gmail.com>
Message-ID: <BANLkTinEJ_-xFkF-046R5DSRH4Ni2bpdJg@mail.gmail.com>

Hello Sabon,
this is not a bug reporting mailing list, as it's about the
documentation provided by cpython.

On Fri, Apr 22, 2011 at 17:42, Sabon Me <mesabon at gmail.com> wrote:
> Hi,
>
> I'm using Python 2.7 on my Mac OSX 10.6. I just installed from this link: http://www.python.org/ftp/python/2.7.1/python-2.7.1-macosx10.6.dmg
>
> The problem is: If I start IDLE, I can't use cmd-V to paste: whenever I use cmd-V, the IDLE goes dead and is not responding at all, then I have to "force quit" the IDLE process using activity monitor. This is very annoying. Hope that you guys can fix soon!

My suggest is to contact a user support forum about mac os, and ask
further guidance there. If it's fails, you can try a more specific
python forum, like python-list .

Regards,
-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

From report at bugs.python.org  Tue Apr 26 14:46:33 2011
From: report at bugs.python.org (Sijin Joseph)
Date: Tue, 26 Apr 2011 12:46:33 +0000
Subject: [docs] [issue11926] help("keywords") returns incomplete list of
	keywords
In-Reply-To: <1303782960.65.0.80653815306.issue11926@psf.upfronthosting.co.za>
Message-ID: <1303821993.24.0.24817028973.issue11926@psf.upfronthosting.co.za>


Sijin Joseph <sijinjoseph at gmail.com> added the comment:

Should True, False and None be keywords? Technically True and False are objects of type bool, in fact the only objects of that type allowed. And None is a specially designated object as well.

P.S: Can anyone point me to where the help function is defined in the source?

----------
nosy: +sijinjoseph

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

From report at bugs.python.org  Tue Apr 26 14:50:23 2011
From: report at bugs.python.org (Sijin Joseph)
Date: Tue, 26 Apr 2011 12:50:23 +0000
Subject: [docs] [issue11926] help("keywords") returns incomplete list of
	keywords
In-Reply-To: <1303782960.65.0.80653815306.issue11926@psf.upfronthosting.co.za>
Message-ID: <1303822223.09.0.806201079476.issue11926@psf.upfronthosting.co.za>


Sijin Joseph <sijinjoseph at gmail.com> added the comment:

@Ezio - help(True), help(False) and help(None) all return the correct documentation for me using latest trunk. I think the quotes around True, False and None might be throwing things off in your case.

----------

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

From report at bugs.python.org  Tue Apr 26 20:19:19 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Tue, 26 Apr 2011 18:19:19 +0000
Subject: [docs] [issue11929] Improve usage of PEP8 in Docs/includes/*
In-Reply-To: <1303841958.69.0.324750983113.issue11929@psf.upfronthosting.co.za>
Message-ID: <1303841958.69.0.324750983113.issue11929@psf.upfronthosting.co.za>


New submission from Sandro Tosi <sandro.tosi at gmail.com>:

Following up http://mail.python.org/pipermail/docs/2011-April/004032.html I made a run of pep8 on Doc/includes/ py files.

i've prepared a patch against default; if it's considered worth I can prepare patches for the other branches (for sure 2.7 needs a different patch, and probably also 3.1).

----------
assignee: docs at python
components: Documentation
files: pep8_doc_includes.patch
keywords: patch
messages: 134486
nosy: docs at python, sandro.tosi
priority: normal
severity: normal
stage: patch review
status: open
title: Improve usage of PEP8 in Docs/includes/*
versions: Python 3.3
Added file: http://bugs.python.org/file21784/pep8_doc_includes.patch

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

From report at bugs.python.org  Tue Apr 26 20:47:10 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Tue, 26 Apr 2011 18:47:10 +0000
Subject: [docs] [issue11929] Improve usage of PEP8 in Docs/includes/*
In-Reply-To: <1303841958.69.0.324750983113.issue11929@psf.upfronthosting.co.za>
Message-ID: <1303843630.24.0.859434660933.issue11929@psf.upfronthosting.co.za>


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

IMO, this is a complete waste of time and much of the code doesn't actually read any better afterwards.  Some of the mathematical expressions look worse.

There may be some merit to splitting the imports but that isn't worth much either, perhaps not enough to warrant trouncing the version control history on those lines.

----------
nosy: +rhettinger
priority: normal -> low

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

From sandro.tosi at gmail.com  Tue Apr 26 20:51:08 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Tue, 26 Apr 2011 20:51:08 +0200
Subject: [docs] PEP8 conventions in documentation
In-Reply-To: <BANLkTi=_aprTKcxJpNuYmGZ-jFrybw7wHQ@mail.gmail.com>
References: <BANLkTi=_aprTKcxJpNuYmGZ-jFrybw7wHQ@mail.gmail.com>
Message-ID: <BANLkTin2sS8FX37n5Fifn5mngSLsJRSsxg@mail.gmail.com>

Hello Denis,

On Mon, Apr 25, 2011 at 10:31, Denis Denisov <abcdenis at gmail.com> wrote:
> Hi,
>
> I've found a lot of PEP8 inconsistencies in datetime documentation:

I opened http://bugs.python.org/issue11929 for that an the others example files.

Regards,
-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

From report at bugs.python.org  Tue Apr 26 20:53:37 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Tue, 26 Apr 2011 18:53:37 +0000
Subject: [docs] [issue11929] Improve usage of PEP8 in Docs/includes/*
In-Reply-To: <1303841958.69.0.324750983113.issue11929@psf.upfronthosting.co.za>
Message-ID: <1303844017.81.0.688394858321.issue11929@psf.upfronthosting.co.za>


Changes by Raymond Hettinger <raymond.hettinger at gmail.com>:


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

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

From report at bugs.python.org  Tue Apr 26 20:59:58 2011
From: report at bugs.python.org (Alexander Belopolsky)
Date: Tue, 26 Apr 2011 18:59:58 +0000
Subject: [docs] [issue11929] Improve usage of PEP8 in Docs/includes/*
In-Reply-To: <1303841958.69.0.324750983113.issue11929@psf.upfronthosting.co.za>
Message-ID: <1303844398.63.0.390725375331.issue11929@psf.upfronthosting.co.za>


Alexander Belopolsky <belopolsky at users.sourceforge.net> added the comment:

Another -1 from me.  Similar changes to inline examples in the docs have been rejected in the past for the same reasons as Raymond wrote.  See issue 4649.

----------
nosy: +belopolsky

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

From report at bugs.python.org  Tue Apr 26 21:18:28 2011
From: report at bugs.python.org (Alexander Belopolsky)
Date: Tue, 26 Apr 2011 19:18:28 +0000
Subject: [docs] [issue11929] Improve usage of PEP8 in Docs/includes/*
In-Reply-To: <1303841958.69.0.324750983113.issue11929@psf.upfronthosting.co.za>
Message-ID: <1303845507.94.0.805680134563.issue11929@psf.upfronthosting.co.za>


Alexander Belopolsky <belopolsky at users.sourceforge.net> added the comment:

On the other hand, I would be +0 for the tzinfo-examples fixes of the form:

foo(x=default) vs. foo(x = default)

(This was also the fix suggested on the ML.)

Overall, I think it is good to judicially point out to PEP 8 violations where fixes would improve readability, but mechanical reformatting is likely to be net loss.  I may fix tzinfo-examples next time I touch it.  With addition of timezone class in 3.3, this set of examples needs to be updated.

----------

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

From report at bugs.python.org  Tue Apr 26 21:32:23 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Tue, 26 Apr 2011 19:32:23 +0000
Subject: [docs] [issue11929] Improve usage of PEP8 in Docs/includes/*
In-Reply-To: <1303841958.69.0.324750983113.issue11929@psf.upfronthosting.co.za>
Message-ID: <1303846343.3.0.202330575343.issue11929@psf.upfronthosting.co.za>


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

> foo(x=default) vs. foo(x = default)

That's fine.  Most of the rest of it isn't.

----------

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

From report at bugs.python.org  Tue Apr 26 22:53:12 2011
From: report at bugs.python.org (Brian Curtin)
Date: Tue, 26 Apr 2011 20:53:12 +0000
Subject: [docs] [issue11834] wrong module installation dir on Windows
In-Reply-To: <1302605256.31.0.234550103785.issue11834@psf.upfronthosting.co.za>
Message-ID: <1303851192.72.0.611855752164.issue11834@psf.upfronthosting.co.za>


Changes by Brian Curtin <brian at python.org>:


----------
nosy: +brian.curtin

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

From report at bugs.python.org  Tue Apr 26 22:59:22 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Tue, 26 Apr 2011 20:59:22 +0000
Subject: [docs] [issue11929] Improve usage of PEP8 in Docs/includes/*
In-Reply-To: <1303841958.69.0.324750983113.issue11929@psf.upfronthosting.co.za>
Message-ID: <1303851562.58.0.351580359657.issue11929@psf.upfronthosting.co.za>


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

I put a few of these in (ones where it looked like readability was improved).

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

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

From report at bugs.python.org  Tue Apr 26 23:00:16 2011
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 26 Apr 2011 21:00:16 +0000
Subject: [docs] [issue11929] Improve usage of PEP8 in Docs/includes/*
In-Reply-To: <1303841958.69.0.324750983113.issue11929@psf.upfronthosting.co.za>
Message-ID: <E1QEpMk-00087f-OY@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 5e93c5cdc378 by Raymond Hettinger in branch '3.2':
Issue 11929: Minor whitespace clean-ups.
http://hg.python.org/cpython/rev/5e93c5cdc378

New changeset 89fcadbc49df by Raymond Hettinger in branch 'default':
Issue 11929: Minor whitespace clean-ups.
http://hg.python.org/cpython/rev/89fcadbc49df

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

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

From report at bugs.python.org  Wed Apr 27 00:06:27 2011
From: report at bugs.python.org (=?utf-8?q?Bo=C5=A1tjan_Mejak?=)
Date: Tue, 26 Apr 2011 22:06:27 +0000
Subject: [docs] [issue11931] Regular expression documentation patch
In-Reply-To: <1303855586.52.0.604026571441.issue11931@psf.upfronthosting.co.za>
Message-ID: <1303855586.52.0.604026571441.issue11931@psf.upfronthosting.co.za>


New submission from Bo?tjan Mejak <bostjan.mejak at gmail.com>:

I have read and fixed the regular expression documentation and made a patch. Ezio, please review it and apply it. Thanks.

----------
assignee: docs at python
components: Documentation
files: re.patch
keywords: patch
messages: 134506
nosy: Retro, docs at python, ezio.melotti
priority: normal
severity: normal
status: open
title: Regular expression documentation patch
versions: Python 2.7, Python 3.1, Python 3.2, Python 3.3
Added file: http://bugs.python.org/file21787/re.patch

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

From report at bugs.python.org  Wed Apr 27 00:32:42 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Tue, 26 Apr 2011 22:32:42 +0000
Subject: [docs] [issue11931] Regular expression documentation patch
In-Reply-To: <1303855586.52.0.604026571441.issue11931@psf.upfronthosting.co.za>
Message-ID: <1303857162.43.0.216523728905.issue11931@psf.upfronthosting.co.za>


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

The section heads should remain in title case.

The colon in the octal escape section should remain, but the "If" following it should be lower cased.

"Phonebook" should remain a single word.

"vs" is fine without the period in a section head.

It would be better to replace all of the "e.g." and "i.e" with "for example" and "such as".

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

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

From report at bugs.python.org  Wed Apr 27 00:38:07 2011
From: report at bugs.python.org (=?utf-8?q?Bo=C5=A1tjan_Mejak?=)
Date: Tue, 26 Apr 2011 22:38:07 +0000
Subject: [docs] [issue11931] Regular expression documentation patch
In-Reply-To: <1303855586.52.0.604026571441.issue11931@psf.upfronthosting.co.za>
Message-ID: <1303857487.6.0.81507399063.issue11931@psf.upfronthosting.co.za>


Bo?tjan Mejak <bostjan.mejak at gmail.com> added the comment:

Raymond, what about the title "search() vs. match()"? There is a dot there! Please add the dot where I added it. Or remove it here as well. Also, "Checking For a Pair" is "Checking for a Pair". The word "for" must be lowercase.

----------

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

From report at bugs.python.org  Wed Apr 27 00:53:36 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Tue, 26 Apr 2011 22:53:36 +0000
Subject: [docs] [issue11931] Regular expression documentation patch
In-Reply-To: <1303855586.52.0.604026571441.issue11931@psf.upfronthosting.co.za>
Message-ID: <1303858416.51.0.677894816815.issue11931@psf.upfronthosting.co.za>


Changes by Raymond Hettinger <raymond.hettinger at gmail.com>:


----------
assignee: docs at python -> rhettinger
priority: normal -> low

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

From report at bugs.python.org  Wed Apr 27 00:57:14 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Tue, 26 Apr 2011 22:57:14 +0000
Subject: [docs] [issue11931] Regular expression documentation patch
In-Reply-To: <1303855586.52.0.604026571441.issue11931@psf.upfronthosting.co.za>
Message-ID: <1303858634.0.0.891530222946.issue11931@psf.upfronthosting.co.za>


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

I'll do these fix-ups but wish you would shift your focus to making substantive changes.  You're wasting developer time.

----------

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

From report at bugs.python.org  Wed Apr 27 02:54:15 2011
From: report at bugs.python.org (Mark Mc Mahon)
Date: Wed, 27 Apr 2011 00:54:15 +0000
Subject: [docs] [issue11834] wrong module installation dir on Windows
In-Reply-To: <1302605256.31.0.234550103785.issue11834@psf.upfronthosting.co.za>
Message-ID: <1303865655.17.0.843422308314.issue11834@psf.upfronthosting.co.za>


Mark Mc Mahon <mtnbikingmark at gmail.com> added the comment:

Reviewing the patch (issue133572.py33.patch):
You have used forward slashes for the first change - but back slashes for the others. I see that other places in the existing docs use back slashes when referring to windows paths.

I have never used the --prefix option - but I am surprised that it would install scripts to prefix\Lib\site-packages (without the prefix option scripts are installed in pythondir\Scripts.

Maybe installing something like grin/pylint/etc which has an executable script is a way to verify?

----------
nosy: +markm

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

From report at bugs.python.org  Wed Apr 27 04:17:05 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Wed, 27 Apr 2011 02:17:05 +0000
Subject: [docs] [issue11926] help("keywords") returns incomplete list of
	keywords
In-Reply-To: <1303782960.65.0.80653815306.issue11926@psf.upfronthosting.co.za>
Message-ID: <1303870625.22.0.635869550977.issue11926@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

This can be fixed by adding 'False', 'None', and 'True' to the Helper.keywords dict in Lib/pydoc.py.  I'm not sure what the topic for these should be though.  True/False/None are documented in the "built-in constants" section[0] of the doc.  An alternative might be to point to 'bool'[1] for True/False or just show the same help of help(True/False/None) (without quotes).

[0]: http://docs.python.org/dev/py3k/library/constants.html#built-in-constants
[1]: http://docs.python.org/dev/py3k/library/functions.html#bool

----------

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

From report at bugs.python.org  Wed Apr 27 09:50:32 2011
From: report at bugs.python.org (Tim Golden)
Date: Wed, 27 Apr 2011 07:50:32 +0000
Subject: [docs] [issue11922] Add General Index to Windows .chm help file
	Contents
In-Reply-To: <1303752107.55.0.594682028964.issue11922@psf.upfronthosting.co.za>
Message-ID: <4DB7CAC2.8040806@timgolden.me.uk>


Tim Golden <mail at timgolden.me.uk> added the comment:

I can't say I'd object as such, but the [Index] tab already
contains the items in the General Index and is arguably the
killer feature of the CHM in any case.

----------
nosy: +tim.golden

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

From report at bugs.python.org  Wed Apr 27 12:04:55 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 27 Apr 2011 10:04:55 +0000
Subject: [docs] [issue10318] "make altinstall" installs many files with
	incorrect	shebangs
In-Reply-To: <1288926610.35.0.932494150274.issue10318@psf.upfronthosting.co.za>
Message-ID: <1303898695.39.0.84003869301.issue10318@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

> There are a lot of examples that use a bare ?python?; changing all of
> those would cause merging pains.

I?ve changed my mind.  Given the python/python2/python3 drama with distributions, I now think that we should use ?python3? in the 3.x docs.  Merging is not hard.

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

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

From report at bugs.python.org  Wed Apr 27 12:14:37 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 27 Apr 2011 10:14:37 +0000
Subject: [docs] [issue11924] Pickle and copyreg modules don't document the
	interface
In-Reply-To: <1303766863.75.0.154822649898.issue11924@psf.upfronthosting.co.za>
Message-ID: <1303899277.98.0.940655562676.issue11924@psf.upfronthosting.co.za>


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


----------
components: +Documentation
nosy: +eric.araujo
stage:  -> needs patch
versions: +Python 3.1

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

From report at bugs.python.org  Wed Apr 27 12:23:44 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 27 Apr 2011 10:23:44 +0000
Subject: [docs] [issue11926] help("keywords") returns incomplete list of
	keywords
In-Reply-To: <1303782960.65.0.80653815306.issue11926@psf.upfronthosting.co.za>
Message-ID: <1303899824.04.0.675339241267.issue11926@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

True and False are keywords in 3.x for the parser (IIUC), even though they?re still instances of bool.

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

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

From report at bugs.python.org  Wed Apr 27 12:24:27 2011
From: report at bugs.python.org (Xuanji Li)
Date: Wed, 27 Apr 2011 10:24:27 +0000
Subject: [docs] [issue9938] Documentation for argparse interactive use
In-Reply-To: <1285338690.84.0.283413950067.issue9938@psf.upfronthosting.co.za>
Message-ID: <1303899867.28.0.142696158033.issue9938@psf.upfronthosting.co.za>


Xuanji Li <xuanji at gmail.com> added the comment:

I don't think it's best to create a new subclass to throw an ArgumentParserExit exception; if I read the stack trace I'd see that an ArgumentError was thrown, then caught, then an ArgumentParserExit was thrown, which IMHO is confusing. In the current design, parse_known_errors catches an ArgumentError and then exits. I propose that the user be optionally allowed to turn off the handling of ArgumentError and to handle it himself instead through an exit_on_argument_error flag. 

Attached patch does this. Also I think this issue falls under component 'Lib' too.

----------
components: +Library (Lib)
keywords: +patch
Added file: http://bugs.python.org/file21793/issue9938.patch

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

From report at bugs.python.org  Wed Apr 27 14:19:34 2011
From: report at bugs.python.org (Nick Coghlan)
Date: Wed, 27 Apr 2011 12:19:34 +0000
Subject: [docs] [issue10912] PyObject_RichCompare differs in behaviour
	from	PyObject_RichCompareBool ;
	difference not noted in documentation
In-Reply-To: <1295053260.1.0.0634834443195.issue10912@psf.upfronthosting.co.za>
Message-ID: <1303906774.73.0.946669403282.issue10912@psf.upfronthosting.co.za>


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

Reopening, as a 2.7 backport of this would be a nice thing to have.

----------
assignee: rhettinger -> 
status: closed -> open
versions: +Python 2.7

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

From report at bugs.python.org  Wed Apr 27 16:51:38 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 27 Apr 2011 14:51:38 +0000
Subject: [docs] [issue9264] trace.py documentation is incomplete
In-Reply-To: <1279167085.71.0.92983376648.issue9264@psf.upfronthosting.co.za>
Message-ID: <1303915898.07.0.255113546359.issue9264@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

Nesting of class/method and class/data directives recommended in 584f9c213a6d.

----------

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

From report at bugs.python.org  Wed Apr 27 17:06:24 2011
From: report at bugs.python.org (R. David Murray)
Date: Wed, 27 Apr 2011 15:06:24 +0000
Subject: [docs] [issue11926] help("keywords") returns incomplete list of
	keywords
In-Reply-To: <1303782960.65.0.80653815306.issue11926@psf.upfronthosting.co.za>
Message-ID: <1303916784.68.0.952590904513.issue11926@psf.upfronthosting.co.za>


R. David Murray <rdmurray at bitdance.com> added the comment:

As part of fixing this we should add a unit test to pydoc that goes something like this:

  assertEqual(sorted(pydoc.Helper.keywords.keys())), sorted(keyword.kwlist))

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

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

From report at bugs.python.org  Wed Apr 27 18:14:36 2011
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 27 Apr 2011 16:14:36 +0000
Subject: [docs] [issue11670] configparser read_file now iterates over f,
	docs still say it calls readline
In-Reply-To: <1301047699.5.0.476245530251.issue11670@psf.upfronthosting.co.za>
Message-ID: <E1QF7Nq-0003dl-SJ@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 6f937d6369b6 by ?ukasz Langa in branch '3.2':
Closes #11670: configparser read_file now iterates over f.
http://hg.python.org/cpython/rev/6f937d6369b6

New changeset 9da06f771a57 by ?ukasz Langa in branch 'default':
Merged #11670 from 3.2
http://hg.python.org/cpython/rev/9da06f771a57

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

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

From report at bugs.python.org  Wed Apr 27 18:17:33 2011
From: report at bugs.python.org (=?utf-8?q?=C5=81ukasz_Langa?=)
Date: Wed, 27 Apr 2011 16:17:33 +0000
Subject: [docs] [issue11670] configparser read_file now iterates over f,
	docs still say it calls readline
In-Reply-To: <1301047699.5.0.476245530251.issue11670@psf.upfronthosting.co.za>
Message-ID: <1303921053.73.0.692162689883.issue11670@psf.upfronthosting.co.za>


?ukasz Langa <lukasz at langa.pl> added the comment:

Closed in http://hg.python.org/cpython/rev/6f937d6369b6.

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

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

From report at bugs.python.org  Wed Apr 27 19:08:01 2011
From: report at bugs.python.org (Bryce Verdier)
Date: Wed, 27 Apr 2011 17:08:01 +0000
Subject: [docs] [issue11834] wrong module installation dir on Windows
In-Reply-To: <1302605256.31.0.234550103785.issue11834@psf.upfronthosting.co.za>
Message-ID: <1303924081.22.0.301158598886.issue11834@psf.upfronthosting.co.za>


Bryce Verdier <bryceverdier at gmail.com> added the comment:

Ok, so after getting some off list help, I changed the defaults to what they should be. Also, Mark was right, "--install-scripts" generally puts things in pythondir\Scripts... as tested with pylint, mako, and some others.

I changed data back to Data... though I could no verify it. Even with --install-data, I couldn't seem to find a new Data directory. Maybe I was doing something wrong.

Anyway, here is the new patch.

----------
nosy:  -brian.curtin, markm
Added file: http://bugs.python.org/file21806/issue133572.py33.patch

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

From report at bugs.python.org  Wed Apr 27 22:04:31 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Wed, 27 Apr 2011 20:04:31 +0000
Subject: [docs] [issue11940] Howto/Advocacy - update the link to John
	Ousterhout paper
In-Reply-To: <1303934671.48.0.846798146708.issue11940@psf.upfronthosting.co.za>
Message-ID: <1303934671.48.0.846798146708.issue11940@psf.upfronthosting.co.za>


New submission from Sandro Tosi <sandro.tosi at gmail.com>:

Following up http://mail.python.org/pipermail/docs/2011-April/004031.html here's a patch to update the link to John Ousterhout paper. It can be applied on all active branches.

----------
assignee: docs at python
components: Documentation
files: howto_advocacy_ousterhout_link.patch
keywords: patch
messages: 134612
nosy: docs at python, sandro.tosi
priority: low
severity: normal
stage: patch review
status: open
title: Howto/Advocacy - update the link to John Ousterhout paper
versions: Python 2.7, Python 3.1, Python 3.2, Python 3.3
Added file: http://bugs.python.org/file21809/howto_advocacy_ousterhout_link.patch

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

From sandro.tosi at gmail.com  Wed Apr 27 22:05:04 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Wed, 27 Apr 2011 22:05:04 +0200
Subject: [docs] Bad link to Ousterhout paper
In-Reply-To: <1303551729.2103.12.camel@drew-laptop>
References: <1303551729.2103.12.camel@drew-laptop>
Message-ID: <BANLkTin-un_Hfr72Eqy9SyiZ9K+=Gfhc4w@mail.gmail.com>

Hello,

On Sat, Apr 23, 2011 at 11:42, R. Drew Davis <drew at rdd.name> wrote:
> On http://docs.python.org/howto/advocacy.html in the references section,
> there's a link for Ousterhout's scripting paper. ? As given,
>
> http://home.pacbell.net/ouster/scripting.html
>
> the link doesn't work. ? I guess the page moved. ? The paper can now be
> found at:
>
> http://www.tcl.tk/doc/scripting.html
>
> Please fix the link.

i've opened http://bugs.python.org/issue11940 to fix it.

Thanks,
-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

From report at bugs.python.org  Wed Apr 27 22:21:17 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Wed, 27 Apr 2011 20:21:17 +0000
Subject: [docs] [issue11922] Add General Index to Windows .chm help file
	Contents
In-Reply-To: <1303752107.55.0.594682028964.issue11922@psf.upfronthosting.co.za>
Message-ID: <1303935676.99.0.386048159756.issue11922@psf.upfronthosting.co.za>


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

I had not really noticed that the Index *was* the General Index. In trying it out, I discovered that double-clicking on entries with multiple links in the General Index, such as 'name,binding' with 7 links, brings up a sub-box with all seven.

So I will close this at least until I decide that I would really want the addition enough to help make the change.

----------
resolution:  -> later
status: open -> closed

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

From sandro.tosi at gmail.com  Wed Apr 27 22:36:48 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Wed, 27 Apr 2011 22:36:48 +0200
Subject: [docs] Wrong method signature for Py_AddPendingCall
In-Reply-To: <BANLkTimkCwui+ro3JoYB1ZQpGYyvD6XDeA@mail.gmail.com>
References: <BANLkTimkCwui+ro3JoYB1ZQpGYyvD6XDeA@mail.gmail.com>
Message-ID: <BANLkTik--8QdmxL+PEjqD4j1nQOpCS9X6A@mail.gmail.com>

Hi Robert,

On Thu, Apr 14, 2011 at 03:42, Robert Xiao <nneonneo at gmail.com> wrote:
> On the page http://docs.python.org/py3k/c-api/init.html#asynchronous-notifications,
> the method signature for Py_AddPendingCall is incorrect.
>
> It reads
> void Py_AddPendingCall(int (*func)(void *, void *arg))
> when it should correctly read
> int Py_AddPendingCall(int (*func)(void *), void *arg)

I see:

void Py_AddPendingCall(int (*func)(void *), void *arg)

on the same page you link above: can you please it works for you now?

Regards,
-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

From report at bugs.python.org  Wed Apr 27 22:55:00 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Wed, 27 Apr 2011 20:55:00 +0000
Subject: [docs] [issue11940] Howto/Advocacy - update the link to John
	Ousterhout paper
In-Reply-To: <1303934671.48.0.846798146708.issue11940@psf.upfronthosting.co.za>
Message-ID: <1303937700.45.0.792169837817.issue11940@psf.upfronthosting.co.za>


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

This looks good.  Thanks for the patch.

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

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

From report at bugs.python.org  Wed Apr 27 23:07:23 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Wed, 27 Apr 2011 21:07:23 +0000
Subject: [docs] [issue11942] Fix signature of Py_AddPendingCall
In-Reply-To: <1303938443.0.0.0267122808218.issue11942@psf.upfronthosting.co.za>
Message-ID: <1303938443.0.0.0267122808218.issue11942@psf.upfronthosting.co.za>


New submission from Sandro Tosi <sandro.tosi at gmail.com>:

Following up with http://mail.python.org/pipermail/docs/2011-April/004021.html here's a couple of patch (the first for 2.7/3.1, the other for 3.2/default) to fix the signature of Py_AddPendingCall (in particular the return type).

Adding in CC Ezio since he fixed issue11865.

----------
assignee: docs at python
components: Documentation
files: py_addpendingcall-py27.patch
keywords: patch
messages: 134620
nosy: docs at python, ezio.melotti, sandro.tosi
priority: normal
severity: normal
stage: patch review
status: open
title: Fix signature of Py_AddPendingCall
versions: Python 2.7, Python 3.1, Python 3.2, Python 3.3
Added file: http://bugs.python.org/file21813/py_addpendingcall-py27.patch

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

From report at bugs.python.org  Wed Apr 27 23:07:28 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Wed, 27 Apr 2011 21:07:28 +0000
Subject: [docs] [issue11942] Fix signature of Py_AddPendingCall
In-Reply-To: <1303938443.0.0.0267122808218.issue11942@psf.upfronthosting.co.za>
Message-ID: <1303938448.72.0.896567488925.issue11942@psf.upfronthosting.co.za>


Changes by Sandro Tosi <sandro.tosi at gmail.com>:


Added file: http://bugs.python.org/file21814/py_addpendingcall-py32.patch

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

From sandro.tosi at gmail.com  Wed Apr 27 23:08:58 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Wed, 27 Apr 2011 23:08:58 +0200
Subject: [docs] Wrong method signature for Py_AddPendingCall
In-Reply-To: <BANLkTimYFMTtHyh1KCoy3Hn_eK8a_5to4Q@mail.gmail.com>
References: <BANLkTimkCwui+ro3JoYB1ZQpGYyvD6XDeA@mail.gmail.com>
	<BANLkTik--8QdmxL+PEjqD4j1nQOpCS9X6A@mail.gmail.com>
	<BANLkTimYFMTtHyh1KCoy3Hn_eK8a_5to4Q@mail.gmail.com>
Message-ID: <BANLkTi=c+avheS-Any2uxQTtTGVOG8dGRQ@mail.gmail.com>

On Wed, Apr 27, 2011 at 22:45, Robert Xiao <nneonneo at gmail.com> wrote:
> The return value is incorrect; it says "void" when it should be "int".
>
> The function is defined here:
> http://hg.python.org/cpython/file/c8f283cd3e6e/Python/ceval.c#l489. As
> you can see, the return type is void.

Oh sorry I overlooked (get confused by parenthesis as fixed by
http://bugs.python.org/issue11865 in the meantime), opened
http://bugs.python.org/issue11942 to fix it.

Thanks,
-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

From report at bugs.python.org  Wed Apr 27 23:42:46 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Wed, 27 Apr 2011 21:42:46 +0000
Subject: [docs] [issue11926] help("keywords") returns incomplete list of
	keywords
In-Reply-To: <1303782960.65.0.80653815306.issue11926@psf.upfronthosting.co.za>
Message-ID: <1303940566.47.0.0693512121085.issue11926@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

+1

----------

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

From report at bugs.python.org  Wed Apr 27 23:54:01 2011
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 27 Apr 2011 21:54:01 +0000
Subject: [docs] [issue11942] Fix signature of Py_AddPendingCall
In-Reply-To: <1303938443.0.0.0267122808218.issue11942@psf.upfronthosting.co.za>
Message-ID: <E1QFCgI-0007GC-Rm@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 6739b9ab7ced by Ezio Melotti in branch '2.7':
#11942: Fix return type of Py_AddPendingCall. Patch by Sandro Tosi.
http://hg.python.org/cpython/rev/6739b9ab7ced

New changeset fd1f47a57ba2 by Ezio Melotti in branch '3.1':
#11942: Fix return type of Py_AddPendingCall. Patch by Sandro Tosi.
http://hg.python.org/cpython/rev/fd1f47a57ba2

New changeset 119c7219b1ac by Ezio Melotti in branch '3.2':
#11942: merge with 3.1.
http://hg.python.org/cpython/rev/119c7219b1ac

New changeset 1cdcd1a25025 by Ezio Melotti in branch 'default':
#11942: merge with 3.2.
http://hg.python.org/cpython/rev/1cdcd1a25025

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

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

From report at bugs.python.org  Wed Apr 27 23:54:44 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Wed, 27 Apr 2011 21:54:44 +0000
Subject: [docs] [issue11942] Fix signature of Py_AddPendingCall
In-Reply-To: <1303938443.0.0.0267122808218.issue11942@psf.upfronthosting.co.za>
Message-ID: <1303941284.6.0.0790126590696.issue11942@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

Fixed, thanks for the patch!

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

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

From report at bugs.python.org  Thu Apr 28 01:33:16 2011
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 27 Apr 2011 23:33:16 +0000
Subject: [docs] [issue11940] Howto/Advocacy - update the link to John
	Ousterhout paper
In-Reply-To: <1303934671.48.0.846798146708.issue11940@psf.upfronthosting.co.za>
Message-ID: <E1QFEEM-0005zs-GV@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 4c5babbf7a73 by Raymond Hettinger in branch '3.1':
Issue #11940: Update external link.
http://hg.python.org/cpython/rev/4c5babbf7a73

New changeset 08647ab0ead7 by Raymond Hettinger in branch '3.2':
Issue #11940: Update external link.
http://hg.python.org/cpython/rev/08647ab0ead7

New changeset 618642ba7551 by Raymond Hettinger in branch 'default':
Issue #11940: Update external link.
http://hg.python.org/cpython/rev/618642ba7551

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

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

From report at bugs.python.org  Thu Apr 28 01:34:17 2011
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 27 Apr 2011 23:34:17 +0000
Subject: [docs] [issue11940] Howto/Advocacy - update the link to John
	Ousterhout paper
In-Reply-To: <1303934671.48.0.846798146708.issue11940@psf.upfronthosting.co.za>
Message-ID: <E1QFEFM-000641-HC@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset eb7c4526ccbf by Raymond Hettinger in branch '2.7':
Issue #11940: Update external link.
http://hg.python.org/cpython/rev/eb7c4526ccbf

----------

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

From report at bugs.python.org  Thu Apr 28 01:34:56 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Wed, 27 Apr 2011 23:34:56 +0000
Subject: [docs] [issue11940] Howto/Advocacy - update the link to John
	Ousterhout paper
In-Reply-To: <1303934671.48.0.846798146708.issue11940@psf.upfronthosting.co.za>
Message-ID: <1303947296.52.0.34633927582.issue11940@psf.upfronthosting.co.za>


Changes by Raymond Hettinger <raymond.hettinger at gmail.com>:


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

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

From report at bugs.python.org  Thu Apr 28 02:12:48 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 28 Apr 2011 00:12:48 +0000
Subject: [docs] [issue11883] Call connect() before sending an email with
	smtplib
In-Reply-To: <1303246763.2.0.10135500331.issue11883@psf.upfronthosting.co.za>
Message-ID: <1303949568.2.0.639656532178.issue11883@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

I?d remove the ?Connect to the SMTP server? comment before ?s.connect()?.  It?s redundant, contrary to the other comment (which no doubt prompted you to add a comment too) ?Send the message via local SMTP server? which helpfully introduces the next lines of code.

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

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

From report at bugs.python.org  Thu Apr 28 02:20:25 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 28 Apr 2011 00:20:25 +0000
Subject: [docs] [issue11726] linecache becomes specific to Python scripts in
	Python 3
In-Reply-To: <1301566082.59.0.198488725536.issue11726@psf.upfronthosting.co.za>
Message-ID: <1303950025.85.0.532867606524.issue11726@psf.upfronthosting.co.za>


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


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

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

From merwok at netwok.org  Thu Apr 28 03:09:24 2011
From: merwok at netwok.org (=?UTF-8?B?w4lyaWMgQXJhdWpv?=)
Date: Thu, 28 Apr 2011 03:09:24 +0200
Subject: [docs] "knights of Ni" bug
In-Reply-To: <4DA35E9D.8030709@underhill.ca>
References: <4DA35E9D.8030709@underhill.ca>
Message-ID: <4DB8BE44.3040405@netwok.org>

Hi Martin,

About documentation links, see existing links to various version in the
left sidebar of the main page http://docs.python.org/ and request for
more links on http://bugs.python.org/issue8040

For a Python 3.2 tutorial, go to http://docs.python.org/py3k/tutorial/

Cheers

From report at bugs.python.org  Thu Apr 28 03:11:28 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 28 Apr 2011 01:11:28 +0000
Subject: [docs] [issue11762] Ast doc: warning and version number
In-Reply-To: <1301933761.05.0.937546235723.issue11762@psf.upfronthosting.co.za>
Message-ID: <1303953088.41.0.415660313875.issue11762@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

Please improve this rough phrasing: ?Check the value of *ast.__version__* to write version-specific code blocks if you need to work across versions.?

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

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

From report at bugs.python.org  Thu Apr 28 03:11:36 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 28 Apr 2011 01:11:36 +0000
Subject: [docs] [issue11762] Ast doc: warning and version number
In-Reply-To: <1301933761.05.0.937546235723.issue11762@psf.upfronthosting.co.za>
Message-ID: <1303953096.57.0.53995056495.issue11762@psf.upfronthosting.co.za>


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


----------
versions: +Python 3.1

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

From report at bugs.python.org  Thu Apr 28 04:20:30 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 28 Apr 2011 02:20:30 +0000
Subject: [docs] [issue11926] help("keywords") returns incomplete list of
	keywords
In-Reply-To: <1303782960.65.0.80653815306.issue11926@psf.upfronthosting.co.za>
Message-ID: <1303957230.86.0.438522962225.issue11926@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

Attached patch adds True/False/None to the list of keywords and a special-cased path to have help('True'/'False'/'None') return the same as help(True/False/None).  I also added tests and found out that nonlocal was missing too, so I added it to the list (the changes to Lib/pydoc_data/topics.py are not included in the patch -- use make pydoc-topics in Doc/ to see them).

----------
assignee: docs at python -> ezio.melotti
keywords: +needs review, patch
stage: needs patch -> patch review
versions: +Python 3.1
Added file: http://bugs.python.org/file21816/issue11926.diff

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

From report at bugs.python.org  Thu Apr 28 05:42:25 2011
From: report at bugs.python.org (Nick Coghlan)
Date: Thu, 28 Apr 2011 03:42:25 +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: <1303962145.0.0.00759154980454.issue11945@psf.upfronthosting.co.za>


New submission from Nick Coghlan <ncoghlan at gmail.com>:

The question of the way Python handles NaN came up again on python-dev recently. The current semantics have been assessed as a reasonable compromise, but a poorly explained and inconsistently implemented one.

Based on a suggestion from Terry Reedy [1] I propose that a new glossary entry be added for "Reflexive Equality":

"Part of the standard mathematical definition of equality is that it is reflexive, that is ``x is y`` necessarily implies that ``x == y``. This is an essential property that is relied upon when designing and implementing container classes such as ``list`` and ``dict``.

However, the IEEE754 committee defined the float Not_a_Number (NaN) values as being unequal with all others floats, including themselves. While this design choice violates the basic mathematical definition of equality, it is still considered desirable to be able to correctly implement IEEE754 floating point semantics, and those of similar types such as ``decimal.Decimal``, directly in Python.

Accordingly, Python makes the follow compromise in order to cope with types that use non-reflexive definitions of equality without breaking the invariants of container classes that rely on reflexive definitions of equality:

1. Direct equality comparisons involving ``NaN``, such as ``nan=float('NaN'); nan == nan``, follow the IEEE754 rule and return False (or True in the case of ``!=``). This rule applies to ``float`` and ``decimal.Decimal`` within the builtins and standard library.

2. Indirect comparisons conducted internally by container classes, such as ``x in someset`` or ``seq.count(x)`` or ``somedict[x]``, enforce reflexivity by using the expressions ``x is y or x == y`` and ``x is not y and x != y`` respectively rather than assuming that ``x == y`` and ``x != y`` will always respect the reflexivity requirement. This rule applies to all container types within the builtins and standard library that may contain values of arbitrary types.

Also see [1] for a more comprehensive theoretical discussion of this topic.

[1] http://bertrandmeyer.com/2010/02/06/reflexivity-and-other-pillars-of-civilization/"

Specific container methods that have currently been identified as relying on the reflexivity assumption are:
- __contains__() (for x in c: assert x in c)
- __eq__() (assert [x] == [x])
- __ne__() (assert not [x] != [x])
- index() (for x in c: assert 0 <= c.index(x) < len(c))
- count() (for x in c: assert c.count(x) > 0)

collections.Sequence and array.array (with the 'f' or 'd' type indicators) have already been identified as container classes in the standard library that fails to follow the second guideline and hence fail to correctly implement the above invariants in the presence of non-reflexive definitions of equality. They will be fixed as part of implementing this patch. Other container types that fail to correctly enforce reflexivity can be fixed as they are identified.

[1] http://mail.python.org/pipermail/python-dev/2011-April/110962.html

----------
assignee: docs at python
components: Documentation, Library (Lib)
messages: 134639
nosy: docs at python, ncoghlan
priority: normal
severity: normal
status: open
title: Adopt and document consistent semantics for handling NaN values in containers
type: behavior
versions: Python 2.7, Python 3.2, Python 3.3

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

From report at bugs.python.org  Thu Apr 28 05:50:39 2011
From: report at bugs.python.org (Nick Coghlan)
Date: Thu, 28 Apr 2011 03:50:39 +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: <1303962639.29.0.237718412796.issue11945@psf.upfronthosting.co.za>


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

Actually, based on the NumPy precedent [1], array.array should be fine as is. Since it uses raw C floats and doubles internally, rather than Python objects, there is no clear concept of "object identity" to use to enforce reflexivity.

[1] http://mail.python.org/pipermail/python-dev/2011-April/110987.html

----------

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

From report at bugs.python.org  Thu Apr 28 06:02:27 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 28 Apr 2011 04:02:27 +0000
Subject: [docs] [issue11926] help("keywords") returns incomplete list of
	keywords
In-Reply-To: <1303782960.65.0.80653815306.issue11926@psf.upfronthosting.co.za>
Message-ID: <1303963347.48.0.571453621732.issue11926@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

I asked about nonlocal in #9724.

Patch looks good (I has to repress a gut reaction ?eval is evil? :)

----------

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

From report at bugs.python.org  Thu Apr 28 06:59:51 2011
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 28 Apr 2011 04:59:51 +0000
Subject: [docs] [issue11926] help("keywords") returns incomplete list of
	keywords
In-Reply-To: <1303782960.65.0.80653815306.issue11926@psf.upfronthosting.co.za>
Message-ID: <E1QFJKN-0002gy-NY@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 99d5542399a1 by Ezio Melotti in branch '3.1':
#11926: add missing keywords to help("keywords").
http://hg.python.org/cpython/rev/99d5542399a1

New changeset 7b4c853aa07d by Ezio Melotti in branch '3.2':
#11926: merge with 3.1.
http://hg.python.org/cpython/rev/7b4c853aa07d

New changeset 0d8a6833f5be by Ezio Melotti in branch 'default':
#11926: merge with 3.2.
http://hg.python.org/cpython/rev/0d8a6833f5be

New changeset ffd83aeb0b67 by Ezio Melotti in branch '2.7':
Backport test from #11926.
http://hg.python.org/cpython/rev/ffd83aeb0b67

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

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

From report at bugs.python.org  Thu Apr 28 07:06:23 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 28 Apr 2011 05:06:23 +0000
Subject: [docs] [issue11926] help("keywords") returns incomplete list of
	keywords
In-Reply-To: <1303782960.65.0.80653815306.issue11926@psf.upfronthosting.co.za>
Message-ID: <1303967183.43.0.964522120578.issue11926@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

Fixed True/False/None in 3.1/3.2/3.3, nonlocal in 3.1 (it was already ok in 3.2/3.3), and backported tests on 2.7.  Thanks for the pointer to #9724.

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

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

From report at bugs.python.org  Thu Apr 28 07:32:54 2011
From: report at bugs.python.org (Glenn Linderman)
Date: Thu, 28 Apr 2011 05:32:54 +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: <1303968774.09.0.597738647828.issue11945@psf.upfronthosting.co.za>


Glenn Linderman <v+python at g.nevcal.com> added the comment:

Bertrand Meyer's exposition is flowery, and he is a learned man, but the basic argument he makes is:

Reflexivity of equality  is something that we expect for any data type, and it seems hard to justify that a value is not equal to itself. As to assignment, what good can it be if it does not make the target equal to the source value?  

The argument is flawed: now that NaN exists, and is not equal to itself in value, there should be, and need be, no expectation that assignment elsewhere should make the target equal to the source in value.  It can, and in Python, should, make them match in identity (is) but not in value (==, equality).

I laud the idea of adding to definition of reflexive equality to the glossary.  However, I think it is presently a bug that a list containing a NaN value compares equal to itself.  Yes, such a list should have the same identity (is), but should not be equal.

----------
nosy: +v+python

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

From report at bugs.python.org  Thu Apr 28 07:38:32 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 28 Apr 2011 05:38:32 +0000
Subject: [docs] [issue9724] help('nonlocal') missing
In-Reply-To: <1283264506.65.0.891353538251.issue9724@psf.upfronthosting.co.za>
Message-ID: <1303969112.06.0.622909657414.issue9724@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

I backported it to 3.1 as part of 99d5542399a1.

----------
nosy: +ezio.melotti
stage:  -> committed/rejected

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

From report at bugs.python.org  Thu Apr 28 08:21:27 2011
From: report at bugs.python.org (Alexander Belopolsky)
Date: Thu, 28 Apr 2011 06:21:27 +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: <1303971687.93.0.32783991787.issue11945@psf.upfronthosting.co.za>


Alexander Belopolsky <belopolsky at users.sourceforge.net> added the comment:

> I think it is presently a bug that a list containing
> a NaN value compares equal to itself. 

Moreover, it also compares equal to another list containing the same NaN:

>>> [nan] is [nan]
False
>>> [nan] == [nan]
True

Here is another case of is implies == optimization breaking NaN property in stdlib:

>>> import ctypes
>>> x = ctypes.c_double(nan)
>>> x == x
True

----------
nosy: +belopolsky

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

From report at bugs.python.org  Thu Apr 28 09:01:49 2011
From: report at bugs.python.org (Nick Coghlan)
Date: Thu, 28 Apr 2011 07:01:49 +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: <1303974109.28.0.0343646743138.issue11945@psf.upfronthosting.co.za>


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

The status quo works. Proposals to change it on theoretical grounds have a significantly higher bar to meet than proposals to simply document it clearly.

----------

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

From report at bugs.python.org  Thu Apr 28 09:07:14 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Thu, 28 Apr 2011 07:07:14 +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: <1303974434.75.0.27041184654.issue11945@psf.upfronthosting.co.za>


Changes by Raymond Hettinger <raymond.hettinger at gmail.com>:


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

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

From report at bugs.python.org  Thu Apr 28 09:16:34 2011
From: report at bugs.python.org (Alexander Belopolsky)
Date: Thu, 28 Apr 2011 07:16:34 +0000
Subject: [docs] [issue11945] Adopt and document consistent semantics for
	handling NaN	values in containers
In-Reply-To: <1303974109.28.0.0343646743138.issue11945@psf.upfronthosting.co.za>
Message-ID: <BANLkTi=4LRRp67+ZRW5QdQaorP9dBY=jPQ@mail.gmail.com>


Alexander Belopolsky <belopolsky at users.sourceforge.net> added the comment:

On Thu, Apr 28, 2011 at 3:01 AM, Nick Coghlan <report at bugs.python.org> wrote:
..
> The status quo works.

No it does not. I am yet to see a Python program that uses
non-reflexivity of NaN in a meaningful way.  What I've seen was either
programmers ignore it and write slightly buggy programs ("slightly"
because it is actually hard to produce a NaN in Python code) or they
add extra code to filter out NaN values before numbers are compared.

> Proposals to change it on theoretical grounds have a significantly higher bar to meet than proposals
> to simply document it clearly.

Documenting the status quo is necessary for any proposal to change.

----------

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

From report at bugs.python.org  Thu Apr 28 09:26:50 2011
From: report at bugs.python.org (Nick Coghlan)
Date: Thu, 28 Apr 2011 07:26:50 +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: <1303975610.29.0.536082648672.issue11945@psf.upfronthosting.co.za>


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

By "works" I merely meant that you can currently achieve both of the following:

1. Write fully conformant implementations of IEEE754 floating point types, including the non-reflexive NaN comparisons (keeping in mind that, as a value-based specification, "same payload" is the closest IEEE754 can get to "same object")

2. Explicitly force reflexivity when you need it, either by filtering out nonconformant values, or by checking identity before checking equality.

The "pure" equality-tests-are-always-reflexive approach advocated by Meyer rules out option 1. Given that one of the use cases for Python is to prototype algorithms that are later translated to C or C++, formally disallowing that use case would be problematic.

----------

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

From report at bugs.python.org  Thu Apr 28 09:40:08 2011
From: report at bugs.python.org (Glenn Linderman)
Date: Thu, 28 Apr 2011 07:40:08 +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: <1303976407.92.0.622817588638.issue11945@psf.upfronthosting.co.za>


Glenn Linderman <v+python at g.nevcal.com> added the comment:

Nick says (and later explains better what he meant): 
The status quo works. Proposals to change it on theoretical grounds have a significantly higher bar to meet than proposals to simply document it clearly.

I say:
What the status quo doesn't provide is containers that "work".  In this case what I mean by "work" is that equality of containers is based on value, and value comparisons, and accept and embrace non-reflexive equality.  It might be possible to implement alternate containers with these characteristics, but that requires significantly more effort than simply filtering values.

Nonetheless, I totally agree with msg134654, and agree that properly documenting the present implementation would be a great service to users of the present implementation.

----------

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

From report at bugs.python.org  Thu Apr 28 09:55:05 2011
From: report at bugs.python.org (Alexander Belopolsky)
Date: Thu, 28 Apr 2011 07:55:05 +0000
Subject: [docs] [issue11945] Adopt and document consistent semantics for
	handling NaN	values in containers
In-Reply-To: <1303975610.29.0.536082648672.issue11945@psf.upfronthosting.co.za>
Message-ID: <BANLkTikf18q7_zEdeVxx9i4bnD7ohqPyAA@mail.gmail.com>


Alexander Belopolsky <belopolsky at users.sourceforge.net> added the comment:

On Thu, Apr 28, 2011 at 3:26 AM, Nick Coghlan <report at bugs.python.org> wrote:
..
> 1. Write fully conformant implementations of IEEE754 floating point types, including the non-reflexive NaN comparisons
> (keeping in mind that, as a value-based specification, "same payload" is the closest IEEE754 can get to "same object")
>

If being "fully conformant" with various IEEE standards was a design
goal for Python, we would have leap seconds in the datetime module.
:-)

Python builtin float equality being reflexive does not in any way
inhibits anyone's ability to *write* a fully conforming
implementation.  In fact, if we ever get arithmetic operations
implemented for ctypes types, I would argue that c_double comparison
of c_double values would need to be changed to match C behavior.  (I
am +0 on changing that even without implementing arithmetics.)

I realize, however that by "status quo" you mean container operations
not calling __eq__ on identical objects.  I agree that this should not
change.  Making float comparison reflexive will actually make this
feature less controversial.

----------

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

From report at bugs.python.org  Thu Apr 28 12:03:14 2011
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 28 Apr 2011 10:03:14 +0000
Subject: [docs] [issue11670] configparser read_file now iterates over f,
	docs still say it calls readline
In-Reply-To: <1301047699.5.0.476245530251.issue11670@psf.upfronthosting.co.za>
Message-ID: <E1QFO40-0008JA-9x@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 1bbda00bbe78 by ?ukasz Langa in branch '3.2':
Style updates for the #11670 solution after post-commit review by Ezio Melotti:
http://hg.python.org/cpython/rev/1bbda00bbe78

New changeset 339cd1d9b21a by ?ukasz Langa in branch 'default':
Merged styling updates for #11670 from 3.2.
http://hg.python.org/cpython/rev/339cd1d9b21a

----------

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

From report at bugs.python.org  Thu Apr 28 13:08:56 2011
From: report at bugs.python.org (Mark Dickinson)
Date: Thu, 28 Apr 2011 11:08:56 +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: <1303988936.58.0.338300484899.issue11945@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Apr 28 14:36:51 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 28 Apr 2011 12:36:51 +0000
Subject: [docs] [issue11926] help("keywords") returns incomplete list of
	keywords
In-Reply-To: <1303782960.65.0.80653815306.issue11926@psf.upfronthosting.co.za>
Message-ID: <1303994211.68.0.479328685778.issue11926@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

Out of curiosity: Any reason you used a containment test with a list instead of a set (IMO more idiomatic, and in 3.2+ also optimized)?  I guess it?s to match the rest of the file, but using sets would not change any behavior.

----------

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

From report at bugs.python.org  Thu Apr 28 14:44:20 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 28 Apr 2011 12:44:20 +0000
Subject: [docs] [issue11926] help("keywords") returns incomplete list of
	keywords
In-Reply-To: <1303782960.65.0.80653815306.issue11926@psf.upfronthosting.co.za>
Message-ID: <1303994660.16.0.812247131256.issue11926@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

Good question. I considered using sets but then decided to use lists because they don't get rid of duplicates and would make the test fail in the (indeed unlikely) case that a keyword gets added twice (that's actually not possible in Test.keywords because it's a dict, but keyword.kwlist is a list and the implementation of either one could change at some point).
In any case it probably doesn't make much difference -- I just preferred to err on the safe side.

----------

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

From report at bugs.python.org  Thu Apr 28 14:52:46 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 28 Apr 2011 12:52:46 +0000
Subject: [docs] [issue11926] help("keywords") returns incomplete list of
	keywords
In-Reply-To: <1303782960.65.0.80653815306.issue11926@psf.upfronthosting.co.za>
Message-ID: <1303995166.2.0.664713677325.issue11926@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

I was too vague.  I referred only to ?if something in ['True', 'False', 'None']? in pydoc.py

----------

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

From merwok at netwok.org  Thu Apr 28 16:04:35 2011
From: merwok at netwok.org (=?UTF-8?B?w4lyaWMgQXJhdWpv?=)
Date: Thu, 28 Apr 2011 16:04:35 +0200
Subject: [docs] Suggested improvement to turtle module doc
In-Reply-To: <AANLkTi=NaHizmSgTQQfCKTihj_-Hpz33VY0gh=jimEo6@mail.gmail.com>
References: <4CDC7E34.5010605@netwok.org>
	<AANLkTi=NaHizmSgTQQfCKTihj_-Hpz33VY0gh=jimEo6@mail.gmail.com>
Message-ID: <4DB973F3.7000609@netwok.org>

Hi,

I was browsing through my ML archives and had an idea.  Context first:

> The turtle module provides both procedural and object-oriented
> interfaces.  In my opinion, beginners should start with the procedural
> interface and this is what is now used in the sidebar.  It is
> unfortunate that the manual uses "turtle" for both the name of the
> module and the name of the turtle instance used in OO examples.  Any
> suggestions on how to improve this are welcome.

What about using a first name for the Turtle instance, say zoe, and use
it in markup: zoe.forward(distance), zoe.right(angle), etc?

Regards

From report at bugs.python.org  Thu Apr 28 17:41:26 2011
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 28 Apr 2011 15:41:26 +0000
Subject: [docs] [issue11786] ConfigParser.[Raw]ConfigParser optionxform()
In-Reply-To: <1302110277.82.0.57770456199.issue11786@psf.upfronthosting.co.za>
Message-ID: <E1QFTLI-0005Ml-JM@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset c7ce67c9237a by ?ukasz Langa in branch '2.6':
Closes #11786: ConfigParser.[Raw]ConfigParser optionxform().
http://hg.python.org/cpython/rev/c7ce67c9237a

New changeset a6b772599594 by ?ukasz Langa in branch '2.7':
Merged solution for #11786 from 2.6
http://hg.python.org/cpython/rev/a6b772599594

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

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

From report at bugs.python.org  Thu Apr 28 17:42:31 2011
From: report at bugs.python.org (=?utf-8?q?=C5=81ukasz_Langa?=)
Date: Thu, 28 Apr 2011 15:42:31 +0000
Subject: [docs] [issue11786] ConfigParser.[Raw]ConfigParser optionxform()
In-Reply-To: <1302110277.82.0.57770456199.issue11786@psf.upfronthosting.co.za>
Message-ID: <1304005351.32.0.0269468290276.issue11786@psf.upfronthosting.co.za>


Changes by ?ukasz Langa <lukasz at langa.pl>:


----------
versions: +Python 2.6

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

From report at bugs.python.org  Thu Apr 28 19:18:31 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Thu, 28 Apr 2011 17:18:31 +0000
Subject: [docs] [issue11948] Tutorial/Modules - small fix to better clarify
	the	modules search path
In-Reply-To: <1304011111.24.0.834772686878.issue11948@psf.upfronthosting.co.za>
Message-ID: <1304011111.24.0.834772686878.issue11948@psf.upfronthosting.co.za>


New submission from Sandro Tosi <sandro.tosi at gmail.com>:

Following up http://mail.python.org/pipermail/docs/2011-April/004029.html here's a small patch (applicable on all the active branches) to "actually" :) connects the two paragraphs about modules search path.

----------
assignee: docs at python
components: Documentation
files: tutorial_modules_actually.patch
keywords: patch
messages: 134704
nosy: docs at python, sandro.tosi
priority: normal
severity: normal
stage: patch review
status: open
title: Tutorial/Modules - small fix to better clarify the modules search path
versions: Python 2.7, Python 3.1, Python 3.2, Python 3.3
Added file: http://bugs.python.org/file21826/tutorial_modules_actually.patch

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

From sandro.tosi at gmail.com  Thu Apr 28 19:19:09 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Thu, 28 Apr 2011 19:19:09 +0200
Subject: [docs] Tutorial 6.1.2
In-Reply-To: <C2500123-F614-4E98-9DF5-4FB76588114E@martinoblum.com>
References: <C2500123-F614-4E98-9DF5-4FB76588114E@martinoblum.com>
Message-ID: <BANLkTimXBfdSkScpM=aTakxNvQ=g6oY41A@mail.gmail.com>

Hello David,

On Thu, Apr 21, 2011 at 21:09, David Blum <david at martinoblum.com> wrote:
> This is not a report of a bug in Python, but a criticism of the phrasing in
> the documentation.
>
> In Python Tutorial 6.1.2
> (docs.python.org/py3k/tutorial/modules.html#the-module-search-path) the
> second paragraph beginning with "Actually," is very alarming and
> disconcerting. It seems to mean that the preceding paragraph is not
> "actually" true and should be disregarded! I doubt that's what was intended,
> but I cannot quite understand just what the intended meaning was. How do
> these two paragraphs relate to one another? Are they both true? Is each one
> only partially true? Is there supposed to be some way of combining or
> synthesizing them into one coherent explanation? If so, it is not adequately
> communicated by the word "actually".

I just opened http://bugs.python.org/issue11948 to fix it.

Thanks,
-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi

From report at bugs.python.org  Thu Apr 28 21:30:32 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Thu, 28 Apr 2011 19:30:32 +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: <1304019032.11.0.216492727708.issue11945@psf.upfronthosting.co.za>


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

To repeat concisely what I said on pydev list, I think Reference 5.9. Comparisons, which says

"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.".

needs 'be indentical or ' added before 'compare equal and ...'

"Mappings (dictionaries) compare equal if and only if they have the same (key, value) pairs."

may be ok, depending on how one interprets 'same (key, value) pairs'.

Alexander has opened a separate issue to change behavior in 3.3.

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

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

From report at bugs.python.org  Thu Apr 28 23:50:54 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Thu, 28 Apr 2011 21:50:54 +0000
Subject: [docs] [issue11948] Tutorial/Modules - small fix to better clarify
	the	modules search path
In-Reply-To: <1304011111.24.0.834772686878.issue11948@psf.upfronthosting.co.za>
Message-ID: <1304027454.41.0.522319540243.issue11948@psf.upfronthosting.co.za>


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

It would be better to drop the introductory phrase entirely.

----------
nosy: +rhettinger
priority: normal -> low

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

From report at bugs.python.org  Thu Apr 28 23:51:06 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 28 Apr 2011 21:51:06 +0000
Subject: [docs] [issue11926] help("keywords") returns incomplete list of
	keywords
In-Reply-To: <1303782960.65.0.80653815306.issue11926@psf.upfronthosting.co.za>
Message-ID: <1304027466.51.0.969377617505.issue11926@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

That's just because I'm used to Python 2 where the {} syntax for sets was not available.  I'll try to keep that in mind for the next time.

----------

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

From report at bugs.python.org  Fri Apr 29 00:27:48 2011
From: report at bugs.python.org (akira)
Date: Thu, 28 Apr 2011 22:27:48 +0000
Subject: [docs] [issue11952] typo in multiprocessing documentation: __main__
	method	should be replaced by __main__ module
In-Reply-To: <1304029668.08.0.895041183069.issue11952@psf.upfronthosting.co.za>
Message-ID: <1304029668.08.0.895041183069.issue11952@psf.upfronthosting.co.za>


New submission from akira <4kir4.1i at gmail.com>:

s/method/module/:

    Functionality within this package requires that the ``__main__`` method be
    importable by the children.

----------
assignee: docs at python
components: Documentation
messages: 134724
nosy: akira, docs at python
priority: normal
severity: normal
status: open
title: typo in multiprocessing documentation: __main__ method should be replaced by __main__ module
type: behavior
versions: Python 2.7, Python 3.1, Python 3.2, Python 3.3, Python 3.4

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

From report at bugs.python.org  Fri Apr 29 01:18:10 2011
From: report at bugs.python.org (Nick Coghlan)
Date: Thu, 28 Apr 2011 23:18:10 +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: <1304032690.64.0.27210825566.issue11945@psf.upfronthosting.co.za>


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

After further discussion on python-dev, it is clear that this identity checking behaviour handles more than just NaNs - it also allows containers to cope more gracefully with objects like NumPy arrays that make use of rich comparisons to return something other than simple True/False values for equality checks.

Also, since I neglected to mention it in the initial post, merely *adding* the glossary entry is just the first step. It then needs to be referenced from the appropriate points in the language and library reference.

----------

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

From report at bugs.python.org  Fri Apr 29 01:28:44 2011
From: report at bugs.python.org (Nick Coghlan)
Date: Thu, 28 Apr 2011 23:28:44 +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: <1304033324.0.0.686826699611.issue11945@psf.upfronthosting.co.za>


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

Scratch the first half of that last comment - Guido pointed out that false positives rear their ugly head almost immediately if you try to store rich comparison objects in other containers.

----------

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

From report at bugs.python.org  Fri Apr 29 06:13:24 2011
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 29 Apr 2011 04:13:24 +0000
Subject: [docs] [issue11952] typo in multiprocessing documentation: __main__
	method	should be replaced by __main__ module
In-Reply-To: <1304029668.08.0.895041183069.issue11952@psf.upfronthosting.co.za>
Message-ID: <E1QFf50-00026c-LV@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset ef9bccfe64de by Ezio Melotti in branch '2.7':
#11952: Fix typo in multiprocessing doc.
http://hg.python.org/cpython/rev/ef9bccfe64de

New changeset 1d3c5df88589 by Ezio Melotti in branch '3.1':
#11952: Fix typo in multiprocessing doc.
http://hg.python.org/cpython/rev/1d3c5df88589

New changeset 56c187b81d2b by Ezio Melotti in branch '3.2':
#11952: merge with 3.1.
http://hg.python.org/cpython/rev/56c187b81d2b

New changeset 8eb794bbb967 by Ezio Melotti in branch 'default':
#11952: merge with 3.2.
http://hg.python.org/cpython/rev/8eb794bbb967

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

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

From report at bugs.python.org  Fri Apr 29 06:14:36 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Fri, 29 Apr 2011 04:14:36 +0000
Subject: [docs] [issue11952] typo in multiprocessing documentation: __main__
	method	should be replaced by __main__ module
In-Reply-To: <1304029668.08.0.895041183069.issue11952@psf.upfronthosting.co.za>
Message-ID: <1304050476.37.0.687175833539.issue11952@psf.upfronthosting.co.za>


Ezio Melotti <ezio.melotti at gmail.com> added the comment:

Fixed, thanks for the report!

----------
assignee: docs at python -> ezio.melotti
nosy: +ezio.melotti
resolution:  -> fixed
stage:  -> committed/rejected
status: open -> closed
versions:  -Python 3.4

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

From report at bugs.python.org  Fri Apr 29 16:51:30 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 29 Apr 2011 14:51:30 +0000
Subject: [docs] [issue11786] ConfigParser.[Raw]ConfigParser optionxform()
In-Reply-To: <1302110277.82.0.57770456199.issue11786@psf.upfronthosting.co.za>
Message-ID: <1304088690.81.0.287416439716.issue11786@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

2.5 and 2.6 are in security mode.  Other bug fixes, build changes, documentation improvements, etc. should not go in these branches.  Your commit does not break anything, but for process clarity, please back it out.

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

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

From report at bugs.python.org  Fri Apr 29 19:12:43 2011
From: report at bugs.python.org (Daniel Urban)
Date: Fri, 29 Apr 2011 17:12:43 +0000
Subject: [docs] [issue11924] Pickle and copyreg modules don't document the
	interface
In-Reply-To: <1303766863.75.0.154822649898.issue11924@psf.upfronthosting.co.za>
Message-ID: <1304097163.8.0.382353909765.issue11924@psf.upfronthosting.co.za>


Changes by Daniel Urban <urban.dani+py at gmail.com>:


----------
nosy: +durban

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

From report at bugs.python.org  Fri Apr 29 19:13:19 2011
From: report at bugs.python.org (Daniel Urban)
Date: Fri, 29 Apr 2011 17:13:19 +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: <1304097199.34.0.0693688443945.issue11945@psf.upfronthosting.co.za>


Changes by Daniel Urban <urban.dani+py at gmail.com>:


----------
nosy: +durban

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

From report at bugs.python.org  Fri Apr 29 19:38:00 2011
From: report at bugs.python.org (=?utf-8?q?=C5=81ukasz_Langa?=)
Date: Fri, 29 Apr 2011 17:38:00 +0000
Subject: [docs] [issue11786] ConfigParser.[Raw]ConfigParser optionxform()
In-Reply-To: <1302110277.82.0.57770456199.issue11786@psf.upfronthosting.co.za>
Message-ID: <1304098680.17.0.342946807913.issue11786@psf.upfronthosting.co.za>


?ukasz Langa <lukasz at langa.pl> added the comment:

Sorry about that. Since I'm not technically touching the source code, I thought the security fixes restriction does not necessarily apply. Especially that my patch only updates what ends up here:

http://docs.python.org/release/2.6.6/library/configparser.html

----------

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

From report at bugs.python.org  Fri Apr 29 22:03:51 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Fri, 29 Apr 2011 20:03:51 +0000
Subject: [docs] [issue11948] Tutorial/Modules - small fix to better clarify
	the	modules search path
In-Reply-To: <1304011111.24.0.834772686878.issue11948@psf.upfronthosting.co.za>
Message-ID: <1304107431.25.0.486745152338.issue11948@psf.upfronthosting.co.za>


Sandro Tosi <sandro.tosi at gmail.com> added the comment:

Hi Raymond, thanks for looking into it! What do you think of this patch? I tried to save what I think was nice in the first paragraph and collapse it into the second one.

----------

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

From report at bugs.python.org  Fri Apr 29 22:04:16 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Fri, 29 Apr 2011 20:04:16 +0000
Subject: [docs] [issue11948] Tutorial/Modules - small fix to better clarify
	the	modules search path
In-Reply-To: <1304011111.24.0.834772686878.issue11948@psf.upfronthosting.co.za>
Message-ID: <1304107456.92.0.861085371389.issue11948@psf.upfronthosting.co.za>


Changes by Sandro Tosi <sandro.tosi at gmail.com>:


Added file: http://bugs.python.org/file21836/issue11948.patch

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

From report at bugs.python.org  Sat Apr 30 01:28:50 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 29 Apr 2011 23:28:50 +0000
Subject: [docs] [issue11948] Tutorial/Modules - small fix to better clarify
	the	modules search path
In-Reply-To: <1304011111.24.0.834772686878.issue11948@psf.upfronthosting.co.za>
Message-ID: <1304119730.52.0.0211547566528.issue11948@psf.upfronthosting.co.za>


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

I believe the patch produces the following as the first sentence

"When a module named :mod:`spam` is imported, the interpreter searches for a file named :file:`spam.py` in a list of directories given by the variable ``sys.path`` which is initialized from the directory containing the input script (or the current directory), :envvar:`PYTHONPATH` (a list of directory names, with the same syntax as the shell variable :envvar:`PATH`) and the installation-dependent default."

This is more that a 'mouthful', especially for a tutorial, and I think is should be split into two:
variable ``sys.path``.  ``Sys.path`` is initialized ...

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

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

From report at bugs.python.org  Sat Apr 30 04:57:16 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Sat, 30 Apr 2011 02:57:16 +0000
Subject: [docs] [issue11762] Ast doc: warning and version number
In-Reply-To: <1301933761.05.0.937546235723.issue11762@psf.upfronthosting.co.za>
Message-ID: <1304132236.88.0.684061684386.issue11762@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Apr 30 07:53:13 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 30 Apr 2011 05:53:13 +0000
Subject: [docs] [issue10912] PyObject_RichCompare differs in behaviour
	from	PyObject_RichCompareBool ;
	difference not noted in documentation
In-Reply-To: <1295053260.1.0.0634834443195.issue10912@psf.upfronthosting.co.za>
Message-ID: <E1QG379-0003g7-8W@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset d27f95e3b52f by Eli Bendersky in branch '2.7':
Issue #10912: add clarification for PyObject_RichCompareBool comparing identical objects
http://hg.python.org/cpython/rev/d27f95e3b52f

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

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

From report at bugs.python.org  Sat Apr 30 07:56:06 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Sat, 30 Apr 2011 05:56:06 +0000
Subject: [docs] [issue11827] mention of list2cmdline() in docs of
	subprocess.Popen
In-Reply-To: <1302511097.53.0.993242324349.issue11827@psf.upfronthosting.co.za>
Message-ID: <1304142966.75.0.832264986175.issue11827@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Apr 30 07:56:48 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Sat, 30 Apr 2011 05:56:48 +0000
Subject: [docs] [issue10912] PyObject_RichCompare differs in behaviour
	from	PyObject_RichCompareBool ;
	difference not noted in documentation
In-Reply-To: <1295053260.1.0.0634834443195.issue10912@psf.upfronthosting.co.za>
Message-ID: <1304143008.59.0.731215372852.issue10912@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Apr 30 13:25:21 2011
From: report at bugs.python.org (Georg Brandl)
Date: Sat, 30 Apr 2011 11:25:21 +0000
Subject: [docs] [issue11786] ConfigParser.[Raw]ConfigParser optionxform()
In-Reply-To: <1302110277.82.0.57770456199.issue11786@psf.upfronthosting.co.za>
Message-ID: <1304162721.69.0.924074091851.issue11786@psf.upfronthosting.co.za>


Georg Brandl <georg at python.org> added the comment:

The point is, all gratuitous changes to such branches are a nuisance to the release manager who decides what needs to go into a security release.

Also, doc changes in 2.6 are almost completely gratuitous, since the docs are never again built and put online somewhere.  (Source-only releases don't have build doc releases.)

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

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

From report at bugs.python.org  Sat Apr 30 14:23:01 2011
From: report at bugs.python.org (Daniel Urban)
Date: Sat, 30 Apr 2011 12:23:01 +0000
Subject: [docs] [issue11762] Ast doc: warning and version number
In-Reply-To: <1301933761.05.0.937546235723.issue11762@psf.upfronthosting.co.za>
Message-ID: <1304166181.66.0.488600297144.issue11762@psf.upfronthosting.co.za>


Changes by Daniel Urban <urban.dani+py at gmail.com>:


----------
nosy: +durban

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

From report at bugs.python.org  Sat Apr 30 16:33:40 2011
From: report at bugs.python.org (=?utf-8?q?=C5=81ukasz_Langa?=)
Date: Sat, 30 Apr 2011 14:33:40 +0000
Subject: [docs] [issue11786] ConfigParser.
In-Reply-To: <1304162721.69.0.924074091851.issue11786@psf.upfronthosting.co.za>
Message-ID: <CF62D5F3-A180-40F6-8E4D-199EE662AA86@langa.pl>


?ukasz Langa <lukasz at langa.pl> added the comment:

Yup, the fact that the docs won't be rebuilt ever again makes my 2.6 commit effectively pointless and harmful for the RM. I will clean it up when I get home.

Thanks for the thorough explanation.

----------
title: ConfigParser.[Raw]ConfigParser optionxform() -> ConfigParser.

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

From report at bugs.python.org  Sat Apr 30 17:47:15 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Sat, 30 Apr 2011 15:47:15 +0000
Subject: [docs] [issue11964] Undocumented change to indent param of
	json.dump in 3.2
In-Reply-To: <1304178435.78.0.522459822796.issue11964@psf.upfronthosting.co.za>
Message-ID: <1304178435.78.0.522459822796.issue11964@psf.upfronthosting.co.za>


New submission from ?ric Araujo <merwok at netwok.org>:

I found out that the indent parameter of json.dump was changed in 3.2: it can be a string as well as an int.  The docstring was not updated; the reST doc was, but without a versionchanged directive.

This probably applies to the doc and docstring of the classes implementing dump, too, and there may be other half-documented changes.

----------
assignee: docs at python
components: Documentation, Library (Lib)
keywords: easy
messages: 134869
nosy: bob.ippolito, docs at python, eric.araujo, rhettinger
priority: normal
severity: normal
stage: needs patch
status: open
title: Undocumented change to indent param of json.dump in 3.2
versions: Python 3.2, Python 3.3

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

From report at bugs.python.org  Sat Apr 30 18:14:54 2011
From: report at bugs.python.org (R. David Murray)
Date: Sat, 30 Apr 2011 16:14:54 +0000
Subject: [docs] [issue11964] Undocumented change to indent param of
	json.dump in 3.2
In-Reply-To: <1304178435.78.0.522459822796.issue11964@psf.upfronthosting.co.za>
Message-ID: <1304180094.23.0.965840215922.issue11964@psf.upfronthosting.co.za>


R. David Murray <rdmurray at bitdance.com> added the comment:

This change was made by Raymond in issue 5729.  It is the only feature added by that patch; the missing versionchanged was an oversight and I don't think it makes any more likely that other features were added that weren't documented.

If you are updating doc strings, note that there is more than one docstring that mentions indent and all should be updated.

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

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

From report at bugs.python.org  Sat Apr 30 18:27:00 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Sat, 30 Apr 2011 16:27:00 +0000
Subject: [docs] [issue11948] Tutorial/Modules - small fix to better clarify
	the	modules search path
In-Reply-To: <1304011111.24.0.834772686878.issue11948@psf.upfronthosting.co.za>
Message-ID: <1304180819.94.0.311805066018.issue11948@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

One caveat to Terry?s suggestion: never ever change the case of a Python identifier or keyword (?Sys?).

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

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

From report at bugs.python.org  Sat Apr 30 18:32:23 2011
From: report at bugs.python.org (=?utf-8?q?Andreas_St=C3=BChrk?=)
Date: Sat, 30 Apr 2011 16:32:23 +0000
Subject: [docs] [issue11966] Typo in PyModule_AddIntMacro's documentation
In-Reply-To: <1304181143.38.0.500156763216.issue11966@psf.upfronthosting.co.za>
Message-ID: <1304181143.38.0.500156763216.issue11966@psf.upfronthosting.co.za>


New submission from Andreas St?hrk <andy-python at hammerhartes.de>:

The example says "PyModule_AddConstant" instead of "PyModule_AddIntMacro". Attached is a patch for 3.1 branch, but it applies to all branches.

----------
assignee: docs at python
components: Documentation
files: PyModule_AddIntMacro_doc.patch
keywords: patch
messages: 134879
nosy: Trundle, docs at python
priority: normal
severity: normal
status: open
title: Typo in PyModule_AddIntMacro's documentation
versions: Python 2.7, Python 3.1, Python 3.2, Python 3.3
Added file: http://bugs.python.org/file21843/PyModule_AddIntMacro_doc.patch

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

From report at bugs.python.org  Sat Apr 30 18:34:12 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Sat, 30 Apr 2011 16:34:12 +0000
Subject: [docs] [issue11964] Undocumented change to indent param of
	json.dump in 3.2
In-Reply-To: <1304178435.78.0.522459822796.issue11964@psf.upfronthosting.co.za>
Message-ID: <1304181252.74.0.414441324431.issue11964@psf.upfronthosting.co.za>


?ric Araujo <merwok at netwok.org> added the comment:

> This change was made by Raymond in issue 5729.  It is the only feature
> added by that patch; the missing versionchanged was an oversight and I
> don't think it makes any more likely that other features were added
> that weren't documented.
Ah, I?m relieved, thanks.  I can fix it but I don?t know when I?ll be able to push again.

> If you are updating doc strings, note that there is more than one
> docstring that mentions indent and all should be updated.
I?m aware of that: ?This probably applies to the doc and docstring of the classes implementing dump too?.

----------

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

From report at bugs.python.org  Sat Apr 30 20:14:14 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 30 Apr 2011 18:14:14 +0000
Subject: [docs] [issue11966] Typo in PyModule_AddIntMacro's documentation
In-Reply-To: <1304181143.38.0.500156763216.issue11966@psf.upfronthosting.co.za>
Message-ID: <E1QGEgF-0004aX-RK@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset b3e7ffe6d727 by Benjamin Peterson in branch '3.1':
fix function name in example (closes #11966)
http://hg.python.org/cpython/rev/b3e7ffe6d727

New changeset fb709d9fe92a by Benjamin Peterson in branch '2.7':
fix function name in example (closes #11966)
http://hg.python.org/cpython/rev/fb709d9fe92a

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

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

From report at bugs.python.org  Sat Apr 30 22:25:48 2011
From: report at bugs.python.org (Prashanth Raghu)
Date: Sat, 30 Apr 2011 20:25:48 +0000
Subject: [docs] [issue11964] Undocumented change to indent param of
	json.dump in 3.2
In-Reply-To: <1304178435.78.0.522459822796.issue11964@psf.upfronthosting.co.za>
Message-ID: <1304195148.31.0.553544645929.issue11964@psf.upfronthosting.co.za>


Prashanth Raghu <p.is.prashanth at gmail.com> added the comment:

The .rst file that was downloaded as of 30-04-2011 (dd-mm-yyyy) had the updated doc .

----------
nosy: +Prashanth.Raghu

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

From report at bugs.python.org  Sat Apr 30 22:36:59 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 30 Apr 2011 20:36:59 +0000
Subject: [docs] [issue11901] Docs for sys.hexversion should give the
	algorithm
In-Reply-To: <1303410263.92.0.721904855375.issue11901@psf.upfronthosting.co.za>
Message-ID: <E1QGGuJ-0005TH-Fu@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 34d2fb56de9a by R David Murray in branch '2.7':
#11901: post-commit review fixes per Georg Brandl
http://hg.python.org/cpython/rev/34d2fb56de9a

New changeset 2ddb4d6f826a by R David Murray in branch '3.1':
#11901: post-commit review fixes per Georg Brandl
http://hg.python.org/cpython/rev/2ddb4d6f826a

New changeset 591a09cf9e62 by R David Murray in branch '3.2':
Merge #11901: post-commit review fixes per Georg Brandl
http://hg.python.org/cpython/rev/591a09cf9e62

New changeset ca8e2fe68ecb by R David Murray in branch 'default':
Merge #11901: post-commit review fixes per Georg Brandl
http://hg.python.org/cpython/rev/ca8e2fe68ecb

----------

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

From report at bugs.python.org  Sat Apr 30 23:21:05 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 30 Apr 2011 21:21:05 +0000
Subject: [docs] [issue11883] Call connect() before sending an email with
	smtplib
In-Reply-To: <1303246763.2.0.10135500331.issue11883@psf.upfronthosting.co.za>
Message-ID: <E1QGHb5-00085a-0D@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 5c61c1d583fd by R David Murray in branch '3.2':
#11883: replace incorrect call to sendmail with correct call to send_message
http://hg.python.org/cpython/rev/5c61c1d583fd

New changeset fcfaeab42f6e by R David Murray in branch 'default':
Merge #11883: replace incorrect call to sendmail with correct call to send_message
http://hg.python.org/cpython/rev/fcfaeab42f6e

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

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

From report at bugs.python.org  Sat Apr 30 23:29:40 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 30 Apr 2011 21:29:40 +0000
Subject: [docs] [issue11883] Call connect() before sending an email with
	smtplib
In-Reply-To: <1303246763.2.0.10135500331.issue11883@psf.upfronthosting.co.za>
Message-ID: <E1QGHjP-00005p-1O@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset a9cb47d0241e by R David Murray in branch '2.7':
#11883: fix email examples by adding 'localhost' to SMTP constructor calls
http://hg.python.org/cpython/rev/a9cb47d0241e

New changeset 00ff8825f551 by R David Murray in branch '3.1':
#11883: fix email examples by adding 'localhost' to SMTP constructor calls
http://hg.python.org/cpython/rev/00ff8825f551

New changeset 0f14dd4e644e by R David Murray in branch '3.2':
Merge #11883: fix email examples by adding 'localhost' to SMTP constructor calls
http://hg.python.org/cpython/rev/0f14dd4e644e

New changeset cfc02e132c12 by R David Murray in branch 'default':
Merge #11883: fix email examples by adding 'localhost' to SMTP constructor calls
http://hg.python.org/cpython/rev/cfc02e132c12

----------

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

From report at bugs.python.org  Sat Apr 30 23:31:30 2011
From: report at bugs.python.org (R. David Murray)
Date: Sat, 30 Apr 2011 21:31:30 +0000
Subject: [docs] [issue11883] Call connect() before sending an email with
	smtplib
In-Reply-To: <1303246763.2.0.10135500331.issue11883@psf.upfronthosting.co.za>
Message-ID: <1304199090.07.0.787734663276.issue11883@psf.upfronthosting.co.za>


R. David Murray <rdmurray at bitdance.com> added the comment:

The call to connect() is not required in the first example, since the hostname is passed to the constructor in that case.  Since these examples are about the email package rather than smtplib, I preferred to change the other examples to pass localhost to the constructor as well, rather than call connect with no arguments after a no argument call to the constructor.

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

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

From gyk.net at gmail.com  Wed Apr 27 07:19:26 2011
From: gyk.net at gmail.com (Yukun Guo)
Date: Wed, 27 Apr 2011 13:19:26 +0800
Subject: [docs] A minor bug in code examples
Message-ID: <BANLkTi=RBWExPcjzzfR917R40BjPvTwuWA@mail.gmail.com>

@ http://docs.python.org/library/struct.html#examples

-     >>> Student._make(unpack('<10sHHb', s))
+    >>> Student._make(unpack('<10sHHb', record))

From christian.herdtweck at tuebingen.mpg.de  Wed Apr 27 10:28:07 2011
From: christian.herdtweck at tuebingen.mpg.de (Christian Herdtweck)
Date: Wed, 27 Apr 2011 10:28:07 +0200
Subject: [docs] minor bug in python documentation 2.7 - multiprocessing
Message-ID: <4DB7D397.7050605@tuebingen.mpg.de>

Hi all,

   first of all thanks for the work you all put into python - much 
appreciated :-)

   I found a minor bug in the python documentation (version 2.7), 
library reference, multiprocessing package: 
http://docs.python.org/library/multiprocessing.html

In the description of Pipe the docu says:
If duplex is False then the pipe is unidirectional: conn1 can only be 
used for receiving messages and conn2 can only be used for sending messages.

which is exactly the other way round as used in the the example on the 
same page further down, where the first connection sends and the second 
receives:
 >>> from multiprocessing import Pipe
 >>> a, b = Pipe()
 >>> a.send([1, 'hello', None])
 >>> b.recv()

   I do not know which one is correct

   Cheers
     Christian

From moloney at ohsu.edu  Wed Apr 27 21:04:05 2011
From: moloney at ohsu.edu (Brendan Moloney)
Date: Wed, 27 Apr 2011 12:04:05 -0700
Subject: [docs] The function pkgutil.iter_modules is not flagged as new
Message-ID: <5E25C96030E66B44B9CFAA95D3DE5919351310A7A4@EX-MB08.ohsu.edu>

Hello,

The funtion pkgutil.iter_modules was added sometime between Python 2.4 and Python 2.6 but this is not noted in the documentation.

Thanks,
Brendan Moloney
Senior Research Assistant / Programmer
Advanced Imaging Research Center
Oregon Health Science University

From jch at thehaxbys.co.uk  Thu Apr 28 13:02:06 2011
From: jch at thehaxbys.co.uk (John Haxby)
Date: Thu, 28 Apr 2011 12:02:06 +0100
Subject: [docs] =?windows-1252?q?Incorrect_footnote_in_=2215=2E3=2E_time_?=
 =?windows-1252?q?=97_Time_access_and_conversions=22?=
Message-ID: <4DB9492E.2000909@thehaxbys.co.uk>

The footnote at the end of http://docs.python.org/library/time.html says
>
> [1]    [...] Also, a strict reading of the original 1982 RFC 822
> standard calls for a two-digit year (%y rather than %Y), but practice
> moved to 4-digit years long before the year 2000. The 4-digit year has
> been mandated by RFC 2822, which obsoletes RFC 822.

The change from 2 digit years to 4 digit years was actually mandated by
RFC 1123 in 1989

>
>       5.2.14  RFC-822 Date and Time Specification: RFC-822 Section 5
>
>          The syntax for the date is hereby changed to:
>
>             date = 1*2DIGIT month 2*4DIGIT
>
>          All mail software SHOULD use 4-digit years in dates, to ease
>          the transition to the next century.


It had to be "SHOULD" to give people time to update software. 
Thankfully, eleven years later, practically everyone had switched to
four digit years.

jch

From amints at andromeda.ru  Thu Apr 28 13:52:54 2011
From: amints at andromeda.ru (minz)
Date: Thu, 28 Apr 2011 15:52:54 +0400
Subject: [docs] Doctest problem
Message-ID: <1303991574.22270.8.camel@minz2-desktop>

Hello!
I have a following problem (maybe it is a bug) while running this:
# coding: utf-8

class test(object):
    """
    ????? ??????
    >>> print 1 # ??????
    1
    >>> obj = test()
    >>> obj.raiser() # ??????
    Traceback (most recent call last):
        ...
    Exception
    """
    def __init__(self):
        pass
        
    def raiser(self):
        raise Exception

if __name__ == "__main__":
    import doctest
    doctest.testmod()


$ python pybug.py
Traceback (most recent call last):
  File "pybug.py", line 22, in <module>
    doctest.testmod()
  File "/usr/lib/python2.6/doctest.py", line 1848, in testmod
    runner.run(test)
  File "/usr/lib/python2.6/doctest.py", line 1391, in run
    return self.__run(test, compileflags, out)
  File "/usr/lib/python2.6/doctest.py", line 1277, in __run
    got += _exception_traceback(exc_info)
  File "/usr/lib/python2.6/doctest.py", line 244, in
_exception_traceback
    traceback.print_exception(exc_type, exc_val, exc_tb, file=excout)
  File "/usr/lib/python2.6/traceback.py", line 125, in print_exception
    print_tb(tb, limit, file)
  File "/usr/lib/python2.6/traceback.py", line 69, in print_tb
    line = linecache.getline(filename, lineno, f.f_globals)
  File "/usr/lib/python2.6/linecache.py", line 14, in getline
    lines = getlines(filename, module_globals)
  File "/usr/lib/python2.6/doctest.py", line 1336, in
__patched_linecache_getlines
    source = example.source.encode('ascii', 'backslashreplace')
UnicodeDecodeError: 'ascii' codec can't decode byte 0xd0 in position 15:
ordinal not in range(128)

The problem is in the comment in line ">>> obj.raiser() # ??????".
Removing this comment or even moving it to previous line removes the
error. 
First test (>>> print 1 # ??????) without the second one works fine.
I have 2.6.6-5ubuntu1 installed:
$ python -V
Python 2.6.6

Regards,
Alexey Mints


From cocoatomo77 at gmail.com  Sat Apr 30 02:59:25 2011
From: cocoatomo77 at gmail.com (tomo cocoa)
Date: Sat, 30 Apr 2011 09:59:25 +0900
Subject: [docs] Python v2.7.1 documentation bug
Message-ID: <BANLkTimCMcXYa9qWarU3GBEWiqyDEDGSkQ@mail.gmail.com>

Hello

I am a Japanese Pythonista and now belong to the document translating team.

I found a subtle bug in the c-api/buffer.html.

In the explanation about the PyBuffer_FillContiguousStrides function,
there is one open parenthesis but is no close parenthesis.
I guess that a close parenthesis should be inserted between words
"'F'" and "array".

PyBuffer_FillContiguousStrides
http://docs.python.org/c-api/buffer.html#PyBuffer_FillContiguousStrides

Regards.

-- 
class Cocoatomo:
? ? name = 'cocoatomo'
? ? email_address = 'cocoatomo77 at gmail.com'
? ? twitter_id = '@cocoatomo'

From anup.warnulkar at gmail.com  Sat Apr 30 18:10:38 2011
From: anup.warnulkar at gmail.com (Anup Warnulkar)
Date: Sat, 30 Apr 2011 21:40:38 +0530
Subject: [docs] pydoc 2.7 in chm format
Message-ID: <F78E1E59-BFC6-4A1E-9E56-ED327130A08E@gmail.com>

Hi,
Where can i download python 2.7.1 documentation in chm format ? Please  
suggest me.
Regards,
Anup Warnulkar





From joemirizio at yahoo.com  Sat Apr 30 18:33:39 2011
From: joemirizio at yahoo.com (Joe Mirizio)
Date: Sat, 30 Apr 2011 09:33:39 -0700 (PDT)
Subject: [docs] 4.7.2. Keyword Arguments - Small Typo: 'sort()' -> 'sorted()'
Message-ID: <308799.94592.qm@web112611.mail.gq1.yahoo.com>

>From 4.7.2. Keyword Arguments:
"
def cheeseshop(kind, *arguments, **keywords): print "-- Do you have any", kind, "?" print "-- I'm sorry, we're all out of", kind for arg in arguments: print arg print "-" * 40 keys = sorted(keywords.keys()) for kw in keys: print kw, ":", keywords[kw]

...

Note that the sort()method of the list of keyword argument names is
called before printing the contents of the keywordsdictionary; if this is
not done, the order in which the arguments are printed is undefined.
"

The note at the bottom says sort(), but the method used in the above code section is sorted()

Since sorted() is like a built-in function rather than a method of list, the sentence might need to be 

reworded to something like:

'Note that the built-in sorted() function is called on the list of keyword 

argument names before printing the contents of the keyword dictionary...'

It should also link to http://docs.python.org/library/functions.html#sorted
Hope this helps!

??? 

????? Joe Mirizio
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20110430/1d34a267/attachment-0001.html>