diff options
author | Fred Drake <fdrake@acm.org> | 2001-12-05 05:46:25 (GMT) |
---|---|---|
committer | Fred Drake <fdrake@acm.org> | 2001-12-05 05:46:25 (GMT) |
commit | c2f496a138a4838375b449e238d963615d546de6 (patch) | |
tree | 863a965a07e9dd6afca31d42e486f032463a5df9 /Doc/ref/ref6.tex | |
parent | 39368c1053ebf0acb6b76f4d34f225fcaf856daf (diff) | |
download | cpython-c2f496a138a4838375b449e238d963615d546de6.zip cpython-c2f496a138a4838375b449e238d963615d546de6.tar.gz cpython-c2f496a138a4838375b449e238d963615d546de6.tar.bz2 |
Add a note to the description of the interaction between the softspace
attribute of file objects, the print statement, and other file operations.
This closes SF bug #484857.
Fix minor markup nits.
Diffstat (limited to 'Doc/ref/ref6.tex')
-rw-r--r-- | Doc/ref/ref6.tex | 21 |
1 files changed, 12 insertions, 9 deletions
diff --git a/Doc/ref/ref6.tex b/Doc/ref/ref6.tex index bb0f920..8691cdf 100644 --- a/Doc/ref/ref6.tex +++ b/Doc/ref/ref6.tex @@ -45,9 +45,9 @@ single expression). In interactive mode, if the value is not \code{None}, it is converted to a string using the built-in \function{repr()}\bifuncindex{repr} function and the resulting string is written to standard output (see -section \ref{print}) on a line by itself. (Expression statements -yielding None are not written, so that procedure calls do not cause -any output.) +section~\ref{print}) on a line by itself. (Expression statements +yielding \code{None} are not written, so that procedure calls do not +cause any output.) \ttindex{None} \indexii{string}{conversion} \index{output} @@ -119,7 +119,7 @@ objects: | \token{slicing}} \end{productionlist} -(See section \ref{primaries} for the syntax definitions for the last +(See section~\ref{primaries} for the syntax definitions for the last three symbols.) An assignment statement evaluates the expression list (remember that @@ -134,7 +134,7 @@ reference, subscription or slicing), the mutable object must ultimately perform the assignment and decide about its validity, and may raise an exception if the assignment is unacceptable. The rules observed by various types and the exceptions raised are given with the -definition of the object types (see section \ref{types}). +definition of the object types (see section~\ref{types}). \index{target} \indexii{target}{list} @@ -285,7 +285,7 @@ operation and an assignment statement: | \token{slicing}} \end{productionlist} -(See section \ref{primaries} for the syntax definitions for the last +(See section~\ref{primaries} for the syntax definitions for the last three symbols.) An augmented assignment evaluates the target (which, unlike normal @@ -304,7 +304,7 @@ modified instead. With the exception of assigning to tuples and multiple targets in a single statement, the assignment done by augmented assignment statements is handled the same way as normal assignments. Similarly, with the exception of the -possible \emph{in-place} behaviour, the binary operation performed by +possible \emph{in-place} behavior, the binary operation performed by augmented assignment is the same as the normal binary operations. @@ -379,7 +379,10 @@ to standard output, (2) when the last character written to standard output is \character{\e n}, or (3) when the last write operation on standard output was not a \keyword{print} statement. (In some cases it may be functional to write an empty string to standard output for -this reason.) +this reason.) \note{Objects which act like file objects but which are +not the built-in file objects often do not properly emulate this +aspect of the file object's behavior, so it is best not to rely on +this.} \index{output} \indexii{writing}{values} @@ -470,7 +473,7 @@ determined in the previous step, with the instance as its parameter. If a third object is present, and it is not \code{None}, it should be -a traceback object (see section \ref{traceback}), and it is +a traceback object (see section~\ref{traceback}), and it is substituted instead of the current location as the place where the exception occurred. This is useful to re-raise an exception transparently in an except clause. |