summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorFred Drake <fdrake@acm.org>2000-09-09 03:30:34 (GMT)
committerFred Drake <fdrake@acm.org>2000-09-09 03:30:34 (GMT)
commit66571cc20c44cf0c4a9ebc4edae8ec4c6c1606f5 (patch)
tree4bb00ca7535a0a758cda1c63f310b9c07a8899a2
parent7acb21866c3d84908cd6d95dbbf9563bb5479a0e (diff)
downloadcpython-66571cc20c44cf0c4a9ebc4edae8ec4c6c1606f5.zip
cpython-66571cc20c44cf0c4a9ebc4edae8ec4c6c1606f5.tar.gz
cpython-66571cc20c44cf0c4a9ebc4edae8ec4c6c1606f5.tar.bz2
Improve a couple of references to the language reference, making them
hyperlinks to relevant sections. Clarify the conditions under which the "softspace" attribute of file-like objects can "just work" (with relation to overriding of attribute access in user-defined classes).
-rw-r--r--Doc/lib/libstdtypes.tex16
1 files changed, 9 insertions, 7 deletions
diff --git a/Doc/lib/libstdtypes.tex b/Doc/lib/libstdtypes.tex
index d2224a1..d36cdb0 100644
--- a/Doc/lib/libstdtypes.tex
+++ b/Doc/lib/libstdtypes.tex
@@ -40,7 +40,8 @@ The following values are considered false:
\item instances of user-defined classes, if the class defines a
\method{__nonzero__()} or \method{__len__()} method, when that
method returns zero.\footnote{Additional information on these
-special methods may be found in the \emph{Python Reference Manual}.}
+special methods may be found in the \citetitle[../ref/ref.html]{Python
+Reference Manual}.}
\end{itemize}
@@ -142,9 +143,9 @@ consistently.
Instances of a class normally compare as non-equal unless the class
\withsubitem{(instance method)}{\ttindex{__cmp__()}}
-defines the \method{__cmp__()} method. Refer to the \emph{Python
-Reference Manual} for information on the use of this method to effect
-object comparisons.
+defines the \method{__cmp__()} method. Refer to the
+\citetitle[../ref/customization.html]{Python Reference Manual} for
+information on the use of this method to effect object comparisons.
\strong{Implementation note:} Objects of different types except
numbers are ordered by their type names; objects of the same types
@@ -1105,9 +1106,10 @@ Boolean that indicates whether a space character needs to be printed
before another value when using the \keyword{print} statement.
Classes that are trying to simulate a file object should also have a
writable \member{softspace} attribute, which should be initialized to
-zero. This will be automatic for classes implemented in Python; types
-implemented in C will have to provide a writable \member{softspace}
-attribute.
+zero. This will be automatic for most classes implemented in Python
+(care may be needed for objects that override attribute access); types
+implemented in C will have to provide a writable
+\member{softspace} attribute.
\end{memberdesc}
\subsubsection{Internal Objects \label{typesinternal}}