added further docblocks.