--- ray/doc/man/man1/pabopto2xyz.1	2021/06/21 17:19:01	1.2
+++ ray/doc/man/man1/pabopto2xyz.1	2025/04/11 20:54:38	1.3
@@ -1,4 +1,4 @@
-.\" RCSid "$Id: pabopto2xyz.1,v 1.2 2021/06/21 17:19:01 greg Exp $"
+.\" RCSid "$Id: pabopto2xyz.1,v 1.3 2025/04/11 20:54:38 greg Exp $"
 .TH PABOPTO2XYZ 1 3/1/2021 RADIANCE
 .SH NAME
 pabopto2xyz - convert a collection of single-channel BSDF measurements to CIE-XYZ colorimetry
@@ -35,12 +35,13 @@ The
 option may be supplied on Unix systems for multiple processes to speed up
 the conversion.
 .PP
-The BSDF measurement file names are listed the three required input text files,
+The BSDF measurement file names must be listed in
+the three required input files,
 dileneated in each by white space.
-File names or paths therein cannot contain white space, and quoting/escaping
+File names or paths therein may not contain white space, and quoting/escaping
 is not supported.
-The same incident directions must be provided in all three measurement sets, but may
-be broken into different files.
+The same incident directions must be provided in all three measurement sets,
+but may be broken into different files.
 (I.e., two or more BSDF files may correspond to the same incident direction.)\0
 Only one file will be produced for each incident direction in the output.
 .PP
@@ -51,6 +52,8 @@ A 2-D interpolant is applied at each incident directio
 the given 3x3 matrix is applied,
 and a combined virtual measurement is produced in output files beginning with
 the given base name.
+For this reason, it is often preferably to place the "green" or "near-Y"
+channel first.
 .PP
 The combined data files produced by
 .I pabopto2xyz
@@ -62,7 +65,7 @@ processing.
 To combine three sets of measurements in a REC709 color space and produce
 a CIE-XYZ file for pabopto2bsdf, which produces a color SIR file:
 .IP "" .2i
-pabopto2xyz -m .412 .358 .180 .213 .715 .072 .019 .119 .951 -o blinds_xyz filesR.txt filesG.txt filesB.txt
+pabopto2xyz -m .358 .412 .180 .715 .213 .072 .119 .019 .951 -o blinds_xyz filesG.txt filesR.txt filesB.txt
 .br
 pabopto2bsdf blinds_xyz*.txt > blinds_xyz.sir
 .SH AUTHOR