From ea9ddafac2ddefa3feb5a091dacf045c4f2fa9a5 Mon Sep 17 00:00:00 2001 From: Kohsuke Kawaguchi Date: Wed, 15 Jun 2011 13:48:01 -0700 Subject: [PATCH] doc improvement --- core/src/main/java/hudson/model/AbstractItem.java | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/core/src/main/java/hudson/model/AbstractItem.java b/core/src/main/java/hudson/model/AbstractItem.java index af738ec84c..aff8dc7472 100644 --- a/core/src/main/java/hudson/model/AbstractItem.java +++ b/core/src/main/java/hudson/model/AbstractItem.java @@ -25,6 +25,7 @@ package hudson.model; import com.infradna.tool.bridge_method_injector.WithBridgeMethods; +import hudson.AbortException; import hudson.XmlFile; import hudson.Util; import hudson.Functions; @@ -298,6 +299,12 @@ public abstract class AbstractItem extends Actionable implements Item, HttpDelet * the files are first copied on the file system, * then it will be loaded, then this method will be invoked * to perform any implementation-specific work. + * + *

+ * + * + * @param src + * Item from which it's copied from. The same type as {@code this}. Never null. */ public void onCopiedFrom(Item src) { } @@ -410,6 +417,10 @@ public abstract class AbstractItem extends Actionable implements Item, HttpDelet /** * Deletes this item. + * + *

+ * Any exception indicates the deletion has failed, but {@link AbortException} would prevent the caller + * from showing the stack trace. This */ public synchronized void delete() throws IOException, InterruptedException { checkPermission(DELETE);