From 4b0140061608f15e0d64f17d44e18971cd11521a Mon Sep 17 00:00:00 2001 From: Kyle Cordes Date: Thu, 23 Feb 2017 18:35:29 -0600 Subject: [PATCH] Docs: Clarify CLI semantics when listing more than one task --- docs/CLI.md | 16 ++++++++++++++-- 1 file changed, 14 insertions(+), 2 deletions(-) diff --git a/docs/CLI.md b/docs/CLI.md index c9bb2631..9752e151 100644 --- a/docs/CLI.md +++ b/docs/CLI.md @@ -1,10 +1,22 @@ ### Usage -gulp [flags] tasks +`gulp [flags] ...` ### Tasks -Tasks can be executed by running `gulp `. Just running `gulp` will execute the task you registered called `default`. If there is no `default` task, gulp will error. +The task(s) listed will be executed. +If more than one task is listed, Gulp will execute all of them +concurrently, that is, as if they had all been listed as dependencies of +a single task. + +Gulp does not serialize tasks listed on the command line. From using +other comparable tools users may expect to execute something like +`gulp clean build`, with tasks named `clean` and `build`. This will not +produce the intended result, as the two tasks will be executed +concurrently. + +Just running `gulp` will execute the task `default`. If there is no +`default` task, gulp will error. ### Compilers