how the heck does table style:group actually group?

This might be a dumb question, but how does the table group? I see little sections of rows in various apps, but I dont know how it works. this documentation tells me nothing. http://docs.appcelerator.com/titanium/2.1/index.html#!/api/Titanium.UI.iPhone.TableViewStyle

Titanium.UI.iPhone.TableViewStyle.GROUPED

is the grouped style. It's taken directly from the page you linked to, so by no means does it tell you nothing.

Example:

var table = Ti.UI.createTableView({
    style : Titanium.UI.iPhone.TableViewStyle.GROUPED,
});

Allow me to refer you to the APPLE Developer's documentation, what I like to think of as required reading for those who wish to call themselves iOS developers, regardless of what tools they use:

Table View Programming Guide

try this,

var table = Ti.UI.createTableView({
    style : 1,
});

Hi, Using Titanium when we provide table view style as grouped i.e. Titanium.UI.iPhone.TableViewStyle.GROUPED then it will group the table view rows with your logical grouping.