home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / pocketbk / utilsm / newcr1_0 / NEWCRON.TXT < prev   
Text File  |  1995-07-17  |  12KB  |  286 lines
  1. ----------------------------------------------------------------------------
  2.  
  3.                              NewCron 1.0
  4.                      Copyright 1995 Stefan Radig
  5.  
  6. ----------------------------------------------------------------------------
  7.  
  8. 0. What's new
  9.  
  10. Version 1.0
  11. New features:
  12. - A help is now available if the help file is installed.
  13. - Events may now be triggered when the S3a is switched off and/or on.
  14. - Settings which are not relevant for the actual event are printed in
  15.   grey.
  16. Other changes:
  17. - The sources now need OPP10f to be compiled. This is an OPL-preprocessor
  18.   by Andy Clarkson.
  19. - The language specific code has completely been moved to the file
  20.   newcron.oph. There are versions for german and english language.
  21. - The distribution format has been changed. See later for details.
  22.  
  23. WARNING: Files of version 0.9 and lower may no longer be used!
  24.   
  25. Version 0.9
  26. New features:
  27. - A new menu option has been added. Now you are able to search for 
  28.   a message text (wildcards may be used).
  29. - A new menu option has been added which displays the copyright screen
  30.   for a while 
  31. - There is now an english and a german version.
  32. Bugfixes:
  33. - A bug has been fixed which led to an error if you inserted an entry
  34.   before copying or editing one. Now a copy event is executed simply
  35.   before you may insert something.
  36.   
  37. Version 0.8
  38. This version has been greatly enhanced. So much of the internal structure
  39. has changed.
  40. New features:
  41. - The scheduler may no longer be started manually. It's started, when
  42.   NewCron is started and finishes when NewCron finishes.
  43. - You can switch manually between the events and the message list via the 
  44.   diamond key.
  45. - You may edit entries while the scheduler is running. (Although it's 
  46.   stopped while you are looking at a dialog or menu.)
  47. - The time when an event occured is logged in the message list.
  48. Bugfixes:
  49. - Now all the 40 characters of a message may be displayed.
  50.  
  51. Version 0.7
  52. New features:
  53. - Now a daily time interval can be given. Events that do not fall in this 
  54.   interval are ignored.
  55. Bugfixes:
  56. - A little bug in doevnt has been fixed. It was a wrong date comparison.
  57.  
  58. WARNING: Files of version 0.6 may no longer be used!
  59.  
  60. Version 0.6
  61. The first released version.
  62.  
  63. ----------------------------------------------------------------------------
  64.  
  65. 1. Intro
  66.  
  67. This is NewCron 1.0, a scheduler program for the psion S3a. It may be used 
  68. to schedule repeated events. It uses a file for storing a list of events 
  69. each of which may trigger different actions.
  70.  
  71. Features:
  72. - Number of events limited only by size of the used disk.
  73. - Triggers sounds, texts, macros and/or opl-programs.
  74. - Comfortable builtin editor for events running in parallel to the scheduler.
  75. - Switches the S3a on, if necessary.
  76. - Repetitions from seconds to years.
  77. - Day time intervall for active events
  78. - Events may be edited at each time and will be queued after you finished
  79.   editing.
  80. - A help screen is given, which holds a subset of this manual.
  81.   
  82. ----------------------------------------------------------------------------
  83.  
  84. 2. Copying
  85.  
  86. The program may be copied and changed according to the terms stated in the 
  87. file COPYING, which is the GNU General public license. If you make any changes 
  88. please send them - along with some documentation - to me. If I consider them 
  89. useful I will include them in the next version. Although you are allowed to,
  90. if would prefer if you would not post own versions. This would be very confusing.
  91. However if you do, give it a different name and/or state explicitly that it's 
  92. an 'unofficial' release.
  93. If you think, that the program is useful to you, don't send any donations but 
  94. please feel free to send your own programs (incl. keys, if shareware) to me.
  95. I would appreciate very much getting feedback from you!
  96.  
  97. ----------------------------------------------------------------------------
  98.  
  99. 3. Files
  100.  
  101. The package consists of the following files in the following folders:
  102.  
  103. newcron.txt - this manual
  104. copying.txt - the GNU General public license V2 which is to be applied
  105. /binaries/
  106.     /deutsch/
  107.         /app/
  108.             newcrong.opa - the german binary
  109.         /cron/
  110.             newcrong.rsc - the german help file
  111.     /english/
  112.         /app/
  113.             newcrone.opa - the english binary
  114.         /cron/
  115.             newcrone.rsc - the english help file
  116. /sources/
  117.     /opd/
  118.         newcrong.hlp - the source for the german help file
  119.         newcrone.hlp - the source for the english help file
  120.     /opp/
  121.         newcron.opp - the program source
  122.         newcron.oph - the language specific code
  123.     /pic/
  124.         newcron.pic - the icon for the opa
  125.         newcron2.pic - an alternative icon
  126.  
  127. ----------------------------------------------------------------------------
  128.  
  129. 4. Installation
  130.  
  131. - Choose your language and go into the appropriate folder. Copy everything
  132.   in it to the correct folder on the internal drive. Install the .opa file
  133.   in the usual way. Then use it.
  134.   Example for the english version:
  135.       - Create the folder /cron/
  136.         - Copy
  137.                 /binaries/english/app/newcrone.opa to /app/newcrone.opa
  138.                 /binaries/english/cron/newcrone.rsc to /cron/newcrone.rsc
  139.       - Install it.
  140.       
  141. ----------------------------------------------------------------------------
  142.  
  143. 5. Using NewCron
  144.  
  145. The program conforms as close as I could to the style used by the internal 
  146. applications. This includes the file list from the system screen, which may 
  147. be used to choose the actual file or create a new one. Even several copies 
  148. of NewCron may be active at the same time.
  149.  
  150. Starting:
  151.   Start NewCron from the system screen selecting a file from the file list 
  152.   or creating a new one using the menu option. The program will display a 
  153.   copyright screen and then start to look for events past due. These will 
  154.   be replayed.
  155.   *** You may stop replaying them by pressing any key.
  156.   *** THIS WILL STOP THE SCHEDULER until you edit any event!
  157.   If you didn't press a key or - after pressing a key - edited an event, the 
  158.   scheduler will search for the next due - or passed due - event. This may 
  159.   take a while, especially if you didn't use it a long while.
  160.   When the next event has been found NewCron will display "Waiting for event #".
  161.  
  162. Stepping around:
  163.   Step around with the arrow keys. Arrow-up goes to the first event, arrow-down 
  164.   to the last one. Arrow-right creates a new entry if you press it when looking 
  165.   at the last event. The events are not sorted and if you alter an event, it
  166.   will become the last one.
  167.  
  168. Editing:
  169.   You may now edit, add and delete events. Note that the scheduler is not 
  170.   active, if either the menu or a dialog box is displayed. However it will 
  171.   replay past due events in the appropriate order after the menu/dialog has
  172.   been left.
  173.   Press enter to edit the event you are looking at. To change the fields 
  174.   <Repetition>, <Sound> or <Opl-Module> select them then press enter. This is 
  175.   annoying because it does not conform to the builtin app style. But I don't 
  176.   know how to use the <TAB>-Button-Options in a dialog from OPL. Is there
  177.   anyone who knows???
  178.   The <active> switch may be used to switch between <not active>, <active>,
  179.   <triggered when S3a is switched on> and <triggered when S3a is switched off>.
  180.   However <switched off> means switched off manually not automatically!
  181.  
  182. Using the menu:
  183.   The menu options may be selected by hotkeys, of course. But I didn't know 
  184.   a reason why you should be forced to press the PSION-key. (Does anyone know 
  185.   one???) So the plain keys will work, too. In addition the delete key will
  186.   delete an event, too.
  187.     Pressing the help key gives a help screen.
  188.       
  189. The log screen:
  190.   Each event executed is logged in the message list although you will only be
  191.   able to look at the last 10 or so events. If a message is attached to the
  192.   event, NewCron will switch to foreground and will display the message list
  193.   when the event occurs. Otherwise it won't. You may manually switch between
  194.   the event-screen and log-screen using the diamond key. If you are looking
  195.   at the log screen, every key will bring you back to the event-screen.
  196.  
  197. Hints:
  198. - The order of events in the file - and wi