# HG changeset patch
# User Christian Humer <christian.humer@gmail.com>
# Date 1407765467 -7200
# Node ID ea9903f9684f24fb9cd2d5c58eb9a1630f8bf17e
# Parent  e5e1013c04fdbb2641c5083630af7199f76f97f5
Truffle-DSL: added some javadoc

diff -r e5e1013c04fd -r ea9903f9684f graal/com.oracle.truffle.api.dsl/src/com/oracle/truffle/api/dsl/Specialization.java
--- a/graal/com.oracle.truffle.api.dsl/src/com/oracle/truffle/api/dsl/Specialization.java	Mon Aug 11 15:57:47 2014 +0200
+++ b/graal/com.oracle.truffle.api.dsl/src/com/oracle/truffle/api/dsl/Specialization.java	Mon Aug 11 15:57:47 2014 +0200
@@ -30,15 +30,34 @@
 @Target({ElementType.METHOD})
 public @interface Specialization {
 
-    int DEFAULT_ORDER = -1;
+    /**
+     * @deprecated do not use anymore. Will get removed in the next release.
+     */
+    @Deprecated int DEFAULT_ORDER = -1;
 
+    /**
+     * The order has no effect anymore. The declaration order specialization methods is used
+     * instead.
+     *
+     * @deprecated use declaration order instead. Will get removed in the next release.
+     */
     @Deprecated
     int order() default DEFAULT_ORDER;
 
+    /**
+     * Inserts this and all specializations that are declared after this specialization before a
+     * specialization in the superclass. By default all specializations of the subclass are appended
+     * to the specializations of the superclass.
+     */
     String insertBefore() default "";
 
     Class<? extends Throwable>[] rewriteOn() default {};
 
+    /**
+     * The contains attribute declares all specializations that are contained by this
+     * specialization. A containing specialization must be strictly generic as the contained
+     * specialization.
+     */
     String[] contains() default {};
 
     String[] guards() default {};