diff options
Diffstat (limited to 'Doc/lib/libdoctest.tex')
| -rw-r--r-- | Doc/lib/libdoctest.tex | 16 |
1 files changed, 6 insertions, 10 deletions
diff --git a/Doc/lib/libdoctest.tex b/Doc/lib/libdoctest.tex index 4d55fec..1dab55f 100644 --- a/Doc/lib/libdoctest.tex +++ b/Doc/lib/libdoctest.tex @@ -712,14 +712,12 @@ can be useful. \subsubsection{Warnings\label{doctest-warnings}} -\begin{itemize} - -\item \module{doctest} is serious about requiring exact matches in expected - output. If even a single character doesn't match, the test fails. This - will probably surprise you a few times, as you learn exactly what Python - does and doesn't guarantee about output. For example, when printing a - dict, Python doesn't guarantee that the key-value pairs will be printed - in any particular order, so a test like +\module{doctest} is serious about requiring exact matches in expected +output. If even a single character doesn't match, the test fails. This +will probably surprise you a few times, as you learn exactly what Python +does and doesn't guarantee about output. For example, when printing a +dict, Python doesn't guarantee that the key-value pairs will be printed +in any particular order, so a test like % Hey! What happened to Monty Python examples? % Tim: ask Guido -- it's his example! @@ -788,8 +786,6 @@ often contrive doctest examples to produce numbers of that form: Simple fractions are also easier for people to understand, and that makes for better documentation. -\end{itemize} - \subsection{Basic API\label{doctest-basic-api}} The functions \function{testmod()} and \function{testfile()} provide a |