
			      Addressbook 0.4
			============================
			      by Clemens Durka
		      (durka@informatik.tu-muenchen.de)

				 INSTALL

0. Requirements

To install Addressbook, you need:

- A Computer
- Tcl/Tk installed
- The file addressbook-[version].tar.gz

See README and ANNOUNCE where to find these things.

1. Dokumentation

The Dokumentation is under development. Look at all the files in 
CAPITAL LETTERS. Or use WWW to get up to date information:

http://wwwmayr.informatik.tu-muenchen.de/~durka/addressbook/index.html

2. Unpacking

Unpack the file addressbook-[version].tar.gz in your favorite place

gzip -cd addressbook-[version].tar.gz | tar xvf -

3. Installing

You have to find out the location of the programm 'wish', 
the Tcl/Tk interpreter. Type something like 'where wish' or 'type wish'
to get the full path to it.

Replace (using your favorite editor) the first line of the file
bin/addressbook if the path to wish on your system differs.

To install, you have two possibilities:
- Install as root for all users on your system (follow Instructions 3.1)
- Install as user in your own home directory (follow Instructions 3.2)

3.1 Installing as root

Copy all the files in bin to /usr/local/bin

cp -d bin/* /usr/local/bin

Make a directory /usr/local/lib/addressbook
if you choose an other place, modify the variable 'configfile' in
addressbook (about line 20)

Copy all the files in lib (incl. subdirs) to /usr/local/lib/addressbook

cp -dR lib/* /usr/local/lib

Edit (using your favorite editor) the file 
/usr/local/lib/addressbook/addressbook.config to meet your local needs.

If you allow users to modify the global addressfile, you have to give
them write access to the file. If not, every user should have a file
.addressbook.config in his homedirectory pointing to his addressfile.


3.2 Installing as user

Copy all the files in bin to ~/bin

cp -d bin/* ~/bin

Make a directory ~/addressbook
Modify the variable 'configfile' in addressbook (about line 20)

Copy all the files in lib (incl. subdirs) to ~/addressbook

cp -dR lib/* ~/addressbook

Edit (using your favorite editor) the file 
~/addressbook/addressbook.config to meet your local needs.

With the file ~/.addressbook.config you can override the defaults.


4. Using

To use, just call addressbook. You will get the default addressfile.
If you want to create your own file, copy the formatfile from the
default addressfile (/usr/local/lib/addressbook/addresses.dat.fmt)
and modify it.

Note: Each data file needs a format file with the same name plus
the extension .fmt


5. Problems?

If you have problems, please contact the me.
As I'm continuing the developement, I welcome any questions, comments, 
suggestions, complaints, assistance etc.

email:	durka@informatik.tu-muenchen.de
WWW:	http://wwwmayr.informatik.tu-muenchen.de/~durka
irc:	Clemens (sometimes at least)

Clemens Durka

