   ###
   table = (options, owner = OJ.body, calledFromFactory = false) ->
     
+    # ## options
     defaults =
+      # ### data
+      # optional array of objects. if provided will generate table automatically.
       data: null
+      # ### props
+      # optional properties to apply to table root node
       props: 
         cellpadding: 0
         cellspacing: 0

        cellvalign: 'top'
        class: ''
      styles: {}
      events:
        click: OJ.noop
      cells:
        class: ''
        align: ''
        'vertical-align': ''
        cellpadding: ''
        margin: ''
      thead: {}
      tbody: {}

      firstAlignRight: false

        
        loadCells()
      else  
        thead = ret.make 'thead', defaults.thead
        theadRow = thead.make 'tr'
        tbody = ret.make 'tbody', defaults.tbody
        rows.push tbody.make 'tr'
      ret
    
