--- ray/doc/man/man1/mkillum.1	2003/03/11 19:20:21	1.1
+++ ray/doc/man/man1/mkillum.1	2005/02/22 16:10:43	1.5
@@ -1,10 +1,12 @@
-.\" RCSid "$Id"
+.\" RCSid "$Id: mkillum.1,v 1.5 2005/02/22 16:10:43 greg Exp $"
 .TH MKILLUM 1 10/6/95 RADIANCE
 .SH NAME
 mkillum - compute illum sources for a RADIANCE scene
 .SH SYNOPSIS
 .B mkillum
 [
+.B "\-n nprocs"
+][
 .B "rtrace options"
 ]
 .B octree
@@ -18,7 +20,7 @@ light source distributions for each surface, replacing
 secondary sources whose contributions can be computed more efficiently by
 .I rpict(1)
 and
-.I rview(1).
+.I rvu(1).
 This type of optimization is most useful for windows and skylights which
 represent concentrated sources of indirect illumination.
 .I Mkillum
@@ -27,7 +29,16 @@ directional distributions.
 These are best handled respectively by the ambient calculation
 and the secondary source types in RADIANCE.
 .PP
-The arguments to
+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
+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
 .I rtrace(1),
@@ -182,10 +193,18 @@ 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 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), rview(1)
+oconv(1), rad(1), rpict(1), rtrace(1), rvu(1)