home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / utilities / tasklog / !TaskLog / !Help < prev    next >
Encoding:
Text File  |  1995-08-02  |  6.5 KB  |  182 lines
  1.  
  2.  
  3.  
  4.  
  5.                TaskLog - Version 1.00 - 2 August 1995 
  6.  
  7.  
  8.  
  9.  1. What is TaskLog?
  10.  -------------------
  11.  
  12. TaskLog is a multi-tasking desktop utility for the Acorn Archimedes
  13. and RISC PC range of computers running under RISC OS.  It requires
  14. RISC OS 3.1 or later.
  15.  
  16. Distribution:
  17.  
  18. This software is Public Domain and may be freely redistributed, so
  19. long as only a reasonable copying or media charge is made, and all
  20. files are included unmodified.  Copyright to the code is vested in
  21. the author.
  22.  
  23. TaskLog runs in the background and continuously monitors the time
  24. spent by the user on different tasks.  This is achieved by keeping
  25. track of which window (if any) has the input focus ('owns the
  26. caret').  The title bar of windows which gain the input focus
  27. usually turn from grey to cream.  Each time the user changes the
  28. input focus a record is made of the time spent on the previous task
  29. and window.  The log is saved automatically at intervals determined
  30. by the user and on quitting the application.
  31.  
  32. The program was written for a designer using a CAD program who
  33. needed to cost his time spent on different projects.  At the start
  34. of a session he launches TaskLog: at the end, he has a complete
  35. record of the time spent on each drawing.
  36.  
  37. You may have other uses in mind.
  38.  
  39.  
  40.  2. Installing and loading TaskLog
  41.  ---------------------------------
  42.  
  43. Install TaskLog in the usual way by double clicking on the
  44. application !TaskLog to place the TaskLog icon on the icon bar.  A
  45. monitor window opens to show the task/window (if any) currently
  46. being logged.  If no window has the input focus then "no focus" is
  47. shown.
  48.  
  49.  
  50.  3. Using TaskLog
  51.  ----------------
  52.  
  53. There is really very little to do as TaskLog works automatically in
  54. the background.  However, you can:
  55.  
  56.  -  close the monitor window by clicking on the close icon
  57.  -  open the monitor window by clicking select on the icon bar icon
  58.  -  lose the caret by clicking adjust on the icon bar icon
  59.  -  configure the auto-save feature from the icon bar menu (see 3)
  60.  -  manually monitor a task/window when required (see 4)
  61.  
  62.  
  63.  3. Auto-save
  64.  ------------
  65.  
  66. The log is saved automatically at an interval and to a directory
  67. specified by you.  The default interval is every minute and the
  68. default directory is the TaskLog application directory.  The
  69. filename of the log is 'TaskLog'.
  70.  
  71. You can change the settings by choosing AutoSave on the icon bar
  72. menu.  Note that clicking on AutoSave opens the window
  73. 'permanently'.  Simply set the button for 1, 5, 10 or 20 minutes, or
  74. set the button next to the writable icon and enter an alternative
  75. choice.  Clicking on 'Now' saves the log instantly in the specified
  76. directory and under a filename indicating the month, date, and
  77. 24-hour time (eg. '1102-1330' would signify that the log was saved
  78. on 2nd November at 1.30pm).
  79.  
  80. To change the destination directory open the required filer window
  81. and drag the text file icon to it.  The directory name appears next
  82. to the icon.
  83.  
  84. You can 'Set' the choices temporarily, or 'Save' them for future use
  85. (in a file called 'Choices' in !TaskDir).  'Cancel' closes the
  86. window and undoes any changes you may have made.
  87.  
  88.  
  89.  4. Manual operation
  90.  -------------------
  91.  
  92. Some applications, particularly spreadsheets, appear to have only
  93. one main window which in reality comprises two or more.  A problem
  94. arises if the window which gains the input focus is not the one
  95. whose title bar displays the name of the document.  This is the case
  96. with PipeDream, for example, which always shows 'Pipedream4 :
  97. <Untitled>' in TaskLog's monitor, despite what the title bar shows. 
  98. TaskLog overcomes this by allowing you explicitly to set the window
  99. of any task with the input focus.
  100.  
  101. The way you do this is to Shift/Adjust click on the title bar.  A
  102. beep sounds, and the required window is logged.  This continues
  103. until either a different title bar is clicked or the input focus
  104. switches to a new task.
  105.  
  106.  5. The log
  107.  ---------- 
  108.  
  109.  The log is saved as a text file which may then be loaded into an
  110. editor or word processor.  It is best illustrated a short example,
  111. as follows:
  112.  
  113. ====================================================================
  114.  
  115.  TaskLog
  116.  
  117. Started at 09:32:05 on Mon 21/11/94
  118. Logged at  09:35:05 on Mon 21/11/94
  119. Total time 00:03:00
  120.  
  121.  
  122.                                                          hh:mm:ss
  123.  
  124. No focus.................................................      20
  125.                                                          --------
  126.                                                          00:00:20
  127.  
  128. Zap
  129.   ADFS::HD4.$.Devp't.Tasklog.!Tasklog.!Help (Text uwa)...      41
  130.   RAM::RamDisc0.$.TLog-0923 (Text ua)....................       4
  131.   RAM::RamDisc0.$.TaskLog (Text ua)......................      41
  132.                                                          --------
  133.                                                          00:01:25
  134.  
  135. Tiger
  136.   Tiger:ADFS::HD4.$.Devp't.Tiger.........................    1:02
  137.   Text File options......................................      13
  138.                                                          --------
  139.                                                          00:01:15
  140.  
  141.                                                          ========
  142.                                                          00:03:00
  143.                                                                   
  144. ====================================================================
  145.  
  146. Note that because TaskLog calculates in centi-seconds there may be
  147. discrepancies of a second or two due to the effect of rounding.
  148.  
  149.  
  150.  
  151.  6. Miscellaneous
  152.  ----------------  
  153.  
  154. Quitting TaskLog, either by choosing 'Quit' or by shutting down the
  155. system, automatically saves the log under a filename indicating the
  156. month, date, and 24-hour time (eg. '1102-1330' would signify that
  157. the log was saved on 2nd November at 1.30pm).
  158.  
  159. If you use a screen blanker, the time that the screen is blanked
  160. should be recorded under the name of the relevant application, with
  161. the window shown as '-'.
  162.  
  163. The editor Zap (and possibly other applications) manages its window
  164. titles in an unusual way.  The effect is that the title has to be
  165. fully visible for TaskLog to record it correctly.
  166.  
  167.  
  168. --------------------------------------------------------------------
  169.  
  170. I hope you find TaskLog useful and satisfying, and shall be pleased
  171. to receive any comments, criticisms or suggestions.
  172.  
  173.  
  174.   
  175.                           Graham Crow
  176.  Crow Associates, Manor Lodge, Llangattock, Monmouth, Gwent NP5 4NG
  177.              Telephone and Fax:  Monmouth (01600) 772532
  178.                                           
  179.                                                              
  180. --------------------------------------------------------------------
  181.  
  182.