updated doc blocks