]> https://gitweb.dealii.org/ - dealii.git/commitdiff
Provide some more documentation. 11709/head
authorWolfgang Bangerth <bangerth@colostate.edu>
Sun, 7 Feb 2021 19:02:22 +0000 (12:02 -0700)
committerWolfgang Bangerth <bangerth@colostate.edu>
Sun, 7 Feb 2021 19:02:22 +0000 (12:02 -0700)
include/deal.II/grid/reference_cell.h

index 796ddba00f81279e350499a8311b4c47557a7251..e6341c7b92e40f2904174736ec0a57a02854aa75 100644 (file)
@@ -67,6 +67,15 @@ namespace internal
  * This includes quadrilaterals and hexahedra (i.e., "hypercubes"),
  * triangles and tetrahedra (simplices), and the pyramids and wedges
  * necessary when using mixed 3d meshes.
+ *
+ * Objects of this type should not be created in user code, and as a
+ * consequence the class does not have a user-accessible constructor
+ * other than the default constructor (which creates an invalid object).
+ * Rather, there is a finite number of specific reference cell objects
+ * defined in the ReferenceCells namespace that completely enumerate
+ * all of the possible values. User codes should therefore rely
+ * exclusively on assigning ReferenceCell objects from these special
+ * objects, and comparing against those special objects.
  */
 class ReferenceCell
 {
@@ -344,6 +353,13 @@ namespace internal
 
 
 
+/**
+ * A namespace in which we define objects that correspond to specific
+ * reference cells. The objects defined here are a complete enumeration
+ * of all possible reference cells that can be used in deal.II.
+ *
+ * @relates ReferenceCell
+ */
 namespace ReferenceCells
 {
   DEAL_II_CONSTEXPR const ReferenceCell Vertex =

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.