Mailman 3 May 2010 - docs

[issue8660] py3k weakref documentation mentions the long built-in type
by Daniel Urban May 8, 2010

May 8, 2010

New submission from Daniel Urban <urban.dani+py(a)gmail.com>: There is a sentence in the weakref module's documentation: "Other built-in types such as tuple and long do not support weak references even when subclassed" But there is no "long" type in py3k. ---------- assignee: docs@python components: Documentation messages: 105285 nosy: docs@python, durban priority: normal severity: normal status: open title: py3k weakref documentation mentions the long built-in type versions: Python 3.1,… [View More]

2 1

Inversion in the documentation of 'xml.dom'
by Vincent Ollivier May 7, 2010

May 7, 2010

Hi, There is a little inversion in the documentation of 'xml.dom': http://docs.python.org/library/xml.dom.html """ 19.6.2.3. NodeList Objects A NodeList represents a sequence of nodes. These objects are used in two ways in the DOM Core recommendation: the Element objects provides one as its list of child nodes, and the getElementsByTagName() and getElementsByTagNameNS() methods of Node return objects with this interface to represent query results. """ It is the 'Node' objects who provides '… [View More]

1 0

Suggested improvement to turtle module doc
by Richard Jones May 7, 2010

May 7, 2010

Hi all, I'm planning on playing turtle with my daughter tomorrow and figured I should look into how to get going before I do so. It took me far longer than it should have to figure out how to do the most basic thing: from an interactive prompt (or elsewhere!) get the turtle window up and have a controllable turtle. In the end I just guessed and created a Turtle and it worked - though I still struggle to see where this is mentioned in the docs. I believe the docs would benefit greatly from a … [View More]

1 0

typo in logging documentation
by David Lindquist May 6, 2010

May 6, 2010

Hello, I found a typo in the logger documentation: http://docs.python.org/library/logging.html#logging.handlers.FileHandler http://docs.python.org/library/logging.html#logging.handlers.StreamHandler These show FileHandler and StreamHandler as being defined in the logging.handlers module, when in fact they are defined in the core logging package. Cheers, David Lindquist Phoenix, AZ USA

1 0

unicode in 3.1
by Bojan Djuric May 6, 2010

May 6, 2010

u'Hello World !' from page http://docs.python.org/tutorial/introduction.html#unicode-strings does not work. Python 3.1, windows xp. probably cause http://docs.python.org/release/3.0.1/whatsnew/3.0.html , "3.1.3. Unicode Strings" part. Maybe you can add link to release page in tutorial, if not updating it. BR,

2 1

[issue8628] Incorrect numbers.Complex.imag documentation
by Daniel Urban May 5, 2010

May 5, 2010

New submission from Daniel Urban <urban.dani+py(a)gmail.com>: The current documentation of the imag abstract property of numbers.Complex is this: "Abstract. Retrieves the Real component of this number." Of course the imag attribute is the imaginary component, not the real. ---------- assignee: docs@python components: Documentation messages: 105048 nosy: docs@python, durban priority: normal severity: normal status: open title: Incorrect numbers.Complex.imag documentation versions: Python … [View More]

3 2

[issue8626] TypeError: rsplit() takes no keyword arguments
by Antoine Pitrou May 5, 2010

May 5, 2010

Antoine Pitrou <pitrou(a)free.fr> added the comment: This is more of a documentation issue than anything else. The fact that the argument is named "maxsplit" and accepts a default value doesn't mean it's usable as a keyword argument. It would be difficult to document a parameter without giving it a name anyway... As a rule of thumb, methods accepting 2 parameters or less often don't accept any keyword arguments, since there's no point in doing so. I suggest closing this issue. --------… [View More]

1 0

logging.handlers StreamHandler/FileHandler
by Brian Johnson May 5, 2010

May 5, 2010

http://docs.python.org/library/logging.html#handler-objects The FileHandler and StreamHandler are specified as being in logging.handers. but they're actually in logging. -- Brian Johnson -- Mobius Works <http://mobiusworks.net> o: 413-564-6942x104 | m: 413-531-2859

1 0

[issue8593] Improve c-api/arg.rst
by Antoine Pitrou May 3, 2010

May 3, 2010

New submission from Antoine Pitrou <pitrou(a)free.fr>: This patch fixes, reorders and improves c-api/arg.rst. I would even suggest to go further and single out a couple of "most useful" formats ('s', 'y*', 'i', 'l'...) so that people don't get lost in all the possibilities. ---------- assignee: docs@python components: Documentation files: argdoc.patch keywords: patch messages: 104736 nosy: docs@python, pitrou priority: normal severity: normal stage: patch review status: open title: … [View More]

1 2

socket programming HOWTO - correction for bind to ''
by David Lim May 3, 2010

May 3, 2010

http://docs.python.org/howto/sockets.html it says: A couple things to notice: we used socket.gethostname() so that the socket would be visible to the outside world. If we had used s.bind(('',80)) or s.bind(('localhost', 80)) or s.bind(('127.0.0.1', 80)) we would still have a “server” socket, but one that was only visible within the same machine. Actually I believe if you do s.bind(('',80)), that corresponds to INADDR_ANY for the host which means that socket is visible to the outside world.… [View More]

1 0