correct doc blocks in newer classes