summaryrefslogtreecommitdiffstats
path: root/Doc/ref/ref6.tex
diff options
context:
space:
mode:
authorFred Drake <fdrake@acm.org>2001-12-05 05:46:25 (GMT)
committerFred Drake <fdrake@acm.org>2001-12-05 05:46:25 (GMT)
commitc2f496a138a4838375b449e238d963615d546de6 (patch)
tree863a965a07e9dd6afca31d42e486f032463a5df9 /Doc/ref/ref6.tex
parent39368c1053ebf0acb6b76f4d34f225fcaf856daf (diff)
downloadcpython-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.tex21
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.