gulp.src ignore option does not match documentation

Created by: breyed

The gulp API docs indicate that gulp supports all options supported by node-glob:

gulp adds some additional options in addition to the options supported by node-glob and glob-stream:

Node-glob says it supports an ignore option.

ignore Add a pattern or an array of patterns to exclude matches.

Furthermore, node-glob says to use ignore and not to use negation:

The intent for negation would be for a pattern starting with ! to match everything that doesn't match the supplied pattern. However, the implementation is weird. It is better to use the ignore option to set a pattern or set of patterns to exclude from matches.

However, as indicated in issue #1176 (closed), ignore does not work in gulp. Something is broken: the docs, the implementation, or both. Step one is to determine the desired state. Step two is to update the docs and/or code. What should the behavior be?