diff options
Diffstat (limited to 'bundles/org.eclipse.equinox.p2.core/src/org/eclipse/equinox/p2/core/IProvisioningAgentProvider.java')
-rw-r--r-- | bundles/org.eclipse.equinox.p2.core/src/org/eclipse/equinox/p2/core/IProvisioningAgentProvider.java | 9 |
1 files changed, 6 insertions, 3 deletions
diff --git a/bundles/org.eclipse.equinox.p2.core/src/org/eclipse/equinox/p2/core/IProvisioningAgentProvider.java b/bundles/org.eclipse.equinox.p2.core/src/org/eclipse/equinox/p2/core/IProvisioningAgentProvider.java index b3067c00c..462b56d60 100644 --- a/bundles/org.eclipse.equinox.p2.core/src/org/eclipse/equinox/p2/core/IProvisioningAgentProvider.java +++ b/bundles/org.eclipse.equinox.p2.core/src/org/eclipse/equinox/p2/core/IProvisioningAgentProvider.java @@ -11,12 +11,11 @@ package org.eclipse.equinox.p2.core; import java.net.URI; -import org.eclipse.equinox.internal.provisional.p2.core.ProvisionException; /** * A service that is used to create or obtain instances of an * {@link IProvisioningAgent}. - * @since 1.1 + * @since 2.0 */ public interface IProvisioningAgentProvider { @@ -31,7 +30,10 @@ public interface IProvisioningAgentProvider { * currently running system is returned, if available. If a <code>null</code> * location is provided and the currently running system has not been provisioned * by any known agent, <code>null</code> is returned. - * + * <p> + * Callers of this method are responsible for stopping the agent + * when they are finished using it by invoking {@link IProvisioningAgent#stop()}. + * </p> * @param location The location where the agent metadata is stored * @return A provisioning agent, or <code>null</code> if a <code>null</code> * parameter is provided an there is no currently running agent. @@ -39,6 +41,7 @@ public interface IProvisioningAgentProvider { * <ul> * <li>The location is not writeable.</li> * </ul> + * @see IProvisioningAgent#stop() */ public IProvisioningAgent createAgent(URI location) throws ProvisionException; } |