--- ray/doc/man/man1/gensurf.1	2003/03/11 22:48:20	1.2
+++ ray/doc/man/man1/gensurf.1	2025/01/21 01:56:27	1.9
@@ -1,4 +1,4 @@
-.\" RCSid "$Id"
+.\" RCSid "$Id: gensurf.1,v 1.9 2025/01/21 01:56:27 greg Exp $"
 .TH GENSURF 1 11/15/93 RADIANCE
 .SH NAME
 gensurf - generate a RADIANCE or Wavefront description of a curved surface
@@ -11,6 +11,8 @@ gensurf - generate a RADIANCE or Wavefront description
 ][
 .B \-s
 ][
+.B \-i
+][
 .B \-o
 ]
 .br
@@ -22,6 +24,8 @@ gensurf - generate a RADIANCE or Wavefront description
 ][
 .B \-s
 ][
+.B \-i
+][
 .B \-o
 ]
 .br
@@ -29,6 +33,8 @@ gensurf - generate a RADIANCE or Wavefront description
 [
 .B \-s
 ][
+.B \-i
+][
 .B \-o
 ]
 .SH DESCRIPTION
@@ -60,16 +66,25 @@ in any number of
 and
 .I \-f
 options.
+The variable and function definitions in each
+.I \-f source
+file are read and compiled from the RADIANCE library where it is found.
 The
 .I \-s
 option adds smoothing (surface normal interpolation) to the surface.
 The
+.I \-i
+option reverses surface normal directions from the standard
+clockwise-from-front orientation.
+The
 .I \-o
 option produces a Wavefront .OBJ file rather than a RADIANCE
 scene description.
 This is most useful as input to the
 .I obj2mesh(1)
 program for producing a compiled mesh.
+A single "usemtl" statement will appear at the beginning
+of the .OBJ output, echoing the modifier given on the command line.
 .PP
 Rough holes may be cut in the mesh by defining a valid(s,t) function.
 Where this function is positive, polygon vertices will be produced.
@@ -106,12 +121,14 @@ gensurf crystal ball 'sin(PI*s)*cos(2*PI*t)' 'cos(PI*s
 To generate a 10x20 smoothed height field from 12 recorded vertex
 z values:
 .IP "" .2i
-gensurf dirt ground '10*s' '20*t' height.dat 2 3 -s
+gensurf dirt ground '10*s' '20*t' height.dat 2 3 \-s
+.SH ENVIRONMENT
+RAYPATH		the directories to check for auxiliary files.
 .SH AUTHOR
 Greg Ward
 .SH BUGS
 The smoothing operation requires that functions be defined
 beyond the [0,1] boundaries of s and t.
 .SH "SEE ALSO"
-calc(1), genbox(1), genrev(1), genworm(1),
-obj2mesh(1), rpict(1), rview(1), xform(1)
+genbox(1), genrev(1), genworm(1), icalc(1),
+obj2mesh(1), obj2rad(1), robjutil(1), rpict(1), rvu(1), xform(1)