Docs: Improve readme & manpage

Author: phated

README.md

@@ -13,10 +13,26 @@ Command Line Utility for Gulp
 ## Usage
 
 ```bash
-> gulp [options] tasks
+> gulp [flags] tasks
 ```
 
-## Options
+## Tasks
+
+Tasks can be executed by running `gulp <task> <othertask>`. Just running `gulp` will execute the task you registered called `default`. If there is no `default` task, gulp will error.
+
+## Compilers
+
+You can find a list of supported languages at https://github.com/js-cli/js-interpret. If you would like to add support for a new language, send pull requests/open issues on that project.
+
+## Environment
+
+The CLI adds process.env.INIT_CWD which is the original cwd it was launched from.
+
+## Flags
+
+gulp has very few flags to know about. All other flags are for tasks to use if needed.
+
+__Some flags only work with gulp 4 and will be ignored when invoked against gulp 3.__
 
 <table>
   <thead>

docs/CLI.md

@@ -1,25 +1,63 @@
-## gulp CLI docs
+### Usage
+
+gulp [flags] tasks
+
+### Tasks
+
+Tasks can be executed by running `gulp <task> <othertask>`. Just running `gulp` will execute the task you registered called `default`. If there is no `default` task, gulp will error.
+
+### Compilers
+
+You can find a list of supported languages at https://github.com/js-cli/js-interpret. If you would like to add support for a new language, send pull requests/open issues on that project.
+
+### Environment
+
+The CLI adds process.env.INIT_CWD which is the original cwd it was launched from.
 
 ### Flags
 
 gulp has very few flags to know about. All other flags are for tasks to use if needed.
 
-- `-v` or `--version` will display the global and local gulp versions
-- `--require <module path>` will require a module before running the gulpfile. This is useful for transpilers but also has other applications. You can use multiple `--require` flags
-- `--gulpfile <gulpfile path>` will manually set path of gulpfile. Useful if you have multiple gulpfiles. This will set the CWD to the gulpfile directory as well
-- `--cwd <dir path>` will manually set the CWD. The search for the gulpfile, as well as the relativity of all requires will be from here
-- `-T` or `--tasks` will display the task dependency tree for the loaded gulpfile
-- `--tasks-simple` will display a plaintext list of tasks for the loaded gulpfile
-- `--color` will force gulp and gulp plugins to display colors even when no color support is detected
-- `--no-color` will force gulp and gulp plugins to not display colors even when color support is detected
-- `--silent` will disable all gulp logging
+**Some flags only work with gulp 4 and will be ignored when invoked against gulp 3.**
 
-The CLI adds process.env.INIT_CWD which is the original cwd it was launched from.
+**--help**, **-h**
+    Show the help.
 
-### Tasks
+**--version**, **-v**
+    Print the global and local gulp versions.
 
-Tasks can be executed by running `gulp <task> <othertask>`. Just running `gulp` will execute the task you registered called `default`. If there is no `default` task gulp will error.
+**--require** [path]
+    Will require a module before running the gulpfile. This is useful for transpilers but also has other applications.
 
-### Compilers
+**--gulpfile** [path]
+    Manually set path of gulpfile. Useful if you have multiple gulpfiles. This will set the CWD to the gulpfile directory as well.
+
+**--cwd** [path]
+    Manually set the CWD. The search for the gulpfile, as well as the relativity of all requires will be from here.
+
+**--verify** [path (optional)]
+    Will verify plugins referenced in project's package.json against the plugins blacklist.
+
+**--tasks**, **-T**
+    Print the task dependency tree for the loaded gulpfile.
+
+**--tasks-simple**
+    Print a plaintext list of tasks for the loaded gulpfile.
+
+**--tasks-json** [path]
+    Print the task dependency tree, in JSON format, for the loaded gulpfile. The [path] argument is optional, and if given writes the JSON to the path.
+
+**--color**
+    Will force gulp and gulp plugins to display colors, even when no color support is detected.
+
+**--no-color**
+    Will force gulp and gulp plugins to not display colors, even when color support is detected.
+
+**--silent**, **-S**
+    Suppress all gulp logging.
+
+**--continue**
+    Continue execution of tasks upon failure.
 
-You can find a list of supported languages at [interpret](https://github.com/tkellen/node-interpret#jsvariants). If you would like to add support for a new language send pull request/open issues there.
+**--log-level**, **-L**
+    Set the loglevel. -L for least verbose and -LLLL for most verbose. -LLL is default.

package.json

@@ -19,7 +19,8 @@
     "index.js",
     "lib",
     "bin",
-    "completion"
+    "completion",
+    "gulp.1"
   ],
   "scripts": {
     "coveralls": "lab -r lcov | coveralls",