note the 2to3 -d could be useful for other refactoring

Doc/library/2to3.rst

@@ -74,7 +74,9 @@ warning beneath the diff for a file.  You should address the warning in order to
 have compliant 3.x code.
 
 2to3 can also refactor doctests.  To enable this mode, use the :option:`-d`
-flag.  Note that *only* doctests will be refactored.
+flag.  Note that *only* doctests will be refactored.  This also doesn't require
+the module to be valid Python.  For example, doctest like examples in a reST
+document could also be refactored with this option.
 
 The :option:`-v` option enables the output of more information on the
 translation process.