Mailman 3 July 2010 - docs

[issue7303] pkgutil lacks documentation for useful functions
by Éric Araujo July 17, 2010

July 17, 2010

Éric Araujo <merwok(a)netwok.org> added the comment: Thanks for your help proposal Ulrik. If I understand the documentation correctly, docstrings should contain enough usage information but not too much. In pkgutil, some examples and long explanations could be removed after you move them to the reST doc. Make sure to work from a checkout of 3.2 (branch named py3k) to have the latest updates. This page contains some tips about patches: http://www.python.org/dev/patches/ You can ask any questions here or on the docs(a)python.org mailing list. Thanks again. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue7303> _______________________________________

1 0

[issue4819] Misc/cheatsheet needs updating
by Éric Araujo July 17, 2010

July 17, 2010

Changes by Éric Araujo <merwok(a)netwok.org>: ---------- assignee: georg.brandl -> docs@python nosy: +docs@python versions: +Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue4819> _______________________________________

1 0

[issue6722] collections.namedtuple: confusing example
by Éric Araujo July 17, 2010

July 17, 2010

Changes by Éric Araujo <merwok(a)netwok.org>: ---------- nosy: +docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue6722> _______________________________________

1 0

[issue8910] Write a text file explaining why Lib/test/data exists
by Éric Araujo July 17, 2010

July 17, 2010

Éric Araujo <merwok(a)netwok.org> added the comment: Adding people listed for the testing interest area in the maintainers file. ---------- nosy: +giampaolo.rodola, michael.foord, pitrou _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8910> _______________________________________

1 0

Bug in email example
by Doug Carter July 17, 2010

July 17, 2010

On the page: http://docs.python.org/library/email-examples.html At the bottom, under the heading: Here's an example of how to create an HTML message with an alternative plain text version: In the code sample, the import from lines are incorrect: from email.mime.multipart import MIMEMultipart from email.mime.text import MIMEText They should be: from email.MIMEMultipart import MIMEMultipart from email.MIMEText import MIMEText Best, Doug Carter

2 1

[issue9274] code.InteractiveInterpreter fails to change locals when invoked in a function
by Eric Promislow July 16, 2010

July 16, 2010

Eric Promislow <ericp(a)activestate.com> added the comment: David, that won't work for a reason I'll get into in a bit. I would drop the priority of this ... Komodo has a had a Python debugger since late 2000, we only fixed updating variables while debugging (using the variable viewer) yesterday, and received fewer than 10 complaints about that over the years. While looking at the code, something seemed wrong with our handling of the variables in the interactive shell. I tested it, and it failed, and then wrote the standalone Python code to isolate the problem. Your solution will work sometimes, but not completely. When you're in interactive mode while debugging, you can type arbitrary Python code, but can also use the variable viewer in the UI to change variables. These two functions are handled by different code paths. My recommendation is to resolve this as a limitation, and document the module. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9274> _______________________________________

1 0

[issue9274] code.InteractiveInterpreter fails to change locals when invoked in a function
by R. David Murray July 16, 2010

July 16, 2010

R. David Murray <rdmurray(a)bitdance.com> added the comment: Well, you could discuss that possibility on python-dev, I suppose. As long as you don't need the changes to persist outside of the debugging loop, you can use InteractiveInterpreter as designed and keep passing it the same (modified) dict every time, as was done in the pdb fix. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9274> _______________________________________

1 0

[issue9274] code.InteractiveInterpreter fails to change locals when invoked in a function
by Eric Promislow July 16, 2010

July 16, 2010

Eric Promislow <ericp(a)activestate.com> added the comment: Thanks for the response. Note that our use case *is* to implement Python-console functionality, but sometimes we do this in the context of a currently running Python program, inside a function. That's why I wrote the repro that way. Using code.InteractiveInterpreter(locals()).runsource(...) in a function corresponds to interacting with the debugger in a function, while the second call to runsource() corresponds to interacting with the program when it's stepping through top-level code. Keep in mind that all of this takes place while control flow of the main program is stuck in the debugger's read-eval-print loop. It would be useful if there was a way of accessing the localsplus container in Python code ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9274> _______________________________________

1 0

[issue9274] code.InteractiveInterpreter fails to change locals when invoked in a function
by R. David Murray July 16, 2010

July 16, 2010

R. David Murray <rdmurray(a)bitdance.com> added the comment: locals() does not give you a copy of the locals dictionary that you can modify and expect the values to affect the actual locals they were copied from. This is documented: http://docs.python.org/library/functions.html#locals You would need to pass InteractiveInterpreter the "real" locals dict from the frame to make your code work, and it sounds like you've already done this. However, I don't believe that this is going to work in the general case (eg: in the face of nested scopes), which is why locals() is not updatable. The use case for InteractiveInterpreter is implementing a python-command-line-like utility, and thus has no need to update the locals in the current function. A doc note about this in InteractiveInterpreter along the lines of the one in the 'exec' docs is almost certainly appropriate, so I'll leave this open as a doc bug. ---------- assignee: -> docs@python components: +Documentation -Interpreter Core nosy: +docs@python stage: -> needs patch versions: +Python 2.7, Python 3.1, Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9274> _______________________________________

1 0

[issue459007] Document sys.path on Windows
by Mark Hammond July 16, 2010

July 16, 2010

Mark Hammond <mhammond(a)users.sourceforge.net> added the comment: FWIW, I think the rules are fairly well explained in the comments in PC/getpathp.c; last time I looked at this, the only thing I couldn't really decide was where in the official docs these comments should be put (after reformatting and minor rewording etc) ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue459007> _______________________________________

1 0