Skip to main content
summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorpelder2006-11-21 15:35:08 -0500
committerpelder2006-11-21 15:35:08 -0500
commit0ff861880316a067249750eba5530b799194e002 (patch)
treeb4f902403bd17c5d83037679179c2aa248be2d51 /doc/org.eclipse.jet.doc/references/taglibs
parent85e924faca7becbb1ce6bc080e8a4c2784d69587 (diff)
downloadorg.eclipse.jet-0ff861880316a067249750eba5530b799194e002.tar.gz
org.eclipse.jet-0ff861880316a067249750eba5530b799194e002.tar.xz
org.eclipse.jet-0ff861880316a067249750eba5530b799194e002.zip
[163849] Merge in 0.7.x maintenance fixes
Diffstat (limited to 'doc/org.eclipse.jet.doc/references/taglibs')
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/addElementTag.html6
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/addTextElementTag.html8
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/caseTag.html12
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/chooseTag.html35
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/copyElementTag.html6
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/dumpTag.html6
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/getTag.html6
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/ifTag.html6
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/includeTag.html18
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/initialCodeTag.html34
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/invokeTransformTag.html10
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/iterateTag.html7
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/loadContentTag.html12
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/loadTag.html14
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/logTag.html18
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/markerTag.html16
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/nodeAttributesTag.html1
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/otherwiseTag.html18
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/overrideTag.html8
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/overview.html197
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/removeElementTag.html6
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/replaceStringsTag.html8
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/setTag.html8
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/setVariableTag.html6
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/stringTokensTag.html12
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/userRegionTag.html32
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/visitTag.html16
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/visitorTag.html11
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/whenTag.html12
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/formatTags/formatNowTag.html6
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/formatTags/lcTag.html15
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/formatTags/millisecondsTag.html11
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/formatTags/overview.html44
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/formatTags/replaceAllTag.html13
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/formatTags/stripTag.html13
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/formatTags/ucTag.html15
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/formatTags/uniqueTag.html14
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/formatTags/uuidTag.html13
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/javaTags/classTag.html32
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/javaTags/impliedImportTag.html9
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/javaTags/importTag.html18
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/javaTags/importsLocationTag.html8
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/javaTags/mergeTag.html21
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/javaTags/overview.html36
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/javaTags/packageTag.html16
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/javaTags/resourceTag.html27
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/copyFileTag.html13
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/fileTag.html12
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/folderTag.html10
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/overview.html30
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/projectTag.html26
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/rebuildWorkspaceTag.html12
52 files changed, 465 insertions, 498 deletions
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/addElementTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/addElementTag.html
index 2477367..3191f99 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/addElementTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/addElementTag.html
@@ -38,7 +38,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -54,7 +53,6 @@
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -76,8 +74,8 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin addElement example -->
-
- &lt;c:addElement select=&quot;<I>value</I>&quot; name=&quot;<I>value</I>&quot;/&gt;<br>
+ &lt;%-- Insert an element 'foo' under $myElement. $new refers to 'foo' --%&gt;<br>
+ &lt;c:addElement select=&quot;$myElement&quot; name=&quot;foo&quot; var=&quot;new&quot;/&gt;<br>
<!-- End addElement example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/addTextElementTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/addTextElementTag.html
index c167c9f..b1e9687 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/addTextElementTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/addTextElementTag.html
@@ -42,7 +42,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -58,7 +57,6 @@
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -84,9 +82,9 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin addTextElement example -->
-
- &lt;c:addTextElement select=&quot;<I>value</I>&quot; name=&quot;<I>value</I>&quot;&gt;<br>
- &nbsp;&nbsp;&nbsp;&nbsp;<I>content consumed by tag evaluation</I><BR>
+ &lt;%-- insert a text element 'foo' under $root. $newText refers to it --%&gt;<br>
+ &lt;c:addTextElement select=&quot;$root&quot; name=&quot;foo&quot; var=&quot;newText&quot;&gt;<br>
+ &nbsp;&nbsp;&nbsp;&nbsp;This is the content of foo<BR>
&lt;/c:addTextElement&gt;
<!-- End addTextElement example -->
</SPAN></TD>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/caseTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/caseTag.html
index c0dcf55..ea67391 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/caseTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/caseTag.html
@@ -44,7 +44,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -56,7 +55,6 @@
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -66,11 +64,13 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin case example -->
-
- &lt;c:case test=&quot;<I>value</I>&quot;&gt;<br>
- &nbsp;&nbsp;&nbsp;&nbsp;<I>content to process if tag condition is
+ &lt;c:choose&gt;<br>
+ &lt;c:case test=&quot;$myVar/@kind = 'FIELD'&quot;&gt;<br>
+ &nbsp;&nbsp;&nbsp;&nbsp;<I>content to process if test condition is
satisfied</I><BR>
- &lt;/c:case&gt;
+ &lt;/c:case&gt;<BR>
+ <I>... other &lt;c:when&gt; and &lt;c:otherwise&gt; tags ...</I><BR>
+ &lt;/c:choose&gt;
<!-- End case example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/chooseTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/chooseTag.html
index bec3372..3bb0466 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/chooseTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/chooseTag.html
@@ -42,15 +42,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
-<HR>
-<TABLE border="1" width="100%">
- <TBODY>
- <TR>
- <TH colspan="2" align="left">Required Attributes</TH></TR>
- </TBODY>
-</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -72,10 +63,32 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin choose example -->
-
+ &lt;%-- evaluate one of a number alternatives --%&gt;<BR>
&lt;c:choose&gt;<br>
- &nbsp;&nbsp;&nbsp;&nbsp;<I>content to be written</I><BR>
+ &lt;c:when test="$var/@value = 1"&gt;<BR>
+ &nbsp;&nbsp;&nbsp;&nbsp;<I>handle case 1</I><BR>
+ &lt;/c:when&gt;<BR>
+ &lt;c:when test="$var/@value >= 2"&gt;<BR>
+ &nbsp;&nbsp;&nbsp;&nbsp;<I>handle case 2</I><BR>
+ &lt;/c:when&gt;<BR>
+ &lt;c:otherwise&gt;<BR>
+ &nbsp;&nbsp;&nbsp;&nbsp;<I>handle other cases</I><BR>
+ &lt;/c:otherwise&gt;<BR>
+ &lt;/c:choose&gt;<BR><BR>
+
+ &lt;%-- evaluate an expression against constances --%&gt;<BR>
+ &lt;c:choose select="$var/@num"&gt;<br>
+ &lt;c:when test=" 'one' "&gt;<BR>
+ &nbsp;&nbsp;&nbsp;&nbsp;<I>handle case 'one' </I><BR>
+ &lt;/c:when&gt;<BR>
+ &lt;c:when test=" 'two' "&gt;<BR>
+ &nbsp;&nbsp;&nbsp;&nbsp;<I>handle case 'two' </I><BR>
+ &lt;/c:when&gt;<BR>
+ &lt;c:otherwise&gt;<BR>
+ &nbsp;&nbsp;&nbsp;&nbsp;<I>handle other cases</I><BR>
+ &lt;/c:otherwise&gt;<BR>
&lt;/c:choose&gt;
+
<!-- End choose example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/copyElementTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/copyElementTag.html
index e1185f3..af4158a 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/copyElementTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/copyElementTag.html
@@ -38,7 +38,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -58,7 +57,6 @@
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -84,8 +82,8 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin copyElement example -->
-
- &lt;c:copyElement select=&quot;<I>value</I>&quot; toSelect=&quot;<I>value</I>&quot; name=&quot;<I>value</I>&quot;/&gt;<br>
+ &lt;%-- copy element $orig to a new element 'copy' under $dest --%&gt;<BR>
+ &lt;c:copyElement select=&quot;$orig&quot; toSelect=&quot;$dest&quot; name=&quot;copy&quot;/&gt;<br>
<!-- End copyElement example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/dumpTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/dumpTag.html
index 58a1ecb..a14eb00 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/dumpTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/dumpTag.html
@@ -38,7 +38,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -50,7 +49,6 @@
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -76,8 +74,8 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin dump example -->
-
- &lt;c:dump select=&quot;<I>value</I>&quot;/&gt;<br>
+ &lt;%-- dump the input model as an XML document --%&gt;<BR>
+ &lt;c:dump select=&quot;/*&quot;/&gt;<br>
<!-- End dump example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/getTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/getTag.html
index 72c1911..62a6c00 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/getTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/getTag.html
@@ -38,7 +38,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -50,7 +49,6 @@
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -72,8 +70,8 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin get example -->
-
- &lt;c:get select=&quot;<I>value</I>&quot;/&gt;<br>
+ &lt;%-- Return the string value of 'name' attribute of element refered to by $var --%&gt;<BR>
+ &lt;c:get select=&quot;$var/@name&quot;/&gt;<br>
<!-- End get example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/ifTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/ifTag.html
index 37650bd..a8bdf2a 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/ifTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/ifTag.html
@@ -44,7 +44,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -56,7 +55,6 @@
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -78,8 +76,8 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin if example -->
-
- &lt;c:if test=&quot;<I>value</I>&quot;&gt;<br>
+ &lt;%-- process contents if 'name' attribute is equal to JET --%&gt;<BR>
+ &lt;c:if test=&quot;$var/@name = 'JET'&quot;&gt;<br>
&nbsp;&nbsp;&nbsp;&nbsp;<I>content to process if tag condition is
satisfied</I><BR>
&lt;/c:if&gt;
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/includeTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/includeTag.html
index 6231439..620c0f6 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/includeTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/includeTag.html
@@ -33,12 +33,11 @@
<TR>
<TD width="10%">full tag</TD>
<TD><SPAN style="font-family: monospace">
- &lt;c:include template=&quot;<I>value</I>&quot; restoreNames=&quot;<I>value</I>&quot; passVariables=&quot;<I>value</I>&quot;/&gt;<br>
+ &lt;c:include template=&quot;<I>value</I>&quot; restoreNames=&quot;<I>value</I>&quot; passVariables=&quot;<I>value</I>&quot; super=&quot;<I>value</I>&quot;/&gt;<br>
</SPAN></TD>
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -50,7 +49,6 @@
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -65,6 +63,10 @@
<TD width="10%">passVariables</TD>
<TD><BR> A comma separated list of variable names (without the $ sign). Mutually exclusive with 'restoreNames'.<BR> </TD>
</TR>
+ <TR>
+ <TD width="10%">super</TD>
+ <TD><BR> If set to 'true', the template loader attempts to load directly from the overriden transformation (as specified by the 'override' tag or by the 'overrides' attribute of the 'transform' element of the 'org.eclipse.jet.transform' extension in the transforms plugin.xml). If no 'super' template can be found, an error occurs. The default is 'false', indicating normal template loading.<BR> </TD>
+ </TR>
</TBODY>
</TABLE>
<HR>
@@ -76,8 +78,14 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin include example -->
-
- &lt;c:include template=&quot;<I>value</I>&quot;/&gt;<br>
+ &lt;c:include template=&quot;templates/myInclude.jet&quot;/&gt;<br><BR>
+
+ &lt;%-- include myInclude.jet from overriden transformation--%&gt;<BR>
+ &lt;c:include template=&quot;templates/myInclude.jet&quot; super=&quot;true&quot;/&gt;<br><BR>
+
+ &lt;%-- pass only the variables $foo and $bar to myInclude.jet--%&gt;<BR>
+ &lt;c:include template=&quot;templates/myInclude.jet&quot; passVariables=&quot;foo,bar&quot;/&gt;<br>
+
<!-- End include example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/initialCodeTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/initialCodeTag.html
index 85fefc2..191b627 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/initialCodeTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/initialCodeTag.html
@@ -35,22 +35,25 @@
<TR>
<TD width="10%">full tag</TD>
<TD><SPAN style="font-family: monospace">
- &lt;c:initialCode&gt;<br>
+ &lt;c:initialCode unmodifiedMarker=&quot;<I>value</I>&quot;&gt;<br>
&nbsp;&nbsp;&nbsp;&nbsp;<I>content to be written</I><BR>
&lt;/c:initialCode&gt;
</SPAN></TD>
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
<TR>
- <TH colspan="2" align="left">Required Attributes</TH></TR>
+ <TH colspan="2" align="left">Optional Attributes</TH></TR>
+ <TR>
+ <TR>
+ <TD width="10%">unmodifiedMarker</TD>
+ <TD><BR> A string that when present in the content of the existing code indicates that the code has not been modified by the user, and should be replace with the contents of this initial code block.<BR> </TD>
+ </TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -60,10 +63,25 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin initialCode example -->
-
- &lt;c:initialCode&gt;<br>
- &nbsp;&nbsp;&nbsp;&nbsp;<I>content to be written</I><BR>
- &lt;/c:initialCode&gt;
+ &lt;%-- Define user region 101. Code in block will never be updated by subsequent executions --%&gt;<BR>
+ &lt;c:userRegion&gt;<BR>
+ // BEGIN region 101<BR>
+ &nbsp;&nbsp;&lt;c:initialCode&gt;<br>
+ &nbsp;&nbsp;&nbsp;&nbsp;<I>default code</I><BR>
+ &nbsp;&nbsp;&lt;/c:initialCode&gt;<BR>
+ // END region 101<BR>
+ &lt;/c:userRegion&gt;<BR><BR>
+
+ &lt;%-- Define user region 102. Code in block will be updated by subsequent
+ executions only if @generated is found in block --%&gt;<BR>
+ &lt;c:userRegion&gt;<BR>
+ // BEGIN region 102<BR>
+ &nbsp;&nbsp;&lt;c:initialCode unmodifiedMarker="@generated"&gt;<br>
+ &nbsp;&nbsp;&nbsp;&nbsp;// @generated<BR>
+ &nbsp;&nbsp;&nbsp;&nbsp;<I>default code</I><BR>
+ &nbsp;&nbsp;&lt;/c:initialCode&gt;<BR>
+ // END region 102<BR>
+ &lt;/c:userRegion&gt;<BR>
<!-- End initialCode example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/invokeTransformTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/invokeTransformTag.html
index 02a5291..0947f3c 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/invokeTransformTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/invokeTransformTag.html
@@ -38,7 +38,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -50,7 +49,6 @@
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -76,8 +74,12 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin invokeTransform example -->
-
- &lt;c:invokeTransform transformId=&quot;<I>value</I>&quot;/&gt;<br>
+ &lt;%-- invoke transform 'foo.bar' against the current input model --%&gt;<BR>
+ &lt;c:invokeTransform transformId=&quot;foo.bar&quot;/&gt;<br><BR>
+
+ &lt;%-- invoke transform 'foo.bar' against the current input model,
+ and pass only the variables $a, $b and $c --%&gt;<BR>
+ &lt;c:invokeTransform transformId=&quot;foo.bar&quot; passVariables="a,b,c"/&gt;<br>
<!-- End invokeTransform example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/iterateTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/iterateTag.html
index 4949b6d..b1e1f68 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/iterateTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/iterateTag.html
@@ -42,7 +42,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -58,7 +57,6 @@
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -80,9 +78,10 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin iterate example -->
-
- &lt;c:iterate select=&quot;<I>value</I>&quot; var=&quot;<I>value</I>&quot;&gt;<br>
+ &lt;%-- Iterate over child 'a' elements of $root. $curA refers to each instance --%&gt;<BR>
+ &lt;c:iterate select=&quot;$root/a&quot; var=&quot;curA&quot;&gt;<br>
&nbsp;&nbsp;&nbsp;&nbsp;<I>content to be repeated for each iteration</I><BR>
+ &nbsp;&nbsp;&nbsp;&nbsp;Value of name: &lt;c:get select="$curA/@name"/&gt;<BR>
&lt;/c:iterate&gt;
<!-- End iterate example -->
</SPAN></TD>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/loadContentTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/loadContentTag.html
index e161a7e..5808092 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/loadContentTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/loadContentTag.html
@@ -42,7 +42,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -54,7 +53,6 @@
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -80,9 +78,13 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin loadContent example -->
-
- &lt;c:loadContent var=&quot;<I>value</I>&quot;&gt;<br>
- &nbsp;&nbsp;&nbsp;&nbsp;<I>content consumed by tag evaluation</I><BR>
+ &lt;%-- Load an in memory XML document. $myXML is the document root,
+ $myXML/root is the root element --%&gt;<BR>
+ &lt;c:loadContent var=&quot;myXML&quot;&gt;<br>
+ &nbsp;&nbsp;&nbsp;&nbsp;&lt;root&gt;<BR>
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;a name="one"/&gt;<BR>
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;a name="two"/&gt;<BR>
+ &nbsp;&nbsp;&nbsp;&nbsp;&lt;/root&gt;<BR>
&lt;/c:loadContent&gt;
<!-- End loadContent example -->
</SPAN></TD>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/loadTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/loadTag.html
index 69086ea..8235e4f 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/loadTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/loadTag.html
@@ -38,7 +38,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -54,7 +53,6 @@
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -84,8 +82,18 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin load example -->
+ &lt;%-- Load plugin.xml from transformation as an XML model, $pluginDoc refers to the
+ loaded document. $pluginDoc/* (or $pluginDoc/plugin) refers to the root element --%&gt;<BR>
+ &lt;c:load url=&quot;plugin.xml&quot; var=&quot;pluginDoc&quot;/&gt;<br><BR>
+
+ &lt;%-- same action as above, but with defaults specified --%&gt;<BR>
+ &lt;c:load url=&quot;plugin.xml&quot; var=&quot;pluginDoc&quot; urlContext=&quot;transform&quot;
+ loader=&quot;org.eclipse.jet.emfxml&quot; /&gt;<br><BR>
+
+ &lt;%-- Load sample.appdef from project myProject as an XML document --%&gt;<BR>
+ &lt;c:load url=&quot;myProject/sample.appdef&quot; var=&quot;sampleDoc&quot; urlContext=&quot;workspace&quot;
+ loader=&quot;org.eclipse.jet.emfxml&quot; type="xml" /&gt;<br>
- &lt;c:load url=&quot;<I>value</I>&quot; var=&quot;<I>value</I>&quot;/&gt;<br>
<!-- End load example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/logTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/logTag.html
index beadac7..5c407a3 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/logTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/logTag.html
@@ -42,15 +42,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
-<HR>
-<TABLE border="1" width="100%">
- <TBODY>
- <TR>
- <TH colspan="2" align="left">Required Attributes</TH></TR>
- </TBODY>
-</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -72,9 +63,14 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin log example -->
-
+ &lt;%-- Write a message to the JET execution console --%&gt;<BR>
&lt;c:log&gt;<br>
- &nbsp;&nbsp;&nbsp;&nbsp;<I>content consumed by tag evaluation</I><BR>
+ &nbsp;&nbsp;&nbsp;&nbsp;Hello from my template<BR>
+ &lt;/c:log&gt;<BR><BR>
+
+ &lt;%-- Write an ERROR message to the JET execution console --%&gt;<BR>
+ &lt;c:log severity="error"&gt;<br>
+ &nbsp;&nbsp;&nbsp;&nbsp;Error from my template<BR>
&lt;/c:log&gt;
<!-- End log example -->
</SPAN></TD>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/markerTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/markerTag.html
index abc00b6..56b3fd4 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/markerTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/markerTag.html
@@ -42,15 +42,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
-<HR>
-<TABLE border="1" width="100%">
- <TBODY>
- <TR>
- <TH colspan="2" align="left">Required Attributes</TH></TR>
- </TBODY>
-</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -72,10 +63,11 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin marker example -->
+ &lt;%-- Create a task marker on the generated text 'This text is marked!'--%&gt;<BR>
+ &lt;c:marker&gt;This text is marked!&lt;/c:marker&gt;<BR><BR>
- &lt;c:marker&gt;<br>
- &nbsp;&nbsp;&nbsp;&nbsp;<I>content to be written</I><BR>
- &lt;/c:marker&gt;
+ &lt;%-- Create a task marker on the generated text 'This text is marked with a description!'--%&gt;<BR>
+ &lt;c:marker description=&quot;Do something about this&quot;&gt;This text is marked with a description!&lt;/c:marker&gt;<BR><BR>
<!-- End marker example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/nodeAttributesTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/nodeAttributesTag.html
index 02825b5..e971e63 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/nodeAttributesTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/nodeAttributesTag.html
@@ -80,7 +80,6 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin nodeAttributes example -->
-
&lt;c:nodeAttributes node=&quot;<I>value</I>&quot; name=&quot;<I>value</I>&quot;&gt;<br>
&nbsp;&nbsp;&nbsp;&nbsp;<I>content to be repeated for each iteration</I><BR>
&lt;/c:nodeAttributes&gt;
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/otherwiseTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/otherwiseTag.html
index c66d307..2a02cf3 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/otherwiseTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/otherwiseTag.html
@@ -44,15 +44,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
-<HR>
-<TABLE border="1" width="100%">
- <TBODY>
- <TR>
- <TH colspan="2" align="left">Required Attributes</TH></TR>
- </TBODY>
-</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -62,11 +53,12 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin otherwise example -->
-
+ &lt;c:choose&gt;<br>
+ <I>... a sequence of &lt;c:when&gt; tags ...</I><BR>
&lt;c:otherwise&gt;<br>
- &nbsp;&nbsp;&nbsp;&nbsp;<I>content to process if tag condition is
- satisfied</I><BR>
- &lt;/c:otherwise&gt;
+ &nbsp;&nbsp;&nbsp;&nbsp;<I>content to process if no when tags were statisfied</I><BR>
+ &lt;/c:otherwise&gt;<BR>
+ &lt;/c:choose&gt;
<!-- End otherwise example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/overrideTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/overrideTag.html
index 44501c3..916acba 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/overrideTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/overrideTag.html
@@ -38,7 +38,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -50,7 +49,6 @@
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -60,8 +58,10 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin override example -->
-
- &lt;c:override transformId=&quot;<I>value</I>&quot;/&gt;<br>
+ &lt;%-- Declare that this transformation over rides 'foo.bar'--%&gt;<BR>
+ &lt;%-- When resolving templates, JET will first look in this transformation,
+ and then in foo.bar. --%&gt;<BR>
+ &lt;c:override transformId=&quot;foo.bar&quot;/&gt;<br>
<!-- End override example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/overview.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/overview.html
index 813469c..2b15aa8 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/overview.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/overview.html
@@ -25,24 +25,24 @@
<TR>
<TH colspan="2" align="left">Tag Summary</TH></TR>
<TR>
- <TD width="10%"><A href="iterateTag.html">&lt;c:iterate&gt;</A></TD>
- <TD><!-- Begin iterate description -->
- <P> Write the tag contents for each in the template input model identified by an XPath expression
- <!-- End iterate description -->
+ <TD width="10%"><A href="addElementTag.html">&lt;c:addElement&gt;</A></TD>
+ <TD><!-- Begin addElement description -->
+ <P> Create a new model element under the selected node
+ <!-- End addElement description -->
</TD>
</TR>
<TR>
- <TD width="10%"><A href="ifTag.html">&lt;c:if&gt;</A></TD>
- <TD><!-- Begin if description -->
- <P> Process the tag contents if a test condition is satisfied
- <!-- End if description -->
+ <TD width="10%"><A href="addTextElementTag.html">&lt;c:addTextElement&gt;</A></TD>
+ <TD><!-- Begin addTextElement description -->
+ <P> Create a new model element node under the selected element, and whose text content is the content of this tag
+ <!-- End addTextElement description -->
</TD>
</TR>
<TR>
- <TD width="10%"><A href="getTag.html">&lt;c:get&gt;</A></TD>
- <TD><!-- Begin get description -->
- <P> Write a the result of an XPath expression
- <!-- End get description -->
+ <TD width="10%"><A href="caseTag.html">&lt;c:case&gt;</A></TD>
+ <TD><!-- Begin case description -->
+ <P> *** DEPRECATED - use 'when' tag instead
+ <!-- End case description -->
</TD>
</TR>
<TR>
@@ -53,38 +53,31 @@
</TD>
</TR>
<TR>
- <TD width="10%"><A href="caseTag.html">&lt;c:case&gt;</A></TD>
- <TD><!-- Begin case description -->
- <P> *** DEPRECATED - use 'when' tag instead
- <!-- End case description -->
- </TD>
- </TR>
- <TR>
- <TD width="10%"><A href="otherwiseTag.html">&lt;c:otherwise&gt;</A></TD>
- <TD><!-- Begin otherwise description -->
- <P> Define a default case for a 'choose' tag
- <!-- End otherwise description -->
+ <TD width="10%"><A href="copyElementTag.html">&lt;c:copyElement&gt;</A></TD>
+ <TD><!-- Begin copyElement description -->
+ <P> Copy the selected node to the selected location
+ <!-- End copyElement description -->
</TD>
</TR>
<TR>
- <TD width="10%"><A href="visitorTag.html">&lt;c:visitor&gt;</A></TD>
- <TD><!-- Begin visitor description -->
- <P> *** PROTOTYPE *** Iterate over an object and all its contained objects, typically be doing a depth-first traversal
- <!-- End visitor description -->
+ <TD width="10%"><A href="dumpTag.html">&lt;c:dump&gt;</A></TD>
+ <TD><!-- Begin dump description -->
+ Writes out the DOM subtree under a specified model node
+ <!-- End dump description -->
</TD>
</TR>
<TR>
- <TD width="10%"><A href="visitTag.html">&lt;c:visit&gt;</A></TD>
- <TD><!-- Begin visit description -->
- <P> Define content to process for an object found by the parent 'visitor' tag, provided a condition is met
- <!-- End visit description -->
+ <TD width="10%"><A href="getTag.html">&lt;c:get&gt;</A></TD>
+ <TD><!-- Begin get description -->
+ <P> Write a the result of an XPath expression
+ <!-- End get description -->
</TD>
</TR>
<TR>
- <TD width="10%"><A href="userRegionTag.html">&lt;c:userRegion&gt;</A></TD>
- <TD><!-- Begin userRegion description -->
- <P> Define a region in the generated text where users may write customized code
- <!-- End userRegion description -->
+ <TD width="10%"><A href="ifTag.html">&lt;c:if&gt;</A></TD>
+ <TD><!-- Begin if description -->
+ <P> Process the tag contents if a test condition is satisfied
+ <!-- End if description -->
</TD>
</TR>
<TR>
@@ -95,13 +88,6 @@
</TD>
</TR>
<TR>
- <TD width="10%"><A href="logTag.html">&lt;c:log&gt;</A></TD>
- <TD><!-- Begin log description -->
- <P> Write a message to the transformation log
- <!-- End log description -->
- </TD>
- </TR>
- <TR>
<TD width="10%"><A href="initialCodeTag.html">&lt;c:initialCode&gt;</A></TD>
<TD><!-- Begin initialCode description -->
<P> A child tag of the 'userRegion' tag containing the initial code to write
@@ -109,38 +95,17 @@
</TD>
</TR>
<TR>
- <TD width="10%"><A href="setVariableTag.html">&lt;c:setVariable&gt;</A></TD>
- <TD><!-- Begin setVariable description -->
- <P> Create a variable whose value is set to the result of the provided XPath expression
- <!-- End setVariable description -->
- </TD>
- </TR>
- <TR>
- <TD width="10%"><A href="addElementTag.html">&lt;c:addElement&gt;</A></TD>
- <TD><!-- Begin addElement description -->
- <P> Create a new model element under the selected node
- <!-- End addElement description -->
- </TD>
- </TR>
- <TR>
- <TD width="10%"><A href="addTextElementTag.html">&lt;c:addTextElement&gt;</A></TD>
- <TD><!-- Begin addTextElement description -->
- <P> Create a new model element node under the selected element, and whose text content is the content of this tag
- <!-- End addTextElement description -->
- </TD>
- </TR>
- <TR>
- <TD width="10%"><A href="removeElementTag.html">&lt;c:removeElement&gt;</A></TD>
- <TD><!-- Begin removeElement description -->
- <P> Remove the selected node from the document tree
- <!-- End removeElement description -->
+ <TD width="10%"><A href="invokeTransformTag.html">&lt;c:invokeTransform&gt;</A></TD>
+ <TD><!-- Begin invokeTransform description -->
+ <P> Invoke the another transformation, passing it the current transformation's source model and context variables
+ <!-- End invokeTransform description -->
</TD>
</TR>
<TR>
- <TD width="10%"><A href="copyElementTag.html">&lt;c:copyElement&gt;</A></TD>
- <TD><!-- Begin copyElement description -->
- <P> Copy the selected node to the selected location
- <!-- End copyElement description -->
+ <TD width="10%"><A href="iterateTag.html">&lt;c:iterate&gt;</A></TD>
+ <TD><!-- Begin iterate description -->
+ <P> Write the tag contents for each in the template input model identified by an XPath expression
+ <!-- End iterate description -->
</TD>
</TR>
<TR>
@@ -151,17 +116,17 @@
</TD>
</TR>
<TR>
- <TD width="10%"><A href="whenTag.html">&lt;c:when&gt;</A></TD>
- <TD><!-- Begin when description -->
- <P> Define a one of the mutually exclusive cases of a 'choose' tag
- <!-- End when description -->
+ <TD width="10%"><A href="loadContentTag.html">&lt;c:loadContent&gt;</A></TD>
+ <TD><!-- Begin loadContent description -->
+ Extends the model by parsing its contents as XML
+ <!-- End loadContent description -->
</TD>
</TR>
<TR>
- <TD width="10%"><A href="setTag.html">&lt;c:set&gt;</A></TD>
- <TD><!-- Begin set description -->
- <P> Set an attribute on an object selected by an XPath expression
- <!-- End set description -->
+ <TD width="10%"><A href="logTag.html">&lt;c:log&gt;</A></TD>
+ <TD><!-- Begin log description -->
+ <P> Write a message to the transformation log
+ <!-- End log description -->
</TD>
</TR>
<TR>
@@ -172,6 +137,13 @@
</TD>
</TR>
<TR>
+ <TD width="10%"><A href="otherwiseTag.html">&lt;c:otherwise&gt;</A></TD>
+ <TD><!-- Begin otherwise description -->
+ <P> Define a default case for a 'choose' tag
+ <!-- End otherwise description -->
+ </TD>
+ </TR>
+ <TR>
<TD width="10%"><A href="overrideTag.html">&lt;c:override&gt;</A></TD>
<TD><!-- Begin override description -->
<P> *** Deprecated: Use the 'overrides' attribute on 'transform' extension in plugin
@@ -179,38 +151,31 @@
</TD>
</TR>
<TR>
- <TD width="10%"><A href="invokeTransformTag.html">&lt;c:invokeTransform&gt;</A></TD>
- <TD><!-- Begin invokeTransform description -->
- <P> Invoke the another transformation, passing it the current transformation's source model and context variables
- <!-- End invokeTransform description -->
- </TD>
- </TR>
- <TR>
- <TD width="10%"><A href="dumpTag.html">&lt;c:dump&gt;</A></TD>
- <TD><!-- Begin dump description -->
- Writes out the DOM subtree under a specified model node
- <!-- End dump description -->
+ <TD width="10%"><A href="removeElementTag.html">&lt;c:removeElement&gt;</A></TD>
+ <TD><!-- Begin removeElement description -->
+ <P> Remove the selected node from the document tree
+ <!-- End removeElement description -->
</TD>
</TR>
<TR>
- <TD width="10%"><A href="loadContentTag.html">&lt;c:loadContent&gt;</A></TD>
- <TD><!-- Begin loadContent description -->
- Extends the model by parsing its contents as XML
- <!-- End loadContent description -->
+ <TD width="10%"><A href="replaceStringsTag.html">&lt;c:replaceStrings&gt;</A></TD>
+ <TD><!-- Begin replaceStrings description -->
+ Replaces one set of strings in its content with another set of strings and writes out the result
+ <!-- End replaceStrings description -->
</TD>
</TR>
<TR>
- <TD width="10%"><A href="nodeAttributesTag.html">&lt;c:nodeAttributes&gt;</A></TD>
- <TD><!-- Begin nodeAttributes description -->
- Iterates over the attributes for a given node
- <!-- End nodeAttributes description -->
+ <TD width="10%"><A href="setTag.html">&lt;c:set&gt;</A></TD>
+ <TD><!-- Begin set description -->
+ <P> Set an attribute on an object selected by an XPath expression
+ <!-- End set description -->
</TD>
</TR>
<TR>
- <TD width="10%"><A href="replaceStringsTag.html">&lt;c:replaceStrings&gt;</A></TD>
- <TD><!-- Begin replaceStrings description -->
- Replaces one set of strings in its content with another set of strings and writes out the result
- <!-- End replaceStrings description -->
+ <TD width="10%"><A href="setVariableTag.html">&lt;c:setVariable&gt;</A></TD>
+ <TD><!-- Begin setVariable description -->
+ <P> Create a variable whose value is set to the result of the provided XPath expression
+ <!-- End setVariable description -->
</TD>
</TR>
<TR>
@@ -220,6 +185,34 @@
<!-- End stringTokens description -->
</TD>
</TR>
+ <TR>
+ <TD width="10%"><A href="userRegionTag.html">&lt;c:userRegion&gt;</A></TD>
+ <TD><!-- Begin userRegion description -->
+ <P> Define a region in the generated text where users may write customized code
+ <!-- End userRegion description -->
+ </TD>
+ </TR>
+ <TR>
+ <TD width="10%"><A href="visitTag.html">&lt;c:visit&gt;</A></TD>
+ <TD><!-- Begin visit description -->
+ <P> Define content to process for an object found by the parent 'visitor' tag, provided a condition is met
+ <!-- End visit description -->
+ </TD>
+ </TR>
+ <TR>
+ <TD width="10%"><A href="visitorTag.html">&lt;c:visitor&gt;</A></TD>
+ <TD><!-- Begin visitor description -->
+ <P> *** PROTOTYPE *** Iterate over an object and all its contained objects, typically be doing a depth-first traversal
+ <!-- End visitor description -->
+ </TD>
+ </TR>
+ <TR>
+ <TD width="10%"><A href="whenTag.html">&lt;c:when&gt;</A></TD>
+ <TD><!-- Begin when description -->
+ <P> Define a one of the mutually exclusive cases of a 'choose' tag
+ <!-- End when description -->
+ </TD>
+ </TR>
</TBODY>
</TABLE>
<HR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/removeElementTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/removeElementTag.html
index e7291aa..735af0d 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/removeElementTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/removeElementTag.html
@@ -38,7 +38,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -50,7 +49,6 @@
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -60,8 +58,8 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin removeElement example -->
-
- &lt;c:removeElement select=&quot;<I>value</I>&quot;/&gt;<br>
+ &lt;%-- Remove element a as a child of $root--%&gt;<BR>
+ &lt;c:removeElement select=&quot;$root/a&quot;/&gt;<br>
<!-- End removeElement example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/replaceStringsTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/replaceStringsTag.html
index a94a762..ab93aac 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/replaceStringsTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/replaceStringsTag.html
@@ -42,7 +42,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -58,7 +57,6 @@
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -68,9 +66,9 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin replaceStrings example -->
-
- &lt;c:replaceStrings replace=&quot;<I>value</I>&quot; with=&quot;<I>value</I>&quot;&gt;<br>
- &nbsp;&nbsp;&nbsp;&nbsp;<I>content consumed by tag evaluation</I><BR>
+ &lt;%-- Replace %name with 'Jim' and %age with '47' --%&gt;<BR>
+ &lt;c:replaceStrings replace=&quot;%name,%age&quot; with=&quot;Jim,47&quot;&gt;<br>
+ &nbsp;&nbsp;&nbsp;&nbsp;My name is %name. My age is %age.<BR>
&lt;/c:replaceStrings&gt;
<!-- End replaceStrings example -->
</SPAN></TD>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/setTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/setTag.html
index 83edfe2..75cc55a 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/setTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/setTag.html
@@ -42,7 +42,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -58,7 +57,6 @@
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -68,9 +66,9 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin set example -->
-
- &lt;c:set select=&quot;<I>value</I>&quot; name=&quot;<I>value</I>&quot;&gt;<br>
- &nbsp;&nbsp;&nbsp;&nbsp;<I>content to be written</I><BR>
+ &lt;%-- create or update an attribute name-length on element $var --%&gt;
+ &lt;c:set select=&quot;$var&quot; name=&quot;name-length&quot;&gt;<br>
+ &lt;c:get select="string-length(local-name($var))"/&gt;<BR>
&lt;/c:set&gt;
<!-- End set example -->
</SPAN></TD>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/setVariableTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/setVariableTag.html
index 86d2692..e49a5be 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/setVariableTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/setVariableTag.html
@@ -38,7 +38,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -54,7 +53,6 @@
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -64,8 +62,8 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin setVariable example -->
-
- &lt;c:setVariable select=&quot;<I>value</I>&quot; var=&quot;<I>value</I>&quot;/&gt;<br>
+ &lt;%-- define $root as pointing to the root element in the mode --%&gt;<BR>
+ &lt;c:setVariable select=&quot;/*&quot; var=&quot;root&quot;/&gt;<br>
<!-- End setVariable example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/stringTokensTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/stringTokensTag.html
index 69d97f8..a71e977 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/stringTokensTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/stringTokensTag.html
@@ -42,7 +42,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -58,7 +57,6 @@
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -92,9 +90,13 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin stringTokens example -->
-
- &lt;c:stringTokens string=&quot;<I>value</I>&quot; name=&quot;<I>value</I>&quot;&gt;<br>
- &nbsp;&nbsp;&nbsp;&nbsp;<I>content to be repeated for each iteration</I><BR>
+ &lt;%-- break a,bc,cde into tokens, and iterate over them --%&gt;<BR>
+ &lt;c:stringTokens string=&quot;a,bc,cde&quot; name=&quot;curStr&quot; delimitedBy=&quot;,&quot;&gt;<br>
+ &nbsp;&nbsp;&nbsp;&nbsp;value: &lt;c:get select="$curStr/@value"/&gt;<BR>
+ &nbsp;&nbsp;&nbsp;&nbsp;index: &lt;c:get select="$curStr/@index"/&gt;<BR>
+ &nbsp;&nbsp;&nbsp;&nbsp;delimiter: &lt;c:get select="$curStr/@delimiter"/&gt;<BR>
+ &nbsp;&nbsp;&nbsp;&nbsp;first: &lt;c:get select="$curStr/@first"/&gt;<BR>
+ &nbsp;&nbsp;&nbsp;&nbsp;last: &lt;c:get select="$curStr/@last"/&gt;<BR>
&lt;/c:stringTokens&gt;
<!-- End stringTokens example -->
</SPAN></TD>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/userRegionTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/userRegionTag.html
index 1d302a5..6fc52db 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/userRegionTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/userRegionTag.html
@@ -42,15 +42,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
-<HR>
-<TABLE border="1" width="100%">
- <TBODY>
- <TR>
- <TH colspan="2" align="left">Required Attributes</TH></TR>
- </TBODY>
-</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -60,10 +51,25 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin userRegion example -->
-
- &lt;c:userRegion&gt;<br>
- &nbsp;&nbsp;&nbsp;&nbsp;<I>content to be written</I><BR>
- &lt;/c:userRegion&gt;
+ &lt;%-- Define user region 101. Code in block will never be updated by subsequent executions --%&gt;<BR>
+ &lt;c:userRegion&gt;<BR>
+ // BEGIN region 101<BR>
+ &nbsp;&nbsp;&lt;c:initialCode&gt;<br>
+ &nbsp;&nbsp;&nbsp;&nbsp;<I>default code</I><BR>
+ &nbsp;&nbsp;&lt;/c:initialCode&gt;<BR>
+ // END region 101<BR>
+ &lt;/c:userRegion&gt;<BR><BR>
+
+ &lt;%-- Define user region 102. Code in block will be updated by subsequent
+ executions only if @generated is found in block --%&gt;<BR>
+ &lt;c:userRegion&gt;<BR>
+ // BEGIN region 102<BR>
+ &nbsp;&nbsp;&lt;c:initialCode unmodifiedMarker="@generated"&gt;<br>
+ &nbsp;&nbsp;&nbsp;&nbsp;// @generated<BR>
+ &nbsp;&nbsp;&nbsp;&nbsp;<I>default code</I><BR>
+ &nbsp;&nbsp;&lt;/c:initialCode&gt;<BR>
+ // END region 102<BR>
+ &lt;/c:userRegion&gt;<BR>
<!-- End userRegion example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/visitTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/visitTag.html
index 6563e0c..69f5bec 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/visitTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/visitTag.html
@@ -44,7 +44,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -52,11 +51,10 @@
<TH colspan="2" align="left">Required Attributes</TH></TR>
<TR>
<TD width="10%">test</TD>
- <TD>TODO Define description of test</TD>
+ <TD><BR> An expression expression, that, if true, causes the tag contents to be evaluated.<BR> </TD>
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -66,11 +64,13 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin visit example -->
-
- &lt;c:visit test=&quot;<I>value</I>&quot;&gt;<br>
- &nbsp;&nbsp;&nbsp;&nbsp;<I>content to process if tag condition is
- satisfied</I><BR>
- &lt;/c:visit&gt;
+ &lt;%-- traverse a model starting at $root. $cur refers to current node --%>
+ &lt;c:visitor select=&quot;$root&quot; var=&quot;cur&quot;&gt;<br>
+ &lt;c:visit test=&quot;local-name($cur) = 'a'&quot;&gt;<BR>
+ &nbsp;&nbsp;&nbsp;&nbsp;<I>content to process of test is true</I><BR>
+ &lt;/c:visit&gt;<BR>
+ &nbsp;&nbsp;&nbsp;&nbsp;<I>... other &lt;c:visit&gt; tags ...</I><BR>
+ &lt;/c:visitor&gt;
<!-- End visit example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/visitorTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/visitorTag.html
index 22ef3ef..09f90f4 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/visitorTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/visitorTag.html
@@ -42,7 +42,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -58,7 +57,6 @@
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -68,9 +66,12 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin visitor example -->
-
- &lt;c:visitor select=&quot;<I>value</I>&quot; var=&quot;<I>value</I>&quot;&gt;<br>
- &nbsp;&nbsp;&nbsp;&nbsp;<I>content to be repeated for each iteration</I><BR>
+ &lt;%-- traverse a model starting at $root. $cur refers to current node --%>
+ &lt;c:visitor select=&quot;$root&quot; var=&quot;cur&quot;&gt;<br>
+ &lt;c:visit test=&quot;local-name($cur) = 'a'&quot;&gt;<BR>
+ &nbsp;&nbsp;&nbsp;&nbsp;<I>content to process of test is true</I><BR>
+ &lt;/c:visit&gt;<BR>
+ &nbsp;&nbsp;&nbsp;&nbsp;<I>... other &lt;c:visit&gt; tags ...</I><BR>
&lt;/c:visitor&gt;
<!-- End visitor example -->
</SPAN></TD>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/whenTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/whenTag.html
index 0e55532..782e4ab 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/whenTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/whenTag.html
@@ -44,7 +44,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -56,7 +55,6 @@
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -66,11 +64,13 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin when example -->
-
- &lt;c:when test=&quot;<I>value</I>&quot;&gt;<br>
- &nbsp;&nbsp;&nbsp;&nbsp;<I>content to process if tag condition is
+ &lt;c:choose&gt;<br>
+ &lt;c:when test=&quot;$myVar/@kind = 'FIELD'&quot;&gt;<br>
+ &nbsp;&nbsp;&nbsp;&nbsp;<I>content to process if test condition is
satisfied</I><BR>
- &lt;/c:when&gt;
+ &lt;/c:when&gt;<BR>
+ <I>... other &lt;c:when&gt; and &lt;c:otherwise&gt; tags ...</I><BR>
+ &lt;/c:choose&gt;
<!-- End when example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/formatTags/formatNowTag.html b/doc/org.eclipse.jet.doc/references/taglibs/formatTags/formatNowTag.html
index abed0f9..74e190b 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/formatTags/formatNowTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/formatTags/formatNowTag.html
@@ -38,7 +38,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -50,7 +49,6 @@
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -60,8 +58,8 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin formatNow example -->
-
- &lt;f:formatNow pattern=&quot;<I>value</I>&quot;/&gt;<br>
+ &lt;f:formatNow pattern=&quot;<I>MM/dd/yyyy : EEE</I>&quot; /&gt;<br>
+ <P>This formatNow tag would write out a time formatted like "01/29/2006 : Sun"</P>
<!-- End formatNow example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/formatTags/lcTag.html b/doc/org.eclipse.jet.doc/references/taglibs/formatTags/lcTag.html
index 738c661..ae77067 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/formatTags/lcTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/formatTags/lcTag.html
@@ -42,15 +42,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
-<HR>
-<TABLE border="1" width="100%">
- <TBODY>
- <TR>
- <TH colspan="2" align="left">Required Attributes</TH></TR>
- </TBODY>
-</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -76,10 +67,8 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin lc example -->
-
- &lt;f:lc&gt;<br>
- &nbsp;&nbsp;&nbsp;&nbsp;<I>content consumed by tag evaluation</I><BR>
- &lt;/f:lc&gt;
+ &lt;%-- This will result in 'upper' --%&gt;<BR>
+ &lt;f:lc&gt;UPPER&lt;/f:lc&gt;
<!-- End lc example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/formatTags/millisecondsTag.html b/doc/org.eclipse.jet.doc/references/taglibs/formatTags/millisecondsTag.html
index 01fd962..eb1d828 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/formatTags/millisecondsTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/formatTags/millisecondsTag.html
@@ -38,15 +38,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
-<HR>
-<TABLE border="1" width="100%">
- <TBODY>
- <TR>
- <TH colspan="2" align="left">Required Attributes</TH></TR>
- </TBODY>
-</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -56,7 +47,7 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin milliseconds example -->
-
+ &lt;%-- this will produce something like 1138570287475 --%&gt;
&lt;f:milliseconds/&gt;<br>
<!-- End milliseconds example -->
</SPAN></TD>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/formatTags/overview.html b/doc/org.eclipse.jet.doc/references/taglibs/formatTags/overview.html
index e5b988e..986a5f3 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/formatTags/overview.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/formatTags/overview.html
@@ -25,6 +25,27 @@
<TR>
<TH colspan="2" align="left">Tag Summary</TH></TR>
<TR>
+ <TD width="10%"><A href="formatNowTag.html">&lt;f:formatNow&gt;</A></TD>
+ <TD><!-- Begin formatNow description -->
+ Formats and writes out the current date and time
+ <!-- End formatNow description -->
+ </TD>
+ </TR>
+ <TR>
+ <TD width="10%"><A href="lcTag.html">&lt;f:lc&gt;</A></TD>
+ <TD><!-- Begin lc description -->
+ <P> Convert the tag contents to lower case
+ <!-- End lc description -->
+ </TD>
+ </TR>
+ <TR>
+ <TD width="10%"><A href="millisecondsTag.html">&lt;f:milliseconds&gt;</A></TD>
+ <TD><!-- Begin milliseconds description -->
+ Writes out a current system milliseconds value
+ <!-- End milliseconds description -->
+ </TD>
+ </TR>
+ <TR>
<TD width="10%"><A href="replaceAllTag.html">&lt;f:replaceAll&gt;</A></TD>
<TD><!-- Begin replaceAll description -->
<P> Replace all instances of a value in the tag's content with a new value
@@ -46,27 +67,6 @@
</TD>
</TR>
<TR>
- <TD width="10%"><A href="lcTag.html">&lt;f:lc&gt;</A></TD>
- <TD><!-- Begin lc description -->
- <P> Convert the tag contents to lower case
- <!-- End lc description -->
- </TD>
- </TR>
- <TR>
- <TD width="10%"><A href="formatNowTag.html">&lt;f:formatNow&gt;</A></TD>
- <TD><!-- Begin formatNow description -->
- Formats and writes out the current date and time
- <!-- End formatNow description -->
- </TD>
- </TR>
- <TR>
- <TD width="10%"><A href="millisecondsTag.html">&lt;f:milliseconds&gt;</A></TD>
- <TD><!-- Begin milliseconds description -->
- Writes out a current system milliseconds value
- <!-- End milliseconds description -->
- </TD>
- </TR>
- <TR>
<TD width="10%"><A href="uniqueTag.html">&lt;f:unique&gt;</A></TD>
<TD><!-- Begin unique description -->
Writes out a unique integer value
@@ -76,7 +76,7 @@
<TR>
<TD width="10%"><A href="uuidTag.html">&lt;f:uuid&gt;</A></TD>
<TD><!-- Begin uuid description -->
- Default description for tag uuid
+ Generate a universally unique identifier (UUID)
<!-- End uuid description -->
</TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/formatTags/replaceAllTag.html b/doc/org.eclipse.jet.doc/references/taglibs/formatTags/replaceAllTag.html
index 442a318..2a2ff06 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/formatTags/replaceAllTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/formatTags/replaceAllTag.html
@@ -42,7 +42,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -58,7 +57,6 @@
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -80,10 +78,15 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin replaceAll example -->
+ &lt;%-- This will result in a/b/c--%&gt;<BR>
+ &lt;f:replaceAll value=&quot;.&quot; replacement=&quot;/&quot;&gt;<br>
+ &nbsp;&nbsp;&nbsp;&nbsp;a.b.c</I><BR>
+ &lt;/f:replaceAll&gt;<BR><BR>
- &lt;f:replaceAll value=&quot;<I>value</I>&quot; replacement=&quot;<I>value</I>&quot;&gt;<br>
- &nbsp;&nbsp;&nbsp;&nbsp;<I>content consumed by tag evaluation</I><BR>
- &lt;/f:replaceAll&gt;
+ &lt;%-- This will result in ///// --%&gt;<BR>
+ &lt;f:replaceAll value=&quot;.&quot; replacement=&quot;/&quot; regex=&quot;true&quot;&gt;<br>
+ &nbsp;&nbsp;&nbsp;&nbsp;a.b.c</I><BR>
+ &lt;/f:replaceAll&gt;<BR><BR>
<!-- End replaceAll example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/formatTags/stripTag.html b/doc/org.eclipse.jet.doc/references/taglibs/formatTags/stripTag.html
index 77ca584..ee5e4b0 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/formatTags/stripTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/formatTags/stripTag.html
@@ -42,15 +42,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
-<HR>
-<TABLE border="1" width="100%">
- <TBODY>
- <TR>
- <TH colspan="2" align="left">Required Attributes</TH></TR>
- </TBODY>
-</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -60,9 +51,9 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin strip example -->
-
+ &lt;%-- This will result 'abc' --%&gt;<BR>
&lt;f:strip&gt;<br>
- &nbsp;&nbsp;&nbsp;&nbsp;<I>content consumed by tag evaluation</I><BR>
+ &nbsp;&nbsp;&nbsp;&nbsp;a b c <BR>
&lt;/f:strip&gt;
<!-- End strip example -->
</SPAN></TD>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/formatTags/ucTag.html b/doc/org.eclipse.jet.doc/references/taglibs/formatTags/ucTag.html
index 593bde2..9348cfe 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/formatTags/ucTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/formatTags/ucTag.html
@@ -42,15 +42,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
-<HR>
-<TABLE border="1" width="100%">
- <TBODY>
- <TR>
- <TH colspan="2" align="left">Required Attributes</TH></TR>
- </TBODY>
-</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -76,10 +67,8 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin uc example -->
-
- &lt;f:uc&gt;<br>
- &nbsp;&nbsp;&nbsp;&nbsp;<I>content consumed by tag evaluation</I><BR>
- &lt;/f:uc&gt;
+ &lt;%-- This will result in 'LOWER' --%&gt;<BR>
+ &lt;f:uc&gt;lower&lt;/f:uc&gt;
<!-- End uc example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/formatTags/uniqueTag.html b/doc/org.eclipse.jet.doc/references/taglibs/formatTags/uniqueTag.html
index c8fe134..3245381 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/formatTags/uniqueTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/formatTags/uniqueTag.html
@@ -38,15 +38,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
-<HR>
-<TABLE border="1" width="100%">
- <TBODY>
- <TR>
- <TH colspan="2" align="left">Required Attributes</TH></TR>
- </TBODY>
-</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -56,7 +47,10 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin unique example -->
-
+ &lt;%-- if this is the first time this is used, 1 will be returned --%&gt;<BR>
+ &lt;f:unique/&gt;<br><BR>
+
+ &lt;%-- if the above retuned 1 this will return 2 --%&gt;<BR>
&lt;f:unique/&gt;<br>
<!-- End unique example -->
</SPAN></TD>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/formatTags/uuidTag.html b/doc/org.eclipse.jet.doc/references/taglibs/formatTags/uuidTag.html
index 9682459..5d34e2a 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/formatTags/uuidTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/formatTags/uuidTag.html
@@ -18,7 +18,7 @@
</TABLE>
<HR>
<P><B>uuid</B></P>
-<P>Default description for tag uuid</P>
+<P>Generate a universally unique identifier (UUID).</P>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -38,15 +38,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
-<HR>
-<TABLE border="1" width="100%">
- <TBODY>
- <TR>
- <TH colspan="2" align="left">Required Attributes</TH></TR>
- </TBODY>
-</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -56,7 +47,7 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin uuid example -->
-
+ &lt;%-- This will return a unique string something like: _e_GS4EgEEdugkoUy0CmRoA --%&gt;<BR>
&lt;f:uuid/&gt;<br>
<!-- End uuid example -->
</SPAN></TD>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/javaTags/classTag.html b/doc/org.eclipse.jet.doc/references/taglibs/javaTags/classTag.html
index 8cd5e30..85355f6 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/javaTags/classTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/javaTags/classTag.html
@@ -18,7 +18,7 @@
</TABLE>
<HR>
<P><B>class</B></P>
-<P><P> Create a Java class with the specified name.<P> </P>
+<P><P> Create a Java class with the specified name and write its contents by evaluating the supplied template.<P> </P>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -33,12 +33,11 @@
<TR>
<TD width="10%">full tag</TD>
<TD><SPAN style="font-family: monospace">
- &lt;java:class name=&quot;<I>value</I>&quot; template=&quot;<I>value</I>&quot; package=&quot;<I>value</I>&quot; srcFolder=&quot;<I>value</I>&quot; project=&quot;<I>value</I>&quot; replace=&quot;<I>value</I>&quot; encoding=&quot;<I>value</I>&quot; derived=&quot;<I>value</I>&quot;/&gt;<br>
+ &lt;java:class name=&quot;<I>value</I>&quot; template=&quot;<I>value</I>&quot; package=&quot;<I>value</I>&quot; srcFolder=&quot;<I>value</I>&quot; replace=&quot;<I>value</I>&quot; encoding=&quot;<I>value</I>&quot; derived=&quot;<I>value</I>&quot;/&gt;<br>
</SPAN></TD>
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -50,11 +49,10 @@
</TR>
<TR>
<TD width="10%">template</TD>
- <TD>TODO Define description of template</TD>
+ <TD><BR> A project-relative path of a JET template to execute. The template provides the class file's contents.<BR> </TD>
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -70,20 +68,16 @@
<TD><BR> The a path of source folder. If a relative path, this relative to any containing 'ws:project' or 'ws:folder' tags. If absolute, it is treated as a workspace relative path. If omitted, the first source folder of the containing project is used.<BR> </TD>
</TR>
<TR>
- <TD width="10%">project</TD>
- <TD>TODO Define description of project</TD>
- </TR>
- <TR>
<TD width="10%">replace</TD>
- <TD>TODO Define description of replace</TD>
+ <TD><BR> A boolean ('true' or 'false') value. If 'true', the tag will overwrite an existing file, otherwise it will not. If omitted, a value of 'true' is assumed.<BR> </TD>
</TR>
<TR>
<TD width="10%">encoding</TD>
- <TD>TODO Define description of encoding</TD>
+ <TD><BR> The character encoding of the file. If omitted, then the Eclipse workspace determines the encoding. If provided, then the encoding is changed to the specified value. A value of '#default' restores the encoding of the file to the workspace determined default.<BR> </TD>
</TR>
<TR>
<TD width="10%">derived</TD>
- <TD>TODO Define description of derived</TD>
+ <TD><BR> A boolean value ('true' or 'false') determining the value of the workspace 'derived' attribute for the file. If omitted, a value of 'false' is assumed.<BR> </TD>
</TR>
</TBODY>
</TABLE>
@@ -96,8 +90,18 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin class example -->
-
- &lt;java:class name=&quot;<I>value</I>&quot; template=&quot;<I>value</I>&quot;/&gt;<br>
+ &lt;%-- create class Foo in package org.example in source folder myProject/src --%&lt;<BR>
+ &lt;java:class name=&quot;Foo&quot; package="org.example" srcFolder="myProject/src" template=&quot;myJava.jet&quot;/&gt;<br><BR>
+
+ &lt;%-- create classes Foo &amp; Bar in package org.example in source folder myProject/src --%><BR>
+ &lt;ws:project name="myProject"&gt;<BR>
+ &nbsp;&nbsp;&lt;ws:folder path=&quot;src&quot;&gt;<BR>
+ &nbsp;&nbsp;&nbsp;&nbsp;&lt;java:package name="org.example"&gt;<BR>
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;java:class name="Foo" template="myFoo.jet"/&gt;<BR>
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;java:class name="Bar" template="myBar.jet"/&gt;<BR>
+ &nbsp;&nbsp;&nbsp;&nbsp;&lt;/java:package&gt;<BR>
+ &nbsp;&nbsp;&lt;/ws:folder&gt;<BR>
+ &lt;/ws:project&gt;<BR>
<!-- End class example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/javaTags/impliedImportTag.html b/doc/org.eclipse.jet.doc/references/taglibs/javaTags/impliedImportTag.html
index 0ea003a..117d829 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/javaTags/impliedImportTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/javaTags/impliedImportTag.html
@@ -38,7 +38,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -50,7 +49,6 @@
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -60,8 +58,11 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin impliedImport example -->
-
- &lt;java:impliedImport name=&quot;<I>value</I>&quot;/&gt;<br>
+ &lt;%-- setup implied import of org.example.List class --%&gt;<BR>
+ package org.example;<BR><BR>
+ &lt;java:importsLocation package="org.example"&gt;<BR>
+ &lt;java:impliedImport name=&quot;org.example.List&quot;/&gt;<br>
+
<!-- End impliedImport example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/javaTags/importTag.html b/doc/org.eclipse.jet.doc/references/taglibs/javaTags/importTag.html
index 50854d6..879aa50 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/javaTags/importTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/javaTags/importTag.html
@@ -42,15 +42,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
-<HR>
-<TABLE border="1" width="100%">
- <TBODY>
- <TR>
- <TH colspan="2" align="left">Required Attributes</TH></TR>
- </TBODY>
-</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -60,10 +51,11 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin import example -->
-
- &lt;java:import&gt;<br>
- &nbsp;&nbsp;&nbsp;&nbsp;<I>content consumed by tag evaluation</I><BR>
- &lt;/java:import&gt;
+ &lt;%-- generates List and in import java.util.List import if another List is not imported --%&gt;<BR>
+ package org.example;<BR><BR>
+ &lt;java:importsLocation package=&quot;org.example&quot;/&gt;<BR><BR>
+ <I>... later in the template ...</I><BR><BR>
+ &lt;java:import&gt;java.util.List&lt;/java:import&gt; myList;
<!-- End import example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/javaTags/importsLocationTag.html b/doc/org.eclipse.jet.doc/references/taglibs/javaTags/importsLocationTag.html
index e0ec7ff..67c34ab 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/javaTags/importsLocationTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/javaTags/importsLocationTag.html
@@ -38,7 +38,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -50,7 +49,6 @@
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -60,8 +58,10 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin importsLocation example -->
-
- &lt;java:importsLocation package=&quot;<I>value</I>&quot;/&gt;<br>
+ &lt;%-- setup location for automatical import statement insertion --%&gt;<BR>
+ package org.example;<BR><BR>
+
+ &lt;java:importsLocation package=&quot;org.example&quot;/&gt;<br>
<!-- End importsLocation example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/javaTags/mergeTag.html b/doc/org.eclipse.jet.doc/references/taglibs/javaTags/mergeTag.html
index ab5e977..1fb457f 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/javaTags/mergeTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/javaTags/mergeTag.html
@@ -38,15 +38,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
-<HR>
-<TABLE border="1" width="100%">
- <TBODY>
- <TR>
- <TH colspan="2" align="left">Required Attributes</TH></TR>
- </TBODY>
-</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -72,8 +63,16 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin merge example -->
-
- &lt;java:merge/&gt;<br>
+ <i>... template generating a .java or .properties file ...</i><BR><BR>
+ &lt;%-- Merge the generated contents with any existing file, using the standard JMerge rules --%&gt;<BR>
+ &lt;java:merge/&gt;<br><br>
+
+ &lt;%-- Merge using custom JMerge rules --%&gt;<BR>
+ &lt;java:merge rules=&quot;myMergeRules.xml&quot; rulesContext=&quot;transform&quot;/&gt;<br><br>
+
+ &lt;%-- Explicit use of EMF Codegen merge rules (same as first) --%&gt;<BR>
+ &lt;java:merge rules=&quot;platform:/plugin/org.eclipse.emf.codegen.ecore/templates/emf-merge.xml&quot;/&gt;<br><br>
+
<!-- End merge example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/javaTags/overview.html b/doc/org.eclipse.jet.doc/references/taglibs/javaTags/overview.html
index 1240c74..41b3da9 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/javaTags/overview.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/javaTags/overview.html
@@ -25,10 +25,10 @@
<TR>
<TH colspan="2" align="left">Tag Summary</TH></TR>
<TR>
- <TD width="10%"><A href="importsLocationTag.html">&lt;java:importsLocation&gt;</A></TD>
- <TD><!-- Begin importsLocation description -->
- <P> Identify the location for Java import statement generation
- <!-- End importsLocation description -->
+ <TD width="10%"><A href="classTag.html">&lt;java:class&gt;</A></TD>
+ <TD><!-- Begin class description -->
+ <P> Create a Java class with the specified name and write its contents by evaluating the supplied template
+ <!-- End class description -->
</TD>
</TR>
<TR>
@@ -46,6 +46,20 @@
</TD>
</TR>
<TR>
+ <TD width="10%"><A href="importsLocationTag.html">&lt;java:importsLocation&gt;</A></TD>
+ <TD><!-- Begin importsLocation description -->
+ <P> Identify the location for Java import statement generation
+ <!-- End importsLocation description -->
+ </TD>
+ </TR>
+ <TR>
+ <TD width="10%"><A href="mergeTag.html">&lt;java:merge&gt;</A></TD>
+ <TD><!-- Begin merge description -->
+ <P> Cause the template contents to be merged with the existing Java file using the EMF JMerge engine
+ <!-- End merge description -->
+ </TD>
+ </TR>
+ <TR>
<TD width="10%"><A href="packageTag.html">&lt;java:package&gt;</A></TD>
<TD><!-- Begin package description -->
<P> Create a Java package
@@ -59,20 +73,6 @@
<!-- End resource description -->
</TD>
</TR>
- <TR>
- <TD width="10%"><A href="classTag.html">&lt;java:class&gt;</A></TD>
- <TD><!-- Begin class description -->
- <P> Create a Java class with the specified name
- <!-- End class description -->
- </TD>
- </TR>
- <TR>
- <TD width="10%"><A href="mergeTag.html">&lt;java:merge&gt;</A></TD>
- <TD><!-- Begin merge description -->
- <P> Cause the template contents to be merged with the existing Java file using the EMF JMerge engine
- <!-- End merge description -->
- </TD>
- </TR>
</TBODY>
</TABLE>
<HR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/javaTags/packageTag.html b/doc/org.eclipse.jet.doc/references/taglibs/javaTags/packageTag.html
index 408d960..4ca8b87 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/javaTags/packageTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/javaTags/packageTag.html
@@ -35,14 +35,13 @@
<TR>
<TD width="10%">full tag</TD>
<TD><SPAN style="font-family: monospace">
- &lt;java:package name=&quot;<I>value</I>&quot; srcFolder=&quot;<I>value</I>&quot; project=&quot;<I>value</I>&quot;&gt;<br>
+ &lt;java:package name=&quot;<I>value</I>&quot; srcFolder=&quot;<I>value</I>&quot;&gt;<br>
&nbsp;&nbsp;&nbsp;&nbsp;<I>content to be written</I><BR>
&lt;/java:package&gt;
</SPAN></TD>
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -54,7 +53,6 @@
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -63,11 +61,7 @@
<TR>
<TR>
<TD width="10%">srcFolder</TD>
- <TD></TD>
- </TR>
- <TR>
- <TD width="10%">project</TD>
- <TD>TODO Define description of project</TD>
+ <TD><BR> The a path of source folder. If a relative path, this relative to any containing 'ws:project' or 'ws:folder' tags. If absolute, it is treated as a workspace relative path. If omitted, the first source folder of the containing project is used.<BR> </TD>
</TR>
</TBODY>
</TABLE>
@@ -80,9 +74,9 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin package example -->
-
- &lt;java:package name=&quot;<I>value</I>&quot;&gt;<br>
- &nbsp;&nbsp;&nbsp;&nbsp;<I>content to be written</I><BR>
+ &lt;%-- Create a package in myProject/src folder --%&gt;<BR>
+ &lt;java:package name=&quot;org.example&quot; srcFolder=&quot;myProject/src&quot;&gt;<br>
+ &nbsp;&nbsp;&nbsp;&nbsp;<I>... java:class and java:resource tags here will be relative to org.example ...</I><BR>
&lt;/java:package&gt;
<!-- End package example -->
</SPAN></TD>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/javaTags/resourceTag.html b/doc/org.eclipse.jet.doc/references/taglibs/javaTags/resourceTag.html
index 1a22a64..b0c152e 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/javaTags/resourceTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/javaTags/resourceTag.html
@@ -38,7 +38,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -50,11 +49,10 @@
</TR>
<TR>
<TD width="10%">template</TD>
- <TD>TODO Define description of template</TD>
+ <TD><BR> <BR> A project-relative path of a JET template to execute. The template provides the resource file's contents.<BR> <BR> A project-relative path of a JET template to execute. The template provides the resource file's contents.<BR> </TD>
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -63,23 +61,23 @@
<TR>
<TR>
<TD width="10%">package</TD>
- <TD></TD>
+ <TD><BR> The name of the java package. If not specified, then the name of the containing 'java:package' tag is used, otherwise, the default package is used.<BR> </TD>
</TR>
<TR>
<TD width="10%">srcFolder</TD>
- <TD></TD>
+ <TD><BR> The a path of source folder. If a relative path, this relative to any containing 'ws:project' or 'ws:folder' tags. If absolute, it is treated as a workspace relative path. If omitted, the first source folder of the containing project is used.<BR> </TD>
</TR>
<TR>
<TD width="10%">replace</TD>
- <TD>TODO Define description of replace</TD>
+ <TD><BR> A boolean ('true' or 'false') value. If 'true', the tag will overwrite an existing file, otherwise it will not. If omitted, a value of 'true' is assumed.<BR> </TD>
</TR>
<TR>
<TD width="10%">encoding</TD>
- <TD>TODO Define description of encoding</TD>
+ <TD><BR> The character encoding of the file. If omitted, then the Eclipse workspace determines the encoding. If provided, then the encoding is changed to the specified value. A value of '#default' restores the encoding of the file to the workspace determined default.<BR> </TD>
</TR>
<TR>
<TD width="10%">derived</TD>
- <TD>TODO Define description of derived</TD>
+ <TD><BR> A boolean value ('true' or 'false') determining the value of the workspace 'derived' attribute for the file. If omitted, a value of 'false' is assumed.<BR> </TD>
</TR>
</TBODY>
</TABLE>
@@ -92,8 +90,17 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin resource example -->
-
- &lt;java:resource name=&quot;<I>value</I>&quot; template=&quot;<I>value</I>&quot;/&gt;<br>
+ &lt;%-- create resource Messages.properties in package org.example in source folder myProject/src --%><BR>
+ &lt;java:resource name=&quot;Messages.properties&quot; package="org.example" srcFolder="myProject/src" template=&quot;myprops.jet&quot;/&gt;<br><BR>
+
+ &lt;%-- resource Messages.properties in package org.example in source folder myProject/src --%><BR>
+ &lt;ws:project name="myProject"&gt;<BR>
+ &nbsp;&nbsp;&lt;ws:folder path=&quot;src&quot;&gt;<BR>
+ &nbsp;&nbsp;&nbsp;&nbsp;&lt;java:package name="org.example"&gt;<BR>
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&lt;java:resource name="Messages.properties" template="myprops.jet"/&gt;<BR>
+ &nbsp;&nbsp;&nbsp;&nbsp;&lt;/java:package&gt;<BR>
+ &nbsp;&nbsp;&lt;/ws:folder&gt;<BR>
+ &lt;/ws:project&gt;<BR>
<!-- End resource example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/copyFileTag.html b/doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/copyFileTag.html
index f795f89..e5496e9 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/copyFileTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/copyFileTag.html
@@ -38,7 +38,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -54,7 +53,6 @@
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -92,8 +90,15 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin copyFile example -->
-
- &lt;ws:copyFile src=&quot;<I>value</I>&quot; target=&quot;<I>value</I>&quot;/&gt;<br>
+ &lt;%-- copy a transformation supplied file to the project myProject --%&gt;<BR>
+ &lt;ws:copyFile src=&quot;logo.gif&quot; target=&quot;myproject/logo.gif&quot; binary=&quot;true&quot;/&gt;<br><br>
+
+ &lt;%-- this is equivalent to --%gt;<BR>
+ &lt;ws:copyFile src=&quot;logo.gif&quot; srcContext=&quot;transform&quot; target=&quot;myproject/logo.gif&quot; binary=&quot;true&quot;/&gt;<br><br>
+
+ &lt;%-- copy a workspace file from yourProject to myProject --%gt;<br>
+ &lt;ws:copyFile src=&quot;yourProject/plugin.xml&quot; srcContext="workspace" target=&quot;myproject/plugin.xml&quot; /&gt;<br>
+
<!-- End copyFile example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/fileTag.html b/doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/fileTag.html
index 32e1d25..212c417 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/fileTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/fileTag.html
@@ -38,7 +38,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -54,7 +53,6 @@
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -84,8 +82,14 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin file example -->
-
- &lt;ws:file path=&quot;<I>value</I>&quot; template=&quot;<I>value</I>&quot;/&gt;<br>
+ &lt;%-- write a file about.html to myProject after evaluating template about.html.jet--%&gt;<br>
+ &lt;ws:file path=&quot;myProject/about.html&quot; template=&quot;templates/about.html.jet&quot;/&gt;<br><br>
+
+ &lt;%-- alternative way of doing the about--%&gt;<br>
+ &lt;ws:project name="myProject"&gt;<br>
+ &nbsp;&nbsp;&lt;ws:file path=&quot;about.html&quot; template=&quot;templates/about.html.jet&quot;/&gt;<br>
+ &nbsp;&nbsp;<i>... other ws:file tags writing to the same project ...</i><br>
+ &lt;/ws:project&gt;<br>
<!-- End file example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/folderTag.html b/doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/folderTag.html
index cfb7abf..ba717f6 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/folderTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/folderTag.html
@@ -42,7 +42,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -54,7 +53,6 @@
</TR>
</TBODY>
</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -64,9 +62,11 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin folder example -->
-
- &lt;ws:folder path=&quot;<I>value</I>&quot;&gt;<br>
- &nbsp;&nbsp;&nbsp;&nbsp;<I>content to be written</I><BR>
+ &lt;%-- Create a folder src in myProjet--%&gt;<br>
+ &lt;ws:folder path=&quot;myProject/src&quot;/&gt;<br><br>
+ &lt;%-- Create a folder src in myProjet, with nested actions--%&gt;<br>
+ &lt;ws:folder path=&quot;myProject/src&quot;/&gt;<br>
+ &nbsp;&nbsp;&nbsp;&nbsp;<I>... nested ws:folder and ws:file tags are relative to myProject/src ...</I><BR>
&lt;/ws:folder&gt;
<!-- End folder example -->
</SPAN></TD>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/overview.html b/doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/overview.html
index 6ebbb7a..dcbbac0 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/overview.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/overview.html
@@ -25,17 +25,10 @@
<TR>
<TH colspan="2" align="left">Tag Summary</TH></TR>
<TR>
- <TD width="10%"><A href="projectTag.html">&lt;ws:project&gt;</A></TD>
- <TD><!-- Begin project description -->
- <P> Ensure the existence of an Eclipse Project of a given name
- <!-- End project description -->
- </TD>
- </TR>
- <TR>
- <TD width="10%"><A href="folderTag.html">&lt;ws:folder&gt;</A></TD>
- <TD><!-- Begin folder description -->
- <P> Ensure the existence on an Eclipse Workspace Folder
- <!-- End folder description -->
+ <TD width="10%"><A href="copyFileTag.html">&lt;ws:copyFile&gt;</A></TD>
+ <TD><!-- Begin copyFile description -->
+ <P> Copy the file refered to by 'url' to the location refered to by 'path'
+ <!-- End copyFile description -->
</TD>
</TR>
<TR>
@@ -46,10 +39,17 @@
</TD>
</TR>
<TR>
- <TD width="10%"><A href="copyFileTag.html">&lt;ws:copyFile&gt;</A></TD>
- <TD><!-- Begin copyFile description -->
- <P> Copy the file refered to by 'url' to the location refered to by 'path'
- <!-- End copyFile description -->
+ <TD width="10%"><A href="folderTag.html">&lt;ws:folder&gt;</A></TD>
+ <TD><!-- Begin folder description -->
+ <P> Ensure the existence on an Eclipse Workspace Folder
+ <!-- End folder description -->
+ </TD>
+ </TR>
+ <TR>
+ <TD width="10%"><A href="projectTag.html">&lt;ws:project&gt;</A></TD>
+ <TD><!-- Begin project description -->
+ <P> Ensure the existence of an Eclipse Project of a given name
+ <!-- End project description -->
</TD>
</TR>
<TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/projectTag.html b/doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/projectTag.html
index f6143bf..af3b84b 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/projectTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/projectTag.html
@@ -35,14 +35,13 @@
<TR>
<TD width="10%">full tag</TD>
<TD><SPAN style="font-family: monospace">
- &lt;ws:project name=&quot;<I>value</I>&quot;&gt;<br>
+ &lt;ws:project name=&quot;<I>value</I>&quot; location=&quot;<I>value</I>&quot;&gt;<br>
&nbsp;&nbsp;&nbsp;&nbsp;<I>content to be written</I><BR>
&lt;/ws:project&gt;
</SPAN></TD>
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -54,7 +53,18 @@
</TR>
</TBODY>
</TABLE>
-</exists>
+<HR>
+<TABLE border="1" width="100%">
+ <TBODY>
+ <TR>
+ <TH colspan="2" align="left">Optional Attributes</TH></TR>
+ <TR>
+ <TR>
+ <TD width="10%">location</TD>
+ <TD><BR> An optional absolute file-system location for the new project. If not specified, the project is created in a directory under the workspace directory.<BR> </TD>
+ </TR>
+ </TBODY>
+</TABLE>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -64,10 +74,12 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin project example -->
-
- &lt;ws:project name=&quot;<I>value</I>&quot;&gt;<br>
- &nbsp;&nbsp;&nbsp;&nbsp;<I>content to be written</I><BR>
- &lt;/ws:project&gt;
+ &lt;%-- Create project myProjet (or ensure it exists) --%&gt;<br>
+ &lt;ws:project name=&quot;myProject&quot;/&gt;<br><br>
+ &lt;%-- Create project myProjet (or ensure it exists), with nested actions--%&gt;<br>
+ &lt;ws:project name=&quot;myProject&quot;/&gt;<br>
+ &nbsp;&nbsp;&nbsp;&nbsp;<I>... nested ws:folder and ws:file tags are relative to myProject ...</I><BR>
+ &lt;/ws:folder&gt;
<!-- End project example -->
</SPAN></TD>
</TR>
diff --git a/doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/rebuildWorkspaceTag.html b/doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/rebuildWorkspaceTag.html
index 61093e9..030d00a 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/rebuildWorkspaceTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/workspaceTags/rebuildWorkspaceTag.html
@@ -38,15 +38,6 @@
</TR>
</TBODY>
</TABLE>
-<exists node="tag/attribute use='required'">
-<HR>
-<TABLE border="1" width="100%">
- <TBODY>
- <TR>
- <TH colspan="2" align="left">Required Attributes</TH></TR>
- </TBODY>
-</TABLE>
-</exists>
<HR>
<TABLE border="1" width="100%">
<TBODY>
@@ -56,7 +47,8 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin rebuildWorkspace example -->
-
+ &lt;%-- Broadcast change events for Eclipse workspace changes already made,
+ allowing Eclipse to build before to continuing --%&gt;
&lt;ws:rebuildWorkspace/&gt;<br>
<!-- End rebuildWorkspace example -->
</SPAN></TD>

Back to the top