diff --git a/jetty-http/src/main/java/org/eclipse/jetty/http/MultiPartFormInputStream.java b/jetty-http/src/main/java/org/eclipse/jetty/http/MultiPartFormInputStream.java
index 35d4f2a9f6c..4c71a941c86 100644
--- a/jetty-http/src/main/java/org/eclipse/jetty/http/MultiPartFormInputStream.java
+++ b/jetty-http/src/main/java/org/eclipse/jetty/http/MultiPartFormInputStream.java
@@ -55,7 +55,7 @@ import org.eclipse.jetty.util.log.Logger;
  *
  * Handle a MultiPart Mime input stream, breaking it up on the boundary into files and strings.
  * 
- * @see https://tools.ietf.org/html/rfc7578
+ * @see <a href="https://tools.ietf.org/html/rfc7578">https://tools.ietf.org/html/rfc7578</a>
  */
 public class MultiPartFormInputStream
 {
diff --git a/jetty-http/src/main/java/org/eclipse/jetty/http/MultiPartParser.java b/jetty-http/src/main/java/org/eclipse/jetty/http/MultiPartParser.java
index 63aec8605e9..5554e64094a 100644
--- a/jetty-http/src/main/java/org/eclipse/jetty/http/MultiPartParser.java
+++ b/jetty-http/src/main/java/org/eclipse/jetty/http/MultiPartParser.java
@@ -33,9 +33,8 @@ import org.eclipse.jetty.util.log.Logger;
 /* ------------------------------------------------------------ */
 /** A parser for MultiPart content type.
  * 
- * @see https://tools.ietf.org/html/rfc2046#section-5.1
- * @see https://tools.ietf.org/html/rfc2045
- * 
+ * @see <a href="https://tools.ietf.org/html/rfc2046#section-5.1">https://tools.ietf.org/html/rfc2046#section-5.1</a>
+ * @see <a href="https://tools.ietf.org/html/rfc2045">https://tools.ietf.org/html/rfc2045</a>
  */
 public class MultiPartParser
 {
@@ -255,8 +254,8 @@ public class MultiPartParser
     /**
      * Parse until next Event.
      * 
-     * @param buffer
-     *            the buffer to parse
+     * @param buffer the buffer to parse
+     * @param last whether this buffer contains last bit of content
      * @return True if an {@link RequestHandler} method was called and it returned true;
      */
     public boolean parse(ByteBuffer buffer, boolean last)
diff --git a/jetty-util/src/main/java/org/eclipse/jetty/util/MultiPartInputStreamParser.java b/jetty-util/src/main/java/org/eclipse/jetty/util/MultiPartInputStreamParser.java
index 131a5587c78..1280e6f29d5 100644
--- a/jetty-util/src/main/java/org/eclipse/jetty/util/MultiPartInputStreamParser.java
+++ b/jetty-util/src/main/java/org/eclipse/jetty/util/MultiPartInputStreamParser.java
@@ -58,7 +58,7 @@ import org.eclipse.jetty.util.log.Logger;
  * 
  * Non Compliance warnings are documented by the method {@link #getNonComplianceWarnings()}
  *
- * @deprecated Replaced by {@link org.eclipse.jetty.http#MultiPartFormInputStream}
+ * @deprecated Replaced by org.eclipse.jetty.http.MultiPartFormInputStream
  * The code for MultiPartInputStream is slower than its replacement MultiPartFormInputStream. However
  * this class accepts formats non compliant the RFC that the new MultiPartFormInputStream does not accept. 
  *