]> https://gitweb.dealii.org/ - dealii.git/commitdiff
quadrature: improve documentation 7160/head
authorTimo Heister <timo.heister@gmail.com>
Fri, 7 Sep 2018 15:45:06 +0000 (11:45 -0400)
committerTimo Heister <timo.heister@gmail.com>
Fri, 7 Sep 2018 15:45:06 +0000 (11:45 -0400)
include/deal.II/base/quadrature.h

index 25a919674f89fde61c75d49860e20f51d62b3a10..dd7618dd8521416470258beb67fbf932ec269345 100644 (file)
@@ -251,12 +251,29 @@ public:
 
   /**
    * In case the quadrature formula is a tensor product, this function
-   * returns the one-dimensional basis objects.
+   * returns the @p dim one-dimensional basis objects.
    * Otherwise, calling this function is not allowed.
+   *
+   * For @p dim equal to one, we can not return the std::array as a const
+   * reference and have to return it by value. In this case, the array
+   * will always contain a single element (@p this).
+   *
+   * @note The actual return type of this function is
+   * @code
+   * std::conditional<dim == 1,
+   *                  std::array<Quadrature<1>, dim>,
+   *                  const std::array<Quadrature<1>, dim> &>::type
+   * @endcode
+   * The type is abbreviated in the online documentation to improve
+   * readability of this page.
    */
+#ifndef DOXYGEN
   typename std::conditional<dim == 1,
                             std::array<Quadrature<1>, dim>,
                             const std::array<Quadrature<1>, dim> &>::type
+#else
+  const std::array<Quadrature<1>, dim> &
+#endif
   get_tensor_basis() const;
 
 protected:

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.