summaryrefslogtreecommitdiffstats
path: root/libraries/lapack-atlas/README.SLACKWARE
diff options
context:
space:
mode:
Diffstat (limited to 'libraries/lapack-atlas/README.SLACKWARE')
-rw-r--r--libraries/lapack-atlas/README.SLACKWARE49
1 files changed, 49 insertions, 0 deletions
diff --git a/libraries/lapack-atlas/README.SLACKWARE b/libraries/lapack-atlas/README.SLACKWARE
new file mode 100644
index 0000000000..fccc6b12b6
--- /dev/null
+++ b/libraries/lapack-atlas/README.SLACKWARE
@@ -0,0 +1,49 @@
+The following notes apply just for LAPACK built against ATLAS.
+
+IMPORTANT NOTES:
+
+
+1) If you update ATLAS, you MUST also rebuild and reinstall LAPACK, even if
+ there is no update available for LAPACK! Otherwise you end up with a
+ broken/incomplete LAPACK library!
+
+2) This SlackBuild conflicts with the lapack.SlackBuild which is meant mainly
+ for compilation against the reference BLAS. You may install LAPACK by
+ this SlackBuild in parallel with the LAPACK built against the reference BLAS
+ if you use the SYS_DESTDIR and DEFAULT_DOCS variables (see below), but then
+ you are on your own, especially when compiling other software against LAPACK
+ and BLAS/ATLAS.
+
+3) There are a few extra variables which you may want or need to give
+ appropriate values when calling the lapack-atlas.SlackBuild: SYS_DESTDIR,
+ DEFAULT_DOCS, USE_ATLAS_PT_LIBS and TEST_LAPACK.
+
+ SYS_DESTDIR is set by default to "/usr" and is the system destination
+ directory. When installing the package produced by this SlackBuild,
+ LAPACK's files will be written to $SYS_DESTDIR/lib (or lib64).
+ Documentation files are written to /usr/doc/lapack-atlas-$VERSION if not
+ otherwise stated (see below).
+ You may want to change the value of SYS_DESTDIR to avoid conflicts (see
+ the notes above). IMPORTANT: SYS_DESTDIR has to have an absolute
+ path as value.
+
+ DEFAULT_DOCS has the default value "yes", which means that docs go
+ to /usr/doc/lapack-atlas-$VERSION, but you may want to let the docs to
+ go to $SYS_DESTDIR/doc/lapack-atlas-$VERSION. For this, just set this
+ variable to something like "no".
+
+ USE_ATLAS_PT_LIBS is set by default to "yes" which means that this script
+ will try to build LAPACK against the threaded ATLAS libs. On a single
+ processor machine these are missing and you will get a WARNING which you
+ can ignore, since ATLAS will not create these libraries on such a machine.
+ On a multi processor machine the WARNING should not be there and you need to
+ set this variable to "no" if you want to force LAPACK to build against the
+ single threaded ATLAS libraries. At this point in time this is discouraged
+ and you are on your own if you do it, especially when compiling other
+ software which depends on LAPACK and ATLAS.
+
+ TEST_LAPACK is set by default to "no" which means that this script will not
+ try to run the LAPACK test suite. Set it to "yes" if you want the opposite.
+
+ All these settings may be done the usual way on the command line when
+ calling this SlackBuild, you do not have to edit the script.