--- ray/doc/man/man1/rcontrib.1	2014/07/19 18:19:33	1.10
+++ ray/doc/man/man1/rcontrib.1	2016/09/12 20:31:34	1.13
@@ -1,4 +1,4 @@
-.\" RCSid "$Id: rcontrib.1,v 1.10 2014/07/19 18:19:33 greg Exp $"
+.\" RCSid "$Id: rcontrib.1,v 1.13 2016/09/12 20:31:34 greg Exp $"
 .TH RCONTRIB 1 5/25/05 RADIANCE
 .SH NAME
 rcontrib - compute contribution coefficients in a RADIANCE scene
@@ -158,7 +158,10 @@ The
 option may be used to further define
 a "bin number" within each object if finer resolution is needed, and
 this will be applied to a "%d" format in the output file
-specification if present.
+specification if present. 
+(The final integer will be offset incrementally
+if the output is a RADIANCE picture and more than one modifier has
+the same format specification.)\0
 The actual bin number is computed at run time based on ray direction
 and surface intersection, as described below.
 The number of bins must be specified in advance with the
@@ -278,6 +281,24 @@ A command argument beginning with a dollar sign ('$') 
 replaced by the contents of the given environment variable.
 A command argument beginning with an at sign ('@') is immediately
 replaced by the contents of the given file.
+.PP
+.I Rcontrib
+has EXPERIMENTAL support for light source contributions from photon maps
+generated by
+.I mkpmap(1)
+with its
+.I -apC
+option. In photon mapping mode,
+.I rcontrib
+only supports contributions from light sources, not arbitrary modifiers.
+The
+.I -b
+option is supported along with its associated ray variables, as
+discussed above. Ray coefficients are also supported via the
+.I \-V-
+option. Using fewer photons than there are light sources for the photon
+density estimates results in omitted contributions, thus the bandwidth
+is clamped accordingly and a warning issued.
 .SH EXAMPLES
 To compute the proportional contributions from sources modified
 by "light1" vs. "light2" on a set of illuminance values:
@@ -300,10 +321,18 @@ To compute an array of illuminance contributions accor
 .IP "" .2i
 rcontrib \-I+ \-f tregenza.cal \-b tbin \-bn Ntbins \-o sky.dat \-m skyglow
 \-b 0 \-o ground.dat \-m groundglow @render.opt scene.oct < test.dat
+.PP
+To perform an annual simulation of 365 daily sun positions in photon mapping
+mode:
+.IP "" .2i
+rcontrib \-I+ \-h \-V \-fo \-o c_%s.dat \-M lights \-ap contrib.pm 365
+scene.oct < test.dat,
 .SH ENVIRONMENT
 RAYPATH		path to search for \-f and \-M files
 .SH AUTHOR
 Greg Ward
 .SH "SEE ALSO"
-cnt(1), genklemsamp(1), getinfo(1), pcomb(1), pfilt(1), ra_rgbe(1),
-rcalc(1), rpict(1), rsensor(1), rtrace(1), total(1), vwrays(1), ximage(1)
+cnt(1), genklemsamp(1), getinfo(1), mkpmap(1), pcomb(1), pfilt(1), 
+ra_rgbe(1), rcalc(1), rfluxmtx(1), rmtxop(1), rpict(1), rsensor(1), 
+rtrace(1), total(1), vwrays(1), ximage(1)
+