From 16614b16fe841b88e4238360860023270f10c2cb Mon Sep 17 00:00:00 2001
From: Timo Heister <timo.heister@gmail.com>
Date: Mon, 2 Sep 2019 14:37:36 -0400
Subject: [PATCH] step-63: add references

---
 doc/doxygen/references.bib     | 34 ++++++++++++++++++++++++++++++++++
 examples/step-63/doc/intro.dox | 11 ++++++-----
 2 files changed, 40 insertions(+), 5 deletions(-)

diff --git a/doc/doxygen/references.bib b/doc/doxygen/references.bib
index e458098bb7..1fee0117ab 100644
--- a/doc/doxygen/references.bib
+++ b/doc/doxygen/references.bib
@@ -307,6 +307,40 @@ MRREVIEWER = {Jose Luis Gracia},
        URL = {http://dx.doi.org/10.1137/070706616},
 }
 
+% ------------------------------------
+% Step 63
+% ------------------------------------
+
+@incollection{john2006discontinuity,
+  title={On discontinuity—capturing methods for convection—diffusion equations},
+  author={John, Volker and Knobloch, Petr},
+  booktitle={Numerical Mathematics and Advanced Applications},
+  pages={336--344},
+  year={2006},
+  publisher={Springer}
+}
+
+@article{KanschatNotesIterative,
+  title={Notes on Applied Mathematics: Iterative methods, Schwarz preconditioners and multigrid},
+  author={Kanschat, Guido},
+  year={2015},
+  url={https://www.mathsim.eu/~gkanscha/notes/C.pdf}
+}
+
+@book{smith2004domain,
+  title={Domain decomposition: parallel multilevel methods for elliptic partial differential equations},
+  author={Smith, Barry and Bjorstad, Petter and Gropp, William},
+  year={2004},
+  publisher={Cambridge University Press}
+}
+
+@book{toselli2006domain,
+  title={Domain decomposition methods-algorithms and theory},
+  author={Toselli, Andrea and Widlund, Olof},
+  volume={34},
+  year={2006},
+  publisher={Springer Science \& Business Media}
+}
 
 % ------------------------------------
 % References used elsewhere
diff --git a/examples/step-63/doc/intro.dox b/examples/step-63/doc/intro.dox
index ef6e6e689c..201c8824ae 100644
--- a/examples/step-63/doc/intro.dox
+++ b/examples/step-63/doc/intro.dox
@@ -108,10 +108,8 @@ a(u_h,\,v_h) + \sum_K (-\varepsilon \Delta u_h +
 @f}
 where the sum is done over all cells $K$ with the inner product taken
 for each cell, and $\delta_K$ is a cell-wise constant
-stabilization parameter defined in <a
-href="https://link.springer.com/chapter/10.1007/978-3-540-34288-5_27">
-On Discontinuity-Capturing Methods for Convection-Diffusion Equations
-by Volker John and Petr Knobloch</a>.
+stabilization parameter defined in
+@cite john2006discontinuity.
 
 Essentially, adding in the
 discrete strong form residual enhances the coercivity of the bilinear
@@ -166,7 +164,10 @@ accordingly so that the ones further upstream are treated earlier
 (have larger indices). The influence of the ordering will be visible
 in the results section.
 
-Let us now briefly define the smoothers used in this tutorial. A Schwarz
+Let us now briefly define the smoothers used in this tutorial.
+For a more detailed introduction, we refer to
+@cite KanschatNotesIterative and the books @cite smith2004domain and @cite toselli2006domain.
+A Schwarz
 preconditioner requires a decomposition
 @f{align*}{
 V = \sum_{j=1}^J V_j
-- 
2.39.5