message: Added some warnings regarding Mesh pointer modification.
diff: @@ -522,9 +522,11 @@ std::ostream& operator<<(std::ostream& os, const DynamicGrayBlockData& bData)
  * \brief Handles generation of a point containment spatial index over a surface
  * mesh
  *
  - * The point containment queries determines whether a given arbitrary point in
  - * space
  - * lies inside or outside of the surface
  + * The point containment queries determine whether a given arbitrary point in
  + * space lies inside or outside of the surface. This class depends on a
  + * watertight surface mesh. In order to repair common mesh defects, this
  + * class modifies the Mesh passed to it. Please discard all other copies
  + * of the Mesh pointer.
  */
  template<int DIM>
  class InOutOctree : public SpatialOctree<DIM, InOutBlockData>
  @@ -993,8 +995,9 @@ public:
  *
  * \param [in] bb The spatial extent covered by the octree
  * \note We slightly scale the bounding box so all mesh elements are
  - * guaranteed
  - * to be enclosed by the octree
  + * guaranteed to be enclosed by the octree.
  + * \note The InOutOctree modifies its mesh in an effort to repair common
  + * problems. Please make sure to discard all old copies of the meshPtr.
  */
  InOutOctree(const GeometricBoundingBox& bb, SurfaceMesh*& meshPtr)
  : SpatialOctreeType( GeometricBoundingBox(bb).scale(1.0001) ),
  