--- ray/doc/man/man1/rlam.1 2005/10/05 05:20:50 1.4 +++ ray/doc/man/man1/rlam.1 2010/06/18 21:22:49 1.7 @@ -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.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,13 +7,19 @@ 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 @@ -42,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 @@ -60,18 +71,21 @@ 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 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"