I like the way the this API is laid out better.  Thanks for the change.  But remember to update your doc string