JBoss Rich Faces SVN: r22944 - branches/enterprise.
by richfaces-svn-commits＠lists.jboss.org
Author: ivassile
Date: 2011-11-16 14:47:17 -0500 (Wed, 16 Nov 2011)
New Revision: 22944
Added:
branches/enterprise/3.3.1.SP3_BZ-754542/
Log:
Created branch for the BZ-754542 patch.
13 years, 1 month
JBoss Rich Faces SVN: r22943 - modules/docs/trunk/Developer_Guide/src/main/docbook/en-US.
by richfaces-svn-commits＠lists.jboss.org
Author: lfryc(a)redhat.com
Date: 2011-11-16 11:29:56 -0500 (Wed, 16 Nov 2011)
New Revision: 22943
Modified:
modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/chap-Developer_Guide-RichFaces_overview.xml
modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/chap-Developer_Guide-Skinning_and_theming.xml
Log:
RFPL-1850: Document workaround for h:outputStylesheet head and components' resources
Modified: modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/chap-Developer_Guide-RichFaces_overview.xml
===================================================================
--- modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/chap-Developer_Guide-RichFaces_overview.xml 2011-11-16 16:29:30 UTC (rev 22942)
+++ modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/chap-Developer_Guide-RichFaces_overview.xml 2011-11-16 16:29:56 UTC (rev 22943)
@@ -327,6 +327,11 @@
JSF 2 does not allow resources such as JavaScript or Cascading Style Sheets (<acronym>CSS</acronym>) to be added if the element requiring the resource is not initially present in the JSF tree. As such, components added to the tree via Ajax must have any required resources already loaded. In RichFaces, any components added to the JSF tree should have components with corresponding resources included on the main page initially. To facilitate this, components can use the <code>rendered="false"</code> setting to not be rendered on the page.
</para>
</listitem>
+ <listitem>
+ <para>
+ JSF does render resource links (stylesheets, scripts) in order of occurence, thus if you add <code><h:outputStylesheet></code> to the <code><h:head></code> section, JSF will render it before the RichFaces resource links (dependencies of RichFaces components). To be able to overwrite RichFaces stylesheets and re-use RichFaces JavaScript implementation, you need to render <code><h:outputStylesheet target="head"></code> to the <code><h:body></code> section (safe solution is to place it on the end of the section; however to keep readability, you can use start of the section).
+ </para>
+ </listitem>
<listitem>
<para>
Switching RichFaces skins via Ajax during runtime should be avoided, as this requires all the stylesheets to be reloaded.
Modified: modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/chap-Developer_Guide-Skinning_and_theming.xml
===================================================================
--- modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/chap-Developer_Guide-Skinning_and_theming.xml 2011-11-16 16:29:30 UTC (rev 22942)
+++ modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/chap-Developer_Guide-Skinning_and_theming.xml 2011-11-16 16:29:56 UTC (rev 22943)
@@ -432,14 +432,29 @@
</listitem>
</varlistentry>
<varlistentry>
- <term>Custom style classes</term>
+ <term>Custom components style classes</term>
<listitem>
<para>
Individual components can use the <varname>styleClass</varname> attribute to use a unique style class. Add the new style class to the application CSS and reference it from an individual component with the <varname>styleClass</varname> attribute.
</para>
</listitem>
</varlistentry>
+ <varlistentry>
+ <term>Overwriting stylesheets in application</term>
+ <listitem>
+ <para>
+ You can load custom stylesheets using <code><h:outputStylesheet></code> which rewrites of extends styles defined for style classes of components.
+ </para>
+ </listitem>
+ </varlistentry>
</variablelist>
+
+ <note>
+ <title>Customizing skins by rewriting/extending component style classes</title>
+ <para>
+ If you want to extend/overwrite style sheet definitions with own stylesheets, make sure you place definitions to be rendered in right order of occurence (see <link linkend="sect-Developer_Guide-RichFaces_overview-Restrictions">Restrictions</link> section for details).
+ </para>
+ </note>
<example id="exam-Developer_Guide-Using_skins-Simple_skinning_example">
<title>Simple skinning example</title>
13 years, 1 month
JBoss Rich Faces SVN: r22942 - modules/docs/trunk/Developer_Guide/src/main/docbook/en-US.
by richfaces-svn-commits＠lists.jboss.org
Author: lfryc(a)redhat.com
Date: 2011-11-16 11:29:30 -0500 (Wed, 16 Nov 2011)
New Revision: 22942
Modified:
modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/chap-Developer_Guide-Getting_started_with_RichFaces.xml
Log:
RFPL-1841: Developers Guide: refer to Arquillian/JSFUnit instead of jsf-test
Modified: modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/chap-Developer_Guide-Getting_started_with_RichFaces.xml
===================================================================
--- modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/chap-Developer_Guide-Getting_started_with_RichFaces.xml 2011-11-16 16:29:18 UTC (rev 22941)
+++ modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/chap-Developer_Guide-Getting_started_with_RichFaces.xml 2011-11-16 16:29:30 UTC (rev 22942)
@@ -275,8 +275,20 @@
<step id="step-Developer_Guide-Using_RichFaces_with_Maven-Add_dependencies">
<title>Add test dependencies (optional)</title>
<para>
- Your root directory of your project contains a project descriptor file, <filename>pom.xml</filename>. If you wish to include modules for test-driven JSF development, add any dependencies for the tests to the <filename>pom.xml</filename> file. For full details on how to use the <productname>jsf-test</productname> project, refer to <ulink url="http://community.jboss.org/docs/DOC-13155">http://community.jboss.org/wiki/TestDrivenJSFDevelopment</ulink>.
+ Your root directory of your project contains a project descriptor file, <filename>pom.xml</filename>. If you wish to include modules for test-driven JSF development, add any dependencies for the tests to the <filename>pom.xml</filename> file.
</para>
+ <para>
+ For testing server-side part of your implementation, check out <ulink url="http://www.jboss.org/arquillian"><productname>JBoss Arquillian project</productname></ulink>.
+ </para>
+ <para>
+ If you want to test JSF from client's perspective with ability to access state of JSF internals, use <ulink url="http://www.jboss.org/jsfunit"><productname>JBoss JSFUnit project</productname></ulink> (with Arquillian integration).
+ </para>
+ <para>
+ For automation of client-side tests in real-browser, you may want to employ <ulink url="http://community.jboss.org/wiki/ArquillianAjocado"><productname>Arquillian Ajocado</productname></ulink> and <ulink url="https://docs.jboss.org/author/display/ARQ/Drone"><productname>Arquillian Drone</productname></ulink> extensions.
+ </para>
+ <para>
+ For mocking JSF environment, there is set of tools in RichFaces <productname>jsf-test</productname> project. For full details on how to use the <productname>jsf-test</productname> project, refer to article <ulink url="http://community.jboss.org/docs/DOC-13155">Test Driven JSF Development</ulink>.
+ </para>
</step>
<!--
13 years, 1 month
JBoss Rich Faces SVN: r22941 - modules/docs/trunk/Developer_Guide/src/main/docbook/en-US.
by richfaces-svn-commits＠lists.jboss.org
Author: lfryc(a)redhat.com
Date: 2011-11-16 11:29:18 -0500 (Wed, 16 Nov 2011)
New Revision: 22941
Modified:
modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/chap-Developer_Guide-RichFaces_overview.xml
Log:
RFPL-1842: Developer's Guide: Update "Full Technical Requirements" versions
Modified: modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/chap-Developer_Guide-RichFaces_overview.xml
===================================================================
--- modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/chap-Developer_Guide-RichFaces_overview.xml 2011-11-16 16:29:01 UTC (rev 22940)
+++ modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/chap-Developer_Guide-RichFaces_overview.xml 2011-11-16 16:29:18 UTC (rev 22941)
@@ -46,12 +46,12 @@
<itemizedlist>
<listitem>
<para>
- An application server compliant with Java Platform, Enterprise Edition 5 or 6 (<acronym>JEE5</acronym> or <acronym>JEE6</acronym>), such as <productname>JBoss Application Server 6</productname>.
+ An application server compliant with Java Platform, Enterprise Edition 6 (<acronym>JEE6</acronym> or <acronym>JEE6</acronym>), such as <productname>JBoss Application Server 7</productname>.
</para>
</listitem>
<listitem>
<para>
- A major servlet container, such as <productname>Jetty 6</productname> or <productname>Apache Tomcat 6</productname>.
+ A major servlet container, such as <productname>Jetty 8</productname> or <productname>Apache Tomcat 7</productname>.
</para>
</listitem>
</itemizedlist>
@@ -59,72 +59,50 @@
<section id="sect-Component_Reference-RichFaces_overview-Client_requirements">
<title>Client requirements</title>
<para>
- Clients accessing RichFaces applications require a web browser. Richfaces supports the following web browsers:
+ Clients accessing RichFaces applications require a web browser. RichFaces supports the following web browsers:
</para>
<itemizedlist id="item-Developer_Guide-Technical_Requirements-Linux_environments">
<title>Linux environments</title>
<listitem>
<para>
- <productname>Firefox 3.0</productname> and higher
+ <productname>Firefox 3.6 or Firefox 7.0</productname> and higher
</para>
</listitem>
<listitem>
<para>
- <productname>Google Chrome 1.0</productname> and higher
+ <productname>Google Chrome 14</productname> and higher
</para>
</listitem>
- <listitem>
- <para>
- <productname>Opera 9.5</productname> and higher
- </para>
- </listitem>
</itemizedlist>
<itemizedlist id="item-Developer_Guide-Technical_Requirements-Mac_OS_environments">
<title>Mac OS environments</title>
<listitem>
<para>
- <productname>Firefox 3.5</productname> and higher
+ <productname>Safari 5.1</productname> and higher
</para>
</listitem>
- <listitem>
- <para>
- <productname>Google Chrome 1.0</productname> and higher
- </para>
- </listitem>
- <listitem>
- <para>
- <productname>Safari 3.0</productname> and higher
- </para>
- </listitem>
</itemizedlist>
<itemizedlist id="item-Developer_Guide-Technical_Requirements-Microsoft_Windows_environments">
<title>Microsoft Windows environments</title>
<listitem>
<para>
- <productname>Firefox 3.0</productname> and higher
+ <productname>Firefox 3.6 or Firefox 7.0</productname> and higher
</para>
</listitem>
<listitem>
<para>
- <productname>Google Chrome 1.0</productname> and higher
+ <productname>Google Chrome 14</productname> and higher
</para>
</listitem>
<listitem>
<para>
- <productname>Internet Explorer 7.0</productname> and higher
+ <productname>Internet Explorer 8.0</productname> and higher
</para>
</listitem>
- <listitem>
- <para>
- <productname>Opera 9.5</productname> and higher
- </para>
- </listitem>
- <listitem>
- <para>
- <productname>Safari 4.0</productname> and higher
- </para>
- </listitem>
</itemizedlist>
+ <para>
+ Other browsers and versions are partially supported.
+ </para>
</section>
<section id="sect-Component_Reference-RichFaces_overview-Development_requirements">
<title>Development requirements</title>
@@ -140,7 +118,7 @@
<itemizedlist>
<listitem>
<para>
- JDK 1.5 and higher
+ JDK 1.6 and higher
</para>
</listitem>
</itemizedlist>
@@ -155,17 +133,17 @@
<itemizedlist>
<listitem>
<para>
- <productname>MyFaces 2</productname> and higher
+ <productname>MyFaces 2.x</productname>
</para>
</listitem>
<listitem>
<para>
- <productname>Seam 3</productname> and higher
+ <productname>Seam 3.x</productname>
</para>
</listitem>
<listitem>
<para>
- <productname>Mojara 2</productname> and higher
+ <productname>Mojara 2.x</productname>
</para>
</listitem>
</itemizedlist>
@@ -180,12 +158,12 @@
<itemizedlist>
<listitem>
<para>
- <productname>JBoss Tools 3.1</productname> and higher
+ <productname>JBoss Tools 3.3</productname> and higher
</para>
</listitem>
<listitem>
<para>
- <productname>Maven 2.0.9</productname> and higher (2.2.1 recommended)
+ <productname>Maven 3.0.3</productname> and higher
</para>
</listitem>
</itemizedlist>
13 years, 1 month
JBoss Rich Faces SVN: r22940 - in modules/docs/trunk: Developer_Guide/src/main/docbook/en-US and 1 other directory.
by richfaces-svn-commits＠lists.jboss.org
Author: lfryc(a)redhat.com
Date: 2011-11-16 11:29:01 -0500 (Wed, 16 Nov 2011)
New Revision: 22940
Modified:
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/Revision_History.xml
modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/Revision_History.xml
Log:
RFPL-1843: Update revision history in Component Reference and Developer Guide
Modified: modules/docs/trunk/Component_Reference/src/main/docbook/en-US/Revision_History.xml
===================================================================
--- modules/docs/trunk/Component_Reference/src/main/docbook/en-US/Revision_History.xml 2011-11-16 16:28:41 UTC (rev 22939)
+++ modules/docs/trunk/Component_Reference/src/main/docbook/en-US/Revision_History.xml 2011-11-16 16:29:01 UTC (rev 22940)
@@ -18,6 +18,23 @@
</simplelist>
</revdescription>
</revision>
+ <revision>
+ <revnumber>1.1</revnumber>
+ <date>Wed Nov 16 2011</date>
+ <author>
+ <firstname>Brian</firstname>
+ <surname>Leathem</surname>
+ </author>
+ <author>
+ <firstname>Lukas</firstname>
+ <surname>Fryc</surname>
+ </author>
+ <revdescription>
+ <simplelist>
+ <member>4.1.0.Final Release</member>
+ </simplelist>
+ </revdescription>
+ </revision>
</revhistory>
</simpara>
</appendix>
Modified: modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/Revision_History.xml
===================================================================
--- modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/Revision_History.xml 2011-11-16 16:28:41 UTC (rev 22939)
+++ modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/Revision_History.xml 2011-11-16 16:29:01 UTC (rev 22940)
@@ -18,6 +18,23 @@
</simplelist>
</revdescription>
</revision>
+ <revision>
+ <revnumber>1.1</revnumber>
+ <date>Wed Nov 16 2011</date>
+ <author>
+ <firstname>Brian</firstname>
+ <surname>Leathem</surname>
+ </author>
+ <author>
+ <firstname>Lukas</firstname>
+ <surname>Fryc</surname>
+ </author>
+ <revdescription>
+ <simplelist>
+ <member>4.1.0.Final Release</member>
+ </simplelist>
+ </revdescription>
+ </revision>
</revhistory>
</simpara>
</appendix>
13 years, 1 month
JBoss Rich Faces SVN: r22939 - modules/docs/trunk/Component_Reference/src/main/docbook/en-US.
by richfaces-svn-commits＠lists.jboss.org
Author: lfryc(a)redhat.com
Date: 2011-11-16 11:28:41 -0500 (Wed, 16 Nov 2011)
New Revision: 22939
Modified:
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Common_Ajax_attributes.xml
Log:
RFPL-1847: Component Reference - rename onsubmit ajax attribute to onbeforesubmit
Modified: modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Common_Ajax_attributes.xml
===================================================================
--- modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Common_Ajax_attributes.xml 2011-11-16 16:28:25 UTC (rev 22938)
+++ modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Common_Ajax_attributes.xml 2011-11-16 16:28:41 UTC (rev 22939)
@@ -207,9 +207,9 @@
JSF provides global <varname>jsf.ajax.onError</varname> and <varname>jsf.ajax.onEvent</varname> events to define handlers (the <varname>jsf.ajax.onEvent</varname> event is used for all <varname>begin</varname>, <varname>success</varname>, and <varname>complete</varname> events). RichFaces adds event-specific attributes at the component level.
</para>
<section id="sect-Component_Reference-Events_and_JavaScript_interactions-onsubmit">
- <title><varname>onsubmit</varname></title>
+ <title><varname>onbeforesubmit</varname></title>
<para>
- The <varname>onsubmit</varname> event attribute invokes the event listener <emphasis>before</emphasis> the Ajax request is sent. The request is canceled if the event listener defined for the <varname>onsubmit</varname> event returns <literal>false</literal>.
+ The <varname>onbeforesubmit</varname> event attribute invokes the event listener <emphasis>before</emphasis> the Ajax request is sent. The request is canceled if the event listener defined for the <varname>onbeforesubmit</varname> event returns <literal>false</literal>.
</para>
</section>
13 years, 1 month
JBoss Rich Faces SVN: r22938 - in modules/docs/trunk/Component_Reference/src/main/docbook/en-US: extras and 1 other directory.
by richfaces-svn-commits＠lists.jboss.org
Author: lfryc(a)redhat.com
Date: 2011-11-16 11:28:25 -0500 (Wed, 16 Nov 2011)
New Revision: 22938
Added:
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/extras/exam-Component_Reference-a4jpush-Installing_Atmosphere_libraries.xml_sample
Modified:
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Actions.xml
Log:
RFPL-1848: Component Reference: add atmosphere libs installation step
Modified: modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Actions.xml
===================================================================
--- modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Actions.xml 2011-11-16 13:16:58 UTC (rev 22937)
+++ modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Actions.xml 2011-11-16 16:28:25 UTC (rev 22938)
@@ -538,12 +538,20 @@
<para>
The <sgmltag><a4j:push></sgmltag> component uses the Comet model for pushing data to the client.
</para>
+
+ <section id="sect-Component_Reference-a4jpush-Installing_runtime_dependencies">
+ <title>Installing runtime dependencies</title>
+ <para>
+ The <sgmltag><a4j:push></sgmltag> uses Atmosphere framework on both client-side and server-side. In order to use Atmosphere on server-side, it is necessary to add Atmosphere libraries into project.
+ </para>
+ <para>
+ In Maven based project, you should add <code>atmosphere-runtime</code> as runtime dependency (its version is managed by <code>richfaces-bom</code> that your project should be importing):
+ </para>
+ <programlisting language="XML" role="XML"><xi:include parse="text" href="extras/exam-Component_Reference-a4jpush-Installing_Atmosphere_libraries.xml_sample" xmlns:xi="http://www.w3.org/2001/XInclude" /></programlisting>
+ </section>
<section id="sect-Component_Reference-a4jpush-Basic_usage">
<title>Basic usage</title>
- <para>
- The <sgmltag><a4j:push></sgmltag> uses Atmosphere framework on both client-side and server-side. In order to use Atmosphere on server-side, it is necessary to add Atmosphere libraries into project.
- </para>
<para>
It is possible to trigger push events on server-side in several ways:
</para>
Added: modules/docs/trunk/Component_Reference/src/main/docbook/en-US/extras/exam-Component_Reference-a4jpush-Installing_Atmosphere_libraries.xml_sample
===================================================================
--- modules/docs/trunk/Component_Reference/src/main/docbook/en-US/extras/exam-Component_Reference-a4jpush-Installing_Atmosphere_libraries.xml_sample (rev 0)
+++ modules/docs/trunk/Component_Reference/src/main/docbook/en-US/extras/exam-Component_Reference-a4jpush-Installing_Atmosphere_libraries.xml_sample 2011-11-16 16:28:25 UTC (rev 22938)
@@ -0,0 +1,4 @@
+<dependency>
+ <groupId>org.atmosphere</groupId>
+ <artifactId>atmosphere-runtime</artifactId>
+</dependency>
\ No newline at end of file
13 years, 1 month
JBoss Rich Faces SVN: r22937 - modules/tests/metamer/trunk/ftest-source/src/main/java/org/richfaces/tests/metamer/ftest/richCollapsibleSubTable.
by richfaces-svn-commits＠lists.jboss.org
Author: ppitonak(a)redhat.com
Date: 2011-11-16 08:16:58 -0500 (Wed, 16 Nov 2011)
New Revision: 22937
Modified:
modules/tests/metamer/trunk/ftest-source/src/main/java/org/richfaces/tests/metamer/ftest/richCollapsibleSubTable/TestCollapsibleSubTableFacets.java
Log:
test for nodata facet fixed
Modified: modules/tests/metamer/trunk/ftest-source/src/main/java/org/richfaces/tests/metamer/ftest/richCollapsibleSubTable/TestCollapsibleSubTableFacets.java
===================================================================
--- modules/tests/metamer/trunk/ftest-source/src/main/java/org/richfaces/tests/metamer/ftest/richCollapsibleSubTable/TestCollapsibleSubTableFacets.java 2011-11-15 21:30:28 UTC (rev 22936)
+++ modules/tests/metamer/trunk/ftest-source/src/main/java/org/richfaces/tests/metamer/ftest/richCollapsibleSubTable/TestCollapsibleSubTableFacets.java 2011-11-16 13:16:58 UTC (rev 22937)
@@ -63,7 +63,6 @@
JQueryLocator noDataFacet = pjq("table[id$=richDataTable] > tbody.rf-cst:eq(0) > tr.rf-cst-nd > td.rf-cst-nd-c");
assertTrue(selenium.isElementPresent(noDataFacet));
- assertFalse(selenium.isVisible(noDataFacet));
assertTrue(selenium.getText(noDataFacet).isEmpty());
dataTableFacets.set(noData, SAMPLE_STRING);
13 years, 1 month
JBoss Rich Faces SVN: r22936 - modules/docs/trunk/Component_Reference/src/main/docbook/en-US.
by richfaces-svn-commits＠lists.jboss.org
Author: wesleyhales
Date: 2011-11-15 16:30:28 -0500 (Tue, 15 Nov 2011)
New Revision: 22936
Modified:
modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Tables_and_grids.xml
Log:
https://issues.jboss.org/browse/RFPL-1393
Modified: modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Tables_and_grids.xml
===================================================================
--- modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Tables_and_grids.xml 2011-11-14 22:23:17 UTC (rev 22935)
+++ modules/docs/trunk/Component_Reference/src/main/docbook/en-US/chap-Component_Reference-Tables_and_grids.xml 2011-11-15 21:30:28 UTC (rev 22936)
@@ -181,6 +181,9 @@
<para>
The <varname>first</varname> attribute specifies which item in the data model to start from, and the <varname>rows</varname> attribute specifies the number of items to list. The <literal>header</literal>, <literal>footer</literal>, and <literal>caption</literal> facets can be used to display text, and to customize the appearance of the table through skinning. demonstrates a simple table implementation.
</para>
+ <para>
+ The <varname>keepSaved</varname> attribute defines whether this iteration component will reset saved children's state before rendering. By default, the state is reset if there are no faces messages with severity error or higher.
+ </para>
<example id="exam-Component_Reference-richdataTable-richdataTable_example">
<title><sgmltag><rich:dataTable></sgmltag> example</title>
13 years, 1 month
JBoss Rich Faces SVN: r22935 - modules/docs/trunk/Developer_Guide/src/main/docbook/en-US.
by richfaces-svn-commits＠lists.jboss.org
Author: lfryc(a)redhat.com
Date: 2011-11-14 17:23:17 -0500 (Mon, 14 Nov 2011)
New Revision: 22935
Modified:
modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/chap-Developer_Guide-Getting_started_with_RichFaces.xml
modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/chap-Developer_Guide-RichFaces_overview.xml
Log:
RFPL-1818: Remove "Compiling from Source Code" section from Developer's Guide
Modified: modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/chap-Developer_Guide-Getting_started_with_RichFaces.xml
===================================================================
--- modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/chap-Developer_Guide-Getting_started_with_RichFaces.xml 2011-11-14 22:23:00 UTC (rev 22934)
+++ modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/chap-Developer_Guide-Getting_started_with_RichFaces.xml 2011-11-14 22:23:17 UTC (rev 22935)
@@ -110,14 +110,6 @@
</step>
</stepalternatives>
-->
- <stepalternatives>
- <step>
- <title>Compiling from source</title>
- <para>
- Instead of using the pre-compiled binaries, you can compile the source files yourself. Refer to <xref linkend="sect-Component_Reference-RichFaces_overview-Compiling_from_source_code" /> for further instructions.
- </para>
- </step>
- </stepalternatives>
</step>
<step>
<title>Unzip archive</title>
Modified: modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/chap-Developer_Guide-RichFaces_overview.xml
===================================================================
--- modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/chap-Developer_Guide-RichFaces_overview.xml 2011-11-14 22:23:00 UTC (rev 22934)
+++ modules/docs/trunk/Developer_Guide/src/main/docbook/en-US/chap-Developer_Guide-RichFaces_overview.xml 2011-11-14 22:23:17 UTC (rev 22935)
@@ -357,169 +357,6 @@
</itemizedlist>
</para>
</section>
-
- <section id="sect-Component_Reference-RichFaces_overview-Compiling_from_source_code">
- <title>Compiling from source code</title>
- <para>
- The source code for the RichFaces framework can be compiled manually rather than using the pre-compiled binaries.
- </para>
- <procedure>
- <step>
- <title>Acquiring the source code</title>
- <stepalternatives>
- <step>
- <title>JBoss RichFaces Downloads area</title>
- <para>
- Download the RichFaces distribution as described in <xref linkend="sect-Developer_Guide-Getting_started_with_RichFaces-Setting_up_RichFaces" />. The distribution bundles contain the full RichFaces source code.
- </para>
- </step>
- <step>
- <title>Anonymous SVN repository</title>
- <para>
- Alternatively, the source files can be checked out from the anonymous SVN repository at <ulink url="http://anonsvn.jboss.org/repos/richfaces/branches/4.0.X/">http://anonsvn.jboss.org/repos/richfaces/branches/4.0.X/</ulink> using the following command:
- </para>
- <screen>svn co http://anonsvn.jboss.org/repos/richfaces/branches/4.0.X/</screen>
- </step>
- </stepalternatives>
- </step>
- <step>
- <title>Unzip archive</title>
- <para>
- If using the downloaded distribution, create a new directory named <filename>RichFaces</filename>, then unzip the archive containing the source code there.
- </para>
- </step>
- <step>
- <title>Configure <productname>Maven</productname> for RichFaces</title>
- <para>
- To compile the RichFaces source code, <productname>Maven</productname> requires access to the JBoss repositories. Refer to <xref linkend="step-Developer_Guide-Using_RichFaces_with_Maven-Add_required_repositories" /> of the procedure in <xref linkend="sect-Component_Reference-Using_RichFaces_with_Maven-Using_the_RichFaces_project_archetype" /> to configure the required repositories.
- </para>
- </step>
- <step>
- <title>Compile using <productname>Maven</productname></title>
- <para>
- In the root directory of the unzipped source code, enter the following command to compile and build the RichFaces framework:
- </para>
- <screen>mvn clean install</screen>
- <para>
- Add any of the following options after the command to customize the build:
- </para>
- <variablelist>
- <varlistentry>
- <term><command>-P release,docs</command></term>
- <listitem>
- <para>
- Maven additionally builds the documentation and release artifacts.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><command>-D skipTests=true</command></term>
- <listitem>
- <para>
- Maven skips the unit and functional tests, which completes the build faster.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><command>-D checkstyle.skip=true</command></term>
- <listitem>
- <para>
- Maven skips the scans for checking style, which completes the build faster.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><command>-D skip-source</command></term>
- <listitem>
- <para>
- Maven does not produce any source <filename>jar</filename> files from the build.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><command>-D skip-enforce</command></term>
- <listitem>
- <para>
- Maven does not check for the correct JDK version, Maven version, and <literal>SNAPSHOT</literal> plug-in, and forces the build.
- </para>
- </listitem>
- </varlistentry>
- <varlistentry>
- <term><command>-D jsf-profile=<replaceable>implementation</replaceable></command></term>
- <listitem>
- <para>
- Maven tests builds and tests against the specified JSF implementation. The <replaceable>implementation</replaceable> value can be any of the following:
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <literal>jsf_ri</literal>: The latest release of <productname>JSF RI (Mojarra)</productname>. This is the default implemenation.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>jsf_ri_javax</literal>: The latest release of <productname>javax.faces</productname>.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>jsf_ri_snapshot</literal>: The latest snapshot version of <productname>JSF RI (Mojarra)</productname>.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>myfaces</literal>: The latest release of <productname>MyFaces</productname>.
- </para>
- </listitem>
- <listitem>
- <para>
- <literal>myfaces</literal>: The latest snapshot version of <productname>MyFaces</productname>.
- </para>
- </listitem>
- </itemizedlist>
- </listitem>
- </varlistentry>
- </variablelist>
- </step>
- <step>
- <title>Access compiled binaries</title>
- <para>
- The compiled libraries are located in the following sub-directories of the root RichFaces directory:
- </para>
- <itemizedlist>
- <listitem>
- <para>
- <filename>/ui/dist/richfaces-components-api/target/richfaces-components-api-<replaceable>version</replaceable>-SNAPSHOT.jar</filename>
- </para>
- </listitem>
- <listitem>
- <para>
- <filename>/ui/dist/richfaces-components-ui/target/richfaces-components-ui-<replaceable>version</replaceable>-SNAPSHOT.jar</filename>
- </para>
- </listitem>
- <listitem>
- <para>
- <filename>/core/api/target/richfaces-core-api-<replaceable>version</replaceable>-SNAPSHOT.jar</filename>
- </para>
- </listitem>
- <listitem>
- <para>
- <filename>/core/impl/target/richfaces-core-impl-<replaceable>version</replaceable>-SNAPSHOT.jar</filename>
- </para>
- </listitem>
- </itemizedlist>
- <!-- TODO check build location
- <para>
- If Maven built the framework using the <command>-P release</command> option, the distribution package containing all three compiled libraries and reference documentation is located at <filename>ui/assembly/target/dist/richfaces-ui-<replaceable>version</replaceable>-SNAPSHOT-bin.zip</filename>.
- </para>
- -->
- </step>
- </procedure>
- <para>
- You can now add the compiled libraries to your project as described in <xref linkend="step-Developer_Guide-Creating_a_project-Add_the_RichFaces_libraries_to_the_project" /> of <xref linkend="sect-Developer_Guide-Getting_started_with_RichFaces-Creating_a_project_with_JBoss_Tools" />.
- </para>
-
- </section>
</chapter>
13 years, 1 month