.
-
-help
-
Display some help to the user and quit.
.
If the input type is box, then vertical and horizontal box characters
are removed from the input stream, and blanks surrounding the vertical
box characters are removed. The vertical box characters (column
separaters) are ``|
'' or ``:
''. The The horizontal box characters are
``+
'' and ``-
''.
Morever, data wrapped within a column is recognized and parsed as one
column value, by recognizing the presence of a wrapping prefix or
wrapping suffix character. Currently, the wrapping prefix character
is ``<'', and the wrapping suffix character is ``>''.
An example of data wrapped within a column is given here. The table
below has just two logical rows of data; with both rows having data
wrapped into multiple physical rows.
+---------+---------+---------+
| Col 1 | Col 2 | Col 3 |
+---------+---------+---------+
| This is>| Another>| Row 1,3>|
|< a cont>|< value. ||
|| || Item2-2 | Item2-3 |
+---------+---------+---------+
When using the -list or -input=list options, either, or both, the
input and output may be in a ``list'' format, which is implemented
using the following syntax:
r1c1_name: r1c1_value
r1c2_name: r1c2_value
...
r1cN_name: r1cN_value
r2c1_name: r2c1_value
r2c2_name: r2c2_value
: r2c2_value_continued
...
r2cN_name: r2cN_value
rMc1_name: rMc1_value
rMc2_name: rMc2_value
...
rMcN_name: rMcN_value
Each row of data consists of one or more columns, and ends with
a blank line.
Each column consists of a column name, followed by a colon ``:'',
followed by an optional, single space or tab, followed by the
column value, on the same line.
Continuation lines of the previous column value consist of one or more
space or tab characters, a colon ``:'', one optional, single space
or tab, followed by the continuation value. In the example above,
The second column value of the second row was continued.
When using -html on data already containing HTML-formatted text,
the -noescape option should be used. By default, all input
text is assumed not to be HTML-formatted, and is escaped
allowing embedded ``<'', ``>'' characters, if any, to be displayed
correctly.
-
Data::ShowTable
module
-
Performs the actual output formatting.
.
Alan K. Stebbens aks@sgi.com
- Currently, the box formatting characters are not configurable: '+' for
the corners; '-' and '|' for the tops and sides, respectively. In an
ideal world, these things would be configurable.
- The continuation prefix and suffix characters, '<' and '>',
respectively, are also not configurable:
- When reading table input, any data ending with ``>'' will
be considered to be continued by the next row of data. To avoid
this, use -input=simple.
- When selecting noncontiguous fields (ie: -f1,4>) without
field names, the default field names will be consecutively
numbered from 1, which is counter-intuitive to the original
selection. To avoid this, name the fields using the -title=...
option.
.