updated interface + docs
correct return values and docs
Merge pull request #9 from Matt-Esch/master

Updated interface + docs