Improve wording

Signed-off-by: Dave Rodgman <>
diff --git a/docs/ b/docs/
index 49b870a..2b20b5c 100644
--- a/docs/
+++ b/docs/
@@ -12,9 +12,8 @@
 - Removal of many insecure or obsolete features
 - Tidying up of configuration options (including removing some less useful options).
-- Changing function signatures (e.g., adding return codes or extra parameters); introducing const to arguments.
-- Removal of functions marked as deprecated in 2.x
+- Changing function signatures, e.g. adding return codes, adding extra parameters, or making some arguments const.
+- Removal of functions previously marked as deprecated.
 ## Tooling