                           ___                     ___          ,
     |  |     |        |  |   )                   '   )      ,'/
     |`'|  _ -|-  _   ||  |  '_   _   .-.  _       --<        /
     |  | ( ) |  ( \  `|  |    ) ( \  `-. ( )         )      /
        | -'--`-- - `-' \/ ---' - - `-`- --'--  (    / <>   /
________________________/\_______________________`--'___ --'-- ____________

    Please read the dox (specifically the last paragraph or so) /
                                                               '


               Ye Olde Database Installation Instructions

   ...and therefore it was known to Richid the Conqueror that you, the
mortal end-user, would eventually come across his code.  It was then
decided that instruction would be required if this code were to prove
fruitful, yea, if it were aun to be installed.  And so it was written...

                     -- UNIX SYSTEM  (make, cc) --

   Steppe 1:  Un-shar this, thy file, in thy favourite directory.  This
              steppe hast thou already accomplished!
   Steppe 2:  Edit-thou the file entitled "Makefile".  Steppe 3 will have
              you run this file, producing a library.  If you would have
              this file in any directory other than that in which this,
              thy file, resides, change-thou the variable named "LIBDIR"
              to reflect the choice directory.
   Steppe 3:  Typest-thou the word "make".

                 -- AMIGA SYSTEM (lattice C?)  / PC --

   'Ere a convention is chosen for home compilers, there is little
advice which could be of use.  Therefore, these following instructions
will be written in terms of Richid the Conqueror's own choice of the
Lattice C compiler for the Amiga:
	1> lc -cw mbase.c
	1> oml lib:mbase.lib mbase.o
	1> lc -cw build.c
	1> blink from obj:c.o, build.o to build library lib:lc.lib,
                 lib:amiga.lib
	1> lc -cw sample.c
	1> blink from obj:c.o, sample.o to sample library lib:lc.lib,
                 lib:amiga.lib, lib:mbase.lib

   For reference, "lc -cw" is the equivalent of a simple "cc" command--
the "-cw" simply supresses Lattice C's tendency to make useless warnings
about main().  "blink" is the quivalent of "ld"--the linker.

                           -- ALL SYSTEMS --

   It is now hoped that the following files have now been created:
      libmb.a || mbase.lib
      build
      sample
   And the following files of interest still exist:
      mbase.dox
      sample.s

   At this point, it is _strongly_ urged that the user take the time to
read ye olde database documentation.  So strongly in fact that the aid of
one Mr. Guido has been enlisted.  Do read the documentation now... the user
will find it under the title "mbase.dox" .

   Having read the vital points of ye olde database documentation, let us
play with our newly-acquired toys.  To begin, we will need a relation to play
with... luckily, the schema for one has been included for you, the user.  Look
at the file "sample.s" to understand its content, then typest-thou the
following:
         % build sample
   Build attaches ".s" to the end of the file if necessary, and creates the
relation described in ye olde schema file "sample.s".  This file contains the
definition for a relation titled "sample"... thus, build creates "sample.rel"--
a relation with no entries as yet.

   Edit the file sample.rel if you like -- it will prove rather boring.
However, let us add a few records to this relation... type "sample".  The
file "sample", being recently-compiled C code, will execute, adding records
to the relation "sample.rel" and querying it.  Examinest-thou this code
carefully, for therein wilt thou find the key to the use of MetalBase... there
is nothing complicated about it.

   Now, shouldst thou be so inclined, edit-thou the file sample.rel, trying
to see how it is that "sample" can find meaningful text therein.


   Thus spake Richid the Conqueror.

___________________________________________________________________________
                         ___
            ___           | HE MAN WITH THE HAMMER
         .-','                                        /\
        /  (_______.------------------.       Richid <  > Huan-Ti
       (    _______|                  |               \/
        )  (       `------------------'       rpj@owlnet.rice.edu
       '----`

