at the Python prompt, one can do
>>> from docpicture import view
and some_object's docstring will be displayed in your webbrowser, with any docpicture directive being translated so as to embed a nice picture. Well, by "any", I mean any turtle directive conforming to the limited syntax I have included.
When I compare the output of help() with that of docpicture.view(), I am struck at how much more information than simply the object's docstring is included. I have tried (briefly) to play with the pydoc module to see if I could redirect the output of help() to a string that I could process with docpicture.view() ... but to no avail.
If anyone knows how I could do this simply, I would be very grateful.
docpicture is going to be released (version 0.1) as soon as I complete a decent "readme" file.
--UPDATE-- Ok, after playing some more with pydoc, I found out how to do this.
In my module, I do the following:
from StringIO import StringIO
my_stdin = StringIO()
pydoc.pager = my_pager
retrieved = my_stdin.getvalue()
and use the retrieved text as I wish.