group name support, and some bug, test suite, and doc patches

[Sam Roberts]

Ok, this isn't exactly what we talked about, Alain, so if it don't work
for you tell me, however I looked at the draft for the msg format RFC,
and they put it the way I thought it should be, namely the group
name is equivalent to the personal name:

name-addr = [display-name] "<" addr-spec ">"
group     = display-name ":" [mailbox-list] ";"

So either way display-name is a "displayable" name for either a
single address, or a group of addresses. Thus, group name gets stuffed
in personal, and local_part, domain, and email for that "address" will
be zero-length (or you can use the handy address_is_group() to see
if this is the "personal" name of a group.

The attached Addrs.good is used by the test, and should go in examples/.

I also added my tests to examples, it's not what you'd call sophisticated,
but it does provide examples of how addresses should be parsed by
address_create().

Sam

p.s. Take a peek at the "to consider" in parse822.c. The API has some
wrinkles. Cheers, dinner time for this boy!

p.p.s. I don't know if you have a test suite, but I've a collection of
odd messages I've received, and also I note that drums has a number
of example messages in it's back, might be a useful test
for the message parsing code. I might put it all into an mbox file.


-- 
Sam Roberts <address@hidden> (Vivez sans temps mort!)

group-name.diff
Description: Text document

Addrs.good
Description: Text document