some updating of the api doc