10.0;lamf (laminate_file), revision 1.0, 88/01/21
lamf (laminate_file) -- Laminate files.
usage: lamf [pathname ...] [-s string ]
DESCRIPTION
lamf laminates the named files to standard output. That is, it
concatenates the first lines of all input files, sequentially, and writes
the result to standard output; and so on for the next input lines. If
the files contain different numbers of lines, null lines are used for the
missing lines in the shorter files.
NOTE
To insert a newline character between lines, use the escape sequence, @n,
as a string argument. (See Example 4, below.)
ARGUMENTS
pathname (optional)
Specify name(s) of file(s) to be laminated to standard
output. Multiple pathnames are permitted, separated by
blanks.
Default if omitted:
read standard input for input lines Use a
hyphen (-) to specify standard input in a
list of filenames.
OPTIONS
-s string Specify a string of text to be placed in each output line
at the point it appears in the command argument list.
string may not exceed 300 characters. Strings containing
embedded spaces must be in quotation marks (" ").
EXAMPLES
1. Laminate files mary and fred and write results to standard output.
$ lamf mary fred
2. Laminate lines from jan, standard input, and george, in that order.
$ lamf jan - george
3.
$ lamf -s "A line from A: " a -s ", and from B: " b
produces:
A line from A: first line from a, and from B: first line from b
Note that the text strings inserted are not bound in any way to the
position of the pathname arguments: you may place strings wherever you
please. Those strings that contain literal blanks must be enclosed in
quotation marks, as above.
4. Escape sequences are valid in string arguments. For example
$ lamf mary -s @n fred
Insert a newline character between each line from mary and fred, thus
interleaving the lines from the two files.