! mask unlink error
! add / improve function docs

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