From report at bugs.python.org  Sat Jul  2 14:49:01 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Sat, 02 Jul 2011 12:49:01 +0000
Subject: [docs] [issue12409] Moving "Documenting Python" to Devguide
In-Reply-To: <1309008968.0.0.644952507743.issue12409@psf.upfronthosting.co.za>
Message-ID: <1309610941.25.0.0533545929005.issue12409@psf.upfronthosting.co.za>


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

I don?t understand Fred?s replies.

> 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.
Really?  docs.python.org/documenting is much smaller that sphinx.pocoo.org, and only seems to cover documenting Python, not any Python project.

> With that, it makes sense to keep it as part of the documentation for
> users of Python.
I don?t follow.  You?re saying that since the document also covers other projects than Python, it makes sense to include it in the Python docs?

IMO, the criterion for the devguide is to have version-independent documents in one place instead of needlessly including them with CPython and having to sync across versions.  For the Documenting Python docs, if they contain version-specific instructions, or if they contain instructions needed in a CPython tarball, then they?re in the right place, otherwise they could move to the devguide.

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

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

From report at bugs.python.org  Sat Jul  2 16:01:16 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Sat, 02 Jul 2011 14:01:16 +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: <1309615276.89.0.576142434922.issue12415@psf.upfronthosting.co.za>


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

How about adding this near the top of documenting/building:

  The sources for the Python documentation are included in the
  Python repository, alongside code and tests.  Follow the
  instructions in the `Developpers' Guide`_ to get a copy of this
  repository.

  _Developpers's Guide: http://docs.python.org/devguide

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

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

From report at bugs.python.org  Sat Jul  2 16:39:18 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Sat, 02 Jul 2011 14:39: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: <1309617558.72.0.858374155442.issue11363@psf.upfronthosting.co.za>


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

Yes, the typo is also on default; I did not mention it, as the merge would have shown it :)

I did not report the bug I found; if you could test all examples for 3.x-compat and open a report, it would be great.

----------

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

From report at bugs.python.org  Sat Jul  2 22:38:13 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Sat, 02 Jul 2011 20:38:13 +0000
Subject: [docs] [issue12043] Update shutil documentation
In-Reply-To: <1304967545.46.0.442679433989.issue12043@psf.upfronthosting.co.za>
Message-ID: <1309639093.15.0.855323505553.issue12043@psf.upfronthosting.co.za>


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

It turns out it was just move() with a slightly outdated description; so I take the occasion to fix some minor stuff in the doc.

----------
keywords: +patch
stage: needs patch -> patch review
Added file: http://bugs.python.org/file22548/issue12043-default.patch

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

From report at bugs.python.org  Sat Jul  2 22:38:19 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Sat, 02 Jul 2011 20:38:19 +0000
Subject: [docs] [issue12043] Update shutil documentation
In-Reply-To: <1304967545.46.0.442679433989.issue12043@psf.upfronthosting.co.za>
Message-ID: <1309639099.08.0.249373557691.issue12043@psf.upfronthosting.co.za>


Changes by Sandro Tosi <sandro.tosi at gmail.com>:


Added file: http://bugs.python.org/file22549/issue12043-27.patch

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

From report at bugs.python.org  Sun Jul  3 07:32:11 2011
From: report at bugs.python.org (anatoly techtonik)
Date: Sun, 03 Jul 2011 05:32:11 +0000
Subject: [docs] [issue11253] autodocument first appearance of
	ctypes.wintypes	constants
In-Reply-To: <20110626211827.GC2710@mathmagic>
Message-ID: <CAPkN8x++tAJJb=DciZmoenokBu8HXiyTMr9nB6W4JiOJFXk0+w@mail.gmail.com>


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

On Mon, Jun 27, 2011 at 12:18 AM, Senthil Kumaran
<report at bugs.python.org> wrote:
> As you said, the future version can be updated, but we
> cannot go back with updating the documentation of the already released
> versions.

Why?
--
anatoly t.

----------

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

From report at bugs.python.org  Sun Jul  3 10:02:37 2011
From: report at bugs.python.org (anatoly techtonik)
Date: Sun, 03 Jul 2011 08:02:37 +0000
Subject: [docs] [issue12476] ctypes: need example how to pass raw data from
	Python
In-Reply-To: <1309680157.38.0.0819979072917.issue12476@psf.upfronthosting.co.za>
Message-ID: <1309680157.38.0.0819979072917.issue12476@psf.upfronthosting.co.za>


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

ctypes documentation lacks an example, how to pass a raw data block from Python to a C function. For example, how to pass this chunk:

data = open('somefile', 'rb').read()

to this function:

int checkBuffer(LPSTR lpData, DWORD dwBufferLength);

?

----------
assignee: docs at python
components: Documentation, ctypes
messages: 139675
nosy: docs at python, techtonik
priority: normal
severity: normal
status: open
title: ctypes: need example how to pass raw data from Python
versions: Python 2.7, Python 3.1, Python 3.2, Python 3.3, Python 3.4

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

From report at bugs.python.org  Sun Jul  3 10:52:26 2011
From: report at bugs.python.org (Amaury Forgeot d'Arc)
Date: Sun, 03 Jul 2011 08:52:26 +0000
Subject: [docs] [issue12476] ctypes: need example how to pass raw data from
	Python
In-Reply-To: <1309680157.38.0.0819979072917.issue12476@psf.upfronthosting.co.za>
Message-ID: <1309683146.37.0.285512065426.issue12476@psf.upfronthosting.co.za>


Amaury Forgeot d'Arc <amauryfa at gmail.com> added the comment:

Can you suggest a patch?

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

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

From report at bugs.python.org  Sun Jul  3 14:14:28 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Sun, 03 Jul 2011 12:14:28 +0000
Subject: [docs] [issue12478] Possible error in HTTPErrorProcessor
	documentation
In-Reply-To: <1309695268.0.0.0456155108685.issue12478@psf.upfronthosting.co.za>
Message-ID: <1309695268.0.0.0456155108685.issue12478@psf.upfronthosting.co.za>


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

Hello, I think HTTPErrorProcessor documentation at [1] contains a cut&paste error (from UnknownHandler) for the only method available

[1] http://docs.python.org/py3k/library/urllib.request.html#httperrorprocessor-objects

because:

./python -c "import urllib.request as ur; print ('unknown_open' in dir(ur.HTTPErrorProcessor))"
False

If you can confirm that http_response() should be used instead, I'll provide a patch to fix it.

----------
assignee: docs at python
components: Documentation
messages: 139685
nosy: docs at python, sandro.tosi
priority: normal
severity: normal
stage: needs patch
status: open
title: Possible error in HTTPErrorProcessor documentation
versions: Python 2.7, Python 3.2, Python 3.3

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

From report at bugs.python.org  Sun Jul  3 14:24:44 2011
From: report at bugs.python.org (anatoly techtonik)
Date: Sun, 03 Jul 2011 12:24:44 +0000
Subject: [docs] [issue12476] ctypes: need example how to pass raw data from
	Python
In-Reply-To: <1309680157.38.0.0819979072917.issue12476@psf.upfronthosting.co.za>
Message-ID: <1309695884.1.0.382537823756.issue12476@psf.upfronthosting.co.za>


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

ISTM that this code works ok.


data = open('data.raw', 'rb').read()
ret = checkBuffer(data, len(data))


You need to make sure that checkBuffer doesn't try to modify memory though. For mutable memory blocks use create_string_buffer().

----------

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

From report at bugs.python.org  Sun Jul  3 14:53:40 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Sun, 03 Jul 2011 12:53:40 +0000
Subject: [docs] [issue12479] Add HTTPErrorProcessor class definition
In-Reply-To: <1309697619.94.0.838258559522.issue12479@psf.upfronthosting.co.za>
Message-ID: <1309697619.94.0.838258559522.issue12479@psf.upfronthosting.co.za>


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

As reported in http://mail.python.org/pipermail/docs/2011-June/004879.html urllibs/urllib.request misses the definition of HTTPErrorProcessor class; the attached patches add it to the documentation.

----------
assignee: docs at python
components: Documentation
files: HTTPErrorProcessor_class-default.patch
keywords: patch
messages: 139687
nosy: docs at python, sandro.tosi
priority: normal
severity: normal
stage: patch review
status: open
title: Add HTTPErrorProcessor class definition
versions: Python 2.7, Python 3.2, Python 3.3
Added file: http://bugs.python.org/file22552/HTTPErrorProcessor_class-default.patch

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

From report at bugs.python.org  Sun Jul  3 14:53:45 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Sun, 03 Jul 2011 12:53:45 +0000
Subject: [docs] [issue12479] Add HTTPErrorProcessor class definition
In-Reply-To: <1309697619.94.0.838258559522.issue12479@psf.upfronthosting.co.za>
Message-ID: <1309697625.67.0.533432871244.issue12479@psf.upfronthosting.co.za>


Changes by Sandro Tosi <sandro.tosi at gmail.com>:


Added file: http://bugs.python.org/file22553/HTTPErrorProcessor_class-py27.patch

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

From sandro.tosi at gmail.com  Sun Jul  3 14:54:41 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Sun, 3 Jul 2011 14:54:41 +0200
Subject: [docs] undocumented classes in library/urllib2.rst
In-Reply-To: <BANLkTime-yRKgzgewgg52gHkY7BX9NTEeg@mail.gmail.com>
References: <BANLkTinEJKCnQR6UPNBUpL9bRBK-K263EA@mail.gmail.com>
	<BANLkTime-yRKgzgewgg52gHkY7BX9NTEeg@mail.gmail.com>
Message-ID: <CAPdtAj1PTV+nkJxWpjYc7ZW3QtyJy-8UjXxdPnpYiaCr=0rxkw@mail.gmail.com>

Hello Tomo,

On Sun, Jun 19, 2011 at 02:16, tomo cocoa <cocoatomo77 at gmail.com> wrote:
> 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.

i've opened http://bugs.python.org/issue12479 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  Sun Jul  3 18:11:01 2011
From: report at bugs.python.org (Philip Olson)
Date: Sun, 03 Jul 2011 16:11:01 +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: <1309709461.29.0.525708752165.issue12415@psf.upfronthosting.co.za>


Philip Olson <philip at roshambo.org> added the comment:

Thank you, that patch solves this bug report.

However, now I'm not sure which branches we should or must contribute documentation to. Python versions "2.7, 3.2, and 3.3" are now associated to this bug report, so are these the active documentation branches? How is this handled?

----------

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

From report at bugs.python.org  Sun Jul  3 19:25:10 2011
From: report at bugs.python.org (Senthil Kumaran)
Date: Sun, 03 Jul 2011 17:25:10 +0000
Subject: [docs] [issue10020] docs for sqlite3 describe functions not
	available	without recompiling
In-Reply-To: <1309190312.72.0.0963947939619.issue10020@psf.upfronthosting.co.za>
Message-ID: <20110703172505.GA3937@mathmagic>


Senthil Kumaran <senthil at uthcode.com> added the comment:

Fixed the indentation issues. We could not use automatic reST
footnotes because two links refer to same footnote, so left it as
such.

----------

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

From report at bugs.python.org  Sun Jul  3 22:10:04 2011
From: report at bugs.python.org (Senthil Kumaran)
Date: Sun, 03 Jul 2011 20:10:04 +0000
Subject: [docs] [issue11253] autodocument first appearance of
	ctypes.wintypes	constants
In-Reply-To: <CAPkN8x++tAJJb=DciZmoenokBu8HXiyTMr9nB6W4JiOJFXk0+w@mail.gmail.com>
Message-ID: <20110703200958.GC3937@mathmagic>


Senthil Kumaran <senthil at uthcode.com> added the comment:

What's new docs are usually for what is coming up new in the upcoming
releases. It is not updated once the release is done. Bug fixes and
related docs are updated in documentation.

----------

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

From report at bugs.python.org  Mon Jul  4 02:19:12 2011
From: report at bugs.python.org (Senthil Kumaran)
Date: Mon, 04 Jul 2011 00:19:12 +0000
Subject: [docs] [issue12436] Provide reference to detailed installation
	instructions
In-Reply-To: <1309305395.29.0.101516779086.issue12436@psf.upfronthosting.co.za>
Message-ID: <20110704001907.GA15716@mathmagic>


Senthil Kumaran <senthil at uthcode.com> added the comment:

I am not sure that is comprehensive enough. It is just organized into
OS specific sections and gives little details further on.
So, -1 to this, but +1 to the general idea of having detailed install
and get started documentation.

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

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

From report at bugs.python.org  Mon Jul  4 03:15:06 2011
From: report at bugs.python.org (Alejandro Santos)
Date: Mon, 04 Jul 2011 01:15:06 +0000
Subject: [docs] [issue12484] The Py_InitModule functions no longer exist,
	but remain in the docs
In-Reply-To: <1309742106.53.0.381388012939.issue12484@psf.upfronthosting.co.za>
Message-ID: <1309742106.53.0.381388012939.issue12484@psf.upfronthosting.co.za>


New submission from Alejandro Santos <alejolp at alejolp.com>:

While the "Py_InitModule" does not exists on Py3k it is still mentioned on the docs:

http://docs.python.org/py3k/extending/extending.html#keyword-parameters-for-extension-functions
http://docs.python.org/py3k/extending/windows.html#a-cookbook-approach
http://docs.python.org/py3k/faq/extending.html#what-does-systemerror-pyimport-fixupextension-module-yourmodule-not-loaded-mean

----------
assignee: docs at python
components: Documentation
messages: 139728
nosy: alejolp, docs at python
priority: normal
severity: normal
status: open
title: The Py_InitModule functions no longer exist, but remain in the docs
versions: Python 3.2

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

From report at bugs.python.org  Mon Jul  4 03:23:08 2011
From: report at bugs.python.org (Alejandro Santos)
Date: Mon, 04 Jul 2011 01:23:08 +0000
Subject: [docs] [issue12484] The Py_InitModule functions no longer exist,
	but remain in the docs
In-Reply-To: <1309742106.53.0.381388012939.issue12484@psf.upfronthosting.co.za>
Message-ID: <1309742588.43.0.045691980559.issue12484@psf.upfronthosting.co.za>


Alejandro Santos <alejolp at alejolp.com> added the comment:

The call is also present on the older 3.1 and "dev" release of the docs:

http://docs.python.org/release/3.1.3/extending/extending.html#keyword-parameters-for-extension-functions
http://docs.python.org/release/3.1.3/extending/windows.html#a-cookbook-approach
http://docs.python.org/release/3.1.3/faq/extending.html#what-does-systemerror-pyimport-fixupextension-module-yourmodule-not-loaded-mean

http://docs.python.org/dev/extending/extending.html#keyword-parameters-for-extension-functions
http://docs.python.org/dev/extending/windows.html#a-cookbook-approach
http://docs.python.org/dev/faq/extending.html#what-does-systemerror-pyimport-fixupextension-module-yourmodule-not-loaded-mean

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

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

From report at bugs.python.org  Mon Jul  4 08:36:46 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Mon, 04 Jul 2011 06:36:46 +0000
Subject: [docs] [issue12043] Update shutil documentation
In-Reply-To: <1304967545.46.0.442679433989.issue12043@psf.upfronthosting.co.za>
Message-ID: <1309761406.18.0.987252461248.issue12043@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/issue12043>
_______________________________________

From report at bugs.python.org  Mon Jul  4 08:50:21 2011
From: report at bugs.python.org (Senthil Kumaran)
Date: Mon, 04 Jul 2011 06:50:21 +0000
Subject: [docs] [issue12484] The Py_InitModule functions no longer exist,
	but remain in the docs
In-Reply-To: <1309742106.53.0.381388012939.issue12484@psf.upfronthosting.co.za>
Message-ID: <1309762221.48.0.465082724011.issue12484@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Mon Jul  4 15:52:57 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 04 Jul 2011 13:52: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: <1309787577.89.0.691906643068.issue12415@psf.upfronthosting.co.za>


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

We fix bugs in 3.2 and then forward-merge in what will become 3.3, using Mercurial.  Then we apply the same change for 2.7.  More info: http://docs.python.org/devguide

I will commit this change this week.

----------
assignee: docs at python -> eric.araujo
keywords: +patch
stage:  -> patch review

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

From report at bugs.python.org  Mon Jul  4 16:04:30 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 04 Jul 2011 14:04:30 +0000
Subject: [docs] [issue12043] Update shutil documentation
In-Reply-To: <1304967545.46.0.442679433989.issue12043@psf.upfronthosting.co.za>
Message-ID: <1309788270.64.0.32860095671.issue12043@psf.upfronthosting.co.za>


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

-   If *symlinks* is true, symbolic links in the source tree are
+   If *symlinks* is ``True``, symbolic links in the source tree are

I?m not sure about that change.  It may be on purpose that lower-case true is used, given that the code will accept anything that evaluates to True in a boolean context, but does not strictly requires a bool instance.

See also #7969 for another shutil doc bug.

----------

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

From report at bugs.python.org  Mon Jul  4 18:56:55 2011
From: report at bugs.python.org (Georg Brandl)
Date: Mon, 04 Jul 2011 16:56:55 +0000
Subject: [docs] [issue12043] Update shutil documentation
In-Reply-To: <1304967545.46.0.442679433989.issue12043@psf.upfronthosting.co.za>
Message-ID: <1309798615.5.0.606989152464.issue12043@psf.upfronthosting.co.za>


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

Yep. The parts changing true/false to ``True``/``False`` should not be committed.

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

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

From report at bugs.python.org  Mon Jul  4 19:07:21 2011
From: report at bugs.python.org (Antoine Pitrou)
Date: Mon, 04 Jul 2011 17:07:21 +0000
Subject: [docs] [issue12488] multiprocessing.Connection does not communicate
	pipe	closure between parent and child
In-Reply-To: <1309779809.62.0.10199189289.issue12488@psf.upfronthosting.co.za>
Message-ID: <1309799241.29.0.105010421715.issue12488@psf.upfronthosting.co.za>


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

Well, I think it deserves a comment in the documentation that behaviour of Pipes and Queues when one of the process terminates is undefined and implementation-dependent.

By the way, there's internal support in 3.3 to reliably detect killed children, and it's used by concurrent.futures: http://docs.python.org/dev/library/concurrent.futures.html#concurrent.futures.BrokenProcessPool. However, I'm not sure there's an easy way to detect a killed master process from one of the worker processes.

----------
assignee:  -> docs at python
components: +Documentation
nosy: +docs at python
resolution: invalid -> 
stage: committed/rejected -> needs patch
status: closed -> open
versions: +Python 3.2, Python 3.3

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

From report at bugs.python.org  Mon Jul  4 19:11:11 2011
From: report at bugs.python.org (=?utf-8?q?Charles-Fran=C3=A7ois_Natali?=)
Date: Mon, 04 Jul 2011 17:11:11 +0000
Subject: [docs] [issue12488] multiprocessing.Connection does not communicate
	pipe	closure between parent and child
In-Reply-To: <1309779809.62.0.10199189289.issue12488@psf.upfronthosting.co.za>
Message-ID: <1309799471.09.0.549711544355.issue12488@psf.upfronthosting.co.za>


Charles-Fran?ois Natali <neologix at free.fr> added the comment:

Alright.
Luke, if you're motivated, feel free to provide a patch.
The relevant file is Doc/library/multiprocessing.rst.

----------

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

From report at bugs.python.org  Mon Jul  4 19:15:14 2011
From: report at bugs.python.org (Antoine Pitrou)
Date: Mon, 04 Jul 2011 17:15:14 +0000
Subject: [docs] [issue12488] multiprocessing.Connection does not communicate
	pipe	closure between parent and child
In-Reply-To: <1309779809.62.0.10199189289.issue12488@psf.upfronthosting.co.za>
Message-ID: <1309799714.32.0.356530505043.issue12488@psf.upfronthosting.co.za>


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

By the way, if you don't want children processes to continue running when the master exits, just make them daemonic processes (by adding "daemon=True" to the Process() constructor call).

----------

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

From report at bugs.python.org  Mon Jul  4 20:44:34 2011
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 04 Jul 2011 18:44:34 +0000
Subject: [docs] [issue10403] Use "member" consistently
In-Reply-To: <1289623042.93.0.830099606418.issue10403@psf.upfronthosting.co.za>
Message-ID: <E1Qdo8F-0001HL-MT@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset d442c313536b by Senthil Kumaran in branch '3.2':
issue10403 - Let's not use members anymore. Use 'attribute' where it denotes attribute and 'methods' where it denotes methods. Context should clarify usage.
http://hg.python.org/cpython/rev/d442c313536b

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

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

From report at bugs.python.org  Mon Jul  4 20:51:18 2011
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 04 Jul 2011 18:51:18 +0000
Subject: [docs] [issue10403] Use "member" consistently
In-Reply-To: <1289623042.93.0.830099606418.issue10403@psf.upfronthosting.co.za>
Message-ID: <E1QdoEm-0002FD-Dq@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset d442c313536b by Senthil Kumaran in branch '3.2':
issue10403 - Let's not use members anymore. Use 'attribute' where it denotes attribute and 'methods' where it denotes methods. Context should clarify usage.
http://hg.python.org/cpython/rev/d442c313536b

----------

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

From report at bugs.python.org  Mon Jul  4 21:50:23 2011
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 04 Jul 2011 19:50:23 +0000
Subject: [docs] [issue10403] Use "member" consistently
In-Reply-To: <1289623042.93.0.830099606418.issue10403@psf.upfronthosting.co.za>
Message-ID: <E1Qdp9w-0006kk-SC@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset b8f5da066782 by Senthil Kumaran in branch '2.7':
Fix closes issue10403 - Let's not use members anymore.
http://hg.python.org/cpython/rev/b8f5da066782

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

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

From report at bugs.python.org  Mon Jul  4 22:42:12 2011
From: report at bugs.python.org (Rodolpho Eckhardt)
Date: Mon, 04 Jul 2011 20:42:12 +0000
Subject: [docs] [issue12490] Documentation for itertools.chain.from_iterable
	is	incorrect
In-Reply-To: <1309812132.83.0.229828200889.issue12490@psf.upfronthosting.co.za>
Message-ID: <1309812132.83.0.229828200889.issue12490@psf.upfronthosting.co.za>


New submission from Rodolpho Eckhardt <rodolpho.eckhardt at gmail.com>:

The documentation at http://docs.python.org/py3k/library/itertools.html#itertools.chain and http://docs.python.org/library/itertools.html#itertools.chain is inconsistent.

At the definition of the class it states that itertools.chain.from_iterable can receive one iterable "Gets chained inputs from a single iterable argument that is evaluated lazily.", but then it contradicts itself by using the following example:

@classmethod
def from_iterable(iterables):
    # chain.from_iterable(['ABC', 'DEF']) --> A B C D E F
    for it in iterables:
        for element in it:
            yield element

This example could lead the reader to believe this alternative constructor can receive multiple iterable objects, when in fact it can receive only one.

----------
assignee: docs at python
components: Documentation
messages: 139802
nosy: RodolphoEckhardt, docs at python
priority: normal
severity: normal
status: open
title: Documentation for itertools.chain.from_iterable is incorrect
versions: Python 2.7, Python 3.2

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

From report at bugs.python.org  Mon Jul  4 22:48:12 2011
From: report at bugs.python.org (Rodolpho Eckhardt)
Date: Mon, 04 Jul 2011 20:48:12 +0000
Subject: [docs] [issue12490] Documentation for itertools.chain.from_iterable
	is	incorrect
In-Reply-To: <1309812132.83.0.229828200889.issue12490@psf.upfronthosting.co.za>
Message-ID: <1309812492.04.0.934773868607.issue12490@psf.upfronthosting.co.za>


Rodolpho Eckhardt <rodolpho.eckhardt at gmail.com> added the comment:

My mistake reading the documentation.
Sorry, closing this issue.

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

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

From report at bugs.python.org  Mon Jul  4 23:24:35 2011
From: report at bugs.python.org (Senthil Kumaran)
Date: Mon, 04 Jul 2011 21:24:35 +0000
Subject: [docs] [issue12491] Update glossary documentation for the term
	'attribute'
In-Reply-To: <1309814675.46.0.717017747157.issue12491@psf.upfronthosting.co.za>
Message-ID: <1309814675.46.0.717017747157.issue12491@psf.upfronthosting.co.za>


New submission from Senthil Kumaran <senthil at uthcode.com>:

Update the term 'attribute' in the glossary http://docs.python.org/dev/glossary.html#term-attribute so that the reader can understand that the term attribute in Python can mean both 'data-attribute' and a 'callable' method.

----------
assignee: docs at python
components: Documentation
messages: 139809
nosy: docs at python, orsenthil
priority: normal
severity: normal
status: open
title: Update glossary documentation for the term 'attribute'
versions: Python 2.7, Python 3.2, Python 3.3

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

From report at bugs.python.org  Tue Jul  5 12:47:43 2011
From: report at bugs.python.org (Florian Preinstorfer)
Date: Tue, 05 Jul 2011 10:47:43 +0000
Subject: [docs] [issue11468] Improve unittest basic example in the doc
In-Reply-To: <1299867342.41.0.388080450116.issue11468@psf.upfronthosting.co.za>
Message-ID: <1309862863.24.0.628710464298.issue11468@psf.upfronthosting.co.za>


Florian Preinstorfer <nblock at archlinux.us> added the comment:

I tried to implement the improvements suggested by Ezio Melotti and updated the documentation accordingly.

----------
keywords: +patch
nosy: +notizblock
Added file: http://bugs.python.org/file22576/issue-11468.patch

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

From report at bugs.python.org  Tue Jul  5 17:39:24 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Tue, 05 Jul 2011 15:39:24 +0000
Subject: [docs] [issue12043] Update shutil documentation
In-Reply-To: <1304967545.46.0.442679433989.issue12043@psf.upfronthosting.co.za>
Message-ID: <1309880364.28.0.0279512869528.issue12043@psf.upfronthosting.co.za>


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

I will commit the rest of the patch.

----------
assignee: docs at python -> eric.araujo
priority: low -> high

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

From report at bugs.python.org  Tue Jul  5 18:14:33 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Tue, 05 Jul 2011 16:14:33 +0000
Subject: [docs] [issue10318] "make altinstall" installs many files with
	incorrect	shebangs
In-Reply-To: <1288926610.35.0.932494150274.issue10318@psf.upfronthosting.co.za>
Message-ID: <1309882472.95.0.0711096517611.issue10318@psf.upfronthosting.co.za>


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

This 3.2 patch updates UNIX rights and shebangs in Tools/scripts.

I also edited mailerdaemon, which used a string exception.

----------
versions:  -Python 3.1
Added file: http://bugs.python.org/file22584/tools-scripts.diff

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

From report at bugs.python.org  Wed Jul  6 07:48:04 2011
From: report at bugs.python.org (John)
Date: Wed, 06 Jul 2011 05:48:04 +0000
Subject: [docs] [issue11230] "Full unicode import system" not in 3.2
In-Reply-To: <1297926635.95.0.756299771372.issue11230@psf.upfronthosting.co.za>
Message-ID: <1309931284.78.0.0691809483413.issue11230@psf.upfronthosting.co.za>


John <jh45dev at gmail.com> added the comment:

Sorry for the long delay.

haypo wrote:
  Can you propose a sentence which is more clear about bytes/Unicode?

On this page:
http://www.python.org/download/releases/3.2/
is this line:
"- countless fixes regarding bytes/string issues; among them full support for a bytes environment (filenames, environment variables)"

How about adding to that line something like:
" on UNIX; but on Windows the path to and name of each module you import can contain only characters that are in the ANSI codepage that your Windows is using"

and maybe
" (will be fixed in Python 3.3)"

and maybe (or not) also something like:
" (ANSI codepage = basic latin + other characters of only your own language group)"

-- jh

----------

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

From report at bugs.python.org  Thu Jul  7 17:13:21 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 07 Jul 2011 15:13:21 +0000
Subject: [docs] [issue10403] Use "member" consistently
In-Reply-To: <1289623042.93.0.830099606418.issue10403@psf.upfronthosting.co.za>
Message-ID: <1310051601.33.0.793215053291.issue10403@psf.upfronthosting.co.za>


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

Senthil, I?m not sure you read Alexander?s reply on Rietveld before committing.

----------

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

From report at bugs.python.org  Thu Jul  7 20:48:23 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Thu, 07 Jul 2011 18:48:23 +0000
Subject: [docs] [issue12183] Document behaviour of shutil.copy2 and copystat
	with	symlinks
In-Reply-To: <1306384920.41.0.626033537775.issue12183@psf.upfronthosting.co.za>
Message-ID: <1310064503.49.0.608584515477.issue12183@psf.upfronthosting.co.za>


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

Shouldn't at least shutil.copytree() use lutimes in Python 3.3 to copy symlink metadata if symlinks=True?

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

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

From report at bugs.python.org  Thu Jul  7 20:59:14 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Thu, 07 Jul 2011 18:59:14 +0000
Subject: [docs] [issue12183] Document behaviour of shutil.copy2 and copystat
	with	symlinks
In-Reply-To: <1306384920.41.0.626033537775.issue12183@psf.upfronthosting.co.za>
Message-ID: <1310065154.32.0.916610366448.issue12183@psf.upfronthosting.co.za>


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

Attached a patch that documents the behavior of copy2() and copytree() for symlinks.

----------
keywords: +needs review, patch
stage:  -> patch review
Added file: http://bugs.python.org/file22607/copy2_copytree_symlinks_2.7.patch

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

From report at bugs.python.org  Thu Jul  7 21:00:01 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Thu, 07 Jul 2011 19:00:01 +0000
Subject: [docs] [issue12183] Document behaviour of shutil.copy2 and copystat
	with	symlinks
In-Reply-To: <1306384920.41.0.626033537775.issue12183@psf.upfronthosting.co.za>
Message-ID: <1310065201.0.0.277356040344.issue12183@psf.upfronthosting.co.za>


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


----------
nosy: +tarek

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

From report at bugs.python.org  Fri Jul  8 02:46:03 2011
From: report at bugs.python.org (Ned Deily)
Date: Fri, 08 Jul 2011 00:46:03 +0000
Subject: [docs] [issue11230] "Full unicode import system" not in 3.2
In-Reply-To: <1297926635.95.0.756299771372.issue11230@psf.upfronthosting.co.za>
Message-ID: <1310085963.55.0.00658557278836.issue11230@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Jul  8 16:01:50 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 08 Jul 2011 14:01:50 +0000
Subject: [docs] [issue12277] Missing comma in os.walk docs
In-Reply-To: <1307439951.32.0.810805209718.issue12277@psf.upfronthosting.co.za>
Message-ID: <1310133710.14.0.565941399766.issue12277@psf.upfronthosting.co.za>


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

?pending? does not mean ?soon to be fixed?, but ?soon to be closed if nobody reacts?.  In the future, we may have auto-closing of pending bugs.

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

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

From report at bugs.python.org  Fri Jul  8 16:50:14 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 08 Jul 2011 14:50:14 +0000
Subject: [docs] [issue11352] Update cgi module doc
In-Reply-To: <1298895261.86.0.965235067518.issue11352@psf.upfronthosting.co.za>
Message-ID: <1310136614.36.0.789102602211.issue11352@psf.upfronthosting.co.za>


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


----------
keywords: +needs review, patch
nosy: +amaury.forgeotdarc, andyharrington, erob, flox, gagenellina, haypo, oopos, pebbe, r.david.murray, tcourbon, tobias, v+python
priority: normal -> high
stage:  -> patch review
title: Bug in cgi module doc -> Update cgi module doc
type: behavior -> 
versions: +Python 3.3

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

From report at bugs.python.org  Sat Jul  9 09:34:48 2011
From: report at bugs.python.org (Kenyon Ralph)
Date: Sat, 09 Jul 2011 07:34:48 +0000
Subject: [docs] [issue7229] Manual entry for time.daylight can be misleading
In-Reply-To: <1256723052.19.0.148648938954.issue7229@psf.upfronthosting.co.za>
Message-ID: <1310196888.11.0.745415862592.issue7229@psf.upfronthosting.co.za>


Changes by Kenyon Ralph <kenyon at kenyonralph.com>:


----------
nosy: +kralph

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

From report at bugs.python.org  Sat Jul  9 22:54:27 2011
From: report at bugs.python.org (Eric Snow)
Date: Sat, 09 Jul 2011 20:54:27 +0000
Subject: [docs] [issue10403] Use "member" consistently
In-Reply-To: <1289623042.93.0.830099606418.issue10403@psf.upfronthosting.co.za>
Message-ID: <1310244867.6.0.432665152705.issue10403@psf.upfronthosting.co.za>


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


----------
nosy: +ericsnow

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

From report at bugs.python.org  Sat Jul  9 22:54:52 2011
From: report at bugs.python.org (Eric Snow)
Date: Sat, 09 Jul 2011 20:54:52 +0000
Subject: [docs] [issue12491] Update glossary documentation for the term
	'attribute'
In-Reply-To: <1309814675.46.0.717017747157.issue12491@psf.upfronthosting.co.za>
Message-ID: <1310244892.84.0.50564819429.issue12491@psf.upfronthosting.co.za>


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


----------
nosy: +ericsnow

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

From report at bugs.python.org  Sat Jul  9 22:57:38 2011
From: report at bugs.python.org (Eric Snow)
Date: Sat, 09 Jul 2011 20:57:38 +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: <1310245058.55.0.872109081663.issue12374@psf.upfronthosting.co.za>


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


----------
nosy: +ericsnow

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

From report at bugs.python.org  Sat Jul  9 23:31:43 2011
From: report at bugs.python.org (Eric Snow)
Date: Sat, 09 Jul 2011 21:31:43 +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: <1310247103.9.0.309252467562.issue11435@psf.upfronthosting.co.za>


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


----------
nosy: +ericsnow

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

From luciano at defalcoalfano.it  Sat Jul  2 17:55:54 2011
From: luciano at defalcoalfano.it (Luciano De Falco Alfano)
Date: Sat, 02 Jul 2011 17:55:54 +0200
Subject: [docs] Not a bug, but ...
Message-ID: <4E0F3F8A.8040504@defalcoalfano.it>

... maybe useful to change the address used in the POST example in doc 
pages about the httplib module 
(http://docs.python.org/library/httplib.html).

In fact, from the 28th of Jun 2011, mojam.com and musi-cal.com were 
closed 
(http://www.wolfgangsvault.com/blog/index.php/2011/06/closing-mojam-com-and-musi-cal-com/).

Thank you all for yours invaluable work about Python.
Sincerly
Luciano De Falco Alfano
Rome, Italy




From dave_7330 at hotmail.com  Mon Jul  4 20:41:38 2011
From: dave_7330 at hotmail.com (dawud barber)
Date: Mon, 4 Jul 2011 11:41:38 -0700
Subject: [docs] programming newbie
Message-ID: <SNT136-w74234CE254FABD58E24BA815C0@phx.gbl>


Hi. I went to python.org web site, looking to download release 3 of Python. Had trouble locating it.   Thanks. 		 	   		  
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20110704/d8c79f85/attachment.html>

From report at bugs.python.org  Sun Jul 10 11:05:32 2011
From: report at bugs.python.org (Georg Brandl)
Date: Sun, 10 Jul 2011 09:05:32 +0000
Subject: [docs] [issue12524] change httplib docs POST example
In-Reply-To: <1310288732.05.0.896091983102.issue12524@psf.upfronthosting.co.za>
Message-ID: <1310288732.05.0.896091983102.issue12524@psf.upfronthosting.co.za>


New submission from Georg Brandl <georg at python.org>:

The POST example in the httplib docs references musi-cal.mojam.com, which is now defunct.

----------
assignee: docs at python
components: Documentation
keywords: easy
messages: 140074
nosy: docs at python, georg.brandl
priority: low
severity: normal
status: open
title: change httplib docs POST example

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

From georg at python.org  Sun Jul 10 11:06:50 2011
From: georg at python.org (Georg Brandl)
Date: Sun, 10 Jul 2011 11:06:50 +0200
Subject: [docs] Not a bug, but ...
In-Reply-To: <4E0F3F8A.8040504@defalcoalfano.it>
References: <4E0F3F8A.8040504@defalcoalfano.it>
Message-ID: <4E196BAA.5040503@python.org>

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Am 02.07.2011 17:55, schrieb Luciano De Falco Alfano:
> ... maybe useful to change the address used in the POST example in doc pages
> about the httplib module (http://docs.python.org/library/httplib.html).
> 
> In fact, from the 28th of Jun 2011, mojam.com and musi-cal.com were closed 
> (http://www.wolfgangsvault.com/blog/index.php/2011/06/closing-mojam-com-and-musi-cal-com/).

Thanks
> 
for the report, I've opened issue #12524 to track this.

Georg
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.17 (GNU/Linux)

iEYEARECAAYFAk4Za6oACgkQN9GcIYhpnLA4PgCcDH2XeM8bzwmbaq9R9x0FWnxb
QQAAoIJlo6ergNP2QQofD3ITcY/KUSTp
=rCYu
-----END PGP SIGNATURE-----

From report at bugs.python.org  Sun Jul 10 13:18:17 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Sun, 10 Jul 2011 11:18:17 +0000
Subject: [docs] [issue12491] Update glossary documentation for the term
	'attribute'
In-Reply-To: <1309814675.46.0.717017747157.issue12491@psf.upfronthosting.co.za>
Message-ID: <1310296697.39.0.0453799711485.issue12491@psf.upfronthosting.co.za>


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

The current glossary entry is fine and encompasses was is ordinarily meant by attribute as distinct from a method.

We sometimes use the term loosely to mean any value whether callable or not.  And sometimes it is used loosely to mean anything that can be looked up with getattr().

Attempts to over-define it will be incorrect for some uses.  Also, it is likely to make the glossary entry less understandable.

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

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

From report at bugs.python.org  Sun Jul 10 14:44:20 2011
From: report at bugs.python.org (R. David Murray)
Date: Sun, 10 Jul 2011 12:44:20 +0000
Subject: [docs] [issue12491] Update glossary documentation for the term
	'attribute'
In-Reply-To: <1309814675.46.0.717017747157.issue12491@psf.upfronthosting.co.za>
Message-ID: <1310301860.85.0.238863450492.issue12491@psf.upfronthosting.co.za>


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

As an experienced Python programmer, I think of 'attribute' as meaning any attribute (method or non-method) of an object or class.  I sometimes do use it imprecisely (to my mind) to mean "non-method attribute", and it is usually clear from context what I mean.

Raymond, if attribute means only non-method attributes, what is the word for the set of things that contains both method and non-method...ah, attributes...of an object?

(I thought we already had this discussion both on python-dev and another issue....)

Hmm.  Actually looking at the linked entry, it looks correct to me (it covers both method and non-method attributes as far as I can see).  It might be clearer if it mentioned that a value can be anything, including a method.

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

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

From report at bugs.python.org  Sun Jul 10 14:54:05 2011
From: report at bugs.python.org (R. David Murray)
Date: Sun, 10 Jul 2011 12:54:05 +0000
Subject: [docs] [issue12491] Update glossary documentation for the term
	'attribute'
In-Reply-To: <1309814675.46.0.717017747157.issue12491@psf.upfronthosting.co.za>
Message-ID: <1310302445.28.0.814815647002.issue12491@psf.upfronthosting.co.za>


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

OK, I found the other issue and it looks like we agreed to use 'attributes and methods' where the reference was inclusive.  I still think that it is less precise to think this way, but it is clearer exposition given the lack of a good term for non-method attributes.  So now I agree that we should not change the existing glossary definition of attribute.

----------

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

From report at bugs.python.org  Mon Jul 11 00:58:59 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Sun, 10 Jul 2011 22:58:59 +0000
Subject: [docs] [issue12491] Update glossary documentation for the term
	'attribute'
In-Reply-To: <1309814675.46.0.717017747157.issue12491@psf.upfronthosting.co.za>
Message-ID: <1310338739.71.0.504868289374.issue12491@psf.upfronthosting.co.za>


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


----------
resolution:  -> rejected
status: open -> closed

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

From report at bugs.python.org  Mon Jul 11 01:40:40 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 10 Jul 2011 23:40:40 +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: <E1Qg3c7-0000xV-A6@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset b763c1ba5589 by Antoine Pitrou in branch '3.2':
Issue #12343: Add some notes on behaviour of non-blocking SSL sockets.
http://hg.python.org/cpython/rev/b763c1ba5589

New changeset 77334eb5038d by Antoine Pitrou in branch 'default':
Issue #12343: Add some notes on behaviour of non-blocking SSL sockets.
http://hg.python.org/cpython/rev/77334eb5038d

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

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

From report at bugs.python.org  Mon Jul 11 01:42:05 2011
From: report at bugs.python.org (Antoine Pitrou)
Date: Sun, 10 Jul 2011 23:42:05 +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: <1310341325.84.0.241134517679.issue12343@psf.upfronthosting.co.za>


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

I'd say this is fixed now. Tell me if there are any precisions you would like to see added.

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

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

From report at bugs.python.org  Mon Jul 11 14:03:43 2011
From: report at bugs.python.org (Peter Eisentraut)
Date: Mon, 11 Jul 2011 12:03:43 +0000
Subject: [docs] [issue12531] documentation index entries for * and **
In-Reply-To: <1310385823.58.0.152505903133.issue12531@psf.upfronthosting.co.za>
Message-ID: <1310385823.58.0.152505903133.issue12531@psf.upfronthosting.co.za>


New submission from Peter Eisentraut <peter_e at gmx.net>:

The existing documentation index entries for * and ** only point to their use in function definitions but not to their use in function calls.  I was looking for the latter, and it was difficult to find without this.  Here is a small patch to add the additional entries.

----------
assignee: docs at python
components: Documentation
files: python-doc-index-**.patch
keywords: patch
messages: 140113
nosy: docs at python, petere
priority: normal
severity: normal
status: open
title: documentation index entries for * and **
versions: Python 3.3
Added file: http://bugs.python.org/file22619/python-doc-index-**.patch

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

From report at bugs.python.org  Mon Jul 11 14:53:50 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 11 Jul 2011 12:53:50 +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: <1310388830.56.0.485644559086.issue11435@psf.upfronthosting.co.za>


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

Patch to fix links in the 3.2 docs.

----------
Added file: http://bugs.python.org/file22620/docs-source-link-3.2.diff

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

From report at bugs.python.org  Mon Jul 11 17:30:25 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 11 Jul 2011 15:30:25 +0000
Subject: [docs] [issue10403] Use "member" consistently
In-Reply-To: <1289623042.93.0.830099606418.issue10403@psf.upfronthosting.co.za>
Message-ID: <1310398225.24.0.424402666417.issue10403@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Mon Jul 11 18:05:29 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 11 Jul 2011 16:05:29 +0000
Subject: [docs] [issue12434] Strengthen 2.7 io types warning
In-Reply-To: <1309288978.39.0.732754105333.issue12434@psf.upfronthosting.co.za>
Message-ID: <1310400329.18.0.644108924869.issue12434@psf.upfronthosting.co.za>


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

Do you think the docstrings and error messages should be improved as well as the docs?

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

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

From report at bugs.python.org  Mon Jul 11 18:13:06 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 11 Jul 2011 16:13:06 +0000
Subject: [docs] [issue12436] Provide reference to detailed installation
	instructions
In-Reply-To: <1309305395.29.0.101516779086.issue12436@psf.upfronthosting.co.za>
Message-ID: <1310400786.07.0.8062834225.issue12436@psf.upfronthosting.co.za>


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

> Goal #1: set up Python
I believe http://docs.python.org/dev/using/ covers this.

> Goal #2: prepare a text editor
This is missing from our docs.  (My first thought was that it was out of scope, but for complete beginners, it would be nice to give a few pointers.)

> Goal #3: practice starting and exiting Python
The tutorial has one page about that.

> Goal #4: practice navigating the computer from a command prompt
Out of scope?

> Goal #5: practice running Python code from a file
This is probably in the tutorial or using docs, I have to check.

> Goal #6: get dependencies installed for the Saturday projects
This used to be non-standard, but now that we have packaging and pysetup, I translate this item to a doc bug: Explain how to use pysetup to get dependencies (in using, I think).

> Goal #7: start learning Python!
> Goal #8: Checkoff
Nothing to add, IMO.

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

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

From report at bugs.python.org  Tue Jul 12 04:34:55 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Tue, 12 Jul 2011 02:34:55 +0000
Subject: [docs] [issue12434] Strengthen 2.7 io types warning
In-Reply-To: <1309288978.39.0.732754105333.issue12434@psf.upfronthosting.co.za>
Message-ID: <1310438095.33.0.769778758857.issue12434@psf.upfronthosting.co.za>


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

My original suggestion is a minimal change suggestion. I do not have much opinion on what the maximum change 'should' be.

It would obviously be nice from a user viewpoint if the error message were backported to say "unicode argument expected, got 'str'". Then the note change might not be needed. But I do not know if the particular message is an accident or part of a policy of not fully backporting the code (to aid future patching?), or whether there are other messages that would need the same treatment.

The module docstring shown by help(io) does not have the terminology note to be augmented.

----------

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

From report at bugs.python.org  Tue Jul 12 06:55:15 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Tue, 12 Jul 2011 04:55:15 +0000
Subject: [docs] [issue12434] Strengthen 2.7 io types warning
In-Reply-To: <1309288978.39.0.732754105333.issue12434@psf.upfronthosting.co.za>
Message-ID: <1310446515.57.0.426026056.issue12434@psf.upfronthosting.co.za>


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

In my opinion, it's the error messages and docstrings that should be changed, not the documentation. This module was introduced in 2.6 and moves on to 2.7, and there's no reason to have it throw confusing errors for the sake of easier back-patching from 3.x

However, when I run this example on 2.6, I get:

   TypeError: can't write str to text stream

Which (arguably) makes sense, since the docs explicitly say that "Text I/O classes work with unicode data."

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

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

From report at bugs.python.org  Tue Jul 12 08:30:34 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Tue, 12 Jul 2011 06:30:34 +0000
Subject: [docs] [issue12531] documentation index entries for * and **
In-Reply-To: <1310385823.58.0.152505903133.issue12531@psf.upfronthosting.co.za>
Message-ID: <1310452234.81.0.987040590429.issue12531@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/issue12531>
_______________________________________

From report at bugs.python.org  Tue Jul 12 09:15:18 2011
From: report at bugs.python.org (Nick Coghlan)
Date: Tue, 12 Jul 2011 07:15:18 +0000
Subject: [docs] [issue12436] Provide reference to detailed installation
	instructions
In-Reply-To: <1309305395.29.0.101516779086.issue12436@psf.upfronthosting.co.za>
Message-ID: <1310454918.28.0.247789202616.issue12436@psf.upfronthosting.co.za>


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

Nice, I didn't know we have those comprehensive using docs. However, they should be linked from http://docs.python.org/dev/tutorial/interpreter.html (definitely inline and perhaps a see also).

----------

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

From report at bugs.python.org  Tue Jul 12 15:35:30 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Tue, 12 Jul 2011 13:35:30 +0000
Subject: [docs] [issue9254] __import__ docstring should
	recommend	importlib.import_module()
In-Reply-To: <1279057769.02.0.398615806235.issue9254@psf.upfronthosting.co.za>
Message-ID: <1310477730.22.0.11357656134.issue9254@psf.upfronthosting.co.za>


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

The docstring of __import__ was updated to mention importlib in 3d490c3a019e, for #7397.  Attached patch edits the docs.

----------
keywords: +patch
versions:  -Python 3.1
Added file: http://bugs.python.org/file22629/__import__-mention-importlib.diff

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

From report at bugs.python.org  Tue Jul 12 15:43:47 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Tue, 12 Jul 2011 13:43:47 +0000
Subject: [docs] [issue3565] array documentation,
	method names not 3.x-compliant
In-Reply-To: <1218878053.61.0.879399084038.issue3565@psf.upfronthosting.co.za>
Message-ID: <1310478226.97.0.182845073536.issue3565@psf.upfronthosting.co.za>


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

It was Antoine in fa8b57f987c5, for #8990.

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

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

From report at bugs.python.org  Tue Jul 12 17:21:05 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Tue, 12 Jul 2011 15:21:05 +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: <1310484065.3.0.401013663632.issue11553@psf.upfronthosting.co.za>


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

>>> 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.)

importlib.import_module should not be overkill, as it was designed specifically to be more easy and correct to use than __import__.

>>> -- 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.

Sorry, I should have clarified.  I meant that __all__ limits what ?from x import *? can see (for somemodule.__all__), and what pydoc and other tools display (for someobject.__all__).  Direct reference ?x._lalala? or explicit import ?from x import explicit_name? don?t look at __all__.
                                                     
>>> In addsitepackages(), the library directory for Windows (the else
>>> clause) is shown as lower-case 'lib' instead of 'Lib'.

Please report that as a new bug.

>>> 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.

I?m all for demystification, so OK.  We already have platform-specific examples in site and/or sysconfig docs, so once more wouldn?t harm.

>>> '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\.

That does not map to the home concept at all.  Anyway, it does not really add value to say that one OS doesn?t have something that another OS has, let?s just say that X uses something and that Y uses soemthing else.

>> 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" [...]
> Does this really mean "install modules to \Temp\Python\Lib\site-packages"?

I don?t know, try it in a shell!

> (And as a side point, surely installing under the Temp directory is a
> strange location to pick for an example?)

Well, the docs gotta pick something.  A tempdir is not worse than something else to demonstrate how to use a tool.

We need to have one discussion thread for each issue, to make this huge doc bug manageable.  I will go over your first message again and open one report for each point, this week if I have time.

----------

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

From report at bugs.python.org  Tue Jul 12 21:20:44 2011
From: report at bugs.python.org (Brett Cannon)
Date: Tue, 12 Jul 2011 19:20:44 +0000
Subject: [docs] [issue9254] __import__ docstring should
	recommend	importlib.import_module()
In-Reply-To: <1279057769.02.0.398615806235.issue9254@psf.upfronthosting.co.za>
Message-ID: <1310498444.8.0.733963168689.issue9254@psf.upfronthosting.co.za>


Brett Cannon <brett at python.org> added the comment:

Patch looks good to me.

----------
stage: needs patch -> commit review

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

From report at bugs.python.org  Tue Jul 12 21:51:44 2011
From: report at bugs.python.org (Antoine Pitrou)
Date: Tue, 12 Jul 2011 19:51:44 +0000
Subject: [docs] [issue3565] array documentation,
	method names not 3.x-compliant
In-Reply-To: <1218878053.61.0.879399084038.issue3565@psf.upfronthosting.co.za>
Message-ID: <1310500304.01.0.382388351265.issue3565@psf.upfronthosting.co.za>


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

> Is there still any idea/intention of renaming .from/.tounicode to
> .from/.tostring? That would have to be done at least one version with
> the 'string' names absent, and would have little gain as 'unicode' is
> clear.

Indeed, not only it would bring little benefit, but may also confuse users porting from 2.x (since the from/tostring methods would then have a totally different meaning).

----------
resolution:  -> duplicate
stage: patch review -> committed/rejected
status: open -> closed
superseder:  -> array constructor and array.fromstring should accept bytearray.

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

From report at bugs.python.org  Wed Jul 13 05:57:48 2011
From: report at bugs.python.org (Matt Giuca)
Date: Wed, 13 Jul 2011 03:57:48 +0000
Subject: [docs] [issue3565] array documentation,
	method names not 3.x-compliant
In-Reply-To: <1218878053.61.0.879399084038.issue3565@psf.upfronthosting.co.za>
Message-ID: <1310529468.41.0.222174114219.issue3565@psf.upfronthosting.co.za>


Matt Giuca <matt.giuca at gmail.com> added the comment:

There are still some inconsistencies in the documentation (in particular, incorrectly using the word "string" to refer to a bytes object, which made sense in Python 2 but not 3), which I fixed in my doc-only.patch file that's coming up to its third birthday.

Most of it has been fixed with the previous change which added 'tobytes' and 'frombytes' and made tostring and fromstring aliases. But there are some places which don't make sense:

array: "If given a list or string" needs to be "If given a list, bytes or string" (since a bytes is not a string).
frombytes: "Appends items from the string" needs to be "Appends items from the bytes object", since this does not work if you give it a string.

Less importantly, I also recommended renaming "unicode string" to just "string", since in Python 3 there is no such thing as a non-unicode string. For instance, there is an example that uses a variable named "unicodestring" that could be renamed to just "string".

> Indeed, not only it would bring little benefit, but may also confuse
> users porting from 2.x (since the from/tostring methods would then
> have a totally different meaning).
Well, by that logic, you shouldn't have renamed "unicode" to "str" since that would also confuse users porting from 2.x. It generally seems like a good idea in Python 3 to rename all mentions of "string" to "bytes" and all mentions of "unicode" to "string", so as to be consistent with the new names of the types (it is better to be internally consistent than consistent with the previous version).

Though I do agree that it would be chaos to rename array.from/tounicode to from/tostring now, given that array.from/tostring already has a different meaning in Python 3.

----------

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

From albert.zeyer at rwth-aachen.de  Tue Jul 12 02:03:20 2011
From: albert.zeyer at rwth-aachen.de (Albert Zeyer)
Date: Tue, 12 Jul 2011 02:03:20 +0200
Subject: [docs] C code wrong after forward declaration
Message-ID: <CAO1Q+je5NX4VEeAtxa-OmLMCTP_pX2GtHAmKCYTn66zefo5iow@mail.gmail.com>

Hi,

[Here](http://docs.python.org/library/ctypes.html#incomplete-types)
you have this C code:

struct cell; /* forward declaration */

struct {
    char *name;
    struct cell *next;
} cell;

It should be like this:

struct cell; /* forward declaration */

struct cell {
    char *name;
    struct cell *next;
};

Regards,
Albert

From nneonneo at gmail.com  Tue Jul 12 19:45:37 2011
From: nneonneo at gmail.com (Robert Xiao)
Date: Tue, 12 Jul 2011 13:45:37 -0400
Subject: [docs] logging.Logger.debug example doesn't work
Message-ID: <CAJYbZCAeJ4WMPpgNWQxvVuF3xjY-AKcNEnDJ9JjQr1L-sx0O9Q@mail.gmail.com>

The Logger.debug example (at
http://docs.python.org/py3k/library/logging.html#logging.Logger.debug) does
not actually work in Python 3.2:

Python 3.2 (r32:88452, Feb 20 2011, 11:12:31)
[GCC 4.2.1 (Apple Inc. build 5664)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> import logging
>>> FORMAT = '%(asctime)-15s %(clientip)s %(user)-8s %(message)s'
>>> logging.basicConfig(format=FORMAT)
>>> d = {'clientip': '192.168.0.1', 'user': 'fbloggs'}
>>> logging.warning('Protocol problem: %s', 'connection reset', extra=d)
Traceback (most recent call last):
  File
"/Library/Frameworks/Python.framework/Versions/3.2/lib/python3.2/logging/__init__.py",
line 934, in emit
    msg = self.format(record)
  File
"/Library/Frameworks/Python.framework/Versions/3.2/lib/python3.2/logging/__init__.py",
line 809, in format
    return fmt.format(record)
  File
"/Library/Frameworks/Python.framework/Versions/3.2/lib/python3.2/logging/__init__.py",
line 551, in format
    s = self.formatMessage(record)
  File
"/Library/Frameworks/Python.framework/Versions/3.2/lib/python3.2/logging/__init__.py",
line 520, in formatMessage
    return self._style.format(record)
  File
"/Library/Frameworks/Python.framework/Versions/3.2/lib/python3.2/logging/__init__.py",
line 371, in format
    return self._fmt % record.__dict__
KeyError: 'asctime'
Logged from file <stdin>, line 1

The problem is that the logger expects to see the exact string "%(asctime)s"
in the format string before it will add the asctime attribute. Using the
"-15" modifier on the asctime causes the match to fail, and the asctime
attribute is not emitted. To fix the example, change %(asctime)-15s to
%(asctime)s:

Python 3.2 (r32:88452, Feb 20 2011, 11:12:31)
[GCC 4.2.1 (Apple Inc. build 5664)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> import logging
>>> FORMAT = '%(asctime)s %(clientip)s %(user)-8s %(message)s'
>>> logging.basicConfig(format=FORMAT)
>>> d = { 'clientip' : '192.168.0.1', 'user' : 'fbloggs' }
>>> logger = logging.getLogger('tcpserver')
>>> logger.warning('Protocol problem: %s', 'connection reset', extra=d)
2011-07-12 13:39:44,317 192.168.0.1 fbloggs  Protocol problem: connection
reset

This also reflects a problem in the library in that it is not flexible
enough to understand different formats. As a separate matter, perhaps the
library could be amended to always include the asctime field (the asctime
string could be lazily computed by using a class instance for which the
__str__ method produces the actual formatted date), rather than trying to
guess when it is needed.

Robert
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20110712/5a14c24a/attachment.html>

From rohan.bavishi95 at gmail.com  Wed Jul 13 05:19:59 2011
From: rohan.bavishi95 at gmail.com (Rohan Bavishi)
Date: Wed, 13 Jul 2011 08:49:59 +0530
Subject: [docs] Bug Report
Message-ID: <4E1D0EDF.4050407@gmail.com>

  The math package in both Python 2.7 and Python 2.5 is reporting a 
strange error. The sqrt function does not return the correct value for 
1695843602719359844. It returns an answer ending in 0 which is not 
possible and it returns the same answer for values above it. Kindly 
check if the same is happening  with you.

Thanks,
Rohan Bavishi
rohan.bavishi95 at gmail.com

From georg at python.org  Wed Jul 13 09:50:00 2011
From: georg at python.org (Georg Brandl)
Date: Wed, 13 Jul 2011 09:50:00 +0200
Subject: [docs] logging.Logger.debug example doesn't work
In-Reply-To: <CAJYbZCAeJ4WMPpgNWQxvVuF3xjY-AKcNEnDJ9JjQr1L-sx0O9Q@mail.gmail.com>
References: <CAJYbZCAeJ4WMPpgNWQxvVuF3xjY-AKcNEnDJ9JjQr1L-sx0O9Q@mail.gmail.com>
Message-ID: <4E1D4E28.7010505@python.org>

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hi Robert,

this has already been fixed as part of http://bugs.python.org/issue11330 and
the example should work now with 3.2.1.

Georg

Am 12.07.2011 19:45, schrieb Robert Xiao:
> The Logger.debug example (at 
> http://docs.python.org/py3k/library/logging.html#logging.Logger.debug) does
> not actually work in Python 3.2:
> 
> Python 3.2 (r32:88452, Feb 20 2011, 11:12:31) [GCC 4.2.1 (Apple Inc. build
> 5664)] on darwin Type "help", "copyright", "credits" or "license" for more
> information.
>>>> import logging FORMAT = '%(asctime)-15s %(clientip)s %(user)-8s
>>>> %(message)s' logging.basicConfig(format=FORMAT) d = {'clientip':
>>>> '192.168.0.1', 'user': 'fbloggs'} logging.warning('Protocol problem:
>>>> %s', 'connection reset', extra=d)
> Traceback (most recent call last): File 
> "/Library/Frameworks/Python.framework/Versions/3.2/lib/python3.2/logging/__init__.py",
>
> 
line 934, in emit
> msg = self.format(record) File 
> "/Library/Frameworks/Python.framework/Versions/3.2/lib/python3.2/logging/__init__.py",
>
> 
line 809, in format
> return fmt.format(record) File 
> "/Library/Frameworks/Python.framework/Versions/3.2/lib/python3.2/logging/__init__.py",
>
> 
line 551, in format
> s = self.formatMessage(record) File 
> "/Library/Frameworks/Python.framework/Versions/3.2/lib/python3.2/logging/__init__.py",
>
> 
line 520, in formatMessage
> return self._style.format(record) File 
> "/Library/Frameworks/Python.framework/Versions/3.2/lib/python3.2/logging/__init__.py",
>
> 
line 371, in format
> return self._fmt % record.__dict__ KeyError: 'asctime' Logged from file
> <stdin>, line 1
> 
> The problem is that the logger expects to see the exact string "%(asctime)s"
> in the format string before it will add the asctime attribute. Using the
> "-15" modifier on the asctime causes the match to fail, and the asctime
> attribute is not emitted. To fix the example, change %(asctime)-15s to
> %(asctime)s:
> 
> Python 3.2 (r32:88452, Feb 20 2011, 11:12:31) [GCC 4.2.1 (Apple Inc. build
> 5664)] on darwin Type "help", "copyright", "credits" or "license" for more
> information.
>>>> import logging FORMAT = '%(asctime)s %(clientip)s %(user)-8s
>>>> %(message)s' logging.basicConfig(format=FORMAT) d = { 'clientip' :
>>>> '192.168.0.1', 'user' : 'fbloggs' } logger =
>>>> logging.getLogger('tcpserver') logger.warning('Protocol problem: %s',
>>>> 'connection reset', extra=d)
> 2011-07-12 13:39:44,317 192.168.0.1 fbloggs  Protocol problem: connection
> reset
> 
> This also reflects a problem in the library in that it is not flexible enough
> to understand different formats. As a separate matter, perhaps the library
> could be amended to always include the asctime field (the asctime string
> could be lazily computed by using a class instance for which the __str__
> method produces the actual formatted date), rather than trying to guess when
> it is needed.
> 
> Robert
> 
> 
> _______________________________________________ docs mailing list 
> docs at python.org http://mail.python.org/mailman/listinfo/docs

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.17 (GNU/Linux)

iEYEARECAAYFAk4dTigACgkQN9GcIYhpnLA7fACfcagCE7c74yOSxzwYb8UKhXzI
rioAnRaHw2PTrxcRA1j5eBm3xy4dKFy9
=5S06
-----END PGP SIGNATURE-----

From report at bugs.python.org  Wed Jul 13 10:13:31 2011
From: report at bugs.python.org (July Tikhonov)
Date: Wed, 13 Jul 2011 08:13:31 +0000
Subject: [docs] [issue12547] whatsnew/3.3: error in example about nntplib
In-Reply-To: <1310544811.28.0.517615627121.issue12547@psf.upfronthosting.co.za>
Message-ID: <1310544811.28.0.517615627121.issue12547@psf.upfronthosting.co.za>


New submission from July Tikhonov <july.tikh at gmail.com>:

>>> from nntplib import NNTP
>>> with nntplib.NNTP('news.gmane.org') as n:

will not work. It should be

>>> import nntplib
>>> with nntplib.NNTP('news.gmane.org') as n:

or

>>> from nntplib import NNTP
>>> with NNTP('news.gmane.org') as n:

----------
assignee: docs at python
components: Documentation
files: whatsnew.3.3.nntplib.example.diff
keywords: patch
messages: 140228
nosy: docs at python, july
priority: normal
severity: normal
status: open
title: whatsnew/3.3: error in example about nntplib
type: behavior
versions: Python 3.3
Added file: http://bugs.python.org/file22638/whatsnew.3.3.nntplib.example.diff

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

From report at bugs.python.org  Wed Jul 13 10:18:41 2011
From: report at bugs.python.org (Bharadwaj)
Date: Wed, 13 Jul 2011 08:18:41 +0000
Subject: [docs] [issue12524] change httplib docs POST example
In-Reply-To: <1310288732.05.0.896091983102.issue12524@psf.upfronthosting.co.za>
Message-ID: <1310545121.59.0.106625221844.issue12524@psf.upfronthosting.co.za>


Bharadwaj <barbi.bruce at gmail.com> added the comment:

Newbie to python dev. 
This looks like a good issue to get started with and I am interested in creating a patch.
What should the new URL be? python.org:80?

----------
nosy: +barbi

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

From report at bugs.python.org  Wed Jul 13 10:22:28 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Wed, 13 Jul 2011 08:22:28 +0000
Subject: [docs] [issue12524] change httplib docs POST example
In-Reply-To: <1310288732.05.0.896091983102.issue12524@psf.upfronthosting.co.za>
Message-ID: <1310545348.68.0.589870880239.issue12524@psf.upfronthosting.co.za>


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

You'll need a page that accepts POST requests, possibly returning some meaningful value, and without side effects (e.g. adding messages is usually done via POST, but we don't want a new message for every user that tries the example).

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

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

From report at bugs.python.org  Wed Jul 13 10:35:20 2011
From: report at bugs.python.org (Bharadwaj)
Date: Wed, 13 Jul 2011 08:35:20 +0000
Subject: [docs] [issue12524] change httplib docs POST example
In-Reply-To: <1310288732.05.0.896091983102.issue12524@psf.upfronthosting.co.za>
Message-ID: <1310546120.71.0.0110976239073.issue12524@psf.upfronthosting.co.za>


Bharadwaj <barbi.bruce at gmail.com> added the comment:

Is there someway to create a test page in python.org instead of an external domain? This can ensure many people have access to it and will not become defunct.
Please suggest next steps to proceed with this ticket.

----------

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

From report at bugs.python.org  Wed Jul 13 10:40:52 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Wed, 13 Jul 2011 08:40:52 +0000
Subject: [docs] [issue12524] change httplib docs POST example
In-Reply-To: <1310288732.05.0.896091983102.issue12524@psf.upfronthosting.co.za>
Message-ID: <1310546452.14.0.386925318636.issue12524@psf.upfronthosting.co.za>


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

FWIW the 'show issue' button on the left sidebar of http://bugs.python.org/ uses POST, so maybe you could send an issue number as request there to get back the issue page.

----------

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

From report at bugs.python.org  Wed Jul 13 10:45:00 2011
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 13 Jul 2011 08:45:00 +0000
Subject: [docs] [issue12547] whatsnew/3.3: error in example about nntplib
In-Reply-To: <1310544811.28.0.517615627121.issue12547@psf.upfronthosting.co.za>
Message-ID: <E1Qgv3z-0004Ax-4m@dinsdale.python.org>


Roundup Robot <devnull at devnull> added the comment:

New changeset e0cd35660ae9 by Ezio Melotti in branch 'default':
#12547: Fix import and output in nntplib example. Initial patch by July Tikhonov.
http://hg.python.org/cpython/rev/e0cd35660ae9

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

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

From report at bugs.python.org  Wed Jul 13 10:48:34 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Wed, 13 Jul 2011 08:48:34 +0000
Subject: [docs] [issue12547] whatsnew/3.3: error in example about nntplib
In-Reply-To: <1310544811.28.0.517615627121.issue12547@psf.upfronthosting.co.za>
Message-ID: <1310546914.65.0.406007535823.issue12547@psf.upfronthosting.co.za>


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

Fixed, thanks for the report and the patch!

----------
nosy: +ezio.melotti
resolution:  -> fixed
stage:  -> committed/rejected
status: open -> closed

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

From report at bugs.python.org  Wed Jul 13 14:15:48 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Wed, 13 Jul 2011 12:15:48 +0000
Subject: [docs] [issue12531] documentation index entries for * and **
In-Reply-To: <1310385823.58.0.152505903133.issue12531@psf.upfronthosting.co.za>
Message-ID: <1310559348.36.0.228900126353.issue12531@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Wed Jul 13 16:14:50 2011
From: report at bugs.python.org (Sye van der Veen)
Date: Wed, 13 Jul 2011 14:14:50 +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: <1310566490.41.0.0756822056773.issue10224@psf.upfronthosting.co.za>


Sye van der Veen <syeberman at gmail.com> added the comment:

When I built the documentation on Win7, it failed with a SyntaxError, and it took some digging to find the reason why.  I was hoping that issuing this warning would save others the trouble.

I agree: on Windows, PYTHON is rarely set.  However, look in make.bat: you'll see that when PYTHON is not already set, it's set to ..\pcbuild\python, which is Python 3.

----------

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

From report at bugs.python.org  Wed Jul 13 17:01:21 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 13 Jul 2011 15:01:21 +0000
Subject: [docs] [issue4819] Misc/cheatsheet needs updating
In-Reply-To: <1230988594.32.0.497089911482.issue4819@psf.upfronthosting.co.za>
Message-ID: <1310569281.38.0.0268808175276.issue4819@psf.upfronthosting.co.za>


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

I spent a few minutes updating the cheatsheet.  I think that the document is an outdated duplicate of random parts of the docs (syntax, man page, library reference, etc.) that?s rather hard to maintain for little benefit.  Is there any evidence that people used it?

I?d like to propose that we delete the file in 2.7 (it?s already gone from 3.2+) and that we start anew on a real cheatsheet, i.e. one or two A4 pages, in HTML and PDF and t-shirts, which are a useful summary of commonly used things.  I think one Python language cheatsheet and one standard library cheatsheet could be useful (one set for 2.7, another one for 3.2).

Regarding process, I?m not sure using a wiki or a non-reST file not included in the real docs is the way to go.  Maybe volunteers could work with the PSF team that?s producing a brochure?  (http://brochure.getpython.info/ ?I discovered it recently, and don?t know at all who works on it and how)

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

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

From report at bugs.python.org  Wed Jul 13 17:18:36 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Wed, 13 Jul 2011 15:18:36 +0000
Subject: [docs] [issue4819] Misc/cheatsheet needs updating
In-Reply-To: <1230988594.32.0.497089911482.issue4819@psf.upfronthosting.co.za>
Message-ID: <1310570316.54.0.846793486386.issue4819@psf.upfronthosting.co.za>


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

Another idea might be to have a "cheatsheet" in the official docs with links to the right section and possibly a minimal description.  It would be useful to get a quick overview of the features of the language and use the links to jump to the extended doc without having duplication.
Otherwise the examples could be moved to an external file that gets included both in the cheatsheet and in the official doc.

----------

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

From report at bugs.python.org  Wed Jul 13 17:50:19 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 13 Jul 2011 15:50:19 +0000
Subject: [docs] [issue11260] smtpd-as-a-script feature should be documented
	and	should use argparse
In-Reply-To: <1298232231.08.0.088023732748.issue11260@psf.upfronthosting.co.za>
Message-ID: <1310572219.85.0.20983997285.issue11260@psf.upfronthosting.co.za>


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

Here are comments on the doc patch.

+Run as a script
+---------------
I?d say ?Command-Line Interface?.

+``smtpd`` is a pluggable RFC 2821-compliant SMTP proxy.
:mod:`smtpd` is also a pluggable etc.

+.. program:: smtpd.py
Strip the .py

+   the ``setuid``
Please use markup like :func:`os.setuid`.

+   flag in order to run ``smtpd`` as a regular user.
Use :mod:`smtpd` or :program:`smtp` (not very important).

+   Turns on verbose debugging prints (to stderr)
Turn on verbose debbugging, which prints to stderr.

+   The concrete SMTP proxy class ``smtpd`` should use to perform its
+   proxying.
Could you add a link to a section of the doc that defines such classes?

+.. option:: localhost:localport
Currently undocumented.

----------

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

From report at bugs.python.org  Wed Jul 13 18:06:27 2011
From: report at bugs.python.org (Eric Snow)
Date: Wed, 13 Jul 2011 16:06:27 +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: <1310573186.99.0.482893144016.issue10224@psf.upfronthosting.co.za>


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


----------
nosy: +ericsnow

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

From report at bugs.python.org  Thu Jul 14 15:29:31 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 14 Jul 2011 13:29:31 +0000
Subject: [docs] [issue10403] Use "member" consistently
In-Reply-To: <1289623042.93.0.830099606418.issue10403@psf.upfronthosting.co.za>
Message-ID: <1310650171.77.0.0964288399888.issue10403@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Jul 14 16:15:43 2011
From: report at bugs.python.org (Senthil Kumaran)
Date: Thu, 14 Jul 2011 14:15:43 +0000
Subject: [docs] [issue10403] Use "member" consistently
In-Reply-To: <1289623042.93.0.830099606418.issue10403@psf.upfronthosting.co.za>
Message-ID: <1310652943.07.0.629760724759.issue10403@psf.upfronthosting.co.za>


Senthil Kumaran <senthil at uthcode.com> added the comment:

Hello Eric, I missed noticing Alexander's comments in the reitveld, I looked only at tracker then. I see that some of them can be addressed. Like using members (components) of the field, instead of attributes when it is not an attribute. Shall correct it. Thanks.

----------

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

From thavu at ucdavis.edu  Fri Jul 15 03:53:49 2011
From: thavu at ucdavis.edu (Thanh Vu)
Date: Thu, 14 Jul 2011 18:53:49 -0700
Subject: [docs] Up arrow functionality, Previous input
Message-ID: <CABK4Q1Ckb09Rayh5LX4=Oh2Sx+XO2=W7T-Cxs=Nb-nV47gn4oA@mail.gmail.com>

Was there ever a command to repeat the previous user keyboard input in
the Python IDLE? I find that this is a major problem, and I could not
find it anywhere In the documentation, nor could I Google it. Any
thoughts on implementing the up key to?

-- 
Thanh

From report at bugs.python.org  Fri Jul 15 18:05:43 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 15 Jul 2011 16:05:43 +0000
Subject: [docs] [issue1626300] 'Installing Python Modules' does not work for
	Windows
Message-ID: <1310745943.52.0.931549886077.issue1626300@psf.upfronthosting.co.za>


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

In distutils docs, I?ve mentioned ?setup.py thing? as an alternative to ?python setup.py thing? on Windows.  For packaging, the situation is different: there is no local script anymore, people will have to invoke the global pysetup command.  Would it work if I add a note like this:

  In order to run pysetup commands, you need to add the Python Scripts
  directory to your PATH *include link to relevant section of
  docs.python.org/using*.

BTW, do scripts work without file extensions, or does the installer add .py?  If it?s the latter, then my doc note will need to mention that too.

----------
nosy: +terry.reedy
versions: +Python 3.3 -Python 3.1

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

From report at bugs.python.org  Fri Jul 15 20:09:41 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Fri, 15 Jul 2011 18:09:41 +0000
Subject: [docs] [issue12524] change httplib docs POST example
In-Reply-To: <1310288732.05.0.896091983102.issue12524@psf.upfronthosting.co.za>
Message-ID: <1310753381.37.0.812951076691.issue12524@psf.upfronthosting.co.za>


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

There's also http://httpstat.us/. You can send any request (also POST) to http://httpstat.us/200 and it gives you a 200 OK response.

I recall seeing other similar services, but didn't find them quickly.

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

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

From report at bugs.python.org  Fri Jul 15 20:36:40 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 15 Jul 2011 18:36:40 +0000
Subject: [docs] [issue1626300] 'Installing Python Modules' does not work for
	Windows
Message-ID: <1310755000.24.0.919774467148.issue1626300@psf.upfronthosting.co.za>


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

On Windows, scripts run with whatever name -- no extension or other extensions. I have tested this from both IDLE and command line.

----------

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

From report at bugs.python.org  Fri Jul 15 21:25:51 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 15 Jul 2011 19:25:51 +0000
Subject: [docs] [issue12531] documentation index entries for * and **
In-Reply-To: <1310385823.58.0.152505903133.issue12531@psf.upfronthosting.co.za>
Message-ID: <1310757951.29.0.925939252566.issue12531@psf.upfronthosting.co.za>


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

This is just the tip of the iceberg as far as needed symbol index entries goes. Nearly 3 years ago, I wrote a Python 3 symbol glossary "Python3 Syntax Symbol Uses" that was complete as far as I knew then. I think most of the entries there should have a corresponding index entry in the official docs. Link to download/view is

https://code.google.com/p/xploro/downloads/detail?name=PySymbols.html&can=1&q=

That has 7 entries for '*':
  *: In function parameter list, make following unstarred names keyword only.
P *parameter_name: Function parameter bound to a tuple of extra positional arguments, any following unstarred names are keyword only.
P *iterable: In a call, unpack iterable items as arguments.
P *assignment_target: Starred target in assignment statement gets extra items from iterable.
I number1 * number2: Number multiplication operator.
I n * sequence or sequence * n: Operator to concatenate n copies of sequence.
S from module import *: Import all public (non-private) names from the module. 

 /P/I/S == 'nofix', prefix, infix, suffix.

I have been planning to work on a patch 'sometime', but would be happy if someone else grabbed the above and ran with it (and expanded the title of this issue).

I believe existing docs can get additions like this.

----------
nosy: +terry.reedy
versions: +Python 2.7, Python 3.2

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

From report at bugs.python.org  Fri Jul 15 22:36:02 2011
From: report at bugs.python.org (Eric Snow)
Date: Fri, 15 Jul 2011 20:36:02 +0000
Subject: [docs] [issue12531] documentation index entries for * and **
In-Reply-To: <1310385823.58.0.152505903133.issue12531@psf.upfronthosting.co.za>
Message-ID: <1310762162.24.0.612948886345.issue12531@psf.upfronthosting.co.za>


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


----------
nosy: +ericsnow

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

From report at bugs.python.org  Sat Jul 16 01:25:48 2011
From: report at bugs.python.org (Rafe Kettler)
Date: Fri, 15 Jul 2011 23:25:48 +0000
Subject: [docs] [issue12574] Documentation for Queue in 2.x has an incorrect
	title
In-Reply-To: <1310772348.87.0.605438364285.issue12574@psf.upfronthosting.co.za>
Message-ID: <1310772348.87.0.605438364285.issue12574@psf.upfronthosting.co.za>


New submission from Rafe Kettler <rafe.kettler at gmail.com>:

The documentation for Queue in all versions of Python 2.7 and 2.6 (see http://docs.python.org/release/2.6.7/library/queue.html#module-Queue for the 2.7 docs) has the title "queue -- A synchronized queue class." The module, however, is named "Queue" in all of 2.x. So, while the title is appropiate for 3.x, it's incorrect for 2.x.

I can make a patch, as well.

----------
assignee: docs at python
components: Documentation
messages: 140475
nosy: docs at python, rafe.kettler
priority: normal
severity: normal
status: open
title: Documentation for Queue in 2.x has an incorrect title
versions: Python 2.6, Python 2.7

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

From report at bugs.python.org  Sat Jul 16 10:26:55 2011
From: report at bugs.python.org (Bharadwaj)
Date: Sat, 16 Jul 2011 08:26:55 +0000
Subject: [docs] [issue12524] change httplib docs POST example
In-Reply-To: <1310288732.05.0.896091983102.issue12524@psf.upfronthosting.co.za>
Message-ID: <1310804815.74.0.504581542877.issue12524@psf.upfronthosting.co.za>


Changes by Bharadwaj <barbi.bruce at gmail.com>:


----------
keywords: +patch
Added file: http://bugs.python.org/file22674/http_example.diff

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

From report at bugs.python.org  Sat Jul 16 10:41:11 2011
From: report at bugs.python.org (Georg Brandl)
Date: Sat, 16 Jul 2011 08:41:11 +0000
Subject: [docs] [issue12524] change httplib docs POST example
In-Reply-To: <1310288732.05.0.896091983102.issue12524@psf.upfronthosting.co.za>
Message-ID: <1310805671.41.0.489171073354.issue12524@psf.upfronthosting.co.za>


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

httpstat.us is has been registered quite recently, and is titled as an "experiment" in the footer.  I'd rather use something more likely to be persistent.  bugs.python.org seems a better choice.

----------

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

From report at bugs.python.org  Sat Jul 16 11:04:03 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Sat, 16 Jul 2011 09:04:03 +0000
Subject: [docs] [issue12434] Strengthen 2.7 io types warning
In-Reply-To: <1309288978.39.0.732754105333.issue12434@psf.upfronthosting.co.za>
Message-ID: <1310807043.84.0.00492707140306.issue12434@psf.upfronthosting.co.za>


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

The difference between 2.6 and 2.7 stems from the rewrite of the IO library in C that was made for 2.7

The error Terry sees gets thrown here (in Modules/_io/stringio.c):

    if (!PyUnicode_Check(obj)) {
        PyErr_Format(PyExc_TypeError, "string argument expected, got '%s'",
                     Py_TYPE(obj)->tp_name);
        return NULL;
    }

Therefore, I propose to change this error message to:

"unicode argument expected, got '%s'"

as Terry suggested.

Adding Antoine, Benjamin and Daniel (listed as experts on IO) to nosy.

Is there an objection to making this change in the error message?

----------
nosy: +benjamin.peterson, pitrou, stutzbach

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

From report at bugs.python.org  Sat Jul 16 11:06:36 2011
From: report at bugs.python.org (Senthil Kumaran)
Date: Sat, 16 Jul 2011 09:06:36 +0000
Subject: [docs] [issue12524] change httplib docs POST example
In-Reply-To: <1310805671.41.0.489171073354.issue12524@psf.upfronthosting.co.za>
Message-ID: <20110716090628.GA2302@mathmagic>


Senthil Kumaran <senthil at uthcode.com> added the comment:

Also, it does not say or "advertise" about POST, it gives examples for
GET. I find Ezio's suggestion using bugs.python.org as a good one.

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

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

From report at bugs.python.org  Sat Jul 16 11:30:21 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Sat, 16 Jul 2011 09:30:21 +0000
Subject: [docs] [issue12531] documentation index entries for * and **
In-Reply-To: <1310385823.58.0.152505903133.issue12531@psf.upfronthosting.co.za>
Message-ID: <1310808621.02.0.355902187228.issue12531@psf.upfronthosting.co.za>


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

Peter, doesn't your patch also refer to the meaning of * and ** in function definitions?  

I would argue that the missing reference is to a paragraph further down:

   [...] If the syntax *expression appears in the function call, expression must evaluate to a sequence. Elements from this sequence [...]

Terry, the glossary you compiled certainly looks comprehensive. However, I wouldn't delay local fixes like the one discussed here until "the grand scheme" is committed.

----------

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

From sandro.tosi at gmail.com  Sat Jul 16 12:10:15 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Sat, 16 Jul 2011 12:10:15 +0200
Subject: [docs] programming newbie
In-Reply-To: <SNT136-w74234CE254FABD58E24BA815C0@phx.gbl>
References: <SNT136-w74234CE254FABD58E24BA815C0@phx.gbl>
Message-ID: <CAPdtAj384-4C3VLbCRnmYRcp3XiDh5xoQgsirtgi=j-CADbGkA@mail.gmail.com>

Hello dawud,

On Mon, Jul 4, 2011 at 20:41, dawud barber <dave_7330 at hotmail.com> wrote:
> Hi. I went to python.org web site, looking to download release 3 of Python.
> Had trouble locating it.

This is not the right mailing list where to ask about that, since here
we get reports about bugs in the documentation of Python. Probably the
best place for your is to ask for support in the python-list [1]

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

Anyhow, going from http://python.org, there's a link on the left
column named "Download": http://python.org/download/ - there you can
find te version of python we distribute

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 Jul 16 12:43:32 2011
From: report at bugs.python.org (Antoine Pitrou)
Date: Sat, 16 Jul 2011 10:43:32 +0000
Subject: [docs] [issue12434] Strengthen 2.7 io types warning
In-Reply-To: <1310807043.84.0.00492707140306.issue12434@psf.upfronthosting.co.za>
Message-ID: <1310812943.3630.0.camel@localhost.localdomain>


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

> The error Terry sees gets thrown here (in Modules/_io/stringio.c):
> 
>     if (!PyUnicode_Check(obj)) {
>         PyErr_Format(PyExc_TypeError, "string argument expected, got '%s'",
>                      Py_TYPE(obj)->tp_name);
>         return NULL;
>     }
> 
> Therefore, I propose to change this error message to:
> 
> "unicode argument expected, got '%s'"
> 
> as Terry suggested.
> 
> Adding Antoine, Benjamin and Daniel (listed as experts on IO) to nosy.
> 
> Is there an objection to making this change in the error message?

No, the proposal is right.

----------

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

From report at bugs.python.org  Sat Jul 16 16:08:17 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Sat, 16 Jul 2011 14:08:17 +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: <1310825297.07.0.461036458998.issue12380@psf.upfronthosting.co.za>


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

On one hand, I agree that the situation isn't intuitive. Why should some methods of bytearray accept bytearrays, and some shouldn't?

On the other hand, this actually has rather deep implementation reasons. 

Methods like 'translate' are implemented in Objects/bytearrayobject.c

On the other hand, ljust, rjust and center are taken from stringlib. Now, stringlib is generic code, and has some strict argument checking. For example, in stringlib_ljust:

    if (!PyArg_ParseTuple(args, "n|c:ljust", &width, &fillchar))
        return NULL;

The 'c' format to PyArg_ParseTuple expects an object that passes PyBytes_Check, IOW a bytes object or a subclass thereof. bytearray is not a subclass of bytes, hence the problem.

The solution could be global, to allow bytearray fit the 'c' format of PyArg_ParseTuple. Then one would also be able to pass a bytearray into other stringlib methods requiring the 'c' format.

One way or the other, this is of course doable. A decision has to be made though - is the nuisance annoying enough to warrant such an API change?

----------

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

From report at bugs.python.org  Sat Jul 16 16:51:41 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Sat, 16 Jul 2011 14:51:41 +0000
Subject: [docs] [issue12574] Documentation for Queue in 2.x has an incorrect
	title
In-Reply-To: <1310772348.87.0.605438364285.issue12574@psf.upfronthosting.co.za>
Message-ID: <CAF-Rda_J1uVECn0KEqqJiBbVevh-EY-Cfc023fr784PUtF+Yyw@mail.gmail.com>


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

> The documentation for Queue in all versions of Python 2.7 and 2.6 (see
> http://docs.python.org/release/2.6.7/library/queue.html#module-Queue for
> the 2.7 docs) has the title "queue -- A synchronized queue class." The
> module, however, is named "Queue" in all of 2.x. So, while the title is
> appropiate for 3.x, it's incorrect for 2.x.
>
> I can make a patch, as well.
>

Sure, make a patch for 2.7 (the 2.6 line is now in "security only" mode).

Eli

----------
nosy: +eli.bendersky
Added file: http://bugs.python.org/file22676/unnamed

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue12574>
_______________________________________
-------------- next part --------------
<div dir="ltr"><br><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
The documentation for Queue in all versions of Python 2.7 and 2.6 (see <a href="http://docs.python.org/release/2.6.7/library/queue.html#module-Queue" target="_blank">http://docs.python.org/release/2.6.7/library/queue.html#module-Queue</a> for the 2.7 docs) has the title &quot;queue -- A synchronized queue class.&quot; The module, however, is named &quot;Queue&quot; in all of 2.x. So, while the title is appropiate for 3.x, it&#39;s incorrect for 2.x.<br>


<br>
I can make a patch, as well.<br></blockquote></div><br>Sure, make a patch for 2.7 (the 2.6 line is now in &quot;security only&quot; mode).<br><br>Eli<br><br></div>

From report at bugs.python.org  Sat Jul 16 18:08:00 2011
From: report at bugs.python.org (Rafe Kettler)
Date: Sat, 16 Jul 2011 16:08:00 +0000
Subject: [docs] [issue12574] Documentation for Queue in 2.x has an incorrect
	title
In-Reply-To: <1310772348.87.0.605438364285.issue12574@psf.upfronthosting.co.za>
Message-ID: <1310832480.85.0.955321578744.issue12574@psf.upfronthosting.co.za>


Rafe Kettler <rafe.kettler at gmail.com> added the comment:

Okay, here's a patch.

I also went ahead and added my name to ACKS, since this is my 3rd or 4th patch.

Rafe

----------
keywords: +patch
Added file: http://bugs.python.org/file22677/queue_docs.patch

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

From report at bugs.python.org  Sun Jul 17 04:54:53 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 17 Jul 2011 02:54:53 +0000
Subject: [docs] [issue12574] Documentation for Queue in 2.x has an incorrect
	title
In-Reply-To: <1310772348.87.0.605438364285.issue12574@psf.upfronthosting.co.za>
Message-ID: <E1QiHVM-0005fG-2I@dinsdale.python.org>


Roundup Robot <devnull at psf.upfronthosting.co.za> added the comment:

New changeset 60ce5f279a5e by Eli Bendersky in branch '2.7':
Issue #12574: correct capitalization of the Queue module. Patch by Rafe Kettler
http://hg.python.org/cpython/rev/60ce5f279a5e

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

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

From report at bugs.python.org  Sun Jul 17 04:56:59 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Sun, 17 Jul 2011 02:56:59 +0000
Subject: [docs] [issue12574] Documentation for Queue in 2.x has an incorrect
	title
In-Reply-To: <1310772348.87.0.605438364285.issue12574@psf.upfronthosting.co.za>
Message-ID: <1310871419.49.0.118384404022.issue12574@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sun Jul 17 10:59:21 2011
From: report at bugs.python.org (Catalin Iacob)
Date: Sun, 17 Jul 2011 08:59:21 +0000
Subject: [docs] [issue12577] Misleading shutil.move docs regarding when
	os.rename is	used
In-Reply-To: <1310893161.81.0.334547060207.issue12577@psf.upfronthosting.co.za>
Message-ID: <1310893161.81.0.334547060207.issue12577@psf.upfronthosting.co.za>


New submission from Catalin Iacob <iacobcatalin at gmail.com>:

I recently tried to answer the question: "When moving a file to a destination that is an already existing file, is the destination overwritten?"

>From the current docs I understood that if src and dst are on the same filesystem then os.rename is used, if they are on different filesystems then copy + remove is used instead. Since os.rename fails on Windows if the destination exists I concluded that shutil.move would fail on Windows and overwrite dst on Unix.

----------
assignee: docs at python
components: Documentation
messages: 140520
nosy: catalin.iacob, docs at python
priority: normal
severity: normal
status: open
title: Misleading shutil.move docs regarding when os.rename is used
versions: Python 2.7, Python 3.2, Python 3.3

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

From report at bugs.python.org  Sun Jul 17 11:00:14 2011
From: report at bugs.python.org (Catalin Iacob)
Date: Sun, 17 Jul 2011 09:00:14 +0000
Subject: [docs] [issue12577] Misleading shutil.move docs regarding when
	os.rename is	used
In-Reply-To: <1310893161.81.0.334547060207.issue12577@psf.upfronthosting.co.za>
Message-ID: <1310893214.16.0.939010185663.issue12577@psf.upfronthosting.co.za>


Catalin Iacob <iacobcatalin at gmail.com> added the comment:

Attached patch which clarifies that the copy fallback is used whenever os.rename fails not just for the different filesystems case.

----------
keywords: +patch
Added file: http://bugs.python.org/file22679/clarify-shutil.move-docs.patch

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

From report at bugs.python.org  Sun Jul 17 13:06:20 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 17 Jul 2011 11:06:20 +0000
Subject: [docs] [issue10403] Use "member" consistently
In-Reply-To: <1289623042.93.0.830099606418.issue10403@psf.upfronthosting.co.za>
Message-ID: <E1QiPAw-0000xH-G4@dinsdale.python.org>


Roundup Robot <devnull at psf.upfronthosting.co.za> added the comment:

New changeset 05f0ffe4e0b3 by Senthil Kumaran in branch '3.2':
Fix Issue10403 - datetime documentation clarification based on review in the reitveld by Alexendar belopolsky.
http://hg.python.org/cpython/rev/05f0ffe4e0b3

----------

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

From report at bugs.python.org  Sun Jul 17 13:10:32 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 17 Jul 2011 11:10:32 +0000
Subject: [docs] [issue10403] Use "member" consistently
In-Reply-To: <1289623042.93.0.830099606418.issue10403@psf.upfronthosting.co.za>
Message-ID: <E1QiPF1-0001Dc-3g@dinsdale.python.org>


Roundup Robot <devnull at psf.upfronthosting.co.za> added the comment:

New changeset 3935a1fb1db2 by Senthil Kumaran in branch '2.7':
merge from 3.2 - Issue10403  - datetime module documentation changes based on review.
http://hg.python.org/cpython/rev/3935a1fb1db2

----------

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

From report at bugs.python.org  Sun Jul 17 13:11:10 2011
From: report at bugs.python.org (Senthil Kumaran)
Date: Sun, 17 Jul 2011 11:11:10 +0000
Subject: [docs] [issue10403] Use "member" consistently
In-Reply-To: <1289623042.93.0.830099606418.issue10403@psf.upfronthosting.co.za>
Message-ID: <1310901070.89.0.94501418418.issue10403@psf.upfronthosting.co.za>


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


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

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

From sandro.tosi at gmail.com  Sun Jul 17 15:46:42 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Sun, 17 Jul 2011 15:46:42 +0200
Subject: [docs] Bug Report
In-Reply-To: <4E1D0EDF.4050407@gmail.com>
References: <4E1D0EDF.4050407@gmail.com>
Message-ID: <CAPdtAj08fTYG9ZJJTn-8wTorRD6wuy6X47-8ZnzjUL1EkJ1v2w@mail.gmail.com>

Hello Rohan,

On Wed, Jul 13, 2011 at 05:19, Rohan Bavishi <rohan.bavishi95 at gmail.com> wrote:
> ?The math package in both Python 2.7 and Python 2.5 is reporting a strange
> error. The sqrt function does not return the correct value for
> 1695843602719359844. It returns an answer ending in 0 which is not possible
> and it returns the same answer for values above it. Kindly check if the same
> is happening ?with you.

This is not a bug reporting mailing list (if not related to
documentation). I suggest asking on python-list[1] your question. As a
side note, 1302245600.0 is the result returned by several calculators.

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

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

From report at bugs.python.org  Mon Jul 18 00:05:12 2011
From: report at bugs.python.org (Senthil Kumaran)
Date: Sun, 17 Jul 2011 22:05:12 +0000
Subject: [docs] [issue11468] Improve unittest basic example in the doc
In-Reply-To: <1299867342.41.0.388080450116.issue11468@psf.upfronthosting.co.za>
Message-ID: <1310940312.31.0.473185442402.issue11468@psf.upfronthosting.co.za>


Senthil Kumaran <senthil at uthcode.com> added the comment:

I would be +1 if the basic example also highlights setUp and tearDown methods. Those are useful ones for a new comer to know via an example snippet and not just with explanation.

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

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

From report at bugs.python.org  Mon Jul 18 00:33:49 2011
From: report at bugs.python.org (Senthil Kumaran)
Date: Sun, 17 Jul 2011 22:33:49 +0000
Subject: [docs] [issue12577] Misleading shutil.move docs regarding when
	os.rename is	used
In-Reply-To: <1310893161.81.0.334547060207.issue12577@psf.upfronthosting.co.za>
Message-ID: <1310942029.52.0.0641175790476.issue12577@psf.upfronthosting.co.za>


Senthil Kumaran <senthil at uthcode.com> added the comment:

Should information on Windows behavior, which you experienced be included too?

How about - 

It uses :func:`os.rename` to perform the move. If that fails, for example
because src and dst are on different filesystems or in case of Windows where rename cannot be done if dst exists, fallback to copying src (with :func:`copy2`) to the dst and then removing src.

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

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

From report at bugs.python.org  Mon Jul 18 00:44:38 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 17 Jul 2011 22:44:38 +0000
Subject: [docs] [issue12479] Add HTTPErrorProcessor class definition
In-Reply-To: <1309697619.94.0.838258559522.issue12479@psf.upfronthosting.co.za>
Message-ID: <E1Qia4j-0002QI-9p@dinsdale.python.org>


Roundup Robot <devnull at psf.upfronthosting.co.za> added the comment:

New changeset 8d64d47569cb by Senthil Kumaran in branch '3.2':
Fix closes Issue12479 - Add HTTPErrorProcessor class definition - Patch by Sandro Tosi
http://hg.python.org/cpython/rev/8d64d47569cb

New changeset b2125a6deb96 by Senthil Kumaran in branch 'default':
merge from 3.2 - Fix closes Issue12479 - Add HTTPErrorProcessor class definition - Patch by Sandro Tosi
http://hg.python.org/cpython/rev/b2125a6deb96

New changeset b9ae6be1874d by Senthil Kumaran in branch '2.7':
merge from 3.2 - Fix closes Issue12479 - Add HTTPErrorProcessor class definition - Patch by Sandro Tosi
http://hg.python.org/cpython/rev/b9ae6be1874d

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

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

From report at bugs.python.org  Mon Jul 18 01:19:12 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sun, 17 Jul 2011 23:19:12 +0000
Subject: [docs] [issue12478] Possible error in HTTPErrorProcessor
	documentation
In-Reply-To: <1309695268.0.0.0456155108685.issue12478@psf.upfronthosting.co.za>
Message-ID: <E1QiacA-0004VK-Sh@dinsdale.python.org>


Roundup Robot <devnull at psf.upfronthosting.co.za> added the comment:

New changeset 70983e8b114a by Senthil Kumaran in branch '3.2':
Fix closes Issue12478 - HTTPErrorProcess 's methods are http_response and https_response.
http://hg.python.org/cpython/rev/70983e8b114a

New changeset 04541e33364d by Senthil Kumaran in branch 'default':
merge from 3.2 - Fix closes Issue12478 - HTTPErrorProcess 's methods are http_response and https_response.
http://hg.python.org/cpython/rev/04541e33364d

New changeset edf238312baa by Senthil Kumaran in branch '2.7':
merge from 3.2 - Fix closes Issue12478 - HTTPErrorProcess 's methods are http_response and https_response.
http://hg.python.org/cpython/rev/edf238312baa

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

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

From report at bugs.python.org  Mon Jul 18 03:58:55 2011
From: report at bugs.python.org (Bharadwaj)
Date: Mon, 18 Jul 2011 01:58:55 +0000
Subject: [docs] [issue12524] change httplib docs POST example
In-Reply-To: <1310288732.05.0.896091983102.issue12524@psf.upfronthosting.co.za>
Message-ID: <1310954335.51.0.293530696314.issue12524@psf.upfronthosting.co.za>


Bharadwaj <barbi.bruce at gmail.com> added the comment:

Newbie here. Please be patient.

When I tried using the POST form in this page, I ran into minor issues.
1. The form returns a 302 to the actual issue page. Some other example with 200 may be better.
2. The params are a little weird, with '@' in the names. Might be confusing for newbies.
3. Form action param is '#', which is not a great example.

Please suggest if I should continue with this example or find a better one.

Code:
import http.client, urllib.parse
params = urllib.parse.urlencode({'@number': 12524, '@type': 'issue', '@action': 'show'})
headers = {"Content-type": "application/x-www-form-urlencoded",
           "Accept": "text/plain"}
conn = http.client.HTTPConnection("bugs.python.org")
conn.request("POST", "#", params, headers)
response = conn.getresponse()
print(response.status, response.reason)
data = response.read()
conn.close()
data
b'Redirecting to <a href="http://bugs.python.org/issue12524">http://bugs.python.org/issue12524</a>'

----------

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

From report at bugs.python.org  Mon Jul 18 10:27:11 2011
From: report at bugs.python.org (Catalin Iacob)
Date: Mon, 18 Jul 2011 08:27:11 +0000
Subject: [docs] [issue12577] Misleading shutil.move docs regarding when
	os.rename is	used
In-Reply-To: <1310893161.81.0.334547060207.issue12577@psf.upfronthosting.co.za>
Message-ID: <1310977631.79.0.214215494841.issue12577@psf.upfronthosting.co.za>


Catalin Iacob <iacobcatalin at gmail.com> added the comment:

Senthil's proposal in msg140543 has +1 from me.

----------

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

From report at bugs.python.org  Mon Jul 18 15:46:12 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 18 Jul 2011 13:46:12 +0000
Subject: [docs] [issue1626300] 'Installing Python Modules' does not work for
	Windows
Message-ID: <1310996772.26.0.978920105037.issue1626300@psf.upfronthosting.co.za>


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

> On Windows, scripts run with whatever name -- no extension or other
> extensions.
Thanks, this means that the docs can continue to say just ?pysetup3?, without ?.py?.

(I wonder how Windows manages to run the script without file extension!)

> I have tested this from both IDLE and command line.
You can run command-line scripts from IDLE?

Can you also comment on my proposed note about adding Scripts to PATH?

----------

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

From report at bugs.python.org  Mon Jul 18 16:03:46 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 18 Jul 2011 14:03:46 +0000
Subject: [docs] [issue12479] Add HTTPErrorProcessor class definition
In-Reply-To: <1309697619.94.0.838258559522.issue12479@psf.upfronthosting.co.za>
Message-ID: <1310997826.58.0.791442932058.issue12479@psf.upfronthosting.co.za>


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

It seems to me that the doc after the patch is barely more helpful.  It does not explain when and how one would see or use the class, nor what it does.

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

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

From report at bugs.python.org  Mon Jul 18 16:07:42 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 18 Jul 2011 14:07:42 +0000
Subject: [docs] [issue12479] Add HTTPErrorProcessor class definition
In-Reply-To: <1309697619.94.0.838258559522.issue12479@psf.upfronthosting.co.za>
Message-ID: <1310998062.17.0.320532219765.issue12479@psf.upfronthosting.co.za>


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

Ah, I see that the class is referenced earlier in the file, and that its methods come after.  I?d put the class definition just before the methods.  (I would even refactor the reST to use nested class/method combo, but that?s a minor markup cleanup, not a content improvement.)

----------

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

From report at bugs.python.org  Mon Jul 18 16:21:32 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 18 Jul 2011 14:21:32 +0000
Subject: [docs] [issue11468] Improve unittest basic example in the doc
In-Reply-To: <1299867342.41.0.388080450116.issue11468@psf.upfronthosting.co.za>
Message-ID: <1310998892.87.0.336969112059.issue11468@psf.upfronthosting.co.za>


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

I think there?s value in accepting the current patch as really basic example, and then see if the section about setting up and tearing down also has a very simple example.

----------

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

From report at bugs.python.org  Mon Jul 18 16:57:07 2011
From: report at bugs.python.org (Chris Lambacher)
Date: Mon, 18 Jul 2011 14:57:07 +0000
Subject: [docs] [issue1626300] 'Installing Python Modules' does not work for
	Windows
Message-ID: <1311001027.24.0.499221834073.issue1626300@psf.upfronthosting.co.za>


Chris Lambacher <chris at kateandchris.net> added the comment:

I don't think that is the default state. You need to add .py to the PATHEXT environment variable:
http://effbot.org/pyfaq/how-do-i-make-python-scripts-executable.htm

Maybe Terry did this at some point? My windows box certainly does not have it and I have 2.6 and 2.7 installed. I don't have a 3.x install so I can't check if that is new in 3.

----------
nosy: +lambacck

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

From report at bugs.python.org  Mon Jul 18 17:28:18 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Mon, 18 Jul 2011 15:28:18 +0000
Subject: [docs] [issue1626300] 'Installing Python Modules' does not work for
	Windows
Message-ID: <1311002898.51.0.674525056512.issue1626300@psf.upfronthosting.co.za>


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

I perhaps misunderstood your question. I ran files from the command line as as 'python whatever', not 'whatever' so only python would care about an extension. I do not have a file association to 'run' a file, with or without .py. I presume IDLE does same when one RUNs a file, except with pythonw.

----------

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

From report at bugs.python.org  Mon Jul 18 17:39:22 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 18 Jul 2011 15:39:22 +0000
Subject: [docs] [issue1626300] 'Installing Python Modules' does not work for
	Windows
Message-ID: <1311003562.45.0.47024284938.issue1626300@psf.upfronthosting.co.za>


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

The original bug is that the distutils docs use commands like ?python setup.py spam? all over the place, and they don?t typically work
> because the python executable is not in the path in the default
> install.  'setup.py install' will work since .py files are associated
> with python.exe
(quoted from the first message).  I added a note to instruct Windows users to mentally replace those commands with ?setup.py spam?.

Now my concern is about packaging: In a typical Windows install, can people run ?pysetup3 spam??

----------

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

From report at bugs.python.org  Mon Jul 18 17:49:42 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 18 Jul 2011 15:49:42 +0000
Subject: [docs] [issue12531] documentation index entries for * and **
In-Reply-To: <1310385823.58.0.152505903133.issue12531@psf.upfronthosting.co.za>
Message-ID: <1311004182.29.0.682166492885.issue12531@psf.upfronthosting.co.za>


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

> [...] If the syntax *expression appears in the function call,
> expression must evaluate to a sequence.

An iterable :)

----------
nosy: +eric.araujo -ericsnow, terry.reedy
versions:  -Python 2.7, Python 3.2

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

From report at bugs.python.org  Mon Jul 18 17:59:16 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 18 Jul 2011 15:59:16 +0000
Subject: [docs] [issue12531] documentation index entries for * and **
In-Reply-To: <1310385823.58.0.152505903133.issue12531@psf.upfronthosting.co.za>
Message-ID: <1311004756.09.0.049908966746.issue12531@psf.upfronthosting.co.za>


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


----------
nosy: +ericsnow, terry.reedy
versions: +Python 2.7, Python 3.2

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

From report at bugs.python.org  Mon Jul 18 18:52:59 2011
From: report at bugs.python.org (Daniel Stutzbach)
Date: Mon, 18 Jul 2011 16:52:59 +0000
Subject: [docs] [issue12434] Strengthen 2.7 io types warning
In-Reply-To: <1310807043.84.0.00492707140306.issue12434@psf.upfronthosting.co.za>
Message-ID: <CAMMy=OsUjGbpnEh1=HygOQxkf24=Dtpuz0f7UZ7NksRft9A4_w@mail.gmail.com>


Daniel Stutzbach <stutzbach at google.com> added the comment:

On Sat, Jul 16, 2011 at 2:04 AM, Eli Bendersky <report at bugs.python.org>wrote:

> Therefore, I propose to change this error message to:
>  "unicode argument expected, got '%s'"
>  as Terry suggested.
>

Sounds good to me.

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

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue12434>
_______________________________________
-------------- next part --------------
<div class="gmail_quote">On Sat, Jul 16, 2011 at 2:04 AM, Eli Bendersky <span dir="ltr">&lt;<a href="mailto:report at bugs.python.org">report at bugs.python.org</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
Therefore, I propose to change this error message to:<br>
??&quot;unicode argument expected, got &#39;%s&#39;&quot;<br>
??as Terry suggested.<br></blockquote><div><br></div><div>Sounds good to me.??</div></div><br>-- <br>Daniel Stutzbach<br>

From report at bugs.python.org  Mon Jul 18 19:08:59 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Mon, 18 Jul 2011 17:08:59 +0000
Subject: [docs] [issue1626300] 'Installing Python Modules' does not work for
	Windows
Message-ID: <1311008939.38.0.150963176446.issue1626300@psf.upfronthosting.co.za>


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

I went back and reread from the beginning, instead of merely answering the question you asked when adding me as nosy. More comments:

Windows file associations are so disfunctional that you should not depend on them being anything in particular. I nearly always open files from within applications (IDLE for python files) or with RightClick context menu when an entry specifies the app that will be used (as with 'Edit with Notepad++' (getting Python make such is another issue). The only way I can run from Command Prompt is to cd to the appropriate pythonxy directory and enter 'python full\path\to\file' (with stupid backslashes or 'python -m module' (which looks for module under /Lib). 

In XP, and I presume later, the term 'DOS box' is obsolete and I would delete it. The 'Command Prompt' app (with caps) is found in the Start/Accessories directory. So I would say "open a Command Prompt window (in Start/Accessories)"

Back to your message where you added me. I am not sure of the difference between 'local script' and 'global command'. I do not understand your proposed note, especially "*include link to relevant section of docs.python.org/using*.".

Script run without extensions when run with an explicit python command.
I was primed to answer this because someone recently, on the tracker or python-list, proposed to 'fix' a problem (wrongly) by adding a .py(o/w) extension check to determine if a file is Python code before running it.

I am not sure what 'or does the installer add .py?' could mean. The Windows installer? 'Add' to what? 

I realize that my answers may appear naive. I hope usefully so. I have used Windows since Win95 and have learned to focus, as described above, on what dependably works with minimal surprise. The extremely few 3rd party Python-based stuff I have installed has either come as a zipped library I could extract into site-packeges or as an independent app to be unzipped elsewhere or installed with a Windows-style installer. I have never used setup.py so no expert advice on its successor from me.

----------

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

From report at bugs.python.org  Mon Jul 18 19:21:06 2011
From: report at bugs.python.org (Chris Lambacher)
Date: Mon, 18 Jul 2011 17:21:06 +0000
Subject: [docs] [issue1626300] 'Installing Python Modules' does not work for
	Windows
Message-ID: <1311009666.5.0.152188388389.issue1626300@psf.upfronthosting.co.za>


Chris Lambacher <chris at kateandchris.net> added the comment:

> Now my concern is about packaging: In a typical Windows install, can people run ?pysetup3 spam??

The windows installer does not make any additions to the path so it is unlikely that "pysetup3 spam" will work.

There is http://www.python.org/dev/peps/pep-0397/ which addresses running scripts in a multi-version windows environment but I don't think that will help in this case. 

If you are running more than 1 version of windows there is simple statement that tells you how to install and have the install go to the right interpreter. You are almost best to have a shortcut that gives you a command prompt with the PATH variable correctly set to the desired python instance. That does not help the 2.x crowd or anyone before 3.3 :/

----------

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

From report at bugs.python.org  Mon Jul 18 19:39:35 2011
From: report at bugs.python.org (Chris Lambacher)
Date: Mon, 18 Jul 2011 17:39:35 +0000
Subject: [docs] [issue1626300] 'Installing Python Modules' does not work for
	Windows
Message-ID: <1311010774.87.0.584674474896.issue1626300@psf.upfronthosting.co.za>


Chris Lambacher <chris at kateandchris.net> added the comment:

> I am not sure of the difference between 'local script' and 'global command'

local script is the setup.py (or for that matter any other script in an arbitrary place in the filesystem. Global command is referring to something installed in %PYTHONINSTALLDIR%\scripts i.e. it is an installed command. This one operates on a specific version instance of python. I for instance have c:\python26\scripts\easy_install.exe and c:\python27\script\easy_install.exe and each of those operates on their own particular version. Neither are in my path. The current state is that I have to either put one of the scripts directories in my path or run easy_install with the full path. My understanding is that pysetup is a replacement for easy_install that will come with 3.3.

> I am not sure what 'or does the installer add .py?' could mean. The Windows installer? 'Add' to what? 

I was referring .py being added to the PATHEXT evironment variable. I think it is safe to say that has not happened and is likely a bad idea.

----------

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

From report at bugs.python.org  Mon Jul 18 21:14:08 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Mon, 18 Jul 2011 19:14:08 +0000
Subject: [docs] [issue12531] documentation index entries for * and **
In-Reply-To: <1310385823.58.0.152505903133.issue12531@psf.upfronthosting.co.za>
Message-ID: <1311016448.14.0.493114570589.issue12531@psf.upfronthosting.co.za>


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

I would not propose to do everything in one grand patch as it would be way too much to review all at once. A somewhat separate subissue is whether there should be however many separate issues over the next however many years or one master issue with multiple patches.

The existing patch is enough to review for now. It needs changes and should add everything needed just for * and **. And there may be some unwritten policy issues.

I agree that the directive for * should be moved as Eli says.
I think 'statement' should be changed to 'function calls', or maybe 'in function calls' or 'function call operator' for both * and **.
The same directives should be added to the tutorial at the top and middle of Tutorial 4.7.4 Unpacking Argument Lists.
The existing * and ** 'statement' directives for defs in both tutorial and reference should become 'function defs' (or 'definitions') or 'in def statement'.
The existing * 'operator' directive should be 'number multiplication' or 'number multiplication operator' or at least 'number operator'.
Perhaps it (and the following) should be duplicated in the tutorial.
A new * 'sequence repetition* directive should be added.
The existing ** 'operator' directive should be 'number exponentiation'.
New 'assigment' and 'import' directives are needed.

I think *all* the entries for a given symbol should be considered together so that they can be properly differentiated. We should minimize duplicates that appear like this -- 'statement, [1]' -- and such duplicates should refer to the *same* usage. 

Policy issues:

I think 'statement' should be reserved for statement keywords like def, class, etc. Things in statements should be at least qualified as 'in <specific> statement.

I see that plain 'operator' is currently used for most or all operators. I think they should at least be qualified as to category -- number operator, seqeunce operator, comparision operator, logic operator, etc. This might tell users all they need to know and would separate overloaded operators like '*'.

Both general suggestions follow other usages. Classes are specified as 'class in <modname>', not just 'class'. Functions are specified not just with '()' but also 'in <modname>' Expanding 'statement' to 'in <keyword> statement' or something would be in the same spirit. Methods are specified as '<class> method', not just 'method'. Operators should get the same differentiation with at least '<optype> operator' if not more detail.

[separate issue note: 'as' seems not to be indexed.]

Adding Georg as I am suggesting a deviation from certain precedents (and conformance to others).

----------
nosy: +georg.brandl
stage:  -> patch review

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

From report at bugs.python.org  Mon Jul 18 21:21:27 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Mon, 18 Jul 2011 19:21:27 +0000
Subject: [docs] [issue12531] documentation index entries for * and **
In-Reply-To: <1310385823.58.0.152505903133.issue12531@psf.upfronthosting.co.za>
Message-ID: <1311016887.57.0.681949350312.issue12531@psf.upfronthosting.co.za>


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

> expression must evaluate to a sequence.

To be clear, Eli quoted the doc correctly and Eric correctly suggested that 'sequence' needs to be updated to 'iterable' (in at least two places). Since the patch for this issue will be adding something just above, it could just as well make this change also.

----------

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

From report at bugs.python.org  Tue Jul 19 01:31:12 2011
From: report at bugs.python.org (Senthil Kumaran)
Date: Mon, 18 Jul 2011 23:31:12 +0000
Subject: [docs] [issue12479] Add HTTPErrorProcessor class definition
In-Reply-To: <1310998062.17.0.320532219765.issue12479@psf.upfronthosting.co.za>
Message-ID: <20110718233104.GB2599@mathmagic>


Senthil Kumaran <senthil at uthcode.com> added the comment:

On Mon, Jul 18, 2011 at 02:07:42PM +0000, ?ric Araujo wrote:
> I?d put the class definition just before the methods.  (I would even
> refactor the reST to use nested class/method combo...

This is a good suggestion. It would good to do some point in time soon.
Thanks!

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

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

From report at bugs.python.org  Tue Jul 19 02:06:05 2011
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 19 Jul 2011 00:06:05 +0000
Subject: [docs] [issue12577] Misleading shutil.move docs regarding when
	os.rename is	used
In-Reply-To: <1310893161.81.0.334547060207.issue12577@psf.upfronthosting.co.za>
Message-ID: <E1Qixp6-00057L-Aa@dinsdale.python.org>


Roundup Robot <devnull at psf.upfronthosting.co.za> added the comment:

New changeset 62048a6eb43c by Senthil Kumaran in branch '3.2':
Fix closes issue12577 - clarify shutil.move documentation. Patch suggestion by Catalin Iacob
http://hg.python.org/cpython/rev/62048a6eb43c

New changeset 912b97ee40a7 by Senthil Kumaran in branch 'default':
merge from 3.2 - Fix closes issue12577 - clarify shutil.move documentation. Patch suggestion by Catalin Iacob
http://hg.python.org/cpython/rev/912b97ee40a7

New changeset 33f09733612e by Senthil Kumaran in branch '2.7':
merge from 3.2 - Fix closes issue12577 - clarify shutil.move documentation. Patch suggestion by Catalin Iacob
http://hg.python.org/cpython/rev/33f09733612e

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

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

From report at bugs.python.org  Tue Jul 19 05:53:48 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Tue, 19 Jul 2011 03:53:48 +0000
Subject: [docs] [issue12434] Strengthen 2.7 io types warning
In-Reply-To: <CAMMy=OsUjGbpnEh1=HygOQxkf24=Dtpuz0f7UZ7NksRft9A4_w@mail.gmail.com>
Message-ID: <CAF-Rda_dSDDfBQKz3rr9akQbGo=0jj2sM+=j8WixbjFny9ziBA@mail.gmail.com>


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

> > Therefore, I propose to change this error message to:
> >  "unicode argument expected, got '%s'"
> >  as Terry suggested.
> >
>
> Sounds good to me.
>

Terry, what are your thoughts?
Can I commit the fix?

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

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue12434>
_______________________________________
-------------- next part --------------
<div dir="ltr"><br><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;"><div class="im">
&gt; Therefore, I propose to change this error message to:<br>
&gt; ??&quot;unicode argument expected, got &#39;%s&#39;&quot;<br>
&gt; ??as Terry suggested.<br>
&gt;<br>
<br>
</div>Sounds good to me.<br></blockquote><div><br>Terry, what are your thoughts?<br>Can I commit the fix?<br>??<br></div></div><br></div>

From report at bugs.python.org  Tue Jul 19 07:11:17 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Tue, 19 Jul 2011 05:11:17 +0000
Subject: [docs] [issue12434] Strengthen 2.7 io types warning
In-Reply-To: <1309288978.39.0.732754105333.issue12434@psf.upfronthosting.co.za>
Message-ID: <1311052277.02.0.160980436521.issue12434@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Tue Jul 19 07:11:20 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Tue, 19 Jul 2011 05:11:20 +0000
Subject: [docs] [issue12434] Strengthen 2.7 io types warning
In-Reply-To: <1309288978.39.0.732754105333.issue12434@psf.upfronthosting.co.za>
Message-ID: <1311052280.85.0.867540982502.issue12434@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Tue Jul 19 08:00:56 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Tue, 19 Jul 2011 06:00:56 +0000
Subject: [docs] [issue12434] Strengthen 2.7 io types warning
In-Reply-To: <1309288978.39.0.732754105333.issue12434@psf.upfronthosting.co.za>
Message-ID: <1311055256.83.0.20221926581.issue12434@psf.upfronthosting.co.za>


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

Yes, that would be great. It is better than my initial suggestion.

----------

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

From report at bugs.python.org  Tue Jul 19 15:05:59 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Tue, 19 Jul 2011 13:05:59 +0000
Subject: [docs] [issue12524] change httplib docs POST example
In-Reply-To: <1310288732.05.0.896091983102.issue12524@psf.upfronthosting.co.za>
Message-ID: <1311080759.9.0.489877165746.issue12524@psf.upfronthosting.co.za>


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

1. 3xx codes are as fine as 200, IIRC.

2. Agreed, Roundup as very strange form parameters and URIs in general, but that?s not something we can change.

3. Maybe the empty string would work?  (It?s a URI reference which means ?same URI as the resource where the form was found? IOW same page).


Alternate idea: use example.org.  People won?t be able to actually run the example, but is it really important?

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

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

From report at bugs.python.org  Tue Jul 19 18:04:50 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Tue, 19 Jul 2011 16:04:50 +0000
Subject: [docs] [issue11176] give more meaningful argument names in
	argparse	documentation
In-Reply-To: <1297352937.46.0.470038569364.issue11176@psf.upfronthosting.co.za>
Message-ID: <1311091490.17.0.389543780157.issue11176@psf.upfronthosting.co.za>


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

Hi Westley!  Do you still have time to work on this?

----------
keywords: +easy
nosy: +eric.araujo
versions: +Python 2.7, Python 3.2

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

From report at bugs.python.org  Tue Jul 19 20:04:50 2011
From: report at bugs.python.org (=?utf-8?q?Westley_Mart=C3=ADnez?=)
Date: Tue, 19 Jul 2011 18:04:50 +0000
Subject: [docs] [issue11176] give more meaningful argument names in
	argparse	documentation
In-Reply-To: <1297352937.46.0.470038569364.issue11176@psf.upfronthosting.co.za>
Message-ID: <1311098690.15.0.889110973467.issue11176@psf.upfronthosting.co.za>


Westley Mart?nez <anikom15 at gmail.com> added the comment:

I worked on this some time ago; the problem was the size of the documentation, i.e. it was difficult to stay consistent.  Do I have time for this?  Yes, but I wouldn't get it done anytime soon, and the results could be anywhere from good to bad.  As it stands, the documentation is fairly good, so I don't think it's imperative to fix it.

----------

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

From report at bugs.python.org  Wed Jul 20 02:06:30 2011
From: report at bugs.python.org (Senthil Kumaran)
Date: Wed, 20 Jul 2011 00:06:30 +0000
Subject: [docs] [issue12524] change httplib docs POST example
In-Reply-To: <1311080759.9.0.489877165746.issue12524@psf.upfronthosting.co.za>
Message-ID: <20110720000620.GA2804@mathmagic>


Senthil Kumaran <senthil at uthcode.com> added the comment:

Hello Eric,

On Tue, Jul 19, 2011 at 01:05:59PM +0000, ?ric Araujo wrote:

> Alternate idea: use example.org.  People won?t be able to actually
> run the example, but is it really important?

The whole idea is present a usable example. Please don't suggest
unusable example. example.org does not support POST.

----------

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

From report at bugs.python.org  Wed Jul 20 05:25:10 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Wed, 20 Jul 2011 03:25:10 +0000
Subject: [docs] [issue12531] documentation index entries for * and **
In-Reply-To: <1310385823.58.0.152505903133.issue12531@psf.upfronthosting.co.za>
Message-ID: <1311132310.63.0.0469254486656.issue12531@psf.upfronthosting.co.za>


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

Peter, would you like to submit a corrected patch?

----------

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

From report at bugs.python.org  Wed Jul 20 09:55:45 2011
From: report at bugs.python.org (Bharadwaj)
Date: Wed, 20 Jul 2011 07:55:45 +0000
Subject: [docs] [issue12524] change httplib docs POST example
In-Reply-To: <1310288732.05.0.896091983102.issue12524@psf.upfronthosting.co.za>
Message-ID: <1311148545.27.0.867658510894.issue12524@psf.upfronthosting.co.za>


Changes by Bharadwaj <barbi.bruce at gmail.com>:


Added file: http://bugs.python.org/file22704/http_example2.diff

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

From report at bugs.python.org  Wed Jul 20 16:02:53 2011
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 20 Jul 2011 14:02:53 +0000
Subject: [docs] [issue12524] change httplib docs POST example
In-Reply-To: <1310288732.05.0.896091983102.issue12524@psf.upfronthosting.co.za>
Message-ID: <E1QjXMQ-00081h-VT@dinsdale.python.org>


Roundup Robot <devnull at psf.upfronthosting.co.za> added the comment:

New changeset ab4d403cb0c0 by Senthil Kumaran in branch '3.2':
Fix closes issue12524 - update http.client POST example with a working example.
http://hg.python.org/cpython/rev/ab4d403cb0c0

New changeset bc71fff2b6c7 by Senthil Kumaran in branch 'default':
merge from 3.2 - Fix closes issue12524 - update http.client POST example with a working example.
http://hg.python.org/cpython/rev/bc71fff2b6c7

New changeset b754641a429f by Senthil Kumaran in branch '2.7':
merge from 3.2 - Fix closes issue12524 - update http.client POST example with a working example. - Patch contributed by Bharadwaj
http://hg.python.org/cpython/rev/b754641a429f

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

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

From report at bugs.python.org  Wed Jul 20 16:03:55 2011
From: report at bugs.python.org (Senthil Kumaran)
Date: Wed, 20 Jul 2011 14:03:55 +0000
Subject: [docs] [issue12524] change httplib docs POST example
In-Reply-To: <1310288732.05.0.896091983102.issue12524@psf.upfronthosting.co.za>
Message-ID: <1311170635.86.0.133878125817.issue12524@psf.upfronthosting.co.za>


Senthil Kumaran <senthil at uthcode.com> added the comment:

Thanks for the patch, Bharadwaj.

----------

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

From report at bugs.python.org  Wed Jul 20 17:00:57 2011
From: report at bugs.python.org (Christoph Schindler)
Date: Wed, 20 Jul 2011 15:00:57 +0000
Subject: [docs] [issue12594] Docs for py3k still refer to "MacPython 2.5
	folder"
In-Reply-To: <1311174057.47.0.56455855185.issue12594@psf.upfronthosting.co.za>
Message-ID: <1311174057.47.0.56455855185.issue12594@psf.upfronthosting.co.za>


New submission from Christoph Schindler <hop at 30hopsmax.at>:

In http://docs.python.org/py3k/using/mac.html#getting-and-installing-macpython and http://docs.python.org/py3k/using/mac.html#distributing-python-applications-on-the-mac .

----------
assignee: docs at python
components: Documentation
messages: 140744
nosy: docs at python, hop
priority: normal
severity: normal
status: open
title: Docs for py3k still refer to "MacPython 2.5 folder"
versions: Python 3.1, Python 3.2

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

From report at bugs.python.org  Wed Jul 20 17:11:52 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 20 Jul 2011 15:11:52 +0000
Subject: [docs] [issue11176] give more meaningful argument names in
	argparse	documentation
In-Reply-To: <1297352937.46.0.470038569364.issue11176@psf.upfronthosting.co.za>
Message-ID: <1311174712.72.0.487859227279.issue11176@psf.upfronthosting.co.za>


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

> I worked on this some time ago; the problem was the size of the
> documentation, i.e. it was difficult to stay consistent.
I think it?s okay to improve the docs one patch at a time, starting with the simple example referenced in the first message in this bug report, and gradually improving other sections.  Do you have a diff with your work, so that your efforts can serve as a base for someone else?

> Do I have time for this?  Yes, but I wouldn't get it done anytime
> soon, and the results could be anywhere from good to bad.
That?s why we do reviews :)  It?s okay if you don?t have time, I?m interested in working on this some time in the future.

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

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

From report at bugs.python.org  Wed Jul 20 20:53:00 2011
From: report at bugs.python.org (Ned Deily)
Date: Wed, 20 Jul 2011 18:53:00 +0000
Subject: [docs] [issue12594] Docs for py3k still refer to "MacPython 2.5
	folder"
In-Reply-To: <1311174057.47.0.56455855185.issue12594@psf.upfronthosting.co.za>
Message-ID: <1311187980.89.0.299078055062.issue12594@psf.upfronthosting.co.za>


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

Thanks for the report.  The whole "Using Python on a Macintosh" section is very out-of-date and needs a major update.

----------
assignee: docs at python -> ned.deily
nosy: +ned.deily
stage:  -> needs patch
versions: +Python 2.7, Python 3.3 -Python 3.1

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

From report at bugs.python.org  Thu Jul 21 06:21:26 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 21 Jul 2011 04:21:26 +0000
Subject: [docs] [issue12204] str.upper converts to title
In-Reply-To: <1306644560.56.0.146552718337.issue12204@psf.upfronthosting.co.za>
Message-ID: <1311222086.58.0.0166383380022.issue12204@psf.upfronthosting.co.za>


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

Here's a patch.
I don't think it's necessary to update the docstring.

----------
assignee: docs at python -> ezio.melotti
keywords: +patch
stage:  -> commit review
Added file: http://bugs.python.org/file22708/issue12204.diff

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

From report at bugs.python.org  Thu Jul 21 06:54:56 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 21 Jul 2011 04:54:56 +0000
Subject: [docs] [issue12204] str.upper converts to title
In-Reply-To: <1306644560.56.0.146552718337.issue12204@psf.upfronthosting.co.za>
Message-ID: <1311224096.44.0.973299842307.issue12204@psf.upfronthosting.co.za>


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

New patch that factors out the definition of cased characters adding it to a footnote.

----------
Added file: http://bugs.python.org/file22709/issue12204-2.diff

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

From report at bugs.python.org  Thu Jul 21 07:08:31 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 21 Jul 2011 05:08:31 +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: <1311224911.57.0.650639754637.issue11975@psf.upfronthosting.co.za>


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

To distinguish the 'int' in functions.rst from the one in stdtypes.rst (if it works...).

----------

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

From report at bugs.python.org  Thu Jul 21 07:28:54 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 21 Jul 2011 05:28:54 +0000
Subject: [docs] [issue12298] Sphinx glitch in library/functions
In-Reply-To: <1307635612.57.0.782200385704.issue12298@psf.upfronthosting.co.za>
Message-ID: <1311226134.71.0.0488993044867.issue12298@psf.upfronthosting.co.za>


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


----------
keywords: +easy
stage:  -> needs patch

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

From report at bugs.python.org  Thu Jul 21 07:58:37 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 21 Jul 2011 05:58:37 +0000
Subject: [docs] [issue11363] Curses - add missing functions to doc
In-Reply-To: <1299005402.55.0.443028099437.issue11363@psf.upfronthosting.co.za>
Message-ID: <1311227917.56.0.460914870806.issue11363@psf.upfronthosting.co.za>


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

FWIW the typo has been fixed in 13c9b93e97ad.
If the example is failing another issue should be created.

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

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

From report at bugs.python.org  Thu Jul 21 08:39:59 2011
From: report at bugs.python.org (Roundup Robot)
Date: Thu, 21 Jul 2011 06:39:59 +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: <E1QjmvN-0005WW-Gs@dinsdale.python.org>


Roundup Robot <devnull at psf.upfronthosting.co.za> added the comment:

New changeset 79d2682c4fc5 by Ezio Melotti in branch '3.2':
#11435: link to the correct branch.
http://hg.python.org/cpython/rev/79d2682c4fc5

New changeset 3028b5ab92c0 by Ezio Melotti in branch 'default':
#11435: dummy merge with 3.2.
http://hg.python.org/cpython/rev/3028b5ab92c0

----------

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

From report at bugs.python.org  Thu Jul 21 08:42:07 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 21 Jul 2011 06:42:07 +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: <1311230527.47.0.74314057108.issue11435@psf.upfronthosting.co.za>


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

I fixed the URL in 3.2.

> The 2.7 docs link to the Subversion repo.  Can I update them?

2.7 doesn't have the source directive, do you want to replace all the svn links manually?
If so, either reopen this issue or create a new one.

----------

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

From report at bugs.python.org  Thu Jul 21 11:33:42 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Thu, 21 Jul 2011 09:33:42 +0000
Subject: [docs] [issue11669] Clarify Lang Ref "Compound statements" footnote
In-Reply-To: <1301042574.67.0.975748752077.issue11669@psf.upfronthosting.co.za>
Message-ID: <1311240822.71.0.657665339867.issue11669@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Thu Jul 21 13:57:06 2011
From: report at bugs.python.org (Nick Coghlan)
Date: Thu, 21 Jul 2011 11:57:06 +0000
Subject: [docs] [issue12602] Missing using docs cross-references
In-Reply-To: <1311249393.53.0.190511112739.issue12602@psf.upfronthosting.co.za>
Message-ID: <1311249426.14.0.91773769342.issue12602@psf.upfronthosting.co.za>


Changes by Nick Coghlan <ncoghlan at gmail.com>:


----------
assignee:  -> docs at python
components: +Documentation
nosy: +docs at python
versions: +Python 2.7, Python 3.2, Python 3.3

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

From report at bugs.python.org  Thu Jul 21 14:10:47 2011
From: report at bugs.python.org (Nick Coghlan)
Date: Thu, 21 Jul 2011 12:10:47 +0000
Subject: [docs] [issue12602] Missing using docs cross-references
In-Reply-To: <1311249426.14.0.91773769342.issue12602@psf.upfronthosting.co.za>
Message-ID: <CADiSq7d+aaKSZGeHTqg3f_71poHZMZjZNoTK6qwALyceZEWcNw@mail.gmail.com>


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

Should also be an outgoing link to http://bugs.python.org/issue1739468
from the <script> entry.

----------

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

From report at bugs.python.org  Thu Jul 21 19:04:57 2011
From: report at bugs.python.org (Adam Woodbeck)
Date: Thu, 21 Jul 2011 17:04:57 +0000
Subject: [docs] [issue10503] os.getuid() documentation should be clear on
	what kind	of uid it is referring
In-Reply-To: <1290430871.92.0.135823537975.issue10503@psf.upfronthosting.co.za>
Message-ID: <1311267897.81.0.691930767085.issue10503@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/issue10503>
_______________________________________

From report at bugs.python.org  Thu Jul 21 19:10:05 2011
From: report at bugs.python.org (Adam Woodbeck)
Date: Thu, 21 Jul 2011 17:10:05 +0000
Subject: [docs] [issue12436] Provide reference to detailed installation
	instructions
In-Reply-To: <1309305395.29.0.101516779086.issue12436@psf.upfronthosting.co.za>
Message-ID: <1311268205.45.0.419021383229.issue12436@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/issue12436>
_______________________________________

From report at bugs.python.org  Fri Jul 22 01:50:02 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 21 Jul 2011 23:50: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: <1311292202.22.0.698049978668.issue11975@psf.upfronthosting.co.za>


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

Georg, could index directives be used to create link targets?  (see http://bugs.python.org/issue11975#msg137447)

----------

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

From report at bugs.python.org  Fri Jul 22 01:51:33 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Thu, 21 Jul 2011 23:51:33 +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: <1311292293.56.0.867387856461.issue11435@psf.upfronthosting.co.za>


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

Thanks for the commit, I intended to do it these days.

For 2.7, I was indeed talking about updated all manual links.  sed is my friend :)

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

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

From report at bugs.python.org  Fri Jul 22 02:53:59 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 22 Jul 2011 00:53:59 +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: <1311296039.29.0.174554739406.issue11435@psf.upfronthosting.co.za>


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

Georg or Benjamin: The PEP/documents/scripts used for releases should also mention/edit the version in Doc/tools/sphinxext/pyspecific.py.

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

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

From report at bugs.python.org  Fri Jul 22 02:59:04 2011
From: report at bugs.python.org (Antoine Pitrou)
Date: Fri, 22 Jul 2011 00:59:04 +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: <1311296344.97.0.327425416391.issue11435@psf.upfronthosting.co.za>


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


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

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

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


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

Patch looks good, with one issue: I?ve never encountered ?cased character? before, is it an accepted term or an invention in our docs?

----------

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

From report at bugs.python.org  Fri Jul 22 03:51:15 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Fri, 22 Jul 2011 01:51:15 +0000
Subject: [docs] [issue12204] str.upper converts to title
In-Reply-To: <1306644560.56.0.146552718337.issue12204@psf.upfronthosting.co.za>
Message-ID: <1311299475.3.0.701056347454.issue12204@psf.upfronthosting.co.za>


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

I think it's an invention, but its meaning is quite clear to me.

----------

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

From report at bugs.python.org  Fri Jul 22 13:37:24 2011
From: report at bugs.python.org (Myrosia Dzikovska)
Date: Fri, 22 Jul 2011 11:37:24 +0000
Subject: [docs] [issue10026] xml.dom.pulldom strange behavior
In-Reply-To: <1286273854.3.0.24375174829.issue10026@psf.upfronthosting.co.za>
Message-ID: <1311334644.39.0.965510017606.issue10026@psf.upfronthosting.co.za>


Myrosia Dzikovska <myrosia at gmail.com> added the comment:

I have the same problem, and I tried the solution suggested in here, namely expanding the node at END_ELEMENT. It does not work, raising the following exception:

Traceback (most recent call last):
  File "/group/project/onrbee/data/beetle2-eval-09/annotation_tools/logTools/add_start_times.py", line 163, in <module>
    main(sys.argv[1:])
  File "/group/project/onrbee/data/beetle2-eval-09/annotation_tools/logTools/add_start_times.py", line 130, in main
    events.expandNode(node)
  File "/usr/lib/python2.6/site-packages/_xmlplus/dom/pulldom.py", line 248, in expandNode
    parents[-1].appendChild(cur_node)
IndexError: list index out of range


The code fragment was:

  events = xml.dom.pulldom.parse( outName )
    for (event,node) in events:
        if (event == xml.dom.pulldom.END_ELEMENT) and (node.tagName == "message"):
             events.expandNode(node)

----------
nosy: +Myrosia.Dzikovska

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

From report at bugs.python.org  Fri Jul 22 13:40:07 2011
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 22 Jul 2011 11:40:07 +0000
Subject: [docs] [issue12434] Strengthen 2.7 io types warning
In-Reply-To: <1309288978.39.0.732754105333.issue12434@psf.upfronthosting.co.za>
Message-ID: <E1QkE5N-0003H3-Vf@dinsdale.python.org>


Roundup Robot <devnull at psf.upfronthosting.co.za> added the comment:

New changeset 0752215f9f91 by Eli Bendersky in branch '2.7':
Issue #12434: make StringIO.write error message consistent with Python 2.7 nomenclature
http://hg.python.org/cpython/rev/0752215f9f91

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

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

From report at bugs.python.org  Fri Jul 22 13:41:20 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Fri, 22 Jul 2011 11:41:20 +0000
Subject: [docs] [issue12434] Strengthen 2.7 io types warning
In-Reply-To: <1309288978.39.0.732754105333.issue12434@psf.upfronthosting.co.za>
Message-ID: <1311334880.32.0.17358081945.issue12434@psf.upfronthosting.co.za>


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


----------
resolution:  -> fixed
status: open -> closed
versions:  -Python 2.7

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

From report at bugs.python.org  Fri Jul 22 16:22:05 2011
From: report at bugs.python.org (Adam Woodbeck)
Date: Fri, 22 Jul 2011 14:22:05 +0000
Subject: [docs] [issue12436] Provide reference to detailed installation
	instructions
In-Reply-To: <1309305395.29.0.101516779086.issue12436@psf.upfronthosting.co.za>
Message-ID: <1311344525.54.0.39434488756.issue12436@psf.upfronthosting.co.za>


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

So what we're looking for is comprehensive HOWTOs for installing and running Python on Windows, OSX and Linux to be added to http://docs.python.org/howto/index.html?

----------

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

From report at bugs.python.org  Fri Jul 22 17:09:37 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 22 Jul 2011 15:09:37 +0000
Subject: [docs] [issue12436] Provide reference to detailed installation
	instructions
In-Reply-To: <1309305395.29.0.101516779086.issue12436@psf.upfronthosting.co.za>
Message-ID: <1311347377.44.0.610013535704.issue12436@psf.upfronthosting.co.za>


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

IMO we don?t need HOWTOs that duplicate existing docs, but we may need additions to the existing tutorial and ?using? docs.  See http://bugs.python.org/issue12436#msg140141

----------

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

From report at bugs.python.org  Fri Jul 22 21:45:42 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Fri, 22 Jul 2011 19:45:42 +0000
Subject: [docs] [issue10436] tarfile.extractfile in "r|" stream mode fails
	with	filenames or members from getmembers()
In-Reply-To: <1289931464.79.0.618120236196.issue10436@psf.upfronthosting.co.za>
Message-ID: <1311363942.2.0.85051413136.issue10436@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/issue10436>
_______________________________________

From report at bugs.python.org  Fri Jul 22 23:27:29 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 22 Jul 2011 21:27:29 +0000
Subject: [docs] [issue12602] Missing using docs cross-references
In-Reply-To: <1311249393.53.0.190511112739.issue12602@psf.upfronthosting.co.za>
Message-ID: <1311370049.18.0.455639801012.issue12602@psf.upfronthosting.co.za>


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


----------
assignee: docs at python -> 
keywords: +easy
nosy: +eric.araujo
stage:  -> needs patch

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

From report at bugs.python.org  Sat Jul 23 03:39:58 2011
From: report at bugs.python.org (py.user)
Date: Sat, 23 Jul 2011 01:39:58 +0000
Subject: [docs] [issue12617] Mutable Sequence Type can work not only with
	iterable in	slice[i:j] = t
In-Reply-To: <1311385198.6.0.560721842501.issue12617@psf.upfronthosting.co.za>
Message-ID: <1311385198.6.0.560721842501.issue12617@psf.upfronthosting.co.za>


New submission from py.user <port139 at yandex.ru>:

1)
4.6.4 Mutable Sequence Types

| s[i:j] = t |  slice of s from i to j is replaced |
|            |  by the contents of the iterable t  |


>>> lst = list('abc')
>>> barr = bytearray(b'abc')
>>> lst[:1] = 4
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: can only assign an iterable
>>> barr[:1] = 4
>>> barr
bytearray(b'\x00\x00\x00\x00bc')
>>>

there is no info about this feature in the documentation

2)
4.6.4 Mutable Sequence Types

| s.extend(x) |  same as s[len(s):len(s)] = x |

>>> lst = list('abc')
>>> barr = bytearray(b'abc')
>>> lst.extend(4)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: 'int' object is not iterable
>>> barr.extend(4)
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: 'int' object is not iterable
>>> lst[len(lst):len(lst)] = 4
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: can only assign an iterable
>>> barr[len(barr):len(barr)] = 4
>>> barr
bytearray(b'abc\x00\x00\x00\x00')
>>>

barr.extend(x)  !=  barr[len(barr):len(barr)] = x

----------
assignee: docs at python
components: Documentation, Interpreter Core
messages: 140924
nosy: docs at python, py.user
priority: normal
severity: normal
status: open
title: Mutable Sequence Type can work not only with iterable in slice[i:j] = t
type: behavior
versions: Python 3.1

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

From report at bugs.python.org  Sat Jul 23 03:58:57 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Sat, 23 Jul 2011 01:58:57 +0000
Subject: [docs] [issue12617] Mutable Sequence Type can work not only with
	iterable in	slice[i:j] = t
In-Reply-To: <1311385198.6.0.560721842501.issue12617@psf.upfronthosting.co.za>
Message-ID: <1311386337.83.0.116399420754.issue12617@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Jul 23 04:50:57 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Sat, 23 Jul 2011 02:50:57 +0000
Subject: [docs] [issue12617] Mutable Sequence Type can work not only with
	iterable in	slice[i:j] = t
In-Reply-To: <1311385198.6.0.560721842501.issue12617@psf.upfronthosting.co.za>
Message-ID: <1311389456.78.0.584021670451.issue12617@psf.upfronthosting.co.za>


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

To my eye, this looks like a bytearray API bug in the bytearray implementation.  ISTM, the rhs of a slice assignment needs to be restricted to iterable inputs.

I'm marking this as low priority because the documented behaviors (i.e. normal slice assignment from an iterable) appear to be working fine.  So, there is no rush to take away the gratuitous API extension that accepts an integer input where a slice is usually expected.  The extension is not entirely harmless though -- we do lose the error-checking for the common mistake of writing s[i:j]=x instead of s[i:j]=[x].

----------
nosy: +rhettinger
priority: normal -> low

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

From darren.yin at gmail.com  Mon Jul 18 10:05:46 2011
From: darren.yin at gmail.com (Darren Yin)
Date: Mon, 18 Jul 2011 01:05:46 -0700
Subject: [docs] missing "a"
Message-ID: <CAPWDJtVC_jN+BvPFMBNRJomxQLfS2R28ixz3Z1EKhNdirpqd0A@mail.gmail.com>

http://docs.python.org/howto/doanddont.html#from-module-import-name1-name2

right now:
"The reason it is usually bad idea is because you suddenly..."

possible correction:
"The reason it is usually *a* bad idea is because you suddenly..."

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

From mike at potatolondon.com  Mon Jul 18 16:19:15 2011
From: mike at potatolondon.com (Mike MacCana)
Date: Mon, 18 Jul 2011 15:19:15 +0100
Subject: [docs] English trans fix for urllib docs
Message-ID: <CAP8_LBGPW2rYPdD4Kh2OYqb2FppM8KC_CGG5j_riE-BdDqhYdQ@mail.gmail.com>

Hi folks,

http://docs.python.org/library/urllib.html currently reads:

Warning: When opening HTTPS URLs, it is not attempted to validate the
server certificate. Use at your own risk!

In English you'd normally use 'does not attempt to' rather than 'it is
not attempted to'. Suggest:

Warning: When opening HTTPS URLs, urllib does not attempt?to validate
the server certificate. Use it at your own risk!

Cheers,

Mike
--
Mike MacCana
p.ota.to

From gencoyilmaz at gmail.com  Mon Jul 18 17:55:15 2011
From: gencoyilmaz at gmail.com (Genco Yilmaz)
Date: Mon, 18 Jul 2011 17:55:15 +0200
Subject: [docs] object attribute error
Message-ID: <CA+wXseB4WzY+xXEfKSkWXWFSaW2R4kw7gbvJ180C9FjjMpS+xA@mail.gmail.com>

Hi there,
   I think there is a small mistake at the following url and snippet I
added. the last line
"data = urllib2.open(full_url)"  is giving attribute error, I think it must
be urllib2.urlopen(full_url) right?


thanks a lot


URL:
http://docs.python.org/howto/urllib2.html


ERROR SECTION:

>>> import urllib2>>> import urllib>>> data = {}>>> data['name'] = 'Somebody Here'>>> data['location'] = 'Northampton'>>> data['language'] = 'Python'>>> url_values = urllib.urlencode(data)>>> print url_valuesname=Somebody+Here&language=Python&location=Northampton>>> url = 'http://www.example.com/example.cgi'>>> full_url = url + '?' + url_values>>> data = urllib2.open(full_url)
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20110718/2a5443e0/attachment-0001.html>

From jay at jaydresser.us  Fri Jul 22 02:17:19 2011
From: jay at jaydresser.us (Jay Dresser)
Date: Thu, 21 Jul 2011 17:17:19 -0700
Subject: [docs] Minor doc bug
Message-ID: <CAApUq=WsHbDt8wniLsOvFo-u-M_5BACP4e7=0UABifcg_7ooaA@mail.gmail.com>

http://docs.python.org/py3k/whatsnew/3.2.html#optimizations

    "String to integer conversions now work two ?digits? at a time, reducing
the number of division and modulo operations."

String to integer uses multiplication.   Integer to string uses division and
modulo.

I'm not sure what you meant, but since division is more costly than
multiplication, I suspect you meant
    "Integer to string conversions now work two ?digits? at a time, reducing
the number of division and modulo operations."
(doing modulo 100 instead of modulo 10)
I could be wrong since the fractional part of floating point numbers would
use division (but not modulo) for string to integer.

-- 
Jay Dresser, jay at jaydresser.us
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20110721/01b68015/attachment-0001.html>

From jeverling at gmail.com  Fri Jul 22 18:12:30 2011
From: jeverling at gmail.com (Jesaja Everling)
Date: Fri, 22 Jul 2011 18:12:30 +0200
Subject: [docs] Description of 'secure' argument for
 logging.handlers.SMTPHandler isn't up to date
Message-ID: <CAG4oqp1ZDJoArkXT3U6bqwJtrqiVSTdC45-MnuHAvJ_sAT5iKQ@mail.gmail.com>

Hi,

the docs for logging.handlers.SMTPHandler are not up to date.

Docs:
http://docs.python.org/library/logging.handlers.html#logging.handlers.SMTPHandler

"If secure is True, then the handler will attempt to use TLS for the
email transmission.".


Docstring:
http://hg.python.org/cpython/file/c6e63c67efd5/Lib/logging/handlers.py#l833

"To specify the use of a secure protocol (TLS), pass in a tuple for
the secure argument.
This will only be used when authentication credentials are supplied.
The tuple will be either an empty tuple, or a single-value tuple with
the name of a keyfile,
or a 2-value tuple with the names of the keyfile and certificate file.
(This tuple is passed to the `starttls` method)."

Just in case nobody noticed this before.

Best Regards,

Jesaja Everling

From Brett.Rasmussen at inl.gov  Sat Jul 23 00:33:35 2011
From: Brett.Rasmussen at inl.gov (Brett D Rasmussen)
Date: Fri, 22 Jul 2011 16:33:35 -0600
Subject: [docs] Possible Python string.find() documentation error
Message-ID: <OF13E05822.B3598A87-ON872578D5.007BECE9-872578D5.007BECEE@inel.gov>

An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20110722/e8f336de/attachment.html>

From georg at python.org  Sat Jul 23 08:01:17 2011
From: georg at python.org (Georg Brandl)
Date: Sat, 23 Jul 2011 08:01:17 +0200
Subject: [docs] Possible Python string.find() documentation error
In-Reply-To: <OF13E05822.B3598A87-ON872578D5.007BECE9-872578D5.007BECEE@inel.gov>
References: <OF13E05822.B3598A87-ON872578D5.007BECE9-872578D5.007BECEE@inel.gov>
Message-ID: <4E2A63AD.4030907@python.org>

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Am 23.07.2011 00:33, schrieb Brett D Rasmussen:
> 
> Hello.
> 
> The web page at:  http://docs.python.org/library/string.html
> 
> contains the following entry
> 
> string.find(/s/, /sub/[, /start/[, /end/]])? 
> <http://docs.python.org/library/string.html#string.find> Return the lowest
> index in /s/ where the substring /sub/ is found such that /sub/ is wholly
> contained in s[start:end]. Return -1 on failure. Defaults for /start/ and
> /end/ and interpretation of negative values is the same as for slices.
> 
> I believe that the first find() parameter should be removed (i.e. "s").
> 
> The web page at: http://docs.python.org/library/stdtypes.html contains the
> text
> 
> str.find(/sub/[, /start/[, /end/]])? 
> <http://docs.python.org/library/stdtypes.html#str.find>
> 
> Return the lowest index in the string where substring /sub/ is found, such 
> that /sub/ is contained in the slice s[start:end]. Optional arguments /start/
> and /end/ are interpreted as in slice notation. Return -1 if /sub/ is not
> found.
> 
> where the .find method does not include the "s" parameter.
> 
> 
> (Code testing shows that a string.find() call expects one 'search-target'
> string (i.e. sub)  )

Hi Brett,

the "string.find" entry describes the (deprecated) function find() in the string
module, not the method of the string type, so the description is correct there.

cheers,
Georg
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.17 (GNU/Linux)

iEYEARECAAYFAk4qY6wACgkQN9GcIYhpnLAXDgCfW+Swok/Xj91V7bq9k3JaAZ1L
wuwAni8Spi/EUc1EmvCFQw75J90SmbVD
=atYt
-----END PGP SIGNATURE-----

From georg at python.org  Sat Jul 23 08:01:50 2011
From: georg at python.org (Georg Brandl)
Date: Sat, 23 Jul 2011 08:01:50 +0200
Subject: [docs] missing "a"
In-Reply-To: <CAPWDJtVC_jN+BvPFMBNRJomxQLfS2R28ixz3Z1EKhNdirpqd0A@mail.gmail.com>
References: <CAPWDJtVC_jN+BvPFMBNRJomxQLfS2R28ixz3Z1EKhNdirpqd0A@mail.gmail.com>
Message-ID: <4E2A63CE.8020202@python.org>

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Am 18.07.2011 10:05, schrieb Darren Yin:
> http://docs.python.org/howto/doanddont.html#from-module-import-name1-name2
> 
> right now: "The reason it is usually bad idea is because you suddenly..."
> 
> possible correction: "The reason it is usually *a* bad idea is because you
> suddenly..."

Hi Darren,

This is fixed now, thanks.

Georg
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.17 (GNU/Linux)

iEYEARECAAYFAk4qY8sACgkQN9GcIYhpnLBbzACgkcc6HWZ7HsSCvh4NwJiR1258
czsAoIyfbwoetqsr1N7C5fT39hhS8XhK
=mofO
-----END PGP SIGNATURE-----

From georg at python.org  Sat Jul 23 08:06:37 2011
From: georg at python.org (Georg Brandl)
Date: Sat, 23 Jul 2011 08:06:37 +0200
Subject: [docs] object attribute error
In-Reply-To: <CA+wXseB4WzY+xXEfKSkWXWFSaW2R4kw7gbvJ180C9FjjMpS+xA@mail.gmail.com>
References: <CA+wXseB4WzY+xXEfKSkWXWFSaW2R4kw7gbvJ180C9FjjMpS+xA@mail.gmail.com>
Message-ID: <4E2A64ED.8000309@python.org>

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Am 18.07.2011 17:55, schrieb Genco Yilmaz:
> Hi there, I think there is a small mistake at the following url and snippet I
> added. the last line "data = urllib2.open(full_url)"  is giving attribute
> error, I think it must be urllib2.urlopen(full_url) right?
> 
> 
> thanks a lot
> 
> 
> URL: http://docs.python.org/howto/urllib2.html

Indeed. Thanks for the report, this is fixed now.

Georg
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2.0.17 (GNU/Linux)

iEYEARECAAYFAk4qZOwACgkQN9GcIYhpnLBXcwCeNlmRTRAvj1cKWhsPGXNpe+gt
B5MAniHwXOLrqOUgqiUhotS6JNKj6Vak
=46M/
-----END PGP SIGNATURE-----

From report at bugs.python.org  Sat Jul 23 09:52:58 2011
From: report at bugs.python.org (Georg Brandl)
Date: Sat, 23 Jul 2011 07:52:58 +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: <1311407578.29.0.747448803578.issue11435@psf.upfronthosting.co.za>


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

Done (in rev e32f140a020b).

----------

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

From report at bugs.python.org  Sat Jul 23 09:54:25 2011
From: report at bugs.python.org (Georg Brandl)
Date: Sat, 23 Jul 2011 07:54:25 +0000
Subject: [docs] [issue11975] Fix referencing of built-in types (list, int,
	...)
In-Reply-To: <1304281262.53.0.265979216697.issue11975@psf.upfronthosting.co.za>
Message-ID: <1311407665.38.0.622574539802.issue11975@psf.upfronthosting.co.za>


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

index does create targets, but they are not accessible for creating a link *to* it. They are only used for links from the indices.

----------

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

From report at bugs.python.org  Sat Jul 23 12:07:40 2011
From: report at bugs.python.org (Daniel Urban)
Date: Sat, 23 Jul 2011 10:07:40 +0000
Subject: [docs] [issue12617] Mutable Sequence Type can work not only with
	iterable in	slice[i:j] = t
In-Reply-To: <1311385198.6.0.560721842501.issue12617@psf.upfronthosting.co.za>
Message-ID: <1311415660.48.0.757157238369.issue12617@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/issue12617>
_______________________________________

From report at bugs.python.org  Sat Jul 23 12:45:37 2011
From: report at bugs.python.org (Georg Brandl)
Date: Sat, 23 Jul 2011 10:45:37 +0000
Subject: [docs] [issue12617] Mutable Sequence Type can work not only with
	iterable in	slice[i:j] = t
In-Reply-To: <1311385198.6.0.560721842501.issue12617@psf.upfronthosting.co.za>
Message-ID: <1311417937.43.0.327117679652.issue12617@psf.upfronthosting.co.za>


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

Yes, this is a bug in bytearray and should be fixed.

----------
assignee: docs at python -> 
components:  -Documentation
nosy: +georg.brandl
versions: +Python 2.7, Python 3.2 -Python 3.1

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

From report at bugs.python.org  Sat Jul 23 19:00:07 2011
From: report at bugs.python.org (aaugustin)
Date: Sat, 23 Jul 2011 17:00: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: <1311440407.39.0.359254621931.issue11553@psf.upfronthosting.co.za>


aaugustin <aymeric.augustin at polyconseil.fr> added the comment:

I noticed an inconsistency in the docs, and I think it falls in the "Language Reference" section of this ticket. In the definition of the import statement, after:

        | "from" module "import" "*"

we should add:

        | "from" relative_module "import" "*"


It is also possible to replace this line by:

        | "from" (module | relative_module) "import" "*"

----------
nosy: +aaugustin

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

From report at bugs.python.org  Sat Jul 23 20:22:40 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Sat, 23 Jul 2011 18:22:40 +0000
Subject: [docs] [issue12621] Errors in docstrings of find and rfind methods
	of bytes	and bytestring
In-Reply-To: <1311445360.36.0.0968747476875.issue12621@psf.upfronthosting.co.za>
Message-ID: <1311445360.36.0.0968747476875.issue12621@psf.upfronthosting.co.za>


New submission from Petri Lehtinen <petri at digip.org>:

bytes.{find,rfind} reads s[start:end]; should be B[start:end]

bytearray.{find,rfind} reads s[start,end]; should be B[start:end]

{str,unicode}.{find,rfind} reads s{start:end]; should be S[start:end]

----------
assignee: docs at python
components: Documentation, Interpreter Core
keywords: easy
messages: 141001
nosy: docs at python, petri.lehtinen
priority: normal
severity: normal
stage: needs patch
status: open
title: Errors in docstrings of find and rfind methods of bytes and bytestring
versions: Python 2.7, Python 3.2, Python 3.3

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

From report at bugs.python.org  Sun Jul 24 02:14:33 2011
From: report at bugs.python.org (Senthil Kumaran)
Date: Sun, 24 Jul 2011 00:14:33 +0000
Subject: [docs] [issue12621] Errors in docstrings of find and rfind methods
	of bytes	and bytestring
In-Reply-To: <1311445360.36.0.0968747476875.issue12621@psf.upfronthosting.co.za>
Message-ID: <1311466473.05.0.845467199697.issue12621@psf.upfronthosting.co.za>


Senthil Kumaran <senthil at uthcode.com> added the comment:

These are not on head revision in cpython and 3.2. Where did you find this bug? Please provide further details along with snippet and/or file.

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

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

From report at bugs.python.org  Sun Jul 24 05:16:24 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Sun, 24 Jul 2011 03:16:24 +0000
Subject: [docs] [issue1397474] timeit execution enviroment
Message-ID: <1311477384.29.0.263286431422.issue1397474@psf.upfronthosting.co.za>


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

Terry, I'd like to move this forward. New interfaces or not, making the documentation more comprehensible is an important goal in itself.

Could you please comment on rurpy2's latest notes - I will adapt the patch for latest 2.7/3.2/3.3 heads and commit it.

----------

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

From report at bugs.python.org  Sun Jul 24 05:20:21 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Sun, 24 Jul 2011 03:20:21 +0000
Subject: [docs] [issue12043] Update shutil documentation
In-Reply-To: <1304967545.46.0.442679433989.issue12043@psf.upfronthosting.co.za>
Message-ID: <1311477621.83.0.0617193074584.issue12043@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/issue12043>
_______________________________________

From report at bugs.python.org  Sun Jul 24 12:53:51 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Sun, 24 Jul 2011 10:53:51 +0000
Subject: [docs] [issue12621] Errors in docstrings of find and rfind methods
	of bytes	and bytestring
In-Reply-To: <1311445360.36.0.0968747476875.issue12621@psf.upfronthosting.co.za>
Message-ID: <1311504830.94.0.820201265539.issue12621@psf.upfronthosting.co.za>


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

Attached outputs of the following commands in the corresponding head revisions (from yesterday, as hg.python.org seems to be down today):

3.3:

for x in {bytes,bytearray}.{find,rfind} str.{find,rfind}; do echo === $x ===; ./python -c "help($x)" | cat; echo; done > 3.3.txt

3.2:

for x in {bytes,bytearray}.{find,rfind} str.{find,rfind}; do echo === $x ===; ./python -c "help($x)" | cat; echo; done > 3.2.txt

2.7:

for x in bytearray.{find,rfind} unicode.{find,rfind}; do echo === $x ===; ./python -c "help($x)" | cat; echo; done > 2.7.txt


In all files, I see s[start:end] or s[start,end] where there should read B[start:end] or S[start:end].

----------
stage:  -> needs patch
Added file: http://bugs.python.org/file22740/3.3.txt

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

From report at bugs.python.org  Sun Jul 24 12:57:43 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Sun, 24 Jul 2011 10:57:43 +0000
Subject: [docs] [issue12621] Errors in docstrings of find and rfind methods
	of bytes	and bytestring
In-Reply-To: <1311445360.36.0.0968747476875.issue12621@psf.upfronthosting.co.za>
Message-ID: <1311505063.62.0.750170565264.issue12621@psf.upfronthosting.co.za>


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


Added file: http://bugs.python.org/file22741/3.2.txt

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

From report at bugs.python.org  Sun Jul 24 12:59:48 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Sun, 24 Jul 2011 10:59:48 +0000
Subject: [docs] [issue12621] Errors in docstrings of find and rfind methods
	of bytes	and bytestring
In-Reply-To: <1311445360.36.0.0968747476875.issue12621@psf.upfronthosting.co.za>
Message-ID: <1311505188.76.0.23232363348.issue12621@psf.upfronthosting.co.za>


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


Added file: http://bugs.python.org/file22742/2.7.txt

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

From report at bugs.python.org  Sun Jul 24 13:03:12 2011
From: report at bugs.python.org (Senthil Kumaran)
Date: Sun, 24 Jul 2011 11:03:12 +0000
Subject: [docs] [issue12621] Errors in docstrings of find and rfind methods
	of bytes	and bytestring
In-Reply-To: <1311504830.94.0.820201265539.issue12621@psf.upfronthosting.co.za>
Message-ID: <20110724110303.GA3283@mathmagic>


Senthil Kumaran <senthil at uthcode.com> added the comment:

Okay, got it. Thanks. I was a subtle one within the description. I
missed it in the first place.

----------

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

From report at bugs.python.org  Sun Jul 24 19:54:36 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Sun, 24 Jul 2011 17:54:36 +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: <1311530076.77.0.674141417713.issue11784@psf.upfronthosting.co.za>


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


----------
stage:  -> patch review

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

From report at bugs.python.org  Sun Jul 24 19:57:02 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Sun, 24 Jul 2011 17:57:02 +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: <1311530222.92.0.750880797353.issue12063@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sun Jul 24 19:58:43 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Sun, 24 Jul 2011 17:58:43 +0000
Subject: [docs] [issue12174] Multiprocessing logging levels unclear
In-Reply-To: <1306324447.9.0.976036464224.issue12174@psf.upfronthosting.co.za>
Message-ID: <1311530323.78.0.837940862955.issue12174@psf.upfronthosting.co.za>


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


----------
keywords: +needs review
stage:  -> patch review
versions: +Python 3.2

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

From report at bugs.python.org  Mon Jul 25 02:26:30 2011
From: report at bugs.python.org (py.user)
Date: Mon, 25 Jul 2011 00:26:30 +0000
Subject: [docs] [issue12631] Mutable Sequence Type in .remove() is
	consistent only	with lists, but not with bytearrays
In-Reply-To: <1311553590.08.0.463284730319.issue12631@psf.upfronthosting.co.za>
Message-ID: <1311553590.08.0.463284730319.issue12631@psf.upfronthosting.co.za>


New submission from py.user <port139 at yandex.ru>:

4.6.4 Mutable Sequence Types

|  s.remove(x)  |  same as del s[s.index(x)]  |


>>> b = bytearray()
>>> b.extend(range(1, 6))
>>> b
bytearray(b'\x01\x02\x03\x04\x05')
>>> b.remove(2)
>>> del b[b.index(2)]
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: Type int doesn't support the buffer API
>>>

----------
assignee: docs at python
components: Documentation, Interpreter Core
messages: 141066
nosy: docs at python, py.user
priority: normal
severity: normal
status: open
title: Mutable Sequence Type in .remove() is consistent only with lists, but not with bytearrays
versions: Python 3.1

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

From report at bugs.python.org  Mon Jul 25 02:26:58 2011
From: report at bugs.python.org (py.user)
Date: Mon, 25 Jul 2011 00:26:58 +0000
Subject: [docs] [issue12631] Mutable Sequence Type in .remove() is
	consistent only	with lists, but not with bytearrays
In-Reply-To: <1311553590.08.0.463284730319.issue12631@psf.upfronthosting.co.za>
Message-ID: <1311553618.0.0.867318978982.issue12631@psf.upfronthosting.co.za>


Changes by py.user <port139 at yandex.ru>:


----------
type:  -> behavior

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

From report at bugs.python.org  Mon Jul 25 08:36:50 2011
From: report at bugs.python.org (Ashutosh Swain)
Date: Mon, 25 Jul 2011 06:36:50 +0000
Subject: [docs] [issue12634] Random Remarks in class documentation
In-Reply-To: <1311575810.71.0.0727071558423.issue12634@psf.upfronthosting.co.za>
Message-ID: <1311575810.71.0.0727071558423.issue12634@psf.upfronthosting.co.za>


New submission from Ashutosh Swain <ats.engg at gmail.com>:

URL: http://docs.python.org/tutorial/classes.html
section: 9.4 Random Remarks 

The first sentense is bit confusing:
"Data attributes override method attributes with the same name"

Is it possible to change the sentense something like this:
"Data attributes set through instance override method attributes with the same name"

----------
assignee: docs at python
components: Documentation
messages: 141073
nosy: ats.engg, docs at python
priority: normal
severity: normal
status: open
title: Random Remarks in class documentation
type: feature request
versions: Python 2.7

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

From report at bugs.python.org  Mon Jul 25 09:16:31 2011
From: report at bugs.python.org (Raymond Hettinger)
Date: Mon, 25 Jul 2011 07:16:31 +0000
Subject: [docs] [issue12634] Random Remarks in class documentation
In-Reply-To: <1311575810.71.0.0727071558423.issue12634@psf.upfronthosting.co.za>
Message-ID: <1311578190.95.0.0170099827435.issue12634@psf.upfronthosting.co.za>


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

The proposed rewrite doesn't make any sense to me.  Also "set through" is an reads awkwardly.

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

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

From report at bugs.python.org  Mon Jul 25 11:24:02 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Mon, 25 Jul 2011 09:24:02 +0000
Subject: [docs] [issue12634] Random Remarks in class documentation
In-Reply-To: <1311575810.71.0.0727071558423.issue12634@psf.upfronthosting.co.za>
Message-ID: <1311585842.84.0.744115664332.issue12634@psf.upfronthosting.co.za>


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

Indeed that paragraph is not really clear.  I had to read it till the end ("verbs for methods and nouns for data attributes") to figure out what it was talking about.  Even then it's still not clear what it's trying to say.
I *think* it means that if you have a class Foo with a method bar, and you do Foo.bar = 'data', the method will be overridden (so you won't be able to do Foo.bar for the 'data' and Foo.bar() for the method), but the opposite is also true.
Moreover I find both the suggestions for avoiding conflicts (capitalizing method names and/or using an underscore) wrong (both against PEP8).  Also it never happened to me to have an attribute with the same name of a method, and I think in general it's not a common case (becase, as the paragraph says, methods are verbs and attributes nouns).

The whole thing could be rewritten to just say that an attribute name always refers to a single object, either to a method or to some "data".

----------
nosy: +eric.araujo, ezio.melotti, terry.reedy
versions: +Python 3.2, Python 3.3

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

From report at bugs.python.org  Mon Jul 25 14:02:14 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Mon, 25 Jul 2011 12:02:14 +0000
Subject: [docs] [issue12634] Random Remarks in class documentation
In-Reply-To: <1311575810.71.0.0727071558423.issue12634@psf.upfronthosting.co.za>
Message-ID: <1311595334.65.0.526915065731.issue12634@psf.upfronthosting.co.za>


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

I have the same reading as Ezio, and the same opinion that it?s unclear and unhelpful.  +1 to saying that there is only one namespace for data attributes and methods.

----------

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

From report at bugs.python.org  Mon Jul 25 18:36:16 2011
From: report at bugs.python.org (Roundup Robot)
Date: Mon, 25 Jul 2011 16:36:16 +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: <E1QlO8c-00034h-TM@dinsdale.python.org>


Roundup Robot <devnull at psf.upfronthosting.co.za> added the comment:

New changeset 8d67fd820627 by Charles-Fran?ois Natali in branch 'default':
Issue #11784: Improve multiprocessing.Process.join() documentation. Patch by
http://hg.python.org/cpython/rev/8d67fd820627

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

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

From report at bugs.python.org  Mon Jul 25 18:38:16 2011
From: report at bugs.python.org (=?utf-8?q?Charles-Fran=C3=A7ois_Natali?=)
Date: Mon, 25 Jul 2011 16:38:16 +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: <1311611896.17.0.0585320217077.issue11784@psf.upfronthosting.co.za>


Charles-Fran?ois Natali <neologix at free.fr> added the comment:

Committed to default.
Patrick, thanks for the patch!

----------
nosy: +neologix
resolution:  -> fixed
stage: patch review -> committed/rejected
status: open -> closed
versions:  -Python 2.7

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

From report at bugs.python.org  Mon Jul 25 19:10:37 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Mon, 25 Jul 2011 17:10:37 +0000
Subject: [docs] [issue12634] Random Remarks in class documentation
In-Reply-To: <1311575810.71.0.0727071558423.issue12634@psf.upfronthosting.co.za>
Message-ID: <1311613837.34.0.0185530896514.issue12634@psf.upfronthosting.co.za>


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

That sentence is wrong to imply that there is anything special about data versus method attributes with respect to overriding -- or that attributes are special when it comes to names in a single namespace. What I think the paragraph should say, if not just deleted, is something like.

"Instance attributes hide class attributes. Instance data names are often intended to override class data names. But instance data names masking methods names is likely a mistake. This can be avoided by using verbs for method names and nouns for data names."

----------

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

From report at bugs.python.org  Mon Jul 25 21:50:15 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Mon, 25 Jul 2011 19:50:15 +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: <1311623415.39.0.733166391662.issue12380@psf.upfronthosting.co.za>


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

> The solution could be global, to allow bytearray fit the 'c' format of
> PyArg_ParseTuple. Then one would also be able to pass a bytearray into
> other stringlib methods requiring the 'c' format.

Another possibility would be the change the 'c' format so that it accepts any object that supports the buffer protocol and whose buffer length is 1.

Attaching two patches: The first allows bytes and bytearray, the second allows any object that supports the buffer protocol.

----------
keywords: +patch
Added file: http://bugs.python.org/file22756/c_format_bytearray.patch

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

From report at bugs.python.org  Mon Jul 25 21:50:45 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Mon, 25 Jul 2011 19:50:45 +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: <1311623445.19.0.976988957343.issue12380@psf.upfronthosting.co.za>


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


Added file: http://bugs.python.org/file22757/c_format_buffer.patch

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

From report at bugs.python.org  Mon Jul 25 21:51:05 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Mon, 25 Jul 2011 19:51:05 +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: <1311623465.31.0.278319362015.issue12380@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Mon Jul 25 21:53:25 2011
From: report at bugs.python.org (July Tikhonov)
Date: Mon, 25 Jul 2011 19:53:25 +0000
Subject: [docs] [issue12547] whatsnew/3.3: error in example about nntplib
In-Reply-To: <1310544811.28.0.517615627121.issue12547@psf.upfronthosting.co.za>
Message-ID: <1311623605.75.0.266239424894.issue12547@psf.upfronthosting.co.za>


July Tikhonov <july.tikh at gmail.com> added the comment:

The very same example (with the same error) can be found in
Doc/library/nntplib.rst

----------
resolution: fixed -> 
status: closed -> open
Added file: http://bugs.python.org/file22758/library.nntplib.rst.diff

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

From report at bugs.python.org  Mon Jul 25 22:36:58 2011
From: report at bugs.python.org (Eric Snow)
Date: Mon, 25 Jul 2011 20:36:58 +0000
Subject: [docs] [issue12633] sys.modules doc entry should reflect
	restrictions
In-Reply-To: <1311569390.98.0.906064511142.issue12633@psf.upfronthosting.co.za>
Message-ID: <1311626218.69.0.212688212691.issue12633@psf.upfronthosting.co.za>


Eric Snow <ericsnowcurrently at gmail.com> added the comment:

Would an implementation detail note be inappropriate here?  I only ask because it looks like the imp module's use of interp->modules is implementation specific.

Here's a patch for Doc/library/sys.rst that adds the note.

----------
assignee:  -> docs at python
components: +Documentation
keywords: +patch
nosy: +docs at python
title: sys.modules gets special treatment -> sys.modules doc entry should reflect restrictions
Added file: http://bugs.python.org/file22760/sys_modules_doc.diff

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

From report at bugs.python.org  Tue Jul 26 01:10:06 2011
From: report at bugs.python.org (Antoine Pitrou)
Date: Mon, 25 Jul 2011 23:10:06 +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: <1311635406.16.0.905091676123.issue12380@psf.upfronthosting.co.za>


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

c_format_bytearray.patch looks ok to me. The other proposal is too broad, and may lead to confusing behaviour.
In any case, some tests are needed.

----------

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

From report at bugs.python.org  Tue Jul 26 08:38:12 2011
From: report at bugs.python.org (Roundup Robot)
Date: Tue, 26 Jul 2011 06:38:12 +0000
Subject: [docs] [issue12547] whatsnew/3.3: error in example about nntplib
In-Reply-To: <1310544811.28.0.517615627121.issue12547@psf.upfronthosting.co.za>
Message-ID: <E1QlbHO-0004JL-KH@dinsdale.python.org>


Roundup Robot <devnull at psf.upfronthosting.co.za> added the comment:

New changeset 95c34bce986c by Ezio Melotti in branch 'default':
#12547: Fix example in nntplib doc. Patch by July Tikhonov.
http://hg.python.org/cpython/rev/95c34bce986c

----------

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

From report at bugs.python.org  Tue Jul 26 08:38:58 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Tue, 26 Jul 2011 06:38:58 +0000
Subject: [docs] [issue12547] whatsnew/3.3: error in example about nntplib
In-Reply-To: <1310544811.28.0.517615627121.issue12547@psf.upfronthosting.co.za>
Message-ID: <1311662338.56.0.573011504571.issue12547@psf.upfronthosting.co.za>


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

Fixed, thanks again for the patch!

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

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

From sjmcdonald at aol.com  Mon Jul 25 17:19:28 2011
From: sjmcdonald at aol.com (Steve)
Date: Mon, 25 Jul 2011 11:19:28 -0400
Subject: [docs] documentation bug in Python v3.3a0 documentation Python HOWTO
Message-ID: <8CE18F5612624BB-1A54-1ABDF@webmail-d026.sysops.aol.com>







 Descriptor How-To Guide


In Definition and Introduction: double word They are used used throughout Python


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

From report at bugs.python.org  Tue Jul 26 13:37:12 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Tue, 26 Jul 2011 11:37:12 +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: <1311680232.9.0.641134018821.issue12380@psf.upfronthosting.co.za>


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


Removed file: http://bugs.python.org/file22756/c_format_bytearray.patch

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

From report at bugs.python.org  Tue Jul 26 13:37:21 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Tue, 26 Jul 2011 11:37:21 +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: <1311680241.41.0.0282892683105.issue12380@psf.upfronthosting.co.za>


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


Removed file: http://bugs.python.org/file22757/c_format_buffer.patch

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

From report at bugs.python.org  Tue Jul 26 13:38:26 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Tue, 26 Jul 2011 11:38:26 +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: <1311680306.53.0.621943814684.issue12380@psf.upfronthosting.co.za>


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

Updated the bytearray patch to change documentation and add tests.

----------
Added file: http://bugs.python.org/file22764/c_format_bytearray.patch

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

From report at bugs.python.org  Tue Jul 26 17:54:53 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Tue, 26 Jul 2011 15:54:53 +0000
Subject: [docs] [issue1626300] 'Installing Python Modules' does not work for
	Windows
Message-ID: <1311695693.03.0.77518201287.issue1626300@psf.upfronthosting.co.za>


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

> Windows file associations are so disfunctional that you should not
> depend on them being anything in particular.

Ah.  Do you think I should revert the change I did for distutils docs to recommend running ?setup.py spam??  I followed the opinion of the original poster (first message).

> 'python -m module' (which looks for module under /Lib).
Not only under Lib, but along sys.path.

> In XP, and I presume later, the term 'DOS box' is obsolete and I
> would delete it. The 'Command Prompt' app (with caps) is found in
> the Start/Accessories directory. So I would say "open a Command
> Prompt window (in Start/Accessories)"
Thanks, I will change this term.  I won?t put the menu path however, it could change in any version.

> I am not sure of the difference between 'local script' and
> 'global command'.
Chris replied to that: local script is setup.py in a directory you probably just got from unzipping a file downloaded from PyPI, global command is pysetup3, installed alongside idle3, pydoc3 and others.

>> In order to run pysetup commands, you need to add the Python
>> Scripts directory to your PATH *include link to relevant section
>> of docs.python.org/using*.
> I do not understand your proposed note, especially "*include link to
> relevant section of docs.python.org/using*.".
The docs instruct to run pysetup commands, like ?pysetup list? or ?pysetup install Sphinx?.  On UNIX, the script will be available after install just like pydoc or idle.  On Windows, I don?t know.  The goal of my note was to tell people to add the Scripts directory to their PATH, so that they can run ?pysetup list? and co.

The *insert* part meant:  At this place I will put a link to the ?Using Python on...? docs, i.e. http://docs.python.org/using/windows#configuring-python (which explain how to edit PATH).

(Saying pysetup vs. pysetup3 is another unrelated doc bug.)

> Script run without extensions when run with an explicit python
> command.
Like ?python.exe setup? when the file really is setup.py?  I?d never have guessed that.

> I am not sure what 'or does the installer add .py?' could mean.
Do the Windows installers for CPython found on python.org install idle, pydoc and other scripts as ?pydoc? or ?pydoc.py??

> I realize that my answers may appear naive. I hope usefully so.
They?re very useful.

> I have used Windows since Win95 and have learned to focus, as
> described above, on what dependably works with minimal surprise.
This is a very useful standpoint.

> I have never used setup.py so no expert advice on its successor from
> me.
It?s okay, I added you because you can comment on how scripts and programs work, and review my English.

----------

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

From report at bugs.python.org  Tue Jul 26 17:56:20 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Tue, 26 Jul 2011 15:56:20 +0000
Subject: [docs] [issue1626300] 'Installing Python Modules' does not work for
	Windows
Message-ID: <1311695780.84.0.103545323328.issue1626300@psf.upfronthosting.co.za>


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


----------
nosy: +jason.coombs

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

From report at bugs.python.org  Tue Jul 26 18:14:18 2011
From: report at bugs.python.org (Jason R. Coombs)
Date: Tue, 26 Jul 2011 16:14:18 +0000
Subject: [docs] [issue1626300] 'Installing Python Modules' does not work for
	Windows
Message-ID: <1311696858.0.0.017829280087.issue1626300@psf.upfronthosting.co.za>


Jason R. Coombs <jaraco at jaraco.com> added the comment:

> > Script run without extensions when run with an explicit python
> > command.
> Like ?python.exe setup? when the file really is setup.py?  I?d
> never have guessed that.

No. Python.exe expects the full path. The only way to execute scripts without the extension is if PATHEXT specifies extension and you invoke the script itself, in which case the default handler (for that extension) will be invoked on that file.

----------

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

From report at bugs.python.org  Tue Jul 26 20:20:02 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Tue, 26 Jul 2011 18:20:02 +0000
Subject: [docs] [issue1626300] 'Installing Python Modules' does not work for
	Windows
Message-ID: <1311704402.58.0.905799561206.issue1626300@psf.upfronthosting.co.za>


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

I believe I meant that 'python setup' works when the script is named 'setup'. Which is to say, python does not require scripts to have an extension, as someone had thought in writing a patch.

----------

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

From report at bugs.python.org  Tue Jul 26 20:27:57 2011
From: report at bugs.python.org (Terry J. Reedy)
Date: Tue, 26 Jul 2011 18:27:57 +0000
Subject: [docs] [issue1626300] 'Installing Python Modules' does not work for
	Windows
Message-ID: <1311704877.54.0.175219747295.issue1626300@psf.upfronthosting.co.za>


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

I do not know why the msi installer *silently* fails to properly register extensions even when I leave that checked, or how common that it. I have never looked into the issue more because for development, I prefer to run from an IDLE window and be dumped into the shell after and have a chance to examine data and re-call functions. I will soon do an install on a new machine, so I will see what a true 'default' install looks like.

----------

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

From report at bugs.python.org  Tue Jul 26 23:20:19 2011
From: report at bugs.python.org (Jann Eike Kruse)
Date: Tue, 26 Jul 2011 21:20:19 +0000
Subject: [docs] [issue12642] 2.6.6 documentation of the open() built-in
	function
In-Reply-To: <1311715219.77.0.164344328426.issue12642@psf.upfronthosting.co.za>
Message-ID: <1311715219.77.0.164344328426.issue12642@psf.upfronthosting.co.za>


New submission from Jann Eike Kruse <python at jannkruse.de>:

The documentation page 

http://docs.python.org/release/2.6.6/library/functions.html?highlight=open#open

describes the  open()  built-in function as

  open(filename[, mode[, bufsize]])

but the Python interpreter complains:

  Python 2.6.6 (r266:84292, Dec 27 2010, 00:02:40) 
  [GCC 4.4.5] on linux2 
  Type "help", "copyright", "credits" or "license" for more information.
  >>> 
  >>> 
  >>> file_descriptor = open(filename='/spam')
  Traceback (most recent call last):
    File "<stdin>", line 1, in <module>
  TypeError: Required argument 'name' (pos 1) not found
  >>> 
  >>> 
  >>> file_descriptor = open(name='/spam', bufsize=-1)
  Traceback (most recent call last):
    File "<stdin>", line 1, in <module>
  TypeError: 'bufsize' is an invalid keyword argument for this function
  >>> 
  >>> 
  >>> file_descriptor = open(name='/spam', buffering=-1)
  Traceback (most recent call last):
    File "<stdin>", line 1, in <module>
  IOError: [Errno 2] No such file or directory: '/spam'
  >>> _
  

So the documentation page should read

  open(name[, mode[, buffering]])
       ----          ---------

instead, note 'name' not 'filename' and 'buffering' not 'bufsize'.

Maybe it's relevant, because Debian/stable still ships with
Python 2.6.6 and I guess the Python 2.7.x documentation has 
the same bug.

The """docstring""" does already reflect that correctly.


PS:
This is my first bug report. I hope I did this right. 
Mercy, please! ;)

----------
assignee: docs at python
components: Documentation
messages: 141183
nosy: docs at python, jannkruse
priority: normal
severity: normal
status: open
title: 2.6.6 documentation of the  open()  built-in function
versions: Python 2.6

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

From report at bugs.python.org  Tue Jul 26 23:30:59 2011
From: report at bugs.python.org (Dustin Haffner)
Date: Tue, 26 Jul 2011 21:30:59 +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: <1311715859.59.0.405262083379.issue12063@psf.upfronthosting.co.za>


Changes by Dustin Haffner <nitsud at gmail.com>:


----------
nosy: +dhaffner

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

From report at bugs.python.org  Tue Jul 26 23:58:49 2011
From: report at bugs.python.org (R. David Murray)
Date: Tue, 26 Jul 2011 21:58:49 +0000
Subject: [docs] [issue12642] Python2 documentation of the open() built-in
	function
In-Reply-To: <1311715219.77.0.164344328426.issue12642@psf.upfronthosting.co.za>
Message-ID: <1311717528.96.0.571681932225.issue12642@psf.upfronthosting.co.za>


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

The docs are correct in Python3.

The docs for Python2 are not *wrong*, since they indicate only positional parameters and if you use positional parameters it works as documented. (I'm surprised that using keyword arguments works, but I haven't looked at the code.)  Fixing the names in the 2.7 docs would still be helpful (2.6 docs don't get updated any more).

----------
nosy: +r.david.murray
priority: normal -> low
stage:  -> needs patch
title: 2.6.6 documentation of the  open()  built-in function -> Python2 documentation of the  open()  built-in function
type:  -> behavior
versions: +Python 2.7 -Python 2.6

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

From report at bugs.python.org  Wed Jul 27 05:31:27 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Wed, 27 Jul 2011 03:31:27 +0000
Subject: [docs] [issue12642] Python2 documentation of the open() built-in
	function
In-Reply-To: <1311715219.77.0.164344328426.issue12642@psf.upfronthosting.co.za>
Message-ID: <1311737487.54.0.0824311795144.issue12642@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/issue12642>
_______________________________________

From report at bugs.python.org  Wed Jul 27 07:49:04 2011
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 27 Jul 2011 05:49:04 +0000
Subject: [docs] [issue12642] Python2 documentation of the open() built-in
	function
In-Reply-To: <1311715219.77.0.164344328426.issue12642@psf.upfronthosting.co.za>
Message-ID: <E1QlwzP-0006XK-40@dinsdale.python.org>


Roundup Robot <devnull at psf.upfronthosting.co.za> added the comment:

New changeset 5da7924c4775 by Ezio Melotti in branch '2.7':
#12642: fix args names in open() doc.
http://hg.python.org/cpython/rev/5da7924c4775

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

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

From report at bugs.python.org  Wed Jul 27 07:50:31 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Wed, 27 Jul 2011 05:50:31 +0000
Subject: [docs] [issue12642] Python2 documentation of the open() built-in
	function
In-Reply-To: <1311715219.77.0.164344328426.issue12642@psf.upfronthosting.co.za>
Message-ID: <1311745831.43.0.857335686481.issue12642@psf.upfronthosting.co.za>


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

Fixed, thanks for the report!

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

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

From report at bugs.python.org  Wed Jul 27 12:45:15 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Wed, 27 Jul 2011 10:45:15 +0000
Subject: [docs] [issue12631] Mutable Sequence Type in .remove() is
	consistent only	with lists, but not with bytearrays
In-Reply-To: <1311553590.08.0.463284730319.issue12631@psf.upfronthosting.co.za>
Message-ID: <1311763514.92.0.140148106645.issue12631@psf.upfronthosting.co.za>


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

Duplicate of issue 12170.

----------
nosy: +petri.lehtinen
superseder:  -> index() and count() methods of bytes and bytearray should accept byte ints

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

From report at bugs.python.org  Wed Jul 27 16:44:34 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 27 Jul 2011 14:44:34 +0000
Subject: [docs] [issue12644] document the "%a" conversion in the old
	string	formatting operations
In-Reply-To: <1311776954.08.0.677656936944.issue12644@psf.upfronthosting.co.za>
Message-ID: <1311777874.51.0.673460941651.issue12644@psf.upfronthosting.co.za>


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


----------
nosy: +docs at python, eric.araujo

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

From report at bugs.python.org  Wed Jul 27 16:45:46 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Wed, 27 Jul 2011 14:45:46 +0000
Subject: [docs] [issue12644] document the "%a" conversion in the old
	string	formatting operations
In-Reply-To: <1311776954.08.0.677656936944.issue12644@psf.upfronthosting.co.za>
Message-ID: <1311777946.05.0.139054393774.issue12644@psf.upfronthosting.co.za>


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

I don?t think anyone could find anything wrong with the patch.

----------
stage: patch review -> commit review

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

From report at bugs.python.org  Wed Jul 27 17:37:29 2011
From: report at bugs.python.org (Roundup Robot)
Date: Wed, 27 Jul 2011 15:37:29 +0000
Subject: [docs] [issue12621] Errors in docstrings of find and rfind methods
	of bytes	and bytestring
In-Reply-To: <1311445360.36.0.0968747476875.issue12621@psf.upfronthosting.co.za>
Message-ID: <E1Qm6Ap-0008QH-Mb@dinsdale.python.org>


Roundup Robot <devnull at psf.upfronthosting.co.za> added the comment:

New changeset c3aebd01a033 by Senthil Kumaran in branch '3.2':
Fix closes Issue12621 - Fix docstrings of find and rfind methods of bytes/bytearry/unicodeobject.
http://hg.python.org/cpython/rev/c3aebd01a033

New changeset 842494d73f69 by Senthil Kumaran in branch 'default':
merge from 3.2 - Fix closes Issue12621 - Fix docstrings of find and rfind methods of bytes/bytearry/unicodeobject.
http://hg.python.org/cpython/rev/842494d73f69

New changeset e266415cf42c by Senthil Kumaran in branch '2.7':
merge from 3.2 - Fix closes Issue12621 - Fix docstrings of find and rfind methods of bytes/bytearry/unicodeobject.
http://hg.python.org/cpython/rev/e266415cf42c

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

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

From report at bugs.python.org  Wed Jul 27 18:54:57 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Wed, 27 Jul 2011 16:54:57 +0000
Subject: [docs] [issue12644] document the "%a" conversion in the old
	string	formatting operations
In-Reply-To: <1311776954.08.0.677656936944.issue12644@psf.upfronthosting.co.za>
Message-ID: <1311785697.41.0.258833357548.issue12644@psf.upfronthosting.co.za>


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

%r has note (5) saying "The precision determines the maximal number of characters used."

Does this apply to %a as well?

Other than that, LGTM

----------

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

From report at bugs.python.org  Wed Jul 27 18:57:01 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Wed, 27 Jul 2011 16:57:01 +0000
Subject: [docs] [issue12644] document the "%a" conversion in the old
	string	formatting operations
In-Reply-To: <1311776954.08.0.677656936944.issue12644@psf.upfronthosting.co.za>
Message-ID: <1311785821.17.0.553451151178.issue12644@psf.upfronthosting.co.za>


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

ISTM that it applies to both %s and %a, but the note is wrong/imprecise.

The precision determines where the string is truncated, but the actual number of characters is given by the field width.

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

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

From report at bugs.python.org  Wed Jul 27 19:08:32 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Wed, 27 Jul 2011 17:08:32 +0000
Subject: [docs] [issue12644] document the "%a" conversion in the old
	string	formatting operations
In-Reply-To: <1311776954.08.0.677656936944.issue12644@psf.upfronthosting.co.za>
Message-ID: <1311786512.26.0.0868134897043.issue12644@psf.upfronthosting.co.za>


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

Yeah, the note should probably be clarified to mention that if precision is specified, only the first precision characters will be shown. The field width is covered globally (for all conversion types) in note 4 above the table.

While we're at it, note 5 is:

   Precision (optional), given as a '.' (dot) followed by the precision. If specified as '*' (an asterisk), the actual width is read from the next element of the tuple in values, and the value to convert comes after the precision.

I think that the second sentence should have "the actual precision" instead "the actual width".

----------

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

From report at bugs.python.org  Wed Jul 27 19:48:36 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Wed, 27 Jul 2011 17:48:36 +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: <1311788916.22.0.912495449516.issue12380@psf.upfronthosting.co.za>


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

Looks good. How about also adding some tests for the original request of supporting bytearrays in ljust/rjust/center?

----------

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

From report at bugs.python.org  Wed Jul 27 20:03:35 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Wed, 27 Jul 2011 18:03:35 +0000
Subject: [docs] [issue12645] test.support. import_fresh_module - incorrect
	doc
In-Reply-To: <1311789815.76.0.639942891335.issue12645@psf.upfronthosting.co.za>
Message-ID: <1311789815.76.0.639942891335.issue12645@psf.upfronthosting.co.za>


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

>From Ezio Melotti's email to python-dev:


    diff --git a/Doc/library/test.rst b/Doc/library/test.rst
    --- a/Doc/library/test.rst
    +++ b/Doc/library/test.rst
    @@ -447,7 +447,7 @@
        Module and package deprecation messages are suppressed during this import
        if *deprecated* is ``True``.

    -   This function will raise :exc:`unittest.SkipTest` is the named module
    +   This function will raise :exc:`unittest.SkipTest` if the named module


Actually I think this is no longer true.  import_fresh_module raises an ImportError if *name* can't be imported, or returns None if the fresh module is not found.

Its use case is to enable or block accelerations for modules that optionally provide one.  All the modules that currently use import_fresh_module are (afaik) always available (json, warnings, heapq), so raising SkipTest when the module is missing is not useful now.
It returns None in the case an acceleration is missing, so e.g. in "cjson = import_fresh_module('json', fresh=['_json'])" cjson will be None and it will be possible to do things like @skipUnless(cjson, 'requires _json').  Here raising an ImportError will defeat (part of) the purpose of the function, i.e. avoiding:
try:
 import _json
except ImportError:
 _json = None

and raising a SkipTest when the accelerations are missing is not an option if there are other tests (e.g. the tests for the Python implementation).

These changes come from http://hg.python.org/cpython/rev/c1a12a308c5b .  Before the change import_fresh_module was still returning the module (e.g. json) even when the acceleration (fresh=['_json']) was missing, and the C tests were run twice using the same pure-python module used for the Py ones.

The typo and the wrong doc is also on 2.7.

----------
assignee: docs at python
components: Documentation
keywords: easy
messages: 141255
nosy: docs at python, eli.bendersky, ezio.melotti
priority: normal
severity: normal
status: open
title: test.support. import_fresh_module - incorrect doc
versions: Python 2.7, Python 3.3

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

From report at bugs.python.org  Wed Jul 27 20:54:21 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Wed, 27 Jul 2011 18:54:21 +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: <1311792861.34.0.930992996223.issue12380@psf.upfronthosting.co.za>


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

Updated the patch to add tests for {bytes,bytearray}.{center,ljust,rjust}. The tests check that both bytes and bytearray are always accepted as the fill character.

----------
Added file: http://bugs.python.org/file22779/c_format_bytearray_plus_additional_tests.patch

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

From report at bugs.python.org  Thu Jul 28 20:42:38 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Thu, 28 Jul 2011 18:42:38 +0000
Subject: [docs] [issue11699] Doc for optparse.OptionParser.get_option_group
	is wrong
In-Reply-To: <1301301829.71.0.0713641718569.issue11699@psf.upfronthosting.co.za>
Message-ID: <1311878557.89.0.0595898993711.issue11699@psf.upfronthosting.co.za>


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

Attached a patch for 2.7.

----------
keywords: +easy, needs review, patch
nosy: +petri.lehtinen
versions:  -Python 3.1
Added file: http://bugs.python.org/file22785/issue11699.patch

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

From report at bugs.python.org  Thu Jul 28 20:42:56 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Thu, 28 Jul 2011 18:42:56 +0000
Subject: [docs] [issue11699] Doc for optparse.OptionParser.get_option_group
	is wrong
In-Reply-To: <1301301829.71.0.0713641718569.issue11699@psf.upfronthosting.co.za>
Message-ID: <1311878576.42.0.090825623163.issue11699@psf.upfronthosting.co.za>


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


----------
stage:  -> patch review

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

From report at bugs.python.org  Fri Jul 29 06:07:07 2011
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 29 Jul 2011 04:07:07 +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: <E1QmeLn-0006io-C2@dinsdale.python.org>


Roundup Robot <devnull at psf.upfronthosting.co.za> added the comment:

New changeset 536fccc75f5a by Eli Bendersky in branch 'default':
Issue #12380: PyArg_ParseTuple now accepts a bytearray for the 'c' format.
http://hg.python.org/cpython/rev/536fccc75f5a

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

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

From report at bugs.python.org  Fri Jul 29 06:08:47 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Fri, 29 Jul 2011 04:08:47 +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: <1311912527.22.0.187632166038.issue12380@psf.upfronthosting.co.za>


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

Petri, thanks for the patch. I've updated Misc/NEWS and committed it.

Unless there are objections or problems, I will close this issue in a day or two.

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

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

From report at bugs.python.org  Fri Jul 29 08:35:49 2011
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 29 Jul 2011 06:35:49 +0000
Subject: [docs] [issue12644] document the "%a" conversion in the old
	string	formatting operations
In-Reply-To: <1311776954.08.0.677656936944.issue12644@psf.upfronthosting.co.za>
Message-ID: <E1Qmgfj-0000ny-Hs@dinsdale.python.org>


Roundup Robot <devnull at psf.upfronthosting.co.za> added the comment:

New changeset 9846f6463f23 by Eli Bendersky in branch '3.2':
Issue #12644: document the '%a' conversion in the old string formatting operations. Patch prepared together with Ezio Melotti
http://hg.python.org/cpython/rev/9846f6463f23

New changeset 80a3bf889cf6 by Eli Bendersky in branch 'default':
Merge from 3.2: Issue #12644: document the '%a' conversion in the old string formatting operations. Patch prepared together with Ezio Melotti
http://hg.python.org/cpython/rev/80a3bf889cf6

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

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

From report at bugs.python.org  Fri Jul 29 08:43:34 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Fri, 29 Jul 2011 06:43:34 +0000
Subject: [docs] [issue12644] document the "%a" conversion in the old
	string	formatting operations
In-Reply-To: <1311776954.08.0.677656936944.issue12644@psf.upfronthosting.co.za>
Message-ID: <1311921814.38.0.761163915508.issue12644@psf.upfronthosting.co.za>


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

Ezio, I've taken the liberty to adapt your patch with the suggested fixes and commit it to both 3.2 and 3.3

If everything is OK, this issue can be close (I'll do it in a few days if no one else does :-)

----------

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

From report at bugs.python.org  Fri Jul 29 08:47:47 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Fri, 29 Jul 2011 06:47:47 +0000
Subject: [docs] [issue12644] document the "%a" conversion in the old
	string	formatting operations
In-Reply-To: <1311776954.08.0.677656936944.issue12644@psf.upfronthosting.co.za>
Message-ID: <1311922067.28.0.122426390693.issue12644@psf.upfronthosting.co.za>


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

The commit looks fine, the issue can be closed.

----------

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

From report at bugs.python.org  Fri Jul 29 08:49:34 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Fri, 29 Jul 2011 06:49:34 +0000
Subject: [docs] [issue12644] document the "%a" conversion in the old
	string	formatting operations
In-Reply-To: <1311776954.08.0.677656936944.issue12644@psf.upfronthosting.co.za>
Message-ID: <1311922174.53.0.0840497201914.issue12644@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Jul 29 09:45:25 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Fri, 29 Jul 2011 07:45:25 +0000
Subject: [docs] [issue12652] Move documentation of test.support into the
	devguide
In-Reply-To: <1311925525.47.0.986284069415.issue12652@psf.upfronthosting.co.za>
Message-ID: <1311925525.47.0.986284069415.issue12652@psf.upfronthosting.co.za>


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

First step in transition:

Attaching a patch to devguide's runtests.rst to incorporate existing test.support documentation from 3.3 head, with some small markup changes suitable for the devguide.

----------
components: Devguide
files: devguide_test_support.1.patch
keywords: patch
messages: 141337
nosy: brett.cannon, docs at python, eli.bendersky, ncoghlan
priority: low
severity: normal
stage: patch review
status: open
title: Move documentation of test.support into the devguide
type: behavior
Added file: http://bugs.python.org/file22790/devguide_test_support.1.patch

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

From report at bugs.python.org  Fri Jul 29 09:52:37 2011
From: report at bugs.python.org (Ezio Melotti)
Date: Fri, 29 Jul 2011 07:52:37 +0000
Subject: [docs] [issue12652] Move documentation of test.support into the
	devguide
In-Reply-To: <1311925525.47.0.986284069415.issue12652@psf.upfronthosting.co.za>
Message-ID: <1311925957.79.0.741344628288.issue12652@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Jul 29 09:56:04 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Fri, 29 Jul 2011 07:56:04 +0000
Subject: [docs] [issue11699] Doc for optparse.OptionParser.get_option_group
	is wrong
In-Reply-To: <1301301829.71.0.0713641718569.issue11699@psf.upfronthosting.co.za>
Message-ID: <1311926164.55.0.244554457628.issue11699@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/issue11699>
_______________________________________

From report at bugs.python.org  Fri Jul 29 11:28:06 2011
From: report at bugs.python.org (Barry A. Warsaw)
Date: Fri, 29 Jul 2011 09:28:06 +0000
Subject: [docs] [issue12652] Move documentation of test.support into the
	devguide
In-Reply-To: <1311925525.47.0.986284069415.issue12652@psf.upfronthosting.co.za>
Message-ID: <1311931686.42.0.15025803216.issue12652@psf.upfronthosting.co.za>


Barry A. Warsaw <barry at python.org> added the comment:

As I just mentioned on python-dev (via Gmane), I'm uncomfortable with moving the documentation for test.support into the devguide.

----------
nosy: +barry

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

From report at bugs.python.org  Fri Jul 29 13:00:15 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Fri, 29 Jul 2011 11:00:15 +0000
Subject: [docs] [issue11699] Doc for optparse.OptionParser.get_option_group
	is wrong
In-Reply-To: <1301301829.71.0.0713641718569.issue11699@psf.upfronthosting.co.za>
Message-ID: <1311937215.0.0.618089359248.issue11699@psf.upfronthosting.co.za>


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

Petri,

I think the "to" after "belongs" is redundant.

Also, the issue lists 3.2 and 3.3 - is the fix relevant there too? If yes, can you prepare a patch for 3.2? (I will merge it to 3.3 too)

----------

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

From report at bugs.python.org  Fri Jul 29 13:47:09 2011
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 29 Jul 2011 11:47:09 +0000
Subject: [docs] [issue12531] documentation index entries for * and **
In-Reply-To: <1310385823.58.0.152505903133.issue12531@psf.upfronthosting.co.za>
Message-ID: <E1QmlX0-0007of-Gf@dinsdale.python.org>


Roundup Robot <devnull at psf.upfronthosting.co.za> added the comment:

New changeset 8328fe952303 by Eli Bendersky in branch '2.7':
Issue #12531: add index entries to documentation of * and ** in function calls
http://hg.python.org/cpython/rev/8328fe952303

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

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

From report at bugs.python.org  Fri Jul 29 13:48:15 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Fri, 29 Jul 2011 11:48:15 +0000
Subject: [docs] [issue12531] documentation index entries for * and **
In-Reply-To: <1310385823.58.0.152505903133.issue12531@psf.upfronthosting.co.za>
Message-ID: <1311940095.03.0.53916174215.issue12531@psf.upfronthosting.co.za>


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

I've committed a fix into 2.7, taking Terry's advice ("in function calls" subsection instead of "statement") and Eric's sequence/iterable correction into account.

If this looks OK, I will commit a similar fix to the 3.x branches as well.

----------

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

From report at bugs.python.org  Fri Jul 29 14:14:27 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 29 Jul 2011 12:14:27 +0000
Subject: [docs] [issue12652] Move documentation of test.support into the
	devguide
In-Reply-To: <1311925525.47.0.986284069415.issue12652@psf.upfronthosting.co.za>
Message-ID: <1311941667.7.0.370485967063.issue12652@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Fri Jul 29 14:35:18 2011
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 29 Jul 2011 12:35:18 +0000
Subject: [docs] [issue10318] "make altinstall" installs many files with
	incorrect	shebangs
In-Reply-To: <1288926610.35.0.932494150274.issue10318@psf.upfronthosting.co.za>
Message-ID: <E1QmmHb-0003sf-Rp@dinsdale.python.org>


Roundup Robot <devnull at psf.upfronthosting.co.za> added the comment:

New changeset 65d5ecefd50d by ?ric Araujo in branch '3.2':
Fix missing or wrong shebangs and missing executable bits for scripts (#10318)
http://hg.python.org/cpython/rev/65d5ecefd50d

New changeset 5467abaaf5eb by ?ric Araujo in branch 'default':
Merge from 3.2 (#10318, #12255, #12043, #12417 and other fixes)
http://hg.python.org/cpython/rev/5467abaaf5eb

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

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

From report at bugs.python.org  Fri Jul 29 14:35:21 2011
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 29 Jul 2011 12:35:21 +0000
Subject: [docs] [issue12043] Update shutil documentation
In-Reply-To: <1304967545.46.0.442679433989.issue12043@psf.upfronthosting.co.za>
Message-ID: <E1QmmHb-0003sf-SO@dinsdale.python.org>


Roundup Robot <devnull at psf.upfronthosting.co.za> added the comment:

New changeset 836548ce4cd2 by ?ric Araujo in branch '3.2':
Update documentation for shutil.move (#12043) and fix a few typos.
http://hg.python.org/cpython/rev/836548ce4cd2

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

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

From report at bugs.python.org  Fri Jul 29 14:37:58 2011
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 29 Jul 2011 12:37:58 +0000
Subject: [docs] [issue12043] Update shutil documentation
In-Reply-To: <1304967545.46.0.442679433989.issue12043@psf.upfronthosting.co.za>
Message-ID: <E1QmmKC-000445-Fg@dinsdale.python.org>


Roundup Robot <devnull at psf.upfronthosting.co.za> added the comment:

New changeset 6bf168b55d07 by ?ric Araujo in branch '2.7':
Update documentation for shutil.move (#12043) and fix a few typos.
http://hg.python.org/cpython/rev/6bf168b55d07

----------

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

From report at bugs.python.org  Fri Jul 29 14:38:00 2011
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 29 Jul 2011 12:38:00 +0000
Subject: [docs] [issue10318] "make altinstall" installs many files with
	incorrect	shebangs
In-Reply-To: <1288926610.35.0.932494150274.issue10318@psf.upfronthosting.co.za>
Message-ID: <E1QmmKC-000445-FX@dinsdale.python.org>


Roundup Robot <devnull at psf.upfronthosting.co.za> added the comment:

New changeset 7fb0abf928e0 by ?ric Araujo in branch '2.7':
Fix missing or shebangs and executable bits for scripts (#10318)
http://hg.python.org/cpython/rev/7fb0abf928e0

----------

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

From report at bugs.python.org  Fri Jul 29 14:39:55 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 29 Jul 2011 12:39:55 +0000
Subject: [docs] [issue12531] documentation index entries for * and **
In-Reply-To: <1310385823.58.0.152505903133.issue12531@psf.upfronthosting.co.za>
Message-ID: <1311943195.13.0.16299724648.issue12531@psf.upfronthosting.co.za>


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

Looks good to me.

One tip for commits: it?s often better to let a line exceed 80 characters in order to make for a smaller diff.  Here, only one word was changed but four lines were marked as changed, which makes reviews longer.  Lines are rewrapped when doing larger rewritings.

----------

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

From report at bugs.python.org  Fri Jul 29 14:41:17 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 29 Jul 2011 12:41:17 +0000
Subject: [docs] [issue11699] Doc for optparse.OptionParser.get_option_group
	is wrong
In-Reply-To: <1301301829.71.0.0713641718569.issue11699@psf.upfronthosting.co.za>
Message-ID: <1311943277.09.0.170222328256.issue11699@psf.upfronthosting.co.za>


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

Yep, the ?to? is already present before the verb :)

I think we mark None as ``None``, not *None*.  (If the rest of the file does otherwise, then do that.)

----------

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

From report at bugs.python.org  Fri Jul 29 14:46:07 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Fri, 29 Jul 2011 12:46:07 +0000
Subject: [docs] [issue12531] documentation index entries for * and **
In-Reply-To: <1310385823.58.0.152505903133.issue12531@psf.upfronthosting.co.za>
Message-ID: <1311943567.71.0.036267378413.issue12531@psf.upfronthosting.co.za>


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

?ric - when I was just starting contributing patches to Python, I was strictly disciplined by veteran devs to stay within 80 chars no matter what :-)

----------

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

From report at bugs.python.org  Fri Jul 29 15:40:43 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 29 Jul 2011 13:40:43 +0000
Subject: [docs] [issue12043] Update shutil documentation
In-Reply-To: <1304967545.46.0.442679433989.issue12043@psf.upfronthosting.co.za>
Message-ID: <1311946843.88.0.302838747036.issue12043@psf.upfronthosting.co.za>


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

Done!

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

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

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


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

The module docstring (which duplicates the reST docs) still mentions list2cmdline.  I?d vote for removal there too.

----------

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

From report at bugs.python.org  Fri Jul 29 17:54:45 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 29 Jul 2011 15:54:45 +0000
Subject: [docs] [issue9254] __import__ docstring should
	recommend	importlib.import_module()
In-Reply-To: <1279057769.02.0.398615806235.issue9254@psf.upfronthosting.co.za>
Message-ID: <1311954885.21.0.44242871417.issue9254@psf.upfronthosting.co.za>


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

Patch committed in 3.2.

Attached patch ports the docstring change to 2.7 and edits the reST docs, please approve.

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

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

From report at bugs.python.org  Fri Jul 29 17:55:43 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 29 Jul 2011 15:55:43 +0000
Subject: [docs] [issue9254] __import__ docstring should
	recommend	importlib.import_module()
In-Reply-To: <1279057769.02.0.398615806235.issue9254@psf.upfronthosting.co.za>
Message-ID: <1311954943.54.0.0754766585227.issue9254@psf.upfronthosting.co.za>


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


Added file: http://bugs.python.org/file22793/__import__-mention-importlib-2.7.diff

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

From report at bugs.python.org  Fri Jul 29 18:11:13 2011
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 29 Jul 2011 16:11:13 +0000
Subject: [docs] [issue9254] __import__ docstring should
	recommend	importlib.import_module()
In-Reply-To: <1279057769.02.0.398615806235.issue9254@psf.upfronthosting.co.za>
Message-ID: <E1Qmpea-0006ma-3k@dinsdale.python.org>


Roundup Robot <devnull at psf.upfronthosting.co.za> added the comment:

New changeset 7bfc0a45542c by ?ric Araujo in branch '3.2':
Let the doc of __import__ link to importlib (#9254).
http://hg.python.org/cpython/rev/7bfc0a45542c

New changeset 4a6cb2d9e906 by ?ric Araujo in branch 'default':
Merge from 3.2 (#9254, #8982, #9788)
http://hg.python.org/cpython/rev/4a6cb2d9e906

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

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

From report at bugs.python.org  Fri Jul 29 18:11:14 2011
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 29 Jul 2011 16:11:14 +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: <E1Qmpea-0006ma-4o@dinsdale.python.org>


Roundup Robot <devnull at psf.upfronthosting.co.za> added the comment:

New changeset 939631c6bc6f by ?ric Araujo in branch '3.2':
Add a link target for argparse.Namespace (#8982)
http://hg.python.org/cpython/rev/939631c6bc6f

----------

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

From report at bugs.python.org  Fri Jul 29 18:13:47 2011
From: report at bugs.python.org (Roundup Robot)
Date: Fri, 29 Jul 2011 16:13:47 +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: <E1Qmph4-0006zR-E8@dinsdale.python.org>


Roundup Robot <devnull at psf.upfronthosting.co.za> added the comment:

New changeset 01722022f88d by ?ric Araujo in branch '2.7':
Add a link target for argparse.Namespace (#8982)
http://hg.python.org/cpython/rev/01722022f88d

----------

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

From report at bugs.python.org  Fri Jul 29 18:23:25 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 29 Jul 2011 16:23:25 +0000
Subject: [docs] [issue12622] failfast argument to TextTestRunner not
	documented
In-Reply-To: <1311448108.9.0.673600380151.issue12622@psf.upfronthosting.co.za>
Message-ID: <1311956605.04.0.636440092812.issue12622@psf.upfronthosting.co.za>


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


----------
nosy: +docs at python, eric.araujo

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

From report at bugs.python.org  Fri Jul 29 18:27:50 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Fri, 29 Jul 2011 16:27:50 +0000
Subject: [docs] [issue12633] sys.modules doc entry should reflect
	restrictions
In-Reply-To: <1311569390.98.0.906064511142.issue12633@psf.upfronthosting.co.za>
Message-ID: <1311956870.09.0.481359633569.issue12633@psf.upfronthosting.co.za>


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

The note?s spirit is good, but I think something more concise would do.

Side note: Please don?t mix up unrelated cosmetic changes in your diffs.

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

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

From report at bugs.python.org  Fri Jul 29 23:50:47 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Fri, 29 Jul 2011 21:50:47 +0000
Subject: [docs] [issue12652] Move documentation of test.support into the
	devguide
In-Reply-To: <1311925525.47.0.986284069415.issue12652@psf.upfronthosting.co.za>
Message-ID: <1311976247.45.0.493078628154.issue12652@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/issue12652>
_______________________________________

From report at bugs.python.org  Sat Jul 30 06:09:40 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 30 Jul 2011 04:09:40 +0000
Subject: [docs] [issue12531] documentation index entries for * and **
In-Reply-To: <1310385823.58.0.152505903133.issue12531@psf.upfronthosting.co.za>
Message-ID: <E1Qn0rq-000249-Eo@dinsdale.python.org>


Roundup Robot <devnull at psf.upfronthosting.co.za> added the comment:

New changeset a8aa918041c2 by Eli Bendersky in branch '3.2':
Issue #12531: add index entries to documentation of * and ** in function calls
http://hg.python.org/cpython/rev/a8aa918041c2

New changeset 221ca00121ef by Eli Bendersky in branch 'default':
Merge from 3.2: Issue #12531: add index entries to documentation of * and ** in function calls
http://hg.python.org/cpython/rev/221ca00121ef

----------

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

From report at bugs.python.org  Sat Jul 30 06:10:19 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Sat, 30 Jul 2011 04:10:19 +0000
Subject: [docs] [issue12531] documentation index entries for * and **
In-Reply-To: <1310385823.58.0.152505903133.issue12531@psf.upfronthosting.co.za>
Message-ID: <1311999019.08.0.416705961571.issue12531@psf.upfronthosting.co.za>


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


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

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

From report at bugs.python.org  Sat Jul 30 06:13:45 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Sat, 30 Jul 2011 04:13:45 +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: <1311999225.07.0.0150215529502.issue12380@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/issue12380>
_______________________________________

From report at bugs.python.org  Sat Jul 30 07:08:38 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Sat, 30 Jul 2011 05:08:38 +0000
Subject: [docs] [issue11699] Doc for optparse.OptionParser.get_option_group
	is wrong
In-Reply-To: <1301301829.71.0.0713641718569.issue11699@psf.upfronthosting.co.za>
Message-ID: <1312002518.22.0.384569402762.issue11699@psf.upfronthosting.co.za>


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

Updated the patch:

- Removed the extra "to"

- Changed *None* to ``None`` for conformance with the rest of the file

The same patch applies unmodified to 2.7 and 3.2 branches.

----------
Added file: http://bugs.python.org/file22800/issue11699.patch

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

From report at bugs.python.org  Sat Jul 30 07:08:49 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Sat, 30 Jul 2011 05:08:49 +0000
Subject: [docs] [issue11699] Doc for optparse.OptionParser.get_option_group
	is wrong
In-Reply-To: <1301301829.71.0.0713641718569.issue11699@psf.upfronthosting.co.za>
Message-ID: <1312002529.19.0.0381579650931.issue11699@psf.upfronthosting.co.za>


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


Removed file: http://bugs.python.org/file22785/issue11699.patch

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

From report at bugs.python.org  Sat Jul 30 07:12:41 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Sat, 30 Jul 2011 05:12:41 +0000
Subject: [docs] [issue11699] Doc for optparse.OptionParser.get_option_group
	is wrong
In-Reply-To: <1301301829.71.0.0713641718569.issue11699@psf.upfronthosting.co.za>
Message-ID: <1312002761.74.0.872511666734.issue11699@psf.upfronthosting.co.za>


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

Armin, adding you as the optparse expert - could you see the doc change makes sense?

[I will then do the commit work]

----------
nosy: +aronacher

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

From report at bugs.python.org  Sat Jul 30 09:04:30 2011
From: report at bugs.python.org (Georg Brandl)
Date: Sat, 30 Jul 2011 07:04:30 +0000
Subject: [docs] [issue12652] Move documentation of test.support into the
	devguide
In-Reply-To: <1311925525.47.0.986284069415.issue12652@psf.upfronthosting.co.za>
Message-ID: <1312009470.16.0.609691206614.issue12652@psf.upfronthosting.co.za>


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

-1 from me as well.

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

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

From report at bugs.python.org  Sat Jul 30 09:07:34 2011
From: report at bugs.python.org (Georg Brandl)
Date: Sat, 30 Jul 2011 07:07:34 +0000
Subject: [docs] [issue11699] Doc for optparse.OptionParser.get_option_group
	is wrong
In-Reply-To: <1301301829.71.0.0713641718569.issue11699@psf.upfronthosting.co.za>
Message-ID: <1312009654.0.0.147721282995.issue11699@psf.upfronthosting.co.za>


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

It does make sense, please commit.

----------

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

From report at bugs.python.org  Sat Jul 30 10:14:57 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 30 Jul 2011 08:14:57 +0000
Subject: [docs] [issue11699] Doc for optparse.OptionParser.get_option_group
	is wrong
In-Reply-To: <1301301829.71.0.0713641718569.issue11699@psf.upfronthosting.co.za>
Message-ID: <E1Qn4hD-0000FS-LA@dinsdale.python.org>


Roundup Robot <devnull at psf.upfronthosting.co.za> added the comment:

New changeset 5a248fcfa112 by Eli Bendersky in branch '2.7':
Issue #11699: fix documentation of OptionParser.get_option_group. Patch by Petri Lehtinen
http://hg.python.org/cpython/rev/5a248fcfa112

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

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

From report at bugs.python.org  Sat Jul 30 10:39:45 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 30 Jul 2011 08:39:45 +0000
Subject: [docs] [issue11699] Doc for optparse.OptionParser.get_option_group
	is wrong
In-Reply-To: <1301301829.71.0.0713641718569.issue11699@psf.upfronthosting.co.za>
Message-ID: <E1Qn55E-0001X3-8W@dinsdale.python.org>


Roundup Robot <devnull at psf.upfronthosting.co.za> added the comment:

New changeset cfb60dfa7734 by Eli Bendersky in branch '3.2':
Issue #11699: fix documentation of OptionParser.get_option_group. Patch by Petri Lehtinen
http://hg.python.org/cpython/rev/cfb60dfa7734

New changeset 27b588dd6155 by Eli Bendersky in branch 'default':
Merge 3.2: Issue #11699: fix documentation of OptionParser.get_option_group. Patch by Petri Lehtinen
http://hg.python.org/cpython/rev/27b588dd6155

----------

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

From report at bugs.python.org  Sat Jul 30 10:43:31 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Sat, 30 Jul 2011 08:43:31 +0000
Subject: [docs] [issue11699] Doc for optparse.OptionParser.get_option_group
	is wrong
In-Reply-To: <1301301829.71.0.0713641718569.issue11699@psf.upfronthosting.co.za>
Message-ID: <1312015411.81.0.951936522759.issue11699@psf.upfronthosting.co.za>


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

Done. 

Petri - thanks for the contribution.

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

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

From report at bugs.python.org  Sat Jul 30 15:30:30 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Sat, 30 Jul 2011 13:30:30 +0000
Subject: [docs] [issue11699] Doc for optparse.OptionParser.get_option_group
	is wrong
In-Reply-To: <1301301829.71.0.0713641718569.issue11699@psf.upfronthosting.co.za>
Message-ID: <1312032630.87.0.503513535991.issue11699@psf.upfronthosting.co.za>


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


----------
stage: patch review -> committed/rejected

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

From report at bugs.python.org  Sat Jul 30 15:32:06 2011
From: report at bugs.python.org (=?utf-8?q?=C3=89ric_Araujo?=)
Date: Sat, 30 Jul 2011 13:32:06 +0000
Subject: [docs] [issue12531] documentation index entries for * and **
In-Reply-To: <1310385823.58.0.152505903133.issue12531@psf.upfronthosting.co.za>
Message-ID: <1312032726.86.0.566763803578.issue12531@psf.upfronthosting.co.za>


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


----------
stage: patch review -> committed/rejected

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

From report at bugs.python.org  Sat Jul 30 17:38:00 2011
From: report at bugs.python.org (Senthil Kumaran)
Date: Sat, 30 Jul 2011 15:38:00 +0000
Subject: [docs] [issue12183] Document behaviour of shutil.copy2 and copystat
	with	symlinks
In-Reply-To: <1306384920.41.0.626033537775.issue12183@psf.upfronthosting.co.za>
Message-ID: <1312040280.03.0.299305836969.issue12183@psf.upfronthosting.co.za>


Senthil Kumaran <senthil at uthcode.com> added the comment:

When shutil.copy2 already says that it's behavior is equivalent to cp -p, will adding this sentence

+   Symbolic links are not preserved. The contents and metadata of the
+   linked files are copied instead.

Not actively confuse the user?  Because cp -p's behavior includes that and I dont see a special mention without giving more details is going to help.

The other portion of the patch seems okay to me.

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

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

From report at bugs.python.org  Sat Jul 30 18:13:04 2011
From: report at bugs.python.org (Nick Coghlan)
Date: Sat, 30 Jul 2011 16:13:04 +0000
Subject: [docs] [issue12652] Keep test.support docs out of the global docs
	index
In-Reply-To: <1311925525.47.0.986284069415.issue12652@psf.upfronthosting.co.za>
Message-ID: <1312042384.87.0.194476033191.issue12652@psf.upfronthosting.co.za>


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

Barry convinced me that the test.support docs need to stay in the same repo as the code they document, so -1 from me as well.

Changed issue title to reflect the real problem that inspired this suggestion (i.e. test.support.unlink et al appearing in the docs index alongside the actual functions they wrap).

Is there a :noindex: directive that will tell Sphinx not to index an entire section?

----------
title: Move documentation of test.support into the devguide -> Keep test.support docs out of the global docs index

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

From report at bugs.python.org  Sat Jul 30 19:11:04 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Sat, 30 Jul 2011 17:11:04 +0000
Subject: [docs] [issue12652] Keep test.support docs out of the global docs
	index
In-Reply-To: <1311925525.47.0.986284069415.issue12652@psf.upfronthosting.co.za>
Message-ID: <1312045864.16.0.755276909874.issue12652@psf.upfronthosting.co.za>


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

Nick, fair enough, but I think it would be more appropriate (and useful) to close this issue as rejected and open a new one.

----------

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

From report at bugs.python.org  Sat Jul 30 19:16:53 2011
From: report at bugs.python.org (Georg Brandl)
Date: Sat, 30 Jul 2011 17:16:53 +0000
Subject: [docs] [issue12652] Keep test.support docs out of the global docs
	index
In-Reply-To: <1311925525.47.0.986284069415.issue12652@psf.upfronthosting.co.za>
Message-ID: <1312046213.52.0.6485259637.issue12652@psf.upfronthosting.co.za>


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

Why is it more useful to open a new issue for the same problem?

Nick: there is no such option right now, but I can customize our Sphinx build so that test.support is ignored when building the index.  I'll do that if no better consensus is reached on python-dev soon.

----------
assignee:  -> georg.brandl

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

From report at bugs.python.org  Sat Jul 30 19:27:56 2011
From: report at bugs.python.org (Eli Bendersky)
Date: Sat, 30 Jul 2011 17:27:56 +0000
Subject: [docs] [issue12652] Keep test.support docs out of the global docs
	index
In-Reply-To: <1311925525.47.0.986284069415.issue12652@psf.upfronthosting.co.za>
Message-ID: <1312046876.07.0.635804915848.issue12652@psf.upfronthosting.co.za>


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

Georg, since the issue was originally opened to track the solution, not the problem, I just figured it may be useful to mention that this solution was rejected and close the issue, for better historical record. Otherwise some years from now no one will remember what the debate was and that the solution was overruled in favor of another.

It's just an opinion, though. I don't have strong feelings about this.

----------

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

From report at bugs.python.org  Sat Jul 30 20:31:37 2011
From: report at bugs.python.org (Roundup Robot)
Date: Sat, 30 Jul 2011 18:31:37 +0000
Subject: [docs] [issue12531] documentation index entries for * and **
In-Reply-To: <1310385823.58.0.152505903133.issue12531@psf.upfronthosting.co.za>
Message-ID: <E1QnEJz-0004nM-Ui@dinsdale.python.org>


Roundup Robot <devnull at psf.upfronthosting.co.za> added the comment:

New changeset 8862ec62f9ee by Ezio Melotti in branch '3.2':
#12531: Fix spaces and markup.
http://hg.python.org/cpython/rev/8862ec62f9ee

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

New changeset 952e83a8bc78 by Ezio Melotti in branch '2.7':
#12531: Fix spaces.
http://hg.python.org/cpython/rev/952e83a8bc78

----------

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

From report at bugs.python.org  Sun Jul 31 04:59:17 2011
From: report at bugs.python.org (Senthil Kumaran)
Date: Sun, 31 Jul 2011 02:59:17 +0000
Subject: [docs] [issue12436] Provide reference to detailed installation
	instructions
In-Reply-To: <1309305395.29.0.101516779086.issue12436@psf.upfronthosting.co.za>
Message-ID: <1312081157.29.0.320140598311.issue12436@psf.upfronthosting.co.za>


Senthil Kumaran <senthil at uthcode.com> added the comment:

I propose we close this, because it adds a little value as a separate bug. If there are specific sections in the docs that can be improved, we can deal with that.

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

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

From report at bugs.python.org  Sun Jul 31 10:20:33 2011
From: report at bugs.python.org (Nick Coghlan)
Date: Sun, 31 Jul 2011 08:20:33 +0000
Subject: [docs] [issue12648] Wrong import module search order on Windows
In-Reply-To: <1311846003.79.0.904743673634.issue12648@psf.upfronthosting.co.za>
Message-ID: <1312100433.29.0.462964389752.issue12648@psf.upfronthosting.co.za>


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

The Windows build actually uses the registry to locate the standard library rather than sys.path. This is by design, but isn't really documented properly.

It means that code on sys.path (even in the current directory) won't shadow standard library modules on Windows.

Due to various arcane details about how it is implemented, the emulation of the main import system that is used to run code with the '-m' switch gets the search order the other way around and hence gives a different answer (the same answer as Linux) in cases like this.

----------
assignee:  -> docs at python
components: +Documentation -None
nosy: +docs at python

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

From dholth at gmail.com  Tue Jul 26 22:51:31 2011
From: dholth at gmail.com (Daniel Holth)
Date: Tue, 26 Jul 2011 16:51:31 -0400
Subject: [docs] urllib2.urlopen() seems to have worse documentation than
	urllib.urlopen()
Message-ID: <CAG8k2+5sJ4zzBoemvj_p1A9AOZynDxSWwrPhWW-4nVAs+KVRbg@mail.gmail.com>

I know I should probably be using httplib9 by now, but
urllib2.urlopen() doesn't document its return object's getcode()
method even though it seems to have one as documented in
urllib.urlopen()

Thanks,

Daniel Holth

From renaud.tripathi at laposte.net  Wed Jul 27 10:28:56 2011
From: renaud.tripathi at laposte.net (renaud.tripathi)
Date: Wed, 27 Jul 2011 10:28:56 +0200
Subject: [docs] search function for python 27 doc
Message-ID: <3557520.10351.1311755336196.JavaMail.www@wwinf8302>

Hello,
I installed the python 2.7 doc on my laptop (a HP 6720) which is running with Ubuntu 11.04. The search function seems to be stuck in a infinite loop when i try to use it.
best regards,
Renaud Tripathi

Une messagerie gratuite, garantie ? vie et des services en plus, ?a vous tente ?
Je cr?e ma bo?te mail www.laposte.net

From alex.heger at gmail.com  Fri Jul 29 15:45:56 2011
From: alex.heger at gmail.com (Alexander Heger)
Date: Fri, 29 Jul 2011 08:45:56 -0500
Subject: [docs] 15.9.11. SMTPHandler - bug?
Message-ID: <CALMUFh8oa06AGohVnHjT5HEEWhrc8ugCL+RgUORQVWSc=qMcRA@mail.gmail.com>

I use Python 2.7.1 that comes with the current Fedora 15
2.6.38.8-35.fc15.x86_64.
When I try to use the logging.handlers.SMTPHandler I get


Traceback (most recent call last):
  File "/usr/lib64/python2.7/logging/handlers.py", line 885, in emit
    smtp.starttls(*self.secure)
TypeError: starttls() argument after * must be a sequence, not bool
Logged from file <ipython console>, line 1

so it should be called with a tuple to make it work, not just a
Boolean.  Or the code needs to be changed, but maybe easier to just
change documentation

secure=(True,)

It still does not work in the end, however.


Traceback (most recent call last):
  File "/usr/lib64/python2.7/logging/handlers.py", line 885, in emit
    smtp.starttls(*self.secure)
  File "/usr/lib64/python2.7/smtplib.py", line 619, in starttls
    self.sock = ssl.wrap_socket(self.sock, keyfile, certfile)
  File "/usr/lib64/python2.7/ssl.py", line 344, in wrap_socket
    ciphers=ciphers)
  File "/usr/lib64/python2.7/ssl.py", line 119, in __init__
    ciphers)
TypeError: must be string or None, not bool


-Alexander

From kevbroch at gmail.com  Fri Jul 29 16:30:38 2011
From: kevbroch at gmail.com (Kevin Broch)
Date: Fri, 29 Jul 2011 07:30:38 -0700
Subject: [docs] PDF docs in smaller page format for ebook readers (Kindle)
Message-ID: <CAKWKLJBumWGyw-uU-qbfXzYtNThDbOthLiMjU4M53UhYcPEOPQ@mail.gmail.com>

Hello,

I would like to get the Python docs on to my Kindle for reading and reference
but the A4 and US Letter size PDFs provided http://docs.python.org/download.html
make the text impossible to read.

A google search has turned up some complicated
self attempts at doing this, but I thought I'd start at the source to
see if you'd be
receptive to providing some help.

I know supporting every request for a different size PDF would be
impossible but
wondered if you could either:

1) Provide the recipe for how the PDFs are created so I could generate
my desired
format

2) Provide at least a size that would be acceptable to most smaller
form ebook readers.
(I currently find that for my Kindle I create a page that is 3.6" x 4.8",
with all margins 0 except for the bottom which is 0.4" (needed for the
Kindles overlay of
percentage and page)

Best, /<evin

From ejimenez at lakeheadu.ca  Fri Jul 29 22:20:08 2011
From: ejimenez at lakeheadu.ca (Emil Jimenez)
Date: Fri, 29 Jul 2011 16:20:08 -0400
Subject: [docs] error in example :
	http://docs.python.org/release/3.1.3/library/stdtypes.html#dictionary-view-objects
Message-ID: <CALoPEwf5a-68C+zBtiKZZg3xfgsmQsZC2CNrBCkCXQiiRpaxPQ@mail.gmail.com>

In the "An example of dictionary view usage", the last output should
be "{'juice', 'sausage', 'bacon', 'spam'}", not "{'juice', 'eggs',
'bacon', 'spam'}"

-- PROPOSED CORRECT EXAMPLE --
Python 3.2 (r32:88445, Feb 20 2011, 21:29:02) [MSC v.1500 32 bit
(Intel)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>> dishes = {'eggs': 2, 'sausage': 1, 'bacon': 1, 'spam': 500}
>>> keys = dishes.keys()
>>> values = dishes.values()
>>>
>>> # iteration
... n = 0
>>> for val in values:
...     n += val
...
>>> print(n)
504
>>>
>>> # keys and values are iterated over in the same order
... list(keys)
['eggs', 'bacon', 'sausage', 'spam']
>>> list(values)
[2, 1, 1, 500]
>>>
>>> # view objects are dynamic and reflect dict changes
... del dishes['eggs']
>>> del dishes['sausage']
>>> list(keys)
['bacon', 'spam']
>>>
>>> # set operations
... keys & {'eggs', 'bacon', 'salad'}
{'bacon'}
>>> keys ^ {'sausage', 'juice'}
{'juice', 'sausage', 'bacon', 'spam'}
>>>


-- CURRENT INCORRECT EXAMPLE --

An example of dictionary view usage:

>>> dishes = {'eggs': 2, 'sausage': 1, 'bacon': 1, 'spam': 500}
>>> keys = dishes.keys()
>>> values = dishes.values()

>>> # iteration
>>> n = 0
>>> for val in values:
...     n += val
>>> print(n)
504

>>> # keys and values are iterated over in the same order
>>> list(keys)
['eggs', 'bacon', 'sausage', 'spam']
>>> list(values)
[2, 1, 1, 500]

>>> # view objects are dynamic and reflect dict changes
>>> del dishes['eggs']
>>> del dishes['sausage']
>>> list(keys)
['spam', 'bacon']

>>> # set operations
>>> keys & {'eggs', 'bacon', 'salad'}
{'bacon'}
>>> keys ^ {'sausage', 'juice'}
{'juice', 'eggs', 'bacon', 'spam'}

From TOM.S at INTERNODE.ON.NET  Sat Jul 30 15:57:53 2011
From: TOM.S at INTERNODE.ON.NET (Tom Sillence)
Date: Sat, 30 Jul 2011 23:57:53 +1000
Subject: [docs] Trivial argparse documentation bug.
Message-ID: <7B8D1098-EC50-49D6-8FE2-03F54B8611C1@INTERNODE.ON.NET>

Hi,

Re: the documentation for the standard library argparse module, there would seem to be a trivial mistake under "15.4.5.9. Exiting methods":

http://docs.python.org/library/argparse.html#exiting-methods

The ArgumentParser.error method is described as printing "a usage message ... to the standard output". In fact, though, the source suggests it is printed to standard error, not standard output.

Cheers!

Tom S.

From report at bugs.python.org  Sun Jul 31 15:13:17 2011
From: report at bugs.python.org (kota)
Date: Sun, 31 Jul 2011 13:13:17 +0000
Subject: [docs] [issue12648] Wrong import module search order on Windows
In-Reply-To: <1311846003.79.0.904743673634.issue12648@psf.upfronthosting.co.za>
Message-ID: <1312117997.16.0.450256248403.issue12648@psf.upfronthosting.co.za>


kota <nospam.kotarou.dono at gmail.com> added the comment:

So there isn't any way to load parser.py via import parser on Windows?

----------
components: +None -Documentation

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

From report at bugs.python.org  Sun Jul 31 16:33:57 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Sun, 31 Jul 2011 14:33:57 +0000
Subject: [docs] [issue12663] ArgumentParser.error writes to stderr not to
	stdout
In-Reply-To: <1312122837.61.0.0244813637126.issue12663@psf.upfronthosting.co.za>
Message-ID: <1312122837.61.0.0244813637126.issue12663@psf.upfronthosting.co.za>


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

Hello, following up http://mail.python.org/pipermail/docs/2011-July/005210.html , here's a patch to fix it. It applies to all the relevant branches.

----------
assignee: docs at python
components: Documentation
files: ArgumentParser.error_stderr-default.patch
keywords: patch
messages: 141467
nosy: docs at python, sandro.tosi
priority: normal
severity: normal
stage: patch review
status: open
title: ArgumentParser.error writes to stderr not to stdout
versions: Python 2.7, Python 3.2, Python 3.3
Added file: http://bugs.python.org/file22808/ArgumentParser.error_stderr-default.patch

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

From sandro.tosi at gmail.com  Sun Jul 31 16:34:34 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Sun, 31 Jul 2011 16:34:34 +0200
Subject: [docs] Trivial argparse documentation bug.
In-Reply-To: <7B8D1098-EC50-49D6-8FE2-03F54B8611C1@INTERNODE.ON.NET>
References: <7B8D1098-EC50-49D6-8FE2-03F54B8611C1@INTERNODE.ON.NET>
Message-ID: <CAPdtAj1JT06jw0OP2Km+23eJ3Vv5GToMjbU2NShSmNiA7Zf63w@mail.gmail.com>

Hello,

On Sat, Jul 30, 2011 at 15:57, Tom Sillence <TOM.S at internode.on.net> wrote:
> Hi,
>
> Re: the documentation for the standard library argparse module, there would seem to be a trivial mistake under "15.4.5.9. Exiting methods":
>
> http://docs.python.org/library/argparse.html#exiting-methods
>
> The ArgumentParser.error method is described as printing "a usage message ... to the standard output". In fact, though, the source suggests it is printed to standard error, not standard output.

Thanks for spotting it, I've just opened
http://bugs.python.org/issue12663 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  Sun Jul 31 17:08:32 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Sun, 31 Jul 2011 15:08:32 +0000
Subject: [docs] [issue12665] Dictionary view example has error in set ops
In-Reply-To: <1312124912.45.0.454246287313.issue12665@psf.upfronthosting.co.za>
Message-ID: <1312124912.45.0.454246287313.issue12665@psf.upfronthosting.co.za>


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

Hello, following up http://mail.python.org/pipermail/docs/2011-July/005209.html here's a patch to fix the example error on active 3.x branches.

----------
assignee: docs at python
components: Documentation
files: dict_view_examples-default.patch
keywords: patch
messages: 141469
nosy: docs at python, sandro.tosi
priority: normal
severity: normal
stage: patch review
status: open
title: Dictionary view example has error in set ops
versions: Python 3.2, Python 3.3
Added file: http://bugs.python.org/file22809/dict_view_examples-default.patch

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

From sandro.tosi at gmail.com  Sun Jul 31 17:09:58 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Sun, 31 Jul 2011 17:09:58 +0200
Subject: [docs] error in example :
	http://docs.python.org/release/3.1.3/library/stdtypes.html#dictionary-view-objects
In-Reply-To: <CALoPEwf5a-68C+zBtiKZZg3xfgsmQsZC2CNrBCkCXQiiRpaxPQ@mail.gmail.com>
References: <CALoPEwf5a-68C+zBtiKZZg3xfgsmQsZC2CNrBCkCXQiiRpaxPQ@mail.gmail.com>
Message-ID: <CAPdtAj36fiYRf2HyrH4L5WbtqBvuoEPrDsbZ+oy9gueF-hoFJQ@mail.gmail.com>

Hello,

On Fri, Jul 29, 2011 at 22:20, Emil Jimenez <ejimenez at lakeheadu.ca> wrote:
>>>> keys ^ {'sausage', 'juice'}
> {'juice', 'sausage', 'bacon', 'spam'}

Thanks for spotting it! I've just opened
http://bugs.python.org/issue12665 to fix it; please note that 3.1
won't be fixed since it's in security-only status (so only 3.2 and the
future 3.3) will have the correct example.

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

From report at bugs.python.org  Sun Jul 31 17:28:14 2011
From: report at bugs.python.org (Jason R. Coombs)
Date: Sun, 31 Jul 2011 15:28:14 +0000
Subject: [docs] [issue12666] map semantic change not documented in What's New
In-Reply-To: <1312126093.97.0.0321206475431.issue12666@psf.upfronthosting.co.za>
Message-ID: <1312126093.97.0.0321206475431.issue12666@psf.upfronthosting.co.za>


New submission from Jason R. Coombs <jaraco at jaraco.com>:

In `whatsnew/3.0.html`, there is little said about the map builtin:

map() and filter() return iterators. If you really need a list, a quick fix is e.g. list(map(...)), but a better fix is often to use a list comprehension (especially when the original code uses lambda), or rewriting the code so it doesn?t need a list at all. Particularly tricky is map() invoked for the side effects of the function; the correct transformation is to use a regular for loop (since creating a list would just be wasteful).

This suggests that all one must do to port to Python 3 is wrap map in list, and in fact this is what the 2to3 fixers do, when in fact, map is semantically different in how it handles arguments of different lengths. Consider the following.

    def to_tuple(*args):
        return args

    print(list(map(to_tuple, [1,2,3], [4,5,6,7])))

On Python 2, this code outputs:

[(1, 4), (2, 5), (3, 6), (None, 7)]

On Python 3, this code outputs:

[(1, 4), (2, 5), (3, 6)]

I suggest three fixes (in order of importance):

1) Document the difference in whatsnew/3.0.html.
2) Describe how one should port code of this usage to 3.0.
3) Incorporate the porting in the 2to3 fixer (if possible).

If no one objects, I'll begin on (1). Does anyone have any suggestions for a clean approach to (2)?

----------
assignee: docs at python
components: 2to3 (2.x to 3.0 conversion tool), Documentation
keywords: easy
messages: 141470
nosy: docs at python, jason.coombs
priority: normal
severity: normal
status: open
title: map semantic change not documented in What's New
type: behavior
versions: Python 3.1, Python 3.2, Python 3.3

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

From report at bugs.python.org  Sun Jul 31 18:02:30 2011
From: report at bugs.python.org (Jason R. Coombs)
Date: Sun, 31 Jul 2011 16:02:30 +0000
Subject: [docs] [issue12666] map semantic change not documented in What's New
In-Reply-To: <1312126093.97.0.0321206475431.issue12666@psf.upfronthosting.co.za>
Message-ID: <1312128150.45.0.556046543619.issue12666@psf.upfronthosting.co.za>


Jason R. Coombs <jaraco at jaraco.com> added the comment:

I believe the correct solution to (2) is to use itertools.zip_longest. So to port to Python 3, the example would use:

    print(list(map(to_tuple, itertools.zip_longest([1,2,3], [4,5,6,7]))))

----------

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

From sandro.tosi at gmail.com  Sun Jul 31 18:40:06 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Sun, 31 Jul 2011 18:40:06 +0200
Subject: [docs] PDF docs in smaller page format for ebook readers
	(Kindle)
In-Reply-To: <CAKWKLJBumWGyw-uU-qbfXzYtNThDbOthLiMjU4M53UhYcPEOPQ@mail.gmail.com>
References: <CAKWKLJBumWGyw-uU-qbfXzYtNThDbOthLiMjU4M53UhYcPEOPQ@mail.gmail.com>
Message-ID: <CAPdtAj0sD7TkD2Ks71UinqkVes=tO--D_dZJZJVU49nKDvagsw@mail.gmail.com>

Hello Kevin,

On Fri, Jul 29, 2011 at 16:30, Kevin Broch <kevbroch at gmail.com> wrote:
> Hello,
>
> I would like to get the Python docs on to my Kindle for reading and reference
> but the A4 and US Letter size PDFs provided http://docs.python.org/download.html
> make the text impossible to read.
>
> A google search has turned up some complicated
> self attempts at doing this, but I thought I'd start at the source to
> see if you'd be
> receptive to providing some help.
>
> I know supporting every request for a different size PDF would be
> impossible but

Thanks for your inderstanding :) It's nice to see kindle supporting
pdf docs, but give it's unique size, it's kinda difficult to provide
another PDF file only for

> wondered if you could either:
>
> 1) Provide the recipe for how the PDFs are created so I could generate
> my desired
> format

In order to build the doc you have to get the python source code, than
adapt the configuration files under Doc and rebuilt it. There are some
references at [1] and you'll probably need some knowledge of Sphinx
(the tool we use to build documentation from ReST files). You might
want to look at PAPER variable in Doc/Makefile, it might do the trick.

[1] http://docs.python.org/dev/documenting/index.html

> 2) Provide at least a size that would be acceptable to most smaller
> form ebook readers.
> (I currently find that for my Kindle I create a page that is 3.6" x 4.8",
> with all margins 0 except for the bottom which is 0.4" (needed for the
> Kindles overlay of
> percentage and page)

Actually, the correct solution would be to provide the documentation
also in the MOBI format. We already provide it in EPUB format, but
it's incompatible with kindle (if not converted, f.e. using Calibre).
I've just filed and issue[2] to the sphinx bug tracker asking to add
MOBI support.

[2] https://bitbucket.org/birkenfeld/sphinx/issue/739/please-add-a-mobi-builder

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  Sun Jul 31 20:01:18 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Sun, 31 Jul 2011 18:01:18 +0000
Subject: [docs] [issue12667] Better logging.handler.SMTPHandler doc for
	'secure'	argument
In-Reply-To: <1312135278.74.0.984312174238.issue12667@psf.upfronthosting.co.za>
Message-ID: <1312135278.74.0.984312174238.issue12667@psf.upfronthosting.co.za>


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

Hello, following up http://mail.python.org/pipermail/docs/2011-July/005207.html here are 2 patches to correct the documentation for 'secure' argument of SMTPHandler:

- the one for default (applicable also on 3.2) adds completely the 'secure' arg (missing)
- the one for 2.7 corrects the wrong information.

Both are taken from the docstring, that seems perfectly usable for the doc.

----------
assignee: docs at python
components: Documentation
files: logging_smtphandler_secure-default.patch
keywords: patch
messages: 141473
nosy: docs at python, sandro.tosi, vinay.sajip
priority: normal
severity: normal
stage: patch review
status: open
title: Better logging.handler.SMTPHandler doc for 'secure' argument
versions: Python 2.7, Python 3.2, Python 3.3
Added file: http://bugs.python.org/file22810/logging_smtphandler_secure-default.patch

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

From report at bugs.python.org  Sun Jul 31 20:01:26 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Sun, 31 Jul 2011 18:01:26 +0000
Subject: [docs] [issue12667] Better logging.handler.SMTPHandler doc for
	'secure'	argument
In-Reply-To: <1312135278.74.0.984312174238.issue12667@psf.upfronthosting.co.za>
Message-ID: <1312135286.94.0.00413629119334.issue12667@psf.upfronthosting.co.za>


Changes by Sandro Tosi <sandro.tosi at gmail.com>:


Added file: http://bugs.python.org/file22811/logging_smtphandler_secure-2.7.patch

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

From sandro.tosi at gmail.com  Sun Jul 31 20:03:38 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Sun, 31 Jul 2011 20:03:38 +0200
Subject: [docs] 15.9.11. SMTPHandler - bug?
In-Reply-To: <CALMUFh8oa06AGohVnHjT5HEEWhrc8ugCL+RgUORQVWSc=qMcRA@mail.gmail.com>
References: <CALMUFh8oa06AGohVnHjT5HEEWhrc8ugCL+RgUORQVWSc=qMcRA@mail.gmail.com>
Message-ID: <CAPdtAj23wM2_WtQNRiBhDEf_i1oz576VDGY_c-nODn9uTyWHdA@mail.gmail.com>

Hello Alexander,

On Fri, Jul 29, 2011 at 15:45, Alexander Heger <alex.heger at gmail.com> wrote:
> I use Python 2.7.1 that comes with the current Fedora 15
> 2.6.38.8-35.fc15.x86_64.
> When I try to use the logging.handlers.SMTPHandler I get
>
>
> Traceback (most recent call last):
> ?File "/usr/lib64/python2.7/logging/handlers.py", line 885, in emit
> ? ?smtp.starttls(*self.secure)
> TypeError: starttls() argument after * must be a sequence, not bool
> Logged from file <ipython console>, line 1
>
> so it should be called with a tuple to make it work, not just a
> Boolean. ?Or the code needs to be changed, but maybe easier to just
> change documentation
>
> secure=(True,)
>
> It still does not work in the end, however.

It's a bit more complicated than that: I've just filed
http://bugs.python.org/issue12667 to fix it. Thanks for spotting 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  Sun Jul 31 20:08:33 2011
From: report at bugs.python.org (Petri Lehtinen)
Date: Sun, 31 Jul 2011 18:08:33 +0000
Subject: [docs] [issue12183] Document behaviour of shutil.copy2 and copystat
	with	symlinks
In-Reply-To: <1312040280.03.0.299305836969.issue12183@psf.upfronthosting.co.za>
Message-ID: <20110731180829.GB2219@ihaa>


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

Senthil Kumaran wrote:
> When shutil.copy2 already says that it's behavior is equivalent to cp -p, will adding this sentence
> 
> +   Symbolic links are not preserved. The contents and metadata of the
> +   linked files are copied instead.
> 
> Not actively confuse the user? Because cp -p's behavior includes
> that and I dont see a special mention without giving more details is
> going to help.

You're right. Only copytree() seems to understand symlinks, so
deferencing symlinks is the "default" mode of operation.

I updated the patch to remove the first hunk.

----------
Added file: http://bugs.python.org/file22812/copy2_copytree_symlinks_2.7_v2.patch

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue12183>
_______________________________________
-------------- next part --------------
diff --git a/Doc/library/shutil.rst b/Doc/library/shutil.rst
index 1b160d8..99ee111 100644
--- a/Doc/library/shutil.rst
+++ b/Doc/library/shutil.rst
@@ -105,8 +108,9 @@ Directory and files operations
    :func:`copy2`.
 
    If *symlinks* is true, symbolic links in the source tree are represented as
-   symbolic links in the new tree; if false or omitted, the contents of the
-   linked files are copied to the new tree.
+   symbolic links in the new tree, but the metadata of the original links is NOT
+   copied; if false or omitted, the contents and metadata of the linked files
+   are copied to the new tree.
 
    If *ignore* is given, it must be a callable that will receive as its
    arguments the directory being visited by :func:`copytree`, and a list of its

From sandro.tosi at gmail.com  Sun Jul 31 21:42:39 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Sun, 31 Jul 2011 21:42:39 +0200
Subject: [docs] search function for python 27 doc
In-Reply-To: <3557520.10351.1311755336196.JavaMail.www@wwinf8302>
References: <3557520.10351.1311755336196.JavaMail.www@wwinf8302>
Message-ID: <CAPdtAj2-N0PCZtqhUSs3dAb13mfyRMpnUDmtG1zMEo9mfo9xJQ@mail.gmail.com>

Hello Renaud,

On Wed, Jul 27, 2011 at 10:28, renaud.tripathi
<renaud.tripathi at laposte.net> wrote:
> Hello,
> I installed the python 2.7 doc on my laptop (a HP 6720) which is running with Ubuntu 11.04. The search function seems to be stuck in a infinite loop when i try to use it.

Did you download the documentation from python.org site or did you
installed the ubuntu package?

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

From sandro.tosi at gmail.com  Sun Jul 31 21:47:38 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Sun, 31 Jul 2011 21:47:38 +0200
Subject: [docs] Description of 'secure' argument for
 logging.handlers.SMTPHandler isn't up to date
In-Reply-To: <CAG4oqp1ZDJoArkXT3U6bqwJtrqiVSTdC45-MnuHAvJ_sAT5iKQ@mail.gmail.com>
References: <CAG4oqp1ZDJoArkXT3U6bqwJtrqiVSTdC45-MnuHAvJ_sAT5iKQ@mail.gmail.com>
Message-ID: <CAPdtAj2bXPz8LOuess9eswmZH3jU1GEHReOY1yDn2qMq7YgnBA@mail.gmail.com>

Hi Jesaja,
for another report, I filed http://bugs.python.org/issue12667 some
hours ago, to have your same report fixed. Thanks for spotting it!

Cheers,
Sandro

On Fri, Jul 22, 2011 at 18:12, Jesaja Everling <jeverling at gmail.com> wrote:
> Hi,
>
> the docs for logging.handlers.SMTPHandler are not up to date.
>
> Docs:
> http://docs.python.org/library/logging.handlers.html#logging.handlers.SMTPHandler
>
> "If secure is True, then the handler will attempt to use TLS for the
> email transmission.".
>
>
> Docstring:
> http://hg.python.org/cpython/file/c6e63c67efd5/Lib/logging/handlers.py#l833
>
> "To specify the use of a secure protocol (TLS), pass in a tuple for
> the secure argument.
> This will only be used when authentication credentials are supplied.
> The tuple will be either an empty tuple, or a single-value tuple with
> the name of a keyfile,
> or a 2-value tuple with the names of the keyfile and certificate file.
> (This tuple is passed to the `starttls` method)."
>
> Just in case nobody noticed this before.
>
> Best Regards,
>
> Jesaja Everling
> _______________________________________________
> docs mailing list
> docs at python.org
> http://mail.python.org/mailman/listinfo/docs
>



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

From sandro.tosi at gmail.com  Sun Jul 31 21:52:50 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Sun, 31 Jul 2011 21:52:50 +0200
Subject: [docs] documentation bug in Python v3.3a0 documentation Python
	HOWTO
In-Reply-To: <8CE18F5612624BB-1A54-1ABDF@webmail-d026.sysops.aol.com>
References: <8CE18F5612624BB-1A54-1ABDF@webmail-d026.sysops.aol.com>
Message-ID: <CAPdtAj3gsgR4veuTK8gmK29gYiboxVCasZSstACo4JnYqi9WBA@mail.gmail.com>

Hello Steve,

On Mon, Jul 25, 2011 at 17:19, Steve <sjmcdonald at aol.com> wrote:
> ?Descriptor How-To Guide
> In Definition and Introduction: double word They are used used throughout
> Python

It was just fixed in 3.3[1] and also on 2.7 and 3.2 . Thanks for spotting it!

[1] http://hg.python.org/cpython/rev/fe0d3fab0812

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

From report at bugs.python.org  Sun Jul 31 23:19:40 2011
From: report at bugs.python.org (Sandro Tosi)
Date: Sun, 31 Jul 2011 21:19:40 +0000
Subject: [docs] [issue12668] 3.2 What's New: it's integer->string,
	not the opposite
In-Reply-To: <1312147179.72.0.252519921224.issue12668@psf.upfronthosting.co.za>
Message-ID: <1312147179.72.0.252519921224.issue12668@psf.upfronthosting.co.za>


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

Hello, following up http://mail.python.org/pipermail/docs/2011-July/005087.html, here's a patch to fix the 3.2 What's New section.

----------
assignee: docs at python
components: Documentation
files: whatsnew_3.2_int2str-default.patch
keywords: patch
messages: 141476
nosy: docs at python, sandro.tosi
priority: normal
severity: normal
stage: patch review
status: open
title: 3.2 What's New: it's integer->string, not the opposite
versions: Python 3.2, Python 3.3
Added file: http://bugs.python.org/file22813/whatsnew_3.2_int2str-default.patch

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

From sandro.tosi at gmail.com  Sun Jul 31 23:20:17 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Sun, 31 Jul 2011 23:20:17 +0200
Subject: [docs] Minor doc bug
In-Reply-To: <CAApUq=WsHbDt8wniLsOvFo-u-M_5BACP4e7=0UABifcg_7ooaA@mail.gmail.com>
References: <CAApUq=WsHbDt8wniLsOvFo-u-M_5BACP4e7=0UABifcg_7ooaA@mail.gmail.com>
Message-ID: <CAPdtAj2E-X9UcNvGUJe4-A8Sv11A+uHzgMt+16at287pmKPbTw@mail.gmail.com>

Hello Jay,

On Fri, Jul 22, 2011 at 02:17, Jay Dresser <jay at jaydresser.us> wrote:
> http://docs.python.org/py3k/whatsnew/3.2.html#optimizations
> ? ? "String to integer conversions now work two ?digits? at a time, reducing
> the number of division and modulo operations."
> String to integer uses multiplication. ? Integer to string uses?division and
> modulo.
> I'm not sure what you meant, but since division is more costly than
> multiplication, I suspect you meant
> ? ? "Integer to string conversions now work two ?digits? at a time, reducing
> the number of division and modulo operations."
> (doing modulo 100 instead of modulo 10)
> I could be wrong since the fractional part of floating point numbers would
> use?division (but not modulo) for string to integer.

Thanks for spotting it! They were indeed swapped: I've just filed
http://bugs.python.org/issue12668 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 sandro.tosi at gmail.com  Sun Jul 31 23:30:53 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Sun, 31 Jul 2011 23:30:53 +0200
Subject: [docs] Broken link in Python 2.7.2 Tutorial
In-Reply-To: <201106260840.31807.remcoj@xs4all.nl>
References: <201106260840.31807.remcoj@xs4all.nl>
Message-ID: <CAPdtAj0UroQBgHgdWYSRjQQXgPiEdF4+XP761+jEwFs+Y7H45A@mail.gmail.com>

Hello,
thanks for your email.

On Sun, Jun 26, 2011 at 02:40, Remco Janssen <remcoj at xs4all.nl> wrote:
> 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.

I'm not seeing this behavior right now, can you confirm it's gone?

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

From sandro.tosi at gmail.com  Sun Jul 31 23:36:56 2011
From: sandro.tosi at gmail.com (Sandro Tosi)
Date: Sun, 31 Jul 2011 23:36:56 +0200
Subject: [docs] 'Programming FAQ &mdash;
	Python v2.7.2 documentation' international
In-Reply-To: <4E004857.3080308@consultant.com>
References: <4E004857.3080308@consultant.com>
Message-ID: <CAPdtAj0jqwRNUMdNd2cCf9tZwfijds7v=XNDo=4ijPjRBViEyQ@mail.gmail.com>

Hello Alyona,
thanks for your interest in Python and in its doc translation.

On Tue, Jun 21, 2011 at 09:29, Alyona Lompar
<alyona.lompar at consultant.com> wrote:
> 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.

I can't provide any authorization in the name of the PSF but I can
point to a translation project we'd like to advertize more in the
future: http://pootle.python.org/pootle - maybe you can translate the
doc there, so all the users will benefit from your work?

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

From mlclapp at htdteam.com  Wed Jul 27 21:40:23 2011
From: mlclapp at htdteam.com (Michael L. Clapp)
Date: Wed, 27 Jul 2011 15:40:23 -0400
Subject: [docs] Turtle docs
Message-ID: <982AB0587FC89F42AB7350C61728A83F1BA8E9@hoosier1.htdteam.local>

Hi

 

Just a small thing. On your web page:
http://docs.python.org/py3k/library/turtle.html, at about the 4th line
down it is stated "Give it the command turtle.left(25), and it rotates
in-place 25 degrees clockwise." That statement needs to be corrected to
either say "Give it the command turtle.right (25), and it rotates
in-place 25 degrees clockwise." or" Give it the command turtle.left(25),
and it rotates in-place 25 degrees counterclockwise."

 

Thank you

 

Mike Clapp

Hoosier Tool & Die

812.376.8286 X129

 

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

From giecrilj at stegny.2a.pl  Sat Jul 30 23:40:28 2011
From: giecrilj at stegny.2a.pl (=?utf-8?q?K=C5=99i=C5=A1tof_=C5=BDelechovski?=)
Date: Sat, 30 Jul 2011 23:40:28 +0200
Subject: [docs] How to start IDLE?
Message-ID: <201107302340.33204.giecrilj@stegny.2a.pl>

The section 24.5.4.1. "Command line usage" says:

> idle.py [-c command] [-d] [-e] [-s] [-t title] [arg] ...

There is no ?idle.py?, the command is ?idle?.

> If the script name is ?-?, no script is executed but an interactive Python session is started; the arguments are still available in sys.argv.

{ idle -; } waits for standard input.

___
[1] <URL: http://docs.python.org/py3k/library/idle.html#command-line-usage >

From t4chacko+cq at gmail.com  Sun Jul 31 23:31:28 2011
From: t4chacko+cq at gmail.com (t4C+Cq)
Date: Sun, 31 Jul 2011 14:31:28 -0700
Subject: [docs] Python-2.3.3/pdf/ref.pdf
Message-ID: <CAB7OhvxONoATXFP9nK+7uwjLiXbxN_ga1vV4b-P2tuynfmfz4Q@mail.gmail.com>

http://www.compsci.wm.edu/SciClone/documentation/software/compilers/Python-2.3.3/pdf/ref.pdf

Hi,

I understand the url above is not yours, but the content is.  The above pdf
has an unsual repeating error in that all occurances 'fi' even within the
middle of a word has become blank!  I wonder why that occurred?

In any case, can you refer me to another availabe pdf versrion of your
python documentation online?

Thanks,
Cordially,
Cn
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/docs/attachments/20110731/01bcb6a2/attachment.html>