From: Wolfgang Bangerth <bangerth@colostate.edu>
Date: Fri, 22 Sep 2023 15:16:52 +0000 (-0600)
Subject: Use a proper doxygen @cite reference.
X-Git-Tag: relicensing~474^2
X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=9e8b515c2587f9f8c513e1ee339b185d006b19ee;p=dealii.git

Use a proper doxygen @cite reference.
---

diff --git a/doc/doxygen/headers/constraints.h b/doc/doxygen/headers/constraints.h
index be19d57795..f04f0d4132 100644
--- a/doc/doxygen/headers/constraints.h
+++ b/doc/doxygen/headers/constraints.h
@@ -443,10 +443,7 @@
  * @f[
  *   (C^T A C + Id_c) \tilde x = C^T (b - A\,k)
  * @f]
- * instead [1] (M. S. Shephard. Linear multipoint constraints applied via
- * transformation as part of a direct stiffness assembly process.
- * <i>International Journal for Numerical Methods in Engineering</i>
- * 20(11):2107-2112, 1985).
+ * instead (see, for example, @cite Shephard1984).
  *
  * Here, $A$ is a given (unconstrained) system matrix for which we only
  * assume that we can apply it to a vector but can not necessarily access
diff --git a/doc/doxygen/references.bib b/doc/doxygen/references.bib
index 966ff103f6..fdaa7f4a4e 100644
--- a/doc/doxygen/references.bib
+++ b/doc/doxygen/references.bib
@@ -2218,3 +2218,17 @@
   doi = {10.1002/fld.1650020302},
   url = {http://doi.org/10.1002/fld.1650020302},
 }
+
+@article{Shephard1984,
+        doi = {10.1002/nme.1620201112},
+        url = {https://doi.org/10.1002%2Fnme.1620201112},
+        year = 1984,
+        month = {nov},
+        publisher = {Wiley},
+        volume = {20},
+        number = {11},
+        pages = {2107--2112},
+        author = {Mark S. Shephard},
+        title = {Linear multipoint constraints applied via transformation as part of a direct stiffness assembly process},
+        journal = {International Journal for Numerical Methods in Engineering}
+}
\ No newline at end of file
diff --git a/include/deal.II/lac/affine_constraints.h b/include/deal.II/lac/affine_constraints.h
index 7426cfa9eb..63a7568e2f 100644
--- a/include/deal.II/lac/affine_constraints.h
+++ b/include/deal.II/lac/affine_constraints.h
@@ -500,12 +500,11 @@ namespace internal
  *
  * @note Many of the algorithms this class implements are discussed in the
  * @ref hp_paper.
- * The algorithms are also related to those shown in <i>M. S. Shephard: Linear
- * multipoint constraints applied via transformation as part of a direct
- * stiffness assembly process. Int. J. Numer. Meth. Engrg., vol. 20 (1984),
- * pp. 2107-2112.</i>, with the difference that the algorithms shown there
- * completely eliminated constrained degrees of freedom, whereas we usually
- * keep them as part of the linear system.
+ * The algorithms are also related to those shown in @cite Shephard1984 ,
+ * with the difference that the algorithms shown there
+ * completely eliminate constrained degrees of freedom, whereas we usually
+ * keep them as part of the linear system (but zero out the row and column
+ * to decouple this degree of freedom from the rest of the linear system).
  *
  * @ingroup dofs
  * @ingroup constraints