Docs: (Caching) Fix and clarify

README.org

@@ -305,9 +305,9 @@ The variable =org-ql-block-header= may be bound to a string to use as the block
 
 **** Caching
 
-Org QL uses a per-buffer cache to speed up subsequent searches.  It's keyed on query expressions, which means that, for the same query in the same buffer, if the buffer has not been modified since the last time the query was run, the cached result will be returned, and the query will not be evaluated in that buffer again.
+Org QL uses a per-buffer cache to speed up subsequent searches.  It's keyed on query expressions and match actions, which means that, for the same query and same match action in the same buffer, if the buffer has not been modified since the last time the query was run, the cached match-action result will be returned, and the query will not be evaluated in that buffer again.
 
-Therefore, since query expressions are not guaranteed to be evaluated when these functions are called, they should be free of side effects.  Any side effects should be done in the action expression instead.
+Therefore, since neither query expressions nor match actions are guaranteed to be evaluated when the following functions are called, they should be free of side effects.  Or, if a side effect is required, the cache should be invalidated (e.g. by incrementing the buffer's modified tick, or by using a query expression or match action that has yet to be cached).  /Note: Future improvements will allow the cache to be more easily disabled or cleared./
 
 **** Function: ~org-ql-select~
 

org-ql.info

@@ -617,15 +617,19 @@ File: README.info,  Node: Listing / acting-on results,  Next: Custom predicates,
   1. Caching
 
      Org QL uses a per-buffer cache to speed up subsequent searches.
-     It’s keyed on query expressions, which means that, for the same
-     query in the same buffer, if the buffer has not been modified since
-     the last time the query was run, the cached result will be
-     returned, and the query will not be evaluated in that buffer again.
+     It’s keyed on query expressions and match actions, which means
+     that, for the same query and same match action in the same buffer,
+     if the buffer has not been modified since the last time the query
+     was run, the cached match-action result will be returned, and the
+     query will not be evaluated in that buffer again.
 
-     Therefore, since query expressions are not guaranteed to be
-     evaluated when these functions are called, they should be free of
-     side effects.  Any side effects should be done in the action
-     expression instead.
+     Therefore, since neither query expressions nor match actions are
+     guaranteed to be evaluated when the following functions are called,
+     they should be free of side effects.  Or, if a side effect is
+     required, the cache should be invalidated (e.g.  by incrementing
+     the buffer’s modified tick, or by using a query expression or match
+     action that has yet to be cached).  _Note: Future improvements will
+     allow the cache to be more easily disabled or cleared._
 
   2. Function: ‘org-ql-select’
 
@@ -1457,35 +1461,35 @@ Node: Date/time predicates17382
 Node: Functions / Macros20037
 Node: Agenda-like views20335
 Node: Listing / acting-on results21740
-Node: Custom predicates26961
-Node: Dynamic block30452
-Node: Links33150
-Node: Tips33837
-Node: Changelog34155
-Node: 06-pre34851
-Node: 0535291
-Node: 04936768
-Node: 04837042
-Node: 04737389
-Node: 04637784
-Node: 04538184
-Node: 04438543
-Node: 04338900
-Node: 04239095
-Node: 04139256
-Node: 0439497
-Node: 03243430
-Node: 03143809
-Node: 0344006
-Node: 02346981
-Node: 02247209
-Node: 02147477
-Node: 0247676
-Node: 0151711
-Node: Notes51812
-Node: Comparison with Org Agenda searches51974
-Node: org-sidebar52846
-Node: License53125
+Node: Custom predicates27281
+Node: Dynamic block30772
+Node: Links33470
+Node: Tips34157
+Node: Changelog34475
+Node: 06-pre35171
+Node: 0535611
+Node: 04937088
+Node: 04837362
+Node: 04737709
+Node: 04638104
+Node: 04538504
+Node: 04438863
+Node: 04339220
+Node: 04239415
+Node: 04139576
+Node: 0439817
+Node: 03243750
+Node: 03144129
+Node: 0344326
+Node: 02347301
+Node: 02247529
+Node: 02147797
+Node: 0247996
+Node: 0152031
+Node: Notes52132
+Node: Comparison with Org Agenda searches52294
+Node: org-sidebar53166
+Node: License53445
 
 End Tag Table