提交 1c253bb3 编写于 作者: S Stephen Connolly

fix the @since tags

上级 ecac963e
......@@ -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;
......
......@@ -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);
......
......@@ -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 {
......
......@@ -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>
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册