Kaydet (Commit) 9aa8543c authored tarafından Fred Drake's avatar Fred Drake

open() description: Made it more clear that 'b' should always be

	added to the mode value for binary files to improve
	portability.

Fixed latex2html weirdness with a couple of footnotes.
üst ae142300
...@@ -434,18 +434,23 @@ one argument, return the smallest of the arguments. ...@@ -434,18 +434,23 @@ one argument, return the smallest of the arguments.
ignored). If the file cannot be opened, \exception{IOError} is ignored). If the file cannot be opened, \exception{IOError} is
raised. raised.
If \var{mode} is omitted, it defaults to \code{'r'}. If \var{mode} is omitted, it defaults to \code{'r'}. When opening a
The optional \var{bufsize} argument specifies the file's desired binary file, you should append \code{'b'} to the \var{mode} value
buffer size: 0 means unbuffered, 1 means line buffered, any other for improved portability. (It's useful even on systems which don't
positive value means use a buffer of (approximately) that size. A treat binary and text files differently, where it serves as
negative \var{bufsize} means to use the system default, which is documentation.) The optional \var{bufsize} argument specifies the
usually line buffered for for tty devices and fully buffered for other file's desired buffer size: 0 means unbuffered, 1 means line
files. If omitted, the system default is used.% buffered, any other positive value means use a buffer of
\footnote{Specifying a buffer size currently has no effect on systems (approximately) that size. A negative \var{bufsize} means to use
that don't have \cfunction{setvbuf()}. The interface to specify the buffer the system default, which is usually line buffered for for tty
size is not done using a method that calls \cfunction{setvbuf()}, because devices and fully buffered for other files. If omitted, the system
that may dump core when called after any I/O has been performed, and default is used.\footnote{
there's no reliable way to determine whether this is the case.} Specifying a buffer size currently has no effect on systems that
don't have \cfunction{setvbuf()}. The interface to specify the
buffer size is not done using a method that calls
\cfunction{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} \end{funcdesc}
\begin{funcdesc}{ord}{c} \begin{funcdesc}{ord}{c}
...@@ -649,10 +654,10 @@ local symbol table. With a module, class or class instance object as ...@@ -649,10 +654,10 @@ local symbol table. With a module, class or class instance object as
argument (or anything else that has a \member{__dict__} attribute), argument (or anything else that has a \member{__dict__} attribute),
returns a dictionary corresponding to the object's symbol table. returns a dictionary corresponding to the object's symbol table.
The returned dictionary should not be modified: the effects on the The returned dictionary should not be modified: the effects on the
corresponding symbol table are undefined.% corresponding symbol table are undefined.\footnote{
\footnote{In the current implementation, local variable bindings In the current implementation, local variable bindings cannot
cannot normally be affected this way, but variables retrieved from normally be affected this way, but variables retrieved from
other scopes (e.g. modules) can be. This may change.} other scopes (e.g. modules) can be. This may change.}
\end{funcdesc} \end{funcdesc}
\begin{funcdesc}{xrange}{\optional{start,} stop\optional{, step}} \begin{funcdesc}{xrange}{\optional{start,} stop\optional{, step}}
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment