Fill in since annotations (#8530)

This commit is contained in:
Alexander Brandes authored and GitHub committed 2023-09-28 12:18:18 +02:00
1 parent 8357350e33
commit 58a8f2e018
7 files changed
+14 -14

No files matched your search

@@ -542,7 +542,7 @@ public class LogRecorder extends AbstractModelObject implements Saveable {
/**
* Deletes this log recorder.
* @throws IOException In case anything went wrong while deleting the configuration file.
* @since TODO
* @since 2.425
*/
public void delete() throws IOException {
Jenkins.get().checkPermission(Jenkins.ADMINISTER);
@@ -44,7 +44,7 @@ public class HudsonIsRestarting {
private boolean safeRestart;
/**
* @since TODO
* @since 2.414
*/
public HudsonIsRestarting(boolean safeRestart) {
this.safeRestart = safeRestart;
@@ -61,7 +61,7 @@ public class HudsonIsRestarting {
}
/**
* @since TODO
* @since 2.414
*/
public boolean isSafeRestart() {
return safeRestart;
@@ -36,7 +36,7 @@ import org.kohsuke.args4j.Option;
/**
* Safe Restart Jenkins - do not accept any new jobs and try to pause existing.
*
* @since TODO
* @since 2.414
*/
@Extension
@Restricted(NoExternalUse.class)
@@ -2974,7 +2974,7 @@ public class Jenkins extends AbstractCIBase implements DirectlyModifiableTopLeve
/**
* Returns if the quietingDown is a safe restart.
* @since TODO
* @since 2.414
*/
@Restricted(NoExternalUse.class)
@NonNull
@@ -4161,7 +4161,7 @@ public class Jenkins extends AbstractCIBase implements DirectlyModifiableTopLeve
* @param message Quiet reason that will be visible to user
* @deprecated use {@link #doQuietDown(boolean, int, String, boolean)} instead.
*/
@Deprecated(since = "TODO")
@Deprecated(since = "2.414")
public HttpRedirect doQuietDown(boolean block,
int timeout,
@CheckForNull String message) throws InterruptedException, IOException {
@@ -4176,7 +4176,7 @@ public class Jenkins extends AbstractCIBase implements DirectlyModifiableTopLeve
* @param timeout If non-zero, only block up to the specified number of milliseconds
* @param message Quiet reason that will be visible to user
* @param safeRestart If the quietDown is for a safeRestart
* @since TODO
* @since 2.414
*/
@RequirePOST
public HttpRedirect doQuietDown(@QueryParameter boolean block,
@@ -4607,7 +4607,7 @@ public class Jenkins extends AbstractCIBase implements DirectlyModifiableTopLeve
* @deprecated use {@link #doSafeRestart(StaplerRequest, String)} instead.
*
*/
@Deprecated(since = "TODO")
@Deprecated(since = "2.414")
public HttpResponse doSafeRestart(StaplerRequest req) throws IOException, ServletException, RestartNotSupportedException {
return doSafeRestart(req, null);
}
@@ -4615,7 +4615,7 @@ public class Jenkins extends AbstractCIBase implements DirectlyModifiableTopLeve
/**
* Queues up a safe restart of Jenkins. Jobs have to finish or pause before it can proceed. No new jobs are accepted.
*
* @since TODO
* @since 2.414
*/
public HttpResponse doSafeRestart(StaplerRequest req, @QueryParameter("message") String message) throws IOException, ServletException, RestartNotSupportedException {
checkPermission(MANAGE);
@@ -4676,7 +4676,7 @@ public class Jenkins extends AbstractCIBase implements DirectlyModifiableTopLeve
* @since 1.332
* @deprecated use {@link #safeRestart(String)} instead.
*/
@Deprecated(since = "TODO")
@Deprecated(since = "2.414")
public void safeRestart() throws RestartNotSupportedException {
safeRestart(null);
}
@@ -4684,7 +4684,7 @@ public class Jenkins extends AbstractCIBase implements DirectlyModifiableTopLeve
/**
* Queues up a restart to be performed once there are no builds currently running.
* @param message the message to show to users in the shutdown banner.
* @since TODO
* @since 2.414
*/
public void safeRestart(String message) throws RestartNotSupportedException {
final Lifecycle lifecycle = restartableLifecycle();
@@ -165,7 +165,7 @@ public interface ModelObjectWithContextMenu extends ModelObject {
return this;
}
/** @since TODO */
/** @since 2.415 */
public ContextMenu add(String url, String icon, String iconXml, String text, boolean post, boolean requiresConfirmation, Badge badge, String message) {
if (text != null && icon != null && url != null) {
MenuItem item = new MenuItem(url, icon, text);