fix the @since tags

This commit is contained in:
Stephen Connolly committed 2015-03-26 15:22:33 +00:00
1 parent ecac963eaf
commit 1c253bb352
13 files changed
+21 -21

No files matched your search

+1 -1
View File
@@ -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();
@@ -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<TerminationRequest> 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<TerminationRequest> getTerminatedBy() {
return new ArrayList<TerminationRequest>(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<DisplayExecutor> 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;
@@ -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();
@@ -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;
+1 -1
View File
@@ -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<Item> liveGetItems(Task t) {
lock.lock();
@@ -116,7 +116,7 @@ public class LabelAtom extends Label implements Saveable {
}
/**
* @since TODO
* @since 1.580
*/
public String getDescription() {
return description;
@@ -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<FormValidation> validations) {
if (validations == null || validations.isEmpty()) return FormValidation.ok();
@@ -3,7 +3,7 @@ package hudson.util;
/**
* Converts line endings of a string.
*
* @since TODO
* @since 1.582
* @author David Ruhmann
*/
public class LineEndingConversion {
@@ -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 {
@@ -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);
+1 -1
View File
@@ -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 {
@@ -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.
* <p>{@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 {
+1 -1
View File
@@ -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
<st:attribute name="clazz">
Additional CSS classes.
</st:attribute>