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