start using new function signatures for doco #9