You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tapestry.apache.org by jk...@apache.org on 2006/10/13 02:28:44 UTC

svn commit: r463527 [2/3] - in /tapestry/tapestry4/trunk/src/site: ./ xdoc/components/ xdoc/components/form/ xdoc/components/general/ xdoc/components/link/

Copied: tapestry/tapestry4/trunk/src/site/xdoc/components/form/Radio.xml (from r454604, tapestry/tapestry4/trunk/src/site/xdoc/components/Radio.xml)
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/xdoc/components/form/Radio.xml?view=diff&rev=463527&p1=tapestry/tapestry4/trunk/src/site/xdoc/components/Radio.xml&r1=454604&p2=tapestry/tapestry4/trunk/src/site/xdoc/components/form/Radio.xml&r2=463527
==============================================================================
--- tapestry/tapestry4/trunk/src/site/xdoc/components/Radio.xml (original)
+++ tapestry/tapestry4/trunk/src/site/xdoc/components/form/Radio.xml Thu Oct 12 17:28:41 2006
@@ -23,7 +23,7 @@
         <section name="Radio">
 
             <p>
-                Provides a HTML &lt;input type="radio"&gt; form element. The Radio component must be
+                Provides a HTML <code>&lt;input type="radio"&gt;</code> form element. The Radio component must be
                 wrapped (possibly indirectly) inside a
                 <a href="RadioGroup.html">RadioGroup</a>
                 component.
@@ -39,7 +39,7 @@
             <p>
                 <strong>
                     See also:
-                    <a href="../tapestry-framework/apidocs/org/apache/tapestry/form/Radio.html">
+                    <a href="../../tapestry-framework/apidocs/org/apache/tapestry/form/Radio.html">
                         org.apache.tapestry.form.Radio
                     </a>
                     ,
@@ -63,8 +63,6 @@
                     <tr>
                         <th>Name</th>
                         <th>Type</th>
-                        <th>Direction</th>
-
                         <th>Required</th>
                         <th>Default</th>
                         <th>Description</th>
@@ -72,10 +70,8 @@
                     <tr>
                         <td>value</td>
                         <td>Object</td>
-
-                        <td>in</td>
                         <td>no</td>
-                        <td />
+                        <td></td>
                         <td>
                             The value is used to determine if the radio button is initially selected
                             (when rendering) and is the value assigned to the selected parameter
@@ -86,12 +82,11 @@
 
                         <td>disabled</td>
                         <td>boolean</td>
-                        <td>in</td>
                         <td>no</td>
                         <td>false</td>
                         <td>
 
-                            If true, then the Radio is disabled. It will write a "disabled"
+                            If true, then the Radio is disabled. It will write a <code>disabled</code>
                             attribute into its tag when rendering, and will not update its selected
                             binding. A Radio may also be disabled if its containing RadioGroup is
                             disabled.

Copied: tapestry/tapestry4/trunk/src/site/xdoc/components/form/RadioGroup.xml (from r454604, tapestry/tapestry4/trunk/src/site/xdoc/components/RadioGroup.xml)
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/xdoc/components/form/RadioGroup.xml?view=diff&rev=463527&p1=tapestry/tapestry4/trunk/src/site/xdoc/components/RadioGroup.xml&r1=454604&p2=tapestry/tapestry4/trunk/src/site/xdoc/components/form/RadioGroup.xml&r2=463527
==============================================================================
--- tapestry/tapestry4/trunk/src/site/xdoc/components/RadioGroup.xml (original)
+++ tapestry/tapestry4/trunk/src/site/xdoc/components/form/RadioGroup.xml Thu Oct 12 17:28:41 2006
@@ -46,7 +46,7 @@
             <p>
                 <strong>
                     See also:
-                    <a href="../tapestry-framework/apidocs/org/apache/tapestry/form/RadioGroup.html">
+                    <a href="../../tapestry-framework/apidocs/org/apache/tapestry/form/RadioGroup.html">
                         org.apache.tapestry.form.RadioGroup
                     </a>
                     ,
@@ -68,8 +68,6 @@
                     <tr>
                         <th>Name</th>
                         <th>Type</th>
-                        <th>Direction</th>
-
                         <th>Required</th>
                         <th>Default</th>
                         <th>Description</th>
@@ -77,8 +75,6 @@
                     <tr>
                         <td>selected</td>
                         <td>Object</td>
-
-                        <td>in-out</td>
                         <td>yes</td>
                         <td />
                         <td>
@@ -88,10 +84,8 @@
                         </td>
                     </tr>
                     <tr>
-
                         <td>disabled</td>
                         <td>boolean</td>
-                        <td>in</td>
                         <td>no</td>
                         <td>false</td>
                         <td>
@@ -102,10 +96,8 @@
                     <tr>
                         <td>displayName</td>
                         <td>string</td>
-                        <td>in</td>
                         <td>no</td>
-
-                        <td />
+                        <td></td>
                         <td>
                             The user-presentable name for the component, which will be used by a
                             <a href="FieldLabel.html">FieldLabel</a>
@@ -117,22 +109,33 @@
                         <td>
                             Array or collection of
                             <a
-                                href="../tapestry-framework/apidocs/org/apache/tapestry/form/validator/Validator.html">
+                                href="../../tapestry-framework/apidocs/org/apache/tapestry/form/validator/Validator.html">
                                 Validator
                             </a>
-                            , or
+                        </td>
+                        <td>no</td>
+                        <td></td>
+                        <td>
+                            The validators to apply to the component. Something along the lines of:
+                            <code>validators:required</code> .<br/><br/>
+                            
+                            <strong>See also:</strong> <a href="../../UsersGuide/validation.html">Validation</a>
+                        </td>
+                    </tr>
+                    <tr>
+                        <td>translator</td>
+                        <td>
                             <a
-                                href="../tapestry-framework/apidocs/org/apache/tapestry/form/validator/Validator.html">
-                                Validator
+                                href="../../tapestry/apidocs/org/apache/tapestry/form/translator/Translator.html">
+                                Translator
                             </a>
                         </td>
-
-                        <td>in</td>
                         <td>no</td>
-                        <td />
+                        <td></td>
                         <td>
-                            The validators to apply to the component. In many cases, a "validators:"
-                            binding prefix should be used.
+                            The translator to use when displaying and parsing the date.
+                            <br/><br/>
+                            <strong>See also:</strong> <a href="../../UsersGuide/validation.html">Validation</a>
                         </td>
                     </tr>
                 </table>

Copied: tapestry/tapestry4/trunk/src/site/xdoc/components/form/Select.xml (from r454604, tapestry/tapestry4/trunk/src/site/xdoc/components/Select.xml)
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/xdoc/components/form/Select.xml?view=diff&rev=463527&p1=tapestry/tapestry4/trunk/src/site/xdoc/components/Select.xml&r1=454604&p2=tapestry/tapestry4/trunk/src/site/xdoc/components/form/Select.xml&r2=463527
==============================================================================
--- tapestry/tapestry4/trunk/src/site/xdoc/components/Select.xml (original)
+++ tapestry/tapestry4/trunk/src/site/xdoc/components/form/Select.xml Thu Oct 12 17:28:41 2006
@@ -23,9 +23,9 @@
         <section name="Select">
 
             <p>
-                Implements a component that manages an HTML &lt;select&gt; form element. The Select
-                component can take the form of a drop down list (default) or a list selection box if
-                the "multiple" parameter is set to true. The Select component must wrap around
+                Implements a component that manages an HTML <code>&lt;select&gt;</code> form element. 
+                The Select component can take the form of a drop down list (default) or a list selection 
+                box if the "multiple" parameter is set to true. The Select component must wrap around
                 <a href="Option.html">Option</a>
                 components within a
                 <a href="Form.html">Form</a>
@@ -40,7 +40,7 @@
             <p>
                 <strong>
                     See also:
-                    <a href="../tapestry-framework/apidocs/org/apache/tapestry/form/Select.html">
+                    <a href="../../tapestry-framework/apidocs/org/apache/tapestry/form/Select.html">
                         org.apache.tapestry.form.Select
                     </a>
                     ,
@@ -64,8 +64,6 @@
                     <tr>
                         <th>Name</th>
                         <th>Type</th>
-                        <th>Direction</th>
-
                         <th>Required</th>
                         <th>Default</th>
                         <th>Description</th>
@@ -73,8 +71,6 @@
                     <tr>
                         <td>multiple</td>
                         <td>boolean</td>
-
-                        <td>in</td>
                         <td>no</td>
                         <td>false</td>
                         <td>If true, the component allows multiple selection.</td>
@@ -83,7 +79,6 @@
 
                         <td>disabled</td>
                         <td>boolean</td>
-                        <td>in</td>
                         <td>no</td>
                         <td>false</td>
                         <td>
@@ -95,10 +90,8 @@
                     <tr>
                         <td>displayName</td>
                         <td>String</td>
-                        <td>in</td>
                         <td>no</td>
-
-                        <td />
+                        <td></td>
                         <td>
                             The user-presentable name for the component, which will be used by a
                             <a href="FieldLabel.html">FieldLabel</a>
@@ -110,33 +103,41 @@
                         <td>
                             Array or collection of
                             <a
-                                href="../tapestry-framework/apidocs/org/apache/tapestry/form/validator/Validator.html">
+                                href="../../tapestry-framework/apidocs/org/apache/tapestry/form/validator/Validator.html">
                                 Validator
                             </a>
-                            , or
+                        </td>
+                        <td>no</td>
+                        <td></td>
+                        <td>
+                            The validators to apply to the component. Something along the lines of:
+                            <code>validators:required</code> .<br/><br/>
+                            
+                            <strong>See also:</strong> <a href="../../UsersGuide/validation.html">Validation</a>
+                        </td>
+                    </tr>
+                    <tr>
+                        <td>translator</td>
+                        <td>
                             <a
-                                href="../tapestry-framework/apidocs/org/apache/tapestry/form/validator/Validator.html">
-                                Validator
+                                href="../../tapestry/apidocs/org/apache/tapestry/form/translator/Translator.html">
+                                Translator
                             </a>
                         </td>
-
-                        <td>in</td>
                         <td>no</td>
-                        <td />
+                        <td></td>
                         <td>
-                            The validators to apply to the component. In many cases, a "validators"
-                            binding can help.
+                            The translator to use when displaying and parsing the date.
+                            <br/><br/>
+                            <strong>See also:</strong> <a href="../../UsersGuide/validation.html">Validation</a>
                         </td>
                     </tr>
                     <tr>
-
                         <td>id</td>
                         <td>String</td>
-                        <td>in</td>
                         <td>no</td>
                         <td />
-                        <td>Sets the id attribute for the rendered &lt;select&gt; element.</td>
-
+                        <td>Sets the id attribute for the rendered <code>&lt;select&gt;</code> element.</td>
                     </tr>
                 </table>
 

Copied: tapestry/tapestry4/trunk/src/site/xdoc/components/form/Submit.xml (from r454604, tapestry/tapestry4/trunk/src/site/xdoc/components/Submit.xml)
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/xdoc/components/form/Submit.xml?view=diff&rev=463527&p1=tapestry/tapestry4/trunk/src/site/xdoc/components/Submit.xml&r1=454604&p2=tapestry/tapestry4/trunk/src/site/xdoc/components/form/Submit.xml&r2=463527
==============================================================================
--- tapestry/tapestry4/trunk/src/site/xdoc/components/Submit.xml (original)
+++ tapestry/tapestry4/trunk/src/site/xdoc/components/form/Submit.xml Thu Oct 12 17:28:41 2006
@@ -23,8 +23,8 @@
         <section name="Submit">
 
             <p>
-                Provides an HTML form submission element, &lt;input type="submit"&gt;. The Submit
-                component must be enclosed by a
+                Provides an HTML form submission element, <code>&lt;input type="submit"&gt;</code>. 
+                The Submit component must be enclosed by a
                 <a href="Form.html">Form</a>
                 component. A Submit component is used when a single form has multiple form
                 submission buttons, and the application needs to know which one is the trigger for
@@ -51,11 +51,10 @@
                 notified later, just before the form's listener (if any) is invoked.
             </p>
 
-
             <p>
                 <strong>
                     See also:
-                    <a href="../tapestry-framework/apidocs/org/apache/tapestry/form/Submit.html">
+                    <a href="../../tapestry-framework/apidocs/org/apache/tapestry/form/Submit.html">
                         org.apache.tapestry.form.Submit
                     </a>
                     ,
@@ -74,7 +73,6 @@
                     <tr>
                         <th>Name</th>
                         <th>Type</th>
-                        <th>Direction</th>
                         <th>Required</th>
                         <th>Default</th>
                         <th>Description</th>
@@ -86,7 +84,6 @@
                             <strong>(deprecated)</strong>
                         </td>
                         <td>String</td>
-                        <td>in</td>
                         <td>no</td>
                         <td></td>
                         <td>
@@ -99,7 +96,6 @@
                     <tr>
                         <td>disabled</td>
                         <td>boolean</td>
-                        <td>in</td>
                         <td>no</td>
                         <td>false</td>
                         <td>
@@ -111,7 +107,6 @@
                     <tr>
                         <td>selected</td>
                         <td>Object</td>
-                        <td>out</td>
                         <td>no</td>
                         <td></td>
                         <td>
@@ -123,7 +118,6 @@
                     <tr>
                         <td>tag</td>
                         <td>Object</td>
-                        <td>in</td>
                         <td>no</td>
                         <td></td>
                         <td>
@@ -136,11 +130,10 @@
                         <td>listener</td>
                         <td>
                             <a
-                                href="../tapestry-framework/apidocs/org/apache/tapestry/IActionListener.html">
+                                href="../../tapestry-framework/apidocs/org/apache/tapestry/IActionListener.html">
                                 IActionListener
                             </a>
                         </td>
-                        <td>in</td>
                         <td>no</td>
                         <td></td>
                         <td>
@@ -165,11 +158,10 @@
                         <td>action</td>
                         <td>
                             <a
-                                href="../tapestry-framework/apidocs/org/apache/tapestry/IActionListener.html">
+                                href="../../tapestry-framework/apidocs/org/apache/tapestry/IActionListener.html">
                                 IActionListener
                             </a>
                         </td>
-                        <td>in</td>
                         <td>no</td>
                         <td></td>
                         <td>
@@ -186,7 +178,6 @@
                     <tr>
                         <td>parameters</td>
                         <td>Object</td>
-                        <td>in</td>
                         <td>no</td>
                         <td></td>
                         <td>
@@ -208,15 +199,15 @@
                     <tr>
                         <td>submitType</td>
                         <td>String - [submit,cancel,refresh]</td>
-                        <td></td>
                         <td>yes</td>
                         <td>submit</td>
                         <td>
                             Controls the type of submission that this component invokes. Using javascript
                             this parameter will cause the invocation of the component to be recognized as 
                             a cancel/refresh/normal form submission depending on the value given. If you 
-                            have a cancel="listener" or refresh="listener" parameter set on your 
-                            <a href="Form.html">Form</a> they will be invoked accordingly.
+                            have a <code>cancel="listener"</code> or <code>refresh="listener"</code> 
+                            parameter set on your <a href="Form.html">Form</a> they will be invoked 
+                            accordingly.
                         </td>
                     </tr>
                     <tr>
@@ -229,8 +220,11 @@
                             rendered back to the client. These are expected to be unique component ids. 
                             
                             <p>
-                            See: <a href="../tapestry-framework/apidocs/org/apache/tapestry/services/ResponseBuilder.html">ResponseBuilder</a>
+                            See: <a href="../../tapestry-framework/apidocs/org/apache/tapestry/services/ResponseBuilder.html">ResponseBuilder</a>
                             </p>
+                            
+                            <br/>
+                            <strong>See also:</strong> <a href="../../ajax/index.html">Ajax Features</a>
                         </td>
                     </tr>
                     <tr>
@@ -240,8 +234,11 @@
                         <td>false</td>
                         <td>
                             Causes the request to be asynchronous and the response to be captured/rendered via
-                            the <a href="../tapestry-framework/apidocs/org/apache/tapestry/services/impl/JSONResponseBuilder.html">JSONResponseBuilder</a>
+                            the <a href="../../tapestry-framework/apidocs/org/apache/tapestry/services/impl/JSONResponseBuilder.html">JSONResponseBuilder</a>
                             renderer.
+                            
+                            <br/><br/>
+                            <strong>See also:</strong> <a href="../../ajax/index.html">Ajax Features</a>
                         </td>
                     </tr>
                     <tr>
@@ -251,8 +248,11 @@
                         <td>false</td>
                         <td>
                             Causes the request to be asynchronous and the response to be captured/rendered via
-                            the <a href="../tapestry-framework/apidocs/org/apache/tapestry/services/impl/DojoAjaxResponseBuilder.html">DojoAjaxResponseBuilder</a>
+                            the <a href="../../tapestry-framework/apidocs/org/apache/tapestry/services/impl/DojoAjaxResponseBuilder.html">DojoAjaxResponseBuilder</a>
                             renderer.
+                            
+                            <br/><br/>
+                            <strong>See also:</strong> <a href="../../ajax/index.html">Ajax Features</a>
                         </td>
                     </tr>
                 </table>

Copied: tapestry/tapestry4/trunk/src/site/xdoc/components/form/TextArea.xml (from r454604, tapestry/tapestry4/trunk/src/site/xdoc/components/TextArea.xml)
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/xdoc/components/form/TextArea.xml?view=diff&rev=463527&p1=tapestry/tapestry4/trunk/src/site/xdoc/components/TextArea.xml&r1=454604&p2=tapestry/tapestry4/trunk/src/site/xdoc/components/form/TextArea.xml&r2=463527
==============================================================================
--- tapestry/tapestry4/trunk/src/site/xdoc/components/TextArea.xml (original)
+++ tapestry/tapestry4/trunk/src/site/xdoc/components/form/TextArea.xml Thu Oct 12 17:28:41 2006
@@ -23,18 +23,18 @@
         <section name="TextArea">
 
             <p>
-                A form element control that renders an HTML &lt;textarea&gt;, a multi-line text
+                A form element control that renders an HTML <code>&lt;textarea&gt;</code>, a multi-line text
                 input.
             </p>
 
             <p>
                 <strong>
                     See also:
-                    <a href="../tapestry-framework/apidocs/org/apache/tapestry/form/TextArea.html">
+                    <a href="../../tapestry-framework/apidocs/org/apache/tapestry/form/TextArea.html">
                         org.apache.tapestry.form.TextArea
                     </a>
                     ,
-                    <a href="InsertText.html">InsertText</a>
+                    <a href="../general/InsertText.html">InsertText</a>
                     ,
                     <a href="TextField.html">TextField</a>
                 </strong>
@@ -47,7 +47,6 @@
                     <tr>
                         <th>Name</th>
                         <th>Type</th>
-                        <th>Direction</th>
                         <th>Required</th>
                         <th>Default</th>
                         <th>Description</th>
@@ -56,7 +55,6 @@
                     <tr>
                         <td>value</td>
                         <td>string</td>
-                        <td>in / out</td>
                         <td>yes</td>
                         <td></td>
                         <td>
@@ -67,21 +65,18 @@
                     <tr>
                         <td>disabled</td>
                         <td>boolean</td>
-                        <td>in</td>
                         <td>no</td>
                         <td>false</td>
                         <td>
-                            If true, then the &lt;textarea&gt; will be written with a disabled
+                            If true, then the <code>&lt;textarea&gt;</code> will be written with a disabled
                             attribute (preventing user interaction in the client web browser). In
                             addition, when the form is submitted, the component will not update its
                             value parameter.
                         </td>
                     </tr>
-
                     <tr>
                         <td>displayName</td>
                         <td>string</td>
-                        <td>in</td>
                         <td>no</td>
                         <td></td>
                         <td>
@@ -90,7 +85,40 @@
                             component connected to the TextArea.
                         </td>
                     </tr>
-
+                    <tr>
+                        <td>validators</td>
+                        <td>
+                            Array or collection of
+                            <a
+                                href="../../tapestry-framework/apidocs/org/apache/tapestry/form/validator/Validator.html">
+                                Validator
+                            </a>
+                        </td>
+                        <td>no</td>
+                        <td></td>
+                        <td>
+                            The validators to apply to the component. Something along the lines of:
+                            <code>validators:required</code> .<br/><br/>
+                            
+                            <strong>See also:</strong> <a href="../../UsersGuide/validation.html">Validation</a>
+                        </td>
+                    </tr>
+                    <tr>
+                        <td>translator</td>
+                        <td>
+                            <a
+                                href="../../tapestry/apidocs/org/apache/tapestry/form/translator/Translator.html">
+                                Translator
+                            </a>
+                        </td>
+                        <td>no</td>
+                        <td></td>
+                        <td>
+                            The translator to use when displaying and parsing the date.
+                            <br/><br/>
+                            <strong>See also:</strong> <a href="../../UsersGuide/validation.html">Validation</a>
+                        </td>
+                    </tr>
                 </table>
 
                 <p>
@@ -104,16 +132,6 @@
                 </p>
 
                 <p>Reserved parameters: name</p>
-
-                <p>
-                    TextArea components may not have a validator, but they will be decorated by a
-                    <a
-                        href="../tapestry-framework/apidocs/org/apache/tapestry/valid/IValidationDelegate.html">
-                        IValidationDelegate
-                    </a>
-                    if in error. Since there is no validator, such errors would be set within a
-                    listener method.
-                </p>
 
             </section>
 

Copied: tapestry/tapestry4/trunk/src/site/xdoc/components/form/TextField.xml (from r454604, tapestry/tapestry4/trunk/src/site/xdoc/components/TextField.xml)
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/xdoc/components/form/TextField.xml?view=diff&rev=463527&p1=tapestry/tapestry4/trunk/src/site/xdoc/components/TextField.xml&r1=454604&p2=tapestry/tapestry4/trunk/src/site/xdoc/components/form/TextField.xml&r2=463527
==============================================================================
--- tapestry/tapestry4/trunk/src/site/xdoc/components/TextField.xml (original)
+++ tapestry/tapestry4/trunk/src/site/xdoc/components/form/TextField.xml Thu Oct 12 17:28:41 2006
@@ -22,12 +22,12 @@
 
         <section name="TextField">
 
-            <p>A form element component that renders an &lt;input&gt; element.</p>
+            <p>A form element component that renders an <code>&lt;input&gt;</code> element.</p>
 
             <p>
                 <strong>
                     See also:
-                    <a href="../tapestry-framework/apidocs/org/apache/tapestry/form/TextField.html">
+                    <a href="../../tapestry-framework/apidocs/org/apache/tapestry/form/TextField.html">
                         org.apache.tapestry.form.TextField
                     </a>
                     ,
@@ -42,7 +42,6 @@
                     <tr>
                         <th>Name</th>
                         <th>Type</th>
-                        <th>Direction</th>
                         <th>Required</th>
                         <th>Default</th>
                         <th>Description</th>
@@ -51,7 +50,6 @@
                     <tr>
                         <td>value</td>
                         <td>string</td>
-                        <td>in / out</td>
                         <td>yes</td>
                         <td></td>
                         <td>
@@ -59,16 +57,14 @@
                             limited ability to convert to and from strings.
                         </td>
                     </tr>
-
                     <tr>
                         <td>disabled</td>
                         <td>boolean</td>
-                        <td>in</td>
                         <td>no</td>
                         <td>false</td>
                         <td>
                             If true, then a disabled attribute will be rendered as part of the
-                            &lt;input&gt; tag, and the component will not update its value parameter
+                            <code>&lt;input&gt;</code> tag, and the component will not update its value parameter
                             when the form is submitted.
                         </td>
                     </tr>
@@ -76,7 +72,6 @@
                     <tr>
                         <td>displayName</td>
                         <td>string</td>
-                        <td>in</td>
                         <td>no</td>
                         <td></td>
                         <td>
@@ -85,11 +80,43 @@
                             connected to the component.
                         </td>
                     </tr>
-
+                    <tr>
+                        <td>validators</td>
+                        <td>
+                            Array or collection of
+                            <a
+                                href="../../tapestry-framework/apidocs/org/apache/tapestry/form/validator/Validator.html">
+                                Validator
+                            </a>
+                        </td>
+                        <td>no</td>
+                        <td></td>
+                        <td>
+                            The validators to apply to the component. Something along the lines of:
+                            <code>validators:required</code> .<br/><br/>
+                            
+                            <strong>See also:</strong> <a href="../../UsersGuide/validation.html">Validation</a>
+                        </td>
+                    </tr>
+                    <tr>
+                        <td>translator</td>
+                        <td>
+                            <a
+                                href="../../tapestry/apidocs/org/apache/tapestry/form/translator/Translator.html">
+                                Translator
+                            </a>
+                        </td>
+                        <td>no</td>
+                        <td></td>
+                        <td>
+                            The translator to use when displaying and parsing the date.
+                            <br/><br/>
+                            <strong>See also:</strong> <a href="../../UsersGuide/validation.html">Validation</a>
+                        </td>
+                    </tr>
                     <tr>
                         <td>hidden</td>
                         <td>boolean</td>
-                        <td>in</td>
                         <td>no</td>
                         <td>false</td>
                         <td>
@@ -97,7 +124,6 @@
                             user input in the browser will be masked.
                         </td>
                     </tr>
-
                 </table>
 
                 <p>

Copied: tapestry/tapestry4/trunk/src/site/xdoc/components/form/Upload.xml (from r454604, tapestry/tapestry4/trunk/src/site/xdoc/components/Upload.xml)
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/xdoc/components/form/Upload.xml?view=diff&rev=463527&p1=tapestry/tapestry4/trunk/src/site/xdoc/components/Upload.xml&r1=454604&p2=tapestry/tapestry4/trunk/src/site/xdoc/components/form/Upload.xml&r2=463527
==============================================================================
--- tapestry/tapestry4/trunk/src/site/xdoc/components/Upload.xml (original)
+++ tapestry/tapestry4/trunk/src/site/xdoc/components/form/Upload.xml Thu Oct 12 17:28:41 2006
@@ -25,7 +25,7 @@
             <p>
                 A form element used to handle file uploads. The uploaded file is represented by an
                 instance of
-                <a href="../tapestry-framework/apidocs/org/apache/tapestry/request/IUploadFile.html">
+                <a href="../../tapestry-framework/apidocs/org/apache/tapestry/request/IUploadFile.html">
                     IUploadFile
                 </a>
                 .
@@ -34,7 +34,7 @@
             <p>
                 The maximum upload size of a file can be set by configuring the
                 <a
-                    href="../tapestry-framework/apidocs/org/apache/tapestry/multipart/MultipartDecoder.html">
+                    href="../../tapestry-framework/apidocs/org/apache/tapestry/multipart/MultipartDecoder.html">
                     MultipartDecoder
                 </a>
                 service in hivemind. The default is 10000000(10mb). The <code>maxSize</code> parameter is 
@@ -54,15 +54,15 @@
                 <strong>
                     See also:
 
-                    <a href="../tapestry-framework/apidocs/org/apache/tapestry/form/Upload.html">
+                    <a href="../../tapestry-framework/apidocs/org/apache/tapestry/form/Upload.html">
                         org.apache.tapestry.form.Upload
                     </a>
                     ,
-                    <a href="site:Form">Form</a>
+                    <a href="Form">Form</a>
                 </strong>
                 ,
                 <a
-                    href="../tapestry-framework/apidocs/org/apache/tapestry/multipart/ServletMultipartDecoder.html">
+                    href="../../tapestry-framework/apidocs/org/apache/tapestry/multipart/ServletMultipartDecoder.html">
                     ServletMultipartDecoder
                 </a>
             </p>
@@ -84,8 +84,6 @@
                     <tr>
                         <th>Name</th>
                         <th>Type</th>
-                        <th>Direction</th>
-
                         <th>Required</th>
                         <th>Default</th>
                         <th>Description</th>
@@ -94,12 +92,10 @@
                         <td>file</td>
                         <td>
                             <a
-                                href="../tapestry-framework/apidocs/org/apache/tapestry/request/IUploadFile.html">
+                                href="../../tapestry-framework/apidocs/org/apache/tapestry/request/IUploadFile.html">
                                 IUploadFile
                             </a>
                         </td>
-
-                        <td>out</td>
                         <td>yes</td>
                         <td></td>
                         <td>
@@ -110,7 +106,6 @@
 
                         <td>disabled</td>
                         <td>boolean</td>
-                        <td>in</td>
                         <td>no</td>
                         <td>false</td>
                         <td>
@@ -122,7 +117,6 @@
                     <tr>
                         <td>displayName</td>
                         <td>string</td>
-                        <td>in</td>
                         <td>no</td>
                         <td></td>
                         <td>
@@ -136,30 +130,25 @@
                         <td>
                             Array or collection of
                             <a
-                                href="../tapestry-framework/apidocs/org/apache/tapestry/form/validator/Validator.html">
-                                Validator
-                            </a>
-                            , or
-                            <a
-                                href="../tapestry-framework/apidocs/org/apache/tapestry/form/validator/Validator.html">
+                                href="../../tapestry-framework/apidocs/org/apache/tapestry/form/validator/Validator.html">
                                 Validator
                             </a>
                         </td>
-
-                        <td>in</td>
                         <td>no</td>
                         <td></td>
-                        <td>The validators to apply to the component.</td>
+                        <td>
+                            The validators to apply to the component. Something along the lines of:
+                            <code>validators:required</code> .<br/><br/>
+                            
+                            <strong>See also:</strong> <a href="../../UsersGuide/validation.html">Validation</a>
+                        </td>
                     </tr>
                     <tr>
-
                         <td>id</td>
                         <td>String</td>
-                        <td>in</td>
                         <td>no</td>
                         <td></td>
-                        <td>Sets the id attribute for the rendered &lt;input&gt; element.</td>
-
+                        <td>Sets the id attribute for the rendered <code>&lt;input&gt;</code> element.</td>
                     </tr>
                 </table>
 

Added: tapestry/tapestry4/trunk/src/site/xdoc/components/form/index.xml
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/xdoc/components/form/index.xml?view=auto&rev=463527
==============================================================================
--- tapestry/tapestry4/trunk/src/site/xdoc/components/form/index.xml (added)
+++ tapestry/tapestry4/trunk/src/site/xdoc/components/form/index.xml Thu Oct 12 17:28:41 2006
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- 
+    Copyright 2005 The Apache Software Foundation
+    
+    Licensed 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.
+-->
+<document>
+    <properties>
+        <title>Framework Component Reference - Form Components</title>
+    </properties>
+    <body>
+        
+        <section name="Form Components">
+            <p>
+                The menu to the left lists all of the form related components provided 
+                with the Tapestry framework.
+            </p>
+        </section>
+    </body>
+</document>

Propchange: tapestry/tapestry4/trunk/src/site/xdoc/components/form/index.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Copied: tapestry/tapestry4/trunk/src/site/xdoc/components/general/Any.xml (from r454604, tapestry/tapestry4/trunk/src/site/xdoc/components/Any.xml)
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/xdoc/components/general/Any.xml?view=diff&rev=463527&p1=tapestry/tapestry4/trunk/src/site/xdoc/components/Any.xml&r1=454604&p2=tapestry/tapestry4/trunk/src/site/xdoc/components/general/Any.xml&r2=463527
==============================================================================
--- tapestry/tapestry4/trunk/src/site/xdoc/components/Any.xml (original)
+++ tapestry/tapestry4/trunk/src/site/xdoc/components/general/Any.xml Thu Oct 12 17:28:41 2006
@@ -33,7 +33,7 @@
                 <strong>
                     See also:
                     <a
-                        href="../tapestry-framework/apidocs/org/apache/tapestry/components/Any.html">
+                        href="../../tapestry-framework/apidocs/org/apache/tapestry/components/Any.html">
                         org.apache.tapestry.components.Any
                     </a>
                     ,
@@ -50,7 +50,6 @@
                     <tr>
                         <th>Name</th>
                         <th>Type</th>
-                        <th>Direction</th>
                         <th>Required</th>
                         <th>Default</th>
                         <th>Description</th>
@@ -59,7 +58,6 @@
                     <tr>
                         <td>element</td>
                         <td>string</td>
-                        <td>in</td>
                         <td>no</td>
                         <td>
                             <em>From the HTML template</em>
@@ -99,7 +97,7 @@
 
 
                 <p>
-                    In this example, the Any component is emulating an &lt;img&gt; element, and is
+                    In this example, the Any component is emulating an <code>&lt;img&gt;</code> element, and is
                     dynamically calculating the URL, width, height, and title from data (presumably
                     obtained from a database).
                 </p>

Copied: tapestry/tapestry4/trunk/src/site/xdoc/components/general/Block.xml (from r454604, tapestry/tapestry4/trunk/src/site/xdoc/components/Block.xml)
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/xdoc/components/general/Block.xml?view=diff&rev=463527&p1=tapestry/tapestry4/trunk/src/site/xdoc/components/Block.xml&r1=454604&p2=tapestry/tapestry4/trunk/src/site/xdoc/components/general/Block.xml&r2=463527
==============================================================================
--- tapestry/tapestry4/trunk/src/site/xdoc/components/Block.xml (original)
+++ tapestry/tapestry4/trunk/src/site/xdoc/components/general/Block.xml Thu Oct 12 17:28:41 2006
@@ -31,7 +31,7 @@
             <p>
                 <strong>
                     See also:
-                    <a href="../tapestry-framework/apidocs/org/apache/tapestry/components/Block.html">
+                    <a href="../../tapestry-framework/apidocs/org/apache/tapestry/components/Block.html">
                         org.apache.tapestry.components.Block
                     </a>
                     ,

Copied: tapestry/tapestry4/trunk/src/site/xdoc/components/general/Body.xml (from r454604, tapestry/tapestry4/trunk/src/site/xdoc/components/Body.xml)
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/xdoc/components/general/Body.xml?view=diff&rev=463527&p1=tapestry/tapestry4/trunk/src/site/xdoc/components/Body.xml&r1=454604&p2=tapestry/tapestry4/trunk/src/site/xdoc/components/general/Body.xml&r2=463527
==============================================================================
--- tapestry/tapestry4/trunk/src/site/xdoc/components/Body.xml (original)
+++ tapestry/tapestry4/trunk/src/site/xdoc/components/general/Body.xml Thu Oct 12 17:28:41 2006
@@ -22,20 +22,20 @@
 
         <section name="Body">
             <p>
-                Generates the &lt;body&gt; element for the page, and is involved in generating and
+                Generates the <code>&lt;body&gt;</code> element for the page, and is involved in generating and
                 organizing the JavaScript on the page. You should always use the Body component for
-                your &lt;body&gt; tag, since you can never know which components within the page
+                your <code>&lt;body&gt;</code> tag, since you can never know which components within the page
                 will require the services it provides.
             </p>
 
             <p>
                 <strong>
                     See also:
-                    <a href="../tapestry-framework/apidocs/org/apache/tapestry/html/Body.html">
+                    <a href="../../tapestry-framework/apidocs/org/apache/tapestry/html/Body.html">
                         org.apache.tapestry.html.Body
                     </a>
                     ,
-                    <a href="Rollover.html">Rollover</a>
+                    <a href="../link/Rollover.html">Rollover</a>
                     ,
                     <a href="Script.html">Script</a>
                 </strong>
@@ -48,7 +48,6 @@
                     <tr>
                         <th>Name</th>
                         <th>Type</th>
-                        <th>Direction</th>
                         <th>Required</th>
                         <th>Default</th>
                         <th>Description</th>
@@ -57,12 +56,11 @@
                     <tr>
                         <td>element</td>
                         <td>string</td>
-                        <td>in</td>
                         <td>no</td>
                         <td>body</td>
                         <td>
                             The element to use; this can be overriden, for example, when the Body
-                            component is used to generate a &lt;frameset&gt;.
+                            component is used to generate a <code>&lt;frameset&gt;</code>.
                         </td>
                     </tr>
 

Copied: tapestry/tapestry4/trunk/src/site/xdoc/components/general/Delegator.xml (from r454604, tapestry/tapestry4/trunk/src/site/xdoc/components/Delegator.xml)
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/xdoc/components/general/Delegator.xml?view=diff&rev=463527&p1=tapestry/tapestry4/trunk/src/site/xdoc/components/Delegator.xml&r1=454604&p2=tapestry/tapestry4/trunk/src/site/xdoc/components/general/Delegator.xml&r2=463527
==============================================================================
--- tapestry/tapestry4/trunk/src/site/xdoc/components/Delegator.xml (original)
+++ tapestry/tapestry4/trunk/src/site/xdoc/components/general/Delegator.xml Thu Oct 12 17:28:41 2006
@@ -37,7 +37,6 @@
                     <tr>
                         <th>Name</th>
                         <th>Type</th>
-                        <th>Direction</th>
                         <th>Required</th>
                         <th>Default</th>
                         <th>Description</th>
@@ -45,14 +44,12 @@
                     <tr>
                         <td>delegate</td>
                         <td>
-                            <a href="../tapestry-framework/apidocs/org/apache/tapestry/IRender.html">
+                            <a href="../../tapestry-framework/apidocs/org/apache/tapestry/IRender.html">
                                 IRender
                             </a>
                         </td>
-
-                        <td>in</td>
                         <td>no</td>
-                        <td />
+                        <td></td>
                         <td>
                             If specified, the object which will provide the rendering for the
                             component.

Copied: tapestry/tapestry4/trunk/src/site/xdoc/components/general/Describe.xml (from r454604, tapestry/tapestry4/trunk/src/site/xdoc/components/Describe.xml)
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/xdoc/components/general/Describe.xml?view=diff&rev=463527&p1=tapestry/tapestry4/trunk/src/site/xdoc/components/Describe.xml&r1=454604&p2=tapestry/tapestry4/trunk/src/site/xdoc/components/general/Describe.xml&r2=463527
==============================================================================
--- tapestry/tapestry4/trunk/src/site/xdoc/components/Describe.xml (original)
+++ tapestry/tapestry4/trunk/src/site/xdoc/components/general/Describe.xml Thu Oct 12 17:28:41 2006
@@ -41,7 +41,7 @@
             <p>
                 <strong>
                     See also:
-                    <a href="../tapestry-framework/apidocs/org/apache/tapestry/html/Describe.html">
+                    <a href="../../tapestry-framework/apidocs/org/apache/tapestry/html/Describe.html">
                         org.apache.tapestry.html.Describe
                     </a>
                     ,
@@ -58,7 +58,6 @@
                     <tr>
                         <th>Name</th>
                         <th>Type</th>
-                        <th>Direction</th>
                         <th>Required</th>
                         <th>Default</th>
                         <th>Description</th>
@@ -67,9 +66,8 @@
                     <tr>
                         <td>object</td>
                         <td>any</td>
-                        <td>in</td>
                         <td>yes</td>
-                        <td />
+                        <td></td>
                         <td>The object to be described.</td>
                     </tr>
 

Copied: tapestry/tapestry4/trunk/src/site/xdoc/components/general/Else.xml (from r454604, tapestry/tapestry4/trunk/src/site/xdoc/components/Else.xml)
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/xdoc/components/general/Else.xml?view=diff&rev=463527&p1=tapestry/tapestry4/trunk/src/site/xdoc/components/Else.xml&r1=454604&p2=tapestry/tapestry4/trunk/src/site/xdoc/components/general/Else.xml&r2=463527
==============================================================================
--- tapestry/tapestry4/trunk/src/site/xdoc/components/Else.xml (original)
+++ tapestry/tapestry4/trunk/src/site/xdoc/components/general/Else.xml Thu Oct 12 17:28:41 2006
@@ -30,7 +30,7 @@
             <p>
                 <strong>
                     See also:
-                    <a href="../tapestry-framework/apidocs/org/apache/tapestry/components/ElseBean.html">
+                    <a href="../../tapestry-framework/apidocs/org/apache/tapestry/components/ElseBean.html">
                         org.apache.tapestry.components.ElseBean
                     </a>
                     ,
@@ -48,7 +48,6 @@
                         <th>Type</th>
                         <th>Required</th>
                         <th>Default</th>
-
                         <th>Description</th>
                     </tr>
 
@@ -103,10 +102,7 @@
             </section>
 
             <section name="Examples">
-
-
                 <p>
-
                     In the example, we say hello to our user if he/she has login, or we ask him/her
                     login. (Just the same example for If component.)
                 </p>

Copied: tapestry/tapestry4/trunk/src/site/xdoc/components/general/ExceptionDisplay.xml (from r454604, tapestry/tapestry4/trunk/src/site/xdoc/components/ExceptionDisplay.xml)
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/xdoc/components/general/ExceptionDisplay.xml?view=diff&rev=463527&p1=tapestry/tapestry4/trunk/src/site/xdoc/components/ExceptionDisplay.xml&r1=454604&p2=tapestry/tapestry4/trunk/src/site/xdoc/components/general/ExceptionDisplay.xml&r2=463527
==============================================================================
--- tapestry/tapestry4/trunk/src/site/xdoc/components/ExceptionDisplay.xml (original)
+++ tapestry/tapestry4/trunk/src/site/xdoc/components/general/ExceptionDisplay.xml Thu Oct 12 17:28:41 2006
@@ -31,7 +31,7 @@
             <p>
                 <strong>
                     See also:
-                    <a href="InspectorButton.html">InspectorButton</a>
+                    <a href="../../tapestry-contrib/ComponentReference/InspectorButton.html">InspectorButton</a>
                 </strong>
             </p>
 
@@ -42,7 +42,6 @@
                     <tr>
                         <th>Name</th>
                         <th>Type</th>
-                        <th>Direction</th>
                         <th>Required</th>
                         <th>Default</th>
                         <th>Description</th>
@@ -51,14 +50,13 @@
                         <td>exceptions</td>
                         <td>
                             <a
-                                href="../tapestry-framework/apidocs/org/apache/tapestry/util/exception/ExceptionDescription.html">
+                                href="../../tapestry-framework/apidocs/org/apache/tapestry/util/exception/ExceptionDescription.html">
                                 ExceptionDescription
                             </a>
                             []
                         </td>
-                        <td>in</td>
                         <td>yes</td>
-                        <td />
+                        <td></td>
                         <td>Provides the exception descriptions to render.</td>
                     </tr>
 

Copied: tapestry/tapestry4/trunk/src/site/xdoc/components/general/For.xml (from r454604, tapestry/tapestry4/trunk/src/site/xdoc/components/For.xml)
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/xdoc/components/general/For.xml?view=diff&rev=463527&p1=tapestry/tapestry4/trunk/src/site/xdoc/components/For.xml&r1=454604&p2=tapestry/tapestry4/trunk/src/site/xdoc/components/general/For.xml&r2=463527
==============================================================================
--- tapestry/tapestry4/trunk/src/site/xdoc/components/For.xml (original)
+++ tapestry/tapestry4/trunk/src/site/xdoc/components/general/For.xml Thu Oct 12 17:28:41 2006
@@ -32,12 +32,12 @@
             <p>
                 <strong>
                     See also:
-                    <a href="../tapestry-framework/apidocs/org/apache/tapestry/components/ForBean.html">
+                    <a href="../../tapestry-framework/apidocs/org/apache/tapestry/components/ForBean.html">
                         org.apache.tapestry.components.ForBean
                     </a>
                     ,
                     <a
-                        href="../tapestry-framework/apidocs/org/apache/tapestry/utils/DefaultPrimaryKeyConverter.html">
+                        href="../../tapestry-framework/apidocs/org/apache/tapestry/utils/DefaultPrimaryKeyConverter.html">
                         org.apache.tapestry.utils.DefaultPrimaryKeyConverter
                     </a>
                 </strong>
@@ -50,7 +50,6 @@
                     <tr>
                         <th>Name</th>
                         <th>Type</th>
-                        <th>Direction</th>
                         <th>Required</th>
                         <th>Default</th>
                         <th>Description</th>
@@ -59,7 +58,6 @@
                     <tr>
                         <td>source</td>
                         <td>Iterator, Collection, Object[], or Object</td>
-                        <td>in</td>
                         <td>yes</td>
                         <td></td>
 
@@ -76,7 +74,6 @@
                     <tr>
                         <td>value</td>
                         <td>Object</td>
-                        <td>out</td>
                         <td>no</td>
                         <td></td>
 
@@ -89,7 +86,6 @@
                     <tr>
                         <td>index</td>
                         <td>int</td>
-                        <td>out</td>
                         <td>no</td>
                         <td></td>
 
@@ -102,7 +98,6 @@
                     <tr>
                         <td>element</td>
                         <td>String</td>
-                        <td>in</td>
                         <td>no</td>
                         <td></td>
 
@@ -115,10 +110,9 @@
                     <tr>
                         <td>keyExpression</td>
                         <td>String</td>
-                        <td>in</td>
                         <td>no</td>
                         <td></td>
-
+                        
                         <td>
                             Only active in a form. An OGNL expression that returns the primary key
                             of the iterated value. The primary keys are stored in hidden fields
@@ -136,7 +130,6 @@
                     <tr>
                         <td>fullSource</td>
                         <td>Iterator, Collection, Object[], or Object</td>
-                        <td>in</td>
                         <td>no</td>
                         <td></td>
 
@@ -150,7 +143,6 @@
                     <tr>
                         <td>defaultValue</td>
                         <td>Object</td>
-                        <td>in</td>
                         <td>no</td>
                         <td></td>
 
@@ -164,11 +156,10 @@
                         <td>converter</td>
                         <td>
                             <a
-                                href="../tapestry-framework/apidocs/org/apache/tapestry/components/IPrimaryKeyConverter.html">
+                                href="../../tapestry-framework/apidocs/org/apache/tapestry/components/IPrimaryKeyConverter.html">
                                 IPrimaryKeyConverter
                             </a>
                         </td>
-                        <td>in</td>
                         <td>no</td>
                         <td></td>
 
@@ -185,7 +176,6 @@
                     <tr>
                         <td>primaryKeys</td>
                         <td>List</td>
-                        <td>out</td>
                         <td>no</td>
                         <td></td>
 
@@ -201,7 +191,6 @@
                     <tr>
                         <td>match</td>
                         <td>boolean</td>
-                        <td>in</td>
                         <td>no</td>
                         <td>true</td>
 
@@ -219,7 +208,6 @@
                     <tr>
                         <td>volatile</td>
                         <td>boolean</td>
-                        <td>in</td>
                         <td>no</td>
                         <td>false</td>
 

Copied: tapestry/tapestry4/trunk/src/site/xdoc/components/general/Frame.xml (from r454604, tapestry/tapestry4/trunk/src/site/xdoc/components/Frame.xml)
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/xdoc/components/general/Frame.xml?view=diff&rev=463527&p1=tapestry/tapestry4/trunk/src/site/xdoc/components/Frame.xml&r1=454604&p2=tapestry/tapestry4/trunk/src/site/xdoc/components/general/Frame.xml&r2=463527
==============================================================================
--- tapestry/tapestry4/trunk/src/site/xdoc/components/Frame.xml (original)
+++ tapestry/tapestry4/trunk/src/site/xdoc/components/general/Frame.xml Thu Oct 12 17:28:41 2006
@@ -23,8 +23,8 @@
         <section name="Frame">
 
             <p>
-                Provides the HTML &lt;frame&gt; element within a &lt;frameset&gt;, inserting the
-                specified Tapestry page as the content of the frame.
+                Provides the HTML <code>&lt;frame&gt;</code> element within a <code>&lt;frameset&gt;</code>, 
+                inserting the specified Tapestry page as the content of the frame.
             </p>
 
             <p>
@@ -43,7 +43,6 @@
                     <tr>
                         <th>Name</th>
                         <th>Type</th>
-                        <th>Direction</th>
                         <th>Required</th>
                         <th>Default</th>
                         <th>Description</th>
@@ -51,9 +50,8 @@
                     <tr>
                         <td>page</td>
                         <td>String</td>
-                        <td>in</td>
                         <td>yes</td>
-                        <td />
+                        <td></td>
                         <td>The name of the page to display in the frame.</td>
                     </tr>
 

Copied: tapestry/tapestry4/trunk/src/site/xdoc/components/general/If.xml (from r454604, tapestry/tapestry4/trunk/src/site/xdoc/components/If.xml)
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/xdoc/components/general/If.xml?view=diff&rev=463527&p1=tapestry/tapestry4/trunk/src/site/xdoc/components/If.xml&r1=454604&p2=tapestry/tapestry4/trunk/src/site/xdoc/components/general/If.xml&r2=463527
==============================================================================
--- tapestry/tapestry4/trunk/src/site/xdoc/components/If.xml (original)
+++ tapestry/tapestry4/trunk/src/site/xdoc/components/general/If.xml Thu Oct 12 17:28:41 2006
@@ -30,7 +30,7 @@
             <p>
                 <strong>
                     See also:
-                    <a href="../tapestry-framework/apidocs/org/apache/tapestry/components/IfBean.html">
+                    <a href="../../tapestry-framework/apidocs/org/apache/tapestry/components/IfBean.html">
                         org.apache.tapestry.components.IfBean
                     </a>
                     ,
@@ -48,7 +48,6 @@
                         <th>Type</th>
                         <th>Required</th>
                         <th>Default</th>
-
                         <th>Description</th>
                     </tr>
 
@@ -75,7 +74,7 @@
                         <td>listener</td>
                         <td>
                             <a
-                                href="../tapestry-framework/apidocs/org/apache/tapestry/IActionListener.html">
+                                href="../../tapestry-framework/apidocs/org/apache/tapestry/IActionListener.html">
                                 IActionListener
                             </a>
                         </td>

Copied: tapestry/tapestry4/trunk/src/site/xdoc/components/general/Image.xml (from r454604, tapestry/tapestry4/trunk/src/site/xdoc/components/Image.xml)
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/xdoc/components/general/Image.xml?view=diff&rev=463527&p1=tapestry/tapestry4/trunk/src/site/xdoc/components/Image.xml&r1=454604&p2=tapestry/tapestry4/trunk/src/site/xdoc/components/general/Image.xml&r2=463527
==============================================================================
--- tapestry/tapestry4/trunk/src/site/xdoc/components/Image.xml (original)
+++ tapestry/tapestry4/trunk/src/site/xdoc/components/general/Image.xml Thu Oct 12 17:28:41 2006
@@ -25,16 +25,16 @@
             <p>
                 Displays an image, deriving the source URL for the image from an asset.
                 <br />
-                <a href="Rollover.html">Rollover</a>
+                <a href="../link/Rollover.html">Rollover</a>
                 is a similar component that can create dynamic mouse-over effects as well.
             </p>
 
             <p>
                 <strong>
                     See also:
-                    <a href="ImageSubmit.html">ImageSubmit</a>
+                    <a href="../form/ImageSubmit.html">ImageSubmit</a>
                     ,
-                    <a href="Rollover.html">Rollover</a>
+                    <a href="../link/Rollover.html">Rollover</a>
                 </strong>
             </p>
 
@@ -45,7 +45,6 @@
                     <tr>
                         <th>Name</th>
                         <th>Type</th>
-                        <th>Direction</th>
                         <th>Required</th>
                         <th>Default</th>
                         <th>Description</th>
@@ -53,12 +52,10 @@
                     <tr>
                         <td>image</td>
                         <td>
-                            <a href="../tapestry-framework/apidocs/org/apache/tapestry/IAsset.html">
+                            <a href="../../tapestry-framework/apidocs/org/apache/tapestry/IAsset.html">
                                 IAsset
                             </a>
                         </td>
-                        
-                        <td>in</td>
                         <td>yes</td>
                         <td></td>
                         <td>The image to show.</td>
@@ -87,9 +84,9 @@
                 <p>
                     Inserts the static context path based image.
                     <br />
-                    This example uses a &lt;context-asset&gt; to reference the image.
+                    This example uses a <code>&lt;context-asset&gt;</code> to reference the image.
                 </p>
-                <img src="../images/ComponentReference/PoweredByTapestry.png"
+                <img src="../../images/ComponentReference/PoweredByTapestry.png"
                     alt="PoweredByTapestry Screen Shot" />
                 <p>HTML Template</p>
                 <source xml:space="preserve">
@@ -117,7 +114,7 @@
                     Inserts the dynamic image obtained from the page's NewsItem property.
                     <br />
                     This example uses the
-                    <a href="../tapestry-framework/apidocs/org/apache/tapestry/asset/ExternalAsset.html">
+                    <a href="../../tapestry-framework/apidocs/org/apache/tapestry/asset/ExternalAsset.html">
                         ExternalAsset
                     </a>
                     to reference the image's URL.

Copied: tapestry/tapestry4/trunk/src/site/xdoc/components/general/Insert.xml (from r454604, tapestry/tapestry4/trunk/src/site/xdoc/components/Insert.xml)
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/xdoc/components/general/Insert.xml?view=diff&rev=463527&p1=tapestry/tapestry4/trunk/src/site/xdoc/components/Insert.xml&r1=454604&p2=tapestry/tapestry4/trunk/src/site/xdoc/components/general/Insert.xml&r2=463527
==============================================================================
--- tapestry/tapestry4/trunk/src/site/xdoc/components/Insert.xml (original)
+++ tapestry/tapestry4/trunk/src/site/xdoc/components/general/Insert.xml Thu Oct 12 17:28:41 2006
@@ -25,13 +25,13 @@
             <p>
                 Allows for the insertion of text (with a specified format) into the HTML response.
                 The text itself can be filtered or not. When filtering is enabled (the default),
-                certain characters (such as &lt; and &gt;) are escaped into HTML safe
-                representations (such as &amp;lt; and &amp;gt;).
+                certain characters (such as <code>&lt; and &gt;</code>) are escaped into HTML safe
+                representations (such as <code>&amp;lt; and &amp;gt;</code>).
             </p>
 
             <p>
                 <strong>See also:</strong>
-                <a href="../tapestry-framework/apidocs/org/apache/tapestry/components/Insert.html">
+                <a href="../../tapestry-framework/apidocs/org/apache/tapestry/components/Insert.html">
                     org.apache.tapestry.components.Insert
                 </a>
                 <a href="RenderBlock.html">RenderBlock</a>
@@ -48,7 +48,6 @@
                     <tr>
                         <th>Name</th>
                         <th>Type</th>
-                        <th>Direction</th>
                         <th>Required</th>
                         <th>Default Value</th>
                         <th>Description</th>
@@ -56,7 +55,6 @@
                     <tr>
                         <td>value</td>
                         <td>Object</td>
-                        <td>in</td>
                         <td>no</td>
                         <td></td>
                         <td>
@@ -74,7 +72,6 @@
                                 Format
                             </a>
                         </td>
-                        <td>in</td>
                         <td>no</td>
                         <td></td>
                         <td>
@@ -85,11 +82,10 @@
                     <tr>
                         <td>class</td>
                         <td>String</td>
-                        <td>in</td>
                         <td>no</td>
                         <td></td>
                         <td>
-                            If specified, then the output is wrapped in an HTML &lt;span&gt; tag,
+                            If specified, then the output is wrapped in an HTML <code>&lt;span&gt;</code> tag,
                             using the value specified as the CSS class.
 
                             <p>Informal parameters are only rendered if a class is specified.</p>
@@ -98,22 +94,20 @@
                     <tr>
                         <td>raw</td>
                         <td>boolean</td>
-                        <td>in</td>
                         <td>no</td>
                         <td>false</td>
                         <td>
                             If true, then the method
                             <a
-                                href="../tapestry-framework/apidocs/org/apache/tapestry/IMarkupWriter.html#printRaw(java.lang.String)">
+                                href="../../tapestry-framework/apidocs/org/apache/tapestry/IMarkupWriter.html#printRaw(java.lang.String)">
                                 <code>IMarkupWriter.printRaw(String)</code>
                             </a>
                             is used, rather than
                             <a
-                                href="../tapestry-framework/apidocs/org/apache/tapestry/IMarkupWriter.html#print(java.lang.String)">
+                                href="../../tapestry-framework/apidocs/org/apache/tapestry/IMarkupWriter.html#print(java.lang.String)">
                                 <code>IMarkupWriter.print(String)</code>
                             </a>
                             .
-
                             <p>
                                 This bypasses the normal safeguards and is used when the value to
                                 insert contains HTML markup that should be emitted as is.
@@ -149,7 +143,7 @@
                     Example output:
                 </p>
 
-                <img src="../images/ComponentReference/Insert.png"
+                <img src="../../images/ComponentReference/Insert.png"
                     alt="Insert Screen Shot" />
 
                 <p>HTML template</p>

Copied: tapestry/tapestry4/trunk/src/site/xdoc/components/general/InsertText.xml (from r454604, tapestry/tapestry4/trunk/src/site/xdoc/components/InsertText.xml)
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/xdoc/components/general/InsertText.xml?view=diff&rev=463527&p1=tapestry/tapestry4/trunk/src/site/xdoc/components/InsertText.xml&r1=454604&p2=tapestry/tapestry4/trunk/src/site/xdoc/components/general/InsertText.xml&r2=463527
==============================================================================
--- tapestry/tapestry4/trunk/src/site/xdoc/components/InsertText.xml (original)
+++ tapestry/tapestry4/trunk/src/site/xdoc/components/general/InsertText.xml Thu Oct 12 17:28:41 2006
@@ -25,22 +25,22 @@
             <p>
                 Inserts multi-line text, breaking it into individual lines according to a mode.
                 Commonly used to properly display the data provided by a user via the
-                <a href="TextArea.html">TextArea</a>
+                <a href="../form/TextArea.html">TextArea</a>
                 component.
             </p>
 
             <p>
                 <strong>
                     See also:
-                    <a href="../tapestry-framework/apidocs/org/apache/tapestry/html/InsertText.html">
+                    <a href="../../tapestry-framework/apidocs/org/apache/tapestry/html/InsertText.html">
                         org.apache.tapestry.html.InsertText
                     </a>
                     ,
-                    <a href="../tapestry-framework/apidocs/org/apache/tapestry/html/InsertTextMode.html">
+                    <a href="../../tapestry-framework/apidocs/org/apache/tapestry/html/InsertTextMode.html">
                         org.apache.tapestry.html.InsertTextMode
                     </a>
                     ,
-                    <a href="TextArea.html">TextArea</a>
+                    <a href="../form/TextArea.html">TextArea</a>
                 </strong>
             </p>
 
@@ -51,7 +51,6 @@
                     <tr>
                         <th>Name</th>
                         <th>Type</th>
-                        <th>Direction</th>
                         <th>Required</th>
                         <th>Default</th>
                         <th>Description</th>
@@ -60,7 +59,6 @@
                     <tr>
                         <td>value</td>
                         <td>string</td>
-                        <td>in</td>
                         <td>yes</td>
                         <td></td>
                         <td>The multi-line string to render.</td>
@@ -70,11 +68,10 @@
                         <td>mode</td>
                         <td>
                             <a
-                                href="../tapestry-framework/apidocs/org/apache/tapestry/html/InsertTextMode.html">
+                                href="../../tapestry-framework/apidocs/org/apache/tapestry/html/InsertTextMode.html">
                                 InsertTextMode
                             </a>
                         </td>
-                        <td>in</td>
                         <td>no</td>
                         <td>BREAK</td>
                         <td>Controls how each line is rendered.</td>
@@ -83,7 +80,6 @@
                     <tr>
                         <td>raw</td>
                         <td>boolean</td>
-                        <td>in</td>
                         <td>no</td>
                         <td>false</td>
                         <td>
@@ -113,8 +109,8 @@
                     The value parameter is split into multiple lines, and each line is printed. The
                     default
                     <em>mode</em>
-                    renders a &lt;br/&gt; tag between lines (that is, before each line after the
-                    first line output). The alternate mode renders &lt;p&gt; and &lt;/p&gt; tags
+                    renders a <code>&lt;br/&gt;</code> tag between lines (that is, before each line after the
+                    first line output). The alternate mode renders <code>&lt;p&gt; and &lt;/p&gt;</code> tags
                     around each line.
                 </p>
             </section>

Copied: tapestry/tapestry4/trunk/src/site/xdoc/components/general/InvokeListener.xml (from r454604, tapestry/tapestry4/trunk/src/site/xdoc/components/InvokeListener.xml)
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/xdoc/components/general/InvokeListener.xml?view=diff&rev=463527&p1=tapestry/tapestry4/trunk/src/site/xdoc/components/InvokeListener.xml&r1=454604&p2=tapestry/tapestry4/trunk/src/site/xdoc/components/general/InvokeListener.xml&r2=463527
==============================================================================
--- tapestry/tapestry4/trunk/src/site/xdoc/components/InvokeListener.xml (original)
+++ tapestry/tapestry4/trunk/src/site/xdoc/components/general/InvokeListener.xml Thu Oct 12 17:28:41 2006
@@ -31,7 +31,7 @@
                 <strong>
                     See also:
                     <a
-                        href="../tapestry-framework/apidocs/org/apache/tapestry/components/InvokeListener.html">
+                        href="../../tapestry-framework/apidocs/org/apache/tapestry/components/InvokeListener.html">
                         org.apache.tapestry.components.InvokeListener
                     </a>
                     ,
@@ -46,7 +46,6 @@
                     <tr>
                         <th>Name</th>
                         <th>Type</th>
-                        <th>Direction</th>
                         <th>Required</th>
                         <th>Default</th>
                         <th>Description</th>
@@ -56,11 +55,10 @@
                         <td>listener</td>
                         <td>
                             <a
-                                href="../tapestry-framework/apidocs/org/apache/tapestry/IActionListener.html">
+                                href="../../tapestry-framework/apidocs/org/apache/tapestry/IActionListener.html">
                                 IActionListener
                             </a>
                         </td>
-                        <td>in</td>
                         <td>yes</td>
                         <td></td>
                         <td>The listener to invoke.</td>
@@ -69,7 +67,6 @@
                     <tr>
                         <td>parameters</td>
                         <td>Object</td>
-                        <td>in</td>
                         <td>no</td>
                         <td></td>
                         <td>
@@ -77,7 +74,7 @@
                             listener parameters in the IRequestCycle available to the listener.
                             <p>
                                 If the parameter is a Collection, it will be converted to an Object
-                                array (to match the IRequestCycle getListenerParameters()
+                                array (to match the <code>IRequestCycle getListenerParameters()</code>
                                 signature).
                             </p>
                         </td>

Copied: tapestry/tapestry4/trunk/src/site/xdoc/components/general/Relation.xml (from r454604, tapestry/tapestry4/trunk/src/site/xdoc/components/Relation.xml)
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/xdoc/components/general/Relation.xml?view=diff&rev=463527&p1=tapestry/tapestry4/trunk/src/site/xdoc/components/Relation.xml&r1=454604&p2=tapestry/tapestry4/trunk/src/site/xdoc/components/general/Relation.xml&r2=463527
==============================================================================
--- tapestry/tapestry4/trunk/src/site/xdoc/components/Relation.xml (original)
+++ tapestry/tapestry4/trunk/src/site/xdoc/components/general/Relation.xml Thu Oct 12 17:28:41 2006
@@ -45,7 +45,6 @@
                     <tr>
                         <th>Name</th>
                         <th>Type</th>
-                        <th>Direction</th>
                         <th>Required</th>
                         <th>Default</th>
                         <th>Description</th>
@@ -54,9 +53,8 @@
                     <tr>
                         <td>href</td>
                         <td>String or 
-                        <a href="../tapestry-framework/apidocs/org/apache/tapestry/IAsset.html">IAsset</a>
+                        <a href="../../tapestry-framework/apidocs/org/apache/tapestry/IAsset.html">IAsset</a>
                         </td>
-                        <td>in</td>
                         <td>yes</td>
                         <td></td>
                         <td>The target URL of the related resource.</td>
@@ -65,7 +63,6 @@
                     <tr>
                         <td>rel</td>
                         <td>String</td>
-                        <td>in</td>
                         <td>no</td>
                         <td>literal:stylesheet</td>
                         <td>Defines the relationship between the current document and the targeted document.</td>
@@ -74,7 +71,6 @@
                     <tr>
                         <td>type</td>
                         <td>String</td>
-                        <td>in</td>
                         <td>no</td>
                         <td>literal:text/css</td>
                         <td>Specifies the MIME type of the target URL.</td>
@@ -83,7 +79,6 @@
                     <tr>
                         <td>rev</td>
                         <td>String</td>
-                        <td>in</td>
                         <td>no</td>
                         <td></td>
                         <td>Defines the relationship between the targeted document and the current document, 
@@ -93,7 +88,6 @@
                     <tr>
                         <td>title</td>
                         <td>String</td>
-                        <td>in</td>
                         <td>no</td>
                         <td></td>
                         <td>The title of the relation.</td>
@@ -102,7 +96,6 @@
                     <tr>
                         <td>media</td>
                         <td>String</td>
-                        <td>in</td>
                         <td>no</td>
                         <td></td>
                         <td>Specifies on which device the document will be displayed.</td>

Copied: tapestry/tapestry4/trunk/src/site/xdoc/components/general/RenderBlock.xml (from r454604, tapestry/tapestry4/trunk/src/site/xdoc/components/RenderBlock.xml)
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/xdoc/components/general/RenderBlock.xml?view=diff&rev=463527&p1=tapestry/tapestry4/trunk/src/site/xdoc/components/RenderBlock.xml&r1=454604&p2=tapestry/tapestry4/trunk/src/site/xdoc/components/general/RenderBlock.xml&r2=463527
==============================================================================
--- tapestry/tapestry4/trunk/src/site/xdoc/components/RenderBlock.xml (original)
+++ tapestry/tapestry4/trunk/src/site/xdoc/components/general/RenderBlock.xml Thu Oct 12 17:28:41 2006
@@ -35,12 +35,12 @@
                 <p>
                 The
                 <a
-                    href="../tapestry-framework/apidocs/org/apache/tapestry/event/PageBeginRenderListener.html">
+                    href="../../tapestry-framework/apidocs/org/apache/tapestry/event/PageBeginRenderListener.html">
                     PageBeginRenderListener
                 </a>
                 (and
                 <a
-                    href="../tapestry-framework/apidocs/org/apache/tapestry/event/PageEndRenderListener.html">
+                    href="../../tapestry-framework/apidocs/org/apache/tapestry/event/PageEndRenderListener.html">
                     PageEndRenderListener
                 </a>
                 ) event notications only go to the
@@ -58,7 +58,7 @@
                 <strong>
                     See also:
                     <a
-                        href="../tapestry-framework/apidocs/org/apache/tapestry/components/RenderBlock.html">
+                        href="../../tapestry-framework/apidocs/org/apache/tapestry/components/RenderBlock.html">
                         org.apache.tapestry.components.RenderBlock
                     </a>
                     ,
@@ -73,7 +73,6 @@
                     <tr>
                         <th>Name</th>
                         <th>Type</th>
-                        <th>Direction</th>
                         <th>Required</th>
                         <th>Default</th>
                         <th>Description</th>
@@ -84,7 +83,6 @@
                         <td>
                             <a href="Block.html">Block</a>
                         </td>
-                        <td>in</td>
                         <td>yes</td>
                         <td></td>
                         <td>
@@ -119,7 +117,7 @@
                     <a href="RenderBlock.html">RenderBlock</a>
                     that invokes it (in 3.0, this property was called "inserter", which is
                     maintained for backwards compatibility). The parameters of the RenderBlock are
-                    available via the getParameter() method of
+                    available via the <code>getParameter()</code> method of
                     <a href="Block.html">Block</a>
                     . This is most useful when the RenderBlock and Block are contained within
                     different components or even different pages.
@@ -137,7 +135,7 @@
 
                 </p>
 
-                <img src="../images/ComponentReference/RenderBlock.png"
+                <img src="../../images/ComponentReference/RenderBlock.png"
                     alt="RenderBlock Screen Shot" />
 
                 <p>First we'll show a page that makes use of the TabPanel component.</p>
@@ -299,7 +297,7 @@
                 <p>
                     Several bindings in the specification depend on the tabSelected property, which
                     is a synthetic property calculated in Java code. In addition, the @
-                    <a href="DirectLink.html">DirectLink</a>
+                    <a href="../link/DirectLink.html">DirectLink</a>
                     component is configured to pass the block id in the URL as a listener parameter.
                 </p>
 

Copied: tapestry/tapestry4/trunk/src/site/xdoc/components/general/RenderBody.xml (from r454604, tapestry/tapestry4/trunk/src/site/xdoc/components/RenderBody.xml)
URL: http://svn.apache.org/viewvc/tapestry/tapestry4/trunk/src/site/xdoc/components/general/RenderBody.xml?view=diff&rev=463527&p1=tapestry/tapestry4/trunk/src/site/xdoc/components/RenderBody.xml&r1=454604&p2=tapestry/tapestry4/trunk/src/site/xdoc/components/general/RenderBody.xml&r2=463527
==============================================================================
--- tapestry/tapestry4/trunk/src/site/xdoc/components/RenderBody.xml (original)
+++ tapestry/tapestry4/trunk/src/site/xdoc/components/general/RenderBody.xml Thu Oct 12 17:28:41 2006
@@ -31,7 +31,7 @@
                 This component is very useful for creating a common navigational component used by
                 multiple pages of an application. Typically you create a common navigational
                 component which contains navigational links
-                <a href="PageLink.html">PageLink</a>
+                <a href="../link/PageLink.html">PageLink</a>
                 to other pages and a RenderBody component which will insert the actual content of
                 the page. The application pages then use the navigational component as their first
                 element, and then their usual content. When the pages renders, it renders the
@@ -79,7 +79,7 @@
                     application specific component. It is a common practice to use a Border
                     component to provide common layout to almost all of application pages.
                 </p>
-                <img src="../images/ComponentReference/RenderBody.png"
+                <img src="../../images/ComponentReference/RenderBody.png"
                     alt="RenderBody Screen Shot" />
                 <p>Template</p>
                 <source xml:space="preserve">