home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / PSION / MISC / PTIME / P_TIME12.TXT < prev   
Encoding:
Text File  |  1995-10-12  |  3.7 KB  |  96 lines
  1. Documentation for P_TIME.OPL Version 1.2
  2.  
  3. Date: 12.10.1995
  4.  
  5.  
  6.  
  7. 1. GENERAL
  8.  
  9. P_TIME.OPL is a program which shows you how you spend your time
  10. with your psion series 3(a). The intention was to create facts to
  11. argue with my wife, who means that I spend too much time joying
  12. with my psion.
  13. Although I have much learned from the DOHELP.OPL - program I request
  14. full copyright for P_TIME.OPL in all parts. P_TIME.OPL may be distri-
  15. buted and used as public domain program. You may use it at your own
  16. risk.
  17. You are allowed to modify this program under the following condition:
  18. If you are modifying successfully P_TIME.OPL I request a copy of the
  19. modificated program.
  20.  
  21.  
  22. 2. INSTALLATION
  23.  
  24. Copy P_TIME.OPL to your OPL-directory.
  25. Start the OPL-translator.
  26. Select P_TIME.OPL to edit.
  27. Start translation.
  28. Quit translation whithout starting P_TIME.OPL.
  29. Return to system screen.
  30. Start P_TIME.OPO listed under the OPL-RUN-symbol.
  31.  
  32.  
  33. 3. HANDLING, FEATURES
  34.  
  35. After initialization the program quits immediately, but whenever you
  36. select then P_TIME.OPO, it shows its information screen. The screen
  37. contains the following parameters:
  38.  
  39. total time       =  the time since you have started P_TIME.OPO.
  40.  
  41. on time          =  time during total time, whenever the computer
  42.                     was switched on.
  43.  
  44. programming time =  time during on-time, when you have programmed
  45.                     something.
  46.  
  47. The time is shown in the format days (ddd, 0 - 365), hours (hh, 0 - 24)
  48. and minutes (mm, 0 - 60). The on-time is shown aditionally related to
  49. total time and the programming time related to on-time in percent.
  50.  
  51. The time measurement is updated every 10 seconds. If you select
  52. P_TIME.OPO it is first shown the last info-screen and you may have
  53. to wait up to 10 seconds until an updated screen is shown. You are
  54. informed about a completed update by a message on the right bottom
  55. of the screen. To quit the screen you have to hit any key.
  56. The error of the shown values is equal to the error of the built-in
  57. watch and the +-10 seconds error. Additional error occurs if you are
  58. regarding the info screen to long, because this is detected as off-
  59. time. I my opinion this error is neglectible if you use P_TIME.OPO
  60. long enough.
  61.  
  62. The programming time is incremented whenever the standard path of
  63. the foreground application is an OPL or OPD directory. So programming
  64. is detected also it you use another editor than the built-in OPL-
  65. editor (=WORD-application).
  66. Auto-off of the series 3 is not influenced by P_TIME.OPO. Although it
  67. wasn't possible to reduce the priority level of P_TIME.OPO it doesn't
  68. need a lot of activity of your series 3 because of the 10 seconds
  69. count interval. During this interval P_TIME.OPO is waiting for a timer
  70. interrupt before continuing with work. Its work is then completed after
  71. 0,006 seconds.
  72.  
  73.  
  74. 4. VERSION 1.2 ADDITIONAL FEATURES
  75.  
  76. P_TIME now holds its variables in a data file called P_TIME.DAT in the
  77. \OPD\-Directory on your standard drive. This disk MUST NOT be a FLASH
  78. type, because P_TIME.OPO updates it every 10 seconds.
  79. If you shut down P_TIME.OPO (maybe by backing up your drives using
  80. RCOM's backup command,which will shut down all running programs) the
  81. previous values are not lost. After restarting P_TIME.OPO the program
  82. will first read out this file and set its variables according to the
  83. values stored.
  84.  
  85.  
  86. 5. KNOWN BUGS
  87.  
  88. If you have selected an SSD-Drive as standard disk drive, an error will
  89. occur if you open the SSD-door during a write- or read-operation of
  90. P_TIME.OPO to the file P_TIME.DAT. The error type is fatal, so that the
  91. system screen will shut down P_TIME.OPO.
  92.  
  93.  
  94. For further information contact:
  95. Heinrich Hiemesch@m2.maus.de
  96.