cocoon-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cross...@apache.org
Subject svn commit: r405620 - in /cocoon/site/site/2.1: ./ howto/ userdocs/publishing/ userdocs/widgetconcepts/ userdocs/widgets/
Date Wed, 10 May 2006 03:53:08 GMT
Author: crossley
Date: Tue May  9 20:53:07 2006
New Revision: 405620

URL: http://svn.apache.org/viewcvs?rev=405620&view=rev
Log:
Regenerate the 2.1 docs from Daisy.
Regenerate 2.1/changes.html

Removed:
    cocoon/site/site/2.1/howto/howto-author-faq.html
Modified:
    cocoon/site/site/2.1/changes.html
    cocoon/site/site/2.1/changes.rss
    cocoon/site/site/2.1/userdocs/publishing/xslt.html
    cocoon/site/site/2.1/userdocs/widgetconcepts/datatypes.html
    cocoon/site/site/2.1/userdocs/widgetconcepts/eventhandling.html
    cocoon/site/site/2.1/userdocs/widgetconcepts/selectionlists.html
    cocoon/site/site/2.1/userdocs/widgets/widget_repeater.html
    cocoon/site/site/2.1/userdocs/widgets/widget_tree.html

Modified: cocoon/site/site/2.1/changes.html
URL: http://svn.apache.org/viewcvs/cocoon/site/site/2.1/changes.html?rev=405620&r1=405619&r2=405620&view=diff
==============================================================================
--- cocoon/site/site/2.1/changes.html (original)
+++ cocoon/site/site/2.1/changes.html Tue May  9 20:53:07 2006
@@ -1227,14 +1227,102 @@
 <h3 class="h4"></h3>
 <ul>
 <li>
-<img class="icon" alt="add" src="../images/add.jpg">DUMMY(NN)</li>
+<img class="icon" alt="add" src="../images/add.jpg">
+      Added CSS classes in cocoon forms default XSLs.
+    (SG) Fixes <a class="external" href="http://issues.apache.org/jira/browse/COCOON-1782">COCOON-1782</a>.</li>
+<li>
+<img class="icon" alt="update" src="../images/update.jpg">
+      Updated ehcache to 1.2.
+    (AG)</li>
+<li>
+<img class="icon" alt="fix" src="../images/fix.jpg">
+      The JDK 1.4 version of the EncodeURLTransformer did not work properly as it was not matching just the
+      beginning of the string as the Jakarta-regexp version does. The transformer was corrected to only match
+      the beginning of the string.  In 2.1.9 this error can be circumvented by configuring the transformer and
+      adding "*" to the end of each pattern.
+    (RG) Fixes <a class="external" href="http://issues.apache.org/jira/browse/COCOON-1742">COCOON-1742</a>.</li>
+<li>
+<img class="icon" alt="add" src="../images/add.jpg">
+      As with all the AbstractTextSerializer based serializers, the XHTMLSerializer should handle the omit-xml-declaration to not put the XML declaration as first line of the serialized document.
+      This prevents many rendering problems in Internet Explorer. Default behaviour is to send the xml declaration as before.
+    (AS) Thanks to <a href="mailto:m.pillitu.at.thebug.it">Maurizio Pillitu</a>. Fixes <a class="external" href="http://issues.apache.org/jira/browse/COCOON-1845">COCOON-1845</a>.</li>
+<li>
+<img class="icon" alt="fix" src="../images/fix.jpg">
+      Commandline interface: the user-agent is now correctly set in the request headers (and not in the request parameters).
+    (CZ) Thanks to <a href="mailto:james.bates.at.amplexor.com ">James Bates</a>. Fixes <a class="external" href="http://issues.apache.org/jira/browse/COCOON-1511">COCOON-1511</a>.</li>
+<li>
+<img class="icon" alt="fix" src="../images/fix.jpg">
+      RandomNumberModule: does not returns random number in the range (min,max) as expected.
+    (AG) Fixes <a class="external" href="http://issues.apache.org/jira/browse/COCOON-1716">COCOON-1716</a>.</li>
+<li>
+<img class="icon" alt="fix" src="../images/fix.jpg">
+      Performance Issue/JavaScriptFlowScript: If &lt;reload-scripts&gt; is set to false,
+      don't check for last modification time of javascript source files.
+    (AG) Thanks to <a href="mailto:georg.huettenegger.at.gmx.at">Georg H&uuml;ttenegger</a>. Fixes <a class="external" href="http://issues.apache.org/jira/browse/COCOON-1721">COCOON-1721</a>.</li>
+<li>
+<img class="icon" alt="fix" src="../images/fix.jpg">
+      XSP block: Fix regression introduced in 2.1.8 that under specific circumstances logicsheets
+      were not applied, leading to compilation errors.  This manifested itself only if
+      a) two XSPs referred to the same custom logicsheet by a relative location path,
+      b) the custom logicsheet used another logicsheet, and
+      c) the built-in logicsheet's namespace was not mentioned in xsp:page.
+      The compilation errors occurred always when calling the second XSP for the first time.
+      Fix also race condition which could lead to similar XSP compilation errors under high load
+      when accessing the same logicsheet for the first time.
+    (AN)</li>
+<li>
+<img class="icon" alt="fix" src="../images/fix.jpg">
+      Template block: Make the template block usable with JDK 1.3+ and enable it by default.
+    (CZ)</li>
+<li>
+<img class="icon" alt="fix" src="../images/fix.jpg">
+      CForms: Fix inplace editing samples
+    (JBQ)</li>
+<li>
+<img class="icon" alt="add" src="../images/add.jpg">
+      CForms: Add id, state and listening attributes to the transformed form-template element (jx macros
+              and forms transformer).
+    (CZ) Fixes <a class="external" href="http://issues.apache.org/jira/browse/COCOON-1820">COCOON-1820</a>.</li>
+<li>
+<img class="icon" alt="add" src="../images/add.jpg">
+      XSP block: Use private methods to call start/endElement in xsp.xsl.
+      That generates smaller bytecode allowing to compiler larger XSPs before hitting the
+      64k limit for the size of the generate() method.
+    (AN)</li>
+<li>
+<img class="icon" alt="add" src="../images/add.jpg">
+      Forms block: modified ProcessingPhase to add a PROCESSING_INITIALIZE phase instead of the spurious
+      double READ_FROM_REQUEST_VALUE sent before. Made a ProcessingPhaseListener configurable from
+      form definition with on-processing-phase and adapted the JavaScript widget listener to support
+      processing phase events.
+    (SG) Fixes <a class="external" href="http://issues.apache.org/jira/browse/COCOON-1781COCOON-1685">COCOON-1781COCOON-1685</a>.</li>
+<li>
+<img class="icon" alt="add" src="../images/add.jpg">
+      Forms block: added repeater events. Repeater now sends row added, deleted etc.. events.
+      The listener can be added in definition with an on-repeater-modified element. Added support
+      for these events in JavaScript listener.
+    (SG) Fixes <a class="external" href="http://issues.apache.org/jira/browse/COCOON-1801">COCOON-1801</a>.</li>
+<li>
+<img class="icon" alt="fix" src="../images/fix.jpg">
+      Passing the default locale while parsing initial-value on a form if no locale attribute was specified.
+    (SG) Fixes <a class="external" href="http://issues.apache.org/jira/browse/COCOON-1844">COCOON-1844</a>.</li>
+</ul>
+<a name="N10097"></a><a name="Contributors"></a>
+<h3 class="h4">Contributors</h3>
+<p>This is a list of all people who have contributed to this release, but 
+       were not full developers on the project. We thank these people for their 
+       contributions.</p>
+<ul>
+<li>Georg H&uuml;ttenegger</li>
+<li>James Bates</li>
+<li>Maurizio Pillitu</li>
 </ul>
 </div>
   
-<a name="N1001E"></a><a name="version_2.1.9"></a>
+<a name="N100A5"></a><a name="version_2.1.9"></a>
 <h2 class="h3">Version 2.1.9 (April 7 2006)</h2>
 <div class="section">
-<a name="N10022"></a><a name="-N10022"></a>
+<a name="N100A9"></a><a name="-N100A9"></a>
 <h3 class="h4"></h3>
 <ul>
 <li>
@@ -1642,7 +1730,7 @@
       complex the actual pipeline is.
     (MPF)</li>
 </ul>
-<a name="N10339"></a><a name="Contributors"></a>
+<a name="N103C0"></a><a name="Contributors-N103C0"></a>
 <h3 class="h4">Contributors</h3>
 <p>This is a list of all people who have contributed to this release, but 
        were not full developers on the project. We thank these people for their 
@@ -1679,10 +1767,10 @@
 </ul>
 </div>
   
-<a name="N10379"></a><a name="version_2.1.8"></a>
+<a name="N10400"></a><a name="version_2.1.8"></a>
 <h2 class="h3">Version 2.1.8 (November 18 2005)</h2>
 <div class="section">
-<a name="N1037D"></a><a name="-N1037D"></a>
+<a name="N10404"></a><a name="-N10404"></a>
 <h3 class="h4"></h3>
 <ul>
 <li>
@@ -2469,7 +2557,7 @@
       Portal block: Make portal manager available through portal component manager.
     (CZ)</li>
 </ul>
-<a name="N108B4"></a><a name="Contributors-N108B4"></a>
+<a name="N1093B"></a><a name="Contributors-N1093B"></a>
 <h3 class="h4">Contributors</h3>
 <p>This is a list of all people who have contributed to this release, but 
        were not full developers on the project. We thank these people for their 
@@ -2511,10 +2599,10 @@
 </ul>
 </div>
   
-<a name="N108FE"></a><a name="version_2.1.7"></a>
+<a name="N10985"></a><a name="version_2.1.7"></a>
 <h2 class="h3">Version 2.1.7 (March 23 2005)</h2>
 <div class="section">
-<a name="N10902"></a><a name="-N10902"></a>
+<a name="N10989"></a><a name="-N10989"></a>
 <h3 class="h4"></h3>
 <ul>
 <li>
@@ -2952,7 +3040,7 @@
      Fix: Continuation can only be invoked for the interpreter it was originally created for.
    (LG)</li>
 </ul>
-<a name="N10B65"></a><a name="Contributors-N10B65"></a>
+<a name="N10BEC"></a><a name="Contributors-N10BEC"></a>
 <h3 class="h4">Contributors</h3>
 <p>This is a list of all people who have contributed to this release, but 
        were not full developers on the project. We thank these people for their 
@@ -2966,10 +3054,10 @@
 </ul>
 </div>
  
-<a name="N10B77"></a><a name="version_2.1.6"></a>
+<a name="N10BFE"></a><a name="version_2.1.6"></a>
 <h2 class="h3">Version 2.1.6 (November 19 2004)</h2>
 <div class="section">
-<a name="N10B7B"></a><a name="-N10B7B"></a>
+<a name="N10C02"></a><a name="-N10C02"></a>
 <h3 class="h4"></h3>
 <ul>
 <li>
@@ -3543,7 +3631,7 @@
      Added instrumentation support to ContinuationsManager.
    (VG)</li>
 </ul>
-<a name="N10F60"></a><a name="Contributors-N10F60"></a>
+<a name="N10FE7"></a><a name="Contributors-N10FE7"></a>
 <h3 class="h4">Contributors</h3>
 <p>This is a list of all people who have contributed to this release, but 
        were not full developers on the project. We thank these people for their 
@@ -3575,10 +3663,10 @@
 </ul>
 </div>
  
-<a name="N10F96"></a><a name="version_2.1.5.1"></a>
+<a name="N1101D"></a><a name="version_2.1.5.1"></a>
 <h2 class="h3">Version 2.1.5.1 (July 9 2004)</h2>
 <div class="section">
-<a name="N10F9A"></a><a name="-N10F9A"></a>
+<a name="N11021"></a><a name="-N11021"></a>
 <h3 class="h4"></h3>
 <ul>
 <li>
@@ -4005,7 +4093,7 @@
      Remove non-FOM flow classes and system.js
    (VG)</li>
 </ul>
-<a name="N1125A"></a><a name="Contributors-N1125A"></a>
+<a name="N112E1"></a><a name="Contributors-N112E1"></a>
 <h3 class="h4">Contributors</h3>
 <p>This is a list of all people who have contributed to this release, but 
        were not full developers on the project. We thank these people for their 
@@ -4024,10 +4112,10 @@
 </ul>
 </div>
  
-<a name="N11276"></a><a name="version_2.1.4"></a>
+<a name="N112FD"></a><a name="version_2.1.4"></a>
 <h2 class="h3">Version 2.1.4 (February 12 2004)</h2>
 <div class="section">
-<a name="N1127A"></a><a name="-N1127A"></a>
+<a name="N11301"></a><a name="-N11301"></a>
 <h3 class="h4"></h3>
 <ul>
 <li>
@@ -4278,7 +4366,7 @@
      Disable accessing files outside the context via the context protocol.
    (CZ) Fixes <a class="external" href="http://issues.apache.org/jira/browse/24093">24093</a>.</li>
 </ul>
-<a name="N113C2"></a><a name="Contributors-N113C2"></a>
+<a name="N11449"></a><a name="Contributors-N11449"></a>
 <h3 class="h4">Contributors</h3>
 <p>This is a list of all people who have contributed to this release, but 
        were not full developers on the project. We thank these people for their 
@@ -4290,10 +4378,10 @@
 </ul>
 </div>
  
-<a name="N113D0"></a><a name="version_2.1.3"></a>
+<a name="N11457"></a><a name="version_2.1.3"></a>
 <h2 class="h3">Version 2.1.3 (November 13 2003)</h2>
 <div class="section">
-<a name="N113D4"></a><a name="-N113D4"></a>
+<a name="N1145B"></a><a name="-N1145B"></a>
 <h3 class="h4"></h3>
 <ul>
 <li>
@@ -4433,7 +4521,7 @@
      AbstractSAXTransformer. Update examples to show basic repeat tag usage.
    (CH)</li>
 </ul>
-<a name="N114D8"></a><a name="Contributors-N114D8"></a>
+<a name="N1155F"></a><a name="Contributors-N1155F"></a>
 <h3 class="h4">Contributors</h3>
 <p>This is a list of all people who have contributed to this release, but 
        were not full developers on the project. We thank these people for their 
@@ -4453,10 +4541,10 @@
 </ul>
 </div>
  
-<a name="N114F6"></a><a name="version_2.1.2"></a>
+<a name="N1157D"></a><a name="version_2.1.2"></a>
 <h2 class="h3">Version 2.1.2 (September 30 2003)</h2>
 <div class="section">
-<a name="N114FA"></a><a name="-N114FA"></a>
+<a name="N11581"></a><a name="-N11581"></a>
 <h3 class="h4"></h3>
 <ul>
 <li>
@@ -4534,7 +4622,7 @@
      "sitemap.handled-errors". Previously they weren't logged.
    (BRD)</li>
 </ul>
-<a name="N1155F"></a><a name="Contributors-N1155F"></a>
+<a name="N115E6"></a><a name="Contributors-N115E6"></a>
 <h3 class="h4">Contributors</h3>
 <p>This is a list of all people who have contributed to this release, but 
        were not full developers on the project. We thank these people for their 
@@ -4544,10 +4632,10 @@
 </ul>
 </div>
  
-<a name="N11569"></a><a name="version_2.1.1"></a>
+<a name="N115F0"></a><a name="version_2.1.1"></a>
 <h2 class="h3">Version 2.1.1 (September 05 2003)</h2>
 <div class="section">
-<a name="N1156D"></a><a name="-N1156D"></a>
+<a name="N115F4"></a><a name="-N115F4"></a>
 <h3 class="h4"></h3>
 <ul>
 <li>
@@ -4679,7 +4767,7 @@
      view labels from the same component in the parent sitemap.
    (SW) Fixes <a class="external" href="http://issues.apache.org/jira/browse/22239">22239</a>.</li>
 </ul>
-<a name="N1162E"></a><a name="Contributors-N1162E"></a>
+<a name="N116B5"></a><a name="Contributors-N116B5"></a>
 <h3 class="h4">Contributors</h3>
 <p>This is a list of all people who have contributed to this release, but 
        were not full developers on the project. We thank these people for their 
@@ -4692,10 +4780,10 @@
 </ul>
 </div>
  
-<a name="N1163E"></a><a name="version_2.1"></a>
+<a name="N116C5"></a><a name="version_2.1"></a>
 <h2 class="h3">Version 2.1 (August 12 2003)</h2>
 <div class="section">
-<a name="N11642"></a><a name="-N11642"></a>
+<a name="N116C9"></a><a name="-N116C9"></a>
 <h3 class="h4"></h3>
 <ul>
 <li>
@@ -4762,7 +4850,7 @@
     Fix the ignoreErrors handling in the cinclude transformer.
   (CZ)</li>
 </ul>
-<a name="N116D8"></a><a name="Contributors-N116D8"></a>
+<a name="N1175F"></a><a name="Contributors-N1175F"></a>
 <h3 class="h4">Contributors</h3>
 <p>This is a list of all people who have contributed to this release, but 
        were not full developers on the project. We thank these people for their 
@@ -4773,10 +4861,10 @@
 </ul>
 </div>
  
-<a name="N116E4"></a><a name="version_2.1rc1"></a>
+<a name="N1176B"></a><a name="version_2.1rc1"></a>
 <h2 class="h3">Version 2.1rc1 (July 29 2003)</h2>
 <div class="section">
-<a name="N116E8"></a><a name="-N116E8"></a>
+<a name="N1176F"></a><a name="-N1176F"></a>
 <h3 class="h4"></h3>
 <ul>
 <li>
@@ -4913,7 +5001,7 @@
     Applied patch for implementing exists for the xmldb source.
   (CZ) Thanks to <a href="mailto:tjg.at.star.le.ac.uk">Tim Goodwin</a>. Fixes <a class="external" href="http://issues.apache.org/jira/browse/20115">20115</a>.</li>
 </ul>
-<a name="N117B0"></a><a name="Contributors-N117B0"></a>
+<a name="N11837"></a><a name="Contributors-N11837"></a>
 <h3 class="h4">Contributors</h3>
 <p>This is a list of all people who have contributed to this release, but 
        were not full developers on the project. We thank these people for their 
@@ -4925,10 +5013,10 @@
 </ul>
 </div>
  
-<a name="N117BE"></a><a name="version_2.1m3"></a>
+<a name="N11845"></a><a name="version_2.1m3"></a>
 <h2 class="h3">Version 2.1m3 (July 5 2003)</h2>
 <div class="section">
-<a name="N117C2"></a><a name="-N117C2"></a>
+<a name="N11849"></a><a name="-N11849"></a>
 <h3 class="h4"></h3>
 <ul>
 <li>
@@ -5090,7 +5178,7 @@
     Cocoon servlet shuts down or when Cocoon is reloaded.
   (BRD) Thanks to <a href="mailto:unico.at.hippo.nl">Unico Hommes</a>. Fixes <a class="external" href="http://issues.apache.org/jira/browse/15312">15312</a>.</li>
 </ul>
-<a name="N118EE"></a><a name="Contributors-N118EE"></a>
+<a name="N11975"></a><a name="Contributors-N11975"></a>
 <h3 class="h4">Contributors</h3>
 <p>This is a list of all people who have contributed to this release, but 
        were not full developers on the project. We thank these people for their 
@@ -5108,10 +5196,10 @@
 </ul>
 </div>
  
-<a name="N11908"></a><a name="version_2.1m2"></a>
+<a name="N1198F"></a><a name="version_2.1m2"></a>
 <h2 class="h3">Version 2.1m2 (May 20 2003)</h2>
 <div class="section">
-<a name="N1190C"></a><a name="-N1190C"></a>
+<a name="N11993"></a><a name="-N11993"></a>
 <h3 class="h4"></h3>
 <ul>
 <li>
@@ -5253,7 +5341,7 @@
     XMLDBSourceFactory.
   (VG) Fixes <a class="external" href="http://issues.apache.org/jira/browse/18683">18683</a>.</li>
 </ul>
-<a name="N11A3C"></a><a name="Contributors-N11A3C"></a>
+<a name="N11AC3"></a><a name="Contributors-N11AC3"></a>
 <h3 class="h4">Contributors</h3>
 <p>This is a list of all people who have contributed to this release, but 
        were not full developers on the project. We thank these people for their 
@@ -5270,10 +5358,10 @@
 </ul>
 </div>
  
-<a name="N11A54"></a><a name="version_2.1-M1"></a>
+<a name="N11ADB"></a><a name="version_2.1-M1"></a>
 <h2 class="h3">Version 2.1-M1 (April 29 2003)</h2>
 <div class="section">
-<a name="N11A58"></a><a name="-N11A58"></a>
+<a name="N11ADF"></a><a name="-N11ADF"></a>
 <h3 class="h4"></h3>
 <ul>
 <li>
@@ -6355,7 +6443,7 @@
     of (for more performance) by the quick-modified-test.
   (CZ) Fixes <a class="external" href="http://issues.apache.org/jira/browse/12915">12915</a>.</li>
 </ul>
-<a name="N11FD5"></a><a name="Contributors-N11FD5"></a>
+<a name="N1205C"></a><a name="Contributors-N1205C"></a>
 <h3 class="h4">Contributors</h3>
 <p>This is a list of all people who have contributed to this release, but 
        were not full developers on the project. We thank these people for their 
@@ -6387,7 +6475,7 @@
 </ul>
 </div>
   
-<a name="N1200B"></a><a name="Committers"></a>
+<a name="N12092"></a><a name="Committers"></a>
 <h2 class="h3">Committers</h2>
 <div class="section">
 <p>This is a list of all people who have been 
@@ -6409,6 +6497,7 @@
 <li>Pierpaolo Fumagalli (PF)</li>
 <li>Antonio Gallardo (AG)</li>
 <li>Leszek Gawron (LG)</li>
+<li>Simone Gianni (SG)</li>
 <li>Ralph Goers (RG)</li>
 <li>Vadim Gritsenko (VG)</li>
 <li>Christian Haul (CH)</li>

Modified: cocoon/site/site/2.1/changes.rss
URL: http://svn.apache.org/viewcvs/cocoon/site/site/2.1/changes.rss?rev=405620&r1=405619&r2=405620&view=diff
==============================================================================
--- cocoon/site/site/2.1/changes.rss (original)
+++ cocoon/site/site/2.1/changes.rss Tue May  9 20:53:07 2006
@@ -56,6 +56,7 @@
   
   
   
+  
  
 
   
@@ -63,11 +64,171 @@
   
 
   
+    <item><title> add
+          (bug COCOON-1782)
+        </title><link>changes.html</link><description> add
+        by
+        SG
+          (fixes bug COCOON-1782)
+        
+        :
+        
+      Added CSS classes in cocoon forms default XSLs.
+    </description></item>
+    <item><title> update</title><link>changes.html</link><description> update
+        by
+        AG
+        :
+        
+      Updated ehcache to 1.2.
+    </description></item>
+    <item><title> fix
+          (bug COCOON-1742)
+        </title><link>changes.html</link><description> fix
+        by
+        RG
+          (fixes bug COCOON-1742)
+        
+        :
+        
+      The JDK 1.4 version of the EncodeURLTransformer did not work properly as it was not matching just the
+      beginning of the string as the Jakarta-regexp version does. The transformer was corrected to only match
+      the beginning of the string.  In 2.1.9 this error can be circumvented by configuring the transformer and
+      adding "*" to the end of each pattern.
+    </description></item>
+    <item><title> add
+          (bug COCOON-1845)
+        </title><link>changes.html</link><description> add
+        by
+        AS
+          (fixes bug COCOON-1845)
+        
+        :
+        
+      As with all the AbstractTextSerializer based serializers, the XHTMLSerializer should handle the omit-xml-declaration to not put the XML declaration as first line of the serialized document.
+      This prevents many rendering problems in Internet Explorer. Default behaviour is to send the xml declaration as before.
+     Thanks to Maurizio Pillitu.</description></item>
+    <item><title> fix
+          (bug COCOON-1511)
+        </title><link>changes.html</link><description> fix
+        by
+        CZ
+          (fixes bug COCOON-1511)
+        
+        :
+        
+      Commandline interface: the user-agent is now correctly set in the request headers (and not in the request parameters).
+     Thanks to James Bates.</description></item>
+    <item><title> fix
+          (bug COCOON-1716)
+        </title><link>changes.html</link><description> fix
+        by
+        AG
+          (fixes bug COCOON-1716)
+        
+        :
+        
+      RandomNumberModule: does not returns random number in the range (min,max) as expected.
+    </description></item>
+    <item><title> fix
+          (bug COCOON-1721)
+        </title><link>changes.html</link><description> fix
+        by
+        AG
+          (fixes bug COCOON-1721)
+        
+        :
+        
+      Performance Issue/JavaScriptFlowScript: If &lt;reload-scripts&gt; is set to false,
+      don't check for last modification time of javascript source files.
+     Thanks to Georg H├╝ttenegger.</description></item>
+    <item><title> fix</title><link>changes.html</link><description> fix
+        by
+        AN
+        :
+        
+      XSP block: Fix regression introduced in 2.1.8 that under specific circumstances logicsheets
+      were not applied, leading to compilation errors.  This manifested itself only if
+      a) two XSPs referred to the same custom logicsheet by a relative location path,
+      b) the custom logicsheet used another logicsheet, and
+      c) the built-in logicsheet's namespace was not mentioned in xsp:page.
+      The compilation errors occurred always when calling the second XSP for the first time.
+      Fix also race condition which could lead to similar XSP compilation errors under high load
+      when accessing the same logicsheet for the first time.
+    </description></item>
+    <item><title> fix</title><link>changes.html</link><description> fix
+        by
+        CZ
+        :
+        
+      Template block: Make the template block usable with JDK 1.3+ and enable it by default.
+    </description></item>
+    <item><title> fix</title><link>changes.html</link><description> fix
+        by
+        JBQ
+        :
+        
+      CForms: Fix inplace editing samples
+    </description></item>
+    <item><title> add
+          (bug COCOON-1820)
+        </title><link>changes.html</link><description> add
+        by
+        CZ
+          (fixes bug COCOON-1820)
+        
+        :
+        
+      CForms: Add id, state and listening attributes to the transformed form-template element (jx macros
+              and forms transformer).
+    </description></item>
     <item><title> add</title><link>changes.html</link><description> add
         by
-        NN
+        AN
         :
-        DUMMY</description></item>
+        
+      XSP block: Use private methods to call start/endElement in xsp.xsl.
+      That generates smaller bytecode allowing to compiler larger XSPs before hitting the
+      64k limit for the size of the generate() method.
+    </description></item>
+    <item><title> add
+          (bug COCOON-1781 COCOON-1685)
+        </title><link>changes.html</link><description> add
+        by
+        SG
+          (fixes bug COCOON-1781 COCOON-1685)
+        
+        :
+        
+      Forms block: modified ProcessingPhase to add a PROCESSING_INITIALIZE phase instead of the spurious
+      double READ_FROM_REQUEST_VALUE sent before. Made a ProcessingPhaseListener configurable from
+      form definition with on-processing-phase and adapted the JavaScript widget listener to support
+      processing phase events.
+    </description></item>
+    <item><title> add
+          (bug COCOON-1801)
+        </title><link>changes.html</link><description> add
+        by
+        SG
+          (fixes bug COCOON-1801)
+        
+        :
+        
+      Forms block: added repeater events. Repeater now sends row added, deleted etc.. events.
+      The listener can be added in definition with an on-repeater-modified element. Added support
+      for these events in JavaScript listener.
+    </description></item>
+    <item><title> fix
+          (bug COCOON-1844)
+        </title><link>changes.html</link><description> fix
+        by
+        SG
+          (fixes bug COCOON-1844)
+        
+        :
+        
+      Passing the default locale while parsing initial-value on a form if no locale attribute was specified.
+    </description></item>
   
   
     <item><title> fix</title><link>changes.html</link><description> fix
@@ -8960,8 +9121,154 @@
 
   
 
-<item><title> add</title><link>changes.html</link><description> add
+<item><title> add
+          (bug COCOON-1782)
+        </title><link>changes.html</link><description> add
+        by
+        SG
+          (fixes bug COCOON-1782)
+        
+        :
+        
+      Added CSS classes in cocoon forms default XSLs.
+    </description></item><item><title> update</title><link>changes.html</link><description> update
         by
-        NN
+        AG
+        :
+        
+      Updated ehcache to 1.2.
+    </description></item><item><title> fix
+          (bug COCOON-1742)
+        </title><link>changes.html</link><description> fix
+        by
+        RG
+          (fixes bug COCOON-1742)
+        
+        :
+        
+      The JDK 1.4 version of the EncodeURLTransformer did not work properly as it was not matching just the
+      beginning of the string as the Jakarta-regexp version does. The transformer was corrected to only match
+      the beginning of the string.  In 2.1.9 this error can be circumvented by configuring the transformer and
+      adding "*" to the end of each pattern.
+    </description></item><item><title> add
+          (bug COCOON-1845)
+        </title><link>changes.html</link><description> add
+        by
+        AS
+          (fixes bug COCOON-1845)
+        
+        :
+        
+      As with all the AbstractTextSerializer based serializers, the XHTMLSerializer should handle the omit-xml-declaration to not put the XML declaration as first line of the serialized document.
+      This prevents many rendering problems in Internet Explorer. Default behaviour is to send the xml declaration as before.
+     Thanks to Maurizio Pillitu.</description></item><item><title> fix
+          (bug COCOON-1511)
+        </title><link>changes.html</link><description> fix
+        by
+        CZ
+          (fixes bug COCOON-1511)
+        
+        :
+        
+      Commandline interface: the user-agent is now correctly set in the request headers (and not in the request parameters).
+     Thanks to James Bates.</description></item><item><title> fix
+          (bug COCOON-1716)
+        </title><link>changes.html</link><description> fix
+        by
+        AG
+          (fixes bug COCOON-1716)
+        
         :
-        DUMMY</description></item></channel></rss>
\ No newline at end of file
+        
+      RandomNumberModule: does not returns random number in the range (min,max) as expected.
+    </description></item><item><title> fix
+          (bug COCOON-1721)
+        </title><link>changes.html</link><description> fix
+        by
+        AG
+          (fixes bug COCOON-1721)
+        
+        :
+        
+      Performance Issue/JavaScriptFlowScript: If &lt;reload-scripts&gt; is set to false,
+      don't check for last modification time of javascript source files.
+     Thanks to Georg H├╝ttenegger.</description></item><item><title> fix</title><link>changes.html</link><description> fix
+        by
+        AN
+        :
+        
+      XSP block: Fix regression introduced in 2.1.8 that under specific circumstances logicsheets
+      were not applied, leading to compilation errors.  This manifested itself only if
+      a) two XSPs referred to the same custom logicsheet by a relative location path,
+      b) the custom logicsheet used another logicsheet, and
+      c) the built-in logicsheet's namespace was not mentioned in xsp:page.
+      The compilation errors occurred always when calling the second XSP for the first time.
+      Fix also race condition which could lead to similar XSP compilation errors under high load
+      when accessing the same logicsheet for the first time.
+    </description></item><item><title> fix</title><link>changes.html</link><description> fix
+        by
+        CZ
+        :
+        
+      Template block: Make the template block usable with JDK 1.3+ and enable it by default.
+    </description></item><item><title> fix</title><link>changes.html</link><description> fix
+        by
+        JBQ
+        :
+        
+      CForms: Fix inplace editing samples
+    </description></item><item><title> add
+          (bug COCOON-1820)
+        </title><link>changes.html</link><description> add
+        by
+        CZ
+          (fixes bug COCOON-1820)
+        
+        :
+        
+      CForms: Add id, state and listening attributes to the transformed form-template element (jx macros
+              and forms transformer).
+    </description></item><item><title> add</title><link>changes.html</link><description> add
+        by
+        AN
+        :
+        
+      XSP block: Use private methods to call start/endElement in xsp.xsl.
+      That generates smaller bytecode allowing to compiler larger XSPs before hitting the
+      64k limit for the size of the generate() method.
+    </description></item><item><title> add
+          (bug COCOON-1781 COCOON-1685)
+        </title><link>changes.html</link><description> add
+        by
+        SG
+          (fixes bug COCOON-1781 COCOON-1685)
+        
+        :
+        
+      Forms block: modified ProcessingPhase to add a PROCESSING_INITIALIZE phase instead of the spurious
+      double READ_FROM_REQUEST_VALUE sent before. Made a ProcessingPhaseListener configurable from
+      form definition with on-processing-phase and adapted the JavaScript widget listener to support
+      processing phase events.
+    </description></item><item><title> add
+          (bug COCOON-1801)
+        </title><link>changes.html</link><description> add
+        by
+        SG
+          (fixes bug COCOON-1801)
+        
+        :
+        
+      Forms block: added repeater events. Repeater now sends row added, deleted etc.. events.
+      The listener can be added in definition with an on-repeater-modified element. Added support
+      for these events in JavaScript listener.
+    </description></item><item><title> fix
+          (bug COCOON-1844)
+        </title><link>changes.html</link><description> fix
+        by
+        SG
+          (fixes bug COCOON-1844)
+        
+        :
+        
+      Passing the default locale while parsing initial-value on a form if no locale attribute was specified.
+    </description></item></channel></rss>
\ No newline at end of file

Modified: cocoon/site/site/2.1/userdocs/publishing/xslt.html
URL: http://svn.apache.org/viewcvs/cocoon/site/site/2.1/userdocs/publishing/xslt.html?rev=405620&r1=405619&r2=405620&view=diff
==============================================================================
--- cocoon/site/site/2.1/userdocs/publishing/xslt.html (original)
+++ cocoon/site/site/2.1/userdocs/publishing/xslt.html Tue May  9 20:53:07 2006
@@ -1217,19 +1217,20 @@
 <h2 class="h3">Intro</h2>
 <div class="section">
 <p>This page contains information on the default XSLT's provided by CForms, and
-the fi:styling directives they support. Be sure to read first about the
-<a href="../../../2.1/userdocs/publishing/templating/../templating.html">templating mechanism</a>.</p>
-<p>There are basically 3 XSLTs:</p>
+the fi:styling directives they support.</p>
+<p>As specified in <a href="../../../2.1/userdocs/publishing/templating/../templating.html">templating mechanism</a> (be sure to read
+about it), the form template file is transformed in a form instance xml file.
+This file contains all the data needed to properly display a form. An XSLT must
+then be used to transform the form instance to an HTML to be displayed in a
+browser.</p>
+<p>This XSLT does not need to create also all the page layout (that can be added
+by other XSLT, or aggregating the form with other markup), it should only format
+the forms field and the form layout.</p>
+<p>Cocoon forms already a set of XSLTs that does exactly this, they are
+"library" stylesheets :</p>
 <ul>
 
 <li>
-<tt>forms-samples-styling.xsl</tt>: this stylesheet includes two
-stylesheets: one for widget styling, one for page styling. You can choose
-between the basic types of it or advanced stylings. Usually, you will make a
-clone of this stylesheet for your own project, and use the other stylesheets as
-is.</li>
-
-<li>
 <tt>forms-field-styling.xsl</tt>: contains templates that style individual
 widgets, i.e. templates that translate fi:field, fi:booleanfield fi:action, etc.
 to HTML.</li>
@@ -1238,10 +1239,6 @@
 <tt>forms-page-styling.xsl</tt>: contains templates for building high-level
 page layout effects, such as tabbed panes.</li>
 
-</ul>
-<p>Additionally there are 2 XSLTs for advanced widget styling:</p>
-<ul>
-
 <li>
 <tt>forms-advanced-field-styling.xsl</tt>: contains templates that provide
 advanced styling of fields, e.g. the "double-listbox" for a multivaluefield.
@@ -1254,43 +1251,236 @@
 calendar is an advanced styling too, but because it has much specific stuff we
 separated it out of <tt>forms-advanced-styling.xsl</tt>.</li>
 
+<li>
+<tt>forms-htmlarea-styling.xsl</tt>: contains the styling for the html edit
+field.</li>
+
 </ul>
-<p>From the sitemap you only need to reference the first one, for example as
-follows:</p>
-<pre>&lt;map:transform src="context://samples/forms/resources/forms-samples-styling.xsl"/&gt;</pre>
+<p>If you have a look at samples, you'll see also another XSLT,
+<tt>forms-samples-styling.xsl</tt>. This stylesheet includes other two
+stylesheets from the default set. Usually, you will make a clone of this
+stylesheet for your own project, have it include the library XSLTs, and
+customize what you need by writing templates in this XSLT by giving templates
+higher priority than those in the library ones.</p>
+<p>From the sitemap you only need to reference only your custom XSLT, for
+example as follows:</p>
+<pre>&lt;map:transform src="context://forms/resources/myproject-forms-styling.xsl"/&gt;</pre>
 </div>
-<a name="N1003C"></a><a name="fi%3Astyling+options"></a>
+<a name="N10041"></a><a name="fi%3Astyling+options"></a>
 <h2 class="h3">fi:styling options</h2>
 <div class="section">
+<p>The fi:styling elements are specified in the template, and offer a way to
+customize the way the library XSLTs render widgets. For example :</p>
+<pre>&lt;ft:widget id="preferredBeer"&gt;
+&nbsp; &lt;fi:styling list-type="radio"/&gt;
+&lt;/ft:widget&gt;
+</pre>
 <p>The fi:styling options for the different widgets are documented in the
 respective sections about those widgets.</p>
 </div>
-<a name="N10042"></a><a name="High-level+styling+with+fi%3Agroup"></a>
+<a name="N1004B"></a><a name="High-level+styling+with+fi%3Agroup"></a>
 <h2 class="h3">High-level styling with fi:group</h2>
 <div class="section">
-<p>No documentation yet, checkout the samples and the source of
-forms-page-styling.xsl.</p>
-<p>For storing the state of a tab or choice selection server-side just add a
-field to the form definition that shall hold this value:</p>
-<pre>&lt;fd:field id="state"&gt;
+<p>It's quite common to want to layout the form. For example, have part of the
+form displayed in a table with two columns, one with labels the other one with
+actual fields, while in another part have a single colum with labels followed by
+fields, and in another part some tabs to group together fields.</p>
+<p>We could do this simply writing HTML in the template file, but this is
+verbose, non reusable, and not easy to style. That's why fi:groups are there.
+You can layout your form with fi:groups in a simple, efficient, extensible and
+easy to style way. For example :</p>
+<pre>&lt;ft:form-template .... &gt;
+&nbsp; &lt;fi:group&gt;
+    &lt;fi:styling layout="columns"&gt;
+&nbsp;&nbsp;&nbsp; &lt;fi:items&gt;
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;ft:widget id="name"/&gt;
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;ft:widget id="surname"/&gt;
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;ft:widget id="birthday"/&gt;
+&nbsp;&nbsp;&nbsp; &lt;/fi:items&gt;
+&nbsp; &lt;/fi:group&gt;
+&lt;/ft:form-template&gt;
+</pre>
+<p>Will produce a table with two columns, like the following :</p>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+
+<tbody>
+
+<tr>
+
+<td>
+
+<p>Name</p>
+
+</td>
+<td>
+
+<p>[_______]</p>
+
+</td>
+
+</tr>
+
+<tr>
+
+<td>
+
+<p>Surname</p>
+
+</td>
+<td>
+
+<p>[_______]</p>
+
+</td>
+
+</tr>
+
+<tr>
+
+<td>
+
+<p>Birthday</p>
+
+</td>
+<td>
+
+<p>[_______]</p>
+
+</td>
+
+</tr>
+
+</tbody>
+
+</table>
+<p>The <tt>fi:group</tt> accept either a <tt>layout</tt> or a <tt>type</tt>
+attribute in its <tt>fi:styling</tt> element to specify the layout we want. This
+difference is because the "layout based" groups are quite lightweight, while the
+"type based" groups are more sophisticated and usually contains other groups.
+</p>
+<a name="N10097"></a><a name="Layout+groups"></a>
+<h3 class="h4">Layout groups</h3>
+<p>
+<tt>&lt;fi:group layout="column"&gt;</tt> will format its items in a single
+column. One row will contain the label, the following row the input field.</p>
+<p>
+<tt>&lt;fi:group layout="columns"&gt;</tt> will format its items in two
+columns. For each item a row is created, the first column will contain the
+label, and the second column the input field.</p>
+<p>
+<tt>&lt;fi:group layout="row"&gt;</tt> will format its items in a single row.
+One cell will contain the label, the following cell the input field.</p>
+<p>
+<tt>&lt;fi:group layout="rows"&gt;</tt> will format its items in two rows.
+The first row will contain all the labels, one each cell, the second row all the
+input fields, again one each cell.</p>
+<p>Some input fields will have a special layout when inside a certain group :
+</p>
+<ul>
+
+<li>
+<tt>action</tt>, <tt>submit</tt> and <tt>boolanfield</tt> widgets does not
+have a "label" which can be displayed separated from the button or checkbox
+itself, so they will be placed</li>
+
+<ul>
+
+<li>in a single line inside the <tt>column</tt> and <tt>columns</tt> layout</li>
+
+<li>using only one cell in <tt>row</tt> layout</li>
+
+<li>using an empty cell in the first row of a <tt>rows</tt> layout</li>
+
+</ul>
+
+
+<li>
+<tt>multivaluefield</tt> with a <tt><tt>list-type="double-listbox"</tt></tt>
+will be displayed with a row with a label and another row with the two lists
+when in a <tt>columns</tt> group.</li>
+
+<li>every other <tt>fi:group</tt> nested inside a <tt>fi:group</tt> with layout
+<tt>columns</tt> will span on both columns</li>
+
+</ul>
+<p>Also layout <tt>fi:group</tt> can contain other <tt>fi:group</tt> between
+their items, and can be used to create quite complex layouts.</p>
+<a name="N100F2"></a><a name="Type+groups"></a>
+<h3 class="h4">Type groups</h3>
+<p>There are currently two "type" groups : <tt>tabs</tt> and <tt>choice.</tt>
+
+</p>
+<p>The tabs group will display some tabs, every tab is (usually) a fi:group. For
+example :</p>
+<pre>&lt;fi:group&gt;
+&nbsp; &lt;fi:styling type="tabs"/&gt;
+&nbsp; &lt;fi:items&gt;
+&nbsp;&nbsp;&nbsp; &lt;fi:group&gt;
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;fi:label&gt;Personal info&lt;/fi:label&gt;
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;fi:styling layout="columns"/&gt;
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;fi:items&gt;
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;ft:widget id="name"/&gt;
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;ft:widget id="surname"/&gt;
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;/fi:items&gt;
+&nbsp;&nbsp;&nbsp; &lt;/fi:group&gt;
+&nbsp;&nbsp;&nbsp; &lt;fi:group&gt;
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;fi:label&gt;Iternet data&lt;/fi:label&gt;
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;fi:styling layout="columns"/&gt;
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;fi:items&gt;
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;ft:widget id="email"/&gt;
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;ft:widget id="icqaccount"/&gt;
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;/fi:items&gt;
+&nbsp;&nbsp;&nbsp; &lt;/fi:group&gt;
+&nbsp; &lt;/fi:items&gt;
+&lt;/fi:group&gt;</pre>
+<p>Will display two tabs, one called "Personal info" and the other one "Internet
+data". When the user clicks on "Personal info" the field name and surname will
+be displayed, while when the user clicks on "Internet data" the field email and
+icqaccount will be displayed.</p>
+<p>You can specify a widget that will be used to store and retrieve which tab is
+curently active. This way you can control from the flow which tab will be active
+when the form will be displayed, or check which tab was active when the user
+submitted the form. To specify this special field use :</p>
+<pre>&lt;fi:group&gt;
+&nbsp; &lt;fi:styling type="tabs"/&gt;
+&nbsp; &lt;fi:state&gt;
+&nbsp;&nbsp;&nbsp; &lt;ft:widget id="activetab"/&gt;
+&nbsp; &lt;/fi:state&gt;
+  ....
+&lt;/fi:group&gt;</pre>
+<p>Obviously you can call the widget whatever you want, and the suggested
+datatype is integer, since the field will contain a number indicating the active
+tab, the field must be declared in the definition, and can be used in binding if
+needed. For example :</p>
+<pre>&lt;fd:field id="activetab"&gt;
   &lt;fd:datatype base="integer"/&gt;
 &lt;/fd:field&gt;</pre>
-<p>Bind this value to whatever you want. In the form template you need then
-following code:</p>
+<p>The group of type <tt>choice </tt>is identical to the <tt>tabs</tt> group,
+but instead of a row of tabs, a drop down is displayed, and selecting one
+element of the drop down will display the relative group.</p>
+<p>You can specify a client side javascript that will be executed when a tab is
+clicked or when an option of the <tt>choice</tt> drop down is selected. This is
+done simply adding an attribute to the items of the group, for example :</p>
 <pre>&lt;fi:group&gt;
-  &lt;fi:styling type="choice"/&gt;
-  &lt;fi:state&gt;
-    &lt;ft:widget id="state"/&gt; &lt;!-- refering to the above defined field --&gt;
-  &lt;/fi:state&gt;
-  &lt;fi:items&gt;
-    ...
-  &lt;/fi:items&gt;
+&nbsp; &lt;fi:styling type="tabs"/&gt;
+&nbsp; &lt;fi:items&gt;
+&nbsp;&nbsp;&nbsp; &lt;fi:group formsOnShow="personalSelected()"&gt;
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;fi:label&gt;Personal info&lt;/fi:label&gt;
+      ...
+&nbsp;&nbsp;&nbsp; &lt;/fi:group&gt;
+&nbsp;&nbsp;&nbsp; &lt;fi:group formsOnShow="internetSelected()"&gt;
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &lt;fi:label&gt;Iternet data&lt;/fi:label&gt;
+      ...
+&nbsp;&nbsp;&nbsp; &lt;/fi:group&gt;
+&nbsp; &lt;/fi:items&gt;
 &lt;/fi:group&gt;</pre>
+<p>Have a look at <tt>forms-page-styling.xsl</tt> , all <tt>fi:groups</tt> are
+formatted there.</p>
 </div>
-<a name="N10050"></a><a name="Miscellaneous"></a>
+<a name="N10123"></a><a name="Miscellaneous"></a>
 <h2 class="h3">Miscellaneous</h2>
 <div class="section">
-<a name="N10054"></a><a name="fi%3Avalidation-errors"></a>
+<a name="N10127"></a><a name="fi%3Avalidation-errors"></a>
 <h3 class="h4">fi:validation-errors</h3>
 <p>The <tt>fi:validation-errors</tt> tag is used to display all validation
 errors of all widgets in a form at one location, i.e. a the top of the form.</p>

Modified: cocoon/site/site/2.1/userdocs/widgetconcepts/datatypes.html
URL: http://svn.apache.org/viewcvs/cocoon/site/site/2.1/userdocs/widgetconcepts/datatypes.html?rev=405620&r1=405619&r2=405620&view=diff
==============================================================================
--- cocoon/site/site/2.1/userdocs/widgetconcepts/datatypes.html (original)
+++ cocoon/site/site/2.1/userdocs/widgetconcepts/datatypes.html Tue May  9 20:53:07 2006
@@ -1416,10 +1416,30 @@
 
 </tr>
 
+<tr>
+
+<td>
+
+<p>char</p>
+
+</td>
+<td>
+
+<p>java.lang.Char</p>
+
+</td>
+<td>
+
+<p>only the default char convertor</p>
+
+</td>
+
+</tr>
+
 </tbody>
 
 </table>
-<a name="N100E4"></a><a name="Enumerated+datatype"></a>
+<a name="N100F9"></a><a name="Enumerated+datatype"></a>
 <h3 class="h4">Enumerated datatype</h3>
 <p>The <strong>enum</strong> datatype is meant to be used with types
 implementing Joshua Bloch's
@@ -1456,10 +1476,10 @@
 <p>The enum datatype is typically used together with the <strong>enum</strong>
 selection list type.</p>
 </div>
-<a name="N10112"></a><a name="Available+convertors"></a>
+<a name="N10127"></a><a name="Available+convertors"></a>
 <h2 class="h3">Available convertors</h2>
 <div class="section">
-<a name="N10116"></a><a name="formatting+%28decimal%29"></a>
+<a name="N1012B"></a><a name="formatting+%28decimal%29"></a>
 <h3 class="h4">formatting (decimal)</h3>
 <p>This convertor uses the <tt>java.text.DecimalFormat</tt> class (or
 <tt>com.ibm.icu.text.DecimalFormat</tt> class if it is present in the
@@ -1479,15 +1499,15 @@
 <a class="external" href="http://java.sun.com/j2se/1.4.2/docs/api/java/text/DecimalFormat.html">javadoc
 of the DecimalFormat class</a> for the supported pattern syntax. CForms will
 always use the pattern that is most specific for the current locale.</p>
-<a name="N1012E"></a><a name="plain"></a>
+<a name="N10143"></a><a name="plain"></a>
 <h3 class="h4">plain</h3>
 <p>This convertor is not locale-dependent. It shows the full precision of the
 number and uses dot as the decimal separator.</p>
-<a name="N10134"></a><a name="date+convertors"></a>
+<a name="N10149"></a><a name="date+convertors"></a>
 <h3 class="h4">date convertors</h3>
 <p>The date datatype can be used both for dates as times. The date datatype
 supports the following convertors:</p>
-<a name="N1013A"></a><a name="formatting+%28date%29"></a>
+<a name="N1014F"></a><a name="formatting+%28date%29"></a>
 <h4>formatting (date)</h4>
 <p>This convertor uses the <tt>java.text.SimpleDateFormat</tt> class (or
 <tt>com.ibm.icu.text.SimpleDateFormat</tt> class if it is present in the
@@ -1532,7 +1552,7 @@
 default is lenient, which means that the convertor will try to convert a
 somewhat invalid date like "Dec. 32, 2005" into "Jan. 1, 2006". If the value of
 the "lenient" attribute is false, such a date won't validate.</p>
-<a name="N10160"></a><a name="millis"></a>
+<a name="N10175"></a><a name="millis"></a>
 <h4>millis</h4>
 <p>The millis convertor for dates uses the number of milliseconds since January
 1, 1970, 00:00:00 GMT as string representation. This will likely not be used to

Modified: cocoon/site/site/2.1/userdocs/widgetconcepts/eventhandling.html
URL: http://svn.apache.org/viewcvs/cocoon/site/site/2.1/userdocs/widgetconcepts/eventhandling.html?rev=405620&r1=405619&r2=405620&view=diff
==============================================================================
--- cocoon/site/site/2.1/userdocs/widgetconcepts/eventhandling.html (original)
+++ cocoon/site/site/2.1/userdocs/widgetconcepts/eventhandling.html Tue May  9 20:53:07 2006
@@ -1219,7 +1219,8 @@
 <p>Some types of widgets can emit events. For example, the action widget
 produces ActionEvents and the field widget produces ValueChangedEvents. Next to
 these events, there are also ProcessingPhaseEvents, fired in between the various
-phases of the processing of a request.</p>
+phases of the processing of a request, and RepeaterEvents fired by a repeater
+when rows are added, removed or cleared.</p>
 <p>Handling events can be done in three ways:</p>
 <ul>
 
@@ -1373,7 +1374,11 @@
 org.apache.cocoon.forms.event.ActionEvent
 
 org.apache.cocoon.forms.event.ProcessingPhaseListener
-org.apache.cocoon.forms.event.ProcessingPhaseEvent</pre>
+org.apache.cocoon.forms.event.ProcessingPhaseEvent
+
+org.apache.cocoon.forms.event.RepeaterListener
+org.apache.cocoon.forms.event.RepeaterEvent
+</pre>
 <p>The table below gives an overview of what events are supported on what
 widgets.</p>
 <table class="ForrestTable" cellspacing="1" cellpadding="4">
@@ -1397,6 +1402,11 @@
 <p>Supports ActionEvents</p>
 
 </th>
+<th>
+
+<p>Supports RepeaterEvents</p>
+
+</th>
 
 </tr>
 
@@ -1409,6 +1419,7 @@
 </td>
 <td><img alt="" src="375.daisy.img"></td>
 <td></td>
+<td></td>
 
 </tr>
 
@@ -1426,6 +1437,7 @@
 
 </td>
 <td></td>
+<td></td>
 
 </tr>
 
@@ -1438,6 +1450,7 @@
 </td>
 <td><img alt="" src="375.daisy.img"></td>
 <td></td>
+<td></td>
 
 </tr>
 
@@ -1450,6 +1463,7 @@
 </td>
 <td></td>
 <td></td>
+<td></td>
 
 </tr>
 
@@ -1462,6 +1476,7 @@
 </td>
 <td></td>
 <td></td>
+<td></td>
 
 </tr>
 
@@ -1474,6 +1489,7 @@
 </td>
 <td></td>
 <td><img alt="" src="375.daisy.img"></td>
+<td></td>
 
 </tr>
 
@@ -1486,6 +1502,7 @@
 </td>
 <td></td>
 <td><img alt="" src="375.daisy.img"></td>
+<td></td>
 
 </tr>
 
@@ -1498,6 +1515,7 @@
 </td>
 <td></td>
 <td><img alt="" src="375.daisy.img"></td>
+<td></td>
 
 </tr>
 
@@ -1510,6 +1528,7 @@
 </td>
 <td></td>
 <td><img alt="" src="375.daisy.img"></td>
+<td></td>
 
 </tr>
 
@@ -1526,6 +1545,7 @@
 
 </td>
 <td></td>
+<td></td>
 
 </tr>
 
@@ -1538,6 +1558,7 @@
 </td>
 <td></td>
 <td></td>
+<td></td>
 
 </tr>
 
@@ -1550,6 +1571,20 @@
 </td>
 <td></td>
 <td></td>
+<td></td>
+
+</tr>
+
+<tr>
+
+<td>
+
+<p>repeater</p>
+
+</td>
+<td></td>
+<td></td>
+<td><img alt="" src="375.daisy.img"></td>
 
 </tr>
 

Modified: cocoon/site/site/2.1/userdocs/widgetconcepts/selectionlists.html
URL: http://svn.apache.org/viewcvs/cocoon/site/site/2.1/userdocs/widgetconcepts/selectionlists.html?rev=405620&r1=405619&r2=405620&view=diff
==============================================================================
--- cocoon/site/site/2.1/userdocs/widgetconcepts/selectionlists.html (original)
+++ cocoon/site/site/2.1/userdocs/widgetconcepts/selectionlists.html Tue May  9 20:53:07 2006
@@ -1325,8 +1325,17 @@
 &lt;/fi:selection-list&gt;</pre>
 <p>If you don't want an initial null value, add a
 <strong>nullable="false"</strong> attribute to the
-<strong>fd:selection-list</strong> element. This applies only to
+<strong>fd:selection-list</strong> element. You can specify an i18n key to use
+as a label for the null element using the
+<strong>null-text="i18.key.here"</strong> attribute. This applies only to
 <strong>enum</strong> type selection lists.</p>
+<p>Note : since the enum pattern is based on Class.getDeclaredFields() method,
+it's not always granted that the enum selection list items will be in the same
+order the fields are declared in the enumeration class. This is reported to
+happen expecially on IBM JRE. A good solution to this problem is to use the
+apache commons Enum as a super class of your enumeration classes. Due to the way
+this enumeration pattern is implemented, it's possible to grant the element
+orders in a portable way.</p>
 <div class="daisy-edit-link">
 <p>
 <em>Errors and Improvements?</em>

Modified: cocoon/site/site/2.1/userdocs/widgets/widget_repeater.html
URL: http://svn.apache.org/viewcvs/cocoon/site/site/2.1/userdocs/widgets/widget_repeater.html?rev=405620&r1=405619&r2=405620&view=diff
==============================================================================
--- cocoon/site/site/2.1/userdocs/widgets/widget_repeater.html (original)
+++ cocoon/site/site/2.1/userdocs/widgets/widget_repeater.html Tue May  9 20:53:07 2006
@@ -1237,6 +1237,9 @@
   &lt;fd:on-create&gt;
     [...]
   &lt;/fd:on-create&gt;
+  &lt;fd:on-repeater-modified&gt;
+    [...]
+  &lt;/fd:on-repeater-modified&gt;
   &lt;fd:attributes&gt;
     &lt;fd:attribute name="..." value="..."/&gt;
   &lt;/fd:attributes&gt;
@@ -1250,13 +1253,22 @@
 <p>The optional <strong>min-size</strong> and <strong>max-size
 </strong>attributes control the size of the repeater. A validation error is set
 on the repeater when these boundaries are violated.</p>
+<p>The <strong>fd:on-repeater-modified</strong> element is used to specify a
+repeater listener. This listener will be notified of rows additions, removal and
+reordering. The RepeaterEvent instance (accessible with the event variable in a
+javascript listener) allows to know which action (see class RepeaterEventAction)
+is happening on which row. When&nbsp; a row is being deleted or the entire repeater
+is being cleared, two events are thrown : the <tt>ROW_DELETING</tt> or
+<tt>ROWS_CLEARING</tt> before the action actually takes place, and the
+<tt><tt>ROW_DELETED</tt></tt> or <tt>ROWS_CLEARED</tt> after the row has
+actually been deleted or the repeater has actually been cleared.</p>
 <p>For a description of the other elements, see the <a href="../../../2.1/userdocs/widgets/widget_field.html">field
 widget</a>.</p>
 </div>
-<a name="N1003D"></a><a name="Template"></a>
+<a name="N1004F"></a><a name="Template"></a>
 <h2 class="h3">Template</h2>
 <div class="section">
-<a name="N10041"></a><a name="Before+Cocoon+2.1.8"></a>
+<a name="N10053"></a><a name="Before+Cocoon+2.1.8"></a>
 <h3 class="h4">Before Cocoon 2.1.8</h3>
 <p>The following elements are available for formatting a repeater in a template:
 </p>
@@ -1295,7 +1307,7 @@
   &lt;/tbody&gt;
 &lt;/table&gt;
 </pre>
-<a name="N1005F"></a><a name="From+Cocoon+2.1.8"></a>
+<a name="N10071"></a><a name="From+Cocoon+2.1.8"></a>
 <h3 class="h4">From Cocoon 2.1.8</h3>
 <p>Cocoon 2.1.8 introduced a slightly extended manner to format repeaters, which
 is required when using the new <a href="../../../2.1/userdocs/ajax.html">Ajax</a> features. Instead of
@@ -1329,7 +1341,7 @@
   &lt;/table&gt;
 &lt;/ft:repeater&gt;
 </pre>
-<a name="N10079"></a><a name="Tips"></a>
+<a name="N1008B"></a><a name="Tips"></a>
 <h3 class="h4">Tips</h3>
 <p>When using JXTemplate, it is possible to test if a repeater is empty and show
 something else in that case. For example:</p>

Modified: cocoon/site/site/2.1/userdocs/widgets/widget_tree.html
URL: http://svn.apache.org/viewcvs/cocoon/site/site/2.1/userdocs/widgets/widget_tree.html?rev=405620&r1=405619&r2=405620&view=diff
==============================================================================
--- cocoon/site/site/2.1/userdocs/widgets/widget_tree.html (original)
+++ cocoon/site/site/2.1/userdocs/widgets/widget_tree.html Tue May  9 20:53:07 2006
@@ -1215,10 +1215,203 @@
     +-->
 <div id="content">
 <h1>Tree widget</h1>
-<a name="N10019"></a>
-<h2 class="h3"></h2>
+<a name="N10019"></a><a name="Concept"></a>
+<h2 class="h3">Concept</h2>
 <div class="section">
-<p>TODO</p>
+<p>The tree widget is for displaying trees of "things". The tree widget supports
+expanding and collapsing of nodes, single or multiple selections, and a flexible
+TreeModel interface to provide its data.</p>
+</div>
+<a name="N1001F"></a><a name="Definition"></a>
+<h2 class="h3">Definition</h2>
+<div class="section">
+<pre>&lt;fd:tree id="..." state="..." root-visible="true" selection="multiple|single"&gt;
+  &lt;fd:tree-model type="..."/&gt;
+  &lt;fd:on-selection-changed&gt;
+   ...
+  &lt;/fd:on-selection-changed&gt;
+  &lt;fd:on-create&gt;
+    ...
+  &lt;/fd:on-create&gt;
+  &lt;fd:validation&gt;
+    ...
+  &lt;/fd:validation&gt;
+  &lt;fd:attributes&gt;
+    ...
+  &lt;/fd:attributes&gt;
+&lt;/fd:tree&gt;
+</pre>
+<p>All elements and attributes, except for id, are optional.</p>
+<p>See the <a href="../../../2.1/userdocs/widgets/widget_field.html">field widget</a> for information on common
+attributes and elements.</p>
+</div>
+<a name="N1002D"></a><a name="The+tree+model"></a>
+<h2 class="h3">The tree model</h2>
+<div class="section">
+<p>See the interface
+<a class="external" href="javadoc:org.apache.cocoon.forms.formmodel.tree.TreeModel">TreeModel</a>.
+Essentially, can be a tree of any sort of objects (there is no interface for the
+nodes in the tree). Each parent node should be able to identify its children
+uniquely by means of a key (some string).</p>
+<p>CForms ships with two implementations of TreeModel: one generic
+implementation (DefaultTreeModel), and one for browsing over Cocoon/Avalon
+sources (= filesystem-like structures).</p>
+<p>You can set the form model in the form definition, or set it at runtime using
+the setModel method on the tree widget.</p>
+<a name="N1003B"></a><a name="Source+tree+model"></a>
+<h3 class="h4">Source tree model</h3>
+<p>Syntax:</p>
+<pre>&lt;fd:tree-model type="source" src="..."&gt;
+  &lt;fd:fileset&gt;
+    &lt;fd:include pattern="..."/&gt;
+    &lt;fd:exclude pattern="..."/&gt;
+  &lt;/fd:fileset&gt;
+  &lt;fd:dirset&gt;
+    &lt;fd:include pattern="..."/&gt;
+    &lt;fd:exclude pattern="..."/&gt;
+  &lt;/fd:dirset&gt;
+&lt;/fd:tree-model&gt;
+</pre>
+<p>The <tt>src</tt> attribute defines the root of the content to be browsed. For
+example, to browse the content of the webapp directory, specify
+<tt>src="context://"</tt>. Of course, you can also use "file://" or other
+traversable sources [todo: link to some page with info about sources].</p>
+<p>The <tt>fd:fileset</tt> and <tt>fd:dirset</tt> elements are optional. The
+fileset patterns are used to filter files based on their name, and the dirset
+patterns are used to filter directories based on their names.</p>
+<p>There can be multiple (or none at all) <tt>fd:include</tt> and
+<tt>fd:exclude</tt> elements inside <tt>fd:fileset</tt> or <tt>fd:dirset</tt>.
+The include patterns will be evaluated first, the exclude patterns next, so the
+exclude patterns have higher precendence.</p>
+<p>The patterns are wildcard patterns. They are the same as for the wildcard
+matcher in the sitemap, thus simply use a * as wildcard (the ** syntax makes no
+sense here, as the pattern is evaluated on individual names, not on full paths).
+</p>
+<a name="N10063"></a><a name="Custom+models"></a>
+<h3 class="h4">Custom models</h3>
+<p>Syntax:</p>
+<pre>&lt;fd:tree-model type="java" class="..."/&gt;
+</pre>
+<p>whereby the class attribute specifies a class implementing
+<a class="external" href="javadoc:org.apache.cocoon.forms.formmodel.tree.TreeModel">TreeModel</a>.
+The class can implement Avalon interfaces to get the Logger, ServiceManager and
+Context.</p>
+<a name="N10071"></a><a name="Programmatically+assigning+a+model"></a>
+<h3 class="h4">Programmatically assigning a model</h3>
+<p>Here's an example of how to build a tree model programatically using the
+provided DefaultTreeModel in flowscript:</p>
+<pre>importClass(Packages.org.apache.cocoon.forms.formmodel.tree.DefaultTreeModel);
+
+[...]
+
+var node1 = new DefaultTreeModel.DefaultTreeNode("node 1")
+var node2 = new DefaultTreeModel.DefaultTreeNode("node 2")
+var root = new DefaultTreeModel.DefaultTreeNode("root")
+root.add("node1", node1);
+node1.add("node2", node2);
+var treeModel = new DefaultTreeModel(root);
+
+var treeWidget = form.getChild("mytree");
+treeWidget.setModel(treeModel);
+</pre>
+</div>
+<a name="N10079"></a><a name="Template"></a>
+<h2 class="h3">Template</h2>
+<div class="section">
+<p>For the display of a tree widget, three special template elements are
+available:</p>
+<ul>
+
+<li>
+<tt>ft:tree</tt>: global element to insert a tree widget in the template.
+This also inserts two hidden fields, ":path" and ":action" to communicate a node
+action to the server, see below.</li>
+
+<li>
+<tt>ft:tree-nodes</tt>: the template to be executed for each tree node.</li>
+
+<li>
+<tt>ft:tree-children</tt>: used inside ft:tree-nodes to recursively apply
+the ft:tree-nodes template to the child nodes.</li>
+
+</ul>
+<p>A very rough example is:</p>
+<pre>&lt;ft:tree id="mytree"&gt;
+  &lt;div&gt;
+    &lt;ft:tree-nodes&gt;
+      &lt;div&gt;
+        ${treeNode.node.data}
+      &lt;/div&gt;
+      &lt;ft:tree-children/&gt;
+    &lt;/ft:tree-nodes&gt;
+  &lt;/div&gt;
+&lt;/ft:tree&gt;
+</pre>
+<p>This example just shows the typical structural rendering, but doesn't contain
+any styling and javascript actions to trigger expansion and collapsion of nodes.
+</p>
+<p>Inside ft:tree you have access to two variables:</p>
+<ul>
+
+<li>
+<tt>treeWidget</tt>, just a synonym for the normal "widget" variable that is
+available in the template of each widget.</li>
+
+<li>
+<tt>treeNode</tt>, provides access to the current tree node being rendered.
+More specifically it is a
+<a class="external" href="javadoc:org.apache.cocoon.forms.formmodel.tree.TreeWalker">TreeWalker</a>
+instance. Its <tt>node</tt> property gives access to the actual tree node.</li>
+
+</ul>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">The <tt>${treeNode.node.data}</tt> expression in the template
+example above is specific to the form model you are using, since the node can be
+any object. The data property exists in the DefaultTreeModel nodes, however in
+the source tree model the nodes are Source objects, so you would use name
+instead of data.</div>
+</div>
+</div>
+<a name="N100B6"></a><a name="Tree+node+actions"></a>
+<h2 class="h3">Tree node actions</h2>
+<div class="section">
+<p>An action can be executed on a certain node in the tree. The available
+actions are:</p>
+<ul>
+
+<li>expand</li>
+
+<li>collapse</li>
+
+<li>toggle-collapse</li>
+
+<li>select</li>
+
+<li>unselect</li>
+
+<li>toggle-select</li>
+
+</ul>
+<p>To execute an action, set the hidden field named tree-widget-full-name +
+":action" to one of the actions listed above. The node on which the action is
+applied is specified in the hidden field named tree-widget-full-name + ":path".
+The node is specified as a slash-separated path of node keys. In the template
+you can access this easily with <tt>treeNode.path</tt>.</p>
+</div>
+<a name="N100D5"></a><a name="A+more+functional+template"></a>
+<h2 class="h3">A more functional template</h2>
+<div class="section">
+<p>For a complete example of a tree template, see e.g. the
+file_explorer_template.xml file in the CForms samples. From there, you can
+"steal" the styling and the javascript to perform tree node actions.</p>
+</div>
+<a name="N100DB"></a><a name="API+notes"></a>
+<h2 class="h3">API notes</h2>
+<div class="section">
+<p>See the <a class="external" href="javadoc:org.apache.cocoon.forms.formmodel.tree.Tree">API
+docs of the tree widgets</a> for more information on how to access e.g. the
+selected nodes.</p>
 <div class="daisy-edit-link">
 <p>
 <em>Errors and Improvements?</em>



Mime
View raw message