NABR 0.1.0
----------

Contents
--------
1. What is this?
2. License
3. Copyright
4. Guarantees
5. Usage
6. Compiling
7. Changes
8. Author

1. What is this?
----------------
Netscape Address Book Recovery. This is a tool to take that corrupted
Netscape Address Book and get your information out of it. After the third
time my book got corrupted, I gave up trying to fix it by hand and wrote
this program. This program attempts to get as much information out of the
address book as is possible. But as with all programs of this type, it will
always need to change to keep track of the different ways in which the address
book can be corrupted. It can output .csv (Comma Seperated Values) or .ldi
(LDAP Date Interchange Format) files. If you output to .csv files you will lose
all mailling list information.


2. License
----------
GPL license as found in the file LICENSE

3. Copyright
------------
This program is copyright Robert Sandilands @2002.

Netscape and everything associated with them is their copyright.

4. Guarantees
-------------
None. This program may not work at all. I do not guarantee that it will
recover or do anything. If it breaks, you have the source code.

Please read http://rsandila.webhop.org/disclaimer.html

5. Usage
--------
The netscape address books are abook.mab and history.mab. The first one is
your personal address book and seems to be the one that gets corrupted the
most. Depending on your OS it can be in different places on your file
system. Nothing that a file search won't resolve. Take the newest one.

The program is used as follows: nabr [input] [output] [--ldif]

The first parameter is the input file, the second is the output file and the
third specified whether you want LDAP Data Interchange Format files. If you run
the program with no parameters it will default to .csv output with abook.mab as
input and abook.csv as ouput.

The LDIF format data is formatted the same way as the Netscape LDIF exported file
to make it easier to re-import into Netscape. There may be some fields missing and
any comments on this would be appreciated.


6. Compiling
------------
Use make to compile the package. You need everything as detailed in the file
DEPENDS.

7. Changes
----------
Please look at CHANGELOG

8. Author
---------
For contact information look at AUTHORS
