Author: bayard
Date: Sat Jun 30 11:26:35 2007
New Revision: 552192
URL: http://svn.apache.org/viewvc?view=rev&rev=552192
Log:
Upgrading release notes
Modified:
jakarta/commons/proper/cli/trunk/xdocs/changes.xml
jakarta/commons/proper/cli/trunk/xdocs/upgrading-1.0-to-1.1.xml
Modified: jakarta/commons/proper/cli/trunk/xdocs/changes.xml
URL:
http://svn.apache.org/viewvc/jakarta/commons/proper/cli/trunk/xdocs/changes.xml?view=diff&rev=552192&r1=552191&r2=552192
==============================================================================
--- jakarta/commons/proper/cli/trunk/xdocs/changes.xml (original)
+++ jakarta/commons/proper/cli/trunk/xdocs/changes.xml Sat Jun 30 11:26:35 2007
@@ -47,6 +47,11 @@
<action type="fix" issue="CLI-35">HelpFormatter doesn't sort options
properly. </action>
<action type="fix" issue="CLI-130">Remove the Commons Lang dependency.
</action>
<action type="add" issue="CLI-78">Setting description of a Option.
</action>
+ <action type="fix" issue="CLI-131">Options class returns options in
random order. </action>
+ <action type="fix" issue="CLI-132">MissingOptionException should contain
a useful error message. </action>
+ <action type="fix" issue="CLI-133">NullPointerException in
Util.stripLeadingHyphens when passed a null argument. </action>
+ <action type="fix" issue="CLI-134">1.1 is not backwards compatible
because it adds methods to the CommandLineParser interface. </action>
+ <action type="fix" issue="CLI-135">Backwards compatibility between 1.1
and 1.0 broken due to Option.addValue removal. </action>
</release>
Modified: jakarta/commons/proper/cli/trunk/xdocs/upgrading-1.0-to-1.1.xml
URL:
http://svn.apache.org/viewvc/jakarta/commons/proper/cli/trunk/xdocs/upgrading-1.0-to-1.1.xml?view=diff&rev=552192&r1=552191&r2=552192
==============================================================================
--- jakarta/commons/proper/cli/trunk/xdocs/upgrading-1.0-to-1.1.xml (original)
+++ jakarta/commons/proper/cli/trunk/xdocs/upgrading-1.0-to-1.1.xml Sat Jun 30
11:26:35 2007
@@ -23,20 +23,21 @@
<body>
<!-- ================================================== -->
<section name="Upgrading from 1.0 to 1.1">
- <p>CLI 1.1 is a bugfix release of CLI. The following changes were not
backward compatible: </p>
+ <p>CLI 1.1 is a bugfix release of CLI. The following changes notable API
changes were made: </p>
<ul>
- <li>The CommandLineParser interface has two additional methods. If you
were extending this,
- then you will need to add methods to your classes. If you were
extending the abstract
- Parser class, then you should be okay. </li>
- <li>The HelpFormatter class had publicly accessible fields. These are now
accessed via
- get/set methods. </li>
- <li>Two of HelpFormatter's methods no longer throw
IllegalArgumentException. </li>
- <li>The Option class is no longer cloneable, and no longer has an
addValue(String) method. </li>
+ <li>The Parser abstract class has two additional parse methods that take a
Properties parameter. </li>
+ <li>The HelpFormatter class had publicly accessible fields. These should
now be accessed via
+ get/set methods and the public fields are deprecated. </li>
+ <li>The Option class addValue(String) method now throws
UnsupportedOperationException. </li>
+ <li>OptionValidator is a newly added class. </li>
+ <li>Option's now have equals(Object) and hashCode() methods. </li>
+ <li>The Option class also received two new methods, setDescription(String)
and hasValueSeparator();boolean. </li>
</ul>
- <p>The best way to test any of the above is to recompile your code against
CLI 1.1. All of the above
- should result in compile time errors. </p>
+ <p>The jar should be API backwards compatible, though if you were calling
addValue(String) then you won't be happy. Please
+ let us know your use case if that is so. </p>
+
</section>
<section name="Bugs fixed in 1.1">
<p>The list of bugs fixed in 1.1 may be seen via the
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
