Added some HTML documentation for the XSL Tooling Preference pages

13 files changed, 219 insertions, 25 deletions

diff --git a/docs/org.eclipse.wst.xsl.doc/docbook/preferences/preferences.xml b/docs/org.eclipse.wst.xsl.doc/docbook/preferences/preferences.xml
index a4e123c..402c856 100644
--- a/docs/org.eclipse.wst.xsl.doc/docbook/preferences/preferences.xml
+++ b/docs/org.eclipse.wst.xsl.doc/docbook/preferences/preferences.xml
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <chapter id="XSLPreferences" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 	xsi:noNamespaceSchemaLocation="http://www.docbook.org/xsd/4.5/docbook.xsd">
+	<?dbhtml filename="xslpreferences.html" ?>
 	<title>XSL Tooling Preferences</title>
 	<para>
 		The XSL Preference pages has several sub sections.  Each of these allow for configuration
@@ -10,11 +11,12 @@
    </para>
 	<mediaobject>
 		<imageobject>
-			<imagedata align="center" fileref="images/preferences/xslpreferences.png"
+			<imagedata align="center" fileref="../images/preferences/xslpreferences.png"
 				format="PNG" />
 		</imageobject>
 	</mediaobject>
 	<section id="XSLFeatures">
+		<?dbhtml filename="xslfeatures.html" ?>
 		<title>Features</title>
 		<para>
    			The XSL Features preference page allows for the configuration of features for a particular
@@ -25,7 +27,7 @@
 		<mediaobject>
 			<imageobject>
 				<imagedata align="center" format="PNG"
-					fileref="images/preferences/xslfeatures.png" />
+					fileref="../images/preferences/xslfeatures.png" />
 			</imageobject>
 		</mediaobject>
 		<para>
@@ -41,6 +43,7 @@
    		</para>
 	</section>
 	<section id="XSLProcessors">
+		<?dbhtml filename="xslprocessors.html" ?>
 		<title>Installed Processors</title>
 		<para>
   			The installed processors page lets you pick which of the installed XSLT processors will be used
@@ -49,11 +52,12 @@
       	</para>
       	<mediaobject>
       	   <imageobject>
-      	   		<imagedata align="center" fileref="images/preferences/xsl_InstalledProcessors.png" format="PNG"/>
+      	   		<imagedata align="center" fileref="../images/preferences/xsl_InstalledProcessors.png" format="PNG"/>
       	   </imageobject>
       	</mediaobject>
 	</section>
 	<section id="XSLOutputProperties">
+		<?dbhtml filename="xsloutputproperties.html" ?>
 		<title>Output Properties</title>
 		<para>
 			The various xsl processors support a wide variety of processor specific tweaks.  However there
@@ -63,7 +67,7 @@
 		</para>
 		<mediaobject>
 		    <imageobject>
-		    	<imagedata align="center" fileref="images/preferences/xsl_outputproperties.png" format="PNG"/>
+		    	<imagedata align="center" fileref="../images/preferences/xsl_outputproperties.png" format="PNG"/>
 		    </imageobject>
 		</mediaobject>
 		<para>
diff --git a/docs/org.eclipse.wst.xsl.doc/docbook/preferences/preferences.xml.out.xml b/docs/org.eclipse.wst.xsl.doc/docbook/preferences/preferences.xml.out.xml
new file mode 100644
index 0000000..8b13789
--- /dev/null
+++ b/docs/org.eclipse.wst.xsl.doc/docbook/preferences/preferences.xml.out.xml
@@ -0,0 +1 @@
+
diff --git a/docs/org.eclipse.wst.xsl.doc/html/images/preferences/XPathTemplates.png b/docs/org.eclipse.wst.xsl.doc/html/images/preferences/XPathTemplates.png
new file mode 100644
index 0000000..0f89304
--- /dev/null
+++ b/docs/org.eclipse.wst.xsl.doc/html/images/preferences/XPathTemplates.png
diff --git a/docs/org.eclipse.wst.xsl.doc/html/images/preferences/xm_template_xslnewfile.png b/docs/org.eclipse.wst.xsl.doc/html/images/preferences/xm_template_xslnewfile.png
new file mode 100644
index 0000000..7646a6d
--- /dev/null
+++ b/docs/org.eclipse.wst.xsl.doc/html/images/preferences/xm_template_xslnewfile.png
diff --git a/docs/org.eclipse.wst.xsl.doc/html/images/preferences/xsl_InstalledProcessors.png b/docs/org.eclipse.wst.xsl.doc/html/images/preferences/xsl_InstalledProcessors.png
new file mode 100644
index 0000000..3295079
--- /dev/null
+++ b/docs/org.eclipse.wst.xsl.doc/html/images/preferences/xsl_InstalledProcessors.png
diff --git a/docs/org.eclipse.wst.xsl.doc/html/images/preferences/xsl_outputproperties.png b/docs/org.eclipse.wst.xsl.doc/html/images/preferences/xsl_outputproperties.png
new file mode 100644
index 0000000..4e00a42
--- /dev/null
+++ b/docs/org.eclipse.wst.xsl.doc/html/images/preferences/xsl_outputproperties.png
diff --git a/docs/org.eclipse.wst.xsl.doc/html/images/preferences/xslfeatures.png b/docs/org.eclipse.wst.xsl.doc/html/images/preferences/xslfeatures.png
new file mode 100644
index 0000000..29dbec8
--- /dev/null
+++ b/docs/org.eclipse.wst.xsl.doc/html/images/preferences/xslfeatures.png
diff --git a/docs/org.eclipse.wst.xsl.doc/html/images/preferences/xslpreferences.png b/docs/org.eclipse.wst.xsl.doc/html/images/preferences/xslpreferences.png
new file mode 100644
index 0000000..dcb7187
--- /dev/null
+++ b/docs/org.eclipse.wst.xsl.doc/html/images/preferences/xslpreferences.png
diff --git a/docs/org.eclipse.wst.xsl.doc/html/preferences/xsloutputproperties.html b/docs/org.eclipse.wst.xsl.doc/html/preferences/xsloutputproperties.html
new file mode 100644
index 0000000..b5ac86f
--- /dev/null
+++ b/docs/org.eclipse.wst.xsl.doc/html/preferences/xsloutputproperties.html
@@ -0,0 +1,56 @@
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>Output Properties</title>
+<meta content="DocBook XSL Stylesheets V1.73.2" name="generator">
+<link rel="start" href="xslpreferences.html" title="Chapter&nbsp;1.&nbsp;XSL Tooling Preferences">
+<link rel="up" href="xslpreferences.html" title="Chapter&nbsp;1.&nbsp;XSL Tooling Preferences">
+<link rel="prev" href="xslprocessors.html" title="Installed Processors">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<div class="navheader">
+<table summary="Navigation header" width="100%">
+<tr>
+<th align="center" colspan="3">Output Properties</th>
+</tr>
+<tr>
+<td align="left" width="20%"><a accesskey="p" href="xslprocessors.html">Prev</a>&nbsp;</td><th align="center" width="60%">&nbsp;</th><td align="right" width="20%">&nbsp;</td>
+</tr>
+</table>
+<hr>
+</div>
+<div class="section" lang="en">
+<div class="titlepage">
+<div>
+<div>
+<h2 class="title" style="clear: both">
+<a name="XSLOutputProperties"></a>Output Properties</h2>
+</div>
+</div>
+</div>
+<p>
+			The various xsl processors support a wide variety of processor specific tweaks.  However there
+			are several Standard processor features that all XSLT processors support.   These options can be
+			set and will act as the defaults for all transformations unless they are specifically overriden by
+			the stylesheet or the launch configuration.
+		</p>
+<div class="mediaobject" align="center">
+<img src="../images/preferences/xsl_outputproperties.png" align="middle"></div>
+<p>
+			In addition to the Standard Output Properties, each XSLT processor can have processors
+			specific features.
+		</p>
+</div>
+<div class="navfooter">
+<hr>
+<table summary="Navigation footer" width="100%">
+<tr>
+<td align="left" width="40%"><a accesskey="p" href="xslprocessors.html">Prev</a>&nbsp;</td><td align="center" width="20%">&nbsp;</td><td align="right" width="40%">&nbsp;</td>
+</tr>
+<tr>
+<td valign="top" align="left" width="40%">Installed Processors&nbsp;</td><td align="center" width="20%"><a accesskey="h" href="xslpreferences.html">Home</a>&nbsp;|&nbsp;<a accesskey="t" href="ch01-toc.html">ToC</a></td><td valign="top" align="right" width="40%">&nbsp;</td>
+</tr>
+</table>
+</div>
+</body>
+</html>
diff --git a/docs/org.eclipse.wst.xsl.doc/html/preferences/xslpreferences.html b/docs/org.eclipse.wst.xsl.doc/html/preferences/xslpreferences.html
new file mode 100644
index 0000000..290fc9d
--- /dev/null
+++ b/docs/org.eclipse.wst.xsl.doc/html/preferences/xslpreferences.html
@@ -0,0 +1,96 @@
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>Chapter&nbsp;1.&nbsp;XSL Tooling Preferences</title>
+<meta content="DocBook XSL Stylesheets V1.73.2" name="generator">
+<link rel="start" href="xslpreferences.html" title="Chapter&nbsp;1.&nbsp;XSL Tooling Preferences">
+<link rel="next" href="xslprocessors.html" title="Installed Processors">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<div class="navheader">
+<table summary="Navigation header" width="100%">
+<tr>
+<th align="center" colspan="3">Chapter&nbsp;1.&nbsp;XSL Tooling Preferences</th>
+</tr>
+<tr>
+<td align="left" width="20%">&nbsp;</td><th align="center" width="60%">&nbsp;</th><td align="right" width="20%">&nbsp;<a accesskey="n" href="xslprocessors.html">Next</a></td>
+</tr>
+</table>
+<hr>
+</div>
+<div class="chapter" lang="en">
+<div class="titlepage">
+<div>
+<div>
+<h2 class="title">
+<a name="XSLPreferences"></a>Chapter&nbsp;1.&nbsp;XSL Tooling Preferences</h2>
+</div>
+</div>
+</div>
+<div class="toc">
+<p>
+<b>Table of Contents</b>
+</p>
+<dl>
+<dt>
+<span class="section"><a href="xslpreferences.html#XSLFeatures">Features</a></span>
+</dt>
+<dt>
+<span class="section"><a href="xslprocessors.html">Installed Processors</a></span>
+</dt>
+<dt>
+<span class="section"><a href="xsloutputproperties.html">Output Properties</a></span>
+</dt>
+</dl>
+</div>
+<p>
+		The XSL Preference pages has several sub sections.  Each of these allow for configuration
+		of various aspects of the preferences.   From the controlling of the default XSL processor
+		to be used during transformations.   To extending the content assist support of the XPath
+		functions available in the XML editor.
+   </p>
+<div class="mediaobject" align="center">
+<img src="../images/preferences/xslpreferences.png" align="middle"></div>
+<div class="section" lang="en">
+<div class="titlepage">
+<div>
+<div>
+<h2 class="title" style="clear: both">
+<a name="XSLFeatures"></a>Features</h2>
+</div>
+</div>
+</div>
+<p>
+   			The XSL Features preference page allows for the configuration of features for a particular
+   			processor.   XSL Tooling comes with Xalan 2.7.0 by default.  Adopters can extend and include
+   			their own specific features for their own procesoors.   An adopter could extend the tooling
+   			to support XSLT 2.0 transformations, and features particular to that parser.
+   		</p>
+<div class="mediaobject" align="center">
+<img src="../images/preferences/xslfeatures.png" align="middle"></div>
+<p>
+   			The <span class="bold"><strong>Processor Type</strong></span> allows you to set features for a specific processor.  In this case
+   			this is for the processor that is being installed.   XSL Tooling comes with Xalan 2.7.0, and it is the only available
+   			processor type by default.
+   		</p>
+<p>
+   		    The feature table lists the features that are specific to the processor that was selected.  As you
+   		    select each of the features, information regarding that feature and it's abilitis is displayed in the
+   		    description box.   By clicking in the value column, next to the feature you want to set the value
+   		    for, the user can set the feature.
+   		</p>
+</div>
+</div>
+<div class="navfooter">
+<hr>
+<table summary="Navigation footer" width="100%">
+<tr>
+<td align="left" width="40%">&nbsp;</td><td align="center" width="20%">&nbsp;</td><td align="right" width="40%">&nbsp;<a accesskey="n" href="xslprocessors.html">Next</a></td>
+</tr>
+<tr>
+<td valign="top" align="left" width="40%">&nbsp;</td><td align="center" width="20%">&nbsp;<a accesskey="t" href="ch01-toc.html">ToC</a></td><td valign="top" align="right" width="40%">&nbsp;Installed Processors</td>
+</tr>
+</table>
+</div>
+</body>
+</html>
diff --git a/docs/org.eclipse.wst.xsl.doc/html/preferences/xslprocessors.html b/docs/org.eclipse.wst.xsl.doc/html/preferences/xslprocessors.html
new file mode 100644
index 0000000..b1d5df8
--- /dev/null
+++ b/docs/org.eclipse.wst.xsl.doc/html/preferences/xslprocessors.html
@@ -0,0 +1,52 @@
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<title>Installed Processors</title>
+<meta content="DocBook XSL Stylesheets V1.73.2" name="generator">
+<link rel="start" href="xslpreferences.html" title="Chapter&nbsp;1.&nbsp;XSL Tooling Preferences">
+<link rel="up" href="xslpreferences.html" title="Chapter&nbsp;1.&nbsp;XSL Tooling Preferences">
+<link rel="prev" href="xslpreferences.html" title="Chapter&nbsp;1.&nbsp;XSL Tooling Preferences">
+<link rel="next" href="xsloutputproperties.html" title="Output Properties">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<div class="navheader">
+<table summary="Navigation header" width="100%">
+<tr>
+<th align="center" colspan="3">Installed Processors</th>
+</tr>
+<tr>
+<td align="left" width="20%"><a accesskey="p" href="xslpreferences.html">Prev</a>&nbsp;</td><th align="center" width="60%">&nbsp;</th><td align="right" width="20%">&nbsp;<a accesskey="n" href="xsloutputproperties.html">Next</a></td>
+</tr>
+</table>
+<hr>
+</div>
+<div class="section" lang="en">
+<div class="titlepage">
+<div>
+<div>
+<h2 class="title" style="clear: both">
+<a name="XSLProcessors"></a>Installed Processors</h2>
+</div>
+</div>
+</div>
+<p>
+  			The installed processors page lets you pick which of the installed XSLT processors will be used
+  			by default.   The default is the System Default Procesoor, but you can select any of the
+  			available processors to be used as the default processor.    	
+      	</p>
+<div class="mediaobject" align="center">
+<img src="../images/preferences/xsl_InstalledProcessors.png" align="middle"></div>
+</div>
+<div class="navfooter">
+<hr>
+<table summary="Navigation footer" width="100%">
+<tr>
+<td align="left" width="40%"><a accesskey="p" href="xslpreferences.html">Prev</a>&nbsp;</td><td align="center" width="20%">&nbsp;</td><td align="right" width="40%">&nbsp;<a accesskey="n" href="xsloutputproperties.html">Next</a></td>
+</tr>
+<tr>
+<td valign="top" align="left" width="40%">Chapter&nbsp;1.&nbsp;XSL Tooling Preferences&nbsp;</td><td align="center" width="20%"><a accesskey="h" href="xslpreferences.html">Home</a>&nbsp;|&nbsp;<a accesskey="t" href="ch01-toc.html">ToC</a></td><td valign="top" align="right" width="40%">&nbsp;Output Properties</td>
+</tr>
+</table>
+</div>
+</body>
+</html>
diff --git a/docs/org.eclipse.wst.xsl.doc/toc.xml b/docs/org.eclipse.wst.xsl.doc/toc.xml
index 13bbc01..96f43ed 100644
--- a/docs/org.eclipse.wst.xsl.doc/toc.xml
+++ b/docs/org.eclipse.wst.xsl.doc/toc.xml
@@ -1,14 +1,10 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <?NLS TYPE="org.eclipse.help.toc"?>
-
-<toc label="Sample Table of Contents" topic="html/toc.html">
-   <topic label="Getting Started">
-      <anchor id="gettingstarted"/>
-   </topic>
-   <topic label="Reference">
-      <anchor id="reference"/>
-   </topic>
-   <topic label="Samples">
-      <anchor id="samples"/>
+<toc label="XSL Tooling" topic="html/toc.html">
+   <anchor id="XSLBegin"/>
+   <topic href="html/preferences/xslpreferences.html" label="XSL Preferences">
+      <anchor id="xslpreferences"/>
+      <topic href="html/preferences/xsloutputproperties.html" label="Output Properties"/>
+      <topic href="html/preferences/xslprocessors.html" label="XSL Processors"/>
    </topic>
 </toc>
diff --git a/docs/org.eclipse.wst.xsl.doc/tocgettingstarted.xml b/docs/org.eclipse.wst.xsl.doc/tocgettingstarted.xml
deleted file mode 100644
index 38f27e0..0000000
--- a/docs/org.eclipse.wst.xsl.doc/tocgettingstarted.xml
+++ /dev/null
@@ -1,11 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<?NLS TYPE="org.eclipse.help.toc"?>
-
-<toc label="Getting Started" link_to="toc.xml#gettingstarted"> 
-	<topic label="Main Topic"  href="html/gettingstarted/maintopic.html"> 
-		<topic label="Sub Topic" href="html/gettingstarted/subtopic.html" /> 
-	</topic>
-	<topic label="Main Topic 2">
-		<topic label="Sub Topic 2" href="html/gettingstarted/subtopic2.html" />
-	</topic> 
-</toc>