improved jdoc

Author: rbri

src/main/java/org/htmlunit/javascript/HtmlUnitScriptable.java

@@ -109,7 +109,6 @@ public void put(final String name, final Scriptable start, final Object value) {
      * Normally HtmlUnit objects don't need to overwrite this method as properties are defined
      * on the prototypes. In some cases where "content" of object
      * has priority compared to the properties consider using utility {@link #getWithPreemption(String)}.
-     * <p>
      * {@inheritDoc}
      */
     @Override

src/main/java/org/htmlunit/javascript/host/Netscape.java

@@ -38,4 +38,4 @@ public class Netscape extends HtmlUnitScriptable {
     public String getClassName() {
         return "Object";
     }
-}
+}

src/main/java/org/htmlunit/javascript/host/event/SubmitEvent.java

@@ -70,7 +70,9 @@ public void jsConstructor(final String type, final ScriptableObject details) {
     }
 
     /**
-     * @return the submitter
+     * Returns the element that triggered the form submission.
+     *
+     * @return the submitter element, or {@code null} if none is available
      */
     @JsxGetter
     public HTMLElement getSubmitter() {

src/main/java/org/htmlunit/javascript/host/event/UIEvent.java

@@ -162,8 +162,10 @@ public void initUIEvent(
     }
 
     /**
-     * @return a number that indicates which button was pressed on the mouse,
-     *         or the numeric keyCode or the character code (charCode) of the key pressed on the keyboard
+     * Returns the button or key associated with this event.
+     *
+     * @return the mouse button that was pressed, or the numeric {@code keyCode}
+     *         or character {@code charCode} of the key that was pressed
      */
     @JsxGetter
     public int getWhich() {