--- ray/doc/man/man1/rcollate.1 2019/11/11 18:50:07 1.13 +++ ray/doc/man/man1/rcollate.1 2022/03/15 00:25:50 1.15 @@ -1,5 +1,5 @@ -.\" RCSid "$Id: rcollate.1,v 1.13 2019/11/11 18:50:07 greg Exp $" -.TH RCOLLATE 1 7/8/97 RADIANCE +.\" RCSid "$Id: rcollate.1,v 1.15 2022/03/15 00:25:50 greg Exp $" +.TH RCOLLATE 1 9/5/2013 RADIANCE .SH NAME rcollate - resize or re-order matrix data .SH SYNOPSIS @@ -9,8 +9,10 @@ rcollate - resize or re-order matrix data ][ .B \-w ][ -.B \-f[afdb][N] +.B \-c ][ +.B \-f{a|f|d|b}[N] +][ .B \-t ][ .B "\-ic in_col" @@ -61,6 +63,16 @@ The .I \-w option turns off non-fatal warning messages, such as unexpected EOD. .PP +Normally, +.I rcollate +detects whether any transformation is actually taking place, and will +reproduce the data verbatim if the input size and shape should be unaltered. +The +.I \-c +opiton forces the operation to proceed, even if it appears to be a no-op, +which can be useful to correct a misshapen input matrix or check that +the data is the proper size. +.PP The input format is assumed to be ASCII, with three white-space separated words (typically numbers) in each record. A different input format may be specified with the @@ -163,5 +175,5 @@ without a transpose or re-ordering, .I rcollate issues a warning and simply copies its input to its standard output. .SH "SEE ALSO" -cnt(1), histo(1), neaten(1), rcalc(1), rlam(1), rmtxop(1), +cnt(1), histo(1), neaten(1), rcalc(1), rcrop(1), rlam(1), rmtxop(1), rsplit(1), tabfunc(1), total(1)