event_calendar_table doc wrong, perhaps function missing?

event_calendar_table's doc says, 'create a themed table ov events'. It does not create a themed table. It creates a row arrray which the caller might be able to format with theme_table, after deriving a suitable header parameter.

The various event_calendar_xxx functions have inconsistent return values.

What I wanted to do was have a page in a page book that contained a month's worth of events in a tabular format. Sadly, even after figuring out how to use theme_table on the output, event_calendar_table's format (a single column with colspan set to 3?) is not what I want, so I'll have to write code at the next level down I think to get the presentation I want.