Fill in since todo (#8839)

jenkinsci · Jan 8, 2024 · 50bc384 · 50bc384
1 parent 29f3853
commit 50bc384
Show file tree

Hide file tree

Showing 16 changed files with 24 additions and 24 deletions.
diff --git a/core/src/main/java/hudson/ExtensionList.java b/core/src/main/java/hudson/ExtensionList.java
@@ -468,7 +468,7 @@ public static <T> ExtensionList<T> create(Jenkins jenkins, Class<T> type) {
      * @return the singleton instance of the given type in its list.
      * @throws IllegalStateException if there are no instances
      *
-     * @since TODO
+     * @since 2.435
      */
     public static @NonNull <U> U lookupFirst(Class<U> type) {
         var all = lookup(type);

diff --git a/core/src/main/java/hudson/Functions.java b/core/src/main/java/hudson/Functions.java
@@ -1909,7 +1909,7 @@ public static String joinPath(String... components) {
      * Computes the link to the console for the run for the specified executable, taking {@link ConsoleUrlProvider} into account.
      * @param executable the executable (normally a {@link Run})
      * @return the absolute URL for accessing the build console for the executable, or null if there is no build associated with the executable
-     * @since TODO
+     * @since 2.433
      */
     public static @CheckForNull String getConsoleUrl(Queue.Executable executable) {
         if (executable == null) {

diff --git a/core/src/main/java/hudson/model/BuildTimelineWidget.java b/core/src/main/java/hudson/model/BuildTimelineWidget.java
@@ -40,9 +40,9 @@
  *
  * @author Kohsuke Kawaguchi
  * @since 1.372
- * @deprecated since TODO
+ * @deprecated since 2.431
  */
-@Deprecated
+@Deprecated(since = "2.431")
 public class BuildTimelineWidget {
     protected final RunList<?> builds;
 

diff --git a/core/src/main/java/hudson/model/View.java b/core/src/main/java/hudson/model/View.java
@@ -406,7 +406,7 @@ public boolean isFilterExecutors() {
     }
 
     /**
-     * @since TODO
+     * @since 2.426
      */
     @DataBoundSetter
     public void setFilterExecutors(boolean filterExecutors) {
@@ -421,7 +421,7 @@ public boolean isFilterQueue() {
     }
 
     /**
-     * @since TODO
+     * @since 2.426
      */
     @DataBoundSetter
     public void setFilterQueue(boolean filterQueue) {

diff --git a/core/src/main/java/hudson/node_monitors/AbstractNodeMonitorDescriptor.java b/core/src/main/java/hudson/node_monitors/AbstractNodeMonitorDescriptor.java
@@ -73,7 +73,7 @@ protected AbstractNodeMonitorDescriptor() {
      * method and return false.
      *
      * @return true if this monitor might take agents offline
-     * @since TODO
+     * @since 2.437
      */
     public boolean canTakeOffline() {
         return true;

diff --git a/core/src/main/java/hudson/node_monitors/DiskSpaceMonitorDescriptor.java b/core/src/main/java/hudson/node_monitors/DiskSpaceMonitorDescriptor.java
@@ -183,11 +183,11 @@ public long getFreeSize() {
         /**
          * Gets GB left.
          *
-         * @deprecated since TODO
+         * @deprecated
          *   Directly use the size field or to get a human-readable value with units use
          *   {@link Functions#humanReadableByteSize(long)}
          */
-        @Deprecated
+        @Deprecated(since = "2.434")
         public String getGbLeft() {
             long space = size;
             space /= 1024L;   // convert to KB

diff --git a/core/src/main/java/hudson/node_monitors/DiskSpaceMonitorNodeProperty.java b/core/src/main/java/hudson/node_monitors/DiskSpaceMonitorNodeProperty.java
@@ -11,7 +11,7 @@
 /**
  * {@link NodeProperty} that allows users to set agent specific disk space thresholds.
  *
- * @since TODO
+ * @since 2.434
  */
 public class DiskSpaceMonitorNodeProperty extends NodeProperty<Node> {
     private final String freeDiskSpaceThreshold;

diff --git a/core/src/main/java/jenkins/console/ConsoleUrlProvider.java b/core/src/main/java/jenkins/console/ConsoleUrlProvider.java
@@ -52,7 +52,7 @@
  * Pipeline flow graph, there may be various edge cases where your visualization does not work at all, but the classic
  * console view is unaffected.
  * @see Functions#getConsoleUrl
- * @since TODO
+ * @since 2.433
  */
 public interface ConsoleUrlProvider extends Describable<ConsoleUrlProvider> {
     @Restricted(NoExternalUse.class)

diff --git a/core/src/main/java/jenkins/console/ConsoleUrlProviderGlobalConfiguration.java b/core/src/main/java/jenkins/console/ConsoleUrlProviderGlobalConfiguration.java
@@ -48,7 +48,7 @@
 /**
  * Allows administrators to activate and sort {@link ConsoleUrlProvider} extensions to set defaults for all users.
  * @see ConsoleUrlProviderUserProperty
- * @since TODO
+ * @since 2.433
  */
 @Extension
 @Symbol("consoleUrlProvider")

diff --git a/core/src/main/java/jenkins/console/ConsoleUrlProviderUserProperty.java b/core/src/main/java/jenkins/console/ConsoleUrlProviderUserProperty.java
@@ -39,7 +39,7 @@
 /**
  * Allows users to activate and sort {@link ConsoleUrlProvider} extensions based on their preferences.
  * @see ConsoleUrlProviderGlobalConfiguration
- * @since TODO
+ * @since 2.433
  */
 @Restricted(NoExternalUse.class)
 public class ConsoleUrlProviderUserProperty extends UserProperty {

diff --git a/core/src/main/java/jenkins/console/DefaultConsoleUrlProvider.java b/core/src/main/java/jenkins/console/DefaultConsoleUrlProvider.java
@@ -36,7 +36,7 @@
  * Default implementation of {@link ConsoleUrlProvider} that uses the standard Jenkins console view.
  * <p>Exists so that users have a way to override {@link ConsoleUrlProviderGlobalConfiguration} and specify the default
  * console view if desired via {@link ConsoleUrlProviderUserProperty}.
- * @since TODO
+ * @since 2.433
  */
 @Restricted(value = NoExternalUse.class)
 public class DefaultConsoleUrlProvider implements ConsoleUrlProvider {

diff --git a/core/src/main/java/jenkins/model/Loadable.java b/core/src/main/java/jenkins/model/Loadable.java
@@ -6,7 +6,7 @@
 /**
  * Object whose state can be loaded from disk. In general, also implements {@link Saveable}.
  *
- * @since TODO
+ * @since 2.428
  */
 public interface Loadable {
 

diff --git a/core/src/main/java/jenkins/model/PeepholePermalink.java b/core/src/main/java/jenkins/model/PeepholePermalink.java
@@ -242,7 +242,7 @@ public void onCompleted(Run<?, ?> run, @NonNull TaskListener listener) {
     }
 
     /**
-     * @since TODO
+     * @since 2.436
      */
     public static final Permalink LAST_STABLE_BUILD = new PeepholePermalink() {
         @Override
@@ -262,7 +262,7 @@ public boolean apply(Run<?, ?> run) {
     };
 
     /**
-     * @since TODO
+     * @since 2.436
      */
     public static final Permalink LAST_SUCCESSFUL_BUILD = new PeepholePermalink() {
         @Override
@@ -283,7 +283,7 @@ public boolean apply(Run<?, ?> run) {
     };
 
     /**
-     * @since TODO
+     * @since 2.436
      */
     public static final Permalink LAST_FAILED_BUILD = new PeepholePermalink() {
         @Override
@@ -303,7 +303,7 @@ public boolean apply(Run<?, ?> run) {
     };
 
     /**
-     * @since TODO
+     * @since 2.436
      */
     public static final Permalink LAST_UNSTABLE_BUILD = new PeepholePermalink() {
         @Override
@@ -323,7 +323,7 @@ public boolean apply(Run<?, ?> run) {
     };
 
     /**
-     * @since TODO
+     * @since 2.436
      */
     public static final Permalink LAST_UNSUCCESSFUL_BUILD = new PeepholePermalink() {
         @Override
@@ -343,7 +343,7 @@ public boolean apply(Run<?, ?> run) {
     };
 
     /**
-     * @since TODO
+     * @since 2.436
      */
     public static final Permalink LAST_COMPLETED_BUILD = new PeepholePermalink() {
         @Override

diff --git a/core/src/main/java/jenkins/security/FIPS140.java b/core/src/main/java/jenkins/security/FIPS140.java
@@ -32,7 +32,7 @@
  * The environment (host, JVM and servlet container), must be suitably configured which is outside the scope of the Jenkins project.
  * @see <a href="https://csrc.nist.gov/pubs/fips/140-2/upd2/final">FIPS-140-2</a>
  * @see <a href="https://github.com/jenkinsci/jep/tree/master/jep/237#readme">JEP-237</a>
- * @since TODO
+ * @since 2.426
  */
 public class FIPS140 {
 

diff --git a/core/src/main/java/jenkins/util/DefaultScriptListener.java b/core/src/main/java/jenkins/util/DefaultScriptListener.java
@@ -37,7 +37,7 @@
 /**
  * Basic default implementation of {@link jenkins.util.ScriptListener} that just logs.
  *
- * @since TODO
+ * @since 2.427
  */
 @Extension
 @Restricted(NoExternalUse.class)

diff --git a/core/src/main/java/jenkins/util/ScriptListener.java b/core/src/main/java/jenkins/util/ScriptListener.java
@@ -49,7 +49,7 @@
  * @see hudson.cli.GroovyshCommand
  * @see jenkins.util.groovy.GroovyHookScript
  *
- * @since TODO
+ * @since 2.427
  */
 public interface ScriptListener extends ExtensionPoint {