documentation builds all javascript files, not just those specified

[balupton]

If I do documentation build ./source/**.js -f html -g -o docs even javascript files not within ./source are added to the docs... this should not be the case

documentation build ./source/*.js -f html -g -o docs does the same

$ documentation --version
4.0.0-beta2

[balupton]

If not supported, http://npmjs.com/glob for the input string when using the CLI would be great

[balupton]

--shallow seems to fix this, however this seems like it should be the default behaviour... as otherwise specifying a glob pattern is useless if everything is used anyway

[tmcw]

The default behavior of documentation.js is following dependency trees (see the 4th heading). In this way the expectation should be the same as browserify or webpack or node - you don't specify all of the files on the CLI, only the entry files. Long-winded way of saying, feature, not bug.

--shallow turns off dependency resolution and has a behavior more typical of non-JS-aware utilities, but I'm not really that sure that it's a good default. See discussion in #342 for one soul-searching moment I had about this.

[tmcw]

Closing; --shallow is the default, and via #342 the majority user expectation - I've added a note to FAQ.md and referenced this issue to make this information more discoverable.