Mailman 3 August 2012 - docs

Language Missing in Python
by Isaac Munjunga 14 Aug '12

14 Aug '12

I can't find my language every time I update my Ubuntu distro. Kindly include and update locale: 'en_ZM': 'en_GB.ISO8859-1', 'en_ZM.iso88591': 'en_GB.ISO8859-1', I manually include that, but I know someone people may not have the time to do it. Thanks, Isaac

2 1

Small error in the "Extending Python with C" page
by Hadrien Titeux 14 Aug '12

14 Aug '12

Hello, I've recenty started to try using C code in python using the wonderful python API, although i have to say the learning curve was non neglectable :P I've spotted what I believe to be a small mistake in the documentation from this page: http://docs.python.org/release/3.2/extending/extending.html In paragraph 1.8 (http://docs.python.org/release/3.2/extending/extending.html#keyword-paramet…), the code example given contains an error, which is actually obsolete code from python 2.7: void initkeywdarg(void) { /* Create the module and add the functions */ Py_InitModule("keywdarg", keywdarg_methods); } This doesn't work in Python3.2. It's supposed to be static struct PyModuleDef keywdargmodule = { PyModuleDef_HEAD_INIT, "keywdarg", /* name of module */ keywdarg_doc, /* module documentation, may be NULL */ -1, /* size of per-interpreter state of the module, or -1 if the module keeps state in global variables. */ keywdarg_methods }; PyMODINIT_FUNC PyInit_keywdarg(void) { return PyModule_Create(&keywdargmodule); } As explained above (and confirmed by experience). Thanks for your work, Hadrien.

2 1

Grammatical error
by b99902035＠csie.ntu.edu.tw 14 Aug '12

14 Aug '12

Under http://docs.python.org/py3k/tutorial/inputoutput.html#fancier-output-format…, "(or will force a SyntaxError if there is not equivalent syntax)" should be "(or will force a SyntaxError if there is __no__ equivalent syntax)". Regards. ---------------------------------------------------------------- This message was sent using IMP, the Internet Messaging Program.

2 1

Little mistake
by Christoph Müller 14 Aug '12

14 Aug '12

On http://docs.python.org/py3k/tutorial/introduction.html: *code * *prints * *instead of * word[4] 'p' 'A' word[0:2] 'AH' 'He' word[2:4] 'el' 'lp'

1 2

re.VERBOSE whitespace behavior not completely documented (issue 15606)
by ezio.melotti＠gmail.com 14 Aug '12

14 Aug '12

http://bugs.python.org/review/15606/diff/5718/Doc/library/re.rst File Doc/library/re.rst (right): http://bugs.python.org/review/15606/diff/5718/Doc/library/re.rst#newcode540 Doc/library/re.rst:540: extension construct (so, for example, ``(?P<a_or_b> a | b)`` is a Reading this it seems to me that ``( ?:`` is allowed. Maybe saying something like "within tokens like ``(?:`` or ``(?P<...>``" is better. http://bugs.python.org/review/15606/diff/5718/Doc/library/re.rst#newcode546 Doc/library/re.rst:546: the leftmost such ``'#'`` through the end of the line are ignored. I find this paragraph a bit confusing, and would rephrase it to something like: """ All the text after and including the ``'#'`` character is considered as comment and ignored, unless the ``'#'`` is in a character class or it's preceded by an unescaped backslash. """ http://bugs.python.org/review/15606/

1 0

Re: [docs] Typo in the String docs
by Sandro Tosi 14 Aug '12

14 Aug '12

Hello Ramon, On Mon, Aug 13, 2012 at 2:09 PM, Ramon Royo Giner <rroyog(a)uoc.edu> wrote: > "Helloo".replace('oo', 'o') #does work -> "Hello" > "Helloo".replace('Helloo', 'oo', 'o') #doesnt work, throws a type error, > because 'o' is in the place of the third argument (maxreplace), which should > be an int I'm sorry, I could have used some examples to make my original email more clear. What you're doing is using the replace() method of the string object: >>> s = "Helloo" >>> type(s) <type 'str'> which has the first argument already "filled": >>> s.replace('oo', 'o') 'Hello' so you don't need to specify once again the string it operates on. In the example you cited in the original email refers to the replace() function of the string module: >>> import string >>> string.replace('Helloo', 'oo', 'o') 'Hello' Regards, -- Sandro Tosi (aka morph, morpheus, matrixhasu) My website: http://matrixhasu.altervista.org/ Me at Debian: http://wiki.debian.org/SandroTosi

1 0

Re: [docs] Provide some examples for usage of ElementTree methods/attributes (issue 15586)
by eliben＠gmail.com 14 Aug '12

14 Aug '12

http://bugs.python.org/review/15586/diff/5726/Doc/library/xml.etree.element… File Doc/library/xml.etree.elementtree.rst (right): http://bugs.python.org/review/15586/diff/5726/Doc/library/xml.etree.element… Doc/library/xml.etree.elementtree.rst:102: import xml.etree.ElementTree as ET Please fix this similarly to my fix for the 3.3 patch The parse method you call returns an element, not a tree, and anyway there's a shorter way (ET.parse function) http://bugs.python.org/review/15586/diff/5726/Doc/library/xml.etree.element… Doc/library/xml.etree.elementtree.rst:111: :func:`fromstring` parses XML from a string directly into an :class:`Element`, Please also align here for the fixed 3.3 patch http://bugs.python.org/review/15586/

1 0

[issue15497] correct characters in TextWrapper.replace_whitespace docs
by Chris Jerdonek 13 Aug '12

13 Aug '12

New submission from Chris Jerdonek: This issue is to correct the list of whitespace characters to replace in the documentation for the textwrap module's TextWrapper.replace_whitespace attribute. The documentation says this list is string.whitespace: http://docs.python.org/dev/library/textwrap.html#textwrap.TextWrapper.repla… However, the code deliberately avoids using string.whitespace and uses a hard-coded list of characters instead. For example, see this code comment: # Hardcode the recognized whitespace characters to the US-ASCII # whitespace characters. The main reason for doing this is that in # ISO-8859-1, 0xa0 is non-breaking whitespace, so in certain locales # that character winds up in string.whitespace.... http://hg.python.org/cpython/file/917295aaad76/Lib/textwrap.py#l12 Patch attached. ---------- assignee: docs@python components: Documentation files: issue-textwrap-whitespace.patch keywords: easy, patch messages: 166855 nosy: cjerdonek, docs@python priority: normal severity: normal stage: patch review status: open title: correct characters in TextWrapper.replace_whitespace docs versions: Python 2.7, Python 3.3 Added file: http://bugs.python.org/file26591/issue-textwrap-whitespace.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15497> _______________________________________

3 3

[issue15628] Add import ABC hierarchy to docs for importlib
by Brett Cannon 13 Aug '12

13 Aug '12

Brett Cannon added the comment: http://hg.python.org/cpython/rev/1c8a6df94602 seems to be commit this. ---------- resolution: -> fixed stage: -> committed/rejected status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15628> _______________________________________

1 0

[issue15561] update subprocess docs to reference io.TextIOWrapper
by Chris Jerdonek 13 Aug '12

13 Aug '12

New submission from Chris Jerdonek: This is an issue to update the subprocess module documentation after updates to io.TextIOWrapper's documentation here: http://hg.python.org/cpython/rev/f17a1410ebe5 This issue was discussed briefly on python-dev: http://mail.python.org/pipermail/python-dev/2012-August/121239.html Patch attached. ---------- assignee: docs@python components: Documentation files: issue-subprocess-docs-1.patch keywords: easy, patch messages: 167512 nosy: cjerdonek, docs@python, haypo priority: normal severity: normal stage: patch review status: open title: update subprocess docs to reference io.TextIOWrapper versions: Python 3.3 Added file: http://bugs.python.org/file26703/issue-subprocess-docs-1.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15561> _______________________________________

3 18