Messaging: Fix javadoc

Change-Id: Ia1b0a8fa9a5e74078a68a55ca1953b6f085521b1

src/com/android/messaging/util/BugleActivityUtil.java

@@ -39,7 +39,6 @@ public class BugleActivityUtil {
     /**
      * Determine if the requirements for the app to run are met. Log any Activity startup
      * analytics.
-     * @param context
      * @param activity is used to launch an error Dialog if necessary
      * @return true if resume should continue normally. Returns false if some requirements to run
      * are not met.

src/com/android/messaging/util/ImageUtils.java

@@ -174,7 +174,6 @@ public class ImageUtils {
      * @param options a BitmapFactory.Options instance containing the bounds info of the bitmap
      * @param reqWidth the desired width of the bitmap. Can be ImageRequest.UNSPECIFIED_SIZE.
      * @param reqHeight the desired height of the bitmap.  Can be ImageRequest.UNSPECIFIED_SIZE.
-     * @return
      */
     public int calculateInSampleSize(
             final BitmapFactory.Options options, final int reqWidth, final int reqHeight) {

src/com/android/messaging/util/OsUtil.java

@@ -18,6 +18,7 @@
 package com.android.messaging.util;
 
 import android.Manifest;
+import android.app.Activity;
 import android.content.Context;
 import android.content.pm.PackageManager;
 import android.os.UserHandle;
@@ -55,9 +56,6 @@ public class OsUtil {
 
     /**
      * Creates a joined string from a Set<String> using the given delimiter.
-     * @param values
-     * @param delimiter
-     * @return
      */
     public static String joinFromSetWithDelimiter(
             final Set<String> values, final String delimiter) {

src/com/android/messaging/util/exif/ExifData.java

@@ -102,8 +102,6 @@ class ExifData {
 
     /**
      * Gets the strip at the specified index.
-     *
-     * @exceptions #IndexOutOfBoundException
      */
     protected byte[] getStrip(int index) {
         return mStripBytes.get(index);

src/com/android/messaging/util/exif/ExifInterface.java

@@ -720,7 +720,6 @@ public class ExifInterface {
      * object's existing exif tags.
      *
      * @param jpeg a byte array containing a jpeg compressed image.
-     * @throws java.io.IOException
      */
     public void readExif(byte[] jpeg) throws IOException {
         readExif(new ByteArrayInputStream(jpeg));
@@ -731,7 +730,6 @@ public class ExifInterface {
      * object's existing exif tags.
      *
      * @param inStream an InputStream containing a jpeg compressed image.
-     * @throws java.io.IOException
      */
     public void readExif(InputStream inStream) throws IOException {
         if (inStream == null) {
@@ -751,8 +749,6 @@ public class ExifInterface {
      * existing exif tags.
      *
      * @param inFileName a string representing the filepath to jpeg file.
-     * @throws java.io.FileNotFoundException
-     * @throws java.io.IOException
      */
     public void readExif(String inFileName) throws FileNotFoundException, IOException {
         if (inFileName == null) {
@@ -794,7 +790,6 @@ public class ExifInterface {
      * @param jpeg a byte array containing a jpeg compressed image.
      * @param exifOutStream an OutputStream to which the jpeg image with added
      *            exif tags will be written.
-     * @throws java.io.IOException
      */
     public void writeExif(byte[] jpeg, OutputStream exifOutStream) throws IOException {
         if (jpeg == null || exifOutStream == null) {
@@ -812,7 +807,6 @@ public class ExifInterface {
      * @param bmap a bitmap to compress and write exif into.
      * @param exifOutStream the OutputStream to which the jpeg image with added
      *            exif tags will be written.
-     * @throws java.io.IOException
      */
     public void writeExif(Bitmap bmap, OutputStream exifOutStream) throws IOException {
         if (bmap == null || exifOutStream == null) {
@@ -830,7 +824,6 @@ public class ExifInterface {
      * @param jpegStream an InputStream containing a jpeg compressed image.
      * @param exifOutStream an OutputStream to which the jpeg image with added
      *            exif tags will be written.
-     * @throws java.io.IOException
      */
     public void writeExif(InputStream jpegStream, OutputStream exifOutStream) throws IOException {
         if (jpegStream == null || exifOutStream == null) {
@@ -848,8 +841,6 @@ public class ExifInterface {
      * @param jpeg a byte array containing a jpeg compressed image.
      * @param exifOutFileName a String containing the filepath to which the jpeg
      *            image with added exif tags will be written.
-     * @throws java.io.FileNotFoundException
-     * @throws java.io.IOException
      */
     public void writeExif(byte[] jpeg, String exifOutFileName) throws FileNotFoundException,
             IOException {
@@ -875,8 +866,6 @@ public class ExifInterface {
      * @param bmap a bitmap to compress and write exif into.
      * @param exifOutFileName a String containing the filepath to which the jpeg
      *            image with added exif tags will be written.
-     * @throws java.io.FileNotFoundException
-     * @throws java.io.IOException
      */
     public void writeExif(Bitmap bmap, String exifOutFileName) throws FileNotFoundException,
             IOException {
@@ -902,8 +891,6 @@ public class ExifInterface {
      * @param jpegStream an InputStream containing a jpeg compressed image.
      * @param exifOutFileName a String containing the filepath to which the jpeg
      *            image with added exif tags will be written.
-     * @throws java.io.FileNotFoundException
-     * @throws java.io.IOException
      */
     public void writeExif(InputStream jpegStream, String exifOutFileName)
             throws FileNotFoundException, IOException {
@@ -929,8 +916,6 @@ public class ExifInterface {
      * @param jpegFileName a String containing the filepath for a jpeg file.
      * @param exifOutFileName a String containing the filepath to which the jpeg
      *            image with added exif tags will be written.
-     * @throws java.io.FileNotFoundException
-     * @throws java.io.IOException
      */
     public void writeExif(String jpegFileName, String exifOutFileName)
             throws FileNotFoundException, IOException {
@@ -978,7 +963,6 @@ public class ExifInterface {
      * @param exifOutFileName an String containing a filepath for a jpeg file.
      * @return an OutputStream that writes to the exifOutFileName file, and adds
      *         exif metadata. A jpeg image should be written to this stream.
-     * @throws java.io.FileNotFoundException
      */
     public OutputStream getExifWriterStream(String exifOutFileName) throws FileNotFoundException {
         if (exifOutFileName == null) {
@@ -1005,8 +989,6 @@ public class ExifInterface {
      *            tags if possible.
      * @return true if success, false if could not overwrite. If false, no
      *         changes are made to the file.
-     * @throws java.io.FileNotFoundException
-     * @throws java.io.IOException
      */
     public boolean rewriteExif(String filename, Collection<ExifTag> tags)
             throws FileNotFoundException, IOException {
@@ -1064,7 +1046,6 @@ public class ExifInterface {
      *            existing tags if possible.
      * @return true if success, false if could not overwrite. If false, no
      *         changes are made to the ByteBuffer.
-     * @throws java.io.IOException
      */
     public boolean rewriteExif(ByteBuffer buf, Collection<ExifTag> tags) throws IOException {
         ExifModifier mod = null;
@@ -1087,8 +1068,6 @@ public class ExifInterface {
      * @param filename a String containing a filepath for a jpeg file.
      * @param tags tags that will be written into the jpeg file over existing
      *            tags if possible.
-     * @throws java.io.FileNotFoundException
-     * @throws java.io.IOException
      * @see #rewriteExif
      */
     public void forceRewriteExif(String filename, Collection<ExifTag> tags)
@@ -1126,8 +1105,6 @@ public class ExifInterface {
      * This preserves tags that are not being rewritten.
      *
      * @param filename a String containing a filepath for a jpeg file.
-     * @throws java.io.FileNotFoundException
-     * @throws java.io.IOException
      * @see #rewriteExif
      */
     public void forceRewriteExif(String filename) throws FileNotFoundException, IOException {

src/com/android/messaging/util/exif/ExifParser.java

@@ -235,9 +235,6 @@ public class ExifParser {
 
     /**
      * Parses the the given InputStream with the given options
-     *
-     * @exception java.io.IOException
-     * @exception ExifInvalidFormatException
      */
     protected static ExifParser parse(InputStream inputStream, int options, ExifInterface iRef)
             throws IOException, ExifInvalidFormatException {
@@ -248,8 +245,6 @@ public class ExifParser {
      * Parses the the given InputStream with default options; that is, every IFD
      * and thumbnaill will be parsed.
      *
-     * @exception java.io.IOException
-     * @exception ExifInvalidFormatException
      * @see #parse(java.io.InputStream, int)
      */
     protected static ExifParser parse(InputStream inputStream, ExifInterface iRef)
@@ -262,8 +257,6 @@ public class ExifParser {
     /**
      * Moves the parser forward and returns the next parsing event
      *
-     * @exception java.io.IOException
-     * @exception ExifInvalidFormatException
      * @see #EVENT_START_OF_IFD
      * @see #EVENT_NEW_TAG
      * @see #EVENT_VALUE_OF_REGISTERED_TAG
@@ -359,9 +352,6 @@ public class ExifParser {
     /**
      * Skips the tags area of current IFD, if the parser is not in the tag area,
      * nothing will happen.
-     *
-     * @throws java.io.IOException
-     * @throws ExifInvalidFormatException
      */
     protected void skipRemainingTagsInCurrentIfd() throws IOException, ExifInvalidFormatException {
         int endOfTags = mIfdStartOffset + OFFSET_SIZE + TAG_SIZE * mNumOfTagInIfd;

src/com/android/messaging/util/exif/ExifReader.java

@@ -1,5 +1,6 @@
 /*
  * Copyright (C) 2012 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.
@@ -38,9 +39,6 @@ class ExifReader {
     /**
      * Parses the inputStream and and returns the EXIF data in an
      * {@link ExifData}.
-     *
-     * @throws ExifInvalidFormatException
-     * @throws java.io.IOException
      */
     protected ExifData read(InputStream inputStream) throws ExifInvalidFormatException,
             IOException {

src/com/android/messaging/util/exif/Rational.java

@@ -30,9 +30,6 @@ public class Rational {
 
     /**
      * Create a Rational with a given numerator and denominator.
-     *
-     * @param nominator
-     * @param denominator
      */
     public Rational(long nominator, long denominator) {
         mNumerator = nominator;