NAME

showtable - Show data in nicely formatted columns

USAGE

showtable [-options] [file]

DESCRIPTION

Showtable reads an input data stream and displays it in a nicely formatted listing, with exact formatting depending upon the options. The input stream, file or STDIN by default should consist of data separated by tabs or the defined separator character (see -f).

The actual output formatting is peformed by the ShowTable module.

OPTIONS

There are two general sets of options: those which help determine the format of the input, and those which determine the format of the output.

Options affecting input

-fC

Set the inter-column break character to "C". The default is a tab character. If -strip is also given, blanks surrounding the break character will also be ignored.

-nod(ashes)

Do not ignore lines of separators, such as dashes, equal signs, or underlines. If -nodashes is given, and these lines do occur in the stream, they will be treated as normal data.

-ti(tles)[=NN]

Treat the first NN rows of data as column titles; multiple words in the column titles may wrap vertically. If NN is omitted, it defaults to 1. No -titles option is the same as -titles=0.

-s(trip)

Strip blanks from around the column values.

Options affecting output

-t(able)

Use a simple table format. See ShowTable for more details.

-l(ist)

Use a list style format. See ShowTable for more details.

-b(ox)

Use a "boxed" style table. See ShowTable for more details.

-ht(ml)

Use HTML-formating. See ShowTable for more details.

-noh(eaders)

Do not output any headers on the tables; -titles=0 implies this option.

Other options

-help

Display some help to the user and quit.

DEPENDENCIES

ShowTable.pm

Performs the actual output formatting.

OutPut.pm

Used for output to STDOUT and STDERR.

AUTHOR

Alan K. Stebbens aks@hub.ucsb.edu

BUGS