diff options
| author | Brett Cannon <bcannon@gmail.com> | 2011-02-05 22:16:40 (GMT) |
|---|---|---|
| committer | Brett Cannon <bcannon@gmail.com> | 2011-02-05 22:16:40 (GMT) |
| commit | 45aa7cc7a7fc6db5ea3b2dd2b242700cab53e85c (patch) | |
| tree | 759d88779e5547621c32ee9a7b493a1a648a4bc2 /Doc | |
| parent | ce71ab2d69f70da4138b90a40a3254361650ed60 (diff) | |
| download | cpython-45aa7cc7a7fc6db5ea3b2dd2b242700cab53e85c.zip cpython-45aa7cc7a7fc6db5ea3b2dd2b242700cab53e85c.tar.gz cpython-45aa7cc7a7fc6db5ea3b2dd2b242700cab53e85c.tar.bz2 | |
Soften wording on doctest.
Diffstat (limited to 'Doc')
| -rw-r--r-- | Doc/howto/pyporting.rst | 12 |
1 files changed, 8 insertions, 4 deletions
diff --git a/Doc/howto/pyporting.rst b/Doc/howto/pyporting.rst index 5b24a3f..8876c81 100644 --- a/Doc/howto/pyporting.rst +++ b/Doc/howto/pyporting.rst @@ -483,10 +483,14 @@ Been deprecated for a while, but Python 3 finally drops support for friends. -Stop Using :mod:`doctest` -''''''''''''''''''''''''' -While 2to3 tries to port doctests properly, it's a rather tough thing to do. It -is probably best to simply convert your critical doctests to :mod:`unittest`. +Updating doctests +''''''''''''''''' +2to3_ will attempt to generate fixes for doctests that it comes across. It's +not perfect, though. If you wrote a monolithic set of doctests (e.g., a single +docstring containing all of your doctests), you should at least consider +breaking the doctests up into smaller pieces to make it more manageable to fix. +Otherwise it might very well be worth your time and effort to port your tests +to :mod:`unittest`. Eliminate ``-3`` Warnings |