Updated javadoc to pass doclint

JDK 1.8 turned on doclint, validating javadoc and subsequently failing
builds when generating javadoc with invalid markup.  This commit
addresses the javadoc errors in this project that cause javadoc
generation to fail.  There are still warnings that need to be addressed,
but this project should now build with JDK 1.8 when generating javadoc.

BATCHADM-216

Author: mminella

spring-batch-admin-domain/src/main/java/org/springframework/batch/admin/domain/StepExecutionInfoResource.java

@@ -93,6 +93,7 @@ public class StepExecutionInfoResource extends ResourceSupport {
 
 	/**
 	 * @param stepExecution Must not be null
+	 * @param timeZone timeZone dates are represented in.
 	 */
 	public StepExecutionInfoResource(StepExecution stepExecution, TimeZone timeZone) {
 		Assert.notNull(stepExecution, "stepExecution must not be null.");

spring-batch-admin-domain/src/main/java/org/springframework/batch/admin/domain/StepExecutionProgressInfoResource.java

@@ -49,6 +49,10 @@ public StepExecutionProgressInfoResource() {
 	 * 
 	 * @param stepExecution Must not be null
 	 * @param stepExecutionHistory Must not be null
+	 * @param percentageComplete percentage of the step that is complete (1.0 = 100%)
+	 * @param isFinished true if the step is finished
+	 * @param duration duration of the step
+	 * @param timeZone time zone dates/times are expressed in
 	 */
 	public StepExecutionProgressInfoResource(StepExecution stepExecution, StepExecutionHistory stepExecutionHistory,
 			double percentageComplete, boolean isFinished, double duration, TimeZone timeZone) {

spring-batch-admin-domain/src/main/java/org/springframework/batch/admin/domain/support/StepExecutionHistoryJacksonMixIn.java

@@ -21,7 +21,7 @@
 import com.fasterxml.jackson.annotation.JsonProperty;
 
 /**
- * Jackson MixIn for {@link org.springframework.batch.admin.history.StepExecutionHistory} de-serialization.
+ * Jackson MixIn for org.springframework.batch.admin.history.StepExecutionHistory de-serialization.
  * 
  * @author Ilayaperumal Gopinathan
  * @since 2.0

spring-batch-admin-manager/src/main/java/org/springframework/batch/admin/web/BatchJobInstancesController.java

@@ -87,6 +87,8 @@ public JobInstanceInfoResource getJobInstance(@PathVariable long instanceId) {
 	/**
 	 * Return a paged collection of job instances for a given job.
 	 *
+	 * @param pageable page request
+	 * @param assembler used to construct resources
 	 * @param jobName name of the batch job
 	 * @return collection of JobInstances by job name
 	 */

spring-batch-admin-manager/src/main/java/org/springframework/batch/admin/web/BatchJobsController.java

@@ -58,6 +58,8 @@ public class BatchJobsController extends AbstractBatchJobsController {
 	 * 
 	 * @param pageable the paging metadata
 	 * @param assembler the paged resource assembler of type {@link org.springframework.batch.admin.domain.DetailedJobInfo}
+	 *
+	 * @return a page of {@link DetailedJobInfoResource}
 	 */
 	@RequestMapping(value = "", method = RequestMethod.GET)
 	@ResponseStatus(HttpStatus.OK)

spring-batch-admin-manager/src/main/java/org/springframework/batch/admin/web/RestControllerAdvice.java

@@ -58,6 +58,10 @@ public class RestControllerAdvice {
 
 	/**
 	 * Handles the case where client submitted an ill valued request (missing parameter).
+	 *
+	 * @param e exception to be handled
+	 *
+	 * @return VndErrors see {@link VndErrors}
 	 */
 	@ExceptionHandler
 	@ResponseStatus(HttpStatus.BAD_REQUEST)
@@ -69,6 +73,10 @@ public VndErrors onMissingServletRequestParameterException(MissingServletRequest
 
 	/**
 	 * Handles the general error case. Report server-side error.
+	 *
+	 * @param e the exception to be handled
+	 *
+	 * @return VndErrors see {@link VndErrors}
 	 */
 	@ExceptionHandler(Exception.class)
 	@ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)