README

   1
   2  ABOOK by JH <jheinonen@users.sourceforge.net>
   3  -----
   4
   5 Abook is an addressbook program with mutt mail client support.
   6
   7 COMPILATION
   8
   9 To compile abook you must have ncurses developement libraries installed.
  10 Starting from version 0.4.10 abook is known to compile with the native curses
  11 library of SUN Solaris and OpenBSD. Since version 0.5.0 GNU readline is
  12 required. Please note that other readline implementations don't work.
  13
  14 If you compile with --enable-debug flag you should redirect standard error
  15 to somewhere. (for example abook 2> debug or abook 2> /dev/null) Abook has
  16 been compiled and tested successfully on following platforms:
  17 (NOTE: All versions of abook haven't been tested on all platforms.)
  18
  19 Linux (Debian GNU/Linux, RedHat Linux, all other distributions with GNU ncurses
  20        and GNU readline should work)
  21 Darwin
  22 Solaris
  23 FreeBSD
  24 OpenBSD
  25 NetBSD
  26 GNU/Hurd
  27 AIX 3.2.5
  28 HPUX
  29 Irix 6.5
  30 DEC alpha ?
  31
  32 INSTALLATION
  33
  34 See INSTALL for detailed instructions.
  35
  36 If you want to use abook with mutt you should add following lines to your
  37 ~/.muttrc or to the systemwide /etc/Muttrc file.
  38
  39 set query_command="abook --mutt-query '%s'"
  40 macro pager A |'abook --add-email'\n
  41
  42 After this you can make queries from mutt using the query command ('Q')
  43 and add sender e-mail addresses to the addressbook from pager using 'A'
  44 command. (Of course you can choose another keybinding if you like.)
  45
  46 It's also recommeded to set pipe_decode variable in mutt configuration.
  47 See the mutt manual for details.
  48
  49 UPGRADING FROM VERSION 0.4
  50
  51 You must import your abook 0.4 addressbook file because it is stored
  52 to a different location. Configuration file is now located to $HOME/.abook/
  53 directory and it's called abookrc . (without leading dot)
  54
  55 NOTES
  56
  57 If your language specific characters don't work correctly make sure
  58 that your locale configuration has been done properly. (On Linux you
  59 must set at least LC_CTYPE environment variable)
  60
  61 If you want to import a ldif file generated by abook in Netscape you
  62 must use the extension ``.4ld''.
  63
  64 OBTAINING ABOOK
  65
  66 Get the latest version from http://abook.sourceforge.net/
  67
  68 LICENSE
  69
  70 All files in this distribution are released under GNU GENERAL PUBLIC LICENSE.
  71 See COPYING for details.
  72
  73 CONTACT AUTHOR
  74
  75 Send bugreports, fixes, wishes etc. to Jaakko Heinonen
  76 <jheinonen@users.sourceforge.net> or use the mailing list.
  77