aboutsummaryrefslogtreecommitdiff
path: root/pkg/lists/doc/columns.hlp
blob: a4f304fa027a5191c2020670594184b7a684e014 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
.help columns Nov88 lists
.ih
NAME
columns -- break a multicolumn list into multiple single column lists
.ih
USAGE
columns filename numcols 
.ih
PARAMETERS
.ls filename
Name of the input table file.
.le
.ls numcols
The number of columns in the input file.
.le
.ls outroot = "col."
Root name of the output column files.
.le
.ih
DESCRIPTION
Task \fIcolumns\fR is used to reformat a multicolumn list file into separate
files, such that one output file is created for each column in the input
file.  It is used to break multicolumn tables into simple CL lists.
Comment lines beginning with  the character "#" are ignored.  All data
is transferred as text.  One file \fBoutroot\fRn is produced for each
column in the input table.
.ih
EXAMPLES
Make 3 files named datacol.1, datacol.2 and datacol.3 from the 3 column
table dtable:
.nf

    cl> columns dtable 3 outroot=datacol.
.fi
.ih
SEE ALSO
fields
.endhelp