You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@myfaces.apache.org by lu...@apache.org on 2017/06/06 05:27:24 UTC
svn commit: r1797728 - in /myfaces/core/branches/2.3.x: api/
api/src/main/java/javax/faces/application/
api/src/main/java/javax/faces/component/
api/src/main/java/javax/faces/component/behavior/
api/src/main/java/javax/faces/context/ api/src/main/java/...
Author: lu4242
Date: Tue Jun 6 05:27:23 2017
New Revision: 1797728
URL: http://svn.apache.org/viewvc?rev=1797728&view=rev
Log:
fix javadoc generation to new behavior of maven-javadoc-plugin
Modified:
myfaces/core/branches/2.3.x/api/pom.xml
myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/application/Application.java
myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/application/FacesMessage.java
myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/application/ResourceHandler.java
myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/application/ViewHandler.java
myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/component/NamingContainer.java
myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/component/TransientStateHelper.java
myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/component/UIComponent.java
myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/component/_ComponentAttributesMap.java
myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/component/behavior/AjaxBehavior.java
myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/context/FacesContext.java
myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/event/MethodExpressionActionListener.java
myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/event/MethodExpressionValueChangeListener.java
myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/render/FacesBehaviorRenderer.java
myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/render/Renderer.java
myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/validator/FacesValidator.java
myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/view/ViewDeclarationLanguage.java
myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/view/facelets/ConverterHandler.java
myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/view/facelets/Tag.java
myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/view/facelets/ValidatorHandler.java
myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/webapp/UIComponentClassicTagBase.java
myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/webapp/UIComponentTagBase.java
myfaces/core/branches/2.3.x/parent/pom.xml
Modified: myfaces/core/branches/2.3.x/api/pom.xml
URL: http://svn.apache.org/viewvc/myfaces/core/branches/2.3.x/api/pom.xml?rev=1797728&r1=1797727&r2=1797728&view=diff
==============================================================================
--- myfaces/core/branches/2.3.x/api/pom.xml (original)
+++ myfaces/core/branches/2.3.x/api/pom.xml Tue Jun 6 05:27:23 2017
@@ -477,6 +477,18 @@
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
+ <configuration>
+ <tags>
+ <tag>
+ <name>JSFJspTag</name>
+ <placement>X</placement>
+ </tag>
+ <tag>
+ <name>JSFJspAttribute</name>
+ <placement>X</placement>
+ </tag>
+ </tags>
+ </configuration>
<executions>
<execution>
<id>attach-javadoc</id>
@@ -720,6 +732,18 @@
<plugin>
<artifactId>maven-javadoc-plugin</artifactId>
+ <configuration>
+ <tags>
+ <tag>
+ <name>JSFJspTag</name>
+ <placement>X</placement>
+ </tag>
+ <tag>
+ <name>JSFJspAttribute</name>
+ <placement>X</placement>
+ </tag>
+ </tags>
+ </configuration>
</plugin>
<plugin>
Modified: myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/application/Application.java
URL: http://svn.apache.org/viewvc/myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/application/Application.java?rev=1797728&r1=1797727&r2=1797728&view=diff
==============================================================================
--- myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/application/Application.java (original)
+++ myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/application/Application.java Tue Jun 6 05:27:23 2017
@@ -127,6 +127,9 @@ public abstract class Application
* @since 2.0
*
* FIXME: Notify EG, this should not be abstract and throw UnsupportedOperationException
+ *
+ * @param behaviorId
+ * @param behaviorClass
*/
public void addBehavior(String behaviorId, String behaviorClass)
{
@@ -192,9 +195,8 @@ public abstract class Application
/**
*
- * @param validatorId
- *
* @since 2.0
+ * @param validatorId
*/
public void addDefaultValidatorId(String validatorId)
{
@@ -368,7 +370,7 @@ public abstract class Application
* <p>
* Call the <code>getValue()</code> method on the specified <code>ValueExpression</code>. If it returns a
* <code>{@link UIComponent}</code> instance, return it as the value of this method. If it does not, instantiate a
- * new <code>{@linkUIComponent}</code> instance of the specified component type, pass the new component to the
+ * new <code>{@link UIComponent}</code> instance of the specified component type, pass the new component to the
* <code>setValue()</code> method of the specified <code>ValueExpression</code>, and return it.
* </p>
*
@@ -433,7 +435,7 @@ public abstract class Application
* <p>
* To locate an appropriate <code>{@link Converter}</code> class, the following algorithm is performed, stopping as
* soon as an appropriate <code>{@link Converter}</code> class is found: Locate a <code>{@link Converter}</code>
- * registered for the target class itself. <Locate a <code>{@link Converter}</code> registered for interfaces that
+ * registered for the target class itself. Locate a <code>{@link Converter}</code> registered for interfaces that
* are implemented by the target class (directly or indirectly). Locate a <code>{@link Converter}</code> registered
* for the superclass (if any) of the target class, recursively working up the inheritance hierarchy.
* </p>
@@ -488,7 +490,7 @@ public abstract class Application
* Validator instance
*
* @throws FacesException
- * if a <code>{@link Validator}/<code> of the specified id cannot be created
+ * if a <code>{@link Validator}</code> of the specified id cannot be created
* @throws NullPointerException
* if validatorId is <code>null</code>
*/
@@ -539,7 +541,7 @@ public abstract class Application
/**
* <p>
- * Return the default <code>ActionListener</code> to be registered for all <code>ActionSource<3code> components
+ * Return the default <code>ActionListener</code> to be registered for all <code>ActionSource</code> components
* in this appication. If not explicitly set, a default implementation must be provided that performs the
* following functions:
* </p>
@@ -550,23 +552,17 @@ public abstract class Application
* <li>The <code>processAction()</code> method must next determine the logical
* outcome of this event, as follows:</li>
*
- * <ul>
* <li>If the originating component has a non-<code>null action</code> property, retrieve the <code>
- * MethodBinding<code> from the property, and call <code>invoke()</code>
+ * MethodBinding</code> from the property, and call <code>invoke()</code>
* on it. Convert the returned value (if any) to a String, and use it as the logical outcome.</li>
* <li>Otherwise, the logical outcome is null.</li>
- * </ul>
- * </ul>
- * <ul>
- * <li>The <code>processAction()</code> method must finally retrieve the <code>NavigationHandler<3code> instance
+ * <li>The <code>processAction()</code> method must finally retrieve the <code>NavigationHandler</code> instance
* for this application and call <code>NavigationHandler.handleNavigation(javax.faces.context.FacesContext,
* java.lang.String, java.lang.String)</code> passing:</li>
- * <ul>
* <li>the {@link FacesContext} for the current request</li>
* <li>If there is a <code>MethodBinding</code> instance for the <code>action</code> property of this component, the
* result of calling {@link MethodBinding#getExpressionString()} on it, null otherwise</li>
* <li>the logical outcome as determined above</li>
- * <ul>
* </ul>
* <p>
* Note that the specification for the default <code>ActionListener</code> contiues to call for the use of a
@@ -681,12 +677,12 @@ public abstract class Application
}
/**
- * <ul>
* Return the singleton <code>ELResolver</code> instance to be used for all EL resolution. This is actually an
* instance of <code>CompositeELResolver</code> that must contain the following ELResolver instances in the
* following order:
- * <li><code>ELResolver</code> instances declared using the <el-resolver> element in the application configuration
- * resources.</li>
+ * <ul>
+ * <li><code>ELResolver</code> instances declared using the <el-resolver> element in the application
+ * configuration resources.</li>
*
* <li>An <code> implementation</code> that wraps the head of the legacy VariableResolver chain, as per section
* <code> VariableResolver ChainWrapper</code> in Chapter 5 in the spec document.</li>
@@ -699,7 +695,7 @@ public abstract class Application
*
* <li>The default implementation throws <code>UnsupportedOperationException</code> and is provided for the sole
* purpose of not breaking existing applications that extend <code>{@link Application}</code>.</li>
- * <ul>
+ * </ul>
*
* @since 1.2
*/
@@ -717,6 +713,7 @@ public abstract class Application
* <p>
* Return the <code>ExpressionFactory</code> instance for this application. This instance is used by the convenience
* method <code>{@link #evaluateExpressionGet(javax.faces.context.FacesContext, java.lang.String, java.lang.Class)}.
+ * </code>
* </p>
*
* <p>
@@ -730,6 +727,7 @@ public abstract class Application
* </p>
*
* @since 1.2
+ * @return
*/
public ExpressionFactory getExpressionFactory()
{
@@ -777,7 +775,7 @@ public abstract class Application
* without exception, save the value and return it.</li>
* <li>If not found, or any of the previous attempts to discover the enum constant value have failed, log a
* descriptive error message, assign the value as <code>ProjectStage.Production</code> and return it.</li>
- * <ul>
+ * </ul>
*
* @since 2.0
*/
@@ -838,7 +836,8 @@ public abstract class Application
*
* <ul>
* <li>The <code>ResourceHandler</code> implementation is declared in the application configuration resources by
- * giving the fully qualified class name as the value of the <code><resource-handler></code> element within the
+ * giving the fully qualified class name as the value of the <code><resource-handler></code> element
+ * within the
* <code>application</code> element.</li>
* <li>RELEASE_PENDING(edburns) It can also be declared via an annotation as
* specified in [287-ConfigAnnotations].</li>
@@ -938,7 +937,7 @@ public abstract class Application
* <code>systemEventClass</code> argument. If the list is not empty, perform algorithm
* <code>traverseListenerList</code> on the list.</li>
*
- * <li>If any <code>Application</code> level listeners have been installed by previous calls to </code>{@link
+ * <li>If any <code>Application</code> level listeners have been installed by previous calls to <code>{@link
* #subscribeToEvent(java.lang.Class, java.lang.Class, SystemEventListener)}</code>, perform algorithm
* <code>traverseListenerList</code> on the list.</li>
*
@@ -949,17 +948,17 @@ public abstract class Application
*
* <p>
* If the act of invoking the <code>processListener</code> method causes an
- * </code>{@link javax.faces.event.AbortProcessingException}</code> to be thrown,
+ * <code>{@link javax.faces.event.AbortProcessingException}</code> to be thrown,
* processing of the listeners must be aborted.
* </p>
*
* <p>
* Algorithm <code>traverseListenerList</code>: For each listener in the list,
- * <p>
+ * </p>
*
* <ul>
* <li>Call
- * <code>{@link SystemEventListener#isListenerForSource(java.lang.Object)}<code>, passing the <code>source</code>
+ * <code>{@link SystemEventListener#isListenerForSource(java.lang.Object)}</code>, passing the <code>source</code>
* argument. If this returns <code>false</code>, take no action on the listener.</li>
*
* <li>Otherwise, if the event to be passed to the listener instances has not yet been constructed, construct the
@@ -967,11 +966,12 @@ public abstract class Application
* <code>Object</code>. This same event instance must be passed to all listener instances.</li>
*
* <li>Call
- * <code>{@link SystemEvent#isAppropriateListener(javax.faces.event.FacesListener)}<code>, passing the listener
+ * <code>{@link SystemEvent#isAppropriateListener(javax.faces.event.FacesListener)}</code>, passing the listener
* instance as the argument. If this returns <code>false</code>, take no action on the listener.</li>
*
* <li>Call <code>{@link SystemEvent#processListener(javax.faces.event.FacesListener)}</code>, passing the listener
* instance.</li>
+ * </ul>
*
* @param systemEventClass
* - The Class of event that is being published. Must be non-null.
@@ -1072,8 +1072,8 @@ public abstract class Application
public abstract void setNavigationHandler(NavigationHandler handler);
/**
- * The recommended way to affect the execution of the EL is to provide an <el-resolver> element at the right place
- * in the application configuration resources which will be considered in the normal course of expression
+ * The recommended way to affect the execution of the EL is to provide an <el-resolver> element at the right
+ * place in the application configuration resources which will be considered in the normal course of expression
* evaluation. This method now will cause the argument resolver to be wrapped inside an implementation of ELResolver
* and exposed to the EL resolution system as if the user had called addELResolver(javax.el.ELResolver).
*
@@ -1124,8 +1124,8 @@ public abstract class Application
public abstract void setSupportedLocales(Collection<Locale> locales);
/**
- * The recommended way to affect the execution of the EL is to provide an <el-resolver> element at the right place
- * in the application configuration resources which will be considered in the normal course of expression
+ * The recommended way to affect the execution of the EL is to provide an <el-resolver> element at the right
+ * place in the application configuration resources which will be considered in the normal course of expression
* evaluation. This method now will cause the argument resolver to be wrapped inside an implementation of ELResolver
* and exposed to the EL resolution system as if the user had called addELResolver(javax.el.ELResolver).
*
@@ -1240,7 +1240,7 @@ public abstract class Application
/**
* @since 2.2
- * @param newHandler
+ * @param flowHandler
*/
public void setFlowHandler(FlowHandler flowHandler)
{
Modified: myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/application/FacesMessage.java
URL: http://svn.apache.org/viewvc/myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/application/FacesMessage.java?rev=1797728&r1=1797727&r2=1797728&view=diff
==============================================================================
--- myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/application/FacesMessage.java (original)
+++ myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/application/FacesMessage.java Tue Jun 6 05:27:23 2017
@@ -29,25 +29,30 @@ import java.util.List;
import java.util.Map;
/**
- *see Javadoc of <a href="http://java.sun.com/javaee/javaserverfaces/1.2/docs/api/index.html">JSF Specification</a>
*<p>
* <code>FacesMessage</code> represents a single validation (or other) message, which is typically associated with a
* particular component in the view. A {@link FacesMessage} instance may be created based on a specific messageId. The
* specification defines the set of messageIds for which there must be {@link FacesMessage} instances.
* </p>
*
- *<ui>The implementation must take the following steps when creating FacesMessage instances given a messageId: <li>Call
+ * The implementation must take the following steps when creating FacesMessage instances given a messageId:
+ * <ul>
+ * <li>Call
* {@link Application#getMessageBundle()}. If <code>non-null</code>, locate the named <code>ResourceBundle</code>, using
- * the <code>Locale</code> from the current {@linkUIViewRoot} and see if it has a value for the argument
+ * the <code>Locale</code> from the current {@link javax.faces.component.UIViewRoot} and see if it has a value for
+ * the argument
* <code>messageId</code>. If it does, treat the value as the <code>summary</code> of the {@link FacesMessage}. If it
* does not, or if {@link Application#getMessageBundle()} returned null, look in the ResourceBundle named by the value
* of the constant {@link #FACES_MESSAGES} and see if it has a value for the argument messageId. If it does, treat the
* value as the summary of the <code>FacesMessage</code>. If it does not, there is no initialization information for the
- * <code>FacesMessage</code> instance.</li> <li>In all cases, if a <code>ResourceBundle</code> hit is found for the
+ * <code>FacesMessage</code> instance.</li>
+ * <li>In all cases, if a <code>ResourceBundle</code> hit is found for the
* <code>{messageId}</code>, look for further hits under the key <code>{messageId}_detail</code>. Use this value, if
- * present, as the <code>detail</code> for the returned <code>FacesMessage</code>.</li> <li>Make sure to perform any
+ * present, as the <code>detail</code> for the returned <code>FacesMessage</code>.</li>
+ * <li>Make sure to perform any
* parameter substitution required for the <code>summary</code> and <code>detail</code> of the <code>FacesMessage</code>
- * .</li> </ui>
+ * .</li>
+ * </ul>
*
*/
public class FacesMessage implements Serializable
Modified: myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/application/ResourceHandler.java
URL: http://svn.apache.org/viewvc/myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/application/ResourceHandler.java?rev=1797728&r1=1797727&r2=1797728&view=diff
==============================================================================
--- myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/application/ResourceHandler.java (original)
+++ myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/application/ResourceHandler.java Tue Jun 6 05:27:23 2017
@@ -161,7 +161,7 @@ public abstract class ResourceHandler
/**
* @since 2.3
- * @param context
+ * @param facesContext
* @param resourceName
* @param libraryName
*/
Modified: myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/application/ViewHandler.java
URL: http://svn.apache.org/viewvc/myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/application/ViewHandler.java?rev=1797728&r1=1797727&r2=1797728&view=diff
==============================================================================
--- myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/application/ViewHandler.java (original)
+++ myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/application/ViewHandler.java Tue Jun 6 05:27:23 2017
@@ -420,7 +420,7 @@ public abstract class ViewHandler
*
* @since 2.3
* @param context
- * @param channel
+ * @param channelAndToken
* @return
*/
public String getWebsocketURL(FacesContext context, String channelAndToken)
@@ -434,7 +434,6 @@ public abstract class ViewHandler
* @since 2.3
* @param facesContext
* @param path
- * @param maxDepth
* @param options
* @return
*/
Modified: myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/component/NamingContainer.java
URL: http://svn.apache.org/viewvc/myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/component/NamingContainer.java?rev=1797728&r1=1797727&r2=1797728&view=diff
==============================================================================
--- myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/component/NamingContainer.java (original)
+++ myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/component/NamingContainer.java Tue Jun 6 05:27:23 2017
@@ -57,7 +57,7 @@ package javax.faces.component;
public interface NamingContainer
{
/**
- * @deprecated Use {@link UINamingContainer#getSeparatorChar(javax.faces.context.FacesContext)
+ * @deprecated Use {@link UINamingContainer#getSeparatorChar(javax.faces.context.FacesContext)}
*/
public static final char SEPARATOR_CHAR = ':';
}
Modified: myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/component/TransientStateHelper.java
URL: http://svn.apache.org/viewvc/myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/component/TransientStateHelper.java?rev=1797728&r1=1797727&r2=1797728&view=diff
==============================================================================
--- myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/component/TransientStateHelper.java (original)
+++ myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/component/TransientStateHelper.java Tue Jun 6 05:27:23 2017
@@ -27,8 +27,8 @@ package javax.faces.component;
* UIComponent#getTransientStateHelper} method.</p>
*
* <p>The values retrieved or saved through
- * {@link #getTransient(java.io.Serializable)} } or
- * {@link #putTransient(java.io.Serializable, Object value)} }
+ * {@link #getTransient(java.lang.Object) } or
+ * {@link #putTransient(java.lang.Object, java.lang.Object) }
* will not be preserved between requests.</p>
*
* @since 2.1
@@ -45,8 +45,7 @@ public interface TransientStateHelper ex
public Object getTransient(Object key);
/**
- * <p>Performs the same logic as {@link
- * #getTransient(java.io.Serializable)} } but if no value is found, this
+ * <p>Performs the same logic as {@link #getTransient(java.lang.Object)} but if no value is found, this
* will return the specified <code>defaultValue</code></p>
* @param key the key for which the value should be returned.
Modified: myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/component/UIComponent.java
URL: http://svn.apache.org/viewvc/myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/component/UIComponent.java?rev=1797728&r1=1797727&r2=1797728&view=diff
==============================================================================
--- myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/component/UIComponent.java (original)
+++ myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/component/UIComponent.java Tue Jun 6 05:27:23 2017
@@ -616,7 +616,7 @@ public abstract class UIComponent
* <li>Component / Facet removed: if the parent isInView = false,
* set it to false and all their children or facets,
* otherwise take no action</li>
- * <ul>
+ * </ul>
* @param isInView
*
* @since 2.0
Modified: myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/component/_ComponentAttributesMap.java
URL: http://svn.apache.org/viewvc/myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/component/_ComponentAttributesMap.java?rev=1797728&r1=1797727&r2=1797728&view=diff
==============================================================================
--- myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/component/_ComponentAttributesMap.java (original)
+++ myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/component/_ComponentAttributesMap.java Tue Jun 6 05:27:23 2017
@@ -37,20 +37,24 @@ import javax.faces.application.Resource;
import javax.faces.context.FacesContext;
/**
+ * <p>
* A custom implementation of the Map interface, where get and put calls
* try to access getter/setter methods of an associated UIComponent before
* falling back to accessing a real Map object.
- * <p/>
+ * </p>
+ * <p>
* Some of the behaviours of this class don't really comply with the
* definitions of the Map class; for example the key parameter to all
* methods is required to be of type String only, and after clear(),
* calls to get can return non-null values. However the JSF spec
* requires that this class behave in the way implemented below. See
* UIComponent.getAttributes for more details.
- * <p/>
+ * </p>
+ * <p>
* The term "property" is used here to refer to real javabean properties
* on the underlying UIComponent, while "attribute" refers to an entry
* in the associated Map.
+ * </p>
*/
class _ComponentAttributesMap implements Map<String, Object>, Serializable
{
Modified: myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/component/behavior/AjaxBehavior.java
URL: http://svn.apache.org/viewvc/myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/component/behavior/AjaxBehavior.java?rev=1797728&r1=1797727&r2=1797728&view=diff
==============================================================================
--- myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/component/behavior/AjaxBehavior.java (original)
+++ myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/component/behavior/AjaxBehavior.java Tue Jun 6 05:27:23 2017
@@ -39,7 +39,7 @@ public class AjaxBehavior extends Client
/**
* not needed anymore but enforced by the spec
* theoretically a
- * @FacesBehavior(value = "javax.faces.behavior.Ajax")
+ * FacesBehavior(value = "javax.faces.behavior.Ajax")
* could do it
*/
public static final String BEHAVIOR_ID = "javax.faces.behavior.Ajax";
Modified: myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/context/FacesContext.java
URL: http://svn.apache.org/viewvc/myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/context/FacesContext.java?rev=1797728&r1=1797727&r2=1797728&view=diff
==============================================================================
--- myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/context/FacesContext.java (original)
+++ myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/context/FacesContext.java Tue Jun 6 05:27:23 2017
@@ -325,8 +325,7 @@ public abstract class FacesContext
/**
*
- * @return
- *
+ * @param currentPhaseId
* @since 2.0
*/
public void setCurrentPhaseId(PhaseId currentPhaseId)
@@ -343,8 +342,7 @@ public abstract class FacesContext
/**
*
- * @return
- *
+ * @param exceptionHandler
* @since 2.0
*/
public void setExceptionHandler(ExceptionHandler exceptionHandler)
@@ -362,7 +360,6 @@ public abstract class FacesContext
/**
*
* @param processingEvents
- *
* @since 2.0
*/
public void setProcessingEvents(boolean processingEvents)
Modified: myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/event/MethodExpressionActionListener.java
URL: http://svn.apache.org/viewvc/myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/event/MethodExpressionActionListener.java?rev=1797728&r1=1797727&r2=1797728&view=diff
==============================================================================
--- myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/event/MethodExpressionActionListener.java (original)
+++ myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/event/MethodExpressionActionListener.java Tue Jun 6 05:27:23 2017
@@ -28,10 +28,7 @@ import javax.faces.component.StateHolder
import javax.faces.context.FacesContext;
/**
- * See Javadoc of
- * <a href=
- * "https://javaserverfaces.dev.java.net/nonav/docs/2.0/javadocs/javax/faces/event/MethodExpressionActionListener.html">
- * JSF Specification</a>
+ *
*/
public class MethodExpressionActionListener implements ActionListener, StateHolder
{
Modified: myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/event/MethodExpressionValueChangeListener.java
URL: http://svn.apache.org/viewvc/myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/event/MethodExpressionValueChangeListener.java?rev=1797728&r1=1797727&r2=1797728&view=diff
==============================================================================
--- myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/event/MethodExpressionValueChangeListener.java (original)
+++ myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/event/MethodExpressionValueChangeListener.java Tue Jun 6 05:27:23 2017
@@ -27,8 +27,7 @@ import javax.faces.component.StateHolder
import javax.faces.context.FacesContext;
/**
- * See Javadoc of <a href="https://javaserverfaces.dev.java.net/nonav/docs/2.0/javadocs/javax/faces/event/
- * MethodExpressionValueChangeListener.html">JSF Specification</a>
+ *
*/
public class MethodExpressionValueChangeListener implements ValueChangeListener, StateHolder
{
Modified: myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/render/FacesBehaviorRenderer.java
URL: http://svn.apache.org/viewvc/myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/render/FacesBehaviorRenderer.java?rev=1797728&r1=1797727&r2=1797728&view=diff
==============================================================================
--- myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/render/FacesBehaviorRenderer.java (original)
+++ myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/render/FacesBehaviorRenderer.java Tue Jun 6 05:27:23 2017
@@ -34,7 +34,7 @@ public @interface FacesBehaviorRenderer
{
/**
* The value of this annotation attribute is taken to be the <i>renderer-type</i> which, in combination with
- * {@link #componentFamily()} can be used to obtain a reference to an instance of this {@link Renderer} by calling
+ * componentFamily can be used to obtain a reference to an instance of this {@link Renderer} by calling
* {@link RenderKit#getRenderer(java.lang.String, java.lang.String)}.
*/
public String rendererType();
Modified: myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/render/Renderer.java
URL: http://svn.apache.org/viewvc/myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/render/Renderer.java?rev=1797728&r1=1797727&r2=1797728&view=diff
==============================================================================
--- myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/render/Renderer.java (original)
+++ myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/render/Renderer.java Tue Jun 6 05:27:23 2017
@@ -131,7 +131,8 @@ public abstract class Renderer
* @return <b>true</b> - if the component takes care of rendering its children. In this case, encodeChildren() ought
* to be called by the rendering controller (e.g., the rendering controller could be the method encodeAll()
* in UIComponent). In the method encodeChildren(), the component should therefore provide all children
- * encode logic. <br/> <b>false</b> - if the component does not take care of rendering its children. In this
+ * encode logic. <p></p> <b>false</b> - if the component does not take care of rendering its children.
+ * In this
* case, encodeChildren() should not be called by the rendering controller. Instead, the children-list
* should be retrieved and the children should directly be rendered by the rendering controller one by one.
*/
Modified: myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/validator/FacesValidator.java
URL: http://svn.apache.org/viewvc/myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/validator/FacesValidator.java?rev=1797728&r1=1797727&r2=1797728&view=diff
==============================================================================
--- myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/validator/FacesValidator.java (original)
+++ myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/validator/FacesValidator.java Tue Jun 6 05:27:23 2017
@@ -36,13 +36,14 @@ public @interface FacesValidator
{
/**
* The value of this annotation attribute is taken to be the <i>validator-id</i> with which instances of this class
- * of component can be instantiated by calling {@link Application#createValidator(java.lang.String)}.
+ * of component can be instantiated by calling
+ * {@link javax.faces.application.Application#createValidator(java.lang.String)}.
*/
public String value() default "";
/**
* If it is true, the validator is added to default list calling
- * {@link javax.faces.application.Application#addDefaultValidatorId(java.lang.String)}.</
+ * {@link javax.faces.application.Application#addDefaultValidatorId(java.lang.String)}.
*/
boolean isDefault() default false;
Modified: myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/view/ViewDeclarationLanguage.java
URL: http://svn.apache.org/viewvc/myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/view/ViewDeclarationLanguage.java?rev=1797728&r1=1797727&r2=1797728&view=diff
==============================================================================
--- myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/view/ViewDeclarationLanguage.java (original)
+++ myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/view/ViewDeclarationLanguage.java Tue Jun 6 05:27:23 2017
@@ -142,7 +142,6 @@ public abstract class ViewDeclarationLan
* @since 2.3
* @param facesContext
* @param path
- * @param maxDepth
* @param options
* @return
*/
Modified: myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/view/facelets/ConverterHandler.java
URL: http://svn.apache.org/viewvc/myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/view/facelets/ConverterHandler.java?rev=1797728&r1=1797727&r2=1797728&view=diff
==============================================================================
--- myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/view/facelets/ConverterHandler.java (original)
+++ myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/view/facelets/ConverterHandler.java Tue Jun 6 05:27:23 2017
@@ -24,9 +24,9 @@ import org.apache.myfaces.buildtools.mav
/**
* Handles setting a Converter instance on a ValueHolder. Will wire all attributes set to the Converter instance
- * created/fetched. Uses the "binding" attribute for grabbing instances to apply attributes to. <p/> Will only
+ * created/fetched. Uses the "binding" attribute for grabbing instances to apply attributes to. <p> Will only
* set/create Converter is the passed UIComponent's parent is null, signifying that it wasn't restored from an existing
- * tree.
+ * tree.</p>
*
* @see javax.faces.webapp.ConverterELTag
* @see javax.faces.convert.Converter
Modified: myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/view/facelets/Tag.java
URL: http://svn.apache.org/viewvc/myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/view/facelets/Tag.java?rev=1797728&r1=1797727&r2=1797728&view=diff
==============================================================================
--- myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/view/facelets/Tag.java (original)
+++ myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/view/facelets/Tag.java Tue Jun 6 05:27:23 2017
@@ -60,7 +60,7 @@ public final class Tag
}
/**
- * Local name of the tag <my:tag /> would be "tag"
+ * Local name of the tag <my:tag /> would be "tag"
*
* @return local name of the tag
*/
@@ -90,7 +90,7 @@ public final class Tag
}
/**
- * Get the qualified name for this tag <my:tag /> would be "my:tag"
+ * Get the qualified name for this tag <my:tag > would be "my:tag"
*
* @return qualified name of the tag
*/
Modified: myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/view/facelets/ValidatorHandler.java
URL: http://svn.apache.org/viewvc/myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/view/facelets/ValidatorHandler.java?rev=1797728&r1=1797727&r2=1797728&view=diff
==============================================================================
--- myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/view/facelets/ValidatorHandler.java (original)
+++ myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/view/facelets/ValidatorHandler.java Tue Jun 6 05:27:23 2017
@@ -24,9 +24,9 @@ import org.apache.myfaces.buildtools.mav
/**
* Handles setting a Validator instance on a EditableValueHolder. Will wire all attributes set to the Validator instance
- * created/fetched. Uses the "binding" attribute for grabbing instances to apply attributes to. <p/> Will only
+ * created/fetched. Uses the "binding" attribute for grabbing instances to apply attributes to. <p> Will only
* set/create Validator is the passed UIComponent's parent is null, signifying that it wasn't restored from an existing
- * tree.
+ * tree.</p>
*/
@JSFFaceletTag
public class ValidatorHandler extends FaceletsAttachedObjectHandler implements EditableValueHolderAttachedObjectHandler
Modified: myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/webapp/UIComponentClassicTagBase.java
URL: http://svn.apache.org/viewvc/myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/webapp/UIComponentClassicTagBase.java?rev=1797728&r1=1797727&r2=1797728&view=diff
==============================================================================
--- myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/webapp/UIComponentClassicTagBase.java (original)
+++ myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/webapp/UIComponentClassicTagBase.java Tue Jun 6 05:27:23 2017
@@ -127,9 +127,6 @@ public abstract class UIComponentClassic
_facetsAdded = null;
}
- /**
- * @see http://java.sun.com/javaee/5/docs/api/javax/faces/webapp/UIComponentClassicTagBase.html#getCreated()
- */
@Override
public boolean getCreated()
{
@@ -141,12 +138,6 @@ public abstract class UIComponentClassic
return _childrenAdded;
}
- /**
- * @see http://java.sun.com/javaee/5/docs/api/javax/faces/webapp/UIComponentClassicTagBase.html#
- * getParentUIComponentClassicTagBase(javax.servlet.jsp.PageContext)
- * @param pageContext
- * @return
- */
public static UIComponentClassicTagBase getParentUIComponentClassicTagBase(PageContext pageContext)
{
Stack<UIComponentClassicTagBase> stack = getStack(pageContext);
@@ -156,10 +147,6 @@ public abstract class UIComponentClassic
return size > 0 ? stack.get(size - 1) : null;
}
- /**
- * @see http://java.sun.com/javaee/5/docs/api/javax/faces/webapp/UIComponentClassicTagBase.html#getFacesJspId()
- * @return
- */
public String getJspId()
{
return _jspId;
@@ -240,12 +227,6 @@ public abstract class UIComponentClassic
checkIfItIsInAnIterator(_jspId);
}
- /**
- * @param child
- * @see http://java.sun.com/javaee/5/docs/api/javax/faces/webapp/UIComponentTagBase.html#addChild(javax.faces.
- * _componentInstance.UIComponent)
- */
-
@Override
protected void addChild(UIComponent child)
{
@@ -257,10 +238,6 @@ public abstract class UIComponentClassic
_childrenAdded.add(child.getId());
}
- /**
- * @param name
- * @see http://java.sun.com/javaee/5/docs/api/javax/faces/webapp/UIComponentTagBase.html#addFacet(java.lang.String)
- */
@Override
protected void addFacet(String name)
{
@@ -283,11 +260,6 @@ public abstract class UIComponentClassic
return _componentInstance;
}
- /**
- * @return
- * @see http://java.sun.com/javaee/5/docs/api/javax/faces/webapp/UIComponentTagBase.html#getFacesContext()
- */
-
@Override
protected FacesContext getFacesContext()
{
@@ -318,11 +290,6 @@ public abstract class UIComponentClassic
throw new RuntimeException("FacesContext not found");
}
- /**
- * @return
- * @see http://java.sun.com/javaee/5/docs/api/javax/faces/webapp/UIComponentTagBase.html#getIndexOfNextChildTag()
- */
-
@Override
protected int getIndexOfNextChildTag()
{
@@ -334,10 +301,6 @@ public abstract class UIComponentClassic
return _childrenAdded.size();
}
- /**
- * @param id
- * @see http://java.sun.com/javaee/5/docs/api/javax/faces/webapp/UIComponentTagBase.html#setId(java.lang.String)
- */
@Override
public void setId(String id)
{
@@ -683,19 +646,15 @@ public abstract class UIComponentClassic
* <p>
* Creates a transient UIOutput using the Application, with the following characteristics:
* </p>
- * <p/>
* <p>
* <code>componentType</code> is <code>javax.faces.HtmlOutputText</code>.
* </p>
- * <p/>
* <p>
* <code>transient</code> is <code>true</code>.
* </p>
- * <p/>
* <p>
* <code>escape</code> is <code>false</code>.
* </p>
- * <p/>
* <p>
* <code>id</code> is <code>FacesContext.getViewRoot().createUniqueId()</code>
* </p>
Modified: myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/webapp/UIComponentTagBase.java
URL: http://svn.apache.org/viewvc/myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/webapp/UIComponentTagBase.java?rev=1797728&r1=1797727&r2=1797728&view=diff
==============================================================================
--- myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/webapp/UIComponentTagBase.java (original)
+++ myfaces/core/branches/2.3.x/api/src/main/java/javax/faces/webapp/UIComponentTagBase.java Tue Jun 6 05:27:23 2017
@@ -34,25 +34,10 @@ public abstract class UIComponentTagBase
{
protected static final Logger log = Logger.getLogger("javax.faces.webapp");
- /**
- * @see http://java.sun.com/javaee/5/docs/api/javax/faces/webapp/UIComponentTagBase.html#addChild(javax.faces.component.UIComponent)
- * @param child
- */
-
protected abstract void addChild(UIComponent child);
- /**
- * @see http://java.sun.com/javaee/5/docs/api/javax/faces/webapp/UIComponentTagBase.html#addFacet(java.lang.String)
- * @param name
- */
-
protected abstract void addFacet(String name);
- /**
- * @see http://java.sun.com/javaee/5/docs/api/javax/faces/webapp/UIComponentTagBase.html#getComponentInstance()
- * @return
- */
-
public abstract UIComponent getComponentInstance();
/**
@@ -62,21 +47,18 @@ public abstract class UIComponentTagBase
* intended to be overridden in subclasses to specify the actual component
* type to be created.
*
- * @see http://java.sun.com/javaee/5/docs/api/javax/faces/webapp/UIComponentTagBase.html#getComponentType()
* @return a registered component type name, never null.
*/
public abstract String getComponentType();
/**
- * @see http://java.sun.com/javaee/5/docs/api/javax/faces/webapp/UIComponentTagBase.html#getCreated()
* @return
*/
public abstract boolean getCreated();
/**
- * @see http://java.sun.com/javaee/5/docs/api/javax/faces/webapp/UIComponentTagBase.html#getELContext()
* @return
*/
@@ -94,14 +76,12 @@ public abstract class UIComponentTagBase
}
/**
- * @see http://java.sun.com/javaee/5/docs/api/javax/faces/webapp/UIComponentTagBase.html#getFacesContext()
* @return
*/
protected abstract FacesContext getFacesContext();
/**
- * @see http://java.sun.com/javaee/5/docs/api/javax/faces/webapp/UIComponentTagBase.html#getIndexOfNextChildTag()
* @return
*/
@@ -116,13 +96,11 @@ public abstract class UIComponentTagBase
* will be called passing this value, and this will later affect the
* type of renderer object returned by UIComponent.getRenderer().
*
- * @see http://java.sun.com/javaee/5/docs/api/javax/faces/webapp/UIComponentTagBase.html#getRendererType()
* @return
*/
public abstract String getRendererType();
/**
- * @see http://java.sun.com/javaee/5/docs/api/javax/faces/webapp/UIComponentTagBase.html#setId(java.lang.String)
* @param id
*/
Modified: myfaces/core/branches/2.3.x/parent/pom.xml
URL: http://svn.apache.org/viewvc/myfaces/core/branches/2.3.x/parent/pom.xml?rev=1797728&r1=1797727&r2=1797728&view=diff
==============================================================================
--- myfaces/core/branches/2.3.x/parent/pom.xml (original)
+++ myfaces/core/branches/2.3.x/parent/pom.xml Tue Jun 6 05:27:23 2017
@@ -199,7 +199,7 @@
<!-- SITE GENERATION -->
<plugin>
<artifactId>maven-javadoc-plugin</artifactId>
- <version>2.9.1</version>
+ <version>2.10.4</version>
</plugin>
<plugin>
<artifactId>maven-site-plugin</artifactId>