home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Workbench / Misc / DCLK13.LHA / DClock13 / DClock.doc < prev    next >
Encoding:
Text File  |  1994-11-21  |  7.1 KB  |  215 lines
  1.     DCLock V1.3 - The ultimate, menu driven Workbench-Clock
  2.     =======================================================
  3.  
  4.  
  5.  
  6.     Introduction
  7.     ------------
  8.  
  9.     DClock is a digital clock program for the Amiga Workbench.
  10.     Features include:
  11.  
  12.     - DClock has it's own small window which can be placed
  13.       anywhere on the Workbench screen.
  14.  
  15.     - DClock  comes with a completely  menu-driven GUI. No
  16.       commandline options are necessary.
  17.  
  18.     - Timer and alarm clock function with the ability to
  19.       run user-defined Shell commands (including ARexx-
  20.       scripts if you use the RX command, and Shell-scripts
  21.       with the Execute command).
  22.  
  23.     - Fore- and  background colors of the window are user-
  24.       defineable.
  25.  
  26.     - All settings  can be saved and will automatically be
  27.       loaded upon startup. This  includes the  position of
  28.       the DClock window, the  colors, and  the settings of
  29.       the alarm clock.
  30.  
  31.  
  32.     Requirements and Installation
  33.     -----------------------------
  34.  
  35.     DClock makes use of the  reqtools.library, which is not part
  36.     of this distribution. It is  available  on Aminet or  on the
  37.     Amiga software library (fish) disks. Thanks to Nico Francois
  38.     for his great product.
  39.     You need Kickstart 2.04+ to be able to run DClock. If DClock
  40.     immediately  returns after startup, check  whether you  have
  41.  
  42.            Kickstart V37+
  43.            reqtools.library V38+
  44.            a public screen called 'Workbench'
  45.            enough free memory
  46.  
  47.  
  48.     Installation is very simple: Simply drag  the DClock icon to
  49.     the WBStartup drawer of your system partition/disk or to any
  50.     other drawer, if you don't want DClock to be started automa-
  51.     tically after booting.
  52.  
  53.  
  54.     DCLock Menus
  55.     ------------
  56.  
  57.     While the DClock window is active, you can select the follo-
  58.     wing menu items:
  59.  
  60.     DClock menu:
  61.  
  62.        Seconds (toggle) : Display seconds on/off
  63.  
  64.        Alarm on (toggle): Turn alarm function on/off
  65.  
  66.        Timer on (toggle): Turn timer function on/off
  67.  
  68.        Set alarm clock  : Set the alarm time
  69.  
  70.        Set timer        : Set the timer
  71.  
  72.        Alarm command    : Enter a Shell-command which will be
  73.                           executed when the alarm went off.
  74.                           RUN your command if if it takes longer
  75.                           and you don't want to block out the GUI.
  76.  
  77.        Timer command    : dito for the timer.
  78.  
  79.        Save Preferences : Save all the settings to
  80.                           ENVARC:DClock.prefs
  81.  
  82.        About...         : Information about DClock
  83.  
  84.        Quit             : Call the Terminator
  85.  
  86.     Window menu:
  87.  
  88.        Foreground Color : Set the foreground (text) color
  89.  
  90.        Background Color : Set the background color (who would
  91.                           have guessed...)
  92.  
  93.        Dragbar (toggle) : Turn the window dragbar and title on
  94.                           and off. The state of the checkmark
  95.                           will be saved in the preferences file.
  96.  
  97.  
  98.     When you select `Save Preferences'  from  the  Project menu, the
  99.     state  of the alarm  clock  will be saved, too. The  alarm  will
  100.     then be automatically turned on after startup (if it was on when
  101.     you saved  the prefs, off course). I e.g. set the  alarm to 1.00
  102.     AM, switched  it on and  selected `Save preferences'. I  now get
  103.     reminded every day that it's time to go to bed without having to
  104.     set the alarm again and again.
  105.  
  106.  
  107.     Legal section
  108.     -------------
  109.  
  110.     This program is Freely Distributable, as  opposed to Public
  111.     Domain.  Permission  is given  to  freely  distribute  this
  112.     program  provided  no  fee  is charged, and  this  documen-
  113.     tation  file  is included with the program. All  rights re-
  114.     served.
  115.  
  116.     (c) 1994 by Karl Lukas
  117.  
  118.  
  119.  
  120.     Info about the author
  121.     ---------------------
  122.  
  123.     Send bug reports, compliments and such to
  124.  
  125.        kalle@gis.geogr.unizh.ch
  126.  
  127.     Send postcards, money and other gifts to
  128.  
  129.        Karl Lukas
  130.        Konradstr. 51
  131.        CH-8005 Zuerich/Switzerland
  132.  
  133.     These addresses are valid until Feb. 1995. Send  snail mail
  134.     to
  135.  
  136.        Karl Lukas
  137.        Hinterzweienstr. 91
  138.        CH-4132 Muttenz
  139.  
  140.     after  this date. I don't  know whether  I'll have an email
  141.     account by then :(   (God, how can one live without?)
  142.  
  143.  
  144.     Send threatening letters, letter bombs a.s.o. to
  145.  
  146.        NIL:
  147.  
  148.  
  149.  
  150.     History
  151.     -------
  152.  
  153.     V1.0 Apr 1994 o Initial release
  154.  
  155.     V1.1 Jun 1994 o DClock now runs three independent tasks:
  156.                     - User interface  (DClock)
  157.                     - Updating of the DClock window, timer etc.
  158.                       (DClockTask)
  159.                     - display information when alarm went off or
  160.                       timer is finished (DClockInfo).
  161.                     Advantage: Clock and timer won't be stopped tem-
  162.                     porarily while a window/requester is open. You
  163.                     can get informed now when the timer/alarm went
  164.                     off while a window/requester is open.
  165.  
  166.                   o Bug: The alarm and timer symbols were drawn with
  167.                     incorrect offsets, so that the display got mes-
  168.                     sed if big screen fonts were used.
  169.  
  170.                   o The settings are now stored in ENVARC:DClock.prefs
  171.                     You can copy your old DClock.prefs file from S: to
  172.                     ENVARC: if you want to use your old settings.
  173.  
  174.     V1.2 Nov 1994 o You can now enter a Shell command, which will be
  175.                     executed when the alarm or the timer went off. The
  176.                     command can be saved to the preferences file. If you
  177.                     don't want to execute a command, just enter an empty
  178.                     string.
  179.  
  180.                   o The current time is now displayed with two digits
  181.                     in the alarm/timer requester (i.e. 18:08:12 instead
  182.                     of 18:8:12). Hey, there is an ANSI function for
  183.                     this. Why didn't anybody tell me?  ;)
  184.  
  185.                   o You can now turn the titlebar and dragbar off with
  186.                     the menu option "Dragbar". Off course you cannot move
  187.                     the window anymore when the dragbar is turned off.
  188.                     You can save the state of the "Dragbar" menu item to
  189.                     the preferences. THIS ONLY TAKES EFFECT WHEN YOU QUIT
  190.                     AND START DCLOCK AGAIN.
  191.  
  192.     V1.3 Nov 1994 o OK, the dragbar switching was not very elegant. Now
  193.                     you can turn the dragbar on and off without leaving
  194.                     the program.
  195.  
  196.                   o Got rid of the `Snapshot position' menu item. Now
  197.                     `Save preferences' saves the current position, too.
  198.  
  199.                   o I rearranged the menus to a somewhat more logical
  200.                     order.
  201.  
  202.                   o `Alarm command' and `Timer command' now use the
  203.                      SystemTagList() function. A console window is opened
  204.                      as stdin/stdout for the executed program, so you can
  205.                      actually _see_ it's output if you started DClock from
  206.                      the Workbench. Nice, isn't it?
  207.  
  208.  
  209.     Commercial "DClock - The t-shirt"
  210.     ---------------------------------
  211.  
  212.     Just kidding ;)
  213.  
  214.  
  215.