Skip to content

Commit

Permalink
Update javadoc and other docs with dates of API changes (#9396)
Browse files Browse the repository at this point in the history
Several of the changes are not detected by the Python script but were
detected by `git grep TODO | grep since` with review of the output.

The cases that are not detected by the Python script seem obscure enough
to not bother with additions to the script.  If they become common
practice, then we can extend the Python script.
  • Loading branch information
MarkEWaite committed Jun 17, 2024
1 parent 82a37a7 commit d99b83b
Show file tree
Hide file tree
Showing 7 changed files with 15 additions and 15 deletions.
10 changes: 5 additions & 5 deletions core/src/main/java/hudson/ClassicPluginStrategy.java
Original file line number Diff line number Diff line change
Expand Up @@ -269,25 +269,25 @@ public static List<PluginWrapper.Dependency> getImpliedDependencies(String plugi
}

/**
* @deprecated since TODO use {@link #createClassLoader(String, List, ClassLoader, Attributes)}
* @deprecated since 2.459 use {@link #createClassLoader(String, List, ClassLoader, Attributes)}
*/
@Deprecated(since = "TODO")
@Deprecated(since = "2.459")
protected ClassLoader createClassLoader(List<File> paths, ClassLoader parent) throws IOException {
return createClassLoader(paths, parent, null);
}

/**
* @deprecated since TODO use {@link #createClassLoader(String, List, ClassLoader, Attributes)}
* @deprecated since 2.459 use {@link #createClassLoader(String, List, ClassLoader, Attributes)}
*/
@Deprecated(since="TODO")
@Deprecated(since="2.459")
protected ClassLoader createClassLoader(List<File> paths, ClassLoader parent, Attributes atts) throws IOException {
// generate a legacy id so at least we can track to something
return createClassLoader("unidentified-" + UUID.randomUUID(), paths, parent, atts);
}

/**
* Creates a classloader that can load all the specified jar files and delegate to the given parent.
* @since TODO
* @since 2.459
*/
protected ClassLoader createClassLoader(String name, List<File> paths, ClassLoader parent, Attributes atts) throws IOException {
boolean usePluginFirstClassLoader =
Expand Down
2 changes: 1 addition & 1 deletion core/src/main/java/hudson/model/ExecutorListener.java
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@
/**
* A listener for task related events from executors.
* A {@link Computer#getRetentionStrategy} or {@link SlaveComputer#getLauncher} may implement this interface.
* Or you may create an implementation as an extension (since TODO).
* Or you may create an implementation as an extension (since 2.318).
* @author Stephen Connolly
* @since 1.312
*/
Expand Down
2 changes: 1 addition & 1 deletion core/src/main/java/jenkins/model/lazy/LazyBuildMixIn.java
Original file line number Diff line number Diff line change
Expand Up @@ -298,7 +298,7 @@ public List<RunT> getEstimatedDurationCandidates() {
/**
* @deprecated Remove any code calling this method, history widget is now created via {@link jenkins.widgets.WidgetFactory} implementation.
*/
@Deprecated(forRemoval = true, since = "TODO")
@Deprecated(forRemoval = true, since = "2.459")
public final HistoryWidget createHistoryWidget() {
throw new IllegalStateException("HistoryWidget is now created via WidgetFactory implementation");
}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@

/**
* Listener notified when a user was requested to changed their seed
* @since 2.160 and 2.150.2, but restricted (unavailable to plugins) before TODO
* @since 2.160 and 2.150.2, but restricted (unavailable to plugins) before 2.406
*/
public abstract class UserSeedChangeListener implements ExtensionPoint {
private static final Logger LOGGER = Logger.getLogger(SecurityListener.class.getName());
Expand Down
8 changes: 4 additions & 4 deletions core/src/main/java/jenkins/util/URLClassLoader2.java
Original file line number Diff line number Diff line change
Expand Up @@ -20,15 +20,15 @@ public class URLClassLoader2 extends URLClassLoader implements JenkinsClassLoade
/**
* @deprecated use {@link URLClassLoader2#URLClassLoader2(String, URL[])}
*/
@Deprecated(since = "TODO")
@Deprecated(since = "2.459")
public URLClassLoader2(URL[] urls) {
super(urls);
}

/**
* @deprecated use {@link URLClassLoader2#URLClassLoader2(String, URL[], ClassLoader)}
*/
@Deprecated(since = "TODO")
@Deprecated(since = "2.459")
public URLClassLoader2(URL[] urls, ClassLoader parent) {
super(urls, parent);
}
Expand All @@ -37,7 +37,7 @@ public URLClassLoader2(URL[] urls, ClassLoader parent) {
* Create a new {@link URLClassLoader2} with the given name and URLS and the {@link #getSystemClassLoader()} as its parent.
* @param name name of this classloader.
* @param urls the list of URLS to find classes in.
* @since TODO
* @since 2.459
*/
public URLClassLoader2(String name, URL[] urls) {
super(name, urls, getSystemClassLoader());
Expand All @@ -48,7 +48,7 @@ public URLClassLoader2(String name, URL[] urls) {
* @param name name of this classloader.
* @param urls the list of URLS to find classes in.
* @param parent the parent to search for classes before we look in the {@code urls}
* @since TODO
* @since 2.459
*/
public URLClassLoader2(String name, URL[] urls, ClassLoader parent) {
super(name, urls, parent);
Expand Down
2 changes: 1 addition & 1 deletion core/src/main/resources/lib/layout/search-bar.jelly
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ THE SOFTWARE.
<st:attribute name="hasKeyboardShortcut">
If false the default keyboard shortcut for the input is disabled. Defaults to true.
</st:attribute>
<st:attribute name="enabled" since="TODO">
<st:attribute name="enabled" since="2.420">
Defaults to true. Sets whether the search bar is enabled or not.
</st:attribute>
Creates a search input
Expand Down
4 changes: 2 additions & 2 deletions core/src/main/resources/lib/layout/task.jelly
Original file line number Diff line number Diff line change
Expand Up @@ -80,7 +80,7 @@ THE SOFTWARE.
<st:attribute name="onclick" deprecated="true">
Onclick inline JS handler. Deprecated, specify data-callback attribute instead.
</st:attribute>
<st:attribute name="data-callback" since="TODO">
<st:attribute name="data-callback" since="2.437">
Name of a global function to call when clicked.
It will be called with an element (currently 'a') as first argument, and the event as second argument.
You can specify further data-* attributes to customize behavior, those will be defined on the element passed as first argument.
Expand All @@ -97,7 +97,7 @@ THE SOFTWARE.
Message to use for confirmation, if requested; defaults to title.
(since 1.512)
</st:attribute>
<st:attribute name="destructive" type="boolean" since="TODO">
<st:attribute name="destructive" type="boolean" since="2.415">
Show red confirmation button.
</st:attribute>
</st:documentation>
Expand Down

0 comments on commit d99b83b

Please sign in to comment.