Issue 11: Complete method declaration (including documentation).
Issue 11: Method implementation.
Merge pull request #20 from penguineer/issue11

Fix for #11