diff --git a/java/org/brotli/dec/Decode.java b/java/org/brotli/dec/Decode.java
index c4dde3f..d2c71b1 100644
--- a/java/org/brotli/dec/Decode.java
+++ b/java/org/brotli/dec/Decode.java
@@ -224,7 +224,7 @@ final class Decode {
   /**
    * Reads brotli stream header and parses "window bits".
    *
-   * @param s initialized state, before any read is performed.
+   * @param s initialized state, before any read is performed
    * @return -1 if header is invalid
    */
   private static int decodeWindowBits(State s) {
@@ -272,7 +272,8 @@ final class Decode {
    *
    * In "eager" mode decoder returns as soon as there is enough data to fill output buffer.
    *
-   * @param s initialized state, before any read is performed.
+   * @param s initialized state, before any read is performed
+   * @return {@link BROTLI_OK} on success; otherwise an error code
    */
   static int enableEagerOutput(State s) {
     if (s.runningState != INITIALIZED) {
diff --git a/java/org/brotli/dec/Huffman.java b/java/org/brotli/dec/Huffman.java
index 173075d..25fb622 100644
--- a/java/org/brotli/dec/Huffman.java
+++ b/java/org/brotli/dec/Huffman.java
@@ -40,9 +40,10 @@ final class Huffman {
   }
 
   /**
-   * @param count histogram of bit lengths for the remaining symbols,
-   * @param len code length of the next processed symbol.
-   * @return table width of the next 2nd level table.
+   * @param count histogram of bit lengths for the remaining symbols
+   * @param len code length of the next processed symbol
+   * @param rootBits number of bits in the root table
+   * @return table width of the next 2nd level table
    */
   private static int nextTableBitSize(int[] count, int len, int rootBits) {
     int bits = len;
diff --git a/java/org/brotli/integration/BundleChecker.java b/java/org/brotli/integration/BundleChecker.java
index b03c1ae..3be98ef 100644
--- a/java/org/brotli/integration/BundleChecker.java
+++ b/java/org/brotli/integration/BundleChecker.java
@@ -31,7 +31,7 @@ public class BundleChecker implements Runnable {
   private final boolean sanityCheck;
 
   /**
-   * @param sanityCheck do not calculate checksum and ignore {@link IOException}.
+   * @param sanityCheck do not calculate checksum and ignore {@link IOException}
    */
   public BundleChecker(InputStream input, AtomicInteger nextJob, boolean sanityCheck) {
     this.input = input;
diff --git a/java/org/brotli/wrapper/enc/Encoder.java b/java/org/brotli/wrapper/enc/Encoder.java
index ab0e5aa..eb929bc 100644
--- a/java/org/brotli/wrapper/enc/Encoder.java
+++ b/java/org/brotli/wrapper/enc/Encoder.java
@@ -69,6 +69,7 @@ public class Encoder implements AutoCloseable {
      * Setup encoder quality.
      *
      * @param quality compression quality, or -1 for default
+     * @return this
      */
     public Parameters setQuality(int quality) {
       if (quality < -1 || quality > 11) {
@@ -82,6 +83,7 @@ public class Encoder implements AutoCloseable {
      * Setup encoder window size.
      *
      * @param lgwin log2(LZ window size), or -1 for default
+     * @return this
      */
     public Parameters setWindow(int lgwin) {
       if ((lgwin != -1) && ((lgwin < 10) || (lgwin > 24))) {