[Jakarta-commons Wiki] Update of "CLI" by SimonKitching

[Apache Wiki <wi...@apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Jakarta-commons Wiki" for change notification.

The following page has been changed by SimonKitching:
http://wiki.apache.org/jakarta-commons/CLI

The comment on the change is:
create page

New page:
##language:en
= About the Commons CLI Library =

This wiki site is used for discussion of topics associated with the
commons-cli project whose home page is http://jakarta.apache.org/commons/cli

----

= News =

== Bad 1.0 release on Ibiblio (Maven) ==

Release 1.0 occurred in Nov 2002.

Due to an unfortunate accident, the 1.0 jar file published on ibiblio at http://www.ibiblio.org/maven/commons-cli/jars was overwritten at some point by a snapshot of later code, i.e. file commons-cli-1.0.jar became a snapshot of the trunk code at some later time (possibly 29 Jan 2004). The ibiblio repository of jar files is the default location that the Maven build tool uses to automatically download dependencies; therefore any project that uses Maven to build code which declares a dependency on commons-cli 1.0 may have downloaded and cached the incorrect file.

The binary and source distribution downloads available via the download pages of Apache or its mirrors is, and always has been the correct 1.0 release.

The file in question can be found at http://www.ibiblio.org/maven/commons-cli/jars
    * The md5 checksum of the valid 1.0 jar is: f6feeb3b3d95f7d09180fd71e96cead4 and its size is: 30117 bytes. 
    * The md5 checksum of the invalid 1.0 jar is: 5cb21f532ab921134751b4b6e4807be4 and its size is: 32377 bytes

The snapshot which was accidentally published on ibiblio contains a number of API differences from the actual 1.0 release. Most obviously, the snapshot jar contains classes OptionValidator and Util which are not present in the real 1.0 release. 

Debate is currently occurring about the best way to resolve this issue.

For the moment, the best solution is to check the contents of your maven repository (~/.maven on unix/linux systems). If the incorrect file is there then download the 1.0 distribution from the Apache site or its mirrors and place the jar contained in that distribution into the maven repository manually.

= Resources =

 * [wiki:/FAQ The Frequently Asked Questions Page (FAQ)]

---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org