Merge topic 'vtkPointSet_documentation'

0526f004

 Improving documentation to avoid using non-preferred method
Acked-by: Kitware Robot <kwrobot@kitware.com>
Reviewed-by: Cory Quammen <cory.quammen@kitware.com>
Merge-request: !1620

Common/DataModel/vtkPointSet.h

@@ -50,7 +50,6 @@ public:
   // Description:
   // See vtkDataSet for additional information.
   vtkIdType GetNumberOfPoints();
-  double *GetPoint(vtkIdType ptId) {return this->Points->GetPoint(ptId);};
   void GetPoint(vtkIdType ptId, double x[3]) {this->Points->GetPoint(ptId,x);};
   virtual vtkIdType FindPoint(double x[3]);
   vtkIdType FindPoint(double x, double y, double z) {
@@ -63,6 +62,13 @@ public:
                              double tol2, int& subId, double pcoords[3],
                              double *weights);
 
+  // Description:
+  // See vtkDataSet for additional information.
+  // WARNING: Just don't use this error-prone method, the returned pointer
+  // and its values are only valid as long as another method invocation is not
+  // performed. Prefer GetPoint() with the return value in argument.
+  double *GetPoint(vtkIdType ptId) {return this->Points->GetPoint(ptId);};
+
   // Description:
   // Return an iterator that traverses the cells in this data set.
   vtkCellIterator* NewCellIterator();