I added DebuggableScript to javadoc list and fixed javadoc warnings about its documentation comments.

js/rhino/apiClasses.properties

@@ -25,5 +25,6 @@ apiClasses=\
 	src/org/mozilla/javascript/Wrapper.java,\
 	src/org/mozilla/javascript/Synchronizer.java,\
 	src/org/mozilla/javascript/optimizer/ClassCompiler.java,\
+	src/org/mozilla/javascript/debug/DebuggableScript.java,\
 	src/org/mozilla/javascript/serialize/ScriptableInputStream.java,\
 	src/org/mozilla/javascript/serialize/ScriptableOutputStream.java

js/rhino/src/org/mozilla/javascript/debug/DebuggableScript.java

@@ -20,6 +20,7 @@
  *
  * Contributor(s):
  * Norris Boyd
+ * Igor Bukanov
  *
  * Alternatively, the contents of this file may be used under the
  * terms of the GNU Public License (the "GPL"), in which case the
@@ -82,8 +83,9 @@ public interface DebuggableScript
     /**
      * Get name of a declared parameter or local variable.
      * <tt>index</tt> should be less then {@link #getParamAndVarCount()}.
-     * If <tt>index &lt; {@link #getParamCount()}</tt>, return the name of
-     * the corresponding parameter, otherwise return the name of variable.
+     * If <tt>index&nbsp;&lt;&nbsp;{@link #getParamCount()}</tt>, return
+     * the name of the corresponding parameter, otherwise return the name
+     * of variable.
      * If this script is not function, return the name of the declared
      * global variable.
      */
@@ -96,8 +98,9 @@ public interface DebuggableScript
     public String getSourceName();
 
     /**
-     * Retutns true for functions constructed via <tt>Function(...)</tt>
-     * or  eval scripts or any function defined by such functions or scripts
+     * Returns true if this script or function were runtime-generated
+     * from JavaScript using <tt>eval</tt> function or <tt>Function</tt>
+     * or <tt>Script</tt> constructors.
      */
     public boolean isGeneratedScript();