README edited.
docstring corrections.
reference updated.