--- ray/doc/man/man1/rcollate.1 2013/09/05 18:50:30 1.2 +++ ray/doc/man/man1/rcollate.1 2014/05/30 00:00:54 1.5 @@ -1,4 +1,4 @@ -.\" RCSid "$Id: rcollate.1,v 1.2 2013/09/05 18:50:30 greg Exp $" +.\" RCSid "$Id: rcollate.1,v 1.5 2014/05/30 00:00:54 greg Exp $" .TH RCOLLATE 1 7/8/97 RADIANCE .SH NAME rcollate - resize or transpose matrix data @@ -7,6 +7,8 @@ rcollate - resize or transpose matrix data [ .B \-h ][ +.B \-w +][ .B \-f[afdb][N]] ][ .B \-t @@ -32,6 +34,9 @@ By default, the file is assumed to include an informat is copied to the standard output along with the command name, but the .I \-h option may be used to turn this behavior off. +The +.I \-w +option turns off non-fatal warning messages, such as unexpected EOD. .PP The input format is assumed to be ASCII, with three white-space separated words (typically numbers) in each record. @@ -64,6 +69,16 @@ Note that the lack of row separators in binary files m does not actually do anything for binary files unless the transpose option is given, also. .PP +If an input header is present, it may contain the format, number of components +and matrix dimensions. +In such cases, the +.I \-ic, +.I \-ir +and +.I \-f +options are not required, but will be checked against the header +information if provided. +.PP The transpose option, .I \-t swaps rows and columns on the input. @@ -83,7 +98,7 @@ For large transpose operations on Unix systems, it is to specify the input file on the command line, rather than reading from the standard input, since .I rcollate -can map the file directly into memory. +can map the file directly into virtual memory. .SH EXAMPLE To change put 8760 color triplets per row in a matrix with no header: .IP "" .2i