(commons-net) branch master updated: Javadoc @since tag should be after @throws

[ggregory]

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-net.git


The following commit(s) were added to refs/heads/master by this push:
     new 5e4c0235 Javadoc @since tag should be after @throws
5e4c0235 is described below

commit 5e4c0235d8191eac47bef666dc587bccdc8c62b5
Author: Gary D. Gregory <garydgreg...@gmail.com>
AuthorDate: Sat Mar 22 09:13:42 2025 -0400

    Javadoc @since tag should be after @throws
---
 src/main/java/org/apache/commons/net/ftp/FTP.java                     | 2 +-
 src/main/java/org/apache/commons/net/ftp/FTPListParseEngine.java      | 2 +-
 .../apache/commons/net/ftp/parser/RegexFTPFileEntryParserImpl.java    | 4 ++--
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/main/java/org/apache/commons/net/ftp/FTP.java 
b/src/main/java/org/apache/commons/net/ftp/FTP.java
index 077d9751..02cdcade 100644
--- a/src/main/java/org/apache/commons/net/ftp/FTP.java
+++ b/src/main/java/org/apache/commons/net/ftp/FTP.java
@@ -261,8 +261,8 @@ public class FTP extends SocketClient {
     /**
      * Gets the reply, but don't pass it to command listeners. Used for 
keep-alive processing only.
      *
-     * @since 3.0
      * @throws IOException on error
+     * @since 3.0
      */
     protected void __getReplyNoReport() throws IOException {
         getReply(false);
diff --git a/src/main/java/org/apache/commons/net/ftp/FTPListParseEngine.java 
b/src/main/java/org/apache/commons/net/ftp/FTPListParseEngine.java
index d53e11a3..e7dac398 100644
--- a/src/main/java/org/apache/commons/net/ftp/FTPListParseEngine.java
+++ b/src/main/java/org/apache/commons/net/ftp/FTPListParseEngine.java
@@ -142,8 +142,8 @@ public class FTPListParseEngine {
      *         <p>
      *         <strong> NOTE:</strong> This array may contain null members if 
any of the individual file listings failed to parse. The caller should check 
each
      *         entry for null before referencing it, or use a filter such as 
{@link FTPFileFilters#NON_NULL} which does not allow null entries.
-     * @since 2.2
      * @throws IOException - not ever thrown, may be removed in a later release
+     * @since 2.2
      */
     // TODO remove; not actually thrown
     public FTPFile[] getFiles(final FTPFileFilter filter) throws IOException {
diff --git 
a/src/main/java/org/apache/commons/net/ftp/parser/RegexFTPFileEntryParserImpl.java
 
b/src/main/java/org/apache/commons/net/ftp/parser/RegexFTPFileEntryParserImpl.java
index 964daec7..74440603 100644
--- 
a/src/main/java/org/apache/commons/net/ftp/parser/RegexFTPFileEntryParserImpl.java
+++ 
b/src/main/java/org/apache/commons/net/ftp/parser/RegexFTPFileEntryParserImpl.java
@@ -153,8 +153,8 @@ public abstract class RegexFTPFileEntryParserImpl extends 
FTPFileEntryParserImpl
      *
      * @param regex The new regular expression
      * @return true
-     * @since 2.0
      * @throws IllegalArgumentException if the regex cannot be compiled
+     * @since 2.0
      */
     public boolean setRegex(final String regex) {
         compileRegex(regex, 0);
@@ -167,8 +167,8 @@ public abstract class RegexFTPFileEntryParserImpl extends 
FTPFileEntryParserImpl
      * @param regex The new regular expression
      * @param flags the flags to apply, see {@link Pattern#compile(String, 
int)}. Use 0 for none.
      * @return true
-     * @since 3.4
      * @throws IllegalArgumentException if the regex cannot be compiled
+     * @since 3.4
      */
     public boolean setRegex(final String regex, final int flags) {
         compileRegex(regex, flags);