| 1 |
ShowTable.pm, version 4.4, is a Perl 5 module which defines subroutines |
| 2 |
to print arrays of data in a nicely formatted listing, using one of |
| 3 |
four possible formats: simple table, boxed table, list style, and |
| 4 |
HTML-formatting (for World-Wide-Web output). See the documentation on |
| 5 |
ShowTable.pm for details on the formatting. |
| 6 |
|
| 7 |
The program "showtable" reads data in a variety of formats from a file |
| 8 |
or STDIN, optimally columnizes the data, and then feeds the array of |
| 9 |
data to the ShowTable module for display. Showtable can parse its own |
| 10 |
output as input (except for HTML). Individual or ranges of columns may |
| 11 |
be selected for display, either by name or by index. |
| 12 |
|
| 13 |
In other words, showtable is a data formatting program. Using the |
| 14 |
'-html' option, showtable can accept ASCII tablular data and format it |
| 15 |
appropriately for display through a Web-browser. |
| 16 |
|
| 17 |
Both the the ShowTable.pm module and the showtable program have |
| 18 |
embedded POD text with which man or HTML pages can be created. |
| 19 |
|
| 20 |
For detailed usage information, you can do: |
| 21 |
|
| 22 |
pod2man ShowTable.pm | nroff -man |
| 23 |
pod2man showtable | nroff -man |
| 24 |
|
| 25 |
The program and module are accompanied with a perl Makefile.PL, this |
| 26 |
README, test programs (do "make test") and reference test output files, |
| 27 |
and the GNU License, under which this software is freely available. |
| 28 |
|
| 29 |
The archive is available in the Comprehensive Perl Archive Network (CPAN). |
| 30 |
|
| 31 |
INSTALLATION: |
| 32 |
|
| 33 |
1. Unpack the archive |
| 34 |
|
| 35 |
sh Data-ShowTable-4.4.shar |
| 36 |
|
| 37 |
or: |
| 38 |
|
| 39 |
gnutar xvfz Data-ShowTable-4.4.tar.gz |
| 40 |
|
| 41 |
2. Generate the "Makefile": |
| 42 |
|
| 43 |
perl Makefile.PL |
| 44 |
|
| 45 |
Be sure that you are using perl 5.002 or later. |
| 46 |
|
| 47 |
3. Make the installable files: |
| 48 |
|
| 49 |
make |
| 50 |
|
| 51 |
4. Test the new files: |
| 52 |
|
| 53 |
make test |
| 54 |
|
| 55 |
5. Install the modules and "showtable" program into the configured |
| 56 |
Perl library and binary directories. |
| 57 |
|
| 58 |
make install |
| 59 |
|
| 60 |
Contributions or improvements are welcome. |
| 61 |
|
| 62 |
_________________________________ |
| 63 |
Alan Stebbens <[email protected]> |