SUMTIMETRACKER(24 May 1993)

NAME
sumtitra - printing out how many hours you worked last week

SYNOPSIS
sumtitra [-option ...] [weekno]

DESCRIPTION
The sumtitra program takes the files written by titra (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.

-monthday
    Print out the month first then the day (MM/DD), rather than the default DD/MM.

-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.

SEE ALSO
titrax(1)

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
Copyright 1990-1993, Harald Tveit Alvestrand

AUTHORS
Harald Tveit Alvestrand (UNINETT, Norway)
E-mail: Harald.T.Alvestrand@uninett.no