adjust docblocks