diff --git a/core/src/main/java/hudson/ExtensionList.java b/core/src/main/java/hudson/ExtensionList.java
index c9dc69d6dc35cf1b581506f8913479a24a0328a7..ab4bb33db981a737507eabf432e6a50c7c559480 100644
--- a/core/src/main/java/hudson/ExtensionList.java
+++ b/core/src/main/java/hudson/ExtensionList.java
@@ -138,7 +138,7 @@ public class ExtensionList<T> extends AbstractList<T> {
     /**
      * Write access will put the instance into a legacy store.
      *
-     * @deprecated
+     * @deprecated since 2009-02-23.
      *      Prefer automatic registration.
      */
     @Override
diff --git a/core/src/main/java/hudson/Launcher.java b/core/src/main/java/hudson/Launcher.java
index f9bfccec56c1789b6865014f8a359e4139375894..38a1df6bb7e312fd143941f2d3dfebed969021a4 100644
--- a/core/src/main/java/hudson/Launcher.java
+++ b/core/src/main/java/hudson/Launcher.java
@@ -118,7 +118,7 @@ public abstract class Launcher {
      *
      * @return
      *      null if this launcher is not created from a {@link Computer} object.
-     * @deprecated
+     * @deprecated since 2008-11-16.
      *      See the javadoc for why this is inherently unreliable. If you are trying to
      *      figure out the current {@link Computer} from within a build, use
      *      {@link Computer#currentComputer()}  
diff --git a/core/src/main/java/hudson/Util.java b/core/src/main/java/hudson/Util.java
index 47bc09d6d01528fa56bc1c1b1f53d20d341ea668..0976dcdcd764e11f81c86d23322036b871f110ee 100644
--- a/core/src/main/java/hudson/Util.java
+++ b/core/src/main/java/hudson/Util.java
@@ -975,7 +975,7 @@ public class Util {
      * but don't remember it right now.
      *
      * @since 1.204
-     * @deprecated This method is broken (see ISSUE#1666). It should probably
+     * @deprecated since 2008-05-13. This method is broken (see ISSUE#1666). It should probably
      * be removed but I'm not sure if it is considered part of the public API
      * that needs to be maintained for backwards compatibility.
      * Use {@link #encode(String)} instead. 
diff --git a/core/src/main/java/hudson/model/AbstractProject.java b/core/src/main/java/hudson/model/AbstractProject.java
index 7fc86078f14a8650f190409f06f7153277df22ad..472debeb7b349b1fb07530f07b0f74dc4944aea7 100644
--- a/core/src/main/java/hudson/model/AbstractProject.java
+++ b/core/src/main/java/hudson/model/AbstractProject.java
@@ -167,7 +167,7 @@ public abstract class AbstractProject<P extends AbstractProject<P,R>,R extends A
     private volatile String jdk;
 
     /**
-     * @deprecated
+     * @deprecated since 2007-01-29.
      */
     private transient boolean enableRemoteTrigger;
 
diff --git a/core/src/main/java/hudson/model/BuildAuthorizationToken.java b/core/src/main/java/hudson/model/BuildAuthorizationToken.java
index b1be9d65c871f7aaa15f276be92f01250ee679d4..ef8f05ef4ad4bce0c25847d48c5034fc95acf9cd 100644
--- a/core/src/main/java/hudson/model/BuildAuthorizationToken.java
+++ b/core/src/main/java/hudson/model/BuildAuthorizationToken.java
@@ -36,7 +36,7 @@ import java.io.IOException;
  *
  * @author Kohsuke Kawaguchi
  * @see BuildableItem
- * @deprecated
+ * @deprecated 2008-07-20
  *      Use {@link ACL} and {@link AbstractProject#BUILD}. This code is only here
  *      for the backward compatibility.
  */
diff --git a/core/src/main/java/hudson/model/Cause.java b/core/src/main/java/hudson/model/Cause.java
index 9994b15c48f21585ecbe359d548fe97ea3423f02..7c481dc18ff081a6605ea538da23dc653430a5ff 100644
--- a/core/src/main/java/hudson/model/Cause.java
+++ b/core/src/main/java/hudson/model/Cause.java
@@ -58,6 +58,7 @@ public abstract class Cause {
 
     /**
      * Fall back implementation when no other type is available.
+     * @deprecated since 2009-02-08
      */
     public static class LegacyCodeCause extends Cause {
         private StackTraceElement [] stackTrace;
@@ -77,10 +78,16 @@ public abstract class Cause {
     public static class UpstreamCause extends Cause {
         private String upstreamProject, upstreamUrl;
         private int upstreamBuild;
+        /**
+         * @deprecated since 2009-02-28
+         */
         @Deprecated
         private transient Cause upstreamCause;
         private List<Cause> upstreamCauses;
-        
+
+        /**
+         * @deprecated since 2009-02-28
+         */
         // for backward bytecode compatibility
         public UpstreamCause(AbstractBuild<?,?> up) {
             this((Run<?,?>)up);
diff --git a/core/src/main/java/hudson/model/CauseAction.java b/core/src/main/java/hudson/model/CauseAction.java
index b35f1d8c1ea5a2b811ea93d960b3f7a1cc0db25d..356d7d7ee690d84ec701927203bf51fc45f2e2a1 100644
--- a/core/src/main/java/hudson/model/CauseAction.java
+++ b/core/src/main/java/hudson/model/CauseAction.java
@@ -33,9 +33,12 @@ import org.kohsuke.stapler.export.ExportedBean;
 
 @ExportedBean
 public class CauseAction implements FoldableAction {
-	@Deprecated
-	// there can be multiple causes, so this is deprecated
-	private transient Cause cause;
+    /**
+     * @deprecated since 2009-02-28
+     */
+    @Deprecated
+    // there can be multiple causes, so this is deprecated
+    private transient Cause cause;
 	
 	private List<Cause> causes = new ArrayList<Cause>();
 
diff --git a/core/src/main/java/hudson/model/Computer.java b/core/src/main/java/hudson/model/Computer.java
index 9dc58ad4c45e567373536429208dc673b92d7313..842d9d588632e2828936c452b35b857f3d344d9c 100644
--- a/core/src/main/java/hudson/model/Computer.java
+++ b/core/src/main/java/hudson/model/Computer.java
@@ -209,7 +209,7 @@ public /*transient*/ abstract class Computer extends Actionable implements Acces
     public abstract void doLaunchSlaveAgent( StaplerRequest req, StaplerResponse rsp ) throws IOException, ServletException;
 
     /**
-     * @deprecated  Use {@link #connect(boolean)}
+     * @deprecated since 2009-01-06.  Use {@link #connect(boolean)}
      */
     public final void launch() {
         connect(true);
@@ -393,7 +393,8 @@ public /*transient*/ abstract class Computer extends Actionable implements Acces
 
     /**
      * Returns true if this computer is supposed to be launched via JNLP.
-     * @deprecated see {@linkplain #isLaunchSupported()} and {@linkplain ComputerLauncher}
+     * @deprecated since 2008-05-18.
+     *     See {@linkplain #isLaunchSupported()} and {@linkplain ComputerLauncher}
      */
     @Exported
     @Deprecated
diff --git a/core/src/main/java/hudson/model/Descriptor.java b/core/src/main/java/hudson/model/Descriptor.java
index 8a4db66865b334821abbeb47ca992ab1f44b9273..c1ce49ffbfabb1fe4553391ccb756c990954713a 100644
--- a/core/src/main/java/hudson/model/Descriptor.java
+++ b/core/src/main/java/hudson/model/Descriptor.java
@@ -119,7 +119,7 @@ public abstract class Descriptor<T extends Describable<T>> implements Saveable {
      * Going forward Hudson simply persists all the non-transient fields
      * of {@link Descriptor}, just like others, so this is pointless.
      *
-     * @deprecated
+     * @deprecated since 2006-11-16
      */
     @Deprecated
     private transient Map<String,Object> properties;
@@ -687,4 +687,4 @@ public abstract class Descriptor<T extends Describable<T>> implements Saveable {
             throw new AssertionError();
         }
     }
-}
\ No newline at end of file
+}
diff --git a/core/src/main/java/hudson/model/DirectoryBrowserSupport.java b/core/src/main/java/hudson/model/DirectoryBrowserSupport.java
index f9152cc7a7e29094339e4a39ab2f0bf0974ac3f3..07337c103a06ed65baa6366573e06f7715047816 100644
--- a/core/src/main/java/hudson/model/DirectoryBrowserSupport.java
+++ b/core/src/main/java/hudson/model/DirectoryBrowserSupport.java
@@ -73,8 +73,8 @@ public final class DirectoryBrowserSupport implements HttpResponse {
     private String indexFileName = "index.html";
 
     /**
-     * @deprecated
-     *      Use {@link #DirectoryBrowserSupport(ModelObject, String)}
+     * @deprecated since 2007-08-12.
+     *      Use {@link #DirectoryBrowserSupport(ModelObject, FilePath, String, String, boolean)}
      */
     public DirectoryBrowserSupport(ModelObject owner) {
         this(owner,owner.getDisplayName());
diff --git a/core/src/main/java/hudson/model/FingerprintMap.java b/core/src/main/java/hudson/model/FingerprintMap.java
index 48c960245ce345ac7401196410a910e7e1231978..9397a07516d636c487deb0a5458db802af908271 100644
--- a/core/src/main/java/hudson/model/FingerprintMap.java
+++ b/core/src/main/java/hudson/model/FingerprintMap.java
@@ -44,7 +44,7 @@ import java.util.concurrent.ConcurrentHashMap;
 public final class FingerprintMap extends KeyedDataStorage<Fingerprint,FingerprintParams> {
 
     /**
-     * @deprecated
+     * @deprecated since 2007-03-26.
      *      Some old version of Hudson incorrectly serialized this information to the disk.
      *      So we need this field to be here for such configuration to be read correctly.
      *      This field is otherwise no longer in use.
diff --git a/core/src/main/java/hudson/model/HealthReport.java b/core/src/main/java/hudson/model/HealthReport.java
index bc763d823ed4850f02b942fee84fc28ddc66c804..53aafec9a920a55e6d7631b49417f0be4e7cfeb2 100644
--- a/core/src/main/java/hudson/model/HealthReport.java
+++ b/core/src/main/java/hudson/model/HealthReport.java
@@ -70,7 +70,7 @@ public class HealthReport implements Serializable, Comparable<HealthReport> {
     /**
      * Recover the health icon's tool-tip when deserializing.
      *
-     * @deprecated use {@link #localizibleDescription}
+     * @deprecated since 2008-10-18. Use {@link #localizibleDescription}
      */
     @Deprecated
     private transient String description;
@@ -93,7 +93,8 @@ public class HealthReport implements Serializable, Comparable<HealthReport> {
      *                    When calculating the url to display for absolute paths, the getIconUrl(String) method
      *                    will replace /32x32/ in the path with the appropriate size.
      * @param description The health icon's tool-tip.
-     * @deprecated use {@link #HealthReport(int, String, org.jvnet.localizer.Localizable)}
+     * @deprecated since 2008-10-18.
+     *     Use {@link #HealthReport(int, String, org.jvnet.localizer.Localizable)}
      */
     @Deprecated
     public HealthReport(int score, String iconUrl, String description) {
@@ -140,7 +141,8 @@ public class HealthReport implements Serializable, Comparable<HealthReport> {
      *
      * @param score       The percentage health score (from 0 to 100 inclusive).
      * @param description The health icon's tool-tip.
-     * @deprecated use {@link #HealthReport(int, org.jvnet.localizer.Localizable)}
+     * @deprecated since 2008-10-18.
+     *     Use {@link #HealthReport(int, org.jvnet.localizer.Localizable)}
      */
     @Deprecated
     public HealthReport(int score, String description) {
diff --git a/core/src/main/java/hudson/model/Hudson.java b/core/src/main/java/hudson/model/Hudson.java
index 199a2dccb273dfcd168173c00210577117bc87d2..ffaab223b92fddd9ef3a447e4067c01b62ba26b2 100644
--- a/core/src/main/java/hudson/model/Hudson.java
+++ b/core/src/main/java/hudson/model/Hudson.java
@@ -861,7 +861,7 @@ public final class Hudson extends Node implements ItemGroup<TopLevelItem>, Stapl
     /**
      * Adds a new {@link JobListener}.
      *
-     * @deprecated
+     * @deprecated since 2007-01-04.
      *      Use {@code getJobListeners().add(l)} instead.
      */
     public void addListener(JobListener l) {
@@ -871,7 +871,7 @@ public final class Hudson extends Node implements ItemGroup<TopLevelItem>, Stapl
     /**
      * Deletes an existing {@link JobListener}.
      *
-     * @deprecated
+     * @deprecated since 2007-01-04.
      *      Use {@code getJobListeners().remove(l)} instead.
      */
     public boolean removeListener(JobListener l ) {
@@ -3257,7 +3257,7 @@ public final class Hudson extends Node implements ItemGroup<TopLevelItem>, Stapl
     }
 
     /**
-     * @deprecated
+     * @deprecated since 2007-12-18.
      *      Use {@link #checkPermission(Permission)}
      */
     public static boolean adminCheck() throws IOException {
@@ -3265,7 +3265,7 @@ public final class Hudson extends Node implements ItemGroup<TopLevelItem>, Stapl
     }
 
     /**
-     * @deprecated
+     * @deprecated since 2007-12-18.
      *      Use {@link #checkPermission(Permission)}
      */
     public static boolean adminCheck(StaplerRequest req,StaplerResponse rsp) throws IOException {
@@ -3279,7 +3279,7 @@ public final class Hudson extends Node implements ItemGroup<TopLevelItem>, Stapl
      * Checks if the current user (for which we are processing the current request)
      * has the admin access.
      *
-     * @deprecated
+     * @deprecated since 2007-12-18.
      *      This method is deprecated when Hudson moved from simple Unix root-like model
      *      of "admin gets to do everything, and others don't have any privilege" to more
      *      complex {@link ACL} and {@link Permission} based scheme.
@@ -3298,7 +3298,7 @@ public final class Hudson extends Node implements ItemGroup<TopLevelItem>, Stapl
     }
 
     /**
-     * @deprecated
+     * @deprecated since 2007-12-18.
      *      Define a custom {@link Permission} and check against ACL.
      *      See {@link #isAdmin()} for more instructions.
      */
diff --git a/core/src/main/java/hudson/model/JDK.java b/core/src/main/java/hudson/model/JDK.java
index 108deef8f4122ed1269a411c548b53e311ac2ffa..35289ac757d37b6572e11e6b689c1472a5efab4e 100644
--- a/core/src/main/java/hudson/model/JDK.java
+++ b/core/src/main/java/hudson/model/JDK.java
@@ -51,6 +51,9 @@ import org.kohsuke.stapler.QueryParameter;
  * @author Kohsuke Kawaguchi
  */
 public final class JDK extends ToolInstallation implements NodeSpecific<JDK>, EnvironmentSpecific<JDK> {
+    /**
+     * @deprecated since 2009-02-25
+     */
     @Deprecated // kept for backward compatibility - use getHome() instead
     private String javaHome;
 
diff --git a/core/src/main/java/hudson/model/Job.java b/core/src/main/java/hudson/model/Job.java
index 914202c878ff9b84e876094a81769098648d4a1b..9d269a66d7edfa73169f11b7ea84505cbfc8ccbd 100644
--- a/core/src/main/java/hudson/model/Job.java
+++ b/core/src/main/java/hudson/model/Job.java
@@ -570,8 +570,8 @@ public abstract class Job<JobT extends Job<JobT, RunT>, RunT extends Run<JobT, R
     }
 
     /**
-     * @deprecated This is only used to support backward compatibility with old
-     *             URLs.
+     * @deprecated since 2008-06-15.
+     *     This is only used to support backward compatibility with old URLs.
      */
     @Deprecated
     public RunT getBuild(String id) {
diff --git a/core/src/main/java/hudson/model/Jobs.java b/core/src/main/java/hudson/model/Jobs.java
index 078595544e292335d7c70d21538b4e96f98e554a..c124861603f9bcde0dea58ac0c59a82b88210f84 100644
--- a/core/src/main/java/hudson/model/Jobs.java
+++ b/core/src/main/java/hudson/model/Jobs.java
@@ -32,6 +32,7 @@ import java.util.List;
  * List of all installed {@link Job} types.
  * 
  * @author Kohsuke Kawaguchi
+ * @deprecated since 1.281
  */
 public class Jobs {
     /**
diff --git a/core/src/main/java/hudson/model/MultiStageTimeSeries.java b/core/src/main/java/hudson/model/MultiStageTimeSeries.java
index 14bd772a974f891d692c15b163f0b5164ddd1f01..1fb6cdb24c0338056f556b9a0980e9cf8cd3f5cd 100644
--- a/core/src/main/java/hudson/model/MultiStageTimeSeries.java
+++ b/core/src/main/java/hudson/model/MultiStageTimeSeries.java
@@ -102,7 +102,7 @@ public class MultiStageTimeSeries {
     }
 
     /**
-     * @deprecated
+     * @deprecated since 2009-04-05.
      *      Use {@link #MultiStageTimeSeries(Localizable, Color, float, float)}
      */
     public MultiStageTimeSeries(float initialValue, float decay) {
diff --git a/core/src/main/java/hudson/model/ParameterValue.java b/core/src/main/java/hudson/model/ParameterValue.java
index 3f246b8a4c898a3f4d04fa95d927c659cb17003e..c704813a5915e03e85f07932206dbc083e8d2578 100644
--- a/core/src/main/java/hudson/model/ParameterValue.java
+++ b/core/src/main/java/hudson/model/ParameterValue.java
@@ -161,7 +161,7 @@ public abstract class ParameterValue implements Serializable {
     /**
      * Accessing {@link ParameterDefinition} is not a good idea.
      *
-     * @deprecated
+     * @deprecated since 2008-09-20.
      *    parameter definition may change any time. So if you find yourself
      *    in need of accessing the information from {@link ParameterDefinition},
      *    instead copy them in {@link ParameterDefinition#createValue(StaplerRequest, JSONObject)}
diff --git a/core/src/main/java/hudson/model/Project.java b/core/src/main/java/hudson/model/Project.java
index 35aee90b9b7251697f762e65e1b82403e426ea68..d880242635d5840af6c375ad173455edcab88f9f 100644
--- a/core/src/main/java/hudson/model/Project.java
+++ b/core/src/main/java/hudson/model/Project.java
@@ -227,8 +227,8 @@ public abstract class Project<P extends Project<P,B>,B extends Build<P,B>>
     }
 
     /**
-     * @deprecated
-     *      left for legacy config file compatibility
+     * @deprecated since 2006-11-05.
+     *      Left for legacy config file compatibility
      */
     @Deprecated
     private transient String slave;
diff --git a/core/src/main/java/hudson/model/Run.java b/core/src/main/java/hudson/model/Run.java
index 173faf6582eb93d321a077af746f2c742b58dba9..b896e621d0942f6424ba38283045647ee9dc40bf 100644
--- a/core/src/main/java/hudson/model/Run.java
+++ b/core/src/main/java/hudson/model/Run.java
@@ -1259,8 +1259,9 @@ public abstract class Run <JobT extends Job<JobT,RunT>,RunT extends Run<JobT,Run
     /**
      * Gets the log of the build as a string.
      *
-     * @deprecated Use {@link #getLog(int)} instead as it avoids loading
-     * the whole log into memory unnecessarily.
+     * @deprecated since 2007-11-11.
+     *     Use {@link #getLog(int)} instead as it avoids loading
+     *     the whole log into memory unnecessarily.
      */
     @Deprecated
     public String getLog() throws IOException {
diff --git a/core/src/main/java/hudson/model/Slave.java b/core/src/main/java/hudson/model/Slave.java
index de477afb5a079080ed1d2e88dfdcd6f0c418fead..7ac5338320445d79f1db7612e5c9fe4615303d1e 100644
--- a/core/src/main/java/hudson/model/Slave.java
+++ b/core/src/main/java/hudson/model/Slave.java
@@ -130,6 +130,9 @@ public abstract class Slave extends Node implements Serializable {
         this(name,nodeDescription,remoteFS,Util.tryParseNumber(numExecutors, 1).intValue(),mode,labelString,launcher,retentionStrategy, nodeProperties);
     }
 
+    /**
+     * @deprecated since 2009-02-20.
+     */
     @Deprecated
     public Slave(String name, String nodeDescription, String remoteFS, int numExecutors,
             Mode mode, String labelString, ComputerLauncher launcher, RetentionStrategy retentionStrategy) throws FormException, IOException {
@@ -395,6 +398,7 @@ public abstract class Slave extends Node implements Serializable {
      * @deprecated
      */
     private transient String command;
+
     /**
      * Command line to launch the agent, like
      * "ssh myslave java -jar /path/to/hudson-remoting.jar"
diff --git a/core/src/main/java/hudson/model/TopLevelItemDescriptor.java b/core/src/main/java/hudson/model/TopLevelItemDescriptor.java
index f0d1bcd23e981c44dda13ae383a8df66ba05004b..a4e7fd1702562263259c9947dcad1feec87fb9f0 100644
--- a/core/src/main/java/hudson/model/TopLevelItemDescriptor.java
+++ b/core/src/main/java/hudson/model/TopLevelItemDescriptor.java
@@ -80,7 +80,7 @@ public abstract class TopLevelItemDescriptor extends Descriptor<TopLevelItem> {
     }
 
     /**
-     * @deprecated
+     * @deprecated since 2007-01-19.
      *      This is not a valid operation for {@link Job}s.
      */
     @Deprecated
diff --git a/core/src/main/java/hudson/model/listeners/JobListener.java b/core/src/main/java/hudson/model/listeners/JobListener.java
index 19464094985801f3d4d234ae0b08cbfa676575dc..10fec34f498363b2251a407c8fa570e07522ab7c 100644
--- a/core/src/main/java/hudson/model/listeners/JobListener.java
+++ b/core/src/main/java/hudson/model/listeners/JobListener.java
@@ -36,7 +36,8 @@ import hudson.ExtensionPoint;
  *
  * @author Kohsuke Kawaguchi
  * @see Hudson#addListener(JobListener)
- * @deprecated {@link ItemListener} is the generalized form of this.
+ * @deprecated since 2007-10-09.
+ *     {@link ItemListener} is the generalized form of this.
  */
 public abstract class JobListener implements ExtensionPoint {
     /**
@@ -46,8 +47,7 @@ public abstract class JobListener implements ExtensionPoint {
     }
 
     /**
-     * Called after all the jobs are loaded from disk into {@link Hudson}
-     * object.
+     * Called after all the jobs are loaded from disk into {@link Hudson} object.
      *
      * @since 1.68
      */
diff --git a/core/src/main/java/hudson/model/listeners/RunListener.java b/core/src/main/java/hudson/model/listeners/RunListener.java
index 31572aad0319ba5195f725ccd84124751d368b14..d39250e9fdec9a71ae36366aa3ca7003c8053ec2 100644
--- a/core/src/main/java/hudson/model/listeners/RunListener.java
+++ b/core/src/main/java/hudson/model/listeners/RunListener.java
@@ -99,7 +99,7 @@ public abstract class RunListener<R extends Run> implements ExtensionPoint {
      * Registers this object as an active listener so that it can start getting
      * callbacks invoked.
      *
-     * @deprecated
+     * @deprecated as of 1.281
      *      Put {@link Extension} on your class to get it auto-registered.
      */
     public void register() {
diff --git a/core/src/main/java/hudson/scm/RepositoryBrowsers.java b/core/src/main/java/hudson/scm/RepositoryBrowsers.java
index ced9128be6c04d0e62dd14a6e4ac06be80600d21..9079a034f5546b899cfd26dd265d56727a1c93ed 100644
--- a/core/src/main/java/hudson/scm/RepositoryBrowsers.java
+++ b/core/src/main/java/hudson/scm/RepositoryBrowsers.java
@@ -65,7 +65,7 @@ public class RepositoryBrowsers {
     /**
      * Creates an instance of {@link RepositoryBrowser} from a form submission.
      *
-     * @deprecated
+     * @deprecated since 2008-06-19.
      *      Use {@link #createInstance(Class, StaplerRequest, JSONObject, String)}.
      */
     public static <T extends RepositoryBrowser>
diff --git a/core/src/main/java/hudson/security/AuthorizationStrategy.java b/core/src/main/java/hudson/security/AuthorizationStrategy.java
index 0c0ecd94bf090db29f656e2cc9d14183f06fa450..819ee2f9cde255ca0ed853b18fabc48670f4ef30 100644
--- a/core/src/main/java/hudson/security/AuthorizationStrategy.java
+++ b/core/src/main/java/hudson/security/AuthorizationStrategy.java
@@ -78,9 +78,10 @@ public abstract class AuthorizationStrategy implements Describable<Authorization
     public abstract ACL getRootACL();
 
     /**
-     * @deprecated
+     * @deprecated since 1.277
      *      Override {@link #getACL(Job)} instead.
      */
+    @Deprecated
     public ACL getACL(AbstractProject<?,?> project) {
     	return getACL((Job)project);
     }
@@ -188,7 +189,7 @@ public abstract class AuthorizationStrategy implements Describable<Authorization
     /**
      * All registered {@link SecurityRealm} implementations.
      *
-     * @deprecated
+     * @deprecated since 1.286
      *      Use {@link #all()} for read access, and {@link Extension} for registration.
      */
     public static final DescriptorList<AuthorizationStrategy> LIST = new DescriptorList<AuthorizationStrategy>(AuthorizationStrategy.class);
diff --git a/core/src/main/java/hudson/security/Permission.java b/core/src/main/java/hudson/security/Permission.java
index 1fbfe3f6efe01789ef70e73ccc7daa11e7d0b9b1..886fa362e1878ec7bf243a9ebbdd84d0f08cc0cb 100644
--- a/core/src/main/java/hudson/security/Permission.java
+++ b/core/src/main/java/hudson/security/Permission.java
@@ -222,7 +222,7 @@ public final class Permission {
     /**
      * {@link PermissionGroup} for {@link Hudson}.
      *
-     * @deprecated
+     * @deprecated since 2009-01-23.
      *      Access {@link Hudson#PERMISSIONS} instead.
      */
     public static final PermissionGroup HUDSON_PERMISSIONS = new PermissionGroup(Hudson.class, hudson.model.Messages._Hudson_Permissions_Title());
@@ -232,7 +232,7 @@ public final class Permission {
      * <p>
      * All permissions are eventually {@linkplain Permission#impliedBy implied by} this permission.
      *
-     * @deprecated
+     * @deprecated since 2009-01-23.
      *      Access {@link Hudson#ADMINISTER} instead.
      */
     public static final Permission HUDSON_ADMINISTER = new Permission(HUDSON_PERMISSIONS,"Administer", hudson.model.Messages._Hudson_AdministerPermission_Description(),null);
@@ -251,7 +251,7 @@ public final class Permission {
      * Historically this was separate from {@link #HUDSON_ADMINISTER} but such a distinction doesn't make sense
      * any more, so deprecated.
      *
-     * @deprecated
+     * @deprecated since 2009-01-23.
      *      Use {@link Hudson#ADMINISTER}.
      */
     public static final Permission FULL_CONTROL = new Permission(GROUP,"FullControl",HUDSON_ADMINISTER);
diff --git a/core/src/main/java/hudson/slaves/Channels.java b/core/src/main/java/hudson/slaves/Channels.java
index 3dfae505eb4457d8b05db670c1adf7cac78a0a3b..72da947cf4e9a54880694860933be3a701efc092 100644
--- a/core/src/main/java/hudson/slaves/Channels.java
+++ b/core/src/main/java/hudson/slaves/Channels.java
@@ -56,7 +56,7 @@ import java.util.logging.Logger;
  */
 public class Channels {
     /**
-     * @deprecated
+     * @deprecated since 2009-04-13.
      *      Use {@link #forProcess(String, ExecutorService, InputStream, OutputStream, OutputStream, Proc)}
      */
     public static Channel forProcess(String name, ExecutorService execService, InputStream in, OutputStream out, Proc proc) throws IOException {
diff --git a/core/src/main/java/hudson/slaves/SlaveComputer.java b/core/src/main/java/hudson/slaves/SlaveComputer.java
index da852170760388ddb79f489b7bf17fe8d974f98a..ff2c15116e036daab5d351240d43f8f9398c1952 100644
--- a/core/src/main/java/hudson/slaves/SlaveComputer.java
+++ b/core/src/main/java/hudson/slaves/SlaveComputer.java
@@ -144,8 +144,10 @@ public class SlaveComputer extends Computer {
         return super.getIcon();
     }
 
-    @Override
-    @Deprecated
+    /**
+     * @deprecated since 2008-05-20.
+     */
+    @Deprecated @Override
     public boolean isJnlpAgent() {
         return launcher instanceof JNLPLauncher;
     }
@@ -406,7 +408,7 @@ public class SlaveComputer extends Computer {
     /**
      * Serves jar files for JNLP slave agents.
      *
-     * @deprecated
+     * @deprecated since 2008-08-18.
      *      This URL binding is no longer used and moved up directly under to {@link Hudson},
      *      but it's left here for now just in case some old JNLP slave agents request it.
      */
diff --git a/core/src/main/java/hudson/tasks/BuildStepCompatibilityLayer.java b/core/src/main/java/hudson/tasks/BuildStepCompatibilityLayer.java
index 79cb8cfde30063957b83ba2235440592a59f264b..052453de35051396807fce8b6686d8349c36ca07 100644
--- a/core/src/main/java/hudson/tasks/BuildStepCompatibilityLayer.java
+++ b/core/src/main/java/hudson/tasks/BuildStepCompatibilityLayer.java
@@ -41,6 +41,7 @@ import java.io.IOException;
  *
  * @author Kohsuke Kawaguchi
  * @since 1.150
+ * @deprecated since 1.150
  */
 public abstract class BuildStepCompatibilityLayer implements BuildStep {
 //
diff --git a/core/src/main/java/hudson/tasks/BuildWrapper.java b/core/src/main/java/hudson/tasks/BuildWrapper.java
index d53c1909014838e277786f3d96e270e105b1330b..d00c434421d474a3217a04b17d4c46fe04cdf687 100644
--- a/core/src/main/java/hudson/tasks/BuildWrapper.java
+++ b/core/src/main/java/hudson/tasks/BuildWrapper.java
@@ -97,9 +97,10 @@ public abstract class BuildWrapper implements ExtensionPoint, Describable<BuildW
         }
 
         /**
-         * @deprecated
+         * @deprecated since 2007-10-28.
          *      Use {@link #tearDown(AbstractBuild, BuildListener)} instead.
          */
+        @Deprecated
         public boolean tearDown( Build build, BuildListener listener ) throws IOException, InterruptedException {
             return true;
         }
@@ -135,9 +136,10 @@ public abstract class BuildWrapper implements ExtensionPoint, Describable<BuildW
     }
 
     /**
-     * @deprecated
+     * @deprecated since 2007-10-28.
      *      Use {@link #setUp(AbstractBuild, Launcher, BuildListener)} instead.
      */
+    @Deprecated
     public Environment setUp( Build build, Launcher launcher, BuildListener listener ) throws IOException, InterruptedException {
         throw new UnsupportedOperationException(getClass()+" needs to implement the setUp method");
     }
diff --git a/core/src/main/java/hudson/tasks/Maven.java b/core/src/main/java/hudson/tasks/Maven.java
index c1cf35d3b35d4fe79d2dee1e4ca037bccb6f79b1..80291db40ad4b2f8c4e4f156edbb752f8c2bd227 100644
--- a/core/src/main/java/hudson/tasks/Maven.java
+++ b/core/src/main/java/hudson/tasks/Maven.java
@@ -345,6 +345,9 @@ public class Maven extends Builder {
      */
     public static final class MavenInstallation extends ToolInstallation implements EnvironmentSpecific<MavenInstallation>, NodeSpecific<MavenInstallation> {
 
+        /**
+         * @deprecated since 2009-02-25.
+         */
         @Deprecated // kept for backward compatiblity - use getHome()
         private String mavenHome;
 
diff --git a/core/src/main/java/hudson/tasks/Publisher.java b/core/src/main/java/hudson/tasks/Publisher.java
index a841d10cbe40ac5df654a088b67cce177ece25f6..34bce6a5b17380ab0455b5e2545308c4145e6735 100644
--- a/core/src/main/java/hudson/tasks/Publisher.java
+++ b/core/src/main/java/hudson/tasks/Publisher.java
@@ -76,18 +76,18 @@ public abstract class Publisher extends BuildStepCompatibilityLayer implements B
 //
     /**
      * Default implementation that does nothing.
+     * @deprecated since 1.150
      */
-    @Deprecated
-    @Override
+    @Deprecated @Override
     public boolean prebuild(Build build, BuildListener listener) {
         return true;
     }
 
     /**
      * Default implementation that does nothing.
+     * @deprecated since 1.150
      */
-    @Deprecated
-    @Override
+    @Deprecated @Override
     public Action getProjectAction(Project project) {
         return null;
     }
diff --git a/core/src/main/java/hudson/tasks/UserNameResolver.java b/core/src/main/java/hudson/tasks/UserNameResolver.java
index c96b1d7c2e4b411d4da112c74b2bed9ce910e65b..2a8ac7253637c9fa68486ad9cdbdf3711d2f81ed 100644
--- a/core/src/main/java/hudson/tasks/UserNameResolver.java
+++ b/core/src/main/java/hudson/tasks/UserNameResolver.java
@@ -89,7 +89,7 @@ public abstract class UserNameResolver implements ExtensionPoint {
     /**
      * All registered {@link UserNameResolver} implementations.
      *
-     * @deprecated
+     * @deprecated since 2009-02-24.
      *      Use {@link #all()} for read access, and use {@link Extension} for registration.
      */
     public static final List<UserNameResolver> LIST = ExtensionListView.createList(UserNameResolver.class);
diff --git a/core/src/main/java/hudson/tasks/junit/JUnitResultArchiver.java b/core/src/main/java/hudson/tasks/junit/JUnitResultArchiver.java
index 54229602a880aee102d010be3b0752181407947a..91fae3c125f0cd4974f82fc100886f3da82262bf 100644
--- a/core/src/main/java/hudson/tasks/junit/JUnitResultArchiver.java
+++ b/core/src/main/java/hudson/tasks/junit/JUnitResultArchiver.java
@@ -88,6 +88,7 @@ public class JUnitResultArchiver extends Recorder implements Serializable,
 
 	/**
 	 * left for backwards compatibility
+         * @deprecated since 2009-08-09.
 	 */
 	@Deprecated
 	public JUnitResultArchiver(String testResults) {
@@ -161,7 +162,7 @@ public class JUnitResultArchiver extends Recorder implements Serializable,
 	/**
 	 * Not actually used, but left for backward compatibility
 	 * 
-	 * @deprecated
+	 * @deprecated since 2009-08-10.
 	 */
 	protected TestResult parseResult(DirectoryScanner ds, long buildTime)
 			throws IOException {
diff --git a/core/src/main/java/hudson/tools/ToolLocationNodeProperty.java b/core/src/main/java/hudson/tools/ToolLocationNodeProperty.java
index a1f8fca9059e24bce0d3ee7b8b381cc32dd17fd5..29d1c3d76c7becec847dc5fb3f0c3cdcfe164b81 100644
--- a/core/src/main/java/hudson/tools/ToolLocationNodeProperty.java
+++ b/core/src/main/java/hudson/tools/ToolLocationNodeProperty.java
@@ -83,8 +83,8 @@ public class ToolLocationNodeProperty extends NodeProperty<Node> {
      *
      * @return
      *      never null.
-     * @deprecated
-     *      Use {@link ToolInstallation#translateFor(Node)} 
+     * @deprecated since 2009-04-09.
+     *      Use {@link ToolInstallation#translateFor(Node,TaskListener)} 
      */
     public static String getToolHome(Node node, ToolInstallation installation, TaskListener log) throws IOException, InterruptedException {
         String result = null;
diff --git a/core/src/main/java/hudson/util/ByteBuffer.java b/core/src/main/java/hudson/util/ByteBuffer.java
index d93f2b8092129b2bce16232f82fdc28029dac558..ee1f16f47ed3e4ef607573f14e2596d4f87b785b 100644
--- a/core/src/main/java/hudson/util/ByteBuffer.java
+++ b/core/src/main/java/hudson/util/ByteBuffer.java
@@ -35,7 +35,7 @@ import java.io.InputStream;
  * This version allows one to read while writing is in progress. 
  *
  * @author Kohsuke Kawaguchi
- * @deprecated Moved to stapler
+ * @deprecated since 2008-05-28. Moved to stapler
  */
 public class ByteBuffer extends OutputStream {
     private byte[] buf = new byte[8192];
diff --git a/core/src/main/java/hudson/util/CharSpool.java b/core/src/main/java/hudson/util/CharSpool.java
index 89007742a79fb68e99728b587e0657be1f0e5ab5..45d28ddb783432f8a76a4149fe3e2f2d269ab09f 100644
--- a/core/src/main/java/hudson/util/CharSpool.java
+++ b/core/src/main/java/hudson/util/CharSpool.java
@@ -32,7 +32,7 @@ import java.util.List;
  * {@link Writer} that spools the output and writes to another {@link Writer} later.
  *
  * @author Kohsuke Kawaguchi
- * @deprecated moved to stapler
+ * @deprecated since 2008-05-28. moved to stapler
  */
 public final class CharSpool extends Writer {
     private List<char[]> buf;
diff --git a/core/src/main/java/hudson/util/DescribableList.java b/core/src/main/java/hudson/util/DescribableList.java
index c9428cf1ed1b6c7a9fdfbc2d2cdbfb0a965752ed..df0988024fe680990617a4159b7003dc60f2a227 100644
--- a/core/src/main/java/hudson/util/DescribableList.java
+++ b/core/src/main/java/hudson/util/DescribableList.java
@@ -69,7 +69,7 @@ public class DescribableList<T extends Describable<T>, D extends Descriptor<T>>
     }
 
     /**
-     * @deprecated
+     * @deprecated since 2008-08-15.
      *      Use {@link #DescribableList(Saveable)} 
      */
     public DescribableList(Owner owner) {
@@ -81,7 +81,7 @@ public class DescribableList<T extends Describable<T>, D extends Descriptor<T>>
     }
 
     /**
-     * @deprecated
+     * @deprecated since 2008-08-15.
      *      Use {@link #setOwner(Saveable)}
      */
     public void setOwner(Owner owner) {
@@ -279,7 +279,7 @@ public class DescribableList<T extends Describable<T>, D extends Descriptor<T>>
     }
 
     /**
-     * @deprecated 
+     * @deprecated since 2008-08-15.
      *      Just implement {@link Saveable}.
      */
     public interface Owner extends Saveable {
diff --git a/core/src/main/java/hudson/util/LineEndNormalizingWriter.java b/core/src/main/java/hudson/util/LineEndNormalizingWriter.java
index 51798bc5b95aa45e3c0e972e6f1c355fb2693594..e2f26e75f860a4ab4901226f21a72eb2e31bbf15 100644
--- a/core/src/main/java/hudson/util/LineEndNormalizingWriter.java
+++ b/core/src/main/java/hudson/util/LineEndNormalizingWriter.java
@@ -37,7 +37,7 @@ import java.io.IOException;
  * we use this filter to always convert LF to CR+LF.
  *
  * @author Kohsuke Kawaguchi
- * @deprecated moved to stapler
+ * @deprecated since 2008-05-28. moved to stapler
  */
 public class LineEndNormalizingWriter extends FilterWriter {
 
diff --git a/core/src/main/java/hudson/util/WriterOutputStream.java b/core/src/main/java/hudson/util/WriterOutputStream.java
index 31ea9f45342319daf5176379effbd1afe64cfa75..469b015db6969c10407cce5a0cd9632eeb7d2763 100644
--- a/core/src/main/java/hudson/util/WriterOutputStream.java
+++ b/core/src/main/java/hudson/util/WriterOutputStream.java
@@ -38,7 +38,7 @@ import java.nio.*;
  * by assuming the platform default encoding.
  *
  * @author Kohsuke Kawaguchi
- * @deprecated
+ * @deprecated since 2008-05-28.
  *      Use the one in stapler.
  */
 public class WriterOutputStream extends OutputStream {