added some doc blocks