diff --git a/debug/org.eclipse.cdt.debug.mi.core/schema/commandFactories.exsd b/debug/org.eclipse.cdt.debug.mi.core/schema/commandFactories.exsd
index d2c47830bbf..84a7736b1fa 100644
--- a/debug/org.eclipse.cdt.debug.mi.core/schema/commandFactories.exsd
+++ b/debug/org.eclipse.cdt.debug.mi.core/schema/commandFactories.exsd
@@ -6,7 +6,7 @@
          <meta.schema plugin="org.eclipse.cdt.debug.mi.core" id="commandFactories" name="gdb/mi Command Factories"/>
       </appInfo>
       <documentation>
-         Allows the contributions of modified/extended gdb/mi command sets.
+         Allows the contributions of modified gdb/mi command sets.
       </documentation>
    </annotation>
 
@@ -113,7 +113,9 @@
          <meta.section type="examples"/>
       </appInfo>
       <documentation>
-         &lt;extension point=&quot;org.eclipse.cdt.debug.mi.core.commandFactories&quot;&gt;
+         The following is an example of a command factory extension point:
+
+&lt;extension point=&quot;org.eclipse.cdt.debug.mi.core.commandFactories&quot;&gt;
       &lt;commandFactory
              class=&quot;org.eclipse.cdt.debug.mi.core.command.factories.win32.CygwinCommandFactory&quot;
             debuggerID=&quot;org.eclipse.cdt.debug.mi.core.CDebuggerNew&quot;
@@ -122,7 +124,6 @@
             name=&quot;CygWin&quot;
             platforms=&quot;win32&quot;/&gt;
 &lt;/extension&gt;
-
       </documentation>
    </annotation>
 
@@ -131,7 +132,7 @@
          <meta.section type="apiInfo"/>
       </appInfo>
       <documentation>
-         [Enter API information here.]
+         Value of the attribute class must be a fully qualified name of a Java class that extends the class org.eclipse.cdt.debug.mi.core.command.CommandFactory.
       </documentation>
    </annotation>
 
@@ -140,7 +141,7 @@
          <meta.section type="implementation"/>
       </appInfo>
       <documentation>
-         [Enter information about supplied implementation of this extension point.]
+         
       </documentation>
    </annotation>
 
@@ -154,7 +155,6 @@ All rights reserved. This program and the accompanying materials
 are made available under the terms of the Eclipse Public License v1.0
 which accompanies this distribution, and is available at
 http://www.eclipse.org/legal/epl-v10.html
-
       </documentation>
    </annotation>