1
0
Fork 0
mirror of https://github.com/eclipse-cdt/cdt synced 2025-07-15 13:05:22 +02:00

[cleanup] Improve Javadoc of RemoteCommandShellOperation

This commit is contained in:
Martin Oberhuber 2008-12-04 16:40:29 +00:00
parent 448c966004
commit 6acf667c72
2 changed files with 67 additions and 67 deletions

View file

@ -53,7 +53,7 @@ plugin@org.eclipse.rse.subsystems.processes.core=v20080529,:pserver:anonymous:no
plugin@org.eclipse.rse.subsystems.processes.dstore=v20080604,:pserver:anonymous:none@dev.eclipse.org:/cvsroot/dsdp,,org.eclipse.tm.rse/plugins/org.eclipse.rse.subsystems.processes.dstore plugin@org.eclipse.rse.subsystems.processes.dstore=v20080604,:pserver:anonymous:none@dev.eclipse.org:/cvsroot/dsdp,,org.eclipse.tm.rse/plugins/org.eclipse.rse.subsystems.processes.dstore
plugin@org.eclipse.rse.subsystems.processes.local=v20080604,:pserver:anonymous:none@dev.eclipse.org:/cvsroot/dsdp,,org.eclipse.tm.rse/plugins/org.eclipse.rse.subsystems.processes.local plugin@org.eclipse.rse.subsystems.processes.local=v20080604,:pserver:anonymous:none@dev.eclipse.org:/cvsroot/dsdp,,org.eclipse.tm.rse/plugins/org.eclipse.rse.subsystems.processes.local
plugin@org.eclipse.rse.subsystems.processes.shell.linux=v20080714,:pserver:anonymous:none@dev.eclipse.org:/cvsroot/dsdp,,org.eclipse.tm.rse/plugins/org.eclipse.rse.subsystems.processes.shell.linux plugin@org.eclipse.rse.subsystems.processes.shell.linux=v20080714,:pserver:anonymous:none@dev.eclipse.org:/cvsroot/dsdp,,org.eclipse.tm.rse/plugins/org.eclipse.rse.subsystems.processes.shell.linux
plugin@org.eclipse.rse.subsystems.shells.core=v200811251700,:pserver:anonymous:none@dev.eclipse.org:/cvsroot/dsdp,,org.eclipse.tm.rse/plugins/org.eclipse.rse.subsystems.shells.core plugin@org.eclipse.rse.subsystems.shells.core=v200812041630,:pserver:anonymous:none@dev.eclipse.org:/cvsroot/dsdp,,org.eclipse.tm.rse/plugins/org.eclipse.rse.subsystems.shells.core
plugin@org.eclipse.rse.subsystems.shells.dstore=v20080604,:pserver:anonymous:none@dev.eclipse.org:/cvsroot/dsdp,,org.eclipse.tm.rse/plugins/org.eclipse.rse.subsystems.shells.dstore plugin@org.eclipse.rse.subsystems.shells.dstore=v20080604,:pserver:anonymous:none@dev.eclipse.org:/cvsroot/dsdp,,org.eclipse.tm.rse/plugins/org.eclipse.rse.subsystems.shells.dstore
plugin@org.eclipse.rse.subsystems.shells.local=v20080604,:pserver:anonymous:none@dev.eclipse.org:/cvsroot/dsdp,,org.eclipse.tm.rse/plugins/org.eclipse.rse.subsystems.shells.local plugin@org.eclipse.rse.subsystems.shells.local=v20080604,:pserver:anonymous:none@dev.eclipse.org:/cvsroot/dsdp,,org.eclipse.tm.rse/plugins/org.eclipse.rse.subsystems.shells.local
plugin@org.eclipse.rse.subsystems.shells.ssh=v20080604,:pserver:anonymous:none@dev.eclipse.org:/cvsroot/dsdp,,org.eclipse.tm.rse/plugins/org.eclipse.rse.subsystems.shells.ssh plugin@org.eclipse.rse.subsystems.shells.ssh=v20080604,:pserver:anonymous:none@dev.eclipse.org:/cvsroot/dsdp,,org.eclipse.tm.rse/plugins/org.eclipse.rse.subsystems.shells.ssh

View file

@ -1,5 +1,5 @@
/******************************************************************************** /********************************************************************************
* Copyright (c) 2006, 2007 IBM Corporation and others. All rights reserved. * Copyright (c) 2006, 2008 IBM Corporation and others. All rights reserved.
* This program and the accompanying materials are made available under the terms * This program and the accompanying materials are made available under the terms
* of the Eclipse Public License v1.0 which accompanies this distribution, and is * of the Eclipse Public License v1.0 which accompanies this distribution, and is
* available at http://www.eclipse.org/legal/epl-v10.html * available at http://www.eclipse.org/legal/epl-v10.html
@ -35,14 +35,12 @@ import org.eclipse.rse.ui.SystemBasePlugin;
import org.eclipse.rse.ui.model.ISystemShellProvider; import org.eclipse.rse.ui.model.ISystemShellProvider;
import org.eclipse.swt.widgets.Shell; import org.eclipse.swt.widgets.Shell;
/**
* Base class for command shell wrappers that use echo markers to parse command finish.
/* * This abstract class can be extended to provide a command shell wrapper. When
* This abstract class can be extended to provide a command shell wrapper. * running a shell, commands can be piped to the shell via the sendCommand()
* When running a shell, commands can be piped to the shell via the * method. Echo commands are used to determine when each command is complete.
* sendCommand() method. Echo commands are used to determine when each command * Whenever a command completes, the handleCommandFinished() method is called.
* is complete. Whenever a command completes, the handleCommandFinished() method
* is called.
* *
*/ */
public abstract class RemoteCommandShellOperation public abstract class RemoteCommandShellOperation
@ -83,7 +81,7 @@ public abstract class RemoteCommandShellOperation
private Random _random; private Random _random;
/* /**
* Constructor * Constructor
*/ */
public RemoteCommandShellOperation(Shell shell, IRemoteCmdSubSystem cmdSubSystem, IRemoteFile pwd) public RemoteCommandShellOperation(Shell shell, IRemoteCmdSubSystem cmdSubSystem, IRemoteFile pwd)
@ -101,7 +99,7 @@ public abstract class RemoteCommandShellOperation
_pwd = pwd; _pwd = pwd;
} }
/* /**
* Launches a new remote shell * Launches a new remote shell
*/ */
public IRemoteCommandShell run() public IRemoteCommandShell run()
@ -131,7 +129,7 @@ public abstract class RemoteCommandShellOperation
} }
} }
/* /**
* Called when a shell is complete. * Called when a shell is complete.
*/ */
public void finish() public void finish()
@ -270,7 +268,7 @@ public abstract class RemoteCommandShellOperation
} }
/** /**
* Called whenever output is retrieved from the host * Called (on the main Thread) whenever output is retrieved from the host
*/ */
public void outputUpdated() public void outputUpdated()
{ {
@ -334,22 +332,24 @@ public abstract class RemoteCommandShellOperation
return false; return false;
} }
/* /**
* Called when the shell is complete * Called (on the main Thread) when the shell is complete
*/ */
public void handleShellFinished() public void handleShellFinished()
{ {
finish(); finish();
} }
/* /**
* Called when the specified command is complete * Called (on the main Thread) when the specified command is complete
*
* @param cmd the completed command * @param cmd the completed command
*/ */
public abstract void handleCommandFinished(String cmd); public abstract void handleCommandFinished(String cmd);
/* /**
* Called whenever output has changed * Called (on the main Thread) whenever output has changed
*
* @param command the current command * @param command the current command
* @param output the new output object * @param output the new output object
*/ */