--- ray/doc/man/man1/robjutil.1	2020/04/03 02:32:58	1.4
+++ ray/doc/man/man1/robjutil.1	2021/04/15 23:51:04	1.7
@@ -1,4 +1,4 @@
-.\" RCSid "$Id: robjutil.1,v 1.4 2020/04/03 02:32:58 greg Exp $"
+.\" RCSid "$Id: robjutil.1,v 1.7 2021/04/15 23:51:04 greg Exp $"
 .TH ROBJUTIL 1 3/31/20 RADIANCE
 .SH NAME
 robjutil - operate on Wavefront .OBJ file
@@ -19,6 +19,8 @@ robjutil - operate on Wavefront .OBJ file
 ][
 .B "-c epsilon"
 ][
+.B +T
+][
 .B "-x 'xf spec'"
 ]
 [
@@ -35,13 +37,10 @@ will be produced on the standard output.
 If
 .I -r
 is given, a modified .OBJ file will be sent to the standard output.
-This is the default, and is
-typically more useful, since surface normals are better handled by the
-.I obj2rad(1)
-and
-.I obj2mesh(1)
-converters.
-The latter also preserves local texture coordinates for mapping materials.
+This is the default, and is more useful for preserving
+texture coordinates if directed to
+.I obj2mesh(1).
+.PP
 The
 .I +v
 option turns on verbose progress reports.
@@ -75,6 +74,7 @@ The
 and
 .I \+m
 options are mutually exclusive.
+.PP
 Similarly, the
 .I "\-g gname"
 option says to remove all faces belonging to the group
@@ -85,6 +85,11 @@ options may be given.
 There is also a
 .I +g
 option to save just the named group(s).
+Object statements are treated the same as group statements in the input, so
+.I +/-g
+option can also be applied to object names.
+Note that an object name will be overridden by a group name that follows
+it in the input, and vice versa.
 .PP
 The
 .I "\-c epsilon"
@@ -104,6 +109,10 @@ which is usually not a problem for .OBJ output, but ma
 scene descriptions (+r).
 .PP
 The
+.I +T
+option turns all faces with 4 or more sides into triangles.
+.PP
+The
 .I \-x
 option may be used to specify a final transform to apply to all
 coordinates in the file before output.
@@ -123,10 +132,6 @@ To remove degenerate and duplicate faces from "orig.ob
 .IP "" .2i
 robjutil +r orig.obj > final.rad
 .PP
-To convert the same file, preserving surface normal interpolation:
-.IP "" .2i
-robjutil orig.obj | obj2rad > withnormals.rad
-.PP
 To extract only the groups "cat" and "bell" from the file "kitty.obj" and
 write to a Radiance triangle mesh using materials from "kitty.mat":
 .IP "" .2i
@@ -168,4 +173,4 @@ still possible to assign materials by group manually.
 .SH AUTHOR
 Greg Ward
 .SH "SEE ALSO"
-cat(1), obj2mesh(1), obj2rad(1) oconv(1), xform(1)
+cat(1), genbox(1), gensurf(1), obj2mesh(1), obj2rad(1) oconv(1), xform(1)