Author: sebb
Date: Thu Mar 3 14:50:30 2011
New Revision: 1076643
URL: http://svn.apache.org/viewvc?rev=1076643&view=rev
Log:
Add @since markers
Modified:
commons/proper/net/trunk/src/main/java/org/apache/commons/net/ftp/FTP.java
commons/proper/net/trunk/src/main/java/org/apache/commons/net/ftp/FTPClient.java
commons/proper/net/trunk/src/main/java/org/apache/commons/net/ftp/parser/DefaultFTPFileEntryParserFactory.java
commons/proper/net/trunk/src/main/java/org/apache/commons/net/pop3/POP3Reply.java
Modified:
commons/proper/net/trunk/src/main/java/org/apache/commons/net/ftp/FTP.java
URL:
http://svn.apache.org/viewvc/commons/proper/net/trunk/src/main/java/org/apache/commons/net/ftp/FTP.java?rev=1076643&r1=1076642&r2=1076643&view=diff
==============================================================================
--- commons/proper/net/trunk/src/main/java/org/apache/commons/net/ftp/FTP.java
(original)
+++ commons/proper/net/trunk/src/main/java/org/apache/commons/net/ftp/FTP.java
Thu Mar 3 14:50:30 2011
@@ -294,6 +294,7 @@ public class FTP extends SocketClient
/**
* Get the reply, but don't pass it to command listeners.
* Used for keep-alive processing only.
+ * @since 3.0
*/
protected void __getReplyNoReport() throws IOException
{
@@ -519,6 +520,13 @@ public class FTP extends SocketClient
}
}
+ /**
+ * Send a noop and get the reply without reporting to the command listener.
+ * Intended for use with keep-alive.
+ *
+ * @throws IOException
+ * @since 3.0
+ */
protected void __noop() throws IOException {
String msg = __buildMessage(FTPCommand.getCommand(FTPCommand.NOOP),
null);
__send(msg);
Modified:
commons/proper/net/trunk/src/main/java/org/apache/commons/net/ftp/FTPClient.java
URL:
http://svn.apache.org/viewvc/commons/proper/net/trunk/src/main/java/org/apache/commons/net/ftp/FTPClient.java?rev=1076643&r1=1076642&r2=1076643&view=diff
==============================================================================
---
commons/proper/net/trunk/src/main/java/org/apache/commons/net/ftp/FTPClient.java
(original)
+++
commons/proper/net/trunk/src/main/java/org/apache/commons/net/ftp/FTPClient.java
Thu Mar 3 14:50:30 2011
@@ -266,7 +266,8 @@ public class FTPClient extends FTP
implements Configurable
{
/**
- * The system property ({@value}) which can be used to override the system
type.
+ * The system property ({@value}) which can be used to override the system
type.
+ * @since 3.0
*/
public static final String FTP_SYSTEM_TYPE =
"org.apache.commons.net.ftp.systemType";
@@ -2419,6 +2420,7 @@ implements Configurable
* @see org.apache.commons.net.ftp.parser.DefaultFTPFileEntryParserFactory
* @see org.apache.commons.net.ftp.parser.FTPFileEntryParserFactory
* @see org.apache.commons.net.ftp.FTPFileEntryParser
+ * @since 3.0
*/
public FTPFile[] listDirectories() throws IOException {
return listDirectories((String) null);
@@ -2459,6 +2461,7 @@ implements Configurable
* @see org.apache.commons.net.ftp.parser.DefaultFTPFileEntryParserFactory
* @see org.apache.commons.net.ftp.parser.FTPFileEntryParserFactory
* @see org.apache.commons.net.ftp.FTPFileEntryParser
+ * @since 3.0
*/
public FTPFile[] listDirectories(String parent) throws IOException {
return listFiles(parent, FTPFileFilters.DIRECTORIES);
@@ -2888,6 +2891,7 @@ implements Configurable
* The default value (if not set) is {@code null}.
*
* @param listener to be used, may be {@code null} to disable
+ * @since 3.0
*/
public void setCopyStreamListener(CopyStreamListener listener){
__copyStreamListener = listener;
@@ -2897,6 +2901,7 @@ implements Configurable
* Obtain the currently active listener.
*
* @return the listener, may be {@code null}
+ * @since 3.0
*/
public CopyStreamListener getCopyStreamListener(){
return __copyStreamListener;
Modified:
commons/proper/net/trunk/src/main/java/org/apache/commons/net/ftp/parser/DefaultFTPFileEntryParserFactory.java
URL:
http://svn.apache.org/viewvc/commons/proper/net/trunk/src/main/java/org/apache/commons/net/ftp/parser/DefaultFTPFileEntryParserFactory.java?rev=1076643&r1=1076642&r2=1076643&view=diff
==============================================================================
---
commons/proper/net/trunk/src/main/java/org/apache/commons/net/ftp/parser/DefaultFTPFileEntryParserFactory.java
(original)
+++
commons/proper/net/trunk/src/main/java/org/apache/commons/net/ftp/parser/DefaultFTPFileEntryParserFactory.java
Thu Mar 3 14:50:30 2011
@@ -240,6 +240,9 @@ public class DefaultFTPFileEntryParserFa
return createOS400FTPEntryParser(null);
}
+ /**
+ * @since 3.0
+ */
public FTPFileEntryParser createOS400FTPEntryParser(FTPClientConfig config)
{
if (config != null &&
Modified:
commons/proper/net/trunk/src/main/java/org/apache/commons/net/pop3/POP3Reply.java
URL:
http://svn.apache.org/viewvc/commons/proper/net/trunk/src/main/java/org/apache/commons/net/pop3/POP3Reply.java?rev=1076643&r1=1076642&r2=1076643&view=diff
==============================================================================
---
commons/proper/net/trunk/src/main/java/org/apache/commons/net/pop3/POP3Reply.java
(original)
+++
commons/proper/net/trunk/src/main/java/org/apache/commons/net/pop3/POP3Reply.java
Thu Mar 3 14:50:30 2011
@@ -32,7 +32,10 @@ public final class POP3Reply
/*** The reply code indicating failure of an operation. ***/
public static final int ERROR = 1;
- /** The reply code indicating intermediate response to a command. */
+ /**
+ * The reply code indicating intermediate response to a command.
+ * @since 3.0
+ */
public static final int OK_INT = 2;
// Cannot be instantiated.