doc block updates
missing exception doc block
updates to doc block