- Document that getAnnotation(IModelElement modelElement, Class<T> clazz)...

- Document that getAnnotation(IModelElement modelElement, Class<T> clazz) wraps the model access into a command
refs 2199,1841

org.fortiss.tooling.base/trunk/src/org/fortiss/tooling/base/utils/AnnotationUtils.java

@@ -68,9 +68,18 @@ public class AnnotationUtils {
 	}
 
 	/**
+	 * <p>
 	 * Returns the annotation of a given {@code Class<T>} from a given {@code modelElement}. If the
 	 * annotation does not exist yet, it is created and added to the specification list of the
 	 * {@code modelElement}.
+	 * </p>
+	 * 
+	 * <p>
+	 * <b>Note: </b>The access to the model is wrapped into a command in order to allow for
+	 * transparent creation of the annotation object from other contexts (e.g., GUI). If this is not
+	 * desirable, use the {@link #getAnnotation(IModelElement, Class, boolean)} variant of this
+	 * method.
+	 * </p>
 	 */
 	public static <T extends IAnnotatedSpecification> T getAnnotation(IModelElement modelElement,
 			Class<T> clazz) {