Rules for the API docs:
1. Clearly distinguish between internal and the external API/ABI.
2. Mark internal stuff with \internal.
3. If this has been solved, start documenting the external interface.
Thank you.