--- ray/doc/man/man1/rad.1	2008/03/11 02:21:45	1.6
+++ ray/doc/man/man1/rad.1	2015/05/26 10:00:46	1.11
@@ -1,4 +1,4 @@
-.\" RCSid "$Id: rad.1,v 1.6 2008/03/11 02:21:45 greg Exp $"
+.\" RCSid "$Id: rad.1,v 1.11 2015/05/26 10:00:46 greg Exp $"
 .TH RAD 1 2/1/99 RADIANCE
 .SH NAME
 rad - render a RADIANCE scene
@@ -7,7 +7,7 @@ rad - render a RADIANCE scene
 [
 .B \-s
 ][
-.B "-n|-N npr"
+.B "-n | -N npr"
 ][
 .B \-t
 ][
@@ -371,7 +371,7 @@ The default value is 0.
 .BR PICTURE
 This is the root name of the output picture file(s).
 This name will have appended the view identifier (or a number if no
-id was used) and a ".pic" suffix.
+id was used) and a ".hdr" suffix.
 If a picture corresponding to a specific view exists and is not out
 of date with respect to the given octree, it will not be
 re-rendered.
@@ -439,6 +439,25 @@ For a space with penetrating sunlight casting bright p
 few places, it should be set to HIGH.
 The default value is "L".
 .TP
+.BR PGMAP
+This variable designates a global photon map to be generated by
+.I mkpmap(1)
+and used to accelerate rendering.
+The file name must be followed by the number of photons to be stored
+in the map, and this number may be followed by a bandwidth for rendering.
+There is no default value, meaning that a global photon map will not
+normally be created.
+.TP
+.BR PCMAP
+This variable designates a caustic photon map to be generated by
+.I mkpmap(1)
+and used during renderings to model light transmission by reflecting
+and refracting surfaces.
+The file name must be followed by the number of photons to be stored
+in the map, and this number may be followed by a bandwidth for rendering.
+There is no default value, meaning that a caustic photon map will not
+normally be created.
+.TP
 .BR OPTFILE
 This is the name of a file in which
 .I rad
@@ -472,6 +491,8 @@ There is no default value for this variable.
 .BR oconv
 This variable may be used to specify special options to
 .I oconv.
+If the first word of the first instance of this variable is not an option,
+it will be used in place of the default command path, "oconv".
 See the
 .I oconv(1)
 manual page for a list of valid options.
@@ -479,10 +500,21 @@ manual page for a list of valid options.
 .BR mkillum
 This variable may be used to specify additional options to
 .I mkillum.
+If the first word of the first instance of this variable is not an option,
+it will be used in place of the default command path, "mkillum".
 See the
 .I rtrace(1)
 manual page for a list of valid options.
 .TP
+.BR mkpmap
+This variable may be used to specify additional options to
+.I mkpmap.
+If the first word of the first instance of this variable is not an option,
+it will be used in place of the default command path, "mkpmap".
+See the
+.I mkpmap(1)
+manual page for a list of valid options.
+.TP
 .BR render
 This variable may be used to specify additional options to
 .I rpict
@@ -492,9 +524,29 @@ These options will appear after the options set automa
 .I rad,
 and thus will override the default values.
 .TP
+.BR rpict
+This variable may be used to specify overriding options specific to
+.I rpict.
+If the first word of the first instance of this variable is not an option,
+it will be used in place of the default command path, "rpict".
+See the
+.I rpict(1)
+man page for a list of valid options.
+.TP
+.BR rvu
+This variable may be used to specify overriding options specific to
+.I rvu.
+If the first word of the first instance of this variable is not an option,
+it will be used in place of the default command path, "rvu".
+See the
+.I rvu(1)
+man page for a list of valid options.
+.TP
 .BR pfilt
 This variable may be used to specify additional options to
 .I pfilt.
+If the first word of the first instance of this variable is not an option,
+it will be used in place of the default command path, "pfilt".
 See the
 .I pfilt(1)
 manual page for details.
@@ -555,6 +607,10 @@ rad \-V \-v Zl \-n \-s sample.rif > plan.vf	# make a p
 rad \-t sample.rif		# update files after minor change to input
 .br
 rad \-s sample.rif &		# execute silently in the background
+.br
+rad \-N 2 sample.rif	# render views using two parallel rpict calls
+.br
+rad \-N 4 -v 1 sample.rif	# render first view with four rpiece calls
 .PP
 If we decide that the default values
 .I rad
@@ -567,7 +623,7 @@ DET= low		# default was medium - our space is almost e
 PEN= True		# we want to see soft shadows from our window
 VAR= hi		# daylight can result in fairly harsh lighting
 view= XYa \-vv 120	# let's try a fisheye view
-PICT= tutor		# our picture name will be "tutor_XYa.pic"
+PICT= tutor		# our picture name will be "tutor_XYa.hdr"
 .fi
 .PP
 Note the use of abbreviations, and the modification of a standard
@@ -616,6 +672,17 @@ $(PICTURE)_$(view).unf	Unfinished output of
 .SH AUTHOR
 Greg Ward
 .SH BUGS
+You cannot run more than one
+.I rad
+process at a time on the same input file,
+as the second process will attempt to recover the output files
+of the first process, damaging the results.
+The exceptions to this are running interactively via the
+.I \-o
+option, or rendering different views using the
+.I \-v
+option.
+.PP
 Incremental building of octrees is not supported as it would add
 considerable complexity to
 .I rad.
@@ -652,6 +719,7 @@ accurately determine the ambient value for
 The use of upper and lower case naming for the standard views may be
 problematic on systems that don't distinguish case in filenames.
 .SH "SEE ALSO"
-glrad(1), make(1), mkillum(1), objview(1), oconv(1),
+glrad(1), make(1), mkillum(1), mkpmap(1), objview(1), oconv(1),
 pfilt(1), raddepend(1), ranimate(1),
-rholo(1), rpict(1), rtrace(1), rvu(1), touch(1), vgaimage(1), ximage(1)
+rholo(1), rpict(1), rpiece(1), rtrace(1), rvu(1),
+touch(1), vgaimage(1), ximage(1)