also annotate showGroups => showSections

for #855

Author: gordonwoodhull

src/data-table.js

@@ -440,7 +440,7 @@ dc.dataTable = function (parent, chartGroup) {
      * @param {Boolean} [showSections=true]
      * @returns {Boolean|dc.dataTable}
      */
-    _chart.showSections = _chart.showGroups = function (showSections) {
+    _chart.showSections = function (showSections) {
         if (!arguments.length) {
             return _showSections;
         }
@@ -456,6 +456,8 @@ dc.dataTable = function (parent, chartGroup) {
      * @param {Boolean} [showGroups=true]
      * @returns {Boolean|dc.dataTable}
      */
+    _chart.showGroups = dc.logger.annotate(_chart.showSections,
+                                           'consider using dataTable.showSections instead of dataTable.showGroups for clarity');
 
     return _chart.anchor(parent, chartGroup);
 };

web/examples/download-table.html

@@ -111,7 +111,7 @@
 table
     .dimension(spendDim)
     .sortBy(function(d) { return +d.Spent; })
-    .showGroups(false)
+    .showSections(false)
     .columns(['Name',
               {
                   label: 'Spent',

web/examples/table-pagination.html

@@ -56,7 +56,7 @@
           .height(480)
           .dimension(runDimension)
           .size(Infinity)
-          .showGroups(false)
+          .showSections(false)
           .columns(['Expt', 'Run', 'Speed'])
           .sortBy(function (d) { return [fmt(+d.Expt),fmt(+d.Run)]; })
           .order(d3.ascending)