! some moar docblock standards for apigen

Signed-off-by: Spuds <spuds@spudsdesign.com>