[uima-uimaj] 01/01: [UIMA-6329] UIMA Java SDK 3.2.0 release

[re...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

rec pushed a commit to branch UIMA-6329-UIMA-Java-SDK-3.2.0-release
in repository https://gitbox.apache.org/repos/asf/uima-uimaj.git

commit 88aad59ab5b1a2945ec69c1c05720136f1a0c089
Author: Richard Eckart de Castilho <re...@apache.org>
AuthorDate: Fri Mar 5 16:12:58 2021 +0100

    [UIMA-6329] UIMA Java SDK 3.2.0 release
    
    - Update README file for release
    - Update RELEASE_NOTES.html for release
    - Update Jira version in pom.xml for release
    - Removed Maven deploy configuration which is already included in parent POM 14
---
 README               |  3 +-
 RELEASE_NOTES.html   | 90 ++++++++++++++++++++++++++++++++++++++++++++--------
 pom.xml              | 31 +++++++++---------
 uimaj-parent/pom.xml | 15 +--------
 4 files changed, 95 insertions(+), 44 deletions(-)

diff --git a/README b/README
index 7e5de6e..cc79858 100644
--- a/README
+++ b/README
@@ -47,7 +47,8 @@ Supported Platforms
 
 Apache UIMA v3.0.0 and later requires Java version 8; it has been tested with Java 11 and Java 8.
 
-Running the Eclipse plugin tooling for UIMA requires you start Eclipse using a Java 8 or later.
+Running the Eclipse plugin tooling for UIMA requires you start Eclipse using a Java 11 or later
+(Java 8 may work but is no longer supported by recent Eclipse versions).
 
 Running the migration tool on class files requires running with a Java JDK, not a Java JRE.
 
diff --git a/RELEASE_NOTES.html b/RELEASE_NOTES.html
index 7595c28..964979b 100644
--- a/RELEASE_NOTES.html
+++ b/RELEASE_NOTES.html
@@ -20,10 +20,10 @@
    -->
 <html>
 <head>
-  <title>Apache UIMA v3.1.0 Release Notes</title>
+  <title>Apache UIMA v3.2.0 Release Notes</title>
 </head>
 <body>
-<h1>Apache UIMA (Unstructured Information Management Architecture) v3.1.0 Release Notes</h1>
+<h1>Apache UIMA (Unstructured Information Management Architecture) v3.2.0 Release Notes</h1>
 
 <h2>Contents</h2>
 <p>
@@ -33,7 +33,7 @@
 <a href="#report.issues">How to Report Issues</a><br/>
 <a href="#list.issues">List of JIRA Issues Fixed in this Release</a><br/>
 </p>  
-        
+
 <h2><a id="what.is.uima">What is UIMA?</a></h2>
 
      <p>
@@ -79,21 +79,85 @@
 				for Perl, Python and TCL.
 			</p>
 
-<h2><a id="major.changes">Major Changes in this Release</a></h2>
-
-<p>Version 3.1.1 is a minor update to 3.1.0.
-</p>
+<h2><a id="major.changes">Notable changes in this release</a></h2>
 
-<p>Specific changes in release 3.1.1 versus 3.1.0 include</p>
 <ul>
-  <li>Migrated to Git from SVN, updated poms to reflect this</li>
-  <li>Fixed a performance bug when working with 100's of CASs with the same type system</li>
+  <li>Added AnnotationPredicates utility class providing various predicates testing how annotations
+      relate to each other (e.g. covering, being covered by, following, preceding, etc.)</li>
+  <li>Added single-int arg version of select.startAt()</li>
+  <li>Added trim method to AnnotationFS</li>
+  <li>Added ability to serialize as XMIs as XML 1.1</li>
+  <li>Added typed parameter support to PEARs</li>
+  <li>Improve performance of setting up JCas classes by reducing sync lock contention</li>
+  <li>Improved speed of constructing aggregate engines</li>
+  <li>Fixed de-serialization of array subtypes in form 6 binary CASes</li>
+  <li>Fixed parameter-fetching methods PearSpecifier_impl not returning null because they promise not to</li>
+  <li>Fixed logs being spammed with "Import by location/name..." messages</li>
+  <li>Fixed numerous bugs and inconsistencies in the SelectFS implementation</li>
+  <li>Fixed CAS-transportable Java objects not being properly deserialized</li>
+  <li>Fixed FSArray.spliterator() to work in PEAR scenarios</li>
+  <li>Fixed memory leak in FSClassRegistry in scenarios with large numbers of dynamically created classloaders</li>
+  <li>Fixed oddball "race" condition when initializing JCas classes</li>
+  <li>Fixed problem when reading mixed sets of binary CASes from UIMAv2 and UIMAv3</li>
+  <li>Fixed IndexOutOfBoundsException in CVD</li>
+  <li>Fixed bug causing Annotation to be returned when asking JCas for a specific type</li>
+  <li>Fixed ability to install PEARs into directories containing XML special characters in the name</li>
+  <li>Fixed not-indexed document annotation being wrongly added back to the index during de-serialization</li>
+  <li>Fixed index protection for cases that no FSes were indexed</li>
+  <li>Fixed concurrent binary serialization producing corrupt output</li>
+  <li>Fixed deep cloning of AnalysisEngineDescription</li>
+  <li>No longer ship Pack200-compressed versions of the Eclipse plugins</li>
+  <li>Converted UIMAv3 User's Guide from DocBook to Asciidoc</li>
 </ul>
  
 <h3>API changes</h3>
 
- <p>None this release.
- </p>
+<h4>SelectFS API with zero-width annotations</h4>
+
+<p>The behavior of the selectFS API changes in this release, in particular with respect to the 
+handling of zero-width annotations (those that have the same start and end position). The behavior
+has been made to align with the new annotation predicates, the details of which are described in the
+UIMAv3 User's Guide.
+</p>
+
+<h4>SelectFS API with negative shift on bounded selections</h4>
+
+<p>The <code>shifted</code> operation can no longer be used to expand a selection beyond its
+selection boundaries. Consider the following example:<p>
+
+<pre><code>
+t1 = new Token(0,1)
+t2 = new Token(2,3)
+t3 = new Token(4,5)
+t4 = new Token(6,7)
+t5 = new Token(8,9)
+</code></pre>
+
+<p>In previous versions, was also possible to use a negative shift with a bounding operator such as
+<code>following</code>, <code>coveredBy</code>, etc. and it would call <code>moveToPrevious</code>
+on the internal iterator of the selection operation, causing it to return annotations occurring
+before the bounds e.g.:
+
+<pre><code>
+select().shifted(-1).following(t3) => {t3, t4, t5}
+</code></pre>
+
+<p>This was found to be inconsistent behavior. The iterator used for the selection (which can also be 
+obtained by calling <code>fsIterator()</code>) should respect the bounds.</p>
+
+<p>As of this UIMA version, using <code>shifted</code> with a negative argument in conjunction with
+a bounding operator will trigger a warning in the logs and return an empty result.</p>
+
+<pre><code>
+select().shifted(-1).following(t3) => {}
+select().following(t3) => {t4, t5}
+</code></pre>
+
+<h4>SelectFS API with Backwards selection with startAt</h4>
+
+<p>In previous versions, the using the <code>moveTo</code> operation backwards iterators obtained
+through <code>SelectFSs</code> did never ignore type priorities - even though <code>SelectFSs</code>
+by default should ignore them.</p>
  
 <h2><a id="list.issues">Full list of JIRA Issues affecting this Release</a></h2>
 Click <a href="issuesFixed/jira-report.html">issuesFixed/jira-report.hmtl</a> for the list of 
@@ -118,7 +182,5 @@ The Apache UIMA project uses JIRA for issue tracking.  Please report any
 issues you find at 
 <a href="http://issues.apache.org/jira/browse/uima">http://issues.apache.org/jira/browse/uima</a>
 </p>
-  
-    
 </body>
 </html>
\ No newline at end of file
diff --git a/pom.xml b/pom.xml
index 989d32f..5dba25b 100644
--- a/pom.xml
+++ b/pom.xml
@@ -36,7 +36,7 @@
   <artifactId>uimaj</artifactId>
   <packaging>pom</packaging>
   <name>Apache UIMA Java SDK: ${project.artifactId}</name>
-  <description>The top project for the uimaj SDK</description>
+  <description>The top project for the UIMA Java SDK</description>
   <url>${uimaWebsiteUrl}</url>
 
   <!-- Special inheritance note
@@ -62,7 +62,7 @@
 
   <properties>
     <uimaScmProject>${project.artifactId}</uimaScmProject>
-    <jiraVersion>3.1.1SDK</jiraVersion>   
+    <jiraVersion>3.2.0SDK</jiraVersion>   
     <assemblyFinalName>uimaj-${project.version}</assemblyFinalName> 
     <assemblyBinDescriptor>src/main/assembly/bin-without-jackson.xml</assemblyBinDescriptor> 
     <postNoticeText>${ibmNoticeText}</postNoticeText>    
@@ -272,18 +272,18 @@
     
       <plugin> 
         <artifactId>maven-assembly-plugin</artifactId>
-          <executions>
-            <execution>
-              <id>uima-distr</id>
-                <configuration>
-                  <descriptors>
-                    <descriptor>${assemblyBinDescriptor}</descriptor>
-                  </descriptors>
-                </configuration>              
-              </execution>
-            </executions>
-          </plugin>
-       </plugins>
+        <executions>
+          <execution>
+            <id>uima-distr</id>
+            <configuration>
+              <descriptors>
+                <descriptor>${assemblyBinDescriptor}</descriptor>
+              </descriptors>
+            </configuration>
+          </execution>
+        </executions>
+      </plugin>
+   </plugins>
   
     <pluginManagement>
       <plugins>
@@ -373,7 +373,8 @@
     <profile>
       <id>json-support</id>
       <activation>
-        <file><exists>pom.xml</exists></file>  <!-- active by default, turn off via command line -P!json-support  -->
+        <!-- active by default, turn off via command line -P!json-support  -->
+        <file><exists>pom.xml</exists></file>
       </activation>
       <properties>
         <assemblyBinDescriptor>src/main/assembly/bin.xml</assemblyBinDescriptor>  
diff --git a/uimaj-parent/pom.xml b/uimaj-parent/pom.xml
index 685e7c8..2dd1697 100644
--- a/uimaj-parent/pom.xml
+++ b/uimaj-parent/pom.xml
@@ -217,19 +217,6 @@
         </executions>
       </plugin>
     </plugins>
-  
-    <pluginManagement>
-      <plugins>
-        <!-- https://issues.apache.org/jira/browse/UIMA-5367 -->
-        <plugin> 
-          <groupId>org.apache.maven.plugins</groupId> 
-          <artifactId>maven-deploy-plugin</artifactId>
-          <configuration> 
-            <retryFailedDeploymentCount>10</retryFailedDeploymentCount> 
-          </configuration> 
-        </plugin>
-      </plugins>
-    </pluginManagement>
   </build>
   
   <profiles>
@@ -262,7 +249,7 @@
       </activation>
       <build>
         <pluginManagement>
-          <plugins>         
+          <plugins>
             <!-- This plugin's configuration is used to store Eclipse m2e settings 
                 only. It has no influence on the Maven build itself. -->
             <plugin>