adding return values; updating docs
Merge pull request #27 from dr-strangecode/return_params

Return params