updating doc blocks