Mailman 3 December 2010 - docs

[issue10748] zipfile does not write empty ZIP structure if close() called after __init__() as doc suggests
by Ian Stevens Dec. 21, 2010

Dec. 21, 2010

New submission from Ian Stevens <iancstevens(a)gmail.com>: The zipfile documentation (http://docs.python.org/library/zipfile.html) states: "If the file is created with mode 'a' or 'w' and then close()d without adding any files to the archive, the appropriate ZIP structures for an empty archive will be written to the file." This is not the case, eg.:: >>> from StringIO import StringIO >>> import zipfile >>> s = StringIO() >>> z = zipfile.ZipFile(s, 'w') >>> z.close() >>> s.len 0 The code for zipfile (http://svn.python.org/projects/python/trunk/Lib/zipfile.py) does not support the documentation either. The ending records are written only if ZipFile._didModify is True, and that attribute is only set to True if writestr() or write() are called. Either the code should be fixed to support writing the ending records on an empty zip, or the documentation should be changed to reflect the existing behaviour. Test case (for Lib/test/test_zipfile):: def test_close_empty_zip_creates_valid_zip(self): # Test that close() called on a ZipFile without write creates a valid ZIP. zf = zipfile.ZipFile(TESTFN, "w") zf.close() chk = zipfile.is_zipfile(TESTFN) self.assertTrue(chk) ---------- assignee: docs@python components: Documentation, Library (Lib) messages: 124433 nosy: Ian.Stevens, docs@python priority: normal severity: normal status: open title: zipfile does not write empty ZIP structure if close() called after __init__() as doc suggests type: behavior versions: Python 2.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10748> _______________________________________

2 3

Missing action='help' documentation for the argparse module.
by Jurko Gospodnetić Dec. 21, 2010

Dec. 21, 2010

Hi. In Python 3.2 beta1 & Python 2.7 documentation for the 'argparse' module the special value 'help' is not listed for the ArgumentParser.add_argument() function's 'action' parameter. It causes the argument it is specified for to trigger displaying the argument parser's help message and also prevents the parser from complaining about any missing or extra command-line parameters. Without using this action value it is possible to print out the help message programmatically using ArgumentParser.print_help() but there is no way to cause the argument parser to not complaing about missing or extra command-line parameters. Best regards, Jurko Gospodnetić

1 0

[issue8145] Documentation about sqlite3 isolation_level
by Éric Araujo Dec. 20, 2010

Dec. 20, 2010

Changes by Éric Araujo <merwok(a)netwok.org>: Removed file: http://bugs.python.org/file17940/unnamed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8145> _______________________________________

1 0

[issue10728] argparse.ArgumentParser.print_help uses sys.stdout
by Éric Araujo Dec. 20, 2010

Dec. 20, 2010

Éric Araujo <merwok(a)netwok.org> added the comment: Alright, I didn’t know you were doing mass merges. I personally prefer to leave reports open until backported, now I’ll know your habits. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10728> _______________________________________

1 0

[issue10728] argparse.ArgumentParser.print_help uses sys.stdout
by R. David Murray Dec. 19, 2010

Dec. 19, 2010

R. David Murray <rdmurray(a)bitdance.com> added the comment: Like Georg, I'll get to that when I do a mass backport of all my doc fixes. My apologies for missing the beta2 deadline on doing that, but there aren't many of them. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10728> _______________________________________

1 0

[issue10728] argparse.ArgumentParser.print_help uses sys.stdout
by Éric Araujo Dec. 19, 2010

Dec. 19, 2010

Éric Araujo <merwok(a)netwok.org> added the comment: This apparently lacks a 2.7 backport. ---------- nosy: +eric.araujo _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10728> _______________________________________

1 0

[issue10622] WebKit browsers show superfluous scrollbars in html docs
by Davide Rizzo Dec. 18, 2010

Dec. 18, 2010

New submission from Davide Rizzo <sorcio(a)gmail.com>: Some WebKit browsers show a superflous scrollbar on the right side of the <pre> boxes in the Sphinx generated html docs. For example: http://666kb.com/i/boxys2zktxky17vsh.png taken on Chrome 7 on Windows. I believe that the cause of the behaviour is a bug in the WebKit engine. If that's the case, adding "overflow-y: hidden" to the <pre> css style would fix the issue. "overflow-y" is not standard css, but it is understood by the affected browsers, looks ok on other modern browsers and is just ignored on older releases. The provided patch has been tested on all major Windows browsers. ---------- assignee: docs@python components: Documentation files: webkit.patch keywords: patch messages: 123338 nosy: davide.rizzo, docs@python priority: normal severity: normal status: open title: WebKit browsers show superfluous scrollbars in html docs type: behavior versions: Python 2.7, Python 3.1, Python 3.2 Added file: http://bugs.python.org/file19936/webkit.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10622> _______________________________________

3 2

[issue10723] Undocumented built-in exceptions
by flashk Dec. 18, 2010

Dec. 18, 2010

New submission from flashk <flashk(a)gmail.com>: The "Built-in Exceptions" page of the Python 2.7 documentation is missing descriptions for BufferError, IndentationError, and TabError. I've gone ahead and added a brief description of each error to the page. ---------- assignee: docs@python components: Documentation files: exceptions.rst messages: 124165 nosy: docs@python, flashk priority: normal severity: normal status: open title: Undocumented built-in exceptions versions: Python 2.7 Added file: http://bugs.python.org/file20084/exceptions.rst _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10723> _______________________________________

4 6

[issue10728] argparse.ArgumentParser.print_help uses sys.stdout
by R. David Murray Dec. 18, 2010

Dec. 18, 2010

R. David Murray <rdmurray(a)bitdance.com> added the comment: Fixed in r87372. ---------- resolution: -> fixed stage: needs patch -> committed/rejected status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10728> _______________________________________

1 0

[issue10728] argparse.ArgumentParser.print_help uses sys.stdout
by Steven Bethard Dec. 18, 2010

Dec. 18, 2010

Steven Bethard <steven.bethard(a)gmail.com> added the comment: Yep, this is a documentation bug. Help is definitely intended to print to stdout. ---------- versions: -Python 3.1 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10728> _______________________________________

1 0