svn commit: r1660704 - /uima/uimaj/trunk/RELEASE_NOTES.html

[sc...@apache.org]

Author: schor
Date: Wed Feb 18 19:31:39 2015
New Revision: 1660704

URL: http://svn.apache.org/r1660704
Log:
no Jira - clarify in the RELEASE_NOTES that ConcurrentModificationExceptions can be caused by the automatic index protection mechanism, and what to do about it.

Modified:
    uima/uimaj/trunk/RELEASE_NOTES.html

Modified: uima/uimaj/trunk/RELEASE_NOTES.html
URL: http://svn.apache.org/viewvc/uima/uimaj/trunk/RELEASE_NOTES.html?rev=1660704&r1=1660703&r2=1660704&view=diff
==============================================================================
--- uima/uimaj/trunk/RELEASE_NOTES.html (original)
+++ uima/uimaj/trunk/RELEASE_NOTES.html Wed Feb 18 19:31:39 2015
@@ -132,6 +132,11 @@ the sorted and bag indexes. this change
   <a target="_blank" href=
   "http://uima.apache.org/d/uimaj-2.7.0/references.html#ugr.ref.cas.updating_indexed_feature_structures">
   CAS Reference Chapter</a> and the CAS Javadocs; you can also use it with the JCas.</p>
+  
+  <p>Because this protection is automatic and hidden, if you are iterating over sorted or set indexes, the
+  automatic recovery may cause unexpected ConcurrentModificationExceptions to be thrown by the iterator when
+  advancing. To work around this, either stop modifying features which are used as keys in the index being iterated over,
+  or use Snapshot iterators (see following).</p>
 
 <h3>New Snapshot iterators won't throw ConcurrentModificationException</h3>
 <p>A long-standing difficulty with Feature Structure iterators, namely, that adding to / removing from the underlying