203553: Merge contributions from Beth Tibbitts

1 files changed, 19 insertions, 7 deletions

diff --git a/core/org.eclipse.cdt.core/schema/templates.exsd b/core/org.eclipse.cdt.core/schema/templates.exsd
index 8bb637eece8..e5965ee056b 100644
--- a/core/org.eclipse.cdt.core/schema/templates.exsd
+++ b/core/org.eclipse.cdt.core/schema/templates.exsd
@@ -13,7 +13,8 @@
    <element name="extension">
       <annotation>
          <documentation>
-            Extension point added to Template Engine plugin.  Any plugin, which intends to contribute XML templates to Template Engine has to extend this extension point, and add template element.
+            Extension point added to Template Engine plugin. Any plugin, which intends to contribute XML templates to the Template Engine must extend this extension point, and add the template element.
+
          </documentation>
       </annotation>
       <complexType>
@@ -50,7 +51,7 @@
    <element name="template">
       <annotation>
          <documentation>
-            By adding the templates extension point the users can contribute there Template XMLs to the Template Engine plugin.
+            By adding the templates extension point the users can contribute their Template XMLs to the Template Engine plugin.
          </documentation>
       </annotation>
       <complexType>
@@ -67,7 +68,7 @@
          <attribute name="location" type="string" use="required">
             <annotation>
                <documentation>
-                  The path of template.xml (relative to the base of the containing plug-in). For example &quot;templates/TemplateOne/template.xml&quot;. This attribute is mandatory. 
+                  The path of template.xml (relative to the base of the containing plug-in). For example &quot;templates/TemplateOne/template.xml&quot;. This attribute is mandatory.
                </documentation>
                <appInfo>
                   <meta.attribute kind="resource"/>
@@ -77,7 +78,14 @@
          <attribute name="projectType" type="string" use="required">
             <annotation>
                <documentation>
-                  This id refers to the cdt project type that the template will be associated with. Project types are contributed to the org.eclipse.cdt.managedbuilder.core.buildDefinitions extension-point. See the CDT Build System documentation in the developer guide for built-in project type ids.
+                  This attribute is a project type id referring to the cdt project type that the template will be associated with. Project types are contributed to the org.eclipse.cdt.managedbuilder.core.buildDefinitions extension-point.
+This attribute is mandatory. CDT pre-defines the following values of the build artifact type property: 
+&lt;ul&gt;
+&lt;li&gt;&quot;org.eclipse.cdt.build.core.buildArtefactType.exe&quot; - to represent executable
+&lt;li&gt;&quot;org.eclipse.cdt.build.core.buildArtefactType.staticLib&quot; - to represent static library 
+&lt;li&gt;&quot;org.eclipse.cdt.build.core.buildArtefactType.sharedLib&quot; - to represent shared library 
+&lt;li&gt;ISVs can define their own custom build artifact values by contributing to the org.eclipse.cdt.managedbuilder.core.buildProperties extension point. 
+&lt;/ul&gt;
                </documentation>
             </annotation>
          </attribute>
@@ -109,11 +117,16 @@
    </element>
 
    <element name="toolChain">
+      <annotation>
+         <documentation>
+            This element is used to reference an existing toolchain by its unique identifier.
+         </documentation>
+      </annotation>
       <complexType>
          <attribute name="id" type="string" use="required">
             <annotation>
                <documentation>
-                  
+                  The unique identifier of a toolchain contributed to the org.eclipse.cdt.managedbuilder.core.buildDefinitions extension point.
                </documentation>
             </annotation>
          </attribute>
@@ -147,8 +160,7 @@
    &lt;/extension&gt;
 &lt;/pre&gt;            
 
-For more details on how to define your own templates, please check examples provided under
-&lt;samp&gt;org.eclipse.cdt.templates&lt;/samp&gt;
+For more details on how to define your own templates, please check examples provided under &lt;samp&gt;org.eclipse.cdt.ui.templateengine&lt;/samp&gt;
       </documentation>
    </annotation>