--- ray/doc/man/man1/ximage.1	2003/12/09 15:59:07	1.3
+++ ray/doc/man/man1/ximage.1	2024/09/10 20:24:42	1.10
@@ -1,4 +1,4 @@
-.\" RCSid "$Id: ximage.1,v 1.3 2003/12/09 15:59:07 greg Exp $"
+.\" RCSid "$Id: ximage.1,v 1.10 2024/09/10 20:24:42 greg Exp $"
 .TH XIMAGE 1 10/27/98 RADIANCE
 .SH NAME
 ximage - RADIANCE picture display for X window system
@@ -88,7 +88,7 @@ and
 .I \-c
 options, which compensate for human contrast and color sensitivity
 at the corresponding scene luminance levels.
-This option yeilds and appearance of the scene on the display that
+This option yields and appearance of the scene on the display that
 closely matches what would be experienced in the real world.
 .PP
 The
@@ -125,14 +125,16 @@ Redraw the entire image.
 .TP
 .BR <return>
 Display the radiance averaged over the area of interest.
+The maximum of the three (RGB) channels is reported.
 .TP
 .BR l
-Display the luminance value in the area of interest.
+Display the photometrically-weighted luminance value in the area of interest.
 This assumes that the image was correctly computed in terms of
 luminance.
 .TP
 .BR c
-Display the color in the area of interest.
+Display the color in the area of interest, as adjusted by the current
+exposure setting.
 .TP
 .BR p
 Display the x and y location of the cursor.
@@ -140,7 +142,7 @@ Display the x and y location of the cursor.
 .BR i
 Identify identical pixels by assigning a random color at the cursor position.
 This is useful for displaying contours, especially when combined
-with the -b option.
+with the \-b option.
 .TP
 .BR t
 Print information about the pixel under the cursor
@@ -161,7 +163,7 @@ l	luminance value
 .IP
 p	pixel position
 .IP
-The default output is "-ood", which prints
+The default output is "\-ood", which prints
 the ray origin and direction.
 This can be used as input to rtrace(1) to get additional information
 about the image (ie. pipe the output of ximage into rtrace).
@@ -227,6 +229,10 @@ for other windows.
 In addition to the commands listed above, the control or shift key may
 be held while the cursor is dragged to reposition the image within the
 window.
+.SH NOTES
+Hyperspectral Radiance pictures (.hsr files) are understood and crudely
+converted to RGB for display.
+However, the colors may not be very accurate.
 .SH "X RESOURCES"
 radiance.gamma	the default gamma correction value
 .SH ENVIRONMENT
@@ -238,5 +244,6 @@ Anat Grynberg (Paris)
 .br
 Philip Thompson (MIT)
 .SH "SEE ALSO"
-aedimage(1), normtiff(1), pcond(1), pfilt(1), rpict(1), rtrace(1),
-rview(1), xglaresrc(1), xshowtrace(1)
+aedimage(1), normtiff(1), pcond(1), pfilt(1), rcode_depth(1),
+rcode_ident(1), rcode_norm(1), rpict(1), rtrace(1),
+rvu(1), xglaresrc(1), xshowtrace(1)