--- ray/doc/ray.1	2018/06/26 14:42:18	1.35
+++ ray/doc/ray.1	2023/11/03 17:41:27	1.40
@@ -1,8 +1,8 @@
-.\" RCSid "$Id: ray.1,v 1.35 2018/06/26 14:42:18 greg Exp $"
+.\" RCSid "$Id: ray.1,v 1.40 2023/11/03 17:41:27 greg Exp $"
 .\" Print using the -ms macro package
-.DA 07/10/2016
+.DA 5/11/2023
 .LP
-.tl """Copyright \(co 2017 Regents, University of California
+.tl """Copyright \(co 2023 Regents, University of California
 .sp 2
 .TL
 The
@@ -630,6 +630,8 @@ arguments have additional flexibility to specify the s
 Also, rather than roughness, specular power is used, which has no
 physical meaning other than larger numbers are equivalent to a smoother
 surface.
+Unlike other material types, total reflectance is the sum of
+diffuse and specular colors, and should be adjusted accordingly.
 .DS
 mod ashik2 id
 4+ ux uy uz funcfile transform
@@ -1593,6 +1595,20 @@ the Ecole Polytechnique Federale de Lausanne (EPFL Uni
 in Lausanne, Switzerland.
 .NH 1
 References
+.LP
+Ward, Gregory J., Bruno Bueno, David Geisler-Moroder, 
+Lars O. Grobe, Jacob C. Jonsson, Eleanor
+S. Lee, Taoning Wang, Helen Rose Wilson,
+``Daylight Simulation Workflows Incorporating
+Measured Bidirectional Scattering Distribution Functions,''
+.I "Energy & Buildings",
+Vol. 259, No. 111890, 2022.
+.LP
+Wang, Taoning, Gregory Ward, Eleanor Lee,
+``Efficient modeling of optically-complex, non-coplanar
+exterior shading: Validation of matrix algebraic methods,''
+.I "Energy & Buildings",
+vol. 174, pp. 464-83, Sept. 2018.
 .LP
 Lee, Eleanor S., David Geisler-Moroder, Gregory Ward,
 ``Modeling the direct sun component in buildings using matrix