diff --git a/README.md b/README.md
index d4f88cd6..4fae6531 100644
--- a/README.md
+++ b/README.md
@@ -73,7 +73,7 @@ The user manual has an [example](https://picocli.info/#_guice_example) of integr
 
 ### Releases
 * [All Releases](https://github.com/remkop/picocli/releases)
-* Latest: 4.1.4 [Release Notes](https://github.com/remkop/picocli/releases/tag/v4.1.4)
+* Latest: 4.2.0 [Release Notes](https://github.com/remkop/picocli/releases/tag/v4.2.0)
 * Older: Picocli 4.0 [Release Notes](https://github.com/remkop/picocli/releases/tag/v4.0.0)
 * Older: Picocli 3.0 [Release Notes](https://github.com/remkop/picocli/releases/tag/v3.0.0)
 * Older: Picocli 2.0 [Release Notes](https://github.com/remkop/picocli/releases/tag/v2.0.0)
@@ -187,9 +187,9 @@ If you like picocli, there are a few things you can do to help:
 * Upvote my [StackOverflow answer](https://stackoverflow.com/a/43780433/1446916) to "How do I parse command line arguments in Java?"
 * Tweet about picocli! What do you like about it? How has it helped you? How is it different from the alternatives?
 
-If you like picocli and your project is on GitHub, consider adding this badge to your README.md: [![picocli](https://img.shields.io/badge/picocli-4.1.4-green.svg)](https://github.com/remkop/picocli)
+If you like picocli and your project is on GitHub, consider adding this badge to your README.md: [![picocli](https://img.shields.io/badge/picocli-4.2.0-green.svg)](https://github.com/remkop/picocli)
 ```
-[![picocli](https://img.shields.io/badge/picocli-4.1.4-green.svg)](https://github.com/remkop/picocli)
+[![picocli](https://img.shields.io/badge/picocli-4.2.0-green.svg)](https://github.com/remkop/picocli)
 ```
 
 
@@ -277,35 +277,35 @@ See the [source code](https://github.com/remkop/picocli/blob/master/src/main/jav
 
 ### Gradle
 ```
-compile 'info.picocli:picocli:4.1.4'
+compile 'info.picocli:picocli:4.2.0'
 ```
 ### Maven
 ```
 <dependency>
   <groupId>info.picocli</groupId>
   <artifactId>picocli</artifactId>
-  <version>4.1.4</version>
+  <version>4.2.0</version>
 </dependency>
 ```
 ### Scala SBT
 ```
-libraryDependencies += "info.picocli" % "picocli" % "4.1.4"
+libraryDependencies += "info.picocli" % "picocli" % "4.2.0"
 ```
 ### Ivy
 ```
-<dependency org="info.picocli" name="picocli" rev="4.1.4" />
+<dependency org="info.picocli" name="picocli" rev="4.2.0" />
 ```
 ### Grape
 ```groovy
 @Grapes(
-    @Grab(group='info.picocli', module='picocli', version='4.1.4')
+    @Grab(group='info.picocli', module='picocli', version='4.2.0')
 )
 ```
 ### Leiningen
 ```
-[info.picocli/picocli "4.1.4"]
+[info.picocli/picocli "4.2.0"]
 ```
 ### Buildr
 ```
-'info.picocli:picocli:jar:4.1.4'
+'info.picocli:picocli:jar:4.2.0'
 ```
diff --git a/RELEASE-NOTES.md b/RELEASE-NOTES.md
index 6a6116e0..9ba750f2 100644
--- a/RELEASE-NOTES.md
+++ b/RELEASE-NOTES.md
@@ -1,6 +1,6 @@
 # picocli Release Notes
 
-# <a name="4.2.0"></a> Picocli 4.2.0 (UNRELEASED)
+# <a name="4.2.0"></a> Picocli 4.2.0
 The picocli community is pleased to announce picocli 4.2.0.
 
 This release adds support for Repeatable Subcommands: when a command is marked as `@Command(subcommandsRepeatable = true)` it becomes possible to specify that command's subcommands multiple times on the command line.
diff --git a/build.gradle b/build.gradle
index 3dc42569..c2dd0bd9 100644
--- a/build.gradle
+++ b/build.gradle
@@ -276,10 +276,11 @@ task bumpReadmeVersion {
 }
 task bumpVersion {
     doLast {
-        ant.replaceregexp(match: "\"$projectPreviousVersionRegex\"", replace: "\"$version\"", flags: 'g', byline: true, encoding: 'UTF8') {
+        ant.replaceregexp(match: "$projectPreviousVersionRegex", replace: "$version", flags: 'g', byline: true, encoding: 'UTF8') {
             fileset(dir: 'src/main/java/picocli', includes: 'CommandLine.java')
             fileset(dir: 'src/test/java/picocli', includes: 'CommandLineTest.java')
             fileset(dir: 'src/main/java/picocli', includes: 'AutoComplete.java')
+            fileset(dir: 'src/test/java/picocli', includes: 'AutoCompleteTest.java')
             fileset(dir: 'picocli-codegen/src/main/java/picocli/codegen/aot/graalvm', includes: 'DynamicProxyConfigGenerator.java')
             fileset(dir: 'picocli-codegen/src/main/java/picocli/codegen/aot/graalvm', includes: 'JniConfigGenerator.java')
             fileset(dir: 'picocli-codegen/src/main/java/picocli/codegen/aot/graalvm', includes: 'ReflectionConfigGenerator.java')
@@ -304,6 +305,10 @@ task bumpVersion {
         ant.replaceregexp(match: ":picocli-groovy:$projectPreviousVersionRegex", replace: ":picocli-groovy:$version", flags: 'g', byline: true, encoding: 'UTF8') {
             fileset(dir: 'docs', includes: 'index.adoc')
         }
+        // Spring Boot section
+        ant.replaceregexp(match: ":picocli-spring-boot-starter:$projectPreviousVersionRegex", replace: ":picocli-spring-boot-starter:$version", flags: 'g', byline: true, encoding: 'UTF8') {
+            fileset(dir: 'docs', includes: 'index.adoc')
+        }
         // Downloads section, Gradle
         ant.replaceregexp(match: ":picocli:$projectPreviousVersionRegex", replace: ":picocli:$version", flags: 'g', byline: true, encoding: 'UTF8') {
             fileset(dir: 'docs', includes: 'index.adoc')
diff --git a/docs/A-Whirlwind-Tour-of-Picocli.html b/docs/A-Whirlwind-Tour-of-Picocli.html
index eb4f8dc9..ae32115f 100644
--- a/docs/A-Whirlwind-Tour-of-Picocli.html
+++ b/docs/A-Whirlwind-Tour-of-Picocli.html
@@ -528,7 +528,7 @@ table.CodeRay td.code>pre{padding:0}
 <h1>A Whirlwind Tour of Picocli</h1>
 <div class="details">
 <span id="author" class="author">Remko Popma</span><br>
-<span id="revnumber">version 4.1.4</span>
+<span id="revnumber">version 4.2.0</span>
 </div>
 </div>
 <div id="content">
@@ -1966,7 +1966,7 @@ sys     0m0.002s</code></pre>
 </div>
 <div id="footer">
 <div id="footer-text">
-Version 4.1.4<br>
+Version 4.2.0<br>
 Last updated 2019-11-14 09:38:16 +0900
 </div>
 </div>
diff --git a/docs/announcing-picocli-1.0.html b/docs/announcing-picocli-1.0.html
index bc2dc7ba..5eeb7ecb 100644
--- a/docs/announcing-picocli-1.0.html
+++ b/docs/announcing-picocli-1.0.html
@@ -528,7 +528,7 @@ table.CodeRay td.code>pre{padding:0}
 <h1>Announcing picocli 1.0 - a mighty tiny command line interface</h1>
 <div class="details">
 <span id="author" class="author">Remko Popma</span><br>
-<span id="revnumber">version 4.1.4,</span>
+<span id="revnumber">version 4.2.0,</span>
 <span id="revdate">2017-09-10</span>
 </div>
 </div>
@@ -652,7 +652,7 @@ CommandLine.usage(<span class="keyword">new</span> AnsiDescription(), <span clas
 </div>
 <div id="footer">
 <div id="footer-text">
-Version 4.1.4<br>
+Version 4.2.0<br>
 Last updated 2018-12-02 18:44:56 +0900
 </div>
 </div>
diff --git a/docs/apidocs/allclasses-frame.html b/docs/apidocs/allclasses-frame.html
index 1baef8fa..46350b02 100644
--- a/docs/apidocs/allclasses-frame.html
+++ b/docs/apidocs/allclasses-frame.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>All Classes (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>All Classes (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
diff --git a/docs/apidocs/allclasses-noframe.html b/docs/apidocs/allclasses-noframe.html
index 5fcfce8a..9046fb25 100644
--- a/docs/apidocs/allclasses-noframe.html
+++ b/docs/apidocs/allclasses-noframe.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>All Classes (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>All Classes (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
diff --git a/docs/apidocs/constant-values.html b/docs/apidocs/constant-values.html
index a8321feb..f460c3a6 100644
--- a/docs/apidocs/constant-values.html
+++ b/docs/apidocs/constant-values.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>Constant Field Values (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>Constant Field Values (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="Constant Field Values (picocli 4.1.4 API)";
+            parent.document.title="Constant Field Values (picocli 4.2.0 API)";
         }
     }
     catch(err) {
@@ -141,7 +141,7 @@
 <!--   -->
 </a><code>public&nbsp;static&nbsp;final&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td><code><a href="picocli/CommandLine.html#VERSION">VERSION</a></code></td>
-<td class="colLast"><code>"4.1.4"</code></td>
+<td class="colLast"><code>"4.2.0"</code></td>
 </tr>
 </tbody>
 </table>
@@ -279,111 +279,118 @@
 <td class="colLast"><code>80</code></td>
 </tr>
 <tr class="rowColor">
+<td class="colFirst"><a name="picocli.CommandLine.Model.UsageMessageSpec.SECTION_KEY_AT_FILE_PARAMETER">
+<!--   -->
+</a><code>public&nbsp;static&nbsp;final&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
+<td><code><a href="picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_AT_FILE_PARAMETER">SECTION_KEY_AT_FILE_PARAMETER</a></code></td>
+<td class="colLast"><code>"atFileParameterList"</code></td>
+</tr>
+<tr class="altColor">
 <td class="colFirst"><a name="picocli.CommandLine.Model.UsageMessageSpec.SECTION_KEY_COMMAND_LIST">
 <!--   -->
 </a><code>public&nbsp;static&nbsp;final&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td><code><a href="picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_COMMAND_LIST">SECTION_KEY_COMMAND_LIST</a></code></td>
 <td class="colLast"><code>"commandList"</code></td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colFirst"><a name="picocli.CommandLine.Model.UsageMessageSpec.SECTION_KEY_COMMAND_LIST_HEADING">
 <!--   -->
 </a><code>public&nbsp;static&nbsp;final&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td><code><a href="picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_COMMAND_LIST_HEADING">SECTION_KEY_COMMAND_LIST_HEADING</a></code></td>
 <td class="colLast"><code>"commandListHeading"</code></td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colFirst"><a name="picocli.CommandLine.Model.UsageMessageSpec.SECTION_KEY_DESCRIPTION">
 <!--   -->
 </a><code>public&nbsp;static&nbsp;final&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td><code><a href="picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_DESCRIPTION">SECTION_KEY_DESCRIPTION</a></code></td>
 <td class="colLast"><code>"description"</code></td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colFirst"><a name="picocli.CommandLine.Model.UsageMessageSpec.SECTION_KEY_DESCRIPTION_HEADING">
 <!--   -->
 </a><code>public&nbsp;static&nbsp;final&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td><code><a href="picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_DESCRIPTION_HEADING">SECTION_KEY_DESCRIPTION_HEADING</a></code></td>
 <td class="colLast"><code>"descriptionHeading"</code></td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colFirst"><a name="picocli.CommandLine.Model.UsageMessageSpec.SECTION_KEY_EXIT_CODE_LIST">
 <!--   -->
 </a><code>public&nbsp;static&nbsp;final&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td><code><a href="picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_EXIT_CODE_LIST">SECTION_KEY_EXIT_CODE_LIST</a></code></td>
 <td class="colLast"><code>"exitCodeList"</code></td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colFirst"><a name="picocli.CommandLine.Model.UsageMessageSpec.SECTION_KEY_EXIT_CODE_LIST_HEADING">
 <!--   -->
 </a><code>public&nbsp;static&nbsp;final&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td><code><a href="picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_EXIT_CODE_LIST_HEADING">SECTION_KEY_EXIT_CODE_LIST_HEADING</a></code></td>
 <td class="colLast"><code>"exitCodeListHeading"</code></td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colFirst"><a name="picocli.CommandLine.Model.UsageMessageSpec.SECTION_KEY_FOOTER">
 <!--   -->
 </a><code>public&nbsp;static&nbsp;final&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td><code><a href="picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_FOOTER">SECTION_KEY_FOOTER</a></code></td>
 <td class="colLast"><code>"footer"</code></td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colFirst"><a name="picocli.CommandLine.Model.UsageMessageSpec.SECTION_KEY_FOOTER_HEADING">
 <!--   -->
 </a><code>public&nbsp;static&nbsp;final&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td><code><a href="picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_FOOTER_HEADING">SECTION_KEY_FOOTER_HEADING</a></code></td>
 <td class="colLast"><code>"footerHeading"</code></td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colFirst"><a name="picocli.CommandLine.Model.UsageMessageSpec.SECTION_KEY_HEADER">
 <!--   -->
 </a><code>public&nbsp;static&nbsp;final&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td><code><a href="picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_HEADER">SECTION_KEY_HEADER</a></code></td>
 <td class="colLast"><code>"header"</code></td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colFirst"><a name="picocli.CommandLine.Model.UsageMessageSpec.SECTION_KEY_HEADER_HEADING">
 <!--   -->
 </a><code>public&nbsp;static&nbsp;final&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td><code><a href="picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_HEADER_HEADING">SECTION_KEY_HEADER_HEADING</a></code></td>
 <td class="colLast"><code>"headerHeading"</code></td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colFirst"><a name="picocli.CommandLine.Model.UsageMessageSpec.SECTION_KEY_OPTION_LIST">
 <!--   -->
 </a><code>public&nbsp;static&nbsp;final&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td><code><a href="picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_OPTION_LIST">SECTION_KEY_OPTION_LIST</a></code></td>
 <td class="colLast"><code>"optionList"</code></td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colFirst"><a name="picocli.CommandLine.Model.UsageMessageSpec.SECTION_KEY_OPTION_LIST_HEADING">
 <!--   -->
 </a><code>public&nbsp;static&nbsp;final&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td><code><a href="picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_OPTION_LIST_HEADING">SECTION_KEY_OPTION_LIST_HEADING</a></code></td>
 <td class="colLast"><code>"optionListHeading"</code></td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colFirst"><a name="picocli.CommandLine.Model.UsageMessageSpec.SECTION_KEY_PARAMETER_LIST">
 <!--   -->
 </a><code>public&nbsp;static&nbsp;final&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td><code><a href="picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_PARAMETER_LIST">SECTION_KEY_PARAMETER_LIST</a></code></td>
 <td class="colLast"><code>"parameterList"</code></td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colFirst"><a name="picocli.CommandLine.Model.UsageMessageSpec.SECTION_KEY_PARAMETER_LIST_HEADING">
 <!--   -->
 </a><code>public&nbsp;static&nbsp;final&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td><code><a href="picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_PARAMETER_LIST_HEADING">SECTION_KEY_PARAMETER_LIST_HEADING</a></code></td>
 <td class="colLast"><code>"parameterListHeading"</code></td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colFirst"><a name="picocli.CommandLine.Model.UsageMessageSpec.SECTION_KEY_SYNOPSIS">
 <!--   -->
 </a><code>public&nbsp;static&nbsp;final&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td><code><a href="picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_SYNOPSIS">SECTION_KEY_SYNOPSIS</a></code></td>
 <td class="colLast"><code>"synopsis"</code></td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colFirst"><a name="picocli.CommandLine.Model.UsageMessageSpec.SECTION_KEY_SYNOPSIS_HEADING">
 <!--   -->
 </a><code>public&nbsp;static&nbsp;final&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
diff --git a/docs/apidocs/deprecated-list.html b/docs/apidocs/deprecated-list.html
index 9c1a278b..d23fb848 100644
--- a/docs/apidocs/deprecated-list.html
+++ b/docs/apidocs/deprecated-list.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>Deprecated List (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>Deprecated List (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="Deprecated List (picocli 4.1.4 API)";
+            parent.document.title="Deprecated List (picocli 4.2.0 API)";
         }
     }
     catch(err) {
@@ -206,7 +206,7 @@
 </tr>
 <tr class="rowColor">
 <td class="colOne"><a href="picocli/CommandLine.Help.Ansi.Text.html#append-picocli.CommandLine.Help.Ansi.Text-">picocli.CommandLine.Help.Ansi.Text.append(CommandLine.Help.Ansi.Text)</a>
-<div class="block"><span class="deprecationComment">use <code>#concat(Text)</code> instead</span></div>
+<div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.Help.Ansi.Text.html#concat-picocli.CommandLine.Help.Ansi.Text-"><code>CommandLine.Help.Ansi.Text.concat(CommandLine.Help.Ansi.Text)</code></a> instead</span></div>
 </td>
 </tr>
 <tr class="altColor">
@@ -215,219 +215,244 @@
 </td>
 </tr>
 <tr class="rowColor">
+<td class="colOne"><a href="picocli/CommandLine.Help.Ansi.html#apply-java.lang.String-java.util.List-">picocli.CommandLine.Help.Ansi.apply(String, List&lt;CommandLine.Help.Ansi.IStyle&gt;)</a>
+<div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.Help.ColorScheme.html#apply-java.lang.String-java.util.List-"><code>CommandLine.Help.ColorScheme.apply(String, List)</code></a> instead</span></div>
+</td>
+</tr>
+<tr class="altColor">
 <td class="colOne"><a href="picocli/CommandLine.html#call-java.lang.Class-picocli.CommandLine.IFactory-java.io.PrintStream-picocli.CommandLine.Help.Ansi-java.lang.String...-">picocli.CommandLine.call(Class&lt;C&gt;, CommandLine.IFactory, PrintStream, CommandLine.Help.Ansi, String...)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#execute-java.lang.String...-"><code>CommandLine.execute(String...)</code></a> and <a href="picocli/CommandLine.html#getExecutionResult--"><code>CommandLine.getExecutionResult()</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colOne"><a href="picocli/CommandLine.html#call-java.lang.Class-picocli.CommandLine.IFactory-java.io.PrintStream-java.io.PrintStream-picocli.CommandLine.Help.Ansi-java.lang.String...-">picocli.CommandLine.call(Class&lt;C&gt;, CommandLine.IFactory, PrintStream, PrintStream, CommandLine.Help.Ansi, String...)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#execute-java.lang.String...-"><code>CommandLine.execute(String...)</code></a> and <a href="picocli/CommandLine.html#getExecutionResult--"><code>CommandLine.getExecutionResult()</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colOne"><a href="picocli/CommandLine.html#call-java.lang.Class-picocli.CommandLine.IFactory-java.io.PrintStream-java.lang.String...-">picocli.CommandLine.call(Class&lt;C&gt;, CommandLine.IFactory, PrintStream, String...)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#execute-java.lang.String...-"><code>CommandLine.execute(String...)</code></a> and <a href="picocli/CommandLine.html#getExecutionResult--"><code>CommandLine.getExecutionResult()</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colOne"><a href="picocli/CommandLine.html#call-java.lang.Class-picocli.CommandLine.IFactory-java.lang.String...-">picocli.CommandLine.call(Class&lt;C&gt;, CommandLine.IFactory, String...)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#execute-java.lang.String...-"><code>CommandLine.execute(String...)</code></a> and <a href="picocli/CommandLine.html#getExecutionResult--"><code>CommandLine.getExecutionResult()</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colOne"><a href="picocli/CommandLine.html#call-C-java.io.PrintStream-picocli.CommandLine.Help.Ansi-java.lang.String...-">picocli.CommandLine.call(C, PrintStream, CommandLine.Help.Ansi, String...)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#execute-java.lang.String...-"><code>CommandLine.execute(String...)</code></a> and <a href="picocli/CommandLine.html#getExecutionResult--"><code>CommandLine.getExecutionResult()</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colOne"><a href="picocli/CommandLine.html#call-C-java.io.PrintStream-java.io.PrintStream-picocli.CommandLine.Help.Ansi-java.lang.String...-">picocli.CommandLine.call(C, PrintStream, PrintStream, CommandLine.Help.Ansi, String...)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#execute-java.lang.String...-"><code>CommandLine.execute(String...)</code></a> and <a href="picocli/CommandLine.html#getExecutionResult--"><code>CommandLine.getExecutionResult()</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colOne"><a href="picocli/CommandLine.html#call-C-java.io.PrintStream-java.lang.String...-">picocli.CommandLine.call(C, PrintStream, String...)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#execute-java.lang.String...-"><code>CommandLine.execute(String...)</code></a> and <a href="picocli/CommandLine.html#getExecutionResult--"><code>CommandLine.getExecutionResult()</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colOne"><a href="picocli/CommandLine.html#call-C-java.lang.String...-">picocli.CommandLine.call(C, String...)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#execute-java.lang.String...-"><code>CommandLine.execute(String...)</code></a> and <a href="picocli/CommandLine.html#getExecutionResult--"><code>CommandLine.getExecutionResult()</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colOne"><a href="picocli/CommandLine.Help.TextTable.html#cellAt-int-int-">picocli.CommandLine.Help.TextTable.cellAt(int, int)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.Help.TextTable.html#textAt-int-int-"><code>CommandLine.Help.TextTable.textAt(int, int)</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colOne"><a href="picocli/CommandLine.Range.html#defaultArity-java.lang.Class-">picocli.CommandLine.Range.defaultArity(Class&lt;?&gt;)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.Range.html#defaultArity-java.lang.reflect.Field-"><code>CommandLine.Range.defaultArity(Field)</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colOne"><a href="picocli/CommandLine.Help.html#detailedSynopsis-java.util.Comparator-boolean-">picocli.CommandLine.Help.detailedSynopsis(Comparator&lt;CommandLine.Model.OptionSpec&gt;, boolean)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.Help.html#detailedSynopsis-int-java.util.Comparator-boolean-"><code>CommandLine.Help.detailedSynopsis(int, Comparator, boolean)</code></a> instead.</span></div>
 </td>
 </tr>
+<tr class="rowColor">
+<td class="colOne"><a href="picocli/CommandLine.Help.TextTable.html#forColumns-picocli.CommandLine.Help.Ansi-picocli.CommandLine.Help.Column...-">picocli.CommandLine.Help.TextTable.forColumns(CommandLine.Help.Ansi, CommandLine.Help.Column...)</a>
+<div class="block"><span class="deprecationComment">use <code>#forColumns(ColorScheme, Column...)</code> instead</span></div>
+</td>
+</tr>
 <tr class="altColor">
+<td class="colOne"><a href="picocli/CommandLine.Help.TextTable.html#forColumnWidths-picocli.CommandLine.Help.Ansi-int...-">picocli.CommandLine.Help.TextTable.forColumnWidths(CommandLine.Help.Ansi, int...)</a>
+<div class="block"><span class="deprecationComment">use <code>#forColumns(ColorScheme, Column...)</code> instead</span></div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colOne"><a href="picocli/CommandLine.Help.TextTable.html#forDefaultColumns-picocli.CommandLine.Help.Ansi-int-">picocli.CommandLine.Help.TextTable.forDefaultColumns(CommandLine.Help.Ansi, int)</a>
+<div class="block"><span class="deprecationComment">use <code>#forDefaultColumns(Ansi, int, int)</code> instead</span></div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colOne"><a href="picocli/CommandLine.Help.TextTable.html#forDefaultColumns-picocli.CommandLine.Help.Ansi-int-int-">picocli.CommandLine.Help.TextTable.forDefaultColumns(CommandLine.Help.Ansi, int, int)</a>
+<div class="block"><span class="deprecationComment">use <code>#forDefaultColumns(ColorScheme, int, int)</code> instead</span></div>
+</td>
+</tr>
+<tr class="rowColor">
 <td class="colOne"><a href="picocli/CommandLine.Model.OptionSpec.html#help--">picocli.CommandLine.Model.OptionSpec.help()</a>
 <div class="block"><span class="deprecationComment">Use <a href="picocli/CommandLine.Model.OptionSpec.html#usageHelp--"><code>CommandLine.Model.OptionSpec.usageHelp()</code></a> and <a href="picocli/CommandLine.Model.OptionSpec.html#versionHelp--"><code>CommandLine.Model.OptionSpec.versionHelp()</code></a> instead.</span></div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colOne"><a href="picocli/CommandLine.Model.OptionSpec.Builder.html#help--">picocli.CommandLine.Model.OptionSpec.Builder.help()</a>
 <div class="block"><span class="deprecationComment">Use <a href="picocli/CommandLine.Model.OptionSpec.Builder.html#usageHelp--"><code>CommandLine.Model.OptionSpec.Builder.usageHelp()</code></a> and <a href="picocli/CommandLine.Model.OptionSpec.Builder.html#versionHelp--"><code>CommandLine.Model.OptionSpec.Builder.versionHelp()</code></a> instead.</span></div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colOne"><a href="picocli/CommandLine.HelpCommand.html#init-picocli.CommandLine-picocli.CommandLine.Help.Ansi-java.io.PrintStream-java.io.PrintStream-">picocli.CommandLine.HelpCommand.init(CommandLine, CommandLine.Help.Ansi, PrintStream, PrintStream)</a></td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colOne"><a href="picocli/CommandLine.IHelpCommandInitializable.html#init-picocli.CommandLine-picocli.CommandLine.Help.Ansi-java.io.PrintStream-java.io.PrintStream-">picocli.CommandLine.IHelpCommandInitializable.init(CommandLine, CommandLine.Help.Ansi, PrintStream, PrintStream)</a></td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colOne"><a href="picocli/CommandLine.html#invoke-java.lang.String-java.lang.Class-java.io.PrintStream-picocli.CommandLine.Help.Ansi-java.lang.String...-">picocli.CommandLine.invoke(String, Class&lt;?&gt;, PrintStream, CommandLine.Help.Ansi, String...)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#execute-java.lang.String...-"><code>CommandLine.execute(String...)</code></a> and <a href="picocli/CommandLine.html#getExecutionResult--"><code>CommandLine.getExecutionResult()</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colOne"><a href="picocli/CommandLine.html#invoke-java.lang.String-java.lang.Class-java.io.PrintStream-java.io.PrintStream-picocli.CommandLine.Help.Ansi-java.lang.String...-">picocli.CommandLine.invoke(String, Class&lt;?&gt;, PrintStream, PrintStream, CommandLine.Help.Ansi, String...)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#execute-java.lang.String...-"><code>CommandLine.execute(String...)</code></a> and <a href="picocli/CommandLine.html#getExecutionResult--"><code>CommandLine.getExecutionResult()</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colOne"><a href="picocli/CommandLine.html#invoke-java.lang.String-java.lang.Class-java.io.PrintStream-java.lang.String...-">picocli.CommandLine.invoke(String, Class&lt;?&gt;, PrintStream, String...)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#execute-java.lang.String...-"><code>CommandLine.execute(String...)</code></a> and <a href="picocli/CommandLine.html#getExecutionResult--"><code>CommandLine.getExecutionResult()</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colOne"><a href="picocli/CommandLine.html#invoke-java.lang.String-java.lang.Class-java.lang.String...-">picocli.CommandLine.invoke(String, Class&lt;?&gt;, String...)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#execute-java.lang.String...-"><code>CommandLine.execute(String...)</code></a> and <a href="picocli/CommandLine.html#getExecutionResult--"><code>CommandLine.getExecutionResult()</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colOne"><a href="picocli/CommandLine.html#isSplitQuotedStrings--">picocli.CommandLine.isSplitQuotedStrings()</a>
 <div class="block"><span class="deprecationComment">Most applications should not change the default. The rare application that <em>does</em> need to split parameter values
  without respecting quotes should use <a href="picocli/CommandLine.Model.ParserSpec.html#splitQuotedStrings-boolean-"><code>CommandLine.Model.ParserSpec.splitQuotedStrings(boolean)</code></a>.</span></div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colOne"><a href="picocli/CommandLine.Help.html#join-picocli.CommandLine.Help.Ansi-int-java.lang.String:A-java.lang.StringBuilder-java.lang.Object...-">picocli.CommandLine.Help.join(CommandLine.Help.Ansi, int, String[], StringBuilder, Object...)</a>
 <div class="block"><span class="deprecationComment">Use <a href="picocli/CommandLine.Help.html#join-picocli.CommandLine.Help.Ansi-int-boolean-java.lang.String:A-java.lang.StringBuilder-java.lang.Object...-"><code>CommandLine.Help.join(Ansi, int, boolean, String[], StringBuilder, Object...)</code></a>  instead</span></div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colOne"><a href="picocli/CommandLine.html#parse-java.lang.String...-">picocli.CommandLine.parse(String...)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#parseArgs-java.lang.String...-"><code>CommandLine.parseArgs(String...)</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colOne"><a href="picocli/CommandLine.html#parseWithHandler-picocli.CommandLine.IParseResultHandler2-java.lang.String:A-">picocli.CommandLine.parseWithHandler(CommandLine.IParseResultHandler2&lt;R&gt;, String[])</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#execute-java.lang.String...-"><code>CommandLine.execute(String...)</code></a> and <a href="picocli/CommandLine.html#getExecutionResult--"><code>CommandLine.getExecutionResult()</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colOne"><a href="picocli/CommandLine.html#parseWithHandler-picocli.CommandLine.IParseResultHandler-java.io.PrintStream-java.lang.String...-">picocli.CommandLine.parseWithHandler(CommandLine.IParseResultHandler, PrintStream, String...)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#execute-java.lang.String...-"><code>CommandLine.execute(String...)</code></a> and <a href="picocli/CommandLine.html#getExecutionResult--"><code>CommandLine.getExecutionResult()</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colOne"><a href="picocli/CommandLine.html#parseWithHandlers-picocli.CommandLine.IParseResultHandler2-picocli.CommandLine.IExceptionHandler2-java.lang.String...-">picocli.CommandLine.parseWithHandlers(CommandLine.IParseResultHandler2&lt;R&gt;, CommandLine.IExceptionHandler2&lt;R&gt;, String...)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#execute-java.lang.String...-"><code>CommandLine.execute(String...)</code></a> and <a href="picocli/CommandLine.html#getExecutionResult--"><code>CommandLine.getExecutionResult()</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colOne"><a href="picocli/CommandLine.html#parseWithHandlers-picocli.CommandLine.IParseResultHandler-java.io.PrintStream-picocli.CommandLine.Help.Ansi-picocli.CommandLine.IExceptionHandler-java.lang.String...-">picocli.CommandLine.parseWithHandlers(CommandLine.IParseResultHandler, PrintStream, CommandLine.Help.Ansi, CommandLine.IExceptionHandler, String...)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#execute-java.lang.String...-"><code>CommandLine.execute(String...)</code></a> and <a href="picocli/CommandLine.html#getExecutionResult--"><code>CommandLine.getExecutionResult()</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colOne"><a href="picocli/CommandLine.html#printHelpIfRequested-java.util.List-java.io.PrintStream-picocli.CommandLine.Help.Ansi-">picocli.CommandLine.printHelpIfRequested(List&lt;CommandLine&gt;, PrintStream, CommandLine.Help.Ansi)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#printHelpIfRequested-picocli.CommandLine.ParseResult-"><code>CommandLine.printHelpIfRequested(ParseResult)</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colOne"><a href="picocli/CommandLine.html#printHelpIfRequested-java.util.List-java.io.PrintStream-java.io.PrintStream-picocli.CommandLine.Help.Ansi-">picocli.CommandLine.printHelpIfRequested(List&lt;CommandLine&gt;, PrintStream, PrintStream, CommandLine.Help.Ansi)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#executeHelpRequest-picocli.CommandLine.ParseResult-"><code>CommandLine.executeHelpRequest(ParseResult)</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colOne"><a href="picocli/CommandLine.html#printHelpIfRequested-java.util.List-java.io.PrintStream-java.io.PrintStream-picocli.CommandLine.Help.ColorScheme-">picocli.CommandLine.printHelpIfRequested(List&lt;CommandLine&gt;, PrintStream, PrintStream, CommandLine.Help.ColorScheme)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#executeHelpRequest-picocli.CommandLine.ParseResult-"><code>CommandLine.executeHelpRequest(ParseResult)</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colOne"><a href="picocli/CommandLine.Model.ArgSpec.html#renderedDescription--">picocli.CommandLine.Model.ArgSpec.renderedDescription()</a>
 <div class="block"><span class="deprecationComment">Use <a href="picocli/CommandLine.Model.ArgSpec.html#description--"><code>CommandLine.Model.ArgSpec.description()</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colOne"><a href="picocli/CommandLine.html#run-java.lang.Class-picocli.CommandLine.IFactory-java.io.PrintStream-picocli.CommandLine.Help.Ansi-java.lang.String...-">picocli.CommandLine.run(Class&lt;R&gt;, CommandLine.IFactory, PrintStream, CommandLine.Help.Ansi, String...)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#execute-java.lang.String...-"><code>CommandLine.execute(String...)</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colOne"><a href="picocli/CommandLine.html#run-java.lang.Class-picocli.CommandLine.IFactory-java.io.PrintStream-java.io.PrintStream-picocli.CommandLine.Help.Ansi-java.lang.String...-">picocli.CommandLine.run(Class&lt;R&gt;, CommandLine.IFactory, PrintStream, PrintStream, CommandLine.Help.Ansi, String...)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#execute-java.lang.String...-"><code>CommandLine.execute(String...)</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colOne"><a href="picocli/CommandLine.html#run-java.lang.Class-picocli.CommandLine.IFactory-java.io.PrintStream-java.lang.String...-">picocli.CommandLine.run(Class&lt;R&gt;, CommandLine.IFactory, PrintStream, String...)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#execute-java.lang.String...-"><code>CommandLine.execute(String...)</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colOne"><a href="picocli/CommandLine.html#run-java.lang.Class-picocli.CommandLine.IFactory-java.lang.String...-">picocli.CommandLine.run(Class&lt;R&gt;, CommandLine.IFactory, String...)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#execute-java.lang.String...-"><code>CommandLine.execute(String...)</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colOne"><a href="picocli/CommandLine.html#run-R-java.io.PrintStream-picocli.CommandLine.Help.Ansi-java.lang.String...-">picocli.CommandLine.run(R, PrintStream, CommandLine.Help.Ansi, String...)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#execute-java.lang.String...-"><code>CommandLine.execute(String...)</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colOne"><a href="picocli/CommandLine.html#run-R-java.io.PrintStream-java.io.PrintStream-picocli.CommandLine.Help.Ansi-java.lang.String...-">picocli.CommandLine.run(R, PrintStream, PrintStream, CommandLine.Help.Ansi, String...)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#execute-java.lang.String...-"><code>CommandLine.execute(String...)</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colOne"><a href="picocli/CommandLine.html#run-R-java.io.PrintStream-java.lang.String...-">picocli.CommandLine.run(R, PrintStream, String...)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#execute-java.lang.String...-"><code>CommandLine.execute(String...)</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colOne"><a href="picocli/CommandLine.html#run-R-java.lang.String...-">picocli.CommandLine.run(R, String...)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#execute-java.lang.String...-"><code>CommandLine.execute(String...)</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colOne"><a href="picocli/CommandLine.html#setSplitQuotedStrings-boolean-">picocli.CommandLine.setSplitQuotedStrings(boolean)</a>
 <div class="block"><span class="deprecationComment">Most applications should not change the default. The rare application that <em>does</em> need to split parameter values
  without respecting quotes should use <a href="picocli/CommandLine.Model.ParserSpec.html#splitQuotedStrings-boolean-"><code>CommandLine.Model.ParserSpec.splitQuotedStrings(boolean)</code></a>.</span></div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colOne"><a href="picocli/CommandLine.Model.ArgSpec.html#setValue-T-picocli.CommandLine-">picocli.CommandLine.Model.ArgSpec.setValue(T, CommandLine)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.Model.ArgSpec.html#setValue-T-"><code>CommandLine.Model.ArgSpec.setValue(Object)</code></a> instead. This was a design mistake.</span></div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colOne"><a href="picocli/CommandLine.Help.html#synopsis--">picocli.CommandLine.Help.synopsis()</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.Help.html#synopsis-int-"><code>CommandLine.Help.synopsis(int)</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colOne"><a href="picocli/CommandLine.AbstractHandler.html#useAnsi-picocli.CommandLine.Help.Ansi-">picocli.CommandLine.AbstractHandler.useAnsi(CommandLine.Help.Ansi)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#setColorScheme-picocli.CommandLine.Help.ColorScheme-"><code>CommandLine.setColorScheme(Help.ColorScheme)</code></a> and <a href="picocli/CommandLine.html#execute-java.lang.String...-"><code>CommandLine.execute(String...)</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colOne"><a href="picocli/CommandLine.AbstractHandler.html#useErr-java.io.PrintStream-">picocli.CommandLine.AbstractHandler.useErr(PrintStream)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#setErr-java.io.PrintWriter-"><code>CommandLine.setErr(PrintWriter)</code></a> and <a href="picocli/CommandLine.html#execute-java.lang.String...-"><code>CommandLine.execute(String...)</code></a> instead</span></div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colOne"><a href="picocli/CommandLine.AbstractHandler.html#useOut-java.io.PrintStream-">picocli.CommandLine.AbstractHandler.useOut(PrintStream)</a>
 <div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.html#setOut-java.io.PrintWriter-"><code>CommandLine.setOut(PrintWriter)</code></a> and <a href="picocli/CommandLine.html#execute-java.lang.String...-"><code>CommandLine.execute(String...)</code></a> instead</span></div>
 </td>
@@ -452,6 +477,11 @@
 <div class="block"><span class="deprecationComment">use <code>picocli.CommandLine.Help#Help(picocli.CommandLine.Model.CommandSpec, picocli.CommandLine.Help.ColorScheme)</code></span></div>
 </td>
 </tr>
+<tr class="rowColor">
+<td class="colOne"><a href="picocli/CommandLine.Help.TextTable.html#TextTable-picocli.CommandLine.Help.Ansi-picocli.CommandLine.Help.Column:A-">picocli.CommandLine.Help.TextTable(CommandLine.Help.Ansi, CommandLine.Help.Column[])</a>
+<div class="block"><span class="deprecationComment">use <code>TextTable#TextTable(ColorScheme, Column[])</code> instead</span></div>
+</td>
+</tr>
 </tbody>
 </table>
 </li>
diff --git a/docs/apidocs/help-doc.html b/docs/apidocs/help-doc.html
index 464fba25..4008e74b 100644
--- a/docs/apidocs/help-doc.html
+++ b/docs/apidocs/help-doc.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>API Help (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>API Help (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="API Help (picocli 4.1.4 API)";
+            parent.document.title="API Help (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/index-all.html b/docs/apidocs/index-all.html
index 129712d7..67b5eb25 100644
--- a/docs/apidocs/index-all.html
+++ b/docs/apidocs/index-all.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>Index (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>Index (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="Index (picocli 4.1.4 API)";
+            parent.document.title="Index (picocli 4.2.0 API)";
         }
     }
     catch(err) {
@@ -298,11 +298,17 @@
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.Ansi.Text.html#append-picocli.CommandLine.Help.Ansi.Text-">append(CommandLine.Help.Ansi.Text)</a></span> - Method in class picocli.<a href="picocli/CommandLine.Help.Ansi.Text.html" title="class in picocli">CommandLine.Help.Ansi.Text</a></dt>
 <dd>
 <div class="block"><span class="deprecatedLabel">Deprecated.</span>
-<div class="block"><span class="deprecationComment">use <code>#concat(Text)</code> instead</span></div>
+<div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.Help.Ansi.Text.html#concat-picocli.CommandLine.Help.Ansi.Text-"><code>CommandLine.Help.Ansi.Text.concat(CommandLine.Help.Ansi.Text)</code></a> instead</span></div>
 </div>
 </dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.Ansi.html#apply-java.lang.String-java.util.List-">apply(String, List&lt;CommandLine.Help.Ansi.IStyle&gt;)</a></span> - Method in enum picocli.<a href="picocli/CommandLine.Help.Ansi.html" title="enum in picocli">CommandLine.Help.Ansi</a></dt>
 <dd>
+<div class="block"><span class="deprecatedLabel">Deprecated.</span>
+<div class="block"><span class="deprecationComment">use <a href="picocli/CommandLine.Help.ColorScheme.html#apply-java.lang.String-java.util.List-"><code>CommandLine.Help.ColorScheme.apply(String, List)</code></a> instead</span></div>
+</div>
+</dd>
+<dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.ColorScheme.html#apply-java.lang.String-java.util.List-">apply(String, List&lt;CommandLine.Help.Ansi.IStyle&gt;)</a></span> - Method in class picocli.<a href="picocli/CommandLine.Help.ColorScheme.html" title="class in picocli">CommandLine.Help.ColorScheme</a></dt>
+<dd>
 <div class="block">Returns a new Text object where all the specified styles are applied to the full length of the
  specified plain text.</div>
 </dd>
@@ -342,10 +348,16 @@
 <dd>
 <div class="block">Returns this <code>ParseResult</code> as a list of <code>CommandLine</code> objects, one for each matched command/subcommand.</div>
 </dd>
+<dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.html#AT_FILE_POSITIONAL_PARAM">AT_FILE_POSITIONAL_PARAM</a></span> - Variable in class picocli.<a href="picocli/CommandLine.Help.html" title="class in picocli">CommandLine.Help</a></dt>
+<dd>&nbsp;</dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Model.ParserSpec.html#atFileCommentChar--">atFileCommentChar()</a></span> - Method in class picocli.<a href="picocli/CommandLine.Model.ParserSpec.html" title="class in picocli">CommandLine.Model.ParserSpec</a></dt>
 <dd>&nbsp;</dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Model.ParserSpec.html#atFileCommentChar-java.lang.Character-">atFileCommentChar(Character)</a></span> - Method in class picocli.<a href="picocli/CommandLine.Model.ParserSpec.html" title="class in picocli">CommandLine.Model.ParserSpec</a></dt>
 <dd>&nbsp;</dd>
+<dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.html#atFileParameterList--">atFileParameterList()</a></span> - Method in class picocli.<a href="picocli/CommandLine.Help.html" title="class in picocli">CommandLine.Help</a></dt>
+<dd>
+<div class="block">Returns the section of the usage help message that lists the @-file and its description.</div>
+</dd>
 <dt><a href="picocli/AutoComplete.html" title="class in picocli"><span class="typeNameLink">AutoComplete</span></a> - Class in <a href="picocli/package-summary.html">picocli</a></dt>
 <dd>
 <div class="block">Stand-alone tool that generates bash auto-complete scripts for picocli-based command line applications.</div>
@@ -1205,6 +1217,18 @@
 <dd>
 <div class="block">The Control Sequence Introducer (CSI) escape sequence "\u001b[".</div>
 </dd>
+<dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.ColorScheme.Builder.html#customMarkupMap--">customMarkupMap()</a></span> - Method in class picocli.<a href="picocli/CommandLine.Help.ColorScheme.Builder.html" title="class in picocli">CommandLine.Help.ColorScheme.Builder</a></dt>
+<dd>
+<div class="block">Returns the custom mapping from markup names (the names of the <a href="picocli/CommandLine.Help.Ansi.Style.html" title="enum in picocli"><code>CommandLine.Help.Ansi.Style</code></a> enum constants, like bold, italic, fg_blue, bg_green, etc) to <a href="picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli"><code>CommandLine.Help.Ansi.IStyle</code></a> objects in this color scheme.</div>
+</dd>
+<dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.ColorScheme.Builder.html#customMarkupMap-java.util.Map-">customMarkupMap(Map&lt;String, CommandLine.Help.Ansi.IStyle&gt;)</a></span> - Method in class picocli.<a href="picocli/CommandLine.Help.ColorScheme.Builder.html" title="class in picocli">CommandLine.Help.ColorScheme.Builder</a></dt>
+<dd>
+<div class="block">Sets the custom mapping from markup names (the names of the <a href="picocli/CommandLine.Help.Ansi.Style.html" title="enum in picocli"><code>CommandLine.Help.Ansi.Style</code></a> enum constants, like bold, italic, fg_blue, bg_green, etc) to <a href="picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli"><code>CommandLine.Help.Ansi.IStyle</code></a> objects in this color scheme.</div>
+</dd>
+<dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.ColorScheme.html#customMarkupMap--">customMarkupMap()</a></span> - Method in class picocli.<a href="picocli/CommandLine.Help.ColorScheme.html" title="class in picocli">CommandLine.Help.ColorScheme</a></dt>
+<dd>
+<div class="block">Returns the custom mapping from markup names (the names of the <a href="picocli/CommandLine.Help.Ansi.Style.html" title="enum in picocli"><code>CommandLine.Help.Ansi.Style</code></a> enum constants, like bold, italic, fg_blue, bg_green, etc) to <a href="picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli"><code>CommandLine.Help.Ansi.IStyle</code></a> objects in this color scheme.</div>
+</dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.html#customSynopsis-java.lang.Object...-">customSynopsis(Object...)</a></span> - Method in class picocli.<a href="picocli/CommandLine.Help.html" title="class in picocli">CommandLine.Help</a></dt>
 <dd>
 <div class="block">Returns command custom synopsis as a string.</div>
@@ -1609,26 +1633,39 @@
 </dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.TextTable.html#forColumns-picocli.CommandLine.Help.Ansi-picocli.CommandLine.Help.Column...-">forColumns(CommandLine.Help.Ansi, CommandLine.Help.Column...)</a></span> - Static method in class picocli.<a href="picocli/CommandLine.Help.TextTable.html" title="class in picocli">CommandLine.Help.TextTable</a></dt>
 <dd>
+<div class="block"><span class="deprecatedLabel">Deprecated.</span>
+<div class="block"><span class="deprecationComment">use <code>#forColumns(ColorScheme, Column...)</code> instead</span></div>
+</div>
+</dd>
+<dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.TextTable.html#forColumns-picocli.CommandLine.Help.ColorScheme-picocli.CommandLine.Help.Column...-">forColumns(CommandLine.Help.ColorScheme, CommandLine.Help.Column...)</a></span> - Static method in class picocli.<a href="picocli/CommandLine.Help.TextTable.html" title="class in picocli">CommandLine.Help.TextTable</a></dt>
+<dd>
 <div class="block">Constructs a <code>TextTable</code> with the specified columns.</div>
 </dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.TextTable.html#forColumnWidths-picocli.CommandLine.Help.Ansi-int...-">forColumnWidths(CommandLine.Help.Ansi, int...)</a></span> - Static method in class picocli.<a href="picocli/CommandLine.Help.TextTable.html" title="class in picocli">CommandLine.Help.TextTable</a></dt>
 <dd>
+<div class="block"><span class="deprecatedLabel">Deprecated.</span>
+<div class="block"><span class="deprecationComment">use <code>#forColumns(ColorScheme, Column...)</code> instead</span></div>
+</div>
+</dd>
+<dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.TextTable.html#forColumnWidths-picocli.CommandLine.Help.ColorScheme-int...-">forColumnWidths(CommandLine.Help.ColorScheme, int...)</a></span> - Static method in class picocli.<a href="picocli/CommandLine.Help.TextTable.html" title="class in picocli">CommandLine.Help.TextTable</a></dt>
+<dd>
 <div class="block">Constructs a new TextTable with columns with the specified width, all SPANning  multiple columns on
  overflow except the last column which WRAPS to the next row.</div>
 </dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.TextTable.html#forDefaultColumns-picocli.CommandLine.Help.Ansi-int-">forDefaultColumns(CommandLine.Help.Ansi, int)</a></span> - Static method in class picocli.<a href="picocli/CommandLine.Help.TextTable.html" title="class in picocli">CommandLine.Help.TextTable</a></dt>
 <dd>
-<div class="block">Constructs a TextTable with five columns as follows:
- 
- required option/parameter marker (width: 2, indent: 0, TRUNCATE on overflow)
- short option name (width: 2, indent: 0, TRUNCATE on overflow)
- comma separator (width: 1, indent: 0, TRUNCATE on overflow)
- long option name(s) (width: 24, indent: 1, SPAN multiple columns on overflow)
- description line(s) (width: 51, indent: 1, WRAP to next row on overflow)
- </div>
+<div class="block"><span class="deprecatedLabel">Deprecated.</span>
+<div class="block"><span class="deprecationComment">use <code>#forDefaultColumns(Ansi, int, int)</code> instead</span></div>
+</div>
 </dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.TextTable.html#forDefaultColumns-picocli.CommandLine.Help.Ansi-int-int-">forDefaultColumns(CommandLine.Help.Ansi, int, int)</a></span> - Static method in class picocli.<a href="picocli/CommandLine.Help.TextTable.html" title="class in picocli">CommandLine.Help.TextTable</a></dt>
 <dd>
+<div class="block"><span class="deprecatedLabel">Deprecated.</span>
+<div class="block"><span class="deprecationComment">use <code>#forDefaultColumns(ColorScheme, int, int)</code> instead</span></div>
+</div>
+</dd>
+<dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.TextTable.html#forDefaultColumns-picocli.CommandLine.Help.ColorScheme-int-int-">forDefaultColumns(CommandLine.Help.ColorScheme, int, int)</a></span> - Static method in class picocli.<a href="picocli/CommandLine.Help.TextTable.html" title="class in picocli">CommandLine.Help.TextTable</a></dt>
+<dd>
 <div class="block">Constructs a TextTable with five columns as follows:
  
  required option/parameter marker (width: 2, indent: 0, TRUNCATE on overflow)
@@ -1914,6 +1951,10 @@
 <dd>
 <div class="block">Returns the list of unmatched command line arguments, if any.</div>
 </dd>
+<dt><span class="memberNameLink"><a href="picocli/CommandLine.html#getUsageHelpLongOptionsMaxWidth--">getUsageHelpLongOptionsMaxWidth()</a></span> - Method in class picocli.<a href="picocli/CommandLine.html" title="class in picocli">CommandLine</a></dt>
+<dd>
+<div class="block">Returns the maximum usage help long options column max width to the specified value.</div>
+</dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.html#getUsageHelpWidth--">getUsageHelpWidth()</a></span> - Method in class picocli.<a href="picocli/CommandLine.html" title="class in picocli">CommandLine</a></dt>
 <dd>
 <div class="block">Returns the maximum width of the usage help message.</div>
@@ -2151,12 +2192,12 @@
 </dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.html#Help-java.lang.Object-">Help(Object)</a></span> - Constructor for class picocli.<a href="picocli/CommandLine.Help.html" title="class in picocli">CommandLine.Help</a></dt>
 <dd>
-<div class="block">Constructs a new <code>Help</code> instance with a default color scheme, initialized from annotatations
+<div class="block">Constructs a new <code>Help</code> instance with a default color scheme, initialized from annotations
  on the specified class and superclasses.</div>
 </dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.html#Help-java.lang.Object-picocli.CommandLine.Help.Ansi-">Help(Object, CommandLine.Help.Ansi)</a></span> - Constructor for class picocli.<a href="picocli/CommandLine.Help.html" title="class in picocli">CommandLine.Help</a></dt>
 <dd>
-<div class="block">Constructs a new <code>Help</code> instance with a default color scheme, initialized from annotatations
+<div class="block">Constructs a new <code>Help</code> instance with a default color scheme, initialized from annotations
  on the specified class and superclasses.</div>
 </dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.html#Help-java.lang.Object-picocli.CommandLine.Help.ColorScheme-">Help(Object, CommandLine.Help.ColorScheme)</a></span> - Constructor for class picocli.<a href="picocli/CommandLine.Help.html" title="class in picocli">CommandLine.Help</a></dt>
@@ -2167,7 +2208,7 @@
 </dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.html#Help-picocli.CommandLine.Model.CommandSpec-picocli.CommandLine.Help.ColorScheme-">Help(CommandLine.Model.CommandSpec, CommandLine.Help.ColorScheme)</a></span> - Constructor for class picocli.<a href="picocli/CommandLine.Help.html" title="class in picocli">CommandLine.Help</a></dt>
 <dd>
-<div class="block">Constructs a new <code>Help</code> instance with the specified color scheme, initialized from annotatations
+<div class="block">Constructs a new <code>Help</code> instance with the specified color scheme, initialized from annotations
  on the specified class and superclasses.</div>
 </dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Model.OptionSpec.Builder.html#help--">help()</a></span> - Method in class picocli.<a href="picocli/CommandLine.Model.OptionSpec.Builder.html" title="class in picocli">CommandLine.Model.OptionSpec.Builder</a></dt>
@@ -2572,6 +2613,14 @@
 <dd>
 <div class="block">Returns the longest <a href="picocli/CommandLine.Model.OptionSpec.html#names--">option name</a>.</div>
 </dd>
+<dt><span class="memberNameLink"><a href="picocli/CommandLine.Model.UsageMessageSpec.html#longOptionsMaxWidth-int-">longOptionsMaxWidth(int)</a></span> - Method in class picocli.<a href="picocli/CommandLine.Model.UsageMessageSpec.html" title="class in picocli">CommandLine.Model.UsageMessageSpec</a></dt>
+<dd>
+<div class="block">Sets the maximum usage help long options column max width to the specified value.</div>
+</dd>
+<dt><span class="memberNameLink"><a href="picocli/CommandLine.Model.UsageMessageSpec.html#longOptionsMaxWidth--">longOptionsMaxWidth()</a></span> - Method in class picocli.<a href="picocli/CommandLine.Model.UsageMessageSpec.html" title="class in picocli">CommandLine.Model.UsageMessageSpec</a></dt>
+<dd>
+<div class="block">Returns the maximum usage help long options column max width to the specified value.</div>
+</dd>
 </dl>
 <a name="I:M">
 <!--   -->
@@ -3081,6 +3130,10 @@
 <div class="block">Parses the specified comma-separated sequence of style descriptors and returns the associated
   styles.</div>
 </dd>
+<dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.ColorScheme.html#parse-java.lang.String-">parse(String)</a></span> - Method in class picocli.<a href="picocli/CommandLine.Help.ColorScheme.html" title="class in picocli">CommandLine.Help.ColorScheme</a></dt>
+<dd>
+<div class="block">Converts the specified markup styles to an array of <a href="picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli"><code>CommandLine.Help.Ansi.IStyle</code></a> objects.</div>
+</dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.html#parse-java.lang.String...-">parse(String...)</a></span> - Method in class picocli.<a href="picocli/CommandLine.html" title="class in picocli">CommandLine</a></dt>
 <dd>
 <div class="block"><span class="deprecatedLabel">Deprecated.</span>
@@ -3331,15 +3384,19 @@
 <dd>
 <div class="block">Sets the <code>stringValues</code> to a new list instance.</div>
 </dd>
+<dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.ColorScheme.html#resetStyle--">resetStyle()</a></span> - Method in class picocli.<a href="picocli/CommandLine.Help.ColorScheme.html" title="class in picocli">CommandLine.Help.ColorScheme</a></dt>
+<dd>
+<div class="block">Returns the style that "resets" the style state to neutral.</div>
+</dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Model.CommandSpec.html#resourceBundle--">resourceBundle()</a></span> - Method in class picocli.<a href="picocli/CommandLine.Model.CommandSpec.html" title="class in picocli">CommandLine.Model.CommandSpec</a></dt>
 <dd>
 <div class="block">Returns the resource bundle for this command.</div>
 </dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Model.CommandSpec.html#resourceBundle-java.util.ResourceBundle-">resourceBundle(ResourceBundle)</a></span> - Method in class picocli.<a href="picocli/CommandLine.Model.CommandSpec.html" title="class in picocli">CommandLine.Model.CommandSpec</a></dt>
 <dd>
-<div class="block">Initializes the resource bundle for this command: sets the <code>UsageMessageSpec.messages</code> to
+<div class="block">Initializes the resource bundle for this command: sets the <a href="picocli/CommandLine.Model.UsageMessageSpec.html#messages-picocli.CommandLine.Model.Messages-"><code>UsageMessageSpec.messages</code></a> to
  a <a href="picocli/CommandLine.Model.Messages.html" title="class in picocli"><code>Messages</code></a> object created from this command spec and the specified bundle, and then sets the
- <code>ArgSpec.messages</code> of all options and positional parameters in this command
+ <a href="picocli/CommandLine.Model.ArgSpec.html#messages-picocli.CommandLine.Model.Messages-"><code>ArgSpec.messages</code></a> of all options and positional parameters in this command
  to the same <code>Messages</code> instance.</div>
 </dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Model.Messages.html#resourceBundle-picocli.CommandLine.Model.Messages-">resourceBundle(CommandLine.Model.Messages)</a></span> - Static method in class picocli.<a href="picocli/CommandLine.Model.Messages.html" title="class in picocli">CommandLine.Model.Messages</a></dt>
@@ -3356,9 +3413,9 @@
 </dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Model.CommandSpec.html#resourceBundleBaseName-java.lang.String-">resourceBundleBaseName(String)</a></span> - Method in class picocli.<a href="picocli/CommandLine.Model.CommandSpec.html" title="class in picocli">CommandLine.Model.CommandSpec</a></dt>
 <dd>
-<div class="block">Initializes the resource bundle for this command: sets the <code>UsageMessageSpec.messages</code> to
+<div class="block">Initializes the resource bundle for this command: sets the <a href="picocli/CommandLine.Model.UsageMessageSpec.html#messages-picocli.CommandLine.Model.Messages-"><code>UsageMessageSpec.messages</code></a> to
  a <a href="picocli/CommandLine.Model.Messages.html" title="class in picocli"><code>Messages</code></a> object created from this command spec and the specified bundle, and then sets the
- <code>ArgSpec.messages</code> of all options and positional parameters in this command
+ <a href="picocli/CommandLine.Model.ArgSpec.html#messages-picocli.CommandLine.Model.Messages-"><code>ArgSpec.messages</code></a> of all options and positional parameters in this command
  to the same <code>Messages</code> instance.</div>
 </dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Model.Messages.html#resourceBundleBaseName-picocli.CommandLine.Model.Messages-">resourceBundleBaseName(CommandLine.Model.Messages)</a></span> - Static method in class picocli.<a href="picocli/CommandLine.Model.Messages.html" title="class in picocli">CommandLine.Model.Messages</a></dt>
@@ -3468,6 +3525,10 @@
 </dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Model.IAnnotatedElement.html#scope--">scope()</a></span> - Method in interface picocli.<a href="picocli/CommandLine.Model.IAnnotatedElement.html" title="interface in picocli">CommandLine.Model.IAnnotatedElement</a></dt>
 <dd>&nbsp;</dd>
+<dt><span class="memberNameLink"><a href="picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_AT_FILE_PARAMETER">SECTION_KEY_AT_FILE_PARAMETER</a></span> - Static variable in class picocli.<a href="picocli/CommandLine.Model.UsageMessageSpec.html" title="class in picocli">CommandLine.Model.UsageMessageSpec</a></dt>
+<dd>
+<div class="block"><a href="picocli/CommandLine.Model.UsageMessageSpec.html#sectionKeys--">Section key</a> to <a href="picocli/CommandLine.Model.UsageMessageSpec.html#sectionMap--">control</a> the <a href="picocli/CommandLine.IHelpSectionRenderer.html" title="interface in picocli">section renderer</a> for the @-file parameter list section.</div>
+</dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_COMMAND_LIST">SECTION_KEY_COMMAND_LIST</a></span> - Static variable in class picocli.<a href="picocli/CommandLine.Model.UsageMessageSpec.html" title="class in picocli">CommandLine.Model.UsageMessageSpec</a></dt>
 <dd>
 <div class="block"><a href="picocli/CommandLine.Model.UsageMessageSpec.html#sectionKeys--">Section key</a> to <a href="picocli/CommandLine.Model.UsageMessageSpec.html#sectionMap--">control</a> the <a href="picocli/CommandLine.IHelpSectionRenderer.html" title="interface in picocli">section renderer</a> for the Subcommand List section.</div>
@@ -3755,6 +3816,10 @@
 <div class="block">Sets whether picocli should attempt to detect the terminal size and adjust the usage help message width
  to take the full terminal width.</div>
 </dd>
+<dt><span class="memberNameLink"><a href="picocli/CommandLine.html#setUsageHelpLongOptionsMaxWidth-int-">setUsageHelpLongOptionsMaxWidth(int)</a></span> - Method in class picocli.<a href="picocli/CommandLine.html" title="class in picocli">CommandLine</a></dt>
+<dd>
+<div class="block">Returns the maximum usage help long options column max width to the specified value.</div>
+</dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.html#setUsageHelpWidth-int-">setUsageHelpWidth(int)</a></span> - Method in class picocli.<a href="picocli/CommandLine.html" title="class in picocli">CommandLine</a></dt>
 <dd>
 <div class="block">Sets the maximum width of the usage help message.</div>
@@ -3781,6 +3846,14 @@
 <dd>
 <div class="block">Returns the shortest <a href="picocli/CommandLine.Model.OptionSpec.html#names--">option name</a>.</div>
 </dd>
+<dt><span class="memberNameLink"><a href="picocli/CommandLine.Model.UsageMessageSpec.html#showAtFileInUsageHelp--">showAtFileInUsageHelp()</a></span> - Method in class picocli.<a href="picocli/CommandLine.Model.UsageMessageSpec.html" title="class in picocli">CommandLine.Model.UsageMessageSpec</a></dt>
+<dd>
+<div class="block">Sets whether to show a <code>[@&lt;filename&gt;...]</code> entry in the synopsis and parameter list of the usage help message.</div>
+</dd>
+<dt><span class="memberNameLink"><a href="picocli/CommandLine.Model.UsageMessageSpec.html#showAtFileInUsageHelp-boolean-">showAtFileInUsageHelp(boolean)</a></span> - Method in class picocli.<a href="picocli/CommandLine.Model.UsageMessageSpec.html" title="class in picocli">CommandLine.Model.UsageMessageSpec</a></dt>
+<dd>
+<div class="block">Sets whether to show a <code>[@&lt;filename&gt;...]</code> entry in the synopsis and parameter list of the usage help message.</div>
+</dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Model.ArgSpec.html#showDefaultValue--">showDefaultValue()</a></span> - Method in class picocli.<a href="picocli/CommandLine.Model.ArgSpec.html" title="class in picocli">CommandLine.Model.ArgSpec</a></dt>
 <dd>
 <div class="block">Returns whether this option or positional parameter's default value should be shown in the usage help.</div>
@@ -3833,6 +3906,12 @@
  <code>@|bg(red),white,underline some text|@</code> is converted to ANSI escape codes
  if this Ansi is ON, or suppressed if this Ansi is OFF.</div>
 </dd>
+<dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.ColorScheme.html#string-java.lang.String-">string(String)</a></span> - Method in class picocli.<a href="picocli/CommandLine.Help.ColorScheme.html" title="class in picocli">CommandLine.Help.ColorScheme</a></dt>
+<dd>
+<div class="block">Returns a String where any markup like
+ <code>@|bg(red),white,underline some text|@</code> is <a href="picocli/CommandLine.Help.ColorScheme.html#parse-java.lang.String-">converted</a> to the styles defined in this ColorScheme
+ (if its Ansi mode is ON), or to the plain text without the markup (if this ColorScheme's Ansi mode is OFF).</div>
+</dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Model.ArgSpec.html#stringValues--">stringValues()</a></span> - Method in class picocli.<a href="picocli/CommandLine.Model.ArgSpec.html" title="class in picocli">CommandLine.Model.ArgSpec</a></dt>
 <dd>
 <div class="block">Returns the untyped command line arguments matched by this option or positional parameter spec.</div>
@@ -3843,7 +3922,7 @@
 </dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.ParseResult.html#subcommand--">subcommand()</a></span> - Method in class picocli.<a href="picocli/CommandLine.ParseResult.html" title="class in picocli">CommandLine.ParseResult</a></dt>
 <dd>
-<div class="block">Returns the <code>ParseResult</code> for the subcommand of this command that was matched on the command line, or <code>null</code> if no subcommand was matched.</div>
+<div class="block">Returns the <code>ParseResult</code> for the last subcommand of this command that was matched on the command line, or <code>null</code> if no subcommand was matched.</div>
 </dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.html#subcommands--">subcommands()</a></span> - Method in class picocli.<a href="picocli/CommandLine.Help.html" title="class in picocli">CommandLine.Help</a></dt>
 <dd>
@@ -3853,6 +3932,21 @@
 <dd>
 <div class="block">Returns a read-only view of the subcommand map.</div>
 </dd>
+<dt><span class="memberNameLink"><a href="picocli/CommandLine.ParseResult.html#subcommands--">subcommands()</a></span> - Method in class picocli.<a href="picocli/CommandLine.ParseResult.html" title="class in picocli">CommandLine.ParseResult</a></dt>
+<dd>
+<div class="block">Returns a list with the <code>ParseResult</code> objects for each subcommand of this command
+ that was matched on the command line or an empty list if no subcommands were matched.</div>
+</dd>
+<dt><span class="memberNameLink"><a href="picocli/CommandLine.Model.CommandSpec.html#subcommandsRepeatable--">subcommandsRepeatable()</a></span> - Method in class picocli.<a href="picocli/CommandLine.Model.CommandSpec.html" title="class in picocli">CommandLine.Model.CommandSpec</a></dt>
+<dd>
+<div class="block">Returns whether the subcommands of this command are repeatable, that is, whether such subcommands can
+ occur multiple times and may be followed by sibling commands instead of just child commands.</div>
+</dd>
+<dt><span class="memberNameLink"><a href="picocli/CommandLine.Model.CommandSpec.html#subcommandsRepeatable-boolean-">subcommandsRepeatable(boolean)</a></span> - Method in class picocli.<a href="picocli/CommandLine.Model.CommandSpec.html" title="class in picocli">CommandLine.Model.CommandSpec</a></dt>
+<dd>
+<div class="block">Sets whether the subcommands of this command are repeatable, that is, whether such subcommands can
+ occur multiple times and may be followed by sibling commands instead of just child commands.</div>
+</dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Model.ArgGroupSpec.Builder.html#subgroups--">subgroups()</a></span> - Method in class picocli.<a href="picocli/CommandLine.Model.ArgGroupSpec.Builder.html" title="class in picocli">CommandLine.Model.ArgGroupSpec.Builder</a></dt>
 <dd>
 <div class="block">Returns the list of subgroups that this group is composed of.</div>
@@ -3948,6 +4042,10 @@
 <dd>
 <div class="block">Constructs a Text with the specified max length (for use in a TextTable Column).</div>
 </dd>
+<dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.Ansi.Text.html#Text-int-picocli.CommandLine.Help.ColorScheme-">Text(int, CommandLine.Help.ColorScheme)</a></span> - Constructor for class picocli.<a href="picocli/CommandLine.Help.Ansi.Text.html" title="class in picocli">CommandLine.Help.Ansi.Text</a></dt>
+<dd>
+<div class="block">Constructs a Text with the specified max length (for use in a TextTable Column).</div>
+</dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.Ansi.Text.html#Text-picocli.CommandLine.Help.Ansi.Text-">Text(CommandLine.Help.Ansi.Text)</a></span> - Constructor for class picocli.<a href="picocli/CommandLine.Help.Ansi.Text.html" title="class in picocli">CommandLine.Help.Ansi.Text</a></dt>
 <dd>
 <div class="block">Copy constructor.</div>
@@ -3957,11 +4055,26 @@
 <div class="block">Constructs a Text with the specified String, which may contain markup like
  <code>@|bg(red),white,underline some text|@</code>.</div>
 </dd>
+<dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.Ansi.Text.html#Text-java.lang.String-picocli.CommandLine.Help.ColorScheme-">Text(String, CommandLine.Help.ColorScheme)</a></span> - Constructor for class picocli.<a href="picocli/CommandLine.Help.Ansi.Text.html" title="class in picocli">CommandLine.Help.Ansi.Text</a></dt>
+<dd>
+<div class="block">Constructs a Text with the specified String (which may contain markup), and ColorScheme.</div>
+</dd>
+<dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.ColorScheme.html#text-java.lang.String-">text(String)</a></span> - Method in class picocli.<a href="picocli/CommandLine.Help.ColorScheme.html" title="class in picocli">CommandLine.Help.ColorScheme</a></dt>
+<dd>
+<div class="block">Returns a new Text object for this ColorScheme, encapsulating the specified string
+ which may contain markup like <code>@|bg(red),white,underline some text|@</code>.</div>
+</dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.TextTable.html#textAt-int-int-">textAt(int, int)</a></span> - Method in class picocli.<a href="picocli/CommandLine.Help.TextTable.html" title="class in picocli">CommandLine.Help.TextTable</a></dt>
 <dd>
 <div class="block">Returns the <code>Text</code> slot at the specified row and column to write a text value into.</div>
 </dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.TextTable.html#TextTable-picocli.CommandLine.Help.Ansi-picocli.CommandLine.Help.Column:A-">TextTable(CommandLine.Help.Ansi, CommandLine.Help.Column[])</a></span> - Constructor for class picocli.<a href="picocli/CommandLine.Help.TextTable.html" title="class in picocli">CommandLine.Help.TextTable</a></dt>
+<dd>
+<div class="block"><span class="deprecatedLabel">Deprecated.</span>
+<div class="block"><span class="deprecationComment">use <code>TextTable#TextTable(ColorScheme, Column[])</code> instead</span></div>
+</div>
+</dd>
+<dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.TextTable.html#TextTable-picocli.CommandLine.Help.ColorScheme-picocli.CommandLine.Help.Column:A-">TextTable(CommandLine.Help.ColorScheme, CommandLine.Help.Column[])</a></span> - Constructor for class picocli.<a href="picocli/CommandLine.Help.TextTable.html" title="class in picocli">CommandLine.Help.TextTable</a></dt>
 <dd>&nbsp;</dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.AbstractHandler.html#throwOrExit-picocli.CommandLine.ExecutionException-">throwOrExit(CommandLine.ExecutionException)</a></span> - Method in class picocli.<a href="picocli/CommandLine.AbstractHandler.html" title="class in picocli">CommandLine.AbstractHandler</a></dt>
 <dd>
@@ -3988,6 +4101,8 @@
 <div class="block">Returns a String representation of the text with ANSI escape codes embedded, unless ANSI is
  <a href="picocli/CommandLine.Help.Ansi.html#enabled--">CommandLine.Help.Ansi.enabled()</a> not enabled}, in which case the plain text is returned.</div>
 </dd>
+<dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.ColorScheme.html#toString--">toString()</a></span> - Method in class picocli.<a href="picocli/CommandLine.Help.ColorScheme.html" title="class in picocli">CommandLine.Help.ColorScheme</a></dt>
+<dd>&nbsp;</dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Help.Layout.html#toString--">toString()</a></span> - Method in class picocli.<a href="picocli/CommandLine.Help.Layout.html" title="class in picocli">CommandLine.Help.Layout</a></dt>
 <dd>
 <div class="block">Returns the section of the usage help message accumulated in the TextTable owned by this layout.</div>
@@ -4271,7 +4386,7 @@ the order they are declared.</div>
 </dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.html#VERSION">VERSION</a></span> - Static variable in class picocli.<a href="picocli/CommandLine.html" title="class in picocli">CommandLine</a></dt>
 <dd>
-<div class="block">This is picocli version "4.1.4".</div>
+<div class="block">This is picocli version "4.2.0".</div>
 </dd>
 <dt><span class="memberNameLink"><a href="picocli/CommandLine.Model.OptionSpec.Builder.html#versionHelp--">versionHelp()</a></span> - Method in class picocli.<a href="picocli/CommandLine.Model.OptionSpec.Builder.html" title="class in picocli">CommandLine.Model.OptionSpec.Builder</a></dt>
 <dd>
@@ -4319,6 +4434,10 @@ the order they are declared.</div>
 <dd>
 <div class="block">Creates and returns a new <code>CommandSpec</code> with the specified associated user object.</div>
 </dd>
+<dt><span class="memberNameLink"><a href="picocli/CommandLine.Model.CommandSpec.html#wrapWithoutInspection-java.lang.Object-picocli.CommandLine.IFactory-">wrapWithoutInspection(Object, CommandLine.IFactory)</a></span> - Static method in class picocli.<a href="picocli/CommandLine.Model.CommandSpec.html" title="class in picocli">CommandLine.Model.CommandSpec</a></dt>
+<dd>
+<div class="block">Creates and returns a new <code>CommandSpec</code> with the specified associated user object.</div>
+</dd>
 </dl>
 <a href="#I:A">A</a>&nbsp;<a href="#I:B">B</a>&nbsp;<a href="#I:C">C</a>&nbsp;<a href="#I:D">D</a>&nbsp;<a href="#I:E">E</a>&nbsp;<a href="#I:F">F</a>&nbsp;<a href="#I:G">G</a>&nbsp;<a href="#I:H">H</a>&nbsp;<a href="#I:I">I</a>&nbsp;<a href="#I:J">J</a>&nbsp;<a href="#I:K">K</a>&nbsp;<a href="#I:L">L</a>&nbsp;<a href="#I:M">M</a>&nbsp;<a href="#I:N">N</a>&nbsp;<a href="#I:O">O</a>&nbsp;<a href="#I:P">P</a>&nbsp;<a href="#I:Q">Q</a>&nbsp;<a href="#I:R">R</a>&nbsp;<a href="#I:S">S</a>&nbsp;<a href="#I:T">T</a>&nbsp;<a href="#I:U">U</a>&nbsp;<a href="#I:V">V</a>&nbsp;<a href="#I:W">W</a>&nbsp;</div>
 <!-- ======= START OF BOTTOM NAVBAR ====== -->
diff --git a/docs/apidocs/index.html b/docs/apidocs/index.html
index abd8c59c..7e0ac2dc 100644
--- a/docs/apidocs/index.html
+++ b/docs/apidocs/index.html
@@ -2,8 +2,8 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>picocli 4.1.4 API</title>
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>picocli 4.2.0 API</title>
 <script type="text/javascript">
     tmpTargetPage = "" + window.location.search;
     if (tmpTargetPage != "" && tmpTargetPage != "undefined")
diff --git a/docs/apidocs/overview-summary.html b/docs/apidocs/overview-summary.html
index 9fbf8da6..a5af0918 100644
--- a/docs/apidocs/overview-summary.html
+++ b/docs/apidocs/overview-summary.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>Overview (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>Overview (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="Overview (picocli 4.1.4 API)";
+            parent.document.title="Overview (picocli 4.2.0 API)";
         }
     }
     catch(err) {
@@ -69,7 +69,7 @@
 </a></div>
 <!-- ========= END OF TOP NAVBAR ========= -->
 <div class="header">
-<h1 class="title">picocli 4.1.4 API</h1>
+<h1 class="title">picocli 4.2.0 API</h1>
 </div>
 <div class="header">
 <div class="subTitle">
diff --git a/docs/apidocs/overview-tree.html b/docs/apidocs/overview-tree.html
index 10b349bf..9883287d 100644
--- a/docs/apidocs/overview-tree.html
+++ b/docs/apidocs/overview-tree.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>Class Hierarchy (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>Class Hierarchy (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="Class Hierarchy (picocli 4.1.4 API)";
+            parent.document.title="Class Hierarchy (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/AutoComplete.GenerateCompletion.html b/docs/apidocs/picocli/AutoComplete.GenerateCompletion.html
index e01866ee..46e90a7c 100644
--- a/docs/apidocs/picocli/AutoComplete.GenerateCompletion.html
+++ b/docs/apidocs/picocli/AutoComplete.GenerateCompletion.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:42 JST 2019 -->
-<title>AutoComplete.GenerateCompletion (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:49 JST 2020 -->
+<title>AutoComplete.GenerateCompletion (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="AutoComplete.GenerateCompletion (picocli 4.1.4 API)";
+            parent.document.title="AutoComplete.GenerateCompletion (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/AutoComplete.html b/docs/apidocs/picocli/AutoComplete.html
index dc3db2cd..80f18e31 100644
--- a/docs/apidocs/picocli/AutoComplete.html
+++ b/docs/apidocs/picocli/AutoComplete.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:42 JST 2019 -->
-<title>AutoComplete (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:49 JST 2020 -->
+<title>AutoComplete (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="AutoComplete (picocli 4.1.4 API)";
+            parent.document.title="AutoComplete (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.AbstractHandler.html b/docs/apidocs/picocli/CommandLine.AbstractHandler.html
index a8468d4e..65c33722 100644
--- a/docs/apidocs/picocli/CommandLine.AbstractHandler.html
+++ b/docs/apidocs/picocli/CommandLine.AbstractHandler.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.AbstractHandler (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:49 JST 2020 -->
+<title>CommandLine.AbstractHandler (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.AbstractHandler (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.AbstractHandler (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.AbstractParseResultHandler.html b/docs/apidocs/picocli/CommandLine.AbstractParseResultHandler.html
index 5b29069a..7765f30f 100644
--- a/docs/apidocs/picocli/CommandLine.AbstractParseResultHandler.html
+++ b/docs/apidocs/picocli/CommandLine.AbstractParseResultHandler.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.AbstractParseResultHandler (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:49 JST 2020 -->
+<title>CommandLine.AbstractParseResultHandler (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.AbstractParseResultHandler (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.AbstractParseResultHandler (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.ArgGroup.html b/docs/apidocs/picocli/CommandLine.ArgGroup.html
index fa5654cc..2d3a46e2 100644
--- a/docs/apidocs/picocli/CommandLine.ArgGroup.html
+++ b/docs/apidocs/picocli/CommandLine.ArgGroup.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.ArgGroup (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:49 JST 2020 -->
+<title>CommandLine.ArgGroup (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.ArgGroup (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.ArgGroup (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Command.html b/docs/apidocs/picocli/CommandLine.Command.html
index 49d2a810..aac5a7a7 100644
--- a/docs/apidocs/picocli/CommandLine.Command.html
+++ b/docs/apidocs/picocli/CommandLine.Command.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.Command (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:49 JST 2020 -->
+<title>CommandLine.Command (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Command (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Command (picocli 4.2.0 API)";
         }
     }
     catch(err) {
@@ -322,23 +322,37 @@ public static @interface <span class="memberNameLabel">CommandLine.Command</span
 </tr>
 <tr class="altColor">
 <td class="colFirst"><code>boolean</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Command.html#showAtFileInUsageHelp--">showAtFileInUsageHelp</a></span></code>
+<div class="block">Specify <code>true</code> to show a <code>[@&lt;filename&gt;...]</code> entry
+ in the synopsis and parameter list of the usage help message.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Command.html#showDefaultValues--">showDefaultValues</a></span></code>
 <div class="block">Specify <code>true</code> to show default values in the description column of the options list (except for
  boolean options).</div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Command.html#sortOptions--">sortOptions</a></span></code>
 <div class="block">Specify <code>false</code> to show Options in declaration order.</div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a>&lt;?&gt;[]</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Command.html#subcommands--">subcommands</a></span></code>
 <div class="block">A list of classes to instantiate and register as subcommands.</div>
 </td>
 </tr>
+<tr class="altColor">
+<td class="colFirst"><code>boolean</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Command.html#subcommandsRepeatable--">subcommandsRepeatable</a></span></code>
+<div class="block">Returns whether the subcommands of this command are repeatable, that is, whether such subcommands can
+ occur multiple times and may be followed by sibling commands instead of only by child commands of the subcommand.</div>
+</td>
+</tr>
 <tr class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Command.html#synopsisHeading--">synopsisHeading</a></span></code>
@@ -492,6 +506,28 @@ public static @interface <span class="memberNameLabel">CommandLine.Command</span
 </li>
 </ul>
 <ul class="blockList">
+<li class="blockList"><a name="subcommandsRepeatable--">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>subcommandsRepeatable</h4>
+<pre>public abstract&nbsp;boolean&nbsp;subcommandsRepeatable</pre>
+<div class="block">Returns whether the subcommands of this command are repeatable, that is, whether such subcommands can
+ occur multiple times and may be followed by sibling commands instead of only by child commands of the subcommand.</div>
+<dl>
+<dt><span class="simpleTagLabel">Since:</span></dt>
+<dd>4.2</dd>
+</dl>
+<dl>
+<dt>Default:</dt>
+<dd>false</dd>
+</dl>
+</li>
+</ul>
+</li>
+</ul>
+<ul class="blockList">
 <li class="blockList"><a name="addMethodSubcommands--">
 <!--   -->
 </a>
@@ -1012,6 +1048,29 @@ public static @interface <span class="memberNameLabel">CommandLine.Command</span
 </li>
 </ul>
 <ul class="blockList">
+<li class="blockList"><a name="showAtFileInUsageHelp--">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>showAtFileInUsageHelp</h4>
+<pre>public abstract&nbsp;boolean&nbsp;showAtFileInUsageHelp</pre>
+<div class="block">Specify <code>true</code> to show a <code>[@&lt;filename&gt;...]</code> entry
+ in the synopsis and parameter list of the usage help message.
+ (The entry is not shown if <a href="../picocli/CommandLine.html#isExpandAtFiles--">expanding parameter files</a> is disabled.)</div>
+<dl>
+<dt><span class="simpleTagLabel">Since:</span></dt>
+<dd>4.2</dd>
+</dl>
+<dl>
+<dt>Default:</dt>
+<dd>false</dd>
+</dl>
+</li>
+</ul>
+</li>
+</ul>
+<ul class="blockList">
 <li class="blockList"><a name="commandListHeading--">
 <!--   -->
 </a>
diff --git a/docs/apidocs/picocli/CommandLine.DefaultExceptionHandler.html b/docs/apidocs/picocli/CommandLine.DefaultExceptionHandler.html
index bfc04dbf..81c981e7 100644
--- a/docs/apidocs/picocli/CommandLine.DefaultExceptionHandler.html
+++ b/docs/apidocs/picocli/CommandLine.DefaultExceptionHandler.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.DefaultExceptionHandler (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:49 JST 2020 -->
+<title>CommandLine.DefaultExceptionHandler (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.DefaultExceptionHandler (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.DefaultExceptionHandler (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.DuplicateNameException.html b/docs/apidocs/picocli/CommandLine.DuplicateNameException.html
index 49c31e82..5397294f 100644
--- a/docs/apidocs/picocli/CommandLine.DuplicateNameException.html
+++ b/docs/apidocs/picocli/CommandLine.DuplicateNameException.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.DuplicateNameException (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.DuplicateNameException (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.DuplicateNameException (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.DuplicateNameException (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.DuplicateOptionAnnotationsException.html b/docs/apidocs/picocli/CommandLine.DuplicateOptionAnnotationsException.html
index b10a7a1a..b3b05dfe 100644
--- a/docs/apidocs/picocli/CommandLine.DuplicateOptionAnnotationsException.html
+++ b/docs/apidocs/picocli/CommandLine.DuplicateOptionAnnotationsException.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.DuplicateOptionAnnotationsException (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.DuplicateOptionAnnotationsException (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.DuplicateOptionAnnotationsException (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.DuplicateOptionAnnotationsException (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.ExecutionException.html b/docs/apidocs/picocli/CommandLine.ExecutionException.html
index 5fb3d209..1286806f 100644
--- a/docs/apidocs/picocli/CommandLine.ExecutionException.html
+++ b/docs/apidocs/picocli/CommandLine.ExecutionException.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.ExecutionException (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.ExecutionException (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.ExecutionException (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.ExecutionException (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.ExitCode.html b/docs/apidocs/picocli/CommandLine.ExitCode.html
index 6f00fb77..fc9152ad 100644
--- a/docs/apidocs/picocli/CommandLine.ExitCode.html
+++ b/docs/apidocs/picocli/CommandLine.ExitCode.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.ExitCode (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.ExitCode (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.ExitCode (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.ExitCode (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Help.Ansi.IStyle.html b/docs/apidocs/picocli/CommandLine.Help.Ansi.IStyle.html
index b691d497..5e970569 100644
--- a/docs/apidocs/picocli/CommandLine.Help.Ansi.IStyle.html
+++ b/docs/apidocs/picocli/CommandLine.Help.Ansi.IStyle.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.Help.Ansi.IStyle (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Help.Ansi.IStyle (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Help.Ansi.IStyle (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Help.Ansi.IStyle (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Help.Ansi.Style.html b/docs/apidocs/picocli/CommandLine.Help.Ansi.Style.html
index 6d8fb547..6b61be5e 100644
--- a/docs/apidocs/picocli/CommandLine.Help.Ansi.Style.html
+++ b/docs/apidocs/picocli/CommandLine.Help.Ansi.Style.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.Help.Ansi.Style (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Help.Ansi.Style (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Help.Ansi.Style (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Help.Ansi.Style (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Help.Ansi.Text.html b/docs/apidocs/picocli/CommandLine.Help.Ansi.Text.html
index 3b219a4f..835cf008 100644
--- a/docs/apidocs/picocli/CommandLine.Help.Ansi.Text.html
+++ b/docs/apidocs/picocli/CommandLine.Help.Ansi.Text.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.Help.Ansi.Text (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Help.Ansi.Text (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Help.Ansi.Text (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Help.Ansi.Text (picocli 4.2.0 API)";
         }
     }
     catch(err) {
@@ -153,11 +153,23 @@ implements <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Cloneabl
 </td>
 </tr>
 <tr class="altColor">
+<td class="colOne"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.Ansi.Text.html#Text-int-picocli.CommandLine.Help.ColorScheme-">Text</a></span>(int&nbsp;maxLength,
+    <a href="../picocli/CommandLine.Help.ColorScheme.html" title="class in picocli">CommandLine.Help.ColorScheme</a>&nbsp;colorScheme)</code>
+<div class="block">Constructs a Text with the specified max length (for use in a TextTable Column).</div>
+</td>
+</tr>
+<tr class="rowColor">
 <td class="colOne"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.Ansi.Text.html#Text-java.lang.String-">Text</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;input)</code>
 <div class="block">Constructs a Text with the specified String, which may contain markup like
  <code>@|bg(red),white,underline some text|@</code>.</div>
 </td>
 </tr>
+<tr class="altColor">
+<td class="colOne"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.Ansi.Text.html#Text-java.lang.String-picocli.CommandLine.Help.ColorScheme-">Text</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;input,
+    <a href="../picocli/CommandLine.Help.ColorScheme.html" title="class in picocli">CommandLine.Help.ColorScheme</a>&nbsp;colorScheme)</code>
+<div class="block">Constructs a Text with the specified String (which may contain markup), and ColorScheme.</div>
+</td>
+</tr>
 </table>
 </li>
 </ul>
@@ -177,7 +189,7 @@ implements <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Cloneabl
 <td class="colFirst"><code><a href="../picocli/CommandLine.Help.Ansi.Text.html" title="class in picocli">CommandLine.Help.Ansi.Text</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.Ansi.Text.html#append-picocli.CommandLine.Help.Ansi.Text-">append</a></span>(<a href="../picocli/CommandLine.Help.Ansi.Text.html" title="class in picocli">CommandLine.Help.Ansi.Text</a>&nbsp;text)</code>
 <div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;
-<div class="block"><span class="deprecationComment">use <code>#concat(Text)</code> instead</span></div>
+<div class="block"><span class="deprecationComment">use <a href="../picocli/CommandLine.Help.Ansi.Text.html#concat-picocli.CommandLine.Help.Ansi.Text-"><code>concat(CommandLine.Help.Ansi.Text)</code></a> instead</span></div>
 </div>
 </td>
 </tr>
@@ -301,6 +313,24 @@ implements <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Cloneabl
 </dl>
 </li>
 </ul>
+<a name="Text-int-picocli.CommandLine.Help.ColorScheme-">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>Text</h4>
+<pre>public&nbsp;Text(int&nbsp;maxLength,
+            <a href="../picocli/CommandLine.Help.ColorScheme.html" title="class in picocli">CommandLine.Help.ColorScheme</a>&nbsp;colorScheme)</pre>
+<div class="block">Constructs a Text with the specified max length (for use in a TextTable Column).</div>
+<dl>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>maxLength</code> - max length of this text</dd>
+<dd><code>colorScheme</code> - the colorScheme to use</dd>
+<dt><span class="simpleTagLabel">Since:</span></dt>
+<dd>4.2</dd>
+</dl>
+</li>
+</ul>
 <a name="Text-picocli.CommandLine.Help.Ansi.Text-">
 <!--   -->
 </a>
@@ -318,7 +348,7 @@ implements <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Cloneabl
 <a name="Text-java.lang.String-">
 <!--   -->
 </a>
-<ul class="blockListLast">
+<ul class="blockList">
 <li class="blockList">
 <h4>Text</h4>
 <pre>public&nbsp;Text(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;input)</pre>
@@ -330,6 +360,24 @@ implements <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Cloneabl
 </dl>
 </li>
 </ul>
+<a name="Text-java.lang.String-picocli.CommandLine.Help.ColorScheme-">
+<!--   -->
+</a>
+<ul class="blockListLast">
+<li class="blockList">
+<h4>Text</h4>
+<pre>public&nbsp;Text(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;input,
+            <a href="../picocli/CommandLine.Help.ColorScheme.html" title="class in picocli">CommandLine.Help.ColorScheme</a>&nbsp;colorScheme)</pre>
+<div class="block">Constructs a Text with the specified String (which may contain markup), and ColorScheme.</div>
+<dl>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>input</code> - the string with markup like <code>@|bg(red),white,underline some text|@</code> to parse</dd>
+<dd><code>colorScheme</code> - the ColorScheme to use to map markup to replacement strings</dd>
+<dt><span class="simpleTagLabel">Since:</span></dt>
+<dd>4.2</dd>
+</dl>
+</li>
+</ul>
 </li>
 </ul>
 <!-- ============ METHOD DETAIL ========== -->
@@ -413,7 +461,7 @@ public&nbsp;<a href="../picocli/CommandLine.Help.Ansi.Text.html" title="class in
 <h4>append</h4>
 <pre><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Deprecated.html?is-external=true" title="class or interface in java.lang">@Deprecated</a>
 public&nbsp;<a href="../picocli/CommandLine.Help.Ansi.Text.html" title="class in picocli">CommandLine.Help.Ansi.Text</a>&nbsp;append(<a href="../picocli/CommandLine.Help.Ansi.Text.html" title="class in picocli">CommandLine.Help.Ansi.Text</a>&nbsp;text)</pre>
-<div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;<span class="deprecationComment">use <code>#concat(Text)</code> instead</span></div>
+<div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;<span class="deprecationComment">use <a href="../picocli/CommandLine.Help.Ansi.Text.html#concat-picocli.CommandLine.Help.Ansi.Text-"><code>concat(CommandLine.Help.Ansi.Text)</code></a> instead</span></div>
 </li>
 </ul>
 <a name="concat-java.lang.String-">
diff --git a/docs/apidocs/picocli/CommandLine.Help.Ansi.html b/docs/apidocs/picocli/CommandLine.Help.Ansi.html
index a564877b..3162fcf6 100644
--- a/docs/apidocs/picocli/CommandLine.Help.Ansi.html
+++ b/docs/apidocs/picocli/CommandLine.Help.Ansi.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.Help.Ansi (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Help.Ansi (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,14 +12,14 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Help.Ansi (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Help.Ansi (picocli 4.2.0 API)";
         }
     }
     catch(err) {
     }
 //-->
-var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":9,"i5":9,"i6":9};
-var tabs = {65535:["t0","All Methods"],1:["t1","Static Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]};
+var methods = {"i0":42,"i1":10,"i2":10,"i3":10,"i4":9,"i5":9,"i6":9};
+var tabs = {65535:["t0","All Methods"],1:["t1","Static Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"],32:["t6","Deprecated Methods"]};
 var altColor = "altColor";
 var rowColor = "rowColor";
 var tableTab = "tableTab";
@@ -202,7 +202,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Enum.html?i
 </a>
 <h3>Method Summary</h3>
 <table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
-<caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd">&nbsp;</span></span><span id="t1" class="tableTab"><span><a href="javascript:show(1);">Static Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t4" class="tableTab"><span><a href="javascript:show(8);">Concrete Methods</a></span><span class="tabEnd">&nbsp;</span></span></caption>
+<caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd">&nbsp;</span></span><span id="t1" class="tableTab"><span><a href="javascript:show(1);">Static Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t4" class="tableTab"><span><a href="javascript:show(8);">Concrete Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t6" class="tableTab"><span><a href="javascript:show(32);">Deprecated Methods</a></span><span class="tabEnd">&nbsp;</span></span></caption>
 <tr>
 <th class="colFirst" scope="col">Modifier and Type</th>
 <th class="colLast" scope="col">Method and Description</th>
@@ -211,8 +211,9 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Enum.html?i
 <td class="colFirst"><code><a href="../picocli/CommandLine.Help.Ansi.Text.html" title="class in picocli">CommandLine.Help.Ansi.Text</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.Ansi.html#apply-java.lang.String-java.util.List-">apply</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;plainText,
      <a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;<a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli">CommandLine.Help.Ansi.IStyle</a>&gt;&nbsp;styles)</code>
-<div class="block">Returns a new Text object where all the specified styles are applied to the full length of the
- specified plain text.</div>
+<div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;
+<div class="block"><span class="deprecationComment">use <a href="../picocli/CommandLine.Help.ColorScheme.html#apply-java.lang.String-java.util.List-"><code>CommandLine.Help.ColorScheme.apply(String, List)</code></a> instead</span></div>
+</div>
 </td>
 </tr>
 <tr id="i1" class="rowColor">
@@ -401,6 +402,8 @@ not permitted.)</div>
 <dl>
 <dt><span class="simpleTagLabel">Since:</span></dt>
 <dd>3.4</dd>
+<dt><span class="seeLabel">See Also:</span></dt>
+<dd><a href="../picocli/CommandLine.Help.ColorScheme.html#text-java.lang.String-"><code>CommandLine.Help.ColorScheme.text(String)</code></a></dd>
 </dl>
 </li>
 </ul>
@@ -419,6 +422,8 @@ not permitted.)</div>
 <dl>
 <dt><span class="simpleTagLabel">Since:</span></dt>
 <dd>3.4</dd>
+<dt><span class="seeLabel">See Also:</span></dt>
+<dd><a href="../picocli/CommandLine.Help.ColorScheme.html#string-java.lang.String-"><code>CommandLine.Help.ColorScheme.string(String)</code></a></dd>
 </dl>
 </li>
 </ul>
@@ -444,15 +449,7 @@ not permitted.)</div>
 <h4>apply</h4>
 <pre>public&nbsp;<a href="../picocli/CommandLine.Help.Ansi.Text.html" title="class in picocli">CommandLine.Help.Ansi.Text</a>&nbsp;apply(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;plainText,
                                         <a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;<a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli">CommandLine.Help.Ansi.IStyle</a>&gt;&nbsp;styles)</pre>
-<div class="block">Returns a new Text object where all the specified styles are applied to the full length of the
- specified plain text.</div>
-<dl>
-<dt><span class="paramLabel">Parameters:</span></dt>
-<dd><code>plainText</code> - the string to apply all styles to. Must not contain markup!</dd>
-<dd><code>styles</code> - the styles to apply to the full plain text</dd>
-<dt><span class="returnLabel">Returns:</span></dt>
-<dd>a new Text object</dd>
-</dl>
+<div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;<span class="deprecationComment">use <a href="../picocli/CommandLine.Help.ColorScheme.html#apply-java.lang.String-java.util.List-"><code>CommandLine.Help.ColorScheme.apply(String, List)</code></a> instead</span></div>
 </li>
 </ul>
 </li>
diff --git a/docs/apidocs/picocli/CommandLine.Help.ColorScheme.Builder.html b/docs/apidocs/picocli/CommandLine.Help.ColorScheme.Builder.html
index 089bfd80..bf94a1de 100644
--- a/docs/apidocs/picocli/CommandLine.Help.ColorScheme.Builder.html
+++ b/docs/apidocs/picocli/CommandLine.Help.ColorScheme.Builder.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.Help.ColorScheme.Builder (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Help.ColorScheme.Builder (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,13 +12,13 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Help.ColorScheme.Builder (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Help.ColorScheme.Builder (picocli 4.2.0 API)";
         }
     }
     catch(err) {
     }
 //-->
-var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10,"i11":10};
+var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10,"i11":10,"i12":10,"i13":10};
 var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]};
 var altColor = "altColor";
 var rowColor = "rowColor";
@@ -203,36 +203,48 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </td>
 </tr>
 <tr id="i6" class="altColor">
+<td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>,<a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli">CommandLine.Help.Ansi.IStyle</a>&gt;</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.ColorScheme.Builder.html#customMarkupMap--">customMarkupMap</a></span>()</code>
+<div class="block">Returns the custom mapping from markup names (the names of the <a href="../picocli/CommandLine.Help.Ansi.Style.html" title="enum in picocli"><code>CommandLine.Help.Ansi.Style</code></a> enum constants, like bold, italic, fg_blue, bg_green, etc) to <a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli"><code>CommandLine.Help.Ansi.IStyle</code></a> objects in this color scheme.</div>
+</td>
+</tr>
+<tr id="i7" class="rowColor">
+<td class="colFirst"><code><a href="../picocli/CommandLine.Help.ColorScheme.Builder.html" title="class in picocli">CommandLine.Help.ColorScheme.Builder</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.ColorScheme.Builder.html#customMarkupMap-java.util.Map-">customMarkupMap</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>,<a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli">CommandLine.Help.Ansi.IStyle</a>&gt;&nbsp;newValue)</code>
+<div class="block">Sets the custom mapping from markup names (the names of the <a href="../picocli/CommandLine.Help.Ansi.Style.html" title="enum in picocli"><code>CommandLine.Help.Ansi.Style</code></a> enum constants, like bold, italic, fg_blue, bg_green, etc) to <a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli"><code>CommandLine.Help.Ansi.IStyle</code></a> objects in this color scheme.</div>
+</td>
+</tr>
+<tr id="i8" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Help.ColorScheme.Builder.html" title="class in picocli">CommandLine.Help.ColorScheme.Builder</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.ColorScheme.Builder.html#optionParams-picocli.CommandLine.Help.Ansi.IStyle...-">optionParams</a></span>(<a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli">CommandLine.Help.Ansi.IStyle</a>...&nbsp;styles)</code>
 <div class="block">Adds the specified styles to the registered styles for option parameters in this color scheme builder and returns this builder.</div>
 </td>
 </tr>
-<tr id="i7" class="rowColor">
+<tr id="i9" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;<a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli">CommandLine.Help.Ansi.IStyle</a>&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.ColorScheme.Builder.html#optionParamStyles--">optionParamStyles</a></span>()</code>
 <div class="block">Returns the registered styles for option parameters in this color scheme builder.</div>
 </td>
 </tr>
-<tr id="i8" class="altColor">
+<tr id="i10" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Help.ColorScheme.Builder.html" title="class in picocli">CommandLine.Help.ColorScheme.Builder</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.ColorScheme.Builder.html#options-picocli.CommandLine.Help.Ansi.IStyle...-">options</a></span>(<a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli">CommandLine.Help.Ansi.IStyle</a>...&nbsp;styles)</code>
 <div class="block">Adds the specified styles to the registered styles for options in this color scheme and returns this color scheme.</div>
 </td>
 </tr>
-<tr id="i9" class="rowColor">
+<tr id="i11" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;<a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli">CommandLine.Help.Ansi.IStyle</a>&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.ColorScheme.Builder.html#optionStyles--">optionStyles</a></span>()</code>
 <div class="block">Returns the registered styles for options in this color scheme builder.</div>
 </td>
 </tr>
-<tr id="i10" class="altColor">
+<tr id="i12" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Help.ColorScheme.Builder.html" title="class in picocli">CommandLine.Help.ColorScheme.Builder</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.ColorScheme.Builder.html#parameters-picocli.CommandLine.Help.Ansi.IStyle...-">parameters</a></span>(<a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli">CommandLine.Help.Ansi.IStyle</a>...&nbsp;styles)</code>
 <div class="block">Adds the specified styles to the registered styles for positional parameters in this color scheme builder and returns this builder.</div>
 </td>
 </tr>
-<tr id="i11" class="rowColor">
+<tr id="i13" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;<a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli">CommandLine.Help.Ansi.IStyle</a>&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.ColorScheme.Builder.html#parameterStyles--">parameterStyles</a></span>()</code>
 <div class="block">Returns the registered styles for positional parameters in this color scheme builder.</div>
@@ -358,6 +370,37 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <div class="block">Returns the registered styles for option parameters in this color scheme builder.</div>
 </li>
 </ul>
+<a name="customMarkupMap--">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>customMarkupMap</h4>
+<pre>public&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>,<a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli">CommandLine.Help.Ansi.IStyle</a>&gt;&nbsp;customMarkupMap()</pre>
+<div class="block">Returns the custom mapping from markup names (the names of the <a href="../picocli/CommandLine.Help.Ansi.Style.html" title="enum in picocli"><code>CommandLine.Help.Ansi.Style</code></a> enum constants, like bold, italic, fg_blue, bg_green, etc) to <a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli"><code>CommandLine.Help.Ansi.IStyle</code></a> objects in this color scheme.
+ By default this returns <code>null</code>, unless a custom map was configured.</div>
+<dl>
+<dt><span class="simpleTagLabel">Since:</span></dt>
+<dd>4.2</dd>
+</dl>
+</li>
+</ul>
+<a name="customMarkupMap-java.util.Map-">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>customMarkupMap</h4>
+<pre>public&nbsp;<a href="../picocli/CommandLine.Help.ColorScheme.Builder.html" title="class in picocli">CommandLine.Help.ColorScheme.Builder</a>&nbsp;customMarkupMap(<a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>,<a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli">CommandLine.Help.Ansi.IStyle</a>&gt;&nbsp;newValue)</pre>
+<div class="block">Sets the custom mapping from markup names (the names of the <a href="../picocli/CommandLine.Help.Ansi.Style.html" title="enum in picocli"><code>CommandLine.Help.Ansi.Style</code></a> enum constants, like bold, italic, fg_blue, bg_green, etc) to <a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli"><code>CommandLine.Help.Ansi.IStyle</code></a> objects in this color scheme.</div>
+<dl>
+<dt><span class="returnLabel">Returns:</span></dt>
+<dd>this color scheme builder to enable method chaining for a more fluent API</dd>
+<dt><span class="simpleTagLabel">Since:</span></dt>
+<dd>4.2</dd>
+</dl>
+</li>
+</ul>
 <a name="commands-picocli.CommandLine.Help.Ansi.IStyle...-">
 <!--   -->
 </a>
diff --git a/docs/apidocs/picocli/CommandLine.Help.ColorScheme.html b/docs/apidocs/picocli/CommandLine.Help.ColorScheme.html
index bbf9b0ca..f26c2d38 100644
--- a/docs/apidocs/picocli/CommandLine.Help.ColorScheme.html
+++ b/docs/apidocs/picocli/CommandLine.Help.ColorScheme.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.Help.ColorScheme (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Help.ColorScheme (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,13 +12,13 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Help.ColorScheme (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Help.ColorScheme (picocli 4.2.0 API)";
         }
     }
     catch(err) {
     }
 //-->
-var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10};
+var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10,"i11":10,"i12":10,"i13":10,"i14":10,"i15":10,"i16":10,"i17":10};
 var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]};
 var altColor = "altColor";
 var rowColor = "rowColor";
@@ -171,68 +171,113 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </td>
 </tr>
 <tr id="i1" class="rowColor">
+<td class="colFirst"><code><a href="../picocli/CommandLine.Help.Ansi.Text.html" title="class in picocli">CommandLine.Help.Ansi.Text</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.ColorScheme.html#apply-java.lang.String-java.util.List-">apply</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;plainText,
+     <a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;<a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli">CommandLine.Help.Ansi.IStyle</a>&gt;&nbsp;styles)</code>
+<div class="block">Returns a new Text object where all the specified styles are applied to the full length of the
+ specified plain text.</div>
+</td>
+</tr>
+<tr id="i2" class="altColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;<a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli">CommandLine.Help.Ansi.IStyle</a>&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.ColorScheme.html#commandStyles--">commandStyles</a></span>()</code>
 <div class="block">Returns the registered styles for commands in this color scheme.</div>
 </td>
 </tr>
-<tr id="i2" class="altColor">
+<tr id="i3" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Help.Ansi.Text.html" title="class in picocli">CommandLine.Help.Ansi.Text</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.ColorScheme.html#commandText-java.lang.String-">commandText</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;command)</code>
 <div class="block">Returns a Text with all command styles applied to the specified command string.</div>
 </td>
 </tr>
-<tr id="i3" class="rowColor">
+<tr id="i4" class="altColor">
+<td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>,<a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli">CommandLine.Help.Ansi.IStyle</a>&gt;</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.ColorScheme.html#customMarkupMap--">customMarkupMap</a></span>()</code>
+<div class="block">Returns the custom mapping from markup names (the names of the <a href="../picocli/CommandLine.Help.Ansi.Style.html" title="enum in picocli"><code>CommandLine.Help.Ansi.Style</code></a> enum constants, like bold, italic, fg_blue, bg_green, etc) to <a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli"><code>CommandLine.Help.Ansi.IStyle</code></a> objects in this color scheme.</div>
+</td>
+</tr>
+<tr id="i5" class="rowColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.ColorScheme.html#equals-java.lang.Object-">equals</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;obj)</code>&nbsp;</td>
 </tr>
-<tr id="i4" class="altColor">
+<tr id="i6" class="altColor">
 <td class="colFirst"><code>int</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.ColorScheme.html#hashCode--">hashCode</a></span>()</code>&nbsp;</td>
 </tr>
-<tr id="i5" class="rowColor">
+<tr id="i7" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;<a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli">CommandLine.Help.Ansi.IStyle</a>&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.ColorScheme.html#optionParamStyles--">optionParamStyles</a></span>()</code>
 <div class="block">Returns the registered styles for option parameters in this color scheme.</div>
 </td>
 </tr>
-<tr id="i6" class="altColor">
+<tr id="i8" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Help.Ansi.Text.html" title="class in picocli">CommandLine.Help.Ansi.Text</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.ColorScheme.html#optionParamText-java.lang.String-">optionParamText</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;optionParam)</code>
 <div class="block">Returns a Text with all optionParam styles applied to the specified optionParam string.</div>
 </td>
 </tr>
-<tr id="i7" class="rowColor">
+<tr id="i9" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;<a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli">CommandLine.Help.Ansi.IStyle</a>&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.ColorScheme.html#optionStyles--">optionStyles</a></span>()</code>
 <div class="block">Returns the registered styles for options in this color scheme.</div>
 </td>
 </tr>
-<tr id="i8" class="altColor">
+<tr id="i10" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Help.Ansi.Text.html" title="class in picocli">CommandLine.Help.Ansi.Text</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.ColorScheme.html#optionText-java.lang.String-">optionText</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;option)</code>
 <div class="block">Returns a Text with all option styles applied to the specified option string.</div>
 </td>
 </tr>
-<tr id="i9" class="rowColor">
+<tr id="i11" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;<a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli">CommandLine.Help.Ansi.IStyle</a>&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.ColorScheme.html#parameterStyles--">parameterStyles</a></span>()</code>
 <div class="block">Returns the registered styles for positional parameters in this color scheme.</div>
 </td>
 </tr>
-<tr id="i10" class="altColor">
+<tr id="i12" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Help.Ansi.Text.html" title="class in picocli">CommandLine.Help.Ansi.Text</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.ColorScheme.html#parameterText-java.lang.String-">parameterText</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;parameter)</code>
 <div class="block">Returns a Text with all parameter styles applied to the specified parameter string.</div>
 </td>
 </tr>
+<tr id="i13" class="rowColor">
+<td class="colFirst"><code><a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli">CommandLine.Help.Ansi.IStyle</a>[]</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.ColorScheme.html#parse-java.lang.String-">parse</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;commaSeparatedCodes)</code>
+<div class="block">Converts the specified markup styles to an array of <a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli"><code>CommandLine.Help.Ansi.IStyle</code></a> objects.</div>
+</td>
+</tr>
+<tr id="i14" class="altColor">
+<td class="colFirst"><code><a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli">CommandLine.Help.Ansi.IStyle</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.ColorScheme.html#resetStyle--">resetStyle</a></span>()</code>
+<div class="block">Returns the style that "resets" the style state to neutral.</div>
+</td>
+</tr>
+<tr id="i15" class="rowColor">
+<td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.ColorScheme.html#string-java.lang.String-">string</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;stringWithMarkup)</code>
+<div class="block">Returns a String where any markup like
+ <code>@|bg(red),white,underline some text|@</code> is <a href="../picocli/CommandLine.Help.ColorScheme.html#parse-java.lang.String-">converted</a> to the styles defined in this ColorScheme
+ (if its Ansi mode is ON), or to the plain text without the markup (if this ColorScheme's Ansi mode is OFF).</div>
+</td>
+</tr>
+<tr id="i16" class="altColor">
+<td class="colFirst"><code><a href="../picocli/CommandLine.Help.Ansi.Text.html" title="class in picocli">CommandLine.Help.Ansi.Text</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.ColorScheme.html#text-java.lang.String-">text</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;stringWithMarkup)</code>
+<div class="block">Returns a new Text object for this ColorScheme, encapsulating the specified string
+ which may contain markup like <code>@|bg(red),white,underline some text|@</code>.</div>
+</td>
+</tr>
+<tr id="i17" class="rowColor">
+<td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.ColorScheme.html#toString--">toString</a></span>()</code>&nbsp;</td>
+</tr>
 </table>
 <ul class="blockList">
 <li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
 <!--   -->
 </a>
 <h3>Methods inherited from class&nbsp;java.lang.<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></h3>
-<code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#clone--" title="class or interface in java.lang">clone</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#finalize--" title="class or interface in java.lang">finalize</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#getClass--" title="class or interface in java.lang">getClass</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#notify--" title="class or interface in java.lang">notify</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#notifyAll--" title="class or interface in java.lang">notifyAll</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#toString--" title="class or interface in java.lang">toString</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait--" title="class or interface in java.lang">wait</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait-long-" title="class or interface in java.lang">wait</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait-long-int-" title="class or interface in java.lang">wait</a></code></li>
+<code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#clone--" title="class or interface in java.lang">clone</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#finalize--" title="class or interface in java.lang">finalize</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#getClass--" title="class or interface in java.lang">getClass</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#notify--" title="class or interface in java.lang">notify</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#notifyAll--" title="class or interface in java.lang">notifyAll</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait--" title="class or interface in java.lang">wait</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait-long-" title="class or interface in java.lang">wait</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait-long-int-" title="class or interface in java.lang">wait</a></code></li>
 </ul>
 </li>
 </ul>
@@ -378,6 +423,55 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </dl>
 </li>
 </ul>
+<a name="customMarkupMap--">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>customMarkupMap</h4>
+<pre>public&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>,<a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli">CommandLine.Help.Ansi.IStyle</a>&gt;&nbsp;customMarkupMap()</pre>
+<div class="block">Returns the custom mapping from markup names (the names of the <a href="../picocli/CommandLine.Help.Ansi.Style.html" title="enum in picocli"><code>CommandLine.Help.Ansi.Style</code></a> enum constants, like bold, italic, fg_blue, bg_green, etc) to <a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli"><code>CommandLine.Help.Ansi.IStyle</code></a> objects in this color scheme.
+ By default this returns an empty map, unless a custom map was configured.</div>
+<dl>
+<dt><span class="simpleTagLabel">Since:</span></dt>
+<dd>4.2</dd>
+</dl>
+</li>
+</ul>
+<a name="parse-java.lang.String-">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>parse</h4>
+<pre>public&nbsp;<a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli">CommandLine.Help.Ansi.IStyle</a>[]&nbsp;parse(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;commaSeparatedCodes)</pre>
+<div class="block">Converts the specified markup styles to an array of <a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli"><code>CommandLine.Help.Ansi.IStyle</code></a> objects.
+ If no <a href="../picocli/CommandLine.Help.ColorScheme.html#customMarkupMap--">custom markup mapping</a> is specified, this method delegates to <a href="../picocli/CommandLine.Help.Ansi.Style.html#parse-java.lang.String-"><code>CommandLine.Help.Ansi.Style.parse(String)</code></a>,
+ otherwise it returns the styles found in the custom mapping for the specified markup styles.</div>
+<dl>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>commaSeparatedCodes</code> - a string with a comma-separated list of markup styles (for example, <code>"bold,underline,bg_red"</code></dd>
+<dt><span class="simpleTagLabel">Since:</span></dt>
+<dd>4.2</dd>
+</dl>
+</li>
+</ul>
+<a name="resetStyle--">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>resetStyle</h4>
+<pre>public&nbsp;<a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli">CommandLine.Help.Ansi.IStyle</a>&nbsp;resetStyle()</pre>
+<div class="block">Returns the style that "resets" the style state to neutral.</div>
+<dl>
+<dt><span class="returnLabel">Returns:</span></dt>
+<dd><a href="../picocli/CommandLine.Help.Ansi.Style.html#reset"><code>CommandLine.Help.Ansi.Style.reset</code></a> if no <a href="../picocli/CommandLine.Help.ColorScheme.html#customMarkupMap--">customMarkupMap()</a> is defined, otherwise either the style registered with the "reset" name or an empty <code>IStyle</code> if no such style is registered.</dd>
+<dt><span class="simpleTagLabel">Since:</span></dt>
+<dd>4.2</dd>
+</dl>
+</li>
+</ul>
 <a name="equals-java.lang.Object-">
 <!--   -->
 </a>
@@ -394,7 +488,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <a name="hashCode--">
 <!--   -->
 </a>
-<ul class="blockListLast">
+<ul class="blockList">
 <li class="blockList">
 <h4>hashCode</h4>
 <pre>public&nbsp;int&nbsp;hashCode()</pre>
@@ -404,6 +498,83 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </dl>
 </li>
 </ul>
+<a name="toString--">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>toString</h4>
+<pre>public&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;toString()</pre>
+<dl>
+<dt><span class="overrideSpecifyLabel">Overrides:</span></dt>
+<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#toString--" title="class or interface in java.lang">toString</a></code>&nbsp;in class&nbsp;<code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></dd>
+</dl>
+</li>
+</ul>
+<a name="apply-java.lang.String-java.util.List-">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>apply</h4>
+<pre>public&nbsp;<a href="../picocli/CommandLine.Help.Ansi.Text.html" title="class in picocli">CommandLine.Help.Ansi.Text</a>&nbsp;apply(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;plainText,
+                                        <a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;<a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli">CommandLine.Help.Ansi.IStyle</a>&gt;&nbsp;styles)</pre>
+<div class="block">Returns a new Text object where all the specified styles are applied to the full length of the
+ specified plain text.</div>
+<dl>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>plainText</code> - the string to apply all styles to. Must not contain markup!</dd>
+<dd><code>styles</code> - the styles to apply to the full plain text</dd>
+<dt><span class="returnLabel">Returns:</span></dt>
+<dd>a new Text object</dd>
+<dt><span class="simpleTagLabel">Since:</span></dt>
+<dd>4.2</dd>
+</dl>
+</li>
+</ul>
+<a name="text-java.lang.String-">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>text</h4>
+<pre>public&nbsp;<a href="../picocli/CommandLine.Help.Ansi.Text.html" title="class in picocli">CommandLine.Help.Ansi.Text</a>&nbsp;text(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;stringWithMarkup)</pre>
+<div class="block">Returns a new Text object for this ColorScheme, encapsulating the specified string
+ which may contain markup like <code>@|bg(red),white,underline some text|@</code>.
+ <p>
+ Calling <code>toString()</code> on the returned Text will <a href="../picocli/CommandLine.Help.ColorScheme.html#parse-java.lang.String-">convert</a>
+ the markup to the styles defined in this ColorScheme
+ (if its Ansi mode is ON), or to the plain text without the markup (if this ColorScheme's Ansi mode is OFF).
+ <p>
+ Equivalent to <code>this.ansi().new Text(stringWithMarkup, this)</code>.</div>
+<dl>
+<dt><span class="simpleTagLabel">Since:</span></dt>
+<dd>4.2</dd>
+<dt><span class="seeLabel">See Also:</span></dt>
+<dd><a href="../picocli/CommandLine.Help.Ansi.html#text-java.lang.String-"><code>CommandLine.Help.Ansi.text(String)</code></a></dd>
+</dl>
+</li>
+</ul>
+<a name="string-java.lang.String-">
+<!--   -->
+</a>
+<ul class="blockListLast">
+<li class="blockList">
+<h4>string</h4>
+<pre>public&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;string(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;stringWithMarkup)</pre>
+<div class="block">Returns a String where any markup like
+ <code>@|bg(red),white,underline some text|@</code> is <a href="../picocli/CommandLine.Help.ColorScheme.html#parse-java.lang.String-">converted</a> to the styles defined in this ColorScheme
+ (if its Ansi mode is ON), or to the plain text without the markup (if this ColorScheme's Ansi mode is OFF).
+ <p>
+ Equivalent to <code>this.ansi().new Text(stringWithMarkup, this).toString()</code>.</div>
+<dl>
+<dt><span class="simpleTagLabel">Since:</span></dt>
+<dd>4.2</dd>
+<dt><span class="seeLabel">See Also:</span></dt>
+<dd><a href="../picocli/CommandLine.Help.Ansi.html#string-java.lang.String-"><code>CommandLine.Help.Ansi.string(String)</code></a></dd>
+</dl>
+</li>
+</ul>
 </li>
 </ul>
 </li>
diff --git a/docs/apidocs/picocli/CommandLine.Help.Column.Overflow.html b/docs/apidocs/picocli/CommandLine.Help.Column.Overflow.html
index d98bf94a..a52f9626 100644
--- a/docs/apidocs/picocli/CommandLine.Help.Column.Overflow.html
+++ b/docs/apidocs/picocli/CommandLine.Help.Column.Overflow.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.Help.Column.Overflow (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Help.Column.Overflow (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Help.Column.Overflow (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Help.Column.Overflow (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Help.Column.html b/docs/apidocs/picocli/CommandLine.Help.Column.html
index 54db5dcf..1606748e 100644
--- a/docs/apidocs/picocli/CommandLine.Help.Column.html
+++ b/docs/apidocs/picocli/CommandLine.Help.Column.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.Help.Column (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Help.Column (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Help.Column (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Help.Column (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Help.IOptionRenderer.html b/docs/apidocs/picocli/CommandLine.Help.IOptionRenderer.html
index be3433d9..d50898a7 100644
--- a/docs/apidocs/picocli/CommandLine.Help.IOptionRenderer.html
+++ b/docs/apidocs/picocli/CommandLine.Help.IOptionRenderer.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.Help.IOptionRenderer (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Help.IOptionRenderer (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Help.IOptionRenderer (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Help.IOptionRenderer (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Help.IParamLabelRenderer.html b/docs/apidocs/picocli/CommandLine.Help.IParamLabelRenderer.html
index ddf39872..c6f3d17b 100644
--- a/docs/apidocs/picocli/CommandLine.Help.IParamLabelRenderer.html
+++ b/docs/apidocs/picocli/CommandLine.Help.IParamLabelRenderer.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.Help.IParamLabelRenderer (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Help.IParamLabelRenderer (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Help.IParamLabelRenderer (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Help.IParamLabelRenderer (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Help.IParameterRenderer.html b/docs/apidocs/picocli/CommandLine.Help.IParameterRenderer.html
index 69b592fc..b68c43e5 100644
--- a/docs/apidocs/picocli/CommandLine.Help.IParameterRenderer.html
+++ b/docs/apidocs/picocli/CommandLine.Help.IParameterRenderer.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.Help.IParameterRenderer (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Help.IParameterRenderer (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Help.IParameterRenderer (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Help.IParameterRenderer (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Help.Layout.html b/docs/apidocs/picocli/CommandLine.Help.Layout.html
index c69d2c8b..506780c0 100644
--- a/docs/apidocs/picocli/CommandLine.Help.Layout.html
+++ b/docs/apidocs/picocli/CommandLine.Help.Layout.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.Help.Layout (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Help.Layout (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Help.Layout (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Help.Layout (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Help.TextTable.Cell.html b/docs/apidocs/picocli/CommandLine.Help.TextTable.Cell.html
index 31b7b4f4..1cd9a8b2 100644
--- a/docs/apidocs/picocli/CommandLine.Help.TextTable.Cell.html
+++ b/docs/apidocs/picocli/CommandLine.Help.TextTable.Cell.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.Help.TextTable.Cell (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Help.TextTable.Cell (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Help.TextTable.Cell (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Help.TextTable.Cell (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Help.TextTable.html b/docs/apidocs/picocli/CommandLine.Help.TextTable.html
index ff2c206b..3c3d1bb4 100644
--- a/docs/apidocs/picocli/CommandLine.Help.TextTable.html
+++ b/docs/apidocs/picocli/CommandLine.Help.TextTable.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.Help.TextTable (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Help.TextTable (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,13 +12,13 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Help.TextTable (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Help.TextTable (picocli 4.2.0 API)";
         }
     }
     catch(err) {
     }
 //-->
-var methods = {"i0":10,"i1":10,"i2":10,"i3":42,"i4":10,"i5":9,"i6":9,"i7":9,"i8":9,"i9":10,"i10":10,"i11":10,"i12":10,"i13":10,"i14":10,"i15":10};
+var methods = {"i0":10,"i1":10,"i2":10,"i3":42,"i4":10,"i5":41,"i6":9,"i7":41,"i8":9,"i9":41,"i10":41,"i11":9,"i12":10,"i13":10,"i14":10,"i15":10,"i16":10,"i17":10,"i18":10};
 var tabs = {65535:["t0","All Methods"],1:["t1","Static Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"],32:["t6","Deprecated Methods"]};
 var altColor = "altColor";
 var rowColor = "rowColor";
@@ -186,6 +186,15 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <tr class="altColor">
 <td class="colFirst"><code>protected </code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.TextTable.html#TextTable-picocli.CommandLine.Help.Ansi-picocli.CommandLine.Help.Column:A-">TextTable</a></span>(<a href="../picocli/CommandLine.Help.Ansi.html" title="enum in picocli">CommandLine.Help.Ansi</a>&nbsp;ansi,
+         <a href="../picocli/CommandLine.Help.Column.html" title="class in picocli">CommandLine.Help.Column</a>[]&nbsp;columns)</code>
+<div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;
+<div class="block"><span class="deprecationComment">use <code>TextTable#TextTable(ColorScheme, Column[])</code> instead</span></div>
+</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>protected </code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.TextTable.html#TextTable-picocli.CommandLine.Help.ColorScheme-picocli.CommandLine.Help.Column:A-">TextTable</a></span>(<a href="../picocli/CommandLine.Help.ColorScheme.html" title="class in picocli">CommandLine.Help.ColorScheme</a>&nbsp;colorScheme,
          <a href="../picocli/CommandLine.Help.Column.html" title="class in picocli">CommandLine.Help.Column</a>[]&nbsp;columns)</code>&nbsp;</td>
 </tr>
 </table>
@@ -242,36 +251,59 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <td class="colFirst"><code>static <a href="../picocli/CommandLine.Help.TextTable.html" title="class in picocli">CommandLine.Help.TextTable</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.TextTable.html#forColumns-picocli.CommandLine.Help.Ansi-picocli.CommandLine.Help.Column...-">forColumns</a></span>(<a href="../picocli/CommandLine.Help.Ansi.html" title="enum in picocli">CommandLine.Help.Ansi</a>&nbsp;ansi,
           <a href="../picocli/CommandLine.Help.Column.html" title="class in picocli">CommandLine.Help.Column</a>...&nbsp;columns)</code>
-<div class="block">Constructs a <code>TextTable</code> with the specified columns.</div>
+<div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;
+<div class="block"><span class="deprecationComment">use <code>#forColumns(ColorScheme, Column...)</code> instead</span></div>
+</div>
 </td>
 </tr>
 <tr id="i6" class="altColor">
 <td class="colFirst"><code>static <a href="../picocli/CommandLine.Help.TextTable.html" title="class in picocli">CommandLine.Help.TextTable</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.TextTable.html#forColumns-picocli.CommandLine.Help.ColorScheme-picocli.CommandLine.Help.Column...-">forColumns</a></span>(<a href="../picocli/CommandLine.Help.ColorScheme.html" title="class in picocli">CommandLine.Help.ColorScheme</a>&nbsp;colorScheme,
+          <a href="../picocli/CommandLine.Help.Column.html" title="class in picocli">CommandLine.Help.Column</a>...&nbsp;columns)</code>
+<div class="block">Constructs a <code>TextTable</code> with the specified columns.</div>
+</td>
+</tr>
+<tr id="i7" class="rowColor">
+<td class="colFirst"><code>static <a href="../picocli/CommandLine.Help.TextTable.html" title="class in picocli">CommandLine.Help.TextTable</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.TextTable.html#forColumnWidths-picocli.CommandLine.Help.Ansi-int...-">forColumnWidths</a></span>(<a href="../picocli/CommandLine.Help.Ansi.html" title="enum in picocli">CommandLine.Help.Ansi</a>&nbsp;ansi,
                int...&nbsp;columnWidths)</code>
+<div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;
+<div class="block"><span class="deprecationComment">use <code>#forColumns(ColorScheme, Column...)</code> instead</span></div>
+</div>
+</td>
+</tr>
+<tr id="i8" class="altColor">
+<td class="colFirst"><code>static <a href="../picocli/CommandLine.Help.TextTable.html" title="class in picocli">CommandLine.Help.TextTable</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.TextTable.html#forColumnWidths-picocli.CommandLine.Help.ColorScheme-int...-">forColumnWidths</a></span>(<a href="../picocli/CommandLine.Help.ColorScheme.html" title="class in picocli">CommandLine.Help.ColorScheme</a>&nbsp;colorScheme,
+               int...&nbsp;columnWidths)</code>
 <div class="block">Constructs a new TextTable with columns with the specified width, all SPANning  multiple columns on
  overflow except the last column which WRAPS to the next row.</div>
 </td>
 </tr>
-<tr id="i7" class="rowColor">
+<tr id="i9" class="rowColor">
 <td class="colFirst"><code>static <a href="../picocli/CommandLine.Help.TextTable.html" title="class in picocli">CommandLine.Help.TextTable</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.TextTable.html#forDefaultColumns-picocli.CommandLine.Help.Ansi-int-">forDefaultColumns</a></span>(<a href="../picocli/CommandLine.Help.Ansi.html" title="enum in picocli">CommandLine.Help.Ansi</a>&nbsp;ansi,
                  int&nbsp;usageHelpWidth)</code>
-<div class="block">Constructs a TextTable with five columns as follows:
- 
- required option/parameter marker (width: 2, indent: 0, TRUNCATE on overflow)
- short option name (width: 2, indent: 0, TRUNCATE on overflow)
- comma separator (width: 1, indent: 0, TRUNCATE on overflow)
- long option name(s) (width: 24, indent: 1, SPAN multiple columns on overflow)
- description line(s) (width: 51, indent: 1, WRAP to next row on overflow)
- </div>
+<div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;
+<div class="block"><span class="deprecationComment">use <code>#forDefaultColumns(Ansi, int, int)</code> instead</span></div>
+</div>
 </td>
 </tr>
-<tr id="i8" class="altColor">
+<tr id="i10" class="altColor">
 <td class="colFirst"><code>static <a href="../picocli/CommandLine.Help.TextTable.html" title="class in picocli">CommandLine.Help.TextTable</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.TextTable.html#forDefaultColumns-picocli.CommandLine.Help.Ansi-int-int-">forDefaultColumns</a></span>(<a href="../picocli/CommandLine.Help.Ansi.html" title="enum in picocli">CommandLine.Help.Ansi</a>&nbsp;ansi,
                  int&nbsp;longOptionsColumnWidth,
                  int&nbsp;usageHelpWidth)</code>
+<div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;
+<div class="block"><span class="deprecationComment">use <code>#forDefaultColumns(ColorScheme, int, int)</code> instead</span></div>
+</div>
+</td>
+</tr>
+<tr id="i11" class="rowColor">
+<td class="colFirst"><code>static <a href="../picocli/CommandLine.Help.TextTable.html" title="class in picocli">CommandLine.Help.TextTable</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.TextTable.html#forDefaultColumns-picocli.CommandLine.Help.ColorScheme-int-int-">forDefaultColumns</a></span>(<a href="../picocli/CommandLine.Help.ColorScheme.html" title="class in picocli">CommandLine.Help.ColorScheme</a>&nbsp;colorScheme,
+                 int&nbsp;longOptionsColumnWidth,
+                 int&nbsp;usageHelpWidth)</code>
 <div class="block">Constructs a TextTable with five columns as follows:
  
  required option/parameter marker (width: 2, indent: 0, TRUNCATE on overflow)
@@ -282,11 +314,11 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
  </div>
 </td>
 </tr>
-<tr id="i9" class="rowColor">
+<tr id="i12" class="altColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.TextTable.html#isAdjustLineBreaksForWideCJKCharacters--">isAdjustLineBreaksForWideCJKCharacters</a></span>()</code>&nbsp;</td>
 </tr>
-<tr id="i10" class="altColor">
+<tr id="i13" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Help.TextTable.Cell.html" title="class in picocli">CommandLine.Help.TextTable.Cell</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.TextTable.html#putValue-int-int-picocli.CommandLine.Help.Ansi.Text-">putValue</a></span>(int&nbsp;row,
         int&nbsp;col,
@@ -295,28 +327,28 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
  column written to.</div>
 </td>
 </tr>
-<tr id="i11" class="rowColor">
+<tr id="i14" class="altColor">
 <td class="colFirst"><code>int</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.TextTable.html#rowCount--">rowCount</a></span>()</code>
 <div class="block">Returns the current number of rows of this <code>TextTable</code>.</div>
 </td>
 </tr>
-<tr id="i12" class="altColor">
+<tr id="i15" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Help.TextTable.html" title="class in picocli">CommandLine.Help.TextTable</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.TextTable.html#setAdjustLineBreaksForWideCJKCharacters-boolean-">setAdjustLineBreaksForWideCJKCharacters</a></span>(boolean&nbsp;adjustLineBreaksForWideCJKCharacters)</code>&nbsp;</td>
 </tr>
-<tr id="i13" class="rowColor">
+<tr id="i16" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Help.Ansi.Text.html" title="class in picocli">CommandLine.Help.Ansi.Text</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.TextTable.html#textAt-int-int-">textAt</a></span>(int&nbsp;row,
       int&nbsp;col)</code>
 <div class="block">Returns the <code>Text</code> slot at the specified row and column to write a text value into.</div>
 </td>
 </tr>
-<tr id="i14" class="altColor">
+<tr id="i17" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.TextTable.html#toString--">toString</a></span>()</code>&nbsp;</td>
 </tr>
-<tr id="i15" class="rowColor">
+<tr id="i18" class="altColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/StringBuilder.html?is-external=true" title="class or interface in java.lang">StringBuilder</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.TextTable.html#toString-java.lang.StringBuilder-">toString</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/StringBuilder.html?is-external=true" title="class or interface in java.lang">StringBuilder</a>&nbsp;text)</code>
 <div class="block">Copies the text representation that we built up from the options into the specified StringBuilder.</div>
@@ -375,11 +407,22 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <a name="TextTable-picocli.CommandLine.Help.Ansi-picocli.CommandLine.Help.Column:A-">
 <!--   -->
 </a>
-<ul class="blockListLast">
+<ul class="blockList">
 <li class="blockList">
 <h4>TextTable</h4>
 <pre>protected&nbsp;TextTable(<a href="../picocli/CommandLine.Help.Ansi.html" title="enum in picocli">CommandLine.Help.Ansi</a>&nbsp;ansi,
                     <a href="../picocli/CommandLine.Help.Column.html" title="class in picocli">CommandLine.Help.Column</a>[]&nbsp;columns)</pre>
+<div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;<span class="deprecationComment">use <code>TextTable#TextTable(ColorScheme, Column[])</code> instead</span></div>
+</li>
+</ul>
+<a name="TextTable-picocli.CommandLine.Help.ColorScheme-picocli.CommandLine.Help.Column:A-">
+<!--   -->
+</a>
+<ul class="blockListLast">
+<li class="blockList">
+<h4>TextTable</h4>
+<pre>protected&nbsp;TextTable(<a href="../picocli/CommandLine.Help.ColorScheme.html" title="class in picocli">CommandLine.Help.ColorScheme</a>&nbsp;colorScheme,
+                    <a href="../picocli/CommandLine.Help.Column.html" title="class in picocli">CommandLine.Help.Column</a>[]&nbsp;columns)</pre>
 </li>
 </ul>
 </li>
@@ -398,6 +441,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <h4>forDefaultColumns</h4>
 <pre>public static&nbsp;<a href="../picocli/CommandLine.Help.TextTable.html" title="class in picocli">CommandLine.Help.TextTable</a>&nbsp;forDefaultColumns(<a href="../picocli/CommandLine.Help.Ansi.html" title="enum in picocli">CommandLine.Help.Ansi</a>&nbsp;ansi,
                                                            int&nbsp;usageHelpWidth)</pre>
+<div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;<span class="deprecationComment">use <code>#forDefaultColumns(Ansi, int, int)</code> instead</span></div>
 <div class="block">Constructs a TextTable with five columns as follows:
  <ol>
  <li>required option/parameter marker (width: 2, indent: 0, TRUNCATE on overflow)</li>
@@ -422,6 +466,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <pre>public static&nbsp;<a href="../picocli/CommandLine.Help.TextTable.html" title="class in picocli">CommandLine.Help.TextTable</a>&nbsp;forDefaultColumns(<a href="../picocli/CommandLine.Help.Ansi.html" title="enum in picocli">CommandLine.Help.Ansi</a>&nbsp;ansi,
                                                            int&nbsp;longOptionsColumnWidth,
                                                            int&nbsp;usageHelpWidth)</pre>
+<div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;<span class="deprecationComment">use <code>#forDefaultColumns(ColorScheme, int, int)</code> instead</span></div>
 <div class="block">Constructs a TextTable with five columns as follows:
  <ol>
  <li>required option/parameter marker (width: 2, indent: 0, TRUNCATE on overflow)</li>
@@ -438,6 +483,33 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </dl>
 </li>
 </ul>
+<a name="forDefaultColumns-picocli.CommandLine.Help.ColorScheme-int-int-">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>forDefaultColumns</h4>
+<pre>public static&nbsp;<a href="../picocli/CommandLine.Help.TextTable.html" title="class in picocli">CommandLine.Help.TextTable</a>&nbsp;forDefaultColumns(<a href="../picocli/CommandLine.Help.ColorScheme.html" title="class in picocli">CommandLine.Help.ColorScheme</a>&nbsp;colorScheme,
+                                                           int&nbsp;longOptionsColumnWidth,
+                                                           int&nbsp;usageHelpWidth)</pre>
+<div class="block">Constructs a TextTable with five columns as follows:
+ <ol>
+ <li>required option/parameter marker (width: 2, indent: 0, TRUNCATE on overflow)</li>
+ <li>short option name (width: 2, indent: 0, TRUNCATE on overflow)</li>
+ <li>comma separator (width: 1, indent: 0, TRUNCATE on overflow)</li>
+ <li>long option name(s) (width: 24, indent: 1, SPAN multiple columns on overflow)</li>
+ <li>description line(s) (width: 51, indent: 1, WRAP to next row on overflow)</li>
+ </ol></div>
+<dl>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>colorScheme</code> - the styles and ANSI mode to use for embedded markup</dd>
+<dd><code>longOptionsColumnWidth</code> - the width of the long options column</dd>
+<dd><code>usageHelpWidth</code> - the total width of the columns combined</dd>
+<dt><span class="simpleTagLabel">Since:</span></dt>
+<dd>4.2</dd>
+</dl>
+</li>
+</ul>
 <a name="forColumnWidths-picocli.CommandLine.Help.Ansi-int...-">
 <!--   -->
 </a>
@@ -446,6 +518,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <h4>forColumnWidths</h4>
 <pre>public static&nbsp;<a href="../picocli/CommandLine.Help.TextTable.html" title="class in picocli">CommandLine.Help.TextTable</a>&nbsp;forColumnWidths(<a href="../picocli/CommandLine.Help.Ansi.html" title="enum in picocli">CommandLine.Help.Ansi</a>&nbsp;ansi,
                                                          int...&nbsp;columnWidths)</pre>
+<div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;<span class="deprecationComment">use <code>#forColumns(ColorScheme, Column...)</code> instead</span></div>
 <div class="block">Constructs a new TextTable with columns with the specified width, all SPANning  multiple columns on
  overflow except the last column which WRAPS to the next row.</div>
 <dl>
@@ -455,6 +528,25 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </dl>
 </li>
 </ul>
+<a name="forColumnWidths-picocli.CommandLine.Help.ColorScheme-int...-">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>forColumnWidths</h4>
+<pre>public static&nbsp;<a href="../picocli/CommandLine.Help.TextTable.html" title="class in picocli">CommandLine.Help.TextTable</a>&nbsp;forColumnWidths(<a href="../picocli/CommandLine.Help.ColorScheme.html" title="class in picocli">CommandLine.Help.ColorScheme</a>&nbsp;colorScheme,
+                                                         int...&nbsp;columnWidths)</pre>
+<div class="block">Constructs a new TextTable with columns with the specified width, all SPANning  multiple columns on
+ overflow except the last column which WRAPS to the next row.</div>
+<dl>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>colorScheme</code> - the styles and ANSI mode to use for embedded markup</dd>
+<dd><code>columnWidths</code> - the width of each table column (all columns have zero indent)</dd>
+<dt><span class="simpleTagLabel">Since:</span></dt>
+<dd>4.2</dd>
+</dl>
+</li>
+</ul>
 <a name="forColumns-picocli.CommandLine.Help.Ansi-picocli.CommandLine.Help.Column...-">
 <!--   -->
 </a>
@@ -463,6 +555,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <h4>forColumns</h4>
 <pre>public static&nbsp;<a href="../picocli/CommandLine.Help.TextTable.html" title="class in picocli">CommandLine.Help.TextTable</a>&nbsp;forColumns(<a href="../picocli/CommandLine.Help.Ansi.html" title="enum in picocli">CommandLine.Help.Ansi</a>&nbsp;ansi,
                                                     <a href="../picocli/CommandLine.Help.Column.html" title="class in picocli">CommandLine.Help.Column</a>...&nbsp;columns)</pre>
+<div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;<span class="deprecationComment">use <code>#forColumns(ColorScheme, Column...)</code> instead</span></div>
 <div class="block">Constructs a <code>TextTable</code> with the specified columns.</div>
 <dl>
 <dt><span class="paramLabel">Parameters:</span></dt>
@@ -471,6 +564,24 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </dl>
 </li>
 </ul>
+<a name="forColumns-picocli.CommandLine.Help.ColorScheme-picocli.CommandLine.Help.Column...-">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>forColumns</h4>
+<pre>public static&nbsp;<a href="../picocli/CommandLine.Help.TextTable.html" title="class in picocli">CommandLine.Help.TextTable</a>&nbsp;forColumns(<a href="../picocli/CommandLine.Help.ColorScheme.html" title="class in picocli">CommandLine.Help.ColorScheme</a>&nbsp;colorScheme,
+                                                    <a href="../picocli/CommandLine.Help.Column.html" title="class in picocli">CommandLine.Help.Column</a>...&nbsp;columns)</pre>
+<div class="block">Constructs a <code>TextTable</code> with the specified columns.</div>
+<dl>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>colorScheme</code> - the styles and ANSI mode to use for embedded markup</dd>
+<dd><code>columns</code> - columns to construct this TextTable with</dd>
+<dt><span class="simpleTagLabel">Since:</span></dt>
+<dd>4.2</dd>
+</dl>
+</li>
+</ul>
 <a name="isAdjustLineBreaksForWideCJKCharacters--">
 <!--   -->
 </a>
diff --git a/docs/apidocs/picocli/CommandLine.Help.Visibility.html b/docs/apidocs/picocli/CommandLine.Help.Visibility.html
index 97813e6d..1d8b779f 100644
--- a/docs/apidocs/picocli/CommandLine.Help.Visibility.html
+++ b/docs/apidocs/picocli/CommandLine.Help.Visibility.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.Help.Visibility (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Help.Visibility (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Help.Visibility (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Help.Visibility (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Help.html b/docs/apidocs/picocli/CommandLine.Help.html
index 40bc8ae1..20cee99e 100644
--- a/docs/apidocs/picocli/CommandLine.Help.html
+++ b/docs/apidocs/picocli/CommandLine.Help.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.Help (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Help (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,13 +12,13 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Help (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Help (picocli 4.2.0 API)";
         }
     }
     catch(err) {
     }
 //-->
-var methods = {"i0":10,"i1":10,"i2":42,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10,"i11":10,"i12":10,"i13":10,"i14":10,"i15":10,"i16":10,"i17":10,"i18":10,"i19":9,"i20":9,"i21":9,"i22":9,"i23":9,"i24":10,"i25":10,"i26":9,"i27":10,"i28":10,"i29":42,"i30":10,"i31":10,"i32":10,"i33":10,"i34":10,"i35":10,"i36":10,"i37":10,"i38":10,"i39":9,"i40":41,"i41":10,"i42":10,"i43":10,"i44":10,"i45":10,"i46":10,"i47":10,"i48":9,"i49":10,"i50":42,"i51":10,"i52":10,"i53":10};
+var methods = {"i0":10,"i1":10,"i2":42,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10,"i11":10,"i12":10,"i13":10,"i14":10,"i15":10,"i16":10,"i17":10,"i18":10,"i19":10,"i20":9,"i21":9,"i22":9,"i23":9,"i24":9,"i25":10,"i26":10,"i27":9,"i28":10,"i29":10,"i30":42,"i31":10,"i32":10,"i33":10,"i34":10,"i35":10,"i36":10,"i37":10,"i38":10,"i39":10,"i40":9,"i41":41,"i42":10,"i43":10,"i44":10,"i45":10,"i46":10,"i47":10,"i48":10,"i49":9,"i50":10,"i51":42,"i52":10,"i53":10,"i54":10};
 var tabs = {65535:["t0","All Methods"],1:["t1","Static Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"],32:["t6","Deprecated Methods"]};
 var altColor = "altColor";
 var rowColor = "rowColor";
@@ -246,12 +246,16 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <th class="colLast" scope="col">Field and Description</th>
 </tr>
 <tr class="altColor">
+<td class="colFirst"><code><a href="../picocli/CommandLine.Model.PositionalParamSpec.html" title="class in picocli">CommandLine.Model.PositionalParamSpec</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#AT_FILE_POSITIONAL_PARAM">AT_FILE_POSITIONAL_PARAM</a></span></code>&nbsp;</td>
+</tr>
+<tr class="rowColor">
 <td class="colFirst"><code>protected static <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#DEFAULT_COMMAND_NAME">DEFAULT_COMMAND_NAME</a></span></code>
 <div class="block">Constant String holding the default program name, value defined in <a href="../picocli/CommandLine.Model.CommandSpec.html#DEFAULT_COMMAND_NAME"><code>CommandLine.Model.CommandSpec.DEFAULT_COMMAND_NAME</code></a>.</div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colFirst"><code>protected static <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#DEFAULT_SEPARATOR">DEFAULT_SEPARATOR</a></span></code>
 <div class="block">Constant String holding the default string that separates options from option parameters, value defined in <a href="../picocli/CommandLine.Model.ParserSpec.html#DEFAULT_SEPARATOR"><code>CommandLine.Model.ParserSpec.DEFAULT_SEPARATOR</code></a>.</div>
@@ -274,20 +278,20 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <tr class="altColor">
 <td class="colOne"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#Help-picocli.CommandLine.Model.CommandSpec-picocli.CommandLine.Help.ColorScheme-">Help</a></span>(<a href="../picocli/CommandLine.Model.CommandSpec.html" title="class in picocli">CommandLine.Model.CommandSpec</a>&nbsp;commandSpec,
     <a href="../picocli/CommandLine.Help.ColorScheme.html" title="class in picocli">CommandLine.Help.ColorScheme</a>&nbsp;colorScheme)</code>
-<div class="block">Constructs a new <code>Help</code> instance with the specified color scheme, initialized from annotatations
+<div class="block">Constructs a new <code>Help</code> instance with the specified color scheme, initialized from annotations
  on the specified class and superclasses.</div>
 </td>
 </tr>
 <tr class="rowColor">
 <td class="colOne"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#Help-java.lang.Object-">Help</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;command)</code>
-<div class="block">Constructs a new <code>Help</code> instance with a default color scheme, initialized from annotatations
+<div class="block">Constructs a new <code>Help</code> instance with a default color scheme, initialized from annotations
  on the specified class and superclasses.</div>
 </td>
 </tr>
 <tr class="altColor">
 <td class="colOne"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#Help-java.lang.Object-picocli.CommandLine.Help.Ansi-">Help</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;command,
     <a href="../picocli/CommandLine.Help.Ansi.html" title="enum in picocli">CommandLine.Help.Ansi</a>&nbsp;ansi)</code>
-<div class="block">Constructs a new <code>Help</code> instance with a default color scheme, initialized from annotatations
+<div class="block">Constructs a new <code>Help</code> instance with a default color scheme, initialized from annotations
  on the specified class and superclasses.</div>
 </td>
 </tr>
@@ -347,57 +351,63 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </td>
 </tr>
 <tr id="i5" class="rowColor">
+<td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#atFileParameterList--">atFileParameterList</a></span>()</code>
+<div class="block">Returns the section of the usage help message that lists the @-file and its description.</div>
+</td>
+</tr>
+<tr id="i6" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Help.ColorScheme.html" title="class in picocli">CommandLine.Help.ColorScheme</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#colorScheme--">colorScheme</a></span>()</code>
 <div class="block">Returns the <code>ColorScheme</code> model that this Help was constructed with.</div>
 </td>
 </tr>
-<tr id="i6" class="altColor">
+<tr id="i7" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#commandList--">commandList</a></span>()</code>
 <div class="block">Returns a 2-column list with command names and the first line of their header or (if absent) description.</div>
 </td>
 </tr>
-<tr id="i7" class="rowColor">
+<tr id="i8" class="altColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#commandListHeading-java.lang.Object...-">commandListHeading</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>...&nbsp;params)</code>
 <div class="block">Returns the text displayed before the command list; an empty string if there are no commands,
  otherwise the result of <code>String.format(commandListHeading, params)</code>.</div>
 </td>
 </tr>
-<tr id="i8" class="altColor">
+<tr id="i9" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Help.Ansi.Text.html" title="class in picocli">CommandLine.Help.Ansi.Text</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#commandNamesText-java.lang.String-">commandNamesText</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;separator)</code>
 <div class="block">Returns a <code>Text</code> object containing the command name and all aliases, separated with the specified separator.</div>
 </td>
 </tr>
-<tr id="i9" class="rowColor">
+<tr id="i10" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Model.CommandSpec.html" title="class in picocli">CommandLine.Model.CommandSpec</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#commandSpec--">commandSpec</a></span>()</code>
 <div class="block">Returns the <code>CommandSpec</code> model that this Help was constructed with.</div>
 </td>
 </tr>
-<tr id="i10" class="altColor">
+<tr id="i11" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Help.Layout.html" title="class in picocli">CommandLine.Help.Layout</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#createDefaultLayout--">createDefaultLayout</a></span>()</code>
 <div class="block">Returns a <code>Layout</code> instance configured with the user preferences captured in this Help instance.</div>
 </td>
 </tr>
-<tr id="i11" class="rowColor">
+<tr id="i12" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Help.IOptionRenderer.html" title="interface in picocli">CommandLine.Help.IOptionRenderer</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#createDefaultOptionRenderer--">createDefaultOptionRenderer</a></span>()</code>
 <div class="block">Returns a new default OptionRenderer which converts <a href="../picocli/CommandLine.Model.OptionSpec.html" title="class in picocli"><code>Options</code></a> to five columns of text to match
   the default <a href="../picocli/CommandLine.Help.TextTable.html" title="class in picocli">TextTable</a> column layout.</div>
 </td>
 </tr>
-<tr id="i12" class="altColor">
+<tr id="i13" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Help.IParameterRenderer.html" title="interface in picocli">CommandLine.Help.IParameterRenderer</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#createDefaultParameterRenderer--">createDefaultParameterRenderer</a></span>()</code>
 <div class="block">Returns a new default ParameterRenderer which converts <a href="../picocli/CommandLine.Model.PositionalParamSpec.html" title="class in picocli">positional parameters</a> to four columns of
  text to match the default <a href="../picocli/CommandLine.Help.TextTable.html" title="class in picocli">TextTable</a> column layout.</div>
 </td>
 </tr>
-<tr id="i13" class="rowColor">
+<tr id="i14" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Help.IParamLabelRenderer.html" title="interface in picocli">CommandLine.Help.IParamLabelRenderer</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#createDefaultParamLabelRenderer--">createDefaultParamLabelRenderer</a></span>()</code>
 <div class="block">Returns a new default param label renderer that separates option parameters from their option name
@@ -406,20 +416,20 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
  characters and uses ellipses ("...") to indicate that any number of a parameter are allowed.</div>
 </td>
 </tr>
-<tr id="i14" class="altColor">
+<tr id="i15" class="rowColor">
 <td class="colFirst"><code>protected <a href="../picocli/CommandLine.Help.Ansi.Text.html" title="class in picocli">CommandLine.Help.Ansi.Text</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#createDetailedSynopsisCommandText--">createDetailedSynopsisCommandText</a></span>()</code>
 <div class="block">Returns a Text object containing a partial detailed synopsis showing only the subcommands, starting with a <code>" "</code> space.</div>
 </td>
 </tr>
-<tr id="i15" class="rowColor">
+<tr id="i16" class="altColor">
 <td class="colFirst"><code>protected <a href="../picocli/CommandLine.Help.Ansi.Text.html" title="class in picocli">CommandLine.Help.Ansi.Text</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#createDetailedSynopsisGroupsText-java.util.Set-">createDetailedSynopsisGroupsText</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/util/Set.html?is-external=true" title="class or interface in java.util">Set</a>&lt;<a href="../picocli/CommandLine.Model.ArgSpec.html" title="class in picocli">CommandLine.Model.ArgSpec</a>&gt;&nbsp;outparam_groupArgs)</code>
 <div class="block">Returns a Text object containing a partial detailed synopsis showing only the options and positional parameters in
  the specified <a href="../picocli/CommandLine.ArgGroup.html#validate--">validating</a> <a href="../picocli/CommandLine.ArgGroup.html" title="annotation in picocli">groups</a>, starting with a <code>" "</code> space.</div>
 </td>
 </tr>
-<tr id="i16" class="altColor">
+<tr id="i17" class="rowColor">
 <td class="colFirst"><code>protected <a href="../picocli/CommandLine.Help.Ansi.Text.html" title="class in picocli">CommandLine.Help.Ansi.Text</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#createDetailedSynopsisOptionsText-java.util.Collection-java.util.Comparator-boolean-">createDetailedSynopsisOptionsText</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;<a href="../picocli/CommandLine.Model.ArgSpec.html" title="class in picocli">CommandLine.Model.ArgSpec</a>&gt;&nbsp;done,
                                  <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Comparator.html?is-external=true" title="class or interface in java.util">Comparator</a>&lt;<a href="../picocli/CommandLine.Model.OptionSpec.html" title="class in picocli">CommandLine.Model.OptionSpec</a>&gt;&nbsp;optionSort,
@@ -427,86 +437,86 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <div class="block">Returns a Text object containing a partial detailed synopsis showing only the options, starting with a <code>" "</code> space.</div>
 </td>
 </tr>
-<tr id="i17" class="rowColor">
+<tr id="i18" class="altColor">
 <td class="colFirst"><code>protected <a href="../picocli/CommandLine.Help.Ansi.Text.html" title="class in picocli">CommandLine.Help.Ansi.Text</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#createDetailedSynopsisPositionalsText-java.util.Collection-">createDetailedSynopsisPositionalsText</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/util/Collection.html?is-external=true" title="class or interface in java.util">Collection</a>&lt;<a href="../picocli/CommandLine.Model.ArgSpec.html" title="class in picocli">CommandLine.Model.ArgSpec</a>&gt;&nbsp;done)</code>
 <div class="block">Returns a Text object containing a partial detailed synopsis showing only the positional parameters, starting with a <code>" "</code> space.</div>
 </td>
 </tr>
-<tr id="i18" class="altColor">
+<tr id="i19" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#createHeading-java.lang.String-java.lang.Object...-">createHeading</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;text,
              <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>...&nbsp;params)</code>
 <div class="block">Returns a String that can be used as a help section heading.</div>
 </td>
 </tr>
-<tr id="i19" class="rowColor">
+<tr id="i20" class="altColor">
 <td class="colFirst"><code>static <a href="../picocli/CommandLine.Help.IOptionRenderer.html" title="interface in picocli">CommandLine.Help.IOptionRenderer</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#createMinimalOptionRenderer--">createMinimalOptionRenderer</a></span>()</code>
 <div class="block">Returns a new minimal OptionRenderer which converts <a href="../picocli/CommandLine.Model.OptionSpec.html" title="class in picocli"><code>Options</code></a> to a single row with two columns
  of text: an option name and a description.</div>
 </td>
 </tr>
-<tr id="i20" class="altColor">
+<tr id="i21" class="rowColor">
 <td class="colFirst"><code>static <a href="../picocli/CommandLine.Help.IParameterRenderer.html" title="interface in picocli">CommandLine.Help.IParameterRenderer</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#createMinimalParameterRenderer--">createMinimalParameterRenderer</a></span>()</code>
 <div class="block">Returns a new minimal ParameterRenderer which converts <a href="../picocli/CommandLine.Model.PositionalParamSpec.html" title="class in picocli">positional parameters</a>
  to a single row with two columns of text: an option name and a description.</div>
 </td>
 </tr>
-<tr id="i21" class="rowColor">
+<tr id="i22" class="altColor">
 <td class="colFirst"><code>static <a href="../picocli/CommandLine.Help.IParamLabelRenderer.html" title="interface in picocli">CommandLine.Help.IParamLabelRenderer</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#createMinimalParamLabelRenderer--">createMinimalParamLabelRenderer</a></span>()</code>
 <div class="block">Returns a value renderer that returns the <code>paramLabel</code> if defined or the field name otherwise.</div>
 </td>
 </tr>
-<tr id="i22" class="altColor">
+<tr id="i23" class="rowColor">
 <td class="colFirst"><code>static <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Comparator.html?is-external=true" title="class or interface in java.util">Comparator</a>&lt;<a href="../picocli/CommandLine.Model.OptionSpec.html" title="class in picocli">CommandLine.Model.OptionSpec</a>&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#createShortOptionArityAndNameComparator--">createShortOptionArityAndNameComparator</a></span>()</code>
 <div class="block">Sorts <a href="../picocli/CommandLine.Model.OptionSpec.html" title="class in picocli"><code>OptionSpecs</code></a> by their option <a href="../picocli/CommandLine.Range.html#max">max arity</a> first, by
  <a href="../picocli/CommandLine.Range.html#min">min arity</a> next, and by <a href="../picocli/CommandLine.Help.html#createShortOptionNameComparator--">option name</a> last.</div>
 </td>
 </tr>
-<tr id="i23" class="rowColor">
+<tr id="i24" class="altColor">
 <td class="colFirst"><code>static <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Comparator.html?is-external=true" title="class or interface in java.util">Comparator</a>&lt;<a href="../picocli/CommandLine.Model.OptionSpec.html" title="class in picocli">CommandLine.Model.OptionSpec</a>&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#createShortOptionNameComparator--">createShortOptionNameComparator</a></span>()</code>
 <div class="block">Sorts <a href="../picocli/CommandLine.Model.OptionSpec.html" title="class in picocli"><code>OptionSpecs</code></a> by their option name in case-insensitive alphabetic order.</div>
 </td>
 </tr>
-<tr id="i24" class="altColor">
+<tr id="i25" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Help.TextTable.html" title="class in picocli">CommandLine.Help.TextTable</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#createTextTable-java.util.Map-">createTextTable</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;?,?&gt;&nbsp;map)</code>
 <div class="block">Returns a 2-column <code>TextTable</code> containing data from the specified map:
  the keys are put in the left column and the map values are in the right column.</div>
 </td>
 </tr>
-<tr id="i25" class="rowColor">
+<tr id="i26" class="altColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#customSynopsis-java.lang.Object...-">customSynopsis</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>...&nbsp;params)</code>
 <div class="block">Returns command custom synopsis as a string.</div>
 </td>
 </tr>
-<tr id="i26" class="altColor">
+<tr id="i27" class="rowColor">
 <td class="colFirst"><code>static <a href="../picocli/CommandLine.Help.ColorScheme.html" title="class in picocli">CommandLine.Help.ColorScheme</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#defaultColorScheme-picocli.CommandLine.Help.Ansi-">defaultColorScheme</a></span>(<a href="../picocli/CommandLine.Help.Ansi.html" title="enum in picocli">CommandLine.Help.Ansi</a>&nbsp;ansi)</code>
 <div class="block">Creates and returns a new <a href="../picocli/CommandLine.Help.ColorScheme.html" title="class in picocli"><code>CommandLine.Help.ColorScheme</code></a> initialized with picocli default values: commands are bold,
   options and parameters use a yellow foreground, and option parameters use italic.</div>
 </td>
 </tr>
-<tr id="i27" class="rowColor">
+<tr id="i28" class="altColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#description-java.lang.Object...-">description</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>...&nbsp;params)</code>
 <div class="block">Returns command description text as a string.</div>
 </td>
 </tr>
-<tr id="i28" class="altColor">
+<tr id="i29" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#descriptionHeading-java.lang.Object...-">descriptionHeading</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>...&nbsp;params)</code>
 <div class="block">Returns the text displayed before the description text; an empty string if there is no description,
  otherwise the result of <code>String.format(descriptionHeading, params)</code>.</div>
 </td>
 </tr>
-<tr id="i29" class="rowColor">
+<tr id="i30" class="altColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#detailedSynopsis-java.util.Comparator-boolean-">detailedSynopsis</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/util/Comparator.html?is-external=true" title="class or interface in java.util">Comparator</a>&lt;<a href="../picocli/CommandLine.Model.OptionSpec.html" title="class in picocli">CommandLine.Model.OptionSpec</a>&gt;&nbsp;optionSort,
                 boolean&nbsp;clusterBooleanOptions)</code>
@@ -515,7 +525,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </div>
 </td>
 </tr>
-<tr id="i30" class="altColor">
+<tr id="i31" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#detailedSynopsis-int-java.util.Comparator-boolean-">detailedSynopsis</a></span>(int&nbsp;synopsisHeadingLength,
                 <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Comparator.html?is-external=true" title="class or interface in java.util">Comparator</a>&lt;<a href="../picocli/CommandLine.Model.OptionSpec.html" title="class in picocli">CommandLine.Model.OptionSpec</a>&gt;&nbsp;optionSort,
@@ -523,56 +533,56 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <div class="block">Generates a detailed synopsis message showing all options and parameters.</div>
 </td>
 </tr>
-<tr id="i31" class="rowColor">
+<tr id="i32" class="altColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#exitCodeList--">exitCodeList</a></span>()</code>
 <div class="block">Returns a 2-column list with exit codes and their description.</div>
 </td>
 </tr>
-<tr id="i32" class="altColor">
+<tr id="i33" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#exitCodeListHeading-java.lang.Object...-">exitCodeListHeading</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>...&nbsp;params)</code>
 <div class="block">Returns the text displayed before the exit code list text; the result of <code>String.format(exitCodeHeading, params)</code>.</div>
 </td>
 </tr>
-<tr id="i33" class="rowColor">
+<tr id="i34" class="altColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#footer-java.lang.Object...-">footer</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>...&nbsp;params)</code>
 <div class="block">Returns command footer text as a string.</div>
 </td>
 </tr>
-<tr id="i34" class="altColor">
+<tr id="i35" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#footerHeading-java.lang.Object...-">footerHeading</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>...&nbsp;params)</code>
 <div class="block">Returns the text displayed before the footer text; the result of <code>String.format(footerHeading, params)</code>.</div>
 </td>
 </tr>
-<tr id="i35" class="rowColor">
+<tr id="i36" class="altColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#fullSynopsis--">fullSynopsis</a></span>()</code>
 <div class="block">Returns the full usage synopsis of this command.</div>
 </td>
 </tr>
-<tr id="i36" class="altColor">
+<tr id="i37" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#header-java.lang.Object...-">header</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>...&nbsp;params)</code>
 <div class="block">Returns the command header text as a string.</div>
 </td>
 </tr>
-<tr id="i37" class="rowColor">
+<tr id="i38" class="altColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#headerHeading-java.lang.Object...-">headerHeading</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>...&nbsp;params)</code>
 <div class="block">Returns the text displayed before the header text; the result of <code>String.format(headerHeading, params)</code>.</div>
 </td>
 </tr>
-<tr id="i38" class="altColor">
+<tr id="i39" class="rowColor">
 <td class="colFirst"><code>protected <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#insertSynopsisCommandName-int-picocli.CommandLine.Help.Ansi.Text-">insertSynopsisCommandName</a></span>(int&nbsp;synopsisHeadingLength,
                          <a href="../picocli/CommandLine.Help.Ansi.Text.html" title="class in picocli">CommandLine.Help.Ansi.Text</a>&nbsp;optionsAndPositionalsAndCommandsDetails)</code>
 <div class="block">Returns the detailed synopsis text by inserting the command name before the specified text with options and positional parameters details.</div>
 </td>
 </tr>
-<tr id="i39" class="rowColor">
+<tr id="i40" class="altColor">
 <td class="colFirst"><code>static <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/StringBuilder.html?is-external=true" title="class or interface in java.lang">StringBuilder</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#join-picocli.CommandLine.Help.Ansi-int-boolean-java.lang.String:A-java.lang.StringBuilder-java.lang.Object...-">join</a></span>(<a href="../picocli/CommandLine.Help.Ansi.html" title="enum in picocli">CommandLine.Help.Ansi</a>&nbsp;ansi,
     int&nbsp;usageHelpWidth,
@@ -583,7 +593,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <div class="block">Formats each of the specified values and appends it to the specified StringBuilder.</div>
 </td>
 </tr>
-<tr id="i40" class="altColor">
+<tr id="i41" class="rowColor">
 <td class="colFirst"><code>static <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/StringBuilder.html?is-external=true" title="class or interface in java.lang">StringBuilder</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#join-picocli.CommandLine.Help.Ansi-int-java.lang.String:A-java.lang.StringBuilder-java.lang.Object...-">join</a></span>(<a href="../picocli/CommandLine.Help.Ansi.html" title="enum in picocli">CommandLine.Help.Ansi</a>&nbsp;ansi,
     int&nbsp;usageHelpWidth,
@@ -595,13 +605,13 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </div>
 </td>
 </tr>
-<tr id="i41" class="rowColor">
+<tr id="i42" class="altColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#optionList--">optionList</a></span>()</code>
 <div class="block">Returns a description of the <a href="../picocli/CommandLine.Option.html" title="annotation in picocli">options</a> supported by the application.</div>
 </td>
 </tr>
-<tr id="i42" class="altColor">
+<tr id="i43" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#optionList-picocli.CommandLine.Help.Layout-java.util.Comparator-picocli.CommandLine.Help.IParamLabelRenderer-">optionList</a></span>(<a href="../picocli/CommandLine.Help.Layout.html" title="class in picocli">CommandLine.Help.Layout</a>&nbsp;layout,
           <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Comparator.html?is-external=true" title="class or interface in java.util">Comparator</a>&lt;<a href="../picocli/CommandLine.Model.OptionSpec.html" title="class in picocli">CommandLine.Model.OptionSpec</a>&gt;&nbsp;optionSort,
@@ -611,52 +621,52 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
  specified TextTable and returns the result of TextTable.toString().</div>
 </td>
 </tr>
-<tr id="i43" class="rowColor">
+<tr id="i44" class="altColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#optionListHeading-java.lang.Object...-">optionListHeading</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>...&nbsp;params)</code>
 <div class="block">Returns the text displayed before the option list; an empty string if there are no options,
  otherwise the result of <code>String.format(optionListHeading, params)</code>.</div>
 </td>
 </tr>
-<tr id="i44" class="altColor">
+<tr id="i45" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Help.IParamLabelRenderer.html" title="interface in picocli">CommandLine.Help.IParamLabelRenderer</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#parameterLabelRenderer--">parameterLabelRenderer</a></span>()</code>
 <div class="block">Option and positional parameter value label renderer used for the synopsis line(s) and the option list.</div>
 </td>
 </tr>
-<tr id="i45" class="rowColor">
+<tr id="i46" class="altColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#parameterList--">parameterList</a></span>()</code>
 <div class="block">Returns the section of the usage help message that lists the parameters with their descriptions.</div>
 </td>
 </tr>
-<tr id="i46" class="altColor">
+<tr id="i47" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#parameterList-picocli.CommandLine.Help.Layout-picocli.CommandLine.Help.IParamLabelRenderer-">parameterList</a></span>(<a href="../picocli/CommandLine.Help.Layout.html" title="class in picocli">CommandLine.Help.Layout</a>&nbsp;layout,
              <a href="../picocli/CommandLine.Help.IParamLabelRenderer.html" title="interface in picocli">CommandLine.Help.IParamLabelRenderer</a>&nbsp;paramLabelRenderer)</code>
 <div class="block">Returns the section of the usage help message that lists the parameters with their descriptions.</div>
 </td>
 </tr>
-<tr id="i47" class="rowColor">
+<tr id="i48" class="altColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#parameterListHeading-java.lang.Object...-">parameterListHeading</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>...&nbsp;params)</code>
 <div class="block">Returns the text displayed before the positional parameter list; an empty string if there are no positional
  parameters, otherwise the result of <code>String.format(parameterListHeading, params)</code>.</div>
 </td>
 </tr>
-<tr id="i48" class="altColor">
+<tr id="i49" class="rowColor">
 <td class="colFirst"><code>static <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Comparator.html?is-external=true" title="class or interface in java.util">Comparator</a>&lt;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#shortestFirst--">shortestFirst</a></span>()</code>
 <div class="block">Sorts short strings before longer strings.</div>
 </td>
 </tr>
-<tr id="i49" class="rowColor">
-<td class="colFirst"><code>protected <a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>,<a href="../picocli/CommandLine.Help.html" title="class in picocli">CommandLine.Help</a>&gt;</code></td>
+<tr id="i50" class="altColor">
+<td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>,<a href="../picocli/CommandLine.Help.html" title="class in picocli">CommandLine.Help</a>&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#subcommands--">subcommands</a></span>()</code>
 <div class="block">Returns the map of subcommand <code>Help</code> instances for this command Help.</div>
 </td>
 </tr>
-<tr id="i50" class="altColor">
+<tr id="i51" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#synopsis--">synopsis</a></span>()</code>
 <div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;
@@ -664,19 +674,19 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </div>
 </td>
 </tr>
-<tr id="i51" class="rowColor">
+<tr id="i52" class="altColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#synopsis-int-">synopsis</a></span>(int&nbsp;synopsisHeadingLength)</code>
 <div class="block">Returns a synopsis for the command, reserving the specified space for the synopsis heading.</div>
 </td>
 </tr>
-<tr id="i52" class="altColor">
+<tr id="i53" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#synopsisHeading-java.lang.Object...-">synopsisHeading</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>...&nbsp;params)</code>
 <div class="block">Returns the text displayed before the synopsis text; the result of <code>String.format(synopsisHeading, params)</code>.</div>
 </td>
 </tr>
-<tr id="i53" class="rowColor">
+<tr id="i54" class="altColor">
 <td class="colFirst"><code>int</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Help.html#synopsisHeadingLength--">synopsisHeadingLength</a></span>()</code>
 <div class="block">Returns the number of characters the synopsis heading will take on the same line as the synopsis.</div>
@@ -721,7 +731,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <a name="DEFAULT_SEPARATOR">
 <!--   -->
 </a>
-<ul class="blockListLast">
+<ul class="blockList">
 <li class="blockList">
 <h4>DEFAULT_SEPARATOR</h4>
 <pre>protected static final&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> DEFAULT_SEPARATOR</pre>
@@ -732,6 +742,15 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </dl>
 </li>
 </ul>
+<a name="AT_FILE_POSITIONAL_PARAM">
+<!--   -->
+</a>
+<ul class="blockListLast">
+<li class="blockList">
+<h4>AT_FILE_POSITIONAL_PARAM</h4>
+<pre>public final&nbsp;<a href="../picocli/CommandLine.Model.PositionalParamSpec.html" title="class in picocli">CommandLine.Model.PositionalParamSpec</a> AT_FILE_POSITIONAL_PARAM</pre>
+</li>
+</ul>
 </li>
 </ul>
 <!-- ========= CONSTRUCTOR DETAIL ======== -->
@@ -747,7 +766,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <li class="blockList">
 <h4>Help</h4>
 <pre>public&nbsp;Help(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;command)</pre>
-<div class="block">Constructs a new <code>Help</code> instance with a default color scheme, initialized from annotatations
+<div class="block">Constructs a new <code>Help</code> instance with a default color scheme, initialized from annotations
  on the specified class and superclasses.</div>
 <dl>
 <dt><span class="paramLabel">Parameters:</span></dt>
@@ -763,7 +782,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <h4>Help</h4>
 <pre>public&nbsp;Help(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;command,
             <a href="../picocli/CommandLine.Help.Ansi.html" title="enum in picocli">CommandLine.Help.Ansi</a>&nbsp;ansi)</pre>
-<div class="block">Constructs a new <code>Help</code> instance with a default color scheme, initialized from annotatations
+<div class="block">Constructs a new <code>Help</code> instance with a default color scheme, initialized from annotations
  on the specified class and superclasses.</div>
 <dl>
 <dt><span class="paramLabel">Parameters:</span></dt>
@@ -782,7 +801,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 public&nbsp;Help(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;command,
                          <a href="../picocli/CommandLine.Help.ColorScheme.html" title="class in picocli">CommandLine.Help.ColorScheme</a>&nbsp;colorScheme)</pre>
 <div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;<span class="deprecationComment">use <code>picocli.CommandLine.Help#Help(picocli.CommandLine.Model.CommandSpec, picocli.CommandLine.Help.ColorScheme)</code></span></div>
-<div class="block">Constructs a new <code>Help</code> instance with the specified color scheme, initialized from annotatations
+<div class="block">Constructs a new <code>Help</code> instance with the specified color scheme, initialized from annotations
  on the specified class and superclasses.</div>
 <dl>
 <dt><span class="paramLabel">Parameters:</span></dt>
@@ -799,7 +818,7 @@ public&nbsp;Help(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Ob
 <h4>Help</h4>
 <pre>public&nbsp;Help(<a href="../picocli/CommandLine.Model.CommandSpec.html" title="class in picocli">CommandLine.Model.CommandSpec</a>&nbsp;commandSpec,
             <a href="../picocli/CommandLine.Help.ColorScheme.html" title="class in picocli">CommandLine.Help.ColorScheme</a>&nbsp;colorScheme)</pre>
-<div class="block">Constructs a new <code>Help</code> instance with the specified color scheme, initialized from annotatations
+<div class="block">Constructs a new <code>Help</code> instance with the specified color scheme, initialized from annotations
  on the specified class and superclasses.</div>
 <dl>
 <dt><span class="paramLabel">Parameters:</span></dt>
@@ -850,7 +869,7 @@ public&nbsp;Help(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Ob
 <ul class="blockList">
 <li class="blockList">
 <h4>subcommands</h4>
-<pre>protected&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>,<a href="../picocli/CommandLine.Help.html" title="class in picocli">CommandLine.Help</a>&gt;&nbsp;subcommands()</pre>
+<pre>public&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>,<a href="../picocli/CommandLine.Help.html" title="class in picocli">CommandLine.Help</a>&gt;&nbsp;subcommands()</pre>
 <div class="block">Returns the map of subcommand <code>Help</code> instances for this command Help.</div>
 <dl>
 <dt><span class="simpleTagLabel">Since:</span></dt>
@@ -1225,6 +1244,20 @@ public&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.
 </dl>
 </li>
 </ul>
+<a name="atFileParameterList--">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>atFileParameterList</h4>
+<pre>public&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;atFileParameterList()</pre>
+<div class="block">Returns the section of the usage help message that lists the @-file and its description.</div>
+<dl>
+<dt><span class="returnLabel">Returns:</span></dt>
+<dd>the section of the usage help message that lists the @-file and its description</dd>
+</dl>
+</li>
+</ul>
 <a name="join-picocli.CommandLine.Help.Ansi-int-java.lang.String:A-java.lang.StringBuilder-java.lang.Object...-">
 <!--   -->
 </a>
diff --git a/docs/apidocs/picocli/CommandLine.HelpCommand.html b/docs/apidocs/picocli/CommandLine.HelpCommand.html
index d1ce44ae..9cb00bd5 100644
--- a/docs/apidocs/picocli/CommandLine.HelpCommand.html
+++ b/docs/apidocs/picocli/CommandLine.HelpCommand.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.HelpCommand (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.HelpCommand (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.HelpCommand (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.HelpCommand (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.IDefaultValueProvider.html b/docs/apidocs/picocli/CommandLine.IDefaultValueProvider.html
index f129dd07..0444ac66 100644
--- a/docs/apidocs/picocli/CommandLine.IDefaultValueProvider.html
+++ b/docs/apidocs/picocli/CommandLine.IDefaultValueProvider.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.IDefaultValueProvider (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.IDefaultValueProvider (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.IDefaultValueProvider (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.IDefaultValueProvider (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.IExceptionHandler.html b/docs/apidocs/picocli/CommandLine.IExceptionHandler.html
index 3584bac2..7173aaaf 100644
--- a/docs/apidocs/picocli/CommandLine.IExceptionHandler.html
+++ b/docs/apidocs/picocli/CommandLine.IExceptionHandler.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.IExceptionHandler (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.IExceptionHandler (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.IExceptionHandler (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.IExceptionHandler (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.IExceptionHandler2.html b/docs/apidocs/picocli/CommandLine.IExceptionHandler2.html
index 0181f4d2..0306bb4a 100644
--- a/docs/apidocs/picocli/CommandLine.IExceptionHandler2.html
+++ b/docs/apidocs/picocli/CommandLine.IExceptionHandler2.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.IExceptionHandler2 (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.IExceptionHandler2 (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.IExceptionHandler2 (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.IExceptionHandler2 (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.IExecutionExceptionHandler.html b/docs/apidocs/picocli/CommandLine.IExecutionExceptionHandler.html
index 37fb35ec..97099333 100644
--- a/docs/apidocs/picocli/CommandLine.IExecutionExceptionHandler.html
+++ b/docs/apidocs/picocli/CommandLine.IExecutionExceptionHandler.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.IExecutionExceptionHandler (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.IExecutionExceptionHandler (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.IExecutionExceptionHandler (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.IExecutionExceptionHandler (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.IExecutionStrategy.html b/docs/apidocs/picocli/CommandLine.IExecutionStrategy.html
index a5dd2be4..ceb3892f 100644
--- a/docs/apidocs/picocli/CommandLine.IExecutionStrategy.html
+++ b/docs/apidocs/picocli/CommandLine.IExecutionStrategy.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.IExecutionStrategy (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.IExecutionStrategy (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.IExecutionStrategy (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.IExecutionStrategy (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.IExitCodeExceptionMapper.html b/docs/apidocs/picocli/CommandLine.IExitCodeExceptionMapper.html
index f35dc183..933d3f85 100644
--- a/docs/apidocs/picocli/CommandLine.IExitCodeExceptionMapper.html
+++ b/docs/apidocs/picocli/CommandLine.IExitCodeExceptionMapper.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.IExitCodeExceptionMapper (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.IExitCodeExceptionMapper (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.IExitCodeExceptionMapper (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.IExitCodeExceptionMapper (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.IExitCodeGenerator.html b/docs/apidocs/picocli/CommandLine.IExitCodeGenerator.html
index 624cc05d..10941538 100644
--- a/docs/apidocs/picocli/CommandLine.IExitCodeGenerator.html
+++ b/docs/apidocs/picocli/CommandLine.IExitCodeGenerator.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.IExitCodeGenerator (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.IExitCodeGenerator (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.IExitCodeGenerator (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.IExitCodeGenerator (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.IFactory.html b/docs/apidocs/picocli/CommandLine.IFactory.html
index 7b76f941..7da6081b 100644
--- a/docs/apidocs/picocli/CommandLine.IFactory.html
+++ b/docs/apidocs/picocli/CommandLine.IFactory.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.IFactory (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.IFactory (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.IFactory (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.IFactory (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.IHelpCommandInitializable.html b/docs/apidocs/picocli/CommandLine.IHelpCommandInitializable.html
index 79809ab5..faecd405 100644
--- a/docs/apidocs/picocli/CommandLine.IHelpCommandInitializable.html
+++ b/docs/apidocs/picocli/CommandLine.IHelpCommandInitializable.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.IHelpCommandInitializable (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.IHelpCommandInitializable (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.IHelpCommandInitializable (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.IHelpCommandInitializable (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.IHelpCommandInitializable2.html b/docs/apidocs/picocli/CommandLine.IHelpCommandInitializable2.html
index 177faebe..69763c79 100644
--- a/docs/apidocs/picocli/CommandLine.IHelpCommandInitializable2.html
+++ b/docs/apidocs/picocli/CommandLine.IHelpCommandInitializable2.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.IHelpCommandInitializable2 (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.IHelpCommandInitializable2 (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.IHelpCommandInitializable2 (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.IHelpCommandInitializable2 (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.IHelpFactory.html b/docs/apidocs/picocli/CommandLine.IHelpFactory.html
index f2c42256..81e8e7c9 100644
--- a/docs/apidocs/picocli/CommandLine.IHelpFactory.html
+++ b/docs/apidocs/picocli/CommandLine.IHelpFactory.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.IHelpFactory (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.IHelpFactory (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.IHelpFactory (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.IHelpFactory (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.IHelpSectionRenderer.html b/docs/apidocs/picocli/CommandLine.IHelpSectionRenderer.html
index b8083eb4..b96176b4 100644
--- a/docs/apidocs/picocli/CommandLine.IHelpSectionRenderer.html
+++ b/docs/apidocs/picocli/CommandLine.IHelpSectionRenderer.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.IHelpSectionRenderer (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.IHelpSectionRenderer (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.IHelpSectionRenderer (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.IHelpSectionRenderer (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.INegatableOptionTransformer.html b/docs/apidocs/picocli/CommandLine.INegatableOptionTransformer.html
index 7c68974a..8d5dadd7 100644
--- a/docs/apidocs/picocli/CommandLine.INegatableOptionTransformer.html
+++ b/docs/apidocs/picocli/CommandLine.INegatableOptionTransformer.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.INegatableOptionTransformer (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.INegatableOptionTransformer (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.INegatableOptionTransformer (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.INegatableOptionTransformer (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.IParameterConsumer.html b/docs/apidocs/picocli/CommandLine.IParameterConsumer.html
index 514c1d89..3b4c3a48 100644
--- a/docs/apidocs/picocli/CommandLine.IParameterConsumer.html
+++ b/docs/apidocs/picocli/CommandLine.IParameterConsumer.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.IParameterConsumer (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.IParameterConsumer (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.IParameterConsumer (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.IParameterConsumer (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.IParameterExceptionHandler.html b/docs/apidocs/picocli/CommandLine.IParameterExceptionHandler.html
index ba9bd424..bca95f85 100644
--- a/docs/apidocs/picocli/CommandLine.IParameterExceptionHandler.html
+++ b/docs/apidocs/picocli/CommandLine.IParameterExceptionHandler.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.IParameterExceptionHandler (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.IParameterExceptionHandler (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.IParameterExceptionHandler (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.IParameterExceptionHandler (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.IParseResultHandler.html b/docs/apidocs/picocli/CommandLine.IParseResultHandler.html
index e8476bd8..43601128 100644
--- a/docs/apidocs/picocli/CommandLine.IParseResultHandler.html
+++ b/docs/apidocs/picocli/CommandLine.IParseResultHandler.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.IParseResultHandler (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.IParseResultHandler (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.IParseResultHandler (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.IParseResultHandler (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.IParseResultHandler2.html b/docs/apidocs/picocli/CommandLine.IParseResultHandler2.html
index b31cefb7..000c2c6f 100644
--- a/docs/apidocs/picocli/CommandLine.IParseResultHandler2.html
+++ b/docs/apidocs/picocli/CommandLine.IParseResultHandler2.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.IParseResultHandler2 (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.IParseResultHandler2 (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.IParseResultHandler2 (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.IParseResultHandler2 (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.ITypeConverter.html b/docs/apidocs/picocli/CommandLine.ITypeConverter.html
index 5ae9ef13..d16041d8 100644
--- a/docs/apidocs/picocli/CommandLine.ITypeConverter.html
+++ b/docs/apidocs/picocli/CommandLine.ITypeConverter.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.ITypeConverter (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.ITypeConverter (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.ITypeConverter (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.ITypeConverter (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.IVersionProvider.html b/docs/apidocs/picocli/CommandLine.IVersionProvider.html
index 28abd96a..8294e04b 100644
--- a/docs/apidocs/picocli/CommandLine.IVersionProvider.html
+++ b/docs/apidocs/picocli/CommandLine.IVersionProvider.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.IVersionProvider (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.IVersionProvider (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.IVersionProvider (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.IVersionProvider (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.InitializationException.html b/docs/apidocs/picocli/CommandLine.InitializationException.html
index d37f94ed..2d187ff7 100644
--- a/docs/apidocs/picocli/CommandLine.InitializationException.html
+++ b/docs/apidocs/picocli/CommandLine.InitializationException.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.InitializationException (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.InitializationException (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.InitializationException (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.InitializationException (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.MaxValuesExceededException.html b/docs/apidocs/picocli/CommandLine.MaxValuesExceededException.html
index c1490edb..b5ffb46a 100644
--- a/docs/apidocs/picocli/CommandLine.MaxValuesExceededException.html
+++ b/docs/apidocs/picocli/CommandLine.MaxValuesExceededException.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.MaxValuesExceededException (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.MaxValuesExceededException (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.MaxValuesExceededException (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.MaxValuesExceededException (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.MissingParameterException.html b/docs/apidocs/picocli/CommandLine.MissingParameterException.html
index 5f9a7921..2ee617f6 100644
--- a/docs/apidocs/picocli/CommandLine.MissingParameterException.html
+++ b/docs/apidocs/picocli/CommandLine.MissingParameterException.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.MissingParameterException (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.MissingParameterException (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.MissingParameterException (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.MissingParameterException (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.MissingTypeConverterException.html b/docs/apidocs/picocli/CommandLine.MissingTypeConverterException.html
index a7bfd699..ce4731b7 100644
--- a/docs/apidocs/picocli/CommandLine.MissingTypeConverterException.html
+++ b/docs/apidocs/picocli/CommandLine.MissingTypeConverterException.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.MissingTypeConverterException (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.MissingTypeConverterException (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.MissingTypeConverterException (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.MissingTypeConverterException (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Mixin.html b/docs/apidocs/picocli/CommandLine.Mixin.html
index e3ee7b88..cd8c9c24 100644
--- a/docs/apidocs/picocli/CommandLine.Mixin.html
+++ b/docs/apidocs/picocli/CommandLine.Mixin.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine.Mixin (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Mixin (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Mixin (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Mixin (picocli 4.2.0 API)";
         }
     }
     catch(err) {
@@ -103,11 +103,12 @@ public static @interface <span class="memberNameLabel">CommandLine.Mixin</span><
  </p><p>
  The <code>Mixin</code> annotation provides a way to reuse common options and parameters without subclassing. For example:
  </p><pre>
+ &#064;Command(name="HelloWorld")
  class HelloWorld implements Runnable {
 
      // adds the --help and --version options to this command
      &#064;Mixin
-     private HelpOptions = new HelpOptions();
+     private HelpOptions options = new HelpOptions();
 
      &#064;Option(names = {"-u", "--userName"}, required = true, description = "The user name")
      String userName;
diff --git a/docs/apidocs/picocli/CommandLine.Model.ArgGroupSpec.Builder.html b/docs/apidocs/picocli/CommandLine.Model.ArgGroupSpec.Builder.html
index 1bc9d306..ce102b2c 100644
--- a/docs/apidocs/picocli/CommandLine.Model.ArgGroupSpec.Builder.html
+++ b/docs/apidocs/picocli/CommandLine.Model.ArgGroupSpec.Builder.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.Model.ArgGroupSpec.Builder (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Model.ArgGroupSpec.Builder (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Model.ArgGroupSpec.Builder (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Model.ArgGroupSpec.Builder (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Model.ArgGroupSpec.html b/docs/apidocs/picocli/CommandLine.Model.ArgGroupSpec.html
index f92bec05..efa32c5b 100644
--- a/docs/apidocs/picocli/CommandLine.Model.ArgGroupSpec.html
+++ b/docs/apidocs/picocli/CommandLine.Model.ArgGroupSpec.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.Model.ArgGroupSpec (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Model.ArgGroupSpec (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Model.ArgGroupSpec (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Model.ArgGroupSpec (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Model.ArgSpec.html b/docs/apidocs/picocli/CommandLine.Model.ArgSpec.html
index 21d2605a..bb28876a 100644
--- a/docs/apidocs/picocli/CommandLine.Model.ArgSpec.html
+++ b/docs/apidocs/picocli/CommandLine.Model.ArgSpec.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.Model.ArgSpec (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Model.ArgSpec (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Model.ArgSpec (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Model.ArgSpec (picocli 4.2.0 API)";
         }
     }
     catch(err) {
@@ -523,7 +523,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
  including the <code>${DEFAULT-VALUE}</code> and <code>${COMPLETION-CANDIDATES}</code> variables.
  Use <a href="../picocli/CommandLine.Model.CommandSpec.html#interpolateVariables-java.lang.Boolean-"><code>CommandLine.Model.CommandSpec.interpolateVariables(Boolean)</code></a> to switch off variable expansion if needed.
  <p>
- If a resource bundle has been set, this method will first try to find a value in the resource bundle:
+ If a resource bundle has been <a href="../picocli/CommandLine.Model.ArgSpec.html#messages-picocli.CommandLine.Model.Messages-">set</a>, this method will first try to find a value in the resource bundle:
  If the resource bundle has no entry for the <code>fully qualified commandName + "." + descriptionKey</code> or for the unqualified <code>descriptionKey</code>,
  an attempt is made to find the option or positional parameter description using any of the
  <a href="../picocli/CommandLine.Model.ArgSpec.html#getAdditionalDescriptionKeys--">additional description keys</a>, first with the <code>fully qualified commandName + "."</code> prefix, then without.
diff --git a/docs/apidocs/picocli/CommandLine.Model.CommandSpec.html b/docs/apidocs/picocli/CommandLine.Model.CommandSpec.html
index f2f2136a..f357e8c4 100644
--- a/docs/apidocs/picocli/CommandLine.Model.CommandSpec.html
+++ b/docs/apidocs/picocli/CommandLine.Model.CommandSpec.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.Model.CommandSpec (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Model.CommandSpec (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,13 +12,13 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Model.CommandSpec (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Model.CommandSpec (picocli 4.2.0 API)";
         }
     }
     catch(err) {
     }
 //-->
-var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10,"i11":10,"i12":10,"i13":10,"i14":10,"i15":10,"i16":10,"i17":10,"i18":10,"i19":9,"i20":10,"i21":10,"i22":10,"i23":10,"i24":10,"i25":10,"i26":10,"i27":10,"i28":10,"i29":10,"i30":10,"i31":10,"i32":10,"i33":10,"i34":9,"i35":9,"i36":9,"i37":9,"i38":10,"i39":10,"i40":10,"i41":10,"i42":10,"i43":10,"i44":10,"i45":10,"i46":10,"i47":10,"i48":10,"i49":10,"i50":10,"i51":10,"i52":10,"i53":10,"i54":10,"i55":10,"i56":10,"i57":10,"i58":10,"i59":10,"i60":10,"i61":10,"i62":10,"i63":10,"i64":10,"i65":10,"i66":10,"i67":10,"i68":10,"i69":10,"i70":10,"i71":10,"i72":10,"i73":10,"i74":10,"i75":10,"i76":10,"i77":10,"i78":10,"i79":10,"i80":10,"i81":10,"i82":10,"i83":10,"i84":9};
+var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10,"i11":10,"i12":10,"i13":10,"i14":10,"i15":10,"i16":10,"i17":10,"i18":10,"i19":9,"i20":10,"i21":10,"i22":10,"i23":10,"i24":10,"i25":10,"i26":10,"i27":10,"i28":10,"i29":10,"i30":10,"i31":10,"i32":10,"i33":10,"i34":9,"i35":9,"i36":9,"i37":9,"i38":10,"i39":10,"i40":10,"i41":10,"i42":10,"i43":10,"i44":10,"i45":10,"i46":10,"i47":10,"i48":10,"i49":10,"i50":10,"i51":10,"i52":10,"i53":10,"i54":10,"i55":10,"i56":10,"i57":10,"i58":10,"i59":10,"i60":10,"i61":10,"i62":10,"i63":10,"i64":10,"i65":10,"i66":10,"i67":10,"i68":10,"i69":10,"i70":10,"i71":10,"i72":10,"i73":10,"i74":10,"i75":10,"i76":10,"i77":10,"i78":10,"i79":10,"i80":10,"i81":10,"i82":10,"i83":10,"i84":10,"i85":10,"i86":9,"i87":9};
 var tabs = {65535:["t0","All Methods"],1:["t1","Static Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]};
 var altColor = "altColor";
 var rowColor = "rowColor";
@@ -586,9 +586,9 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <tr id="i67" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Model.CommandSpec.html" title="class in picocli">CommandLine.Model.CommandSpec</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.CommandSpec.html#resourceBundle-java.util.ResourceBundle-">resourceBundle</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/util/ResourceBundle.html?is-external=true" title="class or interface in java.util">ResourceBundle</a>&nbsp;bundle)</code>
-<div class="block">Initializes the resource bundle for this command: sets the <code>UsageMessageSpec.messages</code> to
+<div class="block">Initializes the resource bundle for this command: sets the <a href="../picocli/CommandLine.Model.UsageMessageSpec.html#messages-picocli.CommandLine.Model.Messages-"><code>UsageMessageSpec.messages</code></a> to
  a <a href="../picocli/CommandLine.Model.Messages.html" title="class in picocli"><code>Messages</code></a> object created from this command spec and the specified bundle, and then sets the
- <code>ArgSpec.messages</code> of all options and positional parameters in this command
+ <a href="../picocli/CommandLine.Model.ArgSpec.html#messages-picocli.CommandLine.Model.Messages-"><code>ArgSpec.messages</code></a> of all options and positional parameters in this command
  to the same <code>Messages</code> instance.</div>
 </td>
 </tr>
@@ -601,9 +601,9 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <tr id="i69" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Model.CommandSpec.html" title="class in picocli">CommandLine.Model.CommandSpec</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.CommandSpec.html#resourceBundleBaseName-java.lang.String-">resourceBundleBaseName</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;resourceBundleBaseName)</code>
-<div class="block">Initializes the resource bundle for this command: sets the <code>UsageMessageSpec.messages</code> to
+<div class="block">Initializes the resource bundle for this command: sets the <a href="../picocli/CommandLine.Model.UsageMessageSpec.html#messages-picocli.CommandLine.Model.Messages-"><code>UsageMessageSpec.messages</code></a> to
  a <a href="../picocli/CommandLine.Model.Messages.html" title="class in picocli"><code>Messages</code></a> object created from this command spec and the specified bundle, and then sets the
- <code>ArgSpec.messages</code> of all options and positional parameters in this command
+ <a href="../picocli/CommandLine.Model.ArgSpec.html#messages-picocli.CommandLine.Model.Messages-"><code>ArgSpec.messages</code></a> of all options and positional parameters in this command
  to the same <code>Messages</code> instance.</div>
 </td>
 </tr>
@@ -626,19 +626,33 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </td>
 </tr>
 <tr id="i73" class="rowColor">
+<td class="colFirst"><code>boolean</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.CommandSpec.html#subcommandsRepeatable--">subcommandsRepeatable</a></span>()</code>
+<div class="block">Returns whether the subcommands of this command are repeatable, that is, whether such subcommands can
+ occur multiple times and may be followed by sibling commands instead of just child commands.</div>
+</td>
+</tr>
+<tr id="i74" class="altColor">
+<td class="colFirst"><code><a href="../picocli/CommandLine.Model.CommandSpec.html" title="class in picocli">CommandLine.Model.CommandSpec</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.CommandSpec.html#subcommandsRepeatable-boolean-">subcommandsRepeatable</a></span>(boolean&nbsp;subcommandsRepeatable)</code>
+<div class="block">Sets whether the subcommands of this command are repeatable, that is, whether such subcommands can
+ occur multiple times and may be followed by sibling commands instead of just child commands.</div>
+</td>
+</tr>
+<tr id="i75" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.CommandSpec.html#toString--">toString</a></span>()</code>
 <div class="block">Returns a string representation of this command, used in error messages and trace messages.</div>
 </td>
 </tr>
-<tr id="i74" class="altColor">
+<tr id="i76" class="altColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;<a href="../picocli/CommandLine.Model.UnmatchedArgsBinding.html" title="class in picocli">CommandLine.Model.UnmatchedArgsBinding</a>&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.CommandSpec.html#unmatchedArgsBindings--">unmatchedArgsBindings</a></span>()</code>
 <div class="block">Returns the list of <a href="../picocli/CommandLine.Model.UnmatchedArgsBinding.html" title="class in picocli"><code>UnmatchedArgumentsBindings</code></a> configured for this command;
  each <code>UnmatchedArgsBinding</code> captures the arguments that could not be matched to any options or positional parameters.</div>
 </td>
 </tr>
-<tr id="i75" class="rowColor">
+<tr id="i77" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.CommandSpec.html#updateCommandAttributes-picocli.CommandLine.Command-picocli.CommandLine.IFactory-">updateCommandAttributes</a></span>(<a href="../picocli/CommandLine.Command.html" title="annotation in picocli">CommandLine.Command</a>&nbsp;cmd,
                        <a href="../picocli/CommandLine.IFactory.html" title="interface in picocli">CommandLine.IFactory</a>&nbsp;factory)</code>
@@ -647,62 +661,69 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
  version provider, default provider and <a href="../picocli/CommandLine.Model.UsageMessageSpec.html" title="class in picocli"><code>usage message spec</code></a>.</div>
 </td>
 </tr>
-<tr id="i76" class="altColor">
+<tr id="i78" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Model.UsageMessageSpec.html" title="class in picocli">CommandLine.Model.UsageMessageSpec</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.CommandSpec.html#usageMessage--">usageMessage</a></span>()</code>
 <div class="block">Returns the usage help message specification for this command.</div>
 </td>
 </tr>
-<tr id="i77" class="rowColor">
+<tr id="i79" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Model.CommandSpec.html" title="class in picocli">CommandLine.Model.CommandSpec</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.CommandSpec.html#usageMessage-picocli.CommandLine.Model.UsageMessageSpec-">usageMessage</a></span>(<a href="../picocli/CommandLine.Model.UsageMessageSpec.html" title="class in picocli">CommandLine.Model.UsageMessageSpec</a>&nbsp;settings)</code>
 <div class="block">Initializes the usageMessage specification for this command from the specified settings and returns this commandSpec.</div>
 </td>
 </tr>
-<tr id="i78" class="altColor">
+<tr id="i80" class="altColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.CommandSpec.html#userObject--">userObject</a></span>()</code>
 <div class="block">Returns the user object associated with this command.</div>
 </td>
 </tr>
-<tr id="i79" class="rowColor">
+<tr id="i81" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>[]</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.CommandSpec.html#version--">version</a></span>()</code>
 <div class="block">Returns version information for this command, to print to the console when the user specifies an
  <a href="../picocli/CommandLine.Model.OptionSpec.html#versionHelp--">option</a> to request version help.</div>
 </td>
 </tr>
-<tr id="i80" class="altColor">
+<tr id="i82" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Model.CommandSpec.html" title="class in picocli">CommandLine.Model.CommandSpec</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.CommandSpec.html#version-java.lang.String...-">version</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>...&nbsp;version)</code>
 <div class="block">Sets version information literals for this command, to print to the console when the user specifies an
  <a href="../picocli/CommandLine.Model.OptionSpec.html#versionHelp--">option</a> to request version help.</div>
 </td>
 </tr>
-<tr id="i81" class="rowColor">
+<tr id="i83" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.IVersionProvider.html" title="interface in picocli">CommandLine.IVersionProvider</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.CommandSpec.html#versionProvider--">versionProvider</a></span>()</code>
 <div class="block">Returns the version provider for this command, to generate the <a href="../picocli/CommandLine.Model.CommandSpec.html#version--"><code>version()</code></a> strings.</div>
 </td>
 </tr>
-<tr id="i82" class="altColor">
+<tr id="i84" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Model.CommandSpec.html" title="class in picocli">CommandLine.Model.CommandSpec</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.CommandSpec.html#versionProvider-picocli.CommandLine.IVersionProvider-">versionProvider</a></span>(<a href="../picocli/CommandLine.IVersionProvider.html" title="interface in picocli">CommandLine.IVersionProvider</a>&nbsp;versionProvider)</code>
 <div class="block">Sets version provider for this command, to generate the <a href="../picocli/CommandLine.Model.CommandSpec.html#version--"><code>version()</code></a> strings.</div>
 </td>
 </tr>
-<tr id="i83" class="rowColor">
+<tr id="i85" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Model.CommandSpec.html" title="class in picocli">CommandLine.Model.CommandSpec</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.CommandSpec.html#withToString-java.lang.String-">withToString</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;newValue)</code>
 <div class="block">Sets the string representation of this command, used in error messages and trace messages.</div>
 </td>
 </tr>
-<tr id="i84" class="altColor">
+<tr id="i86" class="altColor">
 <td class="colFirst"><code>static <a href="../picocli/CommandLine.Model.CommandSpec.html" title="class in picocli">CommandLine.Model.CommandSpec</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.CommandSpec.html#wrapWithoutInspection-java.lang.Object-">wrapWithoutInspection</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;userObject)</code>
 <div class="block">Creates and returns a new <code>CommandSpec</code> with the specified associated user object.</div>
 </td>
 </tr>
+<tr id="i87" class="rowColor">
+<td class="colFirst"><code>static <a href="../picocli/CommandLine.Model.CommandSpec.html" title="class in picocli">CommandLine.Model.CommandSpec</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.CommandSpec.html#wrapWithoutInspection-java.lang.Object-picocli.CommandLine.IFactory-">wrapWithoutInspection</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;userObject,
+                     <a href="../picocli/CommandLine.IFactory.html" title="interface in picocli">CommandLine.IFactory</a>&nbsp;factory)</code>
+<div class="block">Creates and returns a new <code>CommandSpec</code> with the specified associated user object.</div>
+</td>
+</tr>
 </table>
 <ul class="blockList">
 <li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
@@ -774,6 +795,25 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </dl>
 </li>
 </ul>
+<a name="wrapWithoutInspection-java.lang.Object-picocli.CommandLine.IFactory-">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>wrapWithoutInspection</h4>
+<pre>public static&nbsp;<a href="../picocli/CommandLine.Model.CommandSpec.html" title="class in picocli">CommandLine.Model.CommandSpec</a>&nbsp;wrapWithoutInspection(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;userObject,
+                                                                  <a href="../picocli/CommandLine.IFactory.html" title="interface in picocli">CommandLine.IFactory</a>&nbsp;factory)</pre>
+<div class="block">Creates and returns a new <code>CommandSpec</code> with the specified associated user object.
+ The specified user object is <em>not</em> inspected for annotations.</div>
+<dl>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>userObject</code> - the associated user object. May be any object, may be <code>null</code>.</dd>
+<dd><code>factory</code> - the factory used to create instances of <a href="../picocli/CommandLine.Command.html#subcommands--">subcommands</a>, <a href="../picocli/CommandLine.Option.html#converter--">converters</a>, etc., that are registered declaratively with annotation attributes</dd>
+<dt><span class="simpleTagLabel">Since:</span></dt>
+<dd>4.2</dd>
+</dl>
+</li>
+</ul>
 <a name="forAnnotatedObject-java.lang.Object-">
 <!--   -->
 </a>
@@ -943,9 +983,9 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <li class="blockList">
 <h4>resourceBundleBaseName</h4>
 <pre>public&nbsp;<a href="../picocli/CommandLine.Model.CommandSpec.html" title="class in picocli">CommandLine.Model.CommandSpec</a>&nbsp;resourceBundleBaseName(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;resourceBundleBaseName)</pre>
-<div class="block">Initializes the resource bundle for this command: sets the <code>UsageMessageSpec.messages</code> to
+<div class="block">Initializes the resource bundle for this command: sets the <a href="../picocli/CommandLine.Model.UsageMessageSpec.html#messages-picocli.CommandLine.Model.Messages-"><code>UsageMessageSpec.messages</code></a> to
  a <a href="../picocli/CommandLine.Model.Messages.html" title="class in picocli"><code>Messages</code></a> object created from this command spec and the specified bundle, and then sets the
- <code>ArgSpec.messages</code> of all options and positional parameters in this command
+ <a href="../picocli/CommandLine.Model.ArgSpec.html#messages-picocli.CommandLine.Model.Messages-"><code>ArgSpec.messages</code></a> of all options and positional parameters in this command
  to the same <code>Messages</code> instance. Subcommands are not modified.
  <p>This method is preferable to <a href="../picocli/CommandLine.Model.CommandSpec.html#resourceBundle-java.util.ResourceBundle-"><code>resourceBundle(ResourceBundle)</code></a> for pre-Java 8</p></div>
 <dl>
@@ -983,9 +1023,9 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <li class="blockList">
 <h4>resourceBundle</h4>
 <pre>public&nbsp;<a href="../picocli/CommandLine.Model.CommandSpec.html" title="class in picocli">CommandLine.Model.CommandSpec</a>&nbsp;resourceBundle(<a href="https://docs.oracle.com/javase/8/docs/api/java/util/ResourceBundle.html?is-external=true" title="class or interface in java.util">ResourceBundle</a>&nbsp;bundle)</pre>
-<div class="block">Initializes the resource bundle for this command: sets the <code>UsageMessageSpec.messages</code> to
+<div class="block">Initializes the resource bundle for this command: sets the <a href="../picocli/CommandLine.Model.UsageMessageSpec.html#messages-picocli.CommandLine.Model.Messages-"><code>UsageMessageSpec.messages</code></a> to
  a <a href="../picocli/CommandLine.Model.Messages.html" title="class in picocli"><code>Messages</code></a> object created from this command spec and the specified bundle, and then sets the
- <code>ArgSpec.messages</code> of all options and positional parameters in this command
+ <a href="../picocli/CommandLine.Model.ArgSpec.html#messages-picocli.CommandLine.Model.Messages-"><code>ArgSpec.messages</code></a> of all options and positional parameters in this command
  to the same <code>Messages</code> instance. Subcommands are not modified.</div>
 <dl>
 <dt><span class="paramLabel">Parameters:</span></dt>
@@ -1132,7 +1172,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <dt><span class="simpleTagLabel">Since:</span></dt>
 <dd>3.6.0</dd>
 <dt><span class="seeLabel">See Also:</span></dt>
-<dd><code>#addMethodSubcommands(IFactory)</code>, 
+<dd><a href="../picocli/CommandLine.Model.CommandSpec.html#addMethodSubcommands-picocli.CommandLine.IFactory-"><code>addMethodSubcommands(CommandLine.IFactory)</code></a>, 
 <a href="../picocli/CommandLine.Model.CommandSpec.html#addSubcommand-java.lang.String-picocli.CommandLine-"><code>addSubcommand(String, CommandLine)</code></a></dd>
 </dl>
 </li>
@@ -1399,7 +1439,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <dt><span class="simpleTagLabel">Since:</span></dt>
 <dd>4.1</dd>
 <dt><span class="seeLabel">See Also:</span></dt>
-<dd><code>#addMixin(String, CommandSpec, IAnnotatedElement)</code></dd>
+<dd><a href="../picocli/CommandLine.Model.CommandSpec.html#addMixin-java.lang.String-picocli.CommandLine.Model.CommandSpec-picocli.CommandLine.Model.IAnnotatedElement-"><code>addMixin(String, CommandLine.Model.CommandSpec, CommandLine.Model.IAnnotatedElement)</code></a></dd>
 </dl>
 </li>
 </ul>
@@ -1791,6 +1831,23 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <div class="block">Returns <code>true</code> if the standard help options have been mixed in with this command, <code>false</code> otherwise.</div>
 </li>
 </ul>
+<a name="subcommandsRepeatable--">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>subcommandsRepeatable</h4>
+<pre>public&nbsp;boolean&nbsp;subcommandsRepeatable()</pre>
+<div class="block">Returns whether the subcommands of this command are repeatable, that is, whether such subcommands can
+ occur multiple times and may be followed by sibling commands instead of just child commands.</div>
+<dl>
+<dt><span class="simpleTagLabel">Since:</span></dt>
+<dd>4.2</dd>
+<dt><span class="seeLabel">See Also:</span></dt>
+<dd><a href="../picocli/CommandLine.Command.html#subcommandsRepeatable--"><code>CommandLine.Command.subcommandsRepeatable()</code></a></dd>
+</dl>
+</li>
+</ul>
 <a name="toString--">
 <!--   -->
 </a>
@@ -2029,6 +2086,23 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </dl>
 </li>
 </ul>
+<a name="subcommandsRepeatable-boolean-">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>subcommandsRepeatable</h4>
+<pre>public&nbsp;<a href="../picocli/CommandLine.Model.CommandSpec.html" title="class in picocli">CommandLine.Model.CommandSpec</a>&nbsp;subcommandsRepeatable(boolean&nbsp;subcommandsRepeatable)</pre>
+<div class="block">Sets whether the subcommands of this command are repeatable, that is, whether such subcommands can
+ occur multiple times and may be followed by sibling commands instead of just child commands.</div>
+<dl>
+<dt><span class="simpleTagLabel">Since:</span></dt>
+<dd>4.2</dd>
+<dt><span class="seeLabel">See Also:</span></dt>
+<dd><a href="../picocli/CommandLine.Command.html#subcommandsRepeatable--"><code>CommandLine.Command.subcommandsRepeatable()</code></a></dd>
+</dl>
+</li>
+</ul>
 <a name="withToString-java.lang.String-">
 <!--   -->
 </a>
diff --git a/docs/apidocs/picocli/CommandLine.Model.IAnnotatedElement.html b/docs/apidocs/picocli/CommandLine.Model.IAnnotatedElement.html
index 918dcce1..b03c3dd2 100644
--- a/docs/apidocs/picocli/CommandLine.Model.IAnnotatedElement.html
+++ b/docs/apidocs/picocli/CommandLine.Model.IAnnotatedElement.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.Model.IAnnotatedElement (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Model.IAnnotatedElement (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Model.IAnnotatedElement (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Model.IAnnotatedElement (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Model.IGetter.html b/docs/apidocs/picocli/CommandLine.Model.IGetter.html
index 503bd41b..3f33273a 100644
--- a/docs/apidocs/picocli/CommandLine.Model.IGetter.html
+++ b/docs/apidocs/picocli/CommandLine.Model.IGetter.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.Model.IGetter (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Model.IGetter (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Model.IGetter (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Model.IGetter (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Model.IOrdered.html b/docs/apidocs/picocli/CommandLine.Model.IOrdered.html
index e013f0bf..29476f3d 100644
--- a/docs/apidocs/picocli/CommandLine.Model.IOrdered.html
+++ b/docs/apidocs/picocli/CommandLine.Model.IOrdered.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.Model.IOrdered (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Model.IOrdered (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Model.IOrdered (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Model.IOrdered (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Model.IScope.html b/docs/apidocs/picocli/CommandLine.Model.IScope.html
index b4ea21da..b937afe3 100644
--- a/docs/apidocs/picocli/CommandLine.Model.IScope.html
+++ b/docs/apidocs/picocli/CommandLine.Model.IScope.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.Model.IScope (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Model.IScope (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Model.IScope (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Model.IScope (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Model.ISetter.html b/docs/apidocs/picocli/CommandLine.Model.ISetter.html
index 421d8b11..4934568a 100644
--- a/docs/apidocs/picocli/CommandLine.Model.ISetter.html
+++ b/docs/apidocs/picocli/CommandLine.Model.ISetter.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.Model.ISetter (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Model.ISetter (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Model.ISetter (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Model.ISetter (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Model.ITypeInfo.html b/docs/apidocs/picocli/CommandLine.Model.ITypeInfo.html
index 1f20938b..4651bf76 100644
--- a/docs/apidocs/picocli/CommandLine.Model.ITypeInfo.html
+++ b/docs/apidocs/picocli/CommandLine.Model.ITypeInfo.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.Model.ITypeInfo (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Model.ITypeInfo (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Model.ITypeInfo (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Model.ITypeInfo (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Model.Messages.html b/docs/apidocs/picocli/CommandLine.Model.Messages.html
index 4e1cbc6d..14376dbb 100644
--- a/docs/apidocs/picocli/CommandLine.Model.Messages.html
+++ b/docs/apidocs/picocli/CommandLine.Model.Messages.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.Model.Messages (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Model.Messages (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Model.Messages (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Model.Messages (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Model.MethodParam.html b/docs/apidocs/picocli/CommandLine.Model.MethodParam.html
index ed3e3fcb..41b68210 100644
--- a/docs/apidocs/picocli/CommandLine.Model.MethodParam.html
+++ b/docs/apidocs/picocli/CommandLine.Model.MethodParam.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.Model.MethodParam (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Model.MethodParam (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Model.MethodParam (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Model.MethodParam (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Model.OptionSpec.Builder.html b/docs/apidocs/picocli/CommandLine.Model.OptionSpec.Builder.html
index 3695e29e..2d361be0 100644
--- a/docs/apidocs/picocli/CommandLine.Model.OptionSpec.Builder.html
+++ b/docs/apidocs/picocli/CommandLine.Model.OptionSpec.Builder.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.Model.OptionSpec.Builder (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Model.OptionSpec.Builder (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Model.OptionSpec.Builder (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Model.OptionSpec.Builder (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Model.OptionSpec.html b/docs/apidocs/picocli/CommandLine.Model.OptionSpec.html
index 8a30ed3f..3d59008b 100644
--- a/docs/apidocs/picocli/CommandLine.Model.OptionSpec.html
+++ b/docs/apidocs/picocli/CommandLine.Model.OptionSpec.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.Model.OptionSpec (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Model.OptionSpec (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Model.OptionSpec (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Model.OptionSpec (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Model.ParserSpec.html b/docs/apidocs/picocli/CommandLine.Model.ParserSpec.html
index 58032d59..c65b8f74 100644
--- a/docs/apidocs/picocli/CommandLine.Model.ParserSpec.html
+++ b/docs/apidocs/picocli/CommandLine.Model.ParserSpec.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.Model.ParserSpec (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Model.ParserSpec (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Model.ParserSpec (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Model.ParserSpec (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Model.PositionalParamSpec.Builder.html b/docs/apidocs/picocli/CommandLine.Model.PositionalParamSpec.Builder.html
index 4a79fc29..ea15040f 100644
--- a/docs/apidocs/picocli/CommandLine.Model.PositionalParamSpec.Builder.html
+++ b/docs/apidocs/picocli/CommandLine.Model.PositionalParamSpec.Builder.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.Model.PositionalParamSpec.Builder (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Model.PositionalParamSpec.Builder (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Model.PositionalParamSpec.Builder (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Model.PositionalParamSpec.Builder (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Model.PositionalParamSpec.html b/docs/apidocs/picocli/CommandLine.Model.PositionalParamSpec.html
index e4aee8ee..9d261267 100644
--- a/docs/apidocs/picocli/CommandLine.Model.PositionalParamSpec.html
+++ b/docs/apidocs/picocli/CommandLine.Model.PositionalParamSpec.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.Model.PositionalParamSpec (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Model.PositionalParamSpec (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Model.PositionalParamSpec (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Model.PositionalParamSpec (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Model.UnmatchedArgsBinding.html b/docs/apidocs/picocli/CommandLine.Model.UnmatchedArgsBinding.html
index f10e9a5d..19750d5b 100644
--- a/docs/apidocs/picocli/CommandLine.Model.UnmatchedArgsBinding.html
+++ b/docs/apidocs/picocli/CommandLine.Model.UnmatchedArgsBinding.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.Model.UnmatchedArgsBinding (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Model.UnmatchedArgsBinding (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Model.UnmatchedArgsBinding (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Model.UnmatchedArgsBinding (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Model.UsageMessageSpec.html b/docs/apidocs/picocli/CommandLine.Model.UsageMessageSpec.html
index 8d91cd6d..3a4b92c3 100644
--- a/docs/apidocs/picocli/CommandLine.Model.UsageMessageSpec.html
+++ b/docs/apidocs/picocli/CommandLine.Model.UsageMessageSpec.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.Model.UsageMessageSpec (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>CommandLine.Model.UsageMessageSpec (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,13 +12,13 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Model.UsageMessageSpec (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Model.UsageMessageSpec (picocli 4.2.0 API)";
         }
     }
     catch(err) {
     }
 //-->
-var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10,"i11":10,"i12":10,"i13":10,"i14":10,"i15":10,"i16":10,"i17":10,"i18":10,"i19":10,"i20":10,"i21":10,"i22":10,"i23":10,"i24":10,"i25":10,"i26":10,"i27":10,"i28":10,"i29":10,"i30":9,"i31":10,"i32":10,"i33":10,"i34":10,"i35":10,"i36":10,"i37":10,"i38":10,"i39":10,"i40":10,"i41":10,"i42":10,"i43":10,"i44":10,"i45":10,"i46":10,"i47":10,"i48":10,"i49":10,"i50":10,"i51":10,"i52":10,"i53":10,"i54":10,"i55":10,"i56":10};
+var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10,"i11":10,"i12":10,"i13":10,"i14":10,"i15":10,"i16":10,"i17":10,"i18":10,"i19":10,"i20":10,"i21":10,"i22":10,"i23":10,"i24":10,"i25":10,"i26":10,"i27":10,"i28":10,"i29":10,"i30":9,"i31":10,"i32":10,"i33":10,"i34":10,"i35":10,"i36":10,"i37":10,"i38":10,"i39":10,"i40":10,"i41":10,"i42":10,"i43":10,"i44":10,"i45":10,"i46":10,"i47":10,"i48":10,"i49":10,"i50":10,"i51":10,"i52":10,"i53":10,"i54":10,"i55":10,"i56":10,"i57":10,"i58":10,"i59":10,"i60":10};
 var tabs = {65535:["t0","All Methods"],1:["t1","Static Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]};
 var altColor = "altColor";
 var rowColor = "rowColor";
@@ -197,95 +197,101 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </tr>
 <tr class="rowColor">
 <td class="colFirst"><code>static <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_AT_FILE_PARAMETER">SECTION_KEY_AT_FILE_PARAMETER</a></span></code>
+<div class="block"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionKeys--">Section key</a> to <a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionMap--">control</a> the <a href="../picocli/CommandLine.IHelpSectionRenderer.html" title="interface in picocli">section renderer</a> for the @-file parameter list section.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>static <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_COMMAND_LIST">SECTION_KEY_COMMAND_LIST</a></span></code>
 <div class="block"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionKeys--">Section key</a> to <a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionMap--">control</a> the <a href="../picocli/CommandLine.IHelpSectionRenderer.html" title="interface in picocli">section renderer</a> for the Subcommand List section.</div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colFirst"><code>static <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_COMMAND_LIST_HEADING">SECTION_KEY_COMMAND_LIST_HEADING</a></span></code>
 <div class="block"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionKeys--">Section key</a> to <a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionMap--">control</a> the <a href="../picocli/CommandLine.IHelpSectionRenderer.html" title="interface in picocli">section renderer</a> for the Subcommand List Heading section.</div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colFirst"><code>static <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_DESCRIPTION">SECTION_KEY_DESCRIPTION</a></span></code>
 <div class="block"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionKeys--">Section key</a> to <a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionMap--">control</a> the <a href="../picocli/CommandLine.IHelpSectionRenderer.html" title="interface in picocli">section renderer</a> for the Description section.</div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colFirst"><code>static <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_DESCRIPTION_HEADING">SECTION_KEY_DESCRIPTION_HEADING</a></span></code>
 <div class="block"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionKeys--">Section key</a> to <a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionMap--">control</a> the <a href="../picocli/CommandLine.IHelpSectionRenderer.html" title="interface in picocli">section renderer</a> for the Description Heading section.</div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colFirst"><code>static <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_EXIT_CODE_LIST">SECTION_KEY_EXIT_CODE_LIST</a></span></code>
 <div class="block"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionKeys--">Section key</a> to <a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionMap--">control</a> the <a href="../picocli/CommandLine.IHelpSectionRenderer.html" title="interface in picocli">section renderer</a> for the Exit Code List section.</div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colFirst"><code>static <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_EXIT_CODE_LIST_HEADING">SECTION_KEY_EXIT_CODE_LIST_HEADING</a></span></code>
 <div class="block"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionKeys--">Section key</a> to <a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionMap--">control</a> the <a href="../picocli/CommandLine.IHelpSectionRenderer.html" title="interface in picocli">section renderer</a> for the Exit Code List Heading section.</div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colFirst"><code>static <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_FOOTER">SECTION_KEY_FOOTER</a></span></code>
 <div class="block"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionKeys--">Section key</a> to <a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionMap--">control</a> the <a href="../picocli/CommandLine.IHelpSectionRenderer.html" title="interface in picocli">section renderer</a> for the Footer section.</div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colFirst"><code>static <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_FOOTER_HEADING">SECTION_KEY_FOOTER_HEADING</a></span></code>
 <div class="block"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionKeys--">Section key</a> to <a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionMap--">control</a> the <a href="../picocli/CommandLine.IHelpSectionRenderer.html" title="interface in picocli">section renderer</a> for the Footer Heading section.</div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colFirst"><code>static <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_HEADER">SECTION_KEY_HEADER</a></span></code>
 <div class="block"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionKeys--">Section key</a> to <a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionMap--">control</a> the <a href="../picocli/CommandLine.IHelpSectionRenderer.html" title="interface in picocli">section renderer</a> for the Header section.</div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colFirst"><code>static <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_HEADER_HEADING">SECTION_KEY_HEADER_HEADING</a></span></code>
 <div class="block"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionKeys--">Section key</a> to <a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionMap--">control</a> the <a href="../picocli/CommandLine.IHelpSectionRenderer.html" title="interface in picocli">section renderer</a> for the Header Heading section.</div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colFirst"><code>static <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_OPTION_LIST">SECTION_KEY_OPTION_LIST</a></span></code>
 <div class="block"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionKeys--">Section key</a> to <a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionMap--">control</a> the <a href="../picocli/CommandLine.IHelpSectionRenderer.html" title="interface in picocli">section renderer</a> for the Option List section.</div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colFirst"><code>static <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_OPTION_LIST_HEADING">SECTION_KEY_OPTION_LIST_HEADING</a></span></code>
 <div class="block"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionKeys--">Section key</a> to <a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionMap--">control</a> the <a href="../picocli/CommandLine.IHelpSectionRenderer.html" title="interface in picocli">section renderer</a> for the Option List Heading section.</div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colFirst"><code>static <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_PARAMETER_LIST">SECTION_KEY_PARAMETER_LIST</a></span></code>
 <div class="block"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionKeys--">Section key</a> to <a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionMap--">control</a> the <a href="../picocli/CommandLine.IHelpSectionRenderer.html" title="interface in picocli">section renderer</a> for the Parameter List section.</div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colFirst"><code>static <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_PARAMETER_LIST_HEADING">SECTION_KEY_PARAMETER_LIST_HEADING</a></span></code>
 <div class="block"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionKeys--">Section key</a> to <a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionMap--">control</a> the <a href="../picocli/CommandLine.IHelpSectionRenderer.html" title="interface in picocli">section renderer</a> for the Parameter List Heading section.</div>
 </td>
 </tr>
-<tr class="rowColor">
+<tr class="altColor">
 <td class="colFirst"><code>static <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_SYNOPSIS">SECTION_KEY_SYNOPSIS</a></span></code>
 <div class="block"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionKeys--">Section key</a> to <a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionMap--">control</a> the <a href="../picocli/CommandLine.IHelpSectionRenderer.html" title="interface in picocli">section renderer</a> for the Synopsis section.</div>
 </td>
 </tr>
-<tr class="altColor">
+<tr class="rowColor">
 <td class="colFirst"><code>static <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_SYNOPSIS_HEADING">SECTION_KEY_SYNOPSIS_HEADING</a></span></code>
 <div class="block"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionKeys--">Section key</a> to <a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionMap--">control</a> the <a href="../picocli/CommandLine.IHelpSectionRenderer.html" title="interface in picocli">section renderer</a> for the Synopsis Heading section.</div>
@@ -514,160 +520,184 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </td>
 </tr>
 <tr id="i31" class="rowColor">
+<td class="colFirst"><code>int</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#longOptionsMaxWidth--">longOptionsMaxWidth</a></span>()</code>
+<div class="block">Returns the maximum usage help long options column max width to the specified value.</div>
+</td>
+</tr>
+<tr id="i32" class="altColor">
+<td class="colFirst"><code><a href="../picocli/CommandLine.Model.UsageMessageSpec.html" title="class in picocli">CommandLine.Model.UsageMessageSpec</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#longOptionsMaxWidth-int-">longOptionsMaxWidth</a></span>(int&nbsp;newValue)</code>
+<div class="block">Sets the maximum usage help long options column max width to the specified value.</div>
+</td>
+</tr>
+<tr id="i33" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Model.Messages.html" title="class in picocli">CommandLine.Model.Messages</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#messages--">messages</a></span>()</code>
 <div class="block">Returns the Messages for this usage help message specification, or <code>null</code>.</div>
 </td>
 </tr>
-<tr id="i32" class="altColor">
+<tr id="i34" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Model.UsageMessageSpec.html" title="class in picocli">CommandLine.Model.UsageMessageSpec</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#messages-picocli.CommandLine.Model.Messages-">messages</a></span>(<a href="../picocli/CommandLine.Model.Messages.html" title="class in picocli">CommandLine.Model.Messages</a>&nbsp;msgs)</code>
 <div class="block">Sets the Messages for this usageMessage specification, and returns this UsageMessageSpec.</div>
 </td>
 </tr>
-<tr id="i33" class="rowColor">
+<tr id="i35" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#optionListHeading--">optionListHeading</a></span>()</code>
 <div class="block">Returns the optional heading preceding the options list.</div>
 </td>
 </tr>
-<tr id="i34" class="altColor">
+<tr id="i36" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Model.UsageMessageSpec.html" title="class in picocli">CommandLine.Model.UsageMessageSpec</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#optionListHeading-java.lang.String-">optionListHeading</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;newValue)</code>
 <div class="block">Sets the heading preceding the options list.</div>
 </td>
 </tr>
-<tr id="i35" class="rowColor">
+<tr id="i37" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#parameterListHeading--">parameterListHeading</a></span>()</code>
 <div class="block">Returns the optional heading preceding the parameter list.</div>
 </td>
 </tr>
-<tr id="i36" class="altColor">
+<tr id="i38" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Model.UsageMessageSpec.html" title="class in picocli">CommandLine.Model.UsageMessageSpec</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#parameterListHeading-java.lang.String-">parameterListHeading</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;newValue)</code>
 <div class="block">Sets the optional heading preceding the parameter list.</div>
 </td>
 </tr>
-<tr id="i37" class="rowColor">
+<tr id="i39" class="rowColor">
 <td class="colFirst"><code>char</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#requiredOptionMarker--">requiredOptionMarker</a></span>()</code>
 <div class="block">Returns the character used to prefix required options in the options list.</div>
 </td>
 </tr>
-<tr id="i38" class="altColor">
+<tr id="i40" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Model.UsageMessageSpec.html" title="class in picocli">CommandLine.Model.UsageMessageSpec</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#requiredOptionMarker-char-">requiredOptionMarker</a></span>(char&nbsp;newValue)</code>
 <div class="block">Sets the character used to prefix required options in the options list.</div>
 </td>
 </tr>
-<tr id="i39" class="rowColor">
+<tr id="i41" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionKeys--">sectionKeys</a></span>()</code>
 <div class="block">Returns the section keys in the order that the usage help message should render the sections.</div>
 </td>
 </tr>
-<tr id="i40" class="altColor">
+<tr id="i42" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Model.UsageMessageSpec.html" title="class in picocli">CommandLine.Model.UsageMessageSpec</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionKeys-java.util.List-">sectionKeys</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&gt;&nbsp;keys)</code>
 <div class="block">Sets the section keys in the order that the usage help message should render the sections.</div>
 </td>
 </tr>
-<tr id="i41" class="rowColor">
+<tr id="i43" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>,<a href="../picocli/CommandLine.IHelpSectionRenderer.html" title="interface in picocli">CommandLine.IHelpSectionRenderer</a>&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionMap--">sectionMap</a></span>()</code>
 <div class="block">Returns the map of section keys and renderers used to construct the usage help message.</div>
 </td>
 </tr>
-<tr id="i42" class="altColor">
+<tr id="i44" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Model.UsageMessageSpec.html" title="class in picocli">CommandLine.Model.UsageMessageSpec</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionMap-java.util.Map-">sectionMap</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>,<a href="../picocli/CommandLine.IHelpSectionRenderer.html" title="interface in picocli">CommandLine.IHelpSectionRenderer</a>&gt;&nbsp;map)</code>
 <div class="block">Sets the map of section keys and renderers used to construct the usage help message to a copy of the specified map.</div>
 </td>
 </tr>
-<tr id="i43" class="rowColor">
+<tr id="i45" class="rowColor">
+<td class="colFirst"><code>boolean</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#showAtFileInUsageHelp--">showAtFileInUsageHelp</a></span>()</code>
+<div class="block">Sets whether to show a <code>[@&lt;filename&gt;...]</code> entry in the synopsis and parameter list of the usage help message.</div>
+</td>
+</tr>
+<tr id="i46" class="altColor">
+<td class="colFirst"><code><a href="../picocli/CommandLine.Model.UsageMessageSpec.html" title="class in picocli">CommandLine.Model.UsageMessageSpec</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#showAtFileInUsageHelp-boolean-">showAtFileInUsageHelp</a></span>(boolean&nbsp;newValue)</code>
+<div class="block">Sets whether to show a <code>[@&lt;filename&gt;...]</code> entry in the synopsis and parameter list of the usage help message.</div>
+</td>
+</tr>
+<tr id="i47" class="rowColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#showDefaultValues--">showDefaultValues</a></span>()</code>
 <div class="block">Returns whether the options list in the usage help message should show default values for all non-boolean options.</div>
 </td>
 </tr>
-<tr id="i44" class="altColor">
+<tr id="i48" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Model.UsageMessageSpec.html" title="class in picocli">CommandLine.Model.UsageMessageSpec</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#showDefaultValues-boolean-">showDefaultValues</a></span>(boolean&nbsp;newValue)</code>
 <div class="block">Sets whether the options list in the usage help message should show default values for all non-boolean options.</div>
 </td>
 </tr>
-<tr id="i45" class="rowColor">
+<tr id="i49" class="rowColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sortOptions--">sortOptions</a></span>()</code>
 <div class="block">Returns whether the options list in the usage help message should be sorted alphabetically.</div>
 </td>
 </tr>
-<tr id="i46" class="altColor">
+<tr id="i50" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Model.UsageMessageSpec.html" title="class in picocli">CommandLine.Model.UsageMessageSpec</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sortOptions-boolean-">sortOptions</a></span>(boolean&nbsp;newValue)</code>
 <div class="block">Sets whether the options list in the usage help message should be sorted alphabetically.</div>
 </td>
 </tr>
-<tr id="i47" class="rowColor">
+<tr id="i51" class="rowColor">
 <td class="colFirst"><code>double</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#synopsisAutoIndentThreshold--">synopsisAutoIndentThreshold</a></span>()</code>
 <div class="block">Returns the fraction of the usage help <a href="../picocli/CommandLine.Model.UsageMessageSpec.html#width--"><code>width()</code></a> that is the threshold up to which
  the 2nd line and subsequent lines of a multi-line synopsis should be aligned to the end of the command name.</div>
 </td>
 </tr>
-<tr id="i48" class="altColor">
+<tr id="i52" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Model.UsageMessageSpec.html" title="class in picocli">CommandLine.Model.UsageMessageSpec</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#synopsisAutoIndentThreshold-double-">synopsisAutoIndentThreshold</a></span>(double&nbsp;newValue)</code>
 <div class="block">Sets the fraction of the usage help <a href="../picocli/CommandLine.Model.UsageMessageSpec.html#width--"><code>width()</code></a> that is the threshold up to which
  the 2nd line and subsequent lines of a multi-line synopsis should be aligned to the end of the command name.</div>
 </td>
 </tr>
-<tr id="i49" class="rowColor">
+<tr id="i53" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#synopsisHeading--">synopsisHeading</a></span>()</code>
 <div class="block">Returns the optional heading preceding the synopsis.</div>
 </td>
 </tr>
-<tr id="i50" class="altColor">
+<tr id="i54" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Model.UsageMessageSpec.html" title="class in picocli">CommandLine.Model.UsageMessageSpec</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#synopsisHeading-java.lang.String-">synopsisHeading</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;newValue)</code>
 <div class="block">Sets the optional heading preceding the synopsis.</div>
 </td>
 </tr>
-<tr id="i51" class="rowColor">
+<tr id="i55" class="rowColor">
 <td class="colFirst"><code>int</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#synopsisIndent--">synopsisIndent</a></span>()</code>
 <div class="block">Returns the indentation to use on the 2nd line and subsequent lines of a multi-line synopsis
  when the length of the synopsis heading and the fully qualified command name exceed the <a href="../picocli/CommandLine.Model.UsageMessageSpec.html#width--"><code>width()</code></a> times the <a href="../picocli/CommandLine.Model.UsageMessageSpec.html#synopsisAutoIndentThreshold--"><code>synopsisAutoIndentThreshold()</code></a>, <code>-1</code> by default.</div>
 </td>
 </tr>
-<tr id="i52" class="altColor">
+<tr id="i56" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Model.UsageMessageSpec.html" title="class in picocli">CommandLine.Model.UsageMessageSpec</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#synopsisIndent-int-">synopsisIndent</a></span>(int&nbsp;newValue)</code>
 <div class="block">Sets the indentation to use on the 2nd line and subsequent lines of a multi-line synopsis
  when the length of the synopsis heading and the fully qualified command name exceed the <a href="../picocli/CommandLine.Model.UsageMessageSpec.html#synopsisAutoIndentThreshold--"><code>synopsisAutoIndentThreshold()</code></a> fraction of the <a href="../picocli/CommandLine.Model.UsageMessageSpec.html#width--"><code>width()</code></a>, <code>-1</code> by default.</div>
 </td>
 </tr>
-<tr id="i53" class="rowColor">
+<tr id="i57" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#synopsisSubcommandLabel--">synopsisSubcommandLabel</a></span>()</code>
 <div class="block">Returns the String representing the subcommands in the synopsis.</div>
 </td>
 </tr>
-<tr id="i54" class="altColor">
+<tr id="i58" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Model.UsageMessageSpec.html" title="class in picocli">CommandLine.Model.UsageMessageSpec</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#synopsisSubcommandLabel-java.lang.String-">synopsisSubcommandLabel</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;newValue)</code>
 <div class="block">Sets the String representing the subcommands in the synopsis.</div>
 </td>
 </tr>
-<tr id="i55" class="rowColor">
+<tr id="i59" class="rowColor">
 <td class="colFirst"><code>int</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#width--">width</a></span>()</code>
 <div class="block">Returns the maximum usage help message width.</div>
 </td>
 </tr>
-<tr id="i56" class="altColor">
+<tr id="i60" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.Model.UsageMessageSpec.html" title="class in picocli">CommandLine.Model.UsageMessageSpec</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#width-int-">width</a></span>(int&nbsp;newValue)</code>
 <div class="block">Sets the maximum usage help message width to the specified value.</div>
@@ -814,6 +844,23 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </dl>
 </li>
 </ul>
+<a name="SECTION_KEY_AT_FILE_PARAMETER">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>SECTION_KEY_AT_FILE_PARAMETER</h4>
+<pre>public static final&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> SECTION_KEY_AT_FILE_PARAMETER</pre>
+<div class="block"><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionKeys--">Section key</a> to <a href="../picocli/CommandLine.Model.UsageMessageSpec.html#sectionMap--">control</a> the <a href="../picocli/CommandLine.IHelpSectionRenderer.html" title="interface in picocli">section renderer</a> for the @-file parameter list section.
+ The default renderer for this section calls <a href="../picocli/CommandLine.Help.html#atFileParameterList--"><code>CommandLine.Help.atFileParameterList()</code></a>.</div>
+<dl>
+<dt><span class="simpleTagLabel">Since:</span></dt>
+<dd>4.2</dd>
+<dt><span class="seeLabel">See Also:</span></dt>
+<dd><a href="../constant-values.html#picocli.CommandLine.Model.UsageMessageSpec.SECTION_KEY_AT_FILE_PARAMETER">Constant Field Values</a></dd>
+</dl>
+</li>
+</ul>
 <a name="SECTION_KEY_PARAMETER_LIST">
 <!--   -->
 </a>
@@ -1024,6 +1071,27 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </dl>
 </li>
 </ul>
+<a name="longOptionsMaxWidth-int-">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>longOptionsMaxWidth</h4>
+<pre>public&nbsp;<a href="../picocli/CommandLine.Model.UsageMessageSpec.html" title="class in picocli">CommandLine.Model.UsageMessageSpec</a>&nbsp;longOptionsMaxWidth(int&nbsp;newValue)</pre>
+<div class="block">Sets the maximum usage help long options column max width to the specified value.
+ This value controls the maximum width of the long options column: any positional parameter labels or long options that are longer than the specified value will overflow into the description column, and cause the description to be displayed on the next line.</div>
+<dl>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>newValue</code> - the new maximum usage help long options column max width. Must be 20 or greater.</dd>
+<dt><span class="returnLabel">Returns:</span></dt>
+<dd>this <code>UsageMessageSpec</code> for method chaining</dd>
+<dt><span class="throwsLabel">Throws:</span></dt>
+<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</a></code> - if the specified long options column max is less than 20</dd>
+<dt><span class="simpleTagLabel">Since:</span></dt>
+<dd>4.2</dd>
+</dl>
+</li>
+</ul>
 <a name="width--">
 <!--   -->
 </a>
@@ -1039,6 +1107,23 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </dl>
 </li>
 </ul>
+<a name="longOptionsMaxWidth--">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>longOptionsMaxWidth</h4>
+<pre>public&nbsp;int&nbsp;longOptionsMaxWidth()</pre>
+<div class="block">Returns the maximum usage help long options column max width to the specified value.
+ This value controls the maximum width of the long options column: any positional parameter labels or long options that are longer than the specified value will overflow into the description column, and cause the description to be displayed on the next line.</div>
+<dl>
+<dt><span class="returnLabel">Returns:</span></dt>
+<dd>the new maximum usage help long options column max width. Always 20 or greater.</dd>
+<dt><span class="simpleTagLabel">Since:</span></dt>
+<dd>4.2</dd>
+</dl>
+</li>
+</ul>
 <a name="autoWidth--">
 <!--   -->
 </a>
@@ -1094,6 +1179,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
    <li><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_DESCRIPTION_HEADING"><code>SECTION_KEY_DESCRIPTION_HEADING</code></a></li>
    <li><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_DESCRIPTION"><code>SECTION_KEY_DESCRIPTION</code></a></li>
    <li><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_PARAMETER_LIST_HEADING"><code>SECTION_KEY_PARAMETER_LIST_HEADING</code></a></li>
+   <li><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_AT_FILE_PARAMETER"><code>SECTION_KEY_AT_FILE_PARAMETER</code></a></li>
    <li><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_PARAMETER_LIST"><code>SECTION_KEY_PARAMETER_LIST</code></a></li>
    <li><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_OPTION_LIST_HEADING"><code>SECTION_KEY_OPTION_LIST_HEADING</code></a></li>
    <li><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_OPTION_LIST"><code>SECTION_KEY_OPTION_LIST</code></a></li>
@@ -1376,6 +1462,23 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <div class="block">Returns whether the options list in the usage help message should show default values for all non-boolean options.</div>
 </li>
 </ul>
+<a name="showAtFileInUsageHelp--">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>showAtFileInUsageHelp</h4>
+<pre>public&nbsp;boolean&nbsp;showAtFileInUsageHelp()</pre>
+<div class="block">Sets whether to show a <code>[@&lt;filename&gt;...]</code> entry in the synopsis and parameter list of the usage help message.
+ (The entry is not shown if <a href="../picocli/CommandLine.html#isExpandAtFiles--">expanding parameter files</a> is disabled.)</div>
+<dl>
+<dt><span class="simpleTagLabel">Since:</span></dt>
+<dd>4.2</dd>
+<dt><span class="seeLabel">See Also:</span></dt>
+<dd><a href="../picocli/CommandLine.Command.html#showAtFileInUsageHelp--"><code>CommandLine.Command.showAtFileInUsageHelp()</code></a></dd>
+</dl>
+</li>
+</ul>
 <a name="hidden--">
 <!--   -->
 </a>
@@ -1706,6 +1809,25 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </dl>
 </li>
 </ul>
+<a name="showAtFileInUsageHelp-boolean-">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>showAtFileInUsageHelp</h4>
+<pre>public&nbsp;<a href="../picocli/CommandLine.Model.UsageMessageSpec.html" title="class in picocli">CommandLine.Model.UsageMessageSpec</a>&nbsp;showAtFileInUsageHelp(boolean&nbsp;newValue)</pre>
+<div class="block">Sets whether to show a <code>[@&lt;filename&gt;...]</code> entry in the synopsis and parameter list of the usage help message.
+ (The entry is not shown if <a href="../picocli/CommandLine.html#isExpandAtFiles--">expanding parameter files</a> is disabled.)</div>
+<dl>
+<dt><span class="returnLabel">Returns:</span></dt>
+<dd>this UsageMessageSpec for method chaining</dd>
+<dt><span class="simpleTagLabel">Since:</span></dt>
+<dd>4.2</dd>
+<dt><span class="seeLabel">See Also:</span></dt>
+<dd><a href="../picocli/CommandLine.Command.html#showAtFileInUsageHelp--"><code>CommandLine.Command.showAtFileInUsageHelp()</code></a></dd>
+</dl>
+</li>
+</ul>
 <a name="hidden-boolean-">
 <!--   -->
 </a>
diff --git a/docs/apidocs/picocli/CommandLine.Model.html b/docs/apidocs/picocli/CommandLine.Model.html
index f882ed3d..ca536e33 100644
--- a/docs/apidocs/picocli/CommandLine.Model.html
+++ b/docs/apidocs/picocli/CommandLine.Model.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.Model (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:50 JST 2020 -->
+<title>CommandLine.Model (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Model (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Model (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.MutuallyExclusiveArgsException.html b/docs/apidocs/picocli/CommandLine.MutuallyExclusiveArgsException.html
index 5215b4c8..355a6f9b 100644
--- a/docs/apidocs/picocli/CommandLine.MutuallyExclusiveArgsException.html
+++ b/docs/apidocs/picocli/CommandLine.MutuallyExclusiveArgsException.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.MutuallyExclusiveArgsException (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>CommandLine.MutuallyExclusiveArgsException (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.MutuallyExclusiveArgsException (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.MutuallyExclusiveArgsException (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Option.html b/docs/apidocs/picocli/CommandLine.Option.html
index e99fb4e6..3ded1cb6 100644
--- a/docs/apidocs/picocli/CommandLine.Option.html
+++ b/docs/apidocs/picocli/CommandLine.Option.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.Option (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>CommandLine.Option (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Option (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Option (picocli 4.2.0 API)";
         }
     }
     catch(err) {
@@ -528,6 +528,8 @@ public abstract&nbsp;boolean&nbsp;help</pre>
 <dl>
 <dt><span class="returnLabel">Returns:</span></dt>
 <dd>the description of this option</dd>
+<dt><span class="seeLabel">See Also:</span></dt>
+<dd><a href="https://picocli.info/#_variable_interpolation">Variable Interpolation</a> section of the user manual</dd>
 </dl>
 <dl>
 <dt>Default:</dt>
@@ -805,7 +807,8 @@ public abstract&nbsp;boolean&nbsp;help</pre>
  help message. If not specified, the default value is only shown when the <a href="../picocli/CommandLine.Command.html#showDefaultValues--"><code>CommandLine.Command.showDefaultValues()</code></a>
  is set <code>true</code> on the command. Use this attribute to specify whether the default value
  for this specific option should always be shown or never be shown, regardless of the command setting.
- <p>Note that picocli 3.2 allows <a href="../picocli/CommandLine.Option.html#description--">embedding default values</a> anywhere in the description that ignores this setting.</p></div>
+ <p>Note that picocli 3.2 allows <a href="../picocli/CommandLine.Option.html#description--">embedding default values</a> by specifying the variable
+ <code>${DEFAULT-VALUE}</code> anywhere in the description that ignores this setting.</p></div>
 <dl>
 <dt><span class="returnLabel">Returns:</span></dt>
 <dd>whether this option's default value should be shown in the usage help message</dd>
diff --git a/docs/apidocs/picocli/CommandLine.OverwrittenOptionException.html b/docs/apidocs/picocli/CommandLine.OverwrittenOptionException.html
index b3933916..8e394c49 100644
--- a/docs/apidocs/picocli/CommandLine.OverwrittenOptionException.html
+++ b/docs/apidocs/picocli/CommandLine.OverwrittenOptionException.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.OverwrittenOptionException (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>CommandLine.OverwrittenOptionException (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.OverwrittenOptionException (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.OverwrittenOptionException (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.ParameterException.html b/docs/apidocs/picocli/CommandLine.ParameterException.html
index f044b4b7..b2b001cf 100644
--- a/docs/apidocs/picocli/CommandLine.ParameterException.html
+++ b/docs/apidocs/picocli/CommandLine.ParameterException.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.ParameterException (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>CommandLine.ParameterException (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.ParameterException (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.ParameterException (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.ParameterIndexGapException.html b/docs/apidocs/picocli/CommandLine.ParameterIndexGapException.html
index bee69ba7..d38a7c1c 100644
--- a/docs/apidocs/picocli/CommandLine.ParameterIndexGapException.html
+++ b/docs/apidocs/picocli/CommandLine.ParameterIndexGapException.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.ParameterIndexGapException (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>CommandLine.ParameterIndexGapException (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.ParameterIndexGapException (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.ParameterIndexGapException (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Parameters.html b/docs/apidocs/picocli/CommandLine.Parameters.html
index aef315fa..81725aa4 100644
--- a/docs/apidocs/picocli/CommandLine.Parameters.html
+++ b/docs/apidocs/picocli/CommandLine.Parameters.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.Parameters (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>CommandLine.Parameters (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Parameters (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Parameters (picocli 4.2.0 API)";
         }
     }
     catch(err) {
@@ -291,6 +291,8 @@ public static @interface <span class="memberNameLabel">CommandLine.Parameters</s
 <dl>
 <dt><span class="returnLabel">Returns:</span></dt>
 <dd>the description of the parameter(s)</dd>
+<dt><span class="seeLabel">See Also:</span></dt>
+<dd><a href="https://picocli.info/#_variable_interpolation">Variable Interpolation</a> section of the user manual</dd>
 </dl>
 <dl>
 <dt>Default:</dt>
@@ -535,7 +537,8 @@ public static @interface <span class="memberNameLabel">CommandLine.Parameters</s
  help message. If not specified, the default value is only shown when the <a href="../picocli/CommandLine.Command.html#showDefaultValues--"><code>CommandLine.Command.showDefaultValues()</code></a>
  is set <code>true</code> on the command. Use this attribute to specify whether the default value
  for this specific positional parameter should always be shown or never be shown, regardless of the command setting.
- <p>Note that picocli 3.2 allows <a href="../picocli/CommandLine.Parameters.html#description--">embedding default values</a> anywhere in the description that ignores this setting.</p></div>
+ <p>Note that picocli 3.2 allows <a href="../picocli/CommandLine.Parameters.html#description--">embedding default values</a> by specifying the variable
+ <code>${DEFAULT-VALUE}</code> anywhere in the description that ignores this setting.</p></div>
 <dl>
 <dt><span class="returnLabel">Returns:</span></dt>
 <dd>whether this positional parameter's default value should be shown in the usage help message</dd>
diff --git a/docs/apidocs/picocli/CommandLine.ParentCommand.html b/docs/apidocs/picocli/CommandLine.ParentCommand.html
index fdceec22..29a21cbe 100644
--- a/docs/apidocs/picocli/CommandLine.ParentCommand.html
+++ b/docs/apidocs/picocli/CommandLine.ParentCommand.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.ParentCommand (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>CommandLine.ParentCommand (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.ParentCommand (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.ParentCommand (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.ParseResult.Builder.html b/docs/apidocs/picocli/CommandLine.ParseResult.Builder.html
index 9ded301e..8a06becc 100644
--- a/docs/apidocs/picocli/CommandLine.ParseResult.Builder.html
+++ b/docs/apidocs/picocli/CommandLine.ParseResult.Builder.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.ParseResult.Builder (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>CommandLine.ParseResult.Builder (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.ParseResult.Builder (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.ParseResult.Builder (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.ParseResult.GroupMatch.html b/docs/apidocs/picocli/CommandLine.ParseResult.GroupMatch.html
index 77f0135a..1a3d9d61 100644
--- a/docs/apidocs/picocli/CommandLine.ParseResult.GroupMatch.html
+++ b/docs/apidocs/picocli/CommandLine.ParseResult.GroupMatch.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.ParseResult.GroupMatch (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>CommandLine.ParseResult.GroupMatch (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.ParseResult.GroupMatch (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.ParseResult.GroupMatch (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.ParseResult.GroupMatchContainer.html b/docs/apidocs/picocli/CommandLine.ParseResult.GroupMatchContainer.html
index 223f9ba0..75d67060 100644
--- a/docs/apidocs/picocli/CommandLine.ParseResult.GroupMatchContainer.html
+++ b/docs/apidocs/picocli/CommandLine.ParseResult.GroupMatchContainer.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.ParseResult.GroupMatchContainer (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>CommandLine.ParseResult.GroupMatchContainer (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.ParseResult.GroupMatchContainer (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.ParseResult.GroupMatchContainer (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.ParseResult.html b/docs/apidocs/picocli/CommandLine.ParseResult.html
index 9417145c..bf30d01c 100644
--- a/docs/apidocs/picocli/CommandLine.ParseResult.html
+++ b/docs/apidocs/picocli/CommandLine.ParseResult.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.ParseResult (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>CommandLine.ParseResult (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,13 +12,13 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.ParseResult (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.ParseResult (picocli 4.2.0 API)";
         }
     }
     catch(err) {
     }
 //-->
-var methods = {"i0":10,"i1":9,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10,"i11":10,"i12":10,"i13":10,"i14":10,"i15":10,"i16":10,"i17":10,"i18":10,"i19":10,"i20":10,"i21":10,"i22":10,"i23":10,"i24":10,"i25":10,"i26":10,"i27":10,"i28":10};
+var methods = {"i0":10,"i1":9,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10,"i11":10,"i12":10,"i13":10,"i14":10,"i15":10,"i16":10,"i17":10,"i18":10,"i19":10,"i20":10,"i21":10,"i22":10,"i23":10,"i24":10,"i25":10,"i26":10,"i27":10,"i28":10,"i29":10};
 var tabs = {65535:["t0","All Methods"],1:["t1","Static Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]};
 var altColor = "altColor";
 var rowColor = "rowColor";
@@ -340,10 +340,17 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <tr id="i27" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.ParseResult.html" title="class in picocli">CommandLine.ParseResult</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.ParseResult.html#subcommand--">subcommand</a></span>()</code>
-<div class="block">Returns the <code>ParseResult</code> for the subcommand of this command that was matched on the command line, or <code>null</code> if no subcommand was matched.</div>
+<div class="block">Returns the <code>ParseResult</code> for the last subcommand of this command that was matched on the command line, or <code>null</code> if no subcommand was matched.</div>
 </td>
 </tr>
 <tr id="i28" class="altColor">
+<td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;<a href="../picocli/CommandLine.ParseResult.html" title="class in picocli">CommandLine.ParseResult</a>&gt;</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.ParseResult.html#subcommands--">subcommands</a></span>()</code>
+<div class="block">Returns a list with the <code>ParseResult</code> objects for each subcommand of this command
+ that was matched on the command line or an empty list if no subcommands were matched.</div>
+</td>
+</tr>
+<tr id="i29" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.ParseResult.html#unmatched--">unmatched</a></span>()</code>
 <div class="block">Returns a list of command line arguments that did not match any options or positional parameters.</div>
@@ -407,7 +414,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
  If the user input was a valid combination of group arguments, the returned list should contain a single
  <a href="../picocli/CommandLine.ParseResult.GroupMatch.html" title="class in picocli">match</a>. Details of the <a href="../picocli/CommandLine.ParseResult.GroupMatchContainer.html" title="class in picocli">matched groups</a> encountered
  on the command line can be obtained via its <a href="../picocli/CommandLine.ParseResult.GroupMatch.html#matchedSubgroups--"><code>matchedSubgroups()</code></a> method.
- The top-level match returned by this method contains no matched arguments.
+ The top-level match returned by this method contains no <a href="../picocli/CommandLine.ParseResult.GroupMatch.html#matchedValues-picocli.CommandLine.Model.ArgSpec-">matched arguments</a>.
  </p><p>
  If the returned list contains more than one <a href="../picocli/CommandLine.ParseResult.GroupMatch.html" title="class in picocli">match</a>, the user input was invalid:
  the maximum <a href="../picocli/CommandLine.ArgGroup.html#multiplicity--">multiplicity</a> of a group was exceeded, and the parser created an extra
@@ -712,7 +719,23 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <li class="blockList">
 <h4>subcommand</h4>
 <pre>public&nbsp;<a href="../picocli/CommandLine.ParseResult.html" title="class in picocli">CommandLine.ParseResult</a>&nbsp;subcommand()</pre>
-<div class="block">Returns the <code>ParseResult</code> for the subcommand of this command that was matched on the command line, or <code>null</code> if no subcommand was matched.</div>
+<div class="block">Returns the <code>ParseResult</code> for the last subcommand of this command that was matched on the command line, or <code>null</code> if no subcommand was matched.</div>
+</li>
+</ul>
+<a name="subcommands--">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>subcommands</h4>
+<pre>public&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;<a href="../picocli/CommandLine.ParseResult.html" title="class in picocli">CommandLine.ParseResult</a>&gt;&nbsp;subcommands()</pre>
+<div class="block">Returns a list with the <code>ParseResult</code> objects for each subcommand of this command
+ that was matched on the command line or an empty list if no subcommands were matched.
+ The returned list can only contain multiple values if this command's <a href="../picocli/CommandLine.Model.CommandSpec.html#subcommandsRepeatable--"><code>subcommandsRepeatable</code></a> attribute is <code>true</code>.</div>
+<dl>
+<dt><span class="simpleTagLabel">Since:</span></dt>
+<dd>4.2</dd>
+</dl>
 </li>
 </ul>
 <a name="isUsageHelpRequested--">
@@ -742,7 +765,8 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <li class="blockList">
 <h4>asCommandLineList</h4>
 <pre>public&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;<a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a>&gt;&nbsp;asCommandLineList()</pre>
-<div class="block">Returns this <code>ParseResult</code> as a list of <code>CommandLine</code> objects, one for each matched command/subcommand.</div>
+<div class="block">Returns this <code>ParseResult</code> as a list of <code>CommandLine</code> objects, one for each matched command/subcommand.
+ Note that for repeatable subcommands, there may be multiple commands at each level of the hierarchy in the returned list.</div>
 <dl>
 <dt><span class="simpleTagLabel">Since:</span></dt>
 <dd>3.0</dd>
diff --git a/docs/apidocs/picocli/CommandLine.PicocliException.html b/docs/apidocs/picocli/CommandLine.PicocliException.html
index 03293d83..1cfd2f65 100644
--- a/docs/apidocs/picocli/CommandLine.PicocliException.html
+++ b/docs/apidocs/picocli/CommandLine.PicocliException.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.PicocliException (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>CommandLine.PicocliException (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.PicocliException (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.PicocliException (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.PropertiesDefaultProvider.html b/docs/apidocs/picocli/CommandLine.PropertiesDefaultProvider.html
index e440fbc9..a7c0d078 100644
--- a/docs/apidocs/picocli/CommandLine.PropertiesDefaultProvider.html
+++ b/docs/apidocs/picocli/CommandLine.PropertiesDefaultProvider.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.PropertiesDefaultProvider (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>CommandLine.PropertiesDefaultProvider (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.PropertiesDefaultProvider (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.PropertiesDefaultProvider (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Range.html b/docs/apidocs/picocli/CommandLine.Range.html
index 71ac5909..7d29d2c0 100644
--- a/docs/apidocs/picocli/CommandLine.Range.html
+++ b/docs/apidocs/picocli/CommandLine.Range.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.Range (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>CommandLine.Range (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Range (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Range (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.RegexTransformer.Builder.html b/docs/apidocs/picocli/CommandLine.RegexTransformer.Builder.html
index af32de00..0010b838 100644
--- a/docs/apidocs/picocli/CommandLine.RegexTransformer.Builder.html
+++ b/docs/apidocs/picocli/CommandLine.RegexTransformer.Builder.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.RegexTransformer.Builder (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>CommandLine.RegexTransformer.Builder (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.RegexTransformer.Builder (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.RegexTransformer.Builder (picocli 4.2.0 API)";
         }
     }
     catch(err) {
@@ -264,8 +264,8 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <dl>
 <dt><span class="paramLabel">Parameters:</span></dt>
 <dd><code>regex</code> - regular expression to match an option name</dd>
-<dd><code>negativeReplacement</code> - the replacement to use to generate a negative name when the option name matches</dd>
-<dd><code>synopsisReplacement</code> - the replacement to use to generate a documentation string when the option name matches</dd>
+<dd><code>negativeReplacement</code> - the replacement to use to generate a <a href="../picocli/CommandLine.RegexTransformer.html#makeNegative-java.lang.String-picocli.CommandLine.Model.CommandSpec-">negative name</a> when the option name matches</dd>
+<dd><code>synopsisReplacement</code> - the replacement to use to generate a <a href="../picocli/CommandLine.RegexTransformer.html#makeSynopsis-java.lang.String-picocli.CommandLine.Model.CommandSpec-">documentation string</a> when the option name matches</dd>
 <dt><span class="returnLabel">Returns:</span></dt>
 <dd>this <code>RegexTransformer</code> for method chaining</dd>
 </dl>
diff --git a/docs/apidocs/picocli/CommandLine.RegexTransformer.html b/docs/apidocs/picocli/CommandLine.RegexTransformer.html
index d0779c53..089f197d 100644
--- a/docs/apidocs/picocli/CommandLine.RegexTransformer.html
+++ b/docs/apidocs/picocli/CommandLine.RegexTransformer.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.RegexTransformer (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>CommandLine.RegexTransformer (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.RegexTransformer (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.RegexTransformer (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.RunAll.html b/docs/apidocs/picocli/CommandLine.RunAll.html
index 6af00c68..473f1701 100644
--- a/docs/apidocs/picocli/CommandLine.RunAll.html
+++ b/docs/apidocs/picocli/CommandLine.RunAll.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.RunAll (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>CommandLine.RunAll (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.RunAll (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.RunAll (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.RunFirst.html b/docs/apidocs/picocli/CommandLine.RunFirst.html
index 348a6c1c..a798da0b 100644
--- a/docs/apidocs/picocli/CommandLine.RunFirst.html
+++ b/docs/apidocs/picocli/CommandLine.RunFirst.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.RunFirst (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>CommandLine.RunFirst (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.RunFirst (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.RunFirst (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.RunLast.html b/docs/apidocs/picocli/CommandLine.RunLast.html
index 8291ea77..9f33dbc8 100644
--- a/docs/apidocs/picocli/CommandLine.RunLast.html
+++ b/docs/apidocs/picocli/CommandLine.RunLast.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.RunLast (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>CommandLine.RunLast (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.RunLast (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.RunLast (picocli 4.2.0 API)";
         }
     }
     catch(err) {
@@ -291,9 +291,11 @@ implements <a href="../picocli/CommandLine.IParseResultHandler.html" title="inte
                                       <a href="https://docs.oracle.com/javase/8/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io">PrintStream</a>&nbsp;out,
                                       <a href="../picocli/CommandLine.Help.Ansi.html" title="enum in picocli">CommandLine.Help.Ansi</a>&nbsp;ansi)</pre>
 <div class="block">Prints help if requested, and otherwise executes the most specific <code>Runnable</code> or <code>Callable</code> subcommand.
- Finally, either a list of result objects is returned, or the JVM is terminated if an exit code <a href="../picocli/CommandLine.AbstractHandler.html#andExit-int-">was set</a>.
- If the last (sub)command does not implement either <code>Runnable</code> or <code>Callable</code>, an <code>ExecutionException</code>
- is thrown detailing the problem and capturing the offending <code>CommandLine</code> object.</div>
+ <p>For <a href="../picocli/CommandLine.Command.html#subcommandsRepeatable--">repeatable subcommands</a>, this method
+ may execute multiple subcommands: the most deeply nested subcommands that have the same parent command.</p>
+ <p>Finally, either a list of result objects is returned, or the JVM is terminated if an exit code <a href="../picocli/CommandLine.AbstractHandler.html#andExit-int-">was set</a>.</p>
+ <p>If the last (sub)command does not implement either <code>Runnable</code> or <code>Callable</code>, an <code>ExecutionException</code>
+ is thrown detailing the problem and capturing the offending <code>CommandLine</code> object.</p></div>
 <dl>
 <dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
 <dd><code><a href="../picocli/CommandLine.IParseResultHandler.html#handleParseResult-java.util.List-java.io.PrintStream-picocli.CommandLine.Help.Ansi-">handleParseResult</a></code>&nbsp;in interface&nbsp;<code><a href="../picocli/CommandLine.IParseResultHandler.html" title="interface in picocli">CommandLine.IParseResultHandler</a></code></dd>
@@ -321,8 +323,10 @@ implements <a href="../picocli/CommandLine.IParseResultHandler.html" title="inte
 <pre>protected&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&gt;&nbsp;handle(<a href="../picocli/CommandLine.ParseResult.html" title="class in picocli">CommandLine.ParseResult</a>&nbsp;parseResult)
                        throws <a href="../picocli/CommandLine.ExecutionException.html" title="class in picocli">CommandLine.ExecutionException</a></pre>
 <div class="block">Executes the most specific <code>Runnable</code> or <code>Callable</code> subcommand.
- If the last (sub)command does not implement either <code>Runnable</code> or <code>Callable</code> and is not a <code>Method</code>, an <code>ExecutionException</code>
- is thrown detailing the problem and capturing the offending <code>CommandLine</code> object.</div>
+ <p>For <a href="../picocli/CommandLine.Command.html#subcommandsRepeatable--">repeatable subcommands</a>, this method
+ may execute multiple subcommands: the most deeply nested subcommands that have the same parent command.</p>
+ <p>If the user object of the executed (sub)command does not implement either <code>Runnable</code> or <code>Callable</code> and is not a <code>Method</code>, an <code>ExecutionException</code>
+ is thrown detailing the problem and capturing the offending <code>CommandLine</code> object.</p></div>
 <dl>
 <dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
 <dd><code><a href="../picocli/CommandLine.AbstractParseResultHandler.html#handle-picocli.CommandLine.ParseResult-">handle</a></code>&nbsp;in class&nbsp;<code><a href="../picocli/CommandLine.AbstractParseResultHandler.html" title="class in picocli">CommandLine.AbstractParseResultHandler</a>&lt;<a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&gt;&gt;</code></dd>
diff --git a/docs/apidocs/picocli/CommandLine.Spec.html b/docs/apidocs/picocli/CommandLine.Spec.html
index e613116d..cd5fd273 100644
--- a/docs/apidocs/picocli/CommandLine.Spec.html
+++ b/docs/apidocs/picocli/CommandLine.Spec.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.Spec (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>CommandLine.Spec (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Spec (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Spec (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.TypeConversionException.html b/docs/apidocs/picocli/CommandLine.TypeConversionException.html
index 0523542c..8af82544 100644
--- a/docs/apidocs/picocli/CommandLine.TypeConversionException.html
+++ b/docs/apidocs/picocli/CommandLine.TypeConversionException.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.TypeConversionException (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>CommandLine.TypeConversionException (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.TypeConversionException (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.TypeConversionException (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.Unmatched.html b/docs/apidocs/picocli/CommandLine.Unmatched.html
index ebc6bccd..fda4cbfd 100644
--- a/docs/apidocs/picocli/CommandLine.Unmatched.html
+++ b/docs/apidocs/picocli/CommandLine.Unmatched.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.Unmatched (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>CommandLine.Unmatched (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.Unmatched (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.Unmatched (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.UnmatchedArgumentException.html b/docs/apidocs/picocli/CommandLine.UnmatchedArgumentException.html
index 97ee3cea..b09e673a 100644
--- a/docs/apidocs/picocli/CommandLine.UnmatchedArgumentException.html
+++ b/docs/apidocs/picocli/CommandLine.UnmatchedArgumentException.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>CommandLine.UnmatchedArgumentException (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>CommandLine.UnmatchedArgumentException (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine.UnmatchedArgumentException (picocli 4.1.4 API)";
+            parent.document.title="CommandLine.UnmatchedArgumentException (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/CommandLine.html b/docs/apidocs/picocli/CommandLine.html
index a27dfc72..dd686754 100644
--- a/docs/apidocs/picocli/CommandLine.html
+++ b/docs/apidocs/picocli/CommandLine.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:43 JST 2019 -->
-<title>CommandLine (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:49 JST 2020 -->
+<title>CommandLine (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,13 +12,13 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="CommandLine (picocli 4.1.4 API)";
+            parent.document.title="CommandLine (picocli 4.2.0 API)";
         }
     }
     catch(err) {
     }
 //-->
-var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":41,"i5":41,"i6":41,"i7":41,"i8":41,"i9":41,"i10":41,"i11":41,"i12":10,"i13":9,"i14":9,"i15":10,"i16":9,"i17":10,"i18":10,"i19":10,"i20":9,"i21":10,"i22":10,"i23":10,"i24":10,"i25":10,"i26":10,"i27":10,"i28":10,"i29":10,"i30":10,"i31":10,"i32":10,"i33":10,"i34":10,"i35":10,"i36":10,"i37":10,"i38":10,"i39":10,"i40":10,"i41":10,"i42":10,"i43":10,"i44":10,"i45":10,"i46":10,"i47":10,"i48":41,"i49":41,"i50":41,"i51":41,"i52":10,"i53":10,"i54":10,"i55":10,"i56":10,"i57":10,"i58":42,"i59":10,"i60":10,"i61":10,"i62":10,"i63":10,"i64":10,"i65":10,"i66":10,"i67":10,"i68":10,"i69":42,"i70":10,"i71":42,"i72":42,"i73":42,"i74":42,"i75":9,"i76":9,"i77":9,"i78":41,"i79":41,"i80":41,"i81":10,"i82":10,"i83":10,"i84":10,"i85":10,"i86":10,"i87":41,"i88":41,"i89":41,"i90":41,"i91":41,"i92":41,"i93":41,"i94":41,"i95":10,"i96":10,"i97":10,"i98":10,"i99":10,"i100":10,"i101":10,"i102":10,"i103":10,"i104":10,"i105":10,"i106":10,"i107":10,"i108":10,"i109":10,"i110":10,"i111":10,"i112":10,"i113":10,"i114":10,"i115":10,"i116":10,"i117":10,"i118":10,"i119":42,"i120":10,"i121":10,"i122":10,"i123":10,"i124":10,"i125":10,"i126":10,"i127":10,"i128":10,"i129":9,"i130":9,"i131":9,"i132":10,"i133":10,"i134":10,"i135":10,"i136":10,"i137":10};
+var methods = {"i0":10,"i1":10,"i2":10,"i3":10,"i4":41,"i5":41,"i6":41,"i7":41,"i8":41,"i9":41,"i10":41,"i11":41,"i12":10,"i13":9,"i14":9,"i15":10,"i16":9,"i17":10,"i18":10,"i19":10,"i20":9,"i21":10,"i22":10,"i23":10,"i24":10,"i25":10,"i26":10,"i27":10,"i28":10,"i29":10,"i30":10,"i31":10,"i32":10,"i33":10,"i34":10,"i35":10,"i36":10,"i37":10,"i38":10,"i39":10,"i40":10,"i41":10,"i42":10,"i43":10,"i44":10,"i45":10,"i46":10,"i47":10,"i48":10,"i49":41,"i50":41,"i51":41,"i52":41,"i53":10,"i54":10,"i55":10,"i56":10,"i57":10,"i58":10,"i59":42,"i60":10,"i61":10,"i62":10,"i63":10,"i64":10,"i65":10,"i66":10,"i67":10,"i68":10,"i69":10,"i70":42,"i71":10,"i72":42,"i73":42,"i74":42,"i75":42,"i76":9,"i77":9,"i78":9,"i79":41,"i80":41,"i81":41,"i82":10,"i83":10,"i84":10,"i85":10,"i86":10,"i87":10,"i88":41,"i89":41,"i90":41,"i91":41,"i92":41,"i93":41,"i94":41,"i95":41,"i96":10,"i97":10,"i98":10,"i99":10,"i100":10,"i101":10,"i102":10,"i103":10,"i104":10,"i105":10,"i106":10,"i107":10,"i108":10,"i109":10,"i110":10,"i111":10,"i112":10,"i113":10,"i114":10,"i115":10,"i116":10,"i117":10,"i118":10,"i119":10,"i120":42,"i121":10,"i122":10,"i123":10,"i124":10,"i125":10,"i126":10,"i127":10,"i128":10,"i129":10,"i130":10,"i131":9,"i132":9,"i133":9,"i134":10,"i135":10,"i136":10,"i137":10,"i138":10,"i139":10};
 var tabs = {65535:["t0","All Methods"],1:["t1","Static Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"],32:["t6","Deprecated Methods"]};
 var altColor = "altColor";
 var rowColor = "rowColor";
@@ -603,7 +603,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <tr class="altColor">
 <td class="colFirst"><code>static <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#VERSION">VERSION</a></span></code>
-<div class="block">This is picocli version "4.1.4".</div>
+<div class="block">This is picocli version "4.2.0".</div>
 </td>
 </tr>
 </table>
@@ -961,29 +961,35 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </tr>
 <tr id="i44" class="altColor">
 <td class="colFirst"><code>int</code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#getUsageHelpLongOptionsMaxWidth--">getUsageHelpLongOptionsMaxWidth</a></span>()</code>
+<div class="block">Returns the maximum usage help long options column max width to the specified value.</div>
+</td>
+</tr>
+<tr id="i45" class="rowColor">
+<td class="colFirst"><code>int</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#getUsageHelpWidth--">getUsageHelpWidth</a></span>()</code>
 <div class="block">Returns the maximum width of the usage help message.</div>
 </td>
 </tr>
-<tr id="i45" class="rowColor">
+<tr id="i46" class="altColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#getUsageMessage--">getUsageMessage</a></span>()</code>
 <div class="block">Similar to <a href="../picocli/CommandLine.html#usage-java.io.PrintStream-"><code>usage(PrintStream)</code></a>, but returns the usage help message as a String instead of printing it to the <code>PrintStream</code>.</div>
 </td>
 </tr>
-<tr id="i46" class="altColor">
+<tr id="i47" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#getUsageMessage-picocli.CommandLine.Help.Ansi-">getUsageMessage</a></span>(<a href="../picocli/CommandLine.Help.Ansi.html" title="enum in picocli">CommandLine.Help.Ansi</a>&nbsp;ansi)</code>
 <div class="block">Similar to <a href="../picocli/CommandLine.html#usage-java.io.PrintStream-picocli.CommandLine.Help.Ansi-"><code>usage(PrintStream, Help.Ansi)</code></a>, but returns the usage help message as a String instead of printing it to the <code>PrintStream</code>.</div>
 </td>
 </tr>
-<tr id="i47" class="rowColor">
+<tr id="i48" class="altColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#getUsageMessage-picocli.CommandLine.Help.ColorScheme-">getUsageMessage</a></span>(<a href="../picocli/CommandLine.Help.ColorScheme.html" title="class in picocli">CommandLine.Help.ColorScheme</a>&nbsp;colorScheme)</code>
 <div class="block">Similar to <a href="../picocli/CommandLine.html#usage-java.io.PrintStream-picocli.CommandLine.Help.ColorScheme-"><code>usage(PrintStream, Help.ColorScheme)</code></a>, but returns the usage help message as a String instead of printing it to the <code>PrintStream</code>.</div>
 </td>
 </tr>
-<tr id="i48" class="altColor">
+<tr id="i49" class="rowColor">
 <td class="colFirst"><code>static <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#invoke-java.lang.String-java.lang.Class-java.io.PrintStream-picocli.CommandLine.Help.Ansi-java.lang.String...-">invoke</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;methodName,
       <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a>&lt;?&gt;&nbsp;cls,
@@ -995,7 +1001,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </div>
 </td>
 </tr>
-<tr id="i49" class="rowColor">
+<tr id="i50" class="altColor">
 <td class="colFirst"><code>static <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#invoke-java.lang.String-java.lang.Class-java.io.PrintStream-java.io.PrintStream-picocli.CommandLine.Help.Ansi-java.lang.String...-">invoke</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;methodName,
       <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a>&lt;?&gt;&nbsp;cls,
@@ -1008,7 +1014,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </div>
 </td>
 </tr>
-<tr id="i50" class="altColor">
+<tr id="i51" class="rowColor">
 <td class="colFirst"><code>static <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#invoke-java.lang.String-java.lang.Class-java.io.PrintStream-java.lang.String...-">invoke</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;methodName,
       <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a>&lt;?&gt;&nbsp;cls,
@@ -1019,7 +1025,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </div>
 </td>
 </tr>
-<tr id="i51" class="rowColor">
+<tr id="i52" class="altColor">
 <td class="colFirst"><code>static <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#invoke-java.lang.String-java.lang.Class-java.lang.String...-">invoke</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;methodName,
       <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a>&lt;?&gt;&nbsp;cls,
@@ -1029,44 +1035,44 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </div>
 </td>
 </tr>
-<tr id="i52" class="altColor">
+<tr id="i53" class="rowColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#isAdjustLineBreaksForWideCJKCharacters--">isAdjustLineBreaksForWideCJKCharacters</a></span>()</code>
 <div class="block">Returns whether line breaks should take wide Chinese, Japanese and Korean characters into account for line-breaking purposes.</div>
 </td>
 </tr>
-<tr id="i53" class="rowColor">
+<tr id="i54" class="altColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#isCaseInsensitiveEnumValuesAllowed--">isCaseInsensitiveEnumValuesAllowed</a></span>()</code>
 <div class="block">Returns whether the parser should ignore case when converting arguments to <code>enum</code> values.</div>
 </td>
 </tr>
-<tr id="i54" class="altColor">
+<tr id="i55" class="rowColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#isExpandAtFiles--">isExpandAtFiles</a></span>()</code>
 <div class="block">Returns whether arguments starting with <code>'@'</code> should be treated as the path to an argument file and its
  contents should be expanded into separate arguments for each line in the specified file.</div>
 </td>
 </tr>
-<tr id="i55" class="rowColor">
+<tr id="i56" class="altColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#isInterpolateVariables--">isInterpolateVariables</a></span>()</code>
 <div class="block">Returns whether whether variables should be interpolated in String values.</div>
 </td>
 </tr>
-<tr id="i56" class="altColor">
+<tr id="i57" class="rowColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#isOverwrittenOptionsAllowed--">isOverwrittenOptionsAllowed</a></span>()</code>
 <div class="block">Returns whether options for single-value fields can be specified multiple times on the command line.</div>
 </td>
 </tr>
-<tr id="i57" class="rowColor">
+<tr id="i58" class="altColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#isPosixClusteredShortOptionsAllowed--">isPosixClusteredShortOptionsAllowed</a></span>()</code>
 <div class="block">Returns whether the parser accepts clustered short options.</div>
 </td>
 </tr>
-<tr id="i58" class="altColor">
+<tr id="i59" class="rowColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#isSplitQuotedStrings--">isSplitQuotedStrings</a></span>()</code>
 <div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;
@@ -1075,70 +1081,70 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </div>
 </td>
 </tr>
-<tr id="i59" class="rowColor">
+<tr id="i60" class="altColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#isStopAtPositional--">isStopAtPositional</a></span>()</code>
 <div class="block">Returns whether the parser interprets the first positional parameter as "end of options" so the remaining
  arguments are all treated as positional parameters.</div>
 </td>
 </tr>
-<tr id="i60" class="altColor">
+<tr id="i61" class="rowColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#isStopAtUnmatched--">isStopAtUnmatched</a></span>()</code>
 <div class="block">Returns whether the parser should stop interpreting options and positional parameters as soon as it encounters an
  unmatched option.</div>
 </td>
 </tr>
-<tr id="i61" class="rowColor">
+<tr id="i62" class="altColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#isToggleBooleanFlags--">isToggleBooleanFlags</a></span>()</code>
 <div class="block">Returns whether the value of boolean flag options should be "toggled" when the option is matched.</div>
 </td>
 </tr>
-<tr id="i62" class="altColor">
+<tr id="i63" class="rowColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#isTrimQuotes--">isTrimQuotes</a></span>()</code>
 <div class="block">Returns whether the parser should trim quotes from command line arguments.</div>
 </td>
 </tr>
-<tr id="i63" class="rowColor">
+<tr id="i64" class="altColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#isUnmatchedArgumentsAllowed--">isUnmatchedArgumentsAllowed</a></span>()</code>
 <div class="block">Returns whether the end user may specify arguments on the command line that are not matched to any option or parameter fields.</div>
 </td>
 </tr>
-<tr id="i64" class="altColor">
+<tr id="i65" class="rowColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#isUnmatchedOptionsArePositionalParams--">isUnmatchedOptionsArePositionalParams</a></span>()</code>
 <div class="block">Returns whether arguments on the command line that resemble an option should be treated as positional parameters.</div>
 </td>
 </tr>
-<tr id="i65" class="rowColor">
+<tr id="i66" class="altColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#isUsageHelpAutoWidth--">isUsageHelpAutoWidth</a></span>()</code>
 <div class="block">Returns whether picocli should attempt to detect the terminal size and adjust the usage help message width
  to take the full terminal width.</div>
 </td>
 </tr>
-<tr id="i66" class="altColor">
+<tr id="i67" class="rowColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#isUsageHelpRequested--">isUsageHelpRequested</a></span>()</code>
 <div class="block">Returns <code>true</code> if an option annotated with <a href="../picocli/CommandLine.Option.html#usageHelp--"><code>CommandLine.Option.usageHelp()</code></a> was specified on the command line.</div>
 </td>
 </tr>
-<tr id="i67" class="rowColor">
+<tr id="i68" class="altColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#isUseSimplifiedAtFiles--">isUseSimplifiedAtFiles</a></span>()</code>
 <div class="block">Returns whether to use a simplified argument file format that is compatible with JCommander.</div>
 </td>
 </tr>
-<tr id="i68" class="altColor">
+<tr id="i69" class="rowColor">
 <td class="colFirst"><code>boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#isVersionHelpRequested--">isVersionHelpRequested</a></span>()</code>
 <div class="block">Returns <code>true</code> if an option annotated with <a href="../picocli/CommandLine.Option.html#versionHelp--"><code>CommandLine.Option.versionHelp()</code></a> was specified on the command line.</div>
 </td>
 </tr>
-<tr id="i69" class="rowColor">
+<tr id="i70" class="altColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;<a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a>&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#parse-java.lang.String...-">parse</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>...&nbsp;args)</code>
 <div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;
@@ -1146,14 +1152,14 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </div>
 </td>
 </tr>
-<tr id="i70" class="altColor">
+<tr id="i71" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.ParseResult.html" title="class in picocli">CommandLine.ParseResult</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#parseArgs-java.lang.String...-">parseArgs</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>...&nbsp;args)</code>
 <div class="block">Parses the specified command line arguments and returns a list of <code>ParseResult</code> with the options, positional
  parameters, and subcommands (if any) that were recognized and initialized during the parsing process.</div>
 </td>
 </tr>
-<tr id="i71" class="rowColor">
+<tr id="i72" class="altColor">
 <td class="colFirst"><code>&lt;R&gt;&nbsp;R</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#parseWithHandler-picocli.CommandLine.IParseResultHandler2-java.lang.String:A-">parseWithHandler</a></span>(<a href="../picocli/CommandLine.IParseResultHandler2.html" title="interface in picocli">CommandLine.IParseResultHandler2</a>&lt;R&gt;&nbsp;handler,
                 <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>[]&nbsp;args)</code>
@@ -1162,7 +1168,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </div>
 </td>
 </tr>
-<tr id="i72" class="altColor">
+<tr id="i73" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#parseWithHandler-picocli.CommandLine.IParseResultHandler-java.io.PrintStream-java.lang.String...-">parseWithHandler</a></span>(<a href="../picocli/CommandLine.IParseResultHandler.html" title="interface in picocli">CommandLine.IParseResultHandler</a>&nbsp;handler,
                 <a href="https://docs.oracle.com/javase/8/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io">PrintStream</a>&nbsp;out,
@@ -1172,7 +1178,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </div>
 </td>
 </tr>
-<tr id="i73" class="rowColor">
+<tr id="i74" class="altColor">
 <td class="colFirst"><code>&lt;R&gt;&nbsp;R</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#parseWithHandlers-picocli.CommandLine.IParseResultHandler2-picocli.CommandLine.IExceptionHandler2-java.lang.String...-">parseWithHandlers</a></span>(<a href="../picocli/CommandLine.IParseResultHandler2.html" title="interface in picocli">CommandLine.IParseResultHandler2</a>&lt;R&gt;&nbsp;handler,
                  <a href="../picocli/CommandLine.IExceptionHandler2.html" title="interface in picocli">CommandLine.IExceptionHandler2</a>&lt;R&gt;&nbsp;exceptionHandler,
@@ -1182,7 +1188,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </div>
 </td>
 </tr>
-<tr id="i74" class="altColor">
+<tr id="i75" class="rowColor">
 <td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&gt;</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#parseWithHandlers-picocli.CommandLine.IParseResultHandler-java.io.PrintStream-picocli.CommandLine.Help.Ansi-picocli.CommandLine.IExceptionHandler-java.lang.String...-">parseWithHandlers</a></span>(<a href="../picocli/CommandLine.IParseResultHandler.html" title="interface in picocli">CommandLine.IParseResultHandler</a>&nbsp;handler,
                  <a href="https://docs.oracle.com/javase/8/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io">PrintStream</a>&nbsp;out,
@@ -1194,7 +1200,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </div>
 </td>
 </tr>
-<tr id="i75" class="rowColor">
+<tr id="i76" class="altColor">
 <td class="colFirst"><code>static &lt;T&gt;&nbsp;T</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#populateCommand-T-java.lang.String...-">populateCommand</a></span>(T&nbsp;command,
                <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>...&nbsp;args)</code>
@@ -1202,7 +1208,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
  Convenience method that initializes the specified annotated object from the specified command line arguments.</div>
 </td>
 </tr>
-<tr id="i76" class="altColor">
+<tr id="i77" class="rowColor">
 <td class="colFirst"><code>static &lt;T&gt;&nbsp;T</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#populateSpec-java.lang.Class-java.lang.String...-">populateSpec</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a>&lt;T&gt;&nbsp;spec,
             <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>...&nbsp;args)</code>
@@ -1211,13 +1217,13 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
  instance of the specified interface.</div>
 </td>
 </tr>
-<tr id="i77" class="rowColor">
+<tr id="i78" class="altColor">
 <td class="colFirst"><code>static boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#printHelpIfRequested-picocli.CommandLine.ParseResult-">printHelpIfRequested</a></span>(<a href="../picocli/CommandLine.ParseResult.html" title="class in picocli">CommandLine.ParseResult</a>&nbsp;parseResult)</code>
 <div class="block">Delegates to <a href="../picocli/CommandLine.html#executeHelpRequest-picocli.CommandLine.ParseResult-"><code>executeHelpRequest(ParseResult)</code></a>.</div>
 </td>
 </tr>
-<tr id="i78" class="altColor">
+<tr id="i79" class="rowColor">
 <td class="colFirst"><code>static boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#printHelpIfRequested-java.util.List-java.io.PrintStream-picocli.CommandLine.Help.Ansi-">printHelpIfRequested</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;<a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a>&gt;&nbsp;parsedCommands,
                     <a href="https://docs.oracle.com/javase/8/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io">PrintStream</a>&nbsp;out,
@@ -1227,7 +1233,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </div>
 </td>
 </tr>
-<tr id="i79" class="rowColor">
+<tr id="i80" class="altColor">
 <td class="colFirst"><code>static boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#printHelpIfRequested-java.util.List-java.io.PrintStream-java.io.PrintStream-picocli.CommandLine.Help.Ansi-">printHelpIfRequested</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;<a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a>&gt;&nbsp;parsedCommands,
                     <a href="https://docs.oracle.com/javase/8/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io">PrintStream</a>&nbsp;out,
@@ -1238,7 +1244,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </div>
 </td>
 </tr>
-<tr id="i80" class="altColor">
+<tr id="i81" class="rowColor">
 <td class="colFirst"><code>static boolean</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#printHelpIfRequested-java.util.List-java.io.PrintStream-java.io.PrintStream-picocli.CommandLine.Help.ColorScheme-">printHelpIfRequested</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;<a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a>&gt;&nbsp;parsedCommands,
                     <a href="https://docs.oracle.com/javase/8/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io">PrintStream</a>&nbsp;out,
@@ -1249,20 +1255,20 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </div>
 </td>
 </tr>
-<tr id="i81" class="rowColor">
+<tr id="i82" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#printVersionHelp-java.io.PrintStream-">printVersionHelp</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io">PrintStream</a>&nbsp;out)</code>
 <div class="block">Delegates to <a href="../picocli/CommandLine.html#printVersionHelp-java.io.PrintStream-picocli.CommandLine.Help.Ansi-"><code>printVersionHelp(PrintStream, Help.Ansi)</code></a> with the ANSI setting of the <a href="../picocli/CommandLine.html#getColorScheme--">configured</a> color scheme.</div>
 </td>
 </tr>
-<tr id="i82" class="altColor">
+<tr id="i83" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#printVersionHelp-java.io.PrintStream-picocli.CommandLine.Help.Ansi-">printVersionHelp</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io">PrintStream</a>&nbsp;out,
                 <a href="../picocli/CommandLine.Help.Ansi.html" title="enum in picocli">CommandLine.Help.Ansi</a>&nbsp;ansi)</code>
 <div class="block">Prints version information from the <a href="../picocli/CommandLine.Command.html#version--"><code>CommandLine.Command.version()</code></a> annotation to the specified <code>PrintStream</code>.</div>
 </td>
 </tr>
-<tr id="i83" class="rowColor">
+<tr id="i84" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#printVersionHelp-java.io.PrintStream-picocli.CommandLine.Help.Ansi-java.lang.Object...-">printVersionHelp</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io">PrintStream</a>&nbsp;out,
                 <a href="../picocli/CommandLine.Help.Ansi.html" title="enum in picocli">CommandLine.Help.Ansi</a>&nbsp;ansi,
@@ -1270,13 +1276,13 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <div class="block">Prints version information from the <a href="../picocli/CommandLine.Command.html#version--"><code>CommandLine.Command.version()</code></a> annotation to the specified <code>PrintStream</code>.</div>
 </td>
 </tr>
-<tr id="i84" class="altColor">
+<tr id="i85" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#printVersionHelp-java.io.PrintWriter-">printVersionHelp</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/io/PrintWriter.html?is-external=true" title="class or interface in java.io">PrintWriter</a>&nbsp;out)</code>
 <div class="block">Delegates to <a href="../picocli/CommandLine.html#printVersionHelp-java.io.PrintWriter-picocli.CommandLine.Help.Ansi-java.lang.Object...-"><code>printVersionHelp(PrintWriter, Help.Ansi, Object...)</code></a> with the ANSI setting of the <a href="../picocli/CommandLine.html#getColorScheme--">configured</a> color scheme.</div>
 </td>
 </tr>
-<tr id="i85" class="rowColor">
+<tr id="i86" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#printVersionHelp-java.io.PrintWriter-picocli.CommandLine.Help.Ansi-java.lang.Object...-">printVersionHelp</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/io/PrintWriter.html?is-external=true" title="class or interface in java.io">PrintWriter</a>&nbsp;out,
                 <a href="../picocli/CommandLine.Help.Ansi.html" title="enum in picocli">CommandLine.Help.Ansi</a>&nbsp;ansi,
@@ -1284,14 +1290,14 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <div class="block">Prints version information from the <a href="../picocli/CommandLine.Command.html#version--"><code>CommandLine.Command.version()</code></a> annotation to the specified <code>PrintWriter</code>.</div>
 </td>
 </tr>
-<tr id="i86" class="altColor">
+<tr id="i87" class="rowColor">
 <td class="colFirst"><code>&lt;K&gt;&nbsp;<a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#registerConverter-java.lang.Class-picocli.CommandLine.ITypeConverter-">registerConverter</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a>&lt;K&gt;&nbsp;cls,
                  <a href="../picocli/CommandLine.ITypeConverter.html" title="interface in picocli">CommandLine.ITypeConverter</a>&lt;K&gt;&nbsp;converter)</code>
 <div class="block">Registers the specified type converter for the specified class.</div>
 </td>
 </tr>
-<tr id="i87" class="rowColor">
+<tr id="i88" class="altColor">
 <td class="colFirst"><code>static &lt;R extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Runnable.html?is-external=true" title="class or interface in java.lang">Runnable</a>&gt;<br>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#run-java.lang.Class-picocli.CommandLine.IFactory-java.io.PrintStream-picocli.CommandLine.Help.Ansi-java.lang.String...-">run</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a>&lt;R&gt;&nbsp;runnableClass,
    <a href="../picocli/CommandLine.IFactory.html" title="interface in picocli">CommandLine.IFactory</a>&nbsp;factory,
@@ -1303,7 +1309,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </div>
 </td>
 </tr>
-<tr id="i88" class="altColor">
+<tr id="i89" class="rowColor">
 <td class="colFirst"><code>static &lt;R extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Runnable.html?is-external=true" title="class or interface in java.lang">Runnable</a>&gt;<br>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#run-java.lang.Class-picocli.CommandLine.IFactory-java.io.PrintStream-java.io.PrintStream-picocli.CommandLine.Help.Ansi-java.lang.String...-">run</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a>&lt;R&gt;&nbsp;runnableClass,
    <a href="../picocli/CommandLine.IFactory.html" title="interface in picocli">CommandLine.IFactory</a>&nbsp;factory,
@@ -1316,7 +1322,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </div>
 </td>
 </tr>
-<tr id="i89" class="rowColor">
+<tr id="i90" class="altColor">
 <td class="colFirst"><code>static &lt;R extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Runnable.html?is-external=true" title="class or interface in java.lang">Runnable</a>&gt;<br>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#run-java.lang.Class-picocli.CommandLine.IFactory-java.io.PrintStream-java.lang.String...-">run</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a>&lt;R&gt;&nbsp;runnableClass,
    <a href="../picocli/CommandLine.IFactory.html" title="interface in picocli">CommandLine.IFactory</a>&nbsp;factory,
@@ -1327,7 +1333,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </div>
 </td>
 </tr>
-<tr id="i90" class="altColor">
+<tr id="i91" class="rowColor">
 <td class="colFirst"><code>static &lt;R extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Runnable.html?is-external=true" title="class or interface in java.lang">Runnable</a>&gt;<br>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#run-java.lang.Class-picocli.CommandLine.IFactory-java.lang.String...-">run</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Class.html?is-external=true" title="class or interface in java.lang">Class</a>&lt;R&gt;&nbsp;runnableClass,
    <a href="../picocli/CommandLine.IFactory.html" title="interface in picocli">CommandLine.IFactory</a>&nbsp;factory,
@@ -1337,7 +1343,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </div>
 </td>
 </tr>
-<tr id="i91" class="rowColor">
+<tr id="i92" class="altColor">
 <td class="colFirst"><code>static &lt;R extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Runnable.html?is-external=true" title="class or interface in java.lang">Runnable</a>&gt;<br>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#run-R-java.io.PrintStream-picocli.CommandLine.Help.Ansi-java.lang.String...-">run</a></span>(R&nbsp;runnable,
    <a href="https://docs.oracle.com/javase/8/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io">PrintStream</a>&nbsp;out,
@@ -1348,7 +1354,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </div>
 </td>
 </tr>
-<tr id="i92" class="altColor">
+<tr id="i93" class="rowColor">
 <td class="colFirst"><code>static &lt;R extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Runnable.html?is-external=true" title="class or interface in java.lang">Runnable</a>&gt;<br>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#run-R-java.io.PrintStream-java.io.PrintStream-picocli.CommandLine.Help.Ansi-java.lang.String...-">run</a></span>(R&nbsp;runnable,
    <a href="https://docs.oracle.com/javase/8/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io">PrintStream</a>&nbsp;out,
@@ -1360,7 +1366,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </div>
 </td>
 </tr>
-<tr id="i93" class="rowColor">
+<tr id="i94" class="altColor">
 <td class="colFirst"><code>static &lt;R extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Runnable.html?is-external=true" title="class or interface in java.lang">Runnable</a>&gt;<br>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#run-R-java.io.PrintStream-java.lang.String...-">run</a></span>(R&nbsp;runnable,
    <a href="https://docs.oracle.com/javase/8/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io">PrintStream</a>&nbsp;out,
@@ -1370,7 +1376,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </div>
 </td>
 </tr>
-<tr id="i94" class="altColor">
+<tr id="i95" class="rowColor">
 <td class="colFirst"><code>static &lt;R extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Runnable.html?is-external=true" title="class or interface in java.lang">Runnable</a>&gt;<br>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#run-R-java.lang.String...-">run</a></span>(R&nbsp;runnable,
    <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>...&nbsp;args)</code>
@@ -1379,155 +1385,155 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </div>
 </td>
 </tr>
-<tr id="i95" class="rowColor">
+<tr id="i96" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setAdjustLineBreaksForWideCJKCharacters-boolean-">setAdjustLineBreaksForWideCJKCharacters</a></span>(boolean&nbsp;adjustForWideChars)</code>
 <div class="block">Sets whether line breaks should take wide Chinese, Japanese and Korean characters into account, and returns this UsageMessageSpec.</div>
 </td>
 </tr>
-<tr id="i96" class="altColor">
+<tr id="i97" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setAtFileCommentChar-java.lang.Character-">setAtFileCommentChar</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Character.html?is-external=true" title="class or interface in java.lang">Character</a>&nbsp;atFileCommentChar)</code>
 <div class="block">Sets the character that starts a single-line comment or <code>null</code> if all content of argument files should
  be interpreted as arguments (without comments).</div>
 </td>
 </tr>
-<tr id="i97" class="rowColor">
+<tr id="i98" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setCaseInsensitiveEnumValuesAllowed-boolean-">setCaseInsensitiveEnumValuesAllowed</a></span>(boolean&nbsp;newValue)</code>
 <div class="block">Sets whether the parser should ignore case when converting arguments to <code>enum</code> values.</div>
 </td>
 </tr>
-<tr id="i98" class="altColor">
+<tr id="i99" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setColorScheme-picocli.CommandLine.Help.ColorScheme-">setColorScheme</a></span>(<a href="../picocli/CommandLine.Help.ColorScheme.html" title="class in picocli">CommandLine.Help.ColorScheme</a>&nbsp;colorScheme)</code>
 <div class="block">Sets the color scheme to use when printing help.</div>
 </td>
 </tr>
-<tr id="i99" class="rowColor">
+<tr id="i100" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setCommandName-java.lang.String-">setCommandName</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;commandName)</code>
 <div class="block">Sets the command name (also called program name) displayed in the usage help synopsis to the specified value.</div>
 </td>
 </tr>
-<tr id="i100" class="altColor">
+<tr id="i101" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setDefaultValueProvider-picocli.CommandLine.IDefaultValueProvider-">setDefaultValueProvider</a></span>(<a href="../picocli/CommandLine.IDefaultValueProvider.html" title="interface in picocli">CommandLine.IDefaultValueProvider</a>&nbsp;newValue)</code>
 <div class="block">Sets a default value provider for the command and sub-commands</div>
 </td>
 </tr>
-<tr id="i101" class="rowColor">
+<tr id="i102" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setEndOfOptionsDelimiter-java.lang.String-">setEndOfOptionsDelimiter</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;delimiter)</code>
 <div class="block">Sets the end-of-options delimiter that signals that the remaining command line arguments should be treated as positional parameters.</div>
 </td>
 </tr>
-<tr id="i102" class="altColor">
+<tr id="i103" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setErr-java.io.PrintWriter-">setErr</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/io/PrintWriter.html?is-external=true" title="class or interface in java.io">PrintWriter</a>&nbsp;err)</code>
 <div class="block">Sets the writer to use when printing diagnostic (error) messages during command <a href="../picocli/CommandLine.html#execute-java.lang.String...-">execution</a>.</div>
 </td>
 </tr>
-<tr id="i103" class="rowColor">
+<tr id="i104" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setExecutionExceptionHandler-picocli.CommandLine.IExecutionExceptionHandler-">setExecutionExceptionHandler</a></span>(<a href="../picocli/CommandLine.IExecutionExceptionHandler.html" title="interface in picocli">CommandLine.IExecutionExceptionHandler</a>&nbsp;executionExceptionHandler)</code>
 <div class="block">Sets a custom handler for dealing with exceptions that occurred in the <code>Callable</code>, <code>Runnable</code> or <code>Method</code>
  user object of a command when the command was executed via the <a href="../picocli/CommandLine.html#execute-java.lang.String...-">execute</a> method.</div>
 </td>
 </tr>
-<tr id="i104" class="altColor">
+<tr id="i105" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setExecutionResult-java.lang.Object-">setExecutionResult</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;result)</code>
 <div class="block">Sets the result of calling the business logic on the command's user object.</div>
 </td>
 </tr>
-<tr id="i105" class="rowColor">
+<tr id="i106" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setExecutionStrategy-picocli.CommandLine.IExecutionStrategy-">setExecutionStrategy</a></span>(<a href="../picocli/CommandLine.IExecutionStrategy.html" title="interface in picocli">CommandLine.IExecutionStrategy</a>&nbsp;executionStrategy)</code>
 <div class="block">Sets the execution strategy that the <a href="../picocli/CommandLine.html#execute-java.lang.String...-"><code>execute</code></a> method should use to invoke
  the business logic on the user objects of this command and/or the user-specified subcommand(s).</div>
 </td>
 </tr>
-<tr id="i106" class="altColor">
+<tr id="i107" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setExitCodeExceptionMapper-picocli.CommandLine.IExitCodeExceptionMapper-">setExitCodeExceptionMapper</a></span>(<a href="../picocli/CommandLine.IExitCodeExceptionMapper.html" title="interface in picocli">CommandLine.IExitCodeExceptionMapper</a>&nbsp;exitCodeExceptionMapper)</code>
 <div class="block">Sets the mapper used by the <a href="../picocli/CommandLine.html#execute-java.lang.String...-"><code>execute</code></a> method to map exceptions to exit codes.</div>
 </td>
 </tr>
-<tr id="i107" class="rowColor">
+<tr id="i108" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setExpandAtFiles-boolean-">setExpandAtFiles</a></span>(boolean&nbsp;expandAtFiles)</code>
 <div class="block">Sets whether arguments starting with <code>'@'</code> should be treated as the path to an argument file and its
  contents should be expanded into separate arguments for each line in the specified file.</div>
 </td>
 </tr>
-<tr id="i108" class="altColor">
+<tr id="i109" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setHelpFactory-picocli.CommandLine.IHelpFactory-">setHelpFactory</a></span>(<a href="../picocli/CommandLine.IHelpFactory.html" title="interface in picocli">CommandLine.IHelpFactory</a>&nbsp;helpFactory)</code>
 <div class="block">Sets a new <code>IHelpFactory</code> to customize the usage help message.</div>
 </td>
 </tr>
-<tr id="i109" class="rowColor">
+<tr id="i110" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setHelpSectionKeys-java.util.List-">setHelpSectionKeys</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&gt;&nbsp;keys)</code>
 <div class="block">Sets the section keys in the order that the usage help message should render the sections.</div>
 </td>
 </tr>
-<tr id="i110" class="altColor">
+<tr id="i111" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setHelpSectionMap-java.util.Map-">setHelpSectionMap</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>,<a href="../picocli/CommandLine.IHelpSectionRenderer.html" title="interface in picocli">CommandLine.IHelpSectionRenderer</a>&gt;&nbsp;map)</code>
 <div class="block">Sets the map of section keys and renderers used to construct the usage help message.</div>
 </td>
 </tr>
-<tr id="i111" class="rowColor">
+<tr id="i112" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setInterpolateVariables-boolean-">setInterpolateVariables</a></span>(boolean&nbsp;interpolate)</code>
 <div class="block">Sets whether whether variables should be interpolated in String values.</div>
 </td>
 </tr>
-<tr id="i112" class="altColor">
+<tr id="i113" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setNegatableOptionTransformer-picocli.CommandLine.INegatableOptionTransformer-">setNegatableOptionTransformer</a></span>(<a href="../picocli/CommandLine.INegatableOptionTransformer.html" title="interface in picocli">CommandLine.INegatableOptionTransformer</a>&nbsp;transformer)</code>
 <div class="block">Sets the <code>INegatableOptionTransformer</code> used to create the negative form of <a href="../picocli/CommandLine.Option.html#negatable--">negatable</a> options.</div>
 </td>
 </tr>
-<tr id="i113" class="rowColor">
+<tr id="i114" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setOut-java.io.PrintWriter-">setOut</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/io/PrintWriter.html?is-external=true" title="class or interface in java.io">PrintWriter</a>&nbsp;out)</code>
 <div class="block">Sets the writer to use when printing user-requested usage help or version help during command <a href="../picocli/CommandLine.html#execute-java.lang.String...-">execution</a>.</div>
 </td>
 </tr>
-<tr id="i114" class="altColor">
+<tr id="i115" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setOverwrittenOptionsAllowed-boolean-">setOverwrittenOptionsAllowed</a></span>(boolean&nbsp;newValue)</code>
 <div class="block">Sets whether options for single-value fields can be specified multiple times on the command line without a <a href="../picocli/CommandLine.OverwrittenOptionException.html" title="class in picocli"><code>CommandLine.OverwrittenOptionException</code></a> being thrown.</div>
 </td>
 </tr>
-<tr id="i115" class="rowColor">
+<tr id="i116" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setParameterExceptionHandler-picocli.CommandLine.IParameterExceptionHandler-">setParameterExceptionHandler</a></span>(<a href="../picocli/CommandLine.IParameterExceptionHandler.html" title="interface in picocli">CommandLine.IParameterExceptionHandler</a>&nbsp;parameterExceptionHandler)</code>
 <div class="block">Sets the handler for dealing with invalid user input when the command is <a href="../picocli/CommandLine.html#execute-java.lang.String...-">executed</a>.</div>
 </td>
 </tr>
-<tr id="i116" class="altColor">
+<tr id="i117" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setPosixClusteredShortOptionsAllowed-boolean-">setPosixClusteredShortOptionsAllowed</a></span>(boolean&nbsp;newValue)</code>
 <div class="block">Sets whether short options like <code>-x -v -f SomeFile</code> can be clustered together like <code>-xvfSomeFile</code>.</div>
 </td>
 </tr>
-<tr id="i117" class="rowColor">
+<tr id="i118" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setResourceBundle-java.util.ResourceBundle-">setResourceBundle</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/util/ResourceBundle.html?is-external=true" title="class or interface in java.util">ResourceBundle</a>&nbsp;bundle)</code>
 <div class="block">Sets the ResourceBundle containing usage help message strings.</div>
 </td>
 </tr>
-<tr id="i118" class="altColor">
+<tr id="i119" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setSeparator-java.lang.String-">setSeparator</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;separator)</code>
 <div class="block">Sets the String the parser uses to separate option names from option values to the specified value.</div>
 </td>
 </tr>
-<tr id="i119" class="rowColor">
+<tr id="i120" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setSplitQuotedStrings-boolean-">setSplitQuotedStrings</a></span>(boolean&nbsp;newValue)</code>
 <div class="block"><span class="deprecatedLabel">Deprecated.</span>&nbsp;
@@ -1536,71 +1542,77 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 </div>
 </td>
 </tr>
-<tr id="i120" class="altColor">
+<tr id="i121" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setStopAtPositional-boolean-">setStopAtPositional</a></span>(boolean&nbsp;newValue)</code>
 <div class="block">Sets whether the parser interprets the first positional parameter as "end of options" so the remaining
  arguments are all treated as positional parameters.</div>
 </td>
 </tr>
-<tr id="i121" class="rowColor">
+<tr id="i122" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setStopAtUnmatched-boolean-">setStopAtUnmatched</a></span>(boolean&nbsp;newValue)</code>
 <div class="block">Sets whether the parser should stop interpreting options and positional parameters as soon as it encounters an
  unmatched option.</div>
 </td>
 </tr>
-<tr id="i122" class="altColor">
+<tr id="i123" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setToggleBooleanFlags-boolean-">setToggleBooleanFlags</a></span>(boolean&nbsp;newValue)</code>
 <div class="block">Sets whether the value of boolean flag options should be "toggled" when the option is matched.</div>
 </td>
 </tr>
-<tr id="i123" class="rowColor">
+<tr id="i124" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setTrimQuotes-boolean-">setTrimQuotes</a></span>(boolean&nbsp;newValue)</code>
 <div class="block">Sets whether the parser should trim quotes from command line arguments before processing them.</div>
 </td>
 </tr>
-<tr id="i124" class="altColor">
+<tr id="i125" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setUnmatchedArgumentsAllowed-boolean-">setUnmatchedArgumentsAllowed</a></span>(boolean&nbsp;newValue)</code>
 <div class="block">Sets whether the end user may specify unmatched arguments on the command line without a <a href="../picocli/CommandLine.UnmatchedArgumentException.html" title="class in picocli"><code>CommandLine.UnmatchedArgumentException</code></a> being thrown.</div>
 </td>
 </tr>
-<tr id="i125" class="rowColor">
+<tr id="i126" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setUnmatchedOptionsArePositionalParams-boolean-">setUnmatchedOptionsArePositionalParams</a></span>(boolean&nbsp;newValue)</code>
 <div class="block">Sets whether arguments on the command line that resemble an option should be treated as positional parameters.</div>
 </td>
 </tr>
-<tr id="i126" class="altColor">
+<tr id="i127" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setUsageHelpAutoWidth-boolean-">setUsageHelpAutoWidth</a></span>(boolean&nbsp;detectTerminalSize)</code>
 <div class="block">Sets whether picocli should attempt to detect the terminal size and adjust the usage help message width
  to take the full terminal width.</div>
 </td>
 </tr>
-<tr id="i127" class="rowColor">
+<tr id="i128" class="altColor">
+<td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
+<td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setUsageHelpLongOptionsMaxWidth-int-">setUsageHelpLongOptionsMaxWidth</a></span>(int&nbsp;columnWidth)</code>
+<div class="block">Returns the maximum usage help long options column max width to the specified value.</div>
+</td>
+</tr>
+<tr id="i129" class="rowColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setUsageHelpWidth-int-">setUsageHelpWidth</a></span>(int&nbsp;width)</code>
 <div class="block">Sets the maximum width of the usage help message.</div>
 </td>
 </tr>
-<tr id="i128" class="altColor">
+<tr id="i130" class="altColor">
 <td class="colFirst"><code><a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a></code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#setUseSimplifiedAtFiles-boolean-">setUseSimplifiedAtFiles</a></span>(boolean&nbsp;simplifiedAtFiles)</code>
 <div class="block">Sets whether to use a simplified argument file format that is compatible with JCommander.</div>
 </td>
 </tr>
-<tr id="i129" class="rowColor">
+<tr id="i131" class="rowColor">
 <td class="colFirst"><code>static void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#usage-java.lang.Object-java.io.PrintStream-">usage</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;command,
      <a href="https://docs.oracle.com/javase/8/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io">PrintStream</a>&nbsp;out)</code>
 <div class="block">Equivalent to <code>new CommandLine(command).usage(out)</code>.</div>
 </td>
 </tr>
-<tr id="i130" class="altColor">
+<tr id="i132" class="altColor">
 <td class="colFirst"><code>static void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#usage-java.lang.Object-java.io.PrintStream-picocli.CommandLine.Help.Ansi-">usage</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;command,
      <a href="https://docs.oracle.com/javase/8/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io">PrintStream</a>&nbsp;out,
@@ -1608,7 +1620,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <div class="block">Equivalent to <code>new CommandLine(command).usage(out, ansi)</code>.</div>
 </td>
 </tr>
-<tr id="i131" class="rowColor">
+<tr id="i133" class="rowColor">
 <td class="colFirst"><code>static void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#usage-java.lang.Object-java.io.PrintStream-picocli.CommandLine.Help.ColorScheme-">usage</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;command,
      <a href="https://docs.oracle.com/javase/8/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io">PrintStream</a>&nbsp;out,
@@ -1616,40 +1628,40 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <div class="block">Equivalent to <code>new CommandLine(command).usage(out, colorScheme)</code>.</div>
 </td>
 </tr>
-<tr id="i132" class="altColor">
+<tr id="i134" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#usage-java.io.PrintStream-">usage</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io">PrintStream</a>&nbsp;out)</code>
 <div class="block">Delegates to <a href="../picocli/CommandLine.html#usage-java.io.PrintStream-picocli.CommandLine.Help.ColorScheme-"><code>usage(PrintStream, Help.ColorScheme)</code></a> with the <a href="../picocli/CommandLine.html#getColorScheme--">configured</a> color scheme.</div>
 </td>
 </tr>
-<tr id="i133" class="rowColor">
+<tr id="i135" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#usage-java.io.PrintStream-picocli.CommandLine.Help.Ansi-">usage</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io">PrintStream</a>&nbsp;out,
      <a href="../picocli/CommandLine.Help.Ansi.html" title="enum in picocli">CommandLine.Help.Ansi</a>&nbsp;ansi)</code>
 <div class="block">Delegates to <a href="../picocli/CommandLine.html#usage-java.io.PrintStream-picocli.CommandLine.Help.ColorScheme-"><code>usage(PrintStream, Help.ColorScheme)</code></a> with the <a href="../picocli/CommandLine.Help.html#defaultColorScheme-picocli.CommandLine.Help.Ansi-">default color scheme</a>.</div>
 </td>
 </tr>
-<tr id="i134" class="altColor">
+<tr id="i136" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#usage-java.io.PrintStream-picocli.CommandLine.Help.ColorScheme-">usage</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/io/PrintStream.html?is-external=true" title="class or interface in java.io">PrintStream</a>&nbsp;out,
      <a href="../picocli/CommandLine.Help.ColorScheme.html" title="class in picocli">CommandLine.Help.ColorScheme</a>&nbsp;colorScheme)</code>
 <div class="block">Prints a usage help message for the annotated command class to the specified <code>PrintStream</code>.</div>
 </td>
 </tr>
-<tr id="i135" class="rowColor">
+<tr id="i137" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#usage-java.io.PrintWriter-">usage</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/io/PrintWriter.html?is-external=true" title="class or interface in java.io">PrintWriter</a>&nbsp;writer)</code>
 <div class="block">Delegates to <a href="../picocli/CommandLine.html#usage-java.io.PrintWriter-picocli.CommandLine.Help.ColorScheme-"><code>usage(PrintWriter, Help.ColorScheme)</code></a> with the <a href="../picocli/CommandLine.html#getColorScheme--">configured</a> color scheme.</div>
 </td>
 </tr>
-<tr id="i136" class="altColor">
+<tr id="i138" class="altColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#usage-java.io.PrintWriter-picocli.CommandLine.Help.Ansi-">usage</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/io/PrintWriter.html?is-external=true" title="class or interface in java.io">PrintWriter</a>&nbsp;writer,
      <a href="../picocli/CommandLine.Help.Ansi.html" title="enum in picocli">CommandLine.Help.Ansi</a>&nbsp;ansi)</code>
 <div class="block">Similar to <a href="../picocli/CommandLine.html#usage-java.io.PrintStream-picocli.CommandLine.Help.Ansi-"><code>usage(PrintStream, Help.Ansi)</code></a> but with the specified <code>PrintWriter</code> instead of a <code>PrintStream</code>.</div>
 </td>
 </tr>
-<tr id="i137" class="rowColor">
+<tr id="i139" class="rowColor">
 <td class="colFirst"><code>void</code></td>
 <td class="colLast"><code><span class="memberNameLink"><a href="../picocli/CommandLine.html#usage-java.io.PrintWriter-picocli.CommandLine.Help.ColorScheme-">usage</a></span>(<a href="https://docs.oracle.com/javase/8/docs/api/java/io/PrintWriter.html?is-external=true" title="class or interface in java.io">PrintWriter</a>&nbsp;writer,
      <a href="../picocli/CommandLine.Help.ColorScheme.html" title="class in picocli">CommandLine.Help.ColorScheme</a>&nbsp;colorScheme)</code>
@@ -1685,7 +1697,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
 <li class="blockList">
 <h4>VERSION</h4>
 <pre>public static final&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> VERSION</pre>
-<div class="block">This is picocli version "4.1.4".</div>
+<div class="block">This is picocli version "4.2.0".</div>
 <dl>
 <dt><span class="seeLabel">See Also:</span></dt>
 <dd><a href="../constant-values.html#picocli.CommandLine.VERSION">Constant Field Values</a></dd>
@@ -2112,6 +2124,7 @@ extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html
    <li><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_DESCRIPTION_HEADING"><code>SECTION_KEY_DESCRIPTION_HEADING</code></a></li>
    <li><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_DESCRIPTION"><code>SECTION_KEY_DESCRIPTION</code></a></li>
    <li><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_PARAMETER_LIST_HEADING"><code>SECTION_KEY_PARAMETER_LIST_HEADING</code></a></li>
+   <li><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_AT_FILE_PARAMETER"><code>SECTION_KEY_AT_FILE_PARAMETER</code></a></li>
    <li><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_PARAMETER_LIST"><code>SECTION_KEY_PARAMETER_LIST</code></a></li>
    <li><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_OPTION_LIST_HEADING"><code>SECTION_KEY_OPTION_LIST_HEADING</code></a></li>
    <li><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#SECTION_KEY_OPTION_LIST"><code>SECTION_KEY_OPTION_LIST</code></a></li>
@@ -4991,6 +5004,52 @@ public static&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/
 </dl>
 </li>
 </ul>
+<a name="getUsageHelpLongOptionsMaxWidth--">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getUsageHelpLongOptionsMaxWidth</h4>
+<pre>public&nbsp;int&nbsp;getUsageHelpLongOptionsMaxWidth()</pre>
+<div class="block">Returns the maximum usage help long options column max width to the specified value.
+ This value controls the maximum width of the long options column: any positional parameter
+ labels or long options that are longer than the specified value will overflow into
+ the description column, and cause the description to be displayed on the next line.</div>
+<dl>
+<dt><span class="simpleTagLabel">Since:</span></dt>
+<dd>4.2</dd>
+<dt><span class="seeLabel">See Also:</span></dt>
+<dd><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#longOptionsMaxWidth--"><code>CommandLine.Model.UsageMessageSpec.longOptionsMaxWidth()</code></a></dd>
+</dl>
+</li>
+</ul>
+<a name="setUsageHelpLongOptionsMaxWidth-int-">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>setUsageHelpLongOptionsMaxWidth</h4>
+<pre>public&nbsp;<a href="../picocli/CommandLine.html" title="class in picocli">CommandLine</a>&nbsp;setUsageHelpLongOptionsMaxWidth(int&nbsp;columnWidth)</pre>
+<div class="block">Returns the maximum usage help long options column max width to the specified value.
+ This value controls the maximum width of the long options column: any positional parameter
+ labels or long options that are longer than the specified value will overflow into
+ the description column, and cause the description to be displayed on the next line.
+ <p>The specified setting will be registered with this <code>CommandLine</code> and the full hierarchy of its
+ subcommands and nested sub-subcommands <em>at the moment this method is called</em>. Subcommands added
+ later will have the default setting. To ensure a setting is applied to all
+ subcommands, call the setter last, after adding subcommands.</p></div>
+<dl>
+<dt><span class="paramLabel">Parameters:</span></dt>
+<dd><code>columnWidth</code> - the new maximum usage help long options column max width. Must be 20 or greater.</dd>
+<dt><span class="returnLabel">Returns:</span></dt>
+<dd>this <code>CommandLine</code> object, to allow method chaining</dd>
+<dt><span class="simpleTagLabel">Since:</span></dt>
+<dd>4.2</dd>
+<dt><span class="seeLabel">See Also:</span></dt>
+<dd><a href="../picocli/CommandLine.Model.UsageMessageSpec.html#longOptionsMaxWidth-int-"><code>CommandLine.Model.UsageMessageSpec.longOptionsMaxWidth(int)</code></a></dd>
+</dl>
+</li>
+</ul>
 <a name="isUsageHelpAutoWidth--">
 <!--   -->
 </a>
@@ -5243,7 +5302,7 @@ public static&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/
 <dd>4.0</dd>
 <dt><span class="seeLabel">See Also:</span></dt>
 <dd><a href="../picocli/CommandLine.Option.html#negatable--"><code>CommandLine.Option.negatable()</code></a>, 
-<code>CommandSpec#negatableOptionTransformer(INegatableOptionTransformer)</code></dd>
+<a href="../picocli/CommandLine.Model.CommandSpec.html#negatableOptionTransformer-picocli.CommandLine.INegatableOptionTransformer-"><code>CommandLine.Model.CommandSpec.negatableOptionTransformer(CommandLine.INegatableOptionTransformer)</code></a></dd>
 </dl>
 </li>
 </ul>
diff --git a/docs/apidocs/picocli/package-frame.html b/docs/apidocs/picocli/package-frame.html
index b84faf3a..3574fb38 100644
--- a/docs/apidocs/picocli/package-frame.html
+++ b/docs/apidocs/picocli/package-frame.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>picocli (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>picocli (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
diff --git a/docs/apidocs/picocli/package-summary.html b/docs/apidocs/picocli/package-summary.html
index bc1a25b1..f766e685 100644
--- a/docs/apidocs/picocli/package-summary.html
+++ b/docs/apidocs/picocli/package-summary.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>picocli (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>picocli (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="picocli (picocli 4.1.4 API)";
+            parent.document.title="picocli (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/apidocs/picocli/package-tree.html b/docs/apidocs/picocli/package-tree.html
index c961f056..96188c7d 100644
--- a/docs/apidocs/picocli/package-tree.html
+++ b/docs/apidocs/picocli/package-tree.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>picocli Class Hierarchy (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>picocli Class Hierarchy (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 <script type="text/javascript" src="../script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="picocli Class Hierarchy (picocli 4.1.4 API)";
+            parent.document.title="picocli Class Hierarchy (picocli 4.2.0 API)";
         }
     }
     catch(err) {
@@ -213,13 +213,13 @@
 <h2 title="Annotation Type Hierarchy">Annotation Type Hierarchy</h2>
 <ul>
 <li type="circle">picocli.<a href="../picocli/CommandLine.Spec.html" title="annotation in picocli"><span class="typeNameLink">CommandLine.Spec</span></a> (implements java.lang.annotation.<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/annotation/Annotation.html?is-external=true" title="class or interface in java.lang.annotation">Annotation</a>)</li>
-<li type="circle">picocli.<a href="../picocli/CommandLine.ParentCommand.html" title="annotation in picocli"><span class="typeNameLink">CommandLine.ParentCommand</span></a> (implements java.lang.annotation.<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/annotation/Annotation.html?is-external=true" title="class or interface in java.lang.annotation">Annotation</a>)</li>
+<li type="circle">picocli.<a href="../picocli/CommandLine.Option.html" title="annotation in picocli"><span class="typeNameLink">CommandLine.Option</span></a> (implements java.lang.annotation.<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/annotation/Annotation.html?is-external=true" title="class or interface in java.lang.annotation">Annotation</a>)</li>
 <li type="circle">picocli.<a href="../picocli/CommandLine.ArgGroup.html" title="annotation in picocli"><span class="typeNameLink">CommandLine.ArgGroup</span></a> (implements java.lang.annotation.<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/annotation/Annotation.html?is-external=true" title="class or interface in java.lang.annotation">Annotation</a>)</li>
-<li type="circle">picocli.<a href="../picocli/CommandLine.Parameters.html" title="annotation in picocli"><span class="typeNameLink">CommandLine.Parameters</span></a> (implements java.lang.annotation.<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/annotation/Annotation.html?is-external=true" title="class or interface in java.lang.annotation">Annotation</a>)</li>
+<li type="circle">picocli.<a href="../picocli/CommandLine.Command.html" title="annotation in picocli"><span class="typeNameLink">CommandLine.Command</span></a> (implements java.lang.annotation.<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/annotation/Annotation.html?is-external=true" title="class or interface in java.lang.annotation">Annotation</a>)</li>
+<li type="circle">picocli.<a href="../picocli/CommandLine.ParentCommand.html" title="annotation in picocli"><span class="typeNameLink">CommandLine.ParentCommand</span></a> (implements java.lang.annotation.<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/annotation/Annotation.html?is-external=true" title="class or interface in java.lang.annotation">Annotation</a>)</li>
 <li type="circle">picocli.<a href="../picocli/CommandLine.Unmatched.html" title="annotation in picocli"><span class="typeNameLink">CommandLine.Unmatched</span></a> (implements java.lang.annotation.<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/annotation/Annotation.html?is-external=true" title="class or interface in java.lang.annotation">Annotation</a>)</li>
 <li type="circle">picocli.<a href="../picocli/CommandLine.Mixin.html" title="annotation in picocli"><span class="typeNameLink">CommandLine.Mixin</span></a> (implements java.lang.annotation.<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/annotation/Annotation.html?is-external=true" title="class or interface in java.lang.annotation">Annotation</a>)</li>
-<li type="circle">picocli.<a href="../picocli/CommandLine.Option.html" title="annotation in picocli"><span class="typeNameLink">CommandLine.Option</span></a> (implements java.lang.annotation.<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/annotation/Annotation.html?is-external=true" title="class or interface in java.lang.annotation">Annotation</a>)</li>
-<li type="circle">picocli.<a href="../picocli/CommandLine.Command.html" title="annotation in picocli"><span class="typeNameLink">CommandLine.Command</span></a> (implements java.lang.annotation.<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/annotation/Annotation.html?is-external=true" title="class or interface in java.lang.annotation">Annotation</a>)</li>
+<li type="circle">picocli.<a href="../picocli/CommandLine.Parameters.html" title="annotation in picocli"><span class="typeNameLink">CommandLine.Parameters</span></a> (implements java.lang.annotation.<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/annotation/Annotation.html?is-external=true" title="class or interface in java.lang.annotation">Annotation</a>)</li>
 </ul>
 <h2 title="Enum Hierarchy">Enum Hierarchy</h2>
 <ul>
@@ -228,9 +228,9 @@
 <li type="circle">java.lang.<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Enum.html?is-external=true" title="class or interface in java.lang"><span class="typeNameLink">Enum</span></a>&lt;E&gt; (implements java.lang.<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Comparable.html?is-external=true" title="class or interface in java.lang">Comparable</a>&lt;T&gt;, java.io.<a href="https://docs.oracle.com/javase/8/docs/api/java/io/Serializable.html?is-external=true" title="class or interface in java.io">Serializable</a>)
 <ul>
 <li type="circle">picocli.<a href="../picocli/CommandLine.Help.Ansi.Style.html" title="enum in picocli"><span class="typeNameLink">CommandLine.Help.Ansi.Style</span></a> (implements picocli.<a href="../picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli">CommandLine.Help.Ansi.IStyle</a>)</li>
+<li type="circle">picocli.<a href="../picocli/CommandLine.Help.Visibility.html" title="enum in picocli"><span class="typeNameLink">CommandLine.Help.Visibility</span></a></li>
 <li type="circle">picocli.<a href="../picocli/CommandLine.Help.Ansi.html" title="enum in picocli"><span class="typeNameLink">CommandLine.Help.Ansi</span></a></li>
 <li type="circle">picocli.<a href="../picocli/CommandLine.Help.Column.Overflow.html" title="enum in picocli"><span class="typeNameLink">CommandLine.Help.Column.Overflow</span></a></li>
-<li type="circle">picocli.<a href="../picocli/CommandLine.Help.Visibility.html" title="enum in picocli"><span class="typeNameLink">CommandLine.Help.Visibility</span></a></li>
 </ul>
 </li>
 </ul>
diff --git a/docs/apidocs/serialized-form.html b/docs/apidocs/serialized-form.html
index e7401cb1..aaead42d 100644
--- a/docs/apidocs/serialized-form.html
+++ b/docs/apidocs/serialized-form.html
@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_202) on Sun Dec 22 08:18:44 JST 2019 -->
-<title>Serialized Form (picocli 4.1.4 API)</title>
-<meta name="date" content="2019-12-22">
+<!-- Generated by javadoc (1.8.0_202) on Wed Feb 12 07:12:51 JST 2020 -->
+<title>Serialized Form (picocli 4.2.0 API)</title>
+<meta name="date" content="2020-02-12">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
@@ -12,7 +12,7 @@
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="Serialized Form (picocli 4.1.4 API)";
+            parent.document.title="Serialized Form (picocli 4.2.0 API)";
         }
     }
     catch(err) {
diff --git a/docs/autocomplete.adoc b/docs/autocomplete.adoc
index 8cfdf9bf..16b4b329 100644
--- a/docs/autocomplete.adoc
+++ b/docs/autocomplete.adoc
@@ -1,7 +1,7 @@
 = Autocomplete for Java Command Line Applications
 //:author: Remko Popma
 //:email: rpopma@apache.org
-:revnumber: 4.2.0-SNAPSHOT
+:revnumber: 4.2.0
 :revdate: 2019-12-22
 :toc: left
 :numbered:
diff --git a/docs/autocomplete.html b/docs/autocomplete.html
index 297c4683..83b6252b 100644
--- a/docs/autocomplete.html
+++ b/docs/autocomplete.html
@@ -526,7 +526,7 @@ table.CodeRay td.code>pre{padding:0}
 <div id="header">
 <h1>Autocomplete for Java Command Line Applications</h1>
 <div class="details">
-<span id="revnumber">version 4.1.4,</span>
+<span id="revnumber">version 4.2.0,</span>
 <span id="revdate">2019-12-22</span>
 </div>
 <div id="toc" class="toc2">
@@ -1209,8 +1209,8 @@ Setting system property <code>picocli.autocomplete.systemExitOnError</code> ensu
 </div>
 <div id="footer">
 <div id="footer-text">
-Version 4.1.4<br>
-Last updated 2019-12-22 08:17:56 +0900
+Version 4.2.0<br>
+Last updated 2020-02-12 07:02:37 +0900
 </div>
 </div>
 </body>
diff --git a/docs/groovy-2.5-clibuilder-renewal-part1.html b/docs/groovy-2.5-clibuilder-renewal-part1.html
index e645eb3d..8c007d1d 100644
--- a/docs/groovy-2.5-clibuilder-renewal-part1.html
+++ b/docs/groovy-2.5-clibuilder-renewal-part1.html
@@ -526,7 +526,7 @@ table.CodeRay td.code>pre{padding:0}
 <div id="header">
 <h1>Groovy 2.5 CliBuilder Renewal (Part 1)</h1>
 <div class="details">
-<span id="revnumber">version 4.1.4,</span>
+<span id="revnumber">version 4.2.0,</span>
 <span id="revdate">2018-05-30</span>
 </div>
 </div>
@@ -971,7 +971,7 @@ Please star the projects if you like what you see!
 </div>
 <div id="footer">
 <div id="footer-text">
-Version 4.1.4<br>
+Version 4.2.0<br>
 Last updated 2018-12-02 18:44:56 +0900
 </div>
 </div>
diff --git a/docs/groovy-2.5-clibuilder-renewal-part2.html b/docs/groovy-2.5-clibuilder-renewal-part2.html
index 214cb426..1353ab5f 100644
--- a/docs/groovy-2.5-clibuilder-renewal-part2.html
+++ b/docs/groovy-2.5-clibuilder-renewal-part2.html
@@ -526,7 +526,7 @@ table.CodeRay td.code>pre{padding:0}
 <div id="header">
 <h1>Groovy 2.5 CliBuilder Renewal (Part 2)</h1>
 <div class="details">
-<span id="revnumber">version 4.1.4,</span>
+<span id="revnumber">version 4.2.0,</span>
 <span id="revdate">2018-05-30</span>
 </div>
 </div>
@@ -977,7 +977,7 @@ Please star the projects if you like what you see!
 </div>
 <div id="footer">
 <div id="footer-text">
-Version 4.1.4<br>
+Version 4.2.0<br>
 Last updated 2018-12-02 18:44:56 +0900
 </div>
 </div>
diff --git a/docs/groovy-2.5-clibuilder-renewal.html b/docs/groovy-2.5-clibuilder-renewal.html
index 0129993f..5be5534b 100644
--- a/docs/groovy-2.5-clibuilder-renewal.html
+++ b/docs/groovy-2.5-clibuilder-renewal.html
@@ -526,7 +526,7 @@ table.CodeRay td.code>pre{padding:0}
 <div id="header">
 <h1>Groovy 2.5 CliBuilder Renewal</h1>
 <div class="details">
-<span id="revnumber">version 4.1.4,</span>
+<span id="revnumber">version 4.2.0,</span>
 <span id="revdate">2018-05-30</span>
 </div>
 </div>
@@ -1348,7 +1348,7 @@ picocli <a href="http://picocli.info/">site</a> and GitHub <a href="https://gith
 </div>
 <div id="footer">
 <div id="footer-text">
-Version 4.1.4<br>
+Version 4.2.0<br>
 Last updated 2018-12-02 18:44:56 +0900
 </div>
 </div>
diff --git a/docs/index.adoc b/docs/index.adoc
index af2b5d14..6e86d883 100644
--- a/docs/index.adoc
+++ b/docs/index.adoc
@@ -1,7 +1,7 @@
 = picocli - a mighty tiny command line interface
 //:author: Remko Popma
 //:email: rpopma@apache.org
-:revnumber: 4.2.0-SNAPSHOT
+:revnumber: 4.2.0
 :revdate: 2019-12-08
 :toc: left
 :numbered:
@@ -107,7 +107,7 @@ Below are examples of configuring Gradle or Maven to use picocli as an external
 
 ==== Gradle
 ----
-compile 'info.picocli:picocli:4.2.0-SNAPSHOT'
+compile 'info.picocli:picocli:4.2.0'
 ----
 
 ==== Maven
@@ -115,7 +115,7 @@ compile 'info.picocli:picocli:4.2.0-SNAPSHOT'
 <dependency>
   <groupId>info.picocli</groupId>
   <artifactId>picocli</artifactId>
-  <version>4.2.0-SNAPSHOT</version>
+  <version>4.2.0</version>
 </dependency>
 ----
 
@@ -158,7 +158,7 @@ https://immutables.github.io/apt.html[This page] shows the steps to configure Ec
       <path>
         <groupId>info.picocli</groupId>
         <artifactId>picocli-codegen</artifactId>
-        <version>4.2.0-SNAPSHOT</version>
+        <version>4.2.0</version>
       </path>
     </annotationProcessorPaths>
     <compilerArgs>
@@ -174,8 +174,8 @@ See the https://github.com/remkop/picocli/tree/master/picocli-codegen[`picocli-c
 ===== Gradle
 ```
 dependencies {
-    compile 'info.picocli:picocli:4.2.0-SNAPSHOT'
-    annotationProcessor 'info.picocli:picocli-codegen:4.2.0-SNAPSHOT'
+    compile 'info.picocli:picocli:4.2.0'
+    annotationProcessor 'info.picocli:picocli-codegen:4.2.0'
 }
 ```
 
@@ -5210,14 +5210,14 @@ Maven:
 <dependency>
   <groupId>info.picocli</groupId>
   <artifactId>picocli-spring-boot-starter</artifactId>
-  <version>4.2.0-SNAPSHOT</version>
+  <version>4.2.0</version>
 </dependency>
 ```
 
 Gradle:
 ```
 dependencies {
-    compile "info.picocli:picocli-spring-boot-starter:4.2.0-SNAPSHOT"
+    compile "info.picocli:picocli-spring-boot-starter:4.2.0"
 }
 ```
 
@@ -5568,7 +5568,7 @@ The script body is executed if the user input was valid and did not request usag
 
 [source,groovy]
 ----
-@Grab('info.picocli:picocli-groovy:4.2.0-SNAPSHOT')
+@Grab('info.picocli:picocli-groovy:4.2.0')
 @Command(name = "myScript",
         mixinStandardHelpOptions = true, // add --help and --version options
         description = "@|bold Groovy script|@ @|underline picocli|@ example")
@@ -5589,7 +5589,7 @@ assert this.commandLine.commandName == "myScript"
 ----
 
 WARNING: When upgrading scripts to picocli 4.0, just changing the version number is not enough!
-Scripts should use `@Grab('info.picocli:picocli-groovy:4.2.0-SNAPSHOT')`. The old artifact id `@Grab('info.picocli:picocli:4.2.0-SNAPSHOT')` will not work,
+Scripts should use `@Grab('info.picocli:picocli-groovy:4.2.0')`. The old artifact id `@Grab('info.picocli:picocli:4.2.0')` will not work,
 because the `@picocli.groovy.PicocliScript` annotation class and supporting classes have been moved into a separate module, `picocli-groovy`.
 
 
@@ -5598,7 +5598,7 @@ NOTE: When using a Groovy version older than 2.4.7, use this workaround for the
 
 [source,groovy]
 ----
-@Grab('info.picocli:picocli-groovy:4.2.0-SNAPSHOT')
+@Grab('info.picocli:picocli-groovy:4.2.0')
 @GrabExclude('org.codehaus.groovy:groovy-all') // work around GROOVY-7613
 ...
 ----
@@ -5737,7 +5737,7 @@ See the <<Source,source code>> below. Copy and paste it into a file called `Comm
 
 === Gradle
 ----
-compile 'info.picocli:picocli:4.2.0-SNAPSHOT'
+compile 'info.picocli:picocli:4.2.0'
 ----
 
 === Maven
@@ -5745,19 +5745,19 @@ compile 'info.picocli:picocli:4.2.0-SNAPSHOT'
 <dependency>
   <groupId>info.picocli</groupId>
   <artifactId>picocli</artifactId>
-  <version>4.2.0-SNAPSHOT</version>
+  <version>4.2.0</version>
 </dependency>
 ----
 
 === Scala SBT
 ----
-libraryDependencies += "info.picocli" % "picocli" % "4.2.0-SNAPSHOT"
+libraryDependencies += "info.picocli" % "picocli" % "4.2.0"
 ----
 
 === Ivy
 
 ----
-<dependency org="info.picocli" name="picocli" rev="4.2.0-SNAPSHOT" />
+<dependency org="info.picocli" name="picocli" rev="4.2.0" />
 ----
 
 === Source
diff --git a/docs/index.html b/docs/index.html
index aa0a9431..02abd60b 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -526,7 +526,7 @@ table.CodeRay td.code>pre{padding:0}
 <div id="header">
 <h1>picocli - a mighty tiny command line interface</h1>
 <div class="details">
-<span id="revnumber">version 4.1.4,</span>
+<span id="revnumber">version 4.2.0,</span>
 <span id="revdate">2019-12-08</span>
 </div>
 <div id="toc" class="toc2">
@@ -658,10 +658,12 @@ table.CodeRay td.code>pre{padding:0}
 <li><a href="#_expanded_example">13.13. Expanded Example</a></li>
 <li><a href="#_option_parameter_separators">13.14. Option-Parameter Separators</a></li>
 <li><a href="#_hidden_options_and_parameters">13.15. Hidden Options and Parameters</a></li>
-<li><a href="#_show_default_values">13.16. Show Default Values</a></li>
-<li><a href="#_required_option_marker">13.17. Required-Option Marker</a></li>
-<li><a href="#_usage_width">13.18. Usage Width</a></li>
-<li><a href="#_auto_terminal_width">13.19. Auto (Terminal) Width</a></li>
+<li><a href="#_show_at_files">13.16. Show At Files</a></li>
+<li><a href="#_show_default_values">13.17. Show Default Values</a></li>
+<li><a href="#_required_option_marker">13.18. Required-Option Marker</a></li>
+<li><a href="#_usage_width">13.19. Usage Width</a></li>
+<li><a href="#_auto_terminal_width">13.20. Auto (Terminal) Width</a></li>
+<li><a href="#_long_option_column_width">13.21. Long Option Column Width</a></li>
 </ul>
 </li>
 <li><a href="#_ansi_colors_and_styles">14. ANSI Colors and Styles</a>
@@ -691,18 +693,20 @@ table.CodeRay td.code>pre{padding:0}
 <li><a href="#_executing_subcommands">16.5. Executing Subcommands</a></li>
 <li><a href="#_manually_parsing_subcommands">16.6. Manually Parsing Subcommands</a></li>
 <li><a href="#_parentcommand_annotation">16.7. <code>@ParentCommand</code> Annotation</a></li>
-<li><a href="#_usage_help_for_subcommands">16.8. Usage Help for Subcommands</a></li>
-<li><a href="#_hidden_subcommands">16.9. Hidden Subcommands</a></li>
-<li><a href="#_help_subcommands">16.10. Help Subcommands</a></li>
-<li><a href="#_nested_sub_subcommands">16.11. Nested sub-Subcommands</a></li>
-<li><a href="#_required_subcommands">16.12. Required Subcommands</a></li>
+<li><a href="#_nested_sub_subcommands">16.8. Nested sub-Subcommands</a></li>
+<li><a href="#_repeatable_subcommands">16.9. Repeatable Subcommands</a></li>
+<li><a href="#_usage_help_for_subcommands">16.10. Usage Help for Subcommands</a></li>
+<li><a href="#_hidden_subcommands">16.11. Hidden Subcommands</a></li>
+<li><a href="#_help_subcommands">16.12. Help Subcommands</a></li>
+<li><a href="#_required_subcommands">16.13. Required Subcommands</a></li>
 </ul>
 </li>
 <li><a href="#_reuse">17. Reuse</a>
 <ul class="sectlevel2">
 <li><a href="#_subclassing">17.1. Subclassing</a></li>
 <li><a href="#_mixins">17.2. Mixins</a></li>
-<li><a href="#_reuse_combinations">17.3. Reuse Combinations</a></li>
+<li><a href="#_use_case_sharing_options">17.3. Use Case: Sharing Options</a></li>
+<li><a href="#_reuse_combinations">17.4. Reuse Combinations</a></li>
 </ul>
 </li>
 <li><a href="#_internationalization">18. Internationalization</a>
@@ -747,42 +751,44 @@ table.CodeRay td.code>pre{padding:0}
 </li>
 <li><a href="#_tracing">22. Tracing</a></li>
 <li><a href="#_tab_autocomplete">23. TAB Autocomplete</a></li>
-<li><a href="#_java_9_jpms_modules">24. Java 9 JPMS Modules</a>
+<li><a href="#_generate_man_page_documentation">24. Generate Man Page Documentation</a></li>
+<li><a href="#_java_9_jpms_modules">25. Java 9 JPMS Modules</a>
 <ul class="sectlevel2">
-<li><a href="#_module_configuration">24.1. Module Configuration</a></li>
+<li><a href="#_module_configuration">25.1. Module Configuration</a></li>
 </ul>
 </li>
-<li><a href="#_osgi_bundle">25. OSGi Bundle</a></li>
-<li><a href="#_packaging_your_application">26. Packaging Your Application</a>
+<li><a href="#_osgi_bundle">26. OSGi Bundle</a></li>
+<li><a href="#_packaging_your_application">27. Packaging Your Application</a>
 <ul class="sectlevel2">
-<li><a href="#_graalvm_native_image">26.1. GraalVM Native Image</a></li>
-<li><a href="#_build_tool_plugins">26.2. Build Tool Plugins</a></li>
-<li><a href="#_launch4j">26.3. launch4j</a></li>
-<li><a href="#_javapackager_java_8">26.4. javapackager (Java 8)</a></li>
-<li><a href="#_jlink_java_9">26.5. jlink (Java 9+)</a></li>
-<li><a href="#_jpackage_early_access">26.6. jpackage (Early Access)</a></li>
+<li><a href="#_graalvm_native_image">27.1. GraalVM Native Image</a></li>
+<li><a href="#_build_tool_plugins">27.2. Build Tool Plugins</a></li>
+<li><a href="#_launch4j">27.3. launch4j</a></li>
+<li><a href="#_javapackager_java_8">27.4. javapackager (Java 8)</a></li>
+<li><a href="#_jlink_java_9">27.5. jlink (Java 9+)</a></li>
+<li><a href="#_jpackage_early_access">27.6. jpackage (Early Access)</a></li>
+<li><a href="#_jbang">27.7. jbang</a></li>
 </ul>
 </li>
-<li><a href="#_picocli_in_other_languages">27. Picocli in Other Languages</a>
+<li><a href="#_picocli_in_other_languages">28. Picocli in Other Languages</a>
 <ul class="sectlevel2">
-<li><a href="#_groovy">27.1. Groovy</a></li>
-<li><a href="#_kotlin">27.2. Kotlin</a></li>
-<li><a href="#_scala">27.3. Scala</a></li>
+<li><a href="#_groovy">28.1. Groovy</a></li>
+<li><a href="#_kotlin">28.2. Kotlin</a></li>
+<li><a href="#_scala">28.3. Scala</a></li>
 </ul>
 </li>
-<li><a href="#_api_javadoc">28. API Javadoc</a></li>
-<li><a href="#_github_project">29. GitHub Project</a></li>
-<li><a href="#_issue_tracker">30. Issue Tracker</a></li>
-<li><a href="#_mailing_list">31. Mailing List</a></li>
-<li><a href="#_license">32. License</a></li>
-<li><a href="#_releases">33. Releases</a></li>
-<li><a href="#_download">34. Download</a>
+<li><a href="#_api_javadoc">29. API Javadoc</a></li>
+<li><a href="#_github_project">30. GitHub Project</a></li>
+<li><a href="#_issue_tracker">31. Issue Tracker</a></li>
+<li><a href="#_mailing_list">32. Mailing List</a></li>
+<li><a href="#_license">33. License</a></li>
+<li><a href="#_releases">34. Releases</a></li>
+<li><a href="#_download">35. Download</a>
 <ul class="sectlevel2">
-<li><a href="#_gradle_3">34.1. Gradle</a></li>
-<li><a href="#_maven_3">34.2. Maven</a></li>
-<li><a href="#_scala_sbt">34.3. Scala SBT</a></li>
-<li><a href="#_ivy">34.4. Ivy</a></li>
-<li><a href="#_source">34.5. Source</a></li>
+<li><a href="#_gradle_3">35.1. Gradle</a></li>
+<li><a href="#_maven_3">35.2. Maven</a></li>
+<li><a href="#_scala_sbt">35.3. Scala SBT</a></li>
+<li><a href="#_ivy">35.4. Ivy</a></li>
+<li><a href="#_source">35.5. Source</a></li>
 </ul>
 </li>
 </ul>
@@ -829,6 +835,9 @@ Picocli-based applications can be ahead-of-time compiled to <span class="image">
 <p><span class="image"><img src="images/checksum-usage-help.png" alt="Screenshot of usage help with Ansi codes enabled"></span></p>
 </div>
 <div class="paragraph">
+<p>Picocli <a href="#_generate_man_page_documentation">generates beautiful documentation</a> for your application (HTML, PDF and Unix man pages).</p>
+</div>
+<div class="paragraph">
 <p>Another distinguishing feature of picocli is how it aims
 to let users run picocli-based applications without requiring picocli as an external dependency:
 all the source code lives in a single file, to encourage application authors to include it <em>in source form</em>.</p>
@@ -904,7 +913,7 @@ Applications can call <code>System.exit</code> with the returned exit code to si
 <h4 id="_gradle">2.1.1. Gradle</h4>
 <div class="listingblock">
 <div class="content">
-<pre>compile 'info.picocli:picocli:4.1.4'</pre>
+<pre>compile 'info.picocli:picocli:4.2.0'</pre>
 </div>
 </div>
 </div>
@@ -915,7 +924,7 @@ Applications can call <code>System.exit</code> with the returned exit code to si
 <pre>&lt;dependency&gt;
   &lt;groupId&gt;info.picocli&lt;/groupId&gt;
   &lt;artifactId&gt;picocli&lt;/artifactId&gt;
-  &lt;version&gt;4.1.4&lt;/version&gt;
+  &lt;version&gt;4.2.0&lt;/version&gt;
 &lt;/dependency&gt;</pre>
 </div>
 </div>
@@ -980,7 +989,7 @@ In most cases no further configuration is needed when generating a native image.
       &lt;path&gt;
         &lt;groupId&gt;info.picocli&lt;/groupId&gt;
         &lt;artifactId&gt;picocli-codegen&lt;/artifactId&gt;
-        &lt;version&gt;4.1.4&lt;/version&gt;
+        &lt;version&gt;4.2.0&lt;/version&gt;
       &lt;/path&gt;
     &lt;/annotationProcessorPaths&gt;
     &lt;compilerArgs&gt;
@@ -999,8 +1008,8 @@ In most cases no further configuration is needed when generating a native image.
 <div class="listingblock">
 <div class="content">
 <pre class="CodeRay highlight"><code>dependencies {
-    compile 'info.picocli:picocli:4.1.4'
-    annotationProcessor 'info.picocli:picocli-codegen:4.1.4'
+    compile 'info.picocli:picocli:4.2.0'
+    annotationProcessor 'info.picocli:picocli-codegen:4.2.0'
 }</code></pre>
 </div>
 </div>
@@ -1195,7 +1204,7 @@ After the user enters a password value and presses enter, the <code>call()</code
 </div>
 <div class="listingblock">
 <div class="content">
-<pre class="CodeRay highlight"><code>--password 123 --user Joe</code></pre>
+<pre>--password 123 --user Joe</pre>
 </div>
 </div>
 <div class="paragraph">
@@ -1203,7 +1212,7 @@ After the user enters a password value and presses enter, the <code>call()</code
 </div>
 <div class="listingblock">
 <div class="content">
-<pre class="CodeRay highlight"><code>--password --user Joe</code></pre>
+<pre>--password --user Joe</pre>
 </div>
 </div>
 <div class="admonitionblock tip">
@@ -1225,7 +1234,7 @@ Another idea is to add a separate different option (that could be named <code>--
 <p>A command that combines either of these with an interactive <code>--password</code> option (with the default <code>arity = "0"</code>) allows end users to provide a password without specifying it in plain text on the command line. Such a command can be executed both interactively and in batch mode.</p>
 </div>
 <div class="paragraph">
-<p>The <code>picocli-examples</code> module has <a href="https://github.com/remkop/picocli/blob/master/picocli-examples/src/main/java/picocli/examples/interactive/PasswordDemo.java">an example</a>.</p>
+<p>The <a href="https://github.com/remkop/picocli/blob/master/picocli-examples"><code>picocli-examples</code></a> module has an example, coded both in <a href="https://github.com/remkop/picocli/blob/master/picocli-examples/src/main/java/picocli/examples/interactive/PasswordDemo.java">Java</a> and <a href="https://github.com/remkop/picocli/tree/master/picocli-examples/src/main/kotlin/picocli/examples/kotlin/interactive/PasswordDemo.kt">Kotlin</a>.</p>
 </div>
 </td>
 </tr>
@@ -1574,7 +1583,13 @@ The documentation for these tools shows further examples.</p>
 </div>
 </div>
 <div class="sect3">
-<h4 id="_simplified_format">3.9.2. Simplified Format</h4>
+<h4 id="_files_usage_help">3.9.2. @-files Usage Help</h4>
+<div class="paragraph">
+<p>From picocli 4.2, an entry for <code>@&lt;filename&gt;</code> can be shown in the options and parameters list of the usage help message of a command with the <code>@Command(showAtFileInUsageHelp = true)</code> annotation. See <a href="#_show_at_files">Show At Files</a> for details.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_simplified_format">3.9.3. Simplified Format</h4>
 <div class="paragraph">
 <p>From picocli 3.8.1, a simpler argument file format is also supported where every line (except empty lines and comment lines)
 is interpreted as a single argument. Arguments containing whitespace do not need to be quoted,
@@ -4634,6 +4649,48 @@ and a build-generated version properties file-based
 <div class="paragraph">
 <p>The version strings returned from the <code>IVersionProvider</code> may contain <a href="#_variable_interpolation">system properties and environment variables</a>.</p>
 </div>
+<div class="paragraph">
+<p>For example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="type">class</span> <span class="class">VersionProviderWithVariables</span> <span class="directive">implements</span> IVersionProvider {
+    <span class="directive">public</span> <span class="predefined-type">String</span><span class="type">[]</span> getVersion() {
+        <span class="keyword">return</span> <span class="keyword">new</span> <span class="predefined-type">String</span><span class="type">[]</span> { <span class="string"><span class="delimiter">&quot;</span><span class="content">${COMMAND-FULL-NAME} version 1.0</span><span class="delimiter">&quot;</span></span> };
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The above example version provider will show the fully qualified command name (that is, preceded by its parent fully qualified command name)
+of any command that uses this version provider.</p>
+</div>
+<div class="paragraph">
+<p>This is one way to create a version provider that can be reused across multiple commands.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_injecting_commandspec_into_a_iversionprovider">12.2.4. Injecting <code>CommandSpec</code> Into a <code>IVersionProvider</code></h4>
+<div class="paragraph">
+<p>From picocli 4.2.0, <code>IVersionProvider</code> implementations can have <code>@Spec</code>-annotated fields. If such a field
+exists, picocli will inject the <code>CommandSpec</code> of the command that uses this version provider.
+This gives the version provider access to the full command hierarchy,
+and may make it easier to implement version providers that can be reused among multiple commands.</p>
+</div>
+<div class="paragraph">
+<p>For example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="type">class</span> <span class="class">MyVersionProvider</span> <span class="directive">implements</span> IVersionProvider {
+    <span class="annotation">@Spec</span> CommandSpec spec;
+
+    <span class="directive">public</span> <span class="predefined-type">String</span><span class="type">[]</span> getVersion() {
+        <span class="keyword">return</span> <span class="keyword">new</span> <span class="predefined-type">String</span><span class="type">[]</span> { <span class="string"><span class="delimiter">&quot;</span><span class="content">Version info for </span><span class="delimiter">&quot;</span></span> + spec.qualifiedName() };
+    }
+}</code></pre>
+</div>
+</div>
 </div>
 </div>
 </div>
@@ -5085,9 +5142,129 @@ by default each of these fields would be shown in the usage message, which would
 </div>
 </div>
 <div class="sect2">
-<h3 id="_show_default_values">13.16. Show Default Values</h3>
+<h3 id="_show_at_files">13.16. Show At Files</h3>
+<div class="paragraph">
+<p>From picocli 4.2, an entry for <code>@&lt;filename&gt;</code> can be shown in the options and parameters list of the usage help message of a command with the <code>@Command(showAtFileInUsageHelp = true)</code> annotation.</p>
+</div>
 <div class="sect3">
-<h4 id="_default_value_variable">13.16.1. <code>${DEFAULT-VALUE}</code> Variable</h4>
+<h4 id="_example_2">13.16.1. Example</h4>
+<div class="paragraph">
+<p>Example command:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@Command</span>(name = <span class="string"><span class="delimiter">&quot;</span><span class="content">myapp</span><span class="delimiter">&quot;</span></span>, showAtFileInUsageHelp = <span class="predefined-constant">true</span>,
+        mixinStandardHelpOptions = <span class="predefined-constant">true</span>, description = <span class="string"><span class="delimiter">&quot;</span><span class="content">Example command.</span><span class="delimiter">&quot;</span></span>)
+<span class="type">class</span> <span class="class">MyApp</span> {
+    <span class="annotation">@Parameters</span>(description = <span class="string"><span class="delimiter">&quot;</span><span class="content">A file.</span><span class="delimiter">&quot;</span></span>) <span class="predefined-type">File</span> file;
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The usage help message for this command looks like this:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>Usage: myapp [-hV] [@&lt;filename&gt;...] &lt;file&gt;
+Example command.
+      [@&lt;filename&gt;...]   One or more argument files containing options.
+      &lt;file&gt;             A file.
+  -h, --help             Show this help message and exit.
+  -V, --version          Print version information and exit.</pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_changing_the_at_file_entry_location">13.16.2. Changing the At File Entry Location</h4>
+<div class="paragraph">
+<p>By default, the <code>@&lt;filename&gt;</code> entry is shown before the positional parameters in the synopsis as well as in the parameters list.</p>
+</div>
+<div class="paragraph">
+<p>This can be changed with the <a href="#_usage_help_api">Help API</a> for reordering sections. For example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="keyword">import</span> <span class="include">static</span> <span class="include">picocli.CommandLine.Model.UsageMessageSpec.SECTION_KEY_AT_FILE_PARAMETER</span>;
+<span class="keyword">import</span> <span class="include">static</span> <span class="include">picocli.CommandLine.Model.UsageMessageSpec.SECTION_KEY_COMMAND_LIST_HEADING</span>;
+<span class="keyword">import</span> <span class="include">static</span> <span class="include">picocli.CommandLine.Model.UsageMessageSpec.SECTION_KEY_OPTION_LIST_HEADING</span>;
+
+<span class="annotation">@Command</span>(name = <span class="string"><span class="delimiter">&quot;</span><span class="content">myapp</span><span class="delimiter">&quot;</span></span>, showAtFileInUsageHelp = <span class="predefined-constant">true</span>,
+        mixinStandardHelpOptions = <span class="predefined-constant">true</span>, description = <span class="string"><span class="delimiter">&quot;</span><span class="content">Example command.</span><span class="delimiter">&quot;</span></span>)
+<span class="type">class</span> <span class="class">MyApp</span> {
+    <span class="annotation">@Parameters</span>(description = <span class="string"><span class="delimiter">&quot;</span><span class="content">A file.</span><span class="delimiter">&quot;</span></span>) <span class="predefined-type">File</span> file;
+
+    <span class="directive">public</span> <span class="directive">static</span> <span class="type">void</span> main(<span class="predefined-type">String</span>... args) {
+        CommandLine cmd = <span class="keyword">new</span> CommandLine(<span class="keyword">new</span> MyApp());
+        <span class="predefined-type">List</span>&lt;<span class="predefined-type">String</span>&gt; copy = <span class="keyword">new</span> <span class="predefined-type">ArrayList</span>&lt;&gt;(cmd.getHelpSectionKeys());
+        copy.remove(SECTION_KEY_AT_FILE_PARAMETER);
+        copy.add(copy.indexOf(SECTION_KEY_COMMAND_LIST_HEADING), SECTION_KEY_AT_FILE_PARAMETER);
+        cmd.setHelpSectionKeys(copy);
+
+        cmd.usage(<span class="predefined-type">System</span>.out);
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The resulting usage help message shows the <code>@&lt;filename&gt;</code> entry has moved to the bottom, following the options list:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>Usage: myapp [-hV] [@&lt;filename&gt;...] &lt;file&gt;
+Example command.
+      &lt;file&gt;             A file.
+  -h, --help             Show this help message and exit.
+  -V, --version          Print version information and exit.
+      [@&lt;filename&gt;...]   One or more argument files containing options.</pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_changing_the_at_file_entry_text">13.16.3. Changing the At File Entry Text</h4>
+<div class="paragraph">
+<p>Both the label and the description of the <code>@&lt;filename&gt;</code> entry have been defined with <a href="#_custom_variables">custom variables</a>, to allow applications to change the text. The variables are:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><code>picocli.atfile.label</code></p>
+</li>
+<li>
+<p><code>picocli.atfile.description</code></p>
+</li>
+</ul>
+</div>
+<div class="paragraph">
+<p>By setting the above variables in either system properties, environment variables or the <a href="#_internationalization">resource bundle</a> for a command, the text can be customized.</p>
+</div>
+<div class="paragraph">
+<p>For example, if we define these system properties:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="predefined-type">System</span>.setProperty(<span class="string"><span class="delimiter">&quot;</span><span class="content">picocli.atfile.label</span><span class="delimiter">&quot;</span></span>, <span class="string"><span class="delimiter">&quot;</span><span class="content">my@@@@file</span><span class="delimiter">&quot;</span></span>);
+<span class="predefined-type">System</span>.setProperty(<span class="string"><span class="delimiter">&quot;</span><span class="content">picocli.atfile.description</span><span class="delimiter">&quot;</span></span>, <span class="string"><span class="delimiter">&quot;</span><span class="content">@files rock!</span><span class="delimiter">&quot;</span></span>);</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>then the usage help for our above example changes to this:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>Usage: myapp [-hV] [my@@@@file...] &lt;file&gt;
+Example command.
+      [my@@@@file...]   @files rock!
+      &lt;file&gt;            A file.
+  -h, --help            Show this help message and exit.
+  -V, --version         Print version information and exit.</pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_show_default_values">13.17. Show Default Values</h3>
+<div class="sect3">
+<h4 id="_default_value_variable">13.17.1. <code>${DEFAULT-VALUE}</code> Variable</h4>
 <div class="paragraph">
 <p>From picocli 3.2, it is possible to embed the <a href="#_default_values">default values</a> in the description for an option or positional parameter by
 specifying the <a href="#_variable_interpolation">variable</a> <code>${DEFAULT-VALUE}</code> in the description text.
@@ -5119,7 +5296,7 @@ CommandLine.usage(<span class="keyword">new</span> DefaultValues(), <span class=
 </div>
 </div>
 <div class="sect3">
-<h4 id="_completion_candidates_variable">13.16.2. <code>${COMPLETION-CANDIDATES}</code> Variable</h4>
+<h4 id="_completion_candidates_variable">13.17.2. <code>${COMPLETION-CANDIDATES}</code> Variable</h4>
 <div class="paragraph">
 <p>Similarly, it is possible to embed the completion candidates in the description for an option or positional parameter by
 specifying the <a href="#_variable_interpolation">variable</a> <code>${COMPLETION-CANDIDATES}</code> in the description text.</p>
@@ -5159,7 +5336,7 @@ CommandLine.usage(<span class="keyword">new</span> ValidValuesDemo(), <span clas
 </div>
 </div>
 <div class="sect3">
-<h4 id="_legacy_configuration_for_displaying_default_values">13.16.3. Legacy Configuration for Displaying Default Values</h4>
+<h4 id="_legacy_configuration_for_displaying_default_values">13.17.3. Legacy Configuration for Displaying Default Values</h4>
 <div class="paragraph">
 <p>Prior to picocli 3.2, you need to use the <code>@Command(showDefaultValues = true)</code> attribute to append the default value of
  all non-<code>null</code> options and positional parameters to the description column.</p>
@@ -5188,7 +5365,7 @@ This attribute accepts three values:</p>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_required_option_marker">13.17. Required-Option Marker</h3>
+<h3 id="_required_option_marker">13.18. Required-Option Marker</h3>
 <div class="paragraph">
 <p>Required options can be marked in the option list by the character specified with the <code>requiredOptionMarker</code> attribute. By default options are not marked because the synopsis shows users which options are required and which are optional. This feature may be useful in combination with the <a href="#_abbreviated_synopsis"><code>abbreviateSynopsis</code></a> attribute. For example:</p>
 </div>
@@ -5213,7 +5390,7 @@ This attribute accepts three values:</p>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_usage_width">13.18. Usage Width</h3>
+<h3 id="_usage_width">13.19. Usage Width</h3>
 <div class="paragraph">
 <p>The default width of the usage help message is 80 characters.
 Commands defined with <code>@Command(usageHelpWidth = NUMBER)</code> in the annotations will use the specified width.</p>
@@ -5229,7 +5406,7 @@ Commands defined with <code>@Command(usageHelpWidth = NUMBER)</code> in the anno
 </div>
 </div>
 <div class="sect2">
-<h3 id="_auto_terminal_width">13.19. Auto (Terminal) Width</h3>
+<h3 id="_auto_terminal_width">13.20. Auto (Terminal) Width</h3>
 <div class="paragraph">
 <p>From 4.0, commands defined with <code>@Command(usageHelpAutoWidth = true)</code> will try to adjust the usage message help layout to the terminal width.
 There is also programmatic API to control this via the <code>CommandLine::setUsageHelpAutoWidth</code> and <code>UsageMessageSpec::autoWidth</code> methods.</p>
@@ -5241,6 +5418,47 @@ There is also programmatic API to control this via the <code>CommandLine::setUsa
 <p>This feature requires Java 7.</p>
 </div>
 </div>
+<div class="sect2">
+<h3 id="_long_option_column_width">13.21. Long Option Column Width</h3>
+<div class="paragraph">
+<p>The default layout shows short options and long options in separate columns, followed by the description column.
+The width of the long options column shrinks automatically if all long options are very short,
+but by default this column does not grow larger than 20 characters.</p>
+</div>
+<div class="paragraph">
+<p>If the long option with its option parameter is longer than 20 characters
+(for example: <code>--output=&lt;outputFolder&gt;</code>), the long option overflows into the description column, and the option description is shown on the next line.</p>
+</div>
+<div class="paragraph">
+<p>This (the default) looks like this:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>Usage: myapp [-hV] [-o=&lt;outputFolder&gt;]
+  -h, --help      Show this help message and exit.
+  -o, --output=&lt;outputFolder&gt;
+                  Output location full path.
+  -V, --version   Print version information and exit.</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>From picocli 4.2, there is programmatic API to change this via the <code>CommandLine::setLongOptionsMaxWidth</code> and <code>UsageMessageSpec::longOptionsMaxWidth</code> methods.</p>
+</div>
+<div class="paragraph">
+<p>In the above example, if we call <code>commandLine.setLongOptionsMaxWidth(23)</code> before printing the usage help, we get this result:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>Usage: myapp [-hV] [-o=&lt;outputFolder&gt;]
+  -h, --help                    Show this help message and exit.
+  -o, --output=&lt;outputFolder&gt;   Output location full path.
+  -V, --version                 Print version information and exit.</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The minimum value that can be specified for <code>longOptionsMaxWidth</code> is 20, the maximum value is the <a href="#_usage_width">usage width</a> minus <code>20</code>.</p>
+</div>
+</div>
 </div>
 </div>
 <div class="sect1">
@@ -5359,6 +5577,11 @@ Markup styles cannot be nested, for example: <code>@|bold this @|underline that|
 </tr>
 </table>
 </div>
+<div class="paragraph">
+<p>From picocli 4.2, custom markup like <code>@|bold mytext|@</code>, <code>@|italic mytext|@</code> etc. can also be converted to custom markup like <code>&lt;b&gt;mytext&lt;/b&gt;</code> and <code>&lt;i&gt;mytext&lt;/i&gt;</code> in HTML, or <code>*mytext*</code> and <code>_mytext_</code> in lightweight markup languages like AsciiDoc.
+Applications can control this by setting a <code>ColorScheme</code> with a custom markup map.
+This feature is used to generate man page documentation.</p>
+</div>
 </div>
 <div class="sect2">
 <h3 id="_styles_and_colors_in_application_output">14.3. Styles and Colors in Application Output</h3>
@@ -5771,6 +5994,9 @@ map.put(SECTION_KEY_FOOTER,                 help -&gt; help.footer());</code></p
 <p>SECTION_KEY_PARAMETER_LIST_HEADING</p>
 </li>
 <li>
+<p>SECTION_KEY_AT_FILE_PARAMETER</p>
+</li>
+<li>
 <p>SECTION_KEY_PARAMETER_LIST</p>
 </li>
 <li>
@@ -5910,9 +6136,6 @@ See the <a href="https://github.com/remkop/picocli/blob/master/src/test/java/pic
 </div>
 </div>
 <div class="paragraph">
-<p>The declared subcommands are automatically instantiated and added when the <code>new CommandLine(new Git())</code> instance is constructed. The result is the same as if subcommands were added <a href="#_registering_subcommands_programmatically">programmatically</a>.</p>
-</div>
-<div class="paragraph">
 <p>Subcommands referenced in a <code>subcommands</code> attribute <em>must</em> have a <code>@Command</code> annotation with a <code>name</code> attribute, or an exception is thrown from the <code>CommandLine</code> constructor. This name will be used both for generating usage help and for recognizing subcommands when parsing the command line.</p>
 </div>
 <div class="paragraph">
@@ -5921,6 +6144,12 @@ See the <a href="https://github.com/remkop/picocli/blob/master/src/test/java/pic
 <div class="paragraph">
 <p>Subcommands referenced in a <code>subcommands</code> attribute need to have a public no-argument constructor to be instantiated, unless a <a href="#_custom_factory">Custom Factory</a> is installed to instantiate classes.</p>
 </div>
+<div class="paragraph">
+<p>Prior to picocli 4,2, the declared subcommands were instantiated immediately when the top-level <code>CommandLine</code> (the <code>new CommandLine(new Git())</code> object in the above example) was constructed.</p>
+</div>
+<div class="paragraph">
+<p>From picocli 4.2, the declared subcommands are not instantiated until they are matched on the command line, unless they have a <code>@Spec</code> or <code>@ParentObject</code>-annotated field; these are injected during initialization, and in order to inject them the subcommand is instantiated during initialization.</p>
+</div>
 </div>
 <div class="sect2">
 <h3 id="_registering_subcommands_programmatically">16.2. Registering Subcommands Programmatically</h3>
@@ -5991,7 +6220,10 @@ adding subcommands.
 <div class="sect2">
 <h3 id="_subcommands_as_methods">16.4. Subcommands as Methods</h3>
 <div class="paragraph">
-<p>From picocli 3.6 it is possible to register subcommands in a very compact manner by having a <code>@Command</code> class with <code>@Command</code>-annotated methods. The methods are automatically <a href="#_subcommand_methods">registered as subcommands</a> of the <code>@Command</code> class.</p>
+<p>As of picocli 3.6 it is possible to register subcommands in a very compact manner by having a <code>@Command</code> class with <code>@Command</code>-annotated methods. The methods are automatically <a href="#_subcommand_methods">registered as subcommands</a> of the <code>@Command</code> class.</p>
+</div>
+<div class="paragraph">
+<p>The <a href="https://github.com/remkop/picocli/blob/master/picocli-examples"><code>picocli-examples</code></a> module has an  minimal example application, demonstrating the definition of subcommands via methods. This example was coded in <a href="https://github.com/remkop/picocli/blob/master/picocli-examples/src/main/java/picocli/examples/subcommands/SubCmdsViaMethods.java">Java</a>, <a href="https://github.com/remkop/picocli/blob/master/picocli-examples/src/main/kotlin/picocli/examples/kotlin/subcommands/SubCmdsViaMethods.kt">Kotlin</a> and <a href="https://github.com/remkop/picocli/blob/master/picocli-examples/src/main/scala/picocli/examples/scala/subcommands/SubCmdsViaMethods.scala">Scala</a>.</p>
 </div>
 </div>
 <div class="sect2">
@@ -6222,7 +6454,161 @@ The <code>List</code> subcommand can use the <code>@ParentCommand</code> annotat
 </div>
 </div>
 <div class="sect2">
-<h3 id="_usage_help_for_subcommands">16.8. Usage Help for Subcommands</h3>
+<h3 id="_nested_sub_subcommands">16.8. Nested sub-Subcommands</h3>
+<div class="paragraph">
+<p>The specified object can be an annotated object or a
+<code>CommandLine</code> instance with its own nested subcommands. For example:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java">CommandLine commandLine = <span class="keyword">new</span> CommandLine(<span class="keyword">new</span> MainCommand())
+    .addSubcommand(<span class="string"><span class="delimiter">&quot;</span><span class="content">cmd1</span><span class="delimiter">&quot;</span></span>,                 <span class="keyword">new</span> ChildCommand1())
+    .addSubcommand(<span class="string"><span class="delimiter">&quot;</span><span class="content">cmd2</span><span class="delimiter">&quot;</span></span>,                 <span class="keyword">new</span> ChildCommand2())
+    .addSubcommand(<span class="string"><span class="delimiter">&quot;</span><span class="content">cmd3</span><span class="delimiter">&quot;</span></span>, <span class="keyword">new</span> CommandLine(<span class="keyword">new</span> ChildCommand3())
+        .addSubcommand(<span class="string"><span class="delimiter">&quot;</span><span class="content">cmd3sub1</span><span class="delimiter">&quot;</span></span>,                 <span class="keyword">new</span> GrandChild3Command1())
+        .addSubcommand(<span class="string"><span class="delimiter">&quot;</span><span class="content">cmd3sub2</span><span class="delimiter">&quot;</span></span>,                 <span class="keyword">new</span> GrandChild3Command2())
+        .addSubcommand(<span class="string"><span class="delimiter">&quot;</span><span class="content">cmd3sub3</span><span class="delimiter">&quot;</span></span>, <span class="keyword">new</span> CommandLine(<span class="keyword">new</span> GrandChild3Command3())
+            .addSubcommand(<span class="string"><span class="delimiter">&quot;</span><span class="content">cmd3sub3sub1</span><span class="delimiter">&quot;</span></span>, <span class="keyword">new</span> GreatGrandChild3Command3_1())
+            .addSubcommand(<span class="string"><span class="delimiter">&quot;</span><span class="content">cmd3sub3sub2</span><span class="delimiter">&quot;</span></span>, <span class="keyword">new</span> GreatGrandChild3Command3_2())
+        )
+    );</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>Declaratively, subcommands can be nested by specifying the <code>subcommands</code> attribute on subcommand classes:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@Command</span>(name = <span class="string"><span class="delimiter">&quot;</span><span class="content">main</span><span class="delimiter">&quot;</span></span>, subcommands = {
+    ChildCommand1.class,
+    ChildCommand2.class,
+    ChildCommand3.class })
+<span class="type">class</span> <span class="class">MainCommand</span> { }
+
+<span class="annotation">@Command</span>(name = <span class="string"><span class="delimiter">&quot;</span><span class="content">cmd3</span><span class="delimiter">&quot;</span></span>, subcommands = {
+    GrandChild3Command1.class,
+    GrandChild3Command2.class,
+    GrandChild3Command3.class })
+<span class="type">class</span> <span class="class">ChildCommand3</span> { }
+
+<span class="annotation">@Command</span>(name = <span class="string"><span class="delimiter">&quot;</span><span class="content">cmd3sub3</span><span class="delimiter">&quot;</span></span>, subcommands = {
+    GreatGrandChild3Command3_1.class,
+    GreatGrandChild3Command3_2.class })
+<span class="type">class</span> <span class="class">GrandChild3Command3</span> { }
+...</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>By default, the usage help message only shows the subcommands of the specified command,
+and not the nested sub-subcommands. This can be customized by specifying your own <a href="#_reordering_sections"><code>IHelpSectionRenderer</code></a> for the command list section.
+The <code>picocli-examples</code> module has an <a href="https://github.com/remkop/picocli/blob/master/picocli-examples/src/main/java/picocli/examples/customhelp/ShowCommandHierarchy.java">example</a> that shows how to accomplish this.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_repeatable_subcommands">16.9. Repeatable Subcommands</h3>
+<div class="paragraph">
+<p>From picocli 4.2, it is possible to specify that a command&#8217;s subcommands can be specified multiple times by marking it with <code>@Command(subcommandsRepeatable = true)</code>.</p>
+</div>
+<div class="sect3">
+<h4 id="_example_3">16.9.1. Example</h4>
+<div class="paragraph">
+<p>Below is an example where the top-level command <code>myapp</code> is marked as <code>subcommandsRepeatable = true</code>.
+This command has three subcommands, <code>add</code>, <code>list</code> and <code>send-report</code>:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@Command</span>(name = <span class="string"><span class="delimiter">&quot;</span><span class="content">myapp</span><span class="delimiter">&quot;</span></span>, subcommandsRepeatable = <span class="predefined-constant">true</span>)
+<span class="type">class</span> <span class="class">MyApp</span> <span class="directive">implements</span> <span class="predefined-type">Runnable</span> {
+
+    <span class="annotation">@Command</span>
+    <span class="type">void</span> add(<span class="annotation">@Option</span>(names = <span class="string"><span class="delimiter">&quot;</span><span class="content">-x</span><span class="delimiter">&quot;</span></span>) <span class="predefined-type">String</span> x, <span class="annotation">@Option</span>(names = <span class="string"><span class="delimiter">&quot;</span><span class="content">-w</span><span class="delimiter">&quot;</span></span>) <span class="type">double</span> w) { ... }
+
+    <span class="annotation">@Command</span>
+    <span class="type">void</span> list(<span class="annotation">@Option</span>(names = <span class="string"><span class="delimiter">&quot;</span><span class="content">--where</span><span class="delimiter">&quot;</span></span>) <span class="predefined-type">String</span> where) { ... }
+
+    <span class="annotation">@Command</span>(name = <span class="string"><span class="delimiter">&quot;</span><span class="content">send-report</span><span class="delimiter">&quot;</span></span>)
+    <span class="type">void</span> sendReport(<span class="annotation">@Option</span>(names = <span class="string"><span class="delimiter">&quot;</span><span class="content">--to</span><span class="delimiter">&quot;</span></span>, split = <span class="string"><span class="delimiter">&quot;</span><span class="content">,</span><span class="delimiter">&quot;</span></span>) <span class="predefined-type">String</span><span class="type">[]</span> recipients) { ... }
+
+    <span class="directive">public</span> <span class="directive">static</span> <span class="type">void</span> main(<span class="predefined-type">String</span>... args) {
+        <span class="keyword">new</span> CommandLine(<span class="keyword">new</span> MyApp()).execute(args);
+    }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>The above example command allows users to specify one or more of its subcommands multiple time. For example, this would be a valid invocation:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="bash">myapp add -x=item1 -w=0.2 \
+      add -x=item2 -w=0.5 \
+      add -x=item3 -w=0.7 \
+      list --where &quot;w&gt;0.2&quot; \
+      send-report --to=recipient@myorg.com</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>In the above command line invocation, the <code>myapp</code> top-level command is followed by its subcommand <code>add</code>.
+Next, this is followed by another two occurences of <code>add</code>, followed by <code>list</code> and <code>send-report</code>.
+These are all "sibling" commands, that share the same parent command <code>myapp</code>.
+This invocation is valid because <code>myapp</code> is marked with <code>subcommandsRepeatable = true</code>.</p>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_repeatable_subcommands_specification">16.9.2. Repeatable Subcommands Specification</h4>
+<div class="paragraph">
+<p>Normally, <code>subcommandsRepeatable</code> is <code>false</code>, so for each command, only one of its subcommands can be specified, potentially followed by only one sub-subcommand of that subcommand, etc.
+In mathematical terms, a valid sequence of commands and subcommands can be represented by a <em>directed rooted tree</em> that starts at the top-level command. This is illustrated by the diagram below.</p>
+</div>
+<div id="sequences-when-subcommands-not-repeatable" class="imageblock">
+<div class="content">
+<img src="images/subcommands-non-repeatable.png" alt="subcommands non repeatable">
+</div>
+<div class="title">Figure 1. By default, valid sequences of commands and subcommands form a directed rooted tree.</div>
+</div>
+<div class="paragraph">
+<p>When <code>subcommandsRepeatable</code> is set to <code>true</code> on a command, the subcommands of this command may appear multiple times.
+Also, a subcommand can be followed by a "sibling" command (another command with the same parent command).</p>
+</div>
+<div class="paragraph">
+<p>In mathematical terms, when a parent command has this property, the additional valid sequences of its subcommands form a fully connected subgraph (<em>a complete digraph</em>).</p>
+</div>
+<div class="paragraph">
+<p>The blue and green dotted arrows in the diagram below illustrate the additional sequences that are allowed when a command has repeatable subcommands.</p>
+</div>
+<div id="sequences-when-subcommands-repeatable" class="imageblock">
+<div class="content">
+<img src="images/subcommands-repeatable.png" alt="subcommands repeatable">
+</div>
+<div class="title">Figure 2. If a command is marked to allow repeatable subcommands, the additional valid sequences of its subcommands form a fully connected subgraph.</div>
+</div>
+<div class="paragraph">
+<p>Note that it is not valid to specify a subcommand followed by its parent command:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="bash"># invalid: cannot move _up_ the hierarchy
+myapp add -x=item1 -w=0.2 myapp</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_repeatable_subcommands_execution">16.9.3. Repeatable Subcommands Execution</h4>
+<div class="paragraph">
+<p>The default <a href="#_executing_commands_with_subcommands"><code>IExecutionStrategy</code></a> (<code>picocli.CommandLine.RunLast</code>) only executes the last subcommands <em>with the same parent</em>. For example, if</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>toplevelcmd subcmd-A subcmd-B subsub-B1 subsub-B2</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>is invoked, only the last two sub-subcommands <code>subsub-B1</code> and <code>subsub-B2</code> (who both have parent command <code>subcmd-B</code>) are executed by default. You can <a href="https://picocli.info/apidocs/picocli/CommandLine.html#setExecutionStrategy-picocli.CommandLine.IExecutionStrategy-">set</a> a different <a href="https://picocli.info/apidocs/picocli/CommandLine.IExecutionStrategy.html">execution strategy</a> if this does not meet your needs.</p>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_usage_help_for_subcommands">16.10. Usage Help for Subcommands</h3>
 <div class="paragraph">
 <p>After registering subcommands, calling the <code>commandLine.usage</code> method will show a usage help message that includes all registered subcommands. For example:</p>
 </div>
@@ -6334,7 +6720,7 @@ in <a href="#_expanded_example">Expanded Example</a>.</p>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_hidden_subcommands">16.9. Hidden Subcommands</h3>
+<h3 id="_hidden_subcommands">16.11. Hidden Subcommands</h3>
 <div class="paragraph">
 <p>Commands with the <code>hidden</code> attribute set to <code>true</code> will not be shown in the usage help message of their parent command.</p>
 </div>
@@ -6365,7 +6751,7 @@ Commands:
 </div>
 </div>
 <div class="sect2">
-<h3 id="_help_subcommands">16.10. Help Subcommands</h3>
+<h3 id="_help_subcommands">16.12. Help Subcommands</h3>
 <div class="paragraph">
 <p>Commands with the <code>helpCommand</code> attribute set to <code>true</code> are treated as help commands.
 When picocli encounters a help command on the command line, required options and required positional parameters of the parent command
@@ -6381,58 +6767,7 @@ are not validated (similar to <a href="#_help_options">help options</a>).</p>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_nested_sub_subcommands">16.11. Nested sub-Subcommands</h3>
-<div class="paragraph">
-<p>The specified object can be an annotated object or a
-<code>CommandLine</code> instance with its own nested subcommands. For example:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="CodeRay highlight"><code data-lang="java">CommandLine commandLine = <span class="keyword">new</span> CommandLine(<span class="keyword">new</span> MainCommand())
-    .addSubcommand(<span class="string"><span class="delimiter">&quot;</span><span class="content">cmd1</span><span class="delimiter">&quot;</span></span>,                 <span class="keyword">new</span> ChildCommand1())
-    .addSubcommand(<span class="string"><span class="delimiter">&quot;</span><span class="content">cmd2</span><span class="delimiter">&quot;</span></span>,                 <span class="keyword">new</span> ChildCommand2())
-    .addSubcommand(<span class="string"><span class="delimiter">&quot;</span><span class="content">cmd3</span><span class="delimiter">&quot;</span></span>, <span class="keyword">new</span> CommandLine(<span class="keyword">new</span> ChildCommand3())
-        .addSubcommand(<span class="string"><span class="delimiter">&quot;</span><span class="content">cmd3sub1</span><span class="delimiter">&quot;</span></span>,                 <span class="keyword">new</span> GrandChild3Command1())
-        .addSubcommand(<span class="string"><span class="delimiter">&quot;</span><span class="content">cmd3sub2</span><span class="delimiter">&quot;</span></span>,                 <span class="keyword">new</span> GrandChild3Command2())
-        .addSubcommand(<span class="string"><span class="delimiter">&quot;</span><span class="content">cmd3sub3</span><span class="delimiter">&quot;</span></span>, <span class="keyword">new</span> CommandLine(<span class="keyword">new</span> GrandChild3Command3())
-            .addSubcommand(<span class="string"><span class="delimiter">&quot;</span><span class="content">cmd3sub3sub1</span><span class="delimiter">&quot;</span></span>, <span class="keyword">new</span> GreatGrandChild3Command3_1())
-            .addSubcommand(<span class="string"><span class="delimiter">&quot;</span><span class="content">cmd3sub3sub2</span><span class="delimiter">&quot;</span></span>, <span class="keyword">new</span> GreatGrandChild3Command3_2())
-        )
-    );</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>Declaratively, subcommands can be nested by specifying the <code>subcommands</code> attribute on subcommand classes:</p>
-</div>
-<div class="listingblock">
-<div class="content">
-<pre class="CodeRay highlight"><code data-lang="java"><span class="annotation">@Command</span>(name = <span class="string"><span class="delimiter">&quot;</span><span class="content">main</span><span class="delimiter">&quot;</span></span>, subcommands = {
-    ChildCommand1.class,
-    ChildCommand2.class,
-    ChildCommand3.class })
-<span class="type">class</span> <span class="class">MainCommand</span> { }
-
-<span class="annotation">@Command</span>(name = <span class="string"><span class="delimiter">&quot;</span><span class="content">cmd3</span><span class="delimiter">&quot;</span></span>, subcommands = {
-    GrandChild3Command1.class,
-    GrandChild3Command2.class,
-    GrandChild3Command3.class })
-<span class="type">class</span> <span class="class">ChildCommand3</span> { }
-
-<span class="annotation">@Command</span>(name = <span class="string"><span class="delimiter">&quot;</span><span class="content">cmd3sub3</span><span class="delimiter">&quot;</span></span>, subcommands = {
-    GreatGrandChild3Command3_1.class,
-    GreatGrandChild3Command3_2.class })
-<span class="type">class</span> <span class="class">GrandChild3Command3</span> { }
-...</code></pre>
-</div>
-</div>
-<div class="paragraph">
-<p>By default, the usage help message only shows the subcommands of the specified command,
-and not the nested sub-subcommands. This can be customized by specifying your own <a href="#_reordering_sections"><code>IHelpSectionRenderer</code></a> for the command list section.
-The <code>picocli-examples</code> module has an <a href="https://github.com/remkop/picocli/blob/master/picocli-examples/src/main/java/picocli/examples/customhelp/ShowCommandHierarchy.java">example</a> that shows how to accomplish this.</p>
-</div>
-</div>
-<div class="sect2">
-<h3 id="_required_subcommands">16.12. Required Subcommands</h3>
+<h3 id="_required_subcommands">16.13. Required Subcommands</h3>
 <div class="paragraph">
 <p>For some command suites, it does not make sense to invoke the top-level command by itself, and the user is required to specify a subcommand.</p>
 </div>
@@ -6599,7 +6934,80 @@ commandLine.parseArgs(<span class="string"><span class="delimiter">&quot;</span>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_reuse_combinations">17.3. Reuse Combinations</h3>
+<h3 id="_use_case_sharing_options">17.3. Use Case: Sharing Options</h3>
+<div class="paragraph">
+<p>A common use case is sharing options between different levels of the command hierarchy, so that "global" options from the top-level command are also available on subcommands.</p>
+</div>
+<div class="paragraph">
+<p>Since picocli 4.2, <a href="#_parentcommand_annotation"><code>@ParentCommand</code>-annotated</a> fields can be used in mixins, which makes this easier. Here is an example implementation:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre class="CodeRay highlight"><code data-lang="java"><span class="comment">// Define a mixin that delegates to the parent command.</span>
+<span class="type">class</span> <span class="class">MyMixin</span> {
+    <span class="annotation">@ParentCommand</span> Top top;
+
+    <span class="annotation">@Option</span>(names = <span class="string"><span class="delimiter">&quot;</span><span class="content">-v</span><span class="delimiter">&quot;</span></span>)
+    <span class="directive">public</span> <span class="type">void</span> setVerbose(<span class="type">boolean</span><span class="type">[]</span> verbosity) { top.setVerbose(verbosity); }
+}
+
+<span class="comment">// An example Top-level command with two subcommands.</span>
+<span class="comment">// The `-v` option can be specified on the top-level command as well as the subcommands.</span>
+<span class="annotation">@Command</span>(subcommands = Sub2.class)
+<span class="type">class</span> <span class="class">Top</span> <span class="directive">implements</span> <span class="predefined-type">Runnable</span> {
+    <span class="directive">private</span> <span class="type">boolean</span><span class="type">[]</span> verbosity = <span class="keyword">new</span> <span class="type">boolean</span>[<span class="integer">0</span>];
+
+    <span class="annotation">@Option</span>(names = {<span class="string"><span class="delimiter">&quot;</span><span class="content">-v</span><span class="delimiter">&quot;</span></span>, <span class="string"><span class="delimiter">&quot;</span><span class="content">--verbose</span><span class="delimiter">&quot;</span></span>})
+    <span class="directive">public</span> <span class="type">void</span> setVerbose(<span class="type">boolean</span><span class="type">[]</span> verbosity) { <span class="local-variable">this</span>.verbosity = verbosity; }
+
+    <span class="directive">public</span> <span class="type">void</span> verbose(<span class="predefined-type">String</span> pattern, <span class="predefined-type">Object</span>... params) {
+        <span class="keyword">if</span> (verbosity.length &gt;= <span class="integer">1</span>) {
+            <span class="predefined-type">System</span>.out.printf(pattern, params);
+        }
+    }
+
+    <span class="directive">public</span> <span class="type">void</span> run() { verbose(<span class="string"><span class="delimiter">&quot;</span><span class="content">Hello from top%n</span><span class="delimiter">&quot;</span></span>); }
+
+    <span class="directive">public</span> <span class="directive">static</span> <span class="type">void</span> main(<span class="predefined-type">String</span><span class="type">[]</span> args) {
+        <span class="keyword">new</span> CommandLine(<span class="keyword">new</span> Top()).execute(args);
+    }
+
+    <span class="comment">// The @Mixin-annotated parameter adds the `-v` option to this subcommand.</span>
+    <span class="annotation">@Command</span>
+    <span class="type">void</span> sub1(<span class="annotation">@Mixin</span> MyMixin mymixin) { verbose(<span class="string"><span class="delimiter">&quot;</span><span class="content">Hello from sub1%n</span><span class="delimiter">&quot;</span></span>); }
+}
+
+<span class="comment">// Subcommand classes can mix in the `-v` option with a @Mixin-annotated field.</span>
+<span class="annotation">@Command</span>(name = <span class="string"><span class="delimiter">&quot;</span><span class="content">sub2</span><span class="delimiter">&quot;</span></span>)
+<span class="type">class</span> <span class="class">Sub2</span> <span class="directive">implements</span> <span class="predefined-type">Runnable</span>{
+    <span class="annotation">@Mixin</span> MyMixin mymixin;
+
+    <span class="annotation">@Override</span>
+    <span class="directive">public</span> <span class="type">void</span> run() { mymixin.top.verbose(<span class="string"><span class="delimiter">&quot;</span><span class="content">Hello from sub2%n</span><span class="delimiter">&quot;</span></span>); }
+}</code></pre>
+</div>
+</div>
+<div class="paragraph">
+<p>With this, the <code>-v</code> option can be specified on the top-level command as well as the subcommands, so all of the below are valid invocations:</p>
+</div>
+<div class="listingblock">
+<div class="content">
+<pre>java Top -v
+java Top -v sub1
+java Top sub1 -v
+java Top -v sub2
+java Top sub2 -v</pre>
+</div>
+</div>
+<div class="paragraph">
+<p>All of these invocations will print some output, since the <code>-v</code> option was specified.</p>
+</div>
+<div class="paragraph">
+<p>For mixins that need to be reusable across more than two levels in the command hierarchy, injecting a <a href="#_spec_annotation"><code>@Spec</code>-annotated</a> field gives the mixin access to the full command hierarchy.</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_reuse_combinations">17.4. Reuse Combinations</h3>
 <div class="paragraph">
 <p>The above mechanisms can be combined in any way. Mixins can be nested, and there is no limitation to how deeply mixins can be nested. A mixin may also inherit options, positional parameters and command attributes from a super class.</p>
 </div>
@@ -6641,9 +7049,12 @@ commandLine.parseArgs(<span class="string"><span class="delimiter">&quot;</span>
 <h2 id="_internationalization">18. Internationalization</h2>
 <div class="sectionbody">
 <div class="paragraph">
-<p>From version 3.6, usage help message sections and the description for options and positional parameters can be specified in a resource bundle.
+<p>As of version 3.6, usage help message sections and the description for options and positional parameters can be specified in a resource bundle.
 A resource bundle can be set via annotations and programmatically.</p>
 </div>
+<div class="paragraph">
+<p>In order to get you started quickly, the <a href="https://github.com/remkop/picocli/blob/master/picocli-examples"><code>picocli-examples</code></a> module has a minimal i18n example, coded both in <a href="https://github.com/remkop/picocli/blob/master/picocli-examples/src/main/java/picocli/examples/i18n/I18NDemo.java">Java</a> and <a href="https://github.com/remkop/picocli/tree/master/picocli-examples/src/main/kotlin/picocli/examples/kotlin/i18n/I18NDemo.kt">Kotlin</a>.</p>
+</div>
 <div class="sect2">
 <h3 id="_configuration">18.1. Configuration</h3>
 <div class="paragraph">
@@ -7650,7 +8061,7 @@ To use this custom factory, add the following dependency:</p>
 <pre class="CodeRay highlight"><code data-lang="xml"><span class="tag">&lt;dependency&gt;</span>
   <span class="tag">&lt;groupId&gt;</span>info.picocli<span class="tag">&lt;/groupId&gt;</span>
   <span class="tag">&lt;artifactId&gt;</span>picocli-spring-boot-starter<span class="tag">&lt;/artifactId&gt;</span>
-  <span class="tag">&lt;version&gt;</span>4.0.1<span class="tag">&lt;/version&gt;</span>
+  <span class="tag">&lt;version&gt;</span>4.2.0<span class="tag">&lt;/version&gt;</span>
 <span class="tag">&lt;/dependency&gt;</span></code></pre>
 </div>
 </div>
@@ -7660,7 +8071,7 @@ To use this custom factory, add the following dependency:</p>
 <div class="listingblock">
 <div class="content">
 <pre class="CodeRay highlight"><code>dependencies {
-    compile "info.picocli:picocli-spring-boot-starter:4.0.1"
+    compile "info.picocli:picocli-spring-boot-starter:4.2.0"
 }</code></pre>
 </div>
 </div>
@@ -7889,7 +8300,44 @@ See the <a href="autocomplete.html">Autocomplete for Java Command Line Applicati
 </div>
 </div>
 <div class="sect1">
-<h2 id="_java_9_jpms_modules">24. Java 9 JPMS Modules</h2>
+<h2 id="_generate_man_page_documentation">24. Generate Man Page Documentation</h2>
+<div class="sectionbody">
+<div class="paragraph">
+<p>From picocli 4.2, the <code>picocli-codegen</code> module has a <code>ManPageGenerator</code> tool that can generate AsciiDoc documentation using the <code>manpage</code> doctype and manpage document structure.
+The generated AsciiDoc files can be converted to HTML, PDF and unix man pages with the wonderful <a href="https://asciidoctor.org/docs/user-manual/#man-pages">asciidoctor</a> tool.</p>
+</div>
+<div class="paragraph">
+<p>See the <a href="https://github.com/remkop/picocli/tree/master/picocli-codegen#generate-documentation">Generate Documentation</a> section of the <a href="https://github.com/remkop/picocli/tree/master/picocli-codegen">picocli-codegen README</a> for details on how to generate and customize this documentation.</p>
+</div>
+<div class="paragraph">
+<p>The man pages for the picocli built-in tools were created with this tool:</p>
+</div>
+<div class="ulist">
+<ul>
+<li>
+<p><a href="man/gen-manpage.html">gen-manpage</a> (<code>picocli.codegen.docgen.manpage.ManPageGenerator</code>)</p>
+</li>
+<li>
+<p><a href="man/picocli.AutoComplete.html">picocli.AutoComplete</a> (<code>picocli.AutoComplete</code>)</p>
+</li>
+<li>
+<p><a href="man/generate-completion.html">generate-completion</a> (<code>picocli.AutoComplete$GenerateCompletion</code> - to be used as a subcommand)</p>
+</li>
+<li>
+<p><a href="man/gen-reflect-config.html">gen-reflect-config</a> (<code>picocli.codegen.aot.graalvm.ReflectionConfigGenerator</code>)</p>
+</li>
+<li>
+<p><a href="man/gen-proxy-config.html">gen-proxy-config</a> (<code>picocli.codegen.aot.graalvm.DynamicProxyConfigGenerator</code>)</p>
+</li>
+<li>
+<p><a href="man/gen-resource-config.html">gen-resource-config</a> (<code>picocli.codegen.aot.graalvm.ResourceConfigGenerator</code>)</p>
+</li>
+</ul>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_java_9_jpms_modules">25. Java 9 JPMS Modules</h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>The main <code>picocli-${version}.jar</code> is a JPMS module named <code>info.picocli</code>.</p>
@@ -7905,7 +8353,7 @@ This causes problems for some older tools, which incorrectly process the module
 To provide the best backward compatibility, the main picocli artifact is a <a href="https://openjdk.java.net/jeps/238#Modular-multi-release-JAR-files">modular multi-release jar</a> with the <code>module-info.class</code> file located in <code>META-INF/versions/9</code>.</p>
 </div>
 <div class="sect2">
-<h3 id="_module_configuration">24.1. Module Configuration</h3>
+<h3 id="_module_configuration">25.1. Module Configuration</h3>
 <div class="paragraph">
 <p>Applications that use Java 9&#8217;s modules need to configure their module to allow picocli reflective access to the annotated classes and fields.</p>
 </div>
@@ -7946,7 +8394,7 @@ open module com.yourorg.yourapp {
 </div>
 </div>
 <div class="sect1">
-<h2 id="_osgi_bundle">25. OSGi Bundle</h2>
+<h2 id="_osgi_bundle">26. OSGi Bundle</h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p><span class="image"><img src="https://www.osgi.org/wp-content/uploads/OSGi-website-header-logo.png" alt="OSGi logo"></span></p>
@@ -7957,13 +8405,13 @@ open module com.yourorg.yourapp {
 </div>
 </div>
 <div class="sect1">
-<h2 id="_packaging_your_application">26. Packaging Your Application</h2>
+<h2 id="_packaging_your_application">27. Packaging Your Application</h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>You finished your application. Congratulations! Now, how do you package it and distribute it to your users? Here are some ideas.</p>
 </div>
 <div class="sect2">
-<h3 id="_graalvm_native_image">26.1. GraalVM Native Image</h3>
+<h3 id="_graalvm_native_image">27.1. GraalVM Native Image</h3>
 <div class="paragraph">
 <p><span class="image"><img src="images/exe-picocli-on-graalvm.png" alt="Turn your picocli-based application into a native image" width="265" height="150"></span></p>
 </div>
@@ -8000,25 +8448,25 @@ Gradle users may be interested in the <a href="https://github.com/palantir/gradl
 </div>
 </div>
 <div class="sect2">
-<h3 id="_build_tool_plugins">26.2. Build Tool Plugins</h3>
+<h3 id="_build_tool_plugins">27.2. Build Tool Plugins</h3>
 <div class="paragraph">
 <p>Both <a href="https://www.mojohaus.org/appassembler/">Application Assembler Maven Plugin</a> and <a href="https://docs.gradle.org/current/userguide/application_plugin.html">Gradle Application plugin</a> create a distribution zip or tar file with launcher scripts. Both require a JRE to be installed on the target machine.</p>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_launch4j">26.3. launch4j</h3>
+<h3 id="_launch4j">27.3. launch4j</h3>
 <div class="paragraph">
 <p><a href="http://launch4j.sourceforge.net/docs.html">launch4j</a> can create a native launcher executable. It can bundle a JRE (~200MB) or use a pre-installed one.</p>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_javapackager_java_8">26.4. javapackager (Java 8)</h3>
+<h3 id="_javapackager_java_8">27.4. javapackager (Java 8)</h3>
 <div class="paragraph">
 <p>JDK 8 <a href="https://docs.oracle.com/javase/8/docs/technotes/tools/windows/javapackager.html">javapackager</a> can create a native launcher executable. It can bundle a JRE (~200MB) or use a pre-installed one.</p>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_jlink_java_9">26.5. jlink (Java 9+)</h3>
+<h3 id="_jlink_java_9">27.5. jlink (Java 9+)</h3>
 <div class="paragraph">
 <p>With the JPMS module system introduced in Java 9 it became possible to use <a href="https://docs.oracle.com/javase/9/tools/jlink.htm#JSWOR-GUID-CECAC52B-CFEE-46CB-8166-F17A8E9280E9">jlink</a> to create a custom light-weight JRE with only the necessary modules.
 This JRE may be as small as 30-40MB.
@@ -8029,7 +8477,7 @@ Use <code>jlink</code> with the <code>--launcher</code> option to generate launc
 </div>
 </div>
 <div class="sect2">
-<h3 id="_jpackage_early_access">26.6. jpackage (Early Access)</h3>
+<h3 id="_jpackage_early_access">27.6. jpackage (Early Access)</h3>
 <div class="paragraph">
 <p><a href="https://jdk.java.net/jpackage/">jpackage</a> is an early access build of <a href="https://openjdk.java.net/jeps/343">JEP 343: Packaging Tool</a>.
 JPackage can take the custom light-weight JRE produced by <code>jlink</code> and create an installer and a native application launcher.
@@ -8043,16 +8491,27 @@ Gradle users may like these plugins: <a href="https://badass-runtime-plugin.bery
 and <a href="https://badass-jlink-plugin.beryx.org/releases/latest/">org.beryx Badass JLink Plugin</a>.</p>
 </div>
 </div>
+<div class="sect2">
+<h3 id="_jbang">27.7. jbang</h3>
+<div class="paragraph">
+<p><a href="https://github.com/maxandersen/jbang">jbang</a> allows you to write scripts in Java that use external dependencies.
+You use it with a <code>//DEPS</code> comment, similar to the <a href="http://groovy-lang.org/grape.html"><code>@Grab</code></a> annotation in Groovy.</p>
+</div>
+<div class="paragraph">
+<p>Use <code>jbang --init=cli helloworld.java</code> to create an initial script with a picocli template.
+This <a href="https://asciinema.org/a/AVwA19yijKRNKEO0bJENN2ME3?autoplay=true&amp;speed=2">asciinema presentation</a> shows what is possible.</p>
+</div>
+</div>
 </div>
 </div>
 <div class="sect1">
-<h2 id="_picocli_in_other_languages">27. Picocli in Other Languages</h2>
+<h2 id="_picocli_in_other_languages">28. Picocli in Other Languages</h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>Picocli may be used in other JVM languages that support annotations.</p>
 </div>
 <div class="sect2">
-<h3 id="_groovy">27.1. Groovy</h3>
+<h3 id="_groovy">28.1. Groovy</h3>
 <div class="paragraph">
 <p>In Groovy, use <code>[</code> and <code>]</code> to surround array values, instead of the <code>{</code> and <code>}</code> used in Java.</p>
 </div>
@@ -8092,7 +8551,7 @@ The script body is executed if the user input was valid and did not request usag
 </div>
 <div class="listingblock">
 <div class="content">
-<pre class="CodeRay highlight"><code data-lang="groovy"><span class="annotation">@Grab</span>(<span class="string"><span class="delimiter">'</span><span class="content">info.picocli:picocli-groovy:4.1.4</span><span class="delimiter">'</span></span>)
+<pre class="CodeRay highlight"><code data-lang="groovy"><span class="annotation">@Grab</span>(<span class="string"><span class="delimiter">'</span><span class="content">info.picocli:picocli-groovy:4.2.0</span><span class="delimiter">'</span></span>)
 <span class="annotation">@Command</span>(name = <span class="string"><span class="delimiter">&quot;</span><span class="content">myScript</span><span class="delimiter">&quot;</span></span>,
         mixinStandardHelpOptions = <span class="predefined-constant">true</span>, <span class="comment">// add --help and --version options</span>
         description = <span class="string"><span class="delimiter">&quot;</span><span class="content">@|bold Groovy script|@ @|underline picocli|@ example</span><span class="delimiter">&quot;</span></span>)
@@ -8120,7 +8579,7 @@ count.times {
 </td>
 <td class="content">
 When upgrading scripts to picocli 4.0, just changing the version number is not enough!
-Scripts should use <code>@Grab('info.picocli:picocli-groovy:4.1.4')</code>. The old artifact id <code>@Grab('info.picocli:picocli:4.1.4')</code> will not work,
+Scripts should use <code>@Grab('info.picocli:picocli-groovy:4.2.0')</code>. The old artifact id <code>@Grab('info.picocli:picocli:4.2.0')</code> will not work,
 because the <code>@picocli.groovy.PicocliScript</code> annotation class and supporting classes have been moved into a separate module, <code>picocli-groovy</code>.
 </td>
 </tr>
@@ -8141,7 +8600,7 @@ When using a Groovy version older than 2.4.7, use this workaround for the <a hre
 </div>
 <div class="listingblock">
 <div class="content">
-<pre class="CodeRay highlight"><code data-lang="groovy"><span class="annotation">@Grab</span>(<span class="string"><span class="delimiter">'</span><span class="content">info.picocli:picocli-groovy:4.1.4</span><span class="delimiter">'</span></span>)
+<pre class="CodeRay highlight"><code data-lang="groovy"><span class="annotation">@Grab</span>(<span class="string"><span class="delimiter">'</span><span class="content">info.picocli:picocli-groovy:4.2.0</span><span class="delimiter">'</span></span>)
 <span class="annotation">@GrabExclude</span>(<span class="string"><span class="delimiter">'</span><span class="content">org.codehaus.groovy:groovy-all</span><span class="delimiter">'</span></span>) <span class="comment">// work around GROOVY-7613</span>
 ...</code></pre>
 </div>
@@ -8151,7 +8610,7 @@ When using a Groovy version older than 2.4.7, use this workaround for the <a hre
 </div>
 </div>
 <div class="sect2">
-<h3 id="_kotlin">27.2. Kotlin</h3>
+<h3 id="_kotlin">28.2. Kotlin</h3>
 <div class="paragraph">
 <p>Kotlin 1.2 (released Nov 28, 2017) officially supports <a href="http://kotlinlang.org/docs/reference/whatsnew12.html#array-literals-in-annotations">array literals in annotations</a>, allowing a more compact notation:</p>
 </div>
@@ -8221,7 +8680,7 @@ fun main(args: Array&lt;String&gt;) = System.exit(CommandLine(MyApp()).execute(*
 </div>
 </div>
 <div class="sect2">
-<h3 id="_scala">27.3. Scala</h3>
+<h3 id="_scala">28.3. Scala</h3>
 <div class="paragraph">
 <p>Scala does not allow specifying array annotation attribute as a single value,
 so be aware that you will have to write <code>Array(&#8230;&#8203;)</code> for the <code>names</code>, <code>description</code> and <code>type</code> attributes.</p>
@@ -8245,17 +8704,20 @@ class MyApp extends Callable[Int] {
     }
 }
 object MyApp {
-    def main(args: Array[String]) {
+    def main(args: Array[String]): Unit = {
         System.exit(new CommandLine(new MyApp()).execute(args: _*))
     }
 }</code></pre>
 </div>
 </div>
+<div class="paragraph">
+<p>In order to get you started quickly, you may have a look at the <a href="https://github.com/remkop/picocli/tree/master/picocli-examples/src/main/scala/picocli/examples/scala">Scala examples</a> folder of the picocli code repository.</p>
+</div>
 </div>
 </div>
 </div>
 <div class="sect1">
-<h2 id="_api_javadoc">28. API Javadoc</h2>
+<h2 id="_api_javadoc">29. API Javadoc</h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>Picocli API Javadoc can be found <a href="apidocs/">here</a>.</p>
@@ -8266,7 +8728,7 @@ object MyApp {
 </div>
 </div>
 <div class="sect1">
-<h2 id="_github_project">29. GitHub Project</h2>
+<h2 id="_github_project">30. GitHub Project</h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>The <a href="https://github.com/remkop/picocli">GitHub project</a> has the source code, tests, build scripts, etc.</p>
@@ -8280,7 +8742,7 @@ object MyApp {
 </div>
 </div>
 <div class="sect1">
-<h2 id="_issue_tracker">30. Issue Tracker</h2>
+<h2 id="_issue_tracker">31. Issue Tracker</h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>The GitHub <a href="https://github.com/remkop/picocli/issues">Issue Tracker</a> can be used to report bugs or request features. There is also a <a href="#_mailing_list">Mailing List</a>, and for questions where the user community may know the answer, <a href="https://stackoverflow.com/questions/tagged/picocli">StackOverflow</a> is both a good resource and a great way to build an online knowledge base.</p>
@@ -8288,7 +8750,7 @@ object MyApp {
 </div>
 </div>
 <div class="sect1">
-<h2 id="_mailing_list">31. Mailing List</h2>
+<h2 id="_mailing_list">32. Mailing List</h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>Join the <a href="https://groups.google.com/d/forum/picocli">picocli Google group</a> if you are interested in discussing anything picocli-related and receiving announcements on new releases.</p>
@@ -8296,7 +8758,7 @@ object MyApp {
 </div>
 </div>
 <div class="sect1">
-<h2 id="_license">32. License</h2>
+<h2 id="_license">33. License</h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>Picocli is licensed under the <a href="https://github.com/remkop/picocli/blob/master/LICENSE">Apache License 2.0</a>.</p>
@@ -8304,7 +8766,7 @@ object MyApp {
 </div>
 </div>
 <div class="sect1">
-<h2 id="_releases">33. Releases</h2>
+<h2 id="_releases">34. Releases</h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>Previous versions are available from the GitHub project <a href="https://github.com/remkop/picocli/releases">Releases</a>.</p>
@@ -8312,50 +8774,50 @@ object MyApp {
 </div>
 </div>
 <div class="sect1">
-<h2 id="_download">34. Download</h2>
+<h2 id="_download">35. Download</h2>
 <div class="sectionbody">
 <div class="paragraph">
 <p>You can add picocli as an external dependency to your project, or you can include it as source.
 See the <a href="#_source">source code</a> below. Copy and paste it into a file called <code>CommandLine.java</code>, add it to your project, and enjoy!</p>
 </div>
 <div class="sect2">
-<h3 id="_gradle_3">34.1. Gradle</h3>
+<h3 id="_gradle_3">35.1. Gradle</h3>
 <div class="listingblock">
 <div class="content">
-<pre>compile 'info.picocli:picocli:4.1.4'</pre>
+<pre>compile 'info.picocli:picocli:4.2.0'</pre>
 </div>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_maven_3">34.2. Maven</h3>
+<h3 id="_maven_3">35.2. Maven</h3>
 <div class="listingblock">
 <div class="content">
 <pre>&lt;dependency&gt;
   &lt;groupId&gt;info.picocli&lt;/groupId&gt;
   &lt;artifactId&gt;picocli&lt;/artifactId&gt;
-  &lt;version&gt;4.1.4&lt;/version&gt;
+  &lt;version&gt;4.2.0&lt;/version&gt;
 &lt;/dependency&gt;</pre>
 </div>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_scala_sbt">34.3. Scala SBT</h3>
+<h3 id="_scala_sbt">35.3. Scala SBT</h3>
 <div class="listingblock">
 <div class="content">
-<pre>libraryDependencies += "info.picocli" % "picocli" % "4.1.4"</pre>
+<pre>libraryDependencies += "info.picocli" % "picocli" % "4.2.0"</pre>
 </div>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_ivy">34.4. Ivy</h3>
+<h3 id="_ivy">35.4. Ivy</h3>
 <div class="listingblock">
 <div class="content">
-<pre>&lt;dependency org="info.picocli" name="picocli" rev="4.1.4" /&gt;</pre>
+<pre>&lt;dependency org="info.picocli" name="picocli" rev="4.2.0" /&gt;</pre>
 </div>
 </div>
 </div>
 <div class="sect2">
-<h3 id="_source">34.5. Source</h3>
+<h3 id="_source">35.5. Source</h3>
 <div class="paragraph">
 <p>Picocli has only one source file: <a href="https://github.com/remkop/picocli/blob/master/src/main/java/picocli/CommandLine.java">CommandLine.java</a>.
 This facilitates including it in your project in source form to avoid having an external dependency on picocli.</p>
@@ -8366,8 +8828,8 @@ This facilitates including it in your project in source form to avoid having an
 </div>
 <div id="footer">
 <div id="footer-text">
-Version 4.1.4<br>
-Last updated 2019-12-26 10:01:39 +0900
+Version 4.2.0<br>
+Last updated 2020-02-12 07:02:37 +0900
 </div>
 </div>
 </body>
diff --git a/docs/man/gen-manpage.html b/docs/man/gen-manpage.html
index 63c5232e..401ddf97 100644
--- a/docs/man/gen-manpage.html
+++ b/docs/man/gen-manpage.html
@@ -443,8 +443,8 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <h2 id="_synopsis">Synopsis</h2>
 <div class="sectionbody">
 <div class="paragraph">
-<p><strong>gen-manpage</strong> [<strong>-fhVv</strong>] [<strong>-c</strong>=<em>&lt;factoryClass&gt;</em>] [<strong>-d</strong>=<em>&lt;outdir&gt;</em>] [<strong>-t</strong>=<em>&lt;template-dir&gt;</em>] [<em>@&lt;filename&gt;</em>&#8230;&#8203;]
-            <em>&lt;classes&gt;</em>&#8230;&#8203;</p>
+<p><strong>gen-manpage</strong> [<strong>-fhVv</strong>] [<strong>--[no-]exit</strong>] [<strong>-c</strong>=<em>&lt;factoryClass&gt;</em>] [<strong>-d</strong>=<em>&lt;outdir&gt;</em>] [<strong>-t</strong>=<em>&lt;template-dir&gt;</em>]
+            [<em>@&lt;filename&gt;</em>&#8230;&#8203;] <em>&lt;classes&gt;</em>&#8230;&#8203;</p>
 </div>
 </div>
 </div>
@@ -467,9 +467,12 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </dd>
 <dt class="hdlist1"><strong>-t</strong>, <strong>--template-dir</strong>=<em>&lt;template-dir&gt;</em></dt>
 <dd>
-<p>Optional directory to write customizable man page template files. If specified, additional AsciiDoc files are generated here containing <code>include</code> directives that import content from a generated manpage AsciiDoc file in the <code>--outdir</code> directory.</p>
+<p>Optional directory to write customizable man page template files. If specified, an additional "template" file is created here for each generated manpage AsciiDoc file.</p>
 <div class="paragraph">
-<p>These customizable templates are intended to be generated once, and afterwards be manually updated and maintained. The resulting man page will be a mixture of generated and manually edited text.</p>
+<p>Each template file contains <code>include</code> directives that import content from the corresponding generated manpage AsciiDoc file in the <code>--outdir</code> directory. Text can be added after each include to customize the resulting man page. The resulting man page will be a mixture of generated and manually edited text.</p>
+</div>
+<div class="paragraph">
+<p>These customizable templates are intended to be generated once, and afterwards be manually updated and maintained.</p>
 </div>
 </dd>
 <dt class="hdlist1"><strong>-v</strong>, <strong>--verbose</strong></dt>
@@ -487,6 +490,10 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <dd>
 <p>Optionally specify the fully qualified class name of the custom factory to use to instantiate the command class. If omitted, the default picocli factory is used.</p>
 </dd>
+<dt class="hdlist1"><strong>--[no-]exit</strong></dt>
+<dd>
+<p>Specify <code>--exit</code> if you want the application to call <code>System.exit</code> when finished. By default, <code>System.exit</code> is not called.</p>
+</dd>
 <dt class="hdlist1"><strong>-h</strong>, <strong>--help</strong></dt>
 <dd>
 <p>Show this help message and exit.</p>
@@ -517,6 +524,31 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </div>
 </div>
 <div class="sect1">
+<h2 id="_exit_codes_if_enabled_with_exit">Exit Codes (if enabled with <code>--exit</code>)</h2>
+<div class="sectionbody">
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><strong>0</strong></dt>
+<dd>
+<p>Successful program execution.</p>
+</dd>
+<dt class="hdlist1"><strong>1</strong></dt>
+<dd>
+<p>A runtime exception occurred while generating man pages.</p>
+</dd>
+<dt class="hdlist1"><strong>2</strong></dt>
+<dd>
+<p>Usage error: user input for the command was incorrect, e.g., the wrong number of arguments, a bad flag, a bad syntax in a parameter, etc.</p>
+</dd>
+<dt class="hdlist1"><strong>4</strong></dt>
+<dd>
+<p>A template file exists in the template directory. (Remove the <code>--template-dir</code> option or use <code>--force</code> to overwrite.)</p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div class="sect1">
 <h2 id="_converting_to_man_page_format">Converting to Man Page Format</h2>
 <div class="sectionbody">
 <div class="paragraph">
@@ -537,7 +569,7 @@ See <a href="http://man7.org/linux/man-pages/man7/roff.7.html" class="bare">http
 <div class="sectionbody">
 <div class="literalblock">
 <div class="content">
-<pre>java -cp "myapp.jar;picocli-4.2.0-SNAPSHOT.jar;picocli-codegen-4.2.0-SNAPSHOT.jar" picocli.codegen.docgen.manpage.ManPageGenerator my.pkg.MyClass</pre>
+<pre>java -cp "myapp.jar;picocli-4.2.0.jar;picocli-codegen-4.2.0.jar" picocli.codegen.docgen.manpage.ManPageGenerator my.pkg.MyClass</pre>
 </div>
 </div>
 </div>
@@ -545,8 +577,8 @@ See <a href="http://man7.org/linux/man-pages/man7/roff.7.html" class="bare">http
 </div>
 <div id="footer">
 <div id="footer-text">
-Version 4.2.0-SNAPSHOT<br>
-Last updated 2020-02-10 07:39:24 +0900
+Version 4.2.0<br>
+Last updated 2020-02-12 07:13:06 +0900
 </div>
 </div>
 </body>
diff --git a/docs/man/gen-proxy-config.html b/docs/man/gen-proxy-config.html
index b1e57d25..a045027d 100644
--- a/docs/man/gen-proxy-config.html
+++ b/docs/man/gen-proxy-config.html
@@ -443,7 +443,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <h2 id="_synopsis">Synopsis</h2>
 <div class="sectionbody">
 <div class="paragraph">
-<p><strong>gen-proxy-config</strong> [<strong>-hV</strong>] [<strong>-c</strong>=<em>&lt;factoryClass&gt;</em>] [<strong>-o</strong>=<em>&lt;outputFile&gt;</em>]
+<p><strong>gen-proxy-config</strong> [<strong>-hV</strong>] [<strong>--[no-]exit</strong>] [<strong>-c</strong>=<em>&lt;factoryClass&gt;</em>] [<strong>-o</strong>=<em>&lt;outputFile&gt;</em>]
                  [<strong>-i</strong>=<em>&lt;interfaces&gt;</em>]&#8230;&#8203; [<em>@&lt;filename&gt;</em>&#8230;&#8203;] [<em>&lt;classes&gt;</em>&#8230;&#8203;]</p>
 </div>
 </div>
@@ -463,22 +463,26 @@ See <a href="https://github.com/oracle/graal/blob/master/substratevm/DYNAMIC_PRO
 <div class="sectionbody">
 <div class="dlist">
 <dl>
-<dt class="hdlist1"><strong>-c</strong>, <strong>--factory</strong>=<em>&lt;factoryClass&gt;</em></dt>
-<dd>
-<p>Optionally specify the fully qualified class name of the custom factory to use to instantiate the command class. When omitted, the default picocli factory is used.</p>
-</dd>
-<dt class="hdlist1"><strong>-h</strong>, <strong>--help</strong></dt>
-<dd>
-<p>Show this help message and exit.</p>
-</dd>
 <dt class="hdlist1"><strong>-i</strong>, <strong>--interface</strong>=<em>&lt;interfaces&gt;</em></dt>
 <dd>
 <p>Other fully qualified interface names to generate dynamic proxy classes for in the native image.This option may be specified multiple times with different interface names. Specify multiple comma-separated interface names for dynamic proxies that implement multiple interfaces.</p>
 </dd>
+<dt class="hdlist1"><strong>-c</strong>, <strong>--factory</strong>=<em>&lt;factoryClass&gt;</em></dt>
+<dd>
+<p>Optionally specify the fully qualified class name of the custom factory to use to instantiate the command class. When omitted, the default picocli factory is used.</p>
+</dd>
 <dt class="hdlist1"><strong>-o</strong>, <strong>--output</strong>=<em>&lt;outputFile&gt;</em></dt>
 <dd>
 <p>Output file to write the configuration to. If not specified, the configuration is written to the standard output stream.</p>
 </dd>
+<dt class="hdlist1"><strong>--[no-]exit</strong></dt>
+<dd>
+<p>Specify <code>--exit</code> if you want the application to call <code>System.exit</code> when finished. By default, <code>System.exit</code> is not called.</p>
+</dd>
+<dt class="hdlist1"><strong>-h</strong>, <strong>--help</strong></dt>
+<dd>
+<p>Show this help message and exit.</p>
+</dd>
 <dt class="hdlist1"><strong>-V</strong>, <strong>--version</strong></dt>
 <dd>
 <p>Print version information and exit.</p>
@@ -505,11 +509,32 @@ See <a href="https://github.com/oracle/graal/blob/master/substratevm/DYNAMIC_PRO
 </div>
 </div>
 <div class="sect1">
+<h2 id="_exit_codes_if_enabled_with_exit">Exit Codes (if enabled with <code>--exit</code>)</h2>
+<div class="sectionbody">
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><strong>0</strong></dt>
+<dd>
+<p>Successful program execution.</p>
+</dd>
+<dt class="hdlist1"><strong>1</strong></dt>
+<dd>
+<p>A runtime exception occurred while generating man pages.</p>
+</dd>
+<dt class="hdlist1"><strong>2</strong></dt>
+<dd>
+<p>Usage error: user input for the command was incorrect, e.g., the wrong number of arguments, a bad flag, a bad syntax in a parameter, etc.</p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div class="sect1">
 <h2 id="_example">Example</h2>
 <div class="sectionbody">
 <div class="literalblock">
 <div class="content">
-<pre>java -cp "myapp.jar;picocli-4.2.0-SNAPSHOT.jar;picocli-codegen-4.2.0-SNAPSHOT.jar" picocli.codegen.aot.graalvm.DynamicProxyConfigGenerator my.pkg.MyClass</pre>
+<pre>java -cp "myapp.jar;picocli-4.2.0.jar;picocli-codegen-4.2.0.jar" picocli.codegen.aot.graalvm.DynamicProxyConfigGenerator my.pkg.MyClass</pre>
 </div>
 </div>
 </div>
@@ -517,8 +542,8 @@ See <a href="https://github.com/oracle/graal/blob/master/substratevm/DYNAMIC_PRO
 </div>
 <div id="footer">
 <div id="footer-text">
-Version 4.2.0-SNAPSHOT<br>
-Last updated 2020-02-10 07:39:24 +0900
+Version 4.2.0<br>
+Last updated 2020-02-12 07:13:06 +0900
 </div>
 </div>
 </body>
diff --git a/docs/man/gen-reflect-config.html b/docs/man/gen-reflect-config.html
index 2a5defa0..4cc1f136 100644
--- a/docs/man/gen-reflect-config.html
+++ b/docs/man/gen-reflect-config.html
@@ -443,8 +443,8 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <h2 id="_synopsis">Synopsis</h2>
 <div class="sectionbody">
 <div class="paragraph">
-<p><strong>gen-reflect-config</strong> [<strong>-hV</strong>] [<strong>-c</strong>=<em>&lt;factoryClass&gt;</em>] [<strong>-o</strong>=<em>&lt;outputFile&gt;</em>] [<em>@&lt;filename&gt;</em>&#8230;&#8203;]
-                   <em>&lt;classes&gt;</em>&#8230;&#8203;</p>
+<p><strong>gen-reflect-config</strong> [<strong>-hV</strong>] [<strong>--[no-]exit</strong>] [<strong>-c</strong>=<em>&lt;factoryClass&gt;</em>] [<strong>-o</strong>=<em>&lt;outputFile&gt;</em>]
+                   [<em>@&lt;filename&gt;</em>&#8230;&#8203;] <em>&lt;classes&gt;</em>&#8230;&#8203;</p>
 </div>
 </div>
 </div>
@@ -467,14 +467,18 @@ See <a href="https://github.com/oracle/graal/blob/master/substratevm/REFLECTION.
 <dd>
 <p>Optionally specify the fully qualified class name of the custom factory to use to instantiate the command class. When omitted, the default picocli factory is used.</p>
 </dd>
-<dt class="hdlist1"><strong>-h</strong>, <strong>--help</strong></dt>
-<dd>
-<p>Show this help message and exit.</p>
-</dd>
 <dt class="hdlist1"><strong>-o</strong>, <strong>--output</strong>=<em>&lt;outputFile&gt;</em></dt>
 <dd>
 <p>Output file to write the configuration to. If not specified, the configuration is written to the standard output stream.</p>
 </dd>
+<dt class="hdlist1"><strong>--[no-]exit</strong></dt>
+<dd>
+<p>Specify <code>--exit</code> if you want the application to call <code>System.exit</code> when finished. By default, <code>System.exit</code> is not called.</p>
+</dd>
+<dt class="hdlist1"><strong>-h</strong>, <strong>--help</strong></dt>
+<dd>
+<p>Show this help message and exit.</p>
+</dd>
 <dt class="hdlist1"><strong>-V</strong>, <strong>--version</strong></dt>
 <dd>
 <p>Print version information and exit.</p>
@@ -501,11 +505,32 @@ See <a href="https://github.com/oracle/graal/blob/master/substratevm/REFLECTION.
 </div>
 </div>
 <div class="sect1">
+<h2 id="_exit_codes_if_enabled_with_exit">Exit Codes (if enabled with <code>--exit</code>)</h2>
+<div class="sectionbody">
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><strong>0</strong></dt>
+<dd>
+<p>Successful program execution.</p>
+</dd>
+<dt class="hdlist1"><strong>1</strong></dt>
+<dd>
+<p>A runtime exception occurred while generating man pages.</p>
+</dd>
+<dt class="hdlist1"><strong>2</strong></dt>
+<dd>
+<p>Usage error: user input for the command was incorrect, e.g., the wrong number of arguments, a bad flag, a bad syntax in a parameter, etc.</p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div class="sect1">
 <h2 id="_example">Example</h2>
 <div class="sectionbody">
 <div class="literalblock">
 <div class="content">
-<pre>java -cp "myapp.jar;picocli-4.2.0-SNAPSHOT.jar;picocli-codegen-4.2.0-SNAPSHOT.jar" picocli.codegen.aot.graalvm.ReflectionConfigGenerator my.pkg.MyClass</pre>
+<pre>java -cp "myapp.jar;picocli-4.2.0.jar;picocli-codegen-4.2.0.jar" picocli.codegen.aot.graalvm.ReflectionConfigGenerator my.pkg.MyClass</pre>
 </div>
 </div>
 </div>
@@ -513,8 +538,8 @@ See <a href="https://github.com/oracle/graal/blob/master/substratevm/REFLECTION.
 </div>
 <div id="footer">
 <div id="footer-text">
-Version 4.2.0-SNAPSHOT<br>
-Last updated 2020-02-10 07:39:24 +0900
+Version 4.2.0<br>
+Last updated 2020-02-12 07:13:06 +0900
 </div>
 </div>
 </body>
diff --git a/docs/man/gen-resource-config.html b/docs/man/gen-resource-config.html
index 2ba55abc..086ca3a1 100644
--- a/docs/man/gen-resource-config.html
+++ b/docs/man/gen-resource-config.html
@@ -443,7 +443,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <h2 id="_synopsis">Synopsis</h2>
 <div class="sectionbody">
 <div class="paragraph">
-<p><strong>gen-resource-config</strong> [<strong>-hV</strong>] [<strong>-c</strong>=<em>&lt;factoryClass&gt;</em>] [<strong>-o</strong>=<em>&lt;outputFile&gt;</em>]
+<p><strong>gen-resource-config</strong> [<strong>-hV</strong>] [<strong>--[no-]exit</strong>] [<strong>-c</strong>=<em>&lt;factoryClass&gt;</em>] [<strong>-o</strong>=<em>&lt;outputFile&gt;</em>]
                     [<strong>-b</strong>=<em>&lt;bundle-base-name&gt;</em>]&#8230;&#8203; [<strong>-p</strong>=<em>&lt;resourceRegex&gt;</em>]&#8230;&#8203;
                     [<em>@&lt;filename&gt;</em>&#8230;&#8203;] [<em>&lt;classes&gt;</em>&#8230;&#8203;]</p>
 </div>
@@ -468,21 +468,25 @@ See <a href="https://github.com/oracle/graal/blob/master/substratevm/RESOURCES.m
 <dd>
 <p>Additional resource bundle(s) to be included in the image. This option may be specified multiple times with different regular expression patterns.</p>
 </dd>
+<dt class="hdlist1"><strong>-p</strong>, <strong>--pattern</strong>=<em>&lt;resourceRegex&gt;</em></dt>
+<dd>
+<p>Java regexp that matches resource(s) to be included in the image. This option may be specified multiple times with different regular expression patterns.</p>
+</dd>
 <dt class="hdlist1"><strong>-c</strong>, <strong>--factory</strong>=<em>&lt;factoryClass&gt;</em></dt>
 <dd>
 <p>Optionally specify the fully qualified class name of the custom factory to use to instantiate the command class. When omitted, the default picocli factory is used.</p>
 </dd>
-<dt class="hdlist1"><strong>-h</strong>, <strong>--help</strong></dt>
-<dd>
-<p>Show this help message and exit.</p>
-</dd>
 <dt class="hdlist1"><strong>-o</strong>, <strong>--output</strong>=<em>&lt;outputFile&gt;</em></dt>
 <dd>
 <p>Output file to write the configuration to. If not specified, the configuration is written to the standard output stream.</p>
 </dd>
-<dt class="hdlist1"><strong>-p</strong>, <strong>--pattern</strong>=<em>&lt;resourceRegex&gt;</em></dt>
+<dt class="hdlist1"><strong>--[no-]exit</strong></dt>
 <dd>
-<p>Java regexp that matches resource(s) to be included in the image. This option may be specified multiple times with different regular expression patterns.</p>
+<p>Specify <code>--exit</code> if you want the application to call <code>System.exit</code> when finished. By default, <code>System.exit</code> is not called.</p>
+</dd>
+<dt class="hdlist1"><strong>-h</strong>, <strong>--help</strong></dt>
+<dd>
+<p>Show this help message and exit.</p>
 </dd>
 <dt class="hdlist1"><strong>-V</strong>, <strong>--version</strong></dt>
 <dd>
@@ -510,11 +514,32 @@ See <a href="https://github.com/oracle/graal/blob/master/substratevm/RESOURCES.m
 </div>
 </div>
 <div class="sect1">
+<h2 id="_exit_codes_if_enabled_with_exit">Exit Codes (if enabled with <code>--exit</code>)</h2>
+<div class="sectionbody">
+<div class="dlist">
+<dl>
+<dt class="hdlist1"><strong>0</strong></dt>
+<dd>
+<p>Successful program execution.</p>
+</dd>
+<dt class="hdlist1"><strong>1</strong></dt>
+<dd>
+<p>A runtime exception occurred while generating man pages.</p>
+</dd>
+<dt class="hdlist1"><strong>2</strong></dt>
+<dd>
+<p>Usage error: user input for the command was incorrect, e.g., the wrong number of arguments, a bad flag, a bad syntax in a parameter, etc.</p>
+</dd>
+</dl>
+</div>
+</div>
+</div>
+<div class="sect1">
 <h2 id="_example">Example</h2>
 <div class="sectionbody">
 <div class="literalblock">
 <div class="content">
-<pre>java -cp "myapp.jar;picocli-4.2.0-SNAPSHOT.jar;picocli-codegen-4.2.0-SNAPSHOT.jar" picocli.codegen.aot.graalvm.ResourceConfigGenerator my.pkg.MyClass</pre>
+<pre>java -cp "myapp.jar;picocli-4.2.0.jar;picocli-codegen-4.2.0.jar" picocli.codegen.aot.graalvm.ResourceConfigGenerator my.pkg.MyClass</pre>
 </div>
 </div>
 </div>
@@ -522,8 +547,8 @@ See <a href="https://github.com/oracle/graal/blob/master/substratevm/RESOURCES.m
 </div>
 <div id="footer">
 <div id="footer-text">
-Version 4.2.0-SNAPSHOT<br>
-Last updated 2020-02-10 07:39:24 +0900
+Version 4.2.0<br>
+Last updated 2020-02-12 07:13:06 +0900
 </div>
 </div>
 </body>
diff --git a/docs/man/generate-completion.html b/docs/man/generate-completion.html
index 743f7a75..a467f5ee 100644
--- a/docs/man/generate-completion.html
+++ b/docs/man/generate-completion.html
@@ -481,8 +481,8 @@ Run the following command to give <code>$PARENTCOMMAND</code> TAB completion in
 </div>
 <div id="footer">
 <div id="footer-text">
-Version 4.2.0-SNAPSHOT<br>
-Last updated 2020-02-10 07:39:24 +0900
+Version 4.2.0<br>
+Last updated 2020-02-12 07:13:06 +0900
 </div>
 </div>
 </body>
diff --git a/docs/man/index.html b/docs/man/index.html
index e3d1dedf..c6097d36 100644
--- a/docs/man/index.html
+++ b/docs/man/index.html
@@ -434,7 +434,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <div id="header">
 <h1>Picocli Built-In Tools</h1>
 <div class="details">
-<span id="revnumber">version 4.2.0-SNAPSHOT</span>
+<span id="revnumber">version 4.2.0</span>
 </div>
 </div>
 <div id="content">
@@ -466,7 +466,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </div>
 <div id="footer">
 <div id="footer-text">
-Version 4.2.0-SNAPSHOT<br>
+Version 4.2.0<br>
 Last updated 2020-02-10 07:09:58 +0900
 </div>
 </div>
diff --git a/docs/man/picocli.AutoComplete.html b/docs/man/picocli.AutoComplete.html
index 692ebba5..b93c5f0c 100644
--- a/docs/man/picocli.AutoComplete.html
+++ b/docs/man/picocli.AutoComplete.html
@@ -512,7 +512,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 </div>
 </div>
 <div class="sect1">
-<h2 id="_exit_status">Exit status</h2>
+<h2 id="_exit_codes">Exit Codes:</h2>
 <div class="sectionbody">
 <div class="dlist">
 <dl>
@@ -568,7 +568,8 @@ call <code>System.exit(ERROR_CODE)</code> when an error occurs.</p>
 <div class="sectionbody">
 <div class="literalblock">
 <div class="content">
-<pre>java -cp "myapp.jar;picocli-4.2.0-SNAPSHOT.jar" picocli.AutoComplete my.pkg.MyClass</pre>
+<pre>java -cp "myapp.jar;picocli-4.2.0.jar" \
+            picocli.AutoComplete my.pkg.MyClass</pre>
 </div>
 </div>
 </div>
@@ -576,8 +577,8 @@ call <code>System.exit(ERROR_CODE)</code> when an error occurs.</p>
 </div>
 <div id="footer">
 <div id="footer-text">
-Version 4.2.0-SNAPSHOT<br>
-Last updated 2020-02-10 07:39:24 +0900
+Version 4.2.0<br>
+Last updated 2020-02-12 07:13:06 +0900
 </div>
 </div>
 </body>
diff --git a/docs/migrating-from-commons-cli.html b/docs/migrating-from-commons-cli.html
index 4a5d195d..ce2d3615 100644
--- a/docs/migrating-from-commons-cli.html
+++ b/docs/migrating-from-commons-cli.html
@@ -528,7 +528,7 @@ table.CodeRay td.code>pre{padding:0}
 <h1>Migrating from Commons CLI to picocli</h1>
 <div class="details">
 <span id="author" class="author">Remko Popma</span><br>
-<span id="revnumber">version 4.1.4,</span>
+<span id="revnumber">version 4.2.0,</span>
 <span id="revdate">2018-11-19</span>
 </div>
 </div>
@@ -968,7 +968,7 @@ This doesn&#8217;t just look good, it also <strong>reduces the cognitive load</s
 </div>
 <div id="footer">
 <div id="footer-text">
-Version 4.1.4<br>
+Version 4.2.0<br>
 Last updated 2018-12-02 18:37:39 +0900
 </div>
 </div>
diff --git a/docs/picocli-2.0-do-more-with-less.html b/docs/picocli-2.0-do-more-with-less.html
index 64950506..318fa072 100644
--- a/docs/picocli-2.0-do-more-with-less.html
+++ b/docs/picocli-2.0-do-more-with-less.html
@@ -526,7 +526,7 @@ table.CodeRay td.code>pre{padding:0}
 <div id="header">
 <h1>Picocli 2.0: Do More With Less</h1>
 <div class="details">
-<span id="revnumber">version 4.1.4</span>
+<span id="revnumber">version 4.2.0</span>
 </div>
 </div>
 <div id="content">
@@ -915,7 +915,7 @@ If you haven&#8217;t used picocli before, I hope the above made you interested t
 </div>
 <div id="footer">
 <div id="footer-text">
-Version 4.1.4<br>
+Version 4.2.0<br>
 Last updated 2018-12-02 18:44:56 +0900
 </div>
 </div>
diff --git a/docs/picocli-2.0-groovy-scripts-on-steroids.html b/docs/picocli-2.0-groovy-scripts-on-steroids.html
index e79f9ab8..f2bf3169 100644
--- a/docs/picocli-2.0-groovy-scripts-on-steroids.html
+++ b/docs/picocli-2.0-groovy-scripts-on-steroids.html
@@ -526,7 +526,7 @@ table.CodeRay td.code>pre{padding:0}
 <div id="header">
 <h1>Picocli 2.0: Groovy Scripts on Steroids</h1>
 <div class="details">
-<span id="revnumber">version 4.1.4</span>
+<span id="revnumber">version 4.2.0</span>
 </div>
 </div>
 <div id="content">
@@ -805,7 +805,7 @@ In the final version of our example script, most of the code is actually descrip
 </div>
 <div id="footer">
 <div id="footer-text">
-Version 4.1.4<br>
+Version 4.2.0<br>
 Last updated 2018-12-02 18:44:56 +0900
 </div>
 </div>
diff --git a/docs/picocli-on-graalvm.html b/docs/picocli-on-graalvm.html
index e443fb0b..51f95423 100644
--- a/docs/picocli-on-graalvm.html
+++ b/docs/picocli-on-graalvm.html
@@ -434,7 +434,7 @@ body.book #toc,body.book #preamble,body.book h1.sect0,body.book .sect1>h2{page-b
 <div id="header">
 <h1>Picocli on GraalVM: Blazingly Fast Command Line Apps</h1>
 <div class="details">
-<span id="revnumber">version 4.1.4</span>
+<span id="revnumber">version 4.2.0</span>
 </div>
 </div>
 <div id="content">
@@ -650,7 +650,7 @@ sys     0m0.004s</code></pre>
 </div>
 <div id="footer">
 <div id="footer-text">
-Version 4.1.4<br>
+Version 4.2.0<br>
 Last updated 2018-12-02 18:37:39 +0900
 </div>
 </div>
diff --git a/docs/picocli-programmatic-api.adoc b/docs/picocli-programmatic-api.adoc
index 74c0c209..0fbb7b37 100644
--- a/docs/picocli-programmatic-api.adoc
+++ b/docs/picocli-programmatic-api.adoc
@@ -1,7 +1,7 @@
 = Programmatic API
 //:author: Remko Popma
 //:email: rpopma@apache.org
-:revnumber: 4.2.0-SNAPSHOT
+:revnumber: 4.2.0
 :revdate: 2019-11-29
 :toc: left
 :numbered:
diff --git a/docs/picocli-programmatic-api.html b/docs/picocli-programmatic-api.html
index d9c96b52..b14fa92b 100644
--- a/docs/picocli-programmatic-api.html
+++ b/docs/picocli-programmatic-api.html
@@ -526,7 +526,7 @@ table.CodeRay td.code>pre{padding:0}
 <div id="header">
 <h1>Programmatic API</h1>
 <div class="details">
-<span id="revnumber">version 4.1.4,</span>
+<span id="revnumber">version 4.2.0,</span>
 <span id="revdate">2019-11-29</span>
 </div>
 <div id="toc" class="toc2">
@@ -1188,8 +1188,8 @@ ParseResult subResult = parseResult.subcommand();
 </div>
 <div id="footer">
 <div id="footer-text">
-Version 4.1.4<br>
-Last updated 2019-12-22 08:17:56 +0900
+Version 4.2.0<br>
+Last updated 2020-02-12 07:02:37 +0900
 </div>
 </div>
 </body>
diff --git a/docs/quick-guide.adoc b/docs/quick-guide.adoc
index bb16c316..ecd9ed77 100644
--- a/docs/quick-guide.adoc
+++ b/docs/quick-guide.adoc
@@ -1,7 +1,7 @@
 = Quick Guide
 //:author: Remko Popma
 //:email: rpopma@apache.org
-:revnumber: 4.2.0-SNAPSHOT
+:revnumber: 4.2.0
 :revdate: 2019-12-22
 :toc: left
 :numbered:
diff --git a/docs/quick-guide.html b/docs/quick-guide.html
index 48d15b1d..956393eb 100644
--- a/docs/quick-guide.html
+++ b/docs/quick-guide.html
@@ -526,7 +526,7 @@ table.CodeRay td.code>pre{padding:0}
 <div id="header">
 <h1>Quick Guide</h1>
 <div class="details">
-<span id="revnumber">version 4.1.4,</span>
+<span id="revnumber">version 4.2.0,</span>
 <span id="revdate">2019-12-22</span>
 </div>
 <div id="toc" class="toc2">
@@ -2100,8 +2100,8 @@ Your stars keep me going! :-)</p>
 </div>
 <div id="footer">
 <div id="footer-text">
-Version 4.1.4<br>
-Last updated 2019-12-22 08:17:56 +0900
+Version 4.2.0<br>
+Last updated 2020-02-12 07:02:37 +0900
 </div>
 </div>
 </body>
diff --git a/gradle.properties b/gradle.properties
index 91d5e196..bf77d3da 100644
--- a/gradle.properties
+++ b/gradle.properties
@@ -15,8 +15,8 @@ springBootVersion   = 2.2.2.RELEASE
 # projectPreviousReleaseVersion is non-SNAPSHOT, only published releases
 projectPreviousReleaseVersion = 4\\.1\\.4
 # projectPreviousVersionRegex may be a SNAPSHOT
-projectPreviousVersionRegex   = 4\\.1\\.4
-projectVersion                = 4.2.0-SNAPSHOT
+projectPreviousVersionRegex   = 4\\.2\\.0-SNAPSHOT
+projectVersion                = 4.2.0
 
 releaseDate              = 2019-12-22
 releaseDatePreviousRegex = 2019\\-12\\-22
diff --git a/picocli-codegen/README.adoc b/picocli-codegen/README.adoc
index 1940031b..4f2e2fa1 100644
--- a/picocli-codegen/README.adoc
+++ b/picocli-codegen/README.adoc
@@ -1,5 +1,5 @@
 = Picocli Code Generation
-:revnumber: 4.1.4
+:revnumber: 4.2.0
 :revdate: 2019-12-22
 :toc: left
 :numbered:
@@ -72,7 +72,7 @@ This requires `maven-compiler-plugin` plugin version 3.5 or higher.
       <path>
         <groupId>info.picocli</groupId>
         <artifactId>picocli-codegen</artifactId>
-        <version>4.1.4</version>
+        <version>4.2.0</version>
       </path>
     </annotationProcessorPaths>
   </configuration>
@@ -85,13 +85,13 @@ An alternative that works with older versions of the `maven-compiler-plugin` is
 <dependency>
   <groupId>info.picocli</groupId>
   <artifactId>picocli</artifactId>
-  <version>4.1.4</version>
+  <version>4.2.0</version>
 </dependency>
 
 <dependency>
   <groupId>info.picocli</groupId>
   <artifactId>picocli-codegen</artifactId>
-  <version>4.1.4</version>
+  <version>4.2.0</version>
   <scope>provided</scope>
 </dependency>
 ```
@@ -104,16 +104,16 @@ See <<Picocli Processor Options,processor options>> below.
 Use the `annotationProcessor` path in Gradle https://docs.gradle.org/4.6/release-notes.html#convenient-declaration-of-annotation-processor-dependencies[4.6 and higher]:
 ```groovy
 dependencies {
-    compile 'info.picocli:picocli:4.1.4'
-    annotationProcessor 'info.picocli:picocli-codegen:4.1.4'
+    compile 'info.picocli:picocli:4.2.0'
+    annotationProcessor 'info.picocli:picocli-codegen:4.2.0'
 }
 ```
 
 For Gradle versions prior to 4.6, use `compileOnly`, to prevent the `picocli-codegen` jar from being a transitive dependency included in the artifact the module produces.
 ```groovy
 dependencies {
-    compile 'info.picocli:picocli:4.1.4'
-    compileOnly 'info.picocli:picocli-codegen:4.1.4'
+    compile 'info.picocli:picocli:4.2.0'
+    compileOnly 'info.picocli:picocli-codegen:4.2.0'
 }
 ```
 
@@ -271,7 +271,7 @@ Note that the `picocli-codegen` module is only added as a dependency for the `ex
         <dependency>
           <groupId>info.picocli</groupId>
           <artifactId>picocli-codegen</artifactId>
-          <version>4.1.4</version>
+          <version>4.2.0</version>
           <type>jar</type>
         </dependency>
       </dependencies>
@@ -292,8 +292,8 @@ configurations {
     generateConfig
 }
 dependencies {
-    compile 'info.picocli:picocli:4.1.4'
-    generateConfig 'info.picocli:picocli-codegen:4.1.4'
+    compile 'info.picocli:picocli:4.2.0'
+    generateConfig 'info.picocli:picocli-codegen:4.2.0'
 }
 ----
 
@@ -380,7 +380,7 @@ Note that the `picocli-codegen` module is only added as a dependency for the `ex
         <dependency>
           <groupId>info.picocli</groupId>
           <artifactId>picocli-codegen</artifactId>
-          <version>4.1.4</version>
+          <version>4.2.0</version>
           <type>jar</type>
         </dependency>
       </dependencies>
@@ -400,8 +400,8 @@ configurations {
     generateConfig
 }
 dependencies {
-    compile 'info.picocli:picocli:4.1.4'
-    generateConfig 'info.picocli:picocli-codegen:4.1.4'
+    compile 'info.picocli:picocli:4.2.0'
+    generateConfig 'info.picocli:picocli-codegen:4.2.0'
 }
 ----
 
@@ -485,7 +485,7 @@ Note that the `picocli-codegen` module is only added as a dependency for the `ex
         <dependency>
           <groupId>info.picocli</groupId>
           <artifactId>picocli-codegen</artifactId>
-          <version>4.1.4</version>
+          <version>4.2.0</version>
           <type>jar</type>
         </dependency>
       </dependencies>
@@ -505,8 +505,8 @@ configurations {
     generateConfig
 }
 dependencies {
-    compile 'info.picocli:picocli:4.1.4'
-    generateConfig 'info.picocli:picocli-codegen:4.1.4'
+    compile 'info.picocli:picocli:4.2.0'
+    generateConfig 'info.picocli:picocli-codegen:4.2.0'
 }
 ----
 
diff --git a/picocli-codegen/src/main/java/picocli/codegen/aot/graalvm/DynamicProxyConfigGenerator.java b/picocli-codegen/src/main/java/picocli/codegen/aot/graalvm/DynamicProxyConfigGenerator.java
index f02c17e3..5830be71 100644
--- a/picocli-codegen/src/main/java/picocli/codegen/aot/graalvm/DynamicProxyConfigGenerator.java
+++ b/picocli-codegen/src/main/java/picocli/codegen/aot/graalvm/DynamicProxyConfigGenerator.java
@@ -58,7 +58,7 @@ public class DynamicProxyConfigGenerator {
             },
             footerHeading = "%nExample%n",
             footer = {
-                "  java -cp \"myapp.jar;picocli-4.2.0-SNAPSHOT.jar;picocli-codegen-4.2.0-SNAPSHOT.jar\" " +
+                "  java -cp \"myapp.jar;picocli-4.2.0.jar;picocli-codegen-4.2.0.jar\" " +
                         "picocli.codegen.aot.graalvm.DynamicProxyConfigGenerator my.pkg.MyClass"
             },
             mixinStandardHelpOptions = true, version = "picocli-codegen gen-proxy-config " + CommandLine.VERSION)
diff --git a/picocli-codegen/src/main/java/picocli/codegen/aot/graalvm/JniConfigGenerator.java b/picocli-codegen/src/main/java/picocli/codegen/aot/graalvm/JniConfigGenerator.java
index c30df242..8aa7d09e 100644
--- a/picocli-codegen/src/main/java/picocli/codegen/aot/graalvm/JniConfigGenerator.java
+++ b/picocli-codegen/src/main/java/picocli/codegen/aot/graalvm/JniConfigGenerator.java
@@ -31,7 +31,7 @@ public class JniConfigGenerator {
             },
             footerHeading = "%nExample%n",
             footer = {
-                    "  java -cp \"myapp.jar;picocli-4.2.0-SNAPSHOT.jar;picocli-codegen-4.2.0-SNAPSHOT.jar\" " +
+                    "  java -cp \"myapp.jar;picocli-4.2.0.jar;picocli-codegen-4.2.0.jar\" " +
                             "picocli.codegen.aot.graalvm.JniConfigGenerator my.pkg.MyClass"
             },
             mixinStandardHelpOptions = true, sortOptions = false,
diff --git a/picocli-codegen/src/main/java/picocli/codegen/aot/graalvm/ReflectionConfigGenerator.java b/picocli-codegen/src/main/java/picocli/codegen/aot/graalvm/ReflectionConfigGenerator.java
index 82e40df9..d67db93b 100644
--- a/picocli-codegen/src/main/java/picocli/codegen/aot/graalvm/ReflectionConfigGenerator.java
+++ b/picocli-codegen/src/main/java/picocli/codegen/aot/graalvm/ReflectionConfigGenerator.java
@@ -95,7 +95,7 @@ public class ReflectionConfigGenerator {
             },
             footerHeading = "%nExample%n",
             footer = {
-                    "  java -cp \"myapp.jar;picocli-4.2.0-SNAPSHOT.jar;picocli-codegen-4.2.0-SNAPSHOT.jar\" " +
+                    "  java -cp \"myapp.jar;picocli-4.2.0.jar;picocli-codegen-4.2.0.jar\" " +
                             "picocli.codegen.aot.graalvm.ReflectionConfigGenerator my.pkg.MyClass"
             },
             mixinStandardHelpOptions = true, sortOptions = false,
diff --git a/picocli-codegen/src/main/java/picocli/codegen/aot/graalvm/ResourceConfigGenerator.java b/picocli-codegen/src/main/java/picocli/codegen/aot/graalvm/ResourceConfigGenerator.java
index 6592ba44..a33a2410 100644
--- a/picocli-codegen/src/main/java/picocli/codegen/aot/graalvm/ResourceConfigGenerator.java
+++ b/picocli-codegen/src/main/java/picocli/codegen/aot/graalvm/ResourceConfigGenerator.java
@@ -54,7 +54,7 @@ public class ResourceConfigGenerator {
             },
             footerHeading = "%nExample%n",
             footer = {
-                    "  java -cp \"myapp.jar;picocli-4.2.0-SNAPSHOT.jar;picocli-codegen-4.2.0-SNAPSHOT.jar\" " +
+                    "  java -cp \"myapp.jar;picocli-4.2.0.jar;picocli-codegen-4.2.0.jar\" " +
                             "picocli.codegen.aot.graalvm.ResourceConfigGenerator my.pkg.MyClass"
             },
             mixinStandardHelpOptions = true, version = "picocli-codegen gen-resource-config " + CommandLine.VERSION)
diff --git a/picocli-codegen/src/main/java/picocli/codegen/docgen/manpage/ManPageGenerator.java b/picocli-codegen/src/main/java/picocli/codegen/docgen/manpage/ManPageGenerator.java
index ab1565d0..8378f947 100644
--- a/picocli-codegen/src/main/java/picocli/codegen/docgen/manpage/ManPageGenerator.java
+++ b/picocli-codegen/src/main/java/picocli/codegen/docgen/manpage/ManPageGenerator.java
@@ -123,7 +123,7 @@ public class ManPageGenerator {
                     "",
                     "Example",
                     "-------",
-                    "  java -cp \"myapp.jar;picocli-4.2.0-SNAPSHOT.jar;picocli-codegen-4.2.0-SNAPSHOT.jar\" " +
+                    "  java -cp \"myapp.jar;picocli-4.2.0.jar;picocli-codegen-4.2.0.jar\" " +
                             "picocli.codegen.docgen.manpage.ManPageGenerator my.pkg.MyClass"
             }
     )
diff --git a/picocli-examples/annotation-processing/example-gradle-project-kotlin-graal-nativeimage/build.gradle b/picocli-examples/annotation-processing/example-gradle-project-kotlin-graal-nativeimage/build.gradle
index 667d682a..c9048190 100644
--- a/picocli-examples/annotation-processing/example-gradle-project-kotlin-graal-nativeimage/build.gradle
+++ b/picocli-examples/annotation-processing/example-gradle-project-kotlin-graal-nativeimage/build.gradle
@@ -75,8 +75,8 @@ configurations {
     generateConfig
 }
 dependencies {
-    compile 'info.picocli:picocli:4.1.4'
-    generateConfig 'info.picocli:picocli-codegen:4.1.4'
+    compile 'info.picocli:picocli:4.2.0'
+    generateConfig 'info.picocli:picocli-codegen:4.2.0'
 }
 
 task(generateGraalReflectionConfig, dependsOn: 'classes', type: JavaExec) {
diff --git a/picocli-examples/annotation-processing/example-gradle-project/build.gradle b/picocli-examples/annotation-processing/example-gradle-project/build.gradle
index f003d3cc..d656a720 100644
--- a/picocli-examples/annotation-processing/example-gradle-project/build.gradle
+++ b/picocli-examples/annotation-processing/example-gradle-project/build.gradle
@@ -17,9 +17,9 @@ dependencies {
     testCompile group: 'junit', name: 'junit', version: '4.12'
 }
 dependencies {
-    compile 'info.picocli:picocli:4.1.4'
-    annotationProcessor 'info.picocli:picocli-codegen:4.1.4'
-    //compileOnly 'info.picocli:picocli-codegen:4.1.4' // in pre-Gradle 4.6
+    compile 'info.picocli:picocli:4.2.0'
+    annotationProcessor 'info.picocli:picocli-codegen:4.2.0'
+    //compileOnly 'info.picocli:picocli-codegen:4.2.0' // in pre-Gradle 4.6
 }
 compileJava {
     // minimum 1.6
diff --git a/picocli-examples/annotation-processing/example-maven-project-shading/pom.xml b/picocli-examples/annotation-processing/example-maven-project-shading/pom.xml
index f5a47446..e06572bd 100644
--- a/picocli-examples/annotation-processing/example-maven-project-shading/pom.xml
+++ b/picocli-examples/annotation-processing/example-maven-project-shading/pom.xml
@@ -22,7 +22,7 @@
             <path>
               <groupId>info.picocli</groupId>
               <artifactId>picocli-codegen</artifactId>
-              <version>4.1.4</version>
+              <version>4.2.0</version>
             </path>
           </annotationProcessorPaths>
           <compilerArgs>
@@ -80,7 +80,7 @@
     <dependency>
       <groupId>info.picocli</groupId>
       <artifactId>picocli</artifactId>
-      <version>4.1.4</version>
+      <version>4.2.0</version>
     </dependency>
   </dependencies>
 </project>
diff --git a/picocli-examples/annotation-processing/example-maven-project-simple/pom.xml b/picocli-examples/annotation-processing/example-maven-project-simple/pom.xml
index 4d563ca4..d67058f2 100644
--- a/picocli-examples/annotation-processing/example-maven-project-simple/pom.xml
+++ b/picocli-examples/annotation-processing/example-maven-project-simple/pom.xml
@@ -56,12 +56,12 @@
     <dependency>
       <groupId>info.picocli</groupId>
       <artifactId>picocli</artifactId>
-      <version>4.1.4</version>
+      <version>4.2.0</version>
     </dependency>
     <dependency>
       <groupId>info.picocli</groupId>
       <artifactId>picocli-codegen</artifactId>
-      <version>4.1.4</version>
+      <version>4.2.0</version>
       <scope>provided</scope>
     </dependency>
   </dependencies>
diff --git a/picocli-examples/src/main/kotlin/picocli/examples/kotlin/repeatablesubcommands/repeatable-subcmds-example.kts b/picocli-examples/src/main/kotlin/picocli/examples/kotlin/repeatablesubcommands/repeatable-subcmds-example.kts
index eec28a4c..1b7392bb 100644
--- a/picocli-examples/src/main/kotlin/picocli/examples/kotlin/repeatablesubcommands/repeatable-subcmds-example.kts
+++ b/picocli-examples/src/main/kotlin/picocli/examples/kotlin/repeatablesubcommands/repeatable-subcmds-example.kts
@@ -1,8 +1,8 @@
 #!/usr/bin/env kscript
 
-//DEPS info.picocli:picocli:4.2.0-SNAPSHOT
+//DEPS info.picocli:picocli:4.2.0
 
-//@file:DependsOn("info.picocli:picocli:4.2.0-SNAPSHOT")
+//@file:DependsOn("info.picocli:picocli:4.2.0")
 //import DependsOn // this (and the line above) requires holgerbrandl/kscript
 
 
diff --git a/picocli-groovy/README.md b/picocli-groovy/README.md
index 1aae70a2..5fdaee41 100644
--- a/picocli-groovy/README.md
+++ b/picocli-groovy/README.md
@@ -12,7 +12,7 @@ This module was introduced in picocli 4.0; in previous versions these classes we
 ## Example
 
 ```groovy
-@Grab('info.picocli:picocli-groovy:4.1.4')
+@Grab('info.picocli:picocli-groovy:4.2.0')
 @Command(description = "Print a checksum of each specified FILE.",
         mixinStandardHelpOptions = true,
         version = 'checksum v1.2.3',
diff --git a/picocli-spring-boot-starter/README.md b/picocli-spring-boot-starter/README.md
index b7cfbd81..4fba1ab6 100644
--- a/picocli-spring-boot-starter/README.md
+++ b/picocli-spring-boot-starter/README.md
@@ -20,14 +20,14 @@ Maven:
 <dependency>
   <groupId>info.picocli</groupId>
   <artifactId>picocli-spring-boot-starter</artifactId>
-  <version>4.1.4</version>
+  <version>4.2.0</version>
 </dependency>
 ```
 
 Gradle:
 ```
 dependencies {
-    compile "info.picocli:picocli-spring-boot-starter:4.1.4"
+    compile "info.picocli:picocli-spring-boot-starter:4.2.0"
 }
 ```
 
diff --git a/src/main/java/picocli/AutoComplete.java b/src/main/java/picocli/AutoComplete.java
index ef84d3f6..4896d95a 100644
--- a/src/main/java/picocli/AutoComplete.java
+++ b/src/main/java/picocli/AutoComplete.java
@@ -107,8 +107,8 @@ public class AutoComplete {
                     "",
                     "Example",
                     "-------",
-                    "  java -cp \"myapp.jar;picocli-4.2.0-SNAPSHOT.jar\" " +
-                            "picocli.AutoComplete my.pkg.MyClass"
+                    "  java -cp \"myapp.jar;picocli-4.2.0.jar\" \\",
+                    "              picocli.AutoComplete my.pkg.MyClass"
             },
             exitCodeListHeading = "%nExit Codes:%n",
             exitCodeList = {
diff --git a/src/main/java/picocli/CommandLine.java b/src/main/java/picocli/CommandLine.java
index f4eb6565..942a4195 100644
--- a/src/main/java/picocli/CommandLine.java
+++ b/src/main/java/picocli/CommandLine.java
@@ -145,7 +145,7 @@ import static picocli.CommandLine.Help.Column.Overflow.WRAP;
 public class CommandLine {
 
     /** This is picocli version {@value}. */
-    public static final String VERSION = "4.2.0-SNAPSHOT";
+    public static final String VERSION = "4.2.0";
 
     private final Tracer tracer = new Tracer();
     private final CommandSpec commandSpec;
diff --git a/src/test/java/picocli/AutoCompleteTest.java b/src/test/java/picocli/AutoCompleteTest.java
index a2f79e6e..7b59d7d9 100644
--- a/src/test/java/picocli/AutoCompleteTest.java
+++ b/src/test/java/picocli/AutoCompleteTest.java
@@ -282,8 +282,8 @@ public class AutoCompleteTest {
             "%n" +
             "Example%n" +
             "-------%n" +
-            "  java -cp \"myapp.jar;picocli-4.2.0-SNAPSHOT.jar\" picocli.AutoComplete my.pkg.%n" +
-            "MyClass%n");
+            "  java -cp \"myapp.jar;picocli-4.2.0.jar\" \\%n" +
+            "              picocli.AutoComplete my.pkg.MyClass%n");
 
     @Test
     public void testAutoCompleteAppHelp() {
diff --git a/src/test/java/picocli/CommandLineTest.java b/src/test/java/picocli/CommandLineTest.java
index 6c7d5c05..4afa50d9 100644
--- a/src/test/java/picocli/CommandLineTest.java
+++ b/src/test/java/picocli/CommandLineTest.java
@@ -134,7 +134,7 @@ public class CommandLineTest {
     }
     @Test
     public void testVersion() {
-        assertEquals("4.2.0-SNAPSHOT", CommandLine.VERSION);
+        assertEquals("4.2.0", CommandLine.VERSION);
     }
     @Test
     public void testArrayPositionalParametersAreReplacedNotAppendedTo() {