--- ray/src/util/trad.hlp	1994/10/27 15:56:04	2.1
+++ ray/src/util/trad.hlp	2015/05/27 13:16:11	2.25
@@ -1,9 +1,9 @@
-	$Id: trad.hlp,v 2.1 1994/10/27 15:56:04 greg Exp $
+	trad.hlp 2.18 10/20/98
 
 This help file is associated with the trad interface to the Radiance
 rad(1) program.  Trad consists of trad.wsh and one do_*.tcl file for
-each screen.  There are currently seven such screens:  Action, File,
-Options, Results, Scene, Views and Zone.
+each screen.  There are currently seven such screens:  File, Scene,
+Zone, Views, Options, Action and Results.
 
 .Trad.Intro
 
@@ -48,6 +48,8 @@ the left mouse button while holding the control key ov
 curiosity in the main trad window.
 (In general, only active windows are given help file links -- click
 on these rather than the text labels.)
+Additional search capabilities are available over all topics using
+the "Grep" button.
 
 For help on the help facility itself, Control-click on the problem
 help widget or on the window title in the upper right corner for
@@ -55,17 +57,11 @@ more general information.
 (To get back to trad-specific help, press the "HELP" button in the
 main trad window or Control-click on a trad widget.)
 
-Once the help window has been displayed, it is usually best to
-lower or iconify it rather than dismissing it if further help is
-needed.
-This way, you will not have to wait for the help file to be read in
-all over again every time you have a question.
-
 .Trad.Messages
 
-Informative messages, commands executed by rad, and errors 
+Informative messages, commands executed by rad, and errors
 appear in the message window at the bottom of the trad frame.
-Growing the trad window means growing this message window, and 
+Growing the trad window means growing this message window, and
 not much else.
 This is not really necessary, since the window will be grown
 automatically if the message requires it.
@@ -110,9 +106,7 @@ it is saved.
 Loading a writable file always clears the "Read Only" check box.
 
 If an error is encountered while trying to load the file, a message
-will be printed in the box at the bottom and it will be necessary to
-load another file.
-(I.e. any previous information will be lost.)
+will be printed in the box at the bottom.
 
 .File.Save
 
@@ -341,7 +335,7 @@ All other variables will be unaffected.
 
 .Scene.Revert
 
-The "Revert" button is a convenient way to revert to the original 
+The "Revert" button is a convenient way to revert to the original
 values in the rad input file.
 Only the variables on the Scene screen will be affected, but any changes
 to these variables since the last save will be lost.
@@ -355,11 +349,11 @@ This zone need not correspond exactly to any interior 
 walls, as it is used primarily to set rendering parameters and
 standard viewpoints.
 
-An interior zone means that standard viewpoints will be selected 
+An interior zone means that standard viewpoints will be selected
 from the inside of this box.
 An exterior zone means that standard viewpoints will be selected
 from the outside of this box.
-The default zone is an exterior one computed from the bounding box 
+The default zone is an exterior one computed from the bounding box
 of the entire scene.
 (Note that this is not usually desirable.)
 
@@ -373,9 +367,9 @@ the rad manual page.
 
 .Zone.Type
 
-There are two types of zones understood by rad, "Interior" and 
+There are two types of zones understood by rad, "Interior" and
 "Exterior".
-An interior zone is indicated when renderings generally take place 
+An interior zone is indicated when renderings generally take place
 inside a specified 3-d box.
 A typical example might be a single room or auditorium.
 An exterior zone is indicated when renderings generally take place
@@ -404,11 +398,26 @@ long as the overall size of the given box is close to 
 size of the space.
 
 The Zone entry windows may be manipulated in the following ways.
-Control-U clears the current window.
 Control-V pastes the contents of the current selection at the
 insertion point.
 Return moves the focus to the next window in the chain.
 
+The "Auto" button may be used to set these values based on the bounding
+box of one or more Radiance scene files.
+
+.Zone.Auto
+
+Use this button to automatically determine the bounding box for this
+zone, based on the output of the "getbbox" command run on one or
+more Radiance scene files.
+The appropriate scene files are entered via a file
+selection dialogue box, which comes up after the button is pressed.
+
+The reason for selecting specific files rather than running getbbox
+on the entire scene is that a zone usually does not include large
+external objects, which may be present in the complete scene
+description.
+
 .Zone.Detail
 
 The "Detail" setting indicates the relative level
@@ -478,7 +487,7 @@ an important parameter for rendering accuracy.
 
 There are two basic ways to compute the exposure value.
 The first is by trial and error, where the value is adjusted up and
-down within rview using the "e = value" command.
+down within rvu using the "e = value" command.
 Though it sounds flaky, this is the most reliable way to set the
 exposure (and ambient level) in general lighting situations.
 
@@ -496,7 +505,7 @@ tot_flux is given in watts.
 (Divide total lumens by 179 lumens/watt to get watts.)
 
 The exposure value may either be given as a positive real value, or
-as a real value preceeded by a '+' or '-' indicating a positive or
+as a real value preceded by a '+' or '-' indicating a positive or
 negative number of f-stops (powers of two) from the original value.
 
 If no exposure is given, pfilt will automatically compute the
@@ -507,14 +516,14 @@ used for exterior zones and 0.01 for interior zones.
 
 The "Copy" button on the Zone screen takes all values for this
 screen from another rad input file, replacing the current values.
-Specifically, the rad variables "ZONE, DETAIL, INDIRECT, 
+Specifically, the rad variables "ZONE, DETAIL, INDIRECT,
 VARIABILITY and EXPOSURE" will be copied from the named file.
 
 All other variables will be left untouched.
 
 .Zone.Revert
 
-The "Revert" button is a convenient way to revert to the original 
+The "Revert" button is a convenient way to revert to the original
 values in the rad input file.
 Only the variables on the Zone screen will be affected, but any changes
 to these variables since the last save will be lost.
@@ -526,7 +535,7 @@ This screen provides a means of setting the multi-valu
 "view" variable.
 Each view setting is listed by name, or by number if no name has
 been assigned.
-To add a new view, enter a unique name and specify the view 
+To add a new view, enter a unique name and specify the view
 options,
 then press the "Add" or "Set Default" button.
 If a view with the same name already exists, it is unconditionally
@@ -536,7 +545,7 @@ and/or parameters, and press the "Change" button.
 To remove an unwanted view, select it and press the "Delete" button.
 To undo this action, simply press the "Add" button again.
 
-The first view in the list is the default given to rview during 
+The first view in the list is the default given to rvu during
 interactive rendering, and is the first view rendered in a batch run.
 To change the default view, select the newly desired view and press
 the "Set Default" button.
@@ -571,21 +580,21 @@ The standard view is "X" is used if no views are speci
 
 Each view has a unique name, which may be chosen at the user's
 discretion or taken from a list of standard views, described below.
-An invented name should be kept as short as possible, since it is 
+An invented name should be kept as short as possible, since it is
 added to the picture file name along with the standard ".pic" suffix.
 
 The standard views are specified by strings of the form
-"[Xx]?[Yy]?[Zz]?[vlah]?".
+"[Xx]?[Yy]?[Zz]?[vlahsc]?".
 (That is, an optional upper or lower case X followed by an optional
 upper or lower case Y followed by an optional upper or lower case Z
-followed by an optional lower case V, L, A or H.)
+followed by an optional lower case view type.)
 The letters indicate the desired view position, where upper case "X"
 means maximum X, lower case "y" means minimum Y and so on.
 The final letter is the view type, where 'v' is perspective (the
-default), 'l' is parallel, 'a' is angular fisheye, and 'h' is
-hemispherical fisheye.
-A perspective view from maximum X, minimum Y would be "Xy" or 
-"Xyv".
+default), 'l' is parallel, 'a' is angular fisheye, 'h' is
+hemispherical fisheye, 's' is for planisphere (stereographic) fisheye,
+and 'c' is for cylindrical panorama.
+A perspective view from maximum X, minimum Y would be "Xy" or "Xyv".
 A parallel view from maximum Z would be "Zl".
 If "ZONE" is an interior zone, the standard views will
 be inside the perimeter.
@@ -605,7 +614,7 @@ Otherwise, it is usually necessary to specify a set of
 define a view.
 
 The simplest view specification is of the form "-vf viewfile", where
-"viewfile" is a file created with the rview "view" command, or a
+"viewfile" is a file created with the rvu "view" command, or a
 Radiance picture.
 This method of naming views, although convenient, is not the best
 since it is difficult to know exactly where such a view is by
@@ -624,9 +633,10 @@ interaction mode for trad.
 Consult the rpict(1) manual page for a full description of the various
 view options, all of which begin with "-v".
 Just briefly, the "-vt?" option sets the view type, where "?" is
-replaced by one of the letters "v, l, a or h", corresponding to
-perspective, parallel, angular and hemispherical fisheye, respectively.
-The "-vp x y z" option sets the view position (eyepoint), where "x y z" 
+replaced by one of the letters "v, l, a, h, s or c", corresponding to
+perspective, parallel, angular fisheye, hemispherical fisheye
+and cylindrical panorama, respectively.
+The "-vp x y z" option sets the view position (eyepoint), where "x y z"
 is replaced by the position in 3-space.
 The "-vd xd yd zd" option sets the view direction, where "xd yd zd"
 is a vector pointing in the desired direction.
@@ -635,7 +645,7 @@ the eyepoint from the look-at point.  Vector normaliza
 unnecessary.)
 The "-vh horiz" and "-vv vert" options set the horizontal and
 vertical view sizes, respectively.
-For perspective views, these correspond to full camera angles in 
+For perspective views, these correspond to full camera angles in
 degrees.
 For parallel views (using the "-vtl" option), they correspond to
 image plane size in world coordinates.
@@ -650,7 +660,7 @@ In particular, make sure that each option and each arg
 space between it and whatever follows.
 
 Hitting return in the "Options" window is equivalent to pressing the
-"Add" button.
+"Add" button followed by the "Clear" button.
 
 .Views.Add
 
@@ -687,15 +697,12 @@ The "Clear" button simply clears the "Name" and "Optio
 for the convenience of entering a new view.
 It has no effect on the rad input variables.
 
-Note that Control-U will always clear an entry box whose cursor is
-active.
-
 .Views.Default
 
 The "Set Default" button may be used to make the selected view the
 default view for rendering.
 This simply moves the view to the top of the list in the rad input file.
-The default view will be the one normally rendered by rview when rad
+The default view will be the one normally rendered by rvu when rad
 is started interactively, and is the first view rendered in a batch
 process.
 
@@ -712,10 +719,19 @@ The standard view up vector may be set to the positive
 the positive Y axis (+Y), the positive Z axis (+Z), the negative
 X axis (-X), the negative Y axis (-Y), or the negative Z axis (-Z).
 
-This setting may always be overriden by the "-vu xd yd zd" option,
+This setting may always be overridden by the "-vu xd yd zd" option,
 and will be altered for a particular view if it happens to be
 parallel to the view direction.
 
+.Views.Eyesep
+
+The eye separation is used for generating stereo views of
+the scene.
+It is the measured distance between a viewer's pupils in world
+coordinate units.
+It is not used directly by rad, but should be set for other programs
+that need it, such as rholo and glrad.
+
 .Views.Picture
 
 The root picture file name is given in the "Picture" entry window.
@@ -751,6 +767,41 @@ to maintain a specific pixel aspect ratio (1 by defaul
 
 The default value for this variable is "512".
 
+.Views.Rawfile
+
+The "Rawfile" entry window determines if and where the raw output picture
+from rpict will be saved.
+If the entry is empty, the file will be removed after rendering and
+filtering.
+This is the normal action, since the raw file
+takes up disk space and is not generally useful.
+However, if you wish to perform some special filtering function,
+this file can be renamed instead of removed by giving a
+root file name in this entry window.
+The final name in this case will be the given root plus and
+underscore plus the view name followed by a ".pic" suffix.
+
+In the special case when the raw file name and picture file name are
+the same, the raw file is saved and no filtering takes place.
+
+.Views.Zfile
+
+The "Zfile" entry window gives the root name of the file in which to
+store the raw (binary floating point) distances to pixels in the
+original generated image.
+If this entry is empty, then no z-file will be saved.
+
+The final z-file name will be the given root plus an underscore plus
+the view name plus a ".zbf" suffix.
+
+To convert this image to human-readable form, the program "od" will
+work on some systems, or the Radiance "pvalue" program may be used
+to first convert it to a greyscale Radiance picture using the
+options "-r -h -b -df `getinfo -d < pictname`" where "pictname" is
+replaced by the raw picture file name.
+(Getinfo simply gets the original image dimensions, which are not
+stored in the z-file.)
+
 .Views.Copy
 
 The "Copy" button in the Views screen permits those variables
@@ -763,7 +814,7 @@ untouched.
 
 .Views.Revert
 
-The "Revert" button is a convenient way to revert to the original 
+The "Revert" button is a convenient way to revert to the original
 values in the rad input file.
 Only the variables on the Views screen will be affected, but any changes
 to these variables since the last save will be lost.
@@ -787,7 +838,7 @@ The "Report" variable may be used to specify a time in
 minutes) between progress reports.
 
 Other windows allow the user to customize the options to oconv(1),
-mkillum(1), rview(1) and rpict(1), and pfilt(1).
+mkillum(1), rvu(1) and rpict(1), and pfilt(1).
 
 .Options.Quality
 
@@ -822,7 +873,7 @@ details.)
 
 .Options.Penumbras
 
-The "Penumbras" setting determines whether or not Radiance will 
+The "Penumbras" setting determines whether or not Radiance will
 make a special effort to generate soft shadows from area light sources.
 Since this is a potentially expensive calculation, penumbras should
 only be switched "On" when they are really needed.
@@ -832,6 +883,47 @@ will be treated as points.
 It only means that some accuracy and possibly some smoothness
 will be traded for speed in the shadow calculations.
 
+.Options.Pgmap
+
+The "Pgmap" specifies the file to hold the global photons computed
+by the "mkpmap" command, followed by the number of photons to generate
+(required).
+A typical photon count for a global map is on the order of 100-200K.
+(A 'K', 'M', or 'G' may follow the value to indicate 1000's, millions,
+or billions of photons.)
+By convention, photon map files are given a ".pmp" suffix.
+An optional third parameter specifies the bandwidth to use 
+for the global photons during rendering, and this value should be
+around 50.
+
+.Options.PgmDelete
+
+The "Delete" button next to the "Pgmap" window on the Options
+screen allows you to remove the named global photon map file.
+This is usually done when a change is made to the "mkpmap" options,
+as the file will be regenerated automatically after most scene changes.
+
+.Options.Pcmap
+
+The "Pcmap" specifies the file to hold the caustic photons computed
+by the "mkpmap" command, followed by the number of photons to generate
+(required).
+A typical photon count for a global map is on the order of 1000K (1M).
+(A 'K', 'M', or 'G' may follow the value to indicate 1000's, millions,
+or billions of photons.)
+By convention, photon map files are given a ".pmp" suffix.
+An optional third parameter specifies the bandwidth to use 
+for the global photons during rendering, and this value should be
+around 50.
+(See the "Pgmap" topic under the current help category.)
+
+.Options.PcmDelete
+
+The "Delete" button next to the "Pcmap" window on the Options
+screen allows you to remove the named caustic photon map file.
+This is usually done when a change is made to the "mkpmap" options,
+as the file will be regenerated automatically after most scene changes.
+
 .Options.Ambfile
 
 The "Ambfile" is the file used to store Radiance ambient values for
@@ -850,7 +942,7 @@ vary according to the location and characteristics of 
 
 .Options.AmbDelete
 
-The "Delete" button next to the "Ambfile" window on the Options 
+The "Delete" button next to the "Ambfile" window on the Options
 screens allows you to remove the named ambient file.
 This is usually done when a change to one or more rad variables
 casts doubt on the accuracy of the values stored in this file.
@@ -865,7 +957,7 @@ effort.
 
 The "Optfile" setting assigns a file to hold rendering options,
 which may be a convenience when these options are reused for
-rtrace(1) or rpiece(1), or manual invocations of rview or rpict.
+rtrace(1) or rpiece(1), or manual invocations of rvu or rpict.
 Using an options file also reduces the size of the command line,
 making it a little easier on the eye.
 
@@ -881,12 +973,12 @@ a given rendering has progressed.
 Normally, progress reports and errors during batch renderings
 are sent to the error file given by the root of the rad input
 file name followed by the ".err" suffix.
-(See the "Errors" topic under the "Action" screen category.)
+(See the "CheckErr" topic under the "Action" screen category.)
 If you wish these reports and errors to be directed to a different
 file, follow the time interval by a space and a file name.
 
 No setting on this variable means do not report rendering progress.
-A zero setting means the same thing, and may be used when a 
+A zero setting means the same thing, and may be used when a
 separate error file is desired but progress reports are not.
 
 .Options.Oconv
@@ -916,18 +1008,25 @@ indicate this by not specifying any illum or scene fil
 .Options.Mkillum
 
 The "mkillum opts" window may be used to specify options to the
-mkillum(1) command, whose options are actually passed to rtrace(1).
+mkillum(1) command.
 These options apply only if there are one or more "Illum" files
 named on the Scene screen.
 
 It is very important to set mkillum options sensibly,
 since rad does not have the intelligence to do it for you.
 
+.Options.Mkpmap
+
+The "mkpmap opts" window may be used to specify options
+to the mkpmap(1) command.
+There are no default values, and rad does not set these
+options intelligently.
+
 .Options.Render
 
 The "render opts" window is used to specify additional options to
-the rview(1) and rpict(1) rendering programs.
-Most of the important parameters are computed by rad, so this 
+the rvu(1) and rpict(1) rendering programs.
+Most of the important parameters are computed by rad, so this
 window is usually used to override specific parameters or to give
 additional information, such as which materials to exclude from the
 interreflection calculation.
@@ -975,12 +1074,12 @@ This screen is where the actual Radiance programs are
 run, usually via rad(1).
 The top row of buttons is used to update the octree following a
 change to one or more input files.
-The "rview" button starts an interactive rendering in the
+The "rvu" button starts an interactive rendering in the
 foreground.
 The next set of buttons provides for the control of a batch
 rendering process, taking place in the background.
 Finally, the bottom set of buttons allows you to preview what would
-happen during a batch rendering, or (equivalently) make a script of 
+happen during a batch rendering, or (equivalently) make a script of
 UNIX commands for later execution.
 
 When the Action screen is first brought up, the message window
@@ -1053,37 +1152,67 @@ by the "Touch" button.
 (This will still cause the ambient file to be removed,
 unfortunately.)
 
-.Action.Rview
+.Action.Rvu
 
-The "rview" button on the Action screen starts an interactive 
-rendering for the selected view, indicated by the menu button 
+The "rvu" button on the Action screen starts an interactive
+rendering for the selected view, indicated by the menu button
 just to the right.
-Other views may be accessed within rview using the "L name" 
-command, and new views can be added with the "V name" 
+Other views may be accessed within rvu using the "L name"
+command, and new views can be added with the "V name"
 command.
-(See the rview(1) man page and the "View" topic in the current 
-help category for more information.)
 
-If the octree is out-of-date, it will be rebuilt before rendering 
+When using the "V" command to change an existing view, do not
+give it an existing name because the previous view will not be overridden.
+Instead, give it a new name (or no name, which will show up as
+a number later), then use the Views screen to override the previous
+view definition with the new one.
+(See the "View" topic in the current
+help category, the "Change" topic under "Views" and the rvu(1)
+manual page for more information.)
+
+If the octree is out-of-date, it will be rebuilt before rendering
 begins.
 
 .Action.View
 
 The Action screen contains two menus for selecting views.
-The top menu, next to the "rview" button, sets the view to start 
-with in rview, and is selected from the current view list.
-The second view menu, next to the "Start" button for batch 
+The top menu, next to the "rvu" button, sets the view to start
+with in rvu, and is selected from the current view list.
+The second view menu, next to the "Start" button for batch
 rendering, selects the view or views to render in batch mode.
-If the special entry "ALL" is selected, then every view in the 
+If the special entry "ALL" is selected, then every view in the
 current list will be rendered if it hasn't been already.
 
-The batch rendering view menu also selects the view or views 
+The view menu next to the "rvu" button will be disabled if there
+is only one view to choose from.
+The view menu next to the "Start" button will be disabled if there
+is a batch job in progress, and thus the view cannot be changed.
+
+The batch rendering view menu also selects the view or views
 to use in producing a script during a dry run.
 
+.Action.Processes
+
+The "Number of processes" slider controls how many independent
+processes are initiated by the "rvu" and "Start" buttons above
+and below.
+This should be set no greater than the number of virtual cores
+on your system.
+
+For interactive rendering, the "new" command within rvu may
+be used to change the number of processes running.
+
+For rendering in the background, the number of processes will
+never be greater than the number of views if all views are
+being rendered.
+If only a single view is selected for rendering, rad
+will call rpiece to render it in tiles using the given
+number of processes.
+
 .Action.Start
 
-The "Start" button for batch rendering on the Action screen 
-initiates a rad rendering process in the background using the 
+The "Start" button for batch rendering on the Action screen
+initiates a rad rendering process in the background using the
 selected view or views shown on the menu button to the right.
 
 If any of the rad variables have been changed since the
@@ -1092,40 +1221,46 @@ your changes before starting a background process.
 If you discard these changes, then the batch rendering will be
 conducted using the previously saved values.
 
-Once a background process is going, the "Start" button is 
-disabled, and rendering progress can be monitored by checking 
+Once a background process is going, the "Start" button is
+disabled, and rendering progress can be monitored by checking
 the error file periodically.
-(This file is named by the root of the rad input file followed by 
+(This file is named by the root of the rad input file followed by
 ".err".)
-When a batch process is started or already running, this button 
-will be disabled.
+When a batch process is started or already running, or when a
+process is on another host and its status is unknown,
+this button will be disabled.
 
-The background process can be killed during this or later 
+The background process can be killed during this or later
 invocations of trad using the "Kill" button.
+If the process was started on another machine and the status is unknown,
+it will be necessary to run trad from the other host or remove the error
+file manually before starting a background process on this machine.
+This is to protect you from the great confusion that results when two
+machines are working from the same project file.
 
 .Action.Kill
 
-The batch rendering "Kill" button kills the 
+The batch rendering "Kill" button kills the
 background process started earlier with the "Start" button.
-The rad process id is taken from the first line of the error file, 
+The rad process id is taken from the first line of the error file,
 and this process and all its children are killed when the
 button is pressed.
 
-So long as there is an ambient file specified in the Options 
-screen, no data is lost by killing and restarting a batch 
+So long as there is an ambient file specified in the Options
+screen, no data is lost by killing and restarting a batch
 rendering, though some new startup costs will be incurred.
 
-The "Kill" button is disabled if no running batch process is 
-detected.
+The "Kill" button is disabled if no running batch process is
+detected on the current host machine.
 
 .Action.CheckErr
 
 Pressing the "Check errors" button
-displays the contents of the batch rendering error file, named 
-by the root of the current rad input file followed by the ".err" 
+displays the contents of the batch rendering error file, named
+by the root of the current rad input file followed by the ".err"
 suffix.
-This file will contain the command lines executed by rad so far, 
-and may or may not contain additional progress reports from 
+This file will contain the command lines executed by rad so far,
+and may or may not contain additional progress reports from
 rpict, depending on the initial setting of the "REPORT" variable.
 
 If no error file exists, this button will be disabled.
@@ -1133,11 +1268,11 @@ If no error file exists, this button will be disabled.
 .Action.Script
 
 The dry run "Script" button runs rad with the
-"-n" option so that you may see the commands that would be 
+"-n" option so that you may see the commands that would be
 executed during a batch run without actually executing them.
-If a file is named in the window next to this button, the output 
+If a file is named in the window next to this button, the output
 will simply be written to that file.
-If no file is named, a temporary file is created and an editor 
+If no file is named, a temporary file is created and an editor
 window is opened on it.
 
 Producing a dry run also writes the "Optfile" if one is specified
@@ -1145,43 +1280,43 @@ on the Options screen.
 This may be useful for computing rendering parameters for rtrace(1)
 or rpiece(1).
 
-The view or views are selected by the same menu used for 
+The view or views are selected by the same menu used for
 batch rendering.
-(See the "View" topic under the current help category for more 
+(See the "View" topic under the current help category for more
 information.)
 
 .Action.Edit
 
-The dry run "Edit" button is used to edit the named script file 
+The dry run "Edit" button is used to edit the named script file
 created by pressing the "Script" button.
 If no file is named, this button is ineffective.
 
 .Action.Delete
 
-The "Delete" button removes the named script file, created by the 
+The "Delete" button removes the named script file, created by the
 "Script" button.
-If no file is named, or the named file does not exist, this button has 
+If no file is named, or the named file does not exist, this button has
 no effect.
 
 .Results.Intro
 
 This button selects the trad Results screen.
-This screen permits rendered pictures to be displayed, 
+This screen permits rendered pictures to be displayed,
 converted to other image formats, and printed.
-Only finished pictures may be converted or printed, but 
-incomplete pictures (i.e. aborted renderings or renderings in 
+Only finished pictures may be converted or printed, but
+incomplete pictures (i.e. aborted renderings or renderings in
 progress) may be displayed interactively.
 
 The left-hand window shows a list of completed views, and the
-right-hand window shows views that have been started but not 
+right-hand window shows views that have been started but not
 finished.
-Note that other views may not even be started, thus may not 
+Note that other views may not even be started, thus may not
 appear in either list.
-Also, just because a view appears on the Results screen, it does 
-not mean that view is up-to-date with respect to the Radiance 
+Also, just because a view appears on the Results screen, it does
+not mean that view is up-to-date with respect to the Radiance
 input files.
-(The best way currently to tell which pictures are out-of-date 
-is to press the "Script" button on the Action screen and examine 
+(The best way currently to tell which pictures are out-of-date
+is to press the "Script" button on the Action screen and examine
 the output.)
 
 .Results.Finished
@@ -1214,14 +1349,16 @@ Shift-click also allows views to be added to the selec
 
 .Results.Rescan
 
-The "Rescan" button on the Results screen is used to update the 
-finished and unfinished view lists, in case one or more pictures 
+The "Rescan" button on the Results screen is used to update the
+finished and unfinished view lists, in case one or more pictures
 has completed since the Results screen was brought up.
 
 .Results.Delete
 
 The "Delete" button on the Results screen is used to remove the
 selected picture files from the filesystem.
+Associated raw picture and z-buffer files
+will also be deleted if they exist.
 Verification is required before any action is taken.
 
 .Results.Display
@@ -1309,10 +1446,13 @@ details.)
 The print command window on the Results screen contains the system
 command to use in printing out finished Radiance pictures.
 The "%s" format field, which must appear somewhere in the command,
-is replaced by the selected Radiance picture file name(s).
+is replaced by the selected Radiance picture file name.
+This command is executed multiple times if multiple files are
+selected.
 
 The default command is "ra_ps %s | lpr", which converts the Radiance
 picture to a black and white PostScript file and sends it to the lpr
 print spooler.
+Add a "-c" option to "ra_ps" if the printer supports color.
 If your printer does not understand PostScript, or your system does
 not support lpr, this command must obviously be changed.
