You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@myfaces.apache.org by bu...@apache.org on 2014/01/28 02:49:22 UTC
svn commit: r895593 [2/7] - in /websites/staging/myfaces/trunk/content: ./
wiki/ wiki/asf-board-reports/ wiki/commons/ wiki/commons/user-guide/
wiki/core/ wiki/core/committer-and-pmc-guide/
wiki/core/committer-and-pmc-guide/myfaces-project-management/ ...
Added: websites/staging/myfaces/trunk/content/wiki/core/committer-and-pmc-guide.html
==============================================================================
--- websites/staging/myfaces/trunk/content/wiki/core/committer-and-pmc-guide.html (added)
+++ websites/staging/myfaces/trunk/content/wiki/core/committer-and-pmc-guide.html Tue Jan 28 01:49:20 2014
@@ -0,0 +1,57 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html lang="en">
+ <head>
+ <title>MyFaces Committer and PMC Guide</title>
+
+ <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
+ <meta property="og:image" content="http://www.apache.org/images/asf_logo.gif" />
+
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/style.css">
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/code.css">
+
+
+
+
+
+ </head>
+
+ <body>
+ <div id="page" class="container_16">
+ <div id="header" class="grid_8">
+ <img src="http://www.apache.org/images/feather-small.gif" alt="The Apache Software Foundation">
+ <h1>The Apache Software Foundation</h1>
+ <h2>MyFaces Committer and PMC Guide</h2>
+ </div>
+ <div id="nav" class="grid_8">
+ <ul>
+ <!-- <li><a href="/" title="Welcome!">Home</a></li> -->
+ <li><a href="http://www.apache.org/foundation/" title="The Foundation">Foundation</a></li>
+ <li><a href="http://projects.apache.org" title="The Projects">Projects</a></li>
+ <li><a href="http://people.apache.org" title="The People">People</a></li>
+ <li><a href="http://www.apache.org/foundation/getinvolved.html" title="Get Involved">Get Involved</a></li>
+ <li><a href="http://www.apache.org/dyn/closer.cgi" title="Download">Download</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html" title="Support Apache">Support Apache</a></li>
+ </ul>
+ <p><a href="/">Home</a> » <a href="/wiki/">Wiki</a> » <a href="/wiki/core/">Core</a></p>
+ <form name="search" id="search" action="http://www.google.com/search" method="get">
+ <input value="*.apache.org" name="sitesearch" type="hidden"/>
+ <input type="text" name="q" id="query">
+ <input type="submit" id="submit" value="Search">
+ </form>
+ </div>
+ <div class="clear"></div>
+ <div id="content" class="grid_16"><div class="section-content"><p><ac:macro ac:name="unmigrated-inline-wiki-markup"><ac:plain-text-body><![CDATA<a href="cdata[{scrollbar}.html">{scrollbar}</a>
+]></ac:plain-text-body></ac:macro>
+<p>Here you can find information about how to work with MyFaces Core code,
+and other administrative information of MyFaces project.</p></p>
+<p><ac:macro ac:name="children" /></p>
+<p><ac:macro ac:name="unmigrated-inline-wiki-markup"><ac:plain-text-body><![CDATA<a href="cdata[{scrollbar}.html">{scrollbar}</a>
+]></ac:plain-text-body></ac:macro></p></div></div>
+ <div class="clear"></div>
+ </div>
+
+ <div id="copyright" class="container_16">
+ <p>Copyright © 2011 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.<br/>Apache and the Apache feather logo are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </body>
+</html>
Added: websites/staging/myfaces/trunk/content/wiki/core/committer-and-pmc-guide/myfaces-developer-notes.html
==============================================================================
--- websites/staging/myfaces/trunk/content/wiki/core/committer-and-pmc-guide/myfaces-developer-notes.html (added)
+++ websites/staging/myfaces/trunk/content/wiki/core/committer-and-pmc-guide/myfaces-developer-notes.html Tue Jan 28 01:49:20 2014
@@ -0,0 +1,203 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html lang="en">
+ <head>
+ <title>MyFaces Developer Notes</title>
+
+ <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
+ <meta property="og:image" content="http://www.apache.org/images/asf_logo.gif" />
+
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/style.css">
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/code.css">
+
+
+
+
+
+ </head>
+
+ <body>
+ <div id="page" class="container_16">
+ <div id="header" class="grid_8">
+ <img src="http://www.apache.org/images/feather-small.gif" alt="The Apache Software Foundation">
+ <h1>The Apache Software Foundation</h1>
+ <h2>MyFaces Developer Notes</h2>
+ </div>
+ <div id="nav" class="grid_8">
+ <ul>
+ <!-- <li><a href="/" title="Welcome!">Home</a></li> -->
+ <li><a href="http://www.apache.org/foundation/" title="The Foundation">Foundation</a></li>
+ <li><a href="http://projects.apache.org" title="The Projects">Projects</a></li>
+ <li><a href="http://people.apache.org" title="The People">People</a></li>
+ <li><a href="http://www.apache.org/foundation/getinvolved.html" title="Get Involved">Get Involved</a></li>
+ <li><a href="http://www.apache.org/dyn/closer.cgi" title="Download">Download</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html" title="Support Apache">Support Apache</a></li>
+ </ul>
+ <p><a href="/">Home</a> » <a href="/wiki/">Wiki</a> » <a href="/wiki/core/">Core</a> » <a href="/wiki/core/committer-and-pmc-guide/">Committer-and-pmc-guide</a></p>
+ <form name="search" id="search" action="http://www.google.com/search" method="get">
+ <input value="*.apache.org" name="sitesearch" type="hidden"/>
+ <input type="text" name="q" id="query">
+ <input type="submit" id="submit" value="Search">
+ </form>
+ </div>
+ <div class="clear"></div>
+ <div id="content" class="grid_16"><div class="section-content"><p><ac:macro ac:name="unmigrated-inline-wiki-markup"><ac:plain-text-body><![CDATA<a href="cdata[{scrollbar}.html">{scrollbar}</a>
+]></ac:plain-text-body></ac:macro>
+<p>This document deals with issues that are important for MyFaces
+developers and custom component developers.</p></p>
+<h3>Component developer guidelines</h3>
+
+<p>(same as "SVN guidelines", see below)</p>
+
+<h3>SVN guidelines</h3>
+
+<h5>Code style</h5>
+
+<p>See <a
+href="http://www.apache.org/dev/styleguide.html">http://www.apache.org/dev/styleguide.html</a>
+for the Apache-Wide Coding Style Guide. Everything that is not documented
+there should be written according to Suns Java Code Conventions at <a
+href="http://java.sun.com/docs/codeconv/html/CodeConvTOC.doc.html">http://java.sun.com/docs/codeconv/html/CodeConvTOC.doc.html</a></p>
+
+<p>Here is a formatter profile for eclipse 3.1: <ac:link><ri:attachment
+ri:filename="apache-codeconv.xml" /></ac:link> . Import it through
+Window->Preferences->Java->Code Style->Formatter</p>
+
+<p>Here is a formatter profile for IntelliJ IDEA 7.0 (7718):
+<ac:link><ri:attachment ri:filename="maven-idea-codestyle.xml"
+/></ac:link>. Import it through File->Import Settings ... This should
+add a new profile called "MyFaces"</p>
+
+<h5>Error and exception handling</h5>
+
+<p>Whenever an exception is caught, the following applies:</p>
+
+<ul>
+ <li>If there is no chance to get the system back to a stable state,
+a message with severity "fatal" should be logged and a
+RuntimeException (or derived class) should be thrown. Vice versa: Whenever
+a RuntimeException (or derived class) is thrown from within a catch clause,
+a message with severity "fatal" must have been logged right
+before.</li>
+ <li>If the exception is severe, but there is a chance to continue
+processing, a message with severity "error" or
+"warning" should be logged.</li>
+</ul>
+
+<h5>Logging</h5>
+
+<p>Except in the JSF API (javax.faces.*) classes where there must be no
+dependencies to additional libraries, commons-logging is used for logging.
+Commons-logging should be used in the recommended way, i.e. each class has
+its own private static logger.</p>
+
+<h5>Naming</h5>
+
+<p>Naming is a fundamental concern. The name of a class, method or field
+should tell as much as possible of it's meaning and usage. Avoid short
+names like "Helper", "calc" or "check". Use
+"!FinancialConsultance", "calculateMyYearlyIncome" and
+"isMyIncomeTooLow" instead.</p>
+
+<h5>Special comments</h5>
+
+<p>Addition special comments (see 10.5.4 in CodeConv)</p>
+
+<ul>
+ <li><strong>TODO</strong>: something that is not yet ready</li>
+ <li><strong>HACK</strong>: something that is bogus but (meanwhile)
+necessary to make it work</li>
+ <li><strong>XXX</strong>: something that is bogus but works</li>
+ <li><strong>FIXME</strong>: something that is bogus and broken</li>
+</ul>
+
+<h5>Version Control</h5>
+
+<ul>
+ <li>Every developer may upload files, if (s)he is confident, that
+this file is usable for others.</li>
+ <li>Uploaded java files must be compilable, of course.</li>
+ <li>Changes to java files must leave the whole project in a state
+where it is still compilable.</li>
+ <li>Foreign files should only be committed (changed) after
+consulting and/or informing the original author. The same applies for
+deleting, of course. Exception: Trivial changes such as spelling mistakes
+in comments, etc.</li>
+ <li>Just to be sure: Don't forget the message(s) on commit
+<ac:emoticon ac:name="wink" /></li>
+</ul>
+
+<h5>Communication</h5>
+
+<ul>
+ <li>Main communication instrument among !MyFaces developers is the
+!MyFaces developer mailing list (dev@myfaces.apache.org).</li>
+ <li>Every active !MyFaces developer must subscribe to this
+list.</li>
+</ul>
+
+<h5>Copyright</h5>
+
+<p>Every file should start with the following copyright notice:</p>
+
+<p><ac:macro
+ac:name="code"><ac:default-parameter>java</ac:default-parameter><ac:plain-text-body><![CDATA[
+/<em>
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ </em>
+ * http://www.apache.org/licenses/LICENSE-2.0
+ <em>
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ </em>/
+]
+]></ac:plain-text-body></ac:macro></p>
+<h5>Class and Interface comment</h5>
+
+<p>Every class and interface should have a javadoc similar to this:</p>
+
+<p><ac:macro
+ac:name="code"><ac:default-parameter>java</ac:default-parameter><ac:plain-text-body><![CDATA[
+/<em><em>
+ * Very detailed description goes here... ;-)
+ </em>
+ * @author Bug Rogers
+ </em>/
+]
+]></ac:plain-text-body></ac:macro></p>
+<h5>SVN Settings</h5>
+
+<p>Developers should be setting their autoprops so that files have an
+svn:eol-style of 'native'. Developers working on *nix systems are
+"lucky" because native on *nix is what SVN calls native, but the
+autoprops should still be set so that keywords are replaced as well. This
+is described on the <a
+href="http://wiki.apache.org/struts/StrutsMaintenanceSvn">Struts SVN wiki
+page</a>.</p>
+
+<h3>Issue Tracker guidelines</h3>
+
+<h5>Closing issues</h5>
+
+<p>Issues should be marked as closed at the same time that an issue is
+marked as resolved.</p>
+
+<p><ac:macro ac:name="unmigrated-inline-wiki-markup"><ac:plain-text-body><![CDATA<a href="cdata[{scrollbar}.html">{scrollbar}</a>
+]></ac:plain-text-body></ac:macro></p></div></div>
+ <div class="clear"></div>
+ </div>
+
+ <div id="copyright" class="container_16">
+ <p>Copyright © 2011 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.<br/>Apache and the Apache feather logo are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </body>
+</html>
Added: websites/staging/myfaces/trunk/content/wiki/core/committer-and-pmc-guide/myfaces-project-management.html
==============================================================================
--- websites/staging/myfaces/trunk/content/wiki/core/committer-and-pmc-guide/myfaces-project-management.html (added)
+++ websites/staging/myfaces/trunk/content/wiki/core/committer-and-pmc-guide/myfaces-project-management.html Tue Jan 28 01:49:20 2014
@@ -0,0 +1,57 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html lang="en">
+ <head>
+ <title>MyFaces Project Management</title>
+
+ <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
+ <meta property="og:image" content="http://www.apache.org/images/asf_logo.gif" />
+
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/style.css">
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/code.css">
+
+
+
+
+
+ </head>
+
+ <body>
+ <div id="page" class="container_16">
+ <div id="header" class="grid_8">
+ <img src="http://www.apache.org/images/feather-small.gif" alt="The Apache Software Foundation">
+ <h1>The Apache Software Foundation</h1>
+ <h2>MyFaces Project Management</h2>
+ </div>
+ <div id="nav" class="grid_8">
+ <ul>
+ <!-- <li><a href="/" title="Welcome!">Home</a></li> -->
+ <li><a href="http://www.apache.org/foundation/" title="The Foundation">Foundation</a></li>
+ <li><a href="http://projects.apache.org" title="The Projects">Projects</a></li>
+ <li><a href="http://people.apache.org" title="The People">People</a></li>
+ <li><a href="http://www.apache.org/foundation/getinvolved.html" title="Get Involved">Get Involved</a></li>
+ <li><a href="http://www.apache.org/dyn/closer.cgi" title="Download">Download</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html" title="Support Apache">Support Apache</a></li>
+ </ul>
+ <p><a href="/">Home</a> » <a href="/wiki/">Wiki</a> » <a href="/wiki/core/">Core</a> » <a href="/wiki/core/committer-and-pmc-guide/">Committer-and-pmc-guide</a></p>
+ <form name="search" id="search" action="http://www.google.com/search" method="get">
+ <input value="*.apache.org" name="sitesearch" type="hidden"/>
+ <input type="text" name="q" id="query">
+ <input type="submit" id="submit" value="Search">
+ </form>
+ </div>
+ <div class="clear"></div>
+ <div id="content" class="grid_16"><div class="section-content"><p><ac:macro ac:name="unmigrated-inline-wiki-markup"><ac:plain-text-body><![CDATA<a href="cdata[{scrollbar}.html">{scrollbar}</a>
+]></ac:plain-text-body></ac:macro>
+<p>Here you will find all information related management of MyFaces project
+and community tasks.</p></p>
+<p><ac:macro ac:name="children" /></p>
+<p><ac:macro ac:name="unmigrated-inline-wiki-markup"><ac:plain-text-body><![CDATA<a href="cdata[{scrollbar}.html">{scrollbar}</a>
+]></ac:plain-text-body></ac:macro></p></div></div>
+ <div class="clear"></div>
+ </div>
+
+ <div id="copyright" class="container_16">
+ <p>Copyright © 2011 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.<br/>Apache and the Apache feather logo are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </body>
+</html>
Added: websites/staging/myfaces/trunk/content/wiki/core/committer-and-pmc-guide/myfaces-project-management/deploying-project-website.html
==============================================================================
--- websites/staging/myfaces/trunk/content/wiki/core/committer-and-pmc-guide/myfaces-project-management/deploying-project-website.html (added)
+++ websites/staging/myfaces/trunk/content/wiki/core/committer-and-pmc-guide/myfaces-project-management/deploying-project-website.html Tue Jan 28 01:49:20 2014
@@ -0,0 +1,93 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html lang="en">
+ <head>
+ <title>Deploying project website</title>
+
+ <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
+ <meta property="og:image" content="http://www.apache.org/images/asf_logo.gif" />
+
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/style.css">
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/code.css">
+
+
+
+
+
+ </head>
+
+ <body>
+ <div id="page" class="container_16">
+ <div id="header" class="grid_8">
+ <img src="http://www.apache.org/images/feather-small.gif" alt="The Apache Software Foundation">
+ <h1>The Apache Software Foundation</h1>
+ <h2>Deploying project website</h2>
+ </div>
+ <div id="nav" class="grid_8">
+ <ul>
+ <!-- <li><a href="/" title="Welcome!">Home</a></li> -->
+ <li><a href="http://www.apache.org/foundation/" title="The Foundation">Foundation</a></li>
+ <li><a href="http://projects.apache.org" title="The Projects">Projects</a></li>
+ <li><a href="http://people.apache.org" title="The People">People</a></li>
+ <li><a href="http://www.apache.org/foundation/getinvolved.html" title="Get Involved">Get Involved</a></li>
+ <li><a href="http://www.apache.org/dyn/closer.cgi" title="Download">Download</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html" title="Support Apache">Support Apache</a></li>
+ </ul>
+ <p><a href="/">Home</a> » <a href="/wiki/">Wiki</a> » <a href="/wiki/core/">Core</a> » <a href="/wiki/core/committer-and-pmc-guide/">Committer-and-pmc-guide</a> » <a href="/wiki/core/committer-and-pmc-guide/myfaces-project-management/">Myfaces-project-management</a></p>
+ <form name="search" id="search" action="http://www.google.com/search" method="get">
+ <input value="*.apache.org" name="sitesearch" type="hidden"/>
+ <input type="text" name="q" id="query">
+ <input type="submit" id="submit" value="Search">
+ </form>
+ </div>
+ <div class="clear"></div>
+ <div id="content" class="grid_16"><div class="section-content"><p><ac:macro ac:name="unmigrated-inline-wiki-markup"><ac:plain-text-body><![CDATA<a href="cdata[{scrollbar}.html">{scrollbar}</a>
+]></ac:plain-text-body></ac:macro>
+<p>MyFaces uses maven to deploy its website. To build and deploy a site for
+a project just run.</p></p>
+<p><ac:macro ac:name="code"><ac:plain-text-body><![CDATA[
+mvn site
+mvn site:deploy
+]
+]></ac:plain-text-body></ac:macro></p>
+<p>The site is initially deployed to minotaur.apache.org (aka
+people.apache.org). From there a periodic task transfers it to the main
+apache site and mirrors, so it can take a few hours for a new site to be
+visible to the public.</p>
+
+<p>If your local username is not the same as your account on
+minotaur.apache.org, then you can add an entry in your maven settings.xml
+file to specify logon details. See the release procedures page on this wiki
+for details.</p>
+
+<p>Other alternative is setup your local environment and your apache
+account so it can log people.apache.org without ask for a manual
+password.</p>
+
+<p>You will also need to be in the "myfaces" unix group in order
+to be able to write to the necessary directories.</p>
+
+<h3>Testing Site Modifications</h3>
+
+<p>Running "mvn clean site" will build the site for the current
+module and all its submodules. However the generated html pages for each
+submodule are placed into the target directory for that module. As a
+result, none of the inter-module links work.</p>
+
+<p>To test a multi-module site, use this instead:</p>
+
+<p><ac:macro ac:name="code"><ac:plain-text-body><![CDATA[
+ mvn site:stage -DstagingDirectory=/tmp/stage
+]
+]></ac:plain-text-body></ac:macro>
+<p>which will assemble a complete site from the partial pieces present in
+the different modules.</p>
+<ac:macro ac:name="unmigrated-inline-wiki-markup"><ac:plain-text-body><![CDATA<a href="cdata[{scrollbar}.html">{scrollbar}</a>
+]></ac:plain-text-body></ac:macro></p></div></div>
+ <div class="clear"></div>
+ </div>
+
+ <div id="copyright" class="container_16">
+ <p>Copyright © 2011 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.<br/>Apache and the Apache feather logo are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </body>
+</html>
Added: websites/staging/myfaces/trunk/content/wiki/core/committer-and-pmc-guide/myfaces-project-management/promote-sandbox-components.html
==============================================================================
--- websites/staging/myfaces/trunk/content/wiki/core/committer-and-pmc-guide/myfaces-project-management/promote-sandbox-components.html (added)
+++ websites/staging/myfaces/trunk/content/wiki/core/committer-and-pmc-guide/myfaces-project-management/promote-sandbox-components.html Tue Jan 28 01:49:20 2014
@@ -0,0 +1,80 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html lang="en">
+ <head>
+ <title>Promote Sandbox Components</title>
+
+ <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
+ <meta property="og:image" content="http://www.apache.org/images/asf_logo.gif" />
+
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/style.css">
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/code.css">
+
+
+
+
+
+ </head>
+
+ <body>
+ <div id="page" class="container_16">
+ <div id="header" class="grid_8">
+ <img src="http://www.apache.org/images/feather-small.gif" alt="The Apache Software Foundation">
+ <h1>The Apache Software Foundation</h1>
+ <h2>Promote Sandbox Components</h2>
+ </div>
+ <div id="nav" class="grid_8">
+ <ul>
+ <!-- <li><a href="/" title="Welcome!">Home</a></li> -->
+ <li><a href="http://www.apache.org/foundation/" title="The Foundation">Foundation</a></li>
+ <li><a href="http://projects.apache.org" title="The Projects">Projects</a></li>
+ <li><a href="http://people.apache.org" title="The People">People</a></li>
+ <li><a href="http://www.apache.org/foundation/getinvolved.html" title="Get Involved">Get Involved</a></li>
+ <li><a href="http://www.apache.org/dyn/closer.cgi" title="Download">Download</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html" title="Support Apache">Support Apache</a></li>
+ </ul>
+ <p><a href="/">Home</a> » <a href="/wiki/">Wiki</a> » <a href="/wiki/core/">Core</a> » <a href="/wiki/core/committer-and-pmc-guide/">Committer-and-pmc-guide</a> » <a href="/wiki/core/committer-and-pmc-guide/myfaces-project-management/">Myfaces-project-management</a></p>
+ <form name="search" id="search" action="http://www.google.com/search" method="get">
+ <input value="*.apache.org" name="sitesearch" type="hidden"/>
+ <input type="text" name="q" id="query">
+ <input type="submit" id="submit" value="Search">
+ </form>
+ </div>
+ <div class="clear"></div>
+ <div id="content" class="grid_16"><div class="section-content"><p><ac:macro ac:name="unmigrated-inline-wiki-markup"><ac:plain-text-body><![CDATA<a href="cdata[{scrollbar}.html">{scrollbar}</a>
+]></ac:plain-text-body></ac:macro>
+<h2>Requirements for a sandbox promotion</h2></p>
+<ul>
+ <li>Component is documented by JavaDoc (general class description
+plus javadoc for each method)</li>
+ <li>Component is documented by a handy example</li>
+ <li>Component is document in the sandbox website (screen shot,
+etc.)</li>
+ <li>Component has been tested with MyFaces and JSF RI</li>
+ <li>Testcase written for that particular Component</li>
+ <li>No issues like <a
+href="http://issues.apache.org/jira/browse/TOMAHAWK-451">TOMAHAWK-451</a></li>
+</ul>
+
+<h2>Steps to take after a positive vote</h2>
+
+<ul>
+ <li>Add a new simple example</li>
+ <li>Perform svn move to tomahawk, myfaces commons or other project
+in myfaces land.</li>
+ <li>Svn move sandbox website documentation to tomahawk website</li>
+ <li>Copy any 3rd-party licensing information from sandbox
+src\main\resources\licenses and sandbox
+src\main\resources\licenses\NOTICE.txt file to tomahawk, myfaces commons or
+other project in myfaces land.</li>
+</ul>
+
+<p><ac:macro ac:name="unmigrated-inline-wiki-markup"><ac:plain-text-body><![CDATA<a href="cdata[{scrollbar}.html">{scrollbar}</a>
+]></ac:plain-text-body></ac:macro></p></div></div>
+ <div class="clear"></div>
+ </div>
+
+ <div id="copyright" class="container_16">
+ <p>Copyright © 2011 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.<br/>Apache and the Apache feather logo are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </body>
+</html>
Added: websites/staging/myfaces/trunk/content/wiki/core/committer-and-pmc-guide/myfaces-project-management/release-a-myfaces-project.html
==============================================================================
--- websites/staging/myfaces/trunk/content/wiki/core/committer-and-pmc-guide/myfaces-project-management/release-a-myfaces-project.html (added)
+++ websites/staging/myfaces/trunk/content/wiki/core/committer-and-pmc-guide/myfaces-project-management/release-a-myfaces-project.html Tue Jan 28 01:49:20 2014
@@ -0,0 +1,89 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html lang="en">
+ <head>
+ <title>Release a MyFaces Project</title>
+
+ <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
+ <meta property="og:image" content="http://www.apache.org/images/asf_logo.gif" />
+
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/style.css">
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/code.css">
+
+
+
+
+
+ </head>
+
+ <body>
+ <div id="page" class="container_16">
+ <div id="header" class="grid_8">
+ <img src="http://www.apache.org/images/feather-small.gif" alt="The Apache Software Foundation">
+ <h1>The Apache Software Foundation</h1>
+ <h2>Release a MyFaces Project</h2>
+ </div>
+ <div id="nav" class="grid_8">
+ <ul>
+ <!-- <li><a href="/" title="Welcome!">Home</a></li> -->
+ <li><a href="http://www.apache.org/foundation/" title="The Foundation">Foundation</a></li>
+ <li><a href="http://projects.apache.org" title="The Projects">Projects</a></li>
+ <li><a href="http://people.apache.org" title="The People">People</a></li>
+ <li><a href="http://www.apache.org/foundation/getinvolved.html" title="Get Involved">Get Involved</a></li>
+ <li><a href="http://www.apache.org/dyn/closer.cgi" title="Download">Download</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html" title="Support Apache">Support Apache</a></li>
+ </ul>
+ <p><a href="/">Home</a> » <a href="/wiki/">Wiki</a> » <a href="/wiki/core/">Core</a> » <a href="/wiki/core/committer-and-pmc-guide/">Committer-and-pmc-guide</a> » <a href="/wiki/core/committer-and-pmc-guide/myfaces-project-management/">Myfaces-project-management</a></p>
+ <form name="search" id="search" action="http://www.google.com/search" method="get">
+ <input value="*.apache.org" name="sitesearch" type="hidden"/>
+ <input type="text" name="q" id="query">
+ <input type="submit" id="submit" value="Search">
+ </form>
+ </div>
+ <div class="clear"></div>
+ <div id="content" class="grid_16"><div class="section-content"><p><ac:macro ac:name="unmigrated-inline-wiki-markup"><ac:plain-text-body><![CDATA<a href="cdata[{scrollbar}.html">{scrollbar}</a>
+]></ac:plain-text-body></ac:macro>
+<h2>Release a MyFaces Project</h2></p>
+<p>All MyFaces projects are now released using Nexus. Just follow the guide
+on:</p>
+
+<ul>
+ <li><a
+href="http://www.apache.org/dev/publishing-maven-artifacts.html">http://www.apache.org/dev/publishing-maven-artifacts.html</a></li>
+</ul>
+
+<p>For each release, a daily guide is keep on the wiki, just for historical
+purposes and to keep track of some special steps. For example take a look
+at:</p>
+
+<ul>
+ <li><a
+href="http://wiki.apache.org/myfaces/CoreRelease211">http://wiki.apache.org/myfaces/CoreRelease211</a></li>
+ <li><a
+href="http://wiki.apache.org/myfaces/TomahawkRelease1111">http://wiki.apache.org/myfaces/TomahawkRelease1111</a></li>
+ <li><a
+href="http://wiki.apache.org/myfaces/MyfacesTestRelease103">http://wiki.apache.org/myfaces/MyfacesTestRelease103</a></li>
+ <li><a
+href="http://wiki.apache.org/myfaces/MyfacesTestRelease103">http://wiki.apache.org/myfaces/MyfacesTestRelease103</a></li>
+ <li><a
+href="http://wiki.apache.org/myfaces/BuilderPluginRelease109">http://wiki.apache.org/myfaces/BuilderPluginRelease109</a></li>
+</ul>
+
+<h2>Old release guides:</h2>
+
+<ul>
+ <li><a
+href="http://wiki.apache.org/myfaces/ReleaseHowTo">http://wiki.apache.org/myfaces/ReleaseHowTo</a></li>
+ <li><a
+href="http://wiki.apache.org/myfaces/Release_Procedure">http://wiki.apache.org/myfaces/Release_Procedure</a></li>
+</ul>
+
+<p><ac:macro ac:name="unmigrated-inline-wiki-markup"><ac:plain-text-body><![CDATA<a href="cdata[{scrollbar}.html">{scrollbar}</a>
+]></ac:plain-text-body></ac:macro></p></div></div>
+ <div class="clear"></div>
+ </div>
+
+ <div id="copyright" class="container_16">
+ <p>Copyright © 2011 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.<br/>Apache and the Apache feather logo are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </body>
+</html>
Added: websites/staging/myfaces/trunk/content/wiki/core/committer-and-pmc-guide/myfaces-project-management/voting-on-a-myfaces-project-release.html
==============================================================================
--- websites/staging/myfaces/trunk/content/wiki/core/committer-and-pmc-guide/myfaces-project-management/voting-on-a-myfaces-project-release.html (added)
+++ websites/staging/myfaces/trunk/content/wiki/core/committer-and-pmc-guide/myfaces-project-management/voting-on-a-myfaces-project-release.html Tue Jan 28 01:49:20 2014
@@ -0,0 +1,133 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html lang="en">
+ <head>
+ <title>Voting on a MyFaces Project Release</title>
+
+ <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
+ <meta property="og:image" content="http://www.apache.org/images/asf_logo.gif" />
+
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/style.css">
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/code.css">
+
+
+
+
+
+ </head>
+
+ <body>
+ <div id="page" class="container_16">
+ <div id="header" class="grid_8">
+ <img src="http://www.apache.org/images/feather-small.gif" alt="The Apache Software Foundation">
+ <h1>The Apache Software Foundation</h1>
+ <h2>Voting on a MyFaces Project Release</h2>
+ </div>
+ <div id="nav" class="grid_8">
+ <ul>
+ <!-- <li><a href="/" title="Welcome!">Home</a></li> -->
+ <li><a href="http://www.apache.org/foundation/" title="The Foundation">Foundation</a></li>
+ <li><a href="http://projects.apache.org" title="The Projects">Projects</a></li>
+ <li><a href="http://people.apache.org" title="The People">People</a></li>
+ <li><a href="http://www.apache.org/foundation/getinvolved.html" title="Get Involved">Get Involved</a></li>
+ <li><a href="http://www.apache.org/dyn/closer.cgi" title="Download">Download</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html" title="Support Apache">Support Apache</a></li>
+ </ul>
+ <p><a href="/">Home</a> » <a href="/wiki/">Wiki</a> » <a href="/wiki/core/">Core</a> » <a href="/wiki/core/committer-and-pmc-guide/">Committer-and-pmc-guide</a> » <a href="/wiki/core/committer-and-pmc-guide/myfaces-project-management/">Myfaces-project-management</a></p>
+ <form name="search" id="search" action="http://www.google.com/search" method="get">
+ <input value="*.apache.org" name="sitesearch" type="hidden"/>
+ <input type="text" name="q" id="query">
+ <input type="submit" id="submit" value="Search">
+ </form>
+ </div>
+ <div class="clear"></div>
+ <div id="content" class="grid_16"><div class="section-content"><p><ac:macro ac:name="unmigrated-inline-wiki-markup"><ac:plain-text-body><![CDATA<a href="cdata[{scrollbar}.html">{scrollbar}</a>
+]></ac:plain-text-body></ac:macro>
+<h2>Voting on a MyFaces Project Release</h2></p>
+<p>An Apache release is a set of valid and signed artifacts, voted on by
+the appropriate PMC and distributed on the ASF's official release
+infrastructure. All voters for a release must verify these items:</p>
+
+<ul>
+ <li>Verify checksums on released files.<a
+href="http://www.apache.org/dev/release-publishing.html#signed"><sup>1</sup></a></li>
+ <li>Validate signatures on released files.<a
+href="http://www.apache.org/dev/release-publishing.html#signed"><sup>1</sup></a></li>
+ <li>Verify that the release source code builds.<a
+href="http://www.apache.org/dev/release-publishing.html#valid"><sup>2</sup></a></li>
+ <li>Verify that all source files have appropriate and compatible
+licensing.<a
+href="http://www.apache.org/dev/release-publishing.html#valid"><sup>2</sup></a></li>
+</ul>
+
+<ul>
+ <li>Optionally verify that each archive type contains the same
+contents.</li>
+</ul>
+
+<p><cite><sup>1</sup><a
+href="http://www.apache.org/dev/release-publishing.html#signed">http://www.apache.org/dev/release-publishing.html#signed</a></cite><br
+/>
+<cite><sup>2</sup><a
+href="http://www.apache.org/dev/release-publishing.html#valid">http://www.apache.org/dev/release-publishing.html#valid</a></cite></p>
+
+<h3>Here is an example of how these tasks can be accomplished under
+linux.</h3>
+
+<h4>verify checksums on released files.</h4>
+
+<p><ac:macro ac:name="noformat"><ac:plain-text-body><![CDATA[
+find . -name '<em>.md5' -exec cat {} \; -printf ' %f\n' | sed 's|.md5$||' |
+md5sum -c
+find . -name '</em>.sha1' -exec cat {} \; -printf ' %f\n' | sed 's|.sha1$||'
+| sha1sum -c
+]
+]></ac:plain-text-body></ac:macro> </p>
+<h4>Validate signatures on released files.</h4>
+
+<p><ac:macro ac:name="noformat"><ac:plain-text-body><![CDATA[
+wget http://www.apache.org/dist/myfaces/KEYS
+gpg --import KEYS
+find . -name '*.asc' -exec gpg --verify {} \;
+]
+]></ac:plain-text-body></ac:macro> </p>
+<h4>Verify tar.gz and zip sources are identical</h4>
+
+<p><ac:macro ac:name="noformat"><ac:plain-text-body><![CDATA[
+mkdir src
+cd src
+tar xvf ../myfaces-core-assembly-2.0.15-src.tar.gz
+ls -l
+mv myfaces-core-2.0.15-src/ myfaces-core-2.0.15-src-tar-gz
+unzip ../myfaces-core-assembly-2.0.15-src.zip
+1. should be no output
+diff -rq myfaces-core-2.0.15-src<em>
+1. should be "are identical" output
+diff -srq myfaces-core-2.0.15-src</em>
+]
+]></ac:plain-text-body></ac:macro></p>
+<h4>Verify that the release source code builds.</h4>
+
+<p><ac:macro ac:name="noformat"><ac:plain-text-body><![CDATA[
+cd myfaces-core-2.0.15-src/src
+find ( -name '<em>.jar' -o -name '</em>.zip' ) -exec unzip -n {} \;
+cd myfaces-core-module-2.0.15/
+mvn install
+]
+]></ac:plain-text-body></ac:macro></p>
+<h4>Verify that all source files have appropriate and compatible
+licensing.</h4>
+
+<p><ac:macro ac:name="noformat"><ac:plain-text-body><![CDATA[
+mvn apache-rat:check
+1. To check for all errors, if more than one project is affected
+1. mvn -e -X apache-rat:check -Drat.numUnapprovedLicenses=9999
+]
+]></ac:plain-text-body></ac:macro></p></div></div>
+ <div class="clear"></div>
+ </div>
+
+ <div id="copyright" class="container_16">
+ <p>Copyright © 2011 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.<br/>Apache and the Apache feather logo are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </body>
+</html>
Added: websites/staging/myfaces/trunk/content/wiki/core/committer-and-pmc-guide/new-committers.html
==============================================================================
--- websites/staging/myfaces/trunk/content/wiki/core/committer-and-pmc-guide/new-committers.html (added)
+++ websites/staging/myfaces/trunk/content/wiki/core/committer-and-pmc-guide/new-committers.html Tue Jan 28 01:49:20 2014
@@ -0,0 +1,128 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html lang="en">
+ <head>
+ <title>New Committers</title>
+
+ <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
+ <meta property="og:image" content="http://www.apache.org/images/asf_logo.gif" />
+
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/style.css">
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/code.css">
+
+
+
+
+
+ </head>
+
+ <body>
+ <div id="page" class="container_16">
+ <div id="header" class="grid_8">
+ <img src="http://www.apache.org/images/feather-small.gif" alt="The Apache Software Foundation">
+ <h1>The Apache Software Foundation</h1>
+ <h2>New Committers</h2>
+ </div>
+ <div id="nav" class="grid_8">
+ <ul>
+ <!-- <li><a href="/" title="Welcome!">Home</a></li> -->
+ <li><a href="http://www.apache.org/foundation/" title="The Foundation">Foundation</a></li>
+ <li><a href="http://projects.apache.org" title="The Projects">Projects</a></li>
+ <li><a href="http://people.apache.org" title="The People">People</a></li>
+ <li><a href="http://www.apache.org/foundation/getinvolved.html" title="Get Involved">Get Involved</a></li>
+ <li><a href="http://www.apache.org/dyn/closer.cgi" title="Download">Download</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html" title="Support Apache">Support Apache</a></li>
+ </ul>
+ <p><a href="/">Home</a> » <a href="/wiki/">Wiki</a> » <a href="/wiki/core/">Core</a> » <a href="/wiki/core/committer-and-pmc-guide/">Committer-and-pmc-guide</a></p>
+ <form name="search" id="search" action="http://www.google.com/search" method="get">
+ <input value="*.apache.org" name="sitesearch" type="hidden"/>
+ <input type="text" name="q" id="query">
+ <input type="submit" id="submit" value="Search">
+ </form>
+ </div>
+ <div class="clear"></div>
+ <div id="content" class="grid_16"><div class="section-content"><p><ac:macro ac:name="unmigrated-inline-wiki-markup"><ac:plain-text-body><![CDATA<a href="cdata[{scrollbar}.html">{scrollbar}</a>
+]></ac:plain-text-body></ac:macro>
+<h2>New Committers</h2></p>
+<p>Congratulations! You have reached committer status. This page will help
+you to get up and started.</p>
+
+<p>Once the Apache Software foundation has granted you committer status,
+you should have gotten a mail similar to following message:</p>
+
+<p><ac:macro ac:name="code"><ac:plain-text-body><![CDATA[
+Dear Max Committer,</p>
+<p>We're glad to tell you that your account has been created and is now
+available for use. Your login details are:</p>
+<p>username: maxcom
+ password: reuhgw342434</p>
+<p>This will grant you access to cvs.apache.org.</p>
+<p>Obviously, we'd request that you change the password as soon as you
+login the first time! Even better would be to change your password and
+then upload your SSH keys to the server so that you then won't need a
+password at all.</p>
+<p>Please note that until the Project Management Committee responsible
+for the project to which you were given group membership actually grants
+you access to the relevant source code modules, you won't be able to
+commit anything. If you have problems committing, you need to email
+pmc@myfaces.apache.org.</p>
+<p>The ASF is a large community spread over a number of different
+technologies and programming languages, with access to a number of
+servers. The project that has requested your account is part of
+the ASF and your account is managed by the ASF infrastructure team.
+In the unlikely case of problems please send an email to
+infrastructure@apache.org outlining your problem.</p>
+<p>More information on the ASF can be found at <a href="http://www.apache.org/">http://www.apache.org/</a>
+and information of interest to developers can be found at
+<a href="http://www.apache.org/dev/">http://www.apache.org/dev/</a>.</p>
+<p>There exist several ASF wide mailing lists that may be of interest to
+you, in particular community@apache.org which is aimed at improving
+relations between the various projects and people within the ASF.</p>
+<p>Should you have any questions of a more general nature then please
+direct them initially to your project.</p>
+<p>We hope your time spent as a committer will be enjoyable,</p>
+<p>The Apache Software Foundation
+]
+]></ac:plain-text-body></ac:macro></p>
+<p>This means that you have access to the apache infrastructure and to the
+apache SVN and ssh servers. You now can login<br />
+into the respective servers via ssh.</p>
+
+<h1>SVN access</h1>
+
+<p>You cannot check-in code until the respective project
+maintainers/committees have granted you write access, which should happen
+soon after you have gotten the above email.<br />
+Afterwards, full write access to your respective project should be enabled.
+If things still fail, contact your respective project
+maintainers/committees.</p>
+
+<p>It's possible to change your SVN password at <a
+href="https://svn.apache.org/change-password">https://svn.apache.org/change-password</a>.</p>
+
+<h3>Useful links </h3>
+
+<ul>
+ <li><a href="http://www.apache.org/dev/">Developers Link</a>
+ <ul>
+ <li><a
+href="http://www.apache.org/dev/new-committers-guide.html">Official
+Guide</a></li>
+ </ul>
+ </li>
+ <li><a
+href="http://www.apache.org/dev/version-control.html">detailed info</a> on
+the svn access</li>
+ <li><a href="http://subversion.apache.org">Subversion</a> main
+page</li>
+</ul>
+
+<p><ac:macro ac:name="unmigrated-inline-wiki-markup"><ac:plain-text-body><![CDATA<a href="cdata[{scrollbar}.html">{scrollbar}</a>
+]></ac:plain-text-body></ac:macro></p></div></div>
+ <div class="clear"></div>
+ </div>
+
+ <div id="copyright" class="container_16">
+ <p>Copyright © 2011 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.<br/>Apache and the Apache feather logo are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </body>
+</html>
Added: websites/staging/myfaces/trunk/content/wiki/core/faq.html
==============================================================================
--- websites/staging/myfaces/trunk/content/wiki/core/faq.html (added)
+++ websites/staging/myfaces/trunk/content/wiki/core/faq.html Tue Jan 28 01:49:20 2014
@@ -0,0 +1,935 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html lang="en">
+ <head>
+ <title>FAQ</title>
+
+ <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
+ <meta property="og:image" content="http://www.apache.org/images/asf_logo.gif" />
+
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/style.css">
+ <link rel="stylesheet" type="text/css" media="screen" href="http://www.apache.org/css/code.css">
+
+
+
+
+
+ </head>
+
+ <body>
+ <div id="page" class="container_16">
+ <div id="header" class="grid_8">
+ <img src="http://www.apache.org/images/feather-small.gif" alt="The Apache Software Foundation">
+ <h1>The Apache Software Foundation</h1>
+ <h2>FAQ</h2>
+ </div>
+ <div id="nav" class="grid_8">
+ <ul>
+ <!-- <li><a href="/" title="Welcome!">Home</a></li> -->
+ <li><a href="http://www.apache.org/foundation/" title="The Foundation">Foundation</a></li>
+ <li><a href="http://projects.apache.org" title="The Projects">Projects</a></li>
+ <li><a href="http://people.apache.org" title="The People">People</a></li>
+ <li><a href="http://www.apache.org/foundation/getinvolved.html" title="Get Involved">Get Involved</a></li>
+ <li><a href="http://www.apache.org/dyn/closer.cgi" title="Download">Download</a></li>
+ <li><a href="http://www.apache.org/foundation/sponsorship.html" title="Support Apache">Support Apache</a></li>
+ </ul>
+ <p><a href="/">Home</a> » <a href="/wiki/">Wiki</a> » <a href="/wiki/core/">Core</a></p>
+ <form name="search" id="search" action="http://www.google.com/search" method="get">
+ <input value="*.apache.org" name="sitesearch" type="hidden"/>
+ <input type="text" name="q" id="query">
+ <input type="submit" id="submit" value="Search">
+ </form>
+ </div>
+ <div class="clear"></div>
+ <div id="content" class="grid_16"><div class="section-content"><p><ac:macro ac:name="unmigrated-inline-wiki-markup"><ac:plain-text-body><![CDATA<a href="cdata[{scrollbar}.html">{scrollbar}</a>
+]></ac:plain-text-body></ac:macro>
+<h1>Frequently Asked Questions</h1></p>
+<p>Note that in addition to this FAQ, there are a number of
+"how-to" guides on the <a
+href="https://cwiki.apache.org/confluence/display/MYFACES/Index">MyFaces
+wiki home page</a> that address common issues.</p>
+
+<p><ac:macro ac:name="toc"><ac:parameter
+ac:name="maxLevel">4</ac:parameter><ac:parameter
+ac:name="minLevel">2</ac:parameter></ac:macro></p>
+<h3>What is MyFaces?</h3>
+
+<p> MyFaces is a family of projects related to the JavaServer Faces
+(JSF) specification published as part of the Java Community Process. The
+"core" project is an implementation of that specification. Other
+MyFaces projects implement related specifications (eg the Portlet Bridge),
+or add features to any JSF implementation (not just the Myfaces Core).</p>
+
+<h2>JSF FAQ</h2>
+
+<h3>Are there any other FAQ sites for JSF?</h3>
+
+<p>There is an excellent FAQ addressing general JSF issues at <a
+href="http://www.jsfcentral.com/faq">www.jsfcentral.com</a>. There are a
+number of other places where such information is available; just use the
+web's search engines!</p>
+
+<h2>JSF SPEC</h2>
+
+<h3>I don't like something about the JSF specification. How can I change
+it?</h3>
+
+<p>You can create issues on <a
+href="http://java.net/jira/browse/JAVASERVERFACES_SPEC_PUBLIC">JAVASERVERFACES-SPEC-PUBLIC</a>
+to send your suggestion for the next version of JSF. This will be received
+by the JSR spec leads, and if considered reasonable will be added to the
+project issue tracker. </p>
+
+<p>Additionally, you can suscribe to <a
+href="http://myfaces.apache.org/mail-lists.html">MyFaces Users and Dev
+lists</a> and send your suggestions there. In this way, a MyFaces PMC
+member could help to include that feature on the Expert Group.</p>
+
+<h3>What is the difference between javax.faces.STATE_SAVING_METHOD client
+and server? </h3>
+
+<p>In short, server-side-state stores information held by the UI components
+(ie the "widgets") in the HTTP Session, while client-side state
+stores it in hidden fields in the page sent back to the user.</p>
+
+<p>Client-side-state scales much better for very large numbers of users, as
+no memory is required on the server for user state. However the
+disadvantage is that more data gets transferred across the network for each
+request.</p>
+
+<p>Any session-scoped managed beans still remain in the http session, even
+with client-side-state selected; this flag only affects where the JSF
+implementation stores data that the UI components hold internally.</p>
+
+<p>For the technical details, see:</p>
+
+<ul>
+ <li><a
+href="http://java.sun.com/javaee/5/docs/tutorial/doc/bnavu.html#bnavz">http://java.sun.com/javaee/5/docs/tutorial/doc/bnavu.html#bnavz</a></li>
+ <li><a
+href="http://java.sun.com/javaee/5/docs/tutorial/doc/bnaxj.html#bnaxn">http://java.sun.com/javaee/5/docs/tutorial/doc/bnaxj.html#bnaxn</a></li>
+</ul>
+
+<h3>The Browser always shows a link to the previous page. Why?</h3>
+
+<p>By default, JSF uses "forward" operations internally to
+navigate between pages.</p>
+
+<p>So a user first views page A, and gets back some content. The content
+will be wrapped in a form that has page A as the address to submit to.</p>
+
+<p>When the user then does something to cause that page to submit (eg
+clicks on a "save" button), then JSF receives that post request,
+restores the view for page A and performs postback processing. As part of
+the postback processing, the logic for page A may tell the JSF framework
+that page B should now be shown. </p>
+
+<p>By default, JSF will then perform an internal forward to page B, causing
+that page to be rendered back to the user as the result of their form post.
+</p>
+
+<p>The user now sees page B on their screen. However all the browser knows
+is that it sent some data to page A, so that is the url that it will show
+in the browser navigation bar even though the content on display is page B.
+Unfortunately HTTP/HTML provide no way to tell the browser that it should
+display the url for page B in the browser. Therefore with JSF default
+behaviour, the browser url is always "one page behind" the
+content actually being shown.</p>
+
+<p>Not only does this look odd to users, but it makes bookmarking pages
+within a JSF application difficult. Note, however, that bookmarking
+arbitrary places within JSF applications (which are usually very
+interactive and stateful) is not always sensible anyway.</p>
+
+<p>Another disadvantage of this "optimisation" is that it is not
+safe to use relative links anywhere within a JSF view (eg relative path to
+a stylesheet or icon). When a browser posts to page A, and gets back
+content for page B it will resolve any relative links in the returned page
+relative to the last url it knew about. So on the first view of page B, all
+relative links are relative to A; if A is in a different directory then all
+relative links in the view definition for page B are broken.</p>
+
+<p>One solution is to use navigation rules marked with <redirect/>.
+Then, instead of performing an internal forward to the new page, an http
+redirect command is sent to the browser, causing it to then fetch the new
+page. This is less efficient, however, as the browser now has to make a
+second request to get its content, instead of just getting the content
+immediately as a response to its original form posting. Another serious
+issue is that because the fetch of page B is in a separate request, it is
+impossible for page A to pass any data to page B via request-scoped
+variables. Using request-scoped variables for this purpose is quite
+convenient and therefore quite common.</p>
+
+<h2>Myfaces FAQ </h2>
+
+<h3>Why should I use MyFaces Core?</h3>
+
+<p><em>"... Every Java EE application server comes with a bundled JSF
+implementation. Often the reference implementation (RI), known as
+"Mojarra", is used for this. However, you can bundle an
+alternative JSF implementation to be used with your project. This way, you
+can use MyFaces Core as JSF implementation on every Java EE application
+server. One of the benefits of using MyFaces Core is that it generates more
+informative logging, which can be helpful while debugging. If you're
+looking for an application server that uses MyFaces Core by default, you
+should take a look at <a href="http://geronimo.apache.org/">Apache
+Geronimo</a>..."</em> <sub>Thanks to Bart Kummel for provide this text
+from its book <a
+href="http://www.packtpub.com/apache-myfaces-1-2-web-application-development/book/mid/25011044nqxl?utm_source=bartkummel.net&utm_medium=affiliate&utm_content=blog&utm_campaign=mdb_002220">Apache
+MyFaces 1.2 Web Application Development</a></sub></p>
+
+<p>Other reason why choose MyFaces core are:</p>
+
+<ul>
+ <li>Community over code: MyFaces community counts with a lot of
+folks with outstanding knowledge on JSF. Suscribe to user and dev mailing
+lists are the best way to know what's going on, receive feedback and know
+other people interested in JSF. This is an important consideration, because
+sometimes you can find a bug or need to ask something to somebody about
+JSF.</li>
+ <li>Innovation happens on MyFaces: MyFaces is not just a JSF
+implementation, it host other projects (Trinidad,Tobago, Tomahawk, ExtVal,
+CODI, Orchestra, PortletBridge RI, ....) that provides additional
+functionality not provided by JSF implementation itself.</li>
+ <li>MyFaces Core generates code using myfaces-builder-plugin: these
+project is a maven plugin that with myfaces-builder-annotations provides a
+jsf development kit to create multiple artifacts (components, converters,
+validators, client behaviors) and handle all documentation related in an
+easier way, minimizing the number of files you need to handle. It uses java
+annotations to feed all related information, and each myfaces jar using
+this tool has a myfaces-metadata.xml which contains all meta-information
+required to build each bundle. This tool can read composite component
+definitions and build an integrated documentation with your normal
+components, converters or validators.</li>
+ <li>MyFaces uses Maven, so edit the code or rebuild it is as simple
+as open any maven project with your IDE. Note that most IDEs has built-in
+support for maven.</li>
+ <li>MyFaces Core is "OSGi" friendly: It provides some SPI
+interfaces to deal with special setups, when you need core control over
+classloading. A lot of good stuff has been put in this area.</li>
+ <li>MyFaces Core is tested everyday against MyFaces UI component
+libraries and Add-ons/Extensions. Many of these projects are compatible
+with both MyFaces and Mojarra (because they are build on top of JSF
+standard), but you should note that those projects helps MyFaces Core to
+keep code in good shape, because all those projects test against MyFaces
+Core, and if there is a bug, it is handled more quickly (because everything
+is handled "in home").</li>
+</ul>
+
+<p>For more technical reasons why choose MyFaces core take a look at <a
+href="http://lu4242.blogspot.com/2011/06/10-reason-why-choose-myfaces-core-as.html">this
+blog</a>.</p>
+
+<h3>I have a problem. Should I open a JIRA issue on it or ask about it on
+the mailing list? </h3>
+
+<p>Please ask all questions on the !MyFaces users list.</p>
+
+<p>As as guideline, only create a JIRA issue if</p>
+
+<ul>
+ <li>The same code works in another implementation (eg Sun Mojarra)
+but not in !MyFaces.</li>
+ <li>The same code works in another version of !MyFaces.</li>
+ <li>You've examined the !MyFaces source code and have come up with
+a patch that fixes the behavior.</li>
+ <li>You've asked on the mailing list, and someone has confirmed
+it's a bug and asked you to open a JIRA issue.</li>
+</ul>
+
+<p>In all other cases, ask first on the users mailing list.</p>
+
+<h3>How can I donate new components?</h3>
+
+<p>There are various ways, you can send a note in the mailing list of
+!MyFaces for direct contact with the developers and guidance on what to do,
+you can put your component into <a
+href="https://issues.apache.org/jira/browse/TOMAHAWK">Tomahawk issue
+tracker</a>. There are no strict rules for the participation at the
+sandbox, all you need is some good components.</p>
+
+<h3>Where can I download source code jars?</h3>
+
+<p>Source for released versions of MyFaces Core can be found here:</p>
+
+<ul>
+ <li><a class="external-link"
+href="http://svn.apache.org/repos/asf/myfaces/core/tags"
+rel="nofollow">http://svn.apache.org/repos/asf/myfaces/core/tags</a></li>
+ <li><a class="external-link"
+href="http://svn.apache.org/repos/asf/myfaces/shared/tags"
+rel="nofollow">http://svn.apache.org/repos/asf/myfaces/shared/tags</a></li>
+</ul>
+
+<p>Note that MyFaces Core 1.1.x releases (ie implementations of JSF 1.1)
+include code from the shared project versions 2.0.x. MyFaces Core 1.2.x
+releases (ie implementations of JSF 1.2) include code from the shared
+project versions 3.0.x.</p>
+
+<p>Since version 2.0.8 and 2.1.2, shared code was bundled as a module in
+core, so you only need to checkout its related tags folder.</p>
+
+<p>Source for Tomahawk</p>
+
+<ul>
+ <li><a class="external-link"
+href="http://svn.apache.org/repos/asf/myfaces/tomahawk/tags/"
+rel="nofollow">http://svn.apache.org/repos/asf/myfaces/tomahawk/tags/</a></li>
+ <li><a class="external-link"
+href="http://svn.apache.org/repos/asf/myfaces/shared/tags/"
+rel="nofollow">http://svn.apache.org/repos/asf/myfaces/shared/tags/</a>
+(choose 2.0.x tags)</li>
+</ul>
+
+<p>You can also find builds at this location:<br />
+ <a class="external-link" href="http://people.apache.org/builds/myfaces/"
+rel="nofollow">http://people.apache.org/builds/myfaces/</a></p>
+
+<p>Sources jars usable in IDEs are available from the maven2 repository
+directories:</p>
+
+<ul>
+ <li><a class="external-link"
+href="http://www.ibiblio.org/maven2/org/apache/myfaces/core/"
+rel="nofollow">http://www.ibiblio.org/maven2/org/apache/myfaces/core/</a></li>
+ <li><a class="external-link"
+href="http://www.ibiblio.org/maven2/org/apache/myfaces/shared/"
+rel="nofollow">http://www.ibiblio.org/maven2/org/apache/myfaces/shared/</a></li>
+</ul>
+
+<h3>Where can I download a sandbox jar? </h3>
+
+<p>Binaries of not-yet-released code can be grabbed from the maven build
+repositories.</p>
+
+<ul>
+ <li><a class="external-link"
+href="https://repository.apache.org/content/repositories/snapshots/org/apache/myfaces/"
+rel="nofollow">https://repository.apache.org/content/repositories/snapshots/org/apache/myfaces/</a></li>
+</ul>
+
+<p>For example, the sandbox jar is available beneath here:</p>
+
+<ul>
+ <li><a class="external-link"
+href="https://repository.apache.org/content/repositories/snapshots/org/apache/myfaces/tomahawk/tomahawk-sandbox20/"
+rel="nofollow">https://repository.apache.org/content/repositories/snapshots/org/apache/myfaces/tomahawk/tomahawk-sandbox20/</a></li>
+ <li><a class="external-link"
+href="https://repository.apache.org/content/repositories/snapshots/org/apache/myfaces/tomahawk/tomahawk-sandbox12/"
+rel="nofollow">https://repository.apache.org/content/repositories/snapshots/org/apache/myfaces/tomahawk/tomahawk-sandbox12/</a></li>
+ <li><a class="external-link"
+href="https://repository.apache.org/content/repositories/snapshots/org/apache/myfaces/tomahawk/tomahawk-sandbox/"
+rel="nofollow">https://repository.apache.org/content/repositories/snapshots/org/apache/myfaces/tomahawk/tomahawk-sandbox/</a></li>
+</ul>
+
+<h3>What is the "shared" project? </h3>
+
+<p>If myfaces-core, tomahawk, tobago and trinidad were completely separate
+projects, then there would be no need for a "shared" code
+project; each project would maintain its own code in its own namespace.
+However there would be lots of code duplication and wasted effort. As these
+projects are all under the "myfaces" umbrella, code that is
+common to multiple projects can be placed into the "shared"
+project thus reducing development and maintenance effort, and making the
+projects more consistent with each other.</p>
+
+<p>However these projects all have separate release cycles, and in addition
+tomahawk/tobago/trinidad should be runnable on JSF implementations other
+than myfaces-core. The solution currently in use is a compilation hack that
+renames the shared class package; the code is renamed to
+"org.apache.myfaces.shared_impl" for inclusion in the
+myfaces-impl jarfile, "org.apache.myfaces.shared_tomahawk" for
+inclusion in the tomahawk jarfile etc. In this manner, each project can be
+deployed with all the shared support classes it needs (with the right
+features and fixes) without needing a separate shared jarfile, and without
+worrying about conflicting definitions of the same class. An upgrade to one
+of these projects won't affect any other deployed in the same
+environment.</p>
+
+<p>The shared code has release numbers that are separate from the release
+numbers of projects that use it. For example, <br />
+ <a class="external-link"
+href="http://svn.apache.org/repos/asf/myfaces/tomahawk/tags/1_1_3/core/pom.xml"
+rel="nofollow">http://svn.apache.org/repos/asf/myfaces/tomahawk/tags/1_1_3/core/pom.xml</a><br
+/>
+shows that tomahawk 1.1.3 has a dependency on version 2.0.2 of the shared
+project.</p>
+
+<p>Note that file myfaces-impl-1.1.4.jar includes the .class files for the
+shared project, but myfaces-impl-1.1.4-sources.jar does not include the
+matching source files; myfaces-shared-impl-2.0.3.jar needs to be added to
+access the java source. Recent releases of MyFaces projects that use the
+shared lib now include the source from the shared project in their -sources
+jars so adding an extra sources jar is not necessary.</p>
+
+<p>Since version 2.0.8 and 2.1.2, shared code was bundled as a module in
+core, to make easier work with MyFaces Core.</p>
+
+<h3>How can I get pretty-formatted HTML output from Myfaces?</h3>
+
+<p>The [<ac:link><ri:page ri:content-title="JTidy" /><ac:link-body>http://jtidy.sourceforge.net</ac:link-body></ac:link>](<ac:link><ri:page-ri:content-title="jtidy"-/><ac:link-body>http://jtidy.sourceforge.net</ac:link-body></ac:link>.html)
+ project provides a [<ac:link><ri:page ri:content-title="Servlet Filter" /><ac:link-body>http://jtidy.sourceforge.net/multiproject/jtidyservlet/filter.html</ac:link-body></ac:link>]
+ that reformats response messages before they are sent out. </p>
+
+<p>The Mozilla Firefox web browser has an optional extension "[<ac:link><ri:page ri:content-title="View Formatted Source" /><ac:link-body>https://addons.mozilla.org/extensions/moreinfo.php?id=697</ac:link-body></ac:link>](<ac:link><ri:page-ri:content-title="view-formatted-source"-/><ac:link-body>https://addons.mozilla.org/extensions/moreinfo.php?id=697</ac:link-body></ac:link>.html)
+" which allows developers to see source correctly formatted without
+any changes at the server end.</p>
+
+<p>In some versions of MyFaces there is a context param
+"org.apache.myfaces.PRETTY_HTML" that can be specified in the
+web.xml to enable pretty output. However this option was never well
+supported as it requires support from every renderer in order to work. This
+feature may be removed from future versions of MyFaces.</p>
+
+<h3>What do version numbers mean for the MyFaces Core and Tomahawk
+releases?</h3>
+
+<p>MyFaces Core uses 3-part version numbers, eg 1.1.1. However this value
+is different from the usual version numbering. The first two digits
+indicate which JSF specification the release is an implementation of.
+Because the binary api for a JSF specification does not change, two
+releases with the same first two digits are guaranteed to be binary
+compatible; all existing code using JSF-specified features will continue to
+work as previously (unless the previous behaviour was buggy).</p>
+
+<p>The Tomahawk library also uses the same format of version number.
+However as the JSF 1.2 specification is backwards-compatible with the JSF
+1.1 specification, Tomahawk releases with version numbers 1.1.x also work
+fine with JSF 1.2. Note however that Tomahawk releases are not guaranteed
+to be binary compatible with he previous Tomahawk release; an increment in
+the third digit is simply a release-count and <em>"not"</em> a
+"patch version". There are no releases of Tomahawk that are
+simply "bugfix" releases</p>
+
+<p>Note in addition that Tomahawk releases are only tested with the latest
+versions of the MyFaces and Sun JSF implementations available at the time
+of release. success with other versions of these libraries, or with other
+libraries is likely but not guaranteed. In particular, when running early
+releases of Tomahawk with MyFaces Core, the versions used generally had to
+match exactly (due to the way the "shared" library was used).
+This has since been improved, and recent Tomahawk releases have a good
+chance of working with multiple versions of MyFaces Core.</p>
+
+<h3>Why isn't javax.faces.model.DataModel serializable?</h3>
+
+<p>The DataModel class (used with UIData components) doesn't have any state
+that needs to be preserved between render and restore-view phases.
+Therefore, there is no need for it to be serializable.</p>
+
+<p>If you have a managed bean that you want to be serializable, and there
+is a member of type DataModel then just mark it transient.</p>
+
+<p>If you want to serialize the list within the !DataModel along with the
+managed bean, then do this:</p>
+
+<p><ac:macro ac:name="code"><ac:parameter
+ac:name="borderStyle">solid</ac:parameter><ac:parameter
+ac:name="title">SomeManagedBean.java</ac:parameter><ac:plain-text-body><![CDATA[
+public class SomeManagedBean implements Serializable {
+ private List myData;</p>
+<p>private transient DataModel myDataModel;</p>
+<p>public DataModel getDataModel() {
+ if (myDataModel == null) {
+ myDataModel = new ListDataModel(myData);
+ }
+ return myDataModel;
+ }
+}
+]
+]></ac:plain-text-body></ac:macro> </p>
+<h3>Why are my dates displaying the wrong day/time?</h3>
+
+<p>The JSF specification requires that date->string converters default
+to using the standard UTC (aka GMT) timezone.</p>
+
+<p>Note that MyFaces releases 1.1.0 and earlier did not comply with the JSF
+spec; they defaulted to using the<br />
+timezone of the server.</p>
+
+<p>You can control the timezone used by the conversion by attaching an
+explicit converter:</p>
+
+<p><ac:macro
+ac:name="code"><ac:default-parameter>xml</ac:default-parameter><ac:plain-text-body><![CDATA[
+ <f:convertDateTime timeZone="Antarctica/South_Pole" .../>
+]
+]></ac:plain-text-body></ac:macro></p>
+<p>or</p>
+
+<p><ac:macro
+ac:name="code"><ac:default-parameter>xml</ac:default-parameter><ac:plain-text-body><![CDATA[
+ <f:convertDateTime timeZone="#{bean.timeZone}" .../>
+]
+]></ac:plain-text-body></ac:macro></p>
+<p>where #{bean.timeZone} returns either a string id, or a TimeZone
+instance.</p>
+
+<p>The <a href="http://myfaces.apache.org/commons/index.html">MyFaces
+commons converters project</a> contains a custom converter tag which is
+like f:convertDateTime, but defaults to using the timezone of the
+server:</p>
+
+<p><ac:macro
+ac:name="code"><ac:default-parameter>xml</ac:default-parameter><ac:plain-text-body><![CDATA[
+ <mcc:convertDateTime/>
+]
+]></ac:plain-text-body></ac:macro></p>
+<p>Alternatively you register your own converter to override the standard
+converter, causing your custom code to be applied by default to all
+date->string conversions.</p>
+
+<h3>How can I access one Managed Bean from another?</h3>
+
+<p>See <a
+href="https://cwiki.apache.org/confluence/display/MYFACES/Accessing+one+managed+bean+from+another">Accessing
+one managed bean from another</a></p>
+
+<h3>Handling forward references to components in JSP pages</h3>
+
+<p>Note: this information applies only to projects using JSF 1.1 and JSP.
+Projects using either JSF 1.2 or Facelets can ignore this section.</p>
+
+<p>In some cases, a component in a JSP page needs to reference another
+component by id. One common example is the tomahawk t:dataScroller
+component. This is fine when the referencing component is later in the page
+than the one it refers to. But when the components are in the wrong order,
+an error is reported.</p>
+
+<p><ac:macro
+ac:name="code"><ac:default-parameter>xml</ac:default-parameter><ac:plain-text-body><![CDATA[</p>
+<p><t:dataScroller for="someTable" .../></p>
+<p><t:dataTable id="someTable" .../></p>
+<p>]
+]></ac:plain-text-body></ac:macro></p>
+<p>When using JSP, creating and rendering of components is done in a single
+pass through the JSP page. This means that when the dataScroller is
+rendered, the dataTable it refers to has not yet been created, causing an
+error message about "cannot find UIData" to be displayed. Other
+components that refer to some associated component using a "for"
+attribute or similar mechanism will have this problem too.</p>
+
+<p>This can be resolved by wrapping the components in a parent component
+that "renders its children". Such components cause their nested
+components to be processed in two passes (create then render):</p>
+
+<p><ac:macro
+ac:name="code"><ac:default-parameter>xml</ac:default-parameter><ac:plain-text-body><![CDATA[
+ <h:panelGroup>
+ <t:dataScroller for="someTable" .../>
+ <t:dataTable id="someTable" .../>
+ </h:panelGroup>
+]
+]></ac:plain-text-body></ac:macro></p>
+<p>This does have a few minor drawbacks. In JSF 1.1, components that render
+their children interact badly with nested "template text" and
+non-JSF JSP tags. Avoid non-JSF JSP tags within such components, and wrap
+any "template text" in f:verbatim tags to resolve this
+problem.</p>
+
+<p>An alternative solution is to move to a presentation technology that
+uses separate "create" and "render" passes; Facelets
+and Clay both do this.</p>
+
+<h3>How do I know when a managed bean's properties have all been set?</h3>
+
+<p>A managed bean must have a default constructor (ie one with no
+parameters). Any managed-property declarations then cause the appropriate
+setter methods to be called. However it's common to want to perform some
+initialisation once ''all'' of the bean's properties have been defined.</p>
+
+<p>Spring provides a post-initialisation callback; any bean implementing
+!InitializingBean gets its afterPropertiesSet method called. There isn't
+any exact equivalent in JSF, but something close can be achieved by: </p>
+
+<ul>
+ <li>defining a setter method on the bean, eg "public void
+setInitialized(boolean state)"</li>
+ <li>defining this as the last managed property for the bean:</li>
+</ul>
+
+<p><ac:macro
+ac:name="code"><ac:default-parameter>xml</ac:default-parameter><ac:plain-text-body><![CDATA[
+ <managed-bean>
+ ....
+ <managed-property>
+ <property-name>initialized</property-name>
+ <value>true</value>
+ </managed-property>
+ </managed-bean>
+]
+]></ac:plain-text-body></ac:macro></p>
+<p>The JSF spec requires that managed properties are initialised in the
+order they are declared, so the setInitialized method will be called only
+after all other properties have been set.</p>
+
+<p>In future versions of JSF, it may be possible to annotate managed bean
+methods with @!PostConstruct and @!PreDestroy to perform this
+functionality. See:</p>
+
+<ul>
+ <li><a class="external-link"
+href="https://javaserverfaces-spec-public.dev.java.net/issues/show_bug.cgi?id=119"
+rel="nofollow">https://javaserverfaces-spec-public.dev.java.net/issues/show_bug.cgi?id=119</a></li>
+</ul>
+
+<h3>"My PhaseListener is called twice"</h3>
+
+<p>The JSF specification requires any JSF implementation to automatically
+load /WEB-INF/faces-config.xml at startup. There is consequently no need
+for the following context parameter:</p>
+
+<p><ac:macro
+ac:name="code"><ac:default-parameter>xml</ac:default-parameter><ac:plain-text-body><![CDATA[
+<context-param>
+ <param-name>javax.faces.CONFIG_FILES</param-name>
+ <param-value>/WEB-INF/faces-config.xml</param-value>
+</context-param>
+]
+]></ac:plain-text-body></ac:macro></p>
+<p>Putting this context parameter in your deployment descriptor will force
+any JSF implementation to load the configuration twice, therefore
+registering each phase listener twice.</p>
+
+<p>If you are using portlets, see [<ac:link><ri:page ri:content-title="MYFACES-1338" /><ac:link-body>http://issues.apache.org/jira/browse/MYFACES-1338</ac:link-body></ac:link>](<ac:link><ri:page-ri:content-title="myfaces-1338"-/><ac:link-body>http://issues.apache.org/jira/browse/myfaces-1338</ac:link-body></ac:link>.html)
+</p>
+
+<h3>"Action listeners and actions for my commands on dataTables do not
+fire" </h3>
+
+<p>Action listeners and actions are not invoked when the action source (
+h:commandLink, h:commandButton ) is not rendered. When our action sources
+are on a dataTable, and the value attribute of the dataTable points to a
+request scoped data source, the action source just isn't rendered on a
+subsequent request.</p>
+
+<p><ac:macro
+ac:name="code"><ac:default-parameter>xml</ac:default-parameter><ac:plain-text-body><![CDATA[
+<h:dataTable value="#{requestScopedBean.dataModel.wrappedData}" />
+ <h:column>
+ <h:commandLink value="click here"
+action="#{backingBean.willNotFire}" />
+ </h:column>
+</h:dataTable>
+]
+]></ac:plain-text-body></ac:macro></p>
+<p>The action source ( h:commandLink, h:commandButton ), is not rendered
+because the data source does not exist during a subsequent request ( it was
+garbage collected after the first response was completed).</p>
+
+<p>To solve this problem, use t:saveState or put the request scoped backing
+bean in session scope.</p>
+
+<p><ac:macro
+ac:name="code"><ac:default-parameter>xml</ac:default-parameter><ac:plain-text-body><![CDATA[
+<t:saveState value="#{myRequestScopedBean.dataModel.wrappedData}" />
+]
+]></ac:plain-text-body></ac:macro></p>
+<p>t:saveState is preffered over a session scoped solution.</p>
+
+<h3>Calendar, Tree, etc wont work or javascript errors</h3>
+
+<p>You have to configure the MyFacesExtensionsFilter - see: [<a href="http://myfaces.apache.org/tomahawk/extensionsFilter.html">http://myfaces.apache.org/tomahawk/extensionsFilter.html</a>](<a-href="http://myfaces.apache.org/tomahawk/extensionsfilter.html">http://myfaces.apache.org/tomahawk/extensionsfilter.html</a>.html)
+</p>
+
+<h3>Error "ExtensionsFilter not correctly configured."</h3>
+
+<p>If you are getting the error "java.lang.!IllegalStateException:
+!ExtensionsFilter not correctly configured. JSF mapping missing. JSF pages
+not covered", and everything is well configured:</p>
+
+<p> 1. Make sure that you have the correct filters as explained in [<a href="http://myfaces.apache.org/tomahawk/extensionsFilter.html">http://myfaces.apache.org/tomahawk/extensionsFilter.html</a>](<a-href="http://myfaces.apache.org/tomahawk/extensionsfilter.html">http://myfaces.apache.org/tomahawk/extensionsfilter.html</a>.html)
+<br />
+ 2. If you are using servlets 2.4, you cannot do a jsp:forward or
+request.getDispatcher().forward to any page, because the extensions filter
+is not executed. Instead you may want to try with a
+response.sendRedirect()</p>
+
+<h3>The Tomahawk ExtensionsFilter is not working on Websphere</h3>
+
+<p>You may need to set the special websphere property
+com.ibm.ws.webcontainer.invokefilterscompatibility to true.</p>
+
+<p>It looks like Websphere does not run filters when a request url does not
+map to a servlet <em>and</em> does not map to a file on disk.<br />
+As Tomahawk !ExtensionFilter urls do neither of these, Websphere simply
+doesn't run the filter. Setting the above property to true causes Websphere
+to act<br />
+like every other servlet engine on planet earth, and run the filters in all
+cases.</p>
+
+<h3>Using the tomahawk :popup tag causes java.lang.NullPointerException in
+HtmlPopupRenderer.encodeEnd </h3>
+
+<p>The facet name needs to be hard coded "popup".</p>
+
+<h3>ClassCastException in com.sun.facelets.tag.jsf.ActionSourceRule when
+using the tomahawk dataScroller</h3>
+
+<p>Update to the latest Tomahawk jar from <a class="external-link"
+href="http://myfaces.apache.org/download.html"
+rel="nofollow">http://myfaces.apache.org/download.html</a></p>
+
+<h3>Using the tomahawk you get java.lang.NoClassDefFoundError:
+org/apache/commons/lang/builder/HashCodeBuilder</h3>
+
+<p>Download the latest jakarta commons jars (inside the MyFaces Core 1.1.3
+or later distribution) from <a class="external-link"
+href="http://myfaces.apache.org/download.html"
+rel="nofollow">http://myfaces.apache.org/download.html</a></p>
+
+<h3>WARNING: The AdfFacesFilter has not been installed. ADF Faces requires
+this filter for proper execution.</h3>
+
+<p>Use a servlet-name in web.xml: adfFaces Faces Servlet ... where you've
+assigned "Faces Servlet" as the name of the FacesServlet as below
+Faces Servlet javax.faces.webapp.FacesServlet 1</p>
+
+<h3>The ADF component doesn't popup anything or submit (no javascript
+working). Error: submitForm is not defined </h3>
+
+<p>You need to define how the ADF resources (such as .js files and images)
+are provided in web.xml resources
+oracle.adf.view.faces.webapp.ResourceServlet resources /adf/*</p>
+
+<h3>The MyFaces component doesn't popup anything or submit (no javascript
+working).</h3>
+
+<p>You need to define how the MyFaces resources (such as .js files and
+images) are provided in web.xml with a MyFacesExtensionsFilter entry.</p>
+
+<h3>NullPointerException in adf faces at the start of the render phase OR
+rendering warnings</h3>
+
+<p><ac:macro ac:name="code"><ac:plain-text-body><![CDATA[
+Mar 21, 2006 12:10:15 AM
+org.apache.myfaces.renderkit.html.HtmlRenderKitImpl getRenderer WARNING:
+Unsupported component-family/renderer-type:
+oracle.adf.Panel/oracle.adf.Group
+Mar 21, 2006 12:10:15 AM oracle.adf.view.faces.component.UIXComponentBase _getRendererImpl WARNING: Could not find renderer for CorePanelGroup<a href="uixfacesbeanimpl,-id=_id38.html">UIXFacesBeanImpl, id=_id38</a>
+, rendererType = oracle.adf.Group
+Mar 21, 2006 12:10:15 AM
+org.apache.myfaces.renderkit.html.HtmlRenderKitImpl getRenderer WARNING:
+Unsupported component-family/renderer-type:
+oracle.adf.Command/oracle.adf.Link
+Mar 21, 2006 12:10:15 AM oracle.adf.view.faces.component.UIXComponentBase _getRendererImpl WARNING: Could not find renderer for CoreCommandLink<a href="commandlinkfacesbean,-id=_id41.html">CommandLinkFacesBean, id=_id41</a>
+, rendererType = oracle.adf.Link
+Mar 21, 2006 12:10:15 AM
+org.apache.myfaces.renderkit.html.HtmlRenderKitImpl getRenderer WARNING:
+Unsupported component-family/renderer-type:
+oracle.adf.Output/oracle.adf.Formatted
+SEVERE: Error Rendering View<a href="/main.xhtml.html">/main.xhtml</a>
+ java.lang.NullPointerException at
+oracle.adfinternal.view.faces<WBR>.uinode.FacesRenderingContext<WBR>.setRenderingProperty(FacesRenderingContext.java:157)
+at
+oracle.adfinternal.view.faces<WBR>.ui.RenderedNodeRenderingContex<WBR>t.setProperty(RenderedNodeRenderingContext<WBR>.java:162)
+at
+oracle.adfinternal.view.faces<WBR>.ui.RootRenderingContext.init(RootRenderingContext.java:81)
+at oracle.adfinternal.view.faces<WBR>.uinode.FacesRenderingContext.
+(FacesRenderingContext.java:106) at
+oracle.adfinternal.view.faces<WBR>.uinode.FacesRenderingContext<WBR>.createRenderingContext(FacesRenderingContext.java:79)
+at
+oracle.adfinternal.view.faces<WBR>.uinode.UINodeRendererBase<WBR>.getRenderingContext(UINodeRendererBase.java:89)
+at
+oracle.adfinternal.view.faces<WBR>.uinode.FacesRenderingContext<WBR>.getRenderingContext(FacesRenderingContext.java:66)
+at
+oracle.adfinternal.view.faces<WBR>.uinode.FacesRenderingContext<WBR>.getRenderingContext(FacesRenderingContext.java:52)
+at
+oracle.adfinternal.view.faces<WBR>.renderkit.htmlBasic.UINodeRend<WBR>erer.getRenderingContext(UINodeRenderer.java:79)
+at
+oracle.adfinternal.view.faces<WBR>.renderkit.htmlBasic.UINodeRend<WBR>erer.encodeBegin(UINodeRenderer.java:38)
+at
+javax.faces.component.UICompone<WBR>ntBase.encodeBegin(UIComponentBase.java:512)
+at
+com.sun.facelets.FaceletViewHan<WBR>dler.encodeRecursive(FaceletViewHandler.java:555)
+at
+com.sun.facelets.FaceletViewHan<WBR>dler.encodeRecursive(FaceletViewHandler.java:562)
+at
+com.sun.facelets.FaceletViewHan<WBR>dler.encodeRecursive(FaceletViewHandler.java:562)
+at
+com.sun.facelets.FaceletViewHan<WBR>dler.renderView(FaceletViewHandler.java:457)
+at
+org.apache.myfaces.lifecycle<WBR>.LifecycleImpl.render(LifecycleImpl.java:367)
+at
+javax.faces.webapp.FacesServlet<WBR>.service(FacesServlet.java:138) at
+org.apache.catalina.core<WBR>.ApplicationFilterChain<WBR>.internalDoFilter(ApplicationFilterChain.java:252)
+at
+org.apache.catalina.core<WBR>.ApplicationFilterChain<WBR>.doFilter(ApplicationFilterChain.java:173)
+at
+org.apache.myfaces.webapp<WBR>.filter.ExtensionsFilter<WBR>.doFilter(ExtensionsFilter.java:130)
+at
+org.apache.catalina.core<WBR>.ApplicationFilterChain<WBR>.internalDoFilter(ApplicationFilterChain.java:202)
+at
+org.apache.catalina.core<WBR>.ApplicationFilterChain<WBR>.doFilter(ApplicationFilterChain.java:173)
+at
+org.apache.catalina.core<WBR>.StandardWrapperValve.invoke(StandardWrapperValve.java:213)
+at
+org.apache.catalina.core<WBR>.StandardContextValve.invoke(StandardContextValve.java:178)
+at
+org.apache.catalina.authenticat<WBR>or.AuthenticatorBase.invoke(AuthenticatorBase.java:432)
+at
+org.apache.catalina.core<WBR>.StandardHostValve.invoke(StandardHostValve.java:126)
+at
+org.apache.catalina.valves<WBR>.ErrorReportValve.invoke(ErrorReportValve.java:105)
+at
+org.apache.catalina.core<WBR>.StandardEngineValve.invoke(StandardEngineValve.java:107)
+at
+org.apache.catalina.connector<WBR>.CoyoteAdapter.service(CoyoteAdapter.java:148)
+at
+org.apache.coyote.http11<WBR>.Http11Processor.process(Http11Processor.java:869)
+at
+org.apache.coyote.http11<WBR>.Http11BaseProtocol$Http11Conne<WBR>ctionHandler.processConnection(Http11BaseProtocol.java:667)
+at
+org.apache.tomcat.util.net<WBR>.PoolTcpEndpoint.processSocket(PoolTcpEndpoint.java:527)
+at
+org.apache.tomcat.util.net<WBR>.LeaderFollowerWorkerThread<WBR>.runIt(LeaderFollowerWorkerThread.java:80)
+at
+org.apache.tomcat.util.threads<WBR>.ThreadPool$ControlRunnable.run(ThreadPool.java:684)
+at
+java.lang.Thread.run(Thread.java:595)</p>
+<p>]
+]></ac:plain-text-body></ac:macro></p>
+<p>Make sure your FaceletViewHandler is commented out and the default
+render kit of ADF faces defined in faces-config.xml oracle.adf.core (Note
+that the ADF faces implementation ensures non-ADF components still get
+rendered in the normal way so it can safely co-exist with other JSF
+components) ..and your web.xml contains these lines for ADF faces
+oracle.adf.view.faces.ALTERNATE_VIEW_HANDLER
+com.sun.facelets.FaceletViewHandler AdfFacesFilter
+oracle.adf.view.faces.webapp.AdfFacesFilter AdfFacesFilter FacesServlet</p>
+
+<p>Thanks to Murray Brandon for the initial contribution.</p>
+
+<h3>Select Items stop working in MyFaces 1.1.5</h3>
+
+<p>MyFaces 1.1.4 and earlier did not correctly implement the select
+components. Although the behavior was nice, the components were not
+supposed to convert the values from the UISelectItems. For example, in
+1.1.4 this would have worked:</p>
+
+<p><ac:macro
+ac:name="code"><ac:default-parameter>xml</ac:default-parameter><ac:plain-text-body><![CDATA[
+<f:selectOneMenu value="#{bean.intValue}"><f:selectItem itemValue="1"
+/></selectOneMenu>
+]
+]></ac:plain-text-body></ac:macro></p>
+<p>The reason this used to work is that the code in the past used the
+converter on the select one menu component to convert the value from the
+select item. According to the JSF specification, this is not supposed to be
+done. Therefore, it is important that the converted value from the
+selectOneMenu is identical (passes the equals function test) to the
+itemValue from one of the select items. Therefore, for the example above,
+itemValue must be an integer value, not a string with a number in it. </p>
+
+<p>If you want the old behavior, I suggest creating a custom selectItem
+component that converts the value using the converter from the input
+control. Here is the code:</p>
+
+<p><ac:macro ac:name="code"><ac:parameter
+ac:name="borderStyle">solid</ac:parameter><ac:parameter
+ac:name="title">UISelectItem.java</ac:parameter><ac:plain-text-body><![CDATA[
+public class UISelectItem
+ extends javax.faces.component.UISelectItem
+{
+ public final static String COMPONENT_TYPE =
+"org.apache.myfaces.wiki.SelectItem";
+ private Boolean convertValue;</p>
+<p>/*<em>
+ * @return the convertValue
+ </em>/
+ public boolean getConvertValue()
+ {
+ if (this.convertValue != null) return this.convertValue;
+ ValueBinding vb = getValueBinding("convertValue");
+ return (vb == null) ? true : (Boolean) vb.getValue(getFacesContext());
+ }</p>
+<p>/*<em>
+ * @param convertValue the convertValue to set
+ </em>/
+ public void setConvertValue(boolean convertValue)
+ {
+ this.convertValue = convertValue;
+ }</p>
+<p>/*<em>
+ * @see javax.faces.component.UISelectItem#getItemValue()
+ </em>/
+ @Override
+ public Object getItemValue()
+ {
+ Object value = super.getItemValue();</p>
+<div class="codehilite"><pre><span class="k">if</span> <span class="p">(</span><span class="n">getConvertValue</span><span class="p">())</span>
+<span class="p">{</span>
+ <span class="n">UIInput</span> <span class="n">parent</span> <span class="p">=</span> <span class="n">null</span><span class="p">;</span>
+ <span class="k">for</span> <span class="p">(</span><span class="n">UIComponent</span> <span class="n">comp</span> <span class="p">=</span> <span class="n">getParent</span><span class="p">();</span> <span class="n">comp</span> !<span class="p">=</span> <span class="n">null</span><span class="p">;</span> <span class="n">comp</span> <span class="p">=</span>
+</pre></div>
+
+
+<p>comp.getParent())
+ {
+ if (comp instanceof UIInput)
+ {
+ parent = (UIInput)comp;
+ break;
+ }
+ }
+ if (parent != null)
+ value = getConvertedValue(getFacesContext(), parent, value);
+ }
+ return value;
+ }</p>
+<p>/*<em>
+ * @see
+javax.faces.component.UISelectItem#saveState(javax.faces.context.FacesContext)
+ </em>/
+ @Override
+ public Object saveState(FacesContext context)
+ {
+ return new Object<a href=".html"></a>
+ {
+ super.saveState(context), convertValue, };
+ }</p>
+<p>/*<em>
+ * @see
+javax.faces.component.UISelectItem#restoreState(javax.faces.context.FacesContext,
+java.lang.Object)
+ </em>/
+ @Override
+ public void restoreState(FacesContext context, Object state)
+ {
+ Object<a href=".html"></a>
+ arr = (Object[]) state;
+ int index = -1;
+ super.restoreState(context, arr<a href="++index.html">++index</a>
+);
+ this.convertValue = (Boolean) arr<a href="++index.html">++index</a>
+;
+ }</p>
+<p>private Object getConvertedValue(FacesContext context, UIInput input,
+Object value)
+ throws ConverterException
+ {
+ Renderer renderer = getRenderer(context);
+ if (renderer != null)
+ return renderer.getConvertedValue(context, this, value);
+ else if (value instanceof String)
+ {
+ Converter converter = RendererUtils.findUIOutputConverter(
+ context, input);
+ if (converter != null)
+ return converter.getAsObject(context, this, (String)value);
+ }
+ return value;
+ }
+}
+]
+]></ac:plain-text-body></ac:macro></p>
+<p>Then just register this new component in the standard JSF way.</p>
+
+<p><ac:macro ac:name="unmigrated-inline-wiki-markup"><ac:plain-text-body><![CDATA<a href="cdata[{scrollbar}.html">{scrollbar}</a>
+]></ac:plain-text-body></ac:macro></p></div></div>
+ <div class="clear"></div>
+ </div>
+
+ <div id="copyright" class="container_16">
+ <p>Copyright © 2011 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.<br/>Apache and the Apache feather logo are trademarks of The Apache Software Foundation.</p>
+ </div>
+ </body>
+</html>