diff -r d382dacfd73f -r 033ea09379a0 rt/core/src/main/java/org/apidesign/bck2brwsr/core/ExtraJavaScript.java
--- a/rt/core/src/main/java/org/apidesign/bck2brwsr/core/ExtraJavaScript.java	Tue Feb 26 16:54:16 2013 +0100
+++ b/rt/core/src/main/java/org/apidesign/bck2brwsr/core/ExtraJavaScript.java	Thu Feb 28 20:51:53 2013 +0100
@@ -22,14 +22,16 @@
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
 
-/**
+/** A way to include pre-made JavaScript scripts and libraries.
+ * The {@link #resource()} is loaded into the JavaScript VM and its object
+ * can be referenced from the class annotated by this annotation.
  *
  * @author Jaroslav Tulach <jtulach@netbeans.org>
  */
 @Retention(RetentionPolicy.CLASS)
 @Target(ElementType.TYPE)
 public @interface ExtraJavaScript {
-    /** location of a script to load */
+    /** fully qualified location of a script to load. Start the path with slash. */
     String resource();
     /** should the class file still be processed or not? */
     boolean processByteCode() default true;