update docblocks: