Mailman 3 April 2013 - docs

Documentation improvement suggestion
by Evgeni Sergeev April 5, 2013

April 5, 2013

Proposed improvement for the page http://docs.python.org/2/library/stdtypes.html#set The elements of a set must be hashable. The elements of a set must be :term:`hashable`.

2 1

Typographical Change
by Anthony Dodd April 5, 2013

April 5, 2013

Correcting this typo should improve readability of this documentation. Location: http://docs.python.org/3/howto/argparse.html#id1 Search: Let’s also change the rest of the program make the new functionality makes more sense Replace: Let’s also change the rest of the program to make the new functionality make more sense —— Anthony Josiah Dodd Phone: 512-417-1411 Work: Anthony(a)FirebrandTech.com Personal: Dodd.AnthonyJosiah(a)Gmail.com

2 1

Typo In Documentation
by Anthony Dodd April 5, 2013

April 5, 2013

Greetings Python team. I often find typographical errors in the python documentation, though it is quite nice by and large. I will do my best to report them for now on. If such is unwanted, please let me know via my personal email. *TYPO:* *Search Replace Location-Address* There’s two There are two http://docs.python.org/3/howto/argparse.html#id1 -- *Anthony Josiah Dodd* | eBook Ninja Anthony(a)FirebrandTech.com <anthony(a)firebrandtech.com> <work> Dodd.… [View More]

2 1

Re: [docs] Profile objects should be documented (issue 6696)
by ezio.melotti＠gmail.com April 4, 2013

April 4, 2013

http://bugs.python.org/review/6696/diff/7348/Doc/library/profile.rst File Doc/library/profile.rst (left): http://bugs.python.org/review/6696/diff/7348/Doc/library/profile.rst#oldcod… Doc/library/profile.rst:10: :synopsis: Python source profiler. Why have you removed these? http://bugs.python.org/review/6696/diff/7348/Doc/library/profile.rst File Doc/library/profile.rst (right): http://bugs.python.org/review/6696/diff/7348/Doc/library/profile.rst#newcod… Doc/library/profile.rst:8: :source:`… [View More]Modules/_lsprof.c` and :source:`Lib/pstats.py` :source:`Lib/cProfile.py` and :source:`Modules/_lsprof.c` shouldn't be included IMHO. http://bugs.python.org/review/6696/diff/7348/Doc/library/profile.rst#newcod… Doc/library/profile.rst:63: cProfile.run('foo(x)') Why this change? It seems easier to me to say that if you want to profile the function foo you can call .run('foo()'). http://bugs.python.org/review/6696/diff/7348/Doc/library/profile.rst#newcod… Doc/library/profile.rst:77: 43/3 0.533 0.012 0.749 0.250 pobject.py:99(evaluate) I think it would be even better to use a real-world example that users can run (maybe you can thing about something better than re.compile), e.g.: >>> import cProfile >>> import re >>> cProfile.run('re.compile("foo|bar")') 197 function calls (192 primitive calls) in 0.002 seconds Ordered by: standard name ncalls tottime percall cumtime percall filename:lineno(function) 1 0.000 0.000 0.001 0.001 <string>:1(<module>) 1 0.000 0.000 0.001 0.001 re.py:212(compile) 1 0.000 0.000 0.001 0.001 re.py:268(_compile) 1 0.000 0.000 0.000 0.000 sre_compile.py:172(_compile_charset) 1 0.000 0.000 0.000 0.000 sre_compile.py:201(_optimize_charset) 4 0.000 0.000 0.000 0.000 sre_compile.py:25(_identityfunction) 3/1 0.000 0.000 0.000 0.000 sre_compile.py:33(_compile) http://bugs.python.org/review/6696/diff/7348/Doc/library/profile.rst#newcod… Doc/library/profile.rst:104: provides the respective data of each function The end of lines are inconsistent. You can remove the trailing commas and full stop. http://bugs.python.org/review/6696/diff/7348/Doc/library/profile.rst#newcod… Doc/library/profile.rst:280: Profile the cmd via :func:`exec` with the specified global and local environment. Line too long (there are a few others that are longer than 80 chars too). http://bugs.python.org/review/6696/diff/7348/Doc/library/profile.rst#newcod… Doc/library/profile.rst:397: +------------------+----------------------+ Here you could use the simpler table syntax: ====== ====== header header ====== ====== row1 row1 row2 row2 ... ... ====== ====== http://bugs.python.org/review/6696/diff/7348/Doc/library/profile.rst#newcod… Doc/library/profile.rst:418: .. For compatibility with the old profiler, s/,/./ http://bugs.python.org/review/6696/diff/7348/Doc/library/profile.rst#newcod… Doc/library/profile.rst:447: printed; as of Python 1.5b1, this uses the Perl-style regular This can probably be removed. http://bugs.python.org/review/6696/diff/7348/Doc/library/profile.rst#newcod… Doc/library/profile.rst:618: interpreted differently: This could point to the different times available in the time module, and possibly provide some suggestion. http://bugs.python.org/review/6696/ [View Less]

2 1

[issue8913] Document that datetime.__format__ is datetime.strftime
by Brett Cannon April 4, 2013

April 4, 2013

New submission from Brett Cannon <brett(a)python.org>: Documenting that would help get people using datetime objects with string.format more. ---------- assignee: docs@python components: Documentation keywords: easy messages: 107179 nosy: brett.cannon, docs@python priority: low severity: normal status: open title: Document that datetime.__format__ is datetime.strftime versions: Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8913> _______________________________________

12 28

[issue15964] SyntaxError in asdl when building 2.7 with system Python 3
by Roger Serwy April 4, 2013

April 4, 2013

Roger Serwy added the comment: The attached patch allows the same parser code to run under Python 2 and Python 3. I'm not sure how to test it other than by running the test suite which passed. ---------- Added file: http://bugs.python.org/file29677/patch_2and3.py _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15964> _______________________________________

1 0

[issue16399] argparse: append action with default list adds to list instead of overriding
by paul j3 April 4, 2013

April 4, 2013

paul j3 added the comment: The test file, test_argparse.py, has a test case for this: 'class TestOptionalsActionAppendWithDefault' argument_signatures = [Sig('--baz', action='append', default=['X'])] successes = [ ('--baz a --baz b', NS(baz=['X', 'a', 'b'])), ] ---------- nosy: +paul.j3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue16399> _______________________________________

1 0

Re: [docs] Document that datetime.__format__ is datetime.strftime (issue 8913)
by ezio.melotti＠gmail.com April 4, 2013

April 4, 2013

On 2012/11/04 20:02:50, Heikki Partanen wrote: > http://bugs.python.org/review/8913/diff/6442/Doc/library/datetime.rst > File Doc/library/datetime.rst (right): > > http://bugs.python.org/review/8913/diff/6442/Doc/library/datetime.rst#newco… > Doc/library/datetime.rst:616: 'John in 2002' > The idea there is to emphasize the handiness of being able to format a > date(time) within a single str.format() call. If there are no other parameters > in the example, this advantage … [View More]

1 0

[issue15964] SyntaxError in asdl when building 2.7 with system Python 3
by Ezio Melotti April 4, 2013

April 4, 2013

Ezio Melotti added the comment: Do you want to provide a patch and test that it works? ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15964> _______________________________________

1 0

[issue15331] Codecs docs should explain that the bytes-bytes shorthand aliases are missing
by Ezio Melotti April 3, 2013

April 3, 2013

Ezio Melotti added the comment: Should they just be removed from the table then? ---------- versions: +Python 3.4 -Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15331> _______________________________________

1 0