home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / utility / cli / sksh017.lzh / doc / MiscInfo.doc < prev    next >
Encoding:
Text File  |  1991-05-04  |  5.0 KB  |  199 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                  Misc. Information (bug reports, etc)
  17.  
  18.                                  SKsh
  19.  
  20.                     A ksh-like Shell for the Amiga
  21.  
  22.                               Version 1.7
  23.  
  24.  
  25.                          (Copyright) 1988-1991
  26.  
  27.                               Steve Koren
  28.  
  29.                               May 4, 1991
  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.        Reporting Bugs
  74.  
  75.      Bug  reports (as well  as  other  inquiries) may be sent to the
  76.      following  US  Mail  address (which has changed  after  version
  77.      1.5):
  78.  
  79.         Steve Koren
  80.         405 Pulsar St.
  81.         Fort Collins, CO 80525
  82.         USA
  83.  
  84.      Or reported by phone:
  85.  
  86.         (303) 226-4985
  87.  
  88.      You can also  use  the  following email address, which tends to
  89.      change less often than the US mail address:
  90.  
  91.         koren@hpmoria.HP.COM
  92.  
  93.      In any case, please read the rest  of  this  section before re-
  94.      porting bugs.  Also,  please  understand that I can only answer
  95.      inquiries of any sort during my free (non-work) time.
  96.  
  97.      First of all, try to be sure that  what  you  are  reporting is
  98.      really a bug  and  not  just  a  misunderstanding on your part.
  99.      For  example,  perhaps you  cannot get local variables to work.
  100.      It turns out that there are ways in SKsh  to  turn  local vari-
  101.      ables  off  entirely or change their behavior from the default.
  102.      If you are not aware of this,  you  might  have  an  option set
  103.      that  you  mistake  for  improper behavior.  In short, read all
  104.      the  documentation first, even if you already are familiar with
  105.      Unix shells.  SKsh is not  sh or ksh.  Also, make sure you have
  106.      enough memory, stack space, etc, and verify that you have  cor-
  107.      rectly performed all the steps in the installation guide.
  108.  
  109.      If  you  suspect that your problem is really a bug, then do the
  110.      following.    Duplicate the bug  on  an  unmodified  version of
  111.      SKsh.   This  should   include the  distribution version of the
  112.      .skshinit  and  .skshrc  files,  as  well   as   an   original,
  113.      unmodified SKsh binary.   Then,  if  possible, generate a small
  114.      test script or  function that you believe is correct, but which
  115.      produces  improper results.  Send it to me by one of the  above
  116.      methods.  I will  then  examine it, determine if it is really a
  117.      bug, and if so, how, when and if I  might  fix  it.   Except in
  118.      unusual  circumstances,  I  will  probably  not  distribute bug
  119.      fixes on a case by case basis.  Rather, I will  accumulate sev-
  120.      eral and distribute a new version of SKsh.
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.        SKsh Amiga Shell             Page 2            Misc. Information
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.        Obtaining the Latest SKsh
  140.  
  141.      I  distribute SKsh in several ways.  I will send it to the mod-
  142.      erator of  comp.binaries.amiga  for  posting there.  I also en-
  143.      sure it is  uploaded to the ftp site at ab20.  This is probably
  144.      the best and  fastest way to obtain new versions.  I will prob-
  145.      ably send a copy  off  to  Fred  Fish,  although I assume there
  146.      will be  a  delay before it appears in his collection.  Also, I
  147.      will send SKsh to  several BBS systems around the country, from
  148.      which it tends to propagate.
  149.  
  150.      If you wish to  know  the  latest version of SKsh, you may con-
  151.      tact  me.    However, except under unusual circumstances I will
  152.      simply tell you how to get the  latest version instead of actu-
  153.      ally  sending it to you  directly (unless perhaps you send me a
  154.      self-addressed stamped mailer and a disk).
  155.  
  156.      If  you  do  contact me by US Mail (I prefer email), please in-
  157.      clude a self-addressed  stamped  envelope or postcard.  I reply
  158.      to *all*  inquiries, but my last large Amiga project (QRT) gen-
  159.      erated  several  hundred US Mail inquiries (and even more email
  160.      inquiries).  It is much  more  convenient for me if you include
  161.      a self-addressed envelope.  Thanks!
  162.  
  163.      Also,  QRT  generated  countless requests for IBM versions, Mac
  164.      versions, etc.  QRT did  run  on  those  systems, but SKsh does
  165.      not.   SKsh  is  written with machine independence in mind, and
  166.      the port should not be  difficult, but I personally have no in-
  167.      terest  in  PC  or  Mac  versions, so I will not  be  doing any
  168.      ports.  If SKsh is ported to other  systems, please contact the
  169.      author of the port for information.  As of  SKsh  1.7,  I  have
  170.      not  released source code.  I may  for  future versions, when I
  171.      have a chance to better comment the source.
  172.  
  173.  
  174.        Where to go for Help
  175.  
  176.      If you do not  understand something about SKsh, the first place
  177.      to go is of course the manual.  If you  still  cannot figure it
  178.      out,  you  might  try  asking  a  knowledgeable sh or ksh user.
  179.      Even though SKsh is not  identical to those shells, it is close
  180.      enough  that  someone familiar with ksh could probably read and
  181.      understand an SKsh script easily.
  182.  
  183.      If  all  else  fails,  you  can  contact me by one of the above
  184.      methods.  I can probably help :-).
  185.  
  186.      Finally,  I  wish  to  express my appreciation for those people
  187.      who have taken  the  time  to  make  comments, suggestions, and
  188.      point out bugs.  SKsh will be a better program as a result.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.        SKsh Amiga Shell             Page 3            Misc. Information
  196.  
  197.  
  198.  
  199.