diff --git a/apps/streaming/java/src/net/i2p/client/streaming/impl/Packet.java b/apps/streaming/java/src/net/i2p/client/streaming/impl/Packet.java
index 8872205d5cb7ed281239cd63beb43a44a6c544ef..eed07853d8368145847e0ea13a6eca95e0e90e58 100644
--- a/apps/streaming/java/src/net/i2p/client/streaming/impl/Packet.java
+++ b/apps/streaming/java/src/net/i2p/client/streaming/impl/Packet.java
@@ -391,7 +391,7 @@ class Packet {
     /**
      * What is the largest payload the sender of this packet wants to receive?
      *
-     * @return Maximum payload size sender can receive (MRU)
+     * @return Maximum payload size sender can receive (MRU) or zero if unset
      */
     public int getOptionalMaxSize() { return _optionMaxSize; }
 
diff --git a/core/java/src/net/i2p/crypto/EncAlgo.java b/core/java/src/net/i2p/crypto/EncAlgo.java
index 99a6c762e97310e54eb2ea44dd8301c236f50865..cc2c533820eaf4bea57f86df2ab12e48f9e5ceac 100644
--- a/core/java/src/net/i2p/crypto/EncAlgo.java
+++ b/core/java/src/net/i2p/crypto/EncAlgo.java
@@ -1,8 +1,6 @@
 package net.i2p.crypto;
 
 /**
- * PRELIMINARY - unused - subject to change
- *
  * Base encryption algorithm type
  *
  * @since 0.9.18
diff --git a/core/java/src/net/i2p/crypto/EncType.java b/core/java/src/net/i2p/crypto/EncType.java
index 368e62046644b2e3206b22944d5103e327c5b787..f05517ae080f2da3534ab915616e33a5800c7a50 100644
--- a/core/java/src/net/i2p/crypto/EncType.java
+++ b/core/java/src/net/i2p/crypto/EncType.java
@@ -11,8 +11,6 @@ import net.i2p.data.Hash;
 import net.i2p.data.SimpleDataStructure;
 
 /**
- * PRELIMINARY - subject to change
- *
  * Defines the properties for various encryption types
  * that I2P supports or may someday support.
  *
diff --git a/core/java/src/net/i2p/data/LeaseSet2.java b/core/java/src/net/i2p/data/LeaseSet2.java
index 5a86f7023429d061039e6423d5ea2d50faf4acaa..7f7972fe8533451bf215d380662246b3864782a1 100644
--- a/core/java/src/net/i2p/data/LeaseSet2.java
+++ b/core/java/src/net/i2p/data/LeaseSet2.java
@@ -21,7 +21,7 @@ import net.i2p.util.Log;
 import net.i2p.util.OrderedProperties;
 
 /**
- * PRELIMINARY - Subject to change - see proposal 123
+ * See proposal 123
  *
  * @since 0.9.38
  */
diff --git a/core/java/src/net/i2p/util/FileUtil.java b/core/java/src/net/i2p/util/FileUtil.java
index e1b6d0235f9c3c2736980e2bd53a6437b7f24362..d07c0f5bc27b1532344d4dead31d4093846976f1 100644
--- a/core/java/src/net/i2p/util/FileUtil.java
+++ b/core/java/src/net/i2p/util/FileUtil.java
@@ -361,6 +361,7 @@ public class FileUtil {
      * Warning - this inefficiently allocates a StringBuilder of size maxNumLines*80,
      *           so don't make it too big.
      * Warning - converts \r\n to \n
+     * Warning - inefficient if startAtBeginning is false, see console LogsHelper for better version
      *
      * @param startAtBeginning if true, read the first maxNumLines, otherwise read
      *                         the last maxNumLines
diff --git a/router/java/src/net/i2p/router/crypto/ratchet/RatchetSKM.java b/router/java/src/net/i2p/router/crypto/ratchet/RatchetSKM.java
index 47462964039ec2497cd367e3fcb220007f2f65d8..aa0880b2cee28d4a7085ce5fbd32734b215a2e2b 100644
--- a/router/java/src/net/i2p/router/crypto/ratchet/RatchetSKM.java
+++ b/router/java/src/net/i2p/router/crypto/ratchet/RatchetSKM.java
@@ -323,7 +323,7 @@ public class RatchetSKM extends SessionKeyManager implements SessionTagListener
     /**
      * Side effect - binds this session to the supplied destination.
      *
-     * @param the far-end Destination for this PublicKey if known, or null
+     * @param d the far-end Destination for this PublicKey if known, or null
      * @return true if registered
      * @since 0.9.47
      */