--- ray/doc/man/man1/ranimate.1	2003/12/09 15:59:06	1.2
+++ ray/doc/man/man1/ranimate.1	2005/09/17 05:14:14	1.7
@@ -1,4 +1,4 @@
-.\" RCSid "$Id: ranimate.1,v 1.2 2003/12/09 15:59:06 greg Exp $"
+.\" RCSid "$Id: ranimate.1,v 1.7 2005/09/17 05:14:14 greg Exp $"
 .TH RANIMATE 1 6/24/98 RADIANCE
 .SH NAME
 ranimate - compute a RADIANCE animation
@@ -271,6 +271,10 @@ before it is executed.
 Normally, the transfer command does something such as convert the
 frames to another format and/or copy them to tape or some other
 destination device before removing them.
+The
+.I fieldcomb(1)
+script may be used to conveniently combine fields into frames for
+field-based animations.
 If this variable is not given, the final frames are left where they
 are.
 (See
@@ -279,10 +283,10 @@ above.)\0
 .TP
 .BR RSH
 The command to use instead of
-.I rsh(1)
+.I ssh(1)
 to execute commands remotely on another machine.
 The arguments and behavior of this program must be identical to the UNIX
-.I rsh
+.I ssh
 command, except that the
 .I -l
 option will always be used to specify an alternate user name rather than the
@@ -294,7 +298,7 @@ option may or may not appear, but the
 .I -n
 option will always be used, and the expected starting directory will
 be that of the remote user, just as with
-.I rsh.
+.I ssh.
 .TP
 .BR NEXTANIM
 This variable specifies the next
@@ -352,14 +356,35 @@ If this number is less than 2, then bluring is perform
 only, resulting in greater noise than the combination of
 .I rpict
 and
-.I pinterp used otherwise.
+.I pinterp
+used otherwise.
 (The default value for number of samples is 5.)\0
-The
-.I pmblur(1)
-command is used to generate the given number of additional views for
+The default fraction is 0, meaning no motion blurring.
+This option does not currently work with the
+.I ANIMATE
+variable, since pinterp only works for static environments.
+.TP
+.BR DBLUR
+This variable specifies the aperture diameter for depth-of-field blurring,
+in world units.
+A number of samples may be given as a second argument, which controls the
+number of additional frames computed and averaged together by
+.I pinterp.
+If this number is less than 2, then blurring is performed by
+.I rpict
+only, resulting in greater noise than the combination of
+.I rpict
+and
 .I pinterp
-to average together.
-The default value is 0, meaning no motion blurring.
+used otherwise.
+(The default value for number of samples is 5.)\0
+To simulate a particular camera's aperture, divide the focal length of
+the lens by the f-number, then convert to the corresponding
+world coordinate units.
+For example, if you wish to simulate a 50mm lens at f/2.0 in
+a scene modeled in meters, then you divide 50mm by 2.0 to get 25mm,
+which corresponds to an effective aperture of 0.025 meters.
+The default aperture is 0, meaning no depth-of-field blurring.
 This option does not currently work with the
 .I ANIMATE
 variable, since pinterp only works for static environments.
@@ -560,7 +585,7 @@ to set whatever variables are important in the remote 
 This requirement may be circumvented by substituting the
 .I on(1)
 command for
-.I rsh(1)
+.I ssh(1)
 using the
 .I RSH
 control variable, or by writing a custom remote execution script.
@@ -584,5 +609,5 @@ is called if INTERPOLATE > 0 and/or MBLUR is assigned.
 Since most modern machines use IEEE floating point, this is not
 usually a problem, but it is something to keep in mind.
 .SH "SEE ALSO"
-pfilt(1), pinterp(1), pmblur(1), rad(1),
-ranimove(1), rpict(1), rsh(1), rtrace(1)
+fieldcomb(1), pfilt(1), pinterp(1), pmblur(1), rad(1),
+ran2tiff(1), ranimove(1), rpict(1), ssh(1), rtrace(1)