[BUG #8414] updated tests
[BUG #8414] updated API docs