From richfaces-svn-commits at lists.jboss.org Mon Jan 18 21:07:45 2010
Content-Type: multipart/mixed; boundary="===============0016712382569153611=="
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: r16328 -
 root/docs/trunk/Component_Reference/en-US.
Date: Mon, 18 Jan 2010 21:07:44 -0500
Message-ID: <201001190207.o0J27ii4011158@svn01.web.mwc.hst.phx2.redhat.com>

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

Author: SeanRogers
Date: 2010-01-18 21:07:44 -0500 (Mon, 18 Jan 2010)
New Revision: 16328

Modified:
   root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Commo=
n_Ajax_attributes.xml
   root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Selec=
tion_and_ordering.xml
   root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Table=
s_and_grids.xml
Log:
Completed Common Ajax Attributes, worked on Tables and Selection chapters

Modified: root/docs/trunk/Component_Reference/en-US/chap-Component_Referenc=
e-Common_Ajax_attributes.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
--- root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Comm=
on_Ajax_attributes.xml	2010-01-19 01:54:06 UTC (rev 16327)
+++ root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Comm=
on_Ajax_attributes.xml	2010-01-19 02:07:44 UTC (rev 16328)
@@ -178,42 +178,48 @@
 		<section id=3D"sect-Component_Reference-Events_and_JavaScript_interactio=
ns-onsubmit">
 			<title><varname>onsubmit</varname></title>
 			<para>
-				The <varname>onsubmit</varname> attribute will invoke the JavaScript c=
ode before the Ajax request is sent. The request is canceled if the JavaScr=
ipt code defined for <varname>onsubmit</varname> returns <literal>false</li=
teral>.
+				The <varname>onsubmit</varname> attribute invokes the JavaScript code =
<emphasis>before</emphasis> the Ajax request is sent. The request is cancel=
ed if the JavaScript code defined for <varname>onsubmit</varname> returns <=
literal>false</literal>.
 			</para>
 		</section>
 		=

-		<section id=3D"sect-Component_Reference-Events_and_JavaScript_interactio=
ns-onclick">
-			<title><varname>onclick</varname></title>
+		<section id=3D"sect-Component_Reference-Events_and_JavaScript_interactio=
ns-onbegin">
+			<title><varname>onbegin</varname></title>
 			<para>
-				The <varname>onclick</varname> attribute functions similarly to the <v=
arname>onsubmit</varname> attribute for those components that can be clicke=
d, such as <sgmltag>&lt;a4j:commandButton&gt;</sgmltag> and <sgmltag>&lt;a4=
j:commandLink&gt;</sgmltag>. It invokes the defined JavaScript before the A=
jax request, and the request will be canceled if the defined code returns <=
literal>false</literal>.
+				The <varname>onbegin</varname> attribute invokes the JavaScript code <=
emphasis>after</emphasis> the Ajax request is sent.
 			</para>
 		</section>
 		=

-		<section id=3D"sect-Component_Reference-Events_and_JavaScript_interactio=
ns-oncomplete">
-			<title><varname>oncomplete</varname></title>
+		<section id=3D"sect-Component_Reference-Events_and_JavaScript_interactio=
ns-onclick">
+			<title><varname>onclick</varname></title>
 			<para>
-				The <varname>oncomplete</varname> attribute invokes the JavaScript cod=
e after the Ajax response has been returned and the <acronym>DOM</acronym> =
tree of the browser has been updated. The code is registered for further in=
vocation of the <acronym>XMLHTTP</acronym> request object before an Ajax re=
quest is sent. As such, using <acronym>JSF</acronym> Expression Language (<=
acronym>EL</acronym>) value binding means the code will not be changed duri=
ng processing of the request on the server. Additionally the <varname>oncom=
plete</varname> attribute cannot use the <literal>this</literal> keyword as=
 it will not point to the component from which the Ajax request was initiat=
ed.
+				The <varname>onclick</varname> attribute functions similarly to the <v=
arname>onsubmit</varname> attribute for those components that can be clicke=
d, such as <sgmltag>&lt;a4j:commandButton&gt;</sgmltag> and <sgmltag>&lt;a4=
j:commandLink&gt;</sgmltag>. It invokes the defined JavaScript before the A=
jax request, and the request will be canceled if the defined code returns <=
literal>false</literal>.
 			</para>
 		</section>
 		=

-		<section id=3D"sect-Component_Reference-Events_and_JavaScript_interactio=
ns-onbegin">
-			<title><varname>onbegin</varname></title>
+		<section id=3D"sect-Component_Reference-Events_and_JavaScript_interactio=
ns-onsuccess">
+			<title><varname>onsuccess</varname></title>
 			<para>
-				Incomplete
+				The <varname>onsuccess</varname> attribute invokes the JavaScript code=
 after the Ajax response has been returned but <emphasis>before</emphasis> =
the <acronym>DOM</acronym> tree of the browser has been updated.
 			</para>
 		</section>
 		=

-		<section id=3D"sect-Component_Reference-Events_and_JavaScript_interactio=
ns-onsuccess">
-			<title><varname>onsuccess</varname></title>
+		<section id=3D"sect-Component_Reference-Events_and_JavaScript_interactio=
ns-oncomplete">
+			<title><varname>oncomplete</varname></title>
 			<para>
-				Incomplete
+				The <varname>oncomplete</varname> attribute invokes the JavaScript cod=
e after the Ajax response has been returned <emphasis>and</emphasis> the <a=
cronym>DOM</acronym> tree of the browser has been updated.
 			</para>
+			<note>
+				<title>Reference consistency</title>
+				<para>
+					The code is registered for further invocation of the <acronym>XMLHTTP=
</acronym> request object before an Ajax request is sent. As such, using <a=
cronym>JSF</acronym> Expression Language (<acronym>EL</acronym>) value bind=
ing means the code will not be changed during processing of the request on =
the server. Additionally the <varname>oncomplete</varname> attribute cannot=
 use the <literal>this</literal> keyword as it will not point to the compon=
ent from which the Ajax request was initiated.
+				</para>
+			</note>
 		</section>
 		=

 		<section id=3D"sect-Component_Reference-Events_and_JavaScript_interactio=
ns-onerror">
 			<title><varname>onerror</varname></title>
 			<para>
-				Incomplete
+				The <varname>onerror</varname> attribute invokes the JavaScript code w=
hen an error has occurred during Ajax communications.
 			</para>
 		</section>
 		=


Modified: root/docs/trunk/Component_Reference/en-US/chap-Component_Referenc=
e-Selection_and_ordering.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
--- root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Sele=
ction_and_ordering.xml	2010-01-19 01:54:06 UTC (rev 16327)
+++ root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Sele=
ction_and_ordering.xml	2010-01-19 02:07:44 UTC (rev 16328)
@@ -4,14 +4,17 @@
 <chapter id=3D"chap-Component_Reference-Selection_and_ordering">
 	<title>Selection and ordering</title>
 	<para>
-		Incomplete
+		This chapter describes those components used for the selection and order=
ing of objects in lists.
 	</para>
 	=

 	<section id=3D"sect-Component_Reference-Trees-richlistShuttle">
 		<title>rich:listShuttle</title>
 		<para>
-			Incomplete
+			The <sgmltag>&lt;rich:listShuttle&gt;</sgmltag> component is used for m=
oving select items from one list into another. Items can optionally be re-o=
rdered. It supports selection of multiple items, keyboard usage, and a cust=
omizable look and feel.
 		</para>
+		<para>
+			=

+		</para>
 	</section>
 	=

 	<section id=3D"sect-Component_Reference-Trees-richorderingList">

Modified: root/docs/trunk/Component_Reference/en-US/chap-Component_Referenc=
e-Tables_and_grids.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
--- root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Tabl=
es_and_grids.xml	2010-01-19 01:54:06 UTC (rev 16327)
+++ root/docs/trunk/Component_Reference/en-US/chap-Component_Reference-Tabl=
es_and_grids.xml	2010-01-19 02:07:44 UTC (rev 16328)
@@ -39,7 +39,7 @@
 			The <sgmltag>&lt;rich:column&gt;</sgmltag> component facilitates column=
s in a table or other <classname>UIData</classname> component. It supports =
merging columns and rows, sorting, filtering, and customized skinning.
 		</para>
 		<para>
-			In general usage, the the <sgmltag>&lt;rich:column&gt;</sgmltag> compon=
ent is used in the same was as the JavaServer Faces (<acronym>JSF</acronym>=
) <sgmltag>&lt;h:column&gt;</sgmltag> component. It requires no extra attri=
butes for basic usage, as shown in <xref linkend=3D"exam-Component_Referenc=
e-richcolumn-Basic_column_example" /> and the resulting <xref linkend=3D"fi=
gu-Component_Reference-richcolumn-Basic_column_example" />.
+			In general usage, the <sgmltag>&lt;rich:column&gt;</sgmltag> component =
is used in the same was as the JavaServer Faces (<acronym>JSF</acronym>) <s=
gmltag>&lt;h:column&gt;</sgmltag> component. It requires no extra attribute=
s for basic usage, as shown in <xref linkend=3D"exam-Component_Reference-ri=
chcolumn-Basic_column_example" /> and the resulting <xref linkend=3D"figu-C=
omponent_Reference-richcolumn-Basic_column_example" />.
 		</para>
 		<example id=3D"exam-Component_Reference-richcolumn-Basic_column_example">
 			<title>Basic column example</title>
@@ -74,7 +74,7 @@
 			</mediaobject>
 		</figure>
 		<para>
-			Columns can be merged by using the <varname>colspan</varname> attribute=
 to specify how many normal columns to span. The <varname>colspan</varname>=
 attribute is used in conjunction with the <varname>breakBefore</varname> a=
ttribute on the next column to determine how the merged columns are laid ou=
t. <xref linkend=3D"exam-Component_Reference-richcolumn-Column_spanning_exa=
mple" /> and the resulting <xref linkend=3D"figu-Component_Reference-richco=
lumn-Column_spanning_example" /> show the first column spanning a width of =
three columns, with the others broken on to the following line.
+			Columns can be merged by using the <varname>colspan</varname> attribute=
 to specify how many normal columns to span. The <varname>colspan</varname>=
 attribute is used in conjunction with the <varname>breakBefore</varname> a=
ttribute on the next column to determine how the merged columns are laid ou=
t. <xref linkend=3D"exam-Component_Reference-richcolumn-Column_spanning_exa=
mple" /> and the resulting <xref linkend=3D"figu-Component_Reference-richco=
lumn-Column_spanning_example" /> show the first column spanning a width of =
three columns, with the others broken onto the following line.
 		</para>
 		<example id=3D"exam-Component_Reference-richcolumn-Column_spanning_examp=
le">
 			<title>Column spanning example</title>
@@ -301,6 +301,13 @@
 		</para>
 	</section>
 	=

+	<section id=3D"sect-Component_Reference-Trees-richdataDefinitionList">
+		<title>rich:dataDefinitionList</title>
+		<para>
+			Incomplete
+		</para>
+	</section>
+	=

 	<section id=3D"sect-Component_Reference-Tables_and_grids-richdataFilterSl=
ider">
 		<title>rich:dataFilterSlider</title>
 		<itemizedlist>
@@ -431,6 +438,20 @@
 		</example>
 	</section>
 	=

+	<section id=3D"sect-Component_Reference-Trees-richdataList">
+		<title>rich:dataList</title>
+		<para>
+			Incomplete
+		</para>
+	</section>
+	=

+	<section id=3D"sect-Component_Reference-Trees-richdataOrderedList">
+		<title>rich:dataOrderedList</title>
+		<para>
+			Incomplete
+		</para>
+	</section>
+	=

 	<section id=3D"sect-Component_Reference-Tables_and_grids-richdataScroller=
">
 		<title>rich:dataScroller</title>
 		<para>
@@ -448,7 +469,7 @@
 	<section id=3D"sect-Component_Reference-Tables_and_grids-richextendedData=
Table">
 		<title>rich:extendedDataTable</title>
 		<para>
-			Incomplete
+			* Combined with rich:scrollableDataTable
 		</para>
 	</section>
 	=

@@ -459,13 +480,6 @@
 		</para>
 	</section>
 	=

-	<section id=3D"sect-Component_Reference-Tables_and_grids-richscrollableDa=
taTable">
-		<title>rich:scrollableDataTable</title>
-		<para>
-			Incomplete
-		</para>
-	</section>
-	=

 	<section id=3D"sect-Component_Reference-Tables_and_grids-richsubTable">
 		<title>rich:subTable</title>
 		<para>


--===============0016712382569153611==--