From bee83f90f27a32885d3708363e5c110457f2b5f5 Mon Sep 17 00:00:00 2001
From: bangerth <bangerth@0785d39b-7218-0410-832d-ea1e28bc413d>
Date: Tue, 16 Apr 2013 04:24:22 +0000
Subject: [PATCH] Add to the documentation.

git-svn-id: https://svn.dealii.org/trunk@29296 0785d39b-7218-0410-832d-ea1e28bc413d
---
 deal.II/include/deal.II/grid/grid_tools.h | 24 +++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/deal.II/include/deal.II/grid/grid_tools.h b/deal.II/include/deal.II/grid/grid_tools.h
index c69eb23ce6..37a59770e9 100644
--- a/deal.II/include/deal.II/grid/grid_tools.h
+++ b/deal.II/include/deal.II/grid/grid_tools.h
@@ -359,6 +359,14 @@ namespace GridTools
    * as it simultaneously delivers the
    * local coordinate of the given point
    * without additional computational cost.
+   *
+   * @note When applied to a triangulation or DoF handler object based
+   * on a parallel::distributed::Triangulation object, the cell
+   * returned may in fact be a ghost or artificial cell (see
+   * @ref GlossArtificialCell and @ref GlossGhostCell). If so,
+   * many of the operations one may want to do on this cell
+   * (e.g., evaluating the solution) may not be possible and you
+   * will have to decide what to do in that case.
    */
   template <int dim, template <int,int> class Container, int spacedim>
   typename Container<dim,spacedim>::active_cell_iterator
@@ -418,6 +426,14 @@ namespace GridTools
    * using GeometryInfo::project_to_unit_cell.
    * This is not automatically performed
    * by the algorithm.
+   *
+   * @note When applied to a triangulation or DoF handler object based
+   * on a parallel::distributed::Triangulation object, the cell
+   * returned may in fact be a ghost or artificial cell (see
+   * @ref GlossArtificialCell and @ref GlossGhostCell). If so,
+   * many of the operations one may want to do on this cell
+   * (e.g., evaluating the solution) may not be possible and you
+   * will have to decide what to do in that case.
    */
   template <int dim, template<int, int> class Container, int spacedim>
   std::pair<typename Container<dim,spacedim>::active_cell_iterator, Point<dim> >
@@ -434,6 +450,14 @@ namespace GridTools
    * for hp problems, since the active
    * finite element index for all other DoF
    * handlers is always zero.
+   *
+   * @note When applied to a triangulation or DoF handler object based
+   * on a parallel::distributed::Triangulation object, the cell
+   * returned may in fact be a ghost or artificial cell (see
+   * @ref GlossArtificialCell and @ref GlossGhostCell). If so,
+   * many of the operations one may want to do on this cell
+   * (e.g., evaluating the solution) may not be possible and you
+   * will have to decide what to do in that case.
    */
   template <int dim, int spacedim>
   std::pair<typename hp::DoFHandler<dim,spacedim>::active_cell_iterator, Point<dim> >
-- 
2.39.5