Differences between :mod:`doctest` and :mod:`doctest2`
=============================================================

This article explains the new features in :mod:`doctest2` as compared to 
:mod:`doctest`. It also serves as an introduction to :mod:`doctest2` for those
already familiar with the original :mod:`doctest`.

.. seealso::

    `doctest <http://docs.python.org/library/doctest>`_ - :mod:`doctest` module documentation

Option Flags and Directives
---------------------------

.. todo:: detail added directives, changed defaults.

Shell Doctests
--------------

.. todo:: detail shell doctest stuff.