You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@beehive.apache.org by ek...@apache.org on 2005/05/16 00:11:32 UTC

svn commit: r170271 [3/3] - in /incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding: datagrid/ invoke/

Modified: incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/ImageCell.java
URL: http://svn.apache.org/viewcvs/incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/ImageCell.java?rev=170271&r1=170270&r2=170271&view=diff
==============================================================================
--- incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/ImageCell.java (original)
+++ incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/ImageCell.java Sun May 15 15:11:30 2005
@@ -38,10 +38,19 @@
  * those that augment the available attribute set via the NetUI {@link org.apache.beehive.netui.tags.IAttributeConsumer}
  * interface.
  * </p>
- *
- * @jsptagref.tagdescription Data grid cell that renders an HTML &lt;image&gt; tag with the image source specified by
- * the tag's <code>source</code> attribute.
- * @netui:tag name="imageCell" description="" body-content="scriptless"
+ * <p>
+ * The set of JSP implicit objects available to the body include:
+ * <ul>
+ * <li><code>dataGridModel</code> -- the {@link org.apache.beehive.netui.databinding.datagrid.api.rendering.DataGridTagModel}
+ * for the cell's containing data grid.</li>
+ * <li><code>container</code> -- the {@link org.apache.beehive.netui.script.common.IDataAccessProvider} instance
+ * that exposes the current data item and the current item's index</li>
+ * </ul>
+ * </p>
+*
+ * @jsptagref.tagdescription
+ * @netui:tag name="imageCell" body-content="scriptless"
+ *            description=""
  */
 public class ImageCell
     extends AbstractHtmlTableCell
@@ -63,130 +72,130 @@
     }
 
     /**
-     * Sets the onClick javascript event on the image tag.
+     * Sets the onClick JavaScript event on the image tag.
      *
-     * @param onClick - the onClick event.
-     * @jsptagref.attributedescription The onClick javascript event on the image tag.
+     * @param onClick the onClick event.
+     * @jsptagref.attributedescription The onClick JavaScript event on the image tag.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onClick</i>
-     * @netui:attribute required="false" rtexprvalue="true" description="The onClick javascript event on the image tag."
+     * @netui:attribute required="false" rtexprvalue="true" description="The onClick JavaScript event on the image tag."
      */
     public void setOnClick(String onClick) {
         _imageState.registerAttribute(AbstractHtmlState.ATTR_JAVASCRIPT, HtmlConstants.ONCLICK, onClick);
     }
 
     /**
-     * Sets the onDblClick javascript event on the image tag.
+     * Sets the onDblClick JavaScript event on the image tag.
      *
-     * @param onDblClick - the onDblClick event.
-     * @jsptagref.attributedescription The onDblClick javascript event on the image tag.
+     * @param onDblClick the onDblClick event.
+     * @jsptagref.attributedescription The onDblClick JavaScript event on the image tag.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onDblClick</i>
-     * @netui:attribute required="false" rtexprvalue="true" description="The onDblClick javascript event on the image tag."
+     * @netui:attribute required="false" rtexprvalue="true" description="The onDblClick JavaScript event on the image tag."
      */
     public void setOnDblClick(String onDblClick) {
         _imageState.registerAttribute(AbstractHtmlState.ATTR_JAVASCRIPT, HtmlConstants.ONDBLCLICK, onDblClick);
     }
 
     /**
-     * Sets the onKeyDown javascript event on the image tag.
+     * Sets the onKeyDown JavaScript event on the image tag.
      *
-     * @param onKeyDown - the onKeyDown event.
-     * @jsptagref.attributedescription The onKeyDown javascript event on the image tag.
+     * @param onKeyDown the onKeyDown event.
+     * @jsptagref.attributedescription The onKeyDown JavaScript event on the image tag.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onKeyDown</i>
-     * @netui:attribute required="false" rtexprvalue="true" description="The onKeyDown javascript event on the image tag."
+     * @netui:attribute required="false" rtexprvalue="true" description="The onKeyDown JavaScript event on the image tag."
      */
     public void setOnKeyDown(String onKeyDown) {
         _imageState.registerAttribute(AbstractHtmlState.ATTR_JAVASCRIPT, HtmlConstants.ONKEYDOWN, onKeyDown);
     }
 
     /**
-     * Sets the onKeyUp javascript event on the image tag.
+     * Sets the onKeyUp JavaScript event on the image tag.
      *
-     * @param onKeyUp - the onKeyUp event.
-     * @jsptagref.attributedescription The onKeyUp javascript event on the image tag.
+     * @param onKeyUp the onKeyUp event.
+     * @jsptagref.attributedescription The onKeyUp JavaScript event on the image tag.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onKeyUp</i>
-     * @netui:attribute required="false" rtexprvalue="true" description="The onKeyUp javascript event on the image tag."
+     * @netui:attribute required="false" rtexprvalue="true" description="The onKeyUp JavaScript event on the image tag."
      */
     public void setOnKeyUp(String onKeyUp) {
         _imageState.registerAttribute(AbstractHtmlState.ATTR_JAVASCRIPT, HtmlConstants.ONKEYUP, onKeyUp);
     }
 
     /**
-     * Sets the onKeyPress javascript event on the image tag.
+     * Sets the onKeyPress JavaScript event on the image tag.
      *
-     * @param onKeyPress - the onKeyPress event.
-     * @jsptagref.attributedescription The onKeyPress javascript event on the image tag.
+     * @param onKeyPress the onKeyPress event.
+     * @jsptagref.attributedescription The onKeyPress JavaScript event on the image tag.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onKeyPress</i>
-     * @netui:attribute required="false" rtexprvalue="true" description="The onKeyPress javascript event on the image tag."
+     * @netui:attribute required="false" rtexprvalue="true" description="The onKeyPress JavaScript event on the image tag."
      */
     public void setOnKeyPress(String onKeyPress) {
         _imageState.registerAttribute(AbstractHtmlState.ATTR_JAVASCRIPT, HtmlConstants.ONKEYPRESS, onKeyPress);
     }
 
     /**
-     * Sets the onMouseDown javascript event on the image tag.
+     * Sets the onMouseDown JavaScript event on the image tag.
      *
-     * @param onMouseDown - the onMouseDown event.
-     * @jsptagref.attributedescription The onMouseDown javascript event on the image tag.
+     * @param onMouseDown the onMouseDown event.
+     * @jsptagref.attributedescription The onMouseDown JavaScript event on the image tag.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onMouseDown</i>
-     * @netui:attribute required="false" rtexprvalue="true" description="The onMouseDown javascript event on the image tag."
+     * @netui:attribute required="false" rtexprvalue="true" description="The onMouseDown JavaScript event on the image tag."
      */
     public void setOnMouseDown(String onMouseDown) {
         _imageState.registerAttribute(AbstractHtmlState.ATTR_JAVASCRIPT, HtmlConstants.ONMOUSEDOWN, onMouseDown);
     }
 
     /**
-     * Sets the onMouseUp javascript event on the image tag.
+     * Sets the onMouseUp JavaScript event on the image tag.
      *
-     * @param onMouseUp - the onMouseUp event.
-     * @jsptagref.attributedescription The onMouseUp javascript event on the image tag.
+     * @param onMouseUp the onMouseUp event.
+     * @jsptagref.attributedescription The onMouseUp JavaScript event on the image tag.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onMouseUp</i>
-     * @netui:attribute required="false" rtexprvalue="true" description="The onMouseUp javascript event on the image tag."
+     * @netui:attribute required="false" rtexprvalue="true" description="The onMouseUp JavaScript event on the image tag."
      */
     public void setOnMouseUp(String onMouseUp) {
         _imageState.registerAttribute(AbstractHtmlState.ATTR_JAVASCRIPT, HtmlConstants.ONMOUSEUP, onMouseUp);
     }
 
     /**
-     * Sets the onMouseMove javascript event on the image tag.
+     * Sets the onMouseMove JavaScript event on the image tag.
      *
-     * @param onMouseMove - the onMouseMove event.
-     * @jsptagref.attributedescription The onMouseMove javascript event on the image tag.
+     * @param onMouseMove the onMouseMove event.
+     * @jsptagref.attributedescription The onMouseMove JavaScript event on the image tag.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onMouseMove</i>
-     * @netui:attribute required="false" rtexprvalue="true" description="The onMouseMove javascript event on the image tag."
+     * @netui:attribute required="false" rtexprvalue="true" description="The onMouseMove JavaScript event on the image tag."
      */
     public void setOnMouseMove(String onMouseMove) {
         _imageState.registerAttribute(AbstractHtmlState.ATTR_JAVASCRIPT, HtmlConstants.ONMOUSEMOVE, onMouseMove);
     }
 
     /**
-     * Sets the onMouseOut javascript event on the image tag.
+     * Sets the onMouseOut JavaScript event on the image tag.
      *
-     * @param onMouseOut - the onMouseOut event.
-     * @jsptagref.attributedescription The onMouseOut javascript event on the image tag.
+     * @param onMouseOut the onMouseOut event.
+     * @jsptagref.attributedescription The onMouseOut JavaScript event on the image tag.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onMouseOut</i>
-     * @netui:attribute required="false" rtexprvalue="true" description="The onMouseOut javascript event on the image tag."
+     * @netui:attribute required="false" rtexprvalue="true" description="The onMouseOut JavaScript event on the image tag."
      */
     public void setOnMouseOut(String onMouseOut) {
         _imageState.registerAttribute(AbstractHtmlState.ATTR_JAVASCRIPT, HtmlConstants.ONMOUSEOUT, onMouseOut);
     }
 
     /**
-     * Sets the onMouseOver javascript event on the image tag.
+     * Sets the onMouseOver JavaScript event on the image tag.
      *
-     * @param onMouseOver - the onMouseOver event.
-     * @jsptagref.attributedescription The onMouseOver javascript event on the image tag.
+     * @param onMouseOver the onMouseOver event.
+     * @jsptagref.attributedescription The onMouseOver JavaScript event on the image tag.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onMouseOver</i>
-     * @netui:attribute required="false" rtexprvalue="true" description="The onMouseOver javascript event on the image tag."
+     * @netui:attribute required="false" rtexprvalue="true" description="The onMouseOver JavaScript event on the image tag."
      */
     public void setOnMouseOver(String onMouseOver) {
         _imageState.registerAttribute(AbstractHtmlState.ATTR_JAVASCRIPT, HtmlConstants.ONMOUSEOVER, onMouseOver);
@@ -195,7 +204,7 @@
     /**
      * Sets the style of the rendered html tag.
      *
-     * @param style - the html style.
+     * @param style the html style.
      * @jsptagref.attributedescription The style.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_style</i>
@@ -210,7 +219,7 @@
     /**
      * Sets the style class of the rendered html tag.
      *
-     * @param styleClass - the html style class.
+     * @param styleClass the html style class.
      * @jsptagref.attributedescription The style class.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_style_class</i>
@@ -277,7 +286,7 @@
     /**
      * Sets the property to specify where to align the image.
      *
-     * @param align - the image alignment.
+     * @param align the image alignment.
      * @jsptagref.attributedescription The alignment of the image.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_align</i>
@@ -290,7 +299,7 @@
     /**
      * Sets the the horizontal spacing around the image.
      *
-     * @param hspace - the horizontal spacing.
+     * @param hspace the horizontal spacing.
      * @jsptagref.attributedescription The horizontal spacing around the image.
      * @jsptagref.databindable Read Only
      * @jsptagref.attributesyntaxvalue <i>integer_hspace</i>
@@ -351,7 +360,7 @@
     /**
      * Sets the property to specify the longdesc of the image tag.
      *
-     * @param longdesc - the longdesc attribute
+     * @param longdesc the longdesc attribute
      * @jsptagref.attributedescription The alternative text of the image tag
      * @jsptagref.databindable Read Only
      * @jsptagref.attributesyntaxvalue <i>string_longdesc</i>
@@ -364,7 +373,7 @@
     /**
      * Sets the property to specify the alt text of the image tag.
      *
-     * @param alt - the image alignment.
+     * @param alt the image alignment.
      * @jsptagref.attributedescription The alternative text of the image tag
      * @jsptagref.databindable Read Only
      * @jsptagref.attributesyntaxvalue <i>string_alt</i>
@@ -377,7 +386,7 @@
     /**
      * Set the name of the tagId for the image tag.
      *
-     * @param tagId - the the name of the tagId for the image tag.
+     * @param tagId the the name of the tagId for the image tag.
      * @jsptagref.attributedescription The tagId.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_tagId</i>
@@ -433,6 +442,12 @@
         DECORATOR.decorate(getJspContext(), appender, _imageCellModel);
     }
 
+    /**
+     * Implementation of {@link AbstractHtmlTableCell#internalGetCellModel()} that exposes the
+     * {@link org.apache.beehive.netui.databinding.datagrid.runtime.model.cell.ImageCellModel}
+     * which is storing state for this tag.
+     * @return this tag's image cell model
+     */
     protected CellModel internalGetCellModel() {
         return _imageCellModel;
     }

Modified: incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/RenderPager.java
URL: http://svn.apache.org/viewcvs/incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/RenderPager.java?rev=170271&r1=170270&r2=170271&view=diff
==============================================================================
--- incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/RenderPager.java (original)
+++ incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/RenderPager.java Sun May 15 15:11:30 2005
@@ -42,7 +42,26 @@
  * </pre>
  * </p>
  *
- * @jsptagref.tagdescription Data grid tag used to render the grid's pager at a specific location in a JSP.
+ * @jsptagref.tagdescription
+ * <p>
+ * Data grid tag used to render the grid's pager at a specific location in a JSP.  By default,
+ * the data grid renders its pager in a fixed location.  In order to change the location of the pager,
+ * this tag can be used to move the rendered pager or to render multiple pagers.  For example, to render
+ * a pager in both the grid's header and footer, the tag can be used as:
+ * <pre>
+ *     <netui-data:header>
+ *         ....
+ *         <netui-data;renderPager/>
+ *         ....
+ *     </netui-data:header>
+ *     <netui-data:footer>
+ *         ....
+ *         <netui-data;renderPager/>
+ *         ....
+ *     </netui-data:footer>
+ * </pre>
+ * </p>
+ *
  * @netui:tag name="renderPager" body-content="empty"
  * description="Data grid tag used to render the grid's pager at a specific location in a JSP."
  */
@@ -64,7 +83,6 @@
      * {@link org.apache.beehive.netui.databinding.datagrid.api.rendering.PagerRenderer} into the
      * page's output.
      * </p>
-     *
      * @throws JspException when an error occurs rendering or no {@link DataGridTagModel} can be found.
      */
     public void doTag()

Modified: incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/Row.java
URL: http://svn.apache.org/viewcvs/incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/Row.java?rev=170271&r1=170270&r2=170271&view=diff
==============================================================================
--- incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/Row.java (original)
+++ incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/Row.java Sun May 15 15:11:30 2005
@@ -50,9 +50,9 @@
     }
 
     /**
-     * Sets the onClick javascript event.
+     * Sets the onClick JavaScript event.
      *
-     * @param onClick - the onClick event.
+     * @param onClick the onClick event.
      * @jsptagref.attributedescription The onClick JavaScript event.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onClick</i>
@@ -63,9 +63,9 @@
     }
 
     /**
-     * Sets the onDblClick javascript event.
+     * Sets the onDblClick JavaScript event.
      *
-     * @param onDblClick - the onDblClick event.
+     * @param onDblClick the onDblClick event.
      * @jsptagref.attributedescription The onDblClick JavaScript event.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onDblClick</i>
@@ -76,9 +76,9 @@
     }
 
     /**
-     * Sets the onKeyDown javascript event.
+     * Sets the onKeyDown JavaScript event.
      *
-     * @param onKeyDown - the onKeyDown event.
+     * @param onKeyDown the onKeyDown event.
      * @jsptagref.attributedescription The onKeyDown JavaScript event.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onKeyDown</i>
@@ -89,9 +89,9 @@
     }
 
     /**
-     * Sets the onKeyUp javascript event.
+     * Sets the onKeyUp JavaScript event.
      *
-     * @param onKeyUp - the onKeyUp event.
+     * @param onKeyUp the onKeyUp event.
      * @jsptagref.attributedescription The onKeyUp JavaScript event.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onKeyUp</i>
@@ -102,9 +102,9 @@
     }
 
     /**
-     * Sets the onKeyPress javascript event.
+     * Sets the onKeyPress JavaScript event.
      *
-     * @param onKeyPress - the onKeyPress event.
+     * @param onKeyPress the onKeyPress event.
      * @jsptagref.attributedescription The onKeyPress JavaScript event.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onKeyPress</i>
@@ -115,9 +115,9 @@
     }
 
     /**
-     * Sets the onMouseDown javascript event.
+     * Sets the onMouseDown JavaScript event.
      *
-     * @param onMouseDown - the onMouseDown event.
+     * @param onMouseDown the onMouseDown event.
      * @jsptagref.attributedescription The onMouseDown JavaScript event.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onMouseDown</i>
@@ -128,9 +128,9 @@
     }
 
     /**
-     * Sets the onMouseUp javascript event.
+     * Sets the onMouseUp JavaScript event.
      *
-     * @param onMouseUp - the onMouseUp event.
+     * @param onMouseUp the onMouseUp event.
      * @jsptagref.attributedescription The onMouseUp JavaScript event.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onMouseUp</i>
@@ -141,9 +141,9 @@
     }
 
     /**
-     * Sets the onMouseMove javascript event.
+     * Sets the onMouseMove JavaScript event.
      *
-     * @param onMouseMove - the onMouseMove event.
+     * @param onMouseMove the onMouseMove event.
      * @jsptagref.attributedescription The onMouseMove JavaScript event.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onMouseMove</i>
@@ -154,9 +154,9 @@
     }
 
     /**
-     * Sets the onMouseOut javascript event.
+     * Sets the onMouseOut JavaScript event.
      *
-     * @param onMouseOut - the onMouseOut event.
+     * @param onMouseOut the onMouseOut event.
      * @jsptagref.attributedescription The onMouseOut JavaScript event.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onMouseOut</i>
@@ -167,9 +167,9 @@
     }
 
     /**
-     * Sets the onMouseOver javascript event.
+     * Sets the onMouseOver JavaScript event.
      *
-     * @param onMouseOver - the onMouseOver event.
+     * @param onMouseOver the onMouseOver event.
      * @jsptagref.attributedescription The onMouseOver JavaScript event.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onMouseOver</i>
@@ -182,7 +182,7 @@
     /**
      * Sets the style of the rendered html tag.
      *
-     * @param style - the html style.
+     * @param style the html style.
      * @jsptagref.attributedescription The style.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_style</i>
@@ -197,7 +197,7 @@
     /**
      * Sets the style class of the rendered html tag.
      *
-     * @param styleClass - the html style class.
+     * @param styleClass the html style class.
      * @jsptagref.attributedescription The style class.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_style_class</i>
@@ -253,7 +253,7 @@
     /**
      * Set the name of the tagId for the table row.
      *
-     * @param tagId - the the name of the tagId for the table row.
+     * @param tagId the the name of the tagId for the table row.
      * @jsptagref.attributedescription The tagId.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_tagId</i>

Modified: incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/Rows.java
URL: http://svn.apache.org/viewcvs/incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/Rows.java?rev=170271&r1=170270&r2=170271&view=diff
==============================================================================
--- incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/Rows.java (original)
+++ incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/Rows.java Sun May 15 15:11:30 2005
@@ -41,9 +41,42 @@
 import org.apache.beehive.netui.util.Bundle;
 
 /**
- * @jsptagref.tagdescription Container tag for columns that will render in the data grid.
- * @netui:tag name="rows" description="Container tag for columns that will render in the grid."
- * body-content="scriptless"
+ * <p>
+ * The Rows tag is used to render a table row(s) that contain the data from a data set displayed
+ * in a data grid.  The rows rendered here render after the header reders with the {@link Header} and before
+ * the footer renders in the {@link Footer}.  The body of this tag usually contains the data grid's "cell" tags
+ * which are used to render HTML table cells inside of the rows rendered by this tag.  Such tags include:
+ * <ul>
+ * <li>{@link AnchorCell} which is used to render anchors</li>
+ * <li>{@link ImageAnchorCell} which is used to render clickable images</li>
+ * <li>{@link ImageCell} which is used to render an image</li>
+ * <li>{@link SpanCell} which is used to render an HTML span with data bound content</li>
+ * <li>{@link TemplateCell} which can contain arbitrary content for {@link javax.servlet.jsp.tagext.SimpleTag}</li>
+ * </ul>
+ * </p>
+ * <p>
+ * The attribute setters in this class are used to add attributes to the &lt;tbody&gt; tag which will be rendered
+ * when row groups are enabled.  When row group rendering is disabled, attributes set here do not render.
+ * </p>
+ * <p>
+ * Because this tag renders inside of an HTML table, it by default renders an HTML
+ * &lt;tr&gt; tag to represent a table row.  Table row tag rendering can be disabled using the {@link #setRenderRow(boolean)}
+ * attribute.  When this is disabled, the page author is responsible for maintaining the integrity of the
+ * HTML table by writing &lt;tr&gt; tags manually or by using the {@link Row} tag.  When this tag is rendering
+ * it does not produce table cells; the contents of the table row in the footer is entirely left to the
+ * page author.  With row rendering disabled, it is also possible to add multiple table rows to the
+ * end of a data grid.
+ * </p>
+ * <p>
+ * The set of JSP implicit objects available to the body include:
+ * <ul>
+ * <li><code>dataGridModel</code> -- the {@link org.apache.beehive.netui.databinding.datagrid.api.rendering.DataGridTagModel}
+ * for the cell's containing data grid.</li>
+ * </ul>
+ * </p>
+ * @jsptagref.tagdescription
+ * @netui:tag name="rows" body-content="scriptless"
+ *            description="Renders the data rows into a NetUI data grid"
  */
 public class Rows
     extends AbstractDataGridHtmlTag
@@ -57,143 +90,143 @@
     }
 
     /**
-     * Sets the onClick javascript event.
+     * Sets the onClick JavaScript event for the HTML tbody tag.
      *
-     * @param onClick - the onClick event.
-     * @jsptagref.attributedescription The onClick JavaScript event.
+     * @param onClick the onClick event.
+     * @jsptagref.attributedescription The onClick JavaScript event for the HTML tbody tag.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onClick</i>
-     * @netui:attribute required="false" rtexprvalue="true" description="The onClick JavaScript event."
+     * @netui:attribute required="false" rtexprvalue="true" description="The onClick JavaScript event for the HTML tbody tag."
      */
     public void setOnClick(String onClick) {
         _tbodyTag.registerAttribute(AbstractHtmlState.ATTR_JAVASCRIPT, HtmlConstants.ONCLICK, onClick);
     }
 
     /**
-     * Sets the onDblClick javascript event.
+     * Sets the onDblClick JavaScript event for the HTML tbody tag.
      *
-     * @param onDblClick - the onDblClick event.
-     * @jsptagref.attributedescription The onDblClick JavaScript event.
+     * @param onDblClick the onDblClick event.
+     * @jsptagref.attributedescription The onDblClick JavaScript event for the HTML tbody tag.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onDblClick</i>
-     * @netui:attribute required="false" rtexprvalue="true" description="The onDblClick JavaScript event."
+     * @netui:attribute required="false" rtexprvalue="true" description="The onDblClick JavaScript event for the HTML tbody tag."
      */
     public void setOnDblClick(String onDblClick) {
         _tbodyTag.registerAttribute(AbstractHtmlState.ATTR_JAVASCRIPT, HtmlConstants.ONDBLCLICK, onDblClick);
     }
 
     /**
-     * Sets the onKeyDown javascript event.
+     * Sets the onKeyDown JavaScript event for the HTML tbody tag.
      *
-     * @param onKeyDown - the onKeyDown event.
-     * @jsptagref.attributedescription The onKeyDown JavaScript event.
+     * @param onKeyDown the onKeyDown event.
+     * @jsptagref.attributedescription The onKeyDown JavaScript event for the HTML tbody tag.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onKeyDown</i>
-     * @netui:attribute required="false" rtexprvalue="true" description="The onKeyDown JavaScript event."
+     * @netui:attribute required="false" rtexprvalue="true" description="The onKeyDown JavaScript event for the HTML tbody tag."
      */
     public void setOnKeyDown(String onKeyDown) {
         _tbodyTag.registerAttribute(AbstractHtmlState.ATTR_JAVASCRIPT, HtmlConstants.ONKEYDOWN, onKeyDown);
     }
 
     /**
-     * Sets the onKeyUp javascript event.
+     * Sets the onKeyUp JavaScript event for the HTML tbody tag.
      *
-     * @param onKeyUp - the onKeyUp event.
-     * @jsptagref.attributedescription The onKeyUp JavaScript event.
+     * @param onKeyUp the onKeyUp event.
+     * @jsptagref.attributedescription The onKeyUp JavaScript event for the HTML tbody tag.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onKeyUp</i>
-     * @netui:attribute required="false" rtexprvalue="true" description="The onKeyUp JavaScript event."
+     * @netui:attribute required="false" rtexprvalue="true" description="The onKeyUp JavaScript event for the HTML tbody tag."
      */
     public void setOnKeyUp(String onKeyUp) {
         _tbodyTag.registerAttribute(AbstractHtmlState.ATTR_JAVASCRIPT, HtmlConstants.ONKEYUP, onKeyUp);
     }
 
     /**
-     * Sets the onKeyPress javascript event.
+     * Sets the onKeyPress JavaScript event for the HTML tbody tag.
      *
-     * @param onKeyPress - the onKeyPress event.
-     * @jsptagref.attributedescription The onKeyPress JavaScript event.
+     * @param onKeyPress the onKeyPress event.
+     * @jsptagref.attributedescription The onKeyPress JavaScript event for the HTML tbody tag.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onKeyPress</i>
-     * @netui:attribute required="false" rtexprvalue="true" description="The onKeyPress JavaScript event."
+     * @netui:attribute required="false" rtexprvalue="true" description="The onKeyPress JavaScript event for the HTML tbody tag."
      */
     public void setOnKeyPress(String onKeyPress) {
         _tbodyTag.registerAttribute(AbstractHtmlState.ATTR_JAVASCRIPT, HtmlConstants.ONKEYPRESS, onKeyPress);
     }
 
     /**
-     * Sets the onMouseDown javascript event.
+     * Sets the onMouseDown JavaScript event for the HTML tbody tag.
      *
-     * @param onMouseDown - the onMouseDown event.
-     * @jsptagref.attributedescription The onMouseDown JavaScript event.
+     * @param onMouseDown the onMouseDown event.
+     * @jsptagref.attributedescription The onMouseDown JavaScript event for the HTML tbody tag.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onMouseDown</i>
-     * @netui:attribute required="false" rtexprvalue="true" description="The onMouseDown JavaScript event."
+     * @netui:attribute required="false" rtexprvalue="true" description="The onMouseDown JavaScript event for the HTML tbody tag."
      */
     public void setOnMouseDown(String onMouseDown) {
         _tbodyTag.registerAttribute(AbstractHtmlState.ATTR_JAVASCRIPT, HtmlConstants.ONMOUSEDOWN, onMouseDown);
     }
 
     /**
-     * Sets the onMouseUp javascript event.
+     * Sets the onMouseUp JavaScript event for the HTML tbody tag.
      *
-     * @param onMouseUp - the onMouseUp event.
-     * @jsptagref.attributedescription The onMouseUp JavaScript event.
+     * @param onMouseUp the onMouseUp event.
+     * @jsptagref.attributedescription The onMouseUp JavaScript event for the HTML tbody tag.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onMouseUp</i>
-     * @netui:attribute required="false" rtexprvalue="true" description="The onMouseUp JavaScript event."
+     * @netui:attribute required="false" rtexprvalue="true" description="The onMouseUp JavaScript event for the HTML tbody tag."
      */
     public void setOnMouseUp(String onMouseUp) {
         _tbodyTag.registerAttribute(AbstractHtmlState.ATTR_JAVASCRIPT, HtmlConstants.ONMOUSEUP, onMouseUp);
     }
 
     /**
-     * Sets the onMouseMove javascript event.
+     * Sets the onMouseMove JavaScript event for the HTML tbody tag.
      *
-     * @param onMouseMove - the onMouseMove event.
-     * @jsptagref.attributedescription The onMouseMove JavaScript event.
+     * @param onMouseMove the onMouseMove event.
+     * @jsptagref.attributedescription The onMouseMove JavaScript event for the HTML tbody tag.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onMouseMove</i>
-     * @netui:attribute required="false" rtexprvalue="true" description="The onMouseMove JavaScript event."
+     * @netui:attribute required="false" rtexprvalue="true" description="The onMouseMove JavaScript event for the HTML tbody tag."
      */
     public void setOnMouseMove(String onMouseMove) {
         _tbodyTag.registerAttribute(AbstractHtmlState.ATTR_JAVASCRIPT, HtmlConstants.ONMOUSEMOVE, onMouseMove);
     }
 
     /**
-     * Sets the onMouseOut javascript event.
+     * Sets the onMouseOut JavaScript event for the HTML tbody tag.
      *
-     * @param onMouseOut - the onMouseOut event.
-     * @jsptagref.attributedescription The onMouseOut JavaScript event.
+     * @param onMouseOut the onMouseOut event.
+     * @jsptagref.attributedescription The onMouseOut JavaScript event for the HTML tbody tag.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onMouseOut</i>
-     * @netui:attribute required="false" rtexprvalue="true" description="The onMouseOut JavaScript event."
+     * @netui:attribute required="false" rtexprvalue="true" description="The onMouseOut JavaScript event for the HTML tbody tag."
      */
     public void setOnMouseOut(String onMouseOut) {
         _tbodyTag.registerAttribute(AbstractHtmlState.ATTR_JAVASCRIPT, HtmlConstants.ONMOUSEOUT, onMouseOut);
     }
 
     /**
-     * Sets the onMouseOver javascript event.
+     * Sets the onMouseOver JavaScript event for the HTML tbody tag.
      *
-     * @param onMouseOver - the onMouseOver event.
-     * @jsptagref.attributedescription The onMouseOver JavaScript event.
+     * @param onMouseOver the onMouseOver event.
+     * @jsptagref.attributedescription The onMouseOver JavaScript event for the HTML tbody tag.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onMouseOver</i>
-     * @netui:attribute required="false" rtexprvalue="true" description="The onMouseOver JavaScript event."
+     * @netui:attribute required="false" rtexprvalue="true" description="The onMouseOver JavaScript event for the HTML tbody tag."
      */
     public void setOnMouseOver(String onMouseOver) {
         _tbodyTag.registerAttribute(AbstractHtmlState.ATTR_JAVASCRIPT, HtmlConstants.ONMOUSEOVER, onMouseOver);
     }
 
     /**
-     * Sets the style of the rendered html tag.
+     * Sets the style of the HTML tbody tag.
      *
-     * @param style - the html style.
-     * @jsptagref.attributedescription The style.
+     * @param style the style
+     * @jsptagref.attributedescription The style of the HTML tbody tag.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_style</i>
-     * @netui:attribute required="false"  rtexprvalue="true" description="The style."
+     * @netui:attribute required="false"  rtexprvalue="true" description="The style of the HTML tbody tag."
      */
     public void setStyle(String style) {
         if("".equals(style)) return;
@@ -202,13 +235,13 @@
     }
 
     /**
-     * Sets the style class of the rendered html tag.
+     * Sets the style class of the HTML tbody tag.
      *
-     * @param styleClass - the html style class.
-     * @jsptagref.attributedescription The style class.
+     * @param styleClass the style class
+     * @jsptagref.attributedescription The style class of the HTML tbody tag.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_style_class</i>
-     * @netui:attribute required="false"  rtexprvalue="true" description="The style class."
+     * @netui:attribute required="false"  rtexprvalue="true" description="The style class of the HTML tbody tag."
      */
     public void setStyleClass(String styleClass) {
         if("".equals(styleClass)) return;
@@ -217,26 +250,26 @@
     }
 
     /**
-     * Sets the value of the title attribute.
+     * Sets the value of the title attribute for the HTML tbody tag.
      *
-     * @param title
-     * @jsptagref.attributedescription The title.
+     * @param title the title
+     * @jsptagref.attributedescription The title for the HTML tbody tag
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_title</i>
-     * @netui:attribute required="false" rtexprvalue="true" description="The title. "
+     * @netui:attribute required="false" rtexprvalue="true" description="The title for the HTML tbody tag"
      */
     public void setTitle(String title) {
         _tbodyTag.registerAttribute(AbstractHtmlState.ATTR_GENERAL, HtmlConstants.TITLE, title);
     }
 
     /**
-     * Sets the value of the horizontal align attribute.
-     *
-     * @param align
-     * @jsptagref.attributedescription The horizontal alignment.
+     * Sets the value of the horizontal alignment attribute of the HTML tbody tag.
+
+     * @param align the horizontal alignment
+     * @jsptagref.attributedescription The horizontal alignment of the HTML tbody tag.
      * @jsptagref.databindable true
      * @jsptagref.attributesyntaxvalue <i>string_align</i>
-     * @netui:attribute required="false" rtexprvalue="true" description="The cell's horizontal alignment"
+     * @netui:attribute required="false" rtexprvalue="true" description="The cell's horizontal alignment of the HTML tbody tag."
      */
     public void setAlign(String align) {
         /* todo: should this enforce left|center|right|justify|char as in the spec */
@@ -244,13 +277,13 @@
     }
 
     /**
-     * Sets the value of the horizontal alignment character attribute.
+     * Sets the value of the horizontal alignment character attribute of the HTML tbody tag.
      *
-     * @param alignChar
-     * @jsptagref.attributedescription The horizontal alignment character.
+     * @param alignChar the horizontal alignment character
+     * @jsptagref.attributedescription The horizontal alignment character of the HTML tbody tag.
      * @jsptagref.databindable true
      * @jsptagref.attributesyntaxvalue <i>string_alignChar</i>
-     * @netui:attribute required="false" rtexprvalue="true" description="The cell's horizontal alignment character"
+     * @netui:attribute required="false" rtexprvalue="true" description="The cell's horizontal alignment character of the HTML tbody tag."
      */
     public void setChar(String alignChar) {
         _tbodyTag.registerAttribute(AbstractHtmlState.ATTR_GENERAL, HtmlConstants.CHAR, alignChar);
@@ -270,13 +303,13 @@
     }
 
     /**
-     * Sets the value of the vertical alignment attribute.
+     * Sets the value of the vertical alignment attribute of the HTML tbody tag.
      *
-     * @param align
+     * @param align the alignment
      * @jsptagref.attributedescription The vertical alignment.
      * @jsptagref.databindable true
      * @jsptagref.attributesyntaxvalue <i>string_align</i>
-     * @netui:attribute required="false" rtexprvalue="true" description="The cell's vertical alignment"
+     * @netui:attribute required="false" rtexprvalue="true" description="The vertical alignment of the HTML tbody tag"
      */
     public void setValign(String align) {
         /* todo: should this enforce top|middle|bottom|baseline as in the spec */
@@ -284,40 +317,37 @@
     }
 
     /**
-     * Sets the value of the language attribute.
+     * Sets the value of the language attribute of the HTML tbody tag.
      *
-     * @param lang
-     * @jsptagref.attributedescription The language.
-     * @jsptagref.databindable true
+     * @param lang the language
+     * @jsptagref.attributedescription The language of the HTML tbody tag.
      * @jsptagref.attributesyntaxvalue <i>string_lang</i>
-     * @netui:attribute required="false" rtexprvalue="true" description="The cell's language"
+     * @netui:attribute required="false" rtexprvalue="true" description="The language of the HTML tbody tag."
      */
     public void setLang(String lang) {
         _tbodyTag.registerAttribute(AbstractHtmlState.ATTR_GENERAL, HtmlConstants.LANG, lang);
     }
 
     /**
-     * Sets the value of the text direction attribute.
+     * Sets the value of the text direction attribute of the HTML tbody tag.
      *
-     * @param dir
-     * @jsptagref.attributedescription The text direction attribute.
-     * @jsptagref.databindable true
+     * @param dir the dir
+     * @jsptagref.attributedescription The text direction attribute of the HTML tbody tag.
      * @jsptagref.attributesyntaxvalue <i>string_dir</i>
-     * @netui:attribute required="false" rtexprvalue="true" description="The cell's text direction"
+     * @netui:attribute required="false" rtexprvalue="true" description="The text direction of the HTML tbody tag.
      */
     public void setDir(String dir) {
         _tbodyTag.registerAttribute(AbstractHtmlState.ATTR_GENERAL, HtmlConstants.DIR, dir);
     }
 
     /**
-     * Set the name of the tagId for the tbody tag.
+     * Set the name of the tagId for the HTML tbody tag.
      *
      * @param tagId - the the name of the tagId for the tbody tag.
-     * @jsptagref.attributedescription The tagId.
-     * @jsptagref.databindable false
+     * @jsptagref.attributedescription The tagId of the HTML tbody tag.
      * @jsptagref.attributesyntaxvalue <i>string_tagId</i>
      * @netui:attribute required="false" rtexprvalue="true"
-     * description="String value. Sets the id (or name) attribute of the rendered HTML tag. "
+     * description="String value. Sets the id (or name) attribute of the HTML tbody tag."
      */
     public void setTagId(String tagId)
         throws JspException {
@@ -325,12 +355,33 @@
     }
 
     /**
+     * Set a boolean that enables / disables rendering HTML table rows by this tag.  If the
+     * value is enabled, an HTML &lt;tr&gt; will be rendered when this tag renders its body.  If
+     * the value is disabled, no &lt;tr&gt; tags will be rendered and the page author is responsible
+     * for maintaining the integrity of the HTML table.
+     * @jsptagref.attributedescription
+     * Set a boolean that enables / disables rendering HTML table rows by this tag.  If the
+     * value is enabled, an HTML &lt;tr&gt; will be rendered when this tag renders its body.  If
+     * the value is disabled, no &lt;tr&gt; tags will be rendered and the page author is responsible
+     * for maintaining the integrity of the HTML table.
+     * @jsptagref.attributesyntaxvalue <i>boolean_renderRow</i>
      * @netui:attribute required="false" rtexprvalue="true"
+     *                  description="Boolean to enable / disable rendering HTML table row tags"
      */
     public void setRenderRow(boolean renderRow) {
         _renderRow = renderRow;
     }
 
+    /**
+     * Render this tag.  This method renders during the data grid's {@link DataGridTagModel#RENDER_STATE_GRID}
+     * state in order to add table rows to the beginning of a data grid's HTML table.  If the data grid is rendering
+     * HTML row groups, this tag will output an HTML &lt;tbody&gt; tag.  Then, if this tag is rendering
+     * a table row, it will produce an HTML &lt;tr&gt; tag.  Then the content of the body will be rendered.  If
+     * table row rendering is disabled, the page author is responsible for rendering the appropriate HTML
+     * table row tags as this tag renders inside of the HTML table opened by the data grid.
+     * @throws IOException
+     * @throws JspException when the {@link DataGridTagModel} can not be found in the {@link JspContext}
+     */
     public void doTag()
         throws IOException, JspException {
 

Modified: incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/SpanCell.java
URL: http://svn.apache.org/viewcvs/incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/SpanCell.java?rev=170271&r1=170270&r2=170271&view=diff
==============================================================================
--- incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/SpanCell.java (original)
+++ incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/SpanCell.java Sun May 15 15:11:30 2005
@@ -40,12 +40,35 @@
  * those that provide formatting via the NetUI {@link IFormattable} interface and those that augment the
  * available attribute set via the NetUI {@link org.apache.beehive.netui.tags.IAttributeConsumer} interface.
  * </p>
+ * <p>
+ * The set of JSP implicit objects available to the body include:
+ * <ul>
+ * <li><code>dataGridModel</code> -- the {@link org.apache.beehive.netui.databinding.datagrid.api.rendering.DataGridTagModel}
+ * for the cell's containing data grid.</li>
+ * <li><code>container</code> -- the {@link org.apache.beehive.netui.script.common.IDataAccessProvider} instance
+ * that exposes the current data item and the current item's index</li>
+ * </ul>
+ * </p>
  *
- * @jsptagref.tagdescription Data grid cell that renders an HTML &lt;span&gt; tag containing the tag's
- * <code>value</code> attribute.
+ * @jsptagref.tagdescription
+ * <p>
+ * Data grid cell that renders an HTML &lt;span&gt; tag containing the tag's <code>value</code> attribute.  The
+ * span cell is rendered inside of an HTML table &lt;td&gt;.  The span cell supports various nested tags including
+ * those that provide formatting via the NetUI {@link IFormattable} interface and those that augment the
+ * available attribute set via the NetUI {@link org.apache.beehive.netui.tags.IAttributeConsumer} interface.
+ * </p>
+ * <p>
+ * The set of JSP implicit objects available to the body include:
+ * <ul>
+ * <li><code>dataGridModel</code> -- the {@link org.apache.beehive.netui.databinding.datagrid.api.rendering.DataGridTagModel}
+ * for the cell's containing data grid.</li>
+ * <li><code>container</code> -- the {@link org.apache.beehive.netui.script.common.IDataAccessProvider} instance
+ * that exposes the current data item and the current item's index</li>
+ * </ul>
+ * </p>
  *
- * @netui:tag name="spanCell" description="Data grid cell that renders its value attribute into an HTML &lt;span&gt;"
- * body-content="scriptless"
+ * @netui:tag name="spanCell" body-content="scriptless"
+ *            description="Data grid cell that renders its value attribute into an HTML &lt;span&gt;"
  */
 public class SpanCell
     extends AbstractHtmlTableCell
@@ -67,9 +90,9 @@
     }
 
     /**
-     * Sets the onClick javascript event for the HTML span.
+     * Sets the onClick JavaScript event for the HTML span.
      *
-     * @param onClick - the onClick event for the HTML span.
+     * @param onClick the onClick event for the HTML span.
      * @jsptagref.attributedescription The onClick JavaScript event for the HTML span.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onClick</i>
@@ -80,9 +103,9 @@
     }
 
     /**
-     * Sets the onDblClick javascript event for the HTML span.
+     * Sets the onDblClick JavaScript event for the HTML span.
      *
-     * @param onDblClick - the onDblClick event for the HTML span.
+     * @param onDblClick the onDblClick event for the HTML span.
      * @jsptagref.attributedescription The onDblClick JavaScript event for the HTML span.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onDblClick</i>
@@ -93,9 +116,9 @@
     }
 
     /**
-     * Sets the onKeyDown javascript event for the HTML span.
+     * Sets the onKeyDown JavaScript event for the HTML span.
      *
-     * @param onKeyDown - the onKeyDown event for the HTML span.
+     * @param onKeyDown the onKeyDown event for the HTML span.
      * @jsptagref.attributedescription The onKeyDown JavaScript event for the HTML span.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onKeyDown</i>
@@ -106,9 +129,9 @@
     }
 
     /**
-     * Sets the onKeyUp javascript event for the HTML span.
+     * Sets the onKeyUp JavaScript event for the HTML span.
      *
-     * @param onKeyUp - the onKeyUp event.
+     * @param onKeyUp the onKeyUp event.
      * @jsptagref.attributedescription The onKeyUp JavaScript event for the HTML span.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onKeyUp</i>
@@ -119,9 +142,9 @@
     }
 
     /**
-     * Sets the onKeyPress javascript event for the HTML span.
+     * Sets the onKeyPress JavaScript event for the HTML span.
      *
-     * @param onKeyPress - the onKeyPress event.
+     * @param onKeyPress the onKeyPress event.
      * @jsptagref.attributedescription The onKeyPress JavaScript event for the HTML span.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onKeyPress</i>
@@ -132,9 +155,9 @@
     }
 
     /**
-     * Sets the onMouseDown javascript event for the HTML span.
+     * Sets the onMouseDown JavaScript event for the HTML span.
      *
-     * @param onMouseDown - the onMouseDown event.
+     * @param onMouseDown the onMouseDown event.
      * @jsptagref.attributedescription The onMouseDown JavaScript event for the HTML span.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onMouseDown</i>
@@ -145,9 +168,9 @@
     }
 
     /**
-     * Sets the onMouseUp javascript event for the HTML span.
+     * Sets the onMouseUp JavaScript event for the HTML span.
      *
-     * @param onMouseUp - the onMouseUp event.
+     * @param onMouseUp the onMouseUp event.
      * @jsptagref.attributedescription The onMouseUp JavaScript event for the HTML span.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onMouseUp</i>
@@ -158,9 +181,9 @@
     }
 
     /**
-     * Sets the onMouseMove javascript event for the HTML span.
+     * Sets the onMouseMove JavaScript event for the HTML span.
      *
-     * @param onMouseMove - the onMouseMove event.
+     * @param onMouseMove the onMouseMove event.
      * @jsptagref.attributedescription The onMouseMove JavaScript event for the HTML span.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onMouseMove</i>
@@ -171,9 +194,9 @@
     }
 
     /**
-     * Sets the onMouseOut javascript event for the HTML span.
+     * Sets the onMouseOut JavaScript event for the HTML span.
      *
-     * @param onMouseOut - the onMouseOut event.
+     * @param onMouseOut the onMouseOut event.
      * @jsptagref.attributedescription The onMouseOut JavaScript event for the HTML span.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onMouseOut</i>
@@ -184,9 +207,9 @@
     }
 
     /**
-     * Sets the onMouseOver javascript event for the HTML span.
+     * Sets the onMouseOver JavaScript event for the HTML span.
      *
-     * @param onMouseOver - the onMouseOver event.
+     * @param onMouseOver the onMouseOver event.
      * @jsptagref.attributedescription The onMouseOver JavaScript event for the HTML span.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_onMouseOver</i>
@@ -199,7 +222,7 @@
     /**
      * Sets the style for the HTML span.
      *
-     * @param style - the html style.
+     * @param style the html style.
      * @jsptagref.attributedescription The style for the HTML span
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_style</i>
@@ -214,7 +237,7 @@
     /**
      * Sets the style class for the HTML span.
      *
-     * @param styleClass - the html style class.
+     * @param styleClass the html style class.
      * @jsptagref.attributedescription The style class for the HTML span
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_style_class</i>
@@ -276,7 +299,7 @@
      * For example, if a data set contains {"foo", "bar", "baz"} rendered using a spanCell with a tagId
      * "theTagId", the resulting tagId values will be {"theTagId0", "theTagId1", "theTagId2"}.
      *
-     * @param tagId - the the name of the tagId for the HTML span.
+     * @param tagId the the name of the tagId for the HTML span.
      * @jsptagref.attributedescription The tagId.
      * @jsptagref.databindable false
      * @jsptagref.attributesyntaxvalue <i>string_tagId</i>
@@ -346,6 +369,12 @@
         DECORATOR.decorate(getJspContext(), appender, _spanCellModel);
     }
 
+    /**
+     * Implementation of {@link AbstractHtmlTableCell#internalGetCellModel()} that exposes the
+     * {@link org.apache.beehive.netui.databinding.datagrid.runtime.model.cell.SpanCellModel}
+     * which is storing state for this tag.
+     * @return this tag's span cell model
+     */
     protected CellModel internalGetCellModel() {
         return _spanCellModel;
     }

Modified: incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/TemplateCell.java
URL: http://svn.apache.org/viewcvs/incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/TemplateCell.java?rev=170271&r1=170270&r2=170271&view=diff
==============================================================================
--- incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/TemplateCell.java (original)
+++ incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/datagrid/TemplateCell.java Sun May 15 15:11:30 2005
@@ -28,33 +28,30 @@
  * a {@link javax.servlet.jsp.tagext.SimpleTag}.
  * </p>
  * <p>
+ * The templateCell can be used to render HTML UI that is not supported with other data grid cell types.  For example,
+ * to build UI that will POST data to a form, the NetUI {@link org.apache.beehive.netui.tags.html.TextBox} tag can
+ * be used as:
+ * <pre>
+ *     <netui-data:templateCell>
+ *          <netui:textBox dataSource="container.item.name"/>
+ *     </netui-data:templateCell>
+ * </pre>
+ * </p>
+ * <p>
  * The set of JSP implicit objects available to the body include:
  * <ul>
  * <li><code>dataGridModel</code> -- the {@link org.apache.beehive.netui.databinding.datagrid.api.rendering.DataGridTagModel}
  * for the cell's containing data grid.</li>
  * <li><code>container</code> -- the {@link org.apache.beehive.netui.script.common.IDataAccessProvider} instance
  * that exposes the current data item and the current item's index</li>
- * <li></li>
  * </ul>
  * </p>
  * <p>
  * The HTML events, core attributes, and internationalization JSP tag attributes are applied to the
  * &lt;td&gt;.
  * </p>
- * <p>
- * The templateCell can be used to render HTML UI that is not supported with other data grid cell types.  For example,
- * to build UI that will POST data to a form, the NetUI {@link org.apache.beehive.netui.tags.html.TextBox} tag can
- * be used as:
- * <pre>
- *     <netui-data:templateCell>
- *          <netui:textBox dataSource="container.item.name"/>
- *     </netui-data:templateCell>
- * </pre>
- * </p>
- *
- * @jsptagref.tagdescription Data grid cell that renders the content contained inside of its body inside of an
- * HTML &lt;td&gt; tag.  The body of the template cell can contain any JSP markup that is legal to nest inside of
- * a {@link javax.servlet.jsp.tagext.SimpleTag}.
+ *  *
+ * @jsptagref.tagdescription
  *
  * @netui:tag name="templateCell" description="Data grid cell that renders the content resulting from evaluating its body"
  * body-content="scriptless"
@@ -70,6 +67,12 @@
         appender.append(jspFragmentOutput);
     }
 
+    /**
+     * Implementation of {@link AbstractHtmlTableCell#internalGetCellModel()} that exposes the
+     * {@link org.apache.beehive.netui.databinding.datagrid.runtime.model.cell.TemplateCellModel}
+     * which is storing state for this tag.
+     * @return this tag's template cell model
+     */
     protected CellModel internalGetCellModel() {
         return new TemplateCellModel();
     }

Modified: incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/invoke/AbstractCallMethod.java
URL: http://svn.apache.org/viewcvs/incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/invoke/AbstractCallMethod.java?rev=170271&r1=170270&r2=170271&view=diff
==============================================================================
--- incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/invoke/AbstractCallMethod.java (original)
+++ incubator/beehive/trunk/netui/src/tags-databinding/org/apache/beehive/netui/tags/databinding/invoke/AbstractCallMethod.java Sun May 15 15:11:30 2005
@@ -445,7 +445,7 @@
 
             Object value = pn.paramValue;
             try {
-                // if the value wasn't a String, it may have come from XScript so don't try to convert it
+                // if the value wasn't a String, it may have come from EL so don't try to convert it
                 if(!(value instanceof String) || value == null)
                     args[i] = value;
                 // here, there's a non-null String value