--- ray/doc/man/man1/rlam.1	2005/10/05 05:20:50	1.4
+++ ray/doc/man/man1/rlam.1	2019/07/20 00:57:43	1.12
@@ -1,4 +1,4 @@
-.\" RCSid "$Id: rlam.1,v 1.4 2005/10/05 05:20:50 greg Exp $"
+.\" RCSid "$Id: rlam.1,v 1.12 2019/07/20 00:57:43 greg Exp $"
 .TH RLAM 1 7/8/97 RADIANCE
 .SH NAME
 rlam - laminate records from multiple files
@@ -7,15 +7,23 @@ rlam - laminate records from multiple files
 [
 .B \-tS
 ][
+.B \-u
+][
 .B \-iaN
 |
 .B \-ifN
 |
 .B \-idN
 |
+.B \-iiN
+|
 .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
@@ -25,12 +33,13 @@ additional
 .I \-t
 options in between each file name.
 Note that there is no space between this option and its argument.
+If no argument is given, then a newline is assumed.
 If none of the input files uses an ASCII separator, then no end-of-line
 character will be printed, either.
 .PP
-An input is either a stream or a command.
+An input is either a file 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
@@ -42,37 +51,59 @@ option may be used to indicated binary IEEE 32-bit flo
 Similarly, the
 .I \-id
 and
-.I \-iw
+.I \-ii
 options may be used to indicate binary 64-bit doubles or integer words,
 respectively.
-If an number is immediately follows any of these options, then it
+The
+.I \-iw
+option specifies 2-byte short words, and the
+.I \-ib
+option specifies bytes.
+If a number immediately follows any of these options, then it
 indicates that multiple such values are expected for each record.
 For example,
 .I \-if3
 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.
-.SH EXAMPLE
+The
+.I \-u
+option forces output after each record (i.e., one run through inputs).
+.SH EXAMPLES
 To join files output1 and output2, separated by a comma:
 .IP "" .2i
-rlam -t, output1 output2
+rlam \-t, output1 output2
 .PP
 To join a file with line numbers (starting at 0) and its reverse:
 .IP "" .2i
-cnt `wc -l < lam.c` | rlam - -t: lam.c -t\| '!tail -r lam.c'
+cnt `wc \-l < lam.c` | rlam \- \-t: lam.c \-t\| '!tail \-r lam.c'
 .PP
 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
+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)