added some doc blocks and renamed some vars