+ # options example...
+ # (everything not commented required is optional)
+ #
+ # # basic options, required
+ # 'title' => 'Page title',
+ # 'name' => 'items', #name for the records returned
+ #
+ # # some HTML callbacks...
+ # 'menubar' => '', #menubar arrayref
+ # 'html_init' => '', #after the header/menubar and before the pager
+ # 'html_foot' => '', #at the bottom
+ # 'html_posttotal' => '', #at the bottom
+ # # (these three can be strings or coderefs)
+ #
+ #
+ # #literal SQL query string or qsearch hashref, required
+ # 'query' => {
+ # 'table' => 'tablename',
+ # #everything else is optional...
+ # 'hashref' => { 'field' => 'value',
+ # 'field' => { 'op' => '<',
+ # 'value' => '54',
+ # },
+ # },
+ # 'select' => '*',
+ # 'addl_from' => '', #'LEFT JOIN othertable USING ( key )',
+ # 'extra_sql' => '', #'AND otherstuff', #'WHERE onlystuff',
+ #
+ #
+ # },
+ # # "select * from tablename";
+ #
+ # #required unless 'query' is an SQL query string (shouldn't be...)
+ # 'count_query' => 'SELECT COUNT(*) FROM tablename',
+ #
+ # 'count_addl' => [], #additional count fields listref of sprintf strings
+ # # [ $money_char.'%.2f total paid', ],
+ #
+ # #listref of column labels, <TH>
+ # #required unless 'query' is an SQL query string
+ # # (if not specified the database column names will be used)
+ # 'header' => [ '#', 'Item' ],
+ #
+ # 'disable_download' => '', # set true to hide the CSV/Excel download links
+ # 'disable_nonefound' => '', # set true to disable the "No matching Xs found"
+ # # message
+ #
+ # #listref - each item is a literal column name (or method) or coderef
+ # #if not specified all columns will be shown
+ # 'fields' => [
+ # 'column',
+ # sub { my $row = shift; $row->column; },
+ # ],
+ #
+ # #listref of column footers
+ # 'footer' => [],
+ #
+ # #listref - each item is the empty string, or a listref of ...
+ # 'links' =>
+ #
+ #
+ # 'align' => 'lrc.', #one letter for each column, left/right/center/none
+ # # can also pass a listref with full values:
+ # # [ 'left', 'right', 'center', '' ]
+ #
+ # #listrefs...
+ # #currently only HTML, maybe eventually Excel too
+ # 'color' => [],
+ # 'size' => [],
+ # 'style' => [],
+ #
+ # #redirect if there's only one item...
+ # # listref of URL base and column name (or method)
+ # # or a coderef that returns the same
+ # 'redirect' =>
+
+ my $DEBUG = 0;
+