[BUG #7525] add missing API doc
[BUG #7525] correct and augment tests