It's basically very simple:
Just type M-x bbdb RET RET. You'll end up in an empty contacts list, a BBDB buffer. Then start inserting contacts :-). Have a look at the menu. That should get you started.
Once you have some contacts you can search for them, print or export them, use completion with them when sending mail, refer to them in org-mode buffers or ...
Manual for BBDBv2 → http://obbdb.sourceforge.net/#manual
Manual for BBDBv3 → does not exist.
FWIW here are some BBDBv3 resources:
Discussion about (missing) BBDBv3 manual on official mailing list: https://www.mail-archive.com/bbdb-info%40lists.sourceforge.net/msg05487.html
Official BBDBv3 project page: https://savannah.nongnu.org/projects/bbdb/
The affix field looks like the following: The affix entry Dr.is put behind the name (separated by a comma) and before the slash - before the organisation entry. I guess the reason it was called "affix" is that depending on the culture, entries - for example for academic titles - can be written as prefixes or suffixes.
Apparently it does not have a well defined meaning, from the bbdb mailing list
So far, the affix field in BBDB 3 does not have a detailed meaning.
Its value is a list of strings. So I guess it can stand for all kinds
of prefixes, suffixes, academic titles, and what else. But depending
on a user's cultural background, the details may vary quite a ...
I don't think this functionality is already implemented.
AFAICS the functionality is provided e.g. by
(defun bbdb-word-at-point ()
"Ask bbdb about word at point."
(bbdb (thing-at-point 'word t)))
The folowing solution was tested with bbdb version 2.35: http://bbdb.sourceforge.net/
I gave the bounty-bonus to @Jules Tamagnan for his interesting approach to displaying the entire record as a potential completion candidate.
The following answer provides for tab-completion using the name field of the database -- completing-read does not require a match ...
I use counsel-bbdb but company-bbdb is also enabled.
To insert multiple mail address:
Just press C-M-n in the candidates window. It's built in feature of ivy-mode which counsel-bbdb is dependent on.
Try this out if you want. It lets you enter a regexp and then shows the records when you hit tab. when you are satisfied with the chosen records hit enter. The main function is jat/bbdb-search.
(defun jat/minibuffer-text ()
"only works on one line"
You can pretty much always insert any character using C-q: C-q <. I'd be surprised if that didn't work in your context. (Of course, often there is an easier, more direct way to insert a given character.)