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 5d83e3f6..287783e6 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
@@ -27,7 +27,7 @@
     application, the shell of a <classname>HelloWorldCommands</classname>
     class is shown below </para>
 
-    <programlisting>@Component
+    <programlisting  language="java">@Component
 public class HelloWorldCommands implements CommandMarker {
  
   // use any Spring annotations for Dependency Injection or other Spring interfaces as required.
@@ -43,7 +43,7 @@ public class HelloWorldCommands implements CommandMarker {
     <para>Logging is done using JDK logging. Simply add a LOG declaration as
     shown below to use a logger.</para>
 
-    <programlisting>@Component
+    <programlisting language="java">@Component
 public class HelloWorldCommands implements CommandMarker {
  
   protected final Logger LOG = Logger.getLogger(getClass().getName());
diff --git a/docs/src/reference/docbook/reference/shell.xml b/docs/src/reference/docbook/reference/shell.xml
index bc95f707..7e4d3b18 100644
--- a/docs/src/reference/docbook/reference/shell.xml
+++ b/docs/src/reference/docbook/reference/shell.xml
@@ -29,7 +29,7 @@
 
     <mediaobject>
       <imageobject>
-        <imagedata fileref="../images/shell-arch-overview.png"/>
+        <imagedata fileref="images/shell-arch-overview.png"/>
       </imageobject>
     </mediaobject>
 
@@ -207,7 +207,7 @@ public class HelloWorldCommands implements CommandMarker {
     functionality. The <interfacename>ExecutionProcess</interfacename>
     interface is shown below</para>
 
-    <programlisting>public interface ExecutionProcessor extends CommandMarker {
+    <programlisting language="java">public interface ExecutionProcessor extends CommandMarker {
 
  /**
   * Method called before invoking the target command (described by {@link ParseResult}).
diff --git a/docs/src/reference/docbook/samples/simple-application.xml b/docs/src/reference/docbook/samples/simple-application.xml
index 9d5f4544..634121d8 100644
--- a/docs/src/reference/docbook/samples/simple-application.xml
+++ b/docs/src/reference/docbook/samples/simple-application.xml
@@ -119,7 +119,7 @@ public class HelloWorldCommands implements CommandMarker {
 
     <mediaobject>
       <imageobject>
-        <imagedata fileref="../images/shell-example.jpg"/>
+        <imagedata fileref="images/shell-example.jpg"/>
       </imageobject>
     </mediaobject>
 
@@ -128,7 +128,7 @@ public class HelloWorldCommands implements CommandMarker {
 
     <mediaobject>
       <imageobject>
-        <imagedata fileref="../images/shell-example-enum.jpg"/>
+        <imagedata fileref="images/shell-example-enum.jpg"/>
       </imageobject>
     </mediaobject>
   </section>