interface improvements
added comments for #50
Merge pull request #64 from mikeedwards/issue_50

Issue 50