--- ray/doc/man/man1/pvalue.1	2004/01/01 19:31:45	1.4
+++ ray/doc/man/man1/pvalue.1	2010/12/16 21:34:41	1.8
@@ -1,4 +1,4 @@
-.\" RCSid "$Id: pvalue.1,v 1.4 2004/01/01 19:31:45 greg Exp $"
+.\" RCSid "$Id: pvalue.1,v 1.8 2010/12/16 21:34:41 greg Exp $"
 .TH PVALUE 1 1/15/99 RADIANCE
 .SH NAME
 pvalue - convert RADIANCE picture to/from alternate formats
@@ -48,9 +48,12 @@ turns this option off, which is the default.
 .TP
 .BR \-o
 Print original values, before exposure compensation.
+If the input file is in XYZE format, the Y (green) channel
+will correspond to units of candelas/meter^2.
+Otherwise, the RGB values should be in spectral watts/steradian/meter^2.
 Specifying
 .I \+o
-uses final values, which is the default.
+uses final exposed values, which is the default.
 .TP
 .BR \-h
 Do not print header.
@@ -177,6 +180,14 @@ Specifying
 converts from a Radiance picture to other values, which is the
 default.
 .TP
+.BI \-p " xr yr xg yg xb yb xw yw"
+On reverse conversion, RGB input uses the given set of color primaries.
+These are written into the output header with the PRIMARIES variable.
+.TP
+.BR \-pXYZ
+On reverse conversion, input is in CIE XYZ coordinates, rather than RGB.
+The Y channel is assumed to be in candelas/meter^2.
+.TP
 .BI -y \ res
 Set the output y resolution to
 .I res.
@@ -207,7 +218,7 @@ options determines whether the scanlines are sorted al
 x or along y.
 Most Radiance pictures are sorted top to bottom, then left
 to right.
-This corresponds to a specification of the form "-y yres +x xres".
+This corresponds to a specification of the form "\-y yres +x xres".
 Either an upper or lower case 'X' may be used for this option.
 Like the
 .I \-y
@@ -217,14 +228,14 @@ options have no effect for forward conversions.
 .SH EXAMPLE
 To look at the original, unique pixels in picture:
 .IP "" .2i
-pvalue -o -u picture | more
+pvalue \-o \-u picture | more
 .PP
 To convert from a 512x400 8-bit greyscale image in bottom to top,
 left to right scanline ordering:
 .IP "" .2i
-pvalue -r -db -b -h +y 400 +x 512 input.im > flipped.pic
+pvalue \-r \-db \-b \-h +y 400 +x 512 input.im > flipped.hdr
 .br
-pflip -v flipped.pic > final.pic
+pflip \-v flipped.hdr > final.hdr
 .SH AUTHOR
 Greg Ward
 .SH BUGS
@@ -238,4 +249,4 @@ conversion, so this information is not used in determi
 the scanline ordering or picture size.
 .SH "SEE ALSO"
 getinfo(1), pcompos(1), pfilt(1), pflip(1),
-protate(1), rpict(1), rtrace(1), rvu(1)
+protate(1), ra_xyze(1), rpict(1), rtrace(1), rvu(1)