Updated docstrings for crumbs.

The new docstrings should be much easier to read and provide a more
comprhensive set of information.  They still need edits before a new
release is cut but they are ready for review.