From richfaces-svn-commits at lists.jboss.org Thu Apr  7 03:08:48 2011
Content-Type: multipart/mixed; boundary="===============6166508550410629410=="
MIME-Version: 1.0
From: richfaces-svn-commits at lists.jboss.org
To: richfaces-svn-commits at lists.jboss.org
Subject: [richfaces-svn-commits] JBoss Rich Faces SVN: r22387 -
 modules/docs/trunk/Component_Reference/src/main/docbook/en-US.
Date: Thu, 07 Apr 2011 03:08:48 -0400
Message-ID: <201104070708.p3778mMP028328@svn01.web.mwc.hst.phx2.redhat.com>

--===============6166508550410629410==
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable

Author: SeanRogers
Date: 2011-04-07 03:08:48 -0400 (Thu, 07 Apr 2011)
New Revision: 22387

Modified:
   modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Compo=
nent_Reference-Rich_inputs.xml
Log:
Added information on autocomplete tokens: RFPL-1228

Modified: modules/docs/trunk/Component_Reference/src/main/docbook/en-US/cha=
p-Component_Reference-Rich_inputs.xml
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
--- modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Comp=
onent_Reference-Rich_inputs.xml	2011-04-07 06:21:49 UTC (rev 22386)
+++ modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Comp=
onent_Reference-Rich_inputs.xml	2011-04-07 07:08:48 UTC (rev 22387)
@@ -139,6 +139,15 @@
 			<para>
 				Setting <code><varname>autoFill</varname>=3D"true"</code> causes the c=
ombo-box to fill the text field box with a matching suggestion as the user =
types.
 			</para>
+			<para>
+				To allow users to enter multiple values separated by specific characte=
rs, use the <varname>tokens</varname> attribute. As the user types, a sugge=
stion will present as normal. When they enter a character specified as a to=
ken, this begins a new suggestion process, and the component only uses text=
 entered after the token character for suggestions. For example, if <code>t=
okens=3D", "</code> is set, the <sgmltag>&lt;rich:autocomplete&gt;</sgmltag=
> component uses both the comma and space characters as tokens to separate =
entries. When the user enters a comma or a space, a new suggestion process =
begins.
+			</para>
+			<note>
+				<title>Using tokens</title>
+				<para>
+					When declaring tokens, avoid using any characters that are present in=
 the list of suggestions. This may cause unexpected behavior as the user ex=
pects the character to match suggestions instead of separating suggested en=
tries.
+				</para>
+			</note>
 		</section>
 =

 		<section id=3D"sect-Component_Reference-richautocomplete-Customizing_the=
_filter_in_client_and_lazyClient_modes">


--===============6166508550410629410==--