updated more doc blocks