<?xml version="1.0"?>
<!--
  Licensed to the Apache Software Foundation (ASF) under one or more
  contributor license agreements.  See the NOTICE file distributed with
  this work for additional information regarding copyright ownership.
  The ASF licenses this file to You under the Apache License, Version 2.0
  (the "License"); you may not use this file except in compliance with
  the License.  You may obtain a copy of the License at

      http://www.apache.org/licenses/LICENSE-2.0

  Unless required by applicable law or agreed to in writing, software
  distributed under the License is distributed on an "AS IS" BASIS,
  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  See the License for the specific language governing permissions and
  limitations under the License.
-->

<!-- CVS: $Id: samples.xml 433543 2006-08-22 06:22:54Z crossley $ -->

<samples xmlns:xlink="http://www.w3.org/1999/xlink" name="simple form handling">

  <group name="Simple Form Handling">
     <note>
       Apache Cocoon contains several approaches to forms. The one demonstrated
       here is probably the simplest but also the weakest. Please also consider
       Cocoon Forms in the Forms block.
     </note>
     <note>
       This samples group demonstrates the use for the simple form handling
       in Apache Cocoon. Simple form handling consists of four parts:
       validating user input, filling forms with submitted data, displaying 
       validation results, and filling forms with default values. This
       corresponds largely to the involved Cocoon components: a validating
       action, an XSP logicsheet helping to display validation results, a
       transformer to fill in submitted data and display validation results,
       and a transformer to extract default values.
     </note>
     <sample name="Logicsheet" href="one/index">
       On an XSP page two logicsheets are used to redisplay submitted data
       and indicate validation results.
     </sample>
     <sample name="One Transformer" href="two/index">
       On a static XML page a form is displayed, submitted data is filled in,
       and validation results are displayed by the use of the
       SimpleFormTransformer.
     </sample>
     <sample name="Default Values" href="three/index">
       On a static XML page, form elements are separated from the default
       values. The SimpleFormInstanceTransformer is used to extract the data
       and the SimpleFormTransformer is used to pre-fill the form. No
       validation is performed.
     </sample>
     <sample name="Transformer Sample" href="four/index">
       This sample combines the two samples above into one.
     </sample>
  </group>
  
</samples>
