提交 01d79315 编写于 作者: S Stephen Connolly

Fix @since TODO and @since FIXME tags

上级 b6e4fb4b
......@@ -136,7 +136,7 @@ public abstract class AbstractItem extends Actionable implements Item, HttpDelet
/**
* Gets the term used in the UI to represent the kind of {@link Queue.Task} associated with this kind of
* {@link Item}. Must start with a capital letter. Defaults to "Build".
* @since FIXME
* @since2.50
*/
public String getTaskNoun() {
return AlternativeUiTextProvider.get(TASK_NOUN, this, Messages.AbstractItem_TaskNoun());
......
......@@ -85,7 +85,7 @@ public class Items {
* If you are replacing {@link #getAllItems(ItemGroup, Class)} with {@link #allItems(ItemGroup, Class)} and
* need to restore the sort order of a further filtered result, you probably want {@link #BY_FULL_NAME}.
*
* @since FIXME
* @since 2.37
*/
public static final Comparator<Item> BY_NAME = new Comparator<Item>() {
@Override public int compare(Item i1, Item i2) {
......@@ -103,7 +103,7 @@ public class Items {
/**
* A comparator of {@link Item} instances that uses a case-insensitive comparison of {@link Item#getFullName()}.
*
* @since FIXME
* @since 2.37
*/
public static final Comparator<Item> BY_FULL_NAME = new Comparator<Item>() {
@Override public int compare(Item i1, Item i2) {
......@@ -430,7 +430,7 @@ public class Items {
* @param type the type.
* @param <T> the type.
* @return An {@link Iterable} for all items.
* @since FIXME
* @since 2.37
*/
public static <T extends Item> Iterable<T> allItems(ItemGroup root, Class<T> type) {
return allItems(Jenkins.getAuthentication(), root, type);
......@@ -448,7 +448,7 @@ public class Items {
* @param type the type.
* @param <T> the type.
* @return An {@link Iterable} for all items.
* @since FIXME
* @since 2.37
*/
public static <T extends Item> Iterable<T> allItems(Authentication authentication, ItemGroup root, Class<T> type) {
return new AllItemsIterable<>(root, authentication, type);
......
......@@ -458,7 +458,7 @@ public abstract class Node extends AbstractModelObject implements Reconfigurable
*
* @return null if the property is not configured
*
* @since TODO
* @since 2.37
*/
@CheckForNull
public <T extends NodeProperty> T getNodeProperty(Class<T> clazz)
......@@ -479,7 +479,7 @@ public abstract class Node extends AbstractModelObject implements Reconfigurable
*
* @return null if the property is not configured
*
* @since TODO
* @since 2.37
*/
@CheckForNull
public NodeProperty getNodeProperty(String className)
......
......@@ -75,7 +75,7 @@ public class ParametersAction implements RunAction2, Iterable<ParameterValue>, Q
* If null, and they are not safe, it will log a warning in logs to the user
* to let him choose the behavior
*
* @since TODO
* @since 2.3
*/
@Restricted(NoExternalUse.class)
public static final String KEEP_UNDEFINED_PARAMETERS_SYSTEM_PROPERTY_NAME = ParametersAction.class.getName() +
......
......@@ -526,7 +526,7 @@ public class UpdateSite {
/**
* List of warnings (mostly security) published with the update site.
*
* @since TODO
* @since 2.40
*/
private final Set<Warning> warnings = new HashSet<Warning>();
......@@ -576,7 +576,7 @@ public class UpdateSite {
/**
* Returns the set of warnings
* @return the set of warnings
* @since TODO
* @since 2.40
*/
@Restricted(NoExternalUse.class)
public Set<Warning> getWarnings() {
......@@ -692,7 +692,7 @@ public class UpdateSite {
*
* The {@link #pattern} is used to determine whether a given warning applies to the current installation.
*
* @since TODO
* @since 2.40
*/
@Restricted(NoExternalUse.class)
public static final class WarningVersionRange {
......@@ -745,7 +745,7 @@ public class UpdateSite {
* @see UpdateSiteWarningsConfiguration
* @see jenkins.security.UpdateSiteWarningsMonitor
*
* @since TODO
* @since 2.40
*/
@Restricted(NoExternalUse.class)
public static final class Warning {
......@@ -1128,7 +1128,7 @@ public class UpdateSite {
}
/**
* @since TODO
* @since 2.40
*/
@CheckForNull
@Restricted(NoExternalUse.class)
......@@ -1163,7 +1163,7 @@ public class UpdateSite {
}
/**
* @since TODO
* @since 2.40
*/
@Restricted(DoNotUse.class)
public boolean hasWarnings() {
......
......@@ -46,7 +46,7 @@ import java.util.Calendar;
*
* @see CronTab#floor(Calendar)
* @see CronTab#ceil(Calendar)
* @since TODO
* @since 2.49
*/
@Restricted(NoExternalUse.class)
public class RareOrImpossibleDateException extends RuntimeException {
......
......@@ -70,7 +70,7 @@ public abstract class CloudProvisioningListener implements ExtensionPoint {
* @param plannedNode the plannedNode which resulted in the <code>node</code> being provisioned
* @param node the node which has been provisioned by the cloud
*
* @since TODO
* @since 2.37
*/
public void onCommit(@Nonnull NodeProvisioner.PlannedNode plannedNode, @Nonnull Node node) {
// Noop by default
......@@ -93,7 +93,7 @@ public abstract class CloudProvisioningListener implements ExtensionPoint {
* @param node the node which has been provisioned by the cloud
* @param t the exception
*
* @since TODO
* @since 2.37
*/
public void onRollback(@Nonnull NodeProvisioner.PlannedNode plannedNode, @Nonnull Node node,
@Nonnull Throwable t) {
......
......@@ -83,7 +83,7 @@ public class RunList<R extends Run> extends AbstractList<R> {
* @param <J> the base class of job.
* @param <R> the base class of run.
* @return the run list.
* @since FIXME
* @since 2.37
*/
public static <J extends Job<J,R>, R extends Run<J,R>> RunList<R> fromJobs(Iterable<? extends J> jobs) {
List<Iterable<R>> runLists = new ArrayList<>();
......
......@@ -1736,7 +1736,7 @@ public class Jenkins extends AbstractCIBase implements DirectlyModifiableTopLeve
* Gets all the {@link Item}s unordered, lazily and recursively in the {@link ItemGroup} tree
* and filter them by the given type.
*
* @since FIXME
* @since 2.37
*/
public <T extends Item> Iterable<T> allItems(Class<T> type) {
return Items.allItems(this, type);
......@@ -1754,7 +1754,7 @@ public class Jenkins extends AbstractCIBase implements DirectlyModifiableTopLeve
/**
* Gets all the items unordered, lazily and recursively.
*
* @since FIXME
* @since 2.37
*/
public Iterable<Item> allItems() {
return allItems(Item.class);
......@@ -4463,7 +4463,7 @@ public class Jenkins extends AbstractCIBase implements DirectlyModifiableTopLeve
* http://wiki.jenkins-ci.org/display/JENKINS/Tomcat#Tomcat-i18n
*/
@Restricted(NoExternalUse.class)
@RestrictedSince("since TODO")
@RestrictedSince("2.37")
@Deprecated
public FormValidation doCheckURIEncoding(StaplerRequest request) throws IOException {
return ExtensionList.lookup(URICheckEncodingMonitor.class).get(0).doCheckURIEncoding(request);
......@@ -4473,7 +4473,7 @@ public class Jenkins extends AbstractCIBase implements DirectlyModifiableTopLeve
* Does not check when system default encoding is "ISO-8859-1".
*/
@Restricted(NoExternalUse.class)
@RestrictedSince("since TODO")
@RestrictedSince("2.37")
@Deprecated
public static boolean isCheckURIEncodingEnabled() {
return ExtensionList.lookup(URICheckEncodingMonitor.class).get(0).isCheckEnabled();
......@@ -4570,7 +4570,7 @@ public class Jenkins extends AbstractCIBase implements DirectlyModifiableTopLeve
* Test a path to see if it is subject to mandatory read permission checks by container-managed security
* @param restOfPath the URI, excluding the Jenkins root URI and query string
* @return true if the path is subject to mandatory read permission checks
* @since TODO
* @since 2.37
*/
public boolean isSubjectToMandatoryReadPermissionCheck(String restOfPath) {
for (String name : ALWAYS_READABLE_PATHS) {
......
......@@ -46,7 +46,7 @@ import java.util.Set;
*
* @see UpdateSiteWarningsMonitor
*
* @since TODO
* @since 2.40
*/
@Extension
@Restricted(NoExternalUse.class)
......
......@@ -75,7 +75,7 @@ import java.util.Set;
* <li>Intersection of active and inapplicable
* </ul>
*
* @since TODO
* @since 2.40
*/
@Extension
@Restricted(NoExternalUse.class)
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册