From 733848f38c1148d1374e725b27120743172d0c4e Mon Sep 17 00:00:00 2001
From: Wolfgang Bangerth <bangerth@math.tamu.edu>
Date: Wed, 9 Jul 2014 11:54:27 +0000
Subject: [PATCH] Document how to compile Trilinos with direct solvers.

git-svn-id: https://svn.dealii.org/trunk@33121 0785d39b-7218-0410-832d-ea1e28bc413d
---
 deal.II/doc/external-libs/trilinos.html | 33 +++++++++++++++++++++++--
 1 file changed, 31 insertions(+), 2 deletions(-)
diff --git a/deal.II/doc/external-libs/trilinos.html b/deal.II/doc/external-libs/trilinos.html
index 5776eb809a..1e0a135138 100644
--- a/deal.II/doc/external-libs/trilinos.html
+++ b/deal.II/doc/external-libs/trilinos.html
@@ -4,7 +4,7 @@
   <head>
     <title>The deal.II Readme on interfacing to Trilinos</title>
     <link href="../screen.css" rel="StyleSheet">
-    <meta name="copyright" content="Copyright (C) 2008, 2009, 2010, 2011, 2012, 2013 by the deal.II authors">
+    <meta name="copyright" content="Copyright (C) 2008, 2009, 2010, 2011, 2012, 2013, 2014 by the deal.II authors">
     <meta name="date" content="$Date$">
     <meta name="svn_id" content="$Id$">
     <meta name="keywords" content="deal.II">
@@ -87,13 +87,18 @@
       in the CMAKE_INSTALL_PREFIX line.
     </p>
 
+
+    <h5>Parallel builds</h5>
+
     <p>
-      <b>Parallel builds:</b>
       If your computer has more than one processor core, use
       <code>make -jN</code> instead of <code>make</code> in the last line
       above, where <code>N</code> is the number of processors you have.
     </p>
 
+
+    <h5>BLAS and LAPACK</h5>
+
     <p>
       Trilinos sometimes searches for other libraries but can't find
       them if they are not in the usual directories or have other
@@ -111,6 +116,30 @@
 	</pre>
     </p>
 
+
+    <h5>Using external direct solvers</h5>
+
+    <p>
+      Trilinos (via its Amesos package) can interface with a number of direct
+      solvers (see, for example,
+      <a href="http://trilinos.org/docs/r11.8/packages/amesos/doc/html/index.html"
+	 target="_top">this page for Trilinos 11.8</a>). Most of them are external
+      packages to Trilinos and you will need to tell Trilinos configuration
+      scripts that you want to use them, for example via the 
+      <code>TrilinosWrappers::SolverDirect</code> class.  This can be tricky,
+      but adding defines similar to the following to the cmake command line
+      will achieve the goal:
+      <pre>
+
+          -D TPL_ENABLE_UMFPACK:BOOL=ON \
+          -D TPL_ENABLE_SuperLU:BOOL=ON \
+          -D TPL_ENABLE_SuperLUDist:BOOL=ON \
+          -D TPL_UMFPACK_INCLUDE_DIRS="/usr/include" \
+          -D SuperLUDist_INCLUDE_DIRS:FILEPATH="/path/to/SuperLU_DIST_3.2/SRC" \
+-D TPL_SuperLUDist_LIBRARIES:FILEPATH="/path/to/SuperLU_DIST_3.2/lib/libsuperlu_dist.a" \
+          -D SuperLU_INCLUDE_DIRS:FILEPATH="/path/to/SuperLU_4.3/SRC" \
+          -D TPL_SuperLU_LIBRARIES:FILEPATH="/path/to/SuperLU_4.3/lib/libsuperlu_4.3.a"
+      </pre>
     <hr />
     <address>
       <a href="http://www.dealii.org/authors.html" target="_top">The deal.II Authors</a>
-- 
2.39.5

