doc: Add API description for clock interface