From e177c5faeb842adbbe96108df10343be12e18bec Mon Sep 17 00:00:00 2001
From: Claus-Justus Heine <Claus-Justus.Heine@IANS.Uni-Stuttgart.DE>
Date: Wed, 7 Jan 2004 18:09:15 +0000
Subject: [PATCH] Fixed some typos.
---
README | 63 +++++++++++++++++++++++++++++++++++++++-------------------
1 file changed, 43 insertions(+), 20 deletions(-)
diff --git a/README b/README
index 4ec88af..afa2116 100644
--- a/README
+++ b/README
@@ -2,13 +2,31 @@ ALBERTA is an Adaptive multi-Level finite element toolbox using
Bisectioning refinement and Error control by Residual
Techniques for scientific Applications.
+-------------------------------------------------------------------------------
+
Contents
========
I. Introduction
+
II. External Packages (both required and optional packages)
+ 1.) Required Packages
+ OpenGL
+ BLAS (with examples)
+ 2.) Optional Packages
+ gltools
+ GRAPE
+ alternate compilers
+
III. Configure Options
-IV. Compiler flags
+ 1.) Non-standard behaviour of ALBERTA
+ 2.) Options affecting which versions of ALBERTA are built
+ 3.) Options controlling the search-path for external libraries
+
+IV. Compiler flags (with examples)
+
+-------------------------------------------------------------------------------
+
I) Introduction
===============
@@ -202,8 +220,8 @@ alternate compilers
Many CPU-vendors distribute highly optimizing compilers for
their specific CPU architecture. Often those compilers
generate much faster code than even a modern gcc. Sometimes
- they are available at no cost, at least for private and
- research use.
+ they are available at no costs, at least for private and
+ academical use.
III) Configure Options
@@ -219,10 +237,14 @@ The remaining (i.e. ALBERTA specific) options are explained here:
1.) Non-standard behaviour of ALBERTA
-------------------------------------
-BIG FAT NOTE: the default installation prefix of the ALBERTA-package
+BIG FAT NOTE: the _default_ installation prefix of the ALBERTA-package
is _NOT_ the default GNU installation prefix which would be
-/usr/local/ on Un*x systems, but it is the build-directory. I.e. when
-compiling ALBERTA below
+/usr/local/ on Un*x systems, but it is the build-directory. Of course,
+you can change the default behavior by using the "--prefix=PREFIX"
+switch when running configure (see ./INSTALL). However, the default
+layout is like follows:
+
+When compiling ALBERTA below
/usr/people/claus/alberta-1.2/
@@ -241,7 +263,7 @@ libtool.alberta will reside in
and finally the demo package (under the name alberta-1.2.demo.tar.gz)
will be copied to
- /usr/people/claus/alberta-1.2/libexec/share/
+ /usr/people/claus/alberta-1.2/share/
This will be the layout after running "make install".
@@ -284,7 +306,7 @@ The options below control which of them are actually created.
surrounding space has dimension 3. (default: disabled)
--enable-el-index
- Additionally build ALBERTA libraries which assigns unique
+ Additionally build ALBERTA libraries which assigns an unique
index to each element. Normally, this is not needed but it can
be handy for debugging purposes. (default: disabled)
@@ -293,8 +315,8 @@ The options below control which of them are actually created.
information. On some systems (or better: with some compilers)
optimization and debugging are mutual exclusive, therefore
there are separate ALBERTA libraries which are compiled with
- optimization, but without debugging information, and another
- versions which is compiled without optimization, but with
+ optimization, but without debugging information, and other
+ versions which are compiled without optimization, but with
debugging. (default: enabled)
@@ -314,10 +336,10 @@ following options:
--with-PKG-name=NAME
Alter the default name of the package,
e.g. "--with-opengl-name=MesaGL" or "--with-blas-name=cxml".
- NOTE: it is possible to specify more than one library. E.g on
- (some versions of?) Solaris the BLAS-library is called
- "libsunperf.so". If you want to link with this library using
- gcc and g77, then you need to specify
+ NOTE: it is possible to specify more than one library. For
+ example on (some versions of?) Solaris the BLAS-library is
+ called "libsunperf.so". If you want to link with this library
+ using gcc and g77, then you need to specify
"--with-blas-name=sunperf -lfui -lfsu -lsunmath"
@@ -338,7 +360,8 @@ following options:
e.g. "--with-opengl-include=/usr/people/claus/software/include/".
The following quotes the relevant fragment of the online-help obtained
-by running "configure --help"
+by running "configure --help". Please see the file ./INSTALL for the
+notation (e.g. PREFIX, EPREFIX etc.).
--with-blas-name=NAME use NAME as the name of the blas library (without
leading "lib" prefix and trailing suffix). Default:
@@ -425,7 +448,7 @@ Examples:
1.) gcc with a Pentium 4
- ./configure <blablabla> \
+ ./configure [OTHER OPTIONS] \
CFLAGS="-march=pentium4 -mfpmath=sse" \
FFLAGS="-march=pentium4 -mfpmath=sse"
make
@@ -437,13 +460,13 @@ or (assuming a Bourne-shell)
FFLAGS="-march=pentium4 -mfpmath=sse"
export CFLAGS FFLAGS
- ./configure <blablabla>
+ ./configure [OTHER OPTIONS]
make
make install
or
- ./configure <blablabla>
+ ./configure [OTHER OPTIONS]
make CFLAGS="-march=pentium4 -mfpmath=sse" \
FFLAGS="-march=pentium4 -mfpmath=sse"
make install
@@ -451,8 +474,8 @@ or
2.) Pentium 4 with icc and with Intel "math kernel library" (BLAS
implementation)
- ./configure <blablabla> \
- CC=icc CFLAGS="-mcpu=pentium4" ALBERTA_OPTIMIZE_CFLAGS="-O3" \
+ ./configure [OTHER OPTIONS] \
+ CC=icc CFLAGS="-xW" ALBERTA_OPTIMIZE_CFLAGS="-O3" \
ALBERTA_DEBUG_CFLAGS="-O0 -g" \
F77=ifc FFLAGS="-xW -O3" \
--with-blas-name=mkl --with-blas-lib=/opt/intel/mkl61/lib/32/
--
GitLab