revised doc and api