home *** CD-ROM | disk | FTP | other *** search
/ Software 2000 / Software 2000 Volume 1 (Disc 1 of 2).iso / utilities / u021.dms / u021.adf / SmallAlarm / SmallAlarm.DOC < prev    next >
Encoding:
Text File  |  1990-07-04  |  6.0 KB  |  130 lines
  1.  
  2.                                SMALLalarm
  3.  
  4.         Copyright (c) 1989 - David S. Egan  - All Rights Reserved
  5.  
  6.  
  7.         SMALLalarm was written to fullfill a need that I felt lacking
  8.     with the CLOCK program supplied by Commodore-Amiga on the
  9.     Workbench disk.  I needed an alarm that could accomodate several
  10.     different "times" as well as using the minimum amount of RAM (us
  11.     A1000 512k owners are stingy that way!).  This program will occupy
  12.     approximately 25k of memory (54k when a requester is open).  I
  13.     also wrote this program to learn how to send a message to an
  14.     already running program.  I've made this software as easy to use
  15.     as I could, as well as observing the Amiga Operating System rules.
  16.     If you encounter a problem with this software, please try to
  17.     notify me so that I can fix the problem(s).  See the end of this
  18.     document for ways to reach me.
  19.  
  20.         I am releasing this program, SMALLalarm, as Public Domain
  21.     software but still retain all the rights to the program.  In other
  22.     words, don't use my program except as I intended it:  for a person
  23.     to use as a stand alone alarm on their Amiga.  It may be freely
  24.     distributed, providing that this file is included with it.  If you
  25.     find some use for this software in another product or piece of
  26.     software, get in touch with me.
  27.  
  28.     USAGE:   (SMALLalarm will track a maximum of five (5) alarms)
  29.  
  30.         WORKBENCH:
  31.  
  32.           Click on SMALLalarm ICON.
  33.               A requester opens up, allowing you to enter the time and
  34.               text that you desire.  When things look the way you want
  35.               them, click on the "OK" gadget and I'll take care of the
  36.               rest.  If you decide that you aren't interested in a new
  37.               alarm after all, click on the "CANCEL" gadget, and the
  38.               program will go away.
  39.  
  40.               Please note that these are standard AMIGA Intuition
  41.               gadgets, so they behave as you are probably used to. To
  42.               clear the text in a gadget press Right-Amiga-X; also the
  43.               text gadget scrolls.
  44.  
  45.  
  46.         CLI:
  47.  
  48.           RUN SMALLalarm [+]hh:mm  [text]
  49.                          (brackets signify optional parameters.  They
  50.                           are not part of the actual parameter(s)).
  51.  
  52.               where:  +       is optional
  53.                                 signifies a time of plus hh:mm hours
  54.                                 from now.  Note that if you use the +,
  55.                                 I will let you specify almost any
  56.                                 mm, so be careful here or your
  57.                                 timer won't go off for quite some
  58.                                 time!
  59.  
  60.                       hh:mm   is MANDATORY
  61.                                 This is the time that you want the
  62.                                 alarm to go off.  Note that this is
  63.                                 in 24 hour clock nomenclature.  For
  64.                                 example, if you want the alarm to go
  65.                                 off at 11:15 PM, use 23:15.  If you
  66.                                 wanted an alarm at 9:18 AM, use 9:18.
  67.                                 If you enter a time with out the
  68.                                 colon (:), I treat it as minutes and
  69.                                 let you have anything here, so
  70.                                 again, be careful.  If you enter
  71.                                 something that I don't like, I'll tell
  72.                                 you!
  73.  
  74.                       text    is optional
  75.                                 This is upto 40 characters of text
  76.                                 that you want the alarm to remind you
  77.                                 of.  If you have spaces in the text,
  78.                                 surround the whole string with double
  79.                                 quotes "just like this".
  80.  
  81.     *  Note:  The use of the CLI command RUN is necessary for the
  82.               first invocation of the program.  If you forget the RUN,
  83.               the CLI that started the program will wait until
  84.               SMALLalarm finishes.  If SMALLalarm is already running,
  85.               you can request another alarm, without the use of the
  86.               RUN command.  This functions the same way as POPCLI.  I
  87.               send a message to the already running SMALLalarm about
  88.               your new alarm request, and then the second invocation
  89.               of the program exits, freeing the CLI. To be safe,
  90.               always use the RUN command prepended to SMALLalarm (RUN
  91.               SMALLalarm)!
  92.  
  93.               Also note that if you start SMALLalarm without any
  94.               parameters, I'll open the requester for you to enter
  95.               your time and text.  In that case, see the WORKBENCH
  96.               instructions!
  97.  
  98.     Finally-  The WORKBENCH screen is forced to the front when your
  99.               alarm goes off.  A system Requester pops up with your
  100.               alarm text in it.  I figured that this would really get
  101.               your attention, especially if you are involved in
  102.               something else that has opened another screen. To kill
  103.               the Requester, click on the "OK" gadgets, or use
  104.               Left-Amiga B or V (See AmigaDOS 1.2 enhancer manual,
  105.               page 3).  If you want to get back to what you were
  106.               doing, click on the Screen-To-Back gadget in the upper
  107.               corner until your application re-appears!
  108.  
  109.  
  110. How to find me.
  111.  
  112.               GEnie:        EMAIL D.EGAN
  113.               Amiga-INN:    (714)272-5881 Steve Taylor - SYSOP
  114.                             (Truly a fine BBS - So. Calif area).
  115.  
  116.  
  117.         Again, if you find something deadly wrong with this, let me
  118.         know.  I'd really hate to cause anybody grief with this
  119.         program.  I tested it as well as I could!  If you have any
  120.         comments about this program, please feel free to contact me.
  121.  
  122.         If you have any ideas for software that YOU would like to
  123.         have/see, let me know at the above methods.  I might be
  124.         interested too!
  125.  
  126. Thanks,
  127.    Dave Egan  B-)
  128.  
  129.  
  130.