I have to also prefer (a) with (2), because it makes it possible for
one to define nice long descriptions for functions without having to
put them between the signature and body..
WRT the elisp-like 'first sentence' use.. one might as well make this
2 distinct strings in python.. or just index the whole documentation
string, or add a specific 'keywords' section... anything but actually
looking into the documentation strings themselves.
-- John Redford (AKA GArrow) | 3,600 hours of tape. email@example.com | 5 cans of Scotchguard.