Documentation around glob patterns and shell expansion

[jsdevel]

Not sure if it is needed, but it may be worth noting that due to shell expansion, glob patterns should be wrapped in single quotes on unix shells.

mocha -w -r should 'test/**/*.js'

Using that would render the --recursive flag useless.

[mrjoelkemp]

Similar to #1175.

I agree that this should be noted. Seems like it should be added in the man page and on the site's rendering of the man page.

I'm not sure what's the standard way of noting this precondition of globbing.

Would it be like:

Usage: mocha [debug] [options] [files | 'glob']

or

Usage: mocha [debug] [options] [files] ['glob']

or should it be a separate section "Notes" that contains the hint to quote the glob?

[thom4parisot]

Good catch!

[alexgorbatchev]

💯 👍 got bitten by this! thank you!

[jsdevel]

Some interesting notes on expansion: http://www.gnu.org/software/bash/manual/bashref.html#Filename-Expansion

[jbnicolai]

Anyone willing to create a PR for this?

[boneskull]

continue in mochajs/old-mochajs-site#8

[plroebuck]

Is this done (from 3+ years ago)?

[boneskull]

nope. see #3136