added some more docblocks