--- ray/doc/man/man1/pkgBSDF.1	2011/06/23 18:11:17	1.1
+++ ray/doc/man/man1/pkgBSDF.1	2015/08/18 15:23:38	1.4
@@ -1,4 +1,4 @@
-.\" RCSid $Id: pkgBSDF.1,v 1.1 2011/06/23 18:11:17 greg Exp $
+.\" RCSid $Id: pkgBSDF.1,v 1.4 2015/08/18 15:23:38 greg Exp $
 .TH PKGBSDF 1 6/23/2011 RADIANCE
 .SH NAME
 pkgBSDF - package BSDFs provided as XML for Radiance
@@ -15,11 +15,19 @@ pkgBSDF - package BSDFs provided as XML for Radiance
 takes one or more XML files, each describing the bidirectional scattering
 distribution function of a surface or geometric system, and packages
 them into RADIANCE scene descriptions.
+If the input file(s) do not begin with a '.' or '/', the directories
+in the RAYPATH environment variable will be searched.
 One rectangle is produced for each BSDF that has
 no detail geometry and/or no rear-side reflectance distribution.
 If both front and back reflectance distributions are present with
 detail geometry, then two rectangles will be used to sandwich
 the geometry extracted from the BSDF file.
+The front surface will always be centered just in front of the
+origin facing the positive Z-direction, with "up" in the positive
+Y-direction.
+The back surface, if present, will parallel the front surface at
+a distance slightly greater than the BSDF system thickness.
+Scene units will always be in meters.
 .PP
 The
 .I \-i
@@ -32,7 +40,7 @@ references to the same complex BSDF object.
 Normally,
 .I pkgBSDF
 produces one RADIANCE scene file for each XML input, replacing
-the required '.xml' suffix with '.rad' in the same directory.
+the required '.xml' suffix with '.rad' and writing to the current directory.
 The
 .I \-s
 option sends the RADIANCE scene description to the standard