diff --git a/launch/interface/src/main/java/xsbti/Exit.java b/launch/interface/src/main/java/xsbti/Exit.java
index f88c8c591..3363fce39 100644
--- a/launch/interface/src/main/java/xsbti/Exit.java
+++ b/launch/interface/src/main/java/xsbti/Exit.java
@@ -1,7 +1,9 @@
 package xsbti;
 
-/** A launched application returns an instance of this class in order to communicate to the launcher
-* that the application is completely finished and the launcher should exit with the given exit code.*/
+/**
+ * A launched application returns an instance of this class in order to communicate to the launcher
+ * that the application finished and the launcher should exit with the given exit code.
+ */
 public interface Exit extends MainResult
 {
 	public int code();
diff --git a/launch/interface/src/main/java/xsbti/MainResult.java b/launch/interface/src/main/java/xsbti/MainResult.java
index e81aede2d..b6f27a680 100644
--- a/launch/interface/src/main/java/xsbti/MainResult.java
+++ b/launch/interface/src/main/java/xsbti/MainResult.java
@@ -1,8 +1,12 @@
 package xsbti;
 
-/** A launched application should return an instance of this from its 'run' method
-* to communicate to the launcher what should be done now that the application
-* has competed.  This interface should be treated as 'sealed', with Exit and Reboot the only
-* direct subtypes.
-*/
+/**
+ * A launched application should return an instance of this from its 'run' method
+ * to communicate to the launcher what should be done now that the application
+ * has completed.  This interface should be treated as 'sealed', with Exit and Reboot the only
+ * direct subtypes.
+ *
+ * @see xsbti.Exit
+ * @see xsbti.Reboot
+ */
 public interface MainResult {}
\ No newline at end of file
diff --git a/launch/interface/src/main/java/xsbti/Reboot.java b/launch/interface/src/main/java/xsbti/Reboot.java
index cb978c32a..0d6136a53 100644
--- a/launch/interface/src/main/java/xsbti/Reboot.java
+++ b/launch/interface/src/main/java/xsbti/Reboot.java
@@ -2,9 +2,11 @@ package xsbti;
 
 import java.io.File;
 
-/** A launched application returns an instance of this class in order to communicate to the launcher
-* that the application should be restarted.  Different versions of the application and Scala can be used.
-* The application can be given different arguments and a new working directory as well.*/
+/**
+ * A launched application returns an instance of this class in order to communicate to the launcher
+ * that the application should be restarted. Different versions of the application and Scala can be used.
+ * The application can be given different arguments as well as a new working directory.
+ */
 public interface Reboot extends MainResult
 {
 	public String[] arguments();