home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 336.lha / Ash / MiscInfo.doc < prev    next >
Encoding:
Text File  |  1989-12-27  |  5.5 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.                                          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.           Reporting Bugs
  74.  
  75.             Bug reports (as well as other inquiries) may  be  sent  to  the
  76.             following US Mail address:
  77.  
  78.                Steve Koren
  79.                4501 Boardwalk Dr.
  80.                Apt D-38
  81.                Fort Collins, CO 80525
  82.  
  83.             Or reported by phone:
  84.  
  85.                (303) 226-4985
  86.  
  87.             You can also use the following email address,  which  tends  to
  88.             change less often than the US mail address:
  89.  
  90.                koren@hpfela.HP.COM
  91.  
  92.             In any case, please  read  the  rest  of  this  section  before
  93.             reporting bugs.   Also,  please  understand  that  I  can  only
  94.             answer inquiries of any sort during my free (non-work) time.
  95.  
  96.             First of all, try to be sure that what  you  are  reporting  is
  97.             really a bug and not just  a  misunderstanding  on  your  part.
  98.             For example, perhaps you cannot get local  variables  to  work.
  99.             It turns  out  that  there  are  ways  in  Ash  to  turn  local
  100.             variables off  entirely  or  change  their  behavior  from  the
  101.             default.  If you are not aware  of  this,  you  might  have  an
  102.             option set that you mistake for improper behavior.   In  short,
  103.             read all the documentation  first,  even  if  you  already  are
  104.             familiar with Unix shells.  Ash is  not  sh or ksh.  Also, make
  105.             sure you have enough memory, stack space, etc, and verify  that
  106.             you have correctly performed all the steps in the  installation
  107.             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  Ash.
  111.             This should include the distribution version  of  the  .ashinit
  112.             and .ashrc files,  as  well  as  an  original,  unmodified  Ash
  113.             binary.  Then, if possible, generate a  small  test  script  or
  114.             function that  you  believe  is  correct,  but  which  produces
  115.             improper results.  Send it to me by one of the  above  methods.
  116.             I will then examine it, determine if it is really  a  bug,  and
  117.             if so, how, when and if I might  fix  it.   Except  in  unusual
  118.             circumstances, I will probably not distribute bug  fixes  on  a
  119.             case by case basis.  Rather,  I  will  accumulate  several  and
  120.             distribute a new version of Ash.
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.           ASH Amiga Shell               Page 2           Misc. Information
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.           Obtaining the Latest Ash
  140.  
  141.             I distribute Ash in several  ways.   I  will  send  it  to  the
  142.             moderator of comp.binaries.amiga for posting  there.   This  is
  143.             probably the best and fastest way to obtain  new  versions.   I
  144.             will probably send a copy off to Fred Fish, although  I  assume
  145.             there will be a delay before  it  appears  in  his  collection.
  146.             Also, I will  send  Ash  to  several  BBS  systems  around  the
  147.             country, from which it tends to propagate.
  148.  
  149.             If you wish to know the latest version of Ash, you may  contact
  150.             me.  However, except under unusual circumstances I will  simply
  151.             tell you how to get the  latest  version  instead  of  actually
  152.             sending it to you directly (unless perhaps you send me a  self-
  153.             addressed stamped mailer and a disk).
  154.  
  155.             If you do contact me  by  US  Mail  (I  prefer  email),  please
  156.             include a  self-addressed  stamped  envelope  or  postcard.   I
  157.             reply to *all* inquiries,  but  my  last  large  Amiga  project
  158.             (QRT) generated several hundred US  Mail  inquiries  (and  even
  159.             more email inquiries).  It is much more convenient  for  me  if
  160.             you include a self-addressed envelope.  Thanks!
  161.  
  162.             Also, QRT generated countless requests for  IBM  versions,  Mac
  163.             versions, etc.  QRT did run on  those  systems,  but  Ash  does
  164.             not.  Ash is written with machine  independence  in  mind,  and
  165.             the port should not be difficult,  but  I  personally  have  no
  166.             interest in PC or Mac versions, so I  will  not  be  doing  any
  167.             ports.  If Ash is ported to other systems, please  contact  the
  168.             author of the port for information.  As of Ash 1.0, I have  not
  169.             released source code.  I may for future versions, when  I  have
  170.             a chance to better comment the source.
  171.  
  172.  
  173.           Where to go for Help
  174.  
  175.             If you do not understand something about Ash, the  first  place
  176.             to go is of course the manual.  If you still cannot  figure  it
  177.             out, you  might  try  asking  a  knowledgeable  sh or ksh user.
  178.             Even though Ash is not identical to those shells, it  is  close
  179.             enough that someone familiar  with  ksh could probably read and
  180.             understand an Ash script easily.
  181.  
  182.             If all else fails, you can contact  me  by  one  of  the  above
  183.             methods.  I can probably help :-).
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.           ASH Amiga Shell               Page 3           Misc. Information
  196.  
  197.  
  198.  
  199.