Update docstring for Parameters.parse.

As pointed out in issue #10, it was not very clear what the parse method
was doing.  This new docstring should rectify that but a readability
expert should really let loose on all of the documentation we have.