diff options
author | Fred Drake <fdrake@acm.org> | 2003-06-28 03:09:06 (GMT) |
---|---|---|
committer | Fred Drake <fdrake@acm.org> | 2003-06-28 03:09:06 (GMT) |
commit | 5d2f515dd4735ab8bb69a8fd806b14ae9e361549 (patch) | |
tree | 1c7690e2dce2b992e994584cc4912d1635c3b336 /Doc/lib | |
parent | c0fac96c29a3842d9370e4c954ae1f4d57f849d0 (diff) | |
download | cpython-5d2f515dd4735ab8bb69a8fd806b14ae9e361549.zip cpython-5d2f515dd4735ab8bb69a8fd806b14ae9e361549.tar.gz cpython-5d2f515dd4735ab8bb69a8fd806b14ae9e361549.tar.bz2 |
fix markup nits
Diffstat (limited to 'Doc/lib')
-rw-r--r-- | Doc/lib/libdoctest.tex | 24 |
1 files changed, 12 insertions, 12 deletions
diff --git a/Doc/lib/libdoctest.tex b/Doc/lib/libdoctest.tex index 253d6b4..2a33047 100644 --- a/Doc/lib/libdoctest.tex +++ b/Doc/lib/libdoctest.tex @@ -153,7 +153,7 @@ if __name__ == "__main__": \end{verbatim} If you want to test the module as the main module, you don't need to -pass M to \function{testmod}; in this case, it will test the current +pass M to \function{testmod()}; in this case, it will test the current module. Then running the module as a script causes the examples in the docstrings @@ -176,11 +176,12 @@ python M.py -v and a detailed report of all examples tried is printed to \code{stdout}, along with assorted summaries at the end. -You can force verbose mode by passing \code{verbose=1} to testmod, or +You can force verbose mode by passing \code{verbose=1} to +\function{testmod()}, or prohibit it by passing \code{verbose=0}. In either of those cases, -\code{sys.argv} is not examined by testmod. +\code{sys.argv} is not examined by \function{testmod()}. -In any case, testmod returns a 2-tuple of ints \code{(\var{f}, +In any case, \function{testmod()} returns a 2-tuple of ints \code{(\var{f}, \var{t})}, where \var{f} is the number of docstring examples that failed and \var{t} is the total number of docstring examples attempted. @@ -210,8 +211,8 @@ from \module{M}'s globals are skipped, all names reached from \subsection{What's the Execution Context?} -By default, each time testmod finds a docstring to test, it uses a -\emph{copy} of \module{M}'s globals, so that running tests on a module +By default, each time \function{testmod()} finds a docstring to test, it uses +a \emph{copy} of \module{M}'s globals, so that running tests on a module doesn't change the module's real globals, and so that one test in \module{M} can't leave behind crumbs that accidentally allow another test to work. This means examples can freely use any names defined at top-level @@ -400,21 +401,20 @@ def _test(): \end{verbatim} \item WYSIWYG isn't always the case, starting in Python 2.3. The - string form of boolean results changed from \code{"0"} and - \code{"1"} to \code{"False"} and \code{"True"} in Python 2.3. + string form of boolean results changed from \code{'0'} and + \code{'1'} to \code{'False'} and \code{'True'} in Python 2.3. This makes it clumsy to write a doctest showing boolean results that passes under multiple versions of Python. In Python 2.3, by default, and as a special case, if an expected output block consists solely - of \code{"0"} and the actual output block consists solely of - \code{"False"}, that's accepted as an exact match, and similarly for - \code{"1"} versus \code{"True"}. This behavior can be turned off by + of \code{'0'} and the actual output block consists solely of + \code{'False'}, that's accepted as an exact match, and similarly for + \code{'1'} versus \code{'True'}. This behavior can be turned off by passing the new (in 2.3) module constant \constant{DONT_ACCEPT_TRUE_FOR_1} as the value of \function{testmod()}'s new (in 2.3) optional \var{optionflags} argument. Some years after the integer spellings of booleans are history, this hack will probably be removed again. - \end{enumerate} |