Explanations are a little rare unfortunately
But I'm sure sooner or later Ono finds the time to comment on every function in an upcoming manual.
I guess we just have to wait.
The efficacy thing is only a typo in the manual. But a serious one as it's in the printed example script as well.