X-Git-Url: http://git.kpe.io/?a=blobdiff_plain;f=doc%2Fref-oodml.xml;h=8a3423557fed74a5162c78cc8cdbccd7db1d6d41;hb=679cae55538822bba04c8d30de747826ffc59eae;hp=50139a6288904b1c058a15f47d98c950ef9719e1;hpb=243188d5a588c42c3882846ab373d055da7a22e3;p=clsql.git
diff --git a/doc/ref-oodml.xml b/doc/ref-oodml.xml
index 50139a6..8a34235 100644
--- a/doc/ref-oodml.xml
+++ b/doc/ref-oodml.xml
@@ -972,9 +972,11 @@ Details for Vladimir Lenin have been updated from the database.
slots
-
- A list of slot names in object or &t;.
-
+ * :immediate (default) - refresh join slots with :retrieval :immediate
+ * :deferred - refresh join slots created with :retrieval :deferred
+ * :all,t - refresh all join slots regardless of :retrieval
+ * list of symbols - which explicit slots to refresh
+ * a single symobl - what slot to refresh
@@ -1000,6 +1002,9 @@ Details for Vladimir Lenin have been updated from the database.
A non-negative integer or &nil; defaulting to
*default-update-objects-max-len*.
+ When non-nil this is essentially a batch size for the max number of objects
+ to query from the database at a time. If we need more than max-len
+ we loop till we have all the objects
@@ -1007,25 +1012,15 @@ Details for Vladimir Lenin have been updated from the database.
Description
- Updates from the records of the appropriate database
- tables the join slots specified by slots
- in the supplied list of View
- Class instances
- objects. slots
- when &t; means that all join slots with
- :retrieval :immediate are
- updated. class-name is used to specify
- the View Class of
- all instance in objects, when &nil; then
- the class of the first instance in
- objects is
- used. force-p when &t; means that all
- join slots are updated whereas a value of &nil; means that only
- unbound join slots are updated. max-len
- when non-nil specifies that
- update-object-joins may issue multiple
- database queries with a maximum of
- max-len instances updated in each query.
+
+ Updates from the records of the appropriate database tables the join slots
+ specified by SLOTS in the supplied list of
+ View Class instances OBJECTS.
+
+ A simpler method of causing a join-slot to be requeried is to set it to
+ unbound, then request it again. This function has efficiency gains where
+ join-objects are shared among the `objects` (querying all join-objects,
+ then attaching them appropriately to each of the `objects`)