Release picocli version 3.1.0

README.md

@@ -39,7 +39,7 @@ interactively showing users what options and subcommands are available.
 ![Picocli Demo help message with ANSI colors](docs/images/picocli.Demo.png?raw=true)
 
 #### Releases
-* [Releases](https://github.com/remkop/picocli/releases) - latest: 3.0.2
+* [Releases](https://github.com/remkop/picocli/releases) - latest: 3.1.0
 * [Picocli 3.0.0 Release Notes](https://github.com/remkop/picocli/releases/tag/v3.0.0) - note there are some [potential breaking changes](https://github.com/remkop/picocli/releases/tag/v3.0.0#3.0.0-breaking-changes) from prior versions
 * [Picocli 2.0 Release Notes](https://github.com/remkop/picocli/releases/tag/v2.0.0) - note there are some [potential breaking changes](https://github.com/remkop/picocli/releases/tag/v2.0.0#2.0-breaking-changes) from prior versions
 
@@ -52,7 +52,7 @@ interactively showing users what options and subcommands are available.
 * [FAQ](https://github.com/remkop/picocli/wiki/FAQ)
 
 #### Articles
-* Picocli is now part of Groovy. From <img src="http://picocli.info/images/groovy-logo.png" height="50"> Groovy 2.5, picocli is the underlying parser for Groovy's [CliBuilder DSL](http://groovy-lang.org/dsls.html#_clibuilder). Details: [Part 1](http://picocli.info/groovy-2.5-clibuilder-renewal-part1.html) (also [on DZone](https://dzone.com/articles/groovy-25-clibuilder-renewal)), [Part 2](http://picocli.info/groovy-2.5-clibuilder-renewal-part2.html), [all in one](http://picocli.info/groovy-2.5-clibuilder-renewal.html) (also on [blogs.apache.org](https://blogs.apache.org/logging/entry/groovy-2-5-clibuilder-renewal)). 
+* Picocli is now part of Groovy. <img src="http://picocli.info/images/groovy-logo.png" height="50"> From Groovy 2.5, picocli is the underlying parser for Groovy's [CliBuilder DSL](http://groovy-lang.org/dsls.html#_clibuilder). Details: [Part 1](http://picocli.info/groovy-2.5-clibuilder-renewal-part1.html) (also [on DZone](https://dzone.com/articles/groovy-25-clibuilder-renewal)), [Part 2](http://picocli.info/groovy-2.5-clibuilder-renewal-part2.html), [all in one](http://picocli.info/groovy-2.5-clibuilder-renewal.html) (also on [blogs.apache.org](https://blogs.apache.org/logging/entry/groovy-2-5-clibuilder-renewal)). 
 * [Java Command-Line Interfaces (Part 30): Observations](http://marxsoftware.blogspot.jp/2017/11/java-cmd-line-observations.html) by Dustin Marx about picocli 2.0.1 (also on: [DZone](https://dzone.com/articles/java-command-line-interfaces-part-30-finale-observations), [Java Code Geeks](https://www.javacodegeeks.com/2017/11/java-command-line-interfaces-part-30-observations.html))
 * [Java Command-Line Interfaces (Part 10): Picocli](http://marxsoftware.blogspot.jp/2017/08/picocli.html) by Dustin Marx about picocli 0.9.7 (also on: [DZone](https://dzone.com/articles/java-command-line-interfaces-part-10-picocli), [Java Code Geeks](https://www.javacodegeeks.com/2017/08/java-command-line-interfaces-part-10-picocli.html)) 
 * [Picocli 2.0: Groovy Scripts on Steroids](http://picocli.info/picocli-2.0-groovy-scripts-on-steroids.html) (also on: [DZone](https://dzone.com/articles/picocli-v2-groovy-scripts-on-steroids), [Java Code Geeks](https://www.javacodegeeks.com/2018/01/picocli-2-0-groovy-scripts-steroids.html))
@@ -147,35 +147,35 @@ See the [source code](https://github.com/remkop/picocli/blob/master/src/main/jav
 
 ### Gradle
 ```
-compile 'info.picocli:picocli:3.0.2'
+compile 'info.picocli:picocli:3.1.0'
 ```
 ### Maven
 ```
 <dependency>
   <groupId>info.picocli</groupId>
   <artifactId>picocli</artifactId>
-  <version>3.0.2</version>
+  <version>3.1.0</version>
 </dependency>
 ```
 ### Scala SBT
 ```
-libraryDependencies += "info.picocli" % "picocli" % "3.0.2"
+libraryDependencies += "info.picocli" % "picocli" % "3.1.0"
 ```
 ### Ivy
 ```
-<dependency org="info.picocli" name="picocli" rev="3.0.2" />
+<dependency org="info.picocli" name="picocli" rev="3.1.0" />
 ```
 ### Grape
 ```groovy
 @Grapes(
-    @Grab(group='info.picocli', module='picocli', version='3.0.2')
+    @Grab(group='info.picocli', module='picocli', version='3.1.0')
 )
 ```
 ### Leiningen
 ```
-[info.picocli/picocli "3.0.2"]
+[info.picocli/picocli "3.1.0"]
 ```
 ### Buildr
 ```
-'info.picocli:picocli:jar:3.0.2'
+'info.picocli:picocli:jar:3.1.0'
 ```

RELEASE-NOTES.md

@@ -1,6 +1,6 @@
 # picocli Release Notes
 
-# <a name="3.1.0"></a> Picocli 3.1.0 (UNRELEASED)
+# <a name="3.1.0"></a> Picocli 3.1.0
 The picocli community is pleased to announce picocli 3.1.0.
 
 This release contains bugfixes and support for command aliases.

build.gradle

@@ -1,11 +1,11 @@
 group 'info.picocli'
 description 'Java command line parser with both an annotations API and a programmatic API. Usage help with ANSI styles and colors. Autocomplete. Nested subcommands. Easily included as source to avoid adding a dependency.'
-version '3.0.3-SNAPSHOT'
+version '3.1.0'
 
 // for bumpVersion task
-def oldVersion = '3\\.0\\.2'
+def oldVersion = '3\\.0\\.3-SNAPSHOT'
 def oldRevdate = '2018\\-05\\-23'
-def revDate    = '2018-05-23'
+def revDate    = '2018-06-11'
 
 // for bumpReadmeVersion task
 def previousReleaseVersion = '3.0.2'

docs/apidocs/allclasses-frame.html

@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (version 1.7.0_80) on Wed May 23 20:47:08 JST 2018 -->
-<title>All Classes (picocli 3.0.2 API)</title>
-<meta name="date" content="2018-05-23">
+<!-- Generated by javadoc (version 1.7.0_80) on Tue Jun 12 00:01:38 JST 2018 -->
+<title>All Classes (picocli 3.1.0 API)</title>
+<meta name="date" content="2018-06-12">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 </head>
 <body>

docs/apidocs/allclasses-noframe.html

@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (version 1.7.0_80) on Wed May 23 20:47:08 JST 2018 -->
-<title>All Classes (picocli 3.0.2 API)</title>
-<meta name="date" content="2018-05-23">
+<!-- Generated by javadoc (version 1.7.0_80) on Tue Jun 12 00:01:38 JST 2018 -->
+<title>All Classes (picocli 3.1.0 API)</title>
+<meta name="date" content="2018-06-12">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 </head>
 <body>

docs/apidocs/constant-values.html

@@ -2,15 +2,15 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (version 1.7.0_80) on Wed May 23 20:47:08 JST 2018 -->
-<title>Constant Field Values (picocli 3.0.2 API)</title>
-<meta name="date" content="2018-05-23">
+<!-- Generated by javadoc (version 1.7.0_80) on Tue Jun 12 00:01:38 JST 2018 -->
+<title>Constant Field Values (picocli 3.1.0 API)</title>
+<meta name="date" content="2018-06-12">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 </head>
 <body>
 <script type="text/javascript"><!--
     if (location.href.indexOf('is-external=true') == -1) {
-        parent.document.title="Constant Field Values (picocli 3.0.2 API)";
+        parent.document.title="Constant Field Values (picocli 3.1.0 API)";
     }
 //-->
 </script>
@@ -87,7 +87,7 @@ <h2 title="picocli">picocli.*</h2>
 <!--   -->
 </a><code>public&nbsp;static&nbsp;final&nbsp;java.lang.String</code></td>
 <td><code><a href="picocli/CommandLine.html#VERSION">VERSION</a></code></td>
-<td class="colLast"><code>"3.0.2"</code></td>
+<td class="colLast"><code>"3.1.0"</code></td>
 </tr>
 </tbody>
 </table>

docs/apidocs/deprecated-list.html

@@ -2,15 +2,15 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (version 1.7.0_80) on Wed May 23 20:47:08 JST 2018 -->
-<title>Deprecated List (picocli 3.0.2 API)</title>
-<meta name="date" content="2018-05-23">
+<!-- Generated by javadoc (version 1.7.0_80) on Tue Jun 12 00:01:38 JST 2018 -->
+<title>Deprecated List (picocli 3.1.0 API)</title>
+<meta name="date" content="2018-06-12">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 </head>
 <body>
 <script type="text/javascript"><!--
     if (location.href.indexOf('is-external=true') == -1) {
-        parent.document.title="Deprecated List (picocli 3.0.2 API)";
+        parent.document.title="Deprecated List (picocli 3.1.0 API)";
     }
 //-->
 </script>

docs/apidocs/help-doc.html

@@ -2,15 +2,15 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (version 1.7.0_80) on Wed May 23 20:47:08 JST 2018 -->
-<title>API Help (picocli 3.0.2 API)</title>
-<meta name="date" content="2018-05-23">
+<!-- Generated by javadoc (version 1.7.0_80) on Tue Jun 12 00:01:38 JST 2018 -->
+<title>API Help (picocli 3.1.0 API)</title>
+<meta name="date" content="2018-06-12">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 </head>
 <body>
 <script type="text/javascript"><!--
     if (location.href.indexOf('is-external=true') == -1) {
-        parent.document.title="API Help (picocli 3.0.2 API)";
+        parent.document.title="API Help (picocli 3.1.0 API)";
     }
 //-->
 </script>

docs/apidocs/index-all.html

@@ -2,15 +2,15 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (version 1.7.0_80) on Wed May 23 20:47:08 JST 2018 -->
-<title>Index (picocli 3.0.2 API)</title>
-<meta name="date" content="2018-05-23">
+<!-- Generated by javadoc (version 1.7.0_80) on Tue Jun 12 00:01:38 JST 2018 -->
+<title>Index (picocli 3.1.0 API)</title>
+<meta name="date" content="2018-06-12">
 <link rel="stylesheet" type="text/css" href="./stylesheet.css" title="Style">
 </head>
 <body>
 <script type="text/javascript"><!--
     if (location.href.indexOf('is-external=true') == -1) {
-        parent.document.title="Index (picocli 3.0.2 API)";
+        parent.document.title="Index (picocli 3.1.0 API)";
     }
 //-->
 </script>
@@ -153,6 +153,10 @@ <h2 class="title">A</h2>
 <dd>
 <div class="block">Registers a subcommand with the specified name.</div>
 </dd>
+<dt><span class="strong"><a href="./picocli/CommandLine.html#addSubcommand(java.lang.String,%20java.lang.Object,%20java.lang.String...)">addSubcommand(String, Object, String...)</a></span> - Method in class picocli.<a href="./picocli/CommandLine.html" title="class in picocli">CommandLine</a></dt>
+<dd>
+<div class="block">Registers a subcommand with the specified name and all specified aliases.</div>
+</dd>
 <dt><span class="strong"><a href="./picocli/CommandLine.Help.html#addSubcommand(java.lang.String,%20java.lang.Object)">addSubcommand(String, 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"><span class="strong">Deprecated.</span>&nbsp;</div>
@@ -177,6 +181,14 @@ <h2 class="title">A</h2>
 <dd>
 <div class="block">Adds the specified <code>UnmatchedArgsBinding</code> to the list of model objects to capture unmatched arguments for this command.</div>
 </dd>
+<dt><span class="strong"><a href="./picocli/CommandLine.Model.CommandSpec.html#aliases()">aliases()</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 alias command names of this subcommand.</div>
+</dd>
+<dt><span class="strong"><a href="./picocli/CommandLine.Model.CommandSpec.html#aliases(java.lang.String...)">aliases(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">Sets the alternative names by which this subcommand is recognized on the command line.</div>
+</dd>
 <dt><span class="strong"><a href="./picocli/CommandLine.AbstractHandler.html#andExit(int)">andExit(int)</a></span> - Method in class picocli.<a href="./picocli/CommandLine.AbstractHandler.html" title="class in picocli">CommandLine.AbstractHandler</a></dt>
 <dd>
 <div class="block">Indicates that the handler should call <code>System.exit(int)</code> after processing completes and sets the exit code to use as the termination status.</div>
@@ -2474,7 +2486,7 @@ <h2 class="title">V</h2>
 </dd>
 <dt><span class="strong"><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 "3.0.2".</div>
+<div class="block">This is picocli version "3.1.0".</div>
 </dd>
 <dt><span class="strong"><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>

docs/apidocs/index.html

@@ -2,8 +2,8 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc on Wed May 23 20:47:08 JST 2018 -->
-<title>picocli 3.0.2 API</title>
+<!-- Generated by javadoc on Tue Jun 12 00:01:38 JST 2018 -->
+<title>picocli 3.1.0 API</title>
 <script type="text/javascript">
     targetPage = "" + window.location.search;
     if (targetPage != "" && targetPage != "undefined")

docs/apidocs/overview-frame.html

@@ -2,9 +2,9 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (version 1.7.0_80) on Wed May 23 20:47:08 JST 2018 -->
-<title>Overview List (picocli 3.0.2 API)</title>
-<meta name="date" content="2018-05-23">
+<!-- Generated by javadoc (version 1.7.0_80) on Tue Jun 12 00:01:37 JST 2018 -->
+<title>Overview List (picocli 3.1.0 API)</title>
+<meta name="date" content="2018-06-12">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 </head>
 <body>

docs/apidocs/overview-summary.html

@@ -2,15 +2,15 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (version 1.7.0_80) on Wed May 23 20:47:08 JST 2018 -->
-<title>Overview (picocli 3.0.2 API)</title>
-<meta name="date" content="2018-05-23">
+<!-- Generated by javadoc (version 1.7.0_80) on Tue Jun 12 00:01:38 JST 2018 -->
+<title>Overview (picocli 3.1.0 API)</title>
+<meta name="date" content="2018-06-12">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 </head>
 <body>
 <script type="text/javascript"><!--
     if (location.href.indexOf('is-external=true') == -1) {
-        parent.document.title="Overview (picocli 3.0.2 API)";
+        parent.document.title="Overview (picocli 3.1.0 API)";
     }
 //-->
 </script>
@@ -62,7 +62,7 @@
 </a></div>
 <!-- ========= END OF TOP NAVBAR ========= -->
 <div class="header">
-<h1 class="title">picocli 3.0.2 API</h1>
+<h1 class="title">picocli 3.1.0 API</h1>
 </div>
 <div class="header">
 <div class="subTitle">

docs/apidocs/overview-tree.html

@@ -2,15 +2,15 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (version 1.7.0_80) on Wed May 23 20:47:08 JST 2018 -->
-<title>Class Hierarchy (picocli 3.0.2 API)</title>
-<meta name="date" content="2018-05-23">
+<!-- Generated by javadoc (version 1.7.0_80) on Tue Jun 12 00:01:38 JST 2018 -->
+<title>Class Hierarchy (picocli 3.1.0 API)</title>
+<meta name="date" content="2018-06-12">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 </head>
 <body>
 <script type="text/javascript"><!--
     if (location.href.indexOf('is-external=true') == -1) {
-        parent.document.title="Class Hierarchy (picocli 3.0.2 API)";
+        parent.document.title="Class Hierarchy (picocli 3.1.0 API)";
     }
 //-->
 </script>

docs/apidocs/picocli/AutoComplete.html

@@ -2,15 +2,15 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (version 1.7.0_80) on Wed May 23 20:47:06 JST 2018 -->
-<title>AutoComplete (picocli 3.0.2 API)</title>
-<meta name="date" content="2018-05-23">
+<!-- Generated by javadoc (version 1.7.0_80) on Tue Jun 12 00:01:36 JST 2018 -->
+<title>AutoComplete (picocli 3.1.0 API)</title>
+<meta name="date" content="2018-06-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 </head>
 <body>
 <script type="text/javascript"><!--
     if (location.href.indexOf('is-external=true') == -1) {
-        parent.document.title="AutoComplete (picocli 3.0.2 API)";
+        parent.document.title="AutoComplete (picocli 3.1.0 API)";
     }
 //-->
 </script>

docs/apidocs/picocli/CommandLine.AbstractHandler.html

@@ -2,15 +2,15 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (version 1.7.0_80) on Wed May 23 20:47:07 JST 2018 -->
-<title>CommandLine.AbstractHandler (picocli 3.0.2 API)</title>
-<meta name="date" content="2018-05-23">
+<!-- Generated by javadoc (version 1.7.0_80) on Tue Jun 12 00:01:36 JST 2018 -->
+<title>CommandLine.AbstractHandler (picocli 3.1.0 API)</title>
+<meta name="date" content="2018-06-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 </head>
 <body>
 <script type="text/javascript"><!--
     if (location.href.indexOf('is-external=true') == -1) {
-        parent.document.title="CommandLine.AbstractHandler (picocli 3.0.2 API)";
+        parent.document.title="CommandLine.AbstractHandler (picocli 3.1.0 API)";
     }
 //-->
 </script>

docs/apidocs/picocli/CommandLine.AbstractParseResultHandler.html

@@ -2,15 +2,15 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (version 1.7.0_80) on Wed May 23 20:47:07 JST 2018 -->
-<title>CommandLine.AbstractParseResultHandler (picocli 3.0.2 API)</title>
-<meta name="date" content="2018-05-23">
+<!-- Generated by javadoc (version 1.7.0_80) on Tue Jun 12 00:01:37 JST 2018 -->
+<title>CommandLine.AbstractParseResultHandler (picocli 3.1.0 API)</title>
+<meta name="date" content="2018-06-12">
 <link rel="stylesheet" type="text/css" href="../stylesheet.css" title="Style">
 </head>
 <body>
 <script type="text/javascript"><!--
     if (location.href.indexOf('is-external=true') == -1) {
-        parent.document.title="CommandLine.AbstractParseResultHandler (picocli 3.0.2 API)";
+        parent.document.title="CommandLine.AbstractParseResultHandler (picocli 3.1.0 API)";
     }
 //-->
 </script>