[Japi-cvs] SF.net SVN: japi: [602] libs/argparser/trunk/src/net/sf/japi/io/args/ package-info.java

[<chr...@us...>]

Revision: 602
          http://japi.svn.sourceforge.net/japi/?rev=602&view=rev
Author:   christianhujer
Date:     2007-09-08 13:22:46 -0700 (Sat, 08 Sep 2007)

Log Message:
-----------
Improved documentation.

Modified Paths:
--------------
    libs/argparser/trunk/src/net/sf/japi/io/args/package-info.java

Modified: libs/argparser/trunk/src/net/sf/japi/io/args/package-info.java
===================================================================
--- libs/argparser/trunk/src/net/sf/japi/io/args/package-info.java	2007-09-08 20:22:18 UTC (rev 601)
+++ libs/argparser/trunk/src/net/sf/japi/io/args/package-info.java	2007-09-08 20:22:46 UTC (rev 602)
@@ -34,6 +34,10 @@
  * If short options take argument values and they are concatenated, the argument values are separate strings following the concatenated option in exactly the order of the concatenated options.
  * In <samp>-io foo bar</samp>, given that both, <samp>i</samp> and <samp>o</samp> take an argument value, <samp>foo</samp> is value for <samp>i</samp>, while <samp>bar</samp> is value for <samp>o</samp>.
  * <p/>
+ * If there is an ambiguity between concatenated short options and a long option of the same name, the long option takes precedence.
+ * Users be warned: this ambiguity may cause trouble to you if you use programs in batches and then update them.
+ * One day -xyz means -x -y -z, the other day after updating the program introduced long option xyz, -xyz means --xyz.
+ * <p/>
  * The special option <code>--</code> will stop argument parsing.
  * All strings that follow the <code>--</code>-option are treated as command arguments, not options, even if they start with <code>-</code>.
  * <p/>


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.