summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGuido van Rossum <guido@python.org>1996-05-02 15:16:59 (GMT)
committerGuido van Rossum <guido@python.org>1996-05-02 15:16:59 (GMT)
commit59b328e11ea53cc24146a1649c3727dfe24aa88b (patch)
treeed283278692b0ec3a7e3bfb81bf7ea7819ab8072
parente71c5a758523b688bbf0975e641a9df8e3fe377a (diff)
downloadcpython-59b328e11ea53cc24146a1649c3727dfe24aa88b.zip
cpython-59b328e11ea53cc24146a1649c3727dfe24aa88b.tar.gz
cpython-59b328e11ea53cc24146a1649c3727dfe24aa88b.tar.bz2
Added warning about behavior of open mode 'a' (or 'a+').
-rw-r--r--Doc/lib/libfuncs.tex5
-rw-r--r--Doc/libfuncs.tex5
2 files changed, 8 insertions, 2 deletions
diff --git a/Doc/lib/libfuncs.tex b/Doc/lib/libfuncs.tex
index 34d2928..088f969 100644
--- a/Doc/lib/libfuncs.tex
+++ b/Doc/lib/libfuncs.tex
@@ -265,7 +265,10 @@ any kind of sequence; the result is always a list.
\code{fopen()}: \var{filename} is the file name to be opened,
\var{mode} indicates how the file is to be opened: \code{'r'} for
reading, \code{'w'} for writing (truncating an existing file), and
- \code{'a'} opens it for appending. Modes \code{'r+'}, \code{'w+'} and
+ \code{'a'} opens it for appending (which on {\em some} {\UNIX}
+ systems means that {\em all} writes append to the end of the file,
+ regardless of the current seek position).
+ Modes \code{'r+'}, \code{'w+'} and
\code{'a+'} open the file for updating, provided the underlying
\code{stdio} library understands this. On systems that differentiate
between binary and text files, \code{'b'} appended to the mode opens
diff --git a/Doc/libfuncs.tex b/Doc/libfuncs.tex
index 34d2928..088f969 100644
--- a/Doc/libfuncs.tex
+++ b/Doc/libfuncs.tex
@@ -265,7 +265,10 @@ any kind of sequence; the result is always a list.
\code{fopen()}: \var{filename} is the file name to be opened,
\var{mode} indicates how the file is to be opened: \code{'r'} for
reading, \code{'w'} for writing (truncating an existing file), and
- \code{'a'} opens it for appending. Modes \code{'r+'}, \code{'w+'} and
+ \code{'a'} opens it for appending (which on {\em some} {\UNIX}
+ systems means that {\em all} writes append to the end of the file,
+ regardless of the current seek position).
+ Modes \code{'r+'}, \code{'w+'} and
\code{'a+'} open the file for updating, provided the underlying
\code{stdio} library understands this. On systems that differentiate
between binary and text files, \code{'b'} appended to the mode opens