home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 200-299 / ff279.lzh / Ash / Install.doc < prev    next >
Text File  |  1989-11-20  |  4KB  |  199 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                Installation Guide to 
  17.  
  18.                                          ASH
  19.  
  20.                            A ksh-like Shell for the Amiga
  21.  
  22.                                      Version 1.0
  23.  
  24.  
  25.                                   (Copyright) 1989 
  26.  
  27.                                      Steve Koren
  28.  
  29.                                   November 7, 1989
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.           Installing Ash
  74.  
  75.             This section descibes  how  to  install  Ash.   It  is  vitally
  76.             important that all the steps be performed.  If  they  are  not,
  77.             Ash will not operate correctly.
  78.  
  79.                1)   First, copy the .ashinit and .ashrc files to  the  's:'
  80.                     directory.   Ash  needs  these  two  files   to   start
  81.                     correctly, and they must be in the 's:' directory.
  82.  
  83.                2)   Copy the ash  binary  itself  to  a  location  in  your
  84.                     AmigaDos search path.  You can be fairly sure the  'c:'
  85.                     directory  is  in  your  search  path.   If  you   have
  86.                     modified  your  path,  there  may  be  other  potential
  87.                     locations as well.
  88.  
  89.                3)   Make sure that 't:' points to a  fast  device  suitable
  90.                     for storing temporary files.  A sub-directory on a  ram
  91.                     disk is best.  For example,
  92.  
  93.                          makedir ram:tmp
  94.                          assign t: ram:tmp
  95.  
  96.                     You will probably want to  insert  some  commands  like
  97.                     these into  your  startup-sequence,  if  they  are  not
  98.                     already there.  Ash  uses  temporary  files  only  when
  99.                     absolutely necessary, but some types  of  Ash  commands
  100.                     will not function properly without  them  (see  command
  101.                     subtitution, for example).
  102.  
  103.                4)   Ash needs a stack size  of  at  least  15000  bytes  in
  104.                     order to run properly.  You can manually set the  stack
  105.                     size to 15000 bytes using  the  AmigaDos  stack command
  106.                     before you run Ash, or you  can  insert  'stack  15000'
  107.                     into your startup sequence (recommended).
  108.  
  109.                5)   The following files need to be  copied  to  a  location
  110.                     which  is  in  your  Ash  search  path  (although   not
  111.                     necessarily in your AmigaDos search path):
  112.  
  113.                          cmp
  114.                          head
  115.                          strings
  116.                          tail
  117.                          wc
  118.                          xd
  119.  
  120.                     You can  create  a  directory  called  "sys:bin"  which
  121.                     contains these  commands.   The  supplied  .ashrc  file
  122.                     automatically adds this directory to the search path. 
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.           ASH Amiga Shell               Page 2          Installation Guide
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.                6)   This step is optional, but  recommended.   The  default
  140.                     name for the ram disk is "RAM DISK:".  The  space  will
  141.                     make some things difficult to do (but  not  impossible)
  142.                     in Ash.  I recommend that you change the  default  name
  143.                     of the ram disk in your startup-sequence  to  something
  144.                     like the following:
  145.  
  146.                          relabel ram: RAM_DISK
  147.  
  148.                     The  only  difference  is  that  the  space  has   been
  149.                     replaced by an underscore, and it will make  your  life
  150.                     much easier.
  151.  
  152.                7)   Lastly, you must have  arp.library  installed  in  your
  153.                     system in the LIBS: directory.  If  you  are  not  sure
  154.                     how to do this, see  the  arp  documentation.   arp  is
  155.                     available on most Amiga BBS systems.
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.           ASH Amiga Shell               Page 3          Installation Guide
  196.  
  197.  
  198.  
  199.