[BUG #8110] API doc fixes
[BUG #8253] Mark optional parameters