svn commit: r1781183 - in /uima/uimaj/branches/experiment-v3-jcas/uima-docbook-v3-users-guide/src: docbook/ docbook/images/version_3_users_guide/custom_java_objects/ image-source/

[sc...@apache.org]

Author: schor
Date: Tue Jan 31 22:40:20 2017
New Revision: 1781183

URL: http://svn.apache.org/viewvc?rev=1781183&view=rev
Log:
no Jira, fix some formatting, clarify a few things.

Modified:
    uima/uimaj/branches/experiment-v3-jcas/uima-docbook-v3-users-guide/src/docbook/images/version_3_users_guide/custom_java_objects/5_steps.png
    uima/uimaj/branches/experiment-v3-jcas/uima-docbook-v3-users-guide/src/docbook/uv3.backwards_compatibility.xml
    uima/uimaj/branches/experiment-v3-jcas/uima-docbook-v3-users-guide/src/docbook/uv3.custom_java_objects.xml
    uima/uimaj/branches/experiment-v3-jcas/uima-docbook-v3-users-guide/src/docbook/uv3.migration.aids.xml
    uima/uimaj/branches/experiment-v3-jcas/uima-docbook-v3-users-guide/src/image-source/source.pptx

Modified: uima/uimaj/branches/experiment-v3-jcas/uima-docbook-v3-users-guide/src/docbook/images/version_3_users_guide/custom_java_objects/5_steps.png
URL: http://svn.apache.org/viewvc/uima/uimaj/branches/experiment-v3-jcas/uima-docbook-v3-users-guide/src/docbook/images/version_3_users_guide/custom_java_objects/5_steps.png?rev=1781183&r1=1781182&r2=1781183&view=diff
==============================================================================
Binary files - no diff available.

Modified: uima/uimaj/branches/experiment-v3-jcas/uima-docbook-v3-users-guide/src/docbook/uv3.backwards_compatibility.xml
URL: http://svn.apache.org/viewvc/uima/uimaj/branches/experiment-v3-jcas/uima-docbook-v3-users-guide/src/docbook/uv3.backwards_compatibility.xml?rev=1781183&r1=1781182&r2=1781183&view=diff
==============================================================================
--- uima/uimaj/branches/experiment-v3-jcas/uima-docbook-v3-users-guide/src/docbook/uv3.backwards_compatibility.xml (original)
+++ uima/uimaj/branches/experiment-v3-jcas/uima-docbook-v3-users-guide/src/docbook/uv3.backwards_compatibility.xml Tue Jan 31 22:40:20 2017
@@ -97,7 +97,8 @@ under the License.
   <section id="uv3.backards_compatibility.low_level_apis">
     <title>APIs for creating and modifying Feature Structures</title>
     
-    <para>There are 3 sets of APIs for creating and modifying Feature Structures.
+    <para>There are 3 sets of APIs for creating and modifying Feature Structures;
+      all are supported in V3.
     <itemizedlist spacing="compact">
       <listitem>
         <para>Using the JCas classes</para>
@@ -113,10 +114,10 @@ under the License.
     
     <para>Version 3 retains all 3 sets, to enable backward compatibility.</para>
     <para>The low level CAS interface was originally provided to enable a extra-high-performance
-      (but without type safety checks) mode.  In Version 3, this mode is actually somewhat slower than the others,
-      and no longer has any advantages.      
+      (but without compile-time type safety checks) mode.  
+      In Version 3, this mode is actually somewhat slower than the others, and no longer has any advantages.      
     </para>
-    <para>Using the low level CAS interface also blocks one of the new features of Version 3 - namely, automatic
+    <para>Using the low level CAS interface also sometimes blocks one of the new features of Version 3 - namely, automatic
     garbage collection of unreachable Feature Structures.  This is because creating a Feature Structure using the
     low level API creates the Java object for that Feature Structure, but returns an "int" handle to it.  
     In order to be able to find the Feature Structure, given that int handle, an entry is made in an internal map.

Modified: uima/uimaj/branches/experiment-v3-jcas/uima-docbook-v3-users-guide/src/docbook/uv3.custom_java_objects.xml
URL: http://svn.apache.org/viewvc/uima/uimaj/branches/experiment-v3-jcas/uima-docbook-v3-users-guide/src/docbook/uv3.custom_java_objects.xml?rev=1781183&r1=1781182&r2=1781183&view=diff
==============================================================================
--- uima/uimaj/branches/experiment-v3-jcas/uima-docbook-v3-users-guide/src/docbook/uv3.custom_java_objects.xml (original)
+++ uima/uimaj/branches/experiment-v3-jcas/uima-docbook-v3-users-guide/src/docbook/uv3.custom_java_objects.xml Tue Jan 31 22:40:20 2017
@@ -165,6 +165,9 @@ public void _save_to_cas_data() {
     </variablelist>
     </para>
     
+    <para>For custom types which hold collections of Feature Structures, you can have those participate in the 
+       <code>Select</code> framework, by implementing the optional Interface <code>SelectViaCopyToArray</code>.</para>
+       
     <para>For more examples, please see the implementations of the built-in classes described in the
     following section.</para>
   </section>

Modified: uima/uimaj/branches/experiment-v3-jcas/uima-docbook-v3-users-guide/src/docbook/uv3.migration.aids.xml
URL: http://svn.apache.org/viewvc/uima/uimaj/branches/experiment-v3-jcas/uima-docbook-v3-users-guide/src/docbook/uv3.migration.aids.xml?rev=1781183&r1=1781182&r2=1781183&view=diff
==============================================================================
--- uima/uimaj/branches/experiment-v3-jcas/uima-docbook-v3-users-guide/src/docbook/uv3.migration.aids.xml (original)
+++ uima/uimaj/branches/experiment-v3-jcas/uima-docbook-v3-users-guide/src/docbook/uv3.migration.aids.xml Tue Jan 31 22:40:20 2017
@@ -44,7 +44,7 @@ under the License.
     using -Dxxxxxx, where the xxxxxx is one of
     the properties starting with <code>uima.</code> from the table below.</para>  
     <informaltable frame="all" rowsep="1" colsep="1">
-     <tgroup cols="3">
+     <tgroup cols="2">
        <colspec colnum="1" colname="Title" colwidth="1*"/>
        <colspec colnum="2" colname="Description" colwidth="3*"/>
        

Modified: uima/uimaj/branches/experiment-v3-jcas/uima-docbook-v3-users-guide/src/image-source/source.pptx
URL: http://svn.apache.org/viewvc/uima/uimaj/branches/experiment-v3-jcas/uima-docbook-v3-users-guide/src/image-source/source.pptx?rev=1781183&r1=1781182&r2=1781183&view=diff
==============================================================================
Binary files - no diff available.