document the return value of gulp.src

Closes #673