fix API docs
more doc fixes
restore clear() function
docs