v2.2.1: Auto merge of #454 - kbknapp:issue-453,452, r=kbknapp

a name="2.2.1">

2.2.1 (2016-03-16)

Features

• Help Message: wraps and aligns the help message of subcommands (813d75d0, closes #452)

Bug Fixes

• Help Message: fixes a bug where small terminal sizes causing a loop (1d73b035, closes #453)

2.2.0: Auto merge of #450 - kbknapp:issue-416, r=kbknapp

v2.2.0 (2016-03-15)

Features

• Help Message: can auto wrap and aligning help text to term width (e36af026, closes #428)
• Help Subcommand: adds support passing additional subcommands to help subcommand (2c12757b, closes #416)
• Opts and Flags: adds support for custom ordering in help messages (9803b51e)
• Settings: adds support for automatically deriving custom display order of args (ad86e433, closes #444)
• Subcommands: adds support for custom ordering in help messages (7d2a2ed4, closes #442)

Bug Fixes

• From Usage: fixes a bug where adding empty lines werent ignored (c5c58c86)

Documentation

• Groups: explains required ArgGroups better (4ff0205b, closes #439)

v2.1.1: Auto merge of #425 - kbknapp:issue-421, r=kbknapp

v2.1.1 (2016-02-19)

Documentation

• AppSettings: clarifies that AppSettings do not propagate (3c8db0e9, closes #429)
• Arg Examples: adds better examples (1e79cccc)

Improvements

• Help: adds setting for next line help by arg (066df748, closes #427)

v2.1.0: Auto merge of #423 - kbknapp:issue-418, r=kbknapp

v2.1.0 (2016-02-10)

Features

• Defult Values: adds support for default values in args (73211952, closes #418)

Documentation

• Default Values: adds better examples and notes for default values (9facd74f)

v2.0.6: Auto merge of #422 - kbknapp:issue-420, r=kbknapp

v2.0.6 (2016-02-09)

Improvements

• Positional Arguments: now displays value name if appropriate (f0a99916, closes #420)

v2.0.3: Auto merge of #408 - kbknapp:minor-bug, r=sru

v2.0.3 (2016-02-02)

Improvements

• values: adds support for up to u64::max values per arg (c7abf7d7)
• occurrences: Allow for more than 256 occurrences of an argument. (3731ddb3)

Features

• AppSettings: adds HidePossibleValuesInHelp to skip writing those values (cdee7a0e)

Bug Fixes

• value_t_or_exit: fixes typo which causes value_t_or_exit to return a Result (ee96baff)

v2.0.2: Auto merge of #407 - kbknapp:fixrollup, r=kbknapp

v2.0.2 (2016-01-31)

Improvements

• arg_enum: enum declared with arg_enum returns [&'static str; #] instead of Vec (9c4b8a1a)

Bug Fixes

• clap_app! should be gated by unstable, not nightly feature (0c8b84af)
• SubCommands: fixed where subcmds weren't recognized after mult args (c19c17a8, closes #405)
• Usage Parser: fixes a bug where literal single quotes weren't allowed in help strings (0bcc7120, closes #406)

v2.0.1: Auto merge of #403 - kbknapp:cargo-features, r=kbknapp

v2.0.1 (2016-01-30)

Bug Fixes

• fixes cargo features to NOT require nightly with unstable features (dcbcc60c, closes #402)

clap 2.0 release!

v2.0.0 (2016-01-28)

Improvements

• From Usage: vastly improves the usage parser (fa3a2f86, closes #350)

Features

• adds support for external subcommands (177fe5cc, closes #372)
• adds support values with a leading hyphen (e4d429b9, closes #385)
• adds support for turning off the value delimiter (508db850, closes #352)
• adds support changing the value delimiter (dafeae8a, closes #353)
• adds support for comma separated values (e69da6af, closes #348)
• adds support with options with optional values (4555736c, closes #367)
• UTF-8: adds support for invalid utf8 in values (c5c59dec, closes #269)
• v2: implementing the base of 2.x (a3536054)

Bug Fixes

• fixes nightly build with new lints (17599195)
• fixes Windows build for 2x release (674c9b48, closes #392)
• fixes yaml build for 2x base (adceae64)

Documentation

• updates examples for 2x release (1303b360, closes #394)
• updates examples for 2x release (0a011f31, closes #394)
• updates documentation for v2 release (8d51724e)
• updating docs for 2x release (576d0e0e)
• README.md:
  • updates readme for v2 release (acaba01a, closes #393)
  • fix typo and make documentation conspicuous (07b9f614)

BREAKING CHANGES

• Fewer liftimes! Yay!
  • App<'a, 'b, 'c, 'd, 'e, 'f> => App<'a, 'b>
  • Arg<'a, 'b, 'c, 'd, 'e, 'f> => Arg<'a, 'b>
  • ArgMatches<'a, 'b> => ArgMatches<'a>
• Simply Renamed
  • App::arg_group => App::group
  • App::arg_groups => App::groups
  • ArgGroup::add => ArgGroup::arg
  • ArgGroup::add_all => ArgGroup::args
  • ClapError => Error
  • struct field ClapError::error_type => Error::kind
  • ClapResult => Result
  • ClapErrorType => ErrorKind
• Removed Deprecated Functions and Methods
  • App::subcommands_negate_reqs
  • App::subcommand_required
  • App::arg_required_else_help
  • App::global_version(bool)
  • App::versionless_subcommands
  • App::unified_help_messages
  • App::wait_on_error
  • App::subcommand_required_else_help
  • SubCommand::new
  • App::error_on_no_subcommand
  • Arg::new
  • Arg::mutually_excludes
  • Arg::mutually_excludes_all
  • Arg::mutually_overrides_with
  • simple_enum!
• Renamed Error Variants
  • InvalidUnicode => InvalidUtf8
  • InvalidArgument => UnknownArgument
• Usage Parser
  • Value names can now be specified inline, i.e. -o, --option <FILE> <FILE2> 'some option which takes two files'
  • There is now a priority of order to determine the name - This is perhaps the biggest breaking change. See the documentation for full details. Prior to this change, the value name took precedence. Ensure your args are using the proper names (i.e. typically the long or short and NOT the value name) throughout the code
• ArgMatches::values_of returns an Values now which implements Iterator (should not break any code)
• crate_version! returns &'static str instead of String

v1.5.5

v1.5.5 (2016-01-04)

Bug Fixes

• fixes an issue where invalid short args didn't cause an error (c9bf7e44)
• prints the name in version and help instead of binary name (8f3817f6, closes #368)
• fixes an intentional panic issue discovered via clippy (ea83a3d4)