--- ray/doc/man/man1/oconv.1	2003/03/11 19:20:21	1.1
+++ ray/doc/man/man1/oconv.1	2007/09/04 17:36:40	1.8
@@ -1,4 +1,4 @@
-.\" RCSid "$Id"
+.\" RCSid "$Id: oconv.1,v 1.8 2007/09/04 17:36:40 greg Exp $"
 .TH OCONV 1 8/15/95 RADIANCE
 .SH NAME
 oconv - create an octree from a RADIANCE scene description
@@ -64,7 +64,7 @@ each voxel.
 Larger numbers result in quicker octree generation,
 but potentially slower rendering.
 Smaller values may or may not produce faster renderings,
-since the default number (5) is close to optimal for most scenes.
+since the default number (6) is close to optimal for most scenes.
 .PP
 The
 .I \-r
@@ -72,7 +72,7 @@ option specifies the maximum octree resolution.
 This should be greater than or equal to the ratio of the largest
 and smallest dimensions in the scene (ie. surface size or distance between 
 surfaces).
-The default is 8192.
+The default is 16384.
 .PP
 The
 .I \-f
@@ -109,7 +109,7 @@ Although the octree file format is binary, it is meant
 between machines.
 The only limitation is that machines with radically different integer
 sizes will not work together.
-For the best results, the -f option should be used if an octree is
+For the best results, the \-f option should be used if an octree is
 to be used in different environments.
 .SH DIAGNOSTICS
 There are four basic error types reported by oconv:
@@ -132,15 +132,15 @@ to xform(1) within files to create a hierarchy.
 .IP "Set overflow in addobject (id)"
 This error occurs when too many surfaces are close together in a
 scene.
-Sometimes a dense scene can be accomodated by increasing
-the maximum resolution (by powers of two) using the
-.I \-r
-option, but usually this error indicates something is wrong.
 Either too many surfaces are lying right on top of each other,
 or the bounding cube is inflated from an oversized object
 or an improper
 .I \-b
 specification.
+If hundreds of triangles come together at a common vertex, it may
+not be possible to create an octree from the object.
+This happens most often when inane CAD systems create spheres using
+a polar tessellation.
 Chances are, the surface "id" is near one of those causing the problem.
 .IP "Hash table overflow in fullnode"
 This error is caused by too many surfaces.
@@ -152,7 +152,7 @@ option.
 To add book1, book2 and a
 transformed book3 to the octree ``scene.oct'':
 .IP "" .2i
-oconv -i scene.oct book1 book2 '\\!xform -rz 30 book3' > newscene.oct
+oconv \-i scene.oct book1 book2 '\\!xform \-rz 30 book3' > newscene.oct
 .SH AUTHOR
 Greg Ward
 .SH NOTES
@@ -168,5 +168,5 @@ or
 .I rad(1)
 can be used to automate octree creation and maintenance.
 .SH "SEE ALSO"
-getbbox(1), getinfo(1), make(1), rad(1),
-rpict(1), rview(1), rtrace(1), xform(1)
+getbbox(1), getinfo(1), make(1), obj2mesh(1), rad(1),
+rpict(1), rvu(1), rtrace(1), xform(1)