api change, docs addition