Updated docs based on code review.

Author: cppwfs

spring-batch-core/src/main/java/org/springframework/batch/core/ExitStatus.java

@@ -75,7 +75,7 @@ public class ExitStatus implements Serializable, Comparable<ExitStatus> {
 	private final String exitDescription;
 
 	/**
-	 * Constructor that accepts the exitCode and sets the exitDescription to an empty {@link String}.
+	 * Constructor that accepts the exit code and sets the exit description to an empty {@link String}.
 	 *
 	 * @param exitCode The exit code to be used for the {@link ExitStatus}.
 	 */
@@ -84,7 +84,7 @@ public ExitStatus(String exitCode) {
 	}
 
 	/**
-	 * Constructor that establishes the exitCode and the exitDescription for the {@link ExitStatus}.
+	 * Constructor that establishes the exit code and the exit description for the {@link ExitStatus}.
 	 *
 	 * @param exitCode The exit code to be used for the {@link ExitStatus}.
 	 * @param exitDescription The exit description to be used for the {@link ExitStatus}.

spring-batch-core/src/main/java/org/springframework/batch/core/JobExecution.java

@@ -102,15 +102,15 @@ public JobExecution(JobInstance job, Long id, @Nullable JobParameters jobParamet
 	/**
 	 * Constructor for transient (unsaved) instances.
 	 *
-	 * @param job The enclosing {@link JobInstance}
+	 * @param job The enclosing {@link JobInstance}.
 	 * @param jobParameters The {@link JobParameters} instance for this JobExecution.
 	 */
 	public JobExecution(JobInstance job, JobParameters jobParameters) {
 		this(job, null, jobParameters);
 	}
 
 	/**
-	 * Constructor that accepts the current job execution ID and {@link JobParameters}.
+	 * Constructor that accepts the job execution ID and {@link JobParameters}.
 	 * @param id The job execution ID.
 	 * @param jobParameters The {@link JobParameters} for the {@link JobExecution}.
 	 */
@@ -119,7 +119,7 @@ public JobExecution(Long id, JobParameters jobParameters) {
 	}
 
 	/**
-	 * Constructor that accepts the current job execution ID.
+	 * Constructor that accepts the job execution ID.
 	 * @param id The job execution ID.
 	 */
 	public JobExecution(Long id) {
@@ -336,7 +336,7 @@ public void setLastUpdated(Date lastUpdated) {
 
 	/**
 	 * Retrieve a list of exceptions.
-	 * @return The {@link List} of {@link Throwable}s.
+	 * @return The {@link List} of {@link Throwable} objects.
 	 */
 	public List<Throwable> getFailureExceptions() {
 		return failureExceptions;

spring-batch-core/src/main/java/org/springframework/batch/core/JobParameters.java

@@ -56,7 +56,7 @@ public JobParameters() {
 	}
 
 	/**
-	 * Constructor that is initialized with content of a {@link Map} that contains a string key and {@link JobParameter} value.
+	 * Constructor that is initialized with the content of a {@link Map} that contains a string key and {@link JobParameter} value.
 	 * @param parameters The {@link Map} that contains a string key and {@link JobParameter} value.
 	 */
 	public JobParameters(Map<String,JobParameter> parameters) {

spring-batch-core/src/main/java/org/springframework/batch/core/Step.java

@@ -25,7 +25,7 @@
 public interface Step {
 
 	/**
-	 * The key to retrieve the batch.stepType.
+	 * The key to retrieve the batch step type.
 	 */
 	String STEP_TYPE_KEY = "batch.stepType";
 

spring-batch-core/src/main/java/org/springframework/batch/core/StepExecution.java

@@ -474,14 +474,14 @@ public void setLastUpdated(Date lastUpdated) {
 	}
 
 	/**
-	 * @return The {@link List} of {@link Throwable}s.
+	 * @return The {@link List} of {@link Throwable} objects.
 	 */
 	public List<Throwable> getFailureExceptions() {
 		return failureExceptions;
 	}
 
 	/**
-	 * Add {@link Throwable} to failure exceptions.
+	 * Add a {@link Throwable} to failure exceptions.
 	 * @param throwable The {@link Throwable} to add to failure exceptions.
 	 */
 	public void addFailureException(Throwable throwable) {
@@ -541,7 +541,7 @@ public String toString() {
 	}
 
 	/**
-	 * @return  The {@link String} containing summary of the step execution.
+	 * @return  The {@link String} containing a summary of the step execution.
 	 */
 	public String getSummary() {
 		return super.toString()

spring-batch-core/src/main/java/org/springframework/batch/core/configuration/JobFactory.java

@@ -32,7 +32,7 @@ public interface JobFactory {
 	Job createJob();
 
 	/**
-	 * @return The {@link String} containing the {@link Job} Name.
+	 * @return The {@link String} containing the {@link Job} name.
 	 */
 	String getJobName();
 

spring-batch-core/src/main/java/org/springframework/batch/core/configuration/annotation/AbstractBatchConfiguration.java

@@ -136,8 +136,8 @@ public void afterPropertiesSet() throws Exception {
 	}
 
 	/**
-	 * Returns the {@link BatchConfigurer} if one is present in list.  Create {@link BatchConfigurer} if configurers list is empty.
-	 * If more than one configurer is present in the list then an {@link IllegalStateException} is thrown.
+	 * If a {@link BatchConfigurer}, return it. If the configurers list is empty, create {@link BatchConfigurer}.
+	 * If more than one configurer is present in the list, an {@link IllegalStateException} is thrown.
 	 * @param configurers The {@link Collection} of configurers to review.
 	 * @return The {@link BatchConfigurer} that was in the configurers collection or the one created.
 	 */

spring-batch-core/src/main/java/org/springframework/batch/core/configuration/annotation/DefaultBatchConfigurer.java

@@ -102,7 +102,7 @@ public JobExplorer getJobExplorer() {
 	}
 
 	/**
-	 * Initialize the {@link DefaultBatchConfigurer} with the {@link JobRepository}, {@link JobExplorer} and, {@link JobLauncher}.
+	 * Initialize the {@link DefaultBatchConfigurer} with the {@link JobRepository}, {@link JobExplorer}, and {@link JobLauncher}.
 	 */
 	@PostConstruct
 	public void initialize() {

spring-batch-core/src/main/java/org/springframework/batch/core/configuration/annotation/JobBuilderFactory.java

@@ -29,7 +29,7 @@ public class JobBuilderFactory {
 	private JobRepository jobRepository;
 
 	/**
-	 * @param jobRepository The {@link JobRepository} to be used by builder factory.
+	 * @param jobRepository The {@link JobRepository} to be used by the builder factory.
 	 */
 	public JobBuilderFactory(JobRepository jobRepository) {
 		this.jobRepository = jobRepository;

spring-batch-core/src/main/java/org/springframework/batch/core/configuration/annotation/ModularBatchConfiguration.java

@@ -73,7 +73,7 @@ public JobExplorer jobExplorer() throws Exception {
 	}
 
 	/**
-	 * Creates {@link AutomaticJobRegistrar} bean.
+	 * Creates a {@link AutomaticJobRegistrar} bean.
 	 * @return New instance of {@link AutomaticJobRegistrar}.
 	 * @throws Exception The {@link Exception} thrown if error occurs.
 	 */