doc updates for the api change

2008-02-11, grim