Messaging: Fix javadoc

Change-Id: Ia1b0a8fa9a5e74078a68a55ca1953b6f085521b1

src/com/android/messaging/mmslib/Downloads.java

@@ -1,5 +1,6 @@
 /*
  * Copyright (C) 2008 The Android Open Source Project
+ * Copyright (C) 2024 The LineageOS Project
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -21,8 +22,6 @@ import android.provider.BaseColumns;
 
 /**
  * The Download Manager
- *
- * @pending
  */
 public final class Downloads {
     private Downloads() {}

src/com/android/messaging/mmslib/pdu/EncodedStringValue.java

@@ -80,7 +80,6 @@ public class EncodedStringValue implements Cloneable {
     /**
      * Constructor
      *
-     * @param charset
      * @param data The text in Java String
      * @throws NullPointerException if Text-string value is null.
      */

src/com/android/messaging/mmslib/pdu/PduHeaders.java

@@ -527,8 +527,6 @@ public class PduHeaders {
      *
      * @param value the value
      * @param field the field
-     * @return the TextString value of the pdu header
-     * with specified header field
      * @throws NullPointerException if the value is null.
      */
     protected void setTextString(byte[] value, int field) {
@@ -593,8 +591,6 @@ public class PduHeaders {
      *
      * @param value the value
      * @param field the field
-     * @return the EncodedStringValue value of the pdu header
-     * with specified header field
      * @throws NullPointerException if the value is null.
      */
     protected void setEncodedStringValue(EncodedStringValue value, int field) {
@@ -630,8 +626,6 @@ public class PduHeaders {
      *
      * @param value the value
      * @param field the field
-     * @return the EncodedStringValue value array of the pdu header
-     * with specified header field
      * @throws NullPointerException if the value is null.
      */
     protected void setEncodedStringValues(EncodedStringValue[] value, int field) {

src/com/android/messaging/mmslib/pdu/PduParser.java

@@ -329,7 +329,7 @@ public class PduParser {
                 case PduHeaders.CONTENT_CLASS:
                 case PduHeaders.RETRIEVE_STATUS:
                 case PduHeaders.STORE_STATUS:
-                    /**
+                    /*
                      * The following field has a different value when
                      * used in the M-Mbox-Delete.conf and M-Delete.conf PDU.
                      * For now we ignore this fact, since we do not support these PDUs
@@ -399,7 +399,7 @@ public class PduParser {
                 case PduHeaders.AUX_APPLIC_ID:
                 case PduHeaders.APPLIC_ID:
                 case PduHeaders.REPLY_APPLIC_ID:
-                    /**
+                    /*
                      * The next three header fields are email addresses
                      * as defined in RFC2822,
                      * not including the characters "<" and ">"
@@ -407,7 +407,7 @@ public class PduParser {
                 case PduHeaders.MESSAGE_ID:
                 case PduHeaders.REPLACE_ID:
                 case PduHeaders.CANCEL_ID:
-                    /**
+                    /*
                      * The following field has a different value when
                      * used in the M-Mbox-Delete.conf and M-Delete.conf PDU.
                      * For now we ignore this fact, since we do not support these PDUs

src/com/android/messaging/mmslib/util/DrmConvertSession.java

@@ -78,7 +78,7 @@ public class DrmConvertSession {
     /**
      * Convert a buffer of data to protected format.
      *
-     * @param buffer Buffer filled with data to convert.
+     * @param inBuffer Buffer filled with data to convert.
      * @param size   The number of bytes that shall be converted.
      * @return A Buffer filled with converted data, if execution is ok, in all
      * other case null.
@@ -117,7 +117,7 @@ public class DrmConvertSession {
     /**
      * Ends a conversion session of a file.
      *
-     * @param fileName The filename of the converted file.
+     * @param filename The filename of the converted file.
      * @return Downloads.Impl.STATUS_SUCCESS if execution is ok.
      *         Downloads.Impl.STATUS_FILE_ERROR in case converted file can not
      *         be accessed. Downloads.Impl.STATUS_NOT_ACCEPTABLE if a problem