XEROX LOGTIME 2 4 1 LOGTIME 1 4 Johannes A. G. M. Koomen Koomen.wbst@Xerox Koomen@CS.Rochester.edu October 12, 1989 SUMMARY LOGTIME is a facility for keeping track of how you spend your time. Clicking on the background menu entry "Log Time" loads a data file and starts up a process. The process wakes at regular intervals and prompts the user for the activity engaged in during the latest interval. The default response is the previous activity. Clicking the right mouse button on the prompt window brings up a menu of known activities. Control-E in the prompt window causes the latest interval to be ignored. Clicking on the background menu entry "Log Time" when a LOGTIME process is already active causes the process to be awoken immediately. Rollout menu entries provide a way to edit the current data, to report on the data accumulated for the current day, and to stop keeping track of time (either "Quit" which updates the datafile, or "Abort" which throws away current data). DESCRIPTION (LOGTIME.START datafile) [Function] Starts and returns a new LOGTIME process to keep track of time, using datafile as the file to load and store data, unless a LogTime process is already running, in which case NIL is returned. If datafile is NIL, it defaults to LOGTIME.DATAFILE (see below). (LOGTIME.UPDATE) [Function] Wakes up the LOGTIME process, if any, causing an immediate prompt for an activity. (LOGTIME.STOP abortflg) [Function] Stops and returns the LOGTIME process currently running, if any. If abortflg is NIL, the datafile indicated in the preceeding call to LOGTIME.START is updated. The "Quit" roll-out entry on the background menu invokes (LOGTIME.STOP). The "Abort" roll-out entry on the background menu invokes (LOGTIME.STOP T). (LOGTIME.EDIT olddatafile newdatafile) [Function] Loads olddatafile if necessary. Invokes the Lisp editor on a list of entries, where each entry is a list of starting date, ending date and activity, e.g. ("10-Oct-89 13:07" "10-Oct-89 13:12" "Mail"). If all entries can be reparsed upon return from the editor the dataset is modified accordingly. If the data did not come from the LOGTIME process currently running (if any) the data are written back to newdatafile if given, otherwise to olddatafile. The "Edit" entry on the background menu invokes (LOGTIME.EDIT). (LOGTIME.REPORT bydateflg verboseflg fromdate todate datafile reportfile) [Function] Generates a report of the data in datafile (defaults to LOGTIME.DATAFILE). If bydateflg is non-NIL the report is sorted by date, otherwise by activity. If verboseflg is non-NIL, the report lists each single entry in the dataset, otherwise only cumulative time (per date or per activity) is given. If fromdate is given (a string acceptable to IDATE) all entries prior to this date are skipped. If the time is omitted from fromdate it is assumed to be 0:00. If todate is given (a string acceptable to IDATE) all entries past this date are skipped. If the time is omitted from todate it is assumed to be 23:59. The report will be generated on reportfile (which defaults to LOGTIME.REPORTFILE). The "Report" entry on the background menu invokes (LOGTIME.REPORT T T ). LOGTIME.INTERVAL [Variable] The number of minutes the LOGTIME process will sleep in between prompts. Initial value is 15. LOGTIME.DATAFILE [Variable] The name of the default datafile. Initial value is (CONCAT (DIRECTORYNAME) "LogTime.Data"). LOGTIME.REPORTFILE [Variable] The name of the default reportfile. Initial value is T. LOGTIME.PROMPT.URGENCY [Variable] The value used for the PROMPTFORWORD argument urgency.option. Initial value is 'TTY. (LIST ((PAGE NIL (FOLIOINFO (ARABIC) STARTINGPAGE# 1) (0 0 612 792) ((FOLIO NIL (PARALOOKS (QUAD CENTERED) CHARLOOKS (SUPERSCRIPT 0 SIZE 10 FAMILY MODERN OVERLINE OFF STRIKEOUT OFF UNDERLINE OFF SLOPE REGULAR WEIGHT MEDIUM) FORMATINFO (ARABIC)) (174 36 288 36) NIL) (HEADING NIL (HEADINGTYPE RUNNINGHEAD) (84 744 444 36) NIL) (TEXT NIL NIL (84 96 456 600) NIL))) (PAGE NIL NIL (0 0 612 792) ((FOLIO NIL (PARALOOKS (QUAD CENTERED) CHARLOOKS (SUPERSCRIPT 0 SIZE 10 FAMILY MODERN OVERLINE OFF STRIKEOUT OFF UNDERLINE OFF SLOPE REGULAR WEIGHT MEDIUM)) (282 42 72 36) NIL) (HEADING NIL (HEADINGTYPE RUNNINGHEAD) (84 744 444 36) NIL) (TEXT NIL NIL (84 96 456 600) NIL))) (PAGE NIL NIL (0 0 612 792) ((FOLIO NIL (PARALOOKS (QUAD CENTERED) CHARLOOKS (SUPERSCRIPT 0 SIZE 10 FAMILY MODERN OVERLINE OFF STRIKEOUT OFF UNDERLINE OFF SLOPE REGULAR WEIGHT MEDIUM)) (282 42 72 36) NIL) (HEADING NIL (HEADINGTYPE RUNNINGHEAD) (84 744 444 36) NIL) (TEXT NIL NIL (84 96 456 600) NIL)))))4È 6`È(È1È È1È ¼È(ŠŠ8(È (ŠŠ8DÈÈ PAGEHEADING RUNNINGHEAD HELVETICA MODERN MODERN MODERN MODERNMODERN LOGO HRULE.GETFNMODERN  HRULE.GETFNMODERN  HRULE.GETFNMODERN  HRULE.GETFNMODERN  HRULE.GETFNMODERN Ce  Ft6 S Dê  „  B= "% E ˆrn= | _ _ 9 .F€zº