Mailman 3 May 2013 - docs

[issue14191] argparse doesn't allow optionals within positionals
by paul j3 May 6, 2013

May 6, 2013

paul j3 added the comment: This is the formal patch corresponding to the `test_intermixed.py`. It includes changes to `argparse.rst`, plus tests in `test_argparse.py`. These tests are near the end, after those for `parse_known_args`. They are roughly equivalent to the examples in `test_intermixed.py`. ----------------- The new documentation section is: Some users expect to freely intermix optional and positional argument strings. For example, optparse, by default, allows interspersed … [View More]

1 0

[issue14191] argparse doesn't allow optionals within positionals
by paul j3 May 6, 2013

May 6, 2013

paul j3 added the comment: This is a revision of the test_intermixed.py that I submitted earlier. Now `parse_intermixed_args` acts like `parse_args', and calls `parse_known_intermixed_args`. Again it is form that can exercise the idea without modifying `argparse.py`. If the parser has incompatible features (REMAINDER, PARSER, or certain exclusive groups), it raises an error. However to facilitate testing I included a `_fallback` backdoor. If not default None it will be called instead of … [View More]

1 0

[issue14187] add "annotation" entry to Glossary
by Chris Rebert May 6, 2013

May 6, 2013

New submission from Chris Rebert <pybugs(a)rebertia.com>: The Glossary should include an entry for "annotation" and/or "function annotation" regarding the language feature introduced by PEP 3107. ---------- assignee: docs@python components: Documentation messages: 154852 nosy: cvrebert, docs@python priority: normal severity: normal status: open title: add "annotation" entry to Glossary versions: Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.… [View More]

8 23

[issue17910] Usage error in multiprocessing documentation
by Andriy Mysyk May 6, 2013

May 6, 2013

New submission from Andriy Mysyk: "As mentioned above, when doing concurrent programming it is usually best to avoid using shared state as far as possible" should say "as much as possible" in multiprocessing.rst. ---------- assignee: docs@python components: Documentation messages: 188461 nosy: amysyk, docs@python priority: normal severity: normal status: open title: Usage error in multiprocessing documentation type: enhancement versions: Python 3.4 _______________________________________ … [View More]

2 3

urlparse second example wrong output?
by Catalin Patulea May 5, 2013

May 5, 2013

In the second example for urlparse: http://docs.python.org/3.4/library/urllib.parse.html?highlight=urlparse >>> urlparse('www.cwi.nl/%7Eguido/Python.html') ParseResult(scheme='', netloc='', path='www.cwi.nl:80/%7Eguido/Python.html', params='', query='', fragment='') I think the "path=" component is wrong. ":80" shouldn't be there. Here is what happens in 2.7: In [2]: urlparse('www.cwi.nl/%7Eguido/Python.html') Out[2]: ParseResult(scheme='', netloc='', path='www.cwi.nl/%… [View More]

1 0

Edits to descriptor howto (issue 17894)
by ezio.melotti＠gmail.com May 4, 2013

May 4, 2013

http://bugs.python.org/review/17894/diff/8064/Doc/howto/descriptor.rst File Doc/howto/descriptor.rst (right): http://bugs.python.org/review/17894/diff/8064/Doc/howto/descriptor.rst#newc… Doc/howto/descriptor.rst:39: with ``a.__dict__['x']``, then ``type(a).__dict__['x']``, and continuing This sentence seems too detailed to me, especially in the "Introduction" http://bugs.python.org/review/17894/diff/8064/Doc/howto/descriptor.rst#newc… Doc/howto/descriptor.rst:43: descriptor methods are … [View More]

1 0

Different documentation for identical methods (issue 17858)
by ezio.melotti＠gmail.com May 4, 2013

May 4, 2013

http://bugs.python.org/review/17858/diff/8017/Doc/library/threading.rst File Doc/library/threading.rst (right): http://bugs.python.org/review/17858/diff/8017/Doc/library/threading.rst#new… Doc/library/threading.rst:371: necessary waiting until it is released by another thread (only one thread at a These lines are too long. http://bugs.python.org/review/17858/diff/8017/Doc/library/threading.rst#new… Doc/library/threading.rst:377: unconditionally as above. This paragraph could be simplified. "… [View More]

1 0

[issue17546] Document the circumstances where the locals() dict get updated
by Ezio Melotti May 3, 2013

May 3, 2013

Changes by Ezio Melotti <ezio.melotti(a)gmail.com>: ---------- nosy: +ncoghlan stage: needs patch -> patch review _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue17546> _______________________________________

1 0

Minor bug in ArgumentParser doc?
by Ulf Renman May 2, 2013

May 2, 2013

Hi In section 15.4.2.11 http://docs.python.org/2/library/argparse.html#add-help The last sentance reads "In this case, the first character in prefix_chars is used to prefix the help options:", but that is not what the example code following it shows. I have not tried this code myself, but there is clearly selfcontradiction in the documentation here. /Ulf Renman

1 0

[issue1722] Undocumented urllib functions
by Senthil Kumaran May 2, 2013

May 2, 2013

Senthil Kumaran added the comment: I had added a note in the documentation c3656dca65e7 conveying that splittype, splithost should not be relied upon, and urlparse should be used for parsing. Also, Python3 does not include these in __all__ - It is in Python2 for backwards compatibility purposes. It is not possible provide deprecation warning to things we leave off from __all__ from subsequent versions of python. I consider this request as resolved. Thanks! ---------- resolution: -> fixed … [View More]

1 0