Fix various Javadoc warnings

Issue: SPR-10128

spring-aop/src/test/java/org/springframework/aop/aspectj/AspectJExpressionPointcutTests.java

@@ -121,8 +121,8 @@ public final class AspectJExpressionPointcutTests {
 
 	/**
 	 * This and target are equivalent. Really instanceof pointcuts.
-	 * @throws Exception
 	 * @param which this or target
+	 * @throws Exception
 	 * @throws NoSuchMethodException
 	 * @throws SecurityException
 	 */
@@ -367,4 +367,4 @@ class CallCountingInterceptor implements MethodInterceptor {
 		this.count = 0;
 	}
 
-}
+}

spring-aspects/src/main/java/org/springframework/mock/staticmock/AbstractMethodMockingControl.aj

@@ -106,7 +106,7 @@ public abstract aspect AbstractMethodMockingControl percflow(mockStaticsTestMeth
 		 * Validate the call and provide the expected return value
 		 * @param lastSig
 		 * @param args
-		 * @return
+		 * @return the return value
 		 */
 		public Object respond(String lastSig, Object[] args) {
 			Call call = nextCall();

spring-beans/src/test/java/org/springframework/beans/factory/support/BeanFactoryGenericsTests.java

@@ -630,8 +630,8 @@ public class BeanFactoryGenericsTests {
 	 * public static <T> T createMock(Class<T> toMock)
 	 * }</pre>
 	 *
+	 * See SPR-9493
 	 * @since 3.2
-	 * @see SPR-9493
 	 */
 	@Test
 	public void parameterizedFactoryMethod() {

spring-context/src/main/java/org/springframework/ejb/support/AbstractStatelessSessionBean.java

@@ -81,16 +81,16 @@ public abstract class AbstractStatelessSessionBean extends AbstractSessionBean {
 
 
 	/**
-	 * @see javax.ejb.SessionBean#ejbActivate(). This method always throws an exception, as
+	 * This method always throws an exception, as it should not be invoked by the EJB container.
-	 * it should not be invoked by the EJB container.
+	 * @see javax.ejb.SessionBean#ejbActivate()
 	 */
 	public void ejbActivate() throws EJBException {
 		throw new IllegalStateException("ejbActivate must not be invoked on a stateless session bean");
 	}
 
 	/**
-	 * @see javax.ejb.SessionBean#ejbPassivate(). This method always throws an exception, as
+	 * This method always throws an exception, as it should not be invoked by the EJB container.
-	 * it should not be invoked by the EJB container.
+	 * @see javax.ejb.SessionBean#ejbPassivate()
 	 */
 	public void ejbPassivate() throws EJBException {
 		throw new IllegalStateException("ejbPassivate must not be invoked on a stateless session bean");

spring-context/src/test/java/org/springframework/aop/framework/autoproxy/AdvisorAutoProxyCreatorTests.java

@@ -41,7 +41,7 @@ import test.mixin.Lockable;
 /**
  * Tests for auto proxy creation by advisor recognition.
  *
- * @see org.springframework.aop.framework.autoproxy.AdvisorAutoProxyCreatorIntegrationTests;
+ * @see org.springframework.aop.framework.autoproxy.AdvisorAutoProxyCreatorIntegrationTests
  *
  * @author Rod Johnson
  * @author Dave Syer

spring-core/src/main/java/org/springframework/core/env/Environment.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2011 the original author or authors.
+ * Copyright 2002-2012 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -102,8 +102,8 @@ public interface Environment extends PropertyResolver {
 	 * explicit active profiles, whether one or more of the given profiles is included in
 	 * the set of default profiles. If a profile begins with '!' the logic is inverted,
 	 * i.e. the method will return true if the given profile is <em>not</em> active. For
-	 * example, {@code env.acceptsProfiles("p1", "!p2")} will return true if profile 'p1'
+	 * example, <pre>env.acceptsProfiles("p1", "!p2")</pre> will return true if profile
-	 * is active or 'p2' is not active.
+	 * 'p1' is active or 'p2' is not active.
 	 * @throws IllegalArgumentException if called with zero arguments
 	 * @throws IllegalArgumentException if any profile is null, empty or whitespace-only
 	 * @see #getActiveProfiles

spring-jdbc/src/main/java/org/springframework/jdbc/core/simple/ParameterizedBeanPropertyRowMapper.java

@@ -36,7 +36,7 @@ import org.springframework.jdbc.core.BeanPropertyRowMapper;
  * float, Float, double, Double, BigDecimal, <code>java.util.Date</code>, etc.
  *
  * <p>The mapper can be configured to use the primitives default value when mapping null values
- * by setting the {@link #setPrimitivesDefaultedForNullValue 'primitivesDefaultedForNullValue'}
+ * by setting the '{@link #setPrimitivesDefaultedForNullValue primitivesDefaultedForNullValue}'
  * flag to 'true'.
  *
  * <p>To facilitate mapping between columns and fields that don't have matching names,

spring-jdbc/src/test/java/org/springframework/jdbc/datasource/init/DatabasePopulatorTests.java

@@ -251,7 +251,7 @@ public class DatabasePopulatorTests {
 	}
 
 	/**
-	 * @see SPR-9457
+	 * See SPR-9457
 	 */
 	@Test
 	public void usesBoundConnectionIfAvailable() throws SQLException {
@@ -269,7 +269,7 @@ public class DatabasePopulatorTests {
 	}
 
 	/**
-	 * @see SPR-9781
+	 * See SPR-9781
 	 */
 	@Test(timeout = 1000)
 	public void executesHugeScriptInReasonableTime() throws SQLException {

spring-webmvc/src/main/java/org/springframework/web/servlet/mvc/method/annotation/package-info.java

@@ -1,9 +1,7 @@
-
 /**
- * MVC infrastructure for annotation-based handler method processing,
+ * MVC infrastructure for annotation-based handler method processing, building on the
- * building on the <code>org.springframework.web.method.annotation</code> package.
+ * {@code org.springframework.web.method.annotation} package. Entry points are
- * Entry points are {@link org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping}
+ * {@link org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping}
  * and {@link org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter}.
  */
 package org.springframework.web.servlet.mvc.method.annotation;
-