Mailman 3 June 2013 - docs

Improvement on argparse documentation
by Vincenzo Pii 12 Jun '13

12 Jun '13

In the "short options" paragraph ( http://docs.python.org/2/howto/argparse.html#short-options), please specify that when only the short option is provided for one argument, the value of the option can be accessed by using the name of the short option without the '-' character. Example: parser.add_argument("-b", help="builds the application", action="store_true") if (args.b == True): Thanks, Vincenzo.

1 0

Documentation Error
by Watson, Will 12 Jun '13

12 Jun '13

>>> word[2:5] # characters from position 2 (included) to 4 (excluded) On page http://docs.python.org/3/tutorial/introduction.html should be "to 5 (excluded)" Will Watson Consultant | ISG Technology 25 Cabot Square | Canary Wharf | Floor 03 London, E14 4QA Phone: +44 20 7425-8353 Mobile: +44 77878-92439 Will.Watson(a)morganstanley.com<mailto:Will.Watson@morganstanley.com> Be carbon conscious. Please consider our environment before printing this email. ________________________________ NOTICE: Morgan Stanley is not acting as a municipal advisor and the opinions or views contained herein are not intended to be, and do not constitute, advice within the meaning of Section 975 of the Dodd-Frank Wall Street Reform and Consumer Protection Act. If you have received this communication in error, please destroy all electronic and paper copies and notify the sender immediately. Mistransmission is not intended to waive confidentiality or privilege. Morgan Stanley reserves the right, to the extent permitted under applicable law, to monitor electronic communications. This message is subject to terms available at the following link: http://www.morganstanley.com/disclaimers If you cannot access these links, please notify us by reply message and we will send the contents to you. By messaging with Morgan Stanley you consent to the foregoing.

1 0

[issue18187] Fix broken link in Doc/library/venv.rst
by Berker Peksag 12 Jun '13

12 Jun '13

New submission from Berker Peksag: The correct location of the venv module is Lib/venv, not Lib/venv.py. Attaching a simple patch that fixes the location. ---------- assignee: docs@python components: Documentation files: venv-location.diff keywords: patch messages: 190958 nosy: berker.peksag, docs@python priority: normal severity: normal status: open title: Fix broken link in Doc/library/venv.rst versions: Python 3.3, Python 3.4 Added file: http://bugs.python.org/file30543/venv-location.diff _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue18187> _______________________________________

3 2

Trivial error in documentation
by Brad Aylsworth 12 Jun '13

12 Jun '13

On http://docs.python.org/3.3/tutorial/introduction.html#strings I found an error that really doesn't matter and that most people can probably understand as a typo, but I thought I'd report it. >>>word[0:2] # characters from position 0 (included) to 2 (excluded) 'Py' >>>word[2:*5*] # characters from position 2 (included) to*4* (excluded) 'tho' As far as I can tell, that should say "5 (excluded)".

1 0

Collin Winter's functional module (http://docs.python.org/2.6/howto/functional.html#the-functional-module)
by Justin High 12 Jun '13

12 Jun '13

The links for Collin Winter's module appear broken in the 2.6 documentation here: http://docs.python.org/2.6/howto/functional.html#the-functional-module They currently link to a GoDaddy.com landing page. http://oakwinter.com/?nr=0 - Justin High

1 0

Lambda Forms' explanation should be improved
by aseem bansal 11 Jun '13

11 Jun '13

In the documentation of Python 2.7.5 I was going through the tutorials and read 4.7.5 Lambda Forms. After reading it I was completely lost about what is this thing. The explanation about features of functional programming being added isn't helpful at all for someone without functional programming experience. The explanation should be improved. The explanation at codecademy.com at http://www.codecademy.com/courses/python-beginner-en-KAgt5?curriculum_id=4f… is better than the official documentation. Perhaps some ideas can be taken from the website?

1 0

[issue18176] Builtins documentation refers to old version of UCD.
by Serhiy Storchaka 11 Jun '13

11 Jun '13

Changes by Serhiy Storchaka <storchaka(a)gmail.com>: ---------- components: +Documentation, Unicode nosy: +ezio.melotti _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue18176> _______________________________________

1 0

[issue18176] Builtins documentation refers to old version of UCD.
by Alexander Belopolsky 11 Jun '13

11 Jun '13

Alexander Belopolsky added the comment: This is a trivial change, but I would like someone to review this in case there is a better solution to keep this in sync with unicodedata.unidata_version. ---------- assignee: -> docs@python keywords: +needs review nosy: +docs@python stage: -> commit review _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue18176> _______________________________________

1 0

Re: [docs] Code, test, and doc review for PEP-0435 Enum (issue 17947)
by zachary.ware＠gmail.com 10 Jun '13

10 Jun '13

Barring any typos in the not-yet-uploaded v12 patch, everything looks good to me now. Thanks, Ethan! http://bugs.python.org/review/17947/diff/8339/Doc/library/enum.rst File Doc/library/enum.rst (right): http://bugs.python.org/review/17947/diff/8339/Doc/library/enum.rst#newcode4… Doc/library/enum.rst:423: One frequent request is to not have to specify values for enum members:: On 2013/06/10 16:13:01, stoneleaf wrote: > Major rewrite: Much better :) http://bugs.python.org/review/17947/

1 0

Re: [docs] Code, test, and doc review for PEP-0435 Enum (issue 17947)
by ethan＠stoneleaf.us 10 Jun '13

10 Jun '13

http://bugs.python.org/review/17947/diff/8339/Doc/library/enum.rst File Doc/library/enum.rst (right): http://bugs.python.org/review/17947/diff/8339/Doc/library/enum.rst#newcode2… Doc/library/enum.rst:292: Added: .. warning:: In order to support the singleton nature of enumeration members, pickle protocol version 2 or higher must be used. http://bugs.python.org/review/17947/

1 0