/ 
Timex-6.24
/ tktimex

NAME

tktimex - time recording tool

SYNOPSIS

tktimex [options] [projectfile]

DESCRIPTION

tktimex is a time recording tool. Its purpose is to record working times for projects. Projects may be grouped hierarchically with subprojects. It is also possible to get some daily/weekey/monthly statistics.

QUICK OVERVIEW

To create a new project, select from the Project menu the item New.

To start the timer on a particular project, select the project from the list by mouse click and click on the Cont button. To stop the timer, click on the Pause button. You can also double-click on a project to start/stop the timer.

If autosaving is on (which is the default), after each click on Pause, the project list will be updated on disk, and so will every 10 minutes. If autosaving is off, you have to manually save the project list by clicking on the Save button.

To reload an project list file, you have to specify the file name on the command line:

tktimex projectfile.pj1

If Tk::Getopt is installed on your system (highly recommended!), you can set the default project list file in the Option editor (menu Options).

COMMAND LINE OPTIONS

Possible options are:

	--file
    	--mergedir
    	--[no]lock       (default: 1)
    	--[no]one-instance
    	--[no]as, --[no]autosave         (default: 1)
    	--update         (default: 600)
    	--[no]oneday-immediately         (default: 1)
    	--geometry       (default: 500x230)
    	--[no]securesave
    	--enterpriseprojects
    	--enterprisedefaults
    	--df, --dateformat       (default: h)
    	--[no]day8       (default: 1)
    	--[no]archived
    	--[no]onlytop
    	--domain
    	--sort   (default: name)
    	--[no]busyind
    	--autoscroll     (default: none)
    	--hourlyrate
    	--currency       (default: EUR)

TODO

- better Pod

- enterprice-wide settings:

  - default getopt settings

  - central repository for user data (this directory should be 4777
    or 4555 with all the files already created)

  - template sets

  - set of all projects running in system

  - private vs. enterprice projects

BUGS

If tktimex crashes (it should only due to perl/Tk or OS problems!), then it is possible that the project file gets corrupted. To prevent loss of data, there are always some backup files with the suffixes .1, .2 etc.

The -oneday-immediately option is not supported with Tk::DateEntry.

Setting dateformat to "hs" (show hours, minutes and seconds) is not recommended due to cpu waste. Better leave the option at "d" or "h".

FILES

~/.tktimexrc        personal configuration file
~/.tktimex.last     list of last accessed projects
*.pj1               project files

SEE ALSO

perl, Tk, rcsintro(1), cvs(1), Timex::Project

AUTHOR

Slaven Rezic (eserte@users.sourceforge.net)

Copyright (c) 1996-2005 Slaven Rezic. All rights reserved.

For a complete copyright see the Help/About menu entry.