From 6c2ab6cd7e7493db330f0aa0a026e0095d1cbdd4 Mon Sep 17 00:00:00 2001
From: SAM COX <spc29@le.ac.uk>
Date: Thu, 24 Nov 2016 16:37:13 +0000
Subject: [PATCH] Add note to enable linking against LAPACK 3.6.0 and later.

---
 doc/external-libs/trilinos.html | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/doc/external-libs/trilinos.html b/doc/external-libs/trilinos.html
index 6c872950a1..82f982b643 100644
--- a/doc/external-libs/trilinos.html
+++ b/doc/external-libs/trilinos.html
@@ -116,6 +116,29 @@
 
     <h5>BLAS and LAPACK</h5>
 
+    <p style="color: red">
+      Note: At the time of writing (November 2016) Trilinos (at least up to 
+      v12.8.1) cannot link against LAPACK 3.6.0 or later, due to two symbols 
+      that were deprecated (and removed by default) in LAPACK 3.6.0 (see the 
+      <a href="http://www.netlib.org/lapack/lapack-3.6.0.html">
+      release notes</a>). To fix this, edit the Trilinos file 
+      <code>packages/epetra/src/Epetra_LAPACK_wrappers.h</code> and change the 
+      lines
+      <pre>
+    
+    #define DGGSVD_F77  F77_BLAS_MANGLE(dggsvd,DGGSVD)
+    #define SGGSVD_F77  F77_BLAS_MANGLE(sggsvd,SGGSVD)
+      </pre>
+      to
+      <pre>
+    
+    #define DGGSVD_F77  F77_BLAS_MANGLE(dggsvd3,DGGSVD3)
+    #define SGGSVD_F77  F77_BLAS_MANGLE(sggsvd3,SGGSVD3)
+      </pre>
+      before installing Trilinos. (Credit for this fix goes to 
+      <a href="https://github.com/gahansen/Albany/wiki/ALCF-Vesta">this page</a>.)
+    </p>
+    
     <p>
       Trilinos sometimes searches for other libraries but can't find
       them if they are not in the usual directories or have other
-- 
2.39.5