]> https://gitweb.dealii.org/ - dealii.git/commitdiff
doc: correct friend markup in tensor 8408/head
authorTimo Heister <timo.heister@gmail.com>
Tue, 23 Jul 2019 16:09:19 +0000 (12:09 -0400)
committerTimo Heister <timo.heister@gmail.com>
Tue, 23 Jul 2019 17:45:38 +0000 (13:45 -0400)
Documentation is messed up by using doxygen markup for the comments for
friend declarations as they replace the correct documentation
(SymmetricTensor::trace for example). Fix this.

include/deal.II/base/symmetric_tensor.h
include/deal.II/base/tensor.h

index e8bd996113980047cd9da040ea09d0687f7ef856..2c4252560d2db68c0b2091313743407516538622 100644 (file)
@@ -383,10 +383,8 @@ namespace internal
       tensor_type &            tensor;
       const TableIndices<rank> previous_indices;
 
-      // declare some other classes
-      // as friends. make sure to
-      // work around bugs in some
-      // compilers
+      // Declare some other classes as friends. Make sure to work around bugs
+      // in some compilers:
       template <int, int, typename>
       friend class dealii::SymmetricTensor;
       template <int, int, bool, int, typename>
@@ -468,10 +466,8 @@ namespace internal
       tensor_type &            tensor;
       const TableIndices<rank> previous_indices;
 
-      // declare some other classes
-      // as friends. make sure to
-      // work around bugs in some
-      // compilers
+      // Declare some other classes as friends. Make sure to work around bugs
+      // in some compilers:
       template <int, int, typename>
       friend class dealii::SymmetricTensor;
       template <int, int, bool, int, typename>
@@ -896,15 +892,11 @@ private:
    */
   base_tensor_type data;
 
-  /**
-   * Make all other symmetric tensors friends.
-   */
+  // Make all other symmetric tensors friends.
   template <int, int, typename>
   friend class SymmetricTensor;
 
-  /**
-   * Make a few more functions friends.
-   */
+  // Make a few more functions friends.
   template <int dim2, typename Number2>
   friend DEAL_II_CONSTEXPR Number2
                            trace(const SymmetricTensor<2, dim2, Number2> &d);
@@ -930,9 +922,7 @@ private:
                            identity_tensor();
 
 
-  /**
-   * Make a few helper classes friends as well.
-   */
+  // Make a few helper classes friends as well.
   friend struct internal::SymmetricTensorImplementation::
     Inverse<2, dim, Number>;
 
index fb9526d226c8161e1dfc32489322d95b504dcfe8..75cccf88e66e4c083f0f6e1f4c4c13657eff56c0 100644 (file)
@@ -362,9 +362,7 @@ private:
   unroll_recursion(Vector<OtherNumber> &result,
                    unsigned int &       start_index) const;
 
-  /**
-   * Allow an arbitrary Tensor to access the underlying values.
-   */
+  // Allow an arbitrary Tensor to access the underlying values.
   template <int, int, typename>
   friend class Tensor;
 };
@@ -732,16 +730,12 @@ private:
   constexpr DEAL_II_CUDA_HOST_DEV
   Tensor(const ArrayLike &initializer, std_cxx14::index_sequence<Indices...>);
 
-  /**
-   * Allow an arbitrary Tensor to access the underlying values.
-   */
+  // Allow an arbitrary Tensor to access the underlying values.
   template <int, int, typename>
   friend class Tensor;
 
-  /**
-   * Point is allowed access to the coordinates. This is supposed to improve
-   * speed.
-   */
+  // Point is allowed access to the coordinates. This is supposed to improve
+  // speed.
   friend class Point<dim, Number>;
 };
 

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.