Mailman 3 November 2012 - docs

[issue16157] Irrelevant references to Misc/News
by Serhiy Storchaka Nov. 17, 2012

Nov. 17, 2012

New submission from Serhiy Storchaka: Older versions (3.2 for 3.3, 3.2 and 3.3 for 3.4) whatsnew refers to Misc/News which contains changes only for currect version ("For full details, see the :source:`Misc/NEWS <Misc/NEWS>` file."). http://docs.python.org/3.3/whatsnew/3.2.html http://docs.python.org/3.4/whatsnew/3.2.html http://docs.python.org/3.4/whatsnew/3.3.html ---------- assignee: docs@python components: Documentation messages: 172321 nosy: docs@python, serhiy.storchaka priority: normal severity: normal status: open title: Irrelevant references to Misc/News type: behavior versions: Python 3.3, Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue16157> _______________________________________

5 6

[issue15292] import hook behavior documentation improvement
by Anders Hammarquist Nov. 17, 2012

Nov. 17, 2012

New submission from Anders Hammarquist <iko(a)iko.pp.se>: When testing Eutaxia on PyPy (1.9) I discovered a discrepancy in the path_hooks import hook implementation. In CPython (2.7), if the find_module() method raises ImportError (as imp.find_module() does when it does not find a module in the given path), will cause the search to continue, whereas PyPy would propagate the ImportError. PyPy has now been changed to behave like CPython. The documentation is not entirely clear, but it does not explicitly document the import hook mechanism as eating an ImportError in find_module(). It should probably be made explicit, which ever way it should be. It is not obvious what is the correct behaviour, given the implicit relative imports, where the ImportError simply means that the import hook cannot find the module. Quick testing on CPython 3.3 indicates that it behaves like PyPy did, but as it doesn't do implicit relative imports my test case didn't work as it was. For 3.3, without implicit relative imports, propagating the ImportError feels like the correct behaviour. The attached demonstration needs a file /tmp/test/foo.py that does a top-level import, e.g. "import errno" to demonstrate the discrepancy. ---------- assignee: docs@python components: Documentation files: testimport.py messages: 164998 nosy: docs@python, iko priority: normal severity: normal status: open title: import hook behavior documentation improvement type: behavior versions: Python 2.7 Added file: http://bugs.python.org/file26315/testimport.py _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15292> _______________________________________

4 6

[issue10224] Build 3.x documentation using python3.x
by Brett Cannon Nov. 17, 2012

Nov. 17, 2012

Brett Cannon added the comment: What exactly is blocking this? From looking on PyPI it seems Jinja2, Pygments, and Sphinx have all been ported to Python 3 at this point. Is it a matter of porting any custom code in Doc/ to Python 3 and then updating the Makefile to grab Python 3 versions of the required libraries? ---------- dependencies: -Fix doctest runable examples in python manual _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10224> _______________________________________

1 0

[issue8402] Add a function to escape metacharacters in glob/fnmatch
by Ezio Melotti Nov. 17, 2012

Nov. 17, 2012

Ezio Melotti added the comment: The workaround is now documented. I'm still not sure if this should still be added, or if it should be closed as rejected now that the workaround is documented. A third option would be adding it as a recipe in the doc, given that the whole functions boils down to a single re.sub (the user can take care of picking the bytes/str regex depending on his input). ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8402> _______________________________________

1 0

Improve doc for str(bytesobject) (issue 13538)
by ezio.melotti＠gmail.com Nov. 17, 2012

Nov. 17, 2012

http://bugs.python.org/review/13538/diff/6548/Doc/library/functions.rst File Doc/library/functions.rst (right): http://bugs.python.org/review/13538/diff/6548/Doc/library/functions.rst#new… Doc/library/functions.rst:1263: If neither *encoding* nor *errors* is given, ``str(object)`` returns s/returns/calls/? http://bugs.python.org/review/13538/diff/6548/Doc/library/functions.rst#new… Doc/library/functions.rst:1264: :meth:`object.__str__`, which is the "informal" representation of *object*. Why not keeping the "nicely printable representation" used in the original text? http://bugs.python.org/review/13538/diff/6548/Doc/library/functions.rst#new… Doc/library/functions.rst:1264: :meth:`object.__str__`, which is the "informal" representation of *object*. Doesn't it also fall back on __repr__ if __str__ is missing? http://bugs.python.org/review/13538/diff/6548/Doc/library/functions.rst#new… Doc/library/functions.rst:1266: function with related behavior. "with related behavior" doesn't add much IMHO. Either drop it and use "See also the repr function." or say what repr does. http://bugs.python.org/review/13538/diff/6548/Doc/library/functions.rst#new… Doc/library/functions.rst:1271: :class:`bytes` (or :class:`bytearray`) object in this case, then s/in this case//? http://bugs.python.org/review/13538/diff/6548/Doc/library/functions.rst#new… Doc/library/functions.rst:1279: or *errors* arguments uses the first mode (see also the :option:`-b` s/uses the first mode/calls b.__str__()/? http://bugs.python.org/review/13538/diff/6548/Doc/reference/datamodel.rst File Doc/reference/datamodel.rst (right): http://bugs.python.org/review/13538/diff/6548/Doc/reference/datamodel.rst#n… Doc/reference/datamodel.rst:1168: Called by :func:`str(object) <str>` and the built-in function :func:`print` Should string formatting be mentioned too? http://bugs.python.org/review/13538/diff/6548/Doc/reference/datamodel.rst#n… Doc/reference/datamodel.rst:1176: back to calling :meth:`__repr__`. Where does this happen? Is it done by str/print or it happens automatically? http://bugs.python.org/review/13538/diff/6548/Lib/test/test_unicode.py File Lib/test/test_unicode.py (right): http://bugs.python.org/review/13538/diff/6548/Lib/test/test_unicode.py#newc… Lib/test/test_unicode.py:1194: self.assertEqual(str(b'foo', errors="strict"), "foo") A test with non-ascii (most likely utf-8) bytes should be added. http://bugs.python.org/review/13538/

1 0

[issue16240] Document a way to escape metacharacters in glob/fnmatch
by Serhiy Storchaka Nov. 17, 2012

Nov. 17, 2012

New submission from Serhiy Storchaka: fnmatch.translate's docstraing says "There is no way to quote meta-characters.", but this is wrong. One can remove the special meaning of ``'?'``, ``'*'`` and ``'['`` by wrapping them between square brackets. Thus, ``'[?]'`` matches the literal character ``'?'``. There are a lot of related issues: issue8402, issue13929, issue9358, issue738389, issue738361, issue1580472, issue5852. ---------- assignee: docs@python components: Documentation files: fnmatch_doc_escape.patch keywords: easy, patch messages: 172976 nosy: docs@python, serhiy.storchaka priority: high severity: normal status: open title: Document a way to escape metacharacters in glob/fnmatch type: behavior versions: Python 2.7, Python 3.2, Python 3.3, Python 3.4 Added file: http://bugs.python.org/file27581/fnmatch_doc_escape.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue16240> _______________________________________

3 8

[issue16420] PEP 249 (DB-API 2.0) converted to reStructuredText
by Daniele Varrazzo Nov. 17, 2012

Nov. 17, 2012

New submission from Daniele Varrazzo: I've converted the DBAPI to reST, mostly to allow linking from external documentation. It would be great to replace the current text only version with it. File attached. ---------- assignee: docs@python components: Documentation files: pep-0249.txt messages: 174965 nosy: docs@python, lemburg, piro priority: normal severity: normal status: open title: PEP 249 (DB-API 2.0) converted to reStructuredText type: enhancement Added file: http://bugs.python.org/file27908/pep-0249.txt _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue16420> _______________________________________

5 7

[issue16470] Backport set and dictionary comprehensions in tutorial to 2.7
by Yongzhi Pan Nov. 17, 2012

Nov. 17, 2012

New submission from Yongzhi Pan: Dictionary and set comprehensions are backported to 2.7 in issue #2333. The are not documented in the tutorial of 2.7, though they are in the language reference. Is it OK to add these to the tutorial? I've uploaded a patch. ---------- assignee: docs@python components: Documentation files: set_and_dict_comprehensions.diff keywords: patch messages: 175547 nosy: docs@python, fossilet priority: normal severity: normal status: open title: Backport set and dictionary comprehensions in tutorial to 2.7 type: enhancement versions: Python 2.7 Added file: http://bugs.python.org/file27982/set_and_dict_comprehensions.diff _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue16470> _______________________________________

6 7

try-except-raise-bug
by Hans Larsen Nov. 17, 2012

Nov. 17, 2012

Med venlig hilsen: Hans Larsen Galgebakken Sønder 4-11A DK-2620 Albertslund Danmark/Danio I found a bug in Python3.3! See the attached file: Where is “.. During handling of the above exception, another exception occured: ...”? I use Windows 7 Home Premium 64bit, and installed Python 3.3.0 final 64bit

1 0

[issue16484] Missing/broken documentation redirect for http://docs.python.org/library/xml.etree.ElementTree
by Marius Gedminas Nov. 16, 2012

Nov. 16, 2012

New submission from Marius Gedminas: Do this: pydoc2.7 xml.etree.ElementTree then click on the MODULE DOCS link, which is http://docs.python.org/library/xml.etree.ElementTree You're redirected to http://docs.python.org/2/library/xml.etree.ElementTree which is a 404 page. ---------- assignee: docs@python components: Documentation messages: 175675 nosy: docs@python, mgedmin priority: normal severity: normal status: open title: Missing/broken documentation redirect for http://docs.python.org/library/xml.etree.ElementTree versions: Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue16484> _______________________________________

2 2