From d2882ddaa6d8227d6dd4c629e5155fcbaa90cb0d Mon Sep 17 00:00:00 2001
From: sjplimp
Date: Tue, 19 Jun 2012 20:17:00 +0000
Subject: [PATCH] git-svn-id: svn://svn.icms.temple.edu/lammps-ro/trunk@8341
f3b2605a-c512-4ea7-a41b-209d697bcdaa
---
doc/Section_start.html | 27 +++++++++++++++++++++------
doc/Section_start.txt | 27 +++++++++++++++++++++------
2 files changed, 42 insertions(+), 12 deletions(-)
diff --git a/doc/Section_start.html b/doc/Section_start.html
index 6b916b42f2..e071e8182b 100644
--- a/doc/Section_start.html
+++ b/doc/Section_start.html
@@ -640,10 +640,9 @@ in this manner:
make -f Makefile.g++
-in the appropriate directory, e.g. in lib/reax. Some of the libraries
-do not build this way. Some of the directories do not even have
-source code for the library, since you are expected to download and
-build it separately. Again, see the libary README file for details.
+
in the appropriate directory, e.g. in lib/reax. However, some of the
+libraries do not build this way. Again, see the libary README file
+for details.
If you are building the library, you will need to use a Makefile that
is a match for your system. If one of the provided Makefiles is not
@@ -687,8 +686,24 @@ LAPACK library. It can then be included in the
lib/atc/Makefile.lammps file as part of the SYSPATH and SYSLIB lines
so that LAMMPS will build properly with the USER-ATC package.
-Note that if these settings are not correct for your box, the LAMMPS
-build will likely fail.
+
Note that if the Makefile.lammps settings are not correct for your
+box, the LAMMPS build will likely fail.
+
+There are also a few packages, like KIM and USER-MOLFILE, that use
+additional auxiliary libraries which are not provided with LAMMPS. In
+these cases, there is no corresponding sub-directory under the lib
+directory. You are expected to download and install these libraries
+yourself before building LAMMPS with the package installed, if they
+are not already on your system.
+
+However there is still a Makefile.lammps file with settings used when
+building LAMMPS with the package installed, as in (2) above. Is is
+found in the package directory itself, e.g. src/KIM/Makefile.lammps.
+This file contains the same 3 settings described above for SYSINC,
+SYSPATH, and SYSLIB. The Makefile.lammps file contains instructions
+on how to specify these settings for your system. You need to specify
+the settings before building LAMMPS with one of those packages
+installed, else the LAMMPS build will likely fail.
diff --git a/doc/Section_start.txt b/doc/Section_start.txt
index 5b96a76982..3d07fd2613 100644
--- a/doc/Section_start.txt
+++ b/doc/Section_start.txt
@@ -634,10 +634,9 @@ in this manner:
make -f Makefile.g++ :pre
-in the appropriate directory, e.g. in lib/reax. Some of the libraries
-do not build this way. Some of the directories do not even have
-source code for the library, since you are expected to download and
-build it separately. Again, see the libary README file for details.
+in the appropriate directory, e.g. in lib/reax. However, some of the
+libraries do not build this way. Again, see the libary README file
+for details.
If you are building the library, you will need to use a Makefile that
is a match for your system. If one of the provided Makefiles is not
@@ -681,8 +680,24 @@ LAPACK library. It can then be included in the
lib/atc/Makefile.lammps file as part of the SYSPATH and SYSLIB lines
so that LAMMPS will build properly with the USER-ATC package.
-Note that if these settings are not correct for your box, the LAMMPS
-build will likely fail.
+Note that if the Makefile.lammps settings are not correct for your
+box, the LAMMPS build will likely fail.
+
+There are also a few packages, like KIM and USER-MOLFILE, that use
+additional auxiliary libraries which are not provided with LAMMPS. In
+these cases, there is no corresponding sub-directory under the lib
+directory. You are expected to download and install these libraries
+yourself before building LAMMPS with the package installed, if they
+are not already on your system.
+
+However there is still a Makefile.lammps file with settings used when
+building LAMMPS with the package installed, as in (2) above. Is is
+found in the package directory itself, e.g. src/KIM/Makefile.lammps.
+This file contains the same 3 settings described above for SYSINC,
+SYSPATH, and SYSLIB. The Makefile.lammps file contains instructions
+on how to specify these settings for your system. You need to specify
+the settings before building LAMMPS with one of those packages
+installed, else the LAMMPS build will likely fail.
:line