diff --git a/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/internal/core/model/SystemHostPool.java b/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/internal/core/model/SystemHostPool.java
index 8843551fd4d..df4b5d763e1 100644
--- a/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/internal/core/model/SystemHostPool.java
+++ b/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/internal/core/model/SystemHostPool.java
@@ -20,7 +20,7 @@
  * Martin Oberhuber (Wind River) - [186779] Fix IRSESystemType.getAdapter()
  * David Dykstal (IBM) - [176577] wrong enablement of "Move up/down" in connection context menu
  * Martin Oberhuber (Wind River) - [206742] Make SystemHostPool thread-safe
- * David Dykstal (IBM) - [210537] removed exception signalling from this class to match the interface
+ * David Dykstal (IBM) - [210537] removed exception signaling from this class to match the interface
  ********************************************************************************/
 
 package org.eclipse.rse.internal.core.model;
@@ -141,7 +141,7 @@ public class SystemHostPool extends RSEModelObject implements ISystemHostPool
 
     /**
      * Private debug method to print connections, to test restored ok.
-     * @deprecated
+     * @deprecated this private debug method may be removed at any time.
      */
     public void printConnections()
     {
diff --git a/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/internal/core/model/SystemPreferenceChangeEvent.java b/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/internal/core/model/SystemPreferenceChangeEvent.java
index 9cdd736e65c..f2eb0c05455 100644
--- a/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/internal/core/model/SystemPreferenceChangeEvent.java
+++ b/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/internal/core/model/SystemPreferenceChangeEvent.java
@@ -18,6 +18,7 @@ package org.eclipse.rse.internal.core.model;
 import java.util.EventObject;
 
 import org.eclipse.rse.core.events.ISystemPreferenceChangeEvent;
+import org.eclipse.rse.core.events.ISystemPreferenceChangeEvents;
 
 
 /**
@@ -36,9 +37,9 @@ public class SystemPreferenceChangeEvent
 	/**
 	 * Constructor 
      * @see org.eclipse.rse.core.events.ISystemPreferenceChangeEvents
-	 * @param source The object that was added,deleted,renamed,changed.
-	 * @param type The type of event, one of ISystemChangeEvent constants.
-	 * @param parent The parent of the object that was added or deleted.
+	 * @param type The type of event, one of {@link ISystemPreferenceChangeEvents} constants.
+	 * @param oldValue the old value of the Preference
+	 * @param newValue the old value of the Preference
 	 */
 	public SystemPreferenceChangeEvent(int type, Object oldValue, Object newValue)
 	{