home *** CD-ROM | disk | FTP | other *** search
/ Amiga Computing 66 / ac066a.adf / ARoach.doc / ARoach.doc
Text File  |  1993-09-10  |  4KB  |  125 lines
  1.  
  2.                                 ARoach
  3.  
  4.                               Version 1.0
  5.  
  6.  
  7.        © Copyright Stefan Winterstein 1993. Freely Distributable.
  8.  
  9.  
  10.  
  11. NAME
  12.     ARoach - cockroaches hide under your windows
  13.  
  14.  
  15. SYNOPSIS
  16.     ARoach ROACHES/K/N,SPEED/K/N,SQUISH/S,SCREEN=PUBSCREEN/K,HELP/S
  17.  
  18.  
  19. DESCRIPTION
  20.     ARoach displays disgusting cockroaches on your screen.  These creepy
  21.     crawlies  scamper  around  until  they  find a window to hide under.
  22.     Whenever  you move or resize a window, the exposed orthopteras again
  23.     scamper for cover.
  24.  
  25.     ARoach  is  based  on  Xroach  for  X-Windows.  It requires at least
  26.     AmigaDOS Release 2.
  27.  
  28.     The  roaches live in a backdrop window behind all other windows.  So
  29.     if  your Workbench window is NOT a backdrop window and you don't see
  30.     any roaches, look behind it!
  31.  
  32.     To  quit the program, you can either close its window, break it with
  33.     CTRL-C or squish all roaches with the mouse (see option SQUISH).
  34.  
  35.  
  36. OPTIONS
  37.     All  options  can  be  given  either  as  Tooltypes  or command line
  38.     options.  Tooltypes are parsed _exactly_ like options given from the
  39.     shell.
  40.  
  41.     ROACHES=<n>
  42.         This is the number of the little critters.  Default is 10.
  43.  
  44.         Note:   The  BOB  routines  of  graphics.library  can use a fair
  45.         amount of stack with large numbers of objects.  So the number of
  46.         roaches  is  currently  limited  to  1000,  which  is OK for the
  47.         current (internal) stack size of 16000 Bytes.
  48.  
  49.     SPEED=<n>
  50.         Use  the  given speed for the insects instead of the default 20.
  51.         For example, in winter the speed should be set to 5.  In summer,
  52.         30 might be about right.
  53.  
  54.     SQUISH
  55.         Enables  roach  squishing.   Point and shoot with the left mouse
  56.         button.
  57.  
  58.     PUBSCREEN=<string>
  59.         Drop  the  roaches  on  the  given public screen.  Make sure the
  60.         screen is nearby, so you can hear the screams.
  61.  
  62.     HELP
  63.         Displays a short help text.
  64.  
  65.  
  66. EXAMPLE
  67.         ARoach ROACHES 5 SPEED=30 SQUISH PUBSCREEN="DOPUS.1"
  68.  
  69.     gives  birth  to  5  squishable  roaches  of speed 30, living on the
  70.     public screen of DirectoryOPUS.
  71.  
  72.  
  73. BUGS
  74.     As given by the ROACHES option. Default is 10.
  75.  
  76.     Under  AmigaOS  3.0,  there  is some garbage under a window when you
  77.     move  it  away.  This is a bug with graphics.library and interleaved
  78.     bitmaps, I suppose.
  79.  
  80.  
  81. REVISION HISTORY
  82.  
  83.     1.0 (24-Jun-93)
  84.         First public release.
  85.  
  86.  
  87. AUTHORS & COPYRIGHT
  88.     I  can be reached on internet as "winter@cs.uni-sb.de".  Suggestions
  89.     and comments on the program are welcome.
  90.  
  91.     My snail mail address is
  92.         Stefan Winterstein
  93.         Schwarzbachstr.7
  94.         66424 Homburg
  95.         Germany
  96.  
  97.     The   original   XRoach   is   copyright   1991  by  J.T.   Anderson
  98.     (jta@locus.com),  who  kindly  gave  me the permission for releasing
  99.     this port.
  100.  
  101.     ARoach  is  copyright  ©  1993  by  Stefan  Winterstein,  all rights
  102.     reserved.   This  program  is  not  in the public domain, but freely
  103.     distributable,  provided  it  is  not  modified  in  its  operation,
  104.     distributed   together   with   this   documentation  and  used  for
  105.     non-commercial purposes only.
  106.  
  107.     Though  it  was  tested  rather thoroughly, ARoach is made available
  108.     "as-is", without warranty of any kind.  Any damage caused by the use
  109.     of this program is the sole responsibility of the user.
  110.  
  111.     ARoach  uses  some  of  the `animtool' routines from the `ROM Kernel
  112.     Reference   Manual:    Libraries',   which  is  Copyright  (c)  1992
  113.     Commodore-Amiga, Inc.
  114.  
  115.  
  116. ACKNOWLEDGEMENTS
  117.     Many thanks to J.T. Anderson  for his hilarious Xroach.  ARoach uses
  118.     the  original  Bitmaps,  data  structures and many of its functions.
  119.     This documentation contains parts of the Xroach man-page.
  120.  
  121.  
  122. SEE ALSO
  123.      roachmotel (Fish 807)
  124.  
  125.