svn commit: r894291 - in /incubator/click/trunk/click/documentation/xdocs/src/docbook/click: chapter-configuration.xml chapter-introduction.xml chapter-pages.xml

[sa...@apache.org]

Author: sabob
Date: Tue Dec 29 01:16:38 2009
New Revision: 894291

URL: http://svn.apache.org/viewvc?rev=894291&view=rev
Log:
doco

Modified:
    incubator/click/trunk/click/documentation/xdocs/src/docbook/click/chapter-configuration.xml
    incubator/click/trunk/click/documentation/xdocs/src/docbook/click/chapter-introduction.xml
    incubator/click/trunk/click/documentation/xdocs/src/docbook/click/chapter-pages.xml

Modified: incubator/click/trunk/click/documentation/xdocs/src/docbook/click/chapter-configuration.xml
URL: http://svn.apache.org/viewvc/incubator/click/trunk/click/documentation/xdocs/src/docbook/click/chapter-configuration.xml?rev=894291&r1=894290&r2=894291&view=diff
==============================================================================
--- incubator/click/trunk/click/documentation/xdocs/src/docbook/click/chapter-configuration.xml (original)
+++ incubator/click/trunk/click/documentation/xdocs/src/docbook/click/chapter-configuration.xml Tue Dec 29 01:16:38 2009
@@ -570,10 +570,14 @@
       <sect3 id="application-autobinding-annotation" remap="h4">
         <title>Page Autobinding - Using Annotations</title>
 
-        <para>By default Click's autobinding feature operates on
-        <literal>public</literal> fields. However Click also provides the
+        <para>Click provides the
         <ulink url="../../click-api/org/apache/click/util/Bindable.html">Bindable</ulink>
-        annotation which allows you to annotate public Page fields.
+        annotation which enables autobinding of Page fields. The Bindable
+        annotation can bind private, protected and public Page fields.
+        However by default, Click's autobinding feature operates only on
+        <literal>public</literal> fields. The reason for this is keeping
+        backwards compatibility with earlier versions which did not support
+        the Bindable annotation.
         </para>
 
         <para>To enable Click to recognize the <symbol>@Bindable</symbol>

Modified: incubator/click/trunk/click/documentation/xdocs/src/docbook/click/chapter-introduction.xml
URL: http://svn.apache.org/viewvc/incubator/click/trunk/click/documentation/xdocs/src/docbook/click/chapter-introduction.xml?rev=894291&r1=894290&r2=894291&view=diff
==============================================================================
--- incubator/click/trunk/click/documentation/xdocs/src/docbook/click/chapter-introduction.xml (original)
+++ incubator/click/trunk/click/documentation/xdocs/src/docbook/click/chapter-introduction.xml Tue Dec 29 01:16:38 2009
@@ -180,7 +180,7 @@
 
     <calloutlist>
       <callout arearefs="co-bindable" id="ca-bindable">
-        <para>Variables declared as <literal>@Bindable protected</literal>
+        <para>Variables declared as <literal>@Bindable</literal>
         is a short-hand way of instructing Click to automatically bind request
         parameters to Page variables. Additionally these variables will be
         automatically added to the Page model. For more information please see the

Modified: incubator/click/trunk/click/documentation/xdocs/src/docbook/click/chapter-pages.xml
URL: http://svn.apache.org/viewvc/incubator/click/trunk/click/documentation/xdocs/src/docbook/click/chapter-pages.xml?rev=894291&r1=894290&r2=894291&view=diff
==============================================================================
--- incubator/click/trunk/click/documentation/xdocs/src/docbook/click/chapter-pages.xml (original)
+++ incubator/click/trunk/click/documentation/xdocs/src/docbook/click/chapter-pages.xml Tue Dec 29 01:16:38 2009
@@ -295,8 +295,10 @@
     <title>Request Parameter Auto Binding</title>
 
     <para>Click will automatically bind any request parameter values to public
-    Page fields with the same name. When binding these values it will also
-    attempt to convert them to the correct type.
+    Page fields with the same name. You can also use the
+    <ulink url="../../click-api/org/apache/click/util/Bindable.html">Bindable</ulink>
+    annotation to bind private and protected Page fields. When binding these
+    values Click will also attempt to convert them to the correct type.
     </para>
 
     <para>The best way to understand this is to walk through an example. Our