.TH tabletolist "" "" "/rdb Command"
.PC "Convert a table to list format"
\fBtabletolist [ \-l ] < \fItable\fR
.PP
.II "table^convert to list"
.II "list^convert from table"
The command
.B tabletolist
converts
.I table
to list format.
.PP
Option \fB\-l\fR tells
.B tabletolist
not to write a newline at the beginning of the new list file.
This is for compatibility with the older list format and for other uses.
Note that most
.B /rdb
commands cannot read a list file if it lacks the initial newline.
.SH Example
Consider
.BR mailtable ,
which has the following format:
.DM
Number  Name    Company Street  City    State   ZIP     Phone
------- ------- ------- ------- ------- ------- ------- -------
1       Ronald McDonald McDonald's      123 Mac Attack  Memphis
TENN    30000   (111) 222-3333
2       Chiquita  Banana        United Brands   Uno Avenito De La
Revolution      San Jose        Costa Rica      123456789       1234
.DE
.PP
As you can see, the information in each row is often too wide for the screen;
these data would be better stored in a list-format file.
To convert
.B mailtable
to list format, type the following:
.DM
	tabletolist < mailtable
.DE
.PP
This writes the following to the standard output:
.DM
\fB<newline>\fP
Number  1
Name    Ronald McDonald
Company McDonald's
Street  123 Mac Attack
City    Memphis
State   TENN
ZIP     30000
Phone   (111) 222-3333
.DE
.DM
Number  2
Name    Chiquita  Banana
Company United Brands
Street  Uno Avenido de la Reforma
City    San Jose
State   Costa Rica
ZIP     123456789
Phone   1234
 ...
.DE
.SH "See Also"
.B
listtotable
.R