It's fine not to expose this for now. Also the javadoc here should go inside of the function (it's a note/TODO about one particular case). It's best to save the javadoc itself for a high level description of the function. Otherwise it gets kinda confusing when reviewing.