Add file documentation

dune/common/metis.hh

@@ -5,6 +5,13 @@
 #ifndef DUNE_METIS_HH
 #define DUNE_METIS_HH
 
+/**
+ * \file This include file is intended to be used instead of the direct include of `metis.h`. It
+ * provides the right order of necessary pre-includes, e.g. when scotch-metis is found, and introduces
+ * version-/distribution-independent type definitions for floating-point arguments (`real_t`) and
+ * integer arguments (`idx_t`) in the namespace `Dune::Metis`.
+ **/
+
 #if HAVE_METIS
 
 #if HAVE_SCOTCH_METIS

dune/common/parallel/parmetis.hh

@@ -5,6 +5,13 @@
 #ifndef DUNE_PARMETIS_HH
 #define DUNE_PARMETIS_HH
 
+/**
+ * \file This include file is intended to be used instead of the direct include of `parmetis.h`. It
+ * provides the right order of necessary pre-includes, e.g. when ptscotch-parmetis is found, and introduces
+ * version-/distribution-independent type definitions for floating-point arguments (`real_t`) and
+ * integer arguments (`idx_t`) in the namespace `Dune::ParMetis`.
+ **/
+
 #if HAVE_PARMETIS
 
 #if HAVE_MPI