correct doc blocks for consistency