more doc block corrections