gpg: Move documentation from keydb.h to keydb.c and getkey.c.

When using tags (e.g. GNU global) to navigate the source code it is
way easier to have the documentation close to the function we are
looking at. Having the documentation in the header file would require
an extra manual lookup to understand the function.

• Signed-off-by: Werner Koch <wk@gnupg.org>