Introductory PyClaw docs updated and doctests passing.

The PyClaw docs now reflect the current state of the code, mostly.