More improvements to docblocks

Signed-off-by: Paul de Wouters <paul@hmn.md>