Added a comment and doctest code to the new method.
Adding example usage.
Preparing for a v0.3 release.