diff --git a/CHANGELOG.md b/CHANGELOG.md
index 434c8fe..95278ae 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,16 @@
 # Change Log
 
+## [0.2.3] - 2024-06-25
+
+- `parsers` module:
+    * `inet_addr` compatible parser
+    * parser combinators to build custom parsing
+    * "short IPv4 address" parser (incompatible with `inet_addr`).
+- short IPv4 address support in `FromStr` implementations is deprecated and
+  going to be removed in 0.3.0
+- `no_unsafe` feature to use safe but slower fallbacks
+- `overflowing_add` and `overflowing_sub` methods on `Inet` types
+
 ## [0.2.2] - 2023-06-25
 
 - Make all functions const if possible
@@ -29,3 +40,4 @@
 [0.2.0]: https://github.com/stbuehler/rust-cidr/compare/cidr-0.1.1...cidr-0.2.0
 [0.2.1]: https://github.com/stbuehler/rust-cidr/compare/cidr-0.2.0...cidr-0.2.1
 [0.2.2]: https://github.com/stbuehler/rust-cidr/compare/cidr-0.2.1...cidr-0.2.2
+[0.2.3]: https://github.com/stbuehler/rust-cidr/compare/cidr-0.2.2...cidr-0.2.3
diff --git a/Cargo.toml b/Cargo.toml
index 2a7a9a3..bdaf593 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -1,7 +1,7 @@
 [package]
 name = "cidr"
 # also bump version in html_root_url in src/lib.rs
-version = "0.2.2"
+version = "0.2.3"
 edition = "2018"
 authors = ["Stefan Bühler <stbuehler@web.de>"]
 description = "IP network and IP host within network types"
diff --git a/src/lib.rs b/src/lib.rs
index c914fcf..a3a4fe1 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -3,7 +3,7 @@
 #![cfg_attr(feature = "no_unsafe", forbid(unsafe_code))]
 #![warn(missing_docs)]
 #![warn(rust_2018_idioms)]
-#![doc(html_root_url = "https://docs.rs/cidr/0.2.2")]
+#![doc(html_root_url = "https://docs.rs/cidr/0.2.3")]
 #![allow(clippy::match_like_matches_macro)]
 
 //! This library provides types to represent an IP network ([`Cidr`]) or
@@ -12,7 +12,8 @@
 //! The naming follows the names of the [PostgreSQL data types](https://www.postgresql.org/docs/current/static/datatype-net-types.html)
 //!
 //! Address parsing also accepts IPv4 address with less than four octets
-//! (but always parses those as decimal).
+//! (but always parses those as decimal); this is deprecated and will be
+//! removed in 0.3.0.
 //!
 //! If the `#` flag is used with the `Display` formatting (i.e. `{:#}`) the
 //! prefix will be shown even for host addresses (added in `0.1.1`).