document exported functions