unneeded, I suggest you to read our mate Stephen's blog about that: http://blog.joda.org/2012/11/javadoc-coding-standards.html
HTH, -Simo http://people.apache.org/~simonetripodi/ http://simonetripodi.livejournal.com/ http://twitter.com/simonetripodi http://www.99soft.org/ On Sun, Feb 17, 2013 at 2:18 PM, <brit...@apache.org> wrote: > Author: britter > Date: Sun Feb 17 13:17:59 2013 > New Revision: 1447019 > > URL: http://svn.apache.org/r1447019 > Log: > Wrap JavaDoc paragraphs in <p>-tags > > Modified: > > commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/ClassAccessor.java > > Modified: > commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/ClassAccessor.java > URL: > http://svn.apache.org/viewvc/commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/ClassAccessor.java?rev=1447019&r1=1447018&r2=1447019&view=diff > ============================================================================== > --- > commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/ClassAccessor.java > (original) > +++ > commons/sandbox/beanutils2/trunk/src/main/java/org/apache/commons/beanutils2/ClassAccessor.java > Sun Feb 17 13:17:59 2013 > @@ -20,7 +20,9 @@ package org.apache.commons.beanutils2; > */ > > /** > + * <p> > * Provides access to constructors and static methods on a class. > + * </p> > * > * @param <B> The type modeled by this {@code ClassAccessor}. > */ > @@ -30,9 +32,11 @@ public interface ClassAccessor<B> > // constructors > > /** > + * <p> > * Creates a new instance of type {@code B} by calling the parameterless > constructor of the wrapped class. > + * </p> > * > - * @param<B> the type of the new instance > + * @param <B> the type of the new instance > * @return a {@link BeanAccessor} that wraps the new instance. > * @throws BeanInstantiationException if the class wrapped by this > {@code ClassAccessor} is not instantiable (for > * example if it is a primitive type). > @@ -44,8 +48,10 @@ public interface ClassAccessor<B> > BeanAccessor<B> newInstance(); > > /** > + * <p> > * Invokes the constructor with the parameter list represented by {@code > arguments} on the wrapped class. Primitive > * types may be converted to wrapper types and vice versa to match the > methods signature. > + * </p> > * > * @param arguments the list of arguments to invoke the constructor > with. None of the {@code Argument} objects must > * be {@code null}. If you want to pass {@code null} to the > constructor use > @@ -60,8 +66,10 @@ public interface ClassAccessor<B> > BeanAccessor<B> invokeConstructor( Argument<?>... arguments ); > > /** > + * <p> > * Invokes the constructor with the parameter list represented by {@code > arguments} on the wrapped class. Invoking > * an exact constructor in this context means to not perform any type > conversations during invocation. > + * </p> > * > * @param arguments the list of arguments to invoke the constructor > with. None of the {@code Argument} objects must > * be {@code null}. If you want to pass {@code null} to the > constructor use > @@ -79,7 +87,9 @@ public interface ClassAccessor<B> > // bean properties > > /** > + * <p> > * Provides access to the {@link BeanProperties} defined by the wrapped > class. > + * </p> > * > * @return the {@link BeanProperties} for the wrapped class. > */ > @@ -88,8 +98,10 @@ public interface ClassAccessor<B> > // static methods invocation > > /** > + * <p> > * Invokes the method with name {@code methodName} on the wrapped class. > Primitive types may be converted to wrapper > * types and vice versa to match the methods signature. > + * </p> > * > * @param methodName the name of the method to invoke. Must not be > {@code null}! > * @return the {@link ArgumentsAccessor} for this method invocation. > @@ -97,8 +109,10 @@ public interface ClassAccessor<B> > ArgumentsAccessor invokeStatic( String methodName ); > > /** > + * <p> > * Invokes the method with name {@code methodName} on the wrapped class. > Invoking an exact method in this context > * means to not perform any type conversations during invocation. > + * </p> > * > * @param methodName the name of the method to invoke. Must not be > {@code null}! > * @return the {@link ArgumentsAccessor} for this method invocation. > > --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org For additional commands, e-mail: dev-h...@commons.apache.org
