documentation for new plan interface, deprecate old-style plan(A) calls