--- ray/doc/man/man1/rhpict.1	2003/03/11 19:20:21	1.1
+++ ray/doc/man/man1/rhpict.1	2008/11/10 19:08:17	1.6
@@ -1,4 +1,4 @@
-.\" RCSid "$Id"
+.\" RCSid "$Id: rhpict.1,v 1.6 2008/11/10 19:08:17 greg Exp $"
 .TH RHPICT 1 3/10/99 RADIANCE
 .SH NAME
 rhpict - render a RADIANCE picture from a holodeck file
@@ -84,13 +84,21 @@ A cylindrical panorma may be selected by setting
 to the letter 'c'.
 This view is like a standard perspective vertically, but projected
 on a cylinder horizontally (like a soupcan's-eye view).
-Two fisheye views are provided as well; 'h' yields a hemispherical fisheye
-view and 'a' results in angular fisheye distortion.
+Three fisheye views are provided as well; 'h' yields a hemispherical fisheye
+view, 'a' results in angular fisheye distortion, and 's'
+results in a planisphere (stereographic) projection.
 A hemispherical fisheye is a projection of the hemisphere onto a circle.
 The maximum view angle for this type is 180 degrees.
 An angular fisheye view is defined such that distance from the center of
 the image is proportional to the angle from the central view direction.
 An angular fisheye can display a full 360 degrees.
+A planisphere fisheye view maintains angular relationships between lines,
+and is commonly used for sun path analysis.
+This is more commonly known as a
+"stereographic projection," but we avoid the term here so as not to
+confuse it with a stereoscopic pair.
+A planisphere fisheye can display up to (but not including) 360 degrees,
+although distortion becomes extreme as this limit is approached.
 Note that there is no space between the view type
 option and its single letter argument.
 .TP
@@ -163,7 +171,7 @@ This is option is useful for generating skewed perspec
 rendering an image a piece at a time.
 A value of 1 means that the rendered image starts just to the right of
 the normal view.
-A value of -1 would be to the left.
+A value of \-1 would be to the left.
 Larger or fractional values are permitted as well.
 .TP
 .BI -vl \ val
@@ -177,7 +185,7 @@ option.
 .BI -vf \ file
 Get view parameters from
 .I file,
-which may be a picture or a file created by rview (with the "view" command).
+which may be a picture or a file created by rvu (with the "view" command).
 .TP
 .BI -S \ seqstart
 Instead of generating a single picture based only on the view
@@ -213,11 +221,11 @@ the current frame number.
 .BR \-w
 Turn off warning messages.
 .SH EXAMPLE
-rhpict -vp 10 5 3 -vd 1 -.5 0 scene.hdk > scene.pic
+rhpict \-vp 10 5 3 \-vd 1 \-.5 0 scene.hdk > scene.hdr
 .PP
-rpict -S 1 -o frame%02d.pic scene.hdk < keyframes.vf
+rpict \-S 1 \-o frame%02d.hdr scene.hdk < keyframes.vf
 .SH AUTHOR
 Greg Ward
 .SH "SEE ALSO"
 getinfo(1), pfilt(1), pinterp(1),
-printf(3), ra_rgbe(1), rholo(1), rpict(1), rview(1)
+printf(3), ra_rgbe(1), rholo(1), rpict(1), rvu(1)