Acknowledge that the input option is conditionally required (#3696)

* docs: explain when input is optional * docs: conditionally required input * docs: conditionally required input 2
rollup · Jul 28, 2020 · cd47fcf · cd47fcf
1 parent 966838a
commit cd47fcf
Show file tree

Hide file tree

Showing 3 changed files with 4 additions and 2 deletions.
diff --git a/docs/01-command-line-reference.md b/docs/01-command-line-reference.md
@@ -30,7 +30,7 @@ Config files support the options listed below. Consult the [big list of options]
 export default { // can be an array (for multiple inputs)
   // core input options
   external,
-  input, // required
+  input, // conditionally required
   plugins,
 
   // advanced input options

diff --git a/docs/02-javascript-api.md b/docs/02-javascript-api.md
@@ -81,7 +81,7 @@ The `inputOptions` object can contain the following properties (see the [big lis
 const inputOptions = {
   // core input options
   external,
-  input, // required
+  input, // condtionally required
   plugins,
 
   // advanced input options

diff --git a/docs/999-big-list-of-options.md b/docs/999-big-list-of-options.md
@@ -91,6 +91,8 @@ export default {
 };
 ```
 
+The option can be omitted if some plugin emits at least one chunk (using [`this.emitFile`](guide/en/#thisemitfileemittedfile-emittedchunk--emittedasset--string)) by the end of the [`buildStart`](guide/en/#buildstart) hook.
+
 When using the command line interface, multiple inputs can be provided by using the option multiple times. When provided as the first options, it is equivalent to not prefix them with `--input`:
 
 ```sh