--- a/doc/libervia-cli/pubsub_cache.rst	Wed Sep 08 17:58:48 2021 +0200
+++ b/doc/libervia-cli/pubsub_cache.rst	Wed Sep 08 17:58:48 2021 +0200
@@ -90,6 +90,16 @@
 from cache. After this command, cache will be re-filled progressively as if it where a new
 one.
 
+.. note::
+
+    Use this command with caution: even if cache will be re-constructed with time, that
+    means that items will have to be retrieved again, that may be resource intensive both
+    for your machine and for the pubsub services which will be used. That also means that
+    searching items will return less results until all desired items are cached again.
+
+    Also note that all items of cached nodes are retrieved, even if you have previously
+    purged items, they will be retrieved again.
+
 example
 -------