This is an automated email from the ASF dual-hosted git repository. ggregory pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/commons-fileupload.git
commit 507db9947f28505857f6778a3b92ec5fd75ce66a Author: Gary Gregory <[email protected]> AuthorDate: Mon Jun 5 17:11:52 2023 -0400 Drop @since Javadoc tags for 2.0 @since tags are not helpful since we are not binary and source compatible with 1.x --- .../main/java/org/apache/commons/fileupload2/AbstractFileUpload.java | 1 - .../java/org/apache/commons/fileupload2/AbstractRequestContext.java | 1 - .../src/main/java/org/apache/commons/fileupload2/FileItem.java | 2 -- .../src/main/java/org/apache/commons/fileupload2/FileItemHeaders.java | 2 -- .../java/org/apache/commons/fileupload2/FileItemHeadersSupport.java | 1 - .../src/main/java/org/apache/commons/fileupload2/FileUpload.java | 1 - .../src/main/java/org/apache/commons/fileupload2/MultipartStream.java | 1 - .../src/main/java/org/apache/commons/fileupload2/RequestContext.java | 3 --- .../main/java/org/apache/commons/fileupload2/disk/DiskFileItem.java | 2 -- .../java/org/apache/commons/fileupload2/disk/DiskFileItemFactory.java | 2 -- .../java/org/apache/commons/fileupload2/util/FileItemHeadersImpl.java | 2 -- .../java/org/apache/commons/fileupload2/util/mime/MimeUtility.java | 2 -- .../java/org/apache/commons/fileupload2/util/mime/ParseException.java | 1 - .../apache/commons/fileupload2/util/mime/QuotedPrintableDecoder.java | 1 - 14 files changed, 22 deletions(-) diff --git a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/AbstractFileUpload.java b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/AbstractFileUpload.java index a7d6ab4..65974e7 100644 --- a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/AbstractFileUpload.java +++ b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/AbstractFileUpload.java @@ -386,7 +386,6 @@ public abstract class AbstractFileUpload { * @param ctx The context for the request to be parsed. * @return A map of {@code FileItem} instances parsed from the request. * @throws FileUploadException if there are problems reading/parsing the request or storing files. - * @since 1.3 */ public Map<String, List<FileItem>> parseParameterMap(final RequestContext ctx) throws FileUploadException { final List<FileItem> items = parseRequest(ctx); diff --git a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/AbstractRequestContext.java b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/AbstractRequestContext.java index f8f9c9f..8cf9d67 100644 --- a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/AbstractRequestContext.java +++ b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/AbstractRequestContext.java @@ -54,7 +54,6 @@ public abstract class AbstractRequestContext<T> implements RequestContext { * Gets the content length of the request. * * @return The content length of the request. - * @since 1.3 */ @Override public long getContentLength() { diff --git a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileItem.java b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileItem.java index 0477cfc..ff3da7f 100644 --- a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileItem.java +++ b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileItem.java @@ -38,8 +38,6 @@ import java.io.UnsupportedEncodingException; * specifically defined with the same signatures as methods in that interface. This allows an implementation of this interface to also implement * {@code javax.activation.DataSource} with minimal additional work. * </p> - * - * @since 1.3 additionally implements FileItemHeadersSupport */ public interface FileItem extends FileItemHeadersSupport { diff --git a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileItemHeaders.java b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileItemHeaders.java index ab258da..06af484 100644 --- a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileItemHeaders.java +++ b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileItemHeaders.java @@ -20,8 +20,6 @@ import java.util.Iterator; /** * This class provides support for accessing the headers for a file or form item that was received within a {@code multipart/form-data} POST request. - * - * @since 1.2.1 */ public interface FileItemHeaders { diff --git a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileItemHeadersSupport.java b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileItemHeadersSupport.java index 54b14f5..4928efc 100644 --- a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileItemHeadersSupport.java +++ b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileItemHeadersSupport.java @@ -21,7 +21,6 @@ package org.apache.commons.fileupload2; * * @see FileItem * @see FileItemStream - * @since 1.2.1 */ public interface FileItemHeadersSupport { diff --git a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileUpload.java b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileUpload.java index 32753cc..ed8e9ef 100644 --- a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileUpload.java +++ b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/FileUpload.java @@ -86,7 +86,6 @@ public abstract class FileUpload<T> extends AbstractFileUpload { * @param request The servlet request to be parsed. * @return A map of {@code FileItem} instances parsed from the request. * @throws FileUploadException if there are problems reading/parsing the request or storing files. - * @since 1.3 */ public abstract Map<String, List<FileItem>> parseParameterMap(T request) throws FileUploadException; diff --git a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/MultipartStream.java b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/MultipartStream.java index 2f0360e..5a3a37b 100644 --- a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/MultipartStream.java +++ b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/MultipartStream.java @@ -569,7 +569,6 @@ public class MultipartStream { * @param bufferSize The size of the buffer to be used, in bytes. * @param notifier The notifier, which is used for calling the progress listener, if any. * @throws IllegalArgumentException If the buffer size is too small. - * @since 1.3.1 */ public MultipartStream(final InputStream input, final byte[] boundary, final int bufferSize, final ProgressNotifier notifier) { if (boundary == null) { diff --git a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/RequestContext.java b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/RequestContext.java index 66c44bb..b463497 100644 --- a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/RequestContext.java +++ b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/RequestContext.java @@ -24,8 +24,6 @@ import java.io.InputStream; * <p> * This interface should be implemented for each type of request that may be handled by FileUpload, such as servlets and portlets. * </p> - * - * @since 1.1 */ public interface RequestContext { @@ -40,7 +38,6 @@ public interface RequestContext { * Gets the content length of the request. * * @return The content length of the request. - * @since 1.3 */ long getContentLength(); diff --git a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/disk/DiskFileItem.java b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/disk/DiskFileItem.java index b4fe13d..8a21c53 100644 --- a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/disk/DiskFileItem.java +++ b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/disk/DiskFileItem.java @@ -56,8 +56,6 @@ import org.apache.commons.io.output.DeferredFileOutputStream; * {@link org.apache.commons.io.FileCleaningTracker} when there are files to be tracked. It might make sense to terminate that thread, for example, if your web * application ends. See the section on "Resource cleanup" in the users guide of Commons FileUpload. * </p> - * - * @since 1.1 */ public class DiskFileItem implements FileItem { diff --git a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/disk/DiskFileItemFactory.java b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/disk/DiskFileItemFactory.java index 7bdc817..399c19a 100644 --- a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/disk/DiskFileItemFactory.java +++ b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/disk/DiskFileItemFactory.java @@ -50,8 +50,6 @@ import org.apache.commons.io.FileCleaningTracker; * the so-called reaper thread, which is started and stopped automatically by the {@link FileCleaningTracker} when there are files to be tracked. It might make * sense to terminate that thread, for example, if your web application ends. See the section on "Resource cleanup" in the users guide of commons-fileupload. * </p> - * - * @since 1.1 */ public class DiskFileItemFactory implements FileItemFactory { diff --git a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/FileItemHeadersImpl.java b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/FileItemHeadersImpl.java index 1cc98ca..d3c0c8f 100644 --- a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/FileItemHeadersImpl.java +++ b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/FileItemHeadersImpl.java @@ -28,8 +28,6 @@ import org.apache.commons.fileupload2.FileItemHeaders; /** * Default implementation of the {@link FileItemHeaders} interface. - * - * @since 1.2.1 */ public class FileItemHeadersImpl implements FileItemHeaders { diff --git a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/mime/MimeUtility.java b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/mime/MimeUtility.java index 79b83bb..18fd9d8 100644 --- a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/mime/MimeUtility.java +++ b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/mime/MimeUtility.java @@ -27,8 +27,6 @@ import java.util.Map; /** * Utility class to decode MIME texts. - * - * @since 1.3 */ public final class MimeUtility { diff --git a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/mime/ParseException.java b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/mime/ParseException.java index ee82700..6ea1efc 100644 --- a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/mime/ParseException.java +++ b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/mime/ParseException.java @@ -17,7 +17,6 @@ package org.apache.commons.fileupload2.util.mime; /** - * @since 1.3 */ final class ParseException extends Exception { diff --git a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/mime/QuotedPrintableDecoder.java b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/mime/QuotedPrintableDecoder.java index 09d227e..9ca256f 100644 --- a/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/mime/QuotedPrintableDecoder.java +++ b/commons-fileupload2-core/src/main/java/org/apache/commons/fileupload2/util/mime/QuotedPrintableDecoder.java @@ -20,7 +20,6 @@ import java.io.IOException; import java.io.OutputStream; /** - * @since 1.3 */ final class QuotedPrintableDecoder {
