diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5a08349b..4aa84440 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,21 @@
+<a name="v2.24.2"></a>
+### v2.24.2 (2017-05-15)
+
+
+#### Bug Fixes
+
+*   adds a debug assertion to ensure all args added to groups actually exist ([14f6b8f3](https://github.com/kbknapp/clap-rs/commit/14f6b8f3a2f6df73aeeec9c54a54909b1acfc158), closes [#917](https://github.com/kbknapp/clap-rs/issues/917))
+*   fixes a bug where args that allow values to start with a hyphen couldnt contain a double hyphen -- as a value ([ebf73a09](https://github.com/kbknapp/clap-rs/commit/ebf73a09db6f3c03c19cdd76b1ba6113930e1643), closes [#960](https://github.com/kbknapp/clap-rs/issues/960))
+*   fixes a bug where positional argument help text is misaligned ([54c16836](https://github.com/kbknapp/clap-rs/commit/54c16836dea4651806a2cfad53146a83fa3abf21))
+
+#### Documentation
+
+* **App::template:**  adds details about the necessity to use AppSettings::UnifiedHelpMessage when using {unified} tags in the help template ([cf569438](https://github.com/kbknapp/clap-rs/commit/cf569438f309c199800bb8e46c9f140187de69d7), closes [#949](https://github.com/kbknapp/clap-rs/issues/949))
+* **Arg::allow_hyphen_values:**  updates the docs to include warnings for allow_hyphen_values and multiple(true) used together ([ded5a2f1](https://github.com/kbknapp/clap-rs/commit/ded5a2f15474d4a5bd46a67b130ccb8b6781bd01))
+* **clap_app!:**  adds using the @group specifier to the macro docs ([fe85fcb1](https://github.com/kbknapp/clap-rs/commit/fe85fcb1772b61f13b20b7ea5290e2437a76190c), closes [#932](https://github.com/kbknapp/clap-rs/issues/932))
+
+
+
 <a name="v2.24.0"></a>
 ### v2.24.0 (2017-05-07)
 
diff --git a/Cargo.toml b/Cargo.toml
index 89b39a7b..5590a870 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,7 +1,7 @@
 [package]
 
 name = "clap"
-version = "2.24.1"
+version = "2.24.2"
 authors = ["Kevin K. <kbknapp@gmail.com>"]
 exclude = ["examples/*", "clap-test/*", "tests/*", "benches/*", "*.png", "clap-perf/*", "*.dot"]
 repository = "https://github.com/kbknapp/clap-rs.git"
diff --git a/README.md b/README.md
index ae9a8c7d..e76e6060 100644
--- a/README.md
+++ b/README.md
@@ -45,14 +45,20 @@ Created by [gh-md-toc](https://github.com/ekalinin/github-markdown-toc)
 
 ## What's New
 
-Here's the highlights for v2.24.1
+Here's the highlights for v2.24.2
+
+* fixes a bug where args that allow values to start with a hyphen couldnt contain a double hyphen -- as a value 
+* fixes a bug where positional argument help text is misaligned 
+* **App::template docs:**  adds details about the necessity to use AppSettings::UnifiedHelpMessage when using {unified} tags in the help template 
+* **Arg::allow_hyphen_values docs:**  updates the docs to include warnings for allow_hyphen_values and multiple(true) used together 
+* **clap_app! docs:**  adds using the @group specifier to the macro docs 
+* adds a debug assertion to ensure all args added to groups actually exist 
+
+Here's the highlights for v2.21.0 to v2.24.1
 
 * fixes a bug where args with last(true) and required(true) set were not being printed in the usage string 
 * fixes a bug that was printing the arg name, instead of value name when Arg::last(true) was used 
 * fixes a bug where flags were parsed as flags AND positional values when specific combinations of settings were used 
-
-Here's the highlights for v2.21.0 to v2.24.0
-
 * **README.md:**  fix some typos 
 * **Arg:**  add `default_value_os` 
 * **arg_matches.rs:**  Added a Default implementation for Values and OsValues iterators.