document some CAS serialization are synchronized
for operations that make use of data structures for building serialized
forms that are part of the CAS's svd.
@@ -729,6 +729,10 @@ ae.destroy();</programlisting></para>
<para>Several of the APIs use or return instances of <code>SerialFormat</code>, which is an enum specifying the various
forms of serialization.</para>
+
+ <para>Serialization often makes use of temporary extra data structures, anchored from the CAS being serialized.
+ These are read/write, and because of this, most serializations are synchronized to prevent multiple
+ serializations of the same CAS from happening in parallel.</para>
</section>
</section>
