diff --git a/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/core/subsystems/ISubSystem.java b/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/core/subsystems/ISubSystem.java
index 01fad9c6530..18eab004f7c 100644
--- a/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/core/subsystems/ISubSystem.java
+++ b/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/core/subsystems/ISubSystem.java
@@ -93,7 +93,8 @@ public interface ISubSystem extends ISystemFilterPoolReferenceManagerProvider, I
 	public void uninitializeSubSystem(IProgressMonitor monitor);
 
 	/**
-	 * @return true if this subsystem's properties should take precedence over other subsystems that share the same IConnectorService
+	 * @return true if this subsystem's properties should take precedence over other
+	 * subsystems that share the same {@link IConnectorService}
 	 */
 	public boolean isPrimarySubSystem();
 
diff --git a/rse/plugins/org.eclipse.rse.ui/subsystems/org/eclipse/rse/core/subsystems/SubSystem.java b/rse/plugins/org.eclipse.rse.ui/subsystems/org/eclipse/rse/core/subsystems/SubSystem.java
index 551210b56db..c97a1287d13 100644
--- a/rse/plugins/org.eclipse.rse.ui/subsystems/org/eclipse/rse/core/subsystems/SubSystem.java
+++ b/rse/plugins/org.eclipse.rse.ui/subsystems/org/eclipse/rse/core/subsystems/SubSystem.java
@@ -778,7 +778,7 @@ public abstract class SubSystem extends RSEModelObject
 	 * <code>super.getObjectWithAbsoluteName(key)</code>
 	 * when they do not find a reference for the key themselves.
 	 * </p>
-	 * @see org.eclipse.rse.core.subsystems.IRemoteObjectResolver#getObjectWithAbsoluteName(java.lang.String)
+	 * @see org.eclipse.rse.core.subsystems.IRemoteObjectResolver#getObjectWithAbsoluteName(String, IProgressMonitor)
 	 * 
 	 * @param key the unique id of the remote object.
 	 *     Must not be <code>null</code>.
@@ -2949,12 +2949,9 @@ public abstract class SubSystem extends RSEModelObject
 		return;
 	}
 
-
-
-	
-	/**
-	 * @return true if this subsystem's properties should take precedence
-	 *  over other subsystems that share the same IConnectorService
+	/*
+	 * (non-Javadoc)
+	 * @see org.eclipse.rse.core.subsystems.ISubSystem#isPrimarySubSystem()
 	 */
 	public boolean isPrimarySubSystem()
 	{
@@ -2962,7 +2959,8 @@ public abstract class SubSystem extends RSEModelObject
 	}
 	
 	/*
-	 * Returns the first subsystem associated with the connection
+	 * (non-Javadoc)
+	 * @see org.eclipse.rse.core.subsystems.ISubSystem#getPrimarySubSystem()
 	 */
 	public ISubSystem getPrimarySubSystem()
 	{