Mailman 3 June 2014 - docs

[issue8840] truncate() semantics changed in 3.1.2
by Mark Lawrence June 7, 2014

June 7, 2014

Mark Lawrence added the comment: Is any more work needed here as msg106725 asks about updating doc strings? ---------- nosy: +BreamoreBoy _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8840> _______________________________________

1 0

[issue21662] datamodel documentation: fix typo and phrasing
by Steve Dougherty June 5, 2014

June 5, 2014

New submission from Steve Dougherty: "Should" was missing an o, and putting the reason first makes the sentence flow better. ---------- assignee: docs@python components: Documentation files: typo2.diff keywords: patch messages: 219763 nosy: docs@python, sdougherty priority: normal severity: normal status: open title: datamodel documentation: fix typo and phrasing versions: Python 3.5 Added file: http://bugs.python.org/file35484/typo2.diff _______________________________________ Python … [View More]

3 2

[issue21653] Row.keys() in sqlite3 returns a list, not a tuple
by Andrew McKinlay June 5, 2014

June 5, 2014

New submission from Andrew McKinlay: The documentation here (https://docs.python.org/2/library/sqlite3.html#sqlite3.Row.keys) says that the method returns a tuple. It returns a list. ---------- assignee: docs@python components: Documentation messages: 219724 nosy: amckinlay, docs@python priority: normal severity: normal status: open title: Row.keys() in sqlite3 returns a list, not a tuple versions: Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org… [View More]

4 4

[issue21661] setuptools documentation: typo
by Steve Dougherty June 5, 2014

June 5, 2014

New submission from Steve Dougherty: Typo - "it's" is a contraction for "it is" or "it has." "Its" is the posessive form. ---------- assignee: docs@python components: Documentation files: typo1.diff keywords: patch messages: 219762 nosy: docs@python, sdougherty priority: normal severity: normal status: open title: setuptools documentation: typo type: enhancement versions: Python 3.5 Added file: http://bugs.python.org/file35483/typo1.diff _______________________________________ Python … [View More]

3 2

Fwd: Doc suggestions re exceptions
by Georg Brandl June 5, 2014

June 5, 2014

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 - -------- Original Message -------- Subject: Doc suggestions re exceptions Date: Thu, 5 Jun 2014 10:07:37 +0100 From: Mark Summerfield <mark(a)qtrac.eu> Organization: Qtrac Ltd. To: Georg Brandl <georg(a)python.org> Hi Georg, If you look on this page: https://docs.python.org/3.4/library/getpass.html#module-getpass The docs for getpass.getuser() say "...otherwise, an exception is raised." But does not specify what that exception … [View More]

1 0

[issue21637] Add a warning section exaplaining that tempfiles are opened in binary mode
by Sebastian Kreft June 3, 2014

June 3, 2014

New submission from Sebastian Kreft: Although it is already explained that the default mode of the opened tempfiles is 'w+b' a warning/notice section should be included to make it clearer. I think this is important as the default for the open function is to return strings and not bytes. I just had to debug an error with traceback, as traceback.print_exc expects a file capable of handling unicode. ---------- assignee: docs@python components: Documentation messages: 219585 nosy: Sebastian.… [View More]

3 2

Improve help('non-topic') response (issue 19980)
by zachary.ware＠gmail.com June 3, 2014

June 3, 2014

Other than fixing the test (see comment), this looks pretty good to me. http://bugs.python.org/review/19980/diff/12043/Lib/test/test_pydoc.py File Lib/test/test_pydoc.py (right): http://bugs.python.org/review/19980/diff/12043/Lib/test/test_pydoc.py#newco… Lib/test/test_pydoc.py:210: 'Use help(str) for help on the str class.') Define this as """ os.linesep.join(['No Python...', 'Use help("...', 'Use help(str...', ]) """ to avoid the line … [View More]

1 0

[issue21439] Numerous minor issues in Language Reference
by Roundup Robot June 3, 2014

June 3, 2014

Roundup Robot added the comment: New changeset be8492101251 by Zachary Ware in branch '3.4': Issue #21439: Fix a couple of typos. http://hg.python.org/cpython/rev/be8492101251 New changeset 99b469758f49 by Zachary Ware in branch 'default': Issue #21439: Merge with 3.4 http://hg.python.org/cpython/rev/99b469758f49 ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue21439> _______________________________________

1 0

[issue21640] References to other Python version in sidebar of documentation index is not up to date
by Auke Willem Oosterhoff June 3, 2014

June 3, 2014

New submission from Auke Willem Oosterhoff: Most version of the documentation are labeling Python 3.4 as 'in development' and missing reference to Python 3.5. ---------- Added file: http://bugs.python.org/file35457/python_3.5.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue21640> _______________________________________

3 3

[issue21533] built-in types dict docs - construct dict from iterable, not iterator
by Wolfgang Maier June 3, 2014

June 3, 2014

New submission from Wolfgang Maier: The docs for Python3.4 havethis to say about the arguments to the dict constructor: class dict(**kwarg) class dict(mapping, **kwarg) class dict(iterable, **kwarg) Return a new dictionary initialized from an optional positional argument and a possibly empty set of keyword arguments. If no positional argument is given, an empty dictionary is created. If a positional argument is given and it is a mapping object, a dictionary is created with the same … [View More]

5 5