svn commit: r475142 - /incubator/wicket/branches/wicket-1.x/wicket/src/main/java/wicket/markup/html/list/ListView.java

[ivaynberg]

Author: ivaynberg
Date: Tue Nov 14 23:30:32 2006
New Revision: 475142

URL: http://svn.apache.org/viewvc?view=rev&rev=475142
Log:
WICKET-71: javadoc patch

Modified:
    
incubator/wicket/branches/wicket-1.x/wicket/src/main/java/wicket/markup/html/list/ListView.java

Modified: 
incubator/wicket/branches/wicket-1.x/wicket/src/main/java/wicket/markup/html/list/ListView.java
URL: 
http://svn.apache.org/viewvc/incubator/wicket/branches/wicket-1.x/wicket/src/main/java/wicket/markup/html/list/ListView.java?view=diff&rev=475142&r1=475141&r2=475142
==============================================================================
--- 
incubator/wicket/branches/wicket-1.x/wicket/src/main/java/wicket/markup/html/list/ListView.java
 (original)
+++ 
incubator/wicket/branches/wicket-1.x/wicket/src/main/java/wicket/markup/html/list/ListView.java
 Tue Nov 14 23:30:32 2006
@@ -38,10 +38,10 @@
  * Example:
  * 
  * <pre>
- *               &lt;tbody&gt;
- *                 &lt;tr wicket:id=&quot;rows&quot; class=&quot;even&quot;&gt;
- *                     &lt;td&gt;&lt;span wicket:id=&quot;id&quot;&gt;Test 
ID&lt;/span&gt;&lt;/td&gt;
- *                 ...    
+ *                  &lt;tbody&gt;
+ *                    &lt;tr wicket:id=&quot;rows&quot; 
class=&quot;even&quot;&gt;
+ *                        &lt;td&gt;&lt;span wicket:id=&quot;id&quot;&gt;Test 
ID&lt;/span&gt;&lt;/td&gt;
+ *                    ...    
  * </pre>
  * 
  * <p>
@@ -62,7 +62,19 @@
  * </pre>
  * 
  * <p>
- * WARNING: though you can nest ListViews within Forms, you HAVE to set the
+ * <strong>NOTE:</strong>
+ * 
+ * When you want to change the default generated markup it is important to
+ * realise that the ListView instance itself does not correspond to any markup,
+ * however, the generated ListItems do.<br/>
+ * 
+ * This means that methods like [EMAIL PROTECTED] #setRenderBodyOnly(boolean)} 
and
+ * [EMAIL PROTECTED] #add(wicket.behavior.IBehavior)} should be invoked on the
+ * [EMAIL PROTECTED] ListItem} that is given in [EMAIL PROTECTED] 
#populateItem(ListItem)} method.
+ * </p>
+ * 
+ * <p>
+ * <strong>WARNING:</strong> though you can nest ListViews within Forms, you 
HAVE to set the
  * optimizeItemRemoval property to true in order to have validation work
  * properly. By default, optimizeItemRemoval is false, which has the effect 
that
  * ListView replaces all child components by new instances. The idea behind 
this