-###
- Table view
-
- A directive for generating a lazy rendered table
-
- Dependencies
- - jQuery UI Sortable
- - jQuery UI Resizable
-
- Attributes:
-  - mac-table-data:              Array of objects with table data
-  - mac-table-columns:           Array of columns to display
-  - mac-table-has-header:        A boolean value to determine if header should be shown
-  - mac-table-has-footer:        A boolean value to determine if footer should be shown
-  - mac-table-width:             The width of the whole table
-  - mac-table-column-width:      The minimum width of a column
-  - mac-table-row-height:        The height of each row in the table
-  - mac-table-num-display-rows:  The total number of rows to display
-  - mac-table-cell-padding:      Should match the css padding value on each cell
-  - mac-table-sortable:          Allow user to change the order of columns
-  - mac-table-resizable:         Allow each column to be resized by the user
-  - mac-table-lock-first-column: Lock first column to a static position
-###
+##
+## @name
+## Table view
+##
+## @description
+## A directive for generating a lazy rendered table
+##
+## @dependencies
+## - jQuery UI Sortable
+## - jQuery UI Resizable
+##
+## @attributes
+## - mac-table-data:              Array of objects with table data
+## - mac-table-columns:           Array of columns to display
+## - mac-table-has-header:        A boolean value to determine if header should be shown (default true)
+## - mac-table-has-footer:        A boolean value to determine if footer should be shown (default true)
+## - mac-table-width:             The width of the whole table                           (default 800)
+## - mac-table-column-width:      The minimum width of a column                          (default 140)
+## - mac-table-row-height:        The height of each row in the table                    (default 20)
+## - mac-table-num-display-rows:  The total number of rows to display                    (default 10)
+## - mac-table-cell-padding:      Should match the css padding value on each cell        (default 8)
+## - mac-table-border-width:      Should match the css border width value on each cell   (default 1)
+## - mac-table-sortable:          Allow user to change the order of columns              (default false)
+## - mac-table-resizable:         Allow each column to be resized by the user            (default false)
+## - mac-table-lock-first-column: Lock first column to a static position                 (default false)
+##
 
 angular.module("Mac").directive "macTable", [
   "$rootScope"

          # Set column property again
          templateCell.prop "column", column

          calculatedWidth = (opts.width / numColumns) - opts.cellPadding * 2 - opts.borderWidth
          width           = Math.max calculatedWidth, opts.columnWidth

          templateCell.css
            padding: opts.cellPadding

            # Calculate the width of each row
            rowWidth += templateCell.outerWidth() + opts.borderWidth

            emptyTemplateRow.append createCellTemplate().addClass "table-cell"

          tableRow.append(tableCell).width rowWidth
          emptyTemplateRow.width rowWidth
          bodyBlock.append tableRow

          # Compile the body block to bind all values correctly
