gulpjs
diff --git a/‎docs/API.md
+7-5 b/‎docs/API.md
+7-5
diff --git a/‎index.js
+2 b/‎index.js
+2
diff --git a/‎test/watch.js
+4 b/‎test/watch.js
+4
@@ -504,7 +504,7 @@ Type: `Array`, `String` or `Function`
 A task name, a function or an array of either.
 
 
-### gulp.watch(glob[, opts], fn)
+### gulp.watch(glob[, opts][, fn])
 
 Watch files and do something when a file changes.
 File watching is provided by the [`chokidar`][chokidar] module.
@@ -515,7 +515,7 @@ Please report any file watching problems directly to its
 gulp.watch('js/**/*.js', gulp.parallel('uglify', 'reload'));
 ```
 
-In the example, `gulp.watch` runs the function returned by gulp.parallel each
+In the example, `gulp.watch` runs the function returned by `gulp.parallel` each
 time a file with the `js` extension in `js/` is updated.
 
 #### glob
@@ -548,12 +548,14 @@ Read about the full set of options in [`chokidar`'s README][chokidar].
 #### fn
 Type: `Function`
 
-An [async](#async-support) function to run when a file changes.
+An [async](#async-support) function to run when a file changes. Does not provide
+access to the `path` parameter.
 
 `gulp.watch` returns a wrapped [chokidar] FSWatcher object. If provided,
 the callback will be triggered upon any `add`, `change`, or `unlink` event.
 Listeners can also be set directly for any of [chokidar]'s events, such as
-`addDir`, `unlinkDir`, and `error`.
+`addDir`, `unlinkDir`, and `error`. You must set listeners directly to get
+access to chokidar's callback parameters, such as `path`.
 
 ```js
 var watcher = gulp.watch('js/**/*.js', gulp.parallel('uglify', 'reload'));
@@ -569,7 +571,7 @@ watcher.on('unlink', function(path) {
 ##### path
 Type: `String`
 
-The relative path of the document.
+Path to the file. If `opts.cwd` is set, `path` is relative to it.
 
 ##### stats
 
@@ -35,6 +35,8 @@ Gulp.prototype.watch = function(glob, opt, task) {
     opt = {};
   }
 
+  opt = opt || {};
+
   var fn;
   if (typeof task === 'function') {
     fn = this.parallel(task);
 
@@ -126,6 +126,10 @@ describe('gulp', function() {
       updateTempFile(tempFile);
     });
 
+    it('should work without options or callback', function() {
+      gulp.watch('x');
+    });
+
     it('should run many tasks: w/ options', function(done) {
       var tempFile = path.join(outpath, 'watch-task-options.txt');
       var a = 0;
Original file line number	Diff line number	Diff line change
`@@ -35,6 +35,8 @@ Gulp.prototype.watch = function(glob, opt, task) {`
`35`	`35`	`opt = {};`
`36`	`36`	`}`
`37`	`37`
	`38`	`+ opt = opt \|\| {};`
	`39`	`+`
`38`	`40`	`var fn;`
`39`	`41`	`if (typeof task === 'function') {`
`40`	`42`	`fn = this.parallel(task);`