Clean up Javadoc for Java 17 (#6250)

This commit is contained in:
Basil Crow authored and GitHub committed 2022-02-04 11:48:34 +00:00
1 parent a95f84d726
commit 0bb63a9adf
7 files changed
+9 -21

No files matched your search

+2 -5
View File
@@ -322,14 +322,11 @@ public class WebAppMain implements ServletContextListener {
/**
* Determines the home directory for Jenkins.
*
* <p>
* We look for a setting that affects the smallest scope first, then bigger ones later.
* <p>We look for a setting that affects the smallest scope first, then bigger ones later.
*
* <p>
* People makes configuration mistakes, so we are trying to be nice
* <p>People make configuration mistakes, so we are trying to be nice
* with those by doing {@link String#trim()}.
*
* <p>
* @return the File alongside with some description to help the user troubleshoot issues
*/
public FileAndDescription getHomeDir(ServletContextEvent event) {
@@ -527,9 +527,6 @@ public abstract class AbstractItem extends Actionable implements Item, HttpDelet
* then it will be loaded, then this method will be invoked
* to perform any implementation-specific work.
*
* <p>
*
*
* @param src
* Item from which it's copied from. The same type as {@code this}. Never null.
*/
+1 -2
View File
@@ -1919,9 +1919,8 @@ public class Queue extends ResourceController implements Saveable {
* amongst all the free executors on all possibly suitable nodes.
* NOTE: To be able to re-use the same node during the next run this key should not change from one run to
* another. You probably want to compute that key based on the job's name.
* <p>
* @return by default: {@link #getFullDisplayName()}
*
* @return by default: {@link #getFullDisplayName()}
* @see hudson.model.LoadBalancer
*/
default String getAffinityKey() { return getFullDisplayName(); }
@@ -33,16 +33,12 @@ import java.util.Random;
/**
* Generates a pseudo-random sequence of integers in the specified range.
*
* <p>
* {@link CronTab} supports tokens like '@daily', which means "do it once a day".
* <p>{@link CronTab} supports tokens like '@daily', which means "do it once a day".
* Exactly which time of the day this gets scheduled is randomized --- randomized
* in the sense that it's spread out when many jobs choose @daily, but it's at
* the same time stable so that every job sticks to a specific time of the day
* even after the configuration is updated.
*
* <p>
*
*
* @author Kohsuke Kawaguchi
* @since 1.448
*/
@@ -67,7 +67,7 @@ import org.springframework.security.core.userdetails.UserDetails;
* This causes the container to perform authentication, but there's no way
* to find out whether the user has been successfully authenticated or not.
* So to find this out, we then redirect the user to
* {@link jenkins.model.Jenkins#doSecured(StaplerRequest, StaplerResponse) {@code /secured/...} page}.
* {@link jenkins.model.Jenkins#doSecured(StaplerRequest, StaplerResponse) /secured/... page}.
*
* <p>
* The handler of the above URL checks if the user is authenticated,
@@ -2983,12 +2983,14 @@ public class Jenkins extends AbstractCIBase implements DirectlyModifiableTopLeve
* Gets the item by its path name from the given context
*
* <h2>Path Names</h2>
* <p>
* If the name starts from '/', like "/foo/bar/zot", then it's interpreted as absolute.
*
* <p>If the name starts from '/', like "/foo/bar/zot", then it's interpreted as absolute.
* Otherwise, the name should be something like "foo/bar" and it's interpreted like
* relative path name in the file system is, against the given context.
*
* <p>For compatibility, as a fallback when nothing else matches, a simple path
* like {@code foo/bar} can also be treated with {@link #getItemByFullName}.
*
* @param context
* null is interpreted as {@link Jenkins}. Base 'directory' of the interpretation.
* @since 1.406
@@ -460,9 +460,6 @@ public abstract class AbstractLazyLoadRunMap<R> extends AbstractMap<Integer, R>
/**
* Finds the build #M where M is nearby the given 'n'.
*
* <p>
*
*
* @param n
* the index to start the search from
* @param d