From richfaces-svn-commits at lists.jboss.org Fri Jul 10 12:06:38 2009
Content-Type: multipart/mixed; boundary="===============0048052015033285259=="
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: r14894 -
 branches/community/3.3.X/docs/userguide/en/src/main/docbook/included.
Date: Fri, 10 Jul 2009 11:49:29 -0400
Message-ID: <200907101549.n6AFnTX2022355@svn01.web.mwc.hst.phx2.redhat.com>

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

Author: atsebro
Date: 2009-07-10 11:49:29 -0400 (Fri, 10 Jul 2009)
New Revision: 14894

Modified:
   branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/loa=
dStyle.desc.xml
   branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/loa=
dStyle.xml
Log:
RF-7484:a4j:loadStyle component description review

Modified: branches/community/3.3.X/docs/userguide/en/src/main/docbook/inclu=
ded/loadStyle.desc.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
--- branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/lo=
adStyle.desc.xml	2009-07-10 15:48:33 UTC (rev 14893)
+++ branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/lo=
adStyle.desc.xml	2009-07-10 15:49:29 UTC (rev 14894)
@@ -1,15 +1,15 @@
 <?xml version=3D"1.0" encoding=3D"UTF-8"?>
 <chapter>
-	<section>
-		<sectioninfo>
-			<keywordset>
-				<keyword>loadStyle</keyword>
-			</keywordset>
-		</sectioninfo>
-		=

-		<title>Description</title>
-		<para>
-			The component Inserts stylesheet links to the head element. Render the =
value of the component, after passing it to the <code>getResourceURL()</cod=
e> method of the ViewHandler for this application, and passing the result t=
hrough the <code>encodeResourceURL()</code> method of the ExternalContext.		=

-		</para>
-	</section>
+      <section>
+            <sectioninfo>
+                  <keywordset>
+                        <keyword>loadStyle</keyword>
+                  </keywordset>
+            </sectioninfo>
+            <title>Description</title>
+            <para>
+                  The <emphasis role=3D"bold"><property>&lt;a4j:loadStyle&=
gt;</property></emphasis> component allows to load a style sheet file from =
alternative sources like a jar file, etc. =

+                  It inserts stylesheet links to the head element. =

+            </para>
+      </section>
 </chapter>
\ No newline at end of file

Modified: branches/community/3.3.X/docs/userguide/en/src/main/docbook/inclu=
ded/loadStyle.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
--- branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/lo=
adStyle.xml	2009-07-10 15:48:33 UTC (rev 14893)
+++ branches/community/3.3.X/docs/userguide/en/src/main/docbook/included/lo=
adStyle.xml	2009-07-10 15:49:29 UTC (rev 14894)
@@ -36,7 +36,7 @@
     </table>
   =

   <section>
-    <title>Creating on a page</title>
+        <title>Creating the Component with a Page Tag</title>
     <para>To create the simplest variant on a page use the following synta=
x:</para>
 =

   <para>
@@ -57,29 +57,31 @@
 ...
 ]]></programlisting>
   </section>
-  <section>
-    <title>Key attributes and ways of usage</title>
-    <para>
-      As it was mentioned <link linkend=3D"loadStyle">above</link> this co=
mponent returns its value as the value of =

-      the <emphasis><property>&quot;src&quot;</property></emphasis> attrib=
ute passing it to the
-    	 <code>getResourceURL()</code> method of the ViewHandler for this app=
lication, and passing =

-    	 the result	via the <code>encodeResourceURL()</code> method of the Ex=
ternalContext.
-    </para>
-    <para>
-    	It means that the Context is inserted automatically to the link. And =
calls
-    	 like <code>resource://</code> is properly handled.
-    </para>
-    <para>
-    	Except this - you may be free to put your stylesheet links right from=
 the child =

-    	page while using <property>facelets templates</property>.
-    </para>
-</section>
-  <section>
-    <title>Relevant resources links</title>
-    <para>
-      Some additional information about usage of component can be found =

-      <ulink url=3D"http://livedemo.exadel.com/richfaces-demo/richfaces/st=
yle.jsf?c=3DloadStyle">on the component Live Demo page</ulink>.
-    </para>
-  </section>
   =

+      <section>
+            <title>Details of usage</title>
+            <para>
+                  The main attribute of the <emphasis role=3D"bold"><prope=
rty>&lt;a4j:loadStylet&gt;</property></emphasis> is <emphasis><property>&qu=
ot;src&quot;</property></emphasis>, wich defines the context relative path =
to the script. =

+                  The value of the attribute does not require a prefix of =
an application. =

+                  Leading slash in the path means the root of the web cont=
ext.
+                  It is also possible to use <code>resource:///</code> pre=
fix to access the script file using RichFaces resource framework.
+            </para>
+            <para>
+                  <emphasis role=3D"bold">Example:</emphasis>
+            </para>
+            <programlisting role=3D"XML"><![CDATA[<a4j:loadStyle src=3D"re=
source:///org/mycompany/assets/script/focus.js" />]]></programlisting>
+            <para>
+                  The <emphasis><property>&quot;src&quot;</property></emph=
asis> attribute passses value to the <code>getResourceURL()</code> method o=
f the ViewHandler of the application, =

+                  The result is passed through the <code>encodeResourceURL=
()</code> method of the ExternalContext. =

+            </para>
+            =

+      </section>
+      =

+      <section>
+            <title>Relevant resources links</title>
+            <para>
+                  Vizit the <ulink url=3D"http://livedemo.exadel.com/richf=
aces-demo/richfaces/style.jsf?c=3DloadStyle">Script page at RichFaces LiveD=
emo</ulink> for examples of component usage abd their sources.
+            </para>
+      </section>
+     =

 </chapter>   =

\ No newline at end of file


--===============0048052015033285259==--