Updated the docs for `paths` option

The docs now say more about passing a function for the value of paths.