From 5b9b6929c5414c95cdb1f62a577c179b6c8798f3 Mon Sep 17 00:00:00 2001
From: Vincent Aravantinos <aravantinos@fortiss.org>
Date: Wed, 4 Feb 2015 17:17:24 +0000
Subject: [PATCH] RED refs 2255

---
 .../valueprovider/IAnnotationValueProvider.java           | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/org.fortiss.tooling.base/trunk/src/org/fortiss/tooling/base/annotation/valueprovider/IAnnotationValueProvider.java b/org.fortiss.tooling.base/trunk/src/org/fortiss/tooling/base/annotation/valueprovider/IAnnotationValueProvider.java
index 6fa9f336f..1d2f0ca4e 100644
--- a/org.fortiss.tooling.base/trunk/src/org/fortiss/tooling/base/annotation/valueprovider/IAnnotationValueProvider.java
+++ b/org.fortiss.tooling.base/trunk/src/org/fortiss/tooling/base/annotation/valueprovider/IAnnotationValueProvider.java
@@ -36,10 +36,10 @@ import org.fortiss.tooling.kernel.service.base.IEObjectAware;
  * </p>
  * 
  * <p>
- * The interface / some of its methods take two template parameters
+ * The interface / some of its methods take two template parameters:
  * 
  * <ul>
- * <li><tt>T</tt>: Meta-model type of the specification, i.e. the particular subclass of
+ * <li><tt>T</tt>: Meta-model type of the specification, i.e., the particular subclass of
  * {@link IAnnotatedSpecification} supported by the respective implementation of this
  * {@link IAnnotationValueProvider} interface.</li>
  * <li><tt>U</tt>: Data type used in the UI to support the respective annotation. For <tt>U</tt>, a
@@ -81,6 +81,10 @@ public interface IAnnotationValueProvider<T extends IAnnotatedSpecification> ext
 	public <U> U getAnnotationValue(T specification) throws Exception;
 
 	/**
+	 * TODO(VA) Probably obvious for somebody who knows already how to deal with annotations but not
+	 * for a newcomer, so take this remark into account only if you think it's valuable: what is a
+	 * multi-instance annotation?
+	 * 
 	 * Returns the value of a multi-instance annotation's instance denoted by {@code instanceKey}.
 	 */
 	public <U> U getAnnotationValue(T specification, String instanceKey) throws Exception;
-- 
GitLab