Update Javadoc @since for API additions (#6331)

This commit is contained in:
Mark Waite authored and GitHub committed 2022-03-05 07:35:43 -08:00
1 parent 5a3f295f44
commit fa4e71edaa
10 files changed
+11 -11

No files matched your search

+1 -1
View File
@@ -3042,7 +3042,7 @@ public final class FilePath implements SerializableOnlyOverRemoting {
/**
* Same as {@link #validateAntFileMask(String, int, boolean)} with the default number of operations.
* @see #VALIDATE_ANT_FILE_MASK_BOUND
* @since TODO
* @since 2.325
*/
public String validateAntFileMask(final String fileMasks, final boolean caseSensitive) throws IOException, InterruptedException {
return validateAntFileMask(fileMasks, VALIDATE_ANT_FILE_MASK_BOUND, caseSensitive);
@@ -304,7 +304,7 @@ public abstract class Lifecycle implements ExtensionPoint {
* @param timeout The amount by which to extend the timeout.
* @param unit The time unit of the timeout argument.
*
* @since TODO
* @since 2.335
*/
public void onExtendTimeout(long timeout, @NonNull TimeUnit unit) {}
@@ -1911,7 +1911,7 @@ public class UpdateCenter extends AbstractModelObject implements Saveable, OnMas
* metadata.
*
* @return the expected size, or -1 if unknown.
* @since TODO
* @since 2.325
*/
public long getContentLength() {
return -1;
@@ -801,7 +801,7 @@ public class UpdateSite {
* Size of the file being advertised in bytes, or {@code null} if unspecified/unknown.
* @return size of the file if known, {@code null} otherwise.
*
* @since TODO
* @since 2.325
*/
// @Exported -- TODO unsure
@Restricted(NoExternalUse.class)
@@ -45,7 +45,7 @@ import org.kohsuke.accmod.restrictions.NoExternalUse;
*
* @author Kohsuke Kawaguchi
* @see Scrambler
* @since 1.162 and restricted since TODO
* @since 1.162 and restricted since 2.236
*/
@Restricted(NoExternalUse.class)
@RestrictedSince("2.236")
@@ -2657,7 +2657,7 @@ public class Jenkins extends AbstractCIBase implements DirectlyModifiableTopLeve
* Set the LogRecorderManager.
*
* @param log the LogRecorderManager to set
* @since TODO
* @since 2.323
*/
public void setLog(LogRecorderManager log) {
checkPermission(ADMINISTER);
@@ -133,7 +133,7 @@ public interface ModelObjectWithContextMenu extends ModelObject {
return this;
}
/** @since TODO */
/** @since 2.335 */
public ContextMenu add(String url, String icon, String iconXml, String text, boolean post, boolean requiresConfirmation) {
if (text != null && icon != null && url != null) {
MenuItem item = new MenuItem(url, icon, text);
@@ -160,7 +160,7 @@ public abstract class Telemetry implements ExtensionPoint {
* Produces a list of Jenkins core and plugin version numbers
* to include in telemetry implementations for which this would be relevant.
* @return a map in a format suitable for a value of {@link #createContent}
* @since TODO
* @since 2.325
*/
protected final Map<String, String> buildComponentInformation() {
Map<String, String> components = new TreeMap<>();
@@ -34,7 +34,7 @@ import org.springframework.security.core.Authentication;
/**
* Utilities for working with listener interfaces.
* @since TODO
* @since 2.324
*/
public class Listeners {
@@ -50,7 +50,7 @@ public class Listeners {
* because they were sometimes triggered by user actions such as configuration changes;
* this is an antipattern (better to pass an explicit {@link Authentication} argument if relevant).
* @param notification a listener method, perhaps with arguments
* @since TODO
* @since 2.325
*/
public static <L> void notify(Class<L> listenerType, boolean asSystem, Consumer<L> notification) {
Runnable r = () -> {
+1 -1
View File
@@ -24,7 +24,7 @@ import org.kohsuke.accmod.restrictions.NoExternalUse;
* @see PartialHeader
* @see FullHeader
* @see JenkinsHeader
* @since TODO
* @since 2.323
*/
public abstract class Header implements ExtensionPoint {