NAME

rdb2html - translate an rdb table into an html one


SYNOPSIS

rdb2html options [ input [ output ] ]


OPTIONS

Options may be abbreviated. Options which take values may be separated from the values by either an equals sign or by white space.

--align=left|right|-center

Set the table's align tag. By default, no tag is set.

--tblcolor=color

Set the table's bgcolor tag. It's white by default.

--border=integer

Set the table's border tag. It defaults to 2.

--cellpadding=integer

Set the table's cellpadding tag. It defaults to 1.

--cellspacing=integer

Set the table's cellspacing tag. It defaults to 2.

--comments

By default, comments in the rdb header are not output. If this option is present, they will be.

--hdrcolor=color

Set the color for the table's header row. It defaults to whatever the tblcolor is.

--margin=integer

Set the margin (in spaces) prepended to the output. Nice for lining up stuff in embedded HTML. It defaults to zero.

--nomargin

Normally, rdb2html pretty-prints the output HTML with extra indentation. This option turns it off. For large tables, this may save quite a bit of space.

--tralign=left|right|-center

The default alignment for rows. If none is specified, then one is chosen (based upon the alignment requirements of the RDB data) to minimize the number of align tags put in the cells. If --tralign and --nocellalign are specified, this forces all cells to have a common alignment.

--nocellalign

Don't align cell contents based on the column definition. Saves lots of space on large numeric tables, as each cell must get an alignment flag.

--width=integer

Set the table's width tag.

--cw=p|a

This option indicates that cell widths should explicitly by set in the outut HTML table. Cell widths are determined from the RDB column definitions, and are translated either into a percent of the total width (if --cw is p) or into absolute pixels (if --cw is a). Pixel widths are determined by multiplying the column width by the value of --pixchar. Note that the browser may ignore the specified width if the cell contents require more space.

--pixchar=width

The width in pixels of a character. Only useful if --cw is set to a. This defaults to 8.

--cut=lines

A new HTML table will be generated for every --cut lines. The table header will be output for every table if --rpthdr is specified.

--rpthdr

If specified, and --cut is also specified, the table header (which contains the names of the columns) will be output for each table. Normally, it's output only once, at the top of the first table.

--help

print this and exit

--version

print version information and exit


DESCRIPTION

rdb2html translates an rdb table into HTML. It uses the column definitions to determine column alignment. rdb header comments may be included by specifying the --comments option.

The names of the input and output files are optional. If not specified, rdb2html acts as a filter, reading from stdin, and writing to stdout. The input filename must be specified if the output file name is specified.


LICENSE

This software is released under the GNU General Public License. You may find a copy at

   http://www.fsf.org/copyleft/gpl.html


VERSION

@VERSION@


AUTHOR

Diab Jerius ( djerius@cfa.harvard.edu )

Original awk script by Dick Edgar.