/**
  * Licensed 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
  *  
  * 	http://www.apache.org/licenses/LICENSE-2.0
  *  
  * 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. 
  */

package org.ximplementation;

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

/**
 * Implement method annotation.
 * <p>
 * This annotation indicate that the method is an <i>implement method</i>.
 * </p>
 * <p>
 * <b>An <i>implement method</i> is a method in an <i>implementor</i> which
 * overriding or {@code @Implement} methods in <i>implementee</i>.</b>
 * </p>
 * <p>
 * <b>An <i>implementee method</i> is a method in an <i>implementee</i> which is
 * implemented by one or more methods in <i>implementor</i>.</b>
 * </p>
 * <p>
 * <i>Implement method</i> defined through {@code @Implement} is out of Java
 * syntax limitation, it can have different name, sub parameter type and less
 * parameters with the <i>implementee method</i>, and more than one <i>implement
 * method</i>s in one <i>implementor</i> for the same <i>implementee method</i>.
 * If a parameter of an <i>implement method</i> is annotated with
 * {@linkplain ParamIndex @ParamIndex} , then its value will be set to the
 * specified {@linkplain ParamIndex#value()} index parameter value of the
 * <i>implementee method</i> when invoking. If not annotated with
 * {@linkplain ParamIndex @ParamIndex}, its value will be set to the
 * corresponding index parameter value of the <i>implementee method</i> when
 * invoking.
 * </p>
 * <p>
 * There may be many <i>implement method</i>s for one <i>implementee method</i>,
 * but only one of them will be invoked in an <i>implementee method</i>
 * invocation. <i>Implement method</i> annotated with
 * {@linkplain Validity @Validity} indicating it has an invocation validity,
 * annotated with {@linkplain Priority @Priority} indicating it has an
 * invocation priority comparing with other <i>implement method</i>s, only the
 * one with {@code true} validity and max priority will be invoked. If two
 * <i>implement method</i>s have the same {@linkplain Priority @Priority} value,
 * the one whose parameter types are closer to the current <i>implementee
 * method</i> invocation parameters has higher priority.
 * </p>
 * <p>
 * This annotation should be annotated on methods of an <i>implementor</i>.
 * </p>
 * <p>
 * Examples:
 * </p>
 * <code>
 * 
 * <pre>
 * public interface Foo
 * {
 * 	void handle(int a, int b);
 * }
 * 
 * public class Bar0 implements Foo
 * {
 * 	&#64;Override
 * 	public void handle(int a, int b)
 * 	{
 * 	}
 * }
 * 
 * &#64;Implementor(Foo.class)
 * public class Bar1
 * {
 * 	&#64;Implement
 * 	&#64;Priority(method = "getPriority")
 * 	&#64;Validity("isValid")
 * 	public void handle(int a, int b)
 * 	{
 * 	}
 * 
 * 	public int getPriority(int a, int b)
 * 	{
 * 		return 1;
 * 	}
 * 
 * 	public boolean isValid(int a, int b)
 * 	{
 * 		return (a > 0);
 * 	}
 * }
 * 
 * &#64;Implementor(Foo.class)
 * public class Bar2
 * {
 * 	&#64;Implement
 * 	public void handle(int a, int b)
 * 	{
 * 	}
 * 
 * 	&#64;Implement("handle")
 * 	public void handle0(int a)
 * 	{
 * 	}
 * 
 * 	&#64;Implement("handle")
 * 	public void handle1(@ParamIndex(1) int b)
 * 	{
 * 	}
 * }
 * </pre>
 * 
 * <code>
 * <p>
 * Here, {@code Bar0.handle}, {@code Bar1.handle}, {@code Bar2.handle},
 * {@code Bar2.handle0}, {@code Bar2.handle1} are all <i>implement method</i>s
 * of {@code Foo.handle}
 * </p>
 * 
 * @author earthangry@gmail.com
 * @date 2015-12-3
 * @see Implementor
 * @see Priority
 * @see Validity
 * @see ParamIndex
 * @see Refered
 */
@Retention(RetentionPolicy.RUNTIME)
@Target({ ElementType.METHOD })
public @interface Implement
{
	/**
	 * The identification of the <i>implementee method</i> which this method is
	 * implemented.
	 * <p>
	 * It can be any of the following values :
	 * </p>
	 * <ul>
	 * <li>The name of the <i>implementee method</i>;</li>
	 * <li>The {@linkplain Refered#value() @Refered.value} of the <i>implementee
	 * method</i>;</li>
	 * <li>The signature part of the <i>implementee method</i> (eg.
	 * <code>"plus(java.lang.Integer, java.lang.Integer)"</code>).</li>
	 * </ul>
	 * <p>
	 * If not set, its value will be treated as this <i>implement method</i>
	 * name.
	 * </p>
	 * 
	 * @return
	 */
	String value() default "";
}

@@ -3906,16 +3906,17 @@
 .handle%7D
+.
 %0A * %3C/p%3E

Add class doc