[233947] updates to validation documentation

21 files changed, 217 insertions, 29 deletions

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 000000000..64810913a
--- /dev/null
+++ b/docs/org.eclipse.jst.j2ee.doc.user/images/validatefilters.jpg
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 19d50437a..000000000
--- a/docs/org.eclipse.jst.j2ee.doc.user/index/_17.cfs
+++ /dev/null
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 000000000..3402414e8
--- /dev/null
+++ b/docs/org.eclipse.jst.j2ee.doc.user/index/_18.cfs
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 f21c8ac5a..4b6436b91 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 7162f7251..943e5fe77 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 6ace86075..8289a250b 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 1b625a0e6..cbc649a94 100644
--- a/docs/org.eclipse.jst.j2ee.doc.user/index/segments
+++ b/docs/org.eclipse.jst.j2ee.doc.user/index/segments
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 499435bf3..d07f94667 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 @@ scope="peer"></topicref>
 <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 f7248e508..3f2dad802 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 @@ is imported"></topicref>
 <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 9cafc27c3..b8a1c3711 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 8930de3ed..15a495037 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 000000000..fd4f2de31
--- /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 000000000..e73315936
--- /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 851f9e656..d17be81a6 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 @@ check certain files in your enterprise application module projects for errors.</
 <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 @@ projects.</chdesc></chrow>
 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 9e4ccd108..04ab6a212 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 @@ check certain files in your enterprise application module projects for errors.</
 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 @@ validation at the global level.</td>
 <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 @@ validation at the global level.</td>
 
 <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 ee191c448..15fbb8f45 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 @@ of your projects, see <a href="tjvalglobalpref.html" title="For a given project,
 <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 52fa59c8e..894560da9 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 @@ the button in the <span class="uicontrol">Settings</span> column, then click <sp
 <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 4f67f5fac..03b800f8a 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 @@ run a manual validation.</p><p>To manually invoke an immediate code validation,
 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 48463a0e6..b5bbfd27a 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 @@ complete the following steps:</p>
 <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 @@ Problems view.</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/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 d0547d594..5e5e5cf4f 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 @@ projects to override these preference settings</uicontrol> check box.</cmd>
 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 6ba8ccdef..c4e4aa254 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 @@ projects to override these preference settings</span> check box.</span>
 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 @@ to run on manual validation, build validation, both, or neither.</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>
+<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>