From 1c253bb352dc6d43eb4ee2e64f736b4c5a275873 Mon Sep 17 00:00:00 2001 From: Stephen Connolly Date: Thu, 26 Mar 2015 15:22:33 +0000 Subject: [PATCH] fix the @since tags --- core/src/main/java/hudson/Functions.java | 2 +- core/src/main/java/hudson/model/Computer.java | 12 ++++++------ core/src/main/java/hudson/model/Executor.java | 4 ++-- core/src/main/java/hudson/model/ManagementLink.java | 2 +- core/src/main/java/hudson/model/Queue.java | 2 +- .../src/main/java/hudson/model/labels/LabelAtom.java | 2 +- core/src/main/java/hudson/util/FormValidation.java | 2 +- .../main/java/hudson/util/LineEndingConversion.java | 2 +- .../AsynchronousAdministrativeMonitor.java | 6 +++--- core/src/main/java/jenkins/model/Jenkins.java | 2 +- core/src/main/java/jenkins/model/Nodes.java | 2 +- .../jenkins/model/queue/AsynchronousExecution.java | 2 +- core/src/main/resources/lib/form/link.jelly | 2 +- 13 files changed, 21 insertions(+), 21 deletions(-) diff --git a/core/src/main/java/hudson/Functions.java b/core/src/main/java/hudson/Functions.java index 441f865a24..6c4377652a 100644 --- a/core/src/main/java/hudson/Functions.java +++ b/core/src/main/java/hudson/Functions.java @@ -214,7 +214,7 @@ public class Functions { * so that the generic layouts can avoid iterating extension lists while Jenkins is starting up. * * @return {@code true} if the extensions lists have been populated. - * @since 1.FIXME + * @since 1.607 */ public static boolean isExtensionsAvailable() { final Jenkins jenkins = Jenkins.getInstance(); diff --git a/core/src/main/java/hudson/model/Computer.java b/core/src/main/java/hudson/model/Computer.java index bae120fb36..0d564dd83b 100644 --- a/core/src/main/java/hudson/model/Computer.java +++ b/core/src/main/java/hudson/model/Computer.java @@ -184,7 +184,7 @@ public /*transient*/ abstract class Computer extends Actionable implements Acces /** * Keeps track of stack traces to track the tremination requests for this computer. * - * @since 1.FIXME + * @since 1.607 * @see Executor#resetWorkUnit(String) */ private transient final List terminatedBy = Collections.synchronizedList(new ArrayList @@ -196,7 +196,7 @@ public /*transient*/ abstract class Computer extends Actionable implements Acces * not need to call this method directly, however if implementing a custom node type or a different path * for removing nodes, it may make sense to call this method in order to capture the originating request. * - * @since 1.FIXME + * @since 1.607 */ public void recordTermination() { StaplerRequest request = Stapler.getCurrentRequest(); @@ -227,7 +227,7 @@ public /*transient*/ abstract class Computer extends Actionable implements Acces * * @return the (possibly empty) list of termination requests. * @see Executor#resetWorkUnit(String) - * @since 1.FIXME + * @since 1.607 */ public List getTerminatedBy() { return new ArrayList(terminatedBy); @@ -890,7 +890,7 @@ public /*transient*/ abstract class Computer extends Actionable implements Acces /** * Used to render the list of executors. * @return a snapshot of the executor display information - * @since 1.FIXME + * @since 1.607 */ @Restricted(NoExternalUse.class) public List getDisplayExecutors() { @@ -1527,7 +1527,7 @@ public /*transient*/ abstract class Computer extends Actionable implements Acces * A value class to provide a consistent snapshot view of the state of an executor to avoid race conditions * during rendering of the executors list. * - * @since 1.FIXME + * @since 1.607 */ @Restricted(NoExternalUse.class) public static class DisplayExecutor implements ModelObject { @@ -1598,7 +1598,7 @@ public /*transient*/ abstract class Computer extends Actionable implements Acces /** * Used to trace requests to terminate a computer. * - * @since 1.FIXME + * @since 1.607 */ public static class TerminationRequest extends RuntimeException { private final long when; diff --git a/core/src/main/java/hudson/model/Executor.java b/core/src/main/java/hudson/model/Executor.java index 304071496d..81e097afd4 100644 --- a/core/src/main/java/hudson/model/Executor.java +++ b/core/src/main/java/hudson/model/Executor.java @@ -575,7 +575,7 @@ public class Executor extends Thread implements ModelObject { /** * If currently running in asynchronous mode, returns that handle. - * @since TODO + * @since 1.607 */ public @CheckForNull AsynchronousExecution getAsynchronousExecution() { lock.readLock().lock(); @@ -891,7 +891,7 @@ public class Executor extends Thread implements ModelObject { * @param executable a possibly running executable * @return the executor (possibly a {@link OneOffExecutor}) whose {@link Executor#getCurrentExecutable} matches that, * or null if it could not be found (for example because the execution has already completed) - * @since TODO + * @since 1.607 */ public static @CheckForNull Executor of(Executable executable) { Jenkins jenkins = Jenkins.getInstance(); diff --git a/core/src/main/java/hudson/model/ManagementLink.java b/core/src/main/java/hudson/model/ManagementLink.java index 2594d703e3..4b9fe9524f 100644 --- a/core/src/main/java/hudson/model/ManagementLink.java +++ b/core/src/main/java/hudson/model/ManagementLink.java @@ -117,7 +117,7 @@ public abstract class ManagementLink implements ExtensionPoint, Action { * Define if the rendered link will use the default GET method or POST. * @return true if POST must be used * @see RequirePOST - * @since TODO + * @since 1.584 */ public boolean getRequiresPOST() { return false; diff --git a/core/src/main/java/hudson/model/Queue.java b/core/src/main/java/hudson/model/Queue.java index 4179abb229..d776a57893 100644 --- a/core/src/main/java/hudson/model/Queue.java +++ b/core/src/main/java/hudson/model/Queue.java @@ -990,7 +990,7 @@ public class Queue extends ResourceController implements Saveable { * Gets the information about the queue item for the given project. * * @return null if the project is not in the queue. - * @since 1.FIXME + * @since 1.607 */ private List liveGetItems(Task t) { lock.lock(); diff --git a/core/src/main/java/hudson/model/labels/LabelAtom.java b/core/src/main/java/hudson/model/labels/LabelAtom.java index a420b112d2..91c1f3bd77 100644 --- a/core/src/main/java/hudson/model/labels/LabelAtom.java +++ b/core/src/main/java/hudson/model/labels/LabelAtom.java @@ -116,7 +116,7 @@ public class LabelAtom extends Label implements Saveable { } /** - * @since TODO + * @since 1.580 */ public String getDescription() { return description; diff --git a/core/src/main/java/hudson/util/FormValidation.java b/core/src/main/java/hudson/util/FormValidation.java index ac471cb958..4c52f19b6d 100644 --- a/core/src/main/java/hudson/util/FormValidation.java +++ b/core/src/main/java/hudson/util/FormValidation.java @@ -216,7 +216,7 @@ public abstract class FormValidation extends IOException implements HttpResponse * Aggregate multiple validations into one. * * @return Validation of the least successful kind aggregating all child messages. - * @since TODO + * @since 1.590 */ public static @Nonnull FormValidation aggregate(@Nonnull Collection validations) { if (validations == null || validations.isEmpty()) return FormValidation.ok(); diff --git a/core/src/main/java/hudson/util/LineEndingConversion.java b/core/src/main/java/hudson/util/LineEndingConversion.java index 744ff4a4ea..fbc6496501 100644 --- a/core/src/main/java/hudson/util/LineEndingConversion.java +++ b/core/src/main/java/hudson/util/LineEndingConversion.java @@ -3,7 +3,7 @@ package hudson.util; /** * Converts line endings of a string. * - * @since TODO + * @since 1.582 * @author David Ruhmann */ public class LineEndingConversion { diff --git a/core/src/main/java/jenkins/management/AsynchronousAdministrativeMonitor.java b/core/src/main/java/jenkins/management/AsynchronousAdministrativeMonitor.java index f5a0da69a2..766f036bbb 100644 --- a/core/src/main/java/jenkins/management/AsynchronousAdministrativeMonitor.java +++ b/core/src/main/java/jenkins/management/AsynchronousAdministrativeMonitor.java @@ -115,10 +115,10 @@ public abstract class AsynchronousAdministrativeMonitor extends AdministrativeMo } } } - + /** - * Runs the monitor and encapsulates all errors within. - * @since TODO: define a version + * Runs the monitor and encapsulates all errors within. + * @since 1.590 */ private void doRun(@Nonnull TaskListener listener) { try { diff --git a/core/src/main/java/jenkins/model/Jenkins.java b/core/src/main/java/jenkins/model/Jenkins.java index 2404f27fb4..8694f7a1f7 100644 --- a/core/src/main/java/jenkins/model/Jenkins.java +++ b/core/src/main/java/jenkins/model/Jenkins.java @@ -507,7 +507,7 @@ public class Jenkins extends AbstractCIBase implements DirectlyModifiableTopLeve /** * The holder of the set of installed cluster nodes. * - * @since 1.FIXME + * @since 1.607 */ private transient final Nodes nodes = new Nodes(this); diff --git a/core/src/main/java/jenkins/model/Nodes.java b/core/src/main/java/jenkins/model/Nodes.java index 9ba4ad245f..0d04b88949 100644 --- a/core/src/main/java/jenkins/model/Nodes.java +++ b/core/src/main/java/jenkins/model/Nodes.java @@ -58,7 +58,7 @@ import java.util.logging.Logger; /** * Manages all the nodes for Jenkins. * - * @since 1.FIXME + * @since 1.607 */ @Restricted(NoExternalUse.class) // for now, we may make it public later public class Nodes implements Saveable { diff --git a/core/src/main/java/jenkins/model/queue/AsynchronousExecution.java b/core/src/main/java/jenkins/model/queue/AsynchronousExecution.java index 18534044ad..e75a12e295 100644 --- a/core/src/main/java/jenkins/model/queue/AsynchronousExecution.java +++ b/core/src/main/java/jenkins/model/queue/AsynchronousExecution.java @@ -51,7 +51,7 @@ import org.kohsuke.accmod.restrictions.NoExternalUse; * but could also be used with a heavyweight executor even though the number of executors is bounded by node configuration. *

{@link ResourceController}/{@link ResourceActivity}/{@link ResourceList}/{@link Resource} are not currently supported. * Nor are {@link hudson.model.Queue.Task#getSubTasks} other than the primary task. - * @since TODO + * @since 1.607 */ public abstract class AsynchronousExecution extends RuntimeException { diff --git a/core/src/main/resources/lib/form/link.jelly b/core/src/main/resources/lib/form/link.jelly index b0e065561f..ce211fb3d3 100644 --- a/core/src/main/resources/lib/form/link.jelly +++ b/core/src/main/resources/lib/form/link.jelly @@ -28,7 +28,7 @@ THE SOFTWARE. Generates an anchor element with the ability to send POST requests and/or asynchronous requests. It depends the combination of post and async attributes. - @since TODO + @since 1.584 Additional CSS classes. -- GitLab