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

The documentation 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. Testing

If you want to test it before installing, just invoke './test_addressbook'
and play with it.


4. Installing

4.1 Installationscript

I have provided an installationscript written in tcl. You just have to invoke 
'./install_addressbook' and anwer the questions. If you want to
install it as root, you have to be root while installing. 
If you dont have tcl installed, call './install_addressbook_wish'. It will do
the same work, but a bit slower. If anything goes wrong, try to create the
directories (for the binaries and the libdir) before starting the script. If
nothing helps, you can always continue manually.

4.2 Manual Installation

You dont need this, if the installscript finished without errors. Just
if you have problems with the automatic installation, read on.

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.

Copy all the files in bin to /usr/local/bin, installing as root (or
to ~/bin, installing as user)

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

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

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

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

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


4.3. The little programms tel fax and email

These programms are written in perl and they are standalone programms to
get the telephonenumber in a fast way. They get installed by the installation
programm.

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

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.

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

For the little programms, just invoke tel, email or fax with the name, 
you want to search as argument.


6. Registration

Don't be shocked, the program is published under the GNU Public
Licence (see COPYING). However, if you like the programm and you 
use it regularly, it would be nice, if you would send me a short
email, where you write what you like, what suggestions you have,
how you were informed about the existence of this programm,
how many users use it and if you want to be notified, if a new 
version comes out. This registration doesn't cost anything, I 
will not use your emailaddress for any purpose, unless you want to
be notified of new versions. This registration helps me to track down 
the number of people who use it, the problems and the important
things who need to be developed more.

Use may, but neednot use a form like this and send it to the address below:

Subject: Addressbook Registration

I installed as (root/user)            :
My computer is a                      :
running the operation system          :
No. of people who use it approx.      :
I heard about this program from       :
I got the source from                 :
I like it, because                    :
I don't like                          :
I miss the following feature          :
I use it at home / at work            :
The function I use most               :
The size of my database is approx     :
I want to be notified of new versions :
Comments                              :


7. Problems

If you have problems, please contact the me.
As I'm continuing the developement, I welcome any questions, comments, 
suggestions, complaints, assistance, money, CDROMs and virtual beer.

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

Clemens Durka

