blob: 1482f1adc531dfbf3172c1eaa3c4173f1e0a5c98 [file] [log] [blame]
Cedric Beusta6e4abd2010-10-01 11:42:59 -07001Current
2
Cedric Beusta8f4de22012-07-31 11:24:27 -07003Added: JCommander#setCaseSensitiveOptions (default: true)
Cedric Beust5f260732012-07-30 22:23:27 -07004Fixed: The description of commands is now displayed on the next line and indented.
Cedric Beuste79760c2012-07-25 14:53:22 -07005Fixed: Empty string defaults now displayed as "<empty string>" in the usage
Cedric Beustf65b1602012-07-17 22:44:09 -07006Fixed: Bugs with the PositiveInteger validator
Cedric Beust94e08e72012-07-17 22:25:26 -07007Fixed: Parameters with a single double quote were not working properly
Cedric Beusta8560682012-07-06 23:25:36 -07008
91.27
101012/08/05
11Added: IValueValidator to validate parameter values (typed) as opposed to IParameterValidator which validates strings
Cedric Beust11b27d32012-05-30 14:51:50 -070012Added: echoInput, used when password=true to echo the characters (Jason Wheeler)
Cedric Beustc675ef52012-07-04 13:23:31 -070013Added: @Parameter(help = true)
Cedric Beust074b8af2012-05-31 11:51:19 -070014Fixed: wasn't handling parameters that start with " but don't end with one correctly
Cedric Beust9e22cff2012-05-15 14:49:22 -070015Fixed: if using a different option prefix, unknown option are mistakenly reported as "no main parameter defined" (kurmasz)
Cedric Beust13a57cd2012-05-08 15:14:12 -070016Fixed: 113: getCommandDescription() returns the description of the main parameter instead of that of the command
Cedric Beustfb38f402012-05-02 11:52:39 -070017Fixed: bug with several multiple arity parameters (VariableArityTest)
Cedric Beustc84dbd32012-04-29 15:17:05 -070018Fixed: variable arities not working when same parameter appears multiple times.
19
Cedric Beust5f5b78b2012-04-28 17:50:24 -0700201.25
212012/04/26
Cedric Beustd38864b2012-03-15 08:09:11 -070022Added: Default passwords are no longer displayed in the usage (Paul Mendelson)
Cedric Beust8f046522012-04-26 14:00:22 -070023Added: Variable arities now work magically, no need for IVariableArity any more
24Fixed: Commands using @Parameters(resourceBundle) were not i18n'ed properly in the usage()
Cedric Beustca0789b2012-04-18 10:14:48 -070025Fixed: StringIndexOutOfBoundsException if passing an empty parameter (bomanz)
Cedric Beust3506d022012-03-12 14:51:40 -070026Fixed: GITHUB-105: If no description is given for an enum, use that enum's value (Adrian Muraru)
Cedric Beust8ebf58f2012-03-10 16:12:16 -080027Fixed: GITHUB-108: Dynamic parameters with "=" in them are not parsed correctly (szhem)
Cedric Beust8ad02da2012-01-12 13:23:58 -080028Fixed: Commands with same prefix as options were not working properly.
Cedric Beust39e431e2012-02-25 16:43:59 -080029Fixed: GITHUB-97: Required password always complains that it is not specified (timoteoponce)
Cedric Beust8ad02da2012-01-12 13:23:58 -080030
311.23
322012/01/12
33
Cedric Beusta559c602012-01-10 16:49:06 -080034Added: @DynamicParameter
Julien HENRYe45913e2011-11-29 09:40:08 +010035Fixed: Use JDK 6 Console() when available to improve support of non ascii chars (Julien Henry)
36
Cedric Beustaf876df2011-11-25 11:30:06 -0800371.20
382011/11/24
39
Cedric Beust4ba2a3c2011-11-25 09:34:05 -080040Added: Support for delegating parameter definitions to child classes (rodionmoiseev)
Cedric Beust66e78952011-11-23 13:15:16 -080041Added: @Parameter(commandNames) so that command names can be specified with annotations
Cédric Beustf2af8142011-10-23 12:02:09 -070042Added: Support for enums (Adrian Muraru)
Cedric Beust4ba2a3c2011-11-25 09:34:05 -080043Fixed: Throw if an unknown option is found
Cedric Beustc3507eb2011-11-25 10:47:01 -080044Fixed: Main parameters are now validated as well (Connor Mullen)
Cédric Beustf2af8142011-10-23 12:02:09 -070045
461.19
472011/10/10
Cedric Beustaf876df2011-11-25 11:30:06 -080048
Cedric Beust8a3f5622011-07-15 10:55:52 -070049Added: commandDescriptionKey to @Parameters, to allow internationalized command descriptions
Cédric Beustcbdb7072011-10-05 23:14:20 -070050Added: JCommander#setParameterDescriptionComparator for better control over usage()
Cedric Beust876c9772011-08-17 11:09:57 -070051Fixed: Fields of type Set (HashSet and SortedSet) are now supported
Cedric Beustdce5bdf2011-08-03 11:04:58 -070052Fixed: defaults for commands were not properly applied (Stevo Slavic)
Cedric Beust2ee07bc2011-07-27 10:32:36 -070053Fixed: "-args=a=b,b=c" was not being parsed correctly (Michael Lancaster)
Cedric Beust4f4ea1f2011-07-14 11:17:16 -070054Fixed: GITHUB-73: descriptionKey was being ignored on main parameters
55
561.18
572011/07/20
58
Cedric Beustdb01fd22011-04-12 13:03:29 -070059Added: Default converter factories can be overridden (Scott Clasen)
Cedric Beust8877f662011-03-10 11:04:38 -080060Added: IParameterValidator
Cedric Beustc199c872011-07-07 13:34:54 -070061Added: Don't display "Options:" if none were defined
62Added: Enforce that the type of the main parameter is a List
63Added: usage() now displays the options for each command as well
Cedric Beustfe8a6962011-06-13 13:35:31 -070064Fixed: Default values with a validator were being validate at parse() time instead of creation time.
Cedric Beust8877f662011-03-10 11:04:38 -080065Fixed: Exception when using an @ file with empty lines between options
Cedric Beustc199c872011-07-07 13:34:54 -070066Fixed: OOM when parsing certain descriptions with long URL's in them
Cedric Beust279af562011-01-24 14:57:44 -080067
681.15
Cedric Beuste2d8da72011-01-24 14:01:29 -0800692011/01/24
70
Cedric Beustfce970e2010-12-23 12:25:49 -080071Added: Added a constructor that takes a Bundle only, https://github.com/cbeust/jcommander/pull/47 (Russell Egan)
Cedric Beuste2d8da72011-01-24 14:01:29 -080072Fixed: NPE with calling getCommandDescription() of an unknown command
Cedric Beust1f4e89c2010-12-23 12:33:45 -080073
741.13
752010/12/15
76
77Added: Boolean parameters with arity 0 (e.g. "foo -debug")
Cedric Beusta6e4abd2010-10-01 11:42:59 -070078Fixed: JCommander would sometimes just print a stack trace and continue, now rethrowing.
79
Cedric Beuste97a6422010-08-31 22:03:35 -0700801.7
Cedric Beust3a32b552010-09-06 07:26:09 -0700812010/09/06
Cedric Beuste97a6422010-08-31 22:03:35 -070082
Cedric Beust4c020da2010-08-31 22:23:52 -070083Added: Command usages are now shown in the order they were added to the JCommander object
Cedric Beust22b8a2f2010-09-06 07:17:37 -070084Fixed: JCommander now compatible with Java 5
Cedric Beuste97a6422010-08-31 22:03:35 -070085Fixed: Minor bug in the command display (Marc Ende)
86
Cedric Beust72cacba2010-08-15 17:23:00 -0700871.6
Cedric Beuste97a6422010-08-31 22:03:35 -0700882010/08/28
Cedric Beust6f6f4362010-07-29 17:18:24 -070089
Cedric Beustdda16512010-08-25 18:54:58 -070090Added: @Parameters(commandDescription = "command description")
Cedric Beust72cacba2010-08-15 17:23:00 -070091Added: now throwing an exception if required main parameters are not supplied
Cedric Beusta76d5b92010-08-16 21:48:14 -070092Fixed: usage() was changing default values after two runs (jstrachan)
Cedric Beust72cacba2010-08-15 17:23:00 -070093
941.5
952010/08/15
96
97Added: overloaded versions of usage() with StringBuilders
98Added: inheritance support (Guillaume Sauthier)
99Added: support for commands (e.g. "main add --author=cbeust Foo.java")
100Added: support for converters for main parameters (e.g. List<HostPort>).
Cedric Beust6f6f4362010-07-29 17:18:24 -0700101
Cedric Beustc63fd222010-07-27 11:05:19 -07001021.4
Cedric Beust72cacba2010-08-15 17:23:00 -07001032010/07/28
Cedric Beustc63fd222010-07-27 11:05:19 -0700104
Cedric Beustabcd2cb2010-08-15 17:23:30 -0700105Added: string converter factories
106Added: IDefaultProvider
107Added: PropertyFileDefaultProvider
108Added: Usage is now showing required parameters and default value
109Added: Support for values that look like parameters ("-integer -3", "/file /tmp/a")
110Added: @Parameters(optionPrefixes) to allow for different prefixes than "-"
Cedric Beustc63fd222010-07-27 11:05:19 -0700111
Cedric Beust2a7a6d42010-07-20 22:37:47 -07001121.2
Cedric Beust72cacba2010-08-15 17:23:00 -07001132010/07/25
Cedric Beust2a7a6d42010-07-20 22:37:47 -0700114
Cedric Beustb1056412010-07-20 23:11:25 -0700115Usage is now aligned and alphabetically sorted
116Added the hidden attribute
Cedric Beustfe9b1e52010-07-23 15:18:22 -0700117Added support for different separators than " " (e.g. "=").
118Deprecated @ResourceBundle, replaced with @Parameters
Cedric Beust2a7a6d42010-07-20 22:37:47 -0700119
1201.1
Cedric Beustfe9b1e52010-07-23 15:18:22 -07001212010/08/15
Cedric Beust2a7a6d42010-07-20 22:37:47 -0700122
123Better internationalization
124Password support
125Type converters
126