This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author corydodt
Recipients
Date 2006-01-02.00:43:30
SpamBayes Score
Marked as misclassified
Message-id
In-reply-to
Content
Logged In: YES 
user_id=889183

Tim - at a minimum this should be documented; even if it's
just a link to the ANSI C documentation.  Python is not ANSI
C, we shouldn't expect the Python user to seek out ANSI C 
documentation.  Want me to open a separate doc bug?  The
current doc only says this (about the file builtin):
"""
Modes 'r+', 'w+' and 'a+' open the file for updating (note
that 'w+' truncates the file). Append 'b' to the mode to
open the file in binary mode, on systems that differentiate
between binary and text files (else it is ignored). If the
file cannot be opened, IOError is raised.
"""

Either here, or perhaps in section 2.3.9, a clear
description should be given of how to properly operate a +
mode file.  Failing that, a pointer to ANSI C documentation
so the user can read about it on its own (and so the user
knows that this behavior conforms to the underlying platform
API in every ugly detail).

I'm also dubious that this exposed memory is innocuous, but
I'll defer to your expertise on that one.
History
Date User Action Args
2007-08-23 14:37:03adminlinkissue1394612 messages
2007-08-23 14:37:03admincreate