ENH: Additional documentation.

include/CylSrc.hh

@@ -16,6 +16,7 @@ Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen 1993, 1994
 // .NAME vlCylinderSource - generate a cylinder centered at origin
 // .SECTION Description
 // vlCylinderSource creates a polygonal cylinder centered at the origin.
+// The axis of the cylinder is aligned along the global y-axis.
 // The height and radius of the cylinder can be specified, as well as the
 // number of sides. It is also possible to control whether the cylinder is
 // open-ended or capped.

include/PlaneSrc.hh

@@ -15,9 +15,11 @@ Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen 1993, 1994
 =========================================================================*/
 // .NAME - create an array of quadrilaterals located in the plane
 // .SECTION Description
-// vlPlaneSource creates an m x n array of quadrilaterals oriented in a 
-// plane. The plane is centered at the origin. It is possible to control
-// the resolution of the plane in both directions (i.e., set m,n).
+// vlPlaneSource creates an m x n array of quadrilaterals arranged as a
+// regular tiling in the plane. The plane is centered at the origin, and 
+// orthogonal to the global z-axis.  The resolution of the plane can be
+// specified in both the x and y directions (i.e., specify m and n, 
+// respectively).
 
 #ifndef __vlPlaneSource_h
 #define __vlPlaneSource_h