1 /*
2 * EL4J, the Extension Library for the J2EE, adds incremental enhancements to
3 * the spring framework, http://el4j.sf.net
4 * Copyright (C) 2006 by ELCA Informatique SA, Av. de la Harpe 22-24,
5 * 1000 Lausanne, Switzerland, http://www.elca.ch
6 *
7 * EL4J is published under the GNU Lesser General Public License (LGPL)
8 * Version 2.1. See http://www.gnu.org/licenses/
9 *
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU Lesser General Public License for more details.
14 *
15 * For alternative licensing, please contact info@elca.ch
16 */
17 package ch.elca.el4j.util.codingsupport.annotations;
18
19 import java.lang.annotation.Documented;
20 import java.lang.annotation.Inherited;
21 import java.lang.annotation.Retention;
22 import java.lang.annotation.RetentionPolicy;
23
24 /**
25 * The annotated API element is preliminary and subject to major change. The
26 * idea for this type was shamelessly stolen from
27 *
28 * <p>
29 *<a href="http://java.sun.com/j2se/1.5.0/docs/guide/language/annotations.html">
30 * http://java.sun.com/j2se/1.5.0/docs/guide/language/annotations.html</a>
31 *
32 *
33 * <p> The String argument should detail why the annotated element is
34 * preliminary. This annotation itself is preliminary (prototype stage).
35 *
36 * @svnLink $Revision: 3882 $;$Date: 2009-08-04 15:24:14 +0200 (Di, 04. Aug 2009) $;$Author: swismer $;$URL: https://el4j.svn.sourceforge.net/svnroot/el4j/branches/el4j_3_1/el4j/framework/modules/core/src/main/java/ch/elca/el4j/util/codingsupport/annotations/Preliminary.java $
37 *
38 * @author Adrian Moos (AMS)
39 */
40 @Documented
41 @Retention(RetentionPolicy.SOURCE)
42 @Inherited
43 public @interface Preliminary {
44 /** why this is preliminary. */
45 @Preliminary("lack of known use cases")
46 String value() default "";
47 }