update some doc blocks