Return to delam.1 CVS log

Up to [CSRG BSD Unix] / 43BSD / contrib / icon / man / man1

Annotation of 43BSD/contrib/icon/man/man1/delam.1, revision 1.1.1.1

1.1       root        1: .so tmac.ilib
                      2: .TH DELAM 1 "The University of Arizona \- 8/15/84"
                      3: .SH NAME
                      4: delam \- delaminate a file using column positions
                      5: .SH SYNOPSIS
                      6: \f3delam\fP fieldlist {infile | \-} {outputfile | \-}...
                      7: .SH DESCRIPTION
                      8: \fIDelam\fR delaminates an input file into several output files
                      9: according to the fields specified by \f3fieldlist\fR.
                     10: \fIDelam\fR reads \f3infile\fR and writes the fields in each line to the
                     11: corresponding output files as individual lines. If no data occurs in
                     12: the specified position for a given input line an empty output line is
                     13: written. This insures that all output files contain the same number of
                     14: lines as the input file.
                     15: .PP
                     16: If `\-' is used for \f3infile\fR, the standard input is read.
                     17: If `\-' is used as an output file name, the corresponding field
                     18: is written to the standard output.
                     19: .PP
                     20: The fields are defined by \f3fieldlist\fR, which is a list of field
                     21: specifications, separated by commas, colons, or semicolons, of the
                     22: following form:
                     23: .DS
                     24: .ft I
                     25: n              \fRthe character in column \fIn
                     26: n\-m           \fRthe characters in columns \fIn\fR through \fIm
                     27: n+m            m \fRcharacters beginning at column \fIn
                     28: .ft R
                     29: .DE
                     30: where the columns in a line are numbered from 1 to the length of the
                     31: line.
                     32: .PP
                     33: The use of \fIdelam\fR is illustrated by the following examples.
                     34: .DS
                     35: delam 1\-10,5 foo x y
                     36: .DE
                     37: reads file \fIfoo\fR and writes characters 1 through 10 to file \fIx\fR and
                     38: character 5 to file \fIy\fR.
                     39: .DS
                     40: delam 10+5:1\-10:1\-10:80 \- middle left1 left2 end
                     41: .DE
                     42: reads the standard input and writes characters 10 through 14 to
                     43: \fImiddle\fR, 1 through 10 to \fIleft1\fR and \fIleft2\fR, and character 80 to
                     44: \fIend\fR.
                     45: .DS
                     46: delam 1\-80;1\-80 \- \- \-
                     47: .DE
                     48: copies the standard input to the standard output, replicating the
                     49: first eighty columns of each line twice.
                     50: .SH NOTES
                     51: The functionality of the Software Tools \fIdelam\fR has
                     52: been divided. The Icon version of \fIdelam\fR uses an extended fieldlist
                     53: syntax. 
                     54: .SH SEE ALSO
                     55: lam(1),
                     56: delamc(1)
                     57: .LP
                     58: .St
                     59: .SH AUTHOR
                     60: Thomas R. Hicks

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.