You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by br...@apache.org on 2015/05/03 17:04:37 UTC
svn commit: r8797 - in /dev/commons/cli: ./ binaries/ source/
Author: britter
Date: Sun May 3 15:04:37 2015
New Revision: 8797
Log:
Add Apache Commons CLI 1.3 RC1
Added:
dev/commons/cli/RELEASE-NOTES.txt (with props)
dev/commons/cli/binaries/commons-cli-1.3-bin.tar.gz (with props)
dev/commons/cli/binaries/commons-cli-1.3-bin.tar.gz.asc
dev/commons/cli/binaries/commons-cli-1.3-bin.tar.gz.md5
dev/commons/cli/binaries/commons-cli-1.3-bin.tar.gz.sha1
dev/commons/cli/binaries/commons-cli-1.3-bin.zip (with props)
dev/commons/cli/binaries/commons-cli-1.3-bin.zip.asc
dev/commons/cli/binaries/commons-cli-1.3-bin.zip.md5
dev/commons/cli/binaries/commons-cli-1.3-bin.zip.sha1
dev/commons/cli/source/commons-cli-1.3-src.tar.gz (with props)
dev/commons/cli/source/commons-cli-1.3-src.tar.gz.asc
dev/commons/cli/source/commons-cli-1.3-src.tar.gz.md5
dev/commons/cli/source/commons-cli-1.3-src.tar.gz.sha1
dev/commons/cli/source/commons-cli-1.3-src.zip (with props)
dev/commons/cli/source/commons-cli-1.3-src.zip.asc
dev/commons/cli/source/commons-cli-1.3-src.zip.md5
dev/commons/cli/source/commons-cli-1.3-src.zip.sha1
Added: dev/commons/cli/RELEASE-NOTES.txt
==============================================================================
--- dev/commons/cli/RELEASE-NOTES.txt (added)
+++ dev/commons/cli/RELEASE-NOTES.txt Sun May 3 15:04:37 2015
@@ -0,0 +1,223 @@
+ Apache Commons CLI
+ Version 1.3
+ Release Notes
+
+
+INTRODUCTION:
+
+This document contains the release notes for this version of the Commons CLI
+package. Commons CLI provides a simple API for working with the command line
+arguments and options.
+
+Commons CLI 1.3 is a bugfix and feature release and binary compatible with the
+previous versions, except for the OptionValidator class that is no longer public
+(change introduced in v1.2). Commons CLI 1.3 at least requires Java 5.0.
+
+More information can be found on the project site at
+http://commons.apache.org/cli.
+
+NOTES
+=====
+
+A new parser is available: DefaultParser. It combines the features of the
+GnuParser and the PosixParser. It also provides additional features like
+partial matching for the long options, and long options without
+separator (i.e like the JVM memory settings: -Xmx512m). This new parser
+deprecates the previous ones.
+
+DEPRECATIONS
+============
+
+o org.apache.commons.cli.BasicParser
+ replaced by org.apache.commons.cli.DefaultParser
+
+o org.apache.commons.cli.GnuParser
+ replaced by org.apache.commons.cli.DefaultParser
+
+o org.apache.commons.cli.OptionBuilder
+ replaced by org.apache.commons.cli.Option.builder()
+ org.apache.commons.cli.Option.builder(String)
+ org.apache.commons.cli.Option.Builder
+
+o org.apache.commons.cli.Parser
+ replaced by org.apache.commons.cli.DefaultParser
+
+o org.apache.commons.cli.PosixParser
+ replaced by org.apache.commons.cli.DefaultParser
+
+
+NEW FEATURES
+============
+
+o CLI-161: PosixParser doesn't stop the parsing on "--" tokens following an
+ option with an argument
+o CLI-167: Support options like Java memory settings (-Xmx512M)
+o CLI-181: Unified Parser
+o CLI-224: Added new fluent API to create Option instances via builder class
+ Option.Builder. This replaces the now deprecated OptionBuilder.
+ Thanks to Duncan Jones, Brian Blount.
+o CLI-160: PosixParser now supports partial long options (--ver instead of
+ --version).
+o CLI-169: HelpFormatter now supports setting the displayed separator of long
+ options. Thanks to J. Lewis Muir.
+o CLI-214: Added new method Options.addOption(String, String). Thanks to
+ Alexandru Mocanu.
+
+
+BUG FIXES
+=========
+
+o CLI-248: Dead links on doc page.
+o CLI-234: Fixed code example in javadoc of
+ "Option#Builder#valueSeparator(char)". Thanks to Greg Thomas.
+o CLI-241: Clarified behavior of "OptionValidator#validateOption(String)"
+ in case of null input. Thanks to Beluga Behr.
+o CLI-202: Default options will now work correctly with required options that
+ are missing.
+o CLI-203: Default options will now work correctly together with option groups.
+o CLI-205: HelpFormatter.setArgName(String) now correctly sets the argument
+ name.
+o CLI-204: Passing default values for not defined options to a parser will now
+ trigger a ParseException instead of a NullPointerException.
+o CLI-201: Default properties provided as input to the Parser.parse() methods
+ are now correctly processed.
+o CLI-215: CommandLine.getParsedOptionValue() now returns a String object if no
+ option type has been explicitly set. Thanks to Manuel Müller.
+o CLI-212: HelpFormatter now prints command-line options in the same order as
+ they have been added. Thanks to Per Cederberg.
+o CLI-186: Standard help text now shows mandatory arguments also for the first
+ option. Thanks to Kristoff Kiefer.
+o CLI-207: HelpFormatter does not strip anymore leading whitespace in the
+ footer text. Thanks to Uri Moszkowicz.
+o CLI-185: Strip quotes contained in argument values only if there is exactly
+ one at the beginning and one at the end. Thanks to
+ Einar M. R. Rosenvinge.
+o CLI-184: Negative numerical arguments take precedence over numerical options.
+o CLI-193: Fix possible StringIndexOutOfBoundsException in HelpFormatter.
+ Thanks to Travis McLeskey.
+o CLI-183: OptionGroups no longer throw an AlreadySelectedException when reused
+ for several parsings.
+o CLI-182: OptionGroup now selects properly an option with no short name.
+
+
+CHANGES
+=======
+
+o CLI-240: Small cleanup of Option class. Thanks to Beluga Behr.
+o CLI-230: Options.getRequiredOptions() now returns an unmodifiable list.
+o CLI-218: Clarify javadoc for CommandLine.getOptionValue() that the first
+ specified argument will be returned. Thanks to Sven.
+o CLI-227: Changed unit tests to junit 4 annotation style. Thanks to
+ Duncan Jones.
+o CLI-209: The javadoc of OptionBuilder now states that the class is not
+ thread-safe. Thanks to Thomas Herre.
+o CLI-200: Fixed typo in javadoc of class CommandLine. Thanks to
+ Gerard Weatherby.
+o CLI-223: Source code now uses generic types instead of raw types where
+ possible. Thanks to Gerard Weatherby.
+o CLI-220 Corrected javadoc for return type of
+ MissingOptionException.getMissingOptions(). Thanks to Joe Casadonte.
+o CLI-197: Improve description of parameter "stopAtNonOption" in method
+ CommandLine.parse(Options, String[], boolean). Thanks to
+ Anders Larsson.
+o CLI-231: Removed DoubleCheckedLocking test from checkstyle configuration.
+ Thanks to Duncan Jones.
+
+
+ Release Notes for version 1.2
+
+NEW FEATURES
+============
+
+o -- : The method getOptionProperties() in the CommandLine class was added
+ to retrieve easily the key/value pairs specified with options like
+ -Dkey1=value1 -Dkey2=value2.
+o CLI-157: GnuParser now supports long options with an '=' sign
+ (ie. --foo=bar and -foo=bar)
+o CLI-155: The ordering of options can be defined in help messages.
+
+
+BUG FIXES
+=========
+
+o CLI-137: The number of arguments defined for an option specifies the
+ arguments per occurence of the option and not for all occurences.
+o CLI-164: PosixParser no longer ignores unrecognized short options.
+o CLI-163: PosixParser no longer stops the bursting process of a token if
+ stopAtNonOption is enabled and a non option character is
+ encountered.
+o CLI-165: PosixParser no longer keeps processing the tokens after an
+ unrecognized long option when stopAtNonOption is enabled.
+o CLI-156: Required options are properly checked if an Options instance is used
+ twice to parse a command line.
+o CLI-151: The line wrapping in HelpFormatter now works properly.
+
+
+CHANGES
+=======
+
+o CLI-149: The message of MissingOptionException has been improved.
+o CLI-86: The exceptions have been enhanced with methods to retrieve easily
+ the related options.
+o CLI-141: Option.toString() now reports arguments properly.
+o CLI-142: The Parser class has been changed to be more easily extendable.
+o CLI-140: The following classes are now serializable: Option, OptionGroup,
+ CommandLine and Options.
+o -- : OptionValidator is no longer public, its methods were all private.
+
+
+ Release Notes for version 1.1
+
+NEW FEATURES
+============
+
+o CLI-78: Setting description of a Option.
+
+CHANGES
+=======
+
+o CLI-2: Wrong usage summary.
+o CLI-5: Dependecy on commons-lang-2.0 but commons-lang-1.0 is obtained.
+o CLI-8: Line separator as first char for helpformatter (footer) throws
+ exception.
+o CLI-13: CommandLine.getOptionValue() behaves contrary to docs.
+o CLI-21: clone method in Option should use super.clone().
+o CLI-23: Passing properties in Parser does not work for options with a single
+ argument.
+o CLI-26: Only long options without short option seems to be noticed.
+o CLI-28: Infinite Loop in Command-Line processing.
+o CLI-29: Options should not be able to be added more than once.
+o CLI-35: HelpFormatter doesn't sort options properly.
+o CLI-38: HelpFormatter doesn't function correctly for options with only
+ LongOpt.
+o CLI-44: Document enhancement.
+o CLI-45: Documentation errors.
+o CLI-51: Parameter value "-something" misinterpreted as a parameter.
+o CLI-56: clone() method doesn't fully clone contents.
+o CLI-59: No Javadoc for HelpFormatter!.
+o CLI-65: Parser breaks up command line parms into single characters.
+o CLI-67: Missing arguments in HelpFormatter.renderOptions(..).
+o CLI-69: Error parsing option arguments.
+o CLI-71: A weakness of parser.
+o CLI-129: CLI_1_BRANCH build.xml doesn't work.
+o CLI-130: Remove the Commons Lang dependency.
+o CLI-131: Options class returns options in random order.
+o CLI-132: MissingOptionException should contain a useful error message.
+o CLI-133: NullPointerException in Util.stripLeadingHyphens when passed a null
+ argument.
+o CLI-134: 1.1 is not backwards compatible because it adds methods to the
+ CommandLineParser interface.
+o CLI-135: Backwards compatibility between 1.1 and 1.0 broken due to
+ Option.addValue removal.
+
+
+Historical list of changes: http://commons.apache.org/cli/changes-report.html
+
+For complete information on Commons CLI, including instructions on how to
+submit bug reports, patches, or suggestions for improvement, see the
+Apache Commons CLI website:
+
+http://commons.apache.org/cli/
+
+Have fun!
+-Apache Commons CLI team
Propchange: dev/commons/cli/RELEASE-NOTES.txt
------------------------------------------------------------------------------
svn:eol-style = native
Added: dev/commons/cli/binaries/commons-cli-1.3-bin.tar.gz
==============================================================================
Binary file - no diff available.
Propchange: dev/commons/cli/binaries/commons-cli-1.3-bin.tar.gz
------------------------------------------------------------------------------
svn:mime-type = application/x-gzip
Added: dev/commons/cli/binaries/commons-cli-1.3-bin.tar.gz.asc
==============================================================================
--- dev/commons/cli/binaries/commons-cli-1.3-bin.tar.gz.asc (added)
+++ dev/commons/cli/binaries/commons-cli-1.3-bin.tar.gz.asc Sun May 3 15:04:37 2015
@@ -0,0 +1,17 @@
+-----BEGIN PGP SIGNATURE-----
+Version: GnuPG v2
+
+iQIcBAABCgAGBQJVRjaMAAoJEJ2q3ByfzILQMt8QALzzXvM66kPSrnOSZG5UIoxN
+cBvnaTqAqYeN83vve/eDONlObZLLhpKwdb5MqlACo4aD3u1dJbBYxv0iFG4ZAX31
+L6W27Q4++8SIPEukN+VYvbyYx9CArH5XPUEKPFvoyKNGR9Fwo2ncM0KjvWM1LqMS
+BR0bSHxLtbEKLb/Ljq0e0vuLzDUn7yW+y73iyAAUU/jaTlBxobA8P2Nm/fhihap/
+iGB/Xviec5j0vMvmRUwkiihjW0iZAT32sKE3b+XLSAn7+38XKnOnkZFtPogGz/QG
+eZR5y/2DczZUapDiWENlrY67/W1nEJ8SgnaGJwCDkYKDlkjUazpL7+rhj6BVUunF
+oTBTc8NIRMe5iO0YEqI6rAl4VWEXelX8jNmbxa4Ovr/bWxCQkicDkfyFGrI9OfiK
+1Z6ua4BIWjRgDj0clrBsSI0+w+X2jdF9OiD/Eup/GFB0VRJHIV40v+qxSZUOjUBE
+vvf/sI59pw9eLUsLisslxp5Q4gYHduD5ixzKrojZNdkMQNdLybQkFOcQ5JPR7oyt
+XV8F5BIvX/NdANQRCOc1xb+mwcYlTCGfiyeUXtMYZhaMf3vtmquQ1T8N9rBxf5RF
+13s0gh1Mkud3kKahgosj2OabpdU7K/iktPcOrtFjn5UyqPZSc0sxIxCG+u48NVCs
+MOT3RG6jqhYKSunEsvAR
+=dwJL
+-----END PGP SIGNATURE-----
Added: dev/commons/cli/binaries/commons-cli-1.3-bin.tar.gz.md5
==============================================================================
--- dev/commons/cli/binaries/commons-cli-1.3-bin.tar.gz.md5 (added)
+++ dev/commons/cli/binaries/commons-cli-1.3-bin.tar.gz.md5 Sun May 3 15:04:37 2015
@@ -0,0 +1 @@
+a0e59f31856dc344a94ea2fe0ac6ceda
\ No newline at end of file
Added: dev/commons/cli/binaries/commons-cli-1.3-bin.tar.gz.sha1
==============================================================================
--- dev/commons/cli/binaries/commons-cli-1.3-bin.tar.gz.sha1 (added)
+++ dev/commons/cli/binaries/commons-cli-1.3-bin.tar.gz.sha1 Sun May 3 15:04:37 2015
@@ -0,0 +1 @@
+150b0d14656bf98b775b97f85705ecc3759b7757
\ No newline at end of file
Added: dev/commons/cli/binaries/commons-cli-1.3-bin.zip
==============================================================================
Binary file - no diff available.
Propchange: dev/commons/cli/binaries/commons-cli-1.3-bin.zip
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: dev/commons/cli/binaries/commons-cli-1.3-bin.zip.asc
==============================================================================
--- dev/commons/cli/binaries/commons-cli-1.3-bin.zip.asc (added)
+++ dev/commons/cli/binaries/commons-cli-1.3-bin.zip.asc Sun May 3 15:04:37 2015
@@ -0,0 +1,17 @@
+-----BEGIN PGP SIGNATURE-----
+Version: GnuPG v2
+
+iQIcBAABCgAGBQJVRjaMAAoJEJ2q3ByfzILQp6UQAIy1F3eEfVz6rLLMw4kcAdK+
+JJ0TNe27u2+70oH5tPYajVjH/Zr0QBBJxbRJk+z05ePiKR+fxjU8e1N3CyQkq7zf
+mRkWN1jDviaY/lcn3E54gR/+vir+eFVygywc3sZUXkRJQtX7RH9M3XVDtlQquPH+
+CPQb4ODp4EphHNS1IjZ/m+tYrqLPZTW44unqvg0avfnrclitgvd5AheqLjmy1nb/
+7Ti6dmfN8Oe8WQ/tvqZMMwehrZNMZ5L3wbOZ2LKM/nFB8A044eVqRgoAOEwqp1xJ
+kGctLkbBkePzrM1nG6X2PWurvb2uMx6rJSckCcNBJ9041XiTy3qAHD/XL+bZBRPs
+QmRoQFPicdYB5yFr00BYyvuWE17famMWYp+s07ueIsGgcgLEnqW169yZOKw0N7Nz
+QIsqTi/mfuUNtEe1Pm1qcQR3bXibjo0SKHtqCtnUe7qrXFeTDMHLyIVy6biFryv5
+sV13igNSs2H777047GwilXNja40Bv8Ek8OS4X9P0ag9DIrY24n3rFcbRMqUk4F5z
+Opf3yYAY2p4r5hVRlF55dc1o425+1CIG3y33M7/tS7YrZugsQLZv9mzQMGCSV4q2
+TJEqG1ul6dpzxWh8KMGyy03SQarc5VBjBQUE6HMCA/NGpNIg7WdgQVe0Iej0Nz2a
+MFAU5uBmxZh03nJJI2Bn
+=jcRp
+-----END PGP SIGNATURE-----
Added: dev/commons/cli/binaries/commons-cli-1.3-bin.zip.md5
==============================================================================
--- dev/commons/cli/binaries/commons-cli-1.3-bin.zip.md5 (added)
+++ dev/commons/cli/binaries/commons-cli-1.3-bin.zip.md5 Sun May 3 15:04:37 2015
@@ -0,0 +1 @@
+f74d6f83e8ac1820b3035aebff6666bb
\ No newline at end of file
Added: dev/commons/cli/binaries/commons-cli-1.3-bin.zip.sha1
==============================================================================
--- dev/commons/cli/binaries/commons-cli-1.3-bin.zip.sha1 (added)
+++ dev/commons/cli/binaries/commons-cli-1.3-bin.zip.sha1 Sun May 3 15:04:37 2015
@@ -0,0 +1 @@
+009af5e767c9968946547b8602b2142e2e35f278
\ No newline at end of file
Added: dev/commons/cli/source/commons-cli-1.3-src.tar.gz
==============================================================================
Binary file - no diff available.
Propchange: dev/commons/cli/source/commons-cli-1.3-src.tar.gz
------------------------------------------------------------------------------
svn:mime-type = application/x-gzip
Added: dev/commons/cli/source/commons-cli-1.3-src.tar.gz.asc
==============================================================================
--- dev/commons/cli/source/commons-cli-1.3-src.tar.gz.asc (added)
+++ dev/commons/cli/source/commons-cli-1.3-src.tar.gz.asc Sun May 3 15:04:37 2015
@@ -0,0 +1,17 @@
+-----BEGIN PGP SIGNATURE-----
+Version: GnuPG v2
+
+iQIcBAABCgAGBQJVRjaMAAoJEJ2q3ByfzILQ8MYQAMEiIjqoD29X7eIZt5iOqQWg
+ybInM7ICHtw1lchHO/ngdyu6rPzkRDtQ04iPfq8sfIz6kV3DI1jXBxkiROS7dQwL
+SQA3eZs6y4ZERGUlc6Ua/oTqNmBE/R+3xTEfMVpl4NR/sJ9wsq35MeYRiGnn5Kos
+RxvGSZdR+1xvbXxmfuIn0Zt2/Gfd+ezGXlciBDY5x6IukZRU3fl06iPpa6Da8VC1
+4zKDGVehJYV86I2kBIgL5j+Cw1LJ7B7upxv52+C4Nzq70qwD0SElqyKyufuiF5/S
+kYePV9kzo95kwfLQy0XevmydPebk81FiZR3rUpsRf3CtVCudS36wTT2YXxNoqKP8
+kSNRcQ5+r5lNr/uzgV5Sf8iNl5kcM9b+SDvMAsqc07B3YLGIFDrbRwvsI8jy00qx
+hvqPyw0zWVcsR6Y+eNkOP9ncbIGFv3eXSnJVoxE5aJNXhRFRXx0Z6clkghHwEeOs
+KD/P7FuX6ZsHUnpgrUOJJnCXRAUeGll1vkzeiRr+/1AVqka838pyN83cxK8K7b9U
+LTOZkWd7xn/vaQ31xVR5d2gBPoN0WVkC9f89cwOIE71tMrjnPtG/O4qse06Ukm+K
+G2/44nSqQEbp+JtjzvzCJlQRzXpRll0Z81SfzXh1F1MNcoPPmpdL/BYWWl/5pfIH
+j6WKynUsiKHz9348ztrm
+=BG03
+-----END PGP SIGNATURE-----
Added: dev/commons/cli/source/commons-cli-1.3-src.tar.gz.md5
==============================================================================
--- dev/commons/cli/source/commons-cli-1.3-src.tar.gz.md5 (added)
+++ dev/commons/cli/source/commons-cli-1.3-src.tar.gz.md5 Sun May 3 15:04:37 2015
@@ -0,0 +1 @@
+0156b6f7197f7f205c20842979bd4ebe
\ No newline at end of file
Added: dev/commons/cli/source/commons-cli-1.3-src.tar.gz.sha1
==============================================================================
--- dev/commons/cli/source/commons-cli-1.3-src.tar.gz.sha1 (added)
+++ dev/commons/cli/source/commons-cli-1.3-src.tar.gz.sha1 Sun May 3 15:04:37 2015
@@ -0,0 +1 @@
+d124c210812fa44bea4469c469976c00c8663133
\ No newline at end of file
Added: dev/commons/cli/source/commons-cli-1.3-src.zip
==============================================================================
Binary file - no diff available.
Propchange: dev/commons/cli/source/commons-cli-1.3-src.zip
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: dev/commons/cli/source/commons-cli-1.3-src.zip.asc
==============================================================================
--- dev/commons/cli/source/commons-cli-1.3-src.zip.asc (added)
+++ dev/commons/cli/source/commons-cli-1.3-src.zip.asc Sun May 3 15:04:37 2015
@@ -0,0 +1,17 @@
+-----BEGIN PGP SIGNATURE-----
+Version: GnuPG v2
+
+iQIcBAABCgAGBQJVRjaMAAoJEJ2q3ByfzILQvMgQAIIVZm2WmDPoI3OTttxhXiuL
+wnEr4VnSr37SvIiAOU1gke589JoUVf+YnMmH4TegW/RaOwYApaVOmzR/XtN4yOba
+O7if/1wHTFE9fhsbX+I7IuVnj8/w1oasfZM90KCqh+EyJi3QkQstMq6EL6pKI7AJ
+90Me0z/66vw6/9bJusxwb13QlcLR8a0iClYRcWQRzN8F5/NSgOKWni71Zps4ifH7
+g1nz3aWjARR9lBIjVskSbuv+h4a8IR3RD5F9SjkErJXGJzO9TAIppy9LkL8Cgl51
+RdavnlwmNHDDF88yz1NOfHlPeF8dnxDmwyt02d82t18yAsYtUr211BFUQK7JDNXG
+gaKYHmzm5PE2jCbb6lLfCN4pF/lBYMVMje9DG6WtUjZ14wV1EWmoxAg78BkPb9v5
+/65DcSXgiRtSfItrRDgum7x0GlwNkR8R+jHKLsw/NBJfHXNJHkx6sBfkf7zzfDVL
+geDuNsSfKRhFjuz8404lDZxspzVceTGQKBtHsozkzFYOwoOrAcdsUk3ov5bJikY+
+veIQjg1uiNWVMYWI0xPk5DUYIJPV8oAUc/7Of6CeLHl7541cfBZ1gxYgjDmr53Oh
+6RrkhHpVQ5RTX8t7kSObBTzlIYQWu5XHiqa9V5Kg2o6/bsbs0z7jKhnfkuZ/Mpt7
+ZPSoqgYtXz3uMYE6fS/P
+=M42e
+-----END PGP SIGNATURE-----
Added: dev/commons/cli/source/commons-cli-1.3-src.zip.md5
==============================================================================
--- dev/commons/cli/source/commons-cli-1.3-src.zip.md5 (added)
+++ dev/commons/cli/source/commons-cli-1.3-src.zip.md5 Sun May 3 15:04:37 2015
@@ -0,0 +1 @@
+ad32966b23c18ed1ed00c7cf98ebfbf7
\ No newline at end of file
Added: dev/commons/cli/source/commons-cli-1.3-src.zip.sha1
==============================================================================
--- dev/commons/cli/source/commons-cli-1.3-src.zip.sha1 (added)
+++ dev/commons/cli/source/commons-cli-1.3-src.zip.sha1 Sun May 3 15:04:37 2015
@@ -0,0 +1 @@
+c3f3f7f1a7d3e7a999ecb4da1b817d5c4546197d
\ No newline at end of file