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 development 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 (distributions with moderately new GNU ncurses and GNU readline libraries
  20        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 recommended to set pipe_decode variable in mutt configuration.
  47 See the mutt manual for details.
  48
  49 Abook can also convert from/to mutt alias files and a number of other formats.
  50 Mutt groups are fully supported.
  51
  52 UPGRADING FROM VERSION 0.5
  53
  54 See RELEASE_NOTES .
  55
  56 UPGRADING FROM VERSION 0.4
  57
  58 You must import your abook 0.4 addressbook file because it is stored
  59 to a different location. Configuration file is now located to $HOME/.abook/
  60 directory and it's called abookrc . (without leading dot)
  61
  62 NOTES
  63
  64 If your language specific characters don't work correctly make sure
  65 that your locale configuration has been done properly. (On Linux you
  66 must set at least LC_CTYPE environment variable)
  67
  68 If you want to import a ldif file generated by abook in Netscape you
  69 must use the extension ``.4ld''.
  70
  71 OBTAINING ABOOK
  72
  73 Get the latest version from http://abook.sourceforge.net/
  74
  75 LICENSE
  76
  77 All files in this distribution are released under GNU GENERAL PUBLIC LICENSE.
  78 See COPYING for details.
  79
  80 CONTACT AUTHORS
  81
  82 Send bugreports, fixes, wishes etc. to abook mailing list:
  83 https://lists.sourceforge.net/lists/listinfo/abook-devel
  84