Given my experience with Python's docstrings, I wish there could be an easy
way to execute the docstring examples inside the REPL, especially when they
are of the form:
"""
>>> some-code
return-value
"""
If the documentation is an object, and not a string, the *return-value*
could be generated together with the documentation, or otherwise have its
correctness tested.
Another great headache in Python is debugging the documentation examples,
since the code-to-string-to-code conversions lose the trace of the
debugger. I would prefer the documentation (especially the documentation
examples) to be part of the program's AST, rather than a string.
Anyways, it would be nice to be able to execute the documentation examples
from the REPL, and possibly also get the AST of the documentation examples
inside the REPL.
