improved jdoc

Author: rbri

src/main/java/org/htmlunit/Screen.java

@@ -46,6 +46,8 @@ public Screen(final WebClient webClient) {
     }
 
     /**
+     * Returns the value of the {@code availHeight} property.
+     *
      * @return the {@code availHeight} property
      */
     public int getAvailHeight() {
@@ -61,6 +63,8 @@ public void setAvailHeight(final int availHeight) {
     }
 
     /**
+     * Returns the value of the {@code availLeft} property.
+     *
      * @return the {@code availLeft} property
      */
     public int getAvailLeft() {
@@ -76,6 +80,8 @@ public void setAvailLeft(final int availLeft) {
     }
 
     /**
+     * Returns the value of the {@code availTop} property.
+     *
      * @return the {@code availTop} property
      */
     public int getAvailTop() {
@@ -91,6 +97,8 @@ public void setAvailTop(final int availTop) {
     }
 
     /**
+     * Returns the value of the {@code availWidth} property.
+     *
      * @return the {@code availWidth} property
      */
     public int getAvailWidth() {
@@ -106,6 +114,8 @@ public void setAvailWidth(final int availWidth) {
     }
 
     /**
+     * Returns the value of the {@code colorDepth} property.
+     *
      * @return the {@code colorDepth} property
      */
     public int getColorDepth() {
@@ -121,6 +131,8 @@ public void setColorDepth(final int colorDepth) {
     }
 
     /**
+     * Returns the value of the {@code deviceXDPI} property.
+     *
      * @return the {@code deviceXDPI} property
      */
     public int getDeviceXDPI() {
@@ -136,6 +148,8 @@ public void setDeviceXDPI(final int deviceXDPI) {
     }
 
     /**
+     * Returns the value of the {@code deviceYDPI} property.
+     *
      * @return the {@code deviceYDPI} property
      */
     public int getDeviceYDPI() {
@@ -151,6 +165,8 @@ public void setDeviceYDPI(final int deviceYDPI) {
     }
 
     /**
+     * Returns the value of the {@code height} property.
+     *
      * @return the {@code height} property
      */
     public int getHeight() {
@@ -166,6 +182,8 @@ public void setHeight(final int height) {
     }
 
     /**
+     * Returns the value of the {@code left} property.
+     *
      * @return the {@code left} property
      */
     public int getLeft() {
@@ -181,6 +199,8 @@ public void setLeft(final int left) {
     }
 
     /**
+     * Returns the value of the {@code pixelDepth} property.
+     *
      * @return the {@code pixelDepth} property
      */
     public int getPixelDepth() {
@@ -196,6 +216,8 @@ public void setPixelDepth(final int pixelDepth) {
     }
 
     /**
+     * Returns the value of the {@code top} property.
+     *
      * @return the {@code top} property
      */
     public int getTop() {
@@ -211,6 +233,8 @@ public void setTop(final int top) {
     }
 
     /**
+     * Returns the value of the {@code width} property.
+     *
      * @return the {@code width} property
      */
     public int getWidth() {

src/main/java/org/htmlunit/SgmlPage.java

@@ -407,14 +407,18 @@ public void clearComputedStylesUpToRoot(final DomElement element) {
     }
 
     /**
-     * @return whether or not this is currently printing
+     * Returns whether this page is currently being printed.
+     *
+     * @return {@code true} if this page is currently being printed
      */
     public boolean isPrinting() {
         return printing_;
     }
 
     /**
-     * @param printing the printing state to set
+     * Sets whether this page is currently being printed.
+     *
+     * @param printing {@code true} if this page is currently being printed
      */
     public void setPrinting(final boolean printing) {
         printing_ = printing;
@@ -429,21 +433,26 @@ public void domChangeListenerAdded() {
     }
 
     /**
-     * @return true if at least one domChangeListener was registered.
+     * Returns whether any DOM change listeners have been registered.
+     *
+     * @return {@code true} if at least one DOM change listener has been registered
      */
     public boolean isDomChangeListenerInUse() {
         return domChangeListenerInUse_;
     }
 
     /**
-     * Informs about the use of a characterDataChangeListener.
+     * Marks that a character data change listener has been registered.
      */
     public void characterDataChangeListenerAdded() {
         characterDataChangeListenerInUse_ = true;
     }
 
     /**
-     * @return true if at least one characterDataChangeListener was registered.
+     * Returns whether any character data change listeners have been registered.
+     *
+     * @return {@code true} if at least one character data change listener has
+     *         been registered
      */
     public boolean isCharacterDataChangeListenerInUse() {
         return characterDataChangeListenerInUse_;