This collection of tools contains
=================================
1) C-Programs (compile all with `make tools'):
   killdef.c:
	For example
	   `killdef tcharge.c DEBUG > tcharge-no-debug.c'
	removes all preprocessor conditionals for the macro
	`DEBUG' in tcharge.c and writes the result into
	`tcharge-no-debug.c'. Use this program if you want to get into
	tcharge and if you are confused about the preprocessor
	directions.
   day_of_year.c:
	converts a year/month/day triple into the day of year.
	(Needed for a list of public holidays for charge modules.)
   month_day.c:
	converts a yearday 'y' (in the range 0-365) into the triple
	year/month/day.
	(Needed to check a list of public holidays in charge modules.)

2) Perl-scripts:
   mktc:
	A main feature of tcharge: A compiler for charge files!
	(See README.TC)
   date2second:
	converts a date ($hour,$min,$sec,$monthday,$month,$year) into
	the number of seconds elapsed since 1.1.1970
	(Needed for tcharge-options `-start' and `-end'.)
   parse_logfile:
	A script for tcharge-batch-mode (see README.batch)
   summary:
	Generates statistics from a charge-log-file (see section
	`Summary Information' in the man-page).
   summary.log:
	A script to generate stitistics from syslog-files (see section
	`Summary Information' in the man-page).

Trouble-shooting:
=================
* If you get an error like

  > bash: Tools/parse_logfile: No such file or directory

  then the first line of this (and the other) perl-scripts must be
  edited. This is the first line containing the path of perl:

    #!/usr/bin/perl -w

  find out the right path using `which perl' or `type -p perl' and
  edit this line in Tool/Makefile:

    PERL = /usr/bin/perl

  and type `make perl_path' (You may also do the replacement manually)

* You may also "overwrite" the first line using

  perl <scriptname> <script arguments>

  This makes it up to the shell to find perl.
