Bug 387547: extension points must specify available variables for <enablement> elements
diff --git a/org.eclipse.jdt.core.manipulation/schema/changeMethodSignatureParticipants.exsd b/org.eclipse.jdt.core.manipulation/schema/changeMethodSignatureParticipants.exsd
index 5ac485e..3aab553 100644
--- a/org.eclipse.jdt.core.manipulation/schema/changeMethodSignatureParticipants.exsd
+++ b/org.eclipse.jdt.core.manipulation/schema/changeMethodSignatureParticipants.exsd
@@ -8,16 +8,17 @@
       <documentation>
          This extension point is used to define change method signature refactoring participants.
 
-The reader of the expression provides the following predefined variables which can be referenced via the &amp;lt;with variable=&quot;...&quot;&amp;gt; expression element:
-
+&lt;p&gt;
+This extension point supports the &lt;code&gt;&amp;lt;enablement&amp;gt;&lt;/code&gt; element.
+&lt;!-- see org.eclipse.ltk.core.refactoring.participants.ParticipantExtensionPoint#createEvaluationContext(..): --&gt;
+The default variable is the &lt;code&gt;org.eclipse.jdt.core.IMethod&lt;/code&gt; to be changed.
+&lt;br&gt;Defined variables for &lt;code&gt;&amp;lt;with&amp;gt;&lt;/code&gt; expressions are:
+&lt;/p&gt;
 &lt;ul&gt;
-  &lt;li&gt;Object element: the method to be changed&lt;/li&gt;
-  &lt;li&gt;List&amp;lt;String&amp;gt; affectedNatures: a list containing the natures of the projects affected 
-      by the refactoring&lt;/li&gt;
-  &lt;li&gt;String processorId: the id of the refactoring processor that will own the participant.
+&lt;li&gt;&quot;element&quot;: type &lt;code&gt;org.eclipse.jdt.core.IMethod&lt;/code&gt;; the method to be changed (same as the default variable)&lt;/li&gt;
+&lt;li&gt;&quot;affectedNatures&quot;: type &lt;code&gt;java.util.List&amp;lt;String&amp;gt;&lt;/code&gt;; the natures of all projects affected by the refactoring&lt;/li&gt;
+&lt;li&gt;&quot;processorIdentifier&quot;: type &lt;code&gt;java.lang.String&lt;/code&gt;; the id of the refactoring processor that will own the participant&lt;/li&gt;
 &lt;/ul&gt;
-
-The default variable used during expression evaluation is bound to the element variable.
       </documentation>
    </annotation>
 
@@ -149,7 +150,7 @@
          <meta.section type="copyright"/>
       </appInfo>
       <documentation>
-         Copyright (c) 2007 IBM Corporation and others.&lt;br&gt;
+         Copyright (c) 2007, 2013 IBM Corporation and others.&lt;br&gt;
 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 &lt;a href=&quot;http://www.eclipse.org/legal/epl-v10.html&quot;&gt;http://www.eclipse.org/legal/epl-v10.html&lt;/a&gt;
       </documentation>
    </annotation>
diff --git a/org.eclipse.jdt.ui/schema/classpathFixProcessors.exsd b/org.eclipse.jdt.ui/schema/classpathFixProcessors.exsd
index c0b79e9..6e35cdc 100644
--- a/org.eclipse.jdt.ui/schema/classpathFixProcessors.exsd
+++ b/org.eclipse.jdt.ui/schema/classpathFixProcessors.exsd
@@ -7,15 +7,19 @@
       </appinfo>
       <documentation>
          This extension point allows to add a processor to offer fixes for incomplete class paths when types cannot be resolved.
-&lt;p&gt;
-This extension point supports the &lt;code&gt;enablement&lt;/code&gt; tag. Properties to test on are:
-&lt;dl&gt;
-&lt;li&gt;project: type IJavaProject; the current project&lt;/li&gt;
-&lt;li&gt;sourceLevel: type String; the source compliance of the current project&lt;/li&gt;
-&lt;/dl&gt;
-A processor can specify to override another processor. An overridden processor is only asked to provide proposals when the overriding processor returns &lt;code&gt;null&lt;/code&gt; as proposals.
 
+&lt;p&gt;
+This extension point supports the &lt;code&gt;&amp;lt;enablement&amp;gt;&lt;/code&gt; element.
+&lt;!-- see org.eclipse.jdt.internal.ui.text.correction.ClasspathFixProcessorDescriptor#matches(IJavaProject): --&gt;
+The default variable is the containing &lt;code&gt;org.eclipse.jdt.core.IJavaProject&lt;/code&gt;.
+&lt;br&gt;Defined variables for &lt;code&gt;&amp;lt;with&amp;gt;&lt;/code&gt; expressions are:
 &lt;/p&gt;
+&lt;ul&gt;
+&lt;li&gt;&quot;project&quot;: type &lt;code&gt;org.eclipse.jdt.core.IJavaProject&lt;/code&gt;; the current project (same as the default variable)&lt;/li&gt;
+&lt;li&gt;&quot;sourceLevel&quot;: type &lt;code&gt;java.lang.String&lt;/code&gt;; the source compliance level of the current project&lt;/li&gt;
+&lt;/ul&gt;
+
+A processor can specify to override another processor. An overridden processor is only asked to provide proposals when the overriding processor returns &lt;code&gt;null&lt;/code&gt; as proposals.
       </documentation>
    </annotation>
 
@@ -97,7 +101,7 @@
          <attribute name="id" type="string" use="required">
             <annotation>
                <documentation>
-                  The id of the classspath fix processor that is overridden by the current processor. The current processor can choose to replace proposals of extended processor.
+                  The id of the classspath fix processor that is overridden by the current processor. The current processor can choose to replace proposals of the extended processor.
                </documentation>
                <appinfo>
                   <meta.attribute kind="identifier" basedOn="org.eclipse.jdt.ui.classpathFixProcessors/classpathFixProcessor/@id"/>
@@ -123,7 +127,6 @@
       <documentation>
          The following is an example of a Classpath Fix processor contribution:
 
-&lt;p&gt;
 &lt;pre&gt;
  &lt;extension point=&quot;org.eclipse.jdt.ui.classpathFixProcessors&quot;&gt;
   &lt;classpathFixProcessor
@@ -142,7 +145,6 @@
   &lt;/classpathFixProcessor&gt;
  &lt;/extension&gt;
 &lt;/pre&gt;
-&lt;/p&gt;
       </documentation>
    </annotation>
 
@@ -161,7 +163,7 @@
          <meta.section type="copyright"/>
       </appinfo>
       <documentation>
-         Copyright (c) 2007, 2008 IBM Corporation and others.&lt;br&gt;
+         Copyright (c) 2007, 2013 IBM Corporation and others.&lt;br&gt;
 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 &lt;a href=&quot;http://www.eclipse.org/legal/epl-v10.html&quot;&gt;http://www.eclipse.org/legal/epl-v10.html&lt;/a&gt;
       </documentation>
    </annotation>
diff --git a/org.eclipse.jdt.ui/schema/javaCompletionProposalComputer.exsd b/org.eclipse.jdt.ui/schema/javaCompletionProposalComputer.exsd
index 6097afd..abf1586 100644
--- a/org.eclipse.jdt.ui/schema/javaCompletionProposalComputer.exsd
+++ b/org.eclipse.jdt.ui/schema/javaCompletionProposalComputer.exsd
@@ -7,11 +7,16 @@
       </appInfo>
       <documentation>
          This extension point allows to contribute Java completion proposal computers to participate in the content assist process of the Java editor.
+
 &lt;p&gt;
-This extension point supports the &lt;code&gt;enablement&lt;/code&gt; tag. Properties to test on are:
-&lt;dl&gt;
-&lt;li&gt;project: type IJavaProject; the current project&lt;/li&gt;
-&lt;/dl&gt;
+This extension point supports the &lt;code&gt;&amp;lt;enablement&amp;gt;&lt;/code&gt; element.
+&lt;!-- see org.eclipse.jdt.internal.ui.text.java.CompletionProposalCategory#matches(IJavaProject): --&gt;
+The default variable is the containing &lt;code&gt;org.eclipse.jdt.core.IJavaProject&lt;/code&gt;.
+&lt;br&gt;Defined variables for &lt;code&gt;&amp;lt;with&amp;gt;&lt;/code&gt; expressions are:
+&lt;/p&gt;
+&lt;ul&gt;
+&lt;li&gt;&quot;project&quot;: type &lt;code&gt;org.eclipse.jdt.core.IJavaProject&lt;/code&gt;; the current project (same as the default variable)&lt;/li&gt;
+&lt;/ul&gt;
       </documentation>
    </annotation>
 
@@ -179,7 +184,6 @@
       <documentation>
          The following is an example of a Java completion proposal computer contribution:
 
-&lt;p&gt;
 &lt;pre&gt;
  &lt;extension point=&quot;org.eclipse.jdt.ui.javaCompletionProposalComputer&quot;
    id=&quot;textual_proposals&quot;
@@ -196,7 +200,6 @@
    &lt;/javaCompletionProposalComputer&gt;
  &lt;/extension&gt;
 &lt;/pre&gt;
-&lt;/p&gt;
       </documentation>
    </annotation>
 
@@ -223,7 +226,7 @@
          <meta.section type="copyright"/>
       </appInfo>
       <documentation>
-         Copyright (c) 2006, 2012 IBM Corporation and others.&lt;br&gt;
+         Copyright (c) 2006, 2013 IBM Corporation and others.&lt;br&gt;
 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 &lt;a href=&quot;http://www.eclipse.org/legal/epl-v10.html&quot;&gt;http://www.eclipse.org/legal/epl-v10.html&lt;/a&gt;
       </documentation>
    </annotation>
diff --git a/org.eclipse.jdt.ui/schema/quickAssistProcessors.exsd b/org.eclipse.jdt.ui/schema/quickAssistProcessors.exsd
index 813bf9c..e8e8b9a 100644
--- a/org.eclipse.jdt.ui/schema/quickAssistProcessors.exsd
+++ b/org.eclipse.jdt.ui/schema/quickAssistProcessors.exsd
@@ -7,13 +7,16 @@
       </appInfo>
       <documentation>
          This extension point allows to add a Quick Assist processor to offer new Quick Assists in the Java editor.
-This extension point supports the &lt;code&gt;enablement&lt;/code&gt; tag. Properties to test on are:
-&lt;dl&gt;
-&lt;li&gt;compilationUnit: type ICompilationUnit; the compilation unit the quick assist is applied on&lt;/li&gt;
 
-&lt;li&gt;projectNatures: type Collection; all project natures of the current project&lt;/li&gt;
-&lt;li&gt;sourceLevel: type String; the source compliance of the current project&lt;/li&gt;
-&lt;/dl&gt;
+This extension point supports the &lt;code&gt;&amp;lt;enablement&amp;gt;&lt;/code&gt; element.
+&lt;!-- see org.eclipse.jdt.internal.ui.text.correction.ContributedProcessorDescriptor#matches(ICompilationUnit): --&gt;
+The default variable is the containing &lt;code&gt;org.eclipse.jdt.core.ICompilationUnit&lt;/code&gt;.
+&lt;br&gt;Defined variables for &lt;code&gt;&amp;lt;with&amp;gt;&lt;/code&gt; expressions are:
+&lt;ul&gt;
+&lt;li&gt;&quot;compilationUnit&quot;: type &lt;code&gt;org.eclipse.jdt.core.ICompilationUnit&lt;/code&gt;; the compilation unit the quick assist is applied on (same as the default variable)&lt;/li&gt;
+&lt;li&gt;&quot;projectNatures&quot;: type &lt;code&gt;java.util.Collection&amp;lt;String&amp;gt;&lt;/code&gt;; all project natures of the current project&lt;/li&gt;
+&lt;li&gt;&quot;sourceLevel&quot;: type &lt;code&gt;java.lang.String&lt;/code&gt;; the source compliance level of the current project&lt;/li&gt;
+&lt;/ul&gt;
       </documentation>
    </annotation>
 
@@ -103,7 +106,6 @@
       <documentation>
          The following is an example of a Quick Assist processor contribution:
 
-&lt;p&gt;
 &lt;pre&gt;
  &lt;extension point=&quot;org.eclipse.jdt.ui.quickAssistProcessors&quot;&gt;
   &lt;quickAssistProcessor
@@ -121,7 +123,6 @@
    &lt;/enablement&gt;
  &lt;/extension&gt;
 &lt;/pre&gt;
-&lt;/p&gt;
       </documentation>
    </annotation>
 
@@ -157,7 +158,7 @@
          <meta.section type="copyright"/>
       </appInfo>
       <documentation>
-         Copyright (c) 2001, 2004 IBM Corporation and others.&lt;br&gt;
+         Copyright (c) 2001, 2013 IBM Corporation and others.&lt;br&gt;
 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 &lt;a href=&quot;http://www.eclipse.org/legal/epl-v10.html&quot;&gt;http://www.eclipse.org/legal/epl-v10.html&lt;/a&gt;
       </documentation>
    </annotation>
diff --git a/org.eclipse.jdt.ui/schema/quickFixProcessors.exsd b/org.eclipse.jdt.ui/schema/quickFixProcessors.exsd
index e15be2f..fe45155 100644
--- a/org.eclipse.jdt.ui/schema/quickFixProcessors.exsd
+++ b/org.eclipse.jdt.ui/schema/quickFixProcessors.exsd
@@ -8,18 +8,19 @@
       <documentation>
          This extension point allows to add a Quick Fix processor to offer new Quick Fixes on Java problems.
 &lt;p&gt;
-Since 3.2 an extension can specify which problem marker types it can handle. It will only get problems of these types to process.
-If no handled marker type are specified, the processor will only get problems of types org.eclipse.jdt.core.problem, org.eclipse.jdt.core.buildpath_problem and org.eclipse.jdt.core.task (compatible to the behaviour prior to 3.2).
+Since 3.2, an extension can specify which problem marker types it can handle. It will only get problems of these types to process.
+If no handled marker types are specified, the processor will only get problems of types org.eclipse.jdt.core.problem, org.eclipse.jdt.core.buildpath_problem and org.eclipse.jdt.core.task (compatible to the behaviour prior to 3.2).
 &lt;/p&gt;
-&lt;p&gt;
-This extension point supports the &lt;code&gt;enablement&lt;/code&gt; tag. Properties to test on are:
-&lt;dl&gt;
-&lt;li&gt;compilationUnit: type ICompilationUnit; the compilation unit the quick assist is applied on&lt;/li&gt;
 
-&lt;li&gt;projectNatures: type Collection; all project natures of the current project&lt;/li&gt;
-&lt;li&gt;sourceLevel: type String; the source compliance of the current project&lt;/li&gt;
-&lt;/dl&gt;
-&lt;/p&gt;
+This extension point supports the &lt;code&gt;&amp;lt;enablement&amp;gt;&lt;/code&gt; element.
+&lt;!-- see org.eclipse.jdt.internal.ui.text.correction.ContributedProcessorDescriptor#matches(ICompilationUnit): --&gt;
+The default variable is the containing &lt;code&gt;org.eclipse.jdt.core.ICompilationUnit&lt;/code&gt;.
+&lt;br&gt;Defined variables for &lt;code&gt;&amp;lt;with&amp;gt;&lt;/code&gt; expressions are:
+&lt;ul&gt;
+&lt;li&gt;&quot;compilationUnit&quot;: type &lt;code&gt;org.eclipse.jdt.core.ICompilationUnit&lt;/code&gt;; the compilation unit the quick assist is applied on (same as the default variable)&lt;/li&gt;
+&lt;li&gt;&quot;projectNatures&quot;: type &lt;code&gt;java.util.Collection&amp;lt;String&amp;gt;&lt;/code&gt;; all project natures of the current project&lt;/li&gt;
+&lt;li&gt;&quot;sourceLevel&quot;: type &lt;code&gt;java.lang.String&lt;/code&gt;; the source compliance level of the current project&lt;/li&gt;
+&lt;/ul&gt;
       </documentation>
    </annotation>
 
@@ -139,7 +140,6 @@
       <documentation>
          The following is an example of a Quick Fix processor contribution:
 
-&lt;p&gt;
 &lt;pre&gt;
  &lt;extension point=&quot;org.eclipse.jdt.ui.quickFixProcessors&quot;&gt;
   &lt;quickFixProcessor
@@ -160,7 +160,6 @@
   &lt;/quickFixProcessor&gt;
  &lt;/extension&gt;
 &lt;/pre&gt;
-&lt;/p&gt;
       </documentation>
    </annotation>
 
@@ -196,7 +195,7 @@
          <meta.section type="copyright"/>
       </appInfo>
       <documentation>
-         Copyright (c) 2001, 2008 IBM Corporation and others.&lt;br&gt;
+         Copyright (c) 2001, 2013 IBM Corporation and others.&lt;br&gt;
 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 &lt;a href=&quot;http://www.eclipse.org/legal/epl-v10.html&quot;&gt;http://www.eclipse.org/legal/epl-v10.html&lt;/a&gt;
       </documentation>
    </annotation>
diff --git a/org.eclipse.ltk.core.refactoring/schema/copyParticipants.exsd b/org.eclipse.ltk.core.refactoring/schema/copyParticipants.exsd
index a864d7b..478d374 100644
--- a/org.eclipse.ltk.core.refactoring/schema/copyParticipants.exsd
+++ b/org.eclipse.ltk.core.refactoring/schema/copyParticipants.exsd
@@ -6,16 +6,19 @@
          <meta.schema plugin="org.eclipse.ltk.core.refactoring" id="copyParticipants" name="Copy Participants"/>
       </appInfo>
       <documentation>
-         This extension point is used to define refactoring copy participants. The reader of the expression provides the following predefined variables which can be referenced via the &amp;lt;with variable=&quot;...&quot;&amp;gt; expression element:
+         This extension point is used to define refactoring copy participants.
 
+&lt;p&gt;
+This extension point supports the &lt;code&gt;&amp;lt;enablement&amp;gt;&lt;/code&gt; element.
+&lt;!-- see org.eclipse.ltk.core.refactoring.participants.ParticipantExtensionPoint#createEvaluationContext(..): --&gt;
+The default variable is the element to be copied.
+&lt;br&gt;Defined variables for &lt;code&gt;&amp;lt;with&amp;gt;&lt;/code&gt; expressions are:
+&lt;/p&gt;
 &lt;ul&gt;
-  &lt;li&gt;Object element: the element to be copied&lt;/li&gt;
-  &lt;li&gt;List&amp;lt;String&amp;gt; affectedNatures: a list containing the natures of the projects affected 
-      by the refactoring&lt;/li&gt;
-  &lt;li&gt;String processorId: the id of the refactoring processor that will own the participant.
+&lt;li&gt;&quot;element&quot;: type &lt;code&gt;java.lang.Object&lt;/code&gt;; the element to be copied (same as the default variable)&lt;/li&gt;
+&lt;li&gt;&quot;affectedNatures&quot;: type &lt;code&gt;java.util.List&amp;lt;String&amp;gt;&lt;/code&gt;; the natures of all projects affected by the refactoring&lt;/li&gt;
+&lt;li&gt;&quot;processorIdentifier&quot;: type &lt;code&gt;java.lang.String&lt;/code&gt;; the id of the refactoring processor that will own the participant&lt;/li&gt;
 &lt;/ul&gt;
-
-The default variable used during expression evaluation is bound to the element variable.
       </documentation>
    </annotation>
 
@@ -158,7 +161,7 @@
          <meta.section type="copyright"/>
       </appInfo>
       <documentation>
-         Copyright (c) 2001, 2005 IBM Corporation and others.&lt;br&gt;
+         Copyright (c) 2001, 2013 IBM Corporation and others.&lt;br&gt;
 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 &lt;a href=&quot;http://www.eclipse.org/legal/epl-v10.html&quot;&gt;http://www.eclipse.org/legal/epl-v10.html&lt;/a&gt;
       </documentation>
    </annotation>
diff --git a/org.eclipse.ltk.core.refactoring/schema/createParticipants.exsd b/org.eclipse.ltk.core.refactoring/schema/createParticipants.exsd
index e366d4c..407bc4f 100644
--- a/org.eclipse.ltk.core.refactoring/schema/createParticipants.exsd
+++ b/org.eclipse.ltk.core.refactoring/schema/createParticipants.exsd
@@ -6,16 +6,19 @@
          <meta.schema plugin="org.eclipse.ltk.core.refactoring" id="createParticipants" name="Create Participants"/>
       </appInfo>
       <documentation>
-         This extension point is used to define refactoring create participants. The reader of the expression provides the following predefined variables which can be referenced via the &amp;lt;with variable=&quot;...&quot;&amp;gt; expression element:
+         This extension point is used to define refactoring create participants.
 
+&lt;p&gt;
+This extension point supports the &lt;code&gt;&amp;lt;enablement&amp;gt;&lt;/code&gt; element.
+&lt;!-- see org.eclipse.ltk.core.refactoring.participants.ParticipantExtensionPoint#createEvaluationContext(..): --&gt;
+The default variable is the element to be created
+&lt;br&gt;Defined variables for &lt;code&gt;&amp;lt;with&amp;gt;&lt;/code&gt; expressions are:
+&lt;/p&gt;
 &lt;ul&gt;
-  &lt;li&gt;Object element: the element to be create or a corresponding descriptor&lt;/li&gt;
-  &lt;li&gt;List&amp;lt;String&amp;gt; affectedNatures: a list containing the natures of the projects affected 
-      by the refactoring&lt;/li&gt;
-  &lt;li&gt;String processorId: the id of the refactoring processor that will own the participant.
+&lt;li&gt;&quot;element&quot;: type &lt;code&gt;java.lang.Object&lt;/code&gt;; the element to be created (same as the default variable)&lt;/li&gt;
+&lt;li&gt;&quot;affectedNatures&quot;: type &lt;code&gt;java.util.List&amp;lt;String&amp;gt;&lt;/code&gt;; the natures of all projects affected by the refactoring&lt;/li&gt;
+&lt;li&gt;&quot;processorIdentifier&quot;: type &lt;code&gt;java.lang.String&lt;/code&gt;; the id of the refactoring processor that will own the participant&lt;/li&gt;
 &lt;/ul&gt;
-
-The default variable used during expression evaluation is bound to the element variable.
       </documentation>
    </annotation>
 
@@ -147,7 +150,7 @@
          <meta.section type="copyright"/>
       </appInfo>
       <documentation>
-         Copyright (c) 2001, 2004 IBM Corporation and others.&lt;br&gt;
+         Copyright (c) 2001, 2013 IBM Corporation and others.&lt;br&gt;
 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 &lt;a href=&quot;http://www.eclipse.org/legal/epl-v10.html&quot;&gt;http://www.eclipse.org/legal/epl-v10.html&lt;/a&gt;
       </documentation>
    </annotation>
diff --git a/org.eclipse.ltk.core.refactoring/schema/deleteParticipants.exsd b/org.eclipse.ltk.core.refactoring/schema/deleteParticipants.exsd
index c02321b..a888791 100644
--- a/org.eclipse.ltk.core.refactoring/schema/deleteParticipants.exsd
+++ b/org.eclipse.ltk.core.refactoring/schema/deleteParticipants.exsd
@@ -6,16 +6,19 @@
          <meta.schema plugin="org.eclipse.ltk.core.refactoring" id="deleteParticipants" name="Delete Participants"/>
       </appInfo>
       <documentation>
-         This extension point is used to define refactoring delete participants. The reader of the expression provides the following predefined variables which can be referenced via the &amp;lt;with variable=&quot;...&quot;&amp;gt; expression element:
+         This extension point is used to define refactoring delete participants.
 
+&lt;p&gt;
+This extension point supports the &lt;code&gt;&amp;lt;enablement&amp;gt;&lt;/code&gt; element.
+&lt;!-- see org.eclipse.ltk.core.refactoring.participants.ParticipantExtensionPoint#createEvaluationContext(..): --&gt;
+The default variable is the element to be deleted.
+&lt;br&gt;Defined variables for &lt;code&gt;&amp;lt;with&amp;gt;&lt;/code&gt; expressions are:
+&lt;/p&gt;
 &lt;ul&gt;
-  &lt;li&gt;Object element: the element to be deleted&lt;/li&gt;
-  &lt;li&gt;List&amp;lt;String&amp;gt; affectedNatures: a list containing the natures of the projects affected 
-      by the refactoring&lt;/li&gt;
-  &lt;li&gt;String processorId: the id of the refactoring processor that will own the participant.
+&lt;li&gt;&quot;element&quot;: type &lt;code&gt;java.lang.Object&lt;/code&gt;; the element to be deleted (same as the default variable)&lt;/li&gt;
+&lt;li&gt;&quot;affectedNatures&quot;: type &lt;code&gt;java.util.List&amp;lt;String&amp;gt;&lt;/code&gt;; the natures of all projects affected by the refactoring&lt;/li&gt;
+&lt;li&gt;&quot;processorIdentifier&quot;: type &lt;code&gt;java.lang.String&lt;/code&gt;; the id of the refactoring processor that will own the participant&lt;/li&gt;
 &lt;/ul&gt;
-
-The default variable used during expression evaluation is bound to the element variable.
       </documentation>
    </annotation>
 
@@ -147,7 +150,7 @@
          <meta.section type="copyright"/>
       </appInfo>
       <documentation>
-         Copyright (c) 2001, 2004 IBM Corporation and others.&lt;br&gt;
+         Copyright (c) 2001, 2013 IBM Corporation and others.&lt;br&gt;
 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 &lt;a href=&quot;http://www.eclipse.org/legal/epl-v10.html&quot;&gt;http://www.eclipse.org/legal/epl-v10.html&lt;/a&gt;
       </documentation>
    </annotation>
diff --git a/org.eclipse.ltk.core.refactoring/schema/moveParticipants.exsd b/org.eclipse.ltk.core.refactoring/schema/moveParticipants.exsd
index 9218258..151cfb7 100644
--- a/org.eclipse.ltk.core.refactoring/schema/moveParticipants.exsd
+++ b/org.eclipse.ltk.core.refactoring/schema/moveParticipants.exsd
@@ -6,16 +6,19 @@
          <meta.schema plugin="org.eclipse.ltk.core.refactoring" id="moveParticipants" name="Move Participants"/>
       </appInfo>
       <documentation>
-         This extension point is used to define refactoring move participants. The reader of the expression provides the following predefined variables which can be referenced via the &amp;lt;with variable=&quot;...&quot;&amp;gt; expression element:
+         This extension point is used to define refactoring move participants.
 
+&lt;p&gt;
+This extension point supports the &lt;code&gt;&amp;lt;enablement&amp;gt;&lt;/code&gt; element.
+&lt;!-- see org.eclipse.ltk.core.refactoring.participants.ParticipantExtensionPoint#createEvaluationContext(..): --&gt;
+The default variable is the element to be moved.
+&lt;br&gt;Defined variables for &lt;code&gt;&amp;lt;with&amp;gt;&lt;/code&gt; expressions are:
+&lt;/p&gt;
 &lt;ul&gt;
-  &lt;li&gt;Object element: the element to be moved&lt;/li&gt;
-  &lt;li&gt;List&amp;lt;String&amp;gt; affectedNatures: a list containing the natures of the projects affected 
-      by the refactoring&lt;/li&gt;
-  &lt;li&gt;String processorId: the id of the refactoring processor that will own the participant.
+&lt;li&gt;&quot;element&quot;: type &lt;code&gt;java.lang.Object&lt;/code&gt;; the element to be moved (same as the default variable)&lt;/li&gt;
+&lt;li&gt;&quot;affectedNatures&quot;: type &lt;code&gt;java.util.List&amp;lt;String&amp;gt;&lt;/code&gt;; the natures of all projects affected by the refactoring&lt;/li&gt;
+&lt;li&gt;&quot;processorIdentifier&quot;: type &lt;code&gt;java.lang.String&lt;/code&gt;; the id of the refactoring processor that will own the participant&lt;/li&gt;
 &lt;/ul&gt;
-
-The default variable used during expression evaluation is bound to the element variable.
       </documentation>
    </annotation>
 
@@ -148,7 +151,7 @@
          <meta.section type="copyright"/>
       </appInfo>
       <documentation>
-         Copyright (c) 2001, 2004 IBM Corporation and others.&lt;br&gt;
+         Copyright (c) 2001, 2013 IBM Corporation and others.&lt;br&gt;
 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 &lt;a href=&quot;http://www.eclipse.org/legal/epl-v10.html&quot;&gt;http://www.eclipse.org/legal/epl-v10.html&lt;/a&gt;
       </documentation>
    </annotation>
diff --git a/org.eclipse.ltk.core.refactoring/schema/renameParticipants.exsd b/org.eclipse.ltk.core.refactoring/schema/renameParticipants.exsd
index 99a3327..b2810a0 100644
--- a/org.eclipse.ltk.core.refactoring/schema/renameParticipants.exsd
+++ b/org.eclipse.ltk.core.refactoring/schema/renameParticipants.exsd
@@ -6,16 +6,19 @@
          <meta.schema plugin="org.eclipse.ltk.core.refactoring" id="renameParticipants" name="Rename Participants"/>
       </appInfo>
       <documentation>
-         This extension point is used to define refactoring rename participants. The reader of the expression provides the following predefined variables which can be referenced via the &amp;lt;with variable=&quot;...&quot;&amp;gt; expression element:
+         This extension point is used to define refactoring rename participants.
 
+&lt;p&gt;
+This extension point supports the &lt;code&gt;&amp;lt;enablement&amp;gt;&lt;/code&gt; element.
+&lt;!-- see org.eclipse.ltk.core.refactoring.participants.ParticipantExtensionPoint#createEvaluationContext(..): --&gt;
+The default variable is the element to be renamed.
+&lt;br&gt;Defined variables for &lt;code&gt;&amp;lt;with&amp;gt;&lt;/code&gt; expressions are:
+&lt;/p&gt;
 &lt;ul&gt;
-  &lt;li&gt;Object element: the element to be renamed&lt;/li&gt;
-  &lt;li&gt;List&amp;lt;String&amp;gt; affectedNatures: a list containing the natures of the projects affected 
-      by the refactoring&lt;/li&gt;
-  &lt;li&gt;String processorId: the id of the refactoring processor that will own the participant.
+&lt;li&gt;&quot;element&quot;: type &lt;code&gt;java.lang.Object&lt;/code&gt;; the element to be renamed (same as the default variable)&lt;/li&gt;
+&lt;li&gt;&quot;affectedNatures&quot;: type &lt;code&gt;java.util.List&amp;lt;String&amp;gt;&lt;/code&gt;; the natures of all projects affected by the refactoring&lt;/li&gt;
+&lt;li&gt;&quot;processorIdentifier&quot;: type &lt;code&gt;java.lang.String&lt;/code&gt;; the id of the refactoring processor that will own the participant&lt;/li&gt;
 &lt;/ul&gt;
-
-The default variable used during expression evaluation is bound to the element variable.
       </documentation>
    </annotation>
 
@@ -170,7 +173,7 @@
          <meta.section type="copyright"/>
       </appInfo>
       <documentation>
-         Copyright (c) 2001, 2005 IBM Corporation and others.&lt;br&gt;
+         Copyright (c) 2001, 2013 IBM Corporation and others.&lt;br&gt;
 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 &lt;a href=&quot;http://www.eclipse.org/legal/epl-v10.html&quot;&gt;http://www.eclipse.org/legal/epl-v10.html&lt;/a&gt;
       </documentation>
    </annotation>
diff --git a/org.eclipse.ltk.ui.refactoring/schema/changePreviewViewers.exsd b/org.eclipse.ltk.ui.refactoring/schema/changePreviewViewers.exsd
index a0242e1..a22cb52 100644
--- a/org.eclipse.ltk.ui.refactoring/schema/changePreviewViewers.exsd
+++ b/org.eclipse.ltk.ui.refactoring/schema/changePreviewViewers.exsd
@@ -6,16 +6,17 @@
          <meta.schema plugin="org.eclipse.ltk.ui.refactoring" id="changePreviewViewers" name="Refactoring Change Preview Viewers"/>
       </appInfo>
       <documentation>
-         This extension point is used to define a special viewer capable to present change objects. The reader of 
-         the extension point provides the following predefined variables which can be accessed during 
-         expression evaluation using the &amp;lt;with variable=&quot;...&quot;/&amp;gt; tag: 
+         This extension point is used to define a special viewer capable to present change objects.
+
 &lt;p&gt;
-&lt;dl&gt;
-  &lt;dt&gt;change&lt;/dt&gt;
-  &lt;dd&gt;the change object to present a preview for&lt;/dd&gt;
-&lt;/dl&gt;
+This extension point supports the &lt;code&gt;&amp;lt;enablement&amp;gt;&lt;/code&gt; element.
+&lt;!-- see org.eclipse.ltk.internal.ui.refactoring.AbstractDescriptor#matches(Object, String): --&gt;
+The default variable is the change object to present a preview for.
+&lt;br&gt;Defined variables for &lt;code&gt;&amp;lt;with&amp;gt;&lt;/code&gt; expressions are:
 &lt;/p&gt;
-The default variable used during expression evaluation is bound to the change variable.
+&lt;ul&gt;
+&lt;li&gt;&quot;change&quot;: type &lt;code&gt;org.eclipse.ltk.core.refactoring.Change&lt;/code&gt;; the change object to present a preview for (same as the default variable)&lt;/li&gt;
+&lt;/ul&gt;
       </documentation>
    </annotation>
 
@@ -131,7 +132,7 @@
          <meta.section type="copyright"/>
       </appInfo>
       <documentation>
-         Copyright (c) 2001, 2004 IBM Corporation and others.&lt;br&gt;
+         Copyright (c) 2001, 2013 IBM Corporation and others.&lt;br&gt;
 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 &lt;a href=&quot;http://www.eclipse.org/legal/epl-v10.html&quot;&gt;http://www.eclipse.org/legal/epl-v10.html&lt;/a&gt;
       </documentation>
    </annotation>
diff --git a/org.eclipse.ltk.ui.refactoring/schema/statusContextViewers.exsd b/org.eclipse.ltk.ui.refactoring/schema/statusContextViewers.exsd
index 38bec24..7428c7e 100644
--- a/org.eclipse.ltk.ui.refactoring/schema/statusContextViewers.exsd
+++ b/org.eclipse.ltk.ui.refactoring/schema/statusContextViewers.exsd
@@ -6,15 +6,17 @@
          <meta.schema plugin="org.eclipse.ltk.ui.refactoring" id="statusContextViewers" name="Refactoring Status Context Viewers"/>
       </appInfo>
       <documentation>
-         This extension point is used to define a special viewer capable to present the context of a refactoring status entry to the user. The reader of the extension point provides the following predefined variables which can be accessed during expression evaluation using the &amp;lt;with variable=&quot;...&quot;/&amp;gt; tag:
+         This extension point is used to define a special viewer capable to present the context of a refactoring status entry to the user.
+
 &lt;p&gt;
-&lt;dl&gt;
-  &lt;dt&gt;context&lt;/dt&gt;
-  &lt;dd&gt;the context object managed by the refactoring status entry that is to be presented
-      in the user interface.&lt;/dd&gt;
-&lt;/dl&gt;
+This extension point supports the &lt;code&gt;&amp;lt;enablement&amp;gt;&lt;/code&gt; element.
+&lt;!-- see org.eclipse.ltk.internal.ui.refactoring.AbstractDescriptor#matches(Object, String): --&gt;
+The default variable is the refactoring status context.
+&lt;br&gt;Defined variables for &lt;code&gt;&amp;lt;with&amp;gt;&lt;/code&gt; expressions are:
 &lt;/p&gt;
-Variables can be accessed using the &amp;lt;with variable=&quot;...&quot;/&amp;gt; expression. The default variable used during expression evaluation is bound to the context variable.
+&lt;ul&gt;
+&lt;li&gt;&quot;context&quot;: type &lt;code&gt;org.eclipse.ltk.core.refactoring.RefactoringStatusContext&lt;/code&gt;; the context object managed by the refactoring status entry that is to be presented in the user interface (same as the default variable)&lt;/li&gt;
+&lt;/ul&gt;
       </documentation>
    </annotation>
 
@@ -130,7 +132,7 @@
          <meta.section type="copyright"/>
       </appInfo>
       <documentation>
-         Copyright (c) 2001, 2004 IBM Corporation and others.&lt;br&gt;
+         Copyright (c) 2001, 2013 IBM Corporation and others.&lt;br&gt;
 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 &lt;a href=&quot;http://www.eclipse.org/legal/epl-v10.html&quot;&gt;http://www.eclipse.org/legal/epl-v10.html&lt;/a&gt;
       </documentation>
    </annotation>