--- ray/doc/man/man1/mkillum.1	2004/09/17 21:43:49	1.4
+++ ray/doc/man/man1/mkillum.1	2013/08/11 02:57:49	1.12
@@ -1,4 +1,4 @@
-.\" RCSid "$Id: mkillum.1,v 1.4 2004/09/17 21:43:49 greg Exp $"
+.\" RCSid "$Id: mkillum.1,v 1.12 2013/08/11 02:57:49 greg Exp $"
 .TH MKILLUM 1 10/6/95 RADIANCE
 .SH NAME
 mkillum - compute illum sources for a RADIANCE scene
@@ -32,17 +32,16 @@ and the secondary source types in RADIANCE.
 If the
 .I \-n
 option is specified with a value greater than 1, multiple
-.I rtrace(1)
-processes will be used to accelerate computation on a shared
+ray tracing processes will be used to accelerate computation on a shared
 memory machine.
 Note that there is no benefit to using more processes
 than there are local CPUs available to do the work.
 .PP
 Remaining arguments to
 .I mkillum
-are passed directly to
+are interpreted as rendering options for
 .I rtrace(1),
-which is used to compute the light distributions for the input surfaces.
+to compute the light distributions for the input surfaces.
 These surfaces can be any combination of polygons, spheres and rings.
 Other surfaces may be included, but
 .I mkillum
@@ -57,8 +56,7 @@ the file names.
 (Note that this character must be escaped from most shells.)
 This is necessary so
 .I mkillum
-can tell where the arguments to
-.I rtrace(1)
+can tell where the rendering arguments
 end and its own input files begin.
 .SH VARIABLES
 .I Mkillum
@@ -139,7 +137,8 @@ Only produce secondary sources for surfaces modified b
 .TP
 .BR n
 Do not produce any secondary sources.
-All input will be passed to the output unaffected.
+All input will be passed to the output unaffected, except any
+void surfaces will be removed.
 .TP
 .BI b =real
 Do not produce a secondary source for a surface if its average
@@ -193,10 +192,20 @@ will use the material type "illum" with the input surf
 as its alternate material.
 The default is
 .I l-.
+.SH EXAMPLES
+The following command generates illum's corresponding to geometry
+in the files "it1.rad" and "it2.rad":
+.IP "" .3i
+mkillum \-ab 2 \-ad 1024 \-av .1 .1 .1 basic.oct "<" it1.rad it2.rad > illums.rad
+.PP
+The output file "illums.rad" would then be combined with the original
+scene geometry to create a more easily rendered composite.
+.SH ENVIRONMENT
+RAYPATH		the directories to check for auxiliary files.
 .SH AUTHOR
 Greg Ward
 .SH ACKNOWLEDGEMENT
 Work on this program was initiated and sponsored by the LESO
 group at EPFL in Switzerland.
 .SH "SEE ALSO"
-oconv(1), rad(1), rpict(1), rtrace(1), rvu(1)
+genBSDF(1), oconv(1), rad(1), rpict(1), rtrace(1), rvu(1)