From: Luca Heltai <luca.heltai@sissa.it>
Date: Fri, 10 May 2019 08:56:19 +0000 (+0200)
Subject: Documentation fixes.
X-Git-Tag: v9.1.0-rc1~70^2~2
X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=a8bf64c1f086772607d3cff3cb35ecdc1430d4c4;p=dealii.git

Documentation fixes.
---

diff --git a/include/deal.II/fe/mapping.h b/include/deal.II/fe/mapping.h
index fb323e941f..acf799a63f 100644
--- a/include/deal.II/fe/mapping.h
+++ b/include/deal.II/fe/mapping.h
@@ -375,7 +375,10 @@ public:
    * MappingQEulerian, MappingQ1Eulerian, or MappingFEField.
    *
    * This function returns the bounding box containing all the vertices of the
-   * cell, as returned by the get_vertices() method.
+   * cell, as returned by the get_vertices() method. Beware of the fact that
+   * for higher order mappings this bounding box is only an approximation of the
+   * true bounding box, since it does not take into account curved faces, and it
+   * may be smaller than the true bounding box.
    *
    * @param[in] cell The cell for which you want to compute the center
    *
diff --git a/include/deal.II/grid/tria_accessor.h b/include/deal.II/grid/tria_accessor.h
index 47bd239917..b74b059dc0 100644
--- a/include/deal.II/grid/tria_accessor.h
+++ b/include/deal.II/grid/tria_accessor.h
@@ -1430,6 +1430,11 @@ public:
 
   /**
    * Return the smallest bounding box that encloses the object.
+   *
+   * Notice that this method is not aware of any mapping you may be using to
+   * do your computations. If you are using a mapping object that modifies the
+   * position of the vertices, like MappingQEulerian, or MappingFEField, then
+   * you should call the function Mapping::get_bounding_box() instead.
    */
   BoundingBox<spacedim>
   bounding_box() const;