correct doc blocks