Staging
v0.8.1
https://github.com/python/cpython
Revision 956597f4ef4ef4c65b0a5a7e488757d865832a0e authored by Andrew M. Kuchling on 29 July 2006, 18:14:07 UTC, committed by Andrew M. Kuchling on 29 July 2006, 18:14:07 UTC
We want to encourage users to write open() when opening a file, but
open() was described with a single paragraph and
'file' had lots of explanation of the mode and bufsize arguments.

I've shrunk the description of 'file' to cross-reference to the 'File
objects' section, and to open() for an explanation of the arguments.

open() now has all the paragraphs about the mode string.  The bufsize
argument was moved up so that it isn't buried at the end; now there's
1 paragraph on mode, 1 on bufsize, and then 3 more on mode.  Various
other edits and rearrangements were made in the process.

It's probably best to read the final text and not to try to make sense
of the diffs.
1 parent fbdeaad
History
Tip revision: 956597f4ef4ef4c65b0a5a7e488757d865832a0e authored by Andrew M. Kuchling on 29 July 2006, 18:14:07 UTC
Reorganize the docs for 'file' and 'open()' after some discussion with Fred.
Tip revision: 956597f
File Mode Size
bsddb
compiler
ctypes
curses
distutils
email
encodings
hotshot
idlelib
lib-tk
logging
msilib
plat-aix3
plat-aix4
plat-atheos
plat-beos5
plat-darwin
plat-freebsd2
plat-freebsd3
plat-freebsd4
plat-freebsd5
plat-freebsd6
plat-freebsd7
plat-generic
plat-irix5
plat-irix6
plat-linux2
plat-mac
plat-netbsd1
plat-next3
plat-os2emx
plat-riscos
plat-sunos5
plat-unixware7
site-packages
sqlite3
test
wsgiref
xml
BaseHTTPServer.py -rw-r--r-- 20.8 KB
Bastion.py -rw-r--r-- 5.5 KB
CGIHTTPServer.py -rw-r--r-- 11.6 KB
ConfigParser.py -rw-r--r-- 22.6 KB
Cookie.py -rw-r--r-- 24.6 KB
DocXMLRPCServer.py -rw-r--r-- 10.9 KB
HTMLParser.py -rw-r--r-- 12.4 KB
MimeWriter.py -rw-r--r-- 6.2 KB
Queue.py -rw-r--r-- 7.6 KB
SimpleHTTPServer.py -rw-r--r-- 6.7 KB
SimpleXMLRPCServer.py -rw-r--r-- 20.4 KB
SocketServer.py -rw-r--r-- 18.1 KB
StringIO.py -rw-r--r-- 10.3 KB
UserDict.py -rw-r--r-- 5.6 KB
UserList.py -rw-r--r-- 3.5 KB
UserString.py -rwxr-xr-x 8.0 KB
_LWPCookieJar.py -rw-r--r-- 6.4 KB
_MozillaCookieJar.py -rw-r--r-- 5.7 KB
__future__.py -rw-r--r-- 3.8 KB
__phello__.foo.py -rw-r--r-- 64 bytes
_strptime.py -rw-r--r-- 19.2 KB
_threading_local.py -rw-r--r-- 6.8 KB
aifc.py -rw-r--r-- 32.6 KB
anydbm.py -rw-r--r-- 2.6 KB
asynchat.py -rw-r--r-- 10.5 KB
asyncore.py -rw-r--r-- 16.4 KB
atexit.py -rw-r--r-- 1.6 KB
audiodev.py -rw-r--r-- 7.3 KB
base64.py -rwxr-xr-x 11.0 KB
bdb.py -rw-r--r-- 19.7 KB
binhex.py -rw-r--r-- 14.7 KB
bisect.py -rw-r--r-- 2.3 KB
cProfile.py -rwxr-xr-x 6.1 KB
calendar.py -rw-r--r-- 22.4 KB
cgi.py -rwxr-xr-x 33.7 KB
cgitb.py -rw-r--r-- 11.8 KB
chunk.py -rw-r--r-- 5.2 KB
cmd.py -rw-r--r-- 14.6 KB
code.py -rw-r--r-- 9.7 KB
codecs.py -rw-r--r-- 31.9 KB
codeop.py -rw-r--r-- 5.9 KB
colorsys.py -rw-r--r-- 3.4 KB
commands.py -rw-r--r-- 2.2 KB
compileall.py -rw-r--r-- 5.2 KB
contextlib.py -rw-r--r-- 4.0 KB
cookielib.py -rw-r--r-- 62.7 KB
copy.py -rw-r--r-- 10.7 KB
copy_reg.py -rw-r--r-- 6.6 KB
csv.py -rw-r--r-- 14.8 KB
dbhash.py -rw-r--r-- 404 bytes
decimal.py -rw-r--r-- 103.6 KB
difflib.py -rw-r--r-- 78.9 KB
dircache.py -rw-r--r-- 1006 bytes
dis.py -rw-r--r-- 6.3 KB
doctest.py -rw-r--r-- 96.0 KB
dumbdbm.py -rw-r--r-- 8.2 KB
dummy_thread.py -rw-r--r-- 4.5 KB
dummy_threading.py -rw-r--r-- 2.8 KB
filecmp.py -rw-r--r-- 9.2 KB
fileinput.py -rw-r--r-- 13.8 KB
fnmatch.py -rw-r--r-- 2.9 KB
formatter.py -rw-r--r-- 14.6 KB
fpformat.py -rw-r--r-- 4.5 KB
ftplib.py -rw-r--r-- 26.3 KB
functools.py -rw-r--r-- 2.1 KB
getopt.py -rw-r--r-- 7.1 KB
getpass.py -rw-r--r-- 3.3 KB
gettext.py -rw-r--r-- 19.4 KB
glob.py -rw-r--r-- 2.0 KB
gopherlib.py -rw-r--r-- 5.6 KB
gzip.py -rw-r--r-- 16.1 KB
hashlib.py -rw-r--r-- 3.5 KB
heapq.py -rw-r--r-- 14.0 KB
hmac.py -rw-r--r-- 3.5 KB
htmlentitydefs.py -rw-r--r-- 17.6 KB
htmllib.py -rw-r--r-- 12.4 KB
httplib.py -rw-r--r-- 46.0 KB
ihooks.py -rw-r--r-- 16.9 KB
imaplib.py -rw-r--r-- 45.5 KB
imghdr.py -rw-r--r-- 3.5 KB
imputil.py -rw-r--r-- 25.1 KB
inspect.py -rw-r--r-- 33.5 KB
keyword.py -rwxr-xr-x 2.0 KB
linecache.py -rw-r--r-- 4.0 KB
locale.py -rw-r--r-- 71.3 KB
macpath.py -rw-r--r-- 7.4 KB
macurl2path.py -rw-r--r-- 3.2 KB
mailbox.py -rwxr-xr-x 71.8 KB
mailcap.py -rw-r--r-- 7.3 KB
markupbase.py -rw-r--r-- 14.0 KB
md5.py -rw-r--r-- 241 bytes
mhlib.py -rw-r--r-- 32.5 KB
mimetools.py -rw-r--r-- 6.7 KB
mimetypes.py -rw-r--r-- 18.3 KB
mimify.py -rwxr-xr-x 14.5 KB
modulefinder.py -rw-r--r-- 20.7 KB
multifile.py -rw-r--r-- 4.6 KB
mutex.py -rw-r--r-- 1.7 KB
netrc.py -rw-r--r-- 4.0 KB
new.py -rw-r--r-- 541 bytes
nntplib.py -rw-r--r-- 20.7 KB
ntpath.py -rw-r--r-- 16.2 KB
nturl2path.py -rw-r--r-- 2.2 KB
opcode.py -rw-r--r-- 5.1 KB
optparse.py -rw-r--r-- 58.8 KB
os.py -rw-r--r-- 23.9 KB
os2emxpath.py -rw-r--r-- 12.4 KB
pdb.doc -rw-r--r-- 7.3 KB
pdb.py -rwxr-xr-x 40.6 KB
pickle.py -rw-r--r-- 43.7 KB
pickletools.py -rw-r--r-- 71.7 KB
pipes.py -rw-r--r-- 9.8 KB
pkgutil.py -rw-r--r-- 18.1 KB
platform.py -rwxr-xr-x 39.4 KB
popen2.py -rw-r--r-- 9.4 KB
poplib.py -rw-r--r-- 12.2 KB
posixfile.py -rw-r--r-- 7.7 KB
posixpath.py -rw-r--r-- 13.5 KB
pprint.py -rw-r--r-- 10.6 KB
profile.py -rwxr-xr-x 23.0 KB
pstats.py -rw-r--r-- 25.3 KB
pty.py -rw-r--r-- 4.6 KB
py_compile.py -rw-r--r-- 5.4 KB
pyclbr.py -rw-r--r-- 13.0 KB
pydoc.py -rwxr-xr-x 87.6 KB
quopri.py -rwxr-xr-x 6.8 KB
random.py -rw-r--r-- 29.8 KB
re.py -rw-r--r-- 11.9 KB
repr.py -rw-r--r-- 3.9 KB
rexec.py -rw-r--r-- 19.6 KB
rfc822.py -rw-r--r-- 32.3 KB
rlcompleter.py -rw-r--r-- 5.2 KB
robotparser.py -rw-r--r-- 9.7 KB
runpy.py -rwxr-xr-x 3.5 KB
sched.py -rw-r--r-- 4.4 KB
sets.py -rw-r--r-- 19.2 KB
sgmllib.py -rw-r--r-- 17.4 KB
sha.py -rw-r--r-- 265 bytes
shelve.py -rw-r--r-- 7.4 KB
shlex.py -rw-r--r-- 10.9 KB
shutil.py -rw-r--r-- 5.7 KB
site.py -rw-r--r-- 13.9 KB
smtpd.py -rwxr-xr-x 17.6 KB
smtplib.py -rwxr-xr-x 26.1 KB
sndhdr.py -rw-r--r-- 5.8 KB
socket.py -rw-r--r-- 12.9 KB
sre.py -rw-r--r-- 294 bytes
sre_compile.py -rw-r--r-- 16.1 KB
sre_constants.py -rw-r--r-- 7.0 KB
sre_parse.py -rw-r--r-- 26.3 KB
stat.py -rw-r--r-- 1.6 KB
statvfs.py -rw-r--r-- 779 bytes
string.py -rw-r--r-- 16.3 KB
stringold.py -rw-r--r-- 12.0 KB
stringprep.py -rw-r--r-- 13.2 KB
struct.py -rw-r--r-- 2.9 KB
subprocess.py -rw-r--r-- 41.5 KB
sunau.py -rw-r--r-- 16.1 KB
sunaudio.py -rw-r--r-- 1.2 KB
symbol.py -rwxr-xr-x 2.0 KB
symtable.py -rw-r--r-- 7.5 KB
tabnanny.py -rwxr-xr-x 11.0 KB
tarfile.py -rw-r--r-- 71.5 KB
telnetlib.py -rw-r--r-- 21.6 KB
tempfile.py -rw-r--r-- 14.0 KB
textwrap.py -rw-r--r-- 14.5 KB
this.py -rw-r--r-- 1002 bytes
threading.py -rw-r--r-- 25.5 KB
timeit.py -rw-r--r-- 10.0 KB
toaiff.py -rw-r--r-- 3.0 KB
token.py -rwxr-xr-x 2.9 KB
tokenize.py -rw-r--r-- 13.2 KB
trace.py -rw-r--r-- 28.3 KB
traceback.py -rw-r--r-- 10.7 KB
tty.py -rw-r--r-- 879 bytes
types.py -rw-r--r-- 2.5 KB
unittest.py -rw-r--r-- 28.2 KB
urllib.py -rw-r--r-- 53.2 KB
urllib2.py -rw-r--r-- 46.1 KB
urlparse.py -rw-r--r-- 11.5 KB
user.py -rw-r--r-- 1.5 KB
uu.py -rwxr-xr-x 5.7 KB
uuid.py -rw-r--r-- 18.4 KB
warnings.py -rw-r--r-- 8.9 KB
wave.py -rw-r--r-- 17.3 KB
weakref.py -rw-r--r-- 9.8 KB
webbrowser.py -rw-r--r-- 19.7 KB
whichdb.py -rw-r--r-- 3.3 KB
wsgiref.egg-info -rw-r--r-- 187 bytes
xdrlib.py -rw-r--r-- 7.2 KB
xmllib.py -rw-r--r-- 34.0 KB
xmlrpclib.py -rw-r--r-- 45.4 KB
zipfile.py -rw-r--r-- 34.7 KB

back to top