home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / pocketbk / utilsr / teatime10 / TEATIME.DOC next >
Text File  |  1994-11-02  |  7KB  |  163 lines
  1. Hi,
  2.  
  3. here comes Teatime V 1.0 - a simple multiple countdown timer application.  
  4. I have always been wondering why nobody ever wrote such a thing or why it 
  5. did not show up on the net.  As simple as it is, it seems to be one of the 
  6. indispensable features.
  7.  
  8. Lately my brother demanded it. Well, I was the one who convinced him to 
  9. buy a Psion, so did I have a choice? Here is the result...
  10.  
  11. Teatime is Treatware. If you like it, treat somebody you like to a cup of 
  12. tea, a glass of wine, an evening out, or something else she or he likes.
  13.  
  14. *** This program will not run on the old Series 3 !!! ***
  15.  
  16. Enjoy!
  17.  
  18. If you use individually recorded alarm sound, I would love to receive a 
  19. copy of your favourite one by email. Thanks!
  20.  
  21. Bernd
  22.  
  23. (bernd.meyer@fernuni-hagen.de)
  24.  
  25. ==========================================================================
  26.  
  27. Installation
  28.  
  29. If you just want to install it, simply copy Teatime.opa to any \APP 
  30. directory and install it from the system screen.
  31.  
  32. If you want to make changes or to have a look at the source code, copy 
  33. Teatime.opl to any \OPL directory and Teatime.pic to any \OPD directory. 
  34.  
  35.  
  36. Features and Usage
  37.  
  38. Teatime is a "Type 3 Application".  That means that you can run multiple 
  39. timers at once and can display and create various different timers in the 
  40. system screen.
  41.  
  42. Each timer has the following settings: Total running time, intervals 
  43. between ticks (acoustic marks), and the sound to be used with the alarm 
  44. upon expiration.  This sound can be any of the builtin system sounds or a 
  45. recorded sound file.
  46.  
  47. Teatime uses the "ALM:" device to schedule the expiration alarm.  Hence, 
  48. you can see its alarms in the clock application, you can quit a timer 
  49. without cancelling the final alarm, and you can even switch off your 
  50. machine during a countdown.
  51.  
  52. Once you have istalled it as an application, you can use the usual commands 
  53. from the system screen: "Enter" to start a new timer or to change the 
  54. current one to a different one, "Shift-Enter" to start a new timer without 
  55. cancelling any of the running timers (or vice versa if you changed that in 
  56. the system settings), and "Backspace" to abort a timer.  As well you can 
  57. create new timers, delete existing ones, copy them, etc. by the usual 
  58. commands used for any type 3 application like Word or Agenda.
  59.  
  60. When a timer is started it first displays its settings.  You can change 
  61. these settings in a dialog box: 
  62.     "Duration": total time to expiration, 
  63.     "Ticks": interval time between ticks (00:00:00 means no ticks at all), 
  64.     "Message": text to be displayed in the expiration alert box 
  65.     "Sound": Sound to be used for the expiration alert.  
  66.              If you chose "File" here an additional dialog will be presented
  67.              where you can choose any of the sound files you have. 
  68. The Timer is started with "Enter" and can be cancelled at any time 
  69. by "Esc".  If you cancel it a dialog is presented where you can select if 
  70. you want only the progress meter to be cancelled ("Space Bar") or if you 
  71. want the expiration alarm to be cancelled as well ("Esc").  You can as well 
  72. resume the timer ("Enter").  If you cancel the timer you will get back to 
  73. the settings dialog.  You can leave a timer by pressing "Esc" in the 
  74. settings dialog.  Before the timer exits you will be asked if you want the 
  75. settings to be saved.
  76.  
  77. When a timer is cancelled from the system screen by highlighting it and 
  78. pressing "Backspace" it always saves its settings file and the expiration 
  79. alarm is never cancelled.
  80.  
  81. You can still delete an expiration alarm even when you have dismissed the 
  82. progress window for the corresponding countdown. To do this go to the clock 
  83. application, select "view alarms" step to the alarm you want to cancel, 
  84. and press backspace.
  85.  
  86. Please note that a timer cannot be cancelled from the system screen when it 
  87. is in the state of displaying a dialog (The progress bar window is not a 
  88. dialog).  This is because of the way OPL handles dialogs and I have not 
  89. been able to find a workaround (help appreciated).  If you try to cancel a 
  90. timer in this state from the system screen an error message is displayed.  
  91. You will have to bring this timer to the foreground by pressing "Enter" and 
  92. finish the menu.
  93.  
  94.  
  95. Bug Reports
  96.  
  97. Please report all bugs you encounter, features you dislike, and features 
  98. you would like to be added to me via email.  You can reach me via 
  99. snail-mail, but email is preferred: 
  100.  
  101. Bernd Meyer, Ravensberger Str.  152, D-42117 Wuppertal, Germany.  
  102. bernd.meyer@fernuni-hagen.de
  103.  
  104.  
  105. Copyright Notice
  106.  
  107. Teatime is Treatware. If you like it, treat somebody you like to a cup of 
  108. tea, a glass of wine, an evening out, or something else she or he likes.
  109.  
  110. If you use Teatime continously, please send me an e-mail so that I can 
  111. keep track of who is using it for sending out updates.
  112. (A postcard of your home town would be even nicer).
  113.  
  114. You may distribute the program freely, changed or unchanged. If you 
  115. distribute it unchanged, you may not charge any fees for it and you must
  116. provide the source code and this documentation with it.
  117. If you distribute it changed, it should be distributed as some kind of 
  118. freeware or shareware and you should provide the source code with it. 
  119.  
  120. If you circle around changed versions PLEASE rename them to something else 
  121. than "Teatime" to avoid confusion with further versions of Teatime 
  122. on servers and in newsgroups. Thanks.
  123.  
  124.  
  125. Further Plans
  126.  
  127. If there is demand I am planning to add the following features in the 
  128. next version: 
  129.     1.    Automatic repetition of countdowns
  130.     2.    Removing the 24 hour limit
  131.     3.    Scheduling timers multiple days in advance
  132.     4.    Ability to schedule the execution of applications and macros
  133.  
  134.  
  135. Acknowledgements
  136.  
  137. Thanks to Mike Ferenci and my brother, Martin Meyer, for beta testing.  
  138. Additionally, I would like to thank all those marvellous people out there 
  139. on the net, who provide continuous service to the community.  In particular 
  140. I would like to mention all the wizards at src.doc.ic.ac.uk for maintaining 
  141. this wonderful archive, Tom Dolbilin for his great freeware packages, David 
  142. Wood for sharing his excellent technical knowledge, and many, many others 
  143. inside and outside of the Psion community.  Keep the spirit up!
  144.  
  145.  
  146. Disclaimer
  147.  
  148. The program has been tested on German and English S3a machines, version 
  149. 3.22F, as accurately as possible. I cannot guarantee that it is working for 
  150. different version numbers or different international versions. Please let 
  151. me know if you test it on different maschines.
  152.  
  153. *** Teatime does not work on the old Series 3 ***
  154.  
  155. The author cannot accept any responsibility for any damage, loss, or harm 
  156. whatsoever caused by this program.  (Neither for data loss, nor for bitter 
  157. tea, burnt cookies, strawberry pop tarts exploding in the toaster, etc.)
  158.  
  159. It is always a good idea to backup your data before testing a new piece 
  160. of software.
  161.  
  162. <EOF>
  163.