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
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
|
<html>
<head>
<title>BBDB FAQ</title>
<link rel="stylesheet" href="bbdb.css" type="text/css">
</head>
<body>
<h1>The BBDB FAQ</h1>
The FAQ is unmaintained, but you probably find an answer to your question
in the mailing list archives. Feel free to mail me any things that should
be on this list.
<p>This is the BBDB FAQ.</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: 20 April 2010<br>
<br>
The current version is 2.36. Generally speaking, the
development version is the preferred version.<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
there.<br><br></dd>
<dd>Updated: 20 April 2010<br>
<br>
But you might want to check out
<a href="http://github.com/barak/BBDB">http://github.com/barak/BBDB</a>
or <tt>git clone git://github.com/barak/BBDB.git</tt>
.<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>
<dt>How to I get BBDB to not keep changing the name field
for a record?</dt>
<dd>Updated: August 20 2005<br>
Probably the easiest way to do this is to use
<tt>bbdb-ignore-some-messages-alist</tt>; see the
documentation on this for more details. You'll also need
to set <tt>bbdb/{mail,news}-auto-create-p</tt> to
<tt>bbdb-ignore-some-messages-hook</tt>, or invoke the
latter from whatever your <tt>auto-create-p</tt>
variables currently point at.</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: 20 August 2005<br>
<br>
Read The Fine Manual, and then if you're still unsure ask
on the bbdb-info list.<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: 20 August 2005<br>
<br>
<tt>M-x bbdb-show-duplicates</tt>, and delete or merge 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>
<dt>How do I submit a bug report?</dt>
<dd>Updated: 20 August 2005<br>
Use <tt>bbdb-submit-bug-report</tt>. This extracts
version information and settings from your running copy
of BBDB and prepares an email message including
them. The default address for this mail is the bbdb-info
list, so that all developers can see it, but if you've
got privacy issues with that then you can send it
directly to me (waider@waider.ie). A few essential
notes:<ul>
<li>Check the mailing list archives to see if your bug
has previously been discussed.</li>
<li>Make sure you've tried out the latest CVS version,
in case your bug has already been solved.</li>
<li>Be as precise as you can. Do <b>not</b> use
wording like "I got an error message about some
file"; include the exact text of the error message
and the filename it referred to.</li>
<li>If you can, try and provide a minimal <tt>.bbdb</tt>
file that illustrates the problem. There is apparently
an ongoing issue with completion not providing all
possible expansions, but since noone has yet provided a
<tt>.bbdb</tt> file that demonstrates the problem, I've
been unable to reproduce it.</li>
</ul>
</dd>
<!-- 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: 20 August 2005<br>
<br>
This should be (mostly) solved in CVS. If you encounter
this, please submit a bug report.
<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>
</body>
</html>
|
