Bug 547289 - [Passage] Provide javadoc for org.eclipse.passage.lic.api package

bundles/org.eclipse.passage.lic.api/src/org/eclipse/passage/lic/api/conditions/LicensingCondition.java

@@ -17,19 +17,33 @@
 import org.eclipse.passage.lic.api.access.PermissionEmitter;
 
 /**
- * 
+ *
  * Defines the condition to be evaluated by {@link PermissionEmitter} <br/>
  * Obtained from {@link ConditionMiner}
- * 
+ *
  * @since 0.5.0
  *
  */
 public interface LicensingCondition {
-
+	/**
+	 * Returns unique identifier of a feature under licensing.
+	 *
+	 * @return feature identifier
+	 */
 	String getFeatureIdentifier();
 
+	/**
+     * Returns descriptor of the feature version allowed by this licensing condition.
+     *
+     * @return version descriptor
+     * */
 	String getMatchVersion();
 
+	/**
+     * Returns rule of version matching, like "perfect match" or "equal or greater".
+     *
+     * @return match rule
+     * */
 	String getMatchRule();
 
 	/**
@@ -49,12 +63,20 @@ public interface LicensingCondition {
 	Date getValidUntil();
 
 	/**
-	 * the type of condition like "time" or "hardware"
-	 * 
-	 * @return
+	 * The type of condition like "time" or "hardware".
+	 *
+	 * @return condition type
 	 */
 	String getConditionType();
 
+	/**
+     * Returns additional data encoded in a single string value.
+	 * The expression is utilized by {@link PermissionEmitter} in conjunction with {@code conditionType}
+     *
+     * @return enlistment of additional information of this licencing condition
+	 * @see PermissionEmitter
+	 * @see #getConditionType
+     * */
 	String getConditionExpression();
 
 }