improved documentation of this method and fix to wrong variable name in return
Merge pull request #1577 from rossriley/multiple-upload-improvements

improved comments and fix to wrong variable name in return