fix a couple of useful docblocks