complete doc blocks.