Added information about the interaction of opening a file in append mode

freddrake · freddrake · commit 19ae78302e9e · 2001-01-04T05:16:39.000Z
and seek() in the description of seek(). This closes SF bug #126850.
diff --git a/Doc/lib/libstdtypes.tex b/Doc/lib/libstdtypes.tex
@@ -1079,7 +1079,12 @@ \subsubsection{File Objects\obindex{file}
   The \var{whence} argument is optional and defaults to \code{0}
   (absolute file positioning); other values are \code{1} (seek
   relative to the current position) and \code{2} (seek relative to the
-  file's end).  There is no return value.
+  file's end).  There is no return value.  Note that if the file is
+  opened for appending (mode \code{'a'} or \code{'a+'}), any
+  \method{seek()} operations will be undone at the next write.  If the
+  file is only opened for writing in append mode (mode \code{'a'}),
+  this method is essentially a no-op, but it remains useful for files
+  opened in append mode with reading enabled (mode \code{'a+'}).
 \end{methoddesc}
 
 \begin{methoddesc}[file]{tell}{}
