Mailman 3 June 2017 - docs

[issue30558] [Suggestion] Improve documentation for set() API
by Raymond Hettinger June 3, 2017

June 3, 2017

Raymond Hettinger added the comment: This looks like an invalid request. ---------- assignee: docs@python -> rhettinger _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue30558> _______________________________________

1 0

[issue30558] [Suggestion] Improve documentation for set() API
by Ned Deily June 3, 2017

June 3, 2017

Changes by Ned Deily <nad(a)python.org>: ---------- nosy: +rhettinger status: pending -> open _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue30558> _______________________________________

1 0

[issue30558] [Suggestion] Improve documentation for set() API
by Martin Panter June 3, 2017

June 3, 2017

Martin Panter added the comment: Did you see <https://docs.python.org/3.6/library/stdtypes.html#set-types-set-frozenset>? ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python, martin.panter status: open -> pending _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue30558> _______________________________________

1 0

[issue24899] Add an os.path <=> pathlib equivalence table in pathlib docs
by Ezio Melotti June 2, 2017

June 2, 2017

New submission from Ezio Melotti: I think it would be useful to add to the pathlib documentation a table listing os/os.path operations and their pathlib equivalent. This will be useful both for people porting their code to pathlib and for people that already know os/os.path and want to get familiar with pathlib. ---------- assignee: docs@python components: Documentation keywords: easy messages: 248877 nosy: docs@python, ezio.melotti, pitrou priority: normal severity: normal stage: needs patch status: open title: Add an os.path <=> pathlib equivalence table in pathlib docs type: enhancement versions: Python 3.4, Python 3.5, Python 3.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue24899> _______________________________________

7 10

[issue30550] Document order-preserving dictionary output in json
by Eric O. LEBIGOT June 2, 2017

June 2, 2017

Changes by Eric O. LEBIGOT <eric.lebigot(a)normalesup.org>: ---------- assignee: -> docs@python components: +Documentation -Library (Lib) nosy: +docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue30550> _______________________________________

1 0

Error in code at : 15.4 (argparser)
by Herat Kalaria June 2, 2017

June 2, 2017

Hi, I got an error while executing the code given in example 15.4.1. Error is: too few arguments. Please look into this. Thanks & Regards Herat Kalaria

1 0

[issue29660] Document that print/format_exception ignore etype
by Matthias Bussonnier June 1, 2017

June 1, 2017

New submission from Matthias Bussonnier: As far as I can tell, http://bugs.python.org/issue17911 made a couple of function in traceback ignore their first arguments (etype) and infer the type from the second one (evalue). (In git 6bc2c1e7 and 2f0441f0 respectively). At least print_exception and format_exception are affected. This likely affect http://bugs.python.org/issue26389 (who wish to expand same API to remove these parameters). And inconsistency with `format_exception_only` which does need `etype` should be checked. If etype is a deprecated parameter it should be noted, and should likely raise a DeprecationWarning as well when set. ---------- assignee: docs@python components: Documentation messages: 288617 nosy: docs@python, mbussonn priority: normal severity: normal status: open title: Document that print/format_exception ignore etype versions: Python 3.5, Python 3.6, Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29660> _______________________________________

2 11

[issue29920] Document cgitb.text and cgitb.html
by Xavier Morel June 1, 2017

June 1, 2017

New submission from Xavier Morel: Currently, cgitb documents the hook (enable) and somewhat unclearly the ability to dump the HTML traceback to stdout, but despite that being technically available it does not document the ability to dump the traceback to a string as either text or html. Possible further improvement: make ``cgitb.html`` and ``cgitb.text`` implicitly call `sys.exc_info()` if not given a parameter (much like `cgitb.handler` does). ---------- assignee: docs@python components: Documentation messages: 290608 nosy: docs@python, xmorel priority: normal pull_requests: 747 severity: normal status: open title: Document cgitb.text and cgitb.html type: enhancement versions: Python 2.7, Python 3.6, Python 3.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue29920> _______________________________________

4 10

RE documentation question
by bob gailer June 1, 2017

June 1, 2017

I discovered a match object property "regs" which contains the start and end positions of the entire match and of each group. This is exactly what I need. But it is not documented. Is that an oversight, or does it mean it might change in the future?

1 1

[issue30499] Deprecated note in set documentation
by Julien Palard June 1, 2017

June 1, 2017

New submission from Julien Palard: While translating doc to french, I found a surprising comment in stdtypes.html about sets, stating: > To support searching for an equivalent frozenset, the elem set is temporarily mutated during the search and then restored. During the search, the elem set should not be read or mutated since it does not have a meaningful value. So I searched the equivalent in the code, at least to help me understand it to translate it in a proper way, but found it has been deleted in 51ced7afe72d861b46f069d757f2787f13253d32. This commit is in branches 2.7 and 3.1 to 3.6 (and master). ---------- assignee: docs@python components: Documentation messages: 294662 nosy: docs@python, mdk, rhettinger priority: normal severity: normal status: open title: Deprecated note in set documentation versions: Python 2.7, Python 3.5, Python 3.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue30499> _______________________________________

4 12