2nd round of clean ups (see r25285)

1 files changed, 13 insertions, 2 deletions

diff --git a/src/library/scala/remote.scala b/src/library/scala/remote.scala
index 01805101be..bf6b440031 100644
--- a/src/library/scala/remote.scala
+++ b/src/library/scala/remote.scala
@@ -6,11 +6,22 @@
 **                          |/                                          **
 \*                                                                      */
 
-
-
 package scala
 
 /**
  * An annotation that designates the class to which it is applied as remotable.
+ *
+ * For instance, the Scala code
+ * {{{
+ * @remote trait Hello {
+ *   def sayHello(): String
+ * }
+ * }}}
+ * is equivalent to the following Java code:
+ * {{{
+ * public interface Hello extends java.rmi.Remote {
+ *     String sayHello() throws java.rmi.RemoteException;
+ * }
+ * }}}
  */
 class remote extends annotation.StaticAnnotation {}