]> https://gitweb.dealii.org/ - dealii.git/commitdiff
Augment the description of CellId::to_string(). 8934/head
authorWolfgang Bangerth <bangerth@colostate.edu>
Mon, 21 Oct 2019 00:15:42 +0000 (18:15 -0600)
committerWolfgang Bangerth <bangerth@colostate.edu>
Mon, 21 Oct 2019 00:15:42 +0000 (18:15 -0600)
include/deal.II/grid/cell_id.h

index 3787b97801f90b374176e427fbe8eead6e226a5f..721e51b416a75dd78d25b2bd16d8975fb052b31f 100644 (file)
@@ -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;

In the beginning the Universe was created. This has made a lot of people very angry and has been widely regarded as a bad move.

Douglas Adams


Typeset in Trocchi and Trocchi Bold Sans Serif.