diff --git a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/internal/core/cdtvariables/ICdtVariableChangeListener.java b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/internal/core/cdtvariables/ICdtVariableChangeListener.java
index 79740cd4bef..eda0e2096d4 100644
--- a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/internal/core/cdtvariables/ICdtVariableChangeListener.java
+++ b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/internal/core/cdtvariables/ICdtVariableChangeListener.java
@@ -10,6 +10,9 @@
  *******************************************************************************/
 package org.eclipse.cdt.internal.core.cdtvariables;
 
+/**
+ * Listener to listen to Build Variables changes events.
+ */
 public interface ICdtVariableChangeListener {
 	void variablesChanged(VariableChangeEvent event);
 }
diff --git a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/internal/core/cdtvariables/UserDefinedVariableSupplier.java b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/internal/core/cdtvariables/UserDefinedVariableSupplier.java
index b823a917e0a..c098d01fba3 100644
--- a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/internal/core/cdtvariables/UserDefinedVariableSupplier.java
+++ b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/internal/core/cdtvariables/UserDefinedVariableSupplier.java
@@ -651,10 +651,20 @@ public class UserDefinedVariableSupplier extends CoreMacroSupplierBase {
 //	protected void updateProjectInfo(int type, Object context){
 //	}
 	
+	/**
+	 * Adds a listener that will be notified of changes in Build Variables.
+	 *
+	 * @param listener - the listener to add
+	 */
 	public void addListener(ICdtVariableChangeListener listener){
 		fListeners.add(listener);
 	}
 	
+	/**
+	 * Removes a Build Variables change listener.
+	 *
+	 * @param listener - the listener to remove.
+	 */
 	public void removeListener(ICdtVariableChangeListener listener){
 		fListeners.remove(listener);
 	}
diff --git a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/internal/core/cdtvariables/VariableChangeEvent.java b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/internal/core/cdtvariables/VariableChangeEvent.java
index e42425b2ada..fbf7db1dd2c 100644
--- a/core/org.eclipse.cdt.core/src/org/eclipse/cdt/internal/core/cdtvariables/VariableChangeEvent.java
+++ b/core/org.eclipse.cdt.core/src/org/eclipse/cdt/internal/core/cdtvariables/VariableChangeEvent.java
@@ -12,6 +12,9 @@ package org.eclipse.cdt.internal.core.cdtvariables;
 
 import org.eclipse.cdt.core.cdtvariables.ICdtVariable;
 
+/**
+ * Event describing Build Variables changes.
+ */
 public class VariableChangeEvent {
 	private static final ICdtVariable[] EMPTY_VAR_ARRAY = new ICdtVariable[0];