diff --git a/README.md b/README.md index 2f35d1594..e9f0b2576 100644 --- a/README.md +++ b/README.md @@ -79,7 +79,7 @@ The user manual has examples of integrating with [Guice](https://picocli.info/#_ ### Releases * [All Releases](https://github.com/remkop/picocli/releases) -* Latest: 4.7.5 [Release Notes](https://github.com/remkop/picocli/releases/tag/v4.7.5) +* Latest: 4.7.6 [Release Notes](https://github.com/remkop/picocli/releases/tag/v4.7.6) * 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) @@ -88,7 +88,7 @@ The user manual has examples of integrating with [Guice](https://picocli.info/#_ * [4.x User manual: https://picocli.info](https://picocli.info) * [4.x Quick Guide](https://picocli.info/quick-guide.html) * [4.x API Javadoc](https://picocli.info/apidocs/) -* [PREVIEW: Modular Javadoc for all artifacts (4.7.5-SNAPSHOT)](https://picocli.info/apidocs-all/) +* [PREVIEW: Modular Javadoc for all artifacts (4.7.6-SNAPSHOT)](https://picocli.info/apidocs-all/) * [Command line autocompletion](https://picocli.info/autocomplete.html) * [Programmatic API](https://picocli.info/picocli-programmatic-api.html) * [FAQ](https://github.com/remkop/picocli/wiki/FAQ) @@ -272,9 +272,9 @@ If you like picocli, help others discover picocli: #### Spread the joy! :tada: * Tweet about picocli! What do you like about it? How has it helped you? How is it different from the alternatives? * Mention that your project uses picocli in the documentation of your project. -* Show that your GitHub project uses picocli, with this badge in your README.md: [![picocli](https://img.shields.io/badge/picocli-4.7.5-green.svg)](https://github.com/remkop/picocli) +* Show that your GitHub project uses picocli, with this badge in your README.md: [![picocli](https://img.shields.io/badge/picocli-4.7.6-green.svg)](https://github.com/remkop/picocli) ``` -[![picocli](https://img.shields.io/badge/picocli-4.7.5-green.svg)](https://github.com/remkop/picocli) +[![picocli](https://img.shields.io/badge/picocli-4.7.6-green.svg)](https://github.com/remkop/picocli) ``` #### Preach it! :muscle: @@ -365,41 +365,41 @@ See the [source code](https://github.com/remkop/picocli/blob/main/src/main/java/ ### Gradle ``` -implementation 'info.picocli:picocli:4.7.5' +implementation 'info.picocli:picocli:4.7.6' ``` ### Maven ``` info.picocli picocli - 4.7.5 + 4.7.6 ``` ### Scala SBT ``` -libraryDependencies += "info.picocli" % "picocli" % "4.7.5" +libraryDependencies += "info.picocli" % "picocli" % "4.7.6" ``` ### Ivy ``` - + ``` ### Grape ```groovy @Grapes( - @Grab(group='info.picocli', module='picocli', version='4.7.5') + @Grab(group='info.picocli', module='picocli', version='4.7.6') ) ``` ### Leiningen ``` -[info.picocli/picocli "4.7.5"] +[info.picocli/picocli "4.7.6"] ``` ### Buildr ``` -'info.picocli:picocli:jar:4.7.5' +'info.picocli:picocli:jar:4.7.6' ``` ### JBang ``` -//DEPS info.picocli:picocli:4.7.5 +//DEPS info.picocli:picocli:4.7.6 ``` diff --git a/RELEASE-NOTES.md b/RELEASE-NOTES.md index 29c3bc02e..54ef1d1a2 100644 --- a/RELEASE-NOTES.md +++ b/RELEASE-NOTES.md @@ -1,6 +1,6 @@ # picocli Release Notes -# Picocli 4.7.6 (UNRELEASED) +# Picocli 4.7.6 The picocli community is pleased to announce picocli 4.7.6. This release includes bugfixes and enhancements. @@ -46,11 +46,13 @@ Artifacts in this release are signed by Remko Popma (6601 E5C0 8DCC BB96). * [#2108] DEP: Bump actions/checkout from 3.6.0 to 4.0.0 * [#2120] DEP: Bump actions/checkout from 4.0.0 to 4.1.0 * [#2225] DEP: Bump actions/checkout from 4.1.0 to 4.1.2 +* [#2272] DEP: Bump actions/checkout from 4.1.2 to 4.1.4 * [#2098] DEP: Bump actions/setup-java from 3.11.0 to 3.12.0 * [#2158] DEP: Bump actions/setup-java from 3.12.0 to 4.0.0 * [#2236] DEP: Bump actions/setup-java from 4.0.0 to 4.2.1. * [#2111] DEP: Bump actions/upload-artifact from 3.1.2 to 3.1.3 * [#2204] DEP: Bump actions/upload-artifact from 3.1.3 to 4.3.1 +* [#2273] DEP: Bump actions/upload-artifact from 4.3.1 to 4.3.3 * [#2227] DEP: Bump com.google.errorprone:error_prone_core from 2.23.0 to 2.26.1 * [#2271] DEP: Bump com.google.errorprone:error_prone_core from 2.26.1 to 2.27.1 * [#2237] DEP: Bump emibcn/badge-action from 2.0.2 to 2.0.3. diff --git a/dependencies.gradle b/dependencies.gradle index 86e4d59fe..864f87bd2 100644 --- a/dependencies.gradle +++ b/dependencies.gradle @@ -7,9 +7,9 @@ ext { // projectPreviousPublishedVersion is non-SNAPSHOT, only published releases projectPreviousPublishedVersion = "4\\.7\\.5" // for task bumpReadmeVersion // projectPreviousVersionRegex may be a SNAPSHOT - projectPreviousVersionRegex = "4\\.7\\.5" // for task bumpVersion - projectVersion = "4.7.6-SNAPSHOT" // for all build tasks - releaseDate = "2023-08-27" // for task bumpVersion + projectPreviousVersionRegex = "4\\.7\\.6-SNAPSHOT" // for task bumpVersion + projectVersion = "4.7.6" // for all build tasks + releaseDate = "2024-05-07" // for task bumpVersion releaseDatePreviousRegex = "2023\\-08\\-27" // for task bumpVersion // DEPENDENCIES diff --git a/docs/A-Whirlwind-Tour-of-Picocli.html b/docs/A-Whirlwind-Tour-of-Picocli.html index 4f8ea7977..7074966e4 100644 --- a/docs/A-Whirlwind-Tour-of-Picocli.html +++ b/docs/A-Whirlwind-Tour-of-Picocli.html @@ -1565,88 +1565,163 @@ }); + + +
@@ -3084,9 +3159,9 @@

Conclusion

- \ No newline at end of file + diff --git a/docs/announcing-picocli-1.0.html b/docs/announcing-picocli-1.0.html index 7f96c8a4b..c33694ed9 100644 --- a/docs/announcing-picocli-1.0.html +++ b/docs/announcing-picocli-1.0.html @@ -1,5 +1,5 @@ - + @@ -526,81 +526,81 @@ .CodeRay .change .change{color:#66f} .CodeRay .head .head{color:#f4f} - - - + + + @@ -608,7 +608,7 @@

Announcing picocli 1.0 - a mighty tiny command line interface

Remko Popma
-version 4.7.5, +version 4.7.6, 2017-09-10
@@ -732,7 +732,7 @@

Feedback Welcome

diff --git a/docs/apidocs-all/allclasses-frame.html b/docs/apidocs-all/allclasses-frame.html index b34a85aad..85a1809dd 100644 --- a/docs/apidocs-all/allclasses-frame.html +++ b/docs/apidocs-all/allclasses-frame.html @@ -3,7 +3,7 @@ -All Classes (picocli 4.7.5 API) +All Classes (picocli 4.7.6 API) diff --git a/docs/apidocs-all/allclasses-index.html b/docs/apidocs-all/allclasses-index.html index 099f408da..64852366b 100644 --- a/docs/apidocs-all/allclasses-index.html +++ b/docs/apidocs-all/allclasses-index.html @@ -3,7 +3,7 @@ -All Classes (picocli 4.7.5 API) +All Classes (picocli 4.7.6 API) @@ -21,7 +21,7 @@ diff --git a/docs/apidocs/allclasses-noframe.html b/docs/apidocs/allclasses-noframe.html index bc3cdd9f2..90c91eef0 100644 --- a/docs/apidocs/allclasses-noframe.html +++ b/docs/apidocs/allclasses-noframe.html @@ -3,7 +3,7 @@ -All Classes (picocli 4.7.5 API) +All Classes (picocli 4.7.6 API) diff --git a/docs/apidocs/constant-values.html b/docs/apidocs/constant-values.html index 5592c03de..e10902ef9 100644 --- a/docs/apidocs/constant-values.html +++ b/docs/apidocs/constant-values.html @@ -3,7 +3,7 @@ -Constant Field Values (picocli 4.7.5 API) +Constant Field Values (picocli 4.7.6 API) @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ diff --git a/docs/apidocs/picocli/package-summary.html b/docs/apidocs/picocli/package-summary.html index 94369f2e6..c6352948b 100644 --- a/docs/apidocs/picocli/package-summary.html +++ b/docs/apidocs/picocli/package-summary.html @@ -3,7 +3,7 @@ -picocli (picocli 4.7.5 API) +picocli (picocli 4.7.6 API) @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ @@ -11,7 +11,7 @@ - - - + + + diff --git a/docs/groovy-2.5-clibuilder-renewal-part1.html b/docs/groovy-2.5-clibuilder-renewal-part1.html index c4d151911..093a06ef6 100644 --- a/docs/groovy-2.5-clibuilder-renewal-part1.html +++ b/docs/groovy-2.5-clibuilder-renewal-part1.html @@ -1,5 +1,5 @@ - + @@ -525,88 +525,88 @@ .CodeRay .change .change{color:#66f} .CodeRay .head .head{color:#f4f} - - - + + + @@ -1051,7 +1051,7 @@

Wait, There’s More…​

diff --git a/docs/groovy-2.5-clibuilder-renewal-part2.html b/docs/groovy-2.5-clibuilder-renewal-part2.html index 51ef0012d..3cf0b7111 100644 --- a/docs/groovy-2.5-clibuilder-renewal-part2.html +++ b/docs/groovy-2.5-clibuilder-renewal-part2.html @@ -1,5 +1,5 @@ - + @@ -525,88 +525,88 @@ .CodeRay .change .change{color:#66f} .CodeRay .head .head{color:#f4f} - - - + + + @@ -1057,7 +1057,7 @@

Conclusion

diff --git a/docs/groovy-2.5-clibuilder-renewal.html b/docs/groovy-2.5-clibuilder-renewal.html index 1db853ad7..ee85d39b3 100644 --- a/docs/groovy-2.5-clibuilder-renewal.html +++ b/docs/groovy-2.5-clibuilder-renewal.html @@ -1,5 +1,5 @@ - + @@ -525,88 +525,88 @@ .CodeRay .change .change{color:#66f} .CodeRay .head .head{color:#f4f} - - - + + + @@ -1428,7 +1428,7 @@

Conclusion

diff --git a/docs/index.adoc b/docs/index.adoc index 92b61d48c..b6b8c44b4 100644 --- a/docs/index.adoc +++ b/docs/index.adoc @@ -1,8 +1,8 @@ = picocli - a mighty tiny command line interface //:author: Remko Popma //:email: rpopma@apache.org -:revnumber: 4.7.6-SNAPSHOT -:revdate: 2023-08-27 +:revnumber: 4.7.6 +:revdate: 2024-05-07 :toc: left :numbered: :toclevels: 2 @@ -120,7 +120,7 @@ class CheckSum implements Callable { [[CheckSum-App-Groovy]] [source,groovy,role="secondary"] ---- -@Grab('info.picocli:picocli-groovy:4.7.6-SNAPSHOT') +@Grab('info.picocli:picocli-groovy:4.7.6') import picocli.CommandLine import static picocli.CommandLine.* @@ -152,7 +152,7 @@ class Checksum implements Callable { [[CheckSum-App-Groovy-Script]] [source,groovy,role="secondary"] ---- -@Grab('info.picocli:picocli-groovy:4.7.6-SNAPSHOT') +@Grab('info.picocli:picocli-groovy:4.7.6') import static picocli.CommandLine.* import groovy.transform.Field import java.security.MessageDigest @@ -279,7 +279,7 @@ Below are examples of configuring Gradle or Maven to use picocli as an external [source,groovy,role="primary"] ---- dependencies { - implementation 'info.picocli:picocli:4.7.6-SNAPSHOT' + implementation 'info.picocli:picocli:4.7.6' } ---- .Maven @@ -288,7 +288,7 @@ dependencies { info.picocli picocli - 4.7.6-SNAPSHOT + 4.7.6 ---- @@ -325,8 +325,8 @@ https://immutables.github.io/apt.html[This page] shows the steps to configure Ec [source,groovy,role="primary"] ---- dependencies { - implementation 'info.picocli:picocli:4.7.6-SNAPSHOT' - annotationProcessor 'info.picocli:picocli-codegen:4.7.6-SNAPSHOT' + implementation 'info.picocli:picocli:4.7.6' + annotationProcessor 'info.picocli:picocli-codegen:4.7.6' } @@ -348,7 +348,7 @@ compileJava { info.picocli picocli-codegen - 4.7.6-SNAPSHOT + 4.7.6 @@ -368,7 +368,7 @@ then replace `annotationProcessor` with `kapt`: apply plugin: 'kotlin-kapt' // required dependencies { // ... - kapt 'info.picocli:picocli-codegen:4.7.6-SNAPSHOT' + kapt 'info.picocli:picocli-codegen:4.7.6' } ``` @@ -399,7 +399,7 @@ Now, assuming we created a jar named `checksum.jar` containing our compiled `Che [source,bash] ---- -java -cp "picocli-4.7.6-SNAPSHOT.jar:checksum.jar" CheckSum --algorithm SHA-1 hello.txt +java -cp "picocli-4.7.6.jar:checksum.jar" CheckSum --algorithm SHA-1 hello.txt ---- You may want to package your application in such a way that end users can invoke it with a short command like this: @@ -10384,7 +10384,7 @@ Eventually, we are ready to run our application: [source,bash] ---- -java -cp "picocli-4.7.6-SNAPSHOT.jar;myapp.jar" org.myorg.GreetingApp Sarah Lea +java -cp "picocli-4.7.6.jar;myapp.jar" org.myorg.GreetingApp Sarah Lea ---- With no command line parameter `--locale` given, the message texts are printed in the default language (here: English): @@ -10398,7 +10398,7 @@ In order to control the locale chosen for our output, we have to make use of the [source,bash] ---- -java -cp "picocli-4.7.6-SNAPSHOT.jar;myapp.jar" org.myorg.GreetingApp --locale=es Sarah Lea +java -cp "picocli-4.7.6.jar;myapp.jar" org.myorg.GreetingApp --locale=es Sarah Lea ---- Now our message texts are printed in Spanish: @@ -11717,21 +11717,21 @@ Since picocli dependencies are not available in the Spring Initializr, we have t info.picocli picocli-spring-boot-starter - 4.7.6-SNAPSHOT + 4.7.6 ---- .Gradle (Groovy) [source,groovy,role="secondary"] ---- dependencies { - implementation 'info.picocli:picocli-spring-boot-starter:4.7.6-SNAPSHOT' + implementation 'info.picocli:picocli-spring-boot-starter:4.7.6' } ---- .Gradle (Kotlin) [source,kotlin,role="secondary"] ---- dependencies { - implementation("info.picocli:picocli-spring-boot-starter:4.7.6-SNAPSHOT") + implementation("info.picocli:picocli-spring-boot-starter:4.7.6") } ---- @@ -13081,7 +13081,7 @@ As mentioned in <>, earlier in this manual, one way to [source,bash] ---- -java -cp "picocli-4.7.6-SNAPSHOT.jar;myapp.jar" org.myorg.MyMainClass --option=value arg0 arg1 +java -cp "picocli-4.7.6.jar;myapp.jar" org.myorg.MyMainClass --option=value arg0 arg1 ---- That is quite verbose. You may want to package your application in such a way that end users can invoke it by its command name like this: @@ -13100,7 +13100,7 @@ On unix-based operating systems, you can ask your users to define an alias. For [source,bash] ---- -alias mycommand='java -cp "/path/to/picocli-4.7.6-SNAPSHOT.jar:/path/to/myapp.jar" org.myorg.MainClass' +alias mycommand='java -cp "/path/to/picocli-4.7.6.jar:/path/to/myapp.jar" org.myorg.MainClass' ---- Append the above line to your `~/.bashrc` file to make this alias available in every new shell session. @@ -13149,7 +13149,7 @@ After installing GraalVM and installing the `native-image` generator utility (wi you can then create a native image by invoking the `native-image` command: ---- -path/to/native-image -cp picocli-4.7.6-SNAPSHOT.jar --static -jar myapp.jar +path/to/native-image -cp picocli-4.7.6.jar --static -jar myapp.jar ---- CAUTION: To create a native image, the compiler toolchain for your platform needs to be installed. See https://www.infoq.com/articles/java-native-cli-graalvm-picocli/[Build Great Native CLI Apps in Java with Graalvm and Picocli] for details. @@ -13294,7 +13294,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.7.6-SNAPSHOT') +@Grab('info.picocli:picocli-groovy:4.7.6') @GrabConfig(systemClassLoader=true) @Command(name = "myScript", mixinStandardHelpOptions = true, // add --help and --version options @@ -13335,7 +13335,7 @@ The table below compares these two base classes. WARNING: When upgrading scripts from picocli versions older than 4.0, just changing the version number is not enough! -Scripts should use `@Grab('info.picocli:picocli-groovy:4.7.6-SNAPSHOT')`. The old artifact id `@Grab('info.picocli:picocli:4.7.6-SNAPSHOT')` will not work, +Scripts should use `@Grab('info.picocli:picocli-groovy:4.7.6')`. The old artifact id `@Grab('info.picocli:picocli:4.7.6')` will not work, because the `@picocli.groovy.PicocliScript` annotation class and supporting classes have been moved into a separate module, `picocli-groovy`. ==== Closures in Annotations @@ -13393,7 +13393,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.7.6-SNAPSHOT') +@Grab('info.picocli:picocli-groovy:4.7.6') @GrabExclude('org.codehaus.groovy:groovy-all') // work around GROOVY-7613 ... ---- @@ -13536,13 +13536,13 @@ You can add picocli as an external dependency to your project, or you can includ .Gradle [source,groovy,role="primary"] ---- -implementation 'info.picocli:picocli:4.7.6-SNAPSHOT' +implementation 'info.picocli:picocli:4.7.6' ---- .Gradle (Kotlin) [source,kotlin,role="secondary"] ---- -implementation("info.picocli:picocli:4.7.6-SNAPSHOT") +implementation("info.picocli:picocli:4.7.6") ---- .Maven @@ -13551,50 +13551,50 @@ implementation("info.picocli:picocli:4.7.6-SNAPSHOT") info.picocli picocli - 4.7.6-SNAPSHOT + 4.7.6 ---- .Scala SBT [source,role="secondary"] ---- -libraryDependencies += "info.picocli" % "picocli" % "4.7.6-SNAPSHOT" +libraryDependencies += "info.picocli" % "picocli" % "4.7.6" ---- .Ivy [source,role="secondary"] ---- - + ---- .Grape [source,role="secondary"] ---- @Grapes( - @Grab(group='info.picocli', module='picocli', version='4.7.6-SNAPSHOT') + @Grab(group='info.picocli', module='picocli', version='4.7.6') ) ---- .Leiningen [source,role="secondary"] ---- -[info.picocli/picocli "4.7.6-SNAPSHOT"] +[info.picocli/picocli "4.7.6"] ---- .Buildr [source,role="secondary"] ---- -'info.picocli:picocli:jar:4.7.6-SNAPSHOT' +'info.picocli:picocli:jar:4.7.6' ---- .JBang [source,role="secondary"] ---- -//DEPS info.picocli:picocli:4.7.6-SNAPSHOT +//DEPS info.picocli:picocli:4.7.6 ---- === Source By using picocli in source form, you can avoid having an external dependency on picocli. -Picocli has only one source file: link:https://github.com/remkop/picocli/blob/v4.7.6-SNAPSHOT/src/main/java/picocli/CommandLine.java[CommandLine.java]. +Picocli has only one source file: link:https://github.com/remkop/picocli/blob/v4.7.6/src/main/java/picocli/CommandLine.java[CommandLine.java]. This facilitates including picocli in your project: simply copy and paste the code of this file into a file called `CommandLine.java`, add it to your project, and enjoy! diff --git a/docs/index.html b/docs/index.html index 52f8566cd..04d2cbf0b 100644 --- a/docs/index.html +++ b/docs/index.html @@ -1,5 +1,5 @@ - + @@ -1709,89 +1709,89 @@ }); }); - - - + + + @@ -2488,8 +2488,8 @@
Usi
Gradle
dependencies {
-    implementation 'info.picocli:picocli:4.7.5'
-    annotationProcessor 'info.picocli:picocli-codegen:4.7.5'
+    implementation 'info.picocli:picocli:4.7.6'
+    annotationProcessor 'info.picocli:picocli-codegen:4.7.6'
 }
 
 
@@ -2511,7 +2511,7 @@ 
Usi <path> <groupId>info.picocli</groupId> <artifactId>picocli-codegen</artifactId> - <version>4.7.5</version> + <version>4.7.6</version> </path> </annotationProcessorPaths> <compilerArgs> @@ -2536,7 +2536,7 @@
apply plugin: 'kotlin-kapt' // required dependencies { // ... - kapt 'info.picocli:picocli-codegen:4.7.5' + kapt 'info.picocli:picocli-codegen:4.7.6' }
@@ -2579,7 +2579,7 @@

-
java -cp "picocli-4.7.5.jar:checksum.jar" CheckSum --algorithm SHA-1 hello.txt
+
java -cp "picocli-4.7.6.jar:checksum.jar" CheckSum --algorithm SHA-1 hello.txt
@@ -3131,7 +3131,7 @@

3.5 Short option names are not given a negative alias by default. (This is customizable.)

-

If the negated form of the option is found, for example --no-verbose, the value is set to the provided default. Otherwise, with a regular call, for example --verbose, it is set to the opposite of the default.

+

If the negated form of the option is found, for example --no-verbose, the value is set to false. Otherwise, with a regular call, for example --verbose, the value is set to true.

@@ -3370,6 +3370,9 @@

3.8. Double dash (--)

+

Picocli offers built-in support for the End-of-Options delimiter (--), as defined in Guideline 10 of the POSIX Utility Syntax Guidelines.

+
+

When one of the command line arguments is just two dashes without any characters attached (--), picocli interprets all following arguments as positional parameters, even arguments that match an option name.

@@ -4714,7 +4717,7 @@

-

By default, this implementation tries to find a properties file named .${COMMAND-NAME}.properties in the user home directory, where ${COMMAND-NAME} is the name of the command. If a command has aliases in addition to its name, these aliases are also used to try to find the properties file. For example:

+

By default, this implementation tries to find a properties file named .${COMMAND-NAME}.properties in the user home directory or in the classpath, where ${COMMAND-NAME} is the name of the command. If a command has aliases in addition to its name, these aliases are also used to try to find the properties file. For example:

@@ -16614,7 +16618,7 @@

<dependency> <groupId>info.picocli</groupId> <artifactId>picocli-spring-boot-starter</artifactId> - <version>4.7.5</version> + <version>4.7.6</version> </dependency>

@@ -16622,7 +16626,7 @@

Gradle (Groovy)
dependencies {
-    implementation 'info.picocli:picocli-spring-boot-starter:4.7.5'
+    implementation 'info.picocli:picocli-spring-boot-starter:4.7.6'
 }
@@ -16630,7 +16634,7 @@

Gradle (Kotlin)
dependencies {
-    implementation("info.picocli:picocli-spring-boot-starter:4.7.5")
+    implementation("info.picocli:picocli-spring-boot-starter:4.7.6")
 }
@@ -18320,7 +18324,7 @@

-
java -cp "picocli-4.7.5.jar;myapp.jar" org.myorg.MyMainClass --option=value arg0 arg1
+
java -cp "picocli-4.7.6.jar;myapp.jar" org.myorg.MyMainClass --option=value arg0 arg1
-
alias mycommand='java -cp "/path/to/picocli-4.7.5.jar:/path/to/myapp.jar" org.myorg.MainClass'
+
alias mycommand='java -cp "/path/to/picocli-4.7.6.jar:/path/to/myapp.jar" org.myorg.MainClass'
@@ -18421,7 +18425,7 @@

-
path/to/native-image -cp picocli-4.7.5.jar --static -jar myapp.jar
+
path/to/native-image -cp picocli-4.7.6.jar --static -jar myapp.jar
-
@Grab('info.picocli:picocli-groovy:4.7.5')
+
@Grab('info.picocli:picocli-groovy:4.7.6')
 @GrabConfig(systemClassLoader=true)
 @Command(name = "myScript",
         mixinStandardHelpOptions = true, // add --help and --version options
@@ -18728,7 +18732,7 @@ 

30.1.2. G

@@ -18835,7 +18839,7 @@

-
@Grab('info.picocli:picocli-groovy:4.7.5')
+
@Grab('info.picocli:picocli-groovy:4.7.6')
 @GrabExclude('org.codehaus.groovy:groovy-all') // work around GROOVY-7613
 ...
@@ -19026,13 +19030,13 @@

37.1. Build too
Gradle
-
implementation 'info.picocli:picocli:4.7.5'
+
implementation 'info.picocli:picocli:4.7.6'
Gradle (Kotlin)
-
implementation("info.picocli:picocli:4.7.5")
+
implementation("info.picocli:picocli:4.7.6")
@@ -19041,46 +19045,46 @@

37.1. Build too
<dependency>
   <groupId>info.picocli</groupId>
   <artifactId>picocli</artifactId>
-  <version>4.7.5</version>
+  <version>4.7.6</version>
 </dependency>

Scala SBT
-
libraryDependencies += "info.picocli" % "picocli" % "4.7.5"
+
libraryDependencies += "info.picocli" % "picocli" % "4.7.6"
Ivy
-
<dependency org="info.picocli" name="picocli" rev="4.7.5" />
+
<dependency org="info.picocli" name="picocli" rev="4.7.6" />
Grape
@Grapes(
-    @Grab(group='info.picocli', module='picocli', version='4.7.5')
+    @Grab(group='info.picocli', module='picocli', version='4.7.6')
 )
Leiningen
-
[info.picocli/picocli "4.7.5"]
+
[info.picocli/picocli "4.7.6"]
Buildr
-
'info.picocli:picocli:jar:4.7.5'
+
'info.picocli:picocli:jar:4.7.6'
JBang
-
//DEPS info.picocli:picocli:4.7.5
+
//DEPS info.picocli:picocli:4.7.6
@@ -19088,7 +19092,7 @@

37.1. Build too

37.2. Source

By using picocli in source form, you can avoid having an external dependency on picocli. -Picocli has only one source file: CommandLine.java. +Picocli has only one source file: CommandLine.java. This facilitates including picocli in your project: simply copy and paste the code of this file into a file called CommandLine.java, add it to your project, and enjoy!

@@ -19097,8 +19101,8 @@

37.2. Source

diff --git a/docs/man/gen-manpage.html b/docs/man/gen-manpage.html index c51ea0db6..68ff85ff5 100644 --- a/docs/man/gen-manpage.html +++ b/docs/man/gen-manpage.html @@ -1,28 +1,26 @@ - + - + gen-manpage(1) - - - + + +
@@ -548,7 +548,7 @@

Picocli Built-In Tools

diff --git a/docs/man/picocli.AutoComplete.html b/docs/man/picocli.AutoComplete.html index 619ff7252..8acff3b5e 100644 --- a/docs/man/picocli.AutoComplete.html +++ b/docs/man/picocli.AutoComplete.html @@ -1,28 +1,26 @@ - + - + picocli.AutoComplete(1) - - - + + + @@ -608,7 +608,7 @@

Migrating from Commons CLI to picocli

Remko Popma
-version 4.7.5, +version 4.7.6, 2018-11-19
@@ -1048,7 +1048,7 @@

Conclusion

diff --git a/docs/picocli-2.0-do-more-with-less.html b/docs/picocli-2.0-do-more-with-less.html index 5b6e41a80..f62ba29aa 100644 --- a/docs/picocli-2.0-do-more-with-less.html +++ b/docs/picocli-2.0-do-more-with-less.html @@ -1,5 +1,5 @@ - + @@ -525,88 +525,88 @@ .CodeRay .change .change{color:#66f} .CodeRay .head .head{color:#f4f} - - - + + +
@@ -995,7 +995,7 @@

Conclusion

diff --git a/docs/picocli-2.0-groovy-scripts-on-steroids.html b/docs/picocli-2.0-groovy-scripts-on-steroids.html index 2fd872576..30e8fd4da 100644 --- a/docs/picocli-2.0-groovy-scripts-on-steroids.html +++ b/docs/picocli-2.0-groovy-scripts-on-steroids.html @@ -1,5 +1,5 @@ - + @@ -525,88 +525,88 @@ .CodeRay .change .change{color:#66f} .CodeRay .head .head{color:#f4f} - - - + + +
@@ -885,7 +885,7 @@

Conclusion

diff --git a/docs/picocli-on-graalvm.html b/docs/picocli-on-graalvm.html index 396002696..9b918f4c5 100644 --- a/docs/picocli-on-graalvm.html +++ b/docs/picocli-on-graalvm.html @@ -1,5 +1,5 @@ - + @@ -436,88 +436,88 @@ @media amzn-kf8{#header,#content,#footnotes,#footer{padding:0}} - - - + + +
@@ -733,7 +733,7 @@

Conclusion

diff --git a/docs/picocli-programmatic-api.adoc b/docs/picocli-programmatic-api.adoc index e12540e63..5ccbba7d0 100644 --- a/docs/picocli-programmatic-api.adoc +++ b/docs/picocli-programmatic-api.adoc @@ -1,8 +1,8 @@ = Programmatic API //:author: Remko Popma //:email: rpopma@apache.org -:revnumber: 4.7.6-SNAPSHOT -:revdate: 2023-08-27 +:revnumber: 4.7.6 +:revdate: 2024-05-07 :toc: left :numbered: :toclevels: 2 diff --git a/docs/picocli-programmatic-api.html b/docs/picocli-programmatic-api.html index f610d038a..9afe3c38c 100644 --- a/docs/picocli-programmatic-api.html +++ b/docs/picocli-programmatic-api.html @@ -1,5 +1,5 @@ - + @@ -436,89 +436,89 @@ @media amzn-kf8{#header,#content,#footnotes,#footer{padding:0}} - - - + + +

When upgrading scripts from picocli versions older than 4.0, just changing the version number is not enough! -Scripts should use @Grab('info.picocli:picocli-groovy:4.7.5'). The old artifact id @Grab('info.picocli:picocli:4.7.5') will not work, +Scripts should use @Grab('info.picocli:picocli-groovy:4.7.6'). The old artifact id @Grab('info.picocli:picocli:4.7.6') will not work, because the @picocli.groovy.PicocliScript annotation class and supporting classes have been moved into a separate module, picocli-groovy.