diff --git a/core/src/main/java/hudson/WebAppMain.java b/core/src/main/java/hudson/WebAppMain.java index 04d9aae1aa..c63e1f813a 100644 --- a/core/src/main/java/hudson/WebAppMain.java +++ b/core/src/main/java/hudson/WebAppMain.java @@ -322,14 +322,11 @@ public class WebAppMain implements ServletContextListener { /** * Determines the home directory for Jenkins. * - *

- * We look for a setting that affects the smallest scope first, then bigger ones later. + *

We look for a setting that affects the smallest scope first, then bigger ones later. * - *

- * People makes configuration mistakes, so we are trying to be nice + *

People make configuration mistakes, so we are trying to be nice * with those by doing {@link String#trim()}. * - *

* @return the File alongside with some description to help the user troubleshoot issues */ public FileAndDescription getHomeDir(ServletContextEvent event) { diff --git a/core/src/main/java/hudson/model/AbstractItem.java b/core/src/main/java/hudson/model/AbstractItem.java index 458718e89a..c60530639c 100644 --- a/core/src/main/java/hudson/model/AbstractItem.java +++ b/core/src/main/java/hudson/model/AbstractItem.java @@ -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. * - *

- * - * * @param src * Item from which it's copied from. The same type as {@code this}. Never null. */ diff --git a/core/src/main/java/hudson/model/Queue.java b/core/src/main/java/hudson/model/Queue.java index e0abed68cc..50ad97232b 100644 --- a/core/src/main/java/hudson/model/Queue.java +++ b/core/src/main/java/hudson/model/Queue.java @@ -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. - *

- * @return by default: {@link #getFullDisplayName()} * + * @return by default: {@link #getFullDisplayName()} * @see hudson.model.LoadBalancer */ default String getAffinityKey() { return getFullDisplayName(); } diff --git a/core/src/main/java/hudson/scheduler/Hash.java b/core/src/main/java/hudson/scheduler/Hash.java index eb69cfda04..86520ed87f 100644 --- a/core/src/main/java/hudson/scheduler/Hash.java +++ b/core/src/main/java/hudson/scheduler/Hash.java @@ -33,16 +33,12 @@ import java.util.Random; /** * Generates a pseudo-random sequence of integers in the specified range. * - *

- * {@link CronTab} supports tokens like '@daily', which means "do it once a day". + *

{@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. * - *

- * - * * @author Kohsuke Kawaguchi * @since 1.448 */ diff --git a/core/src/main/java/hudson/security/BasicAuthenticationFilter.java b/core/src/main/java/hudson/security/BasicAuthenticationFilter.java index 924c77e25c..dd29dc3004 100644 --- a/core/src/main/java/hudson/security/BasicAuthenticationFilter.java +++ b/core/src/main/java/hudson/security/BasicAuthenticationFilter.java @@ -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}. * *

* The handler of the above URL checks if the user is authenticated, diff --git a/core/src/main/java/jenkins/model/Jenkins.java b/core/src/main/java/jenkins/model/Jenkins.java index 33d3295ab8..5e6b074be6 100644 --- a/core/src/main/java/jenkins/model/Jenkins.java +++ b/core/src/main/java/jenkins/model/Jenkins.java @@ -2983,12 +2983,14 @@ public class Jenkins extends AbstractCIBase implements DirectlyModifiableTopLeve * Gets the item by its path name from the given context * *

Path Names

- *

- * If the name starts from '/', like "/foo/bar/zot", then it's interpreted as absolute. + * + *

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. + * *

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 diff --git a/core/src/main/java/jenkins/model/lazy/AbstractLazyLoadRunMap.java b/core/src/main/java/jenkins/model/lazy/AbstractLazyLoadRunMap.java index afa608fce5..c601ffc77d 100644 --- a/core/src/main/java/jenkins/model/lazy/AbstractLazyLoadRunMap.java +++ b/core/src/main/java/jenkins/model/lazy/AbstractLazyLoadRunMap.java @@ -460,9 +460,6 @@ public abstract class AbstractLazyLoadRunMap extends AbstractMap /** * Finds the build #M where M is nearby the given 'n'. * - *

- * - * * @param n * the index to start the search from * @param d