[Python-checkins] CVS: python/dist/src/Doc/lib libasyncore.tex,1.11,1.12 libcfgparser.tex,1.21,1.22 libcode.tex,1.13,1.14 libfilecmp.tex,1.6,1.7 libmutex.tex,1.5,1.6 libposixpath.tex,1.22,1.23 librobotparser.tex,1.4,1.5 libtabnanny.tex,1.2,1.3
Neal Norwitz
nnorwitz@users.sourceforge.net
Thu, 04 Apr 2002 18:21:12 -0800
Update of /cvsroot/python/python/dist/src/Doc/lib
In directory usw-pr-cvs1:/tmp/cvs-serv31876/Doc/lib
Modified Files:
libasyncore.tex libcfgparser.tex libcode.tex libfilecmp.tex
libmutex.tex libposixpath.tex librobotparser.tex
libtabnanny.tex
Log Message:
Update doc to reflect Tim's changes to bool.
Index: libasyncore.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libasyncore.tex,v
retrieving revision 1.11
retrieving revision 1.12
diff -C2 -d -r1.11 -r1.12
*** libasyncore.tex 31 Jan 2002 17:32:24 -0000 1.11
--- libasyncore.tex 5 Apr 2002 02:21:09 -0000 1.12
***************
*** 119,123 ****
Each time through the \method{select()} loop, the set of sockets
is scanned, and this method is called to see if there is any
! interest in reading. The default method simply returns \code{1},
indicating that by default, all channels will be interested.
\end{methoddesc}
--- 119,123 ----
Each time through the \method{select()} loop, the set of sockets
is scanned, and this method is called to see if there is any
! interest in reading. The default method simply returns \code{True},
indicating that by default, all channels will be interested.
\end{methoddesc}
***************
*** 126,130 ****
Each time through the \method{select()} loop, the set of sockets
is scanned, and this method is called to see if there is any
! interest in writing. The default method simply returns \code{1},
indicating that by default, all channels will be interested.
\end{methoddesc}
--- 126,130 ----
Each time through the \method{select()} loop, the set of sockets
is scanned, and this method is called to see if there is any
! interest in writing. The default method simply returns \code{True},
indicating that by default, all channels will be interested.
\end{methoddesc}
Index: libcfgparser.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libcfgparser.tex,v
retrieving revision 1.21
retrieving revision 1.22
diff -C2 -d -r1.21 -r1.22
*** libcfgparser.tex 7 Dec 2001 21:35:57 -0000 1.21
--- libcfgparser.tex 5 Apr 2002 02:21:09 -0000 1.22
***************
*** 212,216 ****
\begin{methoddesc}{remove_section}{section}
Remove the specified \var{section} from the configuration.
! If the section in fact existed, return 1. Otherwise return 0.
\end{methoddesc}
--- 212,217 ----
\begin{methoddesc}{remove_section}{section}
Remove the specified \var{section} from the configuration.
! If the section in fact existed, return \code{True}.
! Otherwise return \code{False}.
\end{methoddesc}
Index: libcode.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libcode.tex,v
retrieving revision 1.13
retrieving revision 1.14
diff -C2 -d -r1.13 -r1.14
*** libcode.tex 27 Aug 2001 20:02:16 -0000 1.13
--- libcode.tex 5 Apr 2002 02:21:09 -0000 1.14
***************
*** 81,90 ****
syntax traceback will be printed by calling the
\method{showsyntaxerror()} method. \method{runsource()} returns
! \code{0}.
\item
The input is incomplete, and more input is required;
\function{compile_command()} returned \code{None}.
! \method{runsource()} returns \code{1}.
\item
--- 81,90 ----
syntax traceback will be printed by calling the
\method{showsyntaxerror()} method. \method{runsource()} returns
! \code{False}.
\item
The input is incomplete, and more input is required;
\function{compile_command()} returned \code{None}.
! \method{runsource()} returns \code{True}.
\item
***************
*** 92,96 ****
object. The code is executed by calling the \method{runcode()} (which
also handles run-time exceptions, except for \exception{SystemExit}).
! \method{runsource()} returns \code{0}.
\end{itemize}
--- 92,96 ----
object. The code is executed by calling the \method{runcode()} (which
also handles run-time exceptions, except for \exception{SystemExit}).
! \method{runsource()} returns \code{False}.
\end{itemize}
***************
*** 156,161 ****
executed or invalid, the buffer is reset; otherwise, the command is
incomplete, and the buffer is left as it was after the line was
! appended. The return value is \code{1} if more input is required,
! \code{0} if the line was dealt with in some way (this is the same as
\method{runsource()}).
\end{methoddesc}
--- 156,161 ----
executed or invalid, the buffer is reset; otherwise, the command is
incomplete, and the buffer is left as it was after the line was
! appended. The return value is \code{True} if more input is required,
! \code{False} if the line was dealt with in some way (this is the same as
\method{runsource()}).
\end{methoddesc}
Index: libfilecmp.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libfilecmp.tex,v
retrieving revision 1.6
retrieving revision 1.7
diff -C2 -d -r1.6 -r1.7
*** libfilecmp.tex 20 Mar 2002 18:55:09 -0000 1.6
--- libfilecmp.tex 5 Apr 2002 02:21:09 -0000 1.7
***************
*** 13,18 ****
\begin{funcdesc}{cmp}{f1, f2\optional{, shallow\optional{, use_statcache}}}
! Compare the files named \var{f1} and \var{f2}, returning \code{1} if
! they seem equal, \code{0} otherwise.
Unless \var{shallow} is given and is false, files with identical
--- 13,18 ----
\begin{funcdesc}{cmp}{f1, f2\optional{, shallow\optional{, use_statcache}}}
! Compare the files named \var{f1} and \var{f2}, returning \code{True} if
! they seem equal, \code{False} otherwise.
Unless \var{shallow} is given and is false, files with identical
***************
*** 52,58 ****
>>> import filecmp
>>> filecmp.cmp('libundoc.tex', 'libundoc.tex')
! 1
>>> filecmp.cmp('libundoc.tex', 'lib.tex')
! 0
\end{verbatim}
--- 52,58 ----
>>> import filecmp
>>> filecmp.cmp('libundoc.tex', 'libundoc.tex')
! True
>>> filecmp.cmp('libundoc.tex', 'lib.tex')
! False
\end{verbatim}
Index: libmutex.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libmutex.tex,v
retrieving revision 1.5
retrieving revision 1.6
diff -C2 -d -r1.5 -r1.6
*** libmutex.tex 9 Jan 2001 20:54:15 -0000 1.5
--- libmutex.tex 5 Apr 2002 02:21:09 -0000 1.6
***************
*** 42,46 ****
\begin{methoddesc}{testandset}{}
``Atomic'' test-and-set, grab the lock if it is not set,
! and return true, otherwise, return false.
\end{methoddesc}
--- 42,46 ----
\begin{methoddesc}{testandset}{}
``Atomic'' test-and-set, grab the lock if it is not set,
! and return \code{True}, otherwise, return \code{False}.
\end{methoddesc}
Index: libposixpath.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libposixpath.tex,v
retrieving revision 1.22
retrieving revision 1.23
diff -C2 -d -r1.22 -r1.23
*** libposixpath.tex 28 Nov 2001 07:26:15 -0000 1.22
--- libposixpath.tex 5 Apr 2002 02:21:09 -0000 1.23
***************
*** 43,47 ****
\begin{funcdesc}{exists}{path}
! Return true if \var{path} refers to an existing path.
\end{funcdesc}
--- 43,47 ----
\begin{funcdesc}{exists}{path}
! Return \code{True} if \var{path} refers to an existing path.
\end{funcdesc}
***************
*** 89,98 ****
\begin{funcdesc}{isabs}{path}
! Return true if \var{path} is an absolute pathname (begins with a
slash).
\end{funcdesc}
\begin{funcdesc}{isfile}{path}
! Return true if \var{path} is an existing regular file. This follows
symbolic links, so both \function{islink()} and \function{isfile()}
can be true for the same path.
--- 89,98 ----
\begin{funcdesc}{isabs}{path}
! Return \code{True} if \var{path} is an absolute pathname (begins with a
slash).
\end{funcdesc}
\begin{funcdesc}{isfile}{path}
! Return \code{True} if \var{path} is an existing regular file. This follows
symbolic links, so both \function{islink()} and \function{isfile()}
can be true for the same path.
***************
*** 100,104 ****
\begin{funcdesc}{isdir}{path}
! Return true if \var{path} is an existing directory. This follows
symbolic links, so both \function{islink()} and \function{isdir()} can
be true for the same path.
--- 100,104 ----
\begin{funcdesc}{isdir}{path}
! Return \code{True} if \var{path} is an existing directory. This follows
symbolic links, so both \function{islink()} and \function{isdir()} can
be true for the same path.
***************
*** 106,115 ****
\begin{funcdesc}{islink}{path}
! Return true if \var{path} refers to a directory entry that is a
! symbolic link. Always false if symbolic links are not supported.
\end{funcdesc}
\begin{funcdesc}{ismount}{path}
! Return true if pathname \var{path} is a \dfn{mount point}: a point in
a file system where a different file system has been mounted. The
function checks whether \var{path}'s parent, \file{\var{path}/..}, is
--- 106,115 ----
\begin{funcdesc}{islink}{path}
! Return \code{True} if \var{path} refers to a directory entry that is a
! symbolic link. Always \code{False} if symbolic links are not supported.
\end{funcdesc}
\begin{funcdesc}{ismount}{path}
! Return \code{True} if pathname \var{path} is a \dfn{mount point}: a point in
a file system where a different file system has been mounted. The
function checks whether \var{path}'s parent, \file{\var{path}/..}, is
***************
*** 150,154 ****
\begin{funcdesc}{samefile}{path1, path2}
! Return true if both pathname arguments refer to the same file or
directory (as indicated by device number and i-node number).
Raise an exception if a \function{os.stat()} call on either pathname
--- 150,154 ----
\begin{funcdesc}{samefile}{path1, path2}
! Return \code{True} if both pathname arguments refer to the same file or
directory (as indicated by device number and i-node number).
Raise an exception if a \function{os.stat()} call on either pathname
***************
*** 158,162 ****
\begin{funcdesc}{sameopenfile}{fp1, fp2}
! Return true if the file objects \var{fp1} and \var{fp2} refer to the
same file. The two file objects may represent different file
descriptors.
--- 158,162 ----
\begin{funcdesc}{sameopenfile}{fp1, fp2}
! Return \code{True} if the file objects \var{fp1} and \var{fp2} refer to the
same file. The two file objects may represent different file
descriptors.
***************
*** 165,169 ****
\begin{funcdesc}{samestat}{stat1, stat2}
! Return true if the stat tuples \var{stat1} and \var{stat2} refer to
the same file. These structures may have been returned by
\function{fstat()}, \function{lstat()}, or \function{stat()}. This
--- 165,169 ----
\begin{funcdesc}{samestat}{stat1, stat2}
! Return \code{True} if the stat tuples \var{stat1} and \var{stat2} refer to
the same file. These structures may have been returned by
\function{fstat()}, \function{lstat()}, or \function{stat()}. This
Index: librobotparser.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/librobotparser.tex,v
retrieving revision 1.4
retrieving revision 1.5
diff -C2 -d -r1.4 -r1.5
*** librobotparser.tex 6 Nov 2001 22:14:35 -0000 1.4
--- librobotparser.tex 5 Apr 2002 02:21:09 -0000 1.5
***************
*** 36,40 ****
\begin{methoddesc}{can_fetch}{useragent, url}
! Returns true if the \var{useragent} is allowed to fetch the \var{url}
according to the rules contained in the parsed \file{robots.txt} file.
\end{methoddesc}
--- 36,40 ----
\begin{methoddesc}{can_fetch}{useragent, url}
! Returns \code{True} if the \var{useragent} is allowed to fetch the \var{url}
according to the rules contained in the parsed \file{robots.txt} file.
\end{methoddesc}
***************
*** 61,66 ****
>>> rp.read()
>>> rp.can_fetch("*", "http://www.musi-cal.com/cgi-bin/search?city=San+Francisco")
! 0
>>> rp.can_fetch("*", "http://www.musi-cal.com/")
! 1
\end{verbatim}
--- 61,66 ----
>>> rp.read()
>>> rp.can_fetch("*", "http://www.musi-cal.com/cgi-bin/search?city=San+Francisco")
! False
>>> rp.can_fetch("*", "http://www.musi-cal.com/")
! True
\end{verbatim}
Index: libtabnanny.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/lib/libtabnanny.tex,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -d -r1.2 -r1.3
*** libtabnanny.tex 20 Oct 2001 04:24:09 -0000 1.2
--- libtabnanny.tex 5 Apr 2002 02:21:09 -0000 1.3
***************
*** 30,34 ****
\begin{datadesc}{verbose}
Flag indicating whether to print verbose messages.
! This is set to true by the \code{-v} option if called as a script.
\end{datadesc}
--- 30,34 ----
\begin{datadesc}{verbose}
Flag indicating whether to print verbose messages.
! This is incremented by the \code{-v} option if called as a script.
\end{datadesc}