diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4aa84440..c1015a0f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,31 @@
+<a name="v2.24.2"></a>
+### v2.25.0 (2017-06-20)
+
+
+#### Features
+
+*   use textwrap crate for wrapping help texts ([b93870c1](https://github.com/kbknapp/clap-rs/commit/b93870c10ae3bd90d233c586a33e086803117285))
+
+#### Improvements
+
+* **Suggestions:**  suggests to use flag after subcommand when applicable ([2671ca72](https://github.com/kbknapp/clap-rs/commit/2671ca7260119d4311d21c4075466aafdd9da734))
+* Bumps bitflags crate to v0.9
+
+#### Documentation
+
+*   Change `who's` -> `whose` ([53c1ffe8](https://github.com/kbknapp/clap-rs/commit/53c1ffe87f38b05d8804a0f7832412a952845349))
+
+#### Documentation
+
+* **App::template:**  adds details about the necessity to use AppSettings::UnifiedHelpMessage when using {unified} tags in the help template ([cbea3d5a](https://github.com/kbknapp/clap-rs/commit/cbea3d5acf3271a7a734498c4d99c709941c331e), 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 ([f9b0d657](https://github.com/kbknapp/clap-rs/commit/f9b0d657835d3f517f313d70962177dc30acf4a7))
+* **README.md:**
+  *  added a warning about using ~ deps ([821929b5](https://github.com/kbknapp/clap-rs/commit/821929b51bd60213955705900a436c9a64fcb79f), closes [#964](https://github.com/kbknapp/clap-rs/issues/964))
+  *  added a warning about using ~ deps ([667697b0](https://github.com/kbknapp/clap-rs/commit/667697b0018369b71da41d02d567ab57df0f4887))
+* **clap_app!:**  adds using the @group specifier to the macro docs ([826048cb](https://github.com/kbknapp/clap-rs/commit/826048cb3cbc0280169303f1498ff0a2b7395883), closes [#932](https://github.com/kbknapp/clap-rs/issues/932))
+
+
+
 <a name="v2.24.2"></a>
 ### v2.24.2 (2017-05-15)
 
diff --git a/Cargo.toml b/Cargo.toml
index ceb927ab..60cc1633 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,7 +1,7 @@
 [package]
 
 name = "clap"
-version = "2.24.2"
+version = "2.25.0"
 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 2e91b05c..a433baf9 100644
--- a/README.md
+++ b/README.md
@@ -45,7 +45,13 @@ Created by [gh-md-toc](https://github.com/ekalinin/github-markdown-toc)
 
 ## What's New
 
-Here's the highlights for v2.24.2
+Here's the highlights for v2.25.0
+
+* use textwrap crate for wrapping help texts 
+* suggests to use flag after subcommand when applicable 
+* Bumps bitflags crate to v0.9
+
+Here's the highlights for v2.21.0 to 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 
@@ -53,9 +59,6 @@ Here's the highlights for v2.24.2
 * **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