[PATCH] include, libctf: add a bunch of documentation to ctf-api.h

[Nick Alcock]

On 14 May 2024, Nick Alcock told this:

> Hopefully this library is no longer quite so much a "you have to look
> in the source to understand anything" library.
>
> No semantic changes, though some functions have been moved around for
> clarity.
>
> include/
> 	ctf-api.h: Add comments.

This is now pushed, along with the previous series I posted a couple of
weeks ago fixing various small bugs and one big error-path leak (of
course I spotted the missing * in the changelog only a second too late).

(I've also started signing my commits: as Jon Wakely suggested recently,
I'm using the key I push to Sourceware with to do so.)