diff -r d382dacfd73f -r 033ea09379a0 rt/core/src/main/java/org/apidesign/bck2brwsr/core/JavaScriptPrototype.java
--- a/rt/core/src/main/java/org/apidesign/bck2brwsr/core/JavaScriptPrototype.java	Tue Feb 26 16:54:16 2013 +0100
+++ b/rt/core/src/main/java/org/apidesign/bck2brwsr/core/JavaScriptPrototype.java	Thu Feb 28 20:51:53 2013 +0100
@@ -22,7 +22,14 @@
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
 
-/** Controls how JavaScript inheritance should be handled.
+/** Influence the inheritance of your class when converted to JavaScript.
+ * Sometimes one does not want
+ * to mimic the Java hierarchy, but modify it a bit. For example it makes
+ * sense to treat every (JavaScript) string literal as {@link String}.
+ * One can do it by making {@link String} subclass JavaScript <code>String</code>
+ * and use <code>String.prototype</code> as a container for all {@link String}
+ * methods.
+ * 
  * @author Jaroslav Tulach <jtulach@netbeans.org>
  */
 @Retention(RetentionPolicy.CLASS)