Moved html JavaDoc to package-info

impl/pom.xml

@@ -350,6 +350,7 @@
                         <id>attach-javadocs</id>
                         <configuration>
                             <excludePackageNames>com</excludePackageNames>
+                            <docfilessubdirs>true</docfilessubdirs>
                         </configuration>
                         <goals>
                             <goal>jar</goal>

impl/src/main/java/javax/faces/annotation/package-info.java

@@ -0,0 +1,5 @@
+/**
+ * <p class="changed_added_2_3">Annotations in this class allow injection of JSF
+ * objects into CDI beans.</p>
+ */
+package javax.faces.annotation;

impl/src/main/java/javax/faces/application/package-info.java

@@ -0,0 +1,11 @@
+/**
+ * <p>
+ * <span class="changed_modified_2_0 changed_modified_2_0_rev_a
+ * changed_modified_2_1 changed_modified_2_2 changed_modified_2_3">APIs</span>
+ * that are used to link an application's business logic objects to JavaServer
+ * Faces, as well as convenient pluggable mechanisms to manage the execution of
+ * an application that is based on JavaServer Faces. The main class in this
+ * package is {@link
+ * javax.faces.application.Application}.</p>
+ */
+package javax.faces.application;

impl/src/main/java/javax/faces/component/behavior/package-info.java

@@ -0,0 +1,7 @@
+/**
+ * <p>
+ * <span class="changed_added_2_0"><span
+ * class="changed_modified_2_0_rev_a changed_modified_2_2">APIs</span> for
+ * attaching additional behavior to user interface components.</span></p>
+ */
+package javax.faces.component.behavior;

impl/src/main/java/javax/faces/component/html/package-info.java

@@ -0,0 +1,6 @@
+/**
+ * <p>
+ * <span class="changed_modified_2_0_rev_a">Specialized</span> user interface
+ * component classes for HTML.</p>
+ */
+package javax.faces.component.html;

impl/src/main/java/javax/faces/component/package-info.java

@@ -0,0 +1,12 @@
+/**
+ * <p>
+ * <span class="changed_modified_2_0"><span class="changed_modified_2_0_rev_a
+ * changed_modified_2_1"><span class="changed_modified_2_2
+ * changed_modified_2_3">Fundamental</span></span></span> APIs for user
+ * interface components.</p>
+ * <p>
+ * For your convenience here is a UML class diagram of the classes in this
+ * package.</p>
+ * <img src="doc-files/UIComponentHierarchy.jpg" alt="UIComponent hierarchy">
+ */
+package javax.faces.component;

impl/src/main/java/javax/faces/component/search/package-info.java

@@ -0,0 +1,141 @@
+/**
+ * <p class="changed_added_2_3">APIs for searching for components in the
+ * component tree by using expressions.</p>
+ * <div class="changed_added_2_3">
+ * <p>
+ * This feature has two entry points: for the page author and for the Java
+ * programmer. Following is a brief overview of each.</p>
+ * <h2>For the Page Author</h2>
+ * <p>
+ * The following tags support the use of search expressions:
+ * <code>&lt;h:message /&gt;</code>, <code>&lt;h:messages
+ * /&gt;</code>, <code>&lt;h:outputLabel /&gt;</code>, and
+ * <code>&lt;f:ajax /&gt;</code>. Each of those tags have one or more attributes
+ * whose value must be a client identifier. This feature expands the capability
+ * of those attributes to be search expressions. A search expression is space
+ * separated list of tokens, where a token can either be a client identifier, a
+ * search keyword, or a combination of both. See the specification for
+ * <code>{@link javax.faces.component.search.SearchKeywordResolver}</code>
+ * for the list of keywords that must be supported. See the specification for
+ * <code>{@link javax.faces.component.search.SearchExpressionHandler}</code>
+ * to learn how the search is performed.</p>
+ * <p>
+ * Here is a brief example of the page author use case:</p>
+ * <div class="syntax"><div class="text" style="font-family: monospace;"><ol><li class="li1"><div class="de1">&lt;h:body&gt;</div></li>
+ * <li class="li2"><div class="de2">&nbsp; &lt;h:outputLabel
+ * id=&quot;label&quot; for=&quot;@next&quot; value=&quot;Test&quot;
+ * /&gt;</div></li>
+ * <li class="li1"><div class="de1">&nbsp; &lt;h:inputText
+ * id=&quot;input&quot;&gt;</div></li>
+ * <li class="li2"><div class="de2">&nbsp; &nbsp; &lt;f:ajax render=&quot;@this @next&quot; /&gt;</div></li>
+ * <li class="li1"><div class="de1">&nbsp; &lt;/h:inputText&gt;</div></li>
+ * <li class="li2"><div class="de2">&nbsp; &lt;h:inputText id=&quot;input2&quot;
+ * /&gt;</div></li>
+ * <li class="li1"><div class="de1">&lt;/h:body&gt; </div></li></ol></div>
+ * <h2>For the Java Programmer</h2>
+ * <p>
+ * Using search expressions from Java code offers more flexibility. One must
+ * obtain a handle to the
+ * <code>{@link javax.faces.component.search.SearchExpressionHandler}</code>
+ * and invoke methods on it as desired.</p>
+ * <p>
+ * The following example resolves to a clientId:</p>
+ * <div class="syntax">
+ * <div class="java" style="font-family: monospace;">
+ * <ol>
+ * <li class="li1"><div class="de1">SearchExpressionHandler handler =
+ * facesContext.<span class="me1">getApplication</span><span class="br0">&#40;</span><span class="br0">&#41;</span>.<span class="me1">getSearchExpressionHandler</span><span class="br0">&#40;</span><span class="br0">&#41;</span>;</div></li>
+ * <li class="li2"><div class="de2">SearchExpressionContext context =
+ * SearchExpressionContext.<span class="me1">createSearchExpressionContext</span><span class="br0">&#40;</span>facesContext,
+ * facesContext.<span class="me1">getViewRoot</span><span class="br0">&#40;</span><span class="br0">&#41;</span><span class="br0">&#41;</span>;</div></li>
+ * <li class="li1"><div class="de1">String clientId =
+ * handler.<span class="me1">resolveClientId</span><span class="br0">&#40;</span>context,
+ * ":form:container:@next"<span class="br0">&#41;</span>;</div></li>
+ * </ol>
+ * </div>
+ * </div>
+ * <p>
+ * The following example resolves to a component:</p>
+ * <div class="syntax">
+ * <div class="java" style="font-family: monospace;">
+ * <ol>
+ * <li class="li1"><div class="de1">SearchExpressionHandler handler =
+ * facesContext.<span class="me1">getApplication</span><span class="br0">&#40;</span><span class="br0">&#41;</span>.<span class="me1">getSearchExpressionHandler</span><span class="br0">&#40;</span><span class="br0">&#41;</span>;</div></li>
+ * <li class="li2"><div class="de2">SearchExpressionContext context =
+ * SearchExpressionContext.<span class="me1">createSearchExpressionContext</span><span class="br0">&#40;</span>facesContext,
+ * facesContext.<span class="me1">getViewRoot</span><span class="br0">&#40;</span><span class="br0">&#41;</span><span class="br0">&#41;</span>;</div></li>
+ * <li class="li1"><div class="de1">handler.<span class="me1">resolveComponent</span><span class="br0">&#40;</span>context,
+ * ":form:container:@next",</div></li>
+ * <li class="li2"><div class="de2">&nbsp; &nbsp; &nbsp; &nbsp;&nbsp; &nbsp;
+ * &nbsp; &nbsp; <span class="kw2">new</span>
+ * ContextCallback<span class="br0">&#40;</span><span class="br0">&#41;</span>
+ * <span class="br0">&#123;</span></div></li>
+ * <li class="li1"><div class="de1">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
+ * &nbsp; &nbsp;&nbsp; &nbsp; <span class="kw2">public</span> void
+ * invokeContextCallback<span class="br0">&#40;</span>FacesContext context,
+ * </div></li>
+ * <li class="li2"><div class="de2">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
+ * &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
+ * &nbsp; &nbsp; &nbsp;&nbsp; &nbsp; &nbsp;UIComponent
+ * target<span class="br0">&#41;</span>
+ * <span class="br0">&#123;</span></div></li>
+ * <li class="li1"><div class="de1">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
+ * &nbsp; &nbsp;&nbsp; &nbsp; &nbsp; &nbsp; <span class="co1">// target == the
+ * resolved component</span></div></li>
+ * <li class="li1"><div class="de2">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
+ * &nbsp; &nbsp;&nbsp; &nbsp; <span class="br0">&#125;</span></div></li>
+ * <li class="li2"><div class="de1">&nbsp; &nbsp; &nbsp; &nbsp;&nbsp; &nbsp;
+ * &nbsp; &nbsp; <span class="br0">&#125;</span><span class="br0">&#41;</span>;
+ * </div></li></ol></div></div>
+ * <p>
+ * The following example uses multiple expressions and therefor resolves to
+ * multiple components:</p>
+ * <div class="syntax">
+ * <div class="java" style="font-family: monospace;">
+ * <ol>
+ * <li class="li1"><div class="de1">SearchExpressionHandler handler =
+ * facesContext.<span class="me1">getApplication</span><span class="br0">&#40;</span><span class="br0">&#41;</span>.<span class="me1">getSearchExpressionHandler</span><span class="br0">&#40;</span><span class="br0">&#41;</span>;</div></li>
+ * <li class="li2"><div class="de2">SearchExpressionContext context =
+ * SearchExpressionContext.<span class="me1">createSearchExpressionContext</span><span class="br0">&#40;</span>facesContext,
+ * facesContext.<span class="me1">getViewRoot</span><span class="br0">&#40;</span><span class="br0">&#41;</span><span class="br0">&#41;</span>;</div></li>
+ * <li class="li1"><div class="de1">handler.<span class="me1">resolveComponents</span><span class="br0">&#40;</span>context,
+ * ":form:container:@next :input1 input2:@parent",</div></li>
+ * <li class="li2"><div class="de2">&nbsp; &nbsp; &nbsp; &nbsp;&nbsp; &nbsp;
+ * &nbsp; &nbsp; <span class="kw2">new</span>
+ * ContextCallback<span class="br0">&#40;</span><span class="br0">&#41;</span>
+ * <span class="br0">&#123;</span></div></li>
+ * <li class="li1"><div class="de1">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
+ * &nbsp; &nbsp;&nbsp; &nbsp; <span class="kw2">public</span> void
+ * invokeContextCallback<span class="br0">&#40;</span>FacesContext context,
+ * </div></li>
+ * <li class="li2"><div class="de2">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
+ * &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
+ * &nbsp; &nbsp; &nbsp;&nbsp; &nbsp; &nbsp;UIComponent
+ * target<span class="br0">&#41;</span>
+ * <span class="br0">&#123;</span></div></li>
+ * <li class="li1"><div class="de1">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
+ * &nbsp; &nbsp;&nbsp; &nbsp; &nbsp; &nbsp; <span class="co1">// target == the
+ * resolved component</span></div></li>
+ * <li class="li1"><div class="de2">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
+ * &nbsp; &nbsp;&nbsp; &nbsp; <span class="br0">&#125;</span></div></li>
+ * <li class="li2"><div class="de1">&nbsp; &nbsp; &nbsp; &nbsp;&nbsp; &nbsp;
+ * &nbsp; &nbsp; <span class="br0">&#125;</span><span class="br0">&#41;</span>;
+ * </div></li></ol></div></div>
+ * </div>
+ * <h2>Extending the Capabilities of the Component Search Facility</h2>
+ * <p>
+ * <strong>Creation of the
+ * <code>{@link javax.faces.component.search.SearchExpressionContext}</code></strong></p>
+ * <p>
+ * As with other factories in JSF, the <code>FactoryFinder</code> is used by the
+ * system to create instances of the <code>SearchExpressionContext</code> which
+ * holds state during the operation of this API.</p>
+ * <p>
+ * <strong>Adding new <code>{@link javax.faces.component.search.SearchKewordResolver}</code>s</strong></p>
+ * <p>
+ * See
+ * <code>{@link javax.faces.component.search.SearchKeywordResolver}</code>
+ * for the specification of how the set of keywords can be expanded.</p>
+ * </div>
+ */
+package javax.faces.component.search;

impl/src/main/java/javax/faces/component/visit/package-info.java

@@ -0,0 +1,80 @@
+/**
+ * <p class="changed_added_2_0"><span class="changed_modified_2_1 changed_modified_2_2">APIs</span>
+ * for traversing a user interface component view.</p>
+ *
+<div class="changed_added_2_0">
+ *
+<p>
+ * The following example visits all nodes in the view.</p>
+ *
+<div class="syntax"><div class="java" style="font-family: monospace;"><ol><li class="li1"><div class="de1">UIViewRoot
+ * root =
+ * facesContext.<span class="me1">getViewRoot</span><span class="br0">&#40;</span><span class="br0">&#41;</span>;</div></li>
+ * <li class="li2"><div class="de2">root.<span class="me1">visitTree</span><span class="br0">&#40;</span>VisitContext.<span class="me1">createVisitContext</span><span class="br0">&#40;</span>context<span class="br0">&#41;</span>,
+ * </div></li>
+ * <li class="li1"><div class="de1">&nbsp; &nbsp; &nbsp; &nbsp;&nbsp; &nbsp;
+ * &nbsp; &nbsp; <span class="kw2">new</span>
+ * VisitCallback<span class="br0">&#40;</span><span class="br0">&#41;</span>
+ * <span class="br0">&#123;</span></div></li>
+ * <li class="li2"><div class="de2">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
+ * &nbsp; &nbsp;&nbsp; &nbsp; <span class="kw2">public</span> VisitResult
+ * visit<span class="br0">&#40;</span>VisitContext context, </div></li>
+ * <li class="li1"><div class="de1">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
+ * &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
+ * &nbsp; &nbsp; &nbsp;&nbsp; &nbsp; &nbsp;UIComponent
+ * target<span class="br0">&#41;</span>
+ * <span class="br0">&#123;</span></div></li>
+ * <li class="li2"><div class="de2">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
+ * &nbsp; &nbsp;&nbsp; &nbsp; &nbsp; &nbsp; <span class="co1">// take some
+ * action on target</span></div></li>
+ * <li class="li1"><div class="de1">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
+ * &nbsp; &nbsp;&nbsp; &nbsp; &nbsp; &nbsp; <span class="kw2">return</span>
+ * VisitResult.<span class="me1">ACCEPT</span>;</div></li>
+ * <li class="li2"><div class="de2">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
+ * &nbsp; &nbsp;&nbsp; &nbsp; <span class="br0">&#125;</span></div></li>
+ * <li class="li1"><div class="de1">&nbsp; &nbsp; &nbsp; &nbsp;&nbsp; &nbsp;
+ * &nbsp; &nbsp; <span class="br0">&#125;</span><span class="br0">&#41;</span>;
+ * </div></li></ol></div></div>
+ *
+<p>
+ * The following example visits two subtrees within the component view.</p>
+ *
+<div class="syntax"><div class="java" style="font-family: monospace;"><ol><li class="li1"><div class="de1">Set&lt;String&gt;
+ * toVisit =
+ * getSet<span class="br0">&#40;</span><span class="st0">&quot;form1:optionsPanel&quot;</span>,
+ * <span class="st0">&quot;form2:detailPanel&quot;</span><span class="br0">&#41;</span>;</div></li>
+ * <li class="li2"><div class="de2">UIViewRoot root =
+ * facesContext.<span class="me1">getViewRoot</span><span class="br0">&#40;</span><span class="br0">&#41;</span>;</div></li>
+ * <li class="li1"><div class="de1">root.<span class="me1">visitTree</span><span class="br0">&#40;</span>VisitContext.<span class="me1">createVisitContext</span><span class="br0">&#40;</span>context,
+ * toVisit, <span class="kw2">null</span><span class="br0">&#41;</span>,
+ * </div></li>
+ * <li class="li2"><div class="de2">&nbsp; &nbsp; &nbsp; &nbsp;&nbsp; &nbsp;
+ * &nbsp; &nbsp; <span class="kw2">new</span>
+ * VisitCallback<span class="br0">&#40;</span><span class="br0">&#41;</span>
+ * <span class="br0">&#123;</span></div></li>
+ * <li class="li1"><div class="de1">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
+ * &nbsp; &nbsp;&nbsp; &nbsp; <span class="kw2">public</span> VisitResult
+ * visit<span class="br0">&#40;</span>VisitContext context, </div></li>
+ * <li class="li2"><div class="de2">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
+ * &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
+ * &nbsp; &nbsp; &nbsp;&nbsp; &nbsp; &nbsp;UIComponent
+ * target<span class="br0">&#41;</span>
+ * <span class="br0">&#123;</span></div></li>
+ * <li class="li1"><div class="de1">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
+ * &nbsp; &nbsp;&nbsp; &nbsp; &nbsp; &nbsp; <span class="co1">// take some
+ * action on target</span></div></li>
+ * <li class="li2"><div class="de2">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
+ * &nbsp; &nbsp;&nbsp; &nbsp; &nbsp; &nbsp; <span class="kw2">return</span>
+ * VisitResult.<span class="me1">ACCEPT</span>;</div></li>
+ * <li class="li1"><div class="de1">&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;
+ * &nbsp; &nbsp;&nbsp; &nbsp; <span class="br0">&#125;</span></div></li>
+ * <li class="li2"><div class="de2">&nbsp; &nbsp; &nbsp; &nbsp;&nbsp; &nbsp;
+ * &nbsp; &nbsp; <span class="br0">&#125;</span><span class="br0">&#41;</span>;
+ * </div></li></ol></div></div>
+ *
+<p>
+ * Note that every child node of those two subtrees is visited.</p>
+ *
+</div>
+ */
+package javax.faces.component.visit;

impl/src/main/java/javax/faces/context/package-info.java

@@ -0,0 +1,9 @@
+/**
+ * <p>
+ * <span class="changed_modified_2_0 changed_modified_2_1 changed_modified_2_2 changed_modified_2_3">
+ * Classes</span> and interfaces defining per-request state information. The
+ * main class in this package is {@link javax.faces.context.FacesContext}, which
+ * is the access point for all per-request information, as well as the gateway
+ * to several other helper classes.</p>
+ */
+package javax.faces.context;

impl/src/main/java/javax/faces/convert/package-info.java

@@ -0,0 +1,8 @@
+/**
+ * <p>
+ * <span class="changed_modified_2_0
+ * changed_modified_2_0_rev_a changed_modified_2_2 changed_modified_2_3">Contains</span>
+ * classes and interfaces defining converters. The main class in this package is {@link
+ * javax.faces.convert.Converter}.</p>
+ */
+package javax.faces.convert;

impl/src/main/java/javax/faces/el/package-info.java

@@ -0,0 +1,9 @@
+/**
+ * <p>
+ * <b>DEPRECATED</b> Classes and interfaces for evaluating and processing
+ * reference expressions. The main class in this package is
+ * {@link javax.faces.el.ValueBinding}, which is the runtime representation of a
+ * reference expression.  <code>ValueBinding</code> provides methods to get and
+ * set the value of the expression.</p>
+ */
+package javax.faces.el;

impl/src/main/java/javax/faces/event/package-info.java

@@ -0,0 +1,13 @@
+/**
+ * <p>
+ * <span class="changed_modified_2_0 changed_modified_2_0_rev_a
+ * changed_modified_2_1 changed_modified_2_2 changed_modified_2_3">Interfaces</span>
+ * describing events and event listeners, and concrete event implementation
+ * classes. All events extend from {@link javax.faces.event.FacesEvent} and all
+ * listeners extend from {@link javax.faces.event.FacesListener}.</p>
+ * <p>
+ * For your convenience here is a UML class diagram of the classes in this
+ * package.</p>
+ * <a href="doc-files/EventHierarchy.jpg"><img width="640" height="473" src="doc-files/EventHierarchy.jpg" alt="Event hierarchy"></a>
+ */
+package javax.faces.event;

impl/src/main/java/javax/faces/flow/builder/package-info.java

@@ -0,0 +1,6 @@
+/**
+ * <p class="changed_added_2_2"><span>Classes</span> for declaring a Faces Flow.
+ * See <code>{@link javax.faces.flow.builder.FlowBuilder}</code> and its helpers
+ * for the normative specification of this feature.</p>
+ */
+package javax.faces.flow.builder;

impl/src/main/java/javax/faces/flow/package-info.java

@@ -0,0 +1,8 @@
+/**
+ * <p class="changed_added_2_2"><span class="changed_modified_2_3">The</span>
+ * runtime API for Faces Flows. See
+ * <code>{@link javax.faces.flow.FlowHandler}</code> and its helpers for
+ * the normative specification of this feature.</p>
+ * <img src="doc-files/FlowHierarchy.jpg" alt="Flow hierarchy">
+ */
+package javax.faces.flow;

impl/src/main/java/javax/faces/lifecycle/package-info.java

@@ -0,0 +1,10 @@
+/**
+ * <p>
+ * <span class="changed_modified_2_0 changed_modified_2_2">Classes</span> and
+ * interfaces defining lifecycle management for the JavaServer Faces
+ * implementation. The main class in this package is
+ * {@link javax.faces.lifecycle.Lifecycle}.  <code>Lifecycle</code> is the
+ * gateway to executing the request processing lifecycle.
+ * </p>
+ */
+package javax.faces.lifecycle;

impl/src/main/java/javax/faces/model/package-info.java

@@ -0,0 +1,7 @@
+/**
+ * <p>
+ * <span class="changed_modified_2_0
+ * changed_modified_2_0_rev_a changed_modified_2_2">Standard</span> model data
+ * beans for JavaServer Faces.</p>
+ */
+package javax.faces.model;

impl/src/main/java/javax/faces/package-info.java

@@ -0,0 +1,8 @@
+/**
+ * <span class="changed_modified_2_0 changed_modified_2_1 changed_modified_2_2 changed_modified_2_3">Top</span>
+ * level classes for the JavaServer(tm) Faces API. The most important class in
+ * the package is {@link javax.faces.FactoryFinder}, which is the mechanism by
+ * which users can override many of the key pieces of the implementation with
+ * their own.
+ */
+package javax.faces;

impl/src/main/java/javax/faces/push/package-info.java

@@ -0,0 +1,6 @@
+/**
+ * <p class="changed_added_2_3">This package hosts the CDI annotation for
+ * injecting a <code>PushContext</code>.
+ * </p>
+ */
+package javax.faces.push;

impl/src/main/java/javax/faces/render/package-info.java

@@ -0,0 +1,10 @@
+/**
+ * <p>
+ * <span class="changed_modified_2_0 changed_modified_2_2">Classes</span>
+ * and interfaces defining the rendering model. The main class in this package
+ * is {@link
+ * javax.faces.render.RenderKit}.  <code>RenderKit</code> vends a set of
+ * {@link javax.faces.render.Renderer} instances which provide rendering
+ * capability for a specific client device type.</p>
+ */
+package javax.faces.render;

impl/src/main/java/javax/faces/validator/package-info.java

@@ -0,0 +1,8 @@
+/**
+ * <p>
+ * <span class="changed_modified_2_0
+ * changed_modified_2_0_rev_a changed_modified_2_2 changed_modified_2_3">Interface</span>
+ * defining the validator model, and concrete validator implementation
+ * classes.</p>
+ */
+package javax.faces.validator;