added php docblocks all around the place