diff --git a/docs/src/reference/docbook/reference/dev-guide/dev-spring-shell.xml b/docs/src/reference/docbook/reference/dev-guide/dev-spring-shell.xml
index fb39cdc4..79f58d70 100644
--- a/docs/src/reference/docbook/reference/dev-guide/dev-spring-shell.xml
+++ b/docs/src/reference/docbook/reference/dev-guide/dev-spring-shell.xml
@@ -87,7 +87,7 @@ public class HelloWorldCommands implements CommandMarker {
       </listitem>
 
       <listitem>
-        <para><classname>CliOptions</classname> - Placed on the arguments of a
+        <para><classname>CliOption</classname> - Placed on the arguments of a
         command method, allowing it to declare the argument value as mandatory
         or optional with a default value.</para>
       </listitem>
diff --git a/docs/src/reference/docbook/reference/shell.xml b/docs/src/reference/docbook/reference/shell.xml
index 273c4378..391967f7 100644
--- a/docs/src/reference/docbook/reference/shell.xml
+++ b/docs/src/reference/docbook/reference/shell.xml
@@ -184,8 +184,10 @@ public class HelloWorldCommands implements CommandMarker {
     </itemizedlist>
 
     <para>There is a default implementation for these interfaces but you
-    should create your own implementations for your own shell application. Use
-    Spring's <literal>@Ordered</literal> annotation to set the priority of the
+    should create your own implementations for your own shell application.
+    All of these interfaces extend from 
+    <interfacename>NamedProvider</interfacename>.  Use
+    Spring's <literal>@Order</literal> annotation to set the priority of the
     provider. This allows your provider implementations to take precedence
     over any other implementations that maybe present on the classpath from
     other plugins.</para>