diff options
author | Fred Drake <fdrake@acm.org> | 2001-10-20 04:24:09 (GMT) |
---|---|---|
committer | Fred Drake <fdrake@acm.org> | 2001-10-20 04:24:09 (GMT) |
commit | 0aa811c527372fbee0e20192bba3cf343a744e08 (patch) | |
tree | ab0d86073c96b664d6b9d87ea84cdb8cdb263755 /Doc/lib/libstdtypes.tex | |
parent | 64a5aaf05ca20bdbd72c30fa0cfdda2ae9a347d9 (diff) | |
download | cpython-0aa811c527372fbee0e20192bba3cf343a744e08.zip cpython-0aa811c527372fbee0e20192bba3cf343a744e08.tar.gz cpython-0aa811c527372fbee0e20192bba3cf343a744e08.tar.bz2 |
Use the \note and \warning macros where appropriate.
Diffstat (limited to 'Doc/lib/libstdtypes.tex')
-rw-r--r-- | Doc/lib/libstdtypes.tex | 18 |
1 files changed, 9 insertions, 9 deletions
diff --git a/Doc/lib/libstdtypes.tex b/Doc/lib/libstdtypes.tex index b06cd5e..ef1cf8c 100644 --- a/Doc/lib/libstdtypes.tex +++ b/Doc/lib/libstdtypes.tex @@ -1215,8 +1215,8 @@ Files have the following methods: \begin{methoddesc}[file]{isatty}{} Return true if the file is connected to a tty(-like) device, else - false. \strong{Note:} If a file-like object is not associated - with a real file, this method should \emph{not} be implemented. + false. \note{If a file-like object is not associated + with a real file, this method should \emph{not} be implemented.} \end{methoddesc} \begin{methoddesc}[file]{fileno}{} @@ -1227,9 +1227,9 @@ Files have the following methods: operating system. This can be useful for other, lower level interfaces that use file descriptors, such as the \refmodule{fcntl}\refbimodindex{fcntl} module or - \function{os.read()} and friends. \strong{Note:} File-like objects + \function{os.read()} and friends. \note{File-like objects which do not have a real file descriptor should \emph{not} provide - this method! + this method!} \end{methoddesc} \begin{methoddesc}[file]{read}{\optional{size}} @@ -1258,9 +1258,9 @@ Files have the following methods: non-negative, it is a maximum byte count (including the trailing newline) and an incomplete line may be returned. An empty string is returned when \EOF{} is hit - immediately. Note: Unlike \code{stdio}'s \cfunction{fgets()}, the + immediately. \note{Unlike \code{stdio}'s \cfunction{fgets()}, the returned string contains null characters (\code{'\e 0'}) if they - occurred in the input. + occurred in the input.} \end{methoddesc} \begin{methoddesc}[file]{readlines}{\optional{sizehint}} @@ -1307,7 +1307,7 @@ Files have the following methods: \end{methoddesc} \begin{methoddesc}[file]{write}{str} - Write a string to the file. There is no return value. Note: Due to + Write a string to the file. There is no return value. Due to buffering, the string may not actually show up in the file until the \method{flush()} or \method{close()} method is called. \end{methoddesc} @@ -1359,9 +1359,9 @@ 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. -\strong{Note:} This attribute is not used to control the +\note{This attribute is not used to control the \keyword{print} statement, but to allow the implementation of -\keyword{print} to keep track of its internal state. +\keyword{print} to keep track of its internal state.} \end{memberdesc} |