document the return value of gulp.src

Closes #673
Merge pull request #674 from pkozlowski-opensource/issue673

document the return value of gulp.src