Documented optional bufsize argument to open() and the fact that mode
is now also optional
diff --git a/Doc/libfuncs.tex b/Doc/libfuncs.tex
index ab4b03c..2c30c14 100644
--- a/Doc/libfuncs.tex
+++ b/Doc/libfuncs.tex
@@ -206,10 +206,9 @@
expression.
\end{funcdesc}
-\begin{funcdesc}{open}{filename\, mode}
- % XXXJH xrefs here to Built-in types?
+\begin{funcdesc}{open}{filename\, mode\, bufsize}
Return a new file object (described earlier under Built-in Types).
- The string arguments are the same as for \code{stdio}'s
+ The first two arguments are the same as for \code{stdio}'s
\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
@@ -219,6 +218,18 @@
between binary and text files, \code{'b'} appended to the mode opens
the file in binary mode. If the file cannot be opened, \code{IOError}
is raised.
+If \var{mode} is omitted, it defaults to \code{'r'}.
+The optional \var{bufsize} argument specifies the file's desired
+buffer size: 0 means unbuffered, 1 means line buffered, any other
+positive value means use a buffer of (approximately) that size. A
+negative \var{bufsize} means to use the system default, which is
+usually line buffered for for tty devices and fully buffered for other
+files.%
+\footnote{Specifying a buffer size currently has no effect on systems
+that don't have \code{setvbuf()}. The interface to specify the buffer
+size is not done using a method that calls \code{setvbuf()}, because
+that may dump core when called after any I/O has been performed, and
+there's no reliable way to determine whether this is the case.}
\end{funcdesc}
\begin{funcdesc}{ord}{c}