From sandro.tosi at gmail.com  Wed Jun  1 00:07:04 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Wed, 1 Jun 2011 00:07:04 +0200
Subject: [docs] RegexObject findall, finditer docs misleading
In-Reply-To: <BANLkTi=x+348LNCc14=v=EsxpqAEyiWUXg@mail.gmail.com>
References: <BANLkTi=x+348LNCc14=v=EsxpqAEyiWUXg@mail.gmail.com>
Message-ID: <BANLkTin6Mf9JDE4k3O3TOZ-sEbf+bBuhuw@mail.gmail.com>

Hello Sean,

On Wed, May 25, 2011 at 20:36, Sean Silva <chisophugis at gmail.com> wrote:
> http://docs.python.org/library/re.html#re.RegexObject.findall
> On RegexObjects, finditer returns an iterator over MatchObjects, whereas
> findall returns a list of *strings*. This isn't mentioned anywhere in their
> documentation, but it is a pretty big distinction.

It's not explicitly mentioned, but this functions have clear remark
that they are similar to "other" functions, f.e.:

findall(string[, pos[, endpos]])
Similar to the findall() function

and following the "findall()" like you end up to:

re.findall(pattern, string[, flags])
Return all non-overlapping matches of pattern in string, as a list of strings.

The same applies for finditer().

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  Wed Jun  1 00:12:32 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Wed, 1 Jun 2011 00:12:32 +0200
Subject: [docs] Doctest problem
In-Reply-To: <1303991574.22270.8.camel@minz2-desktop>
References: <1303991574.22270.8.camel@minz2-desktop>
Message-ID: <BANLkTineZ5gZgveK4UBWH+_ET4NAUvVMsQ@mail.gmail.com>

Hello,

On Thu, Apr 28, 2011 at 13:52, minz <amints at andromeda.ru> wrote:
> Hello!
> I have a following problem (maybe it is a bug) while running this:

This is not a bug reporting ml, you should contact a user support
forum, like: mail.python.org/pipermail/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  Wed Jun  1 08:23:11 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Wed, 01 Jun 2011 06:23:11 +0000
Subject: [docs] [issue10376] ZipFile unzip is unbuffered
In-Reply-To: <1289317915.09.0.657677437465.issue10376@psf.upfronthosting.co.za>
Message-ID: <1306909391.72.0.531427166822.issue10376@psf.upfronthosting.co.za>


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


----------
versions: +Python 3.2, Python 3.3 -Python 2.5, Python 2.6, Python 3.1

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

From moloney at ohsu.edu  Wed Jun  1 00:15:58 2011
From: moloney at ohsu.edu (Brendan Moloney)
Date: Tue, 31 May 2011 15:15:58 -0700
Subject: [docs] The function pkgutil.iter_modules is not flagged as new
In-Reply-To: <BANLkTim=QnY9duZyjtbFjYPm0GwR+3-+Lg@mail.gmail.com>
References: <AQHMBQ3hU/plRo8o6EqZGh5HHXr7fg==>
	<5E25C96030E66B44B9CFAA95D3DE5919351310A7A4@EX-MB08.ohsu.edu>,
	<BANLkTim=QnY9duZyjtbFjYPm0GwR+3-+Lg@mail.gmail.com>
Message-ID: <5E25C96030E66B44B9CFAA95D3DE59193517C22AEE@EX-MB08.ohsu.edu>

I was under the impression that all modules/classes/functions introduced since 2.0 should be flagged as such (including the version it was introduced in).  It seems silly to flag some of them but not all of them as this gives a false impression that such a policy does exist.

I suppose I can look at the documentation for older versions to figure out the oldest version that can run my code, but this is quite a bit more effort.

Brendan Moloney
Senior Research Assistant / Programmer
Advanced Imaging Research Center
Oregon Health Science University
________________________________________
From: matrixhasu at gmail.com [matrixhasu at gmail.com] On Behalf Of Sandro Tosi [sandro.tosi at gmail.com]
Sent: Tuesday, May 31, 2011 2:52 PM
To: Brendan Moloney
Cc: docs at python.org
Subject: Re: [docs] The function pkgutil.iter_modules is not flagged as new

Hello Brendan,

On Wed, Apr 27, 2011 at 21:04, Brendan Moloney <moloney at ohsu.edu> wrote:
> 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.

If I did my homework fine, it should have been introduced between
Alpha1 and Alpha2 of 2.5. Given so long has passed, and the fact we
don't have a consistent policy (if there's any at all) for marking old
functions (but we do for new functions) introduction release, I don't
see much value in adding this info now.

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

From nicog89 at gmail.com  Wed Jun  1 05:02:12 2011
From: nicog89 at gmail.com (Nicolas Gleichgerrcht)
Date: Wed, 1 Jun 2011 00:02:12 -0300
Subject: [docs] Code example bug in Heap page
Message-ID: <BANLkTikaFnuqKXKiU_Y2G0i9tDYBUuUmFQ@mail.gmail.com>

Hello, I thing there is a bug in the heapq page
(http://docs.python.org/library/heapq.html) under the 8.4.2. Priority
Queue Implementation Notes Secction.
In the code example defines this function

def get_top_priority():
    while True:
        priority, count, task = heappop(pq)
        del task_finder[task]
        if count is not INVALID:
            return task

I thing the delete must be inside the if statment, because if you have
reprioritize task, with lower priority than before, it will delete
from task_finder, but the a task will still be in pq heap.

Example:
add_task(2, 'a')
add_task(1,'b')
reprioritize(3, 'a')
get_top_priority() #print b
get_top_priority() #rise Error, but shoud print b

Thanks!

From report at bugs.python.org  Wed Jun  1 19:27:29 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 01 Jun 2011 17:27:29 +0000
Subject: [docs] [issue11975] Fix referencing of built-in types (list, int,
	...)
In-Reply-To: <1304281262.53.0.265979216697.issue11975@psf.upfronthosting.co.za>
Message-ID: <1306949248.97.0.584514798654.issue11975@psf.upfronthosting.co.za>


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

Jonas, I owe you an apology: when I abruptly asked ?Could you make an effort to accept? etc., I had misread your message and thought you were asking to change the roles, but you were speaking of directives, so my comment was out of line.  Sorry.

----------

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

From report at bugs.python.org  Wed Jun  1 19:34:58 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Wed, 01 Jun 2011 17:34:58 +0000
Subject: [docs] [issue11975] Fix referencing of built-in types (list, int,
	...)
In-Reply-To: <1304281262.53.0.265979216697.issue11975@psf.upfronthosting.co.za>
Message-ID: <1306949698.48.0.870989443504.issue11975@psf.upfronthosting.co.za>


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

FWIW using the class directive also adds a 'class' before the name, and I -1 about having int()/float()/etc. prepended by 'class' in the functions.rst page.
What happens if we leave ".. function::" there and use ".. class::" in another page where all the methods are actually documented?

----------

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

From report at bugs.python.org  Wed Jun  1 19:37:52 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 01 Jun 2011 17:37:52 +0000
Subject: [docs] [issue11975] Fix referencing of built-in types (list, int,
	...)
In-Reply-To: <1304281262.53.0.265979216697.issue11975@psf.upfronthosting.co.za>
Message-ID: <1306949872.73.0.907797957773.issue11975@psf.upfronthosting.co.za>


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

Agreed.

I experimented with tuple and tuple.count and it turns out that it?s not easily solved: the count method is documented in the table describing all sequences methods, which should not be duplicated IMO; I tried adding a .. method:: tuple.append directive to create a link target, but that does not work in a table row.  Maybe the index directives can do what we want, but I do not understand them.

----------

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

From report at bugs.python.org  Wed Jun  1 23:10:59 2011
From: report at bugs.python.org (Jonas H.)
Date: Wed, 01 Jun 2011 21:10:59 +0000
Subject: [docs] [issue11975] Fix referencing of built-in types (list, int,
	...)
In-Reply-To: <1304281262.53.0.265979216697.issue11975@psf.upfronthosting.co.za>
Message-ID: <1306962659.5.0.852955220902.issue11975@psf.upfronthosting.co.za>


Jonas H. <jonas at lophus.org> added the comment:

> Jonas, I owe you an apology [...]

Thanks ?ric, I got a bit worried about getting on your nerves...

Based on Ezio's idea: What happens if we have both a ".. function:: foo" and ".. class:: foo" -- where do :func:`foo` and :class:`foo` link to (internally and using intersphinx)?

----------

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

From report at bugs.python.org  Wed Jun  1 23:22:34 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Wed, 01 Jun 2011 21:22:34 +0000
Subject: [docs] [issue11975] Fix referencing of built-in types (list, int,
	...)
In-Reply-To: <1304281262.53.0.265979216697.issue11975@psf.upfronthosting.co.za>
Message-ID: <1306963354.43.0.523215539016.issue11975@psf.upfronthosting.co.za>


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

I think the only way to find it out is to try it and see.
In the worst case, sphinx will give an error while building the doc, if we are lucky it will just pick one of the two (or even better the one defined with the function directive while using :func:`` and the other one while using :class:``).
You can also experiment with :noindex: but I'm not sure it will do anything useful here.

----------

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

From report at bugs.python.org  Thu Jun  2 17:48:24 2011
From: report at bugs.python.org (Bryce Verdier)
Date: Thu, 02 Jun 2011 15:48:24 +0000
Subject: [docs] [issue12243] getpass.getuser works on OSX
In-Reply-To: <1307029704.02.0.858553376312.issue12243@psf.upfronthosting.co.za>
Message-ID: <1307029704.02.0.858553376312.issue12243@psf.upfronthosting.co.za>


New submission from Bryce Verdier <bryceverdier at gmail.com>:

In the docs for getpass:
http://docs.python.org/release/2.6.6/library/getpass.html (as an example).

It hints that getuser() doesn't work on OSX. I tried this out and it works fine for python 2.6 on 10.6.

I have included a patch for this. I believe the cleanest way to handle this is to remove the "Availability" entry as it's no longer necessary.

----------
assignee: docs at python
components: Documentation
files: getuser.patch
keywords: patch
messages: 137483
nosy: docs at python, louiscipher
priority: normal
severity: normal
status: open
title: getpass.getuser works on OSX
versions: Python 2.6, Python 2.7, Python 3.1, Python 3.2, Python 3.3, Python 3.4
Added file: http://bugs.python.org/file22222/getuser.patch

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

From report at bugs.python.org  Thu Jun  2 20:53:24 2011
From: report at bugs.python.org (R. David Murray)
Date: Thu, 02 Jun 2011 18:53:24 +0000
Subject: [docs] [issue12243] getpass.getuser works on OSX
In-Reply-To: <1307029704.02.0.858553376312.issue12243@psf.upfronthosting.co.za>
Message-ID: <1307040804.2.0.778816468477.issue12243@psf.upfronthosting.co.za>


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

I think you are correct that the Availability can be removed, since the actual limits of the support are exactly as complicated as the code that supports them, and should give *some* result on most (all?) platforms.  However, OS/X is certainly covered by the current one, since OS/X is a unix flavor.  At this point in time it might be worth doing a sweep through the docs to remove all occurrences of 'Macintosh', since we don't support OS/9 any more.  There look to be less than a dozen such references in the Python3 docs.

I'm adding Gregory to nosy to see if he thinks it is appropriate to remove the 'availability' entirely, since he implemented the fallback.

----------
nosy: +gregory.p.smith, r.david.murray
versions:  -Python 2.6, Python 3.1, Python 3.4

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

From report at bugs.python.org  Thu Jun  2 21:47:10 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Thu, 02 Jun 2011 19:47:10 +0000
Subject: [docs] [issue12245] Document the meaning of FLT_ROUNDS constants
	for	sys.float_info
In-Reply-To: <1307044030.93.0.176037757521.issue12245@psf.upfronthosting.co.za>
Message-ID: <1307044030.93.0.176037757521.issue12245@psf.upfronthosting.co.za>


New submission from Raymond Hettinger <raymond.hettinger at gmail.com>:

>>> sys.float_info.rounds
1

----------
assignee: docs at python
components: Documentation
messages: 137493
nosy: docs at python, rhettinger
priority: normal
severity: normal
status: open
title: Document the meaning of FLT_ROUNDS constants for sys.float_info
versions: Python 2.7, Python 3.2, Python 3.3

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

From report at bugs.python.org  Fri Jun  3 02:08:05 2011
From: report at bugs.python.org (Tshepang Lekhonkhobe)
Date: Fri, 03 Jun 2011 00:08:05 +0000
Subject: [docs] [issue12249] add missing command
In-Reply-To: <1307059685.23.0.0593360384194.issue12249@psf.upfronthosting.co.za>
Message-ID: <1307059685.23.0.0593360384194.issue12249@psf.upfronthosting.co.za>


New submission from Tshepang Lekhonkhobe <tshepang at gmail.com>:

It's not indicated where one should run the command 'make html' in the "Building the documentation" page, so when it failed for me when running it from the cpython distribution root, I was left a little puzzled, searching where the problem might lie (wasting time).

----------
assignee: docs at python
components: Documentation
files: add-missing-command.diff
keywords: patch
messages: 137502
nosy: docs at python, tshepang
priority: normal
severity: normal
status: open
title: add missing command
versions: Python 3.3
Added file: http://bugs.python.org/file22226/add-missing-command.diff

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

From report at bugs.python.org  Fri Jun  3 16:30:30 2011
From: report at bugs.python.org (=?utf-8?q?Francisco_Mart=C3=ADn_Brugu=C3=A9?=)
Date: Fri, 03 Jun 2011 14:30:30 +0000
Subject: [docs] [issue12185] Decimal documentation lists "first" and
	"second"	arguments, should be "self" and "other"
In-Reply-To: <1306411163.06.0.644918639795.issue12185@psf.upfronthosting.co.za>
Message-ID: <1307111430.36.0.0672031736336.issue12185@psf.upfronthosting.co.za>


Francisco Mart?n Brugu? <francismb at email.de> added the comment:

Hi all,
that is my first contribution. Please let me know if all it's OK.

Thanks in advance !

----------
keywords: +patch
nosy: +francismb
Added file: http://bugs.python.org/file22228/issue_12185.patch

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

From report at bugs.python.org  Fri Jun  3 16:58:54 2011
From: report at bugs.python.org (Adam Woodbeck)
Date: Fri, 03 Jun 2011 14:58:54 +0000
Subject: [docs] [issue12185] Decimal documentation lists "first" and
	"second"	arguments, should be "self" and "other"
In-Reply-To: <1306411163.06.0.644918639795.issue12185@psf.upfronthosting.co.za>
Message-ID: <1307113134.77.0.29505263014.issue12185@psf.upfronthosting.co.za>


Adam Woodbeck <adam.woodbeck at gmail.com> added the comment:

Hi Francisco,

I finally found time to create a patch for this issue.  I was just saving the patch I wrote as your update arrived in my inbox.  I've included my patch for good measure.  It's better to have two proposed patches than none at all in my opinion.

Adam

----------
Added file: http://bugs.python.org/file22229/issue_12185-ajw.patch

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

From report at bugs.python.org  Fri Jun  3 17:39:17 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 03 Jun 2011 15:39:17 +0000
Subject: [docs] [issue12237] Document how to open non-default webbrowser
In-Reply-To: <1307006042.24.0.905858439151.issue12237@psf.upfronthosting.co.za>
Message-ID: <1307115557.56.0.0588300247693.issue12237@psf.upfronthosting.co.za>


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

Hello.  This tracker is used to report bugs and file feature requests for Python itself, not request help (mailing list such as http://mail.python.org/pipermail/python-list/ are appropriate venues to ask for for help).  I?m changing your question to a bug report about missing documentation.

----------
assignee:  -> docs at python
components: +Documentation
nosy: +docs at python, eric.araujo
stage:  -> needs patch
title: how to open non defult browser? -> Document how to open non-default webbrowser
versions: +Python 2.7, Python 3.2, Python 3.3

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

From report at bugs.python.org  Fri Jun  3 17:43:30 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 03 Jun 2011 15:43:30 +0000
Subject: [docs] [issue12243] getpass.getuser works on OSX
In-Reply-To: <1307029704.02.0.858553376312.issue12243@psf.upfronthosting.co.za>
Message-ID: <1307115810.12.0.735006409151.issue12243@psf.upfronthosting.co.za>


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

Yes, it?s unclear whether Unix in the docs included Mac OS X or not.

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

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

From report at bugs.python.org  Fri Jun  3 17:47:40 2011
From: report at bugs.python.org (Roman Alexeev)
Date: Fri, 03 Jun 2011 15:47:40 +0000
Subject: [docs] [issue12254] PEP-3107 has a wrong attribute name for
	function	annotations
In-Reply-To: <1307116060.53.0.995138421611.issue12254@psf.upfronthosting.co.za>
Message-ID: <1307116060.53.0.995138421611.issue12254@psf.upfronthosting.co.za>


New submission from Roman Alexeev <letit.bee at gmail.com>:

The name of the attribute holding annotations is `__annotations__`, not `func_annotations` as PEP-3107 says.

----------
assignee: docs at python
components: Documentation
messages: 137532
nosy: Roman.Alexeev, docs at python
priority: normal
severity: normal
status: open
title: PEP-3107 has a wrong attribute name for function annotations

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

From report at bugs.python.org  Fri Jun  3 17:47:52 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 03 Jun 2011 15:47:52 +0000
Subject: [docs] [issue12249] add missing command
In-Reply-To: <1307059685.23.0.0593360384194.issue12249@psf.upfronthosting.co.za>
Message-ID: <1307116072.0.0.51026958669.issue12249@psf.upfronthosting.co.za>


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

Your patch adds the cd before running make, but other examples and filenames (for example :file:`tools/sphinx`) are also relative to Doc.  How about adding something like this after the very first paragraph:

All commands in this document should be run from the :file:`Doc` directory of a Python checkout; all file and directory names are also relative to :file:`Doc`.

----------
nosy: +eric.araujo, georg.brandl

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

From report at bugs.python.org  Fri Jun  3 17:48:43 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Fri, 03 Jun 2011 15:48:43 +0000
Subject: [docs] [issue12185] Decimal documentation lists "first" and
	"second"	arguments, should be "self" and "other"
In-Reply-To: <1306411163.06.0.644918639795.issue12185@psf.upfronthosting.co.za>
Message-ID: <1307116123.8.0.185593268272.issue12185@psf.upfronthosting.co.za>


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

I'm not sure this improves the docs.  Will give it more thought and thorough review at a later date.  Also, I will compare it to the "docstrings" in the spec itself.

----------
priority: normal -> low

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

From report at bugs.python.org  Fri Jun  3 18:00:18 2011
From: report at bugs.python.org (Georg Brandl)
Date: Fri, 03 Jun 2011 16:00:18 +0000
Subject: [docs] [issue12243] getpass.getuser works on OSX
In-Reply-To: <1307029704.02.0.858553376312.issue12243@psf.upfronthosting.co.za>
Message-ID: <1307116818.93.0.678834690105.issue12243@psf.upfronthosting.co.za>


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

Well, let's make it clear then.  What about replacing the text-only "Availability" with a directive that renders into a link that displays what the individual values mean?

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

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

From report at bugs.python.org  Fri Jun  3 18:02:05 2011
From: report at bugs.python.org (Georg Brandl)
Date: Fri, 03 Jun 2011 16:02:05 +0000
Subject: [docs] [issue12249] add missing command
In-Reply-To: <1307059685.23.0.0593360384194.issue12249@psf.upfronthosting.co.za>
Message-ID: <1307116925.16.0.0417130611063.issue12249@psf.upfronthosting.co.za>


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

I actually like the "cd Doc" inclusion; it makes it very clear what is going on.

----------

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

From report at bugs.python.org  Fri Jun  3 18:03:39 2011
From: report at bugs.python.org (R. David Murray)
Date: Fri, 03 Jun 2011 16:03:39 +0000
Subject: [docs] [issue12243] getpass.getuser works on OSX
In-Reply-To: <1307029704.02.0.858553376312.issue12243@psf.upfronthosting.co.za>
Message-ID: <1307117019.23.0.0950918685138.issue12243@psf.upfronthosting.co.za>


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

Only because we had Macintosh in there.  We don't mention OS/X explicitly anywhere else in the docs that I could find (except one prose mention in the logging docs).

----------

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

From report at bugs.python.org  Fri Jun  3 18:09:19 2011
From: report at bugs.python.org (R. David Murray)
Date: Fri, 03 Jun 2011 16:09:19 +0000
Subject: [docs] [issue12243] getpass.getuser works on OSX
In-Reply-To: <1307029704.02.0.858553376312.issue12243@psf.upfronthosting.co.za>
Message-ID: <1307117359.76.0.259723610385.issue12243@psf.upfronthosting.co.za>


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

Georg: our post seem to have crossed despite Roundup's attempts at locking.  +1 to your idea about the directive.

----------

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

From report at bugs.python.org  Fri Jun  3 18:17:07 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 03 Jun 2011 16:17:07 +0000
Subject: [docs] =?utf-8?q?=5Bissue12249=5D_Document_working_dir_for_?=
 =?utf-8?b?4oCcbWFrZSBodG1s4oCd?=
In-Reply-To: <1307059685.23.0.0593360384194.issue12249@psf.upfronthosting.co.za>
Message-ID: <1307117826.83.0.590577556921.issue12249@psf.upfronthosting.co.za>


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

Fair enough.  If you think it?s enough to let people know that all paths in :file: roles are relative to Doc, then I can commit it.

----------
title: add missing command -> Document working dir for ?make html?
versions: +Python 2.7, Python 3.2

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

From report at bugs.python.org  Fri Jun  3 18:22:56 2011
From: report at bugs.python.org (Georg Brandl)
Date: Fri, 03 Jun 2011 16:22:56 +0000
Subject: [docs] =?utf-8?q?=5Bissue12249=5D_Document_working_dir_for_?=
 =?utf-8?b?4oCcbWFrZSBodG1s4oCd?=
In-Reply-To: <1307059685.23.0.0593360384194.issue12249@psf.upfronthosting.co.za>
Message-ID: <1307118176.0.0.609198064908.issue12249@psf.upfronthosting.co.za>


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

It's fine, yes.

----------

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

From report at bugs.python.org  Fri Jun  3 18:48:03 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 03 Jun 2011 16:48:03 +0000
Subject: [docs] [issue12204] str.upper converts to title
In-Reply-To: <1306644560.56.0.146552718337.issue12204@psf.upfronthosting.co.za>
Message-ID: <1307119683.67.0.588795528455.issue12204@psf.upfronthosting.co.za>


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

A note sounds good.

----------
assignee:  -> docs at python
components: +Documentation -Interpreter Core, Unicode
nosy: +docs at python, eric.araujo
versions: +Python 2.7 -Python 3.1

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

From report at bugs.python.org  Fri Jun  3 18:55:07 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 03 Jun 2011 16:55:07 +0000
Subject: [docs] [issue12254] PEP-3107 has a wrong attribute name for
	function	annotations
In-Reply-To: <1307116060.53.0.995138421611.issue12254@psf.upfronthosting.co.za>
Message-ID: <1307120107.11.0.00242742338331.issue12254@psf.upfronthosting.co.za>


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

All func_* attributes in 2.x have been given __*__ names in 3.x.

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

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

From report at bugs.python.org  Fri Jun  3 19:00:04 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 03 Jun 2011 17:00:04 +0000
Subject: [docs] [issue12223] Datamodel documentation page: 'operator' where
	'operand'	should be
In-Reply-To: <1306834975.07.0.689179229064.issue12223@psf.upfronthosting.co.za>
Message-ID: <1307120404.25.0.873476539321.issue12223@psf.upfronthosting.co.za>


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

Thanks for catching this.  Is this the only instance of the typo, or are there any others in reference/datamodel or library/operator?

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

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

From report at bugs.python.org  Fri Jun  3 19:27:36 2011
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 03 Jun 2011 17:27:36 +0000
Subject: [docs] =?utf-8?q?=5Bissue12249=5D_Document_working_dir_for_?=
 =?utf-8?b?4oCcbWFrZSBodG1s4oCd?=
In-Reply-To: <1307059685.23.0.0593360384194.issue12249@psf.upfronthosting.co.za>
Message-ID: <E1QSY9n-00048S-08@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 4efc9ded0a03 by ?ric Araujo in branch '3.2':
Document working dir for ?make html? (#12249).  Patch by Tshepang Lekhonkhobe.
http://hg.python.org/cpython/rev/4efc9ded0a03

New changeset 41c918897286 by ?ric Araujo in branch 'default':
Merge #12249 fix from 3.2
http://hg.python.org/cpython/rev/41c918897286

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

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

From report at bugs.python.org  Fri Jun  3 19:31:00 2011
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 03 Jun 2011 17:31:00 +0000
Subject: [docs] =?utf-8?q?=5Bissue12249=5D_Document_working_dir_for_?=
 =?utf-8?b?4oCcbWFrZSBodG1s4oCd?=
In-Reply-To: <1307059685.23.0.0593360384194.issue12249@psf.upfronthosting.co.za>
Message-ID: <E1QSYD4-0004QP-UJ@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 39c29bc8bc35 by ?ric Araujo in branch '2.7':
Document working dir for ?make html? (#12249).  Patch by Tshepang Lekhonkhobe.
http://hg.python.org/cpython/rev/39c29bc8bc35

----------

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

From report at bugs.python.org  Fri Jun  3 19:32:09 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 03 Jun 2011 17:32:09 +0000
Subject: [docs] =?utf-8?q?=5Bissue12249=5D_Document_working_dir_for_?=
 =?utf-8?b?4oCcbWFrZSBodG1s4oCd?=
In-Reply-To: <1307059685.23.0.0593360384194.issue12249@psf.upfronthosting.co.za>
Message-ID: <1307122329.91.0.0563908143922.issue12249@psf.upfronthosting.co.za>


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

Thank you for the report and patch!

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

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

From report at bugs.python.org  Fri Jun  3 21:08:35 2011
From: report at bugs.python.org (Tshepang Lekhonkhobe)
Date: Fri, 03 Jun 2011 19:08:35 +0000
Subject: [docs] [issue12249] add missing command
In-Reply-To: <1307116072.0.0.51026958669.issue12249@psf.upfronthosting.co.za>
Message-ID: <1307128087.17643.3.camel@debian>


Tshepang Lekhonkhobe <tshepang at gmail.com> added the comment:

On Fri, 2011-06-03 at 15:47 +0000, ?ric Araujo wrote:
> ?ric Araujo <merwok at netwok.org> added the comment:
> 
> Your patch adds the cd before running make, but other examples and filenames (for example :file:`tools/sphinx`) are also relative to Doc.  How about adding something like this after the very first paragraph:
> 
> All commands in this document should be run from the :file:`Doc` directory of a Python checkout; all file and directory names are also relative to :file:`Doc`.

I actually much prefer your alternative. When I prepared the patch, I
didn't take note that the rest of the page's content assumed that one
should be in that directory.

----------
title: Document working dir for ?make html? -> add missing command

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

From report at bugs.python.org  Fri Jun  3 21:34:56 2011
From: report at bugs.python.org (Tim Lesher)
Date: Fri, 03 Jun 2011 19:34:56 +0000
Subject: [docs] [issue12261] urllib.parse docs still refer to urlparse
In-Reply-To: <1307129696.46.0.265723026729.issue12261@psf.upfronthosting.co.za>
Message-ID: <1307129696.46.0.265723026729.issue12261@psf.upfronthosting.co.za>


New submission from Tim Lesher <tlesher at gmail.com>:

While most of the occurrences of "urlparse" were corrected to "urllib.parse" when the module was renamed, two were missed: one in the second example, and one in the "See also" note for RFC 3986.

----------
assignee: docs at python
components: Documentation
messages: 137574
nosy: docs at python, tlesher
priority: normal
severity: normal
status: open
title: urllib.parse docs still refer to urlparse
type: behavior
versions: Python 3.2

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

From report at bugs.python.org  Fri Jun  3 21:36:40 2011
From: report at bugs.python.org (Tim Lesher)
Date: Fri, 03 Jun 2011 19:36:40 +0000
Subject: [docs] [issue12261] urllib.parse docs still refer to urlparse
In-Reply-To: <1307129696.46.0.265723026729.issue12261@psf.upfronthosting.co.za>
Message-ID: <1307129800.83.0.621522686524.issue12261@psf.upfronthosting.co.za>


Changes by Tim Lesher <tlesher at gmail.com>:


----------
keywords: +patch
Added file: http://bugs.python.org/file22238/remove-urlparse.patch

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

From report at bugs.python.org  Fri Jun  3 23:30:25 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 03 Jun 2011 21:30:25 +0000
Subject: [docs] [issue12207] Document ast.PyCF_ONLY_AST
In-Reply-To: <1306689830.34.0.885575322408.issue12207@psf.upfronthosting.co.za>
Message-ID: <1307136624.92.0.714910735079.issue12207@psf.upfronthosting.co.za>


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

This is a bit tricky. It may be superseded, but it is still there, is possible used in older code, has not been deprecated as far as I know, and appears in dir(ast).

The two current mentions of PyCF_ONLY_AST in ast doc are:

"An abstract syntax tree can be generated by passing ast.PyCF_ONLY_AST as a flag to the compile() built-in function, or using the parse() helper provided in this module." (near the top )

"ast.parse(source, filename='<unknown>', mode='exec') 
Parse the source into an AST node. Equivalent to compile(source, filename, mode, ast.PyCF_ONLY_AST)."

The first mention is referred to in the compile entry:

"compile(source, filename, mode, flags=0, dont_inherit=False, optimize=-1) 
Compile the source into a code or AST object. Code objects can be executed by exec() or eval(). source can either be a string or an AST object. Refer to the ast module documentation for information on how to work with AST objects."

In my view, it is adequately documented now, should not be undocumented, and should not be given more prominence either. So I recommend closing this.

Hmm. It should be indexed for anyone reading existing code. If possible, I would have the index point to the first current sentence, which also mentions .parse() as an alternative.

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

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

From report at bugs.python.org  Sat Jun  4 02:12:55 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 04 Jun 2011 00:12:55 +0000
Subject: [docs] [issue12237] Document how to open non-default webbrowser
In-Reply-To: <1307006042.24.0.905858439151.issue12237@psf.upfronthosting.co.za>
Message-ID: <1307146374.99.0.00447578732885.issue12237@psf.upfronthosting.co.za>


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

The intended method of using a non-default browser is well documented and the OP did exactly the right thing. However, even if Opera is present, the 'right thing' does not work because nothing but iexplorer gets registered (and that not completely usefully), even if present on the system, because the registration code is buggy, as discussed in #10799.

Hirch, if you had clicked Search and entered 'webbrowser' in the 'All text' box, you could have found that report.

If you add a note to #10799 as to the exact default location of Opera (within Program Files, I presume), it might eventually help.

----------
components: +Library (Lib)
nosy: +georg.brandl, terry.reedy
resolution:  -> duplicate
status: open -> closed
superseder:  -> Improve webbrowser.open doc (and, someday, behavior?)
type:  -> behavior

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

From report at bugs.python.org  Sat Jun  4 13:31:40 2011
From: report at bugs.python.org (=?utf-8?q?Francisco_Mart=C3=ADn_Brugu=C3=A9?=)
Date: Sat, 04 Jun 2011 11:31:40 +0000
Subject: [docs] [issue12185] Decimal documentation lists "first" and
	"second"	arguments, should be "self" and "other"
In-Reply-To: <1306411163.06.0.644918639795.issue12185@psf.upfronthosting.co.za>
Message-ID: <1307187100.76.0.754072605186.issue12185@psf.upfronthosting.co.za>


Francisco Mart?n Brugu? <francismb at email.de> added the comment:

Hi Adam,
I couldn?t see that from the threat context, I'm new to this and just
wanted to learn the work flow and tools so I've just picked up an
easy issue to start with. Anyway your patch seems more complete.

----------

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

From report at bugs.python.org  Sat Jun  4 16:47:35 2011
From: report at bugs.python.org (Mark Dickinson)
Date: Sat, 04 Jun 2011 14:47:35 +0000
Subject: [docs] [issue12185] Decimal documentation lists "first" and
	"second"	arguments, should be "self" and "other"
In-Reply-To: <1306411163.06.0.644918639795.issue12185@psf.upfronthosting.co.za>
Message-ID: <1307198855.11.0.393864256852.issue12185@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/issue12185>
_______________________________________

From report at bugs.python.org  Sat Jun  4 16:54:45 2011
From: report at bugs.python.org (Mark Dickinson)
Date: Sat, 04 Jun 2011 14:54:45 +0000
Subject: [docs] [issue12164] str.translate docstring doesn't mention that
	'table' can	be None
In-Reply-To: <1306214084.99.0.386690557918.issue12164@psf.upfronthosting.co.za>
Message-ID: <1307199285.42.0.222610863212.issue12164@psf.upfronthosting.co.za>


Mark Dickinson <dickinsm at gmail.com> added the comment:

Thanks for the patches!  Here's a slight expansion of the wording on your second patch:

 Return a copy of the string S, where all characters occurring
 in the optional argument deletechars are removed, and the
 remaining characters have been mapped through the given
 translation table, which must be a string of length 256 or None.
 If the table argument is None, no translation is applied and
 the translation simply removes the characters in deletechars.

What do you think?

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

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

From report at bugs.python.org  Sat Jun  4 17:14:43 2011
From: report at bugs.python.org (Mark Dickinson)
Date: Sat, 04 Jun 2011 15:14:43 +0000
Subject: [docs] [issue12245] Document the meaning of FLT_ROUNDS constants
	for	sys.float_info
In-Reply-To: <1307044030.93.0.176037757521.issue12245@psf.upfronthosting.co.za>
Message-ID: <1307200483.18.0.174086604847.issue12245@psf.upfronthosting.co.za>


Mark Dickinson <dickinsm at gmail.com> added the comment:

float_info.rounds is a bit of an odd fish, and I think it was probably a mistake to include it in sys.float_info in the first place.

All the other float_info fields relate to parameters of the floating-point format, which is fixed, useful information.  In contrast, float_info.rounds gives information about the current FPU settings, which are variable.  Moreover, it doesn't do that very well:  all it does is give information about the FPU settings at the time that Python was compiled, which isn't really very helpful (and perhaps not even that:  it reports the value of FLT_ROUNDS, which may not even reflect those FPU settings accurately).  I wouldn't mind seeing this field fade quietly into obscurity.

FWIW, the value is taken from C's FLT_ROUNDS, and its interpretation is *supposed* to be the following (C99 5.2.4.2.2, para 7):

  -1:  The compiler was unable to determine rounding mode.
   0:  Round towards zero.
   1:  Round to nearest (this is the most likely value for
       float_info.rounds on common platforms).
   2:  Round towards positive infinity
   3:  Round towards negative infinity.

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

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

From report at bugs.python.org  Sat Jun  4 18:18:06 2011
From: report at bugs.python.org (Mark Dickinson)
Date: Sat, 04 Jun 2011 16:18:06 +0000
Subject: [docs] [issue12245] Document the meaning of FLT_ROUNDS constants
	for	sys.float_info
In-Reply-To: <1307044030.93.0.176037757521.issue12245@psf.upfronthosting.co.za>
Message-ID: <1307204286.82.0.546921724997.issue12245@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Jun  4 18:19:09 2011
From: report at bugs.python.org (Mark Dickinson)
Date: Sat, 04 Jun 2011 16:19:09 +0000
Subject: [docs] [issue12245] Document the meaning of FLT_ROUNDS constants
	for	sys.float_info
In-Reply-To: <1307044030.93.0.176037757521.issue12245@psf.upfronthosting.co.za>
Message-ID: <1307204349.76.0.593815267828.issue12245@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Jun  4 20:08:50 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Sat, 04 Jun 2011 18:08:50 +0000
Subject: [docs] [issue12164] str.translate docstring doesn't mention that
	'table' can	be None
In-Reply-To: <1307199285.42.0.222610863212.issue12164@psf.upfronthosting.co.za>
Message-ID: <20110604180848.GB1857@ihaa>


Petri Lehtinen <petri at digip.org> added the comment:

> What do you think?

Sounds very good to my native Finnish ears :)

----------

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

From report at bugs.python.org  Sat Jun  4 20:21:34 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Sat, 04 Jun 2011 18:21:34 +0000
Subject: [docs] [issue12164] str.translate docstring doesn't mention that
	'table' can	be None
In-Reply-To: <1306214084.99.0.386690557918.issue12164@psf.upfronthosting.co.za>
Message-ID: <1307211694.98.0.241237014059.issue12164@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sun Jun  5 01:35:37 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 04 Jun 2011 23:35:37 +0000
Subject: [docs] [issue12211] math.copysign must keep object type.
In-Reply-To: <1306710150.53.0.509116993934.issue12211@psf.upfronthosting.co.za>
Message-ID: <1307230537.74.0.377698331949.issue12211@psf.upfronthosting.co.za>


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

> "Return a float with the magnitude of x but the sign of y."
This appears to describe both current behavior and what I believe was the intention. I would go with a doc patch based on this.
umedoblock, go ahead and make one.

It occurred to me, also, that as currently written, copysign 'should' return the type of the first arg. In C89, and I suspect in Python 1.0, all math functions return double (Python float). Like Mark, I am more inclined to change the doc than the code.

1. One use of copysign is to give a correctly signed 0.0. This does not apply to ints, where 0 is always unsigned. I do not know of any use of copysign in number (count/int) theory. (There could be, of course.)

2. icopysign(-1,0) == +1 (sign added for emphasis), whereas I believe that for ints, the answer should be -1, as 0 has no sign.

def icopysign(j,k):
    if (j > 0) and (k < 0) or (j < 0) and (k > 0):
        return -j
    return j
for j,k,i in ((1,1,1), (1,-1,-1), (-1,-1,-1), (-1, 1, 1),
              (1,0,1), (-1,0,-1)):
    assert icopysign(j,k) == i, (j,k,i)

This would certainly be up for debate if we changed the code, but there should be no difference in outputs for same value inputs. (This principle is the reason for / and //.) So lets leave copysign as a function defined on floats with inputs coerced to float if needed. Anyone who needs it for ints can define it for (-1,0) according to their need.

----------
assignee:  -> docs at python
components: +Documentation -Library (Lib)
nosy: +docs at python
stage:  -> needs patch
versions: +Python 2.7, Python 3.3

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

From report at bugs.python.org  Sun Jun  5 03:38:20 2011
From: report at bugs.python.org (umedoblock)
Date: Sun, 05 Jun 2011 01:38:20 +0000
Subject: [docs] [issue12211] math.copysign must keep object type.
In-Reply-To: <1306710150.53.0.509116993934.issue12211@psf.upfronthosting.co.za>
Message-ID: <1307237900.1.0.620779309616.issue12211@psf.upfronthosting.co.za>


umedoblock <umedoblock at gmail.com> added the comment:

I made the patch.
But it cannot pass testCopysign().

math.copysign(1, -0.)
returns 1.

I hope to return -1.
But I don't know how to realize -0. as negative value.

Please help me.

----------
components: +Library (Lib) -Documentation
keywords: +patch
versions:  -Python 2.7, Python 3.3
Added file: http://bugs.python.org/file22249/math_copysign.patch

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

From report at bugs.python.org  Sun Jun  5 03:50:31 2011
From: report at bugs.python.org (umedoblock)
Date: Sun, 05 Jun 2011 01:50:31 +0000
Subject: [docs] [issue12211] math.copysign must keep object type.
In-Reply-To: <1306710150.53.0.509116993934.issue12211@psf.upfronthosting.co.za>
Message-ID: <1307238631.84.0.729490884357.issue12211@psf.upfronthosting.co.za>


Changes by umedoblock <umedoblock at gmail.com>:


Removed file: http://bugs.python.org/file22249/math_copysign.patch

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

From report at bugs.python.org  Sun Jun  5 03:51:04 2011
From: report at bugs.python.org (umedoblock)
Date: Sun, 05 Jun 2011 01:51:04 +0000
Subject: [docs] [issue12211] math.copysign must keep object type.
In-Reply-To: <1306710150.53.0.509116993934.issue12211@psf.upfronthosting.co.za>
Message-ID: <1307238664.74.0.148143437209.issue12211@psf.upfronthosting.co.za>


Changes by umedoblock <umedoblock at gmail.com>:


Added file: http://bugs.python.org/file22250/math_copysign.patch

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

From report at bugs.python.org  Sun Jun  5 04:04:16 2011
From: report at bugs.python.org (umedoblock)
Date: Sun, 05 Jun 2011 02:04:16 +0000
Subject: [docs] [issue12211] math.copysign must keep object type.
In-Reply-To: <1306710150.53.0.509116993934.issue12211@psf.upfronthosting.co.za>
Message-ID: <1307239456.71.0.205635370431.issue12211@psf.upfronthosting.co.za>


Changes by umedoblock <umedoblock at gmail.com>:


Removed file: http://bugs.python.org/file22250/math_copysign.patch

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

From report at bugs.python.org  Sun Jun  5 04:09:16 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 05 Jun 2011 02:09:16 +0000
Subject: [docs] [issue12211] math.copysign must keep object type.
In-Reply-To: <1306710150.53.0.509116993934.issue12211@psf.upfronthosting.co.za>
Message-ID: <1307239756.62.0.696685380176.issue12211@psf.upfronthosting.co.za>


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

umedoblock: David, Mark, and I agree that this should be a doc issue, and so I suggested a DOC patch. So I do not know why you are screwing around with the code, or what you are trying to do with it, or why you are messing around with the version headers or why you think this is a 3.2 only issue.

----------

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

From report at bugs.python.org  Sun Jun  5 04:10:29 2011
From: report at bugs.python.org (umedoblock)
Date: Sun, 05 Jun 2011 02:10:29 +0000
Subject: [docs] [issue12211] math.copysign must keep object type.
In-Reply-To: <1306710150.53.0.509116993934.issue12211@psf.upfronthosting.co.za>
Message-ID: <1307239829.34.0.532473718677.issue12211@psf.upfronthosting.co.za>


umedoblock <umedoblock at gmail.com> added the comment:

sorry.
I fix my bug.

but this patch contain new fail...

math.copysign(-1., 0.)
returns 1.

----------
Added file: http://bugs.python.org/file22251/math_copysign.patch

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

From report at bugs.python.org  Sun Jun  5 05:36:46 2011
From: report at bugs.python.org (umedoblock)
Date: Sun, 05 Jun 2011 03:36:46 +0000
Subject: [docs] [issue12211] math.copysign must keep object type.
In-Reply-To: <1306710150.53.0.509116993934.issue12211@psf.upfronthosting.co.za>
Message-ID: <1307245006.37.0.638342849877.issue12211@psf.upfronthosting.co.za>


umedoblock <umedoblock at gmail.com> added the comment:

I attached DOC patch.

I misunderstand ?
Sorry...
I think that "go ahead and make one" means I shuold make the source patch.

I use just Python3.2. I didn't use Python 2.x, 3.0 and 3.1 in my programming life.
Therefore I reported version 3.2.
I should the versions to "3rd party" ?

----------
Added file: http://bugs.python.org/file22254/math.rst.patch

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

From report at bugs.python.org  Sun Jun  5 08:08:52 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 05 Jun 2011 06:08:52 +0000
Subject: [docs] [issue12211] Better document math.copysign behavior.
In-Reply-To: <1306710150.53.0.509116993934.issue12211@psf.upfronthosting.co.za>
Message-ID: <1307254132.28.0.886028202331.issue12211@psf.upfronthosting.co.za>


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

Third party refers to things other than Pythonx.y code For instance, distutils2/distribute was for some years developed separately from the main codebase and was recently merged into the 3.3 repository. While separate, its issues were '3rd party'. That has nothing to do with this.

A patch against 3.2 is fine. It will almost certainly apply unchanged to both 3.3 and 2.7 since this part of the doc may have never changed since written. The patch looks fine so far. I see that you kept the line just under 80 characters. Now, can you expand it to also change the docstring for this function in the mathmodule.c file? I am not exactly sure where it is in the file, relative to the function code itself. As I remember, it is not as convenient as in Python files.
It currently looks like

    copysign(x, y)
    
    Return x with the sign of y.

When revising the "Return ..." part to match the doc, I think we should include the "On a platform ..." sentence also. If Mark disagrees, it would be easily removed. Notice that the indent is 1 or 2 more spaces, so the existing line would become too long. 'a platform' could be changed to 'platforms'. I personally like that better anyway.

----------
components: +Documentation -Library (Lib)
title: math.copysign must keep object type. -> Better document math.copysign behavior.
versions: +Python 2.7, Python 3.3

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

From report at bugs.python.org  Sun Jun  5 10:12:08 2011
From: report at bugs.python.org (Mark Dickinson)
Date: Sun, 05 Jun 2011 08:12:08 +0000
Subject: [docs] [issue12211] Better document math.copysign behavior.
In-Reply-To: <1306710150.53.0.509116993934.issue12211@psf.upfronthosting.co.za>
Message-ID: <1307261528.69.0.666365841805.issue12211@psf.upfronthosting.co.za>


Mark Dickinson <dickinsm at gmail.com> added the comment:

> I think we should include the "On a platform ..."

Sure, sounds good.  One of the main things that makes copysign useful is that it distinguishes between -0.0 and 0.0.

----------

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

From report at bugs.python.org  Sun Jun  5 13:29:21 2011
From: report at bugs.python.org (Antoine Pitrou)
Date: Sun, 05 Jun 2011 11:29:21 +0000
Subject: [docs] [issue12134] json.dump much slower than dumps
In-Reply-To: <1306611729.68.0.107395742186.issue12134@psf.upfronthosting.co.za>
Message-ID: <1307273357.3540.4.camel@localhost.localdomain>


Antoine Pitrou <pitrou at free.fr> added the comment:

> "In CPython, json.dumps(o), by itself, is faster than json.dump(o,f),
> at the expense of using more space, because it creates the entire
> string at once, instead of incrementally writing each piece of o to f.
> However, f.write(json.dumps(o)) may not be faster."

Uh, talking about "CPython" is not very helpful here and only muddies
the waters IMO.
Something like "typical implementations of dump() will try to write the
result in small chunks and will therefore trade lower memory usage for
higher serialization time. If you have enough memory and care about
performance, consider using dumps() and write the result yourself with a
single write() call".

----------

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

From report at bugs.python.org  Sun Jun  5 19:30:34 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 05 Jun 2011 17:30:34 +0000
Subject: [docs] [issue12134] json.dump much slower than dumps
In-Reply-To: <1305985086.83.0.259963774289.issue12134@psf.upfronthosting.co.za>
Message-ID: <1307295034.55.0.724870569018.issue12134@psf.upfronthosting.co.za>


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

With 'will try to ' and the next 'will ' omitted, I agree that Antoine's version is better than mine.

----------

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

From report at bugs.python.org  Sun Jun  5 20:38:41 2011
From: report at bugs.python.org (poq)
Date: Sun, 05 Jun 2011 18:38:41 +0000
Subject: [docs] [issue12134] json.dump much slower than dumps
In-Reply-To: <1305985086.83.0.259963774289.issue12134@psf.upfronthosting.co.za>
Message-ID: <1307299121.07.0.0500894684233.issue12134@psf.upfronthosting.co.za>


poq <poq at gmx.com> added the comment:

dump() is not slower because it's incremental though. It's slower because it's pure Python. I don't think there is necessarily a memory/speed trade-off; it should be possible to write an incremental encoder in C as well.

----------

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

From report at bugs.python.org  Mon Jun  6 13:27:14 2011
From: report at bugs.python.org (Xuanji Li)
Date: Mon, 06 Jun 2011 11:27:14 +0000
Subject: [docs] [issue10376] ZipFile unzip is unbuffered
In-Reply-To: <1289317915.09.0.657677437465.issue10376@psf.upfronthosting.co.za>
Message-ID: <1307359634.88.0.850228870518.issue10376@psf.upfronthosting.co.za>


Changes by Xuanji Li <xuanji at gmail.com>:


----------
nosy: +xuanji

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

From report at bugs.python.org  Mon Jun  6 18:12:18 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 06 Jun 2011 16:12:18 +0000
Subject: [docs] [issue9302] distutils API Reference: setup() and
	Extension	parameters' description not correct.
In-Reply-To: <1279532605.75.0.42010773345.issue9302@psf.upfronthosting.co.za>
Message-ID: <1307376738.33.0.391573366095.issue9302@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Tue Jun  7 00:55:53 2011
From: report at bugs.python.org (R. David Murray)
Date: Mon, 06 Jun 2011 22:55:53 +0000
Subject: [docs] [issue9302] distutils API Reference: setup() and
	Extension	parameters' description not correct.
In-Reply-To: <1279532605.75.0.42010773345.issue9302@psf.upfronthosting.co.za>
Message-ID: <1307400953.31.0.120872944509.issue9302@psf.upfronthosting.co.za>


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

Why was this issue set to pending?  No motivating comment was added.

----------
nosy: +r.david.murray
status: pending -> open

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

From report at bugs.python.org  Tue Jun  7 01:19:38 2011
From: report at bugs.python.org (Nick ODell)
Date: Mon, 06 Jun 2011 23:19:38 +0000
Subject: [docs] [issue10405] IDLE breakpoint facility undocumented
In-Reply-To: <1289638474.62.0.690259510388.issue10405@psf.upfronthosting.co.za>
Message-ID: <1307402378.49.0.553679486005.issue10405@psf.upfronthosting.co.za>


Nick ODell <nickodell at gmail.com> added the comment:

I've added a short note regarding breakpoints in Doc/library/idle.rst

Ned, I'm not an experienced user with IDLE by any means, but I think some documentation is better than none, no?

----------
nosy: +Nick.ODell
Added file: http://bugs.python.org/file22268/idle.rst

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

From report at bugs.python.org  Tue Jun  7 04:33:55 2011
From: report at bugs.python.org (Nick Coghlan)
Date: Tue, 07 Jun 2011 02:33:55 +0000
Subject: [docs] [issue11690] Devguide: Add "communication" FAQ
In-Reply-To: <1301188192.33.0.9529618781.issue11690@psf.upfronthosting.co.za>
Message-ID: <1307414034.89.0.885990505511.issue11690@psf.upfronthosting.co.za>


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

On a related note, http://docs.python.org/devguide/docquality.html should mention that the devguide itself lives in a different repo but the process is otherwise similar to contributing to the main docs.

----------

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

From report at bugs.python.org  Tue Jun  7 11:45:51 2011
From: report at bugs.python.org (=?utf-8?q?Bo=C5=A1tjan_Mejak?=)
Date: Tue, 07 Jun 2011 09:45:51 +0000
Subject: [docs] [issue12277] Missing comma in os.walk docs
In-Reply-To: <1307439951.32.0.810805209718.issue12277@psf.upfronthosting.co.za>
Message-ID: <1307439951.32.0.810805209718.issue12277@psf.upfronthosting.co.za>


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

http://docs.python.org/release/2.6.6/library/os.html?highlight=os.walk#os.walk

Click the above link and note the 5th paragraph which goes "By default errors from the listdir() call are ignored."

Please fix it to "By default, errors from the listdir() call are ignored."

So add a comma after "By default," Thanks.

----------
assignee: docs at python
components: Documentation
messages: 137795
nosy: Retro, docs at python
priority: normal
severity: normal
status: open
title: Missing comma in os.walk docs
versions: 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/issue12277>
_______________________________________

From report at bugs.python.org  Tue Jun  7 13:23:55 2011
From: report at bugs.python.org (Antoine Pitrou)
Date: Tue, 07 Jun 2011 11:23:55 +0000
Subject: [docs] [issue12188] PEP 7, C style: add ++ policy and explanation
In-Reply-To: <1306433972.91.0.882585972593.issue12188@psf.upfronthosting.co.za>
Message-ID: <1307445835.82.0.81668559565.issue12188@psf.upfronthosting.co.za>


Antoine Pitrou <pitrou at free.fr> added the comment:

Indeed, I don't think that's appropriate. Also, it's not about ++ in general but a particular use of it.

----------
nosy: +gvanrossum, pitrou
resolution:  -> rejected
status: open -> pending
type:  -> feature request

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

From report at bugs.python.org  Tue Jun  7 13:36:32 2011
From: report at bugs.python.org (Eric V. Smith)
Date: Tue, 07 Jun 2011 11:36:32 +0000
Subject: [docs] [issue12188] PEP 7, C style: add ++ policy and explanation
In-Reply-To: <1306433972.91.0.882585972593.issue12188@psf.upfronthosting.co.za>
Message-ID: <1307446592.87.0.435446903286.issue12188@psf.upfronthosting.co.za>


Eric V. Smith <eric at trueblade.com> added the comment:

But don't you think we should put information like this somewhere, even if it's not in PEP 7? We've had a discussion about this particular issue (idiomatic pointer increments when appending to a buffer) at least twice, and there's also the recent "if (const == variable)" issue that feels similar to me.

It seems to me that recording these decisions somewhere has value, just so we don't have to revisit them.

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

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

From report at bugs.python.org  Tue Jun  7 13:38:03 2011
From: report at bugs.python.org (Antoine Pitrou)
Date: Tue, 07 Jun 2011 11:38:03 +0000
Subject: [docs] [issue11203] gzip doc is behind
In-Reply-To: <1297539632.81.0.320134391105.issue11203@psf.upfronthosting.co.za>
Message-ID: <1307446683.91.0.25156461461.issue11203@psf.upfronthosting.co.za>


Antoine Pitrou <pitrou at free.fr> added the comment:

The 3.x doc states that "GzipFile supports the io.BufferedIOBase interface, including iteration and the with statement. Only the truncate() method isn?t implemented". This implies that it also supports close().

----------
nosy: +pitrou
versions:  -Python 3.1, Python 3.2, Python 3.3

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

From report at bugs.python.org  Tue Jun  7 13:51:25 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Tue, 07 Jun 2011 11:51:25 +0000
Subject: [docs] [issue12188] PEP 7, C style: add ++ policy and explanation
In-Reply-To: <1306433972.91.0.882585972593.issue12188@psf.upfronthosting.co.za>
Message-ID: <1307447485.75.0.601503213678.issue12188@psf.upfronthosting.co.za>


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

If there are a few of these idioms, I'm not against adding a new section  to PEP 7 (something like the "Programming Recommendations" section in the PEP 8).  It's just not worth doing it for the "*p++ = x;" idiom alone IMHO.

----------

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

From report at bugs.python.org  Tue Jun  7 13:53:11 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Tue, 07 Jun 2011 11:53:11 +0000
Subject: [docs] [issue12277] Missing comma in os.walk docs
In-Reply-To: <1307439951.32.0.810805209718.issue12277@psf.upfronthosting.co.za>
Message-ID: <1307447591.71.0.716156374117.issue12277@psf.upfronthosting.co.za>


Petri Lehtinen <petri at digip.org> added the comment:

Here's a patch.

----------
keywords: +patch
nosy: +petri.lehtinen
Added file: http://bugs.python.org/file22272/docs_os_walk_add_comma.patch

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

From report at bugs.python.org  Tue Jun  7 13:56:32 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Tue, 07 Jun 2011 11:56:32 +0000
Subject: [docs] [issue12277] Missing comma in os.walk docs
In-Reply-To: <1307439951.32.0.810805209718.issue12277@psf.upfronthosting.co.za>
Message-ID: <1307447792.35.0.270045499243.issue12277@psf.upfronthosting.co.za>


Changes by Petri Lehtinen <petri at digip.org>:


----------
versions:  -Python 2.6, Python 3.4

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

From report at bugs.python.org  Tue Jun  7 13:56:43 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Tue, 07 Jun 2011 11:56:43 +0000
Subject: [docs] [issue12277] Missing comma in os.walk docs
In-Reply-To: <1307439951.32.0.810805209718.issue12277@psf.upfronthosting.co.za>
Message-ID: <1307447803.85.0.322561927137.issue12277@psf.upfronthosting.co.za>


Changes by Petri Lehtinen <petri at digip.org>:


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

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

From report at bugs.python.org  Tue Jun  7 13:58:54 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Tue, 07 Jun 2011 11:58:54 +0000
Subject: [docs] [issue11669] Clarify Lang Ref "Compound statements" footnote
In-Reply-To: <1301042574.67.0.975748752077.issue11669@psf.upfronthosting.co.za>
Message-ID: <1307447934.84.0.719277268572.issue11669@psf.upfronthosting.co.za>


Petri Lehtinen <petri at digip.org> added the comment:

Keywords suggest that there should to be a patch here. Where is it?

----------
nosy: +petri.lehtinen

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

From report at bugs.python.org  Tue Jun  7 14:02:53 2011
From: report at bugs.python.org (Antoine Pitrou)
Date: Tue, 07 Jun 2011 12:02:53 +0000
Subject: [docs] [issue12188] PEP 7, C style: add ++ policy and explanation
In-Reply-To: <1307447485.75.0.601503213678.issue12188@psf.upfronthosting.co.za>
Message-ID: <1307448169.3530.3.camel@localhost.localdomain>


Antoine Pitrou <pitrou at free.fr> added the comment:

> If there are a few of these idioms, I'm not against adding a new
> section  to PEP 7 (something like the "Programming Recommendations"
> section in the PEP 8).  It's just not worth doing it for the "*p++ =
> x;" idiom alone IMHO.

If these are recommandations, perhaps we should put them in the devguide
instead?

But I agree that it's not worth doing it only for "*p++" anyway.

----------

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

From report at bugs.python.org  Tue Jun  7 15:16:11 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Tue, 07 Jun 2011 13:16:11 +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: <1307452571.82.0.930362330458.issue11784@psf.upfronthosting.co.za>


Petri Lehtinen <petri at digip.org> added the comment:

The patch looks good to me and applies cleanly on top of 3.3 and 2.7.

----------
nosy: +petri.lehtinen
versions: +Python 2.7, Python 3.3

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

From report at bugs.python.org  Tue Jun  7 17:07:55 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Tue, 07 Jun 2011 15:07:55 +0000
Subject: [docs] [issue9302] distutils API Reference: setup() and
	Extension	parameters' description not correct.
In-Reply-To: <1279532605.75.0.42010773345.issue9302@psf.upfronthosting.co.za>
Message-ID: <1307459275.62.0.737210921023.issue9302@psf.upfronthosting.co.za>


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

Sorry, I thought updating the status was enough to convey ?I?m about to commit this?.

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

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

From report at bugs.python.org  Tue Jun  7 17:14:30 2011
From: report at bugs.python.org (R. David Murray)
Date: Tue, 07 Jun 2011 15:14:30 +0000
Subject: [docs] [issue9302] distutils API Reference: setup() and
	Extension	parameters' description not correct.
In-Reply-To: <1279532605.75.0.42010773345.issue9302@psf.upfronthosting.co.za>
Message-ID: <1307459670.25.0.86715827466.issue9302@psf.upfronthosting.co.za>


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

Um, no.

'pending' is 'pending close', specifically meaning, 'this issue is going to be closed (with a rejected status of some sort) unless someone objects or provides more information.'

Someday, pending issues will be autoclosed after N days.  Quite possibly this summer, since Ezio is working on roundup this summer.

----------

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

From report at bugs.python.org  Tue Jun  7 17:35:26 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Tue, 07 Jun 2011 15:35:26 +0000
Subject: [docs] [issue9302] distutils API Reference: setup() and
	Extension	parameters' description not correct.
In-Reply-To: <1279532605.75.0.42010773345.issue9302@psf.upfronthosting.co.za>
Message-ID: <1307460925.9.0.450498616603.issue9302@psf.upfronthosting.co.za>


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

Oh, thanks for clearing a misunderstanding I?ve had for a year!  I was using the pending status to prioritize issues (I have a personal ?assigned to me + pending? query, now I?ll use priority instead.

----------

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

From report at bugs.python.org  Tue Jun  7 17:35:56 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Tue, 07 Jun 2011 15:35:56 +0000
Subject: [docs] [issue9302] distutils API Reference: setup() and
	Extension	parameters' description not correct.
In-Reply-To: <1279532605.75.0.42010773345.issue9302@psf.upfronthosting.co.za>
Message-ID: <1307460956.86.0.970305311009.issue9302@psf.upfronthosting.co.za>


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

This also explains why any new message cancels the pending status, BTW.

----------

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

From report at bugs.python.org  Tue Jun  7 18:56:35 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Tue, 07 Jun 2011 16:56:35 +0000
Subject: [docs] [issue11203] gzip doc is behind
In-Reply-To: <1297539632.81.0.320134391105.issue11203@psf.upfronthosting.co.za>
Message-ID: <1307465795.4.0.299695603109.issue11203@psf.upfronthosting.co.za>


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

> This implies that it also supports close().
One has to follow the link to BufferedIOBase and then to IOBase, but I think it?s okay.

Richard: Does that address your issue?

----------

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

From report at bugs.python.org  Tue Jun  7 18:59:32 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Tue, 07 Jun 2011 16:59:32 +0000
Subject: [docs] [issue12277] Missing comma in os.walk docs
In-Reply-To: <1307439951.32.0.810805209718.issue12277@psf.upfronthosting.co.za>
Message-ID: <1307465972.26.0.0463219779716.issue12277@psf.upfronthosting.co.za>


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

I have included this in a patch I?m preparing to fix several typos at once.

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

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

From report at bugs.python.org  Tue Jun  7 19:07:30 2011
From: report at bugs.python.org (K Richard Pixley)
Date: Tue, 07 Jun 2011 17:07:30 +0000
Subject: [docs] [issue11203] gzip doc is behind
In-Reply-To: <1297539632.81.0.320134391105.issue11203@psf.upfronthosting.co.za>
Message-ID: <1307466450.81.0.616603024277.issue11203@psf.upfronthosting.co.za>


K Richard Pixley <rich at noir.com> added the comment:

My point was for python-2.7.  I haven't stumbled into the buffer protocol yet.  So no, it doesn't really.

I still think the documentation, especially the 2.7 doc, could be more explicit.

My concern here is with the use of close() becoming obscure, a second class citizen, or an afterthought.  While I greatly appreciate the context manager, there are times when I want an enduring open channel for which the context manager just isn't appropriate.  Even in a world with context manager, open and close need to be available and presented as a pair.

It isn't clear to me from reading the doc or looking at the examples that gzip is expected to support a close call.  Yes, I concur that there is an implication, but I would prefer to see it stated explicitly along with the explicit statement that it supports an open call.

----------

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

From report at bugs.python.org  Tue Jun  7 19:19:40 2011
From: report at bugs.python.org (Jonas H.)
Date: Tue, 07 Jun 2011 17:19:40 +0000
Subject: [docs] [issue11975] Fix referencing of built-in types (list, int,
	...)
In-Reply-To: <1304281262.53.0.265979216697.issue11975@psf.upfronthosting.co.za>
Message-ID: <1307467180.35.0.336901963074.issue11975@psf.upfronthosting.co.za>


Jonas H. <jonas at lophus.org> added the comment:

Having one page with two objects of the same name, e.g.

  .. function:: foo

  .. class:: foo

renders to two entries with the same anchor name (#foo). The first entry gets a link-to-this-paragraph marker, the second one doesn't.

Internal references (from within the same document) always link to the first entry because they use #foo anchor. (So if you put the class directive first, all links go to the class anchor.)

The first external reference (using intersphinx) always goes to the first target document element - no matter which type both have. The second reference isn't turned into a hyperlink.

This behaviour seems consistent with how HTML anchors work.

Having the two objects on two different pages however shows slightly odd results. Say we have this code on page 1:

  .. class:: foo

  :class:`foo`
  :func:`foo`

and

  .. function:: foo

on page 2, then both links in page 1 go to the page 1 'foo' (the class). However if you change order (putting the func role before the class role), those links go to the page 2 'foo' (the function).

All intersphinx-ed links go to the object on page 1, no matter the role order on page 1 or the external page.


I think we can conclude that using class and function directives at the same time doesn't help very much...

----------

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

From report at bugs.python.org  Tue Jun  7 19:25:53 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Tue, 07 Jun 2011 17:25:53 +0000
Subject: [docs] [issue11203] gzip doc is behind
In-Reply-To: <1297539632.81.0.320134391105.issue11203@psf.upfronthosting.co.za>
Message-ID: <1307467553.29.0.778072772368.issue11203@psf.upfronthosting.co.za>


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

In 2.7, while there is no index-generating entry for the close method, it is mentioned: ?Calling a GzipFile object?s close() method [...]?.

> Yes, I concur that there is an implication, but I would prefer to see
> it stated explicitly along with the explicit statement that it
> supports an open call.

I wouldn?t like to see the docs for int, float, complex, Decimal, Fraction, GzipFile, BZ2File, BytesIO, StringIO and all others having duplicated lists of methods and attributes that are already documented in the doc of the ABC.

----------

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

From report at bugs.python.org  Tue Jun  7 19:38:56 2011
From: report at bugs.python.org (K Richard Pixley)
Date: Tue, 07 Jun 2011 17:38:56 +0000
Subject: [docs] [issue11203] gzip doc is behind
In-Reply-To: <1297539632.81.0.320134391105.issue11203@psf.upfronthosting.co.za>
Message-ID: <1307468336.67.0.0377935913221.issue11203@psf.upfronthosting.co.za>


K Richard Pixley <rich at noir.com> added the comment:

An interesting point, although I think that's only relevant if the documentation lists the ABC and a reference to it.  (python-3 doc essentially does this.)

I see no such reference in the 2.7 gzipfile doc, which leads me to believe, (from the doc alone), that it's an independent implementation of a "file like object".

This may not be important enough to even merit the time we've already put into it.  Please feel free to close this ticket without change if you prefer.

----------

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

From report at bugs.python.org  Tue Jun  7 19:41:48 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Tue, 07 Jun 2011 17:41:48 +0000
Subject: [docs] [issue11203] gzip doc is behind
In-Reply-To: <1297539632.81.0.320134391105.issue11203@psf.upfronthosting.co.za>
Message-ID: <1307468508.27.0.101614050106.issue11203@psf.upfronthosting.co.za>


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

> I see no such reference in the 2.7 gzipfile doc

Did you miss the first part of my previous message?  The 2.7 docs for GzipFile do not link to the ABC, but they mention the close method in plain text.

----------

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

From report at bugs.python.org  Tue Jun  7 19:46:59 2011
From: report at bugs.python.org (K Richard Pixley)
Date: Tue, 07 Jun 2011 17:46:59 +0000
Subject: [docs] [issue11203] gzip doc is behind
In-Reply-To: <1297539632.81.0.320134391105.issue11203@psf.upfronthosting.co.za>
Message-ID: <1307468819.62.0.218822416969.issue11203@psf.upfronthosting.co.za>


K Richard Pixley <rich at noir.com> added the comment:

I didn't miss it.

I think the close call needs equal treatment to the open call.  The mention is certainly present, but seems implicit to me.  I would prefer to see it listed explicitly.

But I also don't think it's important enough in the 2.7 docs to discuss it much further.  You've convinced me that it's not worth fixing.  Let's drop it.

----------

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

From report at bugs.python.org  Tue Jun  7 22:39:06 2011
From: report at bugs.python.org (Bryce Verdier)
Date: Tue, 07 Jun 2011 20:39:06 +0000
Subject: [docs] [issue12243] getpass.getuser works on OSX
In-Reply-To: <1307029704.02.0.858553376312.issue12243@psf.upfronthosting.co.za>
Message-ID: <1307479146.25.0.0621550411807.issue12243@psf.upfronthosting.co.za>


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

I like the idea as well. But I'm not sure what is needed in order to help.

----------

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

From report at bugs.python.org  Tue Jun  7 23:54:02 2011
From: report at bugs.python.org (K Richard Pixley)
Date: Tue, 07 Jun 2011 21:54:02 +0000
Subject: [docs] [issue11203] gzip doc is behind
In-Reply-To: <1297539632.81.0.320134391105.issue11203@psf.upfronthosting.co.za>
Message-ID: <1307483642.74.0.0805736763917.issue11203@psf.upfronthosting.co.za>


K Richard Pixley <rich at noir.com> added the comment:

I'm now convinced this isn't worth fixing in 2.x.

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

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

From report at bugs.python.org  Wed Jun  8 00:28:40 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Tue, 07 Jun 2011 22:28:40 +0000
Subject: [docs] [issue11975] Fix referencing of built-in types (list, int,
	...)
In-Reply-To: <1304281262.53.0.265979216697.issue11975@psf.upfronthosting.co.za>
Message-ID: <1307485719.9.0.429615651435.issue11975@psf.upfronthosting.co.za>


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

What if in the functions.rst page we specify the current module for all the functions (or even just for int/float/etc) as __builtin__ and use the function directive, and in the stdtypes.rst (or elsewhere) we use the class directive?
The idea is to pretend that '__builtin__.int' is a function in the __builtin__ module whereas 'int' is a global object.  In this way :func/class:`int` will probably link to the stdtypes.rst page, and :func/class:`~__builtin__.int` can be used to link to the functions.rst page (or the other way around if we want to link to the functions.rst page more often).  This is only a workaround though (assuming that it works), changing Sphinx to be smarter might be a better option.

----------

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

From report at bugs.python.org  Wed Jun  8 06:06:39 2011
From: report at bugs.python.org (umedoblock)
Date: Wed, 08 Jun 2011 04:06:39 +0000
Subject: [docs] [issue12211] Better document math.copysign behavior.
In-Reply-To: <1306710150.53.0.509116993934.issue12211@psf.upfronthosting.co.za>
Message-ID: <1307505998.94.0.955672580021.issue12211@psf.upfronthosting.co.za>


umedoblock <umedoblock at gmail.com> added the comment:

I'm late, sorry.

I attached the patch for math.rst and mathmodule.c.

----------
Added file: http://bugs.python.org/file22278/issue_12211.patch

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

From report at bugs.python.org  Thu Jun  9 05:18:23 2011
From: report at bugs.python.org (R. David Murray)
Date: Thu, 09 Jun 2011 03:18:23 +0000
Subject: [docs] [issue12243] getpass.getuser works on OSX
In-Reply-To: <1307029704.02.0.858553376312.issue12243@psf.upfronthosting.co.za>
Message-ID: <1307589503.83.0.950800606548.issue12243@psf.upfronthosting.co.za>


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

It requires adding code to support a new Sphinx directive.  I'm not sure if it should be a generic Sphinx directive (in which case we should open an issue on the Sphinx bug tracker) or Python specific.  If the latter, I can't at the moment tell you where the python-specific Sphinx code lives, but someone will know.

----------

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

From jelle at benext.eu  Wed Jun  1 10:12:30 2011
From: jelle at benext.eu (Jelle Verstraaten)
Date: Wed, 1 Jun 2011 10:12:30 +0200
Subject: [docs] Suggest tempfile module in os.tmpfile documentation
Message-ID: <2CE1903A72CC464B8FB0FB71566B6FA232A025@nikita.huiberts.local>

I recently found myself in need of a temporary file and ran into the
os.tmpfile function. After some more research[1] I found out that using
this file isn't recommended, but no mention is made of the tempfile

module.

 

 

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

From svenbrauch at googlemail.com  Thu Jun  2 21:50:47 2011
From: svenbrauch at googlemail.com (Sven Brauch)
Date: Thu, 2 Jun 2011 21:50:47 +0200
Subject: [docs] Function return types
Message-ID: <BANLkTikYJyCxzQ_Qy5Byq2+n7KPbwr594w@mail.gmail.com>

Hi there!

I noticed there's no standard way on docs.python.org in which return
types of functions are specified. Sometimes the return type can be
read out of the description, sometimes it can't; but there's no easy
way to see what kind of data a function is likely to return. What do
you think about adding such an attribute? I'd be happy to help adding
those where it seems necessary.

Bye,
Sven

From tshepang at gmail.com  Fri Jun  3 01:56:09 2011
From: tshepang at gmail.com (Tshepang Lekhonkhobe)
Date: Fri, 03 Jun 2011 01:56:09 +0200
Subject: [docs] Which version of sphinx?
Message-ID: <1307058973.29551.2.camel@debian>

Hi,

Is there any reason Sphinx version was specified here:
http://docs.python.org/dev/documenting/building.html?


From siwego at gmail.com  Mon Jun  6 21:27:00 2011
From: siwego at gmail.com (siwy_)
Date: Mon, 06 Jun 2011 21:27:00 +0200
Subject: [docs] globals
Message-ID: <4DED2A04.6010006@gmail.com>

I am affraid that there is nothing said about global variables inside 
def: blocks

that supports me some problems that solution could be found in internet

s1w
<mailto:docs%40python.org>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20110606/6fe093b2/attachment.html>

From amrood.admin at gmail.com  Tue Jun  7 22:55:29 2011
From: amrood.admin at gmail.com (Mohtashim)
Date: Wed, 8 Jun 2011 00:55:29 +0400
Subject: [docs] Python Tutorial PDF
Message-ID: <BANLkTi=id5Gh3ewWGRASxpBychnDOGp9VQ@mail.gmail.com>

Hi,

It would be useful if you can add
http://www.tutorialspoint.com/python/python_pdf_version.htm

at the following link http://wiki.python.org/moin/BeginnersGuide

Regards
Mohtashim
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20110608/6581f6ff/attachment.html>

From hhdxlx at gmail.com  Wed Jun  8 20:08:20 2011
From: hhdxlx at gmail.com (=?gb2312?B?wfXk7CBBbGV4IExpdQ==?=)
Date: Thu, 9 Jun 2011 02:08:20 +0800
Subject: [docs] Translation Project
Message-ID: <5AD4B4E7B0A24E2CB11E51E3FCB1A090@ShawServer>

Hello there:

I come from China, I want to translate the Python Documentation to Chinese. I don't have any experience, so can you give me any suggest. Thank you so much!

I?ve hosted this project on googlecode, and translated several html files. I saw it?s quite a big project, and googlecode can't manage it well, and translate html files is not so reusability and hard to manage.

How do you cooperate to write the Documentation? You can help me.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20110609/ace3ba6a/attachment.html>

From report at bugs.python.org  Thu Jun  9 13:16:32 2011
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 09 Jun 2011 11:16:32 +0000
Subject: [docs] [issue1626300] 'Installing Python Modules' does not work for
	Windows
Message-ID: <E1QUdDy-0001PN-L0@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 2951641faed1 by ?ric Araujo in branch '2.7':
Add examples that work on Windows to distutils docs (#1626300)
http://hg.python.org/cpython/rev/2951641faed1

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

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

From report at bugs.python.org  Thu Jun  9 13:39:57 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 09 Jun 2011 11:39:57 +0000
Subject: [docs] [issue12243] getpass.getuser works on OSX
In-Reply-To: <1307029704.02.0.858553376312.issue12243@psf.upfronthosting.co.za>
Message-ID: <1307619597.13.0.217695103337.issue12243@psf.upfronthosting.co.za>


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

That would be Doc/tools/sphinxext/pyspecific.py

----------

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

From report at bugs.python.org  Thu Jun  9 13:45:02 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 09 Jun 2011 11:45:02 +0000
Subject: [docs] [issue11975] Fix referencing of built-in types (list, int,
	...)
In-Reply-To: <1304281262.53.0.265979216697.issue11975@psf.upfronthosting.co.za>
Message-ID: <1307619902.25.0.815288748463.issue11975@psf.upfronthosting.co.za>


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

I don?t like the idea of built-in functions being displayed as ?builtins.int?: normal use of builtins is without explicit use of the module name.

----------

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

From report at bugs.python.org  Thu Jun  9 13:47:52 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 09 Jun 2011 11:47:52 +0000
Subject: [docs] [issue11203] gzip doc is behind
In-Reply-To: <1297539632.81.0.320134391105.issue11203@psf.upfronthosting.co.za>
Message-ID: <1307620072.58.0.113379967878.issue11203@psf.upfronthosting.co.za>


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

Just one thing:
> I think the close call needs equal treatment to the open call.

The open call is a module-level functions; the close method of GzipFile cannot be equally treated, as it is in the doc of the class, where no methods are given special treatment :)

----------

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

From report at bugs.python.org  Thu Jun  9 14:10:58 2011
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 09 Jun 2011 12:10:58 +0000
Subject: [docs] [issue1626300] 'Installing Python Modules' does not work for
	Windows
Message-ID: <E1QUe4e-0006Fw-Dy@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 072dbebaa83b by ?ric Araujo in branch '3.2':
Add examples that work on Windows to distutils docs (#1626300)
http://hg.python.org/cpython/rev/072dbebaa83b

----------

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

From report at bugs.python.org  Thu Jun  9 14:10:58 2011
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 09 Jun 2011 12:10:58 +0000
Subject: [docs] [issue9312] Fix usage of :option: markup in stdlib ReST docs
In-Reply-To: <1279599587.56.0.337150515932.issue9312@psf.upfronthosting.co.za>
Message-ID: <E1QUe4e-0006Fw-Dr@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 59d785ea0039 by ?ric Araujo in branch '3.2':
Fix a few misuses of :option: I missed in r86521.
http://hg.python.org/cpython/rev/59d785ea0039

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

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

From report at bugs.python.org  Thu Jun  9 14:21:31 2011
From: report at bugs.python.org (Fredrik Wendt)
Date: Thu, 09 Jun 2011 12:21:31 +0000
Subject: [docs] [issue12293] wrong arguments passed to SMTP.sendmail in
	example
In-Reply-To: <1307622091.83.0.868143597112.issue12293@psf.upfronthosting.co.za>
Message-ID: <1307622091.83.0.868143597112.issue12293@psf.upfronthosting.co.za>


New submission from Fredrik Wendt <fredrik at wendt.se>:

On http://docs.python.org/library/email-examples.html#email-examples the current example (v2.7.1) at the bottom incorrectly calls SMTP.sendmail() with a single recipient e-mail address. It should be a list of addresses.

----------
assignee: docs at python
components: Documentation
messages: 137960
nosy: docs at python, wendt_se
priority: normal
severity: normal
status: open
title: wrong arguments passed to SMTP.sendmail in example
versions: Python 2.7

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

From report at bugs.python.org  Thu Jun  9 14:27:32 2011
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 09 Jun 2011 12:27:32 +0000
Subject: [docs] [issue9312] Fix usage of :option: markup in stdlib ReST docs
In-Reply-To: <1279599587.56.0.337150515932.issue9312@psf.upfronthosting.co.za>
Message-ID: <E1QUeKg-0007Sh-US@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 7164bdfa0b0b by ?ric Araujo in branch '2.7':
Fix a few misuses of :option: I missed in r86521.
http://hg.python.org/cpython/rev/7164bdfa0b0b

----------

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

From report at bugs.python.org  Thu Jun  9 14:28:00 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 09 Jun 2011 12:28:00 +0000
Subject: [docs] [issue1626300] 'Installing Python Modules' does not work for
	Windows
Message-ID: <1307622480.8.0.0255960834939.issue1626300@psf.upfronthosting.co.za>


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

This is now fixed in the distutils Installing and Distributing guides.  Does the same problem apply to the new docs using packaging and the pysetup script?  Please check http://docs.python.org/dev/packaging and http://docs.python.org/dev/install

----------

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

From report at bugs.python.org  Thu Jun  9 15:14:46 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 09 Jun 2011 13:14:46 +0000
Subject: [docs] [issue12293] wrong arguments passed to SMTP.sendmail in
	example
In-Reply-To: <1307622091.83.0.868143597112.issue12293@psf.upfronthosting.co.za>
Message-ID: <1307625286.22.0.849567761803.issue12293@psf.upfronthosting.co.za>


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


----------
assignee: docs at python -> r.david.murray
nosy: +r.david.murray
versions: +Python 3.2, Python 3.3

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

From report at bugs.python.org  Thu Jun  9 16:33:28 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 09 Jun 2011 14:33:28 +0000
Subject: [docs] [issue10224] Build 3.x documentation using python3.x
In-Reply-To: <1288304199.49.0.7053863257.issue10224@psf.upfronthosting.co.za>
Message-ID: <1307630008.37.0.906961368139.issue10224@psf.upfronthosting.co.za>


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

> In either case, there's a high likelihood the PYTHON default will
> resolve to 3.3a0 for any Python developer.

Ah, I understand the reason for the phrasing in your patch: UNIX systems typically install 3.x as python3, not python, so the high likelihood is only for Windows and a few UNIX systems like Arch.

----------

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

From report at bugs.python.org  Thu Jun  9 17:22:39 2011
From: report at bugs.python.org (Georg Brandl)
Date: Thu, 09 Jun 2011 15:22:39 +0000
Subject: [docs] [issue11975] Fix referencing of built-in types (list, int,
	...)
In-Reply-To: <1304281262.53.0.265979216697.issue11975@psf.upfronthosting.co.za>
Message-ID: <1307632959.19.0.566338739525.issue11975@psf.upfronthosting.co.za>


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

Same here.

----------

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

From report at bugs.python.org  Thu Jun  9 17:29:55 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 09 Jun 2011 15:29:55 +0000
Subject: [docs] [issue8617] Better document user site-packages in site
	module doc
In-Reply-To: <1273017080.78.0.24275979751.issue8617@psf.upfronthosting.co.za>
Message-ID: <1307633395.32.0.334970369206.issue8617@psf.upfronthosting.co.za>


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

I have started to work on this; I?ll have one or two patches ready in a few weeks.

----------
assignee: docs at python -> eric.araujo
versions:  -Python 3.1

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

From report at bugs.python.org  Thu Jun  9 17:36:39 2011
From: report at bugs.python.org (R. David Murray)
Date: Thu, 09 Jun 2011 15:36:39 +0000
Subject: [docs] [issue12293] wrong arguments passed to SMTP.sendmail in
	example
In-Reply-To: <1307622091.83.0.868143597112.issue12293@psf.upfronthosting.co.za>
Message-ID: <1307633799.05.0.565027451505.issue12293@psf.upfronthosting.co.za>


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

"The required arguments are an RFC 822 from-address string, a list of RFC 822 to-address strings (a bare string will be treated as a list with 1 address)..."

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

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

From report at bugs.python.org  Thu Jun  9 18:06:52 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 09 Jun 2011 16:06:52 +0000
Subject: [docs] [issue12298] Sphinx glitch in library/functions
In-Reply-To: <1307635612.57.0.782200385704.issue12298@psf.upfronthosting.co.za>
Message-ID: <1307635612.57.0.782200385704.issue12298@psf.upfronthosting.co.za>


New submission from ?ric Araujo <merwok at netwok.org>:

In the summary table at the top of library/functions, the links for frozenset and memoryview do not jump to the definition down in the same file, but link to stdtypes.

----------
assignee: docs at python
components: Documentation
messages: 137997
nosy: docs at python, eric.araujo, ezio.melotti
priority: normal
severity: normal
status: open
title: Sphinx glitch in library/functions
versions: Python 2.7, Python 3.2, Python 3.3

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

From report at bugs.python.org  Thu Jun  9 18:12:52 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 09 Jun 2011 16:12:52 +0000
Subject: [docs] [issue10446] pydoc3 links to 2.x library reference
In-Reply-To: <1290015143.43.0.140543543356.issue10446@psf.upfronthosting.co.za>
Message-ID: <1307635972.22.0.864602178336.issue10446@psf.upfronthosting.co.za>


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

Can I help moving this forward?

----------

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

From report at bugs.python.org  Thu Jun  9 18:19:00 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 09 Jun 2011 16:19:00 +0000
Subject: [docs] [issue12300] Document pydoc.help
In-Reply-To: <1307636340.19.0.379742788124.issue12300@psf.upfronthosting.co.za>
Message-ID: <1307636340.19.0.379742788124.issue12300@psf.upfronthosting.co.za>


New submission from ?ric Araujo <merwok at netwok.org>:

The only public function in pydoc is help, and it?s not listed in the module docs.  The existing doc in library/functions could be moved to library/pydoc.  See also #12299.

----------
assignee: docs at python
components: Documentation
messages: 138002
nosy: docs at python, eric.araujo
priority: normal
severity: normal
status: open
title: Document pydoc.help
versions: Python 2.7, Python 3.2, Python 3.3

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

From report at bugs.python.org  Thu Jun  9 18:24:27 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 09 Jun 2011 16:24:27 +0000
Subject: [docs] [issue12298] Sphinx glitch in library/functions
In-Reply-To: <1307635612.57.0.782200385704.issue12298@psf.upfronthosting.co.za>
Message-ID: <1307636667.96.0.372451858182.issue12298@psf.upfronthosting.co.za>


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


----------
dependencies: +Fix referencing of built-in types (list, int, ...)

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

From report at bugs.python.org  Thu Jun  9 18:26:07 2011
From: report at bugs.python.org (Georg Brandl)
Date: Thu, 09 Jun 2011 16:26:07 +0000
Subject: [docs] [issue12298] Sphinx glitch in library/functions
In-Reply-To: <1307635612.57.0.782200385704.issue12298@psf.upfronthosting.co.za>
Message-ID: <1307636767.73.0.655005225708.issue12298@psf.upfronthosting.co.za>


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

This is not a Sphinx glitch: that's where these classes are defined.

(Plus, dependencies work the other way round.)

----------
dependencies:  -Fix referencing of built-in types (list, int, ...)
nosy: +georg.brandl

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

From report at bugs.python.org  Thu Jun  9 18:26:41 2011
From: report at bugs.python.org (Georg Brandl)
Date: Thu, 09 Jun 2011 16:26:41 +0000
Subject: [docs] [issue12298] Sphinx glitch in library/functions
In-Reply-To: <1307635612.57.0.782200385704.issue12298@psf.upfronthosting.co.za>
Message-ID: <1307636801.02.0.312030888944.issue12298@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Jun  9 18:27:41 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 09 Jun 2011 16:27:41 +0000
Subject: [docs] [issue11975] Fix referencing of built-in types (list, int,
	...)
In-Reply-To: <1304281262.53.0.265979216697.issue11975@psf.upfronthosting.co.za>
Message-ID: <1307636861.15.0.731754605634.issue11975@psf.upfronthosting.co.za>


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

It won't (because there's the ~ in :func/class:`~__builtin__.int`).  Specifying the module would just be a workaround used to distinguish the 'int' in functions.rst from the one in stdtypes.rst.

----------

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

From report at bugs.python.org  Fri Jun 10 09:26:17 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Fri, 10 Jun 2011 07:26:17 +0000
Subject: [docs] [issue12223] Datamodel documentation page: 'operator' where
	'operand'	should be
In-Reply-To: <1306834975.07.0.689179229064.issue12223@psf.upfronthosting.co.za>
Message-ID: <1307690777.29.0.400330361286.issue12223@psf.upfronthosting.co.za>


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

>From a cursory look at reference/datamodel and library/operator, I see no other instances of this error. I didn't read every word, however (just grepped for possible operator/operand mismatches).

Also, AFAICS this error is only in 2.7 - the 3.x docs don't have the relevant paragraphs at all.

----------

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

From report at bugs.python.org  Fri Jun 10 09:36:52 2011
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 10 Jun 2011 07:36:52 +0000
Subject: [docs] [issue12223] Datamodel documentation page: 'operator' where
	'operand'	should be
In-Reply-To: <1306834975.07.0.689179229064.issue12223@psf.upfronthosting.co.za>
Message-ID: <E1QUwGx-0000uo-Bp@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 3bb5400f5bea by Eli Bendersky in branch '2.7':
Issue #12223: Typo fix in datamodel docs
http://hg.python.org/cpython/rev/3bb5400f5bea

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

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

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


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

When I said ?I don?t like the idea of built-in functions being displayed as ?builtins.int??, I was thinking about the output of ?.. function:: int? in combination with the module directive.  I don?t know if using currentmodule instead of module would be better.

----------

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

From report at bugs.python.org  Fri Jun 10 17:45:16 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 10 Jun 2011 15:45:16 +0000
Subject: [docs] [issue12298] Sphinx glitch in library/functions
In-Reply-To: <1307635612.57.0.782200385704.issue12298@psf.upfronthosting.co.za>
Message-ID: <1307720716.28.0.901594699939.issue12298@psf.upfronthosting.co.za>


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

memoryview and frozenset do have a small entry in library/functions, and the links at the top of the file are meant to jump to entries in the same file.

----------

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

From report at bugs.python.org  Fri Jun 10 17:52:39 2011
From: report at bugs.python.org (Georg Brandl)
Date: Fri, 10 Jun 2011 15:52:39 +0000
Subject: [docs] [issue11975] Fix referencing of built-in types (list, int,
	...)
In-Reply-To: <1304281262.53.0.265979216697.issue11975@psf.upfronthosting.co.za>
Message-ID: <1307721159.18.0.581882043046.issue11975@psf.upfronthosting.co.za>


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

Why is any module directive needed anyway?

----------

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

From report at bugs.python.org  Fri Jun 10 17:53:35 2011
From: report at bugs.python.org (Georg Brandl)
Date: Fri, 10 Jun 2011 15:53:35 +0000
Subject: [docs] [issue12298] Sphinx glitch in library/functions
In-Reply-To: <1307635612.57.0.782200385704.issue12298@psf.upfronthosting.co.za>
Message-ID: <1307721215.66.0.372443991219.issue12298@psf.upfronthosting.co.za>


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

Well, then a different way of linking to them must be used.

----------

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

From report at bugs.python.org  Fri Jun 10 17:56:54 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 10 Jun 2011 15:56:54 +0000
Subject: [docs] [issue12298] Sphinx glitch in library/functions
In-Reply-To: <1307635612.57.0.782200385704.issue12298@psf.upfronthosting.co.za>
Message-ID: <1307721414.14.0.450437029173.issue12298@psf.upfronthosting.co.za>


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

Certainly.  I tried using `.memoryview` without success.  How would you do it?

----------

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

From report at bugs.python.org  Fri Jun 10 17:57:41 2011
From: report at bugs.python.org (Georg Brandl)
Date: Fri, 10 Jun 2011 15:57:41 +0000
Subject: [docs] [issue12298] Sphinx glitch in library/functions
In-Reply-To: <1307635612.57.0.782200385704.issue12298@psf.upfronthosting.co.za>
Message-ID: <1307721461.8.0.867468967691.issue12298@psf.upfronthosting.co.za>


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

You can put an anchor and use :ref:.

----------

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

From report at bugs.python.org  Fri Jun 10 18:05:03 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 10 Jun 2011 16:05:03 +0000
Subject: [docs] [issue12298] Sphinx glitch in library/functions
In-Reply-To: <1307635612.57.0.782200385704.issue12298@psf.upfronthosting.co.za>
Message-ID: <1307721903.63.0.636856747017.issue12298@psf.upfronthosting.co.za>


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

Sounds like the easiest solution that could work, thanks.  I?m on it.

----------
assignee: docs at python -> eric.araujo
status: closed -> open

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

From report at bugs.python.org  Fri Jun 10 19:06:36 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 10 Jun 2011 17:06:36 +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: <1307725596.46.0.490676457134.issue8982@psf.upfronthosting.co.za>


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


Removed file: http://bugs.python.org/file21723/fix-argparse-class-directive.diff

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

From report at bugs.python.org  Fri Jun 10 19:07:03 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 10 Jun 2011 17:07:03 +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: <1307725622.91.0.217674064346.issue8982@psf.upfronthosting.co.za>


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

Patch refreshed.  If I get no negative feedback, I?ll commit it next week.

----------
Added file: http://bugs.python.org/file22320/fix-argparse-class-directive.diff

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

From report at bugs.python.org  Fri Jun 10 19:44:16 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 10 Jun 2011 17:44:16 +0000
Subject: [docs] [issue11553] Docs for: import, packages, site.py, .pth files
In-Reply-To: <1300189190.68.0.0305569633639.issue11553@psf.upfronthosting.co.za>
Message-ID: <1307727856.07.0.562811283086.issue11553@psf.upfronthosting.co.za>


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

Thanks for the detailed review.  I?d like to work on a number of them.  I think I?ll open focused bug reports and make this one depend on them; this will let interested people see the new bugs and possibly give feedback.

> The Language Reference is way too complicated for the mainstream case.
Well, it is not a user guide, but a language reference.  Its scope is different from the library reference.

> Exactly what variants of arguments are possible, and what are their effects?
Does http://docs.python.org/dev/library/functions#__import__ help? Does http://docs.python.org/dev/library/importlib ?

> What are the interactions with package features, such as whether or not
> modules have been explicitly imported into package __init_.py?
Ah, that?s a common issue.  I?ll look into the turorial and docs for import and make a patch.

> Details of package structure have evidently changed over Python versions.
I don?t think so.

> Current docs are unclear on points such as:
> -- is __init__.py needed on subpackage directories?
Yes, it always has.  I think there was some discussion about removing them in py3k, but this was rejected.

> -- the __all__ variable: Does it act generally to limit visibility of a
> module or package's attributes, or does pertain only to the
> 'from...import *' statement?
Both.  http://docs.python.org/dev/genindex-_ leads me to http://docs.python.org/dev/reference/simple_stmts#index-44 and http://docs.python.org/dev/c-api/import#index-0  The doc is there; I however agree that the tutorial or libref could have the same info.

> Language Reference
> Grammar issue: the grammar shown for the import statement shows: [snip]
I have no inkling on that one; I?ll create another bug and ask the import experts.

> Really 'module' is not quite right here either since it's used to mean module-or-package.
A package is a type of module.
                                                                                                
> site.py:
I think I?ll focus first on my work about improving the site.rst documentation, then open another bug to synchronize the docstrings.

> Seriously misleading discussion of .pth files.  [snip]
Agreed.  I believe this section dates back to the pre-package days, where projects like PIL had a module, a .pth file and a directory with modules on sys.path.

> The docstring (or other docs) should make clear that .pth files
> are ONLY processed within site-package directories (ie: only by site.py)
I?ll add a section about the ?site directories? in the docs.  They?re defined in site.py or by users calling site.addsitedir.

> In addsitepackages(), the library directory for Windows (the else clause)
> is shown as lower-case 'lib' instead of 'Lib'.
I don?t see any else clause in the 2.7 or 3.3 code.  Otherwise you?re right.


> Tutorial [snip]
All valid points.


> Standard Library Reference
> site
> This page may simply be importing the docstring from site.py?
> In any case it repeats the ommissions and errors noted above for site.py.
We don?t use docstring extraction in CPython.  Code and docs are updated alongside, or like here, get oudated in parallel.

> sys
> Could helpfully point to a discussion of the typical items to
> be found in sys.path under normal circumstances
Hm, this would be very platform-specific.  What use cases would that help?

> pkgutil
I?ll have to read again the code and PEPs to comment on that one.

> 'Installing Python Modules' document
> "Windows has no concept of a user?s home directory, " and so on.
The author probably meant that there was no $HOME environment variable, ~ shortcut and all that.  Even though Windows assigns a directory for each user, it?s not quite a home dir, but the parent of a settings dir, a documents dir, etc.  (Just like on Mac OS X, there is a UNIX-style home dir, but the tools present another directory for users? documents, IIRC.)

> For Windows suggests 'prefix' (default: C:\Python) as an installation directory.
> This is indeed one of the possible 'site-package' directories, but surely it is
> deprecated in favor of C:\Python\Lib\site-packages, which this section does not mention.
Don?t confuse the prefix and the install dir.  The directory for Python modules is computed as prefix + Lib/site-packages.

> Does not mention user-specific site-package directories.
That?s #10745.  I documented it in http://docs.python.org/dev/packaging/commandref#install-dist but it?s not done for distutils docs yet.

> 'Modifying Python's Search Path' [snip]
> (a) .pth files are only processed in site-package directories.
Yes.  I?ll probably link to the site docs after we write out a clean section on .pth files.  There are other parts of the distutils docs that duplicate information found in docs.python.org/dev/using, for example; I?ll remove them from the packaging (distutils2) docs.

> (b) Clarifying an additional point of confusion [...]
We don?t over-explain every implication in the docs; see http://docs.python.org/dev/documenting/style.html#affirmative-tone

> PEP 302 New Import Hooks
This would be a valid point to raise on python-dev.

That was my initial feeback; I think I?ve covered all of your points.  Some time next week I?ll open the focused bugs and start on patches.

----------
assignee: docs at python -> eric.araujo
versions:  -Python 3.1

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

From report at bugs.python.org  Fri Jun 10 19:46:18 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 10 Jun 2011 17:46:18 +0000
Subject: [docs] [issue11553] Docs for: import, packages, site.py, .pth files
In-Reply-To: <1300189190.68.0.0305569633639.issue11553@psf.upfronthosting.co.za>
Message-ID: <1307727978.23.0.631850584571.issue11553@psf.upfronthosting.co.za>


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


----------
dependencies: +Better document user site-packages in site module doc, setup.py install --user option undocumented

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

From report at bugs.python.org  Fri Jun 10 21:22:56 2011
From: report at bugs.python.org (harobed)
Date: Fri, 10 Jun 2011 19:22:56 +0000
Subject: [docs] [issue12315] Improve http.client.HTTPResponse.read
	documentation
In-Reply-To: <1307733776.17.0.904388798994.issue12315@psf.upfronthosting.co.za>
Message-ID: <1307733776.17.0.904388798994.issue12315@psf.upfronthosting.co.za>


New submission from harobed <stephane at harobed.org>:

This is a patch to improve http.client.HTTPResponse.read documentation.

What do you think about ?

----------
assignee: docs at python
components: Documentation
files: improve_http.client_documentation.patch
keywords: patch
messages: 138129
nosy: docs at python, harobed
priority: normal
severity: normal
status: open
title: Improve http.client.HTTPResponse.read documentation
versions: Python 3.3
Added file: http://bugs.python.org/file22321/improve_http.client_documentation.patch

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

From sandro.tosi at gmail.com  Fri Jun 10 22:18:06 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Fri, 10 Jun 2011 20:18:06 +0000
Subject: [docs] Python Tutorial PDF
In-Reply-To: <BANLkTi=id5Gh3ewWGRASxpBychnDOGp9VQ@mail.gmail.com>
References: <BANLkTi=id5Gh3ewWGRASxpBychnDOGp9VQ@mail.gmail.com>
Message-ID: <BANLkTi=XvAvM0OM7h36eaT1HnJ+zCSivNg@mail.gmail.com>

Hello Mohtashim,

On Tue, Jun 7, 2011 at 20:55, Mohtashim <amrood.admin at gmail.com> wrote:
> Hi,
>
> It would be useful if you can add
> http://www.tutorialspoint.com/python/python_pdf_version.htm
>
> at the following link http://wiki.python.org/moin/BeginnersGuide

It's a wiki page, anyone can edit it, you too! :) You have to login,
you can find the link on the left column, if you don't have already a
used, you can create one or use some OpenID providers.

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  Fri Jun 10 22:40:52 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Fri, 10 Jun 2011 20:40:52 +0000
Subject: [docs] Which version of sphinx?
In-Reply-To: <1307058973.29551.2.camel@debian>
References: <1307058973.29551.2.camel@debian>
Message-ID: <BANLkTimq78NVBdJzLg=3Jda_yzRUK-N6XQ@mail.gmail.com>

Hello Tshepang,

On Thu, Jun 2, 2011 at 23:56, Tshepang Lekhonkhobe <tshepang at gmail.com> wrote:
> Hi,
>
> Is there any reason Sphinx version was specified here:
> http://docs.python.org/dev/documenting/building.html?

I don't have that clear your question. Are you asking why the version
is explict in this command:

svn co http://svn.python.org/projects/external/Sphinx-0.6.5/sphinx tools/sphinx

or in some other place? can you please be a bit more specific (either
in what you think is wrong and how you'd fix it)?

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  Sat Jun 11 03:03:14 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 11 Jun 2011 01:03:14 +0000
Subject: [docs] [issue12188] PEP 7 (or guide) add C style policies and
	explanation
In-Reply-To: <1306433972.91.0.882585972593.issue12188@psf.upfronthosting.co.za>
Message-ID: <1307754194.63.0.0256104345777.issue12188@psf.upfronthosting.co.za>


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

We have a second item for the PEP (or Guide) section (but I think I prefer in the PEP so as to have one place to look for such things.).
So I changed the title a bit.

On 6/10/2011 3:49 PM, Guido van Rossum wrote:
> On Wed, Jun 8, 2011 at 8:12 AM, Nick Coghlan<ncoghlan at gmail.com>  
>> I actually thought Brett's rationale in the checkin comment was
>> reasonable (if you get in the habit of putting constants on the left,
>> then the classic "'=' instead of '=='" typo is a compiler error
>> instead of a reassignment).

[I understand this rationale too; I forget what I actually did when I was writing C.]

> I really like consistency across the code base. I really don't like
> constant-on-the-left, and it's basically not used in the current
> codebase. Please be consistent and don't start using it.

[I suspect I did this.]
 
>> Call it a +0 in favour of letting people put constants on the left in
>> C code if they prefer it that way, so long as any given if/elif chain
>> is consistent in the style it uses.
> 
> Sorry, I give it a -1. (I'd like to be able to read the codebase still... :-)

I bet there will be more things for a new section.

----------
title: PEP 7, C style: add ++ policy and explanation -> PEP 7 (or guide) add C style policies and explanation
type: feature request -> 
versions: +Python 2.7, Python 3.2, Python 3.3

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

From report at bugs.python.org  Sat Jun 11 03:56:17 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 11 Jun 2011 01:56:17 +0000
Subject: [docs] [issue12261] urllib.parse docs still refer to urlparse
In-Reply-To: <1307129696.46.0.265723026729.issue12261@psf.upfronthosting.co.za>
Message-ID: <1307757377.59.0.66792659104.issue12261@psf.upfronthosting.co.za>


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

I believe this is ready to apply.

----------
nosy: +terry.reedy
stage:  -> commit review
versions: +Python 3.3

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

From report at bugs.python.org  Sat Jun 11 04:17:35 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 11 Jun 2011 02:17:35 +0000
Subject: [docs] [issue12276] 3.x ignores sys.tracebacklimit=0
In-Reply-To: <1307436501.83.0.59684150491.issue12276@psf.upfronthosting.co.za>
Message-ID: <1307758655.32.0.337613193908.issue12276@psf.upfronthosting.co.za>


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

Either code or doc must change (with 'version changed' note). Doc: "The default is 1000. When set to 0 or less, all traceback information is suppressed and only the exception type and value are printed."

Christian's patch: "values <= 0 are replaced with a default value to avoid infinite recursion and other issues." Default is 1000.

I do not see the logic of changing 'nothing' to 'everything'. I am puzzled how printing nothing causes infinite recursion.

----------
assignee:  -> docs at python
components: +Documentation
nosy: +christian.heimes, docs at python, terry.reedy

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

From report at bugs.python.org  Sat Jun 11 04:40:37 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 11 Jun 2011 02:40:37 +0000
Subject: [docs] [issue12300] Document pydoc.help
In-Reply-To: <1307636340.19.0.379742788124.issue12300@psf.upfronthosting.co.za>
Message-ID: <1307760037.59.0.823330688744.issue12300@psf.upfronthosting.co.za>


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

There is already a link to the main entry, which is where I think it should be.

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

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

From report at bugs.python.org  Sat Jun 11 13:32:35 2011
From: report at bugs.python.org (Graham Wideman)
Date: Sat, 11 Jun 2011 11:32:35 +0000
Subject: [docs] [issue11553] Docs for: import, packages, site.py, .pth files
In-Reply-To: <1300189190.68.0.0305569633639.issue11553@psf.upfronthosting.co.za>
Message-ID: <1307791955.47.0.327332908658.issue11553@psf.upfronthosting.co.za>


Graham Wideman <initcontact at grahamwideman.com> added the comment:

Hi Eric,  Thanks for starting to review this, and your responses are encouraging. Some comments inline below.

FWIW, along the way I accumulated my own notes on this topic, on some pages here:

grahamwideman.wikispaces.com
(Left navigation panel...)
Software development > Python > Organization for common modules

Might be of interest as feedback on the digging process I needed in order to get some clarity on these issues, and also shows my references.

>> Exactly what variants of arguments are possible, and what are their effects?
>Does http://docs.python.org/dev/library/functions#__import__ help? Does http://docs.python.org/dev/library/importlib ?

Well somewhat overkill -- because the matter of interest was args for from... and import, while the docs you mention are for more complicated underlying functions. (Interesting nonetheless.)

>> Current docs are unclear on points such as:
>> -- is __init__.py needed on subpackage directories?
>Yes, it always has.  I think there was some discussion about removing them in py3k, but this was rejected.
I came to same conclusion.. but have seen it described otherwise (in at least one book), so good to state this explicitly.

>> -- the __all__ variable: Does it act generally to limit visibility of a
>> module or package's attributes, or does pertain only to the
>> 'from...import *' statement?
> Both. 

I'm pretty sure that's not correct -- pretty sure that __all__ only specifies what's included in from...import *, and does not prevent access via from...import specific_attrib.  But I may have tested incorrectly.
                                                                                               
>> Seriously misleading discussion of .pth files.  [snip]
>Agreed. 

Cool -- I think it's well worth fixing this area for sure!

>> In addsitepackages(), the library directory for Windows (the else clause)
>> is shown as lower-case 'lib' instead of 'Lib'.
>I don?t see any else clause in the 2.7 or 3.3 code.  Otherwise you?re right.

Sorry, the lowecase 'lib' issue is in 
  getsitepackages()... 
  if sys.platform in(...) ... 
  else:...
    sitepackages.append(os.path.join(prefix, "lib", "site-packages"))

>> sys
>> Could helpfully point to a discussion of the typical items to
>> be found in sys.path under normal circumstances
>Hm, this would be very platform-specific.  What use cases would that help?

It would demystify how python already knows how to find various things under vanilla circumstances.

>> 'Installing Python Modules' document
>> "Windows has no concept of a user?s home directory, " and so on.
>The author probably meant that there was no $HOME environment variable, ~ shortcut and all that.

Fair enough, but in actuality there *is* a user-specific location (on Windows) examined by site.py, which is in %APPDATA%\Python\.

>> For Windows suggests 'prefix' (default: C:\Python) as an installation directory.
>> This is indeed one of the possible 'site-package' directories, but surely it is
>> deprecated in favor of C:\Python\Lib\site-packages, which this section does not mention.
>Don?t confuse the prefix and the install dir.  The directory for Python modules is computed as prefix + Lib/site-packages.

Currently, under "Alternate installation: Windows (the prefix scheme)", it says:
    python setup.py install --prefix="\Temp\Python"
    to install modules to the \Temp\Python directory on the current drive.
Does this really mean "install modules to \Temp\Python\Lib\site-packages"?
(And as a side point, surely installing under the Temp directory is a strange location to pick for an example?)

>That was my initial feeback; I think I?ve covered all of your points. 
Looking forward!

----------

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

From report at bugs.python.org  Sat Jun 11 14:23:14 2011
From: report at bugs.python.org (Nick Coghlan)
Date: Sat, 11 Jun 2011 12:23:14 +0000
Subject: [docs] [issue11553] Docs for: import, packages, site.py, .pth files
In-Reply-To: <1300189190.68.0.0305569633639.issue11553@psf.upfronthosting.co.za>
Message-ID: <1307794993.88.0.982938292143.issue11553@psf.upfronthosting.co.za>


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

Thanks for getting started with such a detailed review on this Graham. We've known the documentation in this area has been flawed for a long time, but actually *fixing* seemed like such a big task that it has tended to get pushed to the bottom of our respective to-do lists.

And so as things have been tweaked, the already flawed documentation has fallen even further out of date (as it wasn't always clear where updates should be included).

Simply breaking it down into a smaller list of easier to tackle problems is a big step towards getting something done about it.

A couple of specific notes:

__all__ only affects import *, and may also affect documentation tools (e.g. pydoc will respect __all__ when deciding what to display). It has no effect on attribute retrieval from modules.

pkgutil.extend_path() is used to modify pkg.__path__ attributes, *not* sys.path. It is used to allow a single package to span multiple directories, forming the basis for "namespace packages" (see http://www.python.org/dev/peps/pep-0382/#namespace-packages-today). 

Packages are technically a kind of module, but we're somewhat inconsistent in our use of the term "module". Sometimes it means all kinds of modules (frozen, builtin, extension, package, compiled, source), sometimes it means anything-but-a-package and occasionally it specifically means pure Python modules. In theory, context should make it clear which interpretation is intended. In practice, the boundaries between the first two meanings get a little blurry.

----------

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

From eliben at gmail.com  Sat Jun 11 15:32:32 2011
From: eliben at gmail.com (Eli Bendersky)
Date: Sat, 11 Jun 2011 16:32:32 +0300
Subject: [docs] globals
In-Reply-To: <4DED2A04.6010006@gmail.com>
References: <4DED2A04.6010006@gmail.com>
Message-ID: <BANLkTin_W8Tx=g1=dOhokaqc6qWAAEgP4A@mail.gmail.com>

2011/6/6 siwy_ <siwego at gmail.com>

>  I am affraid that there is nothing said about global variables inside
> def: blocks
>
> that supports me some problems that solution could be found in internet
>
>
Read this (Python 2.7 version) document:
http://docs.python.org/reference/executionmodel.html#naming-and-binding for
the official information.

The tutorial also mentions globals in functions here:
http://docs.python.org/tutorial/controlflow.html#defining-functions

What other information would you expect to have?
Eli
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20110611/ad517806/attachment.html>

From report at bugs.python.org  Sat Jun 11 16:26:37 2011
From: report at bugs.python.org (=?utf-8?q?Greg_S=C5=82odkowicz?=)
Date: Sat, 11 Jun 2011 14:26:37 +0000
Subject: [docs] [issue11553] Docs for: import, packages, site.py, .pth files
In-Reply-To: <1300189190.68.0.0305569633639.issue11553@psf.upfronthosting.co.za>
Message-ID: <1307802397.21.0.958061026155.issue11553@psf.upfronthosting.co.za>


Changes by Greg S?odkowicz <jergosh at gmail.com>:


----------
nosy: +Greg.Slodkowicz

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

From report at bugs.python.org  Sat Jun 11 17:32:37 2011
From: report at bugs.python.org (Graham Wideman)
Date: Sat, 11 Jun 2011 15:32:37 +0000
Subject: [docs] [issue11553] Docs for: import, packages, site.py, .pth files
In-Reply-To: <1300189190.68.0.0305569633639.issue11553@psf.upfronthosting.co.za>
Message-ID: <1307806356.98.0.910923288986.issue11553@psf.upfronthosting.co.za>


Graham Wideman <initcontact at grahamwideman.com> added the comment:

Hi Nick: Thanks for your additional points. Comments inline:

> __all__ only affects import *, and may also affect documentation tools (e.g. pydoc will respect __all__ when deciding what to display). It has no effect on attribute retrieval from modules.

That's indeed my understanding. So the doc (6. Simple statements) which says that __all__ determines the list of "public names" is a bit of a red herring.  Attributes are accessible (ie: public) regardless of whether on the __all__ list.  Instead the __all__ list establishes the list of names imported by *, and makes those names reference-able without a module prefix. (Plus gives hints about intent to doc tools.)

> pkgutil.extend_path() is used to modify pkg.__path__ attributes, *not* sys.path. 

Understood, and perhaps my point was obtuse.  I was pointing out that the doc for extend_path discusses .pkg entries which point to package dirs, and that this, it says, is like .pth files. I claim that an entry in a .pth files should NOT point to a package dir, but rather to one level up: to a dir that *contains* package dirs. (Pointing a .pth entry directly at a package dir will break package behavior by exposing the constituent modules to sys.path.)  Hence the doc for extend_path is misleadingly suggesting a wrong idea about .pth files.

----------

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

From report at bugs.python.org  Sat Jun 11 18:44:21 2011
From: report at bugs.python.org (Antoine Pitrou)
Date: Sat, 11 Jun 2011 16:44:21 +0000
Subject: [docs] [issue12315] Improve http.client.HTTPResponse.read
	documentation
In-Reply-To: <1307733776.17.0.904388798994.issue12315@psf.upfronthosting.co.za>
Message-ID: <1307810661.49.0.0514653979153.issue12315@psf.upfronthosting.co.za>


Changes by Antoine Pitrou <pitrou at free.fr>:


----------
nosy: +orsenthil
stage:  -> patch review

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

From report at bugs.python.org  Sat Jun 11 23:56:34 2011
From: report at bugs.python.org (Vinay Sajip)
Date: Sat, 11 Jun 2011 21:56:34 +0000
Subject: [docs] [issue12206] Documentation Std. Library 15.7.5 "LogRecord
	objects":	Parameters: level(currently wrong) -> levelno (correct)
In-Reply-To: <1306666020.34.0.114942173152.issue12206@psf.upfronthosting.co.za>
Message-ID: <1307829394.01.0.981510053619.issue12206@psf.upfronthosting.co.za>


Vinay Sajip <vinay_sajip at yahoo.co.uk> added the comment:

Attached is a simple patch clarifying that the level argument in the constructor maps to the two LogRecord attributes, levelno and levelname,

----------
keywords: +patch
Added file: http://bugs.python.org/file22331/patch12206.diff

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

From report at bugs.python.org  Sun Jun 12 00:04:44 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 11 Jun 2011 22:04:44 +0000
Subject: [docs] [issue12206] Documentation Std. Library 15.7.5 "LogRecord
	objects":	Parameters: level(currently wrong) -> levelno (correct)
In-Reply-To: <1306666020.34.0.114942173152.issue12206@psf.upfronthosting.co.za>
Message-ID: <E1QVWIN-000764-3z@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset bb6fe43191c0 by Vinay Sajip in branch '3.2':
Issue #12206: documentation for LogRecord constructor updated re. the level argument.
http://hg.python.org/cpython/rev/bb6fe43191c0

New changeset 596adf14914c by Vinay Sajip in branch 'default':
Merged documentation update for issue #12206.
http://hg.python.org/cpython/rev/596adf14914c

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

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

From report at bugs.python.org  Sun Jun 12 00:06:59 2011
From: report at bugs.python.org (Vinay Sajip)
Date: Sat, 11 Jun 2011 22:06:59 +0000
Subject: [docs] [issue12206] Documentation Std. Library 15.7.5 "LogRecord
	objects":	Parameters: level(currently wrong) -> levelno (correct)
In-Reply-To: <1306666020.34.0.114942173152.issue12206@psf.upfronthosting.co.za>
Message-ID: <1307830019.26.0.456935670106.issue12206@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sun Jun 12 01:53:24 2011
From: report at bugs.python.org (Nick Coghlan)
Date: Sat, 11 Jun 2011 23:53:24 +0000
Subject: [docs] [issue11553] Docs for: import, packages, site.py, .pth files
In-Reply-To: <1300189190.68.0.0305569633639.issue11553@psf.upfronthosting.co.za>
Message-ID: <1307836404.85.0.931756146689.issue11553@psf.upfronthosting.co.za>


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

"Public name" is a term that describes a convention, not anything enforced by the interpreter. Names starting with underscores typically aren't public either (unless documented otherwise), but that has no effect on the ability to retrieve them as attributes. A glossary entry defining the term may be worthwhile (perhaps with a reference to pydoc.visiblename())

Dirs mentioned in .pkg files *should* be added to "the path". It's just that the path in question is pkg.__path__, not sys.path. That could probably be made clearer, but the docs aren't wrong as they stand.

----------

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

From report at bugs.python.org  Sun Jun 12 03:27:04 2011
From: report at bugs.python.org (Graham Wideman)
Date: Sun, 12 Jun 2011 01:27:04 +0000
Subject: [docs] [issue11553] Docs for: import, packages, site.py, .pth files
In-Reply-To: <1300189190.68.0.0305569633639.issue11553@psf.upfronthosting.co.za>
Message-ID: <1307842024.36.0.295579293623.issue11553@psf.upfronthosting.co.za>


Graham Wideman <initcontact at grahamwideman.com> added the comment:

> "Public name" is a term that describes a convention, not anything enforced by the interpreter. 

And I guess that's really the main point. In other languages Public means accessible, and Private means not so.  In Python, Public means "suggested for outside consumption", and Private means not so intended, but nonetheless accessible. If that was reiterated near the discussion of __all__ it would be most helpful.  

>  Dirs mentioned in .pkg files *should* be added to the [...] pkg.__path__, not sys.path. 
> That could probably be made clearer, but the docs aren't wrong as they stand.

Again I've not managed to draw attention to the exact point of contention. 
1. A dir added to a .pkg file evidently should be an actual package dir.  
2. A dir added to a .pth file should NOT be an actual package dir. It should be the dir at the level above.

Thus the entries in .pkg and .pth files point to different kinds of things, yet the doc I pointed to asserts they are the same in this regard.

----------

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

From report at bugs.python.org  Sun Jun 12 09:54:07 2011
From: report at bugs.python.org (Nick Coghlan)
Date: Sun, 12 Jun 2011 07:54:07 +0000
Subject: [docs] [issue11553] Docs for: import, packages, site.py, .pth files
In-Reply-To: <1300189190.68.0.0305569633639.issue11553@psf.upfronthosting.co.za>
Message-ID: <1307865246.98.0.713992597782.issue11553@psf.upfronthosting.co.za>


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

Ah, now I get your point re .pkg vs .pth. I naturally read that as ".pth entries are to sys.path entries as .pkg entries are to pkg.__path__ entries", without any hint that those are the same *kind* of thing. However, I already know that sys.path and pkg.__path__ entries are different, and now I see how it could be misleading for anyone that wasn't as familiar with the distinction.

(This has actually been one of the historic problems with the import documentation - we *don't always know* when something is unclear, because we unconsciously fill in the missing pieces)

----------

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

From report at bugs.python.org  Sun Jun 12 22:28:14 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Sun, 12 Jun 2011 20:28:14 +0000
Subject: [docs] [issue12206] Documentation Std. Library 15.7.5 "LogRecord
	objects":	Parameters: level(currently wrong) -> levelno (correct)
In-Reply-To: <1306666020.34.0.114942173152.issue12206@psf.upfronthosting.co.za>
Message-ID: <1307910494.7.0.193834058362.issue12206@psf.upfronthosting.co.za>


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


Removed file: http://bugs.python.org/file22187/unnamed

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

From report at bugs.python.org  Sun Jun 12 23:30:31 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 12 Jun 2011 21:30:31 +0000
Subject: [docs] [issue6696] Profile objects should be documented
In-Reply-To: <1250182637.82.0.304646827828.issue6696@psf.upfronthosting.co.za>
Message-ID: <1307914231.75.0.0134463449298.issue6696@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Mon Jun 13 16:00:44 2011
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 13 Jun 2011 14:00:44 +0000
Subject: [docs] [issue12206] Documentation Std. Library 15.7.5 "LogRecord
	objects":	Parameters: level(currently wrong) -> levelno (correct)
In-Reply-To: <1306666020.34.0.114942173152.issue12206@psf.upfronthosting.co.za>
Message-ID: <E1QW7h5-00031V-AN@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 5fbf0d010276 by Vinay Sajip in branch '2.7':
Closes #12206: documentation update for LogRecord constructor and Formatter.formatTime.
http://hg.python.org/cpython/rev/5fbf0d010276

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

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

From report at bugs.python.org  Mon Jun 13 18:16:02 2011
From: report at bugs.python.org (R. David Murray)
Date: Mon, 13 Jun 2011 16:16:02 +0000
Subject: [docs] [issue12174] Multiprocessing logging levels unclear
In-Reply-To: <1306324447.9.0.976036464224.issue12174@psf.upfronthosting.co.za>
Message-ID: <1307981761.94.0.188152814616.issue12174@psf.upfronthosting.co.za>


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

I think it would be good to mention the numeric levels in the text as well (in parenthesis, perhaps), unless the rest of the logging docs no longer refer to the numeric levels.

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

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

From report at bugs.python.org  Mon Jun 13 18:18:47 2011
From: report at bugs.python.org (R. David Murray)
Date: Mon, 13 Jun 2011 16:18:47 +0000
Subject: [docs] [issue12063] tokenize module appears to treat unterminated
	single and	double-quoted strings inconsistently
In-Reply-To: <1305209970.17.0.31373709531.issue12063@psf.upfronthosting.co.za>
Message-ID: <1307981927.08.0.396286738287.issue12063@psf.upfronthosting.co.za>


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

I agree with Petri, so I'm setting this to a doc issue.

----------
assignee:  -> docs at python
components: +Documentation
nosy: +docs at python, r.david.murray
stage:  -> needs patch
type:  -> behavior

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

From report at bugs.python.org  Mon Jun 13 18:27:16 2011
From: report at bugs.python.org (R. David Murray)
Date: Mon, 13 Jun 2011 16:27:16 +0000
Subject: [docs] [issue11669] Clarify Lang Ref "Compound statements" footnote
In-Reply-To: <1301042574.67.0.975748752077.issue11669@psf.upfronthosting.co.za>
Message-ID: <1307982436.51.0.894064377653.issue11669@psf.upfronthosting.co.za>


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

Sometimes we use the patch keyword for doc issues where someone has suggested a specific new wording but not generated an actual patch.  That seems to be the case here.

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

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

From report at bugs.python.org  Mon Jun 13 18:28:07 2011
From: report at bugs.python.org (R. David Murray)
Date: Mon, 13 Jun 2011 16:28:07 +0000
Subject: [docs] [issue11669] Clarify Lang Ref "Compound statements" footnote
In-Reply-To: <1301042574.67.0.975748752077.issue11669@psf.upfronthosting.co.za>
Message-ID: <1307982487.6.0.144082167438.issue11669@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Tue Jun 14 07:38:17 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Tue, 14 Jun 2011 05:38:17 +0000
Subject: [docs] [issue12174] Multiprocessing logging levels unclear
In-Reply-To: <1307981761.94.0.188152814616.issue12174@psf.upfronthosting.co.za>
Message-ID: <20110614053816.GA8256@colossus>


Petri Lehtinen <petri at digip.org> added the comment:

R. David Murray wrote:
> I think it would be good to mention the numeric levels in the text as well (in parenthesis, perhaps), unless the rest of the logging docs no longer refer to the numeric levels.

AFAICS, there are no numbers in the logging docs anymore.

----------

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

From report at bugs.python.org  Tue Jun 14 08:26:12 2011
From: report at bugs.python.org (=?utf-8?q?Martin_v=2E_L=C3=B6wis?=)
Date: Tue, 14 Jun 2011 06:26:12 +0000
Subject: [docs] [issue10224] Build 3.x documentation using python3.x
In-Reply-To: <1288304199.49.0.7053863257.issue10224@psf.upfronthosting.co.za>
Message-ID: <1308032772.11.0.641424782642.issue10224@psf.upfronthosting.co.za>


Martin v. L?wis <martin at v.loewis.de> added the comment:

Actually, on Windows, PYTHON is typically not set at all. So the likelihood of it being set to Python 3 is very low, unless you are trying to build Python documentation from time to time.

Sye: I fail to see the point of your patch. sphinx-build.py already issues an error message - why do you need more error messages?

----------

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

From report at bugs.python.org  Tue Jun 14 17:26:38 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Tue, 14 Jun 2011 15:26:38 +0000
Subject: [docs] [issue12207] Document ast.PyCF_ONLY_AST
In-Reply-To: <1306689830.34.0.885575322408.issue12207@psf.upfronthosting.co.za>
Message-ID: <1308065198.36.0.809808703591.issue12207@psf.upfronthosting.co.za>


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

Another bug requesting documentation for a compiler flag exposed by a module: #1612012.

> If possible, I would have the index point to the first current
> sentence, which also mentions .parse() as an alternative.
This should be possible: http://sphinx.pocoo.org/markup/para.html#directive-index

----------

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

From report at bugs.python.org  Tue Jun 14 17:47:27 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Tue, 14 Jun 2011 15:47:27 +0000
Subject: [docs] [issue8255] Packaging step-by-step tutorial
In-Reply-To: <1269787637.04.0.463586986817.issue8255@psf.upfronthosting.co.za>
Message-ID: <1308066447.76.0.794445997659.issue8255@psf.upfronthosting.co.za>


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

I think the official documentation is less opinionated than the Hitchhiker?s Guide.

----------
title: step-by-step tutorial -> Packaging step-by-step tutorial
versions: +Python 3.3 -3rd party

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

From lukasz.ciesnik at gmail.com  Thu Jun  9 10:38:43 2011
From: lukasz.ciesnik at gmail.com (=?UTF-8?B?xYF1a2FzeiBDaWXFm25paw==?=)
Date: Thu, 9 Jun 2011 10:38:43 +0200
Subject: [docs] Bug in mimetypes.MimeTypes documentation
Message-ID: <BANLkTinUSDUL0Y0MYvMJhDk2VCTq4Ho=8g@mail.gmail.com>

Hello,

I have found that MimeTypes class does not provide same interface
as mimetypes module does in terms of ``types_map`` and ``common_types``
attributes.  There is no ``common_types`` dictionary found in
MimeTypes instances and ``types_map`` is a tuple of (non_strict, strict)
extension to mime type mappings:

  Python 2.7.1 (r271:86832, Nov 27 2010, 17:19:03) [MSC v.1500 64 bit
(AMD64)] on win32
  Type "help", "copyright", "credits" or "license" for more information.
  >>> import mimetypes
  >>> m = mimetypes.MimeTypes()
  >>> type(m.types_map)
  <type 'tuple'>
  >>> m.common_types
  Traceback (most recent call last):
    File "<stdin>", line 1, in <module>
  AttributeError: MimeTypes instance has no attribute 'common_types'
  >>> m.types_map[True]
  {'.obj': 'application/octet-stream', '.ra': 'audio/x-pn-realaudio',
'.dwfx': 'model/vnd.dwfx+xps', '.wsdl': 'application/xml', [...]
'.wvx': 'video/x-ms-wvx'}
  >>> m.types_map[False]
  {'.xul': 'text/xul', '.pic': 'image/pict', '.pict': 'image/pict',
'.jpg': 'image/jpg', '.rtf': 'application/rtf', '.pct': 'image/pict',
'.mid': 'audio/midi', '.midi': 'audio/midi'}

At the same time documentation advertises this quite differently:

  18.7.1. MimeTypes Objects
  http://docs.python.org/library/mimetypes.html#mimetypes-objects

  .. attribute:: MimeTypes.types_map

     Dictionary mapping filename extensions to MIME types.  This is
initially a copy
     of the global ``types_map`` defined in the module.


  .. attribute:: MimeTypes.common_types

     Dictionary mapping filename extensions to non-standard, but
commonly found MIME
     types.  This is initially a copy of the global ``common_types``
defined in the
     module.

It would be nice if it resembled module interface, so this might be a
code issue as well.
Nevertheless currently documentation says something different than code does.

Thanks,

-- 
?ukasz Cie?nik

From henrik at henrikholm.com  Thu Jun  9 15:50:02 2011
From: henrik at henrikholm.com (Henrik Holm)
Date: Thu, 9 Jun 2011 09:50:02 -0400
Subject: [docs] Link to PyCrypto
Message-ID: <BANLkTinWVamUgG_0zNckxtSvDuHd21pkhA@mail.gmail.com>

Hi, there's a link to PyCrypto on your documentation page "14.
Cryptographic Services" (http://docs.python.org/library/crypto.html)
This points to Kuchling's original package, on version 2.0.1.
PyCrypto has apparently been taken over by someone else, so I'd
suggest changing the link to https://launchpad.net/pycrypto .

Thanks,
Henrik Holm

-- 
I am hardly working on your problem. ?I will solve it soon.

From Chris.Johnson at Fiserv.com  Thu Jun  9 23:12:13 2011
From: Chris.Johnson at Fiserv.com (Johnson, Chris M (Dublin))
Date: Thu, 9 Jun 2011 17:12:13 -0400
Subject: [docs] Doco bug
Message-ID: <6778E90D923651429D4E9B623EC58BDD31F77E8E8E@IWPMAIL2.corp.checkfree.com>

On this page: http://docs.python.org/dev/whatsnew/3.2.html

In the section for PEP 3333, in the first sentence, WSGI has been misspelled as WGSI

Regards


Chris Johnson
SVP Strategy & Innovation
Fiserv Biller Solutions
Office: 740-945-3248
www.fiserv.com<http://www.fiserv.com/>
P Please consider the environment before printing this e-mail

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

From maquema at coscoiberia.com  Fri Jun 10 13:13:43 2011
From: maquema at coscoiberia.com (maquema/Martin Maqueira (SPAIN System Administrator))
Date: Fri, 10 Jun 2011 13:13:43 +0200
Subject: [docs] datetime.now() bug
Message-ID: <33F4B11231F5FE4B82FC5CEF93EF439F0242FFF6@ntespe04.EU.COSCON.COS>

Hello Everybody.

 

I write you because I found a bug in datetime.now(). (tested in Python 2.6.6 -r266:84297, Aug 24 2010, 18:46:32-win32) This bug is that sometime doesn?t return milliseconds.

 

The code to reproduce the bug is: you have to wait a lot of time (from 20 minutes to 2 hours)

 

 

from datetime import datetime

while True:

            a=str(datetime.now())

            try:

                        b=a.split(".")[1]

                        print b

            except:

                        print "exception a=%s (if you see in this case there are not the milliseconds) " % (str(a))

                        break

 

 

I new in this . Programing and python specially.

 

Best Regards

 

 

 
COSCO Iberia S.A.- Barcelona
SPAIN IT Dept.
Tel: +34 933 047 125
Fax:+34 933 047 128 
e-mail: maquema at coscoiberia.com <mailto:maquema at coscoiberia.com> 

www.coscoiberia.es <blocked::file://www.coscoiberia.es/>  

 

 

  



 




DISCLAIMER:
En cumplimiento del art?culo 5 de la Ley Org?nica de Protecci?n de Datos 15/1999, le informamos que sus datos personales est?n incorporados a un fichero denominado clientes, con la ?nica finalidad de mantener relaciones profesionales. Si lo desea puede ejercer los derechos de acceso, rectificaci?n, cancelaci?n u oposici?n de sus datos personales dirigi?ndose a: COSCO IBERIA  S.A. -Responsable Protecci?n de Datos- calle Casanova, 2, 6? planta de Barcelona (08011).
Este mensaje y cualquier documento que lleve adjunto, es confidencial y destinado ?nicamente a la persona o entidad a quien ha sido enviado. Si Usted ha recibido este mensaje por error, le informamos que el contenido en el mismo es reservado y el uso no autorizado est? prohibido legalmente,por ello,por favor , le rogamos que nos lo notifique al e-mail: manager at coscoiberia.com o al tel?fono 93 304 71 26
Si su e-mail no ha podido ser entregado al buz?n de su destinatario,  por favor reenv?elo a la direcci?n coscoiberia at coscon.com
If your mail could not be delivered correctly, please resend it to coscoiberia at coscon.com

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20110610/1d22536c/attachment-0001.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image003.jpg
Type: image/jpeg
Size: 3330 bytes
Desc: image003.jpg
URL: <http://mail.python.org/pipermail/docs/attachments/20110610/1d22536c/attachment-0001.jpg>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: image004.gif
Type: image/gif
Size: 2393 bytes
Desc: image004.gif
URL: <http://mail.python.org/pipermail/docs/attachments/20110610/1d22536c/attachment-0001.gif>

From tshepang at gmail.com  Sat Jun 11 01:27:48 2011
From: tshepang at gmail.com (Tshepang Lekhonkhobe)
Date: Sat, 11 Jun 2011 01:27:48 +0200
Subject: [docs] Which version of sphinx?
In-Reply-To: <BANLkTimq78NVBdJzLg=3Jda_yzRUK-N6XQ@mail.gmail.com>
References: <1307058973.29551.2.camel@debian>
	<BANLkTimq78NVBdJzLg=3Jda_yzRUK-N6XQ@mail.gmail.com>
Message-ID: <1307748473.4373.3.camel@debian>

On Fri, 2011-06-10 at 20:40 +0000, Sandro Tosi wrote:
> Hello Tshepang,
> 
> On Thu, Jun 2, 2011 at 23:56, Tshepang Lekhonkhobe <tshepang at gmail.com> wrote:
> > Hi,
> >
> > Is there any reason Sphinx version was specified here:
> > http://docs.python.org/dev/documenting/building.html?
> 
> I don't have that clear your question. Are you asking why the version
> is explict in this command:
> 
> svn co http://svn.python.org/projects/external/Sphinx-0.6.5/sphinx tools/sphinx
> 
> or in some other place? can you please be a bit more specific (either
> in what you think is wrong and how you'd fix it)?

Sorry for not being too clear. I meant, why is that specific version
required? Why doesn't the link just point to trunk (or tip, in Mercurial
speak)? I asked because I was looking at the doc, wanting to improve it.
I imagined it could stem from the fear that later versions could break
the doc build.


From cocoatomo77 at gmail.com  Sun Jun 12 17:54:02 2011
From: cocoatomo77 at gmail.com (tomo cocoa)
Date: Mon, 13 Jun 2011 00:54:02 +0900
Subject: [docs] usage of the cfunc directive
Message-ID: <BANLkTinK3+mr-NRFi-muJDDjv0WRULsoxg@mail.gmail.com>

Hello,

I am a Japanese Python-philia.

There are documentation bug(?) in Python/C API Reference Manual v2.7.2
and v3.1.3.
At the explanation on PySequence_ITEM of the page "Sequence Protocol",
the word "PySequence_Check(o)()" appears.

This word is converted from ":cfunc:`PySequence_Check(o)`" in the
corresponding Sphinx source.

I have no solution of this problem, so am just reporting it.


Regards.

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

From mrg_n00q at q.com  Mon Jun 13 21:01:26 2011
From: mrg_n00q at q.com (mrg_n00q at q.com)
Date: Mon, 13 Jun 2011 13:01:26 -0600
Subject: [docs] Glossary Suggestion
Message-ID: <5A1137F25F0B423799F0233A6C181F3D@TSUNAMI>

Hello:

I'm getting into Python and I like it quite a bit,
but wrestling with the nomenclature can be 
troublesome for an informal programmer.  The
glossary (in the v3.3.0 documentation) helps, but
I would point out as a gentle suggestion that, since
it repeatedly refers to "containers", it might also
include a definition of "container".

Not an urgent matter.  Thanks for your time and
attention.

Cheers -- MrG (Greg Goebel)
mrg_n00q at q,com
email address changes periodically
current email always at: 
http://www.vectorsite.net/imymail.html

This is a private correspondence intended 
only for the directly addressed recipient. 
It is not to be forwarded or republished in a 
public forum.

From report at bugs.python.org  Tue Jun 14 18:28:23 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Tue, 14 Jun 2011 16:28:23 +0000
Subject: [docs] [issue1612012] builtin compile() doc needs
	PyCF_DONT_IMPLY_DEDENT
Message-ID: <1308068903.5.0.0954436841269.issue1612012@psf.upfronthosting.co.za>


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

Is this something that would actually be useful to someone using compile()?

See #12207 also

----------
nosy: +terry.reedy
versions: +Python 3.3 -Python 3.1

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

From report at bugs.python.org  Wed Jun 15 18:16:42 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 15 Jun 2011 16:16:42 +0000
Subject: [docs] [issue11435] Links to source code should now point to hg repo
In-Reply-To: <1299519091.7.0.295996410449.issue11435@psf.upfronthosting.co.za>
Message-ID: <1308154602.81.0.429877621738.issue11435@psf.upfronthosting.co.za>


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

The 2.7 docs link to the Subversion repo.  Can I update them?

----------
nosy: +eric.araujo
versions: +Python 2.7

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

From report at bugs.python.org  Thu Jun 16 16:08:32 2011
From: report at bugs.python.org (Antoine Pitrou)
Date: Thu, 16 Jun 2011 14:08:32 +0000
Subject: [docs] [issue12343] ssl documentation needs comments about
	non-blocking	behaviour
In-Reply-To: <1308187568.46.0.159826705626.issue12343@psf.upfronthosting.co.za>
Message-ID: <1308233312.88.0.12334061854.issue12343@psf.upfronthosting.co.za>


Antoine Pitrou <pitrou at free.fr> added the comment:

So let's turn this into a documentation issue, then.

----------
assignee:  -> docs at python
components: +Documentation, Library (Lib) -Extension Modules
nosy: +docs at python
priority: critical -> normal
resolution: invalid -> 
status: closed -> open
title: Python 2.7.2 regression: ssl.SSLError: [Errno 2] _ssl.c:503: The operation did not complete (read) -> ssl documentation needs comments about non-blocking behaviour
versions: +Python 3.2, Python 3.3

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

From report at bugs.python.org  Thu Jun 16 17:07:20 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 16 Jun 2011 15:07:20 +0000
Subject: [docs] [issue9302] distutils API Reference: setup() and
	Extension	parameters' description not correct.
In-Reply-To: <1279532605.75.0.42010773345.issue9302@psf.upfronthosting.co.za>
Message-ID: <1308236840.51.0.0480563365071.issue9302@psf.upfronthosting.co.za>


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

FYI, in one packaging doc I added one note instead of changing each cell: http://docs.python.org/dev/library/packaging.compiler#id6

----------

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

From report at bugs.python.org  Thu Jun 16 17:22:27 2011
From: report at bugs.python.org (ysj.ray)
Date: Thu, 16 Jun 2011 15:22:27 +0000
Subject: [docs] [issue9302] distutils API Reference: setup() and
	Extension	parameters' description not correct.
In-Reply-To: <1279532605.75.0.42010773345.issue9302@psf.upfronthosting.co.za>
Message-ID: <1308237747.48.0.0888509013011.issue9302@psf.upfronthosting.co.za>


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

> FYI, in one packaging doc I added one note instead of changing each cell: http://docs.python.org/dev/library/packaging.compiler#id6


I like this solution, it seems more concise and to the point. With this the doc need only one change:


--- a/Doc/distutils/apiref.rst	Fri Apr 29 14:07:28 2011 +0800
+++ b/Doc/distutils/apiref.rst	Thu Jun 16 23:15:12 2011 +0800
@@ -85,15 +85,15 @@
    | *script_args*      | Arguments to supply to the     | a list of strings                                           |
    |                    | setup script                   |                                                             |
    +--------------------+--------------------------------+-------------------------------------------------------------+
-   | *options*          | default options for the setup  | a string                                                    |
+   | *options*          | default options for the setup  | a dictionary                                                |
    |                    | script                         |                                                             |
    +--------------------+--------------------------------+-------------------------------------------------------------+

----------

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

From report at bugs.python.org  Thu Jun 16 17:26:22 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 16 Jun 2011 15:26:22 +0000
Subject: [docs] [issue9302] distutils API Reference: setup() and
	Extension	parameters' description not correct.
In-Reply-To: <1279532605.75.0.42010773345.issue9302@psf.upfronthosting.co.za>
Message-ID: <1308237982.11.0.679795501898.issue9302@psf.upfronthosting.co.za>


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

Thanks for your feedback.  My patch assumes that people will understand that an argument that has a plural name (like macros) can?t be a string but a list of strings; I don?t know if relying on this inference is better than your initial patch.  An alternate style that I saw somewhere is to use ?[str]? to describe a list of strings.

----------

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

From report at bugs.python.org  Thu Jun 16 18:01:12 2011
From: report at bugs.python.org (R. David Murray)
Date: Thu, 16 Jun 2011 16:01:12 +0000
Subject: [docs] [issue9302] distutils API Reference: setup() and
	Extension	parameters' description not correct.
In-Reply-To: <1279532605.75.0.42010773345.issue9302@psf.upfronthosting.co.za>
Message-ID: <1308240072.63.0.218628648738.issue9302@psf.upfronthosting.co.za>


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

I would not read [str] as implying a list of strings, FWIW.  Nor would I assume a plural option meant a list if the text says "a string".  But I'm just a bystander here and haven't even looked the docs you guys are updating :)

----------

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

From report at bugs.python.org  Thu Jun 16 18:11:52 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 16 Jun 2011 16:11:52 +0000
Subject: [docs] [issue9302] distutils API Reference: setup() and
	Extension	parameters' description not correct.
In-Reply-To: <1279532605.75.0.42010773345.issue9302@psf.upfronthosting.co.za>
Message-ID: <1308240711.91.0.0664543632489.issue9302@psf.upfronthosting.co.za>


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

> Nor would I assume a plural option meant a list if the text says "a string".

Especially in distutils code where we can get space-separated or comma-separated values from the command line or config files.  I?m in favor of using explicit ?list of strings? wording now.  ysj.ray, I understand from the ?Done? comments on the review page that you have an updated patch somewhere; please upload and I?ll commit.

----------

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

From matrixhasu at gmail.com  Thu Jun 16 22:01:46 2011
From: matrixhasu at gmail.com (Sandro Tosi)
Date: Thu, 16 Jun 2011 22:01:46 +0200
Subject: [docs] datetime.now() bug
In-Reply-To: <33F4B11231F5FE4B82FC5CEF93EF439F0242FFF6@ntespe04.EU.COSCON.COS>
References: <33F4B11231F5FE4B82FC5CEF93EF439F0242FFF6@ntespe04.EU.COSCON.COS>
Message-ID: <BANLkTim+rWwngmW+3AnQzgNHbqM0y8YE3g@mail.gmail.com>

Hello,

On 2011-06-10, maquema/Martin Maqueira (SPAIN System Administrator)
<maquema at coscoiberia.com> wrote:
> I write you because I found a bug in datetime.now(). (tested in Python 2.6.6
> -r266:84297, Aug 24 2010, 18:46:32-win32) This bug is that sometime doesn?t
> return milliseconds.

Please note this is not a general bug reporting mailing-list, but it's
targetted at documentation. If you think it's a bug, you can report it
as an issue at [1] or ask for guidance on a general-purpose ml such as
python-list[2]

[1] http://bugs.python.org
[2] http://mail.python.org/mailman/listinfo/python-list

As a side note, I don't find any clear statement in the documentation
that the milliseconds should be there, while it's quite clear that the
precision is depending on the underlying (as in the operating system
ones) functions.

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  Thu Jun 16 22:20:26 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Thu, 16 Jun 2011 20:20:26 +0000
Subject: [docs] [issue12349] Typo in 3.2 "What's New": WGSI / WSGI
In-Reply-To: <1308255626.38.0.351857502668.issue12349@psf.upfronthosting.co.za>
Message-ID: <1308255626.38.0.351857502668.issue12349@psf.upfronthosting.co.za>


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

Following up http://mail.python.org/pipermail/docs/2011-June/004729.html, here's a patch to correct the WGSI/WSGI typo in 3.2 "What's new" (to be applied in 3.2 and default).

----------
assignee: docs at python
components: Documentation
files: 3.2_whatsnew_WSGI-3.2.patch
keywords: patch
messages: 138465
nosy: docs at python, sandro.tosi
priority: low
severity: normal
stage: patch review
status: open
title: Typo in 3.2 "What's New": WGSI / WSGI
versions: Python 3.2, Python 3.3
Added file: http://bugs.python.org/file22381/3.2_whatsnew_WSGI-3.2.patch

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

From matrixhasu at gmail.com  Thu Jun 16 22:21:20 2011
From: matrixhasu at gmail.com (Sandro Tosi)
Date: Thu, 16 Jun 2011 22:21:20 +0200
Subject: [docs] Doco bug
In-Reply-To: <6778E90D923651429D4E9B623EC58BDD31F77E8E8E@IWPMAIL2.corp.checkfree.com>
References: <6778E90D923651429D4E9B623EC58BDD31F77E8E8E@IWPMAIL2.corp.checkfree.com>
Message-ID: <BANLkTi=DE-es2mrVK=FbNNOWS42FjcDuaw@mail.gmail.com>

Hello Chris,

On 2011-06-09, Johnson, Chris M (Dublin) <Chris.Johnson at fiserv.com> wrote:
> On this page: http://docs.python.org/dev/whatsnew/3.2.html
>
> In the section for PEP 3333, in the first sentence, WSGI has been misspelled
> as WGSI

Thanks for spotting it and making up aware of it: I've opened
http://bugs.python.org/issue12349 to fix it.

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 Jun 16 22:28:47 2011
From: report at bugs.python.org (Lars Wirzenius)
Date: Thu, 16 Jun 2011 20:28:47 +0000
Subject: [docs] [issue12350] Improve stat_result.st_blocks and
	st_blksize	documentation
In-Reply-To: <1308256127.22.0.581997138097.issue12350@psf.upfronthosting.co.za>
Message-ID: <1308256127.22.0.581997138097.issue12350@psf.upfronthosting.co.za>


New submission from Lars Wirzenius <liw at liw.fi>:

Attached patch adds a few words to the os.stat documentation for the st_blocks and st_blksize fields to clarify them.

----------
assignee: docs at python
components: Documentation
files: stat_result.patch
keywords: patch
messages: 138467
nosy: docs at python, liw
priority: normal
severity: normal
status: open
title: Improve stat_result.st_blocks and st_blksize documentation
versions: Python 2.7
Added file: http://bugs.python.org/file22382/stat_result.patch

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

From report at bugs.python.org  Thu Jun 16 22:42:33 2011
From: report at bugs.python.org (R. David Murray)
Date: Thu, 16 Jun 2011 20:42:33 +0000
Subject: [docs] [issue12350] Improve stat_result.st_blocks and
	st_blksize	documentation
In-Reply-To: <1308256127.22.0.581997138097.issue12350@psf.upfronthosting.co.za>
Message-ID: <1308256952.91.0.218385295755.issue12350@psf.upfronthosting.co.za>


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

Looks good for linux.  Do you have a posix reference that confirms this interpretation?

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

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

From report at bugs.python.org  Thu Jun 16 22:49:57 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Thu, 16 Jun 2011 20:49:57 +0000
Subject: [docs] [issue12351] Update URL for pycrypto project
In-Reply-To: <1308257397.7.0.688141477172.issue12351@psf.upfronthosting.co.za>
Message-ID: <1308257397.7.0.688141477172.issue12351@psf.upfronthosting.co.za>


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

Following up http://mail.python.org/pipermail/docs/2011-June/004728.html, here's a patch (appliable on 2.7, 3.1, 3.2 and default) to update the pycrypto URL to its new home.

----------
assignee: docs at python
components: Documentation
files: pycrypto_new_url-2.7.patch
keywords: patch
messages: 138470
nosy: docs at python, sandro.tosi
priority: low
severity: normal
stage: patch review
status: open
title: Update URL for pycrypto project
versions: Python 2.7, Python 3.1, Python 3.2, Python 3.3
Added file: http://bugs.python.org/file22383/pycrypto_new_url-2.7.patch

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

From matrixhasu at gmail.com  Thu Jun 16 22:50:40 2011
From: matrixhasu at gmail.com (Sandro Tosi)
Date: Thu, 16 Jun 2011 22:50:40 +0200
Subject: [docs] Link to PyCrypto
In-Reply-To: <BANLkTinWVamUgG_0zNckxtSvDuHd21pkhA@mail.gmail.com>
References: <BANLkTinWVamUgG_0zNckxtSvDuHd21pkhA@mail.gmail.com>
Message-ID: <BANLkTimGqYPHyojVaHkm7utNKKSozgzd5w@mail.gmail.com>

Hello Henrik,

On 2011-06-09, Henrik Holm <henrik at henrikholm.com> wrote:
> Hi, there's a link to PyCrypto on your documentation page "14.
> Cryptographic Services" (http://docs.python.org/library/crypto.html)
> This points to Kuchling's original package, on version 2.0.1.
> PyCrypto has apparently been taken over by someone else, so I'd
> suggest changing the link to https://launchpad.net/pycrypto .

Thanks for your email, I've opened http://bugs.python.org/issue12351 to fix it.

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 Jun 16 23:05:56 2011
From: report at bugs.python.org (Lars Wirzenius)
Date: Thu, 16 Jun 2011 21:05:56 +0000
Subject: [docs] [issue12350] Improve stat_result.st_blocks and
	st_blksize	documentation
In-Reply-To: <1308256127.22.0.581997138097.issue12350@psf.upfronthosting.co.za>
Message-ID: <1308258356.31.0.134218079649.issue12350@psf.upfronthosting.co.za>


Lars Wirzenius <liw at liw.fi> added the comment:

http://pubs.opengroup.org/onlinepubs/009695399/basedefs/sys/stat.h.html says "A file system-specific preferred I/O block size for this object. In some file system types, this may vary from file to file.", which says essentially the same as the Linux stat(2) manpage from which I copied the extra words.

The same page claims that st_blocks may use other units than 512 byte blocks, but that seems to be quite rare. GNU coreutils sources claim HP-UX and AIX PS/2 have non-512 blocks. Perhaps it would be better to indicate how to find out the block size? (Since st_blksize is not it, but that's an easy assumption to make.)

----------

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

From matrixhasu at gmail.com  Thu Jun 16 23:32:47 2011
From: matrixhasu at gmail.com (Sandro Tosi)
Date: Thu, 16 Jun 2011 23:32:47 +0200
Subject: [docs] Glossary Suggestion
In-Reply-To: <5A1137F25F0B423799F0233A6C181F3D@TSUNAMI>
References: <5A1137F25F0B423799F0233A6C181F3D@TSUNAMI>
Message-ID: <BANLkTinKJh6VOTTymeCF-sGTNsm0Uc6Gqg@mail.gmail.com>

Hello Greg,

On 2011-06-13, mrg_n00q at q.com <mrg_n00q at q.com> wrote:
> I'm getting into Python and I like it quite a bit,
> but wrestling with the nomenclature can be
> troublesome for an informal programmer.  The
> glossary (in the v3.3.0 documentation) helps, but
> I would point out as a gentle suggestion that, since
> it repeatedly refers to "containers", it might also
> include a definition of "container".

The only reference to 'container' in 3.3 glossary is inside the
'hashable' key, and it reads like "mutable containers (such as lists
or dictionaries)" which already explains what they are.

Perhaps you're not referring to containers references inside glossary
but somewhere else? I find containers pretty well defined in:
http://docs.python.org/dev/library/collections.html

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 Jun 16 23:38:43 2011
From: report at bugs.python.org (R. David Murray)
Date: Thu, 16 Jun 2011 21:38:43 +0000
Subject: [docs] [issue12350] Improve stat_result.st_blocks and
	st_blksize	documentation
In-Reply-To: <1308256127.22.0.581997138097.issue12350@psf.upfronthosting.co.za>
Message-ID: <1308260323.79.0.0350542753928.issue12350@psf.upfronthosting.co.za>


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

Ah, bingo.  That was what was tickling at my memory but I couldn't remember what the exact issue was I was recalling.  I forget what I was doing where that mattered, but as I vaguely remember it there is no portable way to find out what blocksize st_blocks is in.  Or at least not one that is currently exposed from Python.  I could be remembering wrong, though.

----------

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

From report at bugs.python.org  Thu Jun 16 23:44:03 2011
From: report at bugs.python.org (R. David Murray)
Date: Thu, 16 Jun 2011 21:44:03 +0000
Subject: [docs] [issue12350] Improve stat_result.st_blocks and
	st_blksize	documentation
In-Reply-To: <1308256127.22.0.581997138097.issue12350@psf.upfronthosting.co.za>
Message-ID: <1308260643.74.0.742186643914.issue12350@psf.upfronthosting.co.za>


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

Ah, found it: Issue 10016.

----------

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

From report at bugs.python.org  Thu Jun 16 23:44:32 2011
From: report at bugs.python.org (R. David Murray)
Date: Thu, 16 Jun 2011 21:44:32 +0000
Subject: [docs] [issue12350] Improve stat_result.st_blocks and
	st_blksize	documentation
In-Reply-To: <1308256127.22.0.581997138097.issue12350@psf.upfronthosting.co.za>
Message-ID: <1308260672.16.0.514749825662.issue12350@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Jun 17 01:48:18 2011
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 16 Jun 2011 23:48:18 +0000
Subject: [docs] [issue12351] Update URL for pycrypto project
In-Reply-To: <1308257397.7.0.688141477172.issue12351@psf.upfronthosting.co.za>
Message-ID: <E1QXMIL-0003Mk-AR@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 0cb49ca95109 by Benjamin Peterson in branch '2.7':
update link to pycrypto (closes #12351)
http://hg.python.org/cpython/rev/0cb49ca95109

New changeset 4d465cef3257 by Benjamin Peterson in branch '3.2':
update link to pycrypto (closes #12351)
http://hg.python.org/cpython/rev/4d465cef3257

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

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

From report at bugs.python.org  Fri Jun 17 04:31:42 2011
From: report at bugs.python.org (ysj.ray)
Date: Fri, 17 Jun 2011 02:31:42 +0000
Subject: [docs] [issue9302] distutils API Reference: setup() and
	Extension	parameters' description not correct.
In-Reply-To: <1279532605.75.0.42010773345.issue9302@psf.upfronthosting.co.za>
Message-ID: <1308277901.91.0.197285885034.issue9302@psf.upfronthosting.co.za>


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

> I would not read [str] as implying a list of strings, FWIW.

help() on distutils.extension.Extension gives the parameters description like this:
    ......
    sources: [string]
    ......
    include_dirs: [string]
    ......

So I guess this style can be used as somewhere.


> I?m in favor of using explicit ?list of strings? wording now.  ysj.ray, I understand from the ?Done? comments on the review page that you have an updated patch somewhere; please upload and I?ll commit.


Ok, here is it. Thanks!

----------
Added file: http://bugs.python.org/file22391/issue_9302_2.diff

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

From report at bugs.python.org  Fri Jun 17 08:24:58 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Fri, 17 Jun 2011 06:24:58 +0000
Subject: [docs] [issue12349] Typo in 3.2 "What's New": WGSI / WSGI
In-Reply-To: <1308255626.38.0.351857502668.issue12349@psf.upfronthosting.co.za>
Message-ID: <1308291898.19.0.386056266757.issue12349@psf.upfronthosting.co.za>


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

Fixed by Raymond (thanks!) with these commits:

http://hg.python.org/cpython/rev/0fe3b81c7c89
http://hg.python.org/cpython/rev/cf56abd14eef

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

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

From report at bugs.python.org  Fri Jun 17 20:16:14 2011
From: report at bugs.python.org (=?utf-8?q?Filip_Gruszczy=C5=84ski?=)
Date: Fri, 17 Jun 2011 18:16:14 +0000
Subject: [docs] [issue12354] packaging.pypi.simple docs use both client and
	crawler	variable, which might be confusing
In-Reply-To: <1308334574.8.0.60329566716.issue12354@psf.upfronthosting.co.za>
Message-ID: <1308334574.8.0.60329566716.issue12354@psf.upfronthosting.co.za>


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

In documentation for packaging.pypi.simple in first code snippet crawler variable is created on which further operations will be performed. However in all next snippets there is client variable, which is a little confusing on first sight. This could be consistent throughout the whole page.

----------
assignee: docs at python
components: Distutils2, Documentation
messages: 138538
nosy: alexis, docs at python, eric.araujo, gruszczy
priority: normal
severity: normal
status: open
title: packaging.pypi.simple docs use both client and crawler variable, which might be confusing
versions: Python 3.3

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

From report at bugs.python.org  Fri Jun 17 20:20:13 2011
From: report at bugs.python.org (=?utf-8?q?Filip_Gruszczy=C5=84ski?=)
Date: Fri, 17 Jun 2011 18:20:13 +0000
Subject: [docs] [issue12354] packaging.pypi.simple docs use both client and
	crawler	variable, which might be confusing
In-Reply-To: <1308334574.8.0.60329566716.issue12354@psf.upfronthosting.co.za>
Message-ID: <1308334813.12.0.977921702672.issue12354@psf.upfronthosting.co.za>


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

And a small, quick patch to docs.

----------
keywords: +patch
Added file: http://bugs.python.org/file22396/12354.patch

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

From report at bugs.python.org  Fri Jun 17 20:22:35 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 17 Jun 2011 18:22:35 +0000
Subject: [docs] [issue12354] packaging.pypi.simple docs use both client and
	crawler	variable, which might be confusing
In-Reply-To: <1308334574.8.0.60329566716.issue12354@psf.upfronthosting.co.za>
Message-ID: <1308334955.07.0.363212318892.issue12354@psf.upfronthosting.co.za>


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

Thanks for the report.  I?m editing the doc to fix all instances of client and also improve phrasing in the whole file.

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

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

From report at bugs.python.org  Fri Jun 17 20:42:10 2011
From: report at bugs.python.org (Lars Wirzenius)
Date: Fri, 17 Jun 2011 18:42:10 +0000
Subject: [docs] [issue12350] Improve stat_result.st_blocks and
	st_blksize	documentation
In-Reply-To: <1308256127.22.0.581997138097.issue12350@psf.upfronthosting.co.za>
Message-ID: <1308336130.2.0.102232281084.issue12350@psf.upfronthosting.co.za>


Lars Wirzenius <liw at liw.fi> added the comment:

Right. So I guess at least the following should be changed (I'll make an actual patch once there's consensus):

* st_blocks should say that the size of block is often 512 bytes, but that's not guaranteed, and there's no way to know for sure

* st_blksize should say it is size of efficient I/O, and is unrelated to st_blocks

Should there be something more? Ideally, there should be a way to find out the size of blocks for st_blocks, but I don't know how to figure that out (though probably code from GNU's du could be borrowed).

----------

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

From report at bugs.python.org  Fri Jun 17 20:49:33 2011
From: report at bugs.python.org (R. David Murray)
Date: Fri, 17 Jun 2011 18:49:33 +0000
Subject: [docs] [issue12350] Improve stat_result.st_blocks and
	st_blksize	documentation
In-Reply-To: <1308256127.22.0.581997138097.issue12350@psf.upfronthosting.co.za>
Message-ID: <1308336573.05.0.0835072166744.issue12350@psf.upfronthosting.co.za>


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

I think that wording is as good as we can do for now.  Providing a way to determine the size of st_blocks blocks should be a separate issue (a feature request).  That enhancement can include an update to these docs, but since it is an enhancement it will only go into the development version.  But your wording fix should go into all maintained versions.

I think your suggested rewording is reasonable.

----------

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

From report at bugs.python.org  Fri Jun 17 23:25:06 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 17 Jun 2011 21:25:06 +0000
Subject: [docs] [issue12298] Sphinx glitch in library/functions
In-Reply-To: <1307635612.57.0.782200385704.issue12298@psf.upfronthosting.co.za>
Message-ID: <1308345906.05.0.881966267005.issue12298@psf.upfronthosting.co.za>


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

I agree that all table entries should link to the entry in the same file.

dict() and set() also jump to CH. 4, in addition to memoryview and frozenset. Others all work properly.

The entries for classes should generally have a link to their section in '4. Built-in Types'. All do other than these:

range() definitely needs a forward reference to 4.6 sequence types 

bool() lacks forward references; it could have one to 4.2 Bool ops and 4.11.9 Bool values

object() -- no where to go.

slice() only has a reference to the glossary; it has no entry in Ch.4. "Slice objects have read-only data attributes start, stop and step which merely return the argument values (or their default). They have no other explicit functionality" is slightly wrong since there is the .indices method.

type(n,b,d) has no forward references as there is no where to go exactly

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

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

From report at bugs.python.org  Sat Jun 18 00:54:05 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 17 Jun 2011 22:54:05 +0000
Subject: [docs] [issue12315] Improve http.client.HTTPResponse.read
	documentation
In-Reply-To: <1307733776.17.0.904388798994.issue12315@psf.upfronthosting.co.za>
Message-ID: <1308351245.68.0.24192047433.issue12315@psf.upfronthosting.co.za>


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

The patch does 3 things:

1. clarify that 'amt' in 'the next amt bytes' means 'amount'.

I do not think this is necessary; 'the next blah bytes' is clear. Actually, 'amt' really means 'number', not 'amount', which would imply that 'amt' is a float, not an int. 'amt' was a poor choice of parameter name and should have been 'n' or 'nbytes' I presume it has to be an int, not a float. Since it is passed on to the socket file wrapper, I suspect that io.rawiobase."read(n=-1) 
Read up to n bytes from the object and return them. As a convenience, if n is unspecified or -1, readall() is called. Otherwise, only one system call is ever made. Fewer than n bytes may be returned if the operating system call returns fewer than n bytes.

If 0 bytes are returned, and n was not 0, this indicates end of file. If the object is in non-blocking mode and no bytes are available, None is returned."
applies, but I am not really sure.

2. Add an example after the entry for .read().
This seems out of place since there is already a section for examples. All three of the existing examples use response.read. One of them could be enlarged slightly to read in chunks if an example is needed.

3. Document .closed
If it were mentioned that HTTPResponse is a subclass of RawIOBase, and perhaps it should be, the existence of .closed might be inferred. But since not everything is implemented, and since .closed is useful to iterate (as should be the example), I agree this should be added.

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

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

From report at bugs.python.org  Sat Jun 18 16:34:55 2011
From: report at bugs.python.org (anatoly techtonik)
Date: Sat, 18 Jun 2011 14:34:55 +0000
Subject: [docs] [issue12359] tutorial: Module search path description is
	incorrect
In-Reply-To: <1308407695.09.0.303681719961.issue12359@psf.upfronthosting.co.za>
Message-ID: <1308407695.09.0.303681719961.issue12359@psf.upfronthosting.co.za>


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

http://docs.python.org/tutorial/modules.html#the-module-search-path

Module search path order description is misleading. When a module named spam is imported, the interpreter searches for a file named spam.py in the directory of the script with import instruction, not in the current directory.

----------
assignee: docs at python
components: Documentation
messages: 138584
nosy: docs at python, techtonik
priority: normal
severity: normal
status: open
title: tutorial: Module search path description is incorrect
versions: Python 2.7

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

From report at bugs.python.org  Sat Jun 18 16:57:57 2011
From: report at bugs.python.org (R. David Murray)
Date: Sat, 18 Jun 2011 14:57:57 +0000
Subject: [docs] [issue12359] tutorial: Module search path description is
	incorrect
In-Reply-To: <1308407695.09.0.303681719961.issue12359@psf.upfronthosting.co.za>
Message-ID: <1308409076.95.0.153824894715.issue12359@psf.upfronthosting.co.za>


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

The second paragraph goes on to cover your point, but I agree that it is not as clear as it should be.

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

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

From report at bugs.python.org  Sat Jun 18 20:12:43 2011
From: report at bugs.python.org (R. David Murray)
Date: Sat, 18 Jun 2011 18:12:43 +0000
Subject: [docs] [issue3216] Scarce msilib documentation
In-Reply-To: <1214577470.61.0.590067451474.issue3216@psf.upfronthosting.co.za>
Message-ID: <1308420763.23.0.172228493648.issue3216@psf.upfronthosting.co.za>


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


----------
keywords:  -easy, patch

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

From report at bugs.python.org  Sat Jun 18 22:11:13 2011
From: report at bugs.python.org (Martin Marcher)
Date: Sat, 18 Jun 2011 20:11:13 +0000
Subject: [docs] [issue12360] Doc Typo
In-Reply-To: <1308427873.33.0.846212256461.issue12360@psf.upfronthosting.co.za>
Message-ID: <1308427873.33.0.846212256461.issue12360@psf.upfronthosting.co.za>


New submission from Martin Marcher <martin at marcher.name>:

Slight typo in the docs.

I don't quite know how to work with mercurial. Hope it'll just work to merge the bitbucket link.

Typo is here: http://docs.python.org/py3k/library/asyncore.html#asyncore.dispatcher.handle_accepted (but also present in tip)

The parameter is named *sock*, but the docs talk about *conn*.

regards
Martin


hg diff -r 9569d8c4c781
diff -r 9569d8c4c781 Doc/library/asyncore.rst
--- a/Doc/library/asyncore.rst	Sat Jun 18 13:02:42 2011 -0400
+++ b/Doc/library/asyncore.rst	Sat Jun 18 22:08:42 2011 +0200
@@ -157,7 +157,7 @@
 
       Called on listening channels (passive openers) when a connection has been
       established with a new remote endpoint that has issued a :meth:`connect`
-      call for the local endpoint.  *conn* is a *new* socket object usable to
+      call for the local endpoint.  *sock* is a *new* socket object usable to
       send and receive data on the connection, and *address* is the address
       bound to the socket on the other end of the connection.

----------
assignee: docs at python
components: Documentation
hgrepos: 30
messages: 138594
nosy: docs at python, martin.marcher
priority: normal
severity: normal
status: open
title: Doc Typo
versions: Python 3.2

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

From report at bugs.python.org  Sat Jun 18 22:12:49 2011
From: report at bugs.python.org (Martin Marcher)
Date: Sat, 18 Jun 2011 20:12:49 +0000
Subject: [docs] [issue12360] Doc Typo
In-Reply-To: <1308427873.33.0.846212256461.issue12360@psf.upfronthosting.co.za>
Message-ID: <1308427969.04.0.979129128846.issue12360@psf.upfronthosting.co.za>


Martin Marcher <martin at marcher.name> added the comment:

Fix repo link :(

----------
hgrepos: +31

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

From report at bugs.python.org  Sat Jun 18 22:13:20 2011
From: report at bugs.python.org (Martin Marcher)
Date: Sat, 18 Jun 2011 20:13:20 +0000
Subject: [docs] [issue12360] Doc Typo
In-Reply-To: <1308427873.33.0.846212256461.issue12360@psf.upfronthosting.co.za>
Message-ID: <1308428000.55.0.0534247173123.issue12360@psf.upfronthosting.co.za>


Changes by Martin Marcher <martin at marcher.name>:


----------
keywords: +patch
Added file: http://bugs.python.org/file22405/2d9bc44963f6.diff

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

From report at bugs.python.org  Sun Jun 19 01:42:47 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 18 Jun 2011 23:42:47 +0000
Subject: [docs] [issue6771] Curses.wrapper: documentation/implementation
	error
In-Reply-To: <1251099236.05.0.0799674766136.issue6771@psf.upfronthosting.co.za>
Message-ID: <E1QY5A5-0007io-Kk@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset dc78ab3f7bc5 by R David Murray in branch '2.7':
#6771: fix docs: curses.wrapper is exposed as a function, not a module
http://hg.python.org/cpython/rev/dc78ab3f7bc5

New changeset f9b4cfc19264 by R David Murray in branch '3.2':
#6771: fix docs: curses.wrapper is exposed as a function, not a module
http://hg.python.org/cpython/rev/f9b4cfc19264

New changeset bb5e950ebb04 by R David Murray in branch 'default':
merge #6771: fix docs: curses.wrapper is exposed as a function, not a module
http://hg.python.org/cpython/rev/bb5e950ebb04

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

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

From report at bugs.python.org  Sun Jun 19 02:21:31 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 19 Jun 2011 00:21:31 +0000
Subject: [docs] [issue6771] Curses.wrapper: documentation/implementation
	error
In-Reply-To: <1251099236.05.0.0799674766136.issue6771@psf.upfronthosting.co.za>
Message-ID: <E1QY5lX-0001be-Qi@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 9c96c3adbcd1 by R David Murray in branch 'default':
#6771: Move wrapper function into __init__ and eliminate wrapper module
http://hg.python.org/cpython/rev/9c96c3adbcd1

----------

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

From report at bugs.python.org  Sun Jun 19 02:22:10 2011
From: report at bugs.python.org (R. David Murray)
Date: Sun, 19 Jun 2011 00:22:10 +0000
Subject: [docs] [issue6771] Curses.wrapper: documentation/implementation
	error
In-Reply-To: <1251099236.05.0.0799674766136.issue6771@psf.upfronthosting.co.za>
Message-ID: <1308442930.04.0.778191445503.issue6771@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sun Jun 19 17:02:13 2011
From: report at bugs.python.org (Nick Coghlan)
Date: Sun, 19 Jun 2011 15:02:13 +0000
Subject: [docs] [issue11690] Devguide: Add "communication" FAQ
In-Reply-To: <1301188192.33.0.9529618781.issue11690@psf.upfronthosting.co.za>
Message-ID: <1308495733.31.0.413093945233.issue11690@psf.upfronthosting.co.za>


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

Comms FAQ: http://hg.python.org/devguide/rev/f1ebfb53437f
Devguide note: http://hg.python.org/devguide/rev/5ab42baba771

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

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

From report at bugs.python.org  Sun Jun 19 17:04:11 2011
From: report at bugs.python.org (Nick Coghlan)
Date: Sun, 19 Jun 2011 15:04:11 +0000
Subject: [docs] [issue11690] Devguide: Add "communication" FAQ
In-Reply-To: <1301188192.33.0.9529618781.issue11690@psf.upfronthosting.co.za>
Message-ID: <1308495851.13.0.285417526508.issue11690@psf.upfronthosting.co.za>


Changes by Nick Coghlan <ncoghlan at gmail.com>:


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

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

From report at bugs.python.org  Sun Jun 19 18:12:24 2011
From: report at bugs.python.org (R. David Murray)
Date: Sun, 19 Jun 2011 16:12:24 +0000
Subject: [docs] [issue10454] Clarify compileall command-line options
In-Reply-To: <1290096691.96.0.508340552683.issue10454@psf.upfronthosting.co.za>
Message-ID: <1308499944.49.0.0078038174769.issue10454@psf.upfronthosting.co.za>


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

Looks fine except for your changes to the parenthesized defaults.  Those should be '0' and 'False' for 2.7 and 3.x, respectively, since that's what they areally are.

----------

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

From report at bugs.python.org  Sun Jun 19 22:57:12 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 19 Jun 2011 20:57:12 +0000
Subject: [docs] [issue12261] urllib.parse docs still refer to urlparse
In-Reply-To: <1307129696.46.0.265723026729.issue12261@psf.upfronthosting.co.za>
Message-ID: <E1QYP3P-0001X3-2x@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 4211ace1ff5d by Senthil Kumaran in branch '3.1':
Fix closes issue12261 - Minor documention changes in the urllib.parse.rst
http://hg.python.org/cpython/rev/4211ace1ff5d

New changeset 18f3239b3d48 by Senthil Kumaran in branch '3.2':
merge from 3.1 for issue issue12261.
http://hg.python.org/cpython/rev/18f3239b3d48

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

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

From report at bugs.python.org  Mon Jun 20 02:00:45 2011
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 20 Jun 2011 00:00:45 +0000
Subject: [docs] [issue12315] Improve http.client.HTTPResponse.read
	documentation
In-Reply-To: <1307733776.17.0.904388798994.issue12315@psf.upfronthosting.co.za>
Message-ID: <E1QYRv1-0004Hs-Uk@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset d801b570b1dd by Senthil Kumaran in branch '3.2':
Fix closes Issue12315 - Updates to http.client documentation.
http://hg.python.org/cpython/rev/d801b570b1dd

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

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

From report at bugs.python.org  Mon Jun 20 02:42:35 2011
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 20 Jun 2011 00:42:35 +0000
Subject: [docs] [issue12359] tutorial: Module search path description is
	incorrect
In-Reply-To: <1308407695.09.0.303681719961.issue12359@psf.upfronthosting.co.za>
Message-ID: <E1QYSZW-0006bh-Dv@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset bf8b4c43fb94 by Senthil Kumaran in branch '3.2':
Fix closes Issue12359 - Minor update to module import description.
http://hg.python.org/cpython/rev/bf8b4c43fb94

New changeset 8754fd2ff64a by Senthil Kumaran in branch 'default':
merge from 3.2. Issue 12359
http://hg.python.org/cpython/rev/8754fd2ff64a

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

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

From report at bugs.python.org  Mon Jun 20 02:46:21 2011
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 20 Jun 2011 00:46:21 +0000
Subject: [docs] [issue12359] tutorial: Module search path description is
	incorrect
In-Reply-To: <1308407695.09.0.303681719961.issue12359@psf.upfronthosting.co.za>
Message-ID: <E1QYSdA-0006vO-JO@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 6c16a31e0442 by Senthil Kumaran in branch '2.7':
Fix issue12359. Minor doc update on import module description.
http://hg.python.org/cpython/rev/6c16a31e0442

----------

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

From report at bugs.python.org  Mon Jun 20 03:25:40 2011
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 20 Jun 2011 01:25:40 +0000
Subject: [docs] [issue12360] Doc Typo
In-Reply-To: <1308427873.33.0.846212256461.issue12360@psf.upfronthosting.co.za>
Message-ID: <E1QYTFC-0000ms-No@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset d310cc1c3a5d by Senthil Kumaran in branch '3.2':
Fix closes issue 12360 -  correcting parameter names in asyncore documentation.
http://hg.python.org/cpython/rev/d310cc1c3a5d

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

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

From report at bugs.python.org  Mon Jun 20 11:00:20 2011
From: report at bugs.python.org (anatoly techtonik)
Date: Mon, 20 Jun 2011 09:00:20 +0000
Subject: [docs] [issue12359] tutorial: Module search path description is
	incorrect
In-Reply-To: <1308407695.09.0.303681719961.issue12359@psf.upfronthosting.co.za>
Message-ID: <1308560420.68.0.533077954429.issue12359@psf.upfronthosting.co.za>


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

On Mon, Jun 20, 2011 at 3:42 AM, Roundup Robot <report at bugs.python.org> wrote:
>
> New changeset bf8b4c43fb94 by Senthil Kumaran in branch '3.2':
> Fix closes Issue12359 - Minor update to module import description.
> http://hg.python.org/cpython/rev/bf8b4c43fb94

1. There is a typo 'thecurrent' in this commit
2. The interpreter doesn't search current directory. The first item appended to sys.path is the directory of the importing script.

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

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

From report at bugs.python.org  Mon Jun 20 11:02:57 2011
From: report at bugs.python.org (anatoly techtonik)
Date: Mon, 20 Jun 2011 09:02:57 +0000
Subject: [docs] [issue12359] tutorial: Module search path description is
	incorrect
In-Reply-To: <1308407695.09.0.303681719961.issue12359@psf.upfronthosting.co.za>
Message-ID: <1308560577.83.0.213540697687.issue12359@psf.upfronthosting.co.za>


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

I attach file for testing import if anybody needs it. Move module.py to your current directory, but out of the dir with script.py and execute script.py using relative path from there.

----------
Added file: http://bugs.python.org/file22413/portable-test.7z

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

From report at bugs.python.org  Mon Jun 20 16:38:24 2011
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 20 Jun 2011 14:38:24 +0000
Subject: [docs] [issue12359] tutorial: Module search path description is
	incorrect
In-Reply-To: <1308407695.09.0.303681719961.issue12359@psf.upfronthosting.co.za>
Message-ID: <E1QYfcN-00040H-5t@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset a57134dd8688 by Senthil Kumaran in branch '3.2':
Fix closes Issue12359 - Removing a confusing sentence from the previous change.
http://hg.python.org/cpython/rev/a57134dd8688

New changeset 18ebc7809cb2 by Senthil Kumaran in branch 'default':
merge from 3.2 - Fix closes Issue12359 - Removing a confusing sentence from the previous change.
http://hg.python.org/cpython/rev/18ebc7809cb2

New changeset 51ad2d4390bc by Senthil Kumaran in branch '2.7':
merge 3.2 - Fix closes Issue12359 - Removing a confusing sentence from the previous change.
http://hg.python.org/cpython/rev/51ad2d4390bc

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

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

From report at bugs.python.org  Mon Jun 20 20:48:45 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 20 Jun 2011 18:48:45 +0000
Subject: [docs] [issue12374] Execution model should explain compile vs
	definition vs	execution time
In-Reply-To: <1308582911.55.0.701954968644.issue12374@psf.upfronthosting.co.za>
Message-ID: <1308595725.7.0.170548171955.issue12374@psf.upfronthosting.co.za>


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


----------
assignee:  -> docs at python
components: +Documentation
nosy: +docs at python, eric.araujo
stage:  -> needs patch
versions: +Python 2.7, Python 3.2, Python 3.3

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

From report at bugs.python.org  Tue Jun 21 19:53:05 2011
From: report at bugs.python.org (Adam Woodbeck)
Date: Tue, 21 Jun 2011 17:53:05 +0000
Subject: [docs] [issue10403] Use "member" consistently
In-Reply-To: <1289623042.93.0.830099606418.issue10403@psf.upfronthosting.co.za>
Message-ID: <1308678785.2.0.0506005071564.issue10403@psf.upfronthosting.co.za>


Changes by Adam Woodbeck <adam.woodbeck at gmail.com>:


----------
nosy: +adam.woodbeck

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

From report at bugs.python.org  Wed Jun 22 00:21:47 2011
From: report at bugs.python.org (Adam Woodbeck)
Date: Tue, 21 Jun 2011 22:21:47 +0000
Subject: [docs] [issue10403] Use "member" consistently
In-Reply-To: <1289623042.93.0.830099606418.issue10403@psf.upfronthosting.co.za>
Message-ID: <1308694906.16.0.899861582269.issue10403@psf.upfronthosting.co.za>


Adam Woodbeck <adam.woodbeck at gmail.com> added the comment:

I grepped the documentation in the cpython repository and replaced all mentions of "member(s)" with "attribute(s)" where I felt appropriate.  I left mentions of "members" related to structs or any C documentation alone as I'm less confident of their terminology (I'm new around here).

I used "methods and attribute" in io.rst because BufferedIOBase included one attribute and several methods.  My terminology may be off, but I felt this was the correct replacement of "members."

Please review the patch and critique it as necessary.

----------
keywords: +patch
Added file: http://bugs.python.org/file22422/issue10403.patch

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

From report at bugs.python.org  Wed Jun 22 01:35:00 2011
From: report at bugs.python.org (py.user)
Date: Tue, 21 Jun 2011 23:35:00 +0000
Subject: [docs] [issue12385] the help for bytearray.maketrans
	describes	bytes.maketrans
In-Reply-To: <1308699300.81.0.100519829981.issue12385@psf.upfronthosting.co.za>
Message-ID: <1308699300.81.0.100519829981.issue12385@psf.upfronthosting.co.za>


New submission from py.user <port139 at yandex.ru>:

help(bytearray.maketrans)

maketrans(...)
    B.maketrans(frm, to) -> translation table
    
    Return a translation table (a bytes object of length 256)
    suitable for use in bytes.translate where each byte in frm is
    mapped to the byte at the same position in to.
    The strings frm and to must be of the same length.

----------
assignee: docs at python
components: Documentation
messages: 138808
nosy: docs at python, py.user
priority: normal
severity: normal
status: open
title: the help for bytearray.maketrans describes bytes.maketrans
versions: Python 3.1

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

From report at bugs.python.org  Wed Jun 22 02:15:48 2011
From: report at bugs.python.org (R. David Murray)
Date: Wed, 22 Jun 2011 00:15:48 +0000
Subject: [docs] [issue12385] the help for bytearray.maketrans
	describes	bytes.maketrans
In-Reply-To: <1308699300.81.0.100519829981.issue12385@psf.upfronthosting.co.za>
Message-ID: <1308701748.32.0.270180869754.issue12385@psf.upfronthosting.co.za>


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

Hmm.  I wonder why we have two copies of this method.

Well, given that we do, the best fix for the docs would be to say "for use in the bytes or bytearray translate method" in both this docstring and the bytes.maketrans docstring.

----------
nosy: +r.david.murray
stage:  -> needs patch
type:  -> behavior
versions: +Python 3.2, Python 3.3 -Python 3.1

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

From report at bugs.python.org  Thu Jun 23 01:07:36 2011
From: report at bugs.python.org (Vladimir Rutsky)
Date: Wed, 22 Jun 2011 23:07:36 +0000
Subject: [docs] [issue12389] typo in urllib: missing space after dot at
	sentence end
In-Reply-To: <1308784056.05.0.196763325672.issue12389@psf.upfronthosting.co.za>
Message-ID: <1308784056.05.0.196763325672.issue12389@psf.upfronthosting.co.za>


New submission from Vladimir Rutsky <altsysrq at gmail.com>:

There is a typo in urllib module documentation: missing space after dot at sentence end. Please see attached path for details.

----------
assignee: docs at python
components: Documentation
files: urllib-typo-space-after-dot.patch
keywords: patch
messages: 138838
nosy: docs at python, rutsky
priority: normal
severity: normal
status: open
title: typo in urllib: missing space after dot at sentence end
versions: Python 2.7
Added file: http://bugs.python.org/file22425/urllib-typo-space-after-dot.patch

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

From report at bugs.python.org  Thu Jun 23 02:03:06 2011
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 23 Jun 2011 00:03:06 +0000
Subject: [docs] [issue12389] typo in urllib: missing space after dot at
	sentence end
In-Reply-To: <1308784056.05.0.196763325672.issue12389@psf.upfronthosting.co.za>
Message-ID: <E1QZXNw-0004eC-Vt@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset a0ad25ca772b by R David Murray in branch '2.7':
#12389: fix missing space at sentence end.
http://hg.python.org/cpython/rev/a0ad25ca772b

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

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

From report at bugs.python.org  Thu Jun 23 02:03:37 2011
From: report at bugs.python.org (R. David Murray)
Date: Thu, 23 Jun 2011 00:03:37 +0000
Subject: [docs] [issue12389] typo in urllib: missing space after dot at
	sentence end
In-Reply-To: <1308784056.05.0.196763325672.issue12389@psf.upfronthosting.co.za>
Message-ID: <1308787417.21.0.0594815933421.issue12389@psf.upfronthosting.co.za>


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

Thanks.

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

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

From report at bugs.python.org  Thu Jun 23 02:08:33 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Thu, 23 Jun 2011 00:08:33 +0000
Subject: [docs] [issue12380] bytearray methods center, ljust,
	rjust don't accept a bytearray as the fill character
In-Reply-To: <1308628210.93.0.613061897988.issue12380@psf.upfronthosting.co.za>
Message-ID: <1308787713.82.0.965364938515.issue12380@psf.upfronthosting.co.za>


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

After thinking about this awhile, I see the key sentence of David's reply as "The data type of the arguments to the method have no necessary relationship with the datatype of the object." While true in general, in it not true with respect to corresponing text (string) and byte(array) methods. String parameters of strings methods become byte parameters of byte(array) methods. In the other hand, I think I agree with David's application to byte versus bytearray methods. I might change my mind after further examination of the methods in question. But for the present, I would not change the code.

Or would I? Here is a reason not to change. Example:

for byt in (b'abc', bytearray(b'cdef'), b'xye')
  yield byt.rjust(10,b'-')

Making the type of constant args depend on the type of the base object would make generic byte/bytearray functions more difficult. We already have this problem with writing functions that work with bytes and text in 3.x. It is a big nuisance that is only justified by the benefits of not mixing bytes and text. I do not think we should extend the nuisance to byte and bytearray functions, especially without a strong use case.

I marked this for 'documentation' because I think the doc for some of the str methods might be improved and that the reference to them in the bytes/bytearray definitely needs more. Doc changes would apply to 3.2 also.

"Bytes and bytearray objects, being ?strings of bytes?, have all methods found on strings, with the exception ... " 

should be followed by something like. 

"If the string method has a string parameter, the corresponding byte/bytearray method has a corresponding byte parameter."

(to match the reported current behavior).

I have not yet looked at doc strings. I did not unmark 'Interpreter core' because I have not looked at all of p.u's examples to be sure that I like *all* of the current behaviors.

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

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

From report at bugs.python.org  Thu Jun 23 03:19:30 2011
From: report at bugs.python.org (R. David Murray)
Date: Thu, 23 Jun 2011 01:19:30 +0000
Subject: [docs] [issue9921] os.path.join('x','') behavior
In-Reply-To: <1285168977.46.0.728141650864.issue9921@psf.upfronthosting.co.za>
Message-ID: <1308791970.73.0.291273444028.issue9921@psf.upfronthosting.co.za>


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

Here is a patch that I think describes the algorithm correctly, based on the comments in the module, with a clarifying parenthetical to cover the non-obvious consequence of that algorithm.

----------
versions: +Python 3.3 -Python 3.1
Added file: http://bugs.python.org/file22426/os.path.join-doc.patch

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

From report at bugs.python.org  Thu Jun 23 05:33:04 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Thu, 23 Jun 2011 03:33:04 +0000
Subject: [docs] [issue12380] bytearray methods center, ljust,
	rjust don't accept a bytearray as the fill character
In-Reply-To: <1308628210.93.0.613061897988.issue12380@psf.upfronthosting.co.za>
Message-ID: <1308799984.42.0.904309260418.issue12380@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/issue12380>
_______________________________________

From report at bugs.python.org  Thu Jun 23 09:34:30 2011
From: report at bugs.python.org (Brian Brazil)
Date: Thu, 23 Jun 2011 07:34:30 +0000
Subject: [docs] [issue9921] os.path.join('x','') behavior
In-Reply-To: <1285168977.46.0.728141650864.issue9921@psf.upfronthosting.co.za>
Message-ID: <1308814470.58.0.979385244706.issue9921@psf.upfronthosting.co.za>


Brian Brazil <brian.brazil at gmail.com> added the comment:

David's change sounds good to me.

----------

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

From report at bugs.python.org  Fri Jun 24 03:27:52 2011
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 24 Jun 2011 01:27:52 +0000
Subject: [docs] [issue9921] os.path.join('x','') behavior
In-Reply-To: <1285168977.46.0.728141650864.issue9921@psf.upfronthosting.co.za>
Message-ID: <E1QZvBW-0006Xa-KM@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 1e89444f4ebc by R David Murray in branch '2.7':
#9921: clarify os.path.join joining algorithm
http://hg.python.org/cpython/rev/1e89444f4ebc

New changeset f5f5b715be7e by R David Murray in branch '3.2':
#9921: clarify os.path.join joining algorithm
http://hg.python.org/cpython/rev/f5f5b715be7e

New changeset b6759568b812 by R David Murray in branch 'default':
merge #9921: clarify os.path.join joining algorithm
http://hg.python.org/cpython/rev/b6759568b812

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

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

From report at bugs.python.org  Fri Jun 24 03:28:22 2011
From: report at bugs.python.org (R. David Murray)
Date: Fri, 24 Jun 2011 01:28:22 +0000
Subject: [docs] [issue9921] os.path.join('x','') behavior
In-Reply-To: <1285168977.46.0.728141650864.issue9921@psf.upfronthosting.co.za>
Message-ID: <1308878902.0.0.206307096986.issue9921@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Jun 24 13:25:20 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Fri, 24 Jun 2011 11:25:20 +0000
Subject: [docs] [issue12223] Datamodel documentation page: 'operator' where
	'operand'	should be
In-Reply-To: <1306834975.07.0.689179229064.issue12223@psf.upfronthosting.co.za>
Message-ID: <1308914720.63.0.670922383573.issue12223@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/issue12223>
_______________________________________

From report at bugs.python.org  Fri Jun 24 14:08:43 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 24 Jun 2011 12:08:43 +0000
Subject: [docs] [issue10403] Use "member" consistently
In-Reply-To: <1289623042.93.0.830099606418.issue10403@psf.upfronthosting.co.za>
Message-ID: <1308917323.21.0.772626450718.issue10403@psf.upfronthosting.co.za>


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

> I used "methods and attribute" in io.rst because BufferedIOBase
> included one attribute and several methods.  My terminology may be
> off, but I felt this was the correct replacement of "members."

Nearly :)  See in the first message:
> "Members and methods" should just be "attributes".

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

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

From report at bugs.python.org  Fri Jun 24 14:19:56 2011
From: report at bugs.python.org (Adam Woodbeck)
Date: Fri, 24 Jun 2011 12:19:56 +0000
Subject: [docs] [issue10403] Use "member" consistently
In-Reply-To: <1289623042.93.0.830099606418.issue10403@psf.upfronthosting.co.za>
Message-ID: <1308917995.41.0.494204888576.issue10403@psf.upfronthosting.co.za>


Adam Woodbeck <adam.woodbeck at gmail.com> added the comment:

I was always under the impression attributes and methods were mutually exclusive.  I've corrected the patch as requested.

----------
Added file: http://bugs.python.org/file22436/issue10403_v2.patch

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

From report at bugs.python.org  Fri Jun 24 15:24:03 2011
From: report at bugs.python.org (Adam Woodbeck)
Date: Fri, 24 Jun 2011 13:24:03 +0000
Subject: [docs] [issue10403] Use "member" consistently
In-Reply-To: <1289623042.93.0.830099606418.issue10403@psf.upfronthosting.co.za>
Message-ID: <1308921843.19.0.168157414902.issue10403@psf.upfronthosting.co.za>


Changes by Adam Woodbeck <adam.woodbeck at gmail.com>:


Added file: http://bugs.python.org/file22438/issue10403_v3.patch

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

From report at bugs.python.org  Fri Jun 24 21:03:57 2011
From: report at bugs.python.org (Daniel Urban)
Date: Fri, 24 Jun 2011 19:03:57 +0000
Subject: [docs] [issue12374] Execution model should explain compile vs
	definition vs	execution time
In-Reply-To: <1308582911.55.0.701954968644.issue12374@psf.upfronthosting.co.za>
Message-ID: <1308942237.87.0.939728254834.issue12374@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/issue12374>
_______________________________________

From report at bugs.python.org  Fri Jun 24 23:03:10 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 24 Jun 2011 21:03:10 +0000
Subject: [docs] [issue12354] packaging.pypi.simple docs use both client and
	crawler	variable, which might be confusing
In-Reply-To: <1308334574.8.0.60329566716.issue12354@psf.upfronthosting.co.za>
Message-ID: <1308949390.73.0.672121628675.issue12354@psf.upfronthosting.co.za>


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

Doc update in 8de5fe3b1696

----------

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

From report at bugs.python.org  Sat Jun 25 02:05:36 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Sat, 25 Jun 2011 00:05:36 +0000
Subject: [docs] [issue12374] Execution model should explain compile vs
	definition vs	execution time
In-Reply-To: <1308582911.55.0.701954968644.issue12374@psf.upfronthosting.co.za>
Message-ID: <1308960336.4.0.652912126837.issue12374@psf.upfronthosting.co.za>


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

I presume we are discussing Chapter 4. Execution model. I do not see any mention there of the difference between function definition and body execution time. The section of def statements (7.6) has this: "The function definition does not execute the function body; this gets executed only when the function is called. [3]". This is true for lambda expressions also, but nothing is said there. This may contribute to people expecting name resolution of non-parameters in lambda bodies to happen at lambda expression == function definition time rather than later at function call time (what Nick called function execution time).

I think 4.1. Naming and binding should be slightly expanded and renamed 4.1. Name binding and resolution. People need to understand both how and when associations are made and when they are used (as well as what scopes are used). Not understanding this results in the perennial confusion about params with defaults and free names in lambda expressions.

In function headers, param = expr creates a binding when the header is executed, which is when the function object is created. It is stored in the function object. It may optionally be used when the function is called.

In lambda bodies such as in lambda x: x + i, there is no binding of i so i must be bound in a surrounding context either before the function is defined or before the function is called, depending on the surrounding contex, and used when the function is called.

These two facts are somehow not clear enough at present. In any case, my point is the the 'when' part of name binding and use is related to the when of execution.

The relevance of compilation time is more subtle. It is when module, statement, and function code objects are created, including by compile(). If code objects (and compile) are part of the language, then so is compile time. The existence of both interactive statement execution and delayed module execution also has implications for how Python works and how it can and cannot be modified. I am not sure how much to say, though.

Part of the execution model of Python is that, leaving aside i/o, the effect of executing statements is to change user visible name and slot bindings. There are essentially no declarations for changing invisible compiler/interpreter settings.

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

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

From report at bugs.python.org  Sat Jun 25 02:28:37 2011
From: report at bugs.python.org (Nick Coghlan)
Date: Sat, 25 Jun 2011 00:28:37 +0000
Subject: [docs] [issue12374] Execution model should explain compile vs
	definition vs	execution time
In-Reply-To: <1308582911.55.0.701954968644.issue12374@psf.upfronthosting.co.za>
Message-ID: <1308961717.22.0.539342039803.issue12374@psf.upfronthosting.co.za>


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

Most of my thoughts on this topic can be found at http://svn.python.org/view/sandbox/trunk/userref/ODF/ (that was written ~2.5, so some parts of it are a little dated, but the Essential Concepts section is still fairly accurate).

The most relevant part to the current discussion is 1.5:

1.5 Classes and Functions are Defined at Runtime
In static language such as Java or C++, function and class definitions are essentially directives to the language compiler regarding the nature of certain identifiers. While class and function definition statements still have implications for the compilation stage in Python, these definitions are also first class statements that are executed at runtime, just like any other statement. While the code within the function or class definition statement is compiled at compile time, the actual definition of the function or class does not occur until the statement is executed at runtime.
In top level code, this distinction usually doesn't matter, but it has some significant implications when class and function definitions are placed inside a function. Doing so means that a new class or a new function is defined every time the containing function is executed. This means that not only is it possible to have factory functions that create new class instances (as is common in all object-oriented languages), but it is also possible to have factory functions that create new classes or new functions. Another key feature of nested functions is that they employ lexical scoping, allowing nested functions to see identifiers defined in outer scopes.

----------

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

From report at bugs.python.org  Sat Jun 25 02:32:09 2011
From: report at bugs.python.org (Nick Coghlan)
Date: Sat, 25 Jun 2011 00:32:09 +0000
Subject: [docs] [issue12374] Execution model should explain compile vs
	definition vs	execution time
In-Reply-To: <1308582911.55.0.701954968644.issue12374@psf.upfronthosting.co.za>
Message-ID: <1308961929.27.0.494373911788.issue12374@psf.upfronthosting.co.za>


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

The other directly relevant part is in section 5:

5.1.3 Evaluating Default Arguments
In static languages such as C, function definitions are instructions to the compiler rather than executable statements. This leads to such languages making distinctions between events that occur at run-time and at compile time. In Python, function definitions are statements in their own right, so run-time events related to functions are further divided into events that occur at definition time and at execution time. Definition time refers to the point where the function is defined by the def statement. Execution time refers to the point where the function is called and the body of the function is executed.
Where these distinctions matter the most is in the evaluation of default arguments, as this occurs only once at the time the function is defined. For immutable default values like numbers or the constant value None, this doesn't have any perceptible effect. For mutable defaults like lists and dictionaries, however, it makes a significant difference, as it means a single instance of the object is created at definition time, and is then shared across all invocations of the function that use the default argument value. This can result in unintended side effects. The typical approach to handling this situation is to use None as the default argument, and include code in the body of the function to create the appropriate default value when the parameter is set to None. The following listing shows the difference between the two mechanisms.
[Grab the ODF file if you want to see the code listing]

----------

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

From report at bugs.python.org  Sat Jun 25 07:11:47 2011
From: report at bugs.python.org (R. David Murray)
Date: Sat, 25 Jun 2011 05:11:47 +0000
Subject: [docs] [issue12374] Execution model should explain compile vs
	definition vs	execution time
In-Reply-To: <1308582911.55.0.701954968644.issue12374@psf.upfronthosting.co.za>
Message-ID: <1308978707.12.0.0404889796885.issue12374@psf.upfronthosting.co.za>


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

My understanding is that the language reference is a purposefully minimalist document that specifies the language (insofar as anything other than the CPython implementation does so).  So while better explanations of the implications of the language design are a good thing, they don't necessarily belong in the language reference.  (I'm not saying they don't, I'm just repeating what the intro says: "this is not a tutorial".)  In particular I am suspicious that statements that begin "in languages such as ..." don't belong in the language reference as it is currently written.

----------

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

From report at bugs.python.org  Sat Jun 25 10:11:53 2011
From: report at bugs.python.org (Nick Coghlan)
Date: Sat, 25 Jun 2011 08:11:53 +0000
Subject: [docs] [issue12374] Execution model should explain compile vs
	definition vs	execution time
In-Reply-To: <1308582911.55.0.701954968644.issue12374@psf.upfronthosting.co.za>
Message-ID: <1308989513.39.0.485061098401.issue12374@psf.upfronthosting.co.za>


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

Oh, agreed - the quotes above are from the "Python's User Reference" I wrote several years back, but never got around to converting from ODF and subsequently updating and publishing in a more accessible way.

It was designed to fill the gap that exists in the documentation between the tutorial (which gives usage information, but doesn't really explain how things work) and the language reference (which is a fairly minimalist spec that doesn't explain design intent or rationale very much). The associated publishing deal fell through so I got the copyrights back and donated the whole thing to the PSF.

However, the first step in making it more useful is extracting the text from the ODF files into reStructuredText and that's never made it to the top of my to-do list.

The ideal situation from my point of view would be for someone on doc-sig to help with the conversion process, but I've never had any takers (although I'll grant that the last time I asked was a number of years ago).

----------

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

From report at bugs.python.org  Sat Jun 25 11:00:20 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 25 Jun 2011 09:00:20 +0000
Subject: [docs] [issue12164] str.translate docstring doesn't mention that
	'table' can	be None
In-Reply-To: <1306214084.99.0.386690557918.issue12164@psf.upfronthosting.co.za>
Message-ID: <E1QaOiw-0006ML-Sc@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 60b3a5615c4e by Mark Dickinson in branch '2.7':
Issue #12164: Document (in docstring) that str.translate accepts None for the first argument.
http://hg.python.org/cpython/rev/60b3a5615c4e

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

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

From report at bugs.python.org  Sat Jun 25 11:01:09 2011
From: report at bugs.python.org (Mark Dickinson)
Date: Sat, 25 Jun 2011 09:01:09 +0000
Subject: [docs] [issue12164] str.translate docstring doesn't mention that
	'table' can	be None
In-Reply-To: <1306214084.99.0.386690557918.issue12164@psf.upfronthosting.co.za>
Message-ID: <1308992469.0.0.127426284518.issue12164@psf.upfronthosting.co.za>


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


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

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

From sandro.tosi at gmail.com  Sat Jun 25 11:14:13 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Sat, 25 Jun 2011 11:14:13 +0200
Subject: [docs] Translation Project
In-Reply-To: <5AD4B4E7B0A24E2CB11E51E3FCB1A090@ShawServer>
References: <5AD4B4E7B0A24E2CB11E51E3FCB1A090@ShawServer>
Message-ID: <BANLkTimNy-Ub3pSr7tjjE92tKazLxfa_zg@mail.gmail.com>

Hi Alex,

2011/6/8 ?? Alex Liu <hhdxlx at gmail.com>:
> Hello there:
>
> I come from China, I want to translate the Python Documentation to Chinese.
> I don't have any experience, so can you give me any suggest. Thank you so
> much!
>
> I?ve hosted this project on googlecode, and translated several html files. I
> saw it?s quite a big project, and googlecode can't manage it well, and
> translate html files is not so reusability and hard to manage.
>
> How do you cooperate to write the Documentation? You can help me.

there's discussion in progress about translating documentation tools
and procedures. Follow this ml and you'll get a notice when we're
ready :)

Oh, thanks for your effort!

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  Sat Jun 25 11:20:54 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Sat, 25 Jun 2011 11:20:54 +0200
Subject: [docs] I found misdescription
In-Reply-To: <BANLkTimuV+oc4WaLJ_FkAkAqwQTT0V=s2g@mail.gmail.com>
References: <BANLkTimuV+oc4WaLJ_FkAkAqwQTT0V=s2g@mail.gmail.com>
Message-ID: <BANLkTimR_=PaDC+3XawbxhoGppkw8FdEhg@mail.gmail.com>

Hi Hiro,
thanks for your email.

On Tue, May 31, 2011 at 10:31, kk6 <kekelo1603 at gmail.com> wrote:
> Above the example's line3 and line6, "d.keys" is lack of parentheses
> of callable.
> It raise TypeError in this case to carry along.

i'm just getting Raymond to fix it ;)

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  Sat Jun 25 11:25:52 2011
From: report at bugs.python.org (Mark Dickinson)
Date: Sat, 25 Jun 2011 09:25:52 +0000
Subject: [docs] [issue12245] Document the meaning of FLT_ROUNDS constants
	for	sys.float_info
In-Reply-To: <1307044030.93.0.176037757521.issue12245@psf.upfronthosting.co.za>
Message-ID: <1308993952.55.0.306232862125.issue12245@psf.upfronthosting.co.za>


Mark Dickinson <dickinsm at gmail.com> added the comment:

> all it does is give information about the FPU settings at the time that
> Python was compiled

Hmm.  It's actually a bit better than that:  as far as I can tell, it reflects the value of FLT_ROUNDS at the time that Python is started (when the sys module is initialized).  OTOH, FLT_ROUNDS on my machine is #define'd to be 1, in violation of the C standards.

----------

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

From report at bugs.python.org  Sat Jun 25 11:34:26 2011
From: report at bugs.python.org (Mark Dickinson)
Date: Sat, 25 Jun 2011 09:34:26 +0000
Subject: [docs] [issue12245] Document the meaning of FLT_ROUNDS constants
	for	sys.float_info
In-Reply-To: <1307044030.93.0.176037757521.issue12245@psf.upfronthosting.co.za>
Message-ID: <1308994466.29.0.519603232986.issue12245@psf.upfronthosting.co.za>


Mark Dickinson <dickinsm at gmail.com> added the comment:

Patch that elaborates a bit on the meaning of sys.float_info.rounds.

----------
keywords: +patch
Added file: http://bugs.python.org/file22454/issue12245.patch

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

From sandro.tosi at gmail.com  Sat Jun 25 11:50:18 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Sat, 25 Jun 2011 11:50:18 +0200
Subject: [docs] Suggest tempfile module in os.tmpfile documentation
In-Reply-To: <2CE1903A72CC464B8FB0FB71566B6FA232A025@nikita.huiberts.local>
References: <AcwgM6ox4XmHxuy/SsuMykAeBGYUHQ==>
	<2CE1903A72CC464B8FB0FB71566B6FA232A025@nikita.huiberts.local>
Message-ID: <BANLkTi=yCdW9aok15FgemFXObbqR5JRCMw@mail.gmail.com>

Hello Jelle,

On Wed, Jun 1, 2011 at 10:12, Jelle Verstraaten <jelle at benext.eu> wrote:
> I recently found myself in need of a temporary file and ran into the
> os.tmpfile function. After some more research[1] I found out that using this
> file isn?t recommended, but no mention is made of the tempfile
> module.

The link at [1] is missing, and there is actually a `tempfile`
reference at the top of the os module (I'm supposing your referring to
2.x version, am I correct). Would you find much more useful to have an
explicit link near os.tmpfile() ?

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  Sat Jun 25 12:03:00 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 25 Jun 2011 10:03:00 +0000
Subject: [docs] [issue12228] Stat doc - fix swap of UF_OPAQUE and
	UF_NOUNLINK	description
In-Reply-To: <1306864902.26.0.858229152162.issue12228@psf.upfronthosting.co.za>
Message-ID: <E1QaPha-0001OU-Rl@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset d912dfb7ab7a by Mark Dickinson in branch '2.7':
Issue #12228: Fix exchanged flag descriptions in stat.rst.  Thanks Sandro Tosi.
http://hg.python.org/cpython/rev/d912dfb7ab7a

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

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

From report at bugs.python.org  Sat Jun 25 12:05:35 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 25 Jun 2011 10:05:35 +0000
Subject: [docs] [issue12228] Stat doc - fix swap of UF_OPAQUE and
	UF_NOUNLINK	description
In-Reply-To: <1306864902.26.0.858229152162.issue12228@psf.upfronthosting.co.za>
Message-ID: <E1QaPk6-0001cx-96@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 03c8de42c206 by Mark Dickinson in branch '3.1':
Issue #12228: Fix exchanged flag descriptions in stat.rst.  Thanks Sandro Tosi.
http://hg.python.org/cpython/rev/03c8de42c206

New changeset 4a3e528b6b11 by Mark Dickinson in branch '3.2':
Merge #12228
http://hg.python.org/cpython/rev/4a3e528b6b11

New changeset 6c6ee4eb27f8 by Mark Dickinson in branch 'default':
Merge #12228
http://hg.python.org/cpython/rev/6c6ee4eb27f8

----------

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

From report at bugs.python.org  Sat Jun 25 12:07:02 2011
From: report at bugs.python.org (Mark Dickinson)
Date: Sat, 25 Jun 2011 10:07:02 +0000
Subject: [docs] [issue12228] Stat doc - fix swap of UF_OPAQUE and
	UF_NOUNLINK	description
In-Reply-To: <1306864902.26.0.858229152162.issue12228@psf.upfronthosting.co.za>
Message-ID: <1308996422.18.0.645848402573.issue12228@psf.upfronthosting.co.za>


Mark Dickinson <dickinsm at gmail.com> added the comment:

Thanks for the patch!

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

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

From report at bugs.python.org  Sat Jun 25 13:22:01 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Sat, 25 Jun 2011 11:22:01 +0000
Subject: [docs] [issue10583] Encoding issue with chm help in 2.7.1
In-Reply-To: <1291060108.22.0.631034667944.issue10583@psf.upfronthosting.co.za>
Message-ID: <1309000921.43.0.352183232687.issue10583@psf.upfronthosting.co.za>


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

Hello, can you still replicate it with 2.7.2 ?

----------
nosy: +sandro.tosi

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

From report at bugs.python.org  Sat Jun 25 14:38:58 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Sat, 25 Jun 2011 12:38:58 +0000
Subject: [docs] [issue11163] iter() documentation code doesn't work
In-Reply-To: <1297284045.4.0.795458647498.issue11163@psf.upfronthosting.co.za>
Message-ID: <1309005538.02.0.543346836936.issue11163@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/issue11163>
_______________________________________

From report at bugs.python.org  Sat Jun 25 14:48:59 2011
From: report at bugs.python.org (Kristian Vlaardingerbroek)
Date: Sat, 25 Jun 2011 12:48:59 +0000
Subject: [docs] [issue10020] docs for sqlite3 describe functions not
	available	without recompiling
In-Reply-To: <1286124753.24.0.309036392806.issue10020@psf.upfronthosting.co.za>
Message-ID: <1309006139.5.0.464635371552.issue10020@psf.upfronthosting.co.za>


Kristian Vlaardingerbroek <kristian.vlaardingerbroek at gmail.com> added the comment:

Attached patch for Python 2.7. 

Since Issue10268 has not been applied to Python 2.7 the sentence "you must modify setup.py and and remove the line that sets SQLITE_OMIT_LOAD_EXTENSION" still applies.

----------
keywords: +patch
nosy: +Kristian.Vlaardingerbroek
Added file: http://bugs.python.org/file22458/issue10020-python27.patch

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

From report at bugs.python.org  Sat Jun 25 15:01:08 2011
From: report at bugs.python.org (Kristian Vlaardingerbroek)
Date: Sat, 25 Jun 2011 13:01:08 +0000
Subject: [docs] [issue10583] Encoding issue with chm help in 2.7.1
In-Reply-To: <1291060108.22.0.631034667944.issue10583@psf.upfronthosting.co.za>
Message-ID: <1309006868.15.0.0452553603566.issue10583@psf.upfronthosting.co.za>


Kristian Vlaardingerbroek <kristian.vlaardingerbroek at gmail.com> added the comment:

I can reproduce the issue with Python 2.7.2 and Python 3.2 on Windows 7 Enterprise SP 1 64-bit.

----------
nosy: +Kristian.Vlaardingerbroek

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

From report at bugs.python.org  Sat Jun 25 15:08:12 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Sat, 25 Jun 2011 13:08:12 +0000
Subject: [docs] [issue10583] Encoding issue with chm help in 2.7.1
In-Reply-To: <1291060108.22.0.631034667944.issue10583@psf.upfronthosting.co.za>
Message-ID: <1309007292.87.0.107864677184.issue10583@psf.upfronthosting.co.za>


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

Adding Georg to nosy, he might now how CHM is generated on Windows and shine some light here

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

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

From report at bugs.python.org  Sat Jun 25 15:24:40 2011
From: report at bugs.python.org (Kristian Vlaardingerbroek)
Date: Sat, 25 Jun 2011 13:24:40 +0000
Subject: [docs] [issue10583] Encoding issue with chm help in 2.7.1
In-Reply-To: <1291060108.22.0.631034667944.issue10583@psf.upfronthosting.co.za>
Message-ID: <1309008280.42.0.418407002727.issue10583@psf.upfronthosting.co.za>


Kristian Vlaardingerbroek <kristian.vlaardingerbroek at gmail.com> added the comment:

I've looked at the output from make html and make htmlhelp and taking the library/json.html as example the text between <title> </title> is exactly the same.

Chrome renders both fine:

<title>18.2. json ? JSON encoder and decoder &mdash; Python v2.7.2 documentation</title>

But when looking at the file in the HTML Help Workshop it looks like this:

 <title>18.2. json ??? JSON encoder and decoder</title>

Which is what you see when doing the search.

----------

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

From report at bugs.python.org  Sat Jun 25 15:36:08 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Sat, 25 Jun 2011 13:36:08 +0000
Subject: [docs] [issue12409] Moving "Documenting Python" to Devguide
In-Reply-To: <1309008968.0.0.644952507743.issue12409@psf.upfronthosting.co.za>
Message-ID: <1309008968.0.0.644952507743.issue12409@psf.upfronthosting.co.za>


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

Hi! We have the devguide now, and it should be the place where to look for references and docs about contributing to Python, that means also for the documentation.

In the official Python doc we have a section "Documenting Python" (http://docs.python.org/py3k/documenting/index.html) and I think it should be merged into the devguide - what's your opinion on that?

----------
assignee: docs at python
components: Documentation
messages: 139062
nosy: brett.cannon, docs at python, ezio.melotti, georg.brandl, sandro.tosi
priority: normal
severity: normal
status: open
title: Moving "Documenting Python" to Devguide

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

From report at bugs.python.org  Sat Jun 25 15:38:14 2011
From: report at bugs.python.org (Kristian Vlaardingerbroek)
Date: Sat, 25 Jun 2011 13:38:14 +0000
Subject: [docs] [issue10583] Encoding issue with chm help in 2.7.1
In-Reply-To: <1291060108.22.0.631034667944.issue10583@psf.upfronthosting.co.za>
Message-ID: <1309009094.76.0.558289084952.issue10583@psf.upfronthosting.co.za>


Kristian Vlaardingerbroek <kristian.vlaardingerbroek at gmail.com> added the comment:

This might be non-fixable:

http://support.microsoft.com/kb/269766/

HTML Help 1.x does not compile the Unicode characters. Meaning that in the search and index views you'll get garbage. For the rest of the rendering IE is used which does render the correct characters.

There is support in HTML Help 2.x but as far as I can see that is only available as a component in Visual Studio and not included with a default Windows installation.

----------

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

From report at bugs.python.org  Sat Jun 25 16:08:41 2011
From: report at bugs.python.org (Kristian Vlaardingerbroek)
Date: Sat, 25 Jun 2011 14:08:41 +0000
Subject: [docs] [issue10020] docs for sqlite3 describe functions not
	available	without recompiling
In-Reply-To: <1286124753.24.0.309036392806.issue10020@psf.upfronthosting.co.za>
Message-ID: <1309010921.52.0.436320413086.issue10020@psf.upfronthosting.co.za>


Changes by Kristian Vlaardingerbroek <kristian.vlaardingerbroek at gmail.com>:


Removed file: http://bugs.python.org/file22458/issue10020-python27.patch

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

From report at bugs.python.org  Sat Jun 25 16:09:05 2011
From: report at bugs.python.org (Kristian Vlaardingerbroek)
Date: Sat, 25 Jun 2011 14:09:05 +0000
Subject: [docs] [issue10020] docs for sqlite3 describe functions not
	available	without recompiling
In-Reply-To: <1286124753.24.0.309036392806.issue10020@psf.upfronthosting.co.za>
Message-ID: <1309010945.83.0.670447322063.issue10020@psf.upfronthosting.co.za>


Kristian Vlaardingerbroek <kristian.vlaardingerbroek at gmail.com> added the comment:

Fixed typo (double and).

----------
Added file: http://bugs.python.org/file22464/issue10020-python27.patch

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

From report at bugs.python.org  Sat Jun 25 16:28:23 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 25 Jun 2011 14:28:23 +0000
Subject: [docs] [issue12086] Tutorial doesn't discourage name mangling
In-Reply-To: <1305534944.68.0.723553568142.issue12086@psf.upfronthosting.co.za>
Message-ID: <E1QaTqP-0000AS-Sj@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 68bc3c5960a4 by Raymond Hettinger in branch '2.7':
Issue 12086: add example showing how to use name mangling.
http://hg.python.org/cpython/rev/68bc3c5960a4

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

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

From report at bugs.python.org  Sat Jun 25 16:31:23 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 25 Jun 2011 14:31:23 +0000
Subject: [docs] [issue12086] Tutorial doesn't discourage name mangling
In-Reply-To: <1305534944.68.0.723553568142.issue12086@psf.upfronthosting.co.za>
Message-ID: <E1QaTtJ-0000Pt-TG@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 79f9698777b7 by Raymond Hettinger in branch '3.2':
Issue 12086: add example showing how to use name mangling.
http://hg.python.org/cpython/rev/79f9698777b7

New changeset fca745bc70be by Raymond Hettinger in branch 'default':
Issue 12086: add example showing how to use name mangling.
http://hg.python.org/cpython/rev/fca745bc70be

----------

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

From report at bugs.python.org  Sat Jun 25 16:35:49 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Sat, 25 Jun 2011 14:35:49 +0000
Subject: [docs] [issue12086] Tutorial doesn't discourage name mangling
In-Reply-To: <1305534944.68.0.723553568142.issue12086@psf.upfronthosting.co.za>
Message-ID: <1309012548.94.0.100642481215.issue12086@psf.upfronthosting.co.za>


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

Added an example of how to use double underscores correctly.  

I agree with Ezio that the rest of the documentation is clear on the subject.

----------
resolution:  -> rejected
status: open -> closed

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

From report at bugs.python.org  Sat Jun 25 16:43:29 2011
From: report at bugs.python.org (R. David Murray)
Date: Sat, 25 Jun 2011 14:43:29 +0000
Subject: [docs] [issue12403] Mention sys.displayhook in code module docs and
	the	compile builtin docs
In-Reply-To: <1308959744.93.0.261089879651.issue12403@psf.upfronthosting.co.za>
Message-ID: <1309013009.33.0.57885083201.issue12403@psf.upfronthosting.co.za>


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

Well, the code is being executed by an exec call on a code object that was compiled with the 'single' flag, which is what causes non-None values to get "printed".  The compile docs aren't clear on how "printed" is implemented, but the answer is that it calls sys.displayhook.  So the way to control that part of the output is to assign your own function to sys.displayhook.  None of this is documented, and it should be (it took me a while to figure it out, and I had a suspicions about how it worked), so I'm changing this to a documentation bug.

However, you mention in the other ticket that are trying to do the interactive interpreter trick through a socket.  For that application I think you want to ignore both the write method and sys.displayhook, and instead directly patch sys.stdout and sys.stderr. Otherwise you'd also miss output sent to those destinations via print statements or writing directly to the sys objects, which would confuse the user of your interface since the in the normal interactive prompt those show up on the console.

----------
assignee:  -> docs at python
components: +Documentation
nosy: +docs at python, r.david.murray
stage:  -> needs patch
title: Allow overriding of writing to stdout in code.InteractiveConsole -> Mention sys.displayhook in code module docs and the compile builtin docs
type: feature request -> behavior
versions: +Python 3.1

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

From report at bugs.python.org  Sat Jun 25 16:52:58 2011
From: report at bugs.python.org (Miki Tebeka)
Date: Sat, 25 Jun 2011 14:52:58 +0000
Subject: [docs] [issue12403] Mention sys.displayhook in code module docs and
	the	compile builtin docs
In-Reply-To: <1308959744.93.0.261089879651.issue12403@psf.upfronthosting.co.za>
Message-ID: <1309013578.32.0.380609652381.issue12403@psf.upfronthosting.co.za>


Miki Tebeka <miki.tebeka at gmail.com> added the comment:

Yeah, I though about using dup2 from stdout/stderr to the socket. However this means I can connect only one client at a time. Which was an issue I was trying to avoid. Didn't think about print statements though ...

Thanks.

----------

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

From report at bugs.python.org  Sat Jun 25 17:15:10 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Sat, 25 Jun 2011 15:15:10 +0000
Subject: [docs] [issue11233] clarifying Availability: Unix
In-Reply-To: <1297969399.53.0.187875867799.issue11233@psf.upfronthosting.co.za>
Message-ID: <1309014910.13.0.232452248612.issue11233@psf.upfronthosting.co.za>


Changes by Sandro Tosi <sandro.tosi at gmail.com>:


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

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

From report at bugs.python.org  Sat Jun 25 18:05:24 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Sat, 25 Jun 2011 16:05:24 +0000
Subject: [docs] [issue11669] Clarify Lang Ref "Compound statements" footnote
In-Reply-To: <1301042574.67.0.975748752077.issue11669@psf.upfronthosting.co.za>
Message-ID: <1309017924.91.0.553348245756.issue11669@psf.upfronthosting.co.za>


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

Just to make explicit what's happening:


>>> try:
...     try:
...         raise TypeError()
...     finally:
...         raise ValueError()
... except TypeError as e:
...     print('mmm')
... 
Traceback (most recent call last):
  File "<stdin>", line 3, in <module>
TypeError

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "<stdin>", line 5, in <module>
ValueError

while


>>> try:
...     try:
...         raise TypeError()
...     finally:
...         raise ValueError()
... except ValueError as e:
...     print ('mmm')
... 
mmm

----------
nosy: +sandro.tosi

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

From report at bugs.python.org  Sat Jun 25 18:05:54 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Sat, 25 Jun 2011 16:05:54 +0000
Subject: [docs] [issue11669] Clarify Lang Ref "Compound statements" footnote
In-Reply-To: <1301042574.67.0.975748752077.issue11669@psf.upfronthosting.co.za>
Message-ID: <1309017954.46.0.308974663786.issue11669@psf.upfronthosting.co.za>


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

Ok, I send it too soon... attached is a patch to fix this bug (it applies on default, 3.2 and 2.7).

----------

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

From report at bugs.python.org  Sat Jun 25 18:06:18 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Sat, 25 Jun 2011 16:06:18 +0000
Subject: [docs] [issue11669] Clarify Lang Ref "Compound statements" footnote
In-Reply-To: <1301042574.67.0.975748752077.issue11669@psf.upfronthosting.co.za>
Message-ID: <1309017978.89.0.711497234686.issue11669@psf.upfronthosting.co.za>


Changes by Sandro Tosi <sandro.tosi at gmail.com>:


----------
keywords:  -needs review
Added file: http://bugs.python.org/file22471/issue11669-default.patch

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

From report at bugs.python.org  Sat Jun 25 18:19:25 2011
From: report at bugs.python.org (R. David Murray)
Date: Sat, 25 Jun 2011 16:19:25 +0000
Subject: [docs] [issue12374] Execution model should explain compile vs
	definition vs	execution time
In-Reply-To: <1308582911.55.0.701954968644.issue12374@psf.upfronthosting.co.za>
Message-ID: <1309018765.69.0.294689091113.issue12374@psf.upfronthosting.co.za>


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

You could try the mentors list or Doug Hellman's volunteer group, too.

----------

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

From report at bugs.python.org  Sat Jun 25 18:23:21 2011
From: report at bugs.python.org (R. David Murray)
Date: Sat, 25 Jun 2011 16:23:21 +0000
Subject: [docs] [issue12403] Mention sys.displayhook in code module docs and
	the	compile builtin docs
In-Reply-To: <1308959744.93.0.261089879651.issue12403@psf.upfronthosting.co.za>
Message-ID: <1309019001.11.0.366260847336.issue12403@psf.upfronthosting.co.za>


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

Well, sys.stdout and sys.stderr don't have to be real file objects.  You could substitute a file-like object (one that implements the methods that get called during the interpretation loop) that does your multiplexing.  That kind of trick is one of the things that makes Python so much fun to work with :)

----------

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

From report at bugs.python.org  Sat Jun 25 19:16:20 2011
From: report at bugs.python.org (Fred L. Drake, Jr.)
Date: Sat, 25 Jun 2011 17:16:20 +0000
Subject: [docs] [issue12409] Moving "Documenting Python" to Devguide
In-Reply-To: <1309008968.0.0.644952507743.issue12409@psf.upfronthosting.co.za>
Message-ID: <BANLkTi=PVUrEKHD4ri2XAUSd3a_cfxs6xA@mail.gmail.com>


Fred L. Drake, Jr. <fdrake at acm.org> added the comment:

-1

> Hi! We have the devguide now, and it should be the place where to look
> for references and docs about contributing to Python, that means also
> for the documentation.

For information specific to the Python documentation itself, but not
relevant to users documenting their own projects, yes.

> In the official Python doc we have a section "Documenting Python"
> (http://docs.python.org/py3k/documenting/index.html) and I think it
> should be merged into the devguide - what's your opinion on that?

The scope of this document is much larger than Python's documentation,
but extends to all projects written in Python that use Sphinx as their
documentation tool.  With that, it makes sense to keep it as part of
the documentation for users of Python.

----------
nosy: +fdrake

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

From report at bugs.python.org  Sat Jun 25 22:10:12 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Sat, 25 Jun 2011 20:10:12 +0000
Subject: [docs] [issue10020] docs for sqlite3 describe functions not
	available	without recompiling
In-Reply-To: <1286124753.24.0.309036392806.issue10020@psf.upfronthosting.co.za>
Message-ID: <1309032612.77.0.364525742244.issue10020@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/issue10020>
_______________________________________

From report at bugs.python.org  Sat Jun 25 22:53:25 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Sat, 25 Jun 2011 20:53:25 +0000
Subject: [docs] [issue12409] Moving "Documenting Python" to Devguide
In-Reply-To: <1309008968.0.0.644952507743.issue12409@psf.upfronthosting.co.za>
Message-ID: <1309035205.73.0.306835457711.issue12409@psf.upfronthosting.co.za>


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

Hi Fred, thanks for your input! Let's see what others think, but I think that at the very least, the "Building the documentation" section (that seams very specific to python) should be moved into the devguide.

----------

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

From report at bugs.python.org  Sun Jun 26 00:19:26 2011
From: report at bugs.python.org (Michael Grazebrook)
Date: Sat, 25 Jun 2011 22:19:26 +0000
Subject: [docs] [issue11163] iter() documentation code doesn't work
In-Reply-To: <1309005538.02.0.543346836936.issue11163@psf.upfronthosting.co.za>
Message-ID: <4E065EEB.3070200@grazebrook.com>


Michael Grazebrook <michael at grazebrook.com> added the comment:

Thank you.

On 25/06/2011 13:38, Raymond Hettinger wrote:
> 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/issue11163>
> _______________________________________
>
>
> -----
> No virus found in this message.
> Checked by AVG - www.avg.com
> Version: 10.0.1388 / Virus Database: 1513/3725 - Release Date: 06/25/11
>
>
>

----------

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

From report at bugs.python.org  Sun Jun 26 05:42:31 2011
From: report at bugs.python.org (R. David Murray)
Date: Sun, 26 Jun 2011 03:42:31 +0000
Subject: [docs] [issue11233] clarifying Availability: Unix
In-Reply-To: <1297969399.53.0.187875867799.issue11233@psf.upfronthosting.co.za>
Message-ID: <1309059751.05.0.3390162036.issue11233@psf.upfronthosting.co.za>


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

In another issue Georg came up with the idea of creating an availability directive that would auto link to the appropriate text.  This would then apply to all our different availability types.

----------

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

From report at bugs.python.org  Sun Jun 26 05:48:44 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 26 Jun 2011 03:48:44 +0000
Subject: [docs] [issue10020] docs for sqlite3 describe functions not
	available	without recompiling
In-Reply-To: <1286124753.24.0.309036392806.issue10020@psf.upfronthosting.co.za>
Message-ID: <E1QagKw-0004wq-LJ@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 804a60029091 by Senthil Kumaran in branch '2.7':
Fix Issue10020 - Doc update to sqlite3 module in 2.7 branch.
http://hg.python.org/cpython/rev/804a60029091

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

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

From report at bugs.python.org  Sun Jun 26 06:03:26 2011
From: report at bugs.python.org (Senthil Kumaran)
Date: Sun, 26 Jun 2011 04:03:26 +0000
Subject: [docs] [issue10020] docs for sqlite3 describe functions not
	available	without recompiling
In-Reply-To: <1286124753.24.0.309036392806.issue10020@psf.upfronthosting.co.za>
Message-ID: <1309061006.61.0.979555062341.issue10020@psf.upfronthosting.co.za>


Senthil Kumaran <senthil at uthcode.com> added the comment:

Fixed in branch 2.7. Thanks Kristan. Eric, the documentation patch does not apply to 3.1 because those functions are not present in 3.1.

----------
nosy: +orsenthil
status: open -> closed

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

From report at bugs.python.org  Sun Jun 26 07:46:26 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Sun, 26 Jun 2011 05:46:26 +0000
Subject: [docs] [issue12409] Moving "Documenting Python" to Devguide
In-Reply-To: <1309008968.0.0.644952507743.issue12409@psf.upfronthosting.co.za>
Message-ID: <1309067186.51.0.314980763707.issue12409@psf.upfronthosting.co.za>


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

I agree with Fred.

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

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

From report at bugs.python.org  Sun Jun 26 08:29:38 2011
From: report at bugs.python.org (Philip Olson)
Date: Sun, 26 Jun 2011 06:29:38 +0000
Subject: [docs] [issue12415] Missing: How to checkout the Doc sources
In-Reply-To: <1309069778.19.0.06342861361.issue12415@psf.upfronthosting.co.za>
Message-ID: <1309069778.19.0.06342861361.issue12415@psf.upfronthosting.co.za>


New submission from Philip Olson <philip at roshambo.org>:

I was unable to determine how to download the Python documentation source files (for building via Sphinx) but did figure out the following:

   hg clone http://hg.python.org/cpython
   cd cpython/Doc
   make html

Where to get the Doc sources deserves a mention here:

   http://docs.python.org/dev/documenting/building.html

I don't know this topic so won't propose a patch, but building.txt should mention where/how to get 'Doc' before the 'cd Doc' example.

----------
assignee: docs at python
components: Documentation
messages: 139147
nosy: docs at python, philip
priority: normal
severity: normal
status: open
title: Missing: How to checkout the Doc sources

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

From report at bugs.python.org  Sun Jun 26 09:07:57 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Sun, 26 Jun 2011 07:07:57 +0000
Subject: [docs] [issue12415] Missing: How to checkout the Doc sources
In-Reply-To: <1309069778.19.0.06342861361.issue12415@psf.upfronthosting.co.za>
Message-ID: <1309072077.43.0.944275144061.issue12415@psf.upfronthosting.co.za>


Changes by Sandro Tosi <sandro.tosi at gmail.com>:


----------
nosy: +sandro.tosi

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

From report at bugs.python.org  Sun Jun 26 09:49:27 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Sun, 26 Jun 2011 07:49:27 +0000
Subject: [docs] [issue12211] Better document math.copysign behavior.
In-Reply-To: <1306710150.53.0.509116993934.issue12211@psf.upfronthosting.co.za>
Message-ID: <1309074567.02.0.116391635937.issue12211@psf.upfronthosting.co.za>


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

Taken from http://www.slac.stanford.edu/comp/unix/package/rtems/doc/html/libm/libm.info.copysign.html i'd suggest to extend

  Return a float with the magnitude of x

to

  Return a float with the magnitude (absolute value) of x

It could probably help people less math-savvy in understand what's going to happen :)

Maybe also (only in rest doc) might be nice to describe what happens in case the arguments are NaN, f.e.:

>>> import math
>>> x = float('nan')
>>> math.copysign(1., x)
1.0
>>> math.copysign(-1., x)
1.0
>>> math.copysign(x, -1)
nan
>>> math.copysign(x, x)
nan

umedoblock: would you like to expand the patch with these notes (unless someone objects :)).

----------
nosy: +sandro.tosi
stage: needs patch -> patch review

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

From report at bugs.python.org  Sun Jun 26 09:51:44 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Sun, 26 Jun 2011 07:51:44 +0000
Subject: [docs] [issue12277] Missing comma in os.walk docs
In-Reply-To: <1307439951.32.0.810805209718.issue12277@psf.upfronthosting.co.za>
Message-ID: <1309074704.3.0.631623841575.issue12277@psf.upfronthosting.co.za>


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

Marking the issue as pending (inferred from ?ric msg): ?ric, will this be in your July big-push? :)

----------
nosy: +sandro.tosi
resolution:  -> accepted
stage:  -> commit review
status: open -> pending

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

From report at bugs.python.org  Sun Jun 26 10:06:29 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Sun, 26 Jun 2011 08:06:29 +0000
Subject: [docs] [issue12160] codecs doc: what is StreamCodec?
In-Reply-To: <1306166137.72.0.066960808058.issue12160@psf.upfronthosting.co.za>
Message-ID: <1309075589.25.0.309824099863.issue12160@psf.upfronthosting.co.za>


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

Hi Victor, would you update the patch?

----------
nosy: +sandro.tosi

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

From report at bugs.python.org  Sun Jun 26 10:38:39 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 26 Jun 2011 08:38:39 +0000
Subject: [docs] [issue11669] Clarify Lang Ref "Compound statements" footnote
In-Reply-To: <1301042574.67.0.975748752077.issue11669@psf.upfronthosting.co.za>
Message-ID: <E1QakrW-0004ys-0A@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset b11e7bc76d07 by Ezio Melotti in branch '2.7':
#11669: rephrase footnote in the Compound Statements page.
http://hg.python.org/cpython/rev/b11e7bc76d07

New changeset 74e9f94d8440 by Ezio Melotti in branch '3.2':
#11669: rephrase footnote in the Compound Statements page.
http://hg.python.org/cpython/rev/74e9f94d8440

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

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

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

From report at bugs.python.org  Sun Jun 26 10:41:24 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Sun, 26 Jun 2011 08:41:24 +0000
Subject: [docs] [issue11669] Clarify Lang Ref "Compound statements" footnote
In-Reply-To: <1301042574.67.0.975748752077.issue11669@psf.upfronthosting.co.za>
Message-ID: <1309077684.05.0.632114031676.issue11669@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: patch review -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Sun Jun 26 10:52:03 2011
From: report at bugs.python.org (umedoblock)
Date: Sun, 26 Jun 2011 08:52:03 +0000
Subject: [docs] [issue12211] Better document math.copysign behavior.
In-Reply-To: <1306710150.53.0.509116993934.issue12211@psf.upfronthosting.co.za>
Message-ID: <1309078323.06.0.0797735945469.issue12211@psf.upfronthosting.co.za>


umedoblock <umedoblock at gmail.com> added the comment:

sandro: OK, I attached the new patch.

----------
Added file: http://bugs.python.org/file22480/issue_12211_2.patch

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

From report at bugs.python.org  Sun Jun 26 11:58:15 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Sun, 26 Jun 2011 09:58:15 +0000
Subject: [docs] [issue11363] Curses - add missing functions to doc
In-Reply-To: <1299005402.55.0.443028099437.issue11363@psf.upfronthosting.co.za>
Message-ID: <1309082294.72.0.828928009972.issue11363@psf.upfronthosting.co.za>


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

As requested by Ezio, I'm attaching a "pre-patch" to bring curses doc a bit more adherent to current standards like by s/Returns/Return/ , ``True`` instead of true and so on. It applies ok on 3.3 and 3.2, on 2.7 a hunk is failing (but Ezio said it's fine this way :)).

After this patch is applies, the previous one (to add missing functs) can be applied.

----------
nosy: +ezio.melotti
versions:  -Python 3.1
Added file: http://bugs.python.org/file22481/curses_doc_update.diff

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

From report at bugs.python.org  Sun Jun 26 12:13:05 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Sun, 26 Jun 2011 10:13:05 +0000
Subject: [docs] [issue11363] Curses - add missing functions to doc
In-Reply-To: <1299005402.55.0.443028099437.issue11363@psf.upfronthosting.co.za>
Message-ID: <1309083185.0.0.537595441589.issue11363@psf.upfronthosting.co.za>


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

Still following Ezio suggestion, I've reworked a bit the original patch, attaching its -v2 .

----------
Added file: http://bugs.python.org/file22482/curses_missing_functs-py3k-v2.patch

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

From report at bugs.python.org  Sun Jun 26 12:39:58 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 26 Jun 2011 10:39:58 +0000
Subject: [docs] [issue11363] Curses - add missing functions to doc
In-Reply-To: <1299005402.55.0.443028099437.issue11363@psf.upfronthosting.co.za>
Message-ID: <E1Qamku-0003NE-Cg@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 3eb9c31a0b03 by Ezio Melotti in branch '2.7':
#11363: clean up curses doc.
http://hg.python.org/cpython/rev/3eb9c31a0b03

New changeset 3dc602b1f4a2 by Ezio Melotti in branch '2.7':
#11363: add missing functions from curses doc. Patch by Sandro Tosi.
http://hg.python.org/cpython/rev/3dc602b1f4a2

New changeset bb27baa1124a by Ezio Melotti in branch '3.2':
#11363: clean up curses doc.
http://hg.python.org/cpython/rev/bb27baa1124a

New changeset f852e2d556af by Ezio Melotti in branch '3.2':
#11363: add missing functions from curses doc. Patch by Sandro Tosi.
http://hg.python.org/cpython/rev/f852e2d556af

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

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

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

From report at bugs.python.org  Sun Jun 26 12:41:52 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Sun, 26 Jun 2011 10:41:52 +0000
Subject: [docs] [issue11363] Curses - add missing functions to doc
In-Reply-To: <1299005402.55.0.443028099437.issue11363@psf.upfronthosting.co.za>
Message-ID: <1309084911.96.0.526066102287.issue11363@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/issue11363>
_______________________________________

From report at bugs.python.org  Sun Jun 26 12:44:59 2011
From: report at bugs.python.org (Mark Mc Mahon)
Date: Sun, 26 Jun 2011 10:44:59 +0000
Subject: [docs] [issue11253] autodocument first appearance of
	ctypes.wintypes	constants
In-Reply-To: <1298182426.14.0.687578094658.issue11253@psf.upfronthosting.co.za>
Message-ID: <1309085099.01.0.47716243119.issue11253@psf.upfronthosting.co.za>


Mark Mc Mahon <mtnbikingmark at gmail.com> added the comment:

This mostly a documentation concern - correct? ctypes.wintypes is sparsely documented - in 2.7 the help for it seems to be:
"The ctypes.wintypes module provides quite some other Windows specific data types, for example HWND, WPARAM, or DWORD. Some useful structures like MSG or RECT are also defined."

How about the following solution:
First of all get the previous release information
 - hg log / hg revert / import wintypes / dir(wintypes)

Future changes have to be updated manually (which probably is not a big deal as it is a reasonably stable module)

In fact I went and got the revision when each attribute was added... (some of those are just ctypes leakage)
{36899: ['ARRAY',                   'MSG',
         'ArgumentError',           'OLESTR',
         'Array',                   'OleDLL',
         'BOOL',                    'POINT',
         'BYTE',                    'POINTER',
         'BigEndianStructure',      'POINTL',
         'DEFAULT_MODE',            'PYFUNCTYPE',
         'DWORD',                   'PyDLL',
         'FILETIME',                'RECT',
         'FormatError',             'RECTL',
         'GetLastError',            'RGB',
         'HANDLE',                  'RTLD_GLOBAL',
         'HDC',                     'RTLD_LOCAL',
         'HGDIOBJ',                 'SIZE',
         'HINSTANCE',               'SIZEL',
         'HKEY',                    'SetPointerType',
         'HMENU',                   'Structure',
         'HMODULE',                 'ULARGE_INTEGER',
         'HPEN',                    'ULONG',
         'HRESULT',                 'Union',
         'HRGN',                    'VARIANT_BOOL',
         'HTASK',                   'WIN32_FIND_DATAA',
         'HWND',                    'WIN32_FIND_DATAW',
         'LARGE_INTEGER',           'WINFUNCTYPE',
         'LCID',                    'WORD',
         'LONG',                    'WPARAM',
         'LPARAM',                  'WinDLL',
         'LPCOLESTR',               'WinError',
         'LPCSTR',                  'alignment',
         'LPCWSTR',                 'get_errno',
         'LPOLESTR',                'get_last_error',
         'LPSTR',                   'resize',
         'LPWSTR',                  'set_conversion_mode',
         'LibraryLoader',           'set_errno',
         'LittleEndianStructure',   'set_last_error',
         'MAX_PATH',]

 38788: ['ATOM',                     'HRSRC',
         'BOOLEAN',                  'HSTR',
         'COLORREF',                 'HWINSTA',
         'HACCEL',                   'LANGID',
         'HBITMAP',                  'LCTYPE',
         'HBRUSH',                   'LGRPID',
         'HCOLORSPACE',              'SC_HANDLE',
         'HDESK',                    'SERVICE_STATUS_HANDLE',
         'HDWP',                     'SMALL_RECT',
         'HENHMETAFILE',             '_COORD',
         'HFONT',                    '_FILETIME',
         'HGLOBAL',                  '_POINTL',
         'HHOOK',                    '_RECTL',
         'HICON',                    '_SMALL_RECT',
         'HKL',                      'tagMSG',
         'HLOCAL',                   'tagPOINT',
         'HMETAFILE',                'tagRECT',
         'HMONITOR',                 'tagSIZE',
         'HPALETTE',]

 38830: ['DOUBLE',
         'UINT',
         'WCHAR',
         '_LARGE_INTEGER',
         '_SimpleCData',
         '_ULARGE_INTEGER',
         '__all__'],

 48320: ['FLOAT',
         'INT',
         'LPCVOID',
         'LPVOID',
         'SHORT',
         'USHORT']}

48320 -> 2.7?
38830 -> 2.5?
38788 -> 2.5?
36899 -> 2.4?

So we need a doc patch? Should we update the older 'What's new in Python 2.x' for added attribs?

----------
nosy: +markm

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

From report at bugs.python.org  Sun Jun 26 14:44:27 2011
From: report at bugs.python.org (Dave King)
Date: Sun, 26 Jun 2011 12:44:27 +0000
Subject: [docs] [issue8890] Use tempfile instead of /tmp in examples
In-Reply-To: <1275599514.93.0.639768129715.issue8890@psf.upfronthosting.co.za>
Message-ID: <1309092267.12.0.79365824984.issue8890@psf.upfronthosting.co.za>


Dave King <dave at davbo.org> added the comment:

Spotted another use of /tmp/ in the logging howto. Attached a diff.

----------
nosy: +davbo
Added file: http://bugs.python.org/file22483/tmp_logging_howto.diff

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

From report at bugs.python.org  Sun Jun 26 15:29:44 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 26 Jun 2011 13:29:44 +0000
Subject: [docs] [issue8890] Use tempfile instead of /tmp in examples
In-Reply-To: <1275599514.93.0.639768129715.issue8890@psf.upfronthosting.co.za>
Message-ID: <E1QapPC-0005pD-Ri@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 1ed71544fceb by Raymond Hettinger in branch '3.2':
Issue #8890: Remove /tmp from examples.
http://hg.python.org/cpython/rev/1ed71544fceb

New changeset fcf242243d46 by Raymond Hettinger in branch 'default':
Issue #8890: Remove /tmp from examples.
http://hg.python.org/cpython/rev/fcf242243d46

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

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

From report at bugs.python.org  Sun Jun 26 15:30:07 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Sun, 26 Jun 2011 13:30:07 +0000
Subject: [docs] [issue8890] Use tempfile instead of /tmp in examples
In-Reply-To: <1275599514.93.0.639768129715.issue8890@psf.upfronthosting.co.za>
Message-ID: <1309095007.6.0.994880478286.issue8890@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sun Jun 26 16:30:38 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Sun, 26 Jun 2011 14:30:38 +0000
Subject: [docs] [issue12211] Better document math.copysign behavior.
In-Reply-To: <1306710150.53.0.509116993934.issue12211@psf.upfronthosting.co.za>
Message-ID: <1309098638.12.0.874891731282.issue12211@psf.upfronthosting.co.za>


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

well, what I actually meant is to describe the behavior in case one (or both) of the arguments is NaN (so not cut&pasting the code), while the example was just provided as a quick reference.

----------

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

From report at bugs.python.org  Sun Jun 26 16:41:51 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Sun, 26 Jun 2011 14:41:51 +0000
Subject: [docs] [issue12134] json.dump much slower than dumps
In-Reply-To: <1305985086.83.0.259963774289.issue12134@psf.upfronthosting.co.za>
Message-ID: <1309099311.34.0.582273765684.issue12134@psf.upfronthosting.co.za>


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

As Antoine and Eric stated, the module is working as intended and we don't document implementation details and generally stay away from talking about performance in the docs.

----------
resolution:  -> rejected
status: open -> closed

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

From report at bugs.python.org  Sun Jun 26 16:51:19 2011
From: report at bugs.python.org (engelbert gruber)
Date: Sun, 26 Jun 2011 14:51:19 +0000
Subject: [docs] [issue8890] Use tempfile instead of /tmp in examples
In-Reply-To: <1275599514.93.0.639768129715.issue8890@psf.upfronthosting.co.za>
Message-ID: <1309099878.82.0.400343404079.issue8890@psf.upfronthosting.co.za>


engelbert gruber <grubert at users.sourceforge.net> added the comment:

Assumption:

  /tmp is used in examples so the examples work 
  because /tmp is always writeable

module tempfile is for creating temporary files, the name of which is unimported, when a user is trying code from documentation it might be hard on him/her to additionally guess/save the random filenames.

``grep tmp -r CPython3.3/Doc`` (trimmed results and grouped)

* Doc/distutils/install.rst, Doc/install/install.rst:

  e.g. ``--install-base=/tmp`` 

  maybe ``--install-base=<other-python-base-directory>``
  if someone installs to another directory, one has a reason and 
  therefore knows the directory.

* all other e.g. ::

    Doc/library/sqlite3.rst::file:`/tmp/example` file::
    Doc/library/sqlite3.rst:   conn = sqlite3.connect('/tmp/example')

  use ``/tmp`` because it is writeable, but assuming the user wants
  to program i think it is not so big a burden to assume him/her to
  grasp the concept of directories, files and write protection.

  So either it can be left out, as in sqlite3.rst, maybe a file 
  extension would be more helpful, or replaced by a placeholder
  like ``<my-log-directory>`` or ``<directory-for-tempfiles>``.

  I am unsure about the ``<>`` chars ?

list of files:

Doc/distutils/install.rst
Doc/documenting/fromlatex.rst
Doc/howto/logging-cookbook.rst
Doc/install/install.rst
Doc/library/atexit.rst
Doc/library/cgi.rst
Doc/library/imghdr.rst
Doc/library/mailcap.rst
Doc/library/nntplib.rst
Doc/library/optparse.rst
Doc/library/packaging.database.rst
Doc/library/packaging.pypi.simple.rst
Doc/library/pipes.rst
Doc/library/sqlite3.rst
Doc/library/tempfile.rst
Doc/library/trace.rst
Doc/library/zipimport.rst
Doc/tools/sphinxext/susp-ignored.csv
Doc/tutorial/inputoutput.rst

So which way ?

----------
nosy: +grubert

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

From report at bugs.python.org  Sun Jun 26 17:12:30 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Sun, 26 Jun 2011 15:12:30 +0000
Subject: [docs] [issue11568] docstring of select.epoll.register() is wrong
In-Reply-To: <1300271962.07.0.948411199474.issue11568@psf.upfronthosting.co.za>
Message-ID: <1309101150.64.0.082995361798.issue11568@psf.upfronthosting.co.za>


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

The patch is fine: but would you be interested in trying to write a unittest for select.epoll.register ? it would be really nice to start having 'select' tested (oh no, don't ask me how to test select since I have no idea :)).

----------
nosy: +sandro.tosi
stage:  -> patch review
versions: +Python 2.7, Python 3.2, Python 3.3

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

From report at bugs.python.org  Sun Jun 26 18:54:18 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 26 Jun 2011 16:54:18 +0000
Subject: [docs] [issue12211] Better document math.copysign behavior.
In-Reply-To: <1306710150.53.0.509116993934.issue12211@psf.upfronthosting.co.za>
Message-ID: <1309107258.76.0.141486345153.issue12211@psf.upfronthosting.co.za>


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

I agree with adding '(absolute value)'. I think the following covers the NaN behavior. "NaN acts as a positive value that cannot be negated." This should be added to both doc and docstring.

I do not think we generally specify the nan behavior for each function, but it usually follows general rules. The copysign(x,nan) behavior is not obvious as nan, like int 0, does not really have a sign. One might expect copysign(-1.0,nan) to be -1.

----------

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

From report at bugs.python.org  Sun Jun 26 20:01:05 2011
From: report at bugs.python.org (flashk)
Date: Sun, 26 Jun 2011 18:01:05 +0000
Subject: [docs] [issue10583] Encoding issue with chm help in 2.7.1
In-Reply-To: <1291060108.22.0.631034667944.issue10583@psf.upfronthosting.co.za>
Message-ID: <1309111265.0.0.441360347435.issue10583@psf.upfronthosting.co.za>


flashk <flashk at gmail.com> added the comment:

Yes, I still notice this issue with the 2.7.2 release.

As I mentioned earlier, I did not notice this problem with 2.7. Were there any significant changes to the docs between 2.7 and 2.7.1?

Considering the bug with HTML Help pointed out by Kristian, I'm thinking there was either a change in the html encoding or the build environment for the Windows installer. Anybody aware of either of these changes happening between 2.7 and 2.7.1?

----------

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

From report at bugs.python.org  Sun Jun 26 20:59:24 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Sun, 26 Jun 2011 18:59:24 +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: <1309114764.58.0.036210251232.issue11726@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sun Jun 26 23:18:31 2011
From: report at bugs.python.org (Senthil Kumaran)
Date: Sun, 26 Jun 2011 21:18:31 +0000
Subject: [docs] [issue11253] autodocument first appearance of
	ctypes.wintypes	constants
In-Reply-To: <1309085099.01.0.47716243119.issue11253@psf.upfronthosting.co.za>
Message-ID: <20110626211827.GC2710@mathmagic>


Senthil Kumaran <senthil at uthcode.com> added the comment:

On Sun, Jun 26, 2011 at 10:44:59AM +0000, Mark Mc Mahon wrote:
> So we need a doc patch? Should we update the older 'What's new in
> Python 2.x' for added attribs?

The Documentation patch may be applied only 2.7 and 3.2/3.3 releases
now. What's new is updated for the upcoming release only.

So, if documenting those constants will help in 2.7.x and 3.2.x and
3.3, it would be helpful to provide patches against those lines and it
can be applied. As you said, the future version can be updated, but we
cannot go back with updating the documentation of the already released
versions.

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

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

From report at bugs.python.org  Mon Jun 27 08:50:03 2011
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 27 Jun 2011 06:50:03 +0000
Subject: [docs] [issue11568] docstring of select.epoll.register() is wrong
In-Reply-To: <1300271962.07.0.948411199474.issue11568@psf.upfronthosting.co.za>
Message-ID: <E1Qb5dx-0004Mf-Ez@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 0610f70e6694 by Senthil Kumaran in branch '3.2':
Fix closes issue 11568 - update select.epoll.register docstring with mention of correct behavior.
http://hg.python.org/cpython/rev/0610f70e6694

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

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

From report at bugs.python.org  Mon Jun 27 08:51:25 2011
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 27 Jun 2011 06:51:25 +0000
Subject: [docs] [issue11568] docstring of select.epoll.register() is wrong
In-Reply-To: <1300271962.07.0.948411199474.issue11568@psf.upfronthosting.co.za>
Message-ID: <E1Qb5fH-0004Y0-NN@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset a6586cb660dc by Senthil Kumaran in branch '2.7':
Fix closes issue 11568 - update select.epoll.register docstring with mention of correct behavior.
http://hg.python.org/cpython/rev/a6586cb660dc

----------

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

From report at bugs.python.org  Mon Jun 27 08:54:04 2011
From: report at bugs.python.org (Senthil Kumaran)
Date: Mon, 27 Jun 2011 06:54:04 +0000
Subject: [docs] [issue11568] docstring of select.epoll.register() is wrong
In-Reply-To: <1309101150.64.0.082995361798.issue11568@psf.upfronthosting.co.za>
Message-ID: <20110627065359.GA14974@mathmagic>


Senthil Kumaran <senthil at uthcode.com> added the comment:

On Sun, Jun 26, 2011 at 03:12:30PM +0000, Sandro Tosi wrote:
> The patch is fine: but would you be interested in trying to write a
> unittest for select.epoll.register ? it would be really nice to

This is covered in test_epoll.py

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

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

From report at bugs.python.org  Mon Jun 27 09:14:33 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Mon, 27 Jun 2011 07:14:33 +0000
Subject: [docs] [issue11568] docstring of select.epoll.register() is wrong
In-Reply-To: <1300271962.07.0.948411199474.issue11568@psf.upfronthosting.co.za>
Message-ID: <1309158873.7.0.388539057429.issue11568@psf.upfronthosting.co.za>


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

Ah, I find the test file name a bit unhappy (why not test select.epoll in test_select? or add select in the filename?) but since it's covered - I'm fine! :) Next time I'll grep instead of simple file glob - thanks for your help, Senthil.

----------

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

From report at bugs.python.org  Mon Jun 27 16:44:30 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 27 Jun 2011 14:44:30 +0000
Subject: [docs] [issue10020] docs for sqlite3 describe functions not
	available	without recompiling
In-Reply-To: <1286124753.24.0.309036392806.issue10020@psf.upfronthosting.co.za>
Message-ID: <1309185870.12.0.314978112514.issue10020@psf.upfronthosting.co.za>


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

I just noticed that the blocks in reST should use three-space indent, not two.

----------

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

From report at bugs.python.org  Mon Jun 27 17:44:30 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 27 Jun 2011 15:44:30 +0000
Subject: [docs] [issue8617] Better document user site-packages in site
	module doc
In-Reply-To: <1273017080.78.0.24275979751.issue8617@psf.upfronthosting.co.za>
Message-ID: <1309189470.96.0.241421406386.issue8617@psf.upfronthosting.co.za>


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


----------
keywords: +patch
Added file: http://bugs.python.org/file22498/pep370-doc.diff

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

From report at bugs.python.org  Mon Jun 27 17:45:08 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 27 Jun 2011 15:45:08 +0000
Subject: [docs] [issue8617] Better document user site-packages in site
	module doc
In-Reply-To: <1273017080.78.0.24275979751.issue8617@psf.upfronthosting.co.za>
Message-ID: <1309189508.24.0.40330268137.issue8617@psf.upfronthosting.co.za>


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


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

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

From cocoatomo77 at gmail.com  Sun Jun 19 01:51:35 2011
From: cocoatomo77 at gmail.com (tomo cocoa)
Date: Sun, 19 Jun 2011 08:51:35 +0900
Subject: [docs] undocumented classes in library/urllib2.rst
Message-ID: <BANLkTinEJKCnQR6UPNBUpL9bRBK-K263EA@mail.gmail.com>

Hello,

I am Japanese Pythonista and translating Python documents into Japanese.

I found undocumented classes in library/urllib2.rst,
  - HTTPErrorProcessor
  - AbstractHTTPHandler.

The AbstractHTTPHandler may be undocumented
because this class is abstract and used only for implementation of
common methods in its subclasses.

However, I do not realize why the class HTTPErrorProcessor is undocumented.

Regards.

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

From cocoatomo77 at gmail.com  Sun Jun 19 02:16:13 2011
From: cocoatomo77 at gmail.com (tomo cocoa)
Date: Sun, 19 Jun 2011 09:16:13 +0900
Subject: [docs] undocumented classes in library/urllib2.rst
In-Reply-To: <BANLkTinEJKCnQR6UPNBUpL9bRBK-K263EA@mail.gmail.com>
References: <BANLkTinEJKCnQR6UPNBUpL9bRBK-K263EA@mail.gmail.com>
Message-ID: <BANLkTime-yRKgzgewgg52gHkY7BX9NTEeg@mail.gmail.com>

Hello,

I am @cocoatomo.

Sorry for my bad explanation.

> However, I do not realize why the class HTTPErrorProcessor is undocumented.

This means I wonder why the class HTTPErrorProcessor is undocumented as a class
just after where the class UnknownHandler is documented.

My expectation:

(urllib2.rst)

.. class:: UnknownHandler()

   A catch-all class to handle unknown URLs.

+ .. class:: HTTPErrorProcessor()
+
+    # explanation of HTTPErrorProcessor...

(/urllib2.rst)

Regards.

On 19 June 2011 08:51, tomo cocoa <cocoatomo77 at gmail.com> wrote:
> Hello,
>
> I am Japanese Pythonista and translating Python documents into Japanese.
>
> I found undocumented classes in library/urllib2.rst,
> ?- HTTPErrorProcessor
> ?- AbstractHTTPHandler.
>
> The AbstractHTTPHandler may be undocumented
> because this class is abstract and used only for implementation of
> common methods in its subclasses.
>
> However, I do not realize why the class HTTPErrorProcessor is undocumented.
>
> Regards.
>
> --
> class Cocoatomo:
> ? ? name = 'cocoatomo'
> ? ? email_address = 'cocoatomo77 at gmail.com'
> ? ? twitter_id = '@cocoatomo'
>



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

From alyona.lompar at consultant.com  Tue Jun 21 09:29:27 2011
From: alyona.lompar at consultant.com (Alyona Lompar)
Date: Tue, 21 Jun 2011 10:29:27 +0300
Subject: [docs] 'Programming FAQ &mdash;
	Python v2.7.2 documentation' international
Message-ID: <4E004857.3080308@consultant.com>

Hi!

I'm willing to translate page located at 
http://docs.python.org/faq/programming.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. 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.

You can leave a voice message and I will call you back, if you prefer a 
call instead of emails. Do you prefer email or IM for contact (if any 
questions regarding the translation arise)? What instant messaging 
client (if any) do you use? AIM, MSN, Skype?
Thank you!

Sincerely,
Alyona Lompar
+(360) 488-0303

---
This e-mail, including attachments, may include confidential and/or 
proprietary information, and may be used only by the person or entity to 
which it is addressed. If the reader of this e-mail is not the intended 
recipient or his or her authorized agent, the reader is hereby notified 
that any dissemination, distribution or copying of this e-mail is 
prohibited. If you have received this e-mail in error, please notify the 
sender by replying to this message and delete this e-mail immediately.

From remcoj at xs4all.nl  Sun Jun 26 02:40:31 2011
From: remcoj at xs4all.nl (Remco Janssen)
Date: Sun, 26 Jun 2011 08:40:31 +0800
Subject: [docs] Broken link in Python 2.7.2 Tutorial
Message-ID: <201106260840.31807.remcoj@xs4all.nl>

Dear Madam, Sir,

It seems the 'next' links on top and bottom of the '1. Whetting Your Appetite' 
page in the Python Tutorial (http://docs.python.org/tutorial/appetite.html) 
are broken.

Probably this was introduced during modifications made on June 25th, because I 
didn't encounter this problem before those modifications.

Best regards,
Remco Janssen

From kb1pkl at aim.com  Sun Jun 26 21:23:57 2011
From: kb1pkl at aim.com (Corey Richardson)
Date: Sun, 26 Jun 2011 15:23:57 -0400
Subject: [docs] Default value for optional parameters unexpected
	behaviour?
In-Reply-To: <A2.62.09596.320870E4@hrndva-omtalb.mail.rr.com>
References: <2a25a54a-c60b-4811-9c6a-97c7f717dccb@hd10g2000vbb.googlegroups.com>
	<BANLkTik3UP6j0z=+Ywq6LnTmKyhx_1mtrQ@mail.gmail.com>
	<A2.62.09596.320870E4@hrndva-omtalb.mail.rr.com>
Message-ID: <1309115633-sup-5735@dalek>

Excerpts from Thomas L. Shinnick's message of Sun Jun 26 14:53:21 -0400 2011:
> See reference manual section 7.6  "Function definitions" under the 
> discussion subtitle "Default parameter values are evaluated when the 
> function definition is executed. "
>          http://docs.python.org/reference/compound_stmts.html#function-definitions
> 
> Yes, this is discussed in many places and many times, but why isn't 
> it in the Python FAQ?  Amazing, yes?
> 

Well, to be fair, I don't think most people actually read the FAQ.
The FAQ does say:

"Default arguments can be used to determine values once, at compile
time instead of at run time. This can only be done for functions or
objects which will not be changed during program execution..."

And he did modify the list during program execution. However this
isn't exactly forthright if you aren't looking for it / know what
you're reading.  I don't think it should be spilled out in detail but
maybe a "there are some tricks involved with mutable default
arguments (for example a list).  Refer to the language reference
(LINK) for more details" would be useful.

But I'm not really certain that would make much of a difference.
I'll Cc this to docs at python.org.
-- 
Corey Richardson
  "Those who deny freedom to others, deserve it not for themselves"
     -- Abraham Lincoln
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 490 bytes
Desc: not available
URL: <http://mail.python.org/pipermail/docs/attachments/20110626/8f496358/attachment-0001.pgp>

From report at bugs.python.org  Mon Jun 27 17:54:46 2011
From: report at bugs.python.org (Senthil Kumaran)
Date: Mon, 27 Jun 2011 15:54:46 +0000
Subject: [docs] [issue10020] docs for sqlite3 describe functions not
	available	without recompiling
In-Reply-To: <1286124753.24.0.309036392806.issue10020@psf.upfronthosting.co.za>
Message-ID: <1309190086.87.0.763631164349.issue10020@psf.upfronthosting.co.za>


Senthil Kumaran <senthil at uthcode.com> added the comment:

Eric, you mean for the whole of sqlite3 docmentation or the part in the footnote?

----------

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

From report at bugs.python.org  Mon Jun 27 17:58:32 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 27 Jun 2011 15:58:32 +0000
Subject: [docs] [issue10020] docs for sqlite3 describe functions not
	available	without recompiling
In-Reply-To: <1286124753.24.0.309036392806.issue10020@psf.upfronthosting.co.za>
Message-ID: <1309190312.72.0.0963947939619.issue10020@psf.upfronthosting.co.za>


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

I mean in the two commits.  I can check the whole file later (and also use automatic reST footnotes, [#] instead of [#fn1]).

----------

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

From report at bugs.python.org  Mon Jun 27 18:07:26 2011
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 27 Jun 2011 16:07:26 +0000
Subject: [docs] [issue12385] the help for bytearray.maketrans
	describes	bytes.maketrans
In-Reply-To: <1308699300.81.0.100519829981.issue12385@psf.upfronthosting.co.za>
Message-ID: <E1QbELN-0003Y7-2p@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset 586745894ab8 by Senthil Kumaran in branch '3.2':
Fix closes Issue12385 - Clarify maketrans method docstring for bytes and bytearray object.
http://hg.python.org/cpython/rev/586745894ab8

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

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

From report at bugs.python.org  Mon Jun 27 18:22:06 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Mon, 27 Jun 2011 16:22:06 +0000
Subject: [docs] [issue12043] Update shutil documentation
In-Reply-To: <1304967545.46.0.442679433989.issue12043@psf.upfronthosting.co.za>
Message-ID: <1309191726.43.0.850546274299.issue12043@psf.upfronthosting.co.za>


Changes by Sandro Tosi <sandro.tosi at gmail.com>:


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

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

From report at bugs.python.org  Mon Jun 27 18:23:09 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 27 Jun 2011 16:23:09 +0000
Subject: [docs] [issue12043] Update shutil documentation
In-Reply-To: <1304967545.46.0.442679433989.issue12043@psf.upfronthosting.co.za>
Message-ID: <1309191789.34.0.586083527697.issue12043@psf.upfronthosting.co.za>


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

Can you add links, a list of problems, dependency bugs or a patch?  Otherwise this is an empty placeholder.

----------

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

From report at bugs.python.org  Mon Jun 27 18:27:15 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Mon, 27 Jun 2011 16:27:15 +0000
Subject: [docs] [issue12043] Update shutil documentation
In-Reply-To: <1304967545.46.0.442679433989.issue12043@psf.upfronthosting.co.za>
Message-ID: <1309192035.28.0.796651128512.issue12043@psf.upfronthosting.co.za>


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

I'm starting to work on a patch right now.

----------

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

From report at bugs.python.org  Mon Jun 27 18:28:37 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 27 Jun 2011 16:28:37 +0000
Subject: [docs] [issue10403] Use "member" consistently
In-Reply-To: <1289623042.93.0.830099606418.issue10403@psf.upfronthosting.co.za>
Message-ID: <1309192117.55.0.126760166134.issue10403@psf.upfronthosting.co.za>


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

Alexander, could you comment on the review page about datetime.rst changes?

----------
nosy: +belopolsky

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

From report at bugs.python.org  Tue Jun 28 20:47:18 2011
From: report at bugs.python.org (Antoine Pitrou)
Date: Tue, 28 Jun 2011 18:47:18 +0000
Subject: [docs] [issue12380] bytearray methods center, ljust,
	rjust don't accept a bytearray as the fill character
In-Reply-To: <1308628210.93.0.613061897988.issue12380@psf.upfronthosting.co.za>
Message-ID: <1309286838.23.0.855181844058.issue12380@psf.upfronthosting.co.za>


Antoine Pitrou <pitrou at free.fr> added the comment:

I do agree it is a nuisance that it doesn't work with bytearray instances. After all, these methods are supposed to be homogeneous, and they are when called on a str or bytes object.

----------
assignee: docs at python -> 
stage: committed/rejected -> needs patch

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

From report at bugs.python.org  Tue Jun 28 20:47:34 2011
From: report at bugs.python.org (Antoine Pitrou)
Date: Tue, 28 Jun 2011 18:47:34 +0000
Subject: [docs] [issue12380] bytearray methods center, ljust,
	rjust don't accept a bytearray as the fill character
In-Reply-To: <1308628210.93.0.613061897988.issue12380@psf.upfronthosting.co.za>
Message-ID: <1309286854.22.0.385359407123.issue12380@psf.upfronthosting.co.za>


Changes by Antoine Pitrou <pitrou at free.fr>:


----------
components:  -Documentation

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

From report at bugs.python.org  Tue Jun 28 21:22:58 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Tue, 28 Jun 2011 19:22:58 +0000
Subject: [docs] [issue12434] Strengthen 2.7 io types warning
In-Reply-To: <1309288978.39.0.732754105333.issue12434@psf.upfronthosting.co.za>
Message-ID: <1309288978.39.0.732754105333.issue12434@psf.upfronthosting.co.za>


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

Trying 3.2 code with 2.7, I got this (greatly simplified):

from __future__ import print_function
from io import StringIO
print('hello world', file=StringIO())
Traceback...
TypeError: string argument expected, got 'str'
(StringIO.StringIO works fine, of course.)

This was initially confusing. Suggestion: after

"Note Since this module has been designed primarily for Python 3.x, you have to be aware that all uses of ?bytes? in this document refer to the str type (of which bytes is an alias), and all uses of ?text? refer to the unicode type. "
add
'String' in exception messages may also mean the unicode type."

----------
assignee: docs at python
components: Documentation
keywords: easy
messages: 139374
nosy: docs at python, terry.reedy
priority: normal
severity: normal
stage: needs patch
status: open
title: Strengthen 2.7 io types warning
versions: Python 2.7

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

From report at bugs.python.org  Wed Jun 29 01:56:35 2011
From: report at bugs.python.org (Nick Coghlan)
Date: Tue, 28 Jun 2011 23:56:35 +0000
Subject: [docs] [issue12436] Provide reference to detailed installation
	instructions
In-Reply-To: <1309305395.29.0.101516779086.issue12436@psf.upfronthosting.co.za>
Message-ID: <1309305395.29.0.101516779086.issue12436@psf.upfronthosting.co.za>


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

The Boston Python Workshop folks have some detailed step-by-step instructions on getting Python up and running ([1]).

Given that this can be a pain point for new users (primarily on Windows), it may be good to reference these instructions from the official docs. (Alternatively, we could use them as the basis for a "HOWTO" in the official docs and update release.py to adjust the relevant links. That's a lot more work than just adding a link, though)

[1] http://openhatch.org/wiki/Boston_Python_Workshop_3/Friday

----------
assignee: docs at python
components: Documentation
messages: 139381
nosy: docs at python, ncoghlan
priority: normal
severity: normal
status: open
title: Provide reference to detailed installation instructions

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

From report at bugs.python.org  Wed Jun 29 07:04:08 2011
From: report at bugs.python.org (Antoine Pitrou)
Date: Wed, 29 Jun 2011 05:04:08 +0000
Subject: [docs] [issue10403] Use "member" consistently
In-Reply-To: <1289623042.93.0.830099606418.issue10403@psf.upfronthosting.co.za>
Message-ID: <1309323848.2.0.716545465495.issue10403@psf.upfronthosting.co.za>


Antoine Pitrou <pitrou at free.fr> added the comment:

So I'm -1 on using "attributes" to denote methods. It will actively confuse non-expert users. If you want to ditch "members", please consider using the more explicit phrase "attributes and methods".

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

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

From report at bugs.python.org  Wed Jun 29 07:18:51 2011
From: report at bugs.python.org (Senthil Kumaran)
Date: Wed, 29 Jun 2011 05:18:51 +0000
Subject: [docs] [issue10403] Use "member" consistently
In-Reply-To: <1309323848.2.0.716545465495.issue10403@psf.upfronthosting.co.za>
Message-ID: <20110629051845.GA2273@mathmagic>


Senthil Kumaran <senthil at uthcode.com> added the comment:

Yes, I agree with you. Good Suggestion. Thanks!

----------

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

From report at bugs.python.org  Wed Jun 29 17:14:34 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 29 Jun 2011 15:14:34 +0000
Subject: [docs] [issue10403] Use "member" consistently
In-Reply-To: <1289623042.93.0.830099606418.issue10403@psf.upfronthosting.co.za>
Message-ID: <1309360474.72.0.0298678267985.issue10403@psf.upfronthosting.co.za>


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

I?m not -1 on using ?attributes? to denote methods, since they *are* and it?s not difficult to understand, and I?m not opposed either to using ?attributes? to replace ?members? (i.e. attributes that are not methods.)

For those wanting to see the raging debate: http://mail.python.org/pipermail/python-dev/2011-June/112020.html

:)

----------

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

From report at bugs.python.org  Wed Jun 29 17:17:28 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 29 Jun 2011 15:17:28 +0000
Subject: [docs] [issue11363] Curses - add missing functions to doc
In-Reply-To: <1299005402.55.0.443028099437.issue11363@psf.upfronthosting.co.za>
Message-ID: <1309360648.41.0.335982129958.issue11363@psf.upfronthosting.co.za>


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

A typo slipped into the 3.2 commit: x``'\033[6;4H'``

In addition, I tried the example in my shell and got a bytes/str error; that?s probably another report.

----------
nosy: +eric.araujo
status: closed -> open

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

From report at bugs.python.org  Wed Jun 29 20:16:18 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Wed, 29 Jun 2011 18:16:18 +0000
Subject: [docs] [issue11363] Curses - add missing functions to doc
In-Reply-To: <1299005402.55.0.443028099437.issue11363@psf.upfronthosting.co.za>
Message-ID: <1309371378.73.0.530577563764.issue11363@psf.upfronthosting.co.za>


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

I think the same typo is also on default (since merged from 3.2): Ezio, do you want me to upload a patch or you'll fix it?

?ric: I can see the tparm() example is failing, since tgetstr() is returning bytes while it expects a string: did you already file about about it? want me to?

----------

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