--- ray/doc/man/man1/rlam.1	2010/06/18 21:22:49	1.7
+++ ray/doc/man/man1/rlam.1	2019/07/04 17:36:04	1.9
@@ -1,4 +1,4 @@
-.\" RCSid "$Id: rlam.1,v 1.7 2010/06/18 21:22:49 greg Exp $"
+.\" RCSid "$Id: rlam.1,v 1.9 2019/07/04 17:36:04 greg Exp $"
 .TH RLAM 1 7/8/97 RADIANCE
 .SH NAME
 rlam - laminate records from multiple files
@@ -20,8 +20,10 @@ rlam - laminate records from multiple files
 .B \-iwN
 |
 .B \-ibN
+][
+.B "\-in M"
 ]
-input1 input2 ..
+input1 [options] input2 ..
 .SH DESCRIPTION
 .I Rlam
 simply joins records (or lines) from multiple inputs, separating them with
@@ -36,7 +38,7 @@ character will be printed, either.
 .PP
 An input is either a stream or a command.
 Commands are given in quotes, and begin with an exclamantion point ('!').
-If the inputs do not have the same number of lines, then
+If the inputs do not have the same number of records, then
 shorter files will stop contributing to the output as they
 run out.
 .PP
@@ -63,12 +65,21 @@ For example,
 indicates three floats per input record for the next named input.
 In the case of the
 .I \-ia
-option, no number indicates one line per input record, and numbers
-greater than zero indicate that many characters exactly per record.
+option, no number reads one line per record, and numbers
+greater than zero take multiple lines at a time from the same stream.
 For binary input formts, no number implies one value per record.
 For anything other than EOL-separated input, the default tab separator
 is reset to the empty string.
 .PP
+These options may be interspersed with input specifications,
+indicating different data to draw from the different files.
+.PP
+If a
+.I \-in
+option is given with a positive integer argument, this will be the
+maximum number of records that will be read or produced by
+.I rlam.
+.PP
 A hyphen ('-') by itself can be used to indicate the standard
 input, and may appear multiple times.
 The
@@ -86,7 +97,12 @@ cnt `wc \-l < lam.c` | rlam \- \-t: lam.c \-t\| '!tail
 To join four data files, each having three doubles per record:
 .IP "" .2i
 rlam \-id3 file1.dbl file2.dbl file3.dbl file4.dbl > combined.dbl
+.PP
+To join two data files, the first having two words per
+record and the second having one:
+.IP "" .2i
+rlam \-iw2 file1.hi2 \-iw file2.hi1 > combined.hi3
 .SH AUTHOR
 Greg Ward
 .SH "SEE ALSO"
-cnt(1), histo(1), neaten(1), rcalc(1), tabfunc(1), total(1)
+cnt(1), histo(1), neaten(1), rcalc(1), rsplit(1), tabfunc(1), total(1)