SHL-23 - Create docbook based reference guide

docs/src/reference/docbook/preface.xml

@@ -8,45 +8,40 @@
   <title>Preface</title>
 
   <para>The Spring Shell provides an interactive shell that allows you to
-  plugin your own custom commands using a Spring based POJO programming
+  plugin your own custom commands using a Spring based programming
   model.</para>
 
-  <para>The shell has been extracted from the Spring Roo project, giving it a
-  strong foundation and rich feature set. One significant change from Spring
-  Roo is that the plugin model is no longer based on OSGi but instead uses
-  Spring IoC container to discover commands through classpath scanning. There
-  is currently no classloader isolation between plugins, however that maybe
-  added in future versions.</para>
+  <para>The shell has been extracted from the <link
+  ns2:href="http://www.springsource.org/spring-roo/">Spring Roo
+  project</link>, giving it a strong foundation and rich feature set. One
+  significant change from Spring Roo is that the plugin model is no longer
+  based on OSGi but instead uses Spring IoC container to discover commands
+  through classpath scanning. There is currently no classloader isolation
+  between plugins, however that maybe added in future versions.</para>
 
   <para>Spring Shell's features include</para>
 
   <itemizedlist>
     <listitem>
-      <para>A POJO based programming model to contribute custom
-      commands</para>
+      <para>A simple, annotation driven, programming model to contribute
+      custom commands</para>
     </listitem>
 
     <listitem>
-      <para>Use Spring's classpath scanning functionality as a basis for a
-      command plugin strategy</para>
+      <para>Use of Spring's classpath scanning functionality asthe basis for a
+      command plugin strategy and command develoment</para>
     </listitem>
 
     <listitem>
       <para>Inheritance of the <link
       ns2:href="http://static.springsource.org/spring-roo/reference/html-single/index.html#usage-shell">Roo
-      Shell features</link></para>
+      Shell features</link>, most notably tab completion, colorization, and
+      script execution.</para>
     </listitem>
 
     <listitem>
-      <para>Tab completion</para>
-    </listitem>
-
-    <listitem>
-      <para>Scripting and Script recording</para>
-    </listitem>
-
-    <listitem>
-      <para>Customize command prompt, banner, shell history file name.</para>
+      <para>Customizatin of command prompt, banner, shell history file
+      name.</para>
     </listitem>
   </itemizedlist>