From: Wolfgang Bangerth <bangerth@colostate.edu>
Date: Mon, 21 Oct 2019 00:15:42 +0000 (-0600)
Subject: Augment the description of CellId::to_string().
X-Git-Tag: v9.2.0-rc1~962^2
X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F8934%2Fhead;p=dealii.git

Augment the description of CellId::to_string().
---

diff --git a/include/deal.II/grid/cell_id.h b/include/deal.II/grid/cell_id.h
index 3787b97801..721e51b416 100644
--- a/include/deal.II/grid/cell_id.h
+++ b/include/deal.II/grid/cell_id.h
@@ -117,7 +117,16 @@ public:
   CellId();
 
   /**
-   * Return a human readable string representation of this CellId.
+   * Return a human-readable string representation of this CellId.
+   *
+   * The string returned by this function consists of only ASCII characters
+   * and will look, for example, like this: `"0_3:006"`. It *can* be
+   * interpreted by humans as saying "This cell originates from the zeroth
+   * coarse mesh cell, lives on refinement level 3, and the path from the
+   * coarse mesh cell to its children and grand children is given by 006".
+   * But it is not *meant* to be interpreted in any meaningful way: It's just
+   * a way of representing the internal state of the current object using
+   * only ASCII characters in the printable range.
    */
   std::string
   to_string() const;