From 0a404494bb9c9eedb62df0f0e49f16d4d513ee27 Mon Sep 17 00:00:00 2001
From: lucasward <lucasward@2e8e966d-6415-0410-94b9-dc4e65435d03>
Date: Thu, 9 Oct 2008 05:09:12 +0000
Subject: [PATCH] OPEN - issue BATCH-823: Confusing explanation
 http://jira.springframework.org/browse/BATCH-823

Simplified the description of StepExecution
---
 docs/src/site/docbook/reference/core.xml | 21 +++++++--------------
 1 file changed, 7 insertions(+), 14 deletions(-)

diff --git a/docs/src/site/docbook/reference/core.xml b/docs/src/site/docbook/reference/core.xml
index 1abc19220..a3ce5cf3c 100644
--- a/docs/src/site/docbook/reference/core.xml
+++ b/docs/src/site/docbook/reference/core.xml
@@ -615,20 +615,13 @@
       <title id="stepExecution">StepExecution</title>
 
       <para>A <classname>StepExecution</classname> represents a single attempt
-      to execute a <classname>Step</classname>. Using the example from
-      <classname>JobExecution</classname>, if there is a
-      <classname>JobInstance</classname> for the "EndOfDayJob", with
-      <classname>JobParameters</classname> of "01-01-2008" that fails to
-      successfully complete its work the first time it is run, when it is
-      executed again, a new <classname>StepExecution</classname> will be
-      created. Each of these step executions may represent a different
-      invocation of the batch framework, but they will all correspond to the
-      same <classname>JobInstance</classname>, just as multiple
-      <classname>JobExecutions</classname> belong to the same
-      <classname>JobInstance</classname>. However, if a step fails to execute
-      because the step before it fails, there will be no execution persisted
-      for it. An execution will only be created when the
-      <classname>Step</classname> is actually started.</para>
+      to execute a <classname>Step</classname>. A new
+      <classname>StepExecution</classname> will be created each time a Step is
+      run, similar to <classname>JobExecution</classname>. However, if a step
+      fails to execute because the step before it fails, there will be no
+      execution persisted for it. A <classname>StepExecution</classname> will
+      only be created when it's <classname>Step</classname> is actually
+      started.</para>
 
       <para>Step executions are represented by objects of the
       <classname>StepExecution</classname> class. Each execution contains a