docs/api

[Greg Hudson]

On Fri, 2010-03-12 at 14:10 -0500, Jeff Blaine wrote:
> It seems safe to assume based on the file timestamps
> that everything here is very out of date with the
> exception (maybe?) of krb5.tex.

It's really, really out of date.  Like, we added the krb5_get_init_creds
APIs in 1997 and those API docs don't mention it (and still describe the
deprecated krb5_get_in_tkt APIs instead).

This is obviously a bad situation, and we would love to fix it; it has
mostly been a matter of balancing limited resources between that and
other priorities.  It seems likely that when we do bring resources to
bear to improve the situation, we will use Doxygen rather than bringing
the texinfo API documentation up to date.