Source

bbdb / INSTALL

Diff from to
 To compile and install the BBDB on systems with `make':
 
-  1) Configure the compilation process
-       Edit the Makefile, setting (if necessary) the paths to the Mail
-       and News reader(s), the XEmacs package installation paths (if
-       applicable), and the miscellaneous (but still important) build
-       tool names and paths.
+  1) Configure the compilation process:
 
-       NOTE:  Gnu Emacs 19.34 users should add the path to Custom
-       1.9962 if they plan to build Gnus support.  Gnus support will
-       not build under Gnu Emacs 19.34 without Custom 1.9962.
+       First of all, you should run the `configure' script at the toplevel of
+       the distribution. This script will perform a number of checks on your
+       system and generate the Makefile's accordingly.
 
-  2) Build the BBDB
+       The `configure' script comes with a number of options that might be of
+       interest for you:
+
+       `--with-emacs=PROG' lets you select an Emacs program to use. By
+         default, "emacs" and "xemacs" will be tried in that order.
+
+       `--with-{gnus,mhe,vm}-dir=DIR' let you specify the paths where Gnus,
+         MH-E and VM can respectively be found, if Emacs can't find them by
+         itself (like, if they're not in the load-path by default).
+
+       `--with-other-dirs=DIRS' lets you specify additional paths (space or
+         colon spearated) to find other libraries that might be needed (see
+         the "Byte Compiling the Lisp files" section of the BBDB manual for
+         more information).
+
+         NOTE: Gnu Emacs 19.34 users should add the path to Custom 1.9962
+         here if they plan to build Gnus support.  Gnus support will not build
+         under Gnu Emacs 19.34 without Custom 1.9962.
+
+       `--with-package-dir=DIR' lets you specify the installation path for
+         for XEmacs package installation. By default,
+         "/usr/local/lib/xemacs/site-packages" is used.
+
+       `--with-symlinks' will make the installation process use symbolic links
+         to the sources instead of copying the files.
+
+       `--with-linkpath=PATH' lets you specify the path to link from, if your
+         `pwd' command doesn't work properly.
+
+
+  2) Build the BBDB:
+
        To build the BBDB with support for all of the supported mail
        and news programs (gnus, mh-e, rmail, and vm), issue the
        command 'make all'.  (The BBDB also supports send-mail mode -
        program (except for send-mail mode), issue the command
        'make bbdb'.
 
-  3) Install the BBDB
+
+  3) Install the BBDB:
+
        The three most typical installations are outlined below:
 
         a) In-place.
                   (or make a new directory, copy the files to it, and
                   add the new directory to the Info search path)
         c) XEmacs Package
-             NOTE: This installation option is only available to users 
-                   running XEmacs 20.3 or higher.  At the time of this 
-                   writing, this includes only XEmacs beta testers.
-             i)    Follow steps 1 and 2, making sure to set the
-                   appropriate variables in the XEmacs package
-                   section.
+             NOTE: This installation option is only available to users
+                   running XEmacs 20.3 or higher.
+             i)    Follow steps 1 and 2.
              ii)   Issue the 'make install-pkg' command.
 
+
+
 To compile and install the BBDB on systems without `make':
 
   If at all possible, use make to automatically build the BBDB as
 *                                                                         *
 ***************************************************************************
 
-For information on post-installation BBDB configuration and setup, see 
+For information on post-installation BBDB configuration and setup, see
 the info file.
 
 Questions, Comments, Suggestions, and Bug Reports may be directed to
-the BBDB mailing list at bbdb-info@xemacs.org.  To subscribe, send
-mail to bbdb-info-request@xemacs.org, with 'subscribe' as the subject.
+the BBDB mailing list at bbdb-info@lists.sourceforge.net.  To
+subscribe, send mail to bbdb-info-request@lists.sourceforge.net, with
+'subscribe' as the subject.