add API documentation for some metadata functions