added doc comment notes on generated c++ api