Update gulp API doc with info on file base

Expand on what file base is and how it affects the relative path calculation. Fixes #699.
single quotes to be consistent with the rest of the docs