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
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
|
<html>
<head>
<title>BBDB FAQ</title>
<link rel="stylesheet" href="bbdb.css" type="text/css">
</head>
<body>
<h1>The BBDB FAQ</h1>
<p>This is the BBDB FAQ, $Revision: 1.4 $.</p>
<dl>
<dt>About BBDB and this document</dt>
<dd>
<dl>
<dt>What is the BBDB?</dt>
<dd>Updated: 21 July 2000<br>
<br>
The BBDB is an addressbook for Emacs[1] users. It integrates
tightly with Emacs-based mail and news readers, and
provides some support for Netscape Mail and News. It is
intended to be as unobtrusive in use as possible.<br>
<br>
The full name of BBDB is "The Insidious Big Brother
Database".<br><br>
<em>[1] In this FAQ, "Emacs" refers to both <a
href="ftp://ftp.gnu.org/pub/gnu/emacs/">GNU Emacs</a> and
<a href="http://www.xemacs.org/">XEmacs</a>.</em><br><br></dd>
<dt>What is the most current version of the BBDB?</dt>
<dd>Updated: 12 June 2001<br>
<br>
The current stable version is 2.32. The current
development version is 2.33. The versioning from 2.0 to
2.32 is a little awkward, for hysterical raisins.<br><br></dd>
<dt>Where can I get the most current version of the BBDB?</dt>
<dd>Updated: 21 July 2000<br>
<br>
BBDB is hosted, developed and maintained at <a
href="http://bbdb.sourceforge.net/">http://bbdb.sourceforge.net/</a>.
The current stable and development releases are posted
here.<br><br></dd>
<dt>About the FAQ<dt>
<dd>Updated: 25 February 2001<br>
<br>
This FAQ is currently being constructed from a
backlog of saved email messages from the bbdb-info mailing
list. It is part of the BBDB CVS tree and thus can be
updated by anyone with write access to the
tree. Suggestions for additional questions (and answers!)
can be sent to <a
href="mailto:bbdb-faq@waider.ie">bbdb-faq@waider.ie</a>.<br>
<br>
The FAQ answers assume you have some familiarity with
Emacs. Where configuration variables are mentioned,
there's usually a <tt>customize</tt> interface that allows
you to do point-and-click option setting.<br><br></dd>
</dl>
</dd>
<dt>Installing the BBDB</dt>
<dd>
<dl>
<dt>How do I install BBDB?</dt>
<dd>Updated: 25 February 2001<br>
<br>
Read the file INSTALL in the distribution<br><br></dd>
<!-- integrate with VM, Gnus, MH-E, RMail -->
</dl>
</dd>
<dt>Configuring the BBDB</dt>
<dd>
<dl>
<dt>BBDB sometimes displays the user's full name along with
some names, and not with others.</dt>
<dd>Updated: 25 February 2001<br>
<br>
Set <tt>bbdb-dwim-net-address-allow-redundancy</tt> to
<tt>t</tt>. This tells BBDB it's okay to add full names to
addresses of the form
<Firstname.Lastname@wherever><br><br></dd>
<dt>Is there a way to insert literal strings in the phone
number field?</dt>
<dd>Updated: July 28 2001<br>
<br>
Set <tt>bbdb-north-american-phone-numbers-p</tt> to
nil. This tells BBDB to not try parsing numbers, but to
simply accept whatever the user types in.<br><br></dd>
<!-- I guess this question came off the mailing list. It should be
reformatted & answered.
"One question I ask me since begin: How can I insert new fields (say
for signatures or v-card's) and how the hooks to set/get those new
fields? Now, is this a FAQ?"
Answer: bbdb-notice-hook, bbdb-auto-notes-hook
-->
<dt>How do I make BBDB do something not covered in the FAQ??</dt>
<dd>Updated: 25 February 2001<br>
<br>
Read The Fine Manual!<br><br></dd>
</dl>
</dd>
<dt>Using BBDB</dt>
<dd>
<dl>
<dt>How do I get BBDB to fill out an email address for
me?</dt>
<dd>Updated: 28 June 2001<Br>
<br>
Type as much of the address as you feel necessary, then
hit <tt>M-TAB</tt> to get BBDB to attempt to complete what
you've typed. If it finds several matches, you can loop
through them by repeatedly pressing <tt>M-TAB</tt>; you can
also select from a completion-buffer of
choices.<br><Br></dd> <!-- this isn't strictly true; check
config -->
<dt>I have 42 records for Douglas Adams. How do I delete the
duplicates?</dt>
<dd>Updated: 28 June 2001<br>
<br>
<tt>M-x bbdb-show-duplicates</tt>, and delete the ones you
don't want.<br><br></dd>
<dt>Every time I modifiy bbdb mail-alias fields, I need to
quit and restart before <a
href="http://www.gnus.org/">Gnus</a> sees the changes!</dt>
<dd>Updated: 28 June 2001<br>
<br>
(Thanks to John Hunter)<br>
<tt>(add-hook 'message-setup-hook 'bbdb-define-all-aliases)</tt>
<Br><br></dd>
</dl>
</dd>
<dt>Troubleshooting</dt>
<dd>
<dl>
<!-- this one's actually no longer an issue, I believe -->
<dt>XEmacs is giving me an error about BBDB being already
loaded.</dt>
<dd>Updated: 25 February 2001 (David S. Goldman)<br>
<br>
Add the following before you call (bbdb-initialize):
<pre>
(unload-feature 'bbdb-autoloads t)
</pre>
This is fixed in the developer release, and should be
available in the next stable release.<br><br></dd>
<dt>I downloaded the developer release from CVS and I can't
build it.</dt>
<dd>Updated: 25 February 2001<br>
<br>
The developer version from CVS does not include the
<tt>configure</tt> script; this should be generated using
<tt>autoconf</tt>. The <tt>configure</tt> script is included
in the nightly tarball, so you can get it there if you
wish. Alternatively, it may be downloaded from the <a
href="http://bbdb.sourceforge.net/">BBDB Web Site</a>.<br>
<br>
The other problem you may have is that you're on a Win32
system with no support for Makefiles or scripts in
general. Your options are to install the Cygwin environment
(XXX there is a known issue with building under Cygwin XXX)
or to check the mailing list archives for a recent
<tt>make.bat</tt> file. The latter will probably migrate to
the BBDB bits section of CVS once the author has nailed it
down to his satisfaction.<br><br></dd>
<!-- also Alex's stub Makefile for bbdb-autoloads -->
</dl>
</dd>
<dt>Talking to the world outside Emacs</dt>
<dd>
<dl>
<dt>BBDB with Gnus is asking me if I want to update
<non-ASCII-name> to <<non-ASCII-name<</dt>
<dd>Updated: 28 July 2001<br>
<br>
All Hail coding-systems. This problem can be fixed by
enabling a coding system for your BBDB:
<pre>
(setq file-coding-system-alist
(cons '("\\.bbdb" iso-8859-1 . iso-8859-1)
file-coding-system-alist))
</pre>
<br>(From Raymond Scholz and ShengHuo ZHU)<br>
or you could try this, from Toby Speight:<br>
<pre>
;; Need both `coding-system-p' tests to work with Emacs and XEmacs
(cond ((coding-system-p 'emacs-mule)
(modify-coding-system-alist 'file "/\\.bbdb\\'" 'emacs-mule))
((coding-system-p 'escape-quoted)
(modify-coding-system-alist 'file "/\\.bbdb\\'" 'escape-quoted)))
</pre>
<br><br></dd>
<!-- bbdb-whois, bbdb-ftp,
bbdb-talk-to-great-deities-seeking-enlightenment -->
<dt>How do I get BBDB and supercite to play together?</dt>
<dd>Updated: 28 June 2001<br>
<br>
(Thanks to Kevin Davidson, quoted here)
<pre>
Take a look at bbdb-sc.el that comes with BBDB.
I found I also needed to patch supercite.el (up to at least version
3.1 as supplied with Xemacs 20.3) otherwise it stops using your
sc-preferred-attribution-list and starts using a broken default one.
Patch here:
*** supercite.el Wed May 6 10:45:12 1998
--- supercite.el.orig Wed May 6 10:43:11 1998
***************
*** 1250,1259 ****
(setq attribution attrib
attriblist nil))
((listp attrib)
! (setq attribution (eval attrib))
! (if attribution
! (setq attriblist nil)
! (setq attriblist (cdr attriblist))))
(t (error "%s did not evaluate to a string or list!"
"sc-attrib-selection-list"))
)))
--- 1250,1257 ----
(setq attribution attrib
attriblist nil))
((listp attrib)
! (setq attribution (eval attrib)
! attriblist nil))
(t (error "%s did not evaluate to a string or list!"
"sc-attrib-selection-list"))
)))
</pre><br><br>
You might also need the following, from Sergei Pokrovsky:
<pre>
'(sc-citation-nonnested-root-regexp "\\([-._]\\|\\w\\)+")
'(sc-citation-root-regexp "\\([-._]\\|\\w\\)*")
</pre>
<br><br></dd>
<dt>How do I get my Pilot/Addressbook/Phone/Widget to sync
with BBDB?</dt>
<dd>Updated: 28 June 2001<br>
<br>
Run screaming, waving hands in air.<br><br>
Still here? Okay. This is a problem complicated by some
basic differences in the respective tools' approach to
addressbooks, <a
href="http://www.mail-archive.com/bbdb-info%40xemacs.org/msg00571.html">neatly
summarised in a message from Jamie
Zawinski</a>. The solutions to date are at least three
different <tt>bbdb-pilot.el</tt> files, <a
href="http://home.rochester.rr.com/tsdeweese/SyncBBDB.html">SyncBBDB</a>
and <a href="http://www.valente.de/aldo/palm/">SyncAB +
BBDB</a>. The latter two are quite good, although
personally I don't use anything to keep my bits in sync at
present.</dd>
</dl>
</dd>
<dt>Miscellany</dt>
<dd>
<dl>
<dt>Credits</dt>
<dd>Updated: 25 February 2001<br>
<br>
The BBDB was originally created by <a
href="http://www.jwz.org/">Jamie Zawinski</a>. The
cast of characters involved since then is listed in the
BBDB documentation. The current maintainer is <a
href="http://www.waider.ie/">Waider</a>, assisted by
whoever's got write access on the <a
href="http://www.sourceforge.net/projects/bbdb/">SourceForge
tree</a> and a supporting cast on the bbdb-info mailing
list.<br><br></dd>
</dl>
</dd>
</dl>
<!-- to add: (other than per-section notes)
LINKS!
Mailing List
Developer FAQs - making contributions, etc.
-->
<hr>
<address>bbdb-faq@waider.ie</address>
$Date: 2001/08/22 19:53:31 $
</body>
</html>
|
