1Current
2
31.30
42012/10/27
5
6Added: JCommander#acceptUnknownOption and JCommander#getUnknownArgs
7Added: JCommander#allowAbbreviatedOptions (default: false)
8Added: JCommander#setCaseSensitiveOptions (default: true)
9Added: Support for enums (Scott M Stark)
10Fixed: Missing new lines in usage (styurin)
11Fixed: The description of commands is now displayed on the next line and indented.
12
131.29
142012/07/28
15
16Fixed: Empty string defaults now displayed as "<empty string>" in the usage
17Fixed: Bugs with the PositiveInteger validator
18Fixed: Parameters with a single double quote were not working properly
19
201.27
212012/07/05
22
23Added: IValueValidator to validate parameter values (typed) as opposed to IParameterValidator which validates strings
24Added: echoInput, used when password=true to echo the characters (Jason Wheeler)
25Added: @Parameter(help = true)
26Fixed: wasn't handling parameters that start with " but don't end with one correctly
27Fixed: if using a different option prefix, unknown option are mistakenly reported as "no main parameter defined" (kurmasz)
28Fixed: 113: getCommandDescription() returns the description of the main parameter instead of that of the command
29Fixed: bug with several multiple arity parameters (VariableArityTest)
30Fixed: variable arities not working when same parameter appears multiple times.
31
321.25
332012/04/26
34
35Added: Default passwords are no longer displayed in the usage (Paul Mendelson)
36Added: Variable arities now work magically, no need for IVariableArity any more
37Fixed: Commands using @Parameters(resourceBundle) were not i18n'ed properly in the usage()
38Fixed: StringIndexOutOfBoundsException if passing an empty parameter (bomanz)
39Fixed: GITHUB-105: If no description is given for an enum, use that enum's value (Adrian Muraru)
40Fixed: GITHUB-108: Dynamic parameters with "=" in them are not parsed correctly (szhem)
41Fixed: Commands with same prefix as options were not working properly.
42Fixed: GITHUB-97: Required password always complains that it is not specified (timoteoponce)
43
441.23
452012/01/12
46
47Added: @DynamicParameter
48Fixed: Use JDK 6 Console() when available to improve support of non ascii chars (Julien Henry)
49
501.20
512011/11/24
52
53Added: Support for delegating parameter definitions to child classes (rodionmoiseev)
54Added: @Parameter(commandNames) so that command names can be specified with annotations
55Added: Support for enums (Adrian Muraru)
56Fixed: Throw if an unknown option is found
57Fixed: Main parameters are now validated as well (Connor Mullen)
58
591.19
602011/10/10
61
62Added: commandDescriptionKey to @Parameters, to allow internationalized command descriptions
63Added: JCommander#setParameterDescriptionComparator for better control over usage()
64Fixed: Fields of type Set (HashSet and SortedSet) are now supported
65Fixed: defaults for commands were not properly applied (Stevo Slavic)
66Fixed: "-args=a=b,b=c" was not being parsed correctly (Michael Lancaster)
67Fixed: GITHUB-73: descriptionKey was being ignored on main parameters
68
691.18
702011/07/20
71
72Added: Default converter factories can be overridden (Scott Clasen)
73Added: IParameterValidator
74Added: Don't display "Options:" if none were defined
75Added: Enforce that the type of the main parameter is a List
76Added: usage() now displays the options for each command as well
77Fixed: Default values with a validator were being validate at parse() time instead of creation time.
78Fixed: Exception when using an @ file with empty lines between options
79Fixed: OOM when parsing certain descriptions with long URL's in them
80
811.15
822011/01/24
83
84Added: Added a constructor that takes a Bundle only, https://github.com/cbeust/jcommander/pull/47 (Russell Egan)
85Fixed: NPE with calling getCommandDescription() of an unknown command
86
871.13
882010/12/15
89
90Added: Boolean parameters with arity 0 (e.g. "foo -debug")
91Fixed: JCommander would sometimes just print a stack trace and continue, now rethrowing.
92
931.7
942010/09/06
95
96Added: Command usages are now shown in the order they were added to the JCommander object
97Fixed: JCommander now compatible with Java 5
98Fixed: Minor bug in the command display (Marc Ende)
99
1001.6
1012010/08/28
102
103Added: @Parameters(commandDescription = "command description")
104Added: now throwing an exception if required main parameters are not supplied
105Fixed: usage() was changing default values after two runs (jstrachan)
106
1071.5
1082010/08/15
109
110Added: overloaded versions of usage() with StringBuilders
111Added: inheritance support (Guillaume Sauthier)
112Added: support for commands (e.g. "main add --author=cbeust Foo.java")
113Added: support for converters for main parameters (e.g. List<HostPort>).
114
1151.4
1162010/07/28
117
118Added: string converter factories
119Added: IDefaultProvider
120Added: PropertyFileDefaultProvider
121Added: Usage is now showing required parameters and default value
122Added: Support for values that look like parameters ("-integer -3", "/file /tmp/a")
123Added: @Parameters(optionPrefixes) to allow for different prefixes than "-"
124
1251.2
1262010/07/25
127
128Usage is now aligned and alphabetically sorted
129Added the hidden attribute
130Added support for different separators than " " (e.g. "=").
131Deprecated @ResourceBundle, replaced with @Parameters
132
1331.1
1342010/08/15
135
136Better internationalization
137Password support
138Type converters
139
140