summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorpelder2006-09-19 12:53:47 (EDT)
committer pelder2006-09-19 12:53:47 (EDT)
commite4561049bf4d9cf8ba3d6ed077825a54301e6cb1 (patch)
tree606b0fc9846e45285bcc918140ce48428b3c0f54
parenta3613267c93c6547cb4e0daf81bf8fed972250e1 (diff)
downloadorg.eclipse.jet-e4561049bf4d9cf8ba3d6ed077825a54301e6cb1.zip
org.eclipse.jet-e4561049bf4d9cf8ba3d6ed077825a54301e6cb1.tar.gz
org.eclipse.jet-e4561049bf4d9cf8ba3d6ed077825a54301e6cb1.tar.bz2
[157811] Add examples to controlTags
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/addElementTag.html3
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/addTextElementTag.html5
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/caseTag.html9
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/chooseTag.html25
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/copyElementTag.html3
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/dumpTag.html3
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/getTag.html3
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/ifTag.html3
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/includeTag.html9
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/initialCodeTag.html22
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/invokeTransformTag.html7
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/iterateTag.html4
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/loadContentTag.html9
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/loadTag.html13
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/logTag.html8
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/markerTag.html8
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/otherwiseTag.html8
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/overrideTag.html5
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/removeElementTag.html3
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/replaceStringsTag.html5
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/setTag.html5
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/setVariableTag.html3
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/stringTokensTag.html9
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/userRegionTag.html22
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/visitTag.html11
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/visitorTag.html8
-rw-r--r--doc/org.eclipse.jet.doc/references/taglibs/controlTags/whenTag.html9
27 files changed, 174 insertions, 48 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 89a3718..be0015f 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/addElementTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/addElementTag.html
@@ -76,7 +76,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 da1902f..fa53ddd 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/addTextElementTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/addTextElementTag.html
@@ -84,8 +84,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 1c97c40..97bc487 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/caseTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/caseTag.html
@@ -66,10 +66,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 bb89b7c..0e2b96b 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/chooseTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/chooseTag.html
@@ -72,9 +72,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 dafca50..871c871 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/copyElementTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/copyElementTag.html
@@ -84,7 +84,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 be12849..e5dbebe 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/dumpTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/dumpTag.html
@@ -76,7 +76,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 ec06956..d3400f0 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/getTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/getTag.html
@@ -72,7 +72,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 eee5b8d..196fde5 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/ifTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/ifTag.html
@@ -78,7 +78,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 6be13c5..cc2cdbb 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/includeTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/includeTag.html
@@ -80,7 +80,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 8f6792b..a8a2fb1 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/initialCodeTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/initialCodeTag.html
@@ -72,9 +72,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 f5befb6..e1113e6 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/invokeTransformTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/invokeTransformTag.html
@@ -76,7 +76,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 bc525af..f8d2f91 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/iterateTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/iterateTag.html
@@ -80,8 +80,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 1f5ff62..cf3fe86 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/loadContentTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/loadContentTag.html
@@ -80,8 +80,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 1b5fcbc..6e7f1ac 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/loadTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/loadTag.html
@@ -84,7 +84,18 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin load example -->
- &lt;c:load url=&quot;<I>value</I>&quot; var=&quot;<I>value</I>&quot;/&gt;<br>
+ &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>
+
<!-- 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 2b15ebe..94d5bb9 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/logTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/logTag.html
@@ -72,8 +72,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 c02689b..be59654 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/markerTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/markerTag.html
@@ -72,9 +72,11 @@
<TD width="10%"></TD>
<TD><SPAN style="font-family: monospace">
<!-- Begin marker example -->
- &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!'--%&gt;<BR>
+ &lt;c:marker&gt;This text is marked!&lt;/c:marker&gt;<BR><BR>
+
+ &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/otherwiseTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/otherwiseTag.html
index a301c7c..92c49a2 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/otherwiseTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/otherwiseTag.html
@@ -62,10 +62,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 e228859..3cc8505 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/overrideTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/overrideTag.html
@@ -60,7 +60,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/removeElementTag.html b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/removeElementTag.html
index 698bfa2..7aef310 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/removeElementTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/removeElementTag.html
@@ -60,7 +60,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 7f3aece..8f7c4a1 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/replaceStringsTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/replaceStringsTag.html
@@ -68,8 +68,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 98d8e82..e8833bc 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/setTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/setTag.html
@@ -68,8 +68,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 bca3df7..d9ab3e3 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/setVariableTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/setVariableTag.html
@@ -64,7 +64,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 8f19e6d..8117019 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/stringTokensTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/stringTokensTag.html
@@ -92,8 +92,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 ae63a64..375603c 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/userRegionTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/userRegionTag.html
@@ -60,9 +60,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 82d8150..5737cfa 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/visitTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/visitTag.html
@@ -66,10 +66,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 0aedc9f..b7a478d 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/visitorTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/visitorTag.html
@@ -68,8 +68,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 f707b18..8e58615 100644
--- a/doc/org.eclipse.jet.doc/references/taglibs/controlTags/whenTag.html
+++ b/doc/org.eclipse.jet.doc/references/taglibs/controlTags/whenTag.html
@@ -66,10 +66,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>