Update at-since Javadoc

core/src/main/java/hudson/FilePath.java

@@ -1262,7 +1262,7 @@ public Boolean invoke(File f, VirtualChannel channel) throws IOException, Interr
     /**
      * Deletes all suffixes recursively.
      * @throws IOException if it exists but could not be successfully deleted
-     * @since TODO
+     * @since 2.244
      */
     public void deleteSuffixesRecursive() throws IOException, InterruptedException {
         act(new DeleteSuffixesRecursive());

core/src/main/java/hudson/Functions.java

@@ -1161,7 +1161,7 @@ public static Collection<Descriptor> getSortedDescriptorsForGlobalConfigUnclassi
     /**
      * Checks if the current security principal has one of the supplied permissions.
      *
-     * @since TODO
+     * @since 2.238
      */
     public static boolean hasAnyPermission(AccessControlled ac, Permission[] permissions) {
         if (permissions == null || permissions.length == 0) {
@@ -1176,7 +1176,7 @@ public static boolean hasAnyPermission(AccessControlled ac, Permission[] permiss
      * degrades gracefully if "it" is not an {@link AccessControlled} object.
      * Otherwise it will perform no check and that problem is hard to notice.
      *
-     * @since TODO
+     * @since 2.238
      */
     public static boolean hasAnyPermission(Object object, Permission[] permissions) throws IOException, ServletException {
         if (permissions == null || permissions.length == 0) {

core/src/main/java/hudson/Launcher.java

@@ -116,7 +116,7 @@ protected Launcher(@NonNull Launcher launcher) {
      * @param run The run that requested the command interpretation, could be <code>null</code> if outside of a run context.
      * @param builder The builder that asked to run this command
      *
-     * @since TODO
+     * @since 2.246
      */
     @Restricted(Beta.class)
     public void prepareFilterRules(@CheckForNull Run<?,?> run, @NonNull EnvVarsFilterableBuilder builder){
@@ -483,7 +483,7 @@ public ProcStarter writeStdin() {
         /**
          * Specify the build step that want to run the command to enable the environment filters
          * @return {@code this}
-         * @since TODO
+         * @since 2.246
          */
         @Restricted(Beta.class)
         public ProcStarter buildStep(EnvVarsFilterableBuilder envVarsFilterableBuilder){
@@ -493,7 +493,7 @@ public ProcStarter buildStep(EnvVarsFilterableBuilder envVarsFilterableBuilder){
 
         /**
          * @return if set, returns the build step that wants to run the command
-         * @since TODO
+         * @since 2.246
          */
         @Restricted(Beta.class)
         public @CheckForNull

core/src/main/java/hudson/PluginManager.java

@@ -2242,7 +2242,7 @@ private PluginUpdateInfo(String pluginName, String message) {
     /**
      * {@link AdministrativeMonitor} that checks if there are any plugins that are deprecated.
      *
-     * @since TODO
+     * @since 2.246
      */
     @Restricted(NoExternalUse.class)
     @Symbol("pluginDeprecation")

core/src/main/java/hudson/PluginWrapper.java

@@ -368,7 +368,7 @@ public boolean hasMandatoryDependencies() {
      * Is this plugin deprecated?
      *
      * @return {@code true} if and only if an update site reports deprecations for this plugin.
-     * @since TODO
+     * @since 2.246
      */
     @Restricted(NoExternalUse.class)
     public boolean isDeprecated() {

core/src/main/java/hudson/model/AbstractProject.java

@@ -2080,7 +2080,7 @@ public static abstract class LabelValidator implements ExtensionPoint {
          * @param label The label that the job wants to restrict itself to.
          * @return The validation result.
          *
-         * @since TODO
+         * @since 2.243
          */
         @NonNull
         public FormValidation checkItem(@NonNull Item item, @NonNull Label label) {

core/src/main/java/hudson/model/DownloadService.java

@@ -281,7 +281,7 @@ public String getId() {
          * @param clazz The class to use to generate an ID.
          * @return The ID generated based on the specified class.
          *
-         * @since TODO
+         * @since 2.244
          */
         @NonNull
         public static String idFor(@NonNull Class<?> clazz) {
@@ -460,7 +460,7 @@ public static ExtensionList<Downloadable> all() {
          *
          * @param clazz The class to use to determine the downloadable's ID.
          *
-         * @since TODO
+         * @since 2.244
          */
         @CheckForNull
         public static Downloadable get(@NonNull Class<?> clazz) {

core/src/main/java/hudson/model/Fingerprint.java

@@ -1192,7 +1192,7 @@ public int size() {
     /**
      * Returns the persisted facets.
      *
-     * @since TODO
+     * @since 2.242
      */
     public final @NonNull PersistedList<FingerprintFacet> getPersistedFacets() {
         return facets;
@@ -1359,7 +1359,7 @@ public Api getApi() {
     /**
      * Deletes the {@link Fingerprint} in the Storage with the given unique id.
      *
-     * @since TODO
+     * @since 2.242
      */
     public static void delete(@NonNull String id) throws IOException {
         FingerprintStorage.get().delete(id);

core/src/main/java/hudson/model/ParameterDefinition.java

@@ -227,7 +227,7 @@ public ParameterValue getDefaultParameterValue() {
 
     /**
      * Checks whether a given value is valid for this definition.
-     * @since TODO
+     * @since 2.244
      * @param value The value to validate.
      * @return True if the value is valid for this definition. False if it is invalid.
      */

core/src/main/java/hudson/model/UpdateSite.java

@@ -562,7 +562,7 @@ public final class Data {
         /**
          * Mapping of plugin IDs to deprecation notices
          *
-         * @since TODO
+         * @since 2.246
          */
         private final Map<String, Deprecation> deprecations = new HashMap<>();
 
@@ -650,7 +650,7 @@ public Set<Warning> getWarnings() {
         /**
          * Returns the deprecations provided by the update site
          * @return the deprecations provided by the update site
-         * @since TODO
+         * @since 2.246
          */
         @Restricted(NoExternalUse.class)
         public Map<String, Deprecation> getDeprecations() {
@@ -842,7 +842,7 @@ public boolean includes(VersionNumber number) {
     /**
      * Represents a deprecation of a certain component. Jenkins project policy determines exactly what it means.
      *
-     * @since TODO
+     * @since 2.246
      */
     @Restricted(NoExternalUse.class)
     public static final class Deprecation {

core/src/main/java/hudson/model/labels/LabelExpression.java

@@ -234,7 +234,7 @@ public LabelOperatorPrecedence precedence() {
      *
      * @param label The (partial) label for which auto-completion is being requested.
      * @return A set of auto-completion candidates.
-     * @since TODO
+     * @since 2.243
      */
     @NonNull
     public static AutoCompletionCandidates autoComplete(@Nullable String label) {
@@ -256,7 +256,7 @@ public static AutoCompletionCandidates autoComplete(@Nullable String label) {
      *
      * @param expression The expression to validate.
      * @return The validation result.
-     * @since TODO
+     * @since 2.243
      */
     @NonNull
     public static FormValidation validate(@Nullable String expression) {
@@ -270,7 +270,7 @@ public static FormValidation validate(@Nullable String expression) {
      * @param item       The context item (like a job or a folder), if applicable; used for potential additional
      *                   restrictions via {@link LabelValidator} instances.
      * @return The validation result.
-     * @since TODO
+     * @since 2.243
      */
     // FIXME: Should the messages be moved, or kept where they are for backward compatibility?
     @NonNull

core/src/main/java/hudson/slaves/WorkspaceList.java

@@ -312,7 +312,7 @@ public static FilePath tempDir(FilePath ws) {
 
     /**
      * The token that combines the project name and unique number to create unique workspace directory.
-     * @since TODO
+     * @since 2.244
      */
     public static final String COMBINATOR = SystemProperties.getString(WorkspaceList.class.getName(),"@");
 }

core/src/main/java/hudson/tasks/BatchFile.java

@@ -59,7 +59,7 @@ public BatchFile(String command) {
     /**
      * Set local environment variable filter rules
      * @param configuredLocalRules list of local environment filter rules
-     * @since TODO
+     * @since 2.246
      */
     @Restricted(Beta.class)
     @DataBoundSetter

core/src/main/java/hudson/tasks/Shell.java

@@ -71,7 +71,7 @@ public Shell(String command) {
     /**
      * Set local environment variable filter rules
      * @param configuredLocalRules list of local environment filter rules
-     * @since TODO
+     * @since 2.246
      */
     @Restricted(Beta.class)
     @DataBoundSetter

core/src/main/java/jenkins/fingerprints/FingerprintStorage.java

@@ -102,14 +102,14 @@ public static FingerprintStorage getFileFingerprintStorage() {
      * For reference, see {@link FileFingerprintStorage#iterateAndCleanupFingerprints(TaskListener)}
      * For cleaning up the fingerprint {@link #cleanFingerprint(Fingerprint, TaskListener)} may be used.
      *
-     * @since TODO
+     * @since 2.246
      */
     public abstract void iterateAndCleanupFingerprints(TaskListener taskListener);
 
     /**
      * This method performs the cleanup of the given fingerprint.
      *
-     * @since TODO
+     * @since 2.246
      */
     public boolean cleanFingerprint(@NonNull Fingerprint fingerprint, TaskListener taskListener) {
         try {
@@ -140,7 +140,7 @@ protected Fingerprint getFingerprint(Fingerprint fp) throws IOException {
     }
 
     /**
-     * @since TODO
+     * @since 2.246
      */
     @Override public FingerprintStorageDescriptor getDescriptor() {
         return (FingerprintStorageDescriptor) super.getDescriptor();

core/src/main/java/jenkins/model/labels/LabelValidator.java

@@ -10,7 +10,7 @@
  * Plugins may want to contribute additional restrictions on the use of specific labels for specific context items.
  * This extension point allows such restrictions.
  *
- * @since TODO
+ * @since 2.243
  */
 public interface LabelValidator extends ExtensionPoint {
 

core/src/main/java/jenkins/tasks/SimpleBuildStep.java

@@ -100,7 +100,7 @@ default void perform(@NonNull Run<?, ?> run, @NonNull FilePath workspace, @NonNu
      * @param listener a place to send output
      * @throws InterruptedException if the step is interrupted
      * @throws IOException if something goes wrong; use {@link AbortException} for a polite error
-     * @since TODO
+     * @since 2.241
      */
     default void perform(@NonNull Run<?, ?> run, @NonNull FilePath workspace, @NonNull EnvVars env, @NonNull Launcher launcher,
                          @NonNull TaskListener listener) throws InterruptedException, IOException {

core/src/main/java/jenkins/tasks/filters/EnvVarsFilterException.java

@@ -32,7 +32,7 @@
 /**
  * Exception that occurs during the environment filtering process, with helper to track the source.
  *
- * @since TODO
+ * @since 2.246
  */
 @Restricted(Beta.class)
 public class EnvVarsFilterException extends AbortException {

core/src/main/java/jenkins/tasks/filters/EnvVarsFilterGlobalConfiguration.java

@@ -43,7 +43,7 @@
  * Configuration of the filter rules that are applied globally,
  * after filtering which rule applies on which builder
  *
- * @since TODO
+ * @since 2.246
  */
 @Extension
 @Symbol("envVarsFilter")

core/src/main/java/jenkins/tasks/filters/EnvVarsFilterGlobalRule.java

@@ -42,7 +42,7 @@
  *
  * The local rules are applied before the global ones.
  *
- * @since TODO
+ * @since 2.246
  */
 @Restricted(Beta.class)
 public interface EnvVarsFilterGlobalRule extends Describable<EnvVarsFilterGlobalRule>, EnvVarsFilterRule, ExtensionPoint, Serializable {

core/src/main/java/jenkins/tasks/filters/EnvVarsFilterLocalRule.java

@@ -37,7 +37,7 @@
  *
  * The local rules are applied before the global ones.
  *
- * @since TODO
+ * @since 2.246
  */
 @Restricted(Beta.class)
 public interface EnvVarsFilterLocalRule extends Describable<EnvVarsFilterLocalRule>, EnvVarsFilterRule, ExtensionPoint, Serializable {

core/src/main/java/jenkins/tasks/filters/EnvVarsFilterLocalRuleDescriptor.java

@@ -38,7 +38,7 @@
  * if the rule is applicable to a given builder and then applied every time. <p>
  * For global rule it's the inverse, the rule itself determines when it's applicable.
  *
- * @since TODO
+ * @since 2.246
  */
 @Restricted(Beta.class)
 public abstract class EnvVarsFilterLocalRuleDescriptor extends Descriptor<EnvVarsFilterLocalRule> {

core/src/main/java/jenkins/tasks/filters/EnvVarsFilterRuleContext.java

@@ -32,7 +32,7 @@
 /**
  * Information that is used for the environment filtering process.
  *
- * @since TODO
+ * @since 2.246
  */
 @Restricted(Beta.class)
 public class EnvVarsFilterRuleContext {

core/src/main/java/jenkins/tasks/filters/EnvVarsFilterRuleWrapper.java

@@ -40,7 +40,7 @@
 /**
  * Helper class that provide the list of rules (local + global) for a given builder.
  *
- * @since TODO
+ * @since 2.246
  */
 @Restricted(NoExternalUse.class)
 public class EnvVarsFilterRuleWrapper implements Serializable {

core/src/main/java/jenkins/tasks/filters/EnvVarsFilterableBuilder.java

@@ -33,7 +33,7 @@
 /**
  * Builder step that wants to integrate local environment filter rules should implement this interface
  *
- * @since TODO
+ * @since 2.246
  */
 @Restricted(Beta.class)
 public interface EnvVarsFilterableBuilder {

core/src/main/java/jenkins/tasks/filters/impl/RetainVariablesLocalRule.java

@@ -53,7 +53,7 @@
 /**
  * Local rule that removes all the non-retained variables for that step.
  *
- * @since TODO
+ * @since 2.246
  */
 @Restricted(NoExternalUse.class)
 public class RetainVariablesLocalRule implements EnvVarsFilterLocalRule {

core/src/main/java/jenkins/util/SystemProperties.java

@@ -75,7 +75,7 @@
  * <p>While it looks like it on first glance, this cannot be mapped to {@link EnvVars},
  * because {@link EnvVars} is only for build variables, not Jenkins itself variables.
  *
- * @since TODO
+ * @since 2.236
  */
 @SuppressFBWarnings(value = "ST_WRITE_TO_STATIC_FROM_INSTANCE_METHOD", justification = "Currently Jenkins instance may have one ond only one context")
 public class SystemProperties {