Annotation of src/usr.bin/lam/lam.1, Revision 1.1.1.1
1.1 deraadt 1: .\" $NetBSD: lam.1,v 1.2 1994/11/14 20:27:40 jtc Exp $
2: .\"
3: .\" Copyright (c) 1993
4: .\" The Regents of the University of California. All rights reserved.
5: .\"
6: .\" Redistribution and use in source and binary forms, with or without
7: .\" modification, are permitted provided that the following conditions
8: .\" are met:
9: .\" 1. Redistributions of source code must retain the above copyright
10: .\" notice, this list of conditions and the following disclaimer.
11: .\" 2. Redistributions in binary form must reproduce the above copyright
12: .\" notice, this list of conditions and the following disclaimer in the
13: .\" documentation and/or other materials provided with the distribution.
14: .\" 3. All advertising materials mentioning features or use of this software
15: .\" must display the following acknowledgement:
16: .\" This product includes software developed by the University of
17: .\" California, Berkeley and its contributors.
18: .\" 4. Neither the name of the University nor the names of its contributors
19: .\" may be used to endorse or promote products derived from this software
20: .\" without specific prior written permission.
21: .\"
22: .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
23: .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24: .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25: .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
26: .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27: .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28: .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29: .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32: .\" SUCH DAMAGE.
33: .\"
34: .\" @(#)lam.1 8.1 (Berkeley) 6/6/93
35: .\"
36: .TH LAM 1 "June 6, 1993"
37: .UC 4
38: .SH NAME
39: lam \- laminate files
40: .SH SYNOPSIS
41: .B lam [ \-[fp]
42: min.max
43: .B ] [ \-s
44: sepstring
45: .B ] [ \-t
46: c
47: .B ]
48: file ...
49: .SH DESCRIPTION
50: .I Lam
51: copies the named files side by side onto the standard output.
52: The
53: .IR n -th
54: input lines from the input
55: .IR file s
56: are considered fragments of the single long
57: .IR n -th
58: output line into which they are assembled.
59: The name `\fB\-\fP' means the standard input, and may be repeated.
60: .PP
61: Normally, each option affects only the
62: .I file
63: after it.
64: If the option letter is capitalized it affects all subsequent files
65: until it appears again uncapitalized.
66: The options are described below.
67: .IP \fB\-f\fP\ min.max
68: Print line fragments according to the format string
69: .IR min.max ,
70: where
71: .I min
72: is the minimum field width and
73: .I max
74: the maximum field width.
75: If
76: .I min
77: begins with a zero, zeros will be added to make up the field width,
78: and if it begins with a `\-', the fragment will be left-adjusted
79: within the field.
80: .IP \fB\-p\fP\ min.max
81: Like \fB\-f\fP,
82: but pad this file's field when end-of-file is reached
83: and other files are still active.
84: .IP \fB\-s\fP\ sepstring
85: Print
86: .I sepstring
87: before printing line fragments from the next file.
88: This option may appear after the last file.
89: .IP \fB\-t\fP\ c
90: The input line terminator is
91: .I c
92: instead of a newline.
93: The newline normally appended to each output line is omitted.
94: .PP
95: To print files simultaneously for easy viewing use
96: .IR pr (1).
97: .SH EXAMPLES
98: .de IC
99: .IP
100: .ss 36
101: .ft B
102: ..
103: .de NC
104: .br
105: .ss 12
106: .PP
107: ..
108: .PP
109: The command
110: .IC
111: lam file1 file2 file3 file4
112: .NC
113: joins 4 files together along each line.
114: To merge the lines from four different files use
115: .IC
116: lam file1 \-S "\\
117: .br
118: " file2 file3 file4
119: .NC
120: Every 2 lines of a file may be joined on one line with
121: .IC
122: lam \- \- < file
123: .NC
124: and a form letter with substitutions keyed by `@' can be done with
125: .IC
126: lam \-t @ letter changes
127: .NC
128: .SH SEE ALSO
129: join(1), pr(1), printf(3)