Platforms on which this has been compiled and tested (at least
moderately):

- Sun 4's, running SunOS 4.1.[1-3], and X11R5.
- Sun 4's, running SunOS 5.2 (Solaris), and Solaris' OpenWindows 
  (based on R5).
- Sun 4's, running SunOS 4.1.[1-3], and OpenWindows (based on R4).
- Sun 3's, running SunOS 4.1.1 and X11R4.
- HP's running HP-UX and X11R5: The configure script cannot (yet)
  handle c89 under HPUX.
- HP's running HP-UX and X11R4: this one may be troublesome.  I've had a 
  great deal of difficulty getting the communication to work on HP
  machines, to which I have very little access.  You will have a good
  chance of success on HP-UX A.09.01.
- Decstations running ultrix and X11R5
- IBM RS6000's running AIX and X11R5
- Sequent Symmetry running DYNIX and X11R4
- Linux 0.99.12 Kernel with X386 1.3 on a 486 box.  There's no reason
  why it shouldn't work on later versions as well. Notice that we by
  default link with -g which _not_ generate shared executable on Linux
- SONY NEWS NWS-3860 (Mips R3000 CPU) NEWS-OS 4.2R
- DEC OSF/1 (1.3A) Alpha: Use either cc, cc -std0, or cc -std, but
  it will probably not compile with cc -std1 until we have fixed
  the last warnings.
- 4.3 Reno BSD: I got it to compile under gcc-2.5.8 by adding
  -D__BSD_NET2__ (to avoid problems with <stdarg.h>) and with
  -DNO_STDLIB_H (to avoid problems with wchar_t). Using CC, it
  is was sufficient to add -DNO_STDLIB_H to avoid the same problem,
  but it might very well just be because of a broken X11 setup.
- DEC OSF/MIPS

X Window System:  You need X11 Release 5.  We've done some things with
window resizing that don't work under R4 and products based on it such
as OpenWindows 3.  If you only have X11R4 products, it'll still run, but
the window resizing won't work, so don't resize windows :-).  X11R6,
which has just been released, will be ready as soon as possible.

C Compiler:  You can use either a traditional K&R C compiler or an ANSI
C compiler.  We've tested the latter with gcc -ansi -pedantic as well as 
the ANSI compiler on the Alpha box and under SunOS. LINCKS should compile
without any warnings using an ANSI compiler (but you must run configure
first).

This file explains briefly how to compile and install the LINCKS system.

1. We have redone the configuration of the system since the last
   release.  We now use GNU's autoconf to generate a configure script
   which should figure out the what you need on your architecture.  You
   have to have Bourne Shell around, but if you don't it's not UNIX.

   Run configure

	./configure

   Note that since we check for many things with configure, this takes
   quite a while!

   If you would like to have a bit of help with configure, then type

	./configure -help

   The options most likely to be important are --x-libraries=DIR and
   --x-includes=DIR to help you find the X libraries and includes.  If
   you've got a relatively normal setup, configure will find them.  If
   not, you can tell it where they are with these options.

   By default, the programs/libraries are installed in a directory
   called database under the top directory of the distribution.  This
   can be reset with the --prefix=PREFIX option.  For example, 

	./configure --prefix=/usr/local/lincks

   would install the programs/libraries under /usr/local/lincks.

2. After running configure, look through the file called Make.config.
   Verify that the defines are set up right for your machine.  If you
   don't really understand the file, then just try it without bothering
   with verifying :-).

3. If you want to and plan to be doing development work on the source
   tree, run "make depend" from the top directory.  This will create the
   dependencies for your system.  If you don't have "makedepend" (the
   program used), then you won't be able to do this step.

4. Note that "make help" lists all the possible targets for make.

5. If you're going to make the whole thing, simply type "make" in  this
   directory.  This will build libraries, utilities, the interface
   (xlincks) and the DBMS software.

6. Install the system into the right directories using "make install".
   This will install the binaries, libraries, include files, and man
   pages where they should be.  NOTE:  the system doesn't work if you
   install it under the /tmp directory structure.  For some reason, the
   locking doesn't work in that directory... (at least on the Suns).

7. cd into the DB directory and read the README file.  It explains how
   to install the database.  

   One possible problem that will result from this step is that the
   passwords in the passwd file are all encrypted and someone may not
   know what the password is.  Note that the accounts that are generated
   have the same password as the LINCKS username.  See also the file
   DB/PASSWDS.

8. Finally, please send us mail to let us know that you've picked up the
   distribution and are using it so that you can receive any patches.
   You can send mail to lincks@ida.liu.se.  
   
   If you wish to join the LINCKS mailing list (lincks-users@ida.liu.se), 
   please send mail to lincks-users-request@ida.liu.se and ask to be
   added.

   If you have bug reports or experienced problems in the system
   compilation or installation that you think we can help with, send
   mail to lincks-bugs@ida.liu.se.  If you send a bug report, it would
   be very helpful if it contained:

   - how to reproduce the bug, if you can.
   - your config.status file
   - the output of `gdb xlincks core' or `dbx xlincks core' or some  
     other debugger.

   This will greatly help us in finding the bug.
