[233947] updates to validation documentation
diff --git a/docs/org.eclipse.jst.j2ee.doc.user/images/validatefilters.jpg b/docs/org.eclipse.jst.j2ee.doc.user/images/validatefilters.jpg
new file mode 100644
index 0000000..6481091
--- /dev/null
+++ b/docs/org.eclipse.jst.j2ee.doc.user/images/validatefilters.jpg
Binary files differ
diff --git a/docs/org.eclipse.jst.j2ee.doc.user/index/_17.cfs b/docs/org.eclipse.jst.j2ee.doc.user/index/_17.cfs
deleted file mode 100644
index 19d5043..0000000
--- a/docs/org.eclipse.jst.j2ee.doc.user/index/_17.cfs
+++ /dev/null
Binary files differ
diff --git a/docs/org.eclipse.jst.j2ee.doc.user/index/_18.cfs b/docs/org.eclipse.jst.j2ee.doc.user/index/_18.cfs
new file mode 100644
index 0000000..3402414
--- /dev/null
+++ b/docs/org.eclipse.jst.j2ee.doc.user/index/_18.cfs
Binary files differ
diff --git a/docs/org.eclipse.jst.j2ee.doc.user/index/indexed_contributions b/docs/org.eclipse.jst.j2ee.doc.user/index/indexed_contributions
index f21c8ac..4b6436b 100644
--- a/docs/org.eclipse.jst.j2ee.doc.user/index/indexed_contributions
+++ b/docs/org.eclipse.jst.j2ee.doc.user/index/indexed_contributions
@@ -1,3 +1,3 @@
 #This is a generated file; do not edit.

-#Tue May 13 23:04:33 EDT 2008

+#Tue May 27 10:47:44 EDT 2008

 org.eclipse.jst.j2ee.doc.user=org.eclipse.jst.j2ee.doc.user\n1.1.0.qualifier

diff --git a/docs/org.eclipse.jst.j2ee.doc.user/index/indexed_dependencies b/docs/org.eclipse.jst.j2ee.doc.user/index/indexed_dependencies
index 7162f72..943e5fe 100644
--- a/docs/org.eclipse.jst.j2ee.doc.user/index/indexed_dependencies
+++ b/docs/org.eclipse.jst.j2ee.doc.user/index/indexed_dependencies
@@ -1,4 +1,4 @@
 #This is a generated file; do not edit.

-#Tue May 13 23:04:33 EDT 2008

-lucene=1.9.1.v200803061811

-analyzer=org.eclipse.help.base\#3.3.100.v20080425?locale\=en

+#Tue May 27 10:47:44 EDT 2008

+lucene=1.9.1.v200706111724

+analyzer=org.eclipse.help.base\#3.3.1.v20070813_33x?locale\=en

diff --git a/docs/org.eclipse.jst.j2ee.doc.user/index/indexed_docs b/docs/org.eclipse.jst.j2ee.doc.user/index/indexed_docs
index 6ace860..8289a25 100644
--- a/docs/org.eclipse.jst.j2ee.doc.user/index/indexed_docs
+++ b/docs/org.eclipse.jst.j2ee.doc.user/index/indexed_docs
@@ -1,5 +1,5 @@
 #This is a generated file; do not edit.

-#Tue May 13 23:04:33 EDT 2008

+#Tue May 27 10:47:44 EDT 2008

 /org.eclipse.jst.j2ee.doc.user/topics/cjcircle.html=0

 /org.eclipse.jst.j2ee.doc.user/topics/tjvalselect.html=0

 /org.eclipse.jst.j2ee.doc.user/topics/taddingfacet.html=0

@@ -38,4 +38,5 @@
 /org.eclipse.jst.j2ee.doc.user/topics/cjavaee5.html=0

 /org.eclipse.jst.j2ee.doc.user/topics/tjtargetserver.html=0

 /org.eclipse.jst.j2ee.doc.user/topics/tjvaldisable.html=0

+/org.eclipse.jst.j2ee.doc.user/topics/rtunevalidat.html=0

 /org.eclipse.jst.j2ee.doc.user/topics/tjvalglobalpref.html=0

diff --git a/docs/org.eclipse.jst.j2ee.doc.user/index/segments b/docs/org.eclipse.jst.j2ee.doc.user/index/segments
index 1b625a0..cbc649a 100644
--- a/docs/org.eclipse.jst.j2ee.doc.user/index/segments
+++ b/docs/org.eclipse.jst.j2ee.doc.user/index/segments
Binary files differ
diff --git a/docs/org.eclipse.jst.j2ee.doc.user/jst_j2ee_relsmap.ditamap b/docs/org.eclipse.jst.j2ee.doc.user/jst_j2ee_relsmap.ditamap
index 499435b..d07f946 100644
--- a/docs/org.eclipse.jst.j2ee.doc.user/jst_j2ee_relsmap.ditamap
+++ b/docs/org.eclipse.jst.j2ee.doc.user/jst_j2ee_relsmap.ditamap
@@ -48,7 +48,9 @@
 <topicref href="topics/tjvalselect.dita" navtitle="Selecting code validators">

 </topicref>

 </relcell>

-<relcell></relcell>

+<relcell>

+<topicref href="topics/rtunevalidat.dita" navtitle="Tuning validators"></topicref>

+</relcell>

 </relrow>

 <relrow>

 <relcell collection-type="family">

diff --git a/docs/org.eclipse.jst.j2ee.doc.user/jst_j2ee_toc.ditamap b/docs/org.eclipse.jst.j2ee.doc.user/jst_j2ee_toc.ditamap
index f7248e5..3f2dad8 100644
--- a/docs/org.eclipse.jst.j2ee.doc.user/jst_j2ee_toc.ditamap
+++ b/docs/org.eclipse.jst.j2ee.doc.user/jst_j2ee_toc.ditamap
@@ -92,6 +92,7 @@
 <anchor id="before_validation"/>

 <topicref href="topics/tjval.dita" navtitle="Validating code in enterprise applications">

 <anchor id="validation_top"/>

+<topicref href="topics/rtunevalidat.dita" navtitle="Tuning validators"></topicref>

 <topicref href="topics/rvalerr.dita" navtitle="Common validation errors and solutions">

 </topicref>

 <topicref href="topics/rvalidators.dita" navtitle="J2EE Validators">

diff --git a/docs/org.eclipse.jst.j2ee.doc.user/jst_j2ee_toc.xml b/docs/org.eclipse.jst.j2ee.doc.user/jst_j2ee_toc.xml
index 9cafc27..b8a1c37 100644
--- a/docs/org.eclipse.jst.j2ee.doc.user/jst_j2ee_toc.xml
+++ b/docs/org.eclipse.jst.j2ee.doc.user/jst_j2ee_toc.xml
@@ -62,6 +62,7 @@
 <anchor id="before_validation"/>
 <topic label="Validating code in enterprise applications" href="topics/tjval.html">
 <anchor id="validation_top"/>
+<topic label="Tuning validators" href="topics/rtunevalidat.html"/>
 <topic label="Common validation errors and solutions" href="topics/rvalerr.html"/>
 <topic label="J2EE Validators" href="topics/rvalidators.html">
 <anchor id="childof_validators"/>
diff --git a/docs/org.eclipse.jst.j2ee.doc.user/plugin.properties b/docs/org.eclipse.jst.j2ee.doc.user/plugin.properties
index 8930de3..15a4950 100644
--- a/docs/org.eclipse.jst.j2ee.doc.user/plugin.properties
+++ b/docs/org.eclipse.jst.j2ee.doc.user/plugin.properties
@@ -8,6 +8,7 @@
 # Contributors:
 #     IBM Corporation - initial API and implementation
 ###############################################################################
-
+# NLS_MESSAGEFORMAT_VAR 
+# NLS_ENCODING=UTF-8 
 pluginName = J2EE tools documentation
 pluginProvider = Eclipse.org
diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/rtunevalidat.dita b/docs/org.eclipse.jst.j2ee.doc.user/topics/rtunevalidat.dita
new file mode 100644
index 0000000..fd4f2de
--- /dev/null
+++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/rtunevalidat.dita
@@ -0,0 +1,54 @@
+<?xml version="1.0" encoding="utf-8"?>

+<!--Arbortext, Inc., 1988-2006, v.4002-->

+<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN"

+ "reference.dtd">

+<reference id="rtunevalidat" xml:lang="en-us">

+<title>Tuning validators</title>

+<shortdesc>Whether or not a validator validates a particular resource depends

+on the filters that are in place for that validator.</shortdesc>

+<prolog><metadata>

+<keywords><indexterm>code validation<indexterm>tuning</indexterm></indexterm>

+<indexterm>validation<indexterm>tuning</indexterm></indexterm></keywords>

+</metadata></prolog>

+<refbody>

+<section><p>When a validator is first developed, the implementer of the validator

+defines a default set of filters. These filters may be based on:<ul>

+<li>file extensions</li>

+<li>folder of file names</li>

+<li>project natures</li>

+<li>project facets</li>

+<li>content types</li>

+</ul>Through the Validation Filters dialog, you are able to further tune these

+settings.Normally you would simply keep the defaults, however two reasons

+why you may want to tune validation are:<ul>

+<li>Performance: if you have a very large workspace, you could reduce the

+amount of validation.</li>

+<li>Non standard conventions: if you use a  non standard naming convention

+(for example stores XML in files with an .acme-xml extension), you could still

+enable the appropriate validators to run against those files.</li>

+</ul>You can access this dialog by clicking <menucascade><uicontrol>Window</uicontrol>

+<uicontrol>Preferences</uicontrol><uicontrol>Validation</uicontrol></menucascade> and

+then clicking <uicontrol>Settings</uicontrol> beside each validator.</p><p>Filters

+are stored in groups. There are two types of groups: Include groups and Exclude

+groups. You can have as many Include groups as you like. Filters inside of

+an Include group cause resources to be validated. If any rule matches then

+the entire group matches. Inside of a group the filter rules are OR’d together.

+However individual Include groups are AND’ed together. You can have one Exclude

+group. If any of its filter rules match, then the resource is excluded. Exclusion

+takes precedence over inclusion.</p></section>

+<example><p>These rules are illustrated with this hypothetical example:<image

+href="../images/validatefilters.jpg" placement="break"><alt>screen capture

+of the validation filters panel showing include and exclude groups</alt></image><ul>

+<li>If the resource is in the disabled folder, it will be excluded because

+exclusion takes precedence over everything else.</li>

+<li>If the resource does not have the JSP source content type, and it does

+not have the JSP fragment source content type, and it does not have a file

+extension of .jsp or .jspf then it will be excluded because none of the rules

+in the first group matched.</li>

+<li>If the project does not have the module core nature then it will be excluded

+because the single rule in the second group did not match.</li>

+<li>Otherwise the resource will be validated by this particular validator.</li>

+</ul>To add a rule to a group, select the group on the left, and click <uicontrol>Add

+Rule</uicontrol>.</p></example>

+</refbody>

+</reference>

diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/rtunevalidat.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/rtunevalidat.html
new file mode 100644
index 0000000..e733159
--- /dev/null
+++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/rtunevalidat.html
@@ -0,0 +1,103 @@
+<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html lang="en-us" xml:lang="en-us">
+<head>
+<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
+<meta name="copyright" content="Copyright (c) 2000, 2008 IBM Corporation and others. 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. Contributors: IBM Corporation - initial API and implementation" />
+<meta name="DC.rights.owner" content="(C) Copyright 2000, 2008" />
+<meta content="public" name="security" />
+<meta content="index,follow" name="Robots" />
+<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
+<meta content="reference" name="DC.Type" />
+<meta name="DC.Title" content="Tuning validators" />
+<meta name="abstract" content="Whether or not a validator validates a particular resource depends on the filters that are in place for that validator." />
+<meta name="description" content="Whether or not a validator validates a particular resource depends on the filters that are in place for that validator." />
+<meta content="code validation, tuning, validation" name="DC.subject" />
+<meta content="code validation, tuning, validation" name="keywords" />
+<meta scheme="URI" name="DC.Relation" content="../topics/tjvaldisable.html" />
+<meta scheme="URI" name="DC.Relation" content="../topics/tjvalglobalpref.html" />
+<meta scheme="URI" name="DC.Relation" content="../topics/tjvalmanual.html" />
+<meta scheme="URI" name="DC.Relation" content="../topics/tjvalselect.html" />
+<meta content="XHTML" name="DC.Format" />
+<meta content="rtunevalidat" name="DC.Identifier" />
+<meta content="en-us" name="DC.Language" />
+<link href="../../org.eclipse.wst.doc.user/common.css" type="text/css" rel="stylesheet" />
+<title>Tuning validators</title>
+</head>
+<body id="rtunevalidat"><a name="rtunevalidat"><!-- --></a>
+
+
+<h1 class="topictitle1">Tuning validators</h1>
+
+
+
+<div><p>Whether or not a validator validates a particular resource depends
+on the filters that are in place for that validator.</p>
+
+<div class="section"><div class="p">When a validator is first developed, the implementer of the validator
+defines a default set of filters. These filters may be based on:<ul>
+<li>file extensions</li>
+
+<li>folder of file names</li>
+
+<li>project natures</li>
+
+<li>project facets</li>
+
+<li>content types</li>
+
+</ul>
+Through the Validation Filters dialog, you are able to further tune these
+settings.Normally you would simply keep the defaults, however two reasons
+why you may want to tune validation are:<ul>
+<li>Performance: if you have a very large workspace, you could reduce the
+amount of validation.</li>
+
+<li>Non standard conventions: if you use a  non standard naming convention
+(for example stores XML in files with an .acme-xml extension), you could still
+enable the appropriate validators to run against those files.</li>
+
+</ul>
+You can access this dialog by clicking <span class="menucascade"><span class="uicontrol">Window</span>
+ &gt; <span class="uicontrol">Preferences</span> &gt; <span class="uicontrol">Validation</span></span> and
+then clicking <span class="uicontrol">Settings</span> beside each validator.</div>
+<p>Filters
+are stored in groups. There are two types of groups: Include groups and Exclude
+groups. You can have as many Include groups as you like. Filters inside of
+an Include group cause resources to be validated. If any rule matches then
+the entire group matches. Inside of a group the filter rules are OR’d together.
+However individual Include groups are AND’ed together. You can have one Exclude
+group. If any of its filter rules match, then the resource is excluded. Exclusion
+takes precedence over inclusion.</p>
+</div>
+
+<div class="example"><div class="p">These rules are illustrated with this hypothetical example:<br /><img src="../images/validatefilters.jpg" alt="screen capture&#10;of the validation filters panel showing include and exclude groups" /><br /><ul>
+<li>If the resource is in the disabled folder, it will be excluded because
+exclusion takes precedence over everything else.</li>
+
+<li>If the resource does not have the JSP source content type, and it does
+not have the JSP fragment source content type, and it does not have a file
+extension of .jsp or .jspf then it will be excluded because none of the rules
+in the first group matched.</li>
+
+<li>If the project does not have the module core nature then it will be excluded
+because the single rule in the second group did not match.</li>
+
+<li>Otherwise the resource will be validated by this particular validator.</li>
+
+</ul>
+To add a rule to a group, select the group on the left, and click <span class="uicontrol">Add
+Rule</span>.</div>
+</div>
+
+</div>
+
+<div><div class="reltasks"><strong>Related tasks</strong><br />
+<div><a href="../topics/tjvaldisable.html" title="You can disable one or more validators individually or disable validation entirely. Also, you can set validation settings for your entire workspace and for individual projects.">Disabling validation</a></div>
+<div><a href="../topics/tjvalglobalpref.html" title="For a given project, you can override the global validation preferences.">Overriding global validation preferences</a></div>
+<div><a href="../topics/tjvalmanual.html" title="When you run a manual validation, all resources in the selected project are validated according to the validation settings.">Manually validating code</a></div>
+<div><a href="../topics/tjvalselect.html" title="You can select specific validators to run during manual and build code validation. You can set each validator to run on manual validation, build validation, both, or neither.">Selecting code validators</a></div>
+</div>
+</div>
+
+</body>
+</html>
\ No newline at end of file
diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjval.dita b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjval.dita
index 851f9e6..d17be81 100644
--- a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjval.dita
+++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjval.dita
@@ -15,7 +15,7 @@
 <context outputclass="id_context"> <p outputclass="anchor_topictop"></p> <p>By

 default, the workbench validates your files automatically after any build,

 including automatic builds. You can also begin the validation process manually

-without building.</p><p>On the workbench Properties window, you can enable

+without building.</p><p>On the workbench Preferences window, you can enable

 or disable validators to be used on your projects. Also, you can enable or

 disable validators for each enterprise application module project individually

 on the Properties page for that project.</p><p>Each validator can apply to

@@ -41,19 +41,21 @@
 validation at the global level.</chdesc></chrow>

 <chrow><choption>Save all modified resources automatically prior to validating</choption>

 <chdesc>Select to save resources you have modified before the validation begins.</chdesc>

+</chrow><chrow><choption>Show a confirmation dialog when performing manual validation</choption>

+<chdesc>Select to show an informational dialog after a manual validation request has completed.</chdesc>

 </chrow>

 </choicetable>

 </step>

 <step><cmd>In the list of validators, select the check boxes next to each

 validator you want to use at the global level.</cmd><info>Each validator has

-a check box to specify whether it is used on manual validation or on build

+a check box to specify whether it is used on manual validation and/or on build

 validation.</info></step>

-<step><cmd>Choose an alternate implementation for a validator by clicking

-the button in the <uicontrol>Settings</uicontrol> column, then click <uicontrol>OK</uicontrol>.</cmd>

-<info>Not all validators have alternate implementations.</info></step>

+<step><cmd>Tune a validator by clicking

+the button in the <uicontrol>Settings</uicontrol> column.</cmd>

+<info>Not all validators have additional settings.</info></step>

 <step><cmd>Begin the validation process by one of the following methods:</cmd>

 <choices>

-<choice>Right-click a project and click <uicontrol>Run Validation</uicontrol>.</choice>

+<choice>Right-click a project and click <uicontrol>Validate</uicontrol>.</choice>

 <choice>Start a build.</choice>

 </choices>

 </step>

diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjval.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjval.html
index 9e4ccd1..04ab6a2 100644
--- a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjval.html
+++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjval.html
@@ -36,7 +36,7 @@
 default, the workbench validates your files automatically after any build,
 including automatic builds. You can also begin the validation process manually
 without building.</p>
-<p>On the workbench Properties window, you can enable
+<p>On the workbench Preferences window, you can enable
 or disable validators to be used on your projects. Also, you can enable or
 disable validators for each enterprise application module project individually
 on the Properties page for that project.</p>
@@ -80,6 +80,11 @@
 <td valign="top" headers="N100A9-desc N100E1">Select to save resources you have modified before the validation begins.</td>
 
 </tr>
+<tr><td valign="top" headers="N100A9-option" id="N100F1"><strong>Show a confirmation dialog when performing manual validation</strong></td>
+
+<td valign="top" headers="N100A9-desc N100F1">Select to show an informational dialog after a manual validation request has completed.</td>
+
+</tr>
 
 </tbody></table>
 
@@ -87,16 +92,16 @@
 
 <li class="stepexpand"><span>In the list of validators, select the check boxes next to each
 validator you want to use at the global level.</span> Each validator has
-a check box to specify whether it is used on manual validation or on build
+a check box to specify whether it is used on manual validation and/or on build
 validation.</li>
 
-<li class="stepexpand"><span>Choose an alternate implementation for a validator by clicking
-the button in the <span class="uicontrol">Settings</span> column, then click <span class="uicontrol">OK</span>.</span>
- Not all validators have alternate implementations.</li>
+<li class="stepexpand"><span>Tune a validator by clicking
+the button in the <span class="uicontrol">Settings</span> column.</span>
+ Not all validators have additional settings.</li>
 
 <li class="stepexpand"><span>Begin the validation process by one of the following methods:</span>
 <ul>
-<li>Right-click a project and click <span class="uicontrol">Run Validation</span>.</li>
+<li>Right-click a project and click <span class="uicontrol">Validate</span>.</li>
 
 <li>Start a build.</li>
 
diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvaldisable.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvaldisable.html
index ee191c4..15fbb8f 100644
--- a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvaldisable.html
+++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvaldisable.html
@@ -16,6 +16,7 @@
 <meta scheme="URI" name="DC.Relation" content="../topics/tjvalglobalpref.html" />
 <meta scheme="URI" name="DC.Relation" content="../topics/tjvalmanual.html" />
 <meta scheme="URI" name="DC.Relation" content="../topics/tjvalselect.html" />
+<meta scheme="URI" name="DC.Relation" content="../topics/rtunevalidat.html" />
 <meta content="XHTML" name="DC.Format" />
 <meta content="tjvaldisable" name="DC.Identifier" />
 <meta content="en-us" name="DC.Language" />
@@ -90,6 +91,9 @@
 <div><a href="../topics/tjvalmanual.html" title="When you run a manual validation, all resources in the selected project are validated according to the validation settings.">Manually validating code</a></div>
 <div><a href="../topics/tjvalselect.html" title="You can select specific validators to run during manual and build code validation. You can set each validator to run on manual validation, build validation, both, or neither.">Selecting code validators</a></div>
 </div>
+<div class="relref"><strong>Related reference</strong><br />
+<div><a href="../topics/rtunevalidat.html" title="Whether or not a validator validates a particular resource depends on the filters that are in place for that validator.">Tuning validators</a></div>
+</div>
 </div>
 
 </body>
diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalglobalpref.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalglobalpref.html
index 52fa59c..894560d 100644
--- a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalglobalpref.html
+++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalglobalpref.html
@@ -16,6 +16,7 @@
 <meta scheme="URI" name="DC.Relation" content="../topics/tjvaldisable.html" />
 <meta scheme="URI" name="DC.Relation" content="../topics/tjvalmanual.html" />
 <meta scheme="URI" name="DC.Relation" content="../topics/tjvalselect.html" />
+<meta scheme="URI" name="DC.Relation" content="../topics/rtunevalidat.html" />
 <meta content="XHTML" name="DC.Format" />
 <meta content="tjvalglobalpref" name="DC.Identifier" />
 <meta content="en-us" name="DC.Language" />
@@ -84,6 +85,9 @@
 <div><a href="../topics/tjvalmanual.html" title="When you run a manual validation, all resources in the selected project are validated according to the validation settings.">Manually validating code</a></div>
 <div><a href="../topics/tjvalselect.html" title="You can select specific validators to run during manual and build code validation. You can set each validator to run on manual validation, build validation, both, or neither.">Selecting code validators</a></div>
 </div>
+<div class="relref"><strong>Related reference</strong><br />
+<div><a href="../topics/rtunevalidat.html" title="Whether or not a validator validates a particular resource depends on the filters that are in place for that validator.">Tuning validators</a></div>
+</div>
 </div>
 
 </body>
diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalmanual.dita b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalmanual.dita
index 4f67f5f..03b800f 100644
--- a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalmanual.dita
+++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalmanual.dita
@@ -26,7 +26,7 @@
 complete the following steps<?Pub Caret?>:</p></context>

 <steps outputclass="id_steps">

 <step><cmd>Select the project that you want to validate.</cmd></step>

-<step><cmd>Right-click the project and then click <uicontrol>Run Validation</uicontrol>.</cmd>

+<step><cmd>Right-click the project and then click <uicontrol>Validate</uicontrol>.</cmd>

 <info>If this option is not available, validation is disabled or there are

 no validators enabled for the project. To enable validation at the global

 level, see <xref href="tjval.dita"></xref>. To enable validators for this

diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalmanual.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalmanual.html
index 48463a0..b5bbfd2 100644
--- a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalmanual.html
+++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalmanual.html
@@ -16,6 +16,7 @@
 <meta scheme="URI" name="DC.Relation" content="../topics/tjvaldisable.html" />
 <meta scheme="URI" name="DC.Relation" content="../topics/tjvalglobalpref.html" />
 <meta scheme="URI" name="DC.Relation" content="../topics/tjvalselect.html" />
+<meta scheme="URI" name="DC.Relation" content="../topics/rtunevalidat.html" />
 <meta content="XHTML" name="DC.Format" />
 <meta content="tjvalmanual" name="DC.Identifier" />
 <meta content="en-us" name="DC.Language" />
@@ -56,7 +57,7 @@
 <ol class="id_steps">
 <li class="stepexpand"><span>Select the project that you want to validate.</span></li>
 
-<li class="stepexpand"><span>Right-click the project and then click <span class="uicontrol">Run Validation</span>.</span>
+<li class="stepexpand"><span>Right-click the project and then click <span class="uicontrol">Validate</span>.</span>
  If this option is not available, validation is disabled or there are
 no validators enabled for the project. To enable validation at the global
 level, see <a href="tjval.html" title="The workbench includes validators that&#10;check certain files in your enterprise application module projects for errors.">Validating code in enterprise applications</a>. To enable validators for this
@@ -78,6 +79,9 @@
 <div><a href="../topics/tjvalglobalpref.html" title="For a given project, you can override the global validation preferences.">Overriding global validation preferences</a></div>
 <div><a href="../topics/tjvalselect.html" title="You can select specific validators to run during manual and build code validation. You can set each validator to run on manual validation, build validation, both, or neither.">Selecting code validators</a></div>
 </div>
+<div class="relref"><strong>Related reference</strong><br />
+<div><a href="../topics/rtunevalidat.html" title="Whether or not a validator validates a particular resource depends on the filters that are in place for that validator.">Tuning validators</a></div>
+</div>
 </div>
 
 </body>
diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalselect.dita b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalselect.dita
index d0547d5..5e5e5cf 100644
--- a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalselect.dita
+++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalselect.dita
@@ -31,11 +31,12 @@
 validator you want to use at the global level.</cmd><info>Each validator has

 a check box to specify whether it is used on manual validation or on a build.<note>If

 you deselect any validator that is currently selected, any messages associated

-with the deselected validator will be removed from the task list.</note></info>

+with the deselected validator will be removed from the task list,

+the next time you perform a full build.</note></info>

 </step>

-<step><cmd>Choose an alternate implementation for a validator by clicking

-the button in the <uicontrol>Settings</uicontrol> column, then click <uicontrol>OK</uicontrol>.</cmd>

-<info>Not all validators have alternate implementations.</info></step>

+<step><cmd>Tune a validator by clicking

+the button in the <uicontrol>Settings</uicontrol> column.</cmd>

+<info>Not all validators have additional settings.</info></step>

 </steps>

 <result>If you want to set individual validation settings for one or more

 of your projects, see <xref href="tjvalglobalpref.dita"></xref>. Like the

diff --git a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalselect.html b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalselect.html
index 6ba8ccd..c4e4aa2 100644
--- a/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalselect.html
+++ b/docs/org.eclipse.jst.j2ee.doc.user/topics/tjvalselect.html
@@ -16,6 +16,7 @@
 <meta scheme="URI" name="DC.Relation" content="../topics/tjvaldisable.html" />
 <meta scheme="URI" name="DC.Relation" content="../topics/tjvalglobalpref.html" />
 <meta scheme="URI" name="DC.Relation" content="../topics/tjvalmanual.html" />
+<meta scheme="URI" name="DC.Relation" content="../topics/rtunevalidat.html" />
 <meta content="XHTML" name="DC.Format" />
 <meta content="tjvalselect" name="DC.Identifier" />
 <meta content="en-us" name="DC.Language" />
@@ -57,13 +58,14 @@
 validator you want to use at the global level.</span> Each validator has
 a check box to specify whether it is used on manual validation or on a build.<div class="note"><span class="notetitle">Note:</span> If
 you deselect any validator that is currently selected, any messages associated
-with the deselected validator will be removed from the task list.</div>
+with the deselected validator will be removed from the task list,
+the next time you perform a full build.</div>
 
 </li>
 
-<li class="stepexpand"><span>Choose an alternate implementation for a validator by clicking
-the button in the <span class="uicontrol">Settings</span> column, then click <span class="uicontrol">OK</span>.</span>
- Not all validators have alternate implementations.</li>
+<li class="stepexpand"><span>Tune a validator by clicking
+the button in the <span class="uicontrol">Settings</span> column.</span>
+ Not all validators have additional settings.</li>
 
 </ol>
 
@@ -82,6 +84,9 @@
 <div><a href="../topics/tjvalglobalpref.html" title="For a given project, you can override the global validation preferences.">Overriding global validation preferences</a></div>
 <div><a href="../topics/tjvalmanual.html" title="When you run a manual validation, all resources in the selected project are validated according to the validation settings.">Manually validating code</a></div>
 </div>
+<div class="relref"><strong>Related reference</strong><br />
+<div><a href="../topics/rtunevalidat.html" title="Whether or not a validator validates a particular resource depends on the filters that are in place for that validator.">Tuning validators</a></div>
+</div>
 </div>
 
 </body>