correct comment headers
add note regarding API method