| 1 | .\" RCSid "$Id$" | 
| 2 | .TH RLAM 1 7/8/97 RADIANCE | 
| 3 | .SH NAME | 
| 4 | rlam - laminate lines (records) from multiple files | 
| 5 | .SH SYNOPSIS | 
| 6 | .B rlam | 
| 7 | [ | 
| 8 | .B \-tC | 
| 9 | ] | 
| 10 | input1 input2 .. | 
| 11 | .SH DESCRIPTION | 
| 12 | .I Rlam | 
| 13 | simply joins lines from multiple inputs, separating them with | 
| 14 | the given tab character (TAB by default). | 
| 15 | An input is either a stream or a command. | 
| 16 | Commands are given in quotes, and begin with an exclamantion point ('!'). | 
| 17 | If the inputs do not have the same number of lines, then | 
| 18 | shorter files will stop contributing to the output as they | 
| 19 | run out. | 
| 20 | .PP | 
| 21 | A hyphen ('-') by itself can be used to indicate the standard | 
| 22 | input. | 
| 23 | .SH EXAMPLE | 
| 24 | To join files output1 and output2, separated by a comma: | 
| 25 | .IP "" .2i | 
| 26 | rlam -t, output1 output2 | 
| 27 | .PP | 
| 28 | To join a file with line numbers (starting at 0) and its reverse: | 
| 29 | .IP "" .2i | 
| 30 | cnt `wc -l < lam.c` | rlam - -t: lam.c -t\| '\!tail -r lam.c' | 
| 31 | .SH AUTHOR | 
| 32 | Greg Ward | 
| 33 | .SH "SEE ALSO" | 
| 34 | cnt(1), neaten(1), rcalc(1), tabfunc(1), total(1) |