- <para>Updates from the records of the appropriate database
- tables the join slots specified by <parameter>slots</parameter>
- in the supplied list of <glossterm linkend="gloss-view-class">View
- Class</glossterm> instances
- <parameter>objects</parameter>. <parameter>slots</parameter>
- when &t; means that all join slots with
- <symbol>:retrieval</symbol> <symbol>:immediate</symbol> are
- updated. <parameter>class-name</parameter> is used to specify
- the <glossterm linkend="gloss-view-class">View Class</glossterm> of
- all instance in <parameter>objects</parameter>, when &nil; then
- the class of the first instance in
- <parameter>objects</parameter> is
- used. <parameter>force-p</parameter> when &t; means that all
- join slots are updated whereas a value of &nil; means that only
- unbound join slots are updated. <parameter>max-len</parameter>
- when non-nil specifies that
- <function>update-object-joins</function> may issue multiple
- database queries with a maximum of
- <parameter>max-len</parameter> instances updated in each query.
+ <para>
+ Updates from the records of the appropriate database tables the join slots
+ specified by SLOTS in the supplied list of
+ <glossterm linkend="gloss-view-class">View Class</glossterm> 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`)