--- ray/doc/man/man1/rcollate.1	2019/11/08 02:10:38	1.9
+++ ray/doc/man/man1/rcollate.1	2019/11/11 18:38:41	1.12
@@ -1,4 +1,4 @@
-.\" RCSid "$Id: rcollate.1,v 1.9 2019/11/08 02:10:38 greg Exp $"
+.\" RCSid "$Id: rcollate.1,v 1.12 2019/11/11 18:38:41 greg Exp $"
 .TH RCOLLATE 1 7/8/97 RADIANCE
 .SH NAME
 rcollate - resize or transpose matrix data
@@ -42,9 +42,10 @@ option with the number of rows and columns separated b
 for 30 rows by 14 columns.
 .I Rcollate
 can also reorder the input into nested blocks by continuing the output size
-string, "3x10X7x2" would order output data with a 3x10 super-array of 7x2
-subblocks.
-This is a convenient way to visualize tensor data.
+string.
+For example, "3x10X7x2" would order output data with a 3x10 super-array of
+7x2 subblocks.
+This type of block hierarchy is convenient for visualizing tensor data.
 .PP
 By default, the file is assumed to include an information header, which
 is copied to the standard output along with the command name.
@@ -121,6 +122,11 @@ to specify the input file on the command line, rather 
 from the standard input, since
 .I rcollate
 can map the file directly into virtual memory.
+If the
+.I \-o
+option is also given with multiple block levels, the transpose operation
+will logically precede the reblocking operation, regardless of the order
+they are given on the command line.
 .SH EXAMPLES
 To change put 8760 color triplets per row in a matrix with no header:
 .IP "" .2i