NAME

rdb2latex - convert rdb table(s) to a LaTeX table


SYNOPSIS

rdb2latex [options] file1 file2


OPTIONS

-autotable
Parse the rdb table header, and generate the LaTeX to begin and end the table. When -autotable is set, rdb2latex ignores the .epi and .pro files. This option is useful to get a start at what the table should look like. Grab the LaTeX code, customize it, and create .pro and .epi files with it for future runs with rdb2latex.

-document
Surround the emitted LaTeX with

  \documentclass{article}
  \begin{document}
  [...]
  \end{document}

-output
By default rdb2latex writes the LaTeX table to UNIX standard output. This option specifies an alternate destination.

-help
Print this help message and exit.

-hline N
This option indicates that a horizontal line should be inserted between every N rows.

-page N
Normaly rdb2latex will not attempt to insert page breaks. This option indicates that there are N rows per page. This option is required when the -swap option is specified.

-swap
Normally rdb2latex processes one file at a time, writing one table per input file. rdb2latex provides the capability of interleaving data from different rdb tables into a single table, taking one page at a time from each rdb file. This option turns on this behavior. The -page option must be specified to this to work as advertised. See also the discussion of prologues and epilogues below.

-version
Print out the version number and exit.


DESCRIPTION

rdb2latex takes a bunch of rdb files and turns them into LaTeX tables. Usually it deals only with the data in the tables, i.e., it doesn't use the column names to create column headers in the table, but that can be overridden with the -autotable option. It essentially ``formats'' the data so that they'll line up correctly in LaTeX.

Each input file is assumed to have an extension of .rdb. rdb2latex also looks for three other optional files with the following extensions:

.pro
A prologue file; this is output at the beginning of each page (or table if -page is not specified). It should contain the LaTeX table header information. Lines which should only appear on the first page of the table should be prefixed with %#1. Those which should appear on subsequent pages should be prefixed with %#2.

.epi
An epilogue file; this is output at the end of each page (or table if -page is not specified). It should contain the LaTeX commands to finish off the table.

.tfmt
A printf style string which describes how the data should appear in the resulting table. Here is where the column separation, output precision, extra strings etc., should be placed. For example:

     %s & %.3f & %.4g

If you don't specify this, rdb2latex will print the data exactly as given in the input tables. The format needn't be specified all on one line; blank lines and lines beginning with the # character are ignored. All other lines are concatenated.


AUTHOR

Diab Jerius ( djerius@cfa.harvard.edu )