Removed some spurios biindex calls.
Added description of file.truncate().
Added warning to write() about buffering.
diff --git a/Doc/lib/libtypes.tex b/Doc/lib/libtypes.tex
index 5c6bce8..052bc9f 100644
--- a/Doc/lib/libtypes.tex
+++ b/Doc/lib/libtypes.tex
@@ -639,9 +639,6 @@
\code{posix.fdopen()} and the \code{makefile()} method of socket
objects.
\bifuncindex{open}
-\bifuncindex{popen}
-\bifuncindex{fdopen}
-\bifuncindex{makefile}
When a file operation fails for an I/O-related reason, the exception
\code{IOError} is raised. This includes situations where the
@@ -712,8 +709,18 @@
Return the file's current position, like \code{stdio}'s \code{ftell()}.
\end{funcdesc}
+\begin{funcdesc}{truncate}{\optional{size}}
+Truncate the file's size. If the optional size argument present, the
+file is truncated to (at most) that size. The size defaults to the
+current position. Availability of this function depends on the
+operating system version (e.g., not all {\UNIX} versions support this
+operation).
+\end{funcdesc}
+
\begin{funcdesc}{write}{str}
- Write a string to the file. There is no return value.
+Write a string to the file. There is no return value. Note: due to
+buffering, the string may not actually show up in the file until
+the \code{flush()} or \code{close()} method is called.
\end{funcdesc}
\begin{funcdesc}{writelines}{list}
diff --git a/Doc/libtypes.tex b/Doc/libtypes.tex
index 5c6bce8..052bc9f 100644
--- a/Doc/libtypes.tex
+++ b/Doc/libtypes.tex
@@ -639,9 +639,6 @@
\code{posix.fdopen()} and the \code{makefile()} method of socket
objects.
\bifuncindex{open}
-\bifuncindex{popen}
-\bifuncindex{fdopen}
-\bifuncindex{makefile}
When a file operation fails for an I/O-related reason, the exception
\code{IOError} is raised. This includes situations where the
@@ -712,8 +709,18 @@
Return the file's current position, like \code{stdio}'s \code{ftell()}.
\end{funcdesc}
+\begin{funcdesc}{truncate}{\optional{size}}
+Truncate the file's size. If the optional size argument present, the
+file is truncated to (at most) that size. The size defaults to the
+current position. Availability of this function depends on the
+operating system version (e.g., not all {\UNIX} versions support this
+operation).
+\end{funcdesc}
+
\begin{funcdesc}{write}{str}
- Write a string to the file. There is no return value.
+Write a string to the file. There is no return value. Note: due to
+buffering, the string may not actually show up in the file until
+the \code{flush()} or \code{close()} method is called.
\end{funcdesc}
\begin{funcdesc}{writelines}{list}