home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 200-299 / ff298.lzh / DClock / DClock.doc < prev    next >
Text File  |  1989-12-29  |  7KB  |  138 lines
  1.                      _                              _
  2.                     //      - DClock v1.5 -        //
  3.                  _ //  * A Dumb Clock Utility * _ //
  4.                  \X/                            \X/
  5.                              BACKGROUND:
  6.                              -----------
  7. Who  cares  for  clock  utilities,  really,  who does?  Well, I do.  I
  8. needed  one,  but  couldn't  find  anything  suitable.   The  standard
  9. Workbench   clock   was  a  bit  too  big,  Mclk  slowed  down  system
  10. performance,  TUC  had  far  too  many  features (including occasional
  11. disk-thrashing),  RSLClock  was  too  large,  so was MachII and DMouse
  12. intentionally didn't have any clock display.  So, what was I up to do?
  13. Right,  I  programmed  my  very  special  creation,  short,  sweet and
  14. functional.
  15.  
  16.                               FEATURES:
  17.                               ---------
  18. Since  I  have already cooked out my custom version of DMouse I didn't
  19. need any additional Mouse accelerator, so this one didn't get into it.
  20. What  I  needed  were  Date (including weekday) and Time.
  21.     The  most important question was:  where to place the display?
  22. Since  I  have  already  tested Mouse pointer clocks and my home brewn
  23. MouseClock  program  which  features two sprites hovering at the right
  24. hand  side  of the Mouse pointer, the answer could only be:  put it on
  25. the Workbench screen.
  26.     Remembering   my  experiences  with  ReadySoft's  A-Max  Apple
  27. MacIntosh  Emulator  the  time display found its way to the right hand
  28. side  of  the  Workbench  title  bar.  The time string is updated each
  29. second.
  30.     DClock  needs arp.library v39.1 (DClock-Handler doesn't).  And
  31. as  far  as  I  am concerned, a memory usage bar can be quite a useful
  32. thing.   Pressing  RIGHT-AMIGA+HELP  draws some memory statistics into
  33. the  DClock  window  (this  nasty feature sneaked in in version 1.3, I
  34. can't be blamed for any consequences).
  35.     Mclk  uses  about  10%  of  CPU  time and about 16000 bytes of
  36. memory  (that's  almost  as  much  as  the  standard  Workbench  clock
  37. consumes),  MachII  uses  4% of CPU time and 32000 bytes.  DClock only
  38. consumes  between  1% and 3% of CPU time and requires only 10000 bytes
  39. of  memory  (well,  became some more during the last revisions, didn't
  40. want  to  change  the text, looks so impressive) - note that this also
  41. includes  the keyboard click, the display beep, the memory display and
  42. the time string to be updated each second.
  43.  
  44.                             INSTALLATION:
  45.                             -------------
  46. Place  DClock-Handler  in  L:,  DClock  in C:  or SYS:, arp.library in
  47. LIBS:, type DClock to install, DClock quit to remove.  Easy, isn't it?
  48. I  do  not  advise  you to start DClock from Workbench, but if I can't
  49. keep  you  from  doing so, it's you who's responsible for all negative
  50. side effects (if there are any...  are there?).
  51.  
  52.                                EXTRAS:
  53.                                -------
  54. DClock  still  isn't  a  pure  Clock Utility.  I was used to install a
  55. program  called  DisplayBeep  in  my  Startup-Sequence  script.   This
  56. program  spawns  a  process  which replaces the DisplayBeep() function
  57. with a substitute which does not only flash the display but also beeps
  58. audibly.   To  save  some  memory  the  code of DisplayBeep.c has been
  59. incorporated  into  DClock-Handler.c.  I also added the Click.c code I
  60. had  written back in October.  Somebody asked me to add an alarm-clock
  61. function.  Well, took me two hours to program it.
  62.  
  63.                                CREDITS:
  64.                                --------
  65. Credits  go  to ARP Programmers for the most recent version of ARP, to
  66. Matt  Dillon  for  DMouse,  to  Mike  Oldfield  & Peter Norman for the
  67. keyboard  click,  to  John  Hodgson  for  the  beep  and  to Justin V.
  68. McCormick for the string formatting code.
  69.     A  special mention must also go to Bill Hawes, author of ARexx
  70. and  to  the  authors  of  CygnusEd Professional (Bruce Dawson & Steve
  71. LaRocque?) whose programs both controlled the compiler runs.
  72.  
  73.                    COPY FEE, AUTHORS REQUEST, ETC.:
  74.                    --------------------------------
  75. If you like DClock program and wish to contribute any money I urge you
  76. to send at least 5$ to...
  77.  
  78.                           Amnesty International
  79.                           P.O. Box 37137
  80.                           Washington D.C. 20013
  81.  
  82. I  suppose Amnesty International can make better use of the money than
  83. I can.  Even the smallest contribution makes sense.
  84.  
  85. I  don't  care  what  happens to DClock and DClock-Handler, copy them,
  86. sell them, delete them, they are meant to be PUBLIC-DOMAIN.  But don't
  87. 'fleece'  other  users  for  them.   Permission  to  redistribute  the
  88. documentation, the source code and executable files granted as long as
  89. the body of this document is left intact.
  90.  
  91.                                   -
  92.  
  93. I  have  tried to make DClock as flexible as possible.  The rendezvous
  94. data  is  easily  to  be  extended.   I  encourage you to add whatever
  95. feature  you  want.   I  only ask you to send me a copy of your custom
  96. version of DClock.  The future of this tool depends on you, spread the
  97. word and also the disk! My address is:
  98.  
  99.                      Olaf Barthel
  100.                      Brabeckstrasse 35
  101.                      D-3000 Hannover 71
  102.  
  103.                      Federal Republic of Germany
  104.  
  105.  
  106.              REVISION HISTORY (most recent change first):
  107.              --------------------------------------------
  108. V1.5    Added a most unnerving alarm clock function: the display
  109.     vibrates, a bell is ringing ... what can it be? Probably
  110.     DClock trying to wake you up.
  111.  
  112. V1.4    Fixed bug in time signal routine (didn't update if seconds
  113.     were reset to a point of time already passed), added status
  114.     line information, corrected exit() calls in DClock.
  115.  
  116. V1.3    Played around with a taller custom font (saw Kickstart 1.4
  117.     alpha 15 and noticed that the Workbench status line became
  118.     longer overrriding the DClock display). The font didn't get
  119.     into it. Added a numeric memory display.
  120.  
  121. V1.2    Thought of incorporating the code of Click and DisplayBeep
  122.     into DClock and added them. Also stumbled upon my old
  123.     MemGauge program and added a memory gauge display.
  124.  
  125. V1.1    Added ARP interface, replaced standard DOS calls with ARP
  126.     calls, removed the clock display from the barlayer (always
  127.     crashed after a call to CloseWorkBench()), added weekday
  128.     conversion and command line options.
  129.  
  130. V1.0    Simple ('dumb') backdrop clock with date and time display
  131.     to be rendered directly into the Workbench bar layer.
  132.  
  133.                                   *
  134.  
  135.              Do only its possibilities make it an Amiga?
  136.  
  137.                         WHERE IS THE MAGIC ???
  138.