core: document some functions

Signed-off-by: Hagen Paul Pfeifer <hagen@jauu.net>