--- ray/doc/man/man1/rlam.1	2005/09/25 20:36:01	1.3
+++ ray/doc/man/man1/rlam.1	2010/06/18 21:22:49	1.7
@@ -1,4 +1,4 @@
-.\" RCSid "$Id: rlam.1,v 1.3 2005/09/25 20:36:01 greg Exp $"
+.\" RCSid "$Id: rlam.1,v 1.7 2010/06/18 21:22:49 greg Exp $"
 .TH RLAM 1 7/8/97 RADIANCE
 .SH NAME
 rlam - laminate records from multiple files
@@ -7,23 +7,30 @@ rlam - laminate records from multiple files
 [
 .B \-tS
 ][
+.B \-u
+][
 .B \-iaN
 |
 .B \-ifN
 |
 .B \-idN
 |
+.B \-iiN
+|
 .B \-iwN
+|
+.B \-ibN
 ]
 input1 input2 ..
 .SH DESCRIPTION
 .I Rlam
 simply joins records (or lines) from multiple inputs, separating them with
-the given separator string (TAB by default).
+the given string (TAB by default).
 Different separators may be given for different files by specifying
 additional
 .I \-t
 options in between each file name.
+Note that there is no space between this option and its argument.
 If none of the input files uses an ASCII separator, then no end-of-line
 character will be printed, either.
 .PP
@@ -41,10 +48,15 @@ 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 is immediately follows any of these options, then it
 indicates that multiple such values are expected for each record.
 For example,
 .I \-if3
@@ -54,21 +66,26 @@ In the case of the
 option, no number indicates one line per input record, and numbers
 greater than zero indicate that many characters exactly per record.
 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
 A hyphen ('-') by itself can be used to indicate the standard
 input, and may appear multiple times.
+The
+.I \-u
+option forces output after each record (i.e., one run through inputs).
 .SH EXAMPLE
 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 -t file1.dbl file2.dbl file3.dbl file4.dbl > combined.dbl
+rlam \-id3 file1.dbl file2.dbl file3.dbl file4.dbl > combined.dbl
 .SH AUTHOR
 Greg Ward
 .SH "SEE ALSO"