more documentation for API...