mirror of
https://github.com/jenkinsci/jenkins.git
synced 2026-11-21 15:55:40 +00:00
Clean up Javadoc for Java 17 (#6250)
This commit is contained in:
1 parent
a95f84d726
commit
0bb63a9adf
7 files changed
+9
-21
No files matched your search
@@ -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.
|
||||
*/
|
||||
|
||||
@@ -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
|
||||
|
||||
Reference in new issue
Block a user