diff --git a/chapters/config.xml b/chapters/config.xml
index c25db85031..54348e18c8 100644
--- a/chapters/config.xml
+++ b/chapters/config.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.58 $ -->
+<!-- $Revision: 1.59 $ -->
  <chapter id="configuration">
   <title>Configuration</title>
 
@@ -743,7 +743,7 @@ include_path=".;c:\www\phplib"
         </note>
        </listitem>
       </varlistentry>
-                
+
       <varlistentry id="ini.short-open-tag">
        <term>
         <parameter>short_open_tag</parameter>
@@ -753,9 +753,20 @@ include_path=".;c:\www\phplib"
         <para>
          Tells whether the short form (<userinput>&lt;? ?&gt;</userinput>)
          of PHP's open tag should be allowed.  If you want to use PHP in
-         combination with XML, you have to disable this option.  If
-         disabled, you must use the long form of the open tag
-         (<userinput>&lt;?php ?&gt;</userinput>).</para>
+         combination with XML, you can disable this option in order to 
+         use (<userinput>&lt;?xml ?&gt;</userinput> inline.  Otherwise, you 
+         can print it with PHP, for example: <userinput>&lt;?php echo '&lt;?xml 
+         version="1.0"'; ?&gt;</userinput>.  Also if disabled, you must use the 
+         long form of the PHP open tag (<userinput>&lt;?php ?&gt;</userinput>).
+        </para>
+        <note>
+         <para>
+          This directive also affects the shorthand <userinput>&lt;?=</userinput>, 
+          which is identical to <userinput>&lt;? echo</userinput>.  Use of this 
+          shortcut requires <systemitem role="directive">short_open_tag</systemitem>
+          to be on.
+         </para>
+        </note>
        </listitem>
       </varlistentry>