--- ray/doc/man/man1/gendaymtx.1	2014/06/17 18:03:48	1.7
+++ ray/doc/man/man1/gendaymtx.1	2020/01/07 01:42:30	1.11
@@ -1,4 +1,4 @@
-.\" RCSid $Id: gendaymtx.1,v 1.7 2014/06/17 18:03:48 greg Exp $
+.\" RCSid $Id: gendaymtx.1,v 1.11 2020/01/07 01:42:30 greg Exp $
 .TH GENDAYMTX 1 01/19/13 RADIANCE
 .SH NAME
 gendaymtx - generate an annual Perez sky matrix from a weather tape
@@ -9,8 +9,12 @@ gendaymtx - generate an annual Perez sky matrix from a
 ][
 .B "\-h"
 ][
-.B "\-d|\-s"
+.B "\-A"
 ][
+.B "\-d|\-s|\-n"
+][
+.B "\-D sunfile"
+][
 .B "\-r deg"
 ][
 .B "\-m N"
@@ -42,7 +46,7 @@ parameter setting.
 .PP
 Increasing the
 .I \-m
-parameter, typically by factors of two, yields a higher resolution
+parameter yields a higher resolution
 sky using the Reinhart patch subdivision.
 For example, setting
 .I "\-m 4"
@@ -53,6 +57,14 @@ Thus, an hourly weather tape for an entire year would
 yield 8760x3 (26280) values per output line (row).
 .PP
 The
+.I \-A
+option tells
+.I gendaymtx
+to generate a single column corresponding to an average sky
+computed over all the input time steps, rather than one
+column per time step.
+.PP
+The
 .I \-c
 option may be used to specify a color for the sky.
 The gray value should equal 1 for proper energy balance.
@@ -67,10 +79,29 @@ corresponding to a 20% gray.
 .PP
 The
 .I \-d
-option may be used to produce a sun-only matrix, with no sky contributions.
+option may be used to produce a sun-only matrix, with no sky contributions,
+and the ground patch also set to zero.
 Alternatively, the
 .I \-s
-option may be used to exclude any direct solar component from the output.
+option may be used to exclude any direct solar component from the output,
+with the rest of the sky and ground patch unaffected.
+If there is a sun in the description,
+.I gendaymtx
+will include its contribution in the four nearest sky patches,
+distributing energy according to centroid proximity.
+.PP
+The
+.I \-n
+option may be used if no matrix output is desired.
+This may be used to merely check the input, or in combination with the
+.I \-D
+option, below.
+.PP
+The
+.I \-D
+option may be used to specify an output file to contain a list of
+solar positions and intensities corresponding to time steps in the
+weather tape where the sun is visible above the horizion.
 .PP
 By default,
 .I gendaymtx