diff --git a/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/core/IRSESystemType.java b/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/core/IRSESystemType.java
index c2ada6d02ee..4a89aebd996 100644
--- a/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/core/IRSESystemType.java
+++ b/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/core/IRSESystemType.java
@@ -27,9 +27,11 @@ import org.osgi.framework.Bundle;
 /**
  * Interface for a system type. Constants are defined for various system types.
  * These constants are kept in sync with definitions in plugin.xml.
- * 
- * This interface is not intended to be implemented directly by clients.
- * Clients should extend the abstract base class {@link AbstractRSESystemType} instead.
+ * <p>
+ * This interface is not intended to be implemented by clients.  System type
+ * implementations must subclass {@link AbstractRSESystemType} rather than
+ * implementing this interface directly.
+ * </p>
  */
 public interface IRSESystemType extends IAdaptable {
 
diff --git a/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/core/model/ISystemRegistry.java b/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/core/model/ISystemRegistry.java
index 392a4eac48e..7578fad8db8 100644
--- a/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/core/model/ISystemRegistry.java
+++ b/rse/plugins/org.eclipse.rse.core/src/org/eclipse/rse/core/model/ISystemRegistry.java
@@ -48,10 +48,12 @@ import org.eclipse.rse.internal.core.RSECoreRegistry;
  * To get it, call the {@link org.eclipse.rse.core.RSECorePlugin#getTheSystemRegistry()}.
  * <p>
  * The idea here is that connections are grouped by system profile. At any 
- *  time, there is a user-specified number of profiles "active" and connections
- *  from each active profile are worked with.
+ * time, there is a user-specified number of profiles "active" and connections
+ * from each active profile are worked with.
+ * </p>
  * <p>
  * This interface is not intended to be implemented by clients.
+ * </p>
  */
 public interface ISystemRegistry extends ISchedulingRule, IAdaptable {
 
diff --git a/rse/plugins/org.eclipse.rse.ui/model/org/eclipse/rse/ui/model/ISystemRegistryUI.java b/rse/plugins/org.eclipse.rse.ui/model/org/eclipse/rse/ui/model/ISystemRegistryUI.java
index d5fdd255838..a34845cf4a1 100644
--- a/rse/plugins/org.eclipse.rse.ui/model/org/eclipse/rse/ui/model/ISystemRegistryUI.java
+++ b/rse/plugins/org.eclipse.rse.ui/model/org/eclipse/rse/ui/model/ISystemRegistryUI.java
@@ -29,8 +29,9 @@ import org.eclipse.swt.widgets.Shell;
 
 /**
  * Registry and control center for RSE UI related operations.
- * 
+ * <p>
  * This interface is not intended to be implemented by clients.
+ * </p>
  */
 public interface ISystemRegistryUI 
 	extends ISystemShellProvider, ISystemViewInputProvider {