README

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