home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 300-399 / ff342.lzh / SKsh / Install.doc < prev    next >
Text File  |  1990-04-15  |  6KB  |  265 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.4
  23.  
  24.  
  25.                                (Copyright) 1989, 1990
  26.  
  27.                                      Steve Koren
  28.  
  29.                                    March 19, 1990
  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  at
  81.             any time.
  82.  
  83.  
  84.                1)   First, copy the .skshinit  and  .skshrc  files  to  the
  85.                     's:' directory.  SKsh needs these two  files  to  start
  86.                     correctly.  Their location can be changed  by  changing
  87.                     the SKSH: device (see below).
  88.  
  89.  
  90.                2)   Edit your startup-sequence and insert:
  91.  
  92.                          assign SKSH: s:
  93.  
  94.                     This controls the location in which SKsh looks for  the
  95.                     startup files.
  96.  
  97.  
  98.                3)   Copy the sksh binary  itself  to  a  location  in  your
  99.                     AmigaDos search path.  You can be fairly sure the  'c:'
  100.                     directory  is  in  your  search  path.   If  you   have
  101.                     modified  your  path,  there  may  be  other  potential
  102.                     locations as well.
  103.  
  104.  
  105.                4)   Set the pure bit on the SKsh binary:
  106.  
  107.                          protect c:sksh rep
  108.  
  109.  
  110.                5)   Make sure that 't:' points to a  fast  device  suitable
  111.                     for storing temporary files.  A sub-directory on a  ram
  112.                     disk is best.  For example,
  113.  
  114.                          makedir ram:tmp
  115.                          assign t: ram:tmp
  116.  
  117.                     You will probably want to  insert  some  commands  like
  118.                     these into  your  startup-sequence,  if  they  are  not
  119.                     already there.  SKsh uses  temporary  files  only  when
  120.                     absolutely necessary, but some types of  SKsh  commands
  121.                     will not function properly without  them  (see  command
  122.                     subtitution, for example).
  123.  
  124.  
  125.                6)   SKsh needs a stack size of  at  least  10000  bytes  in
  126.                     order to run properly.  You can manually set the  stack
  127.  
  128.  
  129.           SKsh Amiga Shell             Page 2           Installation Guide
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.                     size to 10000 bytes using  the  AmigaDos  stack command
  140.                     before you run SKsh, or you can  insert  'stack  10000'
  141.                     into your startup sequence (recommended).   If  you  do
  142.                     not have sufficient stack space, SKsh *will* crash.
  143.  
  144.  
  145.                7)   The following files need to be  copied  to  a  location
  146.                     which  is  in  your  SKsh  search  path  (although  not
  147.                     necessarily in your AmigaDos search path):
  148.  
  149.                          cmp
  150.                          cp
  151.                          crc
  152.                          du
  153.                          fgrep
  154.                          grep
  155.                          head
  156.                          join
  157.                          srun
  158.                          strings
  159.                          tail
  160.                          tee
  161.                          view
  162.                          wc
  163.                          window
  164.                          xd
  165.  
  166.                     You can  create  a  directory  called  "sys:bin"  which
  167.                     contains these commands.   The  supplied  .skshrc  file
  168.                     automatically adds this directory to the search path. 
  169.  
  170.  
  171.                8)   This step is optional, but  recommended.   The  default
  172.                     name for the ram disk is "RAM DISK:".  The  space  will
  173.                     make some things difficult to do (but  not  impossible)
  174.                     in SKsh.  I recommend that you change the default  name
  175.                     of the ram disk in your startup-sequence  to  something
  176.                     like the following:
  177.  
  178.                          relabel ram: RAM_DISK
  179.  
  180.                     The  only  difference  is  that  the  space  has   been
  181.                     replaced by an underscore, and it will make  your  life
  182.                     much easier.
  183.  
  184.  
  185.                9)   Insure  that  your  AmigaDos  ENV:  device  is  set  up
  186.                     properly.  If you are not sure how to do this, see  the
  187.                     AmigaDos manual.
  188.  
  189.  
  190.                10)  Lastly, you must have  arp.library  installed  in  your
  191.                     system in the LIBS: directory.  If  you  are  not  sure
  192.                     how to do this, see  the  arp  documentation.   arp  is
  193.  
  194.  
  195.           SKsh Amiga Shell             Page 3           Installation Guide
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.                     available on most Amiga BBS systems.   It  is  best  to
  206.                     use the most recent available arp.library,  since  SKsh
  207.                     will not run correctly with some early versions.
  208.  
  209.                11)  The pure bit on the following  SKsh  external  commands
  210.                     should be set:
  211.  
  212.                          cmp
  213.                          cp
  214.                          du
  215.                          head
  216.                          srun
  217.                          strings
  218.                          view
  219.                          wc
  220.                          window
  221.                          xd
  222.  
  223.                     This can be accomplished with  either  the  SKsh  chmod
  224.                     command or the AmigaDos protect command.
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.           SKsh Amiga Shell             Page 4           Installation Guide
  262.  
  263.  
  264.  
  265.