home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 3 / goldfish_volume_3.bin / files / dev / basic / ace / installation < prev    next >
Text File  |  1994-10-09  |  2KB  |  73 lines
  1.  
  2. Installation
  3. ------------
  4. You will need to open a shell to install ACE. Installation consists of:
  5.  
  6.     - Extracting the four archives found in the single supplied ACE 
  7.       archive.
  8.  
  9.     - Adding a few commands to your s:user-startup (Wb 2.x/3.x) or 
  10.       s:startup-sequence (Wb 1.3) file.
  11.  
  12. The distribution archive contains:
  13.  
  14.     - MAIN.lha        (main ACE files with a few examples)
  15.     - DOCS.lha        (documentation for ACE,A68K and Blink)
  16.     - PRGS.lha        (more example programs)
  17.     - AIDE.lha        (a graphical front-end for ACE)
  18.  
  19. All four will fit onto a single floppy disk in their compressed form.
  20.  
  21. So, extract these four archives into RAM:, into a temporary hard disk 
  22. directory or onto an empty floppy disk with:
  23.   
  24.     lha x <ACE-archive>        
  25. eg.
  26.     lha x ACE23
  27.  
  28. You must now extract the files from each archive with:
  29.  
  30.     lha -a x <archive>
  31. eg.
  32.     lha -a x MAIN
  33.  
  34. The "-a" switch preserves file attributes (eg. the "s" bit on shell scripts) 
  35. in the archive.
  36.  
  37. If you have a hard disk, just extract all four archives into a directory
  38. created for ACE (eg: sys:ACE). Extract MAIN.lha first. This will set up the 
  39. directory structure and main ACE files.
  40.  
  41. The extraction of MAIN.lha also creates three subdirectories for the last 
  42. three archives. Extract DOCS.lha, PRGS.lha and AIDE.lha into the docs, prgs 
  43. and AIDE subdirectories.
  44.  
  45. If you are using a floppy-only system, extract MAIN.lha onto one disk and 
  46. the last three archives onto other disks to suit yourself. The disk on which 
  47. the main ACE files reside is the volume to which the shell commands discussed 
  48. below refer.
  49.  
  50. Next, add the following lines to your user-startup or startup-sequence 
  51. script:
  52.  
  53.     assign ACE: <volume or directory>
  54.     path ACE:bin add
  55.  
  56. where <volume or directory> is the name of the disk or directory where
  57. the main ACE files now reside (eg: assign ACE: sys:ACE).
  58.  
  59. In addition, you need to add three more statements to your startup-sequence
  60. or user-startup script:
  61.  
  62.     assign ACElib:       ACE:lib    ; bas finds scanned libraries here.
  63.     assign ACEbmaps:   ACE:bmaps    ; ace looks here for .bmap files.
  64.     assign ACEinclude: ACE:include    ; app uses this for include files.
  65.  
  66. Now reboot your Amiga to let the above path and assign commands take effect.
  67.  
  68. That's it!
  69.  
  70. ** Note: As an alternative to these startup script modifications, you can 
  71. use the "ACEsetup" script to be found in MAIN.lha. Read the comments at 
  72. the top of that script for usage details.
  73.