Minor documentation updates

Author: pborissow

src/checkbox/Checkbox.js

@@ -6,7 +6,25 @@ if(!javaxt.dhtml) javaxt.dhtml={};
 //******************************************************************************
 /**
  *   Form input that can be either checked or unchecked. The input consists of
- *   a square box with a checkmark when activated and text label.
+ *   a square box with a checkmark when selected.
+ *   <br/>
+ *   Here's a simple example of how to instantiate a checkbox using an existing
+ *   div (DOM element) and a minimal config. See config settings for a full
+ *   range of options.
+ <pre>
+    var checkbox = new javaxt.dhtml.Checkbox(div, {
+        label: "I Agree",
+        checked: false
+    });
+ </pre>
+ *   Once the checkbox is instantiated you can call any of the public methods.
+ *   You can also add event listeners by overriding any of the public "on" or
+ *   "before" methods like this:
+ <pre>
+    checkbox.onClick = function(checked){
+        console.log("I Agree", checked);
+    };
+</pre>
  *
  ******************************************************************************/
 

src/form/Form.js

@@ -16,9 +16,18 @@ javaxt.dhtml.Form = function (parent, config) {
 
     var defaultConfig = {
         onsubmit: null,
+
+      /** An array of items that make up the form (e.g. form inputs and labels).
+       */
         items: [],
 
 
+      /** An array of buttons that will be placed at the bottom of the form
+       * (e.g. submit, cancel, reset).
+       */
+        buttons: [],
+
+
       /** Style for individual elements within the component. Note that you can
        *  provide CSS class names instead of individual style definitions.
        */

src/utils/Utils.js

@@ -1037,6 +1037,24 @@ javaxt.dhtml.utils = {
   //**************************************************************************
   //** initDrag
   //**************************************************************************
+  /** Used to update a DOM element and enable dragging. It is up to the caller
+   *  to process the drag events and update the DOM element via event handlers
+   *  defined in the config. Example:
+   <pre>
+    initDrag(div, {
+        onDragStart: function(mouseX, mouseY){
+            //Do something, like compute x/y offsets, update cursor, etc
+        },
+        onDrag: function(mouseX, mouseY){
+            this.style.left = x + 'px';
+            this.style.top = y + 'px';
+        },
+        onDragEnd: function(){
+            //Do something, like repost position, update cursor, etc
+        }
+    });
+   </pre>
+   */
     initDrag : function(dragHandle, config){
         javaxt.dhtml.utils.addNoSelectRule();
 
@@ -1245,11 +1263,17 @@ javaxt.dhtml.utils = {
   //**************************************************************************
   //** addResizeListener
   //**************************************************************************
-  /** Used to watch for resize events for a given element. Credit:
-   *  http://www.backalleycoder.com/2013/03/18/cross-browser-event-based-element-resize-detection/
+  /** Used to watch for resize events for a given element.
    */
     addResizeListener: function(element, fn){
 
+        /* This is a really old hack from 2013 when there were limited
+         * cross-browser options to watch for resize events. The code was
+         * lifted directly from this link:
+         * http://www.backalleycoder.com/2013/03/18/cross-browser-event-based-element-resize-detection/
+         */
+
+
         var destroy, isDestroyed = false;
 
         var requestFrame = (function(){