Author: schor
Date: Wed Jul 25 20:27:26 2018
New Revision: 1836668
URL: http://svn.apache.org/viewvc?rev=1836668&view=rev
Log:
[UIMA-5845] make select get/single have consistent return or throw for
get/single when nothing is found, based on setting of nullOK(). Clarify
javadocs
Modified:
uima/uv3/uimaj-v3/trunk/uima-docbook-v3-users-guide/src/docbook/uv3.select.xml
Modified:
uima/uv3/uimaj-v3/trunk/uima-docbook-v3-users-guide/src/docbook/uv3.select.xml
URL:
http://svn.apache.org/viewvc/uima/uv3/uimaj-v3/trunk/uima-docbook-v3-users-guide/src/docbook/uv3.select.xml?rev=1836668&r1=1836667&r2=1836668&view=diff
==============================================================================
---
uima/uv3/uimaj-v3/trunk/uima-docbook-v3-users-guide/src/docbook/uv3.select.xml
(original)
+++
uima/uv3/uimaj-v3/trunk/uima-docbook-v3-users-guide/src/docbook/uv3.select.xml
Wed Jul 25 20:27:26 2018
@@ -336,7 +336,7 @@ FSIterator<Token> token_iterator =
<varlistentry>
<term><emphasis role="strong">nullOk</emphasis></term>
<listitem>
- <para>changes the behavior for some terminal_form actions, which
would otherwise
+ <para>changes the behavior for the terminal_form actions
<code>get(...) and single(...)</code>, which would otherwise
throw an exception if a null result happened.
</para>
</listitem>
@@ -774,7 +774,7 @@ startAt(begin, end, shifted) // same as
<varlistentry>
<term><emphasis role="strong">get</emphasis></term>
<listitem>
- <para>If no argument is specified, then returns the first item, or
null. If nullOk(false) is configured,
+ <para>If no argument is specified, then returns the first item.
If nullOk(false) is configured,
then if the result is null, an exception will be thrown.
</para>
<para>If any positioning arguments are specified, then this
returns the item at that position unless
