From 12895253397bdd17d739dc0841f3424ae9ceff48 Mon Sep 17 00:00:00 2001
From: Martin Kronbichler <kronbichler@lnm.mw.tum.de>
Date: Thu, 19 Feb 2015 14:58:11 +0100
Subject: [PATCH] Improve documentation

---
 include/deal.II/lac/solver.h | 19 +++++++++++--------
 1 file changed, 11 insertions(+), 8 deletions(-)

diff --git a/include/deal.II/lac/solver.h b/include/deal.II/lac/solver.h
index 2388cd2aad..f986658876 100644
--- a/include/deal.II/lac/solver.h
+++ b/include/deal.II/lac/solver.h
@@ -121,21 +121,24 @@ template <typename number> class Vector;
  * vectors.
  *
  * Finally, the solvers also expect an instantiation of
- * GrowingVectorMemory<VECTOR>. These instantiations are provided by the
+ * GrowingVectorMemory@<VECTOR@>. These instantiations are provided by the
  * deal.II library for the built-in vector types, but must be explicitly added
  * for user-provided vector classes. Otherwise, the linker will complain that
- * it cannout find the constructors and destructors of GrowingVectorMemory
- * that happen in the @p Solver class below.
+ * it cannot find the constructors and destructors of GrowingVectorMemory that
+ * happen in the @p Solver class.
  *
  * @code
- * #include <deal.II/lac/vector_memory.templates.h>
- *
  * // Definition and implementation of vector class
  * class UserVector { ... };
  *
- * // Create explicit instantiation for the vector class
- * template class VectorMemory<UserVector >;
- * template class GrowingVectorMemory<UserVector >;
+ * // Create explicit instantiation for the vector class. If your project
+ * // consists of multiple files, including header files, this instantiation
+ * // must be put in a <code>.cc</code> file in order to instantiate only
+ * // once.
+ * #include <deal.II/lac/vector_memory.templates.h>
+ *
+ * template class VectorMemory<UserVector>;
+ * template class GrowingVectorMemory<UserVector>;
  * @endcode
  *
  * The preconditioners used must have the same interface as matrices, i.e. in
-- 
2.39.5