1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
|
This file has three sets of installation instructions: with `make',
without `make', and uncompiled. Please follow the appropriate set of
instructions. If you plan on running BBDB directly from CVS, please
check the additional instructions below.
===============================================================================
Running BBDB from CVS:
*** PLEASE NOTE ****
This applies to the master CVS tree at sourceforge, not the XEmacs CVS tree.
*** PLEASE NOTE ***
This is not recommended, unless you're a BBDB developer. You will
need to either install the GNU autoconf package, or download the
pregenerated copy of configure from the BBDB website. If you choose
the former option, you'll need to run `autoconf' to generate the
configure script. Thereafter, follow the appropriate set of
instructions below.
===============================================================================
To compile and install the BBDB on systems with `make':
1) Configure the compilation process:
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.
The `configure' script comes with a number of options that might be of
interest to 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 sendmail mode -
support for it is automatically compiled in, regardless of the
build options supplied) To build with support only for gnus,
mh-e, rmail, and/or vm, issue the 'make' command with one or
more of the following arguments: 'gnus', 'mh-e', 'rmail',
and/or 'vm'. To build the BBDB without support for any mail
program (except for sendmail mode), issue the command
'make bbdb'.
3) Install the BBDB:
The three most typical installations are outlined below:
a) In-place.
i) Follow steps 1 and 2
ii) Add the lisp subdirectory to the Emacs load-path
iii) Add the tex subdirectory to the TeX
search path (can be done by adding the complete path
to the tex subdirectory to the environment variable
TEXINPUTS)
iv) Add the texinfo directory to the Info search path.
b) "Normal".
i) Follow steps 1 and 2.
ii) Copy the .el and .elc files from the lisp
subdirectory to a directory on the Emacs load-path
(or make a new directory, copy the files to it, and
add the new directory to the load-path).
iii) Copy the .tex files from the tex subdirectory to a
directory on the TeX search path (or make a new
directory, copy the files to it, and add the new
directory to the TeX search path.
iv) Copy the .info and .info-* files from the texinfo
subdirectory to a directory on the Info search path
(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.
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
outlined above. While it looks like there are fewer steps in the
non-make instructions below, they're more tedious and involved.
1) Compile the .el files using the byte-compile-file function in
Emacs.
2) Install the BBDB as outlined in step 3 above.
===============================================================================
To run BBDB uncompiled:
Again, this is really not recommended, although it will generate a
more meaningful stacktrace if you happen to run into a problem. In
order to run BBDB uncompiled, you'll need to do two things:
1) Generate bbdb-autoloads.el
You can do this by typing 'make autoloads' in the main BBDB
directory. Note that this will require you to have previously run
configure to generate Makefiles.
2) Add .../bbdb/lisp to your load path
You need to make sure that the lisp subdirectory of the BBDB
source is in your load path so that Emacs can find the BBDB
files.
Since arbitrary chunks of the BBDB are macros, you'll probably find
the uncompiled version slower than the compiled version.
===============================================================================
***************************************************************************
* *
* THE BBDB INITIALIZATION PROCEDURE CHANGED IN 1.57unoff. *
* *
* YOU *MUST* ADD *
* *
* (require 'bbdb) *
* (bbdb-initialize) *
* *
* TO YOUR BBDB INITIALIZATION CODE. THIS TAKES THE PLACE OF ALL BBDB *
* AUTOLOADS. IT DOES *NOT* TAKE THE PLACE OF THE INSINUATION CODE. *
* *
* If you do not add this code, you will receive keymap errors *
* (among other things) *
* *
***************************************************************************
For information on post-installation BBDB configuration and setup, see
the info file. (M-x bbdb, and press 'i' in the BBDB info window)
Questions, Comments, Suggestions, and Bug Reports may be directed to
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.
|