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.
Just saying it seems like too much information and doesn't really have anything to do with the API itself