git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@9959 f3b2605a-c512-4ea7-a41b-209d697bcdaa

lib/atc/Makefile.lammps.empty

@@ -0,0 +1,5 @@
+# Settings that the LAMMPS build will import when this package library is used
+
+user-atc_SYSINC =
+user-atc_SYSLIB =
+user-atc_SYSPATH =

lib/atc/README

@@ -1,48 +1,21 @@
-This directory has source files to build a library that LAMMPS
-links against when using the USER-ATC package.
-
-When you are done building this library, two files should
-exist in this directory:
-
-libatc.a		the library LAMMPS will link against
-Makefile.lammps		settings the LAMMPS Makefile will import
-
-The latter file will have settings like this (can be omitted if blank):
-
-user-atc_SYSINC =
-user-atc_SYSLIB = -lblas -llapack
-user-atc_SYSPATH =
-
-SYSINC is for settings needed to compile LAMMPS source files
-SYSLIB is for additional system libraries needed by this package
-SYSPATH is the path(s) to where those libraries are
-
-You must insure these settings are correct for your system, else
-the LAMMPS build will likely fail.
-
-Note that there is a lib/linalg directory which has the BLAS and
-LAPACK files needed by the USER-ATC package.  If you don't have BLAS
-and LAPACK on your system, you can build the pseudo-library in the
-linalg directory, and point to that with the SYSLIB and SYSPATH
-variables discussed above.
-
--------------------------------------------------------------------------
-
 ATC (Atom To Continuum methods)
 
 Reese Jones, Jeremy Templeton, Jonathan Zimmerman (Sandia National Labs)
 rjones, jatempl, jzimmer at sandia.gov
 September 2009
 
---------------
-
 This is version 1.0 of the ATC library, which provides continuum field
 estimation and molecular dynamics-finite element coupling methods.
 
+---------------------------
+
+This directory has source files to build a library that LAMMPS
+links against when using the USER-ATC package.
+
 This library must be built with a C++ compiler, before LAMMPS is
 built, so LAMMPS can link against it.
 
-Build the library using one of the provided Makefiles or creating your
+Build the library using one of the provided Makefiles or create your
 own, specific to your compiler and system.  For example:
 
 make -f Makefile.g++
@@ -51,9 +24,28 @@ Note that the ATC library makes MPI calls, so you must build it with
 the same MPI library that is used to build LAMMPS, e.g. as specified
 by settings in the lammps/src/MAKE/Makefile.foo file.
 
-If the build is successful, you should end up with a libatc.a file.
+When you are done building this library, two files should
+exist in this directory:
 
-When you build LAMMPS with this library, you must insure that the
-settings in the lo-level Makefile (in lammps/src/MAKE) are correct for
-user-atc-SYSLIB and user-atc_SYSLIBPATH, so the the appropriate BLAS
-and LAPACK libraries on your system can be linked against.
+libatc.a		the library LAMMPS will link against
+Makefile.lammps		settings the LAMMPS Makefile will import
+
+Makefile.lammps is created by the make procedure, by making a copy of
+one of the Makefile.lammps.* files.  See the EXTRAMAKE setting at the
+top of the Makefile.* files.  It is IMPORTANT that you examine the
+final Makefile.lammps to insure it is correct for your system, else
+the LAMMPS build will likely fail.
+
+Makefile.lammps has settings for 3 variables:
+
+user-atc_SYSINC = leave blank for this package
+user-atc_SYSLIB = additional system libraries needed by this package
+user-atc_SYSPATH = path(s) to where those libraries are
+
+SYSLIB must specify a BLAS library and a LAPACK library.  If they are
+already installed on your system, the settings in
+Makefile.lammps.installed should suffice.  If you want to use the
+version provided with LAMMPS in lib/linalg, then the settings in
+Makefile.lammps.linalg should work.  Note that in this case you also
+need to build the linear-algebra in lib/linalg; see the
+lib/linalg/README for more details.