sumtitra(1)

NAME

sumtitra - printing out how many hours you worked last week

SYNOPSIS

sumtitra [-option ...] [weekno]

DESCRIPTION

The sumtitra program takes the files written by titrax (TimeTracker) and sums them into a single timesheet for the week.

The sums are done from Monday to Sunday; the default week is the week that just ended.
(To get this week, use "now" in place of the week number)

Projects that start with a dash (-) are not included in the sum.
Projects that start with a plus (+) are handled specially; see the -adjust command.

Sumtitra is written in Perl, so modifying it should be rather easy.

OPTIONS

Sumtitra has lots of options. Some of them are listed below.

-round: Round off each sum printed to the nearest half hour.

-adjust: Take all projects that start with a "+" sign and spread them evenly over all the other projects worked on this week.

-fudge factor: Give the round-off point when rounding to the nearest half hour. The default is 0.5, but that will tend to lose you time when you have worked a lot on small projects. Sumtitra will print a warning if the change is greater than half an hour. The fudge factor should be between 0 and 1.

-year nn: Give the year; useful if you have to make the timesheets for December in January.

-name string: Change the name printed on the top of the timesheet. Default is your /etc/passwd GECOS field, up to the first comma.

-nameadd string: Add a string (like your employee number) to the front of your name.

-lang code

Give the language for the form. Norwegian (no), English (en), French (fr), German (de) and Italian (it) are more or less included. Comments and contributions are welcomed!

If not given, sumtitra will attempt to inspect the LANG environment variable, the hostname, and the domainname to find out what language to use. If you are surprised, drop me a line.

-minutes: Print out the time in hours and minutes (hh:mm), rather than decimal hours.

-datestyle (us or de)

Changes the way dates are printed. -datestyle us will make it MM/DD; -datestlye de will make it DD.MM

The default is DD/MM, the Norwegian way.

-debug: Print out a lot of not very useful information. If you are surprised by the language chosen, send me a printout with -debug on.

INITFILE

sumtitra will attempt to read its values from the file $TIMETRACKERDIR/sumdefaults. The format is as the command line, with one option per line, and no initial dash. Command-line options override those listed in the sumdefaults file.

BUGS

A lot of the languages have some strings missing. These will be printed in English, with a star (*) in front of them. Contributions solicited!

COPYRIGHT

AUTHORS

Harald Tveit Alvestrand (UNINETT, Norway)
E-mail: [email protected]