Release picocli version 2.0

remkop · Oct 21, 2017 · 81d44fa · 81d44fa
1 parent 2b9bc09
commit 81d44fa
Show file tree

Hide file tree

Showing 69 changed files with 8,527 additions and 1,036 deletions.
diff --git a/RELEASE-NOTES.md b/RELEASE-NOTES.md
@@ -1,8 +1,8 @@
 # picocli Release Notes
 
-# <a name="2.0"></a> (Unreleased) 2.0
+# <a name="2.0"></a> Picocli 2.0
 
-I'm pleased to announce picocli 2.0.
+The picocli community is pleased to announce picocli 2.0.
 
 First, picocli now provides tight integration for Groovy scripts.
 The new `@picocli.groovy.PicocliScript` annotation allows Groovy scripts to use the `@Command` annotation,

diff --git a/build.gradle b/build.gradle
@@ -1,11 +1,11 @@
 group 'info.picocli'
 description 'Annotation-based Java command line parser. Usage help with ANSI styles and colors. Autocomplete. Nested subcommands. Easily included as source to avoid adding a dependency.'
-version '2.0.0-SNAPSHOT'
+version '2.0.0'
 
 // for bumpVersion task
-def oldVersion = '1\\.1\\.0-SNAPSHOT'
+def oldVersion = '2\\.0\\.0-SNAPSHOT'
 def oldRevdate = '2017\\-08\\-29'
-def revDate    = '2017-08-29'
+def revDate    = '2017-10-21'
 
 buildscript {
     repositories {

diff --git 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_131) on Tue Aug 29 00:37:07 JST 2017 -->
-<title>All Classes (picocli 1.0.1 API)</title>
-<meta name="date" content="2017-08-29">
+<!-- Generated by javadoc (1.8.0_131) on Sat Oct 21 19:18:31 JST 2017 -->
+<title>All Classes (picocli 2.0.0 API)</title>
+<meta name="date" content="2017-10-21">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
@@ -15,7 +15,9 @@ <h1 class="bar">All&nbsp;Classes</h1>
 <li><a href="picocli/AutoComplete.html" title="class in picocli" target="classFrame">AutoComplete</a></li>
 <li><a href="picocli/CommandLine.html" title="class in picocli" target="classFrame">CommandLine</a></li>
 <li><a href="picocli/CommandLine.Command.html" title="annotation in picocli" target="classFrame">CommandLine.Command</a></li>
+<li><a href="picocli/CommandLine.DefaultExceptionHandler.html" title="class in picocli" target="classFrame">CommandLine.DefaultExceptionHandler</a></li>
 <li><a href="picocli/CommandLine.DuplicateOptionAnnotationsException.html" title="class in picocli" target="classFrame">CommandLine.DuplicateOptionAnnotationsException</a></li>
+<li><a href="picocli/CommandLine.ExecutionException.html" title="class in picocli" target="classFrame">CommandLine.ExecutionException</a></li>
 <li><a href="picocli/CommandLine.Help.html" title="class in picocli" target="classFrame">CommandLine.Help</a></li>
 <li><a href="picocli/CommandLine.Help.Ansi.html" title="enum in picocli" target="classFrame">CommandLine.Help.Ansi</a></li>
 <li><a href="picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli" target="classFrame"><span class="interfaceName">CommandLine.Help.Ansi.IStyle</span></a></li>
@@ -28,6 +30,10 @@ <h1 class="bar">All&nbsp;Classes</h1>
 <li><a href="picocli/CommandLine.Help.IParamLabelRenderer.html" title="interface in picocli" target="classFrame"><span class="interfaceName">CommandLine.Help.IParamLabelRenderer</span></a></li>
 <li><a href="picocli/CommandLine.Help.Layout.html" title="class in picocli" target="classFrame">CommandLine.Help.Layout</a></li>
 <li><a href="picocli/CommandLine.Help.TextTable.html" title="class in picocli" target="classFrame">CommandLine.Help.TextTable</a></li>
+<li><a href="picocli/CommandLine.Help.TextTable.Cell.html" title="class in picocli" target="classFrame">CommandLine.Help.TextTable.Cell</a></li>
+<li><a href="picocli/CommandLine.IExceptionHandler.html" title="interface in picocli" target="classFrame"><span class="interfaceName">CommandLine.IExceptionHandler</span></a></li>
+<li><a href="picocli/CommandLine.InitializationException.html" title="class in picocli" target="classFrame">CommandLine.InitializationException</a></li>
+<li><a href="picocli/CommandLine.IParseResultHandler.html" title="interface in picocli" target="classFrame"><span class="interfaceName">CommandLine.IParseResultHandler</span></a></li>
 <li><a href="picocli/CommandLine.ITypeConverter.html" title="interface in picocli" target="classFrame"><span class="interfaceName">CommandLine.ITypeConverter</span></a></li>
 <li><a href="picocli/CommandLine.MaxValuesforFieldExceededException.html" title="class in picocli" target="classFrame">CommandLine.MaxValuesforFieldExceededException</a></li>
 <li><a href="picocli/CommandLine.MissingParameterException.html" title="class in picocli" target="classFrame">CommandLine.MissingParameterException</a></li>
@@ -37,8 +43,16 @@ <h1 class="bar">All&nbsp;Classes</h1>
 <li><a href="picocli/CommandLine.ParameterException.html" title="class in picocli" target="classFrame">CommandLine.ParameterException</a></li>
 <li><a href="picocli/CommandLine.ParameterIndexGapException.html" title="class in picocli" target="classFrame">CommandLine.ParameterIndexGapException</a></li>
 <li><a href="picocli/CommandLine.Parameters.html" title="annotation in picocli" target="classFrame">CommandLine.Parameters</a></li>
+<li><a href="picocli/CommandLine.PicocliException.html" title="class in picocli" target="classFrame">CommandLine.PicocliException</a></li>
 <li><a href="picocli/CommandLine.Range.html" title="class in picocli" target="classFrame">CommandLine.Range</a></li>
+<li><a href="picocli/CommandLine.RunAll.html" title="class in picocli" target="classFrame">CommandLine.RunAll</a></li>
+<li><a href="picocli/CommandLine.RunFirst.html" title="class in picocli" target="classFrame">CommandLine.RunFirst</a></li>
+<li><a href="picocli/CommandLine.RunLast.html" title="class in picocli" target="classFrame">CommandLine.RunLast</a></li>
+<li><a href="picocli/CommandLine.TypeConversionException.html" title="class in picocli" target="classFrame">CommandLine.TypeConversionException</a></li>
 <li><a href="picocli/CommandLine.UnmatchedArgumentException.html" title="class in picocli" target="classFrame">CommandLine.UnmatchedArgumentException</a></li>
+<li><a href="picocli/groovy/PicocliBaseScript.html" title="class in picocli.groovy" target="classFrame">PicocliBaseScript</a></li>
+<li><a href="picocli/groovy/PicocliScript.html" title="annotation in picocli.groovy" target="classFrame">PicocliScript</a></li>
+<li><a href="picocli/groovy/PicocliScriptASTTransformation.html" title="class in picocli.groovy" target="classFrame">PicocliScriptASTTransformation</a></li>
 </ul>
 </div>
 </body>

diff --git 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_131) on Tue Aug 29 00:37:07 JST 2017 -->
-<title>All Classes (picocli 1.0.1 API)</title>
-<meta name="date" content="2017-08-29">
+<!-- Generated by javadoc (1.8.0_131) on Sat Oct 21 19:18:31 JST 2017 -->
+<title>All Classes (picocli 2.0.0 API)</title>
+<meta name="date" content="2017-10-21">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
@@ -15,7 +15,9 @@ <h1 class="bar">All&nbsp;Classes</h1>
 <li><a href="picocli/AutoComplete.html" title="class in picocli">AutoComplete</a></li>
 <li><a href="picocli/CommandLine.html" title="class in picocli">CommandLine</a></li>
 <li><a href="picocli/CommandLine.Command.html" title="annotation in picocli">CommandLine.Command</a></li>
+<li><a href="picocli/CommandLine.DefaultExceptionHandler.html" title="class in picocli">CommandLine.DefaultExceptionHandler</a></li>
 <li><a href="picocli/CommandLine.DuplicateOptionAnnotationsException.html" title="class in picocli">CommandLine.DuplicateOptionAnnotationsException</a></li>
+<li><a href="picocli/CommandLine.ExecutionException.html" title="class in picocli">CommandLine.ExecutionException</a></li>
 <li><a href="picocli/CommandLine.Help.html" title="class in picocli">CommandLine.Help</a></li>
 <li><a href="picocli/CommandLine.Help.Ansi.html" title="enum in picocli">CommandLine.Help.Ansi</a></li>
 <li><a href="picocli/CommandLine.Help.Ansi.IStyle.html" title="interface in picocli"><span class="interfaceName">CommandLine.Help.Ansi.IStyle</span></a></li>
@@ -28,6 +30,10 @@ <h1 class="bar">All&nbsp;Classes</h1>
 <li><a href="picocli/CommandLine.Help.IParamLabelRenderer.html" title="interface in picocli"><span class="interfaceName">CommandLine.Help.IParamLabelRenderer</span></a></li>
 <li><a href="picocli/CommandLine.Help.Layout.html" title="class in picocli">CommandLine.Help.Layout</a></li>
 <li><a href="picocli/CommandLine.Help.TextTable.html" title="class in picocli">CommandLine.Help.TextTable</a></li>
+<li><a href="picocli/CommandLine.Help.TextTable.Cell.html" title="class in picocli">CommandLine.Help.TextTable.Cell</a></li>
+<li><a href="picocli/CommandLine.IExceptionHandler.html" title="interface in picocli"><span class="interfaceName">CommandLine.IExceptionHandler</span></a></li>
+<li><a href="picocli/CommandLine.InitializationException.html" title="class in picocli">CommandLine.InitializationException</a></li>
+<li><a href="picocli/CommandLine.IParseResultHandler.html" title="interface in picocli"><span class="interfaceName">CommandLine.IParseResultHandler</span></a></li>
 <li><a href="picocli/CommandLine.ITypeConverter.html" title="interface in picocli"><span class="interfaceName">CommandLine.ITypeConverter</span></a></li>
 <li><a href="picocli/CommandLine.MaxValuesforFieldExceededException.html" title="class in picocli">CommandLine.MaxValuesforFieldExceededException</a></li>
 <li><a href="picocli/CommandLine.MissingParameterException.html" title="class in picocli">CommandLine.MissingParameterException</a></li>
@@ -37,8 +43,16 @@ <h1 class="bar">All&nbsp;Classes</h1>
 <li><a href="picocli/CommandLine.ParameterException.html" title="class in picocli">CommandLine.ParameterException</a></li>
 <li><a href="picocli/CommandLine.ParameterIndexGapException.html" title="class in picocli">CommandLine.ParameterIndexGapException</a></li>
 <li><a href="picocli/CommandLine.Parameters.html" title="annotation in picocli">CommandLine.Parameters</a></li>
+<li><a href="picocli/CommandLine.PicocliException.html" title="class in picocli">CommandLine.PicocliException</a></li>
 <li><a href="picocli/CommandLine.Range.html" title="class in picocli">CommandLine.Range</a></li>
+<li><a href="picocli/CommandLine.RunAll.html" title="class in picocli">CommandLine.RunAll</a></li>
+<li><a href="picocli/CommandLine.RunFirst.html" title="class in picocli">CommandLine.RunFirst</a></li>
+<li><a href="picocli/CommandLine.RunLast.html" title="class in picocli">CommandLine.RunLast</a></li>
+<li><a href="picocli/CommandLine.TypeConversionException.html" title="class in picocli">CommandLine.TypeConversionException</a></li>
 <li><a href="picocli/CommandLine.UnmatchedArgumentException.html" title="class in picocli">CommandLine.UnmatchedArgumentException</a></li>
+<li><a href="picocli/groovy/PicocliBaseScript.html" title="class in picocli.groovy">PicocliBaseScript</a></li>
+<li><a href="picocli/groovy/PicocliScript.html" title="annotation in picocli.groovy">PicocliScript</a></li>
+<li><a href="picocli/groovy/PicocliScriptASTTransformation.html" title="class in picocli.groovy">PicocliScriptASTTransformation</a></li>
 </ul>
 </div>
 </body>

diff --git a/docs/apidocs/constant-values.html b/docs/apidocs/constant-values.html
@@ -2,17 +2,17 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_131) on Tue Aug 29 00:37:07 JST 2017 -->
-<title>Constant Field Values (picocli 1.0.1 API)</title>
-<meta name="date" content="2017-08-29">
+<!-- Generated by javadoc (1.8.0_131) on Sat Oct 21 19:18:30 JST 2017 -->
+<title>Constant Field Values (picocli 2.0.0 API)</title>
+<meta name="date" content="2017-10-21">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
 <body>
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="Constant Field Values (picocli 1.0.1 API)";
+            parent.document.title="Constant Field Values (picocli 2.0.0 API)";
         }
     }
     catch(err) {
@@ -31,7 +31,8 @@
 <!--   -->
 </a>
 <ul class="navList" title="Navigation">
-<li><a href="picocli/package-summary.html">Package</a></li>
+<li><a href="overview-summary.html">Overview</a></li>
+<li>Package</li>
 <li>Class</li>
 <li><a href="overview-tree.html">Tree</a></li>
 <li><a href="deprecated-list.html">Deprecated</a></li>
@@ -93,7 +94,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>"1.0.1"</code></td>
+<td class="colLast"><code>"2.0.0"</code></td>
 </tr>
 </tbody>
 </table>
@@ -114,6 +115,13 @@ <h2 title="picocli">picocli.*</h2>
 <td><code><a href="picocli/CommandLine.Help.html#DEFAULT_COMMAND_NAME">DEFAULT_COMMAND_NAME</a></code></td>
 <td class="colLast"><code>"&lt;main class&gt;"</code></td>
 </tr>
+<tr class="rowColor">
+<td class="colFirst"><a name="picocli.CommandLine.Help.DEFAULT_SEPARATOR">
+<!--   -->
+</a><code>protected&nbsp;static&nbsp;final&nbsp;java.lang.String</code></td>
+<td><code><a href="picocli/CommandLine.Help.html#DEFAULT_SEPARATOR">DEFAULT_SEPARATOR</a></code></td>
+<td class="colLast"><code>"="</code></td>
+</tr>
 </tbody>
 </table>
 </li>
@@ -137,6 +145,31 @@ <h2 title="picocli">picocli.*</h2>
 </table>
 </li>
 </ul>
+<a name="picocli.groovy">
+<!--   -->
+</a>
+<h2 title="picocli.groovy">picocli.groovy.*</h2>
+<ul class="blockList">
+<li class="blockList">
+<table class="constantsSummary" border="0" cellpadding="3" cellspacing="0" summary="Constant Field Values table, listing constant fields, and values">
+<caption><span>picocli.groovy.<a href="picocli/groovy/PicocliBaseScript.html" title="class in picocli.groovy">PicocliBaseScript</a></span><span class="tabEnd">&nbsp;</span></caption>
+<tr>
+<th class="colFirst" scope="col">Modifier and Type</th>
+<th scope="col">Constant Field</th>
+<th class="colLast" scope="col">Value</th>
+</tr>
+<tbody>
+<tr class="altColor">
+<td class="colFirst"><a name="picocli.groovy.PicocliBaseScript.COMMAND_LINE">
+<!--   -->
+</a><code>public&nbsp;static&nbsp;final&nbsp;java.lang.String</code></td>
+<td><code><a href="picocli/groovy/PicocliBaseScript.html#COMMAND_LINE">COMMAND_LINE</a></code></td>
+<td class="colLast"><code>"commandLine"</code></td>
+</tr>
+</tbody>
+</table>
+</li>
+</ul>
 </div>
 <!-- ======= START OF BOTTOM NAVBAR ====== -->
 <div class="bottomNav"><a name="navbar.bottom">
@@ -147,7 +180,8 @@ <h2 title="picocli">picocli.*</h2>
 <!--   -->
 </a>
 <ul class="navList" title="Navigation">
-<li><a href="picocli/package-summary.html">Package</a></li>
+<li><a href="overview-summary.html">Overview</a></li>
+<li>Package</li>
 <li>Class</li>
 <li><a href="overview-tree.html">Tree</a></li>
 <li><a href="deprecated-list.html">Deprecated</a></li>

diff --git a/docs/apidocs/deprecated-list.html b/docs/apidocs/deprecated-list.html
@@ -2,17 +2,17 @@
 <!-- NewPage -->
 <html lang="en">
 <head>
-<!-- Generated by javadoc (1.8.0_131) on Tue Aug 29 00:37:07 JST 2017 -->
-<title>Deprecated List (picocli 1.0.1 API)</title>
-<meta name="date" content="2017-08-29">
+<!-- Generated by javadoc (1.8.0_131) on Sat Oct 21 19:18:31 JST 2017 -->
+<title>Deprecated List (picocli 2.0.0 API)</title>
+<meta name="date" content="2017-10-21">
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <script type="text/javascript" src="script.js"></script>
 </head>
 <body>
 <script type="text/javascript"><!--
     try {
         if (location.href.indexOf('is-external=true') == -1) {
-            parent.document.title="Deprecated List (picocli 1.0.1 API)";
+            parent.document.title="Deprecated List (picocli 2.0.0 API)";
         }
     }
     catch(err) {
@@ -31,7 +31,8 @@
 <!--   -->
 </a>
 <ul class="navList" title="Navigation">
-<li><a href="picocli/package-summary.html">Package</a></li>
+<li><a href="overview-summary.html">Overview</a></li>
+<li>Package</li>
 <li>Class</li>
 <li><a href="overview-tree.html">Tree</a></li>
 <li class="navBarCell1Rev">Deprecated</li>
@@ -72,6 +73,7 @@ <h1 title="Deprecated API" class="title">Deprecated API</h1>
 <h2 title="Contents">Contents</h2>
 <ul>
 <li><a href="#method">Deprecated Methods</a></li>
+<li><a href="#annotation.type.member">Deprecated Annotation Type Elements</a></li>
 </ul>
 </div>
 <div class="contentContainer"><a name="method">
@@ -86,11 +88,16 @@ <h2 title="Contents">Contents</h2>
 </tr>
 <tbody>
 <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="rowColor">
 <td class="colOne"><a href="picocli/CommandLine.Help.html#detailedSynopsis-java.util.Comparator-boolean-">picocli.CommandLine.Help.detailedSynopsis(Comparator&lt;Field&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">
+<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>
@@ -99,6 +106,26 @@ <h2 title="Contents">Contents</h2>
 </table>
 </li>
 </ul>
+<a name="annotation.type.member">
+<!--   -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<table class="deprecatedSummary" border="0" cellpadding="3" cellspacing="0" summary="Deprecated Annotation Type Elements table, listing deprecated annotation type elements, and an explanation">
+<caption><span>Deprecated Annotation Type Elements</span><span class="tabEnd">&nbsp;</span></caption>
+<tr>
+<th class="colOne" scope="col">Annotation Type Element and Description</th>
+</tr>
+<tbody>
+<tr class="altColor">
+<td class="colOne"><a href="picocli/CommandLine.Option.html#help--">picocli.CommandLine.Option.help</a>
+<div class="block"><span class="deprecationComment">Use <a href="picocli/CommandLine.Option.html#usageHelp--"><code>CommandLine.Option.usageHelp()</code></a> and <a href="picocli/CommandLine.Option.html#versionHelp--"><code>CommandLine.Option.versionHelp()</code></a> instead. See <a href="picocli/CommandLine.html#printHelpIfRequested-java.util.List-java.io.PrintStream-picocli.CommandLine.Help.Ansi-"><code>CommandLine.printHelpIfRequested(List, PrintStream, CommandLine.Help.Ansi)</code></a></span></div>
+</td>
+</tr>
+</tbody>
+</table>
+</li>
+</ul>
 </div>
 <!-- ======= START OF BOTTOM NAVBAR ====== -->
 <div class="bottomNav"><a name="navbar.bottom">
@@ -109,7 +136,8 @@ <h2 title="Contents">Contents</h2>
 <!--   -->
 </a>
 <ul class="navList" title="Navigation">
-<li><a href="picocli/package-summary.html">Package</a></li>
+<li><a href="overview-summary.html">Overview</a></li>
+<li>Package</li>
 <li>Class</li>
 <li><a href="overview-tree.html">Tree</a></li>
 <li class="navBarCell1Rev">Deprecated</li>