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