diff --git a/docs/usermanual-object-model.xml b/docs/usermanual-object-model.xml
index 74986dbf1..52db7fb9a 100644
--- a/docs/usermanual-object-model.xml
+++ b/docs/usermanual-object-model.xml
@@ -69,6 +69,9 @@
After construction, each object's properties are accessible only
through the setter and getter functions described in the API
Reference manual.
+
+ Note that many object types can be marked as read-only or immutable,
+ facilitating their use in multi-threaded environments.
Key object types provided by HarfBuzz include:
@@ -253,6 +256,10 @@
about freeing memory and let the reference-counting machinery
take care of that.
+
+ Most of the time, blobs are read-only, facilitating their use in
+ immutable objects.
+