Added explanatory text to doctest comments.
minor fixes