GTimeTracker Documentation - chapter 3
The Dialogs


3.1 The Preferences Dialog


3.1.1 Display

You can select, what GTimeTracker should display in the main window, here.
Show Seconds
You can tell GTimeTracker, if you want the seconds to be displayed in the project list. If seconds are shown, the time displayed in the project list looks like 00:12:47 (hours:minutes:seconds). If not, you just see 00:12 (hours:minutes).

Show Toolbar Icons and Show Toolbar Texts
If you're using a GNOME version of GTimeTracker, you can select how the toolbar should look. You can chosse to display icons and/or a text.

Show Status Bar
Just choose, if you want the status bar to be displayed.


3.1.2 Shell Commands

Switch Project Command
This shell command will be executed every time you select a project, which was previously unselected. If you use %s in this command, GTimeTracker will replace that by the title of the selected project. I use the following entry to update my .project file:
echo '%s' >~/.project

No Project Command
This shell command will be executed every time you deselect a project or if you exit GTimeTracker. To complete the example above, I use this command:
rm -f ~/.project


3.1.3 Logfile

Use Logfile
You have to enable this, if you want a logfile.

Filename
Give a filename for the logfile. GTimeTracker currently does not replace $HOME or ~. You should give the complete path to the logfile.

Timeout in secs
This value represents the minimum time a project has to be selected, before it will be logged. This is usefull, when you don't want any small task to be logged, or when you clicked on the wrong project first. Let's say, you just wanted to start working on a letter to your friend Joe (so you selected the project Letter to Joe), but that reminds you, that you have to prepare a list of Christmas presents first (Joe has asked you to give him some good ideas). So you switch to the project X-Mas presents. You wouldn't want the project Letter to Joe to be in your logfile, because you didn't really start it yet. I would suggest you set this value at least to 10 seconds.

Note that a project will not get logged, before you either quit GTimeTracker, switch to another project, or deselct that project. So don't be confused when you look at your logfile and your current project still isn't listed, even if it is running since two hours.


3.1.4 OK, apply and Cancel

If you are pleased with the values of the dialog, press OK to make them active and have the dialog go away.

If you want to apply these values just for a given task and plan to reopen the dialog again, you can press on Apply to activate the values. But the dialog will remain open.

If you don't want to change to working values, you just press Cancel. That will close the dialog, but will not change the behavier of GTimeTracker in any way. I recommend using Cancel even if you didn't change anything.


3.2 The Properties Dialog

This dialog shows you all values that are internally stored with a project.

Note that this is the only way to examine the overall time yet.

Project Title
You can change the title of a project here.

Project Description
You can give the project a more detailed description if you like. Up to now this value will never be used by GTimeTracker

Project Time today
This is the daily time, you worked on the project today. You can edit this time here.

Project Time ever
This is the total time, you worked on a project. You can edit this time here.

See OK, apply and Cancel, subsection 3.1.4 for the meaning of the buttons at the bottom of the dialog.


3.3 The New Project Dialog

This dialog is fairly small. It just wants to know, how you want to entitle the new project. Just enter a title of the new project and press OK, if you are satisfied. Or press Cancel if you changed your mind and don't want GTimeTracker to add a new project.
GTimeTracker Documentation - Copyright © 1997,98 Eckehard Berns
Contents; next; back.
last modified: 14 January 1998
Eckehard Berns eb@berns.prima.de