TimeKeep-Dev Documentation ---------------------------------------------------------------------------- TimeKeep-Dev v 95.Dec.12 Description Shareware Tutorial Development and Testing Gadgets Installing Starting Configuration Error Messages Future Enhancements Programming Known BUGS Legalness Thank Yous New in this version Previous versions Locating The Author TimeKeep-Dev is a time-clock utility for keeping track of time spent on project development. ============================================================================ Description ---------------------------------------------------------------------------- Description ----------- TimeKeep-Dev is a time-clock utility for keeping track of time spent on project development. Projects and Modules can be defined and a time clock interface used to TimeIn and TimeOut on a selected Module. TimeKeep-Dev will remember which Module is currently in progress and will select it automatically when the program is re-started. ============================================================================ Shareware ---------------------------------------------------------------------------- Shareware --------- A great deal of time has been spent in the development of TimeKeep-Dev. This version is partially SAVE disabled. If you wish to receive a non-disabled version of TimeKeep-Dev, a Shareware fee of $15.00 (US) or more is required. See: Locating The Author Your shareware payment helps to insure continued development of TimeKeep-Dev. See: Future Enhancements ============================================================================ Development and Testing ---------------------------------------------------------------------------- Development and Testing ----------------------- TimeKeep-Dev was developed on an Amiga 3000T/25MHz with 2 Meg CHIP / 16 Meg FAST memory. TimeKeep-Dev has been tested under: Kickstart version 40.68, Workbench version 40.42 Kickstart version 37.175, Workbench version 38.12 ============================================================================ Installing ---------------------------------------------------------------------------- Installing ---------- The following files should be contained in the same directory: TimeKeep-Dev TimeKeep-Dev.info Sample Data files ----------------- The files contained in the "sample data" directory have been provided as examples of the output created by TimeKeep-Dev. To test them, copy them into your S: directory and run TimeKeep-Dev. These data files will also allow you to see how the registered version remembers the contents of the SoFar gadget to display the total hours:minutes spent on projects. ============================================================================ Starting ---------------------------------------------------------------------------- Starting -------- From Workbench, double-click on the TimeKeep-Dev icon. ============================================================================ Configuration ---------------------------------------------------------------------------- Configuration ------------- TimeKeep-Dev supports configuration through use of Workbench ToolTypes. If any options are not included as a ToolType, the stated defaults will be used. ToolTypes can be typed in upper or lower case or any combination of the two. To have a ToolType ignored surround it with brackets ( ). For example: (ToolType=Value) Invalid settings and ToolTypes will be ignored. In this case, the default values will be used. The following configuration commands are supported: BackFillColor= Description: Sets the palette color to use when filling the background. A value of -1 will disable the fill. Colors are numbered from 0 up. For MagicWB users, a value of 4 is recommended. TimeKeep-Dev's NewScreen is currently a 4 color screen, taking its palette from the Workbench. Valid values: -1, 0...(nColors-1) Default: -1 Example: BackFillColor=4 Database= Description: This is the FULL PATH and FILENAME of the data file created by TimeKeep-Dev. This file is where TimeKeep-Dev stores Project and Module information. Default: "S:TimeKeep-Dev.data" Example: Database="DATA:ScotwareSoftware/.TimeKeep-Dev.data" DataPath= Description: This is the FULL PATH to where TimeKeep-Dev will create its .time files. These files contain TimeIn and TimeOut information for generating invoices. Default: "S:TimeKeep-Dev" Example: DataPath="DATA:ScotwareSoftware/.TimeKeep-Dev" DefaultModule= Description: This is the text to be used as the name of the default Module. When a new Project is added, a default Module is automatically created. Default: "General" Example: DefaultModule="Miscellaneous" Font= Description: This is the name of an 8 point font to be used within TimeKeep-Dev. Currently, only 8 point Proportional or Non-Proportional fonts are supported. TimeKeep-Dev will use the Default System Font, regardless of size, for the window title bar, if opened on the Default Public Screen. If you use a really large Default System Font, you may have problems with the error message display. If this is a problem for you, try using the NewScreen option, and the Font option to set a smaller font. Valid values: Any 8 point, Proportional or Non-Proportional font. Default: "topaz.font" Example: Font="Topaz2p" NewScreen= Description: If set to YES, TimeKeep-Dev will open on its own Public Screen. If set to NO, TimeKeep-Dev will open on the default Public Screen. Valid values: YES, NO Default: NO Example: NewScreen=YES ============================================================================ Error Messages ---------------------------------------------------------------------------- Error Messages -------------- Could Not Create Gadgets - TimeKeep-Dev was not able to create its gadgets. Could Not Lock Screen - TimeKeep-Dev could not get a lock on a default public screen, or could not get visual information from it. TimeKeep-Dev may not have been able to find Workbench or another public screen to open on. Could Not Open Font - TimeKeep-Dev was not able to locate, or open the requested font as an 8 point font. Could Not Open Screen - TimeKeep-Dev was not able to open its own screen. Could Not Open Window - TimeKeep-Dev was not able to open its window. Insufficient Memory - TimeKeep-Dev could not allocate memory to create its structures and lists. ERROR: Project Exists - The Project Name already exists. There can not be two Projects with the same name. ERROR: Default Module can not be edited - The name of the Default Module can not be edited. It can only be set globally using the DefaultModule Tooltype. ERROR: Insufficient Memory - There was not enough memory to perform the requested function. ERROR: Module Exists - The Module Name already exists. There can not be two Modules with the same name. ============================================================================ Tutorial ---------------------------------------------------------------------------- Tutorial -------- This tutorial will single-step you through the normal operation of TimeKeep-Dev. The assumption is made that you have not changed any of the defaults through use of ToolTypes. ADDING A NEW PROJECT ==================== · Start TimeKeep-Dev by Double-Clicking on its icon. When you use TimeKeep-Dev for the very first time, the only gadget that will be selectable is the ADD gadget, under the Project list requester. If data had already been entered into TimeKeep-Dev, that data would now be displayed. · Left-click on the ADD gadget under the Project list requester. The Project Name string gadget is auto-selected. · Type 'Test Number 1' {ENTER} If you wish to abort ADDing, at any time click on the DELETE gadget. 'Test Number 1' will now be added to the Project List and the default Module 'General' will be added to the Module List. ADDING A NEW MODULE =================== · Left-Click on the ADD gadget, under the Module List. The Module Name string gadget is auto-selected. · Type 'Module 2' {ENTER} If you wish to abort ADDing, at any time click on the DELETE gadget. 'Module 2' will now be added to the Module List. KEEPING TRACK OF TIME ===================== When you are ready to start/continue work on a Module, all you have to do is select the Module (or add a new Module) and TimeIn. · Left-Click on the Time In gadget The current time will appear in the Time In string gadget. If the Date and Time are satisfactory, you may continue. If you wish to make changes you may do so by selecting the Date or Time string gadget and making changes followed by {ENTER}. TIMING-OUT OF A MODULE IN PROGRESS ================================== When you have already started a Module using Time In, that Module will be remembered the next time you start TimeKeep-Dev, and will be automatically selected. If we were Exiting and Re-starting TimeKeep-Dev, the 'Module 2' Module would be automatically selected since it now has a TimeIn. · Left-Click on the Time Out gadget The current time will appear in the Time Out string gadget. If the Time is satisfactory, you may continue. If you wish to make changes you may do so by selecting the Time Out string gadget and make changes followed by {ENTER}. TimeKeep-Dev does not allow time to be carried on over 24 hours. For this reason, changing the information in the Date string will change the Date for both Time In and Time Out. QUITTING ======== If you wish to save any changes you have made, you should click on SAVE or SAVE & QUIT. · Left-Click on the QUIT gadget. END OF TUTORIAL =============== For further information about the use of TimeKeep-Dev see the Gadgets section. ============================================================================ Gadgets ---------------------------------------------------------------------------- Gadgets ------- So Far: ------- These gadgets display the total hours and minutes spent on Projects and Modules for the currently selected Project. They are calculated as: - + The following information may also be appear: ------ The amount has been altered, but not saved yet. Cancel: ------- This gadget is active when TimeIn (and TimeOut) information is displayed. Selecting 'Cancel' will delete the TimeIn (and TimeOut) information. ============================================================================ Programming ---------------------------------------------------------------------------- Programming ----------- If you write your own TimeKeep-Dev utility for any other software, please send a copy to the author for inclusion with this distribution. See: Locating The Author .time File Format ----------------- This is the format of the .time data file created by TimeKeep-Dev. LINE 1: "" example: "This is Test #1" LINE 2...n: "T","","","","",, where: "T" = Time Information = Module name = Time In date = Time In time = Time Out time = TimeOut - TimeIn (hours) = TimeOut - TimeIn (minutess) examples: "T","Test Module","May 16, 1995","12:15 PM","1:00 PM", 0, 45 ============================================================================ Legalness ---------------------------------------------------------------------------- Legalness --------- TimeKeep-Dev is copyright ©1994-1995 by young monkey studios. With the exception of the ARexx utilities, the files included with this distribution may not be altered in any way. TimeKeep-Dev is released as Shareware - You are required to pay a Shareware fee if you continue to use this software beyond a trial period of 10 days. The software concept and design remain the property of the author, scott dhomas trenn and young monkey studios. Permission is granted for this program to appear in any public domain software archives and on Aminet CDRom compilations. Permission is granted for this program to appear on any commercial disks or CDROMs, provided that a single copy of the first product, containing this version of this progam, is sent to the author. The author is in no way liable for any damage resulting from the use of this program. ============================================================================ Future Enhancements ---------------------------------------------------------------------------- Future Enhancements ------------------- - Busy pointer - Select InProgress button gadget - Runnable from CLI - and MORE... ============================================================================ Known BUGS ---------------------------------------------------------------------------- Known BUGS ---------- - In Progress counter is not completely working. ============================================================================ Locating The Author ---------------------------------------------------------------------------- Locating The Author ------------------- If you like this program and would like to register, reward me for my efforts, or for bug reports, program ideas, or questions, or just to tell me about where you live. I can be contacted through INTERNET EMAIL at: dhomas@youngmonkey.ca or dhomas@mi.net Or by MAIL at: scott dhomas trenn young monkey studios 797 Mitchell Street Fredericton, NB CANADA E3B 3S8 Registered users may send me $5.00 (US) and a disk, for the latest version of this software or receive a free update through EMail. Be sure to include the version number you are currently using, and the name of the program you want, so I do not send you a version you already have or a program you do not want. The version number can be found in the titlebar, at the top of this documentation file, or by typing: Version TimeKeep-Dev at a shell prompt. It looks similar to 94.Oct.16 When reporting bugs or errors generated when you run TimeKeep-Dev, please include any error messages given by TimeKeep-Dev and also the version number you are using. This will aid me in tracking down the problem. Thank-you. If you have an EMAIL address please include that with your letter. ============================================================================ Thank Yous ---------------------------------------------------------------------------- Thank Yous ---------- Thanks to the following people for beta-testing, suggestions, and bug reports: - Doug Hornal - Enumclaw, Washington USA - dhomas trenn ============================================================================ New in this version ---------------------------------------------------------------------------- New In This Version ------------------- - Removed 'Project Name Code'. It was left over from the conversion from TimeKeep. Filenames are now created based on the 'Project Name'. - Added 'About' gadget. - Now outputs year in .time file. - Fixed Open Screen routine to work under 3.x. ============================================================================ Previous versions ---------------------------------------------------------------------------- New In Version 94.Nov.03 ------------------------ - Modified ToolType parsing routine. Old method would crash when used with programs such as ToolManager. - Added 'Module SoFar' to keep track of individual module amounts. - Fixed a few bugs that were not really bugs but felt like they were. - SoFar minutes now forced to 2 digits: 3 is now 03. - Changed all MWB icon shadows from blue to dark grey. New In Version 94.Nov.03 ------------------------ - Fixed an Uneven Address Error which caused a GURU (#8000 0003) on 68000/68010 CPUs. - Changed MWB icon shadow from blue to dark grey. New In Version 94.Oct.18 ------------------------ - Modified UnRegistered version to allow partial saving. This should make it easier to decide if you want to get the full registered version. - Added 'Cancel' TimeIn/TimeOut gadget. - Background color is set to the BackFillColor tooltype setting, for (Un)Registered text. New In Version 94.Oct.16 ------------------------ - First Release ============================================================================