A libcap.3 man page and fix up the cap_get_pid() docs.

Make it easier to find what functions are available in
the API.

Signed-off-by: Andrew G. Morgan <morgan@kernel.org>