home *** CD-ROM | disk | FTP | other *** search
/ Solo Programadores 22 / SOLO_22.iso / docs / lovelace / install.txt < prev    next >
Encoding:
Text File  |  1995-12-07  |  5.7 KB  |  163 lines
  1. This file provides installation instructions for the `local' version of:
  2. * Lovelace, an Ada 95 tutor
  3. * mklesson, a tutor generator
  4. * Small, a sample Ada 95 Object-Oriented program.
  5.  
  6. 1. LEGAL NOTES
  7.  
  8. The Lovelace Ada tutorial & mklesson (tutorial generator)
  9. are covered by the GNU General Public License and/or
  10. Library General Public License; see the file legal.htm
  11. for more information. Unless otherwise noted, this material is
  12. Copyright (C) 1994-1995 David A. Wheeler.
  13.  
  14.     This program is distributed in the hope that it will be useful,
  15.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  16.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  17.     GNU General Public License for more details.
  18.  
  19. Small is, in essence, public domain; see the legal notes for a
  20. more exact description of Small's legal status.
  21.  
  22. This tutorial is not an endorsement.
  23. This tutorial was developed on my own time (off-hours).
  24. I do work at the Institute for Defense Analyses (IDA), but
  25. this tutorial does not represent any kind of endorsement by IDA,
  26. the Ada Joint Program Office (AJPO),
  27. the U.S. Department of Defense (DoD), or the U.S. Government.
  28.  
  29. 2. WHERE TO FIND CURRENT VERSIONS
  30.  
  31. These files are distributed on the World Wide Web,
  32. with the current home page URL of:
  33.  http://lglwww.epfl.ch/Ada/Tutorials/Lovelace/lovelace.htm
  34. Use a World Wide Web browser and go to that URL to see
  35. the latest version of Lovelace.
  36.  
  37.  
  38. 3. INSTALLATION INSTRUCTIONS
  39.  
  40. You should have received a compressed file containing the Lovelace files.
  41.  
  42. The file may be in one of several different compressed formats.
  43.  
  44. If this file is stored in `tar plus gzip' format (a common Unix format),
  45. it will probably have a filename like lovelace.tar.gz
  46. (or a related filename; MS-DOS systems will have shorter
  47. filenames like lovelace.gz).
  48. `tar' is a format that allows multiple files to be stored in a single file.
  49. `gzip' is a compression format supported by the FSF GNU `gzip' and `gunzip'
  50. programs; it is NOT the same format as the MS-DOS `zip' format.
  51.  
  52. If the file is stored in `zip' format (a common PC format), it
  53. will have a filename like `lovelace.zip'.
  54.  
  55. A. Create a new subdirectory called "lovelace", and move into that subdirectory.
  56.    In Unix and MS-DOS systems, this can be done at the command
  57.    line by executing:
  58.  
  59.    mkdir lovelace
  60.    cd lovelace
  61.  
  62. B. Move LOVELACE.gz.tar (or whatever it's called) into this directory.
  63.    In Unix, this is done with the "mv" command. In MS-DOS, this
  64.    can be done using the "copy" command.
  65.  
  66. C. Uncompress the file.
  67.  
  68.    For the tar+gzip file, on Unix and MS-DOS systems, do:
  69.      gunzip lovelace.tar.gz
  70.      tar xvf lovelace.tar
  71.    Some MS-DOS machines don't have these programs already; consult
  72.    your "local expert" on how to get programs to uncompress and untar
  73.    these files.
  74.  
  75.    For the zip file, on MS-DOS systems, do:
  76.       unzip lovelace.zip
  77.    (or whatever your unzipping program name is, such as
  78.     pkunzip or dezip).
  79.  
  80.    On Macintoshes, use programs such as stuffit or suntar.
  81.    Again, if you don't have programs to uncompress and untar, consult
  82.    your "local expert".
  83.  
  84. D. On multiuser systems you _may_ need to reset file access permissions.
  85.    For Unix systems, do:
  86.    chmod a=r *
  87.  
  88. E. Read the file "readme", which points out the key files here.
  89.    On Unix and MS-DOS machines, this can be done using:
  90.    more < readme
  91.  
  92. F. If you don't already have a "web browser" such as Mosaic, Netscape, Lynx,
  93.    Cello, etc., install one.  You do NOT need Internet access to use
  94.    Lovelace this way, though Internet access will increase your
  95.    capabilities.  If you don't have Internet access, make sure your
  96.    web browser is configured so it will NOT attempt Internet access
  97.    and make sure that your "home page" is a local file (say, the
  98.    initial Lovelace file).
  99.  
  100.    For example, to set up Cello so you don't need an Internet connection,
  101.    edit the "CELLO.INI" file (in Cello's directory) to contain the following
  102.    settings:
  103.  
  104.         LocalOnly=Yes
  105.         HomePage=c:\lovelace\local.htm
  106.  
  107.    The "LocalOnly" line indicates that the web browser (Cello in this case)
  108.    should not attempt network connections, and the "Homepage" line
  109.    gives the filename that will be the first filename viewed (change
  110.    the C:\LOVELACE to wherever you've installed Lovelace).
  111.  
  112.    Other web browsers work similarly.
  113.  
  114. G. Start up your favorite web browser (Mosaic, Netscape, etc).
  115.    Open the file "local.htm" in whatever directory you installed Lovelace.
  116.    In most browsers this is simply a "File/Open File" command with the
  117.    filename "C:\lovelace\local.htm" for MS-DOS machines and
  118.    "local.htm" for other machines.  That should start you off!
  119.    If you don't want the notes about this being a local version,
  120.    you can use the normal home page "lovelace.htm" instead of "local.htm".
  121.  
  122.    Most browsers also permit you to provide a starting URL when you start
  123.    them up, and you can use that to move directly to starting up Lovelace.
  124.  
  125. H. When everything seems to work correctly, remove the tar or zip file.
  126.    In Unix systems, this is done with:
  127.      rm lovelace.tar
  128.    In MS-DOS systems, this is done with:
  129.      delete lovelace.tar
  130.      -or-
  131.      delete lovelace.zip
  132.  
  133.  
  134. 4. IF YOU'RE CRAMPED FOR DISK SPACE
  135.  
  136. If all you want to do is run the Lovelace tutorial and you're
  137. cramped for disk space, delete the following files:
  138.  
  139.   *.les        (lesson source)
  140.   *.tim        (timestamps)
  141.   makefile
  142.   mklesson
  143.   template
  144.   default
  145.   userg.htm
  146.  
  147. If you're not using the Ada source code, you can also delete them:
  148.   *.adb     (Ada bodies)
  149.   *.ads     (Ada specifications)
  150.  
  151. MS-DOS-derived systems should note that Lovelace is implemented as a
  152. large number of small text files, and in some sense this is a
  153. "worst case" for MS-DOS.  If you're really hurting for disk space,
  154. using a compressed drive will help space significantly.
  155.  
  156.  
  157.  
  158. Enjoy!
  159.  
  160. --- David A. Wheeler
  161.     wheeler@ida.org
  162.  
  163.