adding @since tags for new apis

rse/plugins/org.eclipse.rse.files.ui/src/org/eclipse/rse/files/ui/resources/UniversalFileTransferUtility.java

@@ -1594,6 +1594,7 @@ public class UniversalFileTransferUtility
 	 * @param monitor the progress monitor
 	 * @param checkForCollisions indicates whether to check for colllisions or not
 	 * @return the result remote object
+	 * @since 3.0
 	 */
 	public static Object uploadResourceFromWorkspace(IResource srcFileOrFolder, IRemoteFile targetFolder, IProgressMonitor monitor, boolean checkForCollisions)
 	{
@@ -1992,6 +1993,9 @@ public class UniversalFileTransferUtility
 		return archiveType;
 	}
 
+	/**
+	 * @since 3.0
+	 */
 	public static IResource compressedDownloadToWorkspace(IRemoteFile directory, IProgressMonitor monitor) throws Exception
 	{
 		if (!directory.getParentRemoteFileSubSystem().getParentRemoteFileSubSystemConfiguration().supportsArchiveManagement()) return null;
@@ -2417,6 +2421,9 @@ public class UniversalFileTransferUtility
 	}
 
 
+	/**
+	 * @since 3.0
+	 */
 	public static String getActualHostFor(IRemoteFileSubSystem subsystem, String remotePath)
 	{
 		String hostname = subsystem.getHost().getHostName();
@@ -2428,6 +2435,9 @@ public class UniversalFileTransferUtility
 		return hostname;
 	}
 
+	/**
+	 * @since 3.0
+	 */
 	public static String getActualHostFor(String hostname, String remotePath, IRemoteFileSubSystem subsystem)
 	{
 		return SystemRemoteEditManager.getInstance().getActualHostFor(hostname, remotePath, subsystem);
@@ -2465,6 +2475,9 @@ public class UniversalFileTransferUtility
 		return false;
 	}
 
+	/**
+	 * @since 3.0
+	 */
 	protected static boolean isRemoteFileMounted(String hostname, String remotePath, IRemoteFileSubSystem subsystem)
 	{
 		String result = SystemRemoteEditManager.getInstance().getActualHostFor(hostname, remotePath, subsystem);
@@ -2550,6 +2563,9 @@ public class UniversalFileTransferUtility
 			return false;
 	}
 
+	/**
+	 * @since 3.0
+	 */
 	public static class RenameRunnable implements Runnable
 	{
 		private IRemoteFile _targetFileOrFolder;
@@ -2557,8 +2573,17 @@ public class UniversalFileTransferUtility
 		private List _namesInUse = new ArrayList();
 		private int cancelStatus;
 
+		/**
+		 * @since 3.0
+		 */
 		public static int RENAME_DIALOG_NOT_CANCELED = -1;
+		/**
+		 * @since 3.0
+		 */
 		public static int RENAME_DIALOG_CANCELED = 0;
+		/**
+		 * @since 3.0
+		 */
 		public static int RENAME_DIALOG_CANCELED_ALL = 1;
 
 		public RenameRunnable(IRemoteFile targetFileOrFolder)
@@ -2695,6 +2720,7 @@ public class UniversalFileTransferUtility
 	 * @return the set of temp files created as a result of the download.
 	 * 
 	 * @deprecated use downloadResourcesToWorkspaceMultiple
+	 * @since 3.0
 	 */
 	public static SystemWorkspaceResourceSet copyRemoteResourcesToWorkspaceMultiple(SystemRemoteResourceSet remoteSet, IProgressMonitor monitor)
 	{

rse/plugins/org.eclipse.rse.subsystems.files.core/src/org/eclipse/rse/subsystems/files/core/subsystems/IRemoteFileSubSystem.java

@@ -135,6 +135,7 @@ public interface IRemoteFileSubSystem extends ISubSystem {
 	 *              should be exactly one fileType specified per parent.
 	 * 				For the default list of available file types see <code>IFileServiceContants</code>
 	 * @param monitor the progress monitor
+	 * @since 3.0
 	 */
 	public IRemoteFile[] listMultiple(IRemoteFile[] parents, String[] fileNameFilters, int[] fileTypes,  IProgressMonitor monitor) throws SystemMessageException;
 
@@ -145,6 +146,7 @@ public interface IRemoteFileSubSystem extends ISubSystem {
 	 * @param fileType - indicates whether to query files, folders, both or some other type. This fileType is used for each parent query.
 	 * 				For the default list of available file types see <code>IFileServiceContants</code>
 	 * @param monitor the progress monitor
+	 * @since 3.0
 	 */
 	public IRemoteFile[] listMultiple(IRemoteFile[] parents, int fileType, IProgressMonitor monitor) throws SystemMessageException;		
 	
@@ -160,6 +162,7 @@ public interface IRemoteFileSubSystem extends ISubSystem {
 	 *      {@link IFileService#FILE_TYPE_FOLDERS}, and 
 	 *      {@link IFileService#FILE_TYPE_FILES_AND_FOLDERS}.
 	 * @param monitor the progress monitor
+	 * @since 3.0
 	 */
 	public IRemoteFile[] listMultiple(IRemoteFile[] parents, String[] fileNameFilters, int fileType,  IProgressMonitor monitor) throws SystemMessageException;
 
@@ -169,6 +172,7 @@ public interface IRemoteFileSubSystem extends ISubSystem {
 	 * 
 	 * @param parent The parent folder to list folders and/or files in
 	 * @param monitor the progress monitor
+	 * @since 3.0
 	 */
 	public IRemoteFile[] list(IRemoteFile parent, IProgressMonitor monitor) throws SystemMessageException;
 	
@@ -181,6 +185,7 @@ public interface IRemoteFileSubSystem extends ISubSystem {
 	 *      {@link IFileService#FILE_TYPE_FOLDERS}, and 
 	 *      {@link IFileService#FILE_TYPE_FILES_AND_FOLDERS}.
 	 * @param monitor the progress monitor
+	 * @since 3.0
 	 */
 	public IRemoteFile[] list(IRemoteFile parent, int fileType, IProgressMonitor monitor) throws SystemMessageException;		
 	
@@ -193,6 +198,7 @@ public interface IRemoteFileSubSystem extends ISubSystem {
 	 * @param fileType - indicates whether to query files, folders, both or some other type.
 	 * 					For the default list of available file types see <code>IFileServiceContants</code>
 	 * @param monitor the progress monitor
+	 * @since 3.0
 	 */
 	public IRemoteFile[] list(IRemoteFile parent, String fileNameFilter, int fileType,  IProgressMonitor monitor) throws SystemMessageException;
 
@@ -207,6 +213,7 @@ public interface IRemoteFileSubSystem extends ISubSystem {
 	 * @param fileType - indicates whether to query files, folders, both or some other type
 	 * 				For the default list of available file types see <code>IFileServiceContants</code>
 	 * @param monitor the progress monitor
+	 * @since 3.0
 
 	 */
 	public IRemoteFile[] list(IRemoteFile parent, String fileNameFilter, IRemoteFileContext context, int fileType, IProgressMonitor monitor) throws SystemMessageException;
@@ -268,6 +275,7 @@ public interface IRemoteFileSubSystem extends ISubSystem {
 	 * @param monitor the progress monitor
 	 * 
 	 * @return the set of resources
+	 * @since 3.0
 	 */
 	public IRemoteFile[] getRemoteFileObjects(String[] folderOrFileNames, IProgressMonitor monitor) throws SystemMessageException;
 	
@@ -516,6 +524,7 @@ public interface IRemoteFileSubSystem extends ISubSystem {
 	 * @throws SystemMessageException if an error occurs. 
 	 *     Typically this would be one of those in the 
 	 *     {@link RemoteFileException} family.
+	 * @since 3.0
 	 */
 	public void downloadMultiple(IRemoteFile[] sources, String[] destinations, String[] encodings, IProgressMonitor monitor) throws SystemMessageException;
 	
@@ -582,6 +591,7 @@ public interface IRemoteFileSubSystem extends ISubSystem {
 	 * @throws SystemMessageException if an error occurs. 
 	 *     Typically this would be one of those in the 
 	 *     {@link RemoteFileException} family.
+	 * @since 3.0
 	 */
 	public void uploadMultiple(String[] sources, IRemoteFile[] destinations, String[] encodings, IProgressMonitor monitor) throws SystemMessageException;
 
@@ -603,6 +613,7 @@ public interface IRemoteFileSubSystem extends ISubSystem {
 	 * @throws SystemMessageException if an error occurs. 
 	 *     Typically this would be one of those in the
 	 *     {@link RemoteFileException} family.
+	 * @since 3.0
 	 */
 	public void uploadMultiple(String sources[], String[] srcEncodings, String[] remotePaths, String[] rmtEncodings,  IProgressMonitor monitor) throws SystemMessageException;
 	
@@ -683,6 +694,7 @@ public interface IRemoteFileSubSystem extends ISubSystem {
 	 * display or enable themselves based on result of this call.
 	 * 
 	 * @return whether this service supports encoding conversion
+	 * @since 3.0
 	 */
 	public boolean supportsEncodingConversion();
 }