This file provides installation instructions for the `local' version of:
* Lovelace, an Ada 95 tutor
* mklesson, a tutor generator

1. LEGAL NOTES

The Lovelace Ada tutorial & mklesson (tutorial generator)
are covered by the GNU General Public License and/or
Library General Public License; see the file legal.html
for more information. Unless otherwise noted, this material is
Copyright (C) 1994-1995 David A. Wheeler.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
    GNU General Public License for more details.

This tutorial is not an endorsement.
This tutorial was developed on my own time (off-hours).
I do work at the Institute for Defense Analyses (IDA), but
this tutorial does not represent any kind of endorsement by IDA,
the Ada Joint Program Office (AJPO),
the U.S. Department of Defense (DoD), or the U.S. Government.

2. WHERE TO FIND CURRENT VERSIONS

These files are distributed on the World Wide Web,
with the current home page URL of:
 http://lglwww.epfl.ch/Ada/Tutorials/Lovelace/lovelace.html
Use a World Wide Web browser and go to that URL to see
the latest version of Lovelace.


3. INSTALLATION INSTRUCTIONS

You should have received a compressed file containing the Lovelace files.

The file may be in one of several different compressed formats.

If this file is stored in `tar plus gzip' format (a common Unix format),
it will probably have a filename like lovelace.tar.gz
(or a related filename; MS-DOS systems will have shorter
filenames like lovelace.gz).
`tar' is a format that allows multiple files to be stored in a single file.
`gzip' is a compression format supported by the FSF GNU `gzip' and `gunzip'
programs; it is NOT the same format as the MS-DOS `zip' format.

If the file is stored in `zip' format (a common PC format), it
will have a filename like `lovelace.zip'.

A. Create a new subdirectory called "lovelace", and move into that subdirectory.
   In Unix and MS-DOS systems, this can be done at the command
   line by executing:

   mkdir lovelace
   cd lovelace

B. Move LOVELACE.gz.tar (or whatever it's called) into this directory.
   In Unix, this is done with the "mv" command. In MS-DOS, this
   can be done using the "copy" command.

C. Uncompress the file.

   For the tar+gzip file, on Unix and MS-DOS systems, do:
     gunzip lovelace.tar.gz
     tar xvf lovelace.tar
   Some MS-DOS machines don't have these programs already; consult
   your "local expert" on how to get programs to uncompress and untar
   these files.

   For the zip file, on MS-DOS systems, do:
      unzip lovelace.zip
   (or whatever your unzipping program name is, such as
    pkunzip or dezip).

   On Macintoshes, use programs such as stuffit or suntar.
   Again, if you don't have programs to uncompress and untar, consult
   your "local expert".

D. On multiuser systems you _may_ need to reset file access permissions.
   For Unix systems, do:
   chmod a=r *

E. Read the file "readme", which points out the key files here.
   On Unix and MS-DOS machines, this can be done using:
   more < readme

F. If you don't already have a "web browser" such as Mosaic, Netscape, Lynx,
   Cello, etc., install one.  You do NOT need internet access to use
   Lovelace this way, though Internet access will increase your
   capabilities.

G. Start up your favorite web browser (Mosaic, netscape, etc).
   Open the file "local.html" (for MS-DOS based machines, open
   the file "local.htm"); that should start you off!
   If you don't want the notes about this being a local version,
   you can use the normal home page "lovelace.html"
   (again, for MS-DOS machines, it will be called "lovelace.htm").

H. Create a WWW pointer to the home page, "local.html"
   from wherever you want.

I. When everything seems to work correctly, remove the tar or zip file.
   In Unix systems, this is done with:
     rm lovelace.tar
   In MS-DOS systems, this is done with:
     delete lovelace.tar
     -or-
     delete lovelace.zip


4. IF YOU'RE CRAMPED FOR DISK SPACE

If all you want to do is run the Lovelace tutorial and you're
cramped for disk space, delete the following files:

  *.les        (lesson source)
  *.tim        (timestamps)
  makefile
  mklesson
  template
  default
  userg.html




Enjoy!

--- David A. Wheeler
    wheeler@ida.org