diff --git a/README.md b/README.md
index 90e0f599..e74653c0 100644
--- a/README.md
+++ b/README.md
@@ -420,10 +420,11 @@ similar to [Semantic Versioning](https://semver.org/), as follows:
while remaining backwards compatible in as many cases as possible
(eg. major version 11 may have slightly different public API than major version 10).
-**CAVEAT:** any function, class, constant or other code _not_ explicitly described
-in the public API documentation is considered as part of the underlying internal
-implementation details, and may change or be removed without notice.
-(In other words, don't use internal functionality).
+**CAVEAT:**
+the above policy applies only to the public API described in the documentation.
+Any functionality within Armadillo which is _not explicitly_ described
+in the public API documentation is considered as internal implementation details,
+and may be changed or removed without notice.
---
diff --git a/docs.html b/docs.html
index f7ace51c..d93d51e1 100644
--- a/docs.html
+++ b/docs.html
@@ -19727,9 +19727,10 @@ However, to allow evolution, the public API may be altered in future major versi
-Caveat: any function, class, constant or other code not explicitly described in the public API documentation is considered as part of the underlying internal implementation details,
-and may be removed or changed without notice.
-(In other words, don't use internal functionality).
+Caveat:
+the above policy applies only to the public API described in the documentation.
+Any functionality within Armadillo which is not explicitly described in the public API documentation is considered as internal implementation details,
+and may be changed or removed without notice.