@@ -2,7 +2,9 @@ MAINTENANCE DOCUMENTATION FOR ALBERT PACKAGES
Daniel Koester, June 2002
I) Introduction and Maintenance
The albert-x.x packages are now distributed using autoconf, automake, and libtool. Since some unusual compilation was necessary, a few hints seemed like a good idea. Here is the general structure of the albert-1.1 packages:
===============================
The albert-x.x packages are now distributed using GNU autoconf 2.53, automake 1.6, and libtool 1.4.2. Since some unusual compilation was necessary, a few hints seemed like a good idea. Here is the general structure of the albert-1.1 packages:
_________ ALBERT/ __________ src/ _______|--- 1d/
/ \ |--- 2d/
...
...
@@ -27,7 +29,10 @@ We keep track of the "Makefile.am"s, which are processed by automake to create "
The file "configure.ac" is processed by autoconf to create "configure". The script "configure" then processes "Makefile.in"s to create proper Makefiles. The created Makefiles can then be used by us to test compilation and the demo programs. All Makefiles can be called independently from any subdirectory. The "install"-target is used to install a package (defaults for maintenance: albert-x.x/lib/ and albert-x.x/include/ as installation paths for libraries and headers, no shared libraries). There are also several variations of "clean" targets.
II) Package contents
====================
The following subpackages are included in albert-x.x:
1) ALBERT
The main package.
...
...
@@ -47,7 +52,10 @@ PLOT_ANSI provides tools for displaying X11 graphics, if gltools is not used.
6) SOLVER
Linear and nonlinear solver routines for ALBERT.
III) External packages
======================
The gltools package is not part of ALBERT. If it is detected during installation, the file ALBERT/src/Common/gltools.c is included in the ALBERT libraries. The user can specify the path of an already installed gltools-package as a configure option, see INSTALL.
IV) Checking into CVS directory tree
...
...
@@ -56,7 +64,10 @@ Do [g]make clean cvs-clean. This deletes all files which are not part of the CVS
Step 2)
cvs commit
V) How to create a distribution
===============================
Step 1)
At the moment, the subpackages ALBERT, BLAS, DEMO, IAMTOOLS, PLOT_ANSI, and SOLVER are maintained using the version control system CVS. To prepare a distribution, one must first check out the distribution version of these packages. The CVS-module admin contains the main administration files like "configure.ac" and the main "Makefile.am" from the root directory.
...
...
@@ -74,16 +85,19 @@ enters "configure" followed by "gmake", "gmake install" to install everything.
c) "configure" AND "configure.ac" are included, so that possible installation problems can (hopefully) be corrected without too much trouble.
V) Problems so far
Some things are already explained in "configure.ac", in which I invested most of the work.
V) Problems and tested platforms
================================
Some things are already explained in "configure.ac", in which I invested most of the work. If not explicitly stated otherwise below, "configure" will run without extra command line options.
Choosing not to use libtool would require many changes, the first would be to change all "LTLIBRARIES" to "LIBRARIES" in all "Makefile.am"s.
1) mips-sgi-irix6.5:
a) The -lgl and -lGL libraries are required.
b) The -n32 link flag seemed to be necessary for g77 (and thus for all object files!!). This was done using @object_type@ set by configure.
2) i686-suse-linux:
a) We used MesaGL and a BLAS lib from the SuSE distribution... The BLAS lib needed -lg2c to function properly.
3) sparc-sun-SunOS:
a) For the xdr-Routines, the library -lnsl seemed necessary.
b) In our case, "configure" did not automatically recognize the canonical system triplet. Calling "configure --build=sparc" worked.
